najm-kit 2.11.14 → 2.11.16

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 2.11.16 - 2026-09-04
+
+- `NBrandingPayload` accepts a `slots` registry, so `NajmAppProvider` takes what
+  `najm-theme`'s `loadServerBranding()` returned as `initialBranding` unchanged
+  instead of renaming `sidebarLogoExpanded` and `sidebarLogoCollapsed` at the
+  call site. Structural — the kit still does not depend on `najm-theme`.
+  Precedence is explicit marks, then flat payload fields, then slots, and only
+  the two sidebar keys are read: an auth logo, a hero, and a consumer's own
+  slots stay out of the context the sidebar sees.
+
+## 2.11.15 - 2026-09-04
+
+- Fixed `ComboboxInput` keyboard interaction. Enter and Space now open its
+  focusable trigger, and Enter commits the active filtered result instead of
+  doing nothing when the previously active CmdK item was filtered out. Disabled
+  comboboxes remain non-activatable.
+
 ## 2.11.14 - 2026-09-04
 
 - Added `defineNajmPreferences` to `najm-kit/server`: the language, theme, and

package/dist/{NNotFoundState-CgU76llk.d.ts → NNotFoundState-BmGDW2Bx.d.ts}

@@ -25,15 +25,28 @@ interface NBrandingValue {
 interface NBrandingPayload {
     sidebarLogoExpandedPath?: string | null;
     sidebarLogoCollapsedPath?: string | null;
+    /**
+     * A slot registry, as `najm-theme` resolves branding: slot key to path.
+     *
+     * Read here so a themed application passes what `loadServerBranding()`
+     * returned straight through, rather than renaming two of its slots at the
+     * one call site that mounts the chrome. Only the two sidebar keys are read,
+     * so an auth logo, a hero, and a consumer's own slots stay out of the
+     * context the sidebar sees.
+     *
+     * Structural on purpose: the kit does not depend on `najm-theme`, and the
+     * dependency runs the other way.
+     */
+    slots?: Record<string, string | null>;
 }
 /** Resolved marks, an endpoint payload, or both. */
 type NBrandingInput = NBrandingValue & NBrandingPayload;
 /**
  * Projects an input onto the marks `useNBranding` publishes.
  *
- * Explicit marks win over payload fields, so an application already passing
- * `logoExpanded` — or a `ReactNode` logo, which no payload can express — is
- * unaffected by the wider input type.
+ * Explicit marks win over payload fields, which win over slots, so an
+ * application already passing `logoExpanded` — or a `ReactNode` logo, which no
+ * payload can express — is unaffected by the wider input type.
  */
 declare function normalizeBranding(input?: NBrandingInput): NBrandingValue;
 /** Returns `null` outside a provider, so every consumer stays optional. */

package/dist/adapters/app.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { Translations } from 'najm-i18n';
-import { F as FormDevToolsOptions, N as NBrandingInput } from '../NNotFoundState-CgU76llk.js';
-export { a as NEmptyState, b as NEmptyStateProps, c as NErrorState, d as NErrorStateProps, e as NFeedbackSurface, f as NForbiddenState, g as NForbiddenStateProps, h as NLoadingState, i as NLoadingStateProps, j as NNotFoundState, k as NNotFoundStateProps } from '../NNotFoundState-CgU76llk.js';
+import { F as FormDevToolsOptions, N as NBrandingInput } from '../NNotFoundState-BmGDW2Bx.js';
+export { a as NEmptyState, b as NEmptyStateProps, c as NErrorState, d as NErrorStateProps, e as NFeedbackSurface, f as NForbiddenState, g as NForbiddenStateProps, h as NLoadingState, i as NLoadingStateProps, j as NNotFoundState, k as NNotFoundStateProps } from '../NNotFoundState-BmGDW2Bx.js';
 import { NajmNextUIProviderProps } from './next.js';
 export { D as DEFAULT_FEEDBACK_KEY_PREFIX, F as FeedbackKey, N as NFeedbackDefaults, a as NFeedbackLabelKeys, b as NFeedbackLabels } from '../NajmUIProvider-BwL5HFIV.js';
 import 'zod';

package/dist/adapters/app.mjs

@@ -1,6 +1,6 @@
 'use client';
-import { FormDevToolsProvider, NBrandingStateProvider, NajmFormatProvider } from '../chunk-26EASWUY.mjs';
-export { NEmptyState, NErrorState, NForbiddenState, NLoadingState, NNotFoundState } from '../chunk-26EASWUY.mjs';
+import { FormDevToolsProvider, NBrandingStateProvider, NajmFormatProvider } from '../chunk-5ZTOCWRA.mjs';
+export { NEmptyState, NErrorState, NForbiddenState, NLoadingState, NNotFoundState } from '../chunk-5ZTOCWRA.mjs';
 import { NajmNextUIProvider } from '../chunk-DKHIQFXX.mjs';
 export { DEFAULT_FEEDBACK_KEY_PREFIX } from '../chunk-BDQK6ECA.mjs';
 import '../chunk-M5VGBZ7R.mjs';

package/dist/{chunk-26EASWUY.mjs → chunk-5ZTOCWRA.mjs}

@@ -10,8 +10,8 @@ import { AlertTriangle, LoaderCircleIcon, LoaderPinwheelIcon, LoaderIcon, Shield
 function normalizeBranding(input) {
   if (!input) return {};
   const value = {};
-  const expanded = input.logoExpanded ?? input.sidebarLogoExpandedPath;
-  const collapsed = input.logoCollapsed ?? input.sidebarLogoCollapsedPath;
+  const expanded = input.logoExpanded ?? input.sidebarLogoExpandedPath ?? input.slots?.sidebarLogoExpanded;
+  const collapsed = input.logoCollapsed ?? input.sidebarLogoCollapsedPath ?? input.slots?.sidebarLogoCollapsed;
   if (input.appName !== void 0) value.appName = input.appName;
   if (input.logoFallback !== void 0) value.logoFallback = input.logoFallback;
   if (input.logoHref !== void 0) value.logoHref = input.logoHref;

package/dist/index.d.ts

@@ -24,8 +24,8 @@ import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import * as ProgressPrimitive from '@radix-ui/react-progress';
 import * as SeparatorPrimitive from '@radix-ui/react-separator';
 import { OverlayScrollbarsComponentProps } from 'overlayscrollbars-react';
-import { l as FormDevTools, F as FormDevToolsOptions } from './NNotFoundState-CgU76llk.js';
-export { m as FormDevToolsConfig, n as FormFillOverride, o as FormFillOverrides, p as NBrandingEditorValue, N as NBrandingInput, q as NBrandingPayload, r as NBrandingProvider, s as NBrandingStateProvider, t as NBrandingStateProviderProps, u as NBrandingValue, a as NEmptyState, b as NEmptyStateProps, c as NErrorState, d as NErrorStateProps, e as NFeedbackSurface, f as NForbiddenState, g as NForbiddenStateProps, h as NLoadingState, i as NLoadingStateProps, j as NNotFoundState, k as NNotFoundStateProps, v as buildFormFill, w as normalizeBranding, x as useNBranding, y as useNBrandingEditor } from './NNotFoundState-CgU76llk.js';
+import { l as FormDevTools, F as FormDevToolsOptions } from './NNotFoundState-BmGDW2Bx.js';
+export { m as FormDevToolsConfig, n as FormFillOverride, o as FormFillOverrides, p as NBrandingEditorValue, N as NBrandingInput, q as NBrandingPayload, r as NBrandingProvider, s as NBrandingStateProvider, t as NBrandingStateProviderProps, u as NBrandingValue, a as NEmptyState, b as NEmptyStateProps, c as NErrorState, d as NErrorStateProps, e as NFeedbackSurface, f as NForbiddenState, g as NForbiddenStateProps, h as NLoadingState, i as NLoadingStateProps, j as NNotFoundState, k as NNotFoundStateProps, v as buildFormFill, w as normalizeBranding, x as useNBranding, y as useNBrandingEditor } from './NNotFoundState-BmGDW2Bx.js';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import { Command as Command$1 } from 'cmdk';
 import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { resolveAvatarSrc } from './chunk-BEGOH366.mjs';
 export { isPlaceholderAvatar, resolveAvatarSrc } from './chunk-BEGOH366.mjs';
-import { NLoadingState, NErrorState, NEmptyState, useResolvedFormDevTools, useNBranding } from './chunk-26EASWUY.mjs';
-export { FormDevToolsProvider, NBrandingProvider, NBrandingStateProvider, NEmptyState, NErrorState, NForbiddenState, NLoadingState, NNotFoundState, NPageLayout, NSpinner, NajmFormatProvider, buildFormFill, normalizeBranding, useNBranding, useNBrandingEditor, useNajmFormat, useNajmFormatContext } from './chunk-26EASWUY.mjs';
+import { NLoadingState, NErrorState, NEmptyState, useResolvedFormDevTools, useNBranding } from './chunk-5ZTOCWRA.mjs';
+export { FormDevToolsProvider, NBrandingProvider, NBrandingStateProvider, NEmptyState, NErrorState, NForbiddenState, NLoadingState, NNotFoundState, NPageLayout, NSpinner, NajmFormatProvider, buildFormFill, normalizeBranding, useNBranding, useNBrandingEditor, useNajmFormat, useNajmFormatContext } from './chunk-5ZTOCWRA.mjs';
 import { normalizeImageSources, useImageChain, useNBadgeDefaults, mergeBadgeMaps, resolveStatusColor, resolveBadgeStatusLabel, colorTextClass, useResolvedPaginationLabels, useResolvedToolbarLabels } from './chunk-BDQK6ECA.mjs';
 export { DEFAULT_FEEDBACK_KEY_PREFIX, DEFAULT_PAGINATION_KEY_PREFIX, DEFAULT_TIME_ZONE, DEFAULT_TOOLBAR_KEY_PREFIX, EMPTY_DESIGN, NAJM_COLOR_TEXT_CLASSES, NAJM_STATUS_COLORS, NTableDefaultsProvider, NajmDesignEditorProvider, NajmPreferencesProvider, NajmUIProvider, buildPaginationLabels, buildToolbarLabels, colorTextClass, findStatusColor, normalizeStatusToken, resolveStatusColor, statusTextClass, useDocumentDirection, useNTableDefaults, useNajmDesignEditor, useNajmPreferencesContext, useNajmTheme, useNajmTimeZone, useResolvedToolbarLabels } from './chunk-BDQK6ECA.mjs';
 import { NajmScroll, useNajmScrollViewport, useTableStore, TableStoreContext, NTableJson } from './chunk-5JVFMOLI.mjs';
@@ -29,7 +29,7 @@ import { HexColorPicker } from 'react-colorful';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import { converter, parse, formatHsl, formatRgb, formatHex } from 'culori';
 import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
-import { Command as Command$1 } from 'cmdk';
+import { Command as Command$1, defaultFilter } from 'cmdk';
 import * as SheetPrimitive from '@radix-ui/react-dialog';
 import { create } from 'zustand';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
@@ -4564,21 +4564,39 @@ var ComboboxInput = ({ placeholder = "Select...", searchPlaceholder = "Search...
   const displayLabel = selectedItem?.label ?? (allowFreeText && value ? value : "");
   const shouldDisplayIcon = Boolean(icon) && showIcon && !value;
   const iconProps = getIconColorProps(iconColor, "h-4 w-4");
+  const [activeItem, setActiveItem] = useState(selectedItem?.label ?? normalizedItems[0]?.label ?? "");
   const trimmedQuery = query.trim();
   const queryMatchesItem = trimmedQuery !== "" && normalizedItems.some((i) => i.value === trimmedQuery || i.label.toLowerCase() === trimmedQuery.toLowerCase());
   const showFreeTextOption = allowFreeText && trimmedQuery !== "" && !queryMatchesItem;
+  const rankItems = (search) => normalizedItems.map((item, index) => ({
+    index,
+    item,
+    score: shouldFilter ? defaultFilter(item.label, search.trim(), [item.value, item.label]) : 1
+  })).filter(({ score }) => score > 0).sort((left, right) => right.score - left.score || left.index - right.index);
   const commit = (next) => {
     onChange(next);
+    setActiveItem(normalizedItems.find((item) => item.value === next)?.label ?? "");
     setOpen(false);
     setQuery("");
     onSearchChange?.("");
   };
   const updateQuery = (next) => {
+    setActiveItem(rankItems(next)[0]?.item.label ?? "");
     setQuery(next);
     onSearchChange?.(next);
   };
+  const updateActiveItem = (next) => {
+    const nextItem = normalizedItems.find((item) => item.label === next);
+    if (trimmedQuery !== "" && shouldFilter && (!nextItem || defaultFilter(nextItem.label, trimmedQuery, [nextItem.value, nextItem.label]) <= 0)) {
+      return;
+    }
+    setActiveItem(next);
+  };
   return /* @__PURE__ */ jsxs(Popover, { open, onOpenChange: (o) => {
     setOpen(o);
+    if (o) {
+      setActiveItem(selectedItem?.label ?? normalizedItems[0]?.label ?? "");
+    }
     if (!o) {
       setQuery("");
       onSearchChange?.("");
@@ -4596,6 +4614,11 @@ var ComboboxInput = ({ placeholder = "Select...", searchPlaceholder = "Search...
         "aria-label": ariaLabel,
         tabIndex: disabled ? -1 : 0,
         "aria-expanded": open,
+        onKeyDown: (event) => {
+          if (disabled || event.key !== "Enter" && event.key !== " ") return;
+          event.preventDefault();
+          setOpen(true);
+        },
         className: cn(
           "cursor-pointer outline-none data-[state=open]:border-ring",
           className
@@ -4621,38 +4644,69 @@ var ComboboxInput = ({ placeholder = "Select...", searchPlaceholder = "Search...
           pointerDismissedRef.current = false;
           triggerRef.current?.blur();
         },
-        children: /* @__PURE__ */ jsxs(Command, { shouldFilter, children: [
-          /* @__PURE__ */ jsx(
-            CommandInput,
-            {
-              placeholder: searchPlaceholder,
-              className: "h-9",
-              value: query,
-              onValueChange: updateQuery,
-              onKeyDown: (e) => {
-                if (e.key === "Enter" && showFreeTextOption) {
-                  e.preventDefault();
-                  commit(trimmedQuery);
+        children: /* @__PURE__ */ jsxs(
+          Command,
+          {
+            shouldFilter,
+            value: activeItem,
+            onValueChange: updateActiveItem,
+            children: [
+              /* @__PURE__ */ jsx(
+                CommandInput,
+                {
+                  placeholder: searchPlaceholder,
+                  className: "h-9",
+                  value: query,
+                  onValueChange: updateQuery,
+                  onKeyDown: (e) => {
+                    const rankedItems = rankItems(trimmedQuery);
+                    if (trimmedQuery !== "" && rankedItems.length > 0 && ["ArrowDown", "ArrowUp", "Home", "End"].includes(e.key)) {
+                      e.preventDefault();
+                      e.stopPropagation();
+                      const currentIndex = rankedItems.findIndex(({ item }) => item.label === activeItem);
+                      const nextIndex = e.key === "Home" ? 0 : e.key === "End" ? rankedItems.length - 1 : e.key === "ArrowDown" ? Math.min(currentIndex + 1, rankedItems.length - 1) : Math.max(currentIndex < 0 ? 0 : currentIndex - 1, 0);
+                      setActiveItem(rankedItems[nextIndex]?.item.label ?? "");
+                      return;
+                    }
+                    if (e.key !== "Enter") return;
+                    if (showFreeTextOption) {
+                      e.preventDefault();
+                      commit(trimmedQuery);
+                      return;
+                    }
+                    if (trimmedQuery !== "") {
+                      const activeMatch = normalizedItems.find((item) => item.label === activeItem);
+                      const nextItem = activeMatch && defaultFilter(
+                        activeMatch.label,
+                        trimmedQuery,
+                        [activeMatch.value, activeMatch.label]
+                      ) > 0 ? activeMatch : rankedItems[0]?.item;
+                      if (nextItem) {
+                        e.preventDefault();
+                        commit(nextItem.value);
+                      }
+                    }
+                  }
                 }
-              }
-            }
-          ),
-          /* @__PURE__ */ jsxs(CommandList, { children: [
-            /* @__PURE__ */ jsx(CommandEmpty, { children: loading ? loadingMessage : emptyMessage }),
-            /* @__PURE__ */ jsxs(CommandGroup, { children: [
-              showFreeTextOption && /* @__PURE__ */ jsxs(CommandItem, { value: trimmedQuery, onSelect: () => commit(trimmedQuery), className: "cursor-pointer", children: [
-                /* @__PURE__ */ jsx(Check, { className: "mr-2 h-4 w-4 opacity-0" }),
-                'Use "',
-                trimmedQuery,
-                '"'
-              ] }, "__free_text__"),
-              normalizedItems.map((item) => /* @__PURE__ */ jsxs(CommandItem, { value: item.label, keywords: [item.value, item.label], onSelect: () => commit(value === item.value ? "" : item.value), className: "cursor-pointer", children: [
-                /* @__PURE__ */ jsx(Check, { className: cn("mr-2 h-4 w-4", value === item.value ? "opacity-100" : "opacity-0") }),
-                item.label
-              ] }, item.value))
-            ] })
-          ] })
-        ] })
+              ),
+              /* @__PURE__ */ jsxs(CommandList, { children: [
+                /* @__PURE__ */ jsx(CommandEmpty, { children: loading ? loadingMessage : emptyMessage }),
+                /* @__PURE__ */ jsxs(CommandGroup, { children: [
+                  showFreeTextOption && /* @__PURE__ */ jsxs(CommandItem, { value: trimmedQuery, onSelect: () => commit(trimmedQuery), className: "cursor-pointer", children: [
+                    /* @__PURE__ */ jsx(Check, { className: "mr-2 h-4 w-4 opacity-0" }),
+                    'Use "',
+                    trimmedQuery,
+                    '"'
+                  ] }, "__free_text__"),
+                  normalizedItems.map((item) => /* @__PURE__ */ jsxs(CommandItem, { value: item.label, keywords: [item.value, item.label], onSelect: () => commit(value === item.value ? "" : item.value), className: "cursor-pointer", children: [
+                    /* @__PURE__ */ jsx(Check, { className: cn("mr-2 h-4 w-4", value === item.value ? "opacity-100" : "opacity-0") }),
+                    item.label
+                  ] }, item.value))
+                ] })
+              ] })
+            ]
+          }
+        )
       }
     )
   ] });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "najm-kit",
-  "version": "2.11.14",
+  "version": "2.11.16",
   "license": "MIT",
   "type": "module",
   "description": "Reusable React UI component package for Najm framework",