@lwrjs/router 0.10.0-alpha.12 → 0.10.0-alpha.13

package/build/bundle/prod/lwr/routerContainer/es/modules/lwr/routerUtils/types.d.ts

@@ -0,0 +1,133 @@
+import type { Key, PathFunction } from './pathToRegexp';
+import type { ContextId } from 'lwr/navigationContext';
+import { Unsubscriber } from 'lwr/observable';
+export declare type Module = Record<string | symbol | number, unknown>;
+export declare type Constructor<T = object> = new (...args: any[]) => T;
+export interface Constructable<T = object> {
+    constructor: Constructor<T>;
+}
+export declare type UrlMapper<TAddress> = {
+    generateUrl(address: TAddress): string | null;
+    parseUrl(url: string): TAddress | null;
+};
+export declare type RouteMatcher<TAddress> = {
+    matchRoute(address: TAddress): RoutingMatch | null;
+};
+export declare type ViewMapper<TAddress> = {
+    navigate(address: TAddress): void;
+    subscribe(callback: RouteCallback, replay?: boolean): Unsubscriber;
+    resolveView(address: TAddress): Promise<RouteDestination>;
+    contextId?: ContextId;
+};
+export declare type Router<TAddress = string> = ViewMapper<TAddress> & UrlMapper<TAddress> & RouteMatcher<TAddress>;
+export interface DEPRECATED_getRouteFromUrl {
+    <TAddress>(url: string, defaultImpl: Function): TAddress | null;
+}
+export interface DEPRECATED_getUrlFromRoute {
+    <TAddress>(route: TAddress, defaultImpl: Function): string | null;
+}
+export declare type RouterConfig = {
+    basePath?: string;
+    routes?: RouteDefinition[];
+    caseSensitive?: boolean;
+    DEPRECATED_getRouteFromUrl?: DEPRECATED_getRouteFromUrl;
+    DEPRECATED_getUrlFromRoute?: DEPRECATED_getUrlFromRoute;
+};
+export declare type RouterSerializationConfig<TAddress> = Required<Omit<RouterConfig, 'DEPRECATED_getRouteFromUrl' | 'DEPRECATED_getUrlFromRoute'> & UrlMapper<TAddress>>;
+export declare type RouteParameterPatterns = {
+    [paramName: string]: string;
+};
+export interface RouteDefinition<TMetadata = Record<string, any>> {
+    id: string;
+    uri: string;
+    patterns?: RouteParameterPatterns;
+    exact?: boolean;
+    page: Partial<PageReference>;
+    handler: () => Promise<RouteHandlerModule>;
+    metadata?: TMetadata;
+}
+export declare type PageBindings = {
+    attributeBindings: NullableStringAttributes;
+    stateBindings: NullableStringAttributes;
+};
+declare type CompiledQueryResult = {
+    literalValue?: string | null;
+    routeParamName?: string;
+};
+export declare type CompiledQuery = Record<string, CompiledQueryResult>;
+declare type MatchedQueryResult = {
+    value: string | null;
+    routeParamName?: string;
+};
+export declare type MatchedQuery = Record<string, MatchedQueryResult>;
+export declare type QueryMatcher = (queryObject: QueryObject) => MatchedQuery | null;
+export interface CompiledRouteDefinition {
+    original: RouteDefinition;
+    regex: RegExp;
+    params: Key[];
+    toPath: PathFunction<object>;
+    compiledQuery: CompiledQuery;
+    queryMatcher: QueryMatcher;
+}
+export declare type RouteHandlerCallback = (routeDestination: RouteDestination) => void;
+export declare type RouteHandlerClass = {
+    new (callback: RouteHandlerCallback): RouteHandler;
+};
+export declare type RouteHandlerModule = {
+    default: RouteHandlerClass;
+};
+export interface RouteInstance {
+    id: string;
+    attributes: NullableStringAttributes;
+    state: NullableStringAttributes;
+    pageReference: PageReference;
+}
+export declare type RouteDestination = {
+    status?: 200 | 404 | 500;
+    viewset: ViewSet;
+    error?: Error;
+};
+export declare type RoutingMatch = {
+    pathMatch: string;
+    route: RouteInstance;
+    routeDefinition: RouteDefinition;
+};
+export interface CompiledRoutingMatch {
+    route: RouteInstance;
+    routeDefinition: CompiledRouteDefinition;
+}
+export declare type RoutingResult = RoutingMatch & RouteDestination;
+export interface ViewSet {
+    [viewName: string]: (() => Promise<Module>) | ViewInfo;
+}
+export interface ViewInfo {
+    module: () => Promise<Module>;
+    specifier: string;
+}
+export declare type RouteCallback = (result: RoutingResult) => void;
+export interface RouteHandler {
+    dispose(): void;
+    update(routeInfo: RouteInstance): void;
+}
+export interface PageReference {
+    type: string;
+    attributes: NullableStringAttributes;
+    state: NullableStringAttributes;
+}
+export interface MessageObject {
+    code: string | number;
+    message: string;
+    level: number;
+    stack?: string;
+    url?: string;
+    address?: string;
+}
+export declare type QueryObject = NullableStringAttributes;
+export interface StringAttributes {
+    [key: string]: string;
+}
+export interface NullableStringAttributes {
+    [key: string]: string | null;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/build/bundle/prod/lwr/routerContainer/es/modules/lwr/routerUtils/uriUtils.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Copyright (c) 2019, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+import type { QueryObject, CompiledQuery } from './types';
+/**
+ * f("one two &") -> "one%20two%20%26"
+ *
+ * @param str - String to URI encode
+ *
+ * @returns {string}
+ */
+export declare function encode(str?: string): string;
+/**
+ * f("one%20two%20%26") -> "one two &"
+ *
+ * @param str - String to URI decode
+ *
+ * @returns {string}
+ */
+export declare function decode(str?: string): string;
+/**
+ * f(url) -> "/some/relative/path"
+ * Output will...
+ * - always start with '/'
+ * - not contain query params or fragment
+ * - akin to window.location.pathname
+ *
+ * @param   {string} url - URL string to parse for a path
+ *
+ * @returns {string}
+ */
+export declare function getPathFromUrl(url: string): string;
+/**
+ * f(url) -> { "param1": "one", "param2": "two", param3: "" }
+ * Parameters without values get set to an empty string.
+ *
+ * @param {string} url - URL string to parse for a query object
+ *
+ * @returns {object}
+ */
+export declare function getQueryFromUrl(url: string): QueryObject;
+/**
+ * f({ "param1": "one", "param2": "two", param3: "" }) -> "?param1=one&param2=two&param3"
+ * Query parameter values, but not keys, get URI encoded.
+ *
+ * @param {object} queryObject - Query object to turn into a string
+ *
+ * @returns {string}
+ */
+export declare function getQueryString(queryObj?: QueryObject): string;
+/**
+ * Determines if the given string is a paramter name (":paramName")
+ * @param str string to test
+ * @returns true if string starts with ":"
+ */
+export declare function isParam(str: string | null | undefined): boolean;
+/**
+ * @param routeParamName - routeParamName from CompiledQueryResult
+ * @returns the paramName without prefix; or undefined
+ */
+export declare function getParamName(routeParamName: string | undefined | null): string | false;
+export declare function getQueryNames(compiledQuery: CompiledQuery): string[];
+//# sourceMappingURL=uriUtils.d.ts.map

package/build/bundle/prod/lwr/routerContainer/es/services/index.d.ts

@@ -0,0 +1,28 @@
+export declare const DEFAULT_SCHEMA = "pageReference_v1";
+export interface LwrRouterConfig {
+    basePath?: string;
+    caseSensitive?: boolean;
+    routes: LwrConfigRouteDefinition[];
+}
+export interface LwrConfigRouteDefinition {
+    id: string;
+    uri: string;
+    patterns?: Record<string, string>;
+    exact?: boolean;
+    page: Partial<PageReference>;
+    metadata?: Record<string, any>;
+    handler?: string;
+    component?: string;
+}
+export interface PageReference {
+    type: string;
+    attributes: Record<string, string | null>;
+    state: Record<string, string | null>;
+}
+export declare function deleteRouterConfigJsonCacheEntry(path: string): void;
+/**
+ * Given a Routes Config path, return the array of Config Route Definitions
+ * @param path - A path to a Route Config files
+ */
+export declare function getClientRoutes(path: string): LwrRouterConfig | undefined;
+//# sourceMappingURL=index.d.ts.map

package/build/bundle/prod/lwr/routerContainer/es/services/module-provider/index.d.ts

@@ -0,0 +1,22 @@
+import type { AbstractModuleId, ModuleCompiled, ModuleEntry, ModuleProvider, ProviderContext } from '@lwrjs/types';
+interface RouterProviderOptions {
+    routesDir?: string;
+}
+export default class RouterModuleProvider implements ModuleProvider {
+    name: string;
+    version: string;
+    routesDir: string;
+    appBasePath?: string;
+    private routerEmitter;
+    private routerWatcher?;
+    private watchedFileMap;
+    private routerModuleCache;
+    constructor({ routesDir }: RouterProviderOptions, context: ProviderContext);
+    onRouterModuleChange(configPath: string, deleted?: boolean): Promise<void>;
+    private watchConfigs;
+    private getRouterConfig;
+    getModuleEntry({ specifier }: AbstractModuleId): Promise<ModuleEntry | undefined>;
+    getModule(moduleId: AbstractModuleId): Promise<ModuleCompiled | undefined>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/bundle/prod/lwr/routerContainer/es/services/module-provider/utils.d.ts

@@ -0,0 +1,27 @@
+import type { Watcher } from '@lwrjs/types';
+import type { LwrRouterConfig } from '../index.js';
+import type { WatcherFactory } from '@lwrjs/types';
+export declare const SPECIFIER_PREFIX = "@lwrjs/router/";
+/**
+ * Parse a specifier into its Router Config ID
+ * Return undefined if the specifier is invalid
+ * @param specifier - The raw specifier to parse
+ */
+export declare function parseSpecifier(specifier: string): string | undefined;
+/**
+ * Given a Router Config ID and directory, return the file path to the router metadata
+ * @param dir       - Path to directory containing Router Config files
+ * @param specifier - Specifier for the Router Config module
+ */
+export declare function getRouterConfigPath(dir: string, specifier: string): string;
+/**
+ * Set up a file system watcher; used to spy on Router Config file changes
+ * @param onModuleChange - File change callback function
+ */
+export declare function setUpWatcher(factory: WatcherFactory, onModuleChange: (file: string, deleted?: boolean) => void): Watcher;
+/**
+ * Generate a module string which fulfills a router request
+ * @param routes - The array of route definitions
+ */
+export declare function generateModule(config?: LwrRouterConfig): string;
+//# sourceMappingURL=utils.d.ts.map

package/build/bundle/prod/lwr/routerContainer/routerContainer.js

@@ -1 +1,2 @@
 import{parseFragment as e,registerTemplate as t,freezeTemplate as r,createContextProvider as i,registerDecorators as n,registerComponent as o,LightningElement as s}from"lwc";import{ROUTER_VIEW as a,ROUTER_NAV as c,ROUTER_ERROR as d}from"lwr/metrics";import{logOperationEnd as l,logOperationStart as h}from"lwr/profiler";var u=[function(e,t,r){return"span.router-title"+(e?"["+e+"]":"")+" {position: absolute;margin: -1px;border: 0;padding: 0;width: 1px;height: 1px;overflow: hidden;clip: rect(0 0 0 0);text-transform: none;white-space: nowrap;}"}];const p=e`<span class="router-title${0}" aria-live="polite" aria-atomic="true"${2}></span>`,v={key:0},g=[];function f(e,t,r,i){const{s:n,st:o,f:s}=e;return s([n("",v,g,r),o(p(),2)])}var m=t(f);function b(e){if(null==e)throw new TypeError("Provider must be defined.")}f.slots=[""],f.stylesheets=[],f.renderMode="light",u&&f.stylesheets.push.apply(f.stylesheets,u),f.stylesheetToken="lwr-routerContainer_routerContainer",r(f);class E{constructor(e){this.infoMap=new WeakMap,this.defaultValue=e}getInfo(e){let t=this.infoMap.get(e);return void 0===t&&(t={consumers:new Set},this.infoMap.set(e,t)),t}setContext(e,t){b(e);const r=t,i=this.getInfo(e);i.contextValue=t,i.consumers.forEach((e=>e.provide(r))),0===i.consumers.size&&r?.onComplete&&r.onComplete()}getContext(e){b(e);const{contextValue:t}=this.getInfo(e);return void 0!==t?t:this.defaultValue}clearContext(e){b(e),this.infoMap.delete(e)}subscribeContext(e,t){b(e);const{consumers:r,contextValue:i}=this.getInfo(e);r.has(t)||(r.add(t),t.provide(i))}unsubscribeContext(e,t){b(e),this.getInfo(e).consumers.delete(t)}}function I(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,i)}return r}function w(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?I(Object(r),!0).forEach((function(t){N(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):I(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function N(e,t,r){return(t=function(e){var t=function(e,t){if("object"!=typeof e||null===e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var i=r.call(e,t||"default");if("object"!=typeof i)return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==typeof t?t:String(t)}(t))in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}const y="LWR",_=1;function O(e,t){return Array.isArray(t)?e.replace(/\{([0-9]+)\}/g,((e,r)=>t[r])):e}function P(e,t){const r=w(w({},e),{},{message:O(e.message,t)});return e.address&&(r.address=O(e.address,t)),e.stack&&(r.stack=O(e.stack,t)),r}function R(e,t,r){if(!e)throw new Error(function(e,t){return`${e.code}: ${O(e.message,t)}`}(t,r))}const x={INVALID_MIXIN_CMP:{code:`${y}4001`,message:"{0} must be an Element type",level:_},MISSING_CONTEXT:{code:`${y}4002`,message:"Could not find context to perform navigation action.",level:_},INVALID_CONTEXT:{code:`${y}4003`,message:"Cannot register navigation context; it must have this shape: { navigate, generateUrl, subscribe }",level:_},MULTIPLE_ROOTS:{code:`${y}4004`,message:"Router connection failed. There can only be one root router.",level:_},MULTIPLE_CHILDREN:{code:`${y}4005`,message:"Could not add to the navigation hierarchy. There can only be one child per navigation node.",level:_},MISSING_ROUTE:{code:`${y}4006`,message:'A route cannot be created to navigate to URL "{0}"',level:_,address:"{0}"},MISSING_URL:{code:`${y}4007`,message:'A URL cannot be created to navigate to route "{0}"',level:_,address:"{0}"},PRENAV_FAILED:{code:`${y}4008`,message:'A preNavigate hook listener blocked routing to "{0}"',level:2,address:"{0}"},MISSING_ROUTE_TEMPLATE:{code:`${y}4009`,message:'A route definition must contain a "uri" property.',level:_},MISSING_ROUTE_CMP:{code:`${y}4016`,message:"Expected a route view component with a default export.",level:_},MISSING_DATA_CONTEXT:{code:`${y}4018`,message:"Could not find context to retrieve navigation data.",level:_},INVALID_ROUTE_QUERY:{code:`${y}4019`,message:"Invalid query param in route definition.",level:_},MISSING_PAGE_BINDING:{code:`${y}4020`,message:"Route definition must provide page binding",level:_},INVALID_PAGE_BINDING:{code:`${y}4021`,message:"Invalid page binding in route definition",level:_},INVALID_URI_SYNTAX:{code:`${y}4022`,message:"Invalid uri syntax. URI cannot contain *, +, (, ), ",level:_},VIEW_IMPORT_FAILED:{code:`${y}4023`,message:'Error importing view with name "{0}", failure was: {1}',level:_,stack:"{2}"},VIEW_MISSING:{code:`${y}4024`,message:'Expected a view with name "{0}" in the viewset',level:_},VIEW_IMPORT_FAILED_WITH_SPECIFIER:{code:`${y}4025`,message:'Error importing module "{0}" from view with name "{1}", failure was: {2}',level:_,stack:"{3}"},NO_ROUTE_MATCH:{code:`${y}4026`,message:"A routing match cannot be found for: {0}",level:_},INVALID_ROUTE_HANDLER:{code:`${y}4027`,message:'Route definition "{0}" does not have a valid route handler module',level:_},DESTINATION_NOT_FOUND:{code:`${y}4028`,message:"Route handler returned 404: Not Found",level:_},DESTINATION_ERROR:{code:`${y}4029`,message:"Route handler returned error status {0}: {1}",level:_,stack:"{2}"}},C=new WeakMap;function T(e){var t;return(t=class{constructor(e){this._callback=e}connect(){}disconnect(){}update(e,t){t&&this._callback(t)}static setContext(t,r){e.setContext(t,r)}static getContext(t){return e.getContext(t)}static clearContext(t){e.clearContext(t)}static subscribeContext(t,r){e.subscribeContext(t,r)}static unsubscribeContext(t,r){e.unsubscribeContext(t,r)}}).contextSchema={value:"required"},t}const S=T(new E(void 0)),D=T(new E(void 0)),A=new E(void 0),M=class extends(T(A)){async update(e,t){if(t){const r=e&&e.viewName?e.viewName:"default",i=t.viewset[r],n=i,o=n&&n.module||i;let s;if(o)try{const e=await o(),t=e&&e.default;if(!t||void 0===t.constructor)throw new Error("error occurred with view import");this._callback(t)}catch(e){const t=e;s=n.specifier?P(x.VIEW_IMPORT_FAILED_WITH_SPECIFIER,[n.specifier,r,t.message,t.stack||""]):P(x.VIEW_IMPORT_FAILED,[r,t.message,t.stack||""])}else s=P(x.VIEW_MISSING,[r]);t.onComplete&&t.onComplete(s)}}};function $(){const e=[],t=t=>{"function"==typeof t&&e.push(t)};return{add:(e=[])=>{Array.isArray(e)?e.forEach((e=>t(e))):t(e)},compile:t=>0===e.length?Promise.resolve(!0):e.reduce(((e,r)=>e.then((e=>!1===e?Promise.reject():Promise.resolve(r(t))))),Promise.resolve(!0)).then((e=>!1!==e)).catch((e=>{if(e instanceof Error)throw e;return!1})),empty:()=>0===e.length}}function L(e=""){return e=e||"",decodeURIComponent(e)}function U(){return Math.floor(65536*(1+Math.random())).toString(16).substring(1)}const j="undefined"!=typeof document,k=`universalcontainergetnavigationcontext${U()}`,F=j?i(D):void 0,V=j?i(M):void 0,G=j?i(S):void 0;function W(e,t,r,i){r&&i&&(i.setContext(t,e),r(t,{consumerConnectedCallback:i.subscribeContext.bind(i,t),consumerDisconnectedCallback:i.unsubscribeContext.bind(i,t)}))}function H(){let e,t,r=[];const i=i=>{r.filter((e=>null!==e)).forEach((e=>e.error&&e.error(i))),e=void 0,t=i};return{next:i=>{r.filter((e=>null!==e)).forEach((e=>e.next&&e.next(i))),e=i,t=void 0},error:i,complete:()=>{r.filter((e=>null!==e)).forEach((e=>e.complete&&e.complete())),r=[],e=void 0,t=void 0},subscribe:(n,o=!0)=>{(e=>{r.push(e)})(n),e&&o&&n.next(e),t&&i(t);const s=r.length-1;return{unsubscribe:()=>(e=>{r=[...r.slice(0,e),...r.slice(e+1)]})(s)}}}}function B(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,i)}return r}function X(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{};t%2?B(Object(r),!0).forEach((function(t){q(e,t,r[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):B(Object(r)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(r,t))}))}return e}function q(e,t,r){return(t=function(e){var t=function(e,t){if("object"!=typeof e||null===e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var i=r.call(e,t||"default");if("object"!=typeof i)return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==typeof t?t:String(t)}(t))in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}const z=`universalcontainernavigationevent${U()}`,Y=`universalcontainerparentevent${U()}`;class J{constructor(e,t,r){this.pendingRoute=null,this.committedRoute=null,this.contextId=Object.freeze((()=>{})),this.connected=!1,this.preNavFilters=$(),this.errorNavFilters=$(),this._handleNavigationEvent=e=>{const t=e;if(t.detail&&"object"==typeof t.detail){const{url:e,replace:r,address:i}=t.detail;this.config.handleNavigation(i,r)?this.root&&!e?this.root.processError(P(x.MISSING_URL,[JSON.stringify(i)])):this.parent||this.process(e,r):t.stopPropagation()}},this._handleParentEvent=e=>{e.stopImmediatePropagation();const t=e;t&&t.detail&&"function"==typeof t.detail&&t.detail(this)},this.config={handleNavigation:e.handleNavigation||(()=>!0)},this.target=r||window,this.router=t,this.router.contextId=this.contextId,this.routeObservable=H()}get root(){if(!this.parent)return this;let e=this.parent;for(;e;){if(!e.parent)return e;e=e.parent}throw new Error("No root router could be found")}updateWires(e,t,r){if(r)this.processError(r);else{if(this.committedRoute&&e.route===this.committedRoute.route)return;l({id:a,specifier:this.eventId}),this.pendingRoute=this.pendingRoute||X(X({},e),{},{url:t}),this.committedRoute=X(X({},this.pendingRoute),e),D.setContext(this.target,e.route.pageReference),this.routeObservable.next(X(X({},this.committedRoute),{},{viewset:e.viewset})),l({id:c,specifier:this.eventId}),this.child&&this.child.process(this._stripUrlForChild(this.committedRoute.url))}}connect(){this._sendEvent(Y,(e=>{this.parent=e,e.addChild(this)}));const e={navigate:(e,t)=>this.navigate(e,t),generateUrl:e=>this.generateUrl(e),subscribe:(e,t)=>this.subscribe(e,t)};!function(e,t){const r={id:e,value:t,update:e=>{r.value=e}};C.set(r.id,r)}(this.contextId,e),W(this.contextId,this.target,G,S),W(void 0,this.target,F,D),W(void 0,this.target,V,M),this.router.subscribe((e=>{if(404===e.status)return void this.processError(P(x.DESTINATION_NOT_FOUND));if(e.status&&e.status>=400){const t=e.error||new Error;return void this.processError(P(x.DESTINATION_ERROR,[e.status.toString(),t.message,t.stack||""]))}const t=e.route.pageReference||{},r=this.router.generateUrl(t)||"";if(h({id:a,specifier:this.eventId}),e.viewset){const t={viewset:e.viewset,onComplete:this.updateWires.bind(this,e,r)};M.setContext(this.target,t)}else e.route.pageReference&&this.updateWires(e,r)}),!0),j&&(this.target.addEventListener(z,this._handleNavigationEvent),this.target.addEventListener(Y,this._handleParentEvent),this.target.addEventListener(k,(e=>{const t=e;t.detail.callback&&t.detail.callback(this.contextId)}))),this.connected=!0}disconnect(){this.target.removeEventListener(z,this._handleNavigationEvent),this.target.removeEventListener(Y,this._handleParentEvent),this.parent&&(this.parent.child=void 0),this.parent=void 0,this.child&&(this.child.parent=void 0),this.child=void 0,this.connected=!1}addPreNavigate(e){this.preNavFilters.add(e)}addErrorNavigate(e){this.errorNavFilters.add(e)}async addChild(e){if(await new Promise((t=>{setTimeout((()=>{R(!this.child,x.MULTIPLE_CHILDREN),this.child=e,t()}),0)})),this.child&&this.committedRoute){const e=this._stripUrlForChild(this.committedRoute.url);await this.child.preProcess(e)&&this.child.process(e)}}async process(e,t){this.eventId=(new Date).getTime().toString(),h({id:c,specifier:this.eventId});try{this.parent||await this.preProcess(e)}catch(e){if(e.code)return this.processError(e),!1;throw e}const r=this.router.parseUrl(e);return r&&this.router.navigate(r),!0}preProcess(e){const t=this.router.parseUrl(e),r=t&&this.router.matchRoute(t);if(!r)return Promise.reject(P(x.MISSING_ROUTE,[e]));this.pendingRoute=X({url:e},r);return(this.preNavFilters.empty()?Promise.resolve(!0):this.preNavFilters.compile({current:this.committedRoute||void 0,next:this.pendingRoute})).then((t=>t&&this.child?this.child.preProcess(this._stripUrlForChild(e)):t)).then((t=>t||Promise.reject(P(x.PRENAV_FAILED,[e]))))}processError(e){h({id:d}),this.errorNavFilters.compile(e),this.child&&this.child.processError(e)}navigate(e,t){let r=this.router.generateUrl(e);if(r){r=(this.parent&&this.parent.committedRoute&&this.parent.committedRoute.pathMatch||"").concat(r)}this._sendEvent(z,{url:r,replace:t,address:e})}generateUrl(e){const t=this.router.generateUrl(e);if(!t)return null;return`${this.parent&&this.parent.committedRoute&&this.parent.committedRoute.pathMatch||""}${t}`}subscribe(e,t){return this.routeObservable.subscribe({next:e,error:()=>{},complete:()=>{}},Boolean(t))}_sendEvent(e,t){j&&this.target.dispatchEvent(new CustomEvent(e,{bubbles:!0,composed:!0,detail:t}))}_stripUrlForChild(e){return this.pendingRoute&&0===e.indexOf(this.pendingRoute.pathMatch)?e.replace(this.pendingRoute.pathMatch,""):e}}function Q(e){const t=function(e=""){if((e=e||"").indexOf("://")<0){const t=window.location.port?`:${window.location.port}`:"",r=`${window.location.protocol}//${window.location.hostname}${t}`,i="/"===e.charAt(0)?"":"/";e=r+i+e}const t={},r=document.createElement("a");r.href=e;const i=r.search.substring(1);return i&&i.split("&").forEach((e=>{const[r,i=""]=e.split("=");t[L(r)]=L(i)})),{href:r.href,origin:`${r.protocol}//${r.hostname}${r.port?`:${r.port}`:""}`,pathname:r.pathname.replace(/(\/)?/,"/"),searchParams:t}}(e),r=t.href.replace(/:\d+/,""),i=t.origin.replace(/:\d+/,"");return r.replace(i,"")}class K extends J{constructor(){super(...arguments),this.historyDisabled=!1}connect(){super.connect(),this.historyDisabled||(j&&window.addEventListener("popstate",this.onpopstate.bind(this)),this.onpopstate())}onpopstate(){!this.parent&&j&&this.catchBrowserUpdate(Q(document.location.href))}disconnect(){super.disconnect(),j&&window.removeEventListener("popstate",this.onpopstate)}async process(e,t,r=!0){const i=await super.process(e);return i&&!this.historyDisabled&&r&&this.connected&&!this.parent&&(t?function(e,t){const r=t||{};window.history.replaceState(r,"",e)}(e):function(e,t){const r=t||{};window.history.pushState(r,"",e)}(e)),i}catchBrowserUpdate(e){this.process(e,!1,!1)}}let Z=!1;class ee extends s{constructor(){super(),this.router=void 0,this.historyDisabled=!1,this.currentTitle=j?document.title:""}connectedCallback(){const e={historyDisabled:this.historyDisabled,handleNavigation:this.handleNavigation.bind(this)};this.router&&(this.routerApi=function(e,t={},r){const i=t.historyDisabled?new J(t,r,e):new K(t,r,e),n={addPreNavigate:e=>(i.addPreNavigate(e),n),addPostNavigate:e=>(i.subscribe(e),n),addErrorNavigate:e=>(i.addErrorNavigate(e),n),connect:()=>{i.connect(),R(!Z||!!i.parent,x.MULTIPLE_ROOTS),Z=Z||!i.parent,n.id=i.contextId},disconnect:()=>{Z=Z&&!!i.parent,i.disconnect()}};return n}(this,e,this.router),this.routerApi.addPreNavigate(this.preNavigate.bind(this)).addPostNavigate(this.postNavigate.bind(this)).addErrorNavigate(this.errorNavigate.bind(this)).connect())}preNavigate(e){const t=this._createEvent("prenavigate",e,!0);return this.dispatchEvent(t),!t.defaultPrevented}postNavigate(e){this.dispatchEvent(this._createEvent("postnavigate",e));const t=e.routeDefinition.metadata&&e.routeDefinition.metadata.title;t&&(this.currentTitle=t,document.title=t);const r=this.querySelector("span.router-title");r&&(r.innerHTML=this.currentTitle)}errorNavigate(e){return this.dispatchEvent(this._createEvent("errornavigate",e)),!0}handleNavigation(e,t){const r=this._createEvent("handlenavigation",{address:e,replace:t},!0);return this.dispatchEvent(r),!r.defaultPrevented}disconnectedCallback(){this.routerApi&&this.routerApi.disconnect()}_createEvent(e,t,r){return new CustomEvent(e,{detail:t,bubbles:!1,composed:!1,cancelable:r})}}ee.renderMode="light",n(ee,{publicProps:{router:{config:0},historyDisabled:{config:0}}});var te=o(ee,{tmpl:m,sel:"lwr-router-container"});export{te as default};
+//# sourceMappingURL=routerContainer.js.map

package/build/es/modules/lwr/currentPageReference/currentPageReference.d.ts

@@ -1,5 +1,5 @@
 import type { PageReference } from 'lwr/router';
-type PageReferenceContext = PageReference | undefined;
+declare type PageReferenceContext = PageReference | undefined;
 /**
  * Services @wire(CurrentPageReference) requests.
  * Hooks up to an Observable from the current navigation context.

package/build/es/modules/lwr/currentView/currentView.d.ts

@@ -1,11 +1,11 @@
 /// <reference types="lwc" />
 import type { ViewSet } from 'lwr/router';
 import type { Constructable } from 'lwr/routerUtils';
-type ViewContext = {
+declare type ViewContext = {
     viewset: ViewSet;
     onComplete?: Function;
 } | undefined;
-type CurrentViewConfig = {
+declare type CurrentViewConfig = {
     viewName?: string;
 };
 /**

package/build/es/modules/lwr/domRouter/domRouter.d.ts

@@ -14,8 +14,8 @@ export declare const PARENT_EVENT: string;
 interface RouterParent {
     addChild(child: DomRouter): Promise<void>;
 }
-export type ParentRouterEvent = CustomEvent<(router: RouterParent) => void>;
-type DomRoutingMatch = RoutingMatch & {
+export declare type ParentRouterEvent = CustomEvent<(router: RouterParent) => void>;
+declare type DomRoutingMatch = RoutingMatch & {
     url: string;
 };
 interface DomRouterNode extends RouterParent {

package/build/es/modules/lwr/domRouterUtils/types.d.ts

@@ -3,7 +3,7 @@ export interface RouteChange {
     current?: RoutingMatch;
     next: RoutingMatch;
 }
-export type NavigationHandler = (address: PageReference, replace?: boolean) => boolean;
+export declare type NavigationHandler = (address: PageReference, replace?: boolean) => boolean;
 export interface DomRouterConfig {
     handleNavigation?: NavigationHandler;
 }

package/build/es/modules/lwr/navigationContext/navigationContext.d.ts

@@ -1,5 +1,5 @@
-export type ContextId = () => void;
-type NavigationContextType = ContextId | undefined;
+export declare type ContextId = () => void;
+declare type NavigationContextType = ContextId | undefined;
 export declare const NavigationContext: import("lwr/contextUtils").ContextualWireAdapter<NavigationContextType, unknown, NavigationContextType>;
 export {};
 //# sourceMappingURL=navigationContext.d.ts.map

package/build/es/modules/lwr/navigationMixinHacks/navigationMixinHacks.d.ts

@@ -1,7 +1,7 @@
 export declare const CONTEXT_ID_BACKDOOR: string;
-export type NavigationContextBackdoorEvent = globalThis.CustomEvent<NavigationContextBackdoorEventPayload>;
+export declare type NavigationContextBackdoorEvent = globalThis.CustomEvent<NavigationContextBackdoorEventPayload>;
 import type { ContextId } from 'lwr/navigation';
-export type NavigationContextBackdoorEventPayload = {
+export declare type NavigationContextBackdoorEventPayload = {
     callback: (contextId: ContextId) => void;
 };
 //# sourceMappingURL=navigationMixinHacks.d.ts.map

package/build/es/modules/lwr/routerUtils/filterUtils.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-export type Filter<V> = (v: V) => Promise<boolean> | boolean;
+export declare type Filter<V> = (v: V) => Promise<boolean> | boolean;
 export interface FilterChain<V> {
     add: (f: Filter<V>[] | Filter<V>) => void;
     compile: (arg: V) => Promise<boolean>;

package/build/es/modules/lwr/routerUtils/pathToRegexp.d.ts

@@ -26,7 +26,7 @@ export interface TokensToFunctionOptions {
      */
     validate?: boolean;
 }
-export type PathFunction<P extends object = object> = (data?: P) => string;
+export declare type PathFunction<P extends object = object> = (data?: P) => string;
 /**
  * Expose a method for transforming tokens into the path function.
  */
@@ -52,11 +52,11 @@ export interface MatchResult<P extends object = object> {
 /**
  * A match is either `false` (no match) or a match result.
  */
-export type Match<P extends object = object> = false | MatchResult<P>;
+export declare type Match<P extends object = object> = false | MatchResult<P>;
 /**
  * The match function takes a string and returns whether it matched the path.
  */
-export type MatchFunction<P extends object = object> = (path: string) => Match<P>;
+export declare type MatchFunction<P extends object = object> = (path: string) => Match<P>;
 /**
  * Create a path match function from `path-to-regexp` output.
  */
@@ -74,7 +74,7 @@ export interface Key {
 /**
  * A token is a string (nothing special) or key metadata (capture group).
  */
-export type Token = string | Key;
+export declare type Token = string | Key;
 export interface TokensToRegexpOptions {
     /**
      * When `true` the regexp will be case sensitive. (default: `false`)
@@ -112,7 +112,7 @@ export declare function tokensToRegexp(tokens: Token[], keys?: Key[], options?:
 /**
  * Supported `path-to-regexp` input types.
  */
-export type Path = string | RegExp | Array<string | RegExp>;
+export declare type Path = string | RegExp | Array<string | RegExp>;
 /**
  * Normalize the given path string, returning a regular expression.
  *

package/build/es/modules/lwr/routerUtils/types.d.ts

@@ -1,40 +1,40 @@
 import type { Key, PathFunction } from './pathToRegexp';
 import type { ContextId } from 'lwr/navigationContext';
 import { Unsubscriber } from 'lwr/observable';
-export type Module = Record<string | symbol | number, unknown>;
-export type Constructor<T = object> = new (...args: any[]) => T;
+export declare type Module = Record<string | symbol | number, unknown>;
+export declare type Constructor<T = object> = new (...args: any[]) => T;
 export interface Constructable<T = object> {
     constructor: Constructor<T>;
 }
-export type UrlMapper<TAddress> = {
+export declare type UrlMapper<TAddress> = {
     generateUrl(address: TAddress): string | null;
     parseUrl(url: string): TAddress | null;
 };
-export type RouteMatcher<TAddress> = {
+export declare type RouteMatcher<TAddress> = {
     matchRoute(address: TAddress): RoutingMatch | null;
 };
-export type ViewMapper<TAddress> = {
+export declare type ViewMapper<TAddress> = {
     navigate(address: TAddress): void;
     subscribe(callback: RouteCallback, replay?: boolean): Unsubscriber;
     resolveView(address: TAddress): Promise<RouteDestination>;
     contextId?: ContextId;
 };
-export type Router<TAddress = string> = ViewMapper<TAddress> & UrlMapper<TAddress> & RouteMatcher<TAddress>;
+export declare type Router<TAddress = string> = ViewMapper<TAddress> & UrlMapper<TAddress> & RouteMatcher<TAddress>;
 export interface DEPRECATED_getRouteFromUrl {
     <TAddress>(url: string, defaultImpl: Function): TAddress | null;
 }
 export interface DEPRECATED_getUrlFromRoute {
     <TAddress>(route: TAddress, defaultImpl: Function): string | null;
 }
-export type RouterConfig = {
+export declare type RouterConfig = {
     basePath?: string;
     routes?: RouteDefinition[];
     caseSensitive?: boolean;
     DEPRECATED_getRouteFromUrl?: DEPRECATED_getRouteFromUrl;
     DEPRECATED_getUrlFromRoute?: DEPRECATED_getUrlFromRoute;
 };
-export type RouterSerializationConfig<TAddress> = Required<Omit<RouterConfig, 'DEPRECATED_getRouteFromUrl' | 'DEPRECATED_getUrlFromRoute'> & UrlMapper<TAddress>>;
-export type RouteParameterPatterns = {
+export declare type RouterSerializationConfig<TAddress> = Required<Omit<RouterConfig, 'DEPRECATED_getRouteFromUrl' | 'DEPRECATED_getUrlFromRoute'> & UrlMapper<TAddress>>;
+export declare type RouteParameterPatterns = {
     [paramName: string]: string;
 };
 export interface RouteDefinition<TMetadata = Record<string, any>> {
@@ -46,21 +46,21 @@ export interface RouteDefinition<TMetadata = Record<string, any>> {
     handler: () => Promise<RouteHandlerModule>;
     metadata?: TMetadata;
 }
-export type PageBindings = {
+export declare type PageBindings = {
     attributeBindings: NullableStringAttributes;
     stateBindings: NullableStringAttributes;
 };
-type CompiledQueryResult = {
+declare type CompiledQueryResult = {
     literalValue?: string | null;
     routeParamName?: string;
 };
-export type CompiledQuery = Record<string, CompiledQueryResult>;
-type MatchedQueryResult = {
+export declare type CompiledQuery = Record<string, CompiledQueryResult>;
+declare type MatchedQueryResult = {
     value: string | null;
     routeParamName?: string;
 };
-export type MatchedQuery = Record<string, MatchedQueryResult>;
-export type QueryMatcher = (queryObject: QueryObject) => MatchedQuery | null;
+export declare type MatchedQuery = Record<string, MatchedQueryResult>;
+export declare type QueryMatcher = (queryObject: QueryObject) => MatchedQuery | null;
 export interface CompiledRouteDefinition {
     original: RouteDefinition;
     regex: RegExp;
@@ -69,11 +69,11 @@ export interface CompiledRouteDefinition {
     compiledQuery: CompiledQuery;
     queryMatcher: QueryMatcher;
 }
-export type RouteHandlerCallback = (routeDestination: RouteDestination) => void;
-export type RouteHandlerClass = {
+export declare type RouteHandlerCallback = (routeDestination: RouteDestination) => void;
+export declare type RouteHandlerClass = {
     new (callback: RouteHandlerCallback): RouteHandler;
 };
-export type RouteHandlerModule = {
+export declare type RouteHandlerModule = {
     default: RouteHandlerClass;
 };
 export interface RouteInstance {
@@ -82,12 +82,12 @@ export interface RouteInstance {
     state: NullableStringAttributes;
     pageReference: PageReference;
 }
-export type RouteDestination = {
+export declare type RouteDestination = {
     status?: 200 | 404 | 500;
     viewset: ViewSet;
     error?: Error;
 };
-export type RoutingMatch = {
+export declare type RoutingMatch = {
     pathMatch: string;
     route: RouteInstance;
     routeDefinition: RouteDefinition;
@@ -96,7 +96,7 @@ export interface CompiledRoutingMatch {
     route: RouteInstance;
     routeDefinition: CompiledRouteDefinition;
 }
-export type RoutingResult = RoutingMatch & RouteDestination;
+export declare type RoutingResult = RoutingMatch & RouteDestination;
 export interface ViewSet {
     [viewName: string]: (() => Promise<Module>) | ViewInfo;
 }
@@ -104,7 +104,7 @@ export interface ViewInfo {
     module: () => Promise<Module>;
     specifier: string;
 }
-export type RouteCallback = (result: RoutingResult) => void;
+export declare type RouteCallback = (result: RoutingResult) => void;
 export interface RouteHandler {
     dispose(): void;
     update(routeInfo: RouteInstance): void;
@@ -122,7 +122,7 @@ export interface MessageObject {
     url?: string;
     address?: string;
 }
-export type QueryObject = NullableStringAttributes;
+export declare type QueryObject = NullableStringAttributes;
 export interface StringAttributes {
     [key: string]: string;
 }

package/package.json

@@ -5,7 +5,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.10.0-alpha.12",
+    "version": "0.10.0-alpha.13",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -45,18 +45,18 @@
     "scripts": {
         "build": "node ../../../bin/pack-lwc --dir src/modules build/modules && yarn utam:compile && yarn build:bundle",
         "build:bundle": "rollup --config scripts/rollup.moduleBundle.config.cjs",
-        "utam:compile": "utam -c utam.config.cjs -t module"
+        "utam:compile": "utam -c utam.config.cjs"
     },
     "dependencies": {
-        "@lwrjs/client-modules": "0.10.0-alpha.12",
-        "@lwrjs/diagnostics": "0.10.0-alpha.12",
-        "@lwrjs/shared-utils": "0.10.0-alpha.12",
+        "@lwrjs/client-modules": "0.10.0-alpha.13",
+        "@lwrjs/diagnostics": "0.10.0-alpha.13",
+        "@lwrjs/shared-utils": "0.10.0-alpha.13",
         "ajv": "6.12.6"
     },
     "devDependencies": {
         "@rollup/plugin-typescript": "^11.1.0",
         "rollup": "^2.78.0",
-        "utam": "^2.0.0"
+        "utam": "^2.0.2"
     },
     "lwc": {
         "modules": [
@@ -84,5 +84,5 @@
     "volta": {
         "extends": "../../../package.json"
     },
-    "gitHead": "c280f6e4914d67a58cb18a52d2320824c8ed4a7b"
+    "gitHead": "f6d142d5a027554cb1685389e0b173734149683d"
 }