2023-11-12 13:10:24 +00:00
# Changelog
2024-02-10 14:25:05 +00:00
## 0.11.0
### Minor Changes
- Fix a few bugs and include BREAKING CHANG refactors
- fix: should not reset the state when calling checkout to latest (#265)
- refactor: only send a event for one `import` /`transaction`/`checkout` (#263)
- perf: optimize snapshot encoding speed (#264)
- feat: remove deleted set in tree state and optimize api (#259)
2024-01-24 02:01:30 +00:00
## 0.10.1
### Patch Changes
- fix: remove checking after checkout
2024-01-22 05:00:42 +00:00
## 0.10.0
### Minor Changes
- New encoding schema
- BREAKING CHANGE: refactor: Optimizing Encoding Representation for Child Container Creation to Reduce Document Size (#247)
- feat: compare frontiers causal order (#257)
- docs: update docs about rich text style (#258)
2024-01-21 12:04:31 +00:00
## 0.9.4
### Patch Changes
- Fix a few richtext time travel issues
2024-01-19 16:59:07 +00:00
## 0.9.3
### Patch Changes
- feat: add getChangeAtLamport
2024-01-19 14:23:24 +00:00
## 0.9.2
### Patch Changes
- Fix a few rich text issue
- fix: time travel back should be able to nullify rich text span (#254)
- fix: formalize apply delta method (#252)
- fix: how to find best insert pos for richtext & expand type reverse behavior (#250)
2024-01-18 05:30:26 +00:00
## 0.9.1
### Patch Changes
- Fix use consistnt peer id repr and expose VersionVector type
2024-01-17 15:00:50 +00:00
## 0.9.0
### Minor Changes
- Refine the rich text CRDT in Loro
2024-01-05 08:11:09 +00:00
## 0.8.0
### Minor Changes
- Stabilize encoding and fix several issues related to time travel
feat: stabilizing encoding (#219)
This PR implements a new encode schema that is more extendible and more compact. It’s also simpler and takes less binary size and maintaining effort. It is inspired by the [Automerge Encoding Format](https://automerge.org/automerge-binary-format-spec/).
The main motivation is the extensibility. When we integrate a new CRDT algorithm, we don’t want to make a breaking change to the encoding or keep multiple versions of the encoding schema in the code, as it will make our WASM size much larger. We need a stable and extendible encoding schema for our v1.0 version.
This PR also exposes the ops that compose the current container state. For example, now you can make a query about which operation a certain character quickly. This behavior is required in the new snapshot encoding, so it’s included in this PR.
# Encoding Schema
## Header
The header has 22 bytes.
- (0-4 bytes) Magic Bytes: The encoding starts with `loro` as magic bytes.
- (4-20 bytes) Checksum: MD5 checksum of the encoded data, including the header starting from 20th bytes. The checksum is encoded as a 16-byte array. The `checksum` and `magic bytes` fields are trimmed when calculating the checksum.
- (20-21 bytes) Encoding Method (2 bytes, big endian): Multiple encoding methods are available for a specific encoding version.
## Encode Mode: Updates
In this approach, only ops, specifically their historical record, are encoded, while document states are excluded.
Like Automerge's format, we employ columnar encoding for operations and changes.
Previously, operations were ordered by their Operation ID (OpId) before columnar encoding. However, sorting operations based on their respective containers initially enhance compression potential.
## Encode Mode: Snapshot
This mode simultaneously captures document state and historical data. Upon importing a snapshot into a new document, initialization occurs directly from the snapshot, bypassing the need for CRDT-based recalculations.
Unlike previous snapshot encoding methods, the current binary output in snapshot mode is compatible with the updates mode. This enhances the efficiency of importing snapshots into non-empty documents, where initialization via snapshot is infeasible.
Additionally, when feasible, we leverage the sequence of operations to construct state snapshots. In CRDTs, deducing the specific ops constituting the current container state is feasible. These ops are tagged in relation to the container, facilitating direct state reconstruction from them. This approach, pioneered by Automerge, significantly improves compression efficiency.
2024-01-02 09:03:24 +00:00
## 0.7.2-alpha.4
### Patch Changes
- Fix encoding value err
## 0.7.2-alpha.3
### Patch Changes
- Fix export compressed snapshot
## 0.7.2-alpha.2
### Patch Changes
- Add compressed method
## 0.7.2-alpha.1
### Patch Changes
- Fix v0 exports
## 0.7.2-alpha.0
### Patch Changes
- Add experimental encode methods
2023-12-26 10:01:14 +00:00
## 0.7.1
### Patch Changes
- Fix a few richtext errors
2023-12-08 09:00:55 +00:00
## 0.7.0
### Minor Changes
- refactor: remove setPanicHook and call it internally when loaded
2023-12-07 07:27:22 +00:00
## 0.6.5
### Patch Changes
- Fix checkout err on seq data
2023-12-06 15:39:55 +00:00
## 0.6.4
### Patch Changes
- Fix time travel issue #211
2023-12-05 05:58:00 +00:00
## 0.6.1
### Patch Changes
- 6753c2f: Refine loro-crdt api
2023-12-05 05:38:09 +00:00
## 0.6.0
### Minor Changes
2023-11-12 13:10:24 +00:00
2023-12-05 05:38:09 +00:00
- Improve API of event
2023-11-12 13:10:24 +00:00
2023-12-05 05:38:09 +00:00
All notable changes to this project will be documented in this file. See [standard-version ](https://github.com/conventional-changelog/standard-version ) for commit guidelines.
