cursedbelt-core 2.11.0 → 2.12.0

package/dist/core/navigation/navigationSelectors.d.ts

@@ -4,6 +4,12 @@ import { type GateFn, type NavDomain, type NavGroup, type NavItem, type Navigati
  * `#tab=…` in-page target), and a trailing slash. `'/'` stays `'/'`. Used so a tab
  * variant (`/tools#tab=curl`) matches the base route (`/tools`) and `/lists/`
  * matches `/lists`.
+ *
+ * 🔴 A HASH ROUTE is the route, not an in-page target: `#/queue` and `/#/queue/x.md` are
+ * matched on `/queue` and `/queue/x.md`. Until 2.12.0 they were cut at the `#` like a tab
+ * variant, so every place of a hash-routed app normalized to `/` and `SideNav` lit ALL of them
+ * (station's first `AppShell`, 2026-10-02). The fragment is the route only when nothing but `/`
+ * stands before it and it starts with `/` — `/tools#tab=curl` is still `/tools`.
  */
 export declare function normalizeNavPath(path: string): string;
 /** A flattened, gated catalogue entry — a leaf plus where it lives (for grouping). */

package/dist/core/navigation/navigationSelectors.js

@@ -9,12 +9,22 @@ import { allowAllGate, } from './navigationModel.js';
  * `#tab=…` in-page target), and a trailing slash. `'/'` stays `'/'`. Used so a tab
  * variant (`/tools#tab=curl`) matches the base route (`/tools`) and `/lists/`
  * matches `/lists`.
+ *
+ * 🔴 A HASH ROUTE is the route, not an in-page target: `#/queue` and `/#/queue/x.md` are
+ * matched on `/queue` and `/queue/x.md`. Until 2.12.0 they were cut at the `#` like a tab
+ * variant, so every place of a hash-routed app normalized to `/` and `SideNav` lit ALL of them
+ * (station's first `AppShell`, 2026-10-02). The fragment is the route only when nothing but `/`
+ * stands before it and it starts with `/` — `/tools#tab=curl` is still `/tools`.
  */
 export function normalizeNavPath(path) {
     // Null-safe: a nav selector must never throw (a breadcrumb derivation crashing
     // white-screens the whole page). Coerce a missing/non-string path to ''.
     const s = typeof path === 'string' ? path : '';
-    let p = (s.split('#')[0] ?? '').split('?')[0]?.trim() ?? '';
+    const hashAt = s.indexOf('#');
+    const before = hashAt === -1 ? s : s.slice(0, hashAt);
+    const fragment = hashAt === -1 ? '' : s.slice(hashAt + 1);
+    const route = (before === '' || before === '/') && fragment.startsWith('/') ? fragment : before;
+    let p = route.split('?')[0]?.trim() ?? '';
     if (p.length > 1 && p.endsWith('/'))
         p = p.slice(0, -1);
     return p || '/';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedbelt-core",
-	"version": "2.11.0",
+	"version": "2.12.0",
 	"license": "ISC",
 	"type": "module",
 	"description": "Framework-agnostic core of the cursedbelt split — isomorphic domain logic. cwip below it, cursedbelt-server and cursedbelt (react) above it.",

package/src/core/navigation/navigation.spec.ts

@@ -131,6 +131,16 @@ describe('normalizeNavPath', () => {
     expect(normalizeNavPath('/')).toBe('/');
     expect(normalizeNavPath('/admin/users')).toBe('/admin/users');
   });
+
+  test('a hash route IS the route — every place of a hash-routed app must not collapse to /', () => {
+    expect(normalizeNavPath('#/queue')).toBe('/queue');
+    expect(normalizeNavPath('/#/queue/Not_Started/x.md')).toBe('/queue/Not_Started/x.md');
+    expect(normalizeNavPath('#/queue?folder=Blocked')).toBe('/queue');
+    expect(normalizeNavPath('#/')).toBe('/');
+    // An in-page target after a real path is still a tab variant, not a route.
+    expect(normalizeNavPath('/tools#/not-a-route')).toBe('/tools');
+    expect(normalizeNavPath('#section')).toBe('/');
+  });
 });
 
 describe('deriveSideNavDomains', () => {

package/src/core/navigation/navigationSelectors.ts

@@ -18,12 +18,22 @@ import {
  * `#tab=…` in-page target), and a trailing slash. `'/'` stays `'/'`. Used so a tab
  * variant (`/tools#tab=curl`) matches the base route (`/tools`) and `/lists/`
  * matches `/lists`.
+ *
+ * 🔴 A HASH ROUTE is the route, not an in-page target: `#/queue` and `/#/queue/x.md` are
+ * matched on `/queue` and `/queue/x.md`. Until 2.12.0 they were cut at the `#` like a tab
+ * variant, so every place of a hash-routed app normalized to `/` and `SideNav` lit ALL of them
+ * (station's first `AppShell`, 2026-10-02). The fragment is the route only when nothing but `/`
+ * stands before it and it starts with `/` — `/tools#tab=curl` is still `/tools`.
  */
 export function normalizeNavPath(path: string): string {
   // Null-safe: a nav selector must never throw (a breadcrumb derivation crashing
   // white-screens the whole page). Coerce a missing/non-string path to ''.
   const s = typeof path === 'string' ? path : '';
-  let p = (s.split('#')[0] ?? '').split('?')[0]?.trim() ?? '';
+  const hashAt = s.indexOf('#');
+  const before = hashAt === -1 ? s : s.slice(0, hashAt);
+  const fragment = hashAt === -1 ? '' : s.slice(hashAt + 1);
+  const route = (before === '' || before === '/') && fragment.startsWith('/') ? fragment : before;
+  let p = route.split('?')[0]?.trim() ?? '';
   if (p.length > 1 && p.endsWith('/')) p = p.slice(0, -1);
   return p || '/';
 }