@camunda/design-system 0.36.0 → 0.38.0

package/dist/src/components/ui/nav-breadcrumb.js

@@ -1,10 +1,11 @@
 "use client";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import * as React from "react";
-import { ChevronDown } from "lucide-react";
+import { Check, ChevronDown, MoreVertical } from "lucide-react";
 import { cn } from "../../lib/utils.js";
 import { Button } from "./button.js";
-import { DropdownMenu, DropdownMenuContent, DropdownMenuTrigger, } from "./dropdown.js";
+import { linkDestination, resolveActive, resolveLinkProps, } from "./nav-data.js";
+import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, } from "./dropdown.js";
 /**
  * Top-nav context switcher — chain of split-button segments separated by `/`.
  *
@@ -32,7 +33,7 @@ function NavBreadcrumb({ className, children, "aria-label": ariaLabel = "Context
                             className: "select-none text-xs text-neutral-foreground-subtle/40", children: "/" })) : null, child] }, childKey));
             }) }) }));
 }
-function NavBreadcrumbItem({ icon, label, onClick, switchLabel = "Switch context", children, active = false, className, }) {
+function NavBreadcrumbItem({ icon, label, onClick, switchLabel = "Switch context", linkProps, linkComponent, children, actions, actionsLabel, trailingElement, menuElement, active = false, className, }) {
     // Clone the user's icon so it carries the `data-icon` attribute the
     // Button uses to drive its inline padding rules.
     const iconWithData = icon && React.isValidElement(icon)
@@ -42,20 +43,66 @@ function NavBreadcrumbItem({ icon, label, onClick, switchLabel = "Switch context
     // padding; with one, we tighten the right side so the chevron reads as
     // paired (otherwise the inline-start `pl-2` makes the segment look
     // heavier on the right).
-    const hasSwitcher = children !== undefined && children !== null;
-    return (_jsxs("li", { "data-slot": "nav-breadcrumb-item", className: cn("inline-flex items-center", className), children: [_jsxs(Button, { variant: "ghost", size: "sm", onClick: onClick, 
+    //
+    // Filtering matters: `children={[]}` and `children={cond && <Item/>}` both arrive here as
+    // something non-null, and a bare presence test would give them a chevron that opens nothing.
+    const hasSwitcher = React.Children.toArray(children).filter(Boolean).length > 0;
+    const visibleActions = actions?.filter(Boolean) ?? [];
+    const hasActions = visibleActions.length > 0;
+    const resolvedActionsLabel = actionsLabel ??
+        (typeof label === "string" ? `${label} actions` : "More actions");
+    const destination = linkDestination(linkProps);
+    const isLink = destination !== undefined;
+    const LinkEl = linkComponent ?? "a";
+    const labelContent = (_jsxs(_Fragment, { children: [iconWithData, label, trailingElement] }));
+    return (_jsxs("li", { "data-slot": "nav-breadcrumb-item", className: cn("inline-flex items-center", className), children: [_jsx(Button, { variant: "ghost", size: "sm", 
+                // A link segment renders through Button's Slot so it keeps the ghost styling while
+                // being a real anchor — hoverable href, Cmd-click, "open in new tab", and announced
+                // as a link rather than a button.
+                asChild: isLink, onClick: onClick, 
                 // Padding rules:
                 //   • icon present → Button's `has-data-[icon=inline-start]:pl-2`
                 //     already tightens the left; tighten the right when there's a
                 //     switcher so the segment reads as paired.
                 //   • no icon → force `px-2` so left and right match the same
                 //     8px the icon variant uses.
-                className: cn(!icon ? "px-2" : hasSwitcher && "pr-2", active && "font-medium"), children: [iconWithData, label] }), hasSwitcher ? (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: "ghost", size: "icon-xs", "aria-label": switchLabel, 
+                className: cn(!icon ? "px-2" : (hasSwitcher || hasActions) && "pr-2", active && "font-medium"), children: isLink ? (_jsx(LinkEl, { ...resolveLinkProps(linkProps, linkComponent !== undefined), children: labelContent })) : (labelContent) }), menuElement, hasActions ? (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: "ghost", size: "icon-xs", "aria-label": resolvedActionsLabel, className: "-ml-0.5 text-neutral-foreground-subtle", children: _jsx(MoreVertical, {}) }) }), _jsx(DropdownMenuContent, { align: "start", children: visibleActions.map((action) => (_jsxs(React.Fragment, { children: [action.hasDivider ? _jsx(DropdownMenuSeparator, {}) : null, _jsx(DropdownMenuItem, { variant: action.isDanger ? "destructive" : "default", disabled: action.disabled, onClick: action.onClick, children: action.label })] }, action.key))) })] })) : null, hasSwitcher ? (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: "ghost", size: "icon-xs", "aria-label": switchLabel, 
                             // Tighten the gap so the chevron reads as paired with the
                             // label, not a sibling segment. `text-neutral-foreground-subtle`
                             // matches the `/` separator — secondary affordance,
                             // but readable.
                             className: "-ml-0.5 text-neutral-foreground-subtle", children: _jsx(ChevronDown, {}) }) }), _jsx(DropdownMenuContent, { align: "start", children: children })] })) : null] }));
 }
+/**
+ * `NavBreadcrumb` built from data instead of composition.
+ *
+ * `NavBreadcrumb` itself stays composition-based: it takes children and gains no `activeItemKey`.
+ * This helper is the data-fed entry point, and it owns the two resolutions a descriptor implies —
+ * label functions and dropdown selection — so consumers stop hand-rolling them.
+ */
+export function NavBreadcrumbSwitcher({ items, activeItemKey, linkComponent, "aria-label": ariaLabel, className, }) {
+    return (_jsx(NavBreadcrumb, { "aria-label": ariaLabel, className: className, children: items.map((item) => {
+            const label = typeof item.label === "function"
+                ? item.label(activeItemKey ?? "")
+                : item.label;
+            const Icon = item.icon;
+            const rows = item.dropdownItems ?? [];
+            return (_jsx(NavBreadcrumbItem, { icon: Icon ? _jsx(Icon, {}) : undefined, label: label, onClick: item.onClick, linkProps: item.linkProps, linkComponent: linkComponent, actions: item.actions, actionsLabel: item.actionsLabel, trailingElement: item.trailingElement, menuElement: item.menuElement, switchLabel: item.dropdownAriaLabel, children: rows.length > 0 ? (_jsxs(_Fragment, { children: [item.dropdownTitle ? (_jsx(DropdownMenuLabel, { children: item.dropdownTitle })) : null, rows.map((row) => (_jsx(SwitcherRow, { row: row, activeItemKey: activeItemKey, linkComponent: linkComponent }, row.key)))] })) : null }, item.key));
+        }) }));
+}
+function SwitcherRow({ row, activeItemKey, linkComponent, }) {
+    // No key fallback here — see `isSelected` on NavBreadcrumbDropdownItem for why.
+    const selected = row.isSelected === undefined
+        ? false
+        : resolveActive(row.isSelected, row.key, activeItemKey);
+    const destination = linkDestination(row.linkProps);
+    const RowIcon = row.icon;
+    const LinkEl = linkComponent ?? "a";
+    const content = (_jsxs(_Fragment, { children: [_jsx("span", { "aria-hidden": true, className: "flex w-4 shrink-0 justify-center", children: selected ? _jsx(Check, { className: "size-4" }) : null }), RowIcon ? _jsx(RowIcon, { "aria-hidden": true, className: "size-4 shrink-0" }) : null, _jsx("span", { className: "flex-1 truncate", children: row.label }), row.trailingElement] }));
+    return (_jsx(DropdownMenuItem
+    // `aria-current` rather than `aria-selected`: the row is a menuitem, and menuitem does
+    // not support aria-selected. Screen readers announce the page relationship instead.
+    , { "aria-current": selected ? "page" : undefined, onClick: row.onClick, asChild: destination !== undefined, children: destination !== undefined ? (_jsx(LinkEl, { ...resolveLinkProps(row.linkProps, linkComponent !== undefined), children: content })) : (content) }));
+}
 export { NavBreadcrumb, NavBreadcrumbItem };
 //# sourceMappingURL=nav-breadcrumb.js.map

package/dist/src/components/ui/nav-breadcrumb.js.map

@@ -1 +1 @@
-{"version":3,"file":"nav-breadcrumb.js","sourceRoot":"","sources":["../../../../src/components/ui/nav-breadcrumb.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"nav-breadcrumb.js","sourceRoot":"","sources":["../../../../src/components/ui/nav-breadcrumb.tsx"],"names":[],"mappings":"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"}

package/dist/src/components/ui/nav-data.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Vocabulary shared by the data-driven navigation surfaces: how a node describes where it goes,
+ * and how it says whether it is the current one. `AppSidebar` and `NavBreadcrumb` both read
+ * these — the rules must not diverge, or the same `linkProps` would resolve differently
+ * depending on which surface renders it.
+ */
+export interface NavLinkProps {
+    href?: string;
+    /**
+     * React Router's destination, declared alongside `href` because `to` is the router convention
+     * and most consumers building navigation data already emit it.
+     *
+     * Narrowed to `string` on purpose. React Router's own `to` is
+     * `LocationDescriptor | ((location) => LocationDescriptor)`, and a non-string value reaching
+     * the default anchor renders `href="[object Object]"` — a link that looks real and navigates
+     * nowhere. Object and function destinations are still supported, but only through an injected
+     * `linkComponent`, which knows how to read them.
+     */
+    to?: string;
+    [key: string]: unknown;
+}
+/**
+ * Whether a node is the current one.
+ *
+ * - `undefined` — fall back to comparing the node's `key` against `activeItemKey`
+ * - `boolean` — as given
+ * - `string` — active when it equals `activeItemKey`
+ * - function — called with `activeItemKey`
+ *
+ * The function form is why this is a union rather than a boolean: a matcher passed to a boolean
+ * prop is always truthy, so every row using one renders permanently active.
+ */
+export type ActiveMatcher = boolean | string | ((activeItemKey: string) => boolean);
+/** The destination a node points at, or `undefined` when it is not a link. */
+export declare function linkDestination(linkProps: NavLinkProps | undefined): string | undefined;
+/**
+ * Props for the rendered link element. An injected `linkComponent` gets everything; the default
+ * anchor gets the router keys stripped and an `href` resolved from `href ?? to`.
+ */
+export declare function resolveLinkProps(linkProps: NavLinkProps | undefined, hasLinkComponent: boolean): Record<string, unknown>;
+/**
+ * Resolves a node's active state. A per-node matcher of any form always wins; `activeItemKey`
+ * is only the fallback comparand, compared against the node's own key.
+ */
+export declare function resolveActive(isActive: ActiveMatcher | undefined, key: string, activeItemKey: string | undefined): boolean;
+//# sourceMappingURL=nav-data.d.ts.map

package/dist/src/components/ui/nav-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-data.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/nav-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;OASG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GACvB,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;AAuB1D,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,SAAS,sBAIlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,GAAG,SAAS,EACnC,gBAAgB,EAAE,OAAO,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,OAAO,CAOT"}

package/dist/src/components/ui/nav-data.js

@@ -0,0 +1,66 @@
+/**
+ * Vocabulary shared by the data-driven navigation surfaces: how a node describes where it goes,
+ * and how it says whether it is the current one. `AppSidebar` and `NavBreadcrumb` both read
+ * these — the rules must not diverge, or the same `linkProps` would resolve differently
+ * depending on which surface renders it.
+ */
+/**
+ * React Router keys that must not reach a plain `<a>`. When a `linkComponent` is injected every
+ * key passes through verbatim — it needs these. When the design system renders its own anchor
+ * they are unknown DOM attributes, and React warns about each one.
+ *
+ * Targets react-router v5 and v6. A consumer on another router should inject a `linkComponent`
+ * rather than expect this list to know its prop names.
+ */
+const ROUTER_ONLY_LINK_KEYS = new Set([
+    "to",
+    "replace",
+    "state",
+    "innerRef",
+    "component",
+    "exact",
+    "strict",
+    "isActive",
+    "activeClassName",
+    "activeStyle",
+]);
+/** The destination a node points at, or `undefined` when it is not a link. */
+export function linkDestination(linkProps) {
+    if (!linkProps)
+        return undefined;
+    if (linkProps.href !== undefined)
+        return linkProps.href;
+    return typeof linkProps.to === "string" ? linkProps.to : undefined;
+}
+/**
+ * Props for the rendered link element. An injected `linkComponent` gets everything; the default
+ * anchor gets the router keys stripped and an `href` resolved from `href ?? to`.
+ */
+export function resolveLinkProps(linkProps, hasLinkComponent) {
+    if (!linkProps)
+        return {};
+    if (hasLinkComponent)
+        return linkProps;
+    const rest = {};
+    for (const [key, value] of Object.entries(linkProps)) {
+        if (!ROUTER_ONLY_LINK_KEYS.has(key))
+            rest[key] = value;
+    }
+    rest.href = linkDestination(linkProps);
+    return rest;
+}
+/**
+ * Resolves a node's active state. A per-node matcher of any form always wins; `activeItemKey`
+ * is only the fallback comparand, compared against the node's own key.
+ */
+export function resolveActive(isActive, key, activeItemKey) {
+    if (isActive === undefined) {
+        return activeItemKey !== undefined && key === activeItemKey;
+    }
+    if (typeof isActive === "boolean")
+        return isActive;
+    if (typeof isActive === "string")
+        return isActive === activeItemKey;
+    return activeItemKey !== undefined ? isActive(activeItemKey) : false;
+}
+//# sourceMappingURL=nav-data.js.map

package/dist/src/components/ui/nav-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-data.js","sourceRoot":"","sources":["../../../../src/components/ui/nav-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,IAAI;IACJ,SAAS;IACT,OAAO;IACP,UAAU;IACV,WAAW;IACX,OAAO;IACP,QAAQ;IACR,UAAU;IACV,iBAAiB;IACjB,aAAa;CACd,CAAC,CAAC;AAEH,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,SAAmC;IACjE,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC;IACxD,OAAO,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAmC,EACnC,gBAAyB;IAEzB,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAEvC,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAmC,EACnC,GAAW,EACX,aAAiC;IAEjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,aAAa,KAAK,SAAS,IAAI,GAAG,KAAK,aAAa,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,KAAK,aAAa,CAAC;IACpE,OAAO,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACvE,CAAC"}

package/dist/src/components/ui/nav-icon.assignability.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Compile-time fixture for the `NavIcon` contract. Nothing imports this file — it exists to be
+ * type-checked, and `npm run typecheck` is what runs it.
+ *
+ * `NavIcon` is deliberately structural. Narrowing it back to lucide's `LucideIcon` (a
+ * `React.ForwardRefExoticComponent`, which structurally requires `$$typeof`) would silently
+ * reject three of the four sources below — including this package's own registry icons — and
+ * every consumer would discover it at their call sites rather than here.
+ */
+import type * as React from "react";
+import type { NavIcon } from "./nav-icon.js";
+import type { SidebarItem } from "./app-sidebar.js";
+import type { GlobalActionButton } from "./app-header.js";
+/** A Carbon icon's shape, which is what C3's `IconComponent` resolves to. */
+interface CarbonIconProps extends React.SVGProps<SVGSVGElement> {
+    size?: number | string;
+}
+declare const fromLucide: NavIcon;
+declare const fromRegistryNamed: NavIcon;
+declare const fromRegistryMap: NavIcon;
+declare const fromAppMap: NavIcon;
+declare const fromCarbonClass: NavIcon;
+declare const fromCarbonFunction: NavIcon;
+/** Both consuming surfaces accept the same four sources. */
+declare const sidebarItem: SidebarItem;
+declare const sidebarItemWithoutIcon: SidebarItem;
+declare const globalAction: GlobalActionButton;
+export type { CarbonIconProps as _CarbonIconProps };
+export { fromLucide, fromRegistryNamed, fromRegistryMap, fromAppMap, fromCarbonClass, fromCarbonFunction, sidebarItem, sidebarItemWithoutIcon, globalAction, };
+//# sourceMappingURL=nav-icon.assignability.d.ts.map

package/dist/src/components/ui/nav-icon.assignability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-icon.assignability.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/nav-icon.assignability.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAMpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,6EAA6E;AAC7E,UAAU,eAAgB,SAAQ,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC7D,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAID,QAAA,MAAM,UAAU,EAAE,OAAmC,CAAC;AACtD,QAAA,MAAM,iBAAiB,EAAE,OAAqB,CAAC;AAC/C,QAAA,MAAM,eAAe,EAAE,OAA8B,CAAC;AACtD,QAAA,MAAM,UAAU,EAAE,OAAiC,CAAC;AACpD,QAAA,MAAM,eAAe,EAAE,OAAyB,CAAC;AACjD,QAAA,MAAM,kBAAkB,EAAE,OAA4B,CAAC;AAEvD,4DAA4D;AAC5D,QAAA,MAAM,WAAW,EAAE,WAKlB,CAAC;AACF,QAAA,MAAM,sBAAsB,EAAE,WAI7B,CAAC;AACF,QAAA,MAAM,YAAY,EAAE,kBAInB,CAAC;AAEF,YAAY,EAAE,eAAe,IAAI,gBAAgB,EAAE,CAAC;AACpD,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,YAAY,GACb,CAAC"}

package/dist/src/components/ui/nav-icon.assignability.js

@@ -0,0 +1,28 @@
+import { Home } from "lucide-react";
+import { camundaIcons, ProjectIcon } from "../../icons/index.js";
+import { camundaAppIcons } from "../../icons/camunda-app-icons.js";
+const fromLucide = Home;
+const fromRegistryNamed = ProjectIcon;
+const fromRegistryMap = camundaIcons.project;
+const fromAppMap = camundaAppIcons.operate;
+const fromCarbonClass = CarbonClassIcon;
+const fromCarbonFunction = CarbonFunctionIcon;
+/** Both consuming surfaces accept the same four sources. */
+const sidebarItem = {
+    type: "item",
+    key: "k",
+    label: "Label",
+    icon: CarbonFunctionIcon,
+};
+const sidebarItemWithoutIcon = {
+    type: "item",
+    key: "k",
+    label: "Label",
+};
+const globalAction = {
+    key: "k",
+    label: "Label",
+    icon: ProjectIcon,
+};
+export { fromLucide, fromRegistryNamed, fromRegistryMap, fromAppMap, fromCarbonClass, fromCarbonFunction, sidebarItem, sidebarItemWithoutIcon, globalAction, };
+//# sourceMappingURL=nav-icon.assignability.js.map

package/dist/src/components/ui/nav-icon.assignability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-icon.assignability.js","sourceRoot":"","sources":["../../../../src/components/ui/nav-icon.assignability.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAYhE,MAAM,UAAU,GAAY,IAAyB,CAAC;AACtD,MAAM,iBAAiB,GAAY,WAAW,CAAC;AAC/C,MAAM,eAAe,GAAY,YAAY,CAAC,OAAO,CAAC;AACtD,MAAM,UAAU,GAAY,eAAe,CAAC,OAAO,CAAC;AACpD,MAAM,eAAe,GAAY,eAAe,CAAC;AACjD,MAAM,kBAAkB,GAAY,kBAAkB,CAAC;AAEvD,4DAA4D;AAC5D,MAAM,WAAW,GAAgB;IAC/B,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,GAAG;IACR,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,kBAAkB;CACzB,CAAC;AACF,MAAM,sBAAsB,GAAgB;IAC1C,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,GAAG;IACR,KAAK,EAAE,OAAO;CACf,CAAC;AACF,MAAM,YAAY,GAAuB;IACvC,GAAG,EAAE,GAAG;IACR,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,WAAW;CAClB,CAAC;AAGF,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,YAAY,GACb,CAAC"}

package/dist/src/components/ui/nav-icon.d.ts

@@ -0,0 +1,33 @@
+import * as React from "react";
+/**
+ * The accepted type of every data-driven icon slot in the navigation API.
+ *
+ * Deliberately structural rather than lucide's nominal `LucideIcon`: that type is a
+ * `React.ForwardRefExoticComponent`, so it structurally requires `$$typeof` and rejects any
+ * plain function component — including the design system's own registry icons. All four sources
+ * a consumer can hold assign to this one: lucide icons, the registry's icons, `camundaIcons[key]`
+ * and Carbon-shaped icon components.
+ *
+ * `size` is intentionally absent, and both plausible spellings were measured to fail under
+ * `strict`: `size?: number | string` rejects Carbon-shaped icons (whose `size` is `number`,
+ * through `getDerivedStateFromProps` contravariance) and `size?: number` rejects lucide
+ * (`propTypes` invariance). Size icons with the `size-*` utility, optionally reinforced with
+ * numeric `width`/`height` — both are members of `SVGProps<SVGSVGElement>`. A class overrides an
+ * SVG `width`/`height` attribute but not an inline `style`, so an icon that hardcodes its
+ * dimensions inline is out of contract.
+ */
+export type NavIcon = React.ComponentType<React.SVGProps<SVGSVGElement>>;
+/**
+ * Renders a navigation row's icon, falling back to the label's initials.
+ *
+ * The collapsed rail renders the icon as the row's only visual, with the label moved into
+ * `sr-only`. An icon-less node would collapse to a row that is invisible yet still focusable and
+ * still carries a tooltip — so something has to occupy the box. Initials keep rows
+ * distinguishable, and the rail's existing tooltip names them.
+ */
+export declare function NavRowIcon({ icon: Icon, label, className, }: {
+    icon?: NavIcon;
+    label: string;
+    className?: string;
+}): React.JSX.Element;
+//# sourceMappingURL=nav-icon.d.ts.map

package/dist/src/components/ui/nav-icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-icon.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/nav-icon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;AAEzE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EAAE,IAAI,EACV,KAAK,EACL,SAAS,GACV,EAAE;IACD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,qBAmBA"}

package/dist/src/components/ui/nav-icon.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { cn } from "../../lib/utils.js";
+import { deriveInitials } from "./avatar.js";
+/**
+ * Renders a navigation row's icon, falling back to the label's initials.
+ *
+ * The collapsed rail renders the icon as the row's only visual, with the label moved into
+ * `sr-only`. An icon-less node would collapse to a row that is invisible yet still focusable and
+ * still carries a tooltip — so something has to occupy the box. Initials keep rows
+ * distinguishable, and the rail's existing tooltip names them.
+ */
+export function NavRowIcon({ icon: Icon, label, className, }) {
+    if (Icon) {
+        return _jsx(Icon, { "aria-hidden": true, className: cn("size-5 shrink-0", className) });
+    }
+    const initials = deriveInitials(label);
+    return (_jsx("span", { "aria-hidden": true, "data-slot": "nav-row-icon-fallback", className: cn("flex size-5 shrink-0 items-center justify-center rounded-sm border border-current/30 text-[0.625rem] font-medium leading-none", className), children: initials }));
+}
+//# sourceMappingURL=nav-icon.js.map

package/dist/src/components/ui/nav-icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-icon.js","sourceRoot":"","sources":["../../../../src/components/ui/nav-icon.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAqB1C;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,IAAI,EAAE,IAAI,EACV,KAAK,EACL,SAAS,GAKV;IACC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,KAAC,IAAI,yBAAa,SAAS,EAAE,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,GAAI,CAAC;IAC3E,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAEvC,OAAO,CACL,iDAEY,uBAAuB,EACjC,SAAS,EAAE,EAAE,CACX,+HAA+H,EAC/H,SAAS,CACV,YAEA,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC"}

package/dist/src/components/ui/nav-tools.assignability.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDescriptor } from "./nav-tools.js";
+import type { AppHeaderProps } from "./app-header.js";
+export declare const asDsTools: ToolDescriptor[];
+export declare const asHeaderProp: AppHeaderProps["tools"];
+export declare const widenedRenderButton: ToolDescriptor["renderButton"];
+export declare const noArgRenderButton: ToolDescriptor["renderButton"];
+export declare const dsShapedTool: ToolDescriptor;
+export declare const actionOnlyTool: ToolDescriptor;
+export declare const nodePanelTool: ToolDescriptor;
+//# sourceMappingURL=nav-tools.assignability.d.ts.map

package/dist/src/components/ui/nav-tools.assignability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-tools.assignability.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/nav-tools.assignability.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAgBnD,eAAO,MAAM,SAAS,EAAE,cAAc,EAAY,CAAC;AAGnD,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,OAAO,CAAW,CAAC;AAS7D,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,cAAc,CAC/C,CAAC;AAGjB,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,cAAc,CAAc,CAAC;AAG5E,eAAO,MAAM,YAAY,EAAE,cAQ1B,CAAC;AAGF,eAAO,MAAM,cAAc,EAAE,cAI5B,CAAC;AAIF,eAAO,MAAM,aAAa,EAAE,cAK3B,CAAC"}

package/dist/src/components/ui/nav-tools.assignability.js

@@ -0,0 +1,35 @@
+// 1. The whole array assigns, which is the migration promise.
+export const asDsTools = c3Tools;
+// 2. And it assigns at the call site, not merely to the exported type.
+export const asHeaderProp = c3Tools;
+export const widenedRenderButton = c3RenderButton;
+// 4. A trigger that ignores the payload entirely is still valid.
+export const noArgRenderButton = () => null;
+// 5. The design-system shape: reading `buttonProps` and using the function form of `panel`.
+export const dsShapedTool = {
+    key: "notifications",
+    label: "Notifications",
+    renderButton: ({ onClick, isActive, buttonProps }) => 
+    // Reads every member, so the payload's shape is exercised and not merely named.
+    `${String(onClick)}${isActive}${buttonProps.id}${buttonProps["aria-expanded"]}${buttonProps["aria-controls"] ?? ""}`,
+    panel: ({ close }) => String(close),
+    panelWidth: "24rem",
+};
+// 6. A panel-less tool — hub's help-centre button is exactly this shape.
+export const actionOnlyTool = {
+    key: "help",
+    label: "Help",
+    renderButton: () => null,
+};
+export const nodePanelTool = {
+    key: "info",
+    label: "Info",
+    renderButton: () => null,
+    panel: someNode,
+};
+/*
+ * Deliberately NOT asserted: that a DS `ToolDescriptor` assigns back to `C3ToolDescriptor`.
+ * It does not, and should not — `panel` accepts a function form C3 cannot render. The contract
+ * is one-way, and only that direction is a migration path.
+ */
+//# sourceMappingURL=nav-tools.assignability.js.map

package/dist/src/components/ui/nav-tools.assignability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-tools.assignability.js","sourceRoot":"","sources":["../../../../src/components/ui/nav-tools.assignability.ts"],"names":[],"mappings":"AA+BA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,SAAS,GAAqB,OAAO,CAAC;AAEnD,uEAAuE;AACvE,MAAM,CAAC,MAAM,YAAY,GAA4B,OAAO,CAAC;AAS7D,MAAM,CAAC,MAAM,mBAAmB,GAC9B,cAAc,CAAC;AAEjB,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAmC,GAAG,EAAE,CAAC,IAAI,CAAC;AAE5E,4FAA4F;AAC5F,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,GAAG,EAAE,eAAe;IACpB,KAAK,EAAE,eAAe;IACtB,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAmB,EAAE,EAAE;IACpE,gFAAgF;IAChF,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,GAAG,WAAW,CAAC,EAAE,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG,WAAW,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE;IACtH,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;IACnC,UAAU,EAAE,OAAO;CACpB,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,GAAG,EAAE,MAAM;IACX,KAAK,EAAE,MAAM;IACb,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI;CACzB,CAAC;AAIF,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,GAAG,EAAE,MAAM;IACX,KAAK,EAAE,MAAM;IACb,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI;IACxB,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF;;;;GAIG"}

package/dist/src/components/ui/nav-tools.d.ts

@@ -0,0 +1,95 @@
+import * as React from "react";
+/**
+ * Header tool panels — the button-plus-panel system that carries app chrome (notifications,
+ * info, help, user).
+ *
+ * The panel is a **disclosure**, not a dialog: opening it leaves focus on the trigger and moving
+ * focus away does not close it. Escape and an outside pointer-down do close it, which a plain
+ * disclosure would not do, but neither is focus-based so neither contradicts the role.
+ */
+/** What the header hands a tool's trigger component. */
+export interface ToolButtonProps {
+    onClick: () => void;
+    isActive: boolean;
+    /**
+     * Spread onto the rendered button. The consumer owns that element, so the design system
+     * cannot put the disclosure wiring on it from outside — cloning the returned node instead
+     * silently no-ops whenever `renderButton` returns a Fragment or a wrapper.
+     *
+     * `aria-controls` appears only while this tool's panel is open, because it must reference an
+     * element that exists.
+     */
+    buttonProps: {
+        id: string;
+        "aria-expanded": boolean;
+        "aria-controls"?: string;
+    };
+}
+/**
+ * A panel, or a function receiving `close`.
+ *
+ * The function form exists because the panel gets no chrome from the design system: C3 ships
+ * none either (`panel-primitives` exports a header and a title, no close button), and its
+ * notifications panel deliberately stays open over the destination the user just navigated to.
+ * A panel that does want a close affordance would otherwise have no way to dismiss itself.
+ */
+export type ToolPanelContent = React.ReactNode | ((props: {
+    close: () => void;
+}) => React.ReactNode);
+export interface ToolDescriptor {
+    key: string;
+    label: string;
+    /**
+     * Rendered as a component (`<tool.renderButton … />`), never called as a function, so it may
+     * use hooks — C3's notifications tool reads a context inside it to drive its unread badge.
+     *
+     * Its identity is therefore a component identity: build the `tools` array outside render or
+     * memoize it, or every button unmounts and remounts on each render, dropping focus, hover and
+     * any open tooltip.
+     */
+    renderButton: (props: ToolButtonProps) => React.ReactNode;
+    /** Omit for a tool that only acts — its click is inert and the action lives in `renderButton`. */
+    panel?: ToolPanelContent;
+    /** Width of this tool's panel on `sm` and up. Default `"20rem"` (C3's 320px). */
+    panelWidth?: string;
+}
+export interface UseHeaderToolsOptions {
+    tools?: ToolDescriptor[];
+    activeToolKey?: string | null;
+    onActiveToolChange?: (key: string | null) => void;
+    /** Namespaces the generated trigger and panel ids. */
+    idPrefix: string;
+}
+/**
+ * Owns which tool is open.
+ *
+ * `activeToolKey` has three states, not two: `undefined` is uncontrolled, `null` is controlled
+ * with nothing open, and a string is controlled with that tool open. A consumer passing `null`
+ * to mean "you decide" enters controlled mode permanently, so that distinction has to survive.
+ */
+export declare function useHeaderTools({ tools, activeToolKey, onActiveToolChange, idPrefix, }: UseHeaderToolsOptions): {
+    activeTool: ToolDescriptor | null;
+    activeKey: string | null;
+    toggleTool: (tool: ToolDescriptor) => void;
+    setActiveKey: (key: string | null) => void;
+    panelId: string;
+    triggerId: (key: string) => string;
+};
+export interface HeaderToolsProps {
+    tools: ToolDescriptor[];
+    activeTool: ToolDescriptor | null;
+    activeKey: string | null;
+    toggleTool: (tool: ToolDescriptor) => void;
+    setActiveKey: (key: string | null) => void;
+    panelId: string;
+    triggerId: (key: string) => string;
+}
+/**
+ * The trigger row plus, when a tool is open, its portaled panel.
+ *
+ * Tab from an expanded trigger moves focus into the panel. Without it a disclosure whose panel
+ * is portaled to the end of `<body>` is reachable only by tabbing the whole page — the panel
+ * sits beside its trigger visually but nowhere near it in the tab sequence.
+ */
+export declare function HeaderTools({ tools, activeTool, activeKey, toggleTool, setActiveKey, panelId, triggerId, }: HeaderToolsProps): React.JSX.Element;
+//# sourceMappingURL=nav-tools.d.ts.map

package/dist/src/components/ui/nav-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-tools.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/nav-tools.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B;;;;;;;GAOG;AAEH,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,WAAW,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,eAAe,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAC1B,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1D,kGAAkG;IAClG,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAaD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,aAAa,EACb,kBAAkB,EAClB,QAAQ,GACT,EAAE,qBAAqB;;;uBAoCb,cAAc;wBAVf,MAAM,GAAG,IAAI;;qBAqBb,MAAM;EAYf;AAUD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,UAAU,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,OAAO,EACP,SAAS,GACV,EAAE,gBAAgB,qBAuDlB"}