mlform 0.1.14 → 0.1.16

package/dist/types/src/builtins/definitions/fields/series-helpers.d.ts

@@ -40,6 +40,7 @@ export declare const seriesFieldSchema: z.ZodObject<{
         "reset-on-hide": "reset-on-hide";
     }>>;
     includeInSubmission: z.ZodOptional<z.ZodBoolean>;
+    displayKey: z.ZodOptional<z.ZodString>;
     mappedTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>]>>;
     valuePath: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     defaultValue: z.ZodOptional<z.ZodUnknown>;

package/dist/types/src/builtins/definitions/shared.d.ts

@@ -22,6 +22,7 @@ export declare const baseFieldShape: {
         "reset-on-hide": "reset-on-hide";
     }>>;
     includeInSubmission: z.ZodOptional<z.ZodBoolean>;
+    displayKey: z.ZodOptional<z.ZodString>;
     mappedTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>]>>;
     valuePath: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     defaultValue: z.ZodOptional<z.ZodUnknown>;

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

@@ -2,6 +2,7 @@ import { AttachedDesignSystem, DesignSystemConfig, DesignSystemRegistry, Resolve
 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 type MountedReportFetchMode = "lazy" | "all" | "none";
 export interface KitDesignSystemSnapshot extends Omit<DesignSystemConfig, "mode" | "theme" | "recipe"> {
     mode: NonNullable<DesignSystemConfig["mode"]>;
     theme: NonNullable<DesignSystemConfig["theme"]>;
@@ -35,6 +36,7 @@ export interface MountFormOptions {
     layout?: FormLayoutConfig;
     containerStrategy?: PrimitiveContainerStrategy;
     reportPane?: "auto" | "always" | "hidden";
+    reportFetchMode?: MountedReportFetchMode;
     reportTransport?: PrimitiveReportTransport;
     labels?: KitLabels;
     primitiveText?: PrimitiveTextOverrides;

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

@@ -1,8 +1,9 @@
 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 { FieldController, FieldStateSnapshot, FormController, FormHooks, FormSchema, FormState, FormValidationResult, FormValidator, InactiveFieldPolicy, Registry, ReportController, ReportStateSnapshot, RuntimeBehavior, PipelineResult, SubmitOptions, SubmitResult, Transport } from '../../runtime';
 import { LayoutReferences } from './layout-utils';
 import { FormLayoutConfig, ResolvedFormLayout, ResolvedFormLayoutNode } from './layout-types';
 import { PanelState } from './panel-nav';
+import { MountedReportFetchMode } from './mount-types';
 export interface WizardState {
     stepIndex: number;
     stepCount: number;
@@ -77,6 +78,7 @@ export interface CreateFormViewOptions {
     listenerErrorPolicy?: "ignore" | "throw-aggregate";
     onListenerError?: (error: unknown) => void;
     layout?: FormLayoutConfig;
+    reportFetchMode?: MountedReportFetchMode;
 }
 export interface FormViewController {
     readonly form: FormController;
@@ -93,6 +95,7 @@ export interface FormViewController {
     getLayoutReferences(): LayoutReferences;
     validate(): Promise<FormValidationResult>;
     submit(options?: SubmitOptions): Promise<SubmitResult>;
+    submitPipeline(options?: SubmitOptions): Promise<PipelineResult>;
     reset(): void;
     subscribe(listener: (snapshot: FormViewSnapshot) => void): () => void;
     nextStep(): Promise<boolean>;

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

@@ -2,7 +2,7 @@ import { TemplateResult } from 'lit';
 import { PrimitiveFormController } from '../controller-types';
 import { PrimitiveDescriptorRegistry } from '../descriptors';
 import { PrimitiveText } from '../constants';
-import { PrimitiveRegistry, PrimitiveReportTransport } from '../types';
+import { PrimitiveRegistry, PrimitiveReportFetchMode, PrimitiveReportTransport } from '../types';
 import { FormRenderState } from './form-root-state';
 import { PresentedField, PresentedReport } from './form-root-presenters';
 export declare const renderStackedLayout: (options: {
@@ -20,6 +20,7 @@ export declare const renderStackedLayout: (options: {
     validatingLabel: string;
     submittingLabel: string;
     reportTransport: PrimitiveReportTransport | undefined;
+    reportFetchMode: PrimitiveReportFetchMode;
     onSubmitRequest: () => Promise<void>;
 }) => TemplateResult;
 export declare const renderSplitLayout: (options: {
@@ -37,5 +38,6 @@ export declare const renderSplitLayout: (options: {
     validatingLabel: string;
     submittingLabel: string;
     reportTransport: PrimitiveReportTransport | undefined;
+    reportFetchMode: PrimitiveReportFetchMode;
     onSubmitRequest: () => Promise<void>;
 }) => TemplateResult;

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

@@ -2,7 +2,7 @@ import { LitElement } from 'lit';
 import { PrimitiveDescriptorRegistry } from '../descriptors';
 import { PrimitiveFormController } from '../controller-types';
 import { primitiveTagNames, PrimitiveText } from '../constants';
-import { PrimitiveLayout, PrimitiveRegistry, PrimitiveReportTransport } from '../types';
+import { PrimitiveLayout, PrimitiveRegistry, PrimitiveReportTransport, PrimitiveReportFetchMode, PrimitiveSubmitExecutionResult } from '../types';
 export declare class PrimitiveFormElement extends LitElement {
     #private;
     static styles: import('lit').CSSResult;
@@ -18,6 +18,8 @@ export declare class PrimitiveFormElement extends LitElement {
     accessor reportPane: "auto" | "always" | "hidden";
     accessor text: PrimitiveText;
     accessor reportTransport: PrimitiveReportTransport | undefined;
+    accessor reportFetchMode: PrimitiveReportFetchMode;
+    accessor submitHandler: (() => Promise<PrimitiveSubmitExecutionResult>) | undefined;
     private accessor formState;
     protected willUpdate(changedProperties: Map<string, unknown>): void;
     connectedCallback(): void;

package/dist/types/src/primitives/components/report-frame.d.ts

@@ -2,7 +2,7 @@ import { LitElement } from 'lit';
 import { PrimitiveReportController, PrimitiveSubmitResult } from '../controller-types';
 import { ReportDescriptor } from '../descriptors';
 import { primitiveTagNames, PrimitiveText } from '../constants';
-import { PrimitiveReportTransport, PrimitiveRegistry } from '../types';
+import { PrimitiveReportFetchMode, PrimitiveReportTransport, PrimitiveRegistry } from '../types';
 export declare class PrimitiveReportFrameElement extends LitElement {
     #private;
     static styles: import('lit').CSSResult;
@@ -10,6 +10,7 @@ export declare class PrimitiveReportFrameElement extends LitElement {
     accessor registry: PrimitiveRegistry | undefined;
     accessor text: PrimitiveText;
     accessor transport: PrimitiveReportTransport | undefined;
+    accessor fetchMode: PrimitiveReportFetchMode;
     accessor lastResult: PrimitiveSubmitResult | null;
     accessor descriptor: ReportDescriptor | null;
     private accessor resolvedDescriptor;

package/dist/types/src/primitives/controller-types.d.ts

@@ -18,15 +18,50 @@ export interface PrimitiveReportStateSnapshot {
 }
 export interface PrimitiveSubmitResult {
     backend?: string;
+    inputs?: PrimitiveSubmissionInputRecord[];
+    displayValues?: Record<string, unknown>;
+    modelValues?: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;
     serializedFieldValues: Record<string, unknown>;
     reports: Record<string, unknown>;
+    reportContexts?: Record<string, PrimitiveReportContext>;
     reportStates: Record<string, unknown>;
     meta: Record<string, unknown>;
     raw: unknown;
 }
+export interface PrimitivePipelineResult {
+    submitResult: PrimitiveSubmitResult;
+    reportFetchResults: Record<string, unknown>;
+    reportFetchErrors: Record<string, string>;
+    artifacts: Record<string, unknown>;
+}
+export interface PrimitiveSubmissionInputRecord {
+    fieldId: string;
+    displayKey?: string;
+    label: string;
+    value: unknown;
+    serializedValue: unknown;
+    mappedTo?: string | number;
+    modelValues: Record<string, unknown>;
+    visible: boolean;
+    disabled: boolean;
+}
+export interface PrimitiveReportContext {
+    reportId: string;
+    kind: string;
+    label?: string;
+    mappedTo?: unknown;
+    target?: string | number;
+    targetKey?: string;
+    backend?: string;
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
+    reports: Record<string, unknown>;
+    meta: Record<string, unknown>;
+    raw: unknown;
+}
 export interface PrimitiveFormState {
     status: PrimitiveFormStatus;
     submitCount: number;
@@ -78,14 +113,23 @@ export interface PrimitiveFormController {
         equality?: (left: T, right: T) => boolean;
     }): () => void;
 }
+export interface PrimitiveSubmitExecutionResult {
+    result: PrimitiveSubmitResult;
+    pipelineResult?: PrimitivePipelineResult;
+}
 export interface PrimitiveReportRequest {
     reportId: string;
     backend?: string;
+    inputs?: PrimitiveSubmissionInputRecord[];
+    displayValues?: Record<string, unknown>;
+    modelValues?: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;
     serializedFieldValues: Record<string, unknown>;
     reports: Record<string, unknown>;
+    reportContext?: PrimitiveReportContext;
+    reportContexts?: Record<string, PrimitiveReportContext>;
     meta: Record<string, unknown>;
     raw: unknown;
     signal?: AbortSignal;

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

@@ -1,9 +1,10 @@
-import { PrimitiveFieldController, PrimitiveFormController, PrimitiveFormStatus, PrimitiveReportRequest, PrimitiveReportController, PrimitiveSubmitResult, PrimitiveFormState } from './controller-types';
+import { PrimitiveFieldController, PrimitiveFormController, PrimitiveFormStatus, PrimitivePipelineResult, PrimitiveReportRequest, PrimitiveReportController, PrimitiveSubmitResult, PrimitiveSubmitExecutionResult, PrimitiveFormState } from './controller-types';
 import { PrimitiveText, PrimitiveTextOverrides } from './constants';
 import { FieldDescriptor, PrimitiveDescriptorRegistry, ReportDescriptor } from './descriptors';
 export type PrimitiveLayout = "stacked" | "split";
 export type PrimitiveContainerStrategy = "error" | "replace";
-export type { PrimitiveReportRequest };
+export type PrimitiveReportFetchMode = "lazy" | "all" | "none";
+export type { PrimitivePipelineResult, PrimitiveReportRequest, PrimitiveSubmitExecutionResult };
 export interface PrimitiveRegistry {
     registerField(component: string, tagName: string): PrimitiveRegistry;
     unregisterField(component: string): PrimitiveRegistry;
@@ -35,6 +36,8 @@ export interface MountFormOptions {
     text?: PrimitiveTextOverrides;
     /** Optional transport for report renderers that fetch extra data after submit. */
     reportTransport?: PrimitiveReportTransport;
+    reportFetchMode?: PrimitiveReportFetchMode;
+    submitHandler?: () => Promise<PrimitiveSubmitExecutionResult>;
 }
 export interface MountedForm {
     readonly form: PrimitiveFormController;
@@ -84,6 +87,7 @@ export interface PrimitiveSubmitSuccessDetail {
     form: PrimitiveFormController;
     state: PrimitiveFormState;
     result: PrimitiveSubmitResult;
+    pipelineResult?: PrimitivePipelineResult;
 }
 export interface PrimitiveSubmitErrorDetail {
     form: PrimitiveFormController;

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

@@ -1,10 +1,12 @@
-export { executeFormPipeline, executeReportFetches } from './submission';
+export { createSubmissionSnapshot, executeFormPipeline, executeReportFetches } from './submission';
+export { createMultiBackendSubmissionSnapshot, executeMultiBackendPipeline } from './submission';
+export type { CreateMultiBackendSubmissionSnapshotOptions, CreateSubmissionSnapshotOptions, ExecuteMultiBackendPipelineOptions, MultiBackendPipelineResult, MultiBackendRunResult, MultiBackendSubmit, SubmissionSnapshot, } from './submission';
 export { EngineError, ReportPayloadError, RegistryError, SubmissionAbortedError, SubmitError, TransportError, transportErrorCodes, ValidationError, } from './errors';
 export type { TransportErrorCode } from './errors';
 export { createForm, createForm as createFormRuntime } from './form';
 export { defaultEquality, shallowArrayEquality, shallowEquality, shallowObjectEquality, } from './equality';
 export { identity, isPromiseLike } from './utils';
-export type { AllConditions, AfterSubmitContext, AfterValidateContext, AnyConditions, BaseFieldConfig, BaseReportConfig, BeforeSubmitContext, BeforeValidateContext, CreateFormConfig, DeclarativeFieldCondition, AfterReportFetchContext, FieldValidationFnContext, FieldValueAdapter, FieldConfig, FieldComparisonCondition, FieldCondition, FieldConditionContext, FieldController, FieldDefinition, FieldStateSnapshot, FieldStatus, FieldValueCondition, FieldValidationContext, FieldValidationResult, FormController, FormHooks, FormSchema, FormState, FormStatusCondition, FormStatus, FormValidator, FormValidationContext, FormValidationIssue, FormValidationResult, InactiveFieldPolicy, MaybePromise, NormalizedFieldConfig, NormalizedReportConfig, Registry, ReportConfig, ReportController, ReportDefinition, ReportFetchContext, ReportFetchErrorContext, ReportFetchExecutionContext, ReportFetchExecutionResult, ReportFetchFactory, ReportFetchRequest, ReportFetchStatus, ReportFetchTransport, ReportResolveContext, ReportStateSnapshot, ReportStatus, PipelineArtifactAdapter, PipelineArtifactContext, PipelineResult, ExecuteFormPipelineOptions, SelectorSubscriptionOptions, SubmitCountCondition, SubmitErrorContext, SubmitOptions, SubmitRequest, SubmitRequestTransportContext, SubmitResult, Transport, TransportAuthKind, TransportBackpressureMode, TransportCapabilities, TransportConsistency, TransportDeliveryMode, TransportPolicyContext, TransportSession, TransportSessionEvent, TransportSessionMessage, TransportStreamEvent, TransportResponse, NotCondition, RuntimeBehavior, RuntimeBehaviorContext, RuntimeBehaviorSubmissionRecords, RuntimeBehaviorValueChangeEvent, } from './types';
+export type { AllConditions, AfterSubmitContext, AfterValidateContext, AnyConditions, BaseFieldConfig, BaseReportConfig, BeforeSubmitContext, BeforeValidateContext, CreateFormConfig, DeclarativeFieldCondition, AfterReportFetchContext, FieldValidationFnContext, FieldValueAdapter, FieldConfig, FieldComparisonCondition, FieldCondition, FieldConditionContext, FieldController, FieldDefinition, FieldStateSnapshot, FieldStatus, FieldValueCondition, FieldValidationContext, FieldValidationResult, FormController, FormHooks, FormSchema, FormState, FormStatusCondition, FormStatus, FormValidator, FormValidationContext, FormValidationIssue, FormValidationResult, InactiveFieldPolicy, MaybePromise, NormalizedFieldConfig, NormalizedReportConfig, Registry, ReportConfig, ReportController, ReportDefinition, ReportFetchContext, ReportFetchErrorContext, ReportFetchExecutionContext, ReportFetchExecutionResult, ReportFetchFactory, ReportFetchRequest, ReportFetchStatus, ReportFetchTransport, ReportResolveContext, ReportStateSnapshot, ReportStatus, PipelineArtifactAdapter, PipelineArtifactContext, PipelineResult, ExecuteFormPipelineOptions, SelectorSubscriptionOptions, SubmitCountCondition, SubmitErrorContext, SubmitOptions, SubmitRequest, SubmitRequestTransportContext, SubmitResult, SubmissionInputRecord, Transport, TransportAuthKind, TransportBackpressureMode, TransportCapabilities, TransportConsistency, TransportDeliveryMode, TransportPolicyContext, TransportSession, TransportSessionEvent, TransportSessionMessage, TransportStreamEvent, TransportResponse, NotCondition, RuntimeBehavior, RuntimeBehaviorContext, RuntimeBehaviorSubmissionRecords, RuntimeBehaviorValueChangeEvent, } from './types';
 export type FieldHandle = import('./types').FieldController;
 export type ReportHandle = import('./types').ReportController;
 export type FormRuntime = import('./types').FormController;

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

@@ -1,5 +1,7 @@
 export * from './pipeline';
+export * from './multi-backend';
 export * from './report-fetches';
 export * from './request';
 export * from './reports';
+export * from './snapshot';
 export * from './submitter';

package/dist/types/src/runtime/submission/multi-backend.d.ts

@@ -0,0 +1,25 @@
+import { FormController, SubmitResult } from '../types';
+import { SubmissionSnapshot } from './snapshot';
+export interface MultiBackendSubmit {
+    backend: string;
+    signal?: AbortSignal;
+}
+export interface MultiBackendRunResult {
+    backend: string;
+    snapshot: SubmissionSnapshot;
+    submitResult?: SubmitResult;
+    reportFetchResults: Record<string, unknown>;
+    reportFetchErrors: Record<string, string>;
+    skippedReportIds: string[];
+    error?: unknown;
+}
+export interface ExecuteMultiBackendPipelineOptions {
+    form: FormController;
+    backends: readonly (string | MultiBackendSubmit)[];
+    reportFetchMode?: "none" | "all";
+    continueOnError?: boolean;
+}
+export interface MultiBackendPipelineResult {
+    runs: Record<string, MultiBackendRunResult>;
+}
+export declare const executeMultiBackendPipeline: ({ form, backends, reportFetchMode, continueOnError, }: ExecuteMultiBackendPipelineOptions) => Promise<MultiBackendPipelineResult>;

package/dist/types/src/runtime/submission/request.d.ts

@@ -9,7 +9,21 @@ type SubmissionField = {
     };
     serialize(): unknown;
 };
+export type SubmissionInputRecord = {
+    fieldId: string;
+    displayKey?: string;
+    label: string;
+    value: unknown;
+    serializedValue: unknown;
+    mappedTo?: string | number;
+    modelValues: Record<string, unknown>;
+    visible: boolean;
+    disabled: boolean;
+};
 export type SubmissionValueRecords = {
+    inputs: SubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;

package/dist/types/src/runtime/submission/snapshot.d.ts

@@ -0,0 +1,12 @@
+import { FormController, InactiveFieldPolicy } from '../types';
+import { SubmissionValueRecords } from './request';
+export interface CreateSubmissionSnapshotOptions {
+    backend?: string;
+    inactiveFieldPolicy?: InactiveFieldPolicy;
+}
+export type SubmissionSnapshot = SubmissionValueRecords;
+export declare const createSubmissionSnapshot: (form: Pick<FormController, "fields">, options?: CreateSubmissionSnapshotOptions) => SubmissionSnapshot;
+export interface CreateMultiBackendSubmissionSnapshotOptions extends Omit<CreateSubmissionSnapshotOptions, "backend"> {
+    backends: readonly string[];
+}
+export declare const createMultiBackendSubmissionSnapshot: (form: Pick<FormController, "fields">, options: CreateMultiBackendSubmissionSnapshotOptions) => Record<string, SubmissionSnapshot>;

package/dist/types/src/runtime/types/behavior.d.ts

@@ -1,4 +1,5 @@
 import { Registry } from '../../../schema';
+import { SubmissionInputRecord } from '../../../transport';
 import { FieldHandle } from './field';
 import { FormStatus } from './form';
 type MaybePromise<T> = T | PromiseLike<T>;
@@ -8,6 +9,9 @@ export interface RuntimeBehaviorValueChangeEvent {
     values: Record<string, unknown>;
 }
 export interface RuntimeBehaviorSubmissionRecords {
+    inputs: SubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;

package/dist/types/src/runtime/types/field.d.ts

@@ -8,6 +8,7 @@ export interface FieldHandle {
     setValue(value: unknown): void;
     blur(): void;
     focus(): void;
+    serialize(): unknown;
     validate(): Promise<FieldValidationResult>;
     reset(): void;
     subscribe(listener: (state: FieldStateSnapshot) => void): () => void;

package/dist/types/src/runtime/types/form.d.ts

@@ -100,6 +100,10 @@ export interface FormController {
     readonly reports: readonly ReportController[];
     readonly state: FormState;
     getField(id: string): FieldController | undefined;
+    getFieldByDisplayKey(displayKey: string): FieldController | undefined;
+    getFieldByMappedTo(target: string | number, options?: {
+        backend?: string;
+    }): FieldController | undefined;
     getReport(id: string): ReportController | undefined;
     getValues(): Record<string, unknown>;
     setValues(values: Record<string, unknown>): void;

package/dist/types/src/runtime/types/transport.d.ts

@@ -1,8 +1,8 @@
-import { SubmitRequest as BaseSubmitRequest, Transport as BaseTransport, TransportStreamEvent as BaseTransportStreamEvent } from '../../../transport';
+import { SubmitRequest as BaseSubmitRequest, Transport as BaseTransport, SubmissionInputRecord, TransportStreamEvent as BaseTransportStreamEvent } from '../../../transport';
 import { SubmitResult as SchemaSubmitResult } from '../../../schema';
 import { NormalizedFieldConfig } from './field';
 import { NormalizedReportConfig, ReportStateSnapshot } from './report';
-export type { CapabilityRequirement, CircuitBreakerSharedState, CircuitBreakerStateSnapshot, RateLimitLeaseRequest, SharedRateLimiter, SharedRateLimiterLease, SubmitRequestMetadata, SubmitRequestTransportContext, TransportAuthKind, TransportBackpressureMode, TransportCacheEntry, TransportCacheStore, TransportCapabilities, TransportCollection, TransportConsistency, TransportDeliveryMode, TransportHealthSnapshot, TransportHealthState, TransportPolicyContext, TransportResponse, TransportSession, TransportSessionCloseEvent, TransportSessionErrorEvent, TransportSessionEvent, TransportSessionMessage, TransportSessionMessageEvent, TransportSessionMetaEvent, TransportSessionProgressEvent, TransportSessionResultEvent, TransportStreamChunkEvent, TransportStreamErrorEvent, TransportStreamMetaEvent, TransportStreamProgressEvent, TransportStreamReportPatchEvent, TransportStreamReportReplaceEvent, } from '../../../transport';
+export type { CapabilityRequirement, CircuitBreakerSharedState, CircuitBreakerStateSnapshot, RateLimitLeaseRequest, SharedRateLimiter, SharedRateLimiterLease, SubmissionInputRecord, SubmitRequestMetadata, SubmitRequestTransportContext, TransportAuthKind, TransportBackpressureMode, TransportCacheEntry, TransportCacheStore, TransportCapabilities, TransportCollection, TransportConsistency, TransportDeliveryMode, TransportHealthSnapshot, TransportHealthState, TransportPolicyContext, TransportResponse, TransportSession, TransportSessionCloseEvent, TransportSessionErrorEvent, TransportSessionEvent, TransportSessionMessage, TransportSessionMessageEvent, TransportSessionMetaEvent, TransportSessionProgressEvent, TransportSessionResultEvent, TransportStreamChunkEvent, TransportStreamErrorEvent, TransportStreamMetaEvent, TransportStreamProgressEvent, TransportStreamReportPatchEvent, TransportStreamReportReplaceEvent, } from '../../../transport';
 export type SubmitRequest = BaseSubmitRequest<NormalizedFieldConfig, NormalizedReportConfig>;
 export type SubmitResult = SchemaSubmitResult<ReportStateSnapshot>;
 export type Transport = BaseTransport<NormalizedFieldConfig, NormalizedReportConfig>;
@@ -13,6 +13,9 @@ export interface SubmitOptions {
 }
 export interface BeforeSubmitContext {
     backend?: string;
+    inputs: SubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;
@@ -22,6 +25,9 @@ export interface BeforeSubmitContext {
 }
 export interface AfterSubmitContext {
     backend?: string;
+    inputs: SubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;
@@ -31,6 +37,9 @@ export interface AfterSubmitContext {
 }
 export interface SubmitErrorContext {
     backend?: string;
+    inputs: SubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;

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

@@ -1,6 +1,8 @@
 export { normalizeSchemaId } from './ids';
 export * from './mapped-to';
 export * from './normalize';
+export * from './onehot-display';
+export * from './report-context';
 export { createReportFetchRequest } from './report-fetch-request';
 export * from './registry';
 export type * from './types/field';

package/dist/types/src/schema/mapped-to.d.ts

@@ -1,11 +1,19 @@
 export type MappedToTarget = string | number;
 export type MappedTo = MappedToTarget | Record<string, MappedToTarget | null | undefined>;
+export type ReportPayloadAliasOptions = {
+    aliases?: readonly MappedToTarget[];
+    onAlias?: (alias: MappedToTarget, target: MappedToTarget) => void;
+};
 export declare const resolveMappedTo: (mappedTo: MappedTo | undefined, backend: string | undefined) => MappedToTarget | undefined;
 export declare const mappedToKey: (target: MappedToTarget) => string;
+export declare class MissingReportMappedToError extends Error {
+    constructor();
+}
 export declare const resolveMappedReportPayload: (report: {
+    id?: string;
     mappedTo?: MappedTo;
 }, result: {
     backend?: string;
     reports: Record<string, unknown>;
     raw: unknown;
-}) => unknown;
+}, options?: ReportPayloadAliasOptions) => unknown;

package/dist/types/src/schema/onehot-display.d.ts

@@ -0,0 +1,15 @@
+import { MappedTo } from './mapped-to';
+export type OneHotDisplayOption = {
+    label?: string;
+    value: string;
+    mappedTo?: MappedTo;
+};
+export type OneHotDisplayField = {
+    id?: string;
+    kind?: string;
+    options?: readonly OneHotDisplayOption[];
+};
+export interface ResolveOneHotDisplayValueOptions {
+    backend?: string;
+}
+export declare const resolveOneHotDisplayValue: (field: OneHotDisplayField, modelValues: Record<string, unknown>, options?: ResolveOneHotDisplayValueOptions) => string | undefined;

package/dist/types/src/schema/report-context.d.ts

@@ -0,0 +1,17 @@
+import { MappedTo } from './mapped-to';
+import { NormalizedReportConfig } from './types/report';
+import { ReportContext, SubmitResult } from './types/submit';
+type ReportContextSource = Pick<SubmitResult, "backend"> & {
+    reportContexts?: Record<string, ReportContext>;
+};
+type ReportContextLookup = string | number | {
+    id?: string;
+    mappedTo?: MappedTo;
+    config?: {
+        id?: string;
+        mappedTo?: MappedTo;
+    };
+};
+export declare const createReportContexts: (reports: readonly NormalizedReportConfig[], result: Pick<SubmitResult, "backend" | "displayValues" | "modelValues" | "serializedValues" | "reports" | "meta" | "raw">) => Record<string, ReportContext>;
+export declare const getReportContext: (source: ReportContextSource, lookup: ReportContextLookup) => ReportContext | undefined;
+export {};

package/dist/types/src/schema/types/field.d.ts

@@ -20,6 +20,7 @@ export interface BaseFieldConfig {
     asyncValidationDebounceMs?: number;
     inactiveFieldPolicy?: InactiveFieldPolicy;
     includeInSubmission?: boolean;
+    displayKey?: string;
     mappedTo?: MappedTo;
     valuePath?: string | string[];
     defaultValue?: unknown;

package/dist/types/src/schema/types/report.d.ts

@@ -1,7 +1,7 @@
 import { ZodType } from 'zod';
 import { MaybePromise } from './field';
 import { MappedTo } from '../mapped-to';
-import { SubmitResult } from './submit';
+import { ReportContext, SubmitResult, SubmissionInputRecord } from './submit';
 export type ReportStatus = "idle" | "loading" | "ready" | "error";
 export type ReportFetchStatus = ReportStatus;
 export type ReportPayloadValidationPolicy = "report-error" | "fail-submit";
@@ -36,11 +36,16 @@ export interface ReportResolveContext<TConfig extends ReportConfig = ReportConfi
 export interface ReportFetchRequest {
     reportId: string;
     backend?: string;
+    inputs?: SubmissionInputRecord[];
+    displayValues?: Record<string, unknown>;
+    modelValues?: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;
     serializedFieldValues: Record<string, unknown>;
     reports: Record<string, unknown>;
+    reportContext?: ReportContext;
+    reportContexts?: Record<string, ReportContext>;
     meta: Record<string, unknown>;
     raw: unknown;
     signal?: AbortSignal;

package/dist/types/src/schema/types/submit.d.ts

@@ -1,10 +1,40 @@
+import { MappedTo } from '../mapped-to';
+export interface SubmissionInputRecord {
+    fieldId: string;
+    displayKey?: string;
+    label: string;
+    value: unknown;
+    serializedValue: unknown;
+    mappedTo?: string | number;
+    modelValues: Record<string, unknown>;
+    visible: boolean;
+    disabled: boolean;
+}
+export interface ReportContext {
+    reportId: string;
+    kind: string;
+    label?: string;
+    mappedTo?: MappedTo;
+    target?: string | number;
+    targetKey?: string;
+    backend?: string;
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
+    reports: Record<string, unknown>;
+    meta: Record<string, unknown>;
+    raw: unknown;
+}
 export interface SubmitResult<TReportState = unknown> {
     backend?: string;
+    inputs?: SubmissionInputRecord[];
+    displayValues?: Record<string, unknown>;
+    modelValues?: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;
     serializedFieldValues: Record<string, unknown>;
     reports: Record<string, unknown>;
+    reportContexts?: Record<string, ReportContext>;
     reportStates: Record<string, TReportState>;
     meta: Record<string, unknown>;
     raw: unknown;

package/dist/types/src/transport/types/core.d.ts

@@ -17,8 +17,22 @@ export interface SubmitRequestTransportContext {
 export interface SubmitRequestMetadata {
     estimatedPayloadBytes?: number;
 }
+export interface SubmissionInputRecord {
+    fieldId: string;
+    displayKey?: string;
+    label: string;
+    value: unknown;
+    serializedValue: unknown;
+    mappedTo?: string | number;
+    modelValues: Record<string, unknown>;
+    visible: boolean;
+    disabled: boolean;
+}
 export interface SubmitRequest<TField extends Record<string, unknown> = Record<string, unknown>, TReport extends Record<string, unknown> = Record<string, unknown>> {
     backend?: string;
+    inputs?: SubmissionInputRecord[];
+    displayValues?: Record<string, unknown>;
+    modelValues?: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;
@@ -36,6 +50,9 @@ export interface TransportResponse {
 }
 export interface SubmitResult<TReportState extends Record<string, unknown> = Record<string, unknown>> {
     backend?: string;
+    inputs?: SubmissionInputRecord[];
+    displayValues?: Record<string, unknown>;
+    modelValues?: Record<string, unknown>;
     values: Record<string, unknown>;
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mlform",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "private": false,
   "description": "Composable form generation utilities for machine learning backend integration",
   "keywords": [
@@ -52,31 +52,31 @@
   "type": "module",
   "exports": {
     "./kit": {
-      "types": "./dist/types/kit/index.d.ts",
+      "types": "./dist/types/src/kit/index.d.ts",
       "import": "./dist/mlform/kit.mjs"
     },
     "./runtime": {
-      "types": "./dist/types/runtime/index.d.ts",
+      "types": "./dist/types/src/runtime/index.d.ts",
       "import": "./dist/mlform/runtime.mjs"
     },
     "./schema": {
-      "types": "./dist/types/schema/index.d.ts",
+      "types": "./dist/types/src/schema/index.d.ts",
       "import": "./dist/mlform/schema.mjs"
     },
     "./builtins": {
-      "types": "./dist/types/builtins/index.d.ts",
+      "types": "./dist/types/src/builtins/index.d.ts",
       "import": "./dist/mlform/builtins.mjs"
     },
     "./transport": {
-      "types": "./dist/types/transport/index.d.ts",
+      "types": "./dist/types/src/transport/index.d.ts",
       "import": "./dist/mlform/transport.mjs"
     },
     "./primitives": {
-      "types": "./dist/types/primitives/index.d.ts",
+      "types": "./dist/types/src/primitives/index.d.ts",
       "import": "./dist/mlform/primitives.mjs"
     },
     "./design": {
-      "types": "./dist/types/design/index.d.ts",
+      "types": "./dist/types/src/design/index.d.ts",
       "import": "./dist/mlform/design.mjs"
     }
   },