@fgv/ts-json 5.0.1-9 → 5.0.2-0

package/dist/index.browser.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright (c) 2023 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+// Browser entry point - re-exports everything from main index
+export * from './index';
+//# sourceMappingURL=index.browser.js.map

package/dist/index.js

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

package/dist/packlets/context/compositeJsonMap.js

@@ -0,0 +1,100 @@
+/*
+ * Copyright (c) 2020 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { isJsonObject } from '@fgv/ts-json-base';
+import { captureResult, failWithDetail, succeedWithDetail } from '@fgv/ts-utils';
+/**
+ * A {@link CompositeJsonMap | CompositeJsonMap} presents a composed view of one or more other
+ * {@link IJsonReferenceMap | JSON reference maps}.
+ * @public
+ */
+export class CompositeJsonMap {
+    /**
+     * The {@link IJsonReferenceMap | reference maps} from which this map is to be composed.
+     * @param maps - An array o {@link IJsonReferenceMap | IJsonReferenceMap} containing the maps
+     * from which this map is to be composed.
+     * @internal
+     */
+    constructor(maps) {
+        this._maps = maps;
+    }
+    /**
+     * Creates a new {@link CompositeJsonMap | CompositeJsonMap} from supplied
+     * {@link IJsonReferenceMap | maps}.
+     * @param maps - one or more {@link IJsonReferenceMap | object maps} to be composed.
+     */
+    static create(maps) {
+        return captureResult(() => new CompositeJsonMap(maps));
+    }
+    /**
+     * Determine if a key might be valid for this map but does not determine
+     * if key actually exists. Allows key range to be constrained.
+     * @param key - The key to be tested.
+     * @returns `true` if the key is in the valid range, `false` otherwise.
+     */
+    keyIsInRange(key) {
+        return this._maps.find((map) => map.keyIsInRange(key)) !== undefined;
+    }
+    /**
+     * Determines if an object with the specified key actually exists in the map.
+     * @param key - The key to be tested.
+     * @returns `true` if an object with the specified key exists, `false` otherwise.
+     */
+    has(key) {
+        return this._maps.find((map) => map.has(key)) !== undefined;
+    }
+    /**
+     * 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'`
+     * if no such object exists, or `Failure` with detail `'error'` if the object was found but
+     * could not be formatted.
+     */
+    getJsonObject(key, context) {
+        return this.getJsonValue(key, context).onSuccess((jv) => {
+            if (!isJsonObject(jv)) {
+                return failWithDetail(`${key}: not an object`, 'error');
+            }
+            return succeedWithDetail(jv);
+        });
+    }
+    /**
+     * 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'`
+     * if no such object exists, or failure with detail `'error'` if the object was found but
+     * could not be formatted.
+     */
+    getJsonValue(key, context) {
+        for (const map of this._maps) {
+            if (map.keyIsInRange(key)) {
+                const result = map.getJsonValue(key, context);
+                if (result.isSuccess() || result.detail === 'error') {
+                    return result;
+                }
+            }
+        }
+        return failWithDetail(`${key}: value not found`, 'unknown');
+    }
+}
+//# sourceMappingURL=compositeJsonMap.js.map

package/dist/packlets/context/contextHelpers.js

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

package/dist/packlets/context/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2023 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+export { CompositeJsonMap } from './compositeJsonMap';
+export { JsonContextHelper } from './contextHelpers';
+export { defaultExtendVars } from './jsonContext';
+//# sourceMappingURL=index.js.map

package/dist/packlets/context/jsonContext.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2020 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { succeed } from '@fgv/ts-utils';
+/**
+ * This default implementation of a {@link TemplateVarsExtendFunction | TemplateVarsExtendFunction}
+ * creates a new collection via inheritance from the supplied collection.
+ * @param base - The base {@link TemplateVars | variables} to be extended.
+ * @param values - The {@link VariableValue | values} to be added or overridden in the new variables.
+ * @public
+ */
+export function defaultExtendVars(base, values) {
+    /* c8 ignore next 1 */
+    const rtrn = base ? Object.create(base) : {};
+    for (const v of values) {
+        rtrn[v[0]] = v[1];
+    }
+    return succeed(rtrn);
+}
+//# sourceMappingURL=jsonContext.js.map

package/dist/packlets/converters/converters.js

@@ -0,0 +1,99 @@
+/*
+ * Copyright (c) 2020 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { ConditionalJsonConverter, JsonConverter, RichJsonConverter, TemplatedJsonConverter } from './jsonConverter';
+/**
+ * A simple validating {@link JsonConverter | JSON converter}. Converts unknown to
+ * JSON or fails if the unknown contains any invalid JSON values.
+ * @public
+ */
+export const json = new JsonConverter();
+/**
+ * A simple validating {@link JsonConverter | JSON converter}. Converts unknown
+ * to a `JsonObject`, or fails if the `unknown` contains invalid
+ * JSON or is not an object.
+ * @public
+ */
+export const jsonObject = json.object();
+/**
+ * A simple validating {@link JsonConverter | JSON converter}. Converts `unknown` to a
+ * `JsonArray`, or fails if the unknown contains invalid JSON or is
+ * not an array.
+ * @public
+ */
+export const jsonArray = json.array();
+let templatedJsonDefault;
+let conditionalJsonDefault;
+let richJsonDefault;
+/**
+ * Helper function which creates a new {@link JsonConverter | JsonConverter} which converts an
+ * `unknown` value to JSON, rendering any property names or string values using mustache with
+ * the supplied context.  See the mustache documentation for details of mustache syntax and view.
+ * @param options - {@link TemplatedJsonConverterOptions | Options and context} for
+ * the conversion.
+ * @public
+ */
+export function templatedJson(options) {
+    if (!options) {
+        if (!templatedJsonDefault) {
+            templatedJsonDefault = new TemplatedJsonConverter();
+        }
+        return templatedJsonDefault;
+    }
+    return new TemplatedJsonConverter(options);
+}
+/**
+ * Helper function which creates a new {@link JsonConverter | JsonConverter} which converts a
+ * supplied `unknown` to strongly-typed JSON, by first rendering any property
+ * names or string values using mustache with the supplied context, then applying
+ * multi-value property expansion and conditional flattening based on property names.
+ * @param options - {@link ConditionalJsonConverterOptions | Options and context} for
+ * the conversion.
+ * @public
+ */
+export function conditionalJson(options) {
+    if (!options) {
+        if (!conditionalJsonDefault) {
+            conditionalJsonDefault = new ConditionalJsonConverter();
+        }
+        return conditionalJsonDefault;
+    }
+    return new ConditionalJsonConverter(options);
+}
+/**
+ * Helper function which creates a new {@link JsonConverter | JsonConverter} which converts a
+ * supplied `unknown` to strongly-typed JSON, by first rendering any property
+ * names or string values using mustache with the supplied context, then applying
+ * multi-value property expansion and conditional flattening based on property names.
+ * @param options - {@link RichJsonConverterOptions | Options and context} for
+ * the conversion.
+ * @public
+ */
+export function richJson(options) {
+    if (!options) {
+        if (!richJsonDefault) {
+            richJsonDefault = new RichJsonConverter();
+        }
+        return richJsonDefault;
+    }
+    return new RichJsonConverter(options);
+}
+//# sourceMappingURL=converters.js.map

package/dist/packlets/converters/index.js

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