gridsmith-ui 0.29.0 → 0.30.0

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 import * as react from 'react';
 import { ButtonHTMLAttributes, ReactNode, InputHTMLAttributes, LabelHTMLAttributes, TextareaHTMLAttributes, Ref, ReactElement, CSSProperties, HTMLAttributes, RefObject, KeyboardEvent, AnchorHTMLAttributes, ElementType } from 'react';
 import { IconSlot, IconName } from './icons.js';
+import { a as DropdownMenuEntry, S as Side, A as Align } from './DropdownMenu-DqT7ZQ0D.js';
+export { b as DropdownMenu, c as DropdownMenuDivider, d as DropdownMenuItem, D as DropdownMenuSubmenu } from './DropdownMenu-DqT7ZQ0D.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { M as MentionSuggestion } from './MentionList-CoNBRFGR.js';
-import { C as ColumnKind, B as BreakpointKey } from './table-utils-BkjNEWts.js';
-export { a as BreakpointWidthProvider, u as useBreakpoint } from './table-utils-BkjNEWts.js';
-import { P as Pager, A as AppShellPreferences } from './use-pagination-BxcRlNQG.js';
-export { a as PaginationOptions, b as PreferencesContext, R as ResolvedPreferences, p as preferenceActionKey, u as usePagination, c as usePreferences } from './use-pagination-BxcRlNQG.js';
+import { C as ColumnKind, B as BreakpointKey } from './table-utils-BXkP-2Hx.js';
+export { a as BreakpointWidthProvider, u as useBreakpoint } from './table-utils-BXkP-2Hx.js';
+import { P as Pager, A as AppShellPreferences } from './use-pagination-QykGSREv.js';
+export { a as PaginationOptions, b as PreferencesContext, R as ResolvedPreferences, p as preferenceActionKey, u as usePagination, c as usePreferences } from './use-pagination-QykGSREv.js';
 export { B as BreadcrumbItem, a as Breadcrumbs, b as BreadcrumbsSeparator, c as BreadcrumbsSize, d as BreadcrumbsVariant } from './Breadcrumbs-CGS8GKl-.js';
 
 type ButtonVariant = "default" | "secondary" | "tertiary" | "outline" | "ghost" | "destructive" | "success" | "warning" | "link";
@@ -26,29 +28,6 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
 }
 declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
 
-type Side = "top" | "right" | "bottom" | "left";
-type Align = "start" | "center" | "end";
-
-interface DropdownMenuItem {
-    label: string;
-    icon?: IconName;
-    onClick: () => void;
-    variant?: "default" | "destructive";
-    disabled?: boolean;
-}
-interface DropdownMenuDivider {
-    type: "divider";
-}
-type DropdownMenuEntry = DropdownMenuItem | DropdownMenuDivider;
-interface DropdownMenuProps {
-    trigger: ReactNode;
-    items: DropdownMenuEntry[];
-    align?: Align;
-    className?: string;
-    container?: Element | DocumentFragment;
-}
-declare function DropdownMenu({ trigger, items, align, className, container }: DropdownMenuProps): react_jsx_runtime.JSX.Element;
-
 interface BulkAction {
     label: string;
     icon?: IconName;
@@ -105,6 +84,12 @@ interface FieldControlProps {
 /** The wiring a control may be given as props: by a Field's clone, or by a page that labels it itself. */
 interface FieldControlWiring {
     id?: string;
+    /**
+     * A name the page gives the control where nothing on screen names it (a row's checkbox, a filter's dropdown). It
+     * names the control's focusable element, or its group (Sprint 25.8.7 item 22: TSX checks no hyphenated attribute,
+     * so a control that didn't declare it dropped it silently).
+     */
+    "aria-label"?: string;
     "aria-labelledby"?: string;
     "aria-describedby"?: string;
     "aria-invalid"?: boolean | "true" | "false";
@@ -323,7 +308,13 @@ type CheckboxSize = "sm" | "md";
 /** A Field passes its wiring (0.21.0): its label names the box, and its hint and error describe it. */
 interface CheckboxProps extends FieldControlWiring {
     checked: boolean;
-    onChange: (checked: boolean) => void;
+    /**
+     * The box's new state. `shiftKey`: whether Shift was held as it changed, by a click or by Space, so a list can select
+     * the run of rows up to it (Table, Sprint 25.8.7 item 23).
+     */
+    onChange: (checked: boolean, detail: {
+        shiftKey: boolean;
+    }) => void;
     label?: string;
     size?: CheckboxSize;
     disabled?: boolean;
@@ -371,6 +362,21 @@ declare function RadioGroup({ value, onChange: onChangeProp, options, orientatio
 /** A day of the week as `Date.getDay()` counts them: Sunday 0, Monday 1 … Saturday 6. */
 type Weekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 
+/**
+ * Keyboard moves for a calendar's day grid (Sprint 25.7, D14(b)): the APG date
+ * picker's keys. Left and Right move a day, Up and Down a week, Home and End go
+ * to the ends of the week, PageUp and PageDown move a month (Shift: a year) and
+ * keep the day, clamped to the month's last day. All arithmetic is on calendar
+ * days in local time, so a clock change never lands on the wrong day.
+ */
+
+/**
+ * Days a picker won't let the person choose, beside its min and max (Sprint 25.8.7 item 9): a function of the day, true
+ * for a day that can't be chosen (a holiday, a booked day), or the weekdays that can't, Sunday 0 to Saturday 6 ([0, 6]
+ * for weekends).
+ */
+type DisabledDates = ((day: Date) => boolean) | readonly Weekday[];
+
 interface DatePickerProps extends Omit<FieldControlWiring, "id"> {
     value: Date | null;
     onChange: (date: Date | null) => void;
@@ -387,6 +393,12 @@ interface DatePickerProps extends Omit<FieldControlWiring, "id"> {
     /** Earliest / latest selectable day (inclusive). Days outside are disabled. */
     min?: Date;
     max?: Date;
+    /**
+     * Days that can't be chosen, beside min and max: a function of the day (true to exclude it: a holiday, a booked day),
+     * or the weekdays to exclude, Sunday 0 to Saturday 6 ([0, 6] for weekends). They show as unavailable, can't be picked
+     * by click, keyboard or typing, and a typed one marks the field invalid.
+     */
+    disabledDates?: DisabledDates;
     /**
      * Range context for paired "Start date" / "End date" pickers. The other
      * end of the range is shown as selected and the days between are shaded,
@@ -400,7 +412,7 @@ interface DatePickerProps extends Omit<FieldControlWiring, "id"> {
     /** The week's first day, Sunday 0 to Saturday 6. Default: the first day of the visitor's week, from their browser's languages, then the page's language, then Monday (gridsmith-ui 0.27.0); Sunday before. */
     weekStartsOn?: Weekday;
 }
-declare function DatePicker({ value, onChange: onChangeProp, placeholder, disabled, className, ref, container, error, label, id, size: sizeProp, min, max, range, weekStartsOn: weekStartsOnProp, ...wiring }: DatePickerProps): react_jsx_runtime.JSX.Element;
+declare function DatePicker({ value, onChange: onChangeProp, placeholder, disabled, className, ref, container, error, label, id, size: sizeProp, min, max, disabledDates, range, weekStartsOn: weekStartsOnProp, ...wiring }: DatePickerProps): react_jsx_runtime.JSX.Element;
 
 interface DateRange {
     start: Date | null;
@@ -426,6 +438,12 @@ interface DateRangePickerProps extends Omit<FieldControlWiring, "id"> {
     /** Earliest / latest selectable day. */
     min?: Date;
     max?: Date;
+    /**
+     * Days that can't be chosen, beside min and max: a function of the day (true to exclude it: a holiday, a booked day),
+     * or the weekdays to exclude, Sunday 0 to Saturday 6 ([0, 6] for weekends). Neither end of the range can be one; the
+     * range may span them, as a week off spans its weekend.
+     */
+    disabledDates?: DisabledDates;
     /** Quick ranges listed beside the calendars. Pass [] to hide; omit for the defaults. */
     presets?: DateRangePreset[];
     /** The week's first day, Sunday 0 to Saturday 6. Default: the first day of the visitor's week, from their browser's languages, then the page's language, then Monday (gridsmith-ui 0.27.0); Sunday before. */
@@ -439,7 +457,7 @@ declare const DEFAULT_DATE_RANGE_PRESETS: DateRangePreset[];
  * the end (clicking before the start restarts the selection). Closes on
  * Escape or outside click. Pair with <Field> for label/hint/error wiring.
  */
-declare function DateRangePicker({ value, onChange: onChangeProp, placeholder, disabled, error, label, id, className, ref, container, min, max, presets, weekStartsOn: weekStartsOnProp, size: sizeProp, ...wiring }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
+declare function DateRangePicker({ value, onChange: onChangeProp, placeholder, disabled, error, label, id, className, ref, container, min, max, disabledDates, presets, weekStartsOn: weekStartsOnProp, size: sizeProp, ...wiring }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
 
 /**
  * How something repeats (Sprint 25.19 R1): the iCalendar standard's rule (RFC 5545 `RRULE`), in the subset Outlook's and
@@ -733,8 +751,10 @@ interface FileUploadProps {
     label?: string;
     /** The file input's id. A Field passes its own, so its label opens the picker. */
     id?: string;
+    /** The zone's name where nothing on screen names it, given to its file input. Inside a Field, the Field's label names it. */
+    "aria-label"?: string;
 }
-declare function FileUpload({ onFiles, files, upload, onCancel, onRetry, onRemove, accept, multiple, maxSize, className, error, label, id }: FileUploadProps): react_jsx_runtime.JSX.Element;
+declare function FileUpload({ onFiles, files, upload, onCancel, onRetry, onRemove, accept, multiple, maxSize, className, error, label, id, "aria-label": ariaLabel }: FileUploadProps): react_jsx_runtime.JSX.Element;
 
 interface SliderRangeProps {
     /**
@@ -803,8 +823,10 @@ interface NumberInputProps {
     allowDecimals?: boolean;
     /** Forwarded to the inner input element so a Label htmlFor can be associated. */
     id?: string;
+    /** The field's name where nothing on screen names it ("Seats"); inside a Field, the Field's label names it. */
+    "aria-label"?: string;
 }
-declare function NumberInput({ value, onChange: onChangeProp, min, max, step, disabled, placeholder, prefix, suffix, size: sizeProp, className, error, allowDecimals, id, }: NumberInputProps): react_jsx_runtime.JSX.Element;
+declare function NumberInput({ value, onChange: onChangeProp, min, max, step, disabled, placeholder, prefix, suffix, size: sizeProp, className, error, allowDecimals, id, "aria-label": ariaLabel, }: NumberInputProps): react_jsx_runtime.JSX.Element;
 
 interface TagInputProps {
     value: string[];
@@ -832,8 +854,10 @@ interface PinInputProps {
     error?: boolean;
     /** Forwarded to the first pin box so a Label htmlFor can be associated. */
     id?: string;
+    /** The group's name where nothing on screen names it ("Verification code"). Default: "PIN input". */
+    "aria-label"?: string;
 }
-declare function PinInput({ value, onChange: onChangeProp, length, mask, disabled, size: sizeProp, className, error, id, }: PinInputProps): react_jsx_runtime.JSX.Element;
+declare function PinInput({ value, onChange: onChangeProp, length, mask, disabled, size: sizeProp, className, error, id, "aria-label": ariaLabel, }: PinInputProps): react_jsx_runtime.JSX.Element;
 
 /** A Field passes its wiring (0.21.0): its label names the stars, and its hint and error describe them. */
 interface RatingProps extends FieldControlWiring {
@@ -856,8 +880,10 @@ interface ColorPickerProps {
     disabled?: boolean;
     className?: string;
     error?: boolean;
+    /** The picker's name where nothing on screen names it ("Brand colour"): it names the picker's group of parts. */
+    "aria-label"?: string;
 }
-declare function ColorPicker({ value, onChange: onChangeProp, showAlpha, swatches, disabled, className, error, }: ColorPickerProps): react_jsx_runtime.JSX.Element;
+declare function ColorPicker({ value, onChange: onChangeProp, showAlpha, swatches, disabled, className, error, "aria-label": ariaLabel, }: ColorPickerProps): react_jsx_runtime.JSX.Element;
 
 interface InlineFieldErrorProps {
     message: string;
@@ -886,6 +912,11 @@ interface FormContextValue {
      */
     register: (field: string, check: FieldCheck) => () => void;
 }
+/**
+ * The FormWrapper a field sits in: its errors with `setError` and `clearErrors`, the project's validation timing
+ * (`validationMode`, forms.validationTiming through FormWrapper), whether it has been submitted, and `register` for a
+ * field's own check, which the form runs on each submit. Throws outside a FormWrapper.
+ */
 declare function useFormContext(): FormContextValue;
 
 /** An invalid field as the form finds it in its own DOM after a submit. */
@@ -1454,6 +1485,11 @@ interface TagProps {
     maxWidth?: string;
     onRemove?: () => void;
     onClick?: () => void;
+    /**
+     * A Tag that toggles (a filter chip): whether it is on. Reported as a pressed button, so it needs `onClick`; leave it
+     * out for a Tag whose click does something else.
+     */
+    selected?: boolean;
     disabled?: boolean;
     className?: string;
     children: ReactNode;
@@ -1747,20 +1783,35 @@ interface TreeViewProps {
     onSelect?: (ids: string[]) => void;
     onCheck?: (ids: string[]) => void;
     className?: string;
+    /** The tree's name where nothing on screen names it ("Folders"). */
+    "aria-label"?: string;
+    /** The id of what names the tree on screen, such as its heading. */
+    "aria-labelledby"?: string;
 }
-declare function TreeView({ nodes, selectable, multiSelect, checkable, defaultExpanded, defaultSelected, selected: selectedProp, defaultChecked, onSelect, onCheck, className, }: TreeViewProps): react_jsx_runtime.JSX.Element;
+declare function TreeView({ nodes, selectable, multiSelect, checkable, defaultExpanded, defaultSelected, selected: selectedProp, defaultChecked, onSelect, onCheck, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, }: TreeViewProps): react_jsx_runtime.JSX.Element;
 
 interface CarouselProps {
     children: ReactNode[];
+    /**
+     * Moves on to the next slide by itself every `autoPlayInterval` ms, back to the first after the last, with a button to
+     * stop and start it, first in the Tab order (the Authoring Practices' carousel). Keyboard focus coming to any part of
+     * the carousel stops it, and it stays stopped until the person presses play; it pauses while the pointer is over it,
+     * a slide is dragged or focus is in a slide; and it never starts by itself for a person who has asked for reduced
+     * motion (they can still press play).
+     */
     autoPlay?: boolean;
     autoPlayInterval?: number;
     loop?: boolean;
     showIndicators?: boolean;
     showArrows?: boolean;
+    /** Names the carousel for assistive technology ("Featured projects"); each slide is named by its place, "3 of 10". */
+    "aria-label"?: string;
+    /** The id of a visible heading that names the carousel, in place of `aria-label`. */
+    "aria-labelledby"?: string;
     className?: string;
     ref?: Ref<HTMLDivElement>;
 }
-declare function Carousel({ children, autoPlay, autoPlayInterval, loop, showIndicators, showArrows, className, ref, }: CarouselProps): react_jsx_runtime.JSX.Element;
+declare function Carousel({ children, autoPlay, autoPlayInterval, loop, showIndicators, showArrows, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, className, ref, }: CarouselProps): react_jsx_runtime.JSX.Element;
 
 interface ChatMessageSender {
     name: string;
@@ -1928,7 +1979,7 @@ interface AsidePanelProps {
     navbarFloating?: boolean;
     /** Whether the sidebar is floating — a left-docked floating column then drops its outer gutter, because the sidebar's own gutter is the gap (as PageHeader does). */
     sidebarFloating?: boolean;
-    /** Below this breakpoint the page is too narrow to share: the panel renders as a non-modal Drawer instead (and as the modal Sheet at or below sm, as Drawer does). Default "lg". */
+    /** Below this breakpoint the page is too narrow to share: the panel renders as a non-modal Drawer instead (and as the modal Sheet below sm, as Drawer does). Default "lg". */
     collapseBelow?: BreakpointKey;
     /** Keep the content mounted while closed (hidden) so drafts and scroll survive. Default true — the column exists for persistent assistants. */
     keepMounted?: boolean;
@@ -1944,7 +1995,7 @@ interface AsidePanelProps {
 }
 /**
  * A docked column beside the page content: the page narrows to make room
- * instead of being covered (the Copilot / Sidekick layout). In-flow, so it is
+ * instead of being covered (the docked assistant's layout). In-flow, so it is
  * a landmark (`role="complementary"`), not a dialog. Same non-modal contract as
  * Drawer modal={false}: no focus trap, Escape closes only from inside, focus
  * returns to the opener, an outside click does nothing, drafts survive closing.
@@ -2549,6 +2600,11 @@ interface GanttProps<T extends GanttItem = GanttItem> {
     labelHeader?: ReactNode;
     /** Controls after the built-in zoom, period and Today buttons, before the legend; false hides the bar (the legend stays). */
     toolbar?: ReactNode | false;
+    /**
+     * Days to shade under the rows (weekends, holidays), as TimeViewport's: asked about each day by its weekday (0 is
+     * Sunday) and "YYYY-MM-DD" key. Drawn where a day is at least 4 px wide (the day, week and month zooms). Default none.
+     */
+    shadeDays?: (day: CalendarDay) => boolean;
     "aria-label": string;
     className?: string;
 }
@@ -2566,7 +2622,7 @@ interface GanttProps<T extends GanttItem = GanttItem> {
  * filter), focus moves to the row before it. Each item's accessible name carries its title, dates, status and
  * dependencies; the arrows and the scale are for sight only.
  */
-declare function Gantt<T extends GanttItem = GanttItem>({ items, groups, selectedId, onSelect, statuses, zoom: zoomProp, defaultZoom, onZoomChange, today, weekStartsOn, locale, renderLabel, describe, labelHeader, toolbar, "aria-label": ariaLabel, className, }: GanttProps<T>): react_jsx_runtime.JSX.Element;
+declare function Gantt<T extends GanttItem = GanttItem>({ items, groups, selectedId, onSelect, statuses, zoom: zoomProp, defaultZoom, onZoomChange, today, weekStartsOn, locale, renderLabel, describe, labelHeader, toolbar, shadeDays, "aria-label": ariaLabel, className, }: GanttProps<T>): react_jsx_runtime.JSX.Element;
 
 type LinkUnderline = "hover" | "always" | "none";
 type LinkTone = "accent" | "muted" | "inherit";
@@ -2646,6 +2702,7 @@ interface LauncherProps {
 declare function Launcher({ variant, size, tone, edge, align, label, icon, badge, open, onOpenChange, panelId, whenOpen, offset, shortcut, container, className, }: LauncherProps): react.ReactPortal | null;
 
 type TabsOverflow = "scroll" | "hidden" | "truncate";
+type TabsActivation = "automatic" | "manual";
 interface Tab {
     id: string;
     label: string;
@@ -2667,6 +2724,12 @@ interface TabsArrayProps {
     mobile?: "scroll" | "dropdown";
     fullWidth?: boolean;
     overflow?: TabsOverflow;
+    /**
+     * How the keyboard selects a tab. "automatic" (the default): the arrow keys, Home and End select the tab they move to.
+     * "manual": they move focus only, and Enter or Space selects, for tabs whose panels load or that navigate. Where the
+     * tabs collapse to a Dropdown below md, a tab is chosen from its open list in either mode.
+     */
+    activation?: TabsActivation;
     className?: string;
     children?: never;
 }
@@ -2676,6 +2739,11 @@ interface TabsCompoundProps {
     orientation?: "horizontal" | "vertical";
     fullWidth?: boolean;
     overflow?: TabsOverflow;
+    /**
+     * How the keyboard selects a tab. "automatic" (the default): the arrow keys, Home and End select the tab they move to.
+     * "manual": they move focus only, and Enter or Space selects, for tabs whose panels load or that navigate.
+     */
+    activation?: TabsActivation;
     className?: string;
     children: ReactNode;
     tabs?: never;
@@ -2860,6 +2928,10 @@ interface SidebarContextValue {
     navbarFloating: boolean;
     navSize?: "sm" | "md";
 }
+/**
+ * The Sidebar around this component, or null outside one: whether it is collapsed (with `onCollapsedChange`), its type
+ * and position, whether the navbar beside it floats, and the element its popovers portal into.
+ */
 declare function useSidebar(): SidebarContextValue | null;
 type SidebarVariant = "default" | "dark";
 interface SidebarProps {
@@ -3195,8 +3267,9 @@ interface DrawerProps {
     topOffset?: string;
     /**
      * What the drawer becomes at phone width (≤ the sm breakpoint).
-     * "sheet" (default for right and bottom): a draggable bottom Sheet with snap points.
-     * "panel" (default for left, which is the navigation convention): a full-height side panel.
+     * "sheet" (default for right and bottom, and for a non-modal drawer on any side): a draggable bottom Sheet with snap
+     * points, always modal.
+     * "panel" (default for a modal left drawer, which is the navigation convention): a full-height side panel.
      * lightBackdrop and topOffset do not apply in sheet mode.
      */
     mobile?: "sheet" | "panel";
@@ -3253,7 +3326,7 @@ interface TooltipProps extends Omit<HTMLAttributes<HTMLElement>, "content"> {
      */
     ref?: Ref<HTMLElement>;
 }
-declare function Tooltip({ content, children, side, delay, className, container, disabled, ref: forwardedRef, ...slotProps }: TooltipProps): react_jsx_runtime.JSX.Element;
+declare function Tooltip({ content, children, side, delay, className, container, disabled, ref, ...slotProps }: TooltipProps): react_jsx_runtime.JSX.Element;
 
 interface PopoverProps {
     open: boolean;
@@ -3356,7 +3429,12 @@ interface Notification {
     id: string;
     title: string;
     description?: string;
-    timestamp: string;
+    /**
+     * When it happened: a Date, milliseconds since the epoch, or an ISO 8601 string ("2026-10-14T09:30:00Z"). A dated row
+     * is grouped by its day (Today, Yesterday, Earlier) and its time drawn as a RelativeTime; other text is shown as
+     * given, under Earlier.
+     */
+    timestamp: TimeValue;
     read?: boolean;
     avatar?: string;
     initials?: string;
@@ -3401,6 +3479,22 @@ interface AlertAction {
     /** An icon name ("refresh"), drawn as the theme's icon at 14 px, or an element. */
     iconLeft?: IconSlot;
 }
+/** One of a consent notice's two choices. */
+interface AlertConsentChoice {
+    label: string;
+    onClick: () => void;
+    /**
+     * Draws this choice as the primary button. Equal weight is the default, and the better practice: an Accept that looks
+     * like the way on nudges people to accept, which UK and EU data-protection guidance counts against freely given
+     * consent. For a page that insists on one.
+     */
+    primary?: boolean;
+}
+/** A consent notice's two choices (Sprint 25.8.7 item 11): equal in weight by default, so neither is the easy way out. */
+interface AlertConsent {
+    accept: AlertConsentChoice;
+    reject: AlertConsentChoice;
+}
 interface AlertProps {
     variant: AlertVariant;
     title: string;
@@ -3413,6 +3507,18 @@ interface AlertProps {
     placement?: AlertPlacement;
     /** Expandable detail content — collapsed by default */
     expandableContent?: ReactNode;
+    /**
+     * A consent notice (analytics cookies, sharing data): a region named by its title, never an alert, with two choices of
+     * equal weight that stay two buttons at any width, and never pinned over the page (a page-top placement draws it in
+     * the page's flow). Once the person has chosen, pass `confirmation`.
+     */
+    consent?: AlertConsent;
+    /**
+     * With `consent`: what the person chose and where to change it ("You've accepted analytics cookies. You can change
+     * your cookie settings at any time."). It takes the choices' place, is announced and takes focus, as the government
+     * design system's cookie banner does; `dismissible` gives it a way to hide, shown once the choice is made.
+     */
+    confirmation?: ReactNode;
     className?: string;
 }
 declare const Alert: react.ForwardRefExoticComponent<AlertProps & react.RefAttributes<HTMLDivElement>>;
@@ -3518,6 +3624,13 @@ interface ToastProviderProps {
     /** Pause every toast's time while the stack is hovered (focus inside it always pauses). Default true. */
     pauseOnHover?: boolean;
 }
+/**
+ * The app's toasts, from the shell's ToastProvider: `toast`, `success`, `warning` and `error` show one and return its id,
+ * `update` changes one in place, `dismiss` and `dismissAll` remove them, and `promise` shows a loading toast that
+ * resolves to success or error. The provider places every toast and times it by the project's preferences. For a
+ * destructive action's Undo, use `useDestructiveAction`, which shows its own toast for the project's undo window.
+ * Throws outside the ToastProvider.
+ */
 declare function useToast(): ToastApi;
 /** The toast API when a ToastProvider is above, else null — for components that can do without one (useDestructiveAction in dialog mode). */
 declare function useToastOptional(): ToastApi | null;
@@ -3592,7 +3705,7 @@ interface AppShellContextValue {
     /**
      * Effective sidebar collapse for a traditional Sidebar rendered in the shell.
      * The user's explicit choice wins; otherwise the auto tier applies — collapsed
-     * to a rail at or below the `lg` breakpoint, expanded above it. Lives here rather
+     * to a rail below the `lg` breakpoint, expanded from it. Lives here rather
      * than in Sidebar so it survives the sidebar unmounting in the drawer range.
      */
     sidebarCollapsed: boolean;
@@ -3627,8 +3740,10 @@ interface AppShellContextValue {
     registerChrome: (kind: "navbar" | "sidebar", position: ChromePosition) => () => void;
     /** True when the shell renders a Launcher above sm — PageContainer adjusts its bottom padding to clear the launcher. */
     hasLauncher: boolean;
-    /** The bottom corner that launcher occupies (a ribbon occupies none), so the container reads that corner's inset variable. */
+    /** The bottom corner a bubble or pill launcher occupies, so the container's bottom padding reads that corner's inset variable. The page's padding ignores a ribbon, which hugs the window's edge (its claim keeps only toasts off it). */
     launcherCorner: "bottom-right" | "bottom-left" | null;
+    /** Called by a Launcher inside the shell with the corner it occupies (null for a ribbon), so the padding follows the Launcher itself however the slot wraps it. Returns the unregister. */
+    registerLauncher: (corner: "bottom-right" | "bottom-left" | null) => () => void;
     /** The shell renders an app footer under the page. Its children sit in a wrapper whose height is not definite, so a
      *  `fill` SplitView reads `--ds-main-height` (published on the shell element) instead of `h-full`. */
     hasFooter: boolean;
@@ -3666,6 +3781,12 @@ interface AppShellFocus {
     /** What the exit control does: save and log out, or return to where the user came from. */
     onExit?: () => void;
 }
+/**
+ * The app shell around this component, or null outside one: its layout state — whether it has a sidebar, a mobile menu
+ * and a mobile nav, whether the sidebar is open or collapsed and the aside open (each with its setter), the viewport tier
+ * (`isMobile`, `isTablet`), the theme it was given and whether its navbar and sidebar float. For telling the shell about
+ * unsaved changes, use `useUnsavedChanges`.
+ */
 declare function useAppShell(): AppShellContextValue | null;
 /**
  * Tells the shell this page has unsaved changes, so focus mode's Exit asks before it leaves (Sprint 25.7, C1). Pass the
@@ -3697,9 +3818,9 @@ interface AppShellProps {
     /** Which side of the content the aside sits on. Default "right". Pass the same value to the AsidePanel. */
     asideSide?: "right" | "left";
     /**
-     * A Launcher for the assistant. Rendered only above the sm breakpoint — a conditional render,
-     * because the Launcher portals out of any wrapper — so on phones the Navbar button is the entry point
-     * and it never collides with BottomNav.
+     * A Launcher for the assistant. Rendered from the sm breakpoint up, where Tailwind's `sm:` starts — a conditional
+     * render, because the Launcher portals out of any wrapper — so below it, on phones, the Navbar button is the entry
+     * point and it never collides with BottomNav.
      */
     launcher?: ReactNode;
     children: ReactNode;
@@ -4076,7 +4197,10 @@ declare function DangerZone({ title, description, children, className }: DangerZ
 interface TextOverflowProps {
     /** Max visible lines before truncation. 1 = single-line ellipsis, >1 = line-clamp-N. */
     lines?: number;
-    /** Show tooltip/hovercard when text is truncated. Default: true. */
+    /**
+     * Show the full text when it is cut: on hover, on keyboard focus (cut text is a Tab stop, drawing the focus outline,
+     * except inside a control, whose own focus reaches it) and on a tap. Default: true.
+     */
     tooltip?: boolean;
     /** Custom tooltip content. Defaults to the text content of children. */
     tooltipContent?: ReactNode;
@@ -4117,4 +4241,4 @@ interface UseTextOverflowResult {
  */
 declare function useTextOverflow(options?: UseTextOverflowOptions): UseTextOverflowResult;
 
-export { Accordion, ActionPanel, ActionPanelGroup, AddAnother, type AddAnotherProps, Alert, type AlertPlacement, AppShell, type AppShellContextValue, type AppShellFocus, AppShellPreferences, type AppShellTheme, AsidePanel, type AsidePanelProps, type AsidePanelSide, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarStatus, Badge, type BadgePaletteColor, type BadgeSeverity, type BadgeSize, type BadgeVariant, BottomNav, type BottomNavItem, BreakpointKey, BulkActionBar, Button, ButtonSizeContext, Calendar, type CalendarColour, type CalendarDay, type CalendarDayClickDetail, type CalendarEvent, type CalendarEventAction, type CalendarEventAttendee, type CalendarProps, type CalendarSize, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardGrid, type CardGridProps, CardHeader, type CardSelectType, CardTitle, type CardVariant, Carousel, type ChatMessage, type ChatMessageAction, type ChatMessageLayout, ChatMessageList, type ChatMessageSender, type ChatMessageSource, type ChatMessageStatus, ChatPanel, type ChatPanelProps, type ChatPanelStatusTone, Checkbox, CheckboxGroup, CheckboxGroupItem, CodeBlock, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorPicker, type Column, Combobox, CommandPalette, ContextMenu, type ControlSize, ControlSizeContext, CornerPanel, type CornerPanelEdge, type CornerPanelProps, DEFAULT_DATE_RANGE_PRESETS, DangerZone, type DangerZoneProps, DataList, type DateInput, DatePicker, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DateRangeWords, type DescriptionItem, DescriptionList, type DescriptionListOrientation, type DescriptionListSize, type DestructiveActionHandle, type DestructiveActionOptions, Dialog, Divider, Dock, Drawer, Dropdown, DropdownMenu, type DropdownMenuDivider, type DropdownMenuEntry, type DropdownMenuItem, EmptyState, EntityCell, type EventCategory, Field, type FieldControlProps, type FieldLabel, type FieldProps, FileUpload, type FileUploadItem, type FileUploadRequestOptions, type FileUploadStatus, type FitLabelsOptions, type FittedLabel, type FlowNavigate, type FlowProgress, FlowSaved, type FlowSavedProps, type FlowStep, type FlowSteps, FormWrapper, Gantt, type GanttGroup, type GanttItem, type GanttProps, type GanttStatus, type GanttTone, type GridKeyboard, type GridKeyboardOptions, HoverCard, INPUT_MODALITY_ATTR, InlineFieldError, Input, type InputModality, Kbd, Label, type LabelBox, Launcher, type LauncherEdge, type LauncherProps, type LauncherVariant, type LauncherWhenOpen, Link, type LinkProps, LocaleProvider, type LocaleProviderProps, MentionInput, type MentionInputProps, MentionSuggestion, MobileHeaderMenu, type MobileHeaderMenuItemData, type MobileHeaderMenuType, NavItem, type NavItemProps, type NavItemType, NavMenu, type NavMenuItem, Navbar, type NavbarSize, type NavbarType, type NavbarVariant, NotificationCenter, NumberInput, type Occurrence, PageActions, PageContainer, type PageContainerWidth, PageHeader, type PageHeaderBehavior, type PageHeaderIntensity, type PageHeaderProps, type PageHeaderVariant, Pager, Pagination, PinInput, Popover, Progress, type PromiseToastMessages, RadioGroup, Rating, type Recurrence, type RecurrenceFrequency, RecurrencePicker, type RecurrencePickerProps, type RecurrencePreset, type RecurrenceScope, RecurrenceScopeDialog, type RecurrenceScopeDialogProps, RelativeTime, type RelativeTimeProps, type RepeatChange, type RepeatingEvent, ScrollArea, SectionHeading, type SectionHeadingProps, SegmentedControl, SettingsLayout, type SettingsLayoutProps, type SettingsSection, Sheet, Sidebar, type SidebarContextValue, type SidebarItem, SidebarNav, type SidebarNavSize, type SidebarPosition, type SidebarSection, type SidebarType, Skeleton, SkipLink, SliderRange, type SortDir, Spinner, StackedList, type StackedListVariant, StatsCard, StatusDot, type StatusDotVariant, Stepper, TIME_ZOOMS, type Tab, Table, type TableDensity, type TableProps, type TableRow, TableToolbar, type TableToolbarActiveFilter, type TableToolbarFilterOption, Tabs, TabsContent, TabsList, TabsTrigger, Tag, TagInput, type TagPaletteColor, type TagVariant, TextOverflow, type TextOverflowProps, Textarea, TimeBar, type TimeBarProps, TimePicker, TimeRow, type TimeRowProps, type TimeScale, TimeScaleHeader, type TimeScaleHeaderProps, type TimeScaleOptions, type TimeTick, type TimeValue, TimeViewport, type TimeViewportHandle, type TimeViewportLayout, type TimeViewportProps, type TimeViewportState, type TimeZoom, Timeline, TimezoneSelect, type TimezoneSelectProps, Toast, type ToastAction, type ToastApi, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, Toggle, Tooltip, Tour, TransferList, TreeView, type Trend, type UseFlowStepsOptions, type UseTextOverflowOptions, type UseTextOverflowResult, type WeekOfMonth, type Weekday, browserTimeZone, canonicalTimeZone, countEdited, dateOfDay, dayOf, deleteOccurrence, describeRecurrence, endDayOf, fitLabel, fitLabels, formatDateRange, formatFullTime, formatRelativeTime, inputModality, installInputModality, nthOf, occurrenceOn, occurrences, parseRRule, readFlowProgress, readRecurrence, recurrencePresets, sameRecurrence, saveOccurrence, timeExtent, timeZoneOffset, toRRule, useAppShell, useBrowserTimeZone, useContentWidth, useDestructiveAction, useFittedLabels, useFlowSteps, useFormContext, useFormatLocale, useGridKeyboard, useHydrated, useInputModality, useRelativeTimeFormat, useRevealFocus, useSidebar, useTextMeasure, useTextOverflow, useTimeScale, useTimeViewport, useTimeViewportLayout, useToast, useToastOptional, useUnsavedChanges };
+export { Accordion, ActionPanel, ActionPanelGroup, AddAnother, type AddAnotherProps, Alert, type AlertConsent, type AlertConsentChoice, type AlertPlacement, AppShell, type AppShellContextValue, type AppShellFocus, AppShellPreferences, type AppShellTheme, AsidePanel, type AsidePanelProps, type AsidePanelSide, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarStatus, Badge, type BadgePaletteColor, type BadgeSeverity, type BadgeSize, type BadgeVariant, BottomNav, type BottomNavItem, BreakpointKey, BulkActionBar, Button, ButtonSizeContext, Calendar, type CalendarColour, type CalendarDay, type CalendarDayClickDetail, type CalendarEvent, type CalendarEventAction, type CalendarEventAttendee, type CalendarProps, type CalendarSize, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardGrid, type CardGridProps, CardHeader, type CardSelectType, CardTitle, type CardVariant, Carousel, type ChatMessage, type ChatMessageAction, type ChatMessageLayout, ChatMessageList, type ChatMessageSender, type ChatMessageSource, type ChatMessageStatus, ChatPanel, type ChatPanelProps, type ChatPanelStatusTone, Checkbox, CheckboxGroup, CheckboxGroupItem, CodeBlock, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorPicker, type Column, Combobox, CommandPalette, ContextMenu, type ControlSize, ControlSizeContext, CornerPanel, type CornerPanelEdge, type CornerPanelProps, DEFAULT_DATE_RANGE_PRESETS, DangerZone, type DangerZoneProps, DataList, type DateInput, DatePicker, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DateRangeWords, type DescriptionItem, DescriptionList, type DescriptionListOrientation, type DescriptionListSize, type DestructiveActionHandle, type DestructiveActionOptions, Dialog, type DisabledDates, Divider, Dock, Drawer, Dropdown, DropdownMenuEntry, EmptyState, EntityCell, type EventCategory, Field, type FieldControlProps, type FieldLabel, type FieldProps, FileUpload, type FileUploadItem, type FileUploadRequestOptions, type FileUploadStatus, type FitLabelsOptions, type FittedLabel, type FlowNavigate, type FlowProgress, FlowSaved, type FlowSavedProps, type FlowStep, type FlowSteps, FormWrapper, Gantt, type GanttGroup, type GanttItem, type GanttProps, type GanttStatus, type GanttTone, type GridKeyboard, type GridKeyboardOptions, HoverCard, INPUT_MODALITY_ATTR, InlineFieldError, Input, type InputModality, Kbd, Label, type LabelBox, Launcher, type LauncherEdge, type LauncherProps, type LauncherVariant, type LauncherWhenOpen, Link, type LinkProps, LocaleProvider, type LocaleProviderProps, MentionInput, type MentionInputProps, MentionSuggestion, MobileHeaderMenu, type MobileHeaderMenuItemData, type MobileHeaderMenuType, NavItem, type NavItemProps, type NavItemType, NavMenu, type NavMenuItem, Navbar, type NavbarSize, type NavbarType, type NavbarVariant, NotificationCenter, NumberInput, type Occurrence, PageActions, PageContainer, type PageContainerWidth, PageHeader, type PageHeaderBehavior, type PageHeaderIntensity, type PageHeaderProps, type PageHeaderVariant, Pager, Pagination, PinInput, Popover, Progress, type PromiseToastMessages, RadioGroup, Rating, type Recurrence, type RecurrenceFrequency, RecurrencePicker, type RecurrencePickerProps, type RecurrencePreset, type RecurrenceScope, RecurrenceScopeDialog, type RecurrenceScopeDialogProps, RelativeTime, type RelativeTimeProps, type RepeatChange, type RepeatingEvent, ScrollArea, SectionHeading, type SectionHeadingProps, SegmentedControl, SettingsLayout, type SettingsLayoutProps, type SettingsSection, Sheet, Sidebar, type SidebarContextValue, type SidebarItem, SidebarNav, type SidebarNavSize, type SidebarPosition, type SidebarSection, type SidebarType, Skeleton, SkipLink, SliderRange, type SortDir, Spinner, StackedList, type StackedListVariant, StatsCard, StatusDot, type StatusDotVariant, Stepper, TIME_ZOOMS, type Tab, Table, type TableDensity, type TableProps, type TableRow, TableToolbar, type TableToolbarActiveFilter, type TableToolbarFilterOption, Tabs, TabsContent, TabsList, TabsTrigger, Tag, TagInput, type TagPaletteColor, type TagVariant, TextOverflow, type TextOverflowProps, Textarea, TimeBar, type TimeBarProps, TimePicker, TimeRow, type TimeRowProps, type TimeScale, TimeScaleHeader, type TimeScaleHeaderProps, type TimeScaleOptions, type TimeTick, type TimeValue, TimeViewport, type TimeViewportHandle, type TimeViewportLayout, type TimeViewportProps, type TimeViewportState, type TimeZoom, Timeline, TimezoneSelect, type TimezoneSelectProps, Toast, type ToastAction, type ToastApi, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, Toggle, Tooltip, Tour, TransferList, TreeView, type Trend, type UseFlowStepsOptions, type UseTextOverflowOptions, type UseTextOverflowResult, type WeekOfMonth, type Weekday, browserTimeZone, canonicalTimeZone, countEdited, dateOfDay, dayOf, deleteOccurrence, describeRecurrence, endDayOf, fitLabel, fitLabels, formatDateRange, formatFullTime, formatRelativeTime, inputModality, installInputModality, nthOf, occurrenceOn, occurrences, parseRRule, readFlowProgress, readRecurrence, recurrencePresets, sameRecurrence, saveOccurrence, timeExtent, timeZoneOffset, toRRule, useAppShell, useBrowserTimeZone, useContentWidth, useDestructiveAction, useFittedLabels, useFlowSteps, useFormContext, useFormatLocale, useGridKeyboard, useHydrated, useInputModality, useRelativeTimeFormat, useRevealFocus, useSidebar, useTextMeasure, useTextOverflow, useTimeScale, useTimeViewport, useTimeViewportLayout, useToast, useToastOptional, useUnsavedChanges };