@pluv/crdt 0.0.0-experimental-20250527040415

package/.turbo/turbo-build.log

@@ -0,0 +1,19 @@
+
+
+> @pluv/crdt@2.2.4 build /home/leedavidcs/projects/pluv/packages/crdt
+> tsup src/index.ts --format esm,cjs --dts
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.0
+CLI Target: es6
+ESM Build start
+CJS Build start
+CJS dist/index.js 2.68 KB
+CJS ⚡️ Build success in 37ms
+ESM dist/index.mjs 1.55 KB
+ESM ⚡️ Build success in 37ms
+DTS Build start
+DTS ⚡️ Build success in 676ms
+DTS dist/index.d.mts 2.64 KB
+DTS dist/index.d.ts  2.64 KB

package/.turbo/turbo-lint.log

@@ -0,0 +1,5 @@
+
+
+> @pluv/crdt@2.2.1 lint /home/leedavidcs/projects/pluv/packages/crdt
+> eslint "src/**/*.ts*" --fix --max-warnings 0
+

package/CHANGELOG.md

@@ -0,0 +1,721 @@
+# @pluv/crdt
+
+## 0.0.0-experimental-20250527040415
+
+### Patch Changes
+
+- @pluv/types@0.0.0-experimental-20250527040415
+
+## 2.2.7
+
+### Patch Changes
+
+- @pluv/types@2.2.7
+
+## 2.2.6
+
+### Patch Changes
+
+- @pluv/types@2.2.6
+
+## 2.2.5
+
+### Patch Changes
+
+- @pluv/types@2.2.5
+
+## 2.2.4
+
+### Patch Changes
+
+- @pluv/types@2.2.4
+
+## 2.2.3
+
+### Patch Changes
+
+- @pluv/types@2.2.3
+
+## 2.2.2
+
+### Patch Changes
+
+- @pluv/types@2.2.2
+
+## 2.2.1
+
+### Patch Changes
+
+- @pluv/types@2.2.1
+
+## 2.2.0
+
+### Patch Changes
+
+- @pluv/types@2.2.0
+
+## 2.1.0
+
+### Patch Changes
+
+- @pluv/types@2.1.0
+
+## 2.0.2
+
+### Patch Changes
+
+- @pluv/types@2.0.2
+
+## 2.0.1
+
+### Patch Changes
+
+- @pluv/types@2.0.1
+
+## 2.0.0
+
+### Patch Changes
+
+- 047a1d8: Moved several internal types to `@pluv/types`.
+- Updated dependencies [047a1d8]
+    - @pluv/types@2.0.0
+
+## 1.0.2
+
+### Patch Changes
+
+- @pluv/types@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- @pluv/types@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- af94706: pluv.io is now stable and production ready!
+
+    With this v1 release, pluv.io will now follow [semantic versioning](https://semver.org/) with more comprehensive release notes for future changes to the library.
+
+    Checkout the [full documentation here](https://pluv.io/docs/introduction) to get started today!
+
+### Patch Changes
+
+- Updated dependencies [af94706]
+    - @pluv/types@1.0.0
+
+## 0.44.2
+
+### Patch Changes
+
+- @pluv/types@0.44.2
+
+## 0.44.1
+
+### Patch Changes
+
+- @pluv/types@0.44.1
+
+## 0.44.0
+
+### Patch Changes
+
+- @pluv/types@0.44.0
+
+## 0.43.0
+
+### Patch Changes
+
+- @pluv/types@0.43.0
+
+## 0.42.0
+
+### Patch Changes
+
+- @pluv/types@0.42.0
+
+## 0.41.7
+
+### Patch Changes
+
+- @pluv/types@0.41.7
+
+## 0.41.6
+
+### Patch Changes
+
+- @pluv/types@0.41.6
+
+## 0.41.5
+
+### Patch Changes
+
+- @pluv/types@0.41.5
+
+## 0.41.4
+
+### Patch Changes
+
+- @pluv/types@0.41.4
+
+## 0.41.3
+
+### Patch Changes
+
+- @pluv/types@0.41.3
+
+## 0.41.2
+
+### Patch Changes
+
+- @pluv/types@0.41.2
+
+## 0.41.1
+
+### Patch Changes
+
+- @pluv/types@0.41.1
+
+## 0.41.0
+
+### Patch Changes
+
+- @pluv/types@0.41.0
+
+## 0.40.2
+
+### Patch Changes
+
+- @pluv/types@0.40.2
+
+## 0.40.1
+
+### Patch Changes
+
+- @pluv/types@0.40.1
+
+## 0.40.0
+
+### Patch Changes
+
+- @pluv/types@0.40.0
+
+## 0.39.1
+
+### Patch Changes
+
+- @pluv/types@0.39.1
+
+## 0.39.0
+
+### Patch Changes
+
+- @pluv/types@0.39.0
+
+## 0.38.14
+
+### Patch Changes
+
+- @pluv/types@0.38.14
+
+## 0.38.13
+
+### Patch Changes
+
+- @pluv/types@0.38.13
+
+## 0.38.12
+
+### Patch Changes
+
+- @pluv/types@0.38.12
+
+## 0.38.11
+
+### Patch Changes
+
+- @pluv/types@0.38.11
+
+## 0.38.10
+
+### Patch Changes
+
+- @pluv/types@0.38.10
+
+## 0.38.9
+
+### Patch Changes
+
+- @pluv/types@0.38.9
+
+## 0.38.8
+
+### Patch Changes
+
+- @pluv/types@0.38.8
+
+## 0.38.7
+
+### Patch Changes
+
+- @pluv/types@0.38.7
+
+## 0.38.6
+
+### Patch Changes
+
+- @pluv/types@0.38.6
+
+## 0.38.5
+
+### Patch Changes
+
+- @pluv/types@0.38.5
+
+## 0.38.4
+
+### Patch Changes
+
+- @pluv/types@0.38.4
+
+## 0.38.3
+
+### Patch Changes
+
+- @pluv/types@0.38.3
+
+## 0.38.2
+
+### Patch Changes
+
+- @pluv/types@0.38.2
+
+## 0.38.1
+
+### Patch Changes
+
+- @pluv/types@0.38.1
+
+## 0.38.0
+
+### Patch Changes
+
+- Updated dependencies [f4ceca3]
+    - @pluv/types@0.38.0
+
+## 0.37.7
+
+### Patch Changes
+
+- @pluv/types@0.37.7
+
+## 0.37.6
+
+### Patch Changes
+
+- @pluv/types@0.37.6
+
+## 0.37.5
+
+### Patch Changes
+
+- @pluv/types@0.37.5
+
+## 0.37.4
+
+### Patch Changes
+
+- @pluv/types@0.37.4
+
+## 0.37.3
+
+### Patch Changes
+
+- @pluv/types@0.37.3
+
+## 0.37.2
+
+### Patch Changes
+
+- @pluv/types@0.37.2
+
+## 0.37.1
+
+### Patch Changes
+
+- @pluv/types@0.37.1
+
+## 0.37.0
+
+### Patch Changes
+
+- @pluv/types@0.37.0
+
+## 0.36.0
+
+### Patch Changes
+
+- @pluv/types@0.36.0
+
+## 0.35.4
+
+### Patch Changes
+
+- @pluv/types@0.35.4
+
+## 0.35.3
+
+### Patch Changes
+
+- @pluv/types@0.35.3
+
+## 0.35.2
+
+### Patch Changes
+
+- Updated dependencies [81cb692]
+    - @pluv/types@0.35.2
+
+## 0.35.1
+
+### Patch Changes
+
+- @pluv/types@0.35.1
+
+## 0.35.0
+
+### Patch Changes
+
+- @pluv/types@0.35.0
+
+## 0.34.1
+
+### Patch Changes
+
+- @pluv/types@0.34.1
+
+## 0.34.0
+
+### Patch Changes
+
+- @pluv/types@0.34.0
+
+## 0.33.0
+
+### Patch Changes
+
+- @pluv/types@0.33.0
+
+## 0.32.9
+
+### Patch Changes
+
+- @pluv/types@0.32.9
+
+## 0.32.8
+
+### Patch Changes
+
+- @pluv/types@0.32.8
+
+## 0.32.7
+
+### Patch Changes
+
+- @pluv/types@0.32.7
+
+## 0.32.6
+
+### Patch Changes
+
+- @pluv/types@0.32.6
+
+## 0.32.5
+
+### Patch Changes
+
+- @pluv/types@0.32.5
+
+## 0.32.4
+
+### Patch Changes
+
+- @pluv/types@0.32.4
+
+## 0.32.3
+
+### Patch Changes
+
+- @pluv/types@0.32.3
+
+## 0.32.2
+
+### Patch Changes
+
+- @pluv/types@0.32.2
+
+## 0.32.1
+
+### Patch Changes
+
+- @pluv/types@0.32.1
+
+## 0.32.0
+
+### Patch Changes
+
+- @pluv/types@0.32.0
+
+## 0.31.0
+
+### Patch Changes
+
+- @pluv/types@0.31.0
+
+## 0.30.2
+
+### Patch Changes
+
+- @pluv/types@0.30.2
+
+## 0.30.1
+
+### Patch Changes
+
+- @pluv/types@0.30.1
+
+## 0.30.0
+
+### Patch Changes
+
+- @pluv/types@0.30.0
+
+## 0.29.0
+
+### Patch Changes
+
+- @pluv/types@0.29.0
+
+## 0.28.0
+
+### Patch Changes
+
+- @pluv/types@0.28.0
+
+## 0.27.0
+
+### Patch Changes
+
+- @pluv/types@0.27.0
+
+## 0.26.0
+
+### Patch Changes
+
+- @pluv/types@0.26.0
+
+## 0.25.4
+
+### Patch Changes
+
+- @pluv/types@0.25.4
+
+## 0.25.3
+
+### Patch Changes
+
+- @pluv/types@0.25.3
+
+## 0.25.2
+
+### Patch Changes
+
+- @pluv/types@0.25.2
+
+## 0.25.1
+
+### Patch Changes
+
+- @pluv/types@0.25.1
+
+## 0.25.0
+
+### Patch Changes
+
+- @pluv/types@0.25.0
+
+## 0.24.1
+
+### Patch Changes
+
+- @pluv/types@0.24.1
+
+## 0.24.0
+
+### Patch Changes
+
+- @pluv/types@0.24.0
+
+## 0.23.0
+
+### Patch Changes
+
+- @pluv/types@0.23.0
+
+## 0.22.0
+
+### Patch Changes
+
+- @pluv/types@0.22.0
+
+## 0.21.1
+
+### Patch Changes
+
+- @pluv/types@0.21.1
+
+## 0.21.0
+
+### Patch Changes
+
+- @pluv/types@0.21.0
+
+## 0.20.0
+
+### Minor Changes
+
+- 9492085: **BREAKING**: `@pluv/crdt-yjs` and `@pluv/crdt-loro` have been updated so that the utilities to create shared-types/containers no-longer return a wrapper around the underlying shared-types and containers, but rather return the shared-types/containers directly.
+
+    This means that for methods such as `getStorage` from `@pluv/client` and `useStorage` from `@pluv/react`, the shared-types/containers are also returned instead of the wrapper types.
+
+    The motivation for these changes are so that pluv.io is supplementary to `yjs` and `loro-crdt`, instead of having these libraries be an internal implementation of pluv.io.
+
+    ```ts
+    // Before
+
+    import { yjs } from "@pluv/crdt-yjs";
+
+    yjs.array([]); // Returns CrdtYjsArray
+    yjs.object([]); // Returns CrdtYjsObject
+
+    const room: PluvRoom = /* ... */;
+
+    room.getStorage("messages"); // Returns AbstractCrdtType
+
+    const [, sharedType] = useStorage("messages"); // sharedType is an AbstractCrdtType
+    ```
+
+    ```ts
+    // Now
+
+    import { yjs } from "@pluv/crdt-yjs";
+
+    yjs.array([]); // Returns yjs.Array
+    yjs.object([]); // Returns yjs.Map
+
+    const room: PluvRoom = /* ... */;
+
+    room.getStorage("messages"); // Returns yjs.AbstractType
+
+    const [, sharedType] = useStorage("messages"); // sharedType is a yjs.AbstractType
+    ```
+
+    For `@pluv/crdt-loro` specifically, `@pluv/client` relies on [loro events and subscriptions](https://www.loro.dev/docs/tutorial/get_started#event) to detect changes. The `AbstractLoroCrdt` types previously called `Loro.commit` after each change as an abstraction, but now this no-longer happens. To ensure that changes to loro containers are properly handled in `@pluv/react`, make sure to commit your changes whenever possible:
+
+    ```ts
+    // Before
+
+    const [data, container] = useStorage("messages");
+
+    // This automatically called Loro.commit under the hood and rerendered the page with updated data.
+    container.push(loro.object({ name: "John Doe", age: 35 }));
+    ```
+
+    ```ts
+    // Now
+
+    const [data, container] = useStorage("messages");
+
+    const doc = useDoc();
+    const transact = useTransact();
+
+    // Updates need to be committed back to the doc whenever the changes need to be emitted to other users
+    // The returned data also will not update until the changes are commited
+
+    // The two operations below are functionally equivalent
+    transact(() => {
+        container.push(loro.object({ name: "John Doe", age: 35 }));
+    });
+
+    container.push(loro.object({ name: "John Doe", age: 35 }));
+    doc.value.commit();
+    ```
+
+### Patch Changes
+
+- @pluv/types@0.20.0
+
+## 0.19.0
+
+### Patch Changes
+
+- @pluv/types@0.19.0
+
+## 0.18.0
+
+### Patch Changes
+
+- Updated dependencies [99b5ca9]
+    - @pluv/types@0.18.0
+
+## 0.17.3
+
+### Patch Changes
+
+- @pluv/types@0.17.3
+
+## 0.17.2
+
+### Patch Changes
+
+- @pluv/types@0.17.2
+
+## 0.17.1
+
+### Patch Changes
+
+- @pluv/types@0.17.1
+
+## 0.17.0
+
+### Patch Changes
+
+- Updated dependencies [507bc00]
+    - @pluv/types@0.17.0
+
+## 0.16.3
+
+### Patch Changes
+
+- @pluv/types@0.16.3
+
+## 0.16.2
+
+### Patch Changes
+
+- @pluv/types@0.16.2
+
+## 0.16.1
+
+### Patch Changes
+
+- @pluv/types@0.16.1
+
+## 0.16.0
+
+### Patch Changes
+
+- @pluv/types@0.16.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Shoubhit Dash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -0,0 +1,50 @@
+import { CrdtType, CrdtDocLike, DocApplyEncodedStateParams, DocBatchApplyEncodedStateParams, DocSubscribeCallbackParams } from '@pluv/types';
+export { CrdtDocLike, CrdtType, DocApplyEncodedStateParams, DocBatchApplyEncodedStateParams, DocSubscribeCallbackParams, InferCrdtJson } from '@pluv/types';
+
+declare abstract class AbstractCrdtDocFactory<TDoc extends any, TStorage extends Record<string, CrdtType<any, any>>> {
+    _initialStorage: (builder: any) => TStorage;
+    constructor(initialStorage: (builder: any) => TStorage);
+    abstract getEmpty(): CrdtDocLike<TDoc, TStorage>;
+    abstract getFactory(initialStorage?: (builder: any) => TStorage): AbstractCrdtDocFactory<TDoc, TStorage>;
+    abstract getInitialized(initialStorage?: (builder: any) => TStorage): CrdtDocLike<TDoc, TStorage>;
+    resolveEncodedState(updates: string | string[] | readonly string[]): string | null;
+}
+
+declare class NoopCrdtDoc implements CrdtDocLike<any, any> {
+    value: any;
+    applyEncodedState(params: DocApplyEncodedStateParams): this;
+    batchApplyEncodedState(params: DocBatchApplyEncodedStateParams): this;
+    canRedo(): boolean;
+    canUndo(): boolean;
+    destroy(): void;
+    get(key?: undefined): {};
+    get<TKey extends never>(key: TKey): {}[TKey];
+    getEncodedState(): string;
+    isEmpty(): boolean;
+    rebuildStorage(): this;
+    redo(): this;
+    subscribe(listener: (params: DocSubscribeCallbackParams<any, any>) => void): () => void;
+    toJson(): any;
+    track(): this;
+    transact(fn: () => void, origin?: string | undefined): this;
+    undo(): this;
+}
+
+declare class NoopCrdtDocFactory extends AbstractCrdtDocFactory<any, any> {
+    constructor(initialStorage?: () => {});
+    getEmpty(): NoopCrdtDoc;
+    getFactory(initialStorage?: ((builder: any) => any) | undefined): NoopCrdtDocFactory;
+    getInitialized(initialStorage?: ((builder: any) => any) | undefined): NoopCrdtDoc;
+}
+
+declare const noop: {
+    doc: (args?: any) => NoopCrdtDocFactory;
+};
+
+type InferDoc<TFactory extends AbstractCrdtDocFactory<any, any>> = InferDocLike<TFactory>["value"];
+type InferDocLike<TFactory extends AbstractCrdtDocFactory<any, any>> = ReturnType<TFactory["getInitialized"]>;
+type InferInitialStorageFn<TFactory extends AbstractCrdtDocFactory<any, any>> = TFactory["_initialStorage"];
+type InferStorage<TFactory extends AbstractCrdtDocFactory<any, any>> = ReturnType<InferInitialStorageFn<TFactory>>;
+type InferBuilder<TFactory extends AbstractCrdtDocFactory<any, any>> = Parameters<InferInitialStorageFn<TFactory>>[0];
+
+export { AbstractCrdtDocFactory, type InferBuilder, type InferDoc, type InferDocLike, type InferInitialStorageFn, type InferStorage, NoopCrdtDoc, NoopCrdtDocFactory, noop };

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import { CrdtType, CrdtDocLike, DocApplyEncodedStateParams, DocBatchApplyEncodedStateParams, DocSubscribeCallbackParams } from '@pluv/types';
+export { CrdtDocLike, CrdtType, DocApplyEncodedStateParams, DocBatchApplyEncodedStateParams, DocSubscribeCallbackParams, InferCrdtJson } from '@pluv/types';
+
+declare abstract class AbstractCrdtDocFactory<TDoc extends any, TStorage extends Record<string, CrdtType<any, any>>> {
+    _initialStorage: (builder: any) => TStorage;
+    constructor(initialStorage: (builder: any) => TStorage);
+    abstract getEmpty(): CrdtDocLike<TDoc, TStorage>;
+    abstract getFactory(initialStorage?: (builder: any) => TStorage): AbstractCrdtDocFactory<TDoc, TStorage>;
+    abstract getInitialized(initialStorage?: (builder: any) => TStorage): CrdtDocLike<TDoc, TStorage>;
+    resolveEncodedState(updates: string | string[] | readonly string[]): string | null;
+}
+
+declare class NoopCrdtDoc implements CrdtDocLike<any, any> {
+    value: any;
+    applyEncodedState(params: DocApplyEncodedStateParams): this;
+    batchApplyEncodedState(params: DocBatchApplyEncodedStateParams): this;
+    canRedo(): boolean;
+    canUndo(): boolean;
+    destroy(): void;
+    get(key?: undefined): {};
+    get<TKey extends never>(key: TKey): {}[TKey];
+    getEncodedState(): string;
+    isEmpty(): boolean;
+    rebuildStorage(): this;
+    redo(): this;
+    subscribe(listener: (params: DocSubscribeCallbackParams<any, any>) => void): () => void;
+    toJson(): any;
+    track(): this;
+    transact(fn: () => void, origin?: string | undefined): this;
+    undo(): this;
+}
+
+declare class NoopCrdtDocFactory extends AbstractCrdtDocFactory<any, any> {
+    constructor(initialStorage?: () => {});
+    getEmpty(): NoopCrdtDoc;
+    getFactory(initialStorage?: ((builder: any) => any) | undefined): NoopCrdtDocFactory;
+    getInitialized(initialStorage?: ((builder: any) => any) | undefined): NoopCrdtDoc;
+}
+
+declare const noop: {
+    doc: (args?: any) => NoopCrdtDocFactory;
+};
+
+type InferDoc<TFactory extends AbstractCrdtDocFactory<any, any>> = InferDocLike<TFactory>["value"];
+type InferDocLike<TFactory extends AbstractCrdtDocFactory<any, any>> = ReturnType<TFactory["getInitialized"]>;
+type InferInitialStorageFn<TFactory extends AbstractCrdtDocFactory<any, any>> = TFactory["_initialStorage"];
+type InferStorage<TFactory extends AbstractCrdtDocFactory<any, any>> = ReturnType<InferInitialStorageFn<TFactory>>;
+type InferBuilder<TFactory extends AbstractCrdtDocFactory<any, any>> = Parameters<InferInitialStorageFn<TFactory>>[0];
+
+export { AbstractCrdtDocFactory, type InferBuilder, type InferDoc, type InferDocLike, type InferInitialStorageFn, type InferStorage, NoopCrdtDoc, NoopCrdtDocFactory, noop };

package/dist/index.js

@@ -0,0 +1,121 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AbstractCrdtDocFactory: () => AbstractCrdtDocFactory,
+  NoopCrdtDoc: () => NoopCrdtDoc,
+  NoopCrdtDocFactory: () => NoopCrdtDocFactory,
+  noop: () => noop
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/AbstractCrdtDocFactory.ts
+var AbstractCrdtDocFactory = class {
+  constructor(initialStorage) {
+    this._initialStorage = initialStorage;
+  }
+  resolveEncodedState(updates) {
+    if (typeof updates === "string") return updates;
+    if (!updates.length) return null;
+    return this.getEmpty().batchApplyEncodedState({ updates }).getEncodedState();
+  }
+};
+
+// src/NoopCrdtDoc.ts
+var NoopCrdtDoc = class {
+  constructor() {
+    this.value = null;
+  }
+  applyEncodedState(params) {
+    return this;
+  }
+  batchApplyEncodedState(params) {
+    return this;
+  }
+  canRedo() {
+    return false;
+  }
+  canUndo() {
+    return false;
+  }
+  destroy() {
+    return;
+  }
+  get(key) {
+    return typeof key === "string" ? void 0 : {};
+  }
+  getEncodedState() {
+    return "";
+  }
+  isEmpty() {
+    return true;
+  }
+  rebuildStorage() {
+    return this;
+  }
+  redo() {
+    return this;
+  }
+  subscribe(listener) {
+    return () => void 0;
+  }
+  toJson() {
+    return {};
+  }
+  track() {
+    return this;
+  }
+  transact(fn, origin) {
+    fn();
+    return this;
+  }
+  undo() {
+    return this;
+  }
+};
+
+// src/NoopCrdtDocFactory.ts
+var NoopCrdtDocFactory = class extends AbstractCrdtDocFactory {
+  constructor(initialStorage = () => ({})) {
+    super(initialStorage);
+  }
+  getEmpty() {
+    return new NoopCrdtDoc();
+  }
+  getFactory(initialStorage) {
+    return this;
+  }
+  getInitialized(initialStorage) {
+    return new NoopCrdtDoc();
+  }
+};
+
+// src/noop.ts
+var noop = {
+  doc: (args) => new NoopCrdtDocFactory()
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AbstractCrdtDocFactory,
+  NoopCrdtDoc,
+  NoopCrdtDocFactory,
+  noop
+});

package/dist/index.mjs

@@ -0,0 +1,91 @@
+// src/AbstractCrdtDocFactory.ts
+var AbstractCrdtDocFactory = class {
+  constructor(initialStorage) {
+    this._initialStorage = initialStorage;
+  }
+  resolveEncodedState(updates) {
+    if (typeof updates === "string") return updates;
+    if (!updates.length) return null;
+    return this.getEmpty().batchApplyEncodedState({ updates }).getEncodedState();
+  }
+};
+
+// src/NoopCrdtDoc.ts
+var NoopCrdtDoc = class {
+  constructor() {
+    this.value = null;
+  }
+  applyEncodedState(params) {
+    return this;
+  }
+  batchApplyEncodedState(params) {
+    return this;
+  }
+  canRedo() {
+    return false;
+  }
+  canUndo() {
+    return false;
+  }
+  destroy() {
+    return;
+  }
+  get(key) {
+    return typeof key === "string" ? void 0 : {};
+  }
+  getEncodedState() {
+    return "";
+  }
+  isEmpty() {
+    return true;
+  }
+  rebuildStorage() {
+    return this;
+  }
+  redo() {
+    return this;
+  }
+  subscribe(listener) {
+    return () => void 0;
+  }
+  toJson() {
+    return {};
+  }
+  track() {
+    return this;
+  }
+  transact(fn, origin) {
+    fn();
+    return this;
+  }
+  undo() {
+    return this;
+  }
+};
+
+// src/NoopCrdtDocFactory.ts
+var NoopCrdtDocFactory = class extends AbstractCrdtDocFactory {
+  constructor(initialStorage = () => ({})) {
+    super(initialStorage);
+  }
+  getEmpty() {
+    return new NoopCrdtDoc();
+  }
+  getFactory(initialStorage) {
+    return this;
+  }
+  getInitialized(initialStorage) {
+    return new NoopCrdtDoc();
+  }
+};
+
+// src/noop.ts
+var noop = {
+  doc: (args) => new NoopCrdtDocFactory()
+};
+export {
+  AbstractCrdtDocFactory,
+  NoopCrdtDoc,
+  NoopCrdtDocFactory,
+  noop
+};

package/eslint.config.mjs

@@ -0,0 +1,4 @@
+import { config } from "eslint-config-pluv/base";
+
+/** @type {import("eslint").Linter.Config} */
+export default config;

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@pluv/crdt",
+  "version": "0.0.0-experimental-20250527040415",
+  "description": "crdt base for @pluv/io",
+  "author": "leedavidcs",
+  "license": "MIT",
+  "homepage": "https://github.com/pluv-io/pluv",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pluv-io/pluv.git",
+    "directory": "packages/crdt"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pluv/types": "^0.0.0-experimental-20250527040415"
+  },
+  "devDependencies": {
+    "eslint": "^9.27.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "@pluv/tsconfig": "^0.0.0-experimental-20250527040415",
+    "eslint-config-pluv": "^0.0.0-experimental-20250527040415"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --watch --dts",
+    "lint": "eslint \"src/**/*.ts*\" --fix --max-warnings 0",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist"
+  }
+}

package/src/AbstractCrdtDocFactory.ts

@@ -0,0 +1,27 @@
+import type { CrdtDocLike, CrdtType } from "@pluv/types";
+
+export abstract class AbstractCrdtDocFactory<
+    TDoc extends any,
+    TStorage extends Record<string, CrdtType<any, any>>,
+> {
+    public _initialStorage: (builder: any) => TStorage;
+
+    constructor(initialStorage: (builder: any) => TStorage) {
+        this._initialStorage = initialStorage;
+    }
+
+    public abstract getEmpty(): CrdtDocLike<TDoc, TStorage>;
+    public abstract getFactory(
+        initialStorage?: (builder: any) => TStorage,
+    ): AbstractCrdtDocFactory<TDoc, TStorage>;
+    public abstract getInitialized(
+        initialStorage?: (builder: any) => TStorage,
+    ): CrdtDocLike<TDoc, TStorage>;
+
+    public resolveEncodedState(updates: string | string[] | readonly string[]): string | null {
+        if (typeof updates === "string") return updates;
+        if (!updates.length) return null;
+
+        return this.getEmpty().batchApplyEncodedState({ updates }).getEncodedState();
+    }
+}

package/src/NoopCrdtDoc.ts

@@ -0,0 +1,74 @@
+import {
+    CrdtDocLike,
+    DocApplyEncodedStateParams,
+    DocBatchApplyEncodedStateParams,
+    DocSubscribeCallbackParams,
+} from "@pluv/types";
+
+export class NoopCrdtDoc implements CrdtDocLike<any, any> {
+    public value: any = null;
+
+    public applyEncodedState(params: DocApplyEncodedStateParams): this {
+        return this;
+    }
+
+    public batchApplyEncodedState(params: DocBatchApplyEncodedStateParams): this {
+        return this;
+    }
+
+    public canRedo(): boolean {
+        return false;
+    }
+
+    public canUndo(): boolean {
+        return false;
+    }
+
+    public destroy(): void {
+        return;
+    }
+
+    public get(key?: undefined): {};
+    public get<TKey extends never>(key: TKey): {}[TKey];
+    public get(key?: string): {} | undefined {
+        return typeof key === "string" ? undefined : {};
+    }
+
+    public getEncodedState(): string {
+        return "";
+    }
+
+    public isEmpty(): boolean {
+        return true;
+    }
+
+    public rebuildStorage(): this {
+        return this;
+    }
+
+    public redo(): this {
+        return this;
+    }
+
+    public subscribe(listener: (params: DocSubscribeCallbackParams<any, any>) => void): () => void {
+        return () => undefined;
+    }
+
+    public toJson(): any {
+        return {};
+    }
+
+    public track(): this {
+        return this;
+    }
+
+    public transact(fn: () => void, origin?: string | undefined): this {
+        fn();
+
+        return this;
+    }
+
+    public undo(): this {
+        return this;
+    }
+}

package/src/NoopCrdtDocFactory.ts

@@ -0,0 +1,20 @@
+import { AbstractCrdtDocFactory } from "./AbstractCrdtDocFactory";
+import { NoopCrdtDoc } from "./NoopCrdtDoc";
+
+export class NoopCrdtDocFactory extends AbstractCrdtDocFactory<any, any> {
+    constructor(initialStorage: () => {} = () => ({})) {
+        super(initialStorage);
+    }
+
+    public getEmpty(): NoopCrdtDoc {
+        return new NoopCrdtDoc();
+    }
+
+    public getFactory(initialStorage?: ((builder: any) => any) | undefined): NoopCrdtDocFactory {
+        return this;
+    }
+
+    public getInitialized(initialStorage?: ((builder: any) => any) | undefined): NoopCrdtDoc {
+        return new NoopCrdtDoc();
+    }
+}

package/src/index.ts

@@ -0,0 +1,19 @@
+export type {
+    CrdtDocLike,
+    CrdtType,
+    DocApplyEncodedStateParams,
+    DocBatchApplyEncodedStateParams,
+    DocSubscribeCallbackParams,
+    InferCrdtJson,
+} from "@pluv/types";
+export { AbstractCrdtDocFactory } from "./AbstractCrdtDocFactory";
+export { noop } from "./noop";
+export { NoopCrdtDoc } from "./NoopCrdtDoc";
+export { NoopCrdtDocFactory } from "./NoopCrdtDocFactory";
+export type {
+    InferBuilder,
+    InferDoc,
+    InferDocLike,
+    InferInitialStorageFn,
+    InferStorage,
+} from "./types";

package/src/noop.ts

@@ -0,0 +1,5 @@
+import { NoopCrdtDocFactory } from "./NoopCrdtDocFactory";
+
+export const noop = {
+    doc: (args?: any) => new NoopCrdtDocFactory(),
+};

package/src/types.ts

@@ -0,0 +1,19 @@
+import type { AbstractCrdtDocFactory } from "./AbstractCrdtDocFactory";
+
+export type InferDoc<TFactory extends AbstractCrdtDocFactory<any, any>> =
+    InferDocLike<TFactory>["value"];
+
+export type InferDocLike<TFactory extends AbstractCrdtDocFactory<any, any>> = ReturnType<
+    TFactory["getInitialized"]
+>;
+
+export type InferInitialStorageFn<TFactory extends AbstractCrdtDocFactory<any, any>> =
+    TFactory["_initialStorage"];
+
+export type InferStorage<TFactory extends AbstractCrdtDocFactory<any, any>> = ReturnType<
+    InferInitialStorageFn<TFactory>
+>;
+
+export type InferBuilder<TFactory extends AbstractCrdtDocFactory<any, any>> = Parameters<
+    InferInitialStorageFn<TFactory>
+>[0];

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+	"extends": "@pluv/tsconfig/library.json",
+	"include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
+	"exclude": ["node_modules"],
+	"compilerOptions": {
+		"lib": ["esnext"]
+	}
+}