@voidhash/mimic 0.0.2 → 0.0.3

package/dist/primitives/Array.cjs

@@ -0,0 +1,302 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_defineProperty = require('../_virtual/_@oxc-project_runtime@0.103.0/helpers/defineProperty.cjs');
+const require_objectSpread2 = require('../_virtual/_@oxc-project_runtime@0.103.0/helpers/objectSpread2.cjs');
+const require_shared = require('./shared.cjs');
+const require_OperationDefinition = require('../OperationDefinition.cjs');
+const require_OperationPath = require('../OperationPath.cjs');
+const require_Operation = require('../Operation.cjs');
+const require_FractionalIndex = require('../FractionalIndex.cjs');
+require('../Primitive.cjs');
+let effect = require("effect");
+
+//#region src/primitives/Array.ts
+/**
+* Sort array entries by their fractional position
+*/
+const sortByPos = (entries) => [...entries].sort((a, b) => a.pos < b.pos ? -1 : a.pos > b.pos ? 1 : 0);
+/**
+* Generate a fractional position between two positions
+*/
+const generatePosBetween = (left, right) => {
+	const charSet = require_FractionalIndex.base62CharSet();
+	return effect.Effect.runSync(require_FractionalIndex.generateKeyBetween(left, right, charSet));
+};
+var ArrayPrimitive = class ArrayPrimitive {
+	constructor(schema) {
+		require_defineProperty._defineProperty(this, "_tag", "ArrayPrimitive");
+		require_defineProperty._defineProperty(this, "_State", void 0);
+		require_defineProperty._defineProperty(this, "_Proxy", void 0);
+		require_defineProperty._defineProperty(this, "_TRequired", void 0);
+		require_defineProperty._defineProperty(this, "_THasDefault", void 0);
+		require_defineProperty._defineProperty(this, "TSetInput", void 0);
+		require_defineProperty._defineProperty(this, "TUpdateInput", void 0);
+		require_defineProperty._defineProperty(this, "_schema", void 0);
+		require_defineProperty._defineProperty(this, "_opDefinitions", {
+			set: require_OperationDefinition.make({
+				kind: "array.set",
+				payload: effect.Schema.Unknown,
+				target: effect.Schema.Unknown,
+				apply: (payload) => payload
+			}),
+			insert: require_OperationDefinition.make({
+				kind: "array.insert",
+				payload: effect.Schema.Unknown,
+				target: effect.Schema.Unknown,
+				apply: (payload) => payload
+			}),
+			remove: require_OperationDefinition.make({
+				kind: "array.remove",
+				payload: effect.Schema.Unknown,
+				target: effect.Schema.Unknown,
+				apply: (payload) => payload
+			}),
+			move: require_OperationDefinition.make({
+				kind: "array.move",
+				payload: effect.Schema.Unknown,
+				target: effect.Schema.Unknown,
+				apply: (payload) => payload
+			})
+		});
+		require_defineProperty._defineProperty(this, "_internal", {
+			createProxy: (env, operationPath) => {
+				const elementPrimitive = this._schema.element;
+				const getCurrentState = () => {
+					const state = env.getState(operationPath);
+					if (!state || !globalThis.Array.isArray(state)) return [];
+					return sortByPos(state);
+				};
+				const applyElementDefaults = (value) => {
+					return require_shared.applyDefaults(elementPrimitive, value);
+				};
+				return {
+					get: () => {
+						return getCurrentState();
+					},
+					set: (values) => {
+						const entries = [];
+						let prevPos = null;
+						for (const value of values) {
+							const id = env.generateId();
+							const pos = generatePosBetween(prevPos, null);
+							const mergedValue = applyElementDefaults(value);
+							entries.push({
+								id,
+								pos,
+								value: mergedValue
+							});
+							prevPos = pos;
+						}
+						env.addOperation(require_Operation.fromDefinition(operationPath, this._opDefinitions.set, entries));
+					},
+					push: (value) => {
+						const sorted = getCurrentState();
+						const lastPos = sorted.length > 0 ? sorted[sorted.length - 1].pos : null;
+						const id = env.generateId();
+						const pos = generatePosBetween(lastPos, null);
+						const mergedValue = applyElementDefaults(value);
+						env.addOperation(require_Operation.fromDefinition(operationPath, this._opDefinitions.insert, {
+							id,
+							pos,
+							value: mergedValue
+						}));
+					},
+					insertAt: (index, value) => {
+						const sorted = getCurrentState();
+						const leftPos = index > 0 && sorted[index - 1] ? sorted[index - 1].pos : null;
+						const rightPos = index < sorted.length && sorted[index] ? sorted[index].pos : null;
+						const id = env.generateId();
+						const pos = generatePosBetween(leftPos, rightPos);
+						const mergedValue = applyElementDefaults(value);
+						env.addOperation(require_Operation.fromDefinition(operationPath, this._opDefinitions.insert, {
+							id,
+							pos,
+							value: mergedValue
+						}));
+					},
+					remove: (id) => {
+						env.addOperation(require_Operation.fromDefinition(operationPath, this._opDefinitions.remove, { id }));
+					},
+					move: (id, toIndex) => {
+						const without = getCurrentState().filter((e) => e.id !== id);
+						const clampedIndex = Math.max(0, Math.min(toIndex, without.length));
+						const pos = generatePosBetween(clampedIndex > 0 && without[clampedIndex - 1] ? without[clampedIndex - 1].pos : null, clampedIndex < without.length && without[clampedIndex] ? without[clampedIndex].pos : null);
+						env.addOperation(require_Operation.fromDefinition(operationPath, this._opDefinitions.move, {
+							id,
+							pos
+						}));
+					},
+					at: (id) => {
+						const elementPath = operationPath.append(id);
+						return elementPrimitive._internal.createProxy(env, elementPath);
+					},
+					find: (predicate) => {
+						const found = getCurrentState().find((entry) => predicate(entry.value, entry.id));
+						if (!found) return void 0;
+						const elementPath = operationPath.append(found.id);
+						return elementPrimitive._internal.createProxy(env, elementPath);
+					},
+					toSnapshot: () => {
+						return getCurrentState().map((entry) => {
+							const elementPath = operationPath.append(entry.id);
+							const elementProxy = elementPrimitive._internal.createProxy(env, elementPath);
+							return {
+								id: entry.id,
+								value: elementProxy.toSnapshot()
+							};
+						});
+					}
+				};
+			},
+			applyOperation: (state, operation) => {
+				const path = operation.path;
+				const tokens = path.toTokens().filter((t) => t !== "");
+				const currentState = state !== null && state !== void 0 ? state : [];
+				let newState;
+				if (tokens.length === 0) switch (operation.kind) {
+					case "array.set": {
+						const payload = operation.payload;
+						if (!globalThis.Array.isArray(payload)) throw new require_shared.ValidationError(`ArrayPrimitive.set requires an array payload`);
+						newState = payload;
+						break;
+					}
+					case "array.insert": {
+						const { id, pos, value } = operation.payload;
+						newState = [...currentState, {
+							id,
+							pos,
+							value
+						}];
+						break;
+					}
+					case "array.remove": {
+						const { id } = operation.payload;
+						newState = currentState.filter((entry) => entry.id !== id);
+						break;
+					}
+					case "array.move": {
+						const { id, pos } = operation.payload;
+						newState = currentState.map((entry) => entry.id === id ? require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, entry), {}, { pos }) : entry);
+						break;
+					}
+					default: throw new require_shared.ValidationError(`ArrayPrimitive cannot apply operation of kind: ${operation.kind}`);
+				}
+				else {
+					const elementId = tokens[0];
+					const entryIndex = currentState.findIndex((entry) => entry.id === elementId);
+					if (entryIndex === -1) throw new require_shared.ValidationError(`Array element not found with ID: ${elementId}`);
+					const elementPrimitive = this._schema.element;
+					const remainingPath = path.shift();
+					const elementOperation = require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, operation), {}, { path: remainingPath });
+					const currentEntry = currentState[entryIndex];
+					const newValue = elementPrimitive._internal.applyOperation(currentEntry.value, elementOperation);
+					const mutableState = [...currentState];
+					mutableState[entryIndex] = require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, currentEntry), {}, { value: newValue });
+					newState = mutableState;
+				}
+				require_shared.runValidators(newState, this._schema.validators);
+				return newState;
+			},
+			getInitialState: () => {
+				return this._schema.defaultValue;
+			},
+			transformOperation: (clientOp, serverOp) => {
+				const clientPath = clientOp.path;
+				const serverPath = serverOp.path;
+				if (!require_OperationPath.pathsOverlap(clientPath, serverPath)) return {
+					type: "transformed",
+					operation: clientOp
+				};
+				if (serverOp.kind === "array.remove") {
+					const removedId = serverOp.payload.id;
+					const clientTokens$1 = clientPath.toTokens().filter((t) => t !== "");
+					const serverTokens$1 = serverPath.toTokens().filter((t) => t !== "");
+					if (clientTokens$1.length > serverTokens$1.length) {
+						if (clientTokens$1[serverTokens$1.length] === removedId) return { type: "noop" };
+					}
+				}
+				if (serverOp.kind === "array.insert" && clientOp.kind === "array.insert") return {
+					type: "transformed",
+					operation: clientOp
+				};
+				if (serverOp.kind === "array.move" && clientOp.kind === "array.move") {
+					if (serverOp.payload.id === clientOp.payload.id) return {
+						type: "transformed",
+						operation: clientOp
+					};
+					return {
+						type: "transformed",
+						operation: clientOp
+					};
+				}
+				if (require_OperationPath.pathsEqual(clientPath, serverPath)) return {
+					type: "transformed",
+					operation: clientOp
+				};
+				if (serverOp.kind === "array.set" && require_OperationPath.isPrefix(serverPath, clientPath)) return {
+					type: "transformed",
+					operation: clientOp
+				};
+				const clientTokens = clientPath.toTokens().filter((t) => t !== "");
+				const serverTokens = serverPath.toTokens().filter((t) => t !== "");
+				if (clientTokens.length > 0 && serverTokens.length > 0) {
+					if (clientTokens[0] !== serverTokens[0]) return {
+						type: "transformed",
+						operation: clientOp
+					};
+					const elementPrimitive = this._schema.element;
+					const clientOpForElement = require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, clientOp), {}, { path: clientOp.path.shift() });
+					const serverOpForElement = require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, serverOp), {}, { path: serverOp.path.shift() });
+					const result = elementPrimitive._internal.transformOperation(clientOpForElement, serverOpForElement);
+					if (result.type === "transformed") return {
+						type: "transformed",
+						operation: require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, result.operation), {}, { path: clientOp.path })
+					};
+					return result;
+				}
+				return {
+					type: "transformed",
+					operation: clientOp
+				};
+			}
+		});
+		this._schema = schema;
+	}
+	/** Mark this array as required */
+	required() {
+		return new ArrayPrimitive(require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, this._schema), {}, { required: true }));
+	}
+	/** Set a default value for this array */
+	default(defaultValue) {
+		return new ArrayPrimitive(require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, this._schema), {}, { defaultValue }));
+	}
+	/** Get the element primitive */
+	get element() {
+		return this._schema.element;
+	}
+	/** Add a custom validation rule */
+	refine(fn, message) {
+		return new ArrayPrimitive(require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, this._schema), {}, { validators: [...this._schema.validators, {
+			validate: fn,
+			message
+		}] }));
+	}
+	/** Minimum array length */
+	minLength(length) {
+		return this.refine((v) => v.length >= length, `Array must have at least ${length} elements`);
+	}
+	/** Maximum array length */
+	maxLength(length) {
+		return this.refine((v) => v.length <= length, `Array must have at most ${length} elements`);
+	}
+};
+/** Creates a new ArrayPrimitive with the given element type */
+const Array = (element) => new ArrayPrimitive({
+	required: false,
+	defaultValue: void 0,
+	element,
+	validators: []
+});
+
+//#endregion
+exports.Array = Array;
+exports.ArrayPrimitive = ArrayPrimitive;

package/dist/primitives/Array.d.cts

@@ -0,0 +1,95 @@
+import { AnyPrimitive, InferProxy, InferSetInput, InferSnapshot, InferState, Primitive, PrimitiveInternal, Validator } from "./shared.cjs";
+import { StructPrimitive, StructSetInput } from "./Struct.cjs";
+
+//#region src/primitives/Array.d.ts
+
+/**
+ * Entry in an ordered array with ID and fractional position
+ */
+interface ArrayEntry<T> {
+  readonly id: string;
+  readonly pos: string;
+  readonly value: T;
+}
+/**
+ * Entry in an array snapshot with ID and value snapshot
+ */
+interface ArrayEntrySnapshot<TElement extends AnyPrimitive> {
+  readonly id: string;
+  readonly value: InferSnapshot<TElement>;
+}
+/**
+ * Snapshot type for arrays - always an array (never undefined)
+ */
+type ArraySnapshot<TElement extends AnyPrimitive> = readonly ArrayEntrySnapshot<TElement>[];
+/**
+ * Compute the input type for array element values.
+ * Uses StructSetInput directly for struct elements so that:
+ * - Fields that are required AND have no default must be provided
+ * - Fields that are optional OR have defaults can be omitted
+ *
+ * For non-struct elements, falls back to InferSetInput.
+ */
+type ArrayElementSetInput<TElement extends AnyPrimitive> = TElement extends StructPrimitive<infer TFields, any, any> ? StructSetInput<TFields> : InferSetInput<TElement>;
+interface ArrayProxy<TElement extends AnyPrimitive> {
+  /** Gets the current array entries (sorted by position) */
+  get(): ArrayState<TElement>;
+  /** Replaces the entire array with new values (generates new IDs and positions, applies defaults) */
+  set(values: readonly ArrayElementSetInput<TElement>[]): void;
+  /** Appends a value to the end of the array (applies defaults for struct elements) */
+  push(value: ArrayElementSetInput<TElement>): void;
+  /** Inserts a value at the specified visual index (applies defaults for struct elements) */
+  insertAt(index: number, value: ArrayElementSetInput<TElement>): void;
+  /** Removes the element with the specified ID */
+  remove(id: string): void;
+  /** Moves an element to a new visual index */
+  move(id: string, toIndex: number): void;
+  /** Returns a proxy for the element with the specified ID */
+  at(id: string): InferProxy<TElement>;
+  /** Finds an element by predicate and returns its proxy */
+  find(predicate: (value: InferState<TElement>, id: string) => boolean): InferProxy<TElement> | undefined;
+  /** Returns a readonly snapshot of the array for rendering (always returns an array, never undefined) */
+  toSnapshot(): ArraySnapshot<TElement>;
+}
+/** The state type for arrays - an array of entries */
+type ArrayState<TElement extends AnyPrimitive> = readonly ArrayEntry<InferState<TElement>>[];
+interface ArrayPrimitiveSchema<TElement extends AnyPrimitive> {
+  readonly required: boolean;
+  readonly defaultValue: ArrayState<TElement> | undefined;
+  readonly element: TElement;
+  readonly validators: readonly Validator<ArrayState<TElement>>[];
+}
+/** Input type for array set() - an array of element set inputs */
+type ArraySetInput<TElement extends AnyPrimitive> = readonly ArrayElementSetInput<TElement>[];
+/** Input type for array update() - same as set() for arrays */
+type ArrayUpdateInput<TElement extends AnyPrimitive> = readonly ArrayElementSetInput<TElement>[];
+declare class ArrayPrimitive<TElement extends AnyPrimitive, TRequired extends boolean = false, THasDefault extends boolean = false> implements Primitive<ArrayState<TElement>, ArrayProxy<TElement>, TRequired, THasDefault, ArraySetInput<TElement>, ArrayUpdateInput<TElement>> {
+  readonly _tag: "ArrayPrimitive";
+  readonly _State: ArrayState<TElement>;
+  readonly _Proxy: ArrayProxy<TElement>;
+  readonly _TRequired: TRequired;
+  readonly _THasDefault: THasDefault;
+  readonly TSetInput: ArraySetInput<TElement>;
+  readonly TUpdateInput: ArrayUpdateInput<TElement>;
+  private readonly _schema;
+  private readonly _opDefinitions;
+  constructor(schema: ArrayPrimitiveSchema<TElement>);
+  /** Mark this array as required */
+  required(): ArrayPrimitive<TElement, true, THasDefault>;
+  /** Set a default value for this array */
+  default(defaultValue: ArrayState<TElement>): ArrayPrimitive<TElement, TRequired, true>;
+  /** Get the element primitive */
+  get element(): TElement;
+  /** Add a custom validation rule */
+  refine(fn: (value: ArrayState<TElement>) => boolean, message: string): ArrayPrimitive<TElement, TRequired, THasDefault>;
+  /** Minimum array length */
+  minLength(length: number): ArrayPrimitive<TElement, TRequired, THasDefault>;
+  /** Maximum array length */
+  maxLength(length: number): ArrayPrimitive<TElement, TRequired, THasDefault>;
+  readonly _internal: PrimitiveInternal<ArrayState<TElement>, ArrayProxy<TElement>>;
+}
+/** Creates a new ArrayPrimitive with the given element type */
+declare const Array: <TElement extends AnyPrimitive>(element: TElement) => ArrayPrimitive<TElement, false, false>;
+//#endregion
+export { Array, ArrayElementSetInput, ArrayEntry, ArrayEntrySnapshot, ArrayPrimitive, ArrayProxy, ArraySetInput, ArraySnapshot, ArrayState, ArrayUpdateInput };
+//# sourceMappingURL=Array.d.cts.map

package/dist/primitives/Array.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Array.d.cts","names":[],"sources":["../../src/primitives/Array.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/primitives/Array.d.mts

@@ -0,0 +1,95 @@
+import { AnyPrimitive, InferProxy, InferSetInput, InferSnapshot, InferState, Primitive, PrimitiveInternal, Validator } from "./shared.mjs";
+import { StructPrimitive, StructSetInput } from "./Struct.mjs";
+import "../Primitive.mjs";
+
+//#region src/primitives/Array.d.ts
+/**
+ * Entry in an ordered array with ID and fractional position
+ */
+interface ArrayEntry<T> {
+  readonly id: string;
+  readonly pos: string;
+  readonly value: T;
+}
+/**
+ * Entry in an array snapshot with ID and value snapshot
+ */
+interface ArrayEntrySnapshot<TElement extends AnyPrimitive> {
+  readonly id: string;
+  readonly value: InferSnapshot<TElement>;
+}
+/**
+ * Snapshot type for arrays - always an array (never undefined)
+ */
+type ArraySnapshot<TElement extends AnyPrimitive> = readonly ArrayEntrySnapshot<TElement>[];
+/**
+ * Compute the input type for array element values.
+ * Uses StructSetInput directly for struct elements so that:
+ * - Fields that are required AND have no default must be provided
+ * - Fields that are optional OR have defaults can be omitted
+ *
+ * For non-struct elements, falls back to InferSetInput.
+ */
+type ArrayElementSetInput<TElement extends AnyPrimitive> = TElement extends StructPrimitive<infer TFields, any, any> ? StructSetInput<TFields> : InferSetInput<TElement>;
+interface ArrayProxy<TElement extends AnyPrimitive> {
+  /** Gets the current array entries (sorted by position) */
+  get(): ArrayState<TElement>;
+  /** Replaces the entire array with new values (generates new IDs and positions, applies defaults) */
+  set(values: readonly ArrayElementSetInput<TElement>[]): void;
+  /** Appends a value to the end of the array (applies defaults for struct elements) */
+  push(value: ArrayElementSetInput<TElement>): void;
+  /** Inserts a value at the specified visual index (applies defaults for struct elements) */
+  insertAt(index: number, value: ArrayElementSetInput<TElement>): void;
+  /** Removes the element with the specified ID */
+  remove(id: string): void;
+  /** Moves an element to a new visual index */
+  move(id: string, toIndex: number): void;
+  /** Returns a proxy for the element with the specified ID */
+  at(id: string): InferProxy<TElement>;
+  /** Finds an element by predicate and returns its proxy */
+  find(predicate: (value: InferState<TElement>, id: string) => boolean): InferProxy<TElement> | undefined;
+  /** Returns a readonly snapshot of the array for rendering (always returns an array, never undefined) */
+  toSnapshot(): ArraySnapshot<TElement>;
+}
+/** The state type for arrays - an array of entries */
+type ArrayState<TElement extends AnyPrimitive> = readonly ArrayEntry<InferState<TElement>>[];
+interface ArrayPrimitiveSchema<TElement extends AnyPrimitive> {
+  readonly required: boolean;
+  readonly defaultValue: ArrayState<TElement> | undefined;
+  readonly element: TElement;
+  readonly validators: readonly Validator<ArrayState<TElement>>[];
+}
+/** Input type for array set() - an array of element set inputs */
+type ArraySetInput<TElement extends AnyPrimitive> = readonly ArrayElementSetInput<TElement>[];
+/** Input type for array update() - same as set() for arrays */
+type ArrayUpdateInput<TElement extends AnyPrimitive> = readonly ArrayElementSetInput<TElement>[];
+declare class ArrayPrimitive<TElement extends AnyPrimitive, TRequired extends boolean = false, THasDefault extends boolean = false> implements Primitive<ArrayState<TElement>, ArrayProxy<TElement>, TRequired, THasDefault, ArraySetInput<TElement>, ArrayUpdateInput<TElement>> {
+  readonly _tag: "ArrayPrimitive";
+  readonly _State: ArrayState<TElement>;
+  readonly _Proxy: ArrayProxy<TElement>;
+  readonly _TRequired: TRequired;
+  readonly _THasDefault: THasDefault;
+  readonly TSetInput: ArraySetInput<TElement>;
+  readonly TUpdateInput: ArrayUpdateInput<TElement>;
+  private readonly _schema;
+  private readonly _opDefinitions;
+  constructor(schema: ArrayPrimitiveSchema<TElement>);
+  /** Mark this array as required */
+  required(): ArrayPrimitive<TElement, true, THasDefault>;
+  /** Set a default value for this array */
+  default(defaultValue: ArrayState<TElement>): ArrayPrimitive<TElement, TRequired, true>;
+  /** Get the element primitive */
+  get element(): TElement;
+  /** Add a custom validation rule */
+  refine(fn: (value: ArrayState<TElement>) => boolean, message: string): ArrayPrimitive<TElement, TRequired, THasDefault>;
+  /** Minimum array length */
+  minLength(length: number): ArrayPrimitive<TElement, TRequired, THasDefault>;
+  /** Maximum array length */
+  maxLength(length: number): ArrayPrimitive<TElement, TRequired, THasDefault>;
+  readonly _internal: PrimitiveInternal<ArrayState<TElement>, ArrayProxy<TElement>>;
+}
+/** Creates a new ArrayPrimitive with the given element type */
+declare const Array: <TElement extends AnyPrimitive>(element: TElement) => ArrayPrimitive<TElement, false, false>;
+//#endregion
+export { Array, ArrayElementSetInput, ArrayEntry, ArrayEntrySnapshot, ArrayPrimitive, ArrayProxy, ArraySetInput, ArraySnapshot, ArrayState, ArrayUpdateInput };
+//# sourceMappingURL=Array.d.mts.map

package/dist/primitives/Array.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Array.d.mts","names":[],"sources":["../../src/primitives/Array.ts"],"sourcesContent":[],"mappings":"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"}