@loomweaver/devkit 0.7.2

package/src/generators/weaver/schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "LoomWeaverWeaver",
+  "title": "Scaffold an Angular in-process plugin: manifest, surface, rail item, i18n, test",
+  "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."
+    },
+    "command": {
+      "type": "boolean",
+      "description": "Also scaffold a registered command the weaver can trigger.",
+      "default": false
+    },
+    "shortcut": {
+      "type": "string",
+      "description": "Keyboard chord for the command, e.g. 'mod+shift+k'. Implies --command."
+    },
+    "menu": {
+      "type": "string",
+      "description": "Hook a menu item into a slot, e.g. 'content/tab/context'. Implies --command."
+    },
+    "barItem": {
+      "type": "boolean",
+      "description": "Also add a status-bar button that triggers the command. Implies --command.",
+      "default": false
+    },
+    "settings": {
+      "type": "boolean",
+      "description": "Also scaffold a settings section with signal-backed value owners.",
+      "default": false
+    },
+    "about": {
+      "type": "boolean",
+      "description": "Also scaffold an About dialog that reads ctx.host, plus a bottom rail item.",
+      "default": false
+    },
+    "instanceable": {
+      "type": "boolean",
+      "description": "Dock the surface and give it named saved instances, each with its own view state. Not combinable with --container: named instances exist only for a docked, non-routable surface.",
+      "default": false
+    },
+    "container": {
+      "type": "boolean",
+      "description": "Make the surface a container: a routable tab at '<id>/:id' holding a nested pane tree of child surfaces, which the host draws. Not combinable with --instanceable.",
+      "default": false
+    },
+    "access": {
+      "type": "string",
+      "description": "Auth-gate the surface and rail item: 'authenticated', 'anonymous' or 'role:<name>'."
+    },
+    "spec": {
+      "type": "boolean",
+      "description": "Generate a starter unit test. Use --no-spec to skip it.",
+      "default": true
+    },
+    "projectName": {
+      "type": "string",
+      "description": "Nx project name. Defaults to '<id>-weaver'."
+    },
+    "importPath": {
+      "type": "string",
+      "description": "Import path for the workspace alias. Defaults to the workspace scope plus the project name."
+    },
+    "app": {
+      "type": "string",
+      "description": "Application to drop into. Inferred when the workspace has exactly one."
+    },
+    "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": ["id"]
+}

package/src/index.d.ts

@@ -0,0 +1,15 @@
+export type { FileMap, Recipe } from './lib/generate/types';
+export { generate } from './lib/generate/generate';
+export { isKebabId, toCamelCase, toPascalCase, toTitleCase } from './lib/generate/casing';
+export { angularWeaver, resolveWeaverInput, type WeaverInput, type ResolvedWeaver, } from './recipes/angular-weaver/recipe';
+export { framePlugin, resolveFramePluginInput, type FramePluginInput, type ResolvedFramePlugin, } from './recipes/frame-plugin/recipe';
+export { angularDistribution, resolveDistributionInput, type DistributionInput, type ResolvedDistribution, } from './recipes/angular-distribution/recipe';
+export { authSource, resolveAuthSourceInput, type AuthSourceInput, type ResolvedAuthSource, } from './recipes/auth-source/recipe';
+export { settingsStore, resolveSettingsStoreInput, type SettingsStoreInput, type ResolvedSettingsStore, } from './recipes/settings-store/recipe';
+export { theme, resolveThemeInput, type ThemeInput, type ResolvedTheme } from './recipes/theme/recipe';
+export { layout, resolveLayoutInput, type LayoutInput, type ResolvedLayout, } from './recipes/layout/recipe';
+export { SCAFFOLDS, findScaffold, kebabCase, nxSchemaFor, portableOptions, usageFor, type ScaffoldDescriptor, type ScaffoldOption, type ScaffoldValues, } from './lib/scaffolds/scaffolds';
+export type { Finding, FindingLevel } from './lib/validate/types';
+export { validateManifest, KNOWN_CAPABILITIES, type ManifestLike } from './lib/validate/manifest';
+export { validateI18nParity, type I18nBundle } from './lib/validate/i18n';
+export { validateCatalog, CATALOG_ENTRY_KEYS } from './lib/validate/catalog';

package/src/index.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CATALOG_ENTRY_KEYS = exports.validateCatalog = exports.validateI18nParity = exports.KNOWN_CAPABILITIES = exports.validateManifest = exports.usageFor = exports.portableOptions = exports.nxSchemaFor = exports.kebabCase = exports.findScaffold = exports.SCAFFOLDS = exports.resolveLayoutInput = exports.layout = exports.resolveThemeInput = exports.theme = exports.resolveSettingsStoreInput = exports.settingsStore = exports.resolveAuthSourceInput = exports.authSource = exports.resolveDistributionInput = exports.angularDistribution = exports.resolveFramePluginInput = exports.framePlugin = exports.resolveWeaverInput = exports.angularWeaver = exports.toTitleCase = exports.toPascalCase = exports.toCamelCase = exports.isKebabId = exports.generate = void 0;
+var generate_1 = require("./lib/generate/generate");
+Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return generate_1.generate; } });
+var casing_1 = require("./lib/generate/casing");
+Object.defineProperty(exports, "isKebabId", { enumerable: true, get: function () { return casing_1.isKebabId; } });
+Object.defineProperty(exports, "toCamelCase", { enumerable: true, get: function () { return casing_1.toCamelCase; } });
+Object.defineProperty(exports, "toPascalCase", { enumerable: true, get: function () { return casing_1.toPascalCase; } });
+Object.defineProperty(exports, "toTitleCase", { enumerable: true, get: function () { return casing_1.toTitleCase; } });
+var recipe_1 = require("./recipes/angular-weaver/recipe");
+Object.defineProperty(exports, "angularWeaver", { enumerable: true, get: function () { return recipe_1.angularWeaver; } });
+Object.defineProperty(exports, "resolveWeaverInput", { enumerable: true, get: function () { return recipe_1.resolveWeaverInput; } });
+var recipe_2 = require("./recipes/frame-plugin/recipe");
+Object.defineProperty(exports, "framePlugin", { enumerable: true, get: function () { return recipe_2.framePlugin; } });
+Object.defineProperty(exports, "resolveFramePluginInput", { enumerable: true, get: function () { return recipe_2.resolveFramePluginInput; } });
+var recipe_3 = require("./recipes/angular-distribution/recipe");
+Object.defineProperty(exports, "angularDistribution", { enumerable: true, get: function () { return recipe_3.angularDistribution; } });
+Object.defineProperty(exports, "resolveDistributionInput", { enumerable: true, get: function () { return recipe_3.resolveDistributionInput; } });
+var recipe_4 = require("./recipes/auth-source/recipe");
+Object.defineProperty(exports, "authSource", { enumerable: true, get: function () { return recipe_4.authSource; } });
+Object.defineProperty(exports, "resolveAuthSourceInput", { enumerable: true, get: function () { return recipe_4.resolveAuthSourceInput; } });
+var recipe_5 = require("./recipes/settings-store/recipe");
+Object.defineProperty(exports, "settingsStore", { enumerable: true, get: function () { return recipe_5.settingsStore; } });
+Object.defineProperty(exports, "resolveSettingsStoreInput", { enumerable: true, get: function () { return recipe_5.resolveSettingsStoreInput; } });
+var recipe_6 = require("./recipes/theme/recipe");
+Object.defineProperty(exports, "theme", { enumerable: true, get: function () { return recipe_6.theme; } });
+Object.defineProperty(exports, "resolveThemeInput", { enumerable: true, get: function () { return recipe_6.resolveThemeInput; } });
+var recipe_7 = require("./recipes/layout/recipe");
+Object.defineProperty(exports, "layout", { enumerable: true, get: function () { return recipe_7.layout; } });
+Object.defineProperty(exports, "resolveLayoutInput", { enumerable: true, get: function () { return recipe_7.resolveLayoutInput; } });
+var scaffolds_1 = require("./lib/scaffolds/scaffolds");
+Object.defineProperty(exports, "SCAFFOLDS", { enumerable: true, get: function () { return scaffolds_1.SCAFFOLDS; } });
+Object.defineProperty(exports, "findScaffold", { enumerable: true, get: function () { return scaffolds_1.findScaffold; } });
+Object.defineProperty(exports, "kebabCase", { enumerable: true, get: function () { return scaffolds_1.kebabCase; } });
+Object.defineProperty(exports, "nxSchemaFor", { enumerable: true, get: function () { return scaffolds_1.nxSchemaFor; } });
+Object.defineProperty(exports, "portableOptions", { enumerable: true, get: function () { return scaffolds_1.portableOptions; } });
+Object.defineProperty(exports, "usageFor", { enumerable: true, get: function () { return scaffolds_1.usageFor; } });
+var manifest_1 = require("./lib/validate/manifest");
+Object.defineProperty(exports, "validateManifest", { enumerable: true, get: function () { return manifest_1.validateManifest; } });
+Object.defineProperty(exports, "KNOWN_CAPABILITIES", { enumerable: true, get: function () { return manifest_1.KNOWN_CAPABILITIES; } });
+var i18n_1 = require("./lib/validate/i18n");
+Object.defineProperty(exports, "validateI18nParity", { enumerable: true, get: function () { return i18n_1.validateI18nParity; } });
+var catalog_1 = require("./lib/validate/catalog");
+Object.defineProperty(exports, "validateCatalog", { enumerable: true, get: function () { return catalog_1.validateCatalog; } });
+Object.defineProperty(exports, "CATALOG_ENTRY_KEYS", { enumerable: true, get: function () { return catalog_1.CATALOG_ENTRY_KEYS; } });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/tooling/devkit/src/index.ts"],"names":[],"mappings":";;;AACA,oDAAmD;AAA1C,oGAAA,QAAQ,OAAA;AACjB,gDAA0F;AAAjF,mGAAA,SAAS,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA;AAC1D,0DAKyC;AAJvC,uGAAA,aAAa,OAAA;AACb,4GAAA,kBAAkB,OAAA;AAIpB,wDAKuC;AAJrC,qGAAA,WAAW,OAAA;AACX,iHAAA,uBAAuB,OAAA;AAIzB,gEAK+C;AAJ7C,6GAAA,mBAAmB,OAAA;AACnB,kHAAA,wBAAwB,OAAA;AAI1B,uDAKsC;AAJpC,oGAAA,UAAU,OAAA;AACV,gHAAA,sBAAsB,OAAA;AAIxB,0DAKyC;AAJvC,uGAAA,aAAa,OAAA;AACb,mHAAA,yBAAyB,OAAA;AAI3B,iDAAuG;AAA9F,+FAAA,KAAK,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AACjC,kDAKiC;AAJ/B,gGAAA,MAAM,OAAA;AACN,4GAAA,kBAAkB,OAAA;AAIpB,uDAUmC;AATjC,sGAAA,SAAS,OAAA;AACT,yGAAA,YAAY,OAAA;AACZ,sGAAA,SAAS,OAAA;AACT,wGAAA,WAAW,OAAA;AACX,4GAAA,eAAe,OAAA;AACf,qGAAA,QAAQ,OAAA;AAMV,oDAAkG;AAAzF,4GAAA,gBAAgB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAC7C,4CAA0E;AAAjE,0GAAA,kBAAkB,OAAA;AAC3B,kDAA6E;AAApE,0GAAA,eAAe,OAAA;AAAE,6GAAA,kBAAkB,OAAA"}

package/src/lib/generate/casing.d.ts

@@ -0,0 +1,4 @@
+export declare function isKebabId(value: string): boolean;
+export declare function toPascalCase(value: string): string;
+export declare function toCamelCase(value: string): string;
+export declare function toTitleCase(value: string): string;

package/src/lib/generate/casing.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isKebabId = isKebabId;
+exports.toPascalCase = toPascalCase;
+exports.toCamelCase = toCamelCase;
+exports.toTitleCase = toTitleCase;
+function isKebabId(value) {
+    return /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(value);
+}
+function words(value) {
+    return value.split(/[-_\s]+/).filter(Boolean);
+}
+function toPascalCase(value) {
+    return words(value)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+function toCamelCase(value) {
+    const pascal = toPascalCase(value);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+function toTitleCase(value) {
+    return words(value)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=casing.js.map

package/src/lib/generate/casing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"casing.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/lib/generate/casing.ts"],"names":[],"mappings":";;AAAA,8BAEC;AAMD,oCAIC;AAED,kCAGC;AAED,kCAIC;AAvBD,SAAgB,SAAS,CAAC,KAAa;IACrC,OAAO,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,KAAK,CAAC;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa;IACvC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,KAAK,CAAC;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/src/lib/generate/generate.d.ts

@@ -0,0 +1,2 @@
+import { FileMap, Recipe } from './types';
+export declare function generate<Input>(recipe: Recipe<Input>, input: Input): FileMap;

package/src/lib/generate/generate.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generate = generate;
+function isUnsafePath(path) {
+    return (path.length === 0 ||
+        path.startsWith('/') ||
+        path.includes('\\') ||
+        path.split('/').includes('..'));
+}
+function generate(recipe, input) {
+    const files = recipe.build(input);
+    const unsafe = Object.keys(files).find(isUnsafePath);
+    if (unsafe !== undefined) {
+        throw new Error(`Recipe "${recipe.id}" produced an unsafe path: "${unsafe}".`);
+    }
+    return files;
+}
+//# sourceMappingURL=generate.js.map

package/src/lib/generate/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/lib/generate/generate.ts"],"names":[],"mappings":";;AAWA,4BAOC;AAhBD,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,CACL,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED,SAAgB,QAAQ,CAAQ,MAAqB,EAAE,KAAY;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,EAAE,+BAA+B,MAAM,IAAI,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/src/lib/generate/types.d.ts

@@ -0,0 +1,5 @@
+export type FileMap = Readonly<Record<string, string>>;
+export interface Recipe<Input> {
+    readonly id: string;
+    build(input: Input): FileMap;
+}

package/src/lib/generate/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/src/lib/generate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/lib/generate/types.ts"],"names":[],"mappings":""}

package/src/lib/scaffolds/scaffolds.d.ts

@@ -0,0 +1,37 @@
+import { FileMap } from '../generate/types';
+export type ScaffoldValues = Readonly<Record<string, string | boolean | undefined>>;
+export interface ScaffoldOption {
+    readonly name: string;
+    readonly type: 'string' | 'boolean';
+    readonly description: string;
+    readonly required?: boolean;
+    readonly default?: string | boolean;
+    readonly choices?: readonly string[];
+    readonly pattern?: string;
+    /**
+     * True for options that describe a place in an Nx workspace. An adapter that only returns or
+     * writes a file map has nowhere to put them, so it leaves them out of its surface.
+     */
+    readonly workspaceOnly?: boolean;
+}
+export interface ScaffoldDescriptor {
+    readonly name: string;
+    readonly summary: string;
+    readonly options: readonly ScaffoldOption[];
+    build(values: ScaffoldValues): FileMap;
+}
+export declare function str(values: ScaffoldValues, name: string): string | undefined;
+export declare function bool(values: ScaffoldValues, name: string): boolean | undefined;
+/** The kebab-case spelling of a camelCase option, for command lines that prefer it. */
+export declare function kebabCase(name: string): string;
+export declare const SCAFFOLDS: readonly ScaffoldDescriptor[];
+export declare function findScaffold(name: string): ScaffoldDescriptor | undefined;
+/** The option surface an adapter that only produces files can offer. */
+export declare function portableOptions(scaffold: ScaffoldDescriptor): readonly ScaffoldOption[];
+/**
+ * The JSON Schema an Nx generator loads. Nx reads it from disk before any of our code runs, so the
+ * file cannot be computed at call time — instead it is checked against this shape by a test, which
+ * fails the moment the two drift apart.
+ */
+export declare function nxSchemaFor(scaffold: ScaffoldDescriptor): Record<string, unknown>;
+export declare function usageFor(scaffold: ScaffoldDescriptor): string;

package/src/lib/scaffolds/scaffolds.js

@@ -0,0 +1,357 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCAFFOLDS = void 0;
+exports.str = str;
+exports.bool = bool;
+exports.kebabCase = kebabCase;
+exports.findScaffold = findScaffold;
+exports.portableOptions = portableOptions;
+exports.nxSchemaFor = nxSchemaFor;
+exports.usageFor = usageFor;
+const recipe_1 = require("../../recipes/angular-distribution/recipe");
+const recipe_2 = require("../../recipes/angular-weaver/recipe");
+const recipe_3 = require("../../recipes/auth-source/recipe");
+const recipe_4 = require("../../recipes/layout/recipe");
+const recipe_5 = require("../../recipes/frame-plugin/recipe");
+const recipe_6 = require("../../recipes/settings-store/recipe");
+const recipe_7 = require("../../recipes/theme/recipe");
+const generate_1 = require("../generate/generate");
+function str(values, name) {
+    const value = values[name];
+    return typeof value === 'string' ? value : undefined;
+}
+function bool(values, name) {
+    const value = values[name];
+    return typeof value === 'boolean' ? value : undefined;
+}
+/** The kebab-case spelling of a camelCase option, for command lines that prefer it. */
+function kebabCase(name) {
+    return name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+const ID_PATTERN = '^[a-z][a-z0-9]*(-[a-z0-9]+)*$';
+const PLACEMENT_OPTIONS = [
+    {
+        name: 'directory',
+        type: 'string',
+        description: 'Project root, relative to the workspace root.',
+        workspaceOnly: true,
+    },
+    {
+        name: 'tags',
+        type: 'string',
+        description: 'Comma-separated Nx tags for the project.',
+        workspaceOnly: true,
+    },
+    {
+        name: 'prefix',
+        type: 'string',
+        description: 'Selector prefix for generated components and directives.',
+        default: 'lw',
+        pattern: ID_PATTERN,
+        workspaceOnly: true,
+    },
+    {
+        name: 'unitTestRunner',
+        type: 'string',
+        description: "Test wiring to emit. 'vitest' uses @nx/angular:unit-test; 'none' emits no test target.",
+        choices: ['vitest', 'none'],
+        default: 'vitest',
+        workspaceOnly: true,
+    },
+];
+const APP_OPTION = {
+    name: 'app',
+    type: 'string',
+    description: 'Application to drop into. Inferred when the workspace has exactly one.',
+    workspaceOnly: true,
+};
+exports.SCAFFOLDS = [
+    {
+        name: 'weaver',
+        summary: 'an Angular in-process plugin: manifest, surface, rail item, i18n, test',
+        options: [
+            {
+                name: 'id',
+                type: 'string',
+                description: "Plugin id in kebab-case, e.g. 'notes'.",
+                required: true,
+                pattern: ID_PATTERN,
+            },
+            {
+                name: 'name',
+                type: 'string',
+                description: 'Human-readable name. Defaults to a title-cased id.',
+            },
+            {
+                name: 'command',
+                type: 'boolean',
+                description: 'Also scaffold a registered command the weaver can trigger.',
+                default: false,
+            },
+            {
+                name: 'shortcut',
+                type: 'string',
+                description: "Keyboard chord for the command, e.g. 'mod+shift+k'. Implies --command.",
+            },
+            {
+                name: 'menu',
+                type: 'string',
+                description: "Hook a menu item into a slot, e.g. 'content/tab/context'. Implies --command.",
+            },
+            {
+                name: 'barItem',
+                type: 'boolean',
+                description: 'Also add a status-bar button that triggers the command. Implies --command.',
+                default: false,
+            },
+            {
+                name: 'settings',
+                type: 'boolean',
+                description: 'Also scaffold a settings section with signal-backed value owners.',
+                default: false,
+            },
+            {
+                name: 'about',
+                type: 'boolean',
+                description: 'Also scaffold an About dialog that reads ctx.host, plus a bottom rail item.',
+                default: false,
+            },
+            {
+                name: 'instanceable',
+                type: 'boolean',
+                description: 'Dock the surface and give it named saved instances, each with its own view state. Not combinable with --container: named instances exist only for a docked, non-routable surface.',
+                default: false,
+            },
+            {
+                name: 'container',
+                type: 'boolean',
+                description: "Make the surface a container: a routable tab at '<id>/:id' holding a nested pane tree of child surfaces, which the host draws. Not combinable with --instanceable.",
+                default: false,
+            },
+            {
+                name: 'access',
+                type: 'string',
+                description: "Auth-gate the surface and rail item: 'authenticated', 'anonymous' or 'role:<name>'.",
+            },
+            {
+                name: 'spec',
+                type: 'boolean',
+                description: 'Generate a starter unit test. Use --no-spec to skip it.',
+                default: true,
+            },
+            {
+                name: 'projectName',
+                type: 'string',
+                description: "Nx project name. Defaults to '<id>-weaver'.",
+                workspaceOnly: true,
+            },
+            {
+                name: 'importPath',
+                type: 'string',
+                description: 'Import path for the workspace alias. Defaults to the workspace scope plus the project name.',
+                workspaceOnly: true,
+            },
+            APP_OPTION,
+            ...PLACEMENT_OPTIONS,
+        ],
+        build: (values) => {
+            var _a;
+            return (0, generate_1.generate)(recipe_2.angularWeaver, {
+                id: (_a = str(values, 'id')) !== null && _a !== void 0 ? _a : '',
+                name: str(values, 'name'),
+                prefix: str(values, 'prefix'),
+                importPath: str(values, 'importPath'),
+                features: {
+                    command: bool(values, 'command'),
+                    shortcut: str(values, 'shortcut'),
+                    menu: str(values, 'menu'),
+                    barItem: bool(values, 'barItem'),
+                    settings: bool(values, 'settings'),
+                    about: bool(values, 'about'),
+                    instanceable: bool(values, 'instanceable'),
+                    container: bool(values, 'container'),
+                    access: str(values, 'access'),
+                    spec: bool(values, 'spec'),
+                },
+            });
+        },
+    },
+    {
+        name: 'frame-plugin',
+        summary: 'a framework-agnostic iframe plugin (Penpal + the frame UI kit)',
+        options: [
+            {
+                name: 'id',
+                type: 'string',
+                description: "Plugin id in kebab-case, e.g. 'notes'.",
+                required: true,
+                pattern: ID_PATTERN,
+            },
+            {
+                name: 'name',
+                type: 'string',
+                description: 'Human-readable name. Defaults to a title-cased id.',
+            },
+            APP_OPTION,
+        ],
+        build: (values) => {
+            var _a;
+            return (0, generate_1.generate)(recipe_5.framePlugin, {
+                id: (_a = str(values, 'id')) !== null && _a !== void 0 ? _a : '',
+                name: str(values, 'name'),
+            });
+        },
+    },
+    {
+        name: 'distribution',
+        summary: 'a runnable composition root that boots the shell',
+        options: [
+            {
+                name: 'name',
+                type: 'string',
+                description: "Distribution name in kebab-case, e.g. 'acme-studio'.",
+                required: true,
+                pattern: ID_PATTERN,
+            },
+            {
+                name: 'title',
+                type: 'string',
+                description: 'Product display title. Defaults to a title-cased name.',
+            },
+            {
+                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.",
+                choices: ['tailwind', 'precompiled'],
+                default: 'tailwind',
+            },
+            {
+                name: '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.',
+                workspaceOnly: true,
+            },
+            ...PLACEMENT_OPTIONS,
+        ],
+        build: (values) => {
+            var _a, _b;
+            return (0, generate_1.generate)(recipe_1.angularDistribution, {
+                name: (_a = str(values, 'name')) !== null && _a !== void 0 ? _a : '',
+                title: str(values, 'title'),
+                directory: str(values, 'directory'),
+                styles: (_b = str(values, 'styles')) !== null && _b !== void 0 ? _b : 'tailwind',
+            });
+        },
+    },
+    {
+        name: 'auth-source',
+        summary: 'a provider-neutral AuthSource that feeds the session',
+        options: [
+            {
+                name: 'name',
+                type: 'string',
+                description: "Source name in kebab-case, e.g. 'dev'.",
+                required: true,
+                pattern: ID_PATTERN,
+            },
+            APP_OPTION,
+        ],
+        build: (values) => { var _a; return (0, generate_1.generate)(recipe_3.authSource, { name: (_a = str(values, 'name')) !== null && _a !== void 0 ? _a : '' }); },
+    },
+    {
+        name: 'settings-store',
+        summary: 'a settings-store implementation backed by your API',
+        options: [
+            {
+                name: 'name',
+                type: 'string',
+                description: "Store name in kebab-case, e.g. 'backend'.",
+                required: true,
+                pattern: ID_PATTERN,
+            },
+            APP_OPTION,
+        ],
+        build: (values) => { var _a; return (0, generate_1.generate)(recipe_6.settingsStore, { name: (_a = str(values, 'name')) !== null && _a !== void 0 ? _a : '' }); },
+    },
+    {
+        name: 'theme',
+        summary: 'a token-override stylesheet in @layer lw-tenant-theme',
+        options: [
+            {
+                name: 'name',
+                type: 'string',
+                description: "Theme name in kebab-case, e.g. 'midnight'.",
+                required: true,
+                pattern: ID_PATTERN,
+            },
+            {
+                name: 'preset',
+                type: 'string',
+                description: "Where the token values come from. 'literal' writes editable colours; 'bootstrap' maps them onto Bootstrap 5.3's --bs-* variables, which makes the shell follow your Bootstrap theme live.",
+                choices: ['literal', 'bootstrap'],
+                default: 'literal',
+            },
+            APP_OPTION,
+        ],
+        build: (values) => {
+            var _a, _b;
+            return (0, generate_1.generate)(recipe_7.theme, {
+                name: (_a = str(values, 'name')) !== null && _a !== void 0 ? _a : '',
+                preset: (_b = str(values, 'preset')) !== null && _b !== void 0 ? _b : 'literal',
+            });
+        },
+    },
+    {
+        name: 'layout',
+        summary: 'a ShellLayout with the regions a weaver expects',
+        options: [
+            {
+                name: 'name',
+                type: 'string',
+                description: 'Layout name. Defaults to a base layout.',
+            },
+            APP_OPTION,
+        ],
+        build: (values) => (0, generate_1.generate)(recipe_4.layout, { name: str(values, 'name') }),
+    },
+];
+function findScaffold(name) {
+    return exports.SCAFFOLDS.find((scaffold) => scaffold.name === name);
+}
+/** The option surface an adapter that only produces files can offer. */
+function portableOptions(scaffold) {
+    return scaffold.options.filter((option) => !option.workspaceOnly);
+}
+/**
+ * The JSON Schema an Nx generator loads. Nx reads it from disk before any of our code runs, so the
+ * file cannot be computed at call time — instead it is checked against this shape by a test, which
+ * fails the moment the two drift apart.
+ */
+function nxSchemaFor(scaffold) {
+    const properties = {};
+    for (const option of scaffold.options) {
+        properties[option.name] = Object.assign(Object.assign(Object.assign({ type: option.type, description: option.description }, (option.pattern ? { pattern: option.pattern } : {})), (option.choices ? { enum: option.choices } : {})), (option.default === undefined ? {} : { default: option.default }));
+    }
+    return {
+        $schema: 'https://json-schema.org/schema',
+        $id: `LoomWeaver${scaffold.name
+            .split('-')
+            .map((part) => part[0].toUpperCase() + part.slice(1))
+            .join('')}`,
+        title: `Scaffold ${scaffold.summary}`,
+        type: 'object',
+        properties,
+        required: scaffold.options
+            .filter((option) => option.required)
+            .map((option) => option.name),
+    };
+}
+function usageFor(scaffold) {
+    const parts = portableOptions(scaffold).map((option) => {
+        const flag = `--${kebabCase(option.name)}`;
+        const body = option.type === 'boolean' ? flag : `${flag} <${option.name}>`;
+        return option.required ? body : `[${body}]`;
+    });
+    return [scaffold.name, ...parts].join(' ');
+}
+//# sourceMappingURL=scaffolds.js.map