@marktiderman/genesis-ui 1.3.0 → 2.1.0

package/dist/index.js

@@ -1,56 +1,72 @@
-export { Tooltip } from './chunk-EI5EGKHL.js';
 export { H1, H2, H3, H4, Large, Lead, Muted, P, Small } from './chunk-HVQCZFJ7.js';
-export { Slider } from './chunk-LRXDZBV2.js';
+export { VisuallyHidden } from './chunk-SY62XJFA.js';
+export { Tabs, TabsContent, TabsList, TabsTrigger } from './chunk-VXFYETRK.js';
+export { ToggleGroup, ToggleGroupItem } from './chunk-NUXW6NPP.js';
+export { Toolbar, ToolbarButton, ToolbarLink, ToolbarSeparator, ToolbarToggleGroup, ToolbarToggleItem, toolbarVariants } from './chunk-YYEGAFUE.js';
+export { Toggle, toggleVariants } from './chunk-C46ITXE4.js';
+export { Tooltip } from './chunk-G5YKBPBF.js';
+export { ScrollArea } from './chunk-6KHY647C.js';
+export { Slider } from './chunk-PSR47JRA.js';
 export { Toaster, toast } from './chunk-4RAZJ6LL.js';
-export { Tabs, TabsContent, TabsList, TabsTrigger } from './chunk-JJ4NOMMI.js';
-export { ToggleGroup, ToggleGroupItem } from './chunk-5Q4FABZQ.js';
-export { Toggle, toggleVariants } from './chunk-JXI2MYL3.js';
-export { RadioGroup, RadioGroupItem } from './chunk-TKA4LOMT.js';
+export { Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger } from './chunk-AL5TMEZQ.js';
+export { NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, navigationMenuTriggerStyle } from './chunk-THD3YOOZ.js';
+export { Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious } from './chunk-IJCT5IJD.js';
+export { PasswordToggleField, PasswordToggleFieldIcon, PasswordToggleFieldInput, PasswordToggleFieldSlot, PasswordToggleFieldToggle } from './chunk-SRIT4NFQ.js';
+export { RadioGroup, RadioGroupItem } from './chunk-ZZ7H7VVX.js';
 export { ResizableHandle, ResizablePanel, ResizablePanelGroup } from './chunk-TAP3PBQT.js';
-export { ScrollArea } from './chunk-OCTV3S4I.js';
-export { InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot } from './chunk-K23AQNOM.js';
-export { Kbd } from './chunk-FFSDFQQN.js';
-export { Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger } from './chunk-4V4H2ZM7.js';
-export { NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, navigationMenuTriggerStyle } from './chunk-SVXDWPLO.js';
-export { Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious } from './chunk-KB5T5LWM.js';
-export { DatePicker } from './chunk-6VVVGYKS.js';
 export { Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger } from './chunk-JYPENH7T.js';
-export { EmptyState, NoFeaturesFound, NoFeedbackFound, NoSearchResults } from './chunk-ZDAT5JDH.js';
-export { HoverCard, HoverCardContent, HoverCardTrigger } from './chunk-63FW5ZUA.js';
+export { HoverCard, HoverCardContent, HoverCardTrigger } from './chunk-P3ZL6FGR.js';
 export { InputGroup, InputGroupInput, InputGroupPrefix, InputGroupSuffix } from './chunk-GJ6XSCNF.js';
-export { Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious } from './chunk-AUECDWP2.js';
+export { InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot } from './chunk-K23AQNOM.js';
+export { Kbd } from './chunk-FFSDFQQN.js';
 export { ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent } from './chunk-QCJAASJT.js';
-export { ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger } from './chunk-UGHQFQOE.js';
-export { Alert, AlertDescription, AlertTitle, alertVariants } from './chunk-OZZTPE7F.js';
-export { AspectRatio } from './chunk-WALXVR6V.js';
-export { Avatar, AvatarFallback, AvatarImage } from './chunk-C6H7AMO4.js';
+export { ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger } from './chunk-6TVMQH6M.js';
+export { DatePicker } from './chunk-6XPMU65K.js';
 export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from './chunk-2MQKBZBJ.js';
 export { ButtonGroup } from './chunk-K4YLKVMX.js';
-export { Calendar, CalendarDayButton } from './chunk-44TULYGG.js';
-export { Spinner } from './chunk-OVU3Z2MT.js';
-export { Switch } from './chunk-2MXMWBDV.js';
+export { Calendar, CalendarDayButton } from './chunk-J6FBA7PH.js';
+export { Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious } from './chunk-AOZGQM6W.js';
+export { AccessibleIcon } from './chunk-JAMLFMDS.js';
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from './chunk-YWFPMND7.js';
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger } from './chunk-M62CHO3N.js';
+export { AspectRatio } from './chunk-6Q6CLLJ4.js';
+export { Container, Stack, containerVariants, stackVariants } from './chunk-4CQHPWJD.js';
+export { FormPage } from './chunk-PLIYF6KI.js';
+export { Alert, AlertDescription, AlertTitle, alertVariants } from './chunk-OZZTPE7F.js';
+export { Section, SettingsPage, sectionHeadingVariants } from './chunk-P64MFQXZ.js';
+export { StatusBadge, statusBadgeVariants } from './chunk-XMK3T4TA.js';
+export { ToggleRow } from './chunk-6M4NHHKG.js';
+export { UserAvatar, userAvatarVariants } from './chunk-XBX6QMR5.js';
+export { Avatar, AvatarFallback, AvatarImage } from './chunk-LNFF2RBD.js';
+export { SettingsRow } from './chunk-A7AHVDG7.js';
 export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from './chunk-N2ZFNOOT.js';
 export { Textarea } from './chunk-YETMISCE.js';
-export { Progress } from './chunk-W5Y3LG5K.js';
-export { Select, SelectContent, SelectGroup, SelectItem, SelectScrollDownButton, SelectScrollUpButton, SelectTrigger, SelectValue } from './chunk-2B3MFHBQ.js';
 export { Separator } from './chunk-SXSCHWZU.js';
-export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger } from './chunk-SCUT2ZCD.js';
+export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger } from './chunk-XCGZPFT7.js';
 export { Skeleton } from './chunk-QFM4Z2SS.js';
+export { Progress } from './chunk-W5Y3LG5K.js';
+export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from './chunk-QJ6P2DW6.js';
 export { Input } from './chunk-QSXVL5UB.js';
-export { Popover, PopoverContent, PopoverTrigger } from './chunk-NJMO3VPA.js';
-export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from './chunk-SBJV3K4G.js';
-export { FormDescription, FormError, FormField, FormLabel } from './chunk-IP6TMT3D.js';
-export { Label } from './chunk-T5VX5DYO.js';
+export { Checkbox } from './chunk-SEBU6JCK.js';
 export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from './chunk-FN3FZVUR.js';
-export { Checkbox } from './chunk-WZWR2ELB.js';
-export { Collapsible, CollapsibleContent, CollapsibleTrigger } from './chunk-KBS4BHME.js';
+export { Collapsible, CollapsibleContent, CollapsibleTrigger } from './chunk-B2GIBUQD.js';
 export { Badge } from './chunk-NPNADZHM.js';
-export { Button } from './chunk-ZJFSZFPI.js';
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from './chunk-5J7BP5DI.js';
-export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger } from './chunk-QBZMY2AF.js';
-export { CommandPalette, useCommandPaletteHotkey } from './chunk-A2OXCNNY.js';
-export { Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut } from './chunk-7OBL3H5P.js';
-export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger } from './chunk-YZEA5TGK.js';
+export { Select, SelectContent, SelectGroup, SelectItem, SelectScrollDownButton, SelectScrollUpButton, SelectTrigger, SelectValue } from './chunk-FK42ZGGV.js';
+export { Popover, PopoverContent, PopoverTrigger } from './chunk-22XB3Q6H.js';
+export { Switch } from './chunk-27ELYTGE.js';
+export { EmptyState, NoFeaturesFound, NoFeedbackFound, NoSearchResults } from './chunk-65SPT7EA.js';
+export { Button } from './chunk-NWSCYLPT.js';
+export { PageLoading, pageLoadingVariants } from './chunk-YRYQXU3G.js';
+export { Spinner } from './chunk-OVU3Z2MT.js';
+export { FormDescription, FormError, FormField, FormLabel } from './chunk-R7QFP6EL.js';
+export { Label } from './chunk-F47U5KNW.js';
+export { DashboardPage, Grid, gridVariants } from './chunk-ARJI2JUV.js';
+export { DetailPage } from './chunk-AFZ76Q26.js';
+export { Split, splitVariants } from './chunk-D2LIXA2Y.js';
+export { GAP_CLASSES, spaceScale } from './chunk-AVFZ4P4B.js';
+export { CommandPalette, useCommandPaletteHotkey } from './chunk-CNTWQSUT.js';
+export { Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut } from './chunk-SEFK4NZV.js';
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger } from './chunk-7XMZVISM.js';
 export { cn } from './chunk-NZ5WBA4R.js';
 export { DefaultLink, defaultNavigate, isPathActive, useBrowserSearchParams } from './chunk-6NPEMLBA.js';
 //# sourceMappingURL=index.js.map

package/dist/spacing-BS6qECD4.d.ts

@@ -0,0 +1,191 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const stackVariants: (props?: ({
+    direction?: "row" | "column" | null | undefined;
+    gap?: "sm" | "lg" | "none" | "xs" | "md" | "xl" | "2xl" | "3xl" | null | undefined;
+    align?: "center" | "end" | "start" | "stretch" | null | undefined;
+    justify?: "center" | "end" | "start" | "between" | "around" | null | undefined;
+    wrap?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface StackProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof stackVariants> {
+    /** Stable test/automation selector (emitted as `data-testid`). */
+    testID?: string;
+}
+/**
+ * Stack — one-dimensional flow. The single most-repeated shape in any
+ * application: a run of things in a line, evenly spaced.
+ *
+ * It replaces the `flex flex-col gap-4` / `flex items-center gap-2` strings
+ * that otherwise get retyped in every file, and it is the reason `gap`
+ * stays on the shared `SpaceToken` scale (see `./spacing`) instead of
+ * drifting per page.
+ *
+ * ```tsx
+ * <Stack gap="lg">
+ *   <Card />
+ *   <Card />
+ * </Stack>
+ *
+ * <Stack direction="row" align="center" justify="between" gap="sm">
+ *   <h2>Members</h2>
+ *   <Button>Invite</Button>
+ * </Stack>
+ * ```
+ *
+ * Deliberately NOT here: responsive per-breakpoint directions. A layout
+ * that changes axis at a breakpoint is a `Split`, which owns that idea and
+ * names the breakpoint explicitly.
+ *
+ * Note for consumers of both surfaces: `@marktiderman/genesis-ui-native`
+ * splits this shape into two components, `Stack` (column) and `Inline`
+ * (row). On web they are one component with a `direction` prop, which is
+ * the established web idiom. The `gap` / `align` / `justify` vocabulary is
+ * identical either way — deliberately, and enforced by a test that reads
+ * the native definitions directly — so a spec written once still reads the
+ * same on both. That means the web unions are the SHARED vocabulary, not
+ * everything web flexbox can do; see the note on `align` below.
+ *
+ * @stability Beta
+ */
+declare const Stack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<HTMLDivElement>>;
+
+declare const sectionHeadingVariants: (props?: ({
+    level?: 2 | 4 | 3 | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SectionProps extends Omit<React.HTMLAttributes<HTMLElement>, "title"> {
+    /** Section heading. Required — an untitled region is just a `Stack`. */
+    title: React.ReactNode;
+    /** Optional supporting copy under the heading. */
+    description?: React.ReactNode;
+    /** Optional trailing controls for this region (a button, a menu, a filter). */
+    actions?: React.ReactNode;
+    /**
+     * Heading level. Default `2`, i.e. a top-level region of a page whose
+     * `<h1>` is the page title. Drop to `3`/`4` when nesting so the outline
+     * stays legal — heading level is document structure, not a font size.
+     */
+    level?: 2 | 3 | 4;
+    /** Escape hatch for the heading's own classes (type scale, color). */
+    headingClassName?: string;
+    /** Stable test/automation selector (emitted as `data-testid`). */
+    testID?: string;
+}
+/**
+ * Section — a titled region of a page: heading, optional description,
+ * optional trailing actions, and the content itself.
+ *
+ * ```tsx
+ * <Section
+ *   title="Team members"
+ *   description="Everyone with access to this workspace."
+ *   actions={<Button>Invite</Button>}
+ * >
+ *   <Grid cols={3}>{…}</Grid>
+ * </Section>
+ * ```
+ *
+ * Renders a real `<section>` named by its own heading through
+ * `aria-labelledby`, which is what turns it into a navigable landmark —
+ * an unnamed `<section>` is announced as nothing at all, so the markup
+ * that *looks* the most semantic is the markup that most often isn't.
+ *
+ * The header collapses to a column below `sm`, so a long title and an
+ * action button never fight over the same line on a phone.
+ *
+ * @stability Beta
+ */
+declare const Section: React.ForwardRefExoticComponent<SectionProps & React.RefAttributes<HTMLElement>>;
+
+declare const containerVariants: (props?: ({
+    size?: "sm" | "lg" | "md" | "full" | "prose" | null | undefined;
+    gutter?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ContainerProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof containerVariants> {
+    /** Stable test/automation selector (emitted as `data-testid`). */
+    testID?: string;
+}
+/**
+ * Container — the page gutter: a centered column with a named maximum
+ * width and responsive side padding.
+ *
+ * ```tsx
+ * <Container>
+ *   <Section title="Overview">{…}</Section>
+ * </Container>
+ *
+ * <Container size="sm">
+ *   <SettingsForm />
+ * </Container>
+ *
+ * <Container size="full" gutter={false}>
+ *   <FullBleedMap />
+ * </Container>
+ * ```
+ *
+ * `gutter` is a real prop rather than a `className` override because the
+ * padding is responsive: passing `px-0` would only cancel the base step
+ * and leave `sm:px-6` and `lg:px-8` intact, so the escape hatch that looks
+ * like it should work silently doesn't.
+ *
+ * @stability Beta
+ */
+declare const Container: React.ForwardRefExoticComponent<ContainerProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Layout spacing scale — the single source of truth for the `gap` prop
+ * shared by `Stack`, `Grid` and `Split`.
+ *
+ * These are the SAME semantic step names and the SAME pixel values as
+ * `@marktiderman/genesis-ui-native`'s `spaceScale`
+ * (`packages/ui-native/src/components/layout/spacing.ts`), which already
+ * governs the native `Stack` / `Inline` / `Box` / `Grid`. That parity is the
+ * point: `gap="lg"` has to mean 16px on both surfaces, or a design spec
+ * written once produces two different pages. A second, subtly-different
+ * six-step scale on web would have been exactly the "one concept, two
+ * divergent implementations" failure `docs/FRAMEWORK.md` is written to
+ * prevent.
+ *
+ * Every emitted class is a STATIC literal in `GAP_CLASSES` rather than a
+ * template built at runtime, for the same reason the native side spells its
+ * table out: Tailwind compiles only the class names its content scanner
+ * finds in source. A `gap-${scale[token] / 4}` form is invisible to the
+ * scanner, so any step that doesn't independently appear as a literal
+ * elsewhere silently renders with no gap at all.
+ *
+ * @stability Beta
+ */
+/** Semantic spacing steps, in pixels, on the 4px design grid. */
+declare const spaceScale: {
+    readonly none: 0;
+    readonly xs: 4;
+    readonly sm: 8;
+    readonly md: 12;
+    readonly lg: 16;
+    readonly xl: 24;
+    readonly "2xl": 32;
+    readonly "3xl": 48;
+};
+/**
+ * The spacing vocabulary shared by every layout primitive — and, by
+ * construction, by the native ones too.
+ */
+type SpaceToken = keyof typeof spaceScale;
+/**
+ * `SpaceToken` → Tailwind gap utility. `satisfies` keeps the table
+ * exhaustive against the scale, so adding a step to `spaceScale` without a
+ * class here is a type error rather than a silently missing gap.
+ */
+declare const GAP_CLASSES: {
+    readonly none: "gap-0";
+    readonly xs: "gap-1";
+    readonly sm: "gap-2";
+    readonly md: "gap-3";
+    readonly lg: "gap-4";
+    readonly xl: "gap-6";
+    readonly "2xl": "gap-8";
+    readonly "3xl": "gap-12";
+};
+
+export { Container as C, GAP_CLASSES as G, Section as S, type ContainerProps as a, type SectionProps as b, type SpaceToken as c, Stack as d, type StackProps as e, containerVariants as f, spaceScale as g, stackVariants as h, sectionHeadingVariants as s };

package/dist/split-Dk9f4Mi0.d.ts

@@ -0,0 +1,57 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * Breakpoint at which a `Split` stops stacking and becomes side-by-side.
+ * These are Tailwind's own breakpoint names, so `at="lg"` means exactly
+ * what `lg:` means everywhere else in the app.
+ */
+type SplitBreakpoint = "sm" | "md" | "lg" | "xl";
+/** How the horizontal space divides once the split is side-by-side. */
+type SplitRatio = "1/3" | "1/2" | "2/3";
+declare const splitVariants: (props?: ({
+    at?: "sm" | "lg" | "md" | "xl" | null | undefined;
+    gap?: "sm" | "lg" | "none" | "xs" | "md" | "xl" | "2xl" | "3xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SplitProps extends React.HTMLAttributes<HTMLDivElement>, Omit<VariantProps<typeof splitVariants>, "at"> {
+    /** Leading pane — the "master" half. Renders first when stacked. */
+    start: React.ReactNode;
+    /** Trailing pane — the "detail" half. Renders second when stacked. */
+    end: React.ReactNode;
+    /** Share of the width the `start` pane takes. Default `"1/3"`. */
+    ratio?: SplitRatio;
+    /** Breakpoint at and above which the panes sit side by side. Default `"md"`. */
+    at?: SplitBreakpoint;
+    /** Stable test/automation selector (emitted as `data-testid`). */
+    testID?: string;
+}
+/**
+ * Split — the master-detail layout: two panes side by side above a
+ * breakpoint, stacked below it.
+ *
+ * ```tsx
+ * <Split
+ *   ratio="1/3"
+ *   at="lg"
+ *   gap="lg"
+ *   start={<ConversationList />}
+ *   end={<ConversationDetail />}
+ * />
+ * ```
+ *
+ * The stacking behaviour is the whole reason this is a component rather
+ * than two divs: a hand-rolled split usually forgets the small screen, and
+ * a hand-rolled split that remembers usually picks a different breakpoint
+ * from the one next door.
+ *
+ * Two panes only, and both are required — a "split" with an optional half
+ * is a `Stack`, and a three-pane shell (nav + list + detail) is an
+ * application shell, not a layout primitive. Nest a `Split` inside a
+ * `Split` if you genuinely need three.
+ *
+ * @stability Beta
+ */
+declare const Split: React.ForwardRefExoticComponent<SplitProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Split as S, type SplitBreakpoint as a, type SplitProps as b, type SplitRatio as c, splitVariants as s };

package/dist/{use-resource-page-BXBv_Xah.d.ts → use-resource-page-DTQS011Q.d.ts}

@@ -1,7 +1,7 @@
+import * as React from 'react';
 import { ReactNode } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Density } from './hooks/use-view-settings.js';
-import { V as ViewMode } from './ViewToggle-DDe_Luj2.js';
+import { V as ViewMode } from './view-toggle-CahQ87PW.js';
 import { Identifier, FilterParam, SortParam } from '@marktiderman/genesis-core/provider';
 
 interface DataTableColumn<T> {
@@ -59,15 +59,15 @@ interface DataTableProps<T> {
      */
     density?: Density;
 }
-declare function DataTable<T>({ items, columns, getKey, onRowClick, selectable, selected, onToggleSelect, onToggleAll, renderActions, emptyMessage, columnVisibility, columnVisibilityKey, resizableColumns, pagination, pageSize: initialPageSize, pageSizeOptions, stickyHeader, resizeKey, stickyFirstColumn, density, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
+declare function DataTable<T>({ items, columns, getKey, onRowClick, selectable, selected, onToggleSelect, onToggleAll, renderActions, emptyMessage, columnVisibility, columnVisibilityKey, resizableColumns, pagination, pageSize: initialPageSize, pageSizeOptions, stickyHeader, resizeKey, stickyFirstColumn, density, }: DataTableProps<T>): React.JSX.Element;
 declare function ThumbnailCell({ src, alt, }: {
     src?: string | null;
     alt: string;
-}): react_jsx_runtime.JSX.Element;
+}): React.JSX.Element;
 declare function LinkCell({ href, label, }: {
     href?: string | null;
     label?: string;
-}): react_jsx_runtime.JSX.Element;
+}): React.JSX.Element;
 
 /** Actions available inside column render functions. */
 interface ResourceActions<T> {
@@ -111,11 +111,23 @@ interface UseResourcePageProps<T> {
     titleField?: string;
     /** Field used for the detail subtitle. Defaults to second column key. */
     subtitleField?: string;
+    /**
+     * Server-controlled mode. The `data` handed in has ALREADY been searched,
+     * sorted and paginated by the server, so this hook must not do any of it a
+     * second time — `data` is returned untouched and `total` is the server's
+     * `total` rather than the length of a client-filtered slice.
+     *
+     * Search / sort / status state is still tracked (the filter UI stays
+     * controlled and `onFiltersChange` still fires) — only the client-side
+     * transform of `data` is skipped. Defaults to `false`, so every existing
+     * caller keeps its current client-side behavior.
+     */
+    controlled?: boolean;
 }
 interface UseResourcePageReturn<T> {
     /** Filtered and sorted data for display. */
     data: T[];
-    /** Total count (of the filtered set). */
+    /** Total count (of the filtered set; the server's `total` when `controlled`). */
     total: number;
     /** Resolved column definitions. */
     columns: ResourceColumnDef<T>[];

package/dist/view-settings-kHKCHMjj.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+import { Density } from './hooks/use-view-settings.js';
+
+interface ViewSettingsProps {
+    pageSize: number;
+    onPageSizeChange: (size: number) => void;
+    density: Density;
+    onDensityChange: (density: Density) => void;
+}
+declare function ViewSettings({ pageSize, onPageSizeChange, density, onDensityChange, }: ViewSettingsProps): React.JSX.Element;
+
+export { ViewSettings as V };

package/dist/{ViewToggle-DDe_Luj2.d.ts → view-toggle-CahQ87PW.d.ts}

@@ -1,10 +1,10 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
 
 type ViewMode = "grid" | "table" | "list";
 interface ViewToggleProps {
     viewMode: ViewMode;
     onViewModeChange: (mode: ViewMode) => void;
 }
-declare function ViewToggle({ viewMode, onViewModeChange }: ViewToggleProps): react_jsx_runtime.JSX.Element;
+declare function ViewToggle({ viewMode, onViewModeChange }: ViewToggleProps): React.JSX.Element;
 
 export { type ViewMode as V, ViewToggle as a };