@nolwenture/formik-jsonschema-form 2.0.2 → 3.0.0-beta.1

package/dist/cjs/v3/raw/model/form/componentTable.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORM_COMPONENTS = void 0;
+exports.FORM_COMPONENTS = {
+    ArrayFieldAddButton: ["button", "ObjectFieldButton", "ArrayFieldButton", "ArrayFieldAddButton"],
+    ArrayFieldButton: ["button", "ObjectFieldButton", "ArrayFieldButton"],
+    ArrayFieldDownButton: ["button", "ObjectFieldButton", "ArrayFieldButton", "ArrayFieldLineButton", "ArrayFieldDownButton"],
+    ArrayFieldItem: ["li", "ObjectFieldItem", "ArrayFieldItem"],
+    ArrayFieldItemButtons: ["div", "ObjectFieldItemButtons"],
+    ArrayFieldLineButton: ["button", "ObjectFieldButton", "ArrayFieldButton", "ArrayFieldLineButton"],
+    ArrayFieldRemoveButton: ["button", "ObjectFieldButton", "ArrayFieldButton", "ArrayFieldLineButton", "ArrayFieldRemoveButton"],
+    ArrayFieldTemplateDescription: null,
+    ArrayFieldTemplateErrorMessage: null,
+    ArrayFieldTemplateHelp: null,
+    ArrayFieldTemplateIcon: null,
+    ArrayFieldTemplateInfo: null,
+    ArrayFieldTemplateRequiredIndicator: null,
+    ArrayFieldTemplateTitle: null,
+    ArrayFieldTemplateWrapper: null,
+    ArrayFieldTitleInfoWrapper: null,
+    ArrayFieldUpButton: ["button", "ObjectFieldButton", "ArrayFieldButton", "ArrayFieldLineButton", "ArrayFieldUpButton"],
+    BooleanFieldWrapper: ["div", "BooleanFieldWrapper"],
+    Clickable: "fn",
+    ClickableEl: ["button", "ClickableEl"],
+    CollapsibleObjectFieldTemplateChildWrapper: ["div", "CollapsibleObjectFieldTemplateChildWrapper"],
+    CollapsibleObjectFieldTemplateDescription: null,
+    CollapsibleObjectFieldTemplateErrorMessage: null,
+    CollapsibleObjectFieldTemplateHelp: null,
+    CollapsibleObjectFieldTemplateIcon: null,
+    CollapsibleObjectFieldTemplateInfo: null,
+    CollapsibleObjectFieldTemplateRequiredIndicator: null,
+    CollapsibleObjectFieldTemplateTitle: ["legend", "ObjectFieldTemplateTitle", "CollapsibleObjectFieldTemplateTitle"],
+    CollapsibleObjectFieldTemplateToggle: ["button", "CollapsibleObjectFieldTemplateToggle"],
+    CollapsibleObjectFieldTemplateWrapper: null,
+    CollapsibleObjectTitleInfoWrapper: null,
+    Divider: ["div", "Divider"],
+    DividerText: ["p", "DividerText"],
+    DragOverlay: ["div", "DragOverlay"],
+    ErrorMessage: "fn",
+    FieldDescription: ["p", "FieldDescription"],
+    FieldHelp: ["p", "FieldHelp"],
+    FieldInfo: "fn",
+    FieldInfoBoxArrowElement: ["div", "FieldInfoBoxArrowElement"],
+    FieldInfoBoxElement: ["div", "FieldInfoBoxElement"],
+    FieldInfoBoxInnerElement: ["div", "FieldInfoBoxInnerElement"],
+    FieldInfoContainer: ["a", "FieldInfoContainer"],
+    FieldInfoLabel: ["span", "FieldInfoLabel"],
+    FieldInput: ["input", "FieldInput"],
+    FieldTitle: ["label", "FieldTitle"],
+    FieldTitleInfoWrapper: ["div", "FieldTitleInfoWrapper"],
+    FieldWrapper: ["div", "FieldWrapper"],
+    FileInfoText: ["p", "FileInfoText"],
+    FileInfoTextMinimized: ["p", "FileInfoTextMinimized"],
+    FileItemContainer: ["div", "FileItemContainer"],
+    FileSize: ["span", "FileSize"],
+    FileTypeIcon: ["div", "FileTypeIcon"],
+    FileUploadButton: ["button", "FileUploadButton"],
+    FileUploadFieldContainer: ["div", "FileUploadFieldContainer"],
+    FileUploadFieldFileInfoText: ["span", "FileUploadFieldFileInfoText"],
+    FileUploadFieldFileItemContainer: ["div", "FileUploadFieldFileItemContainer"],
+    FileUploadFieldFileUploadButton: ["button", "FileUploadFieldFileUploadButton"],
+    FileUploadFieldHiddenFileInput: ["input", "FileUploadFieldHiddenFileInput"],
+    FileUploadFieldInput: "fn",
+    FileUploadFieldProgressBar: ["div", "FileUploadFieldProgressBar"],
+    FileUploadFieldProgressBarContainer: ["div", "FileUploadFieldProgressBarContainer"],
+    FileUploadFieldProgressText: ["span", "FileUploadFieldProgressText"],
+    FileUploadFieldRemoveButton: ["button", "FileUploadFieldRemoveButton"],
+    FileUploadText: ["a", "FileUploadText"],
+    FilesUploadFieldInput: "fn",
+    Form: ["form", "Form"],
+    FormButton: ["button", "FormButton"],
+    FormButtonWrapper: ["div", "FormButtonWrapper"],
+    HiddenFileInput: ["input", "HiddenFileInput"],
+    Icon: ["div", "Icon"],
+    IconWrapper: ["div", "IconWrapper"],
+    InfoText: ["p", "InfoText"],
+    InlineFieldInfoBoxInnerElement: ["div", "InlineFieldInfoBoxInnerElement"],
+    InlineFieldInfoWrapper: ["div", "InlineFieldInfoWrapper"],
+    MultipleChoiceFieldContainer: ["div", "RadioFieldContainer", "MultipleChoiceFieldContainer"],
+    MultipleChoiceFieldElement: ["label", "RadioFieldElement", "MultipleChoiceFieldElement"],
+    MultipleChoiceFieldInput: "fn",
+    MultipleChoiceFieldInputElement: ["input", "FieldInput", "RadioFieldInputElement", "MultipleChoiceFieldInputElement"],
+    MultipleChoiceFieldLabel: ["span", "RadioFieldLabel", "MultipleChoiceFieldLabel"],
+    ObjectFieldAddButton: ["button", "ObjectFieldButton", "ObjectFieldAddButton"],
+    ObjectFieldButton: ["button", "ObjectFieldButton"],
+    ObjectFieldDownButton: ["button", "ObjectFieldButton", "ObjectFieldDownButton"],
+    ObjectFieldItem: ["li", "ObjectFieldItem"],
+    ObjectFieldItemButtons: ["div", "ObjectFieldItemButtons"],
+    ObjectFieldRemoveButton: ["button", "ObjectFieldButton", "ObjectFieldRemoveButton"],
+    ObjectFieldSection: "fn",
+    ObjectFieldSectionChildrenWrapper: ["div", "ObjectFieldSectionChildrenWrapper"],
+    ObjectFieldSectionTitle: ["legend", "ObjectFieldSectionTitle"],
+    ObjectFieldSectionWrapper: ["fieldset", "ObjectFieldSectionWrapper"],
+    ObjectFieldTemplateDescription: null,
+    ObjectFieldTemplateErrorMessage: null,
+    ObjectFieldTemplateHelp: null,
+    ObjectFieldTemplateInfo: null,
+    ObjectFieldTemplateRequiredIndicator: null,
+    ObjectFieldTemplateTitle: ["legend", "ObjectFieldTemplateTitle"],
+    ObjectFieldTemplateWrapper: ["fieldset", "ObjectFieldTemplateWrapper"],
+    ObjectFieldTitleInfoWrapper: ["div", "ObjectFieldTitleInfoWrapper"],
+    ObjectFieldUpButton: ["button", "ObjectFieldButton", "ObjectFieldUpButton"],
+    ObjectFieldWrapper: ["div", "ObjectFieldWrapper"],
+    ProgressBar: ["div", "ProgressBar"],
+    ProgressBarContainer: ["div", "ProgressBarContainer"],
+    RadioFieldContainer: ["div", "RadioFieldContainer"],
+    RadioFieldElement: ["label", "RadioFieldElement"],
+    RadioFieldInput: "fn",
+    RadioFieldInputElement: ["input", "FieldInput", "RadioFieldInputElement"],
+    RadioFieldLabel: ["span", "RadioFieldLabel"],
+    RadioFieldLabelFalse: ["span", "RadioFieldLabel", "RadioFieldLabelFalse"],
+    RadioFieldLabelTrue: ["span", "RadioFieldLabel", "RadioFieldLabelTrue"],
+    RemoveButton: ["button", "RemoveButton"],
+    RemoveButtonIcon: ["svg", "RemoveButtonIcon"],
+    RequiredIndicator: ["span", "RequiredIndicator"],
+    SearchableMultiTagSelectFieldBadge: ["div", "SearchableMultiTagSelectFieldBadge"],
+    SearchableMultiTagSelectFieldBadgeCloseElement: ["button", "SearchableMultiTagSelectFieldBadgeCloseElement"],
+    SearchableMultiTagSelectFieldBadgeContainer: ["div", "SearchableMultiTagSelectFieldBadgeContainer"],
+    SearchableMultiTagSelectFieldContainer: ["div", "SearchableMultiTagSelectFieldContainer"],
+    SearchableMultiTagSelectFieldInput: "fn",
+    SearchableMultiTagSelectFieldInputElement: ["input", "FieldInput", "SearchableMultiTagSelectFieldInputElement"],
+    SearchableMultiTagSelectFieldOptionList: ["ul", "SearchableMultiTagSelectFieldOptionList"],
+    SearchableMultiTagSelectFieldOptionListItem: ["li", "SearchableMultiTagSelectFieldOptionListItem"],
+    SearchableMultiTagSelectFieldOptionListWithoutItem: ["li", "SearchableMultiTagSelectFieldOptionListWithoutItem"],
+    SearchableMultiTagSelectFieldSearchContainer: ["div", "SearchableMultiTagSelectFieldSearchContainer"],
+    SearchableSelectFieldClearButton: ["button", "SearchableSelectFieldClearButton"],
+    SearchableSelectFieldContainer: ["div", "SearchableMultiTagSelectFieldSearchContainer", "SearchableSelectFieldContainer"],
+    SearchableSelectFieldDropdownContainer: ["ul", "SearchableMultiTagSelectFieldOptionList", "SearchableSelectFieldDropdownContainer"],
+    SearchableSelectFieldInputContainer: ["div", "SearchableSelectFieldInputContainer"],
+    SearchableSelectFieldInputElement: ["input", "FieldInput", "SearchableSelectFieldInputElement"],
+    SearchableSelectFieldListExpand: ["li", "SearchableMultiTagSelectFieldOptionListItem", "SearchableSelectFieldListExpand"],
+    SearchableSelectFieldListOption: ["li", "SearchableMultiTagSelectFieldOptionListItem", "SearchableSelectFieldListOption"],
+    SearchableSelectFieldNotFound: ["li", "SearchableMultiTagSelectFieldOptionListItem", "SearchableSelectFieldNotFound"],
+    SelectFieldInput: ["input", "FieldInput", "SelectFieldInput"],
+    SelectFieldInputWrapper: ["div", "SelectFieldInputWrapper"],
+    TextAreaFieldInput: ["input", "FieldInput", "TextAreaFieldInput"],
+    ToggleFieldInput: "fn",
+    ToggleFieldInputElement: ["input", "FieldInput", "ToggleFieldInputElement"],
+    ToggleFieldLabel: ["label", "ToggleFieldLabel"],
+    ToggleFieldToggle: ["span", "ToggleFieldToggle"],
+    UploadIcon: ["svg", "UploadIcon"],
+    UploadedFileInfoContainer: ["div", "UploadedFileInfoContainer"],
+    UploadedFileItemContainer: ["div", "UploadedFileItemContainer"],
+    UploadedFileName: ["div", "UploadedFileName"],
+    UploadedFileWrapper: ["div", "UploadedFileWrapper"],
+    UploadingFileName: ["div", "UploadingFileName"],
+    getComponents: "fn",
+};

package/dist/cjs/v3/raw/model/form/date.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dateField = exports.dateRules = void 0;
+const dates_1 = require("../../core/dates");
+const json_1 = require("../../core/json");
+const paths_1 = require("../../core/paths");
+const uiSchema_1 = require("../../core/uiSchema");
+const vnode_1 = require("../vnode");
+const values_1 = require("../view/values");
+const chrome_1 = require("./chrome");
+const icons_1 = require("./icons");
+const markup_1 = require("./markup");
+const templated_1 = require("./templated");
+const dateRules = (ctx, ui) => {
+    const props = (0, json_1.isPlainObject)((0, uiSchema_1.extractUiSchema)(ui).props) ? (0, uiSchema_1.extractUiSchema)(ui).props : {};
+    const min = typeof props.min === "string" ? props.min : undefined;
+    const max = typeof props.max === "string" ? props.max : undefined;
+    const raw = props.errorMessages?.outOfRange;
+    const fallback = (min && max && `Date must be between ${min} and ${max}.`) || "Date is out of range.";
+    const outOfRange = typeof raw === "function" ? String(raw({ min, max })) : (typeof raw === "string" ? raw : fallback).replace(/\{min\}/g, min ?? "").replace(/\{max\}/g, max ?? "");
+    const locale = [props.locale, ctx.formLocalization?.fields?.DateField?.locale, ctx.locale].find((l) => typeof l === "string" && l) ?? "en-US";
+    return { locale, min, max, invalid: typeof props.errorMessages?.invalid === "string" ? props.errorMessages.invalid : "Enter a valid date", outOfRange };
+};
+exports.dateRules = dateRules;
+const dateField = (ctx, p) => {
+    const props = { ...p, data: { "data-fjsf-string": p.name }, kind: "date" };
+    const ui = (0, uiSchema_1.extractUiSchema)(p.ui);
+    const inputProps = (0, json_1.isPlainObject)(ui.props) ? ui.props : {};
+    const rules = (0, exports.dateRules)(ctx, p.ui);
+    const value = (0, paths_1.getIn)(ctx.values, p.name);
+    const readOnly = p.schema?.readOnly === true;
+    const disabled = inputProps.disabled ? true : undefined;
+    const shown = ctx.ui.text?.[p.name] ?? (0, dates_1.formatForDisplay)(value, rules.locale);
+    const error = !!(0, paths_1.getIn)(ctx.errors, p.name) && !!(0, paths_1.getIn)(ctx.touched, p.name);
+    const commit = { type: "dateCommit", path: p.name, rules: { ...rules, order: (0, dates_1.preferOrderOf)(rules.locale) }, locked: readOnly || !!disabled };
+    const display = {
+        ...(0, markup_1.plain)("input", "DisplayInput", {
+            id: `${p.name}-display`, type: "text", placeholder: (0, values_1.reactAttr)(inputProps.placeholder), autocomplete: "off", inputmode: "numeric",
+            "aria-describedby": inputProps.helpText ? `${p.name}-help` : undefined, "aria-invalid": String(error), value: shown, disabled, readonly: readOnly || undefined,
+        }),
+        on: { change: { type: "dateText", path: p.name }, blur: commit, paste: commit },
+    };
+    const native = readOnly
+        ? null
+        : { ...(0, markup_1.plain)("input", "HiddenNative", { id: `${p.name}-native`, type: "date", min: rules.min, max: rules.max, value: typeof value === "string" ? value : "", tabindex: "-1", "aria-hidden": "true" }), on: { change: { ...commit, native: true } } };
+    const picker = readOnly
+        ? null
+        : { ...(0, markup_1.plain)("button", "PickerButton", { type: "button", "aria-label": "Date picker", title: "Date picker", disabled }, (0, icons_1.iconMarkup)("FaCalendar")), on: { click: { type: "datePicker", id: `${p.name}-native`, locked: !!disabled } } };
+    // 2.x: `CommonFieldWrapper as DateFieldWrapper` (DateField.tsx:10)
+    const content = [(0, markup_1.plain)("div", "CommonFieldWrapper", {}, (0, vnode_1.h)("label", { for: `${p.name}-display` }, (0, values_1.reactText)(inputProps.label)), (0, markup_1.plain)("div", "Row", {}, display, native, picker))];
+    return (0, templated_1.templated)(ctx, "FieldTemplate", props, (0, markup_1.fieldTemplateMarkup)((0, chrome_1.formChrome)(ctx, props), content), content);
+};
+exports.dateField = dateField;

package/dist/cjs/v3/raw/model/form/dispatch.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.builtIn = exports.formField = exports.S5_FIELDS = exports.COMPONENT_TYPES = void 0;
+const issues_1 = require("../../core/issues");
+const trail_1 = require("../../core/trail");
+const json_1 = require("../../core/json");
+const refs_1 = require("../../core/refs");
+const schemaType_1 = require("../../core/schemaType");
+const uiSchema_1 = require("../../core/uiSchema");
+const vnode_1 = require("../vnode");
+const markup_1 = require("./markup");
+const chrome_1 = require("./chrome");
+const any_1 = require("./any");
+const array_1 = require("./array");
+const leaf_1 = require("./leaf");
+const object_1 = require("./object");
+const markup_2 = require("./markup");
+const choice_1 = require("./choice");
+const date_1 = require("./date");
+const searchable_1 = require("./searchable");
+const upload_1 = require("./upload");
+const paths_1 = require("../../core/paths");
+exports.COMPONENT_TYPES = {
+    array: "ArrayField", boolean: "BooleanField", integer: "NumberField", number: "NumberField",
+    object: "ObjectField", string: "StringField", null: "NullField", any: "AnyField",
+};
+/** Built-in field names of slice S5. */
+exports.S5_FIELDS = new Set([
+    "DateField", "SearchableSelectField", "SearchableMultiTagSelectField", "MultipleChoiceField", "RadioField", "ToggleField", "FileUploadField", "FilesUploadField",
+]);
+const BUILT_IN = new Set([...Object.values(exports.COMPONENT_TYPES), "TextAreaField", "SchemaField", ...exports.S5_FIELDS]);
+/** Fields that applied defaults on mount in 2.x (useSetDefault). */
+const DEFAULTING = new Set(["StringField", "NumberField", "TextAreaField", "BooleanField", "ObjectField", "ArrayField", ...exports.S5_FIELDS]);
+/** The upload fields: the host renders its upload component here; RAW draws the state after mount (no upload running). */
+const uploadHost = (ctx, field, p) => {
+    const value = (0, paths_1.getIn)(ctx.values, p.name);
+    const markup = field === "FileUploadField"
+        ? (0, upload_1.fileUploadMarkup)(ctx, p, { value, uploadedFile: null, progress: 0 })
+        : (0, upload_1.filesUploadMarkup)(ctx, p, { value, files: (0, upload_1.filesOf)(value), progress: Object.fromEntries((0, upload_1.filesOf)(value).map((f) => [f.progressId, 100])), dragging: false });
+    const props = { name: p.name, schema: p.schema, uiSchema: p.ui, ...(p.required !== undefined ? { required: p.required } : {}), ...(p.hidden ? { "data-fjsf-hidden": "true" } : {}) };
+    return (0, vnode_1.withHost)((0, vnode_1.h)("#fragment", {}, markup), { kind: "field", field, props });
+};
+const byType = (schema) => {
+    let type = (0, schemaType_1.getSchemaType)(schema);
+    if (Array.isArray(type))
+        type = type[0];
+    return exports.COMPONENT_TYPES[type || "any"];
+};
+/** A field the host provides: the caller's field gets the 2.x SchemaField props. */
+const slot = (ctx, p, field, chain) => {
+    const props = {
+        "data-fjsf-kind": "custom", name: p.name, schema: p.schema, uiSchema: p.ui,
+        ...(p.required !== undefined ? { required: p.required } : {}),
+        ...(p.hidden ? { "data-fjsf-hidden": "true", style: { display: "none" } } : {}),
+        ...(p.forceDefaultValue !== undefined ? { forceDefaultValue: p.forceDefaultValue } : {}),
+    };
+    const markup = (0, markup_1.fieldTemplateMarkup)((0, chrome_1.formChrome)(ctx, { ...p, kind: "custom" }), [(0, vnode_1.h)("div", { "data-fjsf-slot": p.name, "data-fjsf-field": field })]);
+    return (0, vnode_1.withHost)(markup, { kind: "field", field, props, chain });
+};
+const formField = (ctx, p, chain = [], trail = []) => {
+    const given = p.schema;
+    const ref = (0, json_1.isPlainObject)(given) && typeof given.$ref === "string" ? given.$ref : undefined;
+    if (ref && chain.includes(ref)) {
+        ctx.sink((0, issues_1.issue)("REF_CYCLE", p.name, ref));
+        return (0, leaf_1.nullField)(ctx, { ...p, kind: "error" });
+    }
+    const next = ref ? [...chain, ref] : chain;
+    const resolved = given === undefined
+        ? { schema: undefined, uiSchema: p.ui }
+        : (0, refs_1.resolveRefs)(given, p.ui, { definitions: ctx.definitions, defs: ctx.defs, uiSchemaDefinitions: ctx.uiDefinitions, sink: ctx.sink, path: p.name });
+    const q = { ...p, schema: resolved.schema, ui: resolved.uiSchema };
+    const field = (0, uiSchema_1.extractUiSchema)(q.ui).field;
+    if (typeof field === "function")
+        return slot(ctx, q, "", next);
+    if (typeof field === "string" && ctx.customFields.includes(field))
+        return slot(ctx, q, field, next);
+    // SEC-UI-1/2: an unknown name (also "constructor", "toString") is reported and the type's field renders.
+    if (typeof field === "string" && !BUILT_IN.has(field))
+        ctx.sink((0, issues_1.issue)("FIELD_UNKNOWN", q.name, field));
+    let component = typeof field === "string" && BUILT_IN.has(field) ? field : byType(q.schema);
+    if (!component) {
+        ctx.sink((0, issues_1.issue)("SCHEMA_UNSUPPORTED_TYPE", q.name, String((0, schemaType_1.getSchemaType)(q.schema))));
+        return (0, vnode_1.h)("p", { style: "color:red" }, '!!! Unsupported field "" !!!');
+    }
+    if (ctx.customFields.includes(component))
+        return slot(ctx, q, component, next);
+    return (0, exports.builtIn)(ctx, component, q, next, trail);
+};
+exports.formField = formField;
+/** One built-in field by name (2.x `FormFields.X`). */
+const builtIn = (ctx, component, p, chain = [], trail = []) => {
+    if (DEFAULTING.has(component) && p.name)
+        ctx.appeared.push({ path: p.name, schema: p.schema, forceDefaultValue: !!p.forceDefaultValue });
+    switch (component) {
+        case "ObjectField":
+            // BUG-110: an object schema that contains itself, or nests too deep, is cut with a code.
+            if (!(0, json_1.isPlainObject)(p.schema) || (0, trail_1.mayEnter)(p.schema, trail, ctx.sink, p.name))
+                return (0, object_1.objectField)(ctx, p, chain, (0, json_1.isPlainObject)(p.schema) ? [...trail, p.schema] : trail);
+            return (0, leaf_1.nullField)(ctx, { ...p, kind: "error" });
+        case "ArrayField": return (0, array_1.arrayField)(ctx, p, chain);
+        case "NumberField": return (0, markup_2.plain)("div", "NumberFieldWrapper", {}, (0, leaf_1.stringField)(ctx, p, true));
+        case "StringField": return (0, leaf_1.stringField)(ctx, p);
+        case "TextAreaField": return (0, leaf_1.textAreaField)(ctx, p);
+        case "BooleanField": return (0, leaf_1.booleanField)(ctx, p);
+        case "NullField": return (0, leaf_1.nullField)(ctx, p);
+        case "AnyField": return (0, any_1.anyField)(ctx, p, chain, trail);
+        case "SchemaField": return (0, exports.formField)(ctx, p, chain, trail);
+        case "DateField": return (0, date_1.dateField)(ctx, p);
+        case "RadioField": return (0, choice_1.radioField)(ctx, p);
+        case "ToggleField": return (0, choice_1.toggleField)(ctx, p);
+        case "MultipleChoiceField": return (0, choice_1.multipleChoiceField)(ctx, p);
+        case "SearchableSelectField": return (0, searchable_1.searchableSelectField)(ctx, p);
+        case "SearchableMultiTagSelectField": return (0, searchable_1.searchableMultiTagField)(ctx, p);
+        case "FileUploadField":
+        case "FilesUploadField": return uploadHost(ctx, component, p);
+        default: return (0, exports.builtIn)(ctx, byType(p.schema) ?? "AnyField", p, chain, trail);
+    }
+};
+exports.builtIn = builtIn;

package/dist/cjs/v3/raw/model/form/iconData.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ICONS = void 0;
+// react-icons (Font Awesome 5) glyphs 2.x rendered in the S5 fields, as data: the v3 React layer may not import
+// react-icons (ESLint boundary). Generated from react-icons/fa; rendered by iconMarkup (form/icons.ts).
+exports.ICONS = {
+    FaCalendar: { viewBox: "0 0 448 512", paths: ["M12 192h424c6.6 0 12 5.4 12 12v260c0 26.5-21.5 48-48 48H48c-26.5 0-48-21.5-48-48V204c0-6.6 5.4-12 12-12zm436-44v-36c0-26.5-21.5-48-48-48h-48V12c0-6.6-5.4-12-12-12h-40c-6.6 0-12 5.4-12 12v52H160V12c0-6.6-5.4-12-12-12h-40c-6.6 0-12 5.4-12 12v52H48C21.5 64 0 85.5 0 112v36c0 6.6 5.4 12 12 12h424c6.6 0 12-5.4 12-12z"] },
+    FaCloudUploadAlt: { viewBox: "0 0 640 512", paths: ["M537.6 226.6c4.1-10.7 6.4-22.4 6.4-34.6 0-53-43-96-96-96-19.7 0-38.1 6-53.3 16.2C367 64.2 315.3 32 256 32c-88.4 0-160 71.6-160 160 0 2.7.1 5.4.2 8.1C40.2 219.8 0 273.2 0 336c0 79.5 64.5 144 144 144h368c70.7 0 128-57.3 128-128 0-61.9-44-113.6-102.4-125.4zM393.4 288H328v112c0 8.8-7.2 16-16 16h-48c-8.8 0-16-7.2-16-16V288h-65.4c-14.3 0-21.4-17.2-11.3-27.3l105.4-105.4c6.2-6.2 16.4-6.2 22.6 0l105.4 105.4c10.1 10.1 2.9 27.3-11.3 27.3z"] },
+    FaTrash: { viewBox: "0 0 448 512", paths: ["M432 32H312l-9.4-18.7A24 24 0 0 0 281.1 0H166.8a23.72 23.72 0 0 0-21.4 13.3L136 32H16A16 16 0 0 0 0 48v32a16 16 0 0 0 16 16h416a16 16 0 0 0 16-16V48a16 16 0 0 0-16-16zM53.2 467a48 48 0 0 0 47.9 45h245.8a48 48 0 0 0 47.9-45L416 128H32z"] },
+    FaFile: { viewBox: "0 0 384 512", paths: ["M224 136V0H24C10.7 0 0 10.7 0 24v464c0 13.3 10.7 24 24 24h336c13.3 0 24-10.7 24-24V160H248c-13.2 0-24-10.8-24-24zm160-14.1v6.1H256V0h6.1c6.4 0 12.5 2.5 17 7l97.9 98c4.5 4.5 7 10.6 7 16.9z"] },
+    FaFilePdf: { viewBox: "0 0 384 512", paths: ["M181.9 256.1c-5-16-4.9-46.9-2-46.9 8.4 0 7.6 36.9 2 46.9zm-1.7 47.2c-7.7 20.2-17.3 43.3-28.4 62.7 18.3-7 39-17.2 62.9-21.9-12.7-9.6-24.9-23.4-34.5-40.8zM86.1 428.1c0 .8 13.2-5.4 34.9-40.2-6.7 6.3-29.1 24.5-34.9 40.2zM248 160h136v328c0 13.3-10.7 24-24 24H24c-13.3 0-24-10.7-24-24V24C0 10.7 10.7 0 24 0h200v136c0 13.2 10.8 24 24 24zm-8 171.8c-20-12.2-33.3-29-42.7-53.8 4.5-18.5 11.6-46.6 6.2-64.2-4.7-29.4-42.4-26.5-47.8-6.8-5 18.3-.4 44.1 8.1 77-11.6 27.6-28.7 64.6-40.8 85.8-.1 0-.1.1-.2.1-27.1 13.9-73.6 44.5-54.5 68 5.6 6.9 16 10 21.5 10 17.9 0 35.7-18 61.1-61.8 25.8-8.5 54.1-19.1 79-23.2 21.7 11.8 47.1 19.5 64 19.5 29.2 0 31.2-32 19.7-43.4-13.9-13.6-54.3-9.7-73.6-7.2zM377 105L279 7c-4.5-4.5-10.6-7-17-7h-6v128h128v-6.1c0-6.3-2.5-12.4-7-16.9zm-74.1 255.3c4.1-2.7-2.5-11.9-42.8-9 37.1 15.8 42.8 9 42.8 9z"] },
+    FaFileAudio: { viewBox: "0 0 384 512", paths: ["M224 136V0H24C10.7 0 0 10.7 0 24v464c0 13.3 10.7 24 24 24h336c13.3 0 24-10.7 24-24V160H248c-13.2 0-24-10.8-24-24zm-64 268c0 10.7-12.9 16-20.5 8.5L104 376H76c-6.6 0-12-5.4-12-12v-56c0-6.6 5.4-12 12-12h28l35.5-36.5c7.6-7.6 20.5-2.2 20.5 8.5v136zm33.2-47.6c9.1-9.3 9.1-24.1 0-33.4-22.1-22.8 12.2-56.2 34.4-33.5 27.2 27.9 27.2 72.4 0 100.4-21.8 22.3-56.9-10.4-34.4-33.5zm86-117.1c54.4 55.9 54.4 144.8 0 200.8-21.8 22.4-57-10.3-34.4-33.5 36.2-37.2 36.3-96.5 0-133.8-22.1-22.8 12.3-56.3 34.4-33.5zM384 121.9v6.1H256V0h6.1c6.4 0 12.5 2.5 17 7l97.9 98c4.5 4.5 7 10.6 7 16.9z"] },
+    FaFileImage: { viewBox: "0 0 384 512", paths: ["M384 121.941V128H256V0h6.059a24 24 0 0 1 16.97 7.029l97.941 97.941a24.002 24.002 0 0 1 7.03 16.971zM248 160c-13.2 0-24-10.8-24-24V0H24C10.745 0 0 10.745 0 24v464c0 13.255 10.745 24 24 24h336c13.255 0 24-10.745 24-24V160H248zm-135.455 16c26.51 0 48 21.49 48 48s-21.49 48-48 48-48-21.49-48-48 21.491-48 48-48zm208 240h-256l.485-48.485L104.545 328c4.686-4.686 11.799-4.201 16.485.485L160.545 368 264.06 264.485c4.686-4.686 12.284-4.686 16.971 0L320.545 304v112z"] },
+    FaFileCsv: { viewBox: "0 0 384 512", paths: ["M224 136V0H24C10.7 0 0 10.7 0 24v464c0 13.3 10.7 24 24 24h336c13.3 0 24-10.7 24-24V160H248c-13.2 0-24-10.8-24-24zm-96 144c0 4.42-3.58 8-8 8h-8c-8.84 0-16 7.16-16 16v32c0 8.84 7.16 16 16 16h8c4.42 0 8 3.58 8 8v16c0 4.42-3.58 8-8 8h-8c-26.51 0-48-21.49-48-48v-32c0-26.51 21.49-48 48-48h8c4.42 0 8 3.58 8 8v16zm44.27 104H160c-4.42 0-8-3.58-8-8v-16c0-4.42 3.58-8 8-8h12.27c5.95 0 10.41-3.5 10.41-6.62 0-1.3-.75-2.66-2.12-3.84l-21.89-18.77c-8.47-7.22-13.33-17.48-13.33-28.14 0-21.3 19.02-38.62 42.41-38.62H200c4.42 0 8 3.58 8 8v16c0 4.42-3.58 8-8 8h-12.27c-5.95 0-10.41 3.5-10.41 6.62 0 1.3.75 2.66 2.12 3.84l21.89 18.77c8.47 7.22 13.33 17.48 13.33 28.14.01 21.29-19 38.62-42.39 38.62zM256 264v20.8c0 20.27 5.7 40.17 16 56.88 10.3-16.7 16-36.61 16-56.88V264c0-4.42 3.58-8 8-8h16c4.42 0 8 3.58 8 8v20.8c0 35.48-12.88 68.89-36.28 94.09-3.02 3.25-7.27 5.11-11.72 5.11s-8.7-1.86-11.72-5.11c-23.4-25.2-36.28-58.61-36.28-94.09V264c0-4.42 3.58-8 8-8h16c4.42 0 8 3.58 8 8zm121-159L279.1 7c-4.5-4.5-10.6-7-17-7H256v128h128v-6.1c0-6.3-2.5-12.4-7-16.9z"] },
+    FaFileWord: { viewBox: "0 0 384 512", paths: ["M224 136V0H24C10.7 0 0 10.7 0 24v464c0 13.3 10.7 24 24 24h336c13.3 0 24-10.7 24-24V160H248c-13.2 0-24-10.8-24-24zm57.1 120H305c7.7 0 13.4 7.1 11.7 14.7l-38 168c-1.2 5.5-6.1 9.3-11.7 9.3h-38c-5.5 0-10.3-3.8-11.6-9.1-25.8-103.5-20.8-81.2-25.6-110.5h-.5c-1.1 14.3-2.4 17.4-25.6 110.5-1.3 5.3-6.1 9.1-11.6 9.1H117c-5.6 0-10.5-3.9-11.7-9.4l-37.8-168c-1.7-7.5 4-14.6 11.7-14.6h24.5c5.7 0 10.7 4 11.8 9.7 15.6 78 20.1 109.5 21 122.2 1.6-10.2 7.3-32.7 29.4-122.7 1.3-5.4 6.1-9.1 11.7-9.1h29.1c5.6 0 10.4 3.8 11.7 9.2 24 100.4 28.8 124 29.6 129.4-.2-11.2-2.6-17.8 21.6-129.2 1-5.6 5.9-9.5 11.5-9.5zM384 121.9v6.1H256V0h6.1c6.4 0 12.5 2.5 17 7l97.9 98c4.5 4.5 7 10.6 7 16.9z"] },
+    FaFileExcel: { viewBox: "0 0 384 512", paths: ["M224 136V0H24C10.7 0 0 10.7 0 24v464c0 13.3 10.7 24 24 24h336c13.3 0 24-10.7 24-24V160H248c-13.2 0-24-10.8-24-24zm60.1 106.5L224 336l60.1 93.5c5.1 8-.6 18.5-10.1 18.5h-34.9c-4.4 0-8.5-2.4-10.6-6.3C208.9 405.5 192 373 192 373c-6.4 14.8-10 20-36.6 68.8-2.1 3.9-6.1 6.3-10.5 6.3H110c-9.5 0-15.2-10.5-10.1-18.5l60.3-93.5-60.3-93.5c-5.2-8 .6-18.5 10.1-18.5h34.8c4.4 0 8.5 2.4 10.6 6.3 26.1 48.8 20 33.6 36.6 68.5 0 0 6.1-11.7 36.6-68.5 2.1-3.9 6.2-6.3 10.6-6.3H274c9.5-.1 15.2 10.4 10.1 18.4zM384 121.9v6.1H256V0h6.1c6.4 0 12.5 2.5 17 7l97.9 98c4.5 4.5 7 10.6 7 16.9z"] },
+    FaFilePowerpoint: { viewBox: "0 0 384 512", paths: ["M193.7 271.2c8.8 0 15.5 2.7 20.3 8.1 9.6 10.9 9.8 32.7-.2 44.1-4.9 5.6-11.9 8.5-21.1 8.5h-26.9v-60.7h27.9zM377 105L279 7c-4.5-4.5-10.6-7-17-7h-6v128h128v-6.1c0-6.3-2.5-12.4-7-16.9zm-153 31V0H24C10.7 0 0 10.7 0 24v464c0 13.3 10.7 24 24 24h336c13.3 0 24-10.7 24-24V160H248c-13.2 0-24-10.8-24-24zm53 165.2c0 90.3-88.8 77.6-111.1 77.6V436c0 6.6-5.4 12-12 12h-30.8c-6.6 0-12-5.4-12-12V236.2c0-6.6 5.4-12 12-12h81c44.5 0 72.9 32.8 72.9 77z"] },
+    FaFileCode: { viewBox: "0 0 384 512", paths: ["M384 121.941V128H256V0h6.059c6.365 0 12.47 2.529 16.971 7.029l97.941 97.941A24.005 24.005 0 0 1 384 121.941zM248 160c-13.2 0-24-10.8-24-24V0H24C10.745 0 0 10.745 0 24v464c0 13.255 10.745 24 24 24h336c13.255 0 24-10.745 24-24V160H248zM123.206 400.505a5.4 5.4 0 0 1-7.633.246l-64.866-60.812a5.4 5.4 0 0 1 0-7.879l64.866-60.812a5.4 5.4 0 0 1 7.633.246l19.579 20.885a5.4 5.4 0 0 1-.372 7.747L101.65 336l40.763 35.874a5.4 5.4 0 0 1 .372 7.747l-19.579 20.884zm51.295 50.479l-27.453-7.97a5.402 5.402 0 0 1-3.681-6.692l61.44-211.626a5.402 5.402 0 0 1 6.692-3.681l27.452 7.97a5.4 5.4 0 0 1 3.68 6.692l-61.44 211.626a5.397 5.397 0 0 1-6.69 3.681zm160.792-111.045l-64.866 60.812a5.4 5.4 0 0 1-7.633-.246l-19.58-20.885a5.4 5.4 0 0 1 .372-7.747L284.35 336l-40.763-35.874a5.4 5.4 0 0 1-.372-7.747l19.58-20.885a5.4 5.4 0 0 1 7.633-.246l64.866 60.812a5.4 5.4 0 0 1-.001 7.879z"] },
+};

package/dist/cjs/v3/raw/model/form/icons.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iconMarkup = void 0;
+const vnode_1 = require("../vnode");
+const iconData_1 = require("./iconData");
+const iconMarkup = (name, className) => {
+    const icon = iconData_1.ICONS[name] ?? iconData_1.ICONS.FaFile;
+    return (0, vnode_1.h)("svg", { stroke: "currentColor", fill: "currentColor", "stroke-width": "0", viewBox: icon.viewBox, ...(className ? { class: className } : {}), height: "1em", width: "1em", xmlns: "http://www.w3.org/2000/svg" }, icon.paths.map((d) => (0, vnode_1.h)("path", { d })));
+};
+exports.iconMarkup = iconMarkup;

package/dist/cjs/v3/raw/model/form/index.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S5_FIELDS = exports.formField = exports.builtIn = exports.settle = exports.newAppearances = exports.applyAction = exports.formShell = exports.createFormContext = void 0;
+const issues_1 = require("../../core/issues");
+const json_1 = require("../../core/json");
+const markup_1 = require("./markup");
+const createFormContext = (schema, uiSchema, state, o = {}) => ({
+    values: state.values ?? {},
+    errors: state.errors ?? {},
+    touched: state.touched ?? {},
+    submitting: !!state.submitting,
+    customFields: o.customFields ?? [],
+    definitions: o.definitions ?? ((0, json_1.isPlainObject)(schema?.definitions) ? schema.definitions : {}),
+    defs: o.defs ?? ((0, json_1.isPlainObject)(schema?.$defs) ? schema.$defs : undefined),
+    uiDefinitions: o.uiDefinitions ?? uiSchema?.definitions,
+    sink: o.sink ?? issues_1.ignoreIssues,
+    formLocalization: o.formLocalization,
+    formOptions: o.formOptions,
+    locale: o.locale,
+    ui: o.ui ?? {},
+    hideUnmarkedAdditionalProperties: !!o.hideUnmarkedAdditionalProperties,
+    orderable: !!o.orderable,
+    appeared: [],
+    prune: [],
+    anyGuesses: {},
+});
+exports.createFormContext = createFormContext;
+/** 2.x <Form>: formik's <form action="#"> (registry Form), the fields, then the caller's children or the submit button. */
+const formShell = (content, o) => {
+    const submit = o.hideSubmit ? null : (0, markup_1.fc)(["FormButton"], { type: "submit", disabled: o.submitting || undefined, "data-fjsf-button": "submit" }, "Send");
+    const form = (0, markup_1.fc)(["Form"], { action: "#", ...(o.className ? { class: o.className } : {}) }, content, o.children !== undefined ? o.children : (0, markup_1.fc)(["FormButtonWrapper"], {}, submit));
+    return { ...form, on: { submit: { type: "submit" } } };
+};
+exports.formShell = formShell;
+var actions_1 = require("./actions");
+Object.defineProperty(exports, "applyAction", { enumerable: true, get: function () { return actions_1.applyAction; } });
+var appearance_1 = require("./appearance");
+Object.defineProperty(exports, "newAppearances", { enumerable: true, get: function () { return appearance_1.newAppearances; } });
+Object.defineProperty(exports, "settle", { enumerable: true, get: function () { return appearance_1.settle; } });
+var dispatch_1 = require("./dispatch");
+Object.defineProperty(exports, "builtIn", { enumerable: true, get: function () { return dispatch_1.builtIn; } });
+Object.defineProperty(exports, "formField", { enumerable: true, get: function () { return dispatch_1.formField; } });
+Object.defineProperty(exports, "S5_FIELDS", { enumerable: true, get: function () { return dispatch_1.S5_FIELDS; } });

package/dist/cjs/v3/raw/model/form/leaf.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nullField = exports.booleanField = exports.textAreaField = exports.textValue = exports.stringField = exports.on = exports.inputAttrs = void 0;
+const enums_1 = require("../../core/enums");
+const json_1 = require("../../core/json");
+const paths_1 = require("../../core/paths");
+const schemaType_1 = require("../../core/schemaType");
+const uiProps_1 = require("../../core/uiProps");
+const uiSchema_1 = require("../../core/uiSchema");
+const vnode_1 = require("../vnode");
+const values_1 = require("../view/values");
+const chrome_1 = require("./chrome");
+const markup_1 = require("./markup");
+const templated_1 = require("./templated");
+/** HTML input types a uiSchema may pick (`ui:type` / `ui:options.type`); others fall back to text. */
+const INPUT_TYPES = new Set(["text", "number", "email", "tel", "url", "password", "search", "date", "time", "datetime-local", "month", "week", "color", "range"]);
+const NOT_INPUT_PROPS = new Set(["wrapper", "title", "description", "help", "error", "type"]);
+/** `ui:props` for the control (2.x spread them verbatim), through the D5 allowlist. */
+const inputAttrs = (ctx, p) => {
+    const props = (0, uiSchema_1.extractUiSchema)(p.ui).props;
+    if (!(0, json_1.isPlainObject)(props))
+        return {};
+    const own = Object.fromEntries(Object.entries(props).filter(([k]) => !NOT_INPUT_PROPS.has(k)));
+    return (0, uiProps_1.filterUiProps)(own, p.name, ctx.sink).attrs;
+};
+exports.inputAttrs = inputAttrs;
+const control = (p) => ({ name: p.name, readonly: p.schema?.readOnly ? true : undefined });
+/** The control's actions. Q-RO-1: a readOnly control never changes the value (browsers ignore readonly on select/checkbox). */
+const on = (p, parse, consts) => ({
+    ...(p.schema?.readOnly ? {} : { change: { type: "set", path: p.name, parse, ...(consts ? { consts } : {}) } }),
+    // A readOnly checkbox / radio must not even toggle visually (2.x blocked the pointer).
+    ...(p.schema?.readOnly && (parse === "checkbox" || parse === "radio") ? { click: { type: "preventDefault" } } : {}),
+    blur: { type: "touch", path: p.name },
+});
+exports.on = on;
+const field = (ctx, p, content) => (0, templated_1.templated)(ctx, "FieldTemplate", p, (0, markup_1.fieldTemplateMarkup)((0, chrome_1.formChrome)(ctx, p), content), content);
+/** StringField / NumberField: an input, or a select for `oneOf`/`enum` consts. */
+const stringField = (ctx, p, numberField = false) => {
+    const ui = (0, uiSchema_1.extractUiSchema)(p.ui);
+    const value = (0, paths_1.getIn)(ctx.values, p.name);
+    const enums = (0, enums_1.getEnums)({ schema: p.schema }, ctx.sink, p.name);
+    // Q-REN-4 kept (Q12): 2.x tests `schema.type === "string"`, so type arrays carry data-fjsf-number.
+    const data = p.schema?.type === "string" ? { "data-fjsf-string": p.name } : { "data-fjsf-number": p.name };
+    // 2.x NumberField put type "number" into ui:props; `ui:options.props` replaces those (extractUiSchema), so such
+    // fields were text inputs storing strings. Kept: pro3's stored format (legacy/completeDisabled).
+    const numberType = numberField && !(0, json_1.isPlainObject)(p.ui?.["ui:options"]?.props);
+    const type = numberType ? "number" : typeof ui.type === "string" && INPUT_TYPES.has(ui.type) ? ui.type : undefined;
+    const isSelect = enums?.type === enums_1.EnumsTypes.SELECT;
+    const props = { ...p, data, kind: p.kind ?? (isSelect ? "enum" : ["number", "integer"].includes((0, schemaType_1.getSchemaType)(p.schema)) ? "number" : "string") };
+    if (isSelect) {
+        const placeholderOpts = ui.placeholderOptionOptions?.props ?? {};
+        const options = [
+            (0, vnode_1.h)("option", { value: "", disabled: placeholderOpts.disabled === true ? true : undefined, hidden: placeholderOpts.hidden === false ? undefined : true }, (0, values_1.reactText)(ui.placeholder)),
+            ...enums.values.map((o) => (0, vnode_1.h)("option", { value: (0, values_1.reactAttr)(o?.const) ?? "" }, (0, values_1.reactText)(o?.title))),
+        ];
+        const select = { ...(0, markup_1.fcAs)("select", ["SelectFieldInput"], { ...(0, exports.inputAttrs)(ctx, props), ...control(props), value: (0, values_1.reactAttr)(value) ?? "" }, options), on: (0, exports.on)(props, "enum", enums.values.map((o) => o?.const)) };
+        return field(ctx, props, [(0, markup_1.plain)("div", "StringFieldWrapper", {}, select)]);
+    }
+    const input = { ...(0, markup_1.fc)(["FieldInput"], { type, placeholder: (0, values_1.reactAttr)(ui.placeholder), ...(0, exports.inputAttrs)(ctx, props), ...control(props), value: (0, exports.textValue)(value) }), on: (0, exports.on)(props, type === "number" ? "number" : "text") };
+    return field(ctx, props, [(0, markup_1.plain)("div", "StringFieldWrapper", {}, input)]);
+};
+exports.stringField = stringField;
+/** What an input shows for a stored value (React renders primitives; objects and arrays are not shown). */
+const textValue = (value) => {
+    if (value === undefined || value === null)
+        return "";
+    try {
+        return String(value); // React's coercion: an object shows "[object Object]", an array "a,b" (2.x)
+    }
+    catch {
+        return ""; // a null-prototype object has no toString (BUG-109: never throw)
+    }
+};
+exports.textValue = textValue;
+const textAreaField = (ctx, p) => {
+    const props = { ...p, data: { "data-fjsf-string": p.name }, kind: "textarea" };
+    const value = (0, exports.textValue)((0, paths_1.getIn)(ctx.values, p.name));
+    const area = {
+        ...(0, markup_1.fcAs)("textarea", ["TextAreaFieldInput"], { placeholder: (0, values_1.reactAttr)((0, uiSchema_1.extractUiSchema)(p.ui).placeholder), ...(0, exports.inputAttrs)(ctx, props), ...control(props), value }),
+        on: (0, exports.on)(props, "text"),
+    };
+    return field(ctx, props, [area]);
+};
+exports.textAreaField = textAreaField;
+/** BooleanField: a checkbox (stores true/false, Q-R19-1) and its ui:label, which toggles on click (BUG-FMK-1: nested path). */
+const booleanField = (ctx, p) => {
+    const props = { ...p, data: { "data-fjsf-boolean": p.name }, kind: p.kind ?? "boolean" };
+    const value = (0, paths_1.getIn)(ctx.values, p.name);
+    const label = (0, uiSchema_1.extractUiSchema)(p.ui).label;
+    // Q-UI-8: 2.x crashed on a {true,false} label in Form; v3 shows the one for the value.
+    const text = (0, json_1.isPlainObject)(label) ? (0, values_1.reactText)(value === true ? label.true : value === false ? label.false : undefined) : (0, values_1.reactText)(label);
+    // formik Field: checked = !!value (a stored truthy string shows checked); a change stores a boolean (Q-R19-1).
+    const box = { ...(0, markup_1.fc)(["FieldInput"], { ...(0, exports.inputAttrs)(ctx, props), ...control(props), type: "checkbox", checked: !!value }), on: (0, exports.on)(props, "checkbox") };
+    const span = { ...(0, vnode_1.h)("span", {}, text), on: { click: { type: "toggle", path: p.name } } };
+    return field(ctx, props, [(0, markup_1.fc)(["BooleanFieldWrapper"], {}, box, span)]);
+};
+exports.booleanField = booleanField;
+const nullField = (ctx, p) => field(ctx, { ...p, data: { "data-fjsf-null": p.name }, kind: "null" }, []);
+exports.nullField = nullField;

package/dist/cjs/v3/raw/model/form/markup.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrayTemplateMarkup = exports.collapsibleTemplateMarkup = exports.objectTemplateMarkup = exports.fieldTemplateMarkup = exports.fcComposite = exports.plain = exports.fcAs = exports.fc = void 0;
+const classes_1 = require("../classes");
+const vnode_1 = require("../vnode");
+const componentTable_1 = require("./componentTable");
+const classOf = (chain, extra) => [...(0, classes_1.expandClasses)(chain.map((n) => `fjsf-${n}`)), ...(typeof extra === "string" && extra ? [extra] : [])].join(" ");
+/** A registry component element: the default is the first name of the chain that 2.x defines. */
+const fc = (names, attrs, ...children) => (0, exports.fcAs)(undefined, names, attrs, ...children);
+exports.fc = fc;
+/** Same, with another tag (2.x `formikAs`: a FieldInput rendered as select / textarea). */
+const fcAs = (tag, names, attrs, ...children) => {
+    const entry = names.map((n) => componentTable_1.FORM_COMPONENTS[n]).find((e) => Array.isArray(e));
+    const [own, ...chain] = entry ?? ["div", names[names.length - 1]];
+    const { class: extra, ...rest } = attrs;
+    return (0, vnode_1.withHost)((0, vnode_1.h)(tag ?? own, { class: classOf(chain, extra), ...rest }, ...children), { kind: "component", names });
+};
+exports.fcAs = fcAs;
+/** A styled element that is not a registry key (2.x StringFieldWrapper, ErrorText, ...). */
+const plain = (tag, name, attrs, ...children) => {
+    const { class: extra, ...rest } = attrs;
+    return (0, vnode_1.h)(tag, { class: classOf([name], extra), ...rest }, ...children);
+};
+exports.plain = plain;
+/** A 2.x function component in the registry: an override gets `props` (and `children`). */
+const fcComposite = (name, props, content, ...markup) => (0, vnode_1.withHost)((0, vnode_1.h)("#fragment", {}, ...markup), { kind: "component", names: [name], props, ...(content ? { children: content } : {}) });
+exports.fcComposite = fcComposite;
+const required = (c, names) => (c.required ? (0, exports.fc)(names, {}) : null);
+/** 2.x Form FieldTemplate. */
+const fieldTemplateMarkup = (c, content) => (0, exports.fc)(["FieldWrapper"], c.disabled ? { ...c.attrs, "aria-disabled": "true" } : c.attrs, (0, exports.fc)(["FieldTitleInfoWrapper"], {}, c.title ? (0, exports.fc)(["FieldTitle"], { ...c.titleAttrs, for: c.path }, c.title, required(c, ["RequiredIndicator"])) : null, c.info ?? null), c.description ? (0, exports.fc)(["FieldDescription"], { ...c.descriptionAttrs }, c.description) : null, ...content, c.help ? (0, exports.fc)(["FieldHelp"], { ...c.helpAttrs }, c.help) : null, c.error ?? null);
+exports.fieldTemplateMarkup = fieldTemplateMarkup;
+/** 2.x ObjectFieldTemplate (fieldset + legend). */
+const objectTemplateMarkup = (c, content) => (0, exports.fc)(["ObjectFieldTemplateWrapper"], c.attrs, (0, exports.fc)(["ObjectFieldTitleInfoWrapper"], {}, c.title ? (0, exports.fc)(["ObjectFieldTemplateTitle"], { ...c.titleAttrs }, c.title, required(c, ["ObjectFieldTemplateRequiredIndicator", "RequiredIndicator"])) : null, c.info ?? null), c.description ? (0, exports.fc)(["ObjectFieldTemplateDescription", "FieldDescription"], { ...c.descriptionAttrs }, c.description) : null, ...content, c.help ? (0, exports.fc)(["ObjectFieldTemplateHelp", "FieldHelp"], { ...c.helpAttrs }, c.help) : null);
+exports.objectTemplateMarkup = objectTemplateMarkup;
+/** 2.x CollapsibleObjectFieldTemplate: a toggle button around the title; ChildrenWrapper is the wrapper chain (2.x). */
+const collapsibleTemplateMarkup = (c, content, o) => {
+    const C = "CollapsibleObjectFieldTemplate";
+    const toggle = (0, exports.fc)([`${C}Toggle`], 
+    // Q-A11Y-1: the toggle states whether its panel is open (2.x had no aria-expanded)
+    { type: "button", "data-fjsf-button": "collapse", "aria-label": o.ariaLabel, "aria-expanded": o.collapsed ? "false" : "true" }, (0, exports.fc)([`${C}Title`, "ObjectFieldTemplateTitle"], { ...c.titleAttrs, for: c.path }, c.title, required(c, [`${C}RequiredIndicator`, "ObjectFieldTemplateRequiredIndicator", "RequiredIndicator"]), (0, exports.fc)([`${C}Icon`, "Icon"], {}, o.icon)));
+    return (0, exports.fc)([`${C}Wrapper`, "ObjectFieldTemplateWrapper"], c.attrs, (0, exports.fc)(["CollapsibleObjectTitleInfoWrapper", "ObjectFieldTitleInfoWrapper"], {}, c.title ? { ...toggle, on: { click: { type: "collapse", id: o.id, collapsed: !o.collapsed } } } : null, c.info ?? null), (0, exports.fc)([`${C}Wrapper`, "ObjectFieldTemplateWrapper"], o.collapsed ? { style: "display:none", "data-fjsf-hidden": "true" } : {}, c.description ? (0, exports.fc)([`${C}Description`, "ObjectFieldTemplateDescription", "FieldDescription"], { ...c.descriptionAttrs }, c.description) : null, ...content, c.help ? (0, exports.fc)([`${C}Help`, "ObjectFieldTemplateHelp", "FieldHelp"], { ...c.helpAttrs }, c.help) : null));
+};
+exports.collapsibleTemplateMarkup = collapsibleTemplateMarkup;
+/** 2.x ArrayFieldTemplate: the array names first, then the object/field fallbacks; the title keeps `for`. */
+const arrayTemplateMarkup = (c, items) => (0, exports.fc)(["ArrayFieldTemplateWrapper", "ObjectFieldTemplateWrapper"], c.attrs, (0, exports.fc)(["ArrayFieldTitleInfoWrapper", "ObjectFieldTitleInfoWrapper"], {}, c.title ? (0, exports.fc)(["ArrayFieldTemplateTitle", "ObjectFieldTemplateTitle"], { ...c.titleAttrs, for: c.path }, c.title, required(c, ["ArrayFieldTemplateRequiredIndicator", "RequiredIndicator"])) : null, c.info ?? null), c.description ? (0, exports.fc)(["ArrayFieldTemplateDescription", "FieldDescription"], { ...c.descriptionAttrs }, c.description) : null, ...items, c.help ? (0, exports.fc)(["ArrayFieldTemplateHelp", "FieldHelp"], { ...c.helpAttrs }, c.help) : null, c.error ?? null);
+exports.arrayTemplateMarkup = arrayTemplateMarkup;