@aligent/nx-appbuilder 0.2.0

package/src/generators/preset/preset.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = presetGenerator;
+const devkit_1 = require("@nx/devkit");
+const path = __importStar(require("path"));
+const nx_json_1 = require("./nx-json");
+const DEFAULT_NODE_VERSION = '24.0.1';
+/**
+ * Preset generator invoked by `create-nx-workspace --preset=@aligent/nx-appbuilder`.
+ *
+ * Scaffolds the workspace shell — root package.json, nx.json, .npmrc, etc. —
+ * but does NOT scaffold any apps. Apps are added afterwards via the `app`
+ * generator (`npx nx g @aligent/nx-appbuilder:app <name>`).
+ *
+ * Name shape (kebab-case) and nodeVersion semver are enforced by the schema's
+ * `pattern` fields before this function runs.
+ */
+async function presetGenerator(tree, options) {
+    const nodeVersion = options.nodeVersion ?? DEFAULT_NODE_VERSION;
+    const subs = {
+        ...options,
+        nodeVersion,
+        packageName: `@aligent/${options.name}`,
+    };
+    (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files'), '.', subs);
+    (0, devkit_1.updateNxJson)(tree, { ...nx_json_1.NX_JSON });
+    (0, devkit_1.writeJson)(tree, 'package.json', buildWorkspacePackageJson(options.name, nodeVersion));
+    await (0, devkit_1.formatFiles)(tree);
+}
+/**
+ * Build the workspace package.json. Includes `@aligent/nx-appbuilder` in
+ * devDependencies so the lockfile written by create-nx-workspace stays in sync
+ * with what the preset declares — otherwise npm fails the post-preset install
+ * with an arborist "must provide string spec" error.
+ */
+function buildWorkspacePackageJson(name, nodeVersion) {
+    const major = nodeVersion.split('.')[0];
+    return {
+        name: `@aligent/${name}`,
+        version: '0.0.0',
+        author: 'Aligent Consulting',
+        private: true,
+        engines: { node: `>=${major}` },
+        scripts: {
+            lint: 'nx affected -t lint',
+            'lint:all': 'nx run-many -t lint',
+            'check-types': 'nx affected -t check-types',
+            'check-types:all': 'nx run-many -t check-types',
+            test: 'nx affected -t test',
+            'test:all': 'nx run-many -t test',
+            build: 'nx affected -t build',
+            'build:all': 'nx run-many -t build',
+        },
+        workspaces: [],
+        devDependencies: {
+            '@aligent/nx-appbuilder': getGeneratorVersion(),
+            // Resolved by the workspace's tsconfig.json's `extends` line and
+            // by every generated app's tsconfig chain. Pinned at the workspace
+            // root so all apps share one resolution.
+            '@aligent/ts-code-standards': '^4.2.0',
+            // The @nx plugin packages need to be installed at the workspace
+            // root so the plugins declared in nx.json can actually load.
+            '@nx/eslint': '^22.4.5',
+            '@nx/js': '^22.4.5',
+            '@nx/vitest': '^22.4.5',
+            eslint: '^9.0.0',
+            nx: '^22.4.5',
+            typescript: '^5.8.3',
+            vitest: '^2.1.8',
+        },
+    };
+}
+function getGeneratorVersion() {
+    const packagePath = path.join(__dirname, '../../../package.json');
+    const packageJson = (0, devkit_1.readJsonFile)(packagePath);
+    if (typeof packageJson.version !== 'string') {
+        throw new Error(`Unable to read generator version from ${packagePath}`);
+    }
+    return packageJson.version;
+}

package/src/generators/preset/schema.d.ts

@@ -0,0 +1,4 @@
+export interface PresetGeneratorSchema {
+    name: string;
+    nodeVersion?: string;
+}

package/src/generators/preset/schema.json

@@ -0,0 +1,25 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "$id": "AligentAppBuilderPreset",
+    "title": "Aligent AppBuilder workspace",
+    "description": "Scaffolds a new Aligent AppBuilder monorepo (workspace shell only — apps are added via the `app` generator).",
+    "type": "object",
+    "properties": {
+        "name": {
+            "type": "string",
+            "description": "Workspace name (kebab-case). Used as the @aligent/<name> npm package name and the workspace directory name.",
+            "$default": { "$source": "argv", "index": 0 },
+            "x-prompt": "What is the workspace name? (kebab-case, e.g. 'acme-apps')",
+            "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "nodeVersion": {
+            "type": "string",
+            "description": "Target Node.js version pinned in .nvmrc and used as the lower bound of engines.node (e.g. 22.18.0).",
+            "default": "24.0.1",
+            "x-prompt": "What is the target Node.js version?",
+            "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+            "patternErrorMessage": "Node.js version must be a valid semver, e.g. 22.18.0 or 24.0.1"
+        }
+    },
+    "required": ["name"]
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './generators/app/generator';
+export * from './generators/preset/preset';

package/src/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* v8 ignore next 2 */
+__exportStar(require("./generators/app/generator"), exports);
+__exportStar(require("./generators/preset/preset"), exports);

package/tsconfig.lib.tsbuildinfo

@@ -0,0 +1 @@
+{"version":"5.9.3"}