@fgv/ts-json 3.0.1-alpha.5 → 4.0.0

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

@@ -1,8 +1,8 @@
 import * as EditorRules from './rules';
 export * from './common';
 export { JsonEditor } from './jsonEditor';
-export { IJsonEditorRule } from './jsonEditorRule';
+export { IJsonEditorRule, JsonEditorRuleBase } from './jsonEditorRule';
 export { JsonEditorState } from './jsonEditorState';
-export { IReferenceMapKeyPolicyValidateOptions, PrefixedJsonMap, ReferenceMapKeyPolicy, SimpleJsonMap } from './jsonReferenceMap';
+export { IReferenceMapKeyPolicyValidateOptions, ISimpleJsonMapOptions, PrefixedJsonMap, ReferenceMapKeyPolicy, SimpleJsonMap } from './jsonReferenceMap';
 export { EditorRules };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"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,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,qCAAqC,EACrC,eAAe,EACf,qBAAqB,EACrB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"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"}

package/lib/packlets/editor/index.js

@@ -47,12 +47,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EditorRules = exports.SimpleJsonMap = exports.ReferenceMapKeyPolicy = exports.PrefixedJsonMap = exports.JsonEditorState = exports.JsonEditor = void 0;
+exports.EditorRules = exports.SimpleJsonMap = exports.ReferenceMapKeyPolicy = exports.PrefixedJsonMap = exports.JsonEditorState = exports.JsonEditorRuleBase = exports.JsonEditor = void 0;
 const EditorRules = __importStar(require("./rules"));
 exports.EditorRules = EditorRules;
 __exportStar(require("./common"), exports);
 var jsonEditor_1 = require("./jsonEditor");
 Object.defineProperty(exports, "JsonEditor", { enumerable: true, get: function () { return jsonEditor_1.JsonEditor; } });
+var jsonEditorRule_1 = require("./jsonEditorRule");
+Object.defineProperty(exports, "JsonEditorRuleBase", { enumerable: true, get: function () { return jsonEditorRule_1.JsonEditorRuleBase; } });
 var jsonEditorState_1 = require("./jsonEditorState");
 Object.defineProperty(exports, "JsonEditorState", { enumerable: true, get: function () { return jsonEditorState_1.JsonEditorState; } });
 var jsonReferenceMap_1 = require("./jsonReferenceMap");

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/editor/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,qDAAuC;AAY9B,kCAAW;AAVpB,2CAAyB;AACzB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAEnB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,uDAK4B;AAH1B,mHAAA,eAAe,OAAA;AACf,yHAAA,qBAAqB,OAAA;AACrB,iHAAA,aAAa,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\nimport * as EditorRules from './rules';\n\nexport * from './common';\nexport { JsonEditor } from './jsonEditor';\nexport { IJsonEditorRule } from './jsonEditorRule';\nexport { JsonEditorState } from './jsonEditorState';\nexport {\n  IReferenceMapKeyPolicyValidateOptions,\n  PrefixedJsonMap,\n  ReferenceMapKeyPolicy,\n  SimpleJsonMap\n} from './jsonReferenceMap';\nexport { EditorRules };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/editor/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,qDAAuC;AAa9B,kCAAW;AAXpB,2CAAyB;AACzB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,mDAAuE;AAA7C,oHAAA,kBAAkB,OAAA;AAC5C,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,uDAM4B;AAH1B,mHAAA,eAAe,OAAA;AACf,yHAAA,qBAAqB,OAAA;AACrB,iHAAA,aAAa,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\nimport * as EditorRules from './rules';\n\nexport * from './common';\nexport { JsonEditor } from './jsonEditor';\nexport { IJsonEditorRule, JsonEditorRuleBase } from './jsonEditorRule';\nexport { JsonEditorState } from './jsonEditorState';\nexport {\n  IReferenceMapKeyPolicyValidateOptions,\n  ISimpleJsonMapOptions,\n  PrefixedJsonMap,\n  ReferenceMapKeyPolicy,\n  SimpleJsonMap\n} from './jsonReferenceMap';\nexport { EditorRules };\n"]}

package/lib/packlets/editor/jsonEditor.d.ts

@@ -12,48 +12,48 @@ import { JsonEditorState } from './jsonEditorState';
  */
 export declare class JsonEditor implements IJsonCloneEditor {
     /**
-     * Default singleton {@link Editor.JsonEditor | JsonEditor}.
+     * Default singleton {@link JsonEditor | JsonEditor}.
      * @internal
      */
     protected static _default?: JsonEditor;
     /**
-     * Full set of {@link Editor.IJsonEditorOptions | editor options} in effect for this editor.
+     * Full set of {@link IJsonEditorOptions | editor options} in effect for this editor.
      */
     options: IJsonEditorOptions;
     /**
-     * The set of {@link Editor.IJsonEditorRule | editor rules} applied by this editor.
+     * The set of {@link IJsonEditorRule | editor rules} applied by this editor.
      * @internal
      */
     protected _rules: IJsonEditorRule[];
     /**
-     * Protected constructor for {@link Editor.JsonEditor | JsonEditor} and derived classes.
-     * External consumers should instantiate via the {@link Editor.JsonEditor.create | create static method}.
-     * @param options - Optional partial {@link Editor.IJsonEditorOptions | editor options} for the
+     * Protected constructor for {@link JsonEditor | JsonEditor} and derived classes.
+     * External consumers should instantiate via the {@link JsonEditor.create | create static method}.
+     * @param options - Optional partial {@link IJsonEditorOptions | editor options} for the
      * constructed editor.
-     * @param rules - Any {@link Editor.IJsonEditorRule | editor rules} to be applied by the editor.
+     * @param rules - Any {@link IJsonEditorRule | editor rules} to be applied by the editor.
      * @internal
      */
     protected constructor(options?: Partial<IJsonEditorOptions>, rules?: IJsonEditorRule[]);
     /**
-     * Default singleton {@link Editor.JsonEditor | JsonEditor} for simple use. Applies all rules
+     * Default singleton {@link JsonEditor | JsonEditor} for simple use. Applies all rules
      * but with no default context.
      */
     static get default(): JsonEditor;
     /**
-     * Constructs a new {@link Editor.JsonEditor | JsonEditor}.
-     * @param options - Optional partial {@link Editor.IJsonEditorOptions | editor options} for the
+     * Constructs a new {@link JsonEditor | JsonEditor}.
+     * @param options - Optional partial {@link IJsonEditorOptions | editor options} for the
      * constructed editor.
-     * @param rules - Optional set of {@link Editor.IJsonEditorRule | editor rules} to be applied by the editor.
-     * @readonly A new {@link Editor.JsonEditor | JsonEditor}.
+     * @param rules - Optional set of {@link IJsonEditorRule | editor rules} to be applied by the editor.
+     * @readonly A new {@link JsonEditor | JsonEditor}.
      */
     static create(options?: Partial<IJsonEditorOptions>, rules?: IJsonEditorRule[]): Result<JsonEditor>;
     /**
      * Gets the default set of rules to be applied for a given set of options.
      * By default, all available rules (templates, conditionals, multi-value and references)
      * are applied.
-     * @param options - Optional partial {@link Editor.IJsonEditorOptions | editor options} for
+     * @param options - Optional partial {@link IJsonEditorOptions | editor options} for
      * all rules.
-     * @returns Default {@link Editor.IJsonEditorRule | editor rules} with any supplied options
+     * @returns Default {@link IJsonEditorRule | editor rules} with any supplied options
      * applied.
      */
     static getDefaultRules(options?: IJsonEditorOptions): Result<IJsonEditorRule[]>;
@@ -63,21 +63,21 @@ export declare class JsonEditor implements IJsonCloneEditor {
     protected static _getDefaultOptions(options?: Partial<IJsonEditorOptions>): Result<IJsonEditorOptions>;
     /**
      * Merges a supplied source object into a supplied target, updating the target object.
-     * @param target - The target {@link JsonObject | object} to be updated
-     * @param src - The source {@link JsonObject | object} to be merged
+     * @param target - The target `JsonObject` to be updated
+     * @param src - The source `JsonObject` to be merged
      * @param runtimeContext - An optional {@link IJsonContext | IJsonContext} supplying variables
      * and references.
-     * @returns `Success` with the original source {@link JsonObject | object} if merge was successful.
+     * @returns `Success` with the original source `JsonObject` if merge was successful.
      * Returns `Failure` with details if an error occurs.
      */
     mergeObjectInPlace(target: JsonObject, src: JsonObject, runtimeContext?: IJsonContext): Result<JsonObject>;
     /**
      * Merges multiple supplied source objects into a supplied target, updating the target
      * object and using the default context supplied at creation time.
-     * @param target - The target {@link JsonObject | object} to be updated
-     * @param srcObjects - {@link JsonObject | Objects} to be merged into the target object, in the order
+     * @param target - The target `JsonObject` to be updated
+     * @param srcObjects - `JsonObject`s to be merged into the target object, in the order
      * supplied.
-     * @returns `Success` with the original source {@link JsonObject | object} if merge was successful.
+     * @returns `Success` with the original source `JsonObject` if merge was successful.
      * Returns `Failure` with details if an error occurs.
      */
     mergeObjectsInPlace(target: JsonObject, srcObjects: JsonObject[]): Result<JsonObject>;
@@ -86,16 +86,16 @@ export declare class JsonEditor implements IJsonCloneEditor {
      * object and using an optional {@link IJsonContext | context} supplied in the call.
      * @param context - An optional {@link IJsonContext | IJsonContext} supplying variables and
      * references.
-     * @param base - The base {@link JsonObject | object} to be updated
+     * @param base - The base `JsonObject` to be updated
      * @param srcObjects - Objects to be merged into the target object, in the order supplied.
-     * @returns `Success` with the original source {@link JsonObject | object} if merge was successful.
+     * @returns `Success` with the original source `JsonObject` if merge was successful.
      * Returns `Failure` with details if an error occurs.
      */
     mergeObjectsInPlaceWithContext(context: IJsonContext | undefined, base: JsonObject, srcObjects: JsonObject[]): Result<JsonObject>;
     /**
-     * Deep clones a supplied {@link JsonValue | JSON value}, applying all editor rules and a default
+     * Deep clones a supplied `JsonValue`, applying all editor rules and a default
      * or optionally supplied context
-     * @param src - The {@link JsonValue | JsonValue} to be cloned.
+     * @param src - The `JsonValue` to be cloned.
      * @param context - An optional {@link IJsonContext | JSON context} supplying variables and references.
      */
     clone(src: JsonValue, context?: IJsonContext): DetailedResult<JsonValue, JsonEditFailureReason>;

package/lib/packlets/editor/jsonEditor.js

@@ -34,11 +34,11 @@ const jsonEditorState_1 = require("./jsonEditorState");
  */
 class JsonEditor {
     /**
-     * Protected constructor for {@link Editor.JsonEditor | JsonEditor} and derived classes.
-     * External consumers should instantiate via the {@link Editor.JsonEditor.create | create static method}.
-     * @param options - Optional partial {@link Editor.IJsonEditorOptions | editor options} for the
+     * Protected constructor for {@link JsonEditor | JsonEditor} and derived classes.
+     * External consumers should instantiate via the {@link JsonEditor.create | create static method}.
+     * @param options - Optional partial {@link IJsonEditorOptions | editor options} for the
      * constructed editor.
-     * @param rules - Any {@link Editor.IJsonEditorRule | editor rules} to be applied by the editor.
+     * @param rules - Any {@link IJsonEditorRule | editor rules} to be applied by the editor.
      * @internal
      */
     constructor(options, rules) {
@@ -46,7 +46,7 @@ class JsonEditor {
         this._rules = rules || JsonEditor.getDefaultRules(this.options).orThrow();
     }
     /**
-     * Default singleton {@link Editor.JsonEditor | JsonEditor} for simple use. Applies all rules
+     * Default singleton {@link JsonEditor | JsonEditor} for simple use. Applies all rules
      * but with no default context.
      */
     static get default() {
@@ -57,11 +57,11 @@ class JsonEditor {
         return JsonEditor._default;
     }
     /**
-     * Constructs a new {@link Editor.JsonEditor | JsonEditor}.
-     * @param options - Optional partial {@link Editor.IJsonEditorOptions | editor options} for the
+     * Constructs a new {@link JsonEditor | JsonEditor}.
+     * @param options - Optional partial {@link IJsonEditorOptions | editor options} for the
      * constructed editor.
-     * @param rules - Optional set of {@link Editor.IJsonEditorRule | editor rules} to be applied by the editor.
-     * @readonly A new {@link Editor.JsonEditor | JsonEditor}.
+     * @param rules - Optional set of {@link IJsonEditorRule | editor rules} to be applied by the editor.
+     * @readonly A new {@link JsonEditor | JsonEditor}.
      */
     static create(options, rules) {
         return (0, ts_utils_1.captureResult)(() => new JsonEditor(options, rules));
@@ -70,9 +70,9 @@ class JsonEditor {
      * Gets the default set of rules to be applied for a given set of options.
      * By default, all available rules (templates, conditionals, multi-value and references)
      * are applied.
-     * @param options - Optional partial {@link Editor.IJsonEditorOptions | editor options} for
+     * @param options - Optional partial {@link IJsonEditorOptions | editor options} for
      * all rules.
-     * @returns Default {@link Editor.IJsonEditorRule | editor rules} with any supplied options
+     * @returns Default {@link IJsonEditorRule | editor rules} with any supplied options
      * applied.
      */
     static getDefaultRules(options) {
@@ -100,11 +100,11 @@ class JsonEditor {
     }
     /**
      * Merges a supplied source object into a supplied target, updating the target object.
-     * @param target - The target {@link JsonObject | object} to be updated
-     * @param src - The source {@link JsonObject | object} to be merged
+     * @param target - The target `JsonObject` to be updated
+     * @param src - The source `JsonObject` to be merged
      * @param runtimeContext - An optional {@link IJsonContext | IJsonContext} supplying variables
      * and references.
-     * @returns `Success` with the original source {@link JsonObject | object} if merge was successful.
+     * @returns `Success` with the original source `JsonObject` if merge was successful.
      * Returns `Failure` with details if an error occurs.
      */
     mergeObjectInPlace(target, src, runtimeContext) {
@@ -116,10 +116,10 @@ class JsonEditor {
     /**
      * Merges multiple supplied source objects into a supplied target, updating the target
      * object and using the default context supplied at creation time.
-     * @param target - The target {@link JsonObject | object} to be updated
-     * @param srcObjects - {@link JsonObject | Objects} to be merged into the target object, in the order
+     * @param target - The target `JsonObject` to be updated
+     * @param srcObjects - `JsonObject`s to be merged into the target object, in the order
      * supplied.
-     * @returns `Success` with the original source {@link JsonObject | object} if merge was successful.
+     * @returns `Success` with the original source `JsonObject` if merge was successful.
      * Returns `Failure` with details if an error occurs.
      */
     mergeObjectsInPlace(target, srcObjects) {
@@ -130,9 +130,9 @@ class JsonEditor {
      * object and using an optional {@link IJsonContext | context} supplied in the call.
      * @param context - An optional {@link IJsonContext | IJsonContext} supplying variables and
      * references.
-     * @param base - The base {@link JsonObject | object} to be updated
+     * @param base - The base `JsonObject` to be updated
      * @param srcObjects - Objects to be merged into the target object, in the order supplied.
-     * @returns `Success` with the original source {@link JsonObject | object} if merge was successful.
+     * @returns `Success` with the original source `JsonObject` if merge was successful.
      * Returns `Failure` with details if an error occurs.
      */
     mergeObjectsInPlaceWithContext(context, base, srcObjects) {
@@ -145,9 +145,9 @@ class JsonEditor {
         return (0, ts_utils_1.succeedWithDetail)(base);
     }
     /**
-     * Deep clones a supplied {@link JsonValue | JSON value}, applying all editor rules and a default
+     * Deep clones a supplied `JsonValue`, applying all editor rules and a default
      * or optionally supplied context
-     * @param src - The {@link JsonValue | JsonValue} to be cloned.
+     * @param src - The `JsonValue` to be cloned.
      * @param context - An optional {@link IJsonContext | JSON context} supplying variables and references.
      */
     clone(src, context) {

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

@@ -1 +1 @@
-{"version":3,"file":"jsonEditor.js","sourceRoot":"","sources":["../../../src/packlets/editor/jsonEditor.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 {\n  DetailedResult,\n  Result,\n  captureResult,\n  fail,\n  failWithDetail,\n  mapDetailedResults,\n  mapResults,\n  succeed,\n  succeedWithDetail\n} from '@fgv/ts-utils';\nimport {\n  ConditionalJsonEditorRule,\n  MultiValueJsonEditorRule,\n  ReferenceJsonEditorRule,\n  TemplatedJsonEditorRule\n} from './rules';\n\nimport {\n  JsonArray,\n  JsonObject,\n  JsonValue,\n  isJsonArray,\n  isJsonObject,\n  isJsonPrimitive\n} from '@fgv/ts-json-base';\nimport { IJsonContext } from '../context';\nimport {\n  IJsonCloneEditor,\n  IJsonEditorOptions,\n  IJsonEditorValidationOptions,\n  JsonEditFailureReason,\n  JsonPropertyEditFailureReason\n} from './common';\n\nimport { IJsonEditorRule } from './jsonEditorRule';\nimport { JsonEditorState } from './jsonEditorState';\n\n/**\n * A {@link JsonEditor | JsonEditor} can be used to edit JSON objects in place or to\n * clone any JSON value, applying a default context and optional set of editor rules that\n * were supplied at initialization.\n * @public\n */\nexport class JsonEditor implements IJsonCloneEditor {\n  /**\n   * Default singleton {@link Editor.JsonEditor | JsonEditor}.\n   * @internal\n   */\n  protected static _default?: JsonEditor;\n\n  /**\n   * Full set of {@link Editor.IJsonEditorOptions | editor options} in effect for this editor.\n   */\n  public options: IJsonEditorOptions;\n\n  /**\n   * The set of {@link Editor.IJsonEditorRule | editor rules} applied by this editor.\n   * @internal\n   */\n  protected _rules: IJsonEditorRule[];\n\n  /**\n   * Protected constructor for {@link Editor.JsonEditor | JsonEditor} and derived classes.\n   * External consumers should instantiate via the {@link Editor.JsonEditor.create | create static method}.\n   * @param options - Optional partial {@link Editor.IJsonEditorOptions | editor options} for the\n   * constructed editor.\n   * @param rules - Any {@link Editor.IJsonEditorRule | editor rules} to be applied by the editor.\n   * @internal\n   */\n  protected constructor(options?: Partial<IJsonEditorOptions>, rules?: IJsonEditorRule[]) {\n    this.options = JsonEditor._getDefaultOptions(options).orThrow();\n    this._rules = rules || JsonEditor.getDefaultRules(this.options).orThrow();\n  }\n\n  /**\n   * Default singleton {@link Editor.JsonEditor | JsonEditor} for simple use. Applies all rules\n   * but with no default context.\n   */\n  public static get default(): JsonEditor {\n    if (!JsonEditor._default) {\n      const rules = this.getDefaultRules().orDefault();\n      JsonEditor._default = new JsonEditor(undefined, rules);\n    }\n    return JsonEditor._default;\n  }\n\n  /**\n   * Constructs a new {@link Editor.JsonEditor | JsonEditor}.\n   * @param options - Optional partial {@link Editor.IJsonEditorOptions | editor options} for the\n   * constructed editor.\n   * @param rules - Optional set of {@link Editor.IJsonEditorRule | editor rules} to be applied by the editor.\n   * @readonly A new {@link Editor.JsonEditor | JsonEditor}.\n   */\n  public static create(options?: Partial<IJsonEditorOptions>, rules?: IJsonEditorRule[]): Result<JsonEditor> {\n    return captureResult(() => new JsonEditor(options, rules));\n  }\n\n  /**\n   * Gets the default set of rules to be applied for a given set of options.\n   * By default, all available rules (templates, conditionals, multi-value and references)\n   * are applied.\n   * @param options - Optional partial {@link Editor.IJsonEditorOptions | editor options} for\n   * all rules.\n   * @returns Default {@link Editor.IJsonEditorRule | editor rules} with any supplied options\n   * applied.\n   */\n  public static getDefaultRules(options?: IJsonEditorOptions): Result<IJsonEditorRule[]> {\n    return mapResults<IJsonEditorRule>([\n      TemplatedJsonEditorRule.create(options),\n      ConditionalJsonEditorRule.create(options),\n      MultiValueJsonEditorRule.create(options),\n      ReferenceJsonEditorRule.create(options)\n    ]);\n  }\n\n  /**\n   * @internal\n   */\n  protected static _getDefaultOptions(options?: Partial<IJsonEditorOptions>): Result<IJsonEditorOptions> {\n    const context: IJsonContext | undefined = options?.context;\n    let validation: IJsonEditorValidationOptions | undefined = options?.validation;\n    if (validation === undefined) {\n      validation = {\n        onInvalidPropertyName: 'error',\n        onInvalidPropertyValue: 'error',\n        onUndefinedPropertyValue: 'ignore'\n      };\n    }\n    return succeed({ context, validation });\n  }\n\n  /**\n   * Merges a supplied source object into a supplied target, updating the target object.\n   * @param target - The target {@link JsonObject | object} to be updated\n   * @param src - The source {@link JsonObject | object} to be merged\n   * @param runtimeContext - An optional {@link IJsonContext | IJsonContext} supplying variables\n   * and references.\n   * @returns `Success` with the original source {@link JsonObject | object} if merge was successful.\n   * Returns `Failure` with details if an error occurs.\n   */\n  public mergeObjectInPlace(\n    target: JsonObject,\n    src: JsonObject,\n    runtimeContext?: IJsonContext\n  ): Result<JsonObject> {\n    const state = new JsonEditorState(this, this.options, runtimeContext);\n    return this._mergeObjectInPlace(target, src, state).onSuccess((merged) => {\n      return this._finalizeAndMerge(merged, state);\n    });\n  }\n\n  /**\n   * Merges multiple supplied source objects into a supplied target, updating the target\n   * object and using the default context supplied at creation time.\n   * @param target - The target {@link JsonObject | object} to be updated\n   * @param srcObjects - {@link JsonObject | Objects} to be merged into the target object, in the order\n   * supplied.\n   * @returns `Success` with the original source {@link JsonObject | object} if merge was successful.\n   * Returns `Failure` with details if an error occurs.\n   */\n  public mergeObjectsInPlace(target: JsonObject, srcObjects: JsonObject[]): Result<JsonObject> {\n    return this.mergeObjectsInPlaceWithContext(this.options.context, target, srcObjects);\n  }\n\n  /**\n   * Merges multiple supplied source objects into a supplied target, updating the target\n   * object and using an optional {@link IJsonContext | context} supplied in the call.\n   * @param context - An optional {@link IJsonContext | IJsonContext} supplying variables and\n   * references.\n   * @param base - The base {@link JsonObject | object} to be updated\n   * @param srcObjects - Objects to be merged into the target object, in the order supplied.\n   * @returns `Success` with the original source {@link JsonObject | object} if merge was successful.\n   * Returns `Failure` with details if an error occurs.\n   */\n  public mergeObjectsInPlaceWithContext(\n    context: IJsonContext | undefined,\n    base: JsonObject,\n    srcObjects: JsonObject[]\n  ): Result<JsonObject> {\n    for (const src of srcObjects) {\n      const mergeResult = this.mergeObjectInPlace(base, src, context);\n      if (mergeResult.isFailure()) {\n        return mergeResult.withFailureDetail('error');\n      }\n    }\n    return succeedWithDetail(base);\n  }\n\n  /**\n   * Deep clones a supplied {@link JsonValue | JSON value}, applying all editor rules and a default\n   * or optionally supplied context\n   * @param src - The {@link JsonValue | JsonValue} to be cloned.\n   * @param context - An optional {@link IJsonContext | JSON context} supplying variables and references.\n   */\n  public clone(src: JsonValue, context?: IJsonContext): DetailedResult<JsonValue, JsonEditFailureReason> {\n    const state = new JsonEditorState(this, this.options, context);\n    let value = src;\n    let valueResult = this._editValue(src, state);\n\n    while (valueResult.isSuccess()) {\n      value = valueResult.value;\n      valueResult = this._editValue(value, state);\n    }\n\n    if (valueResult.detail === 'error' || valueResult.detail === 'ignore') {\n      return valueResult;\n    }\n\n    if (isJsonPrimitive(value) || value === null) {\n      return succeedWithDetail(value, 'edited');\n    } else if (isJsonObject(value)) {\n      return this.mergeObjectInPlace({}, value, state.context).withFailureDetail('error');\n    } else if (isJsonArray(value)) {\n      return this._cloneArray(value, state.context);\n    } else if (value === undefined) {\n      return state.failValidation('undefinedPropertyValue');\n    }\n    return state.failValidation(\n      'invalidPropertyValue',\n      `Cannot convert invalid JSON: \"${JSON.stringify(value)}\"`\n    );\n  }\n\n  /**\n   *\n   * @param target -\n   * @param src -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _mergeObjectInPlace(\n    target: JsonObject,\n    src: JsonObject,\n    state: JsonEditorState\n  ): Result<JsonObject> {\n    for (const key in src) {\n      if (src.hasOwnProperty(key)) {\n        const propResult = this._editProperty(key, src[key], state);\n        if (propResult.isSuccess()) {\n          if (propResult.detail === 'deferred') {\n            state.defer(propResult.value);\n          } else {\n            const mergeResult = this._mergeObjectInPlace(target, propResult.value, state);\n            if (mergeResult.isFailure()) {\n              return mergeResult;\n            }\n          }\n        } else if (propResult.detail === 'inapplicable') {\n          const valueResult = this.clone(src[key], state.context).onSuccess((cloned) => {\n            return this._mergeClonedProperty(target, key, cloned, state);\n          });\n\n          if (valueResult.isFailure() && valueResult.detail === 'error') {\n            return fail(`${key}: ${valueResult.message}`);\n          }\n        } else if (propResult.detail !== 'ignore') {\n          return fail(`${key}: ${propResult.message}`);\n        }\n      } else {\n        return fail(`${key}: Cannot merge inherited properties`);\n      }\n    }\n    return succeed(target);\n  }\n\n  /**\n   *\n   * @param src -\n   * @param context -\n   * @returns\n   * @internal\n   */\n  protected _cloneArray(\n    src: JsonArray,\n    context?: IJsonContext\n  ): DetailedResult<JsonArray, JsonEditFailureReason> {\n    const results = src.map((v) => {\n      return this.clone(v, context);\n    });\n\n    return mapDetailedResults<JsonValue, JsonEditFailureReason>(results, ['ignore'])\n      .onSuccess((converted) => {\n        return succeed(converted);\n      })\n      .withFailureDetail('error');\n  }\n\n  /**\n   *\n   * @param target -\n   * @param key -\n   * @param newValue -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _mergeClonedProperty(\n    target: JsonObject,\n    key: string,\n    newValue: JsonValue,\n    state: JsonEditorState\n  ): DetailedResult<JsonValue, JsonEditFailureReason> {\n    const existing = target[key];\n\n    // merge is called right after clone so this should never happen\n    // since clone itself will have failed\n\n    if (isJsonPrimitive(newValue)) {\n      target[key] = newValue;\n      return succeedWithDetail(newValue, 'edited');\n    }\n\n    if (isJsonObject(newValue)) {\n      if (isJsonObject(existing)) {\n        return this.mergeObjectInPlace(existing, newValue, state.context).withFailureDetail('error');\n      }\n      target[key] = newValue;\n      return succeedWithDetail(newValue, 'edited');\n    }\n\n    /* c8 ignore else */\n    if (isJsonArray(newValue)) {\n      if (isJsonArray(existing)) {\n        target[key] = existing.concat(...newValue);\n        return succeedWithDetail(target[key], 'edited');\n      }\n      target[key] = newValue;\n      return succeedWithDetail(newValue, 'edited');\n    }\n    /* c8 ignore start */\n    return failWithDetail(`Invalid JSON: ${JSON.stringify(newValue)}`, 'error');\n  } /* c8 ignore stop */\n\n  /**\n   *\n   * @param key -\n   * @param value -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _editProperty(\n    key: string,\n    value: JsonValue,\n    state: JsonEditorState\n  ): DetailedResult<JsonObject, JsonPropertyEditFailureReason> {\n    for (const rule of this._rules) {\n      const ruleResult = rule.editProperty(key, value, state);\n      if (ruleResult.isSuccess() || ruleResult.detail !== 'inapplicable') {\n        return ruleResult;\n      }\n    }\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n\n  /**\n   *\n   * @param value -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _editValue(\n    value: JsonValue,\n    state: JsonEditorState\n  ): DetailedResult<JsonValue, JsonEditFailureReason> {\n    for (const rule of this._rules) {\n      const ruleResult = rule.editValue(value, state);\n      if (ruleResult.isSuccess() || ruleResult.detail !== 'inapplicable') {\n        return ruleResult;\n      }\n    }\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n\n  /**\n   *\n   * @param target -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _finalizeAndMerge(\n    target: JsonObject,\n    state: JsonEditorState\n  ): DetailedResult<JsonObject, JsonEditFailureReason> {\n    const deferred = state.deferred;\n    if (deferred.length > 0) {\n      for (const rule of this._rules) {\n        const ruleResult = rule.finalizeProperties(deferred, state);\n        if (ruleResult.isSuccess()) {\n          return this.mergeObjectsInPlaceWithContext(\n            state.context,\n            target,\n            ruleResult.value\n          ).withFailureDetail('error');\n        } else if (ruleResult.detail === 'ignore') {\n          succeedWithDetail(target, 'edited');\n        } else if (ruleResult.detail !== 'inapplicable') {\n          return failWithDetail(ruleResult.message, ruleResult.detail);\n        }\n      }\n    }\n    return succeedWithDetail(target, 'edited');\n  }\n}\n"]}
+{"version":3,"file":"jsonEditor.js","sourceRoot":"","sources":["../../../src/packlets/editor/jsonEditor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAUuB;AACvB,mCAKiB;AAEjB,oDAO2B;AAW3B,uDAAoD;AAEpD;;;;;GAKG;AACH,MAAa,UAAU;IAkBrB;;;;;;;OAOG;IACH,YAAsB,OAAqC,EAAE,KAAyB;QACpF,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACI,MAAM,KAAK,OAAO;QACvB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,SAAS,EAAE,CAAC;YACjD,UAAU,CAAC,QAAQ,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,OAAqC,EAAE,KAAyB;QACnF,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,eAAe,CAAC,OAA4B;QACxD,OAAO,IAAA,qBAAU,EAAkB;YACjC,+BAAuB,CAAC,MAAM,CAAC,OAAO,CAAC;YACvC,iCAAyB,CAAC,MAAM,CAAC,OAAO,CAAC;YACzC,gCAAwB,CAAC,MAAM,CAAC,OAAO,CAAC;YACxC,+BAAuB,CAAC,MAAM,CAAC,OAAO,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,MAAM,CAAC,kBAAkB,CAAC,OAAqC;QACvE,MAAM,OAAO,GAA6B,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAC;QAC3D,IAAI,UAAU,GAA6C,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,CAAC;QAC/E,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,UAAU,GAAG;gBACX,qBAAqB,EAAE,OAAO;gBAC9B,sBAAsB,EAAE,OAAO;gBAC/B,wBAAwB,EAAE,QAAQ;aACnC,CAAC;QACJ,CAAC;QACD,OAAO,IAAA,kBAAO,EAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACI,kBAAkB,CACvB,MAAkB,EAClB,GAAe,EACf,cAA6B;QAE7B,MAAM,KAAK,GAAG,IAAI,iCAAe,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YACvE,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACI,mBAAmB,CAAC,MAAkB,EAAE,UAAwB;QACrE,OAAO,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACvF,CAAC;IAED;;;;;;;;;OASG;IACI,8BAA8B,CACnC,OAAiC,EACjC,IAAgB,EAChB,UAAwB;QAExB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YAChE,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC5B,OAAO,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,OAAO,IAAA,4BAAiB,EAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,GAAc,EAAE,OAAsB;QACjD,MAAM,KAAK,GAAG,IAAI,iCAAe,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,KAAK,GAAG,GAAG,CAAC;QAChB,IAAI,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE9C,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/B,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;YAC1B,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,KAAK,OAAO,IAAI,WAAW,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtE,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,IAAI,IAAA,8BAAe,EAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC7C,OAAO,IAAA,4BAAiB,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAA,2BAAY,EAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACtF,CAAC;aAAM,IAAI,IAAA,0BAAW,EAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;aAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,KAAK,CAAC,cAAc,CACzB,sBAAsB,EACtB,iCAAiC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAC1D,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACO,mBAAmB,CAC3B,MAAkB,EAClB,GAAe,EACf,KAAsB;QAEtB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC5D,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC3B,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;wBACrC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;oBAChC,CAAC;yBAAM,CAAC;wBACN,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;wBAC9E,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;4BAC5B,OAAO,WAAW,CAAC;wBACrB,CAAC;oBACH,CAAC;gBACH,CAAC;qBAAM,IAAI,UAAU,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;oBAChD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;wBAC3E,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;oBAC/D,CAAC,CAAC,CAAC;oBAEH,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,WAAW,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;wBAC9D,OAAO,IAAA,eAAI,EAAC,GAAG,GAAG,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;oBAChD,CAAC;gBACH,CAAC;qBAAM,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC1C,OAAO,IAAA,eAAI,EAAC,GAAG,GAAG,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAA,eAAI,EAAC,GAAG,GAAG,qCAAqC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QACD,OAAO,IAAA,kBAAO,EAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACO,WAAW,CACnB,GAAc,EACd,OAAsB;QAEtB,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,OAAO,IAAA,6BAAkB,EAAmC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;aAC7E,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YACvB,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;QAC5B,CAAC,CAAC;aACD,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACO,oBAAoB,CAC5B,MAAkB,EAClB,GAAW,EACX,QAAmB,EACnB,KAAsB;QAEtB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAE7B,gEAAgE;QAChE,sCAAsC;QAEtC,IAAI,IAAA,8BAAe,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YACvB,OAAO,IAAA,4BAAiB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,IAAA,2BAAY,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,IAAI,IAAA,2BAAY,EAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC/F,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YACvB,OAAO,IAAA,4BAAiB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QAED,oBAAoB;QACpB,IAAI,IAAA,0BAAW,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,IAAI,IAAA,0BAAW,EAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC;gBAC3C,OAAO,IAAA,4BAAiB,EAAC,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YACvB,OAAO,IAAA,4BAAiB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QACD,qBAAqB;QACrB,OAAO,IAAA,yBAAc,EAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC,CAAC,oBAAoB;IAEtB;;;;;;;OAOG;IACO,aAAa,CACrB,GAAW,EACX,KAAgB,EAChB,KAAsB;QAEtB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACxD,IAAI,UAAU,CAAC,SAAS,EAAE,IAAI,UAAU,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;gBACnE,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;OAMG;IACO,UAAU,CAClB,KAAgB,EAChB,KAAsB;QAEtB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,UAAU,CAAC,SAAS,EAAE,IAAI,UAAU,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;gBACnE,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;OAMG;IACO,iBAAiB,CACzB,MAAkB,EAClB,KAAsB;QAEtB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC5D,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC3B,OAAO,IAAI,CAAC,8BAA8B,CACxC,KAAK,CAAC,OAAO,EACb,MAAM,EACN,UAAU,CAAC,KAAK,CACjB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBAC/B,CAAC;qBAAM,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC1C,IAAA,4BAAiB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACtC,CAAC;qBAAM,IAAI,UAAU,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;oBAChD,OAAO,IAAA,yBAAc,EAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAA,4BAAiB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF;AA3WD,gCA2WC","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 {\n  DetailedResult,\n  Result,\n  captureResult,\n  fail,\n  failWithDetail,\n  mapDetailedResults,\n  mapResults,\n  succeed,\n  succeedWithDetail\n} from '@fgv/ts-utils';\nimport {\n  ConditionalJsonEditorRule,\n  MultiValueJsonEditorRule,\n  ReferenceJsonEditorRule,\n  TemplatedJsonEditorRule\n} from './rules';\n\nimport {\n  JsonArray,\n  JsonObject,\n  JsonValue,\n  isJsonArray,\n  isJsonObject,\n  isJsonPrimitive\n} from '@fgv/ts-json-base';\nimport { IJsonContext } from '../context';\nimport {\n  IJsonCloneEditor,\n  IJsonEditorOptions,\n  IJsonEditorValidationOptions,\n  JsonEditFailureReason,\n  JsonPropertyEditFailureReason\n} from './common';\n\nimport { IJsonEditorRule } from './jsonEditorRule';\nimport { JsonEditorState } from './jsonEditorState';\n\n/**\n * A {@link JsonEditor | JsonEditor} can be used to edit JSON objects in place or to\n * clone any JSON value, applying a default context and optional set of editor rules that\n * were supplied at initialization.\n * @public\n */\nexport class JsonEditor implements IJsonCloneEditor {\n  /**\n   * Default singleton {@link JsonEditor | JsonEditor}.\n   * @internal\n   */\n  protected static _default?: JsonEditor;\n\n  /**\n   * Full set of {@link IJsonEditorOptions | editor options} in effect for this editor.\n   */\n  public options: IJsonEditorOptions;\n\n  /**\n   * The set of {@link IJsonEditorRule | editor rules} applied by this editor.\n   * @internal\n   */\n  protected _rules: IJsonEditorRule[];\n\n  /**\n   * Protected constructor for {@link JsonEditor | JsonEditor} and derived classes.\n   * External consumers should instantiate via the {@link JsonEditor.create | create static method}.\n   * @param options - Optional partial {@link IJsonEditorOptions | editor options} for the\n   * constructed editor.\n   * @param rules - Any {@link IJsonEditorRule | editor rules} to be applied by the editor.\n   * @internal\n   */\n  protected constructor(options?: Partial<IJsonEditorOptions>, rules?: IJsonEditorRule[]) {\n    this.options = JsonEditor._getDefaultOptions(options).orThrow();\n    this._rules = rules || JsonEditor.getDefaultRules(this.options).orThrow();\n  }\n\n  /**\n   * Default singleton {@link JsonEditor | JsonEditor} for simple use. Applies all rules\n   * but with no default context.\n   */\n  public static get default(): JsonEditor {\n    if (!JsonEditor._default) {\n      const rules = this.getDefaultRules().orDefault();\n      JsonEditor._default = new JsonEditor(undefined, rules);\n    }\n    return JsonEditor._default;\n  }\n\n  /**\n   * Constructs a new {@link JsonEditor | JsonEditor}.\n   * @param options - Optional partial {@link IJsonEditorOptions | editor options} for the\n   * constructed editor.\n   * @param rules - Optional set of {@link IJsonEditorRule | editor rules} to be applied by the editor.\n   * @readonly A new {@link JsonEditor | JsonEditor}.\n   */\n  public static create(options?: Partial<IJsonEditorOptions>, rules?: IJsonEditorRule[]): Result<JsonEditor> {\n    return captureResult(() => new JsonEditor(options, rules));\n  }\n\n  /**\n   * Gets the default set of rules to be applied for a given set of options.\n   * By default, all available rules (templates, conditionals, multi-value and references)\n   * are applied.\n   * @param options - Optional partial {@link IJsonEditorOptions | editor options} for\n   * all rules.\n   * @returns Default {@link IJsonEditorRule | editor rules} with any supplied options\n   * applied.\n   */\n  public static getDefaultRules(options?: IJsonEditorOptions): Result<IJsonEditorRule[]> {\n    return mapResults<IJsonEditorRule>([\n      TemplatedJsonEditorRule.create(options),\n      ConditionalJsonEditorRule.create(options),\n      MultiValueJsonEditorRule.create(options),\n      ReferenceJsonEditorRule.create(options)\n    ]);\n  }\n\n  /**\n   * @internal\n   */\n  protected static _getDefaultOptions(options?: Partial<IJsonEditorOptions>): Result<IJsonEditorOptions> {\n    const context: IJsonContext | undefined = options?.context;\n    let validation: IJsonEditorValidationOptions | undefined = options?.validation;\n    if (validation === undefined) {\n      validation = {\n        onInvalidPropertyName: 'error',\n        onInvalidPropertyValue: 'error',\n        onUndefinedPropertyValue: 'ignore'\n      };\n    }\n    return succeed({ context, validation });\n  }\n\n  /**\n   * Merges a supplied source object into a supplied target, updating the target object.\n   * @param target - The target `JsonObject` to be updated\n   * @param src - The source `JsonObject` to be merged\n   * @param runtimeContext - An optional {@link IJsonContext | IJsonContext} supplying variables\n   * and references.\n   * @returns `Success` with the original source `JsonObject` if merge was successful.\n   * Returns `Failure` with details if an error occurs.\n   */\n  public mergeObjectInPlace(\n    target: JsonObject,\n    src: JsonObject,\n    runtimeContext?: IJsonContext\n  ): Result<JsonObject> {\n    const state = new JsonEditorState(this, this.options, runtimeContext);\n    return this._mergeObjectInPlace(target, src, state).onSuccess((merged) => {\n      return this._finalizeAndMerge(merged, state);\n    });\n  }\n\n  /**\n   * Merges multiple supplied source objects into a supplied target, updating the target\n   * object and using the default context supplied at creation time.\n   * @param target - The target `JsonObject` to be updated\n   * @param srcObjects - `JsonObject`s to be merged into the target object, in the order\n   * supplied.\n   * @returns `Success` with the original source `JsonObject` if merge was successful.\n   * Returns `Failure` with details if an error occurs.\n   */\n  public mergeObjectsInPlace(target: JsonObject, srcObjects: JsonObject[]): Result<JsonObject> {\n    return this.mergeObjectsInPlaceWithContext(this.options.context, target, srcObjects);\n  }\n\n  /**\n   * Merges multiple supplied source objects into a supplied target, updating the target\n   * object and using an optional {@link IJsonContext | context} supplied in the call.\n   * @param context - An optional {@link IJsonContext | IJsonContext} supplying variables and\n   * references.\n   * @param base - The base `JsonObject` to be updated\n   * @param srcObjects - Objects to be merged into the target object, in the order supplied.\n   * @returns `Success` with the original source `JsonObject` if merge was successful.\n   * Returns `Failure` with details if an error occurs.\n   */\n  public mergeObjectsInPlaceWithContext(\n    context: IJsonContext | undefined,\n    base: JsonObject,\n    srcObjects: JsonObject[]\n  ): Result<JsonObject> {\n    for (const src of srcObjects) {\n      const mergeResult = this.mergeObjectInPlace(base, src, context);\n      if (mergeResult.isFailure()) {\n        return mergeResult.withFailureDetail('error');\n      }\n    }\n    return succeedWithDetail(base);\n  }\n\n  /**\n   * Deep clones a supplied `JsonValue`, applying all editor rules and a default\n   * or optionally supplied context\n   * @param src - The `JsonValue` to be cloned.\n   * @param context - An optional {@link IJsonContext | JSON context} supplying variables and references.\n   */\n  public clone(src: JsonValue, context?: IJsonContext): DetailedResult<JsonValue, JsonEditFailureReason> {\n    const state = new JsonEditorState(this, this.options, context);\n    let value = src;\n    let valueResult = this._editValue(src, state);\n\n    while (valueResult.isSuccess()) {\n      value = valueResult.value;\n      valueResult = this._editValue(value, state);\n    }\n\n    if (valueResult.detail === 'error' || valueResult.detail === 'ignore') {\n      return valueResult;\n    }\n\n    if (isJsonPrimitive(value) || value === null) {\n      return succeedWithDetail(value, 'edited');\n    } else if (isJsonObject(value)) {\n      return this.mergeObjectInPlace({}, value, state.context).withFailureDetail('error');\n    } else if (isJsonArray(value)) {\n      return this._cloneArray(value, state.context);\n    } else if (value === undefined) {\n      return state.failValidation('undefinedPropertyValue');\n    }\n    return state.failValidation(\n      'invalidPropertyValue',\n      `Cannot convert invalid JSON: \"${JSON.stringify(value)}\"`\n    );\n  }\n\n  /**\n   *\n   * @param target -\n   * @param src -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _mergeObjectInPlace(\n    target: JsonObject,\n    src: JsonObject,\n    state: JsonEditorState\n  ): Result<JsonObject> {\n    for (const key in src) {\n      if (src.hasOwnProperty(key)) {\n        const propResult = this._editProperty(key, src[key], state);\n        if (propResult.isSuccess()) {\n          if (propResult.detail === 'deferred') {\n            state.defer(propResult.value);\n          } else {\n            const mergeResult = this._mergeObjectInPlace(target, propResult.value, state);\n            if (mergeResult.isFailure()) {\n              return mergeResult;\n            }\n          }\n        } else if (propResult.detail === 'inapplicable') {\n          const valueResult = this.clone(src[key], state.context).onSuccess((cloned) => {\n            return this._mergeClonedProperty(target, key, cloned, state);\n          });\n\n          if (valueResult.isFailure() && valueResult.detail === 'error') {\n            return fail(`${key}: ${valueResult.message}`);\n          }\n        } else if (propResult.detail !== 'ignore') {\n          return fail(`${key}: ${propResult.message}`);\n        }\n      } else {\n        return fail(`${key}: Cannot merge inherited properties`);\n      }\n    }\n    return succeed(target);\n  }\n\n  /**\n   *\n   * @param src -\n   * @param context -\n   * @returns\n   * @internal\n   */\n  protected _cloneArray(\n    src: JsonArray,\n    context?: IJsonContext\n  ): DetailedResult<JsonArray, JsonEditFailureReason> {\n    const results = src.map((v) => {\n      return this.clone(v, context);\n    });\n\n    return mapDetailedResults<JsonValue, JsonEditFailureReason>(results, ['ignore'])\n      .onSuccess((converted) => {\n        return succeed(converted);\n      })\n      .withFailureDetail('error');\n  }\n\n  /**\n   *\n   * @param target -\n   * @param key -\n   * @param newValue -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _mergeClonedProperty(\n    target: JsonObject,\n    key: string,\n    newValue: JsonValue,\n    state: JsonEditorState\n  ): DetailedResult<JsonValue, JsonEditFailureReason> {\n    const existing = target[key];\n\n    // merge is called right after clone so this should never happen\n    // since clone itself will have failed\n\n    if (isJsonPrimitive(newValue)) {\n      target[key] = newValue;\n      return succeedWithDetail(newValue, 'edited');\n    }\n\n    if (isJsonObject(newValue)) {\n      if (isJsonObject(existing)) {\n        return this.mergeObjectInPlace(existing, newValue, state.context).withFailureDetail('error');\n      }\n      target[key] = newValue;\n      return succeedWithDetail(newValue, 'edited');\n    }\n\n    /* c8 ignore else */\n    if (isJsonArray(newValue)) {\n      if (isJsonArray(existing)) {\n        target[key] = existing.concat(...newValue);\n        return succeedWithDetail(target[key], 'edited');\n      }\n      target[key] = newValue;\n      return succeedWithDetail(newValue, 'edited');\n    }\n    /* c8 ignore start */\n    return failWithDetail(`Invalid JSON: ${JSON.stringify(newValue)}`, 'error');\n  } /* c8 ignore stop */\n\n  /**\n   *\n   * @param key -\n   * @param value -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _editProperty(\n    key: string,\n    value: JsonValue,\n    state: JsonEditorState\n  ): DetailedResult<JsonObject, JsonPropertyEditFailureReason> {\n    for (const rule of this._rules) {\n      const ruleResult = rule.editProperty(key, value, state);\n      if (ruleResult.isSuccess() || ruleResult.detail !== 'inapplicable') {\n        return ruleResult;\n      }\n    }\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n\n  /**\n   *\n   * @param value -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _editValue(\n    value: JsonValue,\n    state: JsonEditorState\n  ): DetailedResult<JsonValue, JsonEditFailureReason> {\n    for (const rule of this._rules) {\n      const ruleResult = rule.editValue(value, state);\n      if (ruleResult.isSuccess() || ruleResult.detail !== 'inapplicable') {\n        return ruleResult;\n      }\n    }\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n\n  /**\n   *\n   * @param target -\n   * @param state -\n   * @returns\n   * @internal\n   */\n  protected _finalizeAndMerge(\n    target: JsonObject,\n    state: JsonEditorState\n  ): DetailedResult<JsonObject, JsonEditFailureReason> {\n    const deferred = state.deferred;\n    if (deferred.length > 0) {\n      for (const rule of this._rules) {\n        const ruleResult = rule.finalizeProperties(deferred, state);\n        if (ruleResult.isSuccess()) {\n          return this.mergeObjectsInPlaceWithContext(\n            state.context,\n            target,\n            ruleResult.value\n          ).withFailureDetail('error');\n        } else if (ruleResult.detail === 'ignore') {\n          succeedWithDetail(target, 'edited');\n        } else if (ruleResult.detail !== 'inapplicable') {\n          return failWithDetail(ruleResult.message, ruleResult.detail);\n        }\n      }\n    }\n    return succeedWithDetail(target, 'edited');\n  }\n}\n"]}

package/lib/packlets/editor/jsonEditorRule.d.ts

@@ -3,29 +3,29 @@ import { DetailedResult } from '@fgv/ts-utils';
 import { JsonEditFailureReason, JsonPropertyEditFailureReason } from './common';
 import { JsonEditorState } from './jsonEditorState';
 /**
- * An {@link Editor.IJsonEditorRule | IJsonEditorRule} represents a single configurable
- * rule to be applied by a {@link Editor.JsonEditor | JsonEditor}.
+ * An {@link IJsonEditorRule | IJsonEditorRule} represents a single configurable
+ * rule to be applied by a {@link JsonEditor | JsonEditor}.
  * @public
  */
 export interface IJsonEditorRule {
     /**
-     * Called by a {@link Editor.JsonEditor | JsonEditor} to possibly edit one of the properties being
+     * Called by a {@link JsonEditor | JsonEditor} to possibly edit one of the properties being
      * merged into a target object.
      * @param key - The key of the property to be edited.
-     * @param value - The {@link JsonValue | value} of the property to be edited.
-     * @param state - {@link Editor.JsonEditorState | Editor state} which applies to the edit.
-     * @returns If the property was edited, returns `Success` with a {@link JsonObject | JsonObject} containing
+     * @param value - The `JsonValue` of the property to be edited.
+     * @param state - {@link JsonEditorState | Editor state} which applies to the edit.
+     * @returns If the property was edited, returns `Success` with a `JsonObject` containing
      * the edited results and with detail `'edited'`. If this property should be deferred for later consideration
-     * or merge, `Success` with detail `'deferred'` and a {@link JsonObject | JsonObject} to be finalized.  If
+     * or merge, `Success` with detail `'deferred'` and a `JsonObject` to be finalized.  If
      * the rule does not affect this property, returns `Failure` with detail `'inapplicable'`. If an error occurred
      * while processing the error, returns `Failure` with detail `'error'`.
      */
     editProperty(key: string, value: JsonValue, state: JsonEditorState): DetailedResult<JsonObject, JsonPropertyEditFailureReason>;
     /**
-     * Called by a {@link Editor.JsonEditor | JsonEditor} to possibly edit a property value or array element.
-     * @param value - The {@link JsonValue | value} of the property to be edited.
-     * @param state - {@link Editor.JsonEditorState | Editor state} which applies to the edit.
-     * @returns Returns `Success` with the {@link JsonValue | JsonValue} to be inserted, with detail `'edited'` if
+     * Called by a {@link JsonEditor | JsonEditor} to possibly edit a property value or array element.
+     * @param value - The `JsonValue` of the property to be edited.
+     * @param state - {@link JsonEditorState | Editor state} which applies to the edit.
+     * @returns Returns `Success` with the `JsonValue` to be inserted, with detail `'edited'` if
      * the value was edited.  Returns `Failure` with `'inapplicable'` if the rule does not affect this value.
      * Fails with detail `'ignore'` if the value is to be ignored, or with `'error'` if an error occurs.
      */
@@ -33,8 +33,8 @@ export interface IJsonEditorRule {
     /**
      * Called for each rule after all properties have been merged.  Any properties that were deferred
      * during the initial edit pass are supplied as input.
-     * @param deferred - Any {@link JsonObject | objects} that were deferred during the first edit pass.
-     * @param state - {@link Editor.JsonEditorState | Editor state} which applies to the edit.
+     * @param deferred - Any JSON objects that were deferred during the first edit pass.
+     * @param state - {@link JsonEditorState | Editor state} which applies to the edit.
      * @returns On `Success` return, any returned objects are merged in order and finalization
      * is stopped. Finalization is also stopped on `Failure` with detail `'ignore'`. On `Failure`
      * with detail `'inapplicable'`, finalization continues with the next rule. Fails with an
@@ -43,21 +43,21 @@ export interface IJsonEditorRule {
     finalizeProperties(deferred: JsonObject[], state: JsonEditorState): DetailedResult<JsonObject[], JsonEditFailureReason>;
 }
 /**
- * Default base implementation of {@link Editor.IJsonEditorRule | IJsonEditorRule} returns inapplicable for all operations so that
+ * Default base implementation of {@link IJsonEditorRule | IJsonEditorRule} returns inapplicable for all operations so that
  * derived classes need only implement the operations they actually support.
  * @public
  */
 export declare class JsonEditorRuleBase implements IJsonEditorRule {
     /**
-     * {@inheritdoc Editor.IJsonEditorRule.editProperty}
+     * {@inheritdoc IJsonEditorRule.editProperty}
      */
     editProperty(__key: string, __value: JsonValue, __state: JsonEditorState): DetailedResult<JsonObject, JsonPropertyEditFailureReason>;
     /**
-     * {@inheritdoc Editor.IJsonEditorRule.editValue}
+     * {@inheritdoc IJsonEditorRule.editValue}
      */
     editValue(__value: JsonValue, __state: JsonEditorState): DetailedResult<JsonValue, JsonEditFailureReason>;
     /**
-     * {@inheritdoc Editor.IJsonEditorRule.finalizeProperties}
+     * {@inheritdoc IJsonEditorRule.finalizeProperties}
      */
     finalizeProperties(__deferred: JsonObject[], __state: JsonEditorState): DetailedResult<JsonObject[], JsonEditFailureReason>;
 }

package/lib/packlets/editor/jsonEditorRule.js

@@ -24,13 +24,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.JsonEditorRuleBase = void 0;
 const ts_utils_1 = require("@fgv/ts-utils");
 /**
- * Default base implementation of {@link Editor.IJsonEditorRule | IJsonEditorRule} returns inapplicable for all operations so that
+ * Default base implementation of {@link IJsonEditorRule | IJsonEditorRule} returns inapplicable for all operations so that
  * derived classes need only implement the operations they actually support.
  * @public
  */
 class JsonEditorRuleBase {
     /**
-     * {@inheritdoc Editor.IJsonEditorRule.editProperty}
+     * {@inheritdoc IJsonEditorRule.editProperty}
      */
     /* c8 ignore start */
     editProperty(__key, __value, __state) {
@@ -38,13 +38,13 @@ class JsonEditorRuleBase {
     }
     /* c8 ignore stop */
     /**
-     * {@inheritdoc Editor.IJsonEditorRule.editValue}
+     * {@inheritdoc IJsonEditorRule.editValue}
      */
     editValue(__value, __state) {
         return (0, ts_utils_1.failWithDetail)('inapplicable', 'inapplicable');
     }
     /**
-     * {@inheritdoc Editor.IJsonEditorRule.finalizeProperties}
+     * {@inheritdoc IJsonEditorRule.finalizeProperties}
      */
     finalizeProperties(__deferred, __state) {
         return (0, ts_utils_1.failWithDetail)('inapplicable', 'inapplicable');

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

@@ -1 +1 @@
-{"version":3,"file":"jsonEditorRule.js","sourceRoot":"","sources":["../../../src/packlets/editor/jsonEditorRule.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAGH,4CAA+D;AAuD/D;;;;GAIG;AACH,MAAa,kBAAkB;IAC7B;;OAEG;IACH,qBAAqB;IACd,YAAY,CACjB,KAAa,EACb,OAAkB,EAClB,OAAwB;QAExB,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;IACD,oBAAoB;IAEpB;;OAEG;IACI,SAAS,CACd,OAAkB,EAClB,OAAwB;QAExB,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACI,kBAAkB,CACvB,UAAwB,EACxB,OAAwB;QAExB,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;CACF;AAjCD,gDAiCC","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, failWithDetail } from '@fgv/ts-utils';\nimport { JsonEditFailureReason, JsonPropertyEditFailureReason } from './common';\n\nimport { JsonEditorState } from './jsonEditorState';\n\n/**\n * An {@link Editor.IJsonEditorRule | IJsonEditorRule} represents a single configurable\n * rule to be applied by a {@link Editor.JsonEditor | JsonEditor}.\n * @public\n */\nexport interface IJsonEditorRule {\n  /**\n   * Called by a {@link Editor.JsonEditor | JsonEditor} to possibly edit one of the properties being\n   * merged into a target object.\n   * @param key - The key of the property to be edited.\n   * @param value - The {@link JsonValue | value} of the property to be edited.\n   * @param state - {@link Editor.JsonEditorState | Editor state} which applies to the edit.\n   * @returns If the property was edited, returns `Success` with a {@link JsonObject | JsonObject} containing\n   * the edited results and with detail `'edited'`. If this property should be deferred for later consideration\n   * or merge, `Success` with detail `'deferred'` and a {@link JsonObject | JsonObject} to be finalized.  If\n   * the rule does not affect this property, returns `Failure` with detail `'inapplicable'`. If an error occurred\n   * while processing the error, returns `Failure` with detail `'error'`.\n   */\n  editProperty(\n    key: string,\n    value: JsonValue,\n    state: JsonEditorState\n  ): DetailedResult<JsonObject, JsonPropertyEditFailureReason>;\n\n  /**\n   * Called by a {@link Editor.JsonEditor | JsonEditor} to possibly edit a property value or array element.\n   * @param value - The {@link JsonValue | value} of the property to be edited.\n   * @param state - {@link Editor.JsonEditorState | Editor state} which applies to the edit.\n   * @returns Returns `Success` with the {@link JsonValue | JsonValue} to be inserted, with detail `'edited'` if\n   * the value was edited.  Returns `Failure` with `'inapplicable'` if the rule does not affect this value.\n   * Fails with detail `'ignore'` if the value is to be ignored, or with `'error'` if an error occurs.\n   */\n  editValue(value: JsonValue, state: JsonEditorState): DetailedResult<JsonValue, JsonEditFailureReason>;\n\n  /**\n   * Called for each rule after all properties have been merged.  Any properties that were deferred\n   * during the initial edit pass are supplied as input.\n   * @param deferred - Any {@link JsonObject | objects} that were deferred during the first edit pass.\n   * @param state - {@link Editor.JsonEditorState | Editor state} which applies to the edit.\n   * @returns On `Success` return, any returned objects are merged in order and finalization\n   * is stopped. Finalization is also stopped on `Failure` with detail `'ignore'`. On `Failure`\n   * with detail `'inapplicable'`, finalization continues with the next rule. Fails with an\n   * error detail `'error'` and an informative message if an error occurs.\n   */\n  finalizeProperties(\n    deferred: JsonObject[],\n    state: JsonEditorState\n  ): DetailedResult<JsonObject[], JsonEditFailureReason>;\n}\n\n/**\n * Default base implementation of {@link Editor.IJsonEditorRule | IJsonEditorRule} returns inapplicable for all operations so that\n * derived classes need only implement the operations they actually support.\n * @public\n */\nexport class JsonEditorRuleBase implements IJsonEditorRule {\n  /**\n   * {@inheritdoc Editor.IJsonEditorRule.editProperty}\n   */\n  /* c8 ignore start */\n  public editProperty(\n    __key: string,\n    __value: JsonValue,\n    __state: JsonEditorState\n  ): DetailedResult<JsonObject, JsonPropertyEditFailureReason> {\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n  /* c8 ignore stop */\n\n  /**\n   * {@inheritdoc Editor.IJsonEditorRule.editValue}\n   */\n  public editValue(\n    __value: JsonValue,\n    __state: JsonEditorState\n  ): DetailedResult<JsonValue, JsonEditFailureReason> {\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n\n  /**\n   * {@inheritdoc Editor.IJsonEditorRule.finalizeProperties}\n   */\n  public finalizeProperties(\n    __deferred: JsonObject[],\n    __state: JsonEditorState\n  ): DetailedResult<JsonObject[], JsonEditFailureReason> {\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n}\n"]}
+{"version":3,"file":"jsonEditorRule.js","sourceRoot":"","sources":["../../../src/packlets/editor/jsonEditorRule.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAGH,4CAA+D;AAuD/D;;;;GAIG;AACH,MAAa,kBAAkB;IAC7B;;OAEG;IACH,qBAAqB;IACd,YAAY,CACjB,KAAa,EACb,OAAkB,EAClB,OAAwB;QAExB,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;IACD,oBAAoB;IAEpB;;OAEG;IACI,SAAS,CACd,OAAkB,EAClB,OAAwB;QAExB,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACI,kBAAkB,CACvB,UAAwB,EACxB,OAAwB;QAExB,OAAO,IAAA,yBAAc,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IACxD,CAAC;CACF;AAjCD,gDAiCC","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, failWithDetail } from '@fgv/ts-utils';\nimport { JsonEditFailureReason, JsonPropertyEditFailureReason } from './common';\n\nimport { JsonEditorState } from './jsonEditorState';\n\n/**\n * An {@link IJsonEditorRule | IJsonEditorRule} represents a single configurable\n * rule to be applied by a {@link JsonEditor | JsonEditor}.\n * @public\n */\nexport interface IJsonEditorRule {\n  /**\n   * Called by a {@link JsonEditor | JsonEditor} to possibly edit one of the properties being\n   * merged into a target object.\n   * @param key - The key of the property to be edited.\n   * @param value - The `JsonValue` of the property to be edited.\n   * @param state - {@link JsonEditorState | Editor state} which applies to the edit.\n   * @returns If the property was edited, returns `Success` with a `JsonObject` containing\n   * the edited results and with detail `'edited'`. If this property should be deferred for later consideration\n   * or merge, `Success` with detail `'deferred'` and a `JsonObject` to be finalized.  If\n   * the rule does not affect this property, returns `Failure` with detail `'inapplicable'`. If an error occurred\n   * while processing the error, returns `Failure` with detail `'error'`.\n   */\n  editProperty(\n    key: string,\n    value: JsonValue,\n    state: JsonEditorState\n  ): DetailedResult<JsonObject, JsonPropertyEditFailureReason>;\n\n  /**\n   * Called by a {@link JsonEditor | JsonEditor} to possibly edit a property value or array element.\n   * @param value - The `JsonValue` of the property to be edited.\n   * @param state - {@link JsonEditorState | Editor state} which applies to the edit.\n   * @returns Returns `Success` with the `JsonValue` to be inserted, with detail `'edited'` if\n   * the value was edited.  Returns `Failure` with `'inapplicable'` if the rule does not affect this value.\n   * Fails with detail `'ignore'` if the value is to be ignored, or with `'error'` if an error occurs.\n   */\n  editValue(value: JsonValue, state: JsonEditorState): DetailedResult<JsonValue, JsonEditFailureReason>;\n\n  /**\n   * Called for each rule after all properties have been merged.  Any properties that were deferred\n   * during the initial edit pass are supplied as input.\n   * @param deferred - Any JSON objects that were deferred during the first edit pass.\n   * @param state - {@link JsonEditorState | Editor state} which applies to the edit.\n   * @returns On `Success` return, any returned objects are merged in order and finalization\n   * is stopped. Finalization is also stopped on `Failure` with detail `'ignore'`. On `Failure`\n   * with detail `'inapplicable'`, finalization continues with the next rule. Fails with an\n   * error detail `'error'` and an informative message if an error occurs.\n   */\n  finalizeProperties(\n    deferred: JsonObject[],\n    state: JsonEditorState\n  ): DetailedResult<JsonObject[], JsonEditFailureReason>;\n}\n\n/**\n * Default base implementation of {@link IJsonEditorRule | IJsonEditorRule} returns inapplicable for all operations so that\n * derived classes need only implement the operations they actually support.\n * @public\n */\nexport class JsonEditorRuleBase implements IJsonEditorRule {\n  /**\n   * {@inheritdoc IJsonEditorRule.editProperty}\n   */\n  /* c8 ignore start */\n  public editProperty(\n    __key: string,\n    __value: JsonValue,\n    __state: JsonEditorState\n  ): DetailedResult<JsonObject, JsonPropertyEditFailureReason> {\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n  /* c8 ignore stop */\n\n  /**\n   * {@inheritdoc IJsonEditorRule.editValue}\n   */\n  public editValue(\n    __value: JsonValue,\n    __state: JsonEditorState\n  ): DetailedResult<JsonValue, JsonEditFailureReason> {\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n\n  /**\n   * {@inheritdoc IJsonEditorRule.finalizeProperties}\n   */\n  public finalizeProperties(\n    __deferred: JsonObject[],\n    __state: JsonEditorState\n  ): DetailedResult<JsonObject[], JsonEditFailureReason> {\n    return failWithDetail('inapplicable', 'inapplicable');\n  }\n}\n"]}