@kodiak-finance/orderly-plugin-core 2.9.2-alpha.0

package/dist/index.d.mts

@@ -0,0 +1,266 @@
+import React$1, { FC, PropsWithChildren, ReactNode, ReactElement, ElementType, ComponentType } from 'react';
+import { TrackerEventName, NetworkId } from '@kodiak-finance/orderly-types';
+
+/**
+ * Plugin scope value: identifies the current plugin for API request attribution.
+ * When useQuery etc. run inside PluginScopeProvider, they add X-Orderly-Plugin-Id header.
+ */
+interface PluginScopeValue {
+    pluginId: string;
+    pluginName?: string;
+    pluginVersion?: string;
+}
+declare const PluginScopeContext: React$1.Context<PluginScopeValue | null>;
+declare const usePluginScope: () => PluginScopeValue | null;
+interface PluginScopeProviderProps extends PropsWithChildren, PluginScopeValue {
+}
+/**
+ * Wraps plugin output so useQuery/useMutation etc. can inject X-Orderly-Plugin-Id header.
+ */
+declare const PluginScopeProvider: FC<PluginScopeProviderProps>;
+
+/**
+ * Plugin events API interface.
+ * Forwards to global EventEmitter (SimpleDI "EE") used by useTrack and useEventEmitter.
+ */
+interface PluginEventsAPI {
+    on(event: TrackerEventName, handler: (data: unknown) => void): void;
+    off(event: TrackerEventName, handler: (data: unknown) => void): void;
+}
+/**
+ * Creates the events facade wired to the global EventEmitter (SimpleDI "EE").
+ * Returns a noop stub if EE has not been initialized yet.
+ */
+declare function createEventsFacade(): PluginEventsAPI;
+
+/** API Facade for plugins (placeholder, extend later) */
+interface OrderlyPluginAPI {
+    data?: Record<string, unknown>;
+    actions?: Record<string, unknown>;
+    utils?: Record<string, unknown>;
+    /** Event subscription - forwards to global EventEmitter (SimpleDI "EE") */
+    events: PluginEventsAPI;
+}
+/**
+ * Mapping from interceptor target path to component props type.
+ * Extend via module augmentation in UI packages (e.g. @orderly.network/trading)
+ * to enable typed props in createInterceptor(target, (Original, props, api) => ...).
+ * No index signature so that augmented entries keep their exact prop types.
+ */
+interface InterceptorTargetPropsMap {
+}
+/** Union of known interceptor target paths (keys of InterceptorTargetPropsMap) */
+type KnownInterceptorTarget = keyof InterceptorTargetPropsMap;
+/**
+ * Descriptor for one interceptable target (path + optional props type name for docs).
+ * Returned lazily by window.__ORDERLY_INTERCEPTOR_TARGETS_REGISTRY__() when called.
+ */
+interface InterceptorTargetDescriptor {
+    path: string;
+    /** Props type name (e.g. 'DepositFormProps') for documentation / Inspector */
+    propsType?: string;
+    description?: string;
+}
+declare global {
+    interface Window {
+        /** Lazy getter: when called, collects supported targets from current plugins' interceptors. Set by OrderlyPluginProvider. Same style as __ORDERLY_EXTENSION_REGISTRY__. */
+        __ORDERLY_INTERCEPTOR_TARGETS_REGISTRY__?: () => InterceptorTargetDescriptor[];
+    }
+}
+/**
+ * Interceptor component signature: (Original, props, api) => ReactNode.
+ * Use generic TProps to get typed props when targeting a known path.
+ */
+type PluginInterceptorComponent<TProps extends object = Record<string, unknown>> = (Original: React.ComponentType<TProps>, props: TProps, api: OrderlyPluginAPI) => ReactNode;
+/** Single interceptor targeting a component path. TProps defaults to Record<string, unknown> for backward compat. */
+interface PluginInterceptor<TProps extends object = Record<string, unknown>> {
+    target: string;
+    component: PluginInterceptorComponent<TProps>;
+}
+/** Plugin descriptor (per GUIDE.md) */
+interface OrderlyPlugin {
+    id: string;
+    name?: string;
+    version?: string;
+    orderlyVersion?: string;
+    /** Interceptors targeting component paths (e.g. Trading.OrderEntry.SubmitButton). Uses array of any to accept interceptors whose props are augmented (and may not have index signature required by Record<string, unknown>). */
+    interceptors?: Array<PluginInterceptor<any>>;
+    setup?: (api: OrderlyPluginAPI) => void;
+    onInitialize?: () => void;
+    onInstall?: () => void | Promise<void>;
+    onError?: (error: Error) => void;
+    onFallback?: () => ReactNode | ReactElement;
+}
+/** SDK instance passed to plugin registration fn */
+interface OrderlySDK {
+    registerPlugin: (descriptor: OrderlyPlugin) => void;
+}
+type Logo = {
+    img?: string;
+    component?: ReactNode;
+    className?: string;
+};
+type AppLogos = Partial<{
+    main: Logo;
+    secondary: Logo;
+}>;
+interface ApplicationState {
+    config: {
+        appIcons?: AppLogos;
+        brokerName: string;
+        dateFormatting?: string;
+    };
+    networkId: NetworkId;
+}
+/** Plugin registration function: (SDK, state?) => void; calls SDK.registerPlugin internally */
+type PluginRegistrationFn<TState = ApplicationState> = (SDK: OrderlySDK, state?: TState) => void;
+/** @deprecated Use PluginInterceptor with path-based target instead */
+type ExtensionBuilder<Props = Record<string, unknown>> = (props?: Partial<Props> & Record<string, unknown>) => Props;
+/** @deprecated Use path strings (e.g. 'Deposit.DepositForm') instead */
+type ExtensionPosition = ExtensionPositionEnum | string;
+/** @deprecated Use OrderlyPlugin with interceptors instead */
+interface Extension<Props extends object = object> {
+    __isInternal: boolean;
+    name: string;
+    positions: ExtensionPosition[];
+    initialize?: () => void;
+    builder?: ExtensionBuilder<Props>;
+    render: ElementType<Props> | ((props: Props) => ReactElement);
+}
+/** @deprecated Use path strings (e.g. 'Deposit.DepositForm') instead */
+declare enum ExtensionPositionEnum {
+    DepositForm = "depositForm",
+    WithdrawForm = "withdrawForm",
+    AccountMenu = "accountMenu",
+    MobileAccountMenu = "mobileAccountMenu",
+    MainMenus = "mainMenus",
+    EmptyDataIdentifier = "emptyDataIdentifier",
+    /** @deprecated Use EmptyDataIdentifier - same value for backward compatibility */
+    EmptyDataState = "emptyDataIdentifier"
+}
+
+type ExtensionContextState = Record<string, never>;
+declare const useExtensionContext: () => ExtensionContextState;
+declare const ExtensionProvider: React$1.FC<React$1.PropsWithChildren>;
+interface OrderlyPluginContextValue {
+    plugins: OrderlyPlugin[];
+    apiFacade: OrderlyPluginAPI;
+    /** List of interceptable targets (when provided by host); used for window registry and optional useInterceptorTargets */
+    interceptorTargets: InterceptorTargetDescriptor[];
+}
+declare const useOrderlyPluginContext: () => OrderlyPluginContextValue;
+/** Returns the list of interceptable targets when provided via OrderlyPluginProvider (e.g. for in-app dev panel). */
+declare const useInterceptorTargets: () => InterceptorTargetDescriptor[];
+interface OrderlyPluginProviderProps extends PropsWithChildren {
+    plugins: (OrderlyPlugin | PluginRegistrationFn)[];
+    /** Optional state passed to plugin registration fns (e.g. AppState) */
+    pluginState?: ApplicationState;
+}
+declare const OrderlyPluginProvider: FC<OrderlyPluginProviderProps>;
+
+/** @deprecated Use OrderlyPlugin with interceptors instead */
+type ExtensionOptions<Props> = {
+    name: string;
+    scope?: string[];
+    engines?: string;
+    positions: ExtensionPosition[];
+    builder?: (props: any) => Props;
+    __isInternal?: boolean;
+    entry?: string[];
+    installed?: () => Promise<void>;
+    onInit?: () => void;
+    activate?: () => Promise<void>;
+    deactivate?: () => Promise<void>;
+};
+type ExtensionRenderComponentType<Props> = ElementType<Props> | ((props: Props) => ReactElement);
+/**
+ * Registers an extension. Registers to both legacy registry and new plugin registry.
+ * @deprecated Prefer registerPlugin via OrderlyPluginProvider plugins prop
+ */
+declare const installExtension: <Props extends object>(options: ExtensionOptions<Props>) => ((component: ExtensionRenderComponentType<Props>) => void);
+/**
+ * @deprecated Prefer registerPlugin via OrderlyPluginProvider plugins prop
+ */
+declare const setExtensionBuilder: <Props extends object = Record<string, unknown>>(position: ExtensionPosition, builder: () => Props) => void;
+
+interface SlotProps {
+    position: ExtensionPosition;
+    defaultWidget?: React$1.ComponentType<any>;
+    scope?: string[];
+    [key: string]: any;
+}
+/**
+ * Renders the component for the given position, resolving interceptors via useInjectedComponent.
+ * Requires OrderlyPluginProvider in the tree (can have plugins=[]).
+ * @deprecated Prefer useInjectedComponent with path string directly (e.g. 'Deposit.DepositForm')
+ */
+declare const ExtensionSlot: React$1.FC<SlotProps>;
+
+/**
+ * Returns a component that chains all interceptors for the given path (onion model).
+ * Each interceptor is wrapped in PluginErrorBoundary; plugin's onError/onFallback
+ * are used when provided, else SDK defaults.
+ */
+declare function useInjectedComponent<P extends object>(name: string, DefaultComponent: ComponentType<P>): ComponentType<P>;
+
+/**
+ * HOC: wraps a component to make it interceptable by plugins.
+ * Registers the target path in a static registry so it appears in interceptor target lists.
+ */
+declare function injectable<P extends object>(Component: ComponentType<P>, name: string): ComponentType<P>;
+
+/**
+ * Converts ExtensionPosition to interceptor path.
+ * @deprecated Use path strings directly (e.g. 'Deposit.DepositForm') instead of ExtensionPosition
+ */
+declare function positionToPath(position: ExtensionPosition): string;
+
+declare const OrderlyPluginRegistry: {
+    register(descriptor: OrderlyPlugin): void;
+    getPlugins(): OrderlyPlugin[];
+    clear(): void;
+};
+/** SDK instance for plugin registration (used by registration fns) */
+declare const createOrderlySDK: () => OrderlySDK;
+
+/**
+ * String-target overload: use when `@orderly.network/plugin-core` is the only dependency and
+ * `InterceptorTargetPropsMap` is empty (ambient augmentation from UI packages not loaded).
+ * Avoids DTS failures where keyof an empty map is `never`.
+ */
+declare function createInterceptor(target: string, component: PluginInterceptorComponent<Record<string, unknown>>): PluginInterceptor<Record<string, unknown>>;
+/** Typed overload when workspace packages augment `InterceptorTargetPropsMap`. */
+declare function createInterceptor<T extends KnownInterceptorTarget>(target: T, component: PluginInterceptorComponent<InterceptorTargetPropsMap[T]>): PluginInterceptor<InterceptorTargetPropsMap[T]>;
+
+/**
+ * Legacy extension registry (position-based, for installExtension backward compat).
+ * @deprecated Use registerPlugin via OrderlyPluginProvider plugins prop instead
+ */
+declare class OrderlyExtensionRegistry {
+    static getInstance(): OrderlyExtensionRegistry;
+    private extensionMap;
+    register<Props extends object>(plugin: Omit<Extension<Props>, "builder"> & {
+        builder?: (props: any) => Props;
+    }): void;
+    private registerToPosition;
+    setBuilder<Props extends object>(position: ExtensionPosition, builder: ExtensionBuilder<Props>): void;
+    getPluginsByPosition(position: ExtensionPosition): Extension<Record<string, unknown>> | undefined;
+}
+
+/**
+ * Error boundary for plugin interceptors.
+ * Prevents a single plugin crash from taking down the whole page.
+ * Uses plugin's onError/onFallback when provided, else SDK defaults.
+ */
+declare const PluginErrorBoundary: React$1.FC<{
+    children: ReactNode;
+    /** Override fallback (legacy); prefer onFallback from plugin */
+    fallback?: ReactNode;
+    pluginId?: string;
+    /** Plugin's error handler; called when error is caught */
+    onError?: (error: Error) => void;
+    /** Plugin's fallback renderer; used when error is caught */
+    onFallback?: () => ReactNode;
+}>;
+
+export { type ApplicationState, type Extension, type ExtensionBuilder, type ExtensionOptions, type ExtensionPosition, ExtensionPositionEnum, ExtensionProvider, ExtensionSlot, type InterceptorTargetDescriptor, type InterceptorTargetPropsMap, type KnownInterceptorTarget, OrderlyExtensionRegistry, type OrderlyPlugin, type OrderlyPluginAPI, type OrderlyPluginContextValue, OrderlyPluginProvider, OrderlyPluginRegistry, type OrderlySDK, PluginErrorBoundary, type PluginEventsAPI, type PluginInterceptor, type PluginInterceptorComponent, type PluginRegistrationFn, PluginScopeContext, PluginScopeProvider, type PluginScopeValue, createEventsFacade, createInterceptor, createOrderlySDK, injectable, installExtension, positionToPath, setExtensionBuilder, useExtensionContext, useInjectedComponent, useInterceptorTargets, useOrderlyPluginContext, usePluginScope };

package/dist/index.d.ts

@@ -0,0 +1,266 @@
+import React$1, { FC, PropsWithChildren, ReactNode, ReactElement, ElementType, ComponentType } from 'react';
+import { TrackerEventName, NetworkId } from '@kodiak-finance/orderly-types';
+
+/**
+ * Plugin scope value: identifies the current plugin for API request attribution.
+ * When useQuery etc. run inside PluginScopeProvider, they add X-Orderly-Plugin-Id header.
+ */
+interface PluginScopeValue {
+    pluginId: string;
+    pluginName?: string;
+    pluginVersion?: string;
+}
+declare const PluginScopeContext: React$1.Context<PluginScopeValue | null>;
+declare const usePluginScope: () => PluginScopeValue | null;
+interface PluginScopeProviderProps extends PropsWithChildren, PluginScopeValue {
+}
+/**
+ * Wraps plugin output so useQuery/useMutation etc. can inject X-Orderly-Plugin-Id header.
+ */
+declare const PluginScopeProvider: FC<PluginScopeProviderProps>;
+
+/**
+ * Plugin events API interface.
+ * Forwards to global EventEmitter (SimpleDI "EE") used by useTrack and useEventEmitter.
+ */
+interface PluginEventsAPI {
+    on(event: TrackerEventName, handler: (data: unknown) => void): void;
+    off(event: TrackerEventName, handler: (data: unknown) => void): void;
+}
+/**
+ * Creates the events facade wired to the global EventEmitter (SimpleDI "EE").
+ * Returns a noop stub if EE has not been initialized yet.
+ */
+declare function createEventsFacade(): PluginEventsAPI;
+
+/** API Facade for plugins (placeholder, extend later) */
+interface OrderlyPluginAPI {
+    data?: Record<string, unknown>;
+    actions?: Record<string, unknown>;
+    utils?: Record<string, unknown>;
+    /** Event subscription - forwards to global EventEmitter (SimpleDI "EE") */
+    events: PluginEventsAPI;
+}
+/**
+ * Mapping from interceptor target path to component props type.
+ * Extend via module augmentation in UI packages (e.g. @orderly.network/trading)
+ * to enable typed props in createInterceptor(target, (Original, props, api) => ...).
+ * No index signature so that augmented entries keep their exact prop types.
+ */
+interface InterceptorTargetPropsMap {
+}
+/** Union of known interceptor target paths (keys of InterceptorTargetPropsMap) */
+type KnownInterceptorTarget = keyof InterceptorTargetPropsMap;
+/**
+ * Descriptor for one interceptable target (path + optional props type name for docs).
+ * Returned lazily by window.__ORDERLY_INTERCEPTOR_TARGETS_REGISTRY__() when called.
+ */
+interface InterceptorTargetDescriptor {
+    path: string;
+    /** Props type name (e.g. 'DepositFormProps') for documentation / Inspector */
+    propsType?: string;
+    description?: string;
+}
+declare global {
+    interface Window {
+        /** Lazy getter: when called, collects supported targets from current plugins' interceptors. Set by OrderlyPluginProvider. Same style as __ORDERLY_EXTENSION_REGISTRY__. */
+        __ORDERLY_INTERCEPTOR_TARGETS_REGISTRY__?: () => InterceptorTargetDescriptor[];
+    }
+}
+/**
+ * Interceptor component signature: (Original, props, api) => ReactNode.
+ * Use generic TProps to get typed props when targeting a known path.
+ */
+type PluginInterceptorComponent<TProps extends object = Record<string, unknown>> = (Original: React.ComponentType<TProps>, props: TProps, api: OrderlyPluginAPI) => ReactNode;
+/** Single interceptor targeting a component path. TProps defaults to Record<string, unknown> for backward compat. */
+interface PluginInterceptor<TProps extends object = Record<string, unknown>> {
+    target: string;
+    component: PluginInterceptorComponent<TProps>;
+}
+/** Plugin descriptor (per GUIDE.md) */
+interface OrderlyPlugin {
+    id: string;
+    name?: string;
+    version?: string;
+    orderlyVersion?: string;
+    /** Interceptors targeting component paths (e.g. Trading.OrderEntry.SubmitButton). Uses array of any to accept interceptors whose props are augmented (and may not have index signature required by Record<string, unknown>). */
+    interceptors?: Array<PluginInterceptor<any>>;
+    setup?: (api: OrderlyPluginAPI) => void;
+    onInitialize?: () => void;
+    onInstall?: () => void | Promise<void>;
+    onError?: (error: Error) => void;
+    onFallback?: () => ReactNode | ReactElement;
+}
+/** SDK instance passed to plugin registration fn */
+interface OrderlySDK {
+    registerPlugin: (descriptor: OrderlyPlugin) => void;
+}
+type Logo = {
+    img?: string;
+    component?: ReactNode;
+    className?: string;
+};
+type AppLogos = Partial<{
+    main: Logo;
+    secondary: Logo;
+}>;
+interface ApplicationState {
+    config: {
+        appIcons?: AppLogos;
+        brokerName: string;
+        dateFormatting?: string;
+    };
+    networkId: NetworkId;
+}
+/** Plugin registration function: (SDK, state?) => void; calls SDK.registerPlugin internally */
+type PluginRegistrationFn<TState = ApplicationState> = (SDK: OrderlySDK, state?: TState) => void;
+/** @deprecated Use PluginInterceptor with path-based target instead */
+type ExtensionBuilder<Props = Record<string, unknown>> = (props?: Partial<Props> & Record<string, unknown>) => Props;
+/** @deprecated Use path strings (e.g. 'Deposit.DepositForm') instead */
+type ExtensionPosition = ExtensionPositionEnum | string;
+/** @deprecated Use OrderlyPlugin with interceptors instead */
+interface Extension<Props extends object = object> {
+    __isInternal: boolean;
+    name: string;
+    positions: ExtensionPosition[];
+    initialize?: () => void;
+    builder?: ExtensionBuilder<Props>;
+    render: ElementType<Props> | ((props: Props) => ReactElement);
+}
+/** @deprecated Use path strings (e.g. 'Deposit.DepositForm') instead */
+declare enum ExtensionPositionEnum {
+    DepositForm = "depositForm",
+    WithdrawForm = "withdrawForm",
+    AccountMenu = "accountMenu",
+    MobileAccountMenu = "mobileAccountMenu",
+    MainMenus = "mainMenus",
+    EmptyDataIdentifier = "emptyDataIdentifier",
+    /** @deprecated Use EmptyDataIdentifier - same value for backward compatibility */
+    EmptyDataState = "emptyDataIdentifier"
+}
+
+type ExtensionContextState = Record<string, never>;
+declare const useExtensionContext: () => ExtensionContextState;
+declare const ExtensionProvider: React$1.FC<React$1.PropsWithChildren>;
+interface OrderlyPluginContextValue {
+    plugins: OrderlyPlugin[];
+    apiFacade: OrderlyPluginAPI;
+    /** List of interceptable targets (when provided by host); used for window registry and optional useInterceptorTargets */
+    interceptorTargets: InterceptorTargetDescriptor[];
+}
+declare const useOrderlyPluginContext: () => OrderlyPluginContextValue;
+/** Returns the list of interceptable targets when provided via OrderlyPluginProvider (e.g. for in-app dev panel). */
+declare const useInterceptorTargets: () => InterceptorTargetDescriptor[];
+interface OrderlyPluginProviderProps extends PropsWithChildren {
+    plugins: (OrderlyPlugin | PluginRegistrationFn)[];
+    /** Optional state passed to plugin registration fns (e.g. AppState) */
+    pluginState?: ApplicationState;
+}
+declare const OrderlyPluginProvider: FC<OrderlyPluginProviderProps>;
+
+/** @deprecated Use OrderlyPlugin with interceptors instead */
+type ExtensionOptions<Props> = {
+    name: string;
+    scope?: string[];
+    engines?: string;
+    positions: ExtensionPosition[];
+    builder?: (props: any) => Props;
+    __isInternal?: boolean;
+    entry?: string[];
+    installed?: () => Promise<void>;
+    onInit?: () => void;
+    activate?: () => Promise<void>;
+    deactivate?: () => Promise<void>;
+};
+type ExtensionRenderComponentType<Props> = ElementType<Props> | ((props: Props) => ReactElement);
+/**
+ * Registers an extension. Registers to both legacy registry and new plugin registry.
+ * @deprecated Prefer registerPlugin via OrderlyPluginProvider plugins prop
+ */
+declare const installExtension: <Props extends object>(options: ExtensionOptions<Props>) => ((component: ExtensionRenderComponentType<Props>) => void);
+/**
+ * @deprecated Prefer registerPlugin via OrderlyPluginProvider plugins prop
+ */
+declare const setExtensionBuilder: <Props extends object = Record<string, unknown>>(position: ExtensionPosition, builder: () => Props) => void;
+
+interface SlotProps {
+    position: ExtensionPosition;
+    defaultWidget?: React$1.ComponentType<any>;
+    scope?: string[];
+    [key: string]: any;
+}
+/**
+ * Renders the component for the given position, resolving interceptors via useInjectedComponent.
+ * Requires OrderlyPluginProvider in the tree (can have plugins=[]).
+ * @deprecated Prefer useInjectedComponent with path string directly (e.g. 'Deposit.DepositForm')
+ */
+declare const ExtensionSlot: React$1.FC<SlotProps>;
+
+/**
+ * Returns a component that chains all interceptors for the given path (onion model).
+ * Each interceptor is wrapped in PluginErrorBoundary; plugin's onError/onFallback
+ * are used when provided, else SDK defaults.
+ */
+declare function useInjectedComponent<P extends object>(name: string, DefaultComponent: ComponentType<P>): ComponentType<P>;
+
+/**
+ * HOC: wraps a component to make it interceptable by plugins.
+ * Registers the target path in a static registry so it appears in interceptor target lists.
+ */
+declare function injectable<P extends object>(Component: ComponentType<P>, name: string): ComponentType<P>;
+
+/**
+ * Converts ExtensionPosition to interceptor path.
+ * @deprecated Use path strings directly (e.g. 'Deposit.DepositForm') instead of ExtensionPosition
+ */
+declare function positionToPath(position: ExtensionPosition): string;
+
+declare const OrderlyPluginRegistry: {
+    register(descriptor: OrderlyPlugin): void;
+    getPlugins(): OrderlyPlugin[];
+    clear(): void;
+};
+/** SDK instance for plugin registration (used by registration fns) */
+declare const createOrderlySDK: () => OrderlySDK;
+
+/**
+ * String-target overload: use when `@orderly.network/plugin-core` is the only dependency and
+ * `InterceptorTargetPropsMap` is empty (ambient augmentation from UI packages not loaded).
+ * Avoids DTS failures where keyof an empty map is `never`.
+ */
+declare function createInterceptor(target: string, component: PluginInterceptorComponent<Record<string, unknown>>): PluginInterceptor<Record<string, unknown>>;
+/** Typed overload when workspace packages augment `InterceptorTargetPropsMap`. */
+declare function createInterceptor<T extends KnownInterceptorTarget>(target: T, component: PluginInterceptorComponent<InterceptorTargetPropsMap[T]>): PluginInterceptor<InterceptorTargetPropsMap[T]>;
+
+/**
+ * Legacy extension registry (position-based, for installExtension backward compat).
+ * @deprecated Use registerPlugin via OrderlyPluginProvider plugins prop instead
+ */
+declare class OrderlyExtensionRegistry {
+    static getInstance(): OrderlyExtensionRegistry;
+    private extensionMap;
+    register<Props extends object>(plugin: Omit<Extension<Props>, "builder"> & {
+        builder?: (props: any) => Props;
+    }): void;
+    private registerToPosition;
+    setBuilder<Props extends object>(position: ExtensionPosition, builder: ExtensionBuilder<Props>): void;
+    getPluginsByPosition(position: ExtensionPosition): Extension<Record<string, unknown>> | undefined;
+}
+
+/**
+ * Error boundary for plugin interceptors.
+ * Prevents a single plugin crash from taking down the whole page.
+ * Uses plugin's onError/onFallback when provided, else SDK defaults.
+ */
+declare const PluginErrorBoundary: React$1.FC<{
+    children: ReactNode;
+    /** Override fallback (legacy); prefer onFallback from plugin */
+    fallback?: ReactNode;
+    pluginId?: string;
+    /** Plugin's error handler; called when error is caught */
+    onError?: (error: Error) => void;
+    /** Plugin's fallback renderer; used when error is caught */
+    onFallback?: () => ReactNode;
+}>;
+
+export { type ApplicationState, type Extension, type ExtensionBuilder, type ExtensionOptions, type ExtensionPosition, ExtensionPositionEnum, ExtensionProvider, ExtensionSlot, type InterceptorTargetDescriptor, type InterceptorTargetPropsMap, type KnownInterceptorTarget, OrderlyExtensionRegistry, type OrderlyPlugin, type OrderlyPluginAPI, type OrderlyPluginContextValue, OrderlyPluginProvider, OrderlyPluginRegistry, type OrderlySDK, PluginErrorBoundary, type PluginEventsAPI, type PluginInterceptor, type PluginInterceptorComponent, type PluginRegistrationFn, PluginScopeContext, PluginScopeProvider, type PluginScopeValue, createEventsFacade, createInterceptor, createOrderlySDK, injectable, installExtension, positionToPath, setExtensionBuilder, useExtensionContext, useInjectedComponent, useInterceptorTargets, useOrderlyPluginContext, usePluginScope };