create-nx-archweave 0.1.0 → 0.1.1

package/README.md

@@ -185,7 +185,7 @@ The printed next steps cover the first commit. If review is enabled, they also c
 
 - `nx build create-nx-archweave` runs tsc, for local dev and typecheck.
 - `nx test` runs Jest.
-- `nx bundle` (depends on `build`) uses esbuild to bundle `src/index.ts` and `src/bin.ts` into `dist/`. The `bin.js` shebang is preserved, and only `tslib` stays external.
+- `nx bundle` (depends on `build`) uses esbuild to bundle `src/index.ts` and `src/bin.ts` into `dist/`. The `bin.js` shebang is preserved, and the CLI has no runtime dependencies.
 - The CLI has no runtime import of the plugin. It only names the plugin as an install spec.
 
 ## License

package/dist/bin.js

@@ -153,6 +153,25 @@ function describeResolution(resolution) {
   return `${name} (${SOURCE_TEXT[resolution.source]})`;
 }
 
+// src/cli/workspace-name.ts
+var MAX_LENGTH = 214;
+var EXAMPLE = "my-app";
+function workspaceNameProblem(name) {
+  if (name.length === 0) return "it is empty";
+  if (/\s/.test(name)) return "it contains whitespace";
+  if (name.length > MAX_LENGTH) return `it is ${name.length} characters long, and npm allows at most ${MAX_LENGTH}`;
+  if (name.startsWith(".") || name.startsWith("_")) return `it starts with "${name[0]}"`;
+  if (/[A-Z]/.test(name)) return "it contains uppercase letters, and npm package names are lowercase";
+  const others = [...new Set(name.replace(/[a-z0-9._-]/g, ""))];
+  if (others.length > 0) {
+    return `it contains ${others.map((char) => `"${char}"`).join(", ")} \u2014 only lowercase letters, digits, "-", "_" and "." are allowed`;
+  }
+  return void 0;
+}
+function invalidWorkspaceNameMessage(name, problem) {
+  return `Invalid workspace name "${name}": ${problem}. For example: ${EXAMPLE}`;
+}
+
 // src/cli/parse-args.ts
 var STRING_VALUE_FLAGS = /* @__PURE__ */ new Set(["--preset", "--frontend", "--backend", "--locale", "--ai-hosts", "--plugins", "--review-provider", "--plugin-source", "--package-manager"]);
 function extractReviewFlag(argv) {
@@ -216,6 +235,10 @@ function parseCliArgs(argv) {
     };
   }
   const name = parsed.positionals[0];
+  const nameProblem = name === void 0 ? void 0 : workspaceNameProblem(name);
+  if (name !== void 0 && nameProblem !== void 0) {
+    return { kind: "error", message: invalidWorkspaceNameMessage(name, nameProblem) };
+  }
   const preset = parsed.values.preset;
   if (preset !== void 0 && !PRESET_VALUES.includes(preset)) {
     return { kind: "error", message: invalidChoiceMessage("--preset", preset, PRESET_VALUES) };

package/dist/cli/parse-args.js

@@ -1,6 +1,7 @@
 import { parseArgs as parseNodeArgs } from 'node:util';
 import { AI_HOST_VALUES, BACKEND_VALUES, FRONTEND_VALUES, LOCALE_VALUES, PLUGIN_VALUES, PRESET_VALUES, REVIEW_PROVIDER_VALUES, } from "./types.js";
 import { isCliPackageManager } from "./package-manager.js";
+import { invalidWorkspaceNameMessage, workspaceNameProblem } from "./workspace-name.js";
 /** The string-valued flags declared below, in their separated two-token form
  * (`--preset solo`). extractReviewFlag must never treat the token AFTER one of
  * these as a review flag — it is that flag's value, so both tokens pass through
@@ -88,6 +89,10 @@ export function parseCliArgs(argv) {
         };
     }
     const name = parsed.positionals[0];
+    const nameProblem = name === undefined ? undefined : workspaceNameProblem(name);
+    if (name !== undefined && nameProblem !== undefined) {
+        return { kind: 'error', message: invalidWorkspaceNameMessage(name, nameProblem) };
+    }
     const preset = parsed.values.preset;
     if (preset !== undefined && !PRESET_VALUES.includes(preset)) {
         return { kind: 'error', message: invalidChoiceMessage('--preset', preset, PRESET_VALUES) };

package/dist/cli/workspace-name.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Why `name` can't be a workspace name, or undefined when it can. The name becomes the
+ * directory and the root package.json name, and it reaches create-nx-workspace as an
+ * argument — on Windows through cmd.exe — so only npm's package-name characters pass:
+ * lowercase letters, digits, "-", "_" and ".", not starting with "." or "_".
+ */
+export declare function workspaceNameProblem(name: string): string | undefined;
+export declare function invalidWorkspaceNameMessage(name: string, problem: string): string;
+//# sourceMappingURL=workspace-name.d.ts.map

package/dist/cli/workspace-name.js

@@ -0,0 +1,29 @@
+/** npm's limit on a package name, which the workspace name becomes. */
+const MAX_LENGTH = 214;
+const EXAMPLE = 'my-app';
+/**
+ * Why `name` can't be a workspace name, or undefined when it can. The name becomes the
+ * directory and the root package.json name, and it reaches create-nx-workspace as an
+ * argument — on Windows through cmd.exe — so only npm's package-name characters pass:
+ * lowercase letters, digits, "-", "_" and ".", not starting with "." or "_".
+ */
+export function workspaceNameProblem(name) {
+    if (name.length === 0)
+        return 'it is empty';
+    if (/\s/.test(name))
+        return 'it contains whitespace';
+    if (name.length > MAX_LENGTH)
+        return `it is ${name.length} characters long, and npm allows at most ${MAX_LENGTH}`;
+    if (name.startsWith('.') || name.startsWith('_'))
+        return `it starts with "${name[0]}"`;
+    if (/[A-Z]/.test(name))
+        return 'it contains uppercase letters, and npm package names are lowercase';
+    const others = [...new Set(name.replace(/[a-z0-9._-]/g, ''))];
+    if (others.length > 0) {
+        return `it contains ${others.map((char) => `"${char}"`).join(', ')} — only lowercase letters, digits, "-", "_" and "." are allowed`;
+    }
+    return undefined;
+}
+export function invalidWorkspaceNameMessage(name, problem) {
+    return `Invalid workspace name "${name}": ${problem}. For example: ${EXAMPLE}`;
+}

package/dist/index.js

@@ -50,6 +50,25 @@ function isCliPackageManager(name) {
   return SUPPORTED.includes(name);
 }
 
+// src/cli/workspace-name.ts
+var MAX_LENGTH = 214;
+var EXAMPLE = "my-app";
+function workspaceNameProblem(name) {
+  if (name.length === 0) return "it is empty";
+  if (/\s/.test(name)) return "it contains whitespace";
+  if (name.length > MAX_LENGTH) return `it is ${name.length} characters long, and npm allows at most ${MAX_LENGTH}`;
+  if (name.startsWith(".") || name.startsWith("_")) return `it starts with "${name[0]}"`;
+  if (/[A-Z]/.test(name)) return "it contains uppercase letters, and npm package names are lowercase";
+  const others = [...new Set(name.replace(/[a-z0-9._-]/g, ""))];
+  if (others.length > 0) {
+    return `it contains ${others.map((char) => `"${char}"`).join(", ")} \u2014 only lowercase letters, digits, "-", "_" and "." are allowed`;
+  }
+  return void 0;
+}
+function invalidWorkspaceNameMessage(name, problem) {
+  return `Invalid workspace name "${name}": ${problem}. For example: ${EXAMPLE}`;
+}
+
 // src/cli/parse-args.ts
 var STRING_VALUE_FLAGS = /* @__PURE__ */ new Set(["--preset", "--frontend", "--backend", "--locale", "--ai-hosts", "--plugins", "--review-provider", "--plugin-source", "--package-manager"]);
 function extractReviewFlag(argv) {
@@ -113,6 +132,10 @@ function parseCliArgs(argv) {
     };
   }
   const name = parsed.positionals[0];
+  const nameProblem = name === void 0 ? void 0 : workspaceNameProblem(name);
+  if (name !== void 0 && nameProblem !== void 0) {
+    return { kind: "error", message: invalidWorkspaceNameMessage(name, nameProblem) };
+  }
   const preset = parsed.values.preset;
   if (preset !== void 0 && !PRESET_VALUES.includes(preset)) {
     return { kind: "error", message: invalidChoiceMessage("--preset", preset, PRESET_VALUES) };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nx-archweave",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "One command from an empty directory to a configured Nx workspace: FSD Lite structure, AI agent rules, GitHub templates, and optional AI PR review (Claude, Gemini, GPT, Cursor)",
   "license": "MIT",
   "author": "clearlydev (https://github.com/clearlydev)",
@@ -74,8 +74,5 @@
         ]
       }
     }
-  },
-  "dependencies": {
-    "tslib": "^2.3.0"
   }
 }