mlform 0.1.20 → 0.1.23

package/dist/schema-BI-Ia-h9.js

@@ -0,0 +1,339 @@
+import { array as e, never as t, strictObject as n, toJSONSchema as r, xor as i } from "zod";
+//#region src/schema/ids.ts
+var a = (e) => e.trim().toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "item", o = (e, t) => {
+	if (typeof e == "string" || typeof e == "number") return e;
+	if (e) return (t ? e[t] : void 0) ?? e.default ?? void 0;
+}, s = (e) => String(e), c = (e, t) => {
+	let n = o(e, t);
+	if (t !== void 0 || typeof e != "object" || !e) return n === void 0 ? [] : [n];
+	let r = /* @__PURE__ */ new Set();
+	return Object.values(e).filter((e) => {
+		if (typeof e != "string" && typeof e != "number") return !1;
+		let t = s(e);
+		return r.has(t) ? !1 : (r.add(t), !0);
+	});
+}, l = (e, t) => {
+	if (typeof e == "string" || typeof e == "number") return [{
+		backend: t ?? "default",
+		mappedTo: e
+	}];
+	if (!e) return [];
+	if (t) {
+		let n = o(e, t);
+		return n === void 0 ? [] : [{
+			backend: t,
+			mappedTo: n
+		}];
+	}
+	return Object.entries(e).flatMap(([e, t]) => typeof t == "string" || typeof t == "number" ? [{
+		backend: e,
+		mappedTo: t
+	}] : []);
+}, u = (e, t) => {
+	let n = l(e.mappedTo, t.backend), r = t.reports.filter((e) => n.some((t) => t.backend === e.backend && s(t.mappedTo) === s(e.mappedTo)));
+	if (r.length > 1) {
+		let e = r[0];
+		throw Error(`Duplicate report result for backend "${e?.backend}" and mappedTo "${String(e?.mappedTo)}".`);
+	}
+	return r[0];
+}, d = (e, t) => {
+	let n = u(e, t);
+	return n?.status === "ready" ? n.payload : void 0;
+}, f = class extends Error {
+	constructor(e) {
+		super(e), this.name = "RegistryError";
+	}
+}, p = class {
+	fieldDefinitions = /* @__PURE__ */ new Map();
+	reportDefinitions = /* @__PURE__ */ new Map();
+	registerField(e) {
+		if (this.fieldDefinitions.has(e.kind)) throw new f(`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 f(`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());
+	}
+}, m = () => new p(), h = (e) => e, g = (e) => e, _ = class extends Error {
+	path;
+	code;
+	constructor(e, t, n = "invalid-config") {
+		super(e), this.path = t, this.code = n, this.name = "SchemaNormalizationError";
+	}
+}, v = (e, t, n, r, i) => {
+	if (typeof n != "object" || !n) throw new _(`Series field "${e}" requires "${t}" configuration.`, [
+		"fields",
+		i,
+		t
+	]);
+	let a = "kind" in n && typeof n.kind == "string" ? n.kind : "";
+	if (a.length === 0) throw new _(`Series field "${e}" requires "${t}.kind".`, [
+		"fields",
+		i,
+		t,
+		"kind"
+	]);
+	if (a === "series") throw new _(`Series field "${e}" cannot nest series in "${t}".`, [
+		"fields",
+		i,
+		t,
+		"kind"
+	]);
+	if (!r.getField(a)) throw new _(`Series field "${e}" uses unknown sub-field kind "${a}" in "${t}".`, [
+		"fields",
+		i,
+		t,
+		"kind"
+	], "unknown-kind");
+}, y = (e, t, n) => {
+	if (e.kind === "series" && (v(e.label, "field1", e.field1, t, n), v(e.label, "field2", e.field2, t, n), typeof e.minPoints == "number" && typeof e.maxPoints == "number" && e.minPoints > e.maxPoints)) throw new _(`Series field "${e.label}" requires minPoints to be less than or equal to maxPoints.`, [
+		"fields",
+		n,
+		"minPoints"
+	]);
+}, b = (e, t, n, r, i) => {
+	let o = a((e ?? t) || r);
+	if (e) {
+		if (n.has(o)) throw new _(`Duplicate explicit id "${o}" in schema.`, i);
+		return n.add(o), o;
+	}
+	let s = o, c = 2;
+	for (; n.has(s);) s = `${o}-${c}`, c += 1;
+	return n.add(s), s;
+}, x = (e, t, n, r) => {
+	let i = n.getField(e.kind);
+	if (!i) throw new f(`Unknown field kind "${e.kind}".`);
+	let a = i.schema.parse(e);
+	return y(a, n, t), {
+		...a,
+		id: b(a.id, a.label, r, `field-${t + 1}`, [
+			"fields",
+			t,
+			"id"
+		])
+	};
+}, S = (e, t, n, r) => {
+	let i = n.getReport(e.kind);
+	if (!i) throw new f(`Unknown report kind "${e.kind}".`);
+	let a = i.schema.parse(e), o = b(e.id ?? a.id, e.label ?? a.label ?? a.kind, r, `report-${t + 1}`, [
+		"reports",
+		t,
+		"id"
+	]);
+	return {
+		...a,
+		...e.label === void 0 ? {} : { label: e.label },
+		...e.description === void 0 ? {} : { description: e.description },
+		...e.mappedTo === void 0 ? {} : { mappedTo: e.mappedTo },
+		...e.ui === void 0 ? {} : { ui: e.ui },
+		id: o
+	};
+}, C = (e, t) => {
+	let n = /* @__PURE__ */ new Set(), r = /* @__PURE__ */ new Set(), i = (e.reports ?? []).map((e, n) => S(e, n, t, r));
+	return {
+		fields: e.fields.map((e, r) => x(e, r, t, n)),
+		reports: i
+	};
+}, w = (e) => e === 1 || e === "1" || e === !0, T = (e, t, n = {}) => {
+	if (e.kind !== "onehot-category" || !Array.isArray(e.options)) return;
+	let r = /* @__PURE__ */ new Set(), i;
+	for (let a of e.options) {
+		let c = o(a.mappedTo, n.backend);
+		if (c === void 0) throw Error(`onehot-category "${e.id ?? e.kind}": option "${a.value}" has no mappedTo.`);
+		let l = s(c);
+		if (r.has(l)) throw Error(`onehot-category "${e.id ?? e.kind}": duplicate mappedTo "${l}".`);
+		if (r.add(l), w(t[l])) {
+			if (i !== void 0) throw Error(`onehot-category "${e.id ?? e.kind}": multiple selected mapped values.`);
+			i = a.value;
+		}
+	}
+	return i;
+}, E = (e) => {
+	if (typeof e == "string") return e;
+	if (typeof e != "number") return e.id ?? e.config?.id;
+}, D = (e, t) => {
+	if (typeof e == "string" || typeof e == "number") return String(e);
+	let n = o(e.mappedTo ?? e.config?.mappedTo, t);
+	return n === void 0 ? void 0 : s(n);
+}, O = (e, t) => Object.fromEntries(e.map((e) => {
+	let n = u(e, t), r = n?.context, i = n?.mappedTo ?? o(e.mappedTo, t.backend);
+	return [e.id, {
+		reportId: e.id,
+		kind: e.kind,
+		label: e.label,
+		mappedTo: e.mappedTo,
+		target: i,
+		targetKey: i === void 0 ? void 0 : s(i),
+		backend: n?.backend ?? t.backend,
+		displayValues: r?.displayValues ?? t.displayValues,
+		modelValues: r?.modelValues ?? t.modelValues,
+		reports: t.reports,
+		meta: r?.meta ?? t.meta,
+		raw: r && "raw" in r ? r.raw : t.raw
+	}];
+})), k = (e, t) => {
+	let n = e.reportContexts, r = E(t);
+	if (r && n[r]) return n[r];
+	let i = D(t, e.backend);
+	if (i === void 0) return;
+	let a = Object.values(n).filter((t) => t.targetKey === i && (e.backend === void 0 || t.backend === e.backend));
+	return a.length === 1 ? a[0] : void 0;
+}, A = (e) => typeof e == "object" && !!e && !Array.isArray(e), j = (e, t) => {
+	if (!A(e)) return [];
+	let n = [], r = (r) => {
+		let i = e[r];
+		Array.isArray(i) && i.forEach((e, i) => {
+			if (!(!A(e) || typeof e.kind != "string") && ((r === "fields" ? t.getField(e.kind) : t.getReport(e.kind)) || n.push({
+				section: r,
+				index: i,
+				kind: e.kind,
+				path: [
+					r,
+					i,
+					"kind"
+				]
+			}), r === "fields" && e.kind === "series")) for (let a of ["field1", "field2"]) {
+				let o = e[a];
+				!A(o) || typeof o.kind != "string" || t.getField(o.kind) || n.push({
+					section: r,
+					index: i,
+					kind: o.kind,
+					path: [
+						r,
+						i,
+						a,
+						"kind"
+					]
+				});
+			}
+		});
+	};
+	return r("fields"), r("reports"), n;
+}, M = (e, t, n, r) => {
+	if (!Array.isArray(t)) {
+		r.push({
+			path: [e],
+			message: `${e} must be an array.`,
+			code: "invalid-schema"
+		});
+		return;
+	}
+	t.forEach((t, i) => {
+		if (!A(t)) {
+			r.push({
+				path: [e, i],
+				message: `${e === "fields" ? "Field" : "Report"} must be an object.`,
+				code: "invalid-config"
+			});
+			return;
+		}
+		if (typeof t.kind != "string" || t.kind.length === 0) {
+			r.push({
+				path: [
+					e,
+					i,
+					"kind"
+				],
+				message: "kind must be a non-empty string.",
+				code: "invalid-config"
+			});
+			return;
+		}
+		let a = e === "fields" ? n.getField(t.kind) : n.getReport(t.kind);
+		if (!a) return;
+		let o = a.schema.safeParse(t);
+		if (!o.success) for (let t of o.error.issues) r.push({
+			path: [
+				e,
+				i,
+				...t.path.map((e) => typeof e == "symbol" ? String(e) : e)
+			],
+			message: t.message,
+			code: "invalid-config"
+		});
+	});
+}, N = (e, t) => {
+	if (!A(e)) return {
+		success: !1,
+		issues: [{
+			path: [],
+			message: "Schema must be an object.",
+			code: "invalid-schema"
+		}]
+	};
+	let n = [], r = new Set(["fields", "reports"]);
+	for (let t of Object.keys(e)) r.has(t) || n.push({
+		path: [t],
+		message: `Unsupported schema property "${t}".`,
+		code: "invalid-schema"
+	});
+	M("fields", e.fields, t, n), M("reports", e.reports ?? [], t, n);
+	for (let r of j(e, t)) n.push({
+		path: r.path,
+		message: `Unknown ${r.section === "fields" ? "field" : "report"} kind "${r.kind}".`,
+		code: "unknown-kind"
+	});
+	if (n.length > 0) return {
+		success: !1,
+		issues: n
+	};
+	try {
+		return {
+			success: !0,
+			data: C(e, t),
+			issues: []
+		};
+	} catch (e) {
+		let t = e instanceof _ ? e : void 0;
+		return {
+			success: !1,
+			issues: [{
+				path: t?.path ?? [],
+				message: e instanceof Error ? e.message : "Schema normalization failed.",
+				code: t?.code ?? "invalid-schema"
+			}]
+		};
+	}
+}, P = (e) => {
+	let n = e.map((e) => e.schema);
+	return n.length > 0 ? i(n) : t();
+}, F = (t) => r(n({
+	fields: e(P(t.listFields())),
+	reports: e(P(t.listReports())).optional()
+}), {
+	target: "draft-2020-12",
+	io: "input",
+	unrepresentable: "any"
+}), I = (e, t = {}) => ({
+	reportId: t.reportId ?? "",
+	backend: e.backend,
+	inputs: e.inputs,
+	displayValues: e.displayValues,
+	modelValues: e.modelValues,
+	reports: e.reports,
+	reportContext: t.reportId === void 0 ? void 0 : k(e, t.reportId),
+	reportContexts: e.reportContexts,
+	meta: e.meta,
+	raw: e.raw,
+	signal: t.signal
+});
+//#endregion
+export { l as _, O as a, a as b, _ as c, m as d, h as f, u as g, d as h, N as i, C as l, s as m, j as n, k as o, g as p, F as r, T as s, I as t, f as u, c as v, o as y };

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

@@ -18,15 +18,11 @@ 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>;
+    inputs: PrimitiveSubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     reports: readonly unknown[];
-    reportContexts?: Record<string, PrimitiveReportContext>;
+    reportContexts: Record<string, PrimitiveReportContext>;
     reportStates: Record<string, unknown>;
     meta: Record<string, unknown>;
     raw: unknown;
@@ -114,16 +110,12 @@ export interface PrimitiveSubmitExecutionResult {
 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>;
+    inputs: PrimitiveSubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     reports: readonly unknown[];
     reportContext?: PrimitiveReportContext;
-    reportContexts?: Record<string, PrimitiveReportContext>;
+    reportContexts: Record<string, PrimitiveReportContext>;
     meta: Record<string, unknown>;
     raw: unknown;
     signal?: AbortSignal;

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

@@ -14,10 +14,6 @@ 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>;
-    serializedFieldValues: Record<string, unknown>;
 };
 export declare const cloneSubmissionValueRecords: (records: SubmissionValueRecords) => SubmissionValueRecords;
 export declare const shouldIncludeFieldInSubmission: (field: SubmissionField, resolveInactiveFieldPolicy: (field: SubmissionField) => "include" | "omit" | "reset-on-hide") => boolean;

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

@@ -10,10 +10,6 @@ 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>;
-    serializedFieldValues: Record<string, unknown>;
 }
 export interface RuntimeBehaviorContext {
     readonly registry: Registry;

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

@@ -17,10 +17,6 @@ export interface BeforeSubmitContext {
     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>;
     submitCount: number;
     signal: AbortSignal;
 }
@@ -29,10 +25,6 @@ export interface AfterSubmitContext {
     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>;
     submitCount: number;
     result: SubmitResult;
 }
@@ -41,10 +33,6 @@ export interface SubmitErrorContext {
     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>;
     submitCount: number;
     error: unknown;
 }

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

@@ -1,9 +1,14 @@
 import { ReportResult } from './types/submit';
 export type MappedToTarget = string | number;
 export type MappedTo = MappedToTarget | Record<string, MappedToTarget | null | undefined>;
+export type MappedToRoute = {
+    backend: string;
+    mappedTo: MappedToTarget;
+};
 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 resolveMappedRoutes: (mappedTo: MappedTo | undefined, backend: string | undefined) => MappedToRoute[];
 export declare const resolveMappedReportResult: (report: {
     mappedTo?: MappedTo;
 }, result: {

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

@@ -1,2 +1,7 @@
 import { FormSchema, NormalizedFormSchema, Registry } from './index';
+export declare class SchemaNormalizationError extends Error {
+    readonly path: readonly (string | number)[];
+    readonly code: "invalid-config" | "unknown-kind";
+    constructor(message: string, path: readonly (string | number)[], code?: "invalid-config" | "unknown-kind");
+}
 export declare const normalizeSchema: (schema: FormSchema, registry: Registry) => NormalizedFormSchema;

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

@@ -2,7 +2,7 @@ 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>;
+    reportContexts: Record<string, ReportContext>;
 };
 type ReportContextLookup = string | number | {
     id?: string;
@@ -12,6 +12,6 @@ type ReportContextLookup = string | number | {
         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 createReportContexts: (reports: readonly NormalizedReportConfig[], result: Pick<SubmitResult, "backend" | "displayValues" | "modelValues" | "reports" | "meta" | "raw">) => Record<string, ReportContext>;
 export declare const getReportContext: (source: ReportContextSource, lookup: ReportContextLookup) => ReportContext | undefined;
 export {};

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

@@ -35,16 +35,12 @@ 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>;
+    inputs: SubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     reports: readonly unknown[];
     reportContext?: ReportContext;
-    reportContexts?: Record<string, ReportContext>;
+    reportContexts: Record<string, ReportContext>;
     meta: Record<string, unknown>;
     raw: unknown;
     signal?: AbortSignal;

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

@@ -46,15 +46,11 @@ export type ReportResult = (BaseReportResult & {
 });
 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>;
+    inputs: SubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     reports: readonly ReportResult[];
-    reportContexts?: Record<string, ReportContext>;
+    reportContexts: Record<string, ReportContext>;
     reportStates: Record<string, TReportState>;
     meta: Record<string, unknown>;
     raw: unknown;

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

@@ -22,4 +22,5 @@ export type SchemaValidationResult = {
 export type SchemaJsonSchema = Record<string, unknown>;
 export declare const findUnknownKinds: (schema: unknown, registry: Registry) => UnknownSchemaKind[];
 export declare const validateSchema: (schema: unknown, registry: Registry) => SchemaValidationResult;
+/** Registered schemas that set metadata ids must use globally unique ids. */
 export declare const toSchemaJsonSchema: (registry: Registry) => SchemaJsonSchema;

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

@@ -1,13 +1,9 @@
 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>;
+    inputs: SubmissionInputRecord[];
+    displayValues: Record<string, unknown>;
+    modelValues: Record<string, unknown>;
     fields: readonly TField[];
     reports: readonly TReport[];
     signal?: AbortSignal;

package/package.json

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