@loomweaver/devkit 0.7.2

package/README.md

@@ -0,0 +1,127 @@
+# @loomweaver/devkit
+
+Dev-time scaffolding + validation for LoomWeaver. Not a runtime package — it is never
+imported by `@loomweaver/shell` or a weaver at runtime; it only generates and checks author code.
+
+Install it as a dev dependency of an Nx workspace:
+
+```sh
+npm i -D @loomweaver/devkit
+```
+
+It is the fullest of the three scaffolding adapters, because Nx hands it a virtual tree of your
+workspace: it is the only one that can also *change* files — register the project, add the tsconfig
+path alias. `@loomweaver/cli` writes files but knows no workspace; `@loomweaver/mcp` returns a file map and lets
+your assistant place it. All three read the same scaffold descriptors, so the generated source is
+identical.
+
+Placement is read from your workspace, not assumed: `--directory` (default `libs/<project name>`),
+`--import-path` (default: your root manifest's npm scope), `--app` (inferred when the workspace has
+exactly one application, an error naming the candidates when it has several), plus `--tags`,
+`--prefix` and `--unit-test-runner`.
+
+## Architecture
+
+- **Generation core** (`src/lib/generate`) — a pure `generate(recipe, input) → FileMap` (path →
+  content). No filesystem, no Nx, no framework: deterministic and unit-testable. This is the seam a
+  CLI or an MCP server wraps later.
+- **Recipes** (`src/recipes`) — templates + a typed input per target: `angular-weaver` (a trusted
+  in-process weaver) and `frame-plugin` (a framework-agnostic iframe/Penpal plugin — drop
+  any framework into `view.html`).
+- **Validation core** (`src/lib/validate`) — pure `validateManifest` / `validateI18nParity` /
+  `validateCatalog` returning MCP-shaped `Finding[]`. They cover the three places the platform
+  swallows a mistake on purpose: an ungranted capability, a missing translation key, and a plugin
+  store catalog, which the shell parses defensively — unknown fields, malformed values and whole
+  entries disappear without a word.
+- **Nx generator adapter** (`src/generators`) — writes a recipe's `FileMap` (plus the Nx project
+  files) into the workspace `Tree`.
+
+## Scaffold a weaver
+
+```sh
+nx g @loomweaver/devkit:weaver --id=notes --name="Notes"
+```
+
+Creates a weaver library at `libs/notes-weaver/` — a manifest, a routable surface, a rail item, i18n
+stubs and a test — plus the import alias under your workspace scope, and an assets glob on the
+composing application's build so the i18n bundle is served under `/i18n/<id>/`. The generated
+`README.md` explains how to wire it into a distribution (`providePlugins`,
+`provideCapabilityGrants`, `provideTranslationNamespaces`).
+
+Compose more contributions with flags — the generator assembles the `activate()` body, derives the
+required capabilities and adds the matching i18n keys:
+
+| Flag | Adds |
+| --- | --- |
+| `--command` | a registered command (with a keyboard shortcut) that toasts (→ capability `ui`) |
+| `--shortcut=<chord>` | override the command's chord, e.g. `mod+shift+k` (implies `--command`; `mod` = ⌘/Ctrl) |
+| `--menu=<slot>` | a menu item in the slot running the command (e.g. `content/tab/context`; implies `--command`) |
+| `--bar-item` | a status-bar button that triggers the command (implies `--command`) |
+| `--settings` | a settings section (toggle + text) with signal-backed value owners |
+| `--about` | an About dialog (reads `ctx.host` version) + a command + a bottom rail item (→ `ui`, `host`) |
+| `--instanceable` | named saved instances of the surface (switcher) |
+| `--access=<req>` | auth-gate the surface + rail: `authenticated`, `anonymous`, or `role:<name>` |
+| `--no-spec` | skip the generated starter unit test |
+
+```sh
+nx g @loomweaver/devkit:weaver --id=notes --command --menu=content/tab/context --settings --about --access=role:admin
+```
+
+Keyboard chords use the platform-neutral `mod` token (⌘ on macOS, Ctrl elsewhere); the host both
+binds and **displays** them per platform (`formatShortcut` → `⌘⇧K` vs `Ctrl+Shift+K`). A literal
+`cmd`/`ctrl` in `--shortcut` is rejected with an error pointing at `mod`.
+
+## Scaffold a frame plugin (any framework)
+
+```sh
+nx g @loomweaver/devkit:frame-plugin --id=notes --app=loom-testbed
+```
+
+Writes an iframe/Penpal plugin (`plugin.html`, `plugin.js`, `view.html`) into
+`apps/loom-testbed/public/notes/`. Replace `view.html` with any framework; the generated `README.md`
+covers registering it via `provideFramePlugins` and supplying `penpal.global.js`.
+
+## Scaffold a distribution
+
+```sh
+nx g @loomweaver/devkit:distribution --name=acme-studio --title="Acme Studio"
+nx g @loomweaver/devkit:distribution --name=acme-studio --styles=precompiled   # no Tailwind at all
+```
+
+Creates a runnable composition-root app at `apps/acme-studio/` (bootstraps the shell, stylesheet,
+PWA manifest, build/serve/lint/test). `nx serve acme-studio` renders the bare shell; the generated
+`LOOMWEAVER.md` shows how to add weavers, layout, capability grants and branding — it is named that
+so scaffolding over an existing app can never overwrite the app's own `README.md`.
+
+`--styles` decides how the app is styled. The default `tailwind` compiles the shell's source theme,
+which is also what lets you write Tailwind utilities of your own. `precompiled` imports the
+stylesheet we compiled instead — no `tailwindcss`, no `.postcssrc.json`, no `@source` paths — which
+is what you want if the product is themed with Bootstrap, Bulma or hand-written CSS.
+
+## Scaffold backend-integration ports
+
+The platform ships local/anonymous defaults; the product implements two frontend ports against its
+own backend. Scaffold either into a distribution's `src/`:
+
+```sh
+nx g @loomweaver/devkit:auth-source --name=dev --app=acme-studio       # provider-neutral AuthSource
+nx g @loomweaver/devkit:settings-store --name=backend --app=acme-studio # backend-backed settings store
+```
+
+Wire them in `app.config.ts` with `provideAuthSource(() => devAuthSource())` and
+`provideSettingsStore(new BackendSettingsStore())`.
+
+## Scaffold a theme + a layout
+
+```sh
+nx g @loomweaver/devkit:theme --name=midnight --app=acme-studio   # a token-override CSS (@import after ours)
+nx g @loomweaver/devkit:theme --name=acme --preset=bootstrap      # the same, mapped onto Bootstrap 5.3
+nx g @loomweaver/devkit:layout --app=acme-studio                  # a ShellLayout for provideLayout(baseLayout)
+```
+
+`--preset bootstrap` points all 29 `--lw-*` tokens at Bootstrap's `--bs-*` variables instead of
+emitting literal colours, so the shell follows your Bootstrap theme live — including its dark mode,
+provided you mirror `ThemeService.resolvedTheme()` onto `data-bs-theme`. The generated file says how.
+
+The layout's region ids (`primary` rail, `status` bar) match the weaver defaults, so a scaffolded
+weaver's rail + bar items land in it out of the box.

package/generators.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "../../node_modules/nx/schemas/collection.schema.json",
+  "name": "@loomweaver/devkit",
+  "generators": {
+    "weaver": {
+      "factory": "./src/generators/weaver/generator",
+      "schema": "./src/generators/weaver/schema.json",
+      "description": "Scaffold a LoomWeaver weaver (Angular plugin bundle)."
+    },
+    "frame-plugin": {
+      "factory": "./src/generators/frame-plugin/generator",
+      "schema": "./src/generators/frame-plugin/schema.json",
+      "description": "Scaffold a sandboxed, framework-agnostic (iframe) LoomWeaver plugin."
+    },
+    "distribution": {
+      "factory": "./src/generators/distribution/generator",
+      "schema": "./src/generators/distribution/schema.json",
+      "description": "Scaffold a LoomWeaver distribution (a composition-root Angular app)."
+    },
+    "auth-source": {
+      "factory": "./src/generators/auth-source/generator",
+      "schema": "./src/generators/auth-source/schema.json",
+      "description": "Scaffold a provider-neutral AuthSource."
+    },
+    "settings-store": {
+      "factory": "./src/generators/settings-store/generator",
+      "schema": "./src/generators/settings-store/schema.json",
+      "description": "Scaffold a backend-backed settings-store port implementation."
+    },
+    "theme": {
+      "factory": "./src/generators/theme/generator",
+      "schema": "./src/generators/theme/schema.json",
+      "description": "Scaffold a token-override theme (CSS) for a distribution."
+    },
+    "layout": {
+      "factory": "./src/generators/layout/generator",
+      "schema": "./src/generators/layout/schema.json",
+      "description": "Scaffold a distribution base layout (ShellLayout regions)."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@loomweaver/devkit",
+  "version": "0.7.2",
+  "description": "LoomWeaver scaffolding for Nx workspaces: generators for weavers, distributions, frame plugins and the integration seams, plus the manifest and i18n validators.",
+  "keywords": [
+    "loomweaver",
+    "nx",
+    "nx-plugin",
+    "generator",
+    "scaffolding",
+    "angular",
+    "plugin-platform"
+  ],
+  "license": "Apache-2.0",
+  "author": "Norbert Rosenwinkel (https://loomweaver.dev)",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "generators": "./generators.json",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@nx/devkit": ">=23.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://loomweaver.dev",
+  "bugs": {
+    "url": "https://github.com/yesbert/loomweaver/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yesbert/loomweaver.git",
+    "directory": "platform/libs/tooling/devkit"
+  },
+  "type": "commonjs"
+}

package/src/generators/auth-source/generator.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import { AuthSourceGeneratorSchema } from './schema';
+export declare function authSourceGenerator(tree: Tree, options: AuthSourceGeneratorSchema): Promise<void>;
+export default authSourceGenerator;

package/src/generators/auth-source/generator.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authSourceGenerator = authSourceGenerator;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const generate_1 = require("../../lib/generate/generate");
+const recipe_1 = require("../../recipes/auth-source/recipe");
+const shared_1 = require("../shared");
+function authSourceGenerator(tree, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const root = `${(0, shared_1.resolveApp)(tree, options.app).root}/src/auth`;
+        (0, shared_1.writeFilesGuarded)(tree, root, (0, generate_1.generate)(recipe_1.authSource, { name: options.name }));
+        yield (0, devkit_1.formatFiles)(tree);
+    });
+}
+exports.default = authSourceGenerator;
+//# sourceMappingURL=generator.js.map

package/src/generators/auth-source/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/generators/auth-source/generator.ts"],"names":[],"mappings":";;AAMA,kDAOC;;AAbD,uCAA+C;AAC/C,0DAAuD;AACvD,6DAA8D;AAC9D,sCAA0D;AAG1D,SAAsB,mBAAmB,CACvC,IAAU,EACV,OAAkC;;QAElC,MAAM,IAAI,GAAG,GAAG,IAAA,mBAAU,EAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC;QAC9D,IAAA,0BAAiB,EAAC,IAAI,EAAE,IAAI,EAAE,IAAA,mBAAQ,EAAC,mBAAU,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5E,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA;AAED,kBAAe,mBAAmB,CAAC"}

package/src/generators/auth-source/schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "LoomWeaverAuthSource",
+  "title": "Scaffold a provider-neutral AuthSource that feeds the session",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Source name in kebab-case, e.g. 'dev'.",
+      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
+    },
+    "app": {
+      "type": "string",
+      "description": "Application to drop into. Inferred when the workspace has exactly one."
+    }
+  },
+  "required": ["name"]
+}

package/src/generators/distribution/generator.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import { DistributionGeneratorSchema } from './schema';
+export declare function distributionGenerator(tree: Tree, options: DistributionGeneratorSchema): Promise<void>;
+export default distributionGenerator;

package/src/generators/distribution/generator.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distributionGenerator = distributionGenerator;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const generate_1 = require("../../lib/generate/generate");
+const shared_1 = require("../shared");
+const recipe_1 = require("../../recipes/angular-distribution/recipe");
+const nx_files_1 = require("./nx-files");
+function distributionGenerator(tree, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const distribution = (0, nx_files_1.nxDistribution)({
+            name: options.name,
+            directory: options.directory,
+            tags: (_a = options.tags) === null || _a === void 0 ? void 0 : _a.split(',').map((tag) => tag.trim()),
+            prefix: options.prefix,
+            baseTsconfig: (0, shared_1.tsconfigPathsFile)(tree),
+            withTests: options.unitTestRunner !== 'none',
+        });
+        const projectFile = `${distribution.projectRoot}/project.json`;
+        const composingIntoExisting = tree.exists(projectFile);
+        if (composingIntoExisting) {
+            if (!options.force) {
+                throw new Error(`A project already exists at ${distribution.projectRoot}. Pass --force to compose the ` +
+                    'distribution into it, replacing the bootstrap files this scaffold owns.');
+            }
+            const occupantName = (0, devkit_1.readJson)(tree, projectFile).name;
+            if (typeof occupantName === 'string' && occupantName !== options.name) {
+                throw new Error(`The project at ${distribution.projectRoot} is named "${occupantName}", not "${options.name}". ` +
+                    'Renaming it here would break every reference to it in the workspace — pass ' +
+                    `--name ${occupantName}.`);
+            }
+        }
+        const source = (0, generate_1.generate)(recipe_1.angularDistribution, {
+            name: options.name,
+            title: options.title,
+            directory: distribution.projectRoot,
+            withTests: distribution.withTests,
+            styles: options.styles,
+        });
+        const scaffold = (0, nx_files_1.nxDistributionFiles)(distribution);
+        if (composingIntoExisting) {
+            const { 'project.json': ours } = scaffold, rest = tslib_1.__rest(scaffold, ['project.json']);
+            (0, shared_1.writeFiles)(tree, distribution.projectRoot, source, rest);
+            mergeProjectJson(tree, projectFile, JSON.parse(ours));
+        }
+        else {
+            (0, shared_1.writeFiles)(tree, distribution.projectRoot, source, scaffold);
+        }
+        yield (0, devkit_1.formatFiles)(tree);
+    });
+}
+function mergeProjectJson(tree, projectFile, ours) {
+    (0, devkit_1.updateJson)(tree, projectFile, (existing) => {
+        var _a, _b;
+        return (Object.assign(Object.assign(Object.assign({}, existing), ours), { tags: ((_a = ours.tags) === null || _a === void 0 ? void 0 : _a.length) ? ours.tags : ((_b = existing.tags) !== null && _b !== void 0 ? _b : []), targets: Object.assign(Object.assign({}, existing.targets), ours.targets) }));
+    });
+}
+exports.default = distributionGenerator;
+//# sourceMappingURL=generator.js.map

package/src/generators/distribution/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/generators/distribution/generator.ts"],"names":[],"mappings":"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"}

package/src/generators/distribution/nx-files.d.ts

@@ -0,0 +1,22 @@
+import { FileMap } from '../../lib/generate/types';
+import { NxScaffoldDepth } from '../nx-scaffold-shared';
+export interface NxDistributionOptions {
+    readonly name: string;
+    readonly directory?: string;
+    readonly tags?: readonly string[];
+    readonly prefix?: string;
+    readonly baseTsconfig?: string;
+    readonly withTests?: boolean;
+}
+export interface NxDistribution {
+    readonly name: string;
+    readonly projectRoot: string;
+    readonly outputPath: string;
+    readonly tags: readonly string[];
+    readonly prefix: string;
+    readonly baseTsconfig: string;
+    readonly withTests: boolean;
+    readonly depth: NxScaffoldDepth;
+}
+export declare function nxDistribution(options: NxDistributionOptions): NxDistribution;
+export declare function nxDistributionFiles(d: NxDistribution): FileMap;

package/src/generators/distribution/nx-files.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nxDistribution = nxDistribution;
+exports.nxDistributionFiles = nxDistributionFiles;
+const nx_scaffold_shared_1 = require("../nx-scaffold-shared");
+function nxDistribution(options) {
+    var _a, _b, _c, _d, _e;
+    const projectRoot = (_a = options.directory) !== null && _a !== void 0 ? _a : `apps/${options.name}`;
+    return {
+        name: options.name,
+        projectRoot,
+        outputPath: `dist/${projectRoot}`,
+        tags: (_b = options.tags) !== null && _b !== void 0 ? _b : [],
+        prefix: (_c = options.prefix) !== null && _c !== void 0 ? _c : 'lw',
+        baseTsconfig: (_d = options.baseTsconfig) !== null && _d !== void 0 ? _d : 'tsconfig.base.json',
+        withTests: (_e = options.withTests) !== null && _e !== void 0 ? _e : true,
+        depth: (0, nx_scaffold_shared_1.depthFor)(projectRoot),
+    };
+}
+function projectJson(d) {
+    const root = d.projectRoot;
+    return JSON.stringify({
+        name: d.name,
+        $schema: `${d.depth.toRoot}/node_modules/nx/schemas/project-schema.json`,
+        projectType: 'application',
+        prefix: d.prefix,
+        sourceRoot: `${root}/src`,
+        tags: d.tags,
+        targets: Object.assign(Object.assign({ build: {
+                executor: '@angular/build:application',
+                outputs: ['{options.outputPath}'],
+                defaultConfiguration: 'production',
+                options: {
+                    outputPath: d.outputPath,
+                    browser: `${root}/src/main.ts`,
+                    tsConfig: `${root}/tsconfig.app.json`,
+                    serviceWorker: `${root}/ngsw-config.json`,
+                    assets: [
+                        { glob: '**/*', input: `${root}/public` },
+                        {
+                            glob: '**/*',
+                            input: 'node_modules/@loomweaver/shell/i18n',
+                            output: 'i18n',
+                        },
+                        {
+                            glob: '**/*',
+                            input: 'node_modules/@loomweaver/frame-kit/dist',
+                            output: 'frame-kit',
+                        },
+                    ],
+                    styles: [`${root}/src/styles.css`],
+                },
+                configurations: {
+                    production: {
+                        budgets: [
+                            {
+                                type: 'initial',
+                                maximumWarning: '500kb',
+                                maximumError: '1mb',
+                            },
+                            {
+                                type: 'anyComponentStyle',
+                                maximumWarning: '4kb',
+                                maximumError: '8kb',
+                            },
+                        ],
+                        outputHashing: 'all',
+                        optimization: {
+                            scripts: true,
+                            fonts: true,
+                            styles: { minify: true, inlineCritical: false },
+                        },
+                    },
+                    development: {
+                        optimization: false,
+                        extractLicenses: false,
+                        sourceMap: true,
+                    },
+                },
+            }, serve: {
+                continuous: true,
+                executor: '@angular/build:dev-server',
+                defaultConfiguration: 'development',
+                configurations: {
+                    production: { buildTarget: `${d.name}:build:production` },
+                    development: { buildTarget: `${d.name}:build:development` },
+                },
+            }, lint: { executor: '@nx/eslint:lint' } }, (d.withTests
+            ? {
+                test: {
+                    executor: '@nx/angular:unit-test',
+                    outputs: ['{workspaceRoot}/coverage/{projectName}'],
+                    options: { watch: false },
+                },
+            }
+            : {})), { 'serve-static': {
+                continuous: true,
+                executor: '@nx/web:file-server',
+                options: {
+                    buildTarget: `${d.name}:build`,
+                    staticFilePath: `${d.outputPath}/browser`,
+                    spa: true,
+                },
+            } }),
+    }, null, 2);
+}
+function tsconfig(d) {
+    return JSON.stringify({
+        extends: `${d.depth.toRoot}/${d.baseTsconfig}`,
+        compilerOptions: nx_scaffold_shared_1.SHARED_COMPILER_OPTIONS,
+        angularCompilerOptions: nx_scaffold_shared_1.SHARED_ANGULAR_COMPILER_OPTIONS,
+        files: [],
+        include: [],
+        references: [
+            { path: './tsconfig.app.json' },
+            ...(d.withTests ? [{ path: './tsconfig.spec.json' }] : []),
+        ],
+    }, null, 2);
+}
+function tsconfigApp(d) {
+    return JSON.stringify({
+        extends: './tsconfig.json',
+        compilerOptions: { outDir: `${d.depth.toRoot}/dist/out-tsc`, types: [] },
+        include: ['src/**/*.ts'],
+        exclude: ['src/**/*.spec.ts', 'src/**/*.test.ts'],
+    }, null, 2);
+}
+function nxDistributionFiles(d) {
+    return Object.assign(Object.assign({ 'project.json': projectJson(d) + '\n', 'tsconfig.json': tsconfig(d) + '\n', 'tsconfig.app.json': tsconfigApp(d) + '\n' }, (d.withTests
+        ? { 'tsconfig.spec.json': (0, nx_scaffold_shared_1.sharedTsconfigSpec)(d.depth) + '\n' }
+        : {})), { 'eslint.config.mjs': (0, nx_scaffold_shared_1.sharedEslintConfig)(d.depth, [d.prefix, 'app']) });
+}
+//# sourceMappingURL=nx-files.js.map

package/src/generators/distribution/nx-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nx-files.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/generators/distribution/nx-files.ts"],"names":[],"mappings":"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"}

package/src/generators/distribution/schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "LoomWeaverDistribution",
+  "title": "Scaffold a runnable composition root that boots the shell",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Distribution name in kebab-case, e.g. 'acme-studio'.",
+      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
+    },
+    "title": {
+      "type": "string",
+      "description": "Product display title. Defaults to a title-cased name."
+    },
+    "styles": {
+      "type": "string",
+      "description": "Which stylesheet to emit. 'tailwind' compiles the shell's source theme and lets you write Tailwind utilities of your own; 'precompiled' imports the stylesheet we compiled, so the application needs no Tailwind and can be themed with Bootstrap or anything else.",
+      "enum": ["tailwind", "precompiled"],
+      "default": "tailwind"
+    },
+    "force": {
+      "type": "boolean",
+      "description": "Compose into the application already at that path, replacing the bootstrap files this scaffold owns and merging its build targets. Without it an existing project is an error."
+    },
+    "directory": {
+      "type": "string",
+      "description": "Project root, relative to the workspace root."
+    },
+    "tags": {
+      "type": "string",
+      "description": "Comma-separated Nx tags for the project."
+    },
+    "prefix": {
+      "type": "string",
+      "description": "Selector prefix for generated components and directives.",
+      "default": "lw",
+      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
+    },
+    "unitTestRunner": {
+      "type": "string",
+      "description": "Test wiring to emit. 'vitest' uses @nx/angular:unit-test; 'none' emits no test target.",
+      "enum": ["vitest", "none"],
+      "default": "vitest"
+    }
+  },
+  "required": ["name"]
+}

package/src/generators/frame-plugin/generator.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import { SandboxPluginGeneratorSchema } from './schema';
+export declare function framePluginGenerator(tree: Tree, options: SandboxPluginGeneratorSchema): Promise<void>;
+export default framePluginGenerator;

package/src/generators/frame-plugin/generator.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.framePluginGenerator = framePluginGenerator;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const generate_1 = require("../../lib/generate/generate");
+const recipe_1 = require("../../recipes/frame-plugin/recipe");
+const shared_1 = require("../shared");
+function framePluginGenerator(tree, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const root = `${(0, shared_1.resolveApp)(tree, options.app).root}/public/${options.id}`;
+        if (tree.exists(`${root}/plugin.html`)) {
+            throw new Error(`A frame plugin already exists at ${root}.`);
+        }
+        (0, shared_1.writeFiles)(tree, root, (0, generate_1.generate)(recipe_1.framePlugin, { id: options.id, name: options.name }));
+        yield (0, devkit_1.formatFiles)(tree);
+    });
+}
+exports.default = framePluginGenerator;
+//# sourceMappingURL=generator.js.map

package/src/generators/frame-plugin/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/generators/frame-plugin/generator.ts"],"names":[],"mappings":";;AAMA,oDAgBC;;AAtBD,uCAA+C;AAC/C,0DAAuD;AACvD,8DAAgE;AAChE,sCAAmD;AAGnD,SAAsB,oBAAoB,CACxC,IAAU,EACV,OAAqC;;QAErC,MAAM,IAAI,GAAG,GAAG,IAAA,mBAAU,EAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,WAAW,OAAO,CAAC,EAAE,EAAE,CAAC;QAC1E,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,GAAG,CAAC,CAAC;QAC/D,CAAC;QAED,IAAA,mBAAU,EACR,IAAI,EACJ,IAAI,EACJ,IAAA,mBAAQ,EAAC,oBAAW,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAC9D,CAAC;QAEF,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA;AAED,kBAAe,oBAAoB,CAAC"}

package/src/generators/frame-plugin/schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "LoomWeaverFramePlugin",
+  "title": "Scaffold a framework-agnostic iframe plugin (Penpal + the frame UI kit)",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Plugin id in kebab-case, e.g. 'notes'.",
+      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable name. Defaults to a title-cased id."
+    },
+    "app": {
+      "type": "string",
+      "description": "Application to drop into. Inferred when the workspace has exactly one."
+    }
+  },
+  "required": ["id"]
+}

package/src/generators/layout/generator.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import { LayoutGeneratorSchema } from './schema';
+export declare function layoutGenerator(tree: Tree, options: LayoutGeneratorSchema): Promise<void>;
+export default layoutGenerator;

package/src/generators/layout/generator.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.layoutGenerator = layoutGenerator;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const generate_1 = require("../../lib/generate/generate");
+const recipe_1 = require("../../recipes/layout/recipe");
+const shared_1 = require("../shared");
+function layoutGenerator(tree, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const root = `${(0, shared_1.resolveApp)(tree, options.app).root}/src`;
+        (0, shared_1.writeFilesGuarded)(tree, root, (0, generate_1.generate)(recipe_1.layout, { name: options.name }));
+        yield (0, devkit_1.formatFiles)(tree);
+    });
+}
+exports.default = layoutGenerator;
+//# sourceMappingURL=generator.js.map

package/src/generators/layout/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/generators/layout/generator.ts"],"names":[],"mappings":";;AAMA,0CAOC;;AAbD,uCAA+C;AAC/C,0DAAuD;AACvD,wDAAqD;AACrD,sCAA0D;AAG1D,SAAsB,eAAe,CACnC,IAAU,EACV,OAA8B;;QAE9B,MAAM,IAAI,GAAG,GAAG,IAAA,mBAAU,EAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC;QACzD,IAAA,0BAAiB,EAAC,IAAI,EAAE,IAAI,EAAE,IAAA,mBAAQ,EAAC,eAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA;AAED,kBAAe,eAAe,CAAC"}

package/src/generators/layout/schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "LoomWeaverLayout",
+  "title": "Scaffold a ShellLayout with the regions a weaver expects",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Layout name. Defaults to a base layout."
+    },
+    "app": {
+      "type": "string",
+      "description": "Application to drop into. Inferred when the workspace has exactly one."
+    }
+  },
+  "required": []
+}