@fluidframework/tree 2.0.0-rc.2.0.2 → 2.0.0-rc.3.0.0

package/lib/feature-libraries/optional-field/optionalFieldCodecV1.js

@@ -0,0 +1,154 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { assert } from "@fluidframework/core-utils/internal";
+import { makeChangeAtomIdCodec } from "../changeAtomIdCodec.js";
+import { EncodedNodeChangeset } from "../modular-schema/index.js";
+import { EncodedOptionalChangeset, EncodedRegisterId } from "./optionalFieldChangeFormatV1.js";
+function makeRegisterIdCodec(revisionTagCodec) {
+    const changeAtomIdCodec = makeChangeAtomIdCodec(revisionTagCodec);
+    return {
+        encode: (registerId, context) => {
+            if (registerId === "self") {
+                return null;
+            }
+            return changeAtomIdCodec.encode(registerId, context);
+        },
+        decode: (registerId, context) => {
+            if (registerId === null) {
+                return "self";
+            }
+            return changeAtomIdCodec.decode(registerId, context);
+        },
+        encodedSchema: EncodedRegisterId,
+    };
+}
+export function makeOptionalFieldCodec(revisionTagCodec) {
+    const registerIdCodec = makeRegisterIdCodec(revisionTagCodec);
+    return {
+        encode: (change, context) => {
+            const encoded = {};
+            encoded.m = [];
+            if (change.valueReplace !== undefined) {
+                if (change.valueReplace.src !== undefined) {
+                    encoded.m.push([
+                        registerIdCodec.encode(change.valueReplace.src, context.baseContext),
+                        registerIdCodec.encode("self", context.baseContext),
+                        true,
+                    ]);
+                }
+                // When the source of the replace is "self", the destination is a reserved ID that will only be used if
+                // the tree in the field is concurrently replaced.
+                if (change.valueReplace.isEmpty || change.valueReplace.src === "self") {
+                    encoded.d = registerIdCodec.encode(change.valueReplace.dst, context.baseContext);
+                }
+                else {
+                    encoded.m.push([
+                        registerIdCodec.encode("self", context.baseContext),
+                        registerIdCodec.encode(change.valueReplace.dst, context.baseContext),
+                        false,
+                    ]);
+                }
+            }
+            for (const [src, dst] of change.moves) {
+                encoded.m.push([
+                    registerIdCodec.encode(src, context.baseContext),
+                    registerIdCodec.encode(dst, context.baseContext),
+                    true,
+                ]);
+            }
+            if (encoded.m.length === 0) {
+                delete encoded.m;
+            }
+            if (change.childChanges.length > 0) {
+                encoded.c = [];
+                for (const [id, childChange] of change.childChanges) {
+                    encoded.c.push([
+                        registerIdCodec.encode(id, context.baseContext),
+                        context.encodeNode(childChange),
+                    ]);
+                }
+            }
+            return encoded;
+        },
+        decode: (encoded, context) => {
+            // The register that the node in the optional field is moved to upon detach
+            let detached;
+            // The register that the node is moved from to upon attaching that node in the optional field
+            let attached;
+            const moves = [];
+            if (encoded.m !== undefined) {
+                for (const [encodedSrc, encodedDst] of encoded.m) {
+                    const src = registerIdCodec.decode(encodedSrc, context.baseContext);
+                    const dst = registerIdCodec.decode(encodedDst, context.baseContext);
+                    if (src === "self" || dst === "self") {
+                        if (src === "self") {
+                            assert(detached === undefined, 0x8d0 /* Multiple detached nodes */);
+                            detached = dst;
+                        }
+                        if (dst === "self") {
+                            assert(attached === undefined, 0x8d1 /* Multiple attached nodes */);
+                            attached = src;
+                        }
+                    }
+                    else {
+                        moves.push([src, dst]);
+                    }
+                }
+            }
+            const decoded = {
+                moves,
+                childChanges: encoded.c?.map(([id, encodedChange]) => [
+                    registerIdCodec.decode(id, context.baseContext),
+                    context.decodeNode(encodedChange),
+                ]) ?? [],
+            };
+            if (detached !== undefined && attached !== undefined) {
+                if (detached === "self" || attached === "self") {
+                    assert(encoded.d !== undefined, 0x8d2 /* Invalid change: pin must have a reserved detach ID */);
+                    const reserved = registerIdCodec.decode(encoded.d, context.baseContext);
+                    assert(reserved !== "self", 0x8d3 /* Invalid reserved detach ID */);
+                    decoded.valueReplace = { isEmpty: false, dst: reserved, src: "self" };
+                }
+                else {
+                    assert(encoded.d === undefined, 0x8d4 /* Invalid change: unexpected reserved detach ID on a change that detaches a node from the field */);
+                    decoded.valueReplace = {
+                        isEmpty: false,
+                        dst: detached,
+                        src: attached,
+                    };
+                }
+            }
+            else if (attached !== undefined) {
+                assert(encoded.d !== undefined, 0x8d5 /* Invalid change: attach must have a reserved detach ID */);
+                const reserved = registerIdCodec.decode(encoded.d, context.baseContext);
+                assert(reserved !== "self", 0x8d6 /* Invalid reserved detach ID */);
+                decoded.valueReplace = {
+                    isEmpty: true,
+                    dst: reserved,
+                    src: attached,
+                };
+            }
+            else if (detached !== undefined) {
+                assert(encoded.d === undefined, 0x8d7 /* Invalid change: unexpected reserved detach ID on a change that detaches a node from the field */);
+                assert(detached !== "self", 0x8d8 /* Invalid detach ID */);
+                decoded.valueReplace = {
+                    isEmpty: false,
+                    dst: detached,
+                };
+            }
+            else if (encoded.d !== undefined) {
+                const detachId = registerIdCodec.decode(encoded.d, context.baseContext);
+                assert(detachId !== "self", 0x8d9 /* Invalid detach ID */);
+                decoded.valueReplace = {
+                    isEmpty: true,
+                    dst: detachId,
+                };
+            }
+            return decoded;
+        },
+        encodedSchema: EncodedOptionalChangeset(EncodedNodeChangeset),
+    };
+}
+//# sourceMappingURL=optionalFieldCodecV1.js.map

package/lib/feature-libraries/optional-field/optionalFieldCodecV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionalFieldCodecV1.js","sourceRoot":"","sources":["../../../src/feature-libraries/optional-field/optionalFieldCodecV1.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { assert } from \"@fluidframework/core-utils/internal\";\nimport { TAnySchema } from \"@sinclair/typebox\";\n\nimport { IJsonCodec } from \"../../codec/index.js\";\nimport { ChangeEncodingContext, EncodedRevisionTag, RevisionTag } from \"../../core/index.js\";\nimport { Mutable } from \"../../util/index.js\";\nimport { makeChangeAtomIdCodec } from \"../changeAtomIdCodec.js\";\nimport { EncodedNodeChangeset, type FieldChangeEncodingContext } from \"../modular-schema/index.js\";\n\nimport { EncodedOptionalChangeset, EncodedRegisterId } from \"./optionalFieldChangeFormatV1.js\";\nimport type { Move, OptionalChangeset, RegisterId } from \"./optionalFieldChangeTypes.js\";\n\nfunction makeRegisterIdCodec(\n\trevisionTagCodec: IJsonCodec<\n\t\tRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tChangeEncodingContext\n\t>,\n): IJsonCodec<RegisterId, EncodedRegisterId, EncodedRegisterId, ChangeEncodingContext> {\n\tconst changeAtomIdCodec = makeChangeAtomIdCodec(revisionTagCodec);\n\treturn {\n\t\tencode: (registerId: RegisterId, context: ChangeEncodingContext) => {\n\t\t\tif (registerId === \"self\") {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\treturn changeAtomIdCodec.encode(registerId, context);\n\t\t},\n\t\tdecode: (registerId: EncodedRegisterId, context: ChangeEncodingContext) => {\n\t\t\tif (registerId === null) {\n\t\t\t\treturn \"self\";\n\t\t\t}\n\t\t\treturn changeAtomIdCodec.decode(registerId, context);\n\t\t},\n\t\tencodedSchema: EncodedRegisterId,\n\t};\n}\n\nexport function makeOptionalFieldCodec(\n\trevisionTagCodec: IJsonCodec<\n\t\tRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tChangeEncodingContext\n\t>,\n): IJsonCodec<\n\tOptionalChangeset,\n\tEncodedOptionalChangeset<TAnySchema>,\n\tEncodedOptionalChangeset<TAnySchema>,\n\tFieldChangeEncodingContext\n> {\n\tconst registerIdCodec = makeRegisterIdCodec(revisionTagCodec);\n\n\treturn {\n\t\tencode: (change: OptionalChangeset, context: FieldChangeEncodingContext) => {\n\t\t\tconst encoded: EncodedOptionalChangeset<TAnySchema> = {};\n\t\t\tencoded.m = [];\n\n\t\t\tif (change.valueReplace !== undefined) {\n\t\t\t\tif (change.valueReplace.src !== undefined) {\n\t\t\t\t\tencoded.m.push([\n\t\t\t\t\t\tregisterIdCodec.encode(change.valueReplace.src, context.baseContext),\n\t\t\t\t\t\tregisterIdCodec.encode(\"self\", context.baseContext),\n\t\t\t\t\t\ttrue,\n\t\t\t\t\t]);\n\t\t\t\t}\n\n\t\t\t\t// When the source of the replace is \"self\", the destination is a reserved ID that will only be used if\n\t\t\t\t// the tree in the field is concurrently replaced.\n\t\t\t\tif (change.valueReplace.isEmpty || change.valueReplace.src === \"self\") {\n\t\t\t\t\tencoded.d = registerIdCodec.encode(\n\t\t\t\t\t\tchange.valueReplace.dst,\n\t\t\t\t\t\tcontext.baseContext,\n\t\t\t\t\t);\n\t\t\t\t} else {\n\t\t\t\t\tencoded.m.push([\n\t\t\t\t\t\tregisterIdCodec.encode(\"self\", context.baseContext),\n\t\t\t\t\t\tregisterIdCodec.encode(change.valueReplace.dst, context.baseContext),\n\t\t\t\t\t\tfalse,\n\t\t\t\t\t]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tfor (const [src, dst] of change.moves) {\n\t\t\t\tencoded.m.push([\n\t\t\t\t\tregisterIdCodec.encode(src, context.baseContext),\n\t\t\t\t\tregisterIdCodec.encode(dst, context.baseContext),\n\t\t\t\t\ttrue,\n\t\t\t\t]);\n\t\t\t}\n\n\t\t\tif (encoded.m.length === 0) {\n\t\t\t\tdelete encoded.m;\n\t\t\t}\n\n\t\t\tif (change.childChanges.length > 0) {\n\t\t\t\tencoded.c = [];\n\t\t\t\tfor (const [id, childChange] of change.childChanges) {\n\t\t\t\t\tencoded.c.push([\n\t\t\t\t\t\tregisterIdCodec.encode(id, context.baseContext),\n\t\t\t\t\t\tcontext.encodeNode(childChange),\n\t\t\t\t\t]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn encoded;\n\t\t},\n\n\t\tdecode: (\n\t\t\tencoded: EncodedOptionalChangeset<TAnySchema>,\n\t\t\tcontext: FieldChangeEncodingContext,\n\t\t) => {\n\t\t\t// The register that the node in the optional field is moved to upon detach\n\t\t\tlet detached: RegisterId | undefined;\n\t\t\t// The register that the node is moved from to upon attaching that node in the optional field\n\t\t\tlet attached: RegisterId | undefined;\n\t\t\tconst moves: Move[] = [];\n\t\t\tif (encoded.m !== undefined) {\n\t\t\t\tfor (const [encodedSrc, encodedDst] of encoded.m) {\n\t\t\t\t\tconst src = registerIdCodec.decode(encodedSrc, context.baseContext);\n\t\t\t\t\tconst dst = registerIdCodec.decode(encodedDst, context.baseContext);\n\t\t\t\t\tif (src === \"self\" || dst === \"self\") {\n\t\t\t\t\t\tif (src === \"self\") {\n\t\t\t\t\t\t\tassert(detached === undefined, 0x8d0 /* Multiple detached nodes */);\n\t\t\t\t\t\t\tdetached = dst;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (dst === \"self\") {\n\t\t\t\t\t\t\tassert(attached === undefined, 0x8d1 /* Multiple attached nodes */);\n\t\t\t\t\t\t\tattached = src;\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tmoves.push([src, dst]);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst decoded: Mutable<OptionalChangeset> = {\n\t\t\t\tmoves,\n\t\t\t\tchildChanges:\n\t\t\t\t\tencoded.c?.map(([id, encodedChange]) => [\n\t\t\t\t\t\tregisterIdCodec.decode(id, context.baseContext),\n\t\t\t\t\t\tcontext.decodeNode(encodedChange),\n\t\t\t\t\t]) ?? [],\n\t\t\t};\n\n\t\t\tif (detached !== undefined && attached !== undefined) {\n\t\t\t\tif (detached === \"self\" || attached === \"self\") {\n\t\t\t\t\tassert(\n\t\t\t\t\t\tencoded.d !== undefined,\n\t\t\t\t\t\t0x8d2 /* Invalid change: pin must have a reserved detach ID */,\n\t\t\t\t\t);\n\t\t\t\t\tconst reserved = registerIdCodec.decode(encoded.d, context.baseContext);\n\t\t\t\t\tassert(reserved !== \"self\", 0x8d3 /* Invalid reserved detach ID */);\n\t\t\t\t\tdecoded.valueReplace = { isEmpty: false, dst: reserved, src: \"self\" };\n\t\t\t\t} else {\n\t\t\t\t\tassert(\n\t\t\t\t\t\tencoded.d === undefined,\n\t\t\t\t\t\t0x8d4 /* Invalid change: unexpected reserved detach ID on a change that detaches a node from the field */,\n\t\t\t\t\t);\n\t\t\t\t\tdecoded.valueReplace = {\n\t\t\t\t\t\tisEmpty: false,\n\t\t\t\t\t\tdst: detached,\n\t\t\t\t\t\tsrc: attached,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t} else if (attached !== undefined) {\n\t\t\t\tassert(\n\t\t\t\t\tencoded.d !== undefined,\n\t\t\t\t\t0x8d5 /* Invalid change: attach must have a reserved detach ID */,\n\t\t\t\t);\n\t\t\t\tconst reserved = registerIdCodec.decode(encoded.d, context.baseContext);\n\t\t\t\tassert(reserved !== \"self\", 0x8d6 /* Invalid reserved detach ID */);\n\t\t\t\tdecoded.valueReplace = {\n\t\t\t\t\tisEmpty: true,\n\t\t\t\t\tdst: reserved,\n\t\t\t\t\tsrc: attached,\n\t\t\t\t};\n\t\t\t} else if (detached !== undefined) {\n\t\t\t\tassert(\n\t\t\t\t\tencoded.d === undefined,\n\t\t\t\t\t0x8d7 /* Invalid change: unexpected reserved detach ID on a change that detaches a node from the field */,\n\t\t\t\t);\n\t\t\t\tassert(detached !== \"self\", 0x8d8 /* Invalid detach ID */);\n\t\t\t\tdecoded.valueReplace = {\n\t\t\t\t\tisEmpty: false,\n\t\t\t\t\tdst: detached,\n\t\t\t\t};\n\t\t\t} else if (encoded.d !== undefined) {\n\t\t\t\tconst detachId = registerIdCodec.decode(encoded.d, context.baseContext);\n\t\t\t\tassert(detachId !== \"self\", 0x8d9 /* Invalid detach ID */);\n\t\t\t\tdecoded.valueReplace = {\n\t\t\t\t\tisEmpty: true,\n\t\t\t\t\tdst: detachId,\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn decoded;\n\t\t},\n\t\tencodedSchema: EncodedOptionalChangeset(EncodedNodeChangeset),\n\t};\n}\n"]}

package/lib/feature-libraries/optional-field/optionalFieldCodecV2.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { TAnySchema } from "@sinclair/typebox";
+import { IJsonCodec } from "../../codec/index.js";
+import { ChangeEncodingContext, EncodedRevisionTag, RevisionTag } from "../../core/index.js";
+import { type FieldChangeEncodingContext } from "../modular-schema/index.js";
+import { EncodedOptionalChangeset } from "./optionalFieldChangeFormatV2.js";
+import type { OptionalChangeset } from "./optionalFieldChangeTypes.js";
+export declare function makeOptionalFieldCodec(revisionTagCodec: IJsonCodec<RevisionTag, EncodedRevisionTag, EncodedRevisionTag, ChangeEncodingContext>): IJsonCodec<OptionalChangeset, EncodedOptionalChangeset<TAnySchema>, EncodedOptionalChangeset<TAnySchema>, FieldChangeEncodingContext>;
+//# sourceMappingURL=optionalFieldCodecV2.d.ts.map

package/lib/feature-libraries/optional-field/optionalFieldCodecV2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionalFieldCodecV2.d.ts","sourceRoot":"","sources":["../../../src/feature-libraries/optional-field/optionalFieldCodecV2.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAEN,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAGN,KAAK,0BAA0B,EAC/B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,wBAAwB,EAAqB,MAAM,kCAAkC,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,+BAA+B,CAAC;AA2B5F,wBAAgB,sBAAsB,CACrC,gBAAgB,EAAE,UAAU,CAC3B,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,CACrB,GACC,UAAU,CACZ,iBAAiB,EACjB,wBAAwB,CAAC,UAAU,CAAC,EACpC,wBAAwB,CAAC,UAAU,CAAC,EACpC,0BAA0B,CAC1B,CAwEA"}

package/lib/feature-libraries/optional-field/optionalFieldCodecV2.js

@@ -0,0 +1,83 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { makeChangeAtomIdCodec } from "../changeAtomIdCodec.js";
+import { EncodedNodeChangeset, } from "../modular-schema/index.js";
+import { EncodedOptionalChangeset, EncodedRegisterId } from "./optionalFieldChangeFormatV2.js";
+function makeRegisterIdCodec(changeAtomIdCodec) {
+    return {
+        encode: (registerId, context) => {
+            if (registerId === "self") {
+                return null;
+            }
+            return changeAtomIdCodec.encode(registerId, context);
+        },
+        decode: (registerId, context) => {
+            if (registerId === null) {
+                return "self";
+            }
+            return changeAtomIdCodec.decode(registerId, context);
+        },
+        encodedSchema: EncodedRegisterId,
+    };
+}
+export function makeOptionalFieldCodec(revisionTagCodec) {
+    const changeAtomIdCodec = makeChangeAtomIdCodec(revisionTagCodec);
+    const registerIdCodec = makeRegisterIdCodec(changeAtomIdCodec);
+    return {
+        encode: (change, context) => {
+            const encoded = {};
+            if (change.moves.length > 0) {
+                encoded.m = change.moves.map(([src, dst]) => [
+                    changeAtomIdCodec.encode(src, context.baseContext),
+                    changeAtomIdCodec.encode(dst, context.baseContext),
+                ]);
+            }
+            if (change.valueReplace !== undefined) {
+                encoded.r = {
+                    e: change.valueReplace.isEmpty,
+                    d: changeAtomIdCodec.encode(change.valueReplace.dst, context.baseContext),
+                };
+                if (change.valueReplace.src !== undefined) {
+                    encoded.r.s = registerIdCodec.encode(change.valueReplace.src, context.baseContext);
+                }
+            }
+            if (change.childChanges.length > 0) {
+                encoded.c = [];
+                for (const [id, childChange] of change.childChanges) {
+                    encoded.c.push([
+                        registerIdCodec.encode(id, context.baseContext),
+                        context.encodeNode(childChange),
+                    ]);
+                }
+            }
+            return encoded;
+        },
+        decode: (encoded, context) => {
+            const decoded = {
+                moves: encoded.m?.map(([encodedSrc, encodedDst]) => [
+                    changeAtomIdCodec.decode(encodedSrc, context.baseContext),
+                    changeAtomIdCodec.decode(encodedDst, context.baseContext),
+                ]) ?? [],
+                childChanges: encoded.c?.map(([id, encodedChange]) => [
+                    registerIdCodec.decode(id, context.baseContext),
+                    context.decodeNode(encodedChange),
+                ]) ?? [],
+            };
+            if (encoded.r !== undefined) {
+                const replace = {
+                    isEmpty: encoded.r.e,
+                    dst: changeAtomIdCodec.decode(encoded.r.d, context.baseContext),
+                };
+                if (encoded.r.s !== undefined) {
+                    replace.src = registerIdCodec.decode(encoded.r.s, context.baseContext);
+                }
+                decoded.valueReplace = replace;
+            }
+            return decoded;
+        },
+        encodedSchema: EncodedOptionalChangeset(EncodedNodeChangeset),
+    };
+}
+//# sourceMappingURL=optionalFieldCodecV2.js.map

package/lib/feature-libraries/optional-field/optionalFieldCodecV2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionalFieldCodecV2.js","sourceRoot":"","sources":["../../../src/feature-libraries/optional-field/optionalFieldCodecV2.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { TAnySchema } from \"@sinclair/typebox\";\n\nimport { IJsonCodec } from \"../../codec/index.js\";\nimport {\n\tChangeAtomId,\n\tChangeEncodingContext,\n\tEncodedRevisionTag,\n\tRevisionTag,\n} from \"../../core/index.js\";\nimport { Mutable } from \"../../util/index.js\";\nimport { makeChangeAtomIdCodec } from \"../changeAtomIdCodec.js\";\nimport {\n\tEncodedNodeChangeset,\n\ttype EncodedChangeAtomId,\n\ttype FieldChangeEncodingContext,\n} from \"../modular-schema/index.js\";\n\nimport { EncodedOptionalChangeset, EncodedRegisterId } from \"./optionalFieldChangeFormatV2.js\";\nimport type { OptionalChangeset, RegisterId, Replace } from \"./optionalFieldChangeTypes.js\";\n\nfunction makeRegisterIdCodec(\n\tchangeAtomIdCodec: IJsonCodec<\n\t\tChangeAtomId,\n\t\tEncodedChangeAtomId,\n\t\tEncodedChangeAtomId,\n\t\tChangeEncodingContext\n\t>,\n): IJsonCodec<RegisterId, EncodedRegisterId, EncodedRegisterId, ChangeEncodingContext> {\n\treturn {\n\t\tencode: (registerId: RegisterId, context: ChangeEncodingContext) => {\n\t\t\tif (registerId === \"self\") {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\treturn changeAtomIdCodec.encode(registerId, context);\n\t\t},\n\t\tdecode: (registerId: EncodedRegisterId, context: ChangeEncodingContext) => {\n\t\t\tif (registerId === null) {\n\t\t\t\treturn \"self\";\n\t\t\t}\n\t\t\treturn changeAtomIdCodec.decode(registerId, context);\n\t\t},\n\t\tencodedSchema: EncodedRegisterId,\n\t};\n}\n\nexport function makeOptionalFieldCodec(\n\trevisionTagCodec: IJsonCodec<\n\t\tRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tChangeEncodingContext\n\t>,\n): IJsonCodec<\n\tOptionalChangeset,\n\tEncodedOptionalChangeset<TAnySchema>,\n\tEncodedOptionalChangeset<TAnySchema>,\n\tFieldChangeEncodingContext\n> {\n\tconst changeAtomIdCodec = makeChangeAtomIdCodec(revisionTagCodec);\n\tconst registerIdCodec = makeRegisterIdCodec(changeAtomIdCodec);\n\n\treturn {\n\t\tencode: (change: OptionalChangeset, context: FieldChangeEncodingContext) => {\n\t\t\tconst encoded: EncodedOptionalChangeset<TAnySchema> = {};\n\n\t\t\tif (change.moves.length > 0) {\n\t\t\t\tencoded.m = change.moves.map(([src, dst]) => [\n\t\t\t\t\tchangeAtomIdCodec.encode(src, context.baseContext),\n\t\t\t\t\tchangeAtomIdCodec.encode(dst, context.baseContext),\n\t\t\t\t]);\n\t\t\t}\n\n\t\t\tif (change.valueReplace !== undefined) {\n\t\t\t\tencoded.r = {\n\t\t\t\t\te: change.valueReplace.isEmpty,\n\t\t\t\t\td: changeAtomIdCodec.encode(change.valueReplace.dst, context.baseContext),\n\t\t\t\t};\n\t\t\t\tif (change.valueReplace.src !== undefined) {\n\t\t\t\t\tencoded.r.s = registerIdCodec.encode(\n\t\t\t\t\t\tchange.valueReplace.src,\n\t\t\t\t\t\tcontext.baseContext,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (change.childChanges.length > 0) {\n\t\t\t\tencoded.c = [];\n\t\t\t\tfor (const [id, childChange] of change.childChanges) {\n\t\t\t\t\tencoded.c.push([\n\t\t\t\t\t\tregisterIdCodec.encode(id, context.baseContext),\n\t\t\t\t\t\tcontext.encodeNode(childChange),\n\t\t\t\t\t]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn encoded;\n\t\t},\n\n\t\tdecode: (\n\t\t\tencoded: EncodedOptionalChangeset<TAnySchema>,\n\t\t\tcontext: FieldChangeEncodingContext,\n\t\t) => {\n\t\t\tconst decoded: Mutable<OptionalChangeset> = {\n\t\t\t\tmoves:\n\t\t\t\t\tencoded.m?.map(([encodedSrc, encodedDst]) => [\n\t\t\t\t\t\tchangeAtomIdCodec.decode(encodedSrc, context.baseContext),\n\t\t\t\t\t\tchangeAtomIdCodec.decode(encodedDst, context.baseContext),\n\t\t\t\t\t]) ?? [],\n\t\t\t\tchildChanges:\n\t\t\t\t\tencoded.c?.map(([id, encodedChange]) => [\n\t\t\t\t\t\tregisterIdCodec.decode(id, context.baseContext),\n\t\t\t\t\t\tcontext.decodeNode(encodedChange),\n\t\t\t\t\t]) ?? [],\n\t\t\t};\n\n\t\t\tif (encoded.r !== undefined) {\n\t\t\t\tconst replace: Mutable<Replace> = {\n\t\t\t\t\tisEmpty: encoded.r.e,\n\t\t\t\t\tdst: changeAtomIdCodec.decode(encoded.r.d, context.baseContext),\n\t\t\t\t};\n\t\t\t\tif (encoded.r.s !== undefined) {\n\t\t\t\t\treplace.src = registerIdCodec.decode(encoded.r.s, context.baseContext);\n\t\t\t\t}\n\t\t\t\tdecoded.valueReplace = replace;\n\t\t\t}\n\t\t\treturn decoded;\n\t\t},\n\t\tencodedSchema: EncodedOptionalChangeset(EncodedNodeChangeset),\n\t};\n}\n"]}

package/lib/feature-libraries/optional-field/optionalFieldCodecs.d.ts

@@ -4,9 +4,7 @@
  */
 import { ICodecFamily, IJsonCodec } from "../../codec/index.js";
 import { ChangeEncodingContext, EncodedRevisionTag, RevisionTag } from "../../core/index.js";
-import { JsonCompatibleReadOnly } from "../../util/index.js";
-import type { NodeChangeset } from "../modular-schema/index.js";
+import type { FieldChangeEncodingContext } from "../modular-schema/index.js";
 import type { OptionalChangeset } from "./optionalFieldChangeTypes.js";
-export declare const noChangeCodecFamily: ICodecFamily<0, ChangeEncodingContext>;
-export declare const makeOptionalFieldCodecFamily: <TChildChange = NodeChangeset>(childCodec: IJsonCodec<TChildChange, JsonCompatibleReadOnly, JsonCompatibleReadOnly, ChangeEncodingContext>, revisionTagCodec: IJsonCodec<RevisionTag, EncodedRevisionTag, EncodedRevisionTag, ChangeEncodingContext>) => ICodecFamily<OptionalChangeset<TChildChange>, ChangeEncodingContext>;
+export declare const makeOptionalFieldCodecFamily: (revisionTagCodec: IJsonCodec<RevisionTag, EncodedRevisionTag, EncodedRevisionTag, ChangeEncodingContext>) => ICodecFamily<OptionalChangeset, FieldChangeEncodingContext>;
 //# sourceMappingURL=optionalFieldCodecs.d.ts.map

package/lib/feature-libraries/optional-field/optionalFieldCodecs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optionalFieldCodecs.d.ts","sourceRoot":"","sources":["../../../src/feature-libraries/optional-field/optionalFieldCodecs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,UAAU,EAA8B,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAW,MAAM,qBAAqB,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAQ,iBAAiB,EAAc,MAAM,+BAA+B,CAAC;AAGzF,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,CAAC,EAAE,qBAAqB,CAGpD,CAAC;AAEpB,eAAO,MAAM,4BAA4B,gKAOtB,WACjB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,CACrB,yEAE2E,CAAC"}
+{"version":3,"file":"optionalFieldCodecs.d.ts","sourceRoot":"","sources":["../../../src/feature-libraries/optional-field/optionalFieldCodecs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAIvE,eAAO,MAAM,4BAA4B,qBACtB,WACjB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,CACrB,KACC,aAAa,iBAAiB,EAAE,0BAA0B,CAI1D,CAAC"}

package/lib/feature-libraries/optional-field/optionalFieldCodecs.js

@@ -2,154 +2,11 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-import { Type } from "@sinclair/typebox";
-import { assert } from "@fluidframework/core-utils";
-import { makeCodecFamily, unitCodec } from "../../codec/index.js";
-import { makeChangeAtomIdCodec } from "../changeAtomIdCodec.js";
-import { EncodedOptionalChangeset, EncodedRegisterId } from "./optionalFieldChangeFormat.js";
-export const noChangeCodecFamily = makeCodecFamily([[0, unitCodec]]);
-export const makeOptionalFieldCodecFamily = (childCodec, revisionTagCodec) => makeCodecFamily([[0, makeOptionalFieldCodec(childCodec, revisionTagCodec)]]);
-function makeRegisterIdCodec(revisionTagCodec) {
-    const changeAtomIdCodec = makeChangeAtomIdCodec(revisionTagCodec);
-    return {
-        encode: (registerId, context) => {
-            if (registerId === "self") {
-                return null;
-            }
-            return changeAtomIdCodec.encode(registerId, context);
-        },
-        decode: (registerId, context) => {
-            if (registerId === null) {
-                return "self";
-            }
-            return changeAtomIdCodec.decode(registerId, context);
-        },
-        encodedSchema: EncodedRegisterId,
-    };
-}
-function makeOptionalFieldCodec(childCodec, revisionTagCodec) {
-    const registerIdCodec = makeRegisterIdCodec(revisionTagCodec);
-    return {
-        encode: (change, context) => {
-            const encoded = {};
-            encoded.m = [];
-            if (change.valueReplace !== undefined) {
-                if (change.valueReplace.src !== undefined) {
-                    encoded.m.push([
-                        registerIdCodec.encode(change.valueReplace.src, context),
-                        registerIdCodec.encode("self", context),
-                        true,
-                    ]);
-                }
-                if (change.valueReplace.isEmpty) {
-                    encoded.d = registerIdCodec.encode(change.valueReplace.dst, context);
-                }
-                else {
-                    encoded.m.push([
-                        registerIdCodec.encode("self", context),
-                        registerIdCodec.encode(change.valueReplace.dst, context),
-                        false,
-                    ]);
-                }
-            }
-            for (const [src, dst] of change.moves) {
-                encoded.m.push([
-                    registerIdCodec.encode(src, context),
-                    registerIdCodec.encode(dst, context),
-                    true,
-                ]);
-            }
-            if (encoded.m.length === 0) {
-                delete encoded.m;
-            }
-            if (change.childChanges.length > 0) {
-                encoded.c = [];
-                for (const [id, childChange] of change.childChanges) {
-                    encoded.c.push([
-                        registerIdCodec.encode(id, context),
-                        childCodec.encode(childChange, context),
-                    ]);
-                }
-            }
-            return encoded;
-        },
-        decode: (encoded, context) => {
-            // The register that the node in the optional field is moved to upon detach
-            let detached;
-            // The register that the node is moved from to upon attaching that node in the optional field
-            let attached;
-            const moves = [];
-            if (encoded.m !== undefined) {
-                for (const [encodedSrc, encodedDst] of encoded.m) {
-                    const src = registerIdCodec.decode(encodedSrc, context);
-                    const dst = registerIdCodec.decode(encodedDst, context);
-                    if (src === "self" || dst === "self") {
-                        if (src === "self") {
-                            assert(detached === undefined, 0x8d0 /* Multiple detached nodes */);
-                            detached = dst;
-                        }
-                        if (dst === "self") {
-                            assert(attached === undefined, 0x8d1 /* Multiple attached nodes */);
-                            attached = src;
-                        }
-                    }
-                    else {
-                        moves.push([src, dst]);
-                    }
-                }
-            }
-            const decoded = {
-                moves,
-                childChanges: encoded.c?.map(([id, encodedChange]) => [
-                    registerIdCodec.decode(id, context),
-                    childCodec.decode(encodedChange, context),
-                ]) ?? [],
-            };
-            if (detached !== undefined && attached !== undefined) {
-                if (detached === "self" || attached === "self") {
-                    assert(encoded.d !== undefined, 0x8d2 /* Invalid change: pin must have a reserved detach ID */);
-                    const reserved = registerIdCodec.decode(encoded.d, context);
-                    assert(reserved !== "self", 0x8d3 /* Invalid reserved detach ID */);
-                    decoded.valueReplace = { isEmpty: false, dst: reserved, src: "self" };
-                }
-                else {
-                    assert(encoded.d === undefined, 0x8d4 /* Invalid change: unexpected reserved detach ID on a change that detaches a node from the field */);
-                    decoded.valueReplace = {
-                        isEmpty: false,
-                        dst: detached,
-                        src: attached,
-                    };
-                }
-            }
-            else if (attached !== undefined) {
-                assert(encoded.d !== undefined, 0x8d5 /* Invalid change: attach must have a reserved detach ID */);
-                const reserved = registerIdCodec.decode(encoded.d, context);
-                assert(reserved !== "self", 0x8d6 /* Invalid reserved detach ID */);
-                decoded.valueReplace = {
-                    isEmpty: true,
-                    dst: reserved,
-                    src: attached,
-                };
-            }
-            else if (detached !== undefined) {
-                assert(encoded.d === undefined, 0x8d7 /* Invalid change: unexpected reserved detach ID on a change that detaches a node from the field */);
-                assert(detached !== "self", 0x8d8 /* Invalid detach ID */);
-                decoded.valueReplace = {
-                    isEmpty: false,
-                    dst: detached,
-                };
-            }
-            else if (encoded.d !== undefined) {
-                const detachId = registerIdCodec.decode(encoded.d, context);
-                assert(detachId !== "self", 0x8d9 /* Invalid detach ID */);
-                decoded.valueReplace = {
-                    isEmpty: true,
-                    dst: detachId,
-                };
-            }
-            return decoded;
-        },
-        encodedSchema: EncodedOptionalChangeset(childCodec.encodedSchema ?? Type.Any()),
-    };
-}
+import { makeCodecFamily } from "../../codec/index.js";
+import { makeOptionalFieldCodec as makeV1Codec } from "./optionalFieldCodecV1.js";
+import { makeOptionalFieldCodec as makeV2Codec } from "./optionalFieldCodecV2.js";
+export const makeOptionalFieldCodecFamily = (revisionTagCodec) => makeCodecFamily([
+    [1, makeV1Codec(revisionTagCodec)],
+    [2, makeV2Codec(revisionTagCodec)],
+]);
 //# sourceMappingURL=optionalFieldCodecs.js.map

package/lib/feature-libraries/optional-field/optionalFieldCodecs.js.map

@@ -1 +1 @@
-{"version":3,"file":"optionalFieldCodecs.js","sourceRoot":"","sources":["../../../src/feature-libraries/optional-field/optionalFieldCodecs.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { TAnySchema, Type } from \"@sinclair/typebox\";\nimport { assert } from \"@fluidframework/core-utils\";\nimport { ICodecFamily, IJsonCodec, makeCodecFamily, unitCodec } from \"../../codec/index.js\";\nimport { ChangeEncodingContext, EncodedRevisionTag, RevisionTag } from \"../../core/index.js\";\nimport { JsonCompatibleReadOnly, Mutable } from \"../../util/index.js\";\nimport { makeChangeAtomIdCodec } from \"../changeAtomIdCodec.js\";\nimport type { NodeChangeset } from \"../modular-schema/index.js\";\nimport type { Move, OptionalChangeset, RegisterId } from \"./optionalFieldChangeTypes.js\";\nimport { EncodedOptionalChangeset, EncodedRegisterId } from \"./optionalFieldChangeFormat.js\";\n\nexport const noChangeCodecFamily: ICodecFamily<0, ChangeEncodingContext> = makeCodecFamily<\n\t0,\n\tChangeEncodingContext\n>([[0, unitCodec]]);\n\nexport const makeOptionalFieldCodecFamily = <TChildChange = NodeChangeset>(\n\tchildCodec: IJsonCodec<\n\t\tTChildChange,\n\t\tJsonCompatibleReadOnly,\n\t\tJsonCompatibleReadOnly,\n\t\tChangeEncodingContext\n\t>,\n\trevisionTagCodec: IJsonCodec<\n\t\tRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tChangeEncodingContext\n\t>,\n): ICodecFamily<OptionalChangeset<TChildChange>, ChangeEncodingContext> =>\n\tmakeCodecFamily([[0, makeOptionalFieldCodec(childCodec, revisionTagCodec)]]);\n\nfunction makeRegisterIdCodec(\n\trevisionTagCodec: IJsonCodec<\n\t\tRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tChangeEncodingContext\n\t>,\n): IJsonCodec<RegisterId, EncodedRegisterId, EncodedRegisterId, ChangeEncodingContext> {\n\tconst changeAtomIdCodec = makeChangeAtomIdCodec(revisionTagCodec);\n\treturn {\n\t\tencode: (registerId: RegisterId, context: ChangeEncodingContext) => {\n\t\t\tif (registerId === \"self\") {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\treturn changeAtomIdCodec.encode(registerId, context);\n\t\t},\n\t\tdecode: (registerId: EncodedRegisterId, context: ChangeEncodingContext) => {\n\t\t\tif (registerId === null) {\n\t\t\t\treturn \"self\";\n\t\t\t}\n\t\t\treturn changeAtomIdCodec.decode(registerId, context);\n\t\t},\n\t\tencodedSchema: EncodedRegisterId,\n\t};\n}\n\nfunction makeOptionalFieldCodec<TChildChange = NodeChangeset>(\n\tchildCodec: IJsonCodec<\n\t\tTChildChange,\n\t\tJsonCompatibleReadOnly,\n\t\tJsonCompatibleReadOnly,\n\t\tChangeEncodingContext\n\t>,\n\trevisionTagCodec: IJsonCodec<\n\t\tRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tChangeEncodingContext\n\t>,\n): IJsonCodec<\n\tOptionalChangeset<TChildChange>,\n\tEncodedOptionalChangeset<TAnySchema>,\n\tEncodedOptionalChangeset<TAnySchema>,\n\tChangeEncodingContext\n> {\n\tconst registerIdCodec = makeRegisterIdCodec(revisionTagCodec);\n\n\treturn {\n\t\tencode: (change: OptionalChangeset<TChildChange>, context: ChangeEncodingContext) => {\n\t\t\tconst encoded: EncodedOptionalChangeset<TAnySchema> = {};\n\t\t\tencoded.m = [];\n\n\t\t\tif (change.valueReplace !== undefined) {\n\t\t\t\tif (change.valueReplace.src !== undefined) {\n\t\t\t\t\tencoded.m.push([\n\t\t\t\t\t\tregisterIdCodec.encode(change.valueReplace.src, context),\n\t\t\t\t\t\tregisterIdCodec.encode(\"self\", context),\n\t\t\t\t\t\ttrue,\n\t\t\t\t\t]);\n\t\t\t\t}\n\n\t\t\t\tif (change.valueReplace.isEmpty) {\n\t\t\t\t\tencoded.d = registerIdCodec.encode(change.valueReplace.dst, context);\n\t\t\t\t} else {\n\t\t\t\t\tencoded.m.push([\n\t\t\t\t\t\tregisterIdCodec.encode(\"self\", context),\n\t\t\t\t\t\tregisterIdCodec.encode(change.valueReplace.dst, context),\n\t\t\t\t\t\tfalse,\n\t\t\t\t\t]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tfor (const [src, dst] of change.moves) {\n\t\t\t\tencoded.m.push([\n\t\t\t\t\tregisterIdCodec.encode(src, context),\n\t\t\t\t\tregisterIdCodec.encode(dst, context),\n\t\t\t\t\ttrue,\n\t\t\t\t]);\n\t\t\t}\n\n\t\t\tif (encoded.m.length === 0) {\n\t\t\t\tdelete encoded.m;\n\t\t\t}\n\n\t\t\tif (change.childChanges.length > 0) {\n\t\t\t\tencoded.c = [];\n\t\t\t\tfor (const [id, childChange] of change.childChanges) {\n\t\t\t\t\tencoded.c.push([\n\t\t\t\t\t\tregisterIdCodec.encode(id, context),\n\t\t\t\t\t\tchildCodec.encode(childChange, context),\n\t\t\t\t\t]);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn encoded;\n\t\t},\n\n\t\tdecode: (encoded: EncodedOptionalChangeset<TAnySchema>, context: ChangeEncodingContext) => {\n\t\t\t// The register that the node in the optional field is moved to upon detach\n\t\t\tlet detached: RegisterId | undefined;\n\t\t\t// The register that the node is moved from to upon attaching that node in the optional field\n\t\t\tlet attached: RegisterId | undefined;\n\t\t\tconst moves: Move[] = [];\n\t\t\tif (encoded.m !== undefined) {\n\t\t\t\tfor (const [encodedSrc, encodedDst] of encoded.m) {\n\t\t\t\t\tconst src = registerIdCodec.decode(encodedSrc, context);\n\t\t\t\t\tconst dst = registerIdCodec.decode(encodedDst, context);\n\t\t\t\t\tif (src === \"self\" || dst === \"self\") {\n\t\t\t\t\t\tif (src === \"self\") {\n\t\t\t\t\t\t\tassert(detached === undefined, 0x8d0 /* Multiple detached nodes */);\n\t\t\t\t\t\t\tdetached = dst;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (dst === \"self\") {\n\t\t\t\t\t\t\tassert(attached === undefined, 0x8d1 /* Multiple attached nodes */);\n\t\t\t\t\t\t\tattached = src;\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tmoves.push([src, dst]);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst decoded: Mutable<OptionalChangeset<TChildChange>> = {\n\t\t\t\tmoves,\n\t\t\t\tchildChanges:\n\t\t\t\t\tencoded.c?.map(([id, encodedChange]) => [\n\t\t\t\t\t\tregisterIdCodec.decode(id, context),\n\t\t\t\t\t\tchildCodec.decode(encodedChange, context),\n\t\t\t\t\t]) ?? [],\n\t\t\t};\n\n\t\t\tif (detached !== undefined && attached !== undefined) {\n\t\t\t\tif (detached === \"self\" || attached === \"self\") {\n\t\t\t\t\tassert(\n\t\t\t\t\t\tencoded.d !== undefined,\n\t\t\t\t\t\t0x8d2 /* Invalid change: pin must have a reserved detach ID */,\n\t\t\t\t\t);\n\t\t\t\t\tconst reserved = registerIdCodec.decode(encoded.d, context);\n\t\t\t\t\tassert(reserved !== \"self\", 0x8d3 /* Invalid reserved detach ID */);\n\t\t\t\t\tdecoded.valueReplace = { isEmpty: false, dst: reserved, src: \"self\" };\n\t\t\t\t} else {\n\t\t\t\t\tassert(\n\t\t\t\t\t\tencoded.d === undefined,\n\t\t\t\t\t\t0x8d4 /* Invalid change: unexpected reserved detach ID on a change that detaches a node from the field */,\n\t\t\t\t\t);\n\t\t\t\t\tdecoded.valueReplace = {\n\t\t\t\t\t\tisEmpty: false,\n\t\t\t\t\t\tdst: detached,\n\t\t\t\t\t\tsrc: attached,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t} else if (attached !== undefined) {\n\t\t\t\tassert(\n\t\t\t\t\tencoded.d !== undefined,\n\t\t\t\t\t0x8d5 /* Invalid change: attach must have a reserved detach ID */,\n\t\t\t\t);\n\t\t\t\tconst reserved = registerIdCodec.decode(encoded.d, context);\n\t\t\t\tassert(reserved !== \"self\", 0x8d6 /* Invalid reserved detach ID */);\n\t\t\t\tdecoded.valueReplace = {\n\t\t\t\t\tisEmpty: true,\n\t\t\t\t\tdst: reserved,\n\t\t\t\t\tsrc: attached,\n\t\t\t\t};\n\t\t\t} else if (detached !== undefined) {\n\t\t\t\tassert(\n\t\t\t\t\tencoded.d === undefined,\n\t\t\t\t\t0x8d7 /* Invalid change: unexpected reserved detach ID on a change that detaches a node from the field */,\n\t\t\t\t);\n\t\t\t\tassert(detached !== \"self\", 0x8d8 /* Invalid detach ID */);\n\t\t\t\tdecoded.valueReplace = {\n\t\t\t\t\tisEmpty: false,\n\t\t\t\t\tdst: detached,\n\t\t\t\t};\n\t\t\t} else if (encoded.d !== undefined) {\n\t\t\t\tconst detachId = registerIdCodec.decode(encoded.d, context);\n\t\t\t\tassert(detachId !== \"self\", 0x8d9 /* Invalid detach ID */);\n\t\t\t\tdecoded.valueReplace = {\n\t\t\t\t\tisEmpty: true,\n\t\t\t\t\tdst: detachId,\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn decoded;\n\t\t},\n\t\tencodedSchema: EncodedOptionalChangeset(childCodec.encodedSchema ?? Type.Any()),\n\t};\n}\n"]}
+{"version":3,"file":"optionalFieldCodecs.js","sourceRoot":"","sources":["../../../src/feature-libraries/optional-field/optionalFieldCodecs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA4B,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKjF,OAAO,EAAE,sBAAsB,IAAI,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,sBAAsB,IAAI,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAElF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC3C,gBAKC,EAC6D,EAAE,CAChE,eAAe,CAAC;IACf,CAAC,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAClC,CAAC,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;CAClC,CAAC,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { ICodecFamily, IJsonCodec, makeCodecFamily } from \"../../codec/index.js\";\nimport { ChangeEncodingContext, EncodedRevisionTag, RevisionTag } from \"../../core/index.js\";\nimport type { FieldChangeEncodingContext } from \"../modular-schema/index.js\";\n\nimport type { OptionalChangeset } from \"./optionalFieldChangeTypes.js\";\nimport { makeOptionalFieldCodec as makeV1Codec } from \"./optionalFieldCodecV1.js\";\nimport { makeOptionalFieldCodec as makeV2Codec } from \"./optionalFieldCodecV2.js\";\n\nexport const makeOptionalFieldCodecFamily = (\n\trevisionTagCodec: IJsonCodec<\n\t\tRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tEncodedRevisionTag,\n\t\tChangeEncodingContext\n\t>,\n): ICodecFamily<OptionalChangeset, FieldChangeEncodingContext> =>\n\tmakeCodecFamily([\n\t\t[1, makeV1Codec(revisionTagCodec)],\n\t\t[2, makeV2Codec(revisionTagCodec)],\n\t]);\n"]}

package/lib/feature-libraries/schema-aware/schemaAware.d.ts

@@ -2,11 +2,10 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-import { TreeNodeSchemaIdentifier, TreeValue, ValueSchema } from "../../core/index.js";
-import { ContextuallyTypedNodeData, typeNameSymbol, valueSymbol } from "../contextuallyTyped.js";
-import { FlexFieldSchema, FlexTreeNodeSchema, FlexAllowedTypes, LeafNodeSchema, FlexObjectNodeSchema, FlexObjectNodeFields, FlexFieldNodeSchema, FlexMapNodeSchema, FlexListToUnion, LazyItem } from "../typed-schema/index.js";
+import { TreeNodeSchemaIdentifier, TreeValue, ValueSchema, Multiplicity } from "../../core/index.js";
 import { Assume, FlattenKeys, _InlineTrick } from "../../util/index.js";
-import { Multiplicity } from "../multiplicity.js";
+import { ContextuallyTypedNodeData, typeNameSymbol, valueSymbol } from "../contextuallyTyped.js";
+import { FlexAllowedTypes, FlexFieldNodeSchema, FlexFieldSchema, FlexListToUnion, FlexMapNodeSchema, FlexObjectNodeFields, FlexObjectNodeSchema, FlexTreeNodeSchema, LazyItem, LeafNodeSchema } from "../typed-schema/index.js";
 /**
  * Empty Object for use in type computations that should contribute no fields when `&`ed with another type.
  * @internal

package/lib/feature-libraries/schema-aware/schemaAware.d.ts.map

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

package/lib/feature-libraries/schema-aware/schemaAware.js

@@ -2,6 +2,6 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
+import { Multiplicity, } from "../../core/index.js";
 import { typeNameSymbol, valueSymbol } from "../contextuallyTyped.js";
-import { Multiplicity } from "../multiplicity.js";
 //# sourceMappingURL=schemaAware.js.map

package/lib/feature-libraries/schema-aware/schemaAware.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemaAware.js","sourceRoot":"","sources":["../../../src/feature-libraries/schema-aware/schemaAware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAA6B,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAcjG,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { TreeNodeSchemaIdentifier, TreeValue, ValueSchema } from \"../../core/index.js\";\nimport { ContextuallyTypedNodeData, typeNameSymbol, valueSymbol } from \"../contextuallyTyped.js\";\nimport {\n\tFlexFieldSchema,\n\tFlexTreeNodeSchema,\n\tFlexAllowedTypes,\n\tLeafNodeSchema,\n\tFlexObjectNodeSchema,\n\tFlexObjectNodeFields,\n\tFlexFieldNodeSchema,\n\tFlexMapNodeSchema,\n\tFlexListToUnion,\n\tLazyItem,\n} from \"../typed-schema/index.js\";\nimport { Assume, FlattenKeys, _InlineTrick } from \"../../util/index.js\";\nimport { Multiplicity } from \"../multiplicity.js\";\n\n/**\n * Empty Object for use in type computations that should contribute no fields when `&`ed with another type.\n * @internal\n */\n// Using {} instead of interface {} or Record<string, never> for empty object here produces better IntelliSense in the generated types than `Record<string, never>` recommended by the linter.\n// Making this a type instead of an interface prevents it from showing up in IntelliSense, and also avoids breaking the typing somehow.\n// eslint-disable-next-line @typescript-eslint/ban-types, @typescript-eslint/consistent-type-definitions\nexport type EmptyObject = {};\n\n/**\n * Collects the various parts of the API together.\n * @internal\n */\nexport type CollectOptions<\n\tTTypedFields,\n\tTValueSchema extends ValueSchema | undefined,\n\tTName,\n> = TValueSchema extends undefined\n\t? FlattenKeys<\n\t\t\t{ [typeNameSymbol]?: UnbrandedName<TName> } & (TValueSchema extends ValueSchema\n\t\t\t\t? { [valueSymbol]: TreeValue<TValueSchema> }\n\t\t\t\t: EmptyObject)\n\t  > &\n\t\t\tTTypedFields\n\t: TValueSchema extends ValueSchema\n\t? TreeValue<TValueSchema>\n\t: undefined;\n\n/**\n * Remove type brand from name.\n * @internal\n */\nexport type UnbrandedName<TName> = [\n\tTName extends TreeNodeSchemaIdentifier<infer S> ? S : string,\n][_InlineTrick];\n\n/**\n * `{ [key: string]: FieldSchemaTypeInfo }` to `{ [key: string]: TypedTree }`\n *\n * In Editable mode, unwraps the fields.\n * @internal\n */\nexport type TypedFields<TFields extends undefined | { readonly [key: string]: FlexFieldSchema }> = [\n\tTFields extends { [key: string]: FlexFieldSchema }\n\t\t? {\n\t\t\t\t-readonly [key in keyof TFields]: InsertableFlexField<TFields[key]>;\n\t\t  }\n\t\t: EmptyObject,\n][_InlineTrick];\n\n/**\n * `TreeFieldSchema` to `TypedField`. May unwrap to child depending on FieldKind.\n * @internal\n */\nexport type InsertableFlexField<TField extends FlexFieldSchema> = [\n\tApplyMultiplicity<\n\t\tTField[\"kind\"][\"multiplicity\"],\n\t\tAllowedTypesToFlexInsertableTree<TField[\"allowedTypes\"]>\n\t>,\n][_InlineTrick];\n\n/**\n * Adjusts the API for a field based on its Multiplicity.\n * @internal\n */\nexport type ApplyMultiplicity<TMultiplicity extends Multiplicity, TypedChild> = {\n\t[Multiplicity.Forbidden]: undefined;\n\t[Multiplicity.Optional]: undefined | TypedChild;\n\t[Multiplicity.Sequence]: TypedChild[];\n\t[Multiplicity.Single]: TypedChild;\n}[TMultiplicity];\n\n/**\n * Takes in `AllowedTypes` and returns a TypedTree union.\n * @internal\n */\nexport type AllowedTypesToFlexInsertableTree<T extends FlexAllowedTypes> = [\n\tT extends readonly LazyItem<FlexTreeNodeSchema>[]\n\t\t? InsertableFlexNode<Assume<FlexListToUnion<T>, FlexTreeNodeSchema>>\n\t\t: ContextuallyTypedNodeData,\n][_InlineTrick];\n\n/**\n * Generate a schema aware API for a single tree schema.\n * @internal\n */\nexport type InsertableFlexNode<TSchema extends FlexTreeNodeSchema> = FlattenKeys<\n\tCollectOptions<\n\t\tTSchema extends FlexObjectNodeSchema<string, infer TFields extends FlexObjectNodeFields>\n\t\t\t? TypedFields<TFields>\n\t\t\t: TSchema extends FlexFieldNodeSchema<string, infer TField extends FlexFieldSchema>\n\t\t\t? InsertableFlexField<TField>\n\t\t\t: TSchema extends FlexMapNodeSchema<string, infer TField extends FlexFieldSchema>\n\t\t\t? {\n\t\t\t\t\treadonly [P in string]: InsertableFlexField<TField>;\n\t\t\t  }\n\t\t\t: EmptyObject,\n\t\tTSchema extends LeafNodeSchema<string, infer TValueSchema> ? TValueSchema : undefined,\n\t\tTSchema[\"name\"]\n\t>\n>;\n"]}
+{"version":3,"file":"schemaAware.js","sourceRoot":"","sources":["../../../src/feature-libraries/schema-aware/schemaAware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIN,YAAY,GACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAA6B,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport {\n\tTreeNodeSchemaIdentifier,\n\tTreeValue,\n\tValueSchema,\n\tMultiplicity,\n} from \"../../core/index.js\";\nimport { Assume, FlattenKeys, _InlineTrick } from \"../../util/index.js\";\nimport { ContextuallyTypedNodeData, typeNameSymbol, valueSymbol } from \"../contextuallyTyped.js\";\nimport {\n\tFlexAllowedTypes,\n\tFlexFieldNodeSchema,\n\tFlexFieldSchema,\n\tFlexListToUnion,\n\tFlexMapNodeSchema,\n\tFlexObjectNodeFields,\n\tFlexObjectNodeSchema,\n\tFlexTreeNodeSchema,\n\tLazyItem,\n\tLeafNodeSchema,\n} from \"../typed-schema/index.js\";\n\n/**\n * Empty Object for use in type computations that should contribute no fields when `&`ed with another type.\n * @internal\n */\n// Using {} instead of interface {} or Record<string, never> for empty object here produces better IntelliSense in the generated types than `Record<string, never>` recommended by the linter.\n// Making this a type instead of an interface prevents it from showing up in IntelliSense, and also avoids breaking the typing somehow.\n// eslint-disable-next-line @typescript-eslint/ban-types, @typescript-eslint/consistent-type-definitions\nexport type EmptyObject = {};\n\n/**\n * Collects the various parts of the API together.\n * @internal\n */\nexport type CollectOptions<\n\tTTypedFields,\n\tTValueSchema extends ValueSchema | undefined,\n\tTName,\n> = TValueSchema extends undefined\n\t? FlattenKeys<\n\t\t\t{ [typeNameSymbol]?: UnbrandedName<TName> } & (TValueSchema extends ValueSchema\n\t\t\t\t? { [valueSymbol]: TreeValue<TValueSchema> }\n\t\t\t\t: EmptyObject)\n\t  > &\n\t\t\tTTypedFields\n\t: TValueSchema extends ValueSchema\n\t? TreeValue<TValueSchema>\n\t: undefined;\n\n/**\n * Remove type brand from name.\n * @internal\n */\nexport type UnbrandedName<TName> = [\n\tTName extends TreeNodeSchemaIdentifier<infer S> ? S : string,\n][_InlineTrick];\n\n/**\n * `{ [key: string]: FieldSchemaTypeInfo }` to `{ [key: string]: TypedTree }`\n *\n * In Editable mode, unwraps the fields.\n * @internal\n */\nexport type TypedFields<TFields extends undefined | { readonly [key: string]: FlexFieldSchema }> = [\n\tTFields extends { [key: string]: FlexFieldSchema }\n\t\t? {\n\t\t\t\t-readonly [key in keyof TFields]: InsertableFlexField<TFields[key]>;\n\t\t  }\n\t\t: EmptyObject,\n][_InlineTrick];\n\n/**\n * `TreeFieldSchema` to `TypedField`. May unwrap to child depending on FieldKind.\n * @internal\n */\nexport type InsertableFlexField<TField extends FlexFieldSchema> = [\n\tApplyMultiplicity<\n\t\tTField[\"kind\"][\"multiplicity\"],\n\t\tAllowedTypesToFlexInsertableTree<TField[\"allowedTypes\"]>\n\t>,\n][_InlineTrick];\n\n/**\n * Adjusts the API for a field based on its Multiplicity.\n * @internal\n */\nexport type ApplyMultiplicity<TMultiplicity extends Multiplicity, TypedChild> = {\n\t[Multiplicity.Forbidden]: undefined;\n\t[Multiplicity.Optional]: undefined | TypedChild;\n\t[Multiplicity.Sequence]: TypedChild[];\n\t[Multiplicity.Single]: TypedChild;\n}[TMultiplicity];\n\n/**\n * Takes in `AllowedTypes` and returns a TypedTree union.\n * @internal\n */\nexport type AllowedTypesToFlexInsertableTree<T extends FlexAllowedTypes> = [\n\tT extends readonly LazyItem<FlexTreeNodeSchema>[]\n\t\t? InsertableFlexNode<Assume<FlexListToUnion<T>, FlexTreeNodeSchema>>\n\t\t: ContextuallyTypedNodeData,\n][_InlineTrick];\n\n/**\n * Generate a schema aware API for a single tree schema.\n * @internal\n */\nexport type InsertableFlexNode<TSchema extends FlexTreeNodeSchema> = FlattenKeys<\n\tCollectOptions<\n\t\tTSchema extends FlexObjectNodeSchema<string, infer TFields extends FlexObjectNodeFields>\n\t\t\t? TypedFields<TFields>\n\t\t\t: TSchema extends FlexFieldNodeSchema<string, infer TField extends FlexFieldSchema>\n\t\t\t? InsertableFlexField<TField>\n\t\t\t: TSchema extends FlexMapNodeSchema<string, infer TField extends FlexFieldSchema>\n\t\t\t? {\n\t\t\t\t\treadonly [P in string]: InsertableFlexField<TField>;\n\t\t\t  }\n\t\t\t: EmptyObject,\n\t\tTSchema extends LeafNodeSchema<string, infer TValueSchema> ? TValueSchema : undefined,\n\t\tTSchema[\"name\"]\n\t>\n>;\n"]}

package/lib/feature-libraries/schema-edits/index.d.ts

@@ -2,7 +2,7 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export { makeSchemaChangeCodec } from "./schemaChangeCodecs.js";
+export { makeSchemaChangeCodecs } from "./schemaChangeCodecs.js";
 export { SchemaChange } from "./schemaChangeTypes.js";
 export { EncodedSchemaChange } from "./schemaChangeFormat.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/feature-libraries/schema-edits/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/feature-libraries/schema-edits/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/feature-libraries/schema-edits/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/lib/feature-libraries/schema-edits/index.js

@@ -2,6 +2,6 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export { makeSchemaChangeCodec } from "./schemaChangeCodecs.js";
+export { makeSchemaChangeCodecs } from "./schemaChangeCodecs.js";
 export { EncodedSchemaChange } from "./schemaChangeFormat.js";
 //# sourceMappingURL=index.js.map

package/lib/feature-libraries/schema-edits/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/feature-libraries/schema-edits/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport { makeSchemaChangeCodec } from \"./schemaChangeCodecs.js\";\nexport { SchemaChange } from \"./schemaChangeTypes.js\";\nexport { EncodedSchemaChange } from \"./schemaChangeFormat.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/feature-libraries/schema-edits/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport { makeSchemaChangeCodecs } from \"./schemaChangeCodecs.js\";\nexport { SchemaChange } from \"./schemaChangeTypes.js\";\nexport { EncodedSchemaChange } from \"./schemaChangeFormat.js\";\n"]}