@microsoft/fast-router 1.0.0-alpha.19 → 1.0.0-alpha.20

package/CHANGELOG.json

@@ -1,6 +1,33 @@
 {
   "name": "@microsoft/fast-router",
   "entries": [
+    {
+      "date": "Wed, 11 Jan 2023 22:07:44 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.20",
+      "version": "1.0.0-alpha.20",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-router",
+            "commit": "26fdb6b0dd0eafab1c4cb2769b7e7aaa24c673c9",
+            "comment": "fix: router cannot render component and has missing types"
+          },
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-router",
+            "commit": "5c3b2f0431ae8f840d3dc778ff93be73b585c6e2",
+            "comment": "fix(fast-router): update to use html.partial"
+          },
+          {
+            "author": "beachball",
+            "package": "@microsoft/fast-router",
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.20",
+            "commit": "2bb85c931a84d4de3a8b61d6f26f89f2d9a525f6"
+          }
+        ]
+      }
+    },
     {
       "date": "Fri, 02 Dec 2022 01:18:22 GMT",
       "tag": "@microsoft/fast-router_v1.0.0-alpha.19",

package/CHANGELOG.md

@@ -1,9 +1,19 @@
 # Change Log - @microsoft/fast-router
 
-This log was last generated on Fri, 02 Dec 2022 01:18:22 GMT and should not be manually modified.
+This log was last generated on Wed, 11 Jan 2023 22:07:44 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## 1.0.0-alpha.20
+
+Wed, 11 Jan 2023 22:07:44 GMT
+
+### Changes
+
+- fix: router cannot render component and has missing types (roeisenb@microsoft.com)
+- fix(fast-router): update to use html.partial (roeisenb@microsoft.com)
+- Bump @microsoft/fast-element to v2.0.0-beta.20
+
 ## 1.0.0-alpha.19
 
 Fri, 02 Dec 2022 01:18:22 GMT

package/dist/dts/phases.d.ts

@@ -33,5 +33,5 @@ export interface NavigationPhase<TSettings = any> {
  * @beta
  */
 export interface NavigationCommitPhase<TSettings = any> extends Omit<NavigationPhase<TSettings>, "cancel" | "canceled" | "onCancel"> {
-    setTitle(title: string): any;
+    setTitle(title: string): void;
 }

package/dist/dts/query-string.d.ts

@@ -10,7 +10,7 @@ export declare const QueryString: Readonly<{
      * @param traditional - Boolean Use the old URI template standard (RFC6570)
      * @returns The generated query string, excluding leading '?'.
      */
-    build(params: Object, traditional?: boolean): string;
+    build(params: Record<string, string>, traditional?: boolean): string;
     /**
      * Separate the query string from the path and returns the two parts.
      * @param path - The path to separate.

package/dist/dts/recognizer.d.ts

@@ -2,7 +2,16 @@ import { Route } from "./navigation.js";
 /**
  * @beta
  */
-export declare type RouteParameterConverter = (value: string | undefined) => any | Promise<any>;
+export interface RouteParameterConverterContext<TSettings = any> {
+    readonly endpoint: Endpoint<TSettings>;
+    readonly params: Readonly<Record<string, string | undefined>>;
+    readonly typedParams: Record<string, any>;
+    readonly queryParams: Record<string, string>;
+}
+/**
+ * @beta
+ */
+export declare type RouteParameterConverter = (name: string, value: string | undefined, context: RouteParameterConverterContext) => any | Promise<any>;
 /**
  * @beta
  */

package/dist/dts/router.d.ts

@@ -32,8 +32,8 @@ declare const routerProperty = "$router";
 export interface RouterElement extends HTMLElement {
     readonly [routerProperty]: Router;
     config: RouterConfiguration | null;
-    connectedCallback(): any;
-    disconnectedCallback(): any;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
 }
 /**
  * @beta

package/dist/dts/routes.d.ts

@@ -125,13 +125,13 @@ export declare type RouteMatch<TSettings = any> = {
 /**
  * @beta
  */
-export declare type ConverterObject = {
+export declare type RouteParameterConverterObject = {
     convert: RouteParameterConverter;
 };
 /**
  * @beta
  */
-export declare type ParameterConverter = RouteParameterConverter | ConverterObject | Constructable<ConverterObject>;
+export declare type ParameterConverter = RouteParameterConverter | RouteParameterConverterObject | Constructable<RouteParameterConverterObject>;
 /**
  * @beta
  */

package/dist/esm/commands.js

@@ -45,8 +45,9 @@ export class Redirect {
         });
     }
 }
-function factoryFromElementName(name) {
-    return html `<${name} ${navigationContributor()}></${name}>`;
+function factoryFromElementName(tagName) {
+    const tag = html.partial(tagName);
+    return html `<${tag} ${navigationContributor()}></${tag}>`;
 }
 function factoryFromElementInstance(element) {
     const fragment = document.createDocumentFragment();

package/dist/esm/recognizer.js

@@ -1,6 +1,8 @@
 import { __awaiter } from "tslib";
 import { QueryString } from "./query-string.js";
-const defaultParameterConverter = (value) => value;
+const defaultParameterConverter = (name, value, context) => {
+    return value;
+};
 /**
  * @beta
  */
@@ -35,7 +37,7 @@ export class RecognizedRoute {
         this.typedParams = typedParams;
         this.queryParams = queryParams;
         this.allParams = Object.assign(Object.assign({}, params), queryParams);
-        this.allTypedParams = Object.assign(Object.assign({}, typedParams), queryParams);
+        this.allTypedParams = Object.assign(Object.assign({}, queryParams), typedParams);
     }
     get settings() {
         return this.endpoint.settings;
@@ -386,12 +388,17 @@ export class DefaultRouteRecognizer {
             const paramTypes = endpoint.paramTypes;
             const params = candidate.getParams();
             const typedParams = {};
+            const converterContext = {
+                endpoint,
+                params,
+                typedParams,
+                queryParams,
+            };
             for (let i = 0, ii = paramNames.length; i < ii; ++i) {
-                const name = paramNames[i];
+                const paramName = paramNames[i];
+                const paramValue = params[paramName];
                 const convert = converters[paramTypes[i]] || defaultParameterConverter;
-                const untypedValue = params[name];
-                const typedValue = yield convert(untypedValue);
-                typedParams[name] = typedValue;
+                typedParams[paramName] = yield convert(paramName, paramValue, converterContext);
             }
             return new RecognizedRoute(endpoint, params, typedParams, queryParams);
         });

package/dist/esm/router.js

@@ -31,13 +31,20 @@ export const Router = Object.freeze({
         class RouterBase extends BaseType {
             constructor() {
                 super();
-                Router.getOrCreateFor(this);
-            }
-            get config() {
-                return this[routerProperty].config;
-            }
-            set config(value) {
-                this[routerProperty].config = value;
+                const router = Router.getOrCreateFor(this);
+                const config = this.config || null;
+                delete this.config;
+                Reflect.defineProperty(this, "config", {
+                    get() {
+                        return router.config;
+                    },
+                    set(value) {
+                        router.config = value;
+                    },
+                });
+                if (config !== null) {
+                    router.config = config;
+                }
             }
         }
         const proto = RouterBase.prototype;
@@ -113,7 +120,7 @@ export class DefaultRouter {
             }
             this.parentRouter = findParentRouterForElement(this.host);
         }
-        return this.parentRouter || null;
+        return this.parentRouter;
     }
     get level() {
         if (this.parent === null) {

package/dist/esm/routes.js

@@ -17,7 +17,7 @@ function getFallbackCommand(config, definition) {
         return Render.fromDefinition(config, definition);
     }
 }
-const booleanConverter = value => {
+const booleanConverter = (name, value) => {
     if (value === void 0 || value === null) {
         return false;
     }
@@ -31,11 +31,11 @@ const booleanConverter = value => {
     }
 };
 const defaultConverters = {
-    number: value => (value === void 0 ? NaN : parseFloat(value)),
-    float: value => (value === void 0 ? NaN : parseFloat(value)),
-    int: value => (value === void 0 ? NaN : parseInt(value)),
-    integer: value => (value === void 0 ? NaN : parseInt(value)),
-    Date: value => (value === void 0 ? new Date(Date.now()) : new Date(value)),
+    number: (name, value) => (value === void 0 ? NaN : parseFloat(value)),
+    float: (name, value) => (value === void 0 ? NaN : parseFloat(value)),
+    int: (name, value) => (value === void 0 ? NaN : parseInt(value)),
+    integer: (name, value) => (value === void 0 ? NaN : parseInt(value)),
+    Date: (name, value) => value === void 0 ? new Date(Date.now()) : new Date(value),
     boolean: booleanConverter,
     bool: booleanConverter,
 };
@@ -129,9 +129,9 @@ export class RouteCollection {
             normalizedConverter = converter.convert.bind(converter);
         }
         else if (converter.prototype && "convert" in converter.prototype) {
-            normalizedConverter = (value) => {
+            normalizedConverter = (name, value, context) => {
                 const obj = this.owner.construct(converter);
-                return obj.convert(value);
+                return obj.convert(name, value, context);
             };
         }
         else {

package/dist/fast-router.api.json

@@ -461,40 +461,6 @@
             "endIndex": 2
           }
         },
-        {
-          "kind": "TypeAlias",
-          "canonicalReference": "@microsoft/fast-router!ConverterObject:type",
-          "docComment": "/**\n * @beta\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export declare type ConverterObject = "
-            },
-            {
-              "kind": "Content",
-              "text": "{\n    convert: "
-            },
-            {
-              "kind": "Reference",
-              "text": "RouteParameterConverter",
-              "canonicalReference": "@microsoft/fast-router!RouteParameterConverter:type"
-            },
-            {
-              "kind": "Content",
-              "text": ";\n}"
-            },
-            {
-              "kind": "Content",
-              "text": ";"
-            }
-          ],
-          "releaseTag": "Beta",
-          "name": "ConverterObject",
-          "typeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 4
-          }
-        },
         {
           "kind": "Class",
           "canonicalReference": "@microsoft/fast-router!DefaultLinkHandler:class",
@@ -3674,7 +3640,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "any"
+                  "text": "void"
                 },
                 {
                   "kind": "Content",
@@ -4817,8 +4783,8 @@
             },
             {
               "kind": "Reference",
-              "text": "ConverterObject",
-              "canonicalReference": "@microsoft/fast-router!ConverterObject:type"
+              "text": "RouteParameterConverterObject",
+              "canonicalReference": "@microsoft/fast-router!RouteParameterConverterObject:type"
             },
             {
               "kind": "Content",
@@ -4835,8 +4801,8 @@
             },
             {
               "kind": "Reference",
-              "text": "ConverterObject",
-              "canonicalReference": "@microsoft/fast-router!ConverterObject:type"
+              "text": "RouteParameterConverterObject",
+              "canonicalReference": "@microsoft/fast-router!RouteParameterConverterObject:type"
             },
             {
               "kind": "Content",
@@ -4999,12 +4965,12 @@
             },
             {
               "kind": "Reference",
-              "text": "Object",
-              "canonicalReference": "!Object:interface"
+              "text": "Record",
+              "canonicalReference": "!Record:type"
             },
             {
               "kind": "Content",
-              "text": ", traditional?: boolean): string;\n    separate(path: string): "
+              "text": "<string, string>, traditional?: boolean): string;\n    separate(path: string): "
             },
             {
               "kind": "Reference",
@@ -7187,7 +7153,16 @@
             },
             {
               "kind": "Content",
-              "text": "(value: string | undefined) => any | "
+              "text": "(name: string, value: string | undefined, context: "
+            },
+            {
+              "kind": "Reference",
+              "text": "RouteParameterConverterContext",
+              "canonicalReference": "@microsoft/fast-router!RouteParameterConverterContext:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ") => any | "
             },
             {
               "kind": "Reference",
@@ -7205,6 +7180,210 @@
           ],
           "releaseTag": "Beta",
           "name": "RouteParameterConverter",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 6
+          }
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@microsoft/fast-router!RouteParameterConverterContext:interface",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface RouteParameterConverterContext<TSettings = "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": "> "
+            }
+          ],
+          "releaseTag": "Beta",
+          "typeParameters": [
+            {
+              "typeParameterName": "TSettings",
+              "constraintTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "name": "RouteParameterConverterContext",
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/fast-router!RouteParameterConverterContext#endpoint:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly endpoint: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Endpoint",
+                  "canonicalReference": "@microsoft/fast-router!Endpoint:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TSettings>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "endpoint",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/fast-router!RouteParameterConverterContext#params:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly params: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Readonly",
+                  "canonicalReference": "!Readonly:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, string | undefined>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "params",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/fast-router!RouteParameterConverterContext#queryParams:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly queryParams: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, string>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "queryParams",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@microsoft/fast-router!RouteParameterConverterContext#typedParams:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly typedParams: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, any>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "typedParams",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@microsoft/fast-router!RouteParameterConverterObject:type",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare type RouteParameterConverterObject = "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    convert: "
+            },
+            {
+              "kind": "Reference",
+              "text": "RouteParameterConverter",
+              "canonicalReference": "@microsoft/fast-router!RouteParameterConverter:type"
+            },
+            {
+              "kind": "Content",
+              "text": ";\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "releaseTag": "Beta",
+          "name": "RouteParameterConverterObject",
           "typeTokenRange": {
             "startIndex": 1,
             "endIndex": 4
@@ -9032,7 +9211,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "any"
+                  "text": "void"
                 },
                 {
                   "kind": "Content",
@@ -9060,7 +9239,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "any"
+                  "text": "void"
                 },
                 {
                   "kind": "Content",

package/dist/fast-router.d.ts

@@ -38,13 +38,6 @@ export declare type ContributorOptions = {
     parameters?: boolean;
 };
 
-/**
- * @beta
- */
-export declare type ConverterObject = {
-    convert: RouteParameterConverter;
-};
-
 /**
  * @beta
  */
@@ -319,7 +312,7 @@ export declare interface NavigationCommand {
  * @beta
  */
 export declare interface NavigationCommitPhase<TSettings = any> extends Omit<NavigationPhase<TSettings>, "cancel" | "canceled" | "onCancel"> {
-    setTitle(title: string): any;
+    setTitle(title: string): void;
 }
 
 /**
@@ -445,7 +438,7 @@ export declare interface NavigationQueue {
 /**
  * @beta
  */
-export declare type ParameterConverter = RouteParameterConverter | ConverterObject | Constructable<ConverterObject>;
+export declare type ParameterConverter = RouteParameterConverter | RouteParameterConverterObject | Constructable<RouteParameterConverterObject>;
 
 /**
  * @beta
@@ -471,7 +464,7 @@ export declare const QueryString: Readonly<{
      * @param traditional - Boolean Use the old URI template standard (RFC6570)
      * @returns The generated query string, excluding leading '?'.
      */
-    build(params: Object, traditional?: boolean): string;
+    build(params: Record<string, string>, traditional?: boolean): string;
     /**
      * Separate the query string from the path and returns the two parts.
      * @param path - The path to separate.
@@ -648,7 +641,24 @@ export declare type RouteMatch<TSettings = any> = {
 /**
  * @beta
  */
-export declare type RouteParameterConverter = (value: string | undefined) => any | Promise<any>;
+export declare type RouteParameterConverter = (name: string, value: string | undefined, context: RouteParameterConverterContext) => any | Promise<any>;
+
+/**
+ * @beta
+ */
+export declare interface RouteParameterConverterContext<TSettings = any> {
+    readonly endpoint: Endpoint<TSettings>;
+    readonly params: Readonly<Record<string, string | undefined>>;
+    readonly typedParams: Record<string, any>;
+    readonly queryParams: Record<string, string>;
+}
+
+/**
+ * @beta
+ */
+export declare type RouteParameterConverterObject = {
+    convert: RouteParameterConverter;
+};
 
 /**
  * @beta
@@ -737,8 +747,8 @@ export declare interface RouteRecognizer<TSettings> {
 export declare interface RouterElement extends HTMLElement {
     readonly [routerProperty]: Router;
     config: RouterConfiguration | null;
-    connectedCallback(): any;
-    disconnectedCallback(): any;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
 }
 
 /**

package/dist/fast-router.untrimmed.d.ts

@@ -41,13 +41,6 @@ export declare type ContributorOptions = {
     parameters?: boolean;
 };
 
-/**
- * @beta
- */
-export declare type ConverterObject = {
-    convert: RouteParameterConverter;
-};
-
 /**
  * @beta
  */
@@ -322,7 +315,7 @@ export declare interface NavigationCommand {
  * @beta
  */
 export declare interface NavigationCommitPhase<TSettings = any> extends Omit<NavigationPhase<TSettings>, "cancel" | "canceled" | "onCancel"> {
-    setTitle(title: string): any;
+    setTitle(title: string): void;
 }
 
 /**
@@ -448,7 +441,7 @@ export declare interface NavigationQueue {
 /**
  * @beta
  */
-export declare type ParameterConverter = RouteParameterConverter | ConverterObject | Constructable<ConverterObject>;
+export declare type ParameterConverter = RouteParameterConverter | RouteParameterConverterObject | Constructable<RouteParameterConverterObject>;
 
 /**
  * @beta
@@ -474,7 +467,7 @@ export declare const QueryString: Readonly<{
      * @param traditional - Boolean Use the old URI template standard (RFC6570)
      * @returns The generated query string, excluding leading '?'.
      */
-    build(params: Object, traditional?: boolean): string;
+    build(params: Record<string, string>, traditional?: boolean): string;
     /**
      * Separate the query string from the path and returns the two parts.
      * @param path - The path to separate.
@@ -651,7 +644,24 @@ export declare type RouteMatch<TSettings = any> = {
 /**
  * @beta
  */
-export declare type RouteParameterConverter = (value: string | undefined) => any | Promise<any>;
+export declare type RouteParameterConverter = (name: string, value: string | undefined, context: RouteParameterConverterContext) => any | Promise<any>;
+
+/**
+ * @beta
+ */
+export declare interface RouteParameterConverterContext<TSettings = any> {
+    readonly endpoint: Endpoint<TSettings>;
+    readonly params: Readonly<Record<string, string | undefined>>;
+    readonly typedParams: Record<string, any>;
+    readonly queryParams: Record<string, string>;
+}
+
+/**
+ * @beta
+ */
+export declare type RouteParameterConverterObject = {
+    convert: RouteParameterConverter;
+};
 
 /**
  * @beta
@@ -740,8 +750,8 @@ export declare interface RouteRecognizer<TSettings> {
 export declare interface RouterElement extends HTMLElement {
     readonly [routerProperty]: Router;
     config: RouterConfiguration | null;
-    connectedCallback(): any;
-    disconnectedCallback(): any;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
 }
 
 /**

package/docs/api-report.md

@@ -42,11 +42,6 @@ export type ContributorOptions = {
     parameters?: boolean;
 };
 
-// @beta (undocumented)
-export type ConverterObject = {
-    convert: RouteParameterConverter;
-};
-
 // @beta (undocumented)
 export class DefaultLinkHandler implements LinkHandler {
     // (undocumented)
@@ -246,7 +241,7 @@ export interface NavigationCommand {
 // @beta (undocumented)
 export interface NavigationCommitPhase<TSettings = any> extends Omit<NavigationPhase<TSettings>, "cancel" | "canceled" | "onCancel"> {
     // (undocumented)
-    setTitle(title: string): any;
+    setTitle(title: string): void;
 }
 
 // @beta (undocumented)
@@ -327,7 +322,7 @@ export interface NavigationQueue {
 }
 
 // @beta (undocumented)
-export type ParameterConverter = RouteParameterConverter | ConverterObject | Constructable<ConverterObject>;
+export type ParameterConverter = RouteParameterConverter | RouteParameterConverterObject | Constructable<RouteParameterConverterObject>;
 
 // @beta (undocumented)
 export type ParentRouteDefinition<TSettings = any> = PathedRouteDefinition<TSettings> & LayoutAndTransitionRouteDefinition & {
@@ -340,7 +335,7 @@ export type PathedRouteDefinition<TSettings = any> = SupportsSettings<TSettings>
 // @beta (undocumented)
 export const QueryString: Readonly<{
     readonly current: string;
-    build(params: Object, traditional?: boolean): string;
+    build(params: Record<string, string>, traditional?: boolean): string;
     separate(path: string): Readonly<{
         path: string;
         queryString: string;
@@ -474,7 +469,24 @@ export type RouteMatch<TSettings = any> = {
 };
 
 // @beta (undocumented)
-export type RouteParameterConverter = (value: string | undefined) => any | Promise<any>;
+export type RouteParameterConverter = (name: string, value: string | undefined, context: RouteParameterConverterContext) => any | Promise<any>;
+
+// @beta (undocumented)
+export interface RouteParameterConverterContext<TSettings = any> {
+    // (undocumented)
+    readonly endpoint: Endpoint<TSettings>;
+    // (undocumented)
+    readonly params: Readonly<Record<string, string | undefined>>;
+    // (undocumented)
+    readonly queryParams: Record<string, string>;
+    // (undocumented)
+    readonly typedParams: Record<string, any>;
+}
+
+// @beta (undocumented)
+export type RouteParameterConverterObject = {
+    convert: RouteParameterConverter;
+};
 
 // @beta (undocumented)
 export interface Router<TSettings = any> {
@@ -575,9 +587,9 @@ export interface RouterElement extends HTMLElement {
     // (undocumented)
     config: RouterConfiguration | null;
     // (undocumented)
-    connectedCallback(): any;
+    connectedCallback(): void;
     // (undocumented)
-    disconnectedCallback(): any;
+    disconnectedCallback(): void;
 }
 
 // @beta (undocumented)

package/package.json

@@ -2,7 +2,7 @@
   "name": "@microsoft/fast-router",
   "description": "A web-components-based router.",
   "sideEffects": false,
-  "version": "1.0.0-alpha.19",
+  "version": "1.0.0-alpha.20",
   "author": {
     "name": "Microsoft",
     "url": "https://discord.gg/FcSNfg4"
@@ -80,6 +80,6 @@
     "webpack-cli": "^4.9.2"
   },
   "dependencies": {
-    "@microsoft/fast-element": "^2.0.0-beta.19"
+    "@microsoft/fast-element": "^2.0.0-beta.20"
   }
 }