@thebase/ui 1.2.0 → 1.2.1

package/dist/baseui.registry.json

@@ -1690,8 +1690,8 @@
   "integrity": {
     "baseui.min.css": "sha384-ZHn0002xs5Vgxz9uxfop7VtPOQAh6E5rIJO01L/a2zmeIBWoZyFt6cnVrx75Dvuv",
     "bootstrap.bundle.min.js": "sha384-RMbllTJcplkCRnELNTOc5Kz/3AvFDE/rNlJqWqfgmRWruobClBdfwvl10akQZkR1",
-    "baseui.min.js": "sha384-ngv95qClP1dpgmpqtod8rhEOsTqIyA+TVoM4r8SwTWAmTY9ywjd0/Dg3Tof5Tctc",
-    "baseui.esm.js": "sha384-iotSpACgMEmc6RjnCVirA3EQ9OSVj4EiAFNTRDIsE9bq57WtQzafHLZYU61QD8Zv",
+    "baseui.min.js": "sha384-aD8d00QW67jb6lvNvF5zTVnL6PhUxwsFM6zCf1h8PAy9HoYQCyDTuRZYoh0WRw9E",
+    "baseui.esm.js": "sha384-frdLhpMXVNCzoVdnDtpd/y9IzPJzmNgBdKKYDYQCtLm/an9wp+LjCVPvbSpKar4O",
     "baseui.icons.esm.js": "sha384-ZfEsbs5m2fWdNSu4Ql+ul4mOxhfl1HviBlbxZGZ/4ud905I8Csa6/ekJjNSVkjQ0",
     "baseui.templates.xml": "sha384-+f/GUQVnonSoB2Q38NEa6hialYS8zT1NAAeGBtV6Kvtio+W4hOlpzihhvaCwKipc",
     "baseui.block-viewer.esm.js": "sha384-vOMuFxKFmcXlJnc7tF4g9+ZcZJs3E8oLe2pgyOp5ZWqJ9zsmW7S8gcS5kFIWRnY4",

package/dist/types/i18n.d.ts

@@ -0,0 +1,25 @@
+/** gettext (.po) translation service. Call `init` before the first `loadCatalog`. */
+export interface BaseUII18nLanguage { code: string; label: string }
+export interface BaseUII18nConfig {
+  /** Languages the page can show; `code` is the .po file name. Defaults to English only. */
+  languages?: BaseUII18nLanguage[];
+  /** Language the texts are written in (no catalog is loaded for it). Defaults to the first language. */
+  defaultLanguage?: string;
+  /** localStorage key remembering the visitor's choice. Defaults to "thebase-lang". */
+  storageKey?: string;
+  /** Query parameter that forces a language. Defaults to "lang". */
+  queryParam?: string;
+  /** Folder (next to each module) holding `<code>.po`. Defaults to "i18n". */
+  catalogDir?: string;
+  /** Selector of the meta description `translateHead` translates. */
+  headDescription?: string;
+}
+export interface BaseUII18nEntry { id: string; str: string; fuzzy: boolean }
+export function init(config?: BaseUII18nConfig): void;
+export function languages(): BaseUII18nLanguage[];
+export function t(text: string, params?: Record<string, string | number>): string;
+export function parsePo(text: string): Map<string, BaseUII18nEntry>;
+export function loadCatalog(moduleUrl: string | URL): Promise<void>;
+export function currentLanguage(): string;
+export function translateHead(): void;
+export function setLanguage(code: string): void;

package/dist/types/index.d.ts

@@ -27,6 +27,8 @@ 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;
+  /** Set by dist/baseui.i18n.min.js (the optional i18n service). */
+  i18n?: typeof import("./i18n");
   /** Bound by `analytics.init()` (unless `bindToWindow: false`). */
   track?: import("./analytics").BaseUIAnalytics["track"];
 }

package/docs/analytics.md

@@ -13,12 +13,12 @@ init({ backendUrl: "https://stats.example.com" });
 ```html
 <!-- ES module from the CDN (or map it as "@base/analytics" in an import map) -->
 <script type="module">
-  import { init } from "https://cdn.jsdelivr.net/npm/@thebase/ui@1.2.0/dist/baseui.analytics.esm.js";
+  import { init } from "https://cdn.jsdelivr.net/npm/@thebase/ui@1.2.1/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.2.0/dist/baseui.analytics.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@thebase/ui@1.2.1/dist/baseui.analytics.min.js"></script>
 <script>
   thebase.analytics.init({ backendUrl: "https://stats.example.com" });
 </script>
@@ -228,7 +228,7 @@ curl -i -X POST http://localhost:8080/api/event -H 'Content-Type: text/plain' \
 
 [`examples/analytics/`](../examples/analytics/dashboard/?backend=http://localhost:8080) contains a working dashboard plus two complete sample backends: [`server-go`](../examples/analytics/server-go/main.go) (Fiber v3) and [`server-fastapi`](../examples/analytics/server-fastapi/main.py). Each one extends the receivers above with an in-memory store, a daily-salted cookieless visitor hash, a `GET /api/stats` endpoint, and static hosting for the dashboard.
 
-The dashboard ([`dashboard/`](../examples/analytics/dashboard/?backend=http://localhost:8080)) is a pure application that loads `@thebase/ui@1.2.0` from jsDelivr: KPI `Card`s, an area `Chart`, top pages/sources/events `Table`s, site and period `NativeSelect`s, and a `ThemeButton`. It refreshes every 30 s and tracks its own visits through `@thebase/ui/analytics`, so a fresh backend has data straight away.
+The dashboard ([`dashboard/`](../examples/analytics/dashboard/?backend=http://localhost:8080)) is a pure application that loads `@thebase/ui@1.2.1` from jsDelivr: KPI `Card`s, an area `Chart`, top pages/sources/events `Table`s, site and period `NativeSelect`s, and a `ThemeButton`. It refreshes every 30 s and tracks its own visits through `@thebase/ui/analytics`, so a fresh backend has data straight away.
 
 ```sh
 # Go (1.25+)

package/docs/blocks.md

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

package/docs/i18n.md

@@ -0,0 +1,119 @@
+# i18n service
+
+Instructions for adding translations to a page or app with the Base UI i18n service (`@thebase/ui/i18n`). It is optional and standalone: no Owl, Bootstrap or component runtime, and it is not part of the main bundles.
+
+- **Audience:** developers adding a language switcher or translating an existing page.
+- **Runnable example:** `examples/i18n/` (open `/examples/i18n/` from `npm run dev`).
+- **Real-world use:** `emvhub/i18n.js` and the `i18n/*.po` folders beside each emvhub module.
+
+## 1. How it works
+
+You write every text in the default language and wrap it in `t()`. Each module keeps its translations in an `i18n/<code>.po` folder next to it and loads them with `loadCatalog(import.meta.url)`. The service picks one language per page load and fills a shared lookup; `t()` returns the translation, or the original text when none exists.
+
+```mermaid
+flowchart LR
+  A["init(config)"] --> B["loadCatalog(import.meta.url)"]
+  B --> C{"Pick language"}
+  C -->|"?lang= → saved choice → browser → default"| D["Fetch ./i18n/code.po"]
+  D --> E["Finished entries join the lookup"]
+  E --> F["t(text) returns translation"]
+  G["setLanguage(code)"] -->|"saves choice, reloads"| B
+```
+
+## 2. Install
+
+| How you load it | Use |
+| --- | --- |
+| ES module | `import { init, t, loadCatalog } from "@thebase/ui/i18n"` (file: `dist/baseui.i18n.esm.js`) |
+| Import map | map `@base/i18n` to the ESM file, then `import … from "@base/i18n"` |
+| Script tag | `dist/baseui.i18n.min.js` sets `window.thebase.i18n` |
+
+## 3. Quick start
+
+1. Map the module in your HTML:
+
+```html
+<script type="importmap">
+  { "imports": { "@base/i18n": "https://cdn.jsdelivr.net/npm/@thebase/ui@<version>/dist/baseui.i18n.esm.js" } }
+</script>
+```
+
+2. Configure once, then load the catalog next to your module:
+
+```js
+import { init, t, loadCatalog, languages, currentLanguage, setLanguage, translateHead } from "@base/i18n";
+
+init({ languages: [{ code: "en", label: "English" }, { code: "vi", label: "Tiếng Việt" }], storageKey: "my-lang" });
+await loadCatalog(import.meta.url); // fetches ./i18n/vi.po when Vietnamese is picked
+translateHead();
+document.querySelector("h1").textContent = t("Hello {name}", { name: "An" });
+```
+
+3. Add `i18n/vi.po` beside the module:
+
+```po
+msgid ""
+msgstr "Language: vi\n"
+
+msgid "Hello {name}"
+msgstr "Xin chào {name}"
+```
+
+## 4. API reference
+
+| Function | Purpose |
+| --- | --- |
+| `init(options)` | Sets languages and defaults. Call once, before the first `loadCatalog()`; it throws afterwards. |
+| `loadCatalog(moduleUrl)` | Picks the language on the first call, then fetches `<catalogDir>/<code>.po` next to `moduleUrl` once. Returns a promise; await it before using `t()`. No request is made for the default language. |
+| `t(text, params?)` | Returns the translation or the original text; replaces `{name}` placeholders from `params`. |
+| `languages()` | The configured `{ code, label }` list, for a switcher. |
+| `currentLanguage()` | The code in use, to mark the active switcher item. |
+| `setLanguage(code)` | Saves the choice and reloads the page with `?lang=<code>`. |
+| `translateHead()` | Translates `document.title` and the meta description. |
+| `parsePo(text)` | Parses `.po` text into a `Map` of original text → `{ id, str, fuzzy }` (useful in tooling and tests). |
+
+### `init()` options
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `languages` | `[{ code: "en", label: "English" }]` | Languages the page can show; `code` is the `.po` file name, `label` is shown in the language's own words. |
+| `defaultLanguage` | first language | The language your texts are written in; no catalog is loaded for it. |
+| `storageKey` | `"thebase-lang"` | `localStorage` key that remembers the visitor's choice. |
+| `queryParam` | `"lang"` | URL parameter that forces a language. |
+| `catalogDir` | `"i18n"` | Folder beside each module that holds the `.po` files. |
+| `headDescription` | `meta[name="description"]` | Selector of the tag `translateHead()` translates. |
+
+Language order: URL parameter, saved choice, browser languages (first two letters), default.
+
+## 5. Writing `.po` files
+
+- One block per text: `msgid` (original, exact match) and `msgstr` (translation). Long texts may continue on following quoted lines.
+- Entries with an empty `msgstr` or a `#, fuzzy` flag are ignored, so unfinished work never reaches visitors.
+- Text matching is exact and case-sensitive. Changing a source string in code means updating its `msgid`.
+- Keep placeholders identical in both: `{name}` in the `msgid` must appear as `{name}` in the `msgstr`.
+- Never build a sentence from joined fragments; use one text with placeholders.
+
+## 6. Multi-module apps
+
+Each module loads its own catalog, but language selection and `init()` must happen once and first. Create one local file that every module imports:
+
+```js
+// i18n.js
+import { init } from "@base/i18n";
+
+init({ languages: [{ code: "en", label: "English" }, { code: "vi", label: "Tiếng Việt" }], storageKey: "my-lang" });
+export * from "@base/i18n";
+```
+
+Because ES modules evaluate dependencies first, `init()` runs before any module's top-level `await loadCatalog(import.meta.url)`. A module that shares another folder's texts loads both: `await Promise.all([loadCatalog(import.meta.url), loadCatalog(new URL("../lib/", import.meta.url))])`.
+
+## 7. Gotchas
+
+| Symptom | Cause and fix |
+| --- | --- |
+| `init() must be called before the first loadCatalog()` | A module loaded a catalog first. Route all imports through the single local file above. |
+| Texts stay in English | The `msgid` differs from the code string, the entry is fuzzy or empty, or the `.po` URL 404s (check `catalogDir` and `moduleUrl`). Failed fetches are silent by design. |
+| Module-level texts untranslated | `t()` ran before `await loadCatalog(...)` finished. Await it at the top of the module. |
+| Switching language reloads the page | By design: every text is redrawn in the new language. |
+| Choice not remembered | Storage is blocked; the `?lang=` link still works for that visit. |
+| Offline/PWA | Precache each `i18n/<code>.po` in your service worker (see `emvhub/baseui.pwa.config.js`). |

package/docs/icons.md

@@ -22,7 +22,7 @@ Load the normal the Base UI assets. No separate icon script is required.
 <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.2.0`, or `@1` to take only non-breaking updates) instead of `@latest` for production. `b-icon` also works with the [pure Base `Icon` component](components/icon.md) — the recommended API in an application; the classic script above is for pages using the static `b-ui` API.
+`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.2.1`, or `@1` to take only non-breaking updates) instead of `@latest` for production. `b-icon` also works with the [pure Base `Icon` component](components/icon.md) — the recommended API in an application; the classic script above is for pages using the static `b-ui` API.
 
 The build publishes every Lucide SVG to `dist/icons/lucide/` and writes the generated icon manifest to `dist/icons/lucide.json`.
 

package/docs/installation.md

@@ -4,7 +4,7 @@ See the [Usage Guide](usage-guide.md) for the end-to-end integration path (choos
 
 The Base UI is distributed as one CSS file and one JavaScript file for browser use. `dist/baseui.min.js` is fully self-contained: Bootstrap's JS bundle (Popper.js included) and the Owl runtime are embedded ahead of the Base UI's own code, in load order (Bootstrap, then Owl, then the Base UI) — nothing else needs to load first. Both install paths below load this same file; the Base component API is the recommended way to consume the Base UI in an application, with the base static markup (`b-ui`) API available as a lighter-weight alternative for non-Owl pages.
 
-The snippets below use the `@latest` tag for readability. Pin an exact version instead (e.g. `@1.2.0`, or `@1` to take only non-breaking updates) for any production page — `@latest` can silently change what your page loads the moment a new version is published.
+The snippets below use the `@latest` tag for readability. Pin an exact version instead (e.g. `@1.2.1`, or `@1` to take only non-breaking updates) for any production page — `@latest` can silently change what your page loads the moment a new version is published.
 
 ## Base component install (recommended)
 
@@ -43,7 +43,7 @@ For static HTML, a server-rendered page, or a Base HUB website page that has no
 
 Bootstrap 5 is the bundled baseline CSS framework, and its JS bundle now drives the Base UI's interactive components directly.
 
-`@thebase/ui` is published on npm, so [unpkg](https://unpkg.com/@thebase/ui@latest/) mirrors the same files as an alternative CDN (`https://unpkg.com/@thebase/ui@latest/dist/baseui.min.css` / `baseui.min.js`) if jsDelivr is unreachable in your environment. Pin an exact version (e.g. `@1.2.0`, or `@1` to take only non-breaking updates) instead of `@latest` for production.
+`@thebase/ui` is published on npm, so [unpkg](https://unpkg.com/@thebase/ui@latest/) mirrors the same files as an alternative CDN (`https://unpkg.com/@thebase/ui@latest/dist/baseui.min.css` / `baseui.min.js`) if jsDelivr is unreachable in your environment. Pin an exact version (e.g. `@1.2.1`, or `@1` to take only non-breaking updates) instead of `@latest` for production.
 
 For npm/self-hosted usage:
 
@@ -77,6 +77,7 @@ Production pages should use pinned version URLs. `latest` is for demos and exper
 | Owl templates XML | `@thebase/ui/dist/baseui.templates.xml` | `@base/templates` | `dist/baseui.templates.xml` |
 | Registry metadata | `@thebase/ui/registry` | none; fetch the JSON file | `dist/baseui.registry.json` |
 | Optional analytics service (`init`, `track`) | `@thebase/ui/analytics` | none; import the file URL or load the `<script>` build (sets `window.thebase.analytics`) | `dist/baseui.analytics.esm.js`, `dist/baseui.analytics.min.js` |
+| Optional i18n service (`init`, `t`, `loadCatalog`) | `@thebase/ui/i18n` | `@base/i18n` (as in `emvhub/index.html`); or load the `<script>` build (sets `window.thebase.i18n`) | `dist/baseui.i18n.esm.js`, `dist/baseui.i18n.min.js` |
 | Standalone ApiDoc (`mountApiDoc`) | `@thebase/ui/apidoc` | none; embeds Owl + its templates, still needs `baseui.min.css`; set `assetBase` for the language logos | `dist/baseui.apidoc.esm.js`, `dist/baseui.apidoc.min.js` |
 
 `@base/templates` points to XML, not JavaScript. Resolve and fetch it (`fetch(import.meta.resolve("@base/templates"))`) before mounting an application that uses the Base UI component classes.

package/docs/owl-components.md

@@ -55,7 +55,7 @@ Everything — the static `b-ui` runtime, the Owl framework, every Base componen
 </script>
 ```
 
-`https://unpkg.com/@thebase/ui@latest/dist/...` mirrors the same files as an alternative CDN if jsDelivr is unreachable — swap the host in each URL above. For a self-hosted build, replace the CDN host with your own served path (e.g. `/dist/baseui.esm.js`). These snippets use `@latest` for readability; pin an exact version (e.g. `@1.2.0`, or `@1` to take only non-breaking updates) in production so a new release can't change what your page loads.
+`https://unpkg.com/@thebase/ui@latest/dist/...` mirrors the same files as an alternative CDN if jsDelivr is unreachable — swap the host in each URL above. For a self-hosted build, replace the CDN host with your own served path (e.g. `/dist/baseui.esm.js`). These snippets use `@latest` for readability; pin an exact version (e.g. `@1.2.1`, or `@1` to take only non-breaking updates) in production so a new release can't change what your page loads.
 
 No `@odoo/owl` import appears anywhere in that snippet — `@base/owl` is the only Owl entry point the Base UI components and consumer apps need. Because `@base/owl`, `@base/component`, and `@base/theme` all point at the exact same `dist/baseui.esm.js` URL, the browser fetches and evaluates it once and every key shares the same module instance — no separate classic `<script>` needs to load first to set up a shared global.
 

package/docs/registry.md

@@ -14,6 +14,7 @@ The Base UI ships as bundled files only — there is no per-component source dis
 - `baseui.icons.esm.js` — the 2000+ generated `Icon<Name>` components (`IconEye`, `IconSearch`, ...), split out because they'd blow the main bundle's size budget. The one deliberate exception to "everything is one bundle".
 - `baseui.templates.xml` — every Base component's compiled `<templates>` body, concatenated into one file. Load this into the Owl `App`'s `templates` config before mounting; `.xml` files under `src/components/` are authoring sources, not something a consumer app loads directly.
 - `baseui.analytics.esm.js` / `baseui.analytics.min.js` — the optional, standalone cookieless analytics service (`@thebase/ui/analytics`). Not part of the main bundles and needs no other Base UI file; see [Analytics](analytics.md).
+- `baseui.i18n.esm.js` / `baseui.i18n.min.js` — the optional, standalone gettext-style i18n service (`@thebase/ui/i18n`). Not part of the main bundles and needs no other Base UI file; see [i18n](i18n.md).
 - `icons/lucide.json` — the built-in icon manifest.
 
 ## Component export policy

package/docs/runtime-api.md

@@ -14,9 +14,11 @@ thebase.theme.set("dark")
 thebase.theme.set({ primary: "#0f6cbd" })
 thebase.analytics.init({ domain, endpoint })
 thebase.track(eventName, options)
+thebase.i18n.init({ languages, defaultLanguage })
+thebase.i18n.t(text, params)
 ```
 
-`thebase.analytics` is set only when the optional `dist/baseui.analytics.min.js` is loaded (it is not in the main bundles), and `thebase.track` is bound once it is initialized — see [Analytics](analytics.md).
+`thebase.analytics` is set only when the optional `dist/baseui.analytics.min.js` is loaded (it is not in the main bundles), and `thebase.track` is bound once it is initialized — see [Analytics](analytics.md). Likewise `thebase.i18n` is set only when the optional `dist/baseui.i18n.min.js` is loaded — see [i18n](i18n.md).
 
 The static runtime calls `autoMount()` when imported through `dist/baseui.esm.js` or `dist/baseui.min.js`. Existing `[b-ui]` and `[b-icon]` markers are enhanced automatically once the DOM is ready.
 

package/docs/theming.md

@@ -22,7 +22,7 @@ thebase.theme.set({ primary: "#0057d8", radius: "0.5rem" });
 3. Load them after the Base UI stylesheet:
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@thebase/ui@1.2.0/dist/baseui.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@thebase/ui@1.2.1/dist/baseui.min.css">
 <link rel="stylesheet" href="/css/baseui-light.css">
 <link rel="stylesheet" href="/css/baseui-dark.css">
 ```
@@ -68,7 +68,7 @@ For a reusable theme toggle with persistence, URL override, button-label sync, a
 </script>
 ```
 
-`https://unpkg.com/@thebase/ui@latest/dist/baseui.esm.js` mirrors the same file as an alternative CDN if jsDelivr is unreachable. Pin an exact version (e.g. `@1.2.0`, or `@1` to take only non-breaking updates) instead of `@latest` for production. Npm/bundler consumers can import the same API from `@thebase/ui`.
+`https://unpkg.com/@thebase/ui@latest/dist/baseui.esm.js` mirrors the same file as an alternative CDN if jsDelivr is unreachable. Pin an exact version (e.g. `@1.2.1`, or `@1` to take only non-breaking updates) instead of `@latest` for production. Npm/bundler consumers can import the same API from `@thebase/ui`.
 
 For a ready-made icon button, use the Base UI component instead of wiring your own click handler:
 

package/docs/usage-guide.md

@@ -32,7 +32,7 @@ Save this as an `.html` file and open it — no build step, no server required.
 </html>
 ```
 
-`https://cdn.jsdelivr.net/npm/@thebase/ui@latest/dist/...` is the real jsDelivr URL for the published `@thebase/ui` npm package's `latest` tag, used here for a copy-paste-and-go quick start. Pin an exact version instead (e.g. `@1.2.0`, or `@1` to take only non-breaking updates) for production, so a new release can't change what your page loads. See [Installation](installation.md) for jsDelivr/unpkg/npm/self-hosted paths.
+`https://cdn.jsdelivr.net/npm/@thebase/ui@latest/dist/...` is the real jsDelivr URL for the published `@thebase/ui` npm package's `latest` tag, used here for a copy-paste-and-go quick start. Pin an exact version instead (e.g. `@1.2.1`, or `@1` to take only non-breaking updates) for production, so a new release can't change what your page loads. See [Installation](installation.md) for jsDelivr/unpkg/npm/self-hosted paths.
 
 The static bundle calls `thebase.mountAll()` automatically on `DOMContentLoaded`, so initial `[b-ui]` and `[b-icon]` markup mounts without an extra script. Call `thebase.mountAll(root)` yourself only after injecting new markup or when mounting a specific fragment. If the consumer is itself an application, use [step 2](#2-install-pure-owl-api--recommended) instead — that's the recommended path.
 
@@ -63,7 +63,7 @@ Both APIs come from the same package and the same CSS file, and can be mixed on
 </script>
 ```
 
-`https://unpkg.com/@thebase/ui@latest/dist/...` mirrors the same files as an alternative CDN if jsDelivr is unreachable — swap the host in each URL above. Pin an exact version (e.g. `@1.2.0`, or `@1` to take only non-breaking updates) instead of `@latest` for production.
+`https://unpkg.com/@thebase/ui@latest/dist/...` mirrors the same files as an alternative CDN if jsDelivr is unreachable — swap the host in each URL above. Pin an exact version (e.g. `@1.2.1`, or `@1` to take only non-breaking updates) instead of `@latest` for production.
 
 ```html
 <script type="module">
@@ -103,7 +103,7 @@ Two rules that account for most integration failures — see [Base Components](o
 <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.2.0`, or `@1` to take only non-breaking updates) instead of `@latest` for production.
+`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.2.1`, or `@1` to take only non-breaking updates) instead of `@latest` for production.
 
 **Option B — npm (bundler-based apps: Vite, webpack, etc.):**
 
@@ -120,7 +120,7 @@ import "@thebase/ui"; // side-effect import: registers window.thebase and auto-m
 
 Rule that applies to both options:
 
-- Production pages must use a pinned version (e.g. `@thebase/ui@1.2.0` or `@thebase/ui@1`), never `@latest`.
+- Production pages must use a pinned version (e.g. `@thebase/ui@1.2.1` or `@thebase/ui@1`), never `@latest`.
 
 Mount markup:
 
@@ -219,7 +219,7 @@ export default {
   },
   serviceWorker: {
     cacheName: "my-app-cache-v1",
-    cdnVersion: "1.2.0", // pin to match the importmap in index.html
+    cdnVersion: "1.2.1", // pin to match the importmap in index.html
     appFiles: ["/app.css", "/app.js", "/app.xml", "/favicon.svg", "/icons/icon-192.png", "/icons/icon-512.png"],
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebase/ui",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "CDN-installable Bootstrap 5 UI component library.",
   "type": "module",
   "main": "./dist/baseui.min.js",
@@ -25,6 +25,11 @@
       "import": "./dist/baseui.analytics.esm.js",
       "default": "./dist/baseui.analytics.min.js"
     },
+    "./i18n": {
+      "types": "./dist/types/i18n.d.ts",
+      "import": "./dist/baseui.i18n.esm.js",
+      "default": "./dist/baseui.i18n.min.js"
+    },
     "./apidoc": {
       "types": "./dist/types/apidoc.d.ts",
       "import": "./dist/baseui.apidoc.esm.js",
@@ -48,6 +53,8 @@
     "dist/baseui.icons.esm.js",
     "dist/baseui.analytics.esm.js",
     "dist/baseui.analytics.min.js",
+    "dist/baseui.i18n.esm.js",
+    "dist/baseui.i18n.min.js",
     "dist/baseui.apidoc.esm.js",
     "dist/baseui.apidoc.min.js",
     "dist/baseui.pwa.esm.js",