@codeleap/portals 6.3.0 → 7.0.0

package/dist/factors/alert.d.ts

@@ -0,0 +1,44 @@
+import { AnyFunction } from '@codeleap/types';
+import { Modal } from './modal';
+/** Discriminant for alert categories used to control icon/style in the wrapper component. */
+export type AlertType = 'info' | 'error' | 'warn' | 'ask' | 'custom';
+/** A single button option rendered inside an alert dialog. */
+export type AlertOption = {
+    text: string;
+    onPress?: AnyFunction;
+    style?: 'destructive' | 'outline' | 'cancel' | 'default' | 'minimal';
+};
+/** Configuration options for displaying an alert dialog. */
+export type AlertOptions = {
+    title?: string;
+    body?: string;
+    options?: AlertOption[];
+    onDismiss?: AnyFunction;
+    type?: AlertType;
+};
+/**
+ * Alert utility for displaying typed alert modals (info, error, warn, ask, custom).
+ * Provides convenient methods for common alert scenarios.
+ */
+export declare class Alert {
+    /**
+     * Returns the Modal instance used to display alerts.
+     * Must be implemented by the consuming app before calling any alert method.
+     * @throws Error if not implemented
+     */
+    static openAlert(): Modal<AlertOptions>;
+    private trigger;
+    /** Opens an alert with 'ask' type. */
+    ask(args: AlertOptions): void;
+    /** Opens an alert with 'error' type. */
+    error(args: AlertOptions): void;
+    /** Opens an alert with 'warn' type. */
+    warn(args: AlertOptions): void;
+    /** Opens an alert with 'info' type. */
+    info(args: AlertOptions): void;
+    /** Opens a custom alert with user-defined options and type. */
+    custom<T>(options: Partial<AlertOptions> & T): void;
+}
+/** Global alert instance for showing alerts throughout the app. */
+export declare const alert: Alert;
+//# sourceMappingURL=alert.d.ts.map

package/dist/factors/alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../src/factors/alert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B,6FAA6F;AAC7F,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;AAEpE,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;CACrE,CAAA;AAED,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB,CAAA;AAED;;;GAGG;AACH,qBAAa,KAAK;IAEhB;;;;OAIG;IACH,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,YAAY,CAAC;IAIvC,OAAO,CAAC,OAAO;IAIf,sCAAsC;IACtC,GAAG,CAAC,IAAI,EAAE,YAAY;IAItB,wCAAwC;IACxC,KAAK,CAAC,IAAI,EAAE,YAAY;IAIxB,uCAAuC;IACvC,IAAI,CAAC,IAAI,EAAE,YAAY;IAIvB,uCAAuC;IACvC,IAAI,CAAC,IAAI,EAAE,YAAY;IAIvB,+DAA+D;IAC/D,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC;CAG7C;AAED,mEAAmE;AACnE,eAAO,MAAM,KAAK,OAAc,CAAA"}

package/dist/factors/bottomSheet.d.ts

@@ -0,0 +1,61 @@
+import { Portal } from '../lib/Portal';
+import { PortalConstructorParam, PortalConfig, PortalWrapperProps } from '../types';
+import { BottomSheetRef, BottomSheetWrapperProps } from '../globals';
+import { Keyof } from '@codeleap/types';
+import { ReactElement } from 'react';
+/**
+ * Bottom sheet portal for bottom-sliding panels.
+ * Extends Portal with bottom sheet-specific wrapper, configuration and ref methods.
+ *
+ * @template Params - Custom bottom sheet parameters
+ * @template Result - Type of result returned by request
+ * @template Metadata - Additional configuration metadata
+ */
+export declare class BottomSheet<Params = {}, Result = {}, Metadata = {}> extends Portal<Params, Result, Metadata, BottomSheetRef, BottomSheetWrapperProps> {
+    displayName: string;
+    /** Wrapper component used to render bottom sheet UI. Must be assigned by the consuming app. */
+    static WrapperComponent: (props: PortalWrapperProps<BottomSheetWrapperProps, BottomSheetRef>) => ReactElement | null;
+    /** Default transition duration in milliseconds for bottom sheet open/close animations. */
+    static DEFAULT_TRANSITION_DURATION: number;
+    /** @inheritdoc */
+    protected get defaultTransitionDuration(): number;
+    /** @inheritdoc */
+    protected get wrapperComponent(): any;
+    /** Closes all open BottomSheet instances. */
+    static closeAll(): Promise<void>;
+    /** Name of the ref method to call imperatively when opening the sheet (set by the consuming app). */
+    static openKeyMethod: Keyof<BottomSheetRef>;
+    /** Name of the ref method to call imperatively when closing the sheet (set by the consuming app). */
+    static closeKeyMethod: Keyof<BottomSheetRef>;
+    /** Returns default config: `rendersWhenHidden=true` and `resetParamsOnClose=false`. */
+    protected getDefaultConfig(): Partial<PortalConfig<Params, Metadata>>;
+    /** Calls the native open method on the ref via `openKeyMethod`, if configured. */
+    protected openBottomSheet(): void;
+    /** Calls the native close method on the ref via `closeKeyMethod`, if configured. */
+    protected closeBottomSheet(): void;
+    /** @inheritdoc — also triggers the native open animation via `openBottomSheet()`. */
+    protected handleOpen(): void;
+    /** @inheritdoc — also triggers the native close animation via `closeBottomSheet()`. */
+    protected handleClose(): void;
+    /**
+     * Registers a callback to be called when bottom sheet opens.
+     * Overrides parent to ensure native open method is called.
+     * @param callback - Function to execute on open
+     * @returns The bottom sheet instance for chaining
+     */
+    onOpen(callback: (portal: Portal<Params, Result, Metadata, BottomSheetRef, BottomSheetWrapperProps>) => void): this;
+    /**
+     * Registers a callback to be called when bottom sheet closes.
+     * Overrides parent to ensure native close method is called.
+     * @param callback - Function to execute on close
+     * @returns The bottom sheet instance for chaining
+     */
+    onClose(callback: (portal: Portal<Params, Result, Metadata, BottomSheetRef, BottomSheetWrapperProps>) => void): this;
+}
+/**
+ * Factory function to create a new BottomSheet instance.
+ * @param idOrConfig - BottomSheet ID or configuration object
+ * @returns New BottomSheet instance
+ */
+export declare function bottomSheet<Params = {}, Result = {}, Metadata = {}>(idOrConfig?: PortalConstructorParam<Params, Metadata>): BottomSheet<Params, Result, Metadata>;
+//# sourceMappingURL=bottomSheet.d.ts.map

package/dist/factors/bottomSheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bottomSheet.d.ts","sourceRoot":"","sources":["../../src/factors/bottomSheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AACnF,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC;;;;;;;GAOG;AACH,qBAAa,WAAW,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,CAAE,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,uBAAuB,CAAC;IACjJ,WAAW,SAAgB;IAE3B,+FAA+F;IAC/F,MAAM,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,uBAAuB,EAAE,cAAc,CAAC,KAAK,YAAY,GAAG,IAAI,CAAa;IAEjI,0FAA0F;IAC1F,MAAM,CAAC,2BAA2B,SAAM;IAExC,kBAAkB;IAClB,SAAS,KAAK,yBAAyB,WAEtC;IAED,kBAAkB;IAClB,SAAS,KAAK,gBAAgB,IAAI,GAAG,CAEpC;IAED,6CAA6C;WAChC,QAAQ;IAKrB,qGAAqG;IACrG,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;IAE3C,qGAAqG;IACrG,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;IAE5C,uFAAuF;IACvF,SAAS,CAAC,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAOrE,kFAAkF;IAClF,SAAS,CAAC,eAAe;IAMzB,oFAAoF;IACpF,SAAS,CAAC,gBAAgB;IAM1B,qFAAqF;IACrF,SAAS,CAAC,UAAU;IAIpB,uFAAuF;IACvF,SAAS,CAAC,WAAW;IAIrB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,uBAAuB,CAAC,KAAK,IAAI;IAS5G;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,uBAAuB,CAAC,KAAK,IAAI;CAQ9G;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,UAAU,CAAC,EAAE,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,yCAEzH"}

package/dist/factors/drawer.d.ts

@@ -0,0 +1,32 @@
+import { ReactElement } from 'react';
+import { DrawerRef, DrawerWrapperProps } from '../globals';
+import { Portal } from '../lib/Portal';
+import { PortalConstructorParam, PortalWrapperProps } from '../types';
+/**
+ * Drawer portal for side-sliding panels.
+ * Extends Portal with drawer-specific wrapper and configuration.
+ *
+ * @template Params - Custom drawer parameters
+ * @template Result - Type of result returned by request
+ * @template Metadata - Additional configuration metadata
+ */
+export declare class Drawer<Params = {}, Result = {}, Metadata = {}> extends Portal<Params, Result, Metadata, DrawerRef, DrawerWrapperProps> {
+    displayName: string;
+    /** Wrapper component used to render drawer UI. Must be assigned by the consuming app. */
+    static WrapperComponent: (props: PortalWrapperProps<DrawerWrapperProps, DrawerRef>) => ReactElement | null;
+    /** Default transition duration in milliseconds for drawer open/close animations. */
+    static DEFAULT_TRANSITION_DURATION: number;
+    /** @inheritdoc */
+    protected get defaultTransitionDuration(): number;
+    /** @inheritdoc */
+    protected get wrapperComponent(): any;
+    /** Closes all open Drawer instances. */
+    static closeAll(): Promise<void>;
+}
+/**
+ * Factory function to create a new Drawer instance.
+ * @param idOrConfig - Drawer ID or configuration object
+ * @returns New Drawer instance
+ */
+export declare function drawer<Params = {}, Result = {}, Metadata = {}>(idOrConfig?: PortalConstructorParam<Params, Metadata>): Drawer<Params, Result, Metadata>;
+//# sourceMappingURL=drawer.d.ts.map

package/dist/factors/drawer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawer.d.ts","sourceRoot":"","sources":["../../src/factors/drawer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAErE;;;;;;;GAOG;AACH,qBAAa,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,CAAE,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,CAAC;IAClI,WAAW,SAAW;IAEtB,yFAAyF;IACzF,MAAM,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,kBAAkB,EAAE,SAAS,CAAC,KAAK,YAAY,GAAG,IAAI,CAAa;IAEvH,oFAAoF;IACpF,MAAM,CAAC,2BAA2B,SAAM;IAExC,kBAAkB;IAClB,SAAS,KAAK,yBAAyB,WAEtC;IAED,kBAAkB;IAClB,SAAS,KAAK,gBAAgB,IAAI,GAAG,CAEpC;IAED,wCAAwC;WAC3B,QAAQ;CAItB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,UAAU,CAAC,EAAE,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,oCAEpH"}

package/dist/factors/modal.d.ts

@@ -0,0 +1,32 @@
+import { ReactElement } from 'react';
+import { ModalRef, ModalWrapperProps } from '../globals';
+import { Portal } from '../lib/Portal';
+import { PortalConstructorParam, PortalWrapperProps } from '../types';
+/**
+ * Modal portal for centered overlay dialogs.
+ * Extends Portal with modal-specific wrapper and configuration.
+ *
+ * @template Params - Custom modal parameters
+ * @template Result - Type of result returned by request
+ * @template Metadata - Additional configuration metadata
+ */
+export declare class Modal<Params = {}, Result = {}, Metadata = {}> extends Portal<Params, Result, Metadata, ModalRef, ModalWrapperProps> {
+    displayName: string;
+    /** Wrapper component used to render modal UI. Must be assigned by the consuming app. */
+    static WrapperComponent: (props: PortalWrapperProps<ModalWrapperProps, ModalRef>) => ReactElement | null;
+    /** Default transition duration in milliseconds for modal open/close animations. */
+    static DEFAULT_TRANSITION_DURATION: number;
+    /** @inheritdoc */
+    protected get defaultTransitionDuration(): number;
+    /** @inheritdoc */
+    protected get wrapperComponent(): any;
+    /** Closes all open Modal instances. */
+    static closeAll(): Promise<void>;
+}
+/**
+ * Factory function to create a new Modal instance.
+ * @param idOrConfig - Modal ID or configuration object
+ * @returns New Modal instance
+ */
+export declare function modal<Params = {}, Result = {}, Metadata = {}>(idOrConfig?: PortalConstructorParam<Params, Metadata>): Modal<Params, Result, Metadata>;
+//# sourceMappingURL=modal.d.ts.map

package/dist/factors/modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../../src/factors/modal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAErE;;;;;;;GAOG;AACH,qBAAa,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,CAAE,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,CAAC;IAC/H,WAAW,SAAU;IAErB,wFAAwF;IACxF,MAAM,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,iBAAiB,EAAE,QAAQ,CAAC,KAAK,YAAY,GAAG,IAAI,CAAa;IAErH,mFAAmF;IACnF,MAAM,CAAC,2BAA2B,SAAM;IAExC,kBAAkB;IAClB,SAAS,KAAK,yBAAyB,WAEtC;IAED,kBAAkB;IAClB,SAAS,KAAK,gBAAgB,IAAI,GAAG,CAEpC;IAED,uCAAuC;WAC1B,QAAQ;CAItB;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,UAAU,CAAC,EAAE,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,mCAEnH"}

package/dist/globals.d.ts

@@ -0,0 +1,19 @@
+/** Props for the bottom sheet wrapper component. Extend this interface in the consuming app. */
+export interface BottomSheetWrapperProps {
+}
+/** Ref type for the bottom sheet component. Extend this interface to expose imperative methods. */
+export interface BottomSheetRef {
+}
+/** Props for the modal wrapper component. Extend this interface in the consuming app. */
+export interface ModalWrapperProps {
+}
+/** Ref type for the modal component. Extend this interface to expose imperative methods. */
+export interface ModalRef {
+}
+/** Props for the drawer wrapper component. Extend this interface in the consuming app. */
+export interface DrawerWrapperProps {
+}
+/** Ref type for the drawer component. Extend this interface to expose imperative methods. */
+export interface DrawerRef {
+}
+//# sourceMappingURL=globals.d.ts.map

package/dist/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,MAAM,WAAW,uBAAuB;CAAG;AAE3C,mGAAmG;AACnG,MAAM,WAAW,cAAc;CAAG;AAElC,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;CAAG;AAErC,4FAA4F;AAC5F,MAAM,WAAW,QAAQ;CAAG;AAE5B,0FAA0F;AAC1F,MAAM,WAAW,kBAAkB;CAAG;AAEtC,6FAA6F;AAC7F,MAAM,WAAW,SAAS;CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './lib/Portal';
+export * from './lib/PortalRegistry';
+export * from './lib/PortalState';
+export * from './lib/PortalRequest';
+export * from './types/misc';
+export * from './types/portal';
+export * from './utils';
+export * from './factors/alert';
+export * from './factors/modal';
+export * from './factors/bottomSheet';
+export * from './factors/drawer';
+export * from './globals';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AAEvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA"}

package/dist/lib/Portal.d.ts

@@ -0,0 +1,121 @@
+import React, { JSX } from 'react';
+import { atom } from 'nanostores';
+import { AnyRecord } from '@codeleap/types';
+import { PortalConfig, PortalConstructorParam, RenderPortalContent } from '../types';
+import { PortalRegistry } from './PortalRegistry';
+import { PortalState } from './PortalState';
+import { PortalRequest } from './PortalRequest';
+type IAtom<T> = ReturnType<typeof atom<T>>;
+/**
+ * Nanostores atom holding the IDs of all currently registered portals in creation order.
+ * Drives `GlobalOutlet` re-renders when portals are added or removed (including ephemeral ones).
+ * Read-only outside of portal lifecycle code — mutate only via `Portal` constructor/`onVisibilityChanged`.
+ */
+export declare const registeredIds: import("nanostores").PreinitializedWritableAtom<string[]> & object;
+/**
+ * Base class for creating portals (modal, drawer, bottom sheet, etc).
+ * Manages state, visibility, params and lifecycle of floating components.
+ *
+ * @template Params - Custom portal parameters
+ * @template Result - Type of result returned by request
+ * @template Metadata - Additional configuration metadata
+ * @template RefType - Type of wrapper component ref
+ * @template WrapperProps - Props for wrapper component
+ */
+export declare class Portal<Params = {}, Result = {}, Metadata = {}, RefType = any, WrapperProps = AnyRecord> extends PortalState<Params> {
+    displayName: string;
+    id: string;
+    RenderContent: RenderPortalContent<Params, Result, RefType>;
+    ref?: React.RefObject<RefType | null>;
+    requestHandler: PortalRequest<Params, Result>;
+    _config: PortalConfig<Params, Metadata>;
+    _wrapperProps: IAtom<WrapperProps>;
+    _lazyWrapperProps: (params: Params) => WrapperProps;
+    static registry: PortalRegistry<Portal<any, any, any, any, AnyRecord>>;
+    static generateId: () => string;
+    protected getDefaultConfig(): Partial<PortalConfig<Params, Metadata>>;
+    protected get registry(): PortalRegistry<any>;
+    protected get idGenerator(): () => string;
+    protected get defaultTransitionDuration(): number | null;
+    protected get wrapperComponent(): any;
+    /**
+     * Sets the render function for portal content.
+     * @param render - Function that renders the portal content
+     * @returns The portal instance for chaining
+     */
+    content(render: RenderPortalContent<Params, Result, RefType>): this;
+    /** Gets the resolve handler for the pending request. */
+    get resolve(): ((result: Result | undefined) => void) | undefined;
+    /** Gets the reject handler for the pending request. */
+    get reject(): ((reason: unknown) => void) | undefined;
+    private onVisibilityChanged;
+    /** Gets the z-index position of the portal in the registry stack. */
+    get stackIndex(): number;
+    /**
+     * Creates a new portal instance.
+     * @param idOrConfig - Portal ID string or configuration object with optional id field
+     */
+    constructor(idOrConfig?: PortalConstructorParam<Params, Metadata>);
+    /**
+     * Registers a callback to be called when portal closes.
+     * @param callback - Function to execute on close
+     * @returns The portal instance for chaining
+     */
+    onClose(callback: (portal: Portal<Params, Result, Metadata, RefType, WrapperProps>) => void): this;
+    /**
+     * Registers a callback to be called when portal opens.
+     * @param callback - Function to execute on open
+     * @returns The portal instance for chaining
+     */
+    onOpen(callback: (portal: Portal<Params, Result, Metadata, RefType, WrapperProps>) => void): this;
+    /**
+     * Sets wrapper component props. Can be static or a function based on params.
+     * @param props - Props object or function that returns props
+     * @returns The portal instance for chaining
+     */
+    props(props: WrapperProps | ((params: Params) => WrapperProps)): this;
+    /**
+     * React hook to update wrapper props with dependency tracking.
+     * @param props - Props to merge with existing wrapper props
+     * @param deps - Dependency array for effect
+     */
+    useProps(props: WrapperProps, deps?: React.DependencyList): void;
+    /**
+     * React hook to access portal state (visibility and params).
+     * @returns Object with visible and params state
+     */
+    useState(): {
+        visible: boolean;
+        params: Params;
+    };
+    /** Whether there is a pending request awaiting resolution. */
+    get hasPendingRequest(): boolean;
+    /**
+     * Renders the portal component. Use this as a React component.
+     * @param props - Combined params and wrapper props
+     * @returns JSX element with portal content wrapped in wrapper component
+     */
+    Component(props?: Params & {
+        portalProps?: WrapperProps;
+    }): JSX.Element | null;
+    /**
+     * Creates a request promise that resolves when portal is closed with result.
+     * @param params - Parameters to pass to the portal
+     * @param force - Force new request even if one is pending
+     * @returns Promise that resolves with portal result
+     */
+    request(params?: Params, force?: boolean): Promise<Result | undefined>;
+    /**
+     * Resets all registered portals to their closed initial state.
+     * Useful in test afterEach hooks to prevent state leaking between tests.
+     */
+    static resetAll(): void;
+    /**
+     * Global outlet component that renders all non-independent portals.
+     * Place this once in your app root.
+     * @returns JSX element rendering all registered portals
+     */
+    static GlobalOutlet(): JSX.Element;
+}
+export {};
+//# sourceMappingURL=Portal.d.ts.map

package/dist/lib/Portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Portal.d.ts","sourceRoot":"","sources":["../../src/lib/Portal.tsx"],"names":[],"mappings":"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"}

package/dist/lib/PortalRegistry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Registry for managing portal instances and their stacking order.
+ * Maintains a registry of portals by ID and tracks their z-index stack.
+ *
+ * @template T - Type of portal instances to manage
+ */
+export declare class PortalRegistry<T> {
+    private registry;
+    private stack;
+    /**
+     * Registers a portal instance with an ID.
+     * @param id - Unique identifier for the portal
+     * @param instance - Portal instance to register
+     */
+    register(id: string, instance: T): void;
+    /**
+     * Unregisters a portal and removes it from the stack.
+     * @param id - Portal ID to unregister
+     */
+    unregister(id: string): void;
+    /**
+     * Retrieves a portal instance by ID.
+     * @param id - Portal ID to retrieve
+     * @returns Portal instance or undefined
+     */
+    getInstance(id: string): T;
+    /**
+     * Adds a portal ID to the top of the stack.
+     * @param id - Portal ID to push
+     */
+    push(id: string): void;
+    /**
+     * Removes a portal ID from the stack and all portals above it.
+     * @param id - Portal ID to remove
+     */
+    remove(id: string): void;
+    /**
+     * Gets the stack index (z-index position) of a portal.
+     * @param id - Portal ID to find
+     * @returns Stack index or -1 if not found
+     */
+    getStackIndex(id: string): number;
+    /**
+     * Retrieves all registered portal instances.
+     * @returns Array of all portal instances
+     */
+    getAll(): T[];
+    /**
+     * Filters portal instances by predicate function.
+     * @param predicate - Function to test each instance
+     * @returns Filtered array of portal instances
+     */
+    filter(predicate: (instance: T) => boolean): T[];
+    /**
+     * Clears all portals from registry and stack.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=PortalRegistry.d.ts.map

package/dist/lib/PortalRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortalRegistry.d.ts","sourceRoot":"","sources":["../../src/lib/PortalRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,cAAc,CAAC,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAwB;IAExC,OAAO,CAAC,KAAK,CAAe;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAIhC;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM;IAKrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC;IAI1B;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM;IAIf;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM;IAOjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAIjC;;;OAGG;IACH,MAAM,IAAI,CAAC,EAAE;IAIb;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,EAAE;IAIhD;;OAEG;IACH,KAAK;CAIN"}

package/dist/lib/PortalRequest.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Handles promise-based portal requests with resolve/reject semantics.
+ * Manages the async flow of opening a portal and waiting for a result.
+ *
+ * @template Params - Parameters for opening the portal
+ * @template Result - Type of result returned when request resolves
+ */
+export declare class PortalRequest<Params = {}, Result = {}> {
+    resolve?: (result: Result | undefined) => void;
+    reject?: (reason: unknown) => void;
+    private onOpen;
+    private onClose;
+    /**
+     * Creates a portal request handler.
+     * @param onOpen - Function to call when opening portal
+     * @param onClose - Function to call when closing portal
+     */
+    constructor(onOpen: (params?: Params) => Promise<void>, onClose: () => Promise<void>);
+    /**
+     * Checks if there's a pending request waiting for resolution.
+     * @returns True if request is pending
+     */
+    get hasPendingRequest(): boolean;
+    /**
+     * Creates a new request promise that opens the portal and waits for result.
+     * @param params - Parameters to pass when opening portal
+     * @param force - Force new request even if one is pending
+     * @returns Promise that resolves with portal result
+     */
+    request(params?: Params, force?: boolean): Promise<Result | undefined>;
+    /**
+     * Clears the current request resolve/reject handlers.
+     */
+    clearRequest(): void;
+    /**
+     * Gets the current request handlers for resolve and reject.
+     * @returns Object with resolve and reject functions
+     */
+    getRequestHandlers(): {
+        resolve: ((result: Result | undefined) => void) | undefined;
+        reject: ((reason: unknown) => void) | undefined;
+    };
+}
+//# sourceMappingURL=PortalRequest.d.ts.map

package/dist/lib/PortalRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortalRequest.d.ts","sourceRoot":"","sources":["../../src/lib/PortalRequest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,aAAa,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE;IACjD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IAE9C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IAElC,OAAO,CAAC,MAAM,CAAoC;IAElD,OAAO,CAAC,OAAO,CAAqB;IAEpC;;;;OAIG;gBAED,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAC1C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAM9B;;;OAGG;IACH,IAAI,iBAAiB,YAEpB;IAED;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,MAAM,GAAC,SAAS,CAAC;IAyBlE;;OAEG;IACH,YAAY;IAKZ;;;OAGG;IACH,kBAAkB;2BAxEC,MAAM,GAAG,SAAS,KAAK,IAAI;0BAE5B,OAAO,KAAK,IAAI;;CA4EnC"}

package/dist/lib/PortalState.d.ts

@@ -0,0 +1,83 @@
+import { atom } from 'nanostores';
+type IAtom<T> = ReturnType<typeof atom<T>>;
+/** Configuration for initializing portal state: initial params, visibility, reset behavior, and transition timing. */
+export type PortalStateConfig<Params> = {
+    initialParams?: Params | (() => Promise<Params>);
+    startsOpen?: boolean | (() => Promise<boolean>);
+    resetParamsOnClose?: boolean;
+    transitionDuration?: number;
+};
+/**
+ * Manages portal visibility and parameter state with nanostores.
+ * Handles opening, closing, toggling and parameter updates.
+ *
+ * @template Params - Type of parameters managed by the state
+ */
+export declare class PortalState<Params = {}> {
+    /** Nanostores atom managing portal visibility state. */
+    visible: IAtom<boolean>;
+    /** Nanostores atom managing portal parameters. */
+    params: IAtom<Params>;
+    /** Initial parameter values used when resetting. */
+    _initialParams: Params;
+    private config;
+    /**
+     * Asserts the portal state has been initialized and returns the initialized stores.
+     * @throws Error if `initializeState()` has not been called yet
+     */
+    assertInitialized(): {
+        visible: import("nanostores").PreinitializedWritableAtom<boolean> & object;
+        params: import("nanostores").PreinitializedWritableAtom<Params> & object;
+        config: PortalStateConfig<Params>;
+        initialParams: Params & ({} | null);
+    };
+    /**
+     * Initializes the portal state with configuration.
+     * @param config - Configuration for initial state, visibility and params
+     */
+    initializeState(config: PortalStateConfig<Params>): void;
+    /** Gets the current visibility state. */
+    get isVisible(): boolean;
+    /** Gets the current parameter values. */
+    get currentParams(): Params;
+    private awaitTransition;
+    /** Lifecycle hook called after the portal opens. Override in subclasses to run custom logic. */
+    protected handleOpen(): void;
+    /**
+     * Opens the portal with optional parameters.
+     * @param params - Parameters to merge with current params
+     */
+    open(params?: Params): Promise<void>;
+    /** Lifecycle hook called after the portal closes. Override in subclasses to run custom logic. */
+    protected handleClose(): void;
+    /**
+     * Closes the portal and optionally resets parameters.
+     */
+    close(): Promise<void>;
+    /**
+     * Toggles portal visibility (opens if closed, closes if open).
+     */
+    toggle(): Promise<void>;
+    /**
+     * Updates portal parameters by merging with current params.
+     * @param next - Partial params or updater function
+     */
+    setParams(next: Partial<Params> | ((prev: Params) => Partial<Params>)): void;
+    /**
+     * Resets parameters to initial values.
+     */
+    resetParams(): void;
+    /**
+     * Gets current parameter values.
+     * @returns Current params object
+     */
+    getParams(): Params;
+    /**
+     * Subscribes to visibility changes.
+     * @param callback - Function called when visibility changes
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: (visible: boolean, wasVisible?: boolean) => void): () => void;
+}
+export {};
+//# sourceMappingURL=PortalState.d.ts.map

package/dist/lib/PortalState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortalState.d.ts","sourceRoot":"","sources":["../../src/lib/PortalState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAiB,MAAM,YAAY,CAAA;AAIhD,KAAK,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AAU1C,sHAAsH;AACtH,MAAM,MAAM,iBAAiB,CAAC,MAAM,IAAI;IACtC,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAChD,UAAU,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED;;;;;GAKG;AACH,qBAAa,WAAW,CAAC,MAAM,GAAG,EAAE;IAClC,wDAAwD;IACxD,OAAO,EAAG,KAAK,CAAC,OAAO,CAAC,CAAA;IAExB,kDAAkD;IAClD,MAAM,EAAG,KAAK,CAAC,MAAM,CAAC,CAAA;IAEtB,oDAAoD;IACpD,cAAc,EAAG,MAAM,CAAA;IAEvB,OAAO,CAAC,MAAM,CAA4B;IAE1C;;;OAGG;IACH,iBAAiB;;;;;;IAYjB;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;IAyBjD,yCAAyC;IACzC,IAAI,SAAS,YAGZ;IAED,yCAAyC;IACzC,IAAI,aAAa,WAGhB;IAED,OAAO,CAAC,eAAe;IAKvB,gGAAgG;IAChG,SAAS,CAAC,UAAU;IAEpB;;;OAGG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM;IAqB1B,iGAAiG;IACjG,SAAS,CAAC,WAAW;IAErB;;OAEG;IACG,KAAK;IAoBX;;OAEG;IACH,MAAM;IAUN;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAYrE;;OAEG;IACH,WAAW;IAKX;;;OAGG;IACH,SAAS;IAKT;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,KAAK,IAAI;CAIrE"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './portal';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA"}

package/dist/types/misc.d.ts

@@ -0,0 +1,7 @@
+import { AnyFunction } from '@codeleap/types';
+/** Extracts all but the first element of a tuple type. */
+type AllButFirst<T extends any[]> = T extends [infer _, ...infer Rest] ? Rest : [];
+/** Produces a version of function `T` whose first parameter excludes type `E`. */
+export type ExcludeFromParam<T extends AnyFunction, E = any> = (p?: Exclude<Parameters<T>[0], E>, ...args: AllButFirst<Parameters<T>>) => ReturnType<T>;
+export {};
+//# sourceMappingURL=misc.d.ts.map

package/dist/types/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/types/misc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,0DAA0D;AAC1D,KAAK,WAAW,CAAC,CAAC,SAAS,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,EAAE,CAAA;AAElF,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,CAC1B,CAAC,SAAS,WAAW,EACrB,CAAC,GAAG,GAAG,IACL,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAA"}

package/dist/types/portal.d.ts

@@ -0,0 +1,40 @@
+import { Ref } from 'react';
+/** Props injected into portal content: visibility flag, lifecycle methods, and the portal's current params. */
+export type PortalParams<P = {}, Result = {}> = {
+    visible: boolean;
+    toggle: () => void | Promise<void>;
+    close: () => void | Promise<void>;
+    open: (params?: P) => void | Promise<void>;
+    setParams: (next: Partial<P> | ((prev: P) => Partial<P>)) => void;
+    request?: {
+        resolve?: (result: Result) => void;
+        reject?: (reason: unknown) => void;
+    };
+} & P;
+/** Function that renders portal content, receiving params and an optional ref. */
+export type RenderPortalContent<Params = {}, Result = {}, RefType = any> = (props: PortalParams<Params, Result>, ref?: React.RefObject<RefType>) => React.ReactElement;
+/** Configuration options for portal initialization and runtime behavior. */
+export type PortalConfig<P, M = {}> = {
+    initialParams?: P | (() => Promise<P>);
+    startsOpen?: boolean | (() => Promise<boolean>);
+    independent?: boolean;
+    rendersWhenHidden?: boolean;
+    metadata?: M;
+    transitionDuration?: number;
+    resetParamsOnClose?: boolean;
+    ephemeral?: boolean;
+};
+/** Constructor parameter — either a portal ID string or a config object with an optional `id` field. */
+export type PortalConstructorParam<Params = {}, Metadata = {}> = (Partial<PortalConfig<Params, Metadata>> & {
+    id?: string;
+}) | string;
+/** Props passed to the wrapper component (modal/drawer/sheet) including lifecycle handlers and z-index. */
+export type PortalWrapperProps<P, R> = P & {
+    close: () => void;
+    open: () => void;
+    toggle: () => void;
+    zIndex: number;
+    visible: boolean;
+    ref: Ref<R>;
+};
+//# sourceMappingURL=portal.d.ts.map

package/dist/types/portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/types/portal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAE3B,+GAA+G;AAC/G,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI;IAC9C,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1C,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACjE,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;QAClC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;KACnC,CAAA;CACF,GAAG,CAAC,CAAA;AAEL,kFAAkF;AAClF,MAAM,MAAM,mBAAmB,CAAC,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,OAAO,GAAG,GAAG,IAAI,CACzE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,KAC3B,KAAK,CAAC,YAAY,CAAA;AAEvB,4EAA4E;AAC5E,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI;IACpC,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IACtC,UAAU,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,CAAC,CAAA;IACZ,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,wGAAwG;AACxG,MAAM,MAAM,sBAAsB,CAAC,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAAA;AAErI,2GAA2G;AAC3G,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACzC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;CACZ,CAAA"}