@seifer-webapp-factory/kits 0.1.0

package/dist/frontend/forms/core/form.js

@@ -0,0 +1,179 @@
+import { FORM_LEVEL_KEY } from './ports.js';
+import { FormBusyError, ServerValidationError } from './errors.js';
+function clone(value) {
+    return structuredClone(value);
+}
+/** Structurele gelijkheid voor dirty-vergelijking tegen de initiële snapshot. */
+function equals(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null || typeof a !== 'object' || typeof b !== 'object')
+        return false;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((item, i) => equals(item, b[i]));
+    }
+    const ao = a;
+    const bo = b;
+    const ak = Object.keys(ao);
+    const bk = Object.keys(bo);
+    if (ak.length !== bk.length)
+        return false;
+    return ak.every((key) => Object.prototype.hasOwnProperty.call(bo, key) && equals(ao[key], bo[key]));
+}
+/**
+ * Bouwt een form-state-engine uit een geïnjecteerd schema + beginwaarden. Domein-loos: de kit
+ * kent geen concrete velden — die volgen uit `initialValues` en het schema. Per aanroep een eigen
+ * state (geen module-globale mutable state).
+ */
+export function createForm(schema, options) {
+    if (schema == null || typeof schema.parse !== 'function') {
+        throw new Error('[forms] createForm(): schema ontbreekt of is geen geldig FormSchema (verwacht een parse()-poort, bv. zodFormSchema(...)).');
+    }
+    if (options == null || options.initialValues == null || typeof options.initialValues !== 'object') {
+        throw new Error('[forms] createForm(): initialValues ontbreekt of is geen object.');
+    }
+    const createState = options.createState ?? ((snapshot) => snapshot);
+    const submitHandler = options.submitHandler;
+    const knownFields = new Set(Object.keys(options.initialValues));
+    let baseline = clone(options.initialValues);
+    const state = createState({
+        values: clone(options.initialValues),
+        touched: {},
+        errors: {},
+        isSubmitting: false,
+    });
+    function toFieldError(code, message, params) {
+        return params === undefined ? { code, message } : { code, message, params };
+    }
+    function hasField(path) {
+        return knownFields.has(path);
+    }
+    function getFieldErrors(path) {
+        return state.errors[path] ?? [];
+    }
+    function isFieldTouched(path) {
+        return state.touched[path] === true;
+    }
+    function isFieldDirty(path) {
+        return !equals(state.values[path], baseline[path]);
+    }
+    function isDirty() {
+        const keys = new Set([...Object.keys(baseline), ...Object.keys(state.values)]);
+        for (const key of keys) {
+            if (isFieldDirty(key))
+                return true;
+        }
+        return false;
+    }
+    function isTouched() {
+        return Object.values(state.touched).some((t) => t === true);
+    }
+    function isValid() {
+        return Object.values(state.errors).every((list) => list.length === 0);
+    }
+    function isSubmitting() {
+        return state.isSubmitting;
+    }
+    function setFieldValue(path, value) {
+        state.values[path] = value;
+    }
+    function setTouched(path, touched = true) {
+        state.touched[path] = touched;
+    }
+    function validate() {
+        const result = schema.parse(state.values);
+        const next = {};
+        if (!result.ok) {
+            for (const v of result.violations) {
+                (next[v.path] ??= []).push(toFieldError(v.code, v.message, v.params));
+            }
+        }
+        state.errors = next;
+        return result;
+    }
+    function validateField(path) {
+        const result = schema.parse(state.values);
+        const forField = result.ok
+            ? []
+            : result.violations
+                .filter((v) => v.path === path)
+                .map((v) => toFieldError(v.code, v.message, v.params));
+        const next = { ...state.errors };
+        if (forField.length > 0) {
+            next[path] = forField;
+        }
+        else {
+            delete next[path];
+        }
+        state.errors = next;
+        return result;
+    }
+    function applyServerErrors(errors) {
+        const next = { ...state.errors };
+        for (const [path, messages] of Object.entries(errors)) {
+            next[path] = messages.map((message) => ({ message }));
+        }
+        state.errors = next;
+    }
+    function reset(snapshot) {
+        if (state.isSubmitting) {
+            throw new FormBusyError('reset');
+        }
+        const base = snapshot ?? baseline;
+        baseline = clone(base);
+        state.values = clone(base);
+        state.touched = {};
+        state.errors = {};
+    }
+    async function handleSubmit() {
+        if (state.isSubmitting) {
+            return { status: 'ignored' };
+        }
+        const result = validate();
+        if (!result.ok) {
+            return { status: 'invalid', violations: result.violations };
+        }
+        if (submitHandler === undefined) {
+            throw new Error('[forms] handleSubmit(): geen submitHandler geïnjecteerd. Geef er één mee aan createForm/useForm.');
+        }
+        state.isSubmitting = true;
+        try {
+            await submitHandler(result.value);
+            return { status: 'success' };
+        }
+        catch (err) {
+            if (err instanceof ServerValidationError) {
+                applyServerErrors(err.errors);
+            }
+            else {
+                const message = err instanceof Error ? err.message : String(err);
+                applyServerErrors({ [FORM_LEVEL_KEY]: [message] });
+            }
+            return { status: 'error' };
+        }
+        finally {
+            state.isSubmitting = false;
+        }
+    }
+    return {
+        state,
+        hasField,
+        getFieldErrors,
+        isFieldTouched,
+        isFieldDirty,
+        isDirty,
+        isTouched,
+        isValid,
+        isSubmitting,
+        setFieldValue,
+        setTouched,
+        validate,
+        validateField,
+        applyServerErrors,
+        reset,
+        handleSubmit,
+    };
+}
+//# sourceMappingURL=form.js.map

package/dist/frontend/forms/core/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../../../../frontend/src/forms/core/form.ts"],"names":[],"mappings":"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"}

package/dist/frontend/forms/core/index.d.ts

@@ -0,0 +1,6 @@
+export type { FieldPath, FieldViolation, FormParseResult, FormSchema, FieldError, FieldErrors, FormValues, ServerErrors, Translate, SubmitHandler, SubmitStatus, SubmitOutcome, } from './ports.js';
+export { FORM_LEVEL_KEY } from './ports.js';
+export { ServerValidationError, FormBusyError } from './errors.js';
+export { createForm } from './form.js';
+export type { FormEngine, CreateFormOptions, FormStateSnapshot } from './form.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/forms/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../frontend/src/forms/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}

package/dist/frontend/forms/core/index.js

@@ -0,0 +1,4 @@
+export { FORM_LEVEL_KEY } from './ports.js';
+export { ServerValidationError, FormBusyError } from './errors.js';
+export { createForm } from './form.js';
+//# sourceMappingURL=index.js.map

package/dist/frontend/forms/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../frontend/src/forms/core/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/frontend/forms/core/ports.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Ports voor de forms-kit. De core kent alleen deze abstracties; het project levert de
+ * adapters (schema, submit-handler) en optioneel een translate-functie. Geen domeinkennis,
+ * geen veldnaam-kennis, geen framework.
+ */
+/** Sleutel voor form-brede (niet-veld-gebonden) fouten in de errors-map. */
+export declare const FORM_LEVEL_KEY = "";
+/** Een veld-pad (top-level veldnaam). */
+export type FieldPath = string;
+/**
+ * Genormaliseerd validatie-issue: pad + code + boodschap, plus optionele params voor de
+ * translate-resolver (bv. `minimum` bij `too_small`). Nooit de rauwe invoerwaarde.
+ */
+export interface FieldViolation {
+    readonly path: FieldPath;
+    readonly code: string;
+    readonly message: string;
+    readonly params?: Readonly<Record<string, unknown>>;
+}
+/** Resultaat van een schema-parse: succes met getypte waarde, of falen met issues. */
+export type FormParseResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly violations: readonly FieldViolation[];
+};
+/**
+ * Schema-port: valideert een rauwe record en leidt het type af. Adapter: `zodFormSchema(...)`.
+ */
+export interface FormSchema<T> {
+    parse(input: unknown): FormParseResult<T>;
+}
+/**
+ * Een enkele veldfout zoals opgeslagen in de form-state. `code` is aanwezig bij
+ * client-validatie (i18n-sleutel); server-berichten dragen enkel een kant-en-klare `message`.
+ */
+export interface FieldError {
+    readonly code?: string;
+    readonly message: string;
+    readonly params?: Readonly<Record<string, unknown>>;
+}
+/** Platte waarden per top-level veld. */
+export type FormValues = Record<FieldPath, unknown>;
+/** Fouten per veld-pad (form-brede fouten onder `FORM_LEVEL_KEY`). */
+export type FieldErrors = Readonly<Record<FieldPath, readonly FieldError[]>>;
+/** Server-fout-contract: veld-pad → boodschappen (form-breed onder `FORM_LEVEL_KEY`). */
+export type ServerErrors = Readonly<Record<FieldPath, readonly string[]>>;
+/**
+ * Translate-port (optioneel): vertaalt een sleutel (bv. een issue-code) met optionele params.
+ * Wordt geïnjecteerd via de i18n-kit; ontbreekt die, dan valt de kit terug op de code als sleutel.
+ */
+export type Translate = (key: string, params?: Readonly<Record<string, unknown>>) => string;
+/**
+ * Submit-handler-port: async actie die de geldige, getypte waarden verwerkt. Werpt bij falen;
+ * een `ServerValidationError` mapt terug naar velden, elke andere fout landt form-breed.
+ */
+export interface SubmitHandler<T> {
+    (values: T): Promise<void> | void;
+}
+/** Uitkomst van de submit-lifecycle. */
+export type SubmitStatus = 'success' | 'error' | 'invalid' | 'ignored';
+export interface SubmitOutcome {
+    readonly status: SubmitStatus;
+    /** Client-side violations bij `status: 'invalid'`. */
+    readonly violations?: readonly FieldViolation[];
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/frontend/forms/core/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../../frontend/src/forms/core/ports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,sFAAsF;AACtF,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAEpD,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC,CAAC,CAAC;AAE7E,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,CAAC;AAE5F;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnC;AAED,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACjD"}

package/dist/frontend/forms/core/ports.js

@@ -0,0 +1,8 @@
+/**
+ * Ports voor de forms-kit. De core kent alleen deze abstracties; het project levert de
+ * adapters (schema, submit-handler) en optioneel een translate-functie. Geen domeinkennis,
+ * geen veldnaam-kennis, geen framework.
+ */
+/** Sleutel voor form-brede (niet-veld-gebonden) fouten in de errors-map. */
+export const FORM_LEVEL_KEY = '';
+//# sourceMappingURL=ports.js.map

package/dist/frontend/forms/core/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../../frontend/src/forms/core/ports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC"}

package/dist/frontend/forms/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * forms-kit (frontend) — getypte, schema-gedreven form-state + validatie, veld-binding met
+ * toegankelijke i18n-bewuste fouten, submit-lifecycle met server-fout-mapping en dirty/touched/
+ * reset. Pure core + adapters; framework-vrij en SSR/hydratie-veilig (geen module-globale state).
+ */
+export type { FieldPath, FieldViolation, FormParseResult, FormSchema, FieldError, FieldErrors, FormValues, ServerErrors, Translate, SubmitHandler, SubmitStatus, SubmitOutcome, } from './core/ports.js';
+export { FORM_LEVEL_KEY } from './core/ports.js';
+export { ServerValidationError, FormBusyError } from './core/errors.js';
+export { createForm } from './core/form.js';
+export type { FormEngine, CreateFormOptions, FormStateSnapshot } from './core/form.js';
+export { zodFormSchema } from './adapters/zod-schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../frontend/src/forms/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/frontend/forms/index.js

@@ -0,0 +1,5 @@
+export { FORM_LEVEL_KEY } from './core/ports.js';
+export { ServerValidationError, FormBusyError } from './core/errors.js';
+export { createForm } from './core/form.js';
+export { zodFormSchema } from './adapters/zod-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/frontend/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../frontend/src/forms/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/frontend/forms/nuxt/module.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Nuxt-module-adapter (dun) voor de forms-kit. Registreert een plugin dat — indien de i18n-kit
+ * aanwezig is — de i18n-resolver als forms-translate op de Vue-app provside, zodat veldfouten
+ * vertaald worden. De form-state/logica zit volledig in de core (`createForm`, `useForm`); deze
+ * module doet alleen Nuxt-wiring.
+ *
+ * De plugin-code wordt als template geëmit (door Nuxt's build getypecheckt, niet door onze tsc),
+ * zodat we niet afhankelijk zijn van Nuxt's `#app`-virtuals in dit package.
+ */
+export interface FormsKitModuleOptions {
+    /** Koppel de i18n-resolver (indien geprovide) automatisch als forms-translate. Default: true. */
+    readonly useI18nResolver?: boolean;
+}
+declare const _default: NuxtModule<TOptions, TOptions, false>;
+export default _default;
+//# sourceMappingURL=module.d.ts.map

package/dist/frontend/forms/nuxt/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../frontend/src/forms/nuxt/module.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,iGAAiG;IACjG,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;;AAED,wBA+BG"}

package/dist/frontend/forms/nuxt/module.js

@@ -0,0 +1,34 @@
+import { defineNuxtModule, addPluginTemplate } from '@nuxt/kit';
+export default defineNuxtModule({
+    meta: {
+        name: '@seifer-webapp-factory/kits/frontend/forms',
+        configKey: 'foundationForms',
+        compatibility: { nuxt: '>=3.10.0' },
+    },
+    defaults: { useI18nResolver: true },
+    setup(options) {
+        if (options.useI18nResolver === false) {
+            return;
+        }
+        addPluginTemplate({
+            filename: 'foundation-forms-plugin.mjs',
+            getContents: () => `
+import { defineNuxtPlugin } from '#app';
+import { provideFormTranslate } from '@seifer-webapp-factory/kits/frontend/forms/vue';
+import { useI18n } from '@seifer-webapp-factory/kits/frontend/i18n/vue';
+
+export default defineNuxtPlugin((nuxtApp) => {
+  // Koppel de i18n-resolver (indien aanwezig) als forms-translate; anders valt forms terug
+  // op de issue-code als sleutel.
+  try {
+    const i18n = nuxtApp.vueApp.runWithContext(() => useI18n());
+    provideFormTranslate(nuxtApp.vueApp, (key, params) => i18n.t(key, params));
+  } catch {
+    // Geen i18n geprovide — bewust genegeerd.
+  }
+});
+`,
+        });
+    },
+});
+//# sourceMappingURL=module.js.map

package/dist/frontend/forms/nuxt/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../frontend/src/forms/nuxt/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAgBhE,eAAe,gBAAgB,CAAwB;IACrD,IAAI,EAAE;QACJ,IAAI,EAAE,4CAA4C;QAClD,SAAS,EAAE,iBAAiB;QAC5B,aAAa,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;KACpC;IACD,QAAQ,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;IACnC,KAAK,CAAC,OAA8B;QAClC,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QACD,iBAAiB,CAAC;YAChB,QAAQ,EAAE,6BAA6B;YACvC,WAAW,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;CAexB;SACI,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/frontend/forms/vue/index.d.ts

@@ -0,0 +1,7 @@
+export { useForm } from './use-form.js';
+export type { UseFormOptions, UseFormReturn } from './use-form.js';
+export { useField } from './use-field.js';
+export type { UseFieldReturn, FieldInputAttrs, FieldErrorAttrs, } from './use-field.js';
+export { FORM_KEY, FORMS_TRANSLATE_KEY, provideFormTranslate, injectTranslate, resolveMessage, createFieldRegistry, } from './provide.js';
+export type { FormContext, FieldRegistry } from './provide.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/forms/vue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../frontend/src/forms/vue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EACV,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/frontend/forms/vue/index.js

@@ -0,0 +1,4 @@
+export { useForm } from './use-form.js';
+export { useField } from './use-field.js';
+export { FORM_KEY, FORMS_TRANSLATE_KEY, provideFormTranslate, injectTranslate, resolveMessage, createFieldRegistry, } from './provide.js';
+//# sourceMappingURL=index.js.map

package/dist/frontend/forms/vue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../frontend/src/forms/vue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/frontend/forms/vue/provide.d.ts

@@ -0,0 +1,34 @@
+import { type App, type InjectionKey, type Ref } from 'vue';
+import type { FieldError, Translate } from '../core/ports.js';
+import type { FormEngine } from '../core/form.js';
+/**
+ * Vue-adapter voor de forms-kit: dunne provide/inject-laag bovenop de pure core. De
+ * InjectionKey-symbolen zijn constanten (geen mutable state); de form-instance + resolver worden
+ * per app-/component-instance geprovide, zodat SSR/hydratie per request/component geïsoleerd blijft.
+ */
+/** Registry van veld-elementen, gebruikt om bij een submit-fout naar het eerste ongeldige veld te focussen. */
+export interface FieldRegistry {
+    register(path: string, el: Ref<HTMLElement | null>): void;
+    unregister(path: string): void;
+    /** Focus het eerste veld (in volgorde van `paths`) waarvan het element geregistreerd is. */
+    focusFirst(paths: readonly string[]): void;
+}
+export declare function createFieldRegistry(): FieldRegistry;
+/** Gedeelde context die `useForm` provside en `useField` inject. */
+export interface FormContext {
+    readonly form: FormEngine<unknown>;
+    readonly registry: FieldRegistry;
+}
+export declare const FORM_KEY: InjectionKey<FormContext>;
+export declare const FORMS_TRANSLATE_KEY: InjectionKey<Translate>;
+/** Registreer een (optionele) translate-resolver voor i18n-bewuste veldfouten op een app-instance. */
+export declare function provideFormTranslate(app: App, translate: Translate): void;
+/** Haal de optioneel geïnjecteerde translate-resolver op binnen setup(). */
+export declare function injectTranslate(): Translate | undefined;
+/**
+ * Zet een opgeslagen veldfout om naar een leesbare tekst. Met resolver: vertaal via de code als
+ * sleutel (+ params). Zonder resolver: val terug op de issue-code als sleutel; server-berichten
+ * (zonder code) tonen hun kant-en-klare boodschap.
+ */
+export declare function resolveMessage(error: FieldError, translate: Translate | undefined): string;
+//# sourceMappingURL=provide.d.ts.map

package/dist/frontend/forms/vue/provide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provide.d.ts","sourceRoot":"","sources":["../../../../frontend/src/forms/vue/provide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AAEH,+GAA+G;AAC/G,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,4FAA4F;IAC5F,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAC5C;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAmBnD;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED,eAAO,MAAM,QAAQ,EAAE,YAAY,CAAC,WAAW,CAAqB,CAAC;AACrE,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,SAAS,CAAgC,CAAC;AAEzF,sGAAsG;AACtG,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAEzE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,IAAI,SAAS,GAAG,SAAS,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAK1F"}

package/dist/frontend/forms/vue/provide.js

@@ -0,0 +1,43 @@
+import { inject } from 'vue';
+export function createFieldRegistry() {
+    const els = new Map();
+    return {
+        register(path, el) {
+            els.set(path, el);
+        },
+        unregister(path) {
+            els.delete(path);
+        },
+        focusFirst(paths) {
+            for (const path of paths) {
+                const el = els.get(path)?.value;
+                if (el != null && typeof el.focus === 'function') {
+                    el.focus();
+                    return;
+                }
+            }
+        },
+    };
+}
+export const FORM_KEY = Symbol('ff.form');
+export const FORMS_TRANSLATE_KEY = Symbol('ff.forms.translate');
+/** Registreer een (optionele) translate-resolver voor i18n-bewuste veldfouten op een app-instance. */
+export function provideFormTranslate(app, translate) {
+    app.provide(FORMS_TRANSLATE_KEY, translate);
+}
+/** Haal de optioneel geïnjecteerde translate-resolver op binnen setup(). */
+export function injectTranslate() {
+    return inject(FORMS_TRANSLATE_KEY, undefined);
+}
+/**
+ * Zet een opgeslagen veldfout om naar een leesbare tekst. Met resolver: vertaal via de code als
+ * sleutel (+ params). Zonder resolver: val terug op de issue-code als sleutel; server-berichten
+ * (zonder code) tonen hun kant-en-klare boodschap.
+ */
+export function resolveMessage(error, translate) {
+    if (error.code !== undefined) {
+        return translate !== undefined ? translate(error.code, error.params) : error.code;
+    }
+    return error.message;
+}
+//# sourceMappingURL=provide.js.map

package/dist/frontend/forms/vue/provide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provide.js","sourceRoot":"","sources":["../../../../frontend/src/forms/vue/provide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAyC,MAAM,KAAK,CAAC;AAkBpE,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmC,CAAC;IACvD,OAAO;QACL,QAAQ,CAAC,IAAI,EAAE,EAAE;YACf,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpB,CAAC;QACD,UAAU,CAAC,IAAI;YACb,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,UAAU,CAAC,KAAK;YACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;gBAChC,IAAI,EAAE,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;oBACjD,EAAE,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAQD,MAAM,CAAC,MAAM,QAAQ,GAA8B,MAAM,CAAC,SAAS,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAA4B,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAEzF,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAAC,GAAQ,EAAE,SAAoB;IACjE,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,SAAgC;IAChF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IACpF,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC"}

package/dist/frontend/forms/vue/use-field.d.ts

@@ -0,0 +1,39 @@
+import { type ComputedRef, type Ref, type WritableComputedRef } from 'vue';
+/** Toegankelijkheidsattributen voor de input. */
+export interface FieldInputAttrs {
+    readonly 'aria-invalid': 'true' | undefined;
+    readonly 'aria-describedby': string | undefined;
+}
+/** Toegankelijkheidsattributen voor de foutregio (aria-live zodat screenreaders aankondigen). */
+export interface FieldErrorAttrs {
+    readonly id: string;
+    readonly role: 'alert';
+    readonly 'aria-live': 'polite';
+}
+export interface UseFieldReturn {
+    readonly name: string;
+    /** Bind aan het input-element (`ref="..."`) zodat focus-op-fout werkt. */
+    readonly elRef: Ref<HTMLElement | null>;
+    /** v-model-compatibele waarde-binding. */
+    readonly value: WritableComputedRef<unknown>;
+    /** Vertaalde foutmeldingen voor dit veld. */
+    readonly errors: ComputedRef<readonly string[]>;
+    readonly hasError: ComputedRef<boolean>;
+    readonly touched: ComputedRef<boolean>;
+    readonly dirty: ComputedRef<boolean>;
+    /** Stabiel id van de foutregio (voor `aria-describedby`). */
+    readonly errorId: string;
+    readonly inputAttrs: ComputedRef<FieldInputAttrs>;
+    readonly errorAttrs: FieldErrorAttrs;
+    /** Markeer touched + valideer dit veld (bind aan `@blur`). */
+    handleBlur(): void;
+    /** Zet de waarde (bind aan `@input`/`@update:modelValue`). */
+    handleInput(value: unknown): void;
+}
+/**
+ * `useField(name)` — bindt één veld: waarde (v-model), state (touched/dirty/valid) en
+ * toegankelijke, i18n-bewuste foutmeldingen. Vereist een ouder-`useForm`. Werpt expliciet bij een
+ * onbekend veld. Binding is per component-instance (geen module-globale mutable state).
+ */
+export declare function useField(name: string): UseFieldReturn;
+//# sourceMappingURL=use-field.d.ts.map

package/dist/frontend/forms/vue/use-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-field.d.ts","sourceRoot":"","sources":["../../../../frontend/src/forms/vue/use-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,GAAG,EACR,KAAK,mBAAmB,EACzB,MAAM,KAAK,CAAC;AAGb,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD;AAED,iGAAiG;AACjG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACxC,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7C,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,8DAA8D;IAC9D,UAAU,IAAI,IAAI,CAAC;IACnB,8DAA8D;IAC9D,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA+DrD"}

package/dist/frontend/forms/vue/use-field.js

@@ -0,0 +1,57 @@
+import { computed, inject, onScopeDispose, ref, } from 'vue';
+import { FORM_KEY, injectTranslate, resolveMessage } from './provide.js';
+/**
+ * `useField(name)` — bindt één veld: waarde (v-model), state (touched/dirty/valid) en
+ * toegankelijke, i18n-bewuste foutmeldingen. Vereist een ouder-`useForm`. Werpt expliciet bij een
+ * onbekend veld. Binding is per component-instance (geen module-globale mutable state).
+ */
+export function useField(name) {
+    const ctx = inject(FORM_KEY);
+    if (ctx === undefined) {
+        throw new Error(`[forms] useField('${name}'): geen form geprovide. Roep useForm(...) aan in een ouder-component.`);
+    }
+    const { form, registry } = ctx;
+    if (!form.hasField(name)) {
+        throw new Error(`[forms] useField('${name}'): onbekend veld — geen enkele beginwaarde met die naam. Geef het veld een waarde in initialValues.`);
+    }
+    const translate = injectTranslate();
+    const elRef = ref(null);
+    registry.register(name, elRef);
+    onScopeDispose(() => registry.unregister(name));
+    const errorId = `ff-field-${name}-error`;
+    const value = computed({
+        get: () => form.state.values[name],
+        set: (next) => form.setFieldValue(name, next),
+    });
+    const errors = computed(() => form.getFieldErrors(name).map((e) => resolveMessage(e, translate)));
+    const hasError = computed(() => errors.value.length > 0);
+    const touched = computed(() => form.isFieldTouched(name));
+    const dirty = computed(() => form.isFieldDirty(name));
+    const inputAttrs = computed(() => ({
+        'aria-invalid': hasError.value ? 'true' : undefined,
+        'aria-describedby': hasError.value ? errorId : undefined,
+    }));
+    const errorAttrs = { id: errorId, role: 'alert', 'aria-live': 'polite' };
+    function handleBlur() {
+        form.setTouched(name, true);
+        form.validateField(name);
+    }
+    function handleInput(next) {
+        form.setFieldValue(name, next);
+    }
+    return {
+        name,
+        elRef,
+        value,
+        errors,
+        hasError,
+        touched,
+        dirty,
+        errorId,
+        inputAttrs,
+        errorAttrs,
+        handleBlur,
+        handleInput,
+    };
+}
+//# sourceMappingURL=use-field.js.map

package/dist/frontend/forms/vue/use-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-field.js","sourceRoot":"","sources":["../../../../frontend/src/forms/vue/use-field.ts"],"names":[],"mappings":"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"}