@sprucelabs/spruce-heartwood-utils 38.17.4 → 38.17.6

package/README.md

@@ -1,6 +1,6 @@
 # @sprucelabs/spruce-heartwood-utils
 
-Tools for building Spruce skills that integrate with Heartwood — remote card loading, auto-logout control, animation primitives, and testing utilities.
+Heartwood integration toolkit for Spruce skills. Use this package to load remote cards, register and render cross-skill views, apply shared theme behavior, drive animation/layout primitives, and test the full flow with built-in mocks.
 
 ---
 
@@ -14,16 +14,99 @@ This package is designed for use inside a Spruce skill. It expects `@sprucelabs/
 
 ---
 
+## Project Pitch
+
+Building a Spruce experience usually means combining:
+- browser/runtime view infrastructure
+- test utilities for remote card/event flows
+- animation and layout primitives used in Heartwood views
+
+`@sprucelabs/spruce-heartwood-utils` packages those into one module with explicit entrypoints so you can keep browser bundles clean while still getting first-class testing helpers.
+
+---
+
+## What You Get
+
+- Remote view controller infrastructure:
+`RemoteViewControllerFactoryImpl`, `CardRegistrar`, shared remote VC types
+- Theming and plugins:
+`loadActiveThemeForOrg`, `AutoLogoutPlugin`
+- Test harness pieces:
+`remoteVcAssert`, `fakeGetViews`, `MockRemoteViewControllerFactory`, `SpyAutoLogoutPlugin`
+- Animation/layout primitives:
+`Sizer`, `DelayedPlacer`, queue/show helpers, emitters, settings utilities
+
+---
+
+## Import Paths
+
+- `@sprucelabs/spruce-heartwood-utils/web` for browser-safe runtime imports (recommended for Vite/Bun/ESM apps)
+- `@sprucelabs/spruce-heartwood-utils/testing` for test helpers and mocks
+- `@sprucelabs/spruce-heartwood-utils` keeps the legacy mixed export surface for existing consumers
+
+---
+
+## Get Started
+
+### Web Only
+
+Use this when you are shipping runtime/browser code and do not need test helpers in that code path.
+
+```ts
+import {
+    CardRegistrar,
+    RemoteViewControllerFactoryImpl,
+    AutoLogoutPlugin,
+    loadActiveThemeForOrg,
+    Sizer,
+    SimpleEmitter,
+} from '@sprucelabs/spruce-heartwood-utils/web'
+```
+
+### Tests Only
+
+Use this in test suites where you need to fake remote views and assert event-driven card registration.
+
+```ts
+import {
+    remoteVcAssert,
+    fakeGetViews,
+    MockRemoteViewControllerFactory,
+    SpyAutoLogoutPlugin,
+} from '@sprucelabs/spruce-heartwood-utils/testing'
+```
+
+### Web + Tests
+
+Use split imports so runtime code stays browser-safe while tests get all mocks/helpers.
+
+```ts
+import {
+    CardRegistrar,
+    RemoteViewControllerFactoryImpl,
+} from '@sprucelabs/spruce-heartwood-utils/web'
+import {
+    remoteVcAssert,
+    MockRemoteViewControllerFactory,
+} from '@sprucelabs/spruce-heartwood-utils/testing'
+```
+
+---
+
 ## Table of Contents
 
-1. [Remote View Controllers](#remote-view-controllers)
-2. [CardRegistrar](#cardregistrar)
-3. [Types](#types)
-4. [Theming](#theming)
-5. [Plugins](#plugins)
-6. [Test Utilities](#test-utilities)
-7. [Device & Layout Utilities](#device--layout-utilities)
-8. [Animation](#animation)
+1. [Project Pitch](#project-pitch)
+2. [What You Get](#what-you-get)
+3. [Import Paths](#import-paths)
+4. [Get Started](#get-started)
+5. [Remote View Controllers](#remote-view-controllers)
+6. [CardRegistrar](#cardregistrar)
+7. [Types](#types)
+8. [Theming](#theming)
+9. [Plugins](#plugins)
+10. [Test Utilities](#test-utilities)
+11. [Device & Layout Utilities](#device--layout-utilities)
+12. [Animation](#animation)
    - [Quick Start](#quick-start)
    - [Required CSS](#required-css)
    - [System Architecture](#system-architecture)
@@ -49,7 +132,7 @@ Fetches compiled ViewController source from the `heartwood.get-skill-views` even
 import {
     RemoteViewControllerFactoryImpl,
     RemoteViewControllerFactory,
-} from '@sprucelabs/spruce-heartwood-utils'
+} from '@sprucelabs/spruce-heartwood-utils/web'
 ```
 
 **Injecting a mock factory in tests:**
@@ -77,7 +160,7 @@ const vc = await remoteVcFactory.RemoteController(
 The interface that both `RemoteViewControllerFactoryImpl` and `MockRemoteViewControllerFactory` implement. Use this type for any field that may hold the real factory or a test mock:
 
 ```ts
-import { RemoteViewControllerFactory } from '@sprucelabs/spruce-heartwood-utils'
+import { RemoteViewControllerFactory } from '@sprucelabs/spruce-heartwood-utils/web'
 
 private remoteVcFactory: RemoteViewControllerFactory
 ```
@@ -89,7 +172,7 @@ private remoteVcFactory: RemoteViewControllerFactory
 Options passed to `RemoteViewControllerFactoryImpl.Factory()`.
 
 ```ts
-import { RemoteFactoryOptions } from '@sprucelabs/spruce-heartwood-utils'
+import { RemoteFactoryOptions } from '@sprucelabs/spruce-heartwood-utils/web'
 
 interface RemoteFactoryOptions {
     connectToApi: () => Promise<MercuryClient>
@@ -104,7 +187,7 @@ interface RemoteFactoryOptions {
 A narrowed subset of `ViewControllerFactory` containing only what the remote factory needs. Use this type when accepting or storing a factory reference to avoid a full `ViewControllerFactory` dependency:
 
 ```ts
-import { VcFactoryForRemoteFactory } from '@sprucelabs/spruce-heartwood-utils'
+import { VcFactoryForRemoteFactory } from '@sprucelabs/spruce-heartwood-utils/web'
 
 private views: VcFactoryForRemoteFactory
 ```
@@ -121,7 +204,7 @@ import {
     CardRegistrarOptions,
     CardFetchOptions,
     EachCardHandler,
-} from '@sprucelabs/spruce-heartwood-utils'
+} from '@sprucelabs/spruce-heartwood-utils/web'
 ```
 
 ### `CardRegistrar.Registrar(options)`
@@ -203,7 +286,7 @@ type CardFetchOptions<Contract, Name> = {
 The shape of a card loaded from another skill. Extends `ViewController<Card>` with an optional `load()` method so you can forward load arguments after the card is rendered.
 
 ```ts
-import { RemoteDashboardCard } from '@sprucelabs/spruce-heartwood-utils'
+import { RemoteDashboardCard } from '@sprucelabs/spruce-heartwood-utils/web'
 
 interface RemoteDashboardCard extends ViewController<Card> {
     load?(options: SkillViewControllerLoadOptions): Promise<void>
@@ -235,7 +318,7 @@ cards: [
 Fetches the active Heartwood theme for an organization so your skill can apply the same visual style.
 
 ```ts
-import { loadActiveThemeForOrg } from '@sprucelabs/spruce-heartwood-utils'
+import { loadActiveThemeForOrg } from '@sprucelabs/spruce-heartwood-utils/web'
 ```
 
 **Signature:**
@@ -264,7 +347,7 @@ const theme = await loadActiveThemeForOrg(client, organizationId)
 Sends `enableAutoLogout` / `disableAutoLogout` commands to the native Heartwood device layer. Register it with your skill's `ViewControllerFactory` to give your skill views control over session timeout behavior.
 
 ```ts
-import { AutoLogoutPlugin } from '@sprucelabs/spruce-heartwood-utils'
+import { AutoLogoutPlugin } from '@sprucelabs/spruce-heartwood-utils/web'
 
 const plugin = factory.BuildPlugin(AutoLogoutPlugin)
 
@@ -279,7 +362,7 @@ plugin.disableAutoLogout()     // cancel a pending auto-logout
 Use this type when you want to reference the plugin without coupling to the concrete class — for example, when declaring a field that holds either the real plugin or a spy:
 
 ```ts
-import type { AutoLogoutViewPlugin } from '@sprucelabs/spruce-heartwood-utils'
+import type { AutoLogoutViewPlugin } from '@sprucelabs/spruce-heartwood-utils/web'
 
 // Field declaration — works with both AutoLogoutPlugin and SpyAutoLogoutPlugin:
 private autoLogoutPlugin: AutoLogoutViewPlugin
@@ -301,7 +384,7 @@ interface AutoLogoutViewPlugin extends ViewControllerPlugin {
 A test double that records calls to `enableAutoLogout` and `disableAutoLogout`. Swap it in during test setup to assert your skill calls the plugin correctly:
 
 ```ts
-import { SpyAutoLogoutPlugin } from '@sprucelabs/spruce-heartwood-utils'
+import { SpyAutoLogoutPlugin } from '@sprucelabs/spruce-heartwood-utils/testing'
 
 protected async beforeEach() {
     const factory = this.views.getFactory()
@@ -341,7 +424,7 @@ Use these in your skill's test suite to verify that your skill correctly registe
 High-level assertion helper. Verifies that your skill view emits the expected registration event and that the returned cards are rendered.
 
 ```ts
-import { remoteVcAssert } from '@sprucelabs/spruce-heartwood-utils'
+import { remoteVcAssert } from '@sprucelabs/spruce-heartwood-utils/testing'
 ```
 
 **Basic assertion — confirm your skill view emits the event and renders cards:**
@@ -387,7 +470,7 @@ await remoteVcAssert.assertSkillViewRendersRemoteCards({
 ### `AssertRendersRemoteCardsOptions<Svc>`
 
 ```ts
-import { AssertRendersRemoteCardsOptions } from '@sprucelabs/spruce-heartwood-utils'
+import { AssertRendersRemoteCardsOptions } from '@sprucelabs/spruce-heartwood-utils/testing'
 
 interface AssertRendersRemoteCardsOptions<Svc extends SkillViewController = SkillViewController> {
     svc: Svc
@@ -410,7 +493,7 @@ interface AssertRendersRemoteCardsOptions<Svc extends SkillViewController = Skil
 Intercepts `heartwood.get-skill-views::v2021_02_11` and returns stub ViewController source. Useful when you need manual control over what remote views are returned in a test — `remoteVcAssert` uses this internally, but you can call it directly for custom scenarios.
 
 ```ts
-import { fakeGetViews } from '@sprucelabs/spruce-heartwood-utils'
+import { fakeGetViews } from '@sprucelabs/spruce-heartwood-utils/testing'
 
 // Stub two remote views:
 await fakeGetViews.fakeGetViews(['your-skill.card-a', 'your-skill.card-b'])
@@ -439,7 +522,8 @@ A drop-in replacement for the real remote factory. Controls exactly which VC cla
 import {
     MockRemoteViewControllerFactory,
     RemoteViewControllerFactoryImpl,
-} from '@sprucelabs/spruce-heartwood-utils'
+} from '@sprucelabs/spruce-heartwood-utils/web'
+import { MockDroppedInControllers } from '@sprucelabs/spruce-heartwood-utils/testing'
 ```
 
 **Setup — inject the mock before your skill view creates its factory:**
@@ -497,7 +581,7 @@ if (mockFactory.hasController('your-skill.some-card')) { ... }
 Type for the map of card IDs to VC classes held by `MockRemoteViewControllerFactory`:
 
 ```ts
-import { MockDroppedInControllers } from '@sprucelabs/spruce-heartwood-utils'
+import { MockDroppedInControllers } from '@sprucelabs/spruce-heartwood-utils/testing'
 
 type MockDroppedInControllers = Record<
     string,
@@ -596,7 +680,7 @@ import {
     AnimationEmitter,
     SizerProps,
     DelayedPlacerProps,
-} from '@sprucelabs/spruce-heartwood-utils'
+} from '@sprucelabs/spruce-heartwood-utils/web'
 ```
 
 ---
@@ -692,7 +776,7 @@ Pass the **same emitter instance** to `Sizer` and `DelayedPlacer` when they are
 The interface `Sizer` and `DelayedPlacer` use to communicate layout-change events. Pass an instance as the `emitter` prop to coordinate components. The package exports `SimpleEmitter` — a lightweight in-memory implementation you can use directly:
 
 ```ts
-import { SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils'
+import { SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
 
 const emitter = new SimpleEmitter()
 ```
@@ -720,7 +804,7 @@ interface AnimationEmitter {
 2. **Create an emitter** — one per component tree, stable across renders:
 
    ```ts
-   import { SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils'
+   import { SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
 
    const emitter = useMemo(() => new SimpleEmitter(), [])
    ```
@@ -990,7 +1074,7 @@ Wraps children in a div whose `height` is set via inline style to match the meas
 2. **Wrap your content** — `shouldHideOverflow` clips children during the height transition:
 
    ```tsx
-   import { Sizer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils'
+   import { Sizer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
 
    const emitter = useMemo(() => new SimpleEmitter(), [])
 
@@ -1058,7 +1142,7 @@ sizer.current?.hideOverflow(): void // re-apply overflow: hidden
 #### Usage
 
 ```tsx
-import { Sizer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils'
+import { Sizer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
 
 // Simplest — just clip overflow during height transition:
 <Sizer shouldHideOverflow>
@@ -1120,7 +1204,7 @@ When `isEnabled={false}`, children render inline with no wrapper.
 2. **Wrap your content** — `isEnabled`, `className`, and `isFocused` are all required:
 
    ```tsx
-   import { DelayedPlacer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils'
+   import { DelayedPlacer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
 
    const emitter = useMemo(() => new SimpleEmitter(), [])
 
@@ -1190,7 +1274,7 @@ delayedPlacer.current?.placeRightAway(): void  // re-measure and re-place immedi
 
 ```tsx
 import React, { useRef, useMemo } from 'react'
-import { DelayedPlacer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils'
+import { DelayedPlacer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
 
 function YourPanel({ isFocused }: { isFocused: () => boolean }) {
     const placerRef = useRef<React.ElementRef<typeof DelayedPlacer>>(null)
@@ -1282,7 +1366,7 @@ A complete example showing all three systems working together in a card componen
 import React, { useMemo } from 'react'
 import {
     Sizer, DelayedPlacer, queueShow, Settings, SimpleEmitter,
-} from '@sprucelabs/spruce-heartwood-utils'
+} from '@sprucelabs/spruce-heartwood-utils/web'
 
 function YourCard({ isPlaced, isFocused }: { isPlaced: boolean; isFocused: () => boolean }) {
     const emitter = useMemo(() => new SimpleEmitter(), [])
@@ -1321,7 +1405,7 @@ queueShow removes .hidden from each element with a 40ms stagger
 **Test setup for animation components:**
 
 ```ts
-import { Settings, stopQueue } from '@sprucelabs/spruce-heartwood-utils'
+import { Settings, stopQueue } from '@sprucelabs/spruce-heartwood-utils/web'
 import { skillViewState } from '@sprucelabs/spruce-heartwood-utils/build/components/skillViews/skillViewState'
 
 protected async beforeEach() {

package/build/app/SkillViewEmitter.d.ts

@@ -0,0 +1,167 @@
+import { AbstractEventEmitter } from '@sprucelabs/mercury-event-emitter';
+import { EventContract, EventContractEmitPayloads, MercuryEventEmitter } from '@sprucelabs/mercury-types';
+declare const contract: {
+    eventSignatures: {
+        'did-change-orientation': {};
+        'did-resize': {};
+        'did-render': {};
+        'did-resize-content': {};
+        'did-place-cards': {};
+        'will-change-route': {};
+        'did-render-dialog': {};
+        'did-keydown': {
+            emitPayloadSchema: {
+                id: string;
+                fields: {
+                    e: {
+                        type: "raw";
+                        isRequired: true;
+                        options: {
+                            valueType: string;
+                        };
+                    };
+                };
+            };
+        };
+        'did-scroll': {
+            emitPayloadSchema: {
+                id: string;
+                fields: {
+                    scrollTop: {
+                        type: "number";
+                        isRequired: true;
+                    };
+                    skillViewNode: {
+                        type: "raw";
+                        isRequired: true;
+                        options: {
+                            valueType: string;
+                        };
+                    };
+                };
+            };
+        };
+        'connection-status-change': {
+            emitPayloadSchema: {
+                id: string;
+                fields: {
+                    payload: {
+                        type: "schema";
+                        isRequired: true;
+                        options: {
+                            schema: {
+                                id: string;
+                                fields: {
+                                    status: {
+                                        type: "select";
+                                        isRequired: true;
+                                        options: {
+                                            choices: ({
+                                                readonly label: "Connecting";
+                                                readonly value: "connecting";
+                                            } | {
+                                                readonly label: "Connected";
+                                                readonly value: "connected";
+                                            } | {
+                                                readonly label: "Disconnected";
+                                                readonly value: "disconnected";
+                                            })[];
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+export type SkillViewEventContract = typeof contract;
+export type SkillViewEvents = SkillViewEventContract['eventSignatures'];
+export type SkillViewEmitPayloads = EventContractEmitPayloads<SkillViewEventContract>;
+export type SkillViewEmitter = MercuryEventEmitter<SkillViewEventContract>;
+export default class SkillViewEmitterImpl<Contract extends EventContract = SkillViewEventContract> extends AbstractEventEmitter<Contract> implements MercuryEventEmitter<Contract> {
+    private static instance;
+    private constructor();
+    static Emitter(): SkillViewEmitterImpl<{
+        eventSignatures: {
+            'did-change-orientation': {};
+            'did-resize': {};
+            'did-render': {};
+            'did-resize-content': {};
+            'did-place-cards': {};
+            'will-change-route': {};
+            'did-render-dialog': {};
+            'did-keydown': {
+                emitPayloadSchema: {
+                    id: string;
+                    fields: {
+                        e: {
+                            type: "raw";
+                            isRequired: true;
+                            options: {
+                                valueType: string;
+                            };
+                        };
+                    };
+                };
+            };
+            'did-scroll': {
+                emitPayloadSchema: {
+                    id: string;
+                    fields: {
+                        scrollTop: {
+                            type: "number";
+                            isRequired: true;
+                        };
+                        skillViewNode: {
+                            type: "raw";
+                            isRequired: true;
+                            options: {
+                                valueType: string;
+                            };
+                        };
+                    };
+                };
+            };
+            'connection-status-change': {
+                emitPayloadSchema: {
+                    id: string;
+                    fields: {
+                        payload: {
+                            type: "schema";
+                            isRequired: true;
+                            options: {
+                                schema: {
+                                    id: string;
+                                    fields: {
+                                        status: {
+                                            type: "select";
+                                            isRequired: true;
+                                            options: {
+                                                choices: ({
+                                                    readonly label: "Connecting";
+                                                    readonly value: "connecting";
+                                                } | {
+                                                    readonly label: "Connected";
+                                                    readonly value: "connected";
+                                                } | {
+                                                    readonly label: "Disconnected";
+                                                    readonly value: "disconnected";
+                                                })[];
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    }>;
+    static reset(): void;
+    static getInstance(): SkillViewEmitter;
+}
+export {};

package/build/app/SkillViewEmitter.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mercury_client_1 = require("@sprucelabs/mercury-client");
+const mercury_event_emitter_1 = require("@sprucelabs/mercury-event-emitter");
+const mercury_types_1 = require("@sprucelabs/mercury-types");
+const schema_1 = require("@sprucelabs/schema");
+const contract = (0, mercury_types_1.buildEventContract)({
+    eventSignatures: {
+        ...mercury_client_1.connectionStatusContract.eventSignatures,
+        'did-change-orientation': {},
+        'did-resize': {},
+        'did-render': {},
+        'did-resize-content': {},
+        'did-place-cards': {},
+        'will-change-route': {},
+        'did-render-dialog': {},
+        'did-keydown': {
+            emitPayloadSchema: (0, schema_1.buildSchema)({
+                id: 'didKeydownEmitPayload',
+                fields: {
+                    e: {
+                        type: 'raw',
+                        isRequired: true,
+                        options: {
+                            valueType: 'KeyboardEvent',
+                        },
+                    },
+                },
+            }),
+        },
+        'did-scroll': {
+            emitPayloadSchema: (0, schema_1.buildSchema)({
+                id: 'didScrollEmitPayload',
+                fields: {
+                    scrollTop: {
+                        type: 'number',
+                        isRequired: true,
+                    },
+                    skillViewNode: {
+                        type: 'raw',
+                        isRequired: true,
+                        options: {
+                            valueType: 'HTMLDivElement',
+                        },
+                    },
+                },
+            }),
+        },
+    },
+});
+class SkillViewEmitterImpl extends mercury_event_emitter_1.AbstractEventEmitter {
+    constructor(contract) {
+        super(contract);
+    }
+    static Emitter() {
+        return new this(contract);
+    }
+    static reset() {
+        this.instance = null;
+    }
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = this.Emitter();
+        }
+        return this.instance;
+    }
+}
+exports.default = SkillViewEmitterImpl;
+//# sourceMappingURL=SkillViewEmitter.js.map

package/build/esm/__tests__/support/MockRemoteViewControllerFactory.js

@@ -1,12 +1,3 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import { vcAssert, } from '@sprucelabs/heartwood-view-controllers';
 import { assert } from '@sprucelabs/test-utils';
 class MockRemoteViewControllerFactory {
@@ -45,8 +36,7 @@ class MockRemoteViewControllerFactory {
         }
     }
     assertSkillViewRendersRemoteCard(vc, name, id) {
-        var _a;
-        const Class = (_a = MockRemoteViewControllerFactory.controllers) === null || _a === void 0 ? void 0 : _a[name];
+        const Class = MockRemoteViewControllerFactory.controllers?.[name];
         assert.isTruthy(Class, `You did not drop in a remote card with the name '${name}'! Try MockRemoteViewControllerFactory.dropInRemoteController('${name}', Class) in your beforeEach().`);
         const cards = vcAssert.assertSkillViewRendersCards(vc);
         const cardsWithNoControllers = cards.filter((c) => !c);
@@ -92,7 +82,7 @@ class MockRemoteViewControllerFactory {
         try {
             this.assertFetchedRemoteController(id);
         }
-        catch (_a) {
+        catch {
             return;
         }
         assert.fail(`You fetched the controller with the id '${id}' but you should not have.`);
@@ -107,23 +97,17 @@ class MockRemoteViewControllerFactory {
         assert.isEqualDeep(this.constructorOptionsById[id], expected, `The constructor options for the remote card with id '${id}' do not match the expected options. Make sure the card you are rendering has an id using this.views.Controller('card', { id })`);
     }
     hasController(name) {
-        var _a;
-        return (_a = this.loadedControllers[name]) !== null && _a !== void 0 ? _a : false;
-    }
-    RemoteController(id, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            assert.isTruthy((_a = MockRemoteViewControllerFactory.controllers) === null || _a === void 0 ? void 0 : _a[id], `Could not find a remote card with the id '${id}'! Try MockRemoteViewControllerFactory.dropInRemoteController('${id}', Class) in your beforeEach().`);
-            this.loadedControllers[id] = true;
-            this.constructorOptionsById[(_b = options.id) !== null && _b !== void 0 ? _b : id] = options;
-            this.lastRemoteCostructorOptions = options;
-            return this.views.Controller(id, options);
-        });
-    }
-    loadViewsForNamespace(namespace) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.loadedNamespaces[namespace] = true;
-        });
+        return this.loadedControllers[name] ?? false;
+    }
+    async RemoteController(id, options) {
+        assert.isTruthy(MockRemoteViewControllerFactory.controllers?.[id], `Could not find a remote card with the id '${id}'! Try MockRemoteViewControllerFactory.dropInRemoteController('${id}', Class) in your beforeEach().`);
+        this.loadedControllers[id] = true;
+        this.constructorOptionsById[options.id ?? id] = options;
+        this.lastRemoteCostructorOptions = options;
+        return this.views.Controller(id, options);
+    }
+    async loadViewsForNamespace(namespace) {
+        this.loadedNamespaces[namespace] = true;
     }
     assertLoadedViewsForNamespace(namespace) {
         assert.isTrue(this.loadedNamespaces[namespace], `You did not load views for the namespace '${namespace}'. Try removeVc.loadViewsForNamespace('${namespace}').`);