@texturehq/edges 5.12.2 → 5.14.0

package/dist/{colors-Dccs-164.d.cts → colors-6y9-eGyY.d.cts}

@@ -256,7 +256,9 @@ type StackNavItem = {
      *
      * 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.
+     * This mirrors the Vercel/Linear/Edges dashboard pattern. Set
+     * `pushOnSelect: false` to split the two: the row becomes a plain link and a
+     * separate chevron button drills into the sub-pane.
      */
     href?: string;
     /** Optional leading-edge icon. Alias-friendly for item models shared with SideNav. */
@@ -272,10 +274,12 @@ type StackNavItem = {
     /** 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`.
+     * When `false` and the row has both `children` and an `href`, selecting the
+     * row only navigates — it does not push a sub-pane; the row's chevron becomes
+     * a separate drill-in button, and a `value` matching the row keeps its own
+     * pane open rather than auto-opening the children. Without an `href` the row
+     * still drills in on click (there is nothing else it could do). Defaults to
+     * `true`.
      */
     pushOnSelect?: boolean;
     /** Aria-label override for screen readers. */
@@ -296,13 +300,13 @@ type StackNavRowRenderProps = {
      * Whether the item has children. Use it to decide whether to draw a drill-in
      * affordance.
      *
-     * Note this reports child presence, not a guarantee about `select`: the click
-     * path pushes a pane whenever children exist and does not consult
-     * `pushOnSelect`, which today only affects deep-link resolution. That
-     * discrepancy predates this prop and is left alone here rather than changed
-     * underneath existing consumers.
+     * Note this reports child presence, not a guarantee about `select`: `select`
+     * pushes a pane when children exist unless the item is an `href` row with
+     * `pushOnSelect: false`, whose pane is pushed by `drillIn` instead.
      */
     hasChildren: boolean;
+    /** Push the item's sub-pane without navigating — the chevron affordance for split rows. */
+    drillIn: () => void;
     /**
      * Run StackNav's selection: report through `onSelect` and push the sub-pane
      * when the item has children.

package/dist/{colors-aSE98RKK.d.ts → colors-lgmIbyUz.d.ts}

@@ -256,7 +256,9 @@ type StackNavItem = {
      *
      * 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.
+     * This mirrors the Vercel/Linear/Edges dashboard pattern. Set
+     * `pushOnSelect: false` to split the two: the row becomes a plain link and a
+     * separate chevron button drills into the sub-pane.
      */
     href?: string;
     /** Optional leading-edge icon. Alias-friendly for item models shared with SideNav. */
@@ -272,10 +274,12 @@ type StackNavItem = {
     /** 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`.
+     * When `false` and the row has both `children` and an `href`, selecting the
+     * row only navigates — it does not push a sub-pane; the row's chevron becomes
+     * a separate drill-in button, and a `value` matching the row keeps its own
+     * pane open rather than auto-opening the children. Without an `href` the row
+     * still drills in on click (there is nothing else it could do). Defaults to
+     * `true`.
      */
     pushOnSelect?: boolean;
     /** Aria-label override for screen readers. */
@@ -296,13 +300,13 @@ type StackNavRowRenderProps = {
      * Whether the item has children. Use it to decide whether to draw a drill-in
      * affordance.
      *
-     * Note this reports child presence, not a guarantee about `select`: the click
-     * path pushes a pane whenever children exist and does not consult
-     * `pushOnSelect`, which today only affects deep-link resolution. That
-     * discrepancy predates this prop and is left alone here rather than changed
-     * underneath existing consumers.
+     * Note this reports child presence, not a guarantee about `select`: `select`
+     * pushes a pane when children exist unless the item is an `href` row with
+     * `pushOnSelect: false`, whose pane is pushed by `drillIn` instead.
      */
     hasChildren: boolean;
+    /** Push the item's sub-pane without navigating — the chevron affordance for split rows. */
+    drillIn: () => void;
     /**
      * Run StackNav's selection: report through `onSelect` and push the sub-pane
      * when the item has children.