@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.0

package/dist/render/visibility-css.js

@@ -0,0 +1,119 @@
+/**
+ * Per-breakpoint visibility CSS generation (the `hidden md:flex` equivalent).
+ *
+ * `block.layout.hideOn` / `block.layout.showOn` declare at which breakpoints a
+ * block is hidden / the only breakpoints where it is visible. Inline styles
+ * can't express media queries, so the runtime emits scoped CSS rules — keyed
+ * by the block's `data-block-id` — into the surface's generated `<style>`
+ * (alongside the box-sizing reset). The pixel thresholds are the SAME
+ * `BREAKPOINTS[].minWidth` values the span system uses.
+ *
+ * Semantics:
+ *   - `hideOn: ['xs','sm']` → hidden across the xs+sm ranges → hidden below the
+ *     md threshold (768px) → `@media (max-width:767.98px){ display:none }`.
+ *   - `showOn: ['lg','xl']` → visible ONLY in the lg+xl ranges → hidden below
+ *     lg (1024px) AND at/above the breakpoint after xl (2xl = 1536px).
+ *   - `showOn` is the inverse of `hideOn`; when both are present `showOn` wins.
+ *
+ * @module @pwfabric/runtime/render/visibility-css
+ */
+import { BREAKPOINTS, BREAKPOINT_ORDER } from '@pwfabric/core';
+import { blockSelector, collectScopedCss } from './scoped-css.js';
+/** Sub-pixel epsilon so `max-width` ranges don't overlap the next `min-width`. */
+const MAX_EPSILON = 0.02;
+/** `[minWidth, maxExclusive)` pixel range a named breakpoint covers. */
+function rangeFor(bp) {
+    const idx = BREAKPOINTS.findIndex((b) => b.name === bp);
+    const def = BREAKPOINTS[idx];
+    const next = BREAKPOINTS[idx + 1];
+    return {
+        min: def?.minWidth ?? 0,
+        maxExclusive: next?.minWidth ?? Number.POSITIVE_INFINITY,
+    };
+}
+/**
+ * Resolve the SET of breakpoints at which a block must be hidden, given its
+ * `hideOn` / `showOn` declarations. `showOn` takes precedence (the block is
+ * hidden at every breakpoint NOT listed in `showOn`).
+ */
+export function resolveHiddenBreakpoints(hideOn, showOn) {
+    if (showOn && showOn.length > 0) {
+        const visible = new Set(showOn);
+        return BREAKPOINT_ORDER.filter((bp) => !visible.has(bp));
+    }
+    if (hideOn && hideOn.length > 0) {
+        const hide = new Set(hideOn);
+        return BREAKPOINT_ORDER.filter((bp) => hide.has(bp));
+    }
+    return [];
+}
+/**
+ * Collapse a set of hidden breakpoints into the minimal set of
+ * `[min, maxExclusive)` pixel ranges (contiguous breakpoints merge).
+ */
+function collapseRanges(hidden) {
+    // Order by the canonical breakpoint order so contiguity is by ascending width.
+    const ordered = BREAKPOINT_ORDER.filter((bp) => hidden.includes(bp));
+    const out = [];
+    for (const bp of ordered) {
+        const r = rangeFor(bp);
+        const last = out[out.length - 1];
+        if (last && last.maxExclusive === r.min) {
+            last.maxExclusive = r.maxExclusive; // contiguous → extend
+        }
+        else {
+            out.push({ ...r });
+        }
+    }
+    return out;
+}
+/** Build a single `@media` condition for a `[min, maxExclusive)` range. */
+function mediaCondition(min, maxExclusive) {
+    const parts = [];
+    if (min > 0)
+        parts.push(`(min-width:${min}px)`);
+    if (Number.isFinite(maxExclusive))
+        parts.push(`(max-width:${maxExclusive - MAX_EPSILON}px)`);
+    return parts.join(' and ');
+}
+/**
+ * Emit the CSS rule(s) that hide a single block at the resolved breakpoints.
+ * Targets `[data-block-id="<id>"]` scoped under the surface root so it cannot
+ * leak to the host page. Uses `!important` so the rule beats the inline layout
+ * style (`display:grid`/flex on the wrapper) it must override.
+ *
+ * Returns '' when there is nothing to hide.
+ */
+export function blockVisibilityCss(blockId, hidden, surfaceId) {
+    if (hidden.length === 0)
+        return '';
+    const ranges = collapseRanges(hidden);
+    // The whole spectrum is hidden (no showOn match anywhere): unconditional hide.
+    const everything = ranges.length === 1 && ranges[0].min === 0 && !Number.isFinite(ranges[0].maxExclusive);
+    const selector = blockSelector(blockId, surfaceId);
+    if (everything) {
+        return `${selector}{display:none !important}`;
+    }
+    return ranges
+        .map((r) => {
+        const cond = mediaCondition(r.min, r.maxExclusive);
+        return `@media ${cond}{${selector}{display:none !important}}`;
+    })
+        .join('');
+}
+/**
+ * Walk a surface block tree and concatenate the per-block visibility CSS for
+ * every block declaring `hideOn` / `showOn`. Blocks without either are skipped
+ * (zero bytes emitted) so existing surfaces are byte-identical.
+ */
+export function collectVisibilityCss(blocks, surfaceId) {
+    return collectScopedCss(blocks, (block) => {
+        const layout = block.layout;
+        if (layout && (layout.hideOn?.length || layout.showOn?.length)) {
+            const hidden = resolveHiddenBreakpoints(layout.hideOn, layout.showOn);
+            return blockVisibilityCss(block.id, hidden, surfaceId);
+        }
+        return '';
+    });
+}
+//# sourceMappingURL=visibility-css.js.map

package/dist/render/visibility-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility-css.js","sourceRoot":"","sources":["../../src/render/visibility-css.ts"],"names":[],"mappings":"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"}

package/dist/render/width-scope.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Width scope — splits blocks into groups while KEEPING SOURCE ORDER.
+ *
+ * WHY. If the surface root carried both the 12-column grid and
+ * `maxWidth: var(--pw-layout-container-max-width)` + `margin: 0 auto`,
+ * persistent chrome would sit inside the centred box too (on a 1536px screen
+ * a persistent rail would start 218px in from the edge). The rule: persistent
+ * navigation chrome belongs to the viewport, the content body to the measure.
+ *
+ * WHY GROUPS, NOT BUCKETS. A surface runs `[navbar][body…][bottombar]`.
+ * Collecting `viewport`-scoped blocks into one bucket and `container` ones
+ * into another would break the order and put the bottom bar next to the top
+ * bar. Consecutive grouping keeps the order: three groups, three DOM siblings.
+ *
+ * WHY NOT 100vw. The `width:100vw; margin-inline:calc(50% - 50vw)` trick is
+ * the short way out of a centred container and is NOT used: `100vw` counts
+ * the scrollbar too, so every page with a vertical scrollbar would get ~15px
+ * of horizontal overflow — the very defect this module exists to avoid.
+ *
+ * @module @pwfabric/runtime/render/width-scope
+ */
+import { type Block, type BreakpointName } from '@pwfabric/core';
+import type { WidthScope } from '@pwfabric/contracts';
+export interface WidthScopeChunk {
+    readonly scope: WidthScope;
+    readonly blocks: readonly Block[];
+}
+/**
+ * A block's scope at this breakpoint. Without a declaration it is
+ * `container`, so a block that declares nothing keeps the default behaviour.
+ */
+export declare function resolveWidthScope(block: Block, viewport: BreakpointName): WidthScope;
+/** Groups consecutive blocks of the same scope together; order is kept. */
+export declare function chunkByWidthScope(blocks: readonly Block[], viewport: BreakpointName): readonly WidthScopeChunk[];
+//# sourceMappingURL=width-scope.d.ts.map

package/dist/render/width-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"width-scope.d.ts","sourceRoot":"","sources":["../../src/render/width-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAA;AAIvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAA;CAClC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,GAAG,UAAU,CAGpF;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,QAAQ,EAAE,cAAc,GACvB,SAAS,eAAe,EAAE,CAS5B"}

package/dist/render/width-scope.js

@@ -0,0 +1,44 @@
+/**
+ * Width scope — splits blocks into groups while KEEPING SOURCE ORDER.
+ *
+ * WHY. If the surface root carried both the 12-column grid and
+ * `maxWidth: var(--pw-layout-container-max-width)` + `margin: 0 auto`,
+ * persistent chrome would sit inside the centred box too (on a 1536px screen
+ * a persistent rail would start 218px in from the edge). The rule: persistent
+ * navigation chrome belongs to the viewport, the content body to the measure.
+ *
+ * WHY GROUPS, NOT BUCKETS. A surface runs `[navbar][body…][bottombar]`.
+ * Collecting `viewport`-scoped blocks into one bucket and `container` ones
+ * into another would break the order and put the bottom bar next to the top
+ * bar. Consecutive grouping keeps the order: three groups, three DOM siblings.
+ *
+ * WHY NOT 100vw. The `width:100vw; margin-inline:calc(50% - 50vw)` trick is
+ * the short way out of a centred container and is NOT used: `100vw` counts
+ * the scrollbar too, so every page with a vertical scrollbar would get ~15px
+ * of horizontal overflow — the very defect this module exists to avoid.
+ *
+ * @module @pwfabric/runtime/render/width-scope
+ */
+import { DEFAULT_BLOCK_LAYOUT, resolveResponsiveValue, } from '@pwfabric/core';
+/**
+ * A block's scope at this breakpoint. Without a declaration it is
+ * `container`, so a block that declares nothing keeps the default behaviour.
+ */
+export function resolveWidthScope(block, viewport) {
+    const layout = block.layout ?? DEFAULT_BLOCK_LAYOUT;
+    return resolveResponsiveValue(layout.widthScope, viewport) ?? 'container';
+}
+/** Groups consecutive blocks of the same scope together; order is kept. */
+export function chunkByWidthScope(blocks, viewport) {
+    const chunks = [];
+    for (const block of blocks) {
+        const scope = resolveWidthScope(block, viewport);
+        const last = chunks[chunks.length - 1];
+        if (last && last.scope === scope)
+            last.blocks.push(block);
+        else
+            chunks.push({ scope, blocks: [block] });
+    }
+    return chunks;
+}
+//# sourceMappingURL=width-scope.js.map

package/dist/render/width-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"width-scope.js","sourceRoot":"","sources":["../../src/render/width-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GAGvB,MAAM,gBAAgB,CAAA;AAWvB;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAY,EAAE,QAAwB;IACtE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,oBAAoB,CAAA;IACnD,OAAO,sBAAsB,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,WAAW,CAAA;AAC3E,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAC/B,MAAwB,EACxB,QAAwB;IAExB,MAAM,MAAM,GAA6C,EAAE,CAAA;IAC3D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACtC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;;YACpD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/render/write-only-sources.d.ts

@@ -0,0 +1,34 @@
+/**
+ * WRITE-ONLY SOURCES — a form's target that nothing on the page reads.
+ *
+ * A data source a form writes to (`platform/entities` `config.formBindings[].sourceId`)
+ * was also fetched as a list on mount and again after every submit (the
+ * bridge's `refreshAll`). For an intake-only model — anonymous visitors may
+ * create, never list — that is a refused request on every visit and every
+ * submit (`GET /_host/records/<model>` → 403
+ * `RECORDS_NOT_PUBLIC`, `__errors.records` set, no block bound to it).
+ *
+ * A source is write-only when:
+ *  - at least one form binding targets it, and every binding that does writes
+ *    with POST (a PATCH/PUT needs the loaded record to know what to update), and
+ *  - its id is referenced NOWHERE else: no block (props, expressions, actions,
+ *    repeat), no behavior, no other source, no other capability config.
+ *
+ * The reference check is a whole-word search of every string, which errs on
+ * the side of fetching: a stray word equal to the id keeps today's behaviour.
+ * A write-only source stays declared and registered — it is still the write
+ * target — it is just never asked for its rows.
+ *
+ * @module @pwfabric/runtime/render/write-only-sources
+ */
+export interface WriteOnlySourceInput {
+    readonly blocks: readonly unknown[];
+    readonly dataSources: readonly {
+        readonly id: string;
+    }[];
+    readonly capabilities?: readonly unknown[] | undefined;
+    readonly behaviors?: readonly unknown[] | undefined;
+}
+/** The ids of the declared sources that are only ever written to. */
+export declare function writeOnlySourceIds(input: WriteOnlySourceInput): ReadonlySet<string>;
+//# sourceMappingURL=write-only-sources.d.ts.map

package/dist/render/write-only-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-only-sources.d.ts","sourceRoot":"","sources":["../../src/render/write-only-sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAcH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAA;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAA;CACpD;AAyBD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC,CA2CnF"}

package/dist/render/write-only-sources.js

@@ -0,0 +1,99 @@
+/**
+ * WRITE-ONLY SOURCES — a form's target that nothing on the page reads.
+ *
+ * A data source a form writes to (`platform/entities` `config.formBindings[].sourceId`)
+ * was also fetched as a list on mount and again after every submit (the
+ * bridge's `refreshAll`). For an intake-only model — anonymous visitors may
+ * create, never list — that is a refused request on every visit and every
+ * submit (`GET /_host/records/<model>` → 403
+ * `RECORDS_NOT_PUBLIC`, `__errors.records` set, no block bound to it).
+ *
+ * A source is write-only when:
+ *  - at least one form binding targets it, and every binding that does writes
+ *    with POST (a PATCH/PUT needs the loaded record to know what to update), and
+ *  - its id is referenced NOWHERE else: no block (props, expressions, actions,
+ *    repeat), no behavior, no other source, no other capability config.
+ *
+ * The reference check is a whole-word search of every string, which errs on
+ * the side of fetching: a stray word equal to the id keeps today's behaviour.
+ * A write-only source stays declared and registered — it is still the write
+ * target — it is just never asked for its rows.
+ *
+ * @module @pwfabric/runtime/render/write-only-sources
+ */
+import { isCapability } from '../capability/type-mapping.js';
+function collectStrings(value, out, seen) {
+    if (typeof value === 'string') {
+        out.push(value);
+        return;
+    }
+    if (value === null || typeof value !== 'object')
+        return;
+    if (seen.has(value))
+        return;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (const v of value)
+            collectStrings(v, out, seen);
+        return;
+    }
+    for (const [k, v] of Object.entries(value)) {
+        // A key can be a reference too (`{ records: … }` maps).
+        out.push(k);
+        collectStrings(v, out, seen);
+    }
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** The ids of the declared sources that are only ever written to. */
+export function writeOnlySourceIds(input) {
+    const capabilities = (input.capabilities ?? []);
+    const entities = capabilities.find((c) => isCapability(c, 'platform/entities'));
+    const bindings = entities?.config?.formBindings;
+    if (!Array.isArray(bindings) || bindings.length === 0)
+        return new Set();
+    // Candidates: targeted by a form, and only ever with POST.
+    const postOnly = new Map();
+    for (const raw of bindings) {
+        if (typeof raw?.sourceId !== 'string')
+            continue;
+        const isPost = raw.method === undefined || raw.method === 'POST';
+        postOnly.set(raw.sourceId, (postOnly.get(raw.sourceId) ?? true) && isPost);
+    }
+    const declared = new Set(input.dataSources.map((s) => s.id));
+    const candidates = [...postOnly].filter(([id, post]) => post && declared.has(id)).map(([id]) => id);
+    if (candidates.length === 0)
+        return new Set();
+    // Everything that could read a source, minus the declarations themselves:
+    // the form bindings (they ARE the write) and the source list (each source is
+    // checked against the OTHER sources below).
+    const strings = [];
+    const seen = new Set();
+    collectStrings(input.blocks, strings, seen);
+    collectStrings(input.behaviors ?? [], strings, seen);
+    for (const c of capabilities) {
+        const config = c.config;
+        if (config === null || typeof config !== 'object')
+            continue;
+        const rest = { ...config };
+        delete rest['dataSources'];
+        delete rest['behaviors']; // collected above (the same list, seeded from persistence)
+        if (c === entities)
+            delete rest['formBindings'];
+        collectStrings(rest, strings, seen);
+    }
+    const result = new Set();
+    for (const id of candidates) {
+        const word = new RegExp(`(^|[^A-Za-z0-9_$])${escapeRegExp(id)}([^A-Za-z0-9_$]|$)`);
+        const others = [];
+        for (const s of input.dataSources)
+            if (s.id !== id)
+                collectStrings(s, others, new Set());
+        const read = strings.some((s) => word.test(s)) || others.some((s) => word.test(s));
+        if (!read)
+            result.add(id);
+    }
+    return result;
+}
+//# sourceMappingURL=write-only-sources.js.map

package/dist/render/write-only-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-only-sources.js","sourceRoot":"","sources":["../../src/render/write-only-sources.ts"],"names":[],"mappings":"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"}

package/dist/routing/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Routing Capability Module
+ *
+ * Route matching, navigation, and URL parameter resolution
+ *
+ * Exports:
+ * - Types: RouteDefinition, RouteMatch, NavigationTarget, RoutingCapability, etc.
+ * - Implementations: DefaultRoutingCapability
+ * - Factory functions: createRoutingCapability
+ *
+ * @module @pwfabric/runtime/routing
+ */
+export type { RouteDefinition, RouteGuard, RouteGuardContext, RouteMatchResult, RouteMatch, NavigationTarget, NavigationResult, NavigationFailureReason, NavigationListener, RoutingCapability, } from './types.js';
+export { DefaultRoutingCapability, createRoutingCapability } from './router.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/routing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA"}

package/dist/routing/index.js

@@ -0,0 +1,15 @@
+/**
+ * Routing Capability Module
+ *
+ * Route matching, navigation, and URL parameter resolution
+ *
+ * Exports:
+ * - Types: RouteDefinition, RouteMatch, NavigationTarget, RoutingCapability, etc.
+ * - Implementations: DefaultRoutingCapability
+ * - Factory functions: createRoutingCapability
+ *
+ * @module @pwfabric/runtime/routing
+ */
+// Implementations
+export { DefaultRoutingCapability, createRoutingCapability } from './router.js';
+//# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH,kBAAkB;AAClB,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA"}

package/dist/routing/router.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Routing Capability Implementation
+ *
+ * Route matching, navigation, and parameter resolution
+ *
+ * @module @pwfabric/runtime/routing/router
+ */
+import type { RoutingCapability, RouteDefinition, RouteMatch, RouteMatchResult, NavigationTarget, NavigationResult, NavigationListener } from './types.js';
+/**
+ * Default routing capability implementation
+ */
+export declare class DefaultRoutingCapability implements RoutingCapability {
+    private readonly routes;
+    private readonly listeners;
+    private readonly navigationHistory;
+    private currentRoute;
+    private readonly maxHistorySize;
+    constructor(options?: {
+        maxHistorySize?: number;
+    });
+    addRoute(route: RouteDefinition): void;
+    removeRoute(routeId: string): boolean;
+    matchRoute(path: string): RouteMatchResult;
+    navigate(target: NavigationTarget): Promise<NavigationResult>;
+    resolveParams(pattern: string, params: Record<string, string>): string;
+    getCurrentRoute(): RouteMatch | undefined;
+    getHistory(): readonly RouteMatch[];
+    onNavigate(listener: NavigationListener): () => void;
+    getRouteIds(): readonly string[];
+    clear(): void;
+    private compileRoute;
+    private tryMatch;
+    private parsePath;
+    private buildPath;
+    private notifyListeners;
+}
+/**
+ * Create a routing capability instance
+ */
+export declare function createRoutingCapability(options?: {
+    maxHistorySize?: number;
+}): RoutingCapability;
+//# sourceMappingURL=router.d.ts.map

package/dist/routing/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/routing/router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAgBnB;;GAEG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;gBAE3B,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE;IAIjD,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAQtC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAapC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuDnE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAQtE,eAAe,IAAI,UAAU,GAAG,SAAS;IAIzC,UAAU,IAAI,SAAS,UAAU,EAAE;IAInC,UAAU,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAOpD,WAAW,IAAI,SAAS,MAAM,EAAE;IAIhC,KAAK,IAAI,IAAI;IAWb,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,QAAQ;IA2BhB,OAAO,CAAC,SAAS;IAsCjB,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,eAAe;CASxB;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAEhG"}