@microsoft/fast-router 0.4.5 → 1.0.0-alpha.10

package/.eslintrc.json

@@ -12,10 +12,6 @@
                 },
                 "extendDefaults": true
             }
-        ],
-        "import/extensions": [
-            "error",
-            "always"
         ]
     }
 }

package/CHANGELOG.json

@@ -2,24 +2,237 @@
   "name": "@microsoft/fast-router",
   "entries": [
     {
-      "date": "Wed, 17 Aug 2022 16:39:47 GMT",
-      "tag": "@microsoft/fast-router_v0.4.5",
-      "version": "0.4.5",
+      "date": "Mon, 03 Oct 2022 23:44:38 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.10",
+      "version": "1.0.0-alpha.10",
       "comments": {
-        "none": [
+        "prerelease": [
           {
-            "author": "prudepixie@users.noreply.github.com",
+            "author": "beachball",
             "package": "@microsoft/fast-router",
-            "commit": "3d7f8e4e8a7f9e3c1d9d997d510eafd0dc220f97",
-            "comment": "updating change file"
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.10",
+            "commit": "e23f4375f183f0672f9aeafd0e58411adb66ae90"
           }
-        ],
-        "patch": [
+        ]
+      }
+    },
+    {
+      "date": "Wed, 28 Sep 2022 20:45:51 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.9",
+      "version": "1.0.0-alpha.9",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "beachball",
+            "package": "@microsoft/fast-router",
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.9",
+            "commit": "08fab33015853b7f820fdfdac2aecddfeb31843f"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Tue, 27 Sep 2022 22:31:52 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.8",
+      "version": "1.0.0-alpha.8",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "beachball",
+            "package": "@microsoft/fast-router",
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.8",
+            "commit": "8834c6732c727d39f92f72b197388453a9c17f9b"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Fri, 23 Sep 2022 22:53:27 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.7",
+      "version": "1.0.0-alpha.7",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-router",
+            "commit": "2edd63a8abe24c68cfc7c76d773c912c6f2d6543",
+            "comment": "fix: update router to use the new behavior API"
+          },
+          {
+            "author": "beachball",
+            "package": "@microsoft/fast-router",
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.7",
+            "commit": "1646b26450a08a77c8bd6302560fe12cc6989ae1"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Thu, 01 Sep 2022 21:53:34 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.6",
+      "version": "1.0.0-alpha.6",
+      "comments": {
+        "prerelease": [
           {
             "author": "beachball",
             "package": "@microsoft/fast-router",
-            "comment": "Bump @microsoft/fast-element to v1.10.5",
-            "commit": "818bea15a2e2b2cfd8d92180135a7e231579f69b"
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.6",
+            "commit": "6b0f08574475d8b28cc2df67bf72b9041c2ad285"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Thu, 18 Aug 2022 20:46:10 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.5",
+      "version": "1.0.0-alpha.5",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "beachball",
+            "package": "@microsoft/fast-router",
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.5",
+            "commit": "0b57f1bc812e8e6371b7d27bb625f99a25bfaa66"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Mon, 18 Jul 2022 21:10:01 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.4",
+      "version": "1.0.0-alpha.4",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "roeisenb@microsoft.com",
+            "package": "@microsoft/fast-router",
+            "commit": "f164aa75e62ed71c9386902051c021f1fdfba364",
+            "comment": "refactor: reduce duplication in style normalization code scenarios"
+          },
+          {
+            "author": "beachball",
+            "package": "@microsoft/fast-router",
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.4",
+            "commit": "2ff46a32cdd9af12b236d0e2f3436a4de782e8ee"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Wed, 22 Jun 2022 20:17:50 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.3",
+      "version": "1.0.0-alpha.3",
+      "comments": {
+        "prerelease": [
+          {
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.3",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "f28cdb9fdba9cb27904acfad7444de82d447f39e",
+            "package": "@microsoft/fast-router"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Wed, 15 Jun 2022 17:41:10 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.2",
+      "version": "1.0.0-alpha.2",
+      "comments": {
+        "prerelease": [
+          {
+            "comment": "chore: fix package.json type fields",
+            "author": "roeisenb@microsoft.com",
+            "commit": "e86a638b9e84cbf36d950025889742944e68e512",
+            "package": "@microsoft/fast-router"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Wed, 01 Jun 2022 17:53:14 GMT",
+      "tag": "@microsoft/fast-router_v1.0.0-alpha.1",
+      "version": "1.0.0-alpha.1",
+      "comments": {
+        "prerelease": [
+          {
+            "comment": "fix: update router to work with new template primitives",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "fix: update router to new directive APIs.",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "chore: remove rollup of router",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "Upgrade TypeScript",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "Set prerelease version",
+            "author": "nicholasrice@users.noreply.github.com",
+            "commit": "5b313a3262b977acbee3c2efac87d0d14a82f792",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "chore: configure fast-router for internals stripping",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "refactor: new design for execution context",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "Update the fast-router with the updates to fast-element 2.0 APIs",
+            "author": "7559015+janechu@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "fix: update to latest fast-element utilities",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "Fixed an updated export from FAST element 2.0",
+            "author": "7559015+janechu@users.noreply.github.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          }
+        ],
+        "none": [
+          {
+            "comment": "update api extractor and typescript to use the latest versions",
+            "author": "chhol@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "docs: update a few readme files",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
+          },
+          {
+            "comment": "Bump @microsoft/fast-element to v2.0.0-beta.1",
+            "author": "roeisenb@microsoft.com",
+            "commit": "4699e77715068f8610aae908ede6356a249574b6",
+            "package": "@microsoft/fast-router"
           }
         ]
       }

package/CHANGELOG.md

@@ -1,16 +1,99 @@
 # Change Log - @microsoft/fast-router
 
-This log was last generated on Wed, 17 Aug 2022 16:39:47 GMT and should not be manually modified.
+This log was last generated on Mon, 03 Oct 2022 23:44:38 GMT and should not be manually modified.
 
 <!-- Start content -->
 
-## 0.4.5
+## 1.0.0-alpha.10
 
-Wed, 17 Aug 2022 16:39:47 GMT
+Mon, 03 Oct 2022 23:44:38 GMT
 
-### Patches
+### Changes
+
+- Bump @microsoft/fast-element to v2.0.0-beta.10
+
+## 1.0.0-alpha.9
+
+Wed, 28 Sep 2022 20:45:51 GMT
+
+### Changes
+
+- Bump @microsoft/fast-element to v2.0.0-beta.9
+
+## 1.0.0-alpha.8
+
+Tue, 27 Sep 2022 22:31:52 GMT
+
+### Changes
+
+- Bump @microsoft/fast-element to v2.0.0-beta.8
+
+## 1.0.0-alpha.7
+
+Fri, 23 Sep 2022 22:53:27 GMT
+
+### Changes
+
+- fix: update router to use the new behavior API (roeisenb@microsoft.com)
+- Bump @microsoft/fast-element to v2.0.0-beta.7
+
+## 1.0.0-alpha.6
+
+Thu, 01 Sep 2022 21:53:34 GMT
+
+### Changes
+
+- Bump @microsoft/fast-element to v2.0.0-beta.6
+
+## 1.0.0-alpha.5
+
+Thu, 18 Aug 2022 20:46:10 GMT
+
+### Changes
+
+- Bump @microsoft/fast-element to v2.0.0-beta.5
+
+## 1.0.0-alpha.4
+
+Mon, 18 Jul 2022 21:10:01 GMT
+
+### Changes
+
+- refactor: reduce duplication in style normalization code scenarios (roeisenb@microsoft.com)
+- Bump @microsoft/fast-element to v2.0.0-beta.4
+
+## 1.0.0-alpha.3
+
+Wed, 22 Jun 2022 20:17:50 GMT
+
+### Changes
+
+- Bump @microsoft/fast-element to v2.0.0-beta.3 (nicholasrice@users.noreply.github.com)
+
+## 1.0.0-alpha.2
+
+Wed, 15 Jun 2022 17:41:10 GMT
+
+### Changes
+
+- chore: fix package.json type fields (roeisenb@microsoft.com)
+
+## 1.0.0-alpha.1
+
+Wed, 01 Jun 2022 17:53:14 GMT
+
+### Changes
 
-- Bump @microsoft/fast-element to v1.10.5
+- fix: update router to work with new template primitives (roeisenb@microsoft.com)
+- fix: update router to new directive APIs. (roeisenb@microsoft.com)
+- chore: remove rollup of router (roeisenb@microsoft.com)
+- Upgrade TypeScript (nicholasrice@users.noreply.github.com)
+- Set prerelease version (nicholasrice@users.noreply.github.com)
+- chore: configure fast-router for internals stripping (roeisenb@microsoft.com)
+- refactor: new design for execution context (roeisenb@microsoft.com)
+- Update the fast-router with the updates to fast-element 2.0 APIs (7559015+janechu@users.noreply.github.com)
+- fix: update to latest fast-element utilities (roeisenb@microsoft.com)
+- Fixed an updated export from FAST element 2.0 (7559015+janechu@users.noreply.github.com)
 
 ## 0.4.2
 

package/README.md

@@ -1,9 +1,6 @@
 # FAST Router
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![npm version](https://badge.fury.io/js/%40microsoft%2Ffast-router.svg)](https://badge.fury.io/js/%40microsoft%2Ffast-router)
-
-The `fast-router` package contains a history-based navigation and routing solution designed around web components. By using `fast-router`, you can create multi-page and full application experiences.
+The `@microsoft/fast-router` package contains a history-based navigation and routing solution designed around Web Components. By using `fast-router`, you can create multi-page and full application experiences. The router works with any Web Components, but has special support for Web Components built on FAST.
 
 ## Installation
 
@@ -27,36 +24,10 @@ import { FASTRouter } from '@microsoft/fast-router';
 
 Looking for a setup that integrates with a particular front-end framework or bundler? Check out [our integration docs](https://fast.design/docs/integrations/introduction).
 
-### From CDN
-
-A pre-bundled script that contains all APIs needed to use FAST Router and FAST Element is available on CDN. You can use this script by adding [`type="module"`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) to the script element and then importing from the CDN.
-
-```html
-<!DOCTYPE html>
-<html lang="en">
-    <head>
-        <script type="module">
-          import { FASTRouter } from "https://cdn.jsdelivr.net/npm/@microsoft/fast-router/dist/fast-router.min.js";
-
-          // your code here
-        </script>
-    </head>
-    <!-- ... -->
-</html>
-```
-
-The markup above always references the latest release. When deploying to production, you will want to ship with a specific version. Here's an example of the markup for that:
-
-```html
-<script type="module" src="https://cdn.jsdelivr.net/npm/@microsoft/fast-router@0.2.11/dist/fast-router.min.js"></script>
-```
-
-:::note
-For simplicity, examples throughout the documentation will assume the library has been installed from NPM, but you can always replace the import location with the CDN URL.
-:::
-
 ## Configuration at a Glance
 
+The router is currently in `alpha` while we address a few bugs, finish up some final polish, and write the full documentation. Below is a quick sample of how to configure the router, to help get you going while we complete the full documentation.
+
 #### A Sample Route Configuration
 
 ```ts

package/dist/dts/commands.d.ts

@@ -6,13 +6,13 @@ import { RecognizedRoute } from "./recognizer.js";
 import { NavigationContributor } from "./contributors.js";
 import { NavigationCommitPhase, NavigationPhase } from "./phases.js";
 /**
- * @alpha
+ * @beta
  */
 export interface NavigationCommand {
     createContributor(router: Router, route: RecognizedRoute): Promise<NavigationContributor>;
 }
 /**
- * @alpha
+ * @beta
  */
 export interface RenderCommand extends NavigationCommand {
     layout: Layout;
@@ -20,7 +20,7 @@ export interface RenderCommand extends NavigationCommand {
     createView(): Promise<RouteView>;
 }
 /**
- * @alpha
+ * @beta
  */
 export declare class Ignore implements NavigationCommand {
     createContributor(): Promise<{
@@ -28,7 +28,7 @@ export declare class Ignore implements NavigationCommand {
     }>;
 }
 /**
- * @alpha
+ * @beta
  */
 export declare class Redirect implements NavigationCommand {
     private redirect;
@@ -47,7 +47,7 @@ declare class RenderContributor {
     commit(phase: NavigationCommitPhase): Promise<void>;
 }
 /**
- * @alpha
+ * @beta
  */
 export declare class Render implements RenderCommand {
     private owner;

package/dist/dts/configuration.d.ts

@@ -10,7 +10,7 @@ import { NavigationContributor } from "./contributors.js";
 import { NavigationPhaseHook, NavigationPhaseName } from "./phases.js";
 import { RouteRecognizer } from "./recognizer.js";
 /**
- * @alpha
+ * @beta
  */
 export declare abstract class RouterConfiguration<TSettings = any> {
     private isConfigured;

package/dist/dts/contributors.d.ts

@@ -1,23 +1,40 @@
-import { HTMLDirective } from "@microsoft/fast-element";
+import { AddViewBehaviorFactory, ViewBehavior, ViewBehaviorFactory, ViewController } from "@microsoft/fast-element";
 import { NavigationCommitPhaseHook, NavigationPhaseHook, NavigationPhaseName } from "./phases.js";
 /**
- * @alpha
+ * @beta
  */
 export declare type NavigationContributor<TSettings = any> = Partial<Record<Exclude<NavigationPhaseName, "commit">, NavigationPhaseHook<TSettings>>> & {
     commit?: NavigationCommitPhaseHook<TSettings>;
 };
 /**
- * @alpha
+ * @beta
  */
 export declare function isNavigationPhaseContributor<T extends NavigationPhaseName>(object: any, phase: T): object is Record<T, NavigationPhaseHook>;
 /**
- * @alpha
+ * @beta
  */
 export declare type ContributorOptions = {
     lifecycle?: boolean;
     parameters?: boolean;
 };
+declare class NavigationContributorDirective implements ViewBehaviorFactory {
+    readonly options: Required<ContributorOptions>;
+    id: string;
+    nodeId: string;
+    constructor(options: Required<ContributorOptions>);
+    createHTML(add: AddViewBehaviorFactory): string;
+    createBehavior(): NavigationContributorBehavior;
+}
+declare class NavigationContributorBehavior implements ViewBehavior {
+    private directive;
+    private router;
+    private contributor;
+    constructor(directive: NavigationContributorDirective);
+    bind(controller: ViewController): void;
+    unbind(source: unknown): void;
+}
 /**
- * @alpha
+ * @beta
  */
-export declare function navigationContributor(options?: ContributorOptions): HTMLDirective;
+export declare function navigationContributor(options?: ContributorOptions): NavigationContributorDirective;
+export {};

package/dist/dts/events.d.ts

@@ -4,7 +4,7 @@ import { NavigationPhase } from "./phases.js";
 import { RecognizedRoute } from "./recognizer.js";
 import { Router } from "./router.js";
 /**
- * @alpha
+ * @beta
  */
 export interface RoutingEventSink {
     onUnhandledNavigationMessage(router: Router, message: NavigationMessage): void;
@@ -14,7 +14,7 @@ export interface RoutingEventSink {
     onNavigationEnd(router: Router, route: RecognizedRoute, command: NavigationCommand): void;
 }
 /**
- * @alpha
+ * @beta
  */
 export declare class DefaultRoutingEventSink implements RoutingEventSink {
     onUnhandledNavigationMessage(router: Router, message: NavigationMessage): void;

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

@@ -2,7 +2,7 @@ import { FASTElement } from "@microsoft/fast-element";
 import { RouterElement } from "./router.js";
 declare const FASTRouter_base: new () => FASTElement & RouterElement;
 /**
- * @alpha
+ * @beta
  */
 export declare class FASTRouter extends FASTRouter_base {
 }

package/dist/dts/links.d.ts

@@ -1,12 +1,12 @@
 /**
- * @alpha
+ * @beta
  */
 export interface LinkHandler {
     connect(): void;
     disconnect(): void;
 }
 /**
- * @alpha
+ * @beta
  */
 export declare class DefaultLinkHandler implements LinkHandler {
     private handler;

package/dist/dts/navigation.d.ts

@@ -1,6 +1,6 @@
 import { Router } from "./router.js";
 /**
- * @alpha
+ * @beta
  */
 export interface Route {
     readonly path: string;
@@ -8,27 +8,27 @@ export interface Route {
     readonly caseSensitive?: boolean;
 }
 /**
- * @alpha
+ * @beta
  */
 export declare class NavigationMessage {
     path: string;
     constructor(path: string);
 }
 /**
- * @alpha
+ * @beta
  */
 export interface NavigationHandler {
     enqueue(msg: NavigationMessage): void;
 }
 /**
- * @alpha
+ * @beta
  */
 export declare const NavigationHandler: Readonly<{
     register(handler: NavigationHandler): void;
     unregister(handler: NavigationHandler): void;
 }>;
 /**
- * @alpha
+ * @beta
  */
 export interface NavigationQueue {
     connect(): void;
@@ -36,7 +36,7 @@ export interface NavigationQueue {
     receive(): Promise<NavigationMessage>;
 }
 /**
- * @alpha
+ * @beta
  */
 export declare const Route: Readonly<{
     path: Readonly<{
@@ -54,7 +54,7 @@ export declare const Route: Readonly<{
     }>;
 }>;
 /**
- * @alpha
+ * @beta
  */
 export declare class DefaultNavigationQueue implements NavigationQueue, NavigationHandler {
     private queue;

package/dist/dts/phases.d.ts

@@ -1,23 +1,23 @@
 import { RecognizedRoute } from "./recognizer.js";
 import { Router } from "./router.js";
 /**
- * @alpha
+ * @beta
  */
 export declare type NavigationPhaseName = "navigate" | "leave" | "construct" | "enter" | "commit";
 /**
- * @alpha
+ * @beta
  */
 export declare type NavigationPhaseHook<TSettings = any> = (phase: NavigationPhase<TSettings>) => Promise<any> | any;
 /**
- * @alpha
+ * @beta
  */
 export declare type NavigationCommitPhaseHook<TSettings = any> = (phase: NavigationCommitPhase<TSettings>) => Promise<any> | any;
 /**
- * @alpha
+ * @beta
  */
 export declare type NavigationPhaseFollowupAction = () => Promise<any> | any;
 /**
- * @alpha
+ * @beta
  */
 export interface NavigationPhase<TSettings = any> {
     readonly name: NavigationPhaseName;
@@ -30,7 +30,7 @@ export interface NavigationPhase<TSettings = any> {
     evaluateContributor(contributor: any, route?: RecognizedRoute<TSettings>, router?: Router<TSettings>): Promise<void>;
 }
 /**
- * @alpha
+ * @beta
  */
 export interface NavigationCommitPhase<TSettings = any> extends Omit<NavigationPhase<TSettings>, "cancel" | "canceled" | "onCancel"> {
     setTitle(title: string): any;

package/dist/dts/process.d.ts

@@ -20,13 +20,13 @@ declare class NavigationPhaseImpl<TSettings = any> implements NavigationCommitPh
     evaluateContributor(contributor: any, route?: RecognizedRoute<TSettings>, router?: Router): Promise<void>;
 }
 /**
- * @alpha
+ * @beta
  */
 export interface NavigationProcess {
     run(router: Router, message: NavigationMessage): Promise<void>;
 }
 /**
- * @alpha
+ * @beta
  */
 export declare class DefaultNavigationProcess<TSettings> {
     private phases;