@alfadocs/ui-kit-debug 0.68.0 → 0.70.0

package/dist/_chunks/{recaptcha-widget-BCNHsgqt.js → recaptcha-widget-BC-4To9b.js}

@@ -3,9 +3,12 @@ import { forwardRef as U, useRef as m, useState as q, useEffect as C, useMemo as
 import { useTranslation as Q } from "react-i18next";
 import { u as X } from "./form-field-context-B3APVHKx.js";
 import { u as Y } from "./use-theme-CAuo6EYT.js";
-import { u as Z } from "./registry-nPAVE19X.js";
+import { u as Z } from "./registry-DvAUVLHh.js";
 const z = {
   id: "recaptcha-widget",
+  // `submit` is the pre-form-submission gate: the `execute` action issues a
+  // verification token to Google's reCAPTCHA service (the catalog's heuristic
+  // does not recognise `execute` as a submit verb, but it genuinely backs it).
   capabilities: ["submit"],
   state: {
     hasToken: {
@@ -17,7 +20,9 @@ const z = {
   },
   actions: {
     execute: {
+      // Triggers the challenge against Google's reCAPTCHA service — external side effect.
       safety: "write",
+      openWorld: !0,
       descriptionKey: "ui.agent.recaptchaWidget.actions.execute",
       description: "Programmatically trigger the captcha challenge. Issues a token via the callback.",
       invoke: (t) => {
@@ -25,7 +30,9 @@ const z = {
       }
     },
     reset: {
+      // Discards the issued token and re-rolls the challenge — loses the verification.
       safety: "destructive",
+      idempotent: !0,
       descriptionKey: "ui.agent.recaptchaWidget.actions.reset",
       description: "Clear the current token and re-roll the captcha. Irreversible.",
       invoke: (t) => {
@@ -218,4 +225,4 @@ export {
   ae as R,
   z as r
 };
-//# sourceMappingURL=recaptcha-widget-BCNHsgqt.js.map
+//# sourceMappingURL=recaptcha-widget-BC-4To9b.js.map

package/dist/_chunks/recaptcha-widget-BC-4To9b.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recaptcha-widget-BC-4To9b.js","sources":["../../src/components/recaptcha-widget/recaptcha-widget.agent.ts","../../src/components/recaptcha-widget/recaptcha-widget.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — RecaptchaWidget.                                       */\n/*                                                                        */\n/* Recaptcha already exposes a curated `RecaptchaWidgetHandle` via        */\n/* useImperativeHandle. The adapter wires `execute` (issue token, write)  */\n/* and `reset` (clear token, destructive) into that existing handle.      */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { RecaptchaWidgetHandle } from './recaptcha-widget';\n\nexport const recaptchaWidgetAgent: AgentAdapter<RecaptchaWidgetHandle> = {\n  id: 'recaptcha-widget',\n  // `submit` is the pre-form-submission gate: the `execute` action issues a\n  // verification token to Google's reCAPTCHA service (the catalog's heuristic\n  // does not recognise `execute` as a submit verb, but it genuinely backs it).\n  capabilities: ['submit'],\n  state: {\n    hasToken: {\n      type: 'boolean',\n      descriptionKey: 'ui.agent.recaptchaWidget.state.hasToken',\n      description:\n        'True when the widget currently holds a valid verification token.',\n      read: (handle) => handle.getResponse().length > 0,\n    },\n  },\n  actions: {\n    execute: {\n      // Triggers the challenge against Google's reCAPTCHA service — external side effect.\n      safety: 'write',\n      openWorld: true,\n      descriptionKey: 'ui.agent.recaptchaWidget.actions.execute',\n      description:\n        'Programmatically trigger the captcha challenge. Issues a token via the callback.',\n      invoke: (handle) => {\n        handle.execute();\n      },\n    },\n    reset: {\n      // Discards the issued token and re-rolls the challenge — loses the verification.\n      safety: 'destructive',\n      idempotent: true,\n      descriptionKey: 'ui.agent.recaptchaWidget.actions.reset',\n      description:\n        'Clear the current token and re-roll the captcha. Irreversible.',\n      invoke: (handle) => {\n        handle.reset();\n      },\n    },\n  },\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'recaptcha-widget',\n      description: 'Marks the RecaptchaWidget wrapper.',\n    },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description:\n        'Sourced from the id prop (or the surrounding FormField id).',\n    },\n  },\n};\n","import {\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { useTranslation } from 'react-i18next';\nimport { useFormField } from '../form-field/form-field-context';\nimport { useTheme } from '../../hooks';\nimport { useAgentRegistration } from '../../agent/registry';\nimport { recaptchaWidgetAgent } from './recaptcha-widget.agent';\n\n/* ------------------------------------------------------------------ */\n/* Loader — idempotent across instances                                */\n/* ------------------------------------------------------------------ */\n\n/**\n * Google reCAPTCHA v2 ships as a global `grecaptcha` object loaded from\n * `https://www.google.com/recaptcha/api.js`. We lazy-load the script\n * once per page using a shared promise so N widgets on the same form\n * (or N renders of a single widget) all wait on the same fetch.\n *\n * The `?render=explicit` query parameter is required so we control\n * when each widget mounts via `grecaptcha.render`, rather than letting\n * the global auto-bind to every `.g-recaptcha` div on the page.\n */\nconst SCRIPT_SRC = 'https://www.google.com/recaptcha/api.js';\nconst SCRIPT_ID = 'alfadocs-ui-recaptcha-loader';\nconst FOREIGN_LOADER_GRACE_MS = 10_000;\nconst POLL_INTERVAL_MS = 100;\n\ninterface RecaptchaApi {\n  render: (\n    container: HTMLElement,\n    parameters: {\n      sitekey: string;\n      theme?: 'light' | 'dark';\n      size?: 'normal' | 'compact' | 'invisible';\n      hl?: string;\n      callback?: (token: string) => void;\n      'expired-callback'?: () => void;\n      'error-callback'?: () => void;\n    },\n  ) => number;\n  reset: (widgetId?: number) => void;\n  getResponse: (widgetId?: number) => string;\n  execute: (widgetId?: number) => void;\n}\n\ndeclare global {\n  interface Window {\n    grecaptcha?: RecaptchaApi;\n    ___grecaptchaOnLoad___?: () => void;\n  }\n}\n\nlet loaderPromise: Promise<RecaptchaApi> | null = null;\n\nfunction loadRecaptcha(hl: string | undefined): Promise<RecaptchaApi> {\n  if (typeof window === 'undefined') {\n    return Promise.reject(new Error('recaptcha: window is not available'));\n  }\n  if (window.grecaptcha && typeof window.grecaptcha.render === 'function') {\n    return Promise.resolve(window.grecaptcha);\n  }\n  if (loaderPromise) {\n    return loaderPromise;\n  }\n\n  loaderPromise = new Promise<RecaptchaApi>((resolve, reject) => {\n    const existing = document.getElementById(\n      SCRIPT_ID,\n    ) as HTMLScriptElement | null;\n\n    const onReady = () => {\n      if (window.grecaptcha && typeof window.grecaptcha.render === 'function') {\n        resolve(window.grecaptcha);\n      } else {\n        reject(new Error('recaptcha: grecaptcha global missing after load'));\n      }\n    };\n\n    window.___grecaptchaOnLoad___ = onReady;\n\n    if (existing) {\n      // Foreign loader present (e.g. host page already injected\n      // api.js without ?onload=). Poll for grecaptcha; if it never\n      // arrives, inject our own redundant loader with a fresh onload.\n      let pollHandle: ReturnType<typeof setInterval> | null = null;\n      let timeoutHandle: ReturnType<typeof setTimeout> | null = null;\n      const clearTimers = () => {\n        if (pollHandle !== null) clearInterval(pollHandle);\n        if (timeoutHandle !== null) clearTimeout(timeoutHandle);\n        pollHandle = null;\n        timeoutHandle = null;\n      };\n      pollHandle = setInterval(() => {\n        if (\n          window.grecaptcha &&\n          typeof window.grecaptcha.render === 'function'\n        ) {\n          clearTimers();\n          resolve(window.grecaptcha);\n        }\n      }, POLL_INTERVAL_MS);\n      timeoutHandle = setTimeout(() => {\n        clearTimers();\n        if (\n          window.grecaptcha &&\n          typeof window.grecaptcha.render === 'function'\n        ) {\n          resolve(window.grecaptcha);\n          return;\n        }\n        // Foreign loader didn't deliver in time — inject our own.\n        const fallbackCb = `___grecaptchaOnLoad___fallback_${Date.now()}___`;\n        (window as unknown as Record<string, () => void>)[fallbackCb] = () => {\n          delete (window as unknown as Record<string, () => void>)[fallbackCb];\n          if (\n            window.grecaptcha &&\n            typeof window.grecaptcha.render === 'function'\n          ) {\n            resolve(window.grecaptcha);\n          } else {\n            reject(\n              new Error('recaptcha: grecaptcha global missing after fallback'),\n            );\n          }\n        };\n        const fallbackParams = new URLSearchParams({\n          onload: fallbackCb,\n          render: 'explicit',\n        });\n        if (hl) fallbackParams.set('hl', hl);\n        const fallbackScript = document.createElement('script');\n        fallbackScript.src = `${SCRIPT_SRC}?${fallbackParams.toString()}`;\n        fallbackScript.async = true;\n        fallbackScript.defer = true;\n        fallbackScript.onerror = () => {\n          delete (window as unknown as Record<string, () => void>)[fallbackCb];\n          loaderPromise = null;\n          reject(new Error('recaptcha: fallback script failed to load'));\n        };\n        document.head.appendChild(fallbackScript);\n      }, FOREIGN_LOADER_GRACE_MS);\n      return;\n    }\n\n    const params = new URLSearchParams({\n      onload: '___grecaptchaOnLoad___',\n      render: 'explicit',\n    });\n    if (hl) params.set('hl', hl);\n\n    const script = document.createElement('script');\n    script.id = SCRIPT_ID;\n    script.src = `${SCRIPT_SRC}?${params.toString()}`;\n    script.async = true;\n    script.defer = true;\n    script.onerror = () => {\n      loaderPromise = null;\n      reject(new Error('recaptcha: script failed to load'));\n    };\n    document.head.appendChild(script);\n  });\n\n  return loaderPromise;\n}\n\n/* ------------------------------------------------------------------ */\n/* Public API                                                          */\n/* ------------------------------------------------------------------ */\n\nexport interface RecaptchaWidgetHandle {\n  /** Re-roll the captcha — clears the response token. */\n  reset: () => void;\n  /** Returns the current response token, or empty string when unsolved. */\n  getResponse: () => string;\n  /** Programmatically trigger an invisible captcha challenge. */\n  execute: () => void;\n}\n\nexport interface RecaptchaWidgetProps {\n  /** Google reCAPTCHA v2 site key. Required. */\n  siteKey: string;\n  /**\n   * Visual theme. Defaults to the resolved DS theme (`useTheme`).\n   * Pass `'light'` / `'dark'` to force.\n   */\n  theme?: 'light' | 'dark';\n  /** Two-letter locale hint. Defaults to the current i18next language. */\n  locale?: string;\n  /** Widget size. */\n  size?: 'normal' | 'compact' | 'invisible';\n  /** Called with the verification token, or `null` when expired/reset. */\n  onChange?: (token: string | null) => void;\n  /** Called when the user solves but the token then times out. */\n  onExpired?: () => void;\n  /** Called when the script or challenge errors out. */\n  onError?: () => void;\n  /** Error message — wires aria-describedby + announces via the live region. */\n  error?: string;\n  /** Override the DOM id; defaults to the surrounding FormField id. */\n  id?: string;\n  /** Extra class names on the wrapper. */\n  className?: string;\n}\n\n/* ------------------------------------------------------------------ */\n/* Component                                                            */\n/* ------------------------------------------------------------------ */\n\nexport const RecaptchaWidget = forwardRef<\n  RecaptchaWidgetHandle,\n  RecaptchaWidgetProps\n>(function RecaptchaWidget(\n  {\n    siteKey,\n    theme,\n    locale,\n    size = 'normal',\n    onChange,\n    onExpired,\n    onError,\n    error,\n    id,\n    className,\n  },\n  ref,\n) {\n  const { t, i18n } = useTranslation();\n  const formField = useFormField();\n  const { resolvedTheme } = useTheme();\n\n  const containerRef = useRef<HTMLDivElement | null>(null);\n  const widgetIdRef = useRef<number | null>(null);\n  const apiRef = useRef<RecaptchaApi | null>(null);\n  const [statusMessage, setStatusMessage] = useState<string>('');\n\n  const wrapperId = id ?? formField.id;\n  const errorId = error ? `${wrapperId}-error` : undefined;\n  const describedBy =\n    [formField.describedBy, errorId].filter(Boolean).join(' ') || undefined;\n\n  // Mirror the DS theme into reCAPTCHA's two-tone setting.\n  const effectiveTheme: 'light' | 'dark' =\n    theme ?? (resolvedTheme.startsWith('dark') ? 'dark' : 'light');\n  const effectiveLocale = locale ?? i18n.language;\n\n  // Stable callbacks via refs so we don't re-render the widget on\n  // every parent state change.\n  const onChangeRef = useRef(onChange);\n  const onExpiredRef = useRef(onExpired);\n  const onErrorRef = useRef(onError);\n  onChangeRef.current = onChange;\n  onExpiredRef.current = onExpired;\n  onErrorRef.current = onError;\n\n  const expiredLabel = t(\n    'inputs.recaptcha.expired',\n    'Verification expired — please retry.',\n  );\n  const errorLabel = t(\n    'inputs.recaptcha.error',\n    'Verification failed — please retry.',\n  );\n\n  useEffect(() => {\n    if (!siteKey || !containerRef.current) return;\n    let cancelled = false;\n\n    loadRecaptcha(effectiveLocale)\n      .then((api) => {\n        if (cancelled || !containerRef.current) return;\n        apiRef.current = api;\n        widgetIdRef.current = api.render(containerRef.current, {\n          sitekey: siteKey,\n          theme: effectiveTheme,\n          size,\n          hl: effectiveLocale,\n          callback: (token) => {\n            setStatusMessage('');\n            onChangeRef.current?.(token);\n          },\n          'expired-callback': () => {\n            setStatusMessage(expiredLabel);\n            onChangeRef.current?.(null);\n            onExpiredRef.current?.();\n          },\n          'error-callback': () => {\n            setStatusMessage(errorLabel);\n            onChangeRef.current?.(null);\n            onErrorRef.current?.();\n          },\n        });\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setStatusMessage(errorLabel);\n        onErrorRef.current?.();\n      });\n\n    return () => {\n      cancelled = true;\n      // grecaptcha has no public destroy. The shared script stays\n      // loaded; we reset the widget so its iframe stops listening.\n      if (apiRef.current && widgetIdRef.current !== null) {\n        try {\n          apiRef.current.reset(widgetIdRef.current);\n        } catch {\n          /* widget id may already be invalid — safe to ignore. */\n        }\n      }\n    };\n    // Re-render the widget when the underlying configuration changes.\n  }, [\n    siteKey,\n    effectiveTheme,\n    effectiveLocale,\n    size,\n    expiredLabel,\n    errorLabel,\n  ]);\n\n  const agentHandle = useMemo<RecaptchaWidgetHandle>(\n    () => ({\n      reset: () => {\n        if (apiRef.current && widgetIdRef.current !== null) {\n          apiRef.current.reset(widgetIdRef.current);\n          setStatusMessage('');\n          onChangeRef.current?.(null);\n        }\n      },\n      getResponse: () => {\n        if (apiRef.current && widgetIdRef.current !== null) {\n          return apiRef.current.getResponse(widgetIdRef.current);\n        }\n        return '';\n      },\n      execute: () => {\n        if (apiRef.current && widgetIdRef.current !== null) {\n          apiRef.current.execute(widgetIdRef.current);\n        }\n      },\n    }),\n    [],\n  );\n  useImperativeHandle(ref, () => agentHandle, [agentHandle]);\n  useAgentRegistration(recaptchaWidgetAgent, agentHandle, wrapperId);\n\n  const liveMessage = error || statusMessage;\n  // For invisible widgets the iframe is offscreen, so we mark the\n  // wrapper as a non-visual badge. Otherwise the wrapper just hosts\n  // the rendered iframe and contributes no interactive role itself.\n  const wrapperRole = size === 'invisible' ? 'presentation' : undefined;\n\n  return (\n    <div\n      className={[\n        'ds:inline-block',\n        // Keep the iframe inside the wrapper's stacking context so\n        // popovers etc. above the form continue to overlay correctly.\n        'ds:relative ds:isolate',\n        className,\n      ]\n        .filter(Boolean)\n        .join(' ')}\n      data-component=\"recaptcha-widget\"\n      data-component-id={wrapperId}\n      data-size={size}\n      role={wrapperRole}\n    >\n      <div\n        ref={containerRef}\n        id={wrapperId}\n        // The class name is the canonical hook Google's verifier\n        // looks for when the page form is submitted server-side. Some\n        // Symfony / Laravel validators short-circuit when this class\n        // is missing, so we render it even though we're using\n        // grecaptcha.render explicitly.\n        className=\"g-recaptcha\"\n        data-sitekey={siteKey}\n        data-theme={effectiveTheme}\n        data-size={size}\n        aria-describedby={describedBy}\n        aria-invalid={error || formField.invalid ? true : undefined}\n      />\n      {/* Live announcement for expired / error states. Empty when the\n          widget is healthy so SR users aren't spammed. */}\n      <div\n        role=\"status\"\n        aria-live=\"polite\"\n        aria-atomic=\"true\"\n        className=\"ds:sr-only\"\n      >\n        {liveMessage}\n      </div>\n    </div>\n  );\n});\n\nRecaptchaWidget.displayName = 'RecaptchaWidget';\n"],"names":["recaptchaWidgetAgent","handle","SCRIPT_SRC","SCRIPT_ID","FOREIGN_LOADER_GRACE_MS","POLL_INTERVAL_MS","loaderPromise","loadRecaptcha","hl","resolve","reject","existing","onReady","pollHandle","timeoutHandle","clearTimers","fallbackCb","fallbackParams","fallbackScript","params","script","RecaptchaWidget","forwardRef","siteKey","theme","locale","size","onChange","onExpired","onError","error","id","className","ref","t","i18n","useTranslation","formField","useFormField","resolvedTheme","useTheme","containerRef","useRef","widgetIdRef","apiRef","statusMessage","setStatusMessage","useState","wrapperId","errorId","describedBy","effectiveTheme","effectiveLocale","onChangeRef","onExpiredRef","onErrorRef","expiredLabel","errorLabel","useEffect","cancelled","api","token","_a","_b","agentHandle","useMemo","useImperativeHandle","useAgentRegistration","liveMessage","wrapperRole","jsxs","jsx"],"mappings":"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"}

package/dist/_chunks/registry-DvAUVLHh.js

@@ -0,0 +1,51 @@
+import { useEffect as u } from "react";
+function c() {
+  const s = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Set(), r = (e, t) => `${e}\0${t}`, i = (e) => {
+    for (const t of n) t(e);
+  };
+  return {
+    register(e) {
+      s.set(r(e.id, e.instanceId), e), i({
+        type: "register",
+        id: e.id,
+        instanceId: e.instanceId
+      });
+    },
+    unregister(e, t) {
+      s.delete(r(e, t)) && i({ type: "unregister", id: e, instanceId: t });
+    },
+    get(e, t) {
+      return s.get(r(e, t));
+    },
+    list(e) {
+      const t = [...s.values()];
+      return e ? t.filter((o) => o.id === e) : t;
+    },
+    subscribe(e) {
+      return n.add(e), () => {
+        n.delete(e);
+      };
+    }
+  };
+}
+function f(s, n, r) {
+  u(() => {
+    if (typeof globalThis > "u") return;
+    const e = globalThis.__alfadocs_agent;
+    if (!e || !r || n == null) return;
+    const t = {
+      id: s.id,
+      instanceId: r,
+      handle: n,
+      adapter: s
+    };
+    return e.register(t), () => {
+      e.unregister(s.id, r);
+    };
+  }, [s, n, r]);
+}
+export {
+  c,
+  f as u
+};
+//# sourceMappingURL=registry-DvAUVLHh.js.map

package/dist/_chunks/registry-DvAUVLHh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-DvAUVLHh.js","sources":["../../src/agent/registry.ts"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent runtime registry — interface only.                               */\n/*                                                                        */\n/* The kit declares the registry shape and a no-op subscription hook.     */\n/* The platform-side UI bridge mounts the actual registry at app root and */\n/* consumes the registrations to drive components from a future MCP       */\n/* server. With no registry mounted, `useAgentRegistration` is a no-op.   */\n/* -------------------------------------------------------------------- */\n\nimport { useEffect } from 'react';\nimport type { AgentAdapter } from './types';\n\nexport interface AgentRegistration<THandle = unknown> {\n  id: string;\n  instanceId: string;\n  handle: THandle;\n  adapter: AgentAdapter<THandle>;\n}\n\nexport interface AgentRegistry {\n  register: (registration: AgentRegistration) => void;\n  unregister: (id: string, instanceId: string) => void;\n  /** Resolve a single live registration by `(adapter id, instance id)`. */\n  get: (id: string, instanceId: string) => AgentRegistration | undefined;\n  /**\n   * Snapshot every currently-mounted registration. Optionally filter by\n   * adapter id (e.g. `list('data-table')` → all live tables). The MCP UI\n   * bridge uses this to answer \"which instances exist right now?\".\n   */\n  list: (id?: string) => AgentRegistration[];\n  /**\n   * Observe mount/unmount events. Returns an unsubscribe function. Fires after\n   * the registry has applied the change, so a `list()` inside the listener\n   * reflects the new state.\n   */\n  subscribe: (listener: (event: AgentRegistryEvent) => void) => () => void;\n}\n\n/** Emitted by {@link AgentRegistry.subscribe} whenever the registry changes. */\nexport interface AgentRegistryEvent {\n  type: 'register' | 'unregister';\n  id: string;\n  instanceId: string;\n}\n\n/**\n * Reference implementation of {@link AgentRegistry}. The kit ships this so the\n * platform's MCP UI bridge can mount a working registry with one line:\n *\n * ```ts\n * (globalThis as { __alfadocs_agent?: AgentRegistry }).__alfadocs_agent =\n *   createAgentRegistry();\n * ```\n *\n * It keeps a `(id, instanceId)` keyed map and a listener set; it has no React\n * or DOM dependency, so a host can also drive it from a worker or test.\n */\nexport function createAgentRegistry(): AgentRegistry {\n  const slots = new Map<string, AgentRegistration>();\n  const listeners = new Set<(event: AgentRegistryEvent) => void>();\n  const key = (id: string, instanceId: string) => `${id}\u0000${instanceId}`;\n\n  const emit = (event: AgentRegistryEvent) => {\n    for (const listener of listeners) listener(event);\n  };\n\n  return {\n    register(registration) {\n      slots.set(key(registration.id, registration.instanceId), registration);\n      emit({\n        type: 'register',\n        id: registration.id,\n        instanceId: registration.instanceId,\n      });\n    },\n    unregister(id, instanceId) {\n      if (slots.delete(key(id, instanceId))) {\n        emit({ type: 'unregister', id, instanceId });\n      }\n    },\n    get(id, instanceId) {\n      return slots.get(key(id, instanceId));\n    },\n    list(id) {\n      const all = [...slots.values()];\n      return id ? all.filter((r) => r.id === id) : all;\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\n// Local type for the registry slot — avoids `declare global` leaking\n// into consumer Window types via the published .d.ts bundle.\ntype AgentGlobal = { __alfadocs_agent?: AgentRegistry };\n\n/**\n * Register a live component instance with the host agent registry, if one\n * is mounted. No-op when `globalThis.__alfadocs_agent` is undefined, so the\n * call is safe to add unconditionally inside any kit component.\n *\n * Re-registers when `instanceId` or `handle` changes; deregisters on\n * unmount.\n */\nexport function useAgentRegistration<THandle>(\n  adapter: AgentAdapter<THandle>,\n  handle: THandle | null | undefined,\n  instanceId: string | null | undefined,\n): void {\n  useEffect(() => {\n    if (typeof globalThis === 'undefined') return;\n    const slot = globalThis as AgentGlobal;\n    const registry = slot.__alfadocs_agent;\n    if (!registry || !instanceId || handle == null) return;\n\n    const registration: AgentRegistration<THandle> = {\n      id: adapter.id,\n      instanceId,\n      handle,\n      adapter,\n    };\n    registry.register(registration as AgentRegistration);\n\n    return () => {\n      registry.unregister(adapter.id, instanceId);\n    };\n  }, [adapter, handle, instanceId]);\n}\n"],"names":["createAgentRegistry","slots","listeners","key","id","instanceId","emit","event","listener","registration","all","r","useAgentRegistration","adapter","handle","useEffect","registry"],"mappings":";AAyDO,SAASA,IAAqC;AACnD,QAAMC,wBAAY,IAAA,GACZC,wBAAgB,IAAA,GAChBC,IAAM,CAACC,GAAYC,MAAuB,GAAGD,CAAE,KAAIC,CAAU,IAE7DC,IAAO,CAACC,MAA8B;AAC1C,eAAWC,KAAYN,EAAW,CAAAM,EAASD,CAAK;AAAA,EAClD;AAEA,SAAO;AAAA,IACL,SAASE,GAAc;AACrB,MAAAR,EAAM,IAAIE,EAAIM,EAAa,IAAIA,EAAa,UAAU,GAAGA,CAAY,GACrEH,EAAK;AAAA,QACH,MAAM;AAAA,QACN,IAAIG,EAAa;AAAA,QACjB,YAAYA,EAAa;AAAA,MAAA,CAC1B;AAAA,IACH;AAAA,IACA,WAAWL,GAAIC,GAAY;AACzB,MAAIJ,EAAM,OAAOE,EAAIC,GAAIC,CAAU,CAAC,KAClCC,EAAK,EAAE,MAAM,cAAc,IAAAF,GAAI,YAAAC,GAAY;AAAA,IAE/C;AAAA,IACA,IAAID,GAAIC,GAAY;AAClB,aAAOJ,EAAM,IAAIE,EAAIC,GAAIC,CAAU,CAAC;AAAA,IACtC;AAAA,IACA,KAAKD,GAAI;AACP,YAAMM,IAAM,CAAC,GAAGT,EAAM,QAAQ;AAC9B,aAAOG,IAAKM,EAAI,OAAO,CAACC,MAAMA,EAAE,OAAOP,CAAE,IAAIM;AAAA,IAC/C;AAAA,IACA,UAAUF,GAAU;AAClB,aAAAN,EAAU,IAAIM,CAAQ,GACf,MAAM;AACX,QAAAN,EAAU,OAAOM,CAAQ;AAAA,MAC3B;AAAA,IACF;AAAA,EAAA;AAEJ;AAcO,SAASI,EACdC,GACAC,GACAT,GACM;AACN,EAAAU,EAAU,MAAM;AACd,QAAI,OAAO,aAAe,IAAa;AAEvC,UAAMC,IADO,WACS;AACtB,QAAI,CAACA,KAAY,CAACX,KAAcS,KAAU,KAAM;AAEhD,UAAML,IAA2C;AAAA,MAC/C,IAAII,EAAQ;AAAA,MACZ,YAAAR;AAAA,MACA,QAAAS;AAAA,MACA,SAAAD;AAAA,IAAA;AAEF,WAAAG,EAAS,SAASP,CAAiC,GAE5C,MAAM;AACX,MAAAO,EAAS,WAAWH,EAAQ,IAAIR,CAAU;AAAA,IAC5C;AAAA,EACF,GAAG,CAACQ,GAASC,GAAQT,CAAU,CAAC;AAClC;"}