@jirawatpyk/aura-react 5.7.3 → 5.9.0

package/dist/icons/index.d.cts

@@ -0,0 +1,106 @@
+import * as React$1 from 'react';
+
+/** An AURA icon name, or any icon element (e.g. `<Building />` from lucide-react). AURA sizes it and hides it from screen readers. */
+export type IconInput = IconName | React$1.ReactElement;
+export type IconName = "check" | "x" | "plus" | "minus" | "search" | "chevron-down" | "chevron-up" | "chevron-left" | "chevron-right" | "arrow-right" | "arrow-up-right" | "arrow-up-down" | "loader-circle" | "circle-alert" | "circle-check" | "info" | "triangle-alert" | "settings" | "user" | "users" | "filter" | "ellipsis" | "external-link" | "copy" | "trash-2" | "pencil" | "download" | "upload" | "calendar" | "bell" | "menu" | "eye" | "log-out" | "circle" | "circle-dot-dashed" | "ban" | "arrow-up" | "arrow-down" | "inbox" | "pin" | "pin-off" | "eye-off" | "columns-3" | "arrow-left" | "rotate-ccw" | "house" | "layout-dashboard" | "folder" | "chart-column" | "file-text" | "mail" | "lock" | "clock" | "trending-up" | "trending-down" | "image" | "paperclip" | "cloud-upload" | "file" | "sun" | "moon" | "monitor" | "panel-left-close" | "panel-left-open" | "server" | "globe" | "activity" | "shield-alert" | "phone" | "wrench";
+/** Lucide stroke icon drawn inline in currentColor. */
+export interface IconProps {
+	/** A name from the set, or an icon element of your own (sized and styled the same way). */
+	name: IconInput;
+	/** `sm` 16 (default) · `md` 20 · `lg` 24, or a px number. */
+	size?: "sm" | "md" | "lg" | number | undefined;
+	/** Accessible name. Omit for decorative icons next to a text label (then aria-hidden). */
+	label?: string | undefined;
+	/** Default 2 (Lucide's). */
+	strokeWidth?: number | undefined;
+	className?: string | undefined;
+}
+/** One SVG child: element name and its attributes. */
+export type IconShape = [
+	string,
+	Record<string, string>
+];
+/** An AURA icon component from `@jirawatpyk/aura-react/icons` (5.9), e.g. `IconUsers`. */
+export type AuraIcon = React$1.ForwardRefExoticComponent<Omit<IconProps, "name"> & React$1.RefAttributes<SVGSVGElement>> & {
+	/** The icon's path data. */
+	readonly auraShapes: IconShape[];
+	/** Its name in the set, e.g. `users`. */
+	readonly iconName: string;
+};
+/** Makes an icon component from path data (24×24, stroked in currentColor, like Lucide). The per-icon exports are
+ * built with it; use it for an icon of your own that should look and behave exactly like AURA's. */
+export declare function defineIcon(name: string, shapes: IconShape[]): AuraIcon;
+export declare const IconCheck: AuraIcon;
+export declare const IconX: AuraIcon;
+export declare const IconPlus: AuraIcon;
+export declare const IconMinus: AuraIcon;
+export declare const IconSearch: AuraIcon;
+export declare const IconChevronDown: AuraIcon;
+export declare const IconChevronUp: AuraIcon;
+export declare const IconChevronLeft: AuraIcon;
+export declare const IconChevronRight: AuraIcon;
+export declare const IconArrowRight: AuraIcon;
+export declare const IconArrowUpRight: AuraIcon;
+export declare const IconArrowUpDown: AuraIcon;
+export declare const IconLoaderCircle: AuraIcon;
+export declare const IconCircleAlert: AuraIcon;
+export declare const IconCircleCheck: AuraIcon;
+export declare const IconInfo: AuraIcon;
+export declare const IconTriangleAlert: AuraIcon;
+export declare const IconSettings: AuraIcon;
+export declare const IconUser: AuraIcon;
+export declare const IconUsers: AuraIcon;
+export declare const IconFilter: AuraIcon;
+export declare const IconEllipsis: AuraIcon;
+export declare const IconExternalLink: AuraIcon;
+export declare const IconCopy: AuraIcon;
+export declare const IconTrash2: AuraIcon;
+export declare const IconPencil: AuraIcon;
+export declare const IconDownload: AuraIcon;
+export declare const IconUpload: AuraIcon;
+export declare const IconCalendar: AuraIcon;
+export declare const IconBell: AuraIcon;
+export declare const IconMenu: AuraIcon;
+export declare const IconEye: AuraIcon;
+export declare const IconLogOut: AuraIcon;
+export declare const IconCircle: AuraIcon;
+export declare const IconCircleDotDashed: AuraIcon;
+export declare const IconBan: AuraIcon;
+export declare const IconArrowUp: AuraIcon;
+export declare const IconArrowDown: AuraIcon;
+export declare const IconInbox: AuraIcon;
+export declare const IconPin: AuraIcon;
+export declare const IconPinOff: AuraIcon;
+export declare const IconEyeOff: AuraIcon;
+export declare const IconColumns3: AuraIcon;
+export declare const IconArrowLeft: AuraIcon;
+export declare const IconRotateCcw: AuraIcon;
+export declare const IconHouse: AuraIcon;
+export declare const IconLayoutDashboard: AuraIcon;
+export declare const IconFolder: AuraIcon;
+export declare const IconChartColumn: AuraIcon;
+export declare const IconFileText: AuraIcon;
+export declare const IconMail: AuraIcon;
+export declare const IconLock: AuraIcon;
+export declare const IconClock: AuraIcon;
+export declare const IconTrendingUp: AuraIcon;
+export declare const IconTrendingDown: AuraIcon;
+export declare const IconImage: AuraIcon;
+export declare const IconPaperclip: AuraIcon;
+export declare const IconCloudUpload: AuraIcon;
+export declare const IconFile: AuraIcon;
+export declare const IconSun: AuraIcon;
+export declare const IconMoon: AuraIcon;
+export declare const IconMonitor: AuraIcon;
+export declare const IconPanelLeftClose: AuraIcon;
+export declare const IconPanelLeftOpen: AuraIcon;
+export declare const IconServer: AuraIcon;
+export declare const IconGlobe: AuraIcon;
+export declare const IconActivity: AuraIcon;
+export declare const IconShieldAlert: AuraIcon;
+export declare const IconPhone: AuraIcon;
+export declare const IconWrench: AuraIcon;
+/** Every icon — what `registerIcons(allIcons)` takes to keep icon names as strings working in 6.0. */
+export declare const allIcons: AuraIcon[];
+
+export {};

package/dist/icons/index.d.ts

@@ -0,0 +1,106 @@
+import * as React$1 from 'react';
+
+/** An AURA icon name, or any icon element (e.g. `<Building />` from lucide-react). AURA sizes it and hides it from screen readers. */
+export type IconInput = IconName | React$1.ReactElement;
+export type IconName = "check" | "x" | "plus" | "minus" | "search" | "chevron-down" | "chevron-up" | "chevron-left" | "chevron-right" | "arrow-right" | "arrow-up-right" | "arrow-up-down" | "loader-circle" | "circle-alert" | "circle-check" | "info" | "triangle-alert" | "settings" | "user" | "users" | "filter" | "ellipsis" | "external-link" | "copy" | "trash-2" | "pencil" | "download" | "upload" | "calendar" | "bell" | "menu" | "eye" | "log-out" | "circle" | "circle-dot-dashed" | "ban" | "arrow-up" | "arrow-down" | "inbox" | "pin" | "pin-off" | "eye-off" | "columns-3" | "arrow-left" | "rotate-ccw" | "house" | "layout-dashboard" | "folder" | "chart-column" | "file-text" | "mail" | "lock" | "clock" | "trending-up" | "trending-down" | "image" | "paperclip" | "cloud-upload" | "file" | "sun" | "moon" | "monitor" | "panel-left-close" | "panel-left-open" | "server" | "globe" | "activity" | "shield-alert" | "phone" | "wrench";
+/** Lucide stroke icon drawn inline in currentColor. */
+export interface IconProps {
+	/** A name from the set, or an icon element of your own (sized and styled the same way). */
+	name: IconInput;
+	/** `sm` 16 (default) · `md` 20 · `lg` 24, or a px number. */
+	size?: "sm" | "md" | "lg" | number | undefined;
+	/** Accessible name. Omit for decorative icons next to a text label (then aria-hidden). */
+	label?: string | undefined;
+	/** Default 2 (Lucide's). */
+	strokeWidth?: number | undefined;
+	className?: string | undefined;
+}
+/** One SVG child: element name and its attributes. */
+export type IconShape = [
+	string,
+	Record<string, string>
+];
+/** An AURA icon component from `@jirawatpyk/aura-react/icons` (5.9), e.g. `IconUsers`. */
+export type AuraIcon = React$1.ForwardRefExoticComponent<Omit<IconProps, "name"> & React$1.RefAttributes<SVGSVGElement>> & {
+	/** The icon's path data. */
+	readonly auraShapes: IconShape[];
+	/** Its name in the set, e.g. `users`. */
+	readonly iconName: string;
+};
+/** Makes an icon component from path data (24×24, stroked in currentColor, like Lucide). The per-icon exports are
+ * built with it; use it for an icon of your own that should look and behave exactly like AURA's. */
+export declare function defineIcon(name: string, shapes: IconShape[]): AuraIcon;
+export declare const IconCheck: AuraIcon;
+export declare const IconX: AuraIcon;
+export declare const IconPlus: AuraIcon;
+export declare const IconMinus: AuraIcon;
+export declare const IconSearch: AuraIcon;
+export declare const IconChevronDown: AuraIcon;
+export declare const IconChevronUp: AuraIcon;
+export declare const IconChevronLeft: AuraIcon;
+export declare const IconChevronRight: AuraIcon;
+export declare const IconArrowRight: AuraIcon;
+export declare const IconArrowUpRight: AuraIcon;
+export declare const IconArrowUpDown: AuraIcon;
+export declare const IconLoaderCircle: AuraIcon;
+export declare const IconCircleAlert: AuraIcon;
+export declare const IconCircleCheck: AuraIcon;
+export declare const IconInfo: AuraIcon;
+export declare const IconTriangleAlert: AuraIcon;
+export declare const IconSettings: AuraIcon;
+export declare const IconUser: AuraIcon;
+export declare const IconUsers: AuraIcon;
+export declare const IconFilter: AuraIcon;
+export declare const IconEllipsis: AuraIcon;
+export declare const IconExternalLink: AuraIcon;
+export declare const IconCopy: AuraIcon;
+export declare const IconTrash2: AuraIcon;
+export declare const IconPencil: AuraIcon;
+export declare const IconDownload: AuraIcon;
+export declare const IconUpload: AuraIcon;
+export declare const IconCalendar: AuraIcon;
+export declare const IconBell: AuraIcon;
+export declare const IconMenu: AuraIcon;
+export declare const IconEye: AuraIcon;
+export declare const IconLogOut: AuraIcon;
+export declare const IconCircle: AuraIcon;
+export declare const IconCircleDotDashed: AuraIcon;
+export declare const IconBan: AuraIcon;
+export declare const IconArrowUp: AuraIcon;
+export declare const IconArrowDown: AuraIcon;
+export declare const IconInbox: AuraIcon;
+export declare const IconPin: AuraIcon;
+export declare const IconPinOff: AuraIcon;
+export declare const IconEyeOff: AuraIcon;
+export declare const IconColumns3: AuraIcon;
+export declare const IconArrowLeft: AuraIcon;
+export declare const IconRotateCcw: AuraIcon;
+export declare const IconHouse: AuraIcon;
+export declare const IconLayoutDashboard: AuraIcon;
+export declare const IconFolder: AuraIcon;
+export declare const IconChartColumn: AuraIcon;
+export declare const IconFileText: AuraIcon;
+export declare const IconMail: AuraIcon;
+export declare const IconLock: AuraIcon;
+export declare const IconClock: AuraIcon;
+export declare const IconTrendingUp: AuraIcon;
+export declare const IconTrendingDown: AuraIcon;
+export declare const IconImage: AuraIcon;
+export declare const IconPaperclip: AuraIcon;
+export declare const IconCloudUpload: AuraIcon;
+export declare const IconFile: AuraIcon;
+export declare const IconSun: AuraIcon;
+export declare const IconMoon: AuraIcon;
+export declare const IconMonitor: AuraIcon;
+export declare const IconPanelLeftClose: AuraIcon;
+export declare const IconPanelLeftOpen: AuraIcon;
+export declare const IconServer: AuraIcon;
+export declare const IconGlobe: AuraIcon;
+export declare const IconActivity: AuraIcon;
+export declare const IconShieldAlert: AuraIcon;
+export declare const IconPhone: AuraIcon;
+export declare const IconWrench: AuraIcon;
+/** Every icon — what `registerIcons(allIcons)` takes to keep icon names as strings working in 6.0. */
+export declare const allIcons: AuraIcon[];
+
+export {};

package/dist/index.d.cts

@@ -223,7 +223,7 @@ export interface AuraProviderProps {
 	locale?: "th" | "en" | "sv" | undefined;
 	/** Default calendar for DatePicker / DateRangePicker / Calendar / formatDate callers that read it. Unset: `buddhist` (พ.ศ.) for `th`, `gregory` for `en` and `sv`. */
 	calendar?: "buddhist" | "gregory" | undefined;
-	/** Override individual strings. */
+	/** Override individual strings, or pass a whole locale pack (`strings={th}` from `@jirawatpyk/aura-react/locales/th`, 5.9). */
 	strings?: Partial<Record<string, string | ((...args: any[]) => string)>> | undefined;
 	/** IANA time zone for "today" in DatePicker, DateRangePicker and Calendar, e.g. `Asia/Bangkok` (4.19). Default: the browser's. */
 	timeZone?: string | undefined;
@@ -236,8 +236,8 @@ export interface AuraProviderProps {
 /** `warning` (5.1): needs attention but still works — Warning, Problem, Degraded, At risk. */
 export type StatusTone = "neutral" | "progress" | "ready" | "warning" | "blocked";
 /** Status pill: tone fill + icon + the status word. Tone comes from the word unless given. */
-export interface StatusPillProps {
-	/** The status word shown, e.g. "In Progress". */
+export interface StatusPillProps extends Omit<React$1.HTMLAttributes<HTMLSpanElement>, "children"> {
+	/** The status word shown, e.g. "In Progress". Other attributes (`id`, `data-*`, `aria-*`) go on the pill (5.8). */
 	children: React$1.ReactNode;
 	/** Force a tone. Default: matched from the word (Ready/Done → ready, In Progress/In Review → progress, Warning/Problem/Degraded/At risk → warning (5.1), Blocked/Failed → blocked, anything else → neutral). */
 	tone?: StatusTone | undefined;
@@ -488,8 +488,13 @@ export interface SwitchProps {
 	className?: string | undefined;
 }
 export type FeedbackTone = "info" | "success" | "warning" | "danger";
-export interface AlertProps {
+export interface AlertProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "title" | "role"> {
 	tone?: FeedbackTone | undefined;
+	/** Default: `alert` for warning and danger, `status` otherwise (5.8). Pass `status` for a standing notice in a
+	 * warning or danger tone that shouldn't interrupt; `note` or `none` for one that isn't a live region. */
+	role?: "alert" | "status" | "note" | "none" | undefined;
+	/** Replaces the tone's icon (5.8): a name or your own element; always hidden from screen readers. */
+	icon?: IconInput | undefined;
 	title?: React$1.ReactNode | undefined;
 	children?: React$1.ReactNode | undefined;
 	/** Usually a secondary Button. */
@@ -562,7 +567,8 @@ export interface DialogProps {
 	autoFocus?: boolean | undefined;
 	className?: string | undefined;
 }
-export interface CardProps {
+/** Other attributes (`id`, `data-*`, `aria-*`) go on the card's root (5.8). */
+export interface CardProps extends Omit<React$1.HTMLAttributes<HTMLElement>, "title"> {
 	title?: React$1.ReactNode | undefined;
 	description?: React$1.ReactNode | undefined;
 	/** Top-right, usually an IconButton. */
@@ -590,6 +596,9 @@ export interface TabItem {
 	/** A route (4.19). When every tab has one, Tabs renders a `nav` of links (section tabs that are pages), with
 	 * `aria-current="page"` on the current one and no panels. */
 	href?: string | undefined;
+	/** Attributes for this tab's button (or link): `data-testid`, or an `aria-label` that starts with the visible
+	 * label ("Card — switch payment method") so voice control still finds it (WCAG 2.5.3). (5.9, Chamber-OS 71) */
+	tabProps?: ButtonAttributes | undefined;
 }
 export interface TabsProps {
 	tabs: TabItem[];
@@ -602,6 +611,12 @@ export interface TabsProps {
 	/** Router link for tabs with `href`; defaults to AuraProvider's `linkComponent`, then `<a>`. (4.19) */
 	linkComponent?: React$1.ElementType | undefined;
 	className?: string | undefined;
+	/** Keep every panel mounted, the inactive ones `hidden`, so their state survives a switch (a payment iframe, a
+	 * half-filled form). Default false: only the active panel is rendered. (5.9, Chamber-OS 71) */
+	keepMounted?: boolean | undefined;
+	/** `auto` (default): arrow keys select as they move. `manual`: arrows, Home and End only move focus; Enter, Space
+	 * or a click selects — for tabs whose selection does work (loads data, starts a payment). (5.9) */
+	activation?: "auto" | "manual" | undefined;
 }
 export interface NavItem {
 	id: string;
@@ -864,7 +879,14 @@ export interface DateRangePickerProps extends DateFieldProps {
 	defaultValue?: DateRange | undefined;
 	onChange?: ((value: DateRange) => void) | undefined;
 }
-export interface DrawerProps {
+/** `data-*` attributes in an object prop (TypeScript checks object literals, where JSX would allow them anyway). */
+export type DataAttributes = {
+	[key: `data-${string}`]: string | number | boolean | undefined;
+};
+/** Attributes for a button AURA renders for you (a Drawer's close button, a tab): `data-testid`, `aria-*`, `id`… */
+export type ButtonAttributes = React$1.ButtonHTMLAttributes<HTMLButtonElement> & DataAttributes;
+/** `id`, `data-*`, `aria-*`, `style`, `lang` and `dir` go on the `.aura-drawer` panel (5.9, Chamber-OS 70). */
+export interface DrawerProps extends Pick<React$1.HTMLAttributes<HTMLDivElement>, "id" | "style" | "lang" | "dir">, React$1.AriaAttributes, DataAttributes {
 	open: boolean;
 	onClose: () => void;
 	/** Default `right`. */
@@ -885,6 +907,11 @@ export interface DrawerProps {
 	/** Needed when there is no title. */
 	"aria-label"?: string | undefined;
 	className?: string | undefined;
+	/** The close button's accessible name and tooltip, saying what it closes ("Close payment drawer"). Default: the
+	 * built-in "Close" in the provider's language. (5.9) */
+	closeLabel?: string | undefined;
+	/** Attributes for the close button, e.g. `{ 'data-testid': 'pay-sheet-close' }`. (5.9) */
+	closeProps?: ButtonAttributes | undefined;
 }
 export type Breakpoint = "base" | "sm" | "md" | "lg" | "xl";
 export type Responsive<T> = T | Partial<Record<Breakpoint, T>>;
@@ -943,6 +970,10 @@ export interface TableProps extends Omit<React$1.TableHTMLAttributes<HTMLTableEl
 	captionHidden?: boolean | undefined;
 	/** `compact` tightens the cell padding. Default follows the page. */
 	density?: "comfortable" | "compact" | undefined;
+	/** Below this width of the table's box (5.8) — `sm` 640px, `md` 768px — each body row becomes a card and each
+	 * cell shows its column's header as a label: a `Td`'s `label`, else the text of the matching `Th` in `THead`.
+	 * Done in CSS (a container query), so the server's HTML is already right; table semantics are kept. */
+	stackBelow?: "sm" | "md" | undefined;
 	className?: string | undefined;
 	children?: React$1.ReactNode | undefined;
 }
@@ -961,6 +992,8 @@ export interface TableCellProps extends Omit<React$1.TdHTMLAttributes<HTMLTableC
 	mono?: boolean | undefined;
 	/** Th only. Default `col`. */
 	scope?: "col" | "row" | "colgroup" | "rowgroup" | undefined;
+	/** The label this cell shows when its table is stacked (`stackBelow`, 5.8). Default: the matching header's text. */
+	label?: string | undefined;
 	className?: string | undefined;
 }
 export interface ActionBarProps {
@@ -1235,7 +1268,22 @@ export type IconShape = [
 	string,
 	Record<string, string>
 ];
+/** An AURA icon component from `@jirawatpyk/aura-react/icons` (5.9), e.g. `IconUsers`. */
+export type AuraIcon = React$1.ForwardRefExoticComponent<Omit<IconProps, "name"> & React$1.RefAttributes<SVGSVGElement>> & {
+	/** The icon's path data. */
+	readonly auraShapes: IconShape[];
+	/** Its name in the set, e.g. `users`. */
+	readonly iconName: string;
+};
+/** @deprecated 5.9 — path data by name. In 6.0 it is removed; use the per-icon components or `allIcons` from
+ * `@jirawatpyk/aura-react/icons`. */
 export declare const ICONS: Record<IconName, IconShape[]>;
+/** Makes icon names as strings work: `registerIcons(allIcons)` once at startup, with `allIcons` from
+ * `@jirawatpyk/aura-react/icons`, or only the icons you use (`registerIcons([IconUsers, IconPlus])`). In 5.x every
+ * name already works and this only says you are ready for 6.0 (it silences the notice); in 6.0 it is required. Call it in the module
+ * graph that renders the names: a client module for the components, and also a server module if Server Components
+ * render names with `/server`'s Icon (the two entries keep separate registries). */
+export declare function registerIcons(icons: readonly AuraIcon[]): void;
 export declare const Icon: React$1.ForwardRefExoticComponent<IconProps & React$1.RefAttributes<SVGSVGElement>>;
 /** Every icon name the bundle carries. */
 export declare const iconNames: IconName[];
@@ -1306,6 +1354,15 @@ export declare const Calendar: React$1.ForwardRefExoticComponent<CalendarProps &
 /** Typed date field + calendar popover. English / Gregorian unless a locale is set; `th` shows Buddhist-era dates (18 ก.ย. 2569) and accepts พ.ศ. or ค.ศ. years. The value is always a Gregorian ISO date. */
 export declare const DatePicker: React$1.ForwardRefExoticComponent<DatePickerProps & React$1.RefAttributes<HTMLInputElement>>;
 export declare const DateRangePicker: React$1.ForwardRefExoticComponent<DateRangePickerProps & React$1.RefAttributes<HTMLInputElement>>;
+/** The class list of a Button (5.8): put it on your own link or `<Link>` to make it look like one, e.g. in a Server
+ * Component — `<Link href="/renew" className={buttonClass({ variant: 'secondary' })}>Renew</Link>`. */
+export declare function buttonClass(opts?: {
+	variant?: ButtonProps["variant"];
+	size?: ButtonProps["size"];
+	fullWidth?: boolean | undefined;
+	loading?: boolean | undefined;
+	className?: string | undefined;
+}): string;
 export declare const Alert: React$1.ForwardRefExoticComponent<AlertProps & React$1.RefAttributes<HTMLDivElement>>;
 /** Show a toast; returns its id. Needs `<Toaster />` mounted once. */
 export declare function toast(opts: ToastOptions | string): string;
@@ -1488,6 +1545,12 @@ export interface AuraStrings {
 	pageN: (p: number) => string;
 	accepts: (list?: string, max?: number | string) => string;
 }
+/** Built-in strings by locale. th and sv also ship as packs (`@jirawatpyk/aura-react/locales/th`, `/sv`, 5.9); in 6.0
+ * only en stays built in and a Thai or Swedish app passes its pack to AuraProvider `strings`. */
+/** A whole language for AuraProvider `strings` (5.9): every built-in label, and assignable to the prop. */
+export type AuraLocalePack = AuraStrings & {
+	[key: string]: string | ((...args: any[]) => string);
+};
 export declare const STRINGS: {
 	en: AuraStrings;
 	th: AuraStrings;

package/dist/index.d.ts

@@ -223,7 +223,7 @@ export interface AuraProviderProps {
 	locale?: "th" | "en" | "sv" | undefined;
 	/** Default calendar for DatePicker / DateRangePicker / Calendar / formatDate callers that read it. Unset: `buddhist` (พ.ศ.) for `th`, `gregory` for `en` and `sv`. */
 	calendar?: "buddhist" | "gregory" | undefined;
-	/** Override individual strings. */
+	/** Override individual strings, or pass a whole locale pack (`strings={th}` from `@jirawatpyk/aura-react/locales/th`, 5.9). */
 	strings?: Partial<Record<string, string | ((...args: any[]) => string)>> | undefined;
 	/** IANA time zone for "today" in DatePicker, DateRangePicker and Calendar, e.g. `Asia/Bangkok` (4.19). Default: the browser's. */
 	timeZone?: string | undefined;
@@ -236,8 +236,8 @@ export interface AuraProviderProps {
 /** `warning` (5.1): needs attention but still works — Warning, Problem, Degraded, At risk. */
 export type StatusTone = "neutral" | "progress" | "ready" | "warning" | "blocked";
 /** Status pill: tone fill + icon + the status word. Tone comes from the word unless given. */
-export interface StatusPillProps {
-	/** The status word shown, e.g. "In Progress". */
+export interface StatusPillProps extends Omit<React$1.HTMLAttributes<HTMLSpanElement>, "children"> {
+	/** The status word shown, e.g. "In Progress". Other attributes (`id`, `data-*`, `aria-*`) go on the pill (5.8). */
 	children: React$1.ReactNode;
 	/** Force a tone. Default: matched from the word (Ready/Done → ready, In Progress/In Review → progress, Warning/Problem/Degraded/At risk → warning (5.1), Blocked/Failed → blocked, anything else → neutral). */
 	tone?: StatusTone | undefined;
@@ -488,8 +488,13 @@ export interface SwitchProps {
 	className?: string | undefined;
 }
 export type FeedbackTone = "info" | "success" | "warning" | "danger";
-export interface AlertProps {
+export interface AlertProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "title" | "role"> {
 	tone?: FeedbackTone | undefined;
+	/** Default: `alert` for warning and danger, `status` otherwise (5.8). Pass `status` for a standing notice in a
+	 * warning or danger tone that shouldn't interrupt; `note` or `none` for one that isn't a live region. */
+	role?: "alert" | "status" | "note" | "none" | undefined;
+	/** Replaces the tone's icon (5.8): a name or your own element; always hidden from screen readers. */
+	icon?: IconInput | undefined;
 	title?: React$1.ReactNode | undefined;
 	children?: React$1.ReactNode | undefined;
 	/** Usually a secondary Button. */
@@ -562,7 +567,8 @@ export interface DialogProps {
 	autoFocus?: boolean | undefined;
 	className?: string | undefined;
 }
-export interface CardProps {
+/** Other attributes (`id`, `data-*`, `aria-*`) go on the card's root (5.8). */
+export interface CardProps extends Omit<React$1.HTMLAttributes<HTMLElement>, "title"> {
 	title?: React$1.ReactNode | undefined;
 	description?: React$1.ReactNode | undefined;
 	/** Top-right, usually an IconButton. */
@@ -590,6 +596,9 @@ export interface TabItem {
 	/** A route (4.19). When every tab has one, Tabs renders a `nav` of links (section tabs that are pages), with
 	 * `aria-current="page"` on the current one and no panels. */
 	href?: string | undefined;
+	/** Attributes for this tab's button (or link): `data-testid`, or an `aria-label` that starts with the visible
+	 * label ("Card — switch payment method") so voice control still finds it (WCAG 2.5.3). (5.9, Chamber-OS 71) */
+	tabProps?: ButtonAttributes | undefined;
 }
 export interface TabsProps {
 	tabs: TabItem[];
@@ -602,6 +611,12 @@ export interface TabsProps {
 	/** Router link for tabs with `href`; defaults to AuraProvider's `linkComponent`, then `<a>`. (4.19) */
 	linkComponent?: React$1.ElementType | undefined;
 	className?: string | undefined;
+	/** Keep every panel mounted, the inactive ones `hidden`, so their state survives a switch (a payment iframe, a
+	 * half-filled form). Default false: only the active panel is rendered. (5.9, Chamber-OS 71) */
+	keepMounted?: boolean | undefined;
+	/** `auto` (default): arrow keys select as they move. `manual`: arrows, Home and End only move focus; Enter, Space
+	 * or a click selects — for tabs whose selection does work (loads data, starts a payment). (5.9) */
+	activation?: "auto" | "manual" | undefined;
 }
 export interface NavItem {
 	id: string;
@@ -864,7 +879,14 @@ export interface DateRangePickerProps extends DateFieldProps {
 	defaultValue?: DateRange | undefined;
 	onChange?: ((value: DateRange) => void) | undefined;
 }
-export interface DrawerProps {
+/** `data-*` attributes in an object prop (TypeScript checks object literals, where JSX would allow them anyway). */
+export type DataAttributes = {
+	[key: `data-${string}`]: string | number | boolean | undefined;
+};
+/** Attributes for a button AURA renders for you (a Drawer's close button, a tab): `data-testid`, `aria-*`, `id`… */
+export type ButtonAttributes = React$1.ButtonHTMLAttributes<HTMLButtonElement> & DataAttributes;
+/** `id`, `data-*`, `aria-*`, `style`, `lang` and `dir` go on the `.aura-drawer` panel (5.9, Chamber-OS 70). */
+export interface DrawerProps extends Pick<React$1.HTMLAttributes<HTMLDivElement>, "id" | "style" | "lang" | "dir">, React$1.AriaAttributes, DataAttributes {
 	open: boolean;
 	onClose: () => void;
 	/** Default `right`. */
@@ -885,6 +907,11 @@ export interface DrawerProps {
 	/** Needed when there is no title. */
 	"aria-label"?: string | undefined;
 	className?: string | undefined;
+	/** The close button's accessible name and tooltip, saying what it closes ("Close payment drawer"). Default: the
+	 * built-in "Close" in the provider's language. (5.9) */
+	closeLabel?: string | undefined;
+	/** Attributes for the close button, e.g. `{ 'data-testid': 'pay-sheet-close' }`. (5.9) */
+	closeProps?: ButtonAttributes | undefined;
 }
 export type Breakpoint = "base" | "sm" | "md" | "lg" | "xl";
 export type Responsive<T> = T | Partial<Record<Breakpoint, T>>;
@@ -943,6 +970,10 @@ export interface TableProps extends Omit<React$1.TableHTMLAttributes<HTMLTableEl
 	captionHidden?: boolean | undefined;
 	/** `compact` tightens the cell padding. Default follows the page. */
 	density?: "comfortable" | "compact" | undefined;
+	/** Below this width of the table's box (5.8) — `sm` 640px, `md` 768px — each body row becomes a card and each
+	 * cell shows its column's header as a label: a `Td`'s `label`, else the text of the matching `Th` in `THead`.
+	 * Done in CSS (a container query), so the server's HTML is already right; table semantics are kept. */
+	stackBelow?: "sm" | "md" | undefined;
 	className?: string | undefined;
 	children?: React$1.ReactNode | undefined;
 }
@@ -961,6 +992,8 @@ export interface TableCellProps extends Omit<React$1.TdHTMLAttributes<HTMLTableC
 	mono?: boolean | undefined;
 	/** Th only. Default `col`. */
 	scope?: "col" | "row" | "colgroup" | "rowgroup" | undefined;
+	/** The label this cell shows when its table is stacked (`stackBelow`, 5.8). Default: the matching header's text. */
+	label?: string | undefined;
 	className?: string | undefined;
 }
 export interface ActionBarProps {
@@ -1235,7 +1268,22 @@ export type IconShape = [
 	string,
 	Record<string, string>
 ];
+/** An AURA icon component from `@jirawatpyk/aura-react/icons` (5.9), e.g. `IconUsers`. */
+export type AuraIcon = React$1.ForwardRefExoticComponent<Omit<IconProps, "name"> & React$1.RefAttributes<SVGSVGElement>> & {
+	/** The icon's path data. */
+	readonly auraShapes: IconShape[];
+	/** Its name in the set, e.g. `users`. */
+	readonly iconName: string;
+};
+/** @deprecated 5.9 — path data by name. In 6.0 it is removed; use the per-icon components or `allIcons` from
+ * `@jirawatpyk/aura-react/icons`. */
 export declare const ICONS: Record<IconName, IconShape[]>;
+/** Makes icon names as strings work: `registerIcons(allIcons)` once at startup, with `allIcons` from
+ * `@jirawatpyk/aura-react/icons`, or only the icons you use (`registerIcons([IconUsers, IconPlus])`). In 5.x every
+ * name already works and this only says you are ready for 6.0 (it silences the notice); in 6.0 it is required. Call it in the module
+ * graph that renders the names: a client module for the components, and also a server module if Server Components
+ * render names with `/server`'s Icon (the two entries keep separate registries). */
+export declare function registerIcons(icons: readonly AuraIcon[]): void;
 export declare const Icon: React$1.ForwardRefExoticComponent<IconProps & React$1.RefAttributes<SVGSVGElement>>;
 /** Every icon name the bundle carries. */
 export declare const iconNames: IconName[];
@@ -1306,6 +1354,15 @@ export declare const Calendar: React$1.ForwardRefExoticComponent<CalendarProps &
 /** Typed date field + calendar popover. English / Gregorian unless a locale is set; `th` shows Buddhist-era dates (18 ก.ย. 2569) and accepts พ.ศ. or ค.ศ. years. The value is always a Gregorian ISO date. */
 export declare const DatePicker: React$1.ForwardRefExoticComponent<DatePickerProps & React$1.RefAttributes<HTMLInputElement>>;
 export declare const DateRangePicker: React$1.ForwardRefExoticComponent<DateRangePickerProps & React$1.RefAttributes<HTMLInputElement>>;
+/** The class list of a Button (5.8): put it on your own link or `<Link>` to make it look like one, e.g. in a Server
+ * Component — `<Link href="/renew" className={buttonClass({ variant: 'secondary' })}>Renew</Link>`. */
+export declare function buttonClass(opts?: {
+	variant?: ButtonProps["variant"];
+	size?: ButtonProps["size"];
+	fullWidth?: boolean | undefined;
+	loading?: boolean | undefined;
+	className?: string | undefined;
+}): string;
 export declare const Alert: React$1.ForwardRefExoticComponent<AlertProps & React$1.RefAttributes<HTMLDivElement>>;
 /** Show a toast; returns its id. Needs `<Toaster />` mounted once. */
 export declare function toast(opts: ToastOptions | string): string;
@@ -1488,6 +1545,12 @@ export interface AuraStrings {
 	pageN: (p: number) => string;
 	accepts: (list?: string, max?: number | string) => string;
 }
+/** Built-in strings by locale. th and sv also ship as packs (`@jirawatpyk/aura-react/locales/th`, `/sv`, 5.9); in 6.0
+ * only en stays built in and a Thai or Swedish app passes its pack to AuraProvider `strings`. */
+/** A whole language for AuraProvider `strings` (5.9): every built-in label, and assignable to the prop. */
+export type AuraLocalePack = AuraStrings & {
+	[key: string]: string | ((...args: any[]) => string);
+};
 export declare const STRINGS: {
 	en: AuraStrings;
 	th: AuraStrings;