@excom/spa-route 0.1.0

package/support/custom-elements.json

@@ -0,0 +1,953 @@
+{
+  "schemaVersion": "1.0.0",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "spa-route.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "SpaRoute",
+          "customElement": true,
+          "tagName": "spa-route",
+          "mixins": [
+            {
+              "name": "RenderableElement",
+              "package": "@excom/renderable-element"
+            },
+            {
+              "name": "RoutableElement",
+              "package": "@excom/routable-element"
+            }
+          ],
+          "summary": "Declarative SPA screen — URL match → render.",
+          "description": "One screen of a single-page app. Matches `route-href` / `route-regex`, then renders its `<template>` while active and unrenders on the way out. Place inside `<spa-manager>` for view transitions and coordinated scroll.",
+          "attributes": [
+            {
+              "name": "same-route",
+              "type": {
+                "text": "string"
+              },
+              "description": "When this route matches while already active, `reuse` keeps the rendered tree and updates route data; `refresh` tears down and re-renders. Use `refresh` for param-driven screens (e.g. `/users/:id` → `/users/2`); `reuse` when only route data should change (e.g. `/logs/:view`). Pair with `scroll-set-disabled` to leave the viewport untouched.",
+              "fieldName": "sameRoute",
+              "default": "reuse",
+              "values": [
+                "reuse",
+                "refresh"
+              ]
+            },
+            {
+              "name": "no-transition",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Opt this route out of the parent `<spa-manager>` View Transition. Still renders/unrenders — just without the cross-fade.",
+              "fieldName": "noTransition"
+            },
+            {
+              "name": "scroll-reset-behavior",
+              "type": {
+                "text": "string"
+              },
+              "description": "`window.scrollTo` behavior when this route applies a scroll reset / restore.",
+              "fieldName": "scrollResetBehavior",
+              "default": "instant",
+              "values": [
+                "auto",
+                "instant",
+                "smooth"
+              ]
+            },
+            {
+              "name": "scroll-reset-x",
+              "type": {
+                "text": "tokenlist"
+              },
+              "description": "Navigation moves that reset scroll X to `0`. Moves omitted here restore the saved X for that history entry instead.",
+              "fieldName": "scrollResetX",
+              "default": "push replace",
+              "values": [
+                "push",
+                "replace",
+                "back",
+                "forward"
+              ]
+            },
+            {
+              "name": "scroll-reset-y",
+              "type": {
+                "text": "tokenlist"
+              },
+              "description": "Navigation moves that reset scroll Y to `0`. Moves omitted here restore the saved Y for that history entry instead.",
+              "fieldName": "scrollResetY",
+              "default": "push replace",
+              "values": [
+                "push",
+                "replace",
+                "back",
+                "forward"
+              ]
+            },
+            {
+              "name": "scroll-set-disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Disable all scroll reset / restore for this route.",
+              "fieldName": "scrollSetDisabled"
+            },
+            {
+              "name": "is-fallback",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Only activate when this route matches *and* no earlier sibling `<spa-route>` is already active. Pair with a permissive `route-regex` (e.g. `.*`) for 404 catch-alls.",
+              "fieldName": "isFallback"
+            },
+            {
+              "name": "document-title",
+              "type": {
+                "text": "string"
+              },
+              "description": "`document.title` while this route is active. The outermost `<spa-manager>` applies the last active route carrying one — so a nested route beats its ancestor — and restores the page's own `<title>` once no active route has one. Cold loads and back / forward retitle too: it keys off activation, not clicks.",
+              "fieldName": "documentTitle"
+            },
+            {
+              "name": "was-active",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Set briefly while navigating away. Style outgoing screens / card-expansion exits with `spa-route[was-active]`.",
+              "fieldName": "wasActive"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "sameRoute",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "When this route matches while already active, `reuse` keeps the rendered tree and updates route data; `refresh` tears down and re-renders. Use `refresh` for param-driven screens (e.g. `/users/:id` → `/users/2`); `reuse` when only route data should change (e.g. `/logs/:view`). Pair with `scroll-set-disabled` to leave the viewport untouched.",
+              "default": "reuse",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "noTransition",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Opt this route out of the parent `<spa-manager>` View Transition. Still renders/unrenders — just without the cross-fade.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "scrollResetBehavior",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "`window.scrollTo` behavior when this route applies a scroll reset / restore.",
+              "default": "instant",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "scrollResetX",
+              "type": {
+                "text": "tokenlist"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Navigation moves that reset scroll X to `0`. Moves omitted here restore the saved X for that history entry instead.",
+              "default": "push replace",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "scrollResetY",
+              "type": {
+                "text": "tokenlist"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Navigation moves that reset scroll Y to `0`. Moves omitted here restore the saved Y for that history entry instead.",
+              "default": "push replace",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "scrollSetDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Disable all scroll reset / restore for this route.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isFallback",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Only activate when this route matches *and* no earlier sibling `<spa-route>` is already active. Pair with a permissive `route-regex` (e.g. `.*`) for 404 catch-alls.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "documentTitle",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "`document.title` while this route is active. The outermost `<spa-manager>` applies the last active route carrying one — so a nested route beats its ancestor — and restores the page's own `<title>` once no active route has one. Cold loads and back / forward retitle too: it keys off activation, not clicks.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "wasActive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Set briefly while navigating away. Style outgoing screens / card-expansion exits with `spa-route[was-active]`.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "provision",
+              "type": {
+                "text": "SpaRouteProvision",
+                "expanded": "{ routeHref: string; matchNested: boolean; scrollResetY: string[]; scrollResetX: string[]; scrollResetBehavior: ScrollBehavior; noTransition: boolean; active: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; }; event: { hasUAVisualTransition: boolean; }; match: Array<any> | null; move: null | \"push\" | \"replace\" | \"back\" | \"forward\"; next: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; } | null; previous: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; } | null; params: Record<string, string> | null; }"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Active route payload for this activation (`null` when inactive). Not reflected as an attribute.",
+              "_neutron": {
+                "surface": "option"
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "spa-route-provision",
+              "description": "Cancelable. Same route stayed active but params changed (`same-route=\"reuse\"`). `event.detail` is a thunk that updates route data and resolves the ready promise. `<spa-manager>` batches this into the View Transition like render/unrender.",
+              "type": {
+                "text": "SpaRouteProvisionEvent",
+                "expanded": "CustomEvent & { type: \"spa-route-provision\"; detail: () => void; bubbles: true; cancelable: true; composed: true }"
+              }
+            }
+          ],
+          "_neutron": {
+            "provisions": [
+              {
+                "name": "provision",
+                "type": {
+                  "text": "SpaRouteProvision",
+                  "expanded": "{ routeHref: string; matchNested: boolean; scrollResetY: string[]; scrollResetX: string[]; scrollResetBehavior: ScrollBehavior; noTransition: boolean; active: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; }; event: { hasUAVisualTransition: boolean; }; match: Array<any> | null; move: null | \"push\" | \"replace\" | \"back\" | \"forward\"; next: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; } | null; previous: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; } | null; params: Record<string, string> | null; }"
+                },
+                "description": "Active route payload for this activation (`null` when inactive). Not reflected as an attribute.",
+                "fieldName": "provision"
+              }
+            ],
+            "defaultActions": [
+              {
+                "name": "spa-route-provision",
+                "description": "Invokes `event.detail()` to apply the new provision."
+              }
+            ],
+            "expectedChildren": [
+              {
+                "relationship": "child",
+                "selector": "template",
+                "required": true,
+                "description": "Screen content. Cloned (or reused with `persist-content`) on activation."
+              }
+            ],
+            "cssAliases": [
+              {
+                "name": ":--spa-route",
+                "selectors": [
+                  "spa-route",
+                  ".tag-spa-route"
+                ],
+                "kind": "element"
+              }
+            ]
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SpaRoute",
+          "declaration": {
+            "name": "SpaRoute",
+            "module": "spa-route.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "spa-route",
+          "declaration": {
+            "name": "SpaRoute",
+            "module": "spa-route.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "spa-a.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "SpaA",
+          "customElement": true,
+          "tagName": "spa-a",
+          "mixins": [
+            {
+              "name": "ListenableElement",
+              "package": "@excom/listenable-element"
+            },
+            {
+              "name": "RoutableElement",
+              "package": "@excom/routable-element"
+            }
+          ],
+          "summary": "Declarative SPA link with active-state styling.",
+          "description": "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.).",
+          "attributes": [
+            {
+              "name": "route-action",
+              "type": {
+                "text": "string"
+              },
+              "description": "Navigation mode when activated (default click).",
+              "fieldName": "routeAction",
+              "default": "push",
+              "values": [
+                "push",
+                "replace",
+                "back",
+                "forward"
+              ]
+            },
+            {
+              "name": "document-title",
+              "type": {
+                "text": "string"
+              },
+              "description": "Sets `document.title` after navigation.",
+              "fieldName": "documentTitle"
+            },
+            {
+              "name": "transition-types",
+              "type": {
+                "text": "tokenlist"
+              },
+              "description": "Space-separated View Transition types for this navigation (CSS View Transitions API). Useful for shared-element morphs like card expansion.",
+              "fieldName": "transitionTypes",
+              "values": [
+                "<token>…"
+              ]
+            },
+            {
+              "name": "match-hash",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Require the URL hash to match when setting `is-active`.",
+              "fieldName": "matchHash"
+            },
+            {
+              "name": "is-active",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Current URL matches `route-href`. Style with `spa-a[is-active]`.",
+              "fieldName": "isActive"
+            },
+            {
+              "name": "was-active",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Previous URL matched `route-href`. Style outgoing links / card-expansion exits with `spa-a[was-active]`.",
+              "fieldName": "wasActive"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "routeAction",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Navigation mode when activated (default click).",
+              "default": "push",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "documentTitle",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Sets `document.title` after navigation.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "transitionTypes",
+              "type": {
+                "text": "tokenlist"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Space-separated View Transition types for this navigation (CSS View Transitions API). Useful for shared-element morphs like card expansion.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "matchHash",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Require the URL hash to match when setting `is-active`.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isActive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Current URL matches `route-href`. Style with `spa-a[is-active]`.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "wasActive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Previous URL matched `route-href`. Style outgoing links / card-expansion exits with `spa-a[was-active]`.",
+              "_neutron": {
+                "surface": "state"
+              }
+            }
+          ],
+          "_neutron": {
+            "cssAliases": [
+              {
+                "name": ":--spa-a",
+                "selectors": [
+                  "spa-a",
+                  ".tag-spa-a"
+                ],
+                "kind": "element"
+              }
+            ]
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SpaA",
+          "declaration": {
+            "name": "SpaA",
+            "module": "spa-a.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "spa-a",
+          "declaration": {
+            "name": "SpaA",
+            "module": "spa-a.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "spa-manager.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "SpaManager",
+          "customElement": true,
+          "tagName": "spa-manager",
+          "mixins": [
+            {
+              "name": "RoutableElement",
+              "package": "@excom/routable-element"
+            }
+          ],
+          "summary": "SPA shell — view transitions, swipe nav, route orchestration.",
+          "description": "Coordinates sibling `<spa-route>` children: batches their render / unrender into one View Transition per navigation, re-emits nav lifecycle events, and optionally handles touch edge-swipe back / forward.",
+          "attributes": [
+            {
+              "name": "transition-first-render",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Animate the very first activation (cold load) with a View Transition. Off by default so the initial paint is instant.",
+              "fieldName": "transitionFirstRender"
+            },
+            {
+              "name": "transition-delay",
+              "type": {
+                "text": "number"
+              },
+              "description": "Delay (ms) before starting the batched View Transition. Gives late sibling render/unrender events time to queue, or room for last-second DOM work. Unset / `null` starts synchronously.",
+              "fieldName": "transitionDelay"
+            },
+            {
+              "name": "no-transition",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Disable View Transitions for every child route.",
+              "fieldName": "noTransition"
+            },
+            {
+              "name": "render-timeout",
+              "type": {
+                "text": "number"
+              },
+              "description": "Max wait (ms) for child render promises before forcing the transition to resolve. Raise for slow remote templates.",
+              "fieldName": "renderTimeout",
+              "default": 2000
+            },
+            {
+              "name": "overscroll-behavior-x",
+              "type": {
+                "text": "string"
+              },
+              "description": "Touch edge-swipe on touch devices. `none` blocks horizontal overscroll; `navigate` also calls back / forward past the threshold.",
+              "fieldName": "overscrollBehaviorX",
+              "values": [
+                "none",
+                "navigate"
+              ]
+            },
+            {
+              "name": "overscroll-x-threshold",
+              "type": {
+                "text": "number"
+              },
+              "description": "Edge inset (px) where a touch start counts as an edge swipe.",
+              "fieldName": "overscrollXThreshold",
+              "default": 40
+            },
+            {
+              "name": "max-states",
+              "type": {
+                "text": "number"
+              },
+              "description": "Cap retained router history states (scroll positions, transition types, etc.).",
+              "fieldName": "maxStates"
+            },
+            {
+              "name": "last-move",
+              "type": {
+                "text": "string"
+              },
+              "description": "Last navigation direction (`push` / `replace` / `back` / `forward`). Pick CSS transition styles from this.",
+              "fieldName": "lastMove",
+              "values": [
+                "push",
+                "replace",
+                "back",
+                "forward"
+              ]
+            },
+            {
+              "name": "active-url",
+              "type": {
+                "text": "string"
+              },
+              "description": "URL of the currently active route.",
+              "fieldName": "activeUrl"
+            },
+            {
+              "name": "is-transitioning",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "A View Transition is in flight.",
+              "fieldName": "isTransitioning"
+            },
+            {
+              "name": "has-rendered",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "At least one render has committed. Gates `transition-first-render`; useful for hiding loading shells.",
+              "fieldName": "hasRendered"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "transitionFirstRender",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Animate the very first activation (cold load) with a View Transition. Off by default so the initial paint is instant.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "transitionDelay",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Delay (ms) before starting the batched View Transition. Gives late sibling render/unrender events time to queue, or room for last-second DOM work. Unset / `null` starts synchronously.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "noTransition",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Disable View Transitions for every child route.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "renderTimeout",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Max wait (ms) for child render promises before forcing the transition to resolve. Raise for slow remote templates.",
+              "default": 2000,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "overscrollBehaviorX",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Touch edge-swipe on touch devices. `none` blocks horizontal overscroll; `navigate` also calls back / forward past the threshold.",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "overscrollXThreshold",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Edge inset (px) where a touch start counts as an edge swipe.",
+              "default": 40,
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "maxStates",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Cap retained router history states (scroll positions, transition types, etc.).",
+              "_neutron": {
+                "surface": "option"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "lastMove",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "Last navigation direction (`push` / `replace` / `back` / `forward`). Pick CSS transition styles from this.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "activeUrl",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "URL of the currently active route.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isTransitioning",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "A View Transition is in flight.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hasRendered",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "readonly": true,
+              "description": "At least one render has committed. Gates `transition-first-render`; useful for hiding loading shells.",
+              "_neutron": {
+                "surface": "state"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "provision",
+              "type": {
+                "text": "KitRouteData",
+                "expanded": "{ previous: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; } | null; active: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; }; next: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; } | null; all: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; }[]; params: Record<string, string> | null; match: Array<any> | null; move: null | \"push\" | \"replace\" | \"back\" | \"forward\"; event?: { hasUAVisualTransition: boolean; }; route: KitRoute; }"
+              },
+              "privacy": "public",
+              "readonly": false,
+              "description": "Current route payload. Not reflected as an attribute.",
+              "_neutron": {
+                "surface": "option"
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "spa-manager-will-transition",
+              "description": "Cancelable. Once per navigation, just before the View Transition starts. `preventDefault()` skips the transition for this navigation.",
+              "type": {
+                "text": "SpaManagerWillTransitionEvent",
+                "expanded": "CustomEvent & { type: \"spa-manager-will-transition\"; detail: void; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "spa-manager-transition",
+              "description": "After `document.startViewTransition()` is called.",
+              "type": {
+                "text": "SpaManagerTransitionEvent",
+                "expanded": "CustomEvent & { type: \"spa-manager-transition\"; detail: { transition: ViewTransition; }; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "spa-manager-rendered",
+              "description": "After the transition (or synchronous fallback) finishes and routes are settled.",
+              "type": {
+                "text": "SpaManagerRenderedEvent",
+                "expanded": "CustomEvent & { type: \"spa-manager-rendered\"; detail: void; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "spa-manager-error",
+              "description": "Re-emitted when a child fires `spa-route-error`. `event.detail` mirrors the source error.",
+              "type": {
+                "text": "SpaManagerErrorEvent",
+                "expanded": "CustomEvent & { type: \"spa-manager-error\"; detail: unknown; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "spa-manager-push",
+              "description": "On `pushState` navigations.",
+              "type": {
+                "text": "SpaManagerPushEvent",
+                "expanded": "CustomEvent & { type: \"spa-manager-push\"; detail: void; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "spa-manager-replace",
+              "description": "On `replaceState` navigations.",
+              "type": {
+                "text": "SpaManagerReplaceEvent",
+                "expanded": "CustomEvent & { type: \"spa-manager-replace\"; detail: void; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "spa-manager-back",
+              "description": "On `back` navigations.",
+              "type": {
+                "text": "SpaManagerBackEvent",
+                "expanded": "CustomEvent & { type: \"spa-manager-back\"; detail: void; bubbles: true; cancelable: true; composed: true }"
+              }
+            },
+            {
+              "name": "spa-manager-forward",
+              "description": "On `forward` navigations.",
+              "type": {
+                "text": "SpaManagerForwardEvent",
+                "expanded": "CustomEvent & { type: \"spa-manager-forward\"; detail: void; bubbles: true; cancelable: true; composed: true }"
+              }
+            }
+          ],
+          "_neutron": {
+            "provisions": [
+              {
+                "name": "provision",
+                "type": {
+                  "text": "KitRouteData",
+                  "expanded": "{ previous: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; } | null; active: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; }; next: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; } | null; all: { id: string; url: string; title?: string; isInit?: boolean; scrollX?: number; scrollY?: number; ttypes?: string[]; }[]; params: Record<string, string> | null; match: Array<any> | null; move: null | \"push\" | \"replace\" | \"back\" | \"forward\"; event?: { hasUAVisualTransition: boolean; }; route: KitRoute; }"
+                },
+                "description": "Current route payload. Not reflected as an attribute.",
+                "fieldName": "provision"
+              }
+            ],
+            "listens": [
+              {
+                "name": "spa-route-render",
+                "description": "Queues the child's render callback for the next batched transition.",
+                "type": {
+                  "text": "RenderableRenderEvent",
+                  "expanded": "CustomEvent & { type: \"{tag}-render\"; detail: () => Promise<void>; bubbles: true; cancelable: true; composed: true }"
+                }
+              },
+              {
+                "name": "spa-route-unrender",
+                "description": "Queues the child's unrender callback (runs before renders so the outgoing route leaves first).",
+                "type": {
+                  "text": "RenderableUnrenderEvent",
+                  "expanded": "CustomEvent & { type: \"{tag}-unrender\"; detail: () => void; bubbles: true; cancelable: true; composed: true }"
+                }
+              },
+              {
+                "name": "spa-route-provision",
+                "description": "Queues a same-route param update (reuse) into the next batched transition.",
+                "type": {
+                  "text": "SpaRouteProvisionEvent",
+                  "expanded": "CustomEvent & { type: \"spa-route-provision\"; detail: () => void; bubbles: true; cancelable: true; composed: true }"
+                }
+              },
+              {
+                "name": "spa-route-error",
+                "description": "Falls back to a non-transitioned update and re-emits as `spa-manager-error`.",
+                "type": {
+                  "text": "RenderableErrorEvent",
+                  "expanded": "CustomEvent & { type: \"{tag}-error\"; detail: void; bubbles: true; cancelable: true; composed: true }"
+                }
+              }
+            ],
+            "defaultActions": [
+              {
+                "name": "spa-manager-will-transition",
+                "description": "Starts the batched View Transition (or synchronous update when transitions are unavailable / opted out)."
+              }
+            ],
+            "expectedChildren": [
+              {
+                "relationship": "descendant",
+                "selector": "spa-route",
+                "required": true,
+                "description": "Routes this manager coordinates. Their render lifecycle is intercepted and batched into one view transition per navigation."
+              }
+            ]
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SpaManager",
+          "declaration": {
+            "name": "SpaManager",
+            "module": "spa-manager.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "spa-manager",
+          "declaration": {
+            "name": "SpaManager",
+            "module": "spa-manager.ts"
+          }
+        }
+      ]
+    }
+  ]
+}