@thebase/ui 1.2.1 → 1.3.0

package/CHANGELOG.md

@@ -1,271 +1,34 @@
 # Changelog
 
-All notable changes to this project are documented in this file.
-
-## [v1.2.1] - 2026-10-30
-
-### Added
-- Optional standalone i18n service (`@thebase/ui/i18n`, `dist/baseui.i18n.esm.js` / `.min.js`, `window.thebase.i18n`), extracted from `emvhub/i18n.js` and configurable through `init({ languages, defaultLanguage, storageKey, queryParam, catalogDir })`. See `docs/i18n.md`. `emvhub/i18n.js` is now a thin adapter that calls `init()` and re-exports it.
-- `docs/i18n.md` (install, quick start, `.po` catalogs, language detection order, API) and the runnable example in `examples/i18n/`; `test/i18n.test.js` covers the service. The `./i18n` export and `dist/baseui.i18n.*` files are listed in `package.json` `files`/`exports`.
-
-### Changed
-- Version pins in README, docs, emvhub, qr-page, momo_demo and the skill references moved to `@1.2.1`. No breaking changes; existing `emvhub/i18n.js` imports keep working.
-
-## [v1.2.0] - 2026-10-29
-
-### Breaking
-- Component CSS classes renamed from the `bu-` prefix to `b-` (e.g. `bu-button` -> `b-button`, `bu-dialog-title` -> `b-dialog-title`), and the matching custom properties from `--bu-*` to `--b-*` (e.g. `--bu-badge-bg` -> `--b-badge-bg`, `--bu-code-*` -> `--b-code-*`). Update any app CSS, markup (`class="bu-..."`) or selectors that target the old names. Helper attributes (`b-ui`, `b-att-*`, `b-tab`, ...) are unchanged; `.b-x` class selectors never match `[b-x]` attributes. Applied with `scripts/rename-bu-prefix.mjs`.
-
-### Changed (themes)
-- New status colour tokens `--b-success`, `--b-warning`, `--b-info` (each with `-rgb` and `-foreground`) in both theme files, alongside the existing `--b-danger`; bridged to Bootstrap's `--bs-success|warning|info` (+ `-bg-subtle`, `-border-subtle`, `-text-emphasis`) so badges, alerts and Bootstrap helpers follow them, with `.btn-success|warning|info` restyled to match. The Theme tab can customise all four status colours.
-- `src/styles/baseui.css` is removed. All Base UI styles and shared tokens (spacing/type/radius scales, shadows, `--bs-*` bridge, button variants, font) now live in `src/styles/base-extensions.css`; `base.min.css` stays stock Bootstrap 5. Colour tokens, `--base-radius` and `--b-overlay` are defined only in `src/themes/baseui-light.css` and `baseui-dark.css`, which users can download and edit. `dist/themes/baseui-*.css` are now readable copies; minified versions are `baseui-*.min.css` (also listed in the registry).
-- `docs/theming.md` documents the new layout and how to build a custom theme.
-
-### Fixed (contrast)
-- `Switch`: the thumb was Bootstrap's fixed-colour SVG (25% black unchecked, white checked), nearly invisible in dark mode, and the pure Base `<Switch>` (no `b-ui` attribute) was not reached by any of the component's CSS. Styles now target `.b-switch`, and the thumb is drawn from theme tokens (`--b-muted-foreground` unchecked, `--b-primary-foreground` checked) with a visible track edge, focus ring uses `--b-ring`.
-- Light `--b-muted-foreground` is `neutral-600` (was `neutral-500`, 4.35:1 on muted fills); light `--b-danger` is `red-700` (the old red was under 4.5:1 as text on its own tint). Status text (`alert-success|warning`, `badge` success/warning/info/danger, clipboard "copied") uses `-text-emphasis` tones that clear 4.5:1. Disabled pagination items (the "..." ellipsis) no longer drop to 55% opacity.
-- Themes now set `--bs-body-bg-rgb`, `--bs-secondary-bg-rgb`, `--bs-tertiary-bg-rgb` and `--bs-emphasis-color-rgb`, so Bootstrap's `bg-body`, `bg-body-secondary`, `bg-body-tertiary` and `text-body-emphasis` follow the Base UI theme (and custom themes from the Theme tab) in light and dark.
-- `Button` corner radius uses `--b-radius-md` (was a fixed 8px spacing value), so it follows `--base-radius` and the Theme tab radius setting; identical at the default radius. `Switch` is laid out as a two-column grid so the track, label and helper text align in the pure Base and static versions.
-- Theme tab: colour selection buttons are 1.5rem.
-
-### Added
-- Theme tab in the examples app (`examples/index.html#/theme`): choose base colour, accent and radius, preview Base UI live in light/dark, then download `baseui-light.css` and `baseui-dark.css`.
-- `@thebase/ui/vite`: `baseuiPwa()` Vite plugin. Scaffolded projects (`create`, `init`) now build as PWAs by default: each `vite build` emits `manifest.webmanifest`, `sw.js`, `sw-register.js`, `version.json` (bundle hash) and default icons, and open pages reload when a deploy changes the code.
-- `@thebase/ui/pwa`: generated service workers poll `version.json` (activate, navigation, `check-version` message) and post `version-changed` after wiping caches; new `buildVersionJson` and `buildServiceWorkerRegister`; `cdnVersion` is now optional. `create-baseui-app pwa` also writes `sw-register.js` and `version.json`.
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `b-*` classes, in both pure Base templates and static adapters; `b-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `b-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- `base-extensions.css`: Bootstrap's own `.accordion`, `.dropdown-menu`, `.nav`/`.nav-tabs`/`.nav-pills`, `.navbar`, `.progress`, `.list-group`, `.toast`, `.input-group-text`, `.form-label`/`.form-text`/`.form-range`/feedback, `.placeholder`, `.btn-close`, carousel and `.img-thumbnail` are now restyled to the shadcn look via their `--bs-*` variables, so plain Bootstrap markup matches Base UI.
-- `Badge` and `Alert` CSS now set their look through Bootstrap's own `--bs-badge-*` / `--bs-alert-*` variables (size, weight, padding, radius, colour, border) instead of redeclaring `padding`, `font-size`, `color` and `border-color` directly. Badge variants set `--bs-badge-color` plus the new `--b-badge-bg`/`--b-badge-border`. Class names, markup and rendered look are unchanged; `b-badge-*` and `b-alert-*` stay the public API.
-
-## [v1.1.7] - 2026-10-18
-
-### Added
-- `CodeEditor` (pure Base): code box with line numbers, syntax colouring, Tab/Enter indent handling and a copy button, for the language named by the `codeLang` prop (go, c, cpp, java, javascript, typescript, python, rust, sql, json, yaml, css, html, lua, and more). Code can be loaded from a URL (`src`) or a local file (`upload`), with the language picked from the file extension. An **Edit/View** button toggles reading and editing mode (`readonly` sets the starting mode, `toggle="false"` hides the button). A **Format** button (and `Shift+Alt+F`) re-indents code per language (JSON is pretty-printed; bracket languages, Lua, HTML and XML re-indented). Syntax colouring follows `codeLang` (keywords, builtins, function calls, types, strings, numbers, comments, HTML/XML tags, attributes and entities, JSON/YAML keys, CSS properties and colours, annotations, `$variables`) with themeable `--bu-code-*` colours for light and dark. Built from `Badge`, `ClipboardButton`, `Kbd`, `Button`, `Alert` and `Spinner`; docs at `docs/components/code-editor.md` and a Blocks gallery demo (`examples/blocks/code-editor-demo.html`).
-- `Input` accepts `start` and `end` slots, and `Textarea` accepts `start`, `end` and `footer` slots, for text, icons, `Kbd` and `Button` inside the field.
-
-### Changed
-- `Shell` and `Sidebar` switch to the off-canvas mobile drawer below 992px (was 768px), so tablets get the drawer.
-- `NavigationMenu` scrolls horizontally under 768px with an edge fade and no scrollbar.
-- `Markdown` gives task-list checkboxes an accessible name and larger touch targets on coarse pointers.
-- `useTip` tooltip icon now sits right after the label text (circle-question-mark) instead of floating at the field edge.
-- Docs and examples: production pin examples now use `@1.1.7`; `qr-page` service-worker cache bumped to `2qr-cache-v14`.
-
-### Fixed
-- `Chart` bars no longer collapse to 2px lines: the plot has a definite height and each bar is positioned from the bottom of its column.
-
-### Removed
-- **Breaking:** `InputGroup`, `InputGroupAddon`, `InputGroupButton`, `InputGroupText`, `InputGroupInput` and `InputGroupTextarea`, the static `b-ui="input-group"` adapter, and the `input-group` docs page and demo. Migrate to `Input`/`Textarea` slots: `<Input label="'Search'"><t t-set-slot="end"><Button size="'xs'">Go</Button></t></Input>`; a textarea with a send bar becomes `<Textarea><t t-set-slot="footer">…</t></Textarea>`.
-
-## [v1.1.6] - 2026-10-17
-
-### Added
-- `useTip` prop (`Number`, default `0`) on `Input`, `Textarea`, `NativeSelect`, `Combobox`, `DatePicker`, `Select`, `InputGroup` and `Field`: set to `1` to hide the helper text under the field and show it in a tooltip on an info icon instead. Error text always stays visible. See the matching pages under `docs/components/`.
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- Focus ring is unified across form controls: `Checkbox`, `Switch`, `RadioGroup`, `InputOTP`, `Select` and the outlined fields now use `--b-primary` as border plus a 1px `--b-primary` ring, matching `Input`.
-- `Tabs`: trigger content is packed to the start (and to the end in right-to-left text).
-- Docs and examples: production pin examples now use `@1.1.6`; `qr-page` service-worker cache bumped to `2qr-cache-v13`.
-
-## [v1.1.5] - 2026-10-17
-
-### Added
-- Material outlined style is now shared by every input-like control: `Input`, `Textarea`, `NativeSelect`, `Combobox`, `DatePicker`, `Select` and `InputGroup` accept `label`, `supportingText`, `errorText`, `invalid` (and `leadingIcon`/`trailingIcon`/`maxLength` where they apply). The label rests inside and floats onto the border when focused or filled. Static `b-ui` adapters are unchanged. See the matching pages under `docs/components/`.
-- `labelBackground` prop (any CSS colour) on every outlined control and on `Field`, to match the floating label's cut-out to the surrounding surface.
-- `Field` accepts `label`, `description`, `error` and `invalid` and hands them to the control inside it.
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- `Field` no longer renders its own label and error text; the control inside draws them. Use `FieldLabel` / `FieldError` for checkbox-style fields.
-- Docs and examples: blocks (`field`, `textarea`, `date-picker`, `input-group`, `select`, `combobox`, `native-select`, `hover-card`, `login-03/04`, `signup-03/04`) use the `label` props; production pin examples now use `@1.1.5`; `qr-page` builds its VietQR/QR payload from CDN modules instead of vendored copies.
-- `package.json` description no longer mentions Owl.
-
-## [v1.1.4] - 2026-10-14
-
-Backfilled entry (1.1.4 shipped without release notes).
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- Tabs, Toast and style-prop rollout; internal `baseui` class prefix renamed to `bu`; docs and memory synced.
-
-## [v1.1.3] - 2026-10-13
-
-### Added
-- `ApiDoc` component (`b-ui="apidoc"` / pure Base `ApiDoc`): renders an OpenAPI 3 JSON document as browsable API documentation — grouped sidebar, per-operation parameters, request body, responses, callbacks, a Try It panel with request samples in 17 languages, and an Authorize dialog (API key, HTTP basic, bearer, OpenID Connect, OAuth2 flows). Props include `src`, `spec`, `serverUrl`, `theme`, `themeToggle`, `hash`, `operation`, `tryIt`, `authorize`, `languages`, `language`, `assetBase`, `oauthRedirectUri`, `height`; events `baseui:load`, `baseui:error`, `baseui:navigate`. Built from the Base UI's own `Button`, `Badge`, `Dialog`, `Tabs`, `Breadcrumb`, `Input`, `Textarea`, `NativeSelect` and `Checkbox`. See `docs/components/apidoc.md`.
-- `apidoc-01` block (full-page API reference) and the `examples/apidoc/` demo with a Petstore spec.
-- `Input`: Material-style outlined mode with `label`, `supportingText`, `errorText`, `leadingIcon`/`trailingIcon` and a `maxLength` counter (documented in `docs/components/input.md`).
-- PWA toolkit: default logo and favicon set (`dist/pwa-icons/`: `favicon.ico`, 16/32 px favicons, `apple-touch-icon.png`, `icon-192.png`, `icon-512.png`). `create-baseui-app pwa` copies it into `<path>/icons/` without overwriting existing files, and the default manifest icons and precache list point at it. New optional `iconsBase` (manifest + service worker) and `manifestUrl` (service worker) config keys.
-- Examples: the examples/landing site is now an installable, offline-capable PWA (`examples/pwa/`, generated from `baseui.pwa.config.js`). The service worker is served from `/examples-sw.js`; `deploy_landing.sh` stages it at the site root. New `momo_demo/` static `b-ui` business-admin demo.
-- Build: ApiDoc's language logos are copied to `dist/apidoc/img/` and published (`dist/apidoc` added to `package.json` `files`).
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- PWA toolkit: the default precache list no longer includes `/favicon.svg`; it precaches the default icon files instead.
-- `npm run dev` server: serves `.ico` as `image/x-icon` and `.mjs` as JavaScript.
-- Docs and examples: production pin examples now use `@1.1.3`; component counts in `docs/owl-components.md` and `docs/registry.md` now say 74.
-
-## [v1.1.2] - 2026-10-06
-
-Backfilled entry (1.1.2 shipped without release notes).
-
-### Added
-- PWA toolkit: `@thebase/ui/pwa` (`dist/baseui.pwa.esm.js`, types in `dist/types/pwa.d.ts`) exports `buildManifest` and `buildServiceWorker`.
-- `create-baseui-app` CLI: `create`, `init`, `convert` and `pwa` commands to scaffold a Base UI project and generate `manifest.webmanifest` + `sw.js`. See `docs/usage-guide.md` §5b and `docs/components/pwa.md`.
-- Examples: the landing page shows PWA install and visitor tracking (`examples/tracking.js`).
-
-## [v1.1.1] - 2026-10-04
-
-### Added
-- Analytics: `visitorContext()` export from `@thebase/ui/analytics` (and `window.thebase.analytics.visitorContext`). It returns the visitor's timezone (`tz`), browser language (`lang`) and a coarse screen bucket (`screen`: Mobile/Tablet/Laptop/Desktop). Pass it as `customProperties` to attach them to every event. Types are included as `BaseUIVisitorContext`. It's an additive export released as a patch by maintainer decision; nothing existing changed.
-- Docs: `docs/analytics.md` covers receiving events on your own backend (payload reference, Go Fiber v3 and FastAPI receivers), a "Sample dashboard" section, and "Visitor context". README has an Analytics section.
-- Examples: `examples/analytics/` contains a Base UI analytics dashboard plus runnable Go Fiber and FastAPI sample backends (in-memory store, `GET /api/stats`, `DEMO_SEED=1` demo data). The landing page has an Analytics section, and the docs nav lists the Analytics guide.
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- Docs and examples: production pin examples now use `@1.1.1`.
-- `npm run dev` server: folder URLs serve their `index.html`, and `.go`/`.py`/`.mod` sources are served as text.
-
-## [v1.1.0] - 2026-10-04
-
-### Added
-- Optional, standalone analytics service: `@thebase/ui/analytics`. Use `dist/baseui.analytics.esm.js`, or the `<script>` build `dist/baseui.analytics.min.js`, which sets `window.thebase.analytics`. It is not part of the main bundles and needs no other Base UI file. Start it with `init({ backendUrl })`: events go to `<backendUrl>/api/event` (change the path with `apiPath`), and `domain` defaults to `location.hostname`. Pass a full `endpoint` instead when routing through a proxy. A URL without a scheme throws instead of silently posting to your own site. It is a cookieless tracker ported from `@plausible-analytics/tracker` 0.4.6 and keeps that package's options and compact payload. It covers automatic and SPA pageviews, engagement (time on page and scroll depth), outbound links, file downloads, form submissions, `thebase-event-*` / `thebase-revenue-*` class tagging, the `localStorage.thebase_ignore` opt-out, `customProperties` and `transformRequest`. After `init()` the tracker is bound to `window.thebase.track`. Types are in `dist/types/analytics.d.ts`; see `docs/analytics.md`. The upstream MIT notice is in `LICENSE`.
-- The browser global is now `window.thebase`, holding the same object as before (`version`, `register`, `component`, `mount`, `mountAll`, `destroy`, `theme`, `icons`). If a page script creates `window.thebase` before a Base UI bundle loads, the runtime adds its methods to that object instead of replacing it.
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- Docs: production pin examples now use `@1.1.0`. `docs/installation.md` and `docs/registry.md` list the analytics bundles and the `@thebase/ui/analytics` export.
-
-### Deprecated
-- `window.BaseUI`: use `window.thebase` instead (e.g. `thebase.mountAll(...)`, `thebase.theme.set(...)`). It still points to the same object throughout 1.x and will be removed in 2.0.0. The ESM export `import { BaseUI } from "@thebase/ui"`, `window.BaseUITheme` and the `element.BaseUI*` handles are not affected.
-
-## [v1.0.0] - 2026-10-03
-
-First stable release. From here on the package follows [Semantic Versioning](https://semver.org/) — see the [Versioning policy](README.md#versioning-policy) for what counts as the public API and what each version bump means. No API changes versus v0.0.12 beyond the fixes below; upgrading from 0.0.12 needs no code changes.
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- Docs: production pin examples now use `@1.0.0`, or the `@1` major range to receive non-breaking updates. `docs/owl-components.md` documents the global component fallback below, and `docs/components/button.md` now lists `Button`'s `unstyled`, `attrs`, and `getRef` props.
-- Internal: shared prop and overlay helpers replace per-component copies (`optional()`/`slotProps` prop declarations, controlled-open and Bootstrap Collapse hooks, one binder for the static dialog/sheet/drawer overlays, one checkbox/radio enhancer). Every Base component keeps exactly the same props, and every static adapter keeps the same attributes, events, and `element.BaseUI*` handles.
-
-### Fixed
-- Pure Base: nested consumer components no longer crash with `Cannot find the definition of component "Icon"` (or `Button`, etc.) when their template uses a Base UI component missing from their own `static components`. `Component` from `@base/owl` now falls back to the globally registered the Base UI components for every component, not just the root passed to `mount()`. A component's own `static components` entries still take precedence.
-- `Sidebar`: `SidebarMenu` now fills the remaining panel height and scrolls on its own when its items overflow, so a long nav list no longer pushes `SidebarFooter` off-screen.
-
-## [v0.0.12] - 2026-09-13
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- **Breaking**: `Tabs` restyled to match [shadcn/base's Tabs](https://ui.shadcn.com/docs/components/base/tabs) — `TabsList` is now a segmented pill control on a muted background by default (new `variant="'line'"`/`b-att-variant="line"` opts into a transparent underline list instead), and `TabContent`/`b-panel` render as bare panels with no default `Card` border/background (that chrome is now opt-in via `className` on `TabsContainer` or the consumer's own wrapper). New `orientation` prop (`"horizontal"`/`"vertical"`) on the pure Base `Tabs` puts `TabsList` beside `TabsContainer` instead of above it.
-- Internal: every pure Base component's raw `<button>` (dialog, sheet, pwa, attachment, carousel, collapsible, calendar, dropdown-menu, popover, data-table, accordion, tabs, alert, input-group, sidebar, clipboard-button, theme-button, shell, questionnaire, alert-dialog, drawer, select, toggle, toggle-group) now renders through the shared `Button` component instead of hand-written markup. `Button` gained `unstyled` (opt out of forced `btn`/variant classes for components with their own bespoke styling), `attrs` (pass-through object for one-off attributes with no first-class prop), and `getRef` (reports the mounted root element for callers that need direct DOM access) to support this. No public prop-level API changes for any consuming component.
-
-### Added
-- `Toast`: new optional `action` slot (`<t t-set-slot="action">...</t>`, e.g. an "Undo" `<Button/>`) renders grouped tight against the close button on the trailing edge, matching the shadcn/ui toast layout. The toast root and static `[b-ui="toast"]` markup are now a flex row: wrap message content in `.bu-toast-content` (grows to fill available width) and the action/close controls in `.bu-toast-actions` (grouped on the trailing edge) — see `docs/components/toast.md` for the updated static markup. `Shell`'s `toast.actionLabel` now renders through the new `action` slot instead of inline in the default slot.
-
-## [v0.0.11] - 2026-09-03
-
-### Added
-- `Toast`/`b-ui="toast"`: new `position` option (`top-left`/`top-right`/`bottom-left`/`bottom-right`) fixes a toast to a screen corner; omit it for the previous inline-placement behavior.
-- Public `cn(...classNames)` and `mergeStyle(...)` helpers, exported from `@thebase/ui` (and `BaseUIBundle.cn`/`BaseUIBundle.mergeStyle`) for consumers building their own class lists or inline styles. Documented in `docs/runtime-api.md`.
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- **Breaking**: every CSS custom property has been renamed from the `--baseui-*` prefix to `--b-*` (e.g. `--baseui-primary` → `--b-primary`). Aligns the token prefix with the existing `--b1`/`--b2_5` spacing scale and `[b-ui]`/`b-att-*` attribute convention. `BaseUI.theme.set()` now writes/reads `--b-*` tokens; any consumer CSS that directly referenced `--baseui-*` must update to `--b-*`.
-- **Breaking**: every component CSS class has been renamed from the `baseui-*` prefix to `bu-*` (e.g. `.baseui-alert` → `.bu-alert`), to shorten it and avoid colliding with third-party `b-*`-prefixed conventions (e.g. Buefy) while staying distinct from the `b-ui`/`b-att-*` attribute and `--b-*` token conventions. Any consumer markup, CSS, or pure Base `className` override referencing `.baseui-*` must update to `.bu-*`. The bare `.baseui` root/theme-scope class, file names, the `BaseUI` global, the `@thebase/ui` package name, and `storageKey="'baseui-theme'"` are untouched.
-- Every component's class-name string-building now goes through the shared `cn()` helper instead of ad hoc `classes.push()/join(" ")` logic; the pure Base `Toast`'s close control now composes the real `Button` component instead of a raw `<button>`.
-
-## [v0.0.10] - 2026-09-02
-
-### Fixed
-- `TextEditor`/`b-ui="text-editor"`: found the actual root cause of the `MilkdownError: Context "editorState" not found, do you forget to inject it?` crash in collaborative mode (`collaborative="true"`), which the v0.0.9 fix below reduced the odds of but did not eliminate. `@milkdown/plugin-collab`'s own teardown only removes its Milkdown ctx slice — it never calls `CollabService.disconnect()` — so the y-prosemirror sync/cursor/undo plugins `.connect()` installs into the ProseMirror view were never uninstalled when a collaborative `TextEditor` was destroyed. Left connected, they kept reacting to further Yjs doc updates (from any peer sharing the doc/room) and kept dispatching transactions into the already-destroyed view, throwing `Context "..." not found` for whichever internal ctx slice the stale plugin happened to touch (`editorState`, `placeholderConfigCtx`, etc). Fixed by capturing the bound `CollabService` and explicitly calling `.disconnect()` on it before `crepe.destroy()` runs. Added a real (unmocked) regression test — `test/milkdown-collab-teardown.test.js` — exercising the actual Milkdown/Yjs teardown sequence with two synced docs standing in for two peers; it reproduces the exact reported crash when run against the pre-fix code.
-
-## [v0.0.9] - 2026-09-02
-
-### Fixed
-- `TextEditor`/`b-ui="text-editor"`: collaborative mode (`collaborative="true"`) could crash with `MilkdownError: Context "editorState" not found, do you forget to inject it?` — the `y-webrtc`/`y-websocket` provider began syncing over the network the moment it was constructed, before the editor was created and the Yjs doc bound to Milkdown's collab plugin (`bindDoc().connect()`). A remote peer's sync update landing in that window could dispatch a ProseMirror transaction against an editor whose Milkdown context wasn't (yet, or any longer) fully wired. Both provider types are now created paused (`WebsocketProvider`'s `connect: false` option; an explicit `provider.disconnect()` right after construction for `WebrtcProvider`, which has no such option) and only resumed via `provider.connect()` after `bindDoc().setAwareness().applyTemplate().connect()` has fully wired the collab plugin against a live ctx.
-
-## [v0.0.8] - 2026-09-02
-
-### Fixed
-- `TextEditor`/`b-ui="text-editor"`: a prop-driven restart (`provider`/`room`/`url`/`password`/`signaling` change) landing while the previous editor mount was still in flight could discard the stale editor but never remount a fresh one, leaving the editor permanently unmounted with no error. Affected both collaborative and non-collaborative modes.
-
-## [v0.0.7] - 2026-09-02
-
-### Added
-- Optional Yjs collaboration on `TextEditor`/`b-ui="text-editor"` can now connect to an external `y-websocket`-compatible backend as an alternative to the existing peer-to-peer `y-webrtc` transport. New `provider`/`b-att-provider` (`"webrtc"` default or `"websocket"`) and `url`/`b-att-url` (the websocket server URL, joining `room`/`b-att-room` as the document name).
-- Collaboration now auto-enables when `provider` and `url` are both supplied, even without also setting `collaborative="true"` — `collaborative` explicitly `false`/unset with an incomplete provider/url pair still leaves the editor single-user.
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- `y-websocket` added as a runtime dependency, lazy-loaded only when `provider="websocket"` is actually selected, so `y-webrtc`-only consumers see no bundle-size change.
-
-## [v0.0.6] - 2026-09-02
-
-### Fixed
-- Removed the unused `y-prosemirror` runtime dependency, which `scripts/check-release-guards.mjs`'s allowlist rejected and broke `npm run build`.
-- `TextEditor`'s shell now fills its viewport (added `width`/`max-width` alongside the existing height rules in `text-editor.css`).
-
-## [v0.0.5] - 2026-09-02
-
-### Fixed
-- `package.json` `files` was missing `dist/runtime`, so the vendored runtime chunks (marked, mermaid, milkdown-editor, prosemirror-text-editor, and their split chunk files) never shipped to npm/CDN. Dynamic imports of `dist/runtime/prosemirror-text-editor.js` (and the other lazy runtime assets) 404'd for CDN consumers. Added `dist/runtime` to `files`.
-
-## [v0.0.4] - 2026-09-01
-
-Initial documented release. The Base UI is a self-contained component library (Owl v2 + Bootstrap 5 + GrapesJS page-builder tooling) with a shadcn-aligned component set, a live docs/examples app, and vendored runtime assets.
-
-### Added
-- Full the Base UI component set aligned with shadcn/ui coverage (Accordion, Alert, AlertDialog, Avatar, Badge, Breadcrumb, Button, Calendar, Card, Carousel, Chart, Checkbox, Collapsible, Combobox, Command, ContextMenu, DataTable, DatePicker, Dialog, Drawer, DropdownMenu, Empty, Field, Form, HoverCard, Input, InputGroup, InputOTP, Item, Kbd, Label, Marker, Menubar, NativeSelect, NavigationMenu, Pagination, Popover, Progress, RadioGroup, Resizable, ScrollArea, Select, Separator, Sheet, Shell, Sidebar, Skeleton, Slider, Spinner, Switch, Tabs, and more), plus Lucide icons and `b-*` component attributes.
-- Markdown component with live BaseUI/Mermaid previews, a copyable code pane with copy-to-clipboard toast, and a Template/Base Component code toggle for every block demo.
-- Collaborative Milkdown Markdown editor and a TextEditor component.
-- Hash-routed examples/docs app unifying all component demos under one navigation shell, with a chart gallery and component previews embedded in docs.
-- Mobile support: sidecar CSS/XML for Sidebar, Shell, DataTable, and Markdown, plus per-component demo blocks.
-- QR page generator demo.
-- `style` prop support across all Base components.
-- PWA support and ClipboardButton component.
-- Published `docs/*.md` and `docs/components/` inside the npm package (`package.json` `files`), plus `CHANGELOG.md`, so integration docs and per-component reference pages are reachable straight from unpkg/jsDelivr without cloning the repo. `docs/v2/` (vendored general Owl framework reference) and `docs/component-authoring.md` stay repo-only and are excluded.
-
-### Changed
-- Renamed `src/styles/bootstrap.min.css` (+ `.map`) to `base.min.css` and `bootstrap-extensions.css` to `base-extensions.css`; `scripts/build.mjs` now loads every `src/styles/base*.css` (vendored Bootstrap, extensions, then the rest alphabetically, e.g. `baseui.css`). `dist/baseui.min.css` is byte-identical.
-- `Accordion`, `DropdownMenu` items, `Tabs` and `NavigationMenu` now also carry Bootstrap classes (`accordion*`, `dropdown-item`/`-header`/`-divider`, `nav`/`nav-link`) alongside their `bu-*` classes, in both pure Base templates and static adapters; `bu-*` class names and selectors are unchanged. `Toast` and `Carousel` already used Bootstrap classes.
-- `Progress` now renders Bootstrap `.progress` / `.progress-bar` (plus `bu-progress*`); its CSS only sets the value-driven fill width and `--bs-progress-height`.
-- Consolidated the Base UI into a single self-contained bundle: vendored Bootstrap 5 and Owl under `src/runtime`, externalized Owl into `dist/owl.js` for lean CDN bundles, and deduped disclosure/modal logic.
-- Rewrote the Markdown live-preview to mount real Base components instead of static templates.
-- Renamed Tabs sub-components and reworked the example shell (unified sidebar/shell collapse trigger, `baseui-text-xs` utility).
-- Merged shell collapse trigger into the sidebar trigger.
-- Renamed the published npm package from `@the-base/baseui` to `@thebase/ui`.
-- Vendored Lucide icon sources into `src/icons/` (flat, git-tracked) instead of generating them only into the gitignored `dist/icons/lucide/` build output; the lucide loader module moved to `src/runtime/`.
-- `dist/` and `package-lock.json` are now gitignored, since `dist/` is purely a build artifact.
-- Consolidated duplicated class-name string-building logic (`DropdownMenu`, `Sidebar`, `Form`, `Field`) into a single shared `classNames()` helper in `prop-aliases.js`.
-- Switched the QR page consumer demo to load the Base UI directly from `/dist/` instead of a vendored copy; bumped its service worker cache to `v4`.
-- Rewrote `README.md`'s release notes to point at `CHANGELOG.md` instead of embedded version narrative; corrected the published component count; documented the CDN doc-access URLs and which docs are excluded from the package.
-
-### Fixed
-- Block-viewer mount race across all block demos.
-- Dialog close-button and input auto-mount bugs.
-- Mobile sidebar/shell layout bugs.
-- Docs-preview code-fence rendering; added MarkdownTree and frontmatter support.
-- Tabs panel border/alignment and sidebar/toast styling.
-- Removed an orphaned, unused `bootstrap.bundle.min.js.map` source map and its dangling `sourceMappingURL` reference.
+All notable changes to Nodex UI are documented in this file. Nodex UI follows [Semantic Versioning](https://semver.org/).
+
+## [v1.3.0] - 2026-10-31
+
+First release of **Nodex UI**, published on npm as [`nodexui`](https://www.npmjs.com/package/nodexui).
+
+### Components and API
+- 74 components, each available two ways: component classes (`import { Button } from "nodexui"`, Nodex-powered, for your own application) and static `b-ui` markup (`b-att-*` attributes, `nodexui:*` events) for plain HTML, server-rendered and CMS pages.
+- Self-contained builds: `dist/nodexui.min.js` and `dist/nodexui.esm.js` embed the bundled JS, the Nodex runtime, every component class and the theme helper. No build step; load from a CDN script tag or import map, or install from npm.
+- Runtime exports: `NodexUI`, `Component`, `mount`, `xml`, `cn`, `mergeStyle`, plus the theme helpers `createThemeController` and `NodexUITheme`.
+- Built-in Lucide icon library (`b-icon`, `dist/icons/`), 2000+ icon components in `nodexui/icons`.
+- Blocks: copyable shadcn-style page blocks with a Preview/Code/responsive viewer.
+
+### Theming
+- Light and dark themes (`dist/themes/nodexui-light.css`, `nodexui-dark.css`) hold all colour tokens, `--base-radius` and `--b-overlay`, including the `--b-success`, `--b-warning` and `--b-info` status tokens.
+- Theme tab in the examples app (`examples/index.html#/theme`) builds a custom pair and downloads the CSS.
+- Component classes use the `b-` prefix and design tokens use `--b-*`.
+
+### Optional standalone services
+- `nodexui/analytics`: cookieless web analytics (pageviews including SPA, engagement, outbound links, downloads, forms). Nothing is collected until `init()` is called.
+- `nodexui/i18n`: gettext-style `.po` catalogs with language detection and a language switcher, no runtime dependencies.
+- `nodexui/apidoc`: renders an OpenAPI 3 JSON file as browsable API docs with a Try It panel, code samples in 17 languages and an Authorize dialog.
+- `nodexui/pwa` and `nodexui/vite`: `buildManifest`, `buildServiceWorker` and the `nodexuiPwa()` Vite plugin. Generated service workers poll `version.json` and reload when it changes.
+
+### Tooling
+- `create-nodexui-app` CLI: `create`, `init`, `convert` and `pwa` commands for static-importmap or Vite PWA projects.
+- Package exports: `nodexui`, `nodexui/nodexui.css`, `nodexui/registry`, `nodexui/icons`, `nodexui/analytics`, `nodexui/i18n`, `nodexui/apidoc`, `nodexui/pwa`, `nodexui/vite`. Docs under `docs/` ship in the package.
+
+### Website, SEO and analytics
+- The public site <https://ui.thebase.vn> keeps its hostname and URLs under the Nodex UI brand.
+- Per-route title, description, canonical and Open Graph tags (`examples/seo.js`), an updated `sitemap.xml`, and first-party event tracking (`examples/tracking.js`) with no Google Analytics, following `.agents/knowledge/base-ui-seo-analytics-ai-agent-brief.md`.
+- The examples app, emvhub, qr-page and momo_demo are translated and pinned to `nodexui@1.3.0`.

package/LICENSE

@@ -23,7 +23,7 @@ SOFTWARE.
 ---
 
 Third-party notice: src/runtime/base/analytics.js (the optional analytics service,
-built as dist/baseui.analytics.esm.js and dist/baseui.analytics.min.js) is a port of
+built as dist/nodexui.analytics.esm.js and dist/nodexui.analytics.min.js) is a port of
 @plausible-analytics/tracker, distributed under the following license:
 
 MIT License