@rjsf/utils 5.11.2 → 5.12.0

package/lib/getInputProps.js

@@ -0,0 +1,41 @@
+import rangeSpec from './rangeSpec';
+/** Using the `schema`, `defaultType` and `options`, extract out the props for the <input> element that make sense.
+ *
+ * @param schema - The schema for the field provided by the widget
+ * @param [defaultType] - The default type, if any, for the field provided by the widget
+ * @param [options={}] - The UI Options for the field provided by the widget
+ * @param [autoDefaultStepAny=true] - Determines whether to auto-default step=any when the type is number and no step
+ * @returns - The extracted `InputPropsType` object
+ */
+export default function getInputProps(schema, defaultType, options = {}, autoDefaultStepAny = true) {
+    const inputProps = Object.assign({ type: defaultType || 'text' }, rangeSpec(schema));
+    // If options.inputType is set use that as the input type
+    if (options.inputType) {
+        inputProps.type = options.inputType;
+    }
+    else if (!defaultType) {
+        // If the schema is of type number or integer, set the input type to number
+        if (schema.type === 'number') {
+            inputProps.type = 'number';
+            // Only add step if one isn't already defined and we are auto-defaulting the "any" step
+            if (autoDefaultStepAny && inputProps.step === undefined) {
+                // Setting step to 'any' fixes a bug in Safari where decimals are not
+                // allowed in number inputs
+                inputProps.step = 'any';
+            }
+        }
+        else if (schema.type === 'integer') {
+            inputProps.type = 'number';
+            // Only add step if one isn't already defined
+            if (inputProps.step === undefined) {
+                // Since this is integer, you always want to step up or down in multiples of 1
+                inputProps.step = 1;
+            }
+        }
+    }
+    if (options.autocomplete) {
+        inputProps.autoComplete = options.autocomplete;
+    }
+    return inputProps;
+}
+//# sourceMappingURL=getInputProps.js.map

package/lib/getInputProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getInputProps.js","sourceRoot":"","sources":["../src/getInputProps.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AAGpC;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAKnC,MAAkB,EAClB,WAAoB,EACpB,UAAkC,EAAE,EACpC,kBAAkB,GAAG,IAAI;IAEzB,MAAM,UAAU,mBACd,IAAI,EAAE,WAAW,IAAI,MAAM,IACxB,SAAS,CAAC,MAAM,CAAC,CACrB,CAAC;IAEF,yDAAyD;IACzD,IAAI,OAAO,CAAC,SAAS,EAAE;QACrB,UAAU,CAAC,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC;KACrC;SAAM,IAAI,CAAC,WAAW,EAAE;QACvB,2EAA2E;QAC3E,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE;YAC5B,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;YAC3B,uFAAuF;YACvF,IAAI,kBAAkB,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE;gBACvD,qEAAqE;gBACrE,2BAA2B;gBAC3B,UAAU,CAAC,IAAI,GAAG,KAAK,CAAC;aACzB;SACF;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE;YACpC,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;YAC3B,6CAA6C;YAC7C,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE;gBACjC,8EAA8E;gBAC9E,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;aACrB;SACF;KACF;IAED,IAAI,OAAO,CAAC,YAAY,EAAE;QACxB,UAAU,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;KAChD;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/lib/getSchemaType.d.ts

@@ -0,0 +1,13 @@
+import { RJSFSchema, StrictRJSFSchema } from './types';
+/** Gets the type of a given `schema`. If the type is not explicitly defined, then an attempt is made to infer it from
+ * other elements of the schema as follows:
+ * - schema.const: Returns the `guessType()` of that value
+ * - schema.enum: Returns `string`
+ * - schema.properties: Returns `object`
+ * - schema.additionalProperties: Returns `object`
+ * - type is an array with a length of 2 and one type is 'null': Returns the other type
+ *
+ * @param schema - The schema for which to get the type
+ * @returns - The type of the schema
+ */
+export default function getSchemaType<S extends StrictRJSFSchema = RJSFSchema>(schema: S): string | string[] | undefined;

package/lib/getSchemaType.js

@@ -0,0 +1,29 @@
+import guessType from './guessType';
+/** Gets the type of a given `schema`. If the type is not explicitly defined, then an attempt is made to infer it from
+ * other elements of the schema as follows:
+ * - schema.const: Returns the `guessType()` of that value
+ * - schema.enum: Returns `string`
+ * - schema.properties: Returns `object`
+ * - schema.additionalProperties: Returns `object`
+ * - type is an array with a length of 2 and one type is 'null': Returns the other type
+ *
+ * @param schema - The schema for which to get the type
+ * @returns - The type of the schema
+ */
+export default function getSchemaType(schema) {
+    let { type } = schema;
+    if (!type && schema.const) {
+        return guessType(schema.const);
+    }
+    if (!type && schema.enum) {
+        return 'string';
+    }
+    if (!type && (schema.properties || schema.additionalProperties)) {
+        return 'object';
+    }
+    if (Array.isArray(type) && type.length === 2 && type.includes('null')) {
+        type = type.find((type) => type !== 'null');
+    }
+    return type;
+}
+//# sourceMappingURL=getSchemaType.js.map

package/lib/getSchemaType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSchemaType.js","sourceRoot":"","sources":["../src/getSchemaType.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AAGpC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,MAAS;IAET,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAEtB,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE;QACzB,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;KAChC;IAED,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE;QACxB,OAAO,QAAQ,CAAC;KACjB;IAED,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,oBAAoB,CAAC,EAAE;QAC/D,OAAO,QAAQ,CAAC;KACjB;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QACrE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;KAC7C;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/getSubmitButtonOptions.d.ts

@@ -0,0 +1,10 @@
+import { FormContextType, RJSFSchema, StrictRJSFSchema, UiSchema, UISchemaSubmitButtonOptions } from './types';
+/** The default submit button options, exported for testing purposes
+ */
+export declare const DEFAULT_OPTIONS: UISchemaSubmitButtonOptions;
+/** Extracts any `ui:submitButtonOptions` from the `uiSchema` and merges them onto the `DEFAULT_OPTIONS`
+ *
+ * @param [uiSchema={}] - the UI Schema from which to extract submit button props
+ * @returns - The merging of the `DEFAULT_OPTIONS` with any custom ones
+ */
+export default function getSubmitButtonOptions<T = any, S extends StrictRJSFSchema = RJSFSchema, F extends FormContextType = any>(uiSchema?: UiSchema<T, S, F>): UISchemaSubmitButtonOptions;

package/lib/getSubmitButtonOptions.js

@@ -0,0 +1,25 @@
+import { SUBMIT_BTN_OPTIONS_KEY } from './constants';
+import getUiOptions from './getUiOptions';
+/** The default submit button options, exported for testing purposes
+ */
+export const DEFAULT_OPTIONS = {
+    props: {
+        disabled: false,
+    },
+    submitText: 'Submit',
+    norender: false,
+};
+/** Extracts any `ui:submitButtonOptions` from the `uiSchema` and merges them onto the `DEFAULT_OPTIONS`
+ *
+ * @param [uiSchema={}] - the UI Schema from which to extract submit button props
+ * @returns - The merging of the `DEFAULT_OPTIONS` with any custom ones
+ */
+export default function getSubmitButtonOptions(uiSchema = {}) {
+    const uiOptions = getUiOptions(uiSchema);
+    if (uiOptions && uiOptions[SUBMIT_BTN_OPTIONS_KEY]) {
+        const options = uiOptions[SUBMIT_BTN_OPTIONS_KEY];
+        return Object.assign(Object.assign({}, DEFAULT_OPTIONS), options);
+    }
+    return DEFAULT_OPTIONS;
+}
+//# sourceMappingURL=getSubmitButtonOptions.js.map

package/lib/getSubmitButtonOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSubmitButtonOptions.js","sourceRoot":"","sources":["../src/getSubmitButtonOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAG1C;GACG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgC;IAC1D,KAAK,EAAE;QACL,QAAQ,EAAE,KAAK;KAChB;IACD,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,KAAK;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAI5C,WAA8B,EAAE;IAChC,MAAM,SAAS,GAAG,YAAY,CAAU,QAAQ,CAAC,CAAC;IAClD,IAAI,SAAS,IAAI,SAAS,CAAC,sBAAsB,CAAC,EAAE;QAClD,MAAM,OAAO,GAAG,SAAS,CAAC,sBAAsB,CAAgC,CAAC;QACjF,uCAAY,eAAe,GAAK,OAAO,EAAG;KAC3C;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/lib/getTemplate.d.ts

@@ -0,0 +1,10 @@
+import { FormContextType, TemplatesType, Registry, UIOptionsType, StrictRJSFSchema, RJSFSchema } from './types';
+/** Returns the template with the given `name` from either the `uiSchema` if it is defined or from the `registry`
+ * otherwise. NOTE, since `ButtonTemplates` are not overridden in `uiSchema` only those in the `registry` are returned.
+ *
+ * @param name - The name of the template to fetch, restricted to the keys of `TemplatesType`
+ * @param registry - The `Registry` from which to read the template
+ * @param [uiOptions={}] - The `UIOptionsType` from which to read an alternate template
+ * @returns - The template from either the `uiSchema` or `registry` for the `name`
+ */
+export default function getTemplate<Name extends keyof TemplatesType<T, S, F>, T = any, S extends StrictRJSFSchema = RJSFSchema, F extends FormContextType = any>(name: Name, registry: Registry<T, S, F>, uiOptions?: UIOptionsType<T, S, F>): TemplatesType<T, S, F>[Name];

package/lib/getTemplate.js

@@ -0,0 +1,19 @@
+/** Returns the template with the given `name` from either the `uiSchema` if it is defined or from the `registry`
+ * otherwise. NOTE, since `ButtonTemplates` are not overridden in `uiSchema` only those in the `registry` are returned.
+ *
+ * @param name - The name of the template to fetch, restricted to the keys of `TemplatesType`
+ * @param registry - The `Registry` from which to read the template
+ * @param [uiOptions={}] - The `UIOptionsType` from which to read an alternate template
+ * @returns - The template from either the `uiSchema` or `registry` for the `name`
+ */
+export default function getTemplate(name, registry, uiOptions = {}) {
+    const { templates } = registry;
+    if (name === 'ButtonTemplates') {
+        return templates[name];
+    }
+    return (
+    // Evaluating uiOptions[name] results in TS2590: Expression produces a union type that is too complex to represent
+    // To avoid that, we cast uiOptions to `any` before accessing the name field
+    uiOptions[name] || templates[name]);
+}
+//# sourceMappingURL=getTemplate.js.map

package/lib/getTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTemplate.js","sourceRoot":"","sources":["../src/getTemplate.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAKjC,IAAU,EAAE,QAA2B,EAAE,YAAoC,EAAE;IAC/E,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;IAC/B,IAAI,IAAI,KAAK,iBAAiB,EAAE;QAC9B,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;KACxB;IACD,OAAO;IACL,kHAAkH;IAClH,4EAA4E;IAC1E,SAAiB,CAAC,IAAI,CAAkC,IAAI,SAAS,CAAC,IAAI,CAAC,CAC9E,CAAC;AACJ,CAAC"}

package/lib/getUiOptions.d.ts

@@ -0,0 +1,9 @@
+import { FormContextType, GlobalUISchemaOptions, RJSFSchema, StrictRJSFSchema, UIOptionsType, UiSchema } from './types';
+/** Get all passed options from ui:options, and ui:<optionName>, returning them in an object with the `ui:`
+ * stripped off. Any `globalOptions` will always be returned, unless they are overridden by options in the `uiSchema`.
+ *
+ * @param [uiSchema={}] - The UI Schema from which to get any `ui:xxx` options
+ * @param [globalOptions={}] - The optional Global UI Schema from which to get any fallback `xxx` options
+ * @returns - An object containing all the `ui:xxx` options with the `ui:` stripped off along with all `globalOptions`
+ */
+export default function getUiOptions<T = any, S extends StrictRJSFSchema = RJSFSchema, F extends FormContextType = any>(uiSchema?: UiSchema<T, S, F>, globalOptions?: GlobalUISchemaOptions): UIOptionsType<T, S, F>;

package/lib/getUiOptions.js

@@ -0,0 +1,25 @@
+import { UI_OPTIONS_KEY, UI_WIDGET_KEY } from './constants';
+import isObject from './isObject';
+/** Get all passed options from ui:options, and ui:<optionName>, returning them in an object with the `ui:`
+ * stripped off. Any `globalOptions` will always be returned, unless they are overridden by options in the `uiSchema`.
+ *
+ * @param [uiSchema={}] - The UI Schema from which to get any `ui:xxx` options
+ * @param [globalOptions={}] - The optional Global UI Schema from which to get any fallback `xxx` options
+ * @returns - An object containing all the `ui:xxx` options with the `ui:` stripped off along with all `globalOptions`
+ */
+export default function getUiOptions(uiSchema = {}, globalOptions = {}) {
+    return Object.keys(uiSchema)
+        .filter((key) => key.indexOf('ui:') === 0)
+        .reduce((options, key) => {
+        const value = uiSchema[key];
+        if (key === UI_WIDGET_KEY && isObject(value)) {
+            console.error('Setting options via ui:widget object is no longer supported, use ui:options instead');
+            return options;
+        }
+        if (key === UI_OPTIONS_KEY && isObject(value)) {
+            return Object.assign(Object.assign({}, options), value);
+        }
+        return Object.assign(Object.assign({}, options), { [key.substring(3)]: value });
+    }, Object.assign({}, globalOptions));
+}
+//# sourceMappingURL=getUiOptions.js.map

package/lib/getUiOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUiOptions.js","sourceRoot":"","sources":["../src/getUiOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,QAAQ,MAAM,YAAY,CAAC;AAGlC;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,WAA8B,EAAE,EAChC,gBAAuC,EAAE;IAEzC,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;SACzB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SACzC,MAAM,CACL,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACf,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,GAAG,KAAK,aAAa,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE;YAC5C,OAAO,CAAC,KAAK,CAAC,qFAAqF,CAAC,CAAC;YACrG,OAAO,OAAO,CAAC;SAChB;QACD,IAAI,GAAG,KAAK,cAAc,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE;YAC7C,uCAAY,OAAO,GAAK,KAAK,EAAG;SACjC;QACD,uCAAY,OAAO,KAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAG;IACnD,CAAC,oBACI,aAAa,EACnB,CAAC;AACN,CAAC"}

package/lib/getWidget.d.ts

@@ -0,0 +1,13 @@
+import { FormContextType, RJSFSchema, Widget, RegistryWidgetsType, StrictRJSFSchema } from './types';
+/** Given a schema representing a field to render and either the name or actual `Widget` implementation, returns the
+ * React component that is used to render the widget. If the `widget` is already a React component, then it is wrapped
+ * with a `MergedWidget`. Otherwise an attempt is made to look up the widget inside of the `registeredWidgets` map based
+ * on the schema type and `widget` name. If no widget component can be found an `Error` is thrown.
+ *
+ * @param schema - The schema for the field
+ * @param [widget] - Either the name of the widget OR a `Widget` implementation to use
+ * @param [registeredWidgets={}] - A registry of widget name to `Widget` implementation
+ * @returns - The `Widget` component to use
+ * @throws - An error if there is no `Widget` component that can be returned
+ */
+export default function getWidget<T = any, S extends StrictRJSFSchema = RJSFSchema, F extends FormContextType = any>(schema: RJSFSchema, widget?: Widget<T, S, F> | string, registeredWidgets?: RegistryWidgetsType<T, S, F>): Widget<T, S, F>;

package/lib/getWidget.js

@@ -0,0 +1,118 @@
+import { __rest } from "tslib";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createElement } from 'react';
+import ReactIs from 'react-is';
+import get from 'lodash/get';
+import set from 'lodash/set';
+import getSchemaType from './getSchemaType';
+/** The map of schema types to widget type to widget name
+ */
+const widgetMap = {
+    boolean: {
+        checkbox: 'CheckboxWidget',
+        radio: 'RadioWidget',
+        select: 'SelectWidget',
+        hidden: 'HiddenWidget',
+    },
+    string: {
+        text: 'TextWidget',
+        password: 'PasswordWidget',
+        email: 'EmailWidget',
+        hostname: 'TextWidget',
+        ipv4: 'TextWidget',
+        ipv6: 'TextWidget',
+        uri: 'URLWidget',
+        'data-url': 'FileWidget',
+        radio: 'RadioWidget',
+        select: 'SelectWidget',
+        textarea: 'TextareaWidget',
+        hidden: 'HiddenWidget',
+        date: 'DateWidget',
+        datetime: 'DateTimeWidget',
+        'date-time': 'DateTimeWidget',
+        'alt-date': 'AltDateWidget',
+        'alt-datetime': 'AltDateTimeWidget',
+        time: 'TimeWidget',
+        color: 'ColorWidget',
+        file: 'FileWidget',
+    },
+    number: {
+        text: 'TextWidget',
+        select: 'SelectWidget',
+        updown: 'UpDownWidget',
+        range: 'RangeWidget',
+        radio: 'RadioWidget',
+        hidden: 'HiddenWidget',
+    },
+    integer: {
+        text: 'TextWidget',
+        select: 'SelectWidget',
+        updown: 'UpDownWidget',
+        range: 'RangeWidget',
+        radio: 'RadioWidget',
+        hidden: 'HiddenWidget',
+    },
+    array: {
+        select: 'SelectWidget',
+        checkboxes: 'CheckboxesWidget',
+        files: 'FileWidget',
+        hidden: 'HiddenWidget',
+    },
+};
+/** Wraps the given widget with stateless functional component that will merge any `defaultProps.options` with the
+ * `options` that are provided in the props. It will add the wrapper component as a `MergedWidget` property onto the
+ * `Widget` so that future attempts to wrap `AWidget` will return the already existing wrapper.
+ *
+ * @param AWidget - A widget that will be wrapped or one that is already wrapped
+ * @returns - The wrapper widget
+ */
+function mergeWidgetOptions(AWidget) {
+    let MergedWidget = get(AWidget, 'MergedWidget');
+    // cache return value as property of widget for proper react reconciliation
+    if (!MergedWidget) {
+        const defaultOptions = (AWidget.defaultProps && AWidget.defaultProps.options) || {};
+        MergedWidget = (_a) => {
+            var { options } = _a, props = __rest(_a, ["options"]);
+            return _jsx(AWidget, Object.assign({ options: Object.assign(Object.assign({}, defaultOptions), options) }, props));
+        };
+        set(AWidget, 'MergedWidget', MergedWidget);
+    }
+    return MergedWidget;
+}
+/** Given a schema representing a field to render and either the name or actual `Widget` implementation, returns the
+ * React component that is used to render the widget. If the `widget` is already a React component, then it is wrapped
+ * with a `MergedWidget`. Otherwise an attempt is made to look up the widget inside of the `registeredWidgets` map based
+ * on the schema type and `widget` name. If no widget component can be found an `Error` is thrown.
+ *
+ * @param schema - The schema for the field
+ * @param [widget] - Either the name of the widget OR a `Widget` implementation to use
+ * @param [registeredWidgets={}] - A registry of widget name to `Widget` implementation
+ * @returns - The `Widget` component to use
+ * @throws - An error if there is no `Widget` component that can be returned
+ */
+export default function getWidget(schema, widget, registeredWidgets = {}) {
+    const type = getSchemaType(schema);
+    if (typeof widget === 'function' ||
+        (widget && ReactIs.isForwardRef(createElement(widget))) ||
+        ReactIs.isMemo(widget)) {
+        return mergeWidgetOptions(widget);
+    }
+    if (typeof widget !== 'string') {
+        throw new Error(`Unsupported widget definition: ${typeof widget}`);
+    }
+    if (widget in registeredWidgets) {
+        const registeredWidget = registeredWidgets[widget];
+        return getWidget(schema, registeredWidget, registeredWidgets);
+    }
+    if (typeof type === 'string') {
+        if (!(type in widgetMap)) {
+            throw new Error(`No widget for type '${type}'`);
+        }
+        if (widget in widgetMap[type]) {
+            const registeredWidget = registeredWidgets[widgetMap[type][widget]];
+            return getWidget(schema, registeredWidget, registeredWidgets);
+        }
+    }
+    throw new Error(`No widget '${widget}' for type '${type}'`);
+}
+//# sourceMappingURL=getWidget.js.map

package/lib/getWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWidget.js","sourceRoot":"","sources":["../src/getWidget.tsx"],"names":[],"mappings":"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"}

package/lib/guessType.d.ts

@@ -0,0 +1,7 @@
+/** Given a specific `value` attempts to guess the type of a schema element. In the case where we have to implicitly
+ *  create a schema, it is useful to know what type to use based on the data we are defining.
+ *
+ * @param value - The value from which to guess the type
+ * @returns - The best guess for the object type
+ */
+export default function guessType(value: any): "object" | "string" | "number" | "boolean" | "array" | "null";

package/lib/guessType.js

@@ -0,0 +1,29 @@
+/** Given a specific `value` attempts to guess the type of a schema element. In the case where we have to implicitly
+ *  create a schema, it is useful to know what type to use based on the data we are defining.
+ *
+ * @param value - The value from which to guess the type
+ * @returns - The best guess for the object type
+ */
+export default function guessType(value) {
+    if (Array.isArray(value)) {
+        return 'array';
+    }
+    if (typeof value === 'string') {
+        return 'string';
+    }
+    if (value == null) {
+        return 'null';
+    }
+    if (typeof value === 'boolean') {
+        return 'boolean';
+    }
+    if (!isNaN(value)) {
+        return 'number';
+    }
+    if (typeof value === 'object') {
+        return 'object';
+    }
+    // Default to string if we can't figure it out
+    return 'string';
+}
+//# sourceMappingURL=guessType.js.map

package/lib/guessType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guessType.js","sourceRoot":"","sources":["../src/guessType.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,KAAU;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACxB,OAAO,OAAO,CAAC;KAChB;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,OAAO,QAAQ,CAAC;KACjB;IACD,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,OAAO,MAAM,CAAC;KACf;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE;QAC9B,OAAO,SAAS,CAAC;KAClB;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACjB,OAAO,QAAQ,CAAC;KACjB;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,OAAO,QAAQ,CAAC;KACjB;IACD,8CAA8C;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/hasWidget.d.ts

@@ -0,0 +1,10 @@
+import { FormContextType, RegistryWidgetsType, RJSFSchema, StrictRJSFSchema, Widget } from './types';
+/** Detects whether the `widget` exists for the `schema` with the associated `registryWidgets` and returns true if it
+ * does, or false if it doesn't.
+ *
+ * @param schema - The schema for the field
+ * @param widget - Either the name of the widget OR a `Widget` implementation to use
+ * @param [registeredWidgets={}] - A registry of widget name to `Widget` implementation
+ * @returns - True if the widget exists, false otherwise
+ */
+export default function hasWidget<T = any, S extends StrictRJSFSchema = RJSFSchema, F extends FormContextType = any>(schema: RJSFSchema, widget: Widget<T, S, F> | string, registeredWidgets?: RegistryWidgetsType<T, S, F>): boolean;

package/lib/hasWidget.js

@@ -0,0 +1,23 @@
+import getWidget from './getWidget';
+/** Detects whether the `widget` exists for the `schema` with the associated `registryWidgets` and returns true if it
+ * does, or false if it doesn't.
+ *
+ * @param schema - The schema for the field
+ * @param widget - Either the name of the widget OR a `Widget` implementation to use
+ * @param [registeredWidgets={}] - A registry of widget name to `Widget` implementation
+ * @returns - True if the widget exists, false otherwise
+ */
+export default function hasWidget(schema, widget, registeredWidgets = {}) {
+    try {
+        getWidget(schema, widget, registeredWidgets);
+        return true;
+    }
+    catch (e) {
+        const err = e;
+        if (err.message && (err.message.startsWith('No widget') || err.message.startsWith('Unsupported widget'))) {
+            return false;
+        }
+        throw e;
+    }
+}
+//# sourceMappingURL=hasWidget.js.map

package/lib/hasWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasWidget.js","sourceRoot":"","sources":["../src/hasWidget.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AAGpC;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,MAAkB,EAClB,MAAgC,EAChC,oBAAkD,EAAE;IAEpD,IAAI;QACF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;KACb;IAAC,OAAO,CAAC,EAAE;QACV,MAAM,GAAG,GAAU,CAAU,CAAC;QAC9B,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,EAAE;YACxG,OAAO,KAAK,CAAC;SACd;QACD,MAAM,CAAC,CAAC;KACT;AACH,CAAC"}

package/lib/hashForSchema.d.ts

@@ -0,0 +1,8 @@
+import { RJSFSchema, StrictRJSFSchema } from './types';
+/** Stringifies the schema and returns the hash of the resulting string. Sorts schema fields
+ * in consistent order before stringify to prevent different hash ids for the same schema.
+ *
+ * @param schema - The schema for which the hash is desired
+ * @returns - The string obtained from the hash of the stringified schema
+ */
+export default function hashForSchema<S extends StrictRJSFSchema = RJSFSchema>(schema: S): string;

package/lib/hashForSchema.js

@@ -0,0 +1,29 @@
+/** JS has no built-in hashing function, so rolling our own
+ *  based on Java's hashing fn:
+ *  http://www.java2s.com/example/nodejs-utility-method/string-hash/hashcode-4dc2b.html
+ *
+ * @param string - The string for which to get the hash
+ * @returns - The resulting hash of the string in hex format
+ */
+function hashString(string) {
+    let hash = 0;
+    for (let i = 0; i < string.length; i += 1) {
+        const chr = string.charCodeAt(i);
+        hash = (hash << 5) - hash + chr;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    return hash.toString(16);
+}
+/** Stringifies the schema and returns the hash of the resulting string. Sorts schema fields
+ * in consistent order before stringify to prevent different hash ids for the same schema.
+ *
+ * @param schema - The schema for which the hash is desired
+ * @returns - The string obtained from the hash of the stringified schema
+ */
+export default function hashForSchema(schema) {
+    const allKeys = new Set();
+    // solution source: https://stackoverflow.com/questions/16167581/sort-object-properties-and-json-stringify/53593328#53593328
+    JSON.stringify(schema, (key, value) => (allKeys.add(key), value));
+    return hashString(JSON.stringify(schema, Array.from(allKeys).sort()));
+}
+//# sourceMappingURL=hashForSchema.js.map

package/lib/hashForSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashForSchema.js","sourceRoot":"","sources":["../src/hashForSchema.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,MAAc;IAChC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC;QAChC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,2BAA2B;KAChD;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAA0C,MAAS;IACtF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,4HAA4H;IAC5H,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAClE,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/lib/idGenerators.d.ts

@@ -0,0 +1,47 @@
+import { IdSchema } from './types';
+/** Return a consistent `id` for the field description element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field description element from the given `id`
+ */
+export declare function descriptionId<T = any>(id: IdSchema<T> | string): string;
+/** Return a consistent `id` for the field error element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field error element from the given `id`
+ */
+export declare function errorId<T = any>(id: IdSchema<T> | string): string;
+/** Return a consistent `id` for the field examples element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field examples element from the given `id`
+ */
+export declare function examplesId<T = any>(id: IdSchema<T> | string): string;
+/** Return a consistent `id` for the field help element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field help element from the given `id`
+ */
+export declare function helpId<T = any>(id: IdSchema<T> | string): string;
+/** Return a consistent `id` for the field title element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field title element from the given `id`
+ */
+export declare function titleId<T = any>(id: IdSchema<T> | string): string;
+/** Return a list of element ids that contain additional information about the field that can be used to as the aria
+ * description of the field. This is correctly omitting `titleId` which would be "labeling" rather than "describing" the
+ * element.
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @param [includeExamples=false] - Optional flag, if true, will add the `examplesId` into the list
+ * @returns - The string containing the list of ids for use in an `aria-describedBy` attribute
+ */
+export declare function ariaDescribedByIds<T = any>(id: IdSchema<T> | string, includeExamples?: boolean): string;
+/** Return a consistent `id` for the `optionIndex`s of a `Radio` or `Checkboxes` widget
+ *
+ * @param id - The id of the parent component for the option
+ * @param optionIndex - The index of the option for which the id is desired
+ * @returns - An id for the option index based on the parent `id`
+ */
+export declare function optionId(id: string, optionIndex: number): string;

package/lib/idGenerators.js

@@ -0,0 +1,73 @@
+import isString from 'lodash/isString';
+import { ID_KEY } from './constants';
+/** Generates a consistent `id` pattern for a given `id` and a `suffix`
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @param suffix - The suffix to append to the id
+ */
+function idGenerator(id, suffix) {
+    const theId = isString(id) ? id : id[ID_KEY];
+    return `${theId}__${suffix}`;
+}
+/** Return a consistent `id` for the field description element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field description element from the given `id`
+ */
+export function descriptionId(id) {
+    return idGenerator(id, 'description');
+}
+/** Return a consistent `id` for the field error element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field error element from the given `id`
+ */
+export function errorId(id) {
+    return idGenerator(id, 'error');
+}
+/** Return a consistent `id` for the field examples element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field examples element from the given `id`
+ */
+export function examplesId(id) {
+    return idGenerator(id, 'examples');
+}
+/** Return a consistent `id` for the field help element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field help element from the given `id`
+ */
+export function helpId(id) {
+    return idGenerator(id, 'help');
+}
+/** Return a consistent `id` for the field title element
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @returns - The consistent id for the field title element from the given `id`
+ */
+export function titleId(id) {
+    return idGenerator(id, 'title');
+}
+/** Return a list of element ids that contain additional information about the field that can be used to as the aria
+ * description of the field. This is correctly omitting `titleId` which would be "labeling" rather than "describing" the
+ * element.
+ *
+ * @param id - Either simple string id or an IdSchema from which to extract it
+ * @param [includeExamples=false] - Optional flag, if true, will add the `examplesId` into the list
+ * @returns - The string containing the list of ids for use in an `aria-describedBy` attribute
+ */
+export function ariaDescribedByIds(id, includeExamples = false) {
+    const examples = includeExamples ? ` ${examplesId(id)}` : '';
+    return `${errorId(id)} ${descriptionId(id)} ${helpId(id)}${examples}`;
+}
+/** Return a consistent `id` for the `optionIndex`s of a `Radio` or `Checkboxes` widget
+ *
+ * @param id - The id of the parent component for the option
+ * @param optionIndex - The index of the option for which the id is desired
+ * @returns - An id for the option index based on the parent `id`
+ */
+export function optionId(id, optionIndex) {
+    return `${id}-${optionIndex}`;
+}
+//# sourceMappingURL=idGenerators.js.map

package/lib/idGenerators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idGenerators.js","sourceRoot":"","sources":["../src/idGenerators.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAGvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;GAIG;AACH,SAAS,WAAW,CAAU,EAAwB,EAAE,MAAc;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,GAAG,KAAK,KAAK,MAAM,EAAE,CAAC;AAC/B,CAAC;AACD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAU,EAAwB;IAC7D,OAAO,WAAW,CAAI,EAAE,EAAE,aAAa,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAU,EAAwB;IACvD,OAAO,WAAW,CAAI,EAAE,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAU,EAAwB;IAC1D,OAAO,WAAW,CAAI,EAAE,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAU,EAAwB;IACtD,OAAO,WAAW,CAAI,EAAE,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAU,EAAwB;IACvD,OAAO,WAAW,CAAI,EAAE,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAU,EAAwB,EAAE,eAAe,GAAG,KAAK;IAC3F,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,UAAU,CAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,GAAG,OAAO,CAAI,EAAE,CAAC,IAAI,aAAa,CAAI,EAAE,CAAC,IAAI,MAAM,CAAI,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,WAAmB;IACtD,OAAO,GAAG,EAAE,IAAI,WAAW,EAAE,CAAC;AAChC,CAAC"}