@adoptai/genui-components 0.1.65 → 0.1.66

package/dist/builders/BlockForm.d.ts

@@ -0,0 +1,35 @@
+import type { BuilderPayload } from "./schemas";
+import type { BuilderState } from "./hooks";
+import type { FileUploadResult, EntitySearch, EntityCreate } from "./fields";
+import type { FieldSuggestion } from "./BuilderForm";
+/** Single-block builder presentation. Two cosmetic variants of the SAME form:
+ *  - "escalation": compact, accent left-rail, no title (the host/dock owns it),
+ *    outlined "Continue" CTA, no in-card cancel. A high-urgency interruption
+ *    that lifts into the dock.
+ *  - "form": a standalone card with border + shadow, serif title, filled
+ *    "Submit" CTA, and a Cancel button. Structured intake.
+ *  Behaviour (fields, validation, context, recap) is identical; only chrome,
+ *  default labels, title and cancel differ. Multi-block flows use StepperBuilder. */
+export type BlockFormVariant = "escalation" | "form";
+export interface BlockFormProps {
+    builder: BuilderPayload;
+    state: BuilderState;
+    onSubmit: () => void;
+    onCancel?: () => void;
+    disabled?: boolean;
+    onFileUpload?: (file: File) => Promise<FileUploadResult>;
+    onEntitySearch?: EntitySearch;
+    onEntityCreate?: EntityCreate;
+    /** When true, omit the built-in action button(s) — the host (e.g. a sticky
+     *  dock footer) renders the CTA and drives submit via `submitRef`. */
+    hideActions?: boolean;
+    /** Compact presentation for tight containers (the docked action tray). */
+    dense?: boolean;
+    /** Cosmetic variant. Defaults to "form". */
+    variant?: BlockFormVariant;
+    /** Agent-proposed values rendered as Apply chips under matching fields. */
+    fieldSuggestions?: FieldSuggestion[];
+    onApplySuggestion?: (suggestion: FieldSuggestion) => void;
+}
+export declare function BlockForm({ builder, state, onSubmit, onCancel, disabled, onFileUpload, onEntitySearch, onEntityCreate, hideActions, dense, variant, fieldSuggestions, onApplySuggestion, }: BlockFormProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=BlockForm.d.ts.map

package/dist/builders/BlockForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockForm.d.ts","sourceRoot":"","sources":["../../src/builders/BlockForm.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;qFAOqF;AACrF,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzD,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B;0EACsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;CAC3D;AAED,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACX,KAAK,EACL,OAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,EAAE,cAAc,kDAyJhB"}

package/dist/builders/BuilderForm.d.ts

@@ -0,0 +1,76 @@
+import React from "react";
+import type { ValidationFailure } from "./hooks";
+import type { BuilderBlock, BuilderPayload } from "./schemas";
+import type { FileUploadResult, EntitySearch, EntityCreate } from "./fields";
+/** Per-block answers. `blocks` is the authoritative shape (one entry per block,
+ * so reused field names across blocks never collide). `values` is a flat
+ * convenience copy of the single block's answers when there's exactly one block
+ * (back-compat for form/escalation consumers). */
+export interface BuilderSubmission {
+    builder_id: string;
+    builder_kind: "form" | "stepper" | "escalation";
+    blocks: Array<{
+        id: string;
+        title: string;
+        values: Record<string, unknown>;
+    }>;
+    values?: Record<string, unknown>;
+}
+/** An agent-proposed value for one field (e.g. surfaced from an escalation
+ * discussion thread). Rendered as a "Suggested: X — Apply" chip under the
+ * matching field; Apply writes the value into the draft, where the user can
+ * still edit it freely before submitting. */
+export interface FieldSuggestion {
+    /** Field name the suggestion targets. */
+    field: string;
+    /** Block id when the builder has several; defaults to the first block. */
+    block_id?: string;
+    value: unknown;
+    /** Display override for the value (e.g. "$6.69M" for 6692000). */
+    label?: string;
+    /** Short provenance note, e.g. "verified against sheet 4 · D47". */
+    note?: string;
+}
+export interface BuilderFormProps {
+    builder: BuilderPayload;
+    onSubmit: (submission: BuilderSubmission) => void;
+    onCancel?: () => void;
+    disabled?: boolean;
+    onFileUpload?: (file: File) => Promise<FileUploadResult>;
+    /** Search/create handlers for `entity_picker` fields (host-injected). */
+    onEntitySearch?: EntitySearch;
+    onEntityCreate?: EntityCreate;
+    /** Fired on every field edit with the current (UNVALIDATED) draft, so a host
+     *  chrome — e.g. a docked panel — can show live progress (filled groups,
+     *  file count) without owning the form state. */
+    onChange?: (draft: BuilderSubmission) => void;
+    /** When provided, the resolver assigns its submit trigger to
+     *  `submitRef.current` so an external footer (the dock) can submit the form
+     *  while the fields scroll. Cleared on unmount. */
+    submitRef?: React.MutableRefObject<(() => void) | null>;
+    /** Hide the builder's OWN action button(s) — the host renders them (e.g. a
+     *  sticky dock footer). Only honoured by the escalation presentation. */
+    hideActions?: boolean;
+    /** Compact presentation for tight containers (the docked action tray) —
+     *  forwarded to the escalation presentation. */
+    dense?: boolean;
+    /** Fired when a submit attempt is blocked by required-field validation, with
+     *  the failing fields. Lets the host (dock) scroll to + focus the offending
+     *  field and show a summary instead of the submit silently doing nothing. */
+    onValidationError?: (failure: ValidationFailure) => void;
+    /** Agent-proposed field values (see {@link FieldSuggestion}). Honoured by
+     *  the form/escalation presentations; a suggestion whose field/block doesn't
+     *  exist is silently ignored. */
+    fieldSuggestions?: FieldSuggestion[];
+    /** Fired when the user applies a suggestion (after the draft is updated). */
+    onApplySuggestion?: (suggestion: FieldSuggestion) => void;
+    /** Fired with the ACTIVE block on mount and on every step navigation
+     *  (stepper Back/Next; form/escalation fire once for their single block).
+     *  Lets a host react to the block in focus — e.g. dispatch the block's
+     *  `document_target` so its Files panel highlights that field's bounding
+     *  box on the PDF. Not fired again after unmount (post-submit recap is
+     *  host-rendered). */
+    onBlockChange?: (block: BuilderBlock, index: number) => void;
+}
+export declare function BuilderFormResolver({ builder, onSubmit, onCancel, disabled, onFileUpload, onEntitySearch, onEntityCreate, onChange, submitRef, hideActions, dense, onValidationError, fieldSuggestions, onApplySuggestion, onBlockChange, }: BuilderFormProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BuilderForm.d.ts.map

package/dist/builders/BuilderForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuilderForm.d.ts","sourceRoot":"","sources":["../../src/builders/BuilderForm.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAI9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7E;;;kDAGkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;IAChD,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;6CAG6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzD,yEAAyE;IACzE,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B;;qDAEiD;IACjD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C;;uDAEmD;IACnD,SAAS,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxD;6EACyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;oDACgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;iFAE6E;IAC7E,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACzD;;qCAEiC;IACjC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1D;;;;;0BAKsB;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D;AAED,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,cAAc,EACd,QAAQ,EACR,SAAS,EACT,WAAW,EACX,KAAK,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,GACd,EAAE,gBAAgB,2CA2IlB"}

package/dist/builders/BuilderRecap.d.ts

@@ -0,0 +1,12 @@
+import type { BuilderPayload } from "./schemas";
+import type { BuilderState } from "./hooks";
+export interface BuilderRecapProps {
+    builder: BuilderPayload;
+    state: BuilderState;
+}
+/** Read-only recap shown after a builder is submitted (the `disabled` state).
+ * Replaces the useless flat "Decision: Accept" x16 echo with a scannable
+ * counts bar + per-block decision pills. Scales to large steppers (bounded +
+ * scroll). Tokens only. */
+export declare function BuilderRecap({ builder, state }: BuilderRecapProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BuilderRecap.d.ts.map

package/dist/builders/BuilderRecap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuilderRecap.d.ts","sourceRoot":"","sources":["../../src/builders/BuilderRecap.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAA8B,MAAM,WAAW,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;2BAG2B;AAC3B,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,iBAAiB,2CAiIjE"}

package/dist/builders/ContextSlot.d.ts

@@ -0,0 +1,12 @@
+interface ContextSlotProps {
+    payload: Record<string, unknown>;
+}
+/** Read-only composite embedded above a builder's fields (e.g. the data under
+ * review at a gated step). Unlike standalone `render_ui`, this payload is NOT
+ * validated server-side — the agent hand-authors it and often under-specifies
+ * nested fields. So validate against the composite's Zod schema here: on success
+ * render the parsed (defaults-filled) payload; on failure show a neutral note
+ * instead of silently blanking, so the gap is visible rather than mysterious. */
+export declare function ContextSlot({ payload }: ContextSlotProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=ContextSlot.d.ts.map

package/dist/builders/ContextSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextSlot.d.ts","sourceRoot":"","sources":["../../src/builders/ContextSlot.tsx"],"names":[],"mappings":"AAOA,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AA6BD;;;;;iFAKiF;AACjF,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,gBAAgB,kDAkCxD"}

package/dist/builders/FieldRenderer.d.ts

@@ -0,0 +1,19 @@
+import type { FileUploadResult, EntitySearch, EntityCreate } from "./fields";
+import type { BuilderField } from "./schemas";
+export interface FieldRendererProps {
+    field: BuilderField;
+    value: unknown;
+    onChange: (v: unknown) => void;
+    disabled?: boolean;
+    error?: string;
+    onFileUpload?: (file: File) => Promise<FileUploadResult>;
+    /** Search/create handlers for `entity_picker` fields (host-injected). */
+    onEntitySearch?: EntitySearch;
+    onEntityCreate?: EntityCreate;
+    /** Compact presentation for tight containers — forwarded to the field. In
+     *  dense mode the per-field description is dropped (the field label carries
+     *  it) to save vertical space. */
+    dense?: boolean;
+}
+export declare function FieldRenderer({ field, value, onChange, disabled, error, onFileUpload, onEntitySearch, onEntityCreate, dense }: FieldRendererProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FieldRenderer.d.ts.map

package/dist/builders/FieldRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldRenderer.d.ts","sourceRoot":"","sources":["../../src/builders/FieldRenderer.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzD,yEAAyE;IACzE,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B;;sCAEkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,kBAAkB,2CA4BjJ"}

package/dist/builders/StepperBuilder.d.ts

@@ -0,0 +1,27 @@
+import type { BuilderPayload } from "./schemas";
+import type { BuilderState } from "./hooks";
+import type { FileUploadResult, EntitySearch, EntityCreate } from "./fields";
+export interface StepperBuilderProps {
+    builder: BuilderPayload;
+    state: BuilderState;
+    onSubmit: () => void;
+    onCancel?: () => void;
+    disabled?: boolean;
+    onFileUpload?: (file: File) => Promise<FileUploadResult>;
+    onEntitySearch?: EntitySearch;
+    onEntityCreate?: EntityCreate;
+    /** Compact, bare presentation for a host tray (the docked composer): drop
+     *  the outer card chrome + height cap and fill the host height, so the TRAY
+     *  bounds it. The pinned header (progress) + footer nav are kept — a stepper
+     *  always needs its own Back/Next/Submit. */
+    dense?: boolean;
+}
+/**
+ * Multi-step builder. Scales to large step counts (e.g. a 13-item HITL review):
+ * a single progress track + "Step N of M" header replaces the old all-dots
+ * rail (which overflowed horizontally), the step body is height-bounded and
+ * scrolls (tall context tables + fields no longer overflow the card), and the
+ * header + footer nav stay pinned so navigation is always reachable.
+ */
+export declare function StepperBuilder({ builder, state, onSubmit, onCancel, disabled, onFileUpload, onEntitySearch, onEntityCreate, dense }: StepperBuilderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=StepperBuilder.d.ts.map

package/dist/builders/StepperBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepperBuilder.d.ts","sourceRoot":"","sources":["../../src/builders/StepperBuilder.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzD,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B;;;iDAG6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,mBAAmB,2CAsHxJ"}

package/dist/builders/fields.d.ts

@@ -0,0 +1,52 @@
+import React from "react";
+import type { BuilderField, EntityOption } from "./schemas";
+export type FileUploadResult = {
+    object_key: string;
+    filename: string;
+    content_type: string;
+    size: number;
+    upload_id: string;
+};
+/** Host-injected search for an `entity_picker` field. `source` is the field's
+ * allowlist key (e.g. "workstreams"); the host maps it to a real authed query
+ * and returns candidate rows. Throwing surfaces an inline error + retry. */
+export type EntitySearch = (source: string, query: string) => Promise<EntityOption[]>;
+/** Host-injected create for an `entity_picker` field. Returns the new record as
+ * an option so the picker can select it. Reject (e.g. 403 for non-admins) to
+ * surface the error inline. */
+export type EntityCreate = (source: string, values: Record<string, unknown>) => Promise<EntityOption>;
+export interface FieldProps {
+    field: BuilderField;
+    value: unknown;
+    onChange: (v: unknown) => void;
+    disabled?: boolean;
+    onFileUpload?: (file: File) => Promise<FileUploadResult>;
+    /** Search callback for `entity_picker` fields (host-injected). */
+    onEntitySearch?: EntitySearch;
+    /** Create callback for `entity_picker` fields (host-injected). */
+    onEntityCreate?: EntityCreate;
+    error?: string;
+    /** Compact presentation for tight containers (e.g. the docked action tray):
+     *  the empty file dropzone collapses to a single slim row instead of a tall
+     *  centered card. Honored by FileUploadField; inert for other fields. */
+    dense?: boolean;
+}
+export declare function TextField({ field, value, onChange, disabled, error }: FieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function TextAreaField({ field, value, onChange, disabled, error }: FieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function NumberField({ field, value, onChange, disabled, error }: FieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function SelectField({ field, value, onChange, disabled, error }: FieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function MultiSelectField({ field, value, onChange, disabled }: FieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function DateField({ field, value, onChange, disabled, error }: FieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function CheckboxField({ field, value, onChange, disabled }: FieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function FileUploadField({ field, value, onChange, disabled, onFileUpload, error, dense }: FieldProps): import("react/jsx-runtime").JSX.Element;
+/** Server-backed search-as-you-type combobox. Queries an allowlisted `source`
+ * via host-injected `onEntitySearch`; selecting sets the field value to the
+ * chosen option's `value` (e.g. a workstream id). With `allow_create`, a pinned
+ * "Create new" row opens an inline sub-form wired to `onEntityCreate`. */
+export declare function EntityPickerField({ field, value, onChange, disabled, error, onEntitySearch, onEntityCreate }: FieldProps): import("react/jsx-runtime").JSX.Element;
+/** Assign files to role categories — grouped cards + inline Move. Self-contained:
+ * candidate files + AI suggestions ride `field.file_map` (no host callback).
+ * Submits `{category_id: [path], "unassigned": [path]}`. */
+export declare function FileMapField({ field, value, onChange, disabled }: FieldProps): import("react/jsx-runtime").JSX.Element;
+export declare const FIELD_REGISTRY: Record<string, React.ComponentType<FieldProps>>;
+//# sourceMappingURL=fields.d.ts.map

package/dist/builders/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/builders/fields.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAoC,MAAM,WAAW,CAAC;AAsB9F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;4EAE4E;AAC5E,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;AACtF;;+BAE+B;AAC/B,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEtG,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzD,kEAAkE;IAClE,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,kEAAkE;IAClE,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;6EAEyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,UAAU,2CAYhF;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,UAAU,2CAYpF;AAED,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,UAAU,2CAiBlF;AAED,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,UAAU,2CAgBlF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,UAAU,2CAuDhF;AAED,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,UAAU,2CAWhF;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,UAAU,2CAO7E;AAqDD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,UAAU,2CAoI3G;AAgBD;;;0EAG0E;AAC1E,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,EAAE,UAAU,2CA+PxH;AAYD;;4DAE4D;AAC5D,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,UAAU,2CAmL5E;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAW1E,CAAC"}

package/dist/builders/hooks.d.ts

@@ -0,0 +1,39 @@
+import type { BuilderBlock } from "./schemas";
+/** Composite state key. Field values are namespaced by block id so the SAME
+ * field name reused across blocks (e.g. a `decision` select on every step of a
+ * 16-exception HITL stepper) does NOT collide into one shared value. Null-byte
+ * separator can't appear in ids/names. */
+export declare function fieldKey(blockId: string, name: string): string;
+/** A required field that failed validation, with enough info for the host to
+ * scroll to + focus it (`fieldKey`) and jump to its step (`blockIndex`). */
+export interface ValidationFailure {
+    /** Composite `fieldKey(blockId, name)` of the first failing field. */
+    firstKey: string | null;
+    /** Block id of the first failing field. */
+    firstBlockId: string | null;
+    /** Field name of the first failing field. */
+    firstName: string | null;
+    /** Block index of the first failing field (for stepper navigation). */
+    firstBlockIndex: number;
+    /** All failing composite keys. */
+    failingKeys: string[];
+}
+export interface BuilderState {
+    /** Composite-keyed (`fieldKey(blockId, name)`) value map. */
+    values: Record<string, unknown>;
+    /** Composite-keyed error map. */
+    errors: Record<string, string>;
+    getValue: (blockId: string, name: string) => unknown;
+    getError: (blockId: string, name: string) => string | undefined;
+    setFieldValue: (blockId: string, name: string, value: unknown) => void;
+    validateBlock: (blockIdx: number) => boolean;
+    validateAll: () => boolean;
+    /** Like `validateAll` but returns the failing fields so the host can give
+     *  feedback (scroll/focus/summary) instead of a silent no-op. */
+    validateAllDetailed: () => ValidationFailure;
+    currentBlock: number;
+    setCurrentBlock: (idx: number) => void;
+    isMultiBlock: boolean;
+}
+export declare function useBuilderState(blocks: BuilderBlock[]): BuilderState;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/builders/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/builders/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C;;;0CAG0C;AAC1C,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;4EAC4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAChE,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B;qEACiE;IACjE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,YAAY,EAAE,OAAO,CAAC;CACvB;AAkBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CA6HpE"}

package/dist/builders/index.d.ts

@@ -0,0 +1,20 @@
+export { builderSchema, builderBlockSchema, builderDocumentTargetSchema, builderFieldSchema, builderFieldOptionSchema, builderFieldValidationSchema, entityOptionSchema, entityCreateFieldSchema, fileMapConfigSchema, fileMapCategorySchema, fileMapFileSchema, BUILDER_FIELD_TYPES, } from "./schemas";
+export type { BuilderPayload, BuilderBlock, BuilderDocumentTarget, BuilderField, BuilderFieldType, BuilderFieldOption, EntityOption, EntityCreateField, FileMapConfig, FileMapCategory, FileMapFile, FileMapValue, } from "./schemas";
+export { validateBuilderPayload } from "./validateBuilder";
+export { BuilderFormResolver } from "./BuilderForm";
+export type { BuilderFormProps, BuilderSubmission, FieldSuggestion } from "./BuilderForm";
+export { BuilderRecap } from "./BuilderRecap";
+export type { BuilderRecapProps } from "./BuilderRecap";
+export { BlockForm } from "./BlockForm";
+export type { BlockFormProps, BlockFormVariant } from "./BlockForm";
+export { StepperBuilder } from "./StepperBuilder";
+export { resolveBuilder } from "./resolver";
+export type { ResolveBuilderCallbacks } from "./resolver";
+export { FieldRenderer } from "./FieldRenderer";
+export type { FieldRendererProps } from "./FieldRenderer";
+export { ContextSlot } from "./ContextSlot";
+export { FIELD_REGISTRY } from "./fields";
+export type { FieldProps, FileUploadResult, EntitySearch, EntityCreate } from "./fields";
+export { useBuilderState } from "./hooks";
+export type { BuilderState } from "./hooks";
+//# sourceMappingURL=index.d.ts.map

package/dist/builders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builders/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/builders/resolver.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+import type { BuilderSubmission } from "./BuilderForm";
+import type { BuilderPayload } from "./schemas";
+import type { FileUploadResult, EntitySearch, EntityCreate } from "./fields";
+export interface ResolveBuilderCallbacks {
+    onSubmit: (submission: BuilderSubmission) => void;
+    onCancel?: () => void;
+    disabled?: boolean;
+    /** Upload handler for `file_upload` fields. */
+    onFileUpload?: (file: File) => Promise<FileUploadResult>;
+    /** Search/create handlers for `entity_picker` fields. */
+    onEntitySearch?: EntitySearch;
+    onEntityCreate?: EntityCreate;
+    /** Live (unvalidated) draft on every edit — for host chrome (e.g. progress). */
+    onChange?: (draft: BuilderSubmission) => void;
+    /** Receives the submit trigger so an external footer can drive submit. */
+    submitRef?: React.MutableRefObject<(() => void) | null>;
+    /** Hide the builder's own action buttons (host renders them). */
+    hideActions?: boolean;
+    /** Compact/bare presentation for a tight host container. */
+    dense?: boolean;
+}
+export declare function resolveBuilder(payload: BuilderPayload, callbacks: ResolveBuilderCallbacks): React.ReactElement;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/builders/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/builders/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzD,yDAAyD;IACzD,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C,0EAA0E;IAC1E,SAAS,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxD,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,uBAAuB,GACjC,KAAK,CAAC,YAAY,CAKpB"}