remote-components 0.0.51 → 0.1.2

package/dist/react/index.d.ts

@@ -1,8 +1,22 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { L as LoadRemoteComponentProps, O as OnRequestHook, a as OnResponseHook } from '../component-loader-1838f572.js';
-export { H as HookOptions } from '../component-loader-1838f572.js';
+import { R as ResolveClientUrl } from '../proxy-through-host-a676a522.js';
+export { p as proxyClientRequestsThroughHost } from '../proxy-through-host-a676a522.js';
+import { H as HostConfig, C as ClientHostConfig, a as HostLifecycleCallbacks, L as LoadRemoteComponentProps } from '../component-loader-21865da3.js';
+export { b as HookOptions, O as OnRequestHook, c as OnResponseHook } from '../component-loader-21865da3.js';
 import 'react';
 
+/**
+ * Client-side context provider for passing `resolveClientUrl` to all nested
+ * `<RemoteComponent>` instances. Since `resolveClientUrl` is a function, it
+ * can't be passed as a prop through Server Components — this provider should
+ * wrap the tree in a Client Component boundary so the callback is available
+ * on the client where asset fetches happen.
+ */
+declare function RemoteComponentsProvider({ resolveClientUrl, children, }: {
+    resolveClientUrl?: ResolveClientUrl;
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
 declare module 'react/jsx-runtime' {
     namespace JSX {
         interface IntrinsicElements {
@@ -18,45 +32,18 @@ declare module 'react/jsx-runtime' {
         }
     }
 }
-interface RemoteComponentProps {
-    /** The source URL of the remote component. */
-    src?: string | URL;
-    /** Whether to isolate the remote component using a Shadow DOM wrapper. */
-    isolate?: boolean;
-    /** The shadow DOM mode to use when isolating the remote component. */
-    mode?: 'open' | 'closed';
-    /** Whether to include a CSS reset style in the shadow DOM. Defaults to `false`. */
-    reset?: boolean;
-    /** The credentials to use for the fetch request. Defaults to `same-origin`. */
-    credentials?: RequestCredentials;
-    name?: string;
+/**
+ * Props for the React remote component host.
+ *
+ * Extends {@link HostConfig}, {@link ClientHostConfig}, and
+ * {@link HostLifecycleCallbacks}. Adds `shared` for module sharing and
+ * `children` for loading fallback content.
+ */
+interface RemoteComponentProps extends HostConfig, ClientHostConfig, HostLifecycleCallbacks {
     /** Shared modules to include in the remote component's context. */
     shared?: LoadRemoteComponentProps['shared'];
-    /** The children to use as a loading fallback until the remote component is loaded. */
+    /** Loading fallback content displayed while the remote component is being fetched. */
     children?: React.ReactNode;
-    /** Called right before a new remote component load starts. */
-    onBeforeLoad?: (src: string | URL) => void;
-    /** Called when the remote component has been successfully loaded and mounted. */
-    onLoad?: (src: string | URL) => void;
-    /** Called when an error occurs while loading or mounting the remote component. */
-    onError?: (error: unknown) => void;
-    /** Called when a different remote component is loaded into the same wrapper. */
-    onChange?: (info: {
-        previousSrc: string | URL | null;
-        nextSrc: string | URL | null;
-        previousName: string | undefined;
-        nextName: string | undefined;
-    }) => void;
-    /**
-     * Called when a fetch request is made to retrieve the remote component payload.
-     * Can be used to intercept requests, modify headers, or provide a custom response.
-     */
-    onRequest?: OnRequestHook;
-    /**
-     * Called after a fetch completes to retrieve the remote component payload.
-     * Can be used to inspect the response (e.g., check for redirects) or transform it.
-     */
-    onResponse?: OnResponseHook;
 }
 /**
  * RemoteComponent is a React component that fetches and renders a remote component.
@@ -94,6 +81,6 @@ interface RemoteComponentProps {
  * />
  * ```
  */
-declare function RemoteComponent({ src, isolate, mode, reset, credentials, name: nameProp, shared, children, onBeforeLoad, onLoad, onError, onChange, onRequest, onResponse, }: RemoteComponentProps): react_jsx_runtime.JSX.Element;
+declare function RemoteComponent({ src, isolate, mode, reset, credentials, name: nameProp, shared, children, onBeforeLoad, onLoad, onError, onChange, onRequest, onResponse, resolveClientUrl: _resolveClientUrl, }: RemoteComponentProps): react_jsx_runtime.JSX.Element;
 
-export { OnRequestHook, OnResponseHook, RemoteComponent, RemoteComponentProps };
+export { RemoteComponent, RemoteComponentProps, RemoteComponentsProvider, ResolveClientUrl };