@loomweaver/devkit 0.7.5 → 0.7.7

package/src/generators/weaver/generator.js

@@ -1,69 +1,79 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.weaverGenerator = weaverGenerator;
-const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
 const generate_1 = require("../../lib/generate/generate");
 const shared_1 = require("../shared");
+const amendments_1 = require("../../recipes/angular-weaver/amendments");
 const recipe_1 = require("../../recipes/angular-weaver/recipe");
 const nx_files_1 = require("./nx-files");
-function weaverGenerator(tree, options) {
-    return tslib_1.__awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const baseTsconfig = (0, shared_1.tsconfigPathsFile)(tree);
-        const app = appFor(tree, options);
-        const project = (0, nx_files_1.nxWeaverProject)({
-            id: options.id,
-            projectName: options.projectName,
-            directory: options.directory,
-            importPath: options.importPath,
-            scope: (0, shared_1.workspaceScope)(tree),
-            tags: (_a = options.tags) === null || _a === void 0 ? void 0 : _a.split(',').map((tag) => tag.trim()),
-            prefix: options.prefix,
-            buildTarget: app ? `${app}:build:development` : undefined,
-            baseTsconfig,
-        });
-        if (tree.exists(`${project.projectRoot}/project.json`)) {
-            throw new Error(`A project already exists at ${project.projectRoot}.`);
-        }
-        const source = (0, generate_1.generate)(recipe_1.angularWeaver, {
-            id: options.id,
-            name: options.name,
-            prefix: project.prefix,
-            importPath: project.importPath,
-            features: {
-                command: options.command,
-                menu: options.menu,
-                settings: options.settings,
-                access: options.access,
-                shortcut: options.shortcut,
-                barItem: options.barItem,
-                about: options.about,
-                instanceable: options.instanceable,
-                container: options.container,
-                spec: options.spec,
-            },
-        });
-        (0, shared_1.writeFiles)(tree, project.projectRoot, source, (0, nx_files_1.nxWeaverFiles)(project));
-        (0, devkit_1.updateJson)(tree, baseTsconfig, (json) => {
-            var _a, _b;
-            var _c;
-            (_a = json.compilerOptions) !== null && _a !== void 0 ? _a : (json.compilerOptions = {});
-            (_b = (_c = json.compilerOptions).paths) !== null && _b !== void 0 ? _b : (_c.paths = {});
-            json.compilerOptions.paths[project.importPath] = [
-                `./${project.projectRoot}/src/index.ts`,
-            ];
-            return json;
+async function weaverGenerator(tree, options) {
+    const baseTsconfig = (0, shared_1.tsconfigPathsFile)(tree);
+    const app = appFor(tree, options);
+    const project = (0, nx_files_1.nxWeaverProject)({
+        id: options.id,
+        projectName: options.projectName,
+        directory: options.directory,
+        importPath: options.importPath,
+        scope: (0, shared_1.workspaceScope)(tree),
+        tags: options.tags?.split(',').map((tag) => tag.trim()),
+        prefix: options.prefix,
+        buildTarget: app ? `${app}:build:development` : undefined,
+        baseTsconfig,
+    });
+    if (tree.exists(`${project.projectRoot}/project.json`)) {
+        throw new Error(`A project already exists at ${project.projectRoot}.`);
+    }
+    const input = {
+        id: options.id,
+        name: options.name,
+        prefix: project.prefix,
+        importPath: project.importPath,
+        features: {
+            command: options.command,
+            menu: options.menu,
+            settings: options.settings,
+            access: options.access,
+            shortcut: options.shortcut,
+            barItem: options.barItem,
+            about: options.about,
+            instanceable: options.instanceable,
+            container: options.container,
+            agent: options.agent,
+            spec: options.spec,
+        },
+    };
+    const source = (0, generate_1.generate)(recipe_1.angularWeaver, input);
+    (0, shared_1.writeFiles)(tree, project.projectRoot, source, (0, nx_files_1.nxWeaverFiles)(project));
+    (0, devkit_1.updateJson)(tree, baseTsconfig, (json) => {
+        json.compilerOptions ??= {};
+        json.compilerOptions.paths ??= {};
+        json.compilerOptions.paths[project.importPath] = [
+            `./${project.projectRoot}/src/index.ts`,
+        ];
+        return json;
+    });
+    if (app) {
+        (0, shared_1.addI18nAssetsGlob)(tree, app, {
+            input: `${project.projectRoot}/src/lib/i18n`,
+            output: `i18n/${options.id}`,
         });
-        if (app) {
-            (0, shared_1.addI18nAssetsGlob)(tree, app, {
-                input: `${project.projectRoot}/src/lib/i18n`,
-                output: `i18n/${options.id}`,
-            });
-            (0, shared_1.addTailwindSource)(tree, app, `${project.projectRoot}/src`);
+        (0, shared_1.addTailwindSource)(tree, app, `${project.projectRoot}/src`);
+    }
+    const installed = addPackages(tree, (0, amendments_1.weaverAmendments)(input, project.projectRoot));
+    await (0, devkit_1.formatFiles)(tree);
+    return installed;
+}
+function addPackages(tree, amendments) {
+    const wanted = {};
+    for (const amendment of amendments) {
+        if (amendment.kind === 'package') {
+            wanted[amendment.name] = amendment.version;
         }
-        yield (0, devkit_1.formatFiles)(tree);
-    });
+    }
+    return Object.keys(wanted).length === 0
+        ? undefined
+        : (0, devkit_1.addDependenciesToPackageJson)(tree, wanted, {});
 }
 function appFor(tree, options) {
     if (options.unitTestRunner === 'none') {

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

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/generators/weaver/generator.ts"],"names":[],"mappings":";;AAcA,0CA2DC;;AAzED,uCAA2D;AAC3D,0DAAuD;AACvD,sCAOmB;AACnB,gEAAoE;AACpE,yCAA4D;AAG5D,SAAsB,eAAe,CACnC,IAAU,EACV,OAA8B;;;QAE9B,MAAM,YAAY,GAAG,IAAA,0BAAiB,EAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,IAAA,0BAAe,EAAC;YAC9B,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,KAAK,EAAE,IAAA,uBAAc,EAAC,IAAI,CAAC;YAC3B,IAAI,EAAE,MAAA,OAAO,CAAC,IAAI,0CAAE,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACvD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,oBAAoB,CAAC,CAAC,CAAC,SAAS;YACzD,YAAY;SACb,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,eAAe,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,mBAAQ,EAAC,sBAAa,EAAE;YACrC,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE;gBACR,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB;SACF,CAAC,CAAC;QACH,IAAA,mBAAU,EAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,IAAA,wBAAa,EAAC,OAAO,CAAC,CAAC,CAAC;QAEtE,IAAA,mBAAU,EAAC,IAAI,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;;;YACtC,MAAA,IAAI,CAAC,eAAe,oCAApB,IAAI,CAAC,eAAe,GAAK,EAAE,EAAC;YAC5B,YAAA,IAAI,CAAC,eAAe,EAAC,KAAK,uCAAL,KAAK,GAAK,EAAE,EAAC;YAClC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG;gBAC/C,KAAK,OAAO,CAAC,WAAW,eAAe;aACxC,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,IAAI,GAAG,EAAE,CAAC;YACR,IAAA,0BAAiB,EAAC,IAAI,EAAE,GAAG,EAAE;gBAC3B,KAAK,EAAE,GAAG,OAAO,CAAC,WAAW,eAAe;gBAC5C,MAAM,EAAE,QAAQ,OAAO,CAAC,EAAE,EAAE;aAC7B,CAAC,CAAC;YACH,IAAA,0BAAiB,EAAC,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,MAAM,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA;AAED,SAAS,MAAM,CACb,IAAU,EACV,OAA8B;IAE9B,IAAI,OAAO,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAA,mBAAU,EAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,kBAAe,eAAe,CAAC"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/generators/weaver/generator.ts"],"names":[],"mappings":"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"}

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

@@ -4,18 +4,18 @@ exports.nxWeaverProject = nxWeaverProject;
 exports.nxWeaverFiles = nxWeaverFiles;
 const nx_scaffold_shared_1 = require("../nx-scaffold-shared");
 function nxWeaverProject(options) {
-    var _a, _b, _c, _d, _e, _f;
-    const projectName = (_a = options.projectName) !== null && _a !== void 0 ? _a : `${options.id}-weaver`;
-    const projectRoot = (_b = options.directory) !== null && _b !== void 0 ? _b : `libs/${projectName}`;
+    const projectName = options.projectName ?? `${options.id}-weaver`;
+    const projectRoot = options.directory ?? `libs/${projectName}`;
     return {
         id: options.id,
         projectName,
         projectRoot,
-        importPath: (_c = options.importPath) !== null && _c !== void 0 ? _c : (options.scope ? `${options.scope}/${projectName}` : projectName),
-        tags: (_d = options.tags) !== null && _d !== void 0 ? _d : [],
-        prefix: (_e = options.prefix) !== null && _e !== void 0 ? _e : 'lw',
+        importPath: options.importPath ??
+            (options.scope ? `${options.scope}/${projectName}` : projectName),
+        tags: options.tags ?? [],
+        prefix: options.prefix ?? 'lw',
         buildTarget: options.buildTarget,
-        baseTsconfig: (_f = options.baseTsconfig) !== null && _f !== void 0 ? _f : 'tsconfig.base.json',
+        baseTsconfig: options.baseTsconfig ?? 'tsconfig.base.json',
         depth: (0, nx_scaffold_shared_1.depthFor)(projectRoot),
     };
 }
@@ -27,15 +27,16 @@ function projectJson(p) {
         prefix: p.prefix,
         projectType: 'library',
         tags: p.tags,
-        targets: Object.assign(Object.assign({}, (p.buildTarget
-            ? {
+        targets: {
+            ...(p.buildTarget && {
                 test: {
                     executor: '@nx/angular:unit-test',
                     outputs: ['{workspaceRoot}/coverage/{projectName}'],
                     options: { buildTarget: p.buildTarget, watch: false },
                 },
-            }
-            : {})), { lint: { executor: '@nx/eslint:lint' } }),
+            }),
+            lint: { executor: '@nx/eslint:lint' },
+        },
     }, null, 2);
 }
 function tsconfig(p) {
@@ -51,7 +52,7 @@ function tsconfig(p) {
         ],
     }, null, 2);
 }
-function tsconfigLib(p) {
+function tsconfigLibrary(p) {
     return JSON.stringify({
         extends: './tsconfig.json',
         compilerOptions: {
@@ -66,8 +67,12 @@ function tsconfigLib(p) {
     }, null, 2);
 }
 function nxWeaverFiles(p) {
-    return Object.assign(Object.assign({ 'project.json': projectJson(p) + '\n', 'tsconfig.json': tsconfig(p) + '\n', 'tsconfig.lib.json': tsconfigLib(p) + '\n' }, (p.buildTarget
-        ? { 'tsconfig.spec.json': (0, nx_scaffold_shared_1.sharedTsconfigSpec)(p.depth) + '\n' }
-        : {})), { 'eslint.config.mjs': (0, nx_scaffold_shared_1.sharedEslintConfig)(p.depth, p.prefix) });
+    return {
+        'project.json': projectJson(p) + '\n',
+        'tsconfig.json': tsconfig(p) + '\n',
+        'tsconfig.lib.json': tsconfigLibrary(p) + '\n',
+        ...(p.buildTarget && { 'tsconfig.spec.json': (0, nx_scaffold_shared_1.sharedTsconfigSpec)(p.depth) + '\n' }),
+        'eslint.config.mjs': (0, nx_scaffold_shared_1.sharedEslintConfig)(p.depth, p.prefix),
+    };
 }
 //# sourceMappingURL=nx-files.js.map

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

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

package/src/generators/weaver/schema.json

@@ -51,6 +51,11 @@
       "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
     },
+    "agent": {
+      "type": "boolean",
+      "description": "Also scaffold the connection that lets an AG-UI agent run the commands this workbench offers: a docked panel, the seam where a call is decided before it runs, and a local stand-in that speaks the protocol so the whole path works on the first serve. Implies --command.",
+      "default": false
+    },
     "access": {
       "type": "string",
       "description": "Auth-gate the surface and rail item: 'authenticated', 'anonymous' or 'role:<name>'."

package/src/index.d.ts

@@ -1,19 +1,19 @@
 export type { FileMap, Recipe } from './lib/generate/types';
 export { amendments, generate } from './lib/generate/generate';
-export type { Amendment, AssetGlob, ComposePluginAmendment, BuildTargetAmendment, PostcssAmendment, StylesheetSourceAmendment, } from './lib/amend/types';
-export { ensureBuildTarget, ensurePostcssPlugin, ensureStylesheetSource, joinProjectPath, resolveAssetInput, type MergeResult, } from './lib/amend/merge';
-export { composeLines, composePlugin, type ComposeResult } from './lib/amend/compose';
+export type { Amendment, AssetGlob, ComposePluginAmendment, BuildTargetAmendment, PackageAmendment, PostcssAmendment, StylesheetSourceAmendment, } from './lib/amend/types';
+export { ensureBuildTarget, ensureDependency, ensurePostcssPlugin, ensureStylesheetSource, joinProjectPath, resolveAssetInput, type MergeResult, } from './lib/amend/merge';
+export { composeLines, composePlugin, type ComposeResult, } from './lib/amend/compose';
 export { describeAmendment } from './lib/amend/describe';
-export { isKebabId, toCamelCase, toPascalCase, toTitleCase } from './lib/generate/casing';
+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 { 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 { 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

@@ -1,11 +1,12 @@
 "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.describeAmendment = exports.composePlugin = exports.composeLines = exports.resolveAssetInput = exports.joinProjectPath = exports.ensureStylesheetSource = exports.ensurePostcssPlugin = exports.ensureBuildTarget = exports.generate = exports.amendments = void 0;
+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.describeAmendment = exports.composePlugin = exports.composeLines = exports.resolveAssetInput = exports.joinProjectPath = exports.ensureStylesheetSource = exports.ensurePostcssPlugin = exports.ensureDependency = exports.ensureBuildTarget = exports.generate = exports.amendments = void 0;
 var generate_1 = require("./lib/generate/generate");
 Object.defineProperty(exports, "amendments", { enumerable: true, get: function () { return generate_1.amendments; } });
 Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return generate_1.generate; } });
 var merge_1 = require("./lib/amend/merge");
 Object.defineProperty(exports, "ensureBuildTarget", { enumerable: true, get: function () { return merge_1.ensureBuildTarget; } });
+Object.defineProperty(exports, "ensureDependency", { enumerable: true, get: function () { return merge_1.ensureDependency; } });
 Object.defineProperty(exports, "ensurePostcssPlugin", { enumerable: true, get: function () { return merge_1.ensurePostcssPlugin; } });
 Object.defineProperty(exports, "ensureStylesheetSource", { enumerable: true, get: function () { return merge_1.ensureStylesheetSource; } });
 Object.defineProperty(exports, "joinProjectPath", { enumerable: true, get: function () { return merge_1.joinProjectPath; } });

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/tooling/devkit/src/index.ts"],"names":[],"mappings":";;;AACA,oDAA+D;AAAtD,sGAAA,UAAU,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAS7B,2CAO2B;AANzB,0GAAA,iBAAiB,OAAA;AACjB,4GAAA,mBAAmB,OAAA;AACnB,+GAAA,sBAAsB,OAAA;AACtB,wGAAA,eAAe,OAAA;AACf,0GAAA,iBAAiB,OAAA;AAGnB,+CAAsF;AAA7E,uGAAA,YAAY,OAAA;AAAE,wGAAA,aAAa,OAAA;AACpC,iDAAyD;AAAhD,6GAAA,iBAAiB,OAAA;AAC1B,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/tooling/devkit/src/index.ts"],"names":[],"mappings":";;;AACA,oDAA+D;AAAtD,sGAAA,UAAU,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAU7B,2CAQ2B;AAPzB,0GAAA,iBAAiB,OAAA;AACjB,yGAAA,gBAAgB,OAAA;AAChB,4GAAA,mBAAmB,OAAA;AACnB,+GAAA,sBAAsB,OAAA;AACtB,wGAAA,eAAe,OAAA;AACf,0GAAA,iBAAiB,OAAA;AAGnB,+CAI6B;AAH3B,uGAAA,YAAY,OAAA;AACZ,wGAAA,aAAa,OAAA;AAGf,iDAAyD;AAAhD,6GAAA,iBAAiB,OAAA;AAC1B,gDAK+B;AAJ7B,mGAAA,SAAS,OAAA;AACT,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA;AACZ,qGAAA,WAAW,OAAA;AAEb,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,iDAKgC;AAJ9B,+FAAA,KAAK,OAAA;AACL,2GAAA,iBAAiB,OAAA;AAInB,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,oDAIiC;AAH/B,4GAAA,gBAAgB,OAAA;AAChB,8GAAA,kBAAkB,OAAA;AAGpB,4CAA0E;AAAjE,0GAAA,kBAAkB,OAAA;AAC3B,kDAA6E;AAApE,0GAAA,eAAe,OAAA;AAAE,6GAAA,kBAAkB,OAAA"}

package/src/lib/amend/compose.js

@@ -2,8 +2,34 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.composePlugin = composePlugin;
 exports.composeLines = composeLines;
-const PROVIDERS = /(export\s+const\s+appConfig\s*:[^=]*=\s*\{[\s\S]*?providers\s*:\s*\[)([\s\S]*?)(\n(\s*)\],)/;
+const APP_CONFIG = /export\s+const\s+appConfig\s*:[^=]*=\s*\{/;
+const PROVIDERS_OPEN = /providers\s*:\s*\[/g;
 const SHELL_IMPORT = /import\s*\{([^}]*)\}\s*from\s*'@loomweaver\/shell';/;
+function closingLine(source, from) {
+    let close = source.indexOf('],', from);
+    while (close !== -1) {
+        let start = close;
+        while (start > from && source.charAt(start - 1).trim() === '') {
+            start -= 1;
+        }
+        const gap = source.slice(start, close);
+        const newline = gap.indexOf('\n');
+        if (newline !== -1) {
+            return { insertAt: start + newline, indent: gap.slice(newline + 1) };
+        }
+        close = source.indexOf('],', close + 2);
+    }
+    return null;
+}
+function providersBlock(source) {
+    const declaration = APP_CONFIG.exec(source);
+    if (!declaration) {
+        return null;
+    }
+    PROVIDERS_OPEN.lastIndex = declaration.index + declaration[0].length;
+    const open = PROVIDERS_OPEN.exec(source);
+    return open ? closingLine(source, open.index + open[0].length) : null;
+}
 /**
  * Registers a generated plugin in a composition root we generated ourselves. Recognition is the
  * whole safety mechanism: the providers array and the shell import are matched by the shape the
@@ -13,13 +39,16 @@ function composePlugin(source, amendment, importPath) {
     if (source.includes(amendment.symbol)) {
         return { source, composed: true };
     }
-    const providers = PROVIDERS.exec(source);
     const shellImport = SHELL_IMPORT.exec(source);
-    if (!providers || !shellImport) {
+    if (!shellImport || !providersBlock(source)) {
+        return { source, composed: false };
+    }
+    const withImports = source.replace(SHELL_IMPORT, () => `import {${withShellSymbols(shellImport[1])}} from '@loomweaver/shell';\nimport { ${amendment.symbol} } from '${importPath}';`);
+    const block = providersBlock(withImports);
+    if (!block) {
         return { source, composed: false };
     }
-    const withImports = source.replace(SHELL_IMPORT, `import {${withShellSymbols(shellImport[1])}} from '@loomweaver/shell';\nimport { ${amendment.symbol} } from '${importPath}';`);
-    const indent = `${providers[4]}  `;
+    const indent = `${block.indent}  `;
     const lines = [
         `${indent}provideTranslationNamespaces('${amendment.id}'),`,
         `${indent}provideCapabilityGrants({ ${amendment.id}: [${amendment.capabilities
@@ -28,7 +57,7 @@ function composePlugin(source, amendment, importPath) {
         `${indent}...providePlugins(${amendment.symbol}),`,
     ].join('\n');
     return {
-        source: withImports.replace(PROVIDERS, (_all, head, body, tail) => `${head}${body}\n${lines}${tail}`),
+        source: `${withImports.slice(0, block.insertAt)}\n${lines}${withImports.slice(block.insertAt)}`,
         composed: true,
     };
 }
@@ -53,12 +82,12 @@ function withShellSymbols(existing) {
         .split(',')
         .map((symbol) => symbol.trim())
         .filter(Boolean);
-    const missing = wanted.filter((symbol) => !present.some((entry) => entry.replace(/^type\s+/, '') === symbol));
+    const missing = wanted.filter((symbol) => present.every((entry) => entry.replace(/^type\s+/, '') !== symbol));
     if (missing.length === 0) {
         return existing;
     }
     const multiline = existing.includes('\n');
-    const all = [...present, ...missing].sort((a, b) => a.localeCompare(b));
+    const all = [...present, ...missing].toSorted((a, b) => a.localeCompare(b));
     return multiline ? `\n  ${all.join(',\n  ')},\n` : ` ${all.join(', ')} `;
 }
 //# sourceMappingURL=compose.js.map

package/src/lib/amend/compose.js.map

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

package/src/lib/amend/describe.js

@@ -10,6 +10,9 @@ function describeAmendment(amendment) {
     if (amendment.kind === 'postcss') {
         return `Write ${amendment.file} beside your package.json, naming ${amendment.plugin}. Without it the stylesheet is read as plain CSS: no utility class is emitted, the workbench renders unstyled, and the build still reports success.`;
     }
+    if (amendment.kind === 'package') {
+        return `Add ${amendment.name}@${amendment.version} to your project's dependencies and install it. Without it the generated files import a package that is not there, so the very first build fails.`;
+    }
     if (amendment.kind === 'stylesheet-source') {
         return `Add an @source entry for '${amendment.sourceRoot}' to the application's entry stylesheet, resolved from that stylesheet. Without it none of that code's utilities are emitted.`;
     }

package/src/lib/amend/describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/lib/amend/describe.ts"],"names":[],"mappings":";;AAOA,8CAsCC;AA3CD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,SAAoB;IACpD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,SAAS,SAAS,CAAC,IAAI,qCAAqC,SAAS,CAAC,MAAM,qJAAqJ,CAAC;IAC3O,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAC3C,OAAO,6BAA6B,SAAS,CAAC,UAAU,+HAA+H,CAAC;IAC1L,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACxC,OAAO,YAAY,SAAS,CAAC,EAAE,sCAAsC,SAAS,CAAC,MAAM,qCAAqC,SAAS,CAAC,EAAE,iCAAiC,SAAS,CAAC,EAAE,MAAM,SAAS,CAAC,YAAY;aAC5M,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,UAAU,GAAG,CAAC;aACtC,IAAI,CACH,IAAI,CACL,8BAA8B,SAAS,CAAC,MAAM,iDAAiD,CAAC;IACrG,CAAC;IACD,OAAO;QACL,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAC7B,CAAC,CAAC,CAAC,QAAQ,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;YACnD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAC7B,CAAC,CAAC;gBACE,kBAAkB,SAAS,CAAC,MAAM;qBAC/B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;qBAC3B,IAAI,CAAC,IAAI,CAAC,oIAAoI;aAClJ;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,aAAa;YACzB,CAAC,CAAC;gBACE,wBAAwB,SAAS,CAAC,aAAa,wFAAwF;aACxI;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,cAAc,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,6CAA6C,SAAS,CAAC,cAAc,8KAA8K;aACpP,CAAC;KACP;SACE,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;SAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/lib/amend/describe.ts"],"names":[],"mappings":";;AAOA,8CA2CC;AAhDD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,SAAoB;IACpD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,SAAS,SAAS,CAAC,IAAI,qCAAqC,SAAS,CAAC,MAAM,qJAAqJ,CAAC;IAC3O,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,OAAO,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,OAAO,mJAAmJ,CAAC;IACvM,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAC3C,OAAO,6BAA6B,SAAS,CAAC,UAAU,+HAA+H,CAAC;IAC1L,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACxC,OAAO,YAAY,SAAS,CAAC,EAAE,sCAAsC,SAAS,CAAC,MAAM,qCAAqC,SAAS,CAAC,EAAE,iCAAiC,SAAS,CAAC,EAAE,MAAM,SAAS,CAAC,YAAY;aAC5M,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,UAAU,GAAG,CAAC;aACtC,IAAI,CACH,IAAI,CACL,8BAA8B,SAAS,CAAC,MAAM,iDAAiD,CAAC;IACrG,CAAC;IACD,OAAO;QACL,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAC7B,CAAC,CAAC,CAAC,QAAQ,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;YACnD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAC7B,CAAC,CAAC;gBACE,kBAAkB,SAAS,CAAC,MAAM;qBAC/B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;qBAC3B,IAAI,CACH,IAAI,CACL,oIAAoI;aACxI;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,aAAa;YACzB,CAAC,CAAC;gBACE,wBAAwB,SAAS,CAAC,aAAa,wFAAwF;aACxI;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,cAAc,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,6CAA6C,SAAS,CAAC,cAAc,8KAA8K;aACpP,CAAC;KACP;SACE,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;SAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/src/lib/amend/merge.d.ts

@@ -1,4 +1,4 @@
-import { AssetGlob, BuildTargetAmendment, PostcssAmendment } from './types';
+import { AssetGlob, BuildTargetAmendment, PackageAmendment, PostcssAmendment } from './types';
 export type JsonObject = Record<string, unknown>;
 export interface MergeResult {
     readonly value: JsonObject;
@@ -7,8 +7,15 @@ export interface MergeResult {
     /** What could not be added because the consumer's value occupies the place it would go. */
     readonly declined: readonly string[];
 }
+export declare function normalizeProjectRoot(value: string): string;
 export declare function joinProjectPath(projectRoot: string, path: string): string;
 export declare function resolveAssetInput(glob: AssetGlob, projectRoot: string): string;
 export declare function ensurePostcssPlugin(existing: unknown, amendment: PostcssAmendment): MergeResult;
+/**
+ * Records a package the generated files need in the project's manifest. A version already recorded
+ * wins wherever it stands — a consumer who pinned it, or moved it to devDependencies, chose that on
+ * purpose and this is an "ensure it is present", not a "set it to".
+ */
+export declare function ensureDependency(manifest: unknown, amendment: PackageAmendment): MergeResult;
 export declare function ensureBuildTarget(target: unknown, amendment: BuildTargetAmendment, projectRoot: string): MergeResult;
 export declare function ensureStylesheetSource(css: string, source: string): string;