@seifer-webapp-factory/user-settings 0.1.0

package/dist/scaffolder/core/errors.js

@@ -0,0 +1,38 @@
+/**
+ * Fouttypes voor de user-settings-scaffolder. Draag altijd genoeg context voor een expliciete melding
+ * (paden, poorten, modules), maar NOOIT invoerwaarden of secrets. Deterministisch: geen timestamps/random.
+ */
+/** Geworpen wanneer te materialiseren surface-bestanden al bestaan en `overwrite` niet gezet is. */
+export class UserSettingsMaterializationConflictError extends Error {
+    paths;
+    constructor(paths) {
+        super(`Materialisatie gestopt: ${paths.length} surface-bestand(en) bestaan al en zouden overschreven ` +
+            `worden zonder overwrite-vlag: ${paths.join(', ')}`);
+        this.name = 'UserSettingsMaterializationConflictError';
+        this.paths = paths;
+    }
+}
+/** Geworpen wanneer het project een door het manifest vereiste requires-port niet levert. */
+export class MissingRequiredPortError extends Error {
+    missing;
+    constructor(missing) {
+        super(`Materialisatie geweigerd: de host levert niet alle vereiste ports. Ontbrekend: ${missing.join(', ')}`);
+        this.name = 'MissingRequiredPortError';
+        this.missing = missing;
+    }
+}
+/**
+ * Geworpen door `checkRequiredModules` wanneer een vereiste capability-module niet aanwezig is.
+ * user-settings heeft GEEN `requires.modules` (kit-only), dus dit vuurt bij deze module in de praktijk niet
+ * — het blijft aanwezig voor pariteit met de siblings en voor het geval een host de check toch aanroept.
+ */
+export class MissingRequiredModuleError extends Error {
+    missing;
+    constructor(missing) {
+        super(`Assemblage geweigerd: deze module vereist andere capability-module(s) die niet aanwezig zijn. ` +
+            `Ontbrekend: ${missing.join(', ')}`);
+        this.name = 'MissingRequiredModuleError';
+        this.missing = missing;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/scaffolder/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../scaffolder/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oGAAoG;AACpG,MAAM,OAAO,wCAAyC,SAAQ,KAAK;IACxD,KAAK,CAAoB;IAClC,YAAY,KAAwB;QAClC,KAAK,CACH,2BAA2B,KAAK,CAAC,MAAM,yDAAyD;YAC9F,iCAAiC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0CAA0C,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,6FAA6F;AAC7F,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,OAAO,CAAoB;IACpC,YAAY,OAA0B;QACpC,KAAK,CAAC,kFAAkF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9G,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,OAAO,CAAoB;IACpC,YAAY,OAA0B;QACpC,KAAK,CACH,gGAAgG;YAC9F,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/scaffolder/core/materialize.d.ts

@@ -0,0 +1,40 @@
+/**
+ * materialize — de GENERATE-stap van de version-aware materializer. Schrijft de surface-`FileDescriptor`s
+ * van de user-settings-module via een geïnjecteerde fs-port in een doelproject; vanaf dat moment is de
+ * surface projecteigendom en mag ze divergeren. De functie stempelt de `templateVersion` per bestand,
+ * verzamelt ÁLLE collisions en weigert all-or-nothing zonder `overwrite`, en weigert te starten als een
+ * vereiste requires-port ontbreekt. Puur op de fs-port na: deterministisch, geen module-globale state.
+ */
+import type { CapabilityModuleManifest } from '../../manifest.js';
+import type { UserSettingsScaffolderFsPort, FileDescriptor } from './ports.js';
+export interface MaterializedFile {
+    readonly templateVersion: string;
+    readonly base: string;
+}
+export interface MaterializationRecord {
+    readonly module: string;
+    readonly templateVersion: string;
+    readonly files: Readonly<Record<string, MaterializedFile>>;
+}
+export interface MaterializeOptions {
+    readonly manifest: CapabilityModuleManifest;
+    readonly surfaceFiles: readonly FileDescriptor[];
+    readonly fsPort: UserSettingsScaffolderFsPort;
+    readonly templateVersion?: string;
+    readonly overwrite?: boolean;
+    readonly providedPorts?: readonly string[];
+}
+export interface MaterializeResult {
+    readonly record: MaterializationRecord;
+    readonly written: readonly string[];
+}
+/**
+ * Materialiseert de surface van de user-settings-module in een project.
+ *
+ * @throws MissingRequiredPortError als een vereiste port ontbreekt (geen enkele write gebeurt)
+ * @throws UserSettingsMaterializationConflictError als bestanden al bestaan en `overwrite` niet gezet is
+ */
+export declare function materializeUserSettingsModule(options: MaterializeOptions): MaterializeResult;
+/** Convenience: het stempelrecord platgeslagen tot een pure `bestand → templateVersion`-map. */
+export declare function stampedVersions(record: MaterializationRecord): Record<string, string>;
+//# sourceMappingURL=materialize.d.ts.map

package/dist/scaffolder/core/materialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../../../scaffolder/core/materialize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,4BAA4B,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG/E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAwB5F;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIrF"}

package/dist/scaffolder/core/materialize.js

@@ -0,0 +1,38 @@
+import { UserSettingsMaterializationConflictError, MissingRequiredPortError } from './errors.js';
+/**
+ * Materialiseert de surface van de user-settings-module in een project.
+ *
+ * @throws MissingRequiredPortError als een vereiste port ontbreekt (geen enkele write gebeurt)
+ * @throws UserSettingsMaterializationConflictError als bestanden al bestaan en `overwrite` niet gezet is
+ */
+export function materializeUserSettingsModule(options) {
+    const { manifest, surfaceFiles, fsPort, overwrite = false, providedPorts } = options;
+    const templateVersion = options.templateVersion ?? manifest.templateVersion;
+    if (providedPorts !== undefined) {
+        const provided = new Set(providedPorts);
+        const missing = manifest.requires.ports.filter((port) => !provided.has(port));
+        if (missing.length > 0)
+            throw new MissingRequiredPortError(missing);
+    }
+    if (!overwrite) {
+        const conflicts = surfaceFiles.filter((f) => fsPort.exists(f.path)).map((f) => f.path);
+        if (conflicts.length > 0)
+            throw new UserSettingsMaterializationConflictError(conflicts);
+    }
+    const files = {};
+    const written = [];
+    for (const descriptor of surfaceFiles) {
+        fsPort.write(descriptor.path, descriptor.contents);
+        files[descriptor.path] = { templateVersion, base: descriptor.contents };
+        written.push(descriptor.path);
+    }
+    return { record: { module: manifest.name, templateVersion, files }, written };
+}
+/** Convenience: het stempelrecord platgeslagen tot een pure `bestand → templateVersion`-map. */
+export function stampedVersions(record) {
+    const out = {};
+    for (const [path, file] of Object.entries(record.files))
+        out[path] = file.templateVersion;
+    return out;
+}
+//# sourceMappingURL=materialize.js.map

package/dist/scaffolder/core/materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.js","sourceRoot":"","sources":["../../../scaffolder/core/materialize.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,wCAAwC,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AA2BjG;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAA2B;IACvE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IACrF,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe,CAAC;IAE5E,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,wCAAwC,CAAC,SAAS,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QACnD,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC;AAChF,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC3D,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;IAC1F,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/scaffolder/core/ports.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ports — de geïnjecteerde randen van de scaffolder. De core-functies raken NOOIT een echt filesystem:
+ * ze krijgen een {@link UserSettingsScaffolderFsPort} injected en werken uitsluitend met {@link FileDescriptor}s.
+ * Zo blijft de materializer deterministisch, testbaar met een in-memory port en vrij van module-globale state.
+ *
+ * NB (bekende schuld — Layer 1b): deze fs-port + descriptor zijn per module gekopieerd-met-hernoeming
+ * (`UserSettingsScaffolderFsPort` ↔ `AccountScaffolderFsPort` ↔ `AuthzScaffolderFsPort` ↔ `AuthScaffolderFsPort`).
+ * De generieke extractie naar een gedeeld scaffolder-package is een aparte, breaking refactor; zie
+ * capability-modules/README.
+ */
+/** Eén te materialiseren bestand: relatief pad + volledige inhoud. Pure data, geen side-effects. */
+export interface FileDescriptor {
+    readonly path: string;
+    readonly contents: string;
+}
+/** Minimale, injecteerbare fs-port. Bewust synchroon en klein zodat hij triviaal te mocken is. */
+export interface UserSettingsScaffolderFsPort {
+    exists(path: string): boolean;
+    read(path: string): string;
+    write(path: string, contents: string): void;
+}
+/** Een in-memory fs-port met een `snapshot()` erbij, voor tests én de re-scaffold-naar-temp-stap. */
+export interface MemoryFsPort extends UserSettingsScaffolderFsPort {
+    snapshot(): Record<string, string>;
+}
+/** Maakt een verse, geïsoleerde in-memory fs-port (geen module-globale mutable state). */
+export declare function createMemoryFsPort(seed?: Readonly<Record<string, string>>): MemoryFsPort;
+//# sourceMappingURL=ports.d.ts.map

package/dist/scaffolder/core/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../scaffolder/core/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oGAAoG;AACpG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,kGAAkG;AAClG,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,qGAAqG;AACrG,MAAM,WAAW,YAAa,SAAQ,4BAA4B;IAChE,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,YAAY,CAcxF"}

package/dist/scaffolder/core/ports.js

@@ -0,0 +1,28 @@
+/**
+ * ports — de geïnjecteerde randen van de scaffolder. De core-functies raken NOOIT een echt filesystem:
+ * ze krijgen een {@link UserSettingsScaffolderFsPort} injected en werken uitsluitend met {@link FileDescriptor}s.
+ * Zo blijft de materializer deterministisch, testbaar met een in-memory port en vrij van module-globale state.
+ *
+ * NB (bekende schuld — Layer 1b): deze fs-port + descriptor zijn per module gekopieerd-met-hernoeming
+ * (`UserSettingsScaffolderFsPort` ↔ `AccountScaffolderFsPort` ↔ `AuthzScaffolderFsPort` ↔ `AuthScaffolderFsPort`).
+ * De generieke extractie naar een gedeeld scaffolder-package is een aparte, breaking refactor; zie
+ * capability-modules/README.
+ */
+/** Maakt een verse, geïsoleerde in-memory fs-port (geen module-globale mutable state). */
+export function createMemoryFsPort(seed) {
+    const store = new Map(seed ? Object.entries(seed) : []);
+    return {
+        exists: (path) => store.has(path),
+        read: (path) => {
+            const value = store.get(path);
+            if (value === undefined)
+                throw new Error(`Bestand niet gevonden op de fs-port: ${path}`);
+            return value;
+        },
+        write: (path, contents) => {
+            store.set(path, contents);
+        },
+        snapshot: () => Object.fromEntries([...store.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))),
+    };
+}
+//# sourceMappingURL=ports.js.map

package/dist/scaffolder/core/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../scaffolder/core/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB,CAAC,IAAuC;IACxE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAiB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,OAAO;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;YACzF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;YACxB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5B,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC1G,CAAC;AACJ,CAAC"}

package/dist/scaffolder/core/presence.d.ts

@@ -0,0 +1,21 @@
+/**
+ * presence — de module→module presence-check. user-settings heeft GEEN `requires.modules` (kit-only,
+ * ontkoppeld van account), dus deze check is bij deze module in de praktijk een no-op. Ze blijft aanwezig
+ * voor pariteit met de siblings (account vereist authentication) en zodat een host die de check
+ * generiek aanroept, dezelfde API krijgt.
+ *
+ * Puur & deterministisch: geen fs, geen module-globale mutable state, geen random/timestamps.
+ */
+import type { CapabilityModuleManifest } from '../../manifest.js';
+/**
+ * Controleert dat elke `manifest.requires.modules`-entry in `presentModules` zit. Ontbreekt er één of
+ * meer, dan wordt een {@link MissingRequiredModuleError} geworpen met ÁLLE ontbrekende modules. Geen
+ * `requires.modules` → no-op (het geval voor user-settings).
+ */
+export declare function checkRequiredModules(manifest: CapabilityModuleManifest, presentModules: readonly string[]): void;
+export interface AssemblableOptions {
+    readonly presentModules: readonly string[];
+}
+/** Eén duidelijk instappunt voor de scaffolder-orkestratie vóór het assembleren. */
+export declare function assertAssemblable(manifest: CapabilityModuleManifest, options: AssemblableOptions): void;
+//# sourceMappingURL=presence.d.ts.map

package/dist/scaffolder/core/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../scaffolder/core/presence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGlE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,wBAAwB,EAAE,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAMhH;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,wBAAwB,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEvG"}

package/dist/scaffolder/core/presence.js

@@ -0,0 +1,20 @@
+import { MissingRequiredModuleError } from './errors.js';
+/**
+ * Controleert dat elke `manifest.requires.modules`-entry in `presentModules` zit. Ontbreekt er één of
+ * meer, dan wordt een {@link MissingRequiredModuleError} geworpen met ÁLLE ontbrekende modules. Geen
+ * `requires.modules` → no-op (het geval voor user-settings).
+ */
+export function checkRequiredModules(manifest, presentModules) {
+    const required = manifest.requires.modules;
+    if (required === undefined || required.length === 0)
+        return;
+    const present = new Set(presentModules);
+    const missing = required.filter((module) => !present.has(module));
+    if (missing.length > 0)
+        throw new MissingRequiredModuleError(missing);
+}
+/** Eén duidelijk instappunt voor de scaffolder-orkestratie vóór het assembleren. */
+export function assertAssemblable(manifest, options) {
+    checkRequiredModules(manifest, options.presentModules);
+}
+//# sourceMappingURL=presence.js.map

package/dist/scaffolder/core/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../../scaffolder/core/presence.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAkC,EAAE,cAAiC;IACxG,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC3C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC;AACxE,CAAC;AAMD,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAAC,QAAkC,EAAE,OAA2B;IAC/F,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;AACzD,CAAC"}

package/dist/scaffolder/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * scaffolder (user-settings) — de version-aware materializer van de user-settings-capability-module.
+ * Composeert het manifest tot een werkende generate + de (voor deze module no-op) module→module
+ * presence-check. Alle core-functies zijn puur/deterministisch; het wegschrijven gaat via een
+ * geïnjecteerde fs-port. Dit is een build/dev-tool, geen runtime-mechanisme.
+ *
+ * BEKENDE SCHULD (Layer 1b): de scaffolder-core is per module gekopieerd-met-hernoeming
+ * (`materializeUserSettingsModule` ↔ `materializeAccountModule` ↔ `materializeAuthzModule` ↔
+ * `materializeAuthModule`; `UserSettings*`/`Account*`/`Authz*`/`Auth*`-foutklassen). De three-way-merge +
+ * config/extend-lagen horen bij dezelfde generieke extractie. Zie capability-modules/README — dit is
+ * bewust NIET stilzwijgend nóg een keer gedupliceerd.
+ */
+export type { FileDescriptor, UserSettingsScaffolderFsPort, MemoryFsPort } from './core/ports.js';
+export { createMemoryFsPort } from './core/ports.js';
+export { materializeUserSettingsModule, stampedVersions } from './core/materialize.js';
+export type { MaterializeOptions, MaterializeResult, MaterializationRecord, MaterializedFile, } from './core/materialize.js';
+export { checkRequiredModules, assertAssemblable } from './core/presence.js';
+export type { AssemblableOptions } from './core/presence.js';
+export { UserSettingsMaterializationConflictError, MissingRequiredPortError, MissingRequiredModuleError, } 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;;;;;;;;;;;GAWG;AACH,YAAY,EAAE,cAAc,EAAE,4BAA4B,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvF,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EACL,wCAAwC,EACxC,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC"}

package/dist/scaffolder/index.js

@@ -0,0 +1,6 @@
+export { createMemoryFsPort } from './core/ports.js';
+export { materializeUserSettingsModule, stampedVersions } from './core/materialize.js';
+// Module→module presence-check: user-settings heeft geen requires.modules (no-op), behouden voor pariteit.
+export { checkRequiredModules, assertAssemblable } from './core/presence.js';
+export { UserSettingsMaterializationConflictError, MissingRequiredPortError, MissingRequiredModuleError, } 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,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQvF,2GAA2G;AAC3G,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EACL,wCAAwC,EACxC,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC"}

package/frontend/templates/i18n/en.json

@@ -0,0 +1,20 @@
+{
+  "userSettings.title": "Settings",
+  "userSettings.field.theme": "Theme",
+  "userSettings.theme.light": "Light",
+  "userSettings.theme.dark": "Dark",
+  "userSettings.theme.system": "Match system",
+  "userSettings.field.locale": "Language",
+  "userSettings.field.density": "Density",
+  "userSettings.density.comfortable": "Comfortable",
+  "userSettings.density.compact": "Compact",
+  "userSettings.saved": "Settings saved",
+  "userSettings.error.unknown_key": "That setting isn't available.",
+  "userSettings.error.validation_failed": "That value isn't allowed.",
+  "userSettings.error.consent_namespace_rejected": "Consent choices are managed in your account, not here.",
+  "userSettings.error.stale_write": "Your settings changed on another device. Please retry.",
+  "userSettings.error.unauthenticated": "Please sign in again.",
+  "userSettings.error.csrf_failed": "Your session expired. Please refresh and try again.",
+  "userSettings.error.store_unavailable": "Settings can't be saved right now. Please try again later.",
+  "userSettings.error.unknown": "Something went wrong. Please try again."
+}

package/frontend/templates/i18n/nl.json

@@ -0,0 +1,20 @@
+{
+  "userSettings.title": "Instellingen",
+  "userSettings.field.theme": "Thema",
+  "userSettings.theme.light": "Licht",
+  "userSettings.theme.dark": "Donker",
+  "userSettings.theme.system": "Systeem volgen",
+  "userSettings.field.locale": "Taal",
+  "userSettings.field.density": "Dichtheid",
+  "userSettings.density.comfortable": "Comfortabel",
+  "userSettings.density.compact": "Compact",
+  "userSettings.saved": "Instellingen opgeslagen",
+  "userSettings.error.unknown_key": "Die instelling bestaat niet.",
+  "userSettings.error.validation_failed": "Die waarde is niet toegestaan.",
+  "userSettings.error.consent_namespace_rejected": "Toestemmingen beheer je in je account, niet hier.",
+  "userSettings.error.stale_write": "Je instellingen zijn op een ander apparaat gewijzigd. Probeer opnieuw.",
+  "userSettings.error.unauthenticated": "Log opnieuw in.",
+  "userSettings.error.csrf_failed": "Je sessie is verlopen. Ververs de pagina en probeer opnieuw.",
+  "userSettings.error.store_unavailable": "Instellingen kunnen nu niet worden opgeslagen. Probeer later opnieuw.",
+  "userSettings.error.unknown": "Er ging iets mis. Probeer opnieuw."
+}

package/frontend/templates/pages/settings.vue

@@ -0,0 +1,62 @@
+<script setup lang="ts">
+/**
+ * Optionele referentie-instellingen-pagina (surface, gematerialiseerd, mag divergeren). Headless-first: de
+ * primaire surface is de `useSetting()`-compo­sable; deze pagina toont hoe je die tegen de canonieke keys
+ * (theme/locale/density) bindt. Design-system-agnostisch: plain semantische HTML; de host swapt zijn eigen
+ * componenten in of remapt/schrapt de pagina. a11y + i18n eersteklas.
+ *
+ * De keys zijn host-gedeclareerd; pas deze bindings aan op je eigen descriptor-set.
+ */
+import { useSetting } from '../../src/useSettings.js';
+import { useTranslate } from '../runtime.js';
+
+const t = useTranslate();
+
+// Canonieke keys — pas aan op je host-descriptor-set.
+const theme = useSetting<string>('theme');
+const locale = useSetting<string>('locale');
+const density = useSetting<string>('density');
+</script>
+
+<template>
+  <section class="user-settings-page">
+    <header class="user-settings-page__header">
+      <h1 class="user-settings-page__title">{{ t('userSettings.title') }}</h1>
+    </header>
+
+    <form class="user-settings-form" novalidate @submit.prevent>
+      <fieldset class="user-settings-field">
+        <legend class="user-settings-field__label">{{ t('userSettings.field.theme') }}</legend>
+        <label>
+          <input v-model="theme" type="radio" value="light" name="theme" />
+          <span>{{ t('userSettings.theme.light') }}</span>
+        </label>
+        <label>
+          <input v-model="theme" type="radio" value="dark" name="theme" />
+          <span>{{ t('userSettings.theme.dark') }}</span>
+        </label>
+        <label>
+          <input v-model="theme" type="radio" value="system" name="theme" />
+          <span>{{ t('userSettings.theme.system') }}</span>
+        </label>
+      </fieldset>
+
+      <label class="user-settings-field">
+        <span class="user-settings-field__label">{{ t('userSettings.field.locale') }}</span>
+        <input v-model="locale" name="locale" type="text" data-testid="user-settings-locale" />
+      </label>
+
+      <fieldset class="user-settings-field">
+        <legend class="user-settings-field__label">{{ t('userSettings.field.density') }}</legend>
+        <label>
+          <input v-model="density" type="radio" value="comfortable" name="density" />
+          <span>{{ t('userSettings.density.comfortable') }}</span>
+        </label>
+        <label>
+          <input v-model="density" type="radio" value="compact" name="density" />
+          <span>{{ t('userSettings.density.compact') }}</span>
+        </label>
+      </fieldset>
+    </form>
+  </section>
+</template>

package/frontend/templates/runtime.ts

@@ -0,0 +1,19 @@
+/**
+ * Kleine runtime-helpers voor de surface-pagina (gematerialiseerd, mag divergeren). Houdt de pagina
+ * design-system- en i18n-framework-agnostisch: de host kan een echte vertaler/toaster injecteren; anders
+ * valt alles terug op een veilige no-op/identiteit. Geen module-globale mutable state.
+ */
+import { inject, type InjectionKey } from 'vue';
+
+/** Injecteerbare vertaalfunctie (sleutel → tekst). Default: geef de sleutel terug (zichtbaar in tests). */
+export const USER_SETTINGS_TRANSLATE_KEY: InjectionKey<(key: string) => string> = Symbol('user-settings.translate');
+/** Injecteerbare success-toaster. Default: no-op. */
+export const USER_SETTINGS_TOASTS_KEY: InjectionKey<(message: string) => void> = Symbol('user-settings.toasts');
+
+export function useTranslate(): (key: string) => string {
+  return inject(USER_SETTINGS_TRANSLATE_KEY, (key: string) => key);
+}
+
+export function useOptionalToasts(): ((message: string) => void) | undefined {
+  return inject(USER_SETTINGS_TOASTS_KEY, undefined);
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@seifer-webapp-factory/user-settings",
+  "version": "0.1.0",
+  "description": "user-settings — vijfde capability-module: een herbruikbare preferences-laag (theme/locale/dir, density, layout, dismissed hints, onboarding) met één useSettings()-seam over twee runtime-adapters (client: cookie+localStorage anoniem; server: NestJS+persistence per gebruiker), SSR-veilige render-keys en guest→login LWW-merge. Geparametriseerd door een host-gedeclareerd descriptor-schema (de module levert de engine, de host de keys). Consent hoort NIET hier — dat delegeert naar de account-module.",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    "./contract": {
+      "types": "./dist/contract/index.d.ts",
+      "import": "./dist/contract/index.js"
+    },
+    "./backend": {
+      "types": "./dist/backend/src/index.d.ts",
+      "import": "./dist/backend/src/index.js"
+    },
+    "./frontend": {
+      "types": "./dist/frontend/src/index.d.ts",
+      "import": "./dist/frontend/src/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.ts",
+      "import": "./dist/manifest.js"
+    },
+    "./scaffolder": {
+      "types": "./dist/scaffolder/index.d.ts",
+      "import": "./dist/scaffolder/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:backend": "tsc -p tsconfig.backend.json",
+    "test": "vitest run",
+    "test:e2e": "vitest run -c vitest.e2e.config.ts"
+  },
+  "dependencies": {
+    "@seifer-webapp-factory/capability-spec": "^0.1.0"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0",
+    "zod": "^3.23.0",
+    "@seifer-webapp-factory/kits": "^0.1.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.4.22",
+    "@nestjs/core": "^10.4.22",
+    "@nestjs/platform-express": "^10.4.22",
+    "@nestjs/testing": "^10.4.22",
+    "@playwright/test": "^1.50.0",
+    "@types/pg": "^8.20.0",
+    "@types/supertest": "^6.0.0",
+    "@vitejs/plugin-vue": "^5.2.0",
+    "@vue/test-utils": "^2.4.0",
+    "express": "^4.21.0",
+    "happy-dom": "^15.0.0",
+    "pg": "^8.22.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "supertest": "^7.0.0",
+    "testcontainers": "^10.28.0",
+    "tsx": "^4.23.0",
+    "typescript": "^5.7.0",
+    "vite": "^5.4.0",
+    "vitest": "^2.1.0",
+    "vue": "^3.4.0",
+    "vue-router": "^4.4.0",
+    "zod": "^3.24.0",
+    "@seifer-webapp-factory/kits": "^0.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "backend/templates",
+    "frontend/templates",
+    "README.md"
+  ]
+}