@wzrhine/react 0.0.0-stage → 0.1.0

package/dist/components/Accordion.d.ts

@@ -0,0 +1,82 @@
+import * as React from 'react';
+/**
+ * Stacked disclosure sections on Base UI Accordion (ADR-0010 §2). Each header is a real heading
+ * (`headingLevel`, default 3) wrapping a `<button>` with `aria-expanded` / `aria-controls`; the
+ * panel is a labelled region. Height animates through Base UI's `--accordion-panel-height`
+ * (CSS transition, interruptible); reduced motion zeroes the duration token, so it snaps.
+ *
+ * Keyboard: Tab moves between triggers, Enter / Space toggles. Base UI 1.9 follows the updated
+ * APG guidance and no longer adds arrow-key roving focus between headers.
+ *
+ *   <Accordion items={[{ value: 'scope', title: '适用范围', content: '…' }]} />
+ *   <Accordion multiple defaultValue={['a']}>
+ *     <AccordionItem value="a" title="采样">…</AccordionItem>
+ *   </Accordion>
+ */
+export type AccordionHeadingLevel = 2 | 3 | 4 | 5 | 6;
+export interface AccordionItemData {
+    /** Stable identifier used by `value` / `defaultValue`. */
+    value: string;
+    title: React.ReactNode;
+    content: React.ReactNode;
+    /** Secondary text at the end of the trigger (count, status). Part of the button's name. */
+    meta?: React.ReactNode;
+    disabled?: boolean;
+}
+export type AccordionProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'children' | 'defaultValue' | 'onChange'> & {
+    /** Convenience data form. Ignored when `children` is given. */
+    items?: readonly AccordionItemData[];
+    /** Composition form: `AccordionItem` elements. */
+    children?: React.ReactNode;
+    /** Allow more than one item open at a time (default: opening one closes the others). */
+    multiple?: boolean;
+    value?: string[];
+    defaultValue?: string[];
+    onValueChange?: (value: string[]) => void;
+    /** Heading element wrapping each trigger; pick the level that fits the page outline. */
+    headingLevel?: AccordionHeadingLevel;
+    disabled?: boolean;
+    /** Keep closed panels in the DOM (hidden). */
+    keepMounted?: boolean;
+    /** Closed panels use `hidden="until-found"` so browser find-in-page can open them. */
+    hiddenUntilFound?: boolean;
+};
+export type AccordionItemProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'children' | 'title' | 'onChange'> & {
+    value: string;
+    title: React.ReactNode;
+    meta?: React.ReactNode;
+    disabled?: boolean;
+    /** Overrides the parent Accordion's `headingLevel`. */
+    headingLevel?: AccordionHeadingLevel;
+    children?: React.ReactNode;
+    onOpenChange?: (open: boolean) => void;
+};
+export declare const AccordionItem: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "title" | "onChange"> & {
+    value: string;
+    title: React.ReactNode;
+    meta?: React.ReactNode;
+    disabled?: boolean;
+    /** Overrides the parent Accordion's `headingLevel`. */
+    headingLevel?: AccordionHeadingLevel;
+    children?: React.ReactNode;
+    onOpenChange?: (open: boolean) => void;
+} & React.RefAttributes<HTMLDivElement>>;
+export declare const Accordion: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "defaultValue" | "onChange"> & {
+    /** Convenience data form. Ignored when `children` is given. */
+    items?: readonly AccordionItemData[];
+    /** Composition form: `AccordionItem` elements. */
+    children?: React.ReactNode;
+    /** Allow more than one item open at a time (default: opening one closes the others). */
+    multiple?: boolean;
+    value?: string[];
+    defaultValue?: string[];
+    onValueChange?: (value: string[]) => void;
+    /** Heading element wrapping each trigger; pick the level that fits the page outline. */
+    headingLevel?: AccordionHeadingLevel;
+    disabled?: boolean;
+    /** Keep closed panels in the DOM (hidden). */
+    keepMounted?: boolean;
+    /** Closed panels use `hidden="until-found"` so browser find-in-page can open them. */
+    hiddenUntilFound?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Accordion.d.ts.map

package/dist/components/Accordion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../src/components/Accordion.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC,GAAG;IAClH,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C,wFAAwF;IACxF,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC,GAAG;IAC/G,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,CAAC;AAYF,eAAO,MAAM,aAAa;WApBjB,MAAM;WACN,KAAK,CAAC,SAAS;WACf,KAAK,CAAC,SAAS;eACX,OAAO;IAClB,uDAAuD;mBACxC,qBAAqB;eACzB,KAAK,CAAC,SAAS;mBACX,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI;wCA0CtC,CAAC;AAEH,eAAO,MAAM,SAAS;IAtEpB,+DAA+D;YACvD,SAAS,iBAAiB,EAAE;IACpC,kDAAkD;eACvC,KAAK,CAAC,SAAS;IAC1B,wFAAwF;eAC7E,OAAO;YACV,MAAM,EAAE;mBACD,MAAM,EAAE;oBACP,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI;IACzC,wFAAwF;mBACzE,qBAAqB;eACzB,OAAO;IAClB,8CAA8C;kBAChC,OAAO;IACrB,sFAAsF;uBACnE,OAAO;wCAgG1B,CAAC"}

package/dist/components/Accordion.js

@@ -0,0 +1,19 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { Accordion as BaseAccordion } from '@base-ui/react/accordion';
+import { cx } from '../utils/cx.js';
+const HeadingLevelContext = React.createContext(3);
+function Chevron() {
+    return (_jsx("svg", { className: "rl-accordion__chevron", viewBox: "0 0 16 16", "aria-hidden": "true", focusable: "false", children: _jsx("path", { d: "m4 6 4 4 4-4" }) }));
+}
+export const AccordionItem = React.forwardRef(function AccordionItem({ value, title, meta, disabled, headingLevel, children, onOpenChange, className, ...rest }, ref) {
+    const inheritedLevel = React.useContext(HeadingLevelContext);
+    const Heading = `h${headingLevel ?? inheritedLevel}`;
+    return (_jsxs(BaseAccordion.Item, { ...rest, ref: ref, value: value, disabled: disabled, onOpenChange: onOpenChange ? (open) => onOpenChange(open) : undefined, className: cx('rl-accordion__item', className), children: [_jsx(BaseAccordion.Header, { className: "rl-accordion__header", render: _jsx(Heading, {}), children: _jsxs(BaseAccordion.Trigger, { className: "rl-accordion__trigger", children: [_jsx("span", { className: "rl-accordion__title", children: title }), meta != null && ' ', meta != null && _jsx("span", { className: "rl-accordion__meta", children: meta }), _jsx(Chevron, {})] }) }), _jsx(BaseAccordion.Panel, { className: "rl-accordion__panel", children: _jsx("div", { className: "rl-accordion__content", children: children }) })] }));
+});
+export const Accordion = React.forwardRef(function Accordion({ items, children, multiple = false, value, defaultValue, onValueChange, headingLevel = 3, disabled, keepMounted, hiddenUntilFound, className, ...rest }, ref) {
+    return (_jsx(HeadingLevelContext.Provider, { value: headingLevel, children: _jsx(BaseAccordion.Root, { ...rest, ref: ref, multiple: multiple, value: value, defaultValue: defaultValue, onValueChange: onValueChange ? (next) => onValueChange([...next]) : undefined, disabled: disabled, keepMounted: keepMounted, hiddenUntilFound: hiddenUntilFound, className: cx('rl-accordion', className), "data-slot": "accordion", children: children ??
+                items?.map((item) => (_jsx(AccordionItem, { value: item.value, title: item.title, meta: item.meta, disabled: item.disabled, children: item.content }, item.value))) }) }));
+});
+//# sourceMappingURL=Accordion.js.map

package/dist/components/Accordion.js.map

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

package/dist/components/Alert.d.ts

@@ -0,0 +1,60 @@
+import * as React from 'react';
+/**
+ * In-page status message and explanatory note (ADR-0006 §5). Tone is always carried by an
+ * icon and text as well as colour.
+ *
+ * `Alert` chooses its announcement explicitly with `live`: `off` (default; present on load,
+ * not announced), `polite` (`role="status"`) or `assertive` (`role="alert"`, failures only).
+ * Live regions announce changes, so render a polite Alert first and then change its content.
+ * One message, one live container: do not repeat it in a Toast. The role sits on the message
+ * text, so the action and dismiss buttons are not read out as part of the announcement.
+ * The component holds no hidden state: `onDismiss` renders a close button and the caller
+ * removes the Alert and moves focus somewhere sensible (e.g. the control that triggered it).
+ *
+ *   <Alert tone="warning" title="3 条记录未通过校验" onDismiss={hide}>导出前请先修正。</Alert>
+ *
+ * `Callout` is a side note (`role="note"`): never live, never dismissible.
+ */
+export type AlertTone = 'neutral' | 'info' | 'success' | 'warning' | 'danger';
+export type AlertLive = 'off' | 'polite' | 'assertive';
+type BaseProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'role'> & {
+    tone?: AlertTone;
+    title?: React.ReactNode;
+    children?: React.ReactNode;
+    /** Replace the tone icon; `null` removes it. */
+    icon?: React.ReactNode;
+};
+export type AlertProps = BaseProps & {
+    live?: AlertLive;
+    /** Follow-up control(s), e.g. a small Button 「查看」. */
+    action?: React.ReactNode;
+    /** Shows a close button. The caller removes the Alert and places focus. */
+    onDismiss?: () => void;
+    /** Accessible name of the close button. */
+    dismissLabel?: string;
+};
+export type CalloutProps = BaseProps;
+export declare const Alert: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLDivElement>, "role" | "title"> & {
+    tone?: AlertTone;
+    title?: React.ReactNode;
+    children?: React.ReactNode;
+    /** Replace the tone icon; `null` removes it. */
+    icon?: React.ReactNode;
+} & {
+    live?: AlertLive;
+    /** Follow-up control(s), e.g. a small Button 「查看」. */
+    action?: React.ReactNode;
+    /** Shows a close button. The caller removes the Alert and places focus. */
+    onDismiss?: () => void;
+    /** Accessible name of the close button. */
+    dismissLabel?: string;
+} & React.RefAttributes<HTMLDivElement>>;
+export declare const Callout: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLDivElement>, "role" | "title"> & {
+    tone?: AlertTone;
+    title?: React.ReactNode;
+    children?: React.ReactNode;
+    /** Replace the tone icon; `null` removes it. */
+    icon?: React.ReactNode;
+} & React.RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=Alert.d.ts.map

package/dist/components/Alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../src/components/Alert.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC9E,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEvD,KAAK,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,GAAG;IAC9E,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,gDAAgD;IAChD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG;IACnC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sDAAsD;IACtD,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC;AA2DrC,eAAO,MAAM,KAAK;WA5ET,SAAS;YACR,KAAK,CAAC,SAAS;eACZ,KAAK,CAAC,SAAS;IAC1B,gDAAgD;WACzC,KAAK,CAAC,SAAS;;WAIf,SAAS;IAChB,sDAAsD;aAC7C,KAAK,CAAC,SAAS;IACxB,2EAA2E;gBAC/D,MAAM,IAAI;IACtB,2CAA2C;mBAC5B,MAAM;wCA8ErB,CAAC;AAEH,eAAO,MAAM,OAAO;WA9FX,SAAS;YACR,KAAK,CAAC,SAAS;eACZ,KAAK,CAAC,SAAS;IAC1B,gDAAgD;WACzC,KAAK,CAAC,SAAS;wCAqGtB,CAAC"}

package/dist/components/Alert.js

@@ -0,0 +1,29 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { useRhineMessages } from '../provider/messages.js';
+import { cx } from '../utils/cx.js';
+import { IconButton } from './IconButton.js';
+const liveRole = {
+    off: undefined,
+    polite: 'status',
+    assertive: 'alert',
+};
+/** Tone glyphs; same shapes as the Toast status icon so a status reads the same everywhere. */
+function ToneIcon({ tone, className }) {
+    return (_jsxs("svg", { className: className, viewBox: "0 0 16 16", "aria-hidden": "true", focusable: "false", "data-tone": tone, children: [tone === 'success' && _jsx("path", { d: "m3.5 8.5 3 3 6-7" }), tone === 'danger' && _jsx("path", { d: "M5 5l6 6M11 5l-6 6" }), tone === 'warning' && _jsx("path", { d: "M8 2.5 14 13.5H2L8 2.5ZM8 7v2.5M8 11.5v.01" }), tone === 'info' && _jsx("path", { d: "M8 7.5V11.5M8 5v.01" }), tone === 'neutral' && _jsx("path", { d: "M4 8h8" })] }));
+}
+function CloseIcon() {
+    return (_jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", focusable: "false", className: "rl-alert__close-icon", children: _jsx("path", { d: "M4 4l8 8M12 4l-8 8" }) }));
+}
+function Message({ tone, icon, title, children, role, }) {
+    return (_jsxs("div", { className: "rl-alert__message", role: role, children: [icon === undefined ? (_jsx(ToneIcon, { tone: tone, className: "rl-alert__icon rl-alert__glyph" })) : icon === null ? null : (_jsx("span", { className: "rl-alert__icon", "aria-hidden": "true", children: icon })), _jsxs("div", { className: "rl-alert__text", children: [title != null && title !== false && _jsx("p", { className: "rl-alert__title", children: title }), children != null && children !== false && _jsx("div", { className: "rl-alert__body", children: children })] })] }));
+}
+export const Alert = React.forwardRef(function Alert({ tone = 'info', title, children, icon, live = 'off', action, onDismiss, dismissLabel, className, ...rest }, ref) {
+    const messages = useRhineMessages();
+    return (_jsxs("div", { ...rest, ref: ref, className: cx('rl-alert', className), "data-slot": "alert", "data-tone": tone, "data-live": live, children: [_jsx(Message, { tone: tone, icon: icon, title: title, role: liveRole[live], children: children }), action != null && _jsx("div", { className: "rl-alert__action", children: action }), onDismiss && (_jsx(IconButton, { className: "rl-alert__dismiss", size: "sm", variant: "ghost", icon: _jsx(CloseIcon, {}), label: dismissLabel ?? messages.alert.dismiss, onClick: onDismiss }))] }));
+});
+export const Callout = React.forwardRef(function Callout({ tone = 'info', title, children, icon, className, ...rest }, ref) {
+    return (_jsx("div", { ...rest, ref: ref, role: "note", className: cx('rl-alert', 'rl-callout', className), "data-slot": "callout", "data-tone": tone, children: _jsx(Message, { tone: tone, icon: icon, title: title, children: children }) }));
+});
+//# sourceMappingURL=Alert.js.map

package/dist/components/Alert.js.map

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

package/dist/components/AlertDialog.d.ts

@@ -0,0 +1,41 @@
+import * as React from 'react';
+/**
+ * Confirmation for destructive or irreversible actions (ADR-0006 §2) on Base UI AlertDialog:
+ * role="alertdialog", always modal, outside clicks never dismiss, Escape = cancel. Initial focus
+ * lands on the cancel button. `onConfirm` may return a Promise: while it is pending the confirm
+ * button shows `loading` (and keeps focus) and every way of cancelling is ignored; on resolve the
+ * dialog closes, on reject it stays open with `errorText` in a role="alert" message.
+ * Motion matches Dialog (backdrop fast, panel + 8px rise; opacity only when reduced).
+ */
+export type AlertDialogTone = 'danger' | 'default';
+export type AlertDialogProps = {
+    /** Element that opens the dialog (usually a Button). Omit when opening programmatically. */
+    trigger?: React.ReactElement<Record<string, unknown>>;
+    title: React.ReactNode;
+    /** Required: a confirmation must say what will happen. */
+    description: React.ReactNode;
+    /** Small archive-style label above the title, e.g. "ARCHIVE / DELETE". */
+    eyebrow?: React.ReactNode;
+    /** Extra detail about the consequences, e.g. the affected records. */
+    children?: React.ReactNode;
+    /** Label of the confirming action; name it after the action ("删除记录"), not "确定". */
+    confirmLabel: React.ReactNode;
+    cancelLabel?: React.ReactNode;
+    /** `danger` (default) fills the confirm button with the danger colour. */
+    tone?: AlertDialogTone;
+    /** Runs on confirm. Return a Promise to keep the dialog open until it settles. */
+    onConfirm: () => void | Promise<unknown>;
+    /** Shown in a role="alert" message when the Promise from `onConfirm` rejects. */
+    errorText?: React.ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Fires after the exit animation, when focus has returned. */
+    onClosed?: () => void;
+    className?: string;
+    /** The accessible name and description always come from `title` / `description`. */
+    'aria-label'?: never;
+    'aria-labelledby'?: never;
+};
+export declare function AlertDialog({ trigger, title, description, eyebrow, children, confirmLabel, cancelLabel: cancelLabelProp, tone, onConfirm, errorText: errorTextProp, open: openProp, defaultOpen, onOpenChange, onClosed, className, }: AlertDialogProps): React.JSX.Element;
+//# sourceMappingURL=AlertDialog.d.ts.map

package/dist/components/AlertDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlertDialog.d.ts","sourceRoot":"","sources":["../../src/components/AlertDialog.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B;;;;;;;GAOG;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4FAA4F;IAC5F,OAAO,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,0DAA0D;IAC1D,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,mFAAmF;IACnF,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,kFAAkF;IAClF,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,iFAAiF;IACjF,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,iBAAiB,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAOF,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,WAAW,EAAE,eAAe,EAC5B,IAAe,EACf,SAAS,EACT,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,QAAQ,EACd,WAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,SAAS,GACV,EAAE,gBAAgB,qBAmKlB"}

package/dist/components/AlertDialog.js

@@ -0,0 +1,101 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import { AlertDialog as BaseAlertDialog } from '@base-ui/react/alert-dialog';
+import { AnimatePresence, motion } from 'motion/react';
+import { useRhineMessages } from '../provider/messages.js';
+import { usePortalContainer } from '../provider/portal.js';
+import { useRhineMotion } from '../motion/useRhineMotion.js';
+import { cx } from '../utils/cx.js';
+import { Button } from './Button.js';
+const offset = 8;
+const isThenable = (value) => value != null && typeof value.then === 'function';
+export function AlertDialog({ trigger, title, description, eyebrow, children, confirmLabel, cancelLabel: cancelLabelProp, tone = 'danger', onConfirm, errorText: errorTextProp, open: openProp, defaultOpen = false, onOpenChange, onClosed, className, }) {
+    const messages = useRhineMessages();
+    const cancelLabel = cancelLabelProp === undefined ? messages.alertDialog.cancel : cancelLabelProp;
+    const errorText = errorTextProp === undefined ? messages.alertDialog.error : errorTextProp;
+    const [uncontrolled, setUncontrolled] = React.useState(defaultOpen);
+    const controlled = openProp !== undefined;
+    const open = controlled ? openProp : uncontrolled;
+    const [pending, setPending] = React.useState(false);
+    const [failures, setFailures] = React.useState(0);
+    const container = usePortalContainer();
+    const motionPrefs = useRhineMotion();
+    const rise = motionPrefs.reduced ? 0 : offset;
+    const cancelRef = React.useRef(null);
+    const confirmRef = React.useRef(null);
+    // Identifies the confirmation in flight; bumped on close / reopen / unmount so a stale
+    // promise can neither close a later opening nor set state after unmount.
+    const attempt = React.useRef(0);
+    // Each opening starts clean.
+    const [lastOpen, setLastOpen] = React.useState(open);
+    if (open !== lastOpen) {
+        setLastOpen(open);
+        setPending(false);
+        if (open)
+            setFailures(0);
+    }
+    React.useEffect(() => {
+        attempt.current += 1;
+    }, [open]);
+    React.useEffect(() => () => {
+        attempt.current += 1;
+    }, []);
+    // After a failed attempt, focus returns to the confirm button (it is focusable again).
+    React.useEffect(() => {
+        if (failures > 0)
+            confirmRef.current?.focus();
+    }, [failures]);
+    const setOpen = (next) => {
+        if (!controlled)
+            setUncontrolled(next);
+        onOpenChange?.(next);
+    };
+    const fail = () => {
+        setPending(false);
+        setFailures((n) => n + 1);
+    };
+    const handleConfirm = () => {
+        if (pending)
+            return;
+        attempt.current += 1;
+        const id = attempt.current;
+        let result;
+        try {
+            result = onConfirm();
+        }
+        catch {
+            fail();
+            return;
+        }
+        if (!isThenable(result)) {
+            setOpen(false);
+            return;
+        }
+        setPending(true);
+        result.then(() => {
+            if (attempt.current !== id)
+                return;
+            setPending(false);
+            setOpen(false);
+        }, () => {
+            if (attempt.current !== id)
+                return;
+            fail();
+        });
+    };
+    return (_jsxs(BaseAlertDialog.Root, { open: open, onOpenChange: (next, eventDetails) => {
+            // While a confirmation is in flight, cancelling would look like it undid the action.
+            if (!next && pending) {
+                eventDetails.cancel();
+                return;
+            }
+            setOpen(next);
+        }, onOpenChangeComplete: (isOpen) => {
+            if (!isOpen)
+                onClosed?.();
+        }, children: [trigger && _jsx(BaseAlertDialog.Trigger, { render: trigger }), _jsx(AnimatePresence, { children: open && (_jsxs(BaseAlertDialog.Portal, { keepMounted: true, container: container, children: [_jsx(BaseAlertDialog.Backdrop, { className: "rl-dialog__backdrop", render: _jsx(motion.div, { initial: { opacity: 0 }, animate: { opacity: 1 }, exit: { opacity: 0 }, transition: motionPrefs.get('fast') }) }), _jsxs(BaseAlertDialog.Popup, { className: cx('rl-dialog rl-alert-dialog', className), "data-slot": "alert-dialog", "data-size": "sm", "data-tone": tone, initialFocus: cancelRef, render: _jsx(motion.div, { initial: { opacity: 0, y: rise }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0, y: rise }, transition: motionPrefs.get('panel') }), children: [_jsxs("header", { className: "rl-dialog__header", children: [eyebrow != null && _jsx("p", { className: "rl-dialog__eyebrow", children: eyebrow }), _jsx(BaseAlertDialog.Title, { className: "rl-dialog__title", children: title }), _jsx(BaseAlertDialog.Description, { className: "rl-dialog__description", children: description })] }), (children != null || failures > 0) && (_jsxs("div", { className: "rl-dialog__body", children: [children, failures > 0 && (
+                                        // Remounted per failure so a repeated failure is announced again.
+                                        _jsx("p", { className: "rl-alert-dialog__error", role: "alert", children: errorText }, failures))] })), _jsxs("footer", { className: "rl-dialog__actions", children: [_jsx(BaseAlertDialog.Close, { disabled: pending, render: _jsx(Button, { ref: cancelRef, variant: "ghost", className: "rl-alert-dialog__cancel" }), children: cancelLabel }), _jsx(Button, { ref: confirmRef, className: "rl-alert-dialog__confirm", "data-tone": tone, loading: pending, onClick: handleConfirm, children: confirmLabel })] })] })] })) })] }));
+}
+//# sourceMappingURL=AlertDialog.js.map

package/dist/components/AlertDialog.js.map

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

package/dist/components/ArchiveCard.d.ts

@@ -0,0 +1,58 @@
+import * as React from 'react';
+import type { StatusKind } from './StatusBadge.js';
+/**
+ * Compact archive record for lists and grids (COMPONENTS.md "标准档案卡").
+ * Only `id` and `title` are required; every other field is hidden when missing, so
+ * the card never shows invented times, readings or permissions. When `href` or
+ * `onOpen` is set the whole card is one link/button whose name is the title; secondary
+ * metadata is attached as its description.
+ *
+ * Shared identity (opt-in, ADR-0007): with `motion="identity"` the record ID is a shared element;
+ * an `<ArchiveIdentity id>` for the same record elsewhere (e.g. a detail header) moves from the card's
+ * ID to its own place (`scene` 420ms, position only so text never stretches). Reduced motion: the
+ * detail just appears. Use it only when the detail *replaces* the card (list view → detail view):
+ * motion hides every non-leading member of a shared identity, so a card and its detail must not be
+ * on screen together. Scope duplicate lists with motion's `<LayoutGroup id>`.
+ */
+export interface ArchiveCardStatus {
+    tone: StatusKind;
+    label: React.ReactNode;
+}
+export type ArchiveCardProps = {
+    id: string;
+    title: React.ReactNode;
+    category?: React.ReactNode;
+    /** Short secondary classification, e.g. a discipline. */
+    subcategory?: React.ReactNode;
+    status?: ArchiveCardStatus;
+    /** ISO date for <time dateTime>; `updatedLabel` is the visible text (defaults to the ISO string). */
+    updatedAt?: string;
+    updatedLabel?: React.ReactNode;
+    /** Optional thumbnail. Provide `alt` that describes it, or `alt=""` when purely decorative. */
+    media?: {
+        src: string;
+        alt: string;
+    };
+    /** Navigate to the record (renders <a>). */
+    href?: string;
+    /** Open the record in place (renders <button>). Ignored when `href` is set. */
+    onOpen?: () => void;
+    /** Selected in a list/detail layout. */
+    selected?: boolean;
+    /** `row` for lists, `tile` for grids. */
+    layout?: 'row' | 'tile';
+    /** `identity`: the record ID continues into a matching `ArchiveIdentity` (list → detail). Default `none`. */
+    motion?: 'none' | 'identity';
+    className?: string;
+};
+export type ArchiveIdentityProps = {
+    /** Record ID; must match the `ArchiveCard` it continues from. */
+    id: string;
+    /** Visible text; defaults to the ID. */
+    children?: React.ReactNode;
+    className?: string;
+};
+/** Target end of an ArchiveCard shared identity, e.g. the ID line of a detail pane. */
+export declare function ArchiveIdentity({ id, children, className }: ArchiveIdentityProps): React.JSX.Element;
+export declare const ArchiveCard: React.ForwardRefExoticComponent<ArchiveCardProps & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=ArchiveCard.d.ts.map

package/dist/components/ArchiveCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchiveCard.d.ts","sourceRoot":"","sources":["../../src/components/ArchiveCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,yDAAyD;IACzD,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,+FAA+F;IAC/F,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAmBF,MAAM,MAAM,oBAAoB,GAAG;IACjC,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,oBAAoB,qBAMhF;AAED,eAAO,MAAM,WAAW,sFAgGtB,CAAC"}

package/dist/components/ArchiveCard.js

@@ -0,0 +1,40 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import * as React from 'react';
+import { motion } from 'motion/react';
+import { useRhineMotion } from '../motion/useRhineMotion.js';
+import { cx } from '../utils/cx.js';
+import { StatusBadge } from './StatusBadge.js';
+const identityKey = (id) => `rl-archive-identity:${id}`;
+function IdentityLabel({ id, className, children }) {
+    const motionPrefs = useRhineMotion();
+    return (_jsx(motion.span, { className: className, layoutId: identityKey(id), layout: "position", "data-rl-identity": id, transition: motionPrefs.resolve('layout', 'scene'), children: children }));
+}
+/** Target end of an ArchiveCard shared identity, e.g. the ID line of a detail pane. */
+export function ArchiveIdentity({ id, children, className }) {
+    return (_jsx(IdentityLabel, { id: id, className: cx('rl-archive-identity', className), children: children ?? id }));
+}
+export const ArchiveCard = React.forwardRef(function ArchiveCard({ id, title, category, subcategory, status, updatedAt, updatedLabel, media, href, onOpen, selected, layout = 'row', motion: motionMode = 'none', className }, ref) {
+    const reactId = React.useId();
+    const titleId = `${reactId}-title`;
+    const metaId = `${reactId}-meta`;
+    const hasClassification = category != null || subcategory != null;
+    const interactive = href != null || onOpen != null;
+    const body = (_jsxs(_Fragment, { children: [media && (_jsx("span", { className: "rl-archive-card__media", children: _jsx("img", { src: media.src, alt: media.alt, loading: "lazy", decoding: "async" }) })), _jsxs("span", { className: "rl-archive-card__body", children: [motionMode === 'identity' ? (_jsx(IdentityLabel, { id: id, className: "rl-archive-card__id", children: id })) : (_jsx("span", { className: "rl-archive-card__id", children: id })), _jsx("span", { className: "rl-archive-card__title", id: titleId, children: title }), hasClassification && (_jsxs("span", { className: "rl-archive-card__class", children: [category != null && _jsx("span", { children: category }), subcategory != null && _jsx("span", { children: subcategory })] }))] }), (updatedAt || status) && (_jsxs("span", { className: "rl-archive-card__aside", id: metaId, children: [updatedAt && (_jsx("time", { className: "rl-archive-card__date", dateTime: updatedAt, children: updatedLabel ?? updatedAt })), status && (_jsx(StatusBadge, { status: status.tone, size: "sm", appearance: "outline", children: status.label }))] }))] }));
+    const common = {
+        className: cx('rl-archive-card', className),
+        'data-slot': 'archive-card',
+        'data-layout': layout,
+        'data-selected': selected || undefined,
+        'data-interactive': interactive || undefined,
+    };
+    const describedBy = updatedAt || status ? metaId : undefined;
+    if (href != null) {
+        return (_jsx("a", { ...common, ref: ref, href: href, "aria-labelledby": titleId, "aria-describedby": describedBy, "aria-current": selected ? 'true' : undefined, children: body }));
+    }
+    if (onOpen != null) {
+        return (_jsx("button", { ...common, ref: ref, type: "button", onClick: onOpen, "aria-labelledby": titleId, "aria-describedby": describedBy, "aria-pressed": selected ?? undefined, children: body }));
+    }
+    return (_jsx("article", { ...common, ref: ref, "aria-labelledby": titleId, children: body }));
+});
+//# sourceMappingURL=ArchiveCard.js.map

package/dist/components/ArchiveCard.js.map

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

package/dist/components/Breadcrumb.d.ts

@@ -0,0 +1,48 @@
+import * as React from 'react';
+/**
+ * Location path (ADR-0005 §4): `<nav>` + ordered list; the last item without `href` is the
+ * current page. Separators are CSS-generated, so assistive tech reads only the items.
+ * Long paths collapse their middle items behind a button that expands in place.
+ *
+ *   <Breadcrumb items={[{ label: '档案库', href: '#/' }, { label: '样本', href: '#/samples' }, { label: 'ARC-1024' }]} />
+ */
+export interface BreadcrumbItem {
+    label: React.ReactNode;
+    /** Omit for the current page; items with `href` render as links. */
+    href?: string;
+}
+export interface BreadcrumbLinkProps {
+    href: string;
+    className: string;
+    title?: string;
+    children: React.ReactNode;
+}
+export type BreadcrumbProps = Omit<React.HTMLAttributes<HTMLElement>, 'children'> & {
+    items: readonly BreadcrumbItem[];
+    /** Accessible name of the navigation landmark. */
+    label?: string;
+    /**
+     * Collapse when the path has more than this many items: the first item and the last two stay,
+     * the rest hide behind an expand button. `0` never collapses.
+     */
+    maxItems?: number;
+    /** Accessible name of the expand button; receives the total number of levels. */
+    expandLabel?: (count: number) => string;
+    /** Render links with a router component instead of `<a>`. */
+    renderLink?: (props: BreadcrumbLinkProps) => React.ReactNode;
+};
+export declare const Breadcrumb: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLElement>, "children"> & {
+    items: readonly BreadcrumbItem[];
+    /** Accessible name of the navigation landmark. */
+    label?: string;
+    /**
+     * Collapse when the path has more than this many items: the first item and the last two stay,
+     * the rest hide behind an expand button. `0` never collapses.
+     */
+    maxItems?: number;
+    /** Accessible name of the expand button; receives the total number of levels. */
+    expandLabel?: (count: number) => string;
+    /** Render links with a router component instead of `<a>`. */
+    renderLink?: (props: BreadcrumbLinkProps) => React.ReactNode;
+} & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=Breadcrumb.d.ts.map

package/dist/components/Breadcrumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Breadcrumb.d.ts","sourceRoot":"","sources":["../../src/components/Breadcrumb.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,GAAG;IAClF,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC9D,CAAC;AAoBF,eAAO,MAAM,UAAU;WAhCd,SAAS,cAAc,EAAE;IAChC,kDAAkD;YAC1C,MAAM;IACd;;;OAGG;eACQ,MAAM;IACjB,iFAAiF;kBACnE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM;IACvC,6DAA6D;iBAChD,CAAC,KAAK,EAAE,mBAAmB,KAAK,KAAK,CAAC,SAAS;qCAyG5D,CAAC"}

package/dist/components/Breadcrumb.js

@@ -0,0 +1,55 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from 'react';
+import { useRhineLocale } from '../provider/messages.js';
+import { cx } from '../utils/cx.js';
+const textOf = (node) => typeof node === 'string' || typeof node === 'number' ? String(node) : undefined;
+/** Labels up to this many characters never shrink: truncating them would leave nothing readable. */
+const SHORT_LABEL = 4;
+/**
+ * Width (in em of the trail's mono type) of the first three characters plus an ellipsis: the
+ * narrowest an ancestor may get. Only used for labels longer than SHORT_LABEL, so the minimum
+ * is always smaller than the label itself and can never open a gap after it.
+ */
+function shrinkFloor(text) {
+    const wide = (ch) => /[\u1100-\u115f\u2e80-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe30-\ufe4f\uff00-\uff60\uffe0-\uffe6]/.test(ch);
+    // 1em per CJK glyph, 0.6em per Latin mono glyph, plus the 0.12em caps tracking each.
+    const glyphs = [...text].slice(0, 3).reduce((sum, ch) => sum + (wide(ch) ? 1.12 : 0.72), 0);
+    return Math.round((glyphs + 0.72) * 100) / 100;
+}
+export const Breadcrumb = React.forwardRef(function Breadcrumb({ items, label: labelProp, maxItems = 4, expandLabel: expandLabelProp, renderLink, className, ...rest }, ref) {
+    const { messages, formatNumber } = useRhineLocale();
+    const label = labelProp ?? messages.breadcrumb.nav;
+    const expandLabel = (count) => expandLabelProp ? expandLabelProp(count) : messages.breadcrumb.expand(count, formatNumber);
+    const [expanded, setExpanded] = React.useState(false);
+    const listRef = React.useRef(null);
+    const collapsible = maxItems > 0 && items.length > maxItems && items.length > 3;
+    const collapsed = collapsible && !expanded;
+    const hiddenFrom = 1;
+    const hiddenTo = items.length - 2;
+    const expand = () => {
+        setExpanded(true);
+        // The button disappears; move focus to the first revealed link so it is not lost.
+        requestAnimationFrame(() => {
+            listRef.current?.querySelectorAll('a, [aria-current]')[hiddenFrom]?.focus();
+        });
+    };
+    if (items.length === 0)
+        return null;
+    return (_jsx("nav", { ...rest, ref: ref, className: cx('rl-breadcrumb', className), "aria-label": rest['aria-label'] ?? label, "data-slot": "breadcrumb", children: _jsx("ol", { ref: listRef, className: "rl-breadcrumb__list", children: items.map((item, index) => {
+                if (collapsed && index >= hiddenFrom && index < hiddenTo) {
+                    if (index !== hiddenFrom)
+                        return null;
+                    return (_jsx("li", { className: "rl-breadcrumb__item", "data-collapsed": "", children: _jsx("button", { type: "button", className: "rl-breadcrumb__expand", "aria-label": expandLabel(items.length), onClick: expand, children: _jsx("span", { "aria-hidden": "true", children: "\u2026" }) }) }, "collapsed"));
+                }
+                const last = index === items.length - 1;
+                const current = last && !item.href;
+                const title = textOf(item.label);
+                // Ancestors with a long text label may shrink to a floor; everything else keeps its width.
+                const floor = !last && title && [...title].length > SHORT_LABEL ? shrinkFloor(title) : undefined;
+                return (_jsx("li", { className: "rl-breadcrumb__item", "data-shrink": floor != null || undefined, style: floor != null ? { '--rl-crumb-floor': `${floor}em` } : undefined, children: item.href ? (renderLink ? (renderLink({ href: item.href, className: 'rl-breadcrumb__link', title, children: item.label })) : (_jsx("a", { className: "rl-breadcrumb__link", href: item.href, title: title, children: item.label }))) : (_jsx("span", { className: "rl-breadcrumb__current", "aria-current": current ? 'page' : undefined, title: title, 
+                        // Focus target after expanding; never in the tab order.
+                        tabIndex: collapsible ? -1 : undefined, children: item.label })) }, index));
+            }) }) }));
+});
+//# sourceMappingURL=Breadcrumb.js.map