@thebase/ui 1.2.0 → 1.3.0

package/bin/{create-baseui-app.mjs → create-nodexui-app.mjs}

@@ -15,7 +15,7 @@ function toPackageName(name) {
     .trim()
     .toLowerCase()
     .replace(/[^a-z0-9-]+/g, "-")
-    .replace(/^-+|-+$/g, "") || "baseui-app";
+    .replace(/^-+|-+$/g, "") || "nodexui-app";
 }
 
 /** Turns a kebab/snake-case app name into a human-readable title, e.g. "qr-page" -> "Qr Page". */
@@ -27,8 +27,8 @@ function toTitle(appName) {
     .join(" ");
 }
 
-/** Builds the fixed set of Vite + the Base UI scaffold files for a project named `appName`. */
-function buildTemplateFiles(appName, baseuiVersion) {
+/** Builds the fixed set of Vite + Nodex UI scaffold files for a project named `appName`. */
+function buildTemplateFiles(appName, nodexuiVersion) {
   const title = toTitle(appName);
 
   return {
@@ -44,7 +44,7 @@ function buildTemplateFiles(appName, baseuiVersion) {
           preview: "vite preview",
         },
         dependencies: {
-          "@thebase/ui": `^${baseuiVersion}`,
+          "nodexui": `^${nodexuiVersion}`,
         },
         devDependencies: {
           vite: "^8.2.1",
@@ -55,11 +55,11 @@ function buildTemplateFiles(appName, baseuiVersion) {
     ) + "\n",
 
     "vite.config.js": `import { defineConfig } from "vite";
-import { baseuiPwa } from "@thebase/ui/vite";
+import { nodexuiPwa } from "nodexui/vite";
 
 export default defineConfig({
   server: { open: true },
-  plugins: [baseuiPwa({ name: ${JSON.stringify(title)} })],
+  plugins: [nodexuiPwa({ name: ${JSON.stringify(title)} })],
 });
 `,
 
@@ -88,11 +88,11 @@ export default defineConfig({
 </svg>
 `,
 
-    "src/style.css": `/* App-specific styles layered on top of @thebase/ui/baseui.css go here. */\n`,
+    "src/style.css": `/* App-specific styles layered on top of nodexui/nodexui.css go here. */\n`,
 
-    "src/main.js": `import "@thebase/ui/baseui.css";
-import { mount } from "@thebase/ui";
-import baseuiTemplates from "@thebase/ui/dist/baseui.templates.xml?raw";
+    "src/main.js": `import "nodexui/nodexui.css";
+import { mount } from "nodexui";
+import nodexuiTemplates from "nodexui/dist/nodexui.templates.xml?raw";
 import appTemplates from "./App.xml?raw";
 import { App } from "./App.js";
 import "./style.css";
@@ -103,15 +103,15 @@ import "./style.css";
 const stripTemplatesWrapper = (xml) =>
   xml.replace(/^\\s*<templates[^>]*>/, "").replace(/<\\/templates>\\s*$/, "");
 
-const templates = \`<templates>\${stripTemplatesWrapper(baseuiTemplates)}\${stripTemplatesWrapper(appTemplates)}</templates>\`;
+const templates = \`<templates>\${stripTemplatesWrapper(nodexuiTemplates)}\${stripTemplatesWrapper(appTemplates)}</templates>\`;
 
 await mount(App, document.getElementById("app"), { templates });
 `,
 
-    "src/App.js": `import { Component, useState } from "@thebase/ui";
-import { Button, Card, CardBody, CardHeader, CardTitle } from "@thebase/ui";
+    "src/App.js": `import { Component, useState } from "nodexui";
+import { Button, Card, CardBody, CardHeader, CardTitle } from "nodexui";
 
-/** Root screen of the app: owns top-level state and composes BaseUI components. */
+/** Root screen of the app: owns top-level state and composes NodexUI components. */
 export class App extends Component {
   static template = "app.Root";
   static components = { Button, Card, CardBody, CardHeader, CardTitle };
@@ -139,7 +139,7 @@ export class App extends Component {
 
     "README.md": `# ${title}
 
-Scaffolded with \`@thebase/ui\`'s CLI (Vite + BaseUI, pure Base API).
+Scaffolded with \`nodexui\`'s CLI (Vite + NodexUI, pure Base API).
 
 \`\`\`sh
 npm install
@@ -169,7 +169,7 @@ function pageHtml(title, entryScript) {
 
 /** Builds one page's entry script: loads its templates/component and mounts via the shared mountPage helper. */
 function pageMain(componentName, templatesImportPath, componentImportPath) {
-  return `import "@thebase/ui/baseui.css";
+  return `import "nodexui/nodexui.css";
 import pageTemplates from "${templatesImportPath}?raw";
 import { ${componentName} } from "${componentImportPath}";
 import { mountPage } from "../mount-page.js";
@@ -179,10 +179,10 @@ await mountPage(${componentName}, pageTemplates);
 `;
 }
 
-/** Builds a 4-page Vite + the Base UI starter (landing, login, signup, an authenticated home shell) for a
+/** Builds a 4-page Vite + Nodex UI starter (landing, login, signup, an authenticated home shell) for a
  * project named `appName` — each page is its own Owl root mounted by its own HTML entry, composed
  * from the same blocks as `examples/blocks/login-03.html`, `signup-03.html` and `sidebar-02.html`. */
-function buildStarterFiles(appName, baseuiVersion) {
+function buildStarterFiles(appName, nodexuiVersion) {
   const title = toTitle(appName);
 
   return {
@@ -198,7 +198,7 @@ function buildStarterFiles(appName, baseuiVersion) {
           preview: "vite preview",
         },
         dependencies: {
-          "@thebase/ui": `^${baseuiVersion}`,
+          "nodexui": `^${nodexuiVersion}`,
         },
         devDependencies: {
           vite: "^8.2.1",
@@ -209,7 +209,7 @@ function buildStarterFiles(appName, baseuiVersion) {
     ) + "\n",
 
     "vite.config.js": `import { defineConfig } from "vite";
-import { baseuiPwa } from "@thebase/ui/vite";
+import { nodexuiPwa } from "nodexui/vite";
 import { fileURLToPath } from "node:url";
 
 /** Resolves a file in this config's own directory, Node-ESM-safe (no __dirname in ESM). */
@@ -217,7 +217,7 @@ const here = (file) => fileURLToPath(new URL(file, import.meta.url));
 
 export default defineConfig({
   server: { open: true },
-  plugins: [baseuiPwa({ name: ${JSON.stringify(title)} })],
+  plugins: [nodexuiPwa({ name: ${JSON.stringify(title)} })],
   build: {
     rollupOptions: {
       input: {
@@ -241,27 +241,27 @@ export default defineConfig({
 </svg>
 `,
 
-    "src/style.css": `/* App-specific styles layered on top of @thebase/ui/baseui.css go here. */\n`,
+    "src/style.css": `/* App-specific styles layered on top of nodexui/nodexui.css go here. */\n`,
 
-    "src/mount-page.js": `import { mount } from "@thebase/ui";
-import baseuiTemplates from "@thebase/ui/dist/baseui.templates.xml?raw";
+    "src/mount-page.js": `import { mount } from "nodexui";
+import nodexuiTemplates from "nodexui/dist/nodexui.templates.xml?raw";
 
 /** Both files are full <templates>...</templates> documents; strip each one's outer wrapper before
  * joining them, otherwise the merged string has two root elements and Owl's XML parser throws. */
 const stripTemplatesWrapper = (xml) =>
   xml.replace(/^\\s*<templates[^>]*>/, "").replace(/<\\/templates>\\s*$/, "");
 
-/** Merges BaseUI's component templates with one page's own templates and mounts its root component. */
+/** Merges NodexUI's component templates with one page's own templates and mounts its root component. */
 export async function mountPage(Root, pageTemplatesXml) {
-  const templates = \`<templates>\${stripTemplatesWrapper(baseuiTemplates)}\${stripTemplatesWrapper(pageTemplatesXml)}</templates>\`;
+  const templates = \`<templates>\${stripTemplatesWrapper(nodexuiTemplates)}\${stripTemplatesWrapper(pageTemplatesXml)}</templates>\`;
   await mount(Root, document.getElementById("app"), { templates });
 }
 `,
 
     "index.html": pageHtml(title, "/src/landing/main.js"),
     "src/landing/main.js": pageMain("Landing", "./Landing.xml", "./Landing.js"),
-    "src/landing/Landing.js": `import { Component } from "@thebase/ui";
-import { Button, Card, CardBody, CardHeader, CardTitle, Icon } from "@thebase/ui";
+    "src/landing/Landing.js": `import { Component } from "nodexui";
+import { Button, Card, CardBody, CardHeader, CardTitle, Icon } from "nodexui";
 
 /** Marketing landing page: header with a login link, hero pitch, feature grid, footer. */
 export class Landing extends Component {
@@ -285,7 +285,7 @@ export class Landing extends Component {
       <section class="container py-5 text-center">
         <h1 class="display-5 fw-bold mb-3">Build faster with ${title}</h1>
         <p class="lead text-muted mx-auto mb-4" style="max-width: 40rem">
-          A starter scaffold wired up with BaseUI — Base components, Bootstrap styling, and the pages you need to ship day one.
+          A starter scaffold wired up with NodexUI — Base components, themed styling, and the pages you need to ship day one.
         </p>
         <div class="d-flex justify-content-center gap-3">
           <Button icon="'rocket'" onClick="() => window.location.assign('/signup.html')">Get started</Button>
@@ -298,7 +298,7 @@ export class Landing extends Component {
           <div class="col-12 col-md-4">
             <Card className="'h-100'">
               <CardHeader className="'d-flex align-items-center gap-2'"><Icon name="'zap'"/><CardTitle>Fast by default</CardTitle></CardHeader>
-              <CardBody>Vite dev server and production build, pre-wired to BaseUI's CDN or local dist.</CardBody>
+              <CardBody>Vite dev server and production build, pre-wired to NodexUI's CDN or local dist.</CardBody>
             </Card>
           </div>
           <div class="col-12 col-md-4">
@@ -310,7 +310,7 @@ export class Landing extends Component {
           <div class="col-12 col-md-4">
             <Card className="'h-100'">
               <CardHeader className="'d-flex align-items-center gap-2'"><Icon name="'component'"/><CardTitle>Base components</CardTitle></CardHeader>
-              <CardBody>Every page composes real BaseUI components — swap or extend without fighting the markup.</CardBody>
+              <CardBody>Every page composes real NodexUI components — swap or extend without fighting the markup.</CardBody>
             </Card>
           </div>
         </div>
@@ -329,8 +329,8 @@ export class Landing extends Component {
 
     "login.html": pageHtml(`Login — ${title}`, "/src/login/main.js"),
     "src/login/main.js": pageMain("Login", "./Login.xml", "./Login.js"),
-    "src/login/Login.js": `import { Component } from "@thebase/ui";
-import { Button, Card, CardBody, Field, FieldGroup, Icon, Input, Label } from "@thebase/ui";
+    "src/login/Login.js": `import { Component } from "nodexui";
+import { Button, Card, CardBody, Field, FieldGroup, Icon, Input, Label } from "nodexui";
 
 /** Login page (ported from examples/blocks/login-03.html): email/password card, redirects home on submit. */
 export class Login extends Component {
@@ -380,8 +380,8 @@ export class Login extends Component {
 
     "signup.html": pageHtml(`Sign up — ${title}`, "/src/signup/main.js"),
     "src/signup/main.js": pageMain("Signup", "./Signup.xml", "./Signup.js"),
-    "src/signup/Signup.js": `import { Component } from "@thebase/ui";
-import { Button, Card, CardBody, Field, FieldGroup, Icon, Input, Label } from "@thebase/ui";
+    "src/signup/Signup.js": `import { Component } from "nodexui";
+import { Button, Card, CardBody, Field, FieldGroup, Icon, Input, Label } from "nodexui";
 
 /** Signup page (ported from examples/blocks/signup-03.html): single email field, sends the user to login after submit. */
 export class Signup extends Component {
@@ -424,13 +424,13 @@ export class Signup extends Component {
 
     "home.html": pageHtml(`Home — ${title}`, "/src/home/main.js"),
     "src/home/main.js": pageMain("Home", "./Home.xml", "./Home.js"),
-    "src/home/Home.js": `import { Component, useState } from "@thebase/ui";
+    "src/home/Home.js": `import { Component, useState } from "nodexui";
 import {
   Breadcrumb, BreadcrumbItem, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator,
   Button, Icon, Input, Separator,
   Shell, ShellContent, ShellHeader, ShellMain, ShellNav, ShellSidebar, ShellSidebarHeader,
   SidebarGroupCollapsible, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarTrigger,
-} from "@thebase/ui";
+} from "nodexui";
 
 /** Authenticated home shell (ported from examples/blocks/sidebar-02.html): collapsible sidebar nav
  * + sticky header, reached after login/signup; owns the sidebar's collapsed/expanded state. */
@@ -499,7 +499,7 @@ export class Home extends Component {
 
     "README.md": `# ${title}
 
-Scaffolded with \`@thebase/ui\`'s CLI (\`create-baseui-app init\`): Vite + BaseUI, pure Base API, 4 pages.
+Scaffolded with \`nodexui\`'s CLI (\`create-nodexui-app init\`): Vite + NodexUI, pure Base API, 4 pages.
 
 - \`/\` — landing page (header, hero, features, footer)
 - \`/login.html\` — login (redirects to \`/home.html\` on submit)
@@ -560,7 +560,7 @@ function cmdCreate(argv) {
   const { flags, positional } = parseFlags(argv);
   const rawName = positional[0];
   if (!rawName) {
-    console.error("Usage: create-baseui-app create <app-name> [--version <x.y.z>] [--no-install] [--force]");
+    console.error("Usage: create-nodexui-app create <app-name> [--version <x.y.z>] [--no-install] [--force]");
     process.exit(1);
   }
   const appName = toPackageName(rawName);
@@ -571,11 +571,11 @@ function cmdCreate(argv) {
     process.exit(1);
   }
 
-  const baseuiVersion = flags.version || ownPackageJson.version;
-  const files = buildTemplateFiles(appName, baseuiVersion);
+  const nodexuiVersion = flags.version || ownPackageJson.version;
+  const files = buildTemplateFiles(appName, nodexuiVersion);
   const { written } = writeFiles(targetDir, files, { overwrite: flags.force ?? false });
 
-  console.log(`Scaffolded a Vite + BaseUI app in ${targetDir}`);
+  console.log(`Scaffolded a Vite + NodexUI app in ${targetDir}`);
   written.forEach((f) => console.log(`  create ${f}`));
 
   if (flags.install) runInstall(targetDir);
@@ -588,7 +588,7 @@ function cmdInit(argv) {
   const { flags, positional } = parseFlags(argv);
   const rawName = positional[0];
   if (!rawName) {
-    console.error("Usage: create-baseui-app init <app-name> [--version <x.y.z>] [--no-install] [--force]");
+    console.error("Usage: create-nodexui-app init <app-name> [--version <x.y.z>] [--no-install] [--force]");
     process.exit(1);
   }
   const appName = toPackageName(rawName);
@@ -599,11 +599,11 @@ function cmdInit(argv) {
     process.exit(1);
   }
 
-  const baseuiVersion = flags.version || ownPackageJson.version;
-  const files = buildStarterFiles(appName, baseuiVersion);
+  const nodexuiVersion = flags.version || ownPackageJson.version;
+  const files = buildStarterFiles(appName, nodexuiVersion);
   const { written } = writeFiles(targetDir, files, { overwrite: flags.force ?? false });
 
-  console.log(`Scaffolded a 4-page Vite + BaseUI starter in ${targetDir}`);
+  console.log(`Scaffolded a 4-page Vite + NodexUI starter in ${targetDir}`);
   written.forEach((f) => console.log(`  create ${f}`));
 
   if (flags.install) runInstall(targetDir);
@@ -625,14 +625,14 @@ function cmdConvert(argv) {
 
   const existingPackageJsonPath = path.join(targetDir, "package.json");
   const appName = toPackageName(path.basename(targetDir));
-  const baseuiVersion = flags.version || ownPackageJson.version;
-  const files = buildTemplateFiles(appName, baseuiVersion);
+  const nodexuiVersion = flags.version || ownPackageJson.version;
+  const files = buildTemplateFiles(appName, nodexuiVersion);
 
   if (existsSync(existingPackageJsonPath)) {
     const existing = JSON.parse(readFileSync(existingPackageJsonPath, "utf8"));
     existing.type ??= "module";
     existing.scripts = { dev: "vite", build: "vite build", preview: "vite preview", ...existing.scripts };
-    existing.dependencies = { ...existing.dependencies, "@thebase/ui": `^${baseuiVersion}` };
+    existing.dependencies = { ...existing.dependencies, "nodexui": `^${nodexuiVersion}` };
     existing.devDependencies = { ...existing.devDependencies, vite: existing.devDependencies?.vite || "^8.2.1" };
     delete files["package.json"];
     writeFileSync(existingPackageJsonPath, JSON.stringify(existing, null, 2) + "\n");
@@ -641,14 +641,14 @@ function cmdConvert(argv) {
 
   const { written, skipped } = writeFiles(targetDir, files, { overwrite: false });
 
-  console.log(`Converted ${targetDir} into a Vite + BaseUI project.`);
+  console.log(`Converted ${targetDir} into a Vite + NodexUI project.`);
   written.forEach((f) => console.log(`  create ${f}`));
   skipped.forEach((f) => console.log(`  skip   ${f} (already exists)`));
 
   if (skipped.includes("vite.config.js")) {
     console.log(
-      '\nvite.config.js already existed — add `import { baseuiPwa } from "@thebase/ui/vite"` and ' +
-        "`plugins: [baseuiPwa({ name: \"My App\" })]` so every build emits the PWA files and auto-reloads on a new version.",
+      '\nvite.config.js already existed — add `import { nodexuiPwa } from "nodexui/vite"` and ' +
+        "`plugins: [nodexuiPwa({ name: \"My App\" })]` so every build emits the PWA files and auto-reloads on a new version.",
     );
   }
 
@@ -664,12 +664,12 @@ function cmdConvert(argv) {
   console.log(`\nNext steps:\n  npm run dev`);
 }
 
-/** Generates manifest.webmanifest + sw.js for a PWA from a `baseui.pwa.config.js` the user wrote,
- * using @thebase/ui's buildManifest/buildServiceWorker (see docs/usage-guide.md "PWA toolkit"). */
+/** Generates manifest.webmanifest + sw.js for a PWA from a `nodexui.pwa.config.js` the user wrote,
+ * using nodexui's buildManifest/buildServiceWorker (see docs/usage-guide.md "PWA toolkit"). */
 async function cmdPwa(argv) {
   const { flags, positional } = parseFlags(argv);
   const targetDir = path.resolve(process.cwd(), positional[0] || ".");
-  const configPath = path.resolve(targetDir, flags.config || "baseui.pwa.config.js");
+  const configPath = path.resolve(targetDir, flags.config || "nodexui.pwa.config.js");
 
   if (!existsSync(configPath)) {
     console.error(
@@ -681,7 +681,7 @@ async function cmdPwa(argv) {
   }
 
   const { manifest, serviceWorker } = (await import(pathToFileURL(configPath).href)).default;
-  const { buildManifest, buildServiceWorker, buildServiceWorkerRegister, buildVersionJson, DEFAULT_ICON_FILES } = await import("../dist/baseui.pwa.esm.js");
+  const { buildManifest, buildServiceWorker, buildServiceWorkerRegister, buildVersionJson, DEFAULT_ICON_FILES } = await import("../dist/nodexui.pwa.esm.js");
 
   writeFileSync(
     path.join(targetDir, "manifest.webmanifest"),
@@ -708,7 +708,7 @@ function hashAppFiles(targetDir, appFiles = []) {
   return hash.digest("hex").slice(0, 12);
 }
 
-/** Gives a PWA the default the Base UI logo/favicon set, without replacing any icon the app already has. */
+/** Gives a PWA the default Nodex UI logo/favicon set, without replacing any icon the app already has. */
 function copyDefaultIcons(iconsDir, files) {
   mkdirSync(iconsDir, { recursive: true });
   const source = new URL("../dist/pwa-icons/", import.meta.url);
@@ -719,25 +719,25 @@ function copyDefaultIcons(iconsDir, files) {
 }
 
 function printHelp() {
-  console.log(`@thebase/ui project CLI
+  console.log(`nodexui project CLI
 
 Usage:
-  create-baseui-app create <app-name> [--version <x.y.z>] [--no-install] [--force]
-      Scaffold a new Vite + BaseUI project in ./<app-name>.
+  create-nodexui-app create <app-name> [--version <x.y.z>] [--no-install] [--force]
+      Scaffold a new Vite + NodexUI project in ./<app-name>.
 
-  create-baseui-app convert [path] [--version <x.y.z>] [--no-install]
-      Turn an existing (non-npm) folder into a Vite + BaseUI project, in place.
+  create-nodexui-app convert [path] [--version <x.y.z>] [--no-install]
+      Turn an existing (non-npm) folder into a Vite + NodexUI project, in place.
       Never overwrites files that already exist; only fills in what's missing.
 
-  create-baseui-app init <app-name> [--version <x.y.z>] [--no-install] [--force]
+  create-nodexui-app init <app-name> [--version <x.y.z>] [--no-install] [--force]
       Scaffold a ready-to-start 4-page project in ./<app-name>: a landing page
       (header/hero/features/footer), login, signup, and an authenticated home
       shell (sidebar + header) — ported from the login-03/signup-03/sidebar-02
       example blocks.
 
-  create-baseui-app pwa [path] [--config <file>]
+  create-nodexui-app pwa [path] [--config <file>]
       Generate manifest.webmanifest + sw.js in [path] (default ".") from a
-      baseui.pwa.config.js config file (default name, override with --config).
+      nodexui.pwa.config.js config file (default name, override with --config).
       Also copies the default logo/favicon set into [path]/icons/ (existing files kept).
 `);
 }