@clearlydev/nx-archweave 0.3.2 → 0.3.3

package/dist/generators/_chunks/chunk-2WSX5YNB.js

@@ -0,0 +1,274 @@
+import {
+  resolveProjectType
+} from "./chunk-TXAQ2GJC.js";
+import {
+  readBoundaryTags
+} from "./chunk-6ZTIUBB2.js";
+import {
+  readToolkitConfig
+} from "./chunk-EXYZLL7A.js";
+
+// ../template-engine/dist/frameworks/profiles.js
+var ALL_LAYERS = ["app", "pages", "features", "entities", "shared"];
+var NEXT = {
+  id: "next",
+  recognised: true,
+  // Next.js's own app/ (App Router) directory is the composition root; FSD's Next.js guide
+  // names the FSD app and pages layers _app and _pages, since Next.js reads src/app and
+  // src/pages as its routers.
+  layers: ["pages", "features", "entities", "shared"],
+  layerDirs: { app: "_app", pages: "_pages" },
+  buildOutputDirs: [".next", "out"],
+  platformSuffixes: [],
+  routerDirs: ["pages"]
+};
+var REACT_VITE = {
+  id: "react-vite",
+  recognised: true,
+  layers: ALL_LAYERS,
+  layerDirs: {},
+  buildOutputDirs: ["dist"],
+  platformSuffixes: [],
+  routerDirs: []
+};
+var EXPO_ROUTER = {
+  id: "expo",
+  recognised: true,
+  layers: ALL_LAYERS,
+  layerDirs: { app: "_app" },
+  buildOutputDirs: [".expo", "dist"],
+  platformSuffixes: ["ios", "android", "native", "web"],
+  routerDirs: []
+};
+var EXPO = { ...EXPO_ROUTER, layerDirs: {} };
+var GENERIC = {
+  id: "generic",
+  recognised: false,
+  layers: ALL_LAYERS,
+  layerDirs: {},
+  buildOutputDirs: ["dist", "build"],
+  platformSuffixes: [],
+  routerDirs: []
+};
+var PROFILES = { next: NEXT, "react-vite": REACT_VITE, expo: EXPO_ROUTER, generic: GENERIC };
+function profileById(id) {
+  return PROFILES[id];
+}
+function allFrameworkProfiles() {
+  return Object.values(PROFILES);
+}
+var NEXT_CONFIGS = ["next.config.js", "next.config.mjs", "next.config.ts", "next.config.cjs"];
+var VITE_CONFIGS = ["vite.config.ts", "vite.config.mts", "vite.config.js", "vite.config.mjs"];
+var EXPO_CONFIGS = ["app.config.ts", "app.config.js", "app.config.mjs"];
+function hasExpoKey(input, file) {
+  const text = input.read(file);
+  if (typeof text !== "string")
+    return false;
+  try {
+    return typeof JSON.parse(text)["expo"] === "object";
+  } catch {
+    return false;
+  }
+}
+function dependsOn(input, manifest, name) {
+  const text = input.read(manifest);
+  if (typeof text !== "string")
+    return false;
+  try {
+    const parsed = JSON.parse(text);
+    return ["dependencies", "devDependencies", "peerDependencies"].some((field) => parsed[field]?.[name] !== void 0);
+  } catch {
+    return false;
+  }
+}
+function detectFramework(input) {
+  const prefix = input.projectRoot === "" || input.projectRoot === "." ? "" : `${input.projectRoot}/`;
+  const executors = input.executors ?? [];
+  if (NEXT_CONFIGS.some((file) => input.exists(`${prefix}${file}`)) || executors.some((executor) => executor.startsWith("@nx/next:"))) {
+    return NEXT;
+  }
+  const dependsAnywhere = (name) => dependsOn(input, `${prefix}package.json`, name) || dependsOn(input, "package.json", name);
+  const usesExpo = executors.some((executor) => executor.startsWith("@nx/expo:")) || hasExpoKey(input, `${prefix}app.json`) || EXPO_CONFIGS.some((file) => input.exists(`${prefix}${file}`)) || dependsOn(input, `${prefix}package.json`, "expo");
+  if (usesExpo)
+    return dependsAnywhere("expo-router") ? EXPO_ROUTER : EXPO;
+  const usesReact = dependsAnywhere("react");
+  const usesVite = VITE_CONFIGS.some((file) => input.exists(`${prefix}${file}`)) || executors.some((executor) => executor.startsWith("@nx/vite:"));
+  if (usesVite && usesReact)
+    return REACT_VITE;
+  return GENERIC;
+}
+
+// src/generators/shared/frontend-app.ts
+import { getProjects } from "@nx/devkit";
+
+// ../template-engine/dist/fsd/slice-rules.js
+function toCamelCase(kebabName) {
+  return kebabName.split("-").filter((part) => part.length > 0).map((part, index) => index === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
+function resolveSlicePublicApiName(name, publicApiName) {
+  return publicApiName ?? toCamelCase(name);
+}
+var IDENTIFIER_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+var RESERVED_WORDS = /* @__PURE__ */ new Set([
+  "await",
+  "break",
+  "case",
+  "catch",
+  "class",
+  "const",
+  "continue",
+  "debugger",
+  "default",
+  "delete",
+  "do",
+  "else",
+  "enum",
+  "export",
+  "extends",
+  "false",
+  "finally",
+  "for",
+  "function",
+  "if",
+  "implements",
+  "import",
+  "in",
+  "instanceof",
+  "interface",
+  "let",
+  "new",
+  "null",
+  "package",
+  "private",
+  "protected",
+  "public",
+  "return",
+  "static",
+  "super",
+  "switch",
+  "this",
+  "throw",
+  "true",
+  "try",
+  "typeof",
+  "var",
+  "void",
+  "while",
+  "with",
+  "yield"
+]);
+function isUsableSliceApiName(candidate) {
+  return IDENTIFIER_PATTERN.test(candidate) && !RESERVED_WORDS.has(candidate);
+}
+var ESSENCE_SEGMENT_NAMES = [
+  "components",
+  "hooks",
+  "helpers",
+  "utils",
+  "types",
+  "constants",
+  "consts",
+  "interfaces",
+  "enums",
+  "modals",
+  "stores",
+  "services"
+];
+function isEssenceSegmentName(name) {
+  return ESSENCE_SEGMENT_NAMES.includes(name);
+}
+var SEGMENT_NAME_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+
+// src/generators/shared/frontend-app.ts
+var baseNameOf = (root) => root.split("/").pop() ?? root;
+function isEndToEnd(root) {
+  const dir = baseNameOf(root);
+  return dir === "e2e" || dir.endsWith("-e2e");
+}
+function isBackend(root, config, backendTag) {
+  return baseNameOf(root) === "api" || (config.tags ?? []).includes(backendTag);
+}
+function prefixOf(root) {
+  return root === "" || root === "." ? "" : `${root}/`;
+}
+function sourceRootOf(tree, config) {
+  const prefix = prefixOf(config.root);
+  const declared = config.sourceRoot?.replace(/\/$/, "");
+  const atRoot = declared !== void 0 && (declared === config.root || prefix === "" && (declared === "." || declared === ""));
+  if (declared && !atRoot) return declared;
+  if (atRoot && !tree.exists(`${prefix}src`)) return prefix === "" ? "." : config.root;
+  return `${prefix}src`;
+}
+function frameworkOf(tree, config) {
+  return detectFramework({
+    exists: (path) => tree.exists(path),
+    read: (path) => tree.read(path, "utf-8"),
+    projectRoot: config.root,
+    executors: Object.values(config.targets ?? {}).flatMap((target) => target.executor ? [target.executor] : [])
+  });
+}
+function resolveFrontendApp(tree, explicitProject) {
+  let projects;
+  try {
+    projects = getProjects(tree);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const pathMatch = /Cannot parse ([^:]+):/.exec(message);
+    return { kind: "invalid-project-json", detail: pathMatch ? pathMatch[1] : message };
+  }
+  const found = (project2, config2) => {
+    const profile = frameworkOf(tree, config2);
+    return { kind: "found", project: project2, root: config2.root, sourceRoot: sourceRootOf(tree, config2), framework: profile.id, profile };
+  };
+  if (explicitProject !== void 0) {
+    const config2 = projects.get(explicitProject);
+    if (config2) return found(explicitProject, config2);
+    const rootApp = inferredRootApp(tree, projects);
+    return rootApp?.kind === "found" && rootApp.project === explicitProject ? rootApp : { kind: "not-found", project: explicitProject };
+  }
+  const backendTag = readBoundaryTags(readToolkitConfig(tree)).backend;
+  const eligible = [...projects.entries()].filter(([, config2]) => !isEndToEnd(config2.root) && !isBackend(config2.root, config2, backendTag));
+  const declared = eligible.filter(([, config2]) => config2.projectType === "application");
+  const inferred = eligible.filter(([, config2]) => {
+    if (config2.projectType !== void 0) return false;
+    if (config2.root === "" || config2.root === ".") return frameworkOf(tree, config2).recognised;
+    return resolveProjectType(tree, config2.root, void 0) === "application";
+  });
+  const candidates = (declared.length > 0 ? declared : inferred).sort(([a], [b]) => a.localeCompare(b));
+  if (candidates.length === 0) {
+    const rootApp = inferredRootApp(tree, projects);
+    if (rootApp !== null) return rootApp;
+    const otherProjects = [...projects.keys()].filter((name) => !isEndToEnd(projects.get(name)?.root ?? "")).sort();
+    return { kind: "none", otherProjects };
+  }
+  if (candidates.length > 1) return { kind: "ambiguous", candidates: candidates.map(([name]) => name) };
+  const [project, config] = candidates[0];
+  return found(project, config);
+}
+function inferredRootApp(tree, projects) {
+  if ([...projects.values()].some((config2) => config2.root === "" || config2.root === ".")) return null;
+  const raw = tree.read("package.json", "utf-8");
+  if (raw === null) return null;
+  let name;
+  try {
+    name = JSON.parse(raw).name;
+  } catch {
+    return null;
+  }
+  if (typeof name !== "string" || name === "") return null;
+  const config = { name, root: "." };
+  const framework = frameworkOf(tree, config);
+  if (!framework.recognised) return null;
+  return { kind: "found", project: name, root: ".", sourceRoot: sourceRootOf(tree, config), framework: framework.id, profile: framework, inferredRoot: true };
+}
+
+export {
+  profileById,
+  allFrameworkProfiles,
+  resolveSlicePublicApiName,
+  isUsableSliceApiName,
+  isEssenceSegmentName,
+  SEGMENT_NAME_PATTERN,
+  sourceRootOf,
+  resolveFrontendApp
+};

package/dist/generators/_chunks/chunk-34V6HAJT.js

@@ -0,0 +1,55 @@
+// ../shared/dist/lib/spawnable-command.js
+import { statSync } from "node:fs";
+import { win32 } from "node:path";
+function isFile(path) {
+  try {
+    return statSync(path).isFile();
+  } catch {
+    return false;
+  }
+}
+var DEFAULT_ENV = { platform: process.platform, env: process.env, isFile };
+function envValue(env, name) {
+  const key = Object.keys(env).find((candidate) => candidate.toUpperCase() === name);
+  return key === void 0 ? void 0 : env[key];
+}
+function resolveWindowsCommand(command, environment) {
+  const exts = (envValue(environment.env, "PATHEXT") ?? ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean);
+  const candidates = (base) => win32.extname(base) !== "" ? [base] : exts.map((ext) => base + ext);
+  if (win32.isAbsolute(command) || /[\\/]/.test(command)) {
+    return candidates(command).find(environment.isFile);
+  }
+  const dirs = (envValue(environment.env, "PATH") ?? "").split(";").filter(Boolean);
+  for (const dir of dirs) {
+    const found = candidates(win32.join(dir, command)).find(environment.isFile);
+    if (found !== void 0)
+      return found;
+  }
+  return void 0;
+}
+var META_CHARS = /([()\][%!^"`<>&|;, *?])/g;
+var BIN_SHIM = /node_modules[\\/]\.bin[\\/][^\\/]+\.cmd$/i;
+function escapeCmdArgument(arg, doubleEscape = false) {
+  let quoted = arg.replace(/(\\*)"/g, '$1$1\\"');
+  quoted = quoted.replace(/(\\*)$/, "$1$1");
+  const escaped = `"${quoted}"`.replace(META_CHARS, "^$1");
+  return doubleEscape ? escaped.replace(META_CHARS, "^$1") : escaped;
+}
+function spawnableCommand(command, args, environment = DEFAULT_ENV) {
+  if (environment.platform !== "win32")
+    return { command, args: [...args] };
+  const resolved = resolveWindowsCommand(command, environment);
+  if (resolved === void 0 || !/\.(cmd|bat)$/i.test(resolved))
+    return { command, args: [...args] };
+  const doubleEscape = BIN_SHIM.test(resolved);
+  const line = [resolved.replace(META_CHARS, "^$1"), ...args.map((arg) => escapeCmdArgument(arg, doubleEscape))].join(" ");
+  return {
+    command: envValue(environment.env, "COMSPEC") ?? "cmd.exe",
+    args: ["/d", "/s", "/c", `"${line}"`],
+    windowsVerbatimArguments: true
+  };
+}
+
+export {
+  spawnableCommand
+};

package/dist/generators/_chunks/chunk-3A6RZUCZ.js

@@ -0,0 +1,114 @@
+// src/generators/add-review/render.ts
+var DEPENDABOT_PATH = ".github/dependabot.yml";
+var PROVIDER_STATUS_URL = "https://github.com/clearlydev/nx-archweave/blob/main/docs/pr-review.md#provider-status";
+function renderLineDiff(existing, generated) {
+  const a = existing.split("\n");
+  const b = generated.split("\n");
+  const m = a.length;
+  const n = b.length;
+  const lcs = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+  for (let i2 = m - 1; i2 >= 0; i2--) {
+    for (let j2 = n - 1; j2 >= 0; j2--) {
+      lcs[i2][j2] = a[i2] === b[j2] ? lcs[i2 + 1][j2 + 1] + 1 : Math.max(lcs[i2 + 1][j2], lcs[i2][j2 + 1]);
+    }
+  }
+  const out = ["--- existing", "+++ generated"];
+  let i = 0;
+  let j = 0;
+  while (i < m && j < n) {
+    if (a[i] === b[j]) {
+      out.push(`  ${a[i]}`);
+      i++;
+      j++;
+    } else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
+      out.push(`- ${a[i]}`);
+      i++;
+    } else {
+      out.push(`+ ${b[j]}`);
+      j++;
+    }
+  }
+  while (i < m) out.push(`- ${a[i++]}`);
+  while (j < n) out.push(`+ ${b[j++]}`);
+  return out.join("\n");
+}
+var WORKFLOW_ACTION_LINES = {
+  created: "created",
+  overwritten: "overwritten with the generated version (per --onConflict=overwrite)",
+  unchanged: "unchanged (already matches the generated version)",
+  proposed: "NOT written \u2014 differs from the generated version (merge proposal below)",
+  skipped: "left as-is (per --onConflict=skip)",
+  alternate: "generated alongside the existing file",
+  aborted: "NOT written"
+};
+var CONFIG_ACTION_LINES = {
+  created: "created with the review field",
+  updated: "review field updated",
+  unchanged: "review field unchanged",
+  "not-updated": "NOT updated \u2014 kept consistent with the workflow file that is actually in effect",
+  aborted: "NOT updated"
+};
+function renderAddReviewReport(report) {
+  const lines = [];
+  if (report.packageManagerNote !== void 0) {
+    lines.push(`Note: ${report.packageManagerNote}`);
+  }
+  if (report.workflowAction === "aborted") {
+    lines.push("add-review aborted \u2014 nothing was written.");
+    lines.push(`  toolkit.config.json: ${report.configError ?? "unusable"}`);
+    lines.push("  Fix the config file manually, then rerun the generator.");
+    return lines.join("\n");
+  }
+  if (report.dryRun) {
+    lines.push("add-review dry-run \u2014 no files were written.");
+    lines.push("");
+    lines.push("Generated workflow YAML:");
+    lines.push(report.workflowYaml ?? "");
+    lines.push("");
+    lines.push("toolkit.config.json review field:");
+    lines.push(report.configSnippetJson ?? "");
+    lines.push("");
+    lines.push("Effective decision:");
+  }
+  lines.push(`  ${report.workflowPath}: ${WORKFLOW_ACTION_LINES[report.workflowAction]}`);
+  lines.push(`  toolkit.config.json: ${CONFIG_ACTION_LINES[report.configAction]}`);
+  if (report.workflowAction === "proposed" && report.diff) {
+    lines.push("");
+    lines.push(report.diff);
+    lines.push("");
+    lines.push("To resolve, rerun with one of:");
+    lines.push("  --onConflict=overwrite            replace the existing file with the generated version");
+    lines.push("  --onConflict=skip                 keep the existing file");
+    lines.push("  --onConflict=alternate-filename   write the generated version alongside it");
+  }
+  if (report.dependabot === "created") {
+    lines.push(`  ${DEPENDABOT_PATH}: created \u2014 Dependabot proposes newer pins for the workflow's actions`);
+  } else if (report.dependabot === "present") {
+    lines.push(`  ${DEPENDABOT_PATH}: already updates github-actions`);
+  } else if (report.dependabot === "proposed") {
+    lines.push(`  ${DEPENDABOT_PATH}: NOT changed \u2014 it has no github-actions entry. The workflow pins each action`);
+    lines.push("  to a commit SHA; add this entry under `updates:` so those pins get update pull requests:");
+    lines.push("");
+    lines.push(report.dependabotProposal ?? "");
+  }
+  if (report.workflowAction === "alternate") {
+    lines.push("");
+    lines.push("  Review the generated file, then replace the main workflow file with it yourself;");
+    lines.push("  the config stays pointing at the workflow that is actually in effect until you do.");
+  }
+  lines.push("");
+  lines.push(`Note: the review workflow stays green-skipped until you register the ${report.requiredSecretName} secret.`);
+  if (report.betaProvider !== void 0) {
+    lines.push(`Note: the ${report.betaProvider} provider is in beta \u2014 its workflow hasn't finished a review end to end on`);
+    lines.push(`GitHub Actions yet. Status, costs and known issues: ${PROVIDER_STATUS_URL}`);
+  }
+  lines.push("Note: this workflow runs with elevated permissions only after it is merged to the default branch \u2014");
+  lines.push("merging is the first real validation.");
+  return lines.join("\n");
+}
+
+export {
+  DEPENDABOT_PATH,
+  renderLineDiff,
+  renderAddReviewReport
+};

package/dist/generators/_chunks/chunk-47T7NOPP.js

@@ -0,0 +1,30 @@
+import {
+  TOOLKIT_CONFIG_PATH,
+  workspacePackageManager
+} from "./chunk-EXYZLL7A.js";
+import {
+  packageManagerCommands
+} from "./chunk-FQHFT5IH.js";
+
+// src/generators/shared/run-nx.ts
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+function runNxFor(exists, read) {
+  let config = null;
+  try {
+    const parsed = JSON.parse(read(TOOLKIT_CONFIG_PATH) ?? "null");
+    if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) config = parsed;
+  } catch {
+  }
+  return packageManagerCommands(workspacePackageManager(exists, read, config) ?? "pnpm").runNx;
+}
+function diskRunNx(root) {
+  return runNxFor(
+    (path) => existsSync(join(root, path)),
+    (path) => existsSync(join(root, path)) ? readFileSync(join(root, path), "utf-8") : void 0
+  );
+}
+
+export {
+  diskRunNx
+};

package/dist/generators/_chunks/chunk-5MI3O4VZ.js

@@ -0,0 +1,99 @@
+// src/eslint/fsd-policy.ts
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+var PRESETS = {
+  basic: {
+    sliceGroups: { auto: true, include: [], exclude: [] },
+    sharedPublicApi: "segment",
+    testFiles: false,
+    segments: [],
+    platformSuffixes: [],
+    routerDirs: []
+  },
+  practical: {
+    sliceGroups: { auto: true, include: [], exclude: [] },
+    sharedPublicApi: "file",
+    testFiles: ["**/*.{spec,test}.*", "**/__tests__/**"],
+    segments: [],
+    platformSuffixes: [],
+    routerDirs: []
+  }
+};
+var isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
+function resolveFsdPolicy(recorded, overrides = {}) {
+  const fsd = typeof recorded === "object" && recorded !== null ? recorded : {};
+  const preset = fsd["preset"] === "practical" ? "practical" : "basic";
+  const policy = { ...PRESETS[preset] };
+  const groups = fsd["sliceGroups"];
+  if (groups === false) policy.sliceGroups = false;
+  else if (groups === "auto") policy.sliceGroups = { auto: true, include: [], exclude: [] };
+  else if (typeof groups === "object" && groups !== null) {
+    const value = groups;
+    policy.sliceGroups = {
+      auto: value["auto"] !== false,
+      include: isStringArray(value["include"]) ? value["include"] : [],
+      exclude: isStringArray(value["exclude"]) ? value["exclude"] : []
+    };
+  }
+  const shared = fsd["sharedPublicApi"];
+  if (shared === "segment" || shared === "component" || shared === "file") policy.sharedPublicApi = shared;
+  const tests = fsd["testFiles"];
+  if (tests === false || isStringArray(tests)) policy.testFiles = tests;
+  if (isStringArray(fsd["segments"])) policy.segments = fsd["segments"];
+  if (isStringArray(fsd["platformSuffixes"])) policy.platformSuffixes = fsd["platformSuffixes"];
+  if (isStringArray(fsd["routerDirs"])) policy.routerDirs = fsd["routerDirs"];
+  for (const [key, value] of Object.entries(overrides)) {
+    if (value !== void 0) policy[key] = value;
+  }
+  return policy;
+}
+function readRecordedFsd(from) {
+  for (let dir = from; ; dir = dirname(dir)) {
+    const file = join(dir, "toolkit.config.json");
+    if (existsSync(file)) {
+      try {
+        return JSON.parse(readFileSync(file, "utf-8"))["fsd"];
+      } catch {
+        return void 0;
+      }
+    }
+    if (dirname(dir) === dir) return void 0;
+  }
+}
+var escapeLiteral = (text) => text.replace(/[.+^$()|[\]\\{}]/g, "\\$&");
+function wildcardsToRegExp(glob) {
+  let source = "";
+  for (let i = 0; i < glob.length; i++) {
+    const ch = glob[i];
+    if (ch === "*" && glob[i + 1] === "*") {
+      const slash = glob[i + 2] === "/";
+      source += slash ? "(?:.*/)?" : ".*";
+      i += slash ? 2 : 1;
+    } else if (ch === "*") source += "[^/]*";
+    else if (ch === "?") source += "[^/]";
+    else source += escapeLiteral(ch);
+  }
+  return source;
+}
+function globToRegExp(glob) {
+  let source = "";
+  let rest = glob;
+  for (; ; ) {
+    const open = rest.indexOf("{");
+    const close = open === -1 ? -1 : rest.indexOf("}", open);
+    if (open === -1 || close === -1) {
+      source += wildcardsToRegExp(rest);
+      break;
+    }
+    source += wildcardsToRegExp(rest.slice(0, open));
+    source += `(?:${rest.slice(open + 1, close).split(",").map(wildcardsToRegExp).join("|")})`;
+    rest = rest.slice(close + 1);
+  }
+  return new RegExp(`^${source}$`);
+}
+
+export {
+  resolveFsdPolicy,
+  readRecordedFsd,
+  globToRegExp
+};