gridsmith-ui 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -2,12 +2,14 @@ import * as react from 'react';
 import { ButtonHTMLAttributes, ReactNode, InputHTMLAttributes, LabelHTMLAttributes, TextareaHTMLAttributes, Ref, CSSProperties, ReactElement, HTMLAttributes, AnchorHTMLAttributes, ComponentType } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { IconName } from './icons.js';
-import { B as BreakpointKey } from './use-breakpoint-BfKzmkxx.js';
-export { a as BreakpointWidthProvider, u as useBreakpoint } from './use-breakpoint-BfKzmkxx.js';
+import { C as ColumnKind, B as BreakpointKey } from './table-utils-GounRE6s.js';
+export { a as BreakpointWidthProvider, u as useBreakpoint } from './table-utils-GounRE6s.js';
 
 type ButtonVariant = "default" | "secondary" | "tertiary" | "outline" | "ghost" | "destructive" | "success" | "warning" | "link";
 type ButtonSize = "xs" | "sm" | "md" | "lg" | "icon-xs" | "icon-sm" | "icon" | "icon-lg";
-declare const ButtonSizeContext: react.Context<ButtonSize | null>;
+type ControlSize = "sm" | "md" | "lg";
+declare const ControlSizeContext: react.Context<ControlSize | null>;
+declare const ButtonSizeContext: react.Context<ControlSize | null>;
 interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: ButtonVariant;
     size?: ButtonSize;
@@ -55,8 +57,8 @@ interface BulkActionBarProps {
 }
 declare function BulkActionBar({ selectedCount, actions, onClearSelection, className }: BulkActionBarProps): react_jsx_runtime.JSX.Element | null;
 
-type InputSize = "sm" | "md";
-declare function Input({ className, size, error, prefix, suffix, ...props }: Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "prefix"> & {
+type InputSize = "sm" | "md" | "lg";
+declare function Input({ className, size: sizeProp, error, prefix, suffix, ...props }: Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "prefix"> & {
     size?: InputSize;
     error?: boolean;
     prefix?: ReactNode;
@@ -88,7 +90,7 @@ interface Option {
     label: string;
     group?: string;
 }
-type DropdownSize = "sm" | "md";
+type DropdownSize = "sm" | "md" | "lg";
 interface DropdownProps {
     options: Option[];
     value: string | string[];
@@ -108,7 +110,7 @@ interface DropdownProps {
     /** Accessible name for the trigger, for when there is no visible `label` (e.g. in a toolbar). */
     "aria-label"?: string;
 }
-declare function Dropdown({ options, value, onChange, label, disabled, placeholder, multiple, searchable, size, className, ref, container, error, showChips, "aria-label": ariaLabel, }: DropdownProps): react_jsx_runtime.JSX.Element;
+declare function Dropdown({ options, value, onChange, label, disabled, placeholder, multiple, searchable, size: sizeProp, className, ref, container, error, showChips, "aria-label": ariaLabel, }: DropdownProps): react_jsx_runtime.JSX.Element;
 
 interface ComboboxOption {
     value: string;
@@ -126,8 +128,9 @@ interface ComboboxProps {
     ref?: Ref<HTMLDivElement>;
     container?: Element | DocumentFragment;
     error?: boolean;
+    size?: ControlSize;
 }
-declare function Combobox({ value, onChange, options, placeholder, disabled, loading, className, ref, container, error }: ComboboxProps): react_jsx_runtime.JSX.Element;
+declare function Combobox({ value, onChange, options, placeholder, disabled, loading, className, ref, container, error, size: sizeProp }: ComboboxProps): react_jsx_runtime.JSX.Element;
 
 type CheckboxSize = "sm" | "md";
 interface CheckboxProps {
@@ -186,6 +189,7 @@ interface DatePickerProps {
     label?: string;
     /** Forwarded to the trigger button so an external Label htmlFor can be associated. Defaults to a generated id used by the built-in label. */
     id?: string;
+    size?: ControlSize;
     /** Earliest / latest selectable day (inclusive). Days outside are disabled. */
     min?: Date;
     max?: Date;
@@ -200,7 +204,7 @@ interface DatePickerProps {
         end?: Date | null;
     };
 }
-declare function DatePicker({ value, onChange, placeholder, disabled, className, ref, container, error, label, id, min, max, range }: DatePickerProps): react_jsx_runtime.JSX.Element;
+declare function DatePicker({ value, onChange, placeholder, disabled, className, ref, container, error, label, id, size: sizeProp, min, max, range }: DatePickerProps): react_jsx_runtime.JSX.Element;
 
 interface DateRange {
     start: Date | null;
@@ -230,6 +234,7 @@ interface DateRangePickerProps {
     presets?: DateRangePreset[];
     /** First day of the week. Default 0 (Sunday). */
     weekStartsOn?: 0 | 1;
+    size?: ControlSize;
 }
 declare const DEFAULT_DATE_RANGE_PRESETS: DateRangePreset[];
 /**
@@ -238,7 +243,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, placeholder, disabled, error, label, id, className, ref, container, min, max, presets, weekStartsOn, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
+declare function DateRangePicker({ value, onChange, placeholder, disabled, error, label, id, className, ref, container, min, max, presets, weekStartsOn, size: sizeProp, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
 
 interface FileUploadProps {
     onFiles: (files: File[]) => void;
@@ -284,8 +289,9 @@ interface TimePickerProps {
     error?: boolean;
     /** Forwarded to the trigger button so a Label htmlFor can be associated. */
     id?: string;
+    size?: ControlSize;
 }
-declare function TimePicker({ value, onChange, use24Hour, minuteStep, disabled, className, ref, container, error, id, }: TimePickerProps): react_jsx_runtime.JSX.Element;
+declare function TimePicker({ value, onChange, use24Hour, minuteStep, disabled, className, ref, container, error, id, size: sizeProp, }: TimePickerProps): react_jsx_runtime.JSX.Element;
 
 interface NumberInputProps {
     value: number;
@@ -305,7 +311,7 @@ interface NumberInputProps {
     /** Forwarded to the inner input element so a Label htmlFor can be associated. */
     id?: string;
 }
-declare function NumberInput({ value, onChange, min, max, step, disabled, placeholder, prefix, suffix, size, className, error, allowDecimals, id, }: NumberInputProps): react_jsx_runtime.JSX.Element;
+declare function NumberInput({ value, onChange, min, max, step, disabled, placeholder, prefix, suffix, size: sizeProp, className, error, allowDecimals, id, }: NumberInputProps): react_jsx_runtime.JSX.Element;
 
 interface TagInputProps {
     value: string[];
@@ -334,7 +340,7 @@ interface PinInputProps {
     /** Forwarded to the first pin box so a Label htmlFor can be associated. */
     id?: string;
 }
-declare function PinInput({ value, onChange, length, mask, disabled, size, className, error, id, }: PinInputProps): react_jsx_runtime.JSX.Element;
+declare function PinInput({ value, onChange, length, mask, disabled, size: sizeProp, className, error, id, }: PinInputProps): react_jsx_runtime.JSX.Element;
 
 interface RatingProps {
     value: number;
@@ -411,14 +417,33 @@ interface FormContextValue {
     submitted: boolean;
 }
 declare function useFormContext(): FormContextValue;
+/** An invalid field as the form finds it in its own DOM after a submit. */
+interface FormFieldError {
+    id: string;
+    label: string;
+    message: string;
+}
 interface FormWrapperProps {
     onSubmit: (errors: FormErrors) => void;
     validationMode?: ValidationMode;
     children: ReactNode;
+    /**
+     * The buttons row (submit, cancel) with a clear gap above the last field — never a hand-rolled flex row under it
+     * (bench round 3, R12). Right-aligned like CardFooter and the overlay footers; `actionsAlign="start"` for a narrow form.
+     */
+    actions?: ReactNode;
+    actionsAlign?: "start" | "end";
+    /** After a failed submit, scroll to and focus the first invalid field (default on). */
+    focusFirstError?: boolean;
+    /**
+     * When two or more fields are invalid after a submit, an error summary above the form links to each (default on).
+     * A function renders your own from the list.
+     */
+    errorSummary?: boolean | ((errors: FormFieldError[]) => ReactNode);
     className?: string;
     ref?: React.Ref<HTMLFormElement>;
 }
-declare function FormWrapper({ onSubmit, validationMode, children, className, ref }: FormWrapperProps): react_jsx_runtime.JSX.Element;
+declare function FormWrapper({ onSubmit, validationMode, children, actions, actionsAlign, focusFirstError, errorSummary, className, ref }: FormWrapperProps): react_jsx_runtime.JSX.Element;
 
 interface TransferItem {
     id: string;
@@ -476,7 +501,11 @@ interface CardHeaderProps extends HTMLAttributes<HTMLDivElement> {
     menuItems?: DropdownMenuEntry[];
 }
 declare const CardHeader: react.ForwardRefExoticComponent<CardHeaderProps & react.RefAttributes<HTMLDivElement>>;
-declare const CardTitle: react.ForwardRefExoticComponent<HTMLAttributes<HTMLHeadingElement> & react.RefAttributes<HTMLHeadingElement>>;
+interface CardTitleProps extends HTMLAttributes<HTMLHeadingElement> {
+    /** Max lines before clamping (with the full title on hover). Default 2, like CardDescription; 1 truncates on one line; 0 = no limit. */
+    lines?: number;
+}
+declare const CardTitle: react.ForwardRefExoticComponent<CardTitleProps & react.RefAttributes<HTMLHeadingElement>>;
 interface CardDescriptionProps extends HTMLAttributes<HTMLParagraphElement> {
     /** Max lines before clamping. Default 2. Set to 0 for no limit. */
     lines?: number;
@@ -488,6 +517,8 @@ declare const CardFooter: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDiv
 interface Trend {
     direction: "up" | "down" | "flat";
     value: string;
+    /** Whether the change is good news. Default: up = positive, down = negative, flat = neutral. Pass "positive" for a falling cost or overdue count, "negative" for rising churn or errors. */
+    sentiment?: "positive" | "negative" | "neutral";
 }
 interface StatsCardProps {
     value: string | number;
@@ -528,7 +559,8 @@ interface DescriptionListProps {
     columns?: 1 | 2 | 3 | 4;
     size?: DescriptionListSize;
     dividers?: boolean;
-    stackBelow?: "sm" | "md" | "lg";
+    /** Below this breakpoint a multi-column list becomes one column. Default "sm" when columns > 1 (a phone never shows two columns of pairs); "none" keeps the columns at every width. */
+    stackBelow?: "sm" | "md" | "lg" | "none";
     className?: string;
 }
 declare const DescriptionList: react.ForwardRefExoticComponent<DescriptionListProps & react.RefAttributes<HTMLDListElement>>;
@@ -567,6 +599,8 @@ interface Column {
     };
     /** CSS max-width for the column (e.g. "200px", "30ch"). Helps constrain wide text columns. */
     maxWidth?: string;
+    /** Explicit column kind. When omitted the Table infers it from data values. */
+    kind?: ColumnKind;
 }
 type SortDir = "asc" | "desc" | null;
 type TableDensity = "default" | "compact";
@@ -636,8 +670,11 @@ declare function Calendar({ events, view: controlledView, defaultView, onViewCha
 type BadgeVariant = "default" | "neutral" | "subtle" | "success" | "success-soft" | "warning" | "warning-soft" | "error" | "error-soft" | "outline";
 type BadgeSize = "xs" | "sm" | "md";
 type BadgePaletteColor = 1 | 2 | 3 | 4 | 5;
+type BadgeSeverity = "info" | "low" | "medium" | "high" | "critical";
 interface BadgeProps {
     variant?: BadgeVariant;
+    /** Severity shorthand — maps to a variant. When set, overrides `variant`. */
+    severity?: BadgeSeverity;
     size?: BadgeSize;
     /** Palette colour (1-5). Overrides variant colour with decorative palette tokens. */
     color?: BadgePaletteColor;
@@ -650,7 +687,7 @@ interface BadgeProps {
     className?: string;
     children?: ReactNode;
 }
-declare function Badge({ variant, size, color, iconLeft, iconRight, maxWidth, className, children }: BadgeProps): react_jsx_runtime.JSX.Element;
+declare function Badge({ variant, severity, size, color, iconLeft, iconRight, maxWidth, className, children }: BadgeProps): react_jsx_runtime.JSX.Element;
 
 type TagVariant = "default" | "subtle" | "success" | "warning" | "error" | "outline";
 type TagPaletteColor = 1 | 2 | 3 | 4 | 5;
@@ -736,6 +773,16 @@ interface EmptyStateProps {
 }
 declare function EmptyState({ icon, iconFrame, title, description, action, variant, bordered, className }: EmptyStateProps): react_jsx_runtime.JSX.Element;
 
+interface EntityCellProps {
+    /** Image URL (creates an Avatar) or a pre-built ReactNode. */
+    avatar: string | ReactNode;
+    primary: string;
+    secondary?: string;
+    size?: "sm" | "md";
+    className?: string;
+}
+declare function EntityCell({ avatar, primary, secondary, size, className }: EntityCellProps): react_jsx_runtime.JSX.Element;
+
 interface SkipLinkProps {
     /** The id of the main region (AppShell names its <main> "main"). */
     href?: string;
@@ -812,19 +859,24 @@ interface TimelineItem {
 }
 interface TimelineProps {
     items: TimelineItem[];
+    /** "responsive" lays the items out horizontally only when they fit at minItemWidth each, else vertically. */
     orientation?: "vertical" | "horizontal" | "responsive";
+    /** The least width a horizontal item gets before the row scrolls (a structural size, not a design value). */
+    minItemWidth?: number;
     className?: string;
     ref?: Ref<HTMLDivElement>;
 }
-declare function Timeline({ items, orientation, className, ref }: TimelineProps): react_jsx_runtime.JSX.Element;
+declare function Timeline({ items, orientation, minItemWidth, className, ref }: TimelineProps): react_jsx_runtime.JSX.Element;
 
 interface CodeBlockProps {
     code: string;
     language?: string;
     showLineNumbers?: boolean;
+    /** Wrap long lines instead of scrolling sideways. Default: on for a single-line snippet (a tracking tag, a command), off for multi-line code. */
+    wrap?: boolean;
     className?: string;
 }
-declare function CodeBlock({ code, language, showLineNumbers, className, }: CodeBlockProps): react_jsx_runtime.JSX.Element;
+declare function CodeBlock({ code, language, showLineNumbers, wrap, className, }: CodeBlockProps): react_jsx_runtime.JSX.Element;
 
 interface CollapsibleProps {
     open?: boolean;
@@ -1115,6 +1167,8 @@ interface StackedListProps {
     flush?: boolean;
     /** The current row in a master-detail list. Its treatment follows the theme's in-page vertical active style (rail, tint or pill), like Tabs. */
     selectedId?: string | number;
+    /** How an interactive row answers the pointer: "tint" (default) shades the row; "title" colours the title, for article lists (a knowledge base, a changelog). */
+    hover?: "tint" | "title";
     className?: string;
 }
 declare const StackedList: react.ForwardRefExoticComponent<StackedListProps & react.RefAttributes<HTMLUListElement>>;
@@ -1253,6 +1307,142 @@ declare const Tabs: typeof TabsRoot & {
     Content: typeof TabsContent;
 };
 
+/**
+ * The theme's shell-level decisions, carried once by AppShell so that
+ * PageHeader and PageContainer can render a page the way the builder preview
+ * renders it without the page passing a single flag (Sprint 25, 14 Sep 2026).
+ *
+ * The generated shell passes the object the template emits; the builder
+ * preview passes the same values from the theme state. Every field is
+ * optional: a page's own props always win over the theme, and a header
+ * outside any shell falls back to the component defaults it always had.
+ */
+type ChromePosition = "flush" | "floating";
+type ThemePageHeaderVariant = "default" | "colourful" | "minimal" | "tabs-integrated";
+type ThemePageHeaderBehavior = "static" | "snapping";
+type ThemePageHeaderIntensity = "subtle" | "bold";
+type ThemeBreadcrumbPosition = "inline" | "contained";
+type ThemeBreadcrumbStyle = "default" | "pill";
+type ThemeBreadcrumbSeparator = "chevron" | "slash" | "dot" | "arrow";
+type ThemeSettingsLayout = "sidebar" | "tabs";
+interface AppShellTheme {
+    /** Where the navbar sits; a floating navbar's gutter is the gap above a floating header. Confirmed by the rendered Navbar. */
+    navbarPosition?: ChromePosition;
+    /** Where the sidebar sits; a floating sidebar's gutter is the gap beside a floating header. Confirmed by the rendered Sidebar. */
+    sidebarPosition?: ChromePosition;
+    pageHeader?: {
+        variant?: ThemePageHeaderVariant;
+        behavior?: ThemePageHeaderBehavior;
+        position?: ChromePosition;
+        /** Colourful only. */
+        intensity?: ThemePageHeaderIntensity;
+        /** Colourful on the home page only; other pages take `otherPagesVariant`. The shell decides which page is home. */
+        colourfulHomeOnly?: boolean;
+        otherPagesVariant?: "default" | "minimal";
+        /** Colourful: the container derives the overlap from the first content element and pulls it up. */
+        overlap?: boolean;
+    };
+    breadcrumbs?: {
+        /** Inline in the header, or a contained strip the container renders above it. */
+        position?: ThemeBreadcrumbPosition;
+        style?: ThemeBreadcrumbStyle;
+        separator?: ThemeBreadcrumbSeparator;
+    };
+    /** The customer's settings.layout preference: a rail of sections beside the panel, or horizontal tabs above it. SettingsLayout reads it. */
+    settingsLayout?: ThemeSettingsLayout;
+}
+
+interface SettingsSection {
+    id: string;
+    label: string;
+    icon?: IconName;
+    /** Heading above this section in the rail; the option group in the collapsed Dropdown. */
+    group?: string;
+    disabled?: boolean;
+}
+interface SettingsLayoutProps {
+    sections: SettingsSection[];
+    /** The selected section id. */
+    value: string;
+    onChange: (id: string) => void;
+    /**
+     * 'sidebar': a rail of sections beside the panel; 'tabs': horizontal tabs above it.
+     * Default: the shell theme's settings.layout preference, else 'sidebar'. A page passes nothing.
+     */
+    layout?: ThemeSettingsLayout;
+    /** Width of the rail in px (sidebar layout). */
+    railWidth?: number;
+    /**
+     * Below this width of the layout itself (not the viewport) the rail becomes a Dropdown. Default: the rail plus a
+     * usable panel (railWidth + 480). Measured on the layout, so a narrow PageContainer or a sidebar shell counts.
+     */
+    collapseBelow?: number;
+    /** Accessible name of the section navigation. */
+    "aria-label"?: string;
+    /** The panel: the selected section's content. */
+    children: ReactNode;
+    className?: string;
+}
+/**
+ * The settings page composition (Sprint 25.2, R8): a rail of sections beside
+ * the panel, sticky while the page scrolls, or horizontal tabs above it — the
+ * customer's settings.layout preference decides which, the component decides
+ * the breakpoints. The collapse is measured on the layout's own width (a narrow
+ * PageContainer, a sidebar shell): when the rail would leave too little for the
+ * panel it becomes a Dropdown above the panel; a vertical rail never sits above
+ * the content (settings#10).
+ *
+ * The rail is a Tabs (vertical) styled by the theme's in-page vertical style;
+ * the page assembles the sections' contents and nothing else.
+ */
+declare function SettingsLayout({ sections, value, onChange, layout: layoutProp, railWidth, collapseBelow, "aria-label": ariaLabel, children, className, }: SettingsLayoutProps): react_jsx_runtime.JSX.Element;
+
+type SplitViewFrame = "fill" | "page";
+interface SplitViewProps {
+    /** The list (an inbox, a queue): it scrolls on its own. */
+    list: ReactNode;
+    /** The selected item (a thread, a record): it fills the height and scrolls on its own. */
+    detail: ReactNode;
+    /** Context beside the detail (a contact, properties). Collapses to a toggle that opens it in a Drawer when the layout is narrower than `asideCollapseBelow`. */
+    aside?: ReactNode;
+    /** Names the aside's toggle and Drawer. */
+    asideTitle?: string;
+    /**
+     * Below `collapseBelow` the list shows alone; with `detailOpen` the detail replaces it, with a Back button that calls
+     * `onDetailClose` (detailMode "stack"). The page owns the selection, so it owns this flag.
+     */
+    detailOpen?: boolean;
+    onDetailClose?: () => void;
+    /** "stack" (default): the detail stacks over the list below the collapse width. "route": the app navigates to the detail's own route instead, and this renders the list alone there. */
+    detailMode?: "stack" | "route";
+    backLabel?: string;
+    /** Percent of the width the list takes; the divider is draggable. */
+    listWidth?: number;
+    listMinWidth?: number;
+    asideWidth?: number;
+    /** Below this width of the layout itself (px) the list and detail stop sitting side by side. */
+    collapseBelow?: number;
+    /** Below this width of the layout itself (px) the aside becomes a toggle. */
+    asideCollapseBelow?: number;
+    /** A bordered, rounded surface (inside a page with padding) instead of edge to edge (filling <main>). */
+    bordered?: boolean;
+    /** "fill": the page root, flush to the shell, h-full against main, each pane owns its inset. "page" (default): inside a PageContainer under a PageHeader. */
+    frame?: SplitViewFrame;
+    "aria-label"?: string;
+    className?: string;
+}
+/**
+ * The reading-pane composition (Sprint 25.2, R3): one surface with dividers —
+ * list, detail and an optional aside — that fills the height it is given (an
+ * AppShell's <main> already gives it) and never three cards with gaps. The
+ * panels compose ResizablePanelGroup, so the dividers drag. Below the collapse
+ * width, measured on the layout itself, the list shows alone and the detail
+ * stacks over it (or the app routes to it); the aside collapses to a toggle.
+ * The page owns the selection and assembles the contents; keyboard movement
+ * through the list is the list's job (StackedList selectedId).
+ */
+declare function SplitView({ list, detail, aside, asideTitle, detailOpen, onDetailClose, detailMode, backLabel, listWidth, listMinWidth, asideWidth, collapseBelow, asideCollapseBelow, bordered, frame, "aria-label": ariaLabel, className, }: SplitViewProps): react_jsx_runtime.JSX.Element;
+
 interface BreadcrumbItem$1 {
     label: string;
     href?: string;
@@ -1408,8 +1598,13 @@ interface SegmentedControlProps {
     className?: string;
     /** Accessible name for the radiogroup, for when there is no visible label (e.g. in a toolbar). */
     "aria-label"?: string;
+    /**
+     * Above this many options the control renders a Dropdown with the same value, onChange and options — a row of
+     * eleven segments runs off the page (bench round 3). Default 6; raise it only where the row is known to fit.
+     */
+    maxOptions?: number;
 }
-declare function SegmentedControl({ value, onChange, options, size, variant, fullWidth, onHoverChange, className, "aria-label": ariaLabel, }: SegmentedControlProps): react_jsx_runtime.JSX.Element;
+declare function SegmentedControl({ value, onChange, options, size: sizeProp, variant, fullWidth, onHoverChange, className, "aria-label": ariaLabel, maxOptions, }: SegmentedControlProps): react_jsx_runtime.JSX.Element;
 
 interface BottomNavItem {
     label: string;
@@ -1454,8 +1649,6 @@ interface PageHeaderProps {
     intensity?: PageHeaderIntensity;
     /** Colourful: background image URL — overlaid with accent colour */
     backgroundImage?: string;
-    /** Colourful: extra bottom padding (px) for content overlap. Content below should use -mt-[value] to pull up. */
-    overlapHeight?: number;
     /** Snapping: content shown only when expanded */
     expandedContent?: ReactNode;
     /** Snapping: scroll offset before collapse (px) */
@@ -1593,6 +1786,10 @@ interface DialogProps {
     description?: string;
     children?: ReactNode;
     footer?: ReactNode;
+    /** The content has unsaved changes: Escape, the backdrop and the close control ask before discarding, inside the dialog (Sprint 25.2, C1). */
+    dirty?: boolean;
+    /** Called when the user chooses to discard, before onClose. */
+    onDiscard?: () => void;
     variant?: "default" | "destructive";
     size?: DialogSize;
     alert?: boolean;
@@ -1608,7 +1805,7 @@ interface DialogProps {
      */
     onSubmit?: () => void;
 }
-declare function Dialog({ open, onClose, title, description, children, footer, variant, size, alert, container, onSubmit }: DialogProps): react.ReactPortal | null;
+declare function Dialog({ open, onClose: onCloseProp, title, description, children, footer, variant, size, alert, container, onSubmit, dirty, onDiscard }: DialogProps): react.ReactPortal | null;
 
 interface DrawerProps {
     open: boolean;
@@ -1658,6 +1855,10 @@ interface DrawerProps {
      */
     resizable?: boolean;
     maxWidth?: string;
+    /** The content has unsaved changes: every close path asks before discarding, inside the drawer (Sprint 25.2, C1). */
+    dirty?: boolean;
+    /** Called when the user chooses to discard, before onClose. */
+    onDiscard?: () => void;
 }
 declare function Drawer(props: DrawerProps): react_jsx_runtime.JSX.Element;
 
@@ -1746,6 +1947,8 @@ interface SheetProps {
     title?: ReactNode;
     children: ReactNode;
     footer?: ReactNode;
+    /** A strip between the content and the footer (the Drawer's unsaved-changes question). */
+    confirm?: ReactNode;
     /** Heights the sheet snaps to, as fractions of the viewport (or container). Default [0.5, 0.92]. */
     snapPoints?: number[];
     /** Render inside this element (absolute positioning, no body scroll lock) instead of document.body. */
@@ -1759,7 +1962,7 @@ interface SheetProps {
     /** id of the element that names the dialog when no title is rendered. */
     labelledBy?: string;
 }
-declare function Sheet({ open, onClose, title, children, footer, snapPoints, container, flush, keepMounted, id, labelledBy }: SheetProps): react.ReactPortal | null;
+declare function Sheet({ open, onClose, title, children, footer, confirm, snapPoints, container, flush, keepMounted, id, labelledBy }: SheetProps): react.ReactPortal | null;
 
 interface Notification {
     id: string;
@@ -1943,46 +2146,6 @@ interface ScrollAreaProps {
 }
 declare function ScrollArea({ children, className, orientation, maxHeight, maxWidth, }: ScrollAreaProps): react_jsx_runtime.JSX.Element;
 
-/**
- * The theme's shell-level decisions, carried once by AppShell so that
- * PageHeader and PageContainer can render a page the way the builder preview
- * renders it without the page passing a single flag (Sprint 25, 14 Sep 2026).
- *
- * The generated shell passes the object the template emits; the builder
- * preview passes the same values from the theme state. Every field is
- * optional: a page's own props always win over the theme, and a header
- * outside any shell falls back to the component defaults it always had.
- */
-type ChromePosition = "flush" | "floating";
-type ThemePageHeaderVariant = "default" | "colourful" | "minimal" | "tabs-integrated";
-type ThemePageHeaderBehavior = "static" | "snapping";
-type ThemePageHeaderIntensity = "subtle" | "bold";
-type ThemeBreadcrumbPosition = "inline" | "contained";
-type ThemeBreadcrumbStyle = "default" | "pill";
-type ThemeBreadcrumbSeparator = "chevron" | "slash" | "dot" | "arrow";
-interface AppShellTheme {
-    /** Where the navbar sits; a floating navbar's gutter is the gap above a floating header. Confirmed by the rendered Navbar. */
-    navbarPosition?: ChromePosition;
-    /** Where the sidebar sits; a floating sidebar's gutter is the gap beside a floating header. Confirmed by the rendered Sidebar. */
-    sidebarPosition?: ChromePosition;
-    pageHeader?: {
-        variant?: ThemePageHeaderVariant;
-        behavior?: ThemePageHeaderBehavior;
-        position?: ChromePosition;
-        /** Colourful only. */
-        intensity?: ThemePageHeaderIntensity;
-        /** Colourful on the home page only; other pages take `otherPagesVariant`. The shell decides which page is home. */
-        colourfulHomeOnly?: boolean;
-        otherPagesVariant?: "default" | "minimal";
-    };
-    breadcrumbs?: {
-        /** Inline in the header, or a contained strip the container renders above it. */
-        position?: ThemeBreadcrumbPosition;
-        style?: ThemeBreadcrumbStyle;
-        separator?: ThemeBreadcrumbSeparator;
-    };
-}
-
 interface AppShellContextValue {
     hasSidebar: boolean;
     hasMobileMenu: boolean;
@@ -2028,6 +2191,13 @@ interface AppShellContextValue {
     sidebarFloating: boolean;
     /** Called by Sidebar and Navbar so the shell knows the chrome that is actually rendered. Returns the unregister. */
     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. */
+    launcherCorner: "bottom-right" | "bottom-left" | null;
+    /** 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;
 }
 declare function useAppShell(): AppShellContextValue | null;
 type AppShellLayout = "sidebar" | "stacked" | "sidebar-header" | "multi-column";
@@ -2179,4 +2349,4 @@ interface UseTextOverflowResult {
  */
 declare function useTextOverflow(options?: UseTextOverflowOptions): UseTextOverflowResult;
 
-export { Accordion, ActionPanel, ActionPanelGroup, Alert, type AlertPlacement, AppShell, type AppShellContextValue, type AppShellTheme, AsidePanel, type AsidePanelProps, type AsidePanelSide, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarStatus, Badge, type BadgePaletteColor, type BadgeSize, type BadgeVariant, BottomNav, type BottomNavItem, type BreadcrumbItem$1 as BreadcrumbItem, Breadcrumbs, type BreadcrumbsSeparator, type BreadcrumbsSize, type BreadcrumbsVariant, BreakpointKey, BulkActionBar, Button, ButtonSizeContext, Calendar, Card, CardContent, CardDescription, CardFooter, 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, ColorPicker, type Column, Combobox, CommandPalette, ContextMenu, CornerPanel, type CornerPanelEdge, type CornerPanelProps, DEFAULT_DATE_RANGE_PRESETS, DataList, DatePicker, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DescriptionItem, DescriptionList, type DescriptionListOrientation, type DescriptionListSize, Dialog, Divider, Dock, Drawer, Dropdown, DropdownMenu, type DropdownMenuDivider, type DropdownMenuEntry, type DropdownMenuItem, EmptyState, Field, type FieldControlProps, type FieldProps, FileUpload, FormWrapper, HoverCard, InlineFieldError, Input, Kbd, Label, Launcher, type LauncherEdge, type LauncherProps, type LauncherVariant, type LauncherWhenOpen, Link, type LinkProps, MentionInput, MobileHeaderMenu, type MobileHeaderMenuItemData, type MobileHeaderMenuType, NavItem, type NavItemProps, type NavItemType, NavMenu, type NavMenuItem, Navbar, type NavbarSize, type NavbarType, type NavbarVariant, NotificationCenter, NumberInput, PageContainer, type PageContainerWidth, PageHeader, type PageHeaderBehavior, type PageHeaderIntensity, type PageHeaderProps, type PageHeaderVariant, Pagination, PinInput, Popover, Progress, type PromiseToastMessages, RadioGroup, Rating, ScrollArea, SectionHeading, SegmentedControl, Sheet, Sidebar, type SidebarContextValue, type SidebarItem, SidebarNav, type SidebarNavSize, type SidebarPosition, type SidebarSection, type SidebarType, Skeleton, SkipLink, SliderRange, Spinner, StackedList, StatsCard, StatusDot, type StatusDotVariant, Stepper, type Tab, Table, type TableDensity, type TableProps, TableToolbar, type TableToolbarActiveFilter, type TableToolbarFilterOption, Tabs, Tag, TagInput, type TagPaletteColor, type TagVariant, TextOverflow, type TextOverflowProps, Textarea, TimePicker, Timeline, Toast, type ToastAction, type ToastApi, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, Toggle, Tooltip, Tour, TransferList, TreeView, type UseTextOverflowOptions, type UseTextOverflowResult, useAppShell, useFormContext, useSidebar, useTextOverflow, useToast };
+export { Accordion, ActionPanel, ActionPanelGroup, Alert, type AlertPlacement, AppShell, type AppShellContextValue, 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, type BreadcrumbItem$1 as BreadcrumbItem, Breadcrumbs, type BreadcrumbsSeparator, type BreadcrumbsSize, type BreadcrumbsVariant, BreakpointKey, BulkActionBar, Button, ButtonSizeContext, Calendar, Card, CardContent, CardDescription, CardFooter, 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, ColorPicker, type Column, Combobox, CommandPalette, ContextMenu, type ControlSize, ControlSizeContext, CornerPanel, type CornerPanelEdge, type CornerPanelProps, DEFAULT_DATE_RANGE_PRESETS, DataList, DatePicker, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DescriptionItem, DescriptionList, type DescriptionListOrientation, type DescriptionListSize, Dialog, Divider, Dock, Drawer, Dropdown, DropdownMenu, type DropdownMenuDivider, type DropdownMenuEntry, type DropdownMenuItem, EmptyState, EntityCell, Field, type FieldControlProps, type FieldProps, FileUpload, FormWrapper, HoverCard, InlineFieldError, Input, Kbd, Label, Launcher, type LauncherEdge, type LauncherProps, type LauncherVariant, type LauncherWhenOpen, Link, type LinkProps, MentionInput, MobileHeaderMenu, type MobileHeaderMenuItemData, type MobileHeaderMenuType, NavItem, type NavItemProps, type NavItemType, NavMenu, type NavMenuItem, Navbar, type NavbarSize, type NavbarType, type NavbarVariant, NotificationCenter, NumberInput, PageContainer, type PageContainerWidth, PageHeader, type PageHeaderBehavior, type PageHeaderIntensity, type PageHeaderProps, type PageHeaderVariant, Pagination, PinInput, Popover, Progress, type PromiseToastMessages, RadioGroup, Rating, ScrollArea, SectionHeading, SegmentedControl, SettingsLayout, type SettingsLayoutProps, type SettingsSection, Sheet, Sidebar, type SidebarContextValue, type SidebarItem, SidebarNav, type SidebarNavSize, type SidebarPosition, type SidebarSection, type SidebarType, Skeleton, SkipLink, SliderRange, Spinner, SplitView, type SplitViewFrame, type SplitViewProps, StackedList, StatsCard, StatusDot, type StatusDotVariant, Stepper, type Tab, Table, type TableDensity, type TableProps, TableToolbar, type TableToolbarActiveFilter, type TableToolbarFilterOption, Tabs, Tag, TagInput, type TagPaletteColor, type TagVariant, TextOverflow, type TextOverflowProps, Textarea, TimePicker, Timeline, Toast, type ToastAction, type ToastApi, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, Toggle, Tooltip, Tour, TransferList, TreeView, type Trend, type UseTextOverflowOptions, type UseTextOverflowResult, useAppShell, useFormContext, useSidebar, useTextOverflow, useToast };