@kopexa/sidebar 17.2.1 → 17.3.0

package/dist/v2/types.d.mts

@@ -32,7 +32,10 @@ type SidebarV2PanelItem = {
     label: string;
     href: string;
     icon?: SidebarV2Icon;
+    /** Count pill after the label (e.g. number of open items). */
     badge?: number | string;
+    /** Status chip after the label, e.g. "Preview", "Beta", "Neu". */
+    tag?: string;
     /** Stable key; defaults to href. */
     value?: string;
 } | {
@@ -72,9 +75,25 @@ type SidebarV2RailEntry = {
     slot?: "top" | "bottom";
 };
 type SidebarV2Nav = SidebarV2RailEntry[];
+/**
+ * A route's identity is its pathname — query (`?`) and hash (`#`) are transient
+ * (filters, tabs-by-query, scroll anchors) and never part of nav identity. Strip
+ * them (and any trailing slash) before comparing, so a nav href that carries an
+ * incidental `?param` still matches the bare route. `/` is preserved.
+ */
+declare function normalizePath(href: string): string;
+/**
+ * Length of the match between an already-normalized `currentPath` and a target
+ * `href`, or `-1` when it doesn't match. Exact and ancestor-prefix matches both
+ * return the target's length; callers keep the longest (most specific) one so the
+ * panel/item that owns the deepest matching route wins — never a shorter prefix
+ * from an unrelated entry. The boundary is `/`, so `/risks` never matches
+ * `/risks-archive`.
+ */
+declare function pathMatchLength(currentPath: string, href: string): number;
 declare function panelItemHasChildren(item: SidebarV2PanelItem): item is Extract<SidebarV2PanelItem, {
     children: SidebarV2SubItem[];
 }>;
 declare function panelItemIsSection(item: SidebarV2PanelItem): item is SidebarV2PanelSection;
 
-export { type SidebarV2Icon, type SidebarV2LinkProps, type SidebarV2Nav, type SidebarV2PanelItem, type SidebarV2PanelSection, type SidebarV2RailEntry, type SidebarV2SubItem, panelItemHasChildren, panelItemIsSection };
+export { type SidebarV2Icon, type SidebarV2LinkProps, type SidebarV2Nav, type SidebarV2PanelItem, type SidebarV2PanelSection, type SidebarV2RailEntry, type SidebarV2SubItem, normalizePath, panelItemHasChildren, panelItemIsSection, pathMatchLength };

package/dist/v2/types.d.ts

@@ -32,7 +32,10 @@ type SidebarV2PanelItem = {
     label: string;
     href: string;
     icon?: SidebarV2Icon;
+    /** Count pill after the label (e.g. number of open items). */
     badge?: number | string;
+    /** Status chip after the label, e.g. "Preview", "Beta", "Neu". */
+    tag?: string;
     /** Stable key; defaults to href. */
     value?: string;
 } | {
@@ -72,9 +75,25 @@ type SidebarV2RailEntry = {
     slot?: "top" | "bottom";
 };
 type SidebarV2Nav = SidebarV2RailEntry[];
+/**
+ * A route's identity is its pathname — query (`?`) and hash (`#`) are transient
+ * (filters, tabs-by-query, scroll anchors) and never part of nav identity. Strip
+ * them (and any trailing slash) before comparing, so a nav href that carries an
+ * incidental `?param` still matches the bare route. `/` is preserved.
+ */
+declare function normalizePath(href: string): string;
+/**
+ * Length of the match between an already-normalized `currentPath` and a target
+ * `href`, or `-1` when it doesn't match. Exact and ancestor-prefix matches both
+ * return the target's length; callers keep the longest (most specific) one so the
+ * panel/item that owns the deepest matching route wins — never a shorter prefix
+ * from an unrelated entry. The boundary is `/`, so `/risks` never matches
+ * `/risks-archive`.
+ */
+declare function pathMatchLength(currentPath: string, href: string): number;
 declare function panelItemHasChildren(item: SidebarV2PanelItem): item is Extract<SidebarV2PanelItem, {
     children: SidebarV2SubItem[];
 }>;
 declare function panelItemIsSection(item: SidebarV2PanelItem): item is SidebarV2PanelSection;
 
-export { type SidebarV2Icon, type SidebarV2LinkProps, type SidebarV2Nav, type SidebarV2PanelItem, type SidebarV2PanelSection, type SidebarV2RailEntry, type SidebarV2SubItem, panelItemHasChildren, panelItemIsSection };
+export { type SidebarV2Icon, type SidebarV2LinkProps, type SidebarV2Nav, type SidebarV2PanelItem, type SidebarV2PanelSection, type SidebarV2RailEntry, type SidebarV2SubItem, normalizePath, panelItemHasChildren, panelItemIsSection, pathMatchLength };

package/dist/v2/types.js

@@ -21,10 +21,23 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/v2/types.ts
 var types_exports = {};
 __export(types_exports, {
+  normalizePath: () => normalizePath,
   panelItemHasChildren: () => panelItemHasChildren,
-  panelItemIsSection: () => panelItemIsSection
+  panelItemIsSection: () => panelItemIsSection,
+  pathMatchLength: () => pathMatchLength
 });
 module.exports = __toCommonJS(types_exports);
+function normalizePath(href) {
+  const path = href.split("#")[0].split("?")[0].replace(/\/+$/, "");
+  return path === "" ? "/" : path;
+}
+function pathMatchLength(currentPath, href) {
+  const target = normalizePath(href);
+  if (currentPath === target) return target.length;
+  if (target !== "/" && currentPath.startsWith(`${target}/`))
+    return target.length;
+  return -1;
+}
 function panelItemHasChildren(item) {
   return "children" in item && Array.isArray(item.children);
 }
@@ -33,6 +46,8 @@ function panelItemIsSection(item) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  normalizePath,
   panelItemHasChildren,
-  panelItemIsSection
+  panelItemIsSection,
+  pathMatchLength
 });

package/dist/v2/types.mjs

@@ -1,9 +1,13 @@
 "use client";
 import {
+  normalizePath,
   panelItemHasChildren,
-  panelItemIsSection
-} from "../chunk-SDMGFB6V.mjs";
+  panelItemIsSection,
+  pathMatchLength
+} from "../chunk-BFZFZSUC.mjs";
 export {
+  normalizePath,
   panelItemHasChildren,
-  panelItemIsSection
+  panelItemIsSection,
+  pathMatchLength
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kopexa/sidebar",
-  "version": "17.2.1",
+  "version": "17.3.0",
   "description": "",
   "keywords": [
     "sidebar"
@@ -28,19 +28,19 @@
     "motion": ">=12.23.6",
     "react": ">=19.0.0-rc.0",
     "react-dom": ">=19.0.0-rc.0",
-    "@kopexa/theme": "17.33.1"
+    "@kopexa/theme": "17.34.0"
   },
   "dependencies": {
     "@radix-ui/react-slot": "^1.2.4",
-    "@kopexa/button": "17.0.92",
-    "@kopexa/drawer": "17.2.57",
-    "@kopexa/icons": "17.10.21",
-    "@kopexa/react-utils": "17.1.34",
-    "@kopexa/input": "17.0.92",
-    "@kopexa/separator": "17.0.92",
-    "@kopexa/shared-utils": "17.0.92",
-    "@kopexa/tooltip": "17.2.57",
-    "@kopexa/use-is-mobile": "17.0.92"
+    "@kopexa/drawer": "17.2.58",
+    "@kopexa/icons": "17.10.22",
+    "@kopexa/input": "17.0.93",
+    "@kopexa/use-is-mobile": "17.0.93",
+    "@kopexa/react-utils": "17.1.35",
+    "@kopexa/tooltip": "17.2.58",
+    "@kopexa/button": "17.0.93",
+    "@kopexa/shared-utils": "17.0.93",
+    "@kopexa/separator": "17.0.93"
   },
   "clean-package": "../../../clean-package.config.json",
   "module": "dist/index.mjs",

package/dist/chunk-SDMGFB6V.mjs

@@ -1,14 +0,0 @@
-"use client";
-
-// src/v2/types.ts
-function panelItemHasChildren(item) {
-  return "children" in item && Array.isArray(item.children);
-}
-function panelItemIsSection(item) {
-  return "section" in item;
-}
-
-export {
-  panelItemHasChildren,
-  panelItemIsSection
-};