@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.1

package/dist/forms/form-write-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-write-target.js","sourceRoot":"","sources":["../../src/forms/form-write-target.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Form write target — WHICH verb, WHICH record, and what a refusal means.\n *\n * A form binding says how it wants to write (`method: 'PATCH'`), but a PATCH\n * has to name a record and the page only knows one from what its source\n * loaded. When nothing loaded there is nothing to patch; the honest write is a\n * create. Otherwise a Profile form would send `PATCH /records/Attendee` — the\n * collection, no id — the API would answer 404 \"Route not found\", and the\n * page would report it as a field-validation problem with no field\n * highlighted.\n *\n * Two pure functions, so the rule is testable without a DOM and the same\n * answer serves the in-process facade and the HTTP path alike.\n *\n * @module @pwfabric/runtime/forms/form-write-target\n */\n\nimport type { DataFetchError } from '../data/types.js'\nimport type { EntityOperationError } from '../entity/types.js'\n\nexport type FormWriteMethod = 'POST' | 'PUT' | 'PATCH'\n\nexport interface FormWriteTarget {\n  readonly method: FormWriteMethod\n  /** Present only for an update — the id of the record the source has loaded. */\n  readonly recordId?: string\n}\n\n/**\n * The record a source currently binds, if any.\n *\n * A list source binds an array (the platform's record reads always do — see\n * `LIST_KINDS` in DataBoundSurfaceRenderer); a single-record source may bind\n * an object. The FIRST row is the record a form on that page edits: a\n * profile page reads \"me\", a settings page reads \"the one preference row\".\n */\nfunction boundRecord(bound: unknown): Record<string, unknown> | undefined {\n  const candidate = Array.isArray(bound) ? bound[0] : bound\n  return candidate !== null && typeof candidate === 'object' && !Array.isArray(candidate)\n    ? (candidate as Record<string, unknown>)\n    : undefined\n}\n\nexport function resolveFormWriteTarget(method: FormWriteMethod, bound: unknown): FormWriteTarget {\n  if (method === 'POST') return { method: 'POST' }\n  const id = boundRecord(bound)?.['id']\n  const recordId = typeof id === 'string' ? id : typeof id === 'number' ? String(id) : undefined\n  return recordId ? { method, recordId } : { method: 'POST' }\n}\n\n/**\n * The field paths a validation refusal names.\n *\n * The API answers `VALIDATION_FAILED` with `path: message; path: message`\n * (the host's app-records API). Read the paths out so a\n * form can highlight them; keep the whole sentence so the visitor can too.\n */\nfunction fieldPathsOf(message: string): string[] {\n  return message\n    .split(';')\n    .map((part) => part.trim())\n    .filter((part) => part.includes(':'))\n    .map((part) => part.slice(0, part.indexOf(':')).trim())\n    .filter((path) => path.length > 0 && !/\\s/.test(path))\n}\n\nconst VALIDATION_CODES = new Set(['VALIDATION_FAILED', 'INVALID_BODY'])\n\n/**\n * Translate a data-layer refusal into what the form should say.\n *\n * \"Check the highlighted fields\" is reserved for a 400 that names fields.\n * Anything else is the server refusing, and the server's own status and\n * words are the message — a 404 on the collection path is a routing fact,\n * not a problem with what the visitor typed.\n */\nexport function toFormWriteError(err: DataFetchError): EntityOperationError {\n  const { status, code, message } = err\n  if (status === undefined) {\n    return { type: 'connector', message: `Could not reach the server: ${message}` }\n  }\n  if (status === 400 && (code === undefined || VALIDATION_CODES.has(code))) {\n    return {\n      type: 'validation',\n      message: `Check the highlighted fields — ${message}`,\n      details: { status, code, fields: fieldPathsOf(message) },\n    }\n  }\n  const type: EntityOperationError['type'] =\n    status === 404 ? 'not_found' : status === 401 || status === 403 ? 'unauthorized' : 'connector'\n  return {\n    type,\n    message: `The server could not save this record (${status}): ${message}`,\n    details: { status, code },\n  }\n}\n"]}

package/dist/forms/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Form Processing Module
+ *
+ * Form processing capability for surfaces
+ *
+ * Exports:
+ * - Types: FormField, FormState, ValidationRule, FormResult, etc.
+ * - Implementations: DefaultFormValidator, DefaultFormProcessor
+ * - Factory functions: createFormValidator, createFormProcessor
+ * - Utilities: isFormSuccess, isFormFailure, formatValidationErrors
+ *
+ * @module @pwfabric/runtime/forms
+ */
+export type { FormFieldType, ValidationRuleType, ValidationRule, SelectOption, FormField, FormState, FormValidationResult, FormValidationSuccess, FormValidationFailure, FormResult, FormError, FormSubmitHandler, FormProcessor, FormValidator, FormProcessorConfig, ValidationMessages, } from './types.js';
+export { INITIAL_FORM_STATE, DEFAULT_VALIDATION_MESSAGES } from './types.js';
+export { DefaultFormValidator, createFormValidator, validateWithZod, FormSchemas, } from './validator.js';
+export { DefaultFormProcessor, createFormProcessor, isFormSuccess, isFormFailure, formatFormErrors, getErrorMessages, } from './processor.js';
+export { attachFormEntityBridge } from './form-entity-bridge.js';
+export { completeNamedControlValues } from './named-control-values.js';
+export type { FormEntityBridgeConfig, FormWriter, Unsubscribe } from './form-entity-bridge.js';
+export { resolveFormWriteTarget, toFormWriteError } from './form-write-target.js';
+export type { FormWriteMethod, FormWriteTarget } from './form-write-target.js';

package/dist/forms/index.js

@@ -0,0 +1,25 @@
+/**
+ * Form Processing Module
+ *
+ * Form processing capability for surfaces
+ *
+ * Exports:
+ * - Types: FormField, FormState, ValidationRule, FormResult, etc.
+ * - Implementations: DefaultFormValidator, DefaultFormProcessor
+ * - Factory functions: createFormValidator, createFormProcessor
+ * - Utilities: isFormSuccess, isFormFailure, formatValidationErrors
+ *
+ * @module @pwfabric/runtime/forms
+ */
+// Constants
+export { INITIAL_FORM_STATE, DEFAULT_VALIDATION_MESSAGES } from './types.js';
+// Validator
+export { DefaultFormValidator, createFormValidator, validateWithZod, FormSchemas, } from './validator.js';
+// Processor
+export { DefaultFormProcessor, createFormProcessor, isFormSuccess, isFormFailure, formatFormErrors, getErrorMessages, } from './processor.js';
+// Form → Entity Bridge
+export { attachFormEntityBridge } from './form-entity-bridge.js';
+export { completeNamedControlValues } from './named-control-values.js';
+// Which verb / which record a form write addresses, and what a refusal means
+export { resolveFormWriteTarget, toFormWriteError } from './form-write-target.js';
+//# sourceMappingURL=index.js.map

package/dist/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsBH,YAAY;AACZ,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAE5E,YAAY;AACZ,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAA;AAEvB,YAAY;AACZ,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AAEvB,uBAAuB;AACvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAGtE,6EAA6E;AAC7E,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA","sourcesContent":["/**\n * Form Processing Module\n *\n * Form processing capability for surfaces\n *\n * Exports:\n * - Types: FormField, FormState, ValidationRule, FormResult, etc.\n * - Implementations: DefaultFormValidator, DefaultFormProcessor\n * - Factory functions: createFormValidator, createFormProcessor\n * - Utilities: isFormSuccess, isFormFailure, formatValidationErrors\n *\n * @module @pwfabric/runtime/forms\n */\n\n// Types\nexport type {\n  FormFieldType,\n  ValidationRuleType,\n  ValidationRule,\n  SelectOption,\n  FormField,\n  FormState,\n  FormValidationResult,\n  FormValidationSuccess,\n  FormValidationFailure,\n  FormResult,\n  FormError,\n  FormSubmitHandler,\n  FormProcessor,\n  FormValidator,\n  FormProcessorConfig,\n  ValidationMessages,\n} from './types.js'\n\n// Constants\nexport { INITIAL_FORM_STATE, DEFAULT_VALIDATION_MESSAGES } from './types.js'\n\n// Validator\nexport {\n  DefaultFormValidator,\n  createFormValidator,\n  validateWithZod,\n  FormSchemas,\n} from './validator.js'\n\n// Processor\nexport {\n  DefaultFormProcessor,\n  createFormProcessor,\n  isFormSuccess,\n  isFormFailure,\n  formatFormErrors,\n  getErrorMessages,\n} from './processor.js'\n\n// Form → Entity Bridge\nexport { attachFormEntityBridge } from './form-entity-bridge.js'\nexport { completeNamedControlValues } from './named-control-values.js'\nexport type { FormEntityBridgeConfig, FormWriter, Unsubscribe } from './form-entity-bridge.js'\n\n// Which verb / which record a form write addresses, and what a refusal means\nexport { resolveFormWriteTarget, toFormWriteError } from './form-write-target.js'\nexport type { FormWriteMethod, FormWriteTarget } from './form-write-target.js'\n"]}

package/dist/forms/named-control-values.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Named controls that FormData cannot see.
+ *
+ * A form block gathers its values with `new FormData(form)`, which reads
+ * native fields only. A control drawn from buttons — a segmented control, a
+ * custom picker — has no field, so its answer never reached the record even
+ * though the control named itself and wrote its `stateKey` (an RSVP form
+ * would store every reply without its yes/no answer).
+ *
+ * The page state already holds that answer. This completes the submitted
+ * values from `state[stateKey]` for every block inside the form that declares
+ * both a `name` and a `stateKey` — ONLY where FormData carried nothing under
+ * that name, so a native field's own value always wins, and never for a
+ * disabled control (a disabled native field is not submitted either).
+ *
+ * A control that is never touched has written no state; it contributes
+ * nothing here. A block that wants its untouched default submitted renders a
+ * hidden input (foundation's segmented-control does, from 3.1.3).
+ *
+ * @module @pwfabric/runtime/forms/named-control-values
+ */
+import type { Block } from '@pwfabric/core';
+/**
+ * The form's submitted values, completed from page state for named controls
+ * FormData missed. Returns `values` itself when there is nothing to add.
+ */
+export declare function completeNamedControlValues(blocks: readonly Block[], formId: string, values: Record<string, unknown>, state: Record<string, unknown>): Record<string, unknown>;

package/dist/forms/named-control-values.js

@@ -0,0 +1,42 @@
+function findBlock(blocks, id) {
+    for (const block of blocks ?? []) {
+        if (block.id === id)
+            return block;
+        const inner = findBlock(block.children, id);
+        if (inner)
+            return inner;
+    }
+    return undefined;
+}
+function collect(blocks, state, into, seen) {
+    for (const block of blocks ?? []) {
+        const props = (block.props ?? {});
+        const name = props['name'];
+        const stateKey = props['stateKey'];
+        if (typeof name === 'string' &&
+            name &&
+            typeof stateKey === 'string' &&
+            stateKey &&
+            props['disabled'] !== true &&
+            !seen.has(name) &&
+            state[stateKey] !== undefined) {
+            into[name] = state[stateKey];
+            seen.add(name);
+        }
+        collect(block.children, state, into, seen);
+    }
+}
+/**
+ * The form's submitted values, completed from page state for named controls
+ * FormData missed. Returns `values` itself when there is nothing to add.
+ */
+export function completeNamedControlValues(blocks, formId, values, state) {
+    const form = findBlock(blocks, formId);
+    if (!form)
+        return values;
+    const seen = new Set(Object.keys(values));
+    const added = {};
+    collect(form.children, state, added, seen);
+    return Object.keys(added).length > 0 ? { ...values, ...added } : values;
+}
+//# sourceMappingURL=named-control-values.js.map

package/dist/forms/named-control-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-control-values.js","sourceRoot":"","sources":["../../src/forms/named-control-values.ts"],"names":[],"mappings":"AAuBA,SAAS,SAAS,CAAC,MAAoC,EAAE,EAAU;IACjE,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE;YAAE,OAAO,KAAK,CAAA;QACjC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,QAAwC,EAAE,EAAE,CAAC,CAAA;QAC3E,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IACzB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,OAAO,CACd,MAAoC,EACpC,KAA8B,EAC9B,IAA6B,EAC7B,IAAiB;IAEjB,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAA;QAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;QAClC,IACE,OAAO,IAAI,KAAK,QAAQ;YACxB,IAAI;YACJ,OAAO,QAAQ,KAAK,QAAQ;YAC5B,QAAQ;YACR,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI;YAC1B,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YACf,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,EAC7B,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;YAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,QAAwC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAwB,EACxB,MAAc,EACd,MAA+B,EAC/B,KAA8B;IAE9B,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAA;IACxB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACzC,MAAM,KAAK,GAA4B,EAAE,CAAA;IACzC,OAAO,CAAC,IAAI,CAAC,QAAwC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;AACzE,CAAC","sourcesContent":["/**\n * Named controls that FormData cannot see.\n *\n * A form block gathers its values with `new FormData(form)`, which reads\n * native fields only. A control drawn from buttons — a segmented control, a\n * custom picker — has no field, so its answer never reached the record even\n * though the control named itself and wrote its `stateKey` (an RSVP form\n * would store every reply without its yes/no answer).\n *\n * The page state already holds that answer. This completes the submitted\n * values from `state[stateKey]` for every block inside the form that declares\n * both a `name` and a `stateKey` — ONLY where FormData carried nothing under\n * that name, so a native field's own value always wins, and never for a\n * disabled control (a disabled native field is not submitted either).\n *\n * A control that is never touched has written no state; it contributes\n * nothing here. A block that wants its untouched default submitted renders a\n * hidden input (foundation's segmented-control does, from 3.1.3).\n *\n * @module @pwfabric/runtime/forms/named-control-values\n */\nimport type { Block } from '@pwfabric/core'\n\nfunction findBlock(blocks: readonly Block[] | undefined, id: string): Block | undefined {\n  for (const block of blocks ?? []) {\n    if (block.id === id) return block\n    const inner = findBlock(block.children as readonly Block[] | undefined, id)\n    if (inner) return inner\n  }\n  return undefined\n}\n\nfunction collect(\n  blocks: readonly Block[] | undefined,\n  state: Record<string, unknown>,\n  into: Record<string, unknown>,\n  seen: Set<string>\n): void {\n  for (const block of blocks ?? []) {\n    const props = (block.props ?? {}) as Record<string, unknown>\n    const name = props['name']\n    const stateKey = props['stateKey']\n    if (\n      typeof name === 'string' &&\n      name &&\n      typeof stateKey === 'string' &&\n      stateKey &&\n      props['disabled'] !== true &&\n      !seen.has(name) &&\n      state[stateKey] !== undefined\n    ) {\n      into[name] = state[stateKey]\n      seen.add(name)\n    }\n    collect(block.children as readonly Block[] | undefined, state, into, seen)\n  }\n}\n\n/**\n * The form's submitted values, completed from page state for named controls\n * FormData missed. Returns `values` itself when there is nothing to add.\n */\nexport function completeNamedControlValues(\n  blocks: readonly Block[],\n  formId: string,\n  values: Record<string, unknown>,\n  state: Record<string, unknown>\n): Record<string, unknown> {\n  const form = findBlock(blocks, formId)\n  if (!form) return values\n  const seen = new Set(Object.keys(values))\n  const added: Record<string, unknown> = {}\n  collect(form.children as readonly Block[] | undefined, state, added, seen)\n  return Object.keys(added).length > 0 ? { ...values, ...added } : values\n}\n"]}

package/dist/forms/processor.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Form Processor
+ *
+ * Form processing implementation
+ *
+ * @module @pwfabric/runtime/forms/processor
+ */
+import type { ZodType } from 'zod';
+import type { FormProcessor, FormField, FormSubmitHandler, FormResult, FormError, FormValidationResult, FormProcessorConfig } from './types.js';
+/**
+ * Default form processor implementation
+ */
+export declare class DefaultFormProcessor implements FormProcessor {
+    private readonly validator;
+    private readonly config;
+    constructor(config?: FormProcessorConfig);
+    validate(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult;
+    validateWithSchema<T>(values: Record<string, unknown>, schema: ZodType<T>): FormValidationResult;
+    process<T>(_formId: string, values: Record<string, unknown>, handler: FormSubmitHandler<T>): Promise<FormResult<T>>;
+    /**
+     * Process form with validation
+     */
+    processWithValidation<T>(formId: string, values: Record<string, unknown>, fields: readonly FormField[], handler: FormSubmitHandler<T>): Promise<FormResult<T>>;
+    /**
+     * Process form with Zod schema validation
+     */
+    processWithSchema<T, TOutput>(formId: string, values: Record<string, unknown>, schema: ZodType<TOutput>, handler: FormSubmitHandler<T>): Promise<FormResult<T>>;
+    private createFormError;
+}
+/**
+ * Create a form processor
+ */
+export declare function createFormProcessor(config?: FormProcessorConfig): FormProcessor;
+/**
+ * Check if a form result is successful
+ */
+export declare function isFormSuccess<T>(result: FormResult<T>): result is {
+    success: true;
+    data: T;
+};
+/**
+ * Check if a form result is a failure
+ */
+export declare function isFormFailure<T>(result: FormResult<T>): result is {
+    success: false;
+    error: FormError;
+};
+/**
+ * Format form validation errors into a single message
+ */
+export declare function formatFormErrors(errors: Record<string, string[]>): string;
+/**
+ * Get all error messages as a flat array
+ */
+export declare function getErrorMessages(errors: Record<string, string[]>): string[];

package/dist/forms/processor.js

@@ -0,0 +1,154 @@
+/**
+ * Form Processor
+ *
+ * Form processing implementation
+ *
+ * @module @pwfabric/runtime/forms/processor
+ */
+import { DefaultFormValidator, validateWithZod } from './validator.js';
+// ============================================================
+// DEFAULT FORM PROCESSOR
+// ============================================================
+/**
+ * Default form processor implementation
+ */
+export class DefaultFormProcessor {
+    validator;
+    config;
+    constructor(config = {}) {
+        this.validator = new DefaultFormValidator(config.messages);
+        this.config = {
+            validateOnSubmit: config.validateOnSubmit ?? true,
+            validateOnBlur: config.validateOnBlur ?? true,
+            validateOnChange: config.validateOnChange ?? false,
+            messages: config.messages ?? {},
+        };
+    }
+    validate(values, fields) {
+        return this.validator.validateAll(values, fields);
+    }
+    validateWithSchema(values, schema) {
+        return validateWithZod(values, schema);
+    }
+    async process(_formId, values, handler) {
+        try {
+            const result = await handler(values);
+            return {
+                success: true,
+                data: result,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: this.createFormError(error),
+            };
+        }
+    }
+    /**
+     * Process form with validation
+     */
+    async processWithValidation(formId, values, fields, handler) {
+        // Validate first if enabled
+        if (this.config.validateOnSubmit) {
+            const validationResult = this.validate(values, fields);
+            if (!validationResult.valid) {
+                return {
+                    success: false,
+                    error: {
+                        type: 'validation_failed',
+                        message: 'Form validation failed',
+                        validationErrors: validationResult.errors,
+                    },
+                };
+            }
+        }
+        return this.process(formId, values, handler);
+    }
+    /**
+     * Process form with Zod schema validation
+     */
+    async processWithSchema(formId, values, schema, handler) {
+        // Validate with Zod schema
+        const validationResult = this.validateWithSchema(values, schema);
+        if (!validationResult.valid) {
+            return {
+                success: false,
+                error: {
+                    type: 'validation_failed',
+                    message: 'Form validation failed',
+                    validationErrors: validationResult.errors,
+                },
+            };
+        }
+        return this.process(formId, values, handler);
+    }
+    createFormError(error) {
+        if (error instanceof Error) {
+            // Check for network errors
+            if (error.name === 'NetworkError' ||
+                error.message.includes('network') ||
+                error.message.includes('fetch')) {
+                return {
+                    type: 'network_error',
+                    message: 'A network error occurred. Please try again.',
+                    cause: error,
+                };
+            }
+            return {
+                type: 'processing_failed',
+                message: error.message,
+                cause: error,
+            };
+        }
+        return {
+            type: 'unknown',
+            message: 'An unexpected error occurred',
+            cause: error,
+        };
+    }
+}
+/**
+ * Create a form processor
+ */
+export function createFormProcessor(config) {
+    return new DefaultFormProcessor(config);
+}
+// ============================================================
+// HELPER FUNCTIONS
+// ============================================================
+/**
+ * Check if a form result is successful
+ */
+export function isFormSuccess(result) {
+    return result.success;
+}
+/**
+ * Check if a form result is a failure
+ */
+export function isFormFailure(result) {
+    return !result.success;
+}
+/**
+ * Format form validation errors into a single message
+ */
+export function formatFormErrors(errors) {
+    const messages = [];
+    for (const [field, fieldErrors] of Object.entries(errors)) {
+        for (const error of fieldErrors) {
+            messages.push(`${field}: ${error}`);
+        }
+    }
+    return messages.join('. ');
+}
+/**
+ * Get all error messages as a flat array
+ */
+export function getErrorMessages(errors) {
+    const messages = [];
+    for (const fieldErrors of Object.values(errors)) {
+        messages.push(...fieldErrors);
+    }
+    return messages;
+}
+//# sourceMappingURL=processor.js.map

package/dist/forms/processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.js","sourceRoot":"","sources":["../../src/forms/processor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Form Processor\n *\n * Form processing implementation\n *\n * @module @pwfabric/runtime/forms/processor\n */\n\nimport type { ZodType } from 'zod'\nimport type {\n  FormProcessor,\n  FormField,\n  FormSubmitHandler,\n  FormResult,\n  FormError,\n  FormValidationResult,\n  FormProcessorConfig,\n} from './types.js'\nimport { DefaultFormValidator, validateWithZod } from './validator.js'\n\n// ============================================================\n// DEFAULT FORM PROCESSOR\n// ============================================================\n\n/**\n * Default form processor implementation\n */\nexport class DefaultFormProcessor implements FormProcessor {\n  private readonly validator: DefaultFormValidator\n  private readonly config: Required<FormProcessorConfig>\n\n  constructor(config: FormProcessorConfig = {}) {\n    this.validator = new DefaultFormValidator(config.messages)\n    this.config = {\n      validateOnSubmit: config.validateOnSubmit ?? true,\n      validateOnBlur: config.validateOnBlur ?? true,\n      validateOnChange: config.validateOnChange ?? false,\n      messages: config.messages ?? {},\n    }\n  }\n\n  validate(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult {\n    return this.validator.validateAll(values, fields)\n  }\n\n  validateWithSchema<T>(values: Record<string, unknown>, schema: ZodType<T>): FormValidationResult {\n    return validateWithZod(values, schema)\n  }\n\n  async process<T>(\n    _formId: string,\n    values: Record<string, unknown>,\n    handler: FormSubmitHandler<T>\n  ): Promise<FormResult<T>> {\n    try {\n      const result = await handler(values)\n      return {\n        success: true,\n        data: result,\n      }\n    } catch (error) {\n      return {\n        success: false,\n        error: this.createFormError(error),\n      }\n    }\n  }\n\n  /**\n   * Process form with validation\n   */\n  async processWithValidation<T>(\n    formId: string,\n    values: Record<string, unknown>,\n    fields: readonly FormField[],\n    handler: FormSubmitHandler<T>\n  ): Promise<FormResult<T>> {\n    // Validate first if enabled\n    if (this.config.validateOnSubmit) {\n      const validationResult = this.validate(values, fields)\n\n      if (!validationResult.valid) {\n        return {\n          success: false,\n          error: {\n            type: 'validation_failed',\n            message: 'Form validation failed',\n            validationErrors: validationResult.errors,\n          },\n        }\n      }\n    }\n\n    return this.process(formId, values, handler)\n  }\n\n  /**\n   * Process form with Zod schema validation\n   */\n  async processWithSchema<T, TOutput>(\n    formId: string,\n    values: Record<string, unknown>,\n    schema: ZodType<TOutput>,\n    handler: FormSubmitHandler<T>\n  ): Promise<FormResult<T>> {\n    // Validate with Zod schema\n    const validationResult = this.validateWithSchema(values, schema)\n\n    if (!validationResult.valid) {\n      return {\n        success: false,\n        error: {\n          type: 'validation_failed',\n          message: 'Form validation failed',\n          validationErrors: validationResult.errors,\n        },\n      }\n    }\n\n    return this.process(formId, values, handler)\n  }\n\n  private createFormError(error: unknown): FormError {\n    if (error instanceof Error) {\n      // Check for network errors\n      if (\n        error.name === 'NetworkError' ||\n        error.message.includes('network') ||\n        error.message.includes('fetch')\n      ) {\n        return {\n          type: 'network_error',\n          message: 'A network error occurred. Please try again.',\n          cause: error,\n        }\n      }\n\n      return {\n        type: 'processing_failed',\n        message: error.message,\n        cause: error,\n      }\n    }\n\n    return {\n      type: 'unknown',\n      message: 'An unexpected error occurred',\n      cause: error,\n    }\n  }\n}\n\n/**\n * Create a form processor\n */\nexport function createFormProcessor(config?: FormProcessorConfig): FormProcessor {\n  return new DefaultFormProcessor(config)\n}\n\n// ============================================================\n// HELPER FUNCTIONS\n// ============================================================\n\n/**\n * Check if a form result is successful\n */\nexport function isFormSuccess<T>(result: FormResult<T>): result is { success: true; data: T } {\n  return result.success\n}\n\n/**\n * Check if a form result is a failure\n */\nexport function isFormFailure<T>(\n  result: FormResult<T>\n): result is { success: false; error: FormError } {\n  return !result.success\n}\n\n/**\n * Format form validation errors into a single message\n */\nexport function formatFormErrors(errors: Record<string, string[]>): string {\n  const messages: string[] = []\n\n  for (const [field, fieldErrors] of Object.entries(errors)) {\n    for (const error of fieldErrors) {\n      messages.push(`${field}: ${error}`)\n    }\n  }\n\n  return messages.join('. ')\n}\n\n/**\n * Get all error messages as a flat array\n */\nexport function getErrorMessages(errors: Record<string, string[]>): string[] {\n  const messages: string[] = []\n\n  for (const fieldErrors of Object.values(errors)) {\n    messages.push(...fieldErrors)\n  }\n\n  return messages\n}\n"]}

package/dist/forms/types.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Form Processing Types
+ *
+ * Form processing capability for surfaces
+ *
+ * @module @pwfabric/runtime/forms/types
+ */
+import type { ZodType } from 'zod';
+/**
+ * Form field input type
+ */
+export type FormFieldType = 'text' | 'email' | 'number' | 'select' | 'checkbox' | 'textarea' | 'password' | 'tel' | 'url' | 'date' | 'hidden';
+/**
+ * Validation rule type
+ */
+export type ValidationRuleType = 'required' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'email' | 'url' | 'custom';
+/**
+ * Validation rule definition
+ */
+export interface ValidationRule {
+    readonly type: ValidationRuleType;
+    readonly value?: unknown;
+    readonly message: string;
+}
+/**
+ * Select option for select fields
+ */
+export interface SelectOption {
+    readonly value: string | number;
+    readonly label: string;
+    readonly disabled?: boolean;
+}
+/**
+ * Form field definition
+ */
+export interface FormField {
+    readonly name: string;
+    readonly type: FormFieldType;
+    readonly label?: string;
+    readonly placeholder?: string;
+    readonly required?: boolean;
+    readonly disabled?: boolean;
+    readonly defaultValue?: unknown;
+    readonly validation?: readonly ValidationRule[];
+    readonly options?: readonly SelectOption[];
+}
+/**
+ * Form state tracking
+ */
+export interface FormState {
+    readonly values: Record<string, unknown>;
+    readonly errors: Record<string, string[]>;
+    readonly touched: Record<string, boolean>;
+    readonly isValid: boolean;
+    readonly isSubmitting: boolean;
+    readonly isDirty: boolean;
+    readonly submitCount: number;
+}
+/**
+ * Initial form state
+ */
+export declare const INITIAL_FORM_STATE: FormState;
+/**
+ * Result of validating form values
+ */
+export interface FormValidationResult {
+    readonly valid: boolean;
+    readonly errors: Record<string, string[]>;
+}
+/**
+ * Successful validation result
+ */
+export interface FormValidationSuccess extends FormValidationResult {
+    readonly valid: true;
+    readonly errors: Record<string, never>;
+}
+/**
+ * Failed validation result
+ */
+export interface FormValidationFailure extends FormValidationResult {
+    readonly valid: false;
+    readonly errors: Record<string, string[]>;
+}
+/**
+ * Result of form processing
+ */
+export type FormResult<T = unknown> = {
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly success: false;
+    readonly error: FormError;
+};
+/**
+ * Form processing error
+ */
+export interface FormError {
+    readonly type: 'validation_failed' | 'processing_failed' | 'network_error' | 'unknown';
+    readonly message: string;
+    readonly validationErrors?: Record<string, string[]>;
+    readonly cause?: unknown;
+}
+/**
+ * Form submission handler function
+ */
+export type FormSubmitHandler<T = unknown> = (values: Record<string, unknown>) => Promise<T> | T;
+/**
+ * Form processor interface
+ */
+export interface FormProcessor {
+    /**
+     * Validate form values against field definitions
+     */
+    validate(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult;
+    /**
+     * Validate form values using a Zod schema
+     */
+    validateWithSchema<T>(values: Record<string, unknown>, schema: ZodType<T>): FormValidationResult;
+    /**
+     * Process a form submission
+     */
+    process<T>(formId: string, values: Record<string, unknown>, handler: FormSubmitHandler<T>): Promise<FormResult<T>>;
+}
+/**
+ * Form validator interface
+ */
+export interface FormValidator {
+    /**
+     * Validate a single field value
+     */
+    validateField(value: unknown, field: FormField): string[];
+    /**
+     * Validate all fields
+     */
+    validateAll(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult;
+}
+/**
+ * Form processor configuration
+ */
+export interface FormProcessorConfig {
+    /**
+     * Whether to validate on submit
+     */
+    readonly validateOnSubmit?: boolean;
+    /**
+     * Whether to validate individual fields on blur
+     */
+    readonly validateOnBlur?: boolean;
+    /**
+     * Whether to validate individual fields on change
+     */
+    readonly validateOnChange?: boolean;
+    /**
+     * Custom error messages
+     */
+    readonly messages?: Partial<ValidationMessages>;
+}
+/**
+ * Default validation error messages
+ */
+export interface ValidationMessages {
+    readonly required: string;
+    readonly email: string;
+    readonly url: string;
+    readonly minLength: string;
+    readonly maxLength: string;
+    readonly min: string;
+    readonly max: string;
+    readonly pattern: string;
+}
+/**
+ * Default validation messages
+ */
+export declare const DEFAULT_VALIDATION_MESSAGES: ValidationMessages;

package/dist/forms/types.js

@@ -0,0 +1,33 @@
+/**
+ * Form Processing Types
+ *
+ * Form processing capability for surfaces
+ *
+ * @module @pwfabric/runtime/forms/types
+ */
+/**
+ * Initial form state
+ */
+export const INITIAL_FORM_STATE = {
+    values: {},
+    errors: {},
+    touched: {},
+    isValid: true,
+    isSubmitting: false,
+    isDirty: false,
+    submitCount: 0,
+};
+/**
+ * Default validation messages
+ */
+export const DEFAULT_VALIDATION_MESSAGES = {
+    required: 'This field is required',
+    email: 'Please enter a valid email address',
+    url: 'Please enter a valid URL',
+    minLength: 'Must be at least {value} characters',
+    maxLength: 'Must be no more than {value} characters',
+    min: 'Must be at least {value}',
+    max: 'Must be no more than {value}',
+    pattern: 'Invalid format',
+};
+//# sourceMappingURL=types.js.map

package/dist/forms/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/forms/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwFH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,KAAK;IACnB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,CAAC;CACf,CAAA;AAkJD;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAuB;IAC7D,QAAQ,EAAE,wBAAwB;IAClC,KAAK,EAAE,oCAAoC;IAC3C,GAAG,EAAE,0BAA0B;IAC/B,SAAS,EAAE,qCAAqC;IAChD,SAAS,EAAE,yCAAyC;IACpD,GAAG,EAAE,0BAA0B;IAC/B,GAAG,EAAE,8BAA8B;IACnC,OAAO,EAAE,gBAAgB;CAC1B,CAAA","sourcesContent":["/**\n * Form Processing Types\n *\n * Form processing capability for surfaces\n *\n * @module @pwfabric/runtime/forms/types\n */\n\nimport type { ZodType } from 'zod'\n\n// ============================================================\n// FORM FIELD TYPES\n// ============================================================\n\n/**\n * Form field input type\n */\nexport type FormFieldType =\n  | 'text'\n  | 'email'\n  | 'number'\n  | 'select'\n  | 'checkbox'\n  | 'textarea'\n  | 'password'\n  | 'tel'\n  | 'url'\n  | 'date'\n  | 'hidden'\n\n/**\n * Validation rule type\n */\nexport type ValidationRuleType =\n  | 'required'\n  | 'minLength'\n  | 'maxLength'\n  | 'min'\n  | 'max'\n  | 'pattern'\n  | 'email'\n  | 'url'\n  | 'custom'\n\n/**\n * Validation rule definition\n */\nexport interface ValidationRule {\n  readonly type: ValidationRuleType\n  readonly value?: unknown\n  readonly message: string\n}\n\n/**\n * Select option for select fields\n */\nexport interface SelectOption {\n  readonly value: string | number\n  readonly label: string\n  readonly disabled?: boolean\n}\n\n/**\n * Form field definition\n */\nexport interface FormField {\n  readonly name: string\n  readonly type: FormFieldType\n  readonly label?: string\n  readonly placeholder?: string\n  readonly required?: boolean\n  readonly disabled?: boolean\n  readonly defaultValue?: unknown\n  readonly validation?: readonly ValidationRule[]\n  readonly options?: readonly SelectOption[] // For select fields\n}\n\n// ============================================================\n// FORM STATE\n// ============================================================\n\n/**\n * Form state tracking\n */\nexport interface FormState {\n  readonly values: Record<string, unknown>\n  readonly errors: Record<string, string[]>\n  readonly touched: Record<string, boolean>\n  readonly isValid: boolean\n  readonly isSubmitting: boolean\n  readonly isDirty: boolean\n  readonly submitCount: number\n}\n\n/**\n * Initial form state\n */\nexport const INITIAL_FORM_STATE: FormState = {\n  values: {},\n  errors: {},\n  touched: {},\n  isValid: true,\n  isSubmitting: false,\n  isDirty: false,\n  submitCount: 0,\n}\n\n// ============================================================\n// FORM VALIDATION RESULT\n// ============================================================\n\n/**\n * Result of validating form values\n */\nexport interface FormValidationResult {\n  readonly valid: boolean\n  readonly errors: Record<string, string[]>\n}\n\n/**\n * Successful validation result\n */\nexport interface FormValidationSuccess extends FormValidationResult {\n  readonly valid: true\n  readonly errors: Record<string, never>\n}\n\n/**\n * Failed validation result\n */\nexport interface FormValidationFailure extends FormValidationResult {\n  readonly valid: false\n  readonly errors: Record<string, string[]>\n}\n\n// ============================================================\n// FORM RESULT\n// ============================================================\n\n/**\n * Result of form processing\n */\nexport type FormResult<T = unknown> =\n  | { readonly success: true; readonly data: T }\n  | { readonly success: false; readonly error: FormError }\n\n/**\n * Form processing error\n */\nexport interface FormError {\n  readonly type: 'validation_failed' | 'processing_failed' | 'network_error' | 'unknown'\n  readonly message: string\n  readonly validationErrors?: Record<string, string[]>\n  readonly cause?: unknown\n}\n\n// ============================================================\n// FORM PROCESSOR\n// ============================================================\n\n/**\n * Form submission handler function\n */\nexport type FormSubmitHandler<T = unknown> = (values: Record<string, unknown>) => Promise<T> | T\n\n/**\n * Form processor interface\n */\nexport interface FormProcessor {\n  /**\n   * Validate form values against field definitions\n   */\n  validate(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult\n\n  /**\n   * Validate form values using a Zod schema\n   */\n  validateWithSchema<T>(values: Record<string, unknown>, schema: ZodType<T>): FormValidationResult\n\n  /**\n   * Process a form submission\n   */\n  process<T>(\n    formId: string,\n    values: Record<string, unknown>,\n    handler: FormSubmitHandler<T>\n  ): Promise<FormResult<T>>\n}\n\n// ============================================================\n// FORM VALIDATOR\n// ============================================================\n\n/**\n * Form validator interface\n */\nexport interface FormValidator {\n  /**\n   * Validate a single field value\n   */\n  validateField(value: unknown, field: FormField): string[]\n\n  /**\n   * Validate all fields\n   */\n  validateAll(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult\n}\n\n// ============================================================\n// FORM CONFIGURATION\n// ============================================================\n\n/**\n * Form processor configuration\n */\nexport interface FormProcessorConfig {\n  /**\n   * Whether to validate on submit\n   */\n  readonly validateOnSubmit?: boolean\n\n  /**\n   * Whether to validate individual fields on blur\n   */\n  readonly validateOnBlur?: boolean\n\n  /**\n   * Whether to validate individual fields on change\n   */\n  readonly validateOnChange?: boolean\n\n  /**\n   * Custom error messages\n   */\n  readonly messages?: Partial<ValidationMessages>\n}\n\n/**\n * Default validation error messages\n */\nexport interface ValidationMessages {\n  readonly required: string\n  readonly email: string\n  readonly url: string\n  readonly minLength: string\n  readonly maxLength: string\n  readonly min: string\n  readonly max: string\n  readonly pattern: string\n}\n\n/**\n * Default validation messages\n */\nexport const DEFAULT_VALIDATION_MESSAGES: ValidationMessages = {\n  required: 'This field is required',\n  email: 'Please enter a valid email address',\n  url: 'Please enter a valid URL',\n  minLength: 'Must be at least {value} characters',\n  maxLength: 'Must be no more than {value} characters',\n  min: 'Must be at least {value}',\n  max: 'Must be no more than {value}',\n  pattern: 'Invalid format',\n}\n"]}