@thebase/ui 1.0.0 → 1.1.0

package/dist/baseui.registry.json

@@ -18,6 +18,8 @@
     "baseui.icons.esm.js",
     "baseui.templates.xml",
     "baseui.block-viewer.esm.js",
+    "baseui.analytics.esm.js",
+    "baseui.analytics.min.js",
     "icons/lucide.json"
   ],
   "icons": {
@@ -1660,11 +1662,13 @@
   "integrity": {
     "baseui.min.css": "sha384-hYFwlV6T/ONYzawtDGDFUoruqgNwYl9AVvLDHx24IWgKSMXqwACo/nX04I3gnyT9",
     "bootstrap.bundle.min.js": "sha384-RMbllTJcplkCRnELNTOc5Kz/3AvFDE/rNlJqWqfgmRWruobClBdfwvl10akQZkR1",
-    "baseui.min.js": "sha384-dgJ6Mbk5+apdFpV1iU/Lnp4CQWZXgBpsUn3r7oh8DHH2rNqIqNmsHKPVub5ZEq+D",
-    "baseui.esm.js": "sha384-AP0mGX4n1avSDWoAUakm71/JAR0vvd6n2qR39RI8nssDriB8lhN4wXZijA6XfVeJ",
-    "baseui.icons.esm.js": "sha384-M30zHGB1h8ys1b2YBuLR7J3VzcYqft9L+wVI/EM1P8h8fY5Y2h1woOQzyE5DZ+lp",
+    "baseui.min.js": "sha384-jzPn6U5dm/0jM9kcSMnDNOiDWLfdN4h28z+YRNYU/IbGmMf4nFTSVsTn6siJ+UHH",
+    "baseui.esm.js": "sha384-I61E5GCJymEsiX5xmIe5Ufd498zcuzGIWwu79WfKg1IKbtACkeC3LG1QXbIq/5cT",
+    "baseui.icons.esm.js": "sha384-hj39VMhzcFvmYnjob2hlioMOAqwAXCURGreF6s9RitXFp/iYi7rUdqtfCI+ICQeS",
     "baseui.templates.xml": "sha384-XkqmfurKcEF6WuIQHWAbnZfW6oz19n7SDVRDU3g0hc3qOr4kPd/qfNGcTmcDDIgQ",
-    "baseui.block-viewer.esm.js": "sha384-rQ7YMxLWDA+ccC/JwTcOV8DKUjZTZofqJwNX8xrKTpZbsBVRa4taXLOLpRQ6poR4",
+    "baseui.block-viewer.esm.js": "sha384-XlIb3jDxt6Q75dbC4rLctTdPU6u0vJFcbxp9Gl6VKOkhjpz3wRBe0E3dWd80425L",
+    "baseui.analytics.esm.js": "sha384-M7jEmmio32O8iquXxQjhCbfEAqZAkHG+a1+Wt6sajMFCubQDzEx7QQMMpek0QxY6",
+    "baseui.analytics.min.js": "sha384-aD3A1qm15yTTviPHRscI2enlOIHp7SaIdr+KBCBTgjChn23ZfEsOvY7izOB+hUZe",
     "icons/lucide.json": "sha384-mc5mzpmq9eOgZVa2IcjrL33Ty4nMXE8aoZMfy+lgkC/jMQ4aYnk2S58mFsSGFnW1",
     "themes/baseui-light.css": "sha384-/TosvycgVJ5aZ7EOWd4cr8Zen4nayAC/iA9BgGdXKH0LuHSnZk4guDaWM5WPC7yy",
     "themes/baseui-dark.css": "sha384-zF9Rhfjpv90sxuJ2WK7GBPCltN6mkebzK1w9EzQGY9DYHiX3eIX/fcE7fXzfIZVF"

package/dist/types/analytics.d.ts

@@ -0,0 +1,65 @@
+/** Cookieless analytics service (ported from @plausible-analytics/tracker 0.4.6). */
+export interface BaseUIAnalytics {
+  /** Sets up the tracker. Can be called once. */
+  init(config: BaseUIAnalyticsConfig): void;
+  /** Tracks an event; requires `init` to be called first. */
+  track(eventName: string, options?: BaseUIAnalyticsEventOptions): void;
+  /** File types tracked by default when `fileDownloads` is enabled. */
+  DEFAULT_FILE_TYPES: string[];
+}
+
+export interface BaseUIAnalyticsConfig {
+  /** Analytics backend origin, e.g. "https://stats.example.com" — events go to `<backendUrl><apiPath>`. Required unless `endpoint` is given. */
+  backendUrl?: string;
+  /** Path appended to `backendUrl`. Defaults to "/api/event". */
+  apiPath?: string;
+  /** Full event URL (http(s):// or a same-site /path); overrides `backendUrl` and `apiPath`. */
+  endpoint?: string;
+  /** Site name reported with every event. Defaults to `location.hostname`. */
+  domain?: string;
+  /** Capture pageviews automatically (incl. pushState/popstate). Defaults to true. */
+  autoCapturePageviews?: boolean;
+  /** Page uses hash-based routing. Defaults to false. */
+  hashBasedRouting?: boolean;
+  /** Track outbound link clicks. Defaults to false. */
+  outboundLinks?: boolean;
+  /** Track file downloads, optionally with a custom extension list. Defaults to false. */
+  fileDownloads?: boolean | { fileExtensions: string[] };
+  /** Track form submissions. Defaults to false. */
+  formSubmissions?: boolean;
+  /** Capture events on localhost. Defaults to false. */
+  captureOnLocalhost?: boolean;
+  /** Log ignored events to the console. Defaults to true. */
+  logging?: boolean;
+  /** Properties added to every event, or a function returning them per event name. */
+  customProperties?: Record<string, string> | ((eventName: string) => Record<string, string>);
+  /** Rewrite the payload before sending; return a falsy value to drop the event. */
+  transformRequest?: (payload: BaseUIAnalyticsPayload) => BaseUIAnalyticsPayload | null;
+  /** Bind the tracker to `window.thebase.track`. Defaults to true. */
+  bindToWindow?: boolean;
+}
+
+export interface BaseUIAnalyticsEventOptions {
+  props?: Record<string, string>;
+  /** Non-interactive events don't count towards bounce rate. Defaults to true. */
+  interactive?: boolean;
+  revenue?: { amount: number | string; currency: string };
+  /** Called with `{ status }`, `{ error }`, or undefined when the event was ignored. */
+  callback?: (result?: { status: number } | { error: unknown }) => void;
+  /** Overrides the page URL (defaults to `location.href`). */
+  url?: string;
+}
+
+export type BaseUIAnalyticsPayload = {
+  n: string;
+  u: string;
+  d: string;
+  r?: string | null;
+  p?: Record<string, string>;
+  $?: { amount: number | string; currency: string };
+  i?: boolean;
+} & Record<string, unknown>;
+
+export const DEFAULT_FILE_TYPES: string[];
+export function init(config: BaseUIAnalyticsConfig): void;
+export function track(eventName: string, options?: BaseUIAnalyticsEventOptions): void;

package/dist/types/index.d.ts

@@ -25,6 +25,10 @@ export interface BaseUIApi {
     };
   };
   theme: { set(modeOrTokens: string | Record<string, string>): void };
+  /** Set by dist/baseui.analytics.min.js (the optional analytics service). */
+  analytics?: import("./analytics").BaseUIAnalytics;
+  /** Bound by `analytics.init()` (unless `bindToWindow: false`). */
+  track?: import("./analytics").BaseUIAnalytics["track"];
 }
 
 export interface BaseUIThemeController {

package/docs/analytics.md

@@ -0,0 +1,77 @@
+# 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.
+
+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):
+
+```js
+// npm / bundler
+import { init, track } from "@thebase/ui/analytics";
+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.0/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.0/dist/baseui.analytics.min.js"></script>
+<script>
+  thebase.analytics.init({ backendUrl: "https://stats.example.com" });
+</script>
+```
+
+Types ship as `dist/types/analytics.d.ts` (resolved automatically for `@thebase/ui/analytics`).
+
+`init()` can be called once. It sends the first pageview, then follows `history.pushState`/`popstate` navigations (or `hashchange` with `hashBasedRouting: true`).
+
+## Options
+
+| Option | Default | Effect |
+| --- | --- | --- |
+| `backendUrl` | required¹ | Analytics backend origin, e.g. `https://stats.example.com`. Events are POSTed (`text/plain` JSON, no CORS preflight) to `<backendUrl><apiPath>`; a trailing `/` is fine. |
+| `apiPath` | `/api/event` | Path appended to `backendUrl` (leading `/` optional), e.g. `/v1/collect`. |
+| `endpoint` | — | Full event URL instead of `backendUrl` + `apiPath` (`http(s)://…` or a same-site `/path`, e.g. behind a proxy). |
+| `domain` | `location.hostname` | Site name reported with every event. |
+| `autoCapturePageviews` | `true` | Send pageviews automatically. |
+| `hashBasedRouting` | `false` | Treat `#` changes as navigations. |
+| `outboundLinks` | `false` | Track clicks on links to other hosts as `Outbound Link: Click`. |
+| `fileDownloads` | `false` | Track download links as `File Download`; pass `{ fileExtensions: [...] }` to replace `analytics.DEFAULT_FILE_TYPES`. |
+| `formSubmissions` | `false` | Track valid form submits as `Form: Submission`. |
+| `captureOnLocalhost` | `false` | Also send from `localhost`/`127.x`/`file:`. |
+| `logging` | `true` | `console.warn` when an event is ignored. |
+| `customProperties` | — | Props added to every event (object, or `(eventName) => object`). |
+| `transformRequest` | — | Rewrite the payload; return a falsy value to drop the event. |
+| `bindToWindow` | `true` | Bind the tracker to `window.thebase.track`. |
+
+¹ One of `backendUrl` or `endpoint` is required. `init()` throws if neither is given, or if the URL has no `http(s)://` scheme and doesn't start with `/` (e.g. `stats.example.com`), since that would silently post to a path on your own site.
+
+Your backend should answer with `Access-Control-Allow-Origin` for your site. The event is delivered either way (there is no preflight), but without that header the browser hides the response and `callback` receives `{ error }`.
+
+## Custom events
+
+```js
+thebase.track("Signup", { props: { plan: "pro" }, revenue: { amount: 10, currency: "USD" } });
+```
+
+`track(name, options)` accepts `props`, `revenue`, `interactive: false` (excluded from bounce rate), `url` (override the page URL), and `callback(result)` — called with `{ status }`, `{ error }`, or `undefined` when the event was ignored.
+
+Or tag markup with classes — no JavaScript needed:
+
+```html
+<button class="thebase-event-name=Signup thebase-event-plan=pro">Sign up</button>
+<form class="thebase-event-name=Lead">...</form>
+```
+
+`+` in a class value becomes a space; `thebase-revenue-amount=10 thebase-revenue-currency=USD` attaches revenue.
+
+## Engagement
+
+After each pageview the service measures time on screen and maximum scroll depth, and sends an `engagement` event (`e` = ms, `sd` = %) when the tab is hidden, loses focus, or navigates — only if the visitor scrolled further or spent at least 3 seconds since the last report.
+
+## Ignored visits
+
+Events are dropped (and `callback()` gets `undefined`) on localhost unless `captureOnLocalhost` is set, in automated browsers (`navigator.webdriver`, Cypress, PhantomJS, Nightmare — unless `window.__thebase` is set), or when `localStorage.thebase_ignore === "true"` (set that on your own devices to exclude them).

package/docs/blocks.md

@@ -13,7 +13,7 @@ Blocks are not standalone runtime components. Paste the markup and load the norm
 <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.0.0`, or `@1` to take only non-breaking updates) instead of `@latest` for production. Blocks are static markup, so they only need the static `b-ui` runtime above — see [Usage Guide](usage-guide.md) if the surrounding page is itself an 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.0`, or `@1` to take only non-breaking updates) instead of `@latest` for production. Blocks are static markup, so they only need the static `b-ui` runtime above — see [Usage Guide](usage-guide.md) if the surrounding page is itself an Owl app and you'd rather compose the equivalent layout from [Pure Owl Components](owl-components.md).
 
 Use `b-block` to select the block style:
 

package/docs/components/avatar.md

@@ -37,7 +37,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -45,7 +45,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -69,4 +69,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/block-viewer.md

@@ -37,7 +37,7 @@ import { BlockViewer } from "@base/component";
 </body>
 ```
 
-`BaseUI.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 Owl app, using the block's own inline template as its live preview and its serialized text as the "Code" panel.
 
 ## Options and attributes
 
@@ -49,4 +49,4 @@ See `dist/baseui.registry.json` for the full attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.

package/docs/components/calendar.md

@@ -36,7 +36,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -44,7 +44,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -68,4 +68,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/carousel.md

@@ -86,7 +86,7 @@ The static adapter builds the `.carousel-inner`/`.carousel-item` wrapper structu
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -94,7 +94,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -118,4 +118,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/chart.md

@@ -94,7 +94,7 @@ See `examples/charts/area.html` for the local copy of the shadcn area chart gall
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -102,7 +102,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -126,4 +126,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/combobox.md

@@ -43,7 +43,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -51,7 +51,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -75,4 +75,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/command.md

@@ -46,7 +46,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -54,7 +54,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -78,4 +78,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/context-menu.md

@@ -48,7 +48,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -56,7 +56,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -80,4 +80,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/data-table.md

@@ -74,7 +74,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -82,7 +82,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -154,4 +154,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/date-picker.md

@@ -36,7 +36,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -44,7 +44,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -68,4 +68,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/icon.md

@@ -46,8 +46,8 @@ For install patterns, accessibility guidance, self-hosting, and JavaScript examp
 ## JavaScript API
 
 ```js
-BaseUI.icons.lucide.url("panel-left");
-BaseUI.icons.lucide.render(document.querySelector("#icon"), "check", { size: "18px" });
+thebase.icons.lucide.url("panel-left");
+thebase.icons.lucide.render(document.querySelector("#icon"), "check", { size: "18px" });
 ```
 
 By default, icon URLs point to `https://cdn.jsdelivr.net/npm/lucide-static@1.31.0/icons`. The build also publishes every SVG under `dist/icons/lucide/` plus a generated `dist/icons/lucide.json` manifest for self-hosted CDN deployments.

package/docs/components/input-otp.md

@@ -36,7 +36,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -44,7 +44,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -68,4 +68,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/input.md

@@ -49,11 +49,11 @@ Load `baseui.min.css` and `baseui.min.js`.
 
 ## Enhanced usage
 
-Input is a static component. It can be mounted by `BaseUI.mountAll()` with no extra JavaScript.
+Input is a static component. It can be mounted by `thebase.mountAll()` with no extra JavaScript.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 

package/docs/components/markdown.md

@@ -1,6 +1,6 @@
 # Markdown
 
-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.BaseUI`, e.g. `dist/baseui.min.js`).
+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`).
 
 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.
 
@@ -118,4 +118,4 @@ See `dist/baseui.registry.json` for the full attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.

package/docs/components/message-scroller.md

@@ -58,7 +58,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -66,7 +66,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -90,4 +90,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/message.md

@@ -51,7 +51,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -59,7 +59,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -83,4 +83,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/popover.md

@@ -53,7 +53,7 @@ The static adapter reads `[b-popover-content]` once at mount time as the popover
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -61,7 +61,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -85,4 +85,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/questionnaire.md

@@ -93,7 +93,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -101,7 +101,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -125,4 +125,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/resizable.md

@@ -49,7 +49,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -57,7 +57,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -81,4 +81,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.

package/docs/components/scroll-area.md

@@ -53,7 +53,7 @@ See [Pure Owl Components](/examples/blocks.html#/docs/guide/owl-components) for
 
 ## Enhanced usage
 
-Call `BaseUI.mount(element)` or rely on `BaseUI.mountAll()` after the script loads.
+Call `thebase.mount(element)` or rely on `thebase.mountAll()` after the script loads.
 
 ## Options and attributes
 
@@ -61,7 +61,7 @@ See `dist/baseui.registry.json` for the supported attribute list.
 
 ## Methods
 
-Use the global runtime methods: `BaseUI.mount()`, `BaseUI.mountAll()`, and `BaseUI.destroy()`.
+Use the global runtime methods: `thebase.mount()`, `thebase.mountAll()`, and `thebase.destroy()`.
 
 ## Events
 
@@ -85,4 +85,4 @@ BaseUI targets modern evergreen browsers that support ES modules, CSS variables,
 
 ## Test checklist
 
-Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `BaseUI.destroy()`.
+Verify light and dark themes, keyboard access for focusable controls, disabled or readonly states when applicable, and cleanup through `thebase.destroy()`.