@thebase/ui 1.1.3 → 1.1.5

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
 

package/docs/components/checkbox.md

@@ -2,7 +2,7 @@
 
 Native checkbox input or label wrapper.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Checkbox } from "@thebase/ui";
@@ -22,7 +22,7 @@ import { Checkbox } from "@thebase/ui";
 | `Checkbox` | `id` | `String` | optional, e.g. for `Label`'s `for` |
 | `Checkbox` | `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
 

package/docs/components/clipboard-button.md

@@ -8,7 +8,7 @@ Use `b-ui="clipboard-button"` on a native button to copy specific data to the cl
 <pre id="snippet">const x = 1;</pre>
 ```
 
-## Pure Owl component
+## Base component
 
 ```js
 import { ClipboardButton } from "@thebase/ui";
@@ -35,7 +35,7 @@ import { ClipboardButton } from "@thebase/ui";
 | `onCopy` | `Function` | called with `{ value, event }` after a successful copy |
 | `onCopyError` | `Function` | called with `{ error, event }` when both the Clipboard API and the fallback fail |
 
-Also accepts default slot content instead of `label`. 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`. 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/collapsible.md

@@ -2,7 +2,7 @@
 
 Use `b-ui="collapsible"` for a single disclosure region.
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "@thebase/ui";
@@ -28,7 +28,7 @@ import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "@thebase/ui
 | `CollapsibleContent` | `className` | `String` | optional |
 | `CollapsibleTrigger` | `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/combobox.md

@@ -4,9 +4,9 @@ Use `b-ui="combobox"` for a CDN-ready combobox 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 { Combobox } from "@thebase/ui";
@@ -20,7 +20,7 @@ import { Combobox } from "@thebase/ui";
     { value: 'nuxtjs', label: 'Nuxt.js' },
     { value: 'remix', label: 'Remix' },
     { value: 'astro', label: 'Astro' },
-  ]" placeholder="'Select a framework'"/>
+  ]" label="'Framework'" placeholder="'Select a framework'"/>
 </div>
 ```
 
@@ -32,8 +32,9 @@ import { Combobox } from "@thebase/ui";
 | `Combobox` | `className` | `String` | optional |
 | `Combobox` | `id` | `String` | optional, e.g. for `Label`'s `for` |
 | `Combobox` | `onChange` | `Function` | optional |
+| `Combobox` | `label`, `labelBackground`, `supportingText`, `errorText`, `invalid`, `disabled` | `String` / `Boolean` | Material-style outlined field, same behaviour as [Input](/examples/blocks.html#/docs/components/input): the label floats onto the border, `errorText` replaces `supportingText`. Also inherited from a parent `Field`. |
 
-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
 
@@ -59,7 +60,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
 
@@ -71,7 +72,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/command.md

@@ -4,9 +4,9 @@ Use `b-ui="command"` for a CDN-ready command 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 { Command } from "@thebase/ui";
@@ -36,7 +36,7 @@ import { Command } from "@thebase/ui";
 | `Command` | `className` | `String` | optional |
 | `Command` | `onSelect` | `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
 
@@ -62,7 +62,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
 
@@ -74,7 +74,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/context-menu.md

@@ -4,9 +4,9 @@ Use `b-ui="context-menu"` for a CDN-ready context menu 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 { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuTrigger } from "@thebase/ui";
@@ -38,7 +38,7 @@ import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuTrigger }
 | `ContextMenuItem` | `onClick` | `Function` | optional |
 | `ContextMenuTrigger` | `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
 
@@ -64,7 +64,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
 
@@ -76,7 +76,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/data-table.md

@@ -4,9 +4,9 @@ Use `b-ui="data-table"` for a CDN-ready data table 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 { DataTable } from "@thebase/ui";
@@ -62,9 +62,9 @@ The table viewport always scrolls horizontally (`overflow: auto`) once its conte
 
 ### Mobile kanban view
 
-Below 640px width, the table view is replaced by a stacked one-column card ("kanban") view — each row becomes a card showing every visible column as a label/value pair, with selection and row actions preserved. This is CSS-driven (`.bu-data-table__viewport` hides, `.bu-data-table__cards` shows), so it applies to both the pure Owl component and the static `b-ui="data-table"` markup automatically.
+Below 640px width, the table view is replaced by a stacked one-column card ("kanban") view — each row becomes a card showing every visible column as a label/value pair, with selection and row actions preserved. This is CSS-driven (`.bu-data-table__viewport` hides, `.bu-data-table__cards` shows), so it applies to both the Base component and the static `b-ui="data-table"` markup automatically.
 
-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
 
@@ -90,7 +90,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
 
@@ -150,7 +150,7 @@ Pass custom buttons into the toolbar via the `toolbarActions` slot — they rend
 
 ## 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/date-picker.md

@@ -4,18 +4,18 @@ Use `b-ui="date-picker"` for a CDN-ready date picker 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 { DatePicker } from "@thebase/ui";
 ```
 
 ```base-ui
-<div style="max-width: 28rem" class="w-100 d-flex flex-column gap-2">
-  <Label>Date of birth</Label>
-  <DatePicker/>
+<div style="max-width: 28rem" class="w-100 d-flex flex-column gap-4">
+  <DatePicker label="'Date of birth'" supportingText="'As on your ID'"/>
+  <DatePicker label="'Start date'" errorText="'Pick a date'"/>
 </div>
 ```
 
@@ -25,8 +25,9 @@ import { DatePicker } from "@thebase/ui";
 | `DatePicker` | `disabled` | `Boolean` | optional |
 | `DatePicker` | `className` | `String` | optional |
 | `DatePicker` | `onChange` | `Function` | optional |
+| `DatePicker` | `label`, `labelBackground`, `supportingText`, `errorText`, `invalid` | `String` / `Boolean` | Material-style outlined field, same behaviour as [Input](/examples/blocks.html#/docs/components/input): the label floats onto the border, `errorText` replaces `supportingText`. Also inherited from a parent `Field`. |
 
-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 +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
 
@@ -64,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/dialog.md

@@ -1,6 +1,6 @@
 # Dialog
 
-## Pure Owl component
+## Base component
 
 ```js
 import {
@@ -31,7 +31,7 @@ import {
 | `defaultOpen` | `Boolean` | initial state when uncontrolled |
 | `onOpenChange` | `Function` | called with the new open boolean |
 
-`DialogContent` also accepts `showCloseButton` (default `true`) to render the shadcn-style top-right close control; pass `false` to hide it. `DialogTrigger`, `DialogContent`, `DialogHeader`, `DialogFooter`, `DialogTitle`, `DialogDescription`, and `DialogClose` each accept `className` and render default slot content; they read open/close behavior from the parent `Dialog` automatically. `DialogContent` is driven by a real `bootstrap.Modal` instance bound to its own root (rendered as `.modal.fade > .modal-dialog > .modal-content`, permanently mounted rather than added/removed from the DOM) — Escape, backdrop click, the built-in close control, and `DialogClose` (both wired via `data-bs-dismiss="modal"`) all close the dialog, and the Tab focus trap plus initial-focus/focus-restore on open/close are Bootstrap's own native Modal behavior, same as the static API. See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+`DialogContent` also accepts `showCloseButton` (default `true`) to render the shadcn-style top-right close control; pass `false` to hide it. `DialogTrigger`, `DialogContent`, `DialogHeader`, `DialogFooter`, `DialogTitle`, `DialogDescription`, and `DialogClose` each accept `className` and render default slot content; they read open/close behavior from the parent `Dialog` automatically. `DialogContent` is driven by a real `bootstrap.Modal` instance bound to its own root (rendered as `.modal.fade > .modal-dialog > .modal-content`, permanently mounted rather than added/removed from the DOM) — Escape, backdrop click, the built-in close control, and `DialogClose` (both wired via `data-bs-dismiss="modal"`) all close the dialog, and the Tab focus trap plus initial-focus/focus-restore on open/close are Bootstrap's own native Modal behavior, same as the static API. See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 
@@ -65,8 +65,8 @@ import {
 </div>
 ```
 
-At mount, BaseUI restructures this markup into Bootstrap's required shape: the `[b-ui="dialog"]` root becomes the `.modal.fade` element and `[b-dialog-panel]` is wrapped in a new `.modal-dialog` and becomes `.modal-content` — you don't need to author those wrapper levels yourself. The dialog is driven by a real `bootstrap.Modal` instance (`backdrop: true, keyboard: true, focus: true`, all Bootstrap defaults); `[b-dialog-close]` buttons get `data-bs-dismiss="modal"` at mount time instead of a manual click handler.
+At mount, the Base UI restructures this markup into Bootstrap's required shape: the `[b-ui="dialog"]` root becomes the `.modal.fade` element and `[b-dialog-panel]` is wrapped in a new `.modal-dialog` and becomes `.modal-content` — you don't need to author those wrapper levels yourself. The dialog is driven by a real `bootstrap.Modal` instance (`backdrop: true, keyboard: true, focus: true`, all Bootstrap defaults); `[b-dialog-close]` buttons get `data-bs-dismiss="modal"` at mount time instead of a manual click handler.
 
-Events: `baseui:open`, `baseui:close` (BaseUI), plus the underlying `shown.bs.modal`/`hidden.bs.modal`.
+Events: `baseui:open`, `baseui:close` (the Base UI), plus the underlying `shown.bs.modal`/`hidden.bs.modal`.
 
 Keyboard: Escape closes the dialog (Bootstrap's native `keyboard` option), as does a backdrop click. Focus moves into the panel on open and is trapped there via Tab/Shift+Tab, then returns to the trigger on close — all native `bootstrap.Modal` behavior.

package/docs/components/direction.md

@@ -1,6 +1,6 @@
 # Direction
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Direction } from "@thebase/ui";
@@ -51,7 +51,7 @@ import { Direction } from "@thebase/ui";
 | `Direction` | `dir` | `String` | optional |
 | `Direction` | `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/drawer.md

@@ -1,6 +1,6 @@
 # Drawer
 
-## Pure Owl component
+## Base component
 
 ```js
 import { Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger } from "@thebase/ui";
@@ -38,7 +38,7 @@ import { Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, Dr
 | `DrawerTitle` | `className` | `String` | optional |
 | `DrawerTrigger` | `className` | `String` | optional |
 
-`DrawerContent` is driven by a real `bootstrap.Offcanvas` instance bound to its own root (rendered as `.offcanvas.offcanvas-bottom`, permanently mounted rather than added/removed from the DOM) — Escape, backdrop click, and the Tab focus trap are Bootstrap's own native Offcanvas behavior, same as the static API; focus-restore-to-trigger on close is kept by hand (not native to Offcanvas). `DrawerClose` closes via `data-bs-dismiss="offcanvas"`. Drawer has no side variant — it always slides up from the bottom. See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
+`DrawerContent` is driven by a real `bootstrap.Offcanvas` instance bound to its own root (rendered as `.offcanvas.offcanvas-bottom`, permanently mounted rather than added/removed from the DOM) — Escape, backdrop click, and the Tab focus trap are Bootstrap's own native Offcanvas behavior, same as the static API; focus-restore-to-trigger on close is kept by hand (not native to Offcanvas). `DrawerClose` closes via `data-bs-dismiss="offcanvas"`. Drawer has no side variant — it always slides up from the bottom. See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
 
 ## Static component
 
@@ -53,6 +53,6 @@ import { Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, Dr
 
 At mount, `[b-ui="drawer"]` itself becomes the `.offcanvas.offcanvas-bottom` element (`tabindex="-1"`) driven by a real `bootstrap.Offcanvas` instance (`backdrop: true, keyboard: true, scroll: false`); `[b-drawer-panel]` stays as a plain cosmetic content box inside it. `[b-drawer-close]` buttons get `data-bs-dismiss="offcanvas"` at mount time instead of a manual click handler.
 
-Events: `baseui:open`, `baseui:close` (BaseUI), plus the underlying `shown.bs.offcanvas`/`hidden.bs.offcanvas`.
+Events: `baseui:open`, `baseui:close` (the Base UI), plus the underlying `shown.bs.offcanvas`/`hidden.bs.offcanvas`.
 
 Keyboard: Escape closes the drawer (Bootstrap's native `keyboard` option), as does a backdrop click on the Bootstrap-generated `.offcanvas-backdrop`. Focus is trapped inside via Tab/Shift+Tab (native `bootstrap.Offcanvas` focus trap) and returns to the trigger on close (kept by hand — not native to Offcanvas).

package/docs/components/dropdown-menu.md

@@ -2,7 +2,7 @@
 
 Displays a menu to the user, such as a set of actions or functions, triggered by a button.
 
-## Pure Owl component
+## Base component
 
 ```js
 import {
@@ -68,7 +68,7 @@ import {
 | `DropdownMenuRadioItem` | `value` | `String` | optional |
 | `DropdownMenuLabel`, `DropdownMenuShortcut`, `DropdownMenuSeparator`, `DropdownMenuGroup` | `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
 
@@ -106,4 +106,4 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 </div>
 ```
 
-The trigger supports click, ArrowDown, and Escape. Root open/close is driven by a real `bootstrap.Dropdown` instance on the trigger (the panel carries Bootstrap's `dropdown-menu`/`show` classes); submenus remain BaseUI's own hover/click behavior. Events: `baseui:open`, `baseui:close` (BaseUI), plus the underlying `show.bs.dropdown`/`shown.bs.dropdown`/`hide.bs.dropdown`/`hidden.bs.dropdown`.
+The trigger supports click, ArrowDown, and Escape. Root open/close is driven by a real `bootstrap.Dropdown` instance on the trigger (the panel carries Bootstrap's `dropdown-menu`/`show` classes); submenus remain the Base UI's own hover/click behavior. Events: `baseui:open`, `baseui:close` (the Base UI), plus the underlying `show.bs.dropdown`/`shown.bs.dropdown`/`hide.bs.dropdown`/`hidden.bs.dropdown`.

package/docs/components/empty.md

@@ -2,7 +2,7 @@
 
 Use `b-ui="empty"` for an accessible empty state. The component mirrors shadcn's Base Empty composition: header, media, title, description, and content.
 
-## Pure Owl component
+## Base component
 
 ```js
 import {
@@ -46,7 +46,7 @@ import {
 | `EmptyDescription` | `className` | `String` | optional |
 | `EmptyContent` | `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,4 +63,4 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 </div>
 ```
 
-BaseUI sets `role="status"` by default. Use `b-att-variant="outline"` for a dashed container and `b-att-variant="background"` for a muted panel; avatar, avatar-group, input-group, and RTL states are composed by placing those components inside `b-empty-media` or `b-empty-content`.
+The Base UI sets `role="status"` by default. Use `b-att-variant="outline"` for a dashed container and `b-att-variant="background"` for a muted panel; avatar, avatar-group, input-group, and RTL states are composed by placing those components inside `b-empty-media` or `b-empty-content`.