react-on-rails 17.0.0-rc.1 → 17.0.0-rc.10

package/README.md

@@ -81,11 +81,12 @@ ReactOnRails.register({
 
 ## Exports
 
-| Export Path             | Description                         |
-| ----------------------- | ----------------------------------- |
-| `react-on-rails`        | Full build with SSR utilities       |
-| `react-on-rails/client` | Client-only build (smaller, no SSR) |
-| `react-on-rails/types`  | TypeScript type exports             |
+| Export Path                  | Description                          |
+| ---------------------------- | ------------------------------------ |
+| `react-on-rails`             | Full build with SSR utilities        |
+| `react-on-rails/client`      | Client-only build (smaller, no SSR)  |
+| `react-on-rails/railsAction` | CSRF-aware typed Rails action caller |
+| `react-on-rails/types`       | TypeScript type exports              |
 
 ## Rails-Side Setup
 

package/lib/ClientRenderer.js

@@ -6,9 +6,66 @@ import { getRailsContext } from "./context.js";
 import { isServerRenderHash } from "./isServerRenderResult.js";
 import { onPageUnloaded } from "./pageLifecycle.js";
 import { supportsRootApi, unmountComponentAtNode } from "./reactApis.cjs";
+import { isRendererTeardownResult } from "./rendererTeardown.js";
+import { buildRootErrorCallbackOptions } from "./rootErrorHandlers.js";
+import { convertToError } from "./errorUtils.js";
+import { isThenable } from "./isThenable.js";
 const REACT_ON_RAILS_STORE_ATTRIBUTE = 'data-js-react-on-rails-store';
 // Track all rendered roots for cleanup
 const renderedRoots = new Map();
+/**
+ * Invokes a renderer teardown, swallowing async rejections so a failing teardown cannot produce an
+ * unhandled promise rejection. Synchronous throws propagate to the caller's try/catch. `domNodeId`
+ * is included in the log so a failure can be traced to its mount.
+ * MIRROR OF: packages/react-on-rails-pro/src/ClientSideRenderer.ts (sibling helper). If you change
+ * the error-handling logic or log format here, update that copy too.
+ */
+function invokeRendererTeardown(teardown, domNodeId) {
+    if (!teardown)
+        return;
+    const maybePromise = teardown();
+    if (isThenable(maybePromise)) {
+        // Detect a thenable with `.then` (Promises/A+) but swallow the rejection via
+        // `Promise.resolve(...).catch(...)`: a non-native thenable may lack `.catch`, so calling it
+        // directly could itself throw or leave the rejection unhandled. This keeps a failing async
+        // teardown from surfacing as an unhandled promise rejection.
+        Promise.resolve(maybePromise).catch((error) => {
+            console.error(`Error in renderer teardown for dom node "${domNodeId}":`, error);
+        });
+    }
+}
+/**
+ * Tears down a single tracked entry: runs the renderer's teardown, or unmounts the React root.
+ * Synchronous errors are not caught here; callers wrap this in try/catch so one failure does not
+ * abort cleanup of the remaining entries.
+ */
+function teardownEntry(entry, domNodeId) {
+    if (entry.kind === 'scheduled') {
+        entry.cancel();
+        return;
+    }
+    if (entry.kind === 'renderer') {
+        invokeRendererTeardown(entry.teardown, domNodeId);
+        return;
+    }
+    if (supportsRootApi && entry.root && typeof entry.root === 'object' && 'unmount' in entry.root) {
+        // React 18+ Root API
+        entry.root.unmount();
+    }
+    else {
+        // React 16-17 legacy API
+        unmountComponentAtNode(entry.domNode);
+    }
+}
+function teardownErrorLabel(entry, domNodeId) {
+    if (entry.kind === 'renderer') {
+        return `Error in renderer teardown for dom node "${domNodeId}":`;
+    }
+    if (entry.kind === 'scheduled') {
+        return `Error canceling scheduled render for dom node "${domNodeId}":`;
+    }
+    return `Error unmounting component for dom node "${domNodeId}":`;
+}
 function initializeStore(el, railsContext) {
     const name = el.getAttribute(REACT_ON_RAILS_STORE_ATTRIBUTE) || '';
     const props = el.textContent !== null ? JSON.parse(el.textContent) : {};
@@ -25,6 +82,103 @@ function forEachStore(railsContext) {
 function domNodeIdForEl(el) {
     return el.getAttribute('data-dom-id') || '';
 }
+function hydrateOnForEl(el) {
+    const hydrateOn = el.getAttribute('data-hydrate-on');
+    if (!hydrateOn || hydrateOn === 'immediate' || hydrateOn === 'visible' || hydrateOn === 'idle') {
+        return (hydrateOn || 'immediate');
+    }
+    console.warn(`[react-on-rails] Unsupported hydrate_on: ${hydrateOn}.`);
+    return 'immediate';
+}
+function hasObservableArea(element) {
+    const rects = element.getClientRects();
+    for (let index = 0; index < rects.length; index += 1) {
+        const rect = rects[index];
+        if (rect.width > 0 && rect.height > 0)
+            return true;
+    }
+    const boundingRect = element.getBoundingClientRect();
+    return boundingRect.width > 0 && boundingRect.height > 0;
+}
+function scheduleTimeout(callback, delay) {
+    const timeoutId = window.setTimeout(callback, delay);
+    return () => window.clearTimeout(timeoutId);
+}
+function scheduleWhenVisible(domNode, callback) {
+    if (typeof IntersectionObserver === 'undefined') {
+        console.warn('[react-on-rails] No IntersectionObserver.');
+        return scheduleTimeout(callback, 0);
+    }
+    if (!domNode.hasChildNodes() && !hasObservableArea(domNode)) {
+        return scheduleTimeout(callback, 0);
+    }
+    const observer = new IntersectionObserver((entries) => {
+        // Disconnect early if the target was removed outside Turbo navigation to avoid a
+        // leaked observer holding a live reference to a detached node.
+        const target = entries[0]?.target;
+        if (target && !target.isConnected) {
+            observer.disconnect();
+            callback();
+            return;
+        }
+        const isVisible = entries.some((entry) => entry.isIntersecting || entry.intersectionRatio > 0);
+        if (!isVisible)
+            return;
+        observer.disconnect();
+        callback();
+    }, { rootMargin: '200px 0px' });
+    observer.observe(domNode);
+    return () => {
+        observer.disconnect();
+    };
+}
+function scheduleWhenIdle(callback) {
+    const idleWindow = window;
+    if (typeof idleWindow.requestIdleCallback === 'function') {
+        const idleCallbackId = idleWindow.requestIdleCallback(callback, { timeout: 2000 });
+        return () => {
+            if (typeof idleWindow.cancelIdleCallback === 'function') {
+                idleWindow.cancelIdleCallback(idleCallbackId);
+            }
+        };
+    }
+    // Safari lacks requestIdleCallback; 50 ms defers past the current frame without a layout-blocking
+    // setTimeout(0) but still far enough before most long-idle periods (matching common polyfill defaults).
+    return scheduleTimeout(callback, 50);
+}
+function scheduleHydration(hydrateOn, domNode, callback) {
+    if (hydrateOn === 'visible') {
+        return scheduleWhenVisible(domNode, callback);
+    }
+    if (hydrateOn === 'idle') {
+        return scheduleWhenIdle(callback);
+    }
+    // Defensive: `renderElement` short-circuits for `immediate` before calling `scheduleHydration`, so
+    // this branch is normally unreachable; it acts as a safe fallback guard for future callers.
+    callback();
+    return () => { };
+}
+// Logs a normalized copy of the original thrown value, then returns a fresh ReactOnRails-prefixed
+// error for callers to throw/report. This must not mutate the original value: user code can throw
+// strings, null, cross-realm errors, or frozen Error instances, and delayed hydration catches run
+// inside scheduler callbacks where an error reporter that throws would escape the callback.
+function prepareRenderError(componentName, error) {
+    const originalError = convertToError(error);
+    console.error(originalError);
+    const renderError = new Error(`ReactOnRails encountered an error while rendering component: ${componentName}. See above error message.`);
+    renderError.cause = originalError;
+    if (typeof originalError.stack === 'string') {
+        renderError.stack = originalError.stack;
+    }
+    return renderError;
+}
+function raiseRenderError(componentName, error) {
+    throw prepareRenderError(componentName, error);
+}
+function reportRenderError(componentName, error) {
+    // prepareRenderError already logged the original error; do not log again (avoids the double-log).
+    prepareRenderError(componentName, error);
+}
 function delegateToRenderer(componentObj, props, railsContext, domNodeId, trace) {
     const { name, component, isRenderer } = componentObj;
     if (isRenderer) {
@@ -32,18 +186,94 @@ function delegateToRenderer(componentObj, props, railsContext, domNodeId, trace)
             console.log(`\
 DELEGATING TO RENDERER ${name} for dom node with id: ${domNodeId} with props, railsContext:`, props, railsContext);
         }
-        // Call the renderer function with the expected signature
-        component(props, railsContext, domNodeId);
-        return true;
+        // Call the renderer function with the expected signature. A renderer owns its own mount and may
+        // return nothing, a teardown wrapper, or a promise resolving to one. `component` is the registered
+        // component union, so `as RendererFunction` is a runtime-invariant assertion guarded by
+        // `isRenderer` (the registry only sets it for a 3-arg render function), not a structural
+        // narrowing.
+        if (typeof component !== 'function') {
+            throw new Error(`Registered renderer "${name}" must be a function.`);
+        }
+        const result = component(props, railsContext, domNodeId);
+        return { delegated: true, result };
+    }
+    return { delegated: false };
+}
+/**
+ * Records a renderer-function mount and captures its optional teardown. The renderer may return a
+ * teardown wrapper synchronously, or a promise resolving to one (async renderers). The entry is
+ * stored immediately so the replaced-node path can find it even before an async teardown resolves.
+ *
+ * Known limitation (core package): if the mount is unmounted or its node is replaced *before* an
+ * async renderer resolves its teardown, the still-pending teardown is dropped and that one mount
+ * leaks — the resolved teardown is discarded because the entry is no longer the active mount for
+ * this id (the `renderedRoots.get(domNodeId) === entry` guard below). The drop is an expected,
+ * documented core limitation, but it still leaves a renderer-owned mount uncleaned, so it is logged
+ * with `console.error` rather than silently ignored. Synchronous teardowns are unaffected. The Pro
+ * client renderer (`react-on-rails-pro`) awaits the renderer and re-checks the unmount state, so it
+ * runs the teardown even when a navigation races the resolve; prefer Pro if you depend on async
+ * renderer teardowns surviving fast navigations.
+ *
+ * Renderer results that ultimately do not include a teardown wrapper are left untracked:
+ * synchronous no-wrapper returns are not stored, and async results that resolve without a wrapper use
+ * only a temporary placeholder until the promise settles. Before this cleanup contract existed,
+ * renderer-owned mounts were never tracked, so repeated page-loaded calls re-invoked those legacy
+ * renderers; preserving that behavior keeps "return nothing" backward compatible.
+ */
+function trackRendererMount(domNodeId, domNode, result) {
+    if (isRendererTeardownResult(result)) {
+        renderedRoots.set(domNodeId, { kind: 'renderer', domNode, teardown: result.teardown });
+    }
+    else if (isThenable(result)) {
+        const entry = { kind: 'renderer', domNode, teardown: undefined };
+        renderedRoots.set(domNodeId, entry);
+        Promise.resolve(result)
+            .then((resolved) => {
+            if (!isRendererTeardownResult(resolved)) {
+                if (renderedRoots.get(domNodeId) === entry) {
+                    renderedRoots.delete(domNodeId);
+                }
+                return;
+            }
+            // Only attach if this exact entry is still the active mount for this id.
+            if (renderedRoots.get(domNodeId) === entry) {
+                entry.teardown = resolved.teardown;
+            }
+            else {
+                // The mount was unmounted or its node replaced before this async teardown resolved, so the
+                // entry is no longer the active mount and the teardown can't be attached — it is dropped
+                // and that one mount may leak on cleanup. This is the expected, documented best-effort core
+                // limitation, but the consequence is still a leak, so log it as an error. Pro avoids this
+                // race entirely.
+                console.error(`[react-on-rails] Renderer teardown for dom node "${domNodeId}" resolved after the ` +
+                    'page or node was already cleaned up; the teardown was dropped and that mount may ' +
+                    'leak. Use react-on-rails-pro for reliable async-renderer teardown on fast navigations.');
+            }
+        })
+            .catch((error) => {
+            const isStillActive = renderedRoots.get(domNodeId) === entry;
+            if (!isStillActive) {
+                return;
+            }
+            renderedRoots.delete(domNodeId);
+            // The renderer's own promise rejected: the render failed, so the component never mounted and
+            // no teardown was captured. Log it (rather than letting it surface as an unhandled rejection)
+            // so the failure is diagnosable; any partial mount the renderer created may leak on cleanup.
+            // If this placeholder was already removed by page unload or node replacement, the page/node is
+            // already being cleaned up, so suppress a stale rejection log from the abandoned renderer.
+            console.error(`Renderer for dom node "${domNodeId}" rejected; the component did not mount and no ` +
+                'teardown was captured. Any mount it created may leak on cleanup:', error);
+        });
     }
-    return false;
 }
 /**
  * Used for client rendering by ReactOnRails. Either calls ReactDOM.hydrate, ReactDOM.render, or
  * delegates to a renderer registered by the user.
  */
 function renderElement(el, railsContext) {
-    // This must match lib/react_on_rails/helper.rb
+    // This must match the data-* attributes emitted by lib/react_on_rails/pro_helper.rb.
+    // Covered end-to-end by every spec/dummy client-rendering test (renaming either side fails
+    // loudly), so no MIRROR VALUES guard is added here.
     const name = el.getAttribute('data-component-name') || '';
     const domNodeId = domNodeIdForEl(el);
     const props = el.textContent !== null ? JSON.parse(el.textContent) : {};
@@ -56,69 +286,97 @@ function renderElement(el, railsContext) {
             // (e.g., for asynchronously loaded content)
             const existing = renderedRoots.get(domNodeId);
             if (existing) {
-                // Only skip if it's the exact same DOM node and it's still connected to the document.
-                // If the node was replaced (e.g., via innerHTML or Turbo), we need to unmount the old
-                // root and re-render to the new node to prevent memory leaks and ensure rendering works.
-                const sameNode = existing.domNode === domNode && existing.domNode.isConnected;
+                // Only skip if it's the exact same DOM node, it's still connected to the document, AND it has
+                // actually mounted. A `scheduled` entry has not mounted yet: if its node was detached and later
+                // reattached (e.g. Turbo cache restore or a DOM move), its IntersectionObserver was disconnected
+                // and will never re-observe, so we must fall through to cancel the stale schedule and re-schedule
+                // fresh rather than skip (which would leave the island permanently non-interactive).
+                // If the node was replaced (e.g., via innerHTML or Turbo), we likewise need to unmount/cancel the
+                // old entry and re-render to the new node to prevent memory leaks and ensure rendering works.
+                const sameNode = existing.kind !== 'scheduled' && existing.domNode === domNode && existing.domNode.isConnected;
                 if (sameNode) {
                     if (trace) {
                         console.log(`Skipping already rendered component: ${name} (dom id: ${domNodeId})`);
                     }
                     return;
                 }
-                // DOM node was replaced (e.g., via async HTML injection) - clean up the old root
+                // DOM node was replaced (e.g., via async HTML injection) - clean up the old root or run
+                // the old renderer's teardown.
                 try {
-                    if (supportsRootApi &&
-                        existing.root &&
-                        typeof existing.root === 'object' &&
-                        'unmount' in existing.root) {
-                        existing.root.unmount();
-                    }
-                    else {
-                        unmountComponentAtNode(existing.domNode);
-                    }
+                    teardownEntry(existing, domNodeId);
                 }
                 catch (unmountError) {
-                    // Ignore unmount errors for replaced nodes
-                    if (trace) {
-                        console.log(`Error unmounting replaced component: ${name}`, unmountError);
-                    }
+                    // Surface the failure unconditionally (matching unmountAllComponents) so a teardown/unmount
+                    // error on node replacement is as visible as one on page unload, using the same greppable
+                    // labels. We still continue: the old mount may leak, but the new node must be rendered.
+                    console.error(teardownErrorLabel(existing, domNodeId), unmountError);
                 }
                 renderedRoots.delete(domNodeId);
             }
             const componentObj = ComponentRegistry.get(name);
-            if (delegateToRenderer(componentObj, props, railsContext, domNodeId, trace)) {
+            const delegation = delegateToRenderer(componentObj, props, railsContext, domNodeId, trace);
+            if (delegation.delegated) {
+                // The renderer owns its own mount; record it (with any teardown wrapper it returned) so it
+                // gets cleaned up on page unload or same-id node replacement.
+                trackRendererMount(domNodeId, domNode, delegation.result);
                 return;
             }
-            // Hydrate if the DOM node has content (server-rendered HTML)
-            // Since we skip already-rendered components above, this check now correctly
-            // identifies only server-rendered content, not previously client-rendered content
-            const shouldHydrate = !!domNode.innerHTML;
-            const reactElementOrRouterResult = createReactOutput({
-                componentObj,
-                props,
-                domNodeId,
-                trace,
-                railsContext,
-                shouldHydrate,
-            });
-            if (isServerRenderHash(reactElementOrRouterResult)) {
-                throw new Error(`\
+            const mountReactRoot = () => {
+                // Hydrate if the DOM node has content (server-rendered HTML)
+                // Since we skip already-rendered components above, this check now correctly
+                // identifies only server-rendered content, not previously client-rendered content
+                const shouldHydrate = !!domNode.innerHTML;
+                const reactElementOrRouterResult = createReactOutput({
+                    componentObj,
+                    props,
+                    domNodeId,
+                    trace,
+                    railsContext,
+                    shouldHydrate,
+                });
+                if (isServerRenderHash(reactElementOrRouterResult)) {
+                    throw new Error(`\
 You returned a server side type of react-router error: ${JSON.stringify(reactElementOrRouterResult)}
 You should return a React.Component always for the client side entry point.`);
-            }
-            else {
-                const root = reactHydrateOrRender(domNode, reactElementOrRouterResult, shouldHydrate);
+                }
+                const root = reactHydrateOrRender(domNode, reactElementOrRouterResult, shouldHydrate, 
+                // Attach user-registered root error callbacks (and the dev-mode hydration-mismatch
+                // logger) to every root, enriched with this mount's component name and dom id.
+                buildRootErrorCallbackOptions({ componentName: name || undefined, domNodeId: domNodeId || undefined }, shouldHydrate));
                 // Track the root for cleanup
-                renderedRoots.set(domNodeId, { root, domNode });
+                renderedRoots.set(domNodeId, { kind: 'react', root, domNode });
+            };
+            const hydrateOn = hydrateOnForEl(el);
+            if (hydrateOn === 'immediate') {
+                mountReactRoot();
+                return;
             }
+            let scheduledEntry;
+            const runScheduledRender = () => {
+                if (renderedRoots.get(domNodeId) !== scheduledEntry)
+                    return;
+                if (!domNode.isConnected) {
+                    renderedRoots.delete(domNodeId);
+                    return;
+                }
+                try {
+                    mountReactRoot();
+                }
+                catch (scheduledError) {
+                    renderedRoots.delete(domNodeId);
+                    reportRenderError(name, scheduledError);
+                }
+            };
+            scheduledEntry = {
+                kind: 'scheduled',
+                domNode,
+                cancel: scheduleHydration(hydrateOn, domNode, runScheduledRender),
+            };
+            renderedRoots.set(domNodeId, scheduledEntry);
         }
     }
     catch (e) {
-        const error = e;
-        console.error(error.message);
-        error.message = `ReactOnRails encountered an error while rendering component: ${name}. See above error message.`;
-        throw error;
+        raiseRenderError(name, e);
     }
 }
 /**
@@ -165,23 +423,17 @@ export function reactOnRailsComponentLoaded(domId) {
     return Promise.resolve();
 }
 /**
- * Unmount all rendered React components and clear roots.
- * This should be called on page unload to prevent memory leaks.
+ * Unmount all rendered React components, run all renderer-function teardowns, and clear roots.
+ * Registered with `onPageUnloaded` to run on the page-unload lifecycle (Turbo/Turbolinks
+ * soft-navigation page swap, not a native browser unload) to prevent memory leaks.
  */
 function unmountAllComponents() {
-    renderedRoots.forEach(({ root, domNode }) => {
+    renderedRoots.forEach((entry, domNodeId) => {
         try {
-            if (supportsRootApi && root && typeof root === 'object' && 'unmount' in root) {
-                // React 18+ Root API
-                root.unmount();
-            }
-            else {
-                // React 16-17 legacy API
-                unmountComponentAtNode(domNode);
-            }
+            teardownEntry(entry, domNodeId);
         }
         catch (error) {
-            console.error('Error unmounting component:', error);
+            console.error(teardownErrorLabel(entry, domNodeId), error);
         }
     });
     renderedRoots.clear();

package/lib/ComponentRegistry.d.ts

@@ -1,20 +1,21 @@
-import type { RegisteredComponent, ReactComponentOrRenderFunction } from './types/index.ts';
+import type { RegisteredComponent, RegisteredComponentValue } from './types/index.ts';
+type RegisteredComponentEntry = RegisteredComponent<RegisteredComponentValue>;
 declare const _default: {
     /**
      * @param components { component1: component1, component2: component2, etc. }
      */
-    register(components: Record<string, ReactComponentOrRenderFunction>): void;
+    register(components: Record<string, RegisteredComponentValue>): void;
     /**
      * @param name
      * @returns { name, component, renderFunction, isRenderer }
      */
-    get(name: string): RegisteredComponent;
+    get(name: string): RegisteredComponentEntry;
     /**
      * Get a Map containing all registered components. Useful for debugging.
      * @returns Map where key is the component name and values are the
      * { name, component, renderFunction, isRenderer}
      */
-    components(): Map<string, RegisteredComponent>;
+    components(): Map<string, RegisteredComponentEntry>;
     /**
      * Pro-only method that waits for component registration
      * @param _name Component name to wait for

package/lib/StoreRegistry.d.ts

@@ -29,6 +29,10 @@ declare const _default: {
      * Internally used function to completely clear hydratedStores Map.
      */
     clearHydratedStores(): void;
+    /**
+     * Internally used function to completely clear registeredStoreGenerators Map.
+     */
+    clearStoreGenerators(): void;
     /**
      * Get a Map containing all registered store generators. Useful for debugging.
      * @returns Map where key is the component name and values are the store generators.

package/lib/StoreRegistry.js

@@ -33,6 +33,9 @@ export default {
         if (hydratedStores.has(name)) {
             return hydratedStores.get(name);
         }
+        if (!throwIfMissing) {
+            return undefined;
+        }
         const storeKeys = Array.from(hydratedStores.keys()).join(', ');
         if (storeKeys.length === 0) {
             const msg = `There are no stores hydrated and you are requesting the store ${name}.
@@ -42,12 +45,8 @@ This can happen if you are server rendering and either:
 2. You do not render redux_store_hydration_data anywhere on your page.`;
             throw new Error(msg);
         }
-        if (throwIfMissing) {
-            console.log('storeKeys', storeKeys);
-            throw new Error(`Could not find hydrated store with name '${name}'. ` +
-                `Hydrated store names include [${storeKeys}].`);
-        }
-        return undefined;
+        console.log('storeKeys', storeKeys);
+        throw new Error(`Could not find hydrated store with name '${name}'. Hydrated store names include [${storeKeys}].`);
     },
     /**
      * Internally used function to get the store creator that was passed to `register`.
@@ -77,6 +76,12 @@ This can happen if you are server rendering and either:
     clearHydratedStores() {
         hydratedStores.clear();
     },
+    /**
+     * Internally used function to completely clear registeredStoreGenerators Map.
+     */
+    clearStoreGenerators() {
+        registeredStoreGenerators.clear();
+    },
     /**
      * Get a Map containing all registered store generators. Useful for debugging.
      * @returns Map where key is the component name and values are the store generators.

package/lib/base/client.d.ts

@@ -2,12 +2,13 @@
  * @deprecated Use `capabilities/core.ts` instead. This file is kept for backward compatibility
  * with older versions of react-on-rails-pro that import from `react-on-rails/@internal/base/client`.
  */
-import type { RegisteredComponent, ReactComponentOrRenderFunction, Store, StoreGenerator, ReactOnRailsInternal } from '../types/index.ts';
+import type { RegisteredComponent, RegisteredComponentValue, Store, StoreGenerator, ReactOnRailsInternal } from '../types/index.ts';
+type RegisteredComponentEntry = RegisteredComponent<RegisteredComponentValue>;
 interface Registries {
     ComponentRegistry: {
-        register: (components: Record<string, ReactComponentOrRenderFunction>) => void;
-        get: (name: string) => RegisteredComponent;
-        components: () => Map<string, RegisteredComponent>;
+        register: (components: Record<string, RegisteredComponentValue>) => void;
+        get: (name: string) => RegisteredComponentEntry;
+        components: () => Map<string, RegisteredComponentEntry>;
     };
     StoreRegistry: {
         register: (storeGenerators: Record<string, StoreGenerator>) => void;
@@ -15,6 +16,7 @@ interface Registries {
         getStoreGenerator: (name: string) => StoreGenerator;
         setStore: (name: string, store: Store) => void;
         clearHydratedStores: () => void;
+        clearStoreGenerators: () => void;
         storeGenerators: () => Map<string, StoreGenerator>;
         stores: () => Map<string, Store>;
     };