@dx-labs/template-designer-setup 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+## [0.1.2](https://github.com/dx-labs-com/template-designer-pro-setup/compare/template-designer-pro-setup-v0.1.1...template-designer-pro-setup-v0.1.2) (2026-02-03)
+
+
+### Bug Fixes
+
+* release package ([53ba47f](https://github.com/dx-labs-com/template-designer-pro-setup/commit/53ba47f204eedbc40cb698860208969592ccd670))
+
+## [0.1.1](https://github.com/dx-labs-com/template-designer-pro-setup/compare/template-designer-pro-setup-v0.1.0...template-designer-pro-setup-v0.1.1) (2026-02-03)
+
+
+### Bug Fixes
+
+* release package ([7a2211f](https://github.com/dx-labs-com/template-designer-pro-setup/commit/7a2211f1074716c59d43a4741fcf5302a85af2d7))
+
+# [0.1.0](https://github.com/dx-labs-com/template-designer-pro-setup/compare/template-designer-pro-setup-v0.0.1...template-designer-pro-setup-v0.1.0) (2026-02-03)
+
+
+### Features
+
+* publish template-designer-pro-setup ([f716d0f](https://github.com/dx-labs-com/template-designer-pro-setup/commit/f716d0f6972873ebfac3a68ee47d76abf175ccab))

package/README.md

@@ -0,0 +1,44 @@
+# Template Designer Setup CLI
+
+CLI that installs and wires the Template Designer frontend and License Box backend plugins into a Backstage instance. It can be published and used via `npx @dx-labs/template-designer-setup`.
+
+## Build
+
+- From repo root: `yarn install`
+- Build the CLI: `yarn workspace @dx-labs/template-designer-setup build`
+
+## Usage
+
+Run from the Backstage repo root (must contain `packages/app`, `packages/backend`, and `app-config.yaml`).
+
+- Dry run (no writes): `node npx/dist/index.js --dryRun --licenseId LIC-12345`
+- Full run with prompts for missing values: `npx @dx-labs/template-designer-setup --licenseId LIC-12345`
+- Run against a different Backstage path: `npx @dx-labs/template-designer-setup --backstageDir ../my-backstage --licenseId LIC-12345`
+- Provide registry details explicitly: `npx @dx-labs/template-designer-setup --licenseId LIC-12345 --npmToken TOKEN --registryUrl https://registry.npmjs.org --scopes @tduniec,@dx-labs`
+- Skip final install: `npx @dx-labs/template-designer-setup --licenseId LIC-12345 --skipInstall`
+
+Flags:
+
+- `--licenseId <value>` (required, prompts if missing)
+- `--npmToken <value>` (optional, prompts if missing)
+- `--registryUrl <url>` defaults to `https://registry.npmjs.org`
+- `--scopes <@scope1,@scope2>` defaults to `@tduniec,@dx-labs`
+- `--backstageDir <path>` to target a Backstage repo (default: current working directory)
+- `--dryRun` shows planned actions only
+- `--skipInstall` skips `yarn install` after patching
+
+## What it does
+
+1. Installs `@dx-labs/plugin-template-designer-pro` in `packages/app`
+2. Installs `@dx-labs/plugin-license-box` in `packages/backend`
+3. Adds Template Designer route to `packages/app/src/App.tsx` using ts-morph (idempotent)
+4. Adds sidebar entry with `TemplateDesignerIcon` to `packages/app/src/components/Root/Root.tsx` (idempotent)
+5. Writes `dxLicenseBox.license.key` to `app-config.local.yaml` when present, otherwise `app-config.yaml`
+6. Configures `.npmrc` with the provided scopes, registry, and auth token (token is masked in logs)
+7. Runs `yarn install` unless `--skipInstall` is passed
+
+## Publish (optional)
+
+- Bump the version in `npx/package.json` if needed
+- Build: `yarn workspace @dx-labs/template-designer-setup build`
+- Publish from `npx/`: `cd npx && npm publish --access public`

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path_1 = __importDefault(require("path"));
+const prompts_1 = __importDefault(require("prompts"));
+const ensureNpmrc_1 = require("./steps/ensureNpmrc");
+const installPackages_1 = require("./steps/installPackages");
+const patchAppConfig_1 = require("./steps/patchAppConfig");
+const patchAppTsx_1 = require("./steps/patchAppTsx");
+const patchRootTsx_1 = require("./steps/patchRootTsx");
+const patchBackendIndex_1 = require("./steps/patchBackendIndex");
+const exec_1 = require("./utils/exec");
+const fs_1 = require("./utils/fs");
+const log_1 = require("./utils/log");
+const DEFAULT_SCOPES = ["@tduniec", "@dx-labs"];
+const DEFAULT_REGISTRY = "https://registry.npmjs.org";
+async function main() {
+    const program = new commander_1.Command();
+    program
+        .name("template-designer-setup")
+        .description("Install and configure Template Designer and License Box plugins for Backstage")
+        .option("--backstageDir <path>", "Path to Backstage repo root (defaults to current working directory)")
+        .option("--licenseId <id>", "License Box license identifier")
+        .option("--npmToken <token>", "Token for accessing the private npm registry")
+        .option("--registryUrl <url>", "Registry URL", DEFAULT_REGISTRY)
+        .option("--scopes <scopes>", "Comma-separated scopes to configure", (value) => value, DEFAULT_SCOPES.join(","))
+        .option("--dryRun", "Show actions without writing files or running commands", false)
+        .option("--skipInstall", "Skip running yarn install at the end", false)
+        .parse(process.argv);
+    const options = program.opts();
+    try {
+        const root = options.backstageDir
+            ? path_1.default.resolve(process.cwd(), options.backstageDir)
+            : process.cwd();
+        const scopes = parseScopes(options.scopes);
+        const dryRun = Boolean(options.dryRun);
+        const skipInstall = Boolean(options.skipInstall);
+        await validateBackstageRoot(root);
+        const configPath = (await (0, fs_1.fileExists)(path_1.default.join(root, "app-config.local.yaml")))
+            ? path_1.default.join(root, "app-config.local.yaml")
+            : path_1.default.join(root, "app-config.yaml");
+        const licenseId = await resolveLicenseId(options.licenseId);
+        const npmToken = await resolveNpmToken(options.npmToken);
+        const context = {
+            root,
+            dryRun,
+            skipInstall,
+            licenseId,
+            npmToken,
+            registryUrl: options.registryUrl ?? DEFAULT_REGISTRY,
+            scopes,
+            configPath,
+        };
+        await (0, ensureNpmrc_1.ensureNpmrc)(context);
+        await (0, installPackages_1.installPackages)(context);
+        await (0, patchAppTsx_1.patchAppTsx)(context);
+        await (0, patchRootTsx_1.patchRootTsx)(context);
+        await (0, patchBackendIndex_1.patchBackendIndex)(context);
+        await (0, patchAppConfig_1.patchAppConfig)(context);
+        if (!skipInstall) {
+            await runYarnInstall(context);
+        }
+        else {
+            (0, log_1.info)("Skipping yarn install (--skipInstall provided)");
+        }
+        (0, log_1.success)("Template Designer setup completed");
+        (0, log_1.info)("Next: start Backstage to verify → yarn start");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        (0, log_1.error)(message);
+        process.exitCode = 1;
+    }
+}
+async function validateBackstageRoot(root) {
+    const requiredPaths = [
+        path_1.default.join(root, "packages", "app"),
+        path_1.default.join(root, "packages", "backend"),
+        path_1.default.join(root, "app-config.yaml"),
+    ];
+    for (const required of requiredPaths) {
+        if (!(await (0, fs_1.fileExists)(required))) {
+            throw new Error(`This tool must be run from a Backstage repository root. Missing: ${path_1.default.relative(root, required)}`);
+        }
+    }
+}
+function parseScopes(scopes) {
+    if (!scopes)
+        return DEFAULT_SCOPES;
+    return scopes
+        .split(",")
+        .map((scope) => scope.trim())
+        .filter((scope) => scope.length > 0);
+}
+async function resolveLicenseId(provided) {
+    if (provided)
+        return provided;
+    const validateLicenseId = (value) => value.trim().length > 0 ? true : "licenseId is required";
+    const response = (await (0, prompts_1.default)({
+        type: "text",
+        name: "licenseId",
+        message: "Enter the License Box licenseId",
+        validate: validateLicenseId,
+    }));
+    const licenseIdRaw = response.licenseId;
+    const licenseId = typeof licenseIdRaw === "string" ? licenseIdRaw.trim() : "";
+    if (!licenseId) {
+        throw new Error("licenseId is required");
+    }
+    return licenseId;
+}
+async function resolveNpmToken(provided) {
+    if (provided)
+        return provided;
+    const response = (await (0, prompts_1.default)({
+        type: "password",
+        name: "npmToken",
+        message: "Enter npm token for the private registry (optional)",
+    }));
+    const tokenRaw = response.npmToken;
+    const token = typeof tokenRaw === "string" ? tokenRaw.trim() : "";
+    return token.length > 0 ? token : undefined;
+}
+async function runYarnInstall(context) {
+    await (0, exec_1.runCommand)("yarn", ["install"], { cwd: context.root, dryRun: context.dryRun });
+    if (context.dryRun) {
+        return;
+    }
+    (0, log_1.success)("yarn install completed");
+}
+void main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport path from \"path\";\nimport prompts from \"prompts\";\nimport { CliContext } from \"./types\";\nimport { ensureNpmrc } from \"./steps/ensureNpmrc\";\nimport { installPackages } from \"./steps/installPackages\";\nimport { patchAppConfig } from \"./steps/patchAppConfig\";\nimport { patchAppTsx } from \"./steps/patchAppTsx\";\nimport { patchRootTsx } from \"./steps/patchRootTsx\";\nimport { patchBackendIndex } from \"./steps/patchBackendIndex\";\nimport { runCommand } from \"./utils/exec\";\nimport { fileExists } from \"./utils/fs\";\nimport { error, info, success } from \"./utils/log\";\n\nconst DEFAULT_SCOPES = [\"@tduniec\", \"@dx-labs\"];\nconst DEFAULT_REGISTRY = \"https://registry.npmjs.org\";\n\nasync function main() {\n  const program = new Command();\n\n  program\n    .name(\"template-designer-setup\")\n    .description(\"Install and configure Template Designer and License Box plugins for Backstage\")\n    .option(\n      \"--backstageDir <path>\",\n      \"Path to Backstage repo root (defaults to current working directory)\",\n    )\n    .option(\"--licenseId <id>\", \"License Box license identifier\")\n    .option(\"--npmToken <token>\", \"Token for accessing the private npm registry\")\n    .option(\"--registryUrl <url>\", \"Registry URL\", DEFAULT_REGISTRY)\n    .option(\n      \"--scopes <scopes>\",\n      \"Comma-separated scopes to configure\",\n      (value: string) => value,\n      DEFAULT_SCOPES.join(\",\"),\n    )\n    .option(\"--dryRun\", \"Show actions without writing files or running commands\", false)\n    .option(\"--skipInstall\", \"Skip running yarn install at the end\", false)\n    .parse(process.argv);\n\n  const options = program.opts<{\n    licenseId?: string;\n    npmToken?: string;\n    registryUrl?: string;\n    scopes?: string;\n    dryRun?: boolean;\n    skipInstall?: boolean;\n    backstageDir?: string;\n  }>();\n\n  try {\n    const root = options.backstageDir\n      ? path.resolve(process.cwd(), options.backstageDir)\n      : process.cwd();\n    const scopes = parseScopes(options.scopes);\n    const dryRun = Boolean(options.dryRun);\n    const skipInstall = Boolean(options.skipInstall);\n\n    await validateBackstageRoot(root);\n\n    const configPath = (await fileExists(path.join(root, \"app-config.local.yaml\")))\n      ? path.join(root, \"app-config.local.yaml\")\n      : path.join(root, \"app-config.yaml\");\n\n    const licenseId = await resolveLicenseId(options.licenseId);\n    const npmToken = await resolveNpmToken(options.npmToken);\n\n    const context: CliContext = {\n      root,\n      dryRun,\n      skipInstall,\n      licenseId,\n      npmToken,\n      registryUrl: options.registryUrl ?? DEFAULT_REGISTRY,\n      scopes,\n      configPath,\n    };\n\n    await ensureNpmrc(context);\n    await installPackages(context);\n    await patchAppTsx(context);\n    await patchRootTsx(context);\n    await patchBackendIndex(context);\n    await patchAppConfig(context);\n\n    if (!skipInstall) {\n      await runYarnInstall(context);\n    } else {\n      info(\"Skipping yarn install (--skipInstall provided)\");\n    }\n\n    success(\"Template Designer setup completed\");\n    info(\"Next: start Backstage to verify → yarn start\");\n  } catch (err: unknown) {\n    const message = err instanceof Error ? err.message : String(err);\n    error(message);\n    process.exitCode = 1;\n  }\n}\n\nasync function validateBackstageRoot(root: string) {\n  const requiredPaths = [\n    path.join(root, \"packages\", \"app\"),\n    path.join(root, \"packages\", \"backend\"),\n    path.join(root, \"app-config.yaml\"),\n  ];\n\n  for (const required of requiredPaths) {\n    if (!(await fileExists(required))) {\n      throw new Error(\n        `This tool must be run from a Backstage repository root. Missing: ${path.relative(\n          root,\n          required,\n        )}`,\n      );\n    }\n  }\n}\n\nfunction parseScopes(scopes?: string): string[] {\n  if (!scopes) return DEFAULT_SCOPES;\n  return scopes\n    .split(\",\")\n    .map((scope) => scope.trim())\n    .filter((scope) => scope.length > 0);\n}\n\nasync function resolveLicenseId(provided?: string): Promise<string> {\n  if (provided) return provided;\n\n  const validateLicenseId = (value: string) =>\n    value.trim().length > 0 ? true : \"licenseId is required\";\n\n  const response = (await prompts({\n    type: \"text\",\n    name: \"licenseId\",\n    message: \"Enter the License Box licenseId\",\n    validate: validateLicenseId,\n  })) as { licenseId?: string };\n\n  const licenseIdRaw: unknown = (response as { licenseId?: unknown }).licenseId;\n  const licenseId = typeof licenseIdRaw === \"string\" ? licenseIdRaw.trim() : \"\";\n  if (!licenseId) {\n    throw new Error(\"licenseId is required\");\n  }\n\n  return licenseId;\n}\n\nasync function resolveNpmToken(provided?: string): Promise<string | undefined> {\n  if (provided) return provided;\n\n  const response = (await prompts({\n    type: \"password\",\n    name: \"npmToken\",\n    message: \"Enter npm token for the private registry (optional)\",\n  })) as { npmToken?: string };\n\n  const tokenRaw: unknown = (response as { npmToken?: unknown }).npmToken;\n  const token = typeof tokenRaw === \"string\" ? tokenRaw.trim() : \"\";\n  return token.length > 0 ? token : undefined;\n}\n\nasync function runYarnInstall(context: CliContext) {\n  await runCommand(\"yarn\", [\"install\"], { cwd: context.root, dryRun: context.dryRun });\n  if (context.dryRun) {\n    return;\n  }\n  success(\"yarn install completed\");\n}\n\nvoid main();\n"]}

package/dist/steps/ensureNpmrc.d.ts

@@ -0,0 +1,2 @@
+import { CliContext } from "../types";
+export declare function ensureNpmrc(context: CliContext): Promise<void>;

package/dist/steps/ensureNpmrc.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureNpmrc = ensureNpmrc;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("../utils/fs");
+const log_1 = require("../utils/log");
+const yaml_1 = __importDefault(require("yaml"));
+const DEFAULT_REGISTRY = "https://registry.npmjs.org";
+async function ensureNpmrc(context) {
+    const npmrcPath = path_1.default.join(context.root, ".npmrc");
+    const registryUrl = context.registryUrl || DEFAULT_REGISTRY;
+    const scopes = context.scopes;
+    const npmToken = context.npmToken;
+    (0, log_1.step)("Ensuring .npmrc is configured");
+    const existing = (await (0, fs_1.readFileIfExists)(npmrcPath)) ?? "";
+    const lines = existing.split(/\r?\n/).filter((line) => line.trim().length > 0);
+    const additions = [];
+    scopes.forEach((scope) => {
+        const trimmedScope = scope.trim();
+        if (!trimmedScope.startsWith("@"))
+            return;
+        const scopeLine = `${trimmedScope}:registry=${registryUrl}`;
+        const alreadyPresent = lines.some((line) => line.startsWith(`${trimmedScope}:registry=`));
+        if (!alreadyPresent) {
+            additions.push(scopeLine);
+        }
+    });
+    if (npmToken) {
+        const registryHost = toRegistryHost(registryUrl);
+        const tokenLine = `//${registryHost}:_authToken=${npmToken}`;
+        const hasToken = lines.some((line) => line.startsWith(`//${registryHost}:_authToken=`));
+        if (!hasToken) {
+            additions.push(tokenLine);
+        }
+    }
+    if (additions.length === 0) {
+        if (context.dryRun) {
+            (0, log_1.dryRun)(".npmrc already contains required registry settings");
+        }
+        else {
+            (0, log_1.success)(".npmrc already contains required registry settings");
+        }
+        return;
+    }
+    const nextContent = buildContent(existing, additions);
+    if (context.dryRun) {
+        (0, log_1.dryRun)(`Would update .npmrc with scopes ${scopes.join(", ")}${npmToken ? " and auth token" : ""}`);
+        return;
+    }
+    await (0, fs_1.writeFileSafely)(npmrcPath, nextContent);
+    (0, log_1.success)(`.npmrc updated (${additions.length} entr${additions.length === 1 ? "y" : "ies"} added${npmToken ? `, token ${(0, log_1.mask)(npmToken)}` : ""})`);
+    await ensureYarnrcYml(context, registryUrl, scopes, npmToken);
+}
+function toRegistryHost(registryUrl) {
+    try {
+        const url = new URL(registryUrl);
+        const path = url.pathname.endsWith("/") ? url.pathname.slice(1) : `${url.pathname.slice(1)}/`;
+        return `${url.host}/${path}`;
+    }
+    catch {
+        return registryUrl.replace(/^https?:\/\//, "").replace(/\/?$/, "/");
+    }
+}
+function buildContent(existing, additions) {
+    let content = existing.trimEnd();
+    if (content.length > 0 && !content.endsWith("\n")) {
+        content += "\n";
+    }
+    else if (content.length > 0) {
+        // keep as is
+    }
+    content += additions.join("\n");
+    if (!content.endsWith("\n")) {
+        content += "\n";
+    }
+    return content;
+}
+async function ensureYarnrcYml(context, registryUrl, scopes, npmToken) {
+    const yarnrcPath = path_1.default.join(context.root, ".yarnrc.yml");
+    const existingContent = (await (0, fs_1.readFileIfExists)(yarnrcPath)) ?? "";
+    let doc = existingContent
+        ? yaml_1.default.parse(existingContent)
+        : {};
+    if (!doc || typeof doc !== "object")
+        doc = {};
+    const npmScopes = doc.npmScopes ?? {};
+    doc.npmScopes = npmScopes;
+    let changed = false;
+    scopes
+        .map((s) => s.replace(/^@/, ""))
+        .filter((s) => s.length > 0)
+        .forEach((scope) => {
+        const current = npmScopes[scope] || {};
+        const desired = {
+            npmRegistryServer: registryUrl,
+        };
+        if (npmToken) {
+            desired.npmAuthToken = npmToken;
+            desired.npmAlwaysAuth = true;
+        }
+        const next = { ...current, ...desired };
+        if (JSON.stringify(current) !== JSON.stringify(next)) {
+            npmScopes[scope] = next;
+            changed = true;
+        }
+    });
+    if (!changed) {
+        if (context.dryRun) {
+            (0, log_1.dryRun)(".yarnrc.yml already contains required scope registry settings");
+        }
+        else {
+            (0, log_1.success)(".yarnrc.yml already contains required scope registry settings");
+        }
+        return;
+    }
+    const yamlOut = yaml_1.default.stringify(doc).trimEnd() + "\n";
+    if (context.dryRun) {
+        (0, log_1.dryRun)("Would update .yarnrc.yml with scope registry/token configuration");
+        return;
+    }
+    await (0, fs_1.writeFileSafely)(yarnrcPath, yamlOut);
+    (0, log_1.success)(`.yarnrc.yml updated for scopes ${scopes.join(", ")}${npmToken ? ` (token ${(0, log_1.mask)(npmToken)})` : ""}`);
+}
+//# sourceMappingURL=ensureNpmrc.js.map

package/dist/steps/ensureNpmrc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureNpmrc.js","sourceRoot":"","sources":["../../src/steps/ensureNpmrc.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"path\";\nimport { CliContext } from \"../types\";\nimport { readFileIfExists, writeFileSafely } from \"../utils/fs\";\nimport { dryRun, mask, success, step } from \"../utils/log\";\nimport YAML from \"yaml\";\n\nconst DEFAULT_REGISTRY = \"https://registry.npmjs.org\";\n\nexport async function ensureNpmrc(context: CliContext) {\n  const npmrcPath = path.join(context.root, \".npmrc\");\n  const registryUrl = context.registryUrl || DEFAULT_REGISTRY;\n  const scopes = context.scopes;\n  const npmToken = context.npmToken;\n\n  step(\"Ensuring .npmrc is configured\");\n  const existing = (await readFileIfExists(npmrcPath)) ?? \"\";\n  const lines = existing.split(/\\r?\\n/).filter((line) => line.trim().length > 0);\n\n  const additions: string[] = [];\n\n  scopes.forEach((scope) => {\n    const trimmedScope = scope.trim();\n    if (!trimmedScope.startsWith(\"@\")) return;\n    const scopeLine = `${trimmedScope}:registry=${registryUrl}`;\n    const alreadyPresent = lines.some((line) => line.startsWith(`${trimmedScope}:registry=`));\n    if (!alreadyPresent) {\n      additions.push(scopeLine);\n    }\n  });\n\n  if (npmToken) {\n    const registryHost = toRegistryHost(registryUrl);\n    const tokenLine = `//${registryHost}:_authToken=${npmToken}`;\n    const hasToken = lines.some((line) => line.startsWith(`//${registryHost}:_authToken=`));\n    if (!hasToken) {\n      additions.push(tokenLine);\n    }\n  }\n\n  if (additions.length === 0) {\n    if (context.dryRun) {\n      dryRun(\".npmrc already contains required registry settings\");\n    } else {\n      success(\".npmrc already contains required registry settings\");\n    }\n    return;\n  }\n\n  const nextContent = buildContent(existing, additions);\n\n  if (context.dryRun) {\n    dryRun(\n      `Would update .npmrc with scopes ${scopes.join(\", \")}${npmToken ? \" and auth token\" : \"\"}`,\n    );\n    return;\n  }\n\n  await writeFileSafely(npmrcPath, nextContent);\n  success(\n    `.npmrc updated (${additions.length} entr${additions.length === 1 ? \"y\" : \"ies\"} added${\n      npmToken ? `, token ${mask(npmToken)}` : \"\"\n    })`,\n  );\n\n  await ensureYarnrcYml(context, registryUrl, scopes, npmToken);\n}\n\nfunction toRegistryHost(registryUrl: string): string {\n  try {\n    const url = new URL(registryUrl);\n    const path = url.pathname.endsWith(\"/\") ? url.pathname.slice(1) : `${url.pathname.slice(1)}/`;\n    return `${url.host}/${path}`;\n  } catch {\n    return registryUrl.replace(/^https?:\\/\\//, \"\").replace(/\\/?$/, \"/\");\n  }\n}\n\nfunction buildContent(existing: string, additions: string[]): string {\n  let content = existing.trimEnd();\n  if (content.length > 0 && !content.endsWith(\"\\n\")) {\n    content += \"\\n\";\n  } else if (content.length > 0) {\n    // keep as is\n  }\n  content += additions.join(\"\\n\");\n  if (!content.endsWith(\"\\n\")) {\n    content += \"\\n\";\n  }\n  return content;\n}\n\ntype YarnScopeConfig = {\n  npmRegistryServer: string;\n  npmAuthToken?: string;\n  npmAlwaysAuth?: boolean;\n};\n\nasync function ensureYarnrcYml(\n  context: CliContext,\n  registryUrl: string,\n  scopes: string[],\n  npmToken?: string,\n) {\n  const yarnrcPath = path.join(context.root, \".yarnrc.yml\");\n  const existingContent = (await readFileIfExists(yarnrcPath)) ?? \"\";\n  let doc: Record<string, unknown> = existingContent\n    ? (YAML.parse(existingContent) as Record<string, unknown>)\n    : {};\n  if (!doc || typeof doc !== \"object\") doc = {};\n\n  const npmScopes = (doc.npmScopes as Record<string, YarnScopeConfig>) ?? {};\n  doc.npmScopes = npmScopes;\n\n  let changed = false;\n\n  scopes\n    .map((s) => s.replace(/^@/, \"\"))\n    .filter((s) => s.length > 0)\n    .forEach((scope) => {\n      const current = npmScopes[scope] || {};\n      const desired: YarnScopeConfig = {\n        npmRegistryServer: registryUrl,\n      };\n      if (npmToken) {\n        desired.npmAuthToken = npmToken;\n        desired.npmAlwaysAuth = true;\n      }\n\n      const next = { ...current, ...desired };\n      if (JSON.stringify(current) !== JSON.stringify(next)) {\n        npmScopes[scope] = next;\n        changed = true;\n      }\n    });\n\n  if (!changed) {\n    if (context.dryRun) {\n      dryRun(\".yarnrc.yml already contains required scope registry settings\");\n    } else {\n      success(\".yarnrc.yml already contains required scope registry settings\");\n    }\n    return;\n  }\n\n  const yamlOut = YAML.stringify(doc).trimEnd() + \"\\n\";\n  if (context.dryRun) {\n    dryRun(\"Would update .yarnrc.yml with scope registry/token configuration\");\n    return;\n  }\n\n  await writeFileSafely(yarnrcPath, yamlOut);\n  success(\n    `.yarnrc.yml updated for scopes ${scopes.join(\", \")}${npmToken ? ` (token ${mask(npmToken)})` : \"\"}`,\n  );\n}\n"]}

package/dist/steps/installPackages.d.ts

@@ -0,0 +1,2 @@
+import { CliContext } from "../types";
+export declare function installPackages(context: CliContext): Promise<void>;

package/dist/steps/installPackages.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installPackages = installPackages;
+const path_1 = __importDefault(require("path"));
+const exec_1 = require("../utils/exec");
+const log_1 = require("../utils/log");
+async function installPackages(context) {
+    const appDir = path_1.default.join(context.root, "packages", "app");
+    const backendDir = path_1.default.join(context.root, "packages", "backend");
+    (0, log_1.step)("Installing frontend plugin @dx-labs/plugin-template-designer-pro");
+    await (0, exec_1.runCommand)("yarn", ["--cwd", appDir, "add", "@dx-labs/plugin-template-designer-pro"], {
+        dryRun: context.dryRun,
+    });
+    (0, log_1.step)("Installing backend plugin @dx-labs/plugin-license-box");
+    await (0, exec_1.runCommand)("yarn", ["--cwd", backendDir, "add", "@dx-labs/plugin-license-box"], {
+        dryRun: context.dryRun,
+    });
+    (0, log_1.success)("Dependencies ensured");
+}
+//# sourceMappingURL=installPackages.js.map

package/dist/steps/installPackages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installPackages.js","sourceRoot":"","sources":["../../src/steps/installPackages.ts"],"names":[],"mappings":";;;;;AAKA,0CAeC;AApBD,gDAAwB;AAExB,wCAA2C;AAC3C,sCAA6C;AAEtC,KAAK,UAAU,eAAe,CAAC,OAAmB;IACvD,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAElE,IAAA,UAAI,EAAC,kEAAkE,CAAC,CAAC;IACzE,MAAM,IAAA,iBAAU,EAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,uCAAuC,CAAC,EAAE;QAC1F,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,IAAA,UAAI,EAAC,uDAAuD,CAAC,CAAC;IAC9D,MAAM,IAAA,iBAAU,EAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,6BAA6B,CAAC,EAAE;QACpF,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,IAAA,aAAO,EAAC,sBAAsB,CAAC,CAAC;AAClC,CAAC","sourcesContent":["import path from \"path\";\nimport { CliContext } from \"../types\";\nimport { runCommand } from \"../utils/exec\";\nimport { success, step } from \"../utils/log\";\n\nexport async function installPackages(context: CliContext) {\n  const appDir = path.join(context.root, \"packages\", \"app\");\n  const backendDir = path.join(context.root, \"packages\", \"backend\");\n\n  step(\"Installing frontend plugin @dx-labs/plugin-template-designer-pro\");\n  await runCommand(\"yarn\", [\"--cwd\", appDir, \"add\", \"@dx-labs/plugin-template-designer-pro\"], {\n    dryRun: context.dryRun,\n  });\n\n  step(\"Installing backend plugin @dx-labs/plugin-license-box\");\n  await runCommand(\"yarn\", [\"--cwd\", backendDir, \"add\", \"@dx-labs/plugin-license-box\"], {\n    dryRun: context.dryRun,\n  });\n\n  success(\"Dependencies ensured\");\n}\n"]}

package/dist/steps/patchAppConfig.d.ts

@@ -0,0 +1,2 @@
+import { CliContext } from "../types";
+export declare function patchAppConfig(context: CliContext): Promise<void>;

package/dist/steps/patchAppConfig.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patchAppConfig = patchAppConfig;
+const path_1 = __importDefault(require("path"));
+const yaml_1 = __importDefault(require("yaml"));
+const fs_1 = require("../utils/fs");
+const log_1 = require("../utils/log");
+const yaml_2 = require("../utils/yaml");
+async function patchAppConfig(context) {
+    const targetConfig = context.configPath;
+    if (!(await (0, fs_1.fileExists)(targetConfig))) {
+        throw new Error(`Config file not found at ${targetConfig}`);
+    }
+    (0, log_1.step)(`Updating ${path_1.default.relative(context.root, targetConfig)} with license key`);
+    const existing = (await (0, yaml_2.readYamlFile)(targetConfig)) ?? {};
+    const before = yaml_1.default.stringify(existing);
+    const updated = JSON.parse(JSON.stringify(existing));
+    const dxLicenseBox = updated.dxLicenseBox ?? {};
+    const license = dxLicenseBox.license ?? {};
+    license.key = context.licenseId;
+    dxLicenseBox.license = license;
+    updated.dxLicenseBox = dxLicenseBox;
+    const after = yaml_1.default.stringify(updated);
+    const changed = before !== after;
+    if (context.dryRun) {
+        (0, log_1.dryRun)(changed
+            ? `Would write license key to ${path_1.default.relative(context.root, targetConfig)}`
+            : `No changes needed in ${path_1.default.relative(context.root, targetConfig)}`);
+        return;
+    }
+    if (changed) {
+        await (0, yaml_2.writeYamlFile)(targetConfig, updated);
+        (0, log_1.success)(`Wrote license key to ${path_1.default.relative(context.root, targetConfig)}`);
+    }
+    else {
+        (0, log_1.success)(`License key already present in ${path_1.default.relative(context.root, targetConfig)}`);
+    }
+}
+//# sourceMappingURL=patchAppConfig.js.map

package/dist/steps/patchAppConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchAppConfig.js","sourceRoot":"","sources":["../../src/steps/patchAppConfig.ts"],"names":[],"mappings":";;;;;AAOA,wCAqCC;AA5CD,gDAAwB;AACxB,gDAAwB;AAExB,oCAAyC;AACzC,sCAAqD;AACrD,wCAA4D;AAErD,KAAK,UAAU,cAAc,CAAC,OAAmB;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAExC,IAAI,CAAC,CAAC,MAAM,IAAA,eAAU,EAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAA,UAAI,EAAC,YAAY,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAE/E,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAA,mBAAY,EAA0B,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;IACnF,MAAM,MAAM,GAAG,cAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAA4B,CAAC;IAEhF,MAAM,YAAY,GAAI,OAAO,CAAC,YAAwC,IAAI,EAAE,CAAC;IAC7E,MAAM,OAAO,GAAI,YAAY,CAAC,OAAmC,IAAI,EAAE,CAAC;IACxE,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC;IAChC,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC;IAC/B,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IAEpC,MAAM,KAAK,GAAG,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC;IAEjC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,IAAA,YAAM,EACJ,OAAO;YACL,CAAC,CAAC,8BAA8B,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE;YAC3E,CAAC,CAAC,wBAAwB,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CACxE,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAA,oBAAa,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAA,aAAO,EAAC,wBAAwB,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,IAAA,aAAO,EAAC,kCAAkC,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC","sourcesContent":["import path from \"path\";\nimport YAML from \"yaml\";\nimport { CliContext } from \"../types\";\nimport { fileExists } from \"../utils/fs\";\nimport { dryRun, success, step } from \"../utils/log\";\nimport { readYamlFile, writeYamlFile } from \"../utils/yaml\";\n\nexport async function patchAppConfig(context: CliContext) {\n  const targetConfig = context.configPath;\n\n  if (!(await fileExists(targetConfig))) {\n    throw new Error(`Config file not found at ${targetConfig}`);\n  }\n\n  step(`Updating ${path.relative(context.root, targetConfig)} with license key`);\n\n  const existing = (await readYamlFile<Record<string, unknown>>(targetConfig)) ?? {};\n  const before = YAML.stringify(existing);\n  const updated = JSON.parse(JSON.stringify(existing)) as Record<string, unknown>;\n\n  const dxLicenseBox = (updated.dxLicenseBox as Record<string, unknown>) ?? {};\n  const license = (dxLicenseBox.license as Record<string, unknown>) ?? {};\n  license.key = context.licenseId;\n  dxLicenseBox.license = license;\n  updated.dxLicenseBox = dxLicenseBox;\n\n  const after = YAML.stringify(updated);\n  const changed = before !== after;\n\n  if (context.dryRun) {\n    dryRun(\n      changed\n        ? `Would write license key to ${path.relative(context.root, targetConfig)}`\n        : `No changes needed in ${path.relative(context.root, targetConfig)}`,\n    );\n    return;\n  }\n\n  if (changed) {\n    await writeYamlFile(targetConfig, updated);\n    success(`Wrote license key to ${path.relative(context.root, targetConfig)}`);\n  } else {\n    success(`License key already present in ${path.relative(context.root, targetConfig)}`);\n  }\n}\n"]}

package/dist/steps/patchAppTsx.d.ts

@@ -0,0 +1,2 @@
+import { CliContext } from "../types";
+export declare function patchAppTsx(context: CliContext): Promise<void>;

package/dist/steps/patchAppTsx.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patchAppTsx = patchAppTsx;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("../utils/fs");
+const ast_1 = require("../utils/ast");
+const log_1 = require("../utils/log");
+const ts_morph_1 = require("ts-morph");
+const ROUTE_PATH = "/template-designer";
+const ROUTE_SNIPPET = `<Route path="${ROUTE_PATH}" element={<TemplateDesignerProPage />} />`;
+const IMPORT_NAME = "TemplateDesignerProPage";
+const IMPORT_SOURCE = "@dx-labs/plugin-template-designer-pro";
+async function patchAppTsx(context) {
+    const appTsxPath = path_1.default.join(context.root, "packages", "app", "src", "App.tsx");
+    if (!(await (0, fs_1.fileExists)(appTsxPath))) {
+        throw new Error(`Could not find App.tsx at ${appTsxPath}`);
+    }
+    (0, log_1.step)("Patching packages/app/src/App.tsx");
+    const { sourceFile } = (0, ast_1.loadSourceFile)(appTsxPath);
+    const importsChanged = (0, ast_1.ensureNamedImport)(sourceFile, IMPORT_NAME, IMPORT_SOURCE);
+    const flatRoutes = (0, ast_1.findJsxElements)(sourceFile, "FlatRoutes");
+    const targetFlatRoutes = flatRoutes.find((el) => el.getDescendants().some((child) => child.getKindName().includes("Route"))) || flatRoutes[0];
+    if (!targetFlatRoutes) {
+        throw new Error("Could not locate <FlatRoutes> in App.tsx. Please add the route manually and rerun.");
+    }
+    const descendantRoutes = [
+        ...targetFlatRoutes.getDescendantsOfKind(ts_morph_1.SyntaxKind.JsxElement),
+        ...targetFlatRoutes.getDescendantsOfKind(ts_morph_1.SyntaxKind.JsxSelfClosingElement),
+    ].filter((node) => {
+        const tagName = node.getKind() === ts_morph_1.SyntaxKind.JsxElement
+            ? node.getOpeningElement().getTagNameNode().getText()
+            : node.getTagNameNode().getText();
+        return tagName === "Route";
+    });
+    const existingRoute = descendantRoutes.some((route) => (0, ast_1.hasJsxAttribute)(route, "path", (value) => value === ROUTE_PATH));
+    let routeAdded = false;
+    if (!existingRoute) {
+        const closing = targetFlatRoutes.getClosingElement();
+        if (!closing) {
+            throw new Error("FlatRoutes element is not well-formed (missing closing tag).");
+        }
+        const insertion = `\n    ${ROUTE_SNIPPET}\n  `;
+        sourceFile.insertText(closing.getStart(), insertion);
+        routeAdded = true;
+    }
+    if (context.dryRun) {
+        (0, log_1.dryRun)(importsChanged || routeAdded
+            ? "Would update App.tsx with Template Designer import and route"
+            : "No changes needed in App.tsx");
+        return;
+    }
+    if (importsChanged || routeAdded) {
+        await sourceFile.save();
+        (0, log_1.success)("Updated App.tsx with Template Designer route");
+    }
+    else {
+        (0, log_1.success)("App.tsx already has Template Designer route");
+    }
+}
+//# sourceMappingURL=patchAppTsx.js.map

package/dist/steps/patchAppTsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchAppTsx.js","sourceRoot":"","sources":["../../src/steps/patchAppTsx.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"path\";\nimport { CliContext } from \"../types\";\nimport { fileExists } from \"../utils/fs\";\nimport { findJsxElements, hasJsxAttribute, ensureNamedImport, loadSourceFile } from \"../utils/ast\";\nimport { dryRun, success, step } from \"../utils/log\";\nimport { SyntaxKind, JsxElement, JsxSelfClosingElement } from \"ts-morph\";\n\nconst ROUTE_PATH = \"/template-designer\";\nconst ROUTE_SNIPPET = `<Route path=\"${ROUTE_PATH}\" element={<TemplateDesignerProPage />} />`;\nconst IMPORT_NAME = \"TemplateDesignerProPage\";\nconst IMPORT_SOURCE = \"@dx-labs/plugin-template-designer-pro\";\n\nexport async function patchAppTsx(context: CliContext) {\n  const appTsxPath = path.join(context.root, \"packages\", \"app\", \"src\", \"App.tsx\");\n  if (!(await fileExists(appTsxPath))) {\n    throw new Error(`Could not find App.tsx at ${appTsxPath}`);\n  }\n\n  step(\"Patching packages/app/src/App.tsx\");\n  const { sourceFile } = loadSourceFile(appTsxPath);\n\n  const importsChanged = ensureNamedImport(sourceFile, IMPORT_NAME, IMPORT_SOURCE);\n  const flatRoutes = findJsxElements(sourceFile, \"FlatRoutes\");\n\n  const targetFlatRoutes =\n    flatRoutes.find((el) =>\n      el.getDescendants().some((child) => child.getKindName().includes(\"Route\")),\n    ) || flatRoutes[0];\n\n  if (!targetFlatRoutes) {\n    throw new Error(\n      \"Could not locate <FlatRoutes> in App.tsx. Please add the route manually and rerun.\",\n    );\n  }\n\n  const descendantRoutes: Array<JsxElement | JsxSelfClosingElement> = [\n    ...targetFlatRoutes.getDescendantsOfKind(SyntaxKind.JsxElement),\n    ...targetFlatRoutes.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement),\n  ].filter((node) => {\n    const tagName =\n      node.getKind() === SyntaxKind.JsxElement\n        ? (node as JsxElement).getOpeningElement().getTagNameNode().getText()\n        : (node as JsxSelfClosingElement).getTagNameNode().getText();\n    return tagName === \"Route\";\n  });\n\n  const existingRoute = descendantRoutes.some((route) =>\n    hasJsxAttribute(route, \"path\", (value) => value === ROUTE_PATH),\n  );\n\n  let routeAdded = false;\n  if (!existingRoute) {\n    const closing = targetFlatRoutes.getClosingElement();\n    if (!closing) {\n      throw new Error(\"FlatRoutes element is not well-formed (missing closing tag).\");\n    }\n    const insertion = `\\n    ${ROUTE_SNIPPET}\\n  `;\n    sourceFile.insertText(closing.getStart(), insertion);\n    routeAdded = true;\n  }\n\n  if (context.dryRun) {\n    dryRun(\n      importsChanged || routeAdded\n        ? \"Would update App.tsx with Template Designer import and route\"\n        : \"No changes needed in App.tsx\",\n    );\n    return;\n  }\n\n  if (importsChanged || routeAdded) {\n    await sourceFile.save();\n    success(\"Updated App.tsx with Template Designer route\");\n  } else {\n    success(\"App.tsx already has Template Designer route\");\n  }\n}\n"]}

package/dist/steps/patchBackendIndex.d.ts

@@ -0,0 +1,2 @@
+import { CliContext } from "../types";
+export declare function patchBackendIndex(context: CliContext): Promise<void>;

package/dist/steps/patchBackendIndex.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patchBackendIndex = patchBackendIndex;
+const path_1 = __importDefault(require("path"));
+const ts_morph_1 = require("ts-morph");
+const fs_1 = require("../utils/fs");
+const ast_1 = require("../utils/ast");
+const log_1 = require("../utils/log");
+const DYNAMIC_IMPORT = "@dx-labs/plugin-license-box";
+async function patchBackendIndex(context) {
+    const backendIndexPath = path_1.default.join(context.root, "packages", "backend", "src", "index.ts");
+    if (!(await (0, fs_1.fileExists)(backendIndexPath))) {
+        throw new Error(`Could not find backend index at ${backendIndexPath}`);
+    }
+    (0, log_1.step)("Patching packages/backend/src/index.ts");
+    const { sourceFile } = (0, ast_1.loadSourceFile)(backendIndexPath);
+    const backendAdds = sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.CallExpression).filter((call) => {
+        const expr = call.getExpression();
+        return expr.getText() === "backend.add";
+    });
+    const alreadyPresent = backendAdds.some((call) => call.getText().includes(DYNAMIC_IMPORT));
+    if (alreadyPresent) {
+        if (context.dryRun) {
+            (0, log_1.dryRun)("Backend already adds plugin-license-box");
+        }
+        else {
+            (0, log_1.success)("Backend already adds plugin-license-box");
+        }
+        return;
+    }
+    const insertionTarget = backendAdds[backendAdds.length - 1];
+    const insertionText = `backend.add(import('${DYNAMIC_IMPORT}'));`;
+    const startCall = sourceFile
+        .getDescendantsOfKind(ts_morph_1.SyntaxKind.CallExpression)
+        .find((call) => call.getExpression().getText() === "backend.start");
+    const targetStatement = startCall?.getFirstAncestorByKind(ts_morph_1.SyntaxKind.ExpressionStatement);
+    if (!targetStatement) {
+        // Fallback: use previous logic
+        if (!insertionTarget) {
+            const appendText = `\nbackend.add(import('${DYNAMIC_IMPORT}'));\n`;
+            if (context.dryRun) {
+                (0, log_1.dryRun)("Would append backend.add(import('@dx-labs/plugin-license-box')) to backend index");
+                return;
+            }
+            sourceFile.addStatements(appendText);
+        }
+        else {
+            const stmt = insertionTarget.getFirstAncestorByKind(ts_morph_1.SyntaxKind.ExpressionStatement);
+            const block = stmt?.getParentIfKind(ts_morph_1.SyntaxKind.Block);
+            if (context.dryRun) {
+                (0, log_1.dryRun)("Would insert backend.add(import('@dx-labs/plugin-license-box'))");
+                return;
+            }
+            if (stmt && block) {
+                const statements = block.getStatements();
+                const idx = statements.indexOf(stmt);
+                block.insertStatements(idx + 1, insertionText);
+            }
+            else {
+                sourceFile.addStatements(`\n${insertionText}\n`);
+            }
+        }
+    }
+    else {
+        // Insert before backend.start();
+        if (context.dryRun) {
+            (0, log_1.dryRun)("Would insert backend.add(import('@dx-labs/plugin-license-box')) before backend.start()");
+            return;
+        }
+        const block = targetStatement.getParentIfKind(ts_morph_1.SyntaxKind.Block);
+        if (block) {
+            const statements = block.getStatements();
+            const idx = statements.indexOf(targetStatement);
+            block.insertStatements(idx, `${insertionText}\n`);
+        }
+        else {
+            // As a fallback, insert text directly before the start call statement
+            sourceFile.insertText(targetStatement.getStart(), `${insertionText}\n`);
+        }
+    }
+    if (context.dryRun)
+        return;
+    await sourceFile.save();
+    (0, log_1.success)("Added backend.add(import('@dx-labs/plugin-license-box')) to backend");
+}
+//# sourceMappingURL=patchBackendIndex.js.map

package/dist/steps/patchBackendIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchBackendIndex.js","sourceRoot":"","sources":["../../src/steps/patchBackendIndex.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"path\";\nimport { SyntaxKind } from \"ts-morph\";\nimport { CliContext } from \"../types\";\nimport { fileExists } from \"../utils/fs\";\nimport { loadSourceFile } from \"../utils/ast\";\nimport { dryRun, success, step } from \"../utils/log\";\n\nconst DYNAMIC_IMPORT = \"@dx-labs/plugin-license-box\";\n\nexport async function patchBackendIndex(context: CliContext) {\n  const backendIndexPath = path.join(context.root, \"packages\", \"backend\", \"src\", \"index.ts\");\n  if (!(await fileExists(backendIndexPath))) {\n    throw new Error(`Could not find backend index at ${backendIndexPath}`);\n  }\n\n  step(\"Patching packages/backend/src/index.ts\");\n  const { sourceFile } = loadSourceFile(backendIndexPath);\n\n  const backendAdds = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).filter((call) => {\n    const expr = call.getExpression();\n    return expr.getText() === \"backend.add\";\n  });\n\n  const alreadyPresent = backendAdds.some((call) => call.getText().includes(DYNAMIC_IMPORT));\n\n  if (alreadyPresent) {\n    if (context.dryRun) {\n      dryRun(\"Backend already adds plugin-license-box\");\n    } else {\n      success(\"Backend already adds plugin-license-box\");\n    }\n    return;\n  }\n\n  const insertionTarget = backendAdds[backendAdds.length - 1];\n  const insertionText = `backend.add(import('${DYNAMIC_IMPORT}'));`;\n\n  const startCall = sourceFile\n    .getDescendantsOfKind(SyntaxKind.CallExpression)\n    .find((call) => call.getExpression().getText() === \"backend.start\");\n\n  const targetStatement = startCall?.getFirstAncestorByKind(SyntaxKind.ExpressionStatement);\n\n  if (!targetStatement) {\n    // Fallback: use previous logic\n    if (!insertionTarget) {\n      const appendText = `\\nbackend.add(import('${DYNAMIC_IMPORT}'));\\n`;\n      if (context.dryRun) {\n        dryRun(\"Would append backend.add(import('@dx-labs/plugin-license-box')) to backend index\");\n        return;\n      }\n      sourceFile.addStatements(appendText);\n    } else {\n      const stmt = insertionTarget.getFirstAncestorByKind(SyntaxKind.ExpressionStatement);\n      const block = stmt?.getParentIfKind(SyntaxKind.Block);\n\n      if (context.dryRun) {\n        dryRun(\"Would insert backend.add(import('@dx-labs/plugin-license-box'))\");\n        return;\n      }\n\n      if (stmt && block) {\n        const statements = block.getStatements();\n        const idx = statements.indexOf(stmt);\n        block.insertStatements(idx + 1, insertionText);\n      } else {\n        sourceFile.addStatements(`\\n${insertionText}\\n`);\n      }\n    }\n  } else {\n    // Insert before backend.start();\n    if (context.dryRun) {\n      dryRun(\n        \"Would insert backend.add(import('@dx-labs/plugin-license-box')) before backend.start()\",\n      );\n      return;\n    }\n    const block = targetStatement.getParentIfKind(SyntaxKind.Block);\n    if (block) {\n      const statements = block.getStatements();\n      const idx = statements.indexOf(targetStatement);\n      block.insertStatements(idx, `${insertionText}\\n`);\n    } else {\n      // As a fallback, insert text directly before the start call statement\n      sourceFile.insertText(targetStatement.getStart(), `${insertionText}\\n`);\n    }\n  }\n\n  if (context.dryRun) return;\n\n  await sourceFile.save();\n  success(\"Added backend.add(import('@dx-labs/plugin-license-box')) to backend\");\n}\n"]}

package/dist/steps/patchRootTsx.d.ts

@@ -0,0 +1,2 @@
+import { CliContext } from "../types";
+export declare function patchRootTsx(context: CliContext): Promise<void>;

package/dist/steps/patchRootTsx.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patchRootTsx = patchRootTsx;
+const path_1 = __importDefault(require("path"));
+const ts_morph_1 = require("ts-morph");
+const fs_1 = require("../utils/fs");
+const ast_1 = require("../utils/ast");
+const log_1 = require("../utils/log");
+const ITEM_SNIPPET = '<SidebarItem icon={TemplateDesignerIcon} to="template-designer" text="Template Designer" />';
+const ICON_IMPORT = "TemplateDesignerIcon";
+const ICON_SOURCE = "@dx-labs/plugin-template-designer-pro";
+const SIDEBAR_ITEM_IMPORT = "SidebarItem";
+const SIDEBAR_ITEM_SOURCE = "@backstage/core-components";
+async function patchRootTsx(context) {
+    const rootTsxPath = path_1.default.join(context.root, "packages", "app", "src", "components", "Root", "Root.tsx");
+    if (!(await (0, fs_1.fileExists)(rootTsxPath))) {
+        throw new Error(`Could not find Root.tsx at ${rootTsxPath}`);
+    }
+    (0, log_1.step)("Patching packages/app/src/components/Root/Root.tsx");
+    const { sourceFile } = (0, ast_1.loadSourceFile)(rootTsxPath);
+    const sidebarItemImportChanged = (0, ast_1.ensureNamedImport)(sourceFile, SIDEBAR_ITEM_IMPORT, SIDEBAR_ITEM_SOURCE);
+    const iconImportChanged = (0, ast_1.ensureNamedImport)(sourceFile, ICON_IMPORT, ICON_SOURCE);
+    const importsChanged = sidebarItemImportChanged || iconImportChanged;
+    const sidebarItems = [
+        ...sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.JsxElement),
+        ...sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.JsxSelfClosingElement),
+    ].filter((node) => {
+        const tagName = node.getKind() === ts_morph_1.SyntaxKind.JsxElement
+            ? node.getOpeningElement().getTagNameNode().getText()
+            : node.getTagNameNode().getText();
+        return tagName === "SidebarItem";
+    });
+    const existingItem = sidebarItems.some((item) => (0, ast_1.hasJsxAttribute)(item, "to", (value) => value.includes("template-designer")) ||
+        (0, ast_1.hasJsxAttribute)(item, "text", (value) => value.toLowerCase().includes("template designer")));
+    let itemAdded = false;
+    if (!existingItem) {
+        const sidebarGroups = (0, ast_1.findJsxElements)(sourceFile, "SidebarGroup");
+        const menuGroup = sidebarGroups.find((group) => (0, ast_1.hasJsxAttribute)(group, "label", (value) => value.toLowerCase().includes("menu"))) ||
+            sidebarGroups.find((group) => group.getJsxChildren().some((child) => child.getText().includes("SidebarItem"))) ||
+            sidebarGroups[0];
+        const sidebar = (0, ast_1.findJsxElements)(sourceFile, "Sidebar")[0];
+        const targetContainer = menuGroup || sidebar;
+        if (!targetContainer) {
+            throw new Error("Could not find a Sidebar or SidebarGroup in Root.tsx. Add the sidebar item manually and rerun.");
+        }
+        const closing = targetContainer.getClosingElement();
+        if (!closing) {
+            throw new Error("Sidebar container is not well-formed (missing closing tag).");
+        }
+        const baseIndent = sourceFile.getIndentationText() ?? "  ";
+        const insertion = `\n${baseIndent}${ITEM_SNIPPET}\n`;
+        sourceFile.insertText(closing.getStart(), insertion);
+        itemAdded = true;
+    }
+    if (context.dryRun) {
+        (0, log_1.dryRun)(importsChanged || itemAdded
+            ? "Would update Root.tsx with Template Designer sidebar link"
+            : "No changes needed in Root.tsx");
+        return;
+    }
+    if (importsChanged || itemAdded) {
+        await sourceFile.save();
+        (0, log_1.success)("Updated Root.tsx with Template Designer sidebar item");
+    }
+    else {
+        (0, log_1.success)("Root.tsx already has Template Designer sidebar item");
+    }
+}
+//# sourceMappingURL=patchRootTsx.js.map

package/dist/steps/patchRootTsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchRootTsx.js","sourceRoot":"","sources":["../../src/steps/patchRootTsx.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"path\";\nimport { SyntaxKind, JsxElement, JsxSelfClosingElement } from \"ts-morph\";\nimport { CliContext } from \"../types\";\nimport { fileExists } from \"../utils/fs\";\nimport { ensureNamedImport, findJsxElements, hasJsxAttribute, loadSourceFile } from \"../utils/ast\";\nimport { dryRun, success, step } from \"../utils/log\";\n\nconst ITEM_SNIPPET =\n  '<SidebarItem icon={TemplateDesignerIcon} to=\"template-designer\" text=\"Template Designer\" />';\nconst ICON_IMPORT = \"TemplateDesignerIcon\";\nconst ICON_SOURCE = \"@dx-labs/plugin-template-designer-pro\";\nconst SIDEBAR_ITEM_IMPORT = \"SidebarItem\";\nconst SIDEBAR_ITEM_SOURCE = \"@backstage/core-components\";\n\nexport async function patchRootTsx(context: CliContext) {\n  const rootTsxPath = path.join(\n    context.root,\n    \"packages\",\n    \"app\",\n    \"src\",\n    \"components\",\n    \"Root\",\n    \"Root.tsx\",\n  );\n  if (!(await fileExists(rootTsxPath))) {\n    throw new Error(`Could not find Root.tsx at ${rootTsxPath}`);\n  }\n\n  step(\"Patching packages/app/src/components/Root/Root.tsx\");\n  const { sourceFile } = loadSourceFile(rootTsxPath);\n\n  const sidebarItemImportChanged = ensureNamedImport(\n    sourceFile,\n    SIDEBAR_ITEM_IMPORT,\n    SIDEBAR_ITEM_SOURCE,\n  );\n  const iconImportChanged = ensureNamedImport(sourceFile, ICON_IMPORT, ICON_SOURCE);\n  const importsChanged = sidebarItemImportChanged || iconImportChanged;\n\n  const sidebarItems: Array<JsxElement | JsxSelfClosingElement> = [\n    ...sourceFile.getDescendantsOfKind(SyntaxKind.JsxElement),\n    ...sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement),\n  ].filter((node) => {\n    const tagName =\n      node.getKind() === SyntaxKind.JsxElement\n        ? (node as JsxElement).getOpeningElement().getTagNameNode().getText()\n        : (node as JsxSelfClosingElement).getTagNameNode().getText();\n    return tagName === \"SidebarItem\";\n  });\n\n  const existingItem = sidebarItems.some(\n    (item) =>\n      hasJsxAttribute(item, \"to\", (value) => value.includes(\"template-designer\")) ||\n      hasJsxAttribute(item, \"text\", (value) => value.toLowerCase().includes(\"template designer\")),\n  );\n\n  let itemAdded = false;\n  if (!existingItem) {\n    const sidebarGroups = findJsxElements(sourceFile, \"SidebarGroup\");\n    const menuGroup =\n      sidebarGroups.find((group) =>\n        hasJsxAttribute(group, \"label\", (value) => value.toLowerCase().includes(\"menu\")),\n      ) ||\n      sidebarGroups.find((group) =>\n        group.getJsxChildren().some((child) => child.getText().includes(\"SidebarItem\")),\n      ) ||\n      sidebarGroups[0];\n\n    const sidebar = findJsxElements(sourceFile, \"Sidebar\")[0];\n\n    const targetContainer = menuGroup || sidebar;\n\n    if (!targetContainer) {\n      throw new Error(\n        \"Could not find a Sidebar or SidebarGroup in Root.tsx. Add the sidebar item manually and rerun.\",\n      );\n    }\n\n    const closing = targetContainer.getClosingElement();\n    if (!closing) {\n      throw new Error(\"Sidebar container is not well-formed (missing closing tag).\");\n    }\n    const baseIndent = sourceFile.getIndentationText() ?? \"  \";\n    const insertion = `\\n${baseIndent}${ITEM_SNIPPET}\\n`;\n    sourceFile.insertText(closing.getStart(), insertion);\n    itemAdded = true;\n  }\n\n  if (context.dryRun) {\n    dryRun(\n      importsChanged || itemAdded\n        ? \"Would update Root.tsx with Template Designer sidebar link\"\n        : \"No changes needed in Root.tsx\",\n    );\n    return;\n  }\n\n  if (importsChanged || itemAdded) {\n    await sourceFile.save();\n    success(\"Updated Root.tsx with Template Designer sidebar item\");\n  } else {\n    success(\"Root.tsx already has Template Designer sidebar item\");\n  }\n}\n"]}

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+export type CliContext = {
+    root: string;
+    dryRun: boolean;
+    skipInstall: boolean;
+    licenseId: string;
+    npmToken?: string;
+    registryUrl: string;
+    scopes: string[];
+    configPath: string;
+};

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export type CliContext = {\n  root: string;\n  dryRun: boolean;\n  skipInstall: boolean;\n  licenseId: string;\n  npmToken?: string;\n  registryUrl: string;\n  scopes: string[];\n  configPath: string;\n};\n"]}

package/dist/utils/ast.d.ts

@@ -0,0 +1,9 @@
+import { JsxElement, JsxSelfClosingElement, Project, SourceFile } from "ts-morph";
+export declare function loadSourceFile(filePath: string): {
+    project: Project;
+    sourceFile: SourceFile;
+};
+export declare function ensureNamedImport(sourceFile: SourceFile, imported: string, moduleSpecifier: string): boolean;
+export declare function findJsxElements(sourceFile: SourceFile, tagName: string): JsxElement[];
+export declare function findJsxSelfClosingElements(sourceFile: SourceFile, tagName: string): JsxSelfClosingElement[];
+export declare function hasJsxAttribute(element: JsxElement | JsxSelfClosingElement, attributeName: string, predicate?: (value: string) => boolean): boolean;

package/dist/utils/ast.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSourceFile = loadSourceFile;
+exports.ensureNamedImport = ensureNamedImport;
+exports.findJsxElements = findJsxElements;
+exports.findJsxSelfClosingElements = findJsxSelfClosingElements;
+exports.hasJsxAttribute = hasJsxAttribute;
+const ts_morph_1 = require("ts-morph");
+function loadSourceFile(filePath) {
+    const project = new ts_morph_1.Project({
+        manipulationSettings: {
+            quoteKind: ts_morph_1.QuoteKind.Double,
+            useTrailingCommas: true,
+            indentationText: ts_morph_1.IndentationText.TwoSpaces,
+        },
+    });
+    const sourceFile = project.addSourceFileAtPath(filePath);
+    return { project, sourceFile };
+}
+function ensureNamedImport(sourceFile, imported, moduleSpecifier) {
+    const existing = sourceFile.getImportDeclaration((d) => d.getModuleSpecifierValue() === moduleSpecifier);
+    if (existing) {
+        const hasImport = existing.getNamedImports().some((i) => i.getName() === imported);
+        if (hasImport)
+            return false;
+        existing.addNamedImport(imported);
+        return true;
+    }
+    sourceFile.addImportDeclaration({
+        namedImports: [imported],
+        moduleSpecifier,
+    });
+    return true;
+}
+function findJsxElements(sourceFile, tagName) {
+    return sourceFile
+        .getDescendantsOfKind(ts_morph_1.SyntaxKind.JsxElement)
+        .filter((el) => el.getOpeningElement().getTagNameNode().getText() === tagName);
+}
+function findJsxSelfClosingElements(sourceFile, tagName) {
+    return sourceFile
+        .getDescendantsOfKind(ts_morph_1.SyntaxKind.JsxSelfClosingElement)
+        .filter((el) => el.getTagNameNode().getText() === tagName);
+}
+function hasJsxAttribute(element, attributeName, predicate) {
+    const attributes = ts_morph_1.Node.isJsxElement(element)
+        ? element.getOpeningElement().getAttributes()
+        : element.getAttributes();
+    for (const attr of attributes) {
+        if (!ts_morph_1.Node.isJsxAttribute(attr))
+            continue;
+        const jsxAttr = attr;
+        const attrName = jsxAttr.getNameNode().getText();
+        if (attrName !== attributeName)
+            continue;
+        const init = jsxAttr.getInitializer();
+        if (!init)
+            return predicate ? predicate("") : true;
+        const text = init.getText().replace(/['"`{}]/g, "");
+        if (!predicate || predicate(text))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=ast.js.map

package/dist/utils/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/utils/ast.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  JsxElement,\n  JsxSelfClosingElement,\n  Project,\n  QuoteKind,\n  SourceFile,\n  SyntaxKind,\n  IndentationText,\n  Node,\n  JsxAttributeLike,\n  JsxAttribute,\n} from \"ts-morph\";\n\nexport function loadSourceFile(filePath: string): { project: Project; sourceFile: SourceFile } {\n  const project = new Project({\n    manipulationSettings: {\n      quoteKind: QuoteKind.Double,\n      useTrailingCommas: true,\n      indentationText: IndentationText.TwoSpaces,\n    },\n  });\n  const sourceFile = project.addSourceFileAtPath(filePath);\n  return { project, sourceFile };\n}\n\nexport function ensureNamedImport(\n  sourceFile: SourceFile,\n  imported: string,\n  moduleSpecifier: string,\n): boolean {\n  const existing = sourceFile.getImportDeclaration(\n    (d) => d.getModuleSpecifierValue() === moduleSpecifier,\n  );\n  if (existing) {\n    const hasImport = existing.getNamedImports().some((i) => i.getName() === imported);\n    if (hasImport) return false;\n    existing.addNamedImport(imported);\n    return true;\n  }\n\n  sourceFile.addImportDeclaration({\n    namedImports: [imported],\n    moduleSpecifier,\n  });\n  return true;\n}\n\nexport function findJsxElements(sourceFile: SourceFile, tagName: string): JsxElement[] {\n  return sourceFile\n    .getDescendantsOfKind(SyntaxKind.JsxElement)\n    .filter((el) => el.getOpeningElement().getTagNameNode().getText() === tagName);\n}\n\nexport function findJsxSelfClosingElements(\n  sourceFile: SourceFile,\n  tagName: string,\n): JsxSelfClosingElement[] {\n  return sourceFile\n    .getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)\n    .filter((el) => el.getTagNameNode().getText() === tagName);\n}\n\nexport function hasJsxAttribute(\n  element: JsxElement | JsxSelfClosingElement,\n  attributeName: string,\n  predicate?: (value: string) => boolean,\n): boolean {\n  const attributes: JsxAttributeLike[] = Node.isJsxElement(element)\n    ? element.getOpeningElement().getAttributes()\n    : element.getAttributes();\n\n  for (const attr of attributes) {\n    if (!Node.isJsxAttribute(attr)) continue;\n    const jsxAttr: JsxAttribute = attr;\n    const attrName = jsxAttr.getNameNode().getText();\n    if (attrName !== attributeName) continue;\n    const init = jsxAttr.getInitializer();\n    if (!init) return predicate ? predicate(\"\") : true;\n    const text = init.getText().replace(/['\"`{}]/g, \"\");\n    if (!predicate || predicate(text)) return true;\n  }\n  return false;\n}\n"]}

package/dist/utils/exec.d.ts

@@ -0,0 +1,7 @@
+type ExecOptions = {
+    cwd?: string;
+    dryRun?: boolean;
+    env?: Record<string, string | undefined>;
+};
+export declare function runCommand(command: string, args: string[], options?: ExecOptions): Promise<void>;
+export {};

package/dist/utils/exec.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCommand = runCommand;
+const execa_1 = __importDefault(require("execa"));
+const log_1 = require("./log");
+async function runCommand(command, args, options = {}) {
+    const display = `${command} ${args.join(" ")}`.trim();
+    if (options.dryRun) {
+        (0, log_1.dryRun)(`Would run: ${display}`);
+        return;
+    }
+    (0, log_1.info)(`Running: ${display}`);
+    await (0, execa_1.default)(command, args, {
+        cwd: options.cwd,
+        env: options.env,
+        stdio: "inherit",
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":";;;;;AASA,gCAiBC;AA1BD,kDAA0B;AAC1B,+BAAqC;AAQ9B,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,IAAc,EACd,UAAuB,EAAE;IAEzB,MAAM,OAAO,GAAG,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACtD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,IAAA,YAAM,EAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,IAAA,UAAI,EAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IAC5B,MAAM,IAAA,eAAK,EAAC,OAAO,EAAE,IAAI,EAAE;QACzB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import execa from \"execa\";\nimport { dryRun, info } from \"./log\";\n\ntype ExecOptions = {\n  cwd?: string;\n  dryRun?: boolean;\n  env?: Record<string, string | undefined>;\n};\n\nexport async function runCommand(\n  command: string,\n  args: string[],\n  options: ExecOptions = {},\n): Promise<void> {\n  const display = `${command} ${args.join(\" \")}`.trim();\n  if (options.dryRun) {\n    dryRun(`Would run: ${display}`);\n    return;\n  }\n\n  info(`Running: ${display}`);\n  await execa(command, args, {\n    cwd: options.cwd,\n    env: options.env,\n    stdio: \"inherit\",\n  });\n}\n"]}

package/dist/utils/fs.d.ts

@@ -0,0 +1,8 @@
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function readFileIfExists(filePath: string): Promise<string | undefined>;
+export declare function writeFileSafely(filePath: string, content: string, options?: {
+    dryRun?: boolean;
+}): Promise<boolean>;
+export declare function ensureFile(filePath: string, content: string, options?: {
+    dryRun?: boolean;
+}): Promise<boolean>;

package/dist/utils/fs.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileExists = fileExists;
+exports.readFileIfExists = readFileIfExists;
+exports.writeFileSafely = writeFileSafely;
+exports.ensureFile = ensureFile;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+async function fileExists(filePath) {
+    return fs_1.default.promises
+        .access(filePath, fs_1.default.constants.F_OK)
+        .then(() => true)
+        .catch(() => false);
+}
+async function readFileIfExists(filePath) {
+    if (!(await fileExists(filePath)))
+        return undefined;
+    return fs_1.default.promises.readFile(filePath, "utf8");
+}
+async function writeFileSafely(filePath, content, options = {}) {
+    const dir = path_1.default.dirname(filePath);
+    await fs_1.default.promises.mkdir(dir, { recursive: true });
+    const existing = await readFileIfExists(filePath);
+    if (existing !== undefined && existing === content) {
+        return false;
+    }
+    if (options.dryRun) {
+        return true;
+    }
+    await fs_1.default.promises.writeFile(filePath, content, "utf8");
+    return true;
+}
+async function ensureFile(filePath, content, options = {}) {
+    if (await fileExists(filePath)) {
+        return false;
+    }
+    if (options.dryRun) {
+        return true;
+    }
+    const dir = path_1.default.dirname(filePath);
+    await fs_1.default.promises.mkdir(dir, { recursive: true });
+    await fs_1.default.promises.writeFile(filePath, content, "utf8");
+    return true;
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":";;;;;AAGA,gCAKC;AAED,4CAGC;AAED,0CAmBC;AAED,gCAeC;AAnDD,4CAAoB;AACpB,gDAAwB;AAEjB,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,OAAO,YAAE,CAAC,QAAQ;SACf,MAAM,CAAC,QAAQ,EAAE,YAAE,CAAC,SAAS,CAAC,IAAI,CAAC;SACnC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAChD,CAAC;AAEM,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAe,EACf,UAAgC,EAAE;IAElC,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC;AACd,CAAC;AAEM,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,OAAe,EACf,UAAgC,EAAE;IAElC,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\n\nexport async function fileExists(filePath: string): Promise<boolean> {\n  return fs.promises\n    .access(filePath, fs.constants.F_OK)\n    .then(() => true)\n    .catch(() => false);\n}\n\nexport async function readFileIfExists(filePath: string): Promise<string | undefined> {\n  if (!(await fileExists(filePath))) return undefined;\n  return fs.promises.readFile(filePath, \"utf8\");\n}\n\nexport async function writeFileSafely(\n  filePath: string,\n  content: string,\n  options: { dryRun?: boolean } = {},\n): Promise<boolean> {\n  const dir = path.dirname(filePath);\n  await fs.promises.mkdir(dir, { recursive: true });\n\n  const existing = await readFileIfExists(filePath);\n  if (existing !== undefined && existing === content) {\n    return false;\n  }\n\n  if (options.dryRun) {\n    return true;\n  }\n\n  await fs.promises.writeFile(filePath, content, \"utf8\");\n  return true;\n}\n\nexport async function ensureFile(\n  filePath: string,\n  content: string,\n  options: { dryRun?: boolean } = {},\n): Promise<boolean> {\n  if (await fileExists(filePath)) {\n    return false;\n  }\n  if (options.dryRun) {\n    return true;\n  }\n  const dir = path.dirname(filePath);\n  await fs.promises.mkdir(dir, { recursive: true });\n  await fs.promises.writeFile(filePath, content, \"utf8\");\n  return true;\n}\n"]}

package/dist/utils/log.d.ts

@@ -0,0 +1,7 @@
+export declare function step(message: string): void;
+export declare function success(message: string): void;
+export declare function warn(message: string): void;
+export declare function info(message: string): void;
+export declare function dryRun(message: string): void;
+export declare function error(message: string): void;
+export declare function mask(value: string | undefined): string;

package/dist/utils/log.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.step = step;
+exports.success = success;
+exports.warn = warn;
+exports.info = info;
+exports.dryRun = dryRun;
+exports.error = error;
+exports.mask = mask;
+const chalk_1 = __importDefault(require("chalk"));
+const prefixes = {
+    step: chalk_1.default.cyan("==>"),
+    success: chalk_1.default.green("[ok]"),
+    warn: chalk_1.default.yellow("[warn]"),
+    error: chalk_1.default.red("[err]"),
+    info: chalk_1.default.blue("[info]"),
+    dryRun: chalk_1.default.magenta("[dry-run]"),
+};
+function step(message) {
+    console.log(`${prefixes.step} ${message}`);
+}
+function success(message) {
+    console.log(`${prefixes.success} ${message}`);
+}
+function warn(message) {
+    console.log(`${prefixes.warn} ${message}`);
+}
+function info(message) {
+    console.log(`${prefixes.info} ${message}`);
+}
+function dryRun(message) {
+    console.log(`${prefixes.dryRun} ${message}`);
+}
+function error(message) {
+    console.error(`${prefixes.error} ${message}`);
+}
+function mask(value) {
+    if (!value)
+        return "";
+    if (value.length <= 6)
+        return "*".repeat(value.length);
+    return `${value.slice(0, 2)}***${value.slice(-2)}`;
+}
+//# sourceMappingURL=log.js.map

package/dist/utils/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/utils/log.ts"],"names":[],"mappings":";;;;;AAWA,oBAEC;AAED,0BAEC;AAED,oBAEC;AAED,oBAEC;AAED,wBAEC;AAED,sBAEC;AAED,oBAIC;AAvCD,kDAA0B;AAE1B,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC;IACvB,OAAO,EAAE,eAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,eAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC5B,KAAK,EAAE,eAAK,CAAC,GAAG,CAAC,OAAO,CAAC;IACzB,IAAI,EAAE,eAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC1B,MAAM,EAAE,eAAK,CAAC,OAAO,CAAC,WAAW,CAAC;CACnC,CAAC;AAEF,SAAgB,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,MAAM,CAAC,OAAe;IACpC,OAAO,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,IAAI,CAAC,KAAyB;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC","sourcesContent":["import chalk from \"chalk\";\n\nconst prefixes = {\n  step: chalk.cyan(\"==>\"),\n  success: chalk.green(\"[ok]\"),\n  warn: chalk.yellow(\"[warn]\"),\n  error: chalk.red(\"[err]\"),\n  info: chalk.blue(\"[info]\"),\n  dryRun: chalk.magenta(\"[dry-run]\"),\n};\n\nexport function step(message: string) {\n  console.log(`${prefixes.step} ${message}`);\n}\n\nexport function success(message: string) {\n  console.log(`${prefixes.success} ${message}`);\n}\n\nexport function warn(message: string) {\n  console.log(`${prefixes.warn} ${message}`);\n}\n\nexport function info(message: string) {\n  console.log(`${prefixes.info} ${message}`);\n}\n\nexport function dryRun(message: string) {\n  console.log(`${prefixes.dryRun} ${message}`);\n}\n\nexport function error(message: string) {\n  console.error(`${prefixes.error} ${message}`);\n}\n\nexport function mask(value: string | undefined): string {\n  if (!value) return \"\";\n  if (value.length <= 6) return \"*\".repeat(value.length);\n  return `${value.slice(0, 2)}***${value.slice(-2)}`;\n}\n"]}

package/dist/utils/yaml.d.ts

@@ -0,0 +1,4 @@
+export declare function readYamlFile<T = unknown>(filePath: string): Promise<T | undefined>;
+export declare function writeYamlFile(filePath: string, data: unknown, options?: {
+    dryRun?: boolean;
+}): Promise<boolean>;

package/dist/utils/yaml.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readYamlFile = readYamlFile;
+exports.writeYamlFile = writeYamlFile;
+const yaml_1 = __importDefault(require("yaml"));
+const fs_1 = require("./fs");
+async function readYamlFile(filePath) {
+    const contents = await (0, fs_1.readFileIfExists)(filePath);
+    if (!contents)
+        return undefined;
+    return yaml_1.default.parse(contents);
+}
+async function writeYamlFile(filePath, data, options = {}) {
+    const content = `${yaml_1.default.stringify(data, { indent: 2 })}`.trimEnd() + "\n";
+    return (0, fs_1.writeFileSafely)(filePath, content, { dryRun: options.dryRun });
+}
+//# sourceMappingURL=yaml.js.map

package/dist/utils/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/utils/yaml.ts"],"names":[],"mappings":";;;;;AAGA,oCAIC;AAED,sCAOC;AAhBD,gDAAwB;AACxB,6BAAyD;AAElD,KAAK,UAAU,YAAY,CAAc,QAAgB;IAC9D,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAgB,EAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,cAAI,CAAC,KAAK,CAAC,QAAQ,CAAM,CAAC;AACnC,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,IAAa,EACb,UAAgC,EAAE;IAElC,MAAM,OAAO,GAAG,GAAG,cAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1E,OAAO,IAAA,oBAAe,EAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACxE,CAAC","sourcesContent":["import YAML from \"yaml\";\nimport { readFileIfExists, writeFileSafely } from \"./fs\";\n\nexport async function readYamlFile<T = unknown>(filePath: string): Promise<T | undefined> {\n  const contents = await readFileIfExists(filePath);\n  if (!contents) return undefined;\n  return YAML.parse(contents) as T;\n}\n\nexport async function writeYamlFile(\n  filePath: string,\n  data: unknown,\n  options: { dryRun?: boolean } = {},\n): Promise<boolean> {\n  const content = `${YAML.stringify(data, { indent: 2 })}`.trimEnd() + \"\\n\";\n  return writeFileSafely(filePath, content, { dryRun: options.dryRun });\n}\n"]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@dx-labs/template-designer-setup",
+  "version": "0.1.2",
+  "description": "CLI to install and wire Template Designer and License Box plugins into a Backstage instance",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": "dist/index.js",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "eslint .",
+    "format": "prettier -w .",
+    "format:check": "prettier -c .",
+    "clean": "rm -rf dist",
+    "start": "node dist/index.js",
+    "validate:fix": "yarn tsc && yarn lint && yarn format",
+    "set-version": "node scripts/set-version.js",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "execa": "^5.1.1",
+    "prompts": "^2.4.2",
+    "ts-morph": "^22.0.0",
+    "yaml": "^2.5.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.4.1",
+    "@commitlint/config-conventional": "^20.1.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.1",
+    "@semantic-release/npm": "^13.1.1",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/node": "^20.14.11",
+    "@types/prompts": "^2.4.9",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^9.1.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.6",
+    "prettier": "^3.3.3",
+    "typescript": "~5.8.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "lint-staged": {
+    "*.{js,ts,tsx,jsx}": "eslint --fix",
+    "*.{json,md,yml,yaml}": "prettier --write"
+  },
+  "packageManager": "yarn@4.1.1",
+  "repository": {}
+}