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

package/dist/domains/json/jsonCursor.js

@@ -5,7 +5,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cursorToJsonObject = exports.singleJsonCursor = void 0;
-const core_utils_1 = require("@fluidframework/core-utils");
+const internal_1 = require("@fluidframework/core-utils/internal");
 const index_js_1 = require("../../core/index.js");
 const index_js_2 = require("../../feature-libraries/index.js");
 const leafDomain_js_1 = require("../leafDomain.js");
@@ -65,7 +65,7 @@ const adapter = {
         }
         if (Object.prototype.hasOwnProperty.call(node, key)) {
             const field = node[key];
-            (0, core_utils_1.assert)(field !== undefined, 0x41e /* explicit undefined fields should not be preserved in JSON */);
+            (0, internal_1.assert)(field !== undefined, 0x41e /* explicit undefined fields should not be preserved in JSON */);
             return [field];
         }
         return [];
@@ -90,8 +90,8 @@ function cursorToJsonObject(reader) {
         case leafDomain_js_1.leaf.number.name:
         case leafDomain_js_1.leaf.boolean.name:
         case leafDomain_js_1.leaf.string.name:
-            (0, core_utils_1.assert)(reader.value !== undefined, 0x84f /* out of schema: missing value */);
-            (0, core_utils_1.assert)(!(0, index_js_2.isFluidHandle)(reader.value), 0x850 /* out of schema: unexpected FluidHandle */);
+            (0, internal_1.assert)(reader.value !== undefined, 0x84f /* out of schema: missing value */);
+            (0, internal_1.assert)(!(0, index_js_2.isFluidHandle)(reader.value), 0x850 /* out of schema: unexpected FluidHandle */);
             return reader.value;
         case jsonDomainSchema_js_1.jsonArray.name: {
             reader.enterField(index_js_1.EmptyKey);
@@ -103,7 +103,7 @@ function cursorToJsonObject(reader) {
             const result = {};
             (0, index_js_1.mapCursorFields)(reader, (cursor) => {
                 const key = cursor.getFieldKey();
-                (0, core_utils_1.assert)(cursor.firstNode(), 0x420 /* expected non-empty field */);
+                (0, internal_1.assert)(cursor.firstNode(), 0x420 /* expected non-empty field */);
                 // like `result[key] = cursorToJsonObject(reader);` except safe when keyString == "__proto__".
                 Object.defineProperty(result, key, {
                     enumerable: true,
@@ -111,12 +111,12 @@ function cursorToJsonObject(reader) {
                     writable: true,
                     value: cursorToJsonObject(reader),
                 });
-                (0, core_utils_1.assert)(!cursor.nextNode(), 0x421 /* expected exactly one node */);
+                (0, internal_1.assert)(!cursor.nextNode(), 0x421 /* expected exactly one node */);
             });
             return result;
         }
         default: {
-            (0, core_utils_1.assert)(type === leafDomain_js_1.leaf.null.name, 0x422 /* unexpected type */);
+            (0, internal_1.assert)(type === leafDomain_js_1.leaf.null.name, 0x422 /* unexpected type */);
             return null;
         }
     }

package/dist/domains/json/jsonCursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonCursor.js","sourceRoot":"","sources":["../../../src/domains/json/jsonCursor.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\";\nimport {\n\tITreeCursor,\n\tEmptyKey,\n\tFieldKey,\n\tmapCursorField,\n\tmapCursorFields,\n\tITreeCursorSynchronous,\n} from \"../../core/index.js\";\nimport { JsonCompatible } from \"../../util/index.js\";\nimport {\n\tCursorAdapter,\n\tisFluidHandle,\n\tstackTreeNodeCursor,\n} from \"../../feature-libraries/index.js\";\nimport { leaf } from \"../leafDomain.js\";\nimport { jsonArray, jsonObject } from \"./jsonDomainSchema.js\";\n\nconst adapter: CursorAdapter<JsonCompatible> = {\n\tvalue: (node: JsonCompatible) =>\n\t\tnode !== null && typeof node === \"object\"\n\t\t\t? undefined // arrays and objects have no defined value\n\t\t\t: node, // null, boolean, numbers, and strings are their own values\n\ttype: (node: JsonCompatible) => {\n\t\tconst type = typeof node;\n\n\t\tswitch (type) {\n\t\t\tcase \"number\":\n\t\t\t\treturn leaf.number.name;\n\t\t\tcase \"string\":\n\t\t\t\treturn leaf.string.name;\n\t\t\tcase \"boolean\":\n\t\t\t\treturn leaf.boolean.name;\n\t\t\tdefault:\n\t\t\t\tif (node === null) {\n\t\t\t\t\treturn leaf.null.name;\n\t\t\t\t} else if (Array.isArray(node)) {\n\t\t\t\t\treturn jsonArray.name;\n\t\t\t\t} else {\n\t\t\t\t\treturn jsonObject.name;\n\t\t\t\t}\n\t\t}\n\t},\n\tkeysFromNode: (node: JsonCompatible): readonly FieldKey[] => {\n\t\tswitch (typeof node) {\n\t\t\tcase \"object\":\n\t\t\t\tif (node === null) {\n\t\t\t\t\treturn [];\n\t\t\t\t} else if (Array.isArray(node)) {\n\t\t\t\t\treturn node.length === 0 ? [] : [EmptyKey];\n\t\t\t\t} else {\n\t\t\t\t\treturn Object.keys(node) as FieldKey[];\n\t\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn [];\n\t\t}\n\t},\n\tgetFieldFromNode: (node: JsonCompatible, key: FieldKey): readonly JsonCompatible[] => {\n\t\t// Object.prototype.hasOwnProperty can return true for strings (ex: with key \"0\"), so we have to filter them out.\n\t\t// Rather than just special casing strings, we can handle them with an early return for all primitives.\n\t\tif (typeof node !== \"object\") {\n\t\t\treturn [];\n\t\t}\n\n\t\tif (node === null) {\n\t\t\treturn [];\n\t\t}\n\n\t\tif (Array.isArray(node)) {\n\t\t\treturn key === EmptyKey ? node : [];\n\t\t}\n\n\t\tif (Object.prototype.hasOwnProperty.call(node, key)) {\n\t\t\tconst field = node[key];\n\t\t\tassert(\n\t\t\t\tfield !== undefined,\n\t\t\t\t0x41e /* explicit undefined fields should not be preserved in JSON */,\n\t\t\t);\n\t\t\treturn [field];\n\t\t}\n\n\t\treturn [];\n\t},\n};\n\n/**\n * Used to read a Jsonable tree for testing and benchmarking.\n *\n * @returns an {@link ITreeCursorSynchronous} for a single {@link JsonCompatible}.\n */\nexport function singleJsonCursor(root: JsonCompatible): ITreeCursorSynchronous {\n\treturn stackTreeNodeCursor(adapter, root);\n}\n\n/**\n * Extract a JS object tree from the contents of the given ITreeCursor.\n * Assumes that ITreeCursor contains only unaugmented JsonTypes.\n */\nexport function cursorToJsonObject(reader: ITreeCursor): JsonCompatible {\n\tconst type = reader.type;\n\n\tswitch (type) {\n\t\tcase leaf.number.name:\n\t\tcase leaf.boolean.name:\n\t\tcase leaf.string.name:\n\t\t\tassert(reader.value !== undefined, 0x84f /* out of schema: missing value */);\n\t\t\tassert(!isFluidHandle(reader.value), 0x850 /* out of schema: unexpected FluidHandle */);\n\t\t\treturn reader.value;\n\t\tcase jsonArray.name: {\n\t\t\treader.enterField(EmptyKey);\n\t\t\tconst result = mapCursorField(reader, cursorToJsonObject);\n\t\t\treader.exitField();\n\t\t\treturn result;\n\t\t}\n\t\tcase jsonObject.name: {\n\t\t\tconst result: JsonCompatible = {};\n\t\t\tmapCursorFields(reader, (cursor) => {\n\t\t\t\tconst key = cursor.getFieldKey();\n\t\t\t\tassert(cursor.firstNode(), 0x420 /* expected non-empty field */);\n\t\t\t\t// like `result[key] = cursorToJsonObject(reader);` except safe when keyString == \"__proto__\".\n\t\t\t\tObject.defineProperty(result, key, {\n\t\t\t\t\tenumerable: true,\n\t\t\t\t\tconfigurable: true,\n\t\t\t\t\twritable: true,\n\t\t\t\t\tvalue: cursorToJsonObject(reader),\n\t\t\t\t});\n\t\t\t\tassert(!cursor.nextNode(), 0x421 /* expected exactly one node */);\n\t\t\t});\n\t\t\treturn result;\n\t\t}\n\t\tdefault: {\n\t\t\tassert(type === leaf.null.name, 0x422 /* unexpected type */);\n\t\t\treturn null;\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"jsonCursor.js","sourceRoot":"","sources":["../../../src/domains/json/jsonCursor.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\";\n\nimport {\n\tEmptyKey,\n\tFieldKey,\n\tITreeCursor,\n\tITreeCursorSynchronous,\n\tmapCursorField,\n\tmapCursorFields,\n} from \"../../core/index.js\";\nimport {\n\tCursorAdapter,\n\tisFluidHandle,\n\tstackTreeNodeCursor,\n} from \"../../feature-libraries/index.js\";\nimport { JsonCompatible } from \"../../util/index.js\";\nimport { leaf } from \"../leafDomain.js\";\n\nimport { jsonArray, jsonObject } from \"./jsonDomainSchema.js\";\n\nconst adapter: CursorAdapter<JsonCompatible> = {\n\tvalue: (node: JsonCompatible) =>\n\t\tnode !== null && typeof node === \"object\"\n\t\t\t? undefined // arrays and objects have no defined value\n\t\t\t: node, // null, boolean, numbers, and strings are their own values\n\ttype: (node: JsonCompatible) => {\n\t\tconst type = typeof node;\n\n\t\tswitch (type) {\n\t\t\tcase \"number\":\n\t\t\t\treturn leaf.number.name;\n\t\t\tcase \"string\":\n\t\t\t\treturn leaf.string.name;\n\t\t\tcase \"boolean\":\n\t\t\t\treturn leaf.boolean.name;\n\t\t\tdefault:\n\t\t\t\tif (node === null) {\n\t\t\t\t\treturn leaf.null.name;\n\t\t\t\t} else if (Array.isArray(node)) {\n\t\t\t\t\treturn jsonArray.name;\n\t\t\t\t} else {\n\t\t\t\t\treturn jsonObject.name;\n\t\t\t\t}\n\t\t}\n\t},\n\tkeysFromNode: (node: JsonCompatible): readonly FieldKey[] => {\n\t\tswitch (typeof node) {\n\t\t\tcase \"object\":\n\t\t\t\tif (node === null) {\n\t\t\t\t\treturn [];\n\t\t\t\t} else if (Array.isArray(node)) {\n\t\t\t\t\treturn node.length === 0 ? [] : [EmptyKey];\n\t\t\t\t} else {\n\t\t\t\t\treturn Object.keys(node) as FieldKey[];\n\t\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn [];\n\t\t}\n\t},\n\tgetFieldFromNode: (node: JsonCompatible, key: FieldKey): readonly JsonCompatible[] => {\n\t\t// Object.prototype.hasOwnProperty can return true for strings (ex: with key \"0\"), so we have to filter them out.\n\t\t// Rather than just special casing strings, we can handle them with an early return for all primitives.\n\t\tif (typeof node !== \"object\") {\n\t\t\treturn [];\n\t\t}\n\n\t\tif (node === null) {\n\t\t\treturn [];\n\t\t}\n\n\t\tif (Array.isArray(node)) {\n\t\t\treturn key === EmptyKey ? node : [];\n\t\t}\n\n\t\tif (Object.prototype.hasOwnProperty.call(node, key)) {\n\t\t\tconst field = node[key];\n\t\t\tassert(\n\t\t\t\tfield !== undefined,\n\t\t\t\t0x41e /* explicit undefined fields should not be preserved in JSON */,\n\t\t\t);\n\t\t\treturn [field];\n\t\t}\n\n\t\treturn [];\n\t},\n};\n\n/**\n * Used to read a Jsonable tree for testing and benchmarking.\n *\n * @returns an {@link ITreeCursorSynchronous} for a single {@link JsonCompatible}.\n */\nexport function singleJsonCursor(root: JsonCompatible): ITreeCursorSynchronous {\n\treturn stackTreeNodeCursor(adapter, root);\n}\n\n/**\n * Extract a JS object tree from the contents of the given ITreeCursor.\n * Assumes that ITreeCursor contains only unaugmented JsonTypes.\n */\nexport function cursorToJsonObject(reader: ITreeCursor): JsonCompatible {\n\tconst type = reader.type;\n\n\tswitch (type) {\n\t\tcase leaf.number.name:\n\t\tcase leaf.boolean.name:\n\t\tcase leaf.string.name:\n\t\t\tassert(reader.value !== undefined, 0x84f /* out of schema: missing value */);\n\t\t\tassert(!isFluidHandle(reader.value), 0x850 /* out of schema: unexpected FluidHandle */);\n\t\t\treturn reader.value;\n\t\tcase jsonArray.name: {\n\t\t\treader.enterField(EmptyKey);\n\t\t\tconst result = mapCursorField(reader, cursorToJsonObject);\n\t\t\treader.exitField();\n\t\t\treturn result;\n\t\t}\n\t\tcase jsonObject.name: {\n\t\t\tconst result: JsonCompatible = {};\n\t\t\tmapCursorFields(reader, (cursor) => {\n\t\t\t\tconst key = cursor.getFieldKey();\n\t\t\t\tassert(cursor.firstNode(), 0x420 /* expected non-empty field */);\n\t\t\t\t// like `result[key] = cursorToJsonObject(reader);` except safe when keyString == \"__proto__\".\n\t\t\t\tObject.defineProperty(result, key, {\n\t\t\t\t\tenumerable: true,\n\t\t\t\t\tconfigurable: true,\n\t\t\t\t\twritable: true,\n\t\t\t\t\tvalue: cursorToJsonObject(reader),\n\t\t\t\t});\n\t\t\t\tassert(!cursor.nextNode(), 0x421 /* expected exactly one node */);\n\t\t\t});\n\t\t\treturn result;\n\t\t}\n\t\tdefault: {\n\t\t\tassert(type === leaf.null.name, 0x422 /* unexpected type */);\n\t\t\treturn null;\n\t\t}\n\t}\n}\n"]}

package/dist/domains/json/jsonDomainSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonDomainSchema.d.ts","sourceRoot":"","sources":["../../../src/domains/json/jsonDomainSchema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAGN,eAAe,EAEf,MAAM,kCAAkC,CAAC;AAW1C;;GAEG;AACH,eAAO,MAAM,QAAQ,i9FAAkE,CAAC;AAOxF,eAAO,MAAM,UAAU,unGAGtB,CAAC;AAEF,eAAO,MAAM,SAAS,wnGAGrB,CAAC;AAEF,eAAO,MAAM,UAAU,sEAAwB,CAAC"}
+{"version":3,"file":"jsonDomainSchema.d.ts","sourceRoot":"","sources":["../../../src/domains/json/jsonDomainSchema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAGN,eAAe,EAEf,MAAM,kCAAkC,CAAC;AAW1C;;GAEG;AACH,eAAO,MAAM,QAAQ,i9FAAkE,CAAC;AAOxF,eAAO,MAAM,UAAU,unGAGtB,CAAC;AAEF,eAAO,MAAM,SAAS,wnGAGrB,CAAC;AAEF,eAAO,MAAM,UAAU,sEAAwB,CAAC"}

package/dist/domains/json/jsonDomainSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonDomainSchema.js","sourceRoot":"","sources":["../../../src/domains/json/jsonDomainSchema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AASH,+DAK0C;AAE1C,oDAAwC;AAExC,MAAM,OAAO,GAAG,IAAI,gCAAqB,CAAC;IACzC,KAAK,EAAE,yBAAyB;IAChC,SAAS,EAAE,CAAC,oBAAI,CAAC,OAAO,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,GAAG,oBAAI,CAAC,UAAU,EAAE,oBAAI,CAAC,IAAI,CAAU,CAAC;AAEhE;;GAEG;AACU,QAAA,QAAQ,GAAG,CAAC,GAAG,EAAE,CAAC,kBAAU,EAAE,GAAG,EAAE,CAAC,iBAAS,EAAE,GAAG,cAAc,CAAU,CAAC;AAExF;CAGC;AAEY,QAAA,UAAU,GAAG,OAAO,CAAC,YAAY,CAC7C,QAAQ,EACR,0BAAe,CAAC,YAAY,CAAC,qBAAU,CAAC,QAAQ,EAAE,gBAAQ,CAAC,CAC3D,CAAC;AAEW,QAAA,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAClD,OAAO,EACP,0BAAe,CAAC,YAAY,CAAC,qBAAU,CAAC,QAAQ,EAAE,gBAAQ,CAAC,CAC3D,CAAC;AAEW,QAAA,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n// Adding this unused import makes the generated d.ts file produced by TypeScript stop breaking API-Extractor's rollup generation.\n// Without this import, TypeScript generates inline `import(\"../..\")` statements in the d.ts file,\n// which API-Extractor leaves as is when generating the rollup, leaving them pointing at the wrong directory.\n// API-Extractor issue: https://github.com/microsoft/rushstack/issues/4507\n// eslint-disable-next-line @typescript-eslint/no-unused-vars, unused-imports/no-unused-imports\nimport { ValueSchema } from \"../../core/index.js\";\n\nimport {\n\tFlexAllowedTypes,\n\tFieldKinds,\n\tFlexFieldSchema,\n\tSchemaBuilderInternal,\n} from \"../../feature-libraries/index.js\";\nimport { requireAssignableTo } from \"../../util/index.js\";\nimport { leaf } from \"../leafDomain.js\";\n\nconst builder = new SchemaBuilderInternal({\n\tscope: \"com.fluidframework.json\",\n\tlibraries: [leaf.library],\n});\n\nconst jsonPrimitives = [...leaf.primitives, leaf.null] as const;\n\n/**\n * Types allowed as roots of Json content.\n */\nexport const jsonRoot = [() => jsonObject, () => jsonArray, ...jsonPrimitives] as const;\n\n{\n\t// Recursive objects don't get this type checking automatically, so confirm it\n\ttype _check = requireAssignableTo<typeof jsonRoot, FlexAllowedTypes>;\n}\n\nexport const jsonObject = builder.mapRecursive(\n\t\"object\",\n\tFlexFieldSchema.createUnsafe(FieldKinds.optional, jsonRoot),\n);\n\nexport const jsonArray = builder.fieldNodeRecursive(\n\t\"array\",\n\tFlexFieldSchema.createUnsafe(FieldKinds.sequence, jsonRoot),\n);\n\nexport const jsonSchema = builder.intoLibrary();\n"]}
+{"version":3,"file":"jsonDomainSchema.js","sourceRoot":"","sources":["../../../src/domains/json/jsonDomainSchema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAQH,+DAK0C;AAE1C,oDAAwC;AAExC,MAAM,OAAO,GAAG,IAAI,gCAAqB,CAAC;IACzC,KAAK,EAAE,yBAAyB;IAChC,SAAS,EAAE,CAAC,oBAAI,CAAC,OAAO,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,GAAG,oBAAI,CAAC,UAAU,EAAE,oBAAI,CAAC,IAAI,CAAU,CAAC;AAEhE;;GAEG;AACU,QAAA,QAAQ,GAAG,CAAC,GAAG,EAAE,CAAC,kBAAU,EAAE,GAAG,EAAE,CAAC,iBAAS,EAAE,GAAG,cAAc,CAAU,CAAC;AAExF;CAGC;AAEY,QAAA,UAAU,GAAG,OAAO,CAAC,YAAY,CAC7C,QAAQ,EACR,0BAAe,CAAC,YAAY,CAAC,qBAAU,CAAC,QAAQ,EAAE,gBAAQ,CAAC,CAC3D,CAAC;AAEW,QAAA,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAClD,OAAO,EACP,0BAAe,CAAC,YAAY,CAAC,qBAAU,CAAC,QAAQ,EAAE,gBAAQ,CAAC,CAC3D,CAAC;AAEW,QAAA,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n// Adding this unused import makes the generated d.ts file produced by TypeScript stop breaking API-Extractor's rollup generation.\n// Without this import, TypeScript generates inline `import(\"../..\")` statements in the d.ts file,\n// which API-Extractor leaves as is when generating the rollup, leaving them pointing at the wrong directory.\n// API-Extractor issue: https://github.com/microsoft/rushstack/issues/4507\n// eslint-disable-next-line @typescript-eslint/no-unused-vars, unused-imports/no-unused-imports\nimport { ValueSchema } from \"../../core/index.js\";\nimport {\n\tFieldKinds,\n\tFlexAllowedTypes,\n\tFlexFieldSchema,\n\tSchemaBuilderInternal,\n} from \"../../feature-libraries/index.js\";\nimport { requireAssignableTo } from \"../../util/index.js\";\nimport { leaf } from \"../leafDomain.js\";\n\nconst builder = new SchemaBuilderInternal({\n\tscope: \"com.fluidframework.json\",\n\tlibraries: [leaf.library],\n});\n\nconst jsonPrimitives = [...leaf.primitives, leaf.null] as const;\n\n/**\n * Types allowed as roots of Json content.\n */\nexport const jsonRoot = [() => jsonObject, () => jsonArray, ...jsonPrimitives] as const;\n\n{\n\t// Recursive objects don't get this type checking automatically, so confirm it\n\ttype _check = requireAssignableTo<typeof jsonRoot, FlexAllowedTypes>;\n}\n\nexport const jsonObject = builder.mapRecursive(\n\t\"object\",\n\tFlexFieldSchema.createUnsafe(FieldKinds.optional, jsonRoot),\n);\n\nexport const jsonArray = builder.fieldNodeRecursive(\n\t\"array\",\n\tFlexFieldSchema.createUnsafe(FieldKinds.sequence, jsonRoot),\n);\n\nexport const jsonSchema = builder.intoLibrary();\n"]}

package/dist/domains/leafDomain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"leafDomain.d.ts","sourceRoot":"","sources":["../../src/domains/leafDomain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAkB/C;;;GAGG;AACH,eAAO,MAAM,IAAI;IAChB;;;;;;;;;;;;;OAaG;;IAGH;;OAEG;;IAGH;;;;;;;;;;;;OAYG;;IAGH;;OAEG;;IAGH;;;;;;;OAOG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;;;OAKG;;CAEH,CAAC"}
+{"version":3,"file":"leafDomain.d.ts","sourceRoot":"","sources":["../../src/domains/leafDomain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAmB/C;;;GAGG;AACH,eAAO,MAAM,IAAI;IAChB;;;;;;;;;;;;;OAaG;;IAGH;;OAEG;;IAGH;;;;;;;;;;;;OAYG;;IAGH;;OAEG;;IAGH;;;;;;;OAOG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;;;OAKG;;CAEH,CAAC"}

package/dist/domains/leafDomain.js

@@ -5,17 +5,17 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.leaf = void 0;
-const index_js_1 = require("../feature-libraries/index.js");
-const index_js_2 = require("../core/index.js");
+const index_js_1 = require("../core/index.js");
+const index_js_2 = require("../feature-libraries/index.js");
 /**
  * Names in this domain follow https://en.wikipedia.org/wiki/Reverse_domain_name_notation
  */
-const builder = new index_js_1.SchemaBuilderInternal({ scope: "com.fluidframework.leaf" });
-const number = builder.leaf("number", index_js_2.ValueSchema.Number);
-const boolean = builder.leaf("boolean", index_js_2.ValueSchema.Boolean);
-const string = builder.leaf("string", index_js_2.ValueSchema.String);
-const handle = builder.leaf("handle", index_js_2.ValueSchema.FluidHandle);
-const nullSchema = builder.leaf("null", index_js_2.ValueSchema.Null);
+const builder = new index_js_2.SchemaBuilderInternal({ scope: "com.fluidframework.leaf" });
+const number = builder.leaf("number", index_js_1.ValueSchema.Number);
+const boolean = builder.leaf("boolean", index_js_1.ValueSchema.Boolean);
+const string = builder.leaf("string", index_js_1.ValueSchema.String);
+const handle = builder.leaf("handle", index_js_1.ValueSchema.FluidHandle);
+const nullSchema = builder.leaf("null", index_js_1.ValueSchema.Null);
 const primitives = [number, boolean, string];
 const all = [handle, nullSchema, ...primitives];
 const library = builder.intoLibrary();

package/dist/domains/leafDomain.js.map

@@ -1 +1 @@
-{"version":3,"file":"leafDomain.js","sourceRoot":"","sources":["../../src/domains/leafDomain.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,4DAAsE;AACtE,+CAA+C;AAE/C;;GAEG;AACH,MAAM,OAAO,GAAG,IAAI,gCAAqB,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,CAAC;AAEhF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAW,CAAC,MAAM,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAW,CAAC,OAAO,CAAC,CAAC;AAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAW,CAAC,MAAM,CAAC,CAAC;AAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAW,CAAC,WAAW,CAAC,CAAC;AAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,sBAAW,CAAC,IAAI,CAAC,CAAC;AAE1D,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AACtD,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAU,CAAC;AAEzD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;AAEtC;;;GAGG;AACU,QAAA,IAAI,GAAG;IACnB;;;;;;;;;;;;;OAaG;IACH,MAAM;IAEN;;OAEG;IACH,OAAO;IAEP;;;;;;;;;;;;OAYG;IACH,MAAM;IAEN;;OAEG;IACH,MAAM;IAEN;;;;;;;OAOG;IACH,IAAI,EAAE,UAAU;IAEhB;;OAEG;IACH,UAAU;IAEV;;OAEG;IACH,GAAG;IAEH;;;;;OAKG;IACH,OAAO;CACP,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { SchemaBuilderInternal } from \"../feature-libraries/index.js\";\nimport { ValueSchema } from \"../core/index.js\";\n\n/**\n * Names in this domain follow https://en.wikipedia.org/wiki/Reverse_domain_name_notation\n */\nconst builder = new SchemaBuilderInternal({ scope: \"com.fluidframework.leaf\" });\n\nconst number = builder.leaf(\"number\", ValueSchema.Number);\nconst boolean = builder.leaf(\"boolean\", ValueSchema.Boolean);\nconst string = builder.leaf(\"string\", ValueSchema.String);\nconst handle = builder.leaf(\"handle\", ValueSchema.FluidHandle);\nconst nullSchema = builder.leaf(\"null\", ValueSchema.Null);\n\nconst primitives = [number, boolean, string] as const;\nconst all = [handle, nullSchema, ...primitives] as const;\n\nconst library = builder.intoLibrary();\n\n/**\n * Built-in {@link LeafNodeSchema}.\n * @internal\n */\nexport const leaf = {\n\t/**\n\t * {@link LeafNodeSchema} for holding a JavaScript `number`.\n\t *\n\t * @remarks\n\t * The number is a [double-precision 64-bit binary format IEEE 754](https://en.wikipedia.org/wiki/Double-precision_floating-point_format) value, however there are some exceptions:\n\t * - `NaN`, and the infinities should not be used.\n\t * - `-0` may be converted to `0` in some cases.\n\t *\n\t * These limitations match the limitations of JSON.\n\t * @privateRemarks\n\t * TODO:\n\t * We should be much more clear about what happens if you use problematic values.\n\t * We should validate and/or normalize them when inserting content.\n\t */\n\tnumber,\n\n\t/**\n\t * {@link LeafNodeSchema} for holding a boolean.\n\t */\n\tboolean,\n\n\t/**\n\t * {@link LeafNodeSchema} for holding a JavaScript `string`.\n\t *\n\t * @remarks\n\t * Strings containing unpaired UTF-16 surrogate pair code units may not be handled correctly.\n\t *\n\t * These limitations come from the use of UTF-8 encoding of the strings, which requires them to be valid unicode.\n\t * JavaScript does not make this requirement for its strings so not all possible JavaScript strings are supported.\n\t * @privateRemarks\n\t * TODO:\n\t * We should be much more clear about what happens if you use problematic values.\n\t * We should validate and/or normalize them when inserting content.\n\t */\n\tstring,\n\n\t/**\n\t * {@link LeafNodeSchema} for holding an {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}.\n\t */\n\thandle,\n\n\t/**\n\t * {@link LeafNodeSchema} for JavaScript `null`.\n\t *\n\t * @remarks\n\t * There are good [reasons to avoid using null](https://www.npmjs.com/package/%40rushstack/eslint-plugin#rushstackno-new-null) in JavaScript, however sometimes it is desired.\n\t * This {@link LeafNodeSchema} node provides the option to include nulls in trees when desired.\n\t * Unless directly inter-operating with existing data using null, consider other approaches, like wrapping the value in an optional field, or using a more specifically named empty object node.\n\t */\n\tnull: nullSchema,\n\n\t/**\n\t * The set of {@link LeafNodeSchema} which correspond to JavaScript primitive (non-object) types.\n\t */\n\tprimitives,\n\n\t/**\n\t * All {@link LeafNodeSchema} defined in this library..\n\t */\n\tall,\n\n\t/**\n\t * {@link SchemaLibrary} of the {@link LeafNodeSchema}.\n\t *\n\t * @privateRemarks\n\t * This is included by default in schema produced with {@link SchemaBuilder}.\n\t */\n\tlibrary,\n};\n"]}
+{"version":3,"file":"leafDomain.js","sourceRoot":"","sources":["../../src/domains/leafDomain.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+CAA+C;AAC/C,4DAAsE;AAEtE;;GAEG;AACH,MAAM,OAAO,GAAG,IAAI,gCAAqB,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,CAAC;AAEhF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAW,CAAC,MAAM,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAW,CAAC,OAAO,CAAC,CAAC;AAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAW,CAAC,MAAM,CAAC,CAAC;AAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAW,CAAC,WAAW,CAAC,CAAC;AAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,sBAAW,CAAC,IAAI,CAAC,CAAC;AAE1D,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AACtD,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAU,CAAC;AAEzD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;AAEtC;;;GAGG;AACU,QAAA,IAAI,GAAG;IACnB;;;;;;;;;;;;;OAaG;IACH,MAAM;IAEN;;OAEG;IACH,OAAO;IAEP;;;;;;;;;;;;OAYG;IACH,MAAM;IAEN;;OAEG;IACH,MAAM;IAEN;;;;;;;OAOG;IACH,IAAI,EAAE,UAAU;IAEhB;;OAEG;IACH,UAAU;IAEV;;OAEG;IACH,GAAG;IAEH;;;;;OAKG;IACH,OAAO;CACP,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { ValueSchema } from \"../core/index.js\";\nimport { SchemaBuilderInternal } from \"../feature-libraries/index.js\";\n\n/**\n * Names in this domain follow https://en.wikipedia.org/wiki/Reverse_domain_name_notation\n */\nconst builder = new SchemaBuilderInternal({ scope: \"com.fluidframework.leaf\" });\n\nconst number = builder.leaf(\"number\", ValueSchema.Number);\nconst boolean = builder.leaf(\"boolean\", ValueSchema.Boolean);\nconst string = builder.leaf(\"string\", ValueSchema.String);\nconst handle = builder.leaf(\"handle\", ValueSchema.FluidHandle);\nconst nullSchema = builder.leaf(\"null\", ValueSchema.Null);\n\nconst primitives = [number, boolean, string] as const;\nconst all = [handle, nullSchema, ...primitives] as const;\n\nconst library = builder.intoLibrary();\n\n/**\n * Built-in {@link LeafNodeSchema}.\n * @internal\n */\nexport const leaf = {\n\t/**\n\t * {@link LeafNodeSchema} for holding a JavaScript `number`.\n\t *\n\t * @remarks\n\t * The number is a [double-precision 64-bit binary format IEEE 754](https://en.wikipedia.org/wiki/Double-precision_floating-point_format) value, however there are some exceptions:\n\t * - `NaN`, and the infinities should not be used.\n\t * - `-0` may be converted to `0` in some cases.\n\t *\n\t * These limitations match the limitations of JSON.\n\t * @privateRemarks\n\t * TODO:\n\t * We should be much more clear about what happens if you use problematic values.\n\t * We should validate and/or normalize them when inserting content.\n\t */\n\tnumber,\n\n\t/**\n\t * {@link LeafNodeSchema} for holding a boolean.\n\t */\n\tboolean,\n\n\t/**\n\t * {@link LeafNodeSchema} for holding a JavaScript `string`.\n\t *\n\t * @remarks\n\t * Strings containing unpaired UTF-16 surrogate pair code units may not be handled correctly.\n\t *\n\t * These limitations come from the use of UTF-8 encoding of the strings, which requires them to be valid unicode.\n\t * JavaScript does not make this requirement for its strings so not all possible JavaScript strings are supported.\n\t * @privateRemarks\n\t * TODO:\n\t * We should be much more clear about what happens if you use problematic values.\n\t * We should validate and/or normalize them when inserting content.\n\t */\n\tstring,\n\n\t/**\n\t * {@link LeafNodeSchema} for holding an {@link @fluidframework/core-interfaces#(IFluidHandle:interface)}.\n\t */\n\thandle,\n\n\t/**\n\t * {@link LeafNodeSchema} for JavaScript `null`.\n\t *\n\t * @remarks\n\t * There are good [reasons to avoid using null](https://www.npmjs.com/package/%40rushstack/eslint-plugin#rushstackno-new-null) in JavaScript, however sometimes it is desired.\n\t * This {@link LeafNodeSchema} node provides the option to include nulls in trees when desired.\n\t * Unless directly inter-operating with existing data using null, consider other approaches, like wrapping the value in an optional field, or using a more specifically named empty object node.\n\t */\n\tnull: nullSchema,\n\n\t/**\n\t * The set of {@link LeafNodeSchema} which correspond to JavaScript primitive (non-object) types.\n\t */\n\tprimitives,\n\n\t/**\n\t * All {@link LeafNodeSchema} defined in this library..\n\t */\n\tall,\n\n\t/**\n\t * {@link SchemaLibrary} of the {@link LeafNodeSchema}.\n\t *\n\t * @privateRemarks\n\t * This is included by default in schema produced with {@link SchemaBuilder}.\n\t */\n\tlibrary,\n};\n"]}

package/dist/domains/nodeKey/nodeKeySchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodeKeySchema.d.ts","sourceRoot":"","sources":["../../../src/domains/nodeKey/nodeKeySchema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAKN,eAAe,EACf,MAAM,kCAAkC,CAAC;AAI1C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,qHAA8C,CAAC;AAG7E;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;CAExB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,sEAAwB,CAAC"}
+{"version":3,"file":"nodeKeySchema.d.ts","sourceRoot":"","sources":["../../../src/domains/nodeKey/nodeKeySchema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAEN,eAAe,EAIf,MAAM,kCAAkC,CAAC;AAI1C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,qHAA8C,CAAC;AAG7E;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;CAExB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,sEAAwB,CAAC"}

package/dist/domains/nodeKey/nodeKeySchema.js

@@ -5,7 +5,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.nodeKeySchema = exports.nodeKeyField = exports.nodeKeyTreeSchema = void 0;
-const core_utils_1 = require("@fluidframework/core-utils");
+const internal_1 = require("@fluidframework/core-utils/internal");
 const index_js_1 = require("../../core/index.js");
 const index_js_2 = require("../../feature-libraries/index.js");
 const builder = new index_js_2.SchemaBuilderInternal({ scope: "com.fluidframework.nodeKey" });
@@ -17,7 +17,7 @@ const builder = new index_js_2.SchemaBuilderInternal({ scope: "com.fluidframewor
  * This might need to be changed to be a node holding a string node instead.
  */
 exports.nodeKeyTreeSchema = builder.leaf("NodeKey", index_js_1.ValueSchema.String);
-(0, core_utils_1.assert)(exports.nodeKeyTreeSchema.name === index_js_2.nodeKeyTreeIdentifier, 0x7ae /* mismatched identifiers */);
+(0, internal_1.assert)(exports.nodeKeyTreeSchema.name === index_js_2.nodeKeyTreeIdentifier, 0x7ae /* mismatched identifiers */);
 /**
  * Key and Field schema for working with {@link LocalNodeKey}s in a shared tree.
  * Node keys are added to object nodes via a field.

package/dist/domains/nodeKey/nodeKeySchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodeKeySchema.js","sourceRoot":"","sources":["../../../src/domains/nodeKey/nodeKeySchema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2DAAoD;AACpD,kDAAkD;AAClD,+DAM0C;AAE1C,MAAM,OAAO,GAAG,IAAI,gCAAqB,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;AAEnF;;;;;;GAMG;AACU,QAAA,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAW,CAAC,MAAM,CAAC,CAAC;AAC7E,IAAA,mBAAM,EAAC,yBAAiB,CAAC,IAAI,KAAK,gCAAqB,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAC;AAE7F;;;;;;GAMG;AACU,QAAA,YAAY,GAAG;IAC3B,CAAC,0BAAe,CAAC,EAAE,0BAAe,CAAC,MAAM,CAAC,qBAAU,CAAC,OAAO,EAAE,CAAC,yBAAiB,CAAC,CAAC;CAClF,CAAC;AAEF;;;GAGG;AACU,QAAA,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC","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\";\nimport { ValueSchema } from \"../../core/index.js\";\nimport {\n\tnodeKeyFieldKey,\n\tFieldKinds,\n\tnodeKeyTreeIdentifier,\n\tSchemaBuilderInternal,\n\tFlexFieldSchema,\n} from \"../../feature-libraries/index.js\";\n\nconst builder = new SchemaBuilderInternal({ scope: \"com.fluidframework.nodeKey\" });\n\n/**\n * Schema for a node which holds a {@link StableNodeKey}.\n *\n * @privateRemarks\n * This being a leaf may cause issues with leaf unboxing plans.\n * This might need to be changed to be a node holding a string node instead.\n */\nexport const nodeKeyTreeSchema = builder.leaf(\"NodeKey\", ValueSchema.String);\nassert(nodeKeyTreeSchema.name === nodeKeyTreeIdentifier, 0x7ae /* mismatched identifiers */);\n\n/**\n * Key and Field schema for working with {@link LocalNodeKey}s in a shared tree.\n * Node keys are added to object nodes via a field.\n * This object can be expanded into a schema to add the field.\n *\n * Requires including {@link nodeKeySchema}.\n */\nexport const nodeKeyField = {\n\t[nodeKeyFieldKey]: FlexFieldSchema.create(FieldKinds.nodeKey, [nodeKeyTreeSchema]),\n};\n\n/**\n * The schema library for working with {@link StableNodeKey}s in a tree.\n * Required to use {@link nodeKeyField}.\n */\nexport const nodeKeySchema = builder.intoLibrary();\n"]}
+{"version":3,"file":"nodeKeySchema.js","sourceRoot":"","sources":["../../../src/domains/nodeKey/nodeKeySchema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,kEAA6D;AAE7D,kDAAkD;AAClD,+DAM0C;AAE1C,MAAM,OAAO,GAAG,IAAI,gCAAqB,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;AAEnF;;;;;;GAMG;AACU,QAAA,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAW,CAAC,MAAM,CAAC,CAAC;AAC7E,IAAA,iBAAM,EAAC,yBAAiB,CAAC,IAAI,KAAK,gCAAqB,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAC;AAE7F;;;;;;GAMG;AACU,QAAA,YAAY,GAAG;IAC3B,CAAC,0BAAe,CAAC,EAAE,0BAAe,CAAC,MAAM,CAAC,qBAAU,CAAC,OAAO,EAAE,CAAC,yBAAiB,CAAC,CAAC;CAClF,CAAC;AAEF;;;GAGG;AACU,QAAA,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC","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\";\n\nimport { ValueSchema } from \"../../core/index.js\";\nimport {\n\tFieldKinds,\n\tFlexFieldSchema,\n\tSchemaBuilderInternal,\n\tnodeKeyFieldKey,\n\tnodeKeyTreeIdentifier,\n} from \"../../feature-libraries/index.js\";\n\nconst builder = new SchemaBuilderInternal({ scope: \"com.fluidframework.nodeKey\" });\n\n/**\n * Schema for a node which holds a {@link StableNodeKey}.\n *\n * @privateRemarks\n * This being a leaf may cause issues with leaf unboxing plans.\n * This might need to be changed to be a node holding a string node instead.\n */\nexport const nodeKeyTreeSchema = builder.leaf(\"NodeKey\", ValueSchema.String);\nassert(nodeKeyTreeSchema.name === nodeKeyTreeIdentifier, 0x7ae /* mismatched identifiers */);\n\n/**\n * Key and Field schema for working with {@link LocalNodeKey}s in a shared tree.\n * Node keys are added to object nodes via a field.\n * This object can be expanded into a schema to add the field.\n *\n * Requires including {@link nodeKeySchema}.\n */\nexport const nodeKeyField = {\n\t[nodeKeyFieldKey]: FlexFieldSchema.create(FieldKinds.nodeKey, [nodeKeyTreeSchema]),\n};\n\n/**\n * The schema library for working with {@link StableNodeKey}s in a tree.\n * Required to use {@link nodeKeyField}.\n */\nexport const nodeKeySchema = builder.intoLibrary();\n"]}

package/dist/domains/schemaBuilder.d.ts

@@ -2,7 +2,7 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-import { Any, FieldKinds, FlexFieldSchema, FlexImplicitAllowedTypes, NormalizeAllowedTypes, NormalizeField, SchemaBuilderOptions, FlexTreeNodeSchema, FlexMapFieldSchema, SchemaBuilderBase, FlexImplicitFieldSchema, FlexObjectNodeSchema, Unenforced, FlexAllowedTypes, FlexFieldNodeSchema, FlexMapNodeSchema } from "../feature-libraries/index.js";
+import { FieldKinds, FlexFieldNodeSchema, FlexFieldSchema, FlexImplicitAllowedTypes, FlexImplicitFieldSchema, FlexObjectNodeSchema, NormalizeAllowedTypes, SchemaBuilderBase, SchemaBuilderOptions, Unenforced } from "../feature-libraries/index.js";
 import { RestrictiveReadonlyRecord } from "../util/index.js";
 /**
  * Builds schema libraries, and the schema within them.
@@ -27,64 +27,18 @@ import { RestrictiveReadonlyRecord } from "../util/index.js";
  * @deprecated Users of this class should either use {@link SchemaBuilderBase} and explicitly work with {@link FlexFieldSchema}, or use SchemaFactory and work at its higher level of abstraction.
  */
 export declare class SchemaBuilder<TScope extends string = string, TName extends string | number = string> extends SchemaBuilderBase<TScope, typeof FieldKinds.required, TName> {
-    private readonly structuralTypes;
     constructor(options: SchemaBuilderOptions<TScope>);
     objectRecursive<const Name extends TName, const T extends Unenforced<RestrictiveReadonlyRecord<string, FlexImplicitFieldSchema>>>(name: Name, t: T): FlexObjectNodeSchema<`${TScope}.${Name}`, T>;
     /**
-     * Define (and add to this library if not already present) a structurally typed {@link FlexFieldNodeSchema} for a {@link (TreeListNode:interface)}.
-     *
-     * @remarks
-     * The {@link TreeNodeSchemaIdentifier} for this List is defined as a function of the provided types.
-     * It is still scoped to this SchemaBuilder, but multiple calls with the same arguments will return the same schema object, providing somewhat structural typing.
-     * This does not support recursive types.
-     *
-     * If using these structurally named lists, other types in this schema builder should avoid names of the form `List<${string}>`.
-     *
-     * @privateRemarks
-     * The name produced at the type level here is not as specific as it could be, however doing type level sorting and escaping is a real mess.
-     * There are cases where not having this full type provided will be less than ideal since TypeScript's structural types.
-     * For example attempts to narrow unions of structural lists by name won't work.
-     * Planned future changes to move to a class based schema system as well as factor function based node construction should mostly avoid these issues,
-     * though there may still be some problematic cases even after that work is done.
-     */
-    list<const T extends FlexTreeNodeSchema | Any | readonly FlexTreeNodeSchema[]>(allowedTypes: T): FlexFieldNodeSchema<`${TScope}.List<${string}>`, FlexFieldSchema<typeof FieldKinds.sequence, NormalizeAllowedTypes<T>>>;
-    /**
-     * Define (and add to this library) a {@link FlexFieldNodeSchema} for a {@link (TreeListNode:interface)}.
+     * Define (and add to this library) a {@link FlexFieldNodeSchema} for a {@link Sequence}.
      *
      * The name must be unique among all TreeNodeSchema in the the document schema.
      */
     list<Name extends TName, const T extends FlexImplicitAllowedTypes>(name: Name, allowedTypes: T): FlexFieldNodeSchema<`${TScope}.${Name}`, FlexFieldSchema<typeof FieldKinds.sequence, NormalizeAllowedTypes<T>>>;
-    /**
-     * Define (and add to this library) a {@link FlexFieldNodeSchema} for a {@link (TreeListNode:interface)}.
-     *
-     * The name must be unique among all TreeNodeSchema in the the document schema.
-     *
-     * @privateRemarks
-     * TODO: If A custom "List" API is added as a subtype of {@link FieldNode}, this would opt into that.
-     */
-    private namedList;
-    /**
-     * Define (and add to this library if not already present) a structurally typed {@link FlexMapNodeSchema} for a {@link TreeMapNode}.
-     *
-     * @remarks
-     * The {@link TreeNodeSchemaIdentifier} for this Map is defined as a function of the provided types.
-     * It is still scoped to this SchemaBuilder, but multiple calls with the same arguments will return the same schema object, providing somewhat structural typing.
-     * This does not support recursive types.
-     *
-     * If using these structurally named maps, other types in this schema builder should avoid names of the form `Map<${string}>`.
-     *
-     * @privateRemarks
-     * See note on list.
-     */
-    map<const T extends FlexTreeNodeSchema | Any | readonly FlexTreeNodeSchema[]>(allowedTypes: T): FlexMapNodeSchema<`${TScope}.Map<${string}>`, NormalizeField<T, typeof FieldKinds.optional>>;
-    /**
-     * Define (and add to this library) a {@link FlexMapNodeSchema} for a {@link TreeMapNode}.
-     */
-    map<Name extends TName, const T extends FlexMapFieldSchema | FlexImplicitAllowedTypes>(name: Name, fieldSchema: T): FlexMapNodeSchema<`${TScope}.${Name}`, NormalizeField<T, typeof FieldKinds.optional>>;
     /**
      * Define a schema for an {@link FieldKinds.optional|optional field}.
      * @remarks
-     * Shorthand or passing `FieldKinds.optional` to {@link FlexFieldSchema.create}.
+     * Shorthand for passing `FieldKinds.optional` to {@link FlexFieldSchema.create}.
      *
      * This method is also available as an instance method on {@link SchemaBuilder}.
      */
@@ -92,7 +46,7 @@ export declare class SchemaBuilder<TScope extends string = string, TName extends
     /**
      * Define a schema for an {@link FieldKinds.optional|optional field}.
      * @remarks
-     * Shorthand or passing `FieldKinds.optional` to {@link FlexFieldSchema.create}.
+     * Shorthand for passing `FieldKinds.optional` to {@link FlexFieldSchema.create}.
      *
      * Since this creates a {@link FlexFieldSchema} (and not a {@link FlexTreeNodeSchema}), the resulting schema is structurally typed, and not impacted by the {@link SchemaBuilderBase.scope}:
      * therefore this method is the same as the static version.
@@ -101,7 +55,7 @@ export declare class SchemaBuilder<TScope extends string = string, TName extends
     /**
      * Define a schema for a {@link FieldKinds.required|required field}.
      * @remarks
-     * Shorthand or passing `FieldKinds.required` to {@link FlexFieldSchema.create}.
+     * Shorthand for passing `FieldKinds.required` to {@link FlexFieldSchema.create}.
      *
      * This method is also available as an instance method on {@link SchemaBuilder}.
      */
@@ -109,7 +63,7 @@ export declare class SchemaBuilder<TScope extends string = string, TName extends
     /**
      * Define a schema for a {@link FieldKinds.required|required field}.
      * @remarks
-     * Shorthand or passing `FieldKinds.required` to {@link FlexFieldSchema.create}.
+     * Shorthand for passing `FieldKinds.required` to {@link FlexFieldSchema.create}.
      * Note that `FieldKinds.required` is the current default field kind, so APIs accepting {@link FlexImplicitFieldSchema}
      * can be passed the `allowedTypes` and will implicitly wrap it up in a {@link FieldKinds.required|required field}.
      *
@@ -120,7 +74,7 @@ export declare class SchemaBuilder<TScope extends string = string, TName extends
     /**
      * Define a schema for a {@link FieldKinds.sequence|sequence field}.
      * @remarks
-     * Shorthand or passing `FieldKinds.sequence` to {@link FlexFieldSchema.create}.
+     * Shorthand for passing `FieldKinds.sequence` to {@link FlexFieldSchema.create}.
      *
      * This method is also available as an instance method on {@link SchemaBuilder}
      */
@@ -128,44 +82,28 @@ export declare class SchemaBuilder<TScope extends string = string, TName extends
     /**
      * Define a schema for a {@link FieldKinds.sequence|sequence field}.
      * @remarks
-     * Shorthand or passing `FieldKinds.sequence` to {@link FlexFieldSchema.create}.
+     * Shorthand for passing `FieldKinds.sequence` to {@link FlexFieldSchema.create}.
      *
      * Since this creates a {@link FlexFieldSchema} (and not a {@link FlexTreeNodeSchema}), the resulting schema is structurally typed, and not impacted by the {@link SchemaBuilderBase.scope}:
      * therefore this method is the same as the static version.
      */
     readonly sequence: <const T extends FlexImplicitAllowedTypes>(allowedTypes: T) => FlexFieldSchema<import("../feature-libraries/index.js").Sequence, NormalizeAllowedTypes<T>>;
     /**
-     * {@link leaf.number}
-     */
-    readonly number: import("../feature-libraries/index.js").LeafNodeSchema<"com.fluidframework.leaf.number", import("../index.js").ValueSchema.Number>;
-    /**
-     * {@link leaf.boolean}
-     */
-    readonly boolean: import("../feature-libraries/index.js").LeafNodeSchema<"com.fluidframework.leaf.boolean", import("../index.js").ValueSchema.Boolean>;
-    /**
-     * {@link leaf.string}
-     */
-    readonly string: import("../feature-libraries/index.js").LeafNodeSchema<"com.fluidframework.leaf.string", import("../index.js").ValueSchema.String>;
-    /**
-     * {@link leaf.handle}
-     */
-    readonly handle: import("../feature-libraries/index.js").LeafNodeSchema<"com.fluidframework.leaf.handle", import("../index.js").ValueSchema.FluidHandle>;
-    /**
-     * {@link leaf.null}
+     * Define a schema for an {@link FieldKinds.identifier|identifier field}.
+     * @remarks
+     * Shorthand for passing `FieldKinds.identifier` to {@link TreeFieldSchema.create}.
+     *
+     * This method is also available as an instance method on {@link SchemaBuilder}
      */
-    readonly null: import("../feature-libraries/index.js").LeafNodeSchema<"com.fluidframework.leaf.null", import("../index.js").ValueSchema.Null>;
+    static identifier: <const T extends FlexImplicitAllowedTypes>(allowedTypes: T) => FlexFieldSchema<import("../feature-libraries/index.js").Identifier, NormalizeAllowedTypes<T>>;
     /**
-     * Function which can be used for its compile time side-effects to tweak the evaluation order of recursive types to make them compile.
+     * Define a schema for a {@link FieldKinds.identifier|identifier field}.
      * @remarks
-     * Some related information in https://github.com/microsoft/TypeScript/issues/55758.
+     * Shorthand for passing `FieldKinds.identifier` to {@link TreeFieldSchema.create}.
      *
-     * Also be aware that code which relies on this (or the "recursive" SchemaBuilder methods tends to break VSCode's IntelliSense every time anything related to that code (even comments) is edited.
-     * The command `TypeScript: Restart TS Server` should fix it.
-     * Sometimes this does not work: the exact cause has not been confirmed but if you have the file open multiple times (for example in both sides of a window split into two columns): closing the extra copy may help.
-     * Focusing the file with the errors before running `TypeScript: Restart TS Server` can also help.
-     * Real compile errors (for example elsewhere in the file) can also cause the IntelliSense to not work correctly ever after `TypeScript: Restart TS Server`.
+     * Since this creates a {@link TreeFieldSchema} (and not a {@link FlexTreeNodeSchema}), the resulting schema is structurally typed, and not impacted by the {@link SchemaBuilderBase.scope}:
+     * therefore this method is the same as the static version.
      */
-    fixRecursiveReference<T extends FlexAllowedTypes>(...types: T): void;
+    readonly identifier: <const T extends FlexImplicitAllowedTypes>(allowedTypes: T) => FlexFieldSchema<import("../feature-libraries/index.js").Identifier, NormalizeAllowedTypes<T>>;
 }
-export declare function structuralName<const T extends string>(collectionName: T, allowedTypes: FlexTreeNodeSchema | Any | readonly FlexTreeNodeSchema[]): `${T}<${string}>`;
 //# sourceMappingURL=schemaBuilder.d.ts.map

package/dist/domains/schemaBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemaBuilder.d.ts","sourceRoot":"","sources":["../../src/domains/schemaBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemaBuilder.d.ts","sourceRoot":"","sources":["../../src/domains/schemaBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,UAAU,EAEV,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa,CACzB,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,KAAK,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CACrC,SAAQ,iBAAiB,CAAC,MAAM,EAAE,OAAO,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC;gBAClD,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC;IAOxC,eAAe,CAC9B,KAAK,CAAC,IAAI,SAAS,KAAK,EACxB,KAAK,CAAC,CAAC,SAAS,UAAU,CAAC,yBAAyB,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,EACrF,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAOlB;;;;OAIG;IACI,IAAI,CAAC,IAAI,SAAS,KAAK,EAAE,KAAK,CAAC,CAAC,SAAS,wBAAwB,EACvE,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,CAAC,GACb,mBAAmB,CACrB,GAAG,MAAM,IAAI,IAAI,EAAE,EACnB,eAAe,CAAC,OAAO,UAAU,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,CACrE;IAUD;;;;;;OAMG;IACH,OAAc,QAAQ,6JAAoC;IAE1D;;;;;;;OAOG;IACH,SAAgB,QAAQ,6JAA0B;IAElD;;;;;;OAMG;IACH,OAAc,QAAQ,6JAAoC;IAE1D;;;;;;;;;OASG;IACH,SAAgB,QAAQ,6JAA0B;IAElD;;;;;;OAMG;IACH,OAAc,QAAQ,6JAAoC;IAE1D;;;;;;;OAOG;IACH,SAAgB,QAAQ,6JAA0B;IAElD;;;;;;OAMG;IACH,OAAc,UAAU,+JAAsC;IAE9D;;;;;;;OAOG;IACH,SAAgB,UAAU,+JAA4B;CACtD"}

package/dist/domains/schemaBuilder.js

@@ -4,10 +4,8 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.structuralName = exports.SchemaBuilder = void 0;
-const core_utils_1 = require("@fluidframework/core-utils");
+exports.SchemaBuilder = void 0;
 const index_js_1 = require("../feature-libraries/index.js");
-const index_js_2 = require("../util/index.js");
 const leafDomain_js_1 = require("./leafDomain.js");
 /**
  * Builds schema libraries, and the schema within them.
@@ -37,11 +35,10 @@ class SchemaBuilder extends index_js_1.SchemaBuilderBase {
             ...options,
             libraries: [...(options.libraries ?? []), leafDomain_js_1.leaf.library],
         });
-        this.structuralTypes = new Map();
         /**
          * Define a schema for an {@link FieldKinds.optional|optional field}.
          * @remarks
-         * Shorthand or passing `FieldKinds.optional` to {@link FlexFieldSchema.create}.
+         * Shorthand for passing `FieldKinds.optional` to {@link FlexFieldSchema.create}.
          *
          * Since this creates a {@link FlexFieldSchema} (and not a {@link FlexTreeNodeSchema}), the resulting schema is structurally typed, and not impacted by the {@link SchemaBuilderBase.scope}:
          * therefore this method is the same as the static version.
@@ -50,7 +47,7 @@ class SchemaBuilder extends index_js_1.SchemaBuilderBase {
         /**
          * Define a schema for a {@link FieldKinds.required|required field}.
          * @remarks
-         * Shorthand or passing `FieldKinds.required` to {@link FlexFieldSchema.create}.
+         * Shorthand for passing `FieldKinds.required` to {@link FlexFieldSchema.create}.
          * Note that `FieldKinds.required` is the current default field kind, so APIs accepting {@link FlexImplicitFieldSchema}
          * can be passed the `allowedTypes` and will implicitly wrap it up in a {@link FieldKinds.required|required field}.
          *
@@ -61,83 +58,41 @@ class SchemaBuilder extends index_js_1.SchemaBuilderBase {
         /**
          * Define a schema for a {@link FieldKinds.sequence|sequence field}.
          * @remarks
-         * Shorthand or passing `FieldKinds.sequence` to {@link FlexFieldSchema.create}.
+         * Shorthand for passing `FieldKinds.sequence` to {@link FlexFieldSchema.create}.
          *
          * Since this creates a {@link FlexFieldSchema} (and not a {@link FlexTreeNodeSchema}), the resulting schema is structurally typed, and not impacted by the {@link SchemaBuilderBase.scope}:
          * therefore this method is the same as the static version.
          */
         this.sequence = SchemaBuilder.sequence;
         /**
-         * {@link leaf.number}
-         */
-        this.number = leafDomain_js_1.leaf.number;
-        /**
-         * {@link leaf.boolean}
-         */
-        this.boolean = leafDomain_js_1.leaf.boolean;
-        /**
-         * {@link leaf.string}
-         */
-        this.string = leafDomain_js_1.leaf.string;
-        /**
-         * {@link leaf.handle}
-         */
-        this.handle = leafDomain_js_1.leaf.handle;
-        /**
-         * {@link leaf.null}
+         * Define a schema for a {@link FieldKinds.identifier|identifier field}.
+         * @remarks
+         * Shorthand for passing `FieldKinds.identifier` to {@link TreeFieldSchema.create}.
+         *
+         * Since this creates a {@link TreeFieldSchema} (and not a {@link FlexTreeNodeSchema}), the resulting schema is structurally typed, and not impacted by the {@link SchemaBuilderBase.scope}:
+         * therefore this method is the same as the static version.
          */
-        this.null = leafDomain_js_1.leaf.null;
+        this.identifier = SchemaBuilder.identifier;
     }
     objectRecursive(name, t) {
         return this.object(name, t);
     }
-    list(nameOrAllowedTypes, allowedTypes) {
-        if (allowedTypes === undefined) {
-            const types = nameOrAllowedTypes;
-            const fullName = structuralName("List", types);
-            return (0, index_js_2.getOrCreate)(this.structuralTypes, fullName, () => this.namedList(fullName, nameOrAllowedTypes));
-        }
-        return this.namedList(nameOrAllowedTypes, allowedTypes);
-    }
     /**
-     * Define (and add to this library) a {@link FlexFieldNodeSchema} for a {@link (TreeListNode:interface)}.
+     * Define (and add to this library) a {@link FlexFieldNodeSchema} for a {@link Sequence}.
      *
      * The name must be unique among all TreeNodeSchema in the the document schema.
-     *
-     * @privateRemarks
-     * TODO: If A custom "List" API is added as a subtype of {@link FieldNode}, this would opt into that.
      */
-    namedList(name, allowedTypes) {
+    list(name, allowedTypes) {
         const schema = index_js_1.FlexFieldNodeSchema.create(this, this.scoped(name), this.sequence(allowedTypes));
         this.addNodeSchema(schema);
         return schema;
     }
-    map(nameOrAllowedTypes, allowedTypes) {
-        if (allowedTypes === undefined) {
-            const types = nameOrAllowedTypes;
-            const fullName = structuralName("Map", types);
-            return (0, index_js_2.getOrCreate)(this.structuralTypes, fullName, () => super.map(fullName, (0, index_js_1.normalizeField)(nameOrAllowedTypes, index_js_1.FieldKinds.optional)));
-        }
-        return super.map(nameOrAllowedTypes, (0, index_js_1.normalizeField)(allowedTypes, index_js_1.FieldKinds.optional));
-    }
-    /**
-     * Function which can be used for its compile time side-effects to tweak the evaluation order of recursive types to make them compile.
-     * @remarks
-     * Some related information in https://github.com/microsoft/TypeScript/issues/55758.
-     *
-     * Also be aware that code which relies on this (or the "recursive" SchemaBuilder methods tends to break VSCode's IntelliSense every time anything related to that code (even comments) is edited.
-     * The command `TypeScript: Restart TS Server` should fix it.
-     * Sometimes this does not work: the exact cause has not been confirmed but if you have the file open multiple times (for example in both sides of a window split into two columns): closing the extra copy may help.
-     * Focusing the file with the errors before running `TypeScript: Restart TS Server` can also help.
-     * Real compile errors (for example elsewhere in the file) can also cause the IntelliSense to not work correctly ever after `TypeScript: Restart TS Server`.
-     */
-    fixRecursiveReference(...types) { }
 }
 exports.SchemaBuilder = SchemaBuilder;
 /**
  * Define a schema for an {@link FieldKinds.optional|optional field}.
  * @remarks
- * Shorthand or passing `FieldKinds.optional` to {@link FlexFieldSchema.create}.
+ * Shorthand for passing `FieldKinds.optional` to {@link FlexFieldSchema.create}.
  *
  * This method is also available as an instance method on {@link SchemaBuilder}.
  */
@@ -145,7 +100,7 @@ SchemaBuilder.optional = fieldHelper(index_js_1.FieldKinds.optional);
 /**
  * Define a schema for a {@link FieldKinds.required|required field}.
  * @remarks
- * Shorthand or passing `FieldKinds.required` to {@link FlexFieldSchema.create}.
+ * Shorthand for passing `FieldKinds.required` to {@link FlexFieldSchema.create}.
  *
  * This method is also available as an instance method on {@link SchemaBuilder}.
  */
@@ -153,47 +108,23 @@ SchemaBuilder.required = fieldHelper(index_js_1.FieldKinds.required);
 /**
  * Define a schema for a {@link FieldKinds.sequence|sequence field}.
  * @remarks
- * Shorthand or passing `FieldKinds.sequence` to {@link FlexFieldSchema.create}.
+ * Shorthand for passing `FieldKinds.sequence` to {@link FlexFieldSchema.create}.
  *
  * This method is also available as an instance method on {@link SchemaBuilder}
  */
 SchemaBuilder.sequence = fieldHelper(index_js_1.FieldKinds.sequence);
+/**
+ * Define a schema for an {@link FieldKinds.identifier|identifier field}.
+ * @remarks
+ * Shorthand for passing `FieldKinds.identifier` to {@link TreeFieldSchema.create}.
+ *
+ * This method is also available as an instance method on {@link SchemaBuilder}
+ */
+SchemaBuilder.identifier = fieldHelper(index_js_1.FieldKinds.identifier);
 /**
  * Returns a wrapper around SchemaBuilder.field for a specific FieldKind.
  */
 function fieldHelper(kind) {
     return (allowedTypes) => SchemaBuilder.field(kind, allowedTypes);
 }
-function structuralName(collectionName, allowedTypes) {
-    let inner;
-    if (allowedTypes === index_js_1.Any) {
-        inner = "Any";
-    }
-    else if (allowedTypes instanceof index_js_1.TreeNodeSchemaBase) {
-        return structuralName(collectionName, [allowedTypes]);
-    }
-    else {
-        (0, core_utils_1.assert)(Array.isArray(allowedTypes), 0x7c7 /* Types should be an array */);
-        const names = allowedTypes.map((t) => {
-            // Ensure that lazy types (functions) don't slip through here.
-            (0, core_utils_1.assert)(t instanceof index_js_1.TreeNodeSchemaBase, 0x7c8 /* invalid type provided */);
-            // Adding `as string` here would silence the linter, but make this code less type safe (since if this became not a string, it would still build).
-            // Thus we explicitly check that this satisfies string.
-            // This would best be done by appending `satisfies string`, but the linter also rejects this.
-            // Therefor introducing a variable to do the same thing as `satisfies string` but such that the linter can understand:
-            const name = t.name;
-            // Just incase the compiler and linter really are onto something and this might sometimes not be a string, validate it:
-            (0, core_utils_1.assert)(typeof name === "string", 0x7c9 /* Name should be a string */);
-            return name;
-        });
-        // Ensure name is order independent
-        names.sort();
-        // Ensure name can't have collisions by quoting and escaping any quotes in the names of types.
-        // Using JSON is a simple way to accomplish this.
-        // The outer `[]` around the result are also needed so that a single type name "Any" would not collide with the "any" case above.
-        inner = JSON.stringify(names);
-    }
-    return `${collectionName}<${inner}>`;
-}
-exports.structuralName = structuralName;
 //# sourceMappingURL=schemaBuilder.js.map