kreftjs 0.0.2-beta → 0.0.4-beta

package/bin/update.js

@@ -1,18 +1,18 @@
 /*
- * kreftjs update [packages...]
+ * kreft update [packages...]
  *
  * Updates npm dependencies and/or Kreft runtime files in the current project:
  *
- *   kreftjs update                 Update all packages (npm update) and refresh kreftjs.js / kreftjs.d.ts
- *   kreftjs update <package...>    Update specific npm package(s)
- *   kreftjs update --latest        Upgrade dependencies to their latest versions
- *   kreftjs update --check         Check for outdated packages without installing (npm outdated)
- *   kreftjs update --core          Update only Kreft runtime files (kreftjs.js, kreftjs.d.ts, server.d.ts)
- *   kreftjs update --npm           Update only npm packages
+ *   kreft update                 Update all packages (npm update) and refresh kreftjs.js / kreftjs.d.ts
+ *   kreft update <package...>    Update specific npm package(s)
+ *   kreft update --latest        Upgrade dependencies to their latest versions
+ *   kreft update --check         Check for outdated packages without installing (npm outdated)
+ *   kreft update --core          Update only Kreft runtime files (kreftjs.js, kreftjs.d.ts, server.d.ts)
+ *   kreft update --npm           Update only npm packages
  */
 const fs = require('fs');
 const path = require('path');
-const { spawnSync } = require('child_process');
+const { runSync } = require('./win-spawn.js');
 const { layout } = require('./layout.js');
 const pkg = require('../package.json');
 
@@ -180,7 +180,7 @@ function updateNpmPackages(project, pkgs, flags) {
 
   if (flags.has('check')) {
     console.log(`  ${cyan('Checking for outdated packages (npm outdated):')}\n`);
-    const res = spawnSync(npmCmd, ['outdated'], { stdio: 'inherit', cwd: project });
+    const res = runSync(npmCmd, ['outdated'], { stdio: 'inherit', cwd: project });
     if (res.status === 0) {
       console.log(`  ${green('All packages are up to date.')}`);
     }
@@ -210,7 +210,7 @@ function updateNpmPackages(project, pkgs, flags) {
   }
 
   console.log(`  ${dim('$ ' + npmCmd + ' ' + cmdArgs.join(' '))}\n`);
-  const result = spawnSync(npmCmd, cmdArgs, { stdio: 'inherit', cwd: project });
+  const result = runSync(npmCmd, cmdArgs, { stdio: 'inherit', cwd: project });
 
   if (result.error) {
     console.error(`  ${red('Error running npm:')} ${result.error.message}`);
@@ -226,12 +226,12 @@ function updateNpmPackages(project, pkgs, flags) {
 function printHelp() {
   console.log(`
   Usage:
-    kreftjs update [package...]     Update project packages and Kreft runtime files
-    kreftjs update                  Update all packages in package.json and refresh kreftjs.js
-    kreftjs update <name>           Update a specific package (e.g. kreftjs update esbuild)
-    kreftjs update --latest         Upgrade packages to their latest versions
-    kreftjs update --check          Check for outdated packages (npm outdated)
-    kreftjs update --core           Update only Kreft runtime files (kreftjs.js, kreftjs.d.ts, server.d.ts)
-    kreftjs update --npm            Update only npm dependencies
+    kreft update [package...]     Update project packages and Kreft runtime files
+    kreft update                  Update all packages in package.json and refresh kreftjs.js
+    kreft update <name>           Update a specific package (e.g. kreft update esbuild)
+    kreft update --latest         Upgrade packages to their latest versions
+    kreft update --check          Check for outdated packages (npm outdated)
+    kreft update --core           Update only Kreft runtime files (kreftjs.js, kreftjs.d.ts, server.d.ts)
+    kreft update --npm            Update only npm dependencies
 `);
 }

package/bin/urls-file.js

@@ -1,5 +1,5 @@
 /*
- * A list of page addresses from a file, for `kreftjs build --prerender --urls urls.js` and `kreftjs sitemap --urls urls.js`.
+ * A list of page addresses from a file, for `kreft build --prerender --urls urls.js` and `kreft sitemap --urls urls.js`.
  *
  *   urls.json   ["/posts/1", "/posts/2"]  or  [{ "path": "/posts/1", "lastmod": "2026-01-02" }]
  *   urls.txt    one address per line (# starts a comment)

package/bin/vite.js

@@ -2,13 +2,13 @@
  * Vite.js Bundler & Dev Server Integration for Kreft
  *
  * Commands:
- *   kreftjs vite:init       Add Vite configuration and dependencies to an existing project (alias: kreftjs make:vite)
- *   kreftjs vite:dev        Start ultra-fast Vite dev server with instant HMR and backend proxy (alias: kreftjs vite)
- *   kreftjs vite:build      Build optimized static frontend with Rollup and code-splitting
- *   kreftjs vite:preview    Preview production bundle locally using Vite
+ *   kreft vite:init       Add Vite configuration and dependencies to an existing project (alias: kreft make:vite)
+ *   kreft vite:dev        Start ultra-fast Vite dev server with instant HMR and backend proxy (alias: kreft vite)
+ *   kreft vite:build      Build optimized static frontend with Rollup and code-splitting
+ *   kreft vite:preview    Preview production bundle locally using Vite
  *
  * CLI flag:
- *   kreftjs new my-app --vite
+ *   kreft new my-app --vite
  */
 const fs = require('fs');
 const path = require('path');
@@ -80,10 +80,10 @@ function init(args = [], opts = {}) {
   // Update package.json
   const pkg = JSON.parse(fs.readFileSync(pkgFile, 'utf8'));
   pkg.scripts = pkg.scripts || {};
-  pkg.scripts['vite'] = 'kreftjs vite';
-  pkg.scripts['vite:dev'] = 'kreftjs vite:dev';
-  pkg.scripts['vite:build'] = 'kreftjs vite:build';
-  pkg.scripts['vite:preview'] = 'kreftjs vite:preview';
+  pkg.scripts['vite'] = 'kreft vite';
+  pkg.scripts['vite:dev'] = 'kreft vite:dev';
+  pkg.scripts['vite:build'] = 'kreft vite:build';
+  pkg.scripts['vite:preview'] = 'kreft vite:preview';
 
   pkg.devDependencies = pkg.devDependencies || {};
   if (!pkg.devDependencies['vite']) {
@@ -99,8 +99,8 @@ function init(args = [], opts = {}) {
 
   Next:
     npm install            (install vite)
-    kreftjs vite:dev           (start ultra-fast Vite dev server with instant HMR)
-    kreftjs vite:build         (build production bundle with Rollup)
+    kreft vite:dev           (start ultra-fast Vite dev server with instant HMR)
+    kreft vite:build         (build production bundle with Rollup)
 `);
 }
 

package/bin/win-spawn.js

@@ -0,0 +1,39 @@
+/*
+ * Starting npm and other .cmd programs on Windows.
+ *
+ * Since Node.js 20.12 (and 22) a .cmd or .bat file can only be started through a shell: spawn('npm.cmd') alone fails with
+ * "spawnSync npm.cmd EINVAL". These helpers do that on Windows and start the program directly everywhere else.
+ * With a shell, an argument could carry a second command (`pkg & calc`), so characters that mean something to cmd.exe are refused.
+ */
+const { spawn, spawnSync } = require('child_process');
+
+const WIN = () => process.platform === 'win32';
+const UNSAFE = /[;&|`$<>%!"\r\n]/;
+const quote = (a) => (/[\s^()]/.test(a) ? `"${a}"` : a);
+const isCmdFile = (f) => /\.(cmd|bat)$/i.test(f);
+
+function prepare(cmd, args, options) {
+  if (!WIN() || !isCmdFile(cmd) && cmd !== 'npm' && cmd !== 'npx') return { cmd, args, options };
+  const list = args.map(String);
+  const bad = list.find((a) => UNSAFE.test(a));
+  if (bad) throw new Error(`The argument ${JSON.stringify(bad)} has a character that is not allowed here.`);
+  return { cmd: quote(cmd), args: list.map(quote), options: { ...options, shell: true } };
+}
+
+// spawnSync that works for npm on Windows; an unsafe argument comes back as { status: 1, error }
+function runSync(cmd, args = [], options = {}) {
+  try {
+    const p = prepare(cmd, args, options);
+    return spawnSync(p.cmd, p.args, p.options);
+  } catch (error) {
+    return { status: 1, error };
+  }
+}
+
+// spawn that works for .cmd programs (electron-builder.cmd …) on Windows
+function start(cmd, args = [], options = {}) {
+  const p = prepare(cmd, args, options);
+  return spawn(p.cmd, p.args, p.options);
+}
+
+module.exports = { runSync, start, isCmdFile, prepare };

package/docs/Docs.kreftjs

@@ -524,7 +524,7 @@ on ready {
 .dv-results .none { color: var(--dv-muted); cursor: default; }
 .dv-modal-foot { display: flex; gap: 16px; padding: 9px 14px; border-top: 1px solid var(--dv-line); font-size: 12px; color: var(--dv-muted); }
 
-.dv-top { position: fixed; inset-inline-end: 20px; bottom: 76px;   /* above the DevTools button (bottom right, `kreftjs dev` only) */ z-index: 40; display: grid; place-items: center; width: 40px; height: 40px; background: var(--background, #fff); color: var(--dv-text); border: 1px solid var(--dv-line); border-radius: 50%; cursor: pointer; opacity: 0; pointer-events: none; transform: translateY(8px); transition: opacity .2s, transform .2s; }
+.dv-top { position: fixed; inset-inline-end: 20px; bottom: 76px;   /* above the DevTools button (bottom right, `kreft dev` only) */ z-index: 40; display: grid; place-items: center; width: 40px; height: 40px; background: var(--background, #fff); color: var(--dv-text); border: 1px solid var(--dv-line); border-radius: 50%; cursor: pointer; opacity: 0; pointer-events: none; transform: translateY(8px); transition: opacity .2s, transform .2s; }
 .dv-top.show { opacity: 1; pointer-events: auto; transform: none; }
 
 /* narrow screens */