@danxbot/ui 15.26.0 → 15.27.0

package/dist/types/components/Navigation.d.ts

@@ -1,8 +1,29 @@
-import type { ReactNode } from "react";
+import type { MouseEvent, ReactNode } from "react";
 export type Crumb = {
     label: ReactNode;
     href?: string;
-    onClick?: () => void;
+    /**
+     * Receives the click event, which a client-side router NEEDS in order to
+     * suppress the browser's own navigation.
+     *
+     * The anchor below keeps its real `href` (hover URL, ctrl/cmd-click to a new
+     * tab) and only falls back to `#` when there is none, so a crumb with an
+     * `href` and a router-driven `onClick` used to do the client-side navigation
+     * AND a full page load. Take the event and suppress it:
+     *
+     * ```tsx
+     * onClick: (e) => {
+     *   // A modified or middle click is a request for a new tab — let it through.
+     *   if (e.defaultPrevented || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+     *   e.preventDefault();
+     *   navigate(crumb.href);
+     * }
+     * ```
+     *
+     * A zero-argument `() => void` handler still type-checks. The last crumb is
+     * the current page, a non-link span, and never fires this.
+     */
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
 };
 export interface BreadcrumbProps {
     items: Crumb[];

package/dist/types/components/SectionNav.d.ts

@@ -0,0 +1,15 @@
+import type { NavSection } from "./AppShell";
+export interface SectionNavProps {
+    /** The AppShell data model, reused: a group `label` is optional per section. */
+    sections: NavSection[];
+    /** The `id` of the current item. Matches nothing → nothing is marked current. */
+    activeId?: string;
+    /**
+     * Names the `<nav>` landmark, the collapsed popup, and is the collapsed
+     * control's text while `activeId` matches no item. Make it say what the list
+     * is ("Settings"), not that it is a list.
+     */
+    label: string;
+    className?: string;
+}
+export declare function SectionNav({ sections, activeId, label, className }: SectionNavProps): import("react").JSX.Element | null;

package/dist/types/components/nav-sections.d.ts

@@ -0,0 +1,10 @@
+import type { NavSection } from "./AppShell";
+export interface NavSectionsProps {
+    sections: NavSection[];
+    activeId?: string;
+    /** Icon-only rows with the label moved into a tooltip. The shell's rail. */
+    collapsed?: boolean;
+    /** Runs after the item's own `onClick`, on every row click. */
+    onNavigate?: () => void;
+}
+export declare function NavSections({ sections, activeId, collapsed, onNavigate }: NavSectionsProps): import("react").JSX.Element;

package/dist/types/index.d.ts

@@ -41,6 +41,7 @@ export { Toaster, ToastProvider, useToast, type ToasterProps, type ToastProvider
 export { Menu, MenuItem, MenuGroup, MenuRadioGroup, MenuRadioItem, MenuCheckboxItem, MenuSeparator, type MenuProps, type MenuItemProps, type MenuItemTone, type MenuGroupProps, type MenuRadioGroupProps, type MenuRadioItemProps, type MenuCheckboxItemProps, } from "./components/Menu";
 export { ThemeMenu, type ThemeMenuProps } from "./components/ThemeMenu";
 export { AppShell, type AppShellProps, type NavItem, type NavSection, } from "./components/AppShell";
+export { SectionNav, type SectionNavProps } from "./components/SectionNav";
 export { FileUpload, type FileUploadProps, type UploadFile } from "./components/FileUpload";
 export { ImageUploadField, type ImageUploadFieldProps, type ImageUploadFieldShape, type ImageUploadFieldSize, } from "./components/ImageUploadField";
 export { DatePicker, type DatePickerProps, type DateRange } from "./components/DatePicker";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "15.26.0",
+  "version": "15.27.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",
@@ -74,7 +74,7 @@
     "gates": "npm run shoot && npm run a11y && node scripts/shoot-overlays.mjs && npm run probe",
     "a11y": "node scripts/a11y-scan.mjs",
     "shoot": "node scripts/shoot.mjs",
-    "probe": "node scripts/probe-scale.mjs && node scripts/probe-switch.mjs && node scripts/probe-slider.mjs && node scripts/probe-panel.mjs && node scripts/probe-popover-width.mjs && node scripts/probe-api.mjs && node scripts/probe-api-live.mjs && node scripts/probe-tabs-overflow.mjs && node scripts/probe-stat-row.mjs && node scripts/probe-packaging.mjs && node scripts/probe-containment.mjs && node scripts/probe-popover-containment.mjs && node scripts/probe-theme-menu-overflow.mjs && node scripts/probe-shell.mjs && node scripts/probe-nav-trigger-tap-target.mjs && node scripts/probe-card-header.mjs && node scripts/probe-inline-edit.mjs && node scripts/probe-read-more.mjs",
+    "probe": "node scripts/probe-scale.mjs && node scripts/probe-switch.mjs && node scripts/probe-slider.mjs && node scripts/probe-panel.mjs && node scripts/probe-popover-width.mjs && node scripts/probe-api.mjs && node scripts/probe-api-live.mjs && node scripts/probe-tabs-overflow.mjs && node scripts/probe-stat-row.mjs && node scripts/probe-packaging.mjs && node scripts/probe-containment.mjs && node scripts/probe-popover-containment.mjs && node scripts/probe-theme-menu-overflow.mjs && node scripts/probe-shell.mjs && node scripts/probe-nav-trigger-tap-target.mjs && node scripts/probe-card-header.mjs && node scripts/probe-inline-edit.mjs && node scripts/probe-read-more.mjs && node scripts/probe-section-nav.mjs",
     "sync": "node scripts/sync.mjs",
     "visual": "node scripts/visual-docker.mjs",
     "visual:update": "node scripts/visual-docker.mjs --update-snapshots",