@umituz/web-dashboard 6.8.0 → 6.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/web-dashboard",
-  "version": "6.8.0",
+  "version": "6.9.0",
   "description": "Installable app skeleton for the fleet — layouts, analytics (dependency-free SVG charts), calendar, onboarding flow, i18n via @umituz/web-localization, permissions/module registry; udb-* stylesheet on design-system tokens",
   "type": "module",
   "main": "./src/index.ts",

package/src/domains/layouts/components/DashboardLayout.test.tsx

@@ -98,4 +98,28 @@ describe("DashboardLayout (command palette)", () => {
     expect(onActivate).toHaveBeenCalledTimes(1);
     expect(screen.queryByRole("dialog")).toBeNull();
   });
+
+  it("derives navigation groups from the sidebar when includeSidebar is set", async () => {
+    renderAt("/", undefined, {
+      ...config,
+      commandPalette: {
+        includeSidebar: true,
+        groups: [{ heading: "Quick", items: [{ id: "q", label: "Quick action", onSelect: () => {} }] }],
+      },
+    });
+    fireEvent.keyDown(window, { key: "k", metaKey: true });
+    expect(await screen.findByRole("option", { name: "Quick action" })).toBeTruthy();
+    // The custom group has no "Home" — the one present is derived from the sidebar,
+    // carrying the path as its hint (accessible name "Home /").
+    const derived = screen.getByRole("option", { name: /home/i });
+    expect(derived.textContent).toContain("/");
+  });
+
+  it("omits sidebar-derived items from the palette by default", async () => {
+    renderAt("/", undefined, paletteConfig());
+    fireEvent.keyDown(window, { key: "k", metaKey: true });
+    // Only the palette's own "Home" (no path hint) — nothing derived from the sidebar.
+    const own = await screen.findByRole("option", { name: "Home" });
+    expect(own.textContent).toBe("Home");
+  });
 });

package/src/domains/layouts/components/DashboardLayout.tsx

@@ -1,5 +1,5 @@
 import { useState, useEffect, type ReactNode } from "react";
-import { useLocation, Outlet, Navigate } from "react-router-dom";
+import { useLocation, useNavigate, Outlet, Navigate } from "react-router-dom";
 import { useT } from "@umituz/web-localization/react";
 import { Skeleton } from "@umituz/web-design-system/atoms";
 import { CommandPalette } from "@umituz/web-design-system/organisms";
@@ -61,6 +61,7 @@ export const DashboardLayout = ({
   skipToContentLabel,
 }: DashboardLayoutProps) => {
   const location = useLocation();
+  const navigate = useNavigate();
   const t = useT();
   const [collapsed, setCollapsed] = useState(() => readCollapsed(collapsedStorageKey));
   const [mobileOpen, setMobileOpen] = useState(false);
@@ -132,6 +133,23 @@ export const DashboardLayout = ({
 
   const currentTitle = getTitle();
 
+  // Sidebar-derived navigation groups — one nav definition feeds both chrome surfaces.
+  const paletteGroups = palette?.includeSidebar
+    ? [
+        ...palette.groups,
+        ...config.sidebarGroups.map((group) => ({
+          heading: group.title,
+          items: group.items.map((item) => ({
+            id: `nav-${item.path}`,
+            label: item.raw ? item.label : t(item.label),
+            icon: <item.icon size={16} aria-hidden="true" />,
+            hint: item.path,
+            onSelect: () => navigate(item.path),
+          })),
+        })),
+      ]
+    : undefined;
+
   const sidebarProps = {
     sidebarGroups: config.sidebarGroups,
     brandName: config.brandName,
@@ -225,7 +243,7 @@ export const DashboardLayout = ({
         <CommandPalette
           open={paletteOpen}
           onOpenChange={setPaletteOpen}
-          groups={palette.groups}
+          groups={paletteGroups ?? palette.groups}
           placeholder={palette.placeholder}
           emptyLabel={palette.emptyLabel}
           label={palette.label}

package/src/domains/layouts/types/layout.ts

@@ -42,6 +42,9 @@ export interface CommandPaletteConfig {
     label?: string;
     /** Bind ⌘K/Ctrl+K to open the palette (default true). */
     shortcut?: boolean;
+    /** Append the sidebar groups as navigation groups — derived from
+     *  sidebarGroups and routed internally, so apps never map their nav twice. */
+    includeSidebar?: boolean;
 }
 
 export interface DashboardSidebarProps {