@stapel/forms-react 0.1.0

package/dist/model/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/model/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AAEnD,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,CAAC;AAEnE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,YAAY,CAcd"}

package/dist/model/runtime.js

@@ -0,0 +1,14 @@
+import { createModuleRuntime } from "@stapel/core";
+import { createFormsApi } from "../api/formsApi.js";
+export function createFormsRuntime(options) {
+    return createModuleRuntime((client) => createFormsApi(client, {
+        ...(options.fetch !== undefined ? { fetch: options.fetch } : {}),
+        ...(options.credentials !== undefined
+            ? { credentials: options.credentials }
+            : {}),
+        ...(options.defaultHeaders !== undefined
+            ? { defaultHeaders: options.defaultHeaders }
+            : {}),
+    }), options);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/model/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/model/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA6BpD,MAAM,UAAU,kBAAkB,CAChC,OAAkC;IAElC,OAAO,mBAAmB,CACxB,CAAC,MAAM,EAAE,EAAE,CACT,cAAc,CAAC,MAAM,EAAE;QACrB,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;YACnC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;YACtC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;YACtC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,EACJ,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/widgets/configForms.d.ts

@@ -0,0 +1,112 @@
+/**
+ * The field-kind CONFIG CONTRACT — what `<FormBuilder>` is data-driven off.
+ *
+ * ── Why this table exists in TypeScript at all ─────────────────────────────
+ *
+ * `stapel_attributes.config_form` declares every feature type's admin config
+ * form as DATA (`FormField(name, kind, label_key, required, default, params)`)
+ * precisely so a builder needs no per-type UI. Its own docstring, however,
+ * records how that data reaches a client: *"Emitted server-side onto the admin
+ * page via the widget (**no endpoint**)."* There is no REST surface serving
+ * `form_declarations()` — not in stapel-attributes, and not among
+ * stapel-forms' 13 paths (verified against `docs/schema.json`).
+ *
+ * So this module MIRRORS the upstream declarations rather than fetching them.
+ * That is a real, named cost, not a design preference — see the spec delta
+ * filed for it. What the mirror buys is the property §8 actually asked for:
+ * the builder iterates a table, so a kind is configured by DATA and no kind
+ * gets a bespoke hand-written form. What it costs is that the table can drift
+ * from upstream until the endpoint exists; the drift is bounded by
+ * `test/configForms.test.ts`, which pins every entry against the values quoted
+ * from `config_form.py` here.
+ *
+ * Source: `stapel_attributes/config_form.py::BUILTIN_FORMS` (attributes 0.4.6).
+ *
+ * ── v1 scope, and the two kinds that ship builder-less ─────────────────────
+ *
+ * Spec §12 risk 5: *"if a kind's config form turns out unrepresentable, that
+ * kind ships builder-less (authorable via draft PUT) rather than growing
+ * bespoke UI."* Applying it honestly:
+ *
+ *  - **`convertible_unit`** declares NO config form upstream (it is absent
+ *    from `BUILTIN_FORMS`). Nothing to render → builder-less.
+ *  - **`hierarchical_select`** declares exactly one field, of kind
+ *    `hierarchical_options` — a tree editor. Its whole form is the
+ *    unrepresentable part → builder-less.
+ *
+ * Both remain fully RENDERABLE (they have widgets) and fully authorable
+ * through `PUT /forms/<id>/draft`. The builder says so instead of pretending.
+ *
+ * Two individual config FIELDS are also v1-unrepresentable and are marked
+ * {@link ConfigFieldSpec.unsupported}: `date.options` (`timestamp_array`) and
+ * anything else using `hierarchical_options`. The builder renders the rest of
+ * that kind's form and states which options it cannot edit — dropping them
+ * silently would present a partial form as a complete one.
+ */
+/**
+ * The config-widget vocabulary — `stapel_attributes.config_form.FIELD_KINDS`.
+ * A kind here is a WIDGET, not a feature type: this is why the builder scales
+ * to a host-registered type for free, exactly as the upstream docstring
+ * promises ("a newly registered type gets an admin form with zero JS as long
+ * as it uses the standard field-kinds").
+ */
+export type ConfigFieldKind = "number" | "text" | "checkbox" | "translatable_text" | "number_options" | "string_options" | "color_options" | "select" | "select_options_with_default" | "max_selected_dropdown" | "hierarchical_options" | "timestamp" | "timestamp_array";
+/** One inline choice of a `select` config widget. */
+export interface ConfigSelectOption {
+    readonly value: string;
+    readonly label: string;
+}
+/** One declared config-form field (upstream `FormField.to_dict()`). */
+export interface ConfigFieldSpec {
+    /** The config key this field edits. Order is significant. */
+    readonly name: string;
+    readonly kind: ConfigFieldKind;
+    /** Upstream i18n key, `admin.attributes.form.<type>.<field>`. The builder
+     * renders `t(labelKey)` and falls back to a humanized `name`. */
+    readonly labelKey: string;
+    /** Cosmetic `*` marker only — real validation is server-side. */
+    readonly required?: boolean;
+    /** Applied when the config key is absent. */
+    readonly default?: unknown;
+    /** Inline choices, for `kind: "select"`. */
+    readonly options?: readonly ConfigSelectOption[];
+    /** Numeric step, for `kind: "number"`. */
+    readonly step?: number;
+    /** Placeholder, for the text-ish kinds. */
+    readonly placeholder?: string;
+    /**
+     * Set when v1 has no widget for this config kind. The builder shows the row
+     * disabled with an explanation rather than omitting it — a config form that
+     * silently hides an option looks complete when it is not.
+     */
+    readonly unsupported?: true;
+}
+/** A field kind's full config declaration. */
+export interface KindConfigForm {
+    /** Upstream i18n key, `admin.attributes.type.<slug>`. */
+    readonly labelKey: string;
+    readonly fields: readonly ConfigFieldSpec[];
+}
+/**
+ * Field kind → its config form. A kind ABSENT from this table ships
+ * builder-less (see the module header): `convertible_unit` (no upstream
+ * declaration) and `hierarchical_select` (its only field is a tree editor).
+ */
+export declare const FIELD_KIND_CONFIG_FORMS: Readonly<Record<string, KindConfigForm>>;
+/**
+ * The kinds the builder can configure, in offer order. Anything in
+ * `BUILTIN_FIELD_KINDS` but not here is builder-less by the §12 risk-5 rule.
+ */
+export declare const BUILDER_KINDS: readonly string[];
+/** Can `<FormBuilder>` configure this kind? */
+export declare function isBuilderSupportedKind(kind: string): boolean;
+/** The kind's config declaration, or `undefined` when it ships builder-less. */
+export declare function configFormFor(kind: string): KindConfigForm | undefined;
+/**
+ * The config defaults a freshly-added field of this kind starts with — every
+ * declared `default`, and nothing else. Keys with no upstream default stay
+ * ABSENT rather than being written as `null`: the engine's dataclass reads an
+ * absent key as "use my own default", and writing one changes behaviour.
+ */
+export declare function defaultConfigFor(kind: string): Record<string, unknown>;
+//# sourceMappingURL=configForms.d.ts.map

package/dist/widgets/configForms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configForms.d.ts","sourceRoot":"","sources":["../../src/widgets/configForms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,MAAM,GACN,UAAU,GACV,mBAAmB,GACnB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,QAAQ,GACR,6BAA6B,GAC7B,uBAAuB,GACvB,sBAAsB,GACtB,WAAW,GACX,iBAAiB,CAAC;AAEtB,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B;qEACiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;CAC7B;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AA0HD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAS5E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAS1C,CAAC;AAEF,+CAA+C;AAC/C,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQtE"}

package/dist/widgets/configForms.js

@@ -0,0 +1,211 @@
+/**
+ * The field-kind CONFIG CONTRACT — what `<FormBuilder>` is data-driven off.
+ *
+ * ── Why this table exists in TypeScript at all ─────────────────────────────
+ *
+ * `stapel_attributes.config_form` declares every feature type's admin config
+ * form as DATA (`FormField(name, kind, label_key, required, default, params)`)
+ * precisely so a builder needs no per-type UI. Its own docstring, however,
+ * records how that data reaches a client: *"Emitted server-side onto the admin
+ * page via the widget (**no endpoint**)."* There is no REST surface serving
+ * `form_declarations()` — not in stapel-attributes, and not among
+ * stapel-forms' 13 paths (verified against `docs/schema.json`).
+ *
+ * So this module MIRRORS the upstream declarations rather than fetching them.
+ * That is a real, named cost, not a design preference — see the spec delta
+ * filed for it. What the mirror buys is the property §8 actually asked for:
+ * the builder iterates a table, so a kind is configured by DATA and no kind
+ * gets a bespoke hand-written form. What it costs is that the table can drift
+ * from upstream until the endpoint exists; the drift is bounded by
+ * `test/configForms.test.ts`, which pins every entry against the values quoted
+ * from `config_form.py` here.
+ *
+ * Source: `stapel_attributes/config_form.py::BUILTIN_FORMS` (attributes 0.4.6).
+ *
+ * ── v1 scope, and the two kinds that ship builder-less ─────────────────────
+ *
+ * Spec §12 risk 5: *"if a kind's config form turns out unrepresentable, that
+ * kind ships builder-less (authorable via draft PUT) rather than growing
+ * bespoke UI."* Applying it honestly:
+ *
+ *  - **`convertible_unit`** declares NO config form upstream (it is absent
+ *    from `BUILTIN_FORMS`). Nothing to render → builder-less.
+ *  - **`hierarchical_select`** declares exactly one field, of kind
+ *    `hierarchical_options` — a tree editor. Its whole form is the
+ *    unrepresentable part → builder-less.
+ *
+ * Both remain fully RENDERABLE (they have widgets) and fully authorable
+ * through `PUT /forms/<id>/draft`. The builder says so instead of pretending.
+ *
+ * Two individual config FIELDS are also v1-unrepresentable and are marked
+ * {@link ConfigFieldSpec.unsupported}: `date.options` (`timestamp_array`) and
+ * anything else using `hierarchical_options`. The builder renders the rest of
+ * that kind's form and states which options it cannot edit — dropping them
+ * silently would present a partial form as a complete one.
+ */
+function lk(type, field) {
+    return `admin.attributes.form.${type}.${field}`;
+}
+const INT_FIELDS = [
+    { name: "min", kind: "number", labelKey: lk("int", "min"), step: 1 },
+    { name: "max", kind: "number", labelKey: lk("int", "max"), step: 1 },
+    { name: "options", kind: "number_options", labelKey: lk("int", "options") },
+    { name: "allowCustom", kind: "checkbox", labelKey: lk("int", "allowCustom"), default: true },
+    { name: "prefix", kind: "translatable_text", labelKey: lk("int", "prefix"), placeholder: "$" },
+    { name: "postfix", kind: "translatable_text", labelKey: lk("int", "postfix"), placeholder: "km" },
+    { name: "postfix1000", kind: "translatable_text", labelKey: lk("int", "postfix1000"), placeholder: "k" },
+    { name: "placeholder", kind: "translatable_text", labelKey: lk("int", "placeholder") },
+];
+const FLOAT_FIELDS = [
+    { name: "min", kind: "number", labelKey: lk("float", "min"), step: 0.01 },
+    { name: "max", kind: "number", labelKey: lk("float", "max"), step: 0.01 },
+    { name: "precision", kind: "number", labelKey: lk("float", "precision"), default: 2, step: 1 },
+    { name: "options", kind: "number_options", labelKey: lk("float", "options") },
+    { name: "allowCustom", kind: "checkbox", labelKey: lk("float", "allowCustom"), default: true },
+    { name: "prefix", kind: "translatable_text", labelKey: lk("float", "prefix"), placeholder: "$" },
+    { name: "postfix", kind: "translatable_text", labelKey: lk("float", "postfix"), placeholder: "m²" },
+    { name: "postfix1000", kind: "translatable_text", labelKey: lk("float", "postfix1000"), placeholder: "k" },
+    { name: "placeholder", kind: "translatable_text", labelKey: lk("float", "placeholder") },
+];
+const STRING_FIELDS = [
+    { name: "minLength", kind: "number", labelKey: lk("string", "minLength"), step: 1 },
+    { name: "maxLength", kind: "number", labelKey: lk("string", "maxLength"), step: 1 },
+    // stapel-attributes 0.4.6. Rendering metadata only — the string widget draws
+    // a textarea instead of an input. Absent means false, which is what every
+    // schema published against 0.4.5 (including stapel-forms 0.1.0's own tests)
+    // carries, so nothing stored needs a migration.
+    { name: "multiline", kind: "checkbox", labelKey: lk("string", "multiline"), default: false },
+    { name: "pattern", kind: "text", labelKey: lk("string", "pattern") },
+    { name: "options", kind: "string_options", labelKey: lk("string", "options") },
+    { name: "allowCustom", kind: "checkbox", labelKey: lk("string", "allowCustom"), default: true },
+    { name: "prefix", kind: "translatable_text", labelKey: lk("string", "prefix"), placeholder: "$" },
+    { name: "postfix", kind: "translatable_text", labelKey: lk("string", "postfix"), placeholder: "m²" },
+    { name: "placeholder", kind: "translatable_text", labelKey: lk("string", "placeholder") },
+];
+const BOOL_FIELDS = [
+    { name: "trueLabel", kind: "translatable_text", labelKey: lk("bool", "trueLabel"), placeholder: "yes" },
+    { name: "falseLabel", kind: "translatable_text", labelKey: lk("bool", "falseLabel"), placeholder: "no" },
+];
+const HEX_COLOR_FIELDS = [
+    { name: "options", kind: "color_options", labelKey: lk("hex_color", "options") },
+    // LN-B15: hex_color's allowCustom defaults FALSE, unlike int/float/string.
+    { name: "allowCustom", kind: "checkbox", labelKey: lk("hex_color", "allowCustom"), default: false },
+];
+const SELECT_FIELDS = [
+    { name: "options", kind: "select_options_with_default", labelKey: lk("select", "options") },
+    {
+        name: "uiStyle",
+        kind: "select",
+        labelKey: lk("select", "uiStyle"),
+        required: true,
+        // B2 canon: the untouched-form default MUST equal the engine dataclass
+        // default (SelectConfig.uiStyle = "dropdown"), so a select saved without
+        // touching this round-trips to what the UI displayed.
+        default: "dropdown",
+        options: [
+            { value: "chips", label: "Chips/Tags" },
+            { value: "checkboxes", label: "Checkboxes (like checklist)" },
+            { value: "dropdown", label: "Dropdown" },
+        ],
+    },
+    { name: "minSelected", kind: "number", labelKey: lk("select", "minSelected"), default: 0, step: 1 },
+    // No default: SelectConfig.maxSelected is None = unlimited, and the widget
+    // shows "Unlimited" for an absent value.
+    { name: "maxSelected", kind: "max_selected_dropdown", labelKey: lk("select", "maxSelected") },
+    { name: "lockUserInput", kind: "checkbox", labelKey: lk("select", "lockUserInput") },
+];
+const DATE_FIELDS = [
+    {
+        name: "precision",
+        kind: "select",
+        labelKey: lk("date", "precision"),
+        required: true,
+        default: "date",
+        options: [
+            { value: "year", label: "Year only" },
+            { value: "month", label: "Month (year + month)" },
+            { value: "date", label: "Date (year + month + day)" },
+            { value: "datetime", label: "Date & Time" },
+        ],
+    },
+    { name: "minDate", kind: "timestamp", labelKey: lk("date", "minDate") },
+    { name: "maxDate", kind: "timestamp", labelKey: lk("date", "maxDate") },
+    { name: "allowFuture", kind: "checkbox", labelKey: lk("date", "allowFuture"), default: true },
+    { name: "allowPast", kind: "checkbox", labelKey: lk("date", "allowPast"), default: true },
+    // Upstream names this field literally "default".
+    { name: "default", kind: "timestamp", labelKey: lk("date", "default") },
+    { name: "options", kind: "timestamp_array", labelKey: lk("date", "options"), unsupported: true },
+    { name: "lockInput", kind: "checkbox", labelKey: lk("date", "lockInput") },
+    { name: "placeholder", kind: "text", labelKey: lk("date", "placeholder") },
+];
+const HEADER_FIELDS = [
+    {
+        name: "style",
+        kind: "select",
+        labelKey: lk("header", "style"),
+        required: true,
+        // LN-B01, preserved deliberately: the upstream default "h2" matches
+        // NEITHER option value. Mirrored rather than "fixed" — silently changing
+        // it here would make the builder disagree with the engine.
+        default: "h2",
+        options: [
+            { value: "l", label: "H1 - Large" },
+            { value: "m", label: "H2 - Medium" },
+        ],
+    },
+];
+/**
+ * Field kind → its config form. A kind ABSENT from this table ships
+ * builder-less (see the module header): `convertible_unit` (no upstream
+ * declaration) and `hierarchical_select` (its only field is a tree editor).
+ */
+export const FIELD_KIND_CONFIG_FORMS = {
+    int: { labelKey: "admin.attributes.type.int", fields: INT_FIELDS },
+    float: { labelKey: "admin.attributes.type.float", fields: FLOAT_FIELDS },
+    string: { labelKey: "admin.attributes.type.string", fields: STRING_FIELDS },
+    bool: { labelKey: "admin.attributes.type.bool", fields: BOOL_FIELDS },
+    hex_color: { labelKey: "admin.attributes.type.hex_color", fields: HEX_COLOR_FIELDS },
+    select: { labelKey: "admin.attributes.type.select", fields: SELECT_FIELDS },
+    date: { labelKey: "admin.attributes.type.date", fields: DATE_FIELDS },
+    header: { labelKey: "admin.attributes.type.header", fields: HEADER_FIELDS },
+};
+/**
+ * The kinds the builder can configure, in offer order. Anything in
+ * `BUILTIN_FIELD_KINDS` but not here is builder-less by the §12 risk-5 rule.
+ */
+export const BUILDER_KINDS = [
+    "string",
+    "int",
+    "float",
+    "bool",
+    "select",
+    "date",
+    "header",
+    "hex_color",
+];
+/** Can `<FormBuilder>` configure this kind? */
+export function isBuilderSupportedKind(kind) {
+    return Object.prototype.hasOwnProperty.call(FIELD_KIND_CONFIG_FORMS, kind);
+}
+/** The kind's config declaration, or `undefined` when it ships builder-less. */
+export function configFormFor(kind) {
+    return FIELD_KIND_CONFIG_FORMS[kind];
+}
+/**
+ * The config defaults a freshly-added field of this kind starts with — every
+ * declared `default`, and nothing else. Keys with no upstream default stay
+ * ABSENT rather than being written as `null`: the engine's dataclass reads an
+ * absent key as "use my own default", and writing one changes behaviour.
+ */
+export function defaultConfigFor(kind) {
+    const form = configFormFor(kind);
+    if (form === undefined)
+        return {};
+    const config = {};
+    for (const field of form.fields) {
+        if (field.default !== undefined)
+            config[field.name] = field.default;
+    }
+    return config;
+}
+//# sourceMappingURL=configForms.js.map

package/dist/widgets/configForms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configForms.js","sourceRoot":"","sources":["../../src/widgets/configForms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AA+DH,SAAS,EAAE,CAAC,IAAY,EAAE,KAAa;IACrC,OAAO,yBAAyB,IAAI,IAAI,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,GAA+B;IAC7C,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;IACpE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;IACpE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE;IAC3E,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;IAC5F,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;IAC9F,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;IACjG,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;IACxG,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE;CACvF,CAAC;AAEF,MAAM,YAAY,GAA+B;IAC/C,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;IACzE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;IACzE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;IAC9F,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE;IAC7E,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;IAC9F,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;IAChG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;IACnG,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;IAC1G,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE;CACzF,CAAC;AAEF,MAAM,aAAa,GAA+B;IAChD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;IACnF,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;IACnF,6EAA6E;IAC7E,0EAA0E;IAC1E,4EAA4E;IAC5E,gDAAgD;IAChD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;IAC5F,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE;IACpE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE;IAC9E,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;IAC/F,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;IACjG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;IACpG,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;CAC1F,CAAC;AAEF,MAAM,WAAW,GAA+B;IAC9C,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE;IACvG,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;CACzG,CAAC;AAEF,MAAM,gBAAgB,GAA+B;IACnD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE;IAChF,2EAA2E;IAC3E,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;CACpG,CAAC;AAEF,MAAM,aAAa,GAA+B;IAChD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,6BAA6B,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE;IAC3F;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QACjC,QAAQ,EAAE,IAAI;QACd,uEAAuE;QACvE,yEAAyE;QACzE,sDAAsD;QACtD,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE;YACvC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,6BAA6B,EAAE;YAC7D,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;SACzC;KACF;IACD,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;IACnG,2EAA2E;IAC3E,yCAAyC;IACzC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,uBAAuB,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;IAC7F,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE;CACrF,CAAC;AAEF,MAAM,WAAW,GAA+B;IAC9C;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;QACjC,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,MAAM;QACf,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE;YACrC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE;YACjD,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,EAAE;YACrD,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE;SAC5C;KACF;IACD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;IACvE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;IACvE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;IAC7F,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;IACzF,iDAAiD;IACjD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;IACvE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;IAChG,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE;IAC1E,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE;CAC3E,CAAC;AAEF,MAAM,aAAa,GAA+B;IAChD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC/B,QAAQ,EAAE,IAAI;QACd,oEAAoE;QACpE,yEAAyE;QACzE,2DAA2D;QAC3D,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE;YACnC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE;SACrC;KACF;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA6C;IAC/E,GAAG,EAAE,EAAE,QAAQ,EAAE,2BAA2B,EAAE,MAAM,EAAE,UAAU,EAAE;IAClE,KAAK,EAAE,EAAE,QAAQ,EAAE,6BAA6B,EAAE,MAAM,EAAE,YAAY,EAAE;IACxE,MAAM,EAAE,EAAE,QAAQ,EAAE,8BAA8B,EAAE,MAAM,EAAE,aAAa,EAAE;IAC3E,IAAI,EAAE,EAAE,QAAQ,EAAE,4BAA4B,EAAE,MAAM,EAAE,WAAW,EAAE;IACrE,SAAS,EAAE,EAAE,QAAQ,EAAE,iCAAiC,EAAE,MAAM,EAAE,gBAAgB,EAAE;IACpF,MAAM,EAAE,EAAE,QAAQ,EAAE,8BAA8B,EAAE,MAAM,EAAE,aAAa,EAAE;IAC3E,IAAI,EAAE,EAAE,QAAQ,EAAE,4BAA4B,EAAE,MAAM,EAAE,WAAW,EAAE;IACrE,MAAM,EAAE,EAAE,QAAQ,EAAE,8BAA8B,EAAE,MAAM,EAAE,aAAa,EAAE;CAC5E,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,QAAQ;IACR,KAAK;IACL,OAAO;IACP,MAAM;IACN,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,WAAW;CACZ,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/widgets/registry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * The field-widget registry — THE customer seam of this pair, and the direct
+ * descendant of docs-react's editor registry.
+ *
+ * A form schema's fields are `stapel_attributes` `FeatureDef`s, and that type
+ * vocabulary is an OPEN registry server-side (builtins →
+ * `STAPEL_ATTRIBUTES["EXTRA_TYPES"]` → runtime `register_feature_type`). A
+ * host that adds a type on the backend must be able to render it on the front
+ * without forking the skin:
+ *
+ * ```tsx
+ * registerFormFieldWidget("signature", SignaturePad); // at startup
+ * ```
+ *
+ * ── Resolution, and what happens when nothing matches ──────────────────────
+ *
+ * This module answers only the FIRST rung: an explicit registration, or
+ * `null`. The `/default` skin completes the ladder — explicit registration >
+ * skin builtin (antd) > **unsupported-field notice** — mirroring
+ * docs-react's `DocSurface`, where an explicit `registerDocEditor` outranks
+ * the skin's own styled default so a host's swap is never shadowed.
+ *
+ * The last rung is a notice, deliberately, and never a skipped field. A
+ * schema can legally contain a kind this build has no widget for; rendering
+ * nothing would silently drop a field that may be REQUIRED, and the person
+ * would submit a form they could not complete and be told, by the server,
+ * that a field they never saw is missing. `<FormFill>` therefore also blocks
+ * the submit with `forms.unsupported_kind` while such a field is present —
+ * degrade loudly (spec §7.2).
+ *
+ * The registry lives in the main entry, not in `/default`, so a host building
+ * its own renderer over `<FormFill>` uses the same seam as the skin does
+ * rather than a parallel one.
+ */
+import type { ComponentType } from "react";
+import type { FlowError } from "@stapel/core";
+import type { FormFieldDef } from "../api/types.js";
+/**
+ * What every field widget receives. One field, one value, one setter, one
+ * error — the widget never touches the API layer or the rest of the form.
+ */
+export interface FormFieldWidgetProps {
+    /** The field's `FeatureDef`. `field.config` carries the kind's camelCase
+     * options (`maxLength`, `minSelected`, `precision`, `multiline`, …). */
+    readonly field: FormFieldDef;
+    /** The current answer, or `undefined` while unanswered. */
+    readonly value: unknown;
+    /** Report a new answer. Pass the bare scalar — `select` normalizes to a
+     * list server-side, so a single choice need not be wrapped. */
+    onChange(value: unknown): void;
+    /** The field's current refusal (client mirror or server verdict), or
+     * `undefined`. */
+    readonly error: FlowError | undefined;
+    /** True while a submit is in flight — widgets should go read-only. */
+    readonly disabled: boolean;
+    /**
+     * DOM id the widget MUST put on its primary control. The skin's field row
+     * points its `<label for>` at this, so the label actually names the input
+     * for a screen reader (and for a click). A widget that drops it renders an
+     * unlabelled control — which antd's `Form.Item` cannot detect and will
+     * happily draw a label beside.
+     */
+    readonly id: string;
+}
+export type FormFieldWidget = ComponentType<FormFieldWidgetProps>;
+/**
+ * Register (or override) the widget for a field kind. Call at startup, before
+ * the first render — the registry is module-global, like the i18n bundle
+ * registration and docs-react's editor registry.
+ */
+export declare function registerFormFieldWidget(kind: string, widget: FormFieldWidget): void;
+/** Remove an explicit registration (the skin's builtin, if any, resolves
+ * again). */
+export declare function unregisterFormFieldWidget(kind: string): void;
+/**
+ * The EXPLICIT registration for a kind, or `null`. Named for what it is: the
+ * skin calls this FIRST and only falls back to its own builtin when it
+ * returns `null`, so a host registration always wins.
+ */
+export declare function resolveFormFieldWidget(kind: string): FormFieldWidget | null;
+/** Every kind with an explicit registration, sorted. */
+export declare function registeredFormFieldKinds(): readonly string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/widgets/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/widgets/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;4EACwE;IACxE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;mEAC+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B;sBACkB;IAClB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAIlE;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACtB,IAAI,CAEN;AAED;aACa;AACb,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAE3E;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,IAAI,SAAS,MAAM,EAAE,CAE5D"}

package/dist/widgets/registry.js

@@ -0,0 +1,27 @@
+const registered = new Map();
+/**
+ * Register (or override) the widget for a field kind. Call at startup, before
+ * the first render — the registry is module-global, like the i18n bundle
+ * registration and docs-react's editor registry.
+ */
+export function registerFormFieldWidget(kind, widget) {
+    registered.set(kind, widget);
+}
+/** Remove an explicit registration (the skin's builtin, if any, resolves
+ * again). */
+export function unregisterFormFieldWidget(kind) {
+    registered.delete(kind);
+}
+/**
+ * The EXPLICIT registration for a kind, or `null`. Named for what it is: the
+ * skin calls this FIRST and only falls back to its own builtin when it
+ * returns `null`, so a host registration always wins.
+ */
+export function resolveFormFieldWidget(kind) {
+    return registered.get(kind) ?? null;
+}
+/** Every kind with an explicit registration, sorted. */
+export function registeredFormFieldKinds() {
+    return [...registered.keys()].sort();
+}
+//# sourceMappingURL=registry.js.map

package/dist/widgets/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/widgets/registry.ts"],"names":[],"mappings":"AAoEA,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,MAAuB;IAEvB,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;aACa;AACb,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACtC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,wBAAwB;IACtC,OAAO,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/dist/widgets/validate.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The client-side validation MIRROR — instant feedback, never a verdict.
+ *
+ * "Client-side validation mirrors, server decides" (spec §7.2). Every rule
+ * here is derived from the schema's own `config` so the person sees a problem
+ * as they type instead of after a round trip; none of it is trusted. The
+ * server re-runs `stapel_attributes.validate_dto_structured` on every submit
+ * and its answer is the one that counts.
+ *
+ * ── Why the mirror emits the SERVER's error keys ───────────────────────────
+ *
+ * Each rule below reports the exact `error.400.feature_*` key
+ * (`stapel_attributes.errors.ERROR_CODE_TO_KEY`) the backend would have
+ * returned for the same input, with the same `{feature}`/`{field}` params. So
+ * a "too long" caught locally and a "too long" caught by the server render
+ * the SAME sentence in the SAME language. The alternative — pair-invented
+ * copy for the local half — gives the person two different wordings for one
+ * problem and makes the local one a lie the moment the backend's rule moves.
+ *
+ * ── camelCase, and the cap that does not exist ─────────────────────────────
+ *
+ * Config keys are camelCase (`maxLength`, not `max_length`) — backend delta
+ * note 1. A type's dataclass parser drops keys it does not know, so a
+ * snake_case typo is a constraint that silently does not exist. `publish`
+ * refuses those server-side; this mirror simply reads the camelCase names and
+ * therefore agrees with the engine by construction.
+ */
+import type { FlowError } from "@stapel/core";
+import type { FormFieldDef } from "../api/types.js";
+/** The `error.400.feature_*` keys this mirror can raise — a subset of
+ * `stapel_attributes.errors.ATTRIBUTES_ERRORS`, listed so the i18n bundle can
+ * be checked against it. */
+export declare const FEATURE_ERROR_CODES: readonly string[];
+/** The declared choice values of an options-bearing config, or `undefined`
+ * when the kind has none. Accepts both the bare-scalar and the
+ * `{value, label}` option shapes the attributes types allow. */
+export declare function optionValues(field: FormFieldDef): readonly unknown[] | undefined;
+/** True when the answer is "nothing was entered" — the one shape the
+ * mandatory rule fires on. An explicit `false` is an ANSWER for a `bool`, not
+ * an absence, which is why this is not a falsiness check. */
+export declare function isBlank(value: unknown): boolean;
+/**
+ * Validate one answer against its field's config. Returns the mirrored
+ * refusal, or `undefined` when this side of the wire is satisfied.
+ *
+ * `header` fields are skipped outright: the engine regenerates a header's DAO
+ * from its config and REJECTS an answer to one (backend delta note 1), so a
+ * header has nothing to validate and must never be given a value.
+ */
+export declare function validateFieldValue(field: FormFieldDef, value: unknown): FlowError | undefined;
+/**
+ * Validate a whole answer set. Returns `{slug: FlowError}` for the fields that
+ * failed — the exact shape `FormFillBag.fieldErrors` carries, so a server
+ * response can be merged into it without a translation step.
+ */
+export declare function validateAnswers(fields: readonly FormFieldDef[], values: Readonly<Record<string, unknown>>): Readonly<Record<string, FlowError>>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/widgets/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/widgets/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;4BAE4B;AAC5B,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAOhD,CAAC;AA8BF;;gEAEgE;AAChE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,GAClB,SAAS,OAAO,EAAE,GAAG,SAAS,CAQhC;AAED;;6DAE6D;AAC7D,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK/C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,OAAO,GACb,SAAS,GAAG,SAAS,CAoGvB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACxC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAOrC"}