@voxgig/build 4.4.0 → 4.12.0

package/dist/env/web/web_gen.js

@@ -26,20 +26,52 @@ const generate_1 = require("../lambda/generate");
 // the project root, which holds backend/ and web/). $$slots$$ in the
 // output path are rendered too.
 const WEB_FILES = [
-    // Frontend SPA (web/)
-    { frag: 'web/package.json.frag', out: 'web/package.json' },
-    { frag: 'web/index.html.frag', out: 'web/index.html' },
-    { frag: 'web/playwright.config.js.frag', out: 'web/playwright.config.js' },
-    { frag: 'web/src/main.js.frag', out: 'web/src/main.js' },
-    { frag: 'web/src/bus.js.frag', out: 'web/src/bus.js' },
-    { frag: 'web/src/style.css.frag', out: 'web/src/style.css' },
-    { frag: 'web/src/cmp/app.js.frag', out: 'web/src/cmp/app.js' },
-    { frag: 'web/src/cmp/auth.js.frag', out: 'web/src/cmp/auth.js' },
-    { frag: 'web/src/cmp/admin.js.frag', out: 'web/src/cmp/admin.js' },
-    { frag: 'web/e2e/smoke.spec.js.frag', out: 'web/e2e/smoke.spec.js' },
+    // Frontend SPA (web/) — a model-driven enterprise app: public site + login,
+    // an app shell (nav / project selector / user menu / collapsible entity
+    // menu), and generic CRUD with relationship navigation. All runtime
+    // model-driven (model.js reads /model.json), so it fits any entity graph.
+    { frag: 'web/package.json.frag', out: '$$fe$$/package.json' },
+    { frag: 'web/index.html.frag', out: '$$fe$$/index.html' },
+    { frag: 'web/playwright.config.js.frag', out: '$$fe$$/playwright.config.js' },
+    { frag: 'web/src/main.js.frag', out: '$$fe$$/src/main.js' },
+    { frag: 'web/src/bus.js.frag', out: '$$fe$$/src/bus.js' },
+    { frag: 'web/src/model.js.frag', out: '$$fe$$/src/model.js' },
+    { frag: 'web/src/api.js.frag', out: '$$fe$$/src/api.js' },
+    { frag: 'web/src/hooks.js.frag', out: '$$fe$$/src/hooks.js' },
+    { frag: 'web/src/theme.js.frag', out: '$$fe$$/src/theme.js' },
+    { frag: 'web/src/customise.js.frag', out: '$$fe$$/src/customise.js' },
+    { frag: 'web/src/custom.css.frag', out: '$$fe$$/src/custom.css' },
+    { frag: 'web/src/style.css.frag', out: '$$fe$$/src/style.css' },
+    { frag: 'web/src/cmp/app.js.frag', out: '$$fe$$/src/cmp/app.js' },
+    { frag: 'web/src/cmp/public.js.frag', out: '$$fe$$/src/cmp/public.js' },
+    { frag: 'web/src/cmp/auth.js.frag', out: '$$fe$$/src/cmp/auth.js' },
+    { frag: 'web/src/cmp/shell.js.frag', out: '$$fe$$/src/cmp/shell.js' },
+    { frag: 'web/src/cmp/admin.js.frag', out: '$$fe$$/src/cmp/admin.js' },
+    { frag: 'web/src/cmp/settings.js.frag', out: '$$fe$$/src/cmp/settings.js' },
+    // Per-component doc sidecars (mermaid structure + message diagrams),
+    // create-once next to each component.
+    { frag: 'web/src/cmp/app.md.frag', out: '$$fe$$/src/cmp/app.md' },
+    { frag: 'web/src/cmp/public.md.frag', out: '$$fe$$/src/cmp/public.md' },
+    { frag: 'web/src/cmp/auth.md.frag', out: '$$fe$$/src/cmp/auth.md' },
+    { frag: 'web/src/cmp/shell.md.frag', out: '$$fe$$/src/cmp/shell.md' },
+    { frag: 'web/src/cmp/admin.md.frag', out: '$$fe$$/src/cmp/admin.md' },
+    { frag: 'web/src/cmp/settings.md.frag', out: '$$fe$$/src/cmp/settings.md' },
+    { frag: 'web/e2e/smoke.spec.js.frag', out: '$$fe$$/e2e/smoke.spec.js' },
+    { frag: 'web/AGENTS.md.frag', out: '$$fe$$/AGENTS.md' },
+    // Project docs (Diátaxis) for the web app, alongside the scaffold's
+    // backend docs (@voxgig/create-system DocsPart). Create-once like all
+    // WEB_FILES: the project owns its docs after generation.
+    { frag: 'docs/how-to/customise-the-web-app.md.frag', out: 'docs/how-to/customise-the-web-app.md' },
+    { frag: 'docs/how-to/use-the-api.md.frag', out: 'docs/how-to/use-the-api.md' },
+    { frag: 'docs/how-to/change-the-theme.md.frag', out: 'docs/how-to/change-the-theme.md' },
+    { frag: 'docs/how-to/add-a-custom-entity-view.md.frag', out: 'docs/how-to/add-a-custom-entity-view.md' },
+    { frag: 'docs/reference/web-app.md.frag', out: 'docs/reference/web-app.md' },
+    { frag: 'docs/explanation/web-architecture.md.frag', out: 'docs/explanation/web-architecture.md' },
     // Backend web runner + auth service (backend/src/...)
     { frag: 'backend/env/web/web.ts.frag', out: 'backend/src/env/web/web.ts' },
+    { frag: 'backend/env/shared/seed.ts.frag', out: 'backend/src/env/shared/seed.ts' },
     { frag: 'backend/srv/auth/auth-srv.ts.frag', out: 'backend/src/srv/auth/auth-srv.ts' },
+    { frag: 'backend/srv/auth/user_util.ts.frag', out: 'backend/src/srv/auth/user_util.ts' },
     { frag: 'backend/srv/auth/get_info.ts.frag', out: 'backend/src/srv/auth/get_info.ts' },
     { frag: 'backend/srv/auth/signin_user.ts.frag', out: 'backend/src/srv/auth/signin_user.ts' },
     { frag: 'backend/srv/auth/signout_user.ts.frag', out: 'backend/src/srv/auth/signout_user.ts' },
@@ -47,6 +79,56 @@ const WEB_FILES = [
     { frag: 'backend/srv/auth/web_signin_user.ts.frag', out: 'backend/src/srv/auth/web_signin_user.ts' },
     { frag: 'backend/srv/auth/web_signout_user.ts.frag', out: 'backend/src/srv/auth/web_signout_user.ts' },
     { frag: 'backend/srv/auth/web_load_auth.ts.frag', out: 'backend/src/srv/auth/web_load_auth.ts' },
+    // Auth settings/security extensions.
+    { frag: 'backend/srv/auth/change_pass.ts.frag', out: 'backend/src/srv/auth/change_pass.ts' },
+    { frag: 'backend/srv/auth/web_change_pass.ts.frag', out: 'backend/src/srv/auth/web_change_pass.ts' },
+    { frag: 'backend/srv/auth/update_user.ts.frag', out: 'backend/src/srv/auth/update_user.ts' },
+    { frag: 'backend/srv/auth/web_update_user.ts.frag', out: 'backend/src/srv/auth/web_update_user.ts' },
+    { frag: 'backend/srv/auth/remind_pass.ts.frag', out: 'backend/src/srv/auth/remind_pass.ts' },
+    { frag: 'backend/srv/auth/web_remind_pass.ts.frag', out: 'backend/src/srv/auth/web_remind_pass.ts' },
+    // API access keys (Settings & security + REST API auth).
+    { frag: 'backend/srv/auth/apikey_util.ts.frag', out: 'backend/src/srv/auth/apikey_util.ts' },
+    { frag: 'backend/srv/auth/create_apikey.ts.frag', out: 'backend/src/srv/auth/create_apikey.ts' },
+    { frag: 'backend/srv/auth/list_apikey.ts.frag', out: 'backend/src/srv/auth/list_apikey.ts' },
+    { frag: 'backend/srv/auth/revoke_apikey.ts.frag', out: 'backend/src/srv/auth/revoke_apikey.ts' },
+    { frag: 'backend/srv/auth/web_create_apikey.ts.frag', out: 'backend/src/srv/auth/web_create_apikey.ts' },
+    { frag: 'backend/srv/auth/web_list_apikey.ts.frag', out: 'backend/src/srv/auth/web_list_apikey.ts' },
+    { frag: 'backend/srv/auth/web_revoke_apikey.ts.frag', out: 'backend/src/srv/auth/web_revoke_apikey.ts' },
+    // The strict-JSON REST API (model main.api): api service + HTTP mapping.
+    // valid_gen.ts (request validation shapes) is REGENERATED by api_gen.
+    { frag: 'backend/srv/api/api-srv.ts.frag', out: 'backend/src/srv/api/api-srv.ts' },
+    { frag: 'backend/srv/api/get_info.ts.frag', out: 'backend/src/srv/api/get_info.ts' },
+    { frag: 'backend/srv/api/on_ent.ts.frag', out: 'backend/src/srv/api/on_ent.ts' },
+    { frag: 'backend/srv/api/expose.ts.frag', out: 'backend/src/srv/api/expose.ts' },
+    { frag: 'backend/env/web/api.ts.frag', out: 'backend/src/env/web/api.ts' },
+    // Unit tests for what EnvWeb generates (node:test). They are
+    // MODEL-DRIVEN - the entity under test and its payloads come from the
+    // model - so they hold for any entity graph, and they stand in for
+    // other services with mock messages rather than booting them.
+    { frag: 'backend/test/unit/srv/api/api.setup.ts.frag', out: 'backend/test/unit/srv/api/api.setup.ts' },
+    { frag: 'backend/test/unit/srv/api/api.test.ts.frag', out: 'backend/test/unit/srv/api/api.test.ts' },
+    { frag: 'backend/test/unit/srv/auth/auth.setup.ts.frag', out: 'backend/test/unit/srv/auth/auth.setup.ts' },
+    { frag: 'backend/test/unit/srv/auth/apikey.test.ts.frag', out: 'backend/test/unit/srv/auth/apikey.test.ts' },
+    { frag: 'backend/test/unit/srv/auth/session.test.ts.frag', out: 'backend/test/unit/srv/auth/session.test.ts' },
+    { frag: 'backend/test/unit/env/web/api-router.test.ts.frag', out: 'backend/test/unit/env/web/api-router.test.ts' },
+    { frag: 'backend/test/unit/env/web/surface.test.ts.frag', out: 'backend/test/unit/env/web/surface.test.ts' },
+    { frag: 'backend/test/unit/srv/ent/ent.setup.ts.frag', out: 'backend/test/unit/srv/ent/ent.setup.ts' },
+    { frag: 'backend/test/unit/srv/ent/proxy.test.ts.frag', out: 'backend/test/unit/srv/ent/proxy.test.ts' },
+    // Generic entity service (parameterised CRUD, membership-scoped).
+    { frag: 'backend/srv/ent/ent-srv.ts.frag', out: 'backend/src/srv/ent/ent-srv.ts' },
+    { frag: 'backend/srv/ent/access.ts.frag', out: 'backend/src/srv/ent/access.ts' },
+    { frag: 'backend/srv/ent/get_info.ts.frag', out: 'backend/src/srv/ent/get_info.ts' },
+    { frag: 'backend/srv/ent/cmd_list.ts.frag', out: 'backend/src/srv/ent/cmd_list.ts' },
+    { frag: 'backend/srv/ent/cmd_load.ts.frag', out: 'backend/src/srv/ent/cmd_load.ts' },
+    { frag: 'backend/srv/ent/cmd_save.ts.frag', out: 'backend/src/srv/ent/cmd_save.ts' },
+    { frag: 'backend/srv/ent/cmd_remove.ts.frag', out: 'backend/src/srv/ent/cmd_remove.ts' },
+    // Browser proxies: aim:web,on:ent,cmd:* -> aim:ent,cmd:* (the gateway
+    // accepts only aim:web, so the entity service is never posted directly
+    // from a browser).
+    { frag: 'backend/srv/ent/web_cmd_list.ts.frag', out: 'backend/src/srv/ent/web_cmd_list.ts' },
+    { frag: 'backend/srv/ent/web_cmd_load.ts.frag', out: 'backend/src/srv/ent/web_cmd_load.ts' },
+    { frag: 'backend/srv/ent/web_cmd_save.ts.frag', out: 'backend/src/srv/ent/web_cmd_save.ts' },
+    { frag: 'backend/srv/ent/web_cmd_remove.ts.frag', out: 'backend/src/srv/ent/web_cmd_remove.ts' },
 ];
 exports.WEB_FILES = WEB_FILES;
 // Default seeded users (local testing only), rendered into the runner.
@@ -55,12 +137,39 @@ const DEFAULT_USERS = [
     { name: 'Bob Example', email: 'bob@example.com', password: 'bob-pass-01' },
 ];
 exports.DEFAULT_USERS = DEFAULT_USERS;
+// The frontend folder name, from the model env entry (`web: { dir: ... }`).
+// Defaults to 'web', so a project that says nothing keeps the layout it
+// already has. Everything that names the folder - the WEB_FILES output
+// paths, views.js, theme.css, and the static path the backend runner
+// serves - goes through this one value, via the $$fe$$ slot.
+//
+// Only the FOLDER moves. The `aim:web` message namespace is unrelated and
+// must never follow it: the gateway allow-list is the literal
+// { 'aim:web': true }, and backend/src/env/web/ is the backend runner, not
+// the SPA.
+const DEFAULT_FE = 'web';
+// Absent means 'web'. ANYTHING ELSE provided is validated rather than
+// silently defaulted - `dir: ''` is a mistake, not a request for 'web', and
+// defaulting it would generate the whole SPA into the project root.
+function feDir(envdef) {
+    const dir = null == envdef ? undefined : envdef.dir;
+    if (null == dir) {
+        return DEFAULT_FE;
+    }
+    if ('string' !== typeof dir || '' === dir || dir.split('/').includes('..') ||
+        path_1.default.isAbsolute(dir)) {
+        throw new Error('EnvWeb: env web `dir` must be a non-empty relative folder name, got: ' +
+            JSON.stringify(dir));
+    }
+    return dir;
+}
 // web_gen(model, spec): generate the frontend + backend web pieces into
 // the project. spec.root is the project root (parent of backend/); files
 // that already exist are left untouched (create-once).
 const web_gen = async (model, spec) => {
     const core = (0, conf_1.CoreConfShape)(model.main.conf.core);
     const envdef = spec.env || {};
+    const fe = feDir(envdef);
     const users = envdef.users || DEFAULT_USERS;
     const seed = users[0] || DEFAULT_USERS[0];
     const port = envdef.port ||
@@ -68,6 +177,7 @@ const web_gen = async (model, spec) => {
     const slots = {
         name: core.name,
         Name: (0, util_1.camelify)(core.name),
+        fe,
         users: JSON.stringify(users, null, 2),
         e2eport: envdef.e2eport || (port + 10),
         seedEmail: seed.email,
@@ -87,6 +197,82 @@ const web_gen = async (model, spec) => {
         fs_1.default.writeFileSync(dest, content);
         created.push(outrel);
     }
+    // Custom entity views: for every entity declaring `ux:{ view: 'custom' }`,
+    // generate a hand-coded view component (CREATE-ONCE, so edits survive) plus
+    // an always-regenerated index (views.js) that imports them.
+    const entzones = model.main.ent || {};
+    const customs = [];
+    for (const zone of Object.keys(entzones)) {
+        for (const name of Object.keys(entzones[zone])) {
+            const def = entzones[zone][name];
+            if (def && def.ux && 'custom' === def.ux.view) {
+                customs.push({ zone, name, canon: zone + '/' + name });
+            }
+        }
+    }
+    for (const c of customs) {
+        const vslots = Object.assign({}, slots, {
+            canon: c.canon,
+            zone: c.zone,
+            name: c.name,
+            tag: 'vg-view-' + c.zone + '-' + c.name,
+            className: 'VgView' + (0, util_1.camelify)(c.zone) + (0, util_1.camelify)(c.name),
+            Label: (0, util_1.camelify)(c.name),
+        });
+        // The component starter plus its doc sidecar, both create-once.
+        for (const ext of ['js', 'md']) {
+            const outrel = fe + '/src/cmp/view/' + c.zone + '_' + c.name + '.' + ext;
+            const dest = path_1.default.join(spec.root, outrel);
+            if (fs_1.default.existsSync(dest) && !spec.force) {
+                skipped.push(outrel);
+                continue;
+            }
+            const content = (0, generate_1.renderFragment)((0, generate_1.loadFragment)('web/src/cmp/view/custom-view.' + ext + '.frag', spec, 'web'), vslots);
+            fs_1.default.mkdirSync(path_1.default.dirname(dest), { recursive: true });
+            fs_1.default.writeFileSync(dest, content);
+            created.push(outrel);
+        }
+    }
+    // views.js — the generated index of custom views. Regenerated whenever the
+    // set of custom views changes; a no-op run leaves it (and `created`) alone.
+    const viewsRel = fe + '/src/views.js';
+    const viewsPath = path_1.default.join(spec.root, viewsRel);
+    const viewsBody = '// AUTO-GENERATED: imports every custom entity view (model entities declaring\n' +
+        '// ux:{view:\'custom\'}). Regenerated from the model — do not edit. The view\n' +
+        '// files it imports are hand-coded and create-once.\n\n' +
+        customs.map((c) => `import './cmp/view/${c.zone}_${c.name}.js'`).join('\n') + '\n';
+    const existingViews = fs_1.default.existsSync(viewsPath) ? fs_1.default.readFileSync(viewsPath, 'utf8') : null;
+    if (existingViews !== viewsBody) {
+        fs_1.default.mkdirSync(path_1.default.join(spec.root, fe, 'src'), { recursive: true });
+        fs_1.default.writeFileSync(viewsPath, viewsBody);
+        created.push(viewsRel);
+    }
+    // theme.css — the design theme from the model (main.theme). Each mode's
+    // tokens become CSS variables under :root[data-theme-mode="<mode>"], with the
+    // default mode also on plain :root. Regenerated from the model; override
+    // tokens in custom.css and add modes via the theme:modes hook.
+    const theme = model.main && model.main.theme;
+    if (theme && theme.modes && Object.keys(theme.modes).length) {
+        const defMode = theme.mode || Object.keys(theme.modes)[0];
+        const tokensCss = (tokens) => Object.keys(tokens).sort()
+            .map((k) => `  --vg-${k}: ${tokens[k]};`).join('\n');
+        const blocks = [':root,\n:root[data-theme-mode="' + defMode + '"] {\n' + tokensCss(theme.modes[defMode]) + '\n}'];
+        for (const mode of Object.keys(theme.modes)) {
+            if (mode !== defMode) {
+                blocks.push(':root[data-theme-mode="' + mode + '"] {\n' + tokensCss(theme.modes[mode]) + '\n}');
+            }
+        }
+        const themeBody = '/* AUTO-GENERATED from the model theme (main.theme) — do not edit.\n' +
+            '   Override tokens in custom.css; add modes via the theme:modes hook. */\n\n' +
+            blocks.join('\n\n') + '\n';
+        const themePath = path_1.default.join(spec.root, fe, 'src/theme.css');
+        const existingTheme = fs_1.default.existsSync(themePath) ? fs_1.default.readFileSync(themePath, 'utf8') : null;
+        if (existingTheme !== themeBody) {
+            fs_1.default.mkdirSync(path_1.default.join(spec.root, fe, 'src'), { recursive: true });
+            fs_1.default.writeFileSync(themePath, themeBody);
+            created.push(fe + '/src/theme.css');
+        }
+    }
     return { created: created.sort(), skipped: skipped.sort() };
 };
 exports.web_gen = web_gen;

package/dist/env/web/web_gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"web_gen.js","sourceRoot":"","sources":["../../../env/web/web_gen.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"web_gen.js","sourceRoot":"","sources":["../../../env/web/web_gen.ts"],"names":[],"mappings":"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"}

package/dist/shape/ent.js

@@ -3,7 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntShape = void 0;
 const gubu_1 = require("gubu");
 const { Open, Skip } = gubu_1.Gubu;
-const EntShape = (0, gubu_1.Gubu)({
+// Open: entities may carry extra attributes beyond the deployment-relevant
+// ones below (e.g. `ux` for frontend view hints), which this generator ignores.
+const EntShape = (0, gubu_1.Gubu)(Open({
     id: {
         field: 'id'
     },
@@ -23,6 +25,6 @@ const EntShape = (0, gubu_1.Gubu)({
         active: false
     }),
     custom: Skip(String),
-}, { prefix: 'Entity' });
+}), { prefix: 'Entity' });
 exports.EntShape = EntShape;
 //# sourceMappingURL=ent.js.map

package/dist/shape/ent.js.map

@@ -1 +1 @@
-{"version":3,"file":"ent.js","sourceRoot":"","sources":["../../shape/ent.ts"],"names":[],"mappings":";;;AACA,+BAA2B;AAE3B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,WAAI,CAAA;AAG3B,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC;IACpB,EAAE,EAAE;QACF,KAAK,EAAE,IAAI;KACZ;IACD,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EACrB,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;IACf,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EACrB,CAAC;IACF,QAAQ,EAAE,IAAI,CAAC;QACb,IAAI,EAAE,EAAE;KACT,CAAC;IACF,MAAM,EAAE,IAAI,CAAC;QACX,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;KACX,CAAC;IACF,KAAK,EAAE,IAAI,CAAC;QACV,MAAM,EAAE,KAAK;KACd,CAAC;IACF,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;CACrB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;AAItB,4BAAQ"}
+{"version":3,"file":"ent.js","sourceRoot":"","sources":["../../shape/ent.ts"],"names":[],"mappings":";;;AACA,+BAA2B;AAE3B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,WAAI,CAAA;AAG3B,2EAA2E;AAC3E,gFAAgF;AAChF,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC;IACzB,EAAE,EAAE;QACF,KAAK,EAAE,IAAI;KACZ;IACD,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EACrB,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;IACf,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EACrB,CAAC;IACF,QAAQ,EAAE,IAAI,CAAC;QACb,IAAI,EAAE,EAAE;KACT,CAAC;IACF,MAAM,EAAE,IAAI,CAAC;QACX,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;KACX,CAAC;IACF,KAAK,EAAE,IAAI,CAAC;QACV,MAAM,EAAE,KAAK;KACd,CAAC;IACF,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;CACrB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;AAIvB,4BAAQ"}

package/env/web/web_gen.ts

@@ -27,21 +27,55 @@ import { loadFragment, renderFragment } from '../lambda/generate'
 // the project root, which holds backend/ and web/). $$slots$$ in the
 // output path are rendered too.
 const WEB_FILES: { frag: string, out: string }[] = [
-  // Frontend SPA (web/)
-  { frag: 'web/package.json.frag', out: 'web/package.json' },
-  { frag: 'web/index.html.frag', out: 'web/index.html' },
-  { frag: 'web/playwright.config.js.frag', out: 'web/playwright.config.js' },
-  { frag: 'web/src/main.js.frag', out: 'web/src/main.js' },
-  { frag: 'web/src/bus.js.frag', out: 'web/src/bus.js' },
-  { frag: 'web/src/style.css.frag', out: 'web/src/style.css' },
-  { frag: 'web/src/cmp/app.js.frag', out: 'web/src/cmp/app.js' },
-  { frag: 'web/src/cmp/auth.js.frag', out: 'web/src/cmp/auth.js' },
-  { frag: 'web/src/cmp/admin.js.frag', out: 'web/src/cmp/admin.js' },
-  { frag: 'web/e2e/smoke.spec.js.frag', out: 'web/e2e/smoke.spec.js' },
+  // Frontend SPA (web/) — a model-driven enterprise app: public site + login,
+  // an app shell (nav / project selector / user menu / collapsible entity
+  // menu), and generic CRUD with relationship navigation. All runtime
+  // model-driven (model.js reads /model.json), so it fits any entity graph.
+  { frag: 'web/package.json.frag', out: '$$fe$$/package.json' },
+  { frag: 'web/index.html.frag', out: '$$fe$$/index.html' },
+  { frag: 'web/playwright.config.js.frag', out: '$$fe$$/playwright.config.js' },
+  { frag: 'web/src/main.js.frag', out: '$$fe$$/src/main.js' },
+  { frag: 'web/src/bus.js.frag', out: '$$fe$$/src/bus.js' },
+  { frag: 'web/src/model.js.frag', out: '$$fe$$/src/model.js' },
+  { frag: 'web/src/api.js.frag', out: '$$fe$$/src/api.js' },
+  { frag: 'web/src/hooks.js.frag', out: '$$fe$$/src/hooks.js' },
+  { frag: 'web/src/theme.js.frag', out: '$$fe$$/src/theme.js' },
+  { frag: 'web/src/customise.js.frag', out: '$$fe$$/src/customise.js' },
+  { frag: 'web/src/custom.css.frag', out: '$$fe$$/src/custom.css' },
+  { frag: 'web/src/style.css.frag', out: '$$fe$$/src/style.css' },
+  { frag: 'web/src/cmp/app.js.frag', out: '$$fe$$/src/cmp/app.js' },
+  { frag: 'web/src/cmp/public.js.frag', out: '$$fe$$/src/cmp/public.js' },
+  { frag: 'web/src/cmp/auth.js.frag', out: '$$fe$$/src/cmp/auth.js' },
+  { frag: 'web/src/cmp/shell.js.frag', out: '$$fe$$/src/cmp/shell.js' },
+  { frag: 'web/src/cmp/admin.js.frag', out: '$$fe$$/src/cmp/admin.js' },
+  { frag: 'web/src/cmp/settings.js.frag', out: '$$fe$$/src/cmp/settings.js' },
+
+  // Per-component doc sidecars (mermaid structure + message diagrams),
+  // create-once next to each component.
+  { frag: 'web/src/cmp/app.md.frag', out: '$$fe$$/src/cmp/app.md' },
+  { frag: 'web/src/cmp/public.md.frag', out: '$$fe$$/src/cmp/public.md' },
+  { frag: 'web/src/cmp/auth.md.frag', out: '$$fe$$/src/cmp/auth.md' },
+  { frag: 'web/src/cmp/shell.md.frag', out: '$$fe$$/src/cmp/shell.md' },
+  { frag: 'web/src/cmp/admin.md.frag', out: '$$fe$$/src/cmp/admin.md' },
+  { frag: 'web/src/cmp/settings.md.frag', out: '$$fe$$/src/cmp/settings.md' },
+  { frag: 'web/e2e/smoke.spec.js.frag', out: '$$fe$$/e2e/smoke.spec.js' },
+  { frag: 'web/AGENTS.md.frag', out: '$$fe$$/AGENTS.md' },
+
+  // Project docs (Diátaxis) for the web app, alongside the scaffold's
+  // backend docs (@voxgig/create-system DocsPart). Create-once like all
+  // WEB_FILES: the project owns its docs after generation.
+  { frag: 'docs/how-to/customise-the-web-app.md.frag', out: 'docs/how-to/customise-the-web-app.md' },
+  { frag: 'docs/how-to/use-the-api.md.frag', out: 'docs/how-to/use-the-api.md' },
+  { frag: 'docs/how-to/change-the-theme.md.frag', out: 'docs/how-to/change-the-theme.md' },
+  { frag: 'docs/how-to/add-a-custom-entity-view.md.frag', out: 'docs/how-to/add-a-custom-entity-view.md' },
+  { frag: 'docs/reference/web-app.md.frag', out: 'docs/reference/web-app.md' },
+  { frag: 'docs/explanation/web-architecture.md.frag', out: 'docs/explanation/web-architecture.md' },
 
   // Backend web runner + auth service (backend/src/...)
   { frag: 'backend/env/web/web.ts.frag', out: 'backend/src/env/web/web.ts' },
+  { frag: 'backend/env/shared/seed.ts.frag', out: 'backend/src/env/shared/seed.ts' },
   { frag: 'backend/srv/auth/auth-srv.ts.frag', out: 'backend/src/srv/auth/auth-srv.ts' },
+  { frag: 'backend/srv/auth/user_util.ts.frag', out: 'backend/src/srv/auth/user_util.ts' },
   { frag: 'backend/srv/auth/get_info.ts.frag', out: 'backend/src/srv/auth/get_info.ts' },
   { frag: 'backend/srv/auth/signin_user.ts.frag', out: 'backend/src/srv/auth/signin_user.ts' },
   { frag: 'backend/srv/auth/signout_user.ts.frag', out: 'backend/src/srv/auth/signout_user.ts' },
@@ -49,6 +83,62 @@ const WEB_FILES: { frag: string, out: string }[] = [
   { frag: 'backend/srv/auth/web_signin_user.ts.frag', out: 'backend/src/srv/auth/web_signin_user.ts' },
   { frag: 'backend/srv/auth/web_signout_user.ts.frag', out: 'backend/src/srv/auth/web_signout_user.ts' },
   { frag: 'backend/srv/auth/web_load_auth.ts.frag', out: 'backend/src/srv/auth/web_load_auth.ts' },
+
+  // Auth settings/security extensions.
+  { frag: 'backend/srv/auth/change_pass.ts.frag', out: 'backend/src/srv/auth/change_pass.ts' },
+  { frag: 'backend/srv/auth/web_change_pass.ts.frag', out: 'backend/src/srv/auth/web_change_pass.ts' },
+  { frag: 'backend/srv/auth/update_user.ts.frag', out: 'backend/src/srv/auth/update_user.ts' },
+  { frag: 'backend/srv/auth/web_update_user.ts.frag', out: 'backend/src/srv/auth/web_update_user.ts' },
+  { frag: 'backend/srv/auth/remind_pass.ts.frag', out: 'backend/src/srv/auth/remind_pass.ts' },
+  { frag: 'backend/srv/auth/web_remind_pass.ts.frag', out: 'backend/src/srv/auth/web_remind_pass.ts' },
+
+  // API access keys (Settings & security + REST API auth).
+  { frag: 'backend/srv/auth/apikey_util.ts.frag', out: 'backend/src/srv/auth/apikey_util.ts' },
+  { frag: 'backend/srv/auth/create_apikey.ts.frag', out: 'backend/src/srv/auth/create_apikey.ts' },
+  { frag: 'backend/srv/auth/list_apikey.ts.frag', out: 'backend/src/srv/auth/list_apikey.ts' },
+  { frag: 'backend/srv/auth/revoke_apikey.ts.frag', out: 'backend/src/srv/auth/revoke_apikey.ts' },
+  { frag: 'backend/srv/auth/web_create_apikey.ts.frag', out: 'backend/src/srv/auth/web_create_apikey.ts' },
+  { frag: 'backend/srv/auth/web_list_apikey.ts.frag', out: 'backend/src/srv/auth/web_list_apikey.ts' },
+  { frag: 'backend/srv/auth/web_revoke_apikey.ts.frag', out: 'backend/src/srv/auth/web_revoke_apikey.ts' },
+
+  // The strict-JSON REST API (model main.api): api service + HTTP mapping.
+  // valid_gen.ts (request validation shapes) is REGENERATED by api_gen.
+  { frag: 'backend/srv/api/api-srv.ts.frag', out: 'backend/src/srv/api/api-srv.ts' },
+  { frag: 'backend/srv/api/get_info.ts.frag', out: 'backend/src/srv/api/get_info.ts' },
+  { frag: 'backend/srv/api/on_ent.ts.frag', out: 'backend/src/srv/api/on_ent.ts' },
+  { frag: 'backend/srv/api/expose.ts.frag', out: 'backend/src/srv/api/expose.ts' },
+  { frag: 'backend/env/web/api.ts.frag', out: 'backend/src/env/web/api.ts' },
+
+  // Unit tests for what EnvWeb generates (node:test). They are
+  // MODEL-DRIVEN - the entity under test and its payloads come from the
+  // model - so they hold for any entity graph, and they stand in for
+  // other services with mock messages rather than booting them.
+  { frag: 'backend/test/unit/srv/api/api.setup.ts.frag', out: 'backend/test/unit/srv/api/api.setup.ts' },
+  { frag: 'backend/test/unit/srv/api/api.test.ts.frag', out: 'backend/test/unit/srv/api/api.test.ts' },
+  { frag: 'backend/test/unit/srv/auth/auth.setup.ts.frag', out: 'backend/test/unit/srv/auth/auth.setup.ts' },
+  { frag: 'backend/test/unit/srv/auth/apikey.test.ts.frag', out: 'backend/test/unit/srv/auth/apikey.test.ts' },
+  { frag: 'backend/test/unit/srv/auth/session.test.ts.frag', out: 'backend/test/unit/srv/auth/session.test.ts' },
+  { frag: 'backend/test/unit/env/web/api-router.test.ts.frag', out: 'backend/test/unit/env/web/api-router.test.ts' },
+  { frag: 'backend/test/unit/env/web/surface.test.ts.frag', out: 'backend/test/unit/env/web/surface.test.ts' },
+  { frag: 'backend/test/unit/srv/ent/ent.setup.ts.frag', out: 'backend/test/unit/srv/ent/ent.setup.ts' },
+  { frag: 'backend/test/unit/srv/ent/proxy.test.ts.frag', out: 'backend/test/unit/srv/ent/proxy.test.ts' },
+
+  // Generic entity service (parameterised CRUD, membership-scoped).
+  { frag: 'backend/srv/ent/ent-srv.ts.frag', out: 'backend/src/srv/ent/ent-srv.ts' },
+  { frag: 'backend/srv/ent/access.ts.frag', out: 'backend/src/srv/ent/access.ts' },
+  { frag: 'backend/srv/ent/get_info.ts.frag', out: 'backend/src/srv/ent/get_info.ts' },
+  { frag: 'backend/srv/ent/cmd_list.ts.frag', out: 'backend/src/srv/ent/cmd_list.ts' },
+  { frag: 'backend/srv/ent/cmd_load.ts.frag', out: 'backend/src/srv/ent/cmd_load.ts' },
+  { frag: 'backend/srv/ent/cmd_save.ts.frag', out: 'backend/src/srv/ent/cmd_save.ts' },
+  { frag: 'backend/srv/ent/cmd_remove.ts.frag', out: 'backend/src/srv/ent/cmd_remove.ts' },
+
+  // Browser proxies: aim:web,on:ent,cmd:* -> aim:ent,cmd:* (the gateway
+  // accepts only aim:web, so the entity service is never posted directly
+  // from a browser).
+  { frag: 'backend/srv/ent/web_cmd_list.ts.frag', out: 'backend/src/srv/ent/web_cmd_list.ts' },
+  { frag: 'backend/srv/ent/web_cmd_load.ts.frag', out: 'backend/src/srv/ent/web_cmd_load.ts' },
+  { frag: 'backend/srv/ent/web_cmd_save.ts.frag', out: 'backend/src/srv/ent/web_cmd_save.ts' },
+  { frag: 'backend/srv/ent/web_cmd_remove.ts.frag', out: 'backend/src/srv/ent/web_cmd_remove.ts' },
 ]
 
 
@@ -59,19 +149,51 @@ const DEFAULT_USERS = [
 ]
 
 
+// The frontend folder name, from the model env entry (`web: { dir: ... }`).
+// Defaults to 'web', so a project that says nothing keeps the layout it
+// already has. Everything that names the folder - the WEB_FILES output
+// paths, views.js, theme.css, and the static path the backend runner
+// serves - goes through this one value, via the $$fe$$ slot.
+//
+// Only the FOLDER moves. The `aim:web` message namespace is unrelated and
+// must never follow it: the gateway allow-list is the literal
+// { 'aim:web': true }, and backend/src/env/web/ is the backend runner, not
+// the SPA.
+const DEFAULT_FE = 'web'
+
+// Absent means 'web'. ANYTHING ELSE provided is validated rather than
+// silently defaulted - `dir: ''` is a mistake, not a request for 'web', and
+// defaulting it would generate the whole SPA into the project root.
+function feDir(envdef: any): string {
+  const dir = null == envdef ? undefined : envdef.dir
+  if (null == dir) {
+    return DEFAULT_FE
+  }
+  if ('string' !== typeof dir || '' === dir || dir.split('/').includes('..') ||
+    Path.isAbsolute(dir)) {
+    throw new Error(
+      'EnvWeb: env web `dir` must be a non-empty relative folder name, got: ' +
+      JSON.stringify(dir))
+  }
+  return dir
+}
+
+
 // web_gen(model, spec): generate the frontend + backend web pieces into
 // the project. spec.root is the project root (parent of backend/); files
 // that already exist are left untouched (create-once).
 const web_gen = async (model: any, spec: {
-  root: string       // project root (holds backend/ and web/)
+  root: string       // project root (holds backend/ and the frontend folder)
   tm?: string        // project tm/web folder (fragment shadowing)
-  env?: any          // the model env entry (config: port, users)
+  env?: any          // the model env entry (config: port, users, dir)
   force?: boolean    // overwrite existing files (default: create-once)
 }) => {
 
   const core = CoreConfShape(model.main.conf.core)
   const envdef = spec.env || {}
 
+  const fe = feDir(envdef)
+
   const users = envdef.users || DEFAULT_USERS
   const seed = users[0] || DEFAULT_USERS[0]
   const port = envdef.port ||
@@ -80,6 +202,7 @@ const web_gen = async (model: any, spec: {
   const slots: Record<string, any> = {
     name: core.name,
     Name: camelify(core.name),
+    fe,
     users: JSON.stringify(users, null, 2),
     e2eport: envdef.e2eport || (port + 10),
     seedEmail: seed.email,
@@ -104,6 +227,89 @@ const web_gen = async (model: any, spec: {
     created.push(outrel)
   }
 
+  // Custom entity views: for every entity declaring `ux:{ view: 'custom' }`,
+  // generate a hand-coded view component (CREATE-ONCE, so edits survive) plus
+  // an always-regenerated index (views.js) that imports them.
+  const entzones = model.main.ent || {}
+  const customs: { zone: string, name: string, canon: string }[] = []
+  for (const zone of Object.keys(entzones)) {
+    for (const name of Object.keys(entzones[zone])) {
+      const def = entzones[zone][name]
+      if (def && def.ux && 'custom' === def.ux.view) {
+        customs.push({ zone, name, canon: zone + '/' + name })
+      }
+    }
+  }
+
+  for (const c of customs) {
+    const vslots = Object.assign({}, slots, {
+      canon: c.canon,
+      zone: c.zone,
+      name: c.name,
+      tag: 'vg-view-' + c.zone + '-' + c.name,
+      className: 'VgView' + camelify(c.zone) + camelify(c.name),
+      Label: camelify(c.name),
+    })
+    // The component starter plus its doc sidecar, both create-once.
+    for (const ext of ['js', 'md']) {
+      const outrel = fe + '/src/cmp/view/' + c.zone + '_' + c.name + '.' + ext
+      const dest = Path.join(spec.root, outrel)
+      if (Fs.existsSync(dest) && !spec.force) {
+        skipped.push(outrel)
+        continue
+      }
+      const content = renderFragment(
+        loadFragment('web/src/cmp/view/custom-view.' + ext + '.frag', spec, 'web'), vslots)
+      Fs.mkdirSync(Path.dirname(dest), { recursive: true })
+      Fs.writeFileSync(dest, content)
+      created.push(outrel)
+    }
+  }
+
+  // views.js — the generated index of custom views. Regenerated whenever the
+  // set of custom views changes; a no-op run leaves it (and `created`) alone.
+  const viewsRel = fe + '/src/views.js'
+  const viewsPath = Path.join(spec.root, viewsRel)
+  const viewsBody =
+    '// AUTO-GENERATED: imports every custom entity view (model entities declaring\n' +
+    '// ux:{view:\'custom\'}). Regenerated from the model — do not edit. The view\n' +
+    '// files it imports are hand-coded and create-once.\n\n' +
+    customs.map((c) => `import './cmp/view/${c.zone}_${c.name}.js'`).join('\n') + '\n'
+  const existingViews = Fs.existsSync(viewsPath) ? Fs.readFileSync(viewsPath, 'utf8') : null
+  if (existingViews !== viewsBody) {
+    Fs.mkdirSync(Path.join(spec.root, fe, 'src'), { recursive: true })
+    Fs.writeFileSync(viewsPath, viewsBody)
+    created.push(viewsRel)
+  }
+
+  // theme.css — the design theme from the model (main.theme). Each mode's
+  // tokens become CSS variables under :root[data-theme-mode="<mode>"], with the
+  // default mode also on plain :root. Regenerated from the model; override
+  // tokens in custom.css and add modes via the theme:modes hook.
+  const theme = model.main && model.main.theme
+  if (theme && theme.modes && Object.keys(theme.modes).length) {
+    const defMode = theme.mode || Object.keys(theme.modes)[0]
+    const tokensCss = (tokens: any) => Object.keys(tokens).sort()
+      .map((k) => `  --vg-${k}: ${tokens[k]};`).join('\n')
+    const blocks = [':root,\n:root[data-theme-mode="' + defMode + '"] {\n' + tokensCss(theme.modes[defMode]) + '\n}']
+    for (const mode of Object.keys(theme.modes)) {
+      if (mode !== defMode) {
+        blocks.push(':root[data-theme-mode="' + mode + '"] {\n' + tokensCss(theme.modes[mode]) + '\n}')
+      }
+    }
+    const themeBody =
+      '/* AUTO-GENERATED from the model theme (main.theme) — do not edit.\n' +
+      '   Override tokens in custom.css; add modes via the theme:modes hook. */\n\n' +
+      blocks.join('\n\n') + '\n'
+    const themePath = Path.join(spec.root, fe, 'src/theme.css')
+    const existingTheme = Fs.existsSync(themePath) ? Fs.readFileSync(themePath, 'utf8') : null
+    if (existingTheme !== themeBody) {
+      Fs.mkdirSync(Path.join(spec.root, fe, 'src'), { recursive: true })
+      Fs.writeFileSync(themePath, themeBody)
+      created.push(fe + '/src/theme.css')
+    }
+  }
+
   return { created: created.sort(), skipped: skipped.sort() }
 }