@clearlydev/nx-archweave 0.3.1 → 0.3.3

package/dist/generators/add-backend/generator.js

@@ -1,909 +1,14 @@
-// src/generators/add-backend/generator.ts
-import { getProjects } from "@nx/devkit";
-
-// ../template-engine/dist/environment/package-manager.js
-var LOCKFILES = [
-  ["yarn", ["yarn.lock"]],
-  ["bun", ["bun.lock", "bun.lockb"]],
-  ["npm", ["package-lock.json"]]
-];
-function detectWorkspacePackageManager(exists, read = () => void 0) {
-  if (exists("pnpm-lock.yaml") || exists("pnpm-workspace.yaml"))
-    return "pnpm";
-  const found = LOCKFILES.filter(([, files]) => files.some((file) => exists(file))).map(([pm]) => pm);
-  if (found.length <= 1)
-    return found[0] ?? null;
-  const declared = /"packageManager"\s*:\s*"(npm|yarn|bun)@/.exec(read("package.json") ?? "")?.[1];
-  const named = found.find((pm) => pm === declared);
-  if (named)
-    return named;
-  return found.includes("npm") ? "npm" : found[0];
-}
-function detectYarnFlavor(exists, read) {
-  if (exists(".yarnrc.yml"))
-    return "berry";
-  if (/^__metadata:/m.test(read("yarn.lock") ?? ""))
-    return "berry";
-  const major = /"packageManager"\s*:\s*"yarn@(\d+)\./.exec(read("package.json") ?? "")?.[1];
-  return major !== void 0 && Number(major) >= 2 ? "berry" : "classic";
-}
-function packageManagerCommands(pm, flavor = "classic") {
-  switch (pm) {
-    case "pnpm":
-      return { addDevAtRoot: (spec) => `pnpm add -D -w ${spec}`, addAtRoot: (spec) => `pnpm add -w ${spec}`, runNx: "pnpm nx", install: "pnpm install", workspaceRegistration: "pnpm-workspace.yaml" };
-    case "yarn":
-      return {
-        addDevAtRoot: (spec) => flavor === "berry" ? `yarn add -D ${spec}` : `yarn add -D -W ${spec}`,
-        addAtRoot: (spec) => flavor === "berry" ? `yarn add ${spec}` : `yarn add -W ${spec}`,
-        runNx: "yarn nx",
-        install: "yarn install",
-        workspaceRegistration: "package.json workspaces"
-      };
-    case "bun":
-      return { addDevAtRoot: (spec) => `bun add -d ${spec}`, addAtRoot: (spec) => `bun add ${spec}`, runNx: "bun nx", install: "bun install", workspaceRegistration: "package.json workspaces" };
-    case "npm":
-      return { addDevAtRoot: (spec) => `npm install -D ${spec}`, addAtRoot: (spec) => `npm install ${spec}`, runNx: "npm exec nx --", install: "npm install", workspaceRegistration: "package.json workspaces" };
-  }
-}
-
-// ../template-engine/dist/backend/eslint-boundaries.js
-var DEFAULT_BOUNDARY_TAGS = { frontend: "scope:frontend", backend: "scope:backend", shared: "scope:shared" };
-function readBoundaryTags(config) {
-  const boundaries = config?.["boundaries"];
-  const tags = typeof boundaries === "object" && boundaries !== null ? boundaries["tags"] : void 0;
-  const pick = (role) => {
-    const value = typeof tags === "object" && tags !== null ? tags[role] : void 0;
-    return typeof value === "string" && value.trim() !== "" ? value : DEFAULT_BOUNDARY_TAGS[role];
-  };
-  return { frontend: pick("frontend"), backend: pick("backend"), shared: pick("shared") };
-}
-function scopeConstraints(tags = DEFAULT_BOUNDARY_TAGS) {
-  return [
-    { sourceTag: tags.frontend, notDependOnLibsWithTags: [tags.backend] },
-    { sourceTag: tags.backend, notDependOnLibsWithTags: [tags.frontend] },
-    { sourceTag: tags.shared, notDependOnLibsWithTags: [tags.frontend, tags.backend] }
-  ];
-}
-var SCOPE_CONSTRAINTS = scopeConstraints();
-var ESLINT_CONFIG_CANDIDATES = ["eslint.config.mjs", "eslint.config.js", "eslint.config.cjs"];
-var appliedMarker = (tags) => `sourceTag: '${tags.frontend}'`;
-var ALLOW_ALL_BLOCK = /depConstraints:\s*\[\s*\{\s*sourceTag:\s*'\*',\s*onlyDependOnLibsWithTags:\s*\[\s*'\*'\s*\],?\s*\},?\s*\]/g;
-function maskComments(text) {
-  const out = text.split("");
-  let mode = "code";
-  let quote = "";
-  for (let i = 0; i < text.length; i++) {
-    const c = text[i];
-    const d = text[i + 1];
-    if (mode === "code") {
-      if (c === "'" || c === '"' || c === "`") {
-        mode = "string";
-        quote = c;
-      } else if (c === "/" && d === "/") {
-        mode = "line";
-        out[i] = " ";
-      } else if (c === "/" && d === "*") {
-        mode = "block";
-        out[i] = " ";
-      }
-    } else if (mode === "string") {
-      if (c === "\\") {
-        i++;
-      } else if (c === quote) {
-        mode = "code";
-      }
-    } else if (mode === "line") {
-      if (c === "\n") {
-        mode = "code";
-      } else {
-        out[i] = " ";
-      }
-    } else {
-      if (c === "*" && d === "/") {
-        out[i] = " ";
-        out[i + 1] = " ";
-        i++;
-        mode = "code";
-      } else if (c !== "\n") {
-        out[i] = " ";
-      }
-    }
-  }
-  return out.join("");
-}
-function findAllowAllMatches(masked) {
-  const matches = [];
-  ALLOW_ALL_BLOCK.lastIndex = 0;
-  for (let m = ALLOW_ALL_BLOCK.exec(masked); m !== null; m = ALLOW_ALL_BLOCK.exec(masked)) {
-    matches.push({ index: m.index, length: m[0].length });
-  }
-  return matches;
-}
-function classifyBoundaryConstraints(configText, tags = DEFAULT_BOUNDARY_TAGS) {
-  const masked = maskComments(configText);
-  if (masked.includes(appliedMarker(tags)))
-    return "enforced";
-  if (findAllowAllMatches(masked).length > 0)
-    return "allow-all";
-  return "unknown";
-}
-function renderConstraintsBlock(indent, eol, tags) {
-  const renderList = (list) => list.map((t) => `'${t}'`).join(", ");
-  const inner = scopeConstraints(tags).map((c) => {
-    const field = c.notDependOnLibsWithTags ? `notDependOnLibsWithTags: [${renderList(c.notDependOnLibsWithTags)}]` : `onlyDependOnLibsWithTags: [${renderList(c.onlyDependOnLibsWithTags ?? [])}]`;
-    return [`${indent}  {`, `${indent}    sourceTag: '${c.sourceTag}',`, `${indent}    ${field},`, `${indent}  },`].join(eol);
-  }).join(eol);
-  return [
-    `// nx-archweave boundaries \u2014 the frontend and the backend may never import each other`,
-    `${indent}depConstraints: [`,
-    inner,
-    [
-      `${indent}  // baseline: everything else stays allowed (constraints apply conjunctively)`,
-      `${indent}  {`,
-      `${indent}    sourceTag: '*',`,
-      `${indent}    onlyDependOnLibsWithTags: ['*'],`,
-      `${indent}  },`
-    ].join(eol),
-    `${indent}]`
-  ].join(eol);
-}
-function applyBoundaryConstraints(configText, tags = DEFAULT_BOUNDARY_TAGS) {
-  const classification = classifyBoundaryConstraints(configText, tags);
-  if (classification === "enforced")
-    return { status: "already-applied" };
-  if (classification === "unknown")
-    return { status: "unrecognized" };
-  const masked = maskComments(configText);
-  const matches = findAllowAllMatches(masked);
-  if (matches.length !== 1) {
-    return { status: "unrecognized" };
-  }
-  const [match] = matches;
-  const eol = configText.includes("\r\n") ? "\r\n" : "\n";
-  const lineStart = configText.lastIndexOf("\n", match.index) + 1;
-  const indent = /^[ \t]*/.exec(configText.slice(lineStart, match.index))?.[0] ?? "";
-  const replacement = renderConstraintsBlock(indent, eol, tags);
-  const text = configText.slice(0, match.index) + replacement + configText.slice(match.index + match.length);
-  return { status: "applied", text };
-}
-function buildBoundarySnippet(tags = DEFAULT_BOUNDARY_TAGS) {
-  return [
-    "// nx-archweave project boundaries \u2014 merge these entries into the depConstraints",
-    "// array of the '@nx/enforce-module-boundaries' rule in your root ESLint config.",
-    "// They ride on top of your existing entries: constraints apply conjunctively,",
-    "// so the allow-all baseline can stay.",
-    renderConstraintsBlock("", "\n", tags)
-  ].join("\n");
-}
-
-// ../templates/dist/backend/shared-types.js
-function sharedTypesIndexContent() {
-  return `export * from './lib/api-types.js';
-`;
-}
-function sharedTypesApiTypesContent() {
-  return [
-    "// Types shared between the frontend and the backend live here.",
-    "// Example: the api app returns this from GET /api/health, and the",
-    "// frontend consumes the same shape \u2014 one definition, no drift.",
-    "export interface ApiHealthResponse {",
-    "  status: 'ok';",
-    "}",
-    ""
-  ].join("\n");
-}
-function sharedTypesPackageJsonContent(packageName, sharedTag = "scope:shared") {
-  return `${JSON.stringify({
-    name: packageName,
-    version: "0.0.1",
-    private: true,
-    type: "module",
-    main: "./src/index.ts",
-    types: "./src/index.ts",
-    exports: {
-      ".": {
-        types: "./src/index.ts",
-        import: "./src/index.ts",
-        default: "./src/index.ts"
-      }
-    },
-    nx: {
-      projectType: "library",
-      tags: [sharedTag],
-      targets: {}
-    }
-  }, null, 2)}
-`;
-}
-
-// ../template-engine/dist/backend/compose-backend-wiring.js
-var DEFAULT_SHARED_TYPES_ROOT = "libs/shared-types";
-function readSharedTypesConfig(config) {
-  const value = config?.["sharedTypes"];
-  if (value === false)
-    return false;
-  if (typeof value !== "object" || value === null)
-    return { path: DEFAULT_SHARED_TYPES_ROOT };
-  const record = value;
-  const path = typeof record["path"] === "string" && record["path"].trim() !== "" ? record["path"].replace(/\/+$/, "") : DEFAULT_SHARED_TYPES_ROOT;
-  const importPath = typeof record["importPath"] === "string" && record["importPath"].trim() !== "" ? record["importPath"] : void 0;
-  return importPath === void 0 ? { path } : { path, importPath };
-}
-function composeBackendWiring(input) {
-  const scoped = /^@([^/]+)\//.exec(input.workspaceName);
-  const scope = scoped ? `@${scoped[1]}` : `@${input.workspaceName.split("/").pop() || "workspace"}`;
-  const sharedTypesRoot = input.sharedTypes?.path ?? DEFAULT_SHARED_TYPES_ROOT;
-  const sharedTypesPackageName = input.sharedTypes?.importPath ?? `${scope}/shared-types`;
-  const tagByRole = input.tags ?? DEFAULT_BOUNDARY_TAGS;
-  return {
-    sharedTypesFiles: [
-      { filePath: `${sharedTypesRoot}/package.json`, content: sharedTypesPackageJsonContent(sharedTypesPackageName, tagByRole.shared) },
-      { filePath: `${sharedTypesRoot}/src/index.ts`, content: sharedTypesIndexContent() },
-      { filePath: `${sharedTypesRoot}/src/lib/api-types.ts`, content: sharedTypesApiTypesContent() }
-    ],
-    sharedTypesPackageName,
-    sharedTypesRoot,
-    tagByRole
-  };
-}
-function addSharedTypesNpmWorkspace(packageJsonText, entry = DEFAULT_SHARED_TYPES_ROOT) {
-  let parsed;
-  try {
-    parsed = JSON.parse(packageJsonText);
-  } catch {
-    return { status: "unrecognized" };
-  }
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
-    return { status: "unrecognized" };
-  const pkg = parsed;
-  const field = pkg["workspaces"];
-  let target;
-  if (field === void 0) {
-    target = [];
-  } else if (Array.isArray(field)) {
-    target = field;
-  } else if (field !== null && typeof field === "object" && Array.isArray(field.packages)) {
-    target = field.packages;
-  } else {
-    return { status: "unrecognized" };
-  }
-  const parentGlob = `${entry.split("/").slice(0, -1).join("/")}/*`;
-  if (target.some((existing) => existing === entry || existing === parentGlob))
-    return { status: "present" };
-  const surgical = insertSharedTypesWorkspace(packageJsonText, field === void 0 ? "absent" : Array.isArray(field) ? "array" : "object", JSON.stringify(entry));
-  if (surgical !== null)
-    return { status: "added", text: surgical };
-  if (field === void 0)
-    pkg["workspaces"] = target;
-  target.push(entry);
-  const indent = /\n([ \t]+)"/.exec(packageJsonText)?.[1] ?? "  ";
-  const trailing = packageJsonText.endsWith("\n") ? "\n" : "";
-  return { status: "added", text: `${JSON.stringify(pkg, null, indent)}${trailing}` };
-}
-function skipJsonValue(text, start) {
-  if (text[start] === '"') {
-    let i = start + 1;
-    while (i < text.length && text[i] !== '"')
-      i += text[i] === "\\" ? 2 : 1;
-    return i + 1;
-  }
-  if (text[start] === "[" || text[start] === "{") {
-    let depth = 0;
-    let i = start;
-    while (i < text.length) {
-      const c = text[i];
-      if (c === '"') {
-        i = skipJsonValue(text, i);
-        continue;
-      }
-      if (c === "[" || c === "{")
-        depth++;
-      if (c === "]" || c === "}") {
-        depth--;
-        if (depth === 0)
-          return i + 1;
-      }
-      i++;
-    }
-    return -1;
-  }
-  const literal = /^[^,}\]\s]+/.exec(text.slice(start));
-  return literal ? start + literal[0].length : -1;
-}
-function objectMembers(text, open) {
-  const members = [];
-  let i = open + 1;
-  for (; ; ) {
-    while (/[\s,]/.test(text[i] ?? ""))
-      i++;
-    if (text[i] === "}")
-      return members;
-    if (text[i] !== '"')
-      return null;
-    const keyEnd = skipJsonValue(text, i);
-    const key = JSON.parse(text.slice(i, keyEnd));
-    i = keyEnd;
-    while (/\s/.test(text[i] ?? ""))
-      i++;
-    if (text[i] !== ":")
-      return null;
-    i++;
-    while (/\s/.test(text[i] ?? ""))
-      i++;
-    const valueEnd = skipJsonValue(text, i);
-    if (valueEnd === -1)
-      return null;
-    members.push({ key, valueStart: i, valueEnd });
-    i = valueEnd;
-  }
-}
-function appendToArray(text, open, close, eol, quoted) {
-  const inner = text.slice(open + 1, close - 1);
-  if (inner.trim() === "")
-    return `${text.slice(0, open + 1)}${quoted}${text.slice(close - 1)}`;
-  if (!inner.includes("\n")) {
-    const body = inner.replace(/\s+$/, "");
-    return `${text.slice(0, open + 1)}${body}, ${quoted}${inner.slice(body.length)}${text.slice(close - 1)}`;
-  }
-  const lastEntryLineStart = text.lastIndexOf("\n", open + 1 + inner.trimEnd().length - 1) + 1;
-  const itemIndent = /^[ \t]*/.exec(text.slice(lastEntryLineStart))?.[0] ?? "  ";
-  const bodyEnd = open + 1 + inner.trimEnd().length;
-  return `${text.slice(0, bodyEnd)},${eol}${itemIndent}${quoted}${text.slice(bodyEnd)}`;
-}
-function insertSharedTypesWorkspace(text, form, quoted) {
-  const eol = text.includes("\r\n") ? "\r\n" : "\n";
-  const rootOpen = text.indexOf("{");
-  if (rootOpen === -1)
-    return null;
-  const members = objectMembers(text, rootOpen);
-  if (members === null)
-    return null;
-  const workspaces = members.find((member) => member.key === "workspaces");
-  if (form === "absent") {
-    const last = members[members.length - 1];
-    const indent = /\n([ \t]+)"/.exec(text)?.[1] ?? "  ";
-    if (last === void 0) {
-      const close = skipJsonValue(text, rootOpen) - 1;
-      return `${text.slice(0, rootOpen + 1)}${eol}${indent}"workspaces": [${quoted}]${eol}${text.slice(close)}`;
-    }
-    return `${text.slice(0, last.valueEnd)},${eol}${indent}"workspaces": [${quoted}]${text.slice(last.valueEnd)}`;
-  }
-  if (workspaces === void 0)
-    return null;
-  if (form === "array") {
-    if (text[workspaces.valueStart] !== "[")
-      return null;
-    return appendToArray(text, workspaces.valueStart, workspaces.valueEnd, eol, quoted);
-  }
-  if (text[workspaces.valueStart] !== "{")
-    return null;
-  const packages = objectMembers(text, workspaces.valueStart)?.find((member) => member.key === "packages");
-  if (packages === void 0 || text[packages.valueStart] !== "[")
-    return null;
-  return appendToArray(text, packages.valueStart, packages.valueEnd, eol, quoted);
-}
-function addSharedTypesWorkspaceGlob(yamlText, entry = DEFAULT_SHARED_TYPES_ROOT) {
-  const escape = (value) => value.replace(/[.*+?^${}()|[\]\\/]/g, "\\$&");
-  const parentGlob = `${entry.split("/").slice(0, -1).join("/")}/*`;
-  if (new RegExp(`^\\s*-\\s*['"]?(${escape(entry)}|${escape(parentGlob)})['"]?\\s*$`, "m").test(yamlText)) {
-    return { status: "present" };
-  }
-  const lines = yamlText.split("\n");
-  const packagesIndex = lines.findIndex((line) => /^packages:\s*$/.test(line));
-  if (packagesIndex === -1)
-    return { status: "unrecognized" };
-  let lastEntry = packagesIndex;
-  for (let i = packagesIndex + 1; i < lines.length; i++) {
-    if (/^\s+-\s+\S/.test(lines[i])) {
-      lastEntry = i;
-    } else if (lines[i].trim() === "") {
-      continue;
-    } else {
-      break;
-    }
-  }
-  if (lastEntry === packagesIndex)
-    return { status: "unrecognized" };
-  const indent = /^(\s+)-/.exec(lines[lastEntry])?.[1] ?? "  ";
-  lines.splice(lastEntry + 1, 0, `${indent}- '${entry}'`);
-  return { status: "added", text: lines.join("\n") };
-}
-
-// src/generators/shared/dry-run.ts
-function resolveDryRun(options) {
-  return process.env["NX_DRY_RUN"] === "true" || (options.dryRun ?? false);
-}
-
-// src/generators/shared/json-edit.ts
-import { findNodeAtLocation, parseTree } from "jsonc-parser";
-function detectIndent(raw) {
-  for (const line of raw.split("\n")) {
-    const match = /^(\t+| +)/.exec(line);
-    if (match) return match[1];
-  }
-  return "  ";
-}
-function styleOf(raw) {
-  return { eol: raw.includes("\r\n") ? "\r\n" : "\n", unit: detectIndent(raw) };
-}
-function lineIndentAt(raw, offset) {
-  const lineStart = raw.lastIndexOf("\n", offset - 1) + 1;
-  return /^[ \t]*/.exec(raw.slice(lineStart))?.[0] ?? "";
-}
-function isMultiline(raw, node) {
-  return raw.slice(node.offset, node.offset + node.length).includes("\n");
-}
-function isPrimitive(value) {
-  return value === null || ["string", "number", "boolean"].includes(typeof value);
-}
-function renderValue(value, indent, style) {
-  if (isPrimitive(value)) return JSON.stringify(value);
-  if (Array.isArray(value)) {
-    if (value.every(isPrimitive)) return `[${value.map((item) => JSON.stringify(item)).join(", ")}]`;
-    const inner2 = `${indent}${style.unit}`;
-    return `[${style.eol}${value.map((item) => `${inner2}${renderValue(item, inner2, style)}`).join(`,${style.eol}`)}${style.eol}${indent}]`;
-  }
-  const entries = Object.entries(value);
-  if (entries.length === 0) return "{}";
-  const inner = `${indent}${style.unit}`;
-  const body = entries.map(([key, item]) => `${inner}${JSON.stringify(key)}: ${renderValue(item, inner, style)}`).join(`,${style.eol}`);
-  return `{${style.eol}${body}${style.eol}${indent}}`;
-}
-function splice(raw, start, end, text) {
-  return raw.slice(0, start) + text + raw.slice(end);
-}
-function nest(keys, value) {
-  return keys.reduceRight((inner, key) => ({ [key]: inner }), value);
-}
-function insertProperty(raw, object, key, value, style) {
-  const properties = object.children ?? [];
-  const objectIndent = lineIndentAt(raw, object.offset);
-  if (properties.length === 0) {
-    const inner = `${objectIndent}${style.unit}`;
-    const text = `{${style.eol}${inner}${JSON.stringify(String(key))}: ${renderValue(value, inner, style)}${style.eol}${objectIndent}}`;
-    return splice(raw, object.offset, object.offset + object.length, text);
-  }
-  const last = properties[properties.length - 1];
-  const end = last.offset + last.length;
-  if (!isMultiline(raw, object)) {
-    return splice(raw, end, end, `, ${JSON.stringify(String(key))}: ${renderValue(value, "", style)}`);
-  }
-  const indent = lineIndentAt(raw, last.offset);
-  return splice(raw, end, end, `,${style.eol}${indent}${JSON.stringify(String(key))}: ${renderValue(value, indent, style)}`);
-}
-function setJsonValue(raw, path, value) {
-  const style = styleOf(raw);
-  const root = parseTree(raw);
-  if (root === void 0) throw new Error("setJsonValue: not a JSON document");
-  const existing = findNodeAtLocation(root, path);
-  if (existing !== void 0) {
-    return splice(raw, existing.offset, existing.offset + existing.length, renderValue(value, lineIndentAt(raw, existing.offset), style));
-  }
-  for (let depth = path.length - 1; depth >= 0; depth--) {
-    const parent = depth === 0 ? root : findNodeAtLocation(root, path.slice(0, depth));
-    if (parent === void 0) continue;
-    if (parent.type !== "object") throw new Error(`setJsonValue: ${path.slice(0, depth).join(".") || "the root"} is not an object`);
-    return insertProperty(raw, parent, path[depth], nest(path.slice(depth + 1), value), style);
-  }
-  throw new Error("setJsonValue: unreachable");
-}
-function appendJsonArrayItem(raw, path, item) {
-  const style = styleOf(raw);
-  const root = parseTree(raw);
-  const array = root === void 0 ? void 0 : findNodeAtLocation(root, path);
-  if (array === void 0) return setJsonValue(raw, path, [item]);
-  if (array.type !== "array") throw new Error(`appendJsonArrayItem: ${path.join(".")} is not an array`);
-  const items = array.children ?? [];
-  if (items.length === 0) return splice(raw, array.offset, array.offset + array.length, renderValue([item], "", style));
-  const last = items[items.length - 1];
-  const end = last.offset + last.length;
-  if (!isMultiline(raw, array)) {
-    const separator = items.length >= 2 ? raw.slice(items[0].offset + items[0].length, items[1].offset) : ", ";
-    return splice(raw, end, end, `${separator}${renderValue(item, "", style)}`);
-  }
-  const indent = lineIndentAt(raw, last.offset);
-  return splice(raw, end, end, `,${style.eol}${indent}${renderValue(item, indent, style)}`);
-}
-function applyJsonEdits(raw, edits) {
-  if (raw === null) {
-    let text = "{}\n";
-    for (const [path, value] of edits) text = setJsonValue(text, path, value);
-    return text;
-  }
-  return edits.reduce((text, [path, value]) => setJsonValue(text, path, value), raw);
-}
-
-// src/generators/shared/toolkit-config-file.ts
-var TOOLKIT_CONFIG_PATH = "toolkit.config.json";
-function readToolkitConfigFile(tree) {
-  const raw = tree.read(TOOLKIT_CONFIG_PATH, "utf-8");
-  if (raw === null) return { raw: null, parsed: null };
-  try {
-    const parsed = JSON.parse(raw);
-    return {
-      raw,
-      parsed: typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null
-    };
-  } catch {
-    return { raw, parsed: null };
-  }
-}
-function readToolkitConfig(tree) {
-  return readToolkitConfigFile(tree).parsed;
-}
-function recordedChoice(config, key, allowed) {
-  const value = config?.[key];
-  return typeof value === "string" && allowed.includes(value) ? value : void 0;
-}
-var RECORDED_PACKAGE_MANAGERS = ["pnpm", "npm", "yarn", "bun"];
-function workspacePackageManager(exists, read, config) {
-  return detectWorkspacePackageManager(exists, read) ?? recordedChoice(config, "packageManager", RECORDED_PACKAGE_MANAGERS) ?? null;
-}
-function treePackageManager(tree, config) {
-  return workspacePackageManager((p) => tree.exists(p), (p) => tree.read(p, "utf-8"), config);
-}
-
-// src/generators/shared/project-type.ts
-import { parseJson } from "@nx/devkit";
-function resolveProjectType(tree, root, declared) {
-  if (declared) return declared === "library" ? "library" : "application";
-  const prefix = root === "" || root === "." ? "" : `${root}/`;
-  if (tree.exists(`${prefix}tsconfig.lib.json`)) return "library";
-  if (tree.exists(`${prefix}tsconfig.app.json`)) return "application";
-  const raw = tree.read(`${prefix}package.json`, "utf-8");
-  if (raw === null) return "library";
-  try {
-    const manifest = parseJson(raw);
-    if (manifest && !["exports", "main", "module", "bin"].some((key) => Boolean(manifest[key]))) return "application";
-  } catch {
-  }
-  return "library";
-}
-
-// src/generators/add-backend/render.ts
-function renderAddBackendBody(report) {
-  const lines = [];
-  if (report.refused === "no-frontend") {
-    lines.push(`Refused: no frontend application and no "${report.apiName}" app found in this workspace.`);
-    lines.push("  add-backend wires a backend app \u2014 beside a frontend, or on its own in a backend-only");
-    lines.push(`  workspace (create one with: npx create-nx-workspace --preset=${report.backend} --appName=${report.apiName}).`);
-    lines.push("  If the backend app has another name, pass --apiName=<its directory name>.");
-    return lines.join("\n");
-  }
-  if (report.refused === "frontend-not-found") {
-    lines.push(`Refused: --frontendProject "${report.frontendProject}" does not match any project.`);
-    lines.push("  Nothing was written. Check the name with `nx show projects`.");
-    return lines.join("\n");
-  }
-  if (report.refused === "ambiguous-frontend") {
-    lines.push("Refused: multiple frontend applications found \u2014 add-backend will not guess:");
-    for (const name of report.frontendCandidates ?? []) lines.push(`  - ${name}`);
-    lines.push("  Nothing was written. Re-run with --frontendProject=<name> to pick one.");
-    return lines.join("\n");
-  }
-  if (report.refused === "invalid-project-json") {
-    lines.push("Refused: a project.json this run must update could not be parsed:");
-    for (const path of report.invalidProjects ?? []) lines.push(`  - ${path}`);
-    lines.push("  Nothing was written \u2014 fix the JSON, then re-run add-backend.");
-    return lines.join("\n");
-  }
-  if (report.refused === "missing-api-project") {
-    lines.push(`Refused: no "${report.apiName}" application project found.`);
-    lines.push("  Create it with the official commands first (copy-paste, names already filled in),");
-    lines.push("  then re-run add-backend to wire it up:");
-    lines.push("");
-    for (const command of report.commands ?? []) lines.push(`    ${command}`);
-    if (report.expressRange !== void 0) {
-      lines.push("");
-      lines.push(`  The express line declares express@${report.expressRange}, the range this workspace's @nx/react supports \u2014`);
-      lines.push("  the official generator then keeps it instead of adding express 5, which npm rejects as a peer conflict.");
-    }
-    return lines.join("\n");
-  }
-  if (report.packageManagerNote !== void 0) lines.push(`  note: ${report.packageManagerNote}`);
-  lines.push(`  frontend project: ${report.frontendProject ?? "none (backend-only workspace)"}`);
-  const libPath = report.sharedTypesRoot ?? "libs/shared-types";
-  lines.push(
-    report.sharedTypes === "created" ? `  ${libPath}: created (import it as ${report.sharedTypesPackage})` : report.sharedTypes === "disabled" ? "  shared-types lib: none (sharedTypes: false in toolkit.config.json)" : `  ${libPath}: already exists \u2014 skipped`
-  );
-  if (report.config !== void 0 && report.config !== "unchanged") {
-    lines.push(`  toolkit.config.json: backend "${report.backend}" recorded (${report.config}) \u2014 doctor's backend checks now run`);
-  }
-  if (report.workspaceGlob !== void 0) {
-    const pmName = report.packageManager ?? "pnpm";
-    const registry = packageManagerCommands(pmName).workspaceRegistration;
-    lines.push(
-      {
-        added: `  ${registry}: '${libPath}' registered \u2014 run \`${pmName} install\` once to link it`,
-        present: `  ${registry}: already covers ${libPath}`,
-        unrecognized: (
-          // an integrated layout lists no workspace packages: the paths alias below links it
-          report.tsconfigPaths === "added" || report.tsconfigPaths === "present" ? `  ${registry}: no workspace package list (integrated layout) \u2014 the tsconfig paths alias links ${libPath}` : `  ${registry}: shape not recognized \u2014 add '${libPath}' to its workspace list yourself`
-        )
-      }[report.workspaceGlob]
-    );
-  }
-  for (const tag of report.tags) {
-    lines.push(`  tag ${tag.project}: ${tag.action === "added" ? "added" : "already present"}`);
-  }
-  lines.push(
-    {
-      added: `  tsconfig.base.json paths: ${report.sharedTypesPackage} added (a classic or integrated setup \u2014 libs resolve through paths)`,
-      present: "  tsconfig.base.json paths: already wired",
-      "workspace-link": "  tsconfig paths: not needed \u2014 the workspace package link is the wiring",
-      unrecognized: "  tsconfig.base.json: could not be parsed \u2014 left untouched",
-      none: "  tsconfig paths: nothing to wire (no shared-types lib)"
-    }[report.tsconfigPaths]
-  );
-  switch (report.eslint) {
-    case "applied":
-      lines.push("  ESLint boundaries: cross-side deny rules written (existing imports stay allowed)");
-      break;
-    case "already-applied":
-      lines.push("  ESLint boundaries: already enforced \u2014 no change");
-      break;
-    case "degraded-unrecognized":
-      lines.push("  ESLint boundaries: your config was NOT recognized \u2014 left untouched.");
-      lines.push("  Merge this yourself (then boundaries are actually enforced):");
-      break;
-    case "snippet-only":
-      lines.push("  ESLint boundaries: report-only (pass --applyEslint to write them).");
-      lines.push("  Paste-ready snippet:");
-      break;
-  }
-  if (report.snippet) {
-    lines.push("");
-    lines.push(report.snippet);
-  }
-  return lines.join("\n");
-}
-function renderAddBackendReport(report, dryRun) {
-  return [`add-backend (${report.backend})${dryRun ? " \u2014 dry run" : ""}`, "", renderAddBackendBody(report)].join("\n");
-}
-
-// src/generators/add-backend/generator.ts
-function runAddBackend(tree, options) {
-  const backend = options.backend;
-  const apiName = options.apiName ?? "api";
-  const applyEslint = options.applyEslint ?? false;
-  const dryRun = options.dryRun ?? false;
-  const write = !dryRun;
-  const base = { backend, apiName };
-  const refusalShape = {
-    sharedTypes: "skipped",
-    tags: [],
-    tsconfigPaths: "unrecognized",
-    eslint: "snippet-only"
-  };
-  let projects;
-  try {
-    projects = getProjects(tree);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    const pathMatch = /Cannot parse ([^:]+):/.exec(message);
-    return {
-      ...base,
-      refused: "invalid-project-json",
-      invalidProjects: [pathMatch ? pathMatch[1] : message],
-      ...refusalShape
-    };
-  }
-  const detectedPm = treePackageManager(tree, readToolkitConfig(tree));
-  const packageManager = detectedPm ?? "pnpm";
-  const pmCommands = packageManagerCommands(
-    packageManager,
-    packageManager === "yarn" ? detectYarnFlavor((p) => tree.exists(p), (p) => tree.read(p, "utf-8")) : void 0
-  );
-  const packageManagerNote = detectedPm === null ? "the package manager could not be detected (no pnpm, yarn, bun or npm markers) \u2014 commands below assume pnpm." : void 0;
-  const baseNameOf = (root) => root.split("/").pop() ?? root;
-  const entries = [...projects.entries()];
-  const declaredApp = ([, config]) => config.projectType === "application";
-  const inferredApp = ([, config]) => config.projectType === void 0 && config.root !== "" && config.root !== "." && resolveProjectType(tree, config.root, void 0) === "application";
-  const apiNamed = entries.filter(([, config]) => baseNameOf(config.root) === apiName);
-  const apiEntry = apiNamed.find(declaredApp) ?? apiNamed.find((entry) => inferredApp(entry) && tree.exists(`${entry[1].root}/tsconfig.app.json`));
-  let frontendProject;
-  if (options.frontendProject !== void 0) {
-    if (!projects.has(options.frontendProject)) {
-      return { ...base, refused: "frontend-not-found", frontendProject: options.frontendProject, ...refusalShape };
-    }
-    frontendProject = options.frontendProject;
-  } else {
-    const eligible = entries.filter(([, config]) => {
-      const dir = baseNameOf(config.root);
-      return dir !== apiName && dir !== "e2e" && !dir.endsWith("-e2e");
-    });
-    const declared = eligible.filter(declaredApp);
-    const candidates = (declared.length > 0 ? declared : eligible.filter(inferredApp)).map(([name]) => name).sort();
-    if (candidates.length === 0 && !apiEntry) {
-      return { ...base, refused: "no-frontend", ...refusalShape };
-    }
-    if (candidates.length > 1) {
-      return { ...base, refused: "ambiguous-frontend", frontendCandidates: candidates, ...refusalShape };
-    }
-    frontendProject = candidates[0];
-  }
-  if (!apiEntry) {
-    if (frontendProject === void 0) return { ...base, refused: "no-frontend", ...refusalShape };
-    let nxPin = "";
-    let expressDeclared = false;
-    const rootPkgRaw = tree.read("package.json", "utf-8");
-    if (rootPkgRaw !== null) {
-      try {
-        const pkg = JSON.parse(rootPkgRaw);
-        const nxVersion = pkg.devDependencies?.["nx"] ?? pkg.dependencies?.["nx"];
-        if (nxVersion && /^[~^]?\d/.test(nxVersion)) nxPin = `@${nxVersion}`;
-        expressDeclared = pkg.dependencies?.["express"] !== void 0 || pkg.devDependencies?.["express"] !== void 0;
-      } catch {
-      }
-    }
-    const frontendRoot = projects.get(frontendProject)?.root ?? "";
-    const frontendParent = frontendRoot.split("/").slice(0, -1).join("/");
-    const apiDirectory = frontendRoot === "" || frontendRoot === "." ? `apps/${apiName}` : `${frontendParent === "" ? "" : `${frontendParent}/`}${apiName}`;
-    const expressAlignment = backend === "express" && !expressDeclared ? readExpressPeerRange(tree) : void 0;
-    const quotedExpress = expressAlignment ? `"express@${expressAlignment}"` : void 0;
-    return {
-      ...base,
-      refused: "missing-api-project",
-      frontendProject,
-      ...expressAlignment !== void 0 ? { expressRange: expressAlignment } : {},
-      commands: [
-        pmCommands.addDevAtRoot(`@nx/${backend}${nxPin}`),
-        ...quotedExpress ? [pmCommands.addAtRoot(quotedExpress)] : [],
-        `${pmCommands.runNx} g @nx/${backend}:application ${apiDirectory} --frontendProject=${frontendProject}`
-      ],
-      ...refusalShape
-    };
-  }
-  const recordedConfig = readToolkitConfigFile(tree).parsed;
-  const boundaryTags = readBoundaryTags(recordedConfig);
-  const sharedTypesConfig = readSharedTypesConfig(recordedConfig);
-  const withSharedTypes = sharedTypesConfig !== false;
-  const sharedTypesRoot = sharedTypesConfig === false ? "" : sharedTypesConfig.path;
-  const sharedTypesExists = withSharedTypes && (tree.exists(`${sharedTypesRoot}/package.json`) || tree.exists(`${sharedTypesRoot}/project.json`));
-  const rootPackageJson = tree.read("package.json", "utf-8");
-  const workspaceName = rootPackageJson ? JSON.parse(rootPackageJson).name ?? "workspace" : "workspace";
-  const wiring = composeBackendWiring({ workspaceName, tags: boundaryTags, ...sharedTypesConfig === false ? {} : { sharedTypes: sharedTypesConfig } });
-  const [apiProjectName, apiConfig] = apiEntry;
-  const tagTargets = [
-    ...frontendProject === void 0 ? [] : [{ project: frontendProject, root: projects.get(frontendProject)?.root ?? `apps/${frontendProject}` }],
-    { project: apiProjectName, root: apiConfig.root }
-  ];
-  if (sharedTypesExists) tagTargets.push({ project: wiring.sharedTypesPackageName, root: sharedTypesRoot });
-  const parsedTargets = /* @__PURE__ */ new Map();
-  const invalidProjects = [];
-  for (const target of tagTargets) {
-    const projectJsonPath = `${target.root}/project.json`;
-    const packageJsonPath = `${target.root}/package.json`;
-    const kind = tree.exists(projectJsonPath) ? "project" : "package";
-    const path = kind === "project" ? projectJsonPath : packageJsonPath;
-    const raw = tree.read(path, "utf-8");
-    if (raw === null) {
-      invalidProjects.push(path);
-      continue;
-    }
-    try {
-      parsedTargets.set(target.project, { path, raw, kind, parsed: JSON.parse(raw) });
-    } catch {
-      invalidProjects.push(path);
-    }
-  }
-  if (invalidProjects.length > 0) {
-    return { ...base, refused: "invalid-project-json", frontendProject, invalidProjects, ...refusalShape };
-  }
-  const sharedTypes = !withSharedTypes ? "disabled" : sharedTypesExists ? "skipped" : "created";
-  if (sharedTypes === "created" && write) {
-    for (const file of wiring.sharedTypesFiles) tree.write(file.filePath, file.content);
-  }
-  let configOutcome = "unchanged";
-  {
-    const { raw: configRaw, parsed: configParsed } = readToolkitConfigFile(tree);
-    const parseOk = configRaw === null || configParsed !== null;
-    const existing = configParsed ?? {};
-    if (parseOk && existing["backend"] !== backend) {
-      configOutcome = configRaw === null ? "created" : "updated";
-      if (write) tree.write(TOOLKIT_CONFIG_PATH, applyJsonEdits(configRaw, [[["backend"], backend]]));
-    }
-  }
-  let workspaceGlob = withSharedTypes ? "unrecognized" : void 0;
-  const workspaceYaml = withSharedTypes ? tree.read("pnpm-workspace.yaml", "utf-8") : null;
-  if (!withSharedTypes) {
-  } else if (workspaceYaml !== null) {
-    const globResult = addSharedTypesWorkspaceGlob(workspaceYaml, sharedTypesRoot);
-    workspaceGlob = globResult.status;
-    if (globResult.status === "added" && write) tree.write("pnpm-workspace.yaml", globResult.text);
-  } else if ((detectedPm === "npm" || detectedPm === "yarn" || detectedPm === "bun") && rootPackageJson !== null) {
-    const yarnNeedsPrivate = detectedPm === "yarn" && JSON.parse(rootPackageJson).private !== true;
-    const npmResult = yarnNeedsPrivate ? { status: "unrecognized" } : addSharedTypesNpmWorkspace(rootPackageJson, sharedTypesRoot);
-    workspaceGlob = npmResult.status;
-    if (npmResult.status === "added" && write) tree.write("package.json", npmResult.text);
-  }
-  const mergeTag = (project, tag) => {
-    const target = parsedTargets.get(project);
-    if (!target) return { project, action: "added" };
-    const holder = target.kind === "project" ? target.parsed : target.parsed.nx ??= {};
-    const tags2 = holder.tags ?? [];
-    if (tags2.includes(tag)) return { project, action: "present" };
-    holder.tags = [...tags2, tag];
-    target.raw = appendJsonArrayItem(target.raw, target.kind === "project" ? ["tags"] : ["nx", "tags"], tag);
-    if (write) tree.write(target.path, target.raw);
-    return { project, action: "added" };
-  };
-  const tags = [
-    ...frontendProject === void 0 ? [] : [mergeTag(frontendProject, wiring.tagByRole.frontend)],
-    mergeTag(apiProjectName, wiring.tagByRole.backend),
-    ...withSharedTypes ? [mergeTag(wiring.sharedTypesPackageName, wiring.tagByRole.shared)] : []
-  ];
-  let tsconfigPaths = withSharedTypes ? "workspace-link" : "none";
-  const tsconfigRaw = withSharedTypes ? tree.read("tsconfig.base.json", "utf-8") : null;
-  if (tsconfigRaw !== null) {
-    try {
-      const tsconfig = JSON.parse(tsconfigRaw);
-      const baseUrl = tsconfig.compilerOptions?.baseUrl;
-      if (tsconfig.compilerOptions && (baseUrl || tsconfig.compilerOptions.paths !== void 0)) {
-        const paths = tsconfig.compilerOptions.paths ?? {};
-        if (paths[wiring.sharedTypesPackageName]) {
-          tsconfigPaths = "present";
-        } else {
-          tsconfigPaths = "added";
-          const entry = [`${baseUrl ? "" : "./"}${sharedTypesRoot}/src/index.ts`];
-          if (write) tree.write("tsconfig.base.json", setJsonValue(tsconfigRaw, ["compilerOptions", "paths", wiring.sharedTypesPackageName], entry));
-        }
-      }
-    } catch {
-      tsconfigPaths = "unrecognized";
-    }
-  }
-  let eslint;
-  let snippet;
-  if (!applyEslint) {
-    eslint = "snippet-only";
-    snippet = buildBoundarySnippet(boundaryTags);
-  } else {
-    const configPath = ESLINT_CONFIG_CANDIDATES.find((candidate) => tree.exists(candidate));
-    const configText = configPath ? tree.read(configPath, "utf-8") : null;
-    const result = configText !== null ? applyBoundaryConstraints(configText, boundaryTags) : { status: "unrecognized" };
-    if (result.status === "applied") {
-      eslint = "applied";
-      if (write && configPath) tree.write(configPath, result.text);
-    } else if (result.status === "already-applied") {
-      eslint = "already-applied";
-    } else {
-      eslint = "degraded-unrecognized";
-      snippet = buildBoundarySnippet(boundaryTags);
-    }
-  }
-  return {
-    ...base,
-    frontendProject,
-    sharedTypes,
-    tags,
-    workspaceGlob,
-    tsconfigPaths,
-    eslint,
-    snippet,
-    sharedTypesPackage: withSharedTypes ? wiring.sharedTypesPackageName : void 0,
-    sharedTypesRoot: withSharedTypes ? sharedTypesRoot : void 0,
-    config: configOutcome,
-    packageManager,
-    ...packageManagerNote !== void 0 ? { packageManagerNote } : {}
-  };
-}
-function readExpressPeerRange(tree) {
-  const raw = tree.read("node_modules/@nx/react/package.json", "utf-8");
-  if (raw === null) return void 0;
-  try {
-    const range = JSON.parse(raw).peerDependencies?.["express"];
-    return typeof range === "string" && range.trim().length > 0 ? range.trim() : void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function addBackendGenerator(tree, options) {
-  const dryRun = resolveDryRun(options);
-  const report = runAddBackend(tree, { ...options, dryRun });
-  console.log(renderAddBackendReport(report, dryRun));
-}
-var generator_default = addBackendGenerator;
+import {
+  addBackendGenerator,
+  generator_default,
+  runAddBackend
+} from "../_chunks/chunk-C2VVUWBA.js";
+import "../_chunks/chunk-QQNDYJTR.js";
+import "../_chunks/chunk-TXAQ2GJC.js";
+import "../_chunks/chunk-6ZTIUBB2.js";
+import "../_chunks/chunk-TUN34LAQ.js";
+import "../_chunks/chunk-EXYZLL7A.js";
+import "../_chunks/chunk-FQHFT5IH.js";
 export {
   addBackendGenerator,
   generator_default as default,