lucynui 0.1.1 → 0.1.2

package/cli/create.ts

@@ -1,18 +1,23 @@
 import { closeSync, openSync } from "node:fs";
-import { cp, mkdir, mkdtemp, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
+import { cp } from "node:fs/promises";
 import { basename, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import * as proc from "./proc";
 import * as ui from "./ui";
 
 /** Matches the line the framework logs once the server is listening. */
 const SERVER_READY = /dev server running on http:\/\/localhost:(\d+)/;
 
-/** The starter files, mirroring the template repo. */
+/** Files copied from the bundled template into a new project. */
 const TEMPLATE_FILES = ["index.html", "style.css", "app.js", "app.ts", "lucyn.config.ts", "tsconfig.json", ".gitignore"];
 
 const bun = () => proc.findBun() ?? "bun";
 
+/** Absolute path to the bundled template directory inside this package. */
+function templateDir(): string {
+  return fileURLToPath(new URL("../template", import.meta.url));
+}
+
 /* ------------------------------------------------------------------ commands */
 
 export async function dev(): Promise<never> {
@@ -37,13 +42,11 @@ export async function create(appName: string): Promise<never> {
 
   const bunPath = await proc.ensureBun();
   await proc.ensureSystemDeps();
-  proc.requireGit();
 
-  ui.step(1, "cloning the template, hang on");
-  await proc.runStep(process.cwd(), ["git", "clone", "--depth", "1", proc.TEMPLATE_REPO, appName]);
-  await rm(join(appName, ".git"), { recursive: true, force: true });
+  ui.step(1, "scaffolding the template, hang on");
+  await scaffoldInto(join(process.cwd(), appName));
   await pinFramework(appName);
-  ui.done("cloning complete — fetching the deps and required builds");
+  ui.done("scaffolding complete — fetching the deps and required builds");
 
   ui.step(2, "installing modules including lucynui");
   await proc.runStep(appName, [bunPath, "install"]);
@@ -66,14 +69,13 @@ export async function create(appName: string): Promise<never> {
 export async function init(): Promise<never> {
   const bunPath = await proc.ensureBun();
   await proc.ensureSystemDeps();
-  proc.requireGit();
 
   if (await isProject(process.cwd())) {
     ui.info("This is already a LucyN UI app — starting dev.");
   } else {
-    ui.step(1, "cloning the template, hang on");
+    ui.step(1, "scaffolding the template, hang on");
     await scaffoldInto(process.cwd());
-    ui.done("cloning complete — fetching the deps and required builds");
+    ui.done("scaffolding complete — fetching the deps and required builds");
 
     ui.step(2, "installing modules including lucynui");
     await proc.runStep(process.cwd(), [bunPath, "install"]);
@@ -101,38 +103,38 @@ export function isProject(dir: string) {
 
 /** Runs a build and throws away the binary — the point is proving it compiles. */
 export async function testBuild(dir: string) {
+  const { rm } = await import("node:fs/promises");
   const code = await proc.run(dir, [bun(), proc.frameworkPath("build.ts")]);
   await rm(join(dir, "dist"), { recursive: true, force: true });
 
   if (code !== 0) throw new Error("the test build failed");
 }
 
-/** Copies the starter files into an existing folder, never overwriting anything. */
+/**
+ * Copies the bundled template files into `dir`, never overwriting existing
+ * files — except `package.json`: `bun add` creates a bare manifest (no scripts)
+ * before postinstall runs, so we always replace it with the full template version.
+ */
 export async function scaffoldInto(dir: string) {
-  const source = await fetchTemplate();
-
-  try {
-    for (const file of TEMPLATE_FILES) {
-      const target = join(dir, file);
-      if (await Bun.file(target).exists()) continue;
-      await cp(join(source, file), target);
-    }
+  const { mkdir } = await import("node:fs/promises");
+  await mkdir(dir, { recursive: true });
 
-    const manifest = join(dir, "package.json");
-    if (!(await Bun.file(manifest).exists())) {
-      await cp(join(source, "package.json"), manifest);
-    }
+  const source = templateDir();
 
-    await patchManifest(manifest);
-  } finally {
-    await rm(source, { recursive: true, force: true });
+  for (const file of TEMPLATE_FILES) {
+    const target = join(dir, file);
+    if (await Bun.file(target).exists()) continue;
+    await cp(join(source, file), target);
   }
+
+  // Always write the template package.json — the bare one bun creates before
+  // postinstall (no scripts, no name, no type) is useless and must be replaced.
+  await cp(join(source, "package.json"), join(dir, "package.json"));
 }
 
 /** Points the app at this CLI's own version, so template drift can never bite. */
 async function pinFramework(dir: string) {
-  const manifestPath = join(dir, "package.json");
-  const manifest = Bun.file(manifestPath);
+  const manifest = Bun.file(join(dir, "package.json"));
   if (!(await manifest.exists())) return;
 
   // Running from a checkout rather than an install? Point the app at this copy
@@ -144,43 +146,6 @@ async function pinFramework(dir: string) {
   const pkg = await manifest.json();
   pkg.dependencies = { ...(pkg.dependencies ?? {}), lucynui: spec };
   await Bun.write(manifest, JSON.stringify(pkg, null, 2) + "\n");
-
-  await patchManifest(manifestPath);
-}
-
-/**
- * Ensures the scaffolded package.json has the scripts and trustedDependencies
- * that users expect — the template repo ships a minimal manifest intentionally,
- * so we inject these here rather than keeping them in sync in two repos.
- */
-async function patchManifest(manifestPath: string) {
-  const file = Bun.file(manifestPath);
-  if (!(await file.exists())) return;
-
-  const pkg = await file.json();
-
-  pkg.scripts = {
-    dev: "lucyn dev",
-    build: "lucyn build",
-    ...(pkg.scripts ?? {}),
-  };
-
-  const trusted: string[] = pkg.trustedDependencies ?? [];
-  if (!trusted.includes("lucynui")) trusted.push("lucynui");
-  pkg.trustedDependencies = trusted;
-
-  await Bun.write(file, JSON.stringify(pkg, null, 2) + "\n");
-}
-
-async function fetchTemplate() {
-  const tmp = await mkdtemp(join(tmpdir(), "lucyn-template-"));
-  await mkdir(tmp, { recursive: true });
-  const checkout = join(tmp, "template");
-
-  await proc.runStep(tmp, ["git", "clone", "--depth", "1", proc.TEMPLATE_REPO, checkout]);
-  await rm(join(checkout, ".git"), { recursive: true, force: true });
-
-  return checkout;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lucynui",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Desktop apps from plain HTML, CSS and JS. No React, no Rust, no Electron.",
   "license": "MIT",
   "type": "module",
@@ -13,6 +13,7 @@
     "bin/",
     "cli/",
     "src/",
+    "template/",
     "webview-bun/src/",
     "webview-bun/build/"
   ],

package/template/app.js

@@ -0,0 +1,6 @@
+const button = document.getElementById("ping");
+const message = document.getElementById("message");
+
+button?.addEventListener("click", () => {
+  if (message) message.textContent = `Hello from LucyN UI — ${new Date().toLocaleTimeString()}`;
+});

package/template/app.ts

@@ -0,0 +1,4 @@
+import { createApp } from "lucynui";
+
+// Entry point for `lucyn dev` and `lucyn build`.
+createApp();

package/template/index.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>LucyN App</title>
+    <link rel="stylesheet" href="/style.css" />
+  </head>
+  <body>
+    <main class="app">
+      <p class="brand">LucyN UI</p>
+      <h1>Your desktop app starts here</h1>
+      <p id="message">
+        Edit <code>index.html</code>, <code>style.css</code> or <code>app.js</code> and the window reloads by itself.
+      </p>
+      <button id="ping">Say hello</button>
+    </main>
+    <script src="/app.js"></script>
+  </body>
+</html>

package/template/lucyn.config.ts

@@ -0,0 +1,8 @@
+// LucyN UI config — every field is optional.
+export default {
+  title: "LucyN App",
+  width: 1024,
+  height: 768,
+  port: 3927,
+  dev: false,
+};

package/template/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "lucyn-app",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "lucyn dev",
+    "build": "lucyn build"
+  },
+  "dependencies": {
+    "lucynui": "^0.1.0"
+  },
+  "trustedDependencies": ["lucynui"],
+  "devDependencies": {
+    "@types/bun": "latest"
+  }
+}

package/template/style.css

@@ -0,0 +1,66 @@
+:root {
+  color-scheme: dark;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+  display: grid;
+  place-items: center;
+  background: radial-gradient(circle at 50% 0%, #1b2133, #0d0f14 60%);
+  color: #e8eaf0;
+  font-family: system-ui, -apple-system, "Segoe UI", sans-serif;
+}
+
+.app {
+  max-width: 40rem;
+  padding: 3rem;
+  text-align: center;
+}
+
+.brand {
+  margin: 0 0 1rem;
+  font-size: 0.75rem;
+  letter-spacing: 0.22em;
+  text-transform: uppercase;
+  color: #e0b34d;
+}
+
+h1 {
+  margin: 0 0 1rem;
+  font-size: 2rem;
+}
+
+p {
+  line-height: 1.7;
+  color: #a3abbf;
+}
+
+code {
+  padding: 0.15rem 0.4rem;
+  border-radius: 5px;
+  background: #1d2231;
+  color: #e8eaf0;
+  font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  font-size: 0.9em;
+}
+
+button {
+  margin-top: 1rem;
+  padding: 0.7rem 1.4rem;
+  border: 1px solid #2c3347;
+  border-radius: 10px;
+  background: #e0b34d;
+  color: #14181f;
+  font: inherit;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+button:hover {
+  background: #f0c465;
+}

package/template/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+    "types": ["bun"],
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}