@thebase/ui 1.2.0 → 1.3.0

package/dist/types/index.d.ts

@@ -1,13 +1,13 @@
-export interface BaseUIComponentDefinition {
+export interface NodexUIComponentDefinition {
   type?: "static" | "owl";
   selector?: string;
-  mount?: (element: Element, api: BaseUIApi, options?: Record<string, unknown>) => { destroy?: () => void } | void;
+  mount?: (element: Element, api: NodexUIApi, options?: Record<string, unknown>) => { destroy?: () => void } | void;
 }
 
-export interface BaseUIApi {
+export interface NodexUIApi {
   version: string;
-  register(name: string, componentDefinition: BaseUIComponentDefinition): BaseUIApi;
-  component(name: string): BaseUIComponentDefinition | undefined;
+  register(name: string, componentDefinition: NodexUIComponentDefinition): NodexUIApi;
+  component(name: string): NodexUIComponentDefinition | undefined;
   mount(selectorOrElement: string | Element, options?: Record<string, unknown>): unknown;
   mountAll(rootElement?: ParentNode): unknown[];
   destroy(rootElement?: ParentNode): void;
@@ -25,13 +25,15 @@ export interface BaseUIApi {
     };
   };
   theme: { set(modeOrTokens: string | Record<string, string>): void };
-  /** Set by dist/baseui.analytics.min.js (the optional analytics service). */
-  analytics?: import("./analytics").BaseUIAnalytics;
+  /** Set by dist/nodexui.analytics.min.js (the optional analytics service). */
+  analytics?: import("./analytics").NodexUIAnalytics;
+  /** Set by dist/nodexui.i18n.min.js (the optional i18n service). */
+  i18n?: typeof import("./i18n");
   /** Bound by `analytics.init()` (unless `bindToWindow: false`). */
-  track?: import("./analytics").BaseUIAnalytics["track"];
+  track?: import("./analytics").NodexUIAnalytics["track"];
 }
 
-export interface BaseUIThemeController {
+export interface NodexUIThemeController {
   current(): "light" | "dark";
   set(theme: string, options?: { skipStorage?: boolean }): "light" | "dark";
   toggle(): "light" | "dark";
@@ -39,7 +41,7 @@ export interface BaseUIThemeController {
   init(): "light" | "dark";
 }
 
-export interface BaseUIThemeOptions {
+export interface NodexUIThemeOptions {
   storageKey?: string;
   queryKey?: string;
   toggleSelector?: string;
@@ -47,8 +49,8 @@ export interface BaseUIThemeOptions {
   root?: Element;
 }
 
-export const BaseUI: BaseUIApi;
-export const BaseUITheme: BaseUIThemeController;
-export function createThemeController(options?: BaseUIThemeOptions): BaseUIThemeController;
+export const NodexUI: NodexUIApi;
+export const NodexUITheme: NodexUIThemeController;
+export function createThemeController(options?: NodexUIThemeOptions): NodexUIThemeController;
 export function normalizeTheme(value: unknown): "light" | "dark";
-export default BaseUI;
+export default NodexUI;

package/dist/types/vite.d.ts

@@ -1,4 +1,4 @@
-import type { BaseUIManifestConfig } from "./pwa";
+import type { NodexUIManifestConfig } from "./pwa";
 
 /** Vite plugin: every `vite build` also emits manifest, sw.js, sw-register.js, version.json and icons. */
-export function baseuiPwa(options?: Partial<BaseUIManifestConfig> & { cdnVersion?: string }): import("vite").Plugin;
+export function nodexuiPwa(options?: Partial<NodexUIManifestConfig> & { cdnVersion?: string }): import("vite").Plugin;

package/docs/analytics.md

@@ -1,30 +1,30 @@
 # Analytics
 
-The Base UI ships a cookieless web-analytics service, ported from [`@plausible-analytics/tracker`](https://www.npmjs.com/package/@plausible-analytics/tracker) 0.4.6 (MIT; notice in `LICENSE`). Nothing is collected until the page calls `init({ backendUrl })`. Available from `@thebase/ui` 1.1.0.
+Nodex UI ships a cookieless web-analytics service, ported from [`@plausible-analytics/tracker`](https://www.npmjs.com/package/@plausible-analytics/tracker) 0.4.6 (MIT; notice in `LICENSE`). Nothing is collected until the page calls `init({ backendUrl })`. Available from `nodexui` 1.1.0.
 
-It is an optional, standalone feature: it is **not** part of `dist/baseui.min.js`/`dist/baseui.esm.js`, and it needs neither of them (no Owl, Bootstrap or component runtime). Load it on its own, with or without the rest of the Base UI (~5.6 KB minified):
+It is an optional, standalone feature: it is **not** part of `dist/nodexui.min.js`/`dist/nodexui.esm.js`, and it needs neither of them (no framework or component runtime). Load it on its own, with or without the rest of Nodex UI (~5.6 KB minified):
 
 ```js
 // npm / bundler
-import { init, track } from "@thebase/ui/analytics";
+import { init, track } from "nodexui/analytics";
 init({ backendUrl: "https://stats.example.com" });
 ```
 
 ```html
-<!-- ES module from the CDN (or map it as "@base/analytics" in an import map) -->
+<!-- ES module from the CDN (or map it as "nodexui/analytics" in an import map) -->
 <script type="module">
-  import { init } from "https://cdn.jsdelivr.net/npm/@thebase/ui@1.2.0/dist/baseui.analytics.esm.js";
+  import { init } from "https://cdn.jsdelivr.net/npm/nodexui@1.3.0/dist/nodexui.analytics.esm.js";
   init({ backendUrl: "https://stats.example.com" });
 </script>
 
-<!-- Classic script tag: sets window.thebase.analytics (load order vs dist/baseui.min.js doesn't matter) -->
-<script src="https://cdn.jsdelivr.net/npm/@thebase/ui@1.2.0/dist/baseui.analytics.min.js"></script>
+<!-- Classic script tag: sets window.thebase.analytics (load order vs dist/nodexui.min.js doesn't matter) -->
+<script src="https://cdn.jsdelivr.net/npm/nodexui@1.3.0/dist/nodexui.analytics.min.js"></script>
 <script>
   thebase.analytics.init({ backendUrl: "https://stats.example.com" });
 </script>
 ```
 
-Types ship as `dist/types/analytics.d.ts` (resolved automatically for `@thebase/ui/analytics`).
+Types ship as `dist/types/analytics.d.ts` (resolved automatically for `nodexui/analytics`).
 
 `init()` can be called once. It sends the first pageview, then follows `history.pushState`/`popstate` navigations (or `hashchange` with `hashBasedRouting: true`).
 
@@ -73,7 +73,7 @@ Or tag markup with classes — no JavaScript needed:
 `visitorContext()` returns coarse facts about the visitor's setup. Pass it as `customProperties` to attach them to every event (available from 1.1.1):
 
 ```js
-import { init, visitorContext } from "@thebase/ui/analytics";
+import { init, visitorContext } from "nodexui/analytics";
 init({ backendUrl: "https://stats.example.com", customProperties: visitorContext });
 // every event's props now include { tz: "Asia/Ho_Chi_Minh", lang: "vi-VN", screen: "Mobile" }
 ```
@@ -135,7 +135,7 @@ import (
 	"github.com/gofiber/fiber/v3/middleware/cors"
 )
 
-// Event is the compact payload POSTed by @thebase/ui/analytics.
+// Event is the compact payload POSTed by nodexui/analytics.
 type Event struct {
 	Name        string         `json:"n"`
 	URL         string         `json:"u"`
@@ -185,7 +185,7 @@ app.add_middleware(CORSMiddleware, allow_origins=["https://www.example.com"], al
 
 
 class Event(BaseModel):
-    """Compact payload POSTed by @thebase/ui/analytics."""
+    """Compact payload POSTed by nodexui/analytics."""
 
     name: str = Field(alias="n", min_length=1)
     url: str = Field(alias="u", min_length=1)
@@ -228,7 +228,7 @@ curl -i -X POST http://localhost:8080/api/event -H 'Content-Type: text/plain' \
 
 [`examples/analytics/`](../examples/analytics/dashboard/?backend=http://localhost:8080) contains a working dashboard plus two complete sample backends: [`server-go`](../examples/analytics/server-go/main.go) (Fiber v3) and [`server-fastapi`](../examples/analytics/server-fastapi/main.py). Each one extends the receivers above with an in-memory store, a daily-salted cookieless visitor hash, a `GET /api/stats` endpoint, and static hosting for the dashboard.
 
-The dashboard ([`dashboard/`](../examples/analytics/dashboard/?backend=http://localhost:8080)) is a pure application that loads `@thebase/ui@1.2.0` from jsDelivr: KPI `Card`s, an area `Chart`, top pages/sources/events `Table`s, site and period `NativeSelect`s, and a `ThemeButton`. It refreshes every 30 s and tracks its own visits through `@thebase/ui/analytics`, so a fresh backend has data straight away.
+The dashboard ([`dashboard/`](../examples/analytics/dashboard/?backend=http://localhost:8080)) is a pure application that loads `nodexui@1.3.0` from jsDelivr: KPI `Card`s, an area `Chart`, top pages/sources/events `Table`s, site and period `NativeSelect`s, and a `ThemeButton`. It refreshes every 30 s and tracks its own visits through `nodexui/analytics`, so a fresh backend has data straight away.
 
 ```sh
 # Go (1.25+)

package/docs/base-ui-skill.md

@@ -1,6 +1,6 @@
 # Skill for AI
 
-The Base UI skill teaches an AI coding agent how to build apps and components with BaseUI: scaffolding a PWA, emitting real components and icons, and packaging as Electron or Capacitor apps. It bundles verified syntax references, so the agent uses real BaseUI props and markup instead of guessing.
+Nodex UI skill teaches an AI coding agent how to build apps and components with NodexUI: scaffolding a PWA, emitting real components and icons, and packaging as Electron or Capacitor apps. It bundles verified syntax references, so the agent uses real NodexUI props and markup instead of guessing.
 
 It is a plain folder of Markdown and scripts, so it is not tied to one tool. It works with Claude Code, OpenAI Codex, Gemini CLI, and any other agent that can read instruction files.
 
@@ -32,7 +32,7 @@ Replace `~/.claude/skills` with the folder for your agent, then restart it. Skil
 For an agent without a skills folder (Cursor, Copilot, Windsurf, and others), extract the archive anywhere in your project and point the agent at it from its instruction file, such as `AGENTS.md`, `GEMINI.md` or `.cursor/rules`:
 
 ```md
-For any BaseUI work, read and follow `base-ui/SKILL.md` first.
+For any NodexUI work, read and follow `base-ui/SKILL.md` first.
 ```
 
 ## Use
@@ -41,8 +41,8 @@ Ask in plain language. The skill triggers on these phrases:
 
 | Say | Result |
 | --- | --- |
-| `create app` | Scaffolds a new BaseUI PWA |
-| `use <component>` / `make <component>` | Emits a real BaseUI component |
+| `create app` | Scaffolds a new NodexUI PWA |
+| `use <component>` / `make <component>` | Emits a real NodexUI component |
 | `use <icon>` / `make <icon>` | Emits a real Lucide icon |
 | `create electron app` | PWA scaffold plus an Electron shell |
 | `create capacitor app` | PWA scaffold plus a Capacitor shell |

package/docs/blocks.md

@@ -1,19 +1,19 @@
 # Blocks
 
-The Base UI blocks are static HTML compositions styled by the same shadcn-aligned tokens as the component library. They are based on the public shadcn/ui blocks page and keep the same sizing landmarks: `min-height: 100svh`, sidebar widths, header heights, `gap-4`/`gap-6`, muted backgrounds, and auth-card widths.
+Nodex UI blocks are static HTML compositions styled by the same shadcn-aligned tokens as the component library. They are based on the public shadcn/ui blocks page and keep the same sizing landmarks: `min-height: 100svh`, sidebar widths, header heights, `gap-4`/`gap-6`, muted backgrounds, and auth-card widths.
 
 Each block has its own source stylesheet in `examples/blocks/<block-name>.css`. Shared helpers live in `examples/blocks/shared.css`; new blocks should not be folded into an all-in-one block stylesheet.
 
-Block navigation icons must use the Base UI's built-in Lucide icon component, for example `<span b-icon="layout-dashboard" b-block-icon></span>`. Do not use placeholder letters inside `b-block-icon`.
+Block navigation icons must use Nodex UI's built-in Lucide icon component, for example `<span b-icon="layout-dashboard" b-block-icon></span>`. Do not use placeholder letters inside `b-block-icon`.
 
-Blocks are not standalone runtime components. Paste the markup and load the normal the Base UI assets:
+Blocks are not standalone runtime components. Paste the markup and load the normal Nodex UI assets:
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@thebase/ui@latest/dist/baseui.min.css">
-<script src="https://cdn.jsdelivr.net/npm/@thebase/ui@latest/dist/baseui.min.js" defer></script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/nodexui@latest/dist/nodexui.min.css">
+<script src="https://cdn.jsdelivr.net/npm/nodexui@latest/dist/nodexui.min.js" defer></script>
 ```
 
-`https://unpkg.com/@thebase/ui@latest/dist/...` mirrors the same files as an alternative CDN if jsDelivr is unreachable. Pin an exact version (e.g. `@1.2.0`, or `@1` to take only non-breaking updates) instead of `@latest` for production. Blocks are static markup, so they only need the static `b-ui` runtime above — see [Usage Guide](usage-guide.md) if the surrounding page is itself an application and you'd rather compose the equivalent layout from [Base Components](owl-components.md).
+`https://unpkg.com/nodexui@latest/dist/...` mirrors the same files as an alternative CDN if jsDelivr is unreachable. Pin an exact version (e.g. `@1.3.0`, or `@1` to take only non-breaking updates) instead of `@latest` for production. Blocks are static markup, so they only need the static `b-ui` runtime above — see [Usage Guide](usage-guide.md) if the surrounding page is itself an application and you'd rather compose the equivalent layout from [Nodex UI Component](owl-components.md).
 
 Use `b-block` to select the block style:
 

package/docs/components/accordion.md

@@ -5,7 +5,7 @@ Use `b-ui="accordion"` for grouped disclosure panels.
 ## Base component
 
 ```js
-import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@thebase/ui";
+import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "nodexui";
 ```
 
 ```base-ui
@@ -37,7 +37,7 @@ import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@t
 | `AccordionItem` | `className` | `String` | optional |
 | `AccordionTrigger` | `className` | `String` | optional |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 
@@ -67,6 +67,6 @@ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how
 </div>
 ```
 
-Options: `b-att-multiple="true"` allows more than one item to stay open. Events: `baseui:change`. Keyboard: buttons use native activation and focus behavior. The static adapter only wires ARIA/toggle behavior onto author-provided markup — add your own trailing chevron icon (`b-icon="chevron-down" class="b-accordion-trigger-icon"`) inside the trigger for the rotating-chevron look the pure Base `AccordionTrigger` renders automatically, and set `b-att-state="open"` on an item to have it expanded by default.
+Options: `b-att-multiple="true"` allows more than one item to stay open. Events: `nodexui:change`. Keyboard: buttons use native activation and focus behavior. The static adapter only wires ARIA/toggle behavior onto author-provided markup — add your own trailing chevron icon (`b-icon="chevron-down" class="b-accordion-trigger-icon"`) inside the trigger for the rotating-chevron look the pure Base `AccordionTrigger` renders automatically, and set `b-att-state="open"` on an item to have it expanded by default.
 
-Each panel (`b-accordion-panel` / `AccordionContent`'s root) is driven by its own live `bootstrap.Collapse` instance: it always carries the Bootstrap `collapse` class (plus `show` while open), and Bootstrap itself manages the `collapsing`/height transition and the `show` class across toggles — don't rely on `hidden`/node removal to detect open state. In single-open mode (the default, without `multiple`), opening one item hides every other open item's own `bootstrap.Collapse` instance before showing the clicked item's.
+Each panel (`b-accordion-panel` / `AccordionContent`'s root) is driven by its own live `bootstrap.Collapse` instance: it always carries the built-in `collapse` class (plus `show` while open), and the library itself manages the `collapsing`/height transition and the `show` class across toggles — don't rely on `hidden`/node removal to detect open state. In single-open mode (the default, without `multiple`), opening one item hides every other open item's own `bootstrap.Collapse` instance before showing the clicked item's.

package/docs/components/alert-dialog.md

@@ -3,7 +3,7 @@
 ## Base component
 
 ```js
-import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogMedia, AlertDialogTitle, AlertDialogTrigger, Icon } from "@thebase/ui";
+import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogMedia, AlertDialogTitle, AlertDialogTrigger, Icon } from "nodexui";
 ```
 
 ```base-ui
@@ -41,7 +41,7 @@ import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent,
 | `AlertDialogTitle` | `className` | `String` | optional |
 | `AlertDialogTrigger` | `className` | `String` | optional |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 

package/docs/components/alert.md

@@ -3,7 +3,7 @@
 ## Base component
 
 ```js
-import { Alert, AlertAction, AlertDescription, AlertTitle, Button, Icon } from "@thebase/ui";
+import { Alert, AlertAction, AlertDescription, AlertTitle, Button, Icon } from "nodexui";
 ```
 
 ```base-ui
@@ -24,13 +24,13 @@ import { Alert, AlertAction, AlertDescription, AlertTitle, Button, Icon } from "
 | Component | Prop | Type | Notes |
 | --- | --- | --- | --- |
 | `Alert` | `variant` | `String` | optional |
-| `Alert` | `dismissible` | `Boolean` | optional; renders a Bootstrap close button that fades and removes the alert |
+| `Alert` | `dismissible` | `Boolean` | optional; renders a built-in close button that fades and removes the alert |
 | `Alert` | `className` | `String` | optional |
 | `AlertTitle` | `className` | `String` | optional |
 | `AlertDescription` | `className` | `String` | optional |
 | `AlertAction` | `className` | `String` | optional |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 
@@ -41,6 +41,6 @@ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how
 
 Options: `b-att-variant="default|destructive"`, `b-att-dismissible="true"`. Legacy aliases `info|success|warning|danger` are still supported for existing markup.
 
-Alerts receive Bootstrap alert classes and a default `role="alert"`. Alerts lay out as a grid — putting an icon (`b-ui="icon"`/`<Icon>`) as the first child shifts the title/description into a second column automatically.
+Alerts receive built-in alert classes and a default `role="alert"`. Alerts lay out as a grid — putting an icon (`b-ui="icon"`/`<Icon>`) as the first child shifts the title/description into a second column automatically.
 
-Setting `b-att-dismissible` appends a Bootstrap close button (`<button class="btn-close" data-bs-dismiss="alert">`) if one isn't already present and instantiates `bootstrap.Alert` so clicking it fades out and removes the alert from the DOM.
+Setting `b-att-dismissible` appends a built-in close button (`<button class="btn-close" data-bs-dismiss="alert">`) if one isn't already present and instantiates `bootstrap.Alert` so clicking it fades out and removes the alert from the DOM.

package/docs/components/apidoc.md

@@ -9,7 +9,7 @@ Markdown in `info.description`, tag and operation descriptions is rendered with
 ## Base component
 
 ```js
-import { ApiDoc } from "@base/component";
+import { ApiDoc } from "nodexui";
 ```
 
 ```html
@@ -22,18 +22,18 @@ Pass an already-parsed document with `spec` instead of `src`:
 <ApiDoc spec="state.spec" serverUrl="'https://api.example.com'" tryIt="false"/>
 ```
 
-## Standalone (`@thebase/ui/apidoc`)
+## Standalone (`nodexui/apidoc`)
 
-Like the analytics service, ApiDoc also ships as its own bundle that needs neither the full the Base UI script nor a templates file (Owl and ApiDoc's templates are embedded). Load `baseui.min.css` for styling.
+Like the analytics service, ApiDoc also ships as its own bundle that needs neither the full Nodex UI script nor a templates file (Nodex and ApiDoc's templates are embedded). Load `nodexui.min.css` for styling.
 
 ```js
-import { mountApiDoc } from "@thebase/ui/apidoc";
+import { mountApiDoc } from "nodexui/apidoc";
 
-const app = await mountApiDoc("#docs", { src: "/openapi.json", hash: true, assetBase: "/node_modules/@thebase/ui/dist/apidoc" });
+const app = await mountApiDoc("#docs", { src: "/openapi.json", hash: true, assetBase: "/node_modules/nodexui/dist/apidoc" });
 // app.destroy() removes it
 ```
 
-`mountApiDoc(target, props)` takes an element or selector plus the props below. Without a bundler, import `dist/baseui.apidoc.esm.js` from a CDN, or load `dist/baseui.apidoc.min.js`, which sets `window.thebase.apidoc.mountApiDoc`.
+`mountApiDoc(target, props)` takes an element or selector plus the props below. Without a bundler, import `dist/nodexui.apidoc.esm.js` from a CDN, or load `dist/nodexui.apidoc.min.js`, which sets `window.thebase.apidoc.mountApiDoc`.
 
 ## Static component
 
@@ -41,11 +41,11 @@ const app = await mountApiDoc("#docs", { src: "/openapi.json", hash: true, asset
 <div b-ui="apidoc" b-att-src="/openapi.json" b-att-height="100vh" b-att-hash="true"></div>
 ```
 
-The static adapter fetches `baseui.templates.xml` from the folder the Base UI script was loaded from; set `b-att-templates` to override.
+The static adapter fetches `nodexui.templates.xml` from the folder Nodex UI script was loaded from; set `b-att-templates` to override.
 
 ## Props / attributes
 
-| Owl prop | Static attribute | Default | Meaning |
+| Nodex prop | Static attribute | Default | Meaning |
 | --- | --- | --- | --- |
 | `src` | `b-att-src` | — | URL of the OpenAPI JSON file. |
 | `spec` | — | — | Parsed OpenAPI object (alternative to `src`). |
@@ -59,21 +59,21 @@ The static adapter fetches `baseui.templates.xml` from the folder the Base UI sc
 | `authorize` | `b-att-authorize` | `true` | Show the Authorize button when the spec defines security schemes. |
 | `languages` | `b-att-languages` | all 17 | Which code-sample languages to offer, e.g. `['curl', 'node', 'python']` / `curl,node,python`. |
 | `language` | `b-att-language` | `curl` | Language selected first. |
-| `assetBase` | `b-att-asset-base` | `dist/apidoc` beside the Base UI script | Folder that holds `img/*.svg` language logos. Empty string hides the logos. |
+| `assetBase` | `b-att-asset-base` | `dist/apidoc` beside Nodex UI script | Folder that holds `img/*.svg` language logos. Empty string hides the logos. |
 | `oauthRedirectUri` | `b-att-oauth-redirect-uri` | `oauth2-redirect.html` next to the page | Popup landing page for the implicit / authorization-code flows (see `src/components/apidoc/oauth2-redirect.html`). |
 | `height` | `b-att-height` | `100vh` | CSS height of the component. |
 | `className`, `style` | — | — | Standard root class / inline style. |
 
 ## Events
 
-| Owl callback | Static event | Detail |
+| Nodex callback | Static event | Detail |
 | --- | --- | --- |
-| `onLoad(doc)` | `baseui:load` | `{ info, operations }` once the spec is parsed. |
-| `onError(error)` | `baseui:error` | `{ error }` when the spec cannot be fetched or is not OpenAPI. |
-| `onNavigate(id)` | `baseui:navigate` | `{ id }` — `introduction` or an operation id. |
+| `onLoad(doc)` | `nodexui:load` | `{ info, operations }` once the spec is parsed. |
+| `onError(error)` | `nodexui:error` | `{ error }` when the spec cannot be fetched or is not OpenAPI. |
+| `onNavigate(id)` | `nodexui:navigate` | `{ id }` — `introduction` or an operation id. |
 
 ## Notes
 
 - Credentials entered in Authorize live in the tab's `sessionStorage` (`apikey`, `oauthkey`) and are applied to every Try It request. Try It sends the request from the browser, so the API must allow CORS from the docs origin.
-- Language logos are copied to `dist/apidoc/img/` by `npm run build`; the CDN URL pattern is `https://cdn.jsdelivr.net/npm/@thebase/ui@<version>/dist/apidoc/img/`.
+- Language logos are copied to `dist/apidoc/img/` by `npm run build`; the CDN URL pattern is `https://cdn.jsdelivr.net/npm/nodexui@<version>/dist/apidoc/img/`.
 - Styles are scoped under `.b-apidoc` and use their own palette (`--line`, `--accent`, … on `.b-apidoc`); override them on a wrapper selector to re-theme.

package/docs/components/aspect-ratio.md

@@ -3,7 +3,7 @@
 ## Base component
 
 ```js
-import { AspectRatio } from "@thebase/ui";
+import { AspectRatio } from "nodexui";
 ```
 
 ```base-ui
@@ -21,7 +21,7 @@ import { AspectRatio } from "@thebase/ui";
 | `AspectRatio` | `height` | `Number` | optional |
 | `AspectRatio` | `className` | `String` | optional |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 

package/docs/components/attachment.md

@@ -4,7 +4,7 @@ Use `b-ui="attachment"` for a CDN-ready attachment card with media, metadata, up
 
 ## CDN install requirements
 
-Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
+Load the pinned Nodex UI CSS and JavaScript files; no extra dependency is required for this component.
 
 ## Base component
 
@@ -20,7 +20,7 @@ import {
   AttachmentMedia,
   AttachmentTitle,
   AttachmentTrigger,
-} from "@thebase/ui";
+} from "nodexui";
 ```
 
 ```base-ui
@@ -121,7 +121,7 @@ import {
 | `AttachmentDropzone` | `disabled` | `Boolean` | disables click/drag/drop |
 | `AttachmentDropzone` | `onFilesSelected` | `Function` | receives the picked/dropped `File[]` |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 
@@ -216,7 +216,7 @@ Use `b-ui="attachment-dropzone"` for a drag-and-drop upload target with a hidden
 | `multiple` | on the inner `input[type=file]`; allows multi-file selection. |
 | `disabled` | on the inner `input[type=file]`; visually and functionally disables the zone. |
 
-The dropzone emits `baseui:change` with `{ files }` on drop, on file-input change, or on click-to-browse selection.
+The dropzone emits `nodexui:change` with `{ files }` on drop, on file-input change, or on click-to-browse selection.
 
 ## Options and attributes
 
@@ -231,7 +231,7 @@ The dropzone emits `baseui:change` with `{ files }` on drop, on file-input chang
 
 ## Events
 
-The file picker fallback emits `baseui:change` with `{ files }` from the root element.
+The file picker fallback emits `nodexui:change` with `{ files }` from the root element.
 
 ## Accessibility behavior
 

package/docs/components/avatar.md

@@ -4,12 +4,12 @@ Use `b-ui="avatar"` for a CDN-ready avatar component.
 
 ## CDN install requirements
 
-Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
+Load the pinned Nodex UI CSS and JavaScript files; no extra dependency is required for this component.
 
 ## Base component
 
 ```js
-import { Avatar } from "@thebase/ui";
+import { Avatar } from "nodexui";
 ```
 
 ```base-ui
@@ -27,7 +27,7 @@ import { Avatar } from "@thebase/ui";
 | `Avatar` | `title` | `String` | optional, native hover tooltip |
 | `Avatar` | `className` | `String` | optional |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 
@@ -41,7 +41,7 @@ Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script l
 
 ## Options and attributes
 
-See `dist/baseui.registry.json` for the supported attribute list.
+See `dist/nodexui.registry.json` for the supported attribute list.
 
 ## Methods
 
@@ -49,11 +49,11 @@ Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `th
 
 ## Events
 
-Interactive components emit documented `baseui:*` events from their root element. Static components do not emit events.
+Interactive components emit documented `nodexui:*` events from their root element. Static components do not emit events.
 
 ## CSS variables
 
-The component inherits the Base UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
+The component inherits Nodex UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
 
 ## Accessibility behavior
 
@@ -65,7 +65,7 @@ See `examples/index.html` for a working CDN-style page.
 
 ## Browser support
 
-The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
+Nodex UI targets modern evergreen browsers that support ES modules, CSS variables.
 
 ## Test checklist
 

package/docs/components/badge.md

@@ -5,7 +5,7 @@ Small status label for counts, states, and metadata.
 ## Base component
 
 ```js
-import { Badge } from "@thebase/ui";
+import { Badge } from "nodexui";
 ```
 
 ```base-ui
@@ -24,7 +24,7 @@ import { Badge } from "@thebase/ui";
 | `label` | `String` | alternative to default-slot children |
 | `className` | `String` | appended to the generated `badge ...` classes |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 

package/docs/components/block-viewer.md

@@ -1,21 +1,21 @@
 # Block Viewer
 
-`BlockViewer` is the page-root component used by the Base UI block gallery detail pages (`examples/blocks/*.html`). It reads a title/description from `document.body.dataset`, renders a sample block's markup from a `[b-block-code-template]` script tag into a live preview panel, and offers a preview/code toggle with desktop/tablet/mobile viewport switching and a "copy code" action.
+`BlockViewer` is the page-root component used by Nodex UI block gallery detail pages (`examples/blocks/*.html`). It reads a title/description from `document.body.dataset`, renders a sample block's markup from a `[b-block-code-template]` script tag into a live preview panel, and offers a preview/code toggle with desktop/tablet/mobile viewport switching and a "copy code" action.
 
 ## CDN install requirements
 
-Load the pinned the Base UI CSS and JavaScript files, plus the block-viewer adapter bundle (it is not part of `baseui.min.js`, since it pulls in the full component export surface only when a block sample needs it — but it's self-contained, no import map required):
+Load the pinned Nodex UI CSS and JavaScript files, plus the block-viewer adapter bundle (it is not part of `nodexui.min.js`, since it pulls in the full component export surface only when a block sample needs it — but it's self-contained, no import map required):
 
 ```html
-<link rel="stylesheet" href="/dist/baseui.min.css">
-<script type="module" src="/dist/baseui.block-viewer.esm.js"></script>
-<script src="/dist/baseui.min.js" defer></script>
+<link rel="stylesheet" href="/dist/nodexui.min.css">
+<script type="module" src="/dist/nodexui.block-viewer.esm.js"></script>
+<script src="/dist/nodexui.min.js" defer></script>
 ```
 
 ## Base component
 
 ```js
-import { BlockViewer } from "@base/component";
+import { BlockViewer } from "nodexui";
 ```
 
 ```base-ui
@@ -42,10 +42,10 @@ import { BlockViewer } from "@base/component";
 ## Options and attributes
 
 - `data-block-title` / `data-block-description` (on `<body>`) — the header title/description shown above the preview.
-- `[b-block-code-template]` — a `<script type="text/xml">` (Owl-mounted preview, source-of-truth for both the live preview and the "Code" panel) or a `<template>` (static markup, cloned directly into the preview frame).
+- `[b-block-code-template]` — a `<script type="text/xml">` (runtime-mounted preview, source-of-truth for both the live preview and the "Code" panel) or a `<template>` (static markup, cloned directly into the preview frame).
 - `?embed=1` query param — renders only the preview frame full-bleed, without the page chrome, for use inside an `<iframe>`.
 
-See `dist/baseui.registry.json` for the full attribute list.
+See `dist/nodexui.registry.json` for the full attribute list.
 
 ## Methods
 

package/docs/components/breadcrumb.md

@@ -13,7 +13,7 @@ import {
   BreadcrumbList,
   BreadcrumbPage,
   BreadcrumbSeparator,
-} from "@thebase/ui";
+} from "nodexui";
 ```
 
 ```base-ui
@@ -48,7 +48,7 @@ import {
 | `BreadcrumbSeparator` | `className` | `String` | optional; custom children override the chevron |
 | `BreadcrumbEllipsis` | `className` | `String` | optional |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 
@@ -63,7 +63,7 @@ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how
 </nav>
 ```
 
-The Base UI adds the shadcn/Nova breadcrumb classes, inserts chevron separators when none are authored, styles links and the current page, and marks the current page with `aria-current="page"`.
+Nodex UI adds the shadcn/Nova breadcrumb classes, inserts chevron separators when none are authored, styles links and the current page, and marks the current page with `aria-current="page"`.
 
 ## Dropdown
 

package/docs/components/bubble.md

@@ -3,7 +3,7 @@
 ## Base component
 
 ```js
-import { Bubble } from "@thebase/ui";
+import { Bubble } from "nodexui";
 ```
 
 ```base-ui
@@ -39,7 +39,7 @@ import { Bubble } from "@thebase/ui";
 | --- | --- | --- | --- |
 | `Bubble` | `className` | `String` | optional |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 

package/docs/components/button-group.md

@@ -5,7 +5,7 @@ Groups related buttons while preserving native button semantics.
 ## Base component
 
 ```js
-import { ButtonGroup, ButtonGroupSeparator, ButtonGroupText } from "@thebase/ui";
+import { ButtonGroup, ButtonGroupSeparator, ButtonGroupText } from "nodexui";
 ```
 
 ```base-ui
@@ -88,7 +88,7 @@ import { ButtonGroup, ButtonGroupSeparator, ButtonGroupText } from "@thebase/ui"
 | `ButtonGroupSeparator` | `className` | `String` | optional |
 | `ButtonGroupText` | `className` | `String` | optional |
 
-See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component
 

package/docs/components/button.md

@@ -5,7 +5,7 @@ Use `b-ui="button"` on a native button or link.
 ## Base component
 
 ```js
-import { Button } from "@thebase/ui";
+import { Button } from "nodexui";
 ```
 
 ```base-ui
@@ -55,7 +55,7 @@ import { Button } from "@thebase/ui";
 | `getRef` | `Function` | called with the rendered root element after mount, and with `null` on unmount |
 | `onClick` | `Function` | called with the native click event |
 
-Also accepts default slot content instead of `label`. Every pure Base the Base UI component that renders a clickable control (dialog close, tab triggers, toast action, select trigger, ...) renders it through `Button`, usually with `unstyled`, so those controls share one click/disabled/`href` implementation. See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+Also accepts default slot content instead of `label`. Every pure Base Nodex UI component that renders a clickable control (dialog close, tab triggers, toast action, select trigger, ...) renders it through `Button`, usually with `unstyled`, so those controls share one click/disabled/`href` implementation. See [Nodex UI Component](/examples/blocks.html#/docs/guide/owl-components) for how to load `nodexui` and `dist/nodexui.templates.xml`.
 
 ## Static component