@thebase/ui 1.1.2 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/CHANGELOG.md +42 -16
  2. package/README.md +37 -22
  3. package/bin/create-baseui-app.mjs +21 -8
  4. package/dist/apidoc/img/bash-plain.svg +1 -0
  5. package/dist/apidoc/img/c-original.svg +1 -0
  6. package/dist/apidoc/img/csharp-original.svg +1 -0
  7. package/dist/apidoc/img/dart-original.svg +1 -0
  8. package/dist/apidoc/img/go-original-wordmark.svg +1 -0
  9. package/dist/apidoc/img/java-original.svg +1 -0
  10. package/dist/apidoc/img/javascript-original.svg +1 -0
  11. package/dist/apidoc/img/kotlin-original.svg +10 -0
  12. package/dist/apidoc/img/lua.svg +7 -0
  13. package/dist/apidoc/img/nodejs-original.svg +1 -0
  14. package/dist/apidoc/img/objectivec-plain.svg +1 -0
  15. package/dist/apidoc/img/php-original.svg +2 -0
  16. package/dist/apidoc/img/python-original.svg +1 -0
  17. package/dist/apidoc/img/ruby-plain.svg +1 -0
  18. package/dist/apidoc/img/rust-original.svg +1 -0
  19. package/dist/apidoc/img/swift-original.svg +1 -0
  20. package/dist/apidoc/img/windows8-original.svg +1 -0
  21. package/dist/baseui.apidoc.esm.js +935 -0
  22. package/dist/baseui.apidoc.min.js +936 -0
  23. package/dist/baseui.esm.js +33 -11
  24. package/dist/baseui.min.css +1 -1
  25. package/dist/baseui.min.js +33 -11
  26. package/dist/baseui.pwa.esm.js +4 -4
  27. package/dist/baseui.registry.json +42 -5
  28. package/dist/baseui.templates.xml +470 -2
  29. package/dist/pwa-icons/apple-touch-icon.png +0 -0
  30. package/dist/pwa-icons/favicon-16x16.png +0 -0
  31. package/dist/pwa-icons/favicon-32x32.png +0 -0
  32. package/dist/pwa-icons/favicon.ico +0 -0
  33. package/dist/pwa-icons/icon-192.png +0 -0
  34. package/dist/pwa-icons/icon-512.png +0 -0
  35. package/dist/types/apidoc.d.ts +27 -0
  36. package/dist/types/pwa.d.ts +9 -1
  37. package/docs/analytics.md +5 -5
  38. package/docs/blocks.md +5 -4
  39. package/docs/components/accordion.md +3 -3
  40. package/docs/components/alert-dialog.md +2 -2
  41. package/docs/components/alert.md +2 -2
  42. package/docs/components/apidoc.md +79 -0
  43. package/docs/components/aspect-ratio.md +2 -2
  44. package/docs/components/attachment.md +3 -3
  45. package/docs/components/avatar.md +5 -5
  46. package/docs/components/badge.md +2 -2
  47. package/docs/components/block-viewer.md +4 -4
  48. package/docs/components/breadcrumb.md +3 -3
  49. package/docs/components/bubble.md +2 -2
  50. package/docs/components/button-group.md +2 -2
  51. package/docs/components/button.md +2 -2
  52. package/docs/components/calendar.md +5 -5
  53. package/docs/components/card.md +2 -2
  54. package/docs/components/carousel.md +5 -5
  55. package/docs/components/chart.md +5 -5
  56. package/docs/components/checkbox.md +2 -2
  57. package/docs/components/clipboard-button.md +2 -2
  58. package/docs/components/collapsible.md +2 -2
  59. package/docs/components/combobox.md +5 -5
  60. package/docs/components/command.md +5 -5
  61. package/docs/components/context-menu.md +5 -5
  62. package/docs/components/data-table.md +6 -6
  63. package/docs/components/date-picker.md +5 -5
  64. package/docs/components/dialog.md +4 -4
  65. package/docs/components/direction.md +2 -2
  66. package/docs/components/drawer.md +3 -3
  67. package/docs/components/dropdown-menu.md +3 -3
  68. package/docs/components/empty.md +3 -3
  69. package/docs/components/field.md +1 -1
  70. package/docs/components/form.md +3 -3
  71. package/docs/components/hover-card.md +2 -2
  72. package/docs/components/icon.md +3 -3
  73. package/docs/components/input-group.md +2 -2
  74. package/docs/components/input-otp.md +5 -5
  75. package/docs/components/input.md +22 -5
  76. package/docs/components/item.md +2 -2
  77. package/docs/components/kbd.md +2 -2
  78. package/docs/components/label.md +2 -2
  79. package/docs/components/markdown.md +4 -4
  80. package/docs/components/marker.md +2 -2
  81. package/docs/components/menubar.md +2 -2
  82. package/docs/components/message-scroller.md +5 -5
  83. package/docs/components/message.md +5 -5
  84. package/docs/components/native-select.md +2 -2
  85. package/docs/components/navigation-menu.md +3 -3
  86. package/docs/components/pagination.md +3 -3
  87. package/docs/components/popover.md +7 -7
  88. package/docs/components/progress.md +2 -2
  89. package/docs/components/pwa.md +2 -2
  90. package/docs/components/questionnaire.md +5 -5
  91. package/docs/components/radio-group.md +2 -2
  92. package/docs/components/resizable.md +5 -5
  93. package/docs/components/scroll-area.md +5 -5
  94. package/docs/components/select.md +2 -2
  95. package/docs/components/separator.md +2 -2
  96. package/docs/components/sheet.md +3 -3
  97. package/docs/components/shell.md +2 -2
  98. package/docs/components/sidebar.md +2 -2
  99. package/docs/components/skeleton.md +2 -2
  100. package/docs/components/slider.md +2 -2
  101. package/docs/components/spinner.md +3 -3
  102. package/docs/components/switch.md +2 -2
  103. package/docs/components/table.md +2 -2
  104. package/docs/components/tabs.md +4 -4
  105. package/docs/components/text-editor.md +2 -2
  106. package/docs/components/textarea.md +3 -3
  107. package/docs/components/theme-button.md +4 -4
  108. package/docs/components/toast.md +3 -3
  109. package/docs/components/toggle-group.md +5 -5
  110. package/docs/components/toggle.md +5 -5
  111. package/docs/components/tooltip.md +7 -7
  112. package/docs/components/typography.md +3 -3
  113. package/docs/icons.md +7 -7
  114. package/docs/installation.md +14 -13
  115. package/docs/owl-components.md +16 -16
  116. package/docs/registry.md +8 -8
  117. package/docs/runtime-api.md +3 -3
  118. package/docs/theming.md +5 -5
  119. package/docs/usage-guide.md +30 -27
  120. package/package.json +10 -1
@@ -1,14 +1,14 @@
1
1
  # Markdown
2
2
 
3
- Use `b-ui="markdown"` (or the pure Owl `Markdown` component) to render Markdown or mount an editable Markdown document. Read-only parsing uses the vendored `src/runtime/marked/marked.min.js` (marked v15). Fenced ` ```mermaid ` code blocks render as inline SVG via `src/runtime/mermaid/mermaid.esm.min.mjs`. Fenced ` ```base-ui ` code blocks render as a live BaseUI preview through the page's global static runtime (`window.thebase`, e.g. `dist/baseui.min.js`).
3
+ Use `b-ui="markdown"` (or the pure Base `Markdown` component) to render Markdown or mount an editable Markdown document. Read-only parsing uses the vendored `src/runtime/marked/marked.min.js` (marked v15). Fenced ` ```mermaid ` code blocks render as inline SVG via `src/runtime/mermaid/mermaid.esm.min.mjs`. Fenced ` ```base-ui ` code blocks render as a live the Base UI preview through the page's global static runtime (`window.thebase`, e.g. `dist/baseui.min.js`).
4
4
 
5
5
  Editable mode lazy-loads `dist/runtime/milkdown/milkdown-editor.js`, which bundles Milkdown, Yjs, and y-webrtc only when `b-att-editable="true"` / `editable="true"` is used. The editor runtime enables CommonMark, GFM, history, clipboard, cursor, listener, indent, upload, block handle, tooltip, slash, streaming, and diff plugins. Collaborative mode uses Milkdown's Yjs-aware collab undo/redo instead of the plain history stack.
6
6
 
7
7
  ## CDN install requirements
8
8
 
9
- Load the pinned BaseUI CSS and JavaScript files. No extra `<script>` tag, npm install, or CDN reference is required for Markdown parsing, mermaid diagrams, or the Milkdown editor runtime — each lazy asset is emitted under `dist/runtime/` and fetched only when needed. Live ` ```base-ui ` previews reuse the same static runtime the rest of the page already loads (`dist/baseui.min.js`) — if that script isn't on the page, the block renders an inline error instead of a live preview.
9
+ Load the pinned the Base UI CSS and JavaScript files. No extra `<script>` tag, npm install, or CDN reference is required for Markdown parsing, mermaid diagrams, or the Milkdown editor runtime — each lazy asset is emitted under `dist/runtime/` and fetched only when needed. Live ` ```base-ui ` previews reuse the same static runtime the rest of the page already loads (`dist/baseui.min.js`) — if that script isn't on the page, the block renders an inline error instead of a live preview.
10
10
 
11
- ## Pure Owl component
11
+ ## Base component
12
12
 
13
13
  ```js
14
14
  import { Markdown } from "@base/component";
@@ -97,7 +97,7 @@ A fenced ` ```base-ui ` block renders as a live component, not a code sample:
97
97
 
98
98
  - `b-att-src` / `src` — fetch a remote Markdown file instead of using inline content.
99
99
  - `b-att-content` / `content` — a static `<script type="text/markdown">` child (or a `<template>`), `b-att-content`, or the element's own text content supplies the Markdown source when no `src` is set.
100
- - `b-att-mermaid` / `mermaid` — set to `"false"` to skip mermaid diagram rendering (defaults to enabled).
100
+ - `b-att-mermaid` / `mermaid` — set to `"false"` to skip mermaid diagram rendering (defaults to enabled). Diagrams use mermaid's dark theme when the nearest `data-bs-theme` (else the system preference) is dark.
101
101
  - `b-att-base-ui` / `baseUi` — set to `"false"` to skip live-mounting fenced ` ```base-ui ` blocks; they render as plain code instead (defaults to enabled).
102
102
  - `b-att-editable` / `editable` — set to `"true"` to mount Milkdown instead of read-only rendered HTML.
103
103
  - `b-att-collaborative` / `collaborative` — set to `"true"` to connect the editor through Yjs + y-webrtc.
@@ -1,6 +1,6 @@
1
1
  # Marker
2
2
 
3
- ## Pure Owl component
3
+ ## Base component
4
4
 
5
5
  ```js
6
6
  import { Marker } from "@thebase/ui";
@@ -19,7 +19,7 @@ import { Marker } from "@thebase/ui";
19
19
  | --- | --- | --- | --- |
20
20
  | `Marker` | `className` | `String` | optional |
21
21
 
22
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
22
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
23
23
 
24
24
  ## Static component
25
25
 
@@ -1,6 +1,6 @@
1
1
  # Menubar
2
2
 
3
- ## Pure Owl component
3
+ ## Base component
4
4
 
5
5
  ```js
6
6
  import { Menubar } from "@thebase/ui";
@@ -91,7 +91,7 @@ import { Menubar } from "@thebase/ui";
91
91
  | --- | --- | --- | --- |
92
92
  | `Menubar` | `className` | `String` | optional |
93
93
 
94
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
94
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
95
95
 
96
96
  ## Static component
97
97
 
@@ -4,9 +4,9 @@ Use `b-ui="message-scroller"` for a CDN-ready message scroller component.
4
4
 
5
5
  ## CDN install requirements
6
6
 
7
- Load the pinned BaseUI CSS and JavaScript files; no extra dependency is required for this component.
7
+ Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
8
8
 
9
- ## Pure Owl component
9
+ ## Base component
10
10
 
11
11
  ```js
12
12
  import { MessageScroller } from "@thebase/ui";
@@ -48,7 +48,7 @@ import { MessageScroller } from "@thebase/ui";
48
48
  | `MessageScroller` | `autoscroll` | `Boolean` | optional |
49
49
  | `MessageScroller` | `className` | `String` | optional |
50
50
 
51
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
51
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
52
52
 
53
53
  ## Static component
54
54
 
@@ -74,7 +74,7 @@ Interactive components emit documented `baseui:*` events from their root element
74
74
 
75
75
  ## CSS variables
76
76
 
77
- The component inherits BaseUI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
77
+ The component inherits the Base UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
78
78
 
79
79
  ## Accessibility behavior
80
80
 
@@ -86,7 +86,7 @@ See `examples/index.html` for a working CDN-style page.
86
86
 
87
87
  ## Browser support
88
88
 
89
- BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
89
+ The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
90
90
 
91
91
  ## Test checklist
92
92
 
@@ -4,9 +4,9 @@ Use `b-ui="message"` for a CDN-ready message component.
4
4
 
5
5
  ## CDN install requirements
6
6
 
7
- Load the pinned BaseUI CSS and JavaScript files; no extra dependency is required for this component.
7
+ Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
8
8
 
9
- ## Pure Owl component
9
+ ## Base component
10
10
 
11
11
  ```js
12
12
  import { Message } from "@thebase/ui";
@@ -41,7 +41,7 @@ import { Message } from "@thebase/ui";
41
41
  | `Message` | `side` | `String` | optional |
42
42
  | `Message` | `className` | `String` | optional |
43
43
 
44
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
44
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
45
45
 
46
46
  ## Static component
47
47
 
@@ -67,7 +67,7 @@ Interactive components emit documented `baseui:*` events from their root element
67
67
 
68
68
  ## CSS variables
69
69
 
70
- The component inherits BaseUI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
70
+ The component inherits the Base UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
71
71
 
72
72
  ## Accessibility behavior
73
73
 
@@ -79,7 +79,7 @@ See `examples/index.html` for a working CDN-style page.
79
79
 
80
80
  ## Browser support
81
81
 
82
- BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
82
+ The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
83
83
 
84
84
  ## Test checklist
85
85
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Browser-native select control with Bootstrap-compatible styling.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { NativeSelect } from "@thebase/ui";
@@ -30,7 +30,7 @@ import { NativeSelect } from "@thebase/ui";
30
30
  | `NativeSelect` | `id` | `String` | optional, e.g. for `Label`'s `for` |
31
31
  | `NativeSelect` | `onChange` | `Function` | optional |
32
32
 
33
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
33
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
34
34
 
35
35
  ## Static component
36
36
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Use `b-ui="navigation-menu"` for horizontal site or app navigation.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { NavigationMenu, NavigationMenuItem } from "@thebase/ui";
@@ -27,7 +27,7 @@ import { NavigationMenu, NavigationMenuItem } from "@thebase/ui";
27
27
  | `NavigationMenuItem` | `href` | `String` | optional |
28
28
  | `NavigationMenuItem` | `className` | `String` | optional |
29
29
 
30
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
30
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
31
31
 
32
32
  ## Static component
33
33
 
@@ -38,4 +38,4 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
38
38
  </nav>
39
39
  ```
40
40
 
41
- BaseUI adds `menubar`/`menuitem` roles and Left/Right arrow focus movement.
41
+ The Base UI adds `menubar`/`menuitem` roles and Left/Right arrow focus movement.
@@ -2,7 +2,7 @@
2
2
 
3
3
  Use `b-ui="pagination"` on a `nav` containing a list of links or buttons.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { Pagination, PaginationItem } from "@thebase/ui";
@@ -34,7 +34,7 @@ import { Pagination, PaginationItem } from "@thebase/ui";
34
34
  | `PaginationItem` | `disabled` | `Boolean` | optional |
35
35
  | `PaginationItem` | `onClick` | `Function` | optional |
36
36
 
37
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
37
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
38
38
 
39
39
  ## Static component
40
40
 
@@ -47,4 +47,4 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
47
47
  </nav>
48
48
  ```
49
49
 
50
- BaseUI adds Bootstrap pagination classes, active states, and disabled item styling.
50
+ The Base UI adds Bootstrap pagination classes, active states, and disabled item styling.
@@ -2,7 +2,7 @@
2
2
 
3
3
  Use `b-ui="popover"` with trigger and content nodes.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { Popover, PopoverContent, PopoverTrigger } from "@thebase/ui";
@@ -32,13 +32,13 @@ import { Popover, PopoverContent, PopoverTrigger } from "@thebase/ui";
32
32
  | `PopoverContent` | `className` | `String` | optional |
33
33
  | `PopoverTrigger` | `className` | `String` | optional |
34
34
 
35
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
35
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
36
36
 
37
- Both the pure Owl and static forms are driven by a live `bootstrap.Popover` instance owned on the trigger element — **the visible popup is Bootstrap's own generated DOM (a `.popover`/`.popover-arrow`/`.popover-body` node, positioned via Popper), appended to `document.body`, not rendered inline where you authored the popover.** Don't query for it as a descendant of the trigger or root; query `document.body.querySelector(".popover .popover-body")` instead. There's no separate heading/title concept in the current API — only body content (`.popover-body`); no `.popover-header` is generated.
37
+ Both the pure Base and static forms are driven by a live `bootstrap.Popover` instance owned on the trigger element — **the visible popup is Bootstrap's own generated DOM (a `.popover`/`.popover-arrow`/`.popover-body` node, positioned via Popper), appended to `document.body`, not rendered inline where you authored the popover.** Don't query for it as a descendant of the trigger or root; query `document.body.querySelector(".popover .popover-body")` instead. There's no separate heading/title concept in the current API — only body content (`.popover-body`); no `.popover-header` is generated.
38
38
 
39
39
  The default slot's rendered markup is captured into an HTML string for Bootstrap's `content`/`html: true` options (Bootstrap can't consume live vnodes): `PopoverContent` renders the slot into a hidden buffer element internal to its own template (it is no longer a visibly-toggled popup itself), `PopoverTrigger` reads that buffer's `innerHTML` on mount to seed the bootstrap instance, and re-syncs the live popup via `.setContent({'.popover-body': html})` whenever that HTML changes on a later render.
40
40
 
41
- Unlike `Tooltip`/hover-driven components, Bootstrap's own `trigger: "click"` option would bind its own click listener directly on the trigger element, independent of `PopoverTrigger`'s own `t-on-click`. To avoid double-toggling on a single click, the pure Owl `PopoverTrigger` constructs its `bootstrap.Popover` instance with `trigger: "manual"` and calls `.toggle()` itself from `onClick` — `shown.bs.popover`/`hidden.bs.popover` still fire from `.toggle()` regardless of the `trigger` option, since that option only gates Bootstrap's own auto-binding, not event dispatch. The static adapter, which has no competing click handler of its own, passes `trigger: "click"` and relies on Bootstrap's built-in binding instead.
41
+ Unlike `Tooltip`/hover-driven components, Bootstrap's own `trigger: "click"` option would bind its own click listener directly on the trigger element, independent of `PopoverTrigger`'s own `t-on-click`. To avoid double-toggling on a single click, the pure Base `PopoverTrigger` constructs its `bootstrap.Popover` instance with `trigger: "manual"` and calls `.toggle()` itself from `onClick` — `shown.bs.popover`/`hidden.bs.popover` still fire from `.toggle()` regardless of the `trigger` option, since that option only gates Bootstrap's own auto-binding, not event dispatch. The static adapter, which has no competing click handler of its own, passes `trigger: "click"` and relies on Bootstrap's built-in binding instead.
42
42
 
43
43
  ## Static component
44
44
 
@@ -65,11 +65,11 @@ Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `th
65
65
 
66
66
  ## Events
67
67
 
68
- Interactive components emit documented `baseui:*` events from their root element. Listen for Bootstrap's own `shown.bs.popover`/`hidden.bs.popover` on the trigger element to react to show/hide; BaseUI mirrors those into `b-att-state` (`open`/`closed`) and `aria-expanded` on the static trigger, and `this.env.popover.open`-equivalent reactive state on the pure Owl components.
68
+ Interactive components emit documented `baseui:*` events from their root element. Listen for Bootstrap's own `shown.bs.popover`/`hidden.bs.popover` on the trigger element to react to show/hide; the Base UI mirrors those into `b-att-state` (`open`/`closed`) and `aria-expanded` on the static trigger, and `this.env.popover.open`-equivalent reactive state on the Base components.
69
69
 
70
70
  ## CSS variables
71
71
 
72
- The component inherits BaseUI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`. The popup itself is styled by Bootstrap's own bundled `.popover`/`.popover-arrow`/`.popover-body` CSS (loaded via `dist/baseui.min.css`), not BaseUI's own classes.
72
+ The component inherits the Base UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`. The popup itself is styled by Bootstrap's own bundled `.popover`/`.popover-arrow`/`.popover-body` CSS (loaded via `dist/baseui.min.css`), not the Base UI's own classes.
73
73
 
74
74
  ## Accessibility behavior
75
75
 
@@ -81,7 +81,7 @@ See `examples/index.html` for a working CDN-style page.
81
81
 
82
82
  ## Browser support
83
83
 
84
- BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
84
+ The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
85
85
 
86
86
  ## Test checklist
87
87
 
@@ -1,6 +1,6 @@
1
1
  # Progress
2
2
 
3
- ## Pure Owl component
3
+ ## Base component
4
4
 
5
5
  ```js
6
6
  import { Progress } from "@thebase/ui";
@@ -18,7 +18,7 @@ import { Progress } from "@thebase/ui";
18
18
  | `Progress` | `max` | `Number` | optional |
19
19
  | `Progress` | `className` | `String` | optional |
20
20
 
21
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
21
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
22
22
 
23
23
  ## Static component
24
24
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Use `b-ui="pwa"` for a bottom-anchored install/permission prompt (an "Add to Home Screen" or "Allow notifications" sheet). Pwa is presentational only — it owns open/close state and focus/Escape handling, not the actual install or notification API calls. Wire your app's `beforeinstallprompt`/`Notification.requestPermission()` logic to the footer buttons you compose inside it.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import {
@@ -59,7 +59,7 @@ A launcher rendered outside the `Pwa` tree opens it through `PwaTrigger`, or by
59
59
 
60
60
  Render a second `Pwa` instance for a follow-up prompt (e.g. "Allow notifications" after install is dismissed) — each `Pwa` owns its own open state independently.
61
61
 
62
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
62
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
63
63
 
64
64
  ## Static component
65
65
 
@@ -4,9 +4,9 @@ Use `b-ui="questionnaire"` for a CDN-ready questionnaire component.
4
4
 
5
5
  ## CDN install requirements
6
6
 
7
- Load the pinned BaseUI CSS and JavaScript files; no extra dependency is required for this component.
7
+ Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
8
8
 
9
- ## Pure Owl component
9
+ ## Base component
10
10
 
11
11
  ```js
12
12
  import { Questionnaire, QuestionnaireNext, QuestionnairePrevious, QuestionnaireStep } from "@thebase/ui";
@@ -83,7 +83,7 @@ import { Questionnaire, QuestionnaireNext, QuestionnairePrevious, QuestionnaireS
83
83
  | `QuestionnaireStep` | `index` | `Number` | required |
84
84
  | `QuestionnaireStep` | `className` | `String` | optional |
85
85
 
86
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
86
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
87
87
 
88
88
  ## Static component
89
89
 
@@ -109,7 +109,7 @@ Interactive components emit documented `baseui:*` events from their root element
109
109
 
110
110
  ## CSS variables
111
111
 
112
- The component inherits BaseUI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
112
+ The component inherits the Base UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
113
113
 
114
114
  ## Accessibility behavior
115
115
 
@@ -121,7 +121,7 @@ See `examples/index.html` for a working CDN-style page.
121
121
 
122
122
  ## Browser support
123
123
 
124
- BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
124
+ The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
125
125
 
126
126
  ## Test checklist
127
127
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Native radio input or label wrapper.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { RadioGroup, RadioGroupItem } from "@thebase/ui";
@@ -28,7 +28,7 @@ import { RadioGroup, RadioGroupItem } from "@thebase/ui";
28
28
  | `RadioGroupItem` | `disabled` | `Boolean` | optional |
29
29
  | `RadioGroupItem` | `className` | `String` | optional |
30
30
 
31
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
31
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
32
32
 
33
33
  ## Static component
34
34
 
@@ -4,9 +4,9 @@ Use `b-ui="resizable"` for a CDN-ready resizable component.
4
4
 
5
5
  ## CDN install requirements
6
6
 
7
- Load the pinned BaseUI CSS and JavaScript files; no extra dependency is required for this component.
7
+ Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
8
8
 
9
- ## Pure Owl component
9
+ ## Base component
10
10
 
11
11
  ```js
12
12
  import { Resizable } from "@thebase/ui";
@@ -39,7 +39,7 @@ import { Resizable } from "@thebase/ui";
39
39
  | `Resizable` | `onChange` | `Function` | optional |
40
40
  | `Resizable` | `className` | `String` | optional |
41
41
 
42
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
42
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
43
43
 
44
44
  ## Static component
45
45
 
@@ -65,7 +65,7 @@ Interactive components emit documented `baseui:*` events from their root element
65
65
 
66
66
  ## CSS variables
67
67
 
68
- The component inherits BaseUI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
68
+ The component inherits the Base UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
69
69
 
70
70
  ## Accessibility behavior
71
71
 
@@ -77,7 +77,7 @@ See `examples/index.html` for a working CDN-style page.
77
77
 
78
78
  ## Browser support
79
79
 
80
- BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
80
+ The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
81
81
 
82
82
  ## Test checklist
83
83
 
@@ -4,9 +4,9 @@ Use `b-ui="scroll-area"` for a CDN-ready scroll area component.
4
4
 
5
5
  ## CDN install requirements
6
6
 
7
- Load the pinned BaseUI CSS and JavaScript files; no extra dependency is required for this component.
7
+ Load the pinned the Base UI CSS and JavaScript files; no extra dependency is required for this component.
8
8
 
9
- ## Pure Owl component
9
+ ## Base component
10
10
 
11
11
  ```js
12
12
  import { ScrollArea } from "@thebase/ui";
@@ -43,7 +43,7 @@ import { ScrollArea } from "@thebase/ui";
43
43
  | --- | --- | --- | --- |
44
44
  | `ScrollArea` | `className` | `String` | optional |
45
45
 
46
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
46
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
47
47
 
48
48
  ## Static component
49
49
 
@@ -69,7 +69,7 @@ Interactive components emit documented `baseui:*` events from their root element
69
69
 
70
70
  ## CSS variables
71
71
 
72
- The component inherits BaseUI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
72
+ The component inherits the Base UI semantic tokens such as `--b-surface`, `--b-border`, `--b-primary`, and `--b-radius`.
73
73
 
74
74
  ## Accessibility behavior
75
75
 
@@ -81,7 +81,7 @@ See `examples/index.html` for a working CDN-style page.
81
81
 
82
82
  ## Browser support
83
83
 
84
- BaseUI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
84
+ The Base UI targets modern evergreen browsers that support ES modules, CSS variables, and Bootstrap 5.3.
85
85
 
86
86
  ## Test checklist
87
87
 
@@ -1,6 +1,6 @@
1
1
  # Select
2
2
 
3
- ## Pure Owl component
3
+ ## Base component
4
4
 
5
5
  ```js
6
6
  import { Select, SelectContent, SelectItem, SelectTrigger } from "@thebase/ui";
@@ -29,7 +29,7 @@ import { Select, SelectContent, SelectItem, SelectTrigger } from "@thebase/ui";
29
29
  | `SelectItem` | `className` | `String` | optional |
30
30
  | `SelectTrigger` | `className` | `String` | optional |
31
31
 
32
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
32
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
33
33
 
34
34
  ## Static component
35
35
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Visual divider with separator semantics.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { Separator } from "@thebase/ui";
@@ -30,7 +30,7 @@ import { Separator } from "@thebase/ui";
30
30
  | `Separator` | `orientation` | `String` | optional |
31
31
  | `Separator` | `className` | `String` | optional |
32
32
 
33
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
33
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
34
34
 
35
35
  ## Static component
36
36
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Use `b-ui="sheet"` for offcanvas panels.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger } from "@thebase/ui";
@@ -38,7 +38,7 @@ import { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHe
38
38
  | `SheetTitle` | `className` | `String` | optional |
39
39
  | `SheetTrigger` | `className` | `String` | optional |
40
40
 
41
- `SheetContent` also accepts `side` (`"left"` or the default right), falling back to the `side` prop on the parent `Sheet` when unset. It is driven by a real `bootstrap.Offcanvas` instance bound to its own root, rendered as `.offcanvas.offcanvas-end` by default or `.offcanvas.offcanvas-start` for `side="left"`, permanently mounted rather than added/removed from the DOM. Escape, backdrop click, and the Tab focus trap are Bootstrap's own native Offcanvas behavior; focus-restore-to-trigger on close is kept by hand (not native to Offcanvas). `SheetClose` closes via `data-bs-dismiss="offcanvas"`. See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
41
+ `SheetContent` also accepts `side` (`"left"` or the default right), falling back to the `side` prop on the parent `Sheet` when unset. It is driven by a real `bootstrap.Offcanvas` instance bound to its own root, rendered as `.offcanvas.offcanvas-end` by default or `.offcanvas.offcanvas-start` for `side="left"`, permanently mounted rather than added/removed from the DOM. Escape, backdrop click, and the Tab focus trap are Bootstrap's own native Offcanvas behavior; focus-restore-to-trigger on close is kept by hand (not native to Offcanvas). `SheetClose` closes via `data-bs-dismiss="offcanvas"`. See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
42
42
 
43
43
  ## Static component
44
44
 
@@ -53,6 +53,6 @@ import { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHe
53
53
 
54
54
  At mount, `[b-ui="sheet"]` itself becomes the `.offcanvas.offcanvas-end` element (`.offcanvas.offcanvas-start` when `b-att-side="left"`, `tabindex="-1"`) driven by a real `bootstrap.Offcanvas` instance (`backdrop: true, keyboard: true, scroll: false`); `[b-sheet-panel]` stays as a plain cosmetic content box inside it. `[b-sheet-close]` buttons get `data-bs-dismiss="offcanvas"` at mount time instead of a manual click handler.
55
55
 
56
- Events: `baseui:open`, `baseui:close` (BaseUI), plus the underlying `shown.bs.offcanvas`/`hidden.bs.offcanvas`.
56
+ Events: `baseui:open`, `baseui:close` (the Base UI), plus the underlying `shown.bs.offcanvas`/`hidden.bs.offcanvas`.
57
57
 
58
58
  Options: `b-att-side="left"` moves the sheet panel to the left (`offcanvas-start` instead of `offcanvas-end`). The sheet closes on backdrop click, close button (`data-bs-dismiss="offcanvas"`), or Escape — all native `bootstrap.Offcanvas` behavior — and traps Tab focus while open, restoring focus to the trigger on close (kept by hand — not native to Offcanvas).
@@ -2,7 +2,7 @@
2
2
 
3
3
  Use `b-ui="shell"` for a collapsible app shell: a desktop-collapsible/mobile off-canvas sidebar next to a sticky header and scrollable content region.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import {
@@ -74,7 +74,7 @@ Four cross-cutting concerns are opt-in via props instead of baked into the layou
74
74
  | `ShellContent` | `className` | `String` | optional |
75
75
  | `ShellUserMenu` | `className` | `String` | optional |
76
76
 
77
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
77
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
78
78
 
79
79
  ## Static component
80
80
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Use `b-ui="sidebar"` for app navigation panels. The component mirrors shadcn's composable Sidebar parts: header, content, footer, groups, menu rows, actions, nested submenus, rail, inset, and trigger.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { Sidebar, SidebarContent, SidebarFooter, SidebarHeader, SidebarMenu, SidebarMenuButton, SidebarMenuItem } from "@thebase/ui";
@@ -234,7 +234,7 @@ Reusable nav-content primitives, extracted from the recurring group/item shapes
234
234
  | `SidebarMenuSubButton` | `href` | `String` | optional |
235
235
  | `SidebarMenuSubItem` | `className` | `String` | optional |
236
236
 
237
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
237
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
238
238
 
239
239
  ## Static component
240
240
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Loading placeholder for content that is not ready yet.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { Skeleton } from "@thebase/ui";
@@ -29,7 +29,7 @@ import { Skeleton } from "@thebase/ui";
29
29
  | `Skeleton` | `shape` | `String` | optional |
30
30
  | `Skeleton` | `className` | `String` | optional |
31
31
 
32
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
32
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
33
33
 
34
34
  ## Static component
35
35
 
@@ -1,6 +1,6 @@
1
1
  # Slider
2
2
 
3
- ## Pure Owl component
3
+ ## Base component
4
4
 
5
5
  ```js
6
6
  import { Slider } from "@thebase/ui";
@@ -22,7 +22,7 @@ import { Slider } from "@thebase/ui";
22
22
  | `Slider` | `className` | `String` | optional |
23
23
  | `Slider` | `onChange` | `Function` | optional |
24
24
 
25
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
25
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
26
26
 
27
27
  ## Static component
28
28
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Inline loading indicator using Bootstrap spinner classes.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { Spinner } from "@thebase/ui";
@@ -24,7 +24,7 @@ import { Spinner } from "@thebase/ui";
24
24
  | `Spinner` | `label` | `String` | optional |
25
25
  | `Spinner` | `className` | `String` | optional |
26
26
 
27
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
27
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
28
28
 
29
29
  ## Static component
30
30
 
@@ -35,4 +35,4 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
35
35
 
36
36
  Options: `b-att-type="border|grow"`, `b-att-label`.
37
37
 
38
- Accessibility: BaseUI adds `role="status"` and hidden loading text.
38
+ Accessibility: The Base UI adds `role="status"` and hidden loading text.
@@ -2,7 +2,7 @@
2
2
 
3
3
  Checkbox-backed switch control using `role="switch"`.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { Switch } from "@thebase/ui";
@@ -21,7 +21,7 @@ import { Switch } from "@thebase/ui";
21
21
  | `Switch` | `className` | `String` | optional |
22
22
  | `Switch` | `onChange` | `Function` | optional |
23
23
 
24
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
24
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
25
25
 
26
26
  ## Static component
27
27
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Native table styling for static or server-rendered data.
4
4
 
5
- ## Pure Owl component
5
+ ## Base component
6
6
 
7
7
  ```js
8
8
  import { Table } from "@thebase/ui";
@@ -50,7 +50,7 @@ import { Table } from "@thebase/ui";
50
50
  | `Table` | `hover` | `Boolean` | optional |
51
51
  | `Table` | `className` | `String` | optional |
52
52
 
53
- See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
53
+ See [Base Components](/examples/blocks.html#/docs/guide/owl-components) for how to load `@base/owl` and `dist/baseui.templates.xml`.
54
54
 
55
55
  ## Static component
56
56