@fgv/ts-json 5.0.0-3 → 5.0.0-30

package/lib/packlets/editor/jsonEditor.js

@@ -84,9 +84,15 @@ class JsonEditor {
         ]);
     }
     /**
+     * Creates a complete IJsonEditorOptions object from partial options, filling in
+     * default values for any missing properties. This ensures all editor instances
+     * have consistent, complete configuration including validation rules and merge behavior.
+     * @param options - Optional partial editor options to merge with defaults
+     * @returns Success with complete editor options, or Failure if validation fails
      * @internal
      */
     static _getDefaultOptions(options) {
+        var _a;
         const context = options === null || options === void 0 ? void 0 : options.context;
         let validation = options === null || options === void 0 ? void 0 : options.validation;
         if (validation === undefined) {
@@ -99,7 +105,14 @@ class JsonEditor {
         let merge = options === null || options === void 0 ? void 0 : options.merge;
         if (merge === undefined) {
             merge = {
-                arrayMergeBehavior: 'append'
+                arrayMergeBehavior: 'append',
+                nullAsDelete: false
+            };
+        }
+        else {
+            merge = {
+                arrayMergeBehavior: merge.arrayMergeBehavior,
+                nullAsDelete: (_a = merge.nullAsDelete) !== null && _a !== void 0 ? _a : false
             };
         }
         return (0, ts_utils_1.succeed)({ context, validation, merge });
@@ -171,7 +184,7 @@ class JsonEditor {
             return (0, ts_utils_1.succeedWithDetail)(value, 'edited');
         }
         else if ((0, ts_json_base_1.isJsonObject)(value)) {
-            return this.mergeObjectInPlace({}, value, state.context).withFailureDetail('error');
+            return this._cloneObjectWithoutNullAsDelete({}, value, state);
         }
         else if ((0, ts_json_base_1.isJsonArray)(value)) {
             return this._cloneArray(value, state.context);
@@ -182,16 +195,22 @@ class JsonEditor {
         return state.failValidation('invalidPropertyValue', `Cannot convert invalid JSON: "${JSON.stringify(value)}"`);
     }
     /**
-     *
-     * @param target -
-     * @param src -
-     * @param state -
-     * @returns
+     * Merges properties from a source object into a target object, applying editor rules and
+     * null-as-delete logic. This is the core merge implementation that handles property-by-property
+     * merging with rule processing and deferred property handling.
+     * @param target - The target object to merge properties into
+     * @param src - The source object containing properties to merge
+     * @param state - The editor state containing options and context
+     * @returns Success with the modified target object, or Failure with error details
      * @internal
      */
     _mergeObjectInPlace(target, src, state) {
         for (const key in src) {
             if (src.hasOwnProperty(key)) {
+                // Skip dangerous property names to prevent prototype pollution
+                if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
+                    continue;
+                }
                 const propResult = this._editProperty(key, src[key], state);
                 if (propResult.isSuccess()) {
                     if (propResult.detail === 'deferred') {
@@ -223,10 +242,12 @@ class JsonEditor {
         return (0, ts_utils_1.succeed)(target);
     }
     /**
-     *
-     * @param src -
-     * @param context -
-     * @returns
+     * Creates a deep clone of a JSON array by recursively cloning each element.
+     * Each array element is cloned using the main clone method, preserving the
+     * editor's rules and validation settings.
+     * @param src - The source JSON array to clone
+     * @param context - Optional JSON context for cloning operations
+     * @returns Success with the cloned array, or Failure with error details
      * @internal
      */
     _cloneArray(src, context) {
@@ -240,17 +261,30 @@ class JsonEditor {
             .withFailureDetail('error');
     }
     /**
-     *
-     * @param target -
-     * @param key -
-     * @param newValue -
-     * @param state -
-     * @returns
+     * Merges a single cloned property value into a target object. This method handles
+     * the core merge logic including null-as-delete behavior, array merging, and
+     * recursive object merging. The null-as-delete check occurs before primitive
+     * handling to ensure null values can signal property deletion.
+     * @param target - The target object to merge the property into
+     * @param key - The property key being merged
+     * @param newValue - The cloned value to merge (from source object)
+     * @param state - The editor state containing merge options and context
+     * @returns Success with the merged value, or Failure with error details
      * @internal
      */
     _mergeClonedProperty(target, key, newValue, state) {
-        var _a, _b;
+        var _a, _b, _c;
+        // Skip dangerous property names to prevent prototype pollution
+        if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
+            return (0, ts_utils_1.succeedWithDetail)(newValue, 'edited');
+        }
         const existing = target[key];
+        // Handle null-as-delete behavior before primitive check
+        /* c8 ignore next 1 - ? is defense in depth */
+        if (newValue === null && ((_a = state.options.merge) === null || _a === void 0 ? void 0 : _a.nullAsDelete) === true) {
+            delete target[key];
+            return (0, ts_utils_1.succeedWithDetail)(null, 'edited');
+        }
         // merge is called right after clone so this should never happen
         // since clone itself will have failed
         if ((0, ts_json_base_1.isJsonPrimitive)(newValue)) {
@@ -268,7 +302,7 @@ class JsonEditor {
         if ((0, ts_json_base_1.isJsonArray)(newValue)) {
             if ((0, ts_json_base_1.isJsonArray)(existing)) {
                 /* c8 ignore next 1 - ?? is defense in depth */
-                const arrayMergeBehavior = (_b = (_a = state.options.merge) === null || _a === void 0 ? void 0 : _a.arrayMergeBehavior) !== null && _b !== void 0 ? _b : 'append';
+                const arrayMergeBehavior = (_c = (_b = state.options.merge) === null || _b === void 0 ? void 0 : _b.arrayMergeBehavior) !== null && _c !== void 0 ? _c : 'append';
                 switch (arrayMergeBehavior) {
                     case 'append':
                         target[key] = existing.concat(...newValue);
@@ -289,11 +323,13 @@ class JsonEditor {
         return (0, ts_utils_1.failWithDetail)(`Invalid JSON: ${JSON.stringify(newValue)}`, 'error');
     } /* c8 ignore stop */
     /**
-     *
-     * @param key -
-     * @param value -
-     * @param state -
-     * @returns
+     * Applies editor rules to a single property during merge operations. This method
+     * iterates through all configured editor rules to process the property, handling
+     * templates, conditionals, multi-value properties, and references.
+     * @param key - The property key to edit
+     * @param value - The property value to edit
+     * @param state - The editor state containing rules and context
+     * @returns Success with transformed property object, or Failure if rules cannot process
      * @internal
      */
     _editProperty(key, value, state) {
@@ -306,10 +342,12 @@ class JsonEditor {
         return (0, ts_utils_1.failWithDetail)('inapplicable', 'inapplicable');
     }
     /**
-     *
-     * @param value -
-     * @param state -
-     * @returns
+     * Applies editor rules to a single JSON value during clone operations. This method
+     * iterates through all configured editor rules to process the value, handling
+     * templates, conditionals, multi-value expressions, and references.
+     * @param value - The JSON value to edit and transform
+     * @param state - The editor state containing rules and context
+     * @returns Success with transformed value, or Failure if rules cannot process
      * @internal
      */
     _editValue(value, state) {
@@ -322,10 +360,41 @@ class JsonEditor {
         return (0, ts_utils_1.failWithDetail)('inapplicable', 'inapplicable');
     }
     /**
-     *
-     * @param target -
-     * @param state -
-     * @returns
+     * Clone an object without applying null-as-delete behavior.
+     * This preserves null values during cloning so they can be used for deletion signaling during merge.
+     * @param target - The target object to clone into
+     * @param src - The source object to clone
+     * @param state - The editor state
+     * @returns The cloned object
+     * @internal
+     */
+    _cloneObjectWithoutNullAsDelete(target, src, state) {
+        var _a, _b;
+        // Temporarily disable null-as-delete during cloning
+        const modifiedOptions = {
+            context: state.options.context,
+            validation: state.options.validation,
+            merge: {
+                /* c8 ignore next 1 - ? is defense in depth */
+                arrayMergeBehavior: (_b = (_a = state.options.merge) === null || _a === void 0 ? void 0 : _a.arrayMergeBehavior) !== null && _b !== void 0 ? _b : 'append',
+                nullAsDelete: false
+            }
+        };
+        const modifiedState = new jsonEditorState_1.JsonEditorState(state.editor, modifiedOptions, state.context);
+        return this._mergeObjectInPlace(target, src, modifiedState)
+            .onSuccess((merged) => {
+            return this._finalizeAndMerge(merged, modifiedState);
+        })
+            .withFailureDetail('error');
+    }
+    /**
+     * Finalizes the merge operation by processing any deferred properties and merging
+     * them into the target object. Deferred properties are those that require special
+     * processing after the initial merge phase, such as references that depend on
+     * other properties being resolved first.
+     * @param target - The target object that has been merged
+     * @param state - The editor state containing deferred properties and rules
+     * @returns Success with the finalized target object, or Failure with error details
      * @internal
      */
     _finalizeAndMerge(target, state) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-json",
-  "version": "5.0.0-3",
+  "version": "5.0.0-30",
   "description": "Typescript utilities for working with JSON",
   "main": "lib/index.js",
   "types": "dist/ts-json.d.ts",
@@ -19,35 +19,36 @@
     "@types/jest": "^29.5.14",
     "@types/mustache": "^4.2.5",
     "@types/node": "^20.14.9",
-    "@typescript-eslint/eslint-plugin": "^7.14.1",
-    "@typescript-eslint/parser": "^7.14.1",
-    "eslint": "^8.57.0",
+    "@typescript-eslint/eslint-plugin": "^8.42.0",
+    "@typescript-eslint/parser": "^8.42.0",
+    "eslint": "^9.35.0",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-promise": "^6.2.0",
+    "eslint-plugin-promise": "^7.2.1",
     "jest": "^29.7.0",
     "jest-extended": "^4.0.2",
     "mustache": "^4.2.0",
-    "rimraf": "^5.0.7",
-    "ts-jest": "^29.4.0",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.4.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.7.3",
-    "eslint-plugin-n": "^16.6.2",
-    "@rushstack/heft-node-rig": "~2.9.0",
-    "@rushstack/heft": "~0.74.0",
+    "typescript": "5.8.3",
+    "eslint-plugin-n": "^17.21.3",
+    "@rushstack/heft-node-rig": "2.9.5",
+    "@rushstack/heft": "0.74.4",
     "heft-jest": "~1.0.2",
     "@types/heft-jest": "1.0.6",
-    "@microsoft/api-documenter": "^7.26.29",
-    "@rushstack/eslint-config": "~4.4.0",
+    "@microsoft/api-documenter": "^7.26.31",
+    "@rushstack/eslint-config": "4.4.0",
     "eslint-plugin-tsdoc": "~0.4.0",
-    "@fgv/ts-utils-jest": "5.0.0-3",
-    "@fgv/ts-json-base": "5.0.0-3",
-    "@fgv/ts-utils": "5.0.0-3"
+    "@rushstack/heft-jest-plugin": "0.16.13",
+    "@fgv/ts-utils": "5.0.0-30",
+    "@fgv/ts-json-base": "5.0.0-30",
+    "@fgv/ts-utils-jest": "5.0.0-30"
   },
   "peerDependencies": {
     "mustache": "^4.2.0",
-    "@fgv/ts-utils": "5.0.0-3",
-    "@fgv/ts-json-base": "5.0.0-3"
+    "@fgv/ts-utils": "5.0.0-30",
+    "@fgv/ts-json-base": "5.0.0-30"
   },
   "scripts": {
     "build": "heft build --clean",

package/CHANGELOG.md

@@ -1,115 +0,0 @@
-# Change Log - @fgv/ts-json
-
-This log was last generated on Thu, 17 Jul 2025 00:13:24 GMT and should not be manually modified.
-
-## 5.0.0
-Thu, 17 Jul 2025 00:13:24 GMT
-
-### Updates
-
-- upgrade dependencies
-- bump version
-
-## 4.6.0
-Wed, 02 Jul 2025 05:48:16 GMT
-
-_Version update only_
-
-## 4.5.1
-Wed, 02 Jul 2025 05:47:11 GMT
-
-### Updates
-
-- update rushstack
-
-## 4.5.0
-Tue, 01 Jul 2025 03:26:11 GMT
-
-### Patches
-
-- Fix incorrect build script in package.json that was running tests instead of build
-
-## 4.4.0
-Sat, 01 Feb 2025 17:13:10 GMT
-
-_Version update only_
-
-## 4.3.0
-Thu, 30 Jan 2025 00:35:17 GMT
-
-_Version update only_
-
-## 4.2.2
-Thu, 23 Jan 2025 06:19:32 GMT
-
-_Version update only_
-
-## 4.2.1
-Tue, 21 Jan 2025 04:19:21 GMT
-
-_Version update only_
-
-## 4.2.0
-Mon, 20 Jan 2025 09:46:53 GMT
-
-_Version update only_
-
-## 4.1.0
-Thu, 09 Jan 2025 05:33:39 GMT
-
-### Updates
-
-- update dependencies
-
-## 4.0.2
-Tue, 14 May 2024 14:45:53 GMT
-
-_Version update only_
-
-## 4.0.1
-Tue, 14 May 2024 05:02:20 GMT
-
-### Updates
-
-- publish
-
-## 4.0.0
-Tue, 14 May 2024 03:09:27 GMT
-
-### Updates
-
-- update dependencies
-- update tsdoc comments and generated docs
-
-## 3.0.0
-Mon, 22 Jan 2024 07:00:18 GMT
-
-### Updates
-
-- fix export issues
-- fix peers
-- bump versions
-- refactor
-- major refactor
-- Match ts-utils refactor
-- version upgrades
-- update dependencies
-- update peer dependencies
-- bump version
-
-## 2.2.0
-Thu, 18 Jan 2024 05:45:04 GMT
-
-### Updates
-
-- fix export issues
-- fix peers
-- bump versions
-- refactor
-- major refactor
-- Match ts-utils refactor
-- version upgrades
-- update dependencies
-- update peer dependencies
-- bump version
-

package/lib/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/lib/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,qDAAmC;AACnC,wDAAsC;AACtC,oDAAkC","sourcesContent":["/*\n * Copyright (c) 2023 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './packlets/context';\nexport * from './packlets/converters';\nexport * from './packlets/editor';\n"]}

package/lib/packlets/context/compositeJsonMap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compositeJsonMap.d.ts","sourceRoot":"","sources":["../../../src/packlets/context/compositeJsonMap.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAgB,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAoD,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAE/F;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAErC;;;;;OAKG;IACH,SAAS,aAAa,IAAI,EAAE,iBAAiB,EAAE;IAI/C;;;;OAIG;WACW,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAIzE;;;;;OAKG;IACI,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC;;;;;;;OAOG;IACI,aAAa,CAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAAC,UAAU,EAAE,6BAA6B,CAAC;IAS5D;;;;;;;OAOG;IAEI,YAAY,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAAC,SAAS,EAAE,6BAA6B,CAAC;CAW5D"}

package/lib/packlets/context/compositeJsonMap.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compositeJsonMap.js","sourceRoot":"","sources":["../../../src/packlets/context/compositeJsonMap.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,oDAAwE;AACxE,4CAAyG;AAGzG;;;;GAIG;AACH,MAAa,gBAAgB;IAO3B;;;;;OAKG;IACH,YAAsB,IAAyB;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,IAAyB;QAC5C,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACI,YAAY,CAAC,GAAW;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACI,aAAa,CAClB,GAAW,EACX,OAAsB;QAEtB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE;YACtD,IAAI,CAAC,IAAA,2BAAY,EAAC,EAAE,CAAC,EAAE,CAAC;gBACtB,OAAO,IAAA,yBAAc,EAAC,GAAG,GAAG,iBAAiB,EAAE,OAAO,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,IAAA,4BAAiB,EAAC,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,gDAAgD;IACzC,YAAY,CACjB,GAAW,EACX,OAAsB;QAEtB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAC9C,IAAI,MAAM,CAAC,SAAS,EAAE,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBACpD,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAA,yBAAc,EAAC,GAAG,GAAG,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AAxFD,4CAwFC","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonObject, JsonValue, isJsonObject } from '@fgv/ts-json-base';\nimport { DetailedResult, Result, captureResult, failWithDetail, succeedWithDetail } from '@fgv/ts-utils';\nimport { IJsonContext, IJsonReferenceMap, JsonReferenceMapFailureReason } from './jsonContext';\n\n/**\n * A {@link CompositeJsonMap | CompositeJsonMap} presents a composed view of one or more other\n * {@link IJsonReferenceMap | JSON reference maps}.\n * @public\n */\nexport class CompositeJsonMap implements IJsonReferenceMap {\n  /**\n   * The {@link IJsonReferenceMap | reference maps} from which this map is composed.\n   * @internal\n   */\n  protected _maps: IJsonReferenceMap[];\n\n  /**\n   * The {@link IJsonReferenceMap | reference maps} from which this map is to be composed.\n   * @param maps - An array o {@link IJsonReferenceMap | IJsonReferenceMap} containing the maps\n   * from which this map is to be composed.\n   * @internal\n   */\n  protected constructor(maps: IJsonReferenceMap[]) {\n    this._maps = maps;\n  }\n\n  /**\n   * Creates a new {@link CompositeJsonMap | CompositeJsonMap} from supplied\n   * {@link IJsonReferenceMap | maps}.\n   * @param maps - one or more {@link IJsonReferenceMap | object maps} to be composed.\n   */\n  public static create(maps: IJsonReferenceMap[]): Result<CompositeJsonMap> {\n    return captureResult(() => new CompositeJsonMap(maps));\n  }\n\n  /**\n   * Determine if a key might be valid for this map but does not determine\n   * if key actually exists. Allows key range to be constrained.\n   * @param key - The key to be tested.\n   * @returns `true` if the key is in the valid range, `false` otherwise.\n   */\n  public keyIsInRange(key: string): boolean {\n    return this._maps.find((map) => map.keyIsInRange(key)) !== undefined;\n  }\n\n  /**\n   * Determines if an object with the specified key actually exists in the map.\n   * @param key - The key to be tested.\n   * @returns `true` if an object with the specified key exists, `false` otherwise.\n   */\n  public has(key: string): boolean {\n    return this._maps.find((map) => map.has(key)) !== undefined;\n  }\n\n  /**\n   * Gets a JSON object specified by key.\n   * @param key - The key of the object to be retrieved.\n   * @param context - An optional {@link IJsonContext | JSON Context} used to format the object.\n   * @returns `Success` with the formatted object if successful. `Failure` with detail `'unknown'`\n   * if no such object exists, or `Failure` with detail `'error'` if the object was found but\n   * could not be formatted.\n   */\n  public getJsonObject(\n    key: string,\n    context?: IJsonContext\n  ): DetailedResult<JsonObject, JsonReferenceMapFailureReason> {\n    return this.getJsonValue(key, context).onSuccess((jv) => {\n      if (!isJsonObject(jv)) {\n        return failWithDetail(`${key}: not an object`, 'error');\n      }\n      return succeedWithDetail(jv);\n    });\n  }\n\n  /**\n   * Gets a JSON value specified by key.\n   * @param key - The key of the object to be retrieved.\n   * @param context - An optional {@link IJsonContext | JSON Context} used to format the value.\n   * @returns `Success` with the formatted object if successful. `Failure` with detail `'unknown'`\n   * if no such object exists, or failure with detail `'error'` if the object was found but\n   * could not be formatted.\n   */\n  // eslint-disable-next-line no-use-before-define\n  public getJsonValue(\n    key: string,\n    context?: IJsonContext\n  ): DetailedResult<JsonValue, JsonReferenceMapFailureReason> {\n    for (const map of this._maps) {\n      if (map.keyIsInRange(key)) {\n        const result = map.getJsonValue(key, context);\n        if (result.isSuccess() || result.detail === 'error') {\n          return result;\n        }\n      }\n    }\n    return failWithDetail(`${key}: value not found`, 'unknown');\n  }\n}\n"]}

package/lib/packlets/context/contextHelpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"contextHelpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/context/contextHelpers.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAA0B,MAAM,eAAe,CAAC;AAE/D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,aAAa,EAEd,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAElC;;;;OAIG;gBACgB,OAAO,CAAC,EAAE,YAAY;IAIzC;;;;;;OAMG;WACW,MAAM,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAIvE;;;;;;;;;OASG;WACW,iBAAiB,CAC7B,WAAW,EAAE,YAAY,GAAG,SAAS,EACrC,IAAI,CAAC,EAAE,aAAa,EAAE,GACrB,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;IAQnC;;;;;;;;;OASG;WACW,iBAAiB,CAC7B,WAAW,EAAE,YAAY,GAAG,SAAS,EACrC,IAAI,CAAC,EAAE,iBAAiB,EAAE,GACzB,MAAM,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAWxC;;;;;;;;;OASG;WACW,aAAa,CACzB,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,EACtC,GAAG,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,iBAAiB,EAAE,CAAA;KAAE,GAC3D,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;IAenC;;;;;;;;;OASG;WACW,YAAY,CACxB,WAAW,EAAE,YAAY,GAAG,SAAS,EACrC,GAAG,EAAE,YAAY,GAAG,SAAS,GAC5B,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;IAmBnC;;;;;;;OAOG;IACI,UAAU,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;IAI3E;;;;;;;OAOG;IACI,UAAU,CAAC,IAAI,CAAC,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAIpF;;;;;;;;OAQG;IACI,aAAa,CAAC,GAAG,CAAC,EAAE;QACzB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE,iBAAiB,EAAE,CAAC;KAC5B,GAAG,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;IAIpC;;;;;;;;OAQG;IACI,YAAY,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;CAG5E"}

package/lib/packlets/context/contextHelpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"contextHelpers.js","sourceRoot":"","sources":["../../../src/packlets/context/contextHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, captureResult, succeed } from '@fgv/ts-utils';\nimport { CompositeJsonMap } from './compositeJsonMap';\nimport {\n  IJsonContext,\n  IJsonReferenceMap,\n  TemplateVars,\n  VariableValue,\n  defaultExtendVars\n} from './jsonContext';\n\n/**\n * Helper class for working with {@link IJsonContext | IJsonContext} objects.\n * @public\n */\nexport class JsonContextHelper {\n  /**\n   * The base {@link IJsonContext | context} on which we are operating.\n   * @internal\n   */\n  protected _context?: IJsonContext;\n\n  /**\n   * Constructs a new {@link JsonContextHelper | JsonContextHelper}.\n   * @param context - The base {@link IJsonContext | IJsonContext} on\n   * which to operate.\n   */\n  public constructor(context?: IJsonContext) {\n    this._context = context;\n  }\n\n  /**\n   * Creates a new {@link IJsonContext | context}.\n   * @param context - The base {@link IJsonContext | IJsonContext} on\n   * which to operate.\n   * @returns `Success` with the new {@link IJsonContext | IJsonContext},\n   * or `Failure` with more information if an error occurs.\n   */\n  public static create(context?: IJsonContext): Result<JsonContextHelper> {\n    return captureResult(() => new JsonContextHelper(context));\n  }\n\n  /**\n   * Static helper to extend context variables for a supplied {@link IJsonContext | IJsonContext}.\n   * @param baseContext - The {@link IJsonContext | IJsonContext} to be extended, or `undefined`\n   * to start from an empty context.\n   * @param vars - Optional {@link VariableValue | variable values} to be added to the\n   * {@link IJsonContext | context}.\n   * @returns `Success` with a new {@link TemplateVars | TemplateVars} containing the variables\n   * from the base context, merged with and overridden by any that were passed in, or `Failure`\n   * with a message if an error occurs.\n   */\n  public static extendContextVars(\n    baseContext: IJsonContext | undefined,\n    vars?: VariableValue[]\n  ): Result<TemplateVars | undefined> {\n    if (vars && vars.length > 0) {\n      const extend = baseContext?.extendVars ?? defaultExtendVars;\n      return extend(baseContext?.vars ?? {}, vars);\n    }\n    return succeed(baseContext?.vars);\n  }\n\n  /**\n   * Static helper to extend context references for a supplied {@link IJsonContext | IJsonContext}.\n   * @param baseContext - The {@link IJsonContext | IJsonContext} to be extended, or `undefined`\n   * to start from an empty context.\n   * @param refs - Optional {@link IJsonReferenceMap | reference maps} to be added to the\n   * {@link IJsonContext | context}.\n   * @returns `Success` with a new {@link IJsonReferenceMap | reference map} which projects\n   * the references from the base context, merged with and overridden by any that were passed in,\n   * or `Failure` with a message if an error occurs.\n   */\n  public static extendContextRefs(\n    baseContext: IJsonContext | undefined,\n    refs?: IJsonReferenceMap[]\n  ): Result<IJsonReferenceMap | undefined> {\n    if (refs && refs.length > 0) {\n      const full = baseContext?.refs ? [...refs, baseContext.refs] : refs;\n      if (full.length > 1) {\n        return CompositeJsonMap.create(full);\n      }\n      return succeed(full[0]);\n    }\n    return succeed(baseContext?.refs);\n  }\n\n  /**\n   * Static helper to extend context variables and references for a supplied {@link IJsonContext | IJsonContext}.\n   * @param baseContext - The {@link IJsonContext | IJsonContext} to be extended, or `undefined`\n   * to start from an empty context.\n   * @param add - Optional initializer containing {@link VariableValue | variable values} and/or\n   * {@link IJsonReferenceMap | reference maps} to be added to the {@link IJsonContext | context}.\n   * @returns `Success` with a new {@link IJsonContext | IJsonContext} containing the variables and\n   * references from the base context, merged with and overridden by any that were passed in, or\n   * `Failure` with a message if an error occurs.\n   */\n  public static extendContext(\n    baseContext?: IJsonContext | undefined,\n    add?: { vars?: VariableValue[]; refs?: IJsonReferenceMap[] }\n  ): Result<IJsonContext | undefined> {\n    return JsonContextHelper.extendContextVars(baseContext, add?.vars || []).onSuccess((vars) => {\n      return JsonContextHelper.extendContextRefs(baseContext, add?.refs || []).onSuccess((refs) => {\n        if (!vars && !refs && !baseContext?.extendVars) {\n          return succeed(undefined);\n        }\n        const rtrn: IJsonContext = { vars, refs };\n        if (baseContext?.extendVars) {\n          rtrn.extendVars = baseContext.extendVars;\n        }\n        return succeed(rtrn);\n      });\n    });\n  }\n\n  /**\n   * Static helper to merge context variables and references for a supplied {@link IJsonContext | IJsonContext}.\n   * @param baseContext - The {@link IJsonContext | IJsonContext} into which variables and references\n   * are to be merged, or `undefined` to start from an empty context.\n   * @param add - Optional initializer containing {@link VariableValue | variable values} and/or\n   * {@link IJsonReferenceMap | reference maps} to be added to the {@link IJsonContext | context}.\n   * @returns `Success` with a new {@link IJsonContext | IJsonContext} containing the variables and\n   * references from the base context, merged with and overridden by any that were passed in, or\n   * `Failure` with a message if an error occurs.\n   */\n  public static mergeContext(\n    baseContext: IJsonContext | undefined,\n    add: IJsonContext | undefined\n  ): Result<IJsonContext | undefined> {\n    if (baseContext) {\n      if (add) {\n        const rtrn: IJsonContext = {\n          vars: add.vars ?? baseContext.vars,\n          refs: add.refs ?? baseContext.refs\n        };\n        if (add.hasOwnProperty('extendVars')) {\n          rtrn.extendVars = add.extendVars;\n        } else if (baseContext.hasOwnProperty('extendVars')) {\n          rtrn.extendVars = baseContext.extendVars;\n        }\n        return succeed(rtrn);\n      }\n      return succeed(baseContext);\n    }\n    return succeed(add);\n  }\n\n  /**\n   * Applies {@link JsonContextHelper.extendContextVars | extendContextVars} to the\n   * {@link IJsonContext | IJsonContext} associated with this helper.\n   * @param vars - Optional {@link VariableValue | variable values} to be added to the\n   * @returns `Success` with a new {@link TemplateVars | TemplateVars} containing the variables\n   * from the base context, merged with and overridden by any that were passed in, or `Failure`\n   * with a message if an error occurs.\n   */\n  public extendVars(vars?: VariableValue[]): Result<TemplateVars | undefined> {\n    return JsonContextHelper.extendContextVars(this._context, vars);\n  }\n\n  /**\n   * Applies {@link JsonContextHelper.extendContextRefs | extendContextRefs} to the\n   * {@link IJsonContext | IJsonContext} associated with this helper.\n   * @param refs - Optional {@link IJsonReferenceMap | reference maps} to be added to the\n   * @returns `Success` with a new {@link IJsonReferenceMap | reference map} which projects\n   * the references from the base context, merged with and overridden by any that were passed in,\n   * or `Failure` with a message if an error occurs.\n   */\n  public extendRefs(refs?: IJsonReferenceMap[]): Result<IJsonReferenceMap | undefined> {\n    return JsonContextHelper.extendContextRefs(this._context, refs);\n  }\n\n  /**\n   * Applies static `JsonContextHelper.extendContext` to the\n   * {@link IJsonContext | IJsonContext} associated with this helper.\n   * @param add - Optional initializer containing {@link VariableValue | variable values} and/or\n   * {@link IJsonReferenceMap | reference maps} to be added to the {@link IJsonContext | context}.\n   * @returns `Success` with a new {@link IJsonContext | IJsonContext} containing the variables and\n   * references from the base context, merged with and overridden by any that were passed in, or\n   * `Failure` with a message if an error occurs.\n   */\n  public extendContext(add?: {\n    vars?: VariableValue[];\n    refs?: IJsonReferenceMap[];\n  }): Result<IJsonContext | undefined> {\n    return JsonContextHelper.extendContext(this._context, add);\n  }\n\n  /**\n   * Applies static `JsonContextHelper.mergeContext` to the\n   * {@link IJsonContext | IJsonContext} associated with this helper.\n   * @param add - Optional initializer containing {@link VariableValue | variable values} and/or\n   * {@link IJsonReferenceMap | reference maps} to be added to the {@link IJsonContext | context}.\n   * @returns `Success` with a new {@link IJsonContext | IJsonContext} containing the variables and\n   * references from the base context, merged with and overridden by any that were passed in, or\n   * `Failure` with a message if an error occurs.\n   */\n  public mergeContext(merge?: IJsonContext): Result<IJsonContext | undefined> {\n    return JsonContextHelper.mergeContext(this._context, merge);\n  }\n}\n"]}

package/lib/packlets/context/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/context/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,6BAA6B,EAC7B,YAAY,EACZ,0BAA0B,EAC1B,aAAa,EACb,iBAAiB,EAClB,MAAM,eAAe,CAAC"}

package/lib/packlets/context/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/context/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,mDAAqD;AAA5C,mHAAA,iBAAiB,OAAA;AAC1B,6CAQuB;AADrB,gHAAA,iBAAiB,OAAA","sourcesContent":["/*\n * Copyright (c) 2023 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport { CompositeJsonMap } from './compositeJsonMap';\nexport { JsonContextHelper } from './contextHelpers';\nexport {\n  IJsonContext,\n  IJsonReferenceMap,\n  JsonReferenceMapFailureReason,\n  TemplateVars,\n  TemplateVarsExtendFunction,\n  VariableValue,\n  defaultExtendVars\n} from './jsonContext';\n"]}

package/lib/packlets/context/jsonContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonContext.d.ts","sourceRoot":"","sources":["../../../src/packlets/context/jsonContext.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAW,MAAM,eAAe,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,MAAM,EAAE,aAAa,EAAE,KACpB,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;AAEtC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,MAAM,EAAE,aAAa,EAAE,GACtB,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAOlC;AAED;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAEnC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1B;;;;;;;;OAQG;IAEH,aAAa,CACX,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC;IAE7D;;;;;;;OAOG;IAEH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;CAC7G;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,UAAU,CAAC,EAAE,0BAA0B,CAAC;CACzC"}

package/lib/packlets/context/jsonContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonContext.js","sourceRoot":"","sources":["../../../src/packlets/context/jsonContext.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAoCH,8CAUC;AA3CD,4CAAgE;AA0BhE;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,IAA8B,EAC9B,MAAuB;IAEvB,sBAAsB;IACtB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC;AACvB,CAAC","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonObject, JsonValue } from '@fgv/ts-json-base';\nimport { DetailedResult, Result, succeed } from '@fgv/ts-utils';\n\n/**\n * Collection of variables used for template replacement in a JSON edit or\n * conversion.\n * @public\n */\nexport type TemplateVars = Record<string, unknown>;\n\n/**\n * Describes one value in a {@link TemplateVars | TemplateVars} collection of\n * variables.\n * @public\n */\nexport type VariableValue = [string, unknown];\n\n/**\n * Function used to create a new collection of {@link TemplateVars | TemplateVars} with\n * one or more new or changed values.\n * @public\n */\nexport type TemplateVarsExtendFunction = (\n  base: TemplateVars | undefined,\n  values: VariableValue[]\n) => Result<TemplateVars | undefined>;\n\n/**\n * This default implementation of a {@link TemplateVarsExtendFunction | TemplateVarsExtendFunction}\n * creates a new collection via inheritance from the supplied collection.\n * @param base - The base {@link TemplateVars | variables} to be extended.\n * @param values - The {@link VariableValue | values} to be added or overridden in the new variables.\n * @public\n */\nexport function defaultExtendVars(\n  base: TemplateVars | undefined,\n  values: VariableValue[]\n): Result<TemplateVars | undefined> {\n  /* c8 ignore next 1 */\n  const rtrn = base ? Object.create(base) : {};\n  for (const v of values) {\n    rtrn[v[0]] = v[1];\n  }\n  return succeed(rtrn);\n}\n\n/**\n * Failure reason for {@link IJsonReferenceMap | IJsonReferenceMap} lookup, where `'unknown'`\n * means that the object is not present in the map and `'error'` means\n * that an error occurred while retrieving or converting it.\n * @public\n */\nexport type JsonReferenceMapFailureReason = 'unknown' | 'error';\n\n/**\n * Interface for a simple map that returns named `JsonValue` values with templating,\n * conditional logic, and external reference lookups applied using an optionally supplied context.\n * @public\n */\nexport interface IJsonReferenceMap {\n  /**\n   * Determine if a key might be valid for this map but does not determine if key actually\n   * exists. Allows key range to be constrained.\n   * @param key - The key to be tested.\n   * @returns `true` if the key is in the valid range, `false` otherwise.\n   */\n  keyIsInRange(key: string): boolean;\n\n  /**\n   * Determines if an object with the specified key actually exists in the map.\n   * @param key - The key to be tested.\n   * @returns `true` if an object with the specified key exists, `false` otherwise.\n   */\n  has(key: string): boolean;\n\n  /**\n   * Gets a `JsonObject` specified by key.\n   * @param key - The key of the object to be retrieved.\n   * @param context - Optional {@link IJsonContext | IJsonContext} used to construct\n   * the object.\n   * @returns `Success` with the formatted JsonObject if successful. `Failure`\n   * with detail `'unknown'`  if no such object exists, or `Failure` with detail `'error'` if\n   * the object was found but could not be formatted.\n   */\n  // eslint-disable-next-line no-use-before-define\n  getJsonObject(\n    key: string,\n    context?: IJsonContext\n  ): DetailedResult<JsonObject, JsonReferenceMapFailureReason>;\n\n  /**\n   * Gets a `JsonValue` specified by key.\n   * @param key - The key of the object to be retrieved.\n   * @param context - Optional {@link IJsonContext | JSON Context} used to format the value\n   * @returns `Success` with the formatted `JsonValue` if successful. `Failure`\n   * with detail `'unknown'` if no such object exists, or `Failure` with detail `'error'` if\n   * the object was found but could not be formatted.\n   */\n  // eslint-disable-next-line no-use-before-define\n  getJsonValue(key: string, context?: IJsonContext): DetailedResult<JsonValue, JsonReferenceMapFailureReason>;\n}\n\n/**\n * Context used to convert or edit JSON objects.\n * @public\n */\nexport interface IJsonContext {\n  vars?: TemplateVars;\n  refs?: IJsonReferenceMap;\n  extendVars?: TemplateVarsExtendFunction;\n}\n"]}

package/lib/packlets/converters/converters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../src/packlets/converters/converters.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAEL,+BAA+B,EAC/B,aAAa,EAEb,wBAAwB,EAExB,6BAA6B,EAC9B,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,aAAmC,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,YAAY,CAAiB,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,YAAY,CAAgB,CAAC;AAM1E;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,GAAG,aAAa,CAQ7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,+BAA+B,CAAC,GAAG,aAAa,CAQjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,aAAa,CAQnF"}

package/lib/packlets/converters/converters.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"converters.js","sourceRoot":"","sources":["../../../src/packlets/converters/converters.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAkDH,sCAQC;AAWD,0CAQC;AAWD,4BAQC;AA3FD,mDAQyB;AAEzB;;;;GAIG;AACU,QAAA,IAAI,GAAkB,IAAI,6BAAa,EAAE,CAAC;AAEvD;;;;;GAKG;AACU,QAAA,UAAU,GAAwC,YAAI,CAAC,MAAM,EAAE,CAAC;AAE7E;;;;;GAKG;AACU,QAAA,SAAS,GAAuC,YAAI,CAAC,KAAK,EAAE,CAAC;AAE1E,IAAI,oBAA+C,CAAC;AACpD,IAAI,sBAAiD,CAAC;AACtD,IAAI,eAA0C,CAAC;AAE/C;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,OAAgD;IAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,oBAAoB,GAAG,IAAI,sCAAsB,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,sCAAsB,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,OAAkD;IAChF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAC5B,sBAAsB,GAAG,IAAI,wCAAwB,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,wCAAwB,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,OAA2C;IAClE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,eAAe,GAAG,IAAI,iCAAiB,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,iCAAiB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonArray, JsonObject } from '@fgv/ts-json-base';\nimport { Converter } from '@fgv/ts-utils';\nimport { IJsonContext } from '../context';\nimport {\n  ConditionalJsonConverter,\n  ConditionalJsonConverterOptions,\n  JsonConverter,\n  RichJsonConverter,\n  RichJsonConverterOptions,\n  TemplatedJsonConverter,\n  TemplatedJsonConverterOptions\n} from './jsonConverter';\n\n/**\n * A simple validating {@link JsonConverter | JSON converter}. Converts unknown to\n * JSON or fails if the unknown contains any invalid JSON values.\n * @public\n */\nexport const json: JsonConverter = new JsonConverter();\n\n/**\n * A simple validating {@link JsonConverter | JSON converter}. Converts unknown\n * to a `JsonObject`, or fails if the `unknown` contains invalid\n * JSON or is not an object.\n * @public\n */\nexport const jsonObject: Converter<JsonObject, IJsonContext> = json.object();\n\n/**\n * A simple validating {@link JsonConverter | JSON converter}. Converts `unknown` to a\n * `JsonArray`, or fails if the unknown contains invalid JSON or is\n * not an array.\n * @public\n */\nexport const jsonArray: Converter<JsonArray, IJsonContext> = json.array();\n\nlet templatedJsonDefault: JsonConverter | undefined;\nlet conditionalJsonDefault: JsonConverter | undefined;\nlet richJsonDefault: JsonConverter | undefined;\n\n/**\n * Helper function which creates a new {@link JsonConverter | JsonConverter} which converts an\n * `unknown` value to JSON, rendering any property names or string values using mustache with\n * the supplied context.  See the mustache documentation for details of mustache syntax and view.\n * @param options - {@link TemplatedJsonConverterOptions | Options and context} for\n * the conversion.\n * @public\n */\nexport function templatedJson(options?: Partial<TemplatedJsonConverterOptions>): JsonConverter {\n  if (!options) {\n    if (!templatedJsonDefault) {\n      templatedJsonDefault = new TemplatedJsonConverter();\n    }\n    return templatedJsonDefault;\n  }\n  return new TemplatedJsonConverter(options);\n}\n\n/**\n * Helper function which creates a new {@link JsonConverter | JsonConverter} which converts a\n * supplied `unknown` to strongly-typed JSON, by first rendering any property\n * names or string values using mustache with the supplied context, then applying\n * multi-value property expansion and conditional flattening based on property names.\n * @param options - {@link ConditionalJsonConverterOptions | Options and context} for\n * the conversion.\n * @public\n */\nexport function conditionalJson(options?: Partial<ConditionalJsonConverterOptions>): JsonConverter {\n  if (!options) {\n    if (!conditionalJsonDefault) {\n      conditionalJsonDefault = new ConditionalJsonConverter();\n    }\n    return conditionalJsonDefault;\n  }\n  return new ConditionalJsonConverter(options);\n}\n\n/**\n * Helper function which creates a new {@link JsonConverter | JsonConverter} which converts a\n * supplied `unknown` to strongly-typed JSON, by first rendering any property\n * names or string values using mustache with the supplied context, then applying\n * multi-value property expansion and conditional flattening based on property names.\n * @param options - {@link RichJsonConverterOptions | Options and context} for\n * the conversion.\n * @public\n */\nexport function richJson(options?: Partial<RichJsonConverterOptions>): JsonConverter {\n  if (!options) {\n    if (!richJsonDefault) {\n      richJsonDefault = new RichJsonConverter();\n    }\n    return richJsonDefault;\n  }\n  return new RichJsonConverter(options);\n}\n"]}

package/lib/packlets/converters/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/converters/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/lib/packlets/converters/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/converters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,yDAA2C;AAGlC,gCAAU;AADnB,kDAAgC","sourcesContent":["/*\n * Copyright (c) 2023 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Converters from './converters';\n\nexport * from './jsonConverter';\nexport { Converters };\n"]}

package/lib/packlets/converters/jsonConverter.d.ts.map

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

package/lib/packlets/converters/jsonConverter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonConverter.js","sourceRoot":"","sources":["../../../src/packlets/converters/jsonConverter.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonArray, JsonObject, JsonValue, isJsonObject } from '@fgv/ts-json-base';\nimport { Conversion, Converter, Result, captureResult, fail, succeed } from '@fgv/ts-utils';\nimport {\n  IJsonContext,\n  IJsonReferenceMap,\n  TemplateVars,\n  TemplateVarsExtendFunction,\n  defaultExtendVars\n} from '../context';\n\nimport { EditorRules, IJsonEditorOptions, IJsonEditorRule, JsonEditor } from '../editor';\n\n/**\n * Conversion options for {@link JsonConverter | JsonConverter}.\n * @public\n */\nexport interface IJsonConverterOptions {\n  /**\n   * If `true` and if template variables are available,\n   * then string property values will be rendered using\n   * mustache and those variable values. Otherwise string\n   * properties are copied without modification.\n   *\n   * Defaults to `true` if vars are supplied with options,\n   * `false` otherwise.\n   */\n  useValueTemplates: boolean;\n\n  /**\n   * If `true` and if template variables are available,\n   * then property names will be rendered using\n   * mustache and those variable values. Otherwise\n   * property names are copied without modification.\n   *\n   * Defaults to `true` if vars are supplied with options,\n   * `false` otherwise.\n   */\n  useNameTemplates: boolean;\n\n  /**\n   * If `true` and if template variables are available,\n   * then string property names will be considered for\n   * conditionals.\n   *\n   * Default is to match {@link IJsonConverterOptions.useNameTemplates | useNameTemplates}.\n   */\n  useConditionalNames: boolean;\n\n  /**\n   * If `true` (default) then properties with unconditional names\n   * (which start with !) are flattened.\n   */\n  flattenUnconditionalValues: boolean;\n\n  /**\n   * If `true` and if both template variables and a\n   * context derivation function is available, then properties\n   * which match the multi-value name pattern will be expanded.\n   * Default matches {@link IJsonConverterOptions.useNameTemplates | useNameTemplates}.\n   *\n   * Default is `true` unless {@link IJsonConverterOptions.extendVars | extendVars} is\n   * explicitly set to `undefined`.\n   */\n  useMultiValueTemplateNames: boolean;\n\n  /**\n   * The variables (mustache view) used to render templated string names\n   * and properties.  See the mustache documentation for details of mustache\n   * syntax and the template view.\n   */\n  vars?: TemplateVars;\n\n  /**\n   * Method used to extend variables for children of an array node during\n   * expansion. Default is to use a built-in extension function unless\n   * {@link IJsonConverterOptions.extendVars | extendVars} is explicitly set to undefined.\n   */\n  extendVars?: TemplateVarsExtendFunction;\n\n  /**\n   * If `true` and if a {@link IJsonReferenceMap | references map} is supplied\n   * in {@link IJsonConverterOptions.refs | refs}, then references in the source\n   * object will be replaced with the corresponding value from the reference map.\n   *\n   * Default is `true` if {@link IJsonConverterOptions.refs | refs} are present in options,\n   * `false` otherwise.\n   */\n  useReferences: boolean;\n\n  /**\n   * An optional {@link IJsonReferenceMap | reference map} used to insert any references\n   * in the converted JSON.\n   */\n  refs?: IJsonReferenceMap;\n\n  /**\n   * If {@link IJsonConverterOptions.onInvalidPropertyName | onInvalidPropertyName} is `'error'`\n   * (default) then any property name that is invalid after template rendering causes an error\n   * and stops conversion.  If {@link IJsonConverterOptions.onInvalidPropertyName | onInvalidPropertyName}\n   * is `'ignore'`, then names which are invalid after template rendering are passed through unchanged.\n   */\n  onInvalidPropertyName: 'error' | 'ignore';\n\n  /**\n   * If {@link IJsonConverterOptions.onInvalidPropertyValue | onInvalidPropertyValue} is `'error'`\n   * (default) then any illegal property value causes an error and stops conversion.  If\n   * {@link IJsonConverterOptions.onInvalidPropertyValue | onInvalidPropertyValue} is `'ignore'` then\n   * any invalid property values are silently ignored.\n   */\n  onInvalidPropertyValue: 'error' | 'ignore';\n\n  /**\n   * If {@link IJsonConverterOptions.onUndefinedPropertyValue | onUndefinedPropertyValue} is `'error'`,\n   * then any property with value `undefined` will cause an error and stop conversion.  If\n   * {@link IJsonConverterOptions.onUndefinedPropertyValue | onUndefinedPropertyValue} is `'ignore'` (default)\n   * then any property with value `undefined` is silently ignored.\n   */\n  onUndefinedPropertyValue: 'error' | 'ignore';\n}\n\n/**\n * Merges an optionally supplied partial set of {@link IJsonConverterOptions | options} with\n * the default converter options and taking all dynamic rules into account (e.g. template usage enabled\n * if variables are supplied and disabled if not),  producing a fully-resolved set of\n * {@link IJsonConverterOptions | IJsonConverterOptions}.\n * @param partial - An optional partial {@link IJsonConverterOptions | IJsonConverterOptions}\n * to be merged.\n * @public\n */\nexport function mergeDefaultJsonConverterOptions(\n  partial?: Partial<IJsonConverterOptions>\n): IJsonConverterOptions {\n  const haveVars = partial?.vars !== undefined;\n  const haveRefs = partial?.refs !== undefined;\n  const extender = partial?.hasOwnProperty('extendVars') ? partial.extendVars : defaultExtendVars;\n  const haveExtender = extender !== undefined;\n  const namesDefault = partial?.useNameTemplates ?? haveVars;\n  const conditionsDefault = partial?.useConditionalNames ?? namesDefault;\n\n  const options: IJsonConverterOptions = {\n    useValueTemplates: partial?.useValueTemplates ?? haveVars,\n    useNameTemplates: namesDefault,\n    useConditionalNames: conditionsDefault,\n    flattenUnconditionalValues: partial?.flattenUnconditionalValues ?? conditionsDefault,\n    useMultiValueTemplateNames: partial?.useMultiValueTemplateNames ?? (haveExtender && namesDefault),\n    useReferences: partial?.useReferences ?? haveRefs,\n    onInvalidPropertyName: partial?.onInvalidPropertyName ?? 'error',\n    onInvalidPropertyValue: partial?.onInvalidPropertyValue ?? 'error',\n    onUndefinedPropertyValue: partial?.onUndefinedPropertyValue ?? 'ignore',\n    extendVars: extender\n  };\n  if (partial?.vars) {\n    options.vars = partial.vars;\n  }\n  if (partial?.refs) {\n    options.refs = partial.refs;\n  }\n  return options;\n}\n\n/**\n * Creates a new {@link IJsonContext | JSON context} using values supplied in an optional partial\n * {@link IJsonConverterOptions | converter options}.\n * @param partial - Optional partial {@link IJsonConverterOptions | IJsonConverterOptions} used to\n * populate the context.\n * @public\n */\nexport function contextFromConverterOptions(\n  partial?: Partial<IJsonConverterOptions>\n): IJsonContext | undefined {\n  const context: IJsonContext = {};\n  if (partial?.vars) {\n    context.vars = partial.vars;\n  }\n  if (partial?.refs) {\n    context.refs = partial.refs;\n  }\n  if (partial?.hasOwnProperty('extendVars')) {\n    context.extendVars = partial.extendVars;\n  }\n  return context.vars || context.refs || context.extendVars ? context : undefined;\n}\n\n/**\n * Creates a new {@link JsonEditor | JsonEditor} from an optionally supplied partial\n * {@link IJsonConverterOptions | JSON converter options}.\n * Expands supplied options with default values and constructs an editor with\n * matching configuration and defined rules.\n * @param partial - Optional partial {@link IJsonConverterOptions | IJsonConverterOptions}\n * used to create the editor.\n * @public\n */\nexport function converterOptionsToEditor(partial?: Partial<IJsonConverterOptions>): Result<JsonEditor> {\n  const converterOptions = mergeDefaultJsonConverterOptions(partial);\n  const context = contextFromConverterOptions(partial);\n  const validation = {\n    onInvalidPropertyName: converterOptions.onInvalidPropertyName,\n    onInvalidPropertyValue: converterOptions.onInvalidPropertyValue,\n    onUndefinedPropertyValue: converterOptions.onUndefinedPropertyValue\n  };\n  const editorOptions: IJsonEditorOptions = { context, validation };\n\n  const rules: IJsonEditorRule[] = [];\n  if (converterOptions.useNameTemplates || converterOptions.useValueTemplates) {\n    const templateOptions = {\n      ...editorOptions,\n      useNameTemplates: converterOptions.useNameTemplates,\n      useValueTemplates: converterOptions.useValueTemplates\n    };\n    rules.push(new EditorRules.TemplatedJsonEditorRule(templateOptions));\n  }\n  if (converterOptions.useConditionalNames || converterOptions.flattenUnconditionalValues) {\n    const conditionalOptions = {\n      ...editorOptions,\n      flattenUnconditionalValues: converterOptions.flattenUnconditionalValues\n    };\n    rules.push(new EditorRules.ConditionalJsonEditorRule(conditionalOptions));\n  }\n  if (converterOptions.useMultiValueTemplateNames) {\n    rules.push(new EditorRules.MultiValueJsonEditorRule(editorOptions));\n  }\n  if (converterOptions.useReferences) {\n    rules.push(new EditorRules.ReferenceJsonEditorRule(editorOptions));\n  }\n\n  return JsonEditor.create(editorOptions, rules);\n}\n\n/**\n * A thin wrapper to allow an arbitrary {@link JsonEditor | JsonEditor} to be used via the\n * \\@fgv/ts-utils `Converter` pattern.\n * @public\n */\nexport class JsonEditorConverter extends Conversion.BaseConverter<JsonValue, IJsonContext> {\n  public readonly editor: JsonEditor;\n\n  /**\n   * Constructs a new {@link JsonEditor | JsonEditor}Converter which uses the supplied editor\n   * @param editor -\n   */\n  public constructor(editor: JsonEditor) {\n    super((from, __self, context) => this._convert(from, context), editor.options.context);\n    this.editor = editor;\n  }\n\n  /**\n   * Constructs a new {@link JsonEditor | JsonEditor}Converter which uses the supplied editor\n   * @param editor -\n   */\n  public static createWithEditor(editor: JsonEditor): Result<JsonEditorConverter> {\n    return captureResult(() => new JsonEditorConverter(editor));\n  }\n\n  /**\n   * Gets a derived converter which fails if the resulting converted\n   * `JsonValue` is not a `JsonObject`.\n   */\n  public object(): Converter<JsonObject, IJsonContext> {\n    return this.map((jv) => {\n      if (!isJsonObject(jv)) {\n        return fail(`Cannot convert \"${JSON.stringify(jv)}\" to JSON object.`);\n      }\n      return succeed(jv);\n    });\n  }\n\n  /**\n   * Gets a derived converter which fails if the resulting converted\n   * `JsonValue` is not a `JsonArray`.\n   */\n  public array(): Converter<JsonArray, IJsonContext> {\n    return this.map((jv) => {\n      if (!Array.isArray(jv) || typeof jv !== 'object') {\n        return fail(`Cannot convert \"${JSON.stringify(jv)}\" to JSON array.`);\n      }\n      return succeed(jv);\n    });\n  }\n\n  protected _convert(from: unknown, context?: IJsonContext): Result<JsonValue> {\n    return this.editor.clone(from as JsonValue, context);\n  }\n}\n\n/**\n * An \\@fgv/ts-utils `Converter` from `unknown` to type-safe JSON, optionally\n * rendering any string property names or values using mustache with a supplied view.\n * @public\n */\nexport class JsonConverter extends JsonEditorConverter {\n  /**\n   * Constructs a new {@link JsonConverter | JsonConverter} with\n   * supplied or default options.\n   * @param options - Optional partial {@link IJsonConverterOptions | options}\n   * to configure the converter.\n   */\n  public constructor(options?: Partial<IJsonConverterOptions>) {\n    const editor = converterOptionsToEditor(options).orThrow();\n    super(editor);\n  }\n\n  /**\n   * Creates a new {@link JsonConverter | JsonConverter}.\n   * @param options - Optional partial {@link IJsonConverterOptions | options}\n   * to configure the converter.\n   * @returns `Success` with a new {@link JsonConverter | JsonConverter}, or `Failure`\n   * with an informative message if an error occurs.\n   */\n  public static create(options?: Partial<IJsonConverterOptions>): Result<JsonConverter> {\n    return captureResult(() => new JsonConverter(options));\n  }\n}\n\n/**\n * Initialization options for a {@link TemplatedJsonConverter | TemplatedJsonConverter}.\n * @public\n */\nexport type TemplatedJsonConverterOptions = Omit<\n  IJsonConverterOptions,\n  'useNameTemplates' | 'useValueTemplates' | 'useMultiValueTemplateNames'\n>;\n\n/**\n * An \\@fgv/ts-utils `Converter` from `unknown` to type-safe JSON\n * with mustache template rendering and multi-value property name rules enabled\n * regardless of initial context.\n * @public\n */\nexport class TemplatedJsonConverter extends JsonEditorConverter {\n  /**\n   * Default {@link IJsonConverterOptions | JSON converter options}\n   * to enable templated conversion.\n   */\n  public static readonly templateOptions: Partial<IJsonConverterOptions> = {\n    useNameTemplates: true,\n    useValueTemplates: true,\n    useMultiValueTemplateNames: true,\n    useConditionalNames: false,\n    flattenUnconditionalValues: false\n  };\n\n  /**\n   * Constructs a new {@link TemplatedJsonConverter | TemplatedJsonConverter} with\n   * supplied or default options.\n   * @param options - Optional partial {@link TemplatedJsonConverterOptions | options}\n   * to configure the converter.\n   */\n  public constructor(options?: Partial<TemplatedJsonConverterOptions>) {\n    options = { ...options, ...TemplatedJsonConverter.templateOptions };\n    const editor = converterOptionsToEditor(options).orThrow();\n    super(editor);\n  }\n\n  /**\n   * Constructs a new {@link TemplatedJsonConverter | TemplatedJsonConverter} with\n   * supplied or default options.\n   * @param options - Optional partial {@link TemplatedJsonConverterOptions | options}\n   * to configure the converter.\n   */\n  public static create(options?: Partial<TemplatedJsonConverterOptions>): Result<JsonConverter> {\n    return captureResult(() => new TemplatedJsonConverter(options));\n  }\n}\n\n/**\n * Options for a {@link ConditionalJsonConverter | ConditionalJsonConverter}.\n * @public\n */\nexport type ConditionalJsonConverterOptions = Omit<TemplatedJsonConverterOptions, 'useConditionalNames'>;\n\n/**\n * An \\@fgv/ts-utils `Converter` from `unknown` to type-safe JSON with mustache\n * template rendering, multi-value property name and conditional property\n * name rules enabled regardless of initial context.\n * @public\n */\nexport class ConditionalJsonConverter extends JsonEditorConverter {\n  /**\n   * Default {@link IJsonConverterOptions | JSON converter options}\n   * to enable conditional conversion.\n   */\n  public static readonly conditionalOptions: Partial<IJsonConverterOptions> = {\n    ...TemplatedJsonConverter.templateOptions,\n    useConditionalNames: true,\n    flattenUnconditionalValues: true\n  };\n\n  /**\n   * Constructs a new {@link ConditionalJsonConverter | ConditionalJsonConverter} with supplied or\n   * default options.\n   * @param options - Optional partial {@link ConditionalJsonConverterOptions | configuration or context}\n   * for the converter.\n   */\n  public constructor(options?: Partial<ConditionalJsonConverterOptions>) {\n    options = { ...options, ...ConditionalJsonConverter.conditionalOptions };\n    const editor = converterOptionsToEditor(options).orThrow();\n    super(editor);\n  }\n\n  /**\n   * Constructs a new {@link ConditionalJsonConverter | ConditionalJsonConverter} with supplied or\n   * default options.\n   * @param options - Optional partial {@link ConditionalJsonConverterOptions | configuration or context}\n   * for the converter.\n   */\n  public static create(options?: Partial<ConditionalJsonConverterOptions>): Result<JsonConverter> {\n    return captureResult(() => new ConditionalJsonConverter(options));\n  }\n}\n\n/**\n * Initialization options for a {@link RichJsonConverter | RichJsonConverter}.\n * @public\n */\nexport type RichJsonConverterOptions = Omit<ConditionalJsonConverterOptions, 'useReferences'>;\n\n/**\n * A \\@fgv/ts-utils `Converter` from `unknown` to type-safe JSON with mustache\n * template rendering, multi-value property name, conditional property\n * name, and external reference rules enabled regardless of initial context.\n * @public\n */\nexport class RichJsonConverter extends JsonEditorConverter {\n  /**\n   * Default {@link IJsonConverterOptions | JSON converter options}\n   * to enable rich conversion.\n   */\n  public static readonly richOptions: Partial<IJsonConverterOptions> = {\n    ...ConditionalJsonConverter.conditionalOptions,\n    useReferences: true\n  };\n\n  /**\n   * Constructs a new {@link RichJsonConverter | RichJsonConverter} with supplied or\n   * default options.\n   * @param options - Optional partial {@link RichJsonConverterOptions | configuration or context}\n   * for the converter.\n   */\n  public constructor(options?: Partial<RichJsonConverterOptions>) {\n    options = { ...options, ...RichJsonConverter.richOptions };\n    const editor = converterOptionsToEditor(options).orThrow();\n    super(editor);\n  }\n\n  /**\n   * Constructs a new {@link RichJsonConverter | RichJsonConverter} with supplied or\n   * default options\n   * @param options - Optional partial {@link RichJsonConverterOptions | configuration or context}\n   * for the converter.\n   */\n  public static create(options?: Partial<RichJsonConverterOptions>): Result<JsonConverter> {\n    return captureResult(() => new RichJsonConverter(options));\n  }\n}\n"]}

package/lib/packlets/editor/common.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/packlets/editor/common.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,GAAG,UAAU,CAAC;AAE/E;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GACjC,qBAAqB,GACrB,sBAAsB,GACtB,wBAAwB,CAAC;AAE7B;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,qBAAqB,EAAE,OAAO,GAAG,QAAQ,CAAC;IAE1C;;;;;OAKG;IACH,sBAAsB,EAAE,OAAO,GAAG,QAAQ,CAAC;IAE3C;;;;;OAKG;IACH,wBAAwB,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,4BAA4B,CAAC;IACzC,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;CACjG"}

package/lib/packlets/editor/common.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/packlets/editor/common.ts"],"names":[],"mappings":"","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\nimport { JsonValue } from '@fgv/ts-json-base';\nimport { DetailedResult } from '@fgv/ts-utils';\nimport { IJsonContext } from '../context';\n\n/**\n * Possible `DetailedResult` details for various editor operations.\n * @public\n */\nexport type JsonEditFailureReason = 'ignore' | 'inapplicable' | 'edited' | 'error';\n\n/**\n * Possible `DetailedResult` details for property edit operations.\n * @public\n */\nexport type JsonPropertyEditFailureReason = JsonEditFailureReason | 'deferred';\n\n/**\n * Possible validation rules for a {@link JsonEditor | JsonEditor}.\n * @public\n */\nexport type JsonEditorValidationRules =\n  | 'invalidPropertyName'\n  | 'invalidPropertyValue'\n  | 'undefinedPropertyValue';\n\n/**\n * Array merge behavior options for a {@link JsonEditor | JsonEditor}.\n * @public\n */\nexport type ArrayMergeBehavior = 'append' | 'replace';\n\n/**\n * Merge options for a {@link JsonEditor | JsonEditor}.\n * @public\n */\nexport interface IJsonEditorMergeOptions {\n  /**\n   * Controls how arrays are merged when combining JSON values.\n   * - `'append'` (default): Existing array elements are preserved and new elements are appended\n   * - `'replace'`: Existing array is completely replaced with the new array\n   */\n  arrayMergeBehavior: ArrayMergeBehavior;\n}\n\n/**\n * Validation options for a {@link JsonEditor | JsonEditor}.\n * @public\n */\nexport interface IJsonEditorValidationOptions {\n  /**\n   * If `onInvalidPropertyName` is `'error'` (default) then any property name\n   * that is invalid after template rendering causes an error and stops\n   * conversion.  If `onInvalidPropertyName` is `'ignore'`, then names which\n   * are invalid after template rendering are passed through unchanged.\n   */\n  onInvalidPropertyName: 'error' | 'ignore';\n\n  /**\n   * If `onInvalidPropertyValue` is `'error'` (default) then any illegal\n   * property value other than `undefined` causes an error and stops\n   * conversion.  If `onInvalidPropertyValue` is `'ignore'` then any\n   * invalid property values are silently ignored.\n   */\n  onInvalidPropertyValue: 'error' | 'ignore';\n\n  /**\n   * If `onUndefinedPropertyValue` is `'error'`, then any property with\n   * value `undefined` will cause an error and stop conversion.  If\n   * `onUndefinedPropertyValue` is `'ignore'` (default) then any\n   * property with value `undefined` is silently ignored.\n   */\n  onUndefinedPropertyValue: 'error' | 'ignore';\n}\n\n/**\n * Initialization options for a {@link JsonEditor | JsonEditor}.\n * @public\n */\nexport interface IJsonEditorOptions {\n  context?: IJsonContext;\n  validation: IJsonEditorValidationOptions;\n  merge?: IJsonEditorMergeOptions;\n}\n\n/**\n * A specialized JSON editor which does a deep clone of a supplied `JsonValue`.\n * @public\n */\nexport interface IJsonCloneEditor {\n  /**\n   * Returns a deep clone of a supplied `JsonValue`.\n   * @param src - The `JsonValue` to be cloned.\n   * @param context - An optional {@link IJsonContext | JSON context} used for clone\n   * conversion operations.\n   */\n  clone(src: JsonValue, context?: IJsonContext): DetailedResult<JsonValue, JsonEditFailureReason>;\n}\n"]}

package/lib/packlets/editor/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/editor/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,WAAW,MAAM,SAAS,CAAC;AAEvC,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,qCAAqC,EACrC,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,CAAC"}