mlform 0.1.19 → 0.1.20

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

@@ -1,12 +1,13 @@
-import { SubmitRequest as BaseSubmitRequest, Transport as BaseTransport, SubmissionInputRecord, TransportStreamEvent as BaseTransportStreamEvent } from '../../../transport';
-import { SubmitResult as SchemaSubmitResult } from '../../../schema';
+import { SubmitRequest as BaseSubmitRequest, Transport as BaseTransport } from '../../../transport';
+import { SubmissionInputRecord, SubmitResult as SchemaSubmitResult } from '../../../schema';
 import { NormalizedFieldConfig } from './field';
 import { NormalizedReportConfig, ReportStateSnapshot } from './report';
-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 { SubmissionInputRecord } from '../../../schema';
+export type { ReportContext, ReportResult, ReportResultContext } from '../../../schema';
+export type { TransportResponse } from '../../../transport';
 export type SubmitRequest = BaseSubmitRequest<NormalizedFieldConfig, NormalizedReportConfig>;
 export type SubmitResult = SchemaSubmitResult<ReportStateSnapshot>;
 export type Transport = BaseTransport<NormalizedFieldConfig, NormalizedReportConfig>;
-export type TransportStreamEvent = BaseTransportStreamEvent;
 export interface SubmitOptions {
     signal?: AbortSignal;
     backend?: string;

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

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

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

@@ -1,12 +1,19 @@
+import { ReportResult } from './types/submit';
 export type MappedToTarget = string | number;
 export type MappedTo = MappedToTarget | Record<string, MappedToTarget | null | undefined>;
 export declare const resolveMappedTo: (mappedTo: MappedTo | undefined, backend: string | undefined) => MappedToTarget | undefined;
 export declare const mappedToKey: (target: MappedToTarget) => string;
 export declare const resolveMappedTargets: (mappedTo: MappedTo | undefined, backend: string | undefined) => MappedToTarget[];
+export declare const resolveMappedReportResult: (report: {
+    mappedTo?: MappedTo;
+}, result: {
+    backend?: string;
+    reports: readonly ReportResult[];
+}) => ReportResult | undefined;
 export declare const resolveMappedReportPayload: (report: {
     id?: string;
     mappedTo?: MappedTo;
 }, result: {
     backend?: string;
-    reports: readonly unknown[];
+    reports: readonly ReportResult[];
 }) => unknown;

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

@@ -2,10 +2,9 @@ import { ZodType } from 'zod';
 import { MaybePromise } from './field';
 import { MappedTo } from '../mapped-to';
 import { ReportContext, SubmitResult, SubmissionInputRecord } from './submit';
-export type ReportStatus = "idle" | "loading" | "ready" | "error";
+export type ReportStatus = "idle" | "loading" | "ready" | "skipped" | "error";
 export type ReportFetchStatus = ReportStatus;
 export type ReportPayloadValidationPolicy = "report-error" | "fail-submit";
-export type PartialReportUpdatePolicy = "trust" | "validate" | "defer";
 export interface BaseReportConfig {
     id?: string;
     kind: string;
@@ -63,7 +62,6 @@ export interface ReportDefinition<TConfig extends ReportConfig = ReportConfig> {
     schema: ZodType<TConfig>;
     payloadSchema?: ZodType<unknown>;
     payloadValidationPolicy?: ReportPayloadValidationPolicy;
-    partialUpdatePolicy?: PartialReportUpdatePolicy;
     clonePayload?: (payload: unknown, config: TConfig) => unknown;
     fetch?: ReportFetchFactory<TConfig>;
     resolvePayload?: (config: TConfig, context: ReportPayloadContext<TConfig>) => MaybePromise<unknown>;

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

@@ -1,4 +1,4 @@
-import { MappedTo } from '../mapped-to';
+import { MappedTo, MappedToTarget } from '../mapped-to';
 export interface SubmissionInputRecord {
     fieldId: string;
     displayKey?: string;
@@ -20,10 +20,30 @@ export interface ReportContext {
     backend?: string;
     displayValues: Record<string, unknown>;
     modelValues: Record<string, unknown>;
-    reports: readonly unknown[];
+    reports: readonly ReportResult[];
     meta: Record<string, unknown>;
     raw: unknown;
 }
+export interface ReportResultContext {
+    displayValues?: Record<string, unknown>;
+    modelValues?: Record<string, unknown>;
+    meta?: Record<string, unknown>;
+    raw?: unknown;
+}
+interface BaseReportResult {
+    backend: string;
+    mappedTo: MappedToTarget;
+    context?: ReportResultContext;
+}
+export type ReportResult = (BaseReportResult & {
+    status: "pending";
+}) | (BaseReportResult & {
+    status: "ready";
+    payload: unknown;
+}) | (BaseReportResult & {
+    status: "skipped";
+    reason?: string;
+});
 export interface SubmitResult<TReportState = unknown> {
     backend?: string;
     inputs?: SubmissionInputRecord[];
@@ -33,9 +53,10 @@ export interface SubmitResult<TReportState = unknown> {
     fieldValues: Record<string, unknown>;
     serializedValues: Record<string, unknown>;
     serializedFieldValues: Record<string, unknown>;
-    reports: readonly unknown[];
+    reports: readonly ReportResult[];
     reportContexts?: Record<string, ReportContext>;
     reportStates: Record<string, TReportState>;
     meta: Record<string, unknown>;
     raw: unknown;
 }
+export {};

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

@@ -0,0 +1,25 @@
+import { NormalizedFormSchema, Registry } from './index';
+export type SchemaIssuePath = readonly (string | number)[];
+export type SchemaValidationIssue = {
+    path: SchemaIssuePath;
+    message: string;
+    code: "invalid-schema" | "unknown-kind" | "invalid-config";
+};
+export type UnknownSchemaKind = {
+    section: "fields" | "reports";
+    index: number;
+    kind: string;
+    path: SchemaIssuePath;
+};
+export type SchemaValidationResult = {
+    success: true;
+    data: NormalizedFormSchema;
+    issues: readonly [];
+} | {
+    success: false;
+    issues: readonly SchemaValidationIssue[];
+};
+export type SchemaJsonSchema = Record<string, unknown>;
+export declare const findUnknownKinds: (schema: unknown, registry: Registry) => UnknownSchemaKind[];
+export declare const validateSchema: (schema: unknown, registry: Registry) => SchemaValidationResult;
+export declare const toSchemaJsonSchema: (registry: Registry) => SchemaJsonSchema;

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

@@ -1,35 +1,8 @@
 export declare const transportErrorCodes: {
-    readonly TIMEOUT: "TIMEOUT";
-    readonly AUTH_FAILED: "AUTH_FAILED";
-    readonly RATE_LIMITED: "RATE_LIMITED";
-    readonly OPEN_CIRCUIT: "OPEN_CIRCUIT";
-    readonly PARSE_FAILED: "PARSE_FAILED";
-    readonly UPSTREAM_5XX: "UPSTREAM_5XX";
     readonly ABORTED: "ABORTED";
-    readonly CAPABILITY_MISMATCH: "CAPABILITY_MISMATCH";
-    readonly PAYLOAD_TOO_LARGE: "PAYLOAD_TOO_LARGE";
-    readonly SESSION_RESULT_MISSING: "SESSION_RESULT_MISSING";
-    readonly GRAPHQL_ERROR: "GRAPHQL_ERROR";
-    readonly WEBSOCKET_BUFFER_OVERFLOW: "WEBSOCKET_BUFFER_OVERFLOW";
-    readonly POLICY_STORE_CONFLICT: "POLICY_STORE_CONFLICT";
-    readonly QUORUM_NOT_REACHED: "QUORUM_NOT_REACHED";
 };
 export type TransportErrorCode = (typeof transportErrorCodes)[keyof typeof transportErrorCodes] | (string & {});
 export declare class TransportError extends Error {
-    readonly cause: unknown;
-    readonly source?: string;
-    readonly status?: number;
     readonly code?: TransportErrorCode;
-    readonly retryable?: boolean;
-    readonly details?: unknown;
-    readonly response?: unknown;
-    constructor(message: string, options?: {
-        cause?: unknown;
-        source?: string;
-        status?: number;
-        code?: TransportErrorCode;
-        retryable?: boolean;
-        details?: unknown;
-        response?: unknown;
-    });
+    constructor(message: string, code?: TransportErrorCode);
 }

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

@@ -0,0 +1,17 @@
+import { SubmitRequest, Transport } from './types';
+export type FanoutOutcome<TTarget, TValue> = {
+    target: TTarget;
+    status: "fulfilled";
+    value: TValue;
+} | {
+    target: TTarget;
+    status: "rejected";
+    reason: unknown;
+};
+export type CreateFanoutTransportOptions<TTarget, TValue> = {
+    targets: readonly TTarget[];
+    submit: (target: TTarget, request: SubmitRequest) => Promise<TValue>;
+    merge: (outcomes: readonly FanoutOutcome<TTarget, TValue>[], request: SubmitRequest) => unknown;
+    failurePolicy?: "collect" | "fail-fast";
+};
+export declare const createFanoutTransport: <TTarget, TValue>(options: CreateFanoutTransportOptions<TTarget, TValue>) => Transport;

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

@@ -1,11 +1,5 @@
-export * from './types';
-export { TransportError, transportErrorCodes, type TransportErrorCode } from './errors';
-export { transportDefaults, transportErrorMessages } from './constants';
-export { assertPayloadWithinLimits, assertTransportCapabilities, cloneCapabilities, inferTransportCapabilities, mergeTransportCapabilities, normalizeTransportCapabilities, } from './capabilities';
-export { getTransportPolicyContext, withTransportPolicyContext } from './policy-context';
+export { TransportError, transportErrorCodes } from './errors';
 export { createTransportRequestRunner, extractErrorMessage } from './request-runner';
-export type { TransportRequestOutcome, TransportRequestRunner } from './request-runner';
-export * from './protocols';
-export * from './middleware';
-export * from './composition';
-export * from './state';
+export { createFanoutTransport } from './fanout';
+export type { CreateFanoutTransportOptions, FanoutOutcome } from './fanout';
+export type { SubmitRequest, Transport, TransportResponse } from './types';

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

@@ -1,4 +1,4 @@
-export type TransportRequestOutcome<TResult> = {
+type TransportRequestOutcome<TResult> = {
     status: "completed";
     value: TResult;
 } | {
@@ -8,9 +8,10 @@ export type TransportRequestOutcome<TResult> = {
     error: unknown;
     message: string;
 };
-export type TransportRequestRunner = {
+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;
+export {};

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

@@ -0,0 +1,22 @@
+import { ReportResult, SubmissionInputRecord } from '../../schema';
+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>;
+    serializedFieldValues: Record<string, unknown>;
+    fields: readonly TField[];
+    reports: readonly TReport[];
+    signal?: AbortSignal;
+}
+export interface TransportResponse {
+    reports?: readonly ReportResult[];
+    meta?: Record<string, unknown>;
+    raw?: unknown;
+}
+export interface Transport<TField extends Record<string, unknown> = Record<string, unknown>, TReport extends Record<string, unknown> = Record<string, unknown>> {
+    submit: (request: SubmitRequest<TField, TReport>) => Promise<unknown>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mlform",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "private": false,
   "description": "Composable form generation utilities for machine learning backend integration",
   "keywords": [

package/dist/schema-CNKKJZRx.js

@@ -1,173 +0,0 @@
-//#region src/schema/ids.ts
-var e = (e) => e.trim().toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "item", t = (e, t) => {
-	if (typeof e == "string" || typeof e == "number") return e;
-	if (e) return (t ? e[t] : void 0) ?? e.default ?? void 0;
-}, n = (e) => String(e), r = (e, r) => {
-	let i = t(e, r);
-	if (r !== void 0 || typeof e != "object" || !e) return i === void 0 ? [] : [i];
-	let a = /* @__PURE__ */ new Set();
-	return Object.values(e).filter((e) => {
-		if (typeof e != "string" && typeof e != "number") return !1;
-		let t = n(e);
-		return a.has(t) ? !1 : (a.add(t), !0);
-	});
-}, i = (e, t) => {
-	let r = n(e), i = t.reports.filter((e) => typeof e == "object" && !!e && !Array.isArray(e) && n(e.mappedTo ?? "") === r);
-	if (i.length > 1) throw Error(`Duplicate report payload for mappedTo "${r}".`);
-	let a = i[0];
-	if (!a) return;
-	if ("payload" in a) return a.payload;
-	let { id: o, kind: s, mappedTo: c, ...l } = a;
-	return l;
-}, a = (e, t) => {
-	let n = r(e.mappedTo, t.backend);
-	if (n.length !== 0) for (let e of n) {
-		let n = i(e, t);
-		if (n !== void 0) return n;
-	}
-}, o = class extends Error {
-	constructor(e) {
-		super(e), this.name = "RegistryError";
-	}
-}, s = class {
-	fieldDefinitions = /* @__PURE__ */ new Map();
-	reportDefinitions = /* @__PURE__ */ new Map();
-	registerField(e) {
-		if (this.fieldDefinitions.has(e.kind)) throw new o(`Field kind "${e.kind}" is already registered.`);
-		return this.fieldDefinitions.set(e.kind, e), this;
-	}
-	unregisterField(e) {
-		return this.fieldDefinitions.delete(e), this;
-	}
-	registerReport(e) {
-		if (this.reportDefinitions.has(e.kind)) throw new o(`Report kind "${e.kind}" is already registered.`);
-		return this.reportDefinitions.set(e.kind, e), this;
-	}
-	unregisterReport(e) {
-		return this.reportDefinitions.delete(e), this;
-	}
-	getField(e) {
-		return this.fieldDefinitions.get(e);
-	}
-	getReport(e) {
-		return this.reportDefinitions.get(e);
-	}
-	listFields() {
-		return Array.from(this.fieldDefinitions.values());
-	}
-	listReports() {
-		return Array.from(this.reportDefinitions.values());
-	}
-}, c = () => new s(), l = (e) => e, u = (e) => e, d = (e, t, n, r) => {
-	if (typeof n != "object" || !n) throw Error(`Series field "${e}" requires "${t}" configuration.`);
-	let i = "kind" in n && typeof n.kind == "string" ? n.kind : "";
-	if (i.length === 0) throw Error(`Series field "${e}" requires "${t}.kind".`);
-	if (i === "series") throw Error(`Series field "${e}" cannot nest series in "${t}".`);
-	if (!r.getField(i)) throw new o(`Series field "${e}" uses unknown sub-field kind "${i}" in "${t}".`);
-}, f = (e, t) => {
-	if (e.kind === "series" && (d(e.label, "field1", e.field1, t), d(e.label, "field2", e.field2, t), typeof e.minPoints == "number" && typeof e.maxPoints == "number" && e.minPoints > e.maxPoints)) throw Error(`Series field "${e.label}" requires minPoints to be less than or equal to maxPoints.`);
-}, p = (t, n, r, i) => {
-	let a = e((t ?? n) || i);
-	if (t) {
-		if (r.has(a)) throw Error(`Duplicate explicit id "${a}" in schema.`);
-		return r.add(a), a;
-	}
-	let o = a, s = 2;
-	for (; r.has(o);) o = `${a}-${s}`, s += 1;
-	return r.add(o), o;
-}, m = (e, t, n, r) => {
-	let i = n.getField(e.kind);
-	if (!i) throw new o(`Unknown field kind "${e.kind}".`);
-	let a = i.schema.parse(e);
-	return f(a, n), {
-		...a,
-		id: p(a.id, a.label, r, `field-${t + 1}`)
-	};
-}, h = (e, t, n, r) => {
-	let i = n.getReport(e.kind);
-	if (!i) throw new o(`Unknown report kind "${e.kind}".`);
-	let a = i.schema.parse(e), s = p(a.id, a.label ?? a.kind, r, `report-${t + 1}`);
-	return {
-		...a,
-		id: s
-	};
-}, g = (e) => {
-	let r = e.mappedTo;
-	return typeof r == "string" || typeof r == "number" ? [["default", n(r)]] : r ? Object.keys(r).map((e) => {
-		let i = t(r, e === "default" ? void 0 : e);
-		return i === void 0 ? null : [e, n(i)];
-	}).filter((e) => e !== null) : [];
-}, _ = (e) => {
-	let t = /* @__PURE__ */ new Map();
-	for (let n of e) for (let [e, r] of g(n)) {
-		let i = `${e}:${r}`, a = t.get(i);
-		if (a) throw Error(`Duplicate report mappedTo "${r}" for backend "${e}" in "${a}" and "${n.id}".`);
-		t.set(i, n.id);
-	}
-}, v = (e, t) => {
-	let n = /* @__PURE__ */ new Set(), r = /* @__PURE__ */ new Set(), i = (e.reports ?? []).map((e, n) => h(e, n, t, r));
-	return _(i), {
-		fields: e.fields.map((e, r) => m(e, r, t, n)),
-		reports: i
-	};
-}, y = (e) => e === 1 || e === "1" || e === !0, b = (e, r, i = {}) => {
-	if (e.kind !== "onehot-category" || !Array.isArray(e.options)) return;
-	let a = /* @__PURE__ */ new Set(), o;
-	for (let s of e.options) {
-		let c = t(s.mappedTo, i.backend);
-		if (c === void 0) throw Error(`onehot-category "${e.id ?? e.kind}": option "${s.value}" has no mappedTo.`);
-		let l = n(c);
-		if (a.has(l)) throw Error(`onehot-category "${e.id ?? e.kind}": duplicate mappedTo "${l}".`);
-		if (a.add(l), y(r[l])) {
-			if (o !== void 0) throw Error(`onehot-category "${e.id ?? e.kind}": multiple selected mapped values.`);
-			o = s.value;
-		}
-	}
-	return o;
-}, x = (e) => {
-	if (typeof e == "string") return e;
-	if (typeof e != "number") return e.id ?? e.config?.id;
-}, S = (e, r) => {
-	if (typeof e == "string" || typeof e == "number") return String(e);
-	let i = t(e.mappedTo ?? e.config?.mappedTo, r);
-	return i === void 0 ? void 0 : n(i);
-}, C = (e, r) => Object.fromEntries(e.map((e) => {
-	let i = t(e.mappedTo, r.backend);
-	return [e.id, {
-		reportId: e.id,
-		kind: e.kind,
-		label: e.label,
-		mappedTo: e.mappedTo,
-		target: i,
-		targetKey: i === void 0 ? void 0 : n(i),
-		backend: r.backend,
-		displayValues: r.displayValues ?? {},
-		modelValues: r.modelValues ?? r.serializedValues,
-		reports: r.reports,
-		meta: r.meta,
-		raw: r.raw
-	}];
-})), w = (e, t) => {
-	let n = e.reportContexts ?? {}, r = x(t);
-	if (r && n[r]) return n[r];
-	let i = S(t, e.backend);
-	if (i !== void 0) return Object.values(n).find((e) => e.targetKey === i);
-}, T = (e, t = {}) => ({
-	reportId: t.reportId ?? "",
-	backend: e.backend,
-	inputs: e.inputs ?? [],
-	displayValues: e.displayValues ?? {},
-	modelValues: e.modelValues ?? e.serializedValues,
-	values: e.values,
-	fieldValues: e.fieldValues,
-	serializedValues: e.serializedValues,
-	serializedFieldValues: e.serializedFieldValues,
-	reports: e.reports,
-	reportContext: t.reportId === void 0 ? void 0 : w(e, t.reportId),
-	reportContexts: e.reportContexts ?? {},
-	meta: e.meta,
-	raw: e.raw,
-	signal: t.signal
-});
-//#endregion
-export { v as a, l as c, a as d, r as f, b as i, u as l, e as m, C as n, o, t as p, w as r, c as s, T as t, n as u };