mlform 0.1.9 → 0.1.11

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

@@ -1,7 +1,6 @@
-import { ExplanationConfig, FieldConfig, FieldStateSnapshot, FormSchema, InactiveFieldPolicy, NormalizedFieldConfig, NormalizedReportConfig, Registry, ReportConfig, ReportStateSnapshot, SelectorSubscriptionOptions } from '../../schema';
+import { FieldConfig, FieldStateSnapshot, FormSchema, InactiveFieldPolicy, NormalizedFieldConfig, NormalizedReportConfig, Registry, ReportConfig, ReportStateSnapshot, SelectorSubscriptionOptions } from '../../schema';
 import { RuntimeBehavior } from './behavior';
 import { AfterSubmitContext, BeforeSubmitContext, SubmitErrorContext, SubmitOptions, SubmitResult, Transport, TransportStreamEvent } from './transport';
-import { ExplanationController, ExplanationStateSnapshot } from './explanation';
 import { FieldController } from './field';
 import { ReportController } from './report';
 type MaybePromise<T> = T | PromiseLike<T>;
@@ -31,7 +30,6 @@ export interface FormState {
     touched: boolean;
     values: Record<string, unknown>;
     reportStates: Record<string, ReportStateSnapshot>;
-    explanationStates: Record<string, ExplanationStateSnapshot>;
     submissionProgress: SubmissionProgressState | null;
     errors: {
         form: string[];
@@ -63,13 +61,13 @@ export interface AfterValidateContext {
     result: FormValidationResult;
     submitCount: number;
 }
-export interface AfterExplanationContext {
-    explanationId: string;
+export interface AfterReportFetchContext {
+    reportId: string;
     kind: string;
-    result: unknown;
+    payload: unknown;
 }
-export interface ExplanationErrorContext {
-    explanationId: string;
+export interface ReportFetchErrorContext {
+    reportId: string;
     kind: string;
     error: unknown;
 }
@@ -79,8 +77,8 @@ export interface FormHooks {
     beforeSubmit?: (context: BeforeSubmitContext) => MaybePromise<void>;
     afterSubmit?: (context: AfterSubmitContext) => MaybePromise<void>;
     onSubmitError?: (context: SubmitErrorContext) => MaybePromise<void>;
-    afterExplanation?: (context: AfterExplanationContext) => MaybePromise<void>;
-    onExplanationError?: (context: ExplanationErrorContext) => MaybePromise<void>;
+    afterReportFetch?: (context: AfterReportFetchContext) => MaybePromise<void>;
+    onReportFetchError?: (context: ReportFetchErrorContext) => MaybePromise<void>;
 }
 export interface CreateFormConfig {
     schema: FormSchema;
@@ -100,11 +98,9 @@ export interface CreateFormConfig {
 export interface FormController {
     readonly fields: readonly FieldController[];
     readonly reports: readonly ReportController[];
-    readonly explanations: readonly ExplanationController[];
     readonly state: FormState;
     getField(id: string): FieldController | undefined;
     getReport(id: string): ReportController | undefined;
-    getExplanation(id: string): ExplanationController | undefined;
     getValues(): Record<string, unknown>;
     setValues(values: Record<string, unknown>): void;
     validate(): Promise<FormValidationResult>;
@@ -114,4 +110,4 @@ export interface FormController {
     subscribe(listener: (state: FormState) => void): () => void;
     subscribeSelector<TSelected>(selector: (state: FormState) => TSelected, listener: (selected: TSelected, state: FormState) => void, options?: SelectorSubscriptionOptions<TSelected>): () => void;
 }
-export type { ExplanationConfig, FieldConfig, FormSchema, Registry, ReportConfig };
+export type { FieldConfig, FormSchema, Registry, ReportConfig };

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

@@ -1,6 +1,5 @@
 export type MaybePromise<T> = T | PromiseLike<T>;
 export * from './behavior';
-export * from './explanation';
 export * from './field';
 export * from './form';
 export * from './pipeline';

package/dist/types/runtime/types/pipeline.d.ts

@@ -1,14 +1,14 @@
-import { ExplanationController, ExplanationFetchRequest } from './explanation';
 import { FormController } from './form';
+import { ReportController, ReportFetchRequest } from './report';
 import { SubmitOptions, SubmitResult } from './transport';
-export interface ExplanationExecutionResult {
+export interface ReportFetchExecutionResult {
     results: Record<string, unknown>;
     errors: Record<string, string>;
 }
 export interface PipelineArtifactContext {
     submitResult: SubmitResult;
-    explanationResults: Record<string, unknown>;
-    explanationErrors: Record<string, string>;
+    reportFetchResults: Record<string, unknown>;
+    reportFetchErrors: Record<string, string>;
 }
 export interface PipelineArtifactAdapter<TArtifacts extends Record<string, unknown> = {}> {
     derive(context: PipelineArtifactContext): TArtifacts | Promise<TArtifacts>;
@@ -17,15 +17,15 @@ export interface ExecuteFormPipelineOptions<TArtifacts extends Record<string, un
     form: FormController;
     submit?: SubmitOptions;
     artifactAdapter?: PipelineArtifactAdapter<TArtifacts>;
-    explanationMode?: "none" | "all";
+    reportFetchMode?: "none" | "all";
 }
 export interface PipelineResult<TArtifacts extends Record<string, unknown> = {}> {
     submitResult: SubmitResult;
-    explanationResults: Record<string, unknown>;
-    explanationErrors: Record<string, string>;
+    reportFetchResults: Record<string, unknown>;
+    reportFetchErrors: Record<string, string>;
     artifacts: TArtifacts;
 }
-export interface ExplanationExecutionContext {
-    explanations: readonly ExplanationController[];
-    request: ExplanationFetchRequest;
+export interface ReportFetchExecutionContext {
+    reports: readonly ReportController[];
+    request: ReportFetchRequest;
 }

package/dist/types/runtime/types/registry.d.ts

@@ -1,6 +1,5 @@
-import { ExplanationDefinition, FieldDefinition, Registry as SchemaRegistry, ReportDefinition } from '../../schema';
-export interface Registry extends Omit<SchemaRegistry, "registerExplanation" | "registerField" | "registerReport"> {
+import { FieldDefinition, Registry as SchemaRegistry, ReportDefinition } from '../../schema';
+export interface Registry extends Omit<SchemaRegistry, "registerField" | "registerReport"> {
     registerField(definition: FieldDefinition): Registry;
     registerReport(definition: ReportDefinition): Registry;
-    registerExplanation(definition: ExplanationDefinition): Registry;
 }

package/dist/types/runtime/types/report.d.ts

@@ -1,10 +1,13 @@
 import { NormalizedReportConfig as SchemaNormalizedReportConfig, ReportDefinition as SchemaReportDefinition, ReportStateSnapshot } from '../../schema';
-export type { BaseReportConfig, PartialReportUpdatePolicy, ReportConfig, ReportPayloadContext, ReportPayloadValidationPolicy, ReportResolveContext, ReportStateSnapshot, ReportStatus, } from '../../schema';
+export type { BaseReportConfig, PartialReportUpdatePolicy, ReportConfig, ReportFetchContext, ReportFetchFactory, ReportFetchRequest, ReportFetchStatus, ReportFetchTransport, ReportPayloadContext, ReportPayloadValidationPolicy, ReportResolveContext, ReportStateSnapshot, ReportStatus, } from '../../schema';
 export interface ReportHandle {
     readonly id: string;
     readonly kind: string;
     readonly config: SchemaNormalizedReportConfig;
     readonly state: ReportStateSnapshot;
+    readonly canFetch: boolean;
+    fetch(request: import('../../schema').ReportFetchRequest): Promise<void>;
+    abort(): void;
     subscribe(listener: (state: ReportStateSnapshot) => void): () => void;
 }
 export type ReportController = ReportHandle;

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

@@ -1,11 +1,10 @@
-import { SubmitRequest as BaseSubmitRequest, SubmitResult as BaseSubmitResult, Transport as BaseTransport, TransportStreamEvent as BaseTransportStreamEvent } from '../../transport';
+import { SubmitRequest as BaseSubmitRequest, Transport as BaseTransport, 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 SubmitRequest = BaseSubmitRequest<NormalizedFieldConfig, NormalizedReportConfig>;
-export type SubmitResult = Omit<BaseSubmitResult, "reportStates"> & {
-    reportStates: Record<string, ReportStateSnapshot>;
-};
+export type SubmitResult = SchemaSubmitResult<ReportStateSnapshot>;
 export type Transport = BaseTransport<NormalizedFieldConfig, NormalizedReportConfig>;
 export type TransportStreamEvent = BaseTransportStreamEvent;
 export interface SubmitOptions {

package/dist/types/runtime/utils.d.ts

@@ -1,9 +1,7 @@
 import { MaybePromise } from './types';
-import { isRecord, slugify } from '../shared';
-export { isRecord, slugify };
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
 export declare const isPromiseLike: <T>(value: MaybePromise<T>) => value is PromiseLike<T>;
 export declare const isEmptyValue: (value: unknown) => boolean;
-export declare const toDate: (value: unknown) => Date | null;
 export declare const identity: <T>(value: T) => T;
 export declare const deepFreeze: <T>(value: T) => T;
 export declare const delay: (ms: number, signal?: AbortSignal) => Promise<void>;

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

@@ -1,4 +1,4 @@
-import { NormalizedFormSchema } from '../schema';
+import { NormalizedFormSchema } from '../../schema';
 import { EngineStore } from '../state';
 import { FieldValidationResult, FormHooks, FormStatus, FormValidationIssue, FormValidationResult, FormValidator, InactiveFieldPolicy } from '../types';
 type FormValidationField = {

package/dist/types/schema/ids.d.ts

@@ -0,0 +1 @@
+export declare const normalizeSchemaId: (value: string) => string;

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

@@ -1,7 +1,9 @@
+export { normalizeSchemaId } from './ids';
 export * from './normalize';
+export { createReportFetchRequest } from './report-fetch-request';
 export * from './registry';
-export type * from './types/explanation';
 export type * from './types/field';
 export type * from './types/form';
 export type * from './types/registry';
 export type * from './types/report';
+export type * from './types/submit';

package/dist/types/schema/registry.d.ts

@@ -1,9 +1,7 @@
-import { MLFormError } from '../shared';
-import { ExplanationConfig, ExplanationDefinition, FieldConfig, FieldDefinition, Registry, ReportConfig, ReportDefinition } from './index';
-export declare class RegistryError extends MLFormError {
+import { FieldConfig, FieldDefinition, Registry, ReportConfig, ReportDefinition } from './index';
+export declare class RegistryError extends Error {
     constructor(message: string);
 }
 export declare const createRegistry: () => Registry;
 export declare const defineFieldDefinition: <TDefinition extends FieldDefinition<FieldConfig, unknown>>(definition: TDefinition) => TDefinition;
 export declare const defineReportDefinition: <TDefinition extends ReportDefinition<ReportConfig>>(definition: TDefinition) => TDefinition;
-export declare const defineExplanationDefinition: <TDefinition extends ExplanationDefinition<ExplanationConfig>>(definition: TDefinition) => TDefinition;

package/dist/types/schema/report-fetch-request.d.ts

@@ -0,0 +1,6 @@
+import { ReportFetchRequest } from './types/report';
+import { SubmitResult } from './types/submit';
+export declare const createReportFetchRequest: (submitResult: SubmitResult, options?: {
+    reportId?: string;
+    signal?: AbortSignal;
+}) => ReportFetchRequest;

package/dist/types/schema/types/form.d.ts

@@ -1,13 +1,10 @@
-import { ExplanationConfig, NormalizedExplanationConfig } from './explanation';
 import { FieldConfig, NormalizedFieldConfig } from './field';
 import { NormalizedReportConfig, ReportConfig } from './report';
 export interface FormSchema {
     fields: FieldConfig[];
     reports?: ReportConfig[];
-    explanations?: ExplanationConfig[];
 }
 export interface NormalizedFormSchema {
     fields: NormalizedFieldConfig[];
     reports: NormalizedReportConfig[];
-    explanations: NormalizedExplanationConfig[];
 }

package/dist/types/schema/types/registry.d.ts

@@ -1,4 +1,3 @@
-import { ExplanationConfig, ExplanationDefinition } from './explanation';
 import { FieldConfig, FieldDefinition } from './field';
 import { ReportConfig, ReportDefinition } from './report';
 export interface Registry {
@@ -10,8 +9,4 @@ export interface Registry {
     unregisterReport(kind: string): Registry;
     getReport<TConfig extends ReportConfig = ReportConfig>(kind: string): ReportDefinition<TConfig> | undefined;
     listReports(): ReportDefinition<ReportConfig>[];
-    registerExplanation<TConfig extends ExplanationConfig>(definition: ExplanationDefinition<TConfig>): Registry;
-    unregisterExplanation(kind: string): Registry;
-    getExplanation<TConfig extends ExplanationConfig = ExplanationConfig>(kind: string): ExplanationDefinition<TConfig> | undefined;
-    listExplanations(): ExplanationDefinition<ExplanationConfig>[];
 }

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

@@ -1,7 +1,8 @@
 import { ZodType } from 'zod';
 import { MaybePromise } from './field';
-import { SubmitResult } from '../../runtime/types/transport';
+import { SubmitResult } from './submit';
 export type ReportStatus = "idle" | "loading" | "ready" | "error";
+export type ReportFetchStatus = ReportStatus;
 export type ReportPayloadValidationPolicy = "report-error" | "fail-submit";
 export type PartialReportUpdatePolicy = "trust" | "validate" | "defer";
 export interface BaseReportConfig {
@@ -25,13 +26,33 @@ export interface ReportStateSnapshot {
 }
 export interface ReportPayloadContext<TConfig extends ReportConfig = ReportConfig> {
     report: NormalizedReportConfig<TConfig>;
-    result: SubmitResult;
+    result: SubmitResult<ReportStateSnapshot>;
 }
 export interface ReportResolveContext<TConfig extends ReportConfig = ReportConfig> {
     config: NormalizedReportConfig<TConfig>;
     report: NormalizedReportConfig<TConfig>;
-    result: SubmitResult;
+    result: SubmitResult<ReportStateSnapshot>;
 }
+export interface ReportFetchRequest {
+    reportId: string;
+    backend?: string;
+    values: Record<string, unknown>;
+    fieldValues: Record<string, unknown>;
+    serializedValues: Record<string, unknown>;
+    serializedFieldValues: Record<string, unknown>;
+    reports: Record<string, unknown>;
+    meta: Record<string, unknown>;
+    raw: unknown;
+    signal?: AbortSignal;
+}
+export interface ReportFetchTransport {
+    submit: (request: ReportFetchRequest) => Promise<unknown>;
+}
+export interface ReportFetchContext<TConfig extends ReportConfig = ReportConfig> {
+    config: NormalizedReportConfig<TConfig>;
+    reportId: string;
+}
+export type ReportFetchFactory<TConfig extends ReportConfig = ReportConfig> = (context: ReportFetchContext<TConfig>) => ReportFetchTransport;
 export interface ReportDefinition<TConfig extends ReportConfig = ReportConfig> {
     kind: string;
     schema: ZodType<TConfig>;
@@ -39,5 +60,6 @@ export interface ReportDefinition<TConfig extends ReportConfig = ReportConfig> {
     payloadValidationPolicy?: ReportPayloadValidationPolicy;
     partialUpdatePolicy?: PartialReportUpdatePolicy;
     clonePayload?: (payload: unknown, config: TConfig) => unknown;
+    fetch?: ReportFetchFactory<TConfig>;
     resolvePayload?: (config: TConfig, context: ReportPayloadContext<TConfig>) => MaybePromise<unknown>;
 }

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

@@ -0,0 +1,11 @@
+export interface SubmitResult<TReportState = unknown> {
+    backend?: string;
+    values: Record<string, unknown>;
+    fieldValues: Record<string, unknown>;
+    serializedValues: Record<string, unknown>;
+    serializedFieldValues: Record<string, unknown>;
+    reports: Record<string, unknown>;
+    reportStates: Record<string, TReportState>;
+    meta: Record<string, unknown>;
+    raw: unknown;
+}

package/dist/types/transport/errors.d.ts

@@ -1,4 +1,3 @@
-import { MLFormError } from '../shared';
 export declare const transportErrorCodes: {
     readonly TIMEOUT: "TIMEOUT";
     readonly AUTH_FAILED: "AUTH_FAILED";
@@ -16,7 +15,7 @@ export declare const transportErrorCodes: {
     readonly QUORUM_NOT_REACHED: "QUORUM_NOT_REACHED";
 };
 export type TransportErrorCode = (typeof transportErrorCodes)[keyof typeof transportErrorCodes] | (string & {});
-export declare class TransportError extends MLFormError {
+export declare class TransportError extends Error {
     readonly cause: unknown;
     readonly source?: string;
     readonly status?: number;

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

@@ -3,6 +3,8 @@ export { TransportError, transportErrorCodes, type TransportErrorCode } from './
 export { transportDefaults, transportErrorMessages } from './constants';
 export { assertPayloadWithinLimits, assertTransportCapabilities, cloneCapabilities, inferTransportCapabilities, mergeTransportCapabilities, normalizeTransportCapabilities, } from './capabilities';
 export { getTransportPolicyContext, withTransportPolicyContext } from './policy-context';
+export { createTransportRequestRunner, extractErrorMessage } from './request-runner';
+export type { TransportRequestOutcome, TransportRequestRunner } from './request-runner';
 export * from './protocols';
 export * from './middleware';
 export * from './composition';

package/dist/types/transport/request-runner.d.ts

@@ -0,0 +1,16 @@
+export type TransportRequestOutcome<TResult> = {
+    status: "completed";
+    value: TResult;
+} | {
+    status: "aborted";
+} | {
+    status: "failed";
+    error: unknown;
+    message: string;
+};
+export type TransportRequestRunner = {
+    run<TResult>(submit: (signal: AbortSignal | undefined) => Promise<TResult>, signals?: readonly (AbortSignal | undefined)[]): Promise<TransportRequestOutcome<TResult>>;
+    abort(reason?: unknown): void;
+};
+export declare const extractErrorMessage: (error: unknown) => string;
+export declare const createTransportRequestRunner: () => TransportRequestRunner;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mlform",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "private": false,
   "description": "Composable form generation utilities for machine learning backend integration",
   "keywords": [
@@ -50,47 +50,34 @@
     "dist/**"
   ],
   "type": "module",
-  "types": "dist/types/src/index.d.ts",
   "exports": {
-    ".": {
-      "types": "./dist/types/src/index.d.ts",
-      "import": "./dist/mlform.mjs"
-    },
     "./kit": {
-      "types": "./dist/types/src/kit/index.d.ts",
+      "types": "./dist/types/kit/index.d.ts",
       "import": "./dist/mlform/kit.mjs"
     },
     "./runtime": {
-      "types": "./dist/types/src/runtime/index.d.ts",
+      "types": "./dist/types/runtime/index.d.ts",
       "import": "./dist/mlform/runtime.mjs"
     },
     "./schema": {
-      "types": "./dist/types/src/schema/index.d.ts",
+      "types": "./dist/types/schema/index.d.ts",
       "import": "./dist/mlform/schema.mjs"
     },
-    "./presentation": {
-      "types": "./dist/types/src/presentation/index.d.ts",
-      "import": "./dist/mlform/presentation.mjs"
-    },
-    "./builtins-ml": {
-      "types": "./dist/types/src/builtins-ml/index.d.ts",
-      "import": "./dist/mlform/builtins-ml.mjs"
-    },
-    "./behaviors": {
-      "types": "./dist/types/src/behaviors/index.d.ts",
-      "import": "./dist/mlform/behaviors.mjs"
+    "./builtins": {
+      "types": "./dist/types/builtins/index.d.ts",
+      "import": "./dist/mlform/builtins.mjs"
     },
     "./transport": {
-      "types": "./dist/types/src/transport/index.d.ts",
+      "types": "./dist/types/transport/index.d.ts",
       "import": "./dist/mlform/transport.mjs"
     },
     "./primitives": {
-      "types": "./dist/types/src/primitives/index.d.ts",
+      "types": "./dist/types/primitives/index.d.ts",
       "import": "./dist/mlform/primitives.mjs"
     },
-    "./design-system": {
-      "types": "./dist/types/src/design-system/index.d.ts",
-      "import": "./dist/mlform/design-system.mjs"
+    "./design": {
+      "types": "./dist/types/design/index.d.ts",
+      "import": "./dist/mlform/design.mjs"
     }
   },
   "publishConfig": {
@@ -102,11 +89,11 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.8.0",
+    "@types/node": "^25.9.1",
     "jsdom": "^29.1.1",
     "typescript": "~6.0.3",
     "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-    "vite-plugin-dts": "^5.0.0",
+    "vite-plugin-dts": "^5.0.1",
     "vite-plus": "latest",
     "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
   },