@fundamental-engine/create 0.9.1 → 0.9.3

package/README.md

@@ -8,15 +8,13 @@ npm create @fundamental-engine my-field-app
 npm create @fundamental-engine my-field-app -- --template react
 ```
 
-Three variants, all **signals-first** (the field draws nothing by default — it writes `--field-*` CSS
-variables your styles read; particles are one opt-in surface):
+Three variants, all **signals-first** (the field draws nothing by default — it writes `--field-*` CSS variables your styles read; particles are one opt-in surface):
 
 - **`vanilla`** (default) — a *contained, signals-only* field (`FieldField` + `bounds`, `render: 'none'`)
   over a real list. No canvas; the rows react through CSS. The "this is what it's for" starter.
 - **`web-component`** — the `<field-root>` custom element; works in any framework or plain HTML.
 - **`react`** — `<FieldField>` from `@fundamental-engine/react`.
 
-Each scaffolds a minimal Vite app you run with `npm install && npm run dev`. Every template is explicit
-about `render`, so it behaves the same whichever engine version it resolves to.
+Each scaffolds a minimal Vite app you run with `npm install && npm run dev`. Every template is explicit about `render`, so it behaves the same whichever engine version it resolves to.
 
 Run with no arguments for an interactive prompt (directory + template).

package/dist/index.js

@@ -1,15 +1,46 @@
 #!/usr/bin/env node
 import { fileURLToPath } from 'node:url';
 import { dirname, join, resolve, basename } from 'node:path';
+import { readFileSync } from 'node:fs';
 import { createInterface } from 'node:readline/promises';
 import { stdin, stdout, argv, cwd, exit } from 'node:process';
 import { scaffold, isTemplate, TEMPLATES } from "./scaffold.js";
-const templatesRoot = join(dirname(fileURLToPath(import.meta.url)), '../templates');
-function parseArgs(args) {
+const here = dirname(fileURLToPath(import.meta.url));
+const templatesRoot = join(here, '../templates');
+/** Read this package's own version from its package.json (for `--version`). */
+function selfVersion() {
+    try {
+        return JSON.parse(readFileSync(join(here, '../package.json'), 'utf8')).version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+const HELP = `create-fundamental-engine — scaffold a Fundamental starter (signals-first).
+
+Usage:
+  npm create @fundamental-engine [directory] [-- --template <name>]
+  create-fundamental-engine [directory] [--template <name>]
+
+Arguments:
+  directory                 target directory (default: my-field-app)
+
+Options:
+  -t, --template <name>     one of: ${TEMPLATES.join(', ')} (default: vanilla)
+  -h, --help                show this help and exit
+  -v, --version             print the version and exit
+
+With no TTY (CI / piped), directory and template must be passed as flags — there is no prompt.`;
+export { HELP, selfVersion };
+export function parseArgs(args) {
     const out = {};
     for (let i = 0; i < args.length; i++) {
         const a = args[i];
-        if (a === '--template' || a === '-t')
+        if (a === '--help' || a === '-h')
+            out.help = true;
+        else if (a === '--version' || a === '-v')
+            out.version = true;
+        else if (a === '--template' || a === '-t')
             out.template = args[++i];
         else if (a.startsWith('--template='))
             out.template = a.slice('--template='.length);
@@ -20,6 +51,14 @@ function parseArgs(args) {
 }
 async function main() {
     const args = parseArgs(argv.slice(2));
+    if (args.help) {
+        console.log(HELP);
+        return;
+    }
+    if (args.version) {
+        console.log(selfVersion());
+        return;
+    }
     let dir = args.dir;
     let template = args.template;
     const interactive = Boolean(stdin.isTTY && stdout.isTTY);
@@ -48,4 +87,8 @@ async function main() {
         `Next:\n  cd ${dir}\n  npm install\n  npm run dev\n\n` +
         `The field draws nothing by default — it writes --field-* signals your CSS reads. See src/ for the wiring.\n`);
 }
-void main();
+// Run only as the CLI entrypoint, so tests can `import` this module (for parseArgs / HELP) without
+// executing the scaffold flow.
+if (import.meta.url === `file://${argv[1]}` || argv[1] === fileURLToPath(import.meta.url)) {
+    void main();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fundamental-engine/create",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "type": "module",
   "description": "Scaffold a Fundamental starter — `npm create @fundamental-engine` — vanilla, React, or web-component, contained and signals-first by default.",
   "keywords": [

package/templates/react/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@fundamental-engine/react": "latest",
+    "@fundamental-engine/react": "^0.9.2",
     "react": "^18",
     "react-dom": "^18"
   },

package/templates/vanilla/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@fundamental-engine/vanilla": "latest"
+    "@fundamental-engine/vanilla": "^0.9.2"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/templates/web-component/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@fundamental-engine/elements": "latest"
+    "@fundamental-engine/elements": "^0.9.2"
   },
   "devDependencies": {
     "typescript": "^5.9.3",