@seifer-webapp-factory/authentication 0.1.0

package/dist/scaffolder/core/three-way-merge.d.ts

@@ -0,0 +1,113 @@
+/**
+ * three-way-merge — de UPGRADE-stap die "mag divergeren" van een val naar een feature maakt (US-A0804).
+ *
+ * Per surface-bestand reconcilieert `mergeSurface` drie versies:
+ *   - `base`     = de oorspronkelijk gematerialiseerde template (uit het `MaterializationRecord`),
+ *   - `upstream` = de nieuwe template-versie,
+ *   - `current`  = het (mogelijk gedivergeerde) projectbestand.
+ *
+ * Regels:
+ *   - `current === base`      → schoon toepassen: neem `upstream` over (project onaangeroerd).
+ *   - `upstream === base`     → behoud `current` (upstream ongewijzigd; divergentie blijft staan).
+ *   - `current === upstream`  → beide al gelijk; niets te doen.
+ *   - anders                  → regel-gebaseerde diff3: niet-botsende wijzigingen mergen, botsende
+ *                               krijgen CONFLICT-markers (nooit stil overschrijven).
+ *
+ * `upgradeSurface` orkestreert dit over alle bestanden met behulp van het `MaterializationRecord` en
+ * de twee templateVersions. Puur & deterministisch: geen fs-side-effects in de merge zelf, geen random.
+ */
+import type { AuthScaffolderFsPort, FileDescriptor } from './ports.js';
+import type { MaterializationRecord } from './materialize.js';
+/** De uitkomst-categorie van een merge. */
+export type MergeStatus = 'clean' | 'unchanged' | 'merged' | 'conflict';
+/** Labels die in de conflict-markers verschijnen. */
+export interface MergeMarkerLabels {
+    readonly current: string;
+    readonly base: string;
+    readonly upstream: string;
+}
+/** Invoer voor één bestand-merge. */
+export interface MergeInput {
+    readonly base: string;
+    readonly upstream: string;
+    readonly current: string;
+    readonly labels?: MergeMarkerLabels;
+}
+/** Resultaat van één bestand-merge. */
+export interface MergeResult {
+    readonly status: MergeStatus;
+    /** De uiteindelijke inhoud (met conflict-markers als `status === 'conflict'`). */
+    readonly contents: string;
+    /** True als er minstens één conflict-hunk in zit. */
+    readonly conflict: boolean;
+    /** Aantal conflict-hunks (0 als schoon). */
+    readonly conflicts: number;
+}
+/**
+ * Reconcilieert één bestand (base ↔ upstream ↔ current). Zie de bestandskop voor de regels.
+ */
+export declare function mergeSurface(input: MergeInput): MergeResult;
+/** De uitkomst per bestand binnen een upgrade. */
+export interface FileUpgradeOutcome {
+    readonly path: string;
+    /** Merge-status, of 'added' voor een nieuw upstream-bestand dat nog niet in het project stond. */
+    readonly status: MergeStatus | 'added';
+    readonly contents: string;
+    readonly conflict: boolean;
+}
+/** Uitkomst van een acceptatiegate (contract-tests + verticale e2e). */
+export interface GateOutcome {
+    readonly ok: boolean;
+    /** Naam van de gefaalde gate (bv. 'contract' of 'e2e'), indien van toepassing. */
+    readonly failed?: string;
+}
+/** Een acceptatiegate-callback die na de merge draait; ontvangt de voorgestelde bestanden. */
+export type AcceptanceGate = (files: readonly FileUpgradeOutcome[]) => GateOutcome;
+/** Opties voor `upgradeSurface`. */
+export interface UpgradeOptions {
+    /** Het stempelrecord van de vorige materialisatie (levert base + fromVersion per bestand). */
+    readonly record: MaterializationRecord;
+    /** De nieuwe surface-templates (upstream), voor de doel-`toVersion`. */
+    readonly upstreamFiles: readonly FileDescriptor[];
+    /** De doel-templateVersion die na een veilige upgrade gestempeld wordt. */
+    readonly toVersion: string;
+    /** Fs-port om de huidige (mogelijk gedivergeerde) projectbestanden in te lezen. */
+    readonly fsPort: AuthScaffolderFsPort;
+    /**
+     * Schrijf de gemergede inhoud terug via de fs-port. Standaard `false` (droog: alleen een plan).
+     * Conflict-bestanden worden NOOIT geschreven, ook niet met `write: true` — ze wachten op reconciliatie.
+     */
+    readonly write?: boolean;
+    /**
+     * Optionele acceptatiegate (contract + e2e). Wordt hij opgegeven én slaagt hij niet, dan is de
+     * upgrade niet veilig (US-A0804 AC3 / US-A1004 AC3): bewuste overschrijding richting fork (niveau 4).
+     */
+    readonly gate?: AcceptanceGate;
+    readonly labels?: MergeMarkerLabels;
+}
+/** Uitkomst van een volledige upgrade-run. */
+export interface UpgradeResult {
+    readonly fromVersion: string;
+    readonly toVersion: string;
+    readonly files: readonly FileUpgradeOutcome[];
+    /** Paden met een onopgelost conflict. */
+    readonly conflicts: readonly string[];
+    /**
+     * Is de upgrade veilig? True als er geen conflicten zijn ÉN (indien opgegeven) de gate groen is.
+     * Bij `false` is de divergentie bewust richting niveau 4 (fork) gegaan tenzij eerst gereconcilieerd.
+     */
+    readonly safe: boolean;
+    /** Uitkomst van de gate, indien er één is opgegeven. */
+    readonly gate?: GateOutcome;
+    /**
+     * Het bijgewerkte stempelrecord: schoon-toegepaste/gemergede bestanden staan op `toVersion` met de
+     * nieuwe basis; conflict-bestanden houden hun oude stempel tot ze gereconcilieerd zijn.
+     */
+    readonly record: MaterializationRecord;
+}
+/**
+ * Orkestreert de upgrade over alle upstream-bestanden op basis van het stempelrecord.
+ * Mecht uitsluitend de surface; het mechanisme upgradet los via semver (buiten deze functie).
+ */
+export declare function upgradeSurface(options: UpgradeOptions): UpgradeResult;
+//# sourceMappingURL=three-way-merge.d.ts.map

package/dist/scaffolder/core/three-way-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-way-merge.d.ts","sourceRoot":"","sources":["../../../scaffolder/core/three-way-merge.ts"],"names":[],"mappings":"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"}

package/dist/scaffolder/core/three-way-merge.js

@@ -0,0 +1,184 @@
+const DEFAULT_LABELS = { current: 'current', base: 'base', upstream: 'upstream' };
+/**
+ * Reconcilieert één bestand (base ↔ upstream ↔ current). Zie de bestandskop voor de regels.
+ */
+export function mergeSurface(input) {
+    const { base, upstream, current } = input;
+    const labels = input.labels ?? DEFAULT_LABELS;
+    // Snelle, exacte gevallen — behandeld vóór de regel-diff zodat triviale upgrades geen merge doen.
+    if (current === base) {
+        // Project heeft niets aangeraakt → neem de nieuwe template schoon over.
+        return { status: 'clean', contents: upstream, conflict: false, conflicts: 0 };
+    }
+    if (upstream === base) {
+        // Upstream is onveranderd → behoud de (gedivergeerde) projectversie.
+        return { status: 'unchanged', contents: current, conflict: false, conflicts: 0 };
+    }
+    if (current === upstream) {
+        // Beide kanten kwamen op dezelfde inhoud uit → niets te mergen.
+        return { status: 'clean', contents: current, conflict: false, conflicts: 0 };
+    }
+    // Echte drie-weg-merge op regelniveau.
+    const { lines, conflicts } = threeWayMergeLines(splitLines(base), splitLines(current), splitLines(upstream), labels);
+    const contents = lines.join('\n');
+    return {
+        status: conflicts > 0 ? 'conflict' : 'merged',
+        contents,
+        conflict: conflicts > 0,
+        conflicts,
+    };
+}
+/** Splitst inhoud in regels. Behoudt lege staart-regels zodat join('\n') exact terugkeert. */
+function splitLines(text) {
+    return text.split('\n');
+}
+/** Array-gelijkheid op regels. */
+function equalLines(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Longest common subsequence van twee regel-arrays. Levert de gematchte index-paren [xIdx, yIdx] in
+ * oplopende volgorde. Klassieke DP; deterministisch (bij gelijke lengte kiest hij consequent x++).
+ */
+function lcsPairs(x, y) {
+    const n = x.length;
+    const m = y.length;
+    const dp = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            dp[i][j] = x[i] === y[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+        }
+    }
+    const pairs = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (x[i] === y[j]) {
+            pairs.push([i, j]);
+            i++;
+            j++;
+        }
+        else if (dp[i + 1][j] >= dp[i][j + 1]) {
+            i++;
+        }
+        else {
+            j++;
+        }
+    }
+    return pairs;
+}
+/** Zet LCS-paren om naar een map baseIndex → otherIndex. */
+function matchMap(pairs) {
+    const map = new Map();
+    for (const [o, other] of pairs)
+        map.set(o, other);
+    return map;
+}
+/**
+ * De eigenlijke diff3. Ankers = base-regels die ONgewijzigd zijn in zowel `current` als `upstream`
+ * (aanwezig in beide LCS'en). Tussen opeenvolgende ankers classificeren we het segment:
+ *   - alleen upstream wijzigde  → neem upstream-segment,
+ *   - alleen current wijzigde   → neem current-segment,
+ *   - beide identiek gewijzigd  → neem dat (geen conflict),
+ *   - beide verschillend        → CONFLICT-markers.
+ * Omdat beide LCS'en monotoon zijn in de base-index, zijn de ankers monotoon in alle drie de indices.
+ */
+function threeWayMergeLines(base, current, upstream, labels) {
+    const matchCurrent = matchMap(lcsPairs(base, current)); // baseIdx → currentIdx
+    const matchUpstream = matchMap(lcsPairs(base, upstream)); // baseIdx → upstreamIdx
+    const anchors = [];
+    for (let o = 0; o < base.length; o++) {
+        const a = matchCurrent.get(o);
+        const b = matchUpstream.get(o);
+        if (a !== undefined && b !== undefined)
+            anchors.push({ o, a, b });
+    }
+    const out = [];
+    let conflicts = 0;
+    let po = -1;
+    let pa = -1;
+    let pb = -1;
+    const emitSegment = (oE, aE, bE) => {
+        const baseSeg = base.slice(po + 1, oE);
+        const currentSeg = current.slice(pa + 1, aE);
+        const upstreamSeg = upstream.slice(pb + 1, bE);
+        if (baseSeg.length === 0 && currentSeg.length === 0 && upstreamSeg.length === 0)
+            return;
+        if (equalLines(currentSeg, baseSeg)) {
+            out.push(...upstreamSeg); // alleen upstream wijzigde
+        }
+        else if (equalLines(upstreamSeg, baseSeg)) {
+            out.push(...currentSeg); // alleen current wijzigde
+        }
+        else if (equalLines(currentSeg, upstreamSeg)) {
+            out.push(...currentSeg); // beide dezelfde wijziging
+        }
+        else {
+            conflicts++;
+            out.push(`<<<<<<< ${labels.current}`, ...currentSeg, `||||||| ${labels.base}`, ...baseSeg, '=======', ...upstreamSeg, `>>>>>>> ${labels.upstream}`);
+        }
+    };
+    for (const anchor of anchors) {
+        emitSegment(anchor.o, anchor.a, anchor.b);
+        out.push(base[anchor.o]); // het anker zelf is in alle drie identiek
+        po = anchor.o;
+        pa = anchor.a;
+        pb = anchor.b;
+    }
+    // Staart-segment na het laatste anker.
+    emitSegment(base.length, current.length, upstream.length);
+    return { lines: out, conflicts };
+}
+/**
+ * Orkestreert de upgrade over alle upstream-bestanden op basis van het stempelrecord.
+ * Mecht uitsluitend de surface; het mechanisme upgradet los via semver (buiten deze functie).
+ */
+export function upgradeSurface(options) {
+    const { record, upstreamFiles, toVersion, fsPort, write = false, gate, labels } = options;
+    const fromVersion = record.templateVersion;
+    const files = [];
+    const conflicts = [];
+    const nextFiles = { ...record.files };
+    for (const upstream of upstreamFiles) {
+        const stamped = record.files[upstream.path];
+        const exists = fsPort.exists(upstream.path);
+        // Nieuw upstream-bestand (nog niet gematerialiseerd) of ontbrekend in het project → toevoegen.
+        if (stamped === undefined || !exists) {
+            files.push({ path: upstream.path, status: 'added', contents: upstream.contents, conflict: false });
+            if (write)
+                fsPort.write(upstream.path, upstream.contents);
+            nextFiles[upstream.path] = { templateVersion: toVersion, base: upstream.contents };
+            continue;
+        }
+        const current = fsPort.read(upstream.path);
+        const merge = mergeSurface({ base: stamped.base, upstream: upstream.contents, current, labels });
+        files.push({ path: upstream.path, status: merge.status, contents: merge.contents, conflict: merge.conflict });
+        if (merge.conflict) {
+            conflicts.push(upstream.path);
+            // Conflict: niet schrijven, oud stempel behouden tot reconciliatie.
+            continue;
+        }
+        if (write)
+            fsPort.write(upstream.path, merge.contents);
+        // Schoon/gemerged: stempel de nieuwe versie en leg de nieuwe basis vast voor volgende upgrades.
+        nextFiles[upstream.path] = { templateVersion: toVersion, base: merge.contents };
+    }
+    const gateOutcome = gate ? gate(files) : undefined;
+    const safe = conflicts.length === 0 && (gateOutcome ? gateOutcome.ok : true);
+    return {
+        fromVersion,
+        toVersion,
+        files,
+        conflicts,
+        safe,
+        gate: gateOutcome,
+        record: { module: record.module, templateVersion: safe ? toVersion : fromVersion, files: nextFiles },
+    };
+}
+//# sourceMappingURL=three-way-merge.js.map

package/dist/scaffolder/core/three-way-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-way-merge.js","sourceRoot":"","sources":["../../../scaffolder/core/three-way-merge.ts"],"names":[],"mappings":"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"}

package/dist/scaffolder/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * scaffolder (authentication) — de version-aware materializer van de authentication-capability-module.
+ *
+ * Composeert het manifest (US-A0801/0802) tot een werkende generate + upgrade-merge, en levert de
+ * divergentie-ladder niveau 1–3 (configureren, uitbreiden, materialiseren & mergen). Alle core-functies
+ * zijn puur/deterministisch; het wegschrijven en inlezen gaat via een geïnjecteerde fs-port. Geen
+ * module-globale mutable state, geen echt filesystem. Dit is een build/dev-tool, geen runtime-mechanisme.
+ */
+export type { FileDescriptor, AuthScaffolderFsPort, MemoryFsPort } from './core/ports.js';
+export { createMemoryFsPort } from './core/ports.js';
+export { materializeAuthModule, stampedVersions } from './core/materialize.js';
+export type { MaterializeOptions, MaterializeResult, MaterializationRecord, MaterializedFile, } from './core/materialize.js';
+export { mergeSurface, upgradeSurface } from './core/three-way-merge.js';
+export type { MergeStatus, MergeInput, MergeResult, MergeMarkerLabels, UpgradeOptions, UpgradeResult, FileUpgradeOutcome, AcceptanceGate, GateOutcome, } from './core/three-way-merge.js';
+export { resolveAuthConfig, filterSurfaceByConfig, authConfigSchema } from './core/config.js';
+export type { EffectiveAuthConfig, ResolvedAuthConfig, AffectedSurface, } from './core/config.js';
+export { defineRegisterFieldExtension, extendRegisterSchema, createPostLoginHookRegistry, defineSlot, createSlotRegistry, AUTH_SLOT_NAMES, } from './core/extend.js';
+export type { RegisterFieldExtension, RegisterFieldExtensionSpec, PostLoginContext, PostLoginHook, PostLoginRunResult, PostLoginHookRegistry, AuthSlotName, SlotDescriptor, SlotRegistry, } from './core/extend.js';
+export { AuthMaterializationConflictError, MissingRequiredPortError, AuthConfigValidationError, } from './core/errors.js';
+export type { AuthConfigViolation } from './core/errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/scaffolder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../scaffolder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/E,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACzE,YAAY,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9F,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,2BAA2B,EAC3B,UAAU,EACV,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gCAAgC,EAChC,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/scaffolder/index.js

@@ -0,0 +1,20 @@
+/**
+ * scaffolder (authentication) — de version-aware materializer van de authentication-capability-module.
+ *
+ * Composeert het manifest (US-A0801/0802) tot een werkende generate + upgrade-merge, en levert de
+ * divergentie-ladder niveau 1–3 (configureren, uitbreiden, materialiseren & mergen). Alle core-functies
+ * zijn puur/deterministisch; het wegschrijven en inlezen gaat via een geïnjecteerde fs-port. Geen
+ * module-globale mutable state, geen echt filesystem. Dit is een build/dev-tool, geen runtime-mechanisme.
+ */
+export { createMemoryFsPort } from './core/ports.js';
+// Materialize (US-A0803): surface stampen + all-or-nothing collision-refusal.
+export { materializeAuthModule, stampedVersions } from './core/materialize.js';
+// Three-way-merge / upgrade (US-A0804 / US-A1004).
+export { mergeSurface, upgradeSurface } from './core/three-way-merge.js';
+// Configure (US-A1001): niveau-1-divergentie.
+export { resolveAuthConfig, filterSurfaceByConfig, authConfigSchema } from './core/config.js';
+// Extend (US-A1002): niveau-2-divergentie (additief).
+export { defineRegisterFieldExtension, extendRegisterSchema, createPostLoginHookRegistry, defineSlot, createSlotRegistry, AUTH_SLOT_NAMES, } from './core/extend.js';
+// Fouten.
+export { AuthMaterializationConflictError, MissingRequiredPortError, AuthConfigValidationError, } from './core/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/scaffolder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../scaffolder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,8EAA8E;AAC9E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQ/E,mDAAmD;AACnD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAazE,8CAA8C;AAC9C,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAO9F,sDAAsD;AACtD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,2BAA2B,EAC3B,UAAU,EACV,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAa1B,UAAU;AACV,OAAO,EACL,gCAAgC,EAChC,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC"}

package/frontend/templates/components/AuthField.vue

@@ -0,0 +1,68 @@
+<script setup lang="ts">
+/**
+ * AuthField — toegankelijk veld-fragment (surface, design-system-agnostisch). Wrapt de forms-kit
+ * `useField(name)` en rendert plain semantische HTML: een `<label>`, een `<input>` en een
+ * `aria-live`-foutregio. De accessibiliteits-attributen (`aria-invalid`, `aria-describedby`) komen
+ * uit de forms-kit; de foutmeldingen zijn al i18n-resolved door de kit. Vereist een ouder die
+ * `useForm(...)` heeft aangeroepen (die provside de form-context). Geen eigen validatie-logica.
+ *
+ * De host swapt dit desgewenst voor een design-system-veld: de klassen zijn BEM-ish en het label
+ * is een named slot, zodat de vorm open blijft.
+ */
+import { useField } from '@seifer-webapp-factory/kits/frontend/forms/vue';
+
+const props = withDefaults(
+  defineProps<{
+    /** Veldnaam (moet als beginwaarde in het ouder-`useForm` bestaan). */
+    name: string;
+    /** Zichtbaar label (reeds vertaald door de aanroeper). */
+    label: string;
+    /** HTML input-type. */
+    type?: string;
+    /** Autocomplete-hint voor wachtwoordmanagers/browsers. */
+    autocomplete?: string;
+    /** Verplicht-markering (louter presentatie; validatie zit in het schema). */
+    required?: boolean;
+  }>(),
+  { type: 'text', autocomplete: undefined, required: false },
+);
+
+const field = useField(props.name);
+const inputId = `auth-field-${props.name}`;
+
+// Losse refs teruggeven zodat de template ze auto-unwrapt (geen geneste `.value.value`).
+const { elRef, value, errors, hasError, inputAttrs, errorAttrs, handleBlur } = field;
+</script>
+
+<template>
+  <div class="auth-field" :class="{ 'auth-field--error': hasError }">
+    <label class="auth-field__label" :for="inputId">
+      <slot name="label">{{ label }}</slot>
+      <span v-if="required" class="auth-field__required" aria-hidden="true">*</span>
+    </label>
+
+    <input
+      :id="inputId"
+      ref="elRef"
+      v-model="value"
+      class="auth-field__input"
+      :type="type"
+      :autocomplete="autocomplete"
+      :aria-invalid="inputAttrs['aria-invalid']"
+      :aria-describedby="inputAttrs['aria-describedby']"
+      @blur="handleBlur"
+    />
+
+    <ul
+      v-if="hasError"
+      :id="errorAttrs.id"
+      class="auth-field__errors"
+      :role="errorAttrs.role"
+      :aria-live="errorAttrs['aria-live']"
+    >
+      <li v-for="(message, index) in errors" :key="index" class="auth-field__error">
+        {{ message }}
+      </li>
+    </ul>
+  </div>
+</template>

package/frontend/templates/i18n/en.json

@@ -0,0 +1,70 @@
+{
+  "auth.field.email": "Email address",
+  "auth.field.password": "Password",
+
+  "auth.login.title": "Sign in",
+  "auth.login.subtitle": "Sign in with your email address and password.",
+  "auth.login.submit": "Sign in",
+  "auth.login.submitting": "Signing in…",
+  "auth.login.success": "You are signed in.",
+  "auth.login.forgotLink": "Forgot your password?",
+  "auth.login.registerLink": "No account yet? Register",
+
+  "auth.register.title": "Create account",
+  "auth.register.subtitle": "Create an account to get started.",
+  "auth.register.submit": "Register",
+  "auth.register.submitting": "Registering…",
+  "auth.register.success": "Account created. Check your email.",
+  "auth.register.passwordHint": "Use at least 8 characters.",
+  "auth.register.checkEmailTitle": "Check your email",
+  "auth.register.checkEmailBody": "We sent you a verification link. Open it to activate your account.",
+  "auth.register.backToLogin": "Back to sign in",
+  "auth.register.loginLink": "Already have an account? Sign in",
+
+  "auth.verify.invalidLinkTitle": "Invalid verification link",
+  "auth.verify.invalidLinkBody": "This link is incomplete or invalid. Request a new verification email.",
+  "auth.verify.verifying": "Verifying…",
+  "auth.verify.successTitle": "Email verified",
+  "auth.verify.successBody": "Your email address has been confirmed. You can now sign in.",
+  "auth.verify.failedTitle": "Verification failed",
+  "auth.verify.failedBody": "We could not verify your email address. The link may have expired.",
+  "auth.verify.toLogin": "Go to sign in",
+
+  "auth.forgot.title": "Forgot password",
+  "auth.forgot.subtitle": "Enter your email address and we will send you a reset link.",
+  "auth.forgot.submit": "Send reset link",
+  "auth.forgot.submitting": "Sending…",
+  "auth.forgot.confirmTitle": "Check your email",
+  "auth.forgot.confirmBody": "If an account exists for this email address, you will receive an email with instructions to reset your password.",
+  "auth.forgot.backToLogin": "Back to sign in",
+
+  "auth.reset.title": "Set a new password",
+  "auth.reset.subtitle": "Choose a new password for your account.",
+  "auth.reset.newPassword": "New password",
+  "auth.reset.submit": "Save password",
+  "auth.reset.submitting": "Saving…",
+  "auth.reset.success": "Your password has been reset.",
+  "auth.reset.invalidLinkTitle": "Invalid reset link",
+  "auth.reset.invalidLinkBody": "This link is incomplete or invalid. Request a new reset link.",
+  "auth.reset.requestNew": "Request a new reset link",
+  "auth.reset.doneTitle": "Password updated",
+  "auth.reset.doneBody": "Your password has been reset. You can now sign in.",
+  "auth.reset.toLogin": "Go to sign in",
+
+  "auth.logout.pending": "Signing out…",
+  "auth.logout.doneTitle": "You are signed out",
+  "auth.logout.doneBody": "Your session has ended. See you soon!",
+  "auth.logout.toLogin": "Sign in again",
+
+  "auth.error.invalid_credentials": "Email address or password is incorrect.",
+  "auth.error.email_taken": "An account with this email address already exists.",
+  "auth.error.weak_password": "This password is too weak. Choose a stronger password.",
+  "auth.error.token_invalid": "This link is invalid.",
+  "auth.error.token_expired": "This link has expired. Request a new one.",
+  "auth.error.email_not_verified": "Your email address has not been verified yet. Check your inbox.",
+  "auth.error.rate_limited": "Too many attempts. Please try again in a few minutes.",
+  "auth.error.csrf_failed": "Your session has expired. Refresh the page and try again.",
+  "auth.error.unauthenticated": "You are no longer signed in. Please sign in again.",
+  "auth.error.validation_failed": "Please check the details you entered and try again.",
+  "auth.error.unknown": "Something went wrong. Please try again later."
+}

package/frontend/templates/i18n/nl.json

@@ -0,0 +1,70 @@
+{
+  "auth.field.email": "E-mailadres",
+  "auth.field.password": "Wachtwoord",
+
+  "auth.login.title": "Inloggen",
+  "auth.login.subtitle": "Meld je aan met je e-mailadres en wachtwoord.",
+  "auth.login.submit": "Inloggen",
+  "auth.login.submitting": "Bezig met inloggen…",
+  "auth.login.success": "Je bent ingelogd.",
+  "auth.login.forgotLink": "Wachtwoord vergeten?",
+  "auth.login.registerLink": "Nog geen account? Registreer je",
+
+  "auth.register.title": "Account aanmaken",
+  "auth.register.subtitle": "Maak een account aan om te beginnen.",
+  "auth.register.submit": "Registreren",
+  "auth.register.submitting": "Bezig met registreren…",
+  "auth.register.success": "Account aangemaakt. Controleer je e-mail.",
+  "auth.register.passwordHint": "Gebruik minimaal 8 tekens.",
+  "auth.register.checkEmailTitle": "Controleer je e-mail",
+  "auth.register.checkEmailBody": "We hebben je een verificatielink gestuurd. Open die om je account te activeren.",
+  "auth.register.backToLogin": "Terug naar inloggen",
+  "auth.register.loginLink": "Heb je al een account? Log in",
+
+  "auth.verify.invalidLinkTitle": "Ongeldige verificatielink",
+  "auth.verify.invalidLinkBody": "Deze link is onvolledig of ongeldig. Vraag een nieuwe verificatiemail aan.",
+  "auth.verify.verifying": "Bezig met verifiëren…",
+  "auth.verify.successTitle": "E-mail geverifieerd",
+  "auth.verify.successBody": "Je e-mailadres is bevestigd. Je kunt nu inloggen.",
+  "auth.verify.failedTitle": "Verificatie mislukt",
+  "auth.verify.failedBody": "We konden je e-mailadres niet verifiëren. De link is mogelijk verlopen.",
+  "auth.verify.toLogin": "Naar inloggen",
+
+  "auth.forgot.title": "Wachtwoord vergeten",
+  "auth.forgot.subtitle": "Vul je e-mailadres in; we sturen je een herstellink.",
+  "auth.forgot.submit": "Stuur herstellink",
+  "auth.forgot.submitting": "Bezig met versturen…",
+  "auth.forgot.confirmTitle": "Controleer je e-mail",
+  "auth.forgot.confirmBody": "Als er een account bij dit e-mailadres hoort, ontvang je een e-mail met instructies om je wachtwoord te herstellen.",
+  "auth.forgot.backToLogin": "Terug naar inloggen",
+
+  "auth.reset.title": "Nieuw wachtwoord instellen",
+  "auth.reset.subtitle": "Kies een nieuw wachtwoord voor je account.",
+  "auth.reset.newPassword": "Nieuw wachtwoord",
+  "auth.reset.submit": "Wachtwoord opslaan",
+  "auth.reset.submitting": "Bezig met opslaan…",
+  "auth.reset.success": "Je wachtwoord is opnieuw ingesteld.",
+  "auth.reset.invalidLinkTitle": "Ongeldige herstellink",
+  "auth.reset.invalidLinkBody": "Deze link is onvolledig of ongeldig. Vraag een nieuwe herstellink aan.",
+  "auth.reset.requestNew": "Nieuwe herstellink aanvragen",
+  "auth.reset.doneTitle": "Wachtwoord bijgewerkt",
+  "auth.reset.doneBody": "Je wachtwoord is opnieuw ingesteld. Je kunt nu inloggen.",
+  "auth.reset.toLogin": "Naar inloggen",
+
+  "auth.logout.pending": "Bezig met uitloggen…",
+  "auth.logout.doneTitle": "Je bent uitgelogd",
+  "auth.logout.doneBody": "Je sessie is beëindigd. Tot ziens!",
+  "auth.logout.toLogin": "Opnieuw inloggen",
+
+  "auth.error.invalid_credentials": "E-mailadres of wachtwoord is onjuist.",
+  "auth.error.email_taken": "Er bestaat al een account met dit e-mailadres.",
+  "auth.error.weak_password": "Dit wachtwoord is te zwak. Kies een sterker wachtwoord.",
+  "auth.error.token_invalid": "Deze link is ongeldig.",
+  "auth.error.token_expired": "Deze link is verlopen. Vraag een nieuwe aan.",
+  "auth.error.email_not_verified": "Je e-mailadres is nog niet geverifieerd. Controleer je inbox.",
+  "auth.error.rate_limited": "Te veel pogingen. Probeer het over enkele minuten opnieuw.",
+  "auth.error.csrf_failed": "Je sessie is verlopen. Vernieuw de pagina en probeer het opnieuw.",
+  "auth.error.unauthenticated": "Je bent niet (meer) ingelogd. Log opnieuw in.",
+  "auth.error.validation_failed": "Controleer de ingevulde gegevens en probeer het opnieuw.",
+  "auth.error.unknown": "Er ging iets mis. Probeer het later opnieuw."
+}

package/frontend/templates/middleware/auth.ts

@@ -0,0 +1,25 @@
+/**
+ * US-A0305 — Route-middleware `auth` (surface, gematerialiseerd, Nuxt). Beschermt auth-required
+ * routes door de pinned `authRequiredGuard` te composeren: anonieme bezoekers worden naar `/login`
+ * geredirect met de oorspronkelijke route als `redirect`-terugkeer-parameter. De sessie-status komt
+ * uit de door de plugin geprovide accessor (`$authIsAuthenticated`) — geen module-globale state.
+ *
+ * Gebruik in een pagina: `definePageMeta({ middleware: 'auth' })`.
+ */
+import { authRequiredGuard } from '../../src/index.js';
+
+// Nuxt auto-imports (host-context).
+declare const defineNuxtRouteMiddleware: (
+  fn: (to: { path: string; fullPath: string }) => unknown,
+) => unknown;
+declare const useNuxtApp: () => { $authIsAuthenticated?: () => boolean };
+declare const navigateTo: (to: { path: string; query?: Record<string, string> }) => unknown;
+
+export default defineNuxtRouteMiddleware((to) => {
+  const isAuthenticated = useNuxtApp().$authIsAuthenticated ?? (() => false);
+  const guard = authRequiredGuard({ isAuthenticated, loginPath: '/login' });
+  const decision = guard({ path: to.path, fullPath: to.fullPath });
+  if (decision !== true) {
+    return navigateTo(decision);
+  }
+});

package/frontend/templates/middleware/guest.ts

@@ -0,0 +1,25 @@
+/**
+ * US-A0305 — Route-middleware `guest` (surface, gematerialiseerd, Nuxt). Weert reeds-ingelogde
+ * bezoekers van guest-only routes (bv. `/login`, `/register`) door de pinned `guestOnlyGuard` te
+ * composeren: een geauthenticeerde sessie wordt naar de home (`/`) geredirect. De sessie-status komt
+ * uit de door de plugin geprovide accessor (`$authIsAuthenticated`) — geen module-globale state.
+ *
+ * Gebruik in een pagina: `definePageMeta({ middleware: 'guest' })`.
+ */
+import { guestOnlyGuard } from '../../src/index.js';
+
+// Nuxt auto-imports (host-context).
+declare const defineNuxtRouteMiddleware: (
+  fn: (to: { path: string; fullPath: string }) => unknown,
+) => unknown;
+declare const useNuxtApp: () => { $authIsAuthenticated?: () => boolean };
+declare const navigateTo: (to: { path: string; query?: Record<string, string> }) => unknown;
+
+export default defineNuxtRouteMiddleware((to) => {
+  const isAuthenticated = useNuxtApp().$authIsAuthenticated ?? (() => false);
+  const guard = guestOnlyGuard({ isAuthenticated, homePath: '/' });
+  const decision = guard({ path: to.path, fullPath: to.fullPath });
+  if (decision !== true) {
+    return navigateTo(decision);
+  }
+});