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

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.42.1"
+      "packageVersion": "7.43.4"
     }
   ]
 }

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

@@ -39,7 +39,7 @@ export declare class CompositeJsonMap implements IJsonReferenceMap {
      */
     has(key: string): boolean;
     /**
-     * Gets a {@link JsonObject | JSON object} specified by key.
+     * Gets a JSON object specified by key.
      * @param key - The key of the object to be retrieved.
      * @param context - An optional {@link IJsonContext | JSON Context} used to format the object.
      * @returns `Success` with the formatted object if successful. `Failure` with detail `'unknown'`
@@ -48,7 +48,7 @@ export declare class CompositeJsonMap implements IJsonReferenceMap {
      */
     getJsonObject(key: string, context?: IJsonContext): DetailedResult<JsonObject, JsonReferenceMapFailureReason>;
     /**
-     * Gets a {@link JsonValue | JSON value} specified by key.
+     * Gets a JSON value specified by key.
      * @param key - The key of the object to be retrieved.
      * @param context - An optional {@link IJsonContext | JSON Context} used to format the value.
      * @returns `Success` with the formatted object if successful. `Failure` with detail `'unknown'`

package/lib/packlets/context/compositeJsonMap.js

@@ -65,7 +65,7 @@ class CompositeJsonMap {
         return this._maps.find((map) => map.has(key)) !== undefined;
     }
     /**
-     * Gets a {@link JsonObject | JSON object} specified by key.
+     * Gets a JSON object specified by key.
      * @param key - The key of the object to be retrieved.
      * @param context - An optional {@link IJsonContext | JSON Context} used to format the object.
      * @returns `Success` with the formatted object if successful. `Failure` with detail `'unknown'`
@@ -81,7 +81,7 @@ class CompositeJsonMap {
         });
     }
     /**
-     * Gets a {@link JsonValue | JSON value} specified by key.
+     * Gets a JSON value specified by key.
      * @param key - The key of the object to be retrieved.
      * @param context - An optional {@link IJsonContext | JSON Context} used to format the value.
      * @returns `Success` with the formatted object if successful. `Failure` with detail `'unknown'`

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

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

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

@@ -90,7 +90,7 @@ export declare class JsonContextHelper {
      */
     extendRefs(refs?: IJsonReferenceMap[]): Result<IJsonReferenceMap | undefined>;
     /**
-     * Applies {@link JsonContextHelper.(extendContext:static) | extendContext} to the
+     * Applies static `JsonContextHelper.extendContext` to the
      * {@link IJsonContext | IJsonContext} associated with this helper.
      * @param add - Optional initializer containing {@link VariableValue | variable values} and/or
      * {@link IJsonReferenceMap | reference maps} to be added to the {@link IJsonContext | context}.
@@ -103,7 +103,7 @@ export declare class JsonContextHelper {
         refs?: IJsonReferenceMap[];
     }): Result<IJsonContext | undefined>;
     /**
-     * Applies {@link JsonContextHelper.(mergeContext:static) | mergeContext} to the
+     * Applies static `JsonContextHelper.mergeContext` to the
      * {@link IJsonContext | IJsonContext} associated with this helper.
      * @param add - Optional initializer containing {@link VariableValue | variable values} and/or
      * {@link IJsonReferenceMap | reference maps} to be added to the {@link IJsonContext | context}.

package/lib/packlets/context/contextHelpers.js

@@ -163,7 +163,7 @@ class JsonContextHelper {
         return JsonContextHelper.extendContextRefs(this._context, refs);
     }
     /**
-     * Applies {@link JsonContextHelper.(extendContext:static) | extendContext} to the
+     * Applies static `JsonContextHelper.extendContext` to the
      * {@link IJsonContext | IJsonContext} associated with this helper.
      * @param add - Optional initializer containing {@link VariableValue | variable values} and/or
      * {@link IJsonReferenceMap | reference maps} to be added to the {@link IJsonContext | context}.
@@ -175,7 +175,7 @@ class JsonContextHelper {
         return JsonContextHelper.extendContext(this._context, add);
     }
     /**
-     * Applies {@link JsonContextHelper.(mergeContext:static) | mergeContext} to the
+     * Applies static `JsonContextHelper.mergeContext` to the
      * {@link IJsonContext | IJsonContext} associated with this helper.
      * @param add - Optional initializer containing {@link VariableValue | variable values} and/or
      * {@link IJsonReferenceMap | reference maps} to be added to the {@link IJsonContext | context}.

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

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

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

@@ -34,7 +34,7 @@ export declare function defaultExtendVars(base: TemplateVars | undefined, values
  */
 export type JsonReferenceMapFailureReason = 'unknown' | 'error';
 /**
- * Interface for a simple map that returns named {@link JsonValue | JsonValue} values with templating,
+ * Interface for a simple map that returns named `JsonValue` values with templating,
  * conditional logic, and external reference lookups applied using an optionally supplied context.
  * @public
  */
@@ -53,20 +53,20 @@ export interface IJsonReferenceMap {
      */
     has(key: string): boolean;
     /**
-     * Gets a {@link JsonObject | JsonObject} specified by key.
+     * Gets a `JsonObject` specified by key.
      * @param key - The key of the object to be retrieved.
      * @param context - Optional {@link IJsonContext | IJsonContext} used to construct
      * the object.
-     * @returns `Success` with the formatted {@link JsonObject | object} if successful. `Failure`
+     * @returns `Success` with the formatted JsonObject if successful. `Failure`
      * with detail `'unknown'`  if no such object exists, or `Failure` with detail `'error'` if
      * the object was found but could not be formatted.
      */
     getJsonObject(key: string, context?: IJsonContext): DetailedResult<JsonObject, JsonReferenceMapFailureReason>;
     /**
-     * Gets a {@link JsonValue | JsonValue} specified by key.
+     * Gets a `JsonValue` specified by key.
      * @param key - The key of the object to be retrieved.
      * @param context - Optional {@link IJsonContext | JSON Context} used to format the value
-     * @returns `Success` with the formatted {@link JsonValue | value} if successful. `Failure`
+     * @returns `Success` with the formatted `JsonValue` if successful. `Failure`
      * with detail `'unknown'` if no such object exists, or `Failure` with detail `'error'` if
      * the object was found but could not be formatted.
      */

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

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

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

@@ -10,14 +10,14 @@ import { ConditionalJsonConverterOptions, JsonConverter, RichJsonConverterOption
 export declare const json: JsonConverter;
 /**
  * A simple validating {@link JsonConverter | JSON converter}. Converts unknown
- * to a {@link JsonObject | JsonObject}, or fails if the `unknown` contains invalid
+ * to a `JsonObject`, or fails if the `unknown` contains invalid
  * JSON or is not an object.
  * @public
  */
 export declare const jsonObject: Converter<JsonObject, IJsonContext>;
 /**
  * A simple validating {@link JsonConverter | JSON converter}. Converts `unknown` to a
- * {@link JsonArray | JsonArray}, or fails if the unknown contains invalid JSON or is
+ * `JsonArray`, or fails if the unknown contains invalid JSON or is
  * not an array.
  * @public
  */

package/lib/packlets/converters/converters.js

@@ -31,14 +31,14 @@ const jsonConverter_1 = require("./jsonConverter");
 exports.json = new jsonConverter_1.JsonConverter();
 /**
  * A simple validating {@link JsonConverter | JSON converter}. Converts unknown
- * to a {@link JsonObject | JsonObject}, or fails if the `unknown` contains invalid
+ * to a `JsonObject`, or fails if the `unknown` contains invalid
  * JSON or is not an object.
  * @public
  */
 exports.jsonObject = exports.json.object();
 /**
  * A simple validating {@link JsonConverter | JSON converter}. Converts `unknown` to a
- * {@link JsonArray | JsonArray}, or fails if the unknown contains invalid JSON or is
+ * `JsonArray`, or fails if the unknown contains invalid JSON or is
  * not an array.
  * @public
  */

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

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

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

@@ -117,7 +117,7 @@ export declare function mergeDefaultJsonConverterOptions(partial?: Partial<IJson
  */
 export declare function contextFromConverterOptions(partial?: Partial<IJsonConverterOptions>): IJsonContext | undefined;
 /**
- * Creates a new {@link Editor.JsonEditor | JsonEditor} from an optionally supplied partial
+ * Creates a new {@link JsonEditor | JsonEditor} from an optionally supplied partial
  * {@link IJsonConverterOptions | JSON converter options}.
  * Expands supplied options with default values and constructs an editor with
  * matching configuration and defined rules.
@@ -127,30 +127,30 @@ export declare function contextFromConverterOptions(partial?: Partial<IJsonConve
  */
 export declare function converterOptionsToEditor(partial?: Partial<IJsonConverterOptions>): Result<JsonEditor>;
 /**
- * A thin wrapper to allow an arbitrary {@link Editor.JsonEditor | JsonEditor} to be used via the
+ * A thin wrapper to allow an arbitrary {@link JsonEditor | JsonEditor} to be used via the
  * \@fgv/ts-utils `Converter` pattern.
  * @public
  */
 export declare class JsonEditorConverter extends Conversion.BaseConverter<JsonValue, IJsonContext> {
     readonly editor: JsonEditor;
     /**
-     * Constructs a new {@link Editor.JsonEditor | JsonEditor}Converter which uses the supplied editor
+     * Constructs a new {@link JsonEditor | JsonEditor}Converter which uses the supplied editor
      * @param editor -
      */
     constructor(editor: JsonEditor);
     /**
-     * Constructs a new {@link Editor.JsonEditor | JsonEditor}Converter which uses the supplied editor
+     * Constructs a new {@link JsonEditor | JsonEditor}Converter which uses the supplied editor
      * @param editor -
      */
     static createWithEditor(editor: JsonEditor): Result<JsonEditorConverter>;
     /**
      * Gets a derived converter which fails if the resulting converted
-     * {@link JsonValue | JsonValue} is not a {@link JsonObject | JsonObject}.
+     * `JsonValue` is not a `JsonObject`.
      */
     object(): Converter<JsonObject, IJsonContext>;
     /**
      * Gets a derived converter which fails if the resulting converted
-     * {@link JsonValue | JsonValue} is not a {@link JsonArray | JsonArray}.
+     * `JsonValue` is not a `JsonArray`.
      */
     array(): Converter<JsonArray, IJsonContext>;
     protected _convert(from: unknown, context?: IJsonContext): Result<JsonValue>;

package/lib/packlets/converters/jsonConverter.js

@@ -86,7 +86,7 @@ function contextFromConverterOptions(partial) {
 }
 exports.contextFromConverterOptions = contextFromConverterOptions;
 /**
- * Creates a new {@link Editor.JsonEditor | JsonEditor} from an optionally supplied partial
+ * Creates a new {@link JsonEditor | JsonEditor} from an optionally supplied partial
  * {@link IJsonConverterOptions | JSON converter options}.
  * Expands supplied options with default values and constructs an editor with
  * matching configuration and defined rules.
@@ -122,13 +122,13 @@ function converterOptionsToEditor(partial) {
 }
 exports.converterOptionsToEditor = converterOptionsToEditor;
 /**
- * A thin wrapper to allow an arbitrary {@link Editor.JsonEditor | JsonEditor} to be used via the
+ * A thin wrapper to allow an arbitrary {@link JsonEditor | JsonEditor} to be used via the
  * \@fgv/ts-utils `Converter` pattern.
  * @public
  */
 class JsonEditorConverter extends ts_utils_1.Conversion.BaseConverter {
     /**
-     * Constructs a new {@link Editor.JsonEditor | JsonEditor}Converter which uses the supplied editor
+     * Constructs a new {@link JsonEditor | JsonEditor}Converter which uses the supplied editor
      * @param editor -
      */
     constructor(editor) {
@@ -136,7 +136,7 @@ class JsonEditorConverter extends ts_utils_1.Conversion.BaseConverter {
         this.editor = editor;
     }
     /**
-     * Constructs a new {@link Editor.JsonEditor | JsonEditor}Converter which uses the supplied editor
+     * Constructs a new {@link JsonEditor | JsonEditor}Converter which uses the supplied editor
      * @param editor -
      */
     static createWithEditor(editor) {
@@ -144,7 +144,7 @@ class JsonEditorConverter extends ts_utils_1.Conversion.BaseConverter {
     }
     /**
      * Gets a derived converter which fails if the resulting converted
-     * {@link JsonValue | JsonValue} is not a {@link JsonObject | JsonObject}.
+     * `JsonValue` is not a `JsonObject`.
      */
     object() {
         return this.map((jv) => {
@@ -156,7 +156,7 @@ class JsonEditorConverter extends ts_utils_1.Conversion.BaseConverter {
     }
     /**
      * Gets a derived converter which fails if the resulting converted
-     * {@link JsonValue | JsonValue} is not a {@link JsonArray | JsonArray}.
+     * `JsonValue` is not a `JsonArray`.
      */
     array() {
         return this.map((jv) => {

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

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

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

@@ -12,12 +12,12 @@ export type JsonEditFailureReason = 'ignore' | 'inapplicable' | 'edited' | 'erro
  */
 export type JsonPropertyEditFailureReason = JsonEditFailureReason | 'deferred';
 /**
- * Possible validation rules for a {@link Editor.JsonEditor | JsonEditor}.
+ * Possible validation rules for a {@link JsonEditor | JsonEditor}.
  * @public
  */
 export type JsonEditorValidationRules = 'invalidPropertyName' | 'invalidPropertyValue' | 'undefinedPropertyValue';
 /**
- * Validation options for a {@link Editor.JsonEditor | JsonEditor}.
+ * Validation options for a {@link JsonEditor | JsonEditor}.
  * @public
  */
 export interface IJsonEditorValidationOptions {
@@ -44,7 +44,7 @@ export interface IJsonEditorValidationOptions {
     onUndefinedPropertyValue: 'error' | 'ignore';
 }
 /**
- * Initialization options for a {@link Editor.JsonEditor | JsonEditor}.
+ * Initialization options for a {@link JsonEditor | JsonEditor}.
  * @public
  */
 export interface IJsonEditorOptions {
@@ -52,13 +52,13 @@ export interface IJsonEditorOptions {
     validation: IJsonEditorValidationOptions;
 }
 /**
- * A specialized JSON editor which does a deep clone of a supplied {@link JsonValue | JsonValue}.
+ * A specialized JSON editor which does a deep clone of a supplied `JsonValue`.
  * @public
  */
 export interface IJsonCloneEditor {
     /**
-     * Returns a deep clone of a supplied {@link JsonValue | JsonValue}.
-     * @param src - The {@link JsonValue | JsonValue} to be cloned.
+     * Returns a deep clone of a supplied `JsonValue`.
+     * @param src - The `JsonValue` to be cloned.
      * @param context - An optional {@link IJsonContext | JSON context} used for clone
      * conversion operations.
      */

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

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