mlform 0.1.8 → 0.1.10

package/dist/types/{src/kit → kit}/layout-helpers.d.ts

@@ -1,29 +1,25 @@
-import { ExplanationController, FieldController, ReportController } from '../../runtime';
+import { FieldController, ReportController } from '../runtime';
 import { FormLayoutNode } from './types';
 export type LayoutReferenceMaps = {
     fieldStepIds: Map<string, string>;
     reportStepIds: Map<string, string>;
-    explanationStepIds: Map<string, string>;
     fieldTabIds: Map<string, string>;
     reportTabIds: Map<string, string>;
-    explanationTabIds: Map<string, string>;
+    fieldSectionIds: Map<string, string>;
+    reportSectionIds: Map<string, string>;
     fieldIdsInLayout: Set<string>;
     reportIdsInLayout: Set<string>;
-    explanationIdsInLayout: Set<string>;
 };
 export type EntityMaps = {
     fieldIds: Set<string>;
     reportIds: Set<string>;
-    explanationIds: Set<string>;
 };
-export declare const createEntityMaps: (fields: readonly FieldController[], reports: readonly ReportController[], explanations: readonly ExplanationController[]) => EntityMaps;
+export declare const createEntityMaps: (fields: readonly FieldController[], reports: readonly ReportController[]) => EntityMaps;
 export declare const createReferenceMaps: () => LayoutReferenceMaps;
 export declare const nextNodeId: (prefix: string, preferred: string | undefined, counts: Map<string, number>) => string;
 export declare const assertKnownField: (fieldId: string, entities: EntityMaps) => void;
 export declare const assertKnownReport: (reportId: string, entities: EntityMaps) => void;
-export declare const assertKnownExplanation: (explanationId: string, entities: EntityMaps) => void;
-export declare const markField: (fieldId: string, maps: LayoutReferenceMaps, stepId: string | null, tabId: string | null) => void;
-export declare const markReport: (reportId: string, maps: LayoutReferenceMaps, stepId: string | null, tabId: string | null) => void;
-export declare const markExplanation: (explanationId: string, maps: LayoutReferenceMaps, stepId: string | null, tabId: string | null) => void;
-export declare const createDefaultSinglePageNodes: (fields: readonly FieldController[], explanations: readonly ExplanationController[], reports: readonly ReportController[]) => FormLayoutNode[];
+export declare const markField: (fieldId: string, maps: LayoutReferenceMaps, stepId: string | null, tabId: string | null, sectionId: string | null) => void;
+export declare const markReport: (reportId: string, maps: LayoutReferenceMaps, stepId: string | null, tabId: string | null, sectionId: string | null) => void;
+export declare const createDefaultSinglePageNodes: (fields: readonly FieldController[], reports: readonly ReportController[]) => FormLayoutNode[];
 export declare const assertAllFieldsCovered: (fields: readonly FieldController[], maps: LayoutReferenceMaps) => void;

package/dist/types/kit/layout-node-render.d.ts

@@ -0,0 +1,18 @@
+import { nothing, TemplateResult } from 'lit';
+import { PrimitiveRegistry, PrimitiveText } from '../primitives';
+import { FormViewController, FormViewSnapshot, ResolvedFormLayoutNode } from './types';
+type RenderLayoutNodeOptions = {
+    node: ResolvedFormLayoutNode;
+    view?: FormViewController;
+    snapshot: FormViewSnapshot;
+    registry: PrimitiveRegistry | undefined;
+    primitiveText?: PrimitiveText;
+    sectionClass: string;
+    sectionCopyClass: string;
+    sectionTitleClass: string;
+    sectionDescriptionClass: string;
+    childrenClass: string;
+    groupBaseClass: string;
+};
+export declare const renderLayoutNode: ({ node, view, snapshot, registry, primitiveText, sectionClass, sectionCopyClass, sectionTitleClass, sectionDescriptionClass, childrenClass, groupBaseClass, }: RenderLayoutNodeOptions) => TemplateResult | typeof nothing;
+export {};

package/dist/types/{src/kit → kit}/layout-node-resolver.d.ts

@@ -1,3 +1,3 @@
 import { FormLayoutNode, ResolvedFormLayoutNode } from './types';
 import { EntityMaps, LayoutReferenceMaps } from './layout-helpers';
-export declare const resolveNodes: (nodes: FormLayoutNode[], entities: EntityMaps, maps: LayoutReferenceMaps, nodeIds: Map<string, number>, stepId: string | null, tabId: string | null) => ResolvedFormLayoutNode[];
+export declare const resolveNodes: (nodes: FormLayoutNode[], entities: EntityMaps, maps: LayoutReferenceMaps, nodeIds: Map<string, number>, stepId: string | null, tabId: string | null, sectionId: string | null) => ResolvedFormLayoutNode[];

package/dist/types/{src/kit/accordion-root.d.ts → kit/layout-root.d.ts}

@@ -1,9 +1,8 @@
 import { LitElement } from 'lit';
-import { PrimitiveText } from '../../primitives/constants';
-import { PrimitiveRegistry } from '../../primitives/types';
+import { PrimitiveRegistry, PrimitiveText } from '../primitives';
 import { kitTagNames } from './constants';
 import { FormViewController } from './types';
-export declare class KitAccordionElement extends LitElement {
+export declare class KitSinglePageElement extends LitElement {
     #private;
     static styles: import('lit').CSSResult;
     accessor view: FormViewController | undefined;
@@ -19,6 +18,6 @@ export declare class KitAccordionElement extends LitElement {
 }
 declare global {
     interface HTMLElementTagNameMap {
-        [kitTagNames.accordion]: KitAccordionElement;
+        [kitTagNames.disclosure]: KitSinglePageElement;
     }
 }

package/dist/types/{src/kit → kit}/layout-types.d.ts

@@ -3,6 +3,7 @@ export interface FormLayoutSectionNode {
     id?: string;
     title?: string;
     description?: string;
+    defaultOpen?: boolean;
     children: FormLayoutNode[];
 }
 export interface FormLayoutGroupNode {
@@ -19,13 +20,9 @@ export interface FormLayoutReportNode {
     kind: "report";
     report: string;
 }
-export interface FormLayoutExplanationNode {
-    kind: "explanation";
-    explanation: string;
-}
-export type FormLayoutNode = FormLayoutSectionNode | FormLayoutGroupNode | FormLayoutFieldNode | FormLayoutReportNode | FormLayoutExplanationNode;
+export type FormLayoutNode = FormLayoutSectionNode | FormLayoutGroupNode | FormLayoutFieldNode | FormLayoutReportNode;
 export interface SinglePageLayoutConfig {
-    kind?: "single-page";
+    kind?: "stacked" | "split";
     children?: FormLayoutNode[];
 }
 export interface WizardStepConfig {
@@ -48,23 +45,13 @@ export interface TabsLayoutConfig {
     kind: "tabs";
     tabs: TabLayoutConfig[];
 }
-export interface AccordionSectionConfig {
-    id?: string;
-    title: string;
-    description?: string;
-    children: FormLayoutNode[];
-    defaultOpen?: boolean;
-}
-export interface AccordionLayoutConfig {
-    kind: "accordion";
-    sections: AccordionSectionConfig[];
-}
-export type FormLayoutConfig = SinglePageLayoutConfig | WizardLayoutConfig | TabsLayoutConfig | AccordionLayoutConfig;
+export type FormLayoutConfig = SinglePageLayoutConfig | WizardLayoutConfig | TabsLayoutConfig;
 export interface ResolvedFormLayoutSectionNode {
     kind: "section";
     id: string;
     title?: string;
     description?: string;
+    defaultOpen: boolean;
     children: ResolvedFormLayoutNode[];
 }
 export interface ResolvedFormLayoutGroupNode {
@@ -81,13 +68,9 @@ export interface ResolvedFormLayoutReportNode {
     kind: "report";
     report: string;
 }
-export interface ResolvedFormLayoutExplanationNode {
-    kind: "explanation";
-    explanation: string;
-}
-export type ResolvedFormLayoutNode = ResolvedFormLayoutSectionNode | ResolvedFormLayoutGroupNode | ResolvedFormLayoutFieldNode | ResolvedFormLayoutReportNode | ResolvedFormLayoutExplanationNode;
+export type ResolvedFormLayoutNode = ResolvedFormLayoutSectionNode | ResolvedFormLayoutGroupNode | ResolvedFormLayoutFieldNode | ResolvedFormLayoutReportNode;
 export interface ResolvedSinglePageLayout {
-    kind: "single-page";
+    kind: "stacked" | "split";
     children: ResolvedFormLayoutNode[];
 }
 export interface ResolvedWizardStep {
@@ -110,15 +93,4 @@ export interface ResolvedTabsLayout {
     kind: "tabs";
     tabs: ResolvedTabLayout[];
 }
-export interface ResolvedAccordionSection {
-    id: string;
-    title: string;
-    description?: string;
-    defaultOpen: boolean;
-    children: ResolvedFormLayoutNode[];
-}
-export interface ResolvedAccordionLayout {
-    kind: "accordion";
-    sections: ResolvedAccordionSection[];
-}
-export type ResolvedFormLayout = ResolvedSinglePageLayout | ResolvedWizardLayout | ResolvedTabsLayout | ResolvedAccordionLayout;
+export type ResolvedFormLayout = ResolvedSinglePageLayout | ResolvedWizardLayout | ResolvedTabsLayout;

package/dist/types/{src/kit → kit}/layout-utils.d.ts

@@ -2,7 +2,6 @@ import { ResolvedFormLayout, ResolvedFormLayoutNode } from './types';
 export interface LayoutReferences {
     fields: string[];
     reports: string[];
-    explanations: string[];
 }
 export declare const walkLayoutNodes: (layout: ResolvedFormLayout, visitor: (node: ResolvedFormLayoutNode) => void) => void;
 export declare const flattenLayoutNodes: (layout: ResolvedFormLayout) => ResolvedFormLayoutNode[];

package/dist/types/{src/kit → kit}/layout.d.ts

@@ -1,8 +1,8 @@
-import { ExplanationController, FieldController, ReportController } from '../../runtime';
+import { FieldController, ReportController } from '../runtime';
 import { LayoutReferenceMaps } from './layout-helpers';
 import { FormLayoutConfig, ResolvedFormLayout } from './types';
 export interface ResolvedLayoutResult {
     layout: ResolvedFormLayout;
     maps: LayoutReferenceMaps;
 }
-export declare const resolveFormLayout: (layout: FormLayoutConfig | undefined, fields: readonly FieldController[], reports: readonly ReportController[], explanations: readonly ExplanationController[]) => ResolvedLayoutResult;
+export declare const resolveFormLayout: (layout: FormLayoutConfig | undefined, fields: readonly FieldController[], reports: readonly ReportController[]) => ResolvedLayoutResult;

package/dist/types/{src/kit → kit}/mount-types.d.ts

@@ -1,7 +1,7 @@
-import { AttachedDesignSystem, DesignSystemConfig, DesignSystemRegistry, ResolvedDesignSystem } from '../../design-system';
-import { FormController, FormHooks, FormSchema, FormValidator, InactiveFieldPolicy, Registry, Transport } from '../../runtime';
-import { PrimitiveContainerStrategy, PrimitiveLayout, PrimitiveRegistry, PrimitiveReportTransport, PrimitiveTextOverrides } from '../../primitives';
-import { PresentationRegistry } from '../../presentation';
+import { AttachedDesignSystem, DesignSystemConfig, DesignSystemRegistry, ResolvedDesignSystem } from '../design';
+import { FormController, FormHooks, FormSchema, FormValidator, InactiveFieldPolicy, Registry, RuntimeBehavior, Transport } from '../runtime';
+import { PrimitiveContainerStrategy, PrimitiveRegistry, PrimitiveReportTransport, PrimitiveTextOverrides, PrimitiveDescriptorRegistry } from '../primitives';
+import { FormLayoutConfig } from './layout-types';
 export interface KitDesignSystemSnapshot extends Omit<DesignSystemConfig, "mode" | "theme" | "recipe"> {
     mode: NonNullable<DesignSystemConfig["mode"]>;
     theme: NonNullable<DesignSystemConfig["theme"]>;
@@ -18,7 +18,8 @@ export interface MountFormOptions {
     schema: FormSchema;
     transport: Transport;
     registry?: Registry;
-    presentationRegistry?: PresentationRegistry;
+    descriptorRegistry?: PrimitiveDescriptorRegistry;
+    behaviors?: RuntimeBehavior[];
     primitiveRegistry?: PrimitiveRegistry;
     designSystemRegistry?: DesignSystemRegistry;
     designSystem?: DesignSystemConfig;
@@ -31,7 +32,7 @@ export interface MountFormOptions {
     inactiveFieldPolicy?: InactiveFieldPolicy;
     listenerErrorPolicy?: "ignore" | "throw-aggregate";
     onListenerError?: (error: unknown) => void;
-    layout?: PrimitiveLayout;
+    layout?: FormLayoutConfig;
     containerStrategy?: PrimitiveContainerStrategy;
     reportPane?: "auto" | "always" | "hidden";
     reportTransport?: PrimitiveReportTransport;
@@ -43,7 +44,7 @@ export interface MountedForm {
     readonly form: FormController;
     readonly host: HTMLElement;
     readonly engineRegistry: Registry;
-    readonly presentationRegistry: PresentationRegistry;
+    readonly descriptorRegistry: PrimitiveDescriptorRegistry;
     readonly primitiveRegistry: PrimitiveRegistry;
     readonly designSystemRegistry: DesignSystemRegistry;
     readonly designSystem: AttachedDesignSystem;

package/dist/types/{src/kit → kit}/panel-nav.d.ts

@@ -1,5 +1,5 @@
 export interface PanelState {
-    kind: "wizard-step" | "tab" | "accordion-section";
+    kind: "wizard-step" | "tab" | "disclosure-section";
     index: number;
     count: number;
     currentId: string;

package/dist/types/{src/kit → kit}/tabs-root.d.ts

@@ -1,6 +1,5 @@
 import { LitElement } from 'lit';
-import { PrimitiveText } from '../../primitives/constants';
-import { PrimitiveRegistry } from '../../primitives/types';
+import { PrimitiveRegistry, PrimitiveText } from '../primitives';
 import { kitTagNames } from './constants';
 import { FormViewController } from './types';
 export declare class KitTabsElement extends LitElement {

package/dist/types/kit/types.d.ts

@@ -0,0 +1,4 @@
+export type { FormLayoutNode, FormLayoutSectionNode, FormLayoutGroupNode, FormLayoutFieldNode, FormLayoutReportNode, SinglePageLayoutConfig, WizardStepConfig, WizardLayoutConfig, TabLayoutConfig, TabsLayoutConfig, FormLayoutConfig, ResolvedFormLayoutNode, ResolvedFormLayoutSectionNode, ResolvedFormLayoutGroupNode, ResolvedFormLayoutFieldNode, ResolvedFormLayoutReportNode, ResolvedSinglePageLayout, ResolvedWizardStep, ResolvedWizardLayout, ResolvedTabLayout, ResolvedTabsLayout, ResolvedFormLayout, } from './layout-types';
+export type { KitDesignSystemSnapshot, KitLabels, MountFormOptions, MountedForm, } from './mount-types';
+export type { WizardState, TabsState, DisclosureState, FormViewFieldItem, FormViewReportItem, FormViewState, FormViewSnapshot, CreateFormViewOptions, FormViewController, LayoutReferences, PanelState, } from './view-types';
+export type { WizardLabels, WizardTextOverrides } from './wizard-constants';

package/dist/types/kit/view-core-types.d.ts

@@ -0,0 +1,110 @@
+import { FieldDescriptor, PrimitiveDescriptorRegistry, ReportDescriptor } from '../primitives';
+import { FieldController, FieldStateSnapshot, FormController, FormHooks, FormSchema, FormState, FormValidationResult, FormValidator, InactiveFieldPolicy, Registry, ReportController, ReportStateSnapshot, RuntimeBehavior, SubmitOptions, SubmitResult, Transport } from '../runtime';
+import { LayoutReferences } from './layout-utils';
+import { FormLayoutConfig, ResolvedFormLayout, ResolvedFormLayoutNode } from './layout-types';
+import { PanelState } from './panel-nav';
+export interface WizardState {
+    stepIndex: number;
+    stepCount: number;
+    currentStepId: string;
+    canNext: boolean;
+    canPrev: boolean;
+    isLastStep: boolean;
+}
+export interface TabsState {
+    activeTabIndex: number;
+    tabCount: number;
+    currentTabId: string;
+    canGoNext: boolean;
+    canGoPrev: boolean;
+}
+export interface DisclosureState {
+    openSectionIds: string[];
+    sectionCount: number;
+}
+export interface FormViewFieldItem {
+    id: string;
+    kind: string;
+    config: FieldController["config"];
+    controller: FieldController;
+    state: FieldStateSnapshot;
+    descriptor: FieldDescriptor;
+    stepId: string | null;
+    tabId: string | null;
+    sectionId: string | null;
+    visibleInLayout: boolean;
+}
+export interface FormViewReportItem {
+    id: string;
+    kind: string;
+    config: ReportController["config"];
+    controller: ReportController;
+    state: ReportStateSnapshot;
+    descriptor: ReportDescriptor | null;
+    stepId: string | null;
+    tabId: string | null;
+    sectionId: string | null;
+    visibleInLayout: boolean;
+}
+export interface FormViewState {
+    form: FormState;
+    wizard: WizardState | null;
+    tabs: TabsState | null;
+    disclosure: DisclosureState | null;
+}
+export interface FormViewSnapshot {
+    form: FormState;
+    layout: ResolvedFormLayout;
+    fields: FormViewFieldItem[];
+    reports: FormViewReportItem[];
+    wizard: WizardState | null;
+    tabs: TabsState | null;
+    disclosure: DisclosureState | null;
+}
+export interface CreateFormViewOptions {
+    schema: FormSchema;
+    transport: Transport;
+    registry?: Registry;
+    descriptorRegistry?: PrimitiveDescriptorRegistry;
+    behaviors?: RuntimeBehavior[];
+    initialValues?: Record<string, unknown>;
+    validators?: FormValidator[];
+    hooks?: FormHooks;
+    hookFailurePolicy?: {
+        afterSubmit?: "fail-submit" | "preserve-success";
+    };
+    inactiveFieldPolicy?: InactiveFieldPolicy;
+    listenerErrorPolicy?: "ignore" | "throw-aggregate";
+    onListenerError?: (error: unknown) => void;
+    layout?: FormLayoutConfig;
+}
+export interface FormViewController {
+    readonly form: FormController;
+    readonly engineRegistry: Registry;
+    readonly descriptorRegistry: PrimitiveDescriptorRegistry;
+    readonly state: FormViewState;
+    getSnapshot(): FormViewSnapshot;
+    getNodeById(id: string): ResolvedFormLayoutNode | undefined;
+    getField(id: string): FormViewFieldItem | undefined;
+    getReport(id: string): FormViewReportItem | undefined;
+    getVisibleFields(): FormViewFieldItem[];
+    getVisibleReports(): FormViewReportItem[];
+    getActiveLayoutNodes(): ResolvedFormLayoutNode[];
+    getLayoutReferences(): LayoutReferences;
+    validate(): Promise<FormValidationResult>;
+    submit(options?: SubmitOptions): Promise<SubmitResult>;
+    reset(): void;
+    subscribe(listener: (snapshot: FormViewSnapshot) => void): () => void;
+    nextStep(): Promise<boolean>;
+    prevStep(): void;
+    goToStep(stepId: string): Promise<boolean>;
+    setActiveTab(tabId: string): void;
+    nextTab(): boolean;
+    prevTab(): boolean;
+    toggleSection(sectionId: string): void;
+    openSection(sectionId: string): void;
+    closeSection(sectionId: string): void;
+    openAllSections(): void;
+    closeAllSections(): void;
+}
+export type { LayoutReferences, PanelState, ResolvedFormLayoutNode };

package/dist/types/{src/kit → kit}/view-layout-state.d.ts

@@ -1,4 +1,4 @@
-import { AccordionState, FormViewState, TabsState, WizardState, ResolvedFormLayout } from './types';
+import { DisclosureState, FormViewState, ResolvedFormLayoutNode, TabsState, WizardState, ResolvedFormLayout } from './types';
 type LayoutStateOptions = {
     layout: ResolvedFormLayout;
     stepIndex: number;
@@ -8,7 +8,14 @@ type LayoutStateOptions = {
 };
 export declare const getWizardState: ({ layout, stepIndex, formState, }: LayoutStateOptions) => WizardState | null;
 export declare const getTabsState: ({ layout, activeTabIndex }: LayoutStateOptions) => TabsState | null;
-export declare const getAccordionState: ({ layout, openSectionIds, }: LayoutStateOptions) => AccordionState | null;
+export declare const collectDisclosureSections: (nodes: readonly ResolvedFormLayoutNode[], sections?: {
+    id: string;
+    defaultOpen: boolean;
+}[]) => {
+    id: string;
+    defaultOpen: boolean;
+}[];
+export declare const getDisclosureState: ({ layout, openSectionIds, }: LayoutStateOptions) => DisclosureState | null;
 export declare const createFormViewState: (options: LayoutStateOptions) => FormViewState;
-export declare const isVisibleInLayout: (layout: ResolvedFormLayout, stepIndex: number, activeTabIndex: number, openSectionIds: Set<string>, stepId: string | null, tabId: string | null) => boolean;
+export declare const isVisibleInLayout: (layout: ResolvedFormLayout, stepIndex: number, activeTabIndex: number, openSectionIds: Set<string>, stepId: string | null, tabId: string | null, sectionId: string | null) => boolean;
 export {};

package/dist/types/{src/kit → kit}/view-navigation.d.ts

@@ -1,8 +1,8 @@
-import { FormController } from '../../runtime';
+import { FormController } from '../runtime';
 import { ResolvedLayoutResult } from './layout';
+import { ResolvedFormLayoutNode } from './types';
 export declare const validateCurrentWizardStep: (form: FormController, resolvedLayout: ResolvedLayoutResult, stepIndex: number) => Promise<boolean>;
-export declare const getActiveLayoutNodes: (resolvedLayout: ResolvedLayoutResult, stepIndex: number, activeTabIndex: number, openSectionIds: Set<string>) => import('./layout-types').ResolvedFormLayoutNode[];
-export declare const assertAccordionSection: (resolvedLayout: ResolvedLayoutResult, accordionSections: readonly {
+export declare const getActiveLayoutNodes: (resolvedLayout: ResolvedLayoutResult, stepIndex: number, activeTabIndex: number, openSectionIds: Set<string>) => ResolvedFormLayoutNode[];
+export declare const assertDisclosureSection: (disclosureSections: readonly {
     id: string;
 }[], sectionId: string) => void;
-export declare const assertAccordionLayout: (resolvedLayout: ResolvedLayoutResult) => void;

package/dist/types/kit/view-snapshot-cache.d.ts

@@ -0,0 +1,14 @@
+import { PrimitiveDescriptorRegistry } from '../primitives';
+import { FormController } from '../runtime';
+import { ResolvedLayoutResult } from './layout';
+import { FormViewSnapshot } from './types';
+type SnapshotCacheOptions = {
+    form: FormController;
+    descriptorRegistry: PrimitiveDescriptorRegistry;
+    resolvedLayout: ResolvedLayoutResult;
+    getStepIndex: () => number;
+    getActiveTabIndex: () => number;
+    getOpenSectionIds: () => Set<string>;
+};
+export declare const createFormViewSnapshotCache: ({ form, descriptorRegistry, resolvedLayout, getStepIndex, getActiveTabIndex, getOpenSectionIds, }: SnapshotCacheOptions) => (() => FormViewSnapshot);
+export {};

package/dist/types/kit/view-snapshot.d.ts

@@ -0,0 +1,15 @@
+import { PrimitiveDescriptorRegistry } from '../primitives';
+import { FormController } from '../runtime';
+import { FormViewSnapshot } from './types';
+import { ResolvedLayoutResult } from './layout';
+type BuildSnapshotOptions = {
+    form: FormController;
+    descriptorRegistry: PrimitiveDescriptorRegistry;
+    resolvedLayout: ResolvedLayoutResult;
+    stepIndex: number;
+    activeTabIndex: number;
+    openSectionIds: Set<string>;
+};
+export declare const buildFormViewSnapshot: ({ form, descriptorRegistry, resolvedLayout, stepIndex, activeTabIndex, openSectionIds, }: BuildSnapshotOptions) => FormViewSnapshot;
+export declare const createViewState: (form: FormController, layout: ResolvedLayoutResult["layout"], stepIndex: number, activeTabIndex: number, openSectionIds: Set<string>) => import('./view-core-types').FormViewState;
+export {};

package/dist/types/kit/view-types.d.ts

@@ -0,0 +1 @@
+export type { DisclosureState, CreateFormViewOptions, FormViewController, FormViewFieldItem, FormViewReportItem, FormViewSnapshot, FormViewState, LayoutReferences, PanelState, TabsState, WizardState, } from './view-core-types';

package/dist/types/kit/view.d.ts

@@ -0,0 +1,2 @@
+import { CreateFormViewOptions, FormViewController } from './view-core-types';
+export declare const createFormView: (options: CreateFormViewOptions) => FormViewController;

package/dist/types/{src/kit → kit}/wizard-root.d.ts

@@ -1,6 +1,5 @@
 import { LitElement } from 'lit';
-import { PrimitiveText } from '../../primitives/constants';
-import { PrimitiveRegistry } from '../../primitives/types';
+import { PrimitiveRegistry, PrimitiveText } from '../primitives';
 import { kitTagNames } from './constants';
 import { FormViewController } from './types';
 export declare class KitWizardElement extends LitElement {

package/dist/types/{src/primitives → primitives}/base-async-report-element.d.ts

@@ -15,5 +15,5 @@ export declare abstract class PrimitiveAsyncReportElement extends PrimitiveRepor
     protected get transportResultStatus(): PrimitiveAsyncReportStatus;
     protected get transportResult(): unknown;
     protected get transportError(): string | null;
-    protected renderTransportPanel(text: PrimitiveText): import('lit').TemplateResult<1> | typeof nothing;
+    protected renderTransportPanel(text: PrimitiveText): typeof nothing | import('lit').TemplateResult<1>;
 }

package/dist/types/{src/primitives → primitives}/base-field-element.d.ts

@@ -1,11 +1,11 @@
 import { LitElement, nothing, CSSResultGroup, TemplateResult } from 'lit';
-import { FieldDescriptor } from '../../presentation';
-import { FieldController } from '../../runtime';
+import { FieldDescriptor } from './descriptors';
+import { PrimitiveFieldController } from './controller-types';
 import { PrimitiveText } from './constants';
 import { PrimitiveFieldRenderContext } from './types';
 export declare abstract class PrimitiveFieldElement extends LitElement {
     static styles: CSSResultGroup;
-    accessor controller: FieldController | undefined;
+    accessor controller: PrimitiveFieldController | undefined;
     accessor descriptor: FieldDescriptor | null;
     accessor context: PrimitiveFieldRenderContext | undefined;
     accessor text: PrimitiveText;

package/dist/types/{src/primitives → primitives}/base-report-element.d.ts

@@ -1,11 +1,11 @@
 import { LitElement, CSSResultGroup } from 'lit';
-import { ReportDescriptor } from '../../presentation';
-import { ReportController } from '../../runtime';
+import { ReportDescriptor } from './descriptors';
+import { PrimitiveReportController } from './controller-types';
 import { PrimitiveText } from './constants';
 import { PrimitiveReportRenderContext, PrimitiveReportRequest, PrimitiveReportTransport } from './types';
 export declare abstract class PrimitiveReportElement extends LitElement {
     static styles: CSSResultGroup;
-    accessor controller: ReportController | undefined;
+    accessor controller: PrimitiveReportController | undefined;
     accessor descriptor: ReportDescriptor | null;
     accessor context: PrimitiveReportRenderContext | undefined;
     accessor text: PrimitiveText;

package/dist/types/primitives/components/descriptor-content.d.ts

@@ -0,0 +1,4 @@
+import { nothing, TemplateResult } from 'lit';
+import { DescriptorNode, DescriptorSummary } from '../descriptors';
+export declare const renderDescriptorSummary: (summary: DescriptorSummary | null | undefined, fallbackTitle?: string) => TemplateResult | typeof nothing;
+export declare const renderDescriptorNodes: (nodes: DescriptorNode[]) => TemplateResult | typeof nothing;

package/dist/types/primitives/components/error-focus.d.ts

@@ -0,0 +1,5 @@
+import { PrimitiveFieldController } from '../controller-types';
+export declare const findFieldFrame: (root: ParentNode, fieldId: string) => HTMLElement | null;
+export declare const scrollFieldFrameIntoView: (frame: HTMLElement | null) => Promise<boolean>;
+export declare const focusPrimitiveField: (host: HTMLElement, fieldId: string) => Promise<boolean>;
+export declare const findFirstInvalidField: (fields: readonly PrimitiveFieldController[]) => PrimitiveFieldController | null;

package/dist/types/{src/primitives → primitives}/components/field-frame-feedback.d.ts

@@ -1,9 +1,9 @@
-import { FieldStateSnapshot } from '../../../runtime';
+import { PrimitiveFieldStateSnapshot } from '../controller-types';
 import { PrimitiveText } from '../constants';
 export declare const resolveFieldFeedbackComponent: (component: string, props: Record<string, unknown>) => string;
 export declare const resolveCategorySelection: (props: Record<string, unknown>, value: unknown) => {
     label: string;
     value: string;
 } | null;
-export declare const hasIntroducedValue: (component: string, props: Record<string, unknown>, state: FieldStateSnapshot, defaultValue: unknown) => boolean;
-export declare const createFieldSuccessMessage: (component: string, props: Record<string, unknown>, state: FieldStateSnapshot, text: PrimitiveText) => string;
+export declare const hasIntroducedValue: (component: string, props: Record<string, unknown>, state: PrimitiveFieldStateSnapshot, defaultValue: unknown) => boolean;
+export declare const createFieldSuccessMessage: (component: string, props: Record<string, unknown>, state: PrimitiveFieldStateSnapshot, text: PrimitiveText) => string;

package/dist/types/{src/primitives → primitives}/components/field-frame.d.ts

@@ -1,12 +1,12 @@
 import { LitElement } from 'lit';
-import { FieldController } from '../../../runtime';
-import { FieldDescriptor } from '../../../presentation';
+import { PrimitiveFieldController } from '../controller-types';
+import { FieldDescriptor } from '../descriptors';
 import { primitiveTagNames, PrimitiveText } from '../constants';
 import { PrimitiveRegistry } from '../types';
 export declare class PrimitiveFieldFrameElement extends LitElement {
     #private;
     static styles: import('lit').CSSResult;
-    accessor controller: FieldController | undefined;
+    accessor controller: PrimitiveFieldController | undefined;
     accessor descriptor: FieldDescriptor | null;
     accessor registry: PrimitiveRegistry | undefined;
     accessor text: PrimitiveText;

package/dist/types/{src/primitives → primitives}/components/form-errors.d.ts

@@ -1,10 +1,10 @@
 import { LitElement } from 'lit';
-import { FormController } from '../../../runtime';
+import { PrimitiveFormController } from '../controller-types';
 import { primitiveTagNames, PrimitiveText } from '../constants';
 export declare class PrimitiveFormErrorsElement extends LitElement {
     #private;
     static styles: import('lit').CSSResult;
-    accessor form: FormController | undefined;
+    accessor form: PrimitiveFormController | undefined;
     accessor text: PrimitiveText;
     private accessor formErrors;
     protected willUpdate(changedProperties: Map<string, unknown>): void;

package/dist/types/primitives/components/form-root-presenters.d.ts

@@ -0,0 +1,12 @@
+import { FieldDescriptor, PrimitiveDescriptorRegistry, ReportDescriptor } from '../descriptors';
+import { PrimitiveFormController, PrimitiveReportController } from '../controller-types';
+export type PresentedField = {
+    controller: NonNullable<ReturnType<PrimitiveFormController["getField"]>>;
+    descriptor: FieldDescriptor;
+};
+export type PresentedReport = {
+    controller: PrimitiveReportController;
+    descriptor: ReportDescriptor | null;
+};
+export declare const presentVisibleFields: (form: PrimitiveFormController, fieldIds: readonly string[], descriptorRegistry: PrimitiveDescriptorRegistry | undefined) => PresentedField[];
+export declare const presentVisibleReports: (form: PrimitiveFormController, reportIds: readonly string[], reportPane: "auto" | "always" | "hidden", descriptorRegistry: PrimitiveDescriptorRegistry | undefined) => PresentedReport[];

package/dist/types/primitives/components/form-root-split-styles.d.ts

@@ -0,0 +1 @@
+export declare const formRootSplitStyles: import('lit').CSSResult;

package/dist/types/{src/primitives → primitives}/components/form-root-state.d.ts

@@ -1,6 +1,6 @@
-import { FormController, FormStatus, ReportController } from '../../../runtime';
+import { PrimitiveFormController, PrimitiveFormStatus, PrimitiveReportController } from '../controller-types';
 export type FormRenderState = {
-    status: FormStatus;
+    status: PrimitiveFormStatus;
     submitCount: number;
     hasFormErrors: boolean;
     hasLastResult: boolean;
@@ -10,10 +10,8 @@ export type FormRenderState = {
     submissionSessionMessageCount?: number;
     visibleFieldIds: string[];
     visibleReportIds: string[];
-    explanationIds: string[];
     reportStateKeys: string[];
-    explanationStateKeys: string[];
 };
 export declare const sameFormRenderState: (left: FormRenderState, right: FormRenderState) => boolean;
-export declare const selectFormRenderState: (form: FormController) => FormRenderState;
-export declare const resolveVisibleReports: (form: FormController, visibleReportIds: string[], reportPane: "auto" | "always" | "hidden") => readonly ReportController[];
+export declare const selectFormRenderState: (form: PrimitiveFormController) => FormRenderState;
+export declare const resolveVisibleReports: (form: PrimitiveFormController, visibleReportIds: string[], reportPane: "auto" | "always" | "hidden") => readonly PrimitiveReportController[];

package/dist/types/{src/primitives → primitives}/components/form-root-templates.d.ts

@@ -1,19 +1,16 @@
-import { nothing, TemplateResult } from 'lit';
-import { PresentationRegistry } from '../../../presentation';
-import { FormController } from '../../../runtime';
+import { TemplateResult } from 'lit';
+import { PrimitiveFormController } from '../controller-types';
 import { PrimitiveText } from '../constants';
 import { PrimitiveRegistry, PrimitiveReportTransport } from '../types';
 import { FormRenderState } from './form-root-state';
 import { PresentedField, PresentedReport } from './form-root-presenters';
-export declare const renderExplanations: (form: FormController, state: FormRenderState, registry: PrimitiveRegistry | undefined, presentationRegistry: PresentationRegistry | undefined, text: PrimitiveText) => TemplateResult | typeof nothing;
 export declare const renderStackedLayout: (options: {
-    form: FormController;
+    form: PrimitiveFormController;
     state: FormRenderState;
     visibleFields: readonly PresentedField[];
     reportsToRender: readonly PresentedReport[];
     showReports: boolean;
     registry: PrimitiveRegistry | undefined;
-    presentationRegistry: PresentationRegistry | undefined;
     text: PrimitiveText;
     formLabel: string;
     reportsLabel: string;
@@ -24,13 +21,12 @@ export declare const renderStackedLayout: (options: {
     onSubmitRequest: () => Promise<void>;
 }) => TemplateResult;
 export declare const renderSplitLayout: (options: {
-    form: FormController;
+    form: PrimitiveFormController;
     state: FormRenderState;
     visibleFields: readonly PresentedField[];
     reportsToRender: readonly PresentedReport[];
     showReports: boolean;
     registry: PrimitiveRegistry | undefined;
-    presentationRegistry: PresentationRegistry | undefined;
     text: PrimitiveText;
     formLabel: string;
     reportsLabel: string;