create-lacspace-app 2.1.0 → 2.2.0

package/README.md

@@ -120,6 +120,41 @@ 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.

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",
@@ -555,7 +565,8 @@ function homePage(ctx) {
       restaurant: { t: "Join us for dinner", s: "We fill up fast on weekends \u2014 book your table ahead.", l: "Reserve a table", h: "/reservations" }
     };
     const cc = ctaCopy[ctx.template.key] ?? ctaCopy.business;
-    return `import { site } from "@/lib/site";
+    return `import Link from "next/link";
+import { site } from "@/lib/site";
 import { LiveStats } from "@/components/live-stats";
 import { Aurora } from "@/components/aurora";
 import { HeroArt } from "@/components/hero-art";
@@ -588,13 +599,13 @@ export default function Home() {
         <p className="lead mx-auto mt-6 max-w-xl">${ctx.template.siteDescription}</p>
         <div className="mt-10 flex flex-wrap justify-center gap-3">
           <a href="#work" className="shimmer rounded-full gradient-bg px-7 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">View my work</a>
-          <a href="/contact" className="rounded-full border border-hairline px-7 py-3.5 font-semibold transition hover:bg-surface">Get in touch</a>
+          <Link href="/contact" className="rounded-full border border-hairline px-7 py-3.5 font-semibold transition hover:bg-surface">Get in touch</Link>
         </div>
       </section>
       <section id="work" className="mx-auto max-w-6xl px-6 py-20">
         <div className="mb-12 flex items-end justify-between">
           <div><p className="text-sm font-semibold uppercase tracking-widest gradient-text">Selected work</p><h2 className="mt-3 text-3xl font-bold sm:text-4xl">Things I've shipped</h2></div>
-          <a href="/work" className="hidden text-sm text-muted underline-offset-4 transition hover:text-fg hover:underline sm:block">All projects \u2192</a>
+          <Link href="/work" className="hidden text-sm text-muted underline-offset-4 transition hover:text-fg hover:underline sm:block">All projects \u2192</Link>
         </div>
         <div className="grid gap-6 sm:grid-cols-2 lg:grid-cols-3">
           {[
@@ -605,12 +616,12 @@ export default function Home() {
             { t: "Cadence Marketing", d: "A brand and site refresh that doubled qualified inbound leads.", tag: "Brand", e: "\u2728" },
             { t: "Meadow Docs", d: "A fast, searchable docs platform teams actually enjoy reading.", tag: "Web", e: "\u{1F4DA}" },
           ].map((p) => (
-            <a key={p.t} href="/work" className="card group flex flex-col p-6">
+            <Link key={p.t} href="/work" className="card group flex flex-col p-6">
               <div className="mb-5 flex aspect-[16/10] items-center justify-center overflow-hidden rounded-xl gradient-bg text-5xl on-accent">{p.e}</div>
               <span className="text-xs font-semibold uppercase tracking-widest gradient-text">{p.tag}</span>
               <h3 className="mt-1.5 font-semibold tracking-tight">{p.t}</h3>
               <p className="mt-1.5 text-sm leading-relaxed text-muted">{p.d}</p>
-            </a>
+            </Link>
           ))}
         </div>
       </section>`);
@@ -621,8 +632,8 @@ export default function Home() {
         <h1 className="text-display mt-7">We build products <span className="gradient-text">that grow businesses</span></h1>
         <p className="lead mx-auto mt-6 max-w-2xl">${ctx.template.siteDescription}</p>
         <div className="mt-10 flex flex-wrap justify-center gap-3">
-          <a href="/contact" className="shimmer rounded-full gradient-bg px-7 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Start a project</a>
-          <a href="/work" className="rounded-full border border-hairline px-7 py-3.5 font-semibold transition hover:bg-surface">See our work</a>
+          <Link href="/contact" className="shimmer rounded-full gradient-bg px-7 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Start a project</Link>
+          <Link href="/work" className="rounded-full border border-hairline px-7 py-3.5 font-semibold transition hover:bg-surface">See our work</Link>
         </div>
       </section>
       <section id="services" className="mx-auto max-w-6xl px-6 py-20">
@@ -648,14 +659,14 @@ export default function Home() {
         <h1 className="text-display mt-7"><span className="gradient-text">${n}</span></h1>
         <p className="lead mx-auto mt-6 max-w-xl">${ctx.template.siteDescription}</p>
         <div className="mt-10 flex flex-wrap justify-center gap-3">
-          <a href="/shop" className="shimmer rounded-full gradient-bg px-8 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Shop the collection</a>
-          <a href="/collections" className="rounded-full border border-hairline px-8 py-3.5 font-semibold transition hover:bg-surface">Browse collections</a>
+          <Link href="/shop" className="shimmer rounded-full gradient-bg px-8 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Shop the collection</Link>
+          <Link href="/collections" className="rounded-full border border-hairline px-8 py-3.5 font-semibold transition hover:bg-surface">Browse collections</Link>
         </div>
       </section>
       <section id="shop" className="mx-auto max-w-6xl px-6 py-20">
         <div className="mb-12 flex items-end justify-between">
           <div><p className="text-sm font-semibold uppercase tracking-widest gradient-text">Featured</p><h2 className="mt-3 text-3xl font-bold sm:text-4xl">This week's edit</h2></div>
-          <a href="/shop" className="hidden text-sm text-muted underline-offset-4 transition hover:text-fg hover:underline sm:block">Shop all \u2192</a>
+          <Link href="/shop" className="hidden text-sm text-muted underline-offset-4 transition hover:text-fg hover:underline sm:block">Shop all \u2192</Link>
         </div>
         <div className="grid gap-6 sm:grid-cols-2 lg:grid-cols-4">
           {[
@@ -663,12 +674,12 @@ export default function Home() {
             { n: "Linen Waffle Throw", p: "$65", e: "\u{1F9FA}" }, { n: "Oak Monitor Stand", p: "$120", e: "\u{1FAB5}" },
           ].map((prod) => (
             <div key={prod.n} className="card group flex flex-col p-4">
-              <a href="/shop" className="mb-4 flex aspect-square items-center justify-center overflow-hidden rounded-xl gradient-bg text-6xl on-accent transition group-hover:scale-[1.03]">{prod.e}</a>
+              <Link href="/shop" className="mb-4 flex aspect-square items-center justify-center overflow-hidden rounded-xl gradient-bg text-6xl on-accent transition group-hover:scale-[1.03]">{prod.e}</Link>
               <div className="flex items-start justify-between gap-2">
                 <h3 className="font-semibold tracking-tight">{prod.n}</h3>
                 <span className="shrink-0 font-semibold text-muted">{prod.p}</span>
               </div>
-              <a href="/shop" className="mt-4 block w-full rounded-full gradient-bg py-2.5 text-center text-sm font-semibold on-accent transition hover:-translate-y-0.5">Add to cart</a>
+              <Link href="/shop" className="mt-4 block w-full rounded-full gradient-bg py-2.5 text-center text-sm font-semibold on-accent transition hover:-translate-y-0.5">Add to cart</Link>
             </div>
           ))}
         </div>
@@ -679,10 +690,10 @@ export default function Home() {
         <p className="text-sm font-semibold uppercase tracking-widest gradient-text">The Journal</p>
         <h1 className="text-display mt-4"><span className="gradient-text">${n}</span></h1>
         <p className="lead mt-6 max-w-2xl">${ctx.template.siteDescription}</p>
-        <a href="/blog" className="mt-8 inline-flex items-center gap-2 text-sm font-semibold text-fg underline-offset-4 hover:underline">Read the archive \u2192</a>
+        <Link href="/blog" className="mt-8 inline-flex items-center gap-2 text-sm font-semibold text-fg underline-offset-4 hover:underline">Read the archive \u2192</Link>
       </section>
       <section id="latest" className="mx-auto max-w-5xl px-6 pb-8">
-        <a href="/blog" className="card group grid gap-6 overflow-hidden p-6 sm:grid-cols-[1.2fr_1fr] sm:p-8">
+        <Link href="/blog" className="card group grid gap-6 overflow-hidden p-6 sm:grid-cols-[1.2fr_1fr] sm:p-8">
           <div className="flex aspect-[16/10] items-center justify-center overflow-hidden rounded-2xl gradient-bg text-6xl on-accent transition group-hover:scale-[1.02]">\u{1F4EE}</div>
           <div className="flex flex-col justify-center">
             <span className="text-xs font-semibold uppercase tracking-widest gradient-text">Featured</span>
@@ -690,7 +701,7 @@ export default function Home() {
             <p className="mt-3 leading-relaxed text-muted">Most teams polish the wrong things. Here's the single unglamorous check that separates a launch that lands from one that limps.</p>
             <span className="mt-5 text-sm text-faint">8 min read \xB7 Product</span>
           </div>
-        </a>
+        </Link>
       </section>
       <section className="mx-auto max-w-5xl px-6 py-16">
         <div className="grid gap-8 sm:grid-cols-2">
@@ -700,12 +711,12 @@ export default function Home() {
             { t: "Building in the open, one year in", d: "What we learned shipping every week where anyone could watch.", tag: "Culture", e: "\u{1F331}" },
             { t: "Design systems for teams of one", d: "You don't need a committee to move fast and stay consistent.", tag: "Design", e: "\u{1F3A8}" },
           ].map((p) => (
-            <a key={p.t} href="/blog" className="group">
+            <Link key={p.t} href="/blog" className="group">
               <div className="mb-4 flex aspect-[16/9] items-center justify-center overflow-hidden rounded-2xl gradient-bg text-5xl on-accent transition group-hover:scale-[1.02]">{p.e}</div>
               <span className="text-xs font-semibold uppercase tracking-widest gradient-text">{p.tag}</span>
               <h3 className="mt-1.5 text-xl font-semibold tracking-tight transition group-hover:text-[color:var(--accent-to)]">{p.t}</h3>
               <p className="mt-1.5 text-sm leading-relaxed text-muted">{p.d}</p>
-            </a>
+            </Link>
           ))}
         </div>
       </section>`);
@@ -717,7 +728,7 @@ export default function Home() {
         <h1 className="text-display mt-7">Build with <span className="gradient-text">${n}</span></h1>
         <p className="lead mx-auto mt-6 max-w-2xl">Guides, API references and copy-paste examples \u2014 everything you need, in one fast, searchable place.</p>
         <div className="mt-9 flex flex-wrap items-center justify-center gap-3">
-          <a href="/docs" className="shimmer rounded-full gradient-bg px-7 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Read the docs</a>
+          <Link href="/docs" className="shimmer rounded-full gradient-bg px-7 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Read the docs</Link>
           <div className="glass inline-flex items-center gap-3 rounded-full px-5 py-3 font-mono text-sm text-muted"><span className="gradient-text font-bold">$</span> npm i ${pkg}</div>
         </div>
       </section>
@@ -728,11 +739,11 @@ export default function Home() {
             { t: "Guides", d: "Task-focused walkthroughs for the paths you'll actually take.", e: "\u{1F9ED}", href: "/guides" },
             { t: "API reference", d: "Every endpoint, fully typed, with copy-paste examples in each language.", e: "\u{1F50C}", href: "/api-reference" },
           ].map((c) => (
-            <a key={c.t} href={c.href} className="card group p-8">
+            <Link key={c.t} href={c.href} className="card group p-8">
               <div className="mb-5 inline-flex h-12 w-12 items-center justify-center rounded-2xl gradient-bg text-2xl accent-glow">{c.e}</div>
               <h3 className="text-xl font-bold tracking-tight">{c.t} <span className="inline-block transition group-hover:translate-x-1">\u2192</span></h3>
               <p className="mt-2 leading-relaxed text-muted">{c.d}</p>
-            </a>
+            </Link>
           ))}
         </div>
       </section>`);
@@ -743,8 +754,8 @@ export default function Home() {
         <h1 className="text-display mt-5"><span className="gradient-text">${n}</span></h1>
         <p className="lead mx-auto mt-6 max-w-xl">${ctx.template.siteDescription}</p>
         <div className="mt-10 flex flex-wrap justify-center gap-3">
-          <a href="/reservations" className="shimmer rounded-full gradient-bg px-8 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Reserve a table</a>
-          <a href="/menu" className="rounded-full border border-hairline px-8 py-3.5 font-semibold transition hover:bg-surface">View the menu</a>
+          <Link href="/reservations" className="shimmer rounded-full gradient-bg px-8 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Reserve a table</Link>
+          <Link href="/menu" className="rounded-full border border-hairline px-8 py-3.5 font-semibold transition hover:bg-surface">View the menu</Link>
         </div>
       </section>
       <section id="menu" className="mx-auto max-w-4xl px-6 py-20">
@@ -770,8 +781,8 @@ export default function Home() {
         <h1 className="text-display mt-7">Ship faster with <span className="gradient-text">${n}</span></h1>
         <p className="lead mx-auto mt-6 max-w-2xl">${ctx.template.siteDescription}</p>
         <div className="mt-10 flex flex-wrap justify-center gap-3">
-          <a href="/pricing" className="shimmer rounded-full gradient-bg px-8 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Start free</a>
-          <a href="/features" className="rounded-full border border-hairline px-8 py-3.5 font-semibold transition hover:bg-surface">See features</a>
+          <Link href="/pricing" className="shimmer rounded-full gradient-bg px-8 py-3.5 font-semibold on-accent transition hover:-translate-y-0.5">Start free</Link>
+          <Link href="/features" className="rounded-full border border-hairline px-8 py-3.5 font-semibold transition hover:bg-surface">See features</Link>
         </div>
         <p className="mt-5 text-sm text-faint">No credit card \xB7 Free forever plan \xB7 SOC 2-ready</p>
       </section>
@@ -1015,7 +1026,7 @@ var careersPage = (ctx) => {
           ].map((j) => (
             <div key={j.role} className="flex flex-wrap items-center justify-between gap-3 rounded-2xl border border-hairline bg-surface p-5">
               <div><h3 className="font-semibold">{j.role}</h3><p className="text-sm text-muted">{j.team}</p></div>
-              <div className="flex items-center gap-3"><Badge>{j.type}</Badge><a href="/contact" className="rounded-full gradient-bg px-4 py-2 text-sm font-semibold on-accent">Apply</a></div>
+              <div className="flex items-center gap-3"><Badge>{j.type}</Badge><Link href="/contact" className="rounded-full gradient-bg px-4 py-2 text-sm font-semibold on-accent">Apply</Link></div>
             </div>
           ))}
         </div>
@@ -1112,7 +1123,7 @@ var reservationsPage = (ctx) => {
         <div className="mx-auto max-w-2xl rounded-3xl border border-hairline bg-surface p-8 text-center">
           <h2 className="text-2xl font-bold">Book by phone or online</h2>
           <p className="mt-3 text-muted">Call us on <span className="font-semibold text-fg">+1 (555) 012-3456</span> or reserve online in seconds.</p>
-          <a href="/contact" className="mt-6 inline-block rounded-full gradient-bg px-8 py-3 font-semibold on-accent">Reserve a table</a>
+          <Link href="/contact" className="mt-6 inline-block rounded-full gradient-bg px-8 py-3 font-semibold on-accent">Reserve a table</Link>
         </div>
       </Section>`,
     cta: { title: "Planning something special?", subtitle: "Ask us about private dining and set menus.", label: "Enquire now", href: "/contact" }
@@ -5067,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 };