@askrjs/askr 0.0.48 → 0.0.49

package/dist/renderer/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../../src/renderer/utils.ts"],"sourcesContent":["/**\n * Shared utilities for the renderer module.\n * Consolidates common patterns to reduce code duplication.\n */\n\nimport { globalScheduler } from '../runtime/scheduler';\nimport { logger } from '../dev/logger';\nimport { getPublicAttributeName } from '../common/attr-names';\nimport { getRuntimeEnv } from './env';\nimport { setDevValue, incDevCounter } from '../runtime/dev-namespace';\n\nconst SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n\n// Keep direct replaceChildren(...nodes) commits below a conservative argument\n// count until browser benchmarks prove larger spreads are safe.\nexport const DIRECT_REPLACE_CHILDREN_SPREAD_LIMIT = 4096;\n\nexport function canUseDirectReplaceChildrenSpread(count: number): boolean {\n  return count <= DIRECT_REPLACE_CHILDREN_SPREAD_LIMIT;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface ListenerEntry {\n  handler: EventListener;\n  original: EventListener;\n  eventName: string;\n  options?: boolean | AddEventListenerOptions;\n  updateHandler?: (nextHandler: EventListener) => void;\n}\n\nexport interface ParsedEventProp {\n  eventName: string;\n  capture: boolean;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Event Handler Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n// Handler pooling cache to avoid recreating wrapped handlers\n// Key: handler reference, Value: { wrapped: EventListener, flushAfter: boolean }\nconst handlerCache = new WeakMap<EventListener, Map<boolean, EventListener>>();\nlet cacheSize = 0;\nconst MAX_CACHE_SIZE = 1000;\n\n/**\n * Parse an event prop name (e.g., 'onClick') to its DOM event name (e.g., 'click')\n */\nexport function parseEventName(propName: string): string | null {\n  return parseEventProp(propName)?.eventName ?? null;\n}\n\nexport function parseEventProp(propName: string): ParsedEventProp | null {\n  if (!propName.startsWith('on') || propName.length <= 2) return null;\n  const capture =\n    propName.endsWith('Capture') && propName.length > 'onCapture'.length;\n  const normalizedPropName = capture\n    ? propName.slice(0, -'Capture'.length)\n    : propName;\n\n  return normalizedPropName.length <= 2\n    ? null\n    : {\n        eventName:\n          normalizedPropName.slice(2).charAt(0).toLowerCase() +\n          normalizedPropName.slice(3).toLowerCase(),\n        capture,\n      };\n}\n\nexport function getEventListenerKey(\n  eventName: string,\n  capture = false\n): string {\n  return capture ? `${eventName}:capture` : eventName;\n}\n\nexport function getEventListenerOptions(\n  eventName: string,\n  capture = false\n): AddEventListenerOptions | undefined {\n  const passiveOptions = getPassiveOptions(eventName);\n  if (!capture) {\n    return passiveOptions;\n  }\n\n  return passiveOptions\n    ? { ...passiveOptions, capture: true }\n    : { capture: true };\n}\n\n/**\n * Get default event listener options for passive events\n */\nexport function getPassiveOptions(\n  eventName: string\n): AddEventListenerOptions | undefined {\n  if (\n    eventName === 'wheel' ||\n    eventName === 'scroll' ||\n    eventName.startsWith('touch')\n  ) {\n    return { passive: true };\n  }\n  return undefined;\n}\n\n/**\n * Create a wrapped event handler that integrates with the scheduler\n * Uses caching to avoid recreating wrappers for the same handler\n */\nexport function createWrappedHandler(\n  handler: EventListener,\n  flushAfter = false\n): EventListener {\n  // Check cache first\n  const cachedByFlush = handlerCache.get(handler);\n  if (cachedByFlush) {\n    const cached = cachedByFlush.get(flushAfter);\n    if (cached) return cached;\n  }\n\n  const wrapped: EventListener = (event: Event) => {\n    try {\n      globalScheduler.runInHandlerScope(\n        () => {\n          try {\n            handler(event);\n          } catch (error) {\n            logger.error('[Askr] Event handler error:', error);\n          }\n        },\n        flushAfter ? 'sync' : 'defer'\n      );\n    } catch (err) {\n      if (flushAfter) {\n        queueMicrotask(() => {\n          throw err;\n        });\n      } else {\n        logger.error('[Askr] Event handler error:', err);\n      }\n    }\n  };\n\n  // Cache the wrapped handler\n  try {\n    if (!handlerCache.has(handler)) {\n      // Limit cache size to prevent memory leaks\n      if (cacheSize >= MAX_CACHE_SIZE) {\n        // Simple eviction - just don't cache new entries when full\n      } else {\n        cacheSize++;\n        handlerCache.set(handler, new Map());\n      }\n    }\n    handlerCache.get(handler)?.set(flushAfter, wrapped);\n  } catch {\n    // WeakMap can throw if handler is not a valid key\n  }\n\n  return wrapped;\n}\n\nexport function createMutableWrappedHandler(\n  handler: EventListener,\n  flushAfter = false\n): {\n  handler: EventListener;\n  updateHandler: (nextHandler: EventListener) => void;\n} {\n  let currentHandler = handler;\n\n  const wrapped: EventListener = (event: Event) => {\n    try {\n      globalScheduler.runInHandlerScope(\n        () => {\n          try {\n            currentHandler(event);\n          } catch (error) {\n            logger.error('[Askr] Event handler error:', error);\n          }\n        },\n        flushAfter ? 'sync' : 'defer'\n      );\n    } catch (err) {\n      if (flushAfter) {\n        queueMicrotask(() => {\n          throw err;\n        });\n      } else {\n        logger.error('[Askr] Event handler error:', err);\n      }\n    }\n  };\n\n  return {\n    handler: wrapped,\n    updateHandler(nextHandler: EventListener) {\n      currentHandler = nextHandler;\n    },\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Prop/Attribute Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** Props that should be skipped during attribute processing */\nexport function isSkippedProp(key: string): boolean {\n  return key === 'children' || key === 'key' || key === 'ref';\n}\n\n/** Check if prop should be ignored for prop-change detection */\nexport function isIgnoredForPropChanges(key: string): boolean {\n  if (key === 'children' || key === 'key') return true;\n  if (key.startsWith('on') && key.length > 2) return true;\n  if (key.startsWith('data-')) return true;\n  return false;\n}\n\n/**\n * Check if an element's current attribute value differs from vnode value\n */\nexport function hasPropChanged(\n  el: Element,\n  key: string,\n  value: unknown\n): boolean {\n  try {\n    if (key === 'class' || key === 'className') {\n      return readElementClassName(el) !== String(value);\n    }\n    if (key === 'value' || key === 'checked') {\n      return (el as HTMLElement & Record<string, unknown>)[key] !== value;\n    }\n    const attr = el.getAttribute(getRenderedAttributeName(el, key));\n    if (value === undefined || value === null || value === false) {\n      return attr !== null;\n    }\n    return String(value) !== attr;\n  } catch {\n    return true;\n  }\n}\n\nexport function isSVGDomElement(el: Element): el is SVGElement {\n  return typeof SVGElement !== 'undefined' && el instanceof SVGElement;\n}\n\nexport function getRenderedAttributeName(\n  el: Element,\n  propName: string\n): string {\n  const attributeName = getPublicAttributeName(propName);\n\n  return el.namespaceURI === SVG_NAMESPACE\n    ? attributeName\n    : attributeName.toLowerCase();\n}\n\nexport function setRenderedAttribute(\n  el: Element,\n  propName: string,\n  value: string\n): void {\n  el.setAttribute(getRenderedAttributeName(el, propName), value);\n}\n\nexport function removeRenderedAttribute(el: Element, propName: string): void {\n  el.removeAttribute(getRenderedAttributeName(el, propName));\n}\n\nexport function readElementClassName(el: Element): string {\n  if (isSVGDomElement(el)) {\n    return el.getAttribute('class') ?? '';\n  }\n\n  return (el as HTMLElement).className;\n}\n\nexport function writeElementClassName(el: Element, value: string): void {\n  if (isSVGDomElement(el)) {\n    if (value.length > 0) {\n      el.setAttribute('class', value);\n    } else {\n      el.removeAttribute('class');\n    }\n    return;\n  }\n\n  (el as HTMLElement).className = value;\n}\n\nexport function tagNamesEqualIgnoreCase(a: string, b: string): boolean {\n  if (a === b) return true;\n  if (a.length !== b.length) return false;\n\n  for (let index = 0; index < a.length; index += 1) {\n    const aCode = a.charCodeAt(index);\n    const bCode = b.charCodeAt(index);\n    if (aCode === bCode) continue;\n\n    const normalizedA = aCode >= 65 && aCode <= 90 ? aCode + 32 : aCode;\n    const normalizedB = bCode >= 65 && bCode <= 90 ? bCode + 32 : bCode;\n    if (normalizedA !== normalizedB) return false;\n  }\n\n  return true;\n}\n\n/**\n * Check if a vnode has non-trivial props (excluding events and data-*)\n */\nexport function hasNonTrivialProps(props: Record<string, unknown>): boolean {\n  for (const k of Object.keys(props)) {\n    if (isIgnoredForPropChanges(k)) continue;\n    return true;\n  }\n  return false;\n}\n\n/**\n * Check for prop changes between vnode and existing element\n */\nexport function checkPropChanges(\n  el: Element,\n  props: Record<string, unknown>\n): boolean {\n  for (const k of Object.keys(props)) {\n    if (isIgnoredForPropChanges(k)) continue;\n    if (hasPropChanged(el, k, props[k])) {\n      return true;\n    }\n  }\n  return false;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Key Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Extract key from a vnode object\n */\nexport function extractKey(vnode: unknown): string | number | undefined {\n  if (typeof vnode !== 'object' || vnode === null) return undefined;\n  const obj = vnode as Record<string, unknown>;\n  const rawKey =\n    obj.key ?? (obj.props as Record<string, unknown> | undefined)?.key;\n  if (rawKey === undefined || rawKey === null) return undefined;\n  return typeof rawKey === 'symbol'\n    ? String(rawKey)\n    : (rawKey as string | number);\n}\n\n/**\n * Build a key map from element's children\n */\nexport function buildKeyMapFromChildren(\n  parent: Element\n): Map<string | number, Element> {\n  const map = new Map<string | number, Element>();\n  for (let ch = parent.firstElementChild; ch; ch = ch.nextElementSibling) {\n    const k = ch.getAttribute('data-key');\n    if (k !== null) {\n      map.set(k, ch);\n      const n = Number(k);\n      if (!Number.isNaN(n)) map.set(n, ch);\n    }\n  }\n  return map;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Diagnostic Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Record DOM replace operation for diagnostics\n */\nexport function recordDOMReplace(source: string): void {\n  try {\n    incDevCounter('__DOM_REPLACE_COUNT');\n    setDevValue(`__LAST_DOM_REPLACE_STACK_${source}`, new Error().stack);\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Record fast-path stats for diagnostics\n */\nexport function recordFastPathStats(\n  stats: Record<string, unknown>,\n  counterName?: string\n): void {\n  try {\n    setDevValue('__LAST_FASTPATH_STATS', stats);\n    setDevValue('__LAST_FASTPATH_COMMIT_COUNT', 1);\n    if (counterName) {\n      incDevCounter(counterName);\n    }\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Conditionally log debug info for fast-path operations\n */\nexport function logFastPathDebug(\n  message: string,\n  indexOrData?: number | unknown,\n  data?: unknown\n): void {\n  const env = getRuntimeEnv();\n  if (env.ASKR_FASTPATH_DEBUG === '1' || env.ASKR_FASTPATH_DEBUG === 'true') {\n    if (data !== undefined) {\n      logger.warn(`[Askr][FASTPATH] ${message}`, indexOrData, data);\n    } else if (indexOrData !== undefined) {\n      logger.warn(`[Askr][FASTPATH] ${message}`, indexOrData);\n    } else {\n      logger.warn(`[Askr][FASTPATH] ${message}`);\n    }\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Performance Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get current high-resolution timestamp\n */\nexport function now(): number {\n  return typeof performance !== 'undefined' && performance.now\n    ? performance.now()\n    : Date.now();\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/renderer/utils.ts"],"sourcesContent":["/**\n * Shared utilities for the renderer module.\n * Consolidates common patterns to reduce code duplication.\n */\n\nimport { runRuntimeHandlerScope } from '../runtime/access';\nimport { logger } from '../dev/logger';\nimport { getPublicAttributeName } from '../common/attr-names';\nimport { getRuntimeEnv } from './env';\nimport { setDevValue, incDevCounter } from '../runtime/dev-namespace';\n\nconst SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n\n// Keep direct replaceChildren(...nodes) commits below a conservative argument\n// count until browser benchmarks prove larger spreads are safe.\nexport const DIRECT_REPLACE_CHILDREN_SPREAD_LIMIT = 4096;\n\nexport function canUseDirectReplaceChildrenSpread(count: number): boolean {\n  return count <= DIRECT_REPLACE_CHILDREN_SPREAD_LIMIT;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface ListenerEntry {\n  handler: EventListener;\n  original: EventListener;\n  eventName: string;\n  options?: boolean | AddEventListenerOptions;\n  updateHandler?: (nextHandler: EventListener) => void;\n}\n\nexport interface ParsedEventProp {\n  eventName: string;\n  capture: boolean;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Event Handler Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n// Handler pooling cache to avoid recreating wrapped handlers\n// Key: handler reference, Value: { wrapped: EventListener, flushAfter: boolean }\nconst handlerCache = new WeakMap<EventListener, Map<boolean, EventListener>>();\nlet cacheSize = 0;\nconst MAX_CACHE_SIZE = 1000;\n\n/**\n * Parse an event prop name (e.g., 'onClick') to its DOM event name (e.g., 'click')\n */\nexport function parseEventName(propName: string): string | null {\n  return parseEventProp(propName)?.eventName ?? null;\n}\n\nexport function parseEventProp(propName: string): ParsedEventProp | null {\n  if (!propName.startsWith('on') || propName.length <= 2) return null;\n  const capture =\n    propName.endsWith('Capture') && propName.length > 'onCapture'.length;\n  const normalizedPropName = capture\n    ? propName.slice(0, -'Capture'.length)\n    : propName;\n\n  return normalizedPropName.length <= 2\n    ? null\n    : {\n        eventName:\n          normalizedPropName.slice(2).charAt(0).toLowerCase() +\n          normalizedPropName.slice(3).toLowerCase(),\n        capture,\n      };\n}\n\nexport function getEventListenerKey(\n  eventName: string,\n  capture = false\n): string {\n  return capture ? `${eventName}:capture` : eventName;\n}\n\nexport function getEventListenerOptions(\n  eventName: string,\n  capture = false\n): AddEventListenerOptions | undefined {\n  const passiveOptions = getPassiveOptions(eventName);\n  if (!capture) {\n    return passiveOptions;\n  }\n\n  return passiveOptions\n    ? { ...passiveOptions, capture: true }\n    : { capture: true };\n}\n\n/**\n * Get default event listener options for passive events\n */\nexport function getPassiveOptions(\n  eventName: string\n): AddEventListenerOptions | undefined {\n  if (\n    eventName === 'wheel' ||\n    eventName === 'scroll' ||\n    eventName.startsWith('touch')\n  ) {\n    return { passive: true };\n  }\n  return undefined;\n}\n\n/**\n * Create a wrapped event handler that integrates with the scheduler\n * Uses caching to avoid recreating wrappers for the same handler\n */\nexport function createWrappedHandler(\n  handler: EventListener,\n  flushAfter = false\n): EventListener {\n  // Check cache first\n  const cachedByFlush = handlerCache.get(handler);\n  if (cachedByFlush) {\n    const cached = cachedByFlush.get(flushAfter);\n    if (cached) return cached;\n  }\n\n  const wrapped: EventListener = (event: Event) => {\n    try {\n      runRuntimeHandlerScope(\n        () => {\n          try {\n            handler(event);\n          } catch (error) {\n            logger.error('[Askr] Event handler error:', error);\n          }\n        },\n        flushAfter ? 'sync' : 'defer'\n      );\n    } catch (err) {\n      if (flushAfter) {\n        queueMicrotask(() => {\n          throw err;\n        });\n      } else {\n        logger.error('[Askr] Event handler error:', err);\n      }\n    }\n  };\n\n  // Cache the wrapped handler\n  try {\n    if (!handlerCache.has(handler)) {\n      // Limit cache size to prevent memory leaks\n      if (cacheSize >= MAX_CACHE_SIZE) {\n        // Simple eviction - just don't cache new entries when full\n      } else {\n        cacheSize++;\n        handlerCache.set(handler, new Map());\n      }\n    }\n    handlerCache.get(handler)?.set(flushAfter, wrapped);\n  } catch {\n    // WeakMap can throw if handler is not a valid key\n  }\n\n  return wrapped;\n}\n\nexport function createMutableWrappedHandler(\n  handler: EventListener,\n  flushAfter = false\n): {\n  handler: EventListener;\n  updateHandler: (nextHandler: EventListener) => void;\n} {\n  let currentHandler = handler;\n\n  const wrapped: EventListener = (event: Event) => {\n    try {\n      runRuntimeHandlerScope(\n        () => {\n          try {\n            currentHandler(event);\n          } catch (error) {\n            logger.error('[Askr] Event handler error:', error);\n          }\n        },\n        flushAfter ? 'sync' : 'defer'\n      );\n    } catch (err) {\n      if (flushAfter) {\n        queueMicrotask(() => {\n          throw err;\n        });\n      } else {\n        logger.error('[Askr] Event handler error:', err);\n      }\n    }\n  };\n\n  return {\n    handler: wrapped,\n    updateHandler(nextHandler: EventListener) {\n      currentHandler = nextHandler;\n    },\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Prop/Attribute Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** Props that should be skipped during attribute processing */\nexport function isSkippedProp(key: string): boolean {\n  return key === 'children' || key === 'key' || key === 'ref';\n}\n\n/** Check if prop should be ignored for prop-change detection */\nexport function isIgnoredForPropChanges(key: string): boolean {\n  if (key === 'children' || key === 'key') return true;\n  if (key.startsWith('on') && key.length > 2) return true;\n  if (key.startsWith('data-')) return true;\n  return false;\n}\n\n/**\n * Check if an element's current attribute value differs from vnode value\n */\nexport function hasPropChanged(\n  el: Element,\n  key: string,\n  value: unknown\n): boolean {\n  try {\n    if (key === 'class' || key === 'className') {\n      return readElementClassName(el) !== String(value);\n    }\n    if (key === 'value' || key === 'checked') {\n      return (el as HTMLElement & Record<string, unknown>)[key] !== value;\n    }\n    const attr = el.getAttribute(getRenderedAttributeName(el, key));\n    if (value === undefined || value === null || value === false) {\n      return attr !== null;\n    }\n    return String(value) !== attr;\n  } catch {\n    return true;\n  }\n}\n\nexport function isSVGDomElement(el: Element): el is SVGElement {\n  return typeof SVGElement !== 'undefined' && el instanceof SVGElement;\n}\n\nexport function getRenderedAttributeName(\n  el: Element,\n  propName: string\n): string {\n  const attributeName = getPublicAttributeName(propName);\n\n  return el.namespaceURI === SVG_NAMESPACE\n    ? attributeName\n    : attributeName.toLowerCase();\n}\n\nexport function setRenderedAttribute(\n  el: Element,\n  propName: string,\n  value: string\n): void {\n  el.setAttribute(getRenderedAttributeName(el, propName), value);\n}\n\nexport function removeRenderedAttribute(el: Element, propName: string): void {\n  el.removeAttribute(getRenderedAttributeName(el, propName));\n}\n\nexport function readElementClassName(el: Element): string {\n  if (isSVGDomElement(el)) {\n    return el.getAttribute('class') ?? '';\n  }\n\n  return (el as HTMLElement).className;\n}\n\nexport function writeElementClassName(el: Element, value: string): void {\n  if (isSVGDomElement(el)) {\n    if (value.length > 0) {\n      el.setAttribute('class', value);\n    } else {\n      el.removeAttribute('class');\n    }\n    return;\n  }\n\n  (el as HTMLElement).className = value;\n}\n\nexport function tagNamesEqualIgnoreCase(a: string, b: string): boolean {\n  if (a === b) return true;\n  if (a.length !== b.length) return false;\n\n  for (let index = 0; index < a.length; index += 1) {\n    const aCode = a.charCodeAt(index);\n    const bCode = b.charCodeAt(index);\n    if (aCode === bCode) continue;\n\n    const normalizedA = aCode >= 65 && aCode <= 90 ? aCode + 32 : aCode;\n    const normalizedB = bCode >= 65 && bCode <= 90 ? bCode + 32 : bCode;\n    if (normalizedA !== normalizedB) return false;\n  }\n\n  return true;\n}\n\n/**\n * Check if a vnode has non-trivial props (excluding events and data-*)\n */\nexport function hasNonTrivialProps(props: Record<string, unknown>): boolean {\n  for (const k of Object.keys(props)) {\n    if (isIgnoredForPropChanges(k)) continue;\n    return true;\n  }\n  return false;\n}\n\n/**\n * Check for prop changes between vnode and existing element\n */\nexport function checkPropChanges(\n  el: Element,\n  props: Record<string, unknown>\n): boolean {\n  for (const k of Object.keys(props)) {\n    if (isIgnoredForPropChanges(k)) continue;\n    if (hasPropChanged(el, k, props[k])) {\n      return true;\n    }\n  }\n  return false;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Key Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Extract key from a vnode object\n */\nexport function extractKey(vnode: unknown): string | number | undefined {\n  if (typeof vnode !== 'object' || vnode === null) return undefined;\n  const obj = vnode as Record<string, unknown>;\n  const rawKey =\n    obj.key ?? (obj.props as Record<string, unknown> | undefined)?.key;\n  if (rawKey === undefined || rawKey === null) return undefined;\n  return typeof rawKey === 'symbol'\n    ? String(rawKey)\n    : (rawKey as string | number);\n}\n\n/**\n * Build a key map from element's children\n */\nexport function buildKeyMapFromChildren(\n  parent: Element\n): Map<string | number, Element> {\n  const map = new Map<string | number, Element>();\n  for (let ch = parent.firstElementChild; ch; ch = ch.nextElementSibling) {\n    const k = ch.getAttribute('data-key');\n    if (k !== null) {\n      map.set(k, ch);\n      const n = Number(k);\n      if (!Number.isNaN(n)) map.set(n, ch);\n    }\n  }\n  return map;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Diagnostic Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Record DOM replace operation for diagnostics\n */\nexport function recordDOMReplace(source: string): void {\n  try {\n    incDevCounter('__DOM_REPLACE_COUNT');\n    setDevValue(`__LAST_DOM_REPLACE_STACK_${source}`, new Error().stack);\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Record fast-path stats for diagnostics\n */\nexport function recordFastPathStats(\n  stats: Record<string, unknown>,\n  counterName?: string\n): void {\n  try {\n    setDevValue('__LAST_FASTPATH_STATS', stats);\n    setDevValue('__LAST_FASTPATH_COMMIT_COUNT', 1);\n    if (counterName) {\n      incDevCounter(counterName);\n    }\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Conditionally log debug info for fast-path operations\n */\nexport function logFastPathDebug(\n  message: string,\n  indexOrData?: number | unknown,\n  data?: unknown\n): void {\n  const env = getRuntimeEnv();\n  if (env.ASKR_FASTPATH_DEBUG === '1' || env.ASKR_FASTPATH_DEBUG === 'true') {\n    if (data !== undefined) {\n      logger.warn(`[Askr][FASTPATH] ${message}`, indexOrData, data);\n    } else if (indexOrData !== undefined) {\n      logger.warn(`[Askr][FASTPATH] ${message}`, indexOrData);\n    } else {\n      logger.warn(`[Askr][FASTPATH] ${message}`);\n    }\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Performance Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get current high-resolution timestamp\n */\nexport function now(): number {\n  return typeof performance !== 'undefined' && performance.now\n    ? performance.now()\n    : Date.now();\n}\n"],"mappings":"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"}

package/dist/resources/index.d.ts

@@ -1,3 +1,4 @@
-import { getSignal } from "../runtime/component.js";
-import { ActivityPredicate, ResourceResult, TimerOptions, capture, documentVisible, on, resource, routeActive, stream, task, timer, windowFocused } from "../runtime/operations.js";
+import { getSignal } from "../runtime/component-scope.js";
+import { ResourceResult, resource } from "../runtime/resource-operation.js";
+import { ActivityPredicate, TimerOptions, capture, documentVisible, on, routeActive, stream, task, timer, windowFocused } from "../runtime/lifecycle-operations.js";
 export { type ActivityPredicate, type ResourceResult, type TimerOptions, capture, documentVisible, getSignal, on, resource, routeActive, stream, task, timer, windowFocused };

package/dist/resources/index.js

@@ -1,3 +1,6 @@
-import { getSignal } from "../runtime/component.js";
-import { capture, documentVisible, on, resource, routeActive, stream, task, timer, windowFocused } from "../runtime/operations.js";
+import { getSignal } from "../runtime/component-scope.js";
+import "../runtime/component.js";
+import { resource } from "../runtime/resource-operation.js";
+import { capture, documentVisible, on, routeActive, stream, task, timer, windowFocused } from "../runtime/lifecycle-operations.js";
+import "../runtime/operations.js";
 export { capture, documentVisible, getSignal, on, resource, routeActive, stream, task, timer, windowFocused };

package/dist/router/access.js

@@ -0,0 +1,36 @@
+import { requireAuth, requireGuest, requirePermission, requireRole } from "./policy.js";
+//#region src/router/access.ts
+function hasBuiltInAuthMetadata(node) {
+	return node.auth !== void 0 || !!node.role || !!node.permission;
+}
+function validateSameNodeAccessMetadata(node) {
+	if (node.auth === "guest" && (!!node.role || !!node.permission)) throw new Error("Guest-only routes cannot be combined with role or permission requirements.");
+}
+function validateAccessMetadata(node, context) {
+	validateSameNodeAccessMetadata(node);
+	const requiresAuthenticated = node.auth === true || !!node.role || !!node.permission;
+	if (node.auth === "guest" && (context.state.authenticated || !!node.role || !!node.permission)) throw new Error("Guest-only routes cannot be combined with authenticated access requirements.");
+	if (context.state.guestOnly && requiresAuthenticated) throw new Error("Child routes cannot weaken a guest-only access scope with authenticated requirements.");
+	if (hasBuiltInAuthMetadata(node) && !context.authConfigured) throw new Error("Routes using `auth`, `role`, or `permission` require `auth.resolve` in registerRoutes(...).");
+}
+function nextAccessScopeState(node, state) {
+	const requiresAuthenticated = node.auth === true || !!node.role || !!node.permission;
+	return {
+		guestOnly: state.guestOnly || node.auth === "guest",
+		authenticated: state.authenticated || requiresAuthenticated
+	};
+}
+function compileNodePolicies(node) {
+	validateSameNodeAccessMetadata(node);
+	const compiled = [];
+	if (node.auth === true) compiled.push(requireAuth());
+	else if (node.auth === "guest") compiled.push(requireGuest());
+	if (node.role) compiled.push(requireRole(node.role));
+	if (node.permission) compiled.push(requirePermission(node.permission));
+	if (node.policies?.length) compiled.push(...node.policies);
+	return compiled;
+}
+//#endregion
+export { compileNodePolicies, nextAccessScopeState, validateAccessMetadata };
+
+//# sourceMappingURL=access.js.map

package/dist/router/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","names":[],"sources":["../../src/router/access.ts"],"sourcesContent":["import type {\n  GroupHelperOptions,\n  RouteOptions,\n  RoutePolicy,\n} from '../common/router';\nimport {\n  requireAuth,\n  requireGuest,\n  requirePermission,\n  requireRole,\n} from './policy';\nimport type { AccessScopeState } from './internal-types';\n\nfunction hasBuiltInAuthMetadata(\n  node: Pick<GroupHelperOptions | RouteOptions, 'auth' | 'role' | 'permission'>\n): boolean {\n  return node.auth !== undefined || !!node.role || !!node.permission;\n}\n\nfunction validateSameNodeAccessMetadata(\n  node: Pick<GroupHelperOptions | RouteOptions, 'auth' | 'role' | 'permission'>\n): void {\n  if (node.auth === 'guest' && (!!node.role || !!node.permission)) {\n    throw new Error(\n      'Guest-only routes cannot be combined with role or permission requirements.'\n    );\n  }\n}\n\nexport function validateAccessMetadata(\n  node: Pick<GroupHelperOptions | RouteOptions, 'auth' | 'role' | 'permission'>,\n  context: {\n    authConfigured: boolean;\n    state: AccessScopeState;\n  }\n): void {\n  validateSameNodeAccessMetadata(node);\n\n  const requiresAuthenticated =\n    node.auth === true || !!node.role || !!node.permission;\n\n  if (\n    node.auth === 'guest' &&\n    (context.state.authenticated || !!node.role || !!node.permission)\n  ) {\n    throw new Error(\n      'Guest-only routes cannot be combined with authenticated access requirements.'\n    );\n  }\n\n  if (context.state.guestOnly && requiresAuthenticated) {\n    throw new Error(\n      'Child routes cannot weaken a guest-only access scope with authenticated requirements.'\n    );\n  }\n\n  if (hasBuiltInAuthMetadata(node) && !context.authConfigured) {\n    throw new Error(\n      'Routes using `auth`, `role`, or `permission` require `auth.resolve` in registerRoutes(...).'\n    );\n  }\n}\n\nexport function nextAccessScopeState(\n  node: Pick<GroupHelperOptions | RouteOptions, 'auth' | 'role' | 'permission'>,\n  state: AccessScopeState\n): AccessScopeState {\n  const requiresAuthenticated =\n    node.auth === true || !!node.role || !!node.permission;\n\n  return {\n    guestOnly: state.guestOnly || node.auth === 'guest',\n    authenticated: state.authenticated || requiresAuthenticated,\n  };\n}\n\nexport function compileNodePolicies(\n  node: Pick<\n    RouteOptions | GroupHelperOptions,\n    'auth' | 'role' | 'permission' | 'policies'\n  >\n): RoutePolicy[] {\n  validateSameNodeAccessMetadata(node);\n\n  const compiled: RoutePolicy[] = [];\n\n  if (node.auth === true) {\n    compiled.push(requireAuth());\n  } else if (node.auth === 'guest') {\n    compiled.push(requireGuest());\n  }\n\n  if (node.role) {\n    compiled.push(requireRole(node.role));\n  }\n\n  if (node.permission) {\n    compiled.push(requirePermission(node.permission));\n  }\n\n  if (node.policies?.length) {\n    compiled.push(...node.policies);\n  }\n\n  return compiled;\n}\n"],"mappings":";;AAaA,SAAS,uBACP,MACS;CACT,OAAO,KAAK,SAAS,UAAa,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK;AAC1D;AAEA,SAAS,+BACP,MACM;CACN,IAAI,KAAK,SAAS,YAAY,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK,aAClD,MAAM,IAAI,MACR,4EACF;AAEJ;AAEA,SAAgB,uBACd,MACA,SAIM;CACN,+BAA+B,IAAI;CAEnC,MAAM,wBACJ,KAAK,SAAS,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK;CAE9C,IACE,KAAK,SAAS,YACb,QAAQ,MAAM,iBAAiB,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK,aAEtD,MAAM,IAAI,MACR,8EACF;CAGF,IAAI,QAAQ,MAAM,aAAa,uBAC7B,MAAM,IAAI,MACR,uFACF;CAGF,IAAI,uBAAuB,IAAI,KAAK,CAAC,QAAQ,gBAC3C,MAAM,IAAI,MACR,6FACF;AAEJ;AAEA,SAAgB,qBACd,MACA,OACkB;CAClB,MAAM,wBACJ,KAAK,SAAS,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK;CAE9C,OAAO;EACL,WAAW,MAAM,aAAa,KAAK,SAAS;EAC5C,eAAe,MAAM,iBAAiB;CACxC;AACF;AAEA,SAAgB,oBACd,MAIe;CACf,+BAA+B,IAAI;CAEnC,MAAM,WAA0B,CAAC;CAEjC,IAAI,KAAK,SAAS,MAChB,SAAS,KAAK,YAAY,CAAC;MACtB,IAAI,KAAK,SAAS,SACvB,SAAS,KAAK,aAAa,CAAC;CAG9B,IAAI,KAAK,MACP,SAAS,KAAK,YAAY,KAAK,IAAI,CAAC;CAGtC,IAAI,KAAK,YACP,SAAS,KAAK,kBAAkB,KAAK,UAAU,CAAC;CAGlD,IAAI,KAAK,UAAU,QACjB,SAAS,KAAK,GAAG,KAAK,QAAQ;CAGhC,OAAO;AACT"}

package/dist/router/activity.d.ts

@@ -0,0 +1,10 @@
+import { RouteMatch, RouteParams, RouteSnapshot } from "../common/router.js";
+
+//#region src/router/activity.d.ts
+declare function setServerLocation(url: string | null): void;
+declare function isRoutePathActive(pathOrPaths: string | readonly string[]): boolean;
+declare function currentRoute<TParams extends RouteParams = RouteParams>(): RouteSnapshot<TParams>;
+declare function syncCurrentRouteSnapshot(pathname: string, search: string, hash: string, activityMatches?: readonly RouteMatch[]): void;
+//#endregion
+export { currentRoute };
+//# sourceMappingURL=activity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","names":[],"sources":["../../src/router/activity.ts"],"mappings":";;;iBAyBgB,iBAAA,CAAkB,GAAkB;AAAA,iBA6DpC,iBAAA,CACd,WAAuC;AAAA,iBA8EzB,YAAA,iBACE,WAAA,GAAc,WAAA,KAC3B,aAAA,CAAc,OAAA;AAAA,iBAiBH,wBAAA,CACd,QAAA,UACA,MAAA,UACA,IAAA,UACA,eAAA,YAA2B,UAAU"}

package/dist/router/activity.js

@@ -0,0 +1,89 @@
+import { markReactivePropsDirtySource, markReadableDerivedSubscribersDirty, notifyReadableReaders, recordReadableRead } from "../runtime/readable.js";
+import { getCurrentComponentInstance } from "../runtime/component-scope.js";
+import "../runtime/component.js";
+import { getActiveRenderContext } from "../common/render-context.js";
+import { getActiveRoutes } from "./store.js";
+import { syncRouteActivitySnapshot } from "../common/route-activity.js";
+import { deepFreeze, makeQuery, parseLocation } from "./route-context.js";
+import { computeMatchesFromRoutes } from "./resolution.js";
+//#region src/router/activity.ts
+let currentRouteSnapshot = buildRouteSnapshot("/", "", "");
+const currentRouteSource = (() => currentRouteSnapshot);
+currentRouteSource._readers = /* @__PURE__ */ new Map();
+let serverLocation = null;
+function setServerLocation(url) {
+	serverLocation = url;
+	if (url) {
+		const parsed = parseLocation(url);
+		syncRouteActivitySnapshot(parsed.pathname, computeMatchesFromRoutes(parsed.pathname, getActiveRoutes()));
+		return;
+	}
+	syncRouteActivitySnapshot(currentRouteSnapshot.path, currentRouteSnapshot.matches);
+}
+function buildRouteSnapshot(pathname, search, hash) {
+	const query = makeQuery(search);
+	const matches = computeMatchesFromRoutes(pathname, getActiveRoutes());
+	return Object.freeze({
+		path: pathname,
+		params: deepFreeze({ ...matches[0]?.params }),
+		query,
+		hash: hash || null,
+		matches: Object.freeze(matches)
+	});
+}
+function setCurrentRouteSnapshot(pathname, search, hash, activityMatches) {
+	currentRouteSnapshot = buildRouteSnapshot(pathname, search, hash);
+	syncRouteActivitySnapshot(pathname, activityMatches ?? currentRouteSnapshot.matches);
+	const instance = getCurrentComponentInstance();
+	markReadableDerivedSubscribersDirty(currentRouteSource);
+	markReactivePropsDirtySource(currentRouteSource);
+	notifyReadableReaders(currentRouteSource, instance);
+}
+function readCurrentRouteSnapshot() {
+	const instance = getCurrentComponentInstance();
+	if (!instance) throw new Error("currentRoute() can only be called during component render execution. Call currentRoute() from inside your component function.");
+	let pathname = "/";
+	let search = "";
+	let hash = "";
+	const renderContext = getActiveRenderContext();
+	if (instance.ssr && renderContext?.url) {
+		const parsed = parseLocation(renderContext.url);
+		pathname = parsed.pathname;
+		search = parsed.search;
+		hash = parsed.hash;
+	} else if (typeof window !== "undefined" && window.location) {
+		pathname = window.location.pathname || "/";
+		search = window.location.search || "";
+		hash = window.location.hash || "";
+	} else if (serverLocation) {
+		const parsed = parseLocation(serverLocation);
+		pathname = parsed.pathname;
+		search = parsed.search;
+		hash = parsed.hash;
+	}
+	const query = makeQuery(search);
+	const matches = computeMatchesFromRoutes(pathname, getActiveRoutes());
+	const instanceParams = instance.props;
+	const params = deepFreeze({ ...Object.keys(instanceParams).length > 0 ? instanceParams : matches[0]?.params ?? {} });
+	return Object.freeze({
+		path: pathname,
+		params,
+		query,
+		hash: hash || null,
+		matches: Object.freeze(matches)
+	});
+}
+function currentRoute() {
+	const instance = getCurrentComponentInstance();
+	if (!instance) throw new Error("currentRoute() can only be called during component render execution. Call currentRoute() from inside your component function.");
+	if (typeof window === "undefined" || instance.ssr) return readCurrentRouteSnapshot();
+	recordReadableRead(currentRouteSource);
+	return readCurrentRouteSnapshot();
+}
+function syncCurrentRouteSnapshot(pathname, search, hash, activityMatches) {
+	setCurrentRouteSnapshot(pathname, search, hash, activityMatches);
+}
+//#endregion
+export { currentRoute, setServerLocation, syncCurrentRouteSnapshot };
+
+//# sourceMappingURL=activity.js.map

package/dist/router/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","names":[],"sources":["../../src/router/activity.ts"],"sourcesContent":["import type { RouteMatch, RouteParams, RouteSnapshot } from '../common/router';\nimport { syncRouteActivitySnapshot } from '../common/route-activity';\nimport { getActiveRenderContext } from '../common/render-context';\nimport { getCurrentComponentInstance } from '../runtime/component';\nimport {\n  markReadableDerivedSubscribersDirty,\n  markReactivePropsDirtySource,\n  notifyReadableReaders,\n  recordReadableRead,\n  type ReadableSource,\n} from '../runtime/readable';\nimport { deepFreeze, makeQuery, parseLocation } from './route-context';\nimport { computeMatchesFromRoutes } from './resolution';\nimport { getActiveRoutes } from './store';\n\nlet currentRouteSnapshot = buildRouteSnapshot('/', '', '');\n\nconst currentRouteSource = (() =>\n  currentRouteSnapshot) as ReadableSource<RouteSnapshot> &\n  (() => RouteSnapshot);\n\ncurrentRouteSource._readers = new Map();\n\nlet serverLocation: string | null = null;\n\nexport function setServerLocation(url: string | null): void {\n  serverLocation = url;\n  if (url) {\n    const parsed = parseLocation(url);\n    syncRouteActivitySnapshot(\n      parsed.pathname,\n      computeMatchesFromRoutes(parsed.pathname, getActiveRoutes())\n    );\n    return;\n  }\n\n  syncRouteActivitySnapshot(\n    currentRouteSnapshot.path,\n    currentRouteSnapshot.matches\n  );\n}\n\nfunction buildRouteSnapshot(\n  pathname: string,\n  search: string,\n  hash: string\n): RouteSnapshot {\n  const query = makeQuery(search);\n  const matches = computeMatchesFromRoutes(pathname, getActiveRoutes());\n\n  return Object.freeze({\n    path: pathname,\n    params: deepFreeze({ ...matches[0]?.params }),\n    query,\n    hash: hash || null,\n    matches: Object.freeze(matches),\n  });\n}\n\nfunction setCurrentRouteSnapshot(\n  pathname: string,\n  search: string,\n  hash: string,\n  activityMatches?: readonly RouteMatch[]\n): void {\n  currentRouteSnapshot = buildRouteSnapshot(pathname, search, hash);\n  syncRouteActivitySnapshot(\n    pathname,\n    activityMatches ?? currentRouteSnapshot.matches\n  );\n\n  const instance = getCurrentComponentInstance();\n  markReadableDerivedSubscribersDirty(currentRouteSource);\n  markReactivePropsDirtySource(currentRouteSource);\n  notifyReadableReaders(currentRouteSource, instance);\n}\n\nfunction normalizeRouteActivityPath(path: string): string {\n  const parsed = parseLocation(path);\n  const pathname = parsed.pathname || '/';\n  const absolutePathname = pathname.startsWith('/') ? pathname : `/${pathname}`;\n  return absolutePathname.endsWith('/') && absolutePathname !== '/'\n    ? absolutePathname.slice(0, -1)\n    : absolutePathname;\n}\n\nexport function isRoutePathActive(\n  pathOrPaths: string | readonly string[]\n): boolean {\n  const candidates = new Set(\n    (Array.isArray(pathOrPaths) ? pathOrPaths : [pathOrPaths]).map(\n      normalizeRouteActivityPath\n    )\n  );\n\n  let pathname = currentRouteSnapshot.path;\n  if (typeof window !== 'undefined' && window.location) {\n    pathname = window.location.pathname || '/';\n  } else if (serverLocation) {\n    pathname = parseLocation(serverLocation).pathname;\n  }\n\n  const activePath = normalizeRouteActivityPath(pathname);\n  if (candidates.has(activePath)) {\n    return true;\n  }\n\n  const matches = computeMatchesFromRoutes(activePath, getActiveRoutes());\n  return matches.some((match) =>\n    candidates.has(normalizeRouteActivityPath(match.path))\n  );\n}\n\nfunction readCurrentRouteSnapshot<\n  TParams extends RouteParams = RouteParams,\n>(): RouteSnapshot<TParams> {\n  const instance = getCurrentComponentInstance();\n  if (!instance) {\n    throw new Error(\n      'currentRoute() can only be called during component render execution. ' +\n        'Call currentRoute() from inside your component function.'\n    );\n  }\n\n  let pathname = '/';\n  let search = '';\n  let hash = '';\n  const renderContext = getActiveRenderContext();\n\n  if (instance.ssr && renderContext?.url) {\n    const parsed = parseLocation(renderContext.url);\n    pathname = parsed.pathname;\n    search = parsed.search;\n    hash = parsed.hash;\n  } else if (typeof window !== 'undefined' && window.location) {\n    pathname = window.location.pathname || '/';\n    search = window.location.search || '';\n    hash = window.location.hash || '';\n  } else if (serverLocation) {\n    const parsed = parseLocation(serverLocation);\n    pathname = parsed.pathname;\n    search = parsed.search;\n    hash = parsed.hash;\n  }\n\n  const query = makeQuery(search);\n  const matches = computeMatchesFromRoutes(pathname, getActiveRoutes());\n  const instanceParams = instance.props as Record<string, string>;\n  const routeParams =\n    Object.keys(instanceParams).length > 0\n      ? instanceParams\n      : (matches[0]?.params ?? {});\n  const params = deepFreeze({\n    ...routeParams,\n  });\n\n  return Object.freeze({\n    path: pathname,\n    params,\n    query,\n    hash: hash || null,\n    matches: Object.freeze(matches),\n  }) as RouteSnapshot<TParams>;\n}\n\nexport function currentRoute<\n  TParams extends RouteParams = RouteParams,\n>(): RouteSnapshot<TParams> {\n  const instance = getCurrentComponentInstance();\n  if (!instance) {\n    throw new Error(\n      'currentRoute() can only be called during component render execution. ' +\n        'Call currentRoute() from inside your component function.'\n    );\n  }\n\n  if (typeof window === 'undefined' || instance.ssr) {\n    return readCurrentRouteSnapshot<TParams>();\n  }\n\n  recordReadableRead(currentRouteSource);\n  return readCurrentRouteSnapshot<TParams>();\n}\n\nexport function syncCurrentRouteSnapshot(\n  pathname: string,\n  search: string,\n  hash: string,\n  activityMatches?: readonly RouteMatch[]\n): void {\n  setCurrentRouteSnapshot(pathname, search, hash, activityMatches);\n}\n"],"mappings":";;;;;;;;;AAeA,IAAI,uBAAuB,mBAAmB,KAAK,IAAI,EAAE;AAEzD,MAAM,4BACJ;AAGF,mBAAmB,2BAAW,IAAI,IAAI;AAEtC,IAAI,iBAAgC;AAEpC,SAAgB,kBAAkB,KAA0B;CAC1D,iBAAiB;CACjB,IAAI,KAAK;EACP,MAAM,SAAS,cAAc,GAAG;EAChC,0BACE,OAAO,UACP,yBAAyB,OAAO,UAAU,gBAAgB,CAAC,CAC7D;EACA;CACF;CAEA,0BACE,qBAAqB,MACrB,qBAAqB,OACvB;AACF;AAEA,SAAS,mBACP,UACA,QACA,MACe;CACf,MAAM,QAAQ,UAAU,MAAM;CAC9B,MAAM,UAAU,yBAAyB,UAAU,gBAAgB,CAAC;CAEpE,OAAO,OAAO,OAAO;EACnB,MAAM;EACN,QAAQ,WAAW,EAAE,GAAG,QAAQ,EAAE,EAAE,OAAO,CAAC;EAC5C;EACA,MAAM,QAAQ;EACd,SAAS,OAAO,OAAO,OAAO;CAChC,CAAC;AACH;AAEA,SAAS,wBACP,UACA,QACA,MACA,iBACM;CACN,uBAAuB,mBAAmB,UAAU,QAAQ,IAAI;CAChE,0BACE,UACA,mBAAmB,qBAAqB,OAC1C;CAEA,MAAM,WAAW,4BAA4B;CAC7C,oCAAoC,kBAAkB;CACtD,6BAA6B,kBAAkB;CAC/C,sBAAsB,oBAAoB,QAAQ;AACpD;AAsCA,SAAS,2BAEmB;CAC1B,MAAM,WAAW,4BAA4B;CAC7C,IAAI,CAAC,UACH,MAAM,IAAI,MACR,+HAEF;CAGF,IAAI,WAAW;CACf,IAAI,SAAS;CACb,IAAI,OAAO;CACX,MAAM,gBAAgB,uBAAuB;CAE7C,IAAI,SAAS,OAAO,eAAe,KAAK;EACtC,MAAM,SAAS,cAAc,cAAc,GAAG;EAC9C,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,OAAO,OAAO;CAChB,OAAO,IAAI,OAAO,WAAW,eAAe,OAAO,UAAU;EAC3D,WAAW,OAAO,SAAS,YAAY;EACvC,SAAS,OAAO,SAAS,UAAU;EACnC,OAAO,OAAO,SAAS,QAAQ;CACjC,OAAO,IAAI,gBAAgB;EACzB,MAAM,SAAS,cAAc,cAAc;EAC3C,WAAW,OAAO;EAClB,SAAS,OAAO;EAChB,OAAO,OAAO;CAChB;CAEA,MAAM,QAAQ,UAAU,MAAM;CAC9B,MAAM,UAAU,yBAAyB,UAAU,gBAAgB,CAAC;CACpE,MAAM,iBAAiB,SAAS;CAKhC,MAAM,SAAS,WAAW,EACxB,GAJA,OAAO,KAAK,cAAc,CAAC,CAAC,SAAS,IACjC,iBACC,QAAQ,EAAE,EAAE,UAAU,CAAC,EAG9B,CAAC;CAED,OAAO,OAAO,OAAO;EACnB,MAAM;EACN;EACA;EACA,MAAM,QAAQ;EACd,SAAS,OAAO,OAAO,OAAO;CAChC,CAAC;AACH;AAEA,SAAgB,eAEY;CAC1B,MAAM,WAAW,4BAA4B;CAC7C,IAAI,CAAC,UACH,MAAM,IAAI,MACR,+HAEF;CAGF,IAAI,OAAO,WAAW,eAAe,SAAS,KAC5C,OAAO,yBAAkC;CAG3C,mBAAmB,kBAAkB;CACrC,OAAO,yBAAkC;AAC3C;AAEA,SAAgB,yBACd,UACA,QACA,MACA,iBACM;CACN,wBAAwB,UAAU,QAAQ,MAAM,eAAe;AACjE"}

package/dist/router/authoring.d.ts

@@ -0,0 +1,22 @@
+import { GroupHelperOptions, PageHelperOptions, RegisterRoutesOptions, RouteComponent, RouteDefinition, RouteOptions, RouteParams, RoutePathParams } from "../common/router.js";
+import { AnyRouteComponent } from "./internal-types.js";
+
+//#region src/router/authoring.d.ts
+type RouteComponentParam<TComponent extends AnyRouteComponent> = Parameters<TComponent> extends [] ? unknown : Parameters<TComponent>[0];
+type CompatibleAbsoluteRouteComponent<Path extends string, TComponent extends AnyRouteComponent> = Parameters<TComponent> extends [] ? TComponent : RoutePathParams<Path> extends RouteComponentParam<TComponent> ? TComponent : never;
+type CompatibleRelativeRouteComponent<Path extends string, TComponent extends AnyRouteComponent> = Parameters<TComponent> extends [] ? TComponent : RouteComponentParam<TComponent> extends Record<keyof RoutePathParams<Path>, string> ? TComponent : never;
+type CompatibleRouteComponent<Path extends string, TComponent extends AnyRouteComponent> = Path extends `/${string}` ? CompatibleAbsoluteRouteComponent<Path, TComponent> : CompatibleRelativeRouteComponent<Path, TComponent>;
+type RouteOptionsForComponent<Path extends string, TComponent extends AnyRouteComponent> = Parameters<TComponent> extends [] ? RouteOptions<RoutePathParams<Path>> : RouteComponentParam<TComponent> extends RouteParams ? RouteOptions<RouteComponentParam<TComponent>> : RouteOptions<RoutePathParams<Path>>;
+declare function group(options: GroupHelperOptions, fn: RouteDefinition): void;
+declare function page<const TPath extends string>(path: TPath, Component: RouteComponent<RoutePathParams<TPath>>, fn: RouteDefinition): void;
+declare function page<const TPath extends string, TComponent extends AnyRouteComponent>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, fn: RouteDefinition): void;
+declare function page<const TPath extends string>(path: TPath, Component: RouteComponent<RoutePathParams<TPath>>, options: PageHelperOptions, fn: RouteDefinition): void;
+declare function page<const TPath extends string, TComponent extends AnyRouteComponent>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, options: PageHelperOptions, fn: RouteDefinition): void;
+declare function index(Component: RouteComponent, options?: RouteOptions): void;
+declare function fallback(Component: RouteComponent): void;
+declare function registerRoutes(definition: RouteDefinition, options?: RegisterRoutesOptions): void;
+declare function route<const TPath extends string>(path: TPath, Component: RouteComponent<RoutePathParams<TPath>>, options?: RouteOptions<RoutePathParams<TPath>>): void;
+declare function route<const TPath extends string, TComponent extends AnyRouteComponent>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, options?: RouteOptionsForComponent<TPath, TComponent>): void;
+//#endregion
+export { fallback, group, index, page, registerRoutes, route };
+//# sourceMappingURL=authoring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.d.ts","names":[],"sources":["../../src/router/authoring.ts"],"mappings":";;;;KAsCK,mBAAA,oBAAuC,iBAAA,IAC1C,UAAA,CAAW,UAAA,yBAAmC,UAAA,CAAW,UAAA;AAAA,KAEtD,gCAAA,yCAEgB,iBAAA,IAEnB,UAAA,CAAW,UAAA,eACP,UAAA,GACA,eAAA,CAAgB,IAAA,UAAc,mBAAA,CAAoB,UAAA,IAChD,UAAA;AAAA,KAGH,gCAAA,yCAEgB,iBAAA,IAEnB,UAAA,CAAW,UAAA,eACP,UAAA,GACA,mBAAA,CAAoB,UAAA,UAAoB,MAAA,OAC9B,eAAA,CAAgB,IAAA,aAGxB,UAAA;AAAA,KAGH,wBAAA,yCAEgB,iBAAA,IACjB,IAAA,wBACA,gCAAA,CAAiC,IAAA,EAAM,UAAA,IACvC,gCAAA,CAAiC,IAAA,EAAM,UAAA;AAAA,KAEtC,wBAAA,yCAEgB,iBAAA,IAEnB,UAAA,CAAW,UAAA,eACP,YAAA,CAAa,eAAA,CAAgB,IAAA,KAC7B,mBAAA,CAAoB,UAAA,UAAoB,WAAA,GACtC,YAAA,CAAa,mBAAA,CAAoB,UAAA,KACjC,YAAA,CAAa,eAAA,CAAgB,IAAA;AAAA,iBAmSrB,KAAA,CAAM,OAAA,EAAS,kBAAA,EAAoB,EAAA,EAAI,eAAe;AAAA,iBAKtD,IAAA,6BACd,IAAA,EAAM,KAAA,EACN,SAAA,EAAW,cAAA,CAAe,eAAA,CAAgB,KAAA,IAC1C,EAAA,EAAI,eAAA;AAAA,iBAEU,IAAA,gDAEK,iBAAA,EAEnB,IAAA,EAAM,KAAA,EACN,SAAA,EAAW,wBAAA,CAAyB,KAAA,EAAO,UAAA,GAC3C,EAAA,EAAI,eAAA;AAAA,iBAEU,IAAA,6BACd,IAAA,EAAM,KAAA,EACN,SAAA,EAAW,cAAA,CAAe,eAAA,CAAgB,KAAA,IAC1C,OAAA,EAAS,iBAAA,EACT,EAAA,EAAI,eAAA;AAAA,iBAEU,IAAA,gDAEK,iBAAA,EAEnB,IAAA,EAAM,KAAA,EACN,SAAA,EAAW,wBAAA,CAAyB,KAAA,EAAO,UAAA,GAC3C,OAAA,EAAS,iBAAA,EACT,EAAA,EAAI,eAAA;AAAA,iBA2BU,KAAA,CAAM,SAAA,EAAW,cAAA,EAAgB,OAAA,GAAU,YAAY;AAAA,iBAavD,QAAA,CAAS,SAAyB,EAAd,cAAc;AAAA,iBAmClC,cAAA,CACd,UAAA,EAAY,eAAA,EACZ,OAAA,GAAS,qBAA0B;AAAA,iBAWrB,KAAA,6BACd,IAAA,EAAM,KAAA,EACN,SAAA,EAAW,cAAA,CAAe,eAAA,CAAgB,KAAA,IAC1C,OAAA,GAAU,YAAA,CAAa,eAAA,CAAgB,KAAA;AAAA,iBAEzB,KAAA,gDAEK,iBAAA,EAEnB,IAAA,EAAM,KAAA,EACN,SAAA,EAAW,wBAAA,CAAyB,KAAA,EAAO,UAAA,GAC3C,OAAA,GAAU,wBAAA,CAAyB,KAAA,EAAO,UAAA"}

package/dist/router/authoring.js

@@ -0,0 +1,198 @@
+import { getCurrentComponentInstance } from "../runtime/component-scope.js";
+import "../runtime/component.js";
+import { getExecutionModel } from "../runtime/execution-model.js";
+import { computeRank, normalizeRouteSegmentName, parseSegments } from "./match.js";
+import { compileNodePolicies, nextAccessScopeState, validateAccessMetadata } from "./access.js";
+import { createRouteHandler } from "./rendering.js";
+import { addRouteToStores, assertRouteRegistrationUnlocked, getCurrentAccessScopeState, getCurrentInheritedPolicies, getCurrentLayoutChain, getCurrentPageChain, getCurrentPageScope, getCurrentPathPrefix, getCurrentRegistrationSession, getCurrentScopeKind, hasActivePageScope, insertRecordSorted, pushRegistrationScope, pushRegistrationSession, setDefaultRouteAuthOptions } from "./store.js";
+//#region src/router/authoring.ts
+function validateRoutePath(path) {
+	if (!path.startsWith("/")) throw new Error(`Route path must begin with "/". Got: "${path}"`);
+	if (/\/{2,}/.test(path)) throw new Error("Route path cannot contain consecutive slashes.");
+	if (/:([^/{}]+)/.test(path)) {
+		const suggested = path.replace(/:([^/{}]+)/g, "{$1}");
+		throw new Error(`Route parameter syntax uses {name} interpolation, not :name. Use "${suggested}" instead of "${path}".`);
+	}
+	const segments = path.split("/").filter(Boolean);
+	const seenParamNames = /* @__PURE__ */ new Set();
+	for (let index = 0; index < segments.length; index++) {
+		const segment = segments[index];
+		if (segment === "*") continue;
+		const hasOpenBrace = segment.includes("{");
+		const hasCloseBrace = segment.includes("}");
+		if (!hasOpenBrace && !hasCloseBrace) continue;
+		if (!(segment.startsWith("{") && segment.endsWith("}"))) throw new Error("Route parameter segments must use complete {name} interpolation.");
+		const rawParamName = normalizeRouteSegmentName(segment.slice(1, -1));
+		const isSplat = rawParamName.startsWith("*");
+		const paramName = isSplat ? normalizeRouteSegmentName(rawParamName.slice(1)) : rawParamName;
+		if (!paramName) throw new Error(isSplat ? "Route splat parameter name cannot be empty." : "Route parameter name cannot be empty.");
+		if (isSplat && paramName === "*") throw new Error("Route named splat parameter name cannot be \"*\".");
+		if (isSplat && index !== segments.length - 1) throw new Error("Route named splat parameters must be the final segment.");
+		if (seenParamNames.has(paramName)) throw new Error(`Route path cannot reuse duplicate parameter name "${paramName}".`);
+		seenParamNames.add(paramName);
+	}
+}
+function normalizeAbsoluteRoutePath(path) {
+	if (!path || path === "/") return "/";
+	return (path.endsWith("/") ? path.slice(0, -1) : path) || "/";
+}
+function joinRoutePaths(prefix, path) {
+	const normalizedPrefix = normalizeAbsoluteRoutePath(prefix || "/");
+	const normalizedPath = path.replace(/^\/+|\/+$/g, "");
+	if (!normalizedPath) return normalizedPrefix;
+	return normalizedPrefix === "/" ? `/${normalizedPath}` : `${normalizedPrefix}/${normalizedPath}`;
+}
+function resolvePageScopePath(path) {
+	if (!path) throw new Error("page(path, Component, fn) requires a non-empty path.");
+	if (path.startsWith("/")) {
+		validateRoutePath(path);
+		return normalizeAbsoluteRoutePath(path);
+	}
+	return joinRoutePaths(getCurrentPathPrefix(), path);
+}
+function resolveIndexPath() {
+	return normalizeAbsoluteRoutePath(getCurrentPathPrefix() || "/");
+}
+function resolveRouteRegistrationPath(path) {
+	if (path.startsWith("/")) {
+		if (hasActivePageScope()) throw new Error(`Child route paths inside page() must be relative. Use "${path.slice(1)}" instead of "${path}".`);
+		validateRoutePath(path);
+		return normalizeAbsoluteRoutePath(path);
+	}
+	const prefix = getCurrentPathPrefix();
+	if (!prefix) throw new Error(`Route path must begin with "/". Got: "${path}"`);
+	return joinRoutePaths(prefix, path);
+}
+function pushGroupScope(options, fn) {
+	validateAccessMetadata(options, {
+		authConfigured: getCurrentRegistrationSession().authConfigured,
+		state: getCurrentAccessScopeState()
+	});
+	const policies = compileNodePolicies(options);
+	pushRegistrationScope({
+		kind: "group",
+		pathPrefix: getCurrentPathPrefix(),
+		layout: options.layout,
+		policies,
+		state: nextAccessScopeState(options, getCurrentAccessScopeState())
+	}, fn);
+}
+function pushPageScope(path, Component, options, fn) {
+	if (hasActivePageScope()) throw new Error("page() cannot be nested inside another page(). Use route() for child leaves or group() for inherited behavior inside the existing page scope.");
+	validateAccessMetadata(options, {
+		authConfigured: getCurrentRegistrationSession().authConfigured,
+		state: getCurrentAccessScopeState()
+	});
+	const policies = compileNodePolicies(options);
+	pushRegistrationScope({
+		kind: "page",
+		pathPrefix: resolvePageScopePath(path),
+		page: Component,
+		hasIndex: false,
+		policies,
+		state: nextAccessScopeState(options, getCurrentAccessScopeState())
+	}, fn);
+}
+function normalizeRouteOptions(options) {
+	if (!options) return;
+	const loader = options.loader;
+	const policies = compileNodePolicies(options);
+	if (!loader && !options.entries && policies.length === 0 && !options.title && !options.namespace && options.auth === void 0 && !options.role && !options.permission) return;
+	return {
+		...loader ? { loader } : {},
+		...options.entries ? { entries: options.entries } : {},
+		...options.auth !== void 0 ? { auth: options.auth } : {},
+		...options.role ? { role: options.role } : {},
+		...options.permission ? { permission: options.permission } : {},
+		...policies.length > 0 ? { policies } : {},
+		...options.title ? { title: options.title } : {},
+		...options.namespace ? { namespace: options.namespace } : {}
+	};
+}
+function registerRouteAtResolvedPath(path, Component, options, metadata) {
+	validateRoutePath(path);
+	validateAccessMetadata(options ?? {}, {
+		authConfigured: getCurrentRegistrationSession().authConfigured,
+		state: getCurrentAccessScopeState()
+	});
+	const chain = getCurrentLayoutChain();
+	const pageChain = getCurrentPageChain();
+	const segments = parseSegments(path);
+	const rank = computeRank(segments);
+	const isFallback = metadata?.isFallback ?? path === "/*";
+	const comp = Component;
+	const normalizedOptions = normalizeRouteOptions(options);
+	const policies = [...getCurrentInheritedPolicies(), ...normalizedOptions?.policies ?? []];
+	const handler = createRouteHandler(comp, pageChain, chain);
+	const renderHandler = createRouteHandler(comp, pageChain, chain, true);
+	insertRecordSorted({
+		path,
+		component: comp,
+		segments,
+		rank,
+		layoutChain: chain,
+		pageChain,
+		options: normalizedOptions ? {
+			...normalizedOptions,
+			...policies.length > 0 ? { policies } : {}
+		} : policies.length > 0 ? { policies } : {},
+		isFallback,
+		handler,
+		renderHandler,
+		...metadata?.fallbackPrefix ? { fallbackPrefix: metadata.fallbackPrefix } : {}
+	});
+	addRouteToStores({
+		path,
+		handler,
+		namespace: normalizedOptions?.namespace ?? options?.namespace,
+		...metadata?.fallbackPrefix ? { fallbackPrefix: metadata.fallbackPrefix } : {}
+	});
+}
+function group(options, fn) {
+	pushGroupScope(options, fn);
+}
+function page(path, Component, optionsOrFn, maybeFn) {
+	const options = typeof optionsOrFn === "function" ? {} : optionsOrFn;
+	const fn = typeof optionsOrFn === "function" ? optionsOrFn : maybeFn;
+	if (typeof Component !== "function") throw new Error("page(path, Component, fn) requires a component function as the second argument.");
+	if (typeof fn !== "function") throw new Error("page(path, Component, fn) requires a route definition callback as the final argument.");
+	pushPageScope(path, Component, options, fn);
+}
+function index(Component, options) {
+	const pageScope = getCurrentPageScope();
+	if (pageScope?.hasIndex) throw new Error("page() cannot declare multiple index routes.");
+	if (pageScope) pageScope.hasIndex = true;
+	registerRouteAtResolvedPath(resolveIndexPath(), Component, options);
+}
+function fallback(Component) {
+	if (hasActivePageScope()) {
+		if (getCurrentScopeKind() !== "page") throw new Error("fallback() inside page() must be declared directly in the page scope, not inside nested group().");
+		registerRouteAtResolvedPath(`${getCurrentPathPrefix()}/*`, Component, void 0, {
+			isFallback: true,
+			fallbackPrefix: getCurrentPathPrefix()
+		});
+		return;
+	}
+	if (!(getCurrentInheritedPolicies().length === 0 && !getCurrentAccessScopeState().guestOnly && !getCurrentAccessScopeState().authenticated)) throw new Error("fallback() can only be registered at the root scope. Use route(\"/*\", Component) if you need compatibility behavior.");
+	registerRouteAtResolvedPath("/*", Component, void 0, {
+		isFallback: true,
+		fallbackPrefix: "/"
+	});
+}
+function registerRoutes(definition, options = {}) {
+	setDefaultRouteAuthOptions(options.auth);
+	pushRegistrationSession({ authConfigured: !!options.auth?.resolve }, definition);
+}
+function route(path, Component, options) {
+	if (typeof path === "undefined") throw new Error("route() is only for route registration. Use currentRoute() inside components.");
+	if (getExecutionModel() === "islands") throw new Error("Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.");
+	const currentInst = getCurrentComponentInstance();
+	if (currentInst && currentInst.ssr) throw new Error("route() cannot be called during SSR rendering. Register routes at module load time instead.");
+	assertRouteRegistrationUnlocked();
+	if (typeof Component !== "function") throw new Error("route(path, Component) requires a component function as the second argument. Passing JSX elements or VNodes directly is not supported.");
+	registerRouteAtResolvedPath(resolveRouteRegistrationPath(path), Component, options);
+}
+//#endregion
+export { fallback, group, index, page, registerRoutes, route };
+
+//# sourceMappingURL=authoring.js.map

package/dist/router/authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.js","names":[],"sources":["../../src/router/authoring.ts"],"sourcesContent":["import type {\n  GroupHelperOptions,\n  PageHelperOptions,\n  RegisterRoutesOptions,\n  RouteComponent,\n  RouteDefinition,\n  RouteOptions,\n  RouteParams,\n  RoutePathParams,\n} from '../common/router';\nimport { getCurrentComponentInstance } from '../runtime/component';\nimport { getExecutionModel } from '../runtime/execution-model';\nimport { computeRank, normalizeRouteSegmentName, parseSegments } from './match';\nimport {\n  compileNodePolicies,\n  nextAccessScopeState,\n  validateAccessMetadata,\n} from './access';\nimport type { AnyRouteComponent, InternalRouteRecord } from './internal-types';\nimport { createRouteHandler } from './rendering';\nimport {\n  addRouteToStores,\n  assertRouteRegistrationUnlocked,\n  getCurrentAccessScopeState,\n  getCurrentInheritedPolicies,\n  getCurrentLayoutChain,\n  getCurrentPageChain,\n  getCurrentPageScope,\n  getCurrentPathPrefix,\n  getCurrentRegistrationSession,\n  getCurrentScopeKind,\n  hasActivePageScope,\n  insertRecordSorted,\n  pushRegistrationScope,\n  pushRegistrationSession,\n  setDefaultRouteAuthOptions,\n} from './store';\n\ntype RouteComponentParam<TComponent extends AnyRouteComponent> =\n  Parameters<TComponent> extends [] ? unknown : Parameters<TComponent>[0];\n\ntype CompatibleAbsoluteRouteComponent<\n  Path extends string,\n  TComponent extends AnyRouteComponent,\n> =\n  Parameters<TComponent> extends []\n    ? TComponent\n    : RoutePathParams<Path> extends RouteComponentParam<TComponent>\n      ? TComponent\n      : never;\n\ntype CompatibleRelativeRouteComponent<\n  Path extends string,\n  TComponent extends AnyRouteComponent,\n> =\n  Parameters<TComponent> extends []\n    ? TComponent\n    : RouteComponentParam<TComponent> extends Record<\n          keyof RoutePathParams<Path>,\n          string\n        >\n      ? TComponent\n      : never;\n\ntype CompatibleRouteComponent<\n  Path extends string,\n  TComponent extends AnyRouteComponent,\n> = Path extends `/${string}`\n  ? CompatibleAbsoluteRouteComponent<Path, TComponent>\n  : CompatibleRelativeRouteComponent<Path, TComponent>;\n\ntype RouteOptionsForComponent<\n  Path extends string,\n  TComponent extends AnyRouteComponent,\n> =\n  Parameters<TComponent> extends []\n    ? RouteOptions<RoutePathParams<Path>>\n    : RouteComponentParam<TComponent> extends RouteParams\n      ? RouteOptions<RouteComponentParam<TComponent>>\n      : RouteOptions<RoutePathParams<Path>>;\n\nfunction validateRoutePath(path: string): void {\n  if (!path.startsWith('/')) {\n    throw new Error(`Route path must begin with \"/\". Got: \"${path}\"`);\n  }\n  if (/\\/{2,}/.test(path)) {\n    throw new Error('Route path cannot contain consecutive slashes.');\n  }\n  if (/:([^/{}]+)/.test(path)) {\n    const suggested = path.replace(/:([^/{}]+)/g, '{$1}');\n    throw new Error(\n      `Route parameter syntax uses {name} interpolation, not :name. ` +\n        `Use \"${suggested}\" instead of \"${path}\".`\n    );\n  }\n\n  const segments = path.split('/').filter(Boolean);\n  const seenParamNames = new Set<string>();\n\n  for (let index = 0; index < segments.length; index++) {\n    const segment = segments[index];\n    if (segment === '*') {\n      continue;\n    }\n\n    const hasOpenBrace = segment.includes('{');\n    const hasCloseBrace = segment.includes('}');\n\n    if (!hasOpenBrace && !hasCloseBrace) {\n      continue;\n    }\n\n    if (!(segment.startsWith('{') && segment.endsWith('}'))) {\n      throw new Error(\n        'Route parameter segments must use complete {name} interpolation.'\n      );\n    }\n\n    const rawParamName = normalizeRouteSegmentName(segment.slice(1, -1));\n    const isSplat = rawParamName.startsWith('*');\n    const paramName = isSplat\n      ? normalizeRouteSegmentName(rawParamName.slice(1))\n      : rawParamName;\n\n    if (!paramName) {\n      throw new Error(\n        isSplat\n          ? 'Route splat parameter name cannot be empty.'\n          : 'Route parameter name cannot be empty.'\n      );\n    }\n\n    if (isSplat && paramName === '*') {\n      throw new Error('Route named splat parameter name cannot be \"*\".');\n    }\n\n    if (isSplat && index !== segments.length - 1) {\n      throw new Error(\n        'Route named splat parameters must be the final segment.'\n      );\n    }\n\n    if (seenParamNames.has(paramName)) {\n      throw new Error(\n        `Route path cannot reuse duplicate parameter name \"${paramName}\".`\n      );\n    }\n\n    seenParamNames.add(paramName);\n  }\n}\n\nfunction normalizeAbsoluteRoutePath(path: string): string {\n  if (!path || path === '/') {\n    return '/';\n  }\n\n  const normalized = path.endsWith('/') ? path.slice(0, -1) : path;\n  return normalized || '/';\n}\n\nfunction joinRoutePaths(prefix: string, path: string): string {\n  const normalizedPrefix = normalizeAbsoluteRoutePath(prefix || '/');\n  const normalizedPath = path.replace(/^\\/+|\\/+$/g, '');\n\n  if (!normalizedPath) {\n    return normalizedPrefix;\n  }\n\n  return normalizedPrefix === '/'\n    ? `/${normalizedPath}`\n    : `${normalizedPrefix}/${normalizedPath}`;\n}\n\nfunction resolvePageScopePath(path: string): string {\n  if (!path) {\n    throw new Error('page(path, Component, fn) requires a non-empty path.');\n  }\n\n  if (path.startsWith('/')) {\n    validateRoutePath(path);\n    return normalizeAbsoluteRoutePath(path);\n  }\n\n  return joinRoutePaths(getCurrentPathPrefix(), path);\n}\n\nfunction resolveIndexPath(): string {\n  return normalizeAbsoluteRoutePath(getCurrentPathPrefix() || '/');\n}\n\nfunction resolveRouteRegistrationPath(path: string): string {\n  if (path.startsWith('/')) {\n    if (hasActivePageScope()) {\n      throw new Error(\n        'Child route paths inside page() must be relative. ' +\n          `Use \"${path.slice(1)}\" instead of \"${path}\".`\n      );\n    }\n\n    validateRoutePath(path);\n    return normalizeAbsoluteRoutePath(path);\n  }\n\n  const prefix = getCurrentPathPrefix();\n\n  if (!prefix) {\n    throw new Error(`Route path must begin with \"/\". Got: \"${path}\"`);\n  }\n\n  return joinRoutePaths(prefix, path);\n}\n\nfunction pushGroupScope(\n  options: GroupHelperOptions,\n  fn: RouteDefinition\n): void {\n  const session = getCurrentRegistrationSession();\n  validateAccessMetadata(options, {\n    authConfigured: session.authConfigured,\n    state: getCurrentAccessScopeState(),\n  });\n  const policies = compileNodePolicies(options);\n\n  pushRegistrationScope(\n    {\n      kind: 'group',\n      pathPrefix: getCurrentPathPrefix(),\n      layout: options.layout,\n      policies,\n      state: nextAccessScopeState(options, getCurrentAccessScopeState()),\n    },\n    fn\n  );\n}\n\nfunction pushPageScope(\n  path: string,\n  Component: RouteComponent,\n  options: PageHelperOptions,\n  fn: RouteDefinition\n): void {\n  if (hasActivePageScope()) {\n    throw new Error(\n      'page() cannot be nested inside another page(). ' +\n        'Use route() for child leaves or group() for inherited behavior inside the existing page scope.'\n    );\n  }\n\n  const session = getCurrentRegistrationSession();\n  validateAccessMetadata(options, {\n    authConfigured: session.authConfigured,\n    state: getCurrentAccessScopeState(),\n  });\n\n  const policies = compileNodePolicies(options);\n\n  pushRegistrationScope(\n    {\n      kind: 'page',\n      pathPrefix: resolvePageScopePath(path),\n      page: Component,\n      hasIndex: false,\n      policies,\n      state: nextAccessScopeState(options, getCurrentAccessScopeState()),\n    },\n    fn\n  );\n}\n\nfunction normalizeRouteOptions(\n  options: RouteOptions | undefined\n): RouteOptions | undefined {\n  if (!options) {\n    return undefined;\n  }\n\n  const loader = options.loader;\n  const policies = compileNodePolicies(options);\n\n  if (\n    !loader &&\n    !options.entries &&\n    policies.length === 0 &&\n    !options.title &&\n    !options.namespace &&\n    options.auth === undefined &&\n    !options.role &&\n    !options.permission\n  ) {\n    return undefined;\n  }\n\n  return {\n    ...(loader ? { loader } : {}),\n    ...(options.entries ? { entries: options.entries } : {}),\n    ...(options.auth !== undefined ? { auth: options.auth } : {}),\n    ...(options.role ? { role: options.role } : {}),\n    ...(options.permission ? { permission: options.permission } : {}),\n    ...(policies.length > 0 ? { policies } : {}),\n    ...(options.title ? { title: options.title } : {}),\n    ...(options.namespace ? { namespace: options.namespace } : {}),\n  };\n}\n\nfunction registerRouteAtResolvedPath(\n  path: string,\n  Component: RouteComponent,\n  options?: RouteOptions,\n  metadata?: {\n    isFallback?: boolean;\n    fallbackPrefix?: string;\n  }\n): void {\n  validateRoutePath(path);\n\n  validateAccessMetadata(options ?? {}, {\n    authConfigured: getCurrentRegistrationSession().authConfigured,\n    state: getCurrentAccessScopeState(),\n  });\n\n  const chain = getCurrentLayoutChain();\n  const pageChain = getCurrentPageChain();\n  const segments = parseSegments(path);\n  const rank = computeRank(segments);\n  const isFallback = metadata?.isFallback ?? path === '/*';\n  const comp = Component;\n  const normalizedOptions = normalizeRouteOptions(options);\n  const policies = [\n    ...getCurrentInheritedPolicies(),\n    ...(normalizedOptions?.policies ?? []),\n  ];\n\n  const handler = createRouteHandler(comp, pageChain, chain);\n  const renderHandler = createRouteHandler(comp, pageChain, chain, true);\n\n  const record: InternalRouteRecord = {\n    path,\n    component: comp,\n    segments,\n    rank,\n    layoutChain: chain,\n    pageChain,\n    options: normalizedOptions\n      ? {\n          ...normalizedOptions,\n          ...(policies.length > 0 ? { policies } : {}),\n        }\n      : policies.length > 0\n        ? { policies }\n        : {},\n    isFallback,\n    handler,\n    renderHandler,\n    ...(metadata?.fallbackPrefix\n      ? { fallbackPrefix: metadata.fallbackPrefix }\n      : {}),\n  };\n\n  insertRecordSorted(record);\n  addRouteToStores({\n    path,\n    handler,\n    namespace: normalizedOptions?.namespace ?? options?.namespace,\n    ...(metadata?.fallbackPrefix\n      ? { fallbackPrefix: metadata.fallbackPrefix }\n      : {}),\n  });\n}\n\nexport function group(options: GroupHelperOptions, fn: RouteDefinition): void;\nexport function group(options: GroupHelperOptions, fn: RouteDefinition): void {\n  pushGroupScope(options, fn);\n}\n\nexport function page<const TPath extends string>(\n  path: TPath,\n  Component: RouteComponent<RoutePathParams<TPath>>,\n  fn: RouteDefinition\n): void;\nexport function page<\n  const TPath extends string,\n  TComponent extends AnyRouteComponent,\n>(\n  path: TPath,\n  Component: CompatibleRouteComponent<TPath, TComponent>,\n  fn: RouteDefinition\n): void;\nexport function page<const TPath extends string>(\n  path: TPath,\n  Component: RouteComponent<RoutePathParams<TPath>>,\n  options: PageHelperOptions,\n  fn: RouteDefinition\n): void;\nexport function page<\n  const TPath extends string,\n  TComponent extends AnyRouteComponent,\n>(\n  path: TPath,\n  Component: CompatibleRouteComponent<TPath, TComponent>,\n  options: PageHelperOptions,\n  fn: RouteDefinition\n): void;\nexport function page(\n  path: string,\n  Component: RouteComponent,\n  optionsOrFn: PageHelperOptions | RouteDefinition,\n  maybeFn?: RouteDefinition\n): void {\n  const options =\n    typeof optionsOrFn === 'function' ? ({} as PageHelperOptions) : optionsOrFn;\n  const fn = typeof optionsOrFn === 'function' ? optionsOrFn : maybeFn;\n\n  if (typeof Component !== 'function') {\n    throw new Error(\n      'page(path, Component, fn) requires a component function as the second argument.'\n    );\n  }\n\n  if (typeof fn !== 'function') {\n    throw new Error(\n      'page(path, Component, fn) requires a route definition callback as the final argument.'\n    );\n  }\n\n  pushPageScope(path, Component, options, fn);\n}\n\nexport function index(Component: RouteComponent, options?: RouteOptions): void {\n  const pageScope = getCurrentPageScope();\n  if (pageScope?.hasIndex) {\n    throw new Error('page() cannot declare multiple index routes.');\n  }\n\n  if (pageScope) {\n    pageScope.hasIndex = true;\n  }\n\n  registerRouteAtResolvedPath(resolveIndexPath(), Component, options);\n}\n\nexport function fallback(Component: RouteComponent): void {\n  if (hasActivePageScope()) {\n    if (getCurrentScopeKind() !== 'page') {\n      throw new Error(\n        'fallback() inside page() must be declared directly in the page scope, not inside nested group().'\n      );\n    }\n\n    registerRouteAtResolvedPath(\n      `${getCurrentPathPrefix()}/*`,\n      Component,\n      undefined,\n      { isFallback: true, fallbackPrefix: getCurrentPathPrefix() }\n    );\n    return;\n  }\n\n  const allowsRootFallback =\n    getCurrentInheritedPolicies().length === 0 &&\n    !getCurrentAccessScopeState().guestOnly &&\n    !getCurrentAccessScopeState().authenticated;\n\n  if (!allowsRootFallback) {\n    throw new Error(\n      'fallback() can only be registered at the root scope. ' +\n        'Use route(\"/*\", Component) if you need compatibility behavior.'\n    );\n  }\n\n  registerRouteAtResolvedPath('/*', Component, undefined, {\n    isFallback: true,\n    fallbackPrefix: '/',\n  });\n}\n\nexport function registerRoutes(\n  definition: RouteDefinition,\n  options: RegisterRoutesOptions = {}\n): void {\n  setDefaultRouteAuthOptions(options.auth);\n  pushRegistrationSession(\n    {\n      authConfigured: !!options.auth?.resolve,\n    },\n    definition\n  );\n}\n\nexport function route<const TPath extends string>(\n  path: TPath,\n  Component: RouteComponent<RoutePathParams<TPath>>,\n  options?: RouteOptions<RoutePathParams<TPath>>\n): void;\nexport function route<\n  const TPath extends string,\n  TComponent extends AnyRouteComponent,\n>(\n  path: TPath,\n  Component: CompatibleRouteComponent<TPath, TComponent>,\n  options?: RouteOptionsForComponent<TPath, TComponent>\n): void;\nexport function route(\n  path: string,\n  Component: RouteComponent,\n  options?: RouteOptions\n): void {\n  if (typeof path === 'undefined') {\n    throw new Error(\n      'route() is only for route registration. Use currentRoute() inside components.'\n    );\n  }\n\n  if (getExecutionModel() === 'islands') {\n    throw new Error(\n      'Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.'\n    );\n  }\n\n  const currentInst = getCurrentComponentInstance();\n  if (currentInst && currentInst.ssr) {\n    throw new Error(\n      'route() cannot be called during SSR rendering. Register routes at module load time instead.'\n    );\n  }\n\n  assertRouteRegistrationUnlocked();\n\n  if (typeof Component !== 'function') {\n    throw new Error(\n      'route(path, Component) requires a component function as the second argument. ' +\n        'Passing JSX elements or VNodes directly is not supported.'\n    );\n  }\n\n  registerRouteAtResolvedPath(\n    resolveRouteRegistrationPath(path),\n    Component,\n    options\n  );\n}\n"],"mappings":"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"}

package/dist/router/index.d.ts

@@ -1,6 +1,14 @@
-import { AccessDecision, AccessDenyDecision, AccessRedirectDecision, GroupHelperOptions, LayoutScopeRecord, PageHelperOptions, PageScopeRecord, ParsedSegment, RegisterRoutesOptions, Route, RouteAuthMode, RouteAuthOptions, RouteAuthResolver, RouteAuthState, RouteComponent, RouteContext, RouteDefinition, RouteHandler, RouteManifest, RouteMatch, RouteMode, RouteOptions, RouteParams, RoutePathParams, RoutePolicy, RouteQuery, RouteRecord, RouteRenderResult, RouteRequestOptions, RouteRequestResult, RouteSnapshot } from "../common/router.js";
-import { HistoryScrollBehavior, NavigateOptions, NavigationScrollBehavior, RouteQueryParamInput, RouteQueryParamValue, RouteQueryUpdater, RouteQueryUpdates, ScrollRestorationOptions, UpdateRouteQueryOptions, navigate, updateRouteQuery } from "./navigate.js";
-import { Outlet, clearRoutes, currentRoute, fallback, getManifest, getRoutes, group, index, lazy, page, registerRoutes, route } from "./route.js";
+import { AccessDecision, AccessDenyDecision, AccessRedirectDecision, GroupHelperOptions, LayoutScopeRecord, PageHelperOptions, PageScopeRecord, ParsedSegment, RegisterRoutesOptions, Route, RouteAuthMode, RouteAuthOptions, RouteAuthResolver, RouteAuthState, RouteComponent, RouteContext, RouteDefinition, RouteHandler, RouteManifest, RouteMatch, RouteMode, RouteOptions, RouteParams, RoutePathParams, RoutePolicy, RouteQuery, RouteRecord, RouteRegistry, RouteRenderResult, RouteRequestOptions, RouteRequestResult, RouteSnapshot } from "../common/router.js";
+import { HistoryScrollBehavior, NavigationScrollBehavior, ScrollRestorationOptions } from "./navigation-scroll.js";
+import { NavigateOptions } from "./navigation-targets.js";
+import { RouteQueryParamInput, RouteQueryParamValue, RouteQueryUpdater, RouteQueryUpdates, UpdateRouteQueryOptions, updateRouteQuery } from "./route-query.js";
+import { navigate } from "./navigate.js";
+import { fallback, group, index, page, registerRoutes, route } from "./authoring.js";
+import { currentRoute } from "./activity.js";
+import { clearRoutes, createRouteRegistry, getManifest } from "./manifest.js";
+import { getRoutes } from "./store.js";
+import { lazy } from "./lazy.js";
+import { Outlet } from "./rendering.js";
 import { allow, deny, forbidden, notFound, redirect, requireAuth, requirePermission, requireRole, unauthorized } from "./policy.js";
 import { Link, LinkProps } from "../components/link.js";
-export { type AccessDecision, type AccessDenyDecision, type AccessRedirectDecision, type GroupHelperOptions, type HistoryScrollBehavior, type LayoutScopeRecord, Link, type LinkProps, type NavigateOptions, type NavigationScrollBehavior, Outlet, type PageHelperOptions, type PageScopeRecord, type ParsedSegment, type RegisterRoutesOptions, type Route, type RouteAuthMode, type RouteAuthOptions, type RouteAuthResolver, type RouteAuthState, type RouteComponent, type RouteContext, type RouteDefinition, type RouteHandler, type RouteManifest, type RouteMatch, type RouteMode, type RouteOptions, type RouteParams, type RoutePathParams, type RoutePolicy, type RouteQuery, type RouteQueryParamInput, type RouteQueryParamValue, type RouteQueryUpdater, type RouteQueryUpdates, type RouteRecord, type RouteRenderResult, type RouteRequestOptions, type RouteRequestResult, type RouteSnapshot, type ScrollRestorationOptions, type UpdateRouteQueryOptions, allow, clearRoutes, currentRoute, deny, fallback, forbidden, getManifest, getRoutes, group, index, lazy, navigate, notFound, page, redirect, registerRoutes, requireAuth, requirePermission, requireRole, route, unauthorized, updateRouteQuery };
+export { type AccessDecision, type AccessDenyDecision, type AccessRedirectDecision, type GroupHelperOptions, type HistoryScrollBehavior, type LayoutScopeRecord, Link, type LinkProps, type NavigateOptions, type NavigationScrollBehavior, Outlet, type PageHelperOptions, type PageScopeRecord, type ParsedSegment, type RegisterRoutesOptions, type Route, type RouteAuthMode, type RouteAuthOptions, type RouteAuthResolver, type RouteAuthState, type RouteComponent, type RouteContext, type RouteDefinition, type RouteHandler, type RouteManifest, type RouteMatch, type RouteMode, type RouteOptions, type RouteParams, type RoutePathParams, type RoutePolicy, type RouteQuery, type RouteQueryParamInput, type RouteQueryParamValue, type RouteQueryUpdater, type RouteQueryUpdates, type RouteRecord, type RouteRegistry, type RouteRenderResult, type RouteRequestOptions, type RouteRequestResult, type RouteSnapshot, type ScrollRestorationOptions, type UpdateRouteQueryOptions, allow, clearRoutes, createRouteRegistry, currentRoute, deny, fallback, forbidden, getManifest, getRoutes, group, index, lazy, navigate, notFound, page, redirect, registerRoutes, requireAuth, requirePermission, requireRole, route, unauthorized, updateRouteQuery };

package/dist/router/index.js

@@ -1,5 +1,12 @@
 import { allow, deny, forbidden, notFound, redirect, requireAuth, requirePermission, requireRole, unauthorized } from "./policy.js";
-import { Outlet, clearRoutes, currentRoute, fallback, getManifest, getRoutes, group, index, lazy, page, registerRoutes, route } from "./route.js";
-import { navigate, updateRouteQuery } from "./navigate.js";
+import { Outlet } from "./rendering.js";
+import { getRoutes } from "./store.js";
+import { fallback, group, index, page, registerRoutes, route } from "./authoring.js";
+import { currentRoute } from "./activity.js";
+import { lazy } from "./lazy.js";
+import { clearRoutes, createRouteRegistry, getManifest } from "./manifest.js";
+import "./route.js";
+import { updateRouteQuery } from "./route-query.js";
+import { navigate } from "./navigate.js";
 import { Link } from "../components/link.js";
-export { Link, Outlet, allow, clearRoutes, currentRoute, deny, fallback, forbidden, getManifest, getRoutes, group, index, lazy, navigate, notFound, page, redirect, registerRoutes, requireAuth, requirePermission, requireRole, route, unauthorized, updateRouteQuery };
+export { Link, Outlet, allow, clearRoutes, createRouteRegistry, currentRoute, deny, fallback, forbidden, getManifest, getRoutes, group, index, lazy, navigate, notFound, page, redirect, registerRoutes, requireAuth, requirePermission, requireRole, route, unauthorized, updateRouteQuery };