@texturehq/edges 1.36.1 → 1.37.0

package/dist/{colors-DlH6URGg.d.cts → colors-CIEgeqF8.d.cts}

@@ -459,6 +459,217 @@ type SideNavProps = {
  */
 declare const SideNav: React$1.FC<SideNavProps>;
 
+/**
+ * StackNav — Sliding-pane navigation rail with unbounded depth.
+ *
+ * Each item can carry `children` of the same shape. Selecting an item that has
+ * children pushes a new pane onto the navigation stack (sliding the rail one
+ * level deeper); a back affordance pops the top pane. Items that have an
+ * `href` (and no `children`) behave as leaves and call `onSelect` when clicked.
+ *
+ * The metaphor is a navigation stack — like a UIKit `UINavigationController`
+ * but living inside a sidebar. Nesting is recursive: any pane can drill into
+ * the next, so the same shape composes from one level deep to N levels deep
+ * with no code changes.
+ *
+ * @example
+ * ```tsx
+ * const items: StackNavItem[] = [
+ *   { id: "home", label: "Home", href: "/" },
+ *   {
+ *     id: "components",
+ *     label: "Components",
+ *     href: "/components",
+ *     children: [
+ *       { id: "button", label: "Button", href: "/components/button" },
+ *       {
+ *         id: "data",
+ *         label: "Data",
+ *         children: [
+ *           { id: "table", label: "Table", href: "/components/data/table" },
+ *         ],
+ *       },
+ *     ],
+ *   },
+ * ];
+ *
+ * <StackNav items={items} value="/components/button" />
+ * ```
+ */
+type StackNavItem = {
+    /** Stable identifier. Required for groups; for leaves defaults to `href`. */
+    id: string;
+    /** Display label. */
+    label: string;
+    /**
+     * Target URL for leaves. When omitted (or when `children` is non-empty and
+     * `pushOnSelect` is false), the row acts as a "drill-in" affordance only.
+     *
+     * If both `href` and `children` are present, clicking the row both navigates
+     * to `href` (a section overview) and pushes its sub-pane onto the stack.
+     * This mirrors the Vercel/Linear/Edges dashboard pattern.
+     */
+    href?: string;
+    /** Optional leading-edge icon. Alias-friendly for item models shared with SideNav. */
+    icon?: React$1.ReactNode;
+    /** Optional trailing-edge content (badge, count, kbd hint, etc.). */
+    trailing?: React$1.ReactNode;
+    /** Optional leading-edge content. Overrides `icon` when both are provided. */
+    leading?: React$1.ReactNode;
+    /** Marks the leaf as a divider — purely visual, not focusable. */
+    divider?: boolean;
+    /** Renders the entry as an uppercase group label rather than a row. */
+    groupLabel?: boolean;
+    /** Nested children. Triggers the drill-in arrow and pushes a new pane. */
+    children?: StackNavItem[];
+    /**
+     * When `false` and the row has `children`, selecting the row only navigates
+     * to `href` (if present) — it does not push a sub-pane. Useful for
+     * "Overview" leaves that live in the same array as their siblings. Defaults
+     * to `true`.
+     */
+    pushOnSelect?: boolean;
+    /** Aria-label override for screen readers. */
+    ariaLabel?: string;
+};
+type StackNavLinkComponentProps = {
+    href: string;
+    "aria-label"?: string;
+    className?: string;
+    children?: React$1.ReactNode;
+    "aria-current"?: "page" | undefined;
+    onClick?: (event: React$1.MouseEvent<HTMLAnchorElement>) => void;
+};
+/**
+ * Color overrides for the rail surface and row affordances. Any value accepted
+ * by CSS (`#hex`, `rgb()`, `var(--token)`, etc.) is fine; each entry maps to a
+ * CSS custom property on the rail container, so consumers can also override
+ * the same variables in CSS instead of via props. See `Theming` below.
+ */
+type StackNavTheme = {
+    /** Rail container background. Defaults to `var(--color-background-surface)`. */
+    background?: string;
+    /** Active row background. Defaults to `var(--color-background-selected)`. */
+    activeBackground?: string;
+    /** Active row text color. Defaults to `var(--color-text-primary)`. */
+    activeColor?: string;
+    /** Hover row background. Defaults to `var(--color-background-hover)`. */
+    hoverBackground?: string;
+    /** Border color (rail border, header/footer separators, dividers). Defaults to `var(--color-border-default)`. */
+    borderColor?: string;
+};
+type StackNavProps = {
+    /** Root pane items. Each item can recurse with `children`. */
+    items: StackNavItem[];
+    /**
+     * Additional L1 items pinned to the bottom of the root pane. Behave identically
+     * to `items` — leaves navigate, parents push a sub-pane on click, deep-links
+     * via `value` open them. Use for "tool" sections that sit at the same level
+     * as the primary IA but visually belong at the bottom (e.g., Settings,
+     * Help, Inspector). A subtle border separates them from `items`.
+     *
+     * **Constraint:** L1 `id` and `href` values must be unique across `items` and
+     * `bottomItems`. Stack tokens and `value` lookups use these as keys, so a
+     * collision causes the wrong entry to resolve. Dev builds log a warning when
+     * a duplicate is detected.
+     */
+    bottomItems?: StackNavItem[];
+    /**
+     * Active leaf identifier (matched against `href` or `id`). When set, the
+     * StackNav auto-opens the path that contains it on first render and again
+     * whenever `value` changes externally.
+     */
+    value?: string | null;
+    /**
+     * Initial open stack (array of ids from root to deepest pane). Ignored
+     * after first render — for ongoing control use `stack` + `onStackChange`.
+     */
+    defaultStack?: string[];
+    /**
+     * Fully-controlled open stack. When provided, the component does not manage
+     * its own pane state.
+     */
+    stack?: string[];
+    /** Fires when the open pane stack changes (drill-in / back). */
+    onStackChange?: (stack: string[]) => void;
+    /**
+     * Fires when a leaf row is clicked (after `href` is followed). Receives the
+     * full item plus its ancestor breadcrumb. Use this to track activation
+     * outside of router-driven flows.
+     */
+    onSelect?: (item: StackNavItem, breadcrumb: StackNavItem[]) => void;
+    /**
+     * Custom anchor component (Next.js `Link`, react-router `Link`, etc.).
+     * Receives `href`, `className`, `aria-current`, `onClick`, and `children`.
+     * Defaults to a native `<a>`.
+     */
+    linkComponent?: React$1.ComponentType<StackNavLinkComponentProps>;
+    /**
+     * Render the Texture logo at the top of the rail (above any `header` slot).
+     * Set `logo` to override the default mark; otherwise the standard `<Logo />`
+     * with wordmark is rendered. Defaults to `false` for backward compatibility —
+     * existing consumers that already place a logo inside `header` keep working
+     * unchanged.
+     */
+    showLogo?: boolean;
+    /**
+     * Custom logo node rendered in the logo region when `showLogo` is true.
+     * Ignored when `showLogo` is false. Use this to swap in a co-branded mark
+     * (e.g. partner logo) without losing the standard logo layout/spacing.
+     */
+    logo?: React$1.ReactNode;
+    /** Fixed top region (search trigger, breadcrumb, theme toggle). Rendered below the logo when both are present. */
+    header?: React$1.ReactNode;
+    /** Fixed bottom region (theme toggle, account menu). */
+    footer?: React$1.ReactNode;
+    /** Title shown above the root pane (optional — usually folded into header). */
+    rootLabel?: string;
+    /**
+     * Whether the rail itself should size itself to the viewport and stick.
+     * Defaults to `true`. Disable for embedded / non-fullheight contexts.
+     */
+    sticky?: boolean;
+    /**
+     * Width of the rail in pixels. Defaults to 260. Pass `null` to skip the
+     * inline width style entirely (useful when an ancestor like AppShell controls
+     * width via Tailwind classes).
+     */
+    width?: number | null;
+    /** Aria-label for the rail's `<aside>`. Defaults to "Navigation". */
+    ariaLabel?: string;
+    /**
+     * Per-instance color overrides for the rail surface and row affordances.
+     * Each key maps to a CSS custom property (see {@link StackNavTheme}).
+     * Anything left unset falls back to the corresponding `--edges-stack-nav-*`
+     * variable on the rail, which itself defaults to a neutral Edges token.
+     */
+    theme?: StackNavTheme;
+    /**
+     * Enables the subtle pane slide/fade transition when drilling in or popping
+     * back. Defaults to `true`; set `false` for tests, perf-sensitive embedded
+     * contexts, or users/surfaces that need instant pane swaps.
+     */
+    animated?: boolean;
+    /** Inline style passthrough on the rail container (merged with theme vars). */
+    style?: React$1.CSSProperties;
+    /** Extra classes appended to the rail container. */
+    className?: string;
+    /**
+     * ID of AppShell's mobile-menu checkbox. When provided, the logo region
+     * renders a mobile close-button that toggles this checkbox via `htmlFor`.
+     * Usually wired automatically by AppShell — consumers using StackNav
+     * standalone can leave this unset.
+     */
+    mobileMenuId?: string;
+    /**
+     * ID of AppShell's sidebar-collapse checkbox. When provided, the logo region
+     * renders a desktop collapse toggle that targets this checkbox via `htmlFor`,
+     * and rows emit `data-collapse-*` attributes so AppShell's CSS rules apply.
+     */
+    sidebarCollapseId?: string;
+};
+declare function StackNav({ items, bottomItems, value, defaultStack, stack: controlledStack, onStackChange, onSelect, linkComponent: LinkComponent, showLogo, logo, header, footer, mobileMenuId, sidebarCollapseId, rootLabel, sticky, width, ariaLabel, theme, animated, style, className, }: StackNavProps): react_jsx_runtime.JSX.Element;
+
 type ColorMode = "system" | "light" | "dark";
 type TopNavProps = {
     /**
@@ -491,8 +702,15 @@ declare const TopNav: React$1.FC<TopNavProps>;
 
 /** Layout options for the AppShell */
 type AppShellProps = {
-    /** Structured nav for the left rail */
-    sideNav: Omit<SideNavProps, "mobileMenuId" | "sidebarCollapseId">;
+    /**
+     * Structured nav for the left rail. Use one of `sideNav` or `stackNav`.
+     * When both are provided, `stackNav` takes precedence and `sideNav` is ignored.
+     */
+    sideNav?: Omit<SideNavProps, "mobileMenuId" | "sidebarCollapseId">;
+    /**
+     * Use the StackNav primitive in the left rail instead of SideNav.
+     */
+    stackNav?: Omit<StackNavProps, "mobileMenuId" | "sidebarCollapseId">;
     /** Optional top bar slots & options */
     topNav?: Pick<TopNavProps, "rightContent" | "centerContent" | "showMobileMenu" | "avatar" | "showColorModeSwitcher" | "toggleTheme" | "isDarkThemeEnabled" | "colorMode" | "actions" | "className">;
     /** Main page content */
@@ -505,12 +723,7 @@ type AppShellProps = {
     /** Optional: Enable JavaScript progressive enhancements */
     enableJsEnhancements?: boolean;
 };
-/**
- * Isomorphic AppShell component that works as both server and client component
- * Uses CSS-only interactions by default for full SSR compatibility
- * Can be progressively enhanced with JavaScript when enableJsEnhancements is true
- */
-declare function AppShell({ sideNav, topNav, children, contentPaddingX, contentPaddingY, showSidebarBorder, mainClassName, enableJsEnhancements, }: AppShellProps): react_jsx_runtime.JSX.Element;
+declare function AppShell({ sideNav, stackNav, topNav, children, contentPaddingX, contentPaddingY, showSidebarBorder, mainClassName, enableJsEnhancements, }: AppShellProps): react_jsx_runtime.JSX.Element;
 
 interface AvatarProps {
     /**
@@ -1706,6 +1919,13 @@ interface SegmentedControlProps {
      * @default "subtle"
      */
     variant?: SegmentedControlVariant | LegacySegmentedControlVariant;
+    /**
+     * When true, segments render only their icon — labels become sr-only and
+     * still drive `aria-label` for assistive tech. Each option must provide an
+     * `icon`; options without one fall back to showing the label.
+     * @default false
+     */
+    iconOnly?: boolean;
 }
 /**
  * SegmentedControl
@@ -1713,7 +1933,7 @@ interface SegmentedControlProps {
  * A segmented control component for selecting between multiple options.
  * Similar to a radio group but with a more compact, button-like appearance.
  */
-declare function SegmentedControl({ options, value, onChange, size, className, isDisabled, variant, "aria-label": ariaLabel, }: SegmentedControlProps): react_jsx_runtime.JSX.Element;
+declare function SegmentedControl({ options, value, onChange, size, className, isDisabled, variant, iconOnly, "aria-label": ariaLabel, }: SegmentedControlProps): react_jsx_runtime.JSX.Element;
 
 type TextLinkVariant = "primary" | "secondary" | "muted" | "unstyled";
 type LegacyTextLinkVariant = "default" | "brand";
@@ -1985,4 +2205,4 @@ declare const isLightColor: (color: string) => boolean;
  */
 declare const getContrastingTextColor: (backgroundColor: string) => string;
 
-export { type DistanceFormat as $, type ActionItem as A, type BadgeProps as B, type ChartMargin as C, defaultMargin as D, ENTITY_CONFIG as E, getContrastingTextColor as F, getDefaultChartColor as G, Heading as H, type InteractiveMapProps as I, getDefaultColors as J, getEntityConfig as K, Loader as L, type MapPoint as M, getEntityIcon as N, getEntityLabel as O, getResolvedColor as P, getThemeCategoricalColors as Q, getYFormatSettings as R, type SegmentOption as S, TextLink as T, isLightColor as U, type FieldValue as V, type BooleanFormat as W, type FormattedValue as X, type YFormatSettings as Y, type CurrentFormat as Z, type DateFormat as _, type ActionMenuProps as a, type EnergyFormat as a0, type CurrencyFormat as a1, type NumberFormat as a2, type PhoneFormat as a3, type PowerFormat as a4, type FormatterFunction as a5, type ResistanceFormat as a6, type TemperatureFormat as a7, type TemperatureUnitString as a8, type TemperatureUnit as a9, InteractiveMap as aA, type LayerFeature as aB, type LayerStyle as aC, MAP_TYPES as aD, type MapType as aE, Meter as aF, type MetricFormat as aG, type PercentageFormat as aH, type PowerUnit as aI, type RenderType as aJ, type ResistanceUnit as aK, SegmentedControl as aL, StaticMap as aM, type TextTransform as aN, type TextTruncatePosition as aO, type VoltageUnit as aP, type ZoomStops as aQ, activeDeviceStates as aR, deviceStateLabels as aS, deviceStateMetricFormats as aT, formatComponentValue as aU, getDeviceStateLabel as aV, getGridStateLabel as aW, gridStateLabels as aX, isActiveState as aY, useChartContext as aZ, useComponentFormatter as a_, type TextFormat as aa, type VoltageFormat as ab, type FieldFormat as ac, type DeviceState as ad, type GridState as ae, type ComponentFormatter as af, type LayerSpec as ag, type CustomPinsSpec as ah, type GeoJsonLayerSpec as ai, type RasterLayerSpec as aj, type VectorLayerSpec as ak, type ClusteredVectorLayerSpec as al, ActionMenu as am, Avatar as an, Badge as ao, type BaseFormat as ap, ChartContext as aq, CodeEditor as ar, type ColorSpec as as, type ComponentFormatOptions as at, type CurrentUnit as au, type CustomFormat as av, DEFAULT_MAP_TYPE as aw, type DateFormatStyle as ax, type DistanceUnit as ay, type EnergyUnit as az, AppShell as b, type AppShellProps as c, type AvatarProps as d, type BaseDataPoint as e, type CodeEditorProps as f, type CodeLanguage as g, type CodeTheme as h, type EntityConfig as i, type EntityType as j, Logo as k, type MeterProps as l, type SegmentedControlProps as m, SideNav as n, type SideNavItem as o, type SideNavProps as p, type StaticMapProps as q, type TooltipData as r, type TooltipSeries as s, TopNav as t, type TopNavProps as u, type YFormatType as v, clearColorCache as w, createCategoryColorMap as x, createXScale as y, createYScale as z };
+export { type EnergyFormat as $, type ActionItem as A, type BadgeProps as B, type ChartMargin as C, getContrastingTextColor as D, ENTITY_CONFIG as E, getDefaultChartColor as F, getDefaultColors as G, Heading as H, type InteractiveMapProps as I, getEntityConfig as J, getEntityIcon as K, Loader as L, type MapPoint as M, getEntityLabel as N, getResolvedColor as O, getThemeCategoricalColors as P, getYFormatSettings as Q, isLightColor as R, type SegmentOption as S, TextLink as T, type FieldValue as U, type BooleanFormat as V, type FormattedValue as W, type CurrentFormat as X, type YFormatSettings as Y, type DateFormat as Z, type DistanceFormat as _, type ActionMenuProps as a, getGridStateLabel as a$, type CurrencyFormat as a0, type NumberFormat as a1, type PhoneFormat as a2, type PowerFormat as a3, type FormatterFunction as a4, type ResistanceFormat as a5, type TemperatureFormat as a6, type TemperatureUnitString as a7, type TemperatureUnit as a8, type TextFormat as a9, InteractiveMap as aA, type LayerFeature as aB, type LayerStyle as aC, MAP_TYPES as aD, type MapType as aE, Meter as aF, type MetricFormat as aG, type PercentageFormat as aH, type PowerUnit as aI, type RenderType as aJ, type ResistanceUnit as aK, SegmentedControl as aL, StackNav as aM, type StackNavItem as aN, type StackNavLinkComponentProps as aO, type StackNavProps as aP, type StackNavTheme as aQ, StaticMap as aR, type TextTransform as aS, type TextTruncatePosition as aT, type VoltageUnit as aU, type ZoomStops as aV, activeDeviceStates as aW, deviceStateLabels as aX, deviceStateMetricFormats as aY, formatComponentValue as aZ, getDeviceStateLabel as a_, type VoltageFormat as aa, type FieldFormat as ab, type DeviceState as ac, type GridState as ad, type ComponentFormatter as ae, type LayerSpec as af, type CustomPinsSpec as ag, type GeoJsonLayerSpec as ah, type RasterLayerSpec as ai, type VectorLayerSpec as aj, type ClusteredVectorLayerSpec as ak, ActionMenu as al, AppShell as am, Avatar as an, Badge as ao, type BaseFormat as ap, ChartContext as aq, CodeEditor as ar, type ColorSpec as as, type ComponentFormatOptions as at, type CurrentUnit as au, type CustomFormat as av, DEFAULT_MAP_TYPE as aw, type DateFormatStyle as ax, type DistanceUnit as ay, type EnergyUnit as az, type AppShellProps as b, gridStateLabels as b0, isActiveState as b1, useChartContext as b2, useComponentFormatter as b3, type AvatarProps as c, type BaseDataPoint as d, type CodeEditorProps as e, type CodeLanguage as f, type CodeTheme as g, type EntityConfig as h, type EntityType as i, Logo as j, type MeterProps as k, type SegmentedControlProps as l, SideNav as m, type SideNavItem as n, type SideNavProps as o, type StaticMapProps as p, type TooltipData as q, type TooltipSeries as r, TopNav as s, type TopNavProps as t, type YFormatType as u, clearColorCache as v, createCategoryColorMap as w, createXScale as x, createYScale as y, defaultMargin as z };

package/dist/{colors-Dq4EZi3c.d.ts → colors-CQJMI7Wz.d.ts}

@@ -459,6 +459,217 @@ type SideNavProps = {
  */
 declare const SideNav: React$1.FC<SideNavProps>;
 
+/**
+ * StackNav — Sliding-pane navigation rail with unbounded depth.
+ *
+ * Each item can carry `children` of the same shape. Selecting an item that has
+ * children pushes a new pane onto the navigation stack (sliding the rail one
+ * level deeper); a back affordance pops the top pane. Items that have an
+ * `href` (and no `children`) behave as leaves and call `onSelect` when clicked.
+ *
+ * The metaphor is a navigation stack — like a UIKit `UINavigationController`
+ * but living inside a sidebar. Nesting is recursive: any pane can drill into
+ * the next, so the same shape composes from one level deep to N levels deep
+ * with no code changes.
+ *
+ * @example
+ * ```tsx
+ * const items: StackNavItem[] = [
+ *   { id: "home", label: "Home", href: "/" },
+ *   {
+ *     id: "components",
+ *     label: "Components",
+ *     href: "/components",
+ *     children: [
+ *       { id: "button", label: "Button", href: "/components/button" },
+ *       {
+ *         id: "data",
+ *         label: "Data",
+ *         children: [
+ *           { id: "table", label: "Table", href: "/components/data/table" },
+ *         ],
+ *       },
+ *     ],
+ *   },
+ * ];
+ *
+ * <StackNav items={items} value="/components/button" />
+ * ```
+ */
+type StackNavItem = {
+    /** Stable identifier. Required for groups; for leaves defaults to `href`. */
+    id: string;
+    /** Display label. */
+    label: string;
+    /**
+     * Target URL for leaves. When omitted (or when `children` is non-empty and
+     * `pushOnSelect` is false), the row acts as a "drill-in" affordance only.
+     *
+     * If both `href` and `children` are present, clicking the row both navigates
+     * to `href` (a section overview) and pushes its sub-pane onto the stack.
+     * This mirrors the Vercel/Linear/Edges dashboard pattern.
+     */
+    href?: string;
+    /** Optional leading-edge icon. Alias-friendly for item models shared with SideNav. */
+    icon?: React$1.ReactNode;
+    /** Optional trailing-edge content (badge, count, kbd hint, etc.). */
+    trailing?: React$1.ReactNode;
+    /** Optional leading-edge content. Overrides `icon` when both are provided. */
+    leading?: React$1.ReactNode;
+    /** Marks the leaf as a divider — purely visual, not focusable. */
+    divider?: boolean;
+    /** Renders the entry as an uppercase group label rather than a row. */
+    groupLabel?: boolean;
+    /** Nested children. Triggers the drill-in arrow and pushes a new pane. */
+    children?: StackNavItem[];
+    /**
+     * When `false` and the row has `children`, selecting the row only navigates
+     * to `href` (if present) — it does not push a sub-pane. Useful for
+     * "Overview" leaves that live in the same array as their siblings. Defaults
+     * to `true`.
+     */
+    pushOnSelect?: boolean;
+    /** Aria-label override for screen readers. */
+    ariaLabel?: string;
+};
+type StackNavLinkComponentProps = {
+    href: string;
+    "aria-label"?: string;
+    className?: string;
+    children?: React$1.ReactNode;
+    "aria-current"?: "page" | undefined;
+    onClick?: (event: React$1.MouseEvent<HTMLAnchorElement>) => void;
+};
+/**
+ * Color overrides for the rail surface and row affordances. Any value accepted
+ * by CSS (`#hex`, `rgb()`, `var(--token)`, etc.) is fine; each entry maps to a
+ * CSS custom property on the rail container, so consumers can also override
+ * the same variables in CSS instead of via props. See `Theming` below.
+ */
+type StackNavTheme = {
+    /** Rail container background. Defaults to `var(--color-background-surface)`. */
+    background?: string;
+    /** Active row background. Defaults to `var(--color-background-selected)`. */
+    activeBackground?: string;
+    /** Active row text color. Defaults to `var(--color-text-primary)`. */
+    activeColor?: string;
+    /** Hover row background. Defaults to `var(--color-background-hover)`. */
+    hoverBackground?: string;
+    /** Border color (rail border, header/footer separators, dividers). Defaults to `var(--color-border-default)`. */
+    borderColor?: string;
+};
+type StackNavProps = {
+    /** Root pane items. Each item can recurse with `children`. */
+    items: StackNavItem[];
+    /**
+     * Additional L1 items pinned to the bottom of the root pane. Behave identically
+     * to `items` — leaves navigate, parents push a sub-pane on click, deep-links
+     * via `value` open them. Use for "tool" sections that sit at the same level
+     * as the primary IA but visually belong at the bottom (e.g., Settings,
+     * Help, Inspector). A subtle border separates them from `items`.
+     *
+     * **Constraint:** L1 `id` and `href` values must be unique across `items` and
+     * `bottomItems`. Stack tokens and `value` lookups use these as keys, so a
+     * collision causes the wrong entry to resolve. Dev builds log a warning when
+     * a duplicate is detected.
+     */
+    bottomItems?: StackNavItem[];
+    /**
+     * Active leaf identifier (matched against `href` or `id`). When set, the
+     * StackNav auto-opens the path that contains it on first render and again
+     * whenever `value` changes externally.
+     */
+    value?: string | null;
+    /**
+     * Initial open stack (array of ids from root to deepest pane). Ignored
+     * after first render — for ongoing control use `stack` + `onStackChange`.
+     */
+    defaultStack?: string[];
+    /**
+     * Fully-controlled open stack. When provided, the component does not manage
+     * its own pane state.
+     */
+    stack?: string[];
+    /** Fires when the open pane stack changes (drill-in / back). */
+    onStackChange?: (stack: string[]) => void;
+    /**
+     * Fires when a leaf row is clicked (after `href` is followed). Receives the
+     * full item plus its ancestor breadcrumb. Use this to track activation
+     * outside of router-driven flows.
+     */
+    onSelect?: (item: StackNavItem, breadcrumb: StackNavItem[]) => void;
+    /**
+     * Custom anchor component (Next.js `Link`, react-router `Link`, etc.).
+     * Receives `href`, `className`, `aria-current`, `onClick`, and `children`.
+     * Defaults to a native `<a>`.
+     */
+    linkComponent?: React$1.ComponentType<StackNavLinkComponentProps>;
+    /**
+     * Render the Texture logo at the top of the rail (above any `header` slot).
+     * Set `logo` to override the default mark; otherwise the standard `<Logo />`
+     * with wordmark is rendered. Defaults to `false` for backward compatibility —
+     * existing consumers that already place a logo inside `header` keep working
+     * unchanged.
+     */
+    showLogo?: boolean;
+    /**
+     * Custom logo node rendered in the logo region when `showLogo` is true.
+     * Ignored when `showLogo` is false. Use this to swap in a co-branded mark
+     * (e.g. partner logo) without losing the standard logo layout/spacing.
+     */
+    logo?: React$1.ReactNode;
+    /** Fixed top region (search trigger, breadcrumb, theme toggle). Rendered below the logo when both are present. */
+    header?: React$1.ReactNode;
+    /** Fixed bottom region (theme toggle, account menu). */
+    footer?: React$1.ReactNode;
+    /** Title shown above the root pane (optional — usually folded into header). */
+    rootLabel?: string;
+    /**
+     * Whether the rail itself should size itself to the viewport and stick.
+     * Defaults to `true`. Disable for embedded / non-fullheight contexts.
+     */
+    sticky?: boolean;
+    /**
+     * Width of the rail in pixels. Defaults to 260. Pass `null` to skip the
+     * inline width style entirely (useful when an ancestor like AppShell controls
+     * width via Tailwind classes).
+     */
+    width?: number | null;
+    /** Aria-label for the rail's `<aside>`. Defaults to "Navigation". */
+    ariaLabel?: string;
+    /**
+     * Per-instance color overrides for the rail surface and row affordances.
+     * Each key maps to a CSS custom property (see {@link StackNavTheme}).
+     * Anything left unset falls back to the corresponding `--edges-stack-nav-*`
+     * variable on the rail, which itself defaults to a neutral Edges token.
+     */
+    theme?: StackNavTheme;
+    /**
+     * Enables the subtle pane slide/fade transition when drilling in or popping
+     * back. Defaults to `true`; set `false` for tests, perf-sensitive embedded
+     * contexts, or users/surfaces that need instant pane swaps.
+     */
+    animated?: boolean;
+    /** Inline style passthrough on the rail container (merged with theme vars). */
+    style?: React$1.CSSProperties;
+    /** Extra classes appended to the rail container. */
+    className?: string;
+    /**
+     * ID of AppShell's mobile-menu checkbox. When provided, the logo region
+     * renders a mobile close-button that toggles this checkbox via `htmlFor`.
+     * Usually wired automatically by AppShell — consumers using StackNav
+     * standalone can leave this unset.
+     */
+    mobileMenuId?: string;
+    /**
+     * ID of AppShell's sidebar-collapse checkbox. When provided, the logo region
+     * renders a desktop collapse toggle that targets this checkbox via `htmlFor`,
+     * and rows emit `data-collapse-*` attributes so AppShell's CSS rules apply.
+     */
+    sidebarCollapseId?: string;
+};
+declare function StackNav({ items, bottomItems, value, defaultStack, stack: controlledStack, onStackChange, onSelect, linkComponent: LinkComponent, showLogo, logo, header, footer, mobileMenuId, sidebarCollapseId, rootLabel, sticky, width, ariaLabel, theme, animated, style, className, }: StackNavProps): react_jsx_runtime.JSX.Element;
+
 type ColorMode = "system" | "light" | "dark";
 type TopNavProps = {
     /**
@@ -491,8 +702,15 @@ declare const TopNav: React$1.FC<TopNavProps>;
 
 /** Layout options for the AppShell */
 type AppShellProps = {
-    /** Structured nav for the left rail */
-    sideNav: Omit<SideNavProps, "mobileMenuId" | "sidebarCollapseId">;
+    /**
+     * Structured nav for the left rail. Use one of `sideNav` or `stackNav`.
+     * When both are provided, `stackNav` takes precedence and `sideNav` is ignored.
+     */
+    sideNav?: Omit<SideNavProps, "mobileMenuId" | "sidebarCollapseId">;
+    /**
+     * Use the StackNav primitive in the left rail instead of SideNav.
+     */
+    stackNav?: Omit<StackNavProps, "mobileMenuId" | "sidebarCollapseId">;
     /** Optional top bar slots & options */
     topNav?: Pick<TopNavProps, "rightContent" | "centerContent" | "showMobileMenu" | "avatar" | "showColorModeSwitcher" | "toggleTheme" | "isDarkThemeEnabled" | "colorMode" | "actions" | "className">;
     /** Main page content */
@@ -505,12 +723,7 @@ type AppShellProps = {
     /** Optional: Enable JavaScript progressive enhancements */
     enableJsEnhancements?: boolean;
 };
-/**
- * Isomorphic AppShell component that works as both server and client component
- * Uses CSS-only interactions by default for full SSR compatibility
- * Can be progressively enhanced with JavaScript when enableJsEnhancements is true
- */
-declare function AppShell({ sideNav, topNav, children, contentPaddingX, contentPaddingY, showSidebarBorder, mainClassName, enableJsEnhancements, }: AppShellProps): react_jsx_runtime.JSX.Element;
+declare function AppShell({ sideNav, stackNav, topNav, children, contentPaddingX, contentPaddingY, showSidebarBorder, mainClassName, enableJsEnhancements, }: AppShellProps): react_jsx_runtime.JSX.Element;
 
 interface AvatarProps {
     /**
@@ -1706,6 +1919,13 @@ interface SegmentedControlProps {
      * @default "subtle"
      */
     variant?: SegmentedControlVariant | LegacySegmentedControlVariant;
+    /**
+     * When true, segments render only their icon — labels become sr-only and
+     * still drive `aria-label` for assistive tech. Each option must provide an
+     * `icon`; options without one fall back to showing the label.
+     * @default false
+     */
+    iconOnly?: boolean;
 }
 /**
  * SegmentedControl
@@ -1713,7 +1933,7 @@ interface SegmentedControlProps {
  * A segmented control component for selecting between multiple options.
  * Similar to a radio group but with a more compact, button-like appearance.
  */
-declare function SegmentedControl({ options, value, onChange, size, className, isDisabled, variant, "aria-label": ariaLabel, }: SegmentedControlProps): react_jsx_runtime.JSX.Element;
+declare function SegmentedControl({ options, value, onChange, size, className, isDisabled, variant, iconOnly, "aria-label": ariaLabel, }: SegmentedControlProps): react_jsx_runtime.JSX.Element;
 
 type TextLinkVariant = "primary" | "secondary" | "muted" | "unstyled";
 type LegacyTextLinkVariant = "default" | "brand";
@@ -1985,4 +2205,4 @@ declare const isLightColor: (color: string) => boolean;
  */
 declare const getContrastingTextColor: (backgroundColor: string) => string;
 
-export { type DistanceFormat as $, type ActionItem as A, type BadgeProps as B, type ChartMargin as C, defaultMargin as D, ENTITY_CONFIG as E, getContrastingTextColor as F, getDefaultChartColor as G, Heading as H, type InteractiveMapProps as I, getDefaultColors as J, getEntityConfig as K, Loader as L, type MapPoint as M, getEntityIcon as N, getEntityLabel as O, getResolvedColor as P, getThemeCategoricalColors as Q, getYFormatSettings as R, type SegmentOption as S, TextLink as T, isLightColor as U, type FieldValue as V, type BooleanFormat as W, type FormattedValue as X, type YFormatSettings as Y, type CurrentFormat as Z, type DateFormat as _, type ActionMenuProps as a, type EnergyFormat as a0, type CurrencyFormat as a1, type NumberFormat as a2, type PhoneFormat as a3, type PowerFormat as a4, type FormatterFunction as a5, type ResistanceFormat as a6, type TemperatureFormat as a7, type TemperatureUnitString as a8, type TemperatureUnit as a9, InteractiveMap as aA, type LayerFeature as aB, type LayerStyle as aC, MAP_TYPES as aD, type MapType as aE, Meter as aF, type MetricFormat as aG, type PercentageFormat as aH, type PowerUnit as aI, type RenderType as aJ, type ResistanceUnit as aK, SegmentedControl as aL, StaticMap as aM, type TextTransform as aN, type TextTruncatePosition as aO, type VoltageUnit as aP, type ZoomStops as aQ, activeDeviceStates as aR, deviceStateLabels as aS, deviceStateMetricFormats as aT, formatComponentValue as aU, getDeviceStateLabel as aV, getGridStateLabel as aW, gridStateLabels as aX, isActiveState as aY, useChartContext as aZ, useComponentFormatter as a_, type TextFormat as aa, type VoltageFormat as ab, type FieldFormat as ac, type DeviceState as ad, type GridState as ae, type ComponentFormatter as af, type LayerSpec as ag, type CustomPinsSpec as ah, type GeoJsonLayerSpec as ai, type RasterLayerSpec as aj, type VectorLayerSpec as ak, type ClusteredVectorLayerSpec as al, ActionMenu as am, Avatar as an, Badge as ao, type BaseFormat as ap, ChartContext as aq, CodeEditor as ar, type ColorSpec as as, type ComponentFormatOptions as at, type CurrentUnit as au, type CustomFormat as av, DEFAULT_MAP_TYPE as aw, type DateFormatStyle as ax, type DistanceUnit as ay, type EnergyUnit as az, AppShell as b, type AppShellProps as c, type AvatarProps as d, type BaseDataPoint as e, type CodeEditorProps as f, type CodeLanguage as g, type CodeTheme as h, type EntityConfig as i, type EntityType as j, Logo as k, type MeterProps as l, type SegmentedControlProps as m, SideNav as n, type SideNavItem as o, type SideNavProps as p, type StaticMapProps as q, type TooltipData as r, type TooltipSeries as s, TopNav as t, type TopNavProps as u, type YFormatType as v, clearColorCache as w, createCategoryColorMap as x, createXScale as y, createYScale as z };
+export { type EnergyFormat as $, type ActionItem as A, type BadgeProps as B, type ChartMargin as C, getContrastingTextColor as D, ENTITY_CONFIG as E, getDefaultChartColor as F, getDefaultColors as G, Heading as H, type InteractiveMapProps as I, getEntityConfig as J, getEntityIcon as K, Loader as L, type MapPoint as M, getEntityLabel as N, getResolvedColor as O, getThemeCategoricalColors as P, getYFormatSettings as Q, isLightColor as R, type SegmentOption as S, TextLink as T, type FieldValue as U, type BooleanFormat as V, type FormattedValue as W, type CurrentFormat as X, type YFormatSettings as Y, type DateFormat as Z, type DistanceFormat as _, type ActionMenuProps as a, getGridStateLabel as a$, type CurrencyFormat as a0, type NumberFormat as a1, type PhoneFormat as a2, type PowerFormat as a3, type FormatterFunction as a4, type ResistanceFormat as a5, type TemperatureFormat as a6, type TemperatureUnitString as a7, type TemperatureUnit as a8, type TextFormat as a9, InteractiveMap as aA, type LayerFeature as aB, type LayerStyle as aC, MAP_TYPES as aD, type MapType as aE, Meter as aF, type MetricFormat as aG, type PercentageFormat as aH, type PowerUnit as aI, type RenderType as aJ, type ResistanceUnit as aK, SegmentedControl as aL, StackNav as aM, type StackNavItem as aN, type StackNavLinkComponentProps as aO, type StackNavProps as aP, type StackNavTheme as aQ, StaticMap as aR, type TextTransform as aS, type TextTruncatePosition as aT, type VoltageUnit as aU, type ZoomStops as aV, activeDeviceStates as aW, deviceStateLabels as aX, deviceStateMetricFormats as aY, formatComponentValue as aZ, getDeviceStateLabel as a_, type VoltageFormat as aa, type FieldFormat as ab, type DeviceState as ac, type GridState as ad, type ComponentFormatter as ae, type LayerSpec as af, type CustomPinsSpec as ag, type GeoJsonLayerSpec as ah, type RasterLayerSpec as ai, type VectorLayerSpec as aj, type ClusteredVectorLayerSpec as ak, ActionMenu as al, AppShell as am, Avatar as an, Badge as ao, type BaseFormat as ap, ChartContext as aq, CodeEditor as ar, type ColorSpec as as, type ComponentFormatOptions as at, type CurrentUnit as au, type CustomFormat as av, DEFAULT_MAP_TYPE as aw, type DateFormatStyle as ax, type DistanceUnit as ay, type EnergyUnit as az, type AppShellProps as b, gridStateLabels as b0, isActiveState as b1, useChartContext as b2, useComponentFormatter as b3, type AvatarProps as c, type BaseDataPoint as d, type CodeEditorProps as e, type CodeLanguage as f, type CodeTheme as g, type EntityConfig as h, type EntityType as i, Logo as j, type MeterProps as k, type SegmentedControlProps as l, SideNav as m, type SideNavItem as n, type SideNavProps as o, type StaticMapProps as p, type TooltipData as q, type TooltipSeries as r, TopNav as s, type TopNavProps as t, type YFormatType as u, clearColorCache as v, createCategoryColorMap as w, createXScale as x, createYScale as y, defaultMargin as z };