@excom/spa-route 0.1.0

package/.rush/temp/chunked-rush-logs/spa-route.apply-exports.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: cd \"$RUSH_PROJECT_FOLDER\" && node ../heft-rig/scripts/apply-exports.mjs \n"}

package/.rush/temp/chunked-rush-logs/spa-route.build_docs.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs \n"}

package/.rush/temp/chunked-rush-logs/spa-route.build_package-metas.chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs \n"}

package/.rush/temp/operation/apply-exports/all.log

@@ -0,0 +1 @@
+Invoking: cd "$RUSH_PROJECT_FOLDER" && node ../heft-rig/scripts/apply-exports.mjs 

package/.rush/temp/operation/apply-exports/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: cd \"$RUSH_PROJECT_FOLDER\" && node ../heft-rig/scripts/apply-exports.mjs \n"}

package/.rush/temp/operation/apply-exports/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 39.87107900000001
+}

package/.rush/temp/operation/build_docs/all.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs 

package/.rush/temp/operation/build_docs/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs \n"}

package/.rush/temp/operation/build_docs/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 49.14228400000002
+}

package/.rush/temp/operation/build_package-metas/all.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs 

package/.rush/temp/operation/build_package-metas/log-chunks.jsonl

@@ -0,0 +1 @@
+{"kind":"O","text":"Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs \n"}

package/.rush/temp/operation/build_package-metas/state.json

@@ -0,0 +1,3 @@
+{
+  "nonCachedDurationMs": 147.68652299999985
+}

package/.rush/temp/shrinkwrap-deps.json

@@ -0,0 +1,3 @@
+{
+  "../../packages/spa-route": "../../packages/spa-route:/z/wHmF2sAc5rOPFB5jZxmHb5uUnWtOb2Sg8o55k3B8=:"
+}

package/config/rig.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
+  "rigPackageName": "@excom/heft-rig",
+  "rigProfile": "default"
+}

package/index.css

@@ -0,0 +1,5 @@
+@import "./src/spa-route.css";
+
+@layer {
+  @mixin module-spa-route;
+}

package/index.ts

@@ -0,0 +1,29 @@
+import { SpaA } from "./spa-a";
+import { SpaManager } from "./spa-manager";
+import { SpaRoute } from "./spa-route";
+
+SpaManager.define();
+SpaRoute.define();
+SpaA.define();
+
+export { SpaA, SpaManager, SpaRoute };
+
+type T_HTMLSpaManagerElement = typeof SpaManager.CustomElement;
+type T_HTMLSpaRouteElement = typeof SpaRoute.CustomElement;
+type T_HTMLSpaAElement = typeof SpaA.CustomElement;
+declare global {
+  interface HTMLSpaManagerElement extends T_HTMLSpaManagerElement {}
+  interface HTMLSpaRouteElement extends T_HTMLSpaRouteElement {}
+  interface HTMLSpaAElement extends T_HTMLSpaAElement {}
+  interface Window {
+    HTMLSpaManagerElement: HTMLSpaManagerElement;
+    HTMLSpaRouteElement: HTMLSpaRouteElement;
+    HTMLSpaAElement: HTMLSpaAElement;
+  }
+  interface HTMLElementTagNameMap {
+    "spa-manager": HTMLSpaManagerElement;
+    "spa-route": HTMLSpaRouteElement;
+    "spa-a": HTMLSpaAElement;
+  }
+}
+export type { HTMLSpaAElement, HTMLSpaManagerElement, HTMLSpaRouteElement };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@excom/spa-route",
+  "version": "0.1.0",
+  "description": "<spa-route> custom element",
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.13.0"
+  },
+  "type": "module",
+  "dependencies": {
+    "@excom/kit-logger": "^0.1.0",
+    "@excom/kit-router": "^0.1.0",
+    "@excom/listenable-element": "^0.1.0",
+    "@excom/kit-utils": "^0.1.0",
+    "@excom/neutron": "^0.1.0",
+    "@excom/routable-element": "^0.1.0",
+    "@excom/renderable-element": "^0.1.0"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "@excom/heft-rig": "^0.1.0"
+  },
+  "repository": {
+    "url": "excom-dev/nucleus",
+    "directory": "packages/spa-route"
+  },
+  "homepage": "https://github.com/excom-dev/nucleus/tree/main/packages/spa-route/support/docs/README.md",
+  "bugs": "https://github.com/excom-dev/nucleus/issues",
+  "keywords": [
+    "spa-route",
+    "neutron",
+    "custom-elements"
+  ],
+  "excom": {
+    "packageType": "kit-element"
+  },
+  "scripts": {
+    "build": "node node_modules/@excom/heft-rig/scripts/vite-build.mjs",
+    "build:watch": "node node_modules/@excom/heft-rig/scripts/vite-build-watch.mjs",
+    "format": "node node_modules/@excom/heft-rig/scripts/format.mjs",
+    "test": "node node_modules/@excom/heft-rig/scripts/vitest.mjs",
+    "coverage": "node node_modules/@excom/heft-rig/scripts/coverage.mjs",
+    "dev": "node node_modules/@excom/heft-rig/scripts/vite-dev.mjs",
+    "preview": "node node_modules/@excom/heft-rig/scripts/vite-preview.mjs",
+    "build:package-metas": "node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs",
+    "build:docs": "node node_modules/@excom/heft-rig/scripts/build-docs.mjs"
+  }
+}

package/rush-logs/spa-route.apply-exports.cache.log

@@ -0,0 +1 @@
+Caching has been disabled for this project's "apply-exports" command.

package/rush-logs/spa-route.apply-exports.log

@@ -0,0 +1 @@
+Invoking: cd "$RUSH_PROJECT_FOLDER" && node ../heft-rig/scripts/apply-exports.mjs 

package/rush-logs/spa-route.build_docs.cache.log

@@ -0,0 +1 @@
+This project does not define the caching behavior of the "build:docs" command, so caching has been disabled.

package/rush-logs/spa-route.build_docs.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-docs.mjs 

package/rush-logs/spa-route.build_package-metas.cache.log

@@ -0,0 +1 @@
+This project does not define the caching behavior of the "build:package-metas" command, so caching has been disabled.

package/rush-logs/spa-route.build_package-metas.log

@@ -0,0 +1 @@
+Invoking: node node_modules/@excom/heft-rig/scripts/build-package-metas.mjs 

package/spa-a.ts

@@ -0,0 +1,124 @@
+import { urlMatchesHref } from "./src/utils";
+import { KitLogger } from "@excom/kit-logger";
+import { KitRoute, kitRouter } from "@excom/kit-router";
+import { ListenableElement } from "@excom/listenable-element";
+import { Neutron, TokenList } from "@excom/neutron";
+import { RoutableElement } from "@excom/routable-element";
+
+/**
+ * SPA link — navigates without a full page reload. Set `route-href` to the destination; `is-active` / `was-active` reflect match state for CSS (nav highlighting, card-expansion exits, etc.).
+ *
+ * @summary Declarative SPA link with active-state styling.
+ *
+ * @example
+ * <spa-a route-href="/pricing">Pricing</spa-a>
+ *
+ * @example
+ * <spa-a route-href="/login" route-action="replace">Sign in</spa-a>
+ */
+export const SpaA = Neutron.compose([
+  ListenableElement,
+  RoutableElement,
+  Neutron({
+    tag: "spa-a",
+    props: {
+      /**
+       * @option
+       * Navigation mode when activated (default click).
+       * @default push
+       * @values push | replace | back | forward
+       */
+      routeAction: String,
+      /**
+       * @option
+       * Sets `document.title` after navigation.
+       */
+      documentTitle: String,
+      /**
+       * @option
+       * Space-separated View Transition types for this navigation (CSS View Transitions API). Useful for shared-element morphs like card expansion.
+       * @values <token>…
+       */
+      transitionTypes: TokenList,
+      /**
+       * @option
+       * Require the URL hash to match when setting `is-active`.
+       */
+      matchHash: Boolean,
+      /**
+       * @state
+       * Current URL matches `route-href`. Style with `spa-a[is-active]`.
+       */
+      isActive: Boolean,
+      /**
+       * @state
+       * Previous URL matched `route-href`. Style outgoing links / card-expansion exits with `spa-a[was-active]`.
+       */
+      wasActive: Boolean,
+      routeInstance: KitRoute,
+    },
+  }),
+])
+  .defineMethods({
+    actionHandler: ({
+      routeAction,
+      routeHref,
+      documentTitle,
+      transitionTypes,
+    }) => {
+      if (routeAction === "back" && kitRouter.canGoBack()) {
+        kitRouter.back();
+      } else if (routeAction === "forward" && kitRouter.canGoForward()) {
+        kitRouter.forward();
+      } else if (routeHref) {
+        // Can't go back or forward: fall back to push if `route-href` is set
+        kitRouter[routeAction === "replace" ? "replaceState" : "pushState"]({
+          url: routeHref,
+          title: documentTitle ?? undefined,
+          ttypes: transitionTypes ?? undefined,
+        });
+      } else {
+        KitLogger.error(
+          "spa-a",
+          routeAction === "back"
+            ? "Cannot go back"
+            : routeAction === "forward"
+              ? "Cannot go forward"
+              : "No route-href provided"
+        );
+      }
+    },
+    routeChanged: ({ routeHref, matchHash }, { move, previous, next }) => {
+      return {
+        isActive: urlMatchesHref(location.href, routeHref!, {
+          ignoreHash: !matchHash,
+        }),
+        wasActive:
+          // After a reload, history survives but router states don't: check `next.url`
+          move === "back" && next?.url
+            ? urlMatchesHref(next.url, routeHref!, { ignoreHash: !matchHash })
+            : // need to check previous.url in the case where window reload happens - history will still be persisted, but router states will not
+              ["forward", "push", "replace"].includes(move) && previous?.url
+              ? urlMatchesHref(previous.url, routeHref!, {
+                  ignoreHash: !matchHash,
+                })
+              : false,
+      };
+    },
+  })
+  .onPropChanged(
+    "routeHref",
+    ({ routeHref }) =>
+      !routeHref && {
+        // No `routeHref`: clear `isActive`
+        isActive: false,
+      }
+  )
+  .onConnected(
+    ({ listenFor, listenForLifecycle, handleEvent, isMoving }) =>
+      !isMoving &&
+      !listenFor?.length &&
+      !listenForLifecycle?.length && {
+        addListener: ["click", handleEvent],
+      }
+  );