@wzrhine/react 0.0.0-stage → 0.2.0

package/dist/provider/messages.d.ts

@@ -0,0 +1,209 @@
+import * as React from 'react';
+/**
+ * Built-in copy (ADR-0009). Every visible or screen-reader string a component renders on its own
+ * lives here, grouped by component. This file is the only place in `components/` and `provider/`
+ * allowed to contain CJK text (package-boundary test).
+ *
+ * Priority: component prop > nearest provider `messages` > `zhCN`.
+ *
+ * The tables live in a `'use client'` module on purpose: a Server Component can then pass
+ * `messages={enUS}` to `RhineProvider` as a client reference, although the tables contain functions.
+ */
+/** Formats a number with the provider's `locale` (Intl.NumberFormat). */
+export type RhineNumberFormat = (value: number) => string;
+/**
+ * Parameterised entries are functions. Functions with numeric arguments receive the provider's
+ * number formatter as their last argument; using it is up to the table (`zhCN` keeps the
+ * pre-M9.5 output, which prints raw digits).
+ */
+export interface RhineMessages {
+    workbench: {
+        index: string;
+        content: string;
+        resize: string;
+        width: (width: string) => string;
+    };
+    tree: {
+        loading: string;
+        empty: string;
+        retry: (name: string) => string;
+        expand: (name: string) => string;
+        collapse: (name: string) => string;
+    };
+    tag: {
+        remove: (name: string) => string;
+    };
+    alert: {
+        /** Dismiss button of a dismissible Alert. */
+        dismiss: string;
+    };
+    alertDialog: {
+        cancel: string;
+        /** Shown when `onConfirm` rejects and no `errorText` is given. */
+        error: string;
+    };
+    dialog: {
+        close: string;
+    };
+    breadcrumb: {
+        /** Accessible name of the `<nav>`. */
+        nav: string;
+        /** Button that reveals collapsed levels. */
+        expand: (count: number, format: RhineNumberFormat) => string;
+    };
+    combobox: {
+        /** Shown in the list when nothing matches. */
+        empty: string;
+        /** Status row while `loading`. */
+        loading: string;
+        /** Accessible name of the clear button. */
+        clear: string;
+        /** Accessible name of the button that opens the list. */
+        openList: string;
+    };
+    commandPalette: {
+        /** Accessible name of the dialog (visually hidden). */
+        title: string;
+        /** Accessible name of the search input. */
+        inputLabel: string;
+        placeholder: string;
+        /** Shown when no command matches. */
+        empty: string;
+        /** Keyboard hint in the footer, also the input's description. */
+        hint: string;
+        /** Visually hidden close button for touch screen readers. */
+        close: string;
+        /** Status row while `loading` (async search). */
+        loading: string;
+    };
+    dataTable: {
+        empty: string;
+        loading: string;
+        error: string;
+        retry: string;
+        /** Header checkbox while not every row on the page is selected. */
+        selectAll: string;
+        /** Header checkbox while every row on the page is selected. */
+        deselectAll: string;
+        /** Row checkbox; `label` is `getRowLabel(row)` or the row id. */
+        selectRow: (label: string) => string;
+        /** Selection summary; `offPage` = selected rows that are not on the current page. */
+        selection: (count: number, offPage: number, format: RhineNumberFormat) => string;
+    };
+    drawer: {
+        close: string;
+    };
+    field: {
+        /** Marker after the label of an `optional` field. */
+        optional: string;
+    };
+    fileDropZone: {
+        /** Default prompt inside the drop area. */
+        prompt: string;
+        /** Text of the visible button that opens the file picker. */
+        browse: string;
+        /** A file whose type does not match `accept`. */
+        rejectedType: (fileName: string) => string;
+        /** A file larger than `maxSize`; `limit` is already formatted, e.g. "1 MB". */
+        rejectedSize: (fileName: string, limit: string) => string;
+        /** A file beyond `maxFiles`. */
+        rejectedCount: (fileName: string, max: number, format: RhineNumberFormat) => string;
+        /** Polite announcement after files were accepted. */
+        accepted: (count: number, format: RhineNumberFormat) => string;
+    };
+    metadataList: {
+        /** Spoken text of an empty value shown as "—" (`empty="placeholder"`). */
+        missing: string;
+    };
+    numberField: {
+        /** Accessible name of the decrement stepper button. */
+        decrement: string;
+        /** Accessible name of the increment stepper button. */
+        increment: string;
+        /** `aria-roledescription` of the text input (Base UI defaults to English "Number field"). */
+        roleDescription: string;
+    };
+    pagination: {
+        nav: string;
+        previous: string;
+        next: string;
+        page: (page: number, format: RhineNumberFormat) => string;
+        compact: (page: number, pageCount: number, format: RhineNumberFormat) => string;
+        status: (from: number, to: number, total: number, format: RhineNumberFormat) => string;
+    };
+    progress: {
+        /** Spoken value of an indeterminate Progress (`value={null}`). */
+        indeterminate: string;
+        /** Spoken value of a Meter with a state label, e.g. "72%，偏高". */
+        meterValue: (value: string, state: string) => string;
+    };
+    recordHeader: {
+        /** Accessible name of the breadcrumb trail. */
+        trail: string;
+    };
+    select: {
+        placeholder: string;
+    };
+    stat: {
+        loading: string;
+        /** Spoken text of a missing value shown as "—". */
+        empty: string;
+        up: string;
+        down: string;
+        flat: string;
+    };
+    textarea: {
+        count: (current: number, max: number, format: RhineNumberFormat) => string;
+    };
+    timeline: {
+        empty: string;
+    };
+    toast: {
+        /** Close button of every toast. */
+        close: string;
+        /**
+         * Accessible name of the toast viewport region. `zhCN` keeps Base UI's built-in
+         * "Notifications" so the default output does not change.
+         */
+        region: string;
+    };
+}
+/** Override shape accepted by providers: any namespace, any subset of its keys. */
+export type RhineMessagesOverrides = {
+    [K in keyof RhineMessages]?: Partial<RhineMessages[K]>;
+};
+/** Built-in default (zh-CN). Output is identical to the pre-M9.5 hard-coded defaults. */
+export declare const zhCN: RhineMessages;
+/** Reference English translation (参考译文): wording may change before 1.0. */
+export declare const enUS: RhineMessages;
+/** Default number locale when no provider sets one (ADR-0009 §3). Never read from the runtime. */
+export declare const DEFAULT_LOCALE = "zh-CN";
+export interface RhineLocaleValue {
+    messages: RhineMessages;
+    locale: string;
+}
+/** Shallow merge per namespace; `undefined` values in the override are ignored. */
+export declare function mergeMessages(base: RhineMessages, overrides: RhineMessagesOverrides | undefined): RhineMessages;
+export interface RhineMessagesProviderProps {
+    /** Partial table merged over the outer provider's (or `zhCN`). */
+    messages?: RhineMessagesOverrides;
+    /** Number locale for this subtree; defaults to the outer provider's (or `zh-CN`). */
+    locale?: string;
+    children: React.ReactNode;
+}
+/** Internal: merges a provider's overrides over the outer value (shared by both providers). */
+export declare function useResolvedLocale(messages: RhineMessagesOverrides | undefined, locale: string | undefined): RhineLocaleValue;
+/** Internal: publishes a resolved value (used by RhineProvider). */
+export declare const RhineLocaleProvider: React.Provider<RhineLocaleValue>;
+/**
+ * Copy (and number locale) for a region without its own RhineProvider. Nested providers merge
+ * with the outer one per namespace.
+ */
+export declare function RhineMessagesProvider({ messages, locale, children }: RhineMessagesProviderProps): React.JSX.Element;
+/** The merged message table of the nearest provider (`zhCN` without one). */
+export declare function useRhineMessages(): RhineMessages;
+/** Messages, number locale and a cached formatter of the nearest provider (also used by @wzrhine/agent). */
+export declare function useRhineLocale(): RhineLocaleValue & {
+    formatNumber: RhineNumberFormat;
+};
+//# sourceMappingURL=messages.d.ts.map

package/dist/provider/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/provider/messages.tsx"],"names":[],"mappings":"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"}

package/dist/provider/messages.js

@@ -0,0 +1,168 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from 'react';
+/** Built-in default (zh-CN). Output is identical to the pre-M9.5 hard-coded defaults. */
+export const zhCN = {
+    workbench: { index: '索引', content: '工作台内容', resize: '调整索引宽度', width: (width) => `宽度 ${width} 像素` },
+    tree: { loading: '正在读取…', empty: '暂无项目', retry: (name) => `重试读取 ${name}`, expand: (name) => `展开 ${name}`, collapse: (name) => `收起 ${name}` },
+    tag: { remove: (name) => `移除 ${name}` },
+    alert: { dismiss: '关闭提示' },
+    alertDialog: { cancel: '取消', error: '操作未完成，请重试。' },
+    dialog: { close: '关闭' },
+    breadcrumb: { nav: '路径', expand: (count) => `显示全部 ${count} 级路径` },
+    combobox: { empty: '没有匹配的选项', loading: '正在搜索…', clear: '清除选择', openList: '展开选项' },
+    commandPalette: {
+        title: '命令面板',
+        inputLabel: '搜索命令',
+        placeholder: '输入命令名称或关键词…',
+        empty: '没有匹配的命令',
+        hint: '↑ ↓ 选择，Enter 执行，Esc 关闭',
+        close: '关闭命令面板',
+        loading: '正在搜索命令…',
+    },
+    dataTable: {
+        empty: '没有符合条件的记录',
+        loading: '正在加载…',
+        error: '加载失败。',
+        retry: '重试',
+        selectAll: '全选',
+        deselectAll: '取消全选',
+        selectRow: (label) => `选择 ${label}`,
+        selection: (count, offPage) => `已选 ${count} 条${offPage > 0 ? `（其中 ${offPage} 条在其他页）` : ''}`,
+    },
+    drawer: { close: '关闭' },
+    field: { optional: '（可选）' },
+    fileDropZone: {
+        prompt: '将文件拖放到此处，或',
+        browse: '选择文件',
+        rejectedType: (name) => `「${name}」的文件类型不受支持`,
+        rejectedSize: (name, limit) => `「${name}」超过 ${limit} 的大小上限`,
+        rejectedCount: (name, max) => `「${name}」未添加：最多 ${max} 个文件`,
+        accepted: (count) => `已添加 ${count} 个文件`,
+    },
+    metadataList: { missing: '未记录' },
+    numberField: { decrement: '减少', increment: '增加', roleDescription: '数字输入框' },
+    pagination: {
+        nav: '分页',
+        previous: '上一页',
+        next: '下一页',
+        page: (p) => `第 ${p} 页`,
+        compact: (p, n) => `第 ${p} / ${n} 页`,
+        status: (from, to, total) => (total === 0 ? '共 0 条' : `第 ${from}–${to} 条，共 ${total} 条`),
+    },
+    progress: { indeterminate: '进行中', meterValue: (value, state) => `${value}，${state}` },
+    recordHeader: { trail: '档案位置' },
+    select: { placeholder: '请选择' },
+    stat: { loading: '正在加载', empty: '无数据', up: '上升', down: '下降', flat: '持平' },
+    textarea: { count: (current, max) => `已输入 ${current} / ${max}` },
+    timeline: { empty: '暂无记录' },
+    toast: { close: '关闭通知', region: 'Notifications' },
+};
+/** Reference English translation (参考译文): wording may change before 1.0. */
+export const enUS = {
+    workbench: { index: 'Index', content: 'Workbench content', resize: 'Resize index', width: (width) => `Width ${width} pixels` },
+    tree: { loading: 'Loading…', empty: 'No items', retry: (name) => `Retry loading ${name}`, expand: (name) => `Expand ${name}`, collapse: (name) => `Collapse ${name}` },
+    tag: { remove: (name) => `Remove ${name}` },
+    alert: { dismiss: 'Dismiss alert' },
+    alertDialog: { cancel: 'Cancel', error: 'The action did not complete. Please try again.' },
+    dialog: { close: 'Close' },
+    breadcrumb: { nav: 'Breadcrumb', expand: (count, f) => `Show all ${f(count)} levels` },
+    combobox: { empty: 'No matching options', loading: 'Searching…', clear: 'Clear selection', openList: 'Show options' },
+    commandPalette: {
+        title: 'Command palette',
+        inputLabel: 'Search commands',
+        placeholder: 'Type a command or keyword…',
+        empty: 'No matching commands',
+        hint: '↑ ↓ to choose, Enter to run, Esc to close',
+        close: 'Close command palette',
+        loading: 'Searching commands…',
+    },
+    dataTable: {
+        empty: 'No matching records',
+        loading: 'Loading…',
+        error: 'Failed to load.',
+        retry: 'Retry',
+        selectAll: 'Select all',
+        deselectAll: 'Deselect all',
+        selectRow: (label) => `Select ${label}`,
+        selection: (count, offPage, f) => `${f(count)} selected${offPage > 0 ? ` (${f(offPage)} on other pages)` : ''}`,
+    },
+    drawer: { close: 'Close' },
+    field: { optional: '(optional)' },
+    fileDropZone: {
+        prompt: 'Drop files here, or',
+        browse: 'Choose files',
+        rejectedType: (name) => `"${name}" is not a supported file type`,
+        rejectedSize: (name, limit) => `"${name}" is larger than ${limit}`,
+        rejectedCount: (name, max, f) => `"${name}" was not added: up to ${f(max)} files`,
+        accepted: (count, f) => `${f(count)} ${count === 1 ? 'file' : 'files'} added`,
+    },
+    metadataList: { missing: 'Not recorded' },
+    numberField: { decrement: 'Decrease', increment: 'Increase', roleDescription: 'Number field' },
+    pagination: {
+        nav: 'Pagination',
+        previous: 'Previous',
+        next: 'Next',
+        page: (p, f) => `Page ${f(p)}`,
+        compact: (p, n, f) => `Page ${f(p)} of ${f(n)}`,
+        status: (from, to, total, f) => (total === 0 ? '0 items' : `${f(from)}–${f(to)} of ${f(total)} items`),
+    },
+    progress: { indeterminate: 'In progress', meterValue: (value, state) => `${value}, ${state}` },
+    recordHeader: { trail: 'Record location' },
+    select: { placeholder: 'Select…' },
+    stat: { loading: 'Loading', empty: 'No data', up: 'Up', down: 'Down', flat: 'No change' },
+    textarea: { count: (current, max, f) => `${f(current)} / ${f(max)} characters` },
+    timeline: { empty: 'No entries' },
+    toast: { close: 'Dismiss notification', region: 'Notifications' },
+};
+/** Default number locale when no provider sets one (ADR-0009 §3). Never read from the runtime. */
+export const DEFAULT_LOCALE = 'zh-CN';
+const RhineLocaleContext = React.createContext({ messages: zhCN, locale: DEFAULT_LOCALE });
+/** Shallow merge per namespace; `undefined` values in the override are ignored. */
+export function mergeMessages(base, overrides) {
+    if (!overrides)
+        return base;
+    const result = { ...base };
+    for (const [namespace, entries] of Object.entries(overrides)) {
+        if (!entries || !(namespace in base))
+            continue;
+        const merged = { ...result[namespace] };
+        for (const [key, value] of Object.entries(entries)) {
+            if (value !== undefined)
+                merged[key] = value;
+        }
+        result[namespace] = merged;
+    }
+    return result;
+}
+/** Internal: merges a provider's overrides over the outer value (shared by both providers). */
+export function useResolvedLocale(messages, locale) {
+    const outer = React.useContext(RhineLocaleContext);
+    const merged = React.useMemo(() => mergeMessages(outer.messages, messages), [outer.messages, messages]);
+    const resolvedLocale = locale ?? outer.locale;
+    return React.useMemo(() => ({ messages: merged, locale: resolvedLocale }), [merged, resolvedLocale]);
+}
+/** Internal: publishes a resolved value (used by RhineProvider). */
+export const RhineLocaleProvider = RhineLocaleContext.Provider;
+/**
+ * Copy (and number locale) for a region without its own RhineProvider. Nested providers merge
+ * with the outer one per namespace.
+ */
+export function RhineMessagesProvider({ messages, locale, children }) {
+    const value = useResolvedLocale(messages, locale);
+    return _jsx(RhineLocaleContext.Provider, { value: value, children: children });
+}
+/** The merged message table of the nearest provider (`zhCN` without one). */
+export function useRhineMessages() {
+    return React.useContext(RhineLocaleContext).messages;
+}
+/** Messages, number locale and a cached formatter of the nearest provider (also used by @wzrhine/agent). */
+export function useRhineLocale() {
+    const value = React.useContext(RhineLocaleContext);
+    const formatNumber = React.useMemo(() => {
+        const formatter = new Intl.NumberFormat(value.locale);
+        return (n) => formatter.format(n);
+    }, [value.locale]);
+    return { ...value, formatNumber };
+}
+//# sourceMappingURL=messages.js.map

package/dist/provider/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/provider/messages.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkK/B,yFAAyF;AACzF,MAAM,CAAC,MAAM,IAAI,GAAkB;IACjC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,EAAE;IAClG,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,EAAE,EAAE;IAC5I,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,EAAE,EAAE;IACvC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;IAC1B,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE;IAClD,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;IACvB,UAAU,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,KAAK,MAAM,EAAE;IACjE,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;IACjF,cAAc,EAAE;QACd,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,aAAa;QAC1B,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,SAAS;KACnB;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,EAAE;QACnC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;KAC5F;IACD,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;IACvB,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;IAC3B,YAAY,EAAE;QACZ,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,MAAM;QACd,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,YAAY;QAC5C,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,OAAO,KAAK,QAAQ;QAC3D,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI,WAAW,GAAG,MAAM;QAC1D,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,MAAM;KACxC;IACD,YAAY,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;IAChC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE;IAC3E,UAAU,EAAE;QACV,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI;QACvB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI;QACpC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;KACxF;IACD,QAAQ,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,EAAE;IACrF,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;IAC/B,MAAM,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;IAC9B,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;IACzE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,OAAO,MAAM,GAAG,EAAE,EAAE;IAChE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;IAC3B,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE;CAClD,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,IAAI,GAAkB;IACjC,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,SAAS,EAAE;IAC9H,IAAI,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,IAAI,EAAE,EAAE;IACtK,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,IAAI,EAAE,EAAE;IAC3C,KAAK,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE;IACnC,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,gDAAgD,EAAE;IAC1F,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;IAC1B,UAAU,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE;IACtF,QAAQ,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE;IACrH,cAAc,EAAE;QACd,KAAK,EAAE,iBAAiB;QACxB,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,2CAA2C;QACjD,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,qBAAqB;KAC/B;IACD,SAAS,EAAE;QACT,KAAK,EAAE,qBAAqB;QAC5B,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,YAAY;QACvB,WAAW,EAAE,cAAc;QAC3B,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,KAAK,EAAE;QACvC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE;KAChH;IACD,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;IAC1B,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;IACjC,YAAY,EAAE;QACZ,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE,cAAc;QACtB,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,gCAAgC;QAChE,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,oBAAoB,KAAK,EAAE;QAClE,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,0BAA0B,CAAC,CAAC,GAAG,CAAC,QAAQ;QACjF,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,QAAQ;KAC9E;IACD,YAAY,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE;IACzC,WAAW,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE;IAC9F,UAAU,EAAE;QACV,GAAG,EAAE,YAAY;QACjB,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;QAC/C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;KACvG;IACD,QAAQ,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,KAAK,EAAE,EAAE;IAC9F,YAAY,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAC1C,MAAM,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE;IAClC,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE;IACzF,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE;IAChF,QAAQ,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;IACjC,KAAK,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,eAAe,EAAE;CAClE,CAAC;AAEF,kGAAkG;AAClG,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAOtC,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;AAE7G,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,IAAmB,EAAE,SAA6C;IAC9F,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAA6C,CAAC;IACtE,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC;YAAE,SAAS;QAC/C,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC/C,CAAC;QACD,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;IAC7B,CAAC;IACD,OAAO,MAAkC,CAAC;AAC5C,CAAC;AAUD,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,QAA4C,EAAE,MAA0B;IACxG,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxG,MAAM,cAAc,GAAG,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;AACvG,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,QAAQ,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAA8B;IAC9F,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA+B,CAAC;AAC7F,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB;IAC9B,OAAO,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QACtC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO,CAAC,CAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACnB,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,CAAC;AACpC,CAAC"}

package/dist/provider/portal.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+export interface PortalContextValue {
+    /** The portal node, or null until the provider has mounted it. */
+    container: HTMLElement | null;
+}
+export declare const PortalContext: React.Context<PortalContextValue | null>;
+/**
+ * Portal target for popups (Dialog, Select, Tooltip, Popover, Menu, Toast). Inside a RhineProvider it
+ * is a node within the themed root, so popups inherit --rl-* tokens, theme, density and reduced
+ * motion. The value is the element itself (not a ref) so portals re-render once it exists;
+ * a null container would otherwise make Base UI fall back to <body> and lose the theme.
+ * Returns `undefined` outside a provider.
+ */
+export declare function usePortalContainer(): HTMLElement | null | undefined;
+/** True while inside a provider whose portal node is not mounted yet; popups should wait. */
+export declare function usePortalPending(): boolean;
+//# sourceMappingURL=portal.d.ts.map

package/dist/provider/portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/provider/portal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;CAC/B;AAED,eAAO,MAAM,aAAa,0CAAuD,CAAC;AAElF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,IAAI,GAAG,SAAS,CAGnE;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C"}

package/dist/provider/portal.js

@@ -0,0 +1,20 @@
+'use client';
+import * as React from 'react';
+export const PortalContext = React.createContext(null);
+/**
+ * Portal target for popups (Dialog, Select, Tooltip, Popover, Menu, Toast). Inside a RhineProvider it
+ * is a node within the themed root, so popups inherit --rl-* tokens, theme, density and reduced
+ * motion. The value is the element itself (not a ref) so portals re-render once it exists;
+ * a null container would otherwise make Base UI fall back to <body> and lose the theme.
+ * Returns `undefined` outside a provider.
+ */
+export function usePortalContainer() {
+    const ctx = React.useContext(PortalContext);
+    return ctx ? ctx.container : undefined;
+}
+/** True while inside a provider whose portal node is not mounted yet; popups should wait. */
+export function usePortalPending() {
+    const ctx = React.useContext(PortalContext);
+    return ctx !== null && ctx.container === null;
+}
+//# sourceMappingURL=portal.js.map

package/dist/provider/portal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../src/provider/portal.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAA4B,IAAI,CAAC,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAC5C,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAC5C,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC;AAChD,CAAC"}

package/dist/reset.css

@@ -0,0 +1,45 @@
+/*
+ * WzRhineLab UI · host isolation
+ * Host pages often style bare elements (button, table, th, td, h1–h3, input). Wherever a component
+ * does not set a property itself, such rules would leak in. This file resets those properties on
+ * library classes only — never on bare elements — so the host keeps its own styling.
+ * Class selectors outrank element selectors; this file is imported first, so component rules that
+ * follow still win ties. Verified against a hostile host stylesheet in examples/host-embed.
+ */
+
+:is(.rl-button, .rl-icon-button, .rl-select, .rl-tabs__tab, .rl-toast__action, .rl-toast__close, .rl-table__sort, .rl-archive-card, .rl-input__control, .rl-text) {
+  text-transform: none;
+  letter-spacing: normal;
+  text-shadow: none;
+}
+
+:is(.rl-record__title, .rl-dialog__title, .rl-popover__title, .rl-toast__title) {
+  margin: 0;
+  color: inherit;
+  font-family: var(--rl-font-body);
+  text-transform: none;
+  letter-spacing: normal;
+}
+
+:is(.rl-dialog__description, .rl-popover__description, .rl-toast__description, .rl-dialog__eyebrow) {
+  margin: 0;
+}
+
+.rl-table {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+  border: 0;
+}
+
+/* :where keeps this at class specificity so .rl-table__caption / .rl-table th still win. */
+.rl-table :where(caption, th, td) {
+  box-sizing: border-box;
+  padding: 0;
+  border: 0;
+}
+
+.rl-table__checkbox {
+  padding: 0;
+  font-size: inherit;
+}

package/dist/split.css

@@ -0,0 +1,159 @@
+/*
+ * WzRhineLab UI · M12 gap components: SplitButton, ScrollArea.
+ * Imported by components.css; tokens only (package-boundary test).
+ */
+
+/* ---------- SplitButton ---------- */
+/* One frame, two real buttons: the inner corners are squared and the seam is a single rule. */
+.rl-split-button {
+  box-sizing: border-box;
+  display: inline-flex;
+  align-items: stretch;
+  min-width: 0;
+  max-width: 100%;
+  vertical-align: middle;
+}
+
+.rl-split-button > .rl-split-button__main {
+  min-width: 0;
+  border-start-end-radius: 0;
+  border-end-end-radius: 0;
+}
+
+.rl-split-button > .rl-split-button__toggle {
+  height: auto;
+  min-height: var(--rl-icon-button-size);
+  margin-inline-start: calc(var(--rl-border-width) * -1);
+  border-start-start-radius: 0;
+  border-end-start-radius: 0;
+}
+
+/* The focused half sits above its neighbour so its ring is never clipped by the seam. */
+.rl-split-button > :focus-visible {
+  position: relative;
+  z-index: 1;
+}
+
+.rl-split-button[data-variant='primary'] > .rl-split-button__toggle:not(:disabled) {
+  border-inline-start-color: color-mix(in srgb, var(--rl-fg-inverse) 35%, var(--rl-bg-inverse));
+}
+
+.rl-split-button[data-variant='accent'] > .rl-split-button__toggle {
+  --rl-icon-button-bg: var(--rl-accent);
+  --rl-icon-button-fg: var(--rl-fg-on-accent);
+  --rl-icon-button-border: var(--rl-accent);
+  --rl-icon-button-bg-hover: var(--rl-accent-hover);
+}
+
+.rl-split-button[data-variant='accent'] > .rl-split-button__toggle:not(:disabled) {
+  border-inline-start-color: color-mix(in srgb, var(--rl-fg-on-accent) 35%, var(--rl-accent));
+}
+
+.rl-split-button[data-variant='accent'] > .rl-split-button__toggle:not(:disabled):active {
+  background: var(--rl-accent-hover);
+}
+
+.rl-split-button[data-variant='ghost'] > .rl-split-button__toggle {
+  border-inline-start-color: var(--rl-border-default);
+}
+
+.rl-split-button > .rl-split-button__toggle[aria-disabled='true'] {
+  cursor: progress;
+}
+
+.rl-split-button__toggle[data-popup-open] .rl-icon-button__icon > svg {
+  rotate: 180deg;
+}
+
+.rl-split-button__toggle .rl-icon-button__icon > svg {
+  transition: rotate var(--rl-motion-fast) var(--rl-ease-out);
+}
+
+/* ---------- ScrollArea ---------- */
+.rl-scroll-area {
+  box-sizing: border-box;
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  min-height: 0;
+  max-height: var(--rl-scroll-area-max-height, 100%);
+}
+
+.rl-scroll-area *,
+.rl-scroll-area *::before,
+.rl-scroll-area *::after {
+  box-sizing: border-box;
+}
+
+.rl-scroll-area > .rl-scroll-area__viewport {
+  flex: 1 1 auto;
+  min-width: 0;
+  min-height: 0;
+  max-height: var(--rl-scroll-area-max-height, none);
+  overscroll-behavior: contain;
+  outline: none;
+}
+
+.rl-scroll-area > .rl-scroll-area__viewport:focus-visible {
+  outline: var(--rl-focus-ring);
+  outline-offset: calc(var(--rl-focus-width) * -1);
+}
+
+.rl-scroll-area__scrollbar {
+  display: flex;
+  padding: var(--rl-border-width);
+  opacity: 0;
+  transition: opacity var(--rl-motion-fast) var(--rl-ease-out);
+  user-select: none;
+  touch-action: none;
+}
+
+.rl-scroll-area__scrollbar[data-orientation='vertical'] {
+  width: var(--rl-space-2);
+}
+
+.rl-scroll-area__scrollbar[data-orientation='horizontal'] {
+  height: var(--rl-space-2);
+}
+
+/* Visible while the pointer is over the area, while it scrolls, and while the viewport has focus. */
+.rl-scroll-area__scrollbar:is([data-hovering], [data-scrolling]),
+.rl-scroll-area:focus-within > .rl-scroll-area__scrollbar {
+  opacity: 1;
+}
+
+.rl-scroll-area__thumb {
+  flex: none;
+  border-radius: var(--rl-radius-round);
+  background: var(--rl-border-strong);
+  transition: background-color var(--rl-motion-fast) var(--rl-ease-out);
+}
+
+.rl-scroll-area__scrollbar[data-orientation='vertical'] > .rl-scroll-area__thumb {
+  width: 100%;
+}
+
+.rl-scroll-area__scrollbar[data-orientation='horizontal'] > .rl-scroll-area__thumb {
+  height: 100%;
+}
+
+@media (hover: hover) {
+  .rl-scroll-area__thumb:hover {
+    background: var(--rl-fg-muted);
+  }
+}
+
+.rl-scroll-area__thumb:active {
+  background: var(--rl-fg-primary);
+}
+
+/* ---------- Forced colours ---------- */
+@media (forced-colors: active) {
+  .rl-split-button > .rl-split-button__toggle:not(:disabled) { border-color: ButtonText; }
+  /* The overlay cannot be themed by the system: hide it and bring the native scrollbar back. */
+  .rl-scroll-area__scrollbar,
+  .rl-scroll-area__corner { display: none; }
+  .rl-scroll-area > .rl-scroll-area__viewport { scrollbar-width: thin; }
+  .rl-scroll-area > .rl-scroll-area__viewport:focus-visible { outline-color: Highlight; }
+}