@jasonshimmy/custom-elements-runtime 3.3.0 → 3.5.0

package/dist/custom-elements-runtime.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-elements-runtime.es.js","names":[],"sources":["../src/lib/runtime/hydration.ts","../src/lib/runtime/monitoring/health-monitor.ts","../src/lib/keep-alive.ts","../src/lib/runtime/builtin-components.ts","../src/lib/teleport.ts"],"sourcesContent":["/**\n * Client-side hydration helpers.\n *\n * When the server renders with `dsd: true`, each custom element's shadow DOM\n * is already present in the HTML via a Declarative Shadow DOM template. The\n * browser parses that template and attaches the shadow root before any\n * JavaScript runs. When the JS bundle loads, the custom element constructors\n * detect the existing shadow root and skip the `attachShadow()` call, then\n * hydrate (attach reactivity to) the existing DOM on `connectedCallback`.\n *\n * `hydrateApp` is a signal/entry point for this process. In most cases custom\n * elements self-hydrate automatically on connection — this function is useful\n * when you need to explicitly trigger or defer the hydration of a subtree.\n */\n\n/**\n * Trigger hydration for all registered custom elements within `root`.\n *\n * In practice, custom elements self-hydrate as soon as their class definition\n * is registered and the element is connected to the DOM. Call `hydrateApp`\n * after importing and calling `component()` for all your components to signal\n * that the page is ready for reactive activation.\n *\n * @param root - The root element to hydrate. Defaults to `document`.\n *\n * @example\n * ```ts\n * import { component, hydrateApp } from '@jasonshimmy/custom-elements-runtime';\n * import './components'; // registers all components via component()\n *\n * hydrateApp(); // activate all DSD-rendered components on the page\n * ```\n */\nexport function hydrateApp(root: Element | Document = document): void {\n  if (typeof CustomEvent === 'undefined') return;\n  const target =\n    root instanceof Document ? root.documentElement : (root as Element);\n  target.dispatchEvent(\n    new CustomEvent('cer:hydrate', { bubbles: true, composed: true }),\n  );\n}\n","/**\n * Runtime Health Monitoring System\n * Tracks framework health metrics and provides early warning for potential issues\n */\n\nimport { devWarn, devError } from '../logger';\n\ninterface HealthMetric {\n  name: string;\n  value: number;\n  threshold: number;\n  status: 'healthy' | 'warning' | 'critical';\n  lastUpdated: number;\n  history: number[];\n}\n\ninterface HealthReport {\n  overall: 'healthy' | 'warning' | 'critical';\n  metrics: Record<string, HealthMetric>;\n  timestamp: number;\n  recommendations: string[];\n}\nexport type { HealthReport };\n\n/**\n * Public interface for a health monitor instance.\n * All state is managed internally via closures — no class syntax.\n */\nexport interface HealthMonitorInstance {\n  /** Update a specific health metric value */\n  updateMetric(name: string, value: number): void;\n  /** Get the current health report */\n  getHealthReport(): HealthReport;\n  /** Add a listener to be notified when a health check runs */\n  addListener(listener: (report: HealthReport) => void): void;\n  /** Remove a previously registered listener */\n  removeListener(listener: (report: HealthReport) => void): void;\n  /** Stop the periodic health monitoring timer */\n  stop(): void;\n  /** Get historical values for a specific metric */\n  getMetricHistory(name: string): number[];\n  /** Clear all metric history */\n  clearHistory(): void;\n}\n\nconst MAX_HISTORY_SIZE = 100;\nconst CHECK_INTERVAL = 30_000; // 30 seconds\n\nfunction calcStatus(\n  value: number,\n  threshold: number,\n  metricName: string,\n): 'healthy' | 'warning' | 'critical' {\n  if (metricName === 'jitCacheHitRate') {\n    if (value < threshold * 0.5) return 'critical';\n    if (value < threshold) return 'warning';\n    return 'healthy';\n  }\n  if (value > threshold * 2) return 'critical';\n  if (value > threshold) return 'warning';\n  return 'healthy';\n}\n\nfunction buildRecommendations(metrics: Record<string, HealthMetric>): string[] {\n  const out: string[] = [];\n  if (metrics.memoryUsage?.status !== 'healthy')\n    out.push(\n      'Consider reducing component complexity or implementing better memory cleanup',\n    );\n  if (metrics.averageRenderTime?.status !== 'healthy')\n    out.push(\n      'Optimize component render functions - consider lazy loading or virtualization',\n    );\n  if (metrics.jitCacheHitRate?.status !== 'healthy')\n    out.push(\n      'JIT CSS cache performance is poor - review CSS patterns for optimization',\n    );\n  if (metrics.componentErrorRate?.status !== 'healthy')\n    out.push(\n      'High component error rate detected - review error handling and component logic',\n    );\n  if (metrics.activeReactiveStates?.status !== 'healthy')\n    out.push(\n      'High number of reactive states - consider state consolidation or cleanup',\n    );\n  if (metrics.memoryLeakIndicator?.status !== 'healthy')\n    out.push(\n      'Potential memory leak detected - review component cleanup and event listener management',\n    );\n  return out;\n}\n\n/**\n * Create a new health monitor instance.\n * All mutable state lives in closures — no `class` or `this`.\n */\nexport function createHealthMonitor(): HealthMonitorInstance {\n  const metricsMap = new Map<string, HealthMetric>();\n  const listeners = new Set<(report: HealthReport) => void>();\n  let intervalId: ReturnType<typeof setInterval> | null = null;\n\n  function addMetric(name: string, value: number, threshold: number): void {\n    metricsMap.set(name, {\n      name,\n      value,\n      threshold,\n      status: 'healthy',\n      lastUpdated: Date.now(),\n      history: [],\n    });\n  }\n\n  function initializeMetrics(): void {\n    addMetric('activeComponents', 0, 1000);\n    addMetric('componentCreateRate', 0, 50);\n    addMetric('componentErrorRate', 0, 0.1);\n    addMetric('memoryUsage', 0, 50 * 1024 * 1024);\n    addMetric('memoryGrowthRate', 0, 1024 * 1024);\n    addMetric('averageRenderTime', 0, 16);\n    addMetric('slowRenderCount', 0, 10);\n    addMetric('jitCacheHitRate', 100, 80);\n    addMetric('activeReactiveStates', 0, 5000);\n    addMetric('dependencyUpdates', 0, 100);\n    addMetric('memoryLeakIndicator', 0, 0.1);\n  }\n\n  function updateMetric(name: string, value: number): void {\n    const metric = metricsMap.get(name);\n    if (!metric) return;\n    metric.value = value;\n    metric.lastUpdated = Date.now();\n    metric.history.push(value);\n    if (metric.history.length > MAX_HISTORY_SIZE) metric.history.shift();\n    metric.status = calcStatus(value, metric.threshold, name);\n  }\n\n  function getHealthReport(): HealthReport {\n    const snapshot: Record<string, HealthMetric> = {};\n    let overall: 'healthy' | 'warning' | 'critical' = 'healthy';\n    for (const [name, metric] of metricsMap) {\n      snapshot[name] = { ...metric };\n      if (metric.status === 'critical') overall = 'critical';\n      else if (metric.status === 'warning' && overall === 'healthy')\n        overall = 'warning';\n    }\n    return {\n      overall,\n      metrics: snapshot,\n      timestamp: Date.now(),\n      recommendations: buildRecommendations(snapshot),\n    };\n  }\n\n  function updateMemoryMetrics(): void {\n    if (\n      'memory' in performance &&\n      (performance as Record<string, unknown>).memory\n    ) {\n      const mem = (performance as Record<string, unknown>).memory as {\n        usedJSHeapSize: number;\n      };\n      updateMetric('memoryUsage', mem.usedJSHeapSize);\n      const m = metricsMap.get('memoryUsage');\n      if (m && m.history.length > 1) {\n        const prev = m.history[m.history.length - 2];\n        const curr = m.history[m.history.length - 1];\n        updateMetric('memoryGrowthRate', Math.max(0, curr - prev));\n      }\n    }\n  }\n\n  function notifyListeners(report: HealthReport): void {\n    for (const listener of listeners) {\n      try {\n        listener(report);\n      } catch (e) {\n        devError('Error in health monitor listener:', e);\n      }\n    }\n  }\n\n  function performHealthCheck(): void {\n    updateMemoryMetrics();\n    const report = getHealthReport();\n    notifyListeners(report);\n    if (report.overall === 'critical')\n      devError(\n        '🚨 Runtime Health: Critical issues detected',\n        report.recommendations,\n      );\n    else if (report.overall === 'warning')\n      devWarn(\n        '⚠️ Runtime Health: Performance warnings',\n        report.recommendations,\n      );\n  }\n\n  function startMonitoring(): void {\n    if (typeof window === 'undefined') return;\n    intervalId = setInterval(performHealthCheck, CHECK_INTERVAL);\n  }\n\n  function stop(): void {\n    if (intervalId !== null) {\n      clearInterval(intervalId);\n      intervalId = null;\n    }\n  }\n\n  function addListener(listener: (report: HealthReport) => void): void {\n    listeners.add(listener);\n  }\n  function removeListener(listener: (report: HealthReport) => void): void {\n    listeners.delete(listener);\n  }\n  function getMetricHistory(name: string): number[] {\n    const m = metricsMap.get(name);\n    return m ? [...m.history] : [];\n  }\n  function clearHistory(): void {\n    for (const m of metricsMap.values()) m.history = [];\n  }\n\n  initializeMetrics();\n  startMonitoring();\n\n  return {\n    updateMetric,\n    getHealthReport,\n    addListener,\n    removeListener,\n    stop,\n    getMetricHistory,\n    clearHistory,\n  };\n}\n\n// Global singleton\nlet _monitor: HealthMonitorInstance | null = null;\n\n/**\n * Get the global health monitor singleton instance.\n */\nexport function getHealthMonitor(): HealthMonitorInstance {\n  if (!_monitor) _monitor = createHealthMonitor();\n  return _monitor;\n}\n\n/**\n * Update a health metric from anywhere in the framework.\n */\nexport function updateHealthMetric(name: string, value: number): void {\n  getHealthMonitor().updateMetric(name, value);\n}\n\n/**\n * Get the current health status report.\n */\nexport function getHealthStatus(): HealthReport {\n  return getHealthMonitor().getHealthReport();\n}\n","/**\n * keep-alive.ts\n *\n * Preserves component state when a component is removed from and later\n * re-inserted into the DOM. By default, custom elements lose all JavaScript\n * state when `disconnectedCallback` fires. `cer-keep-alive` intercepts\n * that lifecycle and keeps the child element alive in memory, re-attaching\n * it when a matching component is re-inserted.\n *\n * ## Usage\n *\n * Wrap any custom element with `<cer-keep-alive>`:\n * ```html\n * <cer-keep-alive>\n *   <my-counter></my-counter>\n * </cer-keep-alive>\n * ```\n *\n * Or register it programmatically:\n * ```ts\n * import { registerKeepAlive } from '@jasonshimmy/custom-elements-runtime';\n * registerKeepAlive(); // registers <cer-keep-alive> globally\n * ```\n *\n * ## How it works\n *\n * `cer-keep-alive` uses a slotted layout. When a slotted child component is\n * about to leave the DOM (via a re-render of a parent), KeepAlive intercepts\n * `slotchange` events and preserves the detached child element in an internal\n * cache keyed by tag name. When the same tag re-appears in the slot, the\n * cached element is re-inserted, restoring all JavaScript state.\n *\n * ## Limitations\n *\n * - The first slot child per tag name is cached. Multiple children with the\n *   same tag use separate cache entries keyed by their `id` attribute.\n * - Only components registered with the same tag name are matched.\n * - Cache entries can be manually evicted with `clearCache()`.\n */\n\n/** Cache key = tagName[:id] */\ntype CacheKey = string;\n\n/**\n * Register the `<cer-keep-alive>` custom element.\n * Safe to call multiple times — subsequent calls are no-ops.\n *\n * @example\n * ```ts\n * import { registerKeepAlive } from '@jasonshimmy/custom-elements-runtime';\n * registerKeepAlive();\n * ```\n */\nexport function registerKeepAlive(): void {\n  if (\n    typeof window === 'undefined' ||\n    typeof customElements === 'undefined' ||\n    customElements.get('cer-keep-alive')\n  ) {\n    return;\n  }\n\n  customElements.define('cer-keep-alive', createKeepAliveClass());\n}\n\nfunction createKeepAliveClass(): CustomElementConstructor {\n  return class CerKeepAlive extends HTMLElement {\n    /** Preserved component instances keyed by tag[:id]. */\n    private _cache = new Map<CacheKey, Element>();\n    private _slot: HTMLSlotElement | null = null;\n    private _slotListener: (() => void) | null = null;\n\n    connectedCallback(): void {\n      if (!this.shadowRoot) {\n        this.attachShadow({ mode: 'open' });\n      }\n\n      if (!this.shadowRoot!.querySelector('slot')) {\n        this.shadowRoot!.innerHTML = '<slot></slot>';\n      }\n\n      this._slot = this.shadowRoot!.querySelector('slot');\n      if (this._slot) {\n        this._slotListener = () => this._handleSlotChange();\n        this._slot.addEventListener('slotchange', this._slotListener);\n        // Process current slotted content\n        this._handleSlotChange();\n      }\n    }\n\n    disconnectedCallback(): void {\n      if (this._slot && this._slotListener) {\n        this._slot.removeEventListener('slotchange', this._slotListener);\n      }\n      this._slotListener = null;\n    }\n\n    /**\n     * Evict a cached element by its cache key (`tagName` or `tagName:id`).\n     * The evicted element is disconnected and removed from the cache.\n     */\n    clearCache(key?: CacheKey): void {\n      if (key) {\n        this._cache.delete(key);\n      } else {\n        this._cache.clear();\n      }\n    }\n\n    private _handleSlotChange(): void {\n      if (!this._slot) return;\n\n      const slottedElements = this._slot.assignedElements({ flatten: true });\n\n      for (const child of slottedElements) {\n        const cacheKey = this._buildCacheKey(child);\n\n        if (!this._cache.has(cacheKey)) {\n          // New element — cache it so we can restore it later\n          this._cache.set(cacheKey, child);\n        } else {\n          const cached = this._cache.get(cacheKey)!;\n          if (cached !== child) {\n            // A different instance appeared for the same slot.\n            // Replace it with the cached instance to restore state.\n            try {\n              child.parentNode?.replaceChild(cached, child);\n            } catch {\n              // If replacement fails, update the cache with the new element\n              this._cache.set(cacheKey, child);\n            }\n          }\n        }\n      }\n    }\n\n    private _buildCacheKey(el: Element): CacheKey {\n      const tag = el.tagName.toLowerCase();\n      const id = el.getAttribute('id');\n      return id ? `${tag}:${id}` : tag;\n    }\n  };\n}\n","/**\n * Built-in utility components provided by the custom-elements runtime.\n *\n * These components are registered automatically when this module is imported.\n * They are designed to be minimal, tree-shakeable, and zero-dependency.\n *\n * Included components:\n * - `<cer-suspense>` — Shows a fallback while async work is pending\n * - `<cer-error-boundary>` — Catches render errors and shows a fallback UI\n * - `<cer-keep-alive>` — Preserves component state across DOM removal/re-insertion\n */\n\nimport { component } from './component';\nimport { html } from './template-compiler';\nimport { ref } from './reactive';\nimport { useProps, useOnError, useExpose } from './hooks';\nimport { registerKeepAlive } from '../keep-alive';\n\n// ── cer-suspense ──────────────────────────────────────────────────────────────\n\n/**\n * A built-in component that conditionally renders either the default slot\n * content or the `fallback` slot content, controlled by the `pending` prop.\n *\n * Use the `pending` attribute/property to signal that async work is in\n * progress; the component will swap to the `fallback` slot until `pending`\n * becomes falsy.\n *\n * @example\n * ```html\n * <cer-suspense pending>\n *   <!-- shown when pending=false -->\n *   <my-async-content></my-async-content>\n *\n *   <!-- shown while pending=true -->\n *   <div slot=\"fallback\">Loading…</div>\n * </cer-suspense>\n * ```\n *\n * @example Programmatic usage\n * ```ts\n * component('my-data-loader', () => {\n *   const pending = ref(true);\n *   useOnConnected(async () => {\n *     await fetchData();\n *     pending.value = false;\n *   });\n *   return html`\n *     <cer-suspense pending=\"${pending.value}\">\n *       <my-data-view></my-data-view>\n *       <div slot=\"fallback\">Loading data…</div>\n *     </cer-suspense>\n *   `;\n * });\n * ```\n */\nexport function registerSuspense(): void {\n  if (typeof customElements !== 'undefined' && customElements.get('cer-suspense')) return;\n\n  component('cer-suspense', () => {\n    const { pending } = useProps({ pending: false });\n\n    return pending\n      ? html`<slot name=\"fallback\"><span>Loading…</span></slot>`\n      : html`<slot></slot>`;\n  });\n}\n\n// ── cer-error-boundary ────────────────────────────────────────────────────────\n\n/**\n * A built-in component that catches errors thrown during child component\n * rendering and displays a fallback UI instead of crashing the page.\n *\n * Errors are caught via the `useOnError` lifecycle hook. Once an error is\n * caught the component switches to showing the `fallback` named slot (or a\n * default \"Something went wrong\" message if no fallback slot is provided).\n *\n * Call the custom `reset()` method on the element to clear the error and\n * attempt re-rendering the default slot.\n *\n * @example\n * ```html\n * <cer-error-boundary>\n *   <my-risky-component></my-risky-component>\n *\n *   <div slot=\"fallback\">\n *     <p>Something went wrong. <button onclick=\"this.closest('cer-error-boundary').reset()\">Retry</button></p>\n *   </div>\n * </cer-error-boundary>\n * ```\n */\nexport function registerErrorBoundary(): void {\n  if (typeof customElements !== 'undefined' && customElements.get('cer-error-boundary')) return;\n\n  component('cer-error-boundary', () => {\n    const hasError = ref(false);\n    const errorMessage = ref('');\n\n    useOnError((err: Error) => {\n      hasError.value = true;\n      errorMessage.value = err.message;\n    });\n\n    // Expose a reset() method so parent templates can call\n    // `errorBoundaryRef.value.reset()` to clear the error and retry.\n    // Also expose an internal `_cerHandleChildError` receiver so that the\n    // component runtime can propagate uncaught errors from slotted child\n    // components up to the nearest ancestor <cer-error-boundary>.\n    useExpose({\n      _cerHandleChildError: (err: unknown) => {\n        // Use peek() to read the current value without registering a reactive\n        // dependency — the child component's render context may be active when\n        // this handler runs, and we must not accidentally subscribe the child\n        // to this boundary's internal state.\n        if (!hasError.peek()) {\n          hasError.value = true;\n          errorMessage.value = err instanceof Error ? err.message : String(err);\n        }\n      },\n      reset: () => {\n        hasError.value = false;\n        errorMessage.value = '';\n      },\n    });\n\n    return hasError.value\n      ? html`<slot name=\"fallback\"\n          ><div role=\"alert\">\n            <strong>Something went wrong.</strong>\n            ${errorMessage.value ? html`<p>${errorMessage.value}</p>` : html``}\n          </div></slot\n        >`\n      : html`<slot></slot>`;\n  });\n}\n\n// ── Auto-register all components ─────────────────────────────────────────────\n\n/**\n * Register all built-in components (`cer-suspense`, `cer-error-boundary`,\n * `cer-keep-alive`).\n * Safe to call multiple times — each registration is guarded by a\n * `customElements.get()` check.\n */\nexport function registerBuiltinComponents(): void {\n  registerSuspense();\n  registerErrorBoundary();\n  registerKeepAlive();\n}\n","/**\n * teleport.ts\n *\n * Renders virtual DOM content into an arbitrary DOM target located outside\n * the current component's Shadow Root. Useful for modals, tooltips, popovers,\n * and any UI that must visually escape the component boundary.\n *\n * @example\n * ```ts\n * import { component, html, ref, useOnDisconnected, useTeleport } from '@jasonshimmy/custom-elements-runtime';\n *\n * component('modal-trigger', () => {\n *   const isOpen = ref(false);\n *\n *   // Render modal content into <body> outside the shadow root\n *   const { portal, destroy } = useTeleport('#modal-root');\n *   useOnDisconnected(destroy);\n *\n *   // Call portal() to update the teleported content on each render\n *   if (isOpen.value) {\n *     portal(html`<div class=\"modal\">\n *       <h2>Hello</h2>\n *       <button @click=\"${() => (isOpen.value = false)}\">Close</button>\n *     </div>`);\n *   } else {\n *     portal(null);\n *   }\n *\n *   return html`\n *     <button @click=\"${() => (isOpen.value = true)}\">Open modal</button>\n *   `;\n * });\n * ```\n */\n\nimport type { VNode, VDomRefs } from './runtime/types';\nimport { vdomRenderer } from './runtime/vdom';\nimport { reactiveSystem } from './runtime/reactive';\nimport { getCurrentComponentContext, isDiscoveryRender } from './runtime/hooks';\n\n/** Handle returned by {@link useTeleport} for managing a portal. */\nexport interface TeleportHandle {\n  /**\n   * Render (or clear) content at the teleport target.\n   * Pass `null` or `undefined` to remove previously rendered content.\n   */\n  portal(content: VNode | VNode[] | null | undefined): void;\n\n  /**\n   * Destroy the teleport container and clean up all rendered content.\n   * Call this in `useOnDisconnected` to prevent memory leaks.\n   */\n  destroy(): void;\n}\n\n/**\n * Create a teleport portal that renders content outside the current Shadow Root.\n *\n * @param target - A CSS selector string or an `Element` reference to render into.\n * @returns A {@link TeleportHandle} with `portal()` (update content) and `destroy()` (cleanup).\n *\n * @example\n * ```ts\n * import { component, html, useOnDisconnected, useTeleport } from '@jasonshimmy/custom-elements-runtime';\n *\n * component('my-tooltip', () => {\n *   const { portal, destroy } = useTeleport('body');\n *   useOnDisconnected(destroy);\n *\n *   portal(html`<div class=\"tooltip\">Tooltip content</div>`);\n *   return html`<span>Hover me</span>`;\n * });\n * ```\n */\nexport function useTeleport(target: string | Element): TeleportHandle {\n  // SSR guard\n  if (typeof document === 'undefined') {\n    return { portal: () => {}, destroy: () => {} };\n  }\n\n  // During discovery render the component is not yet mounted — return a no-op\n  // handle so the library can detect props/hooks without side-effects.\n  if (isDiscoveryRender()) {\n    return { portal: () => {}, destroy: () => {} };\n  }\n\n  // If called inside a component render, use the reactive state-index slot\n  // mechanism to ensure the same handle is returned on every re-render of the\n  // same component instance.  Without this, each re-render would create a new\n  // <cer-teleport> container in the target, leaking all but the last one.\n  const ctx = getCurrentComponentContext();\n  if (ctx) {\n    // getOrCreateState uses an incrementing stateIndex that is reset to 0 at\n    // the start of each render, so the same call site always gets the same slot.\n    const slot = reactiveSystem.getOrCreateState<TeleportHandle | null>(null);\n    const existing = slot.peek();\n    if (existing !== null) {\n      return existing;\n    }\n    // First render: create the handle and store it without triggering a\n    // reactive update (initSilent bypasses triggerUpdate).\n    // Pass a slot-invalidation callback so that destroy() clears the slot,\n    // allowing a reconnected component to create a fresh container.\n    const handle = _createTeleportHandle(target, () => slot.initSilent(null));\n    slot.initSilent(handle);\n    return handle;\n  }\n\n  // Outside a component context (e.g. called directly in tests or scripts):\n  // fall through to a non-cached, non-stable handle.\n  return _createTeleportHandle(target);\n}\n\n/** Internal: create a fresh teleport handle pointing at `target`.\n * @param onDestroy - Optional callback invoked after cleanup in destroy(), used\n *   to invalidate a cached slot so the next render creates a fresh handle.\n */\nfunction _createTeleportHandle(\n  target: string | Element,\n  onDestroy?: () => void,\n): TeleportHandle {\n  const targetEl =\n    typeof target === 'string'\n      ? (document.querySelector(target) as Element | null)\n      : target;\n\n  if (!targetEl) {\n    console.warn(\n      `[useTeleport] Target \"${String(target)}\" not found in the document. ` +\n        'Teleported content will not be rendered.',\n    );\n    return { portal: () => {}, destroy: () => {} };\n  }\n\n  // Create a dedicated container so we never clobber sibling content.\n  const container = document.createElement('cer-teleport');\n  container.dataset.cerTeleport = '';\n  targetEl.appendChild(container);\n\n  // Shared refs bag — passed consistently so ref directives work across updates.\n  const refs: VDomRefs = {};\n\n  const handle: TeleportHandle = {\n    portal(content: VNode | VNode[] | null | undefined): void {\n      const nodes: VNode[] =\n        content == null ? [] : Array.isArray(content) ? content : [content];\n      // vdomRenderer stores _prevVNode/_prevDom on the root object for diffing.\n      // Casting to ShadowRoot is safe: we only access properties that exist on\n      // HTMLElement (firstChild, appendChild, replaceChild, childNodes).\n      vdomRenderer(container as unknown as ShadowRoot, nodes, undefined, refs);\n    },\n\n    destroy(): void {\n      // Render empty nodes to clean up event listeners and refs.\n      try {\n        vdomRenderer(container as unknown as ShadowRoot, [], undefined, refs);\n      } catch {\n        /* best-effort cleanup */\n      }\n      if (container.parentNode) {\n        container.parentNode.removeChild(container);\n      }\n      // Invalidate the cached slot so that if the component reconnects and\n      // re-renders, useTeleport() creates a fresh container rather than\n      // reusing this destroyed one.\n      onDestroy?.();\n    },\n  };\n\n  return handle;\n}\n"],"mappings":";;;;AAiCA,SAAgB,GAAW,IAA2B,UAAgB;AACpE,EAAI,OAAO,cAAgB,QAEzB,aAAgB,WAAW,EAAK,kBAAmB,GAC9C,cACL,IAAI,YAAY,eAAe;AAAA,IAAE,SAAS;AAAA,IAAM,UAAU;AAAA,GAAM,CAAC;;ACOrE,IAAM,IAAmB,KACnB,IAAiB;AAEvB,SAAS,EACP,GACA,GACA,GACoC;AACpC,SAAI,MAAe,oBACb,IAAQ,IAAY,MAAY,aAChC,IAAQ,IAAkB,YACvB,YAEL,IAAQ,IAAY,IAAU,aAC9B,IAAQ,IAAkB,YACvB;;AAGT,SAAS,EAAqB,GAAiD;AAC7E,QAAM,IAAgB,CAAA;AACtB,SAAI,EAAQ,aAAa,WAAW,aAClC,EAAI,KACF,8EAAA,GAEA,EAAQ,mBAAmB,WAAW,aACxC,EAAI,KACF,+EAAA,GAEA,EAAQ,iBAAiB,WAAW,aACtC,EAAI,KACF,0EAAA,GAEA,EAAQ,oBAAoB,WAAW,aACzC,EAAI,KACF,gFAAA,GAEA,EAAQ,sBAAsB,WAAW,aAC3C,EAAI,KACF,0EAAA,GAEA,EAAQ,qBAAqB,WAAW,aAC1C,EAAI,KACF,yFAAA,GAEG;;AAOT,SAAgB,IAA6C;AAC3D,QAAM,IAAa,oBAAI,IAAA,GACjB,IAAY,oBAAI,IAAA;AACtB,MAAI,IAAoD;AAExD,WAAS,EAAU,GAAc,GAAe,GAAyB;AACvE,IAAA,EAAW,IAAI,GAAM;AAAA,MACnB,MAAA;AAAA,MACA,OAAA;AAAA,MACA,WAAA;AAAA,MACA,QAAQ;AAAA,MACR,aAAa,KAAK,IAAA;AAAA,MAClB,SAAS,CAAA;AAAA,KACV;AAAA;AAGH,WAAS,IAA0B;AACjC,IAAA,EAAU,oBAAoB,GAAG,GAAA,GACjC,EAAU,uBAAuB,GAAG,EAAA,GACpC,EAAU,sBAAsB,GAAG,GAAA,GACnC,EAAU,eAAe,GAAG,KAAK,OAAO,IAAA,GACxC,EAAU,oBAAoB,GAAG,OAAO,IAAA,GACxC,EAAU,qBAAqB,GAAG,EAAA,GAClC,EAAU,mBAAmB,GAAG,EAAA,GAChC,EAAU,mBAAmB,KAAK,EAAA,GAClC,EAAU,wBAAwB,GAAG,GAAA,GACrC,EAAU,qBAAqB,GAAG,GAAA,GAClC,EAAU,uBAAuB,GAAG,GAAA;AAAA;AAGtC,WAAS,EAAa,GAAc,GAAqB;AACvD,UAAM,IAAS,EAAW,IAAI,CAAA;AAC9B,IAAK,MACL,EAAO,QAAQ,GACf,EAAO,cAAc,KAAK,IAAA,GAC1B,EAAO,QAAQ,KAAK,CAAA,GAChB,EAAO,QAAQ,SAAS,KAAkB,EAAO,QAAQ,MAAA,GAC7D,EAAO,SAAS,EAAW,GAAO,EAAO,WAAW,CAAA;AAAA;AAGtD,WAAS,IAAgC;AACvC,UAAM,IAAyC,CAAA;AAC/C,QAAI,IAA8C;AAClD,eAAW,CAAC,GAAM,CAAA,KAAW;AAC3B,MAAA,EAAS,CAAA,IAAQ,EAAE,GAAG,EAAA,GAClB,EAAO,WAAW,aAAY,IAAU,aACnC,EAAO,WAAW,aAAa,MAAY,cAClD,IAAU;AAEd,WAAO;AAAA,MACL,SAAA;AAAA,MACA,SAAS;AAAA,MACT,WAAW,KAAK,IAAA;AAAA,MAChB,iBAAiB,EAAqB,CAAA;AAAA;;AAI1C,WAAS,IAA4B;AACnC,QACE,YAAY,eACX,YAAwC,QACzC;AACA,YAAM,IAAO,YAAwC;AAGrD,MAAA,EAAa,eAAe,EAAI,cAAA;AAChC,YAAM,IAAI,EAAW,IAAI,aAAA;AACzB,UAAI,KAAK,EAAE,QAAQ,SAAS,GAAG;AAC7B,cAAM,IAAO,EAAE,QAAQ,EAAE,QAAQ,SAAS,CAAA,GACpC,IAAO,EAAE,QAAQ,EAAE,QAAQ,SAAS,CAAA;AAC1C,QAAA,EAAa,oBAAoB,KAAK,IAAI,GAAG,IAAO,CAAA,CAAK;AAAA;;;AAK/D,WAAS,EAAgB,GAA4B;AACnD,eAAW,KAAY,EACrB,KAAI;AACF,MAAA,EAAS,CAAA;AAAA,aACF,GAAG;AACV,MAAA,EAAS,qCAAqC,CAAA;AAAA;;AAKpD,WAAS,IAA2B;AAClC,IAAA,EAAA;AACA,UAAM,IAAS,EAAA;AACf,IAAA,EAAgB,CAAA,GACZ,EAAO,YAAY,aACrB,EACE,+CACA,EAAO,eAAA,IAEF,EAAO,YAAY,aAC1B,EACE,2CACA,EAAO,eAAA;AAAA;AAIb,WAAS,IAAwB;AAC/B,IAAI,OAAO,SAAW,QACtB,IAAa,YAAY,GAAoB,CAAA;AAAA;AAG/C,WAAS,IAAa;AACpB,IAAI,MAAe,SACjB,cAAc,CAAA,GACd,IAAa;AAAA;AAIjB,WAAS,EAAY,GAAgD;AACnE,IAAA,EAAU,IAAI,CAAA;AAAA;AAEhB,WAAS,EAAe,GAAgD;AACtE,IAAA,EAAU,OAAO,CAAA;AAAA;AAEnB,WAAS,EAAiB,GAAwB;AAChD,UAAM,IAAI,EAAW,IAAI,CAAA;AACzB,WAAO,IAAI,CAAC,GAAG,EAAE,OAAA,IAAW,CAAA;AAAA;AAE9B,WAAS,IAAqB;AAC5B,eAAW,KAAK,EAAW,OAAA,EAAU,CAAA,EAAE,UAAU,CAAA;AAAA;AAGnD,SAAA,EAAA,GACA,EAAA,GAEO;AAAA,IACL,cAAA;AAAA,IACA,iBAAA;AAAA,IACA,aAAA;AAAA,IACA,gBAAA;AAAA,IACA,MAAA;AAAA,IACA,kBAAA;AAAA,IACA,cAAA;AAAA;;AAKJ,IAAI,IAAyC;AAK7C,SAAgB,IAA0C;AACxD,SAAK,MAAU,IAAW,EAAA,IACnB;;AAMT,SAAgB,GAAmB,GAAc,GAAqB;AACpE,EAAA,EAAA,EAAmB,aAAa,GAAM,CAAA;;AAMxC,SAAgB,KAAgC;AAC9C,SAAO,EAAA,EAAmB,gBAAA;;AC9M5B,SAAgB,IAA0B;AACxC,EACE,OAAO,SAAW,OAClB,OAAO,iBAAmB,OAC1B,eAAe,IAAI,gBAAA,KAKrB,eAAe,OAAO,kBAAkB,EAAA,CAAsB;;AAGhE,SAAS,IAAiD;AACxD,SAAO,cAA2B,YAAY;AAAA,IAE5C,SAAiB,oBAAI,IAAA;AAAA,IACrB,QAAwC;AAAA,IACxC,gBAA6C;AAAA,IAE7C,oBAA0B;AACxB,MAAK,KAAK,cACR,KAAK,aAAa,EAAE,MAAM,OAAA,CAAQ,GAG/B,KAAK,WAAY,cAAc,MAAA,MAClC,KAAK,WAAY,YAAY,kBAG/B,KAAK,QAAQ,KAAK,WAAY,cAAc,MAAA,GACxC,KAAK,UACP,KAAK,gBAAA,MAAsB,KAAK,kBAAA,GAChC,KAAK,MAAM,iBAAiB,cAAc,KAAK,aAAA,GAE/C,KAAK,kBAAA;AAAA;IAIT,uBAA6B;AAC3B,MAAI,KAAK,SAAS,KAAK,iBACrB,KAAK,MAAM,oBAAoB,cAAc,KAAK,aAAA,GAEpD,KAAK,gBAAgB;AAAA;IAOvB,WAAW,GAAsB;AAC/B,MAAI,IACF,KAAK,OAAO,OAAO,CAAA,IAEnB,KAAK,OAAO,MAAA;AAAA;IAIhB,oBAAkC;AAChC,UAAI,CAAC,KAAK,MAAO;AAEjB,YAAM,IAAkB,KAAK,MAAM,iBAAiB,EAAE,SAAS,GAAA,CAAM;AAErE,iBAAW,KAAS,GAAiB;AACnC,cAAM,IAAW,KAAK,eAAe,CAAA;AAErC,YAAI,CAAC,KAAK,OAAO,IAAI,CAAA,EAEnB,MAAK,OAAO,IAAI,GAAU,CAAA;AAAA,aACrB;AACL,gBAAM,IAAS,KAAK,OAAO,IAAI,CAAA;AAC/B,cAAI,MAAW,EAGb,KAAI;AACF,YAAA,EAAM,YAAY,aAAa,GAAQ,CAAA;AAAA,kBACjC;AAEN,iBAAK,OAAO,IAAI,GAAU,CAAA;AAAA;;;;IAOpC,eAAuB,GAAuB;AAC5C,YAAM,IAAM,EAAG,QAAQ,YAAA,GACjB,IAAK,EAAG,aAAa,IAAA;AAC3B,aAAO,IAAK,GAAG,CAAA,IAAO,CAAA,KAAO;AAAA;;;ACnFnC,SAAgB,IAAyB;AACvC,EAAI,OAAO,iBAAmB,OAAe,eAAe,IAAI,cAAA,KAEhE,EAAU,gBAAA,MAAsB;AAC9B,UAAM,EAAE,SAAA,EAAA,IAAY,EAAS,EAAE,SAAS,GAAA,CAAO;AAE/C,WAAO,IACH,wDACA;AAAA;;AA4BR,SAAgB,IAA8B;AAC5C,EAAI,OAAO,iBAAmB,OAAe,eAAe,IAAI,oBAAA,KAEhE,EAAU,sBAAA,MAA4B;AACpC,UAAM,IAAW,EAAI,EAAA,GACf,IAAe,EAAI,EAAA;AAEzB,WAAA,EAAA,CAAY,MAAe;AACzB,MAAA,EAAS,QAAQ,IACjB,EAAa,QAAQ,EAAI;AAAA,QAQ3B,EAAU;AAAA,MACR,sBAAA,CAAuB,MAAiB;AAKtC,QAAK,EAAS,KAAA,MACZ,EAAS,QAAQ,IACjB,EAAa,QAAQ,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAA;AAAA;MAGrE,OAAA,MAAa;AACX,QAAA,EAAS,QAAQ,IACjB,EAAa,QAAQ;AAAA;KAExB,GAEM,EAAS,QACZ;AAAA;AAAA;AAAA,cAGM,EAAa,QAAQ,OAAU,EAAa,KAAA,SAAc,GAAI;AAAA;AAAA,aAGpE;AAAA;;AAYR,SAAgB,KAAkC;AAChD,EAAA,EAAA,GACA,EAAA,GACA,EAAA;;AC1EF,SAAgB,GAAY,GAA0C;AAEpE,MAAI,OAAO,WAAa,IACtB,QAAO;AAAA,IAAE,QAAA,MAAc;AAAA,IAAA;AAAA,IAAI,SAAA,MAAe;AAAA,IAAA;AAAA;AAK5C,MAAI,EAAA,EACF,QAAO;AAAA,IAAE,QAAA,MAAc;AAAA,IAAA;AAAA,IAAI,SAAA,MAAe;AAAA,IAAA;AAAA;AAQ5C,MADY,EAAA,GACH;AAGP,UAAM,IAAO,EAAe,iBAAwC,IAAA,GAC9D,IAAW,EAAK,KAAA;AACtB,QAAI,MAAa,KACf,QAAO;AAMT,UAAM,IAAS,EAAsB,GAAA,MAAc,EAAK,WAAW,IAAA,CAAK;AACxE,WAAA,EAAK,WAAW,CAAA,GACT;AAAA;AAKT,SAAO,EAAsB,CAAA;;AAO/B,SAAS,EACP,GACA,GACgB;AAChB,QAAM,IACJ,OAAO,KAAW,WACb,SAAS,cAAc,CAAA,IACxB;AAEN,MAAI,CAAC;AACH,mBAAQ,KACN,yBAAyB,OAAO,CAAA,CAAO,uEAAC,GAGnC;AAAA,MAAE,QAAA,MAAc;AAAA,MAAA;AAAA,MAAI,SAAA,MAAe;AAAA,MAAA;AAAA;AAI5C,QAAM,IAAY,SAAS,cAAc,cAAA;AACzC,EAAA,EAAU,QAAQ,cAAc,IAChC,EAAS,YAAY,CAAA;AAGrB,QAAM,IAAiB,CAAA;AA6BvB,SA3B+B;AAAA,IAC7B,OAAO,GAAmD;AAMxD,MAAA,EAAa,GAJX,KAAW,OAAO,CAAA,IAAK,MAAM,QAAQ,CAAA,IAAW,IAAU,CAAC,CAAA,GAIL,QAAW,CAAA;AAAA;IAGrE,UAAgB;AAEd,UAAI;AACF,QAAA,EAAa,GAAoC,CAAA,GAAI,QAAW,CAAA;AAAA,cAC1D;AAAA,MAAA;AAGR,MAAI,EAAU,cACZ,EAAU,WAAW,YAAY,CAAA,GAKnC,IAAA;AAAA"}
+{"version":3,"file":"custom-elements-runtime.es.js","names":[],"sources":["../src/lib/runtime/hydration.ts","../src/lib/runtime/monitoring/health-monitor.ts","../src/lib/keep-alive.ts","../src/lib/runtime/builtin-components.ts","../src/lib/teleport.ts"],"sourcesContent":["/**\n * Client-side hydration helpers.\n *\n * When the server renders with `dsd: true`, each custom element's shadow DOM\n * is already present in the HTML via a Declarative Shadow DOM template. The\n * browser parses that template and attaches the shadow root before any\n * JavaScript runs. When the JS bundle loads, the custom element constructors\n * detect the existing shadow root and skip the `attachShadow()` call, then\n * hydrate (attach reactivity to) the existing DOM on `connectedCallback`.\n *\n * `hydrateApp` is a signal/entry point for this process. In most cases custom\n * elements self-hydrate automatically on connection — this function is useful\n * when you need to explicitly trigger or defer the hydration of a subtree.\n */\n\n/**\n * Trigger hydration for all registered custom elements within `root`.\n *\n * In practice, custom elements self-hydrate as soon as their class definition\n * is registered and the element is connected to the DOM. Call `hydrateApp`\n * after importing and calling `component()` for all your components to signal\n * that the page is ready for reactive activation.\n *\n * @param root - The root element to hydrate. Defaults to `document`.\n *\n * @example\n * ```ts\n * import { component, hydrateApp } from '@jasonshimmy/custom-elements-runtime';\n * import './components'; // registers all components via component()\n *\n * hydrateApp(); // activate all DSD-rendered components on the page\n * ```\n */\nexport function hydrateApp(root: Element | Document = document): void {\n  if (typeof CustomEvent === 'undefined') return;\n  const target =\n    root instanceof Document ? root.documentElement : (root as Element);\n  target.dispatchEvent(\n    new CustomEvent('cer:hydrate', { bubbles: true, composed: true }),\n  );\n}\n","/**\n * Runtime Health Monitoring System\n * Tracks framework health metrics and provides early warning for potential issues\n */\n\nimport { devWarn, devError } from '../logger';\n\ninterface HealthMetric {\n  name: string;\n  value: number;\n  threshold: number;\n  status: 'healthy' | 'warning' | 'critical';\n  lastUpdated: number;\n  history: number[];\n}\n\ninterface HealthReport {\n  overall: 'healthy' | 'warning' | 'critical';\n  metrics: Record<string, HealthMetric>;\n  timestamp: number;\n  recommendations: string[];\n}\nexport type { HealthReport };\n\n/**\n * Public interface for a health monitor instance.\n * All state is managed internally via closures — no class syntax.\n */\nexport interface HealthMonitorInstance {\n  /** Update a specific health metric value */\n  updateMetric(name: string, value: number): void;\n  /** Get the current health report */\n  getHealthReport(): HealthReport;\n  /** Add a listener to be notified when a health check runs */\n  addListener(listener: (report: HealthReport) => void): void;\n  /** Remove a previously registered listener */\n  removeListener(listener: (report: HealthReport) => void): void;\n  /** Stop the periodic health monitoring timer */\n  stop(): void;\n  /** Get historical values for a specific metric */\n  getMetricHistory(name: string): number[];\n  /** Clear all metric history */\n  clearHistory(): void;\n}\n\nconst MAX_HISTORY_SIZE = 100;\nconst CHECK_INTERVAL = 30_000; // 30 seconds\n\nfunction calcStatus(\n  value: number,\n  threshold: number,\n  metricName: string,\n): 'healthy' | 'warning' | 'critical' {\n  if (metricName === 'jitCacheHitRate') {\n    if (value < threshold * 0.5) return 'critical';\n    if (value < threshold) return 'warning';\n    return 'healthy';\n  }\n  if (value > threshold * 2) return 'critical';\n  if (value > threshold) return 'warning';\n  return 'healthy';\n}\n\nfunction buildRecommendations(metrics: Record<string, HealthMetric>): string[] {\n  const out: string[] = [];\n  if (metrics.memoryUsage?.status !== 'healthy')\n    out.push(\n      'Consider reducing component complexity or implementing better memory cleanup',\n    );\n  if (metrics.averageRenderTime?.status !== 'healthy')\n    out.push(\n      'Optimize component render functions - consider lazy loading or virtualization',\n    );\n  if (metrics.jitCacheHitRate?.status !== 'healthy')\n    out.push(\n      'JIT CSS cache performance is poor - review CSS patterns for optimization',\n    );\n  if (metrics.componentErrorRate?.status !== 'healthy')\n    out.push(\n      'High component error rate detected - review error handling and component logic',\n    );\n  if (metrics.activeReactiveStates?.status !== 'healthy')\n    out.push(\n      'High number of reactive states - consider state consolidation or cleanup',\n    );\n  if (metrics.memoryLeakIndicator?.status !== 'healthy')\n    out.push(\n      'Potential memory leak detected - review component cleanup and event listener management',\n    );\n  return out;\n}\n\n/**\n * Create a new health monitor instance.\n * All mutable state lives in closures — no `class` or `this`.\n */\nexport function createHealthMonitor(): HealthMonitorInstance {\n  const metricsMap = new Map<string, HealthMetric>();\n  const listeners = new Set<(report: HealthReport) => void>();\n  let intervalId: ReturnType<typeof setInterval> | null = null;\n\n  function addMetric(name: string, value: number, threshold: number): void {\n    metricsMap.set(name, {\n      name,\n      value,\n      threshold,\n      status: 'healthy',\n      lastUpdated: Date.now(),\n      history: [],\n    });\n  }\n\n  function initializeMetrics(): void {\n    addMetric('activeComponents', 0, 1000);\n    addMetric('componentCreateRate', 0, 50);\n    addMetric('componentErrorRate', 0, 0.1);\n    addMetric('memoryUsage', 0, 50 * 1024 * 1024);\n    addMetric('memoryGrowthRate', 0, 1024 * 1024);\n    addMetric('averageRenderTime', 0, 16);\n    addMetric('slowRenderCount', 0, 10);\n    addMetric('jitCacheHitRate', 100, 80);\n    addMetric('activeReactiveStates', 0, 5000);\n    addMetric('dependencyUpdates', 0, 100);\n    addMetric('memoryLeakIndicator', 0, 0.1);\n  }\n\n  function updateMetric(name: string, value: number): void {\n    const metric = metricsMap.get(name);\n    if (!metric) return;\n    metric.value = value;\n    metric.lastUpdated = Date.now();\n    metric.history.push(value);\n    if (metric.history.length > MAX_HISTORY_SIZE) metric.history.shift();\n    metric.status = calcStatus(value, metric.threshold, name);\n  }\n\n  function getHealthReport(): HealthReport {\n    const snapshot: Record<string, HealthMetric> = {};\n    let overall: 'healthy' | 'warning' | 'critical' = 'healthy';\n    for (const [name, metric] of metricsMap) {\n      snapshot[name] = { ...metric };\n      if (metric.status === 'critical') overall = 'critical';\n      else if (metric.status === 'warning' && overall === 'healthy')\n        overall = 'warning';\n    }\n    return {\n      overall,\n      metrics: snapshot,\n      timestamp: Date.now(),\n      recommendations: buildRecommendations(snapshot),\n    };\n  }\n\n  function updateMemoryMetrics(): void {\n    if (\n      'memory' in performance &&\n      (performance as Record<string, unknown>).memory\n    ) {\n      const mem = (performance as Record<string, unknown>).memory as {\n        usedJSHeapSize: number;\n      };\n      updateMetric('memoryUsage', mem.usedJSHeapSize);\n      const m = metricsMap.get('memoryUsage');\n      if (m && m.history.length > 1) {\n        const prev = m.history[m.history.length - 2];\n        const curr = m.history[m.history.length - 1];\n        updateMetric('memoryGrowthRate', Math.max(0, curr - prev));\n      }\n    }\n  }\n\n  function notifyListeners(report: HealthReport): void {\n    for (const listener of listeners) {\n      try {\n        listener(report);\n      } catch (e) {\n        devError('Error in health monitor listener:', e);\n      }\n    }\n  }\n\n  function performHealthCheck(): void {\n    updateMemoryMetrics();\n    const report = getHealthReport();\n    notifyListeners(report);\n    if (report.overall === 'critical')\n      devError(\n        '🚨 Runtime Health: Critical issues detected',\n        report.recommendations,\n      );\n    else if (report.overall === 'warning')\n      devWarn(\n        '⚠️ Runtime Health: Performance warnings',\n        report.recommendations,\n      );\n  }\n\n  function startMonitoring(): void {\n    if (typeof window === 'undefined') return;\n    intervalId = setInterval(performHealthCheck, CHECK_INTERVAL);\n  }\n\n  function stop(): void {\n    if (intervalId !== null) {\n      clearInterval(intervalId);\n      intervalId = null;\n    }\n  }\n\n  function addListener(listener: (report: HealthReport) => void): void {\n    listeners.add(listener);\n  }\n  function removeListener(listener: (report: HealthReport) => void): void {\n    listeners.delete(listener);\n  }\n  function getMetricHistory(name: string): number[] {\n    const m = metricsMap.get(name);\n    return m ? [...m.history] : [];\n  }\n  function clearHistory(): void {\n    for (const m of metricsMap.values()) m.history = [];\n  }\n\n  initializeMetrics();\n  startMonitoring();\n\n  return {\n    updateMetric,\n    getHealthReport,\n    addListener,\n    removeListener,\n    stop,\n    getMetricHistory,\n    clearHistory,\n  };\n}\n\n// Global singleton\nlet _monitor: HealthMonitorInstance | null = null;\n\n/**\n * Get the global health monitor singleton instance.\n */\nexport function getHealthMonitor(): HealthMonitorInstance {\n  if (!_monitor) _monitor = createHealthMonitor();\n  return _monitor;\n}\n\n/**\n * Update a health metric from anywhere in the framework.\n */\nexport function updateHealthMetric(name: string, value: number): void {\n  getHealthMonitor().updateMetric(name, value);\n}\n\n/**\n * Get the current health status report.\n */\nexport function getHealthStatus(): HealthReport {\n  return getHealthMonitor().getHealthReport();\n}\n","/**\n * keep-alive.ts\n *\n * Preserves component state when a component is removed from and later\n * re-inserted into the DOM. By default, custom elements lose all JavaScript\n * state when `disconnectedCallback` fires. `cer-keep-alive` intercepts\n * that lifecycle and keeps the child element alive in memory, re-attaching\n * it when a matching component is re-inserted.\n *\n * ## Usage\n *\n * Wrap any custom element with `<cer-keep-alive>`:\n * ```html\n * <cer-keep-alive>\n *   <my-counter></my-counter>\n * </cer-keep-alive>\n * ```\n *\n * Or register it programmatically:\n * ```ts\n * import { registerKeepAlive } from '@jasonshimmy/custom-elements-runtime';\n * registerKeepAlive(); // registers <cer-keep-alive> globally\n * ```\n *\n * ## How it works\n *\n * `cer-keep-alive` uses a slotted layout. When a slotted child component is\n * about to leave the DOM (via a re-render of a parent), KeepAlive intercepts\n * `slotchange` events and preserves the detached child element in an internal\n * cache keyed by tag name. When the same tag re-appears in the slot, the\n * cached element is re-inserted, restoring all JavaScript state.\n *\n * ## Limitations\n *\n * - The first slot child per tag name is cached. Multiple children with the\n *   same tag use separate cache entries keyed by their `id` attribute.\n * - Only components registered with the same tag name are matched.\n * - Cache entries can be manually evicted with `clearCache()`.\n */\n\n/** Cache key = tagName[:id] */\ntype CacheKey = string;\n\n/**\n * Register the `<cer-keep-alive>` custom element.\n * Safe to call multiple times — subsequent calls are no-ops.\n *\n * @example\n * ```ts\n * import { registerKeepAlive } from '@jasonshimmy/custom-elements-runtime';\n * registerKeepAlive();\n * ```\n */\nexport function registerKeepAlive(): void {\n  if (\n    typeof window === 'undefined' ||\n    typeof customElements === 'undefined' ||\n    customElements.get('cer-keep-alive')\n  ) {\n    return;\n  }\n\n  customElements.define('cer-keep-alive', createKeepAliveClass());\n}\n\nfunction createKeepAliveClass(): CustomElementConstructor {\n  return class CerKeepAlive extends HTMLElement {\n    /** Preserved component instances keyed by tag[:id]. */\n    private _cache = new Map<CacheKey, Element>();\n    private _slot: HTMLSlotElement | null = null;\n    private _slotListener: (() => void) | null = null;\n\n    connectedCallback(): void {\n      if (!this.shadowRoot) {\n        this.attachShadow({ mode: 'open' });\n      }\n\n      if (!this.shadowRoot!.querySelector('slot')) {\n        this.shadowRoot!.innerHTML = '<slot></slot>';\n      }\n\n      this._slot = this.shadowRoot!.querySelector('slot');\n      if (this._slot) {\n        this._slotListener = () => this._handleSlotChange();\n        this._slot.addEventListener('slotchange', this._slotListener);\n        // Process current slotted content\n        this._handleSlotChange();\n      }\n    }\n\n    disconnectedCallback(): void {\n      if (this._slot && this._slotListener) {\n        this._slot.removeEventListener('slotchange', this._slotListener);\n      }\n      this._slotListener = null;\n    }\n\n    /**\n     * Evict a cached element by its cache key (`tagName` or `tagName:id`).\n     * The evicted element is disconnected and removed from the cache.\n     */\n    clearCache(key?: CacheKey): void {\n      if (key) {\n        this._cache.delete(key);\n      } else {\n        this._cache.clear();\n      }\n    }\n\n    private _handleSlotChange(): void {\n      if (!this._slot) return;\n\n      const slottedElements = this._slot.assignedElements({ flatten: true });\n\n      for (const child of slottedElements) {\n        const cacheKey = this._buildCacheKey(child);\n\n        if (!this._cache.has(cacheKey)) {\n          // New element — cache it so we can restore it later\n          this._cache.set(cacheKey, child);\n        } else {\n          const cached = this._cache.get(cacheKey)!;\n          if (cached !== child) {\n            // A different instance appeared for the same slot.\n            // Replace it with the cached instance to restore state.\n            try {\n              child.parentNode?.replaceChild(cached, child);\n            } catch {\n              // If replacement fails, update the cache with the new element\n              this._cache.set(cacheKey, child);\n            }\n          }\n        }\n      }\n    }\n\n    private _buildCacheKey(el: Element): CacheKey {\n      const tag = el.tagName.toLowerCase();\n      const id = el.getAttribute('id');\n      return id ? `${tag}:${id}` : tag;\n    }\n  };\n}\n","/**\n * Built-in utility components provided by the custom-elements runtime.\n *\n * These components are registered automatically when this module is imported.\n * They are designed to be minimal, tree-shakeable, and zero-dependency.\n *\n * Included components:\n * - `<cer-suspense>` — Shows a fallback while async work is pending\n * - `<cer-error-boundary>` — Catches render errors and shows a fallback UI\n * - `<cer-keep-alive>` — Preserves component state across DOM removal/re-insertion\n */\n\nimport { component } from './component';\nimport { html } from './template-compiler';\nimport { ref } from './reactive';\nimport { useProps, useOnError, useExpose } from './hooks';\nimport { registerKeepAlive } from '../keep-alive';\n\n// ── cer-suspense ──────────────────────────────────────────────────────────────\n\n/**\n * A built-in component that conditionally renders either the default slot\n * content or the `fallback` slot content, controlled by the `pending` prop.\n *\n * Use the `pending` attribute/property to signal that async work is in\n * progress; the component will swap to the `fallback` slot until `pending`\n * becomes falsy.\n *\n * @example\n * ```html\n * <cer-suspense pending>\n *   <!-- shown when pending=false -->\n *   <my-async-content></my-async-content>\n *\n *   <!-- shown while pending=true -->\n *   <div slot=\"fallback\">Loading…</div>\n * </cer-suspense>\n * ```\n *\n * @example Programmatic usage\n * ```ts\n * component('my-data-loader', () => {\n *   const pending = ref(true);\n *   useOnConnected(async () => {\n *     await fetchData();\n *     pending.value = false;\n *   });\n *   return html`\n *     <cer-suspense pending=\"${pending.value}\">\n *       <my-data-view></my-data-view>\n *       <div slot=\"fallback\">Loading data…</div>\n *     </cer-suspense>\n *   `;\n * });\n * ```\n */\nexport function registerSuspense(): void {\n  if (typeof customElements !== 'undefined' && customElements.get('cer-suspense')) return;\n\n  component('cer-suspense', () => {\n    const { pending } = useProps({ pending: false });\n\n    return pending\n      ? html`<slot name=\"fallback\"><span>Loading…</span></slot>`\n      : html`<slot></slot>`;\n  });\n}\n\n// ── cer-error-boundary ────────────────────────────────────────────────────────\n\n/**\n * A built-in component that catches errors thrown during child component\n * rendering and displays a fallback UI instead of crashing the page.\n *\n * Errors are caught via the `useOnError` lifecycle hook. Once an error is\n * caught the component switches to showing the `fallback` named slot (or a\n * default \"Something went wrong\" message if no fallback slot is provided).\n *\n * Call the custom `reset()` method on the element to clear the error and\n * attempt re-rendering the default slot.\n *\n * @example\n * ```html\n * <cer-error-boundary>\n *   <my-risky-component></my-risky-component>\n *\n *   <div slot=\"fallback\">\n *     <p>Something went wrong. <button onclick=\"this.closest('cer-error-boundary').reset()\">Retry</button></p>\n *   </div>\n * </cer-error-boundary>\n * ```\n */\nexport function registerErrorBoundary(): void {\n  if (typeof customElements !== 'undefined' && customElements.get('cer-error-boundary')) return;\n\n  component('cer-error-boundary', () => {\n    const hasError = ref(false);\n    const errorMessage = ref('');\n\n    useOnError((err: Error) => {\n      hasError.value = true;\n      errorMessage.value = err.message;\n    });\n\n    // Expose a reset() method so parent templates can call\n    // `errorBoundaryRef.value.reset()` to clear the error and retry.\n    // Also expose an internal `_cerHandleChildError` receiver so that the\n    // component runtime can propagate uncaught errors from slotted child\n    // components up to the nearest ancestor <cer-error-boundary>.\n    useExpose({\n      _cerHandleChildError: (err: unknown) => {\n        // Use peek() to read the current value without registering a reactive\n        // dependency — the child component's render context may be active when\n        // this handler runs, and we must not accidentally subscribe the child\n        // to this boundary's internal state.\n        if (!hasError.peek()) {\n          hasError.value = true;\n          errorMessage.value = err instanceof Error ? err.message : String(err);\n        }\n      },\n      reset: () => {\n        hasError.value = false;\n        errorMessage.value = '';\n      },\n    });\n\n    return hasError.value\n      ? html`<slot name=\"fallback\"\n          ><div role=\"alert\">\n            <strong>Something went wrong.</strong>\n            ${errorMessage.value ? html`<p>${errorMessage.value}</p>` : html``}\n          </div></slot\n        >`\n      : html`<slot></slot>`;\n  });\n}\n\n// ── Auto-register all components ─────────────────────────────────────────────\n\n/**\n * Register all built-in components (`cer-suspense`, `cer-error-boundary`,\n * `cer-keep-alive`).\n * Safe to call multiple times — each registration is guarded by a\n * `customElements.get()` check.\n */\nexport function registerBuiltinComponents(): void {\n  registerSuspense();\n  registerErrorBoundary();\n  registerKeepAlive();\n}\n","/**\n * teleport.ts\n *\n * Renders virtual DOM content into an arbitrary DOM target located outside\n * the current component's Shadow Root. Useful for modals, tooltips, popovers,\n * and any UI that must visually escape the component boundary.\n *\n * @example\n * ```ts\n * import { component, html, ref, useOnDisconnected, useTeleport } from '@jasonshimmy/custom-elements-runtime';\n *\n * component('modal-trigger', () => {\n *   const isOpen = ref(false);\n *\n *   // Render modal content into <body> outside the shadow root\n *   const { portal, destroy } = useTeleport('#modal-root');\n *   useOnDisconnected(destroy);\n *\n *   // Call portal() to update the teleported content on each render\n *   if (isOpen.value) {\n *     portal(html`<div class=\"modal\">\n *       <h2>Hello</h2>\n *       <button @click=\"${() => (isOpen.value = false)}\">Close</button>\n *     </div>`);\n *   } else {\n *     portal(null);\n *   }\n *\n *   return html`\n *     <button @click=\"${() => (isOpen.value = true)}\">Open modal</button>\n *   `;\n * });\n * ```\n */\n\nimport type { VNode, VDomRefs } from './runtime/types';\nimport { vdomRenderer } from './runtime/vdom';\nimport { reactiveSystem } from './runtime/reactive';\nimport { getCurrentComponentContext, isDiscoveryRender } from './runtime/hooks';\n\n/** Handle returned by {@link useTeleport} for managing a portal. */\nexport interface TeleportHandle {\n  /**\n   * Render (or clear) content at the teleport target.\n   * Pass `null` or `undefined` to remove previously rendered content.\n   */\n  portal(content: VNode | VNode[] | null | undefined): void;\n\n  /**\n   * Destroy the teleport container and clean up all rendered content.\n   * Call this in `useOnDisconnected` to prevent memory leaks.\n   */\n  destroy(): void;\n}\n\n/**\n * Create a teleport portal that renders content outside the current Shadow Root.\n *\n * @param target - A CSS selector string or an `Element` reference to render into.\n * @returns A {@link TeleportHandle} with `portal()` (update content) and `destroy()` (cleanup).\n *\n * @example\n * ```ts\n * import { component, html, useOnDisconnected, useTeleport } from '@jasonshimmy/custom-elements-runtime';\n *\n * component('my-tooltip', () => {\n *   const { portal, destroy } = useTeleport('body');\n *   useOnDisconnected(destroy);\n *\n *   portal(html`<div class=\"tooltip\">Tooltip content</div>`);\n *   return html`<span>Hover me</span>`;\n * });\n * ```\n */\nexport function useTeleport(target: string | Element): TeleportHandle {\n  // SSR guard\n  if (typeof document === 'undefined') {\n    return { portal: () => {}, destroy: () => {} };\n  }\n\n  // During discovery render the component is not yet mounted — return a no-op\n  // handle so the library can detect props/hooks without side-effects.\n  if (isDiscoveryRender()) {\n    return { portal: () => {}, destroy: () => {} };\n  }\n\n  // If called inside a component render, use the reactive state-index slot\n  // mechanism to ensure the same handle is returned on every re-render of the\n  // same component instance.  Without this, each re-render would create a new\n  // <cer-teleport> container in the target, leaking all but the last one.\n  const ctx = getCurrentComponentContext();\n  if (ctx) {\n    // getOrCreateState uses an incrementing stateIndex that is reset to 0 at\n    // the start of each render, so the same call site always gets the same slot.\n    const slot = reactiveSystem.getOrCreateState<TeleportHandle | null>(null);\n    const existing = slot.peek();\n    if (existing !== null) {\n      return existing;\n    }\n    // First render: create the handle and store it without triggering a\n    // reactive update (initSilent bypasses triggerUpdate).\n    // Pass a slot-invalidation callback so that destroy() clears the slot,\n    // allowing a reconnected component to create a fresh container.\n    const handle = _createTeleportHandle(target, () => slot.initSilent(null));\n    slot.initSilent(handle);\n    return handle;\n  }\n\n  // Outside a component context (e.g. called directly in tests or scripts):\n  // fall through to a non-cached, non-stable handle.\n  return _createTeleportHandle(target);\n}\n\n/** Internal: create a fresh teleport handle pointing at `target`.\n * @param onDestroy - Optional callback invoked after cleanup in destroy(), used\n *   to invalidate a cached slot so the next render creates a fresh handle.\n */\nfunction _createTeleportHandle(\n  target: string | Element,\n  onDestroy?: () => void,\n): TeleportHandle {\n  const targetEl =\n    typeof target === 'string'\n      ? (document.querySelector(target) as Element | null)\n      : target;\n\n  if (!targetEl) {\n    console.warn(\n      `[useTeleport] Target \"${String(target)}\" not found in the document. ` +\n        'Teleported content will not be rendered.',\n    );\n    return { portal: () => {}, destroy: () => {} };\n  }\n\n  // Create a dedicated container so we never clobber sibling content.\n  const container = document.createElement('cer-teleport');\n  container.dataset.cerTeleport = '';\n  targetEl.appendChild(container);\n\n  // Shared refs bag — passed consistently so ref directives work across updates.\n  const refs: VDomRefs = {};\n\n  const handle: TeleportHandle = {\n    portal(content: VNode | VNode[] | null | undefined): void {\n      const nodes: VNode[] =\n        content == null ? [] : Array.isArray(content) ? content : [content];\n      // vdomRenderer stores _prevVNode/_prevDom on the root object for diffing.\n      // Casting to ShadowRoot is safe: we only access properties that exist on\n      // HTMLElement (firstChild, appendChild, replaceChild, childNodes).\n      vdomRenderer(container as unknown as ShadowRoot, nodes, undefined, refs);\n    },\n\n    destroy(): void {\n      // Render empty nodes to clean up event listeners and refs.\n      try {\n        vdomRenderer(container as unknown as ShadowRoot, [], undefined, refs);\n      } catch {\n        /* best-effort cleanup */\n      }\n      if (container.parentNode) {\n        container.parentNode.removeChild(container);\n      }\n      // Invalidate the cached slot so that if the component reconnects and\n      // re-renders, useTeleport() creates a fresh container rather than\n      // reusing this destroyed one.\n      onDestroy?.();\n    },\n  };\n\n  return handle;\n}\n"],"mappings":"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"}

package/dist/custom-elements-runtime.event-bus.cjs.js

@@ -1,3 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./logger-BYIN7ysT.cjs");var l=class o extends EventTarget{handlers={};static instance;eventCounters=new Map;nativeUnsubscribers=new Map;MAX_EVENT_COUNTERS=1e3;static getInstance(){return o.instance||(o.instance=new o),o.instance}emit(e,t){const n=Date.now(),s=this.eventCounters.get(e);if(!s||n-s.window>1e3){if(!s&&this.eventCounters.size>=this.MAX_EVENT_COUNTERS){const c=this.eventCounters.keys().next().value;c!==void 0&&this.eventCounters.delete(c)}this.eventCounters.set(e,{count:1,window:n})}else if(s.count++,s.count===51&&a.devError(`[EventBus] Event "${e}" is firing too frequently (>${s.count-1}/s). Emissions above 50/s are throttled and above 100/s are dropped to prevent event storms. Consider debouncing the emitter.`),s.count>100)return;this.dispatchEvent(new CustomEvent(e,{detail:t,bubbles:!1,cancelable:!0}));const u=this.handlers[e];u&&u.forEach(c=>{try{c(t)}catch(h){a.devError(`Error in global event handler for "${e}":`,h)}})}on(e,t){return this.handlers[e]||(this.handlers[e]=new Set),this.handlers[e].add(t),()=>this.off(e,t)}off(e,t){const n=this.handlers[e];n&&(n.delete(t),n.size===0&&delete this.handlers[e])}offAll(e){delete this.handlers[e]}listen(e,t,n){this.addEventListener(e,t,n);const s=()=>{this.removeEventListener(e,t),this.nativeUnsubscribers.delete(s)};return this.nativeUnsubscribers.set(s,!0),s}once(e,t){if(t!==void 0){const n=this.on(e,s=>{n(),t(s)})}else return new Promise(n=>{const s=this.on(e,u=>{s(),n(u)})})}getActiveEvents(){return Object.keys(this.handlers).filter(e=>this.handlers[e]&&this.handlers[e].size>0)}clear(){this.handlers={};const e=Array.from(this.nativeUnsubscribers.keys());this.nativeUnsubscribers.clear();for(const t of e)t()}getHandlerCount(e){return this.handlers[e]?.size||0}getEventStats(){const e={};for(const[t,n]of this.eventCounters.entries())e[t]={count:n.count,handlersCount:this.getHandlerCount(t)};return e}resetEventCounters(){this.eventCounters.clear()}},i=new Proxy({},{get(r,e){const t=l.getInstance(),n=t[e];return typeof n=="function"?n.bind(t):n},apply(){throw new TypeError("eventBus is not a callable function")}}),d=(r,e)=>i.emit(r,e),f=(r,e)=>i.on(r,e),v=(r,e)=>i.off(r,e);function b(r,e){return e!==void 0?i.once(r,e):i.once(r)}var E=(r,e,t)=>i.listen(r,e,t);exports.GlobalEventBus=l;exports.emit=d;exports.eventBus=i;exports.listen=E;exports.off=v;exports.on=f;exports.once=b;
-
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./logger-Dkht1dCX.cjs`);var t=class t extends EventTarget{handlers={};static instance;eventCounters=new Map;nativeUnsubscribers=new Map;MAX_EVENT_COUNTERS=1e3;static getInstance(){return t.instance||=new t,t.instance}emit(t,n){let r=Date.now(),i=this.eventCounters.get(t);if(!i||r-i.window>1e3){if(!i&&this.eventCounters.size>=this.MAX_EVENT_COUNTERS){let e=this.eventCounters.keys().next().value;e!==void 0&&this.eventCounters.delete(e)}this.eventCounters.set(t,{count:1,window:r})}else if(i.count++,i.count===51&&e.t(`[EventBus] Event "${t}" is firing too frequently (>${i.count-1}/s). Emissions above 50/s are throttled and above 100/s are dropped to prevent event storms. Consider debouncing the emitter.`),i.count>100)return;this.dispatchEvent(new CustomEvent(t,{detail:n,bubbles:!1,cancelable:!0}));let a=this.handlers[t];a&&a.forEach(r=>{try{r(n)}catch(n){e.t(`Error in global event handler for "${t}":`,n)}})}on(e,t){return this.handlers[e]||(this.handlers[e]=new Set),this.handlers[e].add(t),()=>this.off(e,t)}off(e,t){let n=this.handlers[e];n&&(n.delete(t),n.size===0&&delete this.handlers[e])}offAll(e){delete this.handlers[e]}listen(e,t,n){this.addEventListener(e,t,n);let r=()=>{this.removeEventListener(e,t),this.nativeUnsubscribers.delete(r)};return this.nativeUnsubscribers.set(r,!0),r}once(e,t){if(t!==void 0){let n=this.on(e,e=>{n(),t(e)})}else return new Promise(t=>{let n=this.on(e,e=>{n(),t(e)})})}getActiveEvents(){return Object.keys(this.handlers).filter(e=>this.handlers[e]&&this.handlers[e].size>0)}clear(){this.handlers={};let e=Array.from(this.nativeUnsubscribers.keys());this.nativeUnsubscribers.clear();for(let t of e)t()}getHandlerCount(e){return this.handlers[e]?.size||0}getEventStats(){let e={};for(let[t,n]of this.eventCounters.entries())e[t]={count:n.count,handlersCount:this.getHandlerCount(t)};return e}resetEventCounters(){this.eventCounters.clear()}},n=new Proxy({},{get(e,n){let r=t.getInstance(),i=r[n];return typeof i==`function`?i.bind(r):i},apply(){throw TypeError(`eventBus is not a callable function`)}}),r=(e,t)=>n.emit(e,t),i=(e,t)=>n.on(e,t),a=(e,t)=>n.off(e,t);function o(e,t){return t===void 0?n.once(e):n.once(e,t)}var s=(e,t,r)=>n.listen(e,t,r);exports.GlobalEventBus=t,exports.emit=r,exports.eventBus=n,exports.listen=s,exports.off=a,exports.on=i,exports.once=o;
 //# sourceMappingURL=custom-elements-runtime.event-bus.cjs.js.map

package/dist/custom-elements-runtime.event-bus.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-elements-runtime.event-bus.cjs.js","names":[],"sources":["../src/lib/event-bus.ts"],"sourcesContent":["/**\n * Event handler type for global event bus\n */\nexport type EventHandler<T> = (data: T) => void;\n\nimport { devError } from './runtime/logger';\n\n/**\n * Event map type using Set for efficient handler management\n */\ntype EventMap<Events extends Record<string, unknown>> = {\n  [K in keyof Events]: Set<EventHandler<Events[K]>>;\n};\n\n/**\n * GlobalEventBus provides a singleton event bus for cross-component communication.\n * Uses Set for handler storage to optimize add/remove operations and prevent duplicates.\n */\nexport class GlobalEventBus extends EventTarget {\n  private handlers: EventMap<Record<string, unknown>> = {};\n  private static instance: GlobalEventBus;\n  private eventCounters: Map<string, { count: number; window: number }> =\n    new Map();\n  private nativeUnsubscribers: Map<() => void, true> = new Map();\n  private readonly MAX_EVENT_COUNTERS = 1000;\n\n  /**\n   * Returns the singleton instance of GlobalEventBus\n   */\n  static getInstance(): GlobalEventBus {\n    if (!GlobalEventBus.instance) {\n      GlobalEventBus.instance = new GlobalEventBus();\n    }\n    return GlobalEventBus.instance;\n  }\n\n  /**\n   * Emit a global event with optional data. Includes event storm protection.\n   * @param eventName - Name of the event\n   * @param data - Optional event payload\n   */\n  emit<T = unknown>(eventName: string, data?: T): void {\n    // Event storm protection\n    const now = Date.now();\n    const counter = this.eventCounters.get(eventName);\n\n    if (!counter || now - counter.window > 1000) {\n      // Evict oldest entry if the map is at capacity to prevent unbounded growth.\n      if (!counter && this.eventCounters.size >= this.MAX_EVENT_COUNTERS) {\n        const firstKey = this.eventCounters.keys().next().value;\n        if (firstKey !== undefined) this.eventCounters.delete(firstKey);\n      }\n      // Reset counter every second\n      this.eventCounters.set(eventName, { count: 1, window: now });\n    } else {\n      counter.count++;\n\n      if (counter.count === 51) {\n        // Warn once at the throttle threshold so developers know emissions are being dropped.\n        devError(\n          `[EventBus] Event \"${eventName}\" is firing too frequently (>${counter.count - 1}/s). ` +\n            'Emissions above 50/s are throttled and above 100/s are dropped to prevent event storms. ' +\n            'Consider debouncing the emitter.',\n        );\n      }\n      if (counter.count > 100) {\n        // Drop the event to protect against runaway event storms.\n        return;\n      }\n    }\n\n    // Use native CustomEvent for better browser integration\n    this.dispatchEvent(\n      new CustomEvent(eventName, {\n        detail: data,\n        bubbles: false, // Global events don't need to bubble\n        cancelable: true,\n      }),\n    );\n\n    // Also trigger registered handlers\n    const eventHandlers = this.handlers[eventName];\n    if (eventHandlers) {\n      eventHandlers.forEach((handler) => {\n        try {\n          handler(data);\n        } catch (error) {\n          devError(`Error in global event handler for \"${eventName}\":`, error);\n        }\n      });\n    }\n  }\n\n  /**\n   * Register a handler for a global event. Returns an unsubscribe function.\n   * @param eventName - Name of the event\n   * @param handler - Handler function\n   */\n  on<T = unknown>(eventName: string, handler: EventHandler<T>): () => void {\n    if (!this.handlers[eventName]) {\n      this.handlers[eventName] = new Set<EventHandler<unknown>>();\n    }\n    this.handlers[eventName].add(handler as EventHandler<unknown>);\n    return () => this.off(eventName, handler);\n  }\n\n  /**\n   * Remove a specific handler for a global event.\n   * @param eventName - Name of the event\n   * @param handler - Handler function to remove\n   */\n  off<T = unknown>(eventName: string, handler: EventHandler<T>): void {\n    const eventHandlers = this.handlers[eventName];\n    if (eventHandlers) {\n      eventHandlers.delete(handler as EventHandler<unknown>);\n      // Remove the entry entirely once it is empty so stale keys don't\n      // accumulate indefinitely in long-lived apps.\n      if (eventHandlers.size === 0) {\n        delete this.handlers[eventName];\n      }\n    }\n  }\n\n  /**\n   * Remove all handlers for a specific event.\n   * @param eventName - Name of the event\n   */\n  offAll(eventName: string): void {\n    delete this.handlers[eventName];\n  }\n\n  /**\n   * Listen for a native CustomEvent. Returns an unsubscribe function.\n   * @param eventName - Name of the event\n   * @param handler - CustomEvent handler\n   * @param options - AddEventListener options\n   */\n  listen<T = unknown>(\n    eventName: string,\n    handler: (event: CustomEvent<T>) => void,\n    options?: AddEventListenerOptions,\n  ): () => void {\n    this.addEventListener(eventName, handler as EventListener, options);\n    // Use a wrapper so calling unsubscribe also removes it from nativeUnsubscribers,\n    // preventing indefinite accumulation in long-lived apps.\n    const unsubscribe: () => void = () => {\n      this.removeEventListener(eventName, handler as EventListener);\n      this.nativeUnsubscribers.delete(unsubscribe);\n    };\n    this.nativeUnsubscribers.set(unsubscribe, true);\n    return unsubscribe;\n  }\n\n  /**\n   * Register a one-time event handler (callback form).\n   * The handler is invoked exactly once, then automatically unsubscribed.\n   * @param eventName - Name of the event\n   * @param handler - Handler function\n   */\n  once<T = unknown>(eventName: string, handler: EventHandler<T>): void;\n  /**\n   * Returns a Promise that resolves with the first emission of the event\n   * (Promise form — no handler argument).\n   * @param eventName - Name of the event\n   */\n  once<T = unknown>(eventName: string): Promise<T>;\n  once<T = unknown>(\n    eventName: string,\n    handler?: EventHandler<T>,\n  ): void | Promise<T> {\n    if (handler !== undefined) {\n      // Callback form: fire-and-forget, returns void\n      const unsubscribe = this.on(eventName, (data: T) => {\n        unsubscribe();\n        handler(data);\n      });\n    } else {\n      // Promise form: resolves on first emission\n      return new Promise<T>((resolve) => {\n        const unsubscribe = this.on(eventName, (data: T) => {\n          unsubscribe();\n          resolve(data);\n        });\n      });\n    }\n  }\n\n  /**\n   * Get a list of all active event names with registered handlers.\n   */\n  getActiveEvents(): string[] {\n    return Object.keys(this.handlers).filter(\n      (eventName) =>\n        this.handlers[eventName] && this.handlers[eventName].size > 0,\n    );\n  }\n\n  /**\n   * Clear all event handlers and native EventTarget listeners (useful for testing or cleanup).\n   */\n  clear(): void {\n    this.handlers = {};\n    const toCleanup = Array.from(this.nativeUnsubscribers.keys());\n    this.nativeUnsubscribers.clear();\n    for (const unsubscribe of toCleanup) {\n      unsubscribe();\n    }\n  }\n\n  /**\n   * Get the number of handlers registered for a specific event.\n   * @param eventName - Name of the event\n   */\n  getHandlerCount(eventName: string): number {\n    return this.handlers[eventName]?.size || 0;\n  }\n\n  /**\n   * Get event statistics for debugging.\n   */\n  getEventStats(): Record<string, { count: number; handlersCount: number }> {\n    const stats: Record<string, { count: number; handlersCount: number }> = {};\n    for (const [eventName, counter] of this.eventCounters.entries()) {\n      stats[eventName] = {\n        count: counter.count,\n        handlersCount: this.getHandlerCount(eventName),\n      };\n    }\n    return stats;\n  }\n\n  /**\n   * Reset event counters (useful for testing or after resolving issues).\n   */\n  resetEventCounters(): void {\n    this.eventCounters.clear();\n  }\n}\n\n/**\n * Singleton instance of the global event bus\n */\n/**\n * Lazily-instantiated event bus.\n *\n * We preserve the `eventBus` export for backward compatibility but avoid\n * creating the underlying GlobalEventBus instance at module import time.\n * A small proxy defers the call to `GlobalEventBus.getInstance()` until a\n * property is accessed. This reduces import-time side-effects and helps\n * bundlers tree-shake unused entrypoints.\n */\nexport const eventBus = new Proxy(\n  {},\n  {\n    get(_target, prop: PropertyKey) {\n      const inst = GlobalEventBus.getInstance();\n      const val = (inst as unknown as Record<PropertyKey, unknown>)[prop];\n      // If the property is a function (method), bind it to the instance\n      // so callers using `eventBus.method(...)` get the correct `this`.\n      if (typeof val === 'function')\n        return (val as (...args: unknown[]) => unknown).bind(inst);\n      return val;\n    },\n    apply() {\n      throw new TypeError('eventBus is not a callable function');\n    },\n  },\n) as unknown as GlobalEventBus;\n\n/**\n * Emit a global event\n */\nexport const emit = <T = unknown>(eventName: string, data?: T) =>\n  eventBus.emit(eventName, data);\n\n/**\n * Register a handler for a global event\n */\nexport const on = <T = unknown>(eventName: string, handler: EventHandler<T>) =>\n  eventBus.on(eventName, handler);\n\n/**\n * Remove a handler for a global event\n */\nexport const off = <T = unknown>(eventName: string, handler: EventHandler<T>) =>\n  eventBus.off(eventName, handler);\n\n/**\n * Register a one-time handler for a global event (callback form).\n * The handler fires once then auto-unsubscribes.\n */\nexport function once<T = unknown>(\n  eventName: string,\n  handler: EventHandler<T>,\n): void;\n/**\n * Returns a Promise that resolves with the next emission of the event\n * (Promise form — no handler argument needed).\n */\nexport function once<T = unknown>(eventName: string): Promise<T>;\nexport function once<T = unknown>(\n  eventName: string,\n  handler?: EventHandler<T>,\n): void | Promise<T> {\n  if (handler !== undefined) {\n    return eventBus.once(eventName, handler);\n  }\n  return eventBus.once<T>(eventName);\n}\n\n/**\n * Listen for a native CustomEvent\n */\nexport const listen = <T = unknown>(\n  eventName: string,\n  handler: (event: CustomEvent<T>) => void,\n  options?: AddEventListenerOptions,\n) => eventBus.listen(eventName, handler, options);\n"],"mappings":"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"}
+{"version":3,"file":"custom-elements-runtime.event-bus.cjs.js","names":[],"sources":["../src/lib/event-bus.ts"],"sourcesContent":["/**\n * Event handler type for global event bus\n */\nexport type EventHandler<T> = (data: T) => void;\n\nimport { devError } from './runtime/logger';\n\n/**\n * Event map type using Set for efficient handler management\n */\ntype EventMap<Events extends Record<string, unknown>> = {\n  [K in keyof Events]: Set<EventHandler<Events[K]>>;\n};\n\n/**\n * GlobalEventBus provides a singleton event bus for cross-component communication.\n * Uses Set for handler storage to optimize add/remove operations and prevent duplicates.\n */\nexport class GlobalEventBus extends EventTarget {\n  private handlers: EventMap<Record<string, unknown>> = {};\n  private static instance: GlobalEventBus;\n  private eventCounters: Map<string, { count: number; window: number }> =\n    new Map();\n  private nativeUnsubscribers: Map<() => void, true> = new Map();\n  private readonly MAX_EVENT_COUNTERS = 1000;\n\n  /**\n   * Returns the singleton instance of GlobalEventBus\n   */\n  static getInstance(): GlobalEventBus {\n    if (!GlobalEventBus.instance) {\n      GlobalEventBus.instance = new GlobalEventBus();\n    }\n    return GlobalEventBus.instance;\n  }\n\n  /**\n   * Emit a global event with optional data. Includes event storm protection.\n   * @param eventName - Name of the event\n   * @param data - Optional event payload\n   */\n  emit<T = unknown>(eventName: string, data?: T): void {\n    // Event storm protection\n    const now = Date.now();\n    const counter = this.eventCounters.get(eventName);\n\n    if (!counter || now - counter.window > 1000) {\n      // Evict oldest entry if the map is at capacity to prevent unbounded growth.\n      if (!counter && this.eventCounters.size >= this.MAX_EVENT_COUNTERS) {\n        const firstKey = this.eventCounters.keys().next().value;\n        if (firstKey !== undefined) this.eventCounters.delete(firstKey);\n      }\n      // Reset counter every second\n      this.eventCounters.set(eventName, { count: 1, window: now });\n    } else {\n      counter.count++;\n\n      if (counter.count === 51) {\n        // Warn once at the throttle threshold so developers know emissions are being dropped.\n        devError(\n          `[EventBus] Event \"${eventName}\" is firing too frequently (>${counter.count - 1}/s). ` +\n            'Emissions above 50/s are throttled and above 100/s are dropped to prevent event storms. ' +\n            'Consider debouncing the emitter.',\n        );\n      }\n      if (counter.count > 100) {\n        // Drop the event to protect against runaway event storms.\n        return;\n      }\n    }\n\n    // Use native CustomEvent for better browser integration\n    this.dispatchEvent(\n      new CustomEvent(eventName, {\n        detail: data,\n        bubbles: false, // Global events don't need to bubble\n        cancelable: true,\n      }),\n    );\n\n    // Also trigger registered handlers\n    const eventHandlers = this.handlers[eventName];\n    if (eventHandlers) {\n      eventHandlers.forEach((handler) => {\n        try {\n          handler(data);\n        } catch (error) {\n          devError(`Error in global event handler for \"${eventName}\":`, error);\n        }\n      });\n    }\n  }\n\n  /**\n   * Register a handler for a global event. Returns an unsubscribe function.\n   * @param eventName - Name of the event\n   * @param handler - Handler function\n   */\n  on<T = unknown>(eventName: string, handler: EventHandler<T>): () => void {\n    if (!this.handlers[eventName]) {\n      this.handlers[eventName] = new Set<EventHandler<unknown>>();\n    }\n    this.handlers[eventName].add(handler as EventHandler<unknown>);\n    return () => this.off(eventName, handler);\n  }\n\n  /**\n   * Remove a specific handler for a global event.\n   * @param eventName - Name of the event\n   * @param handler - Handler function to remove\n   */\n  off<T = unknown>(eventName: string, handler: EventHandler<T>): void {\n    const eventHandlers = this.handlers[eventName];\n    if (eventHandlers) {\n      eventHandlers.delete(handler as EventHandler<unknown>);\n      // Remove the entry entirely once it is empty so stale keys don't\n      // accumulate indefinitely in long-lived apps.\n      if (eventHandlers.size === 0) {\n        delete this.handlers[eventName];\n      }\n    }\n  }\n\n  /**\n   * Remove all handlers for a specific event.\n   * @param eventName - Name of the event\n   */\n  offAll(eventName: string): void {\n    delete this.handlers[eventName];\n  }\n\n  /**\n   * Listen for a native CustomEvent. Returns an unsubscribe function.\n   * @param eventName - Name of the event\n   * @param handler - CustomEvent handler\n   * @param options - AddEventListener options\n   */\n  listen<T = unknown>(\n    eventName: string,\n    handler: (event: CustomEvent<T>) => void,\n    options?: AddEventListenerOptions,\n  ): () => void {\n    this.addEventListener(eventName, handler as EventListener, options);\n    // Use a wrapper so calling unsubscribe also removes it from nativeUnsubscribers,\n    // preventing indefinite accumulation in long-lived apps.\n    const unsubscribe: () => void = () => {\n      this.removeEventListener(eventName, handler as EventListener);\n      this.nativeUnsubscribers.delete(unsubscribe);\n    };\n    this.nativeUnsubscribers.set(unsubscribe, true);\n    return unsubscribe;\n  }\n\n  /**\n   * Register a one-time event handler (callback form).\n   * The handler is invoked exactly once, then automatically unsubscribed.\n   * @param eventName - Name of the event\n   * @param handler - Handler function\n   */\n  once<T = unknown>(eventName: string, handler: EventHandler<T>): void;\n  /**\n   * Returns a Promise that resolves with the first emission of the event\n   * (Promise form — no handler argument).\n   * @param eventName - Name of the event\n   */\n  once<T = unknown>(eventName: string): Promise<T>;\n  once<T = unknown>(\n    eventName: string,\n    handler?: EventHandler<T>,\n  ): void | Promise<T> {\n    if (handler !== undefined) {\n      // Callback form: fire-and-forget, returns void\n      const unsubscribe = this.on(eventName, (data: T) => {\n        unsubscribe();\n        handler(data);\n      });\n    } else {\n      // Promise form: resolves on first emission\n      return new Promise<T>((resolve) => {\n        const unsubscribe = this.on(eventName, (data: T) => {\n          unsubscribe();\n          resolve(data);\n        });\n      });\n    }\n  }\n\n  /**\n   * Get a list of all active event names with registered handlers.\n   */\n  getActiveEvents(): string[] {\n    return Object.keys(this.handlers).filter(\n      (eventName) =>\n        this.handlers[eventName] && this.handlers[eventName].size > 0,\n    );\n  }\n\n  /**\n   * Clear all event handlers and native EventTarget listeners (useful for testing or cleanup).\n   */\n  clear(): void {\n    this.handlers = {};\n    const toCleanup = Array.from(this.nativeUnsubscribers.keys());\n    this.nativeUnsubscribers.clear();\n    for (const unsubscribe of toCleanup) {\n      unsubscribe();\n    }\n  }\n\n  /**\n   * Get the number of handlers registered for a specific event.\n   * @param eventName - Name of the event\n   */\n  getHandlerCount(eventName: string): number {\n    return this.handlers[eventName]?.size || 0;\n  }\n\n  /**\n   * Get event statistics for debugging.\n   */\n  getEventStats(): Record<string, { count: number; handlersCount: number }> {\n    const stats: Record<string, { count: number; handlersCount: number }> = {};\n    for (const [eventName, counter] of this.eventCounters.entries()) {\n      stats[eventName] = {\n        count: counter.count,\n        handlersCount: this.getHandlerCount(eventName),\n      };\n    }\n    return stats;\n  }\n\n  /**\n   * Reset event counters (useful for testing or after resolving issues).\n   */\n  resetEventCounters(): void {\n    this.eventCounters.clear();\n  }\n}\n\n/**\n * Singleton instance of the global event bus\n */\n/**\n * Lazily-instantiated event bus.\n *\n * We preserve the `eventBus` export for backward compatibility but avoid\n * creating the underlying GlobalEventBus instance at module import time.\n * A small proxy defers the call to `GlobalEventBus.getInstance()` until a\n * property is accessed. This reduces import-time side-effects and helps\n * bundlers tree-shake unused entrypoints.\n */\nexport const eventBus = new Proxy(\n  {},\n  {\n    get(_target, prop: PropertyKey) {\n      const inst = GlobalEventBus.getInstance();\n      const val = (inst as unknown as Record<PropertyKey, unknown>)[prop];\n      // If the property is a function (method), bind it to the instance\n      // so callers using `eventBus.method(...)` get the correct `this`.\n      if (typeof val === 'function')\n        return (val as (...args: unknown[]) => unknown).bind(inst);\n      return val;\n    },\n    apply() {\n      throw new TypeError('eventBus is not a callable function');\n    },\n  },\n) as unknown as GlobalEventBus;\n\n/**\n * Emit a global event\n */\nexport const emit = <T = unknown>(eventName: string, data?: T) =>\n  eventBus.emit(eventName, data);\n\n/**\n * Register a handler for a global event\n */\nexport const on = <T = unknown>(eventName: string, handler: EventHandler<T>) =>\n  eventBus.on(eventName, handler);\n\n/**\n * Remove a handler for a global event\n */\nexport const off = <T = unknown>(eventName: string, handler: EventHandler<T>) =>\n  eventBus.off(eventName, handler);\n\n/**\n * Register a one-time handler for a global event (callback form).\n * The handler fires once then auto-unsubscribes.\n */\nexport function once<T = unknown>(\n  eventName: string,\n  handler: EventHandler<T>,\n): void;\n/**\n * Returns a Promise that resolves with the next emission of the event\n * (Promise form — no handler argument needed).\n */\nexport function once<T = unknown>(eventName: string): Promise<T>;\nexport function once<T = unknown>(\n  eventName: string,\n  handler?: EventHandler<T>,\n): void | Promise<T> {\n  if (handler !== undefined) {\n    return eventBus.once(eventName, handler);\n  }\n  return eventBus.once<T>(eventName);\n}\n\n/**\n * Listen for a native CustomEvent\n */\nexport const listen = <T = unknown>(\n  eventName: string,\n  handler: (event: CustomEvent<T>) => void,\n  options?: AddEventListenerOptions,\n) => eventBus.listen(eventName, handler, options);\n"],"mappings":"4GAkBA,IAAa,EAAb,MAAa,UAAuB,WAAY,CAC9C,SAAsD,EAAE,CACxD,OAAe,SACf,cACE,IAAI,IACN,oBAAqD,IAAI,IACzD,mBAAsC,IAKtC,OAAO,aAA8B,CAInC,MAHA,CACE,EAAe,WAAW,IAAI,EAEzB,EAAe,SAQxB,KAAkB,EAAmB,EAAgB,CAEnD,IAAM,EAAM,KAAK,KAAK,CAChB,EAAU,KAAK,cAAc,IAAI,EAAU,CAEjD,GAAI,CAAC,GAAW,EAAM,EAAQ,OAAS,IAAM,CAE3C,GAAI,CAAC,GAAW,KAAK,cAAc,MAAQ,KAAK,mBAAoB,CAClE,IAAM,EAAW,KAAK,cAAc,MAAM,CAAC,MAAM,CAAC,MAC9C,IAAa,IAAA,IAAW,KAAK,cAAc,OAAO,EAAS,CAGjE,KAAK,cAAc,IAAI,EAAW,CAAE,MAAO,EAAG,OAAQ,EAAK,CAAC,SAE5D,EAAQ,QAEJ,EAAQ,QAAU,IAEpB,EAAA,EACE,qBAAqB,EAAU,+BAA+B,EAAQ,MAAQ,EAAE,+HAGjF,CAEC,EAAQ,MAAQ,IAElB,OAKJ,KAAK,cACH,IAAI,YAAY,EAAW,CACzB,OAAQ,EACR,QAAS,GACT,WAAY,GACb,CAAC,CACH,CAGD,IAAM,EAAgB,KAAK,SAAS,GAChC,GACF,EAAc,QAAS,GAAY,CACjC,GAAI,CACF,EAAQ,EAAK,OACN,EAAO,CACd,EAAA,EAAS,sCAAsC,EAAU,IAAK,EAAM,GAEtE,CASN,GAAgB,EAAmB,EAAsC,CAKvE,OAJK,KAAK,SAAS,KACjB,KAAK,SAAS,GAAa,IAAI,KAEjC,KAAK,SAAS,GAAW,IAAI,EAAiC,KACjD,KAAK,IAAI,EAAW,EAAQ,CAQ3C,IAAiB,EAAmB,EAAgC,CAClE,IAAM,EAAgB,KAAK,SAAS,GAChC,IACF,EAAc,OAAO,EAAiC,CAGlD,EAAc,OAAS,GACzB,OAAO,KAAK,SAAS,IAS3B,OAAO,EAAyB,CAC9B,OAAO,KAAK,SAAS,GASvB,OACE,EACA,EACA,EACY,CACZ,KAAK,iBAAiB,EAAW,EAA0B,EAAQ,CAGnE,IAAM,MAAgC,CACpC,KAAK,oBAAoB,EAAW,EAAyB,CAC7D,KAAK,oBAAoB,OAAO,EAAY,EAG9C,OADA,KAAK,oBAAoB,IAAI,EAAa,GAAK,CACxC,EAgBT,KACE,EACA,EACmB,CACnB,GAAI,IAAY,IAAA,GAAW,CAEzB,IAAM,EAAc,KAAK,GAAG,EAAY,GAAY,CAClD,GAAa,CACb,EAAQ,EAAK,EACb,MAGF,OAAO,IAAI,QAAY,GAAY,CACjC,IAAM,EAAc,KAAK,GAAG,EAAY,GAAY,CAClD,GAAa,CACb,EAAQ,EAAK,EACb,EACF,CAON,iBAA4B,CAC1B,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,OAC/B,GACC,KAAK,SAAS,IAAc,KAAK,SAAS,GAAW,KAAO,EAC/D,CAMH,OAAc,CACZ,KAAK,SAAW,EAAE,CAClB,IAAM,EAAY,MAAM,KAAK,KAAK,oBAAoB,MAAM,CAAC,CAC7D,KAAK,oBAAoB,OAAO,CAChC,IAAK,IAAM,KAAe,EACxB,GAAa,CAQjB,gBAAgB,EAA2B,CACzC,OAAO,KAAK,SAAS,IAAY,MAAQ,EAM3C,eAA0E,CACxE,IAAM,EAAkE,EAAE,CAC1E,IAAK,GAAM,CAAC,EAAW,KAAY,KAAK,cAAc,SAAS,CAC7D,EAAM,GAAa,CACjB,MAAO,EAAQ,MACf,cAAe,KAAK,gBAAgB,EAAU,CAC/C,CAEH,OAAO,EAMT,oBAA2B,CACzB,KAAK,cAAc,OAAO,GAgBjB,EAAW,IAAI,MAC1B,EAAE,CACF,CACE,IAAI,EAAS,EAAmB,CAC9B,IAAM,EAAO,EAAe,aAAa,CACnC,EAAO,EAAiD,GAK9D,OAFI,OAAO,GAAQ,WACT,EAAwC,KAAK,EAAK,CACrD,GAET,OAAQ,CACN,MAAU,UAAU,sCAAsC,EAE7D,CACF,CAKY,GAAqB,EAAmB,IACnD,EAAS,KAAK,EAAW,EAAK,CAKnB,GAAmB,EAAmB,IACjD,EAAS,GAAG,EAAW,EAAQ,CAKpB,GAAoB,EAAmB,IAClD,EAAS,IAAI,EAAW,EAAQ,CAelC,SAAgB,EACd,EACA,EACmB,CAInB,OAHI,IAAY,IAAA,GAGT,EAAS,KAAQ,EAAU,CAFzB,EAAS,KAAK,EAAW,EAAQ,CAQ5C,IAAa,GACX,EACA,EACA,IACG,EAAS,OAAO,EAAW,EAAS,EAAQ"}

package/dist/custom-elements-runtime.event-bus.es.js

@@ -1,111 +1,105 @@
-import { t as a } from "./logger-L25axmB-.js";
-var h = class o extends EventTarget {
-  handlers = {};
-  static instance;
-  eventCounters = /* @__PURE__ */ new Map();
-  nativeUnsubscribers = /* @__PURE__ */ new Map();
-  MAX_EVENT_COUNTERS = 1e3;
-  static getInstance() {
-    return o.instance || (o.instance = new o()), o.instance;
-  }
-  emit(t, e) {
-    const n = Date.now(), s = this.eventCounters.get(t);
-    if (!s || n - s.window > 1e3) {
-      if (!s && this.eventCounters.size >= this.MAX_EVENT_COUNTERS) {
-        const c = this.eventCounters.keys().next().value;
-        c !== void 0 && this.eventCounters.delete(c);
-      }
-      this.eventCounters.set(t, {
-        count: 1,
-        window: n
-      });
-    } else if (s.count++, s.count === 51 && a(`[EventBus] Event "${t}" is firing too frequently (>${s.count - 1}/s). Emissions above 50/s are throttled and above 100/s are dropped to prevent event storms. Consider debouncing the emitter.`), s.count > 100) return;
-    this.dispatchEvent(new CustomEvent(t, {
-      detail: e,
-      bubbles: !1,
-      cancelable: !0
-    }));
-    const u = this.handlers[t];
-    u && u.forEach((c) => {
-      try {
-        c(e);
-      } catch (l) {
-        a(`Error in global event handler for "${t}":`, l);
-      }
-    });
-  }
-  on(t, e) {
-    return this.handlers[t] || (this.handlers[t] = /* @__PURE__ */ new Set()), this.handlers[t].add(e), () => this.off(t, e);
-  }
-  off(t, e) {
-    const n = this.handlers[t];
-    n && (n.delete(e), n.size === 0 && delete this.handlers[t]);
-  }
-  offAll(t) {
-    delete this.handlers[t];
-  }
-  listen(t, e, n) {
-    this.addEventListener(t, e, n);
-    const s = () => {
-      this.removeEventListener(t, e), this.nativeUnsubscribers.delete(s);
-    };
-    return this.nativeUnsubscribers.set(s, !0), s;
-  }
-  once(t, e) {
-    if (e !== void 0) {
-      const n = this.on(t, (s) => {
-        n(), e(s);
-      });
-    } else return new Promise((n) => {
-      const s = this.on(t, (u) => {
-        s(), n(u);
-      });
-    });
-  }
-  getActiveEvents() {
-    return Object.keys(this.handlers).filter((t) => this.handlers[t] && this.handlers[t].size > 0);
-  }
-  clear() {
-    this.handlers = {};
-    const t = Array.from(this.nativeUnsubscribers.keys());
-    this.nativeUnsubscribers.clear();
-    for (const e of t) e();
-  }
-  getHandlerCount(t) {
-    return this.handlers[t]?.size || 0;
-  }
-  getEventStats() {
-    const t = {};
-    for (const [e, n] of this.eventCounters.entries()) t[e] = {
-      count: n.count,
-      handlersCount: this.getHandlerCount(e)
-    };
-    return t;
-  }
-  resetEventCounters() {
-    this.eventCounters.clear();
-  }
-}, i = new Proxy({}, {
-  get(r, t) {
-    const e = h.getInstance(), n = e[t];
-    return typeof n == "function" ? n.bind(e) : n;
-  },
-  apply() {
-    throw new TypeError("eventBus is not a callable function");
-  }
-}), d = (r, t) => i.emit(r, t), v = (r, t) => i.on(r, t), b = (r, t) => i.off(r, t);
-function E(r, t) {
-  return t !== void 0 ? i.once(r, t) : i.once(r);
+import { t as e } from "./logger-DIJ0UH3R.js";
+//#region src/lib/event-bus.ts
+var t = class t extends EventTarget {
+	handlers = {};
+	static instance;
+	eventCounters = /* @__PURE__ */ new Map();
+	nativeUnsubscribers = /* @__PURE__ */ new Map();
+	MAX_EVENT_COUNTERS = 1e3;
+	static getInstance() {
+		return t.instance ||= new t(), t.instance;
+	}
+	emit(t, n) {
+		let r = Date.now(), i = this.eventCounters.get(t);
+		if (!i || r - i.window > 1e3) {
+			if (!i && this.eventCounters.size >= this.MAX_EVENT_COUNTERS) {
+				let e = this.eventCounters.keys().next().value;
+				e !== void 0 && this.eventCounters.delete(e);
+			}
+			this.eventCounters.set(t, {
+				count: 1,
+				window: r
+			});
+		} else if (i.count++, i.count === 51 && e(`[EventBus] Event "${t}" is firing too frequently (>${i.count - 1}/s). Emissions above 50/s are throttled and above 100/s are dropped to prevent event storms. Consider debouncing the emitter.`), i.count > 100) return;
+		this.dispatchEvent(new CustomEvent(t, {
+			detail: n,
+			bubbles: !1,
+			cancelable: !0
+		}));
+		let a = this.handlers[t];
+		a && a.forEach((r) => {
+			try {
+				r(n);
+			} catch (n) {
+				e(`Error in global event handler for "${t}":`, n);
+			}
+		});
+	}
+	on(e, t) {
+		return this.handlers[e] || (this.handlers[e] = /* @__PURE__ */ new Set()), this.handlers[e].add(t), () => this.off(e, t);
+	}
+	off(e, t) {
+		let n = this.handlers[e];
+		n && (n.delete(t), n.size === 0 && delete this.handlers[e]);
+	}
+	offAll(e) {
+		delete this.handlers[e];
+	}
+	listen(e, t, n) {
+		this.addEventListener(e, t, n);
+		let r = () => {
+			this.removeEventListener(e, t), this.nativeUnsubscribers.delete(r);
+		};
+		return this.nativeUnsubscribers.set(r, !0), r;
+	}
+	once(e, t) {
+		if (t !== void 0) {
+			let n = this.on(e, (e) => {
+				n(), t(e);
+			});
+		} else return new Promise((t) => {
+			let n = this.on(e, (e) => {
+				n(), t(e);
+			});
+		});
+	}
+	getActiveEvents() {
+		return Object.keys(this.handlers).filter((e) => this.handlers[e] && this.handlers[e].size > 0);
+	}
+	clear() {
+		this.handlers = {};
+		let e = Array.from(this.nativeUnsubscribers.keys());
+		this.nativeUnsubscribers.clear();
+		for (let t of e) t();
+	}
+	getHandlerCount(e) {
+		return this.handlers[e]?.size || 0;
+	}
+	getEventStats() {
+		let e = {};
+		for (let [t, n] of this.eventCounters.entries()) e[t] = {
+			count: n.count,
+			handlersCount: this.getHandlerCount(t)
+		};
+		return e;
+	}
+	resetEventCounters() {
+		this.eventCounters.clear();
+	}
+}, n = new Proxy({}, {
+	get(e, n) {
+		let r = t.getInstance(), i = r[n];
+		return typeof i == "function" ? i.bind(r) : i;
+	},
+	apply() {
+		throw TypeError("eventBus is not a callable function");
+	}
+}), r = (e, t) => n.emit(e, t), i = (e, t) => n.on(e, t), a = (e, t) => n.off(e, t);
+function o(e, t) {
+	return t === void 0 ? n.once(e) : n.once(e, t);
 }
-var C = (r, t, e) => i.listen(r, t, e);
-export {
-  h as GlobalEventBus,
-  d as emit,
-  i as eventBus,
-  C as listen,
-  b as off,
-  v as on,
-  E as once
-};
+var s = (e, t, r) => n.listen(e, t, r);
+//#endregion
+export { t as GlobalEventBus, r as emit, n as eventBus, s as listen, a as off, i as on, o as once };
 
 //# sourceMappingURL=custom-elements-runtime.event-bus.es.js.map

package/dist/custom-elements-runtime.event-bus.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-elements-runtime.event-bus.es.js","names":[],"sources":["../src/lib/event-bus.ts"],"sourcesContent":["/**\n * Event handler type for global event bus\n */\nexport type EventHandler<T> = (data: T) => void;\n\nimport { devError } from './runtime/logger';\n\n/**\n * Event map type using Set for efficient handler management\n */\ntype EventMap<Events extends Record<string, unknown>> = {\n  [K in keyof Events]: Set<EventHandler<Events[K]>>;\n};\n\n/**\n * GlobalEventBus provides a singleton event bus for cross-component communication.\n * Uses Set for handler storage to optimize add/remove operations and prevent duplicates.\n */\nexport class GlobalEventBus extends EventTarget {\n  private handlers: EventMap<Record<string, unknown>> = {};\n  private static instance: GlobalEventBus;\n  private eventCounters: Map<string, { count: number; window: number }> =\n    new Map();\n  private nativeUnsubscribers: Map<() => void, true> = new Map();\n  private readonly MAX_EVENT_COUNTERS = 1000;\n\n  /**\n   * Returns the singleton instance of GlobalEventBus\n   */\n  static getInstance(): GlobalEventBus {\n    if (!GlobalEventBus.instance) {\n      GlobalEventBus.instance = new GlobalEventBus();\n    }\n    return GlobalEventBus.instance;\n  }\n\n  /**\n   * Emit a global event with optional data. Includes event storm protection.\n   * @param eventName - Name of the event\n   * @param data - Optional event payload\n   */\n  emit<T = unknown>(eventName: string, data?: T): void {\n    // Event storm protection\n    const now = Date.now();\n    const counter = this.eventCounters.get(eventName);\n\n    if (!counter || now - counter.window > 1000) {\n      // Evict oldest entry if the map is at capacity to prevent unbounded growth.\n      if (!counter && this.eventCounters.size >= this.MAX_EVENT_COUNTERS) {\n        const firstKey = this.eventCounters.keys().next().value;\n        if (firstKey !== undefined) this.eventCounters.delete(firstKey);\n      }\n      // Reset counter every second\n      this.eventCounters.set(eventName, { count: 1, window: now });\n    } else {\n      counter.count++;\n\n      if (counter.count === 51) {\n        // Warn once at the throttle threshold so developers know emissions are being dropped.\n        devError(\n          `[EventBus] Event \"${eventName}\" is firing too frequently (>${counter.count - 1}/s). ` +\n            'Emissions above 50/s are throttled and above 100/s are dropped to prevent event storms. ' +\n            'Consider debouncing the emitter.',\n        );\n      }\n      if (counter.count > 100) {\n        // Drop the event to protect against runaway event storms.\n        return;\n      }\n    }\n\n    // Use native CustomEvent for better browser integration\n    this.dispatchEvent(\n      new CustomEvent(eventName, {\n        detail: data,\n        bubbles: false, // Global events don't need to bubble\n        cancelable: true,\n      }),\n    );\n\n    // Also trigger registered handlers\n    const eventHandlers = this.handlers[eventName];\n    if (eventHandlers) {\n      eventHandlers.forEach((handler) => {\n        try {\n          handler(data);\n        } catch (error) {\n          devError(`Error in global event handler for \"${eventName}\":`, error);\n        }\n      });\n    }\n  }\n\n  /**\n   * Register a handler for a global event. Returns an unsubscribe function.\n   * @param eventName - Name of the event\n   * @param handler - Handler function\n   */\n  on<T = unknown>(eventName: string, handler: EventHandler<T>): () => void {\n    if (!this.handlers[eventName]) {\n      this.handlers[eventName] = new Set<EventHandler<unknown>>();\n    }\n    this.handlers[eventName].add(handler as EventHandler<unknown>);\n    return () => this.off(eventName, handler);\n  }\n\n  /**\n   * Remove a specific handler for a global event.\n   * @param eventName - Name of the event\n   * @param handler - Handler function to remove\n   */\n  off<T = unknown>(eventName: string, handler: EventHandler<T>): void {\n    const eventHandlers = this.handlers[eventName];\n    if (eventHandlers) {\n      eventHandlers.delete(handler as EventHandler<unknown>);\n      // Remove the entry entirely once it is empty so stale keys don't\n      // accumulate indefinitely in long-lived apps.\n      if (eventHandlers.size === 0) {\n        delete this.handlers[eventName];\n      }\n    }\n  }\n\n  /**\n   * Remove all handlers for a specific event.\n   * @param eventName - Name of the event\n   */\n  offAll(eventName: string): void {\n    delete this.handlers[eventName];\n  }\n\n  /**\n   * Listen for a native CustomEvent. Returns an unsubscribe function.\n   * @param eventName - Name of the event\n   * @param handler - CustomEvent handler\n   * @param options - AddEventListener options\n   */\n  listen<T = unknown>(\n    eventName: string,\n    handler: (event: CustomEvent<T>) => void,\n    options?: AddEventListenerOptions,\n  ): () => void {\n    this.addEventListener(eventName, handler as EventListener, options);\n    // Use a wrapper so calling unsubscribe also removes it from nativeUnsubscribers,\n    // preventing indefinite accumulation in long-lived apps.\n    const unsubscribe: () => void = () => {\n      this.removeEventListener(eventName, handler as EventListener);\n      this.nativeUnsubscribers.delete(unsubscribe);\n    };\n    this.nativeUnsubscribers.set(unsubscribe, true);\n    return unsubscribe;\n  }\n\n  /**\n   * Register a one-time event handler (callback form).\n   * The handler is invoked exactly once, then automatically unsubscribed.\n   * @param eventName - Name of the event\n   * @param handler - Handler function\n   */\n  once<T = unknown>(eventName: string, handler: EventHandler<T>): void;\n  /**\n   * Returns a Promise that resolves with the first emission of the event\n   * (Promise form — no handler argument).\n   * @param eventName - Name of the event\n   */\n  once<T = unknown>(eventName: string): Promise<T>;\n  once<T = unknown>(\n    eventName: string,\n    handler?: EventHandler<T>,\n  ): void | Promise<T> {\n    if (handler !== undefined) {\n      // Callback form: fire-and-forget, returns void\n      const unsubscribe = this.on(eventName, (data: T) => {\n        unsubscribe();\n        handler(data);\n      });\n    } else {\n      // Promise form: resolves on first emission\n      return new Promise<T>((resolve) => {\n        const unsubscribe = this.on(eventName, (data: T) => {\n          unsubscribe();\n          resolve(data);\n        });\n      });\n    }\n  }\n\n  /**\n   * Get a list of all active event names with registered handlers.\n   */\n  getActiveEvents(): string[] {\n    return Object.keys(this.handlers).filter(\n      (eventName) =>\n        this.handlers[eventName] && this.handlers[eventName].size > 0,\n    );\n  }\n\n  /**\n   * Clear all event handlers and native EventTarget listeners (useful for testing or cleanup).\n   */\n  clear(): void {\n    this.handlers = {};\n    const toCleanup = Array.from(this.nativeUnsubscribers.keys());\n    this.nativeUnsubscribers.clear();\n    for (const unsubscribe of toCleanup) {\n      unsubscribe();\n    }\n  }\n\n  /**\n   * Get the number of handlers registered for a specific event.\n   * @param eventName - Name of the event\n   */\n  getHandlerCount(eventName: string): number {\n    return this.handlers[eventName]?.size || 0;\n  }\n\n  /**\n   * Get event statistics for debugging.\n   */\n  getEventStats(): Record<string, { count: number; handlersCount: number }> {\n    const stats: Record<string, { count: number; handlersCount: number }> = {};\n    for (const [eventName, counter] of this.eventCounters.entries()) {\n      stats[eventName] = {\n        count: counter.count,\n        handlersCount: this.getHandlerCount(eventName),\n      };\n    }\n    return stats;\n  }\n\n  /**\n   * Reset event counters (useful for testing or after resolving issues).\n   */\n  resetEventCounters(): void {\n    this.eventCounters.clear();\n  }\n}\n\n/**\n * Singleton instance of the global event bus\n */\n/**\n * Lazily-instantiated event bus.\n *\n * We preserve the `eventBus` export for backward compatibility but avoid\n * creating the underlying GlobalEventBus instance at module import time.\n * A small proxy defers the call to `GlobalEventBus.getInstance()` until a\n * property is accessed. This reduces import-time side-effects and helps\n * bundlers tree-shake unused entrypoints.\n */\nexport const eventBus = new Proxy(\n  {},\n  {\n    get(_target, prop: PropertyKey) {\n      const inst = GlobalEventBus.getInstance();\n      const val = (inst as unknown as Record<PropertyKey, unknown>)[prop];\n      // If the property is a function (method), bind it to the instance\n      // so callers using `eventBus.method(...)` get the correct `this`.\n      if (typeof val === 'function')\n        return (val as (...args: unknown[]) => unknown).bind(inst);\n      return val;\n    },\n    apply() {\n      throw new TypeError('eventBus is not a callable function');\n    },\n  },\n) as unknown as GlobalEventBus;\n\n/**\n * Emit a global event\n */\nexport const emit = <T = unknown>(eventName: string, data?: T) =>\n  eventBus.emit(eventName, data);\n\n/**\n * Register a handler for a global event\n */\nexport const on = <T = unknown>(eventName: string, handler: EventHandler<T>) =>\n  eventBus.on(eventName, handler);\n\n/**\n * Remove a handler for a global event\n */\nexport const off = <T = unknown>(eventName: string, handler: EventHandler<T>) =>\n  eventBus.off(eventName, handler);\n\n/**\n * Register a one-time handler for a global event (callback form).\n * The handler fires once then auto-unsubscribes.\n */\nexport function once<T = unknown>(\n  eventName: string,\n  handler: EventHandler<T>,\n): void;\n/**\n * Returns a Promise that resolves with the next emission of the event\n * (Promise form — no handler argument needed).\n */\nexport function once<T = unknown>(eventName: string): Promise<T>;\nexport function once<T = unknown>(\n  eventName: string,\n  handler?: EventHandler<T>,\n): void | Promise<T> {\n  if (handler !== undefined) {\n    return eventBus.once(eventName, handler);\n  }\n  return eventBus.once<T>(eventName);\n}\n\n/**\n * Listen for a native CustomEvent\n */\nexport const listen = <T = unknown>(\n  eventName: string,\n  handler: (event: CustomEvent<T>) => void,\n  options?: AddEventListenerOptions,\n) => eventBus.listen(eventName, handler, options);\n"],"mappings":"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"}
+{"version":3,"file":"custom-elements-runtime.event-bus.es.js","names":[],"sources":["../src/lib/event-bus.ts"],"sourcesContent":["/**\n * Event handler type for global event bus\n */\nexport type EventHandler<T> = (data: T) => void;\n\nimport { devError } from './runtime/logger';\n\n/**\n * Event map type using Set for efficient handler management\n */\ntype EventMap<Events extends Record<string, unknown>> = {\n  [K in keyof Events]: Set<EventHandler<Events[K]>>;\n};\n\n/**\n * GlobalEventBus provides a singleton event bus for cross-component communication.\n * Uses Set for handler storage to optimize add/remove operations and prevent duplicates.\n */\nexport class GlobalEventBus extends EventTarget {\n  private handlers: EventMap<Record<string, unknown>> = {};\n  private static instance: GlobalEventBus;\n  private eventCounters: Map<string, { count: number; window: number }> =\n    new Map();\n  private nativeUnsubscribers: Map<() => void, true> = new Map();\n  private readonly MAX_EVENT_COUNTERS = 1000;\n\n  /**\n   * Returns the singleton instance of GlobalEventBus\n   */\n  static getInstance(): GlobalEventBus {\n    if (!GlobalEventBus.instance) {\n      GlobalEventBus.instance = new GlobalEventBus();\n    }\n    return GlobalEventBus.instance;\n  }\n\n  /**\n   * Emit a global event with optional data. Includes event storm protection.\n   * @param eventName - Name of the event\n   * @param data - Optional event payload\n   */\n  emit<T = unknown>(eventName: string, data?: T): void {\n    // Event storm protection\n    const now = Date.now();\n    const counter = this.eventCounters.get(eventName);\n\n    if (!counter || now - counter.window > 1000) {\n      // Evict oldest entry if the map is at capacity to prevent unbounded growth.\n      if (!counter && this.eventCounters.size >= this.MAX_EVENT_COUNTERS) {\n        const firstKey = this.eventCounters.keys().next().value;\n        if (firstKey !== undefined) this.eventCounters.delete(firstKey);\n      }\n      // Reset counter every second\n      this.eventCounters.set(eventName, { count: 1, window: now });\n    } else {\n      counter.count++;\n\n      if (counter.count === 51) {\n        // Warn once at the throttle threshold so developers know emissions are being dropped.\n        devError(\n          `[EventBus] Event \"${eventName}\" is firing too frequently (>${counter.count - 1}/s). ` +\n            'Emissions above 50/s are throttled and above 100/s are dropped to prevent event storms. ' +\n            'Consider debouncing the emitter.',\n        );\n      }\n      if (counter.count > 100) {\n        // Drop the event to protect against runaway event storms.\n        return;\n      }\n    }\n\n    // Use native CustomEvent for better browser integration\n    this.dispatchEvent(\n      new CustomEvent(eventName, {\n        detail: data,\n        bubbles: false, // Global events don't need to bubble\n        cancelable: true,\n      }),\n    );\n\n    // Also trigger registered handlers\n    const eventHandlers = this.handlers[eventName];\n    if (eventHandlers) {\n      eventHandlers.forEach((handler) => {\n        try {\n          handler(data);\n        } catch (error) {\n          devError(`Error in global event handler for \"${eventName}\":`, error);\n        }\n      });\n    }\n  }\n\n  /**\n   * Register a handler for a global event. Returns an unsubscribe function.\n   * @param eventName - Name of the event\n   * @param handler - Handler function\n   */\n  on<T = unknown>(eventName: string, handler: EventHandler<T>): () => void {\n    if (!this.handlers[eventName]) {\n      this.handlers[eventName] = new Set<EventHandler<unknown>>();\n    }\n    this.handlers[eventName].add(handler as EventHandler<unknown>);\n    return () => this.off(eventName, handler);\n  }\n\n  /**\n   * Remove a specific handler for a global event.\n   * @param eventName - Name of the event\n   * @param handler - Handler function to remove\n   */\n  off<T = unknown>(eventName: string, handler: EventHandler<T>): void {\n    const eventHandlers = this.handlers[eventName];\n    if (eventHandlers) {\n      eventHandlers.delete(handler as EventHandler<unknown>);\n      // Remove the entry entirely once it is empty so stale keys don't\n      // accumulate indefinitely in long-lived apps.\n      if (eventHandlers.size === 0) {\n        delete this.handlers[eventName];\n      }\n    }\n  }\n\n  /**\n   * Remove all handlers for a specific event.\n   * @param eventName - Name of the event\n   */\n  offAll(eventName: string): void {\n    delete this.handlers[eventName];\n  }\n\n  /**\n   * Listen for a native CustomEvent. Returns an unsubscribe function.\n   * @param eventName - Name of the event\n   * @param handler - CustomEvent handler\n   * @param options - AddEventListener options\n   */\n  listen<T = unknown>(\n    eventName: string,\n    handler: (event: CustomEvent<T>) => void,\n    options?: AddEventListenerOptions,\n  ): () => void {\n    this.addEventListener(eventName, handler as EventListener, options);\n    // Use a wrapper so calling unsubscribe also removes it from nativeUnsubscribers,\n    // preventing indefinite accumulation in long-lived apps.\n    const unsubscribe: () => void = () => {\n      this.removeEventListener(eventName, handler as EventListener);\n      this.nativeUnsubscribers.delete(unsubscribe);\n    };\n    this.nativeUnsubscribers.set(unsubscribe, true);\n    return unsubscribe;\n  }\n\n  /**\n   * Register a one-time event handler (callback form).\n   * The handler is invoked exactly once, then automatically unsubscribed.\n   * @param eventName - Name of the event\n   * @param handler - Handler function\n   */\n  once<T = unknown>(eventName: string, handler: EventHandler<T>): void;\n  /**\n   * Returns a Promise that resolves with the first emission of the event\n   * (Promise form — no handler argument).\n   * @param eventName - Name of the event\n   */\n  once<T = unknown>(eventName: string): Promise<T>;\n  once<T = unknown>(\n    eventName: string,\n    handler?: EventHandler<T>,\n  ): void | Promise<T> {\n    if (handler !== undefined) {\n      // Callback form: fire-and-forget, returns void\n      const unsubscribe = this.on(eventName, (data: T) => {\n        unsubscribe();\n        handler(data);\n      });\n    } else {\n      // Promise form: resolves on first emission\n      return new Promise<T>((resolve) => {\n        const unsubscribe = this.on(eventName, (data: T) => {\n          unsubscribe();\n          resolve(data);\n        });\n      });\n    }\n  }\n\n  /**\n   * Get a list of all active event names with registered handlers.\n   */\n  getActiveEvents(): string[] {\n    return Object.keys(this.handlers).filter(\n      (eventName) =>\n        this.handlers[eventName] && this.handlers[eventName].size > 0,\n    );\n  }\n\n  /**\n   * Clear all event handlers and native EventTarget listeners (useful for testing or cleanup).\n   */\n  clear(): void {\n    this.handlers = {};\n    const toCleanup = Array.from(this.nativeUnsubscribers.keys());\n    this.nativeUnsubscribers.clear();\n    for (const unsubscribe of toCleanup) {\n      unsubscribe();\n    }\n  }\n\n  /**\n   * Get the number of handlers registered for a specific event.\n   * @param eventName - Name of the event\n   */\n  getHandlerCount(eventName: string): number {\n    return this.handlers[eventName]?.size || 0;\n  }\n\n  /**\n   * Get event statistics for debugging.\n   */\n  getEventStats(): Record<string, { count: number; handlersCount: number }> {\n    const stats: Record<string, { count: number; handlersCount: number }> = {};\n    for (const [eventName, counter] of this.eventCounters.entries()) {\n      stats[eventName] = {\n        count: counter.count,\n        handlersCount: this.getHandlerCount(eventName),\n      };\n    }\n    return stats;\n  }\n\n  /**\n   * Reset event counters (useful for testing or after resolving issues).\n   */\n  resetEventCounters(): void {\n    this.eventCounters.clear();\n  }\n}\n\n/**\n * Singleton instance of the global event bus\n */\n/**\n * Lazily-instantiated event bus.\n *\n * We preserve the `eventBus` export for backward compatibility but avoid\n * creating the underlying GlobalEventBus instance at module import time.\n * A small proxy defers the call to `GlobalEventBus.getInstance()` until a\n * property is accessed. This reduces import-time side-effects and helps\n * bundlers tree-shake unused entrypoints.\n */\nexport const eventBus = new Proxy(\n  {},\n  {\n    get(_target, prop: PropertyKey) {\n      const inst = GlobalEventBus.getInstance();\n      const val = (inst as unknown as Record<PropertyKey, unknown>)[prop];\n      // If the property is a function (method), bind it to the instance\n      // so callers using `eventBus.method(...)` get the correct `this`.\n      if (typeof val === 'function')\n        return (val as (...args: unknown[]) => unknown).bind(inst);\n      return val;\n    },\n    apply() {\n      throw new TypeError('eventBus is not a callable function');\n    },\n  },\n) as unknown as GlobalEventBus;\n\n/**\n * Emit a global event\n */\nexport const emit = <T = unknown>(eventName: string, data?: T) =>\n  eventBus.emit(eventName, data);\n\n/**\n * Register a handler for a global event\n */\nexport const on = <T = unknown>(eventName: string, handler: EventHandler<T>) =>\n  eventBus.on(eventName, handler);\n\n/**\n * Remove a handler for a global event\n */\nexport const off = <T = unknown>(eventName: string, handler: EventHandler<T>) =>\n  eventBus.off(eventName, handler);\n\n/**\n * Register a one-time handler for a global event (callback form).\n * The handler fires once then auto-unsubscribes.\n */\nexport function once<T = unknown>(\n  eventName: string,\n  handler: EventHandler<T>,\n): void;\n/**\n * Returns a Promise that resolves with the next emission of the event\n * (Promise form — no handler argument needed).\n */\nexport function once<T = unknown>(eventName: string): Promise<T>;\nexport function once<T = unknown>(\n  eventName: string,\n  handler?: EventHandler<T>,\n): void | Promise<T> {\n  if (handler !== undefined) {\n    return eventBus.once(eventName, handler);\n  }\n  return eventBus.once<T>(eventName);\n}\n\n/**\n * Listen for a native CustomEvent\n */\nexport const listen = <T = unknown>(\n  eventName: string,\n  handler: (event: CustomEvent<T>) => void,\n  options?: AddEventListenerOptions,\n) => eventBus.listen(eventName, handler, options);\n"],"mappings":"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"}

package/dist/custom-elements-runtime.jit-css.cjs.js

@@ -1,3 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./hooks-fYQgZk2g.cjs"),e=require("./style-Bjn8zDiZ.cjs");function o(r){if(s.isDiscoveryRender$1())return;const t=s.getCurrentComponentContext()?._host?.shadowRoot??null;t?e.registerJITCSSComponent(t,r):e.enableJITCSS(r)}function a(r){return r}exports.cls=a;exports.colors=e.colors;exports.containerVariants=e.containerVariants;exports.disableJITCSS=e.disableJITCSS;exports.enableJITCSS=e.enableJITCSS;exports.extractClassesFromHTML=e.extractClassesFromHTML;exports.getJITCSSOptions=e.getJITCSSOptions;exports.isJITCSSEnabled=e.isJITCSSEnabled;exports.isJITCSSEnabledFor=e.isJITCSSEnabledFor;exports.jitCSS=e.jitCSS;exports.mediaVariants=e.mediaVariants;exports.parseArbitrary=e.parseArbitrary;exports.parseColorClass=e.parseColorClass;exports.parseColorWithOpacity=e.parseColorWithOpacity;exports.parseGradientColorStop=e.parseGradientColorStop;exports.parseSpacing=e.parseSpacing;exports.registerJITCSSComponent=e.registerJITCSSComponent;exports.selectorVariants=e.selectorVariants;exports.useDesignTokens=s.useDesignTokens;exports.useGlobalStyle=s.useGlobalStyle;exports.useJITCSS=o;exports.utilityMap=e.utilityMap;
-
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./helpers-DcEpRwq5.cjs`),t=require(`./hooks-CNfugc95.cjs`),n=require(`./style-A8l3aQ52.cjs`);function r(r){if(e.w())return;let i=t.i()?._host?.shadowRoot??null;i?n.g(i,r):n.i(r)}function i(e){return e}exports.cls=i,exports.colors=n.t,exports.containerVariants=n.n,exports.disableJITCSS=n.r,exports.enableJITCSS=n.i,exports.extractClassesFromHTML=n.a,exports.getJITCSSOptions=n.o,exports.isJITCSSEnabled=n.s,exports.isJITCSSEnabledFor=n.c,exports.jitCSS=n.l,exports.mediaVariants=n.u,exports.parseArbitrary=n.d,exports.parseColorClass=n.f,exports.parseColorWithOpacity=n.p,exports.parseGradientColorStop=n.m,exports.parseSpacing=n.h,exports.registerJITCSSComponent=n.g,exports.selectorVariants=n._,exports.useDesignTokens=t.l,exports.useGlobalStyle=t.f,exports.useJITCSS=r,exports.utilityMap=n.v;
 //# sourceMappingURL=custom-elements-runtime.jit-css.cjs.js.map

package/dist/custom-elements-runtime.jit-css.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-elements-runtime.jit-css.cjs.js","names":[],"sources":["../src/lib/runtime/jit-hooks.ts","../src/lib/jit-css.ts"],"sourcesContent":["/**\n * JIT CSS hooks — lives in a separate module so that hooks.ts does not\n * statically import style.ts. Consumers who never call `useJITCSS` will\n * have the entire JIT engine tree-shaken out of their bundle.\n */\n\nimport { isDiscoveryRender as _isDiscoveryRenderFn } from './discovery-state';\nimport { getCurrentComponentContext } from './hooks';\nimport {\n  enableJITCSS,\n  registerJITCSSComponent,\n  type JITCSSOptions,\n} from './style';\n\n/**\n * Configure the JIT CSS engine for the current session.\n * This is a convenience wrapper around `enableJITCSS()` that can be called\n * inside a component render function or at module initialisation time.\n *\n * @example\n * ```ts\n * component('my-component', () => {\n *   // Enable extended Tailwind colors so bg-blue-500, text-violet-700, etc. generate CSS\n *   useJITCSS({ extendedColors: true });\n *   return html`<div class=\"bg-blue-500 text-white\">Hello</div>`;\n * });\n * ```\n *\n * @example\n * ```ts\n * // At app entry – enable once for all components\n * useJITCSS({ extendedColors: true, customColors: { brand: { '500': '#e63946' } } });\n * ```\n */\nexport function useJITCSS(options?: JITCSSOptions): void {\n  // During discovery renders (component registration phase) there is no real\n  // shadow root. Without this guard, useJITCSS() falls through to\n  // enableJITCSS() and globally enables JIT CSS for every component — exactly\n  // the opt-in behaviour we are trying to prevent.\n  if (_isDiscoveryRenderFn()) return;\n\n  // When called inside a component render function, register this component's\n  // shadow root for per-component JIT CSS opt-in. Context is always set during\n  // a real render; it may be absent (null) or missing _host when called at app\n  // startup level (outside any component context).\n  const host = (getCurrentComponentContext() as { _host?: Element } | null)\n    ?._host;\n  const shadowRoot = host?.shadowRoot ?? null;\n\n  if (shadowRoot) {\n    // Per-component opt-in: register this shadow root only.\n    registerJITCSSComponent(shadowRoot, options);\n  } else {\n    // App-level call (outside component context) — enable for all components\n    // globally, preserving v2 behaviour when called at the entry point.\n    enableJITCSS(options);\n  }\n}\n\nexport type { JITCSSOptions };\n","/**\n * JIT CSS entry point — opt-in import for the full JIT CSS engine.\n *\n * @example\n * ```ts\n * import {\n *   useJITCSS,\n *   enableJITCSS,\n * } from '@jasonshimmy/custom-elements-runtime/jit-css';\n * ```\n */\n\n// Hooks\nexport { useJITCSS } from './runtime/jit-hooks';\nexport { useDesignTokens, useGlobalStyle } from './runtime/hooks';\nexport type { JITCSSOptions, DesignTokens } from './runtime/hooks';\n\n// Global configuration\nexport {\n  enableJITCSS,\n  disableJITCSS,\n  isJITCSSEnabled,\n  isJITCSSEnabledFor,\n  registerJITCSSComponent,\n  getJITCSSOptions,\n  jitCSS,\n  extractClassesFromHTML,\n  parseColorClass,\n  parseColorWithOpacity,\n  parseGradientColorStop,\n  parseSpacing,\n  parseArbitrary,\n  utilityMap,\n  selectorVariants,\n  mediaVariants,\n  containerVariants,\n  colors,\n} from './runtime/style';\n\n/**\n * A no-op identity function that signals to development tools (IDE\n * autocomplete, linters, PurgeCSS-style scanners) that the string contains\n * JIT CSS utility class names.\n *\n * At runtime this is simply `return className` — zero overhead.\n *\n * @example\n * ```ts\n * import { cls } from '@jasonshimmy/custom-elements-runtime/jit-css';\n *\n * const containerClasses = cls('flex items-center gap-4 bg-primary-500 text-white');\n * ```\n */\nexport function cls(className: string): string {\n  return className;\n}\n"],"mappings":"6IAkCA,SAAgB,EAAU,EAA+B,CAKvD,GAAI,EAAA,oBAAA,EAAwB,OAQ5B,MAAM,EAFQ,EAAA,2BAAA,GACV,OACqB,YAAc,KAEnC,EAEF,EAAA,wBAAwB,EAAY,CAAA,EAIpC,EAAA,aAAa,CAAA,ECFjB,SAAgB,EAAI,EAA2B,CAC7C,OAAO"}
+{"version":3,"file":"custom-elements-runtime.jit-css.cjs.js","names":[],"sources":["../src/lib/runtime/jit-hooks.ts","../src/lib/jit-css.ts"],"sourcesContent":["/**\n * JIT CSS hooks — lives in a separate module so that hooks.ts does not\n * statically import style.ts. Consumers who never call `useJITCSS` will\n * have the entire JIT engine tree-shaken out of their bundle.\n */\n\nimport { isDiscoveryRender as _isDiscoveryRenderFn } from './discovery-state';\nimport { getCurrentComponentContext } from './hooks';\nimport {\n  enableJITCSS,\n  registerJITCSSComponent,\n  type JITCSSOptions,\n} from './style';\n\n/**\n * Configure the JIT CSS engine for the current session.\n * This is a convenience wrapper around `enableJITCSS()` that can be called\n * inside a component render function or at module initialisation time.\n *\n * @example\n * ```ts\n * component('my-component', () => {\n *   // Enable extended Tailwind colors so bg-blue-500, text-violet-700, etc. generate CSS\n *   useJITCSS({ extendedColors: true });\n *   return html`<div class=\"bg-blue-500 text-white\">Hello</div>`;\n * });\n * ```\n *\n * @example\n * ```ts\n * // At app entry – enable once for all components\n * useJITCSS({ extendedColors: true, customColors: { brand: { '500': '#e63946' } } });\n * ```\n */\nexport function useJITCSS(options?: JITCSSOptions): void {\n  // During discovery renders (component registration phase) there is no real\n  // shadow root. Without this guard, useJITCSS() falls through to\n  // enableJITCSS() and globally enables JIT CSS for every component — exactly\n  // the opt-in behaviour we are trying to prevent.\n  if (_isDiscoveryRenderFn()) return;\n\n  // When called inside a component render function, register this component's\n  // shadow root for per-component JIT CSS opt-in. Context is always set during\n  // a real render; it may be absent (null) or missing _host when called at app\n  // startup level (outside any component context).\n  const host = (getCurrentComponentContext() as { _host?: Element } | null)\n    ?._host;\n  const shadowRoot = host?.shadowRoot ?? null;\n\n  if (shadowRoot) {\n    // Per-component opt-in: register this shadow root only.\n    registerJITCSSComponent(shadowRoot, options);\n  } else {\n    // App-level call (outside component context) — enable for all components\n    // globally, preserving v2 behaviour when called at the entry point.\n    enableJITCSS(options);\n  }\n}\n\nexport type { JITCSSOptions };\n","/**\n * JIT CSS entry point — opt-in import for the full JIT CSS engine.\n *\n * @example\n * ```ts\n * import {\n *   useJITCSS,\n *   enableJITCSS,\n * } from '@jasonshimmy/custom-elements-runtime/jit-css';\n * ```\n */\n\n// Hooks\nexport { useJITCSS } from './runtime/jit-hooks';\nexport { useDesignTokens, useGlobalStyle } from './runtime/hooks';\nexport type { JITCSSOptions, DesignTokens } from './runtime/hooks';\n\n// Global configuration\nexport {\n  enableJITCSS,\n  disableJITCSS,\n  isJITCSSEnabled,\n  isJITCSSEnabledFor,\n  registerJITCSSComponent,\n  getJITCSSOptions,\n  jitCSS,\n  extractClassesFromHTML,\n  parseColorClass,\n  parseColorWithOpacity,\n  parseGradientColorStop,\n  parseSpacing,\n  parseArbitrary,\n  utilityMap,\n  selectorVariants,\n  mediaVariants,\n  containerVariants,\n  colors,\n} from './runtime/style';\n\n/**\n * A no-op identity function that signals to development tools (IDE\n * autocomplete, linters, PurgeCSS-style scanners) that the string contains\n * JIT CSS utility class names.\n *\n * At runtime this is simply `return className` — zero overhead.\n *\n * @example\n * ```ts\n * import { cls } from '@jasonshimmy/custom-elements-runtime/jit-css';\n *\n * const containerClasses = cls('flex items-center gap-4 bg-primary-500 text-white');\n * ```\n */\nexport function cls(className: string): string {\n  return className;\n}\n"],"mappings":"iLAkCA,SAAgB,EAAU,EAA+B,CAKvD,GAAI,EAAA,GAAsB,CAAE,OAQ5B,IAAM,EAFQ,EAAA,GAA4B,EACtC,OACqB,YAAc,KAEnC,EAEF,EAAA,EAAwB,EAAY,EAAQ,CAI5C,EAAA,EAAa,EAAQ,CCFzB,SAAgB,EAAI,EAA2B,CAC7C,OAAO"}