@stapel/forms-react 0.1.0

package/dist/flows/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Zero-flow registry shim (slim wave §21/S3). stapel-forms annotates no
+ * `@flow_step` yet — its backend `docs/flows.json` carries no `forms.*`
+ * flows, so `gen:flows` skips emission for this pair (no `flows/generated/`
+ * scaffolding). This hand-written shim preserves the pair's public
+ * flow-registry surface at its zero-flow shape.
+ *
+ * When the backend annotates flows, `pnpm gen:flows` emits
+ * `./generated/flows.gen.ts` again — replace these exports with re-exports
+ * from it (the shapes match by construction) and delete this file.
+ */
+export declare const FORMS_FLOWS: {};
+/** Canonical flow ids present in flows.json (none yet — see above). */
+export type FormsFlowId = keyof typeof FORMS_FLOWS;
+export type FormsFlowSpec = (typeof FORMS_FLOWS)[FormsFlowId];
+export interface FlowEndpoint {
+    readonly method: string;
+    readonly path: string;
+}
+/** All HTTP endpoints a flow touches, in step order (for the contract test / MSW). */
+export declare function flowEndpoints(id: FormsFlowId): readonly FlowEndpoint[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/flows/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,IAAc,CAAC;AAEvC,uEAAuE;AACvE,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,WAAW,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,WAAW,CAAC,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS,YAAY,EAAE,CAOtE"}

package/dist/flows/registry.js

@@ -0,0 +1,20 @@
+/**
+ * Zero-flow registry shim (slim wave §21/S3). stapel-forms annotates no
+ * `@flow_step` yet — its backend `docs/flows.json` carries no `forms.*`
+ * flows, so `gen:flows` skips emission for this pair (no `flows/generated/`
+ * scaffolding). This hand-written shim preserves the pair's public
+ * flow-registry surface at its zero-flow shape.
+ *
+ * When the backend annotates flows, `pnpm gen:flows` emits
+ * `./generated/flows.gen.ts` again — replace these exports with re-exports
+ * from it (the shapes match by construction) and delete this file.
+ */
+export const FORMS_FLOWS = {};
+/** All HTTP endpoints a flow touches, in step order (for the contract test / MSW). */
+export function flowEndpoints(id) {
+    // Same widened body as the generated registry's — valid for the zero-flow
+    // shape AND correct once flows exist.
+    const spec = FORMS_FLOWS[id];
+    return spec ? spec.steps.flatMap((s) => s.endpoints) : [];
+}
+//# sourceMappingURL=registry.js.map

package/dist/flows/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/flows/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,EAAW,CAAC;AAYvC,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,EAAe;IAC3C,0EAA0E;IAC1E,sCAAsC;IACtC,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAEd,CAAC;IACd,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/dist/headless/FormBuilder.d.ts

@@ -0,0 +1,100 @@
+import type { ReactNode } from "react";
+import type { ActionAvailability, LoadState, StapelApiError } from "@stapel/core";
+import type { ConfigFieldSpec, FieldKind, FormFieldDef, FormRow, FormSchemaMeta, FormState } from "../api/types.js";
+/** One row of the builder's field list, with everything the UI needs to draw
+ * and judge it. */
+export interface BuilderField {
+    readonly field: FormFieldDef;
+    /**
+     * The kind's entry in the server's catalogue, or `undefined` when the
+     * catalogue has not loaded yet or does not list this kind at all (a stored
+     * schema can outlive a host's `FIELD_KINDS` allowlist).
+     */
+    readonly kindInfo: FieldKind | undefined;
+    /** The kind's config declaration, straight from
+     * `stapel_attributes.config_form()` via `GET /field-kinds`. Empty for a
+     * builder-less kind. */
+    readonly configFields: readonly ConfigFieldSpec[];
+    /**
+     * True when this field's options cannot be edited here. TWO server signals
+     * feed it, and they are different facts:
+     *
+     *  - `registered: false` — the host allowlisted a kind the attributes
+     *    registry does not carry. The field is still listed, because a stored
+     *    schema may already use it and a builder that dropped the kind would
+     *    silently drop the field.
+     *  - `fields: []` — the kind is registered but declares no config form at
+     *    all (this is how `convertible_unit` arrives).
+     *
+     * Either way the field stays LISTED, reorderable and removable, and stays
+     * authorable through the draft PUT.
+     */
+    readonly builderLess: boolean;
+    /** Config-widget kinds in this field's declaration that the SKIN has no
+     * editor for. Named so the UI can say which options it is not showing rather
+     * than presenting a partial form as a complete one. */
+    readonly unsupportedConfigKeys: readonly string[];
+}
+/** The bag `<FormBuilder>` hands its render prop (spec §8). */
+export interface FormBuilderBag {
+    /** The form row. A failed read is never "no such form" — LoadState law. */
+    readonly state: LoadState<FormRow>;
+    /** The draft under edit: the row's `draft_schema` when there is one, else
+     * the active version's schema as a starting point, else empty. */
+    readonly fields: readonly BuilderField[];
+    readonly meta: FormSchemaMeta;
+    /** True when the local draft differs from what the server holds. */
+    readonly isDirty: boolean;
+    addField(kind: string): void;
+    removeField(slug: string): void;
+    /** Move a field to a new index (drag-reorder, or a pair of arrow buttons —
+     * field ORDER is schema order). */
+    moveField(slug: string, toIndex: number): void;
+    /** Patch a field's own attributes (`slug`, `name`, `mandatory`, …). */
+    updateField(slug: string, patch: Partial<FormFieldDef>): void;
+    /** Set one config key of one field. `undefined` REMOVES the key, which is
+     * not the same as writing `null`: the engine reads an absent key as "use my
+     * own default". */
+    setFieldConfig(slug: string, key: string, value: unknown): void;
+    setMeta(patch: Partial<FormSchemaMeta>): void;
+    /**
+     * The kinds the builder may offer, from the server's catalogue: allowed by
+     * this deployment, carried by the attributes registry, and declaring a
+     * config form. `LoadState` rather than a bare array — a catalogue that
+     * failed to load must not read as "this deployment has no field kinds".
+     */
+    readonly availableKinds: LoadState<readonly FieldKind[]>;
+    /** The config-WIDGET vocabulary (`config_form.FIELD_KINDS`) and the params
+     * each widget understands, for a skin rendering the config rows. */
+    readonly configWidgets: Readonly<Record<string, readonly string[]>>;
+    readonly save: ActionAvailability;
+    doSave(): void;
+    readonly publish: ActionAvailability;
+    doPublish(): void;
+    readonly isSaving: boolean;
+    readonly isPublishing: boolean;
+    setState(next: FormState): void;
+    rotateLink(): void;
+    /** The last refusal from save/publish/state/rotate — a `StapelApiError` so
+     * the skin can branch with `hasErrorCode` (`forms_duplicate_slug` carries
+     * `params.slug`, `forms_invalid_schema` carries `params.key`, …). */
+    readonly error: StapelApiError | null;
+    refetch(): void;
+}
+/**
+ * Headless form builder — the authoring surface, renderless and DATA-DRIVEN.
+ *
+ * There is no per-kind hand-written form anywhere in this component or in the
+ * skin that renders it: a field's options come from `GET /field-kinds`, which
+ * serves `stapel_attributes.config_form()` verbatim. Until stapel-forms 0.2.0
+ * there was no such route and the pair had to mirror those declarations in
+ * TypeScript — a table that drifts silently. Reading the registry makes the
+ * declaration the single source of truth again: a type registered through
+ * `EXTRA_TYPES` shows up here with no client release at all (spec §8).
+ */
+export declare function FormBuilder(props: {
+    workspaceId: string;
+    formId: string;
+    children: (bag: FormBuilderBag) => ReactNode;
+}): ReactNode;
+//# sourceMappingURL=FormBuilder.d.ts.map

package/dist/headless/FormBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormBuilder.d.ts","sourceRoot":"","sources":["../../src/headless/FormBuilder.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,OAAO,KAAK,EACV,kBAAkB,EAClB,SAAS,EACT,cAAc,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,OAAO,EAEP,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAUzB;mBACmB;AACnB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,CAAC;IACzC;;4BAEwB;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IAClD;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;2DAEuD;IACvD,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC;sEACkE;IAClE,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;uCACmC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,uEAAuE;IACvE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9D;;uBAEmB;IACnB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAE9C;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACzD;wEACoE;IACpE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAEpE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,SAAS,IAAI,IAAI,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAE/B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,UAAU,IAAI,IAAI,CAAC;IAEnB;;yEAEqE;IACrE,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,OAAO,IAAI,IAAI,CAAC;CACjB;AA2DD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,SAAS,CAAC;CAC9C,GAAG,SAAS,CAoQZ"}

package/dist/headless/FormBuilder.js

@@ -0,0 +1,278 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { actionAvailable, actionBlocked, isStapelApiError, loadStateFromQuery, mapLoad, requireLoaded, } from "@stapel/core";
+import { useFieldKinds, useForm } from "../model/queries.js";
+import { usePublishForm, useRotateLink, useSaveDraft, useSetFormState, } from "../model/mutations.js";
+import { FORMS_I18N_KEYS } from "../i18n/keys.js";
+/**
+ * The config-WIDGET kinds the `/default` skin can draw (`ConfigField`).
+ *
+ * Upstream's widget vocabulary is 13 entries; the skin implements 11. The two
+ * it does not — `hierarchical_options` (a tree editor) and `timestamp_array` —
+ * make the individual config ROW unrenderable, not the whole kind, so a field
+ * declaring one still gets its other options and the UI names what it is not
+ * showing. Kept here rather than imported from `/default` so the headless bag
+ * can report it without pulling antd into the main bundle.
+ */
+const SKIN_CONFIG_WIDGETS = new Set([
+    "number",
+    "text",
+    "checkbox",
+    "translatable_text",
+    "number_options",
+    "string_options",
+    "color_options",
+    "select",
+    "select_options_with_default",
+    "max_selected_dropdown",
+    "timestamp",
+]);
+/**
+ * The config a freshly-added field starts with: every default the SERVER's
+ * declaration carries, and nothing else.
+ *
+ * Keys with no declared default stay ABSENT rather than written as `null` —
+ * the engine reads an absent key as "use my own default", and writing one
+ * changes stored behaviour.
+ */
+function defaultConfigFor(kind) {
+    const config = {};
+    for (const spec of kind?.fields ?? []) {
+        if (spec.default !== undefined)
+            config[spec.name] = spec.default;
+    }
+    return config;
+}
+/** A slug that does not collide with anything already in the draft. */
+function freeSlug(kind, taken) {
+    const base = kind === "header" ? "heading" : kind;
+    for (let n = 1;; n += 1) {
+        const candidate = `${base}_${n}`;
+        if (!taken.has(candidate))
+            return candidate;
+    }
+}
+/** The draft a form starts from: its own scratchpad if it has one, otherwise
+ * nothing. The ACTIVE version is deliberately not copied in — editing a live
+ * form starts from the draft the admin last saved, and a form with no draft is
+ * a form nobody has started editing. */
+function initialSchema(row) {
+    return row?.draft_schema ?? { fields: [], meta: {} };
+}
+/**
+ * Headless form builder — the authoring surface, renderless and DATA-DRIVEN.
+ *
+ * There is no per-kind hand-written form anywhere in this component or in the
+ * skin that renders it: a field's options come from `GET /field-kinds`, which
+ * serves `stapel_attributes.config_form()` verbatim. Until stapel-forms 0.2.0
+ * there was no such route and the pair had to mirror those declarations in
+ * TypeScript — a table that drifts silently. Reading the registry makes the
+ * declaration the single source of truth again: a type registered through
+ * `EXTRA_TYPES` shows up here with no client release at all (spec §8).
+ */
+export function FormBuilder(props) {
+    const query = useForm(props.workspaceId, props.formId);
+    const state = loadStateFromQuery(query);
+    const row = state.status === "ready" ? state.data : undefined;
+    const kindsQuery = useFieldKinds(props.workspaceId);
+    const kindsState = loadStateFromQuery(kindsQuery);
+    const catalogue = kindsState.status === "ready" ? kindsState.data : undefined;
+    const kindsBySlug = useMemo(() => {
+        const map = new Map();
+        for (const kind of catalogue?.kinds ?? [])
+            map.set(kind.kind, kind);
+        return map;
+    }, [catalogue]);
+    const saveMutation = useSaveDraft();
+    const publishMutation = usePublishForm();
+    const stateMutation = useSetFormState();
+    const rotateMutation = useRotateLink();
+    const [schema, setSchema] = useState(() => initialSchema(row));
+    const [error, setError] = useState(null);
+    // Adopt the server's draft when the form first loads, and after any save —
+    // but never mid-edit, which would throw away what the admin is typing. The
+    // ref tracks WHICH server draft has been adopted, so a background refetch
+    // that returns the same draft is not an adoption event.
+    const adopted = useRef(null);
+    useEffect(() => {
+        if (row === undefined)
+            return;
+        const fingerprint = JSON.stringify(row.draft_schema ?? null);
+        if (adopted.current === fingerprint)
+            return;
+        adopted.current = fingerprint;
+        setSchema(initialSchema(row));
+    }, [row]);
+    const isDirty = useMemo(() => JSON.stringify(schema) !== JSON.stringify(initialSchema(row)), [schema, row]);
+    const fields = useMemo(() => schema.fields.map((field) => {
+        const kindInfo = kindsBySlug.get(field.kind);
+        const configFields = kindInfo?.fields ?? [];
+        return {
+            field,
+            kindInfo,
+            configFields,
+            // Both server signals collapse to one rendering decision here, but
+            // they are reported separately on `kindInfo` so a skin can word them
+            // differently: "this deployment does not know this kind" is not the
+            // same news as "this kind has no options".
+            builderLess: kindInfo === undefined ||
+                kindInfo.registered === false ||
+                configFields.length === 0,
+            unsupportedConfigKeys: configFields
+                .filter((spec) => !SKIN_CONFIG_WIDGETS.has(spec.kind))
+                .map((spec) => spec.name),
+        };
+    }), [schema, kindsBySlug]);
+    const addField = useCallback((kind) => {
+        setSchema((current) => {
+            const taken = new Set(current.fields.map((f) => f.slug));
+            const config = defaultConfigFor(kindsBySlug.get(kind));
+            const field = {
+                slug: freeSlug(kind, taken),
+                kind,
+                name: "",
+                mandatory: false,
+                ...(Object.keys(config).length > 0 ? { config } : {}),
+            };
+            return { ...current, fields: [...current.fields, field] };
+        });
+        setError(null);
+    }, [kindsBySlug]);
+    const removeField = useCallback((slug) => {
+        setSchema((current) => ({
+            ...current,
+            fields: current.fields.filter((f) => f.slug !== slug),
+        }));
+        setError(null);
+    }, []);
+    const moveField = useCallback((slug, toIndex) => {
+        setSchema((current) => {
+            const from = current.fields.findIndex((f) => f.slug === slug);
+            if (from === -1)
+                return current;
+            const moving = current.fields[from];
+            if (moving === undefined)
+                return current;
+            const rest = current.fields.filter((_, index) => index !== from);
+            const clamped = Math.max(0, Math.min(toIndex, rest.length));
+            return {
+                ...current,
+                fields: [...rest.slice(0, clamped), moving, ...rest.slice(clamped)],
+            };
+        });
+        setError(null);
+    }, []);
+    const updateField = useCallback((slug, patch) => {
+        setSchema((current) => ({
+            ...current,
+            fields: current.fields.map((f) => f.slug === slug ? { ...f, ...patch } : f),
+        }));
+        setError(null);
+    }, []);
+    const setFieldConfig = useCallback((slug, key, value) => {
+        setSchema((current) => ({
+            ...current,
+            fields: current.fields.map((f) => {
+                if (f.slug !== slug)
+                    return f;
+                // `undefined` REMOVES the key. An absent config key means "the
+                // engine's own default"; writing null means "this value", and the
+                // two are different stored schemas. Rebuilt by filtering rather
+                // than `delete` (a dynamic delete deoptimizes the object shape).
+                const current = f.config ?? {};
+                const config = Object.fromEntries(Object.entries(current).filter(([existing]) => existing !== key));
+                if (value !== undefined)
+                    config[key] = value;
+                return { ...f, config };
+            }),
+        }));
+        setError(null);
+    }, []);
+    const setMeta = useCallback((patch) => {
+        setSchema((current) => ({ ...current, meta: { ...current.meta, ...patch } }));
+        setError(null);
+    }, []);
+    const isSaving = saveMutation.isPending;
+    const isPublishing = publishMutation.isPending;
+    const save = useMemo(() => requireLoaded(state, () => {
+        if (isSaving)
+            return actionBlocked(FORMS_I18N_KEYS.builderSaving);
+        if (!isDirty)
+            return actionBlocked(FORMS_I18N_KEYS.builderNoChanges);
+        return actionAvailable();
+    }), [state, isSaving, isDirty]);
+    const publish = useMemo(() => requireLoaded(state, () => {
+        if (isPublishing)
+            return actionBlocked(FORMS_I18N_KEYS.builderPublishing);
+        if (schema.fields.length === 0) {
+            return actionBlocked(FORMS_I18N_KEYS.builderEmptySchema);
+        }
+        // Publishing what the server holds, not what is on screen: an unsaved
+        // draft would publish the PREVIOUS text while the admin looks at the
+        // new one. Save first, then publish — two acts, in that order.
+        if (isDirty)
+            return actionBlocked(FORMS_I18N_KEYS.builderUnsavedDraft);
+        return actionAvailable();
+    }), [state, isPublishing, isDirty, schema.fields.length]);
+    const onError = useCallback((caught) => {
+        // See mutations.ts: a fault that is not a StapelApiError has no code to
+        // show, and pretending it does renders `undefined` at the person.
+        setError(isStapelApiError(caught) ? caught : null);
+    }, []);
+    const ref = useMemo(() => ({ workspaceId: props.workspaceId, formId: props.formId }), [props.workspaceId, props.formId]);
+    const doSave = useCallback(() => {
+        if (!save.available)
+            return;
+        setError(null);
+        saveMutation.mutate({ ...ref, schema }, { onError });
+    }, [save, saveMutation, ref, schema, onError]);
+    const doPublish = useCallback(() => {
+        if (!publish.available)
+            return;
+        setError(null);
+        publishMutation.mutate(ref, { onError });
+    }, [publish, publishMutation, ref, onError]);
+    const setFormState = useCallback((next) => {
+        setError(null);
+        stateMutation.mutate({ ...ref, state: next }, { onError });
+    }, [stateMutation, ref, onError]);
+    const rotateLink = useCallback(() => {
+        setError(null);
+        rotateMutation.mutate(ref, { onError });
+    }, [rotateMutation, ref, onError]);
+    const refetch = useCallback(() => {
+        void query.refetch();
+    }, [query]);
+    // Offer only what this deployment can actually build with: allowed by its
+    // FIELD_KINDS setting, carried by the attributes registry, and declaring a
+    // config form. A kind failing any of those is still RENDERABLE and still
+    // authorable through the draft PUT — it is just not something the builder
+    // can hand somebody a button for.
+    const availableKinds = useMemo(() => mapLoad(kindsState, (cat) => cat.kinds.filter((kind) => kind.allowed &&
+        kind.registered &&
+        (kind.fields?.length ?? 0) > 0)), [kindsState]);
+    return props.children({
+        state,
+        fields,
+        meta: schema.meta ?? {},
+        isDirty,
+        addField,
+        removeField,
+        moveField,
+        updateField,
+        setFieldConfig,
+        setMeta,
+        availableKinds,
+        configWidgets: catalogue?.configWidgets ?? {},
+        save,
+        doSave,
+        publish,
+        doPublish,
+        isSaving,
+        isPublishing,
+        setState: setFormState,
+        rotateLink,
+        error,
+        refetch,
+    });
+}
+//# sourceMappingURL=FormBuilder.js.map

package/dist/headless/FormBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormBuilder.js","sourceRoot":"","sources":["../../src/headless/FormBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE1E,OAAO,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,OAAO,EACP,aAAa,GACd,MAAM,cAAc,CAAC;AAetB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAyFlD;;;;;;;;;GASG;AACH,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IACvD,QAAQ;IACR,MAAM;IACN,UAAU;IACV,mBAAmB;IACnB,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,QAAQ;IACR,6BAA6B;IAC7B,uBAAuB;IACvB,WAAW;CACZ,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,SAAS,gBAAgB,CAAC,IAA2B;IACnD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uEAAuE;AACvE,SAAS,QAAQ,CAAC,IAAY,EAAE,KAA0B;IACxD,MAAM,IAAI,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,GAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;;wCAGwC;AACxC,SAAS,aAAa,CAAC,GAAwB;IAC7C,OAAO,GAAG,EAAE,YAAY,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAI3B;IACC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9D,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAC/B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,KAAK,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpE,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,YAAY,GAAG,YAAY,EAAE,CAAC;IACpC,MAAM,eAAe,GAAG,cAAc,EAAE,CAAC;IACzC,MAAM,aAAa,GAAG,eAAe,EAAE,CAAC;IACxC,MAAM,cAAc,GAAG,aAAa,EAAE,CAAC;IAEvC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAa,GAAG,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3E,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAwB,IAAI,CAAC,CAAC;IAEhE,2EAA2E;IAC3E,2EAA2E;IAC3E,0EAA0E;IAC1E,wDAAwD;IACxD,MAAM,OAAO,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAC5C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW;YAAE,OAAO;QAC5C,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC;QAC9B,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EACnE,CAAC,MAAM,EAAE,GAAG,CAAC,CACd,CAAC;IAEF,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,EAAE,CACH,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;QAC5C,OAAO;YACL,KAAK;YACL,QAAQ;YACR,YAAY;YACZ,mEAAmE;YACnE,qEAAqE;YACrE,oEAAoE;YACpE,2CAA2C;YAC3C,WAAW,EACT,QAAQ,KAAK,SAAS;gBACtB,QAAQ,CAAC,UAAU,KAAK,KAAK;gBAC7B,YAAY,CAAC,MAAM,KAAK,CAAC;YAC3B,qBAAqB,EAAE,YAAY;iBAChC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;iBACrD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SAC5B,CAAC;IACJ,CAAC,CAAC,EACJ,CAAC,MAAM,EAAE,WAAW,CAAC,CACtB,CAAC;IAEF,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,IAAY,EAAQ,EAAE;QACrB,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE;YACpB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YACvD,MAAM,KAAK,GAAiB;gBAC1B,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;gBAC3B,IAAI;gBACJ,IAAI,EAAE,EAAE;gBACR,SAAS,EAAE,KAAK;gBAChB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC;YACF,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;QAC5D,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,IAAY,EAAQ,EAAE;QACrD,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtB,GAAG,OAAO;YACV,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;SACtD,CAAC,CAAC,CAAC;QACJ,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,IAAY,EAAE,OAAe,EAAQ,EAAE;QACpE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAC9D,IAAI,IAAI,KAAK,CAAC,CAAC;gBAAE,OAAO,OAAO,CAAC;YAChC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;YACzC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5D,OAAO;gBACL,GAAG,OAAO;gBACV,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;aACpE,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,IAAY,EAAE,KAA4B,EAAQ,EAAE;QACnD,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtB,GAAG,OAAO;YACV,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CACzC;SACF,CAAC,CAAC,CAAC;QACJ,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,IAAY,EAAE,GAAW,EAAE,KAAc,EAAQ,EAAE;QAClD,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACtB,GAAG,OAAO;YACV,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC/B,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI;oBAAE,OAAO,CAAC,CAAC;gBAC9B,+DAA+D;gBAC/D,kEAAkE;gBAClE,gEAAgE;gBAChE,iEAAiE;gBACjE,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAA4B,MAAM,CAAC,WAAW,CACxD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,KAAK,GAAG,CAAC,CACjE,CAAC;gBACF,IAAI,KAAK,KAAK,SAAS;oBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC7C,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;YAC1B,CAAC,CAAC;SACH,CAAC,CAAC,CAAC;QACJ,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,KAA8B,EAAQ,EAAE;QACnE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9E,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,CAAC;IACxC,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC;IAE/C,MAAM,IAAI,GAAuB,OAAO,CACtC,GAAG,EAAE,CACH,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE;QACxB,IAAI,QAAQ;YAAE,OAAO,aAAa,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO;YAAE,OAAO,aAAa,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;QACrE,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC,CAAC,EACJ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAC3B,CAAC;IAEF,MAAM,OAAO,GAAuB,OAAO,CACzC,GAAG,EAAE,CACH,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE;QACxB,IAAI,YAAY;YAAE,OAAO,aAAa,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC1E,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,aAAa,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QACD,sEAAsE;QACtE,qEAAqE;QACrE,+DAA+D;QAC/D,IAAI,OAAO;YAAE,OAAO,aAAa,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;QACvE,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC,CAAC,EACJ,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CACrD,CAAC;IAEF,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,MAAe,EAAQ,EAAE;QACpD,wEAAwE;QACxE,kEAAkE;QAClE,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,GAAG,GAAG,OAAO,CACjB,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,EAChE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAClC,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAS,EAAE;QACpC,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,YAAY,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAS,EAAE;QACvC,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,OAAO;QAC/B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7C,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAe,EAAQ,EAAE;QACxB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC,EACD,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,CAC9B,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAAC,GAAS,EAAE;QACxC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAS,EAAE;QACrC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,0EAA0E;IAC1E,kCAAkC;IAClC,MAAM,cAAc,GAAoC,OAAO,CAC7D,GAAG,EAAE,CACH,OAAO,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAC1B,GAAG,CAAC,KAAK,CAAC,MAAM,CACd,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,UAAU;QACf,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CACjC,CACF,EACH,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,KAAK;QACL,MAAM;QACN,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QACvB,OAAO;QACP,QAAQ;QACR,WAAW;QACX,SAAS;QACT,WAAW;QACX,cAAc;QACd,OAAO;QACP,cAAc;QACd,aAAa,EAAE,SAAS,EAAE,aAAa,IAAI,EAAE;QAC7C,IAAI;QACJ,MAAM;QACN,OAAO;QACP,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,QAAQ,EAAE,YAAY;QACtB,UAAU;QACV,KAAK;QACL,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/headless/FormFill.d.ts

@@ -0,0 +1,88 @@
+import type { ReactNode } from "react";
+import type { ActionAvailability, FlowError, LoadState, StapelApiError } from "@stapel/core";
+import type { PublicForm } from "../api/types.js";
+/** The bag `<FormFill>` hands its render prop (spec §7.2). */
+export interface FormFillBag {
+    /**
+     * The schema read as a state a skin cannot flatten. A failed fetch renders
+     * the `failed` arm — NEVER an empty or missing form. Distinguish the
+     * verdicts from the outage with
+     * `hasErrorCode(error, "error.404.forms_not_found")` /
+     * `"error.410.forms_closed"`; anything else (network, 5xx) is "we could not
+     * ask", which is a different sentence from "there is no form here".
+     */
+    readonly state: LoadState<PublicForm>;
+    /** Current answers, keyed by slug. */
+    readonly values: Readonly<Record<string, unknown>>;
+    setValue(slug: string, value: unknown): void;
+    /**
+     * Per-field refusals, keyed by slug — the client mirror and the server's
+     * verdicts in one map. A server `error.400.feature_*` is routed here by its
+     * `params.field`; a multi-field refusal arrives in `params.fields[]` and
+     * every entry lands.
+     */
+    readonly fieldErrors: Readonly<Record<string, FlowError>>;
+    /** Why the submit button is off, when it is. */
+    readonly submit: ActionAvailability;
+    doSubmit(): void;
+    readonly isSubmitting: boolean;
+    /** Set once the server accepted the answers. */
+    readonly submitted: {
+        readonly confirmation: string;
+    } | null;
+    /** Whole-form failures (410 closed, 429 throttled, 413 too large, the
+     * submission cap). A `StapelApiError` rather than a `FlowError` so a skin
+     * can branch with `hasErrorCode` (which reads the API dialects, not the
+     * render dialect). */
+    readonly formError: StapelApiError | null;
+    /**
+     * True after a `409 forms_version_superseded`: the schema was refetched and
+     * compatible answers were preserved. The skin must say so — "the form
+     * changed, please review and resubmit" — because silently swapping the
+     * fields under a person and asking them to press submit again is how a
+     * wrong answer gets recorded.
+     */
+    readonly superseded: boolean;
+    /**
+     * Field kinds in this schema that nothing can render (no host registration,
+     * no builtin widget). Non-empty means {@link submit} is blocked: silently
+     * skipping a possibly-REQUIRED field would fabricate an invalid submission
+     * and let the server refuse a field the person never saw.
+     */
+    readonly unsupportedKinds: readonly string[];
+    /**
+     * The captcha seam (spec §12 risk 3). The netintel tier decides whether a
+     * token is required at all, so this stays optional and the captcha layer
+     * refuses on its own terms; the pair only transports it. Wire it the way
+     * auth-react's OTP flow does — the widget hands a token, the bag puts it in
+     * the submit body.
+     */
+    setCaptchaToken(token: string | null): void;
+    readonly captchaToken: string | null;
+    refetch(): void;
+}
+/**
+ * Headless form fill — the anonymous respondent's whole surface, renderless.
+ *
+ * ```tsx
+ * <FormFill publicId="k3J…x9">
+ *   {(bag) => matchLoad(bag.state, { loading, failed, ready })}
+ * </FormFill>
+ * ```
+ *
+ * The `/default` skin's `<StapelForm>` is one renderer over this bag; a host
+ * that wants its own visuals writes another and loses nothing.
+ */
+export declare function FormFill(props: {
+    publicId: string;
+    /** Kinds the CALLER can draw, beyond anything in the widget registry. The
+     * `/default` skin passes its antd builtins here, which is what lets this
+     * headless component judge `unsupportedKinds` without importing the skin. */
+    builtinKinds?: readonly string[];
+    /** Called once the server accepts the answers. */
+    onSubmitted?: (result: {
+        readonly confirmation: string;
+    }) => void;
+    children: (bag: FormFillBag) => ReactNode;
+}): ReactNode;
+//# sourceMappingURL=FormFill.d.ts.map

package/dist/headless/FormFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFill.d.ts","sourceRoot":"","sources":["../../src/headless/FormFill.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,OAAO,KAAK,EACV,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,cAAc,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAWhE,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IACtC,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1D,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,IAAI,IAAI,CAAC;IACjB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7D;;;0BAGsB;IACtB,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;CACjB;AAoGD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB;;iFAE6E;IAC7E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,kDAAkD;IAClD,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClE,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,SAAS,CAAC;CAC3C,GAAG,SAAS,CA8LZ"}