create-lacspace-app 2.12.0 → 2.13.1

package/README.md

@@ -202,6 +202,8 @@ Every template is Next.js 15 App Router + React 19 + Tailwind v4 — dark, moder
 | `--no-install` | skip installing dependencies |
 | `--no-git` | skip git init |
 | `-y, --yes` | accept defaults (needs a project name) |
+| `-h, --help` | show every flag |
+| `-v, --version` | print the installed version |
 
 ### 🎨 Themes
 

package/dist/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { existsSync, readdirSync, mkdirSync, writeFileSync } from 'fs';
-import { resolve, basename, join, dirname } from 'path';
+import { realpathSync, existsSync, readdirSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { basename, resolve, join, dirname } from 'path';
 import { createInterface } from 'readline/promises';
-import { argv, stdout, exit, stdin, cwd } from 'process';
+import { stdout, exit, argv, stdin, cwd } from 'process';
 import { spawnSync } from 'child_process';
-import { pathToFileURL } from 'url';
+import { pathToFileURL, fileURLToPath } from 'url';
 
 var C = {
   reset: "\x1B[0m",
@@ -7468,6 +7468,7 @@ var backendPkgJson = (ctx) => {
       "@lacspace/id": "^1.1.0",
       "@lacspace/rate-limit": "^1.2.0",
       "@lacspace/cache": "^1.1.0",
+      "@lacspace/logger": "^1.0.0",
       ...featureDeps,
       [`${scope(ctx)}/types`]: "*"
     },
@@ -7577,21 +7578,54 @@ var backendIndex = (ctx) => `import "./load-env.js"; // MUST be first: fills pro
 import { env } from "./env.js";
 import { connectDb } from "./db.js";
 import { createApp } from "./app.js";
+import { log } from "./logger.js";
 
 // how this works: connect to MongoDB, build the Express app, then listen.
 async function main(): Promise<void> {
   await connectDb(env.MONGODB_URI);
   const app = createApp();
   app.listen(env.PORT, () => {
-    console.log(\`\u{1F680} ${ctx.name} API ready on http://localhost:\${env.PORT}\`);
+    log.info("${ctx.name} API ready", { url: \`http://localhost:\${env.PORT}\` });
   });
 }
 
 main().catch((err) => {
-  console.error("Failed to start the API:", err);
+  log.fatal("Failed to start the API", { err });
   process.exit(1);
 });
 `;
+var backendLogger = () => `import { createLogger, jsonConsole, prettyConsole } from "@lacspace/logger";
+import type { Request, Response, NextFunction } from "express";
+import { env } from "./env.js";
+
+// how this works: one structured logger for the whole API (@lacspace/logger, zero-dep).
+// In production we emit JSON-per-line (clean for log aggregators); in dev we print a
+// readable, coloured line. Common secret fields are redacted before anything is logged.
+const isProd = env.NODE_ENV === "production";
+export const log = createLogger({
+  level: isProd ? "info" : "debug",
+  transports: [isProd ? jsonConsole() : prettyConsole({ colors: true })],
+  redact: ["password", "token", "authorization", "*.password", "*.token"],
+});
+
+// Request logger \u2014 one line per request with method, path, status and duration.
+// Each request gets a child logger with a short request id you can thread through.
+export function requestLogger(req: Request, res: Response, next: NextFunction): void {
+  const start = Date.now();
+  const reqId = Math.random().toString(36).slice(2, 10);
+  (req as Request & { log: typeof log }).log = log.child({ reqId });
+  res.on("finish", () => {
+    log.info("request", {
+      reqId,
+      method: req.method,
+      path: req.originalUrl,
+      status: res.statusCode,
+      ms: Date.now() - start,
+    });
+  });
+  next();
+}
+`;
 var backendDb = () => `import mongoose from "mongoose";
 
 // how this works: opens the Mongoose connection. Call once at boot.
@@ -7907,16 +7941,19 @@ export default router;
 var backendApp = (ctx) => `import express from "express";
 import cors from "cors";
 import { env } from "./env.js";
+import { requestLogger } from "./logger.js";
 import { errorHandler } from "./middleware/error.js";
 import { registerRoutes } from "./routes/index.js";
 
 // how this works: assembles the Express app \u2014 CORS for the frontend, JSON parsing,
-// a health check, all route groups (see routes/index.ts), then the error handler LAST.
+// structured request logging (@lacspace/logger), a health check, all route groups
+// (see routes/index.ts), then the error handler LAST.
 export function createApp(): express.Express {
   const app = express();
 
   app.use(cors({ origin: env.CORS_ORIGIN.split(",").map((o) => o.trim()), credentials: true }));
   app.use(express.json());
+  app.use(requestLogger); // one structured log line per request
 
   app.get("/health", (_req, res) => { res.json({ ok: true, service: "${ctx.name}-api" }); });
   registerRoutes(app);
@@ -7957,6 +7994,7 @@ function backendFiles(ctx) {
     "backend/src/env.ts": backendEnv(ctx),
     "backend/src/db.ts": backendDb(),
     "backend/src/cache.ts": backendCache(),
+    "backend/src/logger.ts": backendLogger(),
     "backend/src/app.ts": backendApp(ctx),
     "backend/src/http.ts": backendHttp(),
     "backend/src/express.d.ts": backendExpressTypes(),
@@ -7976,9 +8014,24 @@ function backendFiles(ctx) {
   }
   return files;
 }
+function cliVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    for (const rel of ["../package.json", "./package.json", "../../package.json"]) {
+      const file = resolve(here, rel);
+      if (!existsSync(file)) continue;
+      const parsed = JSON.parse(readFileSync(file, "utf8"));
+      const version = parsed.version;
+      const name = parsed.name;
+      if (typeof version === "string" && (name === "create-lacspace-app" || rel !== "../../package.json")) return version;
+    }
+  } catch {
+  }
+  return "unknown";
+}
 var splitList = (s) => s.split(",").map((x) => x.trim()).filter(Boolean);
 function parseArgs(list) {
-  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false, dryRun: false };
+  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false, version: false, dryRun: false, unknown: [] };
   for (let i = 0; i < list.length; i++) {
     const arg = list[i];
     const next = () => list[++i] ?? "";
@@ -8001,6 +8054,7 @@ function parseArgs(list) {
     } else if (arg === "--recipe") a.recipe = next();
     else if (arg.startsWith("--recipe=")) a.recipe = arg.slice(9);
     else if (arg === "-h" || arg === "--help") a.help = true;
+    else if (arg === "-v" || arg === "-V" || arg === "--version") a.version = true;
     else if (arg.startsWith("--template=")) a.template = arg.slice(11);
     else if (arg.startsWith("--theme=")) a.theme = arg.slice(8);
     else if (arg.startsWith("--accent=")) a.theme = arg.slice(9);
@@ -8008,6 +8062,7 @@ function parseArgs(list) {
     else if (arg.startsWith("--with=")) a.features.push(...splitList(arg.slice(7)));
     else if (arg.startsWith("--features=")) a.features.push(...splitList(arg.slice(11)));
     else if (!arg.startsWith("-") && !a.name) a.name = arg;
+    else if (arg.startsWith("-")) a.unknown.push(arg);
   }
   return a;
 }
@@ -8115,6 +8170,7 @@ ${c("bold", "Options")}
   --no-git               Skip git init
   -y, --yes              Accept defaults (needs <name>)
   -h, --help             Show this help
+  -v, --version          Print the version and exit
 
 ${c("bold", "Feature add-ons")} ${c("dim", "(--with) \u2014 free & keyless, local by default")}
 ${FEATURES.map((f) => `  ${f.key.padEnd(11)} ${f.description}`).join("\n")}
@@ -8588,6 +8644,16 @@ async function main() {
     stdout.write(HELP + "\n");
     return;
   }
+  if (args.version) {
+    stdout.write(`create-lacspace-app ${cliVersion()}
+`);
+    return;
+  }
+  if (args.unknown.length) {
+    stdout.write(c("yellow", `
+  ! Unknown option${args.unknown.length > 1 ? "s" : ""}: ${args.unknown.join(", ")} \u2014 ignoring. Run with --help to see every flag.
+`));
+  }
   stdout.write(`
 ${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a gorgeous Next.js starter, batteries wired")}
 
@@ -8786,8 +8852,18 @@ ${c("bold", "Your feature add-ons")} ${c("dim", "\u2014 details in LEARN.md")}
 
 `);
 }
-var invokedAsCli = argv[1] ? import.meta.url === pathToFileURL(argv[1]).href : false;
-if (invokedAsCli) {
+function isDirectRun() {
+  const entry = argv[1];
+  if (!entry) return false;
+  const here = import.meta.url;
+  if (here === pathToFileURL(entry).href) return true;
+  try {
+    if (here === pathToFileURL(realpathSync(entry)).href) return true;
+  } catch {
+  }
+  return basename(entry).replace(/\.[cm]?js$/, "") === "create-lacspace-app";
+}
+if (isDirectRun()) {
   main().catch((err) => {
     stdout.write(c("red", `
 \u2717 ${err instanceof Error ? err.message : String(err)}

package/dist/lib.cjs

@@ -7472,6 +7472,7 @@ var backendPkgJson = (ctx) => {
       "@lacspace/id": "^1.1.0",
       "@lacspace/rate-limit": "^1.2.0",
       "@lacspace/cache": "^1.1.0",
+      "@lacspace/logger": "^1.0.0",
       ...featureDeps,
       [`${scope(ctx)}/types`]: "*"
     },
@@ -7581,21 +7582,54 @@ var backendIndex = (ctx) => `import "./load-env.js"; // MUST be first: fills pro
 import { env } from "./env.js";
 import { connectDb } from "./db.js";
 import { createApp } from "./app.js";
+import { log } from "./logger.js";
 
 // how this works: connect to MongoDB, build the Express app, then listen.
 async function main(): Promise<void> {
   await connectDb(env.MONGODB_URI);
   const app = createApp();
   app.listen(env.PORT, () => {
-    console.log(\`\u{1F680} ${ctx.name} API ready on http://localhost:\${env.PORT}\`);
+    log.info("${ctx.name} API ready", { url: \`http://localhost:\${env.PORT}\` });
   });
 }
 
 main().catch((err) => {
-  console.error("Failed to start the API:", err);
+  log.fatal("Failed to start the API", { err });
   process.exit(1);
 });
 `;
+var backendLogger = () => `import { createLogger, jsonConsole, prettyConsole } from "@lacspace/logger";
+import type { Request, Response, NextFunction } from "express";
+import { env } from "./env.js";
+
+// how this works: one structured logger for the whole API (@lacspace/logger, zero-dep).
+// In production we emit JSON-per-line (clean for log aggregators); in dev we print a
+// readable, coloured line. Common secret fields are redacted before anything is logged.
+const isProd = env.NODE_ENV === "production";
+export const log = createLogger({
+  level: isProd ? "info" : "debug",
+  transports: [isProd ? jsonConsole() : prettyConsole({ colors: true })],
+  redact: ["password", "token", "authorization", "*.password", "*.token"],
+});
+
+// Request logger \u2014 one line per request with method, path, status and duration.
+// Each request gets a child logger with a short request id you can thread through.
+export function requestLogger(req: Request, res: Response, next: NextFunction): void {
+  const start = Date.now();
+  const reqId = Math.random().toString(36).slice(2, 10);
+  (req as Request & { log: typeof log }).log = log.child({ reqId });
+  res.on("finish", () => {
+    log.info("request", {
+      reqId,
+      method: req.method,
+      path: req.originalUrl,
+      status: res.statusCode,
+      ms: Date.now() - start,
+    });
+  });
+  next();
+}
+`;
 var backendDb = () => `import mongoose from "mongoose";
 
 // how this works: opens the Mongoose connection. Call once at boot.
@@ -7911,16 +7945,19 @@ export default router;
 var backendApp = (ctx) => `import express from "express";
 import cors from "cors";
 import { env } from "./env.js";
+import { requestLogger } from "./logger.js";
 import { errorHandler } from "./middleware/error.js";
 import { registerRoutes } from "./routes/index.js";
 
 // how this works: assembles the Express app \u2014 CORS for the frontend, JSON parsing,
-// a health check, all route groups (see routes/index.ts), then the error handler LAST.
+// structured request logging (@lacspace/logger), a health check, all route groups
+// (see routes/index.ts), then the error handler LAST.
 export function createApp(): express.Express {
   const app = express();
 
   app.use(cors({ origin: env.CORS_ORIGIN.split(",").map((o) => o.trim()), credentials: true }));
   app.use(express.json());
+  app.use(requestLogger); // one structured log line per request
 
   app.get("/health", (_req, res) => { res.json({ ok: true, service: "${ctx.name}-api" }); });
   registerRoutes(app);
@@ -7961,6 +7998,7 @@ function backendFiles(ctx) {
     "backend/src/env.ts": backendEnv(ctx),
     "backend/src/db.ts": backendDb(),
     "backend/src/cache.ts": backendCache(),
+    "backend/src/logger.ts": backendLogger(),
     "backend/src/app.ts": backendApp(ctx),
     "backend/src/http.ts": backendHttp(),
     "backend/src/express.d.ts": backendExpressTypes(),
@@ -7980,9 +8018,24 @@ function backendFiles(ctx) {
   }
   return files;
 }
+function cliVersion() {
+  try {
+    const here = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('lib.cjs', document.baseURI).href))));
+    for (const rel of ["../package.json", "./package.json", "../../package.json"]) {
+      const file = path.resolve(here, rel);
+      if (!fs.existsSync(file)) continue;
+      const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+      const version = parsed.version;
+      const name = parsed.name;
+      if (typeof version === "string" && (name === "create-lacspace-app" || rel !== "../../package.json")) return version;
+    }
+  } catch {
+  }
+  return "unknown";
+}
 var splitList = (s) => s.split(",").map((x) => x.trim()).filter(Boolean);
 function parseArgs(list) {
-  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false, dryRun: false };
+  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false, version: false, dryRun: false, unknown: [] };
   for (let i = 0; i < list.length; i++) {
     const arg = list[i];
     const next = () => list[++i] ?? "";
@@ -8005,6 +8058,7 @@ function parseArgs(list) {
     } else if (arg === "--recipe") a.recipe = next();
     else if (arg.startsWith("--recipe=")) a.recipe = arg.slice(9);
     else if (arg === "-h" || arg === "--help") a.help = true;
+    else if (arg === "-v" || arg === "-V" || arg === "--version") a.version = true;
     else if (arg.startsWith("--template=")) a.template = arg.slice(11);
     else if (arg.startsWith("--theme=")) a.theme = arg.slice(8);
     else if (arg.startsWith("--accent=")) a.theme = arg.slice(9);
@@ -8012,6 +8066,7 @@ function parseArgs(list) {
     else if (arg.startsWith("--with=")) a.features.push(...splitList(arg.slice(7)));
     else if (arg.startsWith("--features=")) a.features.push(...splitList(arg.slice(11)));
     else if (!arg.startsWith("-") && !a.name) a.name = arg;
+    else if (arg.startsWith("-")) a.unknown.push(arg);
   }
   return a;
 }
@@ -8119,6 +8174,7 @@ ${c("bold", "Options")}
   --no-git               Skip git init
   -y, --yes              Accept defaults (needs <name>)
   -h, --help             Show this help
+  -v, --version          Print the version and exit
 
 ${c("bold", "Feature add-ons")} ${c("dim", "(--with) \u2014 free & keyless, local by default")}
 ${FEATURES.map((f) => `  ${f.key.padEnd(11)} ${f.description}`).join("\n")}
@@ -8592,6 +8648,16 @@ async function main() {
     process$1.stdout.write(HELP + "\n");
     return;
   }
+  if (args.version) {
+    process$1.stdout.write(`create-lacspace-app ${cliVersion()}
+`);
+    return;
+  }
+  if (args.unknown.length) {
+    process$1.stdout.write(c("yellow", `
+  ! Unknown option${args.unknown.length > 1 ? "s" : ""}: ${args.unknown.join(", ")} \u2014 ignoring. Run with --help to see every flag.
+`));
+  }
   process$1.stdout.write(`
 ${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a gorgeous Next.js starter, batteries wired")}
 
@@ -8790,8 +8856,18 @@ ${c("bold", "Your feature add-ons")} ${c("dim", "\u2014 details in LEARN.md")}
 
 `);
 }
-var invokedAsCli = process$1.argv[1] ? (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('lib.cjs', document.baseURI).href)) === url.pathToFileURL(process$1.argv[1]).href : false;
-if (invokedAsCli) {
+function isDirectRun() {
+  const entry = process$1.argv[1];
+  if (!entry) return false;
+  const here = (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('lib.cjs', document.baseURI).href));
+  if (here === url.pathToFileURL(entry).href) return true;
+  try {
+    if (here === url.pathToFileURL(fs.realpathSync(entry)).href) return true;
+  } catch {
+  }
+  return path.basename(entry).replace(/\.[cm]?js$/, "") === "create-lacspace-app";
+}
+if (isDirectRun()) {
   main().catch((err) => {
     process$1.stdout.write(c("red", `
 \u2717 ${err instanceof Error ? err.message : String(err)}

package/dist/lib.js

@@ -1,10 +1,10 @@
 import { mkdir, writeFile } from 'fs/promises';
-import { resolve, basename, join, dirname } from 'path';
-import { existsSync, readdirSync, mkdirSync, writeFileSync } from 'fs';
+import { basename, resolve, join, dirname } from 'path';
+import { realpathSync, existsSync, readdirSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
 import { createInterface } from 'readline/promises';
-import { argv, stdout, exit, stdin, cwd } from 'process';
+import { stdout, exit, argv, stdin, cwd } from 'process';
 import { spawnSync } from 'child_process';
-import { pathToFileURL } from 'url';
+import { pathToFileURL, fileURLToPath } from 'url';
 
 // src/lib.ts
 var C = {
@@ -7469,6 +7469,7 @@ var backendPkgJson = (ctx) => {
       "@lacspace/id": "^1.1.0",
       "@lacspace/rate-limit": "^1.2.0",
       "@lacspace/cache": "^1.1.0",
+      "@lacspace/logger": "^1.0.0",
       ...featureDeps,
       [`${scope(ctx)}/types`]: "*"
     },
@@ -7578,21 +7579,54 @@ var backendIndex = (ctx) => `import "./load-env.js"; // MUST be first: fills pro
 import { env } from "./env.js";
 import { connectDb } from "./db.js";
 import { createApp } from "./app.js";
+import { log } from "./logger.js";
 
 // how this works: connect to MongoDB, build the Express app, then listen.
 async function main(): Promise<void> {
   await connectDb(env.MONGODB_URI);
   const app = createApp();
   app.listen(env.PORT, () => {
-    console.log(\`\u{1F680} ${ctx.name} API ready on http://localhost:\${env.PORT}\`);
+    log.info("${ctx.name} API ready", { url: \`http://localhost:\${env.PORT}\` });
   });
 }
 
 main().catch((err) => {
-  console.error("Failed to start the API:", err);
+  log.fatal("Failed to start the API", { err });
   process.exit(1);
 });
 `;
+var backendLogger = () => `import { createLogger, jsonConsole, prettyConsole } from "@lacspace/logger";
+import type { Request, Response, NextFunction } from "express";
+import { env } from "./env.js";
+
+// how this works: one structured logger for the whole API (@lacspace/logger, zero-dep).
+// In production we emit JSON-per-line (clean for log aggregators); in dev we print a
+// readable, coloured line. Common secret fields are redacted before anything is logged.
+const isProd = env.NODE_ENV === "production";
+export const log = createLogger({
+  level: isProd ? "info" : "debug",
+  transports: [isProd ? jsonConsole() : prettyConsole({ colors: true })],
+  redact: ["password", "token", "authorization", "*.password", "*.token"],
+});
+
+// Request logger \u2014 one line per request with method, path, status and duration.
+// Each request gets a child logger with a short request id you can thread through.
+export function requestLogger(req: Request, res: Response, next: NextFunction): void {
+  const start = Date.now();
+  const reqId = Math.random().toString(36).slice(2, 10);
+  (req as Request & { log: typeof log }).log = log.child({ reqId });
+  res.on("finish", () => {
+    log.info("request", {
+      reqId,
+      method: req.method,
+      path: req.originalUrl,
+      status: res.statusCode,
+      ms: Date.now() - start,
+    });
+  });
+  next();
+}
+`;
 var backendDb = () => `import mongoose from "mongoose";
 
 // how this works: opens the Mongoose connection. Call once at boot.
@@ -7908,16 +7942,19 @@ export default router;
 var backendApp = (ctx) => `import express from "express";
 import cors from "cors";
 import { env } from "./env.js";
+import { requestLogger } from "./logger.js";
 import { errorHandler } from "./middleware/error.js";
 import { registerRoutes } from "./routes/index.js";
 
 // how this works: assembles the Express app \u2014 CORS for the frontend, JSON parsing,
-// a health check, all route groups (see routes/index.ts), then the error handler LAST.
+// structured request logging (@lacspace/logger), a health check, all route groups
+// (see routes/index.ts), then the error handler LAST.
 export function createApp(): express.Express {
   const app = express();
 
   app.use(cors({ origin: env.CORS_ORIGIN.split(",").map((o) => o.trim()), credentials: true }));
   app.use(express.json());
+  app.use(requestLogger); // one structured log line per request
 
   app.get("/health", (_req, res) => { res.json({ ok: true, service: "${ctx.name}-api" }); });
   registerRoutes(app);
@@ -7958,6 +7995,7 @@ function backendFiles(ctx) {
     "backend/src/env.ts": backendEnv(ctx),
     "backend/src/db.ts": backendDb(),
     "backend/src/cache.ts": backendCache(),
+    "backend/src/logger.ts": backendLogger(),
     "backend/src/app.ts": backendApp(ctx),
     "backend/src/http.ts": backendHttp(),
     "backend/src/express.d.ts": backendExpressTypes(),
@@ -7977,9 +8015,24 @@ function backendFiles(ctx) {
   }
   return files;
 }
+function cliVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    for (const rel of ["../package.json", "./package.json", "../../package.json"]) {
+      const file = resolve(here, rel);
+      if (!existsSync(file)) continue;
+      const parsed = JSON.parse(readFileSync(file, "utf8"));
+      const version = parsed.version;
+      const name = parsed.name;
+      if (typeof version === "string" && (name === "create-lacspace-app" || rel !== "../../package.json")) return version;
+    }
+  } catch {
+  }
+  return "unknown";
+}
 var splitList = (s) => s.split(",").map((x) => x.trim()).filter(Boolean);
 function parseArgs(list) {
-  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false, dryRun: false };
+  const a = { features: [], yes: false, install: true, git: true, pm: "npm", help: false, version: false, dryRun: false, unknown: [] };
   for (let i = 0; i < list.length; i++) {
     const arg = list[i];
     const next = () => list[++i] ?? "";
@@ -8002,6 +8055,7 @@ function parseArgs(list) {
     } else if (arg === "--recipe") a.recipe = next();
     else if (arg.startsWith("--recipe=")) a.recipe = arg.slice(9);
     else if (arg === "-h" || arg === "--help") a.help = true;
+    else if (arg === "-v" || arg === "-V" || arg === "--version") a.version = true;
     else if (arg.startsWith("--template=")) a.template = arg.slice(11);
     else if (arg.startsWith("--theme=")) a.theme = arg.slice(8);
     else if (arg.startsWith("--accent=")) a.theme = arg.slice(9);
@@ -8009,6 +8063,7 @@ function parseArgs(list) {
     else if (arg.startsWith("--with=")) a.features.push(...splitList(arg.slice(7)));
     else if (arg.startsWith("--features=")) a.features.push(...splitList(arg.slice(11)));
     else if (!arg.startsWith("-") && !a.name) a.name = arg;
+    else if (arg.startsWith("-")) a.unknown.push(arg);
   }
   return a;
 }
@@ -8116,6 +8171,7 @@ ${c("bold", "Options")}
   --no-git               Skip git init
   -y, --yes              Accept defaults (needs <name>)
   -h, --help             Show this help
+  -v, --version          Print the version and exit
 
 ${c("bold", "Feature add-ons")} ${c("dim", "(--with) \u2014 free & keyless, local by default")}
 ${FEATURES.map((f) => `  ${f.key.padEnd(11)} ${f.description}`).join("\n")}
@@ -8589,6 +8645,16 @@ async function main() {
     stdout.write(HELP + "\n");
     return;
   }
+  if (args.version) {
+    stdout.write(`create-lacspace-app ${cliVersion()}
+`);
+    return;
+  }
+  if (args.unknown.length) {
+    stdout.write(c("yellow", `
+  ! Unknown option${args.unknown.length > 1 ? "s" : ""}: ${args.unknown.join(", ")} \u2014 ignoring. Run with --help to see every flag.
+`));
+  }
   stdout.write(`
 ${c("bold", c("magenta", "\u25C6 create-lacspace-app"))} ${c("dim", "\u2014 a gorgeous Next.js starter, batteries wired")}
 
@@ -8787,8 +8853,18 @@ ${c("bold", "Your feature add-ons")} ${c("dim", "\u2014 details in LEARN.md")}
 
 `);
 }
-var invokedAsCli = argv[1] ? import.meta.url === pathToFileURL(argv[1]).href : false;
-if (invokedAsCli) {
+function isDirectRun() {
+  const entry = argv[1];
+  if (!entry) return false;
+  const here = import.meta.url;
+  if (here === pathToFileURL(entry).href) return true;
+  try {
+    if (here === pathToFileURL(realpathSync(entry)).href) return true;
+  } catch {
+  }
+  return basename(entry).replace(/\.[cm]?js$/, "") === "create-lacspace-app";
+}
+if (isDirectRun()) {
   main().catch((err) => {
     stdout.write(c("red", `
 \u2717 ${err instanceof Error ? err.message : String(err)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-lacspace-app",
-  "version": "2.12.0",
+  "version": "2.13.1",
   "description": "Scaffold a beautiful, production-ready Next.js app from a Lacspace template — portfolio, business, e-commerce, SaaS, blog, docs, dashboard, restaurant or marketplace — pre-wired with SEO, security headers, sitemap and robots. Use it as a CLI (like create-next-app, but you start gorgeous) or import it as a library to generate projects programmatically.",
   "type": "module",
   "bin": {