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

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

package/dist/routing/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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';

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","sourcesContent":["/**\n * Routing Capability Module\n *\n * Route matching, navigation, and URL parameter resolution\n *\n * Exports:\n * - Types: RouteDefinition, RouteMatch, NavigationTarget, RoutingCapability, etc.\n * - Implementations: DefaultRoutingCapability\n * - Factory functions: createRoutingCapability\n *\n * @module @pwfabric/runtime/routing\n */\n\n// Types\nexport type {\n  RouteDefinition,\n  RouteGuard,\n  RouteGuardContext,\n  RouteMatchResult,\n  RouteMatch,\n  NavigationTarget,\n  NavigationResult,\n  NavigationFailureReason,\n  NavigationListener,\n  RoutingCapability,\n} from './types.js'\n\n// Implementations\nexport { DefaultRoutingCapability, createRoutingCapability } from './router.js'\n"]}

package/dist/routing/router.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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;

package/dist/routing/router.js

@@ -0,0 +1,218 @@
+/**
+ * Routing Capability Implementation
+ *
+ * Route matching, navigation, and parameter resolution
+ *
+ * @module @pwfabric/runtime/routing/router
+ */
+// ============================================================
+// DEFAULT ROUTING CAPABILITY
+// ============================================================
+/**
+ * Default routing capability implementation
+ */
+export class DefaultRoutingCapability {
+    routes = new Map();
+    listeners = new Set();
+    navigationHistory = [];
+    currentRoute = undefined;
+    maxHistorySize;
+    constructor(options) {
+        this.maxHistorySize = options?.maxHistorySize ?? 50;
+    }
+    addRoute(route) {
+        if (this.routes.has(route.id)) {
+            throw new Error(`Route '${route.id}' is already registered`);
+        }
+        const compiled = this.compileRoute(route);
+        this.routes.set(route.id, compiled);
+    }
+    removeRoute(routeId) {
+        return this.routes.delete(routeId);
+    }
+    matchRoute(path) {
+        const { pathname, query, hash } = this.parsePath(path);
+        for (const compiled of this.routes.values()) {
+            const match = this.tryMatch(compiled, pathname, query, hash);
+            if (match) {
+                return { matched: true, match };
+            }
+        }
+        return { matched: false, reason: `No route matches path: ${path}` };
+    }
+    async navigate(target) {
+        const fullPath = this.buildPath(target);
+        const matchResult = this.matchRoute(fullPath);
+        if (!matchResult.matched) {
+            return { success: false, reason: 'no_match' };
+        }
+        const match = matchResult.match;
+        // Check if navigating to the same route
+        if (this.currentRoute &&
+            this.currentRoute.route.id === match.route.id &&
+            this.currentRoute.path === match.path) {
+            return { success: false, reason: 'same_route' };
+        }
+        // Execute guards
+        if (match.route.guards && match.route.guards.length > 0) {
+            for (const guard of match.route.guards) {
+                const canActivate = await guard.canActivate({
+                    from: this.currentRoute,
+                    to: match,
+                    params: match.params,
+                });
+                if (!canActivate) {
+                    return { success: false, reason: 'guard_rejected' };
+                }
+            }
+        }
+        // Update current route
+        const previousRoute = this.currentRoute;
+        this.currentRoute = match;
+        // Add to history
+        if (!target.replace) {
+            this.navigationHistory.push(match);
+            while (this.navigationHistory.length > this.maxHistorySize) {
+                this.navigationHistory.shift();
+            }
+        }
+        else if (this.navigationHistory.length > 0) {
+            this.navigationHistory[this.navigationHistory.length - 1] = match;
+        }
+        else {
+            this.navigationHistory.push(match);
+        }
+        // Notify listeners
+        this.notifyListeners(match, previousRoute);
+        return { success: true, match };
+    }
+    resolveParams(pattern, params) {
+        let resolved = pattern;
+        for (const [key, value] of Object.entries(params)) {
+            resolved = resolved.replace(`:${key}`, encodeURIComponent(value));
+        }
+        return resolved;
+    }
+    getCurrentRoute() {
+        return this.currentRoute;
+    }
+    getHistory() {
+        return [...this.navigationHistory];
+    }
+    onNavigate(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    getRouteIds() {
+        return Array.from(this.routes.keys());
+    }
+    clear() {
+        this.routes.clear();
+        this.listeners.clear();
+        this.navigationHistory.length = 0;
+        this.currentRoute = undefined;
+    }
+    // ============================================================
+    // PRIVATE METHODS
+    // ============================================================
+    compileRoute(route) {
+        const paramNames = [];
+        // Convert pattern to regex
+        // :param -> named capture group
+        // * -> wildcard capture
+        let regexStr = route.pattern
+            .replace(/\/:(\w+)/g, (_match, paramName) => {
+            paramNames.push(paramName);
+            return '/([^/]+)';
+        })
+            .replace(/\*$/, '(.*)');
+        // Ensure exact match (anchor start and end)
+        regexStr = `^${regexStr}$`;
+        return {
+            definition: route,
+            regex: new RegExp(regexStr),
+            paramNames,
+        };
+    }
+    tryMatch(compiled, pathname, query, hash) {
+        const match = pathname.match(compiled.regex);
+        if (!match)
+            return null;
+        const params = {};
+        for (let i = 0; i < compiled.paramNames.length; i++) {
+            const name = compiled.paramNames[i];
+            const value = match[i + 1];
+            if (name && value !== undefined) {
+                params[name] = decodeURIComponent(value);
+            }
+        }
+        return {
+            route: compiled.definition,
+            params,
+            query,
+            path: pathname,
+            hash,
+        };
+    }
+    parsePath(path) {
+        let pathname = path;
+        let hash = '';
+        const query = {};
+        // Extract hash
+        const hashIndex = pathname.indexOf('#');
+        if (hashIndex >= 0) {
+            hash = pathname.slice(hashIndex + 1);
+            pathname = pathname.slice(0, hashIndex);
+        }
+        // Extract query
+        const queryIndex = pathname.indexOf('?');
+        if (queryIndex >= 0) {
+            const queryString = pathname.slice(queryIndex + 1);
+            pathname = pathname.slice(0, queryIndex);
+            for (const pair of queryString.split('&')) {
+                const [key, value] = pair.split('=');
+                if (key) {
+                    query[decodeURIComponent(key)] = value ? decodeURIComponent(value) : '';
+                }
+            }
+        }
+        // Normalize pathname
+        if (!pathname.startsWith('/')) {
+            pathname = '/' + pathname;
+        }
+        return { pathname, query, hash };
+    }
+    buildPath(target) {
+        let path = target.path;
+        if (target.query && Object.keys(target.query).length > 0) {
+            const queryParts = Object.entries(target.query).map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+            path += '?' + queryParts.join('&');
+        }
+        if (target.hash) {
+            path += '#' + target.hash;
+        }
+        return path;
+    }
+    notifyListeners(to, from) {
+        for (const listener of this.listeners) {
+            try {
+                listener(to, from);
+            }
+            catch {
+                // Swallow listener errors
+            }
+        }
+    }
+}
+// ============================================================
+// FACTORY FUNCTION
+// ============================================================
+/**
+ * Create a routing capability instance
+ */
+export function createRoutingCapability(options) {
+    return new DefaultRoutingCapability(options);
+}
+//# sourceMappingURL=router.js.map

package/dist/routing/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/routing/router.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Routing Capability Implementation\n *\n * Route matching, navigation, and parameter resolution\n *\n * @module @pwfabric/runtime/routing/router\n */\n\nimport type {\n  RoutingCapability,\n  RouteDefinition,\n  RouteMatch,\n  RouteMatchResult,\n  NavigationTarget,\n  NavigationResult,\n  NavigationListener,\n} from './types.js'\n\n// ============================================================\n// COMPILED ROUTE\n// ============================================================\n\ninterface CompiledRoute {\n  definition: RouteDefinition\n  regex: RegExp\n  paramNames: string[]\n}\n\n// ============================================================\n// DEFAULT ROUTING CAPABILITY\n// ============================================================\n\n/**\n * Default routing capability implementation\n */\nexport class DefaultRoutingCapability implements RoutingCapability {\n  private readonly routes = new Map<string, CompiledRoute>()\n  private readonly listeners = new Set<NavigationListener>()\n  private readonly navigationHistory: RouteMatch[] = []\n  private currentRoute: RouteMatch | undefined = undefined\n  private readonly maxHistorySize: number\n\n  constructor(options?: { maxHistorySize?: number }) {\n    this.maxHistorySize = options?.maxHistorySize ?? 50\n  }\n\n  addRoute(route: RouteDefinition): void {\n    if (this.routes.has(route.id)) {\n      throw new Error(`Route '${route.id}' is already registered`)\n    }\n    const compiled = this.compileRoute(route)\n    this.routes.set(route.id, compiled)\n  }\n\n  removeRoute(routeId: string): boolean {\n    return this.routes.delete(routeId)\n  }\n\n  matchRoute(path: string): RouteMatchResult {\n    const { pathname, query, hash } = this.parsePath(path)\n\n    for (const compiled of this.routes.values()) {\n      const match = this.tryMatch(compiled, pathname, query, hash)\n      if (match) {\n        return { matched: true, match }\n      }\n    }\n\n    return { matched: false, reason: `No route matches path: ${path}` }\n  }\n\n  async navigate(target: NavigationTarget): Promise<NavigationResult> {\n    const fullPath = this.buildPath(target)\n    const matchResult = this.matchRoute(fullPath)\n\n    if (!matchResult.matched) {\n      return { success: false, reason: 'no_match' }\n    }\n\n    const match = matchResult.match\n\n    // Check if navigating to the same route\n    if (\n      this.currentRoute &&\n      this.currentRoute.route.id === match.route.id &&\n      this.currentRoute.path === match.path\n    ) {\n      return { success: false, reason: 'same_route' }\n    }\n\n    // Execute guards\n    if (match.route.guards && match.route.guards.length > 0) {\n      for (const guard of match.route.guards) {\n        const canActivate = await guard.canActivate({\n          from: this.currentRoute,\n          to: match,\n          params: match.params,\n        })\n        if (!canActivate) {\n          return { success: false, reason: 'guard_rejected' }\n        }\n      }\n    }\n\n    // Update current route\n    const previousRoute = this.currentRoute\n    this.currentRoute = match\n\n    // Add to history\n    if (!target.replace) {\n      this.navigationHistory.push(match)\n      while (this.navigationHistory.length > this.maxHistorySize) {\n        this.navigationHistory.shift()\n      }\n    } else if (this.navigationHistory.length > 0) {\n      this.navigationHistory[this.navigationHistory.length - 1] = match\n    } else {\n      this.navigationHistory.push(match)\n    }\n\n    // Notify listeners\n    this.notifyListeners(match, previousRoute)\n\n    return { success: true, match }\n  }\n\n  resolveParams(pattern: string, params: Record<string, string>): string {\n    let resolved = pattern\n    for (const [key, value] of Object.entries(params)) {\n      resolved = resolved.replace(`:${key}`, encodeURIComponent(value))\n    }\n    return resolved\n  }\n\n  getCurrentRoute(): RouteMatch | undefined {\n    return this.currentRoute\n  }\n\n  getHistory(): readonly RouteMatch[] {\n    return [...this.navigationHistory]\n  }\n\n  onNavigate(listener: NavigationListener): () => void {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  getRouteIds(): readonly string[] {\n    return Array.from(this.routes.keys())\n  }\n\n  clear(): void {\n    this.routes.clear()\n    this.listeners.clear()\n    this.navigationHistory.length = 0\n    this.currentRoute = undefined\n  }\n\n  // ============================================================\n  // PRIVATE METHODS\n  // ============================================================\n\n  private compileRoute(route: RouteDefinition): CompiledRoute {\n    const paramNames: string[] = []\n\n    // Convert pattern to regex\n    // :param -> named capture group\n    // * -> wildcard capture\n    let regexStr = route.pattern\n      .replace(/\\/:(\\w+)/g, (_match, paramName: string) => {\n        paramNames.push(paramName)\n        return '/([^/]+)'\n      })\n      .replace(/\\*$/, '(.*)')\n\n    // Ensure exact match (anchor start and end)\n    regexStr = `^${regexStr}$`\n\n    return {\n      definition: route,\n      regex: new RegExp(regexStr),\n      paramNames,\n    }\n  }\n\n  private tryMatch(\n    compiled: CompiledRoute,\n    pathname: string,\n    query: Record<string, string>,\n    hash: string\n  ): RouteMatch | null {\n    const match = pathname.match(compiled.regex)\n    if (!match) return null\n\n    const params: Record<string, string> = {}\n    for (let i = 0; i < compiled.paramNames.length; i++) {\n      const name = compiled.paramNames[i]\n      const value = match[i + 1]\n      if (name && value !== undefined) {\n        params[name] = decodeURIComponent(value)\n      }\n    }\n\n    return {\n      route: compiled.definition,\n      params,\n      query,\n      path: pathname,\n      hash,\n    }\n  }\n\n  private parsePath(path: string): {\n    pathname: string\n    query: Record<string, string>\n    hash: string\n  } {\n    let pathname = path\n    let hash = ''\n    const query: Record<string, string> = {}\n\n    // Extract hash\n    const hashIndex = pathname.indexOf('#')\n    if (hashIndex >= 0) {\n      hash = pathname.slice(hashIndex + 1)\n      pathname = pathname.slice(0, hashIndex)\n    }\n\n    // Extract query\n    const queryIndex = pathname.indexOf('?')\n    if (queryIndex >= 0) {\n      const queryString = pathname.slice(queryIndex + 1)\n      pathname = pathname.slice(0, queryIndex)\n\n      for (const pair of queryString.split('&')) {\n        const [key, value] = pair.split('=')\n        if (key) {\n          query[decodeURIComponent(key)] = value ? decodeURIComponent(value) : ''\n        }\n      }\n    }\n\n    // Normalize pathname\n    if (!pathname.startsWith('/')) {\n      pathname = '/' + pathname\n    }\n\n    return { pathname, query, hash }\n  }\n\n  private buildPath(target: NavigationTarget): string {\n    let path = target.path\n\n    if (target.query && Object.keys(target.query).length > 0) {\n      const queryParts = Object.entries(target.query).map(\n        ([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`\n      )\n      path += '?' + queryParts.join('&')\n    }\n\n    if (target.hash) {\n      path += '#' + target.hash\n    }\n\n    return path\n  }\n\n  private notifyListeners(to: RouteMatch, from: RouteMatch | undefined): void {\n    for (const listener of this.listeners) {\n      try {\n        listener(to, from)\n      } catch {\n        // Swallow listener errors\n      }\n    }\n  }\n}\n\n// ============================================================\n// FACTORY FUNCTION\n// ============================================================\n\n/**\n * Create a routing capability instance\n */\nexport function createRoutingCapability(options?: { maxHistorySize?: number }): RoutingCapability {\n  return new DefaultRoutingCapability(options)\n}\n"]}

package/dist/routing/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Routing Capability Types
+ *
+ * Route matching, navigation, and URL parameter resolution
+ *
+ * @module @pwfabric/runtime/routing/types
+ */
+/**
+ * Route definition for mapping URLs to surfaces
+ */
+export interface RouteDefinition {
+    /** Unique route identifier */
+    readonly id: string;
+    /** URL pattern (supports :param and * wildcard) */
+    readonly pattern: string;
+    /** Surface ID this route maps to */
+    readonly surfaceId: string;
+    /** Human-readable name */
+    readonly name?: string;
+    /** Route metadata */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    /** Navigation guards for this route */
+    readonly guards?: readonly RouteGuard[];
+    /** Child routes (for nested routing) */
+    readonly children?: readonly RouteDefinition[];
+}
+/**
+ * Route guard function
+ */
+export interface RouteGuard {
+    readonly name: string;
+    canActivate(context: RouteGuardContext): boolean | Promise<boolean>;
+}
+/**
+ * Context provided to route guards
+ */
+export interface RouteGuardContext {
+    readonly from: RouteMatch | undefined;
+    readonly to: RouteMatch;
+    readonly params: Readonly<Record<string, string>>;
+}
+/**
+ * Result of matching a URL against routes
+ */
+export type RouteMatchResult = {
+    readonly matched: true;
+    readonly match: RouteMatch;
+} | {
+    readonly matched: false;
+    readonly reason: string;
+};
+/**
+ * A successfully matched route
+ */
+export interface RouteMatch {
+    /** The matched route definition */
+    readonly route: RouteDefinition;
+    /** Extracted URL parameters */
+    readonly params: Readonly<Record<string, string>>;
+    /** Query parameters */
+    readonly query: Readonly<Record<string, string>>;
+    /** The full matched path */
+    readonly path: string;
+    /** Hash fragment (without #) */
+    readonly hash: string;
+}
+/**
+ * Navigation target
+ */
+export interface NavigationTarget {
+    /** Path to navigate to */
+    readonly path: string;
+    /** Query parameters */
+    readonly query?: Readonly<Record<string, string>>;
+    /** Hash fragment */
+    readonly hash?: string;
+    /** Whether to replace current history entry */
+    readonly replace?: boolean;
+    /** Navigation state data */
+    readonly state?: unknown;
+}
+/**
+ * Navigation result
+ */
+export type NavigationResult = {
+    readonly success: true;
+    readonly match: RouteMatch;
+} | {
+    readonly success: false;
+    readonly reason: NavigationFailureReason;
+};
+/**
+ * Reasons navigation can fail
+ */
+export type NavigationFailureReason = 'no_match' | 'guard_rejected' | 'same_route' | 'aborted';
+/**
+ * Listener for navigation events
+ */
+export type NavigationListener = (to: RouteMatch, from: RouteMatch | undefined) => void;
+/**
+ * Routing capability interface for managing routes and navigation
+ */
+export interface RoutingCapability {
+    /** Register a route definition */
+    addRoute(route: RouteDefinition): void;
+    /** Remove a route by ID */
+    removeRoute(routeId: string): boolean;
+    /** Match a URL path against registered routes */
+    matchRoute(path: string): RouteMatchResult;
+    /** Navigate to a target */
+    navigate(target: NavigationTarget): Promise<NavigationResult>;
+    /** Resolve parameters from a route pattern and values */
+    resolveParams(pattern: string, params: Record<string, string>): string;
+    /** Get the current route match */
+    getCurrentRoute(): RouteMatch | undefined;
+    /** Get navigation history */
+    getHistory(): readonly RouteMatch[];
+    /** Subscribe to navigation events */
+    onNavigate(listener: NavigationListener): () => void;
+    /** Get all registered route IDs */
+    getRouteIds(): readonly string[];
+    /** Clear all routes */
+    clear(): void;
+}

package/dist/routing/types.js

@@ -0,0 +1,9 @@
+/**
+ * Routing Capability Types
+ *
+ * Route matching, navigation, and URL parameter resolution
+ *
+ * @module @pwfabric/runtime/routing/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/routing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/routing/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * Routing Capability Types\n *\n * Route matching, navigation, and URL parameter resolution\n *\n * @module @pwfabric/runtime/routing/types\n */\n\n// ============================================================\n// ROUTE DEFINITION\n// ============================================================\n\n/**\n * Route definition for mapping URLs to surfaces\n */\nexport interface RouteDefinition {\n  /** Unique route identifier */\n  readonly id: string\n\n  /** URL pattern (supports :param and * wildcard) */\n  readonly pattern: string\n\n  /** Surface ID this route maps to */\n  readonly surfaceId: string\n\n  /** Human-readable name */\n  readonly name?: string\n\n  /** Route metadata */\n  readonly metadata?: Readonly<Record<string, unknown>>\n\n  /** Navigation guards for this route */\n  readonly guards?: readonly RouteGuard[]\n\n  /** Child routes (for nested routing) */\n  readonly children?: readonly RouteDefinition[]\n}\n\n/**\n * Route guard function\n */\nexport interface RouteGuard {\n  readonly name: string\n  canActivate(context: RouteGuardContext): boolean | Promise<boolean>\n}\n\n/**\n * Context provided to route guards\n */\nexport interface RouteGuardContext {\n  readonly from: RouteMatch | undefined\n  readonly to: RouteMatch\n  readonly params: Readonly<Record<string, string>>\n}\n\n// ============================================================\n// ROUTE MATCH\n// ============================================================\n\n/**\n * Result of matching a URL against routes\n */\nexport type RouteMatchResult =\n  | { readonly matched: true; readonly match: RouteMatch }\n  | { readonly matched: false; readonly reason: string }\n\n/**\n * A successfully matched route\n */\nexport interface RouteMatch {\n  /** The matched route definition */\n  readonly route: RouteDefinition\n\n  /** Extracted URL parameters */\n  readonly params: Readonly<Record<string, string>>\n\n  /** Query parameters */\n  readonly query: Readonly<Record<string, string>>\n\n  /** The full matched path */\n  readonly path: string\n\n  /** Hash fragment (without #) */\n  readonly hash: string\n}\n\n// ============================================================\n// NAVIGATION\n// ============================================================\n\n/**\n * Navigation target\n */\nexport interface NavigationTarget {\n  /** Path to navigate to */\n  readonly path: string\n\n  /** Query parameters */\n  readonly query?: Readonly<Record<string, string>>\n\n  /** Hash fragment */\n  readonly hash?: string\n\n  /** Whether to replace current history entry */\n  readonly replace?: boolean\n\n  /** Navigation state data */\n  readonly state?: unknown\n}\n\n/**\n * Navigation result\n */\nexport type NavigationResult =\n  | { readonly success: true; readonly match: RouteMatch }\n  | { readonly success: false; readonly reason: NavigationFailureReason }\n\n/**\n * Reasons navigation can fail\n */\nexport type NavigationFailureReason = 'no_match' | 'guard_rejected' | 'same_route' | 'aborted'\n\n/**\n * Listener for navigation events\n */\nexport type NavigationListener = (to: RouteMatch, from: RouteMatch | undefined) => void\n\n// ============================================================\n// ROUTING CAPABILITY INTERFACE\n// ============================================================\n\n/**\n * Routing capability interface for managing routes and navigation\n */\nexport interface RoutingCapability {\n  /** Register a route definition */\n  addRoute(route: RouteDefinition): void\n\n  /** Remove a route by ID */\n  removeRoute(routeId: string): boolean\n\n  /** Match a URL path against registered routes */\n  matchRoute(path: string): RouteMatchResult\n\n  /** Navigate to a target */\n  navigate(target: NavigationTarget): Promise<NavigationResult>\n\n  /** Resolve parameters from a route pattern and values */\n  resolveParams(pattern: string, params: Record<string, string>): string\n\n  /** Get the current route match */\n  getCurrentRoute(): RouteMatch | undefined\n\n  /** Get navigation history */\n  getHistory(): readonly RouteMatch[]\n\n  /** Subscribe to navigation events */\n  onNavigate(listener: NavigationListener): () => void\n\n  /** Get all registered route IDs */\n  getRouteIds(): readonly string[]\n\n  /** Clear all routes */\n  clear(): void\n}\n"]}

package/dist/seo/generator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SEO Capability Implementation
+ *
+ * Meta tag generation, JSON-LD structured data, and Open Graph tags
+ *
+ * All outputs are plain serializable objects suitable for SSR.
+ *
+ * @module @pwfabric/runtime/seo/generator
+ */
+import type { SeoCapability, MetaTagInput, MetaTagOutput, StructuredDataInput, StructuredDataOutput, OpenGraphInput, OpenGraphOutput, SeoConfig, SeoOutput } from './types.js';
+/**
+ * Default SEO capability implementation
+ */
+export declare class DefaultSeoCapability implements SeoCapability {
+    private readonly defaults;
+    constructor(defaults?: Partial<SeoDefaults>);
+    generateMetaTags(input: MetaTagInput): MetaTagOutput;
+    generateStructuredData(input: StructuredDataInput): StructuredDataOutput;
+    generateOpenGraph(input: OpenGraphInput): OpenGraphOutput;
+    generateAll(config: SeoConfig): SeoOutput;
+}
+interface SeoDefaults {
+    siteName: string;
+    titleSeparator: string;
+    defaultViewport: string;
+    defaultCharset: string;
+    defaultRobots: string;
+}
+/**
+ * Create an SEO capability instance
+ */
+export declare function createSeoCapability(defaults?: {
+    siteName?: string;
+    titleSeparator?: string;
+    defaultViewport?: string;
+    defaultCharset?: string;
+    defaultRobots?: string;
+}): SeoCapability;
+export {};