@furystack/shades 12.2.5 → 12.3.0

package/esm/shade.spec.js

@@ -1,6 +1,6 @@
 import { Injector } from '@furystack/inject';
-import { sleepAsync, usingAsync } from '@furystack/utils';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { ObservableValue, sleepAsync, usingAsync } from '@furystack/utils';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { initializeShadeRoot } from './initialize.js';
 import { createComponent } from './shade-component.js';
 import { flushUpdates, Shade } from './shade.js';
@@ -82,6 +82,97 @@ describe('Shade edge cases', () => {
             });
         });
     });
+    describe('disconnected component should not re-render', () => {
+        it('should not re-render when updateComponent is called after removal', async () => {
+            await usingAsync(new Injector(), async (injector) => {
+                const rootElement = document.getElementById('root');
+                const renderCounter = vi.fn();
+                const ExampleComponent = Shade({
+                    shadowDomName: 'shade-no-render-after-disconnect',
+                    render: () => {
+                        renderCounter();
+                        return createComponent("div", null, "content");
+                    },
+                });
+                initializeShadeRoot({
+                    injector,
+                    rootElement,
+                    jsxElement: createComponent(ExampleComponent, null),
+                });
+                await flushUpdates();
+                const element = document.querySelector('shade-no-render-after-disconnect');
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+                element.remove();
+                await flushUpdates();
+                element.updateComponent();
+                await flushUpdates();
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+            });
+        });
+        it('should not re-render when updateComponentSync is called after removal', async () => {
+            await usingAsync(new Injector(), async (injector) => {
+                const rootElement = document.getElementById('root');
+                const renderCounter = vi.fn();
+                const ExampleComponent = Shade({
+                    shadowDomName: 'shade-no-sync-render-after-disconnect',
+                    render: () => {
+                        renderCounter();
+                        return createComponent("div", null, "content");
+                    },
+                });
+                initializeShadeRoot({
+                    injector,
+                    rootElement,
+                    jsxElement: createComponent(ExampleComponent, null),
+                });
+                await flushUpdates();
+                const element = document.querySelector('shade-no-sync-render-after-disconnect');
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+                element.remove();
+                await flushUpdates();
+                element.updateComponentSync();
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+            });
+        });
+        it('should not re-render when an observable fires during disposal', async () => {
+            await usingAsync(new Injector(), async (injector) => {
+                const rootElement = document.getElementById('root');
+                const renderCounter = vi.fn();
+                const obs = new ObservableValue(0);
+                const ExampleComponent = Shade({
+                    shadowDomName: 'shade-no-render-during-disposal',
+                    render: ({ useObservable, useDisposable }) => {
+                        useObservable('obs', obs);
+                        useDisposable('cleanup', () => ({
+                            [Symbol.dispose]: () => {
+                                obs.setValue(999);
+                            },
+                        }));
+                        renderCounter();
+                        return createComponent("div", null, obs.getValue());
+                    },
+                });
+                initializeShadeRoot({
+                    injector,
+                    rootElement,
+                    jsxElement: createComponent(ExampleComponent, null),
+                });
+                await flushUpdates();
+                const element = document.querySelector('shade-no-render-during-disposal');
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+                element.remove();
+                await flushUpdates();
+                await sleepAsync(10);
+                expect(element.getRenderCount()).toBe(1);
+                expect(renderCounter).toBeCalledTimes(1);
+            });
+        });
+    });
     describe('BroadcastChannel cross-tab communication', () => {
         it('should update stored state when receiving BroadcastChannel message with matching key', async () => {
             const mockedStorage = new Map();

package/esm/shade.spec.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furystack/shades",
-  "version": "12.2.5",
+  "version": "12.3.0",
   "description": "A lightweight UI framework for FuryStack with JSX support",
   "type": "module",
   "scripts": {

package/src/components/nested-router.spec.tsx

@@ -4,6 +4,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 import { initializeShadeRoot } from '../initialize.js'
 import { createComponent } from '../shade-component.js'
 import { flushUpdates } from '../shade.js'
+import { RouteMatchService } from '../services/route-match-service.js'
 import {
   buildMatchChain,
   findDivergenceIndex,
@@ -12,7 +13,7 @@ import {
   type MatchChainEntry,
   type NestedRoute,
 } from './nested-router.js'
-import { RouteLink } from './route-link.js'
+import { NestedRouteLink } from './nested-route-link.js'
 
 describe('buildMatchChain', () => {
   it('should match a simple leaf route', () => {
@@ -320,18 +321,18 @@ describe('NestedRouter lifecycle hooks', () => {
         rootElement,
         jsxElement: (
           <div>
-            <RouteLink id="child-a" href="/parent/child-a">
+            <NestedRouteLink id="child-a" href="/parent/child-a">
               child-a
-            </RouteLink>
-            <RouteLink id="child-b" href="/parent/child-b">
+            </NestedRouteLink>
+            <NestedRouteLink id="child-b" href="/parent/child-b">
               child-b
-            </RouteLink>
-            <RouteLink id="other" href="/other">
+            </NestedRouteLink>
+            <NestedRouteLink id="other" href="/other">
               other
-            </RouteLink>
-            <RouteLink id="nowhere" href="/nowhere">
+            </NestedRouteLink>
+            <NestedRouteLink id="nowhere" href="/nowhere">
               nowhere
-            </RouteLink>
+            </NestedRouteLink>
             <NestedRouter
               routes={{
                 '/parent': {
@@ -456,15 +457,15 @@ describe('NestedRouter latest-wins on rapid navigation', () => {
         rootElement,
         jsxElement: (
           <div>
-            <RouteLink id="go-a" href="/route-a">
+            <NestedRouteLink id="go-a" href="/route-a">
               a
-            </RouteLink>
-            <RouteLink id="go-b" href="/route-b">
+            </NestedRouteLink>
+            <NestedRouteLink id="go-b" href="/route-b">
               b
-            </RouteLink>
-            <RouteLink id="go-c" href="/route-c">
+            </NestedRouteLink>
+            <NestedRouteLink id="go-c" href="/route-c">
               c
-            </RouteLink>
+            </NestedRouteLink>
             <NestedRouter
               routes={{
                 '/route-a': {
@@ -538,12 +539,12 @@ describe('NestedRouter lifecycle element scope', () => {
         rootElement,
         jsxElement: (
           <div>
-            <RouteLink id="child-a" href="/parent/child-a">
+            <NestedRouteLink id="child-a" href="/parent/child-a">
               child-a
-            </RouteLink>
-            <RouteLink id="child-b" href="/parent/child-b">
+            </NestedRouteLink>
+            <NestedRouteLink id="child-b" href="/parent/child-b">
               child-b
-            </RouteLink>
+            </NestedRouteLink>
             <NestedRouter
               routes={{
                 '/parent': {
@@ -631,15 +632,15 @@ describe('NestedRouter flat routes', () => {
         rootElement,
         jsxElement: (
           <div>
-            <RouteLink id="home" href="/">
+            <NestedRouteLink id="home" href="/">
               home
-            </RouteLink>
-            <RouteLink id="about" href="/about">
+            </NestedRouteLink>
+            <NestedRouteLink id="about" href="/about">
               about
-            </RouteLink>
-            <RouteLink id="contact" href="/contact">
+            </NestedRouteLink>
+            <NestedRouteLink id="contact" href="/contact">
               contact
-            </RouteLink>
+            </NestedRouteLink>
             <NestedRouter
               routes={{
                 '/about': { component: () => <div id="content">about-page</div> },
@@ -790,15 +791,15 @@ describe('NestedRouter route param changes', () => {
         rootElement,
         jsxElement: (
           <div>
-            <RouteLink id="user-1" href="/users/1">
+            <NestedRouteLink id="user-1" href="/users/1">
               User 1
-            </RouteLink>
-            <RouteLink id="user-2" href="/users/2">
+            </NestedRouteLink>
+            <NestedRouteLink id="user-2" href="/users/2">
               User 2
-            </RouteLink>
-            <RouteLink id="user-3" href="/users/3">
+            </NestedRouteLink>
+            <NestedRouteLink id="user-3" href="/users/3">
               User 3
-            </RouteLink>
+            </NestedRouteLink>
             <NestedRouter
               routes={{
                 '/users/:id': {
@@ -866,12 +867,12 @@ describe('NestedRouter route param changes', () => {
         rootElement,
         jsxElement: (
           <div>
-            <RouteLink id="alpha-dash" href="/org/alpha/dashboard">
+            <NestedRouteLink id="alpha-dash" href="/org/alpha/dashboard">
               Alpha Dashboard
-            </RouteLink>
-            <RouteLink id="beta-dash" href="/org/beta/dashboard">
+            </NestedRouteLink>
+            <NestedRouteLink id="beta-dash" href="/org/beta/dashboard">
               Beta Dashboard
-            </RouteLink>
+            </NestedRouteLink>
             <NestedRouter
               routes={{
                 '/org/:orgId': {
@@ -919,3 +920,107 @@ describe('NestedRouter route param changes', () => {
     })
   })
 })
+
+describe('NestedRouter + RouteMatchService integration', () => {
+  beforeEach(() => {
+    document.body.innerHTML = '<div id="root"></div>'
+  })
+  afterEach(() => {
+    document.body.innerHTML = ''
+  })
+
+  it('should update RouteMatchService with the current match chain on navigation', async () => {
+    history.pushState(null, '', '/parent/child-a')
+
+    await usingAsync(new Injector(), async (injector) => {
+      const rootElement = document.getElementById('root') as HTMLDivElement
+      const routeMatchService = injector.getInstance(RouteMatchService)
+
+      const parentRoute: NestedRoute = {
+        meta: { title: 'Parent' },
+        component: ({ outlet }) => <div>{outlet ?? <div>parent-index</div>}</div>,
+        children: {
+          '/child-a': {
+            meta: { title: 'Child A' },
+            component: () => <div id="content">child-a</div>,
+          },
+          '/child-b': {
+            meta: { title: 'Child B' },
+            component: () => <div id="content">child-b</div>,
+          },
+        },
+      }
+
+      initializeShadeRoot({
+        injector,
+        rootElement,
+        jsxElement: (
+          <div>
+            <NestedRouteLink id="child-a" href="/parent/child-a">
+              child-a
+            </NestedRouteLink>
+            <NestedRouteLink id="child-b" href="/parent/child-b">
+              child-b
+            </NestedRouteLink>
+            <NestedRouteLink id="nowhere" href="/nowhere">
+              nowhere
+            </NestedRouteLink>
+            <NestedRouter routes={{ '/parent': parentRoute }} notFound={<div id="content">not found</div>} />
+          </div>
+        ),
+      })
+
+      // Initial load
+      await flushUpdates()
+      const initialChain = routeMatchService.currentMatchChain.getValue()
+      expect(initialChain).toHaveLength(2)
+      expect(initialChain[0].route.meta?.title).toBe('Parent')
+      expect(initialChain[1].route.meta?.title).toBe('Child A')
+
+      // Navigate to sibling child
+      document.getElementById('child-b')?.click()
+      await flushUpdates()
+      const updatedChain = routeMatchService.currentMatchChain.getValue()
+      expect(updatedChain).toHaveLength(2)
+      expect(updatedChain[0].route.meta?.title).toBe('Parent')
+      expect(updatedChain[1].route.meta?.title).toBe('Child B')
+
+      // Navigate to not-found
+      document.getElementById('nowhere')?.click()
+      await flushUpdates()
+      const notFoundChain = routeMatchService.currentMatchChain.getValue()
+      expect(notFoundChain).toEqual([])
+    })
+  })
+
+  it('should expose match params through RouteMatchService', async () => {
+    history.pushState(null, '', '/users/42')
+
+    await usingAsync(new Injector(), async (injector) => {
+      const rootElement = document.getElementById('root') as HTMLDivElement
+      const routeMatchService = injector.getInstance(RouteMatchService)
+
+      initializeShadeRoot({
+        injector,
+        rootElement,
+        jsxElement: (
+          <NestedRouter
+            routes={{
+              '/users/:id': {
+                meta: {
+                  title: ({ match }: { match: { params: Record<string, string> } }) => `User ${match.params.id}`,
+                },
+                component: ({ match }) => <div id="content">user-{(match.params as { id: string }).id}</div>,
+              },
+            }}
+          />
+        ),
+      })
+
+      await flushUpdates()
+      const chain = routeMatchService.currentMatchChain.getValue()
+      expect(chain).toHaveLength(1)
+      expect(chain[0].match.params).toEqual({ id: '42' })
+    })
+  })
+})

package/src/components/nested-router.tsx

@@ -1,11 +1,46 @@
+import type { Injector } from '@furystack/inject'
 import { ObservableAlreadyDisposedError } from '@furystack/utils'
 import type { MatchOptions, MatchResult } from 'path-to-regexp'
 import { match } from 'path-to-regexp'
 import type { RenderOptions } from '../models/render-options.js'
 import { LocationService } from '../services/location-service.js'
+import { RouteMatchService } from '../services/route-match-service.js'
 import { createComponent, setRenderMode } from '../shade-component.js'
 import { Shade } from '../shade.js'
 
+/**
+ * Options passed to a dynamic title resolver function.
+ * @typeParam TMatchResult - The type of matched URL parameters
+ */
+export type TitleResolverOptions<TMatchResult = unknown> = {
+  match: MatchResult<TMatchResult extends object ? TMatchResult : object>
+  injector: Injector
+}
+
+/**
+ * Metadata associated with a route entry.
+ * Used by consumers (breadcrumbs, document title, navigation trees) to
+ * derive display information from the route hierarchy.
+ *
+ * This is an `interface` so that applications can augment it with custom fields
+ * via declaration merging:
+ *
+ * @example
+ * ```typescript
+ * declare module '@furystack/shades' {
+ *   interface NestedRouteMeta {
+ *     icon?: IconDefinition
+ *     hidden?: boolean
+ *   }
+ * }
+ * ```
+ *
+ * @typeParam TMatchResult - The type of matched URL parameters
+ */
+export interface NestedRouteMeta<TMatchResult = unknown> {
+  title?: string | ((options: TitleResolverOptions<TMatchResult>) => string | Promise<string>)
+}
+
 /**
  * A single route entry in a NestedRouter configuration.
  * Unlike flat `Route`, the URL is the Record key (not a field), and the
@@ -13,6 +48,7 @@ import { Shade } from '../shade.js'
  * @typeParam TMatchResult - The type of matched URL parameters
  */
 export type NestedRoute<TMatchResult = unknown> = {
+  meta?: NestedRouteMeta<TMatchResult>
   component: (options: {
     currentUrl: string
     match: MatchResult<TMatchResult extends object ? TMatchResult : object>
@@ -216,6 +252,7 @@ export const NestedRouter = Shade<NestedRouterProps>({
             }
             if (version !== versionRef.current) return
             setState({ matchChain: newChain, jsx: newResult.jsx, chainElements: newResult.chainElements })
+            injector.getInstance(RouteMatchService).currentMatchChain.setValue(newChain)
 
             // Call onVisit for routes that are being entered (from divergence point to end of new chain)
             for (let i = divergeIndex; i < newChain.length; i++) {
@@ -237,6 +274,7 @@ export const NestedRouter = Shade<NestedRouterProps>({
             jsx: options.props.notFound || <div />,
             chainElements: [],
           })
+          injector.getInstance(RouteMatchService).currentMatchChain.setValue([])
         }
       } catch (e) {
         if (!(e instanceof ObservableAlreadyDisposedError)) {

package/src/services/index.ts

@@ -1,2 +1,4 @@
 export * from './location-service.js'
+export * from './route-match-service.js'
+export * from './route-meta-utils.js'
 export * from './screen-service.js'

package/src/services/route-match-service.spec.ts

@@ -0,0 +1,45 @@
+import { describe, expect, it, vi } from 'vitest'
+import type { MatchChainEntry } from '../components/nested-router.js'
+import { RouteMatchService } from './route-match-service.js'
+
+describe('RouteMatchService', () => {
+  it('should start with an empty match chain', () => {
+    using service = new RouteMatchService()
+    expect(service.currentMatchChain.getValue()).toEqual([])
+  })
+
+  it('should update the match chain', () => {
+    using service = new RouteMatchService()
+    const chain: MatchChainEntry[] = [
+      {
+        route: { component: () => ({}) as JSX.Element },
+        match: { path: '/about', params: {} },
+      },
+    ]
+    service.currentMatchChain.setValue(chain)
+    expect(service.currentMatchChain.getValue()).toBe(chain)
+  })
+
+  it('should notify subscribers on match chain change', () => {
+    using service = new RouteMatchService()
+    const listener = vi.fn()
+    using _subscription = service.currentMatchChain.subscribe(listener)
+
+    const chain: MatchChainEntry[] = [
+      {
+        route: { meta: { title: 'Home' }, component: () => ({}) as JSX.Element },
+        match: { path: '/', params: {} },
+      },
+    ]
+    service.currentMatchChain.setValue(chain)
+
+    expect(listener).toHaveBeenCalledWith(chain)
+  })
+
+  it('should dispose the observable on service disposal', () => {
+    const service = new RouteMatchService()
+    service[Symbol.dispose]()
+
+    expect(() => service.currentMatchChain.setValue([])).toThrow()
+  })
+})

package/src/services/route-match-service.ts

@@ -0,0 +1,17 @@
+import { Injectable } from '@furystack/inject'
+import { ObservableValue } from '@furystack/utils'
+import type { MatchChainEntry } from '../components/nested-router.js'
+
+/**
+ * Singleton service that exposes the current match chain from the nearest
+ * NestedRouter as an observable. Consumers (breadcrumbs, document title,
+ * navigation trees) subscribe to this instead of re-running route matching.
+ */
+@Injectable({ lifetime: 'singleton' })
+export class RouteMatchService implements Disposable {
+  public readonly currentMatchChain = new ObservableValue<MatchChainEntry[]>([])
+
+  public [Symbol.dispose]() {
+    this.currentMatchChain[Symbol.dispose]()
+  }
+}