@skdx/react 0.26.0 → 0.28.0

package/dist/breadcrumb/Breadcrumb.d.cts

@@ -1,27 +1,27 @@
 import * as React from 'react';
-import type { BreadcrumbProps } from './types.cjs';
+import type { BreadcrumbContextValue, BreadcrumbProps } from './types.cjs';
+/** @internal Not part of the public API. Defaults `separator` to `'/'`, so a standalone `BreadcrumbSeparator` outside a `Breadcrumb` keeps its old fallback rather than throwing. */
+export declare const BreadcrumbProvider: {
+    (props: BreadcrumbContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useBreadcrumbContext: (consumerName: string) => BreadcrumbContextValue;
 /**
- * Root of a breadcrumb trail: renders a `<nav>` labelled `"Breadcrumb"` by
- * default (override via `aria-label`). Purely structural — layout and
- * separators are composed from its children.
+ * Root of a breadcrumb trail (`<nav>` with required `aria-label`). Derives
+ * anatomy from `items` or renders `children` for manual composition. No default
+ * label — missing is visible/fixable; wrong-language is not.
  *
  * @example
  * ```tsx
- * <Breadcrumb>
- *   <BreadcrumbList>
- *     <BreadcrumbItem>
- *       <BreadcrumbLink href="/">Home</BreadcrumbLink>
- *     </BreadcrumbItem>
- *     <BreadcrumbSeparator />
- *     <BreadcrumbItem>
- *       <BreadcrumbLink href="/docs">Docs</BreadcrumbLink>
- *     </BreadcrumbItem>
- *     <BreadcrumbSeparator />
- *     <BreadcrumbItem>
- *       <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
- *     </BreadcrumbItem>
- *   </BreadcrumbList>
- * </Breadcrumb>
+ * <Breadcrumb
+ *   aria-label="Breadcrumb"
+ *   items={[
+ *     { label: 'Home', href: '/' },
+ *     { label: 'Docs', href: '/docs' },
+ *     { label: 'Breadcrumb' },
+ *   ]}
+ * />
  * ```
  */
 export declare const Breadcrumb: React.ForwardRefExoticComponent<Omit<BreadcrumbProps, "ref"> & React.RefAttributes<HTMLElement>>;

package/dist/breadcrumb/Breadcrumb.d.ts

@@ -1,27 +1,27 @@
 import * as React from 'react';
-import type { BreadcrumbProps } from './types.js';
+import type { BreadcrumbContextValue, BreadcrumbProps } from './types.js';
+/** @internal Not part of the public API. Defaults `separator` to `'/'`, so a standalone `BreadcrumbSeparator` outside a `Breadcrumb` keeps its old fallback rather than throwing. */
+export declare const BreadcrumbProvider: {
+    (props: BreadcrumbContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useBreadcrumbContext: (consumerName: string) => BreadcrumbContextValue;
 /**
- * Root of a breadcrumb trail: renders a `<nav>` labelled `"Breadcrumb"` by
- * default (override via `aria-label`). Purely structural — layout and
- * separators are composed from its children.
+ * Root of a breadcrumb trail (`<nav>` with required `aria-label`). Derives
+ * anatomy from `items` or renders `children` for manual composition. No default
+ * label — missing is visible/fixable; wrong-language is not.
  *
  * @example
  * ```tsx
- * <Breadcrumb>
- *   <BreadcrumbList>
- *     <BreadcrumbItem>
- *       <BreadcrumbLink href="/">Home</BreadcrumbLink>
- *     </BreadcrumbItem>
- *     <BreadcrumbSeparator />
- *     <BreadcrumbItem>
- *       <BreadcrumbLink href="/docs">Docs</BreadcrumbLink>
- *     </BreadcrumbItem>
- *     <BreadcrumbSeparator />
- *     <BreadcrumbItem>
- *       <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
- *     </BreadcrumbItem>
- *   </BreadcrumbList>
- * </Breadcrumb>
+ * <Breadcrumb
+ *   aria-label="Breadcrumb"
+ *   items={[
+ *     { label: 'Home', href: '/' },
+ *     { label: 'Docs', href: '/docs' },
+ *     { label: 'Breadcrumb' },
+ *   ]}
+ * />
  * ```
  */
 export declare const Breadcrumb: React.ForwardRefExoticComponent<Omit<BreadcrumbProps, "ref"> & React.RefAttributes<HTMLElement>>;

package/dist/breadcrumb/Breadcrumb.js

@@ -1 +1 @@
-import*as m from"react";import{skdxPart as B}from"../utils/part.js";import{Primitive as n}from"../utils/primitive.js";import{jsx as L}from"react/jsx-runtime";var y=m.forwardRef(({"aria-label":r="Breadcrumb",...e},a)=>L(n.nav,{"aria-label":r,...e,...B("breadcrumb","root",e.className),ref:a}));y.displayName="Breadcrumb";import*as o from"react";import{skdxPart as R}from"../utils/part.js";import{Primitive as x}from"../utils/primitive.js";import{jsx as k}from"react/jsx-runtime";var t=o.forwardRef((r,e)=>k(x.ol,{...r,...R("breadcrumb","list",r.className),ref:e}));t.displayName="BreadcrumbList";import*as i from"react";import{skdxPart as N}from"../utils/part.js";import{Primitive as E}from"../utils/primitive.js";import{jsx as v}from"react/jsx-runtime";var p=i.forwardRef((r,e)=>v(E.li,{...r,...N("breadcrumb","item",r.className),ref:e}));p.displayName="BreadcrumbItem";import*as s from"react";import{skdxPart as g}from"../utils/part.js";import{Primitive as I}from"../utils/primitive.js";import{jsx as S}from"react/jsx-runtime";var d=s.forwardRef((r,e)=>S(I.a,{...r,...g("breadcrumb","link",r.className),ref:e}));d.displayName="BreadcrumbLink";import*as c from"react";import{skdxPart as w}from"../utils/part.js";import{Primitive as H}from"../utils/primitive.js";import{jsx as M}from"react/jsx-runtime";var b=c.forwardRef((r,e)=>M(H.span,{"aria-current":"page",...r,...w("breadcrumb","page",r.className),ref:e}));b.displayName="BreadcrumbPage";import*as f from"react";import{skdxPart as T}from"../utils/part.js";import{Primitive as h}from"../utils/primitive.js";import{jsx as A}from"react/jsx-runtime";var l=f.forwardRef(({children:r,...e},a)=>A(h.li,{role:"presentation","aria-hidden":"true",...e,...T("breadcrumb","separator",e.className),ref:a,children:r??"/"}));l.displayName="BreadcrumbSeparator";import*as u from"react";import{skdxPart as O}from"../utils/part.js";import{Primitive as q}from"../utils/primitive.js";import{jsx as z}from"react/jsx-runtime";var P=u.forwardRef(({children:r,...e},a)=>z(q.span,{role:"presentation","aria-hidden":"true",...e,...O("breadcrumb","ellipsis",e.className),ref:a,children:r??"\u2026"}));P.displayName="BreadcrumbEllipsis";export{y as Breadcrumb,P as BreadcrumbEllipsis,p as BreadcrumbItem,d as BreadcrumbLink,t as BreadcrumbList,b as BreadcrumbPage,l as BreadcrumbSeparator};
+import*as L from"react";import{createSafeContext as J}from"../utils/createContext.js";import{skdxPart as K}from"../utils/part.js";import{Primitive as Q}from"../utils/primitive.js";import*as R from"react";import*as b from"react";import{skdxPart as N}from"../utils/part.js";import{Primitive as E}from"../utils/primitive.js";import{jsx as I}from"react/jsx-runtime";var o=b.forwardRef(({children:e,...r},a)=>I(E.span,{role:"presentation","aria-hidden":"true",...r,...N("breadcrumb","ellipsis",r.className),ref:a,children:e??"\u2026"}));o.displayName="BreadcrumbEllipsis";import*as u from"react";import{skdxPart as g}from"../utils/part.js";import{Primitive as S}from"../utils/primitive.js";import{jsx as w}from"react/jsx-runtime";var p=u.forwardRef((e,r)=>w(S.li,{...e,...g("breadcrumb","item",e.className),ref:r}));p.displayName="BreadcrumbItem";import*as l from"react";import{skdxPart as H}from"../utils/part.js";import{Primitive as M}from"../utils/primitive.js";import{jsx as T}from"react/jsx-runtime";var i=l.forwardRef(({current:e=!1,...r},a)=>T(M.a,{"aria-current":e?"page":void 0,...r,...H("breadcrumb","link",r.className),ref:a}));i.displayName="BreadcrumbLink";import*as B from"react";import{skdxPart as h}from"../utils/part.js";import{Primitive as C}from"../utils/primitive.js";import{jsx as A}from"react/jsx-runtime";var c=B.forwardRef((e,r)=>A(C.ol,{role:"list",...e,...h("breadcrumb","list",e.className),ref:r}));c.displayName="BreadcrumbList";import*as n from"react";import{skdxPart as D}from"../utils/part.js";import{Primitive as F}from"../utils/primitive.js";import{jsx as V}from"react/jsx-runtime";var s=n.forwardRef((e,r)=>V(F.span,{"aria-current":"page",...e,...D("breadcrumb","page",e.className),ref:r}));s.displayName="BreadcrumbPage";import*as P from"react";import{skdxPart as O}from"../utils/part.js";import{Primitive as q}from"../utils/primitive.js";import{jsx as z}from"react/jsx-runtime";var d=P.forwardRef(({children:e,...r},a)=>{let t=y("BreadcrumbSeparator");return z(q.li,{role:"presentation","aria-hidden":"true",...r,...O("breadcrumb","separator",r.className),ref:a,children:e??t.separator})});d.displayName="BreadcrumbSeparator";import{jsx as m,jsxs as G}from"react/jsx-runtime";var x=({items:e=[]})=>m(c,{children:e.map((r,a)=>G(R.Fragment,{children:[a>0?m(d,{}):null,m(p,{children:r.ellipsis?m(o,{}):r.href!==void 0?m(i,{href:r.href,current:r.current,children:r.label}):m(s,{children:r.label})})]},a))});import{jsx as f}from"react/jsx-runtime";var[U,y]=J("Breadcrumb",{separator:"/"}),k=L.forwardRef(({separator:e="/",items:r,children:a,...t},v)=>f(U,{separator:e,children:f(Q.nav,{...t,...K("breadcrumb","root",t.className),ref:v,children:a??f(x,{items:r})})}));k.displayName="Breadcrumb";export{k as Breadcrumb,o as BreadcrumbEllipsis,p as BreadcrumbItem,i as BreadcrumbLink,c as BreadcrumbList,s as BreadcrumbPage,U as BreadcrumbProvider,d as BreadcrumbSeparator,y as useBreadcrumbContext};

package/dist/breadcrumb/BreadcrumbAnatomy.d.cts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { BreadcrumbItem as BreadcrumbItemData } from './types.cjs';
+/**
+ * The anatomy a {@link Breadcrumb} draws from `items`: the list with one
+ * `BreadcrumbItem` per entry (holding a Link, Page, or Ellipsis) and a
+ * `BreadcrumbSeparator` before each except the first.
+ *
+ * A crumb with no `href` renders as `BreadcrumbPage` with `aria-current="page"`.
+ *
+ * @internal
+ */
+export declare const BreadcrumbAnatomy: ({ items }: {
+    items?: BreadcrumbItemData[];
+}) => React.JSX.Element;

package/dist/breadcrumb/BreadcrumbAnatomy.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { BreadcrumbItem as BreadcrumbItemData } from './types.js';
+/**
+ * The anatomy a {@link Breadcrumb} draws from `items`: the list with one
+ * `BreadcrumbItem` per entry (holding a Link, Page, or Ellipsis) and a
+ * `BreadcrumbSeparator` before each except the first.
+ *
+ * A crumb with no `href` renders as `BreadcrumbPage` with `aria-current="page"`.
+ *
+ * @internal
+ */
+export declare const BreadcrumbAnatomy: ({ items }: {
+    items?: BreadcrumbItemData[];
+}) => React.JSX.Element;

package/dist/breadcrumb/BreadcrumbEllipsis.d.cts

@@ -1,16 +1,14 @@
 import * as React from 'react';
 import type { BreadcrumbEllipsisProps } from './types.cjs';
 /**
- * Placeholder standing in for collapsed middle items in a long trail: renders
- * a `<span>` with `role="presentation"` and `aria-hidden="true"`. Defaults to
- * `…`; pass `children` to override the glyph.
+ * Placeholder for collapsed middle items: a `<span>` with
+ * `role="presentation"` and `aria-hidden`. Defaults to `…`; pass `children`
+ * to override.
  *
- * Decorative only — never nest an interactive trigger (a menu button revealing
- * the collapsed items) inside it. Interactive content in an `aria-hidden`
- * subtree is unreachable to screen readers while still being tab-focusable.
- * Use it only when the collapsed items are genuinely unreachable; when they
- * are reachable, put a real `DropdownMenuTrigger` in the `BreadcrumbItem`
- * instead and skip `BreadcrumbEllipsis` entirely.
+ * Never nest interactive triggers inside. Interactive content in `aria-hidden`
+ * subtrees is unreachable to screen readers but still focusable. Use only when
+ * collapsed items are genuinely unreachable; put interactive triggers in the
+ * `BreadcrumbItem` instead.
  *
  * @example
  * ```tsx

package/dist/breadcrumb/BreadcrumbEllipsis.d.ts

@@ -1,16 +1,14 @@
 import * as React from 'react';
 import type { BreadcrumbEllipsisProps } from './types.js';
 /**
- * Placeholder standing in for collapsed middle items in a long trail: renders
- * a `<span>` with `role="presentation"` and `aria-hidden="true"`. Defaults to
- * `…`; pass `children` to override the glyph.
+ * Placeholder for collapsed middle items: a `<span>` with
+ * `role="presentation"` and `aria-hidden`. Defaults to `…`; pass `children`
+ * to override.
  *
- * Decorative only — never nest an interactive trigger (a menu button revealing
- * the collapsed items) inside it. Interactive content in an `aria-hidden`
- * subtree is unreachable to screen readers while still being tab-focusable.
- * Use it only when the collapsed items are genuinely unreachable; when they
- * are reachable, put a real `DropdownMenuTrigger` in the `BreadcrumbItem`
- * instead and skip `BreadcrumbEllipsis` entirely.
+ * Never nest interactive triggers inside. Interactive content in `aria-hidden`
+ * subtrees is unreachable to screen readers but still focusable. Use only when
+ * collapsed items are genuinely unreachable; put interactive triggers in the
+ * `BreadcrumbItem` instead.
  *
  * @example
  * ```tsx

package/dist/breadcrumb/BreadcrumbLink.d.cts

@@ -1,14 +1,21 @@
 import * as React from 'react';
 import type { BreadcrumbLinkProps } from './types.cjs';
 /**
- * A navigable ancestor in the trail: renders a plain `<a>`. Pass `href` (or
- * `asChild` with your router's link component) for actual navigation.
+ * A navigable ancestor in the trail: renders `<a>`. Pass `href` (or `asChild`
+ * with your router's link) for navigation.
+ *
+ * Set `current` when this is the current page (mandatory `aria-current='page'`
+ * for breadcrumbs; skin already styles it). Use {@link BreadcrumbPage} for
+ * non-navigable current pages.
  *
  * @example
  * ```tsx
  * <BreadcrumbItem>
  *   <BreadcrumbLink href="/">Home</BreadcrumbLink>
  * </BreadcrumbItem>
+ * <BreadcrumbItem>
+ *   <BreadcrumbLink href="/settings" current>Settings</BreadcrumbLink>
+ * </BreadcrumbItem>
  * ```
  */
 export declare const BreadcrumbLink: React.ForwardRefExoticComponent<Omit<BreadcrumbLinkProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;

package/dist/breadcrumb/BreadcrumbLink.d.ts

@@ -1,14 +1,21 @@
 import * as React from 'react';
 import type { BreadcrumbLinkProps } from './types.js';
 /**
- * A navigable ancestor in the trail: renders a plain `<a>`. Pass `href` (or
- * `asChild` with your router's link component) for actual navigation.
+ * A navigable ancestor in the trail: renders `<a>`. Pass `href` (or `asChild`
+ * with your router's link) for navigation.
+ *
+ * Set `current` when this is the current page (mandatory `aria-current='page'`
+ * for breadcrumbs; skin already styles it). Use {@link BreadcrumbPage} for
+ * non-navigable current pages.
  *
  * @example
  * ```tsx
  * <BreadcrumbItem>
  *   <BreadcrumbLink href="/">Home</BreadcrumbLink>
  * </BreadcrumbItem>
+ * <BreadcrumbItem>
+ *   <BreadcrumbLink href="/settings" current>Settings</BreadcrumbLink>
+ * </BreadcrumbItem>
  * ```
  */
 export declare const BreadcrumbLink: React.ForwardRefExoticComponent<Omit<BreadcrumbLinkProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;

package/dist/breadcrumb/BreadcrumbList.d.cts

@@ -1,8 +1,9 @@
 import * as React from 'react';
 import type { BreadcrumbListProps } from './types.cjs';
 /**
- * Ordered list (`<ol>`) that holds the trail's {@link BreadcrumbItem}s and
- * {@link BreadcrumbSeparator}s.
+ * Ordered list that holds the trail's items and separators.
+ * `role="list"` is explicit since Safari/VoiceOver drops list semantics from
+ * marker-less `<ol>`.
  *
  * @example
  * ```tsx

package/dist/breadcrumb/BreadcrumbList.d.ts

@@ -1,8 +1,9 @@
 import * as React from 'react';
 import type { BreadcrumbListProps } from './types.js';
 /**
- * Ordered list (`<ol>`) that holds the trail's {@link BreadcrumbItem}s and
- * {@link BreadcrumbSeparator}s.
+ * Ordered list that holds the trail's items and separators.
+ * `role="list"` is explicit since Safari/VoiceOver drops list semantics from
+ * marker-less `<ol>`.
  *
  * @example
  * ```tsx

package/dist/breadcrumb/BreadcrumbSeparator.d.cts

@@ -1,9 +1,8 @@
 import * as React from 'react';
 import type { BreadcrumbSeparatorProps } from './types.cjs';
 /**
- * Divider between two {@link BreadcrumbItem}s: renders an `<li>` with
- * `role="presentation"` and `aria-hidden="true"` so assistive tech skips it.
- * Defaults to `/`; pass `children` (e.g. an icon) to override.
+ * Divider between {@link BreadcrumbItem}s: `<li role="presentation"
+ * aria-hidden="true">`. Falls back to root's `separator`; pass `children` to override.
  *
  * @example
  * ```tsx

package/dist/breadcrumb/BreadcrumbSeparator.d.ts

@@ -1,9 +1,8 @@
 import * as React from 'react';
 import type { BreadcrumbSeparatorProps } from './types.js';
 /**
- * Divider between two {@link BreadcrumbItem}s: renders an `<li>` with
- * `role="presentation"` and `aria-hidden="true"` so assistive tech skips it.
- * Defaults to `/`; pass `children` (e.g. an icon) to override.
+ * Divider between {@link BreadcrumbItem}s: `<li role="presentation"
+ * aria-hidden="true">`. Falls back to root's `separator`; pass `children` to override.
  *
  * @example
  * ```tsx

package/dist/breadcrumb/index.d.cts

@@ -1,8 +1,2 @@
-export * from './Breadcrumb.cjs';
-export { BreadcrumbList } from './BreadcrumbList.cjs';
-export { BreadcrumbItem } from './BreadcrumbItem.cjs';
-export { BreadcrumbLink } from './BreadcrumbLink.cjs';
-export { BreadcrumbPage } from './BreadcrumbPage.cjs';
-export { BreadcrumbSeparator } from './BreadcrumbSeparator.cjs';
-export { BreadcrumbEllipsis } from './BreadcrumbEllipsis.cjs';
-export type { BreadcrumbProps, BreadcrumbListProps, BreadcrumbItemProps, BreadcrumbLinkProps, BreadcrumbPageProps, BreadcrumbSeparatorProps, BreadcrumbEllipsisProps, } from './types.cjs';
+export { Breadcrumb } from './Breadcrumb.cjs';
+export type { BreadcrumbProps, BreadcrumbItem } from './types.cjs';

package/dist/breadcrumb/index.d.ts

@@ -1,8 +1,2 @@
-export * from './Breadcrumb.js';
-export { BreadcrumbList } from './BreadcrumbList.js';
-export { BreadcrumbItem } from './BreadcrumbItem.js';
-export { BreadcrumbLink } from './BreadcrumbLink.js';
-export { BreadcrumbPage } from './BreadcrumbPage.js';
-export { BreadcrumbSeparator } from './BreadcrumbSeparator.js';
-export { BreadcrumbEllipsis } from './BreadcrumbEllipsis.js';
-export type { BreadcrumbProps, BreadcrumbListProps, BreadcrumbItemProps, BreadcrumbLinkProps, BreadcrumbPageProps, BreadcrumbSeparatorProps, BreadcrumbEllipsisProps, } from './types.js';
+export { Breadcrumb } from './Breadcrumb.js';
+export type { BreadcrumbProps, BreadcrumbItem } from './types.js';

package/dist/breadcrumb/primitives.d.cts

@@ -0,0 +1,32 @@
+/**
+ * Primitives for `Breadcrumb` — manual composition escape hatch.
+ *
+ * @example
+ * ```tsx
+ * import { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbSeparator, BreadcrumbPage, BreadcrumbEllipsis } from '@skdx/react/primitives/breadcrumb';
+ *
+ * <Breadcrumb aria-label="Breadcrumb">
+ *   <BreadcrumbList>
+ *     <BreadcrumbItem>
+ *       <BreadcrumbLink href="/">Home</BreadcrumbLink>
+ *     </BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem>
+ *       <BreadcrumbEllipsis />
+ *     </BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem>
+ *       <BreadcrumbPage>Settings</BreadcrumbPage>
+ *     </BreadcrumbItem>
+ *   </BreadcrumbList>
+ * </Breadcrumb>
+ * ```
+ */
+export { Breadcrumb } from './Breadcrumb.cjs';
+export { BreadcrumbList } from './BreadcrumbList.cjs';
+export { BreadcrumbItem } from './BreadcrumbItem.cjs';
+export { BreadcrumbLink } from './BreadcrumbLink.cjs';
+export { BreadcrumbPage } from './BreadcrumbPage.cjs';
+export { BreadcrumbSeparator } from './BreadcrumbSeparator.cjs';
+export { BreadcrumbEllipsis } from './BreadcrumbEllipsis.cjs';
+export type { BreadcrumbProps, BreadcrumbListProps, BreadcrumbItemProps, BreadcrumbLinkProps, BreadcrumbPageProps, BreadcrumbSeparatorProps, BreadcrumbEllipsisProps, } from './types.cjs';

package/dist/breadcrumb/primitives.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Primitives for `Breadcrumb` — manual composition escape hatch.
+ *
+ * @example
+ * ```tsx
+ * import { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbSeparator, BreadcrumbPage, BreadcrumbEllipsis } from '@skdx/react/primitives/breadcrumb';
+ *
+ * <Breadcrumb aria-label="Breadcrumb">
+ *   <BreadcrumbList>
+ *     <BreadcrumbItem>
+ *       <BreadcrumbLink href="/">Home</BreadcrumbLink>
+ *     </BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem>
+ *       <BreadcrumbEllipsis />
+ *     </BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem>
+ *       <BreadcrumbPage>Settings</BreadcrumbPage>
+ *     </BreadcrumbItem>
+ *   </BreadcrumbList>
+ * </Breadcrumb>
+ * ```
+ */
+export { Breadcrumb } from './Breadcrumb.js';
+export { BreadcrumbList } from './BreadcrumbList.js';
+export { BreadcrumbItem } from './BreadcrumbItem.js';
+export { BreadcrumbLink } from './BreadcrumbLink.js';
+export { BreadcrumbPage } from './BreadcrumbPage.js';
+export { BreadcrumbSeparator } from './BreadcrumbSeparator.js';
+export { BreadcrumbEllipsis } from './BreadcrumbEllipsis.js';
+export type { BreadcrumbProps, BreadcrumbListProps, BreadcrumbItemProps, BreadcrumbLinkProps, BreadcrumbPageProps, BreadcrumbSeparatorProps, BreadcrumbEllipsisProps, } from './types.js';

package/dist/breadcrumb/types.d.cts

@@ -1,6 +1,58 @@
+import type * as React from 'react';
 import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
+/** One entry of {@link BreadcrumbProps.items} — a crumb in the trail. */
+export interface BreadcrumbItem {
+    /**
+     * Text rendered inside the derived `BreadcrumbLink` or `BreadcrumbPage`. Omit it on an
+     * `ellipsis` entry, which renders no text of its own.
+     * @default undefined — nothing is rendered inside the crumb.
+     */
+    label?: React.ReactNode;
+    /**
+     * Destination of the derived `BreadcrumbLink`. Omit it and the crumb renders as a
+     * `BreadcrumbPage` instead — the current page, not navigable.
+     * @default undefined — rendered as a `BreadcrumbPage`.
+     */
+    href?: string;
+    /**
+     * Marks a *link* crumb as the current page, emitting `aria-current="page"`.
+     * A crumb with no `href` is a `BreadcrumbPage` and already carries it.
+     * @default false
+     */
+    current?: boolean;
+    /**
+     * Renders the collapsed-items placeholder (`…`) instead of a link or a
+     * page. Decorative and `aria-hidden`; use it only when the collapsed crumbs
+     * are genuinely unreachable.
+     * @default false
+     */
+    ellipsis?: boolean;
+}
+/** @internal Shared state distributed from {@link Breadcrumb} to `BreadcrumbSeparator` via context. Not part of the public API. */
+export interface BreadcrumbContextValue {
+    /** Glyph a childless `BreadcrumbSeparator` falls back to. */
+    separator: string;
+}
 /** Props for the {@link Breadcrumb} root. */
 export interface BreadcrumbProps extends PrimitivePropsWithRef<'nav'> {
+    /**
+     * Accessible name for the `<nav>` landmark. Required — provide a unique,
+     * translatable name that distinguishes this breadcrumb from other navigation.
+     */
+    'aria-label': string;
+    /**
+     * The trail, rendered into a derived `BreadcrumbList` holding one `BreadcrumbItem` per entry
+     * with a `BreadcrumbSeparator` between them. Ignored when `children` is given, which
+     * switches to full manual composition.
+     * @default undefined — an empty trail.
+     */
+    items?: BreadcrumbItem[];
+    /**
+     * Glyph every `BreadcrumbSeparator` with no children falls back to. A
+     * `BreadcrumbSeparator` with children overrides this per-crumb.
+     * @default '/'
+     */
+    separator?: string;
 }
 /** Props for {@link BreadcrumbList}, the ordered list of breadcrumb items. */
 export interface BreadcrumbListProps extends PrimitivePropsWithRef<'ol'> {
@@ -10,6 +62,11 @@ export interface BreadcrumbItemProps extends PrimitivePropsWithRef<'li'> {
 }
 /** Props for a {@link BreadcrumbLink}, a navigable ancestor in the trail. */
 export interface BreadcrumbLinkProps extends PrimitivePropsWithRef<'a'> {
+    /**
+     * Marks this link as the current page, emitting `aria-current="page"`.
+     * @default false
+     */
+    current?: boolean;
 }
 /** Props for {@link BreadcrumbPage}, the current (non-link) page. */
 export interface BreadcrumbPageProps extends PrimitivePropsWithRef<'span'> {

package/dist/breadcrumb/types.d.ts

@@ -1,6 +1,58 @@
+import type * as React from 'react';
 import type { PrimitivePropsWithRef } from '../utils/primitive.js';
+/** One entry of {@link BreadcrumbProps.items} — a crumb in the trail. */
+export interface BreadcrumbItem {
+    /**
+     * Text rendered inside the derived `BreadcrumbLink` or `BreadcrumbPage`. Omit it on an
+     * `ellipsis` entry, which renders no text of its own.
+     * @default undefined — nothing is rendered inside the crumb.
+     */
+    label?: React.ReactNode;
+    /**
+     * Destination of the derived `BreadcrumbLink`. Omit it and the crumb renders as a
+     * `BreadcrumbPage` instead — the current page, not navigable.
+     * @default undefined — rendered as a `BreadcrumbPage`.
+     */
+    href?: string;
+    /**
+     * Marks a *link* crumb as the current page, emitting `aria-current="page"`.
+     * A crumb with no `href` is a `BreadcrumbPage` and already carries it.
+     * @default false
+     */
+    current?: boolean;
+    /**
+     * Renders the collapsed-items placeholder (`…`) instead of a link or a
+     * page. Decorative and `aria-hidden`; use it only when the collapsed crumbs
+     * are genuinely unreachable.
+     * @default false
+     */
+    ellipsis?: boolean;
+}
+/** @internal Shared state distributed from {@link Breadcrumb} to `BreadcrumbSeparator` via context. Not part of the public API. */
+export interface BreadcrumbContextValue {
+    /** Glyph a childless `BreadcrumbSeparator` falls back to. */
+    separator: string;
+}
 /** Props for the {@link Breadcrumb} root. */
 export interface BreadcrumbProps extends PrimitivePropsWithRef<'nav'> {
+    /**
+     * Accessible name for the `<nav>` landmark. Required — provide a unique,
+     * translatable name that distinguishes this breadcrumb from other navigation.
+     */
+    'aria-label': string;
+    /**
+     * The trail, rendered into a derived `BreadcrumbList` holding one `BreadcrumbItem` per entry
+     * with a `BreadcrumbSeparator` between them. Ignored when `children` is given, which
+     * switches to full manual composition.
+     * @default undefined — an empty trail.
+     */
+    items?: BreadcrumbItem[];
+    /**
+     * Glyph every `BreadcrumbSeparator` with no children falls back to. A
+     * `BreadcrumbSeparator` with children overrides this per-crumb.
+     * @default '/'
+     */
+    separator?: string;
 }
 /** Props for {@link BreadcrumbList}, the ordered list of breadcrumb items. */
 export interface BreadcrumbListProps extends PrimitivePropsWithRef<'ol'> {
@@ -10,6 +62,11 @@ export interface BreadcrumbItemProps extends PrimitivePropsWithRef<'li'> {
 }
 /** Props for a {@link BreadcrumbLink}, a navigable ancestor in the trail. */
 export interface BreadcrumbLinkProps extends PrimitivePropsWithRef<'a'> {
+    /**
+     * Marks this link as the current page, emitting `aria-current="page"`.
+     * @default false
+     */
+    current?: boolean;
 }
 /** Props for {@link BreadcrumbPage}, the current (non-link) page. */
 export interface BreadcrumbPageProps extends PrimitivePropsWithRef<'span'> {

package/dist/button/Button.cjs

@@ -1 +1 @@
-"use strict";var s=Object.create;var a=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var B=Object.getOwnPropertyNames;var b=Object.getPrototypeOf,P=Object.prototype.hasOwnProperty;var c=(t,o)=>{for(var e in o)a(t,e,{get:o[e],enumerable:!0})},p=(t,o,e,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of B(o))!P.call(t,r)&&r!==e&&a(t,r,{get:()=>o[r],enumerable:!(n=y(o,r))||n.enumerable});return t};var l=(t,o,e)=>(e=t!=null?s(b(t)):{},p(o||!t||!t.__esModule?a(e,"default",{value:t,enumerable:!0}):e,t)),x=t=>p(a({},"__esModule",{value:!0}),t);var R={};c(R,{Button:()=>u});module.exports=x(R);var m=l(require("react"),1),d=require("../utils/part.cjs"),f=require("../utils/primitive.cjs"),i=require("react/jsx-runtime"),u=m.forwardRef(({loading:t,disabled:o,type:e="button",...n},r)=>(0,i.jsx)(f.Primitive.button,{type:e,disabled:o||t,"aria-busy":t||void 0,"data-disabled":o?"":void 0,"data-loading":t?"":void 0,...n,...(0,d.skdxPart)("button","root",n.className),ref:r}));u.displayName="Button";0&&(module.exports={Button});
+"use strict";var C=Object.create;var d=Object.defineProperty;var D=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var N=Object.getPrototypeOf,T=Object.prototype.hasOwnProperty;var V=(t,n)=>{for(var e in n)d(t,e,{get:n[e],enumerable:!0})},y=(t,n,e,a)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of M(n))!T.call(t,o)&&o!==e&&d(t,o,{get:()=>n[o],enumerable:!(a=D(n,o))||a.enumerable});return t};var w=(t,n,e)=>(e=t!=null?C(N(t)):{},y(n||!t||!t.__esModule?d(e,"default",{value:t,enumerable:!0}):e,t)),O=t=>y(d({},"__esModule",{value:!0}),t);var j={};V(j,{Button:()=>v});module.exports=O(j);var r=w(require("react"),1),B=require("../utils/part.cjs"),P=require("../utils/primitive.cjs"),x=require("../utils/visuallyHidden.cjs"),i=require("react/jsx-runtime"),v=r.forwardRef(({loading:t=!1,loadingLabel:n="Loading",disabled:e=!1,focusableWhenDisabled:a=!1,type:o="button",as:c="button",onClick:E,...s},R)=>{let H=e&&a||t&&!e,I=t&&!e,l=e&&!a,u=c==="button",m=l&&!u,p=H||m,b=r.useId(),L=[s["aria-describedby"],t?b:void 0].filter(Boolean).join(" ")||void 0,h=f=>{if(p){f.preventDefault(),f.stopPropagation();return}E?.(f)},k=P.Primitive[c];return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(k,{type:u?o:void 0,disabled:u?l:void 0,"aria-disabled":p||void 0,"aria-busy":I||void 0,tabIndex:e&&a?0:m?-1:void 0,"data-disabled":e||t?"":void 0,"data-loading":t?"":void 0,...s,"aria-describedby":L,onClick:h,...(0,B.skdxPart)("button","root",s.className),ref:R}),t&&(0,i.jsx)(x.VisuallyHidden,{id:b,children:n})]})});v.displayName="Button";0&&(module.exports={Button});

package/dist/button/Button.d.cts

@@ -1,9 +1,15 @@
 import * as React from 'react';
 import type { ButtonProps } from './types.cjs';
 /**
- * Headless `<button>`. Defaults `type` to `"button"` (so it doesn't
- * accidentally submit a form), disables itself while `loading`, and sets
- * `aria-busy` plus `data-disabled` / `data-loading` hooks for theming.
+ * Headless `<button>`. Defaults `type` to `"button"`, soft-disables while loading,
+ * and sets `aria-busy` plus `data-disabled` / `data-loading` for styling.
+ *
+ * `loading` emits `aria-disabled="true"` + `aria-busy="true"` but not `disabled` attribute,
+ * keeping focus and tab-stop while suppressing clicks. Use `focusableWhenDisabled` to
+ * soft-disable the button permanently, needed for toolbar/menu disabled actions.
+ *
+ * `as` renders a different tag; off `<button>`, native type/disabled are dropped.
+ * `asChild` outranks `as`.
  *
  * @example
  * ```tsx

package/dist/button/Button.d.ts

@@ -1,9 +1,15 @@
 import * as React from 'react';
 import type { ButtonProps } from './types.js';
 /**
- * Headless `<button>`. Defaults `type` to `"button"` (so it doesn't
- * accidentally submit a form), disables itself while `loading`, and sets
- * `aria-busy` plus `data-disabled` / `data-loading` hooks for theming.
+ * Headless `<button>`. Defaults `type` to `"button"`, soft-disables while loading,
+ * and sets `aria-busy` plus `data-disabled` / `data-loading` for styling.
+ *
+ * `loading` emits `aria-disabled="true"` + `aria-busy="true"` but not `disabled` attribute,
+ * keeping focus and tab-stop while suppressing clicks. Use `focusableWhenDisabled` to
+ * soft-disable the button permanently, needed for toolbar/menu disabled actions.
+ *
+ * `as` renders a different tag; off `<button>`, native type/disabled are dropped.
+ * `asChild` outranks `as`.
  *
  * @example
  * ```tsx

package/dist/button/Button.js

@@ -1 +1 @@
-import*as r from"react";import{skdxPart as p}from"../utils/part.js";import{Primitive as m}from"../utils/primitive.js";import{jsx as f}from"react/jsx-runtime";var d=r.forwardRef(({loading:t,disabled:o,type:n="button",...e},a)=>f(m.button,{type:n,disabled:o||t,"aria-busy":t||void 0,"data-disabled":o?"":void 0,"data-loading":t?"":void 0,...e,...p("button","root",e.className),ref:a}));d.displayName="Button";export{d as Button};
+import*as n from"react";import{skdxPart as R}from"../utils/part.js";import{Primitive as H}from"../utils/primitive.js";import{VisuallyHidden as I}from"../utils/visuallyHidden.js";import{Fragment as h,jsx as l,jsxs as k}from"react/jsx-runtime";var L=n.forwardRef(({loading:t=!1,loadingLabel:m="Loading",disabled:e=!1,focusableWhenDisabled:o=!1,type:p="button",as:r="button",onClick:b,...i},y)=>{let B=e&&o||t&&!e,P=t&&!e,s=e&&!o,a=r==="button",u=s&&!a,f=B||u,c=n.useId(),x=[i["aria-describedby"],t?c:void 0].filter(Boolean).join(" ")||void 0,v=d=>{if(f){d.preventDefault(),d.stopPropagation();return}b?.(d)},E=H[r];return k(h,{children:[l(E,{type:a?p:void 0,disabled:a?s:void 0,"aria-disabled":f||void 0,"aria-busy":P||void 0,tabIndex:e&&o?0:u?-1:void 0,"data-disabled":e||t?"":void 0,"data-loading":t?"":void 0,...i,"aria-describedby":x,onClick:v,...R("button","root",i.className),ref:y}),t&&l(I,{id:c,children:m})]})});L.displayName="Button";export{L as Button};