@eintrek/erp-shell 0.1.56 → 0.1.57

package/dist/navigation/navigation-data-helpers.d.ts

@@ -18,14 +18,56 @@ export declare function filterNavigationToolsByPermission(tools: Tool[], rulesMa
  */
 export declare function filterNavigationModulesByPermission(modules: Module[], rulesMap: PermissionRulesMap, userChildSegments: string[]): Module[];
 /**
- * Find the active top-level module id from `pathname`. Strips the org-code
- * prefix from the path (first path segment) before matching.
+ * Find the active top-level module id from `pathname`: the module whose URL
+ * (or one of whose pages' URLs) is the longest prefix of the path below the
+ * org code.
+ *
+ * Before 0.1.57 this took the first module with a page URL anywhere in the
+ * path (`includes`), so "/project" claimed /project/schedule and the sidebar,
+ * the trail and the tabs could disagree about where the user was.
  */
 export declare function getActiveModule(pathname: string, modules: Module[]): string | null;
-/** Find the active sub-module id from `pathname`. */
+/** Find the active sub-module id from `pathname`, by the same rule. */
 export declare function getActiveSubModule(pathname: string, modules: Module[]): string | null;
 /** Prepend `code` (org code) to a relative URL so `/sales` → `/O25.../sales`.
  * Absolute `http(s)://` URLs are left intact; optional `{code}` placeholder is replaced.
  * Query/hash are preserved: `/?start=1` → `/O25...?start=1` (not `/O25.../?start=1`).
  */
 export declare function buildUrlWithCode(code: string | undefined, url: string): string;
+/**
+ * The one entry in the sidebar that stands for the current page.
+ *
+ * `item` is the index of the top-level row. `sub` is the index of the
+ * sub-item under it, or null when the row itself is the entry (a one-line
+ * item, or a group on its own URL with no page of its own matching).
+ * `subPage` is the index of the page inside a collapsible sub-item.
+ */
+export interface ActiveNavEntry {
+    item: number;
+    sub: number | null;
+    subPage: number | null;
+}
+export interface ResolveActiveNavOptions {
+    /** Org code the relative URLs are prefixed with. */
+    code?: string;
+    /**
+     * Workspace chrome: a row's own URL counts with or without a trailing
+     * slash. The brand chrome has always compared it exactly.
+     */
+    workspace?: boolean;
+    /** See NavMain: a one-line item is lit by `item.isActive` alone. */
+    highlightActiveModule?: boolean;
+}
+/** "/O1/" and "/O1" are the same page; a query string never is. */
+export declare function samePage(pathname: string, url: string): boolean;
+/**
+ * Pick the single sidebar entry for `pathname`: the longest URL that covers
+ * the path, across every group. Before 0.1.57 the longest match was taken in
+ * each group separately, so /project/schedule lit both "โครงการ" (/project,
+ * under โครงการ) and "ภาพรวมแผน" (/project/schedule, under แผนงาน).
+ *
+ * Equal lengths go to the group the app marks active (`item.isActive`, from
+ * its `activeModule`), then to a page over a group row, then to the first in
+ * menu order.
+ */
+export declare function resolveActiveNav(items: Module[], pathname: string | null | undefined, { code, workspace, highlightActiveModule }?: ResolveActiveNavOptions): ActiveNavEntry | null;

package/dist/version.d.ts

@@ -2,4 +2,4 @@
  * This package's version, attached to help messages so the back office can
  * tell which shell a report came from. Keep in step with package.json.
  */
-export declare const SHELL_VERSION = "0.1.53";
+export declare const SHELL_VERSION = "0.1.57";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eintrek/erp-shell",
-  "version": "0.1.56",
+  "version": "0.1.57",
   "private": false,
   "type": "module",
   "description": "Shared frontend platform for ERP apps — HTTP client, providers, navigation, hooks.",