lit-ui-router 1.2.4 → 1.3.0

package/README.md

@@ -7,4 +7,66 @@
 [![Website](https://img.shields.io/website?url=https%3A%2F%2Flit-ui-router.dev)](https://lit-ui-router.dev)
 [![codecov](https://codecov.io/gh/simshanith/lit-ui-router/graph/badge.svg?component=lit-ui-router)](https://app.codecov.io/gh/simshanith/lit-ui-router?components%5B0%5D=lit-ui-router)
 
-A UI Router implementation for Lit.
+A [UI-Router](https://ui-router.github.io/) implementation for [Lit](https://lit.dev/).
+
+## Quick Start
+
+```ts
+import { UIRouterLit } from 'lit-ui-router';
+import { hashLocationPlugin } from '@uirouter/core';
+import { html } from 'lit';
+
+const router = new UIRouterLit();
+router.plugin(hashLocationPlugin);
+
+router.stateRegistry.register([
+  { name: 'home', url: '/', component: () => html`<h1>Home</h1>` },
+  { name: 'about', url: '/about', component: () => html`<h1>About</h1>` },
+]);
+
+router.start();
+```
+
+## Component Styles
+
+| Style               | Best For                      | Example                    |
+| ------------------- | ----------------------------- | -------------------------- |
+| Template function   | Simple views, prototyping     | `` () => html`...` ``      |
+| Template with props | Views needing params/resolves | `` (props) => html`...` `` |
+| LitElement class    | Complex views with lifecycle  | `MyComponent`              |
+
+## Reacting to Transitions
+
+Any element (routed or not) can stay synchronized with the router using the
+`TransitionController` reactive controller. It registers transition hooks when
+the host connects, calls `host.requestUpdate()` on matching transitions, and
+deregisters everything when the host disconnects — no manual `requestUpdate()`
+plumbing or leaked hooks.
+
+```ts
+import { TransitionController } from 'lit-ui-router';
+
+class NavHeader extends LitElement {
+  private transitions = new TransitionController(this);
+
+  render() {
+    // Re-evaluated after every successful transition
+    return html`Current state: ${this.transitions.current?.name}`;
+  }
+}
+```
+
+Scope it to specific states or react to parameter changes with a callback:
+
+```ts
+class UserDetail extends LitElement {
+  private transitions = new TransitionController(this, {
+    criteria: { to: 'users.detail' },
+    callback: () => this.loadUser(this.transitions.params.userId),
+  });
+}
+```
+
+## Documentation
+
+Visit [lit-ui-router.dev](https://lit-ui-router.dev) for full documentation, tutorials, and API reference.

package/dist/custom-elements.json

@@ -272,6 +272,25 @@
               },
               "description": "Root <code>uiRouter</code> singleton.\nIf not provided, the element creates and assigns a new instance."
             },
+            {
+              "kind": "method",
+              "name": "seekRouter",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "UIRouterLit | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "candidate",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ],
+              "description": "Discovers the UIRouterLit instance provided by the nearest\nenclosing <code>&lt;ui-router&gt;</code> element.\n\nDispatches a bubbling, composed <code>ui-router-context</code> event from\nthe candidate element; the enclosing <code>&lt;ui-router&gt;</code>\nanswers it with its router instance. Returns <code>undefined</code> when\nthe candidate is not inside a <code>&lt;ui-router&gt;</code> (e.g. not\nyet connected).\n\nThis is the dependency-injection primitive for integrating external\nreactivity systems (state stores, controllers) with the router context —\ncall it from <code>hostConnected()</code> / <code>connectedCallback()</code>\ninstead of prop-drilling the router instance."
+            },
             {
               "kind": "field",
               "name": "onUiRouterContextEvent",

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './interface.js';
 export * from './core.js';
+export * from './transition-controller.js';
 export * from './ui-router.js';
 export * from './ui-view.js';
 export * from './ui-sref.js';

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from './interface.js';
 export * from './core.js';
+export * from './transition-controller.js';
 export * from './ui-router.js';
 export * from './ui-view.js';
 export * from './ui-sref.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}

package/dist/interface.d.ts

@@ -166,21 +166,31 @@ export interface UIViewInjectedProps<T extends DefaultResolvesType = DefaultReso
 /**
  * A function that returns a Lit TemplateResult for rendering in a `<ui-view>`.
  *
- * This is one of the component types that can be used in state declarations.
- * The function receives [[UIViewInjectedProps]] as its argument.
- * [[NormalizedLitViewDeclaration.component]] uses this signature.
+ * This is the **simplest way** to define route components - no LitElement class needed.
+ * The function optionally receives [[UIViewInjectedProps]] as its argument.
  *
- * @example
+ * @example Simple template (no props needed)
  * ```ts
- * const HomeView: RoutedLitTemplate = (props) => {
- *   return html`<h1>Welcome Home</h1>`;
- * };
+ * const HomeView: RoutedLitTemplate = () => html`<h1>Welcome Home</h1>`;
  *
- * router.stateRegistry.register({
- *   name: 'home',
- *   url: '/home',
- *   component: HomeView
- * });
+ * // Or use directly inline in a state declaration:
+ * { name: 'home', url: '/', component: () => html`<h1>Home</h1>` }
+ * ```
+ *
+ * @example With route parameters
+ * ```ts
+ * const UserView: RoutedLitTemplate = (props) => html`
+ *   <h1>User: ${props?.transition?.params().id}</h1>
+ * `;
+ * ```
+ *
+ * @example With resolved data (typed)
+ * ```ts
+ * interface UserResolves { user: { name: string } }
+ *
+ * const UserDetail: RoutedLitTemplate<UserResolves> = (props) => html`
+ *   <h1>${props?.resolves?.user?.name}</h1>
+ * `;
  * ```
  *
  * @category types
@@ -266,38 +276,51 @@ export type LitViewDeclaration<T extends DefaultResolvesType = DefaultResolvesTy
  * State declaration interface for Lit applications.
  *
  * Extends the core [[StateDeclaration]] with Lit-specific component support.
+ * The `component` property accepts template functions, LitElement classes, or both.
  *
- * @example Basic state with template function
+ * @example Simplest: inline template function
  * ```ts
- * const homeState: LitStateDeclaration = {
- *   name: 'home',
- *   url: '/home',
- *   component: () => html`<h1>Home</h1>`
- * };
+ * { name: 'home', url: '/', component: () => html`<h1>Home</h1>` }
+ * ```
+ *
+ * @example Template with route parameters
+ * ```ts
+ * {
+ *   name: 'user',
+ *   url: '/user/:id',
+ *   component: (props) => html`<h1>User ${props?.transition?.params().id}</h1>`
+ * }
  * ```
  *
- * @example State with LitElement class
+ * @example Template with resolved data
  * ```ts
- * const usersState: LitStateDeclaration = {
+ * {
  *   name: 'users',
  *   url: '/users',
- *   component: UserListElement,
- *   resolve: [
- *     { token: 'users', resolveFn: () => fetch('/api/users').then(r => r.json()) }
- *   ]
- * };
+ *   component: (props) => html`
+ *     <ul>${props?.resolves?.users?.map(u => html`<li>${u.name}</li>`)}</ul>
+ *   `,
+ *   resolve: [{ token: 'users', resolveFn: () => fetch('/api/users').then(r => r.json()) }]
+ * }
+ * ```
+ *
+ * @example LitElement class (for complex components)
+ * ```ts
+ * { name: 'dashboard', url: '/dashboard', component: DashboardElement }
  * ```
  *
  * @example Nested states
  * ```ts
  * const states: LitStateDeclaration[] = [
  *   { name: 'app', abstract: true, component: AppShell },
- *   { name: 'app.home', url: '/home', component: HomeView },
+ *   { name: 'app.home', url: '/home', component: () => html`<h1>Home</h1>` },
  *   { name: 'app.users', url: '/users', component: UsersView }
  * ];
  * ```
  *
  * @see [[StateDeclaration]]
+ * @see {@link RoutedLitTemplate}
+ * @see {@link RoutedLitElement}
  *
  * @category types
  */

package/dist/transition-controller.d.ts

@@ -0,0 +1,156 @@
+import { HookMatchCriteria, RawParams, StateDeclaration, StateOrName, Transition, UIRouter, UIRouterGlobals } from '@uirouter/core';
+import { ReactiveController, ReactiveControllerHost } from 'lit';
+/**
+ * Transition lifecycle events that a [[TransitionController]] can observe.
+ *
+ * Each value corresponds to a
+ * {@link https://ui-router.github.io/core/docs/latest/interfaces/_transition_interface_.ihookregistry.html | TransitionService hook registry}
+ * method of the same name.
+ *
+ * @category controllers
+ */
+export type TransitionEventType = 'onBefore' | 'onStart' | 'onSuccess' | 'onError';
+/**
+ * The reason a [[TransitionController]] invoked its callback.
+ *
+ * Either one of the observed [[TransitionEventType]] hooks fired, or the
+ * host element (re)connected to the DOM and the controller synchronized
+ * with the router's current state (`'hostConnected'`).
+ *
+ * @category controllers
+ */
+export type TransitionCallbackReason = TransitionEventType | 'hostConnected';
+/**
+ * A callback invoked by [[TransitionController]] whenever the host is
+ * synchronized with the router.
+ *
+ * For `'onBefore'` and `'onStart'` reasons, the returned value is passed
+ * back to UI-Router as a
+ * {@link https://ui-router.github.io/core/docs/latest/modules/_transition_interface_.html#hookresult | HookResult},
+ * so the callback may cancel or redirect the pending transition.
+ *
+ * @param transition - The [[Transition]] which triggered the callback.
+ *   For the `'hostConnected'` reason this is the most recent successful
+ *   transition, or `undefined` when no transition has succeeded yet.
+ * @param reason - Why the callback was invoked (see [[TransitionCallbackReason]]).
+ *
+ * @category controllers
+ */
+export type TransitionCallback = (transition: Transition | undefined, reason: TransitionCallbackReason) => unknown;
+/**
+ * Options for [[TransitionController]].
+ *
+ * @category controllers
+ */
+export interface TransitionControllerOptions {
+    /**
+     * The [[UIRouter]] instance to observe.
+     *
+     * When omitted, the controller discovers the router from an ancestor
+     * <code>&lt;ui-router&gt;</code> (or <code>&lt;ui-view&gt;</code>) via the
+     * `ui-router-context` event when the host connects.
+     */
+    router?: UIRouter;
+    /**
+     * {@link https://ui-router.github.io/core/docs/latest/interfaces/_transition_interface_.hookmatchcriteria.html | HookMatchCriteria}
+     * limiting which transitions notify the host.
+     *
+     * Defaults to `{}` (all transitions).
+     */
+    criteria?: HookMatchCriteria;
+    /**
+     * The transition lifecycle events to observe.
+     *
+     * Defaults to `['onSuccess']`.
+     */
+    events?: TransitionEventType[];
+    /**
+     * Invoked before `host.requestUpdate()` whenever an observed event fires,
+     * and once each time the host connects (see [[TransitionCallbackReason]]).
+     */
+    callback?: TransitionCallback;
+}
+/**
+ * A zero-dependency Lit
+ * {@link https://lit.dev/docs/composition/controllers/ | ReactiveController}
+ * that keeps its host element synchronized with UI-Router transitions.
+ *
+ * The controller registers [[TransitionService]] hooks (by default
+ * `onSuccess`) when the host connects and calls `host.requestUpdate()`
+ * whenever a matching transition event fires — no manual `requestUpdate()`
+ * plumbing, no leaked hooks. All registered hooks are deregistered in
+ * `hostDisconnected()`, so the controller is garbage-collection safe for
+ * elements that come and go from the DOM (including `sticky` routed
+ * components).
+ *
+ * On (re)connect the controller also synchronizes once with the router's
+ * current state, so hosts render fresh data even when they connect after
+ * a transition has already completed.
+ *
+ * @example Re-render on every successful transition
+ * ```ts
+ * class NavHeader extends LitElement {
+ *   private transitions = new TransitionController(this);
+ *
+ *   render() {
+ *     // Re-evaluated after every successful transition
+ *     return html`Current state: ${this.transitions.current?.name}`;
+ *   }
+ * }
+ * ```
+ *
+ * @example React to parameter changes on a specific state
+ * ```ts
+ * class UserDetail extends LitElement {
+ *   private transitions = new TransitionController(this, {
+ *     criteria: { to: 'users.detail' },
+ *     callback: () => this.loadUser(this.transitions.params.userId),
+ *   });
+ * }
+ * ```
+ *
+ * @example With an explicit router instance
+ * ```ts
+ * const controller = new TransitionController(host, { router });
+ * ```
+ *
+ * @category controllers
+ */
+export declare class TransitionController implements ReactiveController {
+    private host;
+    private options;
+    private deregisterFns;
+    private _router?;
+    private _transition?;
+    constructor(host: ReactiveControllerHost & Element, options?: TransitionControllerOptions);
+    /**
+     * The observed [[UIRouter]] instance.
+     *
+     * `undefined` until provided via [[TransitionControllerOptions.router]] or
+     * discovered from an ancestor <code>&lt;ui-router&gt;</code> on connect.
+     */
+    get router(): UIRouter | undefined;
+    /** The router's [[UIRouterGlobals]], if a router has been discovered. */
+    get globals(): UIRouterGlobals | undefined;
+    /** The current parameter values (`globals.params`). */
+    get params(): RawParams;
+    /** The current [[StateDeclaration]] (`globals.current`). */
+    get current(): StateDeclaration | undefined;
+    /**
+     * The most recent [[Transition]] observed by this controller
+     * (set by observed events and on host connect).
+     */
+    get transition(): Transition | undefined;
+    /**
+     * Delegates to [[StateService.includes]]: is the state (or glob pattern,
+     * e.g. `'admin.**'`) included in the current active state?
+     *
+     * Returns `false` when no router has been discovered.
+     */
+    includes(stateOrName: StateOrName, params?: RawParams): boolean;
+    /** @internal */
+    hostConnected(): void;
+    /** @internal */
+    hostDisconnected(): void;
+    private notify;
+}

package/dist/transition-controller.js

@@ -0,0 +1,123 @@
+import { UIRouterLitElement } from './ui-router.js';
+/**
+ * A zero-dependency Lit
+ * {@link https://lit.dev/docs/composition/controllers/ | ReactiveController}
+ * that keeps its host element synchronized with UI-Router transitions.
+ *
+ * The controller registers [[TransitionService]] hooks (by default
+ * `onSuccess`) when the host connects and calls `host.requestUpdate()`
+ * whenever a matching transition event fires — no manual `requestUpdate()`
+ * plumbing, no leaked hooks. All registered hooks are deregistered in
+ * `hostDisconnected()`, so the controller is garbage-collection safe for
+ * elements that come and go from the DOM (including `sticky` routed
+ * components).
+ *
+ * On (re)connect the controller also synchronizes once with the router's
+ * current state, so hosts render fresh data even when they connect after
+ * a transition has already completed.
+ *
+ * @example Re-render on every successful transition
+ * ```ts
+ * class NavHeader extends LitElement {
+ *   private transitions = new TransitionController(this);
+ *
+ *   render() {
+ *     // Re-evaluated after every successful transition
+ *     return html`Current state: ${this.transitions.current?.name}`;
+ *   }
+ * }
+ * ```
+ *
+ * @example React to parameter changes on a specific state
+ * ```ts
+ * class UserDetail extends LitElement {
+ *   private transitions = new TransitionController(this, {
+ *     criteria: { to: 'users.detail' },
+ *     callback: () => this.loadUser(this.transitions.params.userId),
+ *   });
+ * }
+ * ```
+ *
+ * @example With an explicit router instance
+ * ```ts
+ * const controller = new TransitionController(host, { router });
+ * ```
+ *
+ * @category controllers
+ */
+export class TransitionController {
+    constructor(host, options = {}) {
+        this.deregisterFns = [];
+        this.host = host;
+        this.options = options;
+        this._router = options.router;
+        host.addController(this);
+    }
+    /**
+     * The observed [[UIRouter]] instance.
+     *
+     * `undefined` until provided via [[TransitionControllerOptions.router]] or
+     * discovered from an ancestor <code>&lt;ui-router&gt;</code> on connect.
+     */
+    get router() {
+        return this._router;
+    }
+    /** The router's [[UIRouterGlobals]], if a router has been discovered. */
+    get globals() {
+        return this._router?.globals;
+    }
+    /** The current parameter values (`globals.params`). */
+    get params() {
+        return this.globals?.params ?? {};
+    }
+    /** The current [[StateDeclaration]] (`globals.current`). */
+    get current() {
+        return this.globals?.current;
+    }
+    /**
+     * The most recent [[Transition]] observed by this controller
+     * (set by observed events and on host connect).
+     */
+    get transition() {
+        return this._transition;
+    }
+    /**
+     * Delegates to [[StateService.includes]]: is the state (or glob pattern,
+     * e.g. `'admin.**'`) included in the current active state?
+     *
+     * Returns `false` when no router has been discovered.
+     */
+    includes(stateOrName, params) {
+        return this._router?.stateService.includes(stateOrName, params) ?? false;
+    }
+    /** @internal */
+    hostConnected() {
+        this._router ??=
+            this.options.router ?? UIRouterLitElement.seekRouter(this.host);
+        const router = this._router;
+        if (!router) {
+            return;
+        }
+        const criteria = this.options.criteria ?? {};
+        const events = this.options.events ?? ['onSuccess'];
+        for (const event of events) {
+            this.deregisterFns.push(router.transitionService[event](criteria, (transition) => this.notify(transition, event)));
+        }
+        // Synchronize with the router's current state: the host may have
+        // (re)connected after the transition that put it on screen succeeded.
+        this.notify(router.globals.successfulTransitions.peekTail(), 'hostConnected');
+    }
+    /** @internal */
+    hostDisconnected() {
+        while (this.deregisterFns.length) {
+            this.deregisterFns.shift()?.();
+        }
+    }
+    notify(transition, reason) {
+        this._transition = transition ?? this._transition;
+        const result = this.options.callback?.(transition, reason);
+        this.host.requestUpdate();
+        return result;
+    }
+}
+//# sourceMappingURL=transition-controller.js.map

package/dist/transition-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-controller.js","sourceRoot":"","sources":["../src/transition-controller.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAyFpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,OAAO,oBAAoB;IAW/B,YACE,IAAsC,EACtC,UAAuC,EAAE;QARnC,kBAAa,GAAmB,EAAE,CAAC;QAUzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,yEAAyE;IACzE,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;IAC/B,CAAC;IAED,uDAAuD;IACvD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,4DAA4D;IAC5D,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,WAAwB,EAAE,MAAkB;QACnD,OAAO,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC;IAC3E,CAAC;IAED,gBAAgB;IAChB,aAAa;QACX,IAAI,CAAC,OAAO;YACV,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC;QAEpD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,CACrB,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAC7B,QAAQ,EACR,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAe,CAC7C,CAClB,CAAC;QACJ,CAAC;QAED,iEAAiE;QACjE,sEAAsE;QACtE,IAAI,CAAC,MAAM,CACT,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,EAAE,EAC/C,eAAe,CAChB,CAAC;IACJ,CAAC;IAED,gBAAgB;IAChB,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,MAAM,CACZ,UAAkC,EAClC,MAAgC;QAEhC,IAAI,CAAC,WAAW,GAAG,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/ui-router.d.ts

@@ -12,7 +12,7 @@ export type UiRouterContextEvent = CustomEvent<UiRouterContextEventDetail>;
  *
  * @slot - <code>&lt;ui-router&gt;</code> renders slotted content.
  *
- * @event {CustomEvent} ui-router-context
+ * @fires {CustomEvent} ui-router-context
  *
  * <code>&lt;ui-router&gt;</code> listens to the
  * <code>ui-router-context</code> event
@@ -33,7 +33,21 @@ export declare class UIRouterLitElement extends LitElement {
     static uiRouterContextEventName: string;
     /** @internal */
     static uiRouterContextEvent(uiRouter?: UIRouterLit): UiRouterContextEvent;
-    /** @internal */
+    /**
+     * Discovers the {@link UIRouterLit} instance provided by the nearest
+     * enclosing <code>&lt;ui-router&gt;</code> element.
+     *
+     * Dispatches a bubbling, composed <code>ui-router-context</code> event from
+     * the candidate element; the enclosing <code>&lt;ui-router&gt;</code>
+     * answers it with its router instance. Returns <code>undefined</code> when
+     * the candidate is not inside a <code>&lt;ui-router&gt;</code> (e.g. not
+     * yet connected).
+     *
+     * This is the dependency-injection primitive for integrating external
+     * reactivity systems (state stores, controllers) with the router context —
+     * call it from <code>hostConnected()</code> / <code>connectedCallback()</code>
+     * instead of prop-drilling the router instance.
+     */
     static seekRouter(candidate: Element): UIRouterLit | undefined;
     /** @internal */
     static onUiRouterContextEvent(uiRouter?: UIRouterLit): (event: UiRouterContextEvent) => void;

package/dist/ui-router.js

@@ -12,7 +12,7 @@ import { UIRouterLit } from './core.js';
  *
  * @slot - <code>&lt;ui-router&gt;</code> renders slotted content.
  *
- * @event {CustomEvent} ui-router-context
+ * @fires {CustomEvent} ui-router-context
  *
  * <code>&lt;ui-router&gt;</code> listens to the
  * <code>ui-router-context</code> event
@@ -42,7 +42,21 @@ let UIRouterLitElement = class UIRouterLitElement extends LitElement {
             },
         });
     }
-    /** @internal */
+    /**
+     * Discovers the {@link UIRouterLit} instance provided by the nearest
+     * enclosing <code>&lt;ui-router&gt;</code> element.
+     *
+     * Dispatches a bubbling, composed <code>ui-router-context</code> event from
+     * the candidate element; the enclosing <code>&lt;ui-router&gt;</code>
+     * answers it with its router instance. Returns <code>undefined</code> when
+     * the candidate is not inside a <code>&lt;ui-router&gt;</code> (e.g. not
+     * yet connected).
+     *
+     * This is the dependency-injection primitive for integrating external
+     * reactivity systems (state stores, controllers) with the router context —
+     * call it from <code>hostConnected()</code> / <code>connectedCallback()</code>
+     * instead of prop-drilling the router instance.
+     */
     static seekRouter(candidate) {
         const uiRouterContextEvent = this.uiRouterContextEvent();
         candidate.dispatchEvent(uiRouterContextEvent);

package/dist/ui-router.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-router.js","sourceRoot":"","sources":["../src/ui-router.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAWxC;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,UAAU;IAA3C;;QAqCG,2BAAsB,GAAG,CAAC,KAA2B,EAAE,EAAE;YAC/D,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC,CAAC;IAmBJ,CAAC;IAlDC,gBAAgB;aACT,6BAAwB,GAAG,mBAAmB,AAAtB,CAAuB;IAEtD,gBAAgB;IAChB,MAAM,CAAC,oBAAoB,CAAC,QAAsB;QAChD,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,wBAAwB,EAAE;YACpD,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,QAAQ;aACT;SACF,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAChB,MAAM,CAAC,UAAU,CAAC,SAAkB;QAClC,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACzD,SAAS,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;QAC9C,OAAO,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9C,CAAC;IAED,gBAAgB;IAChB,MAAM,CAAC,sBAAsB,CAAC,QAAsB;QAClD,OAAO,CAAC,KAA2B,EAAE,EAAE;YACrC,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACnC,CAAC,CAAC;IACJ,CAAC;IAMD,gBAAgB;IAChB,KAAK,CAAC,iBAAiB;QACrB,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,WAAW,EAAE,CAAC;QAEnD,IAAI,CAAC,gBAAgB,CACnB,IAAI,CAAC,WAAW,CAAC,wBAAwB,EACzC,IAAI,CAAC,sBAAuC,CAC7C,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,gBAAgB;IAChB,MAAM;QACJ,OAAO,IAAI,CAAA,eAAe,CAAC;IAC7B,CAAC;;AAnDD;IADC,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;oDACG;AANvB,kBAAkB;IAD9B,aAAa,CAAC,WAAW,CAAC;GACd,kBAAkB,CA0D9B"}
+{"version":3,"file":"ui-router.js","sourceRoot":"","sources":["../src/ui-router.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAWxC;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,UAAU;IAA3C;;QAmDG,2BAAsB,GAAG,CAAC,KAA2B,EAAE,EAAE;YAC/D,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC,CAAC;IAmBJ,CAAC;IAhEC,gBAAgB;aACT,6BAAwB,GAAG,mBAAmB,AAAtB,CAAuB;IAEtD,gBAAgB;IAChB,MAAM,CAAC,oBAAoB,CAAC,QAAsB;QAChD,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,wBAAwB,EAAE;YACpD,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,QAAQ;aACT;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,UAAU,CAAC,SAAkB;QAClC,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACzD,SAAS,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;QAC9C,OAAO,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9C,CAAC;IAED,gBAAgB;IAChB,MAAM,CAAC,sBAAsB,CAAC,QAAsB;QAClD,OAAO,CAAC,KAA2B,EAAE,EAAE;YACrC,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,KAAK,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACnC,CAAC,CAAC;IACJ,CAAC;IAMD,gBAAgB;IAChB,KAAK,CAAC,iBAAiB;QACrB,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,WAAW,EAAE,CAAC;QAEnD,IAAI,CAAC,gBAAgB,CACnB,IAAI,CAAC,WAAW,CAAC,wBAAwB,EACzC,IAAI,CAAC,sBAAuC,CAC7C,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,gBAAgB;IAChB,MAAM;QACJ,OAAO,IAAI,CAAA,eAAe,CAAC;IAC7B,CAAC;;AAjED;IADC,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;oDACG;AANvB,kBAAkB;IAD9B,aAAa,CAAC,WAAW,CAAC;GACd,kBAAkB,CAwE9B"}

package/dist/ui-sref.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-sref.js","sourceRoot":"","sources":["../src/ui-sref.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAGN,QAAQ,GAET,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAe,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAY,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAuBnD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAwB;IACxD,OAAO,IAAI,WAAW,CAAC,oBAAoB,EAAE;QAC3C,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE,WAAW,EAAE;KACxB,CAAsB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAgB,SAAQ,cAAc;IAgBjD,gBAAgB;IAChB,YAAY,QAAkB;QAC5B,KAAK,CAAC,QAAQ,CAAC,CAAC;QAjBlB,UAAK,GAAkB,IAAI,CAAC;QAC5B,WAAM,GAAc,EAAE,CAAC;QACvB,YAAO,GAAsB,EAAE,CAAC;QAEhC,YAAO,GAAyB,IAAI,CAAC;QAGrC,eAAU,GAAkB,IAAI,CAAC;QAEjC,SAAI,GAAkB,IAAI,CAAC;QAC3B,gBAAW,GAAuB,IAAI,CAAC;QA0EvC,YAAO,GAAG,CAAC,KAAiB,EAAE,EAAE;YAC9B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;YACjD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC;YACpC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;gBAC1C,OAAO;YACT,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;YACnD,MAAM,YAAY,GACf,MAAkB,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC;YAC1D,MAAM,UAAU,GAAI,MAAkB,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC;YAC1E,IACE,YAAY;gBACZ,UAAU;gBACV,MAAM;gBACN,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACjB,OAAO;gBACP,OAAO;gBACP,CAAC,KAAK,EACN,CAAC;gBACD,OAAO;YACT,CAAC;YACD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAClC,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,CAAC,CAAC;QAqBF,aAAQ,GAAG,GAAG,EAAE;YACd,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC;QAEM,kBAAa,GAAG,KAAK,CAAC;QAnH5B,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,UAAU,CAAC,OAA0B,IAAI,CAAC,OAAO;QAC/C,MAAM,WAAW,GAAsB;YACrC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI;YAC5C,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;SACf,CAAC;QACF,OAAO,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,MAAkB,EAAE,OAA2B;QACnE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CACzD,KAAK,EACL,MAAM,EACN,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CACzB,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QAEjE,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,UAAU;QACR,IAAI,CAAC,QAAQ,GAAG,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,OAAQ,CAAC,CAAC;IAC/D,CAAC;IAED,gBAAgB;IAChB,cAAc;QACZ,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,OAAQ,CAAC,CAAC;IACzD,CAAC;IAED,gBAAgB;IAChB,YAAY;QACV,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAwB,CAAC,CAAC;QAC1E,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;IACvB,CAAC;IA4BD,MAAM,CACJ,IAAiB,EACjB,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,CAAyC;QAE1E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAmC,CAAC;QAC/D,IAAI,IAAI,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC;YAC7B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;YAC3B,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,CAAC,EAAE,CAAC,CAAC,CAAC;QACR,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAOD;;OAEG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,OAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAwB,CAAC,CAAC;QACvE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAS,CAAC,aAAa,CAAC,eAAe,CAC7D,IAAI,CAAC,QAAQ,CACd,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC"}
+{"version":3,"file":"ui-sref.js","sourceRoot":"","sources":["../src/ui-sref.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAGN,QAAQ,GAET,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAe,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAY,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAwBnD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAwB;IACxD,OAAO,IAAI,WAAW,CAAC,oBAAoB,EAAE;QAC3C,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,EAAE,WAAW,EAAE;KACxB,CAAsB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAgB,SAAQ,cAAc;IAgBjD,gBAAgB;IAChB,YAAY,QAAkB;QAC5B,KAAK,CAAC,QAAQ,CAAC,CAAC;QAjBlB,UAAK,GAAkB,IAAI,CAAC;QAC5B,WAAM,GAAc,EAAE,CAAC;QACvB,YAAO,GAAsB,EAAE,CAAC;QAEhC,YAAO,GAAyB,IAAI,CAAC;QAGrC,eAAU,GAAkB,IAAI,CAAC;QAEjC,SAAI,GAAkB,IAAI,CAAC;QAC3B,gBAAW,GAAuB,IAAI,CAAC;QA0EvC,YAAO,GAAG,CAAC,KAAiB,EAAE,EAAE;YAC9B,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;YACjD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC;YACpC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;gBAC1C,OAAO;YACT,CAAC;YACD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;YACnD,MAAM,YAAY,GACf,MAAkB,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC;YAC1D,MAAM,UAAU,GAAI,MAAkB,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC;YAC1E,IACE,YAAY;gBACZ,UAAU;gBACV,MAAM;gBACN,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACjB,OAAO;gBACP,OAAO;gBACP,CAAC,KAAK,EACN,CAAC;gBACD,OAAO;YACT,CAAC;YACD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAClC,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,CAAC,CAAC;QAqBF,aAAQ,GAAG,GAAG,EAAE;YACd,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC;QAEM,kBAAa,GAAG,KAAK,CAAC;QAnH5B,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,UAAU,CAAC,OAA0B,IAAI,CAAC,OAAO;QAC/C,MAAM,WAAW,GAAsB;YACrC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI;YAC5C,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;SACf,CAAC;QACF,OAAO,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,MAAkB,EAAE,OAA2B;QACnE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CACzD,KAAK,EACL,MAAM,EACN,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CACzB,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QAEjE,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,UAAU;QACR,IAAI,CAAC,QAAQ,GAAG,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,OAAQ,CAAC,CAAC;IAC/D,CAAC;IAED,gBAAgB;IAChB,cAAc;QACZ,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,OAAQ,CAAC,CAAC;IACzD,CAAC;IAED,gBAAgB;IAChB,YAAY;QACV,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAwB,CAAC,CAAC;QAC1E,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;IACvB,CAAC;IA4BD,MAAM,CACJ,IAAiB,EACjB,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,CAAyC;QAE1E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAmC,CAAC;QAC/D,IAAI,IAAI,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC;YAC7B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;YAC3B,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,CAAC,EAAE,CAAC,CAAC,CAAC;QACR,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAOD;;OAEG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,OAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAwB,CAAC,CAAC;QACvE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAS,CAAC,aAAa,CAAC,eAAe,CAC7D,IAAI,CAAC,QAAQ,CACd,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC"}

package/dist/ui-view.d.ts

@@ -8,14 +8,14 @@ export interface UiViewAddress {
 }
 /**
  * @hideconstructor
- * @event {CustomEvent} ui-router-context
+ * @fires {CustomEvent} ui-router-context
  *
  * This event is fired to obtain the <code>uiRouter</code> instance,
  * when not directly provided.
  * Once obtained, the <code>&lt;ui-view&gt;</code> listens and
  * provides the <code>uiRouter</code> to descendants.
  *
- * @event {CustomEvent} ui-view-context
+ * @fires {CustomEvent} ui-view-context
  *
  * This event is fired to obtain the parent <code>&lt;ui-view&gt;</code>.
  *

package/dist/ui-view.js

@@ -13,14 +13,14 @@ import { UIRouterLitElement } from './ui-router.js';
 let viewIdCounter = 0;
 /**
  * @hideconstructor
- * @event {CustomEvent} ui-router-context
+ * @fires {CustomEvent} ui-router-context
  *
  * This event is fired to obtain the <code>uiRouter</code> instance,
  * when not directly provided.
  * Once obtained, the <code>&lt;ui-view&gt;</code> listens and
  * provides the <code>uiRouter</code> to descendants.
  *
- * @event {CustomEvent} ui-view-context
+ * @fires {CustomEvent} ui-view-context
  *
  * This event is fired to obtain the parent <code>&lt;ui-view&gt;</code>.
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lit-ui-router",
   "description": "State-based routing for Lit",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "type": "module",
   "module": "./dist/index.js",
   "homepage": "https://lit-ui-router.dev",
@@ -31,24 +31,24 @@
     "test": "vitest run",
     "test:coverage": "vitest run --coverage --browser=chromium"
   },
-  "customElements": "./dist/custom-elements.json",
+  "customElements": "dist/custom-elements.json",
   "dependencies": {
-    "@uirouter/core": "^6.0.8",
-    "lit": "^2.0.0 || ^3.0.0"
+    "@uirouter/core": "catalog:",
+    "lit": "catalog:"
   },
   "devDependencies": {
-    "@custom-elements-manifest/analyzer": "0.10.4",
-    "@vitest/browser-playwright": "^4.0.16",
-    "@vitest/coverage-v8": "^4.0.16",
-    "playwright": "1.54.1",
-    "prettier": "3.6.2",
-    "release-it": "^19.2.2",
-    "rimraf": "^6.0.0",
-    "typedoc": "^0.28.15",
+    "@custom-elements-manifest/analyzer": "^0.10.10",
+    "@vitest/browser-playwright": "catalog:",
+    "@vitest/coverage-v8": "catalog:",
+    "playwright": "catalog:",
+    "prettier": "catalog:",
+    "release-it": "catalog:",
+    "rimraf": "catalog:",
+    "typedoc": "catalog:",
     "typedoc-plugin-lit-ui-router": "workspace:*",
-    "typedoc-plugin-markdown": "^4.4.0",
-    "typedoc-vitepress-theme": "^1.1.2",
-    "typescript": "5.8.3",
-    "vitest": "^4.0.16"
+    "typedoc-plugin-markdown": "catalog:",
+    "typedoc-vitepress-theme": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
   }
 }