mlform 0.1.7 → 0.1.8

package/dist/types/src/behaviors/index.d.ts

@@ -0,0 +1,3 @@
+import { RuntimeBehavior } from '../../runtime/types';
+export declare const createMappedCategoryBehavior: () => RuntimeBehavior;
+export type { RuntimeBehavior, RuntimeBehaviorContext, RuntimeBehaviorSubmissionRecords, RuntimeBehaviorValueChangeEvent, } from '../../runtime/types';

package/dist/types/src/builtins-ml/index.d.ts

@@ -0,0 +1,5 @@
+import { classifierReportDefinition, regressorReportDefinition } from '../../runtime/builtins';
+import { Registry } from '../../schema';
+export { classifierReportDefinition, regressorReportDefinition };
+export declare const createBuiltinMlRegistry: () => Registry;
+export declare const createMlRegistryPack: () => import('../packs').RegistryPack;

package/dist/types/src/design-system/runtime/fingerprint.d.ts

@@ -0,0 +1,8 @@
+import { DesignSystemConfig } from '../types';
+export type DesignSystemMediaSnapshot = {
+    prefersDarkScheme: boolean;
+    prefersReducedMotion: boolean;
+    prefersMoreContrast: boolean;
+    forcedColors: boolean;
+};
+export declare const fingerprintEnvironment: (config: DesignSystemConfig, media: DesignSystemMediaSnapshot) => string;

package/dist/types/src/design-system/runtime/host-observer.d.ts

@@ -0,0 +1 @@
+export declare const observeHostChain: (host: HTMLElement, observer: MutationObserver | null, observedNodes: Set<Node>) => void;

package/dist/types/src/design-system/runtime/hydration-state.d.ts

@@ -0,0 +1,13 @@
+import { ResolvedDesignSystem } from '../types';
+export declare const captureOriginalTokenValues: (host: HTMLElement, originalTokenValues: Map<string, string | null>, tokens: Record<string, string>) => void;
+export declare const restoreRemovedTokenValues: (host: HTMLElement, appliedTokens: Set<string>, originalTokenValues: Map<string, string | null>, tokens: Record<string, string>) => void;
+export declare const hostMatchesResolved: (host: HTMLElement, resolved: ResolvedDesignSystem) => boolean;
+export declare const seedHydratedResolvedState: (host: HTMLElement, originalTokenValues: Map<string, string | null>, config: {
+    resolved: ResolvedDesignSystem;
+    envSnapshot: string;
+}) => {
+    appliedTokens: Set<string>;
+    resolved: ResolvedDesignSystem;
+    signature: string;
+    envSnapshot: string;
+} | null;

package/dist/types/src/design-system/runtime/inherited-scheme.d.ts

@@ -0,0 +1,5 @@
+import { DesignSystemConfig, DesignSystemScheme, EffectiveModeSource } from '../types';
+export declare const resolveInheritedScheme: (host: HTMLElement, config: DesignSystemConfig) => {
+    scheme: DesignSystemScheme | null;
+    source: Extract<EffectiveModeSource, "host-attribute" | "host-style" | "host-resolver"> | null;
+};

package/dist/types/src/design-system/runtime/media.d.ts

@@ -0,0 +1,19 @@
+import { DesignSystemMediaSnapshot } from './fingerprint';
+export type MediaQueryListWithLegacy = MediaQueryList & {
+    addListener?: (callback: (event: MediaQueryListEvent) => void) => void;
+    removeListener?: (callback: (event: MediaQueryListEvent) => void) => void;
+};
+export declare const createMediaQueries: () => {
+    scheme: MediaQueryListWithLegacy | null;
+    motion: MediaQueryListWithLegacy | null;
+    contrast: MediaQueryListWithLegacy | null;
+    forcedColors: MediaQueryListWithLegacy | null;
+};
+export declare const addMediaListener: (mql: MediaQueryListWithLegacy, fn: () => void) => void;
+export declare const removeMediaListener: (mql: MediaQueryListWithLegacy, fn: () => void) => void;
+export declare const getMediaSnapshot: (queries: {
+    scheme: MediaQueryListWithLegacy | null;
+    motion: MediaQueryListWithLegacy | null;
+    contrast: MediaQueryListWithLegacy | null;
+    forcedColors: MediaQueryListWithLegacy | null;
+}) => DesignSystemMediaSnapshot;

package/dist/types/src/index.d.ts

@@ -1,7 +1,13 @@
-export { defaultKitDesignSystem, defaultKitLabels, mountForm, unmountForm } from '../kit';
+export { collectLayoutReferences, createFormView, defaultKitDesignSystem, defaultKitLabels, flattenLayoutNodes, mountForm, mountAccordionForm, mountTabsForm, mountWizardForm, unmountForm, walkLayoutNodes, } from '../kit';
 export { assertPayloadWithinLimits, assertTransportCapabilities, cloneCapabilities, createFanoutTransport, createFallbackTransport, createGraphqlTransport, createGrpcSessionTransport, createGrpcStreamTransport, createGrpcTransport, createGrpcUnaryTransport, createHedgedTransport, createJsonTransport, createLoadBalancedTransport, createMemoryCircuitBreakerState, createMemorySharedRateLimiter, createMemoryTransportCacheStore, createMemoryTransportHealthState, createPipelineTransport, createQuorumFanoutTransport, createRacingTransport, createRoutingTransport, createSessionTransport, createSseTransport, createWebSocketSessionTransport, createWeightedRoutingTransport, inferTransportCapabilities, mergeTransportCapabilities, normalizeTransportCapabilities, pipe, transportDefaults, transportErrorMessages, transportErrorCodes, TransportError, withAuth, withCache, withCircuitBreaker, withDedup, withLogging, withMetrics, withRateLimit, withRequestTransform, withResponseTransform, withRetry, withTracing, withTimeout, } from '../transport';
 export type { ApiKeyAuthOptions, AuthOptions, BearerAuthOptions, CacheOptions, CapabilityRequirement, CircuitBreakerOptions, CircuitBreakerSharedState, CircuitBreakerStateSnapshot, CustomAuthOptions, DedupOptions, FanoutTransportFailure, FanoutTransportOptions, FanoutTransportResult, FallbackTransportFailure, FallbackTransportOptions, GraphqlTransportOptions, GrpcSessionTransportOptions, GrpcStreamTransportOptions, GrpcTransportOptions, GrpcUnaryTransportOptions, HedgedTransportOptions, JsonTransportMethod, JsonTransportOptions, LoadBalancingTransportOptions, PipelineStage, PipelineTransportOptions, QuorumFanoutTransportOptions, RateLimitLeaseRequest, RateLimitOptions, RacingTransportOptions, RetryOptions, RoutingTransportOptions, SessionTransportOptions, SharedRateLimiter, SharedRateLimiterLease, SseTransportOptions, TransportBackpressureMode, TransportCacheEntry, TransportCacheStore, TransportCapabilities, TransportCollection, TransportConsistency, TransportContextAuthOptions, TransportDeliveryMode, TransportErrorCode, TransportHealthSnapshot, TransportHealthState, TransportLogOptions, TransportMetricsOptions, TransportMiddleware, TransportTelemetryEvent, TransportTraceOptions, WebSocketSessionTransportOptions, WeightedRoutingTransportOptions, } from '../transport';
-export type { KitDesignSystemSnapshot, KitLabels, MountFormOptions, MountedForm } from '../kit';
+export type { AccordionLayoutConfig, AccordionMountUiOptions, AccordionSectionConfig, AccordionState, CreateFormViewOptions, FormLayoutConfig, FormLayoutExplanationNode, FormLayoutFieldNode, FormLayoutGroupNode, FormLayoutNode, FormLayoutReportNode, FormLayoutSectionNode, FormViewController, FormViewExplanationItem, FormViewFieldItem, FormViewReportItem, FormViewSnapshot, FormViewState, KitDesignSystemSnapshot, KitLabels, MountedAccordionForm, MountFormOptions, MountedForm, MountedTabsForm, MountedWizardForm, MountAccordionFormOptions, MountTabsFormOptions, MountWizardFormOptions, PanelState, ResolvedAccordionLayout, ResolvedAccordionSection, ResolvedFormLayout, ResolvedFormLayoutExplanationNode, ResolvedFormLayoutFieldNode, ResolvedFormLayoutGroupNode, ResolvedFormLayoutNode, ResolvedFormLayoutReportNode, ResolvedFormLayoutSectionNode, ResolvedTabLayout, ResolvedTabsLayout, TabLayoutConfig, TabsLayoutConfig, TabsState, WizardLayoutConfig, WizardState, WizardStepConfig, } from '../kit';
 export type { ExplanationRequest, ExplanationTransport, PrimitiveFieldRenderContext, PrimitiveExplanationRenderContext, PrimitiveExplanationRendererElement, PrimitiveFieldRendererElement, PrimitiveReportRenderContext, PrimitiveReportRendererElement, } from '../primitives';
-export { createExplanationController, defineExplanationDefinition, defineExplanationKind, defineFieldKind, defineReportKind, executeExplanations, executeFormPipeline, } from '../engine';
-export type { AfterExplanationContext, DeclarativeExplanationKind, DeclarativeFieldKind, DeclarativeReportKind, ExplanationConfig, ExplanationController, ExplanationDefinition, ExplanationDescriptor, ExplanationDescriptorContext, ExplanationErrorContext, ExplanationExecutionContext, ExplanationExecutionResult, ExplanationFetchContext, ExplanationFetchFactory, ExplanationFetchRequest, ExplanationFetchTransport, ExplanationRenderSpec, ExplanationRenderSpecContext, ExplanationStateSnapshot, ExplanationStatus, FieldRenderHints, FieldRenderSpec, FieldRenderSpecContext, FieldValidationFnContext, FieldValueAdapter, FieldWidget, NormalizedExplanationConfig, PipelineArtifactAdapter, PipelineArtifactContext, PipelineResult, ExecuteFormPipelineOptions, PresentationNode, PresentationSummary, ReportRenderSpec, ReportRenderSpecContext, ReportResolveContext, } from '../engine';
+export { createExplanationController, executeExplanations, executeFormPipeline } from '../runtime';
+export { createRegistry, defineExplanationDefinition, defineFieldDefinition, defineReportDefinition, } from '../schema';
+export { defineExplanationKind, defineFieldKind, defineReportKind, toPresentationNodes, } from '../presentation';
+export { createBuiltinMlRegistry, createMlRegistryPack } from '../builtins-ml';
+export { createMappedCategoryBehavior } from '../behaviors';
+export { createDefaultRegistryPack } from '../packs';
+export type { AfterExplanationContext, ExplanationConfig, ExplanationController, ExplanationDefinition, ExplanationErrorContext, ExplanationExecutionContext, ExplanationExecutionResult, ExplanationFetchContext, ExplanationFetchFactory, ExplanationFetchRequest, ExplanationFetchTransport, ExplanationStateSnapshot, ExplanationStatus, FieldValidationFnContext, FieldValueAdapter, NormalizedExplanationConfig, PipelineArtifactAdapter, PipelineArtifactContext, PipelineResult, ExecuteFormPipelineOptions, ReportResolveContext, } from '../runtime';
+export type { DeclarativeExplanationKind, DeclarativeFieldKind, DeclarativeReportKind, ExplanationDescriptor, ExplanationDescriptorContext, ExplanationRenderSpec, ExplanationRenderSpecContext, FieldDescriptor, FieldRenderHints, FieldRenderSpec, FieldRenderSpecContext, FieldWidget, PresentationContent, PresentationNode, PresentationSummary, PresentationTone, ReportDescriptor, ReportRenderSpec, ReportRenderSpecContext, } from '../presentation';

package/dist/types/src/kit/accordion-root-styles.d.ts

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

package/dist/types/src/kit/accordion-root.d.ts

@@ -0,0 +1,24 @@
+import { LitElement } from 'lit';
+import { PrimitiveText } from '../../primitives/constants';
+import { PrimitiveRegistry } from '../../primitives/types';
+import { kitTagNames } from './constants';
+import { FormViewController } from './types';
+export declare class KitAccordionElement extends LitElement {
+    #private;
+    static styles: import('lit').CSSResult;
+    accessor view: FormViewController | undefined;
+    accessor registry: PrimitiveRegistry | undefined;
+    accessor primitiveText: PrimitiveText;
+    accessor submitLabel: string;
+    accessor validatingLabel: string;
+    accessor submittingLabel: string;
+    private accessor snapshot;
+    protected willUpdate(changed: Map<string, unknown>): void;
+    disconnectedCallback(): void;
+    render(): import('lit').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        [kitTagNames.accordion]: KitAccordionElement;
+    }
+}

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

@@ -0,0 +1,2 @@
+import { MountAccordionFormOptions, MountedAccordionForm } from './types';
+export declare const mountAccordionForm: (container: HTMLElement, options: MountAccordionFormOptions) => MountedAccordionForm;

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

@@ -1,4 +1,33 @@
 export declare const kitErrorMessages: {
     readonly invalidDesignSystemSnapshot: "replaceDesignSystem requires an explicit mode, theme, and recipe.";
+    readonly fieldDuplicateInLayout: (fieldId: string) => string;
+    readonly fieldMissingInLayout: (fieldId: string) => string;
+    readonly reportDuplicateInLayout: (reportId: string) => string;
+    readonly explanationDuplicateInLayout: (explanationId: string) => string;
+    readonly unknownFieldReference: (fieldId: string) => string;
+    readonly unknownReportReference: (reportId: string) => string;
+    readonly unknownExplanationReference: (explanationId: string) => string;
+    readonly wizardRequiresSteps: "Wizard layout must define at least one step.";
+    readonly wizardStepEmpty: (stepId: string) => string;
+    readonly tabsRequiresTabs: "Tabs layout must define at least one tab.";
+    readonly tabEmpty: (tabId: string) => string;
+    readonly accordionRequiresSections: "Accordion layout must define at least one section.";
+    readonly accordionSectionEmpty: (sectionId: string) => string;
+    readonly wizardMissingLayout: "mountWizardForm requires a wizard layout.";
+    readonly tabsMissingLayout: "mountTabsForm requires a tabs layout.";
+    readonly accordionMissingLayout: "mountAccordionForm requires an accordion layout.";
+    readonly nonWizardNextStep: "nextStep() is only available for wizard layouts.";
+    readonly nonWizardGoToStep: "goToStep() is only available for wizard layouts.";
+    readonly nonTabsSetActiveTab: "setActiveTab() is only available for tabs layouts.";
+    readonly nonAccordionToggleSection: "Accordion section controls are only available for accordion layouts.";
+    readonly unknownTab: (tabId: string) => string;
+    readonly unknownWizardStep: (stepId: string) => string;
+    readonly unknownAccordionSection: (sectionId: string) => string;
+};
+export declare const kitTagNames: {
+    readonly wizard: "mlf-kit-wizard";
+    readonly tabs: "mlf-kit-tabs";
+    readonly accordion: "mlf-kit-accordion";
+    readonly stepIndicator: "mlf-kit-step-indicator";
 };
 export { transportDefaults as kitTransportDefaults, transportErrorMessages } from '../../transport';

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

@@ -1,10 +1,10 @@
 import { DesignSystemConfig, DesignSystemRegistry } from '../../design-system';
-import { Registry } from '../../engine';
+import { Registry } from '../../runtime';
 import { PrimitiveRegistry } from '../../primitives';
 import { KitLabels } from './types';
 export declare const defaultKitLabels: Required<KitLabels>;
 export declare const defaultKitDesignSystem: DesignSystemConfig;
-export declare const cloneEngineRegistry: (registry?: Registry) => Registry;
+export declare const cloneSchemaRegistry: (registry?: Registry) => Registry;
 export declare const resolvePrimitiveRegistry: (registry?: PrimitiveRegistry) => PrimitiveRegistry;
 export declare const resolveDesignSystemRegistry: (registry?: DesignSystemRegistry) => DesignSystemRegistry;
 export declare const resolveKitLabels: (labels?: KitLabels) => Required<KitLabels>;

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

@@ -1,4 +1,9 @@
 export { defaultKitDesignSystem, defaultKitLabels } from './defaults';
+export { mountAccordionForm } from './accordion';
+export { collectLayoutReferences, flattenLayoutNodes, walkLayoutNodes } from './layout-utils';
 export { mountForm, unmountForm } from './mount-form';
+export { mountTabsForm } from './tabs';
+export { createFormView } from './view';
+export { mountWizardForm } from './wizard';
 export { assertPayloadWithinLimits, assertTransportCapabilities, createFanoutTransport, createFallbackTransport, createGraphqlTransport, createGrpcSessionTransport, createGrpcStreamTransport, createGrpcTransport, createGrpcUnaryTransport, createHedgedTransport, createJsonTransport, createLoadBalancedTransport, createMemoryCircuitBreakerState, createMemorySharedRateLimiter, createMemoryTransportCacheStore, createMemoryTransportHealthState, createPipelineTransport, createQuorumFanoutTransport, createRacingTransport, createRoutingTransport, createSseTransport, createSessionTransport, createWebSocketSessionTransport, createWeightedRoutingTransport, pipe, withAuth, withCache, withCircuitBreaker, withDedup, withLogging, withMetrics, withRateLimit, withRequestTransform, withResponseTransform, withRetry, withTracing, withTimeout, } from '../../transport';
-export type { ApiKeyAuthOptions, AuthOptions, BearerAuthOptions, CapabilityRequirement, CacheOptions, CircuitBreakerSharedState, CircuitBreakerOptions, CustomAuthOptions, DedupOptions, FanoutTransportFailure, FanoutTransportOptions, FanoutTransportResult, FallbackTransportFailure, FallbackTransportOptions, GraphqlTransportOptions, GrpcSessionTransportOptions, GrpcStreamTransportOptions, GrpcTransportOptions, GrpcUnaryTransportOptions, HedgedTransportOptions, JsonTransportMethod, JsonTransportOptions, KitDesignSystemSnapshot, KitLabels, LoadBalancingTransportOptions, MountFormOptions, MountedForm, PipelineStage, PipelineTransportOptions, QuorumFanoutTransportOptions, RateLimitLeaseRequest, SharedRateLimiter, SharedRateLimiterLease, SessionTransportOptions, TransportCacheEntry, TransportCacheStore, TransportHealthSnapshot, TransportHealthState, RateLimitOptions, RacingTransportOptions, RetryOptions, RoutingTransportOptions, TransportContextAuthOptions, TransportCollection, TransportMetricsOptions, TransportTelemetryEvent, TransportLogOptions, TransportMiddleware, TransportTraceOptions, SseTransportOptions, WebSocketSessionTransportOptions, WeightedRoutingTransportOptions, } from './types';
+export type { ApiKeyAuthOptions, AuthOptions, BearerAuthOptions, CapabilityRequirement, CacheOptions, CircuitBreakerSharedState, CircuitBreakerOptions, CustomAuthOptions, DedupOptions, FanoutTransportFailure, FanoutTransportOptions, FanoutTransportResult, FallbackTransportFailure, FallbackTransportOptions, GraphqlTransportOptions, GrpcSessionTransportOptions, GrpcStreamTransportOptions, GrpcTransportOptions, GrpcUnaryTransportOptions, HedgedTransportOptions, JsonTransportMethod, JsonTransportOptions, AccordionLayoutConfig, AccordionMountUiOptions, AccordionSectionConfig, AccordionState, CreateFormViewOptions, FormLayoutConfig, FormLayoutExplanationNode, FormLayoutFieldNode, FormLayoutGroupNode, FormLayoutNode, FormLayoutReportNode, FormLayoutSectionNode, FormViewController, FormViewExplanationItem, FormViewFieldItem, FormViewReportItem, FormViewSnapshot, FormViewState, KitDesignSystemSnapshot, KitLabels, LoadBalancingTransportOptions, MountFormOptions, MountedAccordionForm, MountedWizardForm, MountedTabsForm, MountedForm, MountAccordionFormOptions, MountTabsFormOptions, MountWizardFormOptions, PanelState, PipelineStage, PipelineTransportOptions, QuorumFanoutTransportOptions, RateLimitLeaseRequest, SharedRateLimiter, SharedRateLimiterLease, SessionTransportOptions, TransportCacheEntry, TransportCacheStore, TransportHealthSnapshot, TransportHealthState, RateLimitOptions, RacingTransportOptions, RetryOptions, RoutingTransportOptions, TransportContextAuthOptions, TransportCollection, TransportMetricsOptions, TransportTelemetryEvent, TransportLogOptions, TransportMiddleware, TransportTraceOptions, ResolvedAccordionLayout, ResolvedAccordionSection, ResolvedFormLayout, ResolvedFormLayoutExplanationNode, ResolvedFormLayoutFieldNode, ResolvedFormLayoutGroupNode, ResolvedFormLayoutNode, ResolvedFormLayoutReportNode, ResolvedFormLayoutSectionNode, ResolvedTabLayout, ResolvedTabsLayout, SseTransportOptions, TabsLayoutConfig, TabsState, TabLayoutConfig, WebSocketSessionTransportOptions, WizardLayoutConfig, WizardState, WizardStepConfig, WeightedRoutingTransportOptions, } from './types';

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

@@ -0,0 +1,29 @@
+import { ExplanationController, 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>;
+    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 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 assertAllFieldsCovered: (fields: readonly FieldController[], maps: LayoutReferenceMaps) => void;

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

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

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

@@ -0,0 +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[];

package/dist/types/src/kit/layout-types.d.ts

@@ -0,0 +1,124 @@
+export interface FormLayoutSectionNode {
+    kind: "section";
+    id?: string;
+    title?: string;
+    description?: string;
+    children: FormLayoutNode[];
+}
+export interface FormLayoutGroupNode {
+    kind: "group";
+    id?: string;
+    columns?: 1 | 2 | 3;
+    children: FormLayoutNode[];
+}
+export interface FormLayoutFieldNode {
+    kind: "field";
+    field: string;
+}
+export interface FormLayoutReportNode {
+    kind: "report";
+    report: string;
+}
+export interface FormLayoutExplanationNode {
+    kind: "explanation";
+    explanation: string;
+}
+export type FormLayoutNode = FormLayoutSectionNode | FormLayoutGroupNode | FormLayoutFieldNode | FormLayoutReportNode | FormLayoutExplanationNode;
+export interface SinglePageLayoutConfig {
+    kind?: "single-page";
+    children?: FormLayoutNode[];
+}
+export interface WizardStepConfig {
+    id?: string;
+    title: string;
+    description?: string;
+    children: FormLayoutNode[];
+}
+export interface WizardLayoutConfig {
+    kind: "wizard";
+    steps: WizardStepConfig[];
+}
+export interface TabLayoutConfig {
+    id?: string;
+    title: string;
+    description?: string;
+    children: FormLayoutNode[];
+}
+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 interface ResolvedFormLayoutSectionNode {
+    kind: "section";
+    id: string;
+    title?: string;
+    description?: string;
+    children: ResolvedFormLayoutNode[];
+}
+export interface ResolvedFormLayoutGroupNode {
+    kind: "group";
+    id: string;
+    columns?: 1 | 2 | 3;
+    children: ResolvedFormLayoutNode[];
+}
+export interface ResolvedFormLayoutFieldNode {
+    kind: "field";
+    field: string;
+}
+export interface ResolvedFormLayoutReportNode {
+    kind: "report";
+    report: string;
+}
+export interface ResolvedFormLayoutExplanationNode {
+    kind: "explanation";
+    explanation: string;
+}
+export type ResolvedFormLayoutNode = ResolvedFormLayoutSectionNode | ResolvedFormLayoutGroupNode | ResolvedFormLayoutFieldNode | ResolvedFormLayoutReportNode | ResolvedFormLayoutExplanationNode;
+export interface ResolvedSinglePageLayout {
+    kind: "single-page";
+    children: ResolvedFormLayoutNode[];
+}
+export interface ResolvedWizardStep {
+    id: string;
+    title: string;
+    description?: string;
+    children: ResolvedFormLayoutNode[];
+}
+export interface ResolvedWizardLayout {
+    kind: "wizard";
+    steps: ResolvedWizardStep[];
+}
+export interface ResolvedTabLayout {
+    id: string;
+    title: string;
+    description?: string;
+    children: ResolvedFormLayoutNode[];
+}
+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;

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

@@ -0,0 +1,9 @@
+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[];
+export declare const collectLayoutReferences: (layout: ResolvedFormLayout) => LayoutReferences;

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

@@ -0,0 +1,8 @@
+import { ExplanationController, 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;

package/dist/types/src/kit/mount-types.d.ts

@@ -0,0 +1,54 @@
+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';
+export interface KitDesignSystemSnapshot extends Omit<DesignSystemConfig, "mode" | "theme" | "recipe"> {
+    mode: NonNullable<DesignSystemConfig["mode"]>;
+    theme: NonNullable<DesignSystemConfig["theme"]>;
+    recipe: NonNullable<DesignSystemConfig["recipe"]>;
+}
+export interface KitLabels {
+    form?: string;
+    reports?: string;
+    submit?: string;
+    validating?: string;
+    submitting?: string;
+}
+export interface MountFormOptions {
+    schema: FormSchema;
+    transport: Transport;
+    registry?: Registry;
+    presentationRegistry?: PresentationRegistry;
+    primitiveRegistry?: PrimitiveRegistry;
+    designSystemRegistry?: DesignSystemRegistry;
+    designSystem?: DesignSystemConfig;
+    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?: PrimitiveLayout;
+    containerStrategy?: PrimitiveContainerStrategy;
+    reportPane?: "auto" | "always" | "hidden";
+    reportTransport?: PrimitiveReportTransport;
+    labels?: KitLabels;
+    primitiveText?: PrimitiveTextOverrides;
+    onDesignSystemChange?: (resolved: ResolvedDesignSystem) => void;
+}
+export interface MountedForm {
+    readonly form: FormController;
+    readonly host: HTMLElement;
+    readonly engineRegistry: Registry;
+    readonly presentationRegistry: PresentationRegistry;
+    readonly primitiveRegistry: PrimitiveRegistry;
+    readonly designSystemRegistry: DesignSystemRegistry;
+    readonly designSystem: AttachedDesignSystem;
+    updateDesignSystem(config: DesignSystemConfig): void;
+    replaceDesignSystem(config: KitDesignSystemSnapshot): void;
+    resetDesignSystem(): void;
+    unmount(): void;
+}

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

@@ -0,0 +1,9 @@
+export interface PanelState {
+    kind: "wizard-step" | "tab" | "accordion-section";
+    index: number;
+    count: number;
+    currentId: string;
+    canGoNext: boolean;
+    canGoPrev: boolean;
+}
+export declare const createIndexedPanelState: (kind: PanelState["kind"], index: number, ids: readonly string[]) => PanelState | null;

package/dist/types/src/{questionnaire/primitives/components → kit}/step-indicator.d.ts

@@ -1,6 +1,6 @@
 import { LitElement } from 'lit';
-import { questionnaireTagNames } from '../../constants';
-export declare class QuestionnaireStepIndicatorElement extends LitElement {
+import { kitTagNames } from './constants';
+export declare class KitStepIndicatorElement extends LitElement {
     static styles: import('lit').CSSResult;
     accessor current: number;
     accessor total: number;
@@ -9,6 +9,6 @@ export declare class QuestionnaireStepIndicatorElement extends LitElement {
 }
 declare global {
     interface HTMLElementTagNameMap {
-        [questionnaireTagNames.stepIndicator]: QuestionnaireStepIndicatorElement;
+        [kitTagNames.stepIndicator]: KitStepIndicatorElement;
     }
 }

package/dist/types/src/kit/tabs-root-styles.d.ts

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

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

@@ -0,0 +1,24 @@
+import { LitElement } from 'lit';
+import { PrimitiveText } from '../../primitives/constants';
+import { PrimitiveRegistry } from '../../primitives/types';
+import { kitTagNames } from './constants';
+import { FormViewController } from './types';
+export declare class KitTabsElement extends LitElement {
+    #private;
+    static styles: import('lit').CSSResult;
+    accessor view: FormViewController | undefined;
+    accessor registry: PrimitiveRegistry | undefined;
+    accessor primitiveText: PrimitiveText;
+    accessor submitLabel: string;
+    accessor validatingLabel: string;
+    accessor submittingLabel: string;
+    private accessor snapshot;
+    protected willUpdate(changed: Map<string, unknown>): void;
+    disconnectedCallback(): void;
+    render(): import('lit').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        [kitTagNames.tabs]: KitTabsElement;
+    }
+}

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

@@ -0,0 +1,2 @@
+import { MountTabsFormOptions, MountedTabsForm } from './types';
+export declare const mountTabsForm: (container: HTMLElement, options: MountTabsFormOptions) => MountedTabsForm;

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

@@ -1,52 +1,5 @@
-import { AttachedDesignSystem, DesignSystemConfig, DesignSystemRegistry, ResolvedDesignSystem } from '../../design-system';
-import { FormController, FormHooks, FormSchema, FormValidator, InactiveFieldPolicy, Registry, Transport } from '../../engine';
-import { PrimitiveContainerStrategy, PrimitiveLayout, PrimitiveRegistry, PrimitiveReportTransport, PrimitiveTextOverrides } from '../../primitives';
+export type { FormLayoutNode, FormLayoutSectionNode, FormLayoutGroupNode, FormLayoutFieldNode, FormLayoutReportNode, FormLayoutExplanationNode, SinglePageLayoutConfig, WizardStepConfig, WizardLayoutConfig, TabLayoutConfig, TabsLayoutConfig, AccordionSectionConfig, AccordionLayoutConfig, FormLayoutConfig, ResolvedFormLayoutNode, ResolvedFormLayoutSectionNode, ResolvedFormLayoutGroupNode, ResolvedFormLayoutFieldNode, ResolvedFormLayoutReportNode, ResolvedFormLayoutExplanationNode, ResolvedSinglePageLayout, ResolvedWizardStep, ResolvedWizardLayout, ResolvedTabLayout, ResolvedTabsLayout, ResolvedAccordionSection, ResolvedAccordionLayout, ResolvedFormLayout, } from './layout-types';
+export type { KitDesignSystemSnapshot, KitLabels, MountFormOptions, MountedForm, } from './mount-types';
+export type { WizardState, TabsState, AccordionState, FormViewFieldItem, FormViewReportItem, FormViewExplanationItem, FormViewState, FormViewSnapshot, CreateFormViewOptions, FormViewController, WizardMountUiOptions, MountWizardFormOptions, MountedWizardForm, TabsMountUiOptions, MountTabsFormOptions, MountedTabsForm, AccordionMountUiOptions, MountAccordionFormOptions, MountedAccordionForm, LayoutReferences, PanelState, } from './view-types';
+export type { WizardLabels, WizardTextOverrides } from './wizard-constants';
 export type { ApiKeyAuthOptions, AuthOptions, BearerAuthOptions, CacheOptions, CapabilityRequirement, CircuitBreakerOptions, CircuitBreakerSharedState, CircuitBreakerStateSnapshot, CustomAuthOptions, DedupOptions, FanoutTransportFailure, FanoutTransportOptions, FanoutTransportResult, FallbackTransportFailure, FallbackTransportOptions, GraphqlTransportOptions, GrpcSessionTransportOptions, GrpcStreamTransportOptions, GrpcTransportOptions, GrpcUnaryTransportOptions, HedgedTransportOptions, JsonTransportMethod, JsonTransportOptions, LoadBalancingTransportOptions, PipelineStage, PipelineTransportOptions, QuorumFanoutTransportOptions, RateLimitLeaseRequest, RateLimitOptions, RacingTransportOptions, RetryOptions, RoutingTransportOptions, SessionTransportOptions, SharedRateLimiter, SharedRateLimiterLease, SseTransportOptions, TransportCacheEntry, TransportCacheStore, TransportCollection, TransportContextAuthOptions, TransportHealthSnapshot, TransportHealthState, TransportLogOptions, TransportMetricsOptions, TransportMiddleware, TransportTelemetryEvent, TransportTraceOptions, WebSocketSessionTransportOptions, WeightedRoutingTransportOptions, } from '../../transport';
-export interface KitDesignSystemSnapshot extends Omit<DesignSystemConfig, "mode" | "theme" | "recipe"> {
-    mode: NonNullable<DesignSystemConfig["mode"]>;
-    theme: NonNullable<DesignSystemConfig["theme"]>;
-    recipe: NonNullable<DesignSystemConfig["recipe"]>;
-}
-export interface KitLabels {
-    form?: string;
-    reports?: string;
-    submit?: string;
-    validating?: string;
-    submitting?: string;
-}
-export interface MountFormOptions {
-    schema: FormSchema;
-    transport: Transport;
-    registry?: Registry;
-    primitiveRegistry?: PrimitiveRegistry;
-    designSystemRegistry?: DesignSystemRegistry;
-    designSystem?: DesignSystemConfig;
-    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?: PrimitiveLayout;
-    containerStrategy?: PrimitiveContainerStrategy;
-    reportPane?: "auto" | "always" | "hidden";
-    reportTransport?: PrimitiveReportTransport;
-    labels?: KitLabels;
-    primitiveText?: PrimitiveTextOverrides;
-    onDesignSystemChange?: (resolved: ResolvedDesignSystem) => void;
-}
-export interface MountedForm {
-    readonly form: FormController;
-    readonly host: HTMLElement;
-    readonly engineRegistry: Registry;
-    readonly primitiveRegistry: PrimitiveRegistry;
-    readonly designSystemRegistry: DesignSystemRegistry;
-    readonly designSystem: AttachedDesignSystem;
-    updateDesignSystem(config: DesignSystemConfig): void;
-    replaceDesignSystem(config: KitDesignSystemSnapshot): void;
-    resetDesignSystem(): void;
-    unmount(): void;
-}

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

@@ -0,0 +1,14 @@
+import { AccordionState, FormViewState, TabsState, WizardState, ResolvedFormLayout } from './types';
+type LayoutStateOptions = {
+    layout: ResolvedFormLayout;
+    stepIndex: number;
+    activeTabIndex: number;
+    openSectionIds: Set<string>;
+    formState: FormViewState["form"];
+};
+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 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 {};

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

@@ -0,0 +1,8 @@
+import { FormController } from '../../runtime';
+import { ResolvedLayoutResult } from './layout';
+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 {
+    id: string;
+}[], sectionId: string) => void;
+export declare const assertAccordionLayout: (resolvedLayout: ResolvedLayoutResult) => void;

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

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

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

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