@dxos/web-context-react 0.8.4-main.ef1bc66f44 → 0.8.4-main.f466a3d56e

package/LICENSE

@@ -1,8 +1,105 @@
-MIT License
-Copyright (c) 2025 DXOS
+# Functional Source License, Version 1.1, ALv2 Future License
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+## Abbreviation
 
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+FSL-1.1-Apache-2.0
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+## Notice
+
+Copyright 2026 DXOS
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/README.md

@@ -40,7 +40,7 @@ import { useWebComponentContext } from '@dxos/web-context-react';
 
 const MyComponent = () => {
   const theme = useWebComponentContext(ThemeContext, { subscribe: true });
-  
+
   return <div style={{ color: theme?.color }}>Hello World</div>;
 };
 ```

package/dist/lib/browser/index.mjs

@@ -73,8 +73,12 @@ var ContextProtocolProvider = ({ context, value, children }) => {
   ]);
   const handleContextProviderEvent = useCallback((e) => {
     const event = e;
-    if (event.context !== context) return;
-    if (containerRef.current && event.contextTarget === containerRef.current) return;
+    if (event.context !== context) {
+      return;
+    }
+    if (containerRef.current && event.contextTarget === containerRef.current) {
+      return;
+    }
     const seen = /* @__PURE__ */ new Set();
     for (const ref of subscriptionRefs) {
       const callback = ref.deref();
@@ -83,8 +87,12 @@ var ContextProtocolProvider = ({ context, value, children }) => {
         continue;
       }
       const info = subscriptions.get(callback);
-      if (!info) continue;
-      if (seen.has(callback)) continue;
+      if (!info) {
+        continue;
+      }
+      if (seen.has(callback)) {
+        continue;
+      }
       seen.add(callback);
       info.consumerHost.dispatchEvent(new ContextRequestEvent(context, callback, {
         subscribe: true,
@@ -113,7 +121,9 @@ var ContextProtocolProvider = ({ context, value, children }) => {
   const containerRef = useRef(null);
   useEffect(() => {
     const el = containerRef.current;
-    if (!el) return;
+    if (!el) {
+      return;
+    }
     el.addEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);
     el.addEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);
     el.dispatchEvent(new ContextProviderEvent(context, el));
@@ -130,7 +140,6 @@ var ContextProtocolProvider = ({ context, value, children }) => {
   return /* @__PURE__ */ React.createElement(ContextRequestHandlerContext.Provider, {
     value: handleRequest
   }, /* @__PURE__ */ React.createElement("div", {
-    role: "none",
     className: "contents",
     ref: containerRef
   }, children));

package/dist/lib/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/index.ts", "../../../src/consumer.ts", "../../../src/internal.ts", "../../../src/provider.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nexport * from '@dxos/web-context';\n\nexport * from './consumer';\nexport * from './provider';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useContext, useEffect, useState } from 'react';\n\nimport { ContextRequestEvent, type ContextType, type UnknownContext } from '@dxos/web-context';\n\nimport { HostElementContext } from './internal';\nimport { useContextRequestHandler } from './provider';\n\n/**\n * Options for useWebComponentContext hook\n */\nexport interface UseWebComponentContextOptions {\n  /**\n   * Whether to subscribe to context updates.\n   * If true, the returned value will update when the provider's value changes.\n   * Default: false\n   */\n  subscribe?: boolean;\n\n  /**\n   * The element to dispatch the context-request event from.\n   * This is only used when there's no React provider in the tree.\n   * Default: document.body\n   */\n  element?: HTMLElement;\n}\n\n/**\n * A React hook that requests context using the Web Component Context Protocol.\n *\n * This first tries to use the React context chain (for providers in the same\n * React tree), then falls back to dispatching a DOM event (for web component\n * providers).\n *\n * @param context - The context key to request\n * @param options - Optional configuration\n * @returns The context value or undefined\n */\nexport function useWebComponentContext<T extends UnknownContext>(\n  context: T,\n  options?: UseWebComponentContextOptions,\n): ContextType<T> | undefined {\n  const [value, setValue] = useState<ContextType<T> | undefined>(undefined);\n\n  const handler = useContextRequestHandler();\n  const hostElement = useContext(HostElementContext);\n\n  useEffect(() => {\n    let unsubscribeFn: (() => void) | undefined;\n\n    const callback = (newValue: ContextType<T>, unsubscribe?: () => void) => {\n      setValue(newValue);\n      if (unsubscribe) {\n        unsubscribeFn = unsubscribe;\n      }\n    };\n\n    const targetElement = options?.element ?? hostElement ?? document.body;\n\n    const event = new ContextRequestEvent(context, callback, {\n      subscribe: options?.subscribe,\n      target: targetElement,\n    });\n\n    let handled = false;\n    if (handler) {\n      handled = handler(event);\n    }\n\n    if (!handled) {\n      targetElement.dispatchEvent(event);\n    }\n\n    return () => {\n      unsubscribeFn?.();\n    };\n  }, [context, options?.subscribe, options?.element, handler, hostElement]);\n\n  return value;\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from 'react';\n\n/**\n * Internal React context for passing the host element to nested components.\n * This allows useWebComponentContext to dispatch events from the custom element.\n */\nexport const HostElementContext = createContext<HTMLElement | undefined>(undefined);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, {\n  type JSX,\n  type PropsWithChildren,\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useRef,\n} from 'react';\n\nimport {\n  CONTEXT_PROVIDER_EVENT,\n  CONTEXT_REQUEST_EVENT,\n  type ContextCallback,\n  ContextProviderEvent,\n  ContextRequestEvent,\n  type ContextType,\n  type UnknownContext,\n} from '@dxos/web-context';\n\n/**\n * Handler function type for context requests passed via React context\n */\ntype ContextRequestHandler = (event: ContextRequestEvent<UnknownContext>) => boolean;\n\n/**\n * Internal React context for passing context request handlers down the tree.\n * This allows useWebComponentContext to work synchronously in React.\n */\nconst ContextRequestHandlerContext = createContext<ContextRequestHandler | undefined>(undefined);\n\n/**\n * Try to handle a context request using the React context chain.\n * Returns true if handled, false otherwise.\n * Used internally by useWebComponentContext.\n */\nexport function tryHandleContextRequest(event: ContextRequestEvent<UnknownContext>): boolean {\n  // This function is intended to be used where useContext is invalid (outside component),\n  // but context handling in React MUST happen inside components.\n  // So this helper might be less useful in React than in Solid if not used inside a hook/component.\n  // However, we can export the context itself for consumers to use `useContext`.\n  return false;\n}\n\n/**\n * Get the context request handler from React context.\n * Used internally by useWebComponentContext.\n */\nexport function useContextRequestHandler(): ContextRequestHandler | undefined {\n  return useContext(ContextRequestHandlerContext);\n}\n\n/**\n * Props for the ContextProtocolProvider component\n */\nexport interface ContextProtocolProviderProps<T extends UnknownContext> {\n  /** The context key to provide */\n  context: T;\n  /** The value to provide */\n  value: ContextType<T>;\n}\n\n/**\n * A provider component that:\n * 1. Handles context-request events from web components (via DOM events)\n * 2. Handles context requests from React consumers (via React context)\n * 3. Supports subscriptions for reactive updates\n * 4. Uses WeakRef for subscriptions to prevent memory leaks\n */\nexport const ContextProtocolProvider = <T extends UnknownContext>({\n  context,\n  value,\n  children,\n}: PropsWithChildren<ContextProtocolProviderProps<T>>): JSX.Element => {\n  // Get parent handler if one exists (for nested providers)\n  const parentHandler = useContext(ContextRequestHandlerContext);\n\n  // Track subscriptions with their stable unsubscribe functions and consumer host elements\n  interface SubscriptionInfo {\n    unsubscribe: () => void;\n    consumerHost: Element;\n    ref: WeakRef<ContextCallback<ContextType<T>>>;\n  }\n\n  // We use refs for mutable state that doesn't trigger re-renders\n  const subscriptions = useRef(new WeakMap<ContextCallback<ContextType<T>>, SubscriptionInfo>()).current;\n  const subscriptionRefs = useRef(new Set<WeakRef<ContextCallback<ContextType<T>>>>()).current;\n  const valueRef = useRef(value);\n\n  // Update value ref when prop changes\n  useEffect(() => {\n    valueRef.current = value;\n  }, [value]);\n\n  // Core handler logic\n  const handleRequest = useCallback(\n    (event: ContextRequestEvent<UnknownContext>): boolean => {\n      if (event.context !== context) {\n        if (parentHandler) {\n          return parentHandler(event);\n        }\n        return false;\n      }\n\n      const currentValue = valueRef.current; // Use latest value\n\n      if (event.subscribe) {\n        const callback = event.callback as ContextCallback<ContextType<T>>;\n        const consumerHost = event.contextTarget || (event.composedPath()[0] as Element);\n\n        const unsubscribe = () => {\n          const info = subscriptions.get(callback);\n          if (info) {\n            subscriptionRefs.delete(info.ref);\n            subscriptions.delete(callback);\n          }\n        };\n\n        const ref = new WeakRef(callback);\n        subscriptions.set(callback, { unsubscribe, consumerHost, ref });\n        subscriptionRefs.add(ref);\n\n        event.callback(currentValue, unsubscribe);\n      } else {\n        event.callback(currentValue);\n      }\n\n      return true;\n    },\n    [context, parentHandler], // Dependencies\n  );\n\n  // Handle DOM context-request events\n  const handleContextRequestEvent = useCallback(\n    (e: Event) => {\n      const event = e as ContextRequestEvent<UnknownContext>;\n      if (handleRequest(event)) {\n        event.stopImmediatePropagation();\n      }\n    },\n    [handleRequest],\n  );\n\n  // Handle context-provider events\n  const handleContextProviderEvent = useCallback(\n    (e: Event) => {\n      const event = e as ContextProviderEvent<UnknownContext>;\n      if (event.context !== context) return;\n      if (containerRef.current && event.contextTarget === containerRef.current) return;\n\n      const seen = new Set<ContextCallback<ContextType<T>>>();\n      for (const ref of subscriptionRefs) {\n        const callback = ref.deref();\n        if (!callback) {\n          subscriptionRefs.delete(ref);\n          continue;\n        }\n\n        const info = subscriptions.get(callback);\n        if (!info) continue;\n\n        if (seen.has(callback)) continue;\n        seen.add(callback);\n\n        info.consumerHost.dispatchEvent(\n          new ContextRequestEvent(context, callback, { subscribe: true, target: info.consumerHost }),\n        );\n      }\n      event.stopPropagation();\n    },\n    [context],\n  );\n\n  // Notify subscribers when value changes.\n  useEffect(() => {\n    // Skip notification if value hasn't changed? React does this for us if we use dependencies correctly?\n    // No, we need to imperatively call callbacks.\n    // value constraint is in the dependency array.\n\n    for (const ref of subscriptionRefs) {\n      const callback = ref.deref();\n      if (!callback) {\n        subscriptionRefs.delete(ref);\n        continue;\n      }\n      const info = subscriptions.get(callback);\n      if (info) {\n        callback(value, info.unsubscribe);\n      }\n    }\n  }, [value]);\n\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = containerRef.current;\n    if (!el) return;\n\n    el.addEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);\n    el.addEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);\n\n    // Announce provider.\n    el.dispatchEvent(new ContextProviderEvent(context, el));\n\n    return () => {\n      el.removeEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);\n      el.removeEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);\n      subscriptionRefs.clear();\n    };\n  }, [handleContextRequestEvent, handleContextProviderEvent, context]);\n\n  return (\n    <ContextRequestHandlerContext.Provider value={handleRequest}>\n      <div role='none' className='contents' ref={containerRef}>\n        {children}\n      </div>\n    </ContextRequestHandlerContext.Provider>\n  );\n};\n"],
-  "mappings": "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",
-  "names": ["useContext", "useEffect", "useState", "ContextRequestEvent", "createContext", "HostElementContext", "createContext", "undefined", "React", "createContext", "useCallback", "useContext", "useEffect", "useRef", "CONTEXT_PROVIDER_EVENT", "CONTEXT_REQUEST_EVENT", "ContextProviderEvent", "ContextRequestEvent", "ContextRequestHandlerContext", "createContext", "undefined", "tryHandleContextRequest", "event", "useContextRequestHandler", "useContext", "ContextProtocolProvider", "context", "value", "children", "parentHandler", "subscriptions", "useRef", "WeakMap", "current", "subscriptionRefs", "Set", "valueRef", "useEffect", "handleRequest", "useCallback", "currentValue", "subscribe", "callback", "consumerHost", "contextTarget", "composedPath", "unsubscribe", "info", "get", "delete", "ref", "WeakRef", "set", "add", "handleContextRequestEvent", "e", "stopImmediatePropagation", "handleContextProviderEvent", "containerRef", "seen", "deref", "has", "dispatchEvent", "ContextRequestEvent", "target", "stopPropagation", "el", "addEventListener", "CONTEXT_REQUEST_EVENT", "CONTEXT_PROVIDER_EVENT", "ContextProviderEvent", "removeEventListener", "clear", "Provider", "div", "role", "className", "useWebComponentContext", "context", "options", "value", "setValue", "useState", "undefined", "handler", "useContextRequestHandler", "hostElement", "useContext", "HostElementContext", "useEffect", "unsubscribeFn", "callback", "newValue", "unsubscribe", "targetElement", "element", "document", "body", "event", "ContextRequestEvent", "subscribe", "target", "handled", "dispatchEvent"]
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nexport * from '@dxos/web-context';\n\nexport * from './consumer';\nexport * from './provider';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useContext, useEffect, useState } from 'react';\n\nimport { ContextRequestEvent, type ContextType, type UnknownContext } from '@dxos/web-context';\n\nimport { HostElementContext } from './internal';\nimport { useContextRequestHandler } from './provider';\n\n/**\n * Options for useWebComponentContext hook\n */\nexport interface UseWebComponentContextOptions {\n  /**\n   * Whether to subscribe to context updates.\n   * If true, the returned value will update when the provider's value changes.\n   * Default: false\n   */\n  subscribe?: boolean;\n\n  /**\n   * The element to dispatch the context-request event from.\n   * This is only used when there's no React provider in the tree.\n   * Default: document.body\n   */\n  element?: HTMLElement;\n}\n\n/**\n * A React hook that requests context using the Web Component Context Protocol.\n *\n * This first tries to use the React context chain (for providers in the same\n * React tree), then falls back to dispatching a DOM event (for web component\n * providers).\n *\n * @param context - The context key to request\n * @param options - Optional configuration\n * @returns The context value or undefined\n */\nexport function useWebComponentContext<T extends UnknownContext>(\n  context: T,\n  options?: UseWebComponentContextOptions,\n): ContextType<T> | undefined {\n  const [value, setValue] = useState<ContextType<T> | undefined>(undefined);\n\n  const handler = useContextRequestHandler();\n  const hostElement = useContext(HostElementContext);\n\n  useEffect(() => {\n    let unsubscribeFn: (() => void) | undefined;\n\n    const callback = (newValue: ContextType<T>, unsubscribe?: () => void) => {\n      setValue(newValue);\n      if (unsubscribe) {\n        unsubscribeFn = unsubscribe;\n      }\n    };\n\n    const targetElement = options?.element ?? hostElement ?? document.body;\n\n    const event = new ContextRequestEvent(context, callback, {\n      subscribe: options?.subscribe,\n      target: targetElement,\n    });\n\n    let handled = false;\n    if (handler) {\n      handled = handler(event);\n    }\n\n    if (!handled) {\n      targetElement.dispatchEvent(event);\n    }\n\n    return () => {\n      unsubscribeFn?.();\n    };\n  }, [context, options?.subscribe, options?.element, handler, hostElement]);\n\n  return value;\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from 'react';\n\n/**\n * Internal React context for passing the host element to nested components.\n * This allows useWebComponentContext to dispatch events from the custom element.\n */\nexport const HostElementContext = createContext<HTMLElement | undefined>(undefined);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, {\n  type JSX,\n  type PropsWithChildren,\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useRef,\n} from 'react';\n\nimport {\n  CONTEXT_PROVIDER_EVENT,\n  CONTEXT_REQUEST_EVENT,\n  type ContextCallback,\n  ContextProviderEvent,\n  ContextRequestEvent,\n  type ContextType,\n  type UnknownContext,\n} from '@dxos/web-context';\n\n/**\n * Handler function type for context requests passed via React context\n */\ntype ContextRequestHandler = (event: ContextRequestEvent<UnknownContext>) => boolean;\n\n/**\n * Internal React context for passing context request handlers down the tree.\n * This allows useWebComponentContext to work synchronously in React.\n */\nconst ContextRequestHandlerContext = createContext<ContextRequestHandler | undefined>(undefined);\n\n/**\n * Try to handle a context request using the React context chain.\n * Returns true if handled, false otherwise.\n * Used internally by useWebComponentContext.\n */\nexport function tryHandleContextRequest(event: ContextRequestEvent<UnknownContext>): boolean {\n  // This function is intended to be used where useContext is invalid (outside component),\n  // but context handling in React MUST happen inside components.\n  // So this helper might be less useful in React than in Solid if not used inside a hook/component.\n  // However, we can export the context itself for consumers to use `useContext`.\n  return false;\n}\n\n/**\n * Get the context request handler from React context.\n * Used internally by useWebComponentContext.\n */\nexport function useContextRequestHandler(): ContextRequestHandler | undefined {\n  return useContext(ContextRequestHandlerContext);\n}\n\n/**\n * Props for the ContextProtocolProvider component\n */\nexport interface ContextProtocolProviderProps<T extends UnknownContext> {\n  /** The context key to provide */\n  context: T;\n  /** The value to provide */\n  value: ContextType<T>;\n}\n\n/**\n * A provider component that:\n * 1. Handles context-request events from web components (via DOM events)\n * 2. Handles context requests from React consumers (via React context)\n * 3. Supports subscriptions for reactive updates\n * 4. Uses WeakRef for subscriptions to prevent memory leaks\n */\nexport const ContextProtocolProvider = <T extends UnknownContext>({\n  context,\n  value,\n  children,\n}: PropsWithChildren<ContextProtocolProviderProps<T>>): JSX.Element => {\n  // Get parent handler if one exists (for nested providers)\n  const parentHandler = useContext(ContextRequestHandlerContext);\n\n  // Track subscriptions with their stable unsubscribe functions and consumer host elements\n  interface SubscriptionInfo {\n    unsubscribe: () => void;\n    consumerHost: Element;\n    ref: WeakRef<ContextCallback<ContextType<T>>>;\n  }\n\n  // We use refs for mutable state that doesn't trigger re-renders\n  const subscriptions = useRef(new WeakMap<ContextCallback<ContextType<T>>, SubscriptionInfo>()).current;\n  const subscriptionRefs = useRef(new Set<WeakRef<ContextCallback<ContextType<T>>>>()).current;\n  const valueRef = useRef(value);\n\n  // Update value ref when prop changes\n  useEffect(() => {\n    valueRef.current = value;\n  }, [value]);\n\n  // Core handler logic\n  const handleRequest = useCallback(\n    (event: ContextRequestEvent<UnknownContext>): boolean => {\n      if (event.context !== context) {\n        if (parentHandler) {\n          return parentHandler(event);\n        }\n        return false;\n      }\n\n      const currentValue = valueRef.current; // Use latest value\n\n      if (event.subscribe) {\n        const callback = event.callback as ContextCallback<ContextType<T>>;\n        const consumerHost = event.contextTarget || (event.composedPath()[0] as Element);\n\n        const unsubscribe = () => {\n          const info = subscriptions.get(callback);\n          if (info) {\n            subscriptionRefs.delete(info.ref);\n            subscriptions.delete(callback);\n          }\n        };\n\n        const ref = new WeakRef(callback);\n        subscriptions.set(callback, { unsubscribe, consumerHost, ref });\n        subscriptionRefs.add(ref);\n\n        event.callback(currentValue, unsubscribe);\n      } else {\n        event.callback(currentValue);\n      }\n\n      return true;\n    },\n    [context, parentHandler], // Dependencies\n  );\n\n  // Handle DOM context-request events\n  const handleContextRequestEvent = useCallback(\n    (e: Event) => {\n      const event = e as ContextRequestEvent<UnknownContext>;\n      if (handleRequest(event)) {\n        event.stopImmediatePropagation();\n      }\n    },\n    [handleRequest],\n  );\n\n  // Handle context-provider events\n  const handleContextProviderEvent = useCallback(\n    (e: Event) => {\n      const event = e as ContextProviderEvent<UnknownContext>;\n      if (event.context !== context) {\n        return;\n      }\n      if (containerRef.current && event.contextTarget === containerRef.current) {\n        return;\n      }\n\n      const seen = new Set<ContextCallback<ContextType<T>>>();\n      for (const ref of subscriptionRefs) {\n        const callback = ref.deref();\n        if (!callback) {\n          subscriptionRefs.delete(ref);\n          continue;\n        }\n\n        const info = subscriptions.get(callback);\n        if (!info) {\n          continue;\n        }\n\n        if (seen.has(callback)) {\n          continue;\n        }\n        seen.add(callback);\n\n        info.consumerHost.dispatchEvent(\n          new ContextRequestEvent(context, callback, { subscribe: true, target: info.consumerHost }),\n        );\n      }\n      event.stopPropagation();\n    },\n    [context],\n  );\n\n  // Notify subscribers when value changes.\n  useEffect(() => {\n    // Skip notification if value hasn't changed? React does this for us if we use dependencies correctly?\n    // No, we need to imperatively call callbacks.\n    // value constraint is in the dependency array.\n\n    for (const ref of subscriptionRefs) {\n      const callback = ref.deref();\n      if (!callback) {\n        subscriptionRefs.delete(ref);\n        continue;\n      }\n      const info = subscriptions.get(callback);\n      if (info) {\n        callback(value, info.unsubscribe);\n      }\n    }\n  }, [value]);\n\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = containerRef.current;\n    if (!el) {\n      return;\n    }\n\n    el.addEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);\n    el.addEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);\n\n    // Announce provider.\n    el.dispatchEvent(new ContextProviderEvent(context, el));\n\n    return () => {\n      el.removeEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);\n      el.removeEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);\n      subscriptionRefs.clear();\n    };\n  }, [handleContextRequestEvent, handleContextProviderEvent, context]);\n\n  return (\n    <ContextRequestHandlerContext.Provider value={handleRequest}>\n      <div className='contents' ref={containerRef}>\n        {children}\n      </div>\n    </ContextRequestHandlerContext.Provider>\n  );\n};\n"],
+  "mappings": "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",
+  "names": ["useContext", "useEffect", "useState", "ContextRequestEvent", "createContext", "HostElementContext", "undefined", "React", "createContext", "useCallback", "useContext", "useEffect", "useRef", "CONTEXT_PROVIDER_EVENT", "CONTEXT_REQUEST_EVENT", "ContextProviderEvent", "ContextRequestEvent", "ContextRequestHandlerContext", "undefined", "tryHandleContextRequest", "event", "useContextRequestHandler", "ContextProtocolProvider", "context", "value", "children", "parentHandler", "subscriptions", "WeakMap", "current", "subscriptionRefs", "Set", "valueRef", "handleRequest", "currentValue", "subscribe", "callback", "consumerHost", "contextTarget", "composedPath", "unsubscribe", "info", "get", "delete", "ref", "WeakRef", "set", "add", "handleContextRequestEvent", "e", "stopImmediatePropagation", "handleContextProviderEvent", "containerRef", "seen", "deref", "has", "dispatchEvent", "target", "stopPropagation", "el", "addEventListener", "removeEventListener", "clear", "Provider", "div", "className", "useWebComponentContext", "context", "options", "value", "setValue", "useState", "undefined", "handler", "useContextRequestHandler", "hostElement", "useContext", "HostElementContext", "useEffect", "unsubscribeFn", "callback", "newValue", "unsubscribe", "targetElement", "element", "document", "body", "event", "ContextRequestEvent", "subscribe", "target", "handled", "dispatchEvent"]
 }

package/dist/lib/browser/meta.json

@@ -1 +1 @@
-{"inputs":{"src/internal.ts":{"bytes":1209,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/provider.tsx":{"bytes":20824,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true}],"format":"esm"},"src/consumer.ts":{"bytes":6591,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"src/internal.ts","kind":"import-statement","original":"./internal"},{"path":"src/provider.tsx","kind":"import-statement","original":"./provider"}],"format":"esm"},"src/index.ts":{"bytes":659,"imports":[{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"src/consumer.ts","kind":"import-statement","original":"./consumer"},{"path":"src/provider.tsx","kind":"import-statement","original":"./provider"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":15103},"dist/lib/browser/index.mjs":{"imports":[{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true}],"exports":["ContextProtocolProvider","tryHandleContextRequest","useContextRequestHandler","useWebComponentContext"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":35},"src/consumer.ts":{"bytesInOutput":1096},"src/internal.ts":{"bytesInOutput":87},"src/provider.tsx":{"bytesInOutput":3931}},"bytes":5400}}}
+{"inputs":{"src/internal.ts":{"bytes":1122,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/provider.tsx":{"bytes":21018,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true}],"format":"esm"},"src/consumer.ts":{"bytes":6500,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"src/internal.ts","kind":"import-statement","original":"./internal"},{"path":"src/provider.tsx","kind":"import-statement","original":"./provider"}],"format":"esm"},"src/index.ts":{"bytes":575,"imports":[{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"src/consumer.ts","kind":"import-statement","original":"./consumer"},{"path":"src/provider.tsx","kind":"import-statement","original":"./provider"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":15044},"dist/lib/browser/index.mjs":{"imports":[{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true}],"exports":["ContextProtocolProvider","tryHandleContextRequest","useContextRequestHandler","useWebComponentContext"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":35},"src/consumer.ts":{"bytesInOutput":1096},"src/internal.ts":{"bytesInOutput":87},"src/provider.tsx":{"bytesInOutput":3991}},"bytes":5460}}}

package/dist/lib/node-esm/index.mjs

@@ -75,8 +75,12 @@ var ContextProtocolProvider = ({ context, value, children }) => {
   ]);
   const handleContextProviderEvent = useCallback((e) => {
     const event = e;
-    if (event.context !== context) return;
-    if (containerRef.current && event.contextTarget === containerRef.current) return;
+    if (event.context !== context) {
+      return;
+    }
+    if (containerRef.current && event.contextTarget === containerRef.current) {
+      return;
+    }
     const seen = /* @__PURE__ */ new Set();
     for (const ref of subscriptionRefs) {
       const callback = ref.deref();
@@ -85,8 +89,12 @@ var ContextProtocolProvider = ({ context, value, children }) => {
         continue;
       }
       const info = subscriptions.get(callback);
-      if (!info) continue;
-      if (seen.has(callback)) continue;
+      if (!info) {
+        continue;
+      }
+      if (seen.has(callback)) {
+        continue;
+      }
       seen.add(callback);
       info.consumerHost.dispatchEvent(new ContextRequestEvent(context, callback, {
         subscribe: true,
@@ -115,7 +123,9 @@ var ContextProtocolProvider = ({ context, value, children }) => {
   const containerRef = useRef(null);
   useEffect(() => {
     const el = containerRef.current;
-    if (!el) return;
+    if (!el) {
+      return;
+    }
     el.addEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);
     el.addEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);
     el.dispatchEvent(new ContextProviderEvent(context, el));
@@ -132,7 +142,6 @@ var ContextProtocolProvider = ({ context, value, children }) => {
   return /* @__PURE__ */ React.createElement(ContextRequestHandlerContext.Provider, {
     value: handleRequest
   }, /* @__PURE__ */ React.createElement("div", {
-    role: "none",
     className: "contents",
     ref: containerRef
   }, children));

package/dist/lib/node-esm/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/index.ts", "../../../src/consumer.ts", "../../../src/internal.ts", "../../../src/provider.tsx"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nexport * from '@dxos/web-context';\n\nexport * from './consumer';\nexport * from './provider';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useContext, useEffect, useState } from 'react';\n\nimport { ContextRequestEvent, type ContextType, type UnknownContext } from '@dxos/web-context';\n\nimport { HostElementContext } from './internal';\nimport { useContextRequestHandler } from './provider';\n\n/**\n * Options for useWebComponentContext hook\n */\nexport interface UseWebComponentContextOptions {\n  /**\n   * Whether to subscribe to context updates.\n   * If true, the returned value will update when the provider's value changes.\n   * Default: false\n   */\n  subscribe?: boolean;\n\n  /**\n   * The element to dispatch the context-request event from.\n   * This is only used when there's no React provider in the tree.\n   * Default: document.body\n   */\n  element?: HTMLElement;\n}\n\n/**\n * A React hook that requests context using the Web Component Context Protocol.\n *\n * This first tries to use the React context chain (for providers in the same\n * React tree), then falls back to dispatching a DOM event (for web component\n * providers).\n *\n * @param context - The context key to request\n * @param options - Optional configuration\n * @returns The context value or undefined\n */\nexport function useWebComponentContext<T extends UnknownContext>(\n  context: T,\n  options?: UseWebComponentContextOptions,\n): ContextType<T> | undefined {\n  const [value, setValue] = useState<ContextType<T> | undefined>(undefined);\n\n  const handler = useContextRequestHandler();\n  const hostElement = useContext(HostElementContext);\n\n  useEffect(() => {\n    let unsubscribeFn: (() => void) | undefined;\n\n    const callback = (newValue: ContextType<T>, unsubscribe?: () => void) => {\n      setValue(newValue);\n      if (unsubscribe) {\n        unsubscribeFn = unsubscribe;\n      }\n    };\n\n    const targetElement = options?.element ?? hostElement ?? document.body;\n\n    const event = new ContextRequestEvent(context, callback, {\n      subscribe: options?.subscribe,\n      target: targetElement,\n    });\n\n    let handled = false;\n    if (handler) {\n      handled = handler(event);\n    }\n\n    if (!handled) {\n      targetElement.dispatchEvent(event);\n    }\n\n    return () => {\n      unsubscribeFn?.();\n    };\n  }, [context, options?.subscribe, options?.element, handler, hostElement]);\n\n  return value;\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from 'react';\n\n/**\n * Internal React context for passing the host element to nested components.\n * This allows useWebComponentContext to dispatch events from the custom element.\n */\nexport const HostElementContext = createContext<HTMLElement | undefined>(undefined);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, {\n  type JSX,\n  type PropsWithChildren,\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useRef,\n} from 'react';\n\nimport {\n  CONTEXT_PROVIDER_EVENT,\n  CONTEXT_REQUEST_EVENT,\n  type ContextCallback,\n  ContextProviderEvent,\n  ContextRequestEvent,\n  type ContextType,\n  type UnknownContext,\n} from '@dxos/web-context';\n\n/**\n * Handler function type for context requests passed via React context\n */\ntype ContextRequestHandler = (event: ContextRequestEvent<UnknownContext>) => boolean;\n\n/**\n * Internal React context for passing context request handlers down the tree.\n * This allows useWebComponentContext to work synchronously in React.\n */\nconst ContextRequestHandlerContext = createContext<ContextRequestHandler | undefined>(undefined);\n\n/**\n * Try to handle a context request using the React context chain.\n * Returns true if handled, false otherwise.\n * Used internally by useWebComponentContext.\n */\nexport function tryHandleContextRequest(event: ContextRequestEvent<UnknownContext>): boolean {\n  // This function is intended to be used where useContext is invalid (outside component),\n  // but context handling in React MUST happen inside components.\n  // So this helper might be less useful in React than in Solid if not used inside a hook/component.\n  // However, we can export the context itself for consumers to use `useContext`.\n  return false;\n}\n\n/**\n * Get the context request handler from React context.\n * Used internally by useWebComponentContext.\n */\nexport function useContextRequestHandler(): ContextRequestHandler | undefined {\n  return useContext(ContextRequestHandlerContext);\n}\n\n/**\n * Props for the ContextProtocolProvider component\n */\nexport interface ContextProtocolProviderProps<T extends UnknownContext> {\n  /** The context key to provide */\n  context: T;\n  /** The value to provide */\n  value: ContextType<T>;\n}\n\n/**\n * A provider component that:\n * 1. Handles context-request events from web components (via DOM events)\n * 2. Handles context requests from React consumers (via React context)\n * 3. Supports subscriptions for reactive updates\n * 4. Uses WeakRef for subscriptions to prevent memory leaks\n */\nexport const ContextProtocolProvider = <T extends UnknownContext>({\n  context,\n  value,\n  children,\n}: PropsWithChildren<ContextProtocolProviderProps<T>>): JSX.Element => {\n  // Get parent handler if one exists (for nested providers)\n  const parentHandler = useContext(ContextRequestHandlerContext);\n\n  // Track subscriptions with their stable unsubscribe functions and consumer host elements\n  interface SubscriptionInfo {\n    unsubscribe: () => void;\n    consumerHost: Element;\n    ref: WeakRef<ContextCallback<ContextType<T>>>;\n  }\n\n  // We use refs for mutable state that doesn't trigger re-renders\n  const subscriptions = useRef(new WeakMap<ContextCallback<ContextType<T>>, SubscriptionInfo>()).current;\n  const subscriptionRefs = useRef(new Set<WeakRef<ContextCallback<ContextType<T>>>>()).current;\n  const valueRef = useRef(value);\n\n  // Update value ref when prop changes\n  useEffect(() => {\n    valueRef.current = value;\n  }, [value]);\n\n  // Core handler logic\n  const handleRequest = useCallback(\n    (event: ContextRequestEvent<UnknownContext>): boolean => {\n      if (event.context !== context) {\n        if (parentHandler) {\n          return parentHandler(event);\n        }\n        return false;\n      }\n\n      const currentValue = valueRef.current; // Use latest value\n\n      if (event.subscribe) {\n        const callback = event.callback as ContextCallback<ContextType<T>>;\n        const consumerHost = event.contextTarget || (event.composedPath()[0] as Element);\n\n        const unsubscribe = () => {\n          const info = subscriptions.get(callback);\n          if (info) {\n            subscriptionRefs.delete(info.ref);\n            subscriptions.delete(callback);\n          }\n        };\n\n        const ref = new WeakRef(callback);\n        subscriptions.set(callback, { unsubscribe, consumerHost, ref });\n        subscriptionRefs.add(ref);\n\n        event.callback(currentValue, unsubscribe);\n      } else {\n        event.callback(currentValue);\n      }\n\n      return true;\n    },\n    [context, parentHandler], // Dependencies\n  );\n\n  // Handle DOM context-request events\n  const handleContextRequestEvent = useCallback(\n    (e: Event) => {\n      const event = e as ContextRequestEvent<UnknownContext>;\n      if (handleRequest(event)) {\n        event.stopImmediatePropagation();\n      }\n    },\n    [handleRequest],\n  );\n\n  // Handle context-provider events\n  const handleContextProviderEvent = useCallback(\n    (e: Event) => {\n      const event = e as ContextProviderEvent<UnknownContext>;\n      if (event.context !== context) return;\n      if (containerRef.current && event.contextTarget === containerRef.current) return;\n\n      const seen = new Set<ContextCallback<ContextType<T>>>();\n      for (const ref of subscriptionRefs) {\n        const callback = ref.deref();\n        if (!callback) {\n          subscriptionRefs.delete(ref);\n          continue;\n        }\n\n        const info = subscriptions.get(callback);\n        if (!info) continue;\n\n        if (seen.has(callback)) continue;\n        seen.add(callback);\n\n        info.consumerHost.dispatchEvent(\n          new ContextRequestEvent(context, callback, { subscribe: true, target: info.consumerHost }),\n        );\n      }\n      event.stopPropagation();\n    },\n    [context],\n  );\n\n  // Notify subscribers when value changes.\n  useEffect(() => {\n    // Skip notification if value hasn't changed? React does this for us if we use dependencies correctly?\n    // No, we need to imperatively call callbacks.\n    // value constraint is in the dependency array.\n\n    for (const ref of subscriptionRefs) {\n      const callback = ref.deref();\n      if (!callback) {\n        subscriptionRefs.delete(ref);\n        continue;\n      }\n      const info = subscriptions.get(callback);\n      if (info) {\n        callback(value, info.unsubscribe);\n      }\n    }\n  }, [value]);\n\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = containerRef.current;\n    if (!el) return;\n\n    el.addEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);\n    el.addEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);\n\n    // Announce provider.\n    el.dispatchEvent(new ContextProviderEvent(context, el));\n\n    return () => {\n      el.removeEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);\n      el.removeEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);\n      subscriptionRefs.clear();\n    };\n  }, [handleContextRequestEvent, handleContextProviderEvent, context]);\n\n  return (\n    <ContextRequestHandlerContext.Provider value={handleRequest}>\n      <div role='none' className='contents' ref={containerRef}>\n        {children}\n      </div>\n    </ContextRequestHandlerContext.Provider>\n  );\n};\n"],
-  "mappings": ";;;AAIA,cAAc;;;ACAd,SAASA,cAAAA,aAAYC,aAAAA,YAAWC,gBAAgB;AAEhD,SAASC,uBAAAA,4BAAkE;;;ACF3E,SAASC,qBAAqB;AAMvB,IAAMC,qBAAqBC,cAAuCC,MAAAA;;;ACNzE,OAAOC,SAGLC,iBAAAA,gBACAC,aACAC,YACAC,WACAC,cACK;AAEP,SACEC,wBACAC,uBAEAC,sBACAC,2BAGK;AAWP,IAAMC,+BAA+BC,gBAAAA,eAAiDC,MAAAA;AAO/E,SAASC,wBAAwBC,OAA0C;AAKhF,SAAO;AACT;AAMO,SAASC,2BAAAA;AACd,SAAOC,WAAWN,4BAAAA;AACpB;AAmBO,IAAMO,0BAA0B,CAA2B,EAChEC,SACAC,OACAC,SAAQ,MAC2C;AAEnD,QAAMC,gBAAgBL,WAAWN,4BAAAA;AAUjC,QAAMY,gBAAgBC,OAAO,oBAAIC,QAAAA,CAAAA,EAA8DC;AAC/F,QAAMC,mBAAmBH,OAAO,oBAAII,IAAAA,CAAAA,EAAiDF;AACrF,QAAMG,WAAWL,OAAOJ,KAAAA;AAGxBU,YAAU,MAAA;AACRD,aAASH,UAAUN;EACrB,GAAG;IAACA;GAAM;AAGV,QAAMW,gBAAgBC,YACpB,CAACjB,UAAAA;AACC,QAAIA,MAAMI,YAAYA,SAAS;AAC7B,UAAIG,eAAe;AACjB,eAAOA,cAAcP,KAAAA;MACvB;AACA,aAAO;IACT;AAEA,UAAMkB,eAAeJ,SAASH;AAE9B,QAAIX,MAAMmB,WAAW;AACnB,YAAMC,WAAWpB,MAAMoB;AACvB,YAAMC,eAAerB,MAAMsB,iBAAkBtB,MAAMuB,aAAY,EAAG,CAAA;AAElE,YAAMC,cAAc,MAAA;AAClB,cAAMC,OAAOjB,cAAckB,IAAIN,QAAAA;AAC/B,YAAIK,MAAM;AACRb,2BAAiBe,OAAOF,KAAKG,GAAG;AAChCpB,wBAAcmB,OAAOP,QAAAA;QACvB;MACF;AAEA,YAAMQ,MAAM,IAAIC,QAAQT,QAAAA;AACxBZ,oBAAcsB,IAAIV,UAAU;QAAEI;QAAaH;QAAcO;MAAI,CAAA;AAC7DhB,uBAAiBmB,IAAIH,GAAAA;AAErB5B,YAAMoB,SAASF,cAAcM,WAAAA;IAC/B,OAAO;AACLxB,YAAMoB,SAASF,YAAAA;IACjB;AAEA,WAAO;EACT,GACA;IAACd;IAASG;GAAc;AAI1B,QAAMyB,4BAA4Bf,YAChC,CAACgB,MAAAA;AACC,UAAMjC,QAAQiC;AACd,QAAIjB,cAAchB,KAAAA,GAAQ;AACxBA,YAAMkC,yBAAwB;IAChC;EACF,GACA;IAAClB;GAAc;AAIjB,QAAMmB,6BAA6BlB,YACjC,CAACgB,MAAAA;AACC,UAAMjC,QAAQiC;AACd,QAAIjC,MAAMI,YAAYA,QAAS;AAC/B,QAAIgC,aAAazB,WAAWX,MAAMsB,kBAAkBc,aAAazB,QAAS;AAE1E,UAAM0B,OAAO,oBAAIxB,IAAAA;AACjB,eAAWe,OAAOhB,kBAAkB;AAClC,YAAMQ,WAAWQ,IAAIU,MAAK;AAC1B,UAAI,CAAClB,UAAU;AACbR,yBAAiBe,OAAOC,GAAAA;AACxB;MACF;AAEA,YAAMH,OAAOjB,cAAckB,IAAIN,QAAAA;AAC/B,UAAI,CAACK,KAAM;AAEX,UAAIY,KAAKE,IAAInB,QAAAA,EAAW;AACxBiB,WAAKN,IAAIX,QAAAA;AAETK,WAAKJ,aAAamB,cAChB,IAAIC,oBAAoBrC,SAASgB,UAAU;QAAED,WAAW;QAAMuB,QAAQjB,KAAKJ;MAAa,CAAA,CAAA;IAE5F;AACArB,UAAM2C,gBAAe;EACvB,GACA;IAACvC;GAAQ;AAIXW,YAAU,MAAA;AAKR,eAAWa,OAAOhB,kBAAkB;AAClC,YAAMQ,WAAWQ,IAAIU,MAAK;AAC1B,UAAI,CAAClB,UAAU;AACbR,yBAAiBe,OAAOC,GAAAA;AACxB;MACF;AACA,YAAMH,OAAOjB,cAAckB,IAAIN,QAAAA;AAC/B,UAAIK,MAAM;AACRL,iBAASf,OAAOoB,KAAKD,WAAW;MAClC;IACF;EACF,GAAG;IAACnB;GAAM;AAEV,QAAM+B,eAAe3B,OAAuB,IAAA;AAE5CM,YAAU,MAAA;AACR,UAAM6B,KAAKR,aAAazB;AACxB,QAAI,CAACiC,GAAI;AAETA,OAAGC,iBAAiBC,uBAAuBd,yBAAAA;AAC3CY,OAAGC,iBAAiBE,wBAAwBZ,0BAAAA;AAG5CS,OAAGJ,cAAc,IAAIQ,qBAAqB5C,SAASwC,EAAAA,CAAAA;AAEnD,WAAO,MAAA;AACLA,SAAGK,oBAAoBH,uBAAuBd,yBAAAA;AAC9CY,SAAGK,oBAAoBF,wBAAwBZ,0BAAAA;AAC/CvB,uBAAiBsC,MAAK;IACxB;EACF,GAAG;IAAClB;IAA2BG;IAA4B/B;GAAQ;AAEnE,SACE,sBAAA,cAACR,6BAA6BuD,UAAQ;IAAC9C,OAAOW;KAC5C,sBAAA,cAACoC,OAAAA;IAAIC,MAAK;IAAOC,WAAU;IAAW1B,KAAKQ;KACxC9B,QAAAA,CAAAA;AAIT;;;AFrLO,SAASiD,uBACdC,SACAC,SAAuC;AAEvC,QAAM,CAACC,OAAOC,QAAAA,IAAYC,SAAqCC,MAAAA;AAE/D,QAAMC,UAAUC,yBAAAA;AAChB,QAAMC,cAAcC,YAAWC,kBAAAA;AAE/BC,EAAAA,WAAU,MAAA;AACR,QAAIC;AAEJ,UAAMC,WAAW,CAACC,UAA0BC,gBAAAA;AAC1CZ,eAASW,QAAAA;AACT,UAAIC,aAAa;AACfH,wBAAgBG;MAClB;IACF;AAEA,UAAMC,gBAAgBf,SAASgB,WAAWT,eAAeU,SAASC;AAElE,UAAMC,QAAQ,IAAIC,qBAAoBrB,SAASa,UAAU;MACvDS,WAAWrB,SAASqB;MACpBC,QAAQP;IACV,CAAA;AAEA,QAAIQ,UAAU;AACd,QAAIlB,SAAS;AACXkB,gBAAUlB,QAAQc,KAAAA;IACpB;AAEA,QAAI,CAACI,SAAS;AACZR,oBAAcS,cAAcL,KAAAA;IAC9B;AAEA,WAAO,MAAA;AACLR,sBAAAA;IACF;EACF,GAAG;IAACZ;IAASC,SAASqB;IAAWrB,SAASgB;IAASX;IAASE;GAAY;AAExE,SAAON;AACT;",
-  "names": ["useContext", "useEffect", "useState", "ContextRequestEvent", "createContext", "HostElementContext", "createContext", "undefined", "React", "createContext", "useCallback", "useContext", "useEffect", "useRef", "CONTEXT_PROVIDER_EVENT", "CONTEXT_REQUEST_EVENT", "ContextProviderEvent", "ContextRequestEvent", "ContextRequestHandlerContext", "createContext", "undefined", "tryHandleContextRequest", "event", "useContextRequestHandler", "useContext", "ContextProtocolProvider", "context", "value", "children", "parentHandler", "subscriptions", "useRef", "WeakMap", "current", "subscriptionRefs", "Set", "valueRef", "useEffect", "handleRequest", "useCallback", "currentValue", "subscribe", "callback", "consumerHost", "contextTarget", "composedPath", "unsubscribe", "info", "get", "delete", "ref", "WeakRef", "set", "add", "handleContextRequestEvent", "e", "stopImmediatePropagation", "handleContextProviderEvent", "containerRef", "seen", "deref", "has", "dispatchEvent", "ContextRequestEvent", "target", "stopPropagation", "el", "addEventListener", "CONTEXT_REQUEST_EVENT", "CONTEXT_PROVIDER_EVENT", "ContextProviderEvent", "removeEventListener", "clear", "Provider", "div", "role", "className", "useWebComponentContext", "context", "options", "value", "setValue", "useState", "undefined", "handler", "useContextRequestHandler", "hostElement", "useContext", "HostElementContext", "useEffect", "unsubscribeFn", "callback", "newValue", "unsubscribe", "targetElement", "element", "document", "body", "event", "ContextRequestEvent", "subscribe", "target", "handled", "dispatchEvent"]
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nexport * from '@dxos/web-context';\n\nexport * from './consumer';\nexport * from './provider';\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { useContext, useEffect, useState } from 'react';\n\nimport { ContextRequestEvent, type ContextType, type UnknownContext } from '@dxos/web-context';\n\nimport { HostElementContext } from './internal';\nimport { useContextRequestHandler } from './provider';\n\n/**\n * Options for useWebComponentContext hook\n */\nexport interface UseWebComponentContextOptions {\n  /**\n   * Whether to subscribe to context updates.\n   * If true, the returned value will update when the provider's value changes.\n   * Default: false\n   */\n  subscribe?: boolean;\n\n  /**\n   * The element to dispatch the context-request event from.\n   * This is only used when there's no React provider in the tree.\n   * Default: document.body\n   */\n  element?: HTMLElement;\n}\n\n/**\n * A React hook that requests context using the Web Component Context Protocol.\n *\n * This first tries to use the React context chain (for providers in the same\n * React tree), then falls back to dispatching a DOM event (for web component\n * providers).\n *\n * @param context - The context key to request\n * @param options - Optional configuration\n * @returns The context value or undefined\n */\nexport function useWebComponentContext<T extends UnknownContext>(\n  context: T,\n  options?: UseWebComponentContextOptions,\n): ContextType<T> | undefined {\n  const [value, setValue] = useState<ContextType<T> | undefined>(undefined);\n\n  const handler = useContextRequestHandler();\n  const hostElement = useContext(HostElementContext);\n\n  useEffect(() => {\n    let unsubscribeFn: (() => void) | undefined;\n\n    const callback = (newValue: ContextType<T>, unsubscribe?: () => void) => {\n      setValue(newValue);\n      if (unsubscribe) {\n        unsubscribeFn = unsubscribe;\n      }\n    };\n\n    const targetElement = options?.element ?? hostElement ?? document.body;\n\n    const event = new ContextRequestEvent(context, callback, {\n      subscribe: options?.subscribe,\n      target: targetElement,\n    });\n\n    let handled = false;\n    if (handler) {\n      handled = handler(event);\n    }\n\n    if (!handled) {\n      targetElement.dispatchEvent(event);\n    }\n\n    return () => {\n      unsubscribeFn?.();\n    };\n  }, [context, options?.subscribe, options?.element, handler, hostElement]);\n\n  return value;\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from 'react';\n\n/**\n * Internal React context for passing the host element to nested components.\n * This allows useWebComponentContext to dispatch events from the custom element.\n */\nexport const HostElementContext = createContext<HTMLElement | undefined>(undefined);\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport React, {\n  type JSX,\n  type PropsWithChildren,\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useRef,\n} from 'react';\n\nimport {\n  CONTEXT_PROVIDER_EVENT,\n  CONTEXT_REQUEST_EVENT,\n  type ContextCallback,\n  ContextProviderEvent,\n  ContextRequestEvent,\n  type ContextType,\n  type UnknownContext,\n} from '@dxos/web-context';\n\n/**\n * Handler function type for context requests passed via React context\n */\ntype ContextRequestHandler = (event: ContextRequestEvent<UnknownContext>) => boolean;\n\n/**\n * Internal React context for passing context request handlers down the tree.\n * This allows useWebComponentContext to work synchronously in React.\n */\nconst ContextRequestHandlerContext = createContext<ContextRequestHandler | undefined>(undefined);\n\n/**\n * Try to handle a context request using the React context chain.\n * Returns true if handled, false otherwise.\n * Used internally by useWebComponentContext.\n */\nexport function tryHandleContextRequest(event: ContextRequestEvent<UnknownContext>): boolean {\n  // This function is intended to be used where useContext is invalid (outside component),\n  // but context handling in React MUST happen inside components.\n  // So this helper might be less useful in React than in Solid if not used inside a hook/component.\n  // However, we can export the context itself for consumers to use `useContext`.\n  return false;\n}\n\n/**\n * Get the context request handler from React context.\n * Used internally by useWebComponentContext.\n */\nexport function useContextRequestHandler(): ContextRequestHandler | undefined {\n  return useContext(ContextRequestHandlerContext);\n}\n\n/**\n * Props for the ContextProtocolProvider component\n */\nexport interface ContextProtocolProviderProps<T extends UnknownContext> {\n  /** The context key to provide */\n  context: T;\n  /** The value to provide */\n  value: ContextType<T>;\n}\n\n/**\n * A provider component that:\n * 1. Handles context-request events from web components (via DOM events)\n * 2. Handles context requests from React consumers (via React context)\n * 3. Supports subscriptions for reactive updates\n * 4. Uses WeakRef for subscriptions to prevent memory leaks\n */\nexport const ContextProtocolProvider = <T extends UnknownContext>({\n  context,\n  value,\n  children,\n}: PropsWithChildren<ContextProtocolProviderProps<T>>): JSX.Element => {\n  // Get parent handler if one exists (for nested providers)\n  const parentHandler = useContext(ContextRequestHandlerContext);\n\n  // Track subscriptions with their stable unsubscribe functions and consumer host elements\n  interface SubscriptionInfo {\n    unsubscribe: () => void;\n    consumerHost: Element;\n    ref: WeakRef<ContextCallback<ContextType<T>>>;\n  }\n\n  // We use refs for mutable state that doesn't trigger re-renders\n  const subscriptions = useRef(new WeakMap<ContextCallback<ContextType<T>>, SubscriptionInfo>()).current;\n  const subscriptionRefs = useRef(new Set<WeakRef<ContextCallback<ContextType<T>>>>()).current;\n  const valueRef = useRef(value);\n\n  // Update value ref when prop changes\n  useEffect(() => {\n    valueRef.current = value;\n  }, [value]);\n\n  // Core handler logic\n  const handleRequest = useCallback(\n    (event: ContextRequestEvent<UnknownContext>): boolean => {\n      if (event.context !== context) {\n        if (parentHandler) {\n          return parentHandler(event);\n        }\n        return false;\n      }\n\n      const currentValue = valueRef.current; // Use latest value\n\n      if (event.subscribe) {\n        const callback = event.callback as ContextCallback<ContextType<T>>;\n        const consumerHost = event.contextTarget || (event.composedPath()[0] as Element);\n\n        const unsubscribe = () => {\n          const info = subscriptions.get(callback);\n          if (info) {\n            subscriptionRefs.delete(info.ref);\n            subscriptions.delete(callback);\n          }\n        };\n\n        const ref = new WeakRef(callback);\n        subscriptions.set(callback, { unsubscribe, consumerHost, ref });\n        subscriptionRefs.add(ref);\n\n        event.callback(currentValue, unsubscribe);\n      } else {\n        event.callback(currentValue);\n      }\n\n      return true;\n    },\n    [context, parentHandler], // Dependencies\n  );\n\n  // Handle DOM context-request events\n  const handleContextRequestEvent = useCallback(\n    (e: Event) => {\n      const event = e as ContextRequestEvent<UnknownContext>;\n      if (handleRequest(event)) {\n        event.stopImmediatePropagation();\n      }\n    },\n    [handleRequest],\n  );\n\n  // Handle context-provider events\n  const handleContextProviderEvent = useCallback(\n    (e: Event) => {\n      const event = e as ContextProviderEvent<UnknownContext>;\n      if (event.context !== context) {\n        return;\n      }\n      if (containerRef.current && event.contextTarget === containerRef.current) {\n        return;\n      }\n\n      const seen = new Set<ContextCallback<ContextType<T>>>();\n      for (const ref of subscriptionRefs) {\n        const callback = ref.deref();\n        if (!callback) {\n          subscriptionRefs.delete(ref);\n          continue;\n        }\n\n        const info = subscriptions.get(callback);\n        if (!info) {\n          continue;\n        }\n\n        if (seen.has(callback)) {\n          continue;\n        }\n        seen.add(callback);\n\n        info.consumerHost.dispatchEvent(\n          new ContextRequestEvent(context, callback, { subscribe: true, target: info.consumerHost }),\n        );\n      }\n      event.stopPropagation();\n    },\n    [context],\n  );\n\n  // Notify subscribers when value changes.\n  useEffect(() => {\n    // Skip notification if value hasn't changed? React does this for us if we use dependencies correctly?\n    // No, we need to imperatively call callbacks.\n    // value constraint is in the dependency array.\n\n    for (const ref of subscriptionRefs) {\n      const callback = ref.deref();\n      if (!callback) {\n        subscriptionRefs.delete(ref);\n        continue;\n      }\n      const info = subscriptions.get(callback);\n      if (info) {\n        callback(value, info.unsubscribe);\n      }\n    }\n  }, [value]);\n\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const el = containerRef.current;\n    if (!el) {\n      return;\n    }\n\n    el.addEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);\n    el.addEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);\n\n    // Announce provider.\n    el.dispatchEvent(new ContextProviderEvent(context, el));\n\n    return () => {\n      el.removeEventListener(CONTEXT_REQUEST_EVENT, handleContextRequestEvent);\n      el.removeEventListener(CONTEXT_PROVIDER_EVENT, handleContextProviderEvent);\n      subscriptionRefs.clear();\n    };\n  }, [handleContextRequestEvent, handleContextProviderEvent, context]);\n\n  return (\n    <ContextRequestHandlerContext.Provider value={handleRequest}>\n      <div className='contents' ref={containerRef}>\n        {children}\n      </div>\n    </ContextRequestHandlerContext.Provider>\n  );\n};\n"],
+  "mappings": "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",
+  "names": ["useContext", "useEffect", "useState", "ContextRequestEvent", "createContext", "HostElementContext", "undefined", "React", "createContext", "useCallback", "useContext", "useEffect", "useRef", "CONTEXT_PROVIDER_EVENT", "CONTEXT_REQUEST_EVENT", "ContextProviderEvent", "ContextRequestEvent", "ContextRequestHandlerContext", "undefined", "tryHandleContextRequest", "event", "useContextRequestHandler", "ContextProtocolProvider", "context", "value", "children", "parentHandler", "subscriptions", "WeakMap", "current", "subscriptionRefs", "Set", "valueRef", "handleRequest", "currentValue", "subscribe", "callback", "consumerHost", "contextTarget", "composedPath", "unsubscribe", "info", "get", "delete", "ref", "WeakRef", "set", "add", "handleContextRequestEvent", "e", "stopImmediatePropagation", "handleContextProviderEvent", "containerRef", "seen", "deref", "has", "dispatchEvent", "target", "stopPropagation", "el", "addEventListener", "removeEventListener", "clear", "Provider", "div", "className", "useWebComponentContext", "context", "options", "value", "setValue", "useState", "undefined", "handler", "useContextRequestHandler", "hostElement", "useContext", "HostElementContext", "useEffect", "unsubscribeFn", "callback", "newValue", "unsubscribe", "targetElement", "element", "document", "body", "event", "ContextRequestEvent", "subscribe", "target", "handled", "dispatchEvent"]
 }

package/dist/lib/node-esm/meta.json

@@ -1 +1 @@
-{"inputs":{"src/internal.ts":{"bytes":1209,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/provider.tsx":{"bytes":20824,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true}],"format":"esm"},"src/consumer.ts":{"bytes":6591,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"src/internal.ts","kind":"import-statement","original":"./internal"},{"path":"src/provider.tsx","kind":"import-statement","original":"./provider"}],"format":"esm"},"src/index.ts":{"bytes":659,"imports":[{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"src/consumer.ts","kind":"import-statement","original":"./consumer"},{"path":"src/provider.tsx","kind":"import-statement","original":"./provider"}],"format":"esm"}},"outputs":{"dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":15105},"dist/lib/node-esm/index.mjs":{"imports":[{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true}],"exports":["ContextProtocolProvider","tryHandleContextRequest","useContextRequestHandler","useWebComponentContext"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":35},"src/consumer.ts":{"bytesInOutput":1096},"src/internal.ts":{"bytesInOutput":87},"src/provider.tsx":{"bytesInOutput":3931}},"bytes":5493}}}
+{"inputs":{"src/internal.ts":{"bytes":1122,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/provider.tsx":{"bytes":21018,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true}],"format":"esm"},"src/consumer.ts":{"bytes":6500,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"src/internal.ts","kind":"import-statement","original":"./internal"},{"path":"src/provider.tsx","kind":"import-statement","original":"./provider"}],"format":"esm"},"src/index.ts":{"bytes":575,"imports":[{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"src/consumer.ts","kind":"import-statement","original":"./consumer"},{"path":"src/provider.tsx","kind":"import-statement","original":"./provider"}],"format":"esm"}},"outputs":{"dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":15046},"dist/lib/node-esm/index.mjs":{"imports":[{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/web-context","kind":"import-statement","external":true}],"exports":["ContextProtocolProvider","tryHandleContextRequest","useContextRequestHandler","useWebComponentContext"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":35},"src/consumer.ts":{"bytesInOutput":1096},"src/internal.ts":{"bytesInOutput":87},"src/provider.tsx":{"bytesInOutput":3991}},"bytes":5553}}}

package/dist/types/src/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/provider.tsx"],"names":[],"mappings":"AAIA,OAAc,EACZ,KAAK,GAAG,EACR,KAAK,iBAAiB,EAMvB,MAAM,OAAO,CAAC;AAEf,OAAO,EAKL,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,KAAK,qBAAqB,GAAG,CAAC,KAAK,EAAE,mBAAmB,CAAC,cAAc,CAAC,KAAK,OAAO,CAAC;AAQrF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,OAAO,CAM3F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,SAAS,CAE5E;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B,CAAC,CAAC,SAAS,cAAc;IACpE,iCAAiC;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,cAAc,EAAE,+BAI/D,iBAAiB,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,KAAG,GAAG,CAAC,OAiJ3D,CAAC"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/provider.tsx"],"names":[],"mappings":"AAIA,OAAc,EACZ,KAAK,GAAG,EACR,KAAK,iBAAiB,EAMvB,MAAM,OAAO,CAAC;AAEf,OAAO,EAKL,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,KAAK,qBAAqB,GAAG,CAAC,KAAK,EAAE,mBAAmB,CAAC,cAAc,CAAC,KAAK,OAAO,CAAC;AAQrF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,OAAO,CAM3F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,SAAS,CAE5E;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B,CAAC,CAAC,SAAS,cAAc;IACpE,iCAAiC;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,cAAc,iCAI7D,iBAAiB,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,KAAG,GAAG,CAAC,OA2J3D,CAAC"}