@shapeshift-labs/frontier-mutation 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shapeshift Labs
+
+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/README.md

@@ -2,6 +2,10 @@
 
 Explicit mutation and selector plans for Frontier.
 
+Repository: [siliconjungle/-shapeshift-labs-frontier-mutation](https://github.com/siliconjungle/-shapeshift-labs-frontier-mutation)
+
+Built on the core JSON diff/apply package: [`@shapeshift-labs/frontier`](https://github.com/siliconjungle/-shapeshift-labs-frontier).
+
 ```sh
 npm install @shapeshift-labs/frontier @shapeshift-labs/frontier-mutation
 ```
@@ -13,7 +17,9 @@ import { createMutationPlan, select } from '@shapeshift-labs/frontier-mutation';
 
 const enemies = select('/entities/*')
   .where('type', '==', 'enemy')
-  .and('hp', '>', 0);
+  .and('hp', '>', 0)
+  .keyBy('id')
+  .indexBy('id');
 
 const plan = createMutationPlan()
   .forEach(enemies)
@@ -24,6 +30,175 @@ const result = plan.compilePatch(state);
 
 The compiled patch contains concrete paths, indexes, and values. Queries are compile-time selectors, not replay-time patch semantics.
 
+The public surface is intentionally small: build selectors, build a mutation plan, then compile or commit it. Planner choices, compiler passes, and CRDT lowering stay behind options and result metadata.
+
+## Performance
+
+Frontier Mutation was measured from this package on Node v26.1.0, darwin arm64. Timings are median microseconds per operation across warmed samples; p95 is shown to make noise visible. Patch bytes are `JSON.stringify(patch)` bytes because this package emits Frontier patches and does not own binary transport encoding.
+
+| Fixture | Matches | Strategy | Patch | Bytes | Compile median | Compile p95 | Apply median |
+| --- | ---: | --- | ---: | ---: | ---: | ---: | ---: |
+| Selector increment, 1% sparse 10k-row table | 100 | row-field | 1 op | 1.0 KiB | 3.55 ms | 4.04 ms | 10.35 us |
+| Selector increment, indexed id IN | 100 | row-field | 1 op | 1.0 KiB | 2.84 ms | 3.12 ms | 8.77 us |
+| Selector increment, 10% 10k-row table | 1,000 | row-field | 1 op | 8.5 KiB | 4.10 ms | 4.90 ms | 20.33 us |
+| Repeated arithmetic fold, 1000x | 0 | direct | 1 op | 20 B | 0.45 us | 0.78 us | 0.05 us |
+| Repeated text append fold, 1000x | 0 | direct | 1 op | 1.0 KiB | 0.55 us | 0.72 us | 0.10 us |
+
+These are Frontier-only package measurements, not a competitor comparison. Hardware, Node version, selector shape, and table size will affect absolute timings.
+
+## API Overview
+
+```ts
+import {
+  compileMutationPlan,
+  commitCrdtMutation,
+  commitMutation,
+  createMutationPlan,
+  createSelectorRegistry,
+  select,
+  type MutationCompileResult,
+  type MutationPlannerDecision,
+  type MutationPlanLike,
+  type MutationStateEngine
+} from '@shapeshift-labs/frontier-mutation';
+```
+
+Core exports:
+
+- `select(path)` creates a selector builder for array/object-map rows.
+- `createSelectorRegistry(initial?)` stores reusable named selectors.
+- `createMutationPlan()` creates a fluent mutation plan.
+- `compileMutationPlan(plan, state, options?)` compiles intent into a normal Frontier patch.
+- `commitMutation(stateEngine, plan, options?)` compiles and commits to any state engine with `get()` and `commitPatch()`.
+- `commitCrdtMutation(doc, plan, options?)` lowers safe intent to native CRDT operations when the document supports them.
+
+The package has a peer dependency on the core package only. State and CRDT integration use small structural interfaces, so the mutation package does not force the full state or CRDT packages into the core import path.
+
+## Selectors
+
+Selectors support arrays, object maps, and multiple wildcard segments:
+
+```js
+const inNestedRooms = select('/rooms/*/entities/*')
+  .where('type', '==', 'enemy')
+  .keyBy('id');
+
+const byMapKey = select('/entitiesById/*')
+  .where('$key', 'in', ['e1', 'e2'])
+  .keyBy('$key');
+```
+
+`$key` targets the current object-map key and `$index` targets the current array index. `keyBy(path)` controls the stable match key reported in `result.matches`; `indexBy(path)` is a compile-time hint for equality/in selectors on hot entity tables and object maps.
+
+Selectors can also make the mutation target deterministic with ordering, limits, and projections:
+
+```js
+const strongestEnemy = select('/entities/*')
+  .where('type', '==', 'enemy')
+  .orderBy('hp', 'desc')
+  .first()
+  .project('id', 'hp')
+  .keyBy('id');
+```
+
+`limit(n)` caps matched rows after ordering, `first()` is `limit(1)`, and `project(...)` adds a compact field projection to `result.matches` for diagnostics and agent-readable explanations.
+
+Reusable selectors can be named and stored in a registry:
+
+```js
+import { createSelectorRegistry } from '@shapeshift-labs/frontier-mutation';
+
+const selectors = createSelectorRegistry()
+  .define('activeEnemies', enemies.named('activeEnemies'));
+
+const plan = createMutationPlan()
+  .forEach(selectors.get('activeEnemies'))
+  .increment('hp', -5);
+```
+
+Selectors can also be scoped with a callback so later operations return to the previous selector:
+
+```js
+const plan = createMutationPlan()
+  .forEach(enemies, (rows) => {
+    rows.increment('hp', -5)
+      .append('tags', 'damaged');
+  })
+  .increment('/turn', 1);
+```
+
+`compilePatch()` runs a small planner before it emits the patch. In `auto` mode it chooses between direct patch emission, row-field assignment, dirty-row/dirty-path diffing, and materialize-and-diff fallback based on the mutation shape and selector selectivity.
+
+```js
+const result = plan.compilePatch(state, {
+  planner: {
+    strategy: 'auto',
+    schema: {
+      tables: [{
+        path: '/entities',
+        key: 'id',
+        stableRowShape: true,
+        numericFields: ['hp', 'stats.score'],
+        textFields: ['name', 'zoneId'],
+        listFields: ['tags'],
+        selectorFields: ['id', 'type', 'hp', 'zoneId']
+      }]
+    },
+    dirtyDiffMinSelectivity: 0.75
+  }
+});
+
+result.decisions;
+// [{ strategy: 'row-field' | 'dirty-diff' | 'direct' | ... }]
+```
+
+Strategies can be forced for diagnostics or benchmarking with `direct`, `row-field`, `dirty-diff`, or `materialize-diff`.
+
+Schema hints are trusted table/entity contracts. The key field becomes the default selector `keyBy`/`indexBy`, stable row shape lets the planner reuse selector matches across adjacent mutations that do not touch declared selector fields, and known numeric/text/list fields are reported in planner decisions for debugging and downstream specialization.
+
+If you already use `createDiffEngine()` with schema, profile, or adaptive settings, pass it as `planner.diffEngine`. The planner will use that engine when it chooses a dirty diff or materialize-and-diff path.
+
+## Mutation Operations
+
+Plan methods include:
+
+- object/value: `set`, `unset`, `remove`, `ensure`, `upsert`, `assign`, `rename`, `copy`, `move`
+- numbers: `increment`, `decrement`, `multiply`, `min`, `max`, `clamp`
+- booleans: `toggle`
+- arrays/lists: `append`, `prepend`, `splice`, `insert`, `removeAt`, `moveItem`, `addToSet`, `pull`, `removeWhere`
+- text: `appendText`, `insertText`, `deleteText`, `replaceText`, `spliceText`, `formatText`
+- guards: `test`, `compareAndSet`
+- control: `forEach`, `where`, `clearSelector`, `transaction`, `repeat`, `explain`
+
+Examples:
+
+```js
+const plan = createMutationPlan()
+  .ensure('/session', { started: true })
+  .upsert('/profile', { level: 3 })
+  .compareAndSet('/version', 1, 2)
+  .insert('/items', 0, { id: 'first' })
+  .addToSet('/tags', ['new', 'seen'])
+  .replaceText('/title', 0, 5, 'Draft')
+  .transaction((tx) => {
+    tx.rename('/profile/name', 'label');
+    tx.remove('/profile/stale');
+  }, { origin: 'agent-edit' });
+
+const explanation = plan.explain(state);
+```
+
+`test(path, expected)` and `compareAndSet(path, expected, next)` are compile-time guards. If the current state does not match `expected`, compilation throws before a patch or CRDT update is emitted.
+
+Compiled results include:
+
+- `patch`: the Frontier patch to apply or send
+- `matched`: weighted selector matches
+- `lowered`: lowering notes for diagnostics
+- `dirtyPaths` / `dirtyRows`: locality passed to diff planning
+- `matches`: selector matches with resolved paths
+- `decisions`: planner choices and reasons
+
 Adjacent arithmetic and repeated calls are folded where Frontier can represent the result compactly:
 
 ```js
@@ -35,11 +210,41 @@ plan.compilePatch({ count: 0 }).patch;
 // [[OP_SET, ['count'], 50]]
 ```
 
+The compiler also folds adjacent compatible operations before lowering:
+
+- arithmetic runs such as `+1, +2, -1` become one `+2`
+- repeated list appends and text appends become one append operation
+- statically empty repeats and even toggle repeats are removed
+- selector operations can merge only when the mutation cannot affect selector membership
+
+Selector row-field batching still checks the resolved row set at compile time. If a selector-targeted mutation changes which rows match the next operation, the compiler leaves a barrier and emits separate row-field frontiers.
+
 State engines and CRDT documents can be committed directly:
 
 ```js
 import { commitCrdtMutation, commitMutation } from '@shapeshift-labs/frontier-mutation';
 
 commitMutation(stateEngine, plan);
-commitCrdtMutation(doc, plan);
+plan.commit(stateEngine);
+
+commitCrdtMutation(doc, plan, {
+  planner: {
+    crdt: 'auto',
+    crdtAssignmentPolicy: 'preserve-conflicts',
+    crdtMetadata: { source: 'combat-system' }
+  }
+});
+plan.commitCrdt(doc);
 ```
+
+CRDT commits lower intent to native operations when that is semantically safe:
+
+- arithmetic becomes native counters
+- list appends, inserts, removes, moves, and splices become native list operations
+- text appends, inserts, deletes, replaces, and safe text splices become native text operations
+- object field updates can become map field assignments instead of whole-object replacement
+- deletes can become native CRDT tombstones
+
+`crdtAssignmentPolicy` controls assignment lowering. `preserve-conflicts` keeps object updates at field granularity so concurrent same-field register conflicts remain inspectable and resolvable. `last-write-wins` and `materialize` keep the older whole-value materialization behavior for assignment-shaped operations.
+
+`crdtMetadata` is passed through Frontier's durable CRDT update metadata. The returned `crdtDecisions` list also includes per-operation debug metadata with the chosen strategy, reason, path, repeat count, and operation size summary.

package/dist/index.d.ts

@@ -1,8 +1,47 @@
-import { type JsonObject, type JsonPath, type JsonValue, type ObjectKey, type Patch } from '@shapeshift-labs/frontier';
-import type { StateEngine } from '@shapeshift-labs/frontier/state';
-import type { CrdtCommitResult, CrdtDocument } from '@shapeshift-labs/frontier/crdt';
+import { type DiffOptions, type JsonObject, type JsonPath, type JsonValue, type ObjectKey, type Patch } from '@shapeshift-labs/frontier';
 export type MutationPath = string | JsonPath;
+export interface MutationStateEngine {
+    get(): JsonValue;
+    commitPatch(patch: Patch): unknown;
+}
+export type MutationCrdtCommit = unknown;
+export interface MutationCrdtDocument {
+    toJSON(): JsonValue;
+    change(callback: (tx: MutationCrdtTransaction) => void, options?: {
+        metadata?: JsonObject;
+    }): MutationCrdtCommit;
+    changesSince(frontier: null | JsonValue): Array<{
+        type: string;
+        path: JsonPath;
+        keys?: string[];
+    }>;
+}
+export interface MutationCrdtCounterHandle {
+    increment(delta: number): void;
+    decrement(delta: number): void;
+}
+export interface MutationCrdtTextHandle {
+    insert(index: number, text: string): void;
+    splice(index: number, deleteCount: number, text?: string): void;
+}
+export interface MutationCrdtListHandle {
+    insert(index: number, values: JsonValue[]): void;
+    delete(index: number, count?: number): void;
+    move(fromIndex: number, toIndex: number, count?: number): void;
+}
+export interface MutationCrdtMapHandle {
+    set(key: ObjectKey, value: JsonValue): void;
+}
+export interface MutationCrdtTransaction {
+    set(path: JsonPath, value: JsonValue): void;
+    delete(path: JsonPath): void;
+    counter(path: JsonPath): MutationCrdtCounterHandle;
+    text(path: JsonPath): MutationCrdtTextHandle;
+    list(path: JsonPath): MutationCrdtListHandle;
+    map(path: JsonPath): MutationCrdtMapHandle;
+}
 export type SelectorOperator = '==' | 'eq' | '!=' | 'neq' | '>' | 'gt' | '>=' | 'gte' | '<' | 'lt' | '<=' | 'lte' | 'in' | 'exists';
+export type SelectorOrderDirection = 'asc' | 'desc';
 export type SelectorCondition = {
     field: MutationPath;
     op?: SelectorOperator;
@@ -22,30 +61,141 @@ export type SelectorCondition = {
 } | {
     not: SelectorCondition;
 };
-export type MutationOperationKind = 'set' | 'assign' | 'increment' | 'decrement' | 'toggle' | 'append' | 'splice' | 'appendText' | 'spliceText';
+export type MutationOperationKind = 'set' | 'unset' | 'remove' | 'ensure' | 'upsert' | 'assign' | 'increment' | 'decrement' | 'multiply' | 'min' | 'max' | 'clamp' | 'toggle' | 'append' | 'prepend' | 'splice' | 'insert' | 'removeAt' | 'moveItem' | 'addToSet' | 'pull' | 'removeWhere' | 'appendText' | 'spliceText' | 'insertText' | 'deleteText' | 'replaceText' | 'formatText' | 'move' | 'copy' | 'rename' | 'test' | 'compareAndSet';
+export type MutationValueFactory = (current: JsonValue | undefined, path: JsonPath) => JsonValue;
+export type MutationArrayPredicate = (value: JsonValue, index: number, array: readonly JsonValue[]) => boolean;
+export interface MutationTransactionOptions {
+    origin?: string;
+    metadata?: JsonObject;
+    timestamp?: number;
+}
+export interface MutationTransactionInfo {
+    origin?: string;
+    metadata?: JsonObject;
+    timestamp?: number;
+}
 export interface SelectorPlan {
     path: JsonPath;
     conditions: SelectorCondition[];
-    keyBy?: ObjectKey;
+    keyBy?: JsonPath;
+    indexBy?: JsonPath;
+    orderBy?: {
+        path: JsonPath;
+        direction: SelectorOrderDirection;
+    };
+    limit?: number;
+    project?: JsonPath[];
+    name?: string;
+}
+export interface MutationTableSchema {
+    /** Path to an array table or object-map table, without the wildcard segment. */
+    path: MutationPath;
+    /** Stable row identity field. Used as default keyBy/indexBy for selectors over this table. */
+    key?: MutationPath;
+    /** Trusted claim that row objects have a stable field layout. */
+    stableRowShape?: boolean;
+    /** Fields known to contain numbers. */
+    numericFields?: MutationPath[];
+    /** Fields known to contain strings. */
+    textFields?: MutationPath[];
+    /** Fields known to contain arrays/lists. */
+    listFields?: MutationPath[];
+    /** Fields expected to participate in selector predicates for this table. */
+    selectorFields?: MutationPath[];
+}
+export interface MutationShapeSchema {
+    tables?: MutationTableSchema[];
+    /** Alias for table-like entity collections. */
+    entities?: MutationTableSchema[];
 }
+export type MutationSchemaInput = MutationShapeSchema | MutationTableSchema[];
 export interface MutationOperation {
     kind: MutationOperationKind;
     path: JsonPath;
+    to?: JsonPath;
+    key?: ObjectKey;
     value?: JsonValue;
+    expected?: JsonValue;
     values?: JsonValue[];
+    factory?: MutationValueFactory;
+    predicate?: MutationArrayPredicate;
     start?: number;
+    toIndex?: number;
     deleteCount?: number;
+    length?: number;
     text?: string;
+    attributes?: JsonObject;
     delta?: number;
+    min?: number;
+    max?: number;
     repeat: number;
     selector?: SelectorPlan;
+    transaction?: MutationTransactionInfo;
 }
 export interface MutationCompileOptions {
     compact?: boolean;
+    strategy?: MutationPatchStrategy;
+    diff?: DiffOptions;
+    planner?: MutationPlannerOptions;
+}
+export type MutationPatchStrategy = 'auto' | 'direct' | 'row-field' | 'dirty-diff' | 'materialize-diff';
+export type MutationPlannerDecisionStrategy = 'direct' | 'row-field' | 'dirty-diff' | 'materialize-diff' | 'noop';
+export type MutationCrdtStrategy = 'auto' | 'native' | 'materialize';
+export type MutationCrdtDecisionStrategy = 'native-counter' | 'native-text' | 'native-text-splice' | 'native-list' | 'native-map-field' | 'native-delete' | 'materialized-set' | 'noop';
+export type MutationCrdtAssignmentPolicy = 'preserve-conflicts' | 'last-write-wins' | 'materialize';
+export interface MutationDiffEngine {
+    diff(source: JsonValue, target: JsonValue, options?: DiffOptions): Patch;
+}
+export interface MutationPlannerOptions {
+    strategy?: MutationPatchStrategy;
+    crdt?: MutationCrdtStrategy;
+    crdtAssignmentPolicy?: MutationCrdtAssignmentPolicy;
+    crdtMetadata?: JsonObject;
+    schema?: MutationSchemaInput;
+    diff?: DiffOptions;
+    diffEngine?: MutationDiffEngine;
+    dirtyDiffMinSelectivity?: number;
+}
+export interface MutationDirtyRowsFrontier {
+    path: JsonPath;
+    rows: number[];
+    fields?: JsonPath[];
+}
+export interface MutationPlannerDecision {
+    strategy: MutationPlannerDecisionStrategy;
+    reason: string;
+    kind: MutationOperationKind;
+    path: JsonPath;
+    selectorPath?: JsonPath;
+    matched?: number;
+    collectionSize?: number;
+    selectivity?: number | null;
+    dirtyPaths?: JsonPath[];
+    dirtyRows?: MutationDirtyRowsFrontier[];
+    schema?: MutationPlannerSchemaDecision;
+}
+export interface MutationPlannerSchemaDecision {
+    tablePath: JsonPath;
+    key?: JsonPath;
+    stableRowShape: boolean;
+    fieldKind?: 'numeric' | 'text' | 'list';
+    selectorCached?: boolean;
+    selectorIndexed?: boolean;
+}
+export interface MutationCrdtPlannerDecision {
+    strategy: MutationCrdtDecisionStrategy;
+    reason: string;
+    kind: MutationOperationKind;
+    path: JsonPath;
+    selectorPath?: JsonPath;
+    native: boolean;
+    assignmentPolicy?: MutationCrdtAssignmentPolicy;
+    metadata?: JsonObject;
 }
 export interface MutationSelectorMatch {
     path: JsonPath;
     row: ObjectKey;
+    projection?: JsonObject;
 }
 export interface MutationCompileResult {
     patch: Patch;
@@ -59,14 +209,23 @@ export interface MutationCompileResult {
     }>;
     warnings: string[];
     matches: MutationSelectorMatch[];
+    decisions: MutationPlannerDecision[];
+}
+export interface MutationPlanExplanation extends MutationCompileResult {
+    operations: MutationOperation[];
+    operationCount: number;
+    patchOperationCount: number;
 }
 export interface MutationCrdtCommitResult extends MutationCompileResult {
-    commit: CrdtCommitResult;
+    commit: MutationCrdtCommit;
+    crdtDecisions: MutationCrdtPlannerDecision[];
 }
 export interface MutationPlanLike {
     readonly operations: readonly MutationOperation[];
     compilePatch(state: JsonValue | undefined, options?: MutationCompileOptions): MutationCompileResult;
 }
+export type MutationPlanScope = (plan: MutationPlan) => void;
+type SelectorRegistryInit = Record<string, SelectorBuilder | SelectorPlan> | Iterable<readonly [string, SelectorBuilder | SelectorPlan]>;
 export declare class SelectorBuilder {
     private readonly plan;
     constructor(path: MutationPath);
@@ -74,32 +233,77 @@ export declare class SelectorBuilder {
     and(fieldOrCondition: MutationPath | SelectorCondition, op?: SelectorOperator, value?: JsonValue | JsonValue[]): this;
     or(...conditions: SelectorCondition[]): this;
     not(condition: SelectorCondition): this;
-    keyBy(key: ObjectKey): this;
+    keyBy(key: MutationPath): this;
+    indexBy(key?: MutationPath): this;
+    orderBy(path: MutationPath, direction?: SelectorOrderDirection): this;
+    limit(count: number): this;
+    first(): this;
+    project(...fields: MutationPath[]): this;
+    named(name: string): this;
     toPlan(): SelectorPlan;
 }
+export declare class SelectorRegistry {
+    private readonly selectors;
+    constructor(initial?: SelectorRegistryInit);
+    define(name: string, selector: SelectorBuilder | SelectorPlan): this;
+    get(name: string): SelectorPlan;
+    has(name: string): boolean;
+    entries(): Array<[string, SelectorPlan]>;
+}
 export declare class MutationPlan implements MutationPlanLike {
     private readonly ops;
     private currentSelector;
+    private readonly transactionStack;
     get operations(): readonly MutationOperation[];
-    forEach(selector: SelectorBuilder | SelectorPlan): this;
+    forEach(selector: SelectorBuilder | SelectorPlan, scope?: MutationPlanScope): this;
     where(path: MutationPath, condition?: SelectorCondition): this;
     clearSelector(): this;
     set(path: MutationPath, value: JsonValue): this;
+    unset(path: MutationPath): this;
+    remove(path: MutationPath): this;
+    ensure(path: MutationPath, defaultValue: JsonValue | MutationValueFactory): this;
+    upsert(path: MutationPath, value: JsonValue | MutationValueFactory): this;
     assign(path: MutationPath, value: JsonObject): this;
     increment(path: MutationPath, delta?: number): this;
     decrement(path: MutationPath, delta?: number): this;
+    multiply(path: MutationPath, factor: number): this;
+    min(path: MutationPath, value: number): this;
+    max(path: MutationPath, value: number): this;
+    clamp(path: MutationPath, min: number, max: number): this;
     toggle(path: MutationPath): this;
     append(path: MutationPath, values: JsonValue | JsonValue[]): this;
+    prepend(path: MutationPath, values: JsonValue | JsonValue[]): this;
     splice(path: MutationPath, start: number, deleteCount: number, values?: JsonValue[]): this;
+    insert(path: MutationPath, index: number, values: JsonValue | JsonValue[]): this;
+    removeAt(path: MutationPath, index: number, count?: number): this;
+    moveItem(path: MutationPath, fromIndex: number, toIndex: number, count?: number): this;
+    addToSet(path: MutationPath, values: JsonValue | JsonValue[]): this;
+    pull(path: MutationPath, values: JsonValue | JsonValue[]): this;
+    removeWhere(path: MutationPath, predicate: MutationArrayPredicate): this;
     appendText(path: MutationPath, text: string): this;
     spliceText(path: MutationPath, start: number, deleteCount: number, text?: string): this;
+    insertText(path: MutationPath, index: number, text: string): this;
+    deleteText(path: MutationPath, index: number, count: number): this;
+    replaceText(path: MutationPath, index: number, count: number, text: string): this;
+    formatText(path: MutationPath, index: number, length: number, attributes: JsonObject): this;
+    move(from: MutationPath, to: MutationPath): this;
+    copy(from: MutationPath, to: MutationPath): this;
+    rename(path: MutationPath, newKey: ObjectKey): this;
+    test(path: MutationPath, expected: JsonValue): this;
+    compareAndSet(path: MutationPath, expected: JsonValue, next: JsonValue | MutationValueFactory): this;
+    transaction(scope: MutationPlanScope, options?: MutationTransactionOptions): this;
     repeat(count: number): this;
     compilePatch(state: JsonValue | undefined, options?: MutationCompileOptions): MutationCompileResult;
+    commit(state: MutationStateEngine, options?: MutationCompileOptions): MutationCompileResult;
+    commitCrdt(doc: MutationCrdtDocument, options?: MutationCompileOptions): MutationCrdtCommitResult;
+    explain(state: JsonValue | undefined, options?: MutationCompileOptions): MutationPlanExplanation;
     private push;
 }
 export declare function select(path: MutationPath): SelectorBuilder;
 export declare function createMutationPlan(): MutationPlan;
+export declare function createSelectorRegistry(initial?: SelectorRegistryInit): SelectorRegistry;
 export declare function compileMutationPlan(plan: MutationPlanLike, state: JsonValue | undefined, options?: MutationCompileOptions): MutationCompileResult;
-export declare function commitMutation(state: StateEngine, plan: MutationPlanLike, options?: MutationCompileOptions): MutationCompileResult;
-export declare function commitCrdtMutation(doc: CrdtDocument, plan: MutationPlanLike, options?: MutationCompileOptions): MutationCrdtCommitResult;
+export declare function commitMutation(state: MutationStateEngine, plan: MutationPlanLike, options?: MutationCompileOptions): MutationCompileResult;
+export declare function commitCrdtMutation(doc: MutationCrdtDocument, plan: MutationPlanLike, options?: MutationCompileOptions): MutationCrdtCommitResult;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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