@thebase/ui 1.1.2 → 1.1.4

package/dist/types/apidoc.d.ts

@@ -0,0 +1,27 @@
+/** Standalone ApiDoc: renders an OpenAPI 3.x document. Load dist/baseui.min.css for styling. */
+export interface ApiDocProps {
+  src?: string;
+  spec?: object;
+  title?: string;
+  serverUrl?: string;
+  theme?: "light" | "dark" | "auto";
+  themeToggle?: boolean;
+  hash?: boolean;
+  operation?: string;
+  tryIt?: boolean;
+  authorize?: boolean;
+  languages?: string[];
+  language?: string;
+  assetBase?: string;
+  oauthRedirectUri?: string;
+  height?: string;
+  className?: string;
+  style?: string | Record<string, string>;
+  onLoad?(doc: unknown): void;
+  onError?(error: unknown): void;
+  onNavigate?(id: string): void;
+}
+export interface ApiDocApp { destroy(): void }
+export const ApiDoc: unknown;
+/** Mounts ApiDoc into an element (or selector) and returns the application. */
+export function mountApiDoc(target: Element | string, props?: ApiDocProps): Promise<ApiDocApp> | ApiDocApp;

package/dist/types/pwa.d.ts

@@ -18,7 +18,9 @@ export interface BaseUIManifestConfig {
   themeColor?: string;
   /** Defaults to "en". */
   lang?: string;
-  /** Defaults to a 192/512 `/icons/icon-*.png` set. */
+  /** Folder URL holding the default logo files. Defaults to "/icons/". */
+  iconsBase?: string;
+  /** Defaults to the shipped logo: `icon-192.png` and `icon-512.png` under `iconsBase`. */
   icons?: Array<{ src: string; sizes: string; type: string; purpose?: string }>;
 }
 
@@ -27,11 +29,17 @@ export interface BaseUIServiceWorkerConfig {
   cacheName: string;
   /** Pinned `@thebase/ui` version the generated sw.js precaches/serves from jsdelivr. */
   cdnVersion: string;
+  /** Where the manifest is served from. Defaults to "/manifest.webmanifest". */
+  manifestUrl?: string;
+  /** Folder URL holding the default logo/favicon files to precache. Defaults to "/icons/". */
+  iconsBase?: string;
   /** Same-origin app-shell paths to precache (JS/CSS/XML/icons/etc). */
   appFiles?: string[];
   /** Extra same-origin or cross-origin URLs to precache alongside `appFiles`. */
   extraPrecacheUrls?: string[];
 }
 
+/** Default logo/favicon file names (in `dist/pwa-icons/`), precached from `/icons/` by default. */
+export const DEFAULT_ICON_FILES: string[];
 export function buildManifest(config: BaseUIManifestConfig): Record<string, unknown>;
 export function buildServiceWorker(config: BaseUIServiceWorkerConfig): string;

package/docs/analytics.md

@@ -1,8 +1,8 @@
 # Analytics
 
-BaseUI 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.
+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.
 
-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 BaseUI (~5.6 KB minified):
+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):
 
 ```js
 // npm / bundler
@@ -13,12 +13,12 @@ init({ backendUrl: "https://stats.example.com" });
 ```html
 <!-- ES module from the CDN (or map it as "@base/analytics" in an import map) -->
 <script type="module">
-  import { init } from "https://cdn.jsdelivr.net/npm/@thebase/ui@1.1.1/dist/baseui.analytics.esm.js";
+  import { init } from "https://cdn.jsdelivr.net/npm/@thebase/ui@1.1.3/dist/baseui.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.1.1/dist/baseui.analytics.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@thebase/ui@1.1.3/dist/baseui.analytics.min.js"></script>
 <script>
   thebase.analytics.init({ backendUrl: "https://stats.example.com" });
 </script>
@@ -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 Owl app that loads `@thebase/ui@1.1.1` 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 `@thebase/ui@1.1.3` 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.
 
 ```sh
 # Go (1.25+)

package/docs/blocks.md

@@ -1,19 +1,19 @@
 # Blocks
 
-BaseUI 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.
+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.
 
 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 BaseUI'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 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`.
 
-Blocks are not standalone runtime components. Paste the markup and load the normal BaseUI assets:
+Blocks are not standalone runtime components. Paste the markup and load the normal the Base 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>
 ```
 
-`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.1.1`, 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 Owl app and you'd rather compose the equivalent layout from [Pure Owl Components](owl-components.md).
+`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.1.3`, 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).
 
 Use `b-block` to select the block style:
 
@@ -30,6 +30,7 @@ The docs/dev server serves the block gallery at `/blocks` through the shared `ex
 
 ## Included Blocks
 
+- `apidoc-01`: full-page API reference built from an OpenAPI 3 file with the pure Base `ApiDoc` component (sidebar, schemas, Try It, Authorize); see [ApiDoc](components/apidoc.md).
 - `chart-01`: copyable usage block showing how to compose `b-ui="chart"` with chart slots, SVG primitives, tokens, and footer copy.
 - `dashboard-01`: dashboard shell with inset sidebar, header, metric cards, chart surface, and table area.
 - `sidebar-01` through `sidebar-16`: static conversions of the current shadcn/ui sidebar block family, including documentation sidebars, collapsible groups, inset navigation, mail, workspace, file explorer, calendar, dialog, right TOC, dual-sidebar, and sticky-header variants.

package/docs/components/accordion.md

@@ -2,7 +2,7 @@
 
 Use `b-ui="accordion"` for grouped disclosure panels.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@thebase/ui";
@@ -37,7 +37,7 @@ import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@t
 | `AccordionItem` | `className` | `String` | optional |
 | `AccordionTrigger` | `className` | `String` | optional |
 
-See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 
@@ -67,6 +67,6 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 </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="bu-accordion-trigger-icon"`) inside the trigger for the rotating-chevron look the pure Owl `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: `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="bu-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.

package/docs/components/alert-dialog.md

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

package/docs/components/alert.md

@@ -1,6 +1,6 @@
 # Alert
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Alert, AlertAction, AlertDescription, AlertTitle, Button, Icon } from "@thebase/ui";
@@ -30,7 +30,7 @@ import { Alert, AlertAction, AlertDescription, AlertTitle, Button, Icon } from "
 | `AlertDescription` | `className` | `String` | optional |
 | `AlertAction` | `className` | `String` | optional |
 
-See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 

package/docs/components/apidoc.md

@@ -0,0 +1,79 @@
+# ApiDoc
+
+Use `b-ui="apidoc"` (or the pure Base `ApiDoc` component) to render an **OpenAPI 3.0+ JSON** document as browsable API documentation: a grouped sidebar, per-operation parameters / request body / responses / callbacks, a **Try It** panel with request code samples in 17 languages, and an **Authorize** dialog (API key, HTTP basic, bearer, OpenID Connect token, OAuth2 implicit / authorization-code / password / client-credentials).
+
+Swagger 2.0 documents still render, but OpenAPI 3.x is the supported input: `requestBody`, `components.securitySchemes` (`http`, `apiKey`, `oauth2` `flows`, `openIdConnect`, `mutualTLS`), `servers` with variables, `webhooks`, `callbacks`, `links`, tag `parent`/`kind`, and `$ref` to components are all understood.
+
+Markdown in `info.description`, tag and operation descriptions is rendered with the [Markdown](markdown.md) component (fenced ` ```mermaid ` blocks become diagrams). The spec is trusted content — descriptions are rendered as Markdown/HTML, so do not point ApiDoc at a spec you do not control.
+
+## Base component
+
+```js
+import { ApiDoc } from "@base/component";
+```
+
+```html
+<ApiDoc src="'/openapi.json'" height="'100vh'" theme="'auto'" themeToggle="true" hash="true"/>
+```
+
+Pass an already-parsed document with `spec` instead of `src`:
+
+```html
+<ApiDoc spec="state.spec" serverUrl="'https://api.example.com'" tryIt="false"/>
+```
+
+## Standalone (`@thebase/ui/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.
+
+```js
+import { mountApiDoc } from "@thebase/ui/apidoc";
+
+const app = await mountApiDoc("#docs", { src: "/openapi.json", hash: true, assetBase: "/node_modules/@thebase/ui/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`.
+
+## Static component
+
+```html
+<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.
+
+## Props / attributes
+
+| Owl prop | Static attribute | Default | Meaning |
+| --- | --- | --- | --- |
+| `src` | `b-att-src` | — | URL of the OpenAPI JSON file. |
+| `spec` | — | — | Parsed OpenAPI object (alternative to `src`). |
+| `title` | `b-att-title` | `info.title` | Heading shown in the header and introduction. |
+| `serverUrl` | `b-att-server-url` | `servers` of the spec | Replaces the spec's servers (e.g. `location.origin`) so Try It targets one host. |
+| `theme` | `b-att-theme` | `auto` | `light`, `dark`, or `auto` (follows `data-bs-theme` on `<html>`, else the OS). |
+| `themeToggle` | `b-att-theme-toggle` | `false` | Shows a light/dark button in the header. |
+| `hash` | `b-att-hash` | `false` | Keep the open page in `location.hash` (`#/<operationId>`), so pages are linkable. Off by default so ApiDoc does not fight an app's own router. |
+| `operation` | `b-att-operation` | introduction | Operation id to open first (the lower-cased, dash-separated `operationId`). |
+| `tryIt` | `b-att-try-it` | `true` | Show the Try It panel (code samples + Send API Request). |
+| `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. |
+| `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 |
+| --- | --- | --- |
+| `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. |
+
+## 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/`.
+- Styles are scoped under `.bu-apidoc` and use their own palette (`--line`, `--accent`, … on `.bu-apidoc`); override them on a wrapper selector to re-theme.

package/docs/components/aspect-ratio.md

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

package/docs/components/attachment.md

@@ -4,9 +4,9 @@ Use `b-ui="attachment"` for a CDN-ready attachment card with media, metadata, up
 
 ## CDN install requirements
 
-Load the pinned BaseUI CSS and JavaScript files; no extra dependency is required for this component.
+Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
 
-## Pure Owl component
+## Base component
 
 ```js
 import {
@@ -121,7 +121,7 @@ import {
 | `AttachmentDropzone` | `disabled` | `Boolean` | disables click/drag/drop |
 | `AttachmentDropzone` | `onFilesSelected` | `Function` | receives the picked/dropped `File[]` |
 
-See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 

package/docs/components/avatar.md

@@ -4,9 +4,9 @@ Use `b-ui="avatar"` for a CDN-ready avatar component.
 
 ## CDN install requirements
 
-Load the pinned BaseUI CSS and JavaScript files; no extra dependency is required for this component.
+Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Avatar } from "@thebase/ui";
@@ -27,7 +27,7 @@ import { Avatar } from "@thebase/ui";
 | `Avatar` | `title` | `String` | optional, native hover tooltip |
 | `Avatar` | `className` | `String` | optional |
 
-See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 
@@ -53,7 +53,7 @@ Interactive components emit documented `baseui:*` events from their root element
 
 ## CSS variables
 
-The component inherits BaseUI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
+The component inherits the Base 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
 
-BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
+The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
 
 ## Test checklist
 

package/docs/components/badge.md

@@ -2,7 +2,7 @@
 
 Small status label for counts, states, and metadata.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Badge } from "@thebase/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 [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 

package/docs/components/block-viewer.md

@@ -1,10 +1,10 @@
 # Block Viewer
 
-`BlockViewer` is the page-root component used by the BaseUI 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 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.
 
 ## CDN install requirements
 
-Load the pinned BaseUI 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 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):
 
 ```html
 <link rel="stylesheet" href="/dist/baseui.min.css">
@@ -12,7 +12,7 @@ Load the pinned BaseUI CSS and JavaScript files, plus the block-viewer adapter b
 <script src="/dist/baseui.min.js" defer></script>
 ```
 
-## Pure Owl component
+## Base component
 
 ```js
 import { BlockViewer } from "@base/component";
@@ -37,7 +37,7 @@ import { BlockViewer } from "@base/component";
 </body>
 ```
 
-`thebase.mountAll()` (called automatically on `DOMContentLoaded`) mounts the `b-ui="block-viewer"` element as a full Owl app, using the block's own inline template as its live preview and its serialized text as the "Code" panel.
+`thebase.mountAll()` (called automatically on `DOMContentLoaded`) mounts the `b-ui="block-viewer"` element as a full application, using the block's own inline template as its live preview and its serialized text as the "Code" panel.
 
 ## Options and attributes
 

package/docs/components/breadcrumb.md

@@ -2,7 +2,7 @@
 
 Displays the path to the current resource using a hierarchy of links.
 
-## Pure Owl component
+## Base component
 
 ```js
 import {
@@ -48,7 +48,7 @@ import {
 | `BreadcrumbSeparator` | `className` | `String` | optional; custom children override the chevron |
 | `BreadcrumbEllipsis` | `className` | `String` | optional |
 
-See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 
@@ -63,7 +63,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 </nav>
 ```
 
-BaseUI 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"`.
+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"`.
 
 ## Dropdown
 

package/docs/components/bubble.md

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

package/docs/components/button-group.md

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

package/docs/components/button.md

@@ -2,7 +2,7 @@
 
 Use `b-ui="button"` on a native button or link.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Button } from "@thebase/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 Owl BaseUI 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 [Pure Owl 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 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`.
 
 ## Static component
 

package/docs/components/calendar.md

@@ -4,9 +4,9 @@ Use `b-ui="calendar"` for a CDN-ready calendar component.
 
 ## CDN install requirements
 
-Load the pinned BaseUI CSS and JavaScript files; no extra dependency is required for this component.
+Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Calendar } from "@thebase/ui";
@@ -26,7 +26,7 @@ import { Calendar } from "@thebase/ui";
 | `Calendar` | `className` | `String` | optional |
 | `Calendar` | `onChange` | `Function` | optional |
 
-See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 
@@ -52,7 +52,7 @@ Interactive components emit documented `baseui:*` events from their root element
 
 ## CSS variables
 
-The component inherits BaseUI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
+The component inherits the Base UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
 
 ## Accessibility behavior
 
@@ -64,7 +64,7 @@ See `examples/index.html` for a working CDN-style page.
 
 ## Browser support
 
-BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
+The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
 
 ## Test checklist
 

package/docs/components/card.md

@@ -1,6 +1,6 @@
 # Card
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Card, CardBody, CardDescription, CardFooter, CardHeader, CardTitle } from "@thebase/ui";
@@ -32,7 +32,7 @@ import { Card, CardBody, CardDescription, CardFooter, CardHeader, CardTitle } fr
 </div>
 ```
 
-`Card`, `CardHeader`, `CardBody`, `CardFooter`, `CardTitle`, and `CardDescription` each accept `className` (`String`, optional) and render their default slot as-is. `Card` additionally accepts `tag` (`String`, optional, default `"div"`) to render a different semantic root element, e.g. `tag="'aside'"` for complementary content. See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+`Card`, `CardHeader`, `CardBody`, `CardFooter`, `CardTitle`, and `CardDescription` each accept `className` (`String`, optional) and render their default slot as-is. `Card` additionally accepts `tag` (`String`, optional, default `"div"`) to render a different semantic root element, e.g. `tag="'aside'"` for complementary content. See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 

package/docs/components/carousel.md

@@ -4,9 +4,9 @@ Use `b-ui="carousel"` for a CDN-ready carousel component.
 
 ## CDN install requirements
 
-Load the pinned BaseUI CSS and JavaScript files; no extra dependency is required for this component.
+Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Carousel, CarouselNext, CarouselPrevious, CarouselSlide } from "@thebase/ui";
@@ -67,7 +67,7 @@ import { Carousel, CarouselNext, CarouselPrevious, CarouselSlide } from "@thebas
 | `CarouselSlide` | `index` | `Number` | required |
 | `CarouselSlide` | `className` | `String` | optional |
 
-See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 The whole group shares a single live `bootstrap.Carousel` instance, owned by the root `Carousel`/`b-ui="carousel"` element: the root always carries classes `carousel slide` and wraps its slides in a `.carousel-inner` container, each `CarouselSlide`/`b-carousel-slide` renders permanently as a `.carousel-item` (exactly one carrying `.active` at a time) — don't rely on node removal to detect the active slide. `CarouselPrevious`/`CarouselNext` (and the static `[b-carousel-prev]`/`[b-carousel-next]` buttons) call `.prev()`/`.next()` on that shared instance directly; Bootstrap's `wrap: true` handles wrap-around at both ends and `interval: false` keeps autoplay off.
 
@@ -102,7 +102,7 @@ Interactive components emit documented `baseui:*` events from their root element
 
 ## CSS variables
 
-The component inherits BaseUI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
+The component inherits the Base UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
 
 ## Accessibility behavior
 
@@ -114,7 +114,7 @@ See `examples/index.html` for a working CDN-style page.
 
 ## Browser support
 
-BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
+The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
 
 ## Test checklist
 

package/docs/components/chart.md

@@ -4,9 +4,9 @@ Use `b-ui="chart"` for a CDN-ready chart component styled after the current shad
 
 ## CDN install requirements
 
-Load the pinned BaseUI CSS and JavaScript files. No extra dependency is required for static charts. If you provide a `canvas` and a global `window.Chart`, BaseUI will initialize Chart.js v3 from JSON config without bundling Chart.js into BaseUI.
+Load the pinned the Base UI CSS and JavaScript files. No extra dependency is required for static charts. If you provide a `canvas` and a global `window.Chart`, the Base UI will initialize Chart.js v3 from JSON config without bundling Chart.js into the Base UI.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Chart } from "@thebase/ui";
@@ -50,7 +50,7 @@ import { Chart } from "@thebase/ui";
 | `Chart` | `variant` | `String` | optional |
 | `Chart` | `className` | `String` | optional |
 
-See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 
@@ -110,7 +110,7 @@ Interactive components emit documented `baseui:*` events from their root element
 
 ## CSS variables
 
-The component inherits BaseUI semantic tokens plus shadcn-compatible chart tokens: `--b-chart-1` through `--b-chart-5`. Area-card examples also use `--b-chart-height`, `--b-chart-grid`, `b-chart-area`, `b-chart-line`, `b-chart-axis`, `b-chart-footer`, `b-chart-trend`, and `b-chart-range`.
+The component inherits the Base UI semantic tokens plus shadcn-compatible chart tokens: `--b-chart-1` through `--b-chart-5`. Area-card examples also use `--b-chart-height`, `--b-chart-grid`, `b-chart-area`, `b-chart-line`, `b-chart-axis`, `b-chart-footer`, `b-chart-trend`, and `b-chart-range`.
 
 ## Accessibility behavior
 
@@ -122,7 +122,7 @@ See `examples/index.html` for a working CDN-style page.
 
 ## Browser support
 
-BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
+The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
 
 ## Test checklist