create-lacspace-app 2.1.1 → 2.2.1

package/README.md

@@ -120,9 +120,44 @@ npx create-lacspace-app my-app --theme "#0bb9d9,#7c3aed"           # an exact fr
 
 **Presets:** `lacspace` · `violet` · `indigo` · `blue` · `cyan` · `sky` · `teal` · `emerald` · `green` · `lime` · `amber` · `orange` · `red` · `rose` · `pink` · `fuchsia` · `purple` · `slate` · `sunset` · `ocean` · `forest` · `aurora` · `gold`. Give a single hex and the CLI derives a matching second stop for you.
 
+## 📦 Use it as a library
+
+The same generator is exported as a programmatic API, so you can scaffold Lacspace projects from your own code — build tools, custom CLIs, CI jobs, tests, a playground, or a server-side **"download as ZIP"** button. It ships dual **ESM + CJS** with full TypeScript types.
+
+```ts
+import {
+  generateProject,   // pure: returns an in-memory file map — no disk I/O
+  scaffold,          // Node: writes a project to disk
+  listTemplates,     // the 9 templates + their metadata
+  listSections,      // the 15 prebuilt sections
+} from "create-lacspace-app";
+
+// 1. Pure — get the whole project as { "path": "contents" }. Runs anywhere.
+const files = generateProject({ name: "acme", template: "saas", theme: "#ff6a00" });
+files["app/page.tsx"];        // → the generated home page source
+Object.keys(files).length;    // → ~70 files
+
+// 2. Write it to disk (Node).
+const { dir, files: written } = await scaffold({ name: "acme", template: "saas" });
+console.log(`Scaffolded ${written.length} files → ${dir}`);
+```
+
+`generateProject` is **pure** (no I/O), so it's perfect for previews, snapshot tests, zipping in a server route, or post-processing files before you write them. `scaffold` is the thin Node wrapper that writes the map to disk.
+
+| Export | What it does |
+| --- | --- |
+| `generateProject(options)` | Returns the project as an in-memory `{ path: contents }` map. Pure, isomorphic. |
+| `scaffold(options)` | Generates **and writes** the project to disk (`options.dir`, or `<cwd>/<name>`). Node only. |
+| `listTemplates()` / `templates` | The built-in templates with metadata (`key`, `label`, `description`, `accent`, defaults). |
+| `getTemplate(key)` | One template's metadata, or `undefined`. |
+| `listSections()` / `getSection(name)` | The prebuilt section names, and one section's source. |
+| `templateKeys` | Every valid `template` key. |
+
+`options`: `{ name?, template?, theme? }` — the same choices as the CLI flags above.
+
 ## Licensing
 
-Free under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — permissive freedoms. Use it in personal and commercial projects at no cost; the apps you generate are entirely yours.
+Free under the **[Lacspace Free Licence](https://developer.lacspace.com/licenses/lacspace-free-1.0)** — permissive freedoms. Use it in personal and commercial projects at no cost; the apps you generate are entirely yours.
 
 <!-- LACSPACE-DEV-PLATFORM -->
 
@@ -130,13 +165,13 @@ Free under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-
 
 ## The Lacspace Developer Platform
 
-`create-lacspace-app` is part of **63 zero-dependency, isomorphic TypeScript packages** — one standard library for the modern web. Explore the ecosystem:
+`create-lacspace-app` is part of **80+ zero-dependency, isomorphic TypeScript packages** — one standard library for the modern web. Explore the ecosystem:
 
-- 🗂️ **All 63 packages** — https://developer.lacspace.com/packages
+- 🗂️ **All 80+ packages** — https://developer.lacspace.com/packages
 - 🧭 **Developer handbook** — guides & runnable recipes — https://developer.lacspace.com/handbook
 - 🧪 **Live playground** — run any package in your browser — https://developer.lacspace.com/playground
 - 🖥️ **Finished app templates** — https://templates.lacspace.com
 - 🚀 **Scaffold a full app** — `npm create lacspace-app@latest`
 
-Free under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — a permissive, free-to-use licence.
+Free under the **[Lacspace Free Licence](https://developer.lacspace.com/licenses/lacspace-free-1.0)** — a permissive, free-to-use licence.
 

package/dist/index.js

@@ -2,8 +2,9 @@
 import { existsSync, readdirSync, mkdirSync, writeFileSync } from 'fs';
 import { resolve, basename, join, dirname } from 'path';
 import { createInterface } from 'readline/promises';
-import { stdout, exit, argv, stdin, cwd } from 'process';
+import { argv, stdout, exit, stdin, cwd } from 'process';
 import { spawnSync } from 'child_process';
+import { pathToFileURL } from 'url';
 
 var C = {
   reset: "\x1B[0m",
@@ -27,6 +28,15 @@ var TEMPLATES = [
   { key: "restaurant", label: "Restaurant / cafe", description: "A warm restaurant home with menu highlights and reservations.", accent: ["#e11d48", "#f59e0b"], siteName: "LSResto", siteDescription: "Seasonal plates, natural wine and a warm room. Book a table." },
   { key: "marketplace", label: "Marketplace / commerce", description: "A real storefront wired to the Lacspace commerce packages \u2014 cart, checkout, tax, shipping, orders, invoices and Nepal payments.", accent: ["#0d9488", "#6366f1"], siteName: "LSBazaar", siteDescription: "A modern storefront \u2014 cart to checkout, wired end to end." }
 ];
+function resolveContext(options = {}) {
+  const base = TEMPLATES.find((t) => t.key === options.template) ?? TEMPLATES[0];
+  const accent = resolveAccent(options.theme);
+  const template = accent ? { ...base, accent } : base;
+  const raw = options.name ?? "my-app";
+  const seg = raw.split(/[\\/]/).filter(Boolean).pop() ?? "my-app";
+  const name = seg.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/^-+|-+$/g, "") || "my-app";
+  return { name, template };
+}
 var pkgJson = (ctx) => JSON.stringify({
   name: ctx.name,
   version: "0.1.0",
@@ -5068,10 +5078,15 @@ ${c("bold", "Done! Next steps")}
 
 `);
 }
-main().catch((err) => {
-  stdout.write(c("red", `
+var invokedAsCli = argv[1] ? import.meta.url === pathToFileURL(argv[1]).href : false;
+if (invokedAsCli) {
+  main().catch((err) => {
+    stdout.write(c("red", `
 \u2717 ${err instanceof Error ? err.message : String(err)}
 
 `));
-  exit(1);
-});
+    exit(1);
+  });
+}
+
+export { SECTIONS, TEMPLATES, buildFiles, resolveContext };