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

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

@@ -3,40 +3,40 @@ import { DetailedFailure, Result } from '@fgv/ts-utils';
 import { IJsonContext, IJsonReferenceMap, TemplateVars, VariableValue } from '../context';
 import { IJsonCloneEditor, IJsonEditorOptions, IJsonEditorValidationOptions, JsonEditFailureReason, JsonEditorValidationRules } from './common';
 /**
- * Represents the internal state of a {@link Editor.JsonEditor | JsonEditor}.
+ * Represents the internal state of a {@link JsonEditor | JsonEditor}.
  * @public
  */
 export declare class JsonEditorState {
     /**
-     * Static global counter used to assign each {@link Editor.JsonEditorState | JsonEditorState}
+     * Static global counter used to assign each {@link JsonEditorState | JsonEditorState}
      * a unique identifier.
      * @internal
      */
     protected static _nextId: number;
     /**
-     * The {@link Editor.IJsonCloneEditor | editor} for which this state applies.
+     * The {@link IJsonCloneEditor | editor} for which this state applies.
      */
     readonly editor: IJsonCloneEditor;
     /**
-     * Fully resolved {@link Editor.IJsonEditorOptions | editor options} that apply
+     * Fully resolved {@link IJsonEditorOptions | editor options} that apply
      * to the operation for which this state applies.
      */
     readonly options: IJsonEditorOptions;
     /**
-     * Any deferred {@link JsonObject | objects} to be merged during finalization.
+     * Any deferred JSON objects to be merged during finalization.
      * @internal
      */
     protected readonly _deferred: JsonObject[];
     /**
-     * Unique global identifier for this {@link Editor.JsonEditorState | state object}.
+     * Unique global identifier for this {@link JsonEditorState | state object}.
      * @internal
      */
     protected readonly _id: number;
     /**
-     * Constructs a new {@link Editor.JsonEditorState | JsonEditorState}.
-     * @param editor - The {@link Editor.IJsonCloneEditor | editor} to which this state
+     * Constructs a new {@link JsonEditorState | JsonEditorState}.
+     * @param editor - The {@link IJsonCloneEditor | editor} to which this state
      * applies.
-     * @param baseOptions - The {@link Editor.IJsonEditorOptions | editor options} that
+     * @param baseOptions - The {@link IJsonEditorOptions | editor options} that
      * apply to this rule.
      * @param runtimeContext - An optional {@link IJsonContext | JSON context} to be used
      * for json value conversion.
@@ -47,31 +47,31 @@ export declare class JsonEditorState {
      */
     get context(): IJsonContext | undefined;
     /**
-     * An array of {@link JsonObject | objects} that are deferred for merge during
+     * An array of JSON objects that were deferred for merge during
      * finalization.
      */
     get deferred(): JsonObject[];
     /**
      * Merges an optional {@link IJsonContext | JSON context} into a supplied set
-     * of {@link Editor.IJsonEditorOptions | JSON editor options}.
-     * @param options - The {@link Editor.IJsonEditorOptions | IJsonEditorOptions} into
+     * of {@link IJsonEditorOptions | JSON editor options}.
+     * @param options - The {@link IJsonEditorOptions | IJsonEditorOptions} into
      * which the the new context is to be merged.
      * @param context - The {@link IJsonContext | JSON context} to be merged into the
      * editor options.
-     * @returns `Success` with the supplied {@link Editor.IJsonEditorOptions | options} if
-     * there was nothing to merge, or aa new {@link Editor.IJsonEditorOptions | IJsonEditorOptions}
+     * @returns `Success` with the supplied {@link IJsonEditorOptions | options} if
+     * there was nothing to merge, or aa new {@link IJsonEditorOptions | IJsonEditorOptions}
      * constructed from the base options merged with the supplied context.  Returns `Failure`
      * with more information if an error occurs.
      * @internal
      */
     protected static _getEffectiveOptions(options: IJsonEditorOptions, context?: IJsonContext): Result<IJsonEditorOptions>;
     /**
-     * Adds a supplied {@link JsonObject | object} to the deferred list.
-     * @param obj - The {@link JsonObject | object} to be deferred.
+     * Adds a supplied `JsonObject` to the deferred list.
+     * @param obj - The `JsonObject` to be deferred.
      */
     defer(obj: JsonObject): void;
     /**
-     * Gets a {@link TemplateVars | TemplateVars} from the context of this {@link Editor.JsonEditorState | JsonEditorState},
+     * Gets a {@link TemplateVars | TemplateVars} from the context of this {@link JsonEditorState | JsonEditorState},
      * or from an optional supplied {@link IJsonContext | IJsonContext} if the current state has no default
      * context.
      * @param defaultContext - An optional default {@link IJsonContext | IJsonContext} to use as `TemplateVars`
@@ -90,7 +90,7 @@ export declare class JsonEditorState {
      */
     getRefs(defaultContext?: IJsonContext): IJsonReferenceMap | undefined;
     /**
-     * Gets the context of this {@link Editor.JsonEditorState | JsonEditorState} or an optionally
+     * Gets the context of this {@link JsonEditorState | JsonEditorState} or an optionally
      * supplied default context if this state has no context.
      * @param defaultContext - The default {@link IJsonContext | JSON context} to use as default
      * if this state has no context.
@@ -114,9 +114,9 @@ export declare class JsonEditorState {
     /**
      * Helper method to constructs  `DetailedFailure` with appropriate details and messaging
      * for various validation failures.
-     * @param rule - The {@link Editor.JsonEditorValidationRules | validation rule} that failed.
+     * @param rule - The {@link JsonEditorValidationRules | validation rule} that failed.
      * @param message -  A string message describing the failed validation.
-     * @param validation - The {@link Editor.IJsonEditorValidationOptions | validation options}
+     * @param validation - The {@link IJsonEditorValidationOptions | validation options}
      * in effect.
      * @returns A `DetailedFailure` with appropriate detail and message.
      */

package/lib/packlets/editor/jsonEditorState.js

@@ -25,22 +25,22 @@ exports.JsonEditorState = void 0;
 const ts_utils_1 = require("@fgv/ts-utils");
 const context_1 = require("../context");
 /**
- * Represents the internal state of a {@link Editor.JsonEditor | JsonEditor}.
+ * Represents the internal state of a {@link JsonEditor | JsonEditor}.
  * @public
  */
 class JsonEditorState {
     /**
-     * Constructs a new {@link Editor.JsonEditorState | JsonEditorState}.
-     * @param editor - The {@link Editor.IJsonCloneEditor | editor} to which this state
+     * Constructs a new {@link JsonEditorState | JsonEditorState}.
+     * @param editor - The {@link IJsonCloneEditor | editor} to which this state
      * applies.
-     * @param baseOptions - The {@link Editor.IJsonEditorOptions | editor options} that
+     * @param baseOptions - The {@link IJsonEditorOptions | editor options} that
      * apply to this rule.
      * @param runtimeContext - An optional {@link IJsonContext | JSON context} to be used
      * for json value conversion.
      */
     constructor(editor, baseOptions, runtimeContext) {
         /**
-         * Any deferred {@link JsonObject | objects} to be merged during finalization.
+         * Any deferred JSON objects to be merged during finalization.
          * @internal
          */
         this._deferred = [];
@@ -55,7 +55,7 @@ class JsonEditorState {
         return this.options.context;
     }
     /**
-     * An array of {@link JsonObject | objects} that are deferred for merge during
+     * An array of JSON objects that were deferred for merge during
      * finalization.
      */
     get deferred() {
@@ -63,13 +63,13 @@ class JsonEditorState {
     }
     /**
      * Merges an optional {@link IJsonContext | JSON context} into a supplied set
-     * of {@link Editor.IJsonEditorOptions | JSON editor options}.
-     * @param options - The {@link Editor.IJsonEditorOptions | IJsonEditorOptions} into
+     * of {@link IJsonEditorOptions | JSON editor options}.
+     * @param options - The {@link IJsonEditorOptions | IJsonEditorOptions} into
      * which the the new context is to be merged.
      * @param context - The {@link IJsonContext | JSON context} to be merged into the
      * editor options.
-     * @returns `Success` with the supplied {@link Editor.IJsonEditorOptions | options} if
-     * there was nothing to merge, or aa new {@link Editor.IJsonEditorOptions | IJsonEditorOptions}
+     * @returns `Success` with the supplied {@link IJsonEditorOptions | options} if
+     * there was nothing to merge, or aa new {@link IJsonEditorOptions | IJsonEditorOptions}
      * constructed from the base options merged with the supplied context.  Returns `Failure`
      * with more information if an error occurs.
      * @internal
@@ -83,14 +83,14 @@ class JsonEditorState {
         });
     }
     /**
-     * Adds a supplied {@link JsonObject | object} to the deferred list.
-     * @param obj - The {@link JsonObject | object} to be deferred.
+     * Adds a supplied `JsonObject` to the deferred list.
+     * @param obj - The `JsonObject` to be deferred.
      */
     defer(obj) {
         this._deferred.push(obj);
     }
     /**
-     * Gets a {@link TemplateVars | TemplateVars} from the context of this {@link Editor.JsonEditorState | JsonEditorState},
+     * Gets a {@link TemplateVars | TemplateVars} from the context of this {@link JsonEditorState | JsonEditorState},
      * or from an optional supplied {@link IJsonContext | IJsonContext} if the current state has no default
      * context.
      * @param defaultContext - An optional default {@link IJsonContext | IJsonContext} to use as `TemplateVars`
@@ -115,7 +115,7 @@ class JsonEditorState {
         return (_b = (_a = this.options.context) === null || _a === void 0 ? void 0 : _a.refs) !== null && _b !== void 0 ? _b : defaultContext === null || defaultContext === void 0 ? void 0 : defaultContext.refs;
     }
     /**
-     * Gets the context of this {@link Editor.JsonEditorState | JsonEditorState} or an optionally
+     * Gets the context of this {@link JsonEditorState | JsonEditorState} or an optionally
      * supplied default context if this state has no context.
      * @param defaultContext - The default {@link IJsonContext | JSON context} to use as default
      * if this state has no context.
@@ -141,9 +141,9 @@ class JsonEditorState {
     /**
      * Helper method to constructs  `DetailedFailure` with appropriate details and messaging
      * for various validation failures.
-     * @param rule - The {@link Editor.JsonEditorValidationRules | validation rule} that failed.
+     * @param rule - The {@link JsonEditorValidationRules | validation rule} that failed.
      * @param message -  A string message describing the failed validation.
-     * @param validation - The {@link Editor.IJsonEditorValidationOptions | validation options}
+     * @param validation - The {@link IJsonEditorValidationOptions | validation options}
      * in effect.
      * @returns A `DetailedFailure` with appropriate detail and message.
      */
@@ -169,7 +169,7 @@ class JsonEditorState {
 }
 exports.JsonEditorState = JsonEditorState;
 /**
- * Static global counter used to assign each {@link Editor.JsonEditorState | JsonEditorState}
+ * Static global counter used to assign each {@link JsonEditorState | JsonEditorState}
  * a unique identifier.
  * @internal
  */

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

@@ -1 +1 @@
-{"version":3,"file":"jsonEditorState.js","sourceRoot":"","sources":["../../../src/packlets/editor/jsonEditorState.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 { JsonObject } from '@fgv/ts-json-base';\nimport { DetailedFailure, Result, failWithDetail, succeed } from '@fgv/ts-utils';\nimport { IJsonContext, IJsonReferenceMap, JsonContextHelper, TemplateVars, VariableValue } from '../context';\nimport {\n  IJsonCloneEditor,\n  IJsonEditorOptions,\n  IJsonEditorValidationOptions,\n  JsonEditFailureReason,\n  JsonEditorValidationRules,\n  JsonPropertyEditFailureReason\n} from './common';\n\n/**\n * Represents the internal state of a {@link Editor.JsonEditor | JsonEditor}.\n * @public\n */\nexport class JsonEditorState {\n  /**\n   * Static global counter used to assign each {@link Editor.JsonEditorState | JsonEditorState}\n   * a unique identifier.\n   * @internal\n   */\n  protected static _nextId: number = 0;\n\n  /**\n   * The {@link Editor.IJsonCloneEditor | editor} for which this state applies.\n   */\n  public readonly editor: IJsonCloneEditor;\n\n  /**\n   * Fully resolved {@link Editor.IJsonEditorOptions | editor options} that apply\n   * to the operation for which this state applies.\n   */\n  public readonly options: IJsonEditorOptions;\n\n  /**\n   * Any deferred {@link JsonObject | objects} to be merged during finalization.\n   * @internal\n   */\n  protected readonly _deferred: JsonObject[] = [];\n\n  /**\n   * Unique global identifier for this {@link Editor.JsonEditorState | state object}.\n   * @internal\n   */\n  protected readonly _id: number;\n\n  /**\n   * Constructs a new {@link Editor.JsonEditorState | JsonEditorState}.\n   * @param editor - The {@link Editor.IJsonCloneEditor | editor} to which this state\n   * applies.\n   * @param baseOptions - The {@link Editor.IJsonEditorOptions | editor options} that\n   * apply to this rule.\n   * @param runtimeContext - An optional {@link IJsonContext | JSON context} to be used\n   * for json value conversion.\n   */\n  public constructor(\n    editor: IJsonCloneEditor,\n    baseOptions: IJsonEditorOptions,\n    runtimeContext?: IJsonContext\n  ) {\n    this.editor = editor;\n    this.options = JsonEditorState._getEffectiveOptions(baseOptions, runtimeContext).orThrow();\n    this._id = JsonEditorState._nextId++;\n  }\n\n  /**\n   * The optional {@link IJsonContext | JSON context} for this state.\n   */\n  public get context(): IJsonContext | undefined {\n    return this.options.context;\n  }\n\n  /**\n   * An array of {@link JsonObject | objects} that are deferred for merge during\n   * finalization.\n   */\n  public get deferred(): JsonObject[] {\n    return this._deferred;\n  }\n\n  /**\n   * Merges an optional {@link IJsonContext | JSON context} into a supplied set\n   * of {@link Editor.IJsonEditorOptions | JSON editor options}.\n   * @param options - The {@link Editor.IJsonEditorOptions | IJsonEditorOptions} into\n   * which the the new context is to be merged.\n   * @param context - The {@link IJsonContext | JSON context} to be merged into the\n   * editor options.\n   * @returns `Success` with the supplied {@link Editor.IJsonEditorOptions | options} if\n   * there was nothing to merge, or aa new {@link Editor.IJsonEditorOptions | IJsonEditorOptions}\n   * constructed from the base options merged with the supplied context.  Returns `Failure`\n   * with more information if an error occurs.\n   * @internal\n   */\n  protected static _getEffectiveOptions(\n    options: IJsonEditorOptions,\n    context?: IJsonContext\n  ): Result<IJsonEditorOptions> {\n    if (!context) {\n      return succeed(options);\n    }\n    return JsonContextHelper.mergeContext(options.context, context).onSuccess((merged) => {\n      return succeed({ context: merged, validation: options.validation });\n    });\n  }\n\n  /**\n   * Adds a supplied {@link JsonObject | object} to the deferred list.\n   * @param obj - The {@link JsonObject | object} to be deferred.\n   */\n  public defer(obj: JsonObject): void {\n    this._deferred.push(obj);\n  }\n\n  /**\n   * Gets a {@link TemplateVars | TemplateVars} from the context of this {@link Editor.JsonEditorState | JsonEditorState},\n   * or from an optional supplied {@link IJsonContext | IJsonContext} if the current state has no default\n   * context.\n   * @param defaultContext - An optional default {@link IJsonContext | IJsonContext} to use as `TemplateVars`\n   * if the current state does not have context.\n   * @returns A {@link TemplateVars | TemplateVars} reflecting the appropriate {@link IJsonContext | JSON context}, or\n   * `undefined` if no vars are found.\n   */\n  public getVars(defaultContext?: IJsonContext): TemplateVars | undefined {\n    return this.options.context?.vars ?? defaultContext?.vars;\n  }\n\n  /**\n   * Gets an {@link IJsonReferenceMap | reference map} containing any other values\n   * referenced during the operation.\n   * @param defaultContext - An optional default {@link IJsonContext | IJsonContext} to use as\n   * {@link TemplateVars | TemplateVars} if the current state does not have context.\n   * @returns An {@link IJsonReferenceMap | IJsonReferenceMap} containing any values referenced\n   * during this operation.\n   */\n  public getRefs(defaultContext?: IJsonContext): IJsonReferenceMap | undefined {\n    return this.options.context?.refs ?? defaultContext?.refs;\n  }\n\n  /**\n   * Gets the context of this {@link Editor.JsonEditorState | JsonEditorState} or an optionally\n   * supplied default context if this state has no context.\n   * @param defaultContext - The default {@link IJsonContext | JSON context} to use as default\n   * if this state has no context.\n   * @returns The appropriate {@link IJsonContext | IJsonContext} or `undefined` if no context\n   * is available.\n   */\n  public getContext(defaultContext?: IJsonContext): IJsonContext | undefined {\n    return JsonContextHelper.mergeContext(defaultContext, this.options.context).orDefault();\n  }\n\n  /**\n   * Constructs a new {@link IJsonContext | IJsonContext} by merging supplied variables\n   * and references into a supplied existing context.\n   * @param baseContext - The {@link IJsonContext | IJsonContext} into which variables\n   * and references are to be merged, or `undefined` to start with a default empty context.\n   * @param add - The {@link VariableValue | variable values} and/or\n   * {@link IJsonReferenceMap | JSON entity references} to be merged into the base context.\n   * @returns A new {@link IJsonContext | IJsonContext} created by merging the supplied values.\n   */\n  public extendContext(\n    baseContext: IJsonContext | undefined,\n    add: { vars?: VariableValue[]; refs?: IJsonReferenceMap[] }\n  ): Result<IJsonContext | undefined> {\n    const context = this.getContext(baseContext);\n    return JsonContextHelper.extendContext(context, add);\n  }\n\n  /**\n   * Helper method to constructs  `DetailedFailure` with appropriate details and messaging\n   * for various validation failures.\n   * @param rule - The {@link Editor.JsonEditorValidationRules | validation rule} that failed.\n   * @param message -  A string message describing the failed validation.\n   * @param validation - The {@link Editor.IJsonEditorValidationOptions | validation options}\n   * in effect.\n   * @returns A `DetailedFailure` with appropriate detail and message.\n   */\n  public failValidation<T = JsonObject>(\n    rule: JsonEditorValidationRules,\n    message?: string,\n    validation?: IJsonEditorValidationOptions\n  ): DetailedFailure<T, JsonEditFailureReason> {\n    let detail: JsonPropertyEditFailureReason = 'error';\n    const effective = validation ?? this.options.validation;\n    switch (rule) {\n      case 'invalidPropertyName':\n        detail = effective.onInvalidPropertyName !== 'ignore' ? 'error' : 'inapplicable';\n        break;\n      case 'invalidPropertyValue':\n        detail = effective.onInvalidPropertyValue !== 'ignore' ? 'error' : 'ignore';\n        break;\n      case 'undefinedPropertyValue':\n        detail = effective.onUndefinedPropertyValue !== 'error' ? 'ignore' : 'error';\n        /* c8 ignore next */\n        message = message ?? 'Cannot convert undefined to JSON';\n        break;\n    }\n    /* c8 ignore next */\n    return failWithDetail(message ?? rule, detail);\n  }\n}\n"]}
+{"version":3,"file":"jsonEditorState.js","sourceRoot":"","sources":["../../../src/packlets/editor/jsonEditorState.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 { JsonObject } from '@fgv/ts-json-base';\nimport { DetailedFailure, Result, failWithDetail, succeed } from '@fgv/ts-utils';\nimport { IJsonContext, IJsonReferenceMap, JsonContextHelper, TemplateVars, VariableValue } from '../context';\nimport {\n  IJsonCloneEditor,\n  IJsonEditorOptions,\n  IJsonEditorValidationOptions,\n  JsonEditFailureReason,\n  JsonEditorValidationRules,\n  JsonPropertyEditFailureReason\n} from './common';\n\n/**\n * Represents the internal state of a {@link JsonEditor | JsonEditor}.\n * @public\n */\nexport class JsonEditorState {\n  /**\n   * Static global counter used to assign each {@link JsonEditorState | JsonEditorState}\n   * a unique identifier.\n   * @internal\n   */\n  protected static _nextId: number = 0;\n\n  /**\n   * The {@link IJsonCloneEditor | editor} for which this state applies.\n   */\n  public readonly editor: IJsonCloneEditor;\n\n  /**\n   * Fully resolved {@link IJsonEditorOptions | editor options} that apply\n   * to the operation for which this state applies.\n   */\n  public readonly options: IJsonEditorOptions;\n\n  /**\n   * Any deferred JSON objects to be merged during finalization.\n   * @internal\n   */\n  protected readonly _deferred: JsonObject[] = [];\n\n  /**\n   * Unique global identifier for this {@link JsonEditorState | state object}.\n   * @internal\n   */\n  protected readonly _id: number;\n\n  /**\n   * Constructs a new {@link JsonEditorState | JsonEditorState}.\n   * @param editor - The {@link IJsonCloneEditor | editor} to which this state\n   * applies.\n   * @param baseOptions - The {@link IJsonEditorOptions | editor options} that\n   * apply to this rule.\n   * @param runtimeContext - An optional {@link IJsonContext | JSON context} to be used\n   * for json value conversion.\n   */\n  public constructor(\n    editor: IJsonCloneEditor,\n    baseOptions: IJsonEditorOptions,\n    runtimeContext?: IJsonContext\n  ) {\n    this.editor = editor;\n    this.options = JsonEditorState._getEffectiveOptions(baseOptions, runtimeContext).orThrow();\n    this._id = JsonEditorState._nextId++;\n  }\n\n  /**\n   * The optional {@link IJsonContext | JSON context} for this state.\n   */\n  public get context(): IJsonContext | undefined {\n    return this.options.context;\n  }\n\n  /**\n   * An array of JSON objects that were deferred for merge during\n   * finalization.\n   */\n  public get deferred(): JsonObject[] {\n    return this._deferred;\n  }\n\n  /**\n   * Merges an optional {@link IJsonContext | JSON context} into a supplied set\n   * of {@link IJsonEditorOptions | JSON editor options}.\n   * @param options - The {@link IJsonEditorOptions | IJsonEditorOptions} into\n   * which the the new context is to be merged.\n   * @param context - The {@link IJsonContext | JSON context} to be merged into the\n   * editor options.\n   * @returns `Success` with the supplied {@link IJsonEditorOptions | options} if\n   * there was nothing to merge, or aa new {@link IJsonEditorOptions | IJsonEditorOptions}\n   * constructed from the base options merged with the supplied context.  Returns `Failure`\n   * with more information if an error occurs.\n   * @internal\n   */\n  protected static _getEffectiveOptions(\n    options: IJsonEditorOptions,\n    context?: IJsonContext\n  ): Result<IJsonEditorOptions> {\n    if (!context) {\n      return succeed(options);\n    }\n    return JsonContextHelper.mergeContext(options.context, context).onSuccess((merged) => {\n      return succeed({ context: merged, validation: options.validation });\n    });\n  }\n\n  /**\n   * Adds a supplied `JsonObject` to the deferred list.\n   * @param obj - The `JsonObject` to be deferred.\n   */\n  public defer(obj: JsonObject): void {\n    this._deferred.push(obj);\n  }\n\n  /**\n   * Gets a {@link TemplateVars | TemplateVars} from the context of this {@link JsonEditorState | JsonEditorState},\n   * or from an optional supplied {@link IJsonContext | IJsonContext} if the current state has no default\n   * context.\n   * @param defaultContext - An optional default {@link IJsonContext | IJsonContext} to use as `TemplateVars`\n   * if the current state does not have context.\n   * @returns A {@link TemplateVars | TemplateVars} reflecting the appropriate {@link IJsonContext | JSON context}, or\n   * `undefined` if no vars are found.\n   */\n  public getVars(defaultContext?: IJsonContext): TemplateVars | undefined {\n    return this.options.context?.vars ?? defaultContext?.vars;\n  }\n\n  /**\n   * Gets an {@link IJsonReferenceMap | reference map} containing any other values\n   * referenced during the operation.\n   * @param defaultContext - An optional default {@link IJsonContext | IJsonContext} to use as\n   * {@link TemplateVars | TemplateVars} if the current state does not have context.\n   * @returns An {@link IJsonReferenceMap | IJsonReferenceMap} containing any values referenced\n   * during this operation.\n   */\n  public getRefs(defaultContext?: IJsonContext): IJsonReferenceMap | undefined {\n    return this.options.context?.refs ?? defaultContext?.refs;\n  }\n\n  /**\n   * Gets the context of this {@link JsonEditorState | JsonEditorState} or an optionally\n   * supplied default context if this state has no context.\n   * @param defaultContext - The default {@link IJsonContext | JSON context} to use as default\n   * if this state has no context.\n   * @returns The appropriate {@link IJsonContext | IJsonContext} or `undefined` if no context\n   * is available.\n   */\n  public getContext(defaultContext?: IJsonContext): IJsonContext | undefined {\n    return JsonContextHelper.mergeContext(defaultContext, this.options.context).orDefault();\n  }\n\n  /**\n   * Constructs a new {@link IJsonContext | IJsonContext} by merging supplied variables\n   * and references into a supplied existing context.\n   * @param baseContext - The {@link IJsonContext | IJsonContext} into which variables\n   * and references are to be merged, or `undefined` to start with a default empty context.\n   * @param add - The {@link VariableValue | variable values} and/or\n   * {@link IJsonReferenceMap | JSON entity references} to be merged into the base context.\n   * @returns A new {@link IJsonContext | IJsonContext} created by merging the supplied values.\n   */\n  public extendContext(\n    baseContext: IJsonContext | undefined,\n    add: { vars?: VariableValue[]; refs?: IJsonReferenceMap[] }\n  ): Result<IJsonContext | undefined> {\n    const context = this.getContext(baseContext);\n    return JsonContextHelper.extendContext(context, add);\n  }\n\n  /**\n   * Helper method to constructs  `DetailedFailure` with appropriate details and messaging\n   * for various validation failures.\n   * @param rule - The {@link JsonEditorValidationRules | validation rule} that failed.\n   * @param message -  A string message describing the failed validation.\n   * @param validation - The {@link IJsonEditorValidationOptions | validation options}\n   * in effect.\n   * @returns A `DetailedFailure` with appropriate detail and message.\n   */\n  public failValidation<T = JsonObject>(\n    rule: JsonEditorValidationRules,\n    message?: string,\n    validation?: IJsonEditorValidationOptions\n  ): DetailedFailure<T, JsonEditFailureReason> {\n    let detail: JsonPropertyEditFailureReason = 'error';\n    const effective = validation ?? this.options.validation;\n    switch (rule) {\n      case 'invalidPropertyName':\n        detail = effective.onInvalidPropertyName !== 'ignore' ? 'error' : 'inapplicable';\n        break;\n      case 'invalidPropertyValue':\n        detail = effective.onInvalidPropertyValue !== 'ignore' ? 'error' : 'ignore';\n        break;\n      case 'undefinedPropertyValue':\n        detail = effective.onUndefinedPropertyValue !== 'error' ? 'ignore' : 'error';\n        /* c8 ignore next */\n        message = message ?? 'Cannot convert undefined to JSON';\n        break;\n    }\n    /* c8 ignore next */\n    return failWithDetail(message ?? rule, detail);\n  }\n}\n"]}

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

@@ -119,7 +119,6 @@ export type MapOrRecord<T> = Map<string, T> | Record<string, T>;
 /**
  * Abstract base class with common functionality for simple
  * {@link IJsonReferenceMap | reference map} implementations.
- * {@link JsonValue | json values}.
  * @public
  */
 export declare abstract class SimpleJsonMapBase<T> implements IJsonReferenceMap {
@@ -170,7 +169,7 @@ export declare abstract class SimpleJsonMapBase<T> implements IJsonReferenceMap
      */
     has(key: string): boolean;
     /**
-     * Gets a {@link JsonObject | JSON object} specified by key.
+     * Gets a `JsonObject` specified by key.
      * @param key - key of the object to be retrieved
      * @param context - optional {@link IJsonContext | JSON context} used to format the
      * returned object.
@@ -181,7 +180,7 @@ export declare abstract class SimpleJsonMapBase<T> implements IJsonReferenceMap
      */
     getJsonObject(key: string, context?: IJsonContext): DetailedResult<JsonObject, JsonReferenceMapFailureReason>;
     /**
-     * Gets a {@link JsonValue | JSON value} specified by key.
+     * Gets a `JsonValue` specified by key.
      * @param key - key of the value to be retrieved
      * @param context - Optional {@link IJsonContext | JSON context} used to format the value
      * @returns Success with the formatted object if successful. Failure with detail 'unknown'
@@ -200,7 +199,7 @@ export interface ISimpleJsonMapOptions {
 }
 /**
  * A {@link SimpleJsonMap | SimpleJsonMap } presents a view of a simple map
- * of {@link JsonValue | JSON values}.
+ * of JSON values.
  * @public
  */
 export declare class SimpleJsonMap extends SimpleJsonMapBase<JsonValue> {
@@ -210,7 +209,7 @@ export declare class SimpleJsonMap extends SimpleJsonMapBase<JsonValue> {
     protected _editor?: JsonEditor;
     /**
      * Constructs a new {@link SimpleJsonMap | SimpleJsonMap} from the supplied objects
-     * @param values - A string-keyed `Map` or `Record` of the {@link JsonValue | JSON values}
+     * @param values - A string-keyed `Map` or `Record` of the `JsonValue`
      * to be returned.
      * @param context - Optional {@link IJsonContext | IJsonContext} used to format returned values.
      * @param options - Optional {@link ISimpleJsonMapOptions | ISimpleJsonMapOptions} for initialization.
@@ -219,7 +218,7 @@ export declare class SimpleJsonMap extends SimpleJsonMapBase<JsonValue> {
     protected constructor(values?: MapOrRecord<JsonValue>, context?: IJsonContext, options?: ISimpleJsonMapOptions);
     /**
      * Creates a new {@link SimpleJsonMap | SimpleJsonMap} from the supplied objects
-     * @param values - A string-keyed `Map` or `Record` of the {@link JsonValue | JSON values}
+     * @param values - A string-keyed `Map` or `Record` of the `JsonValue`
      * to be returned.
      * @param context - Optional {@link IJsonContext | IJsonContext} used to format returned values.
      * @param options - Optional {@link ISimpleJsonMapOptions | ISimpleJsonMapOptions} for initialization.
@@ -228,7 +227,7 @@ export declare class SimpleJsonMap extends SimpleJsonMapBase<JsonValue> {
      */
     static createSimple(values?: MapOrRecord<JsonValue>, context?: IJsonContext, options?: ISimpleJsonMapOptions): Result<SimpleJsonMap>;
     /**
-     * Gets a {@link JsonValue | JSON value} specified by key.
+     * Gets a `JsonValue` specified by key.
      * @param key - key of the value to be retrieved
      * @param context - Optional {@link IJsonContext | JSON context} used to format the value
      * @returns Success with the formatted object if successful. Failure with detail 'unknown'
@@ -264,18 +263,18 @@ export declare class PrefixedJsonMap extends SimpleJsonMap {
     /**
      * Constructs a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values
      * @param prefix - A string prefix to be enforced for and added to key names as necessary
-     * @param values - A string-keyed Map or Record of the {@link JsonValue | JsonValue} to be returned
+     * @param values - A string-keyed Map or Record of the `JsonValue` to be returned
      * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values
-     * @param editor - Optional {@link Editor.JsonEditor | JsonEditor} used to format returned values
+     * @param editor - Optional {@link JsonEditor | JsonEditor} used to format returned values
      * @public
      */
     protected constructor(values?: MapOrRecord<JsonValue>, context?: IJsonContext, options?: ISimpleJsonMapOptions);
     /**
      * Creates a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values
      * @param prefix - A string prefix to be enforced for and added to key names as necessary
-     * @param values - A string-keyed Map or Record of the {@link JsonValue | JsonValue} to be returned
+     * @param values - A string-keyed Map or Record of the `JsonValue` to be returned
      * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values
-     * @param editor - Optional {@link Editor.JsonEditor | JsonEditor} used to format returned values
+     * @param editor - Optional {@link JsonEditor | JsonEditor} used to format returned values
      * @returns `Success` with a {@link PrefixedJsonMap | PrefixedJsonMap} or `Failure` with a message
      * if an error occurs.
      */
@@ -284,9 +283,9 @@ export declare class PrefixedJsonMap extends SimpleJsonMap {
      * Creates a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values
      * @param prefixOptions - A KeyPrefixOptions indicating the prefix to enforce and whether that prefix should
      * be added automatically if necessary (default true)
-     * @param values - A string-keyed Map or record of the {@link JsonValue | JsonValue} to be returned
+     * @param values - A string-keyed Map or record of the `JsonValue` to be returned
      * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values
-     * @param editor - Optional {@link Editor.JsonEditor | JsonEditor} used to format returned values
+     * @param editor - Optional {@link JsonEditor | JsonEditor} used to format returned values
      */
     static createPrefixed(prefixOptions: IKeyPrefixOptions, values?: MapOrRecord<JsonValue>, context?: IJsonContext, editor?: JsonEditor): Result<PrefixedJsonMap>;
     /**

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

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

package/lib/packlets/editor/jsonReferenceMap.js

@@ -151,7 +151,6 @@ exports.PrefixKeyPolicy = PrefixKeyPolicy;
 /**
  * Abstract base class with common functionality for simple
  * {@link IJsonReferenceMap | reference map} implementations.
- * {@link JsonValue | json values}.
  * @public
  */
 class SimpleJsonMapBase {
@@ -203,7 +202,7 @@ class SimpleJsonMapBase {
         return this._values.has(key);
     }
     /**
-     * Gets a {@link JsonObject | JSON object} specified by key.
+     * Gets a `JsonObject` specified by key.
      * @param key - key of the object to be retrieved
      * @param context - optional {@link IJsonContext | JSON context} used to format the
      * returned object.
@@ -224,13 +223,13 @@ class SimpleJsonMapBase {
 exports.SimpleJsonMapBase = SimpleJsonMapBase;
 /**
  * A {@link SimpleJsonMap | SimpleJsonMap } presents a view of a simple map
- * of {@link JsonValue | JSON values}.
+ * of JSON values.
  * @public
  */
 class SimpleJsonMap extends SimpleJsonMapBase {
     /**
      * Constructs a new {@link SimpleJsonMap | SimpleJsonMap} from the supplied objects
-     * @param values - A string-keyed `Map` or `Record` of the {@link JsonValue | JSON values}
+     * @param values - A string-keyed `Map` or `Record` of the `JsonValue`
      * to be returned.
      * @param context - Optional {@link IJsonContext | IJsonContext} used to format returned values.
      * @param options - Optional {@link ISimpleJsonMapOptions | ISimpleJsonMapOptions} for initialization.
@@ -242,7 +241,7 @@ class SimpleJsonMap extends SimpleJsonMapBase {
     }
     /**
      * Creates a new {@link SimpleJsonMap | SimpleJsonMap} from the supplied objects
-     * @param values - A string-keyed `Map` or `Record` of the {@link JsonValue | JSON values}
+     * @param values - A string-keyed `Map` or `Record` of the `JsonValue`
      * to be returned.
      * @param context - Optional {@link IJsonContext | IJsonContext} used to format returned values.
      * @param options - Optional {@link ISimpleJsonMapOptions | ISimpleJsonMapOptions} for initialization.
@@ -253,7 +252,7 @@ class SimpleJsonMap extends SimpleJsonMapBase {
         return (0, ts_utils_1.captureResult)(() => new SimpleJsonMap(values, context, options));
     }
     /**
-     * Gets a {@link JsonValue | JSON value} specified by key.
+     * Gets a `JsonValue` specified by key.
      * @param key - key of the value to be retrieved
      * @param context - Optional {@link IJsonContext | JSON context} used to format the value
      * @returns Success with the formatted object if successful. Failure with detail 'unknown'
@@ -293,9 +292,9 @@ class PrefixedJsonMap extends SimpleJsonMap {
     /**
      * Constructs a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values
      * @param prefix - A string prefix to be enforced for and added to key names as necessary
-     * @param values - A string-keyed Map or Record of the {@link JsonValue | JsonValue} to be returned
+     * @param values - A string-keyed Map or Record of the `JsonValue` to be returned
      * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values
-     * @param editor - Optional {@link Editor.JsonEditor | JsonEditor} used to format returned values
+     * @param editor - Optional {@link JsonEditor | JsonEditor} used to format returned values
      * @public
      */
     constructor(values, context, options) {

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

@@ -1 +1 @@
-{"version":3,"file":"jsonReferenceMap.js","sourceRoot":"","sources":["../../../src/packlets/editor/jsonReferenceMap.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  mapResults,\n  recordToMap,\n  succeed,\n  succeedWithDetail\n} from '@fgv/ts-utils';\n\nimport { JsonObject, JsonValue, isJsonObject } from '@fgv/ts-json-base';\nimport { IJsonContext, IJsonReferenceMap, JsonReferenceMapFailureReason } from '../context';\nimport { JsonEditor } from './jsonEditor';\n\n/**\n * Options for creating a {@link ReferenceMapKeyPolicy | ReferenceMapKeyPolicy} object.\n * @public\n */\nexport interface IReferenceMapKeyPolicyValidateOptions {\n  /**\n   * If `true`, the validator coerces keys to some valid value.\n   * If `false`, invalid keys cause an error.\n   */\n  makeValid?: boolean;\n}\n\n/**\n * Policy object responsible for validating or correcting\n * keys in a {@link IJsonReferenceMap | reference map}.\n * @public\n */\nexport class ReferenceMapKeyPolicy<T> {\n  /**\n   * @internal\n   */\n  protected readonly _defaultOptions?: IReferenceMapKeyPolicyValidateOptions;\n\n  /**\n   * @internal\n   */\n  protected readonly _isValid: (key: string, item?: T) => boolean;\n\n  /**\n   * Constructs a new {@link ReferenceMapKeyPolicy | ReferenceMapKeyPolicy}.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options}\n   * used to construct the {@link ReferenceMapKeyPolicy}.\n   * @param isValid - An optional predicate to test a supplied key for validity.\n   */\n  public constructor(\n    options?: IReferenceMapKeyPolicyValidateOptions,\n    isValid?: (key: string, item?: T) => boolean\n  ) {\n    this._defaultOptions = options;\n    this._isValid = isValid ?? ReferenceMapKeyPolicy.defaultKeyPredicate;\n  }\n\n  /**\n   * The static default key name validation predicate rejects keys that contain\n   * mustache templates or which start with the default conditional prefix\n   * `'?'`.\n   * @param key - The key to test.\n   * @returns `true` if the key is valid, `false` otherwise.\n   */\n  public static defaultKeyPredicate(key: string): boolean {\n    return key.length > 0 && !key.includes('{{') && !key.startsWith('?');\n  }\n\n  /**\n   * Determines if a supplied key and item are valid according to the current policy.\n   * @param key - The key to be tested.\n   * @param item - The item to be tested.\n   * @returns `true` if the key and value are valid, `false` otherwise.\n   */\n  public isValid(key: string, item?: T): boolean {\n    return this._isValid(key, item);\n  }\n\n  /**\n   * Determines if a supplied key and item are valid according to the current policy.\n   * @param key - The key to be tested.\n   * @param item - The item to be tested.\n   * @returns `Success` with the key if valid, `Failure` with an error message if invalid.\n   */\n  public validate(key: string, item?: T, __options?: IReferenceMapKeyPolicyValidateOptions): Result<string> {\n    return this.isValid(key, item) ? succeed(key) : fail(`${key}: invalid key`);\n  }\n\n  /**\n   * Validates an array of entries using the validation rules for this policy.\n   * @param items - The array of entries to be validated.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options} to control\n   * validation.\n   * @returns `Success` with an array of validated entries, or `Failure` with an error message\n   * if validation fails.\n   */\n  public validateItems(\n    items: [string, T][],\n    options?: IReferenceMapKeyPolicyValidateOptions\n  ): Result<[string, T][]> {\n    return mapResults(\n      items.map((item) => {\n        return this.validate(...item, options).onSuccess((valid) => {\n          return succeed([valid, item[1]]);\n        });\n      })\n    );\n  }\n\n  /**\n   * Validates a `Map\\<string, T\\>` using the validation rules for this policy.\n   * @param items - The `Map\\<string, T\\>` to be validated.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options} to control\n   * validation.\n   * @returns `Success` with a new `Map\\<string, T\\>`, or `Failure` with an error message\n   * if validation fails.\n   */\n  public validateMap(\n    map: Map<string, T>,\n    options?: IReferenceMapKeyPolicyValidateOptions\n  ): Result<Map<string, T>> {\n    return this.validateItems(Array.from(map.entries()), options).onSuccess((valid) => {\n      return captureResult(() => new Map(valid));\n    });\n  }\n}\n\n/**\n * A {@link PrefixKeyPolicy | PrefixKeyPolicy} enforces that all keys start with a supplied\n * prefix, optionally adding the prefix as necessary.\n * @public\n */\nexport class PrefixKeyPolicy<T> extends ReferenceMapKeyPolicy<T> {\n  /**\n   * The string prefix to be enforced by this policy.\n   */\n  public readonly prefix: string;\n\n  /**\n   * Constructs a new {@link PrefixKeyPolicy | PrefixKeyPolicy}.\n   * @param prefix - The string prefix to be enforced or applied.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options} to\n   * configure the policy.\n   */\n  public constructor(prefix: string, options?: IReferenceMapKeyPolicyValidateOptions) {\n    super(options);\n    this.prefix = prefix;\n  }\n\n  /**\n   * Determines if a key is valid according to policy.\n   * @param key - The key to be tested.\n   * @param __item - The item to be tested.\n   * @returns `true` if the key starts with the expected prefix, `false` otherwise.\n   */\n  public isValid(key: string, __item?: T): boolean {\n    return (\n      key.startsWith(this.prefix) && key !== this.prefix && ReferenceMapKeyPolicy.defaultKeyPredicate(key)\n    );\n  }\n\n  /**\n   * Determines if a key is valid according to policy, optionally coercing to a valid value by\n   * adding the required prefix.\n   * @param key - The key to be tested.\n   * @param item - The item which corresponds to the key.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options} to guide\n   * validation.\n   * @returns `Success` with a valid key name if the supplied key is valid or if `makeValid` is set\n   * in the policy options. Returns `Failure` with an error message if an error occurs.\n   */\n  public validate(key: string, item?: T, options?: IReferenceMapKeyPolicyValidateOptions): Result<string> {\n    /* c8 ignore next */\n    const makeValid = (options ?? this._defaultOptions)?.makeValid === true;\n    if (this.isValid(key, item)) {\n      return succeed(key);\n    } else if (makeValid && ReferenceMapKeyPolicy.defaultKeyPredicate(key)) {\n      return succeed(`${this.prefix}${key}`);\n    }\n    return fail(`${key}: invalid key`);\n  }\n}\n\n/**\n * Type representing either a `Map\\<string, T\\>` or a `Record\\<string, T\\>`.\n * @public\n */\nexport type MapOrRecord<T> = Map<string, T> | Record<string, T>;\n\n/**\n * Abstract base class with common functionality for simple\n * {@link IJsonReferenceMap | reference map} implementations.\n * {@link JsonValue | json values}.\n * @public\n */\nexport abstract class SimpleJsonMapBase<T> implements IJsonReferenceMap {\n  /**\n   * The {@link ReferenceMapKeyPolicy | key policy} in effect for this map.\n   * @internal\n   */\n  protected readonly _keyPolicy: ReferenceMapKeyPolicy<T>;\n\n  /**\n   * A map containing keys and values already present in this map.\n   * @internal\n   */\n  protected readonly _values: Map<string, T>;\n\n  /**\n   * An optional {@link IJsonContext | IJsonContext} used for any conversions\n   * involving items in this map.\n   * @internal\n   */\n  protected readonly _context?: IJsonContext;\n\n  /**\n   * Constructs a new {@link SimpleJsonMap | SimpleJsonMap}.\n   * @param values - Initial values for the map.\n   * @param context - An optional {@link IJsonContext | IJsonContext} used for any conversions\n   * involving items in this map.\n   * @param keyPolicy - The {@link ReferenceMapKeyPolicy | key policy} to use for this map.\n   * @internal\n   */\n  protected constructor(\n    values?: MapOrRecord<T>,\n    context?: IJsonContext,\n    keyPolicy?: ReferenceMapKeyPolicy<T>\n  ) {\n    values = SimpleJsonMapBase._toMap(values).orThrow();\n    this._keyPolicy = keyPolicy ?? new ReferenceMapKeyPolicy();\n    this._values = this._keyPolicy.validateMap(values).orThrow();\n    this._context = context;\n  }\n\n  /**\n   * Returns a `Map\\<string, T\\>` derived from a supplied {@link MapOrRecord | MapOrRecord}\n   * @param values - The {@link MapOrRecord | MapOrRecord} to be returned as a map.\n   * @returns `Success` with the corresponding `Map\\<string, T\\>` or `Failure` with a\n   * message if an error occurs.\n   * @internal\n   */\n  protected static _toMap<T>(values?: MapOrRecord<T>): Result<Map<string, T>> {\n    if (values === undefined) {\n      return captureResult(() => new Map<string, T>());\n    } else if (!(values instanceof Map)) {\n      return recordToMap(values, (__k, v) => succeed(v));\n    }\n    return succeed(values);\n  }\n\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 - 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._keyPolicy.isValid(key);\n  }\n\n  /**\n   * Determines if an entry with the specified key actually exists in the map.\n   * @param key - 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._values.has(key);\n  }\n\n  /**\n   * Gets a {@link JsonObject | JSON object} specified by key.\n   * @param key - key of the object to be retrieved\n   * @param context - optional {@link IJsonContext | JSON context} used to format the\n   * returned object.\n   * @returns {@link ts-utils#Success | `Success`} with the formatted object if successful.\n   * {@link ts-utils#Failure | `Failure`} with detail 'unknown' if no such object exists,\n   * or {@link ts-utils#Failure | `Failure`} with detail 'error' if the object was found\n   * but 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 {@link JsonValue | JSON value} specified by key.\n   * @param key - key of the value to be retrieved\n   * @param context - 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 abstract getJsonValue(\n    key: string,\n    context?: IJsonContext\n  ): DetailedResult<JsonValue, JsonReferenceMapFailureReason>;\n}\n\n/**\n * Initialization options for a {@link SimpleJsonMap | SimpleJsonMap}.\n * @public\n */\nexport interface ISimpleJsonMapOptions {\n  keyPolicy?: ReferenceMapKeyPolicy<JsonValue>;\n  editor?: JsonEditor;\n}\n\n/**\n * A {@link SimpleJsonMap | SimpleJsonMap } presents a view of a simple map\n * of {@link JsonValue | JSON values}.\n * @public\n */\nexport class SimpleJsonMap extends SimpleJsonMapBase<JsonValue> {\n  /**\n   * @internal\n   */\n  protected _editor?: JsonEditor;\n\n  /**\n   * Constructs a new {@link SimpleJsonMap | SimpleJsonMap} from the supplied objects\n   * @param values - A string-keyed `Map` or `Record` of the {@link JsonValue | JSON values}\n   * to be returned.\n   * @param context - Optional {@link IJsonContext | IJsonContext} used to format returned values.\n   * @param options - Optional {@link ISimpleJsonMapOptions | ISimpleJsonMapOptions} for initialization.\n   * @public\n   */\n  protected constructor(\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    options?: ISimpleJsonMapOptions\n  ) {\n    super(values, context, options?.keyPolicy);\n    this._editor = options?.editor;\n  }\n\n  /**\n   * Creates a new {@link SimpleJsonMap | SimpleJsonMap} from the supplied objects\n   * @param values - A string-keyed `Map` or `Record` of the {@link JsonValue | JSON values}\n   * to be returned.\n   * @param context - Optional {@link IJsonContext | IJsonContext} used to format returned values.\n   * @param options - Optional {@link ISimpleJsonMapOptions | ISimpleJsonMapOptions} for initialization.\n   * @returns `Success` with a {@link SimpleJsonMap | SimpleJsonMap} or `Failure` with a message if\n   * an error occurs.\n   */\n  public static createSimple(\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    options?: ISimpleJsonMapOptions\n  ): Result<SimpleJsonMap> {\n    return captureResult(() => new SimpleJsonMap(values, context, options));\n  }\n\n  /**\n   * Gets a {@link JsonValue | JSON value} specified by key.\n   * @param key - key of the value to be retrieved\n   * @param context - 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  public getJsonValue(\n    key: string,\n    context?: IJsonContext\n  ): DetailedResult<JsonValue, JsonReferenceMapFailureReason> {\n    context = context ?? this._context;\n    const value = this._values.get(key);\n    if (!value) {\n      return failWithDetail(`${key}: JSON value not found`, 'unknown');\n    }\n    return this._clone(value, context);\n  }\n\n  /**\n   * @internal\n   */\n  protected _clone(\n    value: JsonValue,\n    context?: IJsonContext\n  ): DetailedResult<JsonValue, JsonReferenceMapFailureReason> {\n    if (!this._editor) {\n      const result = JsonEditor.create();\n      /* c8 ignore next 3 - nearly impossible to reproduce */\n      if (result.isFailure()) {\n        return failWithDetail(result.message, 'error');\n      }\n      this._editor = result.value;\n    }\n    return this._editor.clone(value, context).withFailureDetail('error');\n  }\n}\n\n/**\n * Initialization options for a {@link PrefixedJsonMap | PrefixedJsonMap}\n * @public\n */\nexport interface IKeyPrefixOptions {\n  /**\n   * Indicates whether the prefix should be added automatically as needed (default true)\n   */\n  addPrefix?: boolean;\n\n  /**\n   * The prefix to be enforced\n   */\n  prefix: string;\n}\n\n/**\n * A {@link PrefixedJsonMap | PrefixedJsonMap} enforces a supplied prefix for all contained values,\n * optionally adding the prefix as necessary (default `true`).\n * @public\n */\nexport class PrefixedJsonMap extends SimpleJsonMap {\n  /**\n   * Constructs a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values\n   * @param prefix - A string prefix to be enforced for and added to key names as necessary\n   * @param values - A string-keyed Map or Record of the {@link JsonValue | JsonValue} to be returned\n   * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values\n   * @param editor - Optional {@link Editor.JsonEditor | JsonEditor} used to format returned values\n   * @public\n   */\n  protected constructor(\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    options?: ISimpleJsonMapOptions\n  ) {\n    super(values, context, options);\n  }\n\n  /**\n   * Creates a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values\n   * @param prefix - A string prefix to be enforced for and added to key names as necessary\n   * @param values - A string-keyed Map or Record of the {@link JsonValue | JsonValue} to be returned\n   * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values\n   * @param editor - Optional {@link Editor.JsonEditor | JsonEditor} used to format returned values\n   * @returns `Success` with a {@link PrefixedJsonMap | PrefixedJsonMap} or `Failure` with a message\n   * if an error occurs.\n   */\n  public static createPrefixed(\n    prefix: string,\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    editor?: JsonEditor\n  ): Result<PrefixedJsonMap>;\n\n  /**\n   * Creates a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values\n   * @param prefixOptions - A KeyPrefixOptions indicating the prefix to enforce and whether that prefix should\n   * be added automatically if necessary (default true)\n   * @param values - A string-keyed Map or record of the {@link JsonValue | JsonValue} to be returned\n   * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values\n   * @param editor - Optional {@link Editor.JsonEditor | JsonEditor} used to format returned values\n   */\n  public static createPrefixed(\n    prefixOptions: IKeyPrefixOptions,\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    editor?: JsonEditor\n  ): Result<PrefixedJsonMap>;\n  public static createPrefixed(\n    prefixOptions: string | IKeyPrefixOptions,\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    editor?: JsonEditor\n  ): Result<PrefixedJsonMap> {\n    return captureResult(\n      () => new PrefixedJsonMap(values, context, { keyPolicy: this._toPolicy(prefixOptions), editor })\n    );\n  }\n\n  /**\n   * Constructs a new {@link PrefixKeyPolicy | PrefixKeyPolicy} from a supplied prefix\n   * or set of {@link IKeyPrefixOptions | prefix options}.\n   * @param prefixOptions - The prefix or {@link IKeyPrefixOptions | prefix options} or options\n   * for the new policy.\n   * @returns A new {@link ReferenceMapKeyPolicy | ReferenceMapKeyPolicy} which enforces the\n   * supplied prefix or options.\n   * @internal\n   */\n  protected static _toPolicy(prefixOptions: string | IKeyPrefixOptions): ReferenceMapKeyPolicy<JsonValue> {\n    if (typeof prefixOptions === 'string') {\n      return new PrefixKeyPolicy(prefixOptions, { makeValid: true });\n    }\n    return new PrefixKeyPolicy(prefixOptions.prefix, { makeValid: prefixOptions.addPrefix !== false });\n  }\n}\n"]}
+{"version":3,"file":"jsonReferenceMap.js","sourceRoot":"","sources":["../../../src/packlets/editor/jsonReferenceMap.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  mapResults,\n  recordToMap,\n  succeed,\n  succeedWithDetail\n} from '@fgv/ts-utils';\n\nimport { JsonObject, JsonValue, isJsonObject } from '@fgv/ts-json-base';\nimport { IJsonContext, IJsonReferenceMap, JsonReferenceMapFailureReason } from '../context';\nimport { JsonEditor } from './jsonEditor';\n\n/**\n * Options for creating a {@link ReferenceMapKeyPolicy | ReferenceMapKeyPolicy} object.\n * @public\n */\nexport interface IReferenceMapKeyPolicyValidateOptions {\n  /**\n   * If `true`, the validator coerces keys to some valid value.\n   * If `false`, invalid keys cause an error.\n   */\n  makeValid?: boolean;\n}\n\n/**\n * Policy object responsible for validating or correcting\n * keys in a {@link IJsonReferenceMap | reference map}.\n * @public\n */\nexport class ReferenceMapKeyPolicy<T> {\n  /**\n   * @internal\n   */\n  protected readonly _defaultOptions?: IReferenceMapKeyPolicyValidateOptions;\n\n  /**\n   * @internal\n   */\n  protected readonly _isValid: (key: string, item?: T) => boolean;\n\n  /**\n   * Constructs a new {@link ReferenceMapKeyPolicy | ReferenceMapKeyPolicy}.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options}\n   * used to construct the {@link ReferenceMapKeyPolicy}.\n   * @param isValid - An optional predicate to test a supplied key for validity.\n   */\n  public constructor(\n    options?: IReferenceMapKeyPolicyValidateOptions,\n    isValid?: (key: string, item?: T) => boolean\n  ) {\n    this._defaultOptions = options;\n    this._isValid = isValid ?? ReferenceMapKeyPolicy.defaultKeyPredicate;\n  }\n\n  /**\n   * The static default key name validation predicate rejects keys that contain\n   * mustache templates or which start with the default conditional prefix\n   * `'?'`.\n   * @param key - The key to test.\n   * @returns `true` if the key is valid, `false` otherwise.\n   */\n  public static defaultKeyPredicate(key: string): boolean {\n    return key.length > 0 && !key.includes('{{') && !key.startsWith('?');\n  }\n\n  /**\n   * Determines if a supplied key and item are valid according to the current policy.\n   * @param key - The key to be tested.\n   * @param item - The item to be tested.\n   * @returns `true` if the key and value are valid, `false` otherwise.\n   */\n  public isValid(key: string, item?: T): boolean {\n    return this._isValid(key, item);\n  }\n\n  /**\n   * Determines if a supplied key and item are valid according to the current policy.\n   * @param key - The key to be tested.\n   * @param item - The item to be tested.\n   * @returns `Success` with the key if valid, `Failure` with an error message if invalid.\n   */\n  public validate(key: string, item?: T, __options?: IReferenceMapKeyPolicyValidateOptions): Result<string> {\n    return this.isValid(key, item) ? succeed(key) : fail(`${key}: invalid key`);\n  }\n\n  /**\n   * Validates an array of entries using the validation rules for this policy.\n   * @param items - The array of entries to be validated.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options} to control\n   * validation.\n   * @returns `Success` with an array of validated entries, or `Failure` with an error message\n   * if validation fails.\n   */\n  public validateItems(\n    items: [string, T][],\n    options?: IReferenceMapKeyPolicyValidateOptions\n  ): Result<[string, T][]> {\n    return mapResults(\n      items.map((item) => {\n        return this.validate(...item, options).onSuccess((valid) => {\n          return succeed([valid, item[1]]);\n        });\n      })\n    );\n  }\n\n  /**\n   * Validates a `Map\\<string, T\\>` using the validation rules for this policy.\n   * @param items - The `Map\\<string, T\\>` to be validated.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options} to control\n   * validation.\n   * @returns `Success` with a new `Map\\<string, T\\>`, or `Failure` with an error message\n   * if validation fails.\n   */\n  public validateMap(\n    map: Map<string, T>,\n    options?: IReferenceMapKeyPolicyValidateOptions\n  ): Result<Map<string, T>> {\n    return this.validateItems(Array.from(map.entries()), options).onSuccess((valid) => {\n      return captureResult(() => new Map(valid));\n    });\n  }\n}\n\n/**\n * A {@link PrefixKeyPolicy | PrefixKeyPolicy} enforces that all keys start with a supplied\n * prefix, optionally adding the prefix as necessary.\n * @public\n */\nexport class PrefixKeyPolicy<T> extends ReferenceMapKeyPolicy<T> {\n  /**\n   * The string prefix to be enforced by this policy.\n   */\n  public readonly prefix: string;\n\n  /**\n   * Constructs a new {@link PrefixKeyPolicy | PrefixKeyPolicy}.\n   * @param prefix - The string prefix to be enforced or applied.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options} to\n   * configure the policy.\n   */\n  public constructor(prefix: string, options?: IReferenceMapKeyPolicyValidateOptions) {\n    super(options);\n    this.prefix = prefix;\n  }\n\n  /**\n   * Determines if a key is valid according to policy.\n   * @param key - The key to be tested.\n   * @param __item - The item to be tested.\n   * @returns `true` if the key starts with the expected prefix, `false` otherwise.\n   */\n  public isValid(key: string, __item?: T): boolean {\n    return (\n      key.startsWith(this.prefix) && key !== this.prefix && ReferenceMapKeyPolicy.defaultKeyPredicate(key)\n    );\n  }\n\n  /**\n   * Determines if a key is valid according to policy, optionally coercing to a valid value by\n   * adding the required prefix.\n   * @param key - The key to be tested.\n   * @param item - The item which corresponds to the key.\n   * @param options - Optional {@link IReferenceMapKeyPolicyValidateOptions | options} to guide\n   * validation.\n   * @returns `Success` with a valid key name if the supplied key is valid or if `makeValid` is set\n   * in the policy options. Returns `Failure` with an error message if an error occurs.\n   */\n  public validate(key: string, item?: T, options?: IReferenceMapKeyPolicyValidateOptions): Result<string> {\n    /* c8 ignore next */\n    const makeValid = (options ?? this._defaultOptions)?.makeValid === true;\n    if (this.isValid(key, item)) {\n      return succeed(key);\n    } else if (makeValid && ReferenceMapKeyPolicy.defaultKeyPredicate(key)) {\n      return succeed(`${this.prefix}${key}`);\n    }\n    return fail(`${key}: invalid key`);\n  }\n}\n\n/**\n * Type representing either a `Map\\<string, T\\>` or a `Record\\<string, T\\>`.\n * @public\n */\nexport type MapOrRecord<T> = Map<string, T> | Record<string, T>;\n\n/**\n * Abstract base class with common functionality for simple\n * {@link IJsonReferenceMap | reference map} implementations.\n * @public\n */\nexport abstract class SimpleJsonMapBase<T> implements IJsonReferenceMap {\n  /**\n   * The {@link ReferenceMapKeyPolicy | key policy} in effect for this map.\n   * @internal\n   */\n  protected readonly _keyPolicy: ReferenceMapKeyPolicy<T>;\n\n  /**\n   * A map containing keys and values already present in this map.\n   * @internal\n   */\n  protected readonly _values: Map<string, T>;\n\n  /**\n   * An optional {@link IJsonContext | IJsonContext} used for any conversions\n   * involving items in this map.\n   * @internal\n   */\n  protected readonly _context?: IJsonContext;\n\n  /**\n   * Constructs a new {@link SimpleJsonMap | SimpleJsonMap}.\n   * @param values - Initial values for the map.\n   * @param context - An optional {@link IJsonContext | IJsonContext} used for any conversions\n   * involving items in this map.\n   * @param keyPolicy - The {@link ReferenceMapKeyPolicy | key policy} to use for this map.\n   * @internal\n   */\n  protected constructor(\n    values?: MapOrRecord<T>,\n    context?: IJsonContext,\n    keyPolicy?: ReferenceMapKeyPolicy<T>\n  ) {\n    values = SimpleJsonMapBase._toMap(values).orThrow();\n    this._keyPolicy = keyPolicy ?? new ReferenceMapKeyPolicy();\n    this._values = this._keyPolicy.validateMap(values).orThrow();\n    this._context = context;\n  }\n\n  /**\n   * Returns a `Map\\<string, T\\>` derived from a supplied {@link MapOrRecord | MapOrRecord}\n   * @param values - The {@link MapOrRecord | MapOrRecord} to be returned as a map.\n   * @returns `Success` with the corresponding `Map\\<string, T\\>` or `Failure` with a\n   * message if an error occurs.\n   * @internal\n   */\n  protected static _toMap<T>(values?: MapOrRecord<T>): Result<Map<string, T>> {\n    if (values === undefined) {\n      return captureResult(() => new Map<string, T>());\n    } else if (!(values instanceof Map)) {\n      return recordToMap(values, (__k, v) => succeed(v));\n    }\n    return succeed(values);\n  }\n\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 - 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._keyPolicy.isValid(key);\n  }\n\n  /**\n   * Determines if an entry with the specified key actually exists in the map.\n   * @param key - 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._values.has(key);\n  }\n\n  /**\n   * Gets a `JsonObject` specified by key.\n   * @param key - key of the object to be retrieved\n   * @param context - optional {@link IJsonContext | JSON context} used to format the\n   * returned object.\n   * @returns {@link ts-utils#Success | `Success`} with the formatted object if successful.\n   * {@link ts-utils#Failure | `Failure`} with detail 'unknown' if no such object exists,\n   * or {@link ts-utils#Failure | `Failure`} with detail 'error' if the object was found\n   * but 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 `JsonValue` specified by key.\n   * @param key - key of the value to be retrieved\n   * @param context - 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 abstract getJsonValue(\n    key: string,\n    context?: IJsonContext\n  ): DetailedResult<JsonValue, JsonReferenceMapFailureReason>;\n}\n\n/**\n * Initialization options for a {@link SimpleJsonMap | SimpleJsonMap}.\n * @public\n */\nexport interface ISimpleJsonMapOptions {\n  keyPolicy?: ReferenceMapKeyPolicy<JsonValue>;\n  editor?: JsonEditor;\n}\n\n/**\n * A {@link SimpleJsonMap | SimpleJsonMap } presents a view of a simple map\n * of JSON values.\n * @public\n */\nexport class SimpleJsonMap extends SimpleJsonMapBase<JsonValue> {\n  /**\n   * @internal\n   */\n  protected _editor?: JsonEditor;\n\n  /**\n   * Constructs a new {@link SimpleJsonMap | SimpleJsonMap} from the supplied objects\n   * @param values - A string-keyed `Map` or `Record` of the `JsonValue`\n   * to be returned.\n   * @param context - Optional {@link IJsonContext | IJsonContext} used to format returned values.\n   * @param options - Optional {@link ISimpleJsonMapOptions | ISimpleJsonMapOptions} for initialization.\n   * @public\n   */\n  protected constructor(\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    options?: ISimpleJsonMapOptions\n  ) {\n    super(values, context, options?.keyPolicy);\n    this._editor = options?.editor;\n  }\n\n  /**\n   * Creates a new {@link SimpleJsonMap | SimpleJsonMap} from the supplied objects\n   * @param values - A string-keyed `Map` or `Record` of the `JsonValue`\n   * to be returned.\n   * @param context - Optional {@link IJsonContext | IJsonContext} used to format returned values.\n   * @param options - Optional {@link ISimpleJsonMapOptions | ISimpleJsonMapOptions} for initialization.\n   * @returns `Success` with a {@link SimpleJsonMap | SimpleJsonMap} or `Failure` with a message if\n   * an error occurs.\n   */\n  public static createSimple(\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    options?: ISimpleJsonMapOptions\n  ): Result<SimpleJsonMap> {\n    return captureResult(() => new SimpleJsonMap(values, context, options));\n  }\n\n  /**\n   * Gets a `JsonValue` specified by key.\n   * @param key - key of the value to be retrieved\n   * @param context - 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  public getJsonValue(\n    key: string,\n    context?: IJsonContext\n  ): DetailedResult<JsonValue, JsonReferenceMapFailureReason> {\n    context = context ?? this._context;\n    const value = this._values.get(key);\n    if (!value) {\n      return failWithDetail(`${key}: JSON value not found`, 'unknown');\n    }\n    return this._clone(value, context);\n  }\n\n  /**\n   * @internal\n   */\n  protected _clone(\n    value: JsonValue,\n    context?: IJsonContext\n  ): DetailedResult<JsonValue, JsonReferenceMapFailureReason> {\n    if (!this._editor) {\n      const result = JsonEditor.create();\n      /* c8 ignore next 3 - nearly impossible to reproduce */\n      if (result.isFailure()) {\n        return failWithDetail(result.message, 'error');\n      }\n      this._editor = result.value;\n    }\n    return this._editor.clone(value, context).withFailureDetail('error');\n  }\n}\n\n/**\n * Initialization options for a {@link PrefixedJsonMap | PrefixedJsonMap}\n * @public\n */\nexport interface IKeyPrefixOptions {\n  /**\n   * Indicates whether the prefix should be added automatically as needed (default true)\n   */\n  addPrefix?: boolean;\n\n  /**\n   * The prefix to be enforced\n   */\n  prefix: string;\n}\n\n/**\n * A {@link PrefixedJsonMap | PrefixedJsonMap} enforces a supplied prefix for all contained values,\n * optionally adding the prefix as necessary (default `true`).\n * @public\n */\nexport class PrefixedJsonMap extends SimpleJsonMap {\n  /**\n   * Constructs a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values\n   * @param prefix - A string prefix to be enforced for and added to key names as necessary\n   * @param values - A string-keyed Map or Record of the `JsonValue` to be returned\n   * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values\n   * @param editor - Optional {@link JsonEditor | JsonEditor} used to format returned values\n   * @public\n   */\n  protected constructor(\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    options?: ISimpleJsonMapOptions\n  ) {\n    super(values, context, options);\n  }\n\n  /**\n   * Creates a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values\n   * @param prefix - A string prefix to be enforced for and added to key names as necessary\n   * @param values - A string-keyed Map or Record of the `JsonValue` to be returned\n   * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values\n   * @param editor - Optional {@link JsonEditor | JsonEditor} used to format returned values\n   * @returns `Success` with a {@link PrefixedJsonMap | PrefixedJsonMap} or `Failure` with a message\n   * if an error occurs.\n   */\n  public static createPrefixed(\n    prefix: string,\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    editor?: JsonEditor\n  ): Result<PrefixedJsonMap>;\n\n  /**\n   * Creates a new {@link PrefixedJsonMap | PrefixedJsonMap} from the supplied values\n   * @param prefixOptions - A KeyPrefixOptions indicating the prefix to enforce and whether that prefix should\n   * be added automatically if necessary (default true)\n   * @param values - A string-keyed Map or record of the `JsonValue` to be returned\n   * @param context - Optional {@link IJsonContext | JSON Context} used to format returned values\n   * @param editor - Optional {@link JsonEditor | JsonEditor} used to format returned values\n   */\n  public static createPrefixed(\n    prefixOptions: IKeyPrefixOptions,\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    editor?: JsonEditor\n  ): Result<PrefixedJsonMap>;\n  public static createPrefixed(\n    prefixOptions: string | IKeyPrefixOptions,\n    values?: MapOrRecord<JsonValue>,\n    context?: IJsonContext,\n    editor?: JsonEditor\n  ): Result<PrefixedJsonMap> {\n    return captureResult(\n      () => new PrefixedJsonMap(values, context, { keyPolicy: this._toPolicy(prefixOptions), editor })\n    );\n  }\n\n  /**\n   * Constructs a new {@link PrefixKeyPolicy | PrefixKeyPolicy} from a supplied prefix\n   * or set of {@link IKeyPrefixOptions | prefix options}.\n   * @param prefixOptions - The prefix or {@link IKeyPrefixOptions | prefix options} or options\n   * for the new policy.\n   * @returns A new {@link ReferenceMapKeyPolicy | ReferenceMapKeyPolicy} which enforces the\n   * supplied prefix or options.\n   * @internal\n   */\n  protected static _toPolicy(prefixOptions: string | IKeyPrefixOptions): ReferenceMapKeyPolicy<JsonValue> {\n    if (typeof prefixOptions === 'string') {\n      return new PrefixKeyPolicy(prefixOptions, { makeValid: true });\n    }\n    return new PrefixKeyPolicy(prefixOptions.prefix, { makeValid: prefixOptions.addPrefix !== false });\n  }\n}\n"]}