@clearlydev/nx-archweave 0.3.2 → 0.4.0

package/dist/generators/_chunks/chunk-H222FPLK.js

@@ -0,0 +1,80 @@
+// src/generators/slice/render.ts
+var ACTION_LINES = {
+  created: "created",
+  unchanged: "unchanged (already matches the generated content)",
+  skipped: "skipped \u2014 a slice with this name already exists with different content"
+};
+function renderSliceReport(report) {
+  const lines = [];
+  const label = `${report.layer} "${report.name}"`;
+  if (report.refused) {
+    lines.push(`${label}: refused \u2014 nothing was written.`);
+    lines.push("");
+    if (report.refusalReason === "invalid-name") {
+      lines.push(`  "${report.name}" is not a valid kebab-case slice name.`);
+      lines.push('  Use lowercase letters, digits, and single hyphens, starting with a letter (e.g. "add-to-cart").');
+    } else if (report.refusalReason === "invalid-public-api-name") {
+      lines.push("  The public API name is not a usable JavaScript identifier (or is a reserved word).");
+      lines.push('  Pass --publicApiName with a valid identifier, e.g. "addToCart" (this also happens when');
+      lines.push('  the slice name camelCases into a reserved word, like "class" or "delete").');
+    } else if (report.refusalReason === "project-not-found") {
+      lines.push(`  --project=${report.project} names no project in this workspace.`);
+    } else if (report.refusalReason === "ambiguous-frontend") {
+      lines.push("  More than one frontend app was found \u2014 rerun with --project=<one of them>:");
+      for (const name of report.candidates ?? []) lines.push(`    - ${name}`);
+      if ((report.recordedFrontends ?? []).length > 0) lines.push(`  (toolkit.config.json records: ${(report.recordedFrontends ?? []).join(", ")})`);
+    } else if (report.refusalReason === "invalid-project-json") {
+      lines.push(`  A project.json could not be parsed (${report.detail ?? "unknown"}) \u2014 fix it, then rerun.`);
+    } else if (report.refusalReason === "no-frontend-app" && (report.candidates ?? []).length > 0) {
+      lines.push("  No project was recognised as a frontend app. If one of these is it, rerun with --project=<name>:");
+      for (const name of report.candidates ?? []) lines.push(`    - ${name}`);
+    } else if (report.refusalReason === "no-frontend-app") {
+      lines.push("  The workspace has no projects to hold FSD layers \u2014 create a frontend app first.");
+    } else if (report.refusalReason === "invalid-segment") {
+      lines.push(`  --segments: "${report.detail ?? ""}" is not a valid segment name.`);
+      lines.push("  Use lowercase letters, digits, and single hyphens, starting with a letter (e.g. ui, api, lib).");
+    } else if (report.refusalReason === "group-on-shared") {
+      lines.push("  --group does not apply to shared: shared holds segments, not slices.");
+    } else if (report.refusalReason === "invalid-group") {
+      lines.push(`  --group: "${report.detail ?? ""}" is not a usable group name.`);
+      lines.push('  Use kebab-case (e.g. "mypage"), and not a segment name (ui, model, api, lib, config).');
+    } else if (report.refusalReason === "segments-on-shared") {
+      lines.push("  --segments does not apply to shared: a shared segment holds no segments of its own.");
+      lines.push("  Run the generator once per segment instead (e.g. --name=ui, then --name=api).");
+    } else {
+      const offender = report.detail ?? report.name;
+      lines.push(`  "${offender}" names what a segment contains, not what it is for.`);
+      lines.push("  Canonical FSD names segments by purpose \u2014 ui, api, model, lib, config \u2014 so the code stays");
+      lines.push("  findable by what it does (e.g. a date helper lives in shared/lib, a Button in shared/ui).");
+    }
+    return lines.join("\n");
+  }
+  if (report.dryRun) {
+    lines.push("dry-run \u2014 no files were written.");
+    lines.push("");
+  }
+  lines.push(`${label}: ${ACTION_LINES[report.action]}`);
+  if (report.action === "skipped") {
+    lines.push(`  ${report.directory} already exists and does not exactly match the generated content.`);
+    lines.push("  Pick a new slice name (a name collision is a signal to rename, not to merge)");
+    lines.push("  \u2014 or remove the existing directory manually first if you intended to replace it.");
+    return lines.join("\n");
+  }
+  if (report.specSkipped === "no-test-runner") {
+    lines.push("  no test runner found (jest or vitest) \u2014 no .spec.ts was written; pass --unitTestRunner=jest|vitest to add one.");
+  } else if (report.specSkipped === "none-requested") {
+    lines.push("  no .spec.ts was written (unitTestRunner: none).");
+  }
+  if (report.dryRun) {
+    for (const file of report.files) {
+      lines.push("");
+      lines.push(`${file.filePath}:`);
+      lines.push(file.content);
+    }
+  }
+  return lines.join("\n");
+}
+
+export {
+  renderSliceReport
+};