@marktiderman/genesis-ui 2.11.0 → 2.12.0

package/dist/components/layout/index.d.ts

@@ -1,5 +1,5 @@
-export { A as AppShell, a as AppShellOptions, b as AppShellProps, N as NavItem, P as ParentNavigation } from '../../AppShell-BVr4V0UK.js';
-export { G as GenesisLinkProps, L as LinkComponent, N as NavigationNode, R as ResolvedNavigation, r as resolveNavigation } from '../../navigation-Bha0R3Fu.js';
+export { A as AppShell, a as AppShellOptions, b as AppShellPageHeader, c as AppShellProps, d as AppShellSubNavEnd, N as NavItem, P as ParentNavigation, S as SubNavItem, e as SubNavMode, f as SubNavTabs, g as SubNavTabsProps, U as UseAppShellSubNavOptions, u as useAppShellSubNav } from '../../AppShell-DpQdcLE-.js';
+export { G as GenesisLinkProps, L as LinkComponent, N as NavigationNode, R as ResolvedNavigation, r as resolveNavigation } from '../../navigation-By1DrzaM.js';
 export { P as PageHeader, a as PageHeaderOptions, b as PageHeaderProps } from '../../PageHeader-V9lVkZtF.js';
 export { DetailPage, DetailPageProps } from './detail-page.js';
 export { FormPage, FormPageProps } from './form-page.js';

package/dist/components/layout/index.js

@@ -1,4 +1,4 @@
-export { AppShell, PageHeader } from '../../chunk-UYI3GLFJ.js';
+export { AppShell, AppShellPageHeader, AppShellSubNavEnd, PageHeader, SubNavTabs, useAppShellSubNav } from '../../chunk-SZMXNC5Q.js';
 import '../../chunk-46TZGMFW.js';
 export { Container, Stack, containerVariants, stackVariants } from '../../chunk-4CQHPWJD.js';
 import '../../chunk-B2GIBUQD.js';
@@ -6,6 +6,7 @@ import '../../chunk-NPNADZHM.js';
 import '../../chunk-FK42ZGGV.js';
 import '../../chunk-QJ6P2DW6.js';
 import '../../chunk-27ELYTGE.js';
+import '../../chunk-G5YKBPBF.js';
 import '../../chunk-22XB3Q6H.js';
 export { DashboardPage, Grid, gridVariants } from '../../chunk-ARJI2JUV.js';
 export { DetailPage } from '../../chunk-AFZ76Q26.js';
@@ -17,6 +18,6 @@ export { GAP_CLASSES, spaceScale } from '../../chunk-AVFZ4P4B.js';
 import '../../chunk-NWSCYLPT.js';
 import '../../chunk-F47U5KNW.js';
 import '../../chunk-NZ5WBA4R.js';
-export { resolveNavigation } from '../../chunk-WGMEVX3Y.js';
+export { resolveNavigation } from '../../chunk-KC43CNMA.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/components/rich-text/rich-text-editor.js

@@ -2,9 +2,9 @@
 import { parseVideoUrl, sanitizeVideoEmbedAttrs, videoEmbedTitle, VIDEO_IFRAME_ATTRS, videoEmbedSrc, isRichTextDoc, isSafeUrl, sanitizeRichTextDoc, richTextClassName, richTextToHtml, RichText, normalizeLinkUrl, isRichTextEmpty, richTextToPlainText } from '../../chunk-ZDHWNQTR.js';
 import { ToolbarButton, Toolbar, ToolbarSeparator, ToolbarToggleGroup, ToolbarToggleItem } from '../../chunk-YYEGAFUE.js';
 import '../../chunk-C46ITXE4.js';
-import { Tooltip } from '../../chunk-G5YKBPBF.js';
 import { Kbd } from '../../chunk-FFSDFQQN.js';
 import { Input } from '../../chunk-QSXVL5UB.js';
+import { Tooltip } from '../../chunk-G5YKBPBF.js';
 import { Popover, PopoverTrigger, PopoverContent } from '../../chunk-22XB3Q6H.js';
 import { Button } from '../../chunk-NWSCYLPT.js';
 import { Label } from '../../chunk-F47U5KNW.js';

package/dist/hooks/index.d.ts

@@ -6,11 +6,11 @@ export { ResponsiveViewMode, ViewModeDefault, useViewPreference } from './use-vi
 export { Density, ViewSettings, useViewSettings } from './use-view-settings.js';
 export { UseSavedViewsReturn, useSavedViews } from './use-saved-views.js';
 export { RouteMap, createPrefetch } from './use-prefetch.js';
-export { R as ResourceTableState, u as useResourceTable } from '../use-resource-table-Dx1OZRne.js';
+export { R as ResourceTableState, u as useResourceTable } from '../use-resource-table-DrTkD5O1.js';
 export { ResourceUrlParams, ResourceUrlState, ResourceUrlStateOptions, useResourceUrlState } from './use-resource-url-state.js';
 export { R as ResourceActions, a as ResourceColumnDef, U as UseResourcePageProps, b as UseResourcePageReturn, u as useResourcePage } from '../use-resource-page-DaJzuq3M.js';
 export { CommandPalette, CommandPaletteItem, CommandPaletteProps, useCommandPaletteHotkey } from '../components/ui/command-palette.js';
-import '../navigation-Bha0R3Fu.js';
+import '../navigation-By1DrzaM.js';
 import 'react';
 import '../view-toggle-CahQ87PW.js';
 import 'lucide-react';

package/dist/hooks/index.js

@@ -1,4 +1,4 @@
-export { useResourceTable } from '../chunk-5GOQ72WB.js';
+export { useResourceTable } from '../chunk-3TWCZYZY.js';
 export { useResourcePage } from '../chunk-RKPS7ERS.js';
 export { useResourceUrlState } from '../chunk-DIV4BYXX.js';
 export { useSavedViews } from '../chunk-GCQFVMPI.js';
@@ -9,8 +9,8 @@ export { CommandPalette, useCommandPaletteHotkey } from '../chunk-CNTWQSUT.js';
 import '../chunk-SEFK4NZV.js';
 import '../chunk-7XMZVISM.js';
 import '../chunk-NZ5WBA4R.js';
-export { useDataFilters } from '../chunk-OITWCIG2.js';
-import '../chunk-WGMEVX3Y.js';
+export { useDataFilters } from '../chunk-XGG5RUDE.js';
+import '../chunk-KC43CNMA.js';
 export { useKeyboardNavigation } from '../chunk-YJ6MPS6U.js';
 export { useIsMobile } from '../chunk-VFO3I7PV.js';
 export { createPrefetch } from '../chunk-HSHIZHYR.js';

package/dist/hooks/use-data-filters.d.ts

@@ -1,4 +1,4 @@
-import { S as SearchParamsAdapter } from '../navigation-Bha0R3Fu.js';
+import { S as SearchParamsAdapter } from '../navigation-By1DrzaM.js';
 import 'react';
 
 type FilterType = "string" | "multi";

package/dist/hooks/use-data-filters.js

@@ -1,4 +1,4 @@
-export { useDataFilters } from '../chunk-OITWCIG2.js';
-import '../chunk-WGMEVX3Y.js';
+export { useDataFilters } from '../chunk-XGG5RUDE.js';
+import '../chunk-KC43CNMA.js';
 //# sourceMappingURL=use-data-filters.js.map
 //# sourceMappingURL=use-data-filters.js.map

package/dist/hooks/use-resource-url-state.d.ts

@@ -1,4 +1,4 @@
-import { S as SearchParamsAdapter } from '../navigation-Bha0R3Fu.js';
+import { S as SearchParamsAdapter } from '../navigation-By1DrzaM.js';
 import { SortParam } from '@marktiderman/genesis-core/provider';
 import 'react';
 

package/dist/index.d.ts

@@ -68,7 +68,7 @@ export { DetailPage, DetailPageProps } from './components/layout/detail-page.js'
 export { FormPage, FormPageProps } from './components/layout/form-page.js';
 export { SettingsPage, SettingsPageProps, SettingsPageSection } from './components/layout/settings-page.js';
 export { cn } from './utils.js';
-export { D as DefaultLink, G as GenesisLinkProps, I as IsPathActiveOptions, L as LinkComponent, a as NavigateFn, N as NavigationNode, R as ResolvedNavigation, S as SearchParamsAdapter, d as defaultNavigate, i as isPathActive, r as resolveNavigation, u as useBrowserSearchParams } from './navigation-Bha0R3Fu.js';
+export { D as DefaultLink, G as GenesisLinkProps, I as IsPathActiveOptions, L as LinkComponent, a as NavigateFn, N as NavigationNode, R as ResolvedNavigation, S as SearchParamsAdapter, d as defaultNavigate, i as isPathActive, r as resolveNavigation, u as useBrowserSearchParams } from './navigation-By1DrzaM.js';
 export { S as SlotOverride, a as SlotPropsFor, b as Slots, r as renderSlot } from './slots-tR0wf89f.js';
 export { toast } from 'sonner';
 import 'class-variance-authority/types';

package/dist/index.js

@@ -32,7 +32,6 @@ export { UserAvatar, userAvatarVariants } from './chunk-XBX6QMR5.js';
 export { Avatar, AvatarFallback, AvatarImage } from './chunk-LNFF2RBD.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 { Kbd } from './chunk-FFSDFQQN.js';
 export { renderSlot } from './chunk-7S7LKQBD.js';
 export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from './chunk-N2ZFNOOT.js';
@@ -54,6 +53,7 @@ export { Badge } from './chunk-NPNADZHM.js';
 export { Select, SelectContent, SelectGroup, SelectItem, SelectScrollDownButton, SelectScrollUpButton, SelectTrigger, SelectValue } from './chunk-FK42ZGGV.js';
 export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from './chunk-QJ6P2DW6.js';
 export { Switch } from './chunk-27ELYTGE.js';
+export { Tooltip } from './chunk-G5YKBPBF.js';
 export { Popover, PopoverContent, PopoverTrigger } from './chunk-22XB3Q6H.js';
 export { DashboardPage, Grid, gridVariants } from './chunk-ARJI2JUV.js';
 export { DetailPage } from './chunk-AFZ76Q26.js';
@@ -71,6 +71,6 @@ 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, resolveNavigation, useBrowserSearchParams } from './chunk-WGMEVX3Y.js';
+export { DefaultLink, defaultNavigate, isPathActive, resolveNavigation, useBrowserSearchParams } from './chunk-KC43CNMA.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{navigation-Bha0R3Fu.d.ts → navigation-By1DrzaM.d.ts}

@@ -92,6 +92,30 @@ interface NavigationNode<T> {
     /** Contextual nav items to show while this node is current. */
     items: T[];
     children?: NavigationNode<T>[];
+    /**
+     * Ask the app shell to open its desktop sidebar collapsed (icon rail) while
+     * this node, or a descendant that doesn't set its own value, is current.
+     * The nearest node in the resolved trail that sets it wins, so
+     * `defaultCollapsed: false` on a child re-opens it under a collapsed
+     * parent. Only a default: once the user has toggled the sidebar, their
+     * choice wins everywhere. `AppShell` reads it; `resolveNavigation` copies
+     * it through untouched.
+     *
+     * @stability Beta
+     */
+    defaultCollapsed?: boolean;
+    /**
+     * How the app shell shows this node's `items` (its child pages, e.g. a
+     * form's Questions / Logic / Responses / Settings). `"tabs"` (across the
+     * top of the content) or `"sidebar"` (nested under the active item) turn
+     * shell sub-navigation on, which also gives phones a back item plus the
+     * children in the bottom bar. `"section"` is the legacy rendering (the
+     * shell's default) and `"off"` hides them. The nearest node in the trail
+     * that sets it wins over the shell's `options.subNav`.
+     *
+     * @stability Beta
+     */
+    subNav?: "section" | "tabs" | "sidebar" | "off";
 }
 /**
  * Result of {@link resolveNavigation}. `current`, `parent` and every `trail`

package/dist/router/react-router.d.ts

@@ -1,4 +1,4 @@
-import { L as LinkComponent, a as NavigateFn, S as SearchParamsAdapter } from '../navigation-Bha0R3Fu.js';
+import { L as LinkComponent, a as NavigateFn, S as SearchParamsAdapter } from '../navigation-By1DrzaM.js';
 import 'react';
 
 /**

package/dist/router/tanstack-router.d.ts

@@ -1,4 +1,4 @@
-import { L as LinkComponent, a as NavigateFn, S as SearchParamsAdapter } from '../navigation-Bha0R3Fu.js';
+import { L as LinkComponent, a as NavigateFn, S as SearchParamsAdapter } from '../navigation-By1DrzaM.js';
 import 'react';
 
 /**

package/dist/router/tanstack-router.js

@@ -1,6 +1,6 @@
 "use client";
 import { isExternalHref, splitNavigationHref } from '../chunk-FUVWKTPL.js';
-import { DefaultLink } from '../chunk-WGMEVX3Y.js';
+import { DefaultLink } from '../chunk-KC43CNMA.js';
 import { useCallback, useMemo } from 'react';
 import { useRouter, useRouterState, useLinkProps } from '@tanstack/react-router';
 import { jsx } from 'react/jsx-runtime';

package/dist/{use-resource-table-Dx1OZRne.d.ts → use-resource-table-DrTkD5O1.d.ts}

@@ -12,7 +12,7 @@ import { b as Slots, a as SlotPropsFor } from './slots-tR0wf89f.js';
 import { ViewModeDefault } from './hooks/use-view-preference.js';
 import { ResourceUrlStateOptions } from './hooks/use-resource-url-state.js';
 import { FilterParam, SortParam } from '@marktiderman/genesis-core/provider';
-import { a as NavigateFn, S as SearchParamsAdapter } from './navigation-Bha0R3Fu.js';
+import { a as NavigateFn, S as SearchParamsAdapter } from './navigation-By1DrzaM.js';
 
 interface DataPageShellProps {
     /** Display title for the page */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marktiderman/genesis-ui",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "private": false,
   "type": "module",
   "sideEffects": false,
@@ -459,6 +459,7 @@
     "build": "tsup && node scripts/stamp-use-client.mjs && cp src/styles.css dist/styles.css && node ../../scripts/check-exports-resolve.mjs",
     "clean": "rm -rf dist",
     "check:exports": "node ../../scripts/check-exports-resolve.mjs",
-    "test": "vitest run"
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.type-tests.json"
   }
 }

package/dist/AppShell-BVr4V0UK.d.ts

@@ -1,174 +0,0 @@
-import * as React from 'react';
-import { ReactNode } from 'react';
-import { LucideIcon } from 'lucide-react';
-import { N as NavigationNode, L as LinkComponent } from './navigation-Bha0R3Fu.js';
-
-interface NavItem {
-    to: string;
-    icon: LucideIcon;
-    label: string;
-    /** Nested items — rendered as a collapsible group when the rail is expanded */
-    children?: NavItem[];
-    badge?: string | number;
-    disabled?: boolean;
-    /**
-     * Exact-match active state (e.g. overview `/`). Exact on the path only, so
-     * an `activePath` carrying `?search#hash` still matches.
-     */
-    end?: boolean;
-}
-/**
- * The "up" link AppShell renders above page content: a real link to the
- * logical parent, never `history.back()`.
- *
- * @stability Beta
- */
-interface ParentNavigation {
-    href: string;
-    label: string;
-}
-/**
- * Declarative chrome for AppShell — developer defaults + optional
- * in-sidebar user toggles (Notion/Linear “customize chrome” pattern).
- *
- * @stability Beta
- */
-interface AppShellOptions {
-    showLogo?: boolean;
-    showAppName?: boolean;
-    showThemeToggle?: boolean;
-    /** Desktop rail collapse control */
-    showCollapse?: boolean;
-    showUserSlot?: boolean;
-    showFooter?: boolean;
-    showSecondaryNav?: boolean;
-    /** Mobile fixed bottom tab bar */
-    showMobileBottomNav?: boolean;
-    defaultCollapsed?: boolean;
-    /**
-     * Show the in-sidebar Sidebar options popover so users can customize chrome.
-     * Default true when collapse / secondary / theme / slots are available.
-     */
-    configurable?: boolean;
-    /**
-     * Toggle keys the developer has decided on and users may not override —
-     * e.g. hiding `showThemeToggle` for a brand that manages theme elsewhere.
-     * Locked keys are dropped from the options popover and any stored user
-     * override for them is ignored on resolve.
-     */
-    lockedOptions?: (keyof AppShellOptions)[];
-    /** Comfortable (default) vs compact row padding */
-    density?: "comfortable" | "compact";
-    /** Expanded rail width in rem-ish tokens: narrow ≈ 13rem, wide ≈ 16rem */
-    railWidth?: "narrow" | "wide";
-    /**
-     * Where page content scrolls.
-     * - `container` (default): main panel scrolls — classic app-shell chrome.
-     * - `window`: document/window scrolls with a sticky rail so React Router
-     *   `ScrollRestoration` keeps working (dashboard dogfood).
-     */
-    scrollRoot?: "container" | "window";
-}
-/**
- * @stability Beta
- */
-interface AppShellProps {
-    /** App name shown in sidebar header */
-    appName: string;
-    /** App logo letter or short text (ignored when `logo` is set) */
-    appLogo?: string;
-    /** Custom logo node — preferred over `appLogo` letter tile */
-    logo?: ReactNode;
-    /**
-     * Primary navigation items. Optional when `navigation` is set: the tree
-     * root's `items` are the global nav then.
-     */
-    navItems?: NavItem[];
-    /**
-     * The app's logical navigation hierarchy. AppShell resolves it against
-     * `activePath` (see `resolveNavigation`) and derives:
-     * - the sidebar's global items from the root's `items` (unless `navItems`),
-     * - a contextual section from the current node's `items`, labelled with
-     *   the node's `label` (`$param` segments in `to` filled from the URL),
-     * - the mobile tab bar: the contextual items when there are any, else the
-     *   global top-level items (unless `mobileNavItems`),
-     * - a back link to the current node's logical parent (unless
-     *   `parentNavigation`).
-     *
-     * @stability Beta
-     */
-    navigation?: NavigationNode<NavItem>;
-    /**
-     * Back-to-parent link rendered in the content header, above `children`, on
-     * mobile and desktop. Derived from `navigation` when omitted; `null` hides
-     * it. Use this instead of placing a back row inside page content.
-     *
-     * @stability Beta
-     */
-    parentNavigation?: ParentNavigation | null;
-    /** Secondary nav (e.g. “More”) — rendered below a divider when shown */
-    secondaryNavItems?: NavItem[];
-    /** Label above secondary nav (default “More”) */
-    secondaryNavLabel?: string;
-    /**
-     * Items for the mobile bottom tab bar. Defaults to top-level `navItems`
-     * (no children). Pass a short list for apps with large sidebars; pass `[]`
-     * and set `options.showMobileBottomNav: false` to hide.
-     */
-    mobileNavItems?: NavItem[];
-    /** Slot below the logo row (product switcher, workspace picker, …) */
-    headerSlot?: ReactNode;
-    /**
-     * Compact slot shown in the **collapsed** desktop rail, where `headerSlot`
-     * is hidden for space. Use it to keep a core affordance reachable without
-     * expanding — e.g. an icon-only product switcher. Omit to hide the header
-     * region entirely while collapsed.
-     */
-    collapsedHeaderSlot?: ReactNode;
-    /** Footer region above the user slot (version, links) */
-    footer?: ReactNode;
-    /**
-     * User / account block at the bottom of the sidebar. When the rail is
-     * collapsed, AppShell hides any descendant carrying the
-     * `data-shell-user-detail` attribute (e.g. name/email text) so only a
-     * compact element (avatar, initial) remains — tag the detail wrapper you
-     * want hidden in the collapsed rail with that attribute.
-     */
-    userSlot?: ReactNode;
-    /** Page content */
-    children: ReactNode;
-    /**
-     * @deprecated Prefer `options.showThemeToggle`. Kept for sample-app
-     * back-compat; merges into resolved options when `options` omits it.
-     */
-    showThemeToggle?: boolean;
-    /** Chrome config (developer defaults + optional in-sidebar menu) */
-    options?: AppShellOptions;
-    /** Persist user sidebar-option overrides + collapse state (localStorage) */
-    optionsStorageKey?: string;
-    /** Controlled collapse (desktop rail) */
-    collapsed?: boolean;
-    onCollapsedChange?: (collapsed: boolean) => void;
-    /**
-     * Injectable link component. Defaults to a plain `<a>` (no router). Pass a
-     * router adapter — e.g. React Router `({ href, ...p }) => <Link to={href} {...p} />`
-     * or Next.js `next/link` — to get client-side navigation.
-     */
-    linkComponent?: LinkComponent;
-    /**
-     * Current location used to highlight the active nav item. Pass the full
-     * location, `pathname + search + hash` (React Router: `useLocation()`), so
-     * items whose `to` names a query or hash (`/admin?tab=users`) can become
-     * active. A pathname alone still works for path-only items, `end` included.
-     * Omit to disable active highlighting.
-     */
-    activePath?: string;
-    /**
-     * Optional custom active-state matcher. Defaults to a prefix match (with `/`
-     * treated as exact), mirroring React Router `NavLink`.
-     */
-    isActive?: (to: string, activePath?: string) => boolean;
-}
-declare function AppShell({ appName, appLogo, logo, navItems: navItemsProp, navigation, parentNavigation: parentNavigationProp, secondaryNavItems, secondaryNavLabel, mobileNavItems, headerSlot, collapsedHeaderSlot, footer, userSlot, children, showThemeToggle: showThemeToggleProp, options: optionsProp, optionsStorageKey, collapsed: collapsedProp, onCollapsedChange, linkComponent, activePath, isActive, }: AppShellProps): React.JSX.Element;
-
-export { AppShell as A, type NavItem as N, type ParentNavigation as P, type AppShellOptions as a, type AppShellProps as b };