@hubspot/ui-extensions 0.11.2 → 0.11.3

package/dist/experimental/testing/render.js

@@ -1,12 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
 import { createRemoteRoot } from '@remote-ui/core';
 import { createRoot as createReactRoot } from '@remote-ui/react';
-import { convertRemoteRoot } from './internal/convert';
-import { createDocument } from './internal/document';
-import { InvalidComponentsError, WaitForTimeoutError } from './internal/errors';
-import { isMatch } from './internal/match';
-import { find, findAll, findAllChildren, findChild, maybeFind, maybeFindChild, } from './internal/query';
-import { createRootNode } from './internal/root';
-import { createDeferred } from './internal/utils/promise-utils';
+import { convertRemoteRoot } from "./internal/convert.js";
+import { createDocument } from "./internal/document.js";
+import { InvalidComponentsError, InvalidExtensionPointLocationError, WaitForTimeoutError, } from "./internal/errors.js";
+import { EXTENSION_POINT_LOCATIONS, } from "../../shared/types/extension-points.js";
+import { MocksContextProvider } from "../../internal/hook-utils.js";
+import { createMocksWithSpies } from "./internal/mocks/index.js";
+import { find, findAll, findAllChildren, findByTestId, findChild, maybeFind, maybeFindByTestId, maybeFindChild, } from "./internal/query.js";
+import { createRootNode } from "./internal/root.js";
+import { asRenderedRootNode } from "./internal/type-utils-internal.js";
+import { createDeferred, } from "./internal/utils/promise-utils.js";
 const DEFAULT_WAIT_FOR_TIMEOUT_IN_MS = 1000;
 const DEFAULT_WAIT_FOR_OPTIONS = {
     timeoutInMs: DEFAULT_WAIT_FOR_TIMEOUT_IN_MS,
@@ -15,9 +19,9 @@ const DEFAULT_WAIT_FOR_OPTIONS = {
  * Renders a UI extension component using React so that assertions can be made against the rendered output.
  *
  * @param node The React node to render.
- * @returns A render result object that can be used to query the rendered DOM.
+ * @returns A render result object
  */
-export const render = (node) => {
+const render = (node, mocks) => {
     let dirty = true;
     let waitForChecksQueued = false;
     let waitForList = [];
@@ -71,7 +75,7 @@ export const render = (node) => {
     };
     const remoteRoot = createRemoteRoot(remoteChannel);
     const reactRoot = createReactRoot(remoteRoot);
-    reactRoot.render(node);
+    reactRoot.render(_jsx(MocksContextProvider, { value: mocks, children: node }));
     remoteRoot.mount();
     let maybeRenderedRootNode;
     /**
@@ -100,24 +104,7 @@ export const render = (node) => {
         throw new InvalidComponentsError(initialRenderedRootNode);
     }
     return {
-        find: (component, matcher) => {
-            return find(getLatestRootNode(), component, matcher);
-        },
-        findAll: (component, matcher) => {
-            return findAll(getLatestRootNode(), component, matcher);
-        },
-        findChild: (component, matcher) => {
-            return findChild(getLatestRootNode(), component, matcher);
-        },
-        findAllChildren: (component, matcher) => {
-            return findAllChildren(getLatestRootNode(), component, matcher);
-        },
-        maybeFindChild: (component, matcher) => {
-            return maybeFindChild(getLatestRootNode(), component, matcher);
-        },
-        maybeFind: (component, matcher) => {
-            return maybeFind(getLatestRootNode(), component, matcher);
-        },
+        getLatestRootNode,
         waitFor: (check, options = DEFAULT_WAIT_FOR_OPTIONS) => {
             const { timeoutInMs = DEFAULT_WAIT_FOR_TIMEOUT_IN_MS } = options;
             try {
@@ -142,14 +129,91 @@ export const render = (node) => {
             }
             return deferred.promise;
         },
+    };
+};
+/**
+ * Creates a renderer object with methods for rendering and testing UI extension components.
+ * Mocks for supported React hooks and the Extension Point API are automatically provided based on the extension point location.
+ *
+ * Example usage:
+ *
+ * ```tsx
+ * import { createRenderer } from '@hubspot/ui-extensions/testing';
+ * import { Alert, Button, ButtonRow } from '@hubspot/ui-extensions';
+ *
+ * const { render, find } = createRenderer('crm.record.tab');
+ * render(
+ *   <>
+ *   <ButtonRow>
+ *     <Button variant="secondary">Button 1</Button>
+ *     <Button variant="primary">Button 2</Button>
+ *   </ButtonRow>
+ *   <Alert title="My Alert" />
+ * </>
+ * );
+ *
+ * // Find any button
+ * const button = find(Button);
+ *
+ * // Assertions
+ * expect(button.props.variant).toEqual('primary');
+ * expect(button.text).toEqual('Button 2');
+ * ```
+ *
+ * @param extensionPointLocation The extension point location.
+ * @returns A renderer object with methods for rendering and testing UI extension components.
+ */
+export const createRenderer = (extensionPointLocation) => {
+    if (!EXTENSION_POINT_LOCATIONS.includes(extensionPointLocation)) {
+        throw new InvalidExtensionPointLocationError(extensionPointLocation);
+    }
+    let renderResult = null;
+    const getRenderResult = () => {
+        if (!renderResult) {
+            throw new Error('Renderer not initialized');
+        }
+        return renderResult;
+    };
+    const getLatestRootNode = () => getRenderResult().getLatestRootNode();
+    const { mocks, spies } = createMocksWithSpies(extensionPointLocation);
+    return {
+        render: (node) => {
+            renderResult = render(node, mocks);
+            return asRenderedRootNode(renderResult.getLatestRootNode());
+        },
+        mocks: spies,
+        find: (component, matcher) => {
+            return find(getLatestRootNode(), component, matcher);
+        },
+        findAll: (component, matcher) => {
+            return findAll(getLatestRootNode(), component, matcher);
+        },
+        findChild: (component, matcher) => {
+            return findChild(getLatestRootNode(), component, matcher);
+        },
+        findAllChildren: (component, matcher) => {
+            return findAllChildren(getLatestRootNode(), component, matcher);
+        },
+        maybeFindChild: (component, matcher) => {
+            return maybeFindChild(getLatestRootNode(), component, matcher);
+        },
+        maybeFind: (component, matcher) => {
+            return maybeFind(getLatestRootNode(), component, matcher);
+        },
+        findByTestId: (component, testId) => {
+            return findByTestId(getLatestRootNode().document, component, testId);
+        },
+        maybeFindByTestId: (component, testId) => {
+            return maybeFindByTestId(getLatestRootNode().document, component, testId);
+        },
+        waitFor: (check, options = DEFAULT_WAIT_FOR_OPTIONS) => {
+            return getRenderResult().waitFor(check, options);
+        },
         debugLog: (label) => {
             return getLatestRootNode().debugLog(label);
         },
         getRootNode: () => {
-            return getLatestRootNode();
-        },
-        isMatch: (targetNode, component, matcher) => {
-            return isMatch(targetNode, component, matcher);
+            return asRenderedRootNode(getLatestRootNode());
         },
     };
 };

package/dist/experimental/testing/type-utils.d.ts

@@ -1,11 +1,11 @@
-import { type RenderedElementNode, type RenderedFragmentNode, type RenderedNode, type RenderedRootNode, type RenderedTextNode } from './types';
+import { type RenderedElementNode, type RenderedFragmentNode, type RenderedNode, type RenderedRootNode, type RenderedTextNode } from './types.ts';
 /**
  * Type guard to check if a node is a rendered element node.
  *
  * @param node The node to check.
  * @returns `true` if the node is a rendered element node.
  */
-export declare const isRenderedElementNode: (node: RenderedNode | null | undefined) => node is RenderedElementNode<import("../..").UnknownComponentProps>;
+export declare const isRenderedElementNode: (node: RenderedNode | null | undefined) => node is RenderedElementNode;
 /**
  * Type guard to check if a node is a rendered text node.
  *

package/dist/experimental/testing/type-utils.js

@@ -1,4 +1,4 @@
-import { RenderedNodeType, } from './types';
+import { RenderedNodeType, } from "./types.js";
 /**
  * Type guard to check if a node is a rendered element node.
  *

package/dist/experimental/testing/types.d.ts

@@ -1,4 +1,9 @@
-import { HubSpotReactComponent, HubSpotReactFragmentProp, UnknownComponentProps } from '../../__synced__/types/shared.synced';
+import { ExtensionPointApi, ExtensionPointApiActions, ExtensionPointLocation } from '../../shared/types/extension-points.ts';
+import { ServerlessFuncRunner } from '../../shared/types/http-requests.ts';
+import { SpyImpl } from 'tinyspy';
+import { HubSpotReactComponent, HubSpotReactFragmentProp, UnknownComponentProps } from '../../shared/types/shared.ts';
+import { useAssociations, useCrmProperties } from '../../crm/index.ts';
+import { AnyFunction } from './internal/types-internal.ts';
 /**
  * The type of a rendered node.
  */
@@ -64,18 +69,40 @@ interface CommonQueryMethods {
      */
     findAllChildren<TProps extends UnknownComponentProps>(component: HubSpotReactComponent<TProps>, matcher?: ElementMatcher<TProps>): RenderedElementNode<TProps>[];
 }
+interface BaseRenderedNode {
+    /**
+     * The type of the node.
+     */
+    nodeType: RenderedNodeType;
+    /**
+     * Logs a string representation of the node as a console log. This is useful for debugging.
+     */
+    debugLog: (label?: string) => void;
+    /**
+     * Checks if a node matches a specific component and optional matcher criteria.
+     *
+     * @param component The component to check.
+     * @param matcher An optional matcher to filter the elements.
+     * @returns Whether the node matches the component and matcher.
+     */
+    isMatch<TComponentProps extends UnknownComponentProps>(this: BaseRenderedNode, component: HubSpotReactComponent<TComponentProps>, matcher?: ElementMatcher<TComponentProps>): this is RenderedElementNode<TComponentProps>;
+    /**
+     * Returns a string representation of the node.
+     */
+    toString: () => string;
+}
 interface BaseRenderedParentNode {
     /**
      * The child nodes
      */
-    children: RenderedChildNode[];
+    childNodes: RenderedChildNode[];
 }
 /**
  * Represents a root node of a rendered component.
  *
  * NOTE: Rendered root nodes are immutable and are part of a snapshot for a single render cycle. They become immediately stale when a new render occurs.
  */
-export interface RenderedRootNode extends BaseRenderedParentNode, CommonQueryMethods {
+export interface RenderedRootNode extends BaseRenderedParentNode, BaseRenderedNode, CommonQueryMethods {
     /**
      * The type of the node (always `RenderedNodeType.Root` for a root node).
      */
@@ -100,7 +127,7 @@ export interface RenderedRootNode extends BaseRenderedParentNode, CommonQueryMet
  *
  * NOTE: Rendered fragment nodes are immutable and are part of a snapshot for a single render cycle. They become immediately stale when a new render occurs.
  */
-export interface RenderedFragmentNode extends BaseRenderedParentNode, CommonQueryMethods {
+export interface RenderedFragmentNode extends BaseRenderedParentNode, BaseRenderedNode, CommonQueryMethods {
     /**
      * The type of the node (always `RenderedNodeType.Fragment` for a fragment node).
      */
@@ -118,15 +145,20 @@ export interface RenderedFragmentNode extends BaseRenderedParentNode, CommonQuer
      */
     toString: () => string;
 }
-type RenderPropsFromComponentProps<TProps extends UnknownComponentProps> = {
+/**
+ * Converts the component props to the props that will be attached to the rendered element node.
+ * Component props that are of type `ReactNode` are mapped to the `RenderedFragmentNode` type.
+ * `props.children` is removed from the props object since it becomes `childNodes` on the rendered element node.
+ */
+type RenderPropsFromComponentProps<TProps extends UnknownComponentProps> = Omit<{
     [K in keyof TProps]: HubSpotReactFragmentProp extends TProps[K] ? RenderedFragmentNode : TProps[K];
-};
+}, 'children'>;
 /**
  * Represents an element node of a rendered component.
  *
  * NOTE: Rendered elements are immutable and are part of a snapshot for a single render cycle. They become immediately stale when a new render occurs.
  */
-export interface RenderedElementNode<TProps extends UnknownComponentProps = UnknownComponentProps> extends BaseRenderedParentNode, CommonQueryMethods {
+export interface RenderedElementNode<TProps extends UnknownComponentProps = UnknownComponentProps> extends BaseRenderedParentNode, BaseRenderedNode, CommonQueryMethods {
     /**
      * The type of the node (always `RenderedNodeType.Element` for an element node).
      */
@@ -166,7 +198,7 @@ export interface RenderedElementNode<TProps extends UnknownComponentProps = Unkn
  *
  * NOTE: Rendered text nodes are immutable and are part of a snapshot for a single render cycle. They become immediately stale when a new render occurs.
  */
-export interface RenderedTextNode {
+export interface RenderedTextNode extends BaseRenderedNode {
     /**
      * The type of the node (always `RenderedNodeType.Text` for a text node).
      */
@@ -212,10 +244,73 @@ export interface WaitForOptions {
      */
     timeoutInMs?: number;
 }
+/**
+ * Represents a spy for a function. A function spy can be used to track the calls to a
+ * function and also control the return result of a function.
+ *
+ * See the [tinyspy](https://github.com/tiny-spy/tinyspy) library for more
+ * information about spies and the supported API.
+ */
+export type FunctionSpy<TFunction extends AnyFunction> = SpyImpl<Parameters<TFunction>, ReturnType<TFunction>>;
+export type ExtensionPointApiActionSpies<TExtensionPointLocation extends ExtensionPointLocation> = {
+    [TActionName in keyof ExtensionPointApiActions<TExtensionPointLocation>]: ExtensionPointApiActions<TExtensionPointLocation>[TActionName] extends AnyFunction ? FunctionSpy<ExtensionPointApiActions<TExtensionPointLocation>[TActionName]> : never;
+};
+/**
+ * An object containing the spies for the various functions.
+ */
+export interface RendererSpies<TExtensionPointLocation extends ExtensionPointLocation> {
+    /**
+     * A spy for the `useCrmProperties` hook function.
+     * The spy can be used to track the calls to the hook function and also control the
+     * return result of the hook function.
+     *
+     * See the [tinyspy](https://github.com/tiny-spy/tinyspy) library for more
+     * information about spies and the supported API.
+     */
+    useCrmProperties: FunctionSpy<typeof useCrmProperties>;
+    /**
+     * A spy for the `useAssociations` hook function.
+     * The spy can be used to track the calls to the hook function and also control the
+     * return result of the hook function.
+     *
+     * See the [tinyspy](https://github.com/tiny-spy/tinyspy) library for more
+     * information about spies and the supported API.
+     */
+    useAssociations: FunctionSpy<typeof useAssociations>;
+    /**
+     * Mock context object that contains fake context data for the extension point API.
+     */
+    context: ExtensionPointApi<TExtensionPointLocation>['context'];
+    /**
+     * A spy for the actions of the extension point API.
+     * The spy can be used to track the calls to the actions function and also control the
+     * return result of the actions function.
+     *
+     * See the [tinyspy](https://github.com/tiny-spy/tinyspy) library for more
+     * information about spies and the supported API.
+     */
+    actions: ExtensionPointApiActionSpies<TExtensionPointLocation>;
+    /**
+     * A spy for the `runServerlessFunction` function.
+     * The spy can be used to track the calls to the function and also control the
+     * return result of the function.
+     *
+     * See the [tinyspy](https://github.com/tiny-spy/tinyspy) library for more
+     * information about spies and the supported API.
+     */
+    runServerlessFunction: FunctionSpy<ServerlessFuncRunner>;
+}
 /**
  * A result of a render operation.
  */
-export interface RenderResult extends CommonQueryMethods {
+export interface Renderer<TExtensionPointLocation extends ExtensionPointLocation> extends CommonQueryMethods {
+    /**
+     * Renders a UI extension component using React so that assertions can be made against the rendered output.
+     *
+     * @param node The React node to render.
+     * @returns The root node of the rendered component.
+     */
+    render: (node: React.ReactNode) => RenderedRootNode;
     /**
      * Waits for the given check to pass. If the check does not pass within the allowed amount of time, an error will be thrown.
      *
@@ -235,7 +330,29 @@ export interface RenderResult extends CommonQueryMethods {
      * @returns The root node.
      */
     getRootNode: () => RenderedRootNode;
-    isMatch: <TComponentProps extends UnknownComponentProps>(node: RenderedNode | null | undefined, component: HubSpotReactComponent<TComponentProps>, matcher?: ElementMatcher<TComponentProps>) => node is RenderedElementNode<TComponentProps>;
+    /**
+     * The mocks that can be used to control the behavior of the various functions.
+     */
+    mocks: RendererSpies<TExtensionPointLocation>;
+    /**
+     * Finds the first descendant element node that matches the given component and test ID.
+     *
+     * @param component The component to find.
+     * @param testId The test ID to find.
+     * @returns The first element node that matches the given component and test ID.
+     */
+    findByTestId<TProps extends UnknownComponentProps>(component: HubSpotReactComponent<TProps>, testId: string): RenderedElementNode<TProps>;
+    /**
+     * Finds the first descendant element node that matches the given component and test ID. If no match is found, `null` is returned.
+     *
+     * @param component The component to find.
+     * @param testId The test ID to find.
+     * @returns The first element node that matches the given component and test ID or `null` if no match is found.
+     */
+    maybeFindByTestId<TProps extends UnknownComponentProps>(component: HubSpotReactComponent<TProps>, testId: string): RenderedElementNode<TProps> | null;
 }
+/**
+ * Represents one of the four supported node types that include element, root, fragment, and text nodes.
+ */
 export type RenderedNode = RenderedElementNode<any> | RenderedRootNode | RenderedFragmentNode | RenderedTextNode;
 export {};

package/dist/experimental/testing/utils.d.ts

@@ -0,0 +1,11 @@
+import { type HubSpotReactComponent, type UnknownComponentProps } from '../../shared/types/shared.ts';
+import { type ElementMatcher, type RenderedElementNode, type RenderedNode } from './types.ts';
+/**
+ * Checks if the node matches the component and matcher.
+ *
+ * @param node The node to check.
+ * @param component The component to check.
+ * @param matcher An optional matcher to filter the elements.
+ * @returns Whether the node matches the component and matcher.
+ */
+export declare const isMatch: <TComponentProps extends UnknownComponentProps>(node: RenderedNode | null | undefined, component: HubSpotReactComponent<TComponentProps>, matcher?: ElementMatcher<TComponentProps>) => node is RenderedElementNode<TComponentProps>;

package/dist/experimental/testing/utils.js

@@ -0,0 +1,24 @@
+import { RenderedNodeType, } from "./types.js";
+import { __hubSpotComponentRegistry } from "../../shared/remoteComponents.js";
+import { checkElementMatches } from "./internal/match.js";
+/**
+ * Checks if the node matches the component and matcher.
+ *
+ * @param node The node to check.
+ * @param component The component to check.
+ * @param matcher An optional matcher to filter the elements.
+ * @returns Whether the node matches the component and matcher.
+ */
+export const isMatch = (node, component, matcher) => {
+    if (node == null) {
+        return false;
+    }
+    if (node.nodeType !== RenderedNodeType.Element) {
+        return false;
+    }
+    const targetComponentName = __hubSpotComponentRegistry.getComponentName(component);
+    if (node.name !== targetComponentName) {
+        return false;
+    }
+    return checkElementMatches(node, matcher);
+};

package/dist/hubspot.d.ts

@@ -1,10 +1,8 @@
-import { ReactElement } from 'react';
-import type { ExtensionPoints, ExtensionPointApi, ServerlessRunnerParams, HubSpotFetchRequestURI, HubSpotFetchOptions } from './__synced__/types/index.synced';
-export declare function extend_V2<ExtensionPointName extends keyof ExtensionPoints>(renderExtensionCallback: (api: ExtensionPointApi<ExtensionPointName>) => ReactElement<any>): any;
+import type { HubSpotFetchOptions, HubSpotFetchRequestURI, ServerlessRunnerParams } from './shared/types/index.ts';
 export declare function serverless<T = any>(name: ServerlessRunnerParams['name'], options?: Omit<ServerlessRunnerParams, 'name'>): Promise<T>;
 export declare function fetch(url: HubSpotFetchRequestURI, options?: HubSpotFetchOptions): Promise<Response>;
 export declare const hubspot: {
-    extend: typeof extend_V2;
+    extend: import("./shared/types/extend.ts").HubspotExtendFunction;
     serverless: typeof serverless;
     fetch: typeof fetch;
 };

package/dist/hubspot.js

@@ -1,6 +1,6 @@
-export function extend_V2(renderExtensionCallback) {
-    return self.extend_V2(renderExtensionCallback);
-}
+/* eslint-disable hubspot-dev/no-confusing-browser-globals */
+import { getWorkerGlobals } from "./internal/global-utils.js";
+const extend_V2 = getWorkerGlobals().extend_V2;
 export function serverless(name, options) {
     return self.serverless(name, options);
 }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import './clientTypes';
-export { hubspot } from './hubspot';
-export { logger } from './logger';
-export * from './__synced__/types/index.synced';
-export { Accordion, Alert, AutoGrid, BarChart, Box, Button, ButtonRow, Card, Checkbox, CurrencyInput, DateInput, DescriptionList, DescriptionListItem, Divider, Dropdown, EmptyState, ErrorState, Flex, Form, Heading, Icon, Illustration, Image, Inline, Input, LineChart, Link, List, LoadingButton, LoadingSpinner, Modal, ModalBody, ModalFooter, MultiSelect, NumberInput, Panel, PanelBody, PanelFooter, PanelSection, ProgressBar, RadioButton, SearchInput, Select, Stack, Statistics, StatisticsItem, StatisticsTrend, StatusTag, StepIndicator, StepperInput, Tab, Table, TableBody, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, Tag, Text, TextArea, Textarea, Tile, TimeInput, Toggle, ToggleGroup, Tooltip, } from './__synced__/remoteComponents.synced';
+import './clientTypes.ts';
+export { hubspot } from './hubspot.ts';
+export { logger } from './logger.ts';
+export * from './shared/types/index.ts';
+export { Accordion, Alert, AutoGrid, BarChart, Box, Button, ButtonRow, Card, Checkbox, CurrencyInput, DateInput, DescriptionList, DescriptionListItem, Divider, Dropdown, EmptyState, ErrorState, Flex, Form, Heading, Icon, Illustration, Image, Inline, Input, LineChart, Link, List, LoadingButton, LoadingSpinner, Modal, ModalBody, ModalFooter, MultiSelect, NumberInput, Panel, PanelBody, PanelFooter, PanelSection, ProgressBar, RadioButton, SearchInput, Select, Stack, Statistics, StatisticsItem, StatisticsTrend, StatusTag, StepIndicator, StepperInput, Tab, Table, TableBody, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, Tag, Text, TextArea, Textarea, Tile, TimeInput, Toggle, ToggleGroup, Tooltip, } from './shared/remoteComponents.tsx';

package/dist/index.js

@@ -1,6 +1,6 @@
 // In order to easily fix [this issue](https://git.hubteam.com/HubSpot/ui-extensibility/issues/2587) we are temporarily importing a manually created subset of Vite client types. This should be removed once we have a proper solution for this issue.
-import './clientTypes';
-export { hubspot } from './hubspot';
-export { logger } from './logger';
-export * from './__synced__/types/index.synced';
-export { Accordion, Alert, AutoGrid, BarChart, Box, Button, ButtonRow, Card, Checkbox, CurrencyInput, DateInput, DescriptionList, DescriptionListItem, Divider, Dropdown, EmptyState, ErrorState, Flex, Form, Heading, Icon, Illustration, Image, Inline, Input, LineChart, Link, List, LoadingButton, LoadingSpinner, Modal, ModalBody, ModalFooter, MultiSelect, NumberInput, Panel, PanelBody, PanelFooter, PanelSection, ProgressBar, RadioButton, SearchInput, Select, Stack, Statistics, StatisticsItem, StatisticsTrend, StatusTag, StepIndicator, StepperInput, Tab, Table, TableBody, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, Tag, Text, TextArea, Textarea, Tile, TimeInput, Toggle, ToggleGroup, Tooltip, } from './__synced__/remoteComponents.synced';
+import "./clientTypes.js";
+export { hubspot } from "./hubspot.js";
+export { logger } from "./logger.js";
+export * from "./shared/types/index.js";
+export { Accordion, Alert, AutoGrid, BarChart, Box, Button, ButtonRow, Card, Checkbox, CurrencyInput, DateInput, DescriptionList, DescriptionListItem, Divider, Dropdown, EmptyState, ErrorState, Flex, Form, Heading, Icon, Illustration, Image, Inline, Input, LineChart, Link, List, LoadingButton, LoadingSpinner, Modal, ModalBody, ModalFooter, MultiSelect, NumberInput, Panel, PanelBody, PanelFooter, PanelSection, ProgressBar, RadioButton, SearchInput, Select, Stack, Statistics, StatisticsItem, StatisticsTrend, StatusTag, StepIndicator, StepperInput, Tab, Table, TableBody, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, Tag, Text, TextArea, Textarea, Tile, TimeInput, Toggle, ToggleGroup, Tooltip, } from "./shared/remoteComponents.js";

package/dist/internal/global-utils.d.ts

@@ -0,0 +1,6 @@
+import { WorkerGlobalsInternal } from '../shared/types/worker-globals.ts';
+/**
+ * Gets the worker globals object for the current environment.
+ * @returns The worker globals object.
+ */
+export declare const getWorkerGlobals: () => WorkerGlobalsInternal;

package/dist/internal/global-utils.js

@@ -0,0 +1,37 @@
+/**
+ * Checks if the current environment is a HubSpot extension worker.
+ * @returns True if the current environment is a HubSpot extension worker.
+ */
+const isRunningInWorker = () => typeof self !== 'undefined' &&
+    self.__HUBSPOT_EXTENSION_WORKER__ === true;
+/**
+ * A fake worker globals object for use in test environments.
+ */
+const fakeWorkerGlobals = {
+    logger: {
+        debug: (data) => {
+            console.log(data);
+        },
+        info: (data) => {
+            console.info(data);
+        },
+        warn: (data) => {
+            console.warn(data);
+        },
+        error: (data) => {
+            console.error(data);
+        },
+    },
+    extend_V2: () => {
+        // No-op in test environment
+    },
+};
+/**
+ * Gets the worker globals object for the current environment.
+ * @returns The worker globals object.
+ */
+export const getWorkerGlobals = () => {
+    return isRunningInWorker()
+        ? self
+        : fakeWorkerGlobals;
+};

package/dist/internal/hook-utils.d.ts

@@ -0,0 +1,19 @@
+import { RendererMocksInternal } from '../experimental/testing/internal/types-internal.ts';
+type AnyFunction = (...args: any[]) => any;
+/**
+ * Creates a mock-aware hook function that can be used to mock the original hook function.
+ * The mock-aware hook function will return the mocked hook function if a mock is found, otherwise it will return the original hook function.
+ *
+ * @param hookName The name of the hook to mock that corresponds to the key in the Mocks interface
+ * @param originalHookFunction The original hook function to call if no mock is found
+ * @returns The mocked hook function or the original hook function if no mock is found
+ */
+export declare const createMockAwareHook: <THookName extends keyof RendererMocksInternal, THookFunction extends AnyFunction>(hookName: THookName, originalHookFunction: THookFunction) => THookFunction;
+/**
+ * A React component that provides the Mocks context that can be used to provide mocks to the mock-aware hook functions.
+ *
+ * @param children The children to render.
+ * @returns The children wrapped in the Mocks context provider.
+ */
+export declare const MocksContextProvider: import("react").Provider<RendererMocksInternal | null>;
+export {};

package/dist/internal/hook-utils.js

@@ -0,0 +1,34 @@
+import { createContext, useContext } from 'react';
+const MocksContext = createContext(null);
+/**
+ * Creates a mock-aware hook function that can be used to mock the original hook function.
+ * The mock-aware hook function will return the mocked hook function if a mock is found, otherwise it will return the original hook function.
+ *
+ * @param hookName The name of the hook to mock that corresponds to the key in the Mocks interface
+ * @param originalHookFunction The original hook function to call if no mock is found
+ * @returns The mocked hook function or the original hook function if no mock is found
+ */
+export const createMockAwareHook = (hookName, originalHookFunction) => {
+    const useWrapper = (...args) => {
+        const mocks = useContext(MocksContext);
+        if (!mocks) {
+            // If no mocks are provided, call the original hook function
+            return originalHookFunction(...args);
+        }
+        // When a mock is provided by the testing utilities (via <MocksContextProvider>), return the mocked hook function
+        const mockHook = mocks[hookName];
+        if (!mockHook) {
+            throw new Error(`Illegal State: Mock for hook ${hookName} not found.`);
+        }
+        // Call the mocked hook function with the same arguments as the original hook function and return the result
+        return mockHook(...args);
+    };
+    return useWrapper;
+};
+/**
+ * A React component that provides the Mocks context that can be used to provide mocks to the mock-aware hook functions.
+ *
+ * @param children The children to render.
+ * @returns The children wrapped in the Mocks context provider.
+ */
+export const MocksContextProvider = MocksContext.Provider;

package/dist/logger.d.ts

@@ -1,8 +1 @@
-interface Logger {
-    debug: (value: string) => void;
-    info: (value: string) => void;
-    warn: (value: string) => void;
-    error: (value: string) => void;
-}
-export declare const logger: Logger;
-export {};
+export declare const logger: import("./shared/types/logger.ts").Logger;

package/dist/logger.js

@@ -1,2 +1,3 @@
-/* eslint-disable hubspot-dev/no-confusing-browser-globals */
-export const logger = self.logger;
+import { getWorkerGlobals } from "./internal/global-utils.js";
+const workerGlobals = getWorkerGlobals();
+export const logger = workerGlobals.logger;

package/dist/pages/home/index.d.ts

@@ -1 +1 @@
-export { HeaderActions, PrimaryHeaderActionButton, SecondaryHeaderActionButton, } from '../../__synced__/remoteComponents.synced';
+export { HeaderActions, PrimaryHeaderActionButton, SecondaryHeaderActionButton, } from '../../shared/remoteComponents.tsx';

package/dist/pages/home/index.js

@@ -1 +1 @@
-export { HeaderActions, PrimaryHeaderActionButton, SecondaryHeaderActionButton, } from '../../__synced__/remoteComponents.synced';
+export { HeaderActions, PrimaryHeaderActionButton, SecondaryHeaderActionButton, } from "../../shared/remoteComponents.js";