@opendaw/lib-box 0.0.6

package/dist/primitive.d.ts

@@ -0,0 +1,110 @@
+import { Field, FieldConstruct } from "./field";
+import { PointerTypes, UnreferenceableType } from "./pointer";
+import { ByteArrayInput, ByteArrayOutput, DataInput, DataOutput, float, int, MutableObservableValue, Nullish, ObservableValue, Observer, Subscription } from "@opendaw/lib-std";
+import { VertexVisitor } from "./vertex";
+export type PrimitiveValues = float | int | string | boolean | Readonly<Int8Array>;
+export declare enum PrimitiveType {
+    Boolean = "boolean",
+    Float32 = "float32",
+    Int32 = "int32",
+    String = "string",
+    Bytes = "bytes"
+}
+export interface ValueSerialization<V extends PrimitiveValues = PrimitiveValues> {
+    get type(): PrimitiveType;
+    encode(output: DataOutput, value: V): void;
+    decode(input: DataInput): V;
+}
+export declare const ValueSerialization: {
+    readonly boolean: {
+        readonly type: PrimitiveType.Boolean;
+        readonly encode: (output: DataOutput, value: boolean) => void;
+        readonly decode: (input: DataInput) => boolean;
+    };
+    readonly float32: {
+        readonly type: PrimitiveType.Float32;
+        readonly encode: (output: DataOutput, value: float) => void;
+        readonly decode: (input: DataInput) => float;
+    };
+    readonly int32: {
+        readonly type: PrimitiveType.Int32;
+        readonly encode: (output: DataOutput, value: int) => void;
+        readonly decode: (input: DataInput) => int;
+    };
+    readonly string: {
+        readonly type: PrimitiveType.String;
+        readonly encode: (output: DataOutput, value: string) => void;
+        readonly decode: (input: DataInput) => string;
+    };
+    readonly bytes: {
+        readonly type: PrimitiveType.Bytes;
+        readonly encode: (output: DataOutput, value: Readonly<Int8Array>) => void;
+        readonly decode: (input: DataInput) => Readonly<Int8Array>;
+    };
+};
+export declare abstract class PrimitiveField<V extends PrimitiveValues = PrimitiveValues, P extends PointerTypes = UnreferenceableType> extends Field<P, never> implements MutableObservableValue<V> {
+    #private;
+    protected constructor(field: FieldConstruct<P>, type: PrimitiveType, value: V);
+    accept<RETURN>(visitor: VertexVisitor<RETURN>): Nullish<RETURN>;
+    subscribe(observer: Observer<ObservableValue<V>>): Subscription;
+    catchupAndSubscribe(observer: Observer<ObservableValue<V>>): Subscription;
+    abstract serialization(): ValueSerialization<V>;
+    abstract equals(value: V): boolean;
+    abstract clamp(value: V): V;
+    get type(): PrimitiveType;
+    get initValue(): V;
+    setInitValue(value: V): void;
+    getValue(): V;
+    setValue(value: V): void;
+    writeValue(output: ByteArrayOutput, value: V): void;
+    readValue(input: ByteArrayInput): V;
+    reset(): void;
+}
+export declare class BooleanField<E extends PointerTypes = UnreferenceableType> extends PrimitiveField<boolean, E> {
+    static create<E extends PointerTypes = UnreferenceableType>(construct: FieldConstruct<E>, value?: boolean): BooleanField<E>;
+    private constructor();
+    toggle(): void;
+    serialization(): ValueSerialization<boolean>;
+    equals(value: boolean): boolean;
+    clamp(value: boolean): boolean;
+    read(input: DataInput): void;
+    write(output: DataOutput): void;
+}
+export declare class Float32Field<E extends PointerTypes = UnreferenceableType> extends PrimitiveField<float, E> {
+    static create<E extends PointerTypes = UnreferenceableType>(construct: FieldConstruct<E>, value?: float): Float32Field<E>;
+    private constructor();
+    serialization(): ValueSerialization<float>;
+    equals(value: float): boolean;
+    clamp(value: float): float;
+    read(input: DataInput): void;
+    write(output: DataOutput): void;
+}
+export declare class Int32Field<E extends PointerTypes = UnreferenceableType> extends PrimitiveField<int, E> {
+    static create<E extends PointerTypes = UnreferenceableType>(construct: FieldConstruct<E>, value?: int): Int32Field<E>;
+    private constructor();
+    serialization(): ValueSerialization<int>;
+    equals(value: int): boolean;
+    clamp(value: int): int;
+    read(input: DataInput): void;
+    write(output: DataOutput): void;
+}
+export declare class StringField<E extends PointerTypes = UnreferenceableType> extends PrimitiveField<string, E> {
+    static create<E extends PointerTypes = UnreferenceableType>(construct: FieldConstruct<E>, value?: string): StringField<E>;
+    private constructor();
+    serialization(): ValueSerialization<string>;
+    equals(value: string): boolean;
+    clamp(value: string): string;
+    read(input: DataInput): void;
+    write(output: DataOutput): void;
+}
+export declare class ByteArrayField<E extends PointerTypes = UnreferenceableType> extends PrimitiveField<Readonly<Int8Array>, E> {
+    #private;
+    static create<E extends PointerTypes = UnreferenceableType>(construct: FieldConstruct<E>, value?: Readonly<Int8Array>): ByteArrayField<E>;
+    private constructor();
+    serialization(): ValueSerialization<Readonly<Int8Array>>;
+    equals(value: Readonly<Int8Array>): boolean;
+    clamp(value: Readonly<Int8Array>): Readonly<Int8Array>;
+    read(input: DataInput): void;
+    write(output: DataOutput): void;
+}
+//# sourceMappingURL=primitive.d.ts.map

package/dist/primitive.d.ts.map

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

package/dist/primitive.js

@@ -0,0 +1,152 @@
+import { Field } from "./field";
+import { assert, Float, Integer, safeExecute } from "@opendaw/lib-std";
+import { Propagation } from "./dispatchers";
+export var PrimitiveType;
+(function (PrimitiveType) {
+    PrimitiveType["Boolean"] = "boolean";
+    PrimitiveType["Float32"] = "float32";
+    PrimitiveType["Int32"] = "int32";
+    PrimitiveType["String"] = "string";
+    PrimitiveType["Bytes"] = "bytes";
+})(PrimitiveType || (PrimitiveType = {}));
+export const ValueSerialization = {
+    [PrimitiveType.Boolean]: {
+        type: PrimitiveType.Boolean,
+        encode: (output, value) => output.writeBoolean(value),
+        decode: (input) => input.readBoolean()
+    },
+    [PrimitiveType.Float32]: {
+        type: PrimitiveType.Float32,
+        encode: (output, value) => output.writeFloat(value),
+        decode: (input) => input.readFloat()
+    },
+    [PrimitiveType.Int32]: {
+        type: PrimitiveType.Int32,
+        encode: (output, value) => output.writeInt(value),
+        decode: (input) => input.readInt()
+    },
+    [PrimitiveType.String]: {
+        type: PrimitiveType.String,
+        encode: (output, value) => output.writeString(value),
+        decode: (input) => input.readString()
+    },
+    [PrimitiveType.Bytes]: {
+        type: PrimitiveType.Bytes,
+        encode: (output, value) => {
+            output.writeInt(value.length);
+            output.writeBytes(value);
+        },
+        decode: (input) => {
+            const array = new Int8Array(input.readInt());
+            input.readBytes(array);
+            return array;
+        }
+    }
+};
+export class PrimitiveField extends Field {
+    #type;
+    #initValue;
+    #value;
+    constructor(field, type, value) {
+        super(field);
+        this.#type = type;
+        this.#initValue = this.clamp(value);
+        this.#value = this.#initValue;
+    }
+    accept(visitor) {
+        return safeExecute(visitor.visitPrimitiveField, this);
+    }
+    subscribe(observer) {
+        return this.graph.subscribeVertexUpdates(Propagation.This, this.address, () => observer(this));
+    }
+    catchupAndSubscribe(observer) {
+        observer(this);
+        return this.subscribe(observer);
+    }
+    get type() { return this.#type; }
+    get initValue() { return this.#initValue; }
+    setInitValue(value) {
+        assert(this.graph.constructingBox(), "Cannot change initial value at runtime");
+        this.setValue(this.#initValue = value);
+    }
+    getValue() { return this.#value; }
+    setValue(value) {
+        const oldValue = this.#value;
+        const newValue = this.clamp(value);
+        if (this.equals(newValue)) {
+            return;
+        }
+        this.#value = value;
+        this.graph.onPrimitiveValueUpdate(this, oldValue, newValue);
+    }
+    writeValue(output, value) { this.serialization().encode(output, value); }
+    readValue(input) { return this.serialization().decode(input); }
+    reset() { this.setValue(this.#initValue); }
+}
+export class BooleanField extends PrimitiveField {
+    static create(construct, value = false) {
+        return new BooleanField(construct, value);
+    }
+    constructor(construct, value) { super(construct, PrimitiveType.Boolean, value); }
+    toggle() { this.setValue(!this.getValue()); }
+    serialization() { return ValueSerialization[PrimitiveType.Boolean]; }
+    equals(value) { return this.getValue() === value; }
+    clamp(value) { return value; }
+    read(input) { this.setValue(input.readBoolean()); }
+    write(output) { output.writeBoolean(this.getValue()); }
+}
+export class Float32Field extends PrimitiveField {
+    static create(construct, value = 0.0) {
+        return new Float32Field(construct, value);
+    }
+    constructor(construct, value) { super(construct, PrimitiveType.Float32, value); }
+    serialization() { return ValueSerialization[PrimitiveType.Float32]; }
+    equals(value) { return this.getValue() === value; }
+    clamp(value) { return Float.toFloat32(value); }
+    read(input) { this.setValue(input.readFloat()); }
+    write(output) { output.writeFloat(this.getValue()); }
+}
+export class Int32Field extends PrimitiveField {
+    static create(construct, value = 0) {
+        return new Int32Field(construct, value);
+    }
+    constructor(construct, value) { super(construct, PrimitiveType.Int32, value); }
+    serialization() { return ValueSerialization[PrimitiveType.Int32]; }
+    equals(value) { return this.getValue() === value; }
+    clamp(value) { return Integer.toInt(value); }
+    read(input) { this.setValue(input.readInt()); }
+    write(output) { output.writeInt(this.getValue()); }
+}
+export class StringField extends PrimitiveField {
+    static create(construct, value = "") {
+        return new StringField(construct, value);
+    }
+    constructor(construct, value) { super(construct, PrimitiveType.String, value); }
+    serialization() { return ValueSerialization[PrimitiveType.String]; }
+    equals(value) { return this.getValue() === value; }
+    clamp(value) { return value; }
+    read(input) { this.setValue(input.readString()); }
+    write(output) { output.writeString(this.getValue()); }
+}
+export class ByteArrayField extends PrimitiveField {
+    static create(construct, value = this.#empty) {
+        return new ByteArrayField(construct, value);
+    }
+    static #empty = Object.freeze(new Int8Array(0));
+    constructor(construct, value) { super(construct, PrimitiveType.Bytes, value); }
+    serialization() { return ValueSerialization[PrimitiveType.Bytes]; }
+    equals(value) {
+        return this.getValue().length === value.length && this.getValue().every((x, index) => value[index] === x);
+    }
+    clamp(value) { return value; }
+    read(input) {
+        const bytes = new Int8Array(input.readInt());
+        input.readBytes(bytes);
+        this.setValue(bytes);
+    }
+    write(output) {
+        const bytes = this.getValue();
+        output.writeInt(bytes.length);
+        output.writeBytes(bytes);
+    }
+}

package/dist/serializer.d.ts

@@ -0,0 +1,7 @@
+import { Fields } from "./field";
+import { DataInput, DataOutput } from "@opendaw/lib-std";
+export declare namespace Serializer {
+    const writeFields: <FIELDS extends Fields>(output: DataOutput, fields: FIELDS) => void;
+    const readFields: <FIELDS extends Fields>(input: DataInput, fields: FIELDS) => void;
+}
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAC,MAAM,SAAS,CAAA;AACxC,OAAO,EAA0C,SAAS,EAAE,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAE/F,yBAAiB,UAAU,CAAC;IAEjB,MAAM,WAAW,GAAI,MAAM,SAAS,MAAM,EAAE,QAAQ,UAAU,EAAE,QAAQ,MAAM,SAYpF,CAAA;IAEM,MAAM,UAAU,GAAI,MAAM,SAAS,MAAM,EAAE,OAAO,SAAS,EAAE,QAAQ,MAAM,SAUjF,CAAA;CACJ"}

package/dist/serializer.js

@@ -0,0 +1,29 @@
+import { assert, ByteArrayInput, ByteArrayOutput } from "@opendaw/lib-std";
+export var Serializer;
+(function (Serializer) {
+    const MAGIC_HEADER = 0x464c4453;
+    Serializer.writeFields = (output, fields) => {
+        const entries = Object.entries(fields);
+        output.writeInt(MAGIC_HEADER);
+        output.writeShort(entries.length);
+        entries.forEach(([key, field]) => {
+            const bytes = ByteArrayOutput.create();
+            field.write(bytes);
+            const buffer = new Int8Array(bytes.toArrayBuffer());
+            output.writeShort(Number(key));
+            output.writeInt(buffer.length);
+            output.writeBytes(buffer);
+        });
+    };
+    Serializer.readFields = (input, fields) => {
+        assert(input.readInt() === MAGIC_HEADER, "Serializer header is corrupt");
+        const numFields = input.readShort();
+        for (let fieldIndex = 0; fieldIndex < numFields; fieldIndex++) {
+            const key = input.readShort();
+            const byteLength = input.readInt();
+            const bytes = new Int8Array(byteLength);
+            input.readBytes(bytes);
+            fields[key]?.read(new ByteArrayInput(bytes.buffer));
+        }
+    };
+})(Serializer || (Serializer = {}));

package/dist/sync-source.d.ts

@@ -0,0 +1,11 @@
+import { Terminable } from "@opendaw/lib-std";
+import { Messenger } from "@opendaw/lib-runtime";
+import { BoxGraph } from "./graph";
+export declare class SyncSource<M> implements Terminable {
+    #private;
+    static readonly DEBUG_CHECKSUM = false;
+    constructor(graph: BoxGraph<M>, messenger: Messenger, initialize?: boolean);
+    checksum(value: Int8Array): Promise<void>;
+    terminate(): void;
+}
+//# sourceMappingURL=sync-source.d.ts.map

package/dist/sync-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-source.d.ts","sourceRoot":"","sources":["../src/sync-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,UAAU,EAAa,MAAM,kBAAkB,CAAA;AACjF,OAAO,EAAe,SAAS,EAAC,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAA;AAIhC,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,UAAU;;IAC5C,MAAM,CAAC,QAAQ,CAAC,cAAc,SAAQ;gBAK1B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,OAAO;IAkE1E,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,SAAS;CACZ"}

package/dist/sync-source.js

@@ -0,0 +1,72 @@
+import { Arrays, EmptyExec, panic, Terminator } from "@opendaw/lib-std";
+import { Communicator } from "@opendaw/lib-runtime";
+export class SyncSource {
+    static DEBUG_CHECKSUM = false;
+    #terminator;
+    #caller;
+    constructor(graph, messenger, initialize) {
+        this.#terminator = new Terminator();
+        this.#caller = Communicator.sender(messenger, ({ dispatchAndForget, dispatchAndReturn }) => new class {
+            sendUpdates(updates) {
+                dispatchAndForget(this.sendUpdates, updates);
+            }
+            checksum(value) {
+                return dispatchAndReturn(this.checksum, value);
+            }
+        });
+        if (initialize === true) {
+            const boxes = graph.boxes();
+            if (boxes.length > 0) {
+                this.#caller.sendUpdates(boxes.map(box => ({ type: "new", name: box.name, uuid: box.address.uuid, buffer: box.toArrayBuffer() })));
+            }
+        }
+        const updates = [];
+        this.#terminator.own(graph.subscribeTransaction({
+            onBeginTransaction: EmptyExec,
+            onEndTransaction: () => {
+                this.#caller.sendUpdates(updates);
+                if (SyncSource.DEBUG_CHECKSUM) {
+                    this.#caller.checksum(graph.checksum()).then(EmptyExec, (reason) => panic(reason));
+                }
+                Arrays.clear(updates);
+            }
+        }));
+        this.#terminator.own(graph.subscribeToAllUpdatesImmediate({
+            onUpdate: (update) => {
+                if (update.type === "new") {
+                    updates.push({
+                        type: "new",
+                        name: update.name,
+                        uuid: update.uuid,
+                        buffer: update.settings
+                    });
+                }
+                else if (update.type === "primitive") {
+                    updates.push({
+                        type: "update-primitive",
+                        address: update.address.decompose(),
+                        value: update.newValue
+                    });
+                }
+                else if (update.type === "pointer") {
+                    updates.push({
+                        type: "update-pointer",
+                        address: update.address.decompose(),
+                        target: update.newValue.unwrapOrNull()?.decompose()
+                    });
+                }
+                else if (update.type === "delete") {
+                    updates.push({
+                        type: "delete",
+                        uuid: update.uuid
+                    });
+                }
+                else {
+                    return panic(`Unknown ${update}`);
+                }
+            }
+        }));
+    }
+    checksum(value) { return this.#caller.checksum(value); }
+    terminate() { this.#terminator.terminate(); }
+}

package/dist/sync-target.d.ts

@@ -0,0 +1,5 @@
+import { Terminable } from "@opendaw/lib-std";
+import { Messenger } from "@opendaw/lib-runtime";
+import { BoxGraph } from "./graph";
+export declare const createSyncTarget: <M>(graph: BoxGraph<M>, messenger: Messenger) => Terminable;
+//# sourceMappingURL=sync-target.d.ts.map

package/dist/sync-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-target.d.ts","sourceRoot":"","sources":["../src/sync-target.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,UAAU,EAAO,MAAM,kBAAkB,CAAA;AAC5F,OAAO,EAAe,SAAS,EAAC,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAA;AAMhC,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,SAAS,KAAG,UAiC9E,CAAA"}

package/dist/sync-target.js

@@ -0,0 +1,40 @@
+import { Arrays, ByteArrayInput, isDefined, Option, UUID } from "@opendaw/lib-std";
+import { Communicator } from "@opendaw/lib-runtime";
+import { Address } from "./address";
+export const createSyncTarget = (graph, messenger) => {
+    return Communicator.executor(messenger, new class {
+        sendUpdates(updates) {
+            graph.beginTransaction();
+            updates.forEach(update => {
+                const type = update.type;
+                if (type === "new") {
+                    graph.createBox(update.name, update.uuid, box => box.read(new ByteArrayInput(update.buffer)));
+                }
+                else if (type === "update-primitive") {
+                    graph.findVertex(Address.reconstruct(update.address))
+                        .unwrap(() => `Could not find primitive field ${update.address}`)
+                        .setValue(update.value);
+                }
+                else if (type === "update-pointer") {
+                    graph.findVertex(Address.reconstruct(update.address))
+                        .unwrap(() => `Could not find pointer field ${update.address}`)
+                        .targetAddress = isDefined(update.target)
+                        ? Option.wrap(Address.reconstruct(update.target))
+                        : Option.None;
+                }
+                else if (update.type === "delete") {
+                    graph.unstageBox(graph.findBox(update.uuid).unwrap(() => `Could not find box ${UUID.toString(update.uuid)}`));
+                }
+            });
+            graph.endTransaction();
+        }
+        checksum(value) {
+            if (Arrays.equals(graph.checksum(), value)) {
+                return Promise.resolve();
+            }
+            else {
+                return Promise.reject("Checksum mismatch");
+            }
+        }
+    });
+};

package/dist/sync.d.ts

@@ -0,0 +1,24 @@
+import { Nullish, UUID } from "@opendaw/lib-std";
+import { AddressLayout } from "./address";
+export type UpdateTask<M> = {
+    type: "new";
+    name: keyof M;
+    uuid: UUID.Format;
+    buffer: ArrayBufferLike;
+} | {
+    type: "update-primitive";
+    address: AddressLayout;
+    value: unknown;
+} | {
+    type: "update-pointer";
+    address: AddressLayout;
+    target: Nullish<AddressLayout>;
+} | {
+    type: "delete";
+    uuid: UUID.Format;
+};
+export interface Synchronization<M> {
+    sendUpdates(updates: ReadonlyArray<UpdateTask<M>>): void;
+    checksum(value: Int8Array): Promise<void>;
+}
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAC,aAAa,EAAC,MAAM,WAAW,CAAA;AAEvC,MAAM,MAAM,UAAU,CAAC,CAAC,IAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAA;CAAE,CAAA;AAE3C,MAAM,WAAW,eAAe,CAAC,CAAC;IAC9B,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5C"}

package/dist/sync.js

@@ -0,0 +1 @@
+export {};

package/dist/updates.d.ts

@@ -0,0 +1,70 @@
+import { PrimitiveField, PrimitiveValues, ValueSerialization } from "./primitive";
+import { Address } from "./address";
+import { PointerField } from "./pointer";
+import { DataInput, DataOutput, Option, UUID } from "@opendaw/lib-std";
+import { BoxGraph } from "./graph";
+export type Update = NewUpdate | PrimitiveUpdate | PointerUpdate | DeleteUpdate;
+export declare namespace Updates {
+    const decode: (input: DataInput) => ReadonlyArray<Update>;
+}
+interface Modification {
+    forward(graph: BoxGraph): void;
+    inverse(graph: BoxGraph): void;
+    write(output: DataOutput): void;
+}
+export declare class NewUpdate implements Modification {
+    #private;
+    readonly type = "new";
+    constructor(uuid: UUID.Format, name: string, settings: ArrayBufferLike);
+    get uuid(): UUID.Format;
+    get name(): string;
+    get settings(): ArrayBufferLike;
+    forward(graph: BoxGraph): void;
+    inverse(graph: BoxGraph): void;
+    write(output: DataOutput): void;
+    toString(): string;
+    toDebugString(_graph: BoxGraph): string;
+}
+export type FieldUpdate = PrimitiveUpdate | PointerUpdate;
+export declare class PrimitiveUpdate<V extends PrimitiveValues = PrimitiveValues> implements Modification {
+    #private;
+    readonly type = "primitive";
+    constructor(address: Address, serialization: ValueSerialization<V>, oldValue: V, newValue: V);
+    get address(): Address;
+    get oldValue(): V;
+    get newValue(): V;
+    matches(field: PrimitiveField): boolean;
+    inverse(graph: BoxGraph): void;
+    forward(graph: BoxGraph): void;
+    field(graph: BoxGraph): PrimitiveField<V>;
+    write(output: DataOutput): void;
+    toString(): string;
+}
+export declare class PointerUpdate implements Modification {
+    #private;
+    readonly type = "pointer";
+    constructor(address: Address, oldValue: Option<Address>, newValue: Option<Address>);
+    get address(): Address;
+    get oldValue(): Option<Address>;
+    get newValue(): Option<Address>;
+    matches(field: PointerField): boolean;
+    inverse(graph: BoxGraph): void;
+    forward(graph: BoxGraph): void;
+    field(graph: BoxGraph): PointerField;
+    write(output: DataOutput): void;
+    toString(): string;
+}
+export declare class DeleteUpdate implements Modification {
+    #private;
+    readonly type = "delete";
+    constructor(uuid: UUID.Format, name: string, settings: ArrayBufferLike);
+    get uuid(): UUID.Format;
+    get name(): string;
+    get settings(): ArrayBufferLike;
+    forward(graph: BoxGraph): void;
+    inverse(graph: BoxGraph): void;
+    write(output: DataOutput): void;
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=updates.d.ts.map

package/dist/updates.d.ts.map

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