@loomweaver/devkit 0.7.2

package/src/recipes/auth-source/recipe.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authSource = void 0;
+exports.resolveAuthSourceInput = resolveAuthSourceInput;
+const casing_1 = require("../../lib/generate/casing");
+function resolveAuthSourceInput(input) {
+    if (!(0, casing_1.isKebabId)(input.name)) {
+        throw new Error(`Auth source name must be kebab-case (e.g. "dev"); got "${input.name}".`);
+    }
+    return {
+        name: input.name,
+        className: (0, casing_1.toPascalCase)(input.name),
+        propertyName: (0, casing_1.toCamelCase)(input.name),
+    };
+}
+function moduleFile(a) {
+    return `// Provider-neutral AuthSource. LoomWeaver owns no authentication — it only reacts to
+// a session snapshot. Wire it with: provideAuthSource(() => ${a.propertyName}AuthSource()).
+// Replace the dev switcher below by mapping your product's real session onto an AuthSnapshot.
+import { signal, Signal } from '@angular/core';
+import { ANONYMOUS, AuthSnapshot } from '@loomweaver/plugin-sdk';
+
+const USER: AuthSnapshot = {
+  authenticated: true,
+  roles: ['user'],
+  claims: {},
+  displayName: 'Signed-in user',
+};
+
+const ADMIN: AuthSnapshot = {
+  authenticated: true,
+  roles: ['user', 'admin'],
+  claims: {},
+  displayName: 'Administrator',
+};
+
+const state = signal<AuthSnapshot>(ANONYMOUS);
+
+export function ${a.propertyName}AuthSource(): Signal<AuthSnapshot> {
+  return state.asReadonly();
+}
+
+export function cycle${a.className}User(): void {
+  const current = state();
+  const next = !current.authenticated
+    ? USER
+    : current.roles.includes('admin')
+      ? ANONYMOUS
+      : ADMIN;
+  state.set(next);
+}
+`;
+}
+exports.authSource = {
+    id: 'auth-source',
+    build(input) {
+        const a = resolveAuthSourceInput(input);
+        return { [`${a.name}-auth-source.ts`]: moduleFile(a) };
+    },
+};
+//# sourceMappingURL=recipe.js.map

package/src/recipes/auth-source/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/recipes/auth-source/recipe.ts"],"names":[],"mappings":";;;AAaA,wDASC;AArBD,sDAAiF;AAYjF,SAAgB,sBAAsB,CAAC,KAAsB;IAC3D,IAAI,CAAC,IAAA,kBAAS,EAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,0DAA0D,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,IAAA,qBAAY,EAAC,KAAK,CAAC,IAAI,CAAC;QACnC,YAAY,EAAE,IAAA,oBAAW,EAAC,KAAK,CAAC,IAAI,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,CAAqB;IACvC,OAAO;+DACsD,CAAC,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;kBAqB3D,CAAC,CAAC,YAAY;;;;uBAIT,CAAC,CAAC,SAAS;;;;;;;;;CASjC,CAAC;AACF,CAAC;AAEY,QAAA,UAAU,GAA4B;IACjD,EAAE,EAAE,aAAa;IACjB,KAAK,CAAC,KAAsB;QAC1B,MAAM,CAAC,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,iBAAiB,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC;CACF,CAAC"}

package/src/recipes/frame-plugin/recipe.d.ts

@@ -0,0 +1,11 @@
+import { Recipe } from '../../lib/generate/types';
+export interface FramePluginInput {
+    readonly id: string;
+    readonly name?: string;
+}
+export interface ResolvedFramePlugin {
+    readonly id: string;
+    readonly name: string;
+}
+export declare function resolveFramePluginInput(input: FramePluginInput): ResolvedFramePlugin;
+export declare const framePlugin: Recipe<FramePluginInput>;

package/src/recipes/frame-plugin/recipe.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.framePlugin = void 0;
+exports.resolveFramePluginInput = resolveFramePluginInput;
+const casing_1 = require("../../lib/generate/casing");
+function resolveFramePluginInput(input) {
+    var _a;
+    if (!(0, casing_1.isKebabId)(input.id)) {
+        throw new Error(`Sandbox plugin id must be kebab-case (e.g. "notes"); got "${input.id}".`);
+    }
+    return { id: input.id, name: ((_a = input.name) === null || _a === void 0 ? void 0 : _a.trim()) || (0, casing_1.toTitleCase)(input.id) };
+}
+function pluginHtml(p) {
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>${p.name} — frame plugin (logic)</title>
+  </head>
+  <body>
+    <script src="/frame-kit/penpal.global.js"></script>
+    <script src="./plugin.js"></script>
+  </body>
+</html>
+`;
+}
+function pluginJs(p) {
+    return `(function () {
+  const Penpal = globalThis.Penpal;
+  const messenger = new Penpal.WindowMessenger({
+    remoteWindow: globalThis.parent,
+    allowedOrigins: ['*'],
+  });
+  const connection = Penpal.connect({ messenger });
+
+  connection.promise
+    .then(function (ctx) {
+      return Promise.all([
+        ctx.toast({ message: '${p.name} ready', kind: 'success', timeoutMs: 4000 }),
+        ctx.registerSurface({
+          id: '${p.id}.view',
+          title: '${p.name}',
+          iframe: '/${p.id}/view.html',
+          routable: { path: '${p.id}', titleIsLiteral: true },
+        }),
+      ]);
+    })
+    .catch(function (error) {
+      console.error('[${p.id}] frame plugin failed', error);
+    });
+})();
+`;
+}
+function viewHtml(p) {
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>${p.name}</title>
+    <link rel="stylesheet" href="/frame-kit/lw-frame.css" />
+    <style>
+      body {
+        margin: 0;
+        font-family: var(--lw-font-sans, system-ui, sans-serif);
+        color: var(--lw-content, #1f2937);
+        background: var(--lw-surface, transparent);
+      }
+      .wrap { max-width: 42rem; margin: 0 auto; padding: 1.5rem; }
+      h1 { font-size: 1.125rem; font-weight: 600; }
+      p { color: var(--lw-content-faint, #6b7280); }
+    </style>
+  </head>
+  <body>
+    <div class="wrap">
+      <h1>${p.name}</h1>
+      <p>
+        Your sandboxed surface. It runs isolated in its own iframe, so its body can be built with
+        any framework (React, Vue, Svelte, vanilla). The frame UI kit (served by the distribution
+        under <code>/frame-kit/</code>) defines the <code>lw-*</code> element family and
+        the <code>.lw-*</code> class contracts; the host pushes its resolved design tokens over RPC.
+      </p>
+      <p><lw-button variant="primary" size="sm">Kit button</lw-button></p>
+    </div>
+    <script src="/frame-kit/penpal.global.js"></script>
+    <script src="/frame-kit/lw-elements.global.js"></script>
+    <script>
+      globalThis.Penpal.connect({
+        messenger: new globalThis.Penpal.WindowMessenger({
+          remoteWindow: globalThis.parent,
+          allowedOrigins: ['*'],
+        }),
+        methods: {
+          render: function (state) {
+            globalThis.LwFrame.applySurfaceState(state);
+          },
+        },
+      });
+    </script>
+  </body>
+</html>
+`;
+}
+function readme(p) {
+    return [
+        `# ${p.name} — frame plugin`,
+        '',
+        `A framework-agnostic LoomWeaver plugin: it runs in an isolated \`<iframe sandbox>\` and`,
+        `receives \`ctx\` over Penpal RPC through the same default-deny broker a trusted plugin uses.`,
+        '',
+        '## Serve it + wire it into a distribution',
+        '',
+        `1. Put these files under the distribution's static dir, e.g. \`public/${p.id}/\`. The plugin`,
+        `   references the **frame UI kit** (\`@loomweaver/frame-kit\`) at \`/frame-kit/\` —`,
+        `   the distribution serves it via an assets glob (generated distributions already do):`,
+        '',
+        '   ```jsonc',
+        '   { "input": "node_modules/@loomweaver/frame-kit/dist", "glob": "**", "output": "frame-kit" }',
+        '   ```',
+        '',
+        `2. Register + grant it in the composition root:`,
+        '',
+        '   ```ts',
+        `   provideFramePlugins({ id: '${p.id}', entryUrl: '/${p.id}/plugin.html', capabilities: ['contributions', 'ui'] });`,
+        `   provideCapabilityGrants({ '${p.id}': ['contributions', 'ui'] });`,
+        '   ```',
+        '',
+        `The surface is routable at \`/${p.id}\`. Replace \`view.html\` with your own UI in any framework.`,
+        '',
+    ].join('\n');
+}
+exports.framePlugin = {
+    id: 'frame-plugin',
+    build(input) {
+        const p = resolveFramePluginInput(input);
+        return {
+            'plugin.html': pluginHtml(p),
+            'plugin.js': pluginJs(p),
+            'view.html': viewHtml(p),
+            'README.md': readme(p),
+        };
+    },
+};
+//# sourceMappingURL=recipe.js.map

package/src/recipes/frame-plugin/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/recipes/frame-plugin/recipe.ts"],"names":[],"mappings":";;;AAaA,0DAKC;AAjBD,sDAAmE;AAYnE,SAAgB,uBAAuB,CAAC,KAAuB;;IAC7D,IAAI,CAAC,IAAA,kBAAS,EAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,6DAA6D,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,CAAA,MAAA,KAAK,CAAC,IAAI,0CAAE,IAAI,EAAE,KAAI,IAAA,oBAAW,EAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,UAAU,CAAC,CAAsB;IACxC,OAAO;;;;aAII,CAAC,CAAC,IAAI;;;;;;;CAOlB,CAAC;AACF,CAAC;AAED,SAAS,QAAQ,CAAC,CAAsB;IACtC,OAAO;;;;;;;;;;;gCAWuB,CAAC,CAAC,IAAI;;iBAErB,CAAC,CAAC,EAAE;oBACD,CAAC,CAAC,IAAI;sBACJ,CAAC,CAAC,EAAE;+BACK,CAAC,CAAC,EAAE;;;;;wBAKX,CAAC,CAAC,EAAE;;;CAG3B,CAAC;AACF,CAAC;AAED,SAAS,QAAQ,CAAC,CAAsB;IACtC,OAAO;;;;aAII,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;YAgBP,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BjB,CAAC;AACF,CAAC;AAED,SAAS,MAAM,CAAC,CAAsB;IACpC,OAAO;QACL,KAAK,CAAC,CAAC,IAAI,iBAAiB;QAC5B,EAAE;QACF,yFAAyF;QACzF,8FAA8F;QAC9F,EAAE;QACF,2CAA2C;QAC3C,EAAE;QACF,yEAAyE,CAAC,CAAC,EAAE,iBAAiB;QAC9F,qFAAqF;QACrF,wFAAwF;QACxF,EAAE;QACF,aAAa;QACb,gGAAgG;QAChG,QAAQ;QACR,EAAE;QACF,iDAAiD;QACjD,EAAE;QACF,UAAU;QACV,iCAAiC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,0DAA0D;QACrH,iCAAiC,CAAC,CAAC,EAAE,gCAAgC;QACrE,QAAQ;QACR,EAAE;QACF,iCAAiC,CAAC,CAAC,EAAE,8DAA8D;QACnG,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,WAAW,GAA6B;IACnD,EAAE,EAAE,cAAc;IAClB,KAAK,CAAC,KAAuB;QAC3B,MAAM,CAAC,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO;YACL,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;YAC5B,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;YACxB,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;YACxB,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;SACvB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/src/recipes/layout/recipe.d.ts

@@ -0,0 +1,10 @@
+import { Recipe } from '../../lib/generate/types';
+export interface LayoutInput {
+    readonly name?: string;
+}
+export interface ResolvedLayout {
+    readonly name: string;
+    readonly propertyName: string;
+}
+export declare function resolveLayoutInput(input: LayoutInput): ResolvedLayout;
+export declare const layout: Recipe<LayoutInput>;

package/src/recipes/layout/recipe.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.layout = void 0;
+exports.resolveLayoutInput = resolveLayoutInput;
+const shell_regions_1 = require("../shell-regions");
+const casing_1 = require("../../lib/generate/casing");
+function resolveLayoutInput(input) {
+    var _a;
+    const name = ((_a = input.name) === null || _a === void 0 ? void 0 : _a.trim()) || 'base';
+    if (!(0, casing_1.isKebabId)(name)) {
+        throw new Error(`Layout name must be kebab-case (e.g. "base"); got "${name}".`);
+    }
+    return { name, propertyName: (0, casing_1.toCamelCase)(name) };
+}
+function moduleFile(l) {
+    return `// A base layout for the distribution. Pass it to provideLayout(${l.propertyName}Layout)
+// in src/app/app.config.ts. Region ids are what contributions target — 'primary' (rail) and 'status-bar' (bar) match
+// the devkit weaver defaults, so a scaffolded weaver's rail + bar items land here.
+import { ShellLayout } from '@loomweaver/shell';
+
+export const ${l.propertyName}Layout: ShellLayout = {
+  regions: [
+${(0, shell_regions_1.renderRegions)('    ')}
+  ],
+};
+`;
+}
+exports.layout = {
+    id: 'layout',
+    build(input) {
+        const l = resolveLayoutInput(input);
+        return { [`${l.name}-layout.ts`]: moduleFile(l) };
+    },
+};
+//# sourceMappingURL=recipe.js.map

package/src/recipes/layout/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/recipes/layout/recipe.ts"],"names":[],"mappings":";;;AAaA,gDAMC;AAlBD,oDAAiD;AACjD,sDAAmE;AAWnE,SAAgB,kBAAkB,CAAC,KAAkB;;IACnD,MAAM,IAAI,GAAG,CAAA,MAAA,KAAK,CAAC,IAAI,0CAAE,IAAI,EAAE,KAAI,MAAM,CAAC;IAC1C,IAAI,CAAC,IAAA,kBAAS,EAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,sDAAsD,IAAI,IAAI,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAA,oBAAW,EAAC,IAAI,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,CAAiB;IACnC,OAAO,mEAAmE,CAAC,CAAC,YAAY;;;;;eAK3E,CAAC,CAAC,YAAY;;EAE3B,IAAA,6BAAa,EAAC,MAAM,CAAC;;;CAGtB,CAAC;AACF,CAAC;AAEY,QAAA,MAAM,GAAwB;IACzC,EAAE,EAAE,QAAQ;IACZ,KAAK,CAAC,KAAkB;QACtB,MAAM,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC;CACF,CAAC"}

package/src/recipes/settings-store/recipe.d.ts

@@ -0,0 +1,10 @@
+import { Recipe } from '../../lib/generate/types';
+export interface SettingsStoreInput {
+    readonly name: string;
+}
+export interface ResolvedSettingsStore {
+    readonly name: string;
+    readonly className: string;
+}
+export declare function resolveSettingsStoreInput(input: SettingsStoreInput): ResolvedSettingsStore;
+export declare const settingsStore: Recipe<SettingsStoreInput>;

package/src/recipes/settings-store/recipe.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingsStore = void 0;
+exports.resolveSettingsStoreInput = resolveSettingsStoreInput;
+const casing_1 = require("../../lib/generate/casing");
+function resolveSettingsStoreInput(input) {
+    if (!(0, casing_1.isKebabId)(input.name)) {
+        throw new Error(`Settings store name must be kebab-case (e.g. "backend"); got "${input.name}".`);
+    }
+    return { name: input.name, className: (0, casing_1.toPascalCase)(input.name) };
+}
+function moduleFile(s) {
+    return `// A backend-backed settings store for the SETTINGS_STORE port. The platform
+// ships local defaults; the product persists settings against its own backend. Only genuine
+// settings flow through this port — working state stays on WORKING_STATE_STORE. Wire it with:
+// provideSettingsStore(new ${s.className}SettingsStore()).
+import { KeyValueStore } from '@loomweaver/shell';
+
+export class ${s.className}SettingsStore implements KeyValueStore {
+  constructor(private readonly baseUrl = '/api/settings') {}
+
+  async get(key: string): Promise<string | undefined> {
+    const response = await fetch(this.url(key));
+    if (!response.ok) {
+      return undefined;
+    }
+    return response.text();
+  }
+
+  async set(key: string, value: string): Promise<void> {
+    await fetch(this.url(key), { method: 'PUT', body: value });
+  }
+
+  async delete(key: string): Promise<void> {
+    await fetch(this.url(key), { method: 'DELETE' });
+  }
+
+  private url(key: string): string {
+    return \`\${this.baseUrl}/\${encodeURIComponent(key)}\`;
+  }
+}
+`;
+}
+exports.settingsStore = {
+    id: 'settings-store',
+    build(input) {
+        const s = resolveSettingsStoreInput(input);
+        return { [`${s.name}-settings-store.ts`]: moduleFile(s) };
+    },
+};
+//# sourceMappingURL=recipe.js.map

package/src/recipes/settings-store/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/recipes/settings-store/recipe.ts"],"names":[],"mappings":";;;AAYA,8DASC;AApBD,sDAAoE;AAWpE,SAAgB,yBAAyB,CACvC,KAAyB;IAEzB,IAAI,CAAC,IAAA,kBAAS,EAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,iEAAiE,KAAK,CAAC,IAAI,IAAI,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAA,qBAAY,EAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,UAAU,CAAC,CAAwB;IAC1C,OAAO;;;8BAGqB,CAAC,CAAC,SAAS;;;eAG1B,CAAC,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;CAuBzB,CAAC;AACF,CAAC;AAEY,QAAA,aAAa,GAA+B;IACvD,EAAE,EAAE,gBAAgB;IACpB,KAAK,CAAC,KAAyB;QAC7B,MAAM,CAAC,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,oBAAoB,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,CAAC;CACF,CAAC"}

package/src/recipes/shell-regions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The base set of regions every scaffold agrees on. `primary` (rail) and `status-bar` (bar) are the
+ * defaults the weaver recipe targets, so a scaffolded weaver's contributions land somewhere the
+ * moment a scaffolded distribution boots. Emitted by both the layout recipe and the distribution's
+ * app.config, which is why it lives in one place: a region id that drifts here renders a
+ * contribution invisible rather than failing.
+ */
+export declare const SHELL_REGIONS: readonly string[];
+export declare function renderRegions(indent: string): string;

package/src/recipes/shell-regions.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHELL_REGIONS = void 0;
+exports.renderRegions = renderRegions;
+/**
+ * The base set of regions every scaffold agrees on. `primary` (rail) and `status-bar` (bar) are the
+ * defaults the weaver recipe targets, so a scaffolded weaver's contributions land somewhere the
+ * moment a scaffolded distribution boots. Emitted by both the layout recipe and the distribution's
+ * app.config, which is why it lives in one place: a region id that drifts here renders a
+ * contribution invisible rather than failing.
+ */
+exports.SHELL_REGIONS = [
+    "{ id: 'top-bar', type: 'bar', dock: 'top' }",
+    "{ id: 'primary', type: 'rail', dock: 'left' }",
+    "{ id: 'left-panel', type: 'panel', dock: 'left' }",
+    "{ id: 'right-panel', type: 'panel', dock: 'right' }",
+    "{ id: 'main', type: 'content', dock: 'center' }",
+    "{ id: 'status-bar', type: 'bar', dock: 'bottom' }",
+];
+function renderRegions(indent) {
+    return exports.SHELL_REGIONS.map((region) => `${indent}${region},`).join('\n');
+}
+//# sourceMappingURL=shell-regions.js.map

package/src/recipes/shell-regions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-regions.js","sourceRoot":"","sources":["../../../../../../libs/tooling/devkit/src/recipes/shell-regions.ts"],"names":[],"mappings":";;;AAgBA,sCAEC;AAlBD;;;;;;GAMG;AACU,QAAA,aAAa,GAAsB;IAC9C,6CAA6C;IAC7C,+CAA+C;IAC/C,mDAAmD;IACnD,qDAAqD;IACrD,iDAAiD;IACjD,mDAAmD;CACpD,CAAC;AAEF,SAAgB,aAAa,CAAC,MAAc;IAC1C,OAAO,qBAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC"}

package/src/recipes/theme/recipe.d.ts

@@ -0,0 +1,13 @@
+import { Recipe } from '../../lib/generate/types';
+export type ThemePreset = 'literal' | 'bootstrap';
+export interface ThemeInput {
+    readonly name: string;
+    readonly preset?: ThemePreset;
+}
+export interface ResolvedTheme {
+    readonly name: string;
+    readonly title: string;
+    readonly preset: ThemePreset;
+}
+export declare function resolveThemeInput(input: ThemeInput): ResolvedTheme;
+export declare const theme: Recipe<ThemeInput>;

package/src/recipes/theme/recipe.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.theme = void 0;
+exports.resolveThemeInput = resolveThemeInput;
+const casing_1 = require("../../lib/generate/casing");
+const PRESETS = ['literal', 'bootstrap'];
+function resolveThemeInput(input) {
+    var _a;
+    if (!(0, casing_1.isKebabId)(input.name)) {
+        throw new Error(`Theme name must be kebab-case (e.g. "midnight"); got "${input.name}".`);
+    }
+    const preset = (_a = input.preset) !== null && _a !== void 0 ? _a : 'literal';
+    if (!PRESETS.includes(preset)) {
+        throw new Error(`Unknown theme preset "${preset}"; expected one of ${PRESETS.join(', ')}.`);
+    }
+    return { name: input.name, title: (0, casing_1.toTitleCase)(input.name), preset };
+}
+function cssFile(t) {
+    return `/* ${t.title} theme — overrides LoomWeaver's --lw-* design tokens.
+   Import it AFTER the shell theme in your distribution styles.css:
+     @import '@loomweaver/shell/styles/theme.css';
+     @import './themes/${t.name}.css';
+   Declared in @layer lw-tenant-theme so it beats any plugin's ctx.contributeTheme
+   (Product default < Plugin < Tenant). The --lw-* ladder flips in :root.dark, so override both. */
+
+@layer lw-tenant-theme {
+  :root {
+    --lw-brand: #2e96c9;
+    --lw-brand-strong: #237aa6;
+    --lw-brand-fill: #2e96c9;
+    --lw-brand-text: #1f6f97;
+    --lw-accent: #c59a2f;
+    --lw-surface: #ffffff;
+    --lw-surface-raised: #f7f8fa;
+    --lw-content: #1f2937;
+    --lw-content-muted: #4b5563;
+    --lw-content-faint: #6b7280;
+    --lw-border: #e5e7eb;
+  }
+
+  :root.dark {
+    --lw-brand: #3aa9dd;
+    --lw-brand-strong: #2e96c9;
+    --lw-brand-fill: #2e96c9;
+    --lw-brand-text: #7cc4e6;
+    --lw-accent: #d8b45a;
+    --lw-surface: #0f141a;
+    --lw-surface-raised: #171d25;
+    --lw-content: #e5e7eb;
+    --lw-content-muted: #9ca3af;
+    --lw-content-faint: #6b7280;
+    --lw-border: #2a323c;
+  }
+}
+`;
+}
+function bootstrapFile(t) {
+    return `/* ${t.title} theme — maps LoomWeaver's --lw-* design tokens onto Bootstrap 5.3's --bs-*.
+   Import it AFTER the shell theme in your distribution styles.css, and import Bootstrap itself
+   INTO A LAYER — unlayered CSS outranks layered CSS whatever its specificity, so Bootstrap's
+   Reboot (button { border-radius: 0 }) would otherwise beat our .lw-* component classes:
+     @layer vendor;
+     @import 'bootstrap/dist/css/bootstrap.css' layer(vendor);
+     @import '@loomweaver/shell/styles/shell.css';   (or styles/theme.css if you run Tailwind)
+     @import './themes/${t.name}.css';
+   Declared in @layer lw-tenant-theme so it beats any plugin's ctx.contributeTheme
+   (Product default < Plugin < Tenant).
+
+   THERE IS NO :root.dark BLOCK, on purpose. Bootstrap redefines its own --bs-* variables under
+   [data-bs-theme="dark"], so every var() below already resolves to the dark value — provided that
+   attribute is in step with the shell's mode. Mirror it once at startup, from somewhere with an
+   injection context — your root component, or provideEnvironmentInitializer in app.config.ts:
+
+     private readonly theme = inject(ThemeService);        // from '@loomweaver/shell'
+     private readonly html = inject(DOCUMENT).documentElement;
+     constructor() {
+       effect(() => this.html.setAttribute('data-bs-theme', this.theme.resolvedTheme()));
+     }
+
+   Use resolvedTheme, never mode: mode can be 'system', which Bootstrap does not understand.
+
+   WHERE THIS MAPPING IS DELIBERATELY NOT ONE TO ONE: LoomWeaver splits a brand colour into the
+   identity colour, the colour it is safe to *read* as text, and the colour it is safe to *fill*
+   behind white text, because each clears a different WCAG threshold. Bootstrap 5.3 draws the same
+   distinction with -text-emphasis, so that is what the text tokens point at. The on-* tokens are
+   literal because they must contrast with the fill, not follow it, and they match what Bootstrap
+   itself puts on .btn-primary, .btn-warning and .btn-info.
+
+   CONTRAST IS YOURS NOW. LoomWeaver's own palette is verified against WCAG 2.1 AA. These values are
+   your Bootstrap theme's, so the guarantee travels with them: if your --bs-primary does not clear
+   4.5:1 behind white text, neither will our buttons. */
+
+@layer lw-tenant-theme {
+  :root {
+    --lw-brand: var(--bs-primary);
+    --lw-brand-strong: var(--bs-primary-text-emphasis);
+    --lw-brand-text: var(--bs-primary-text-emphasis);
+    --lw-brand-fill: var(--bs-primary);
+    --lw-on-brand: #fff;
+    --lw-accent: var(--bs-secondary);
+    --lw-accent-strong: var(--bs-secondary-text-emphasis);
+
+    --lw-surface: var(--bs-body-bg);
+    --lw-surface-raised: var(--bs-body-bg);
+    --lw-surface-overlay: var(--bs-tertiary-bg);
+    --lw-field: var(--bs-body-bg);
+    --lw-border: var(--bs-border-color);
+
+    --lw-content: var(--bs-body-color);
+    --lw-content-muted: var(--bs-secondary-color);
+    --lw-content-faint: var(--bs-secondary-color);
+
+    --lw-tooltip: var(--bs-emphasis-color);
+    --lw-tooltip-content: var(--bs-body-bg);
+
+    --lw-positive: var(--bs-success);
+    --lw-on-positive: #fff;
+    --lw-negative: var(--bs-danger);
+    --lw-negative-fill: var(--bs-danger);
+    --lw-on-negative: #fff;
+    --lw-caution: var(--bs-warning);
+    --lw-on-caution: #000;
+    --lw-info: var(--bs-info);
+    --lw-on-info: #000;
+
+    --lw-scrim: rgb(0 0 0 / 0.5);
+
+    --lw-font-sans: var(--bs-body-font-family);
+    --lw-font-mono: var(--bs-font-monospace);
+  }
+}
+`;
+}
+exports.theme = {
+    id: 'theme',
+    build(input) {
+        const t = resolveThemeInput(input);
+        const content = t.preset === 'bootstrap' ? bootstrapFile(t) : cssFile(t);
+        return { [`${t.name}.css`]: content };
+    },
+};
+//# sourceMappingURL=recipe.js.map

package/src/recipes/theme/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/recipes/theme/recipe.ts"],"names":[],"mappings":";;;AAkBA,8CASC;AA1BD,sDAAmE;AAenE,MAAM,OAAO,GAA2B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAEjE,SAAgB,iBAAiB,CAAC,KAAiB;;IACjD,IAAI,CAAC,IAAA,kBAAS,EAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,yDAAyD,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,MAAM,GAAG,MAAA,KAAK,CAAC,MAAM,mCAAI,SAAS,CAAC;IACzC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,sBAAsB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAA,oBAAW,EAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,OAAO,CAAC,CAAgB;IAC/B,OAAO,MAAM,CAAC,CAAC,KAAK;;;yBAGG,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC9B,CAAC;AACF,CAAC;AAED,SAAS,aAAa,CAAC,CAAgB;IACrC,OAAO,MAAM,CAAC,CAAC,KAAK;;;;;;;yBAOG,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmE9B,CAAC;AACF,CAAC;AAEY,QAAA,KAAK,GAAuB;IACvC,EAAE,EAAE,OAAO;IACX,KAAK,CAAC,KAAiB;QACrB,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACxC,CAAC;CACF,CAAC"}