@thebase/ui 1.1.3 → 1.1.5

package/dist/baseui.registry.json

@@ -1697,13 +1697,13 @@
     }
   ],
   "integrity": {
-    "baseui.min.css": "sha384-RP2d04etuqh6nmVNHdJFYqK79B7N55jITUg52YrEXI3lyla5kJA4AHa2hUq79v0m",
+    "baseui.min.css": "sha384-MzYm4tnpt85MomNRXCdL9Rs4jDdw2qAPIoagZbC8/1kQLnPbHlW2tIf2F9OmRgPj",
     "bootstrap.bundle.min.js": "sha384-RMbllTJcplkCRnELNTOc5Kz/3AvFDE/rNlJqWqfgmRWruobClBdfwvl10akQZkR1",
-    "baseui.min.js": "sha384-3kwM3Q4HqvaVSHDfkmmIFzU9nr7VfuMAqeNpacnv8iWs2k8FAvCg3vW+j18Uoq4Y",
-    "baseui.esm.js": "sha384-Kg7yHA4YxH2uOdvcC4sWN5SrLfMLT09TGKzE6+WldH1rveQTfE3okF7YZPYX1TY0",
+    "baseui.min.js": "sha384-GcCWnFI6t+f/dc757+Crav6N80AmqwuB2K8kSTaeb08ErsYd9mTHA1aKB/rnQltB",
+    "baseui.esm.js": "sha384-UBVYm8E0mq0ZAVhefx5fmnAJVT31BD4cukBRhCyGIqxJ8AtoRNqg92NJ6uC233zU",
     "baseui.icons.esm.js": "sha384-hj39VMhzcFvmYnjob2hlioMOAqwAXCURGreF6s9RitXFp/iYi7rUdqtfCI+ICQeS",
-    "baseui.templates.xml": "sha384-A1BT9HyTN/3AyKq21IwbLUfMWcvMRoESKDoDOzOcEWEEapHVc/7rBBHygOUWpree",
-    "baseui.block-viewer.esm.js": "sha384-6GNPYUTwsoi1ZsfOWhVWqw4vI328WX6Xb5f7A4HygyT5s+fmJaEbL7ZQmPamoyJz",
+    "baseui.templates.xml": "sha384-9llWP0L4BuRpij3wEYymvwY8MOBd11X9mdXqI2JtYHr9j2tCrTbE0hIEMNCDOFdj",
+    "baseui.block-viewer.esm.js": "sha384-5Y2lUNdq6p3i8srVH4rVWtYLO7mFPP6Pqn80e4Ih32c/PgQqy1HDf6nI04mu6yLa",
     "baseui.analytics.esm.js": "sha384-M6TVmchmceTvpSzgI+DNA6zAn9xmz9a+YEexCLslSo/Ngxyp2kmzs9fm+PxWy+Da",
     "baseui.analytics.min.js": "sha384-B0hBkVDbT7gmDmUMazlN4Nc1KnYGSpL+IcW2hd8840knx73HGImPgGs84MvS3hKE",
     "icons/lucide.json": "sha384-mc5mzpmq9eOgZVa2IcjrL33Ty4nMXE8aoZMfy+lgkC/jMQ4aYnk2S58mFsSGFnW1",

package/dist/baseui.templates.xml

@@ -731,7 +731,7 @@
             <section t-att-class="state.mode === 'code' ? 'bu-block-code-panel is-active' : 'bu-block-code-panel'">
               <div class="bu-block-code-toolbar" role="group" aria-label="Code source">
                 <Button variant="'ghost'" type="'button'" ariaPressed="state.codeVariant === 'owl' ? 'true' : 'false'" onClick="() => this.setCodeVariant('owl')">
-                  Pure Owl Component
+                  Base Component
                 </Button>
                 <Button variant="'ghost'" type="'button'" ariaPressed="state.codeVariant === 'template' ? 'true' : 'false'" onClick="() => this.setCodeVariant('template')">
                   Template
@@ -1085,16 +1085,7 @@
   </t>
   <t t-name="baseui.Combobox">
     <div t-att-class="'bu-combobox' + (props.className ? ' ' + props.className : '')" t-att-style="props.style" t-ref="root">
-      <input
-        class="form-control"
-        role="combobox"
-        t-att-id="props.id"
-        t-att-aria-expanded="disclosure.open ? 'true' : 'false'"
-        t-att-placeholder="props.placeholder"
-        t-att-value="state.query"
-        t-on-input="onInput"
-        t-on-focus="onFocus"
-      />
+      <t t-call="baseui.Outlined"><t t-call="baseui.Combobox.field"/></t>
       <div t-if="disclosure.open" class="bu-combobox-list" role="listbox">
         <div
           t-foreach="filteredOptions"
@@ -1109,6 +1100,21 @@
       </div>
     </div>
   </t>
+  <t t-name="baseui.Combobox.field">
+    <input
+      t-att-class="classNames"
+      role="combobox"
+      t-att-id="props.id"
+      t-att-disabled="props.disabled"
+      t-att-aria-expanded="disclosure.open ? 'true' : 'false'"
+      t-att-aria-invalid="isInvalid ? 'true' : undefined"
+      t-att-aria-describedby="describedBy"
+      t-att-placeholder="fieldPlaceholder"
+      t-att-value="state.query"
+      t-on-input="onInput"
+      t-on-focus="onFocus"
+    />
+  </t>
   <t t-name="Combobox" t-call="baseui.Combobox"/>
 <t t-name="baseui.command">
     <div b-ui="command" class="bu-command"/>
@@ -1344,12 +1350,17 @@
     <input class="form-control" type="date"/>
   </t>
   <t t-name="baseui.DatePicker">
+    <t t-call="baseui.Outlined"><t t-call="baseui.DatePicker.field"/></t>
+  </t>
+  <t t-name="baseui.DatePicker.field">
     <input
       type="date"
       t-att-class="classNames"
       t-att-style="props.style"
       t-att-value="props.value"
       t-att-disabled="props.disabled"
+      t-att-aria-invalid="isInvalid ? 'true' : undefined"
+      t-att-aria-describedby="describedBy"
       t-on-input="onInput"
     />
   </t>
@@ -1616,13 +1627,7 @@
       t-att-class="classNames"
       t-att-style="props.style"
     >
-      <label t-if="props.label" class="bu-field-label" data-slot="field-label">
-        <t t-esc="props.label"/>
-      </label>
       <t t-slot="default"/>
-      <div t-if="props.error" role="alert" class="bu-field-error" data-slot="field-error">
-        <t t-esc="props.error"/>
-      </div>
     </div>
   </t>
   <t t-name="Field" t-call="baseui.Field"/>
@@ -1746,7 +1751,7 @@
   </t>
   <t t-name="HoverCardTrigger" t-call="baseui.HoverCardTrigger"/>
   <t t-name="baseui.HoverCardContent">
-    <span t-if="open" class="bu-hover-card-content" t-att-style="props.style" role="dialog"><t t-slot="default"/></span>
+    <span t-if="open" t-att-class="'bu-hover-card-content' + (props.className ? ' ' + props.className : '')" t-att-style="props.style" role="dialog"><t t-slot="default"/></span>
   </t>
   <t t-name="HoverCardContent" t-call="baseui.HoverCardContent"/>
 <t t-name="baseui.Icon">
@@ -1761,12 +1766,12 @@
     ></span>
   </t>
   <t t-name="Icon" t-call="baseui.Icon"/>
-<t t-name="baseui.Input">
-    <div t-if="isOutlined" t-att-class="outlinedClassNames">
+<t t-name="baseui.Outlined">
+    <div t-if="isOutlined" t-att-class="outlinedClassNames" t-att-style="labelStyle">
       <div class="bu-input-box">
-        <Icon t-if="props.leadingIcon" name="props.leadingIcon" className="'bu-input-icon bu-input-leading'"/>
-        <t t-call="baseui.Input.field"/>
-        <span class="bu-input-label" t-esc="props.label"/>
+        <Icon t-if="leadingIcon" name="leadingIcon" className="'bu-input-icon bu-input-leading'"/>
+        <t t-out="0"/>
+        <span class="bu-input-label" t-esc="label"/>
         <Icon t-if="trailingIcon" name="trailingIcon" className="'bu-input-icon bu-input-trailing'"/>
       </div>
       <div t-if="supportingText or props.maxLength" class="bu-input-support">
@@ -1774,7 +1779,10 @@
         <span t-if="props.maxLength" class="bu-input-counter" t-esc="counter"/>
       </div>
     </div>
-    <t t-else="" t-call="baseui.Input.field"/>
+    <t t-else="" t-out="0"/>
+  </t>
+  <t t-name="baseui.Input">
+    <t t-call="baseui.Outlined"><t t-call="baseui.Input.field"/></t>
   </t>
   <t t-name="baseui.Input.field">
     <input
@@ -1791,7 +1799,7 @@
       t-att-maxlength="props.maxLength"
       t-att-aria-label="ariaLabel"
       t-att-aria-invalid="isInvalid ? 'true' : undefined"
-      t-att-aria-describedby="supportingText ? supportId : undefined"
+      t-att-aria-describedby="describedBy"
       t-att-min="props.min"
       t-att-max="props.max"
       t-att-step="props.step"
@@ -1802,7 +1810,11 @@
   <t t-name="Input" t-call="baseui.Input"/>
 <t t-name="baseui.input-group"><div b-ui="input-group"><t t-esc="props.content"/></div></t>
   <t t-name="baseui.InputGroup">
-    <div t-att-class="classNames" t-att-style="props.style" data-slot="input-group" role="group"><t t-slot="default"/></div>
+    <t t-call="baseui.Outlined"><t t-call="baseui.InputGroup.box"/></t>
+  </t>
+  <t t-name="baseui.InputGroup.box">
+    <div t-att-class="classNames" t-att-style="props.style" data-slot="input-group" role="group"
+         t-att-aria-describedby="describedBy"><t t-slot="default"/></div>
   </t>
   <t t-name="baseui.InputGroupAddon">
     <div
@@ -1837,7 +1849,7 @@
       t-att-class="classNames"
       t-att-style="props.style"
       t-att-type="props.type || 'text'"
-      t-att-placeholder="props.placeholder"
+      t-att-placeholder="fieldPlaceholder"
       t-att-value="props.value"
       t-att-disabled="props.disabled"
       t-att-readonly="props.readonly"
@@ -1851,7 +1863,7 @@
     <textarea
       t-att-class="classNames"
       t-att-style="props.style"
-      t-att-placeholder="props.placeholder"
+      t-att-placeholder="fieldPlaceholder"
       t-att-rows="props.rows"
       t-att-disabled="props.disabled"
       t-att-readonly="props.readonly"
@@ -2044,8 +2056,13 @@
     <select b-ui="native-select"><t t-slot="default"/></select>
   </t>
   <t t-name="baseui.NativeSelect">
+    <t t-call="baseui.Outlined"><t t-call="baseui.NativeSelect.field"/></t>
+  </t>
+  <t t-name="baseui.NativeSelect.field">
     <select t-att-class="classNames" t-att-disabled="props.disabled" t-att-value="props.value"
-            t-att-aria-label="ariaLabel" t-att-id="props.id" t-att-style="props.style" t-on-change="onChange">
+            t-att-aria-label="ariaLabel" t-att-id="props.id" t-att-style="props.style"
+            t-att-aria-invalid="isInvalid ? 'true' : undefined" t-att-aria-describedby="describedBy"
+            t-on-change="onChange">
       <t t-slot="default"/>
     </select>
   </t>
@@ -2256,7 +2273,13 @@
   <t t-name="Separator" t-call="baseui.Separator"/>
 <t t-name="baseui.select"><div b-ui="select"><t t-esc="props.content"/></div></t>
   <t t-name="baseui.Select">
-    <div t-att-class="classNames" t-att-style="props.style" t-ref="root"><t t-slot="default"/></div>
+    <div t-att-class="classNames" t-att-style="rootStyle" t-ref="root">
+      <t t-slot="default"/>
+      <span t-if="isOutlined" class="bu-input-label" t-esc="label"/>
+      <div t-if="isOutlined and supportingText" class="bu-input-support">
+        <span t-att-id="supportId" t-esc="supportingText"/>
+      </div>
+    </div>
   </t>
   <t t-name="Select" t-call="baseui.Select"/>
   <t t-name="baseui.SelectTrigger">
@@ -2732,15 +2755,21 @@
     <textarea b-ui="textarea"></textarea>
   </t>
   <t t-name="baseui.Textarea">
+    <t t-call="baseui.Outlined"><t t-call="baseui.Textarea.field"/></t>
+  </t>
+  <t t-name="baseui.Textarea.field">
     <textarea
       t-att-class="classNames"
       t-att-style="props.style"
-      t-att-placeholder="props.placeholder"
+      t-att-placeholder="fieldPlaceholder"
       t-att-rows="props.rows"
       t-att-disabled="props.disabled"
       t-att-readonly="props.readonly"
       t-att-value="props.value"
       t-att-id="props.id"
+      t-att-maxlength="props.maxLength"
+      t-att-aria-invalid="isInvalid ? 'true' : undefined"
+      t-att-aria-describedby="describedBy"
       t-on-input="onInput"
       t-on-change="onChange"
     ></textarea>

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/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.3/dist/baseui.analytics.esm.js";
+  import { init } from "https://cdn.jsdelivr.net/npm/@thebase/ui@1.1.5/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.3/dist/baseui.analytics.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@thebase/ui@1.1.5/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.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.
+The dashboard ([`dashboard/`](../examples/analytics/dashboard/?backend=http://localhost:8080)) is a pure application that loads `@thebase/ui@1.1.5` 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.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 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.5`, 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,7 +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 Owl `ApiDoc` component (sidebar, schemas, Try It, Authorize); see [ApiDoc](components/apidoc.md).
+- `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

@@ -1,12 +1,12 @@
 # ApiDoc
 
-Use `b-ui="apidoc"` (or the pure Owl `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).
+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.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { ApiDoc } from "@base/component";
@@ -22,13 +22,26 @@ 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`)
+
+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 BaseUI script was loaded from; set `b-att-templates` to override.
+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
 
@@ -46,7 +59,7 @@ The static adapter fetches `baseui.templates.xml` from the folder the BaseUI scr
 | `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 BaseUI script | Folder that holds `img/*.svg` language logos. Empty string hides the logos. |
+| `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. |

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