@sigmela/router 0.3.7 → 0.4.0

package/lib/typescript/src/StackRenderer.d.ts

@@ -1,8 +0,0 @@
-import type { HistoryItem, NavigationAppearance } from './types';
-export interface StackRendererProps {
-    stackId: string;
-    appearance?: NavigationAppearance;
-    history?: HistoryItem[];
-}
-export declare const StackRenderer: import("react").NamedExoticComponent<StackRendererProps>;
-//# sourceMappingURL=StackRenderer.d.ts.map

package/lib/typescript/src/TabBar/RenderTabBar.native.d.ts

@@ -1,8 +0,0 @@
-import type { TabBar } from './TabBar';
-import type { NavigationAppearance } from '../types';
-export interface RenderTabBarProps {
-    tabBar: TabBar;
-    appearance?: NavigationAppearance;
-}
-export declare const RenderTabBar: import("react").NamedExoticComponent<RenderTabBarProps>;
-//# sourceMappingURL=RenderTabBar.native.d.ts.map

package/lib/typescript/src/TabBar/RenderTabBar.web.d.ts

@@ -1,8 +0,0 @@
-import type { NavigationAppearance } from '../types';
-import type { TabBar } from './TabBar';
-export interface RenderTabBarProps {
-    tabBar: TabBar;
-    appearance?: NavigationAppearance;
-}
-export declare const RenderTabBar: import("react").NamedExoticComponent<RenderTabBarProps>;
-//# sourceMappingURL=RenderTabBar.web.d.ts.map

package/lib/typescript/src/TabBar/TabBar.d.ts

@@ -1,112 +0,0 @@
-import type { ImageSourcePropType } from 'react-native';
-import { NavigationStack } from '../NavigationStack';
-import type { ComponentType } from 'react';
-import type { TabItem } from '../types';
-import React from 'react';
-import type { NavigationNode, NodeChild, NodeRoute } from '../navigationNode';
-import type { PlatformIcon, TabAccessoryComponentFactory } from 'react-native-screens';
-type LegacyIOSIconShape = {
-    sfSymbolName: string;
-} | {
-    imageSource: ImageSourcePropType;
-} | {
-    templateSource: ImageSourcePropType;
-};
-type ExtendedIcon = ImageSourcePropType | LegacyIOSIconShape | PlatformIcon;
-export type InternalTabItem = Omit<TabItem, 'icon' | 'selectedIcon'> & {
-    icon?: ExtendedIcon;
-    selectedIcon?: ExtendedIcon;
-    badgeValue?: string;
-    /**
-     * Optional base prefix for this tab's navigation subtree, e.g. '/mail'.
-     * Used by Router registry building via TabBar.getNodeChildren().
-     */
-    tabPrefix?: string;
-};
-export type TabBarProps = {
-    onTabPress: (index: number) => void;
-    tabs: InternalTabItem[];
-    activeIndex: number;
-};
-export type TabBarDescriptor = {
-    renderer?: ComponentType<TabBarProps>;
-};
-type TabBarConfig = Omit<InternalTabItem, 'tabKey' | 'key'> & {
-    /**
-     * Legacy content type: a stack rendered in the tab.
-     */
-    stack?: NavigationStack;
-    /**
-     * New content type: any NavigationNode (e.g. SplitView).
-     */
-    node?: NavigationNode;
-    /**
-     * Screen component rendered in the tab (no routing).
-     */
-    screen?: React.ComponentType<any>;
-    /**
-     * Optional base prefix for node/stack routes, e.g. '/mail'.
-     */
-    prefix?: string;
-    /**
-     * Custom tab bar component (UI). Kept for compatibility.
-     */
-    component?: ComponentType<TabBarProps>;
-    /**
-     * iOS 26+ bottom accessory factory.
-     */
-    bottomAccessory?: TabAccessoryComponentFactory;
-    /**
-     * Experimental: control navigation state in JS.
-     */
-    experimentalControlNavigationStateInJS?: boolean;
-};
-type TabBarOptions = {
-    component?: ComponentType<TabBarProps>;
-    config?: TabBarConfig;
-    initialIndex?: number;
-};
-export declare class TabBar implements NavigationNode {
-    private readonly tabBarId;
-    screens: Record<string, React.ComponentType<any>>;
-    stacks: Record<string, NavigationStack>;
-    nodes: Record<string, NavigationNode>;
-    private listeners;
-    private _cachedRenderer;
-    private state;
-    constructor(options?: TabBarOptions);
-    getId(): string;
-    addTab(tab: Omit<TabBarConfig, 'tabKey'> & {
-        key: string;
-    }): TabBar;
-    setBadge(tabIndex: number, badge: string | null): void;
-    setTabBarConfig(config: Partial<TabBarConfig>): void;
-    onIndexChange(index: number): void;
-    getState: () => {
-        tabs: InternalTabItem[];
-        config: TabBarConfig;
-        index: number;
-    };
-    private setState;
-    private notifyListeners;
-    subscribe(listener: () => void): () => void;
-    getTabs(): InternalTabItem[];
-    getInitialIndex(): number;
-    getActiveChildId(): string | undefined;
-    switchToRoute(routeId: string): void;
-    hasRoute(routeId: string): boolean;
-    setActiveChildByRoute(routeId: string): void;
-    getNodeRoutes(): NodeRoute[];
-    getNodeChildren(): NodeChild[];
-    getRenderer(): React.ComponentType<any>;
-    seed(): {
-        routeId: string;
-        params?: Record<string, unknown>;
-        path: string;
-        stackId?: string;
-    } | null;
-    private findTabIndexByRoute;
-    private nodeHasRoute;
-}
-export {};
-//# sourceMappingURL=TabBar.d.ts.map

package/lib/typescript/src/TabBar/TabBarContext.d.ts

@@ -1,3 +0,0 @@
-import { TabBar } from './TabBar';
-export declare const TabBarContext: import("react").Context<TabBar | null>;
-//# sourceMappingURL=TabBarContext.d.ts.map

package/lib/typescript/src/TabBar/TabIcon.web.d.ts

@@ -1,7 +0,0 @@
-import { type ImageSourcePropType } from 'react-native';
-export interface TabIconProps {
-    source: ImageSourcePropType;
-    tintColor?: string;
-}
-export declare const TabIcon: import("react").MemoExoticComponent<({ source, tintColor }: TabIconProps) => import("react/jsx-runtime").JSX.Element>;
-//# sourceMappingURL=TabIcon.web.d.ts.map

package/lib/typescript/src/TabBar/index.d.ts

@@ -1,5 +0,0 @@
-export { RenderTabBar } from './RenderTabBar';
-export { TabBar } from './TabBar';
-export { useTabBar } from './useTabBar';
-export { useTabBarHeight, TAB_BAR_HEIGHT } from './useTabBarHeight';
-//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/TabBar/useTabBar.d.ts

@@ -1,2 +0,0 @@
-export declare const useTabBar: () => import("./TabBar").TabBar;
-//# sourceMappingURL=useTabBar.d.ts.map

package/lib/typescript/src/TabBar/useTabBarHeight.d.ts

@@ -1,18 +0,0 @@
-/**
- * The height of the TabBar in pixels
- */
-export declare const TAB_BAR_HEIGHT = 57;
-/**
- * Hook that returns the height of the TabBar
- * @returns {number} The height of the TabBar in pixels
- *
- * @example
- * ```tsx
- * const TabBarExample = () => {
- *   const tabBarHeight = useTabBarHeight();
- *   return <div style={{ paddingBottom: tabBarHeight }}>Content</div>;
- * };
- * ```
- */
-export declare const useTabBarHeight: () => number;
-//# sourceMappingURL=useTabBarHeight.d.ts.map

package/lib/typescript/src/createController.d.ts

@@ -1,15 +0,0 @@
-type ControllerPresenter<P = any> = (passProps?: P) => void;
-type ControllerInput<TParams, TQuery> = {
-    params: TParams;
-    query: TQuery;
-};
-export type Controller<TParams = Record<string, unknown>, TQuery = Record<string, unknown>> = (input: ControllerInput<TParams, TQuery>, present: ControllerPresenter) => void;
-export type ComponentWithController = {
-    controller?: Controller<any, any>;
-    component: React.ComponentType<any>;
-    childNode?: import('./navigationNode').NavigationNode;
-};
-export type MixedComponent = ComponentWithController | React.ComponentType<any>;
-export declare function createController<TParams, TQuery = Record<string, unknown>>(controller: Controller<TParams, TQuery>): Controller<TParams, TQuery>;
-export {};
-//# sourceMappingURL=createController.d.ts.map

package/lib/typescript/src/index.d.ts

@@ -1,21 +0,0 @@
-export { useTabBar } from './TabBar/useTabBar';
-export { useTabBarHeight, TAB_BAR_HEIGHT } from './TabBar/useTabBarHeight';
-export { TabBar } from './TabBar/TabBar';
-export type { TabBarProps } from './TabBar/TabBar';
-export { Drawer } from './Drawer/Drawer';
-export type { DrawerProps } from './Drawer/Drawer';
-export { useDrawer } from './Drawer/useDrawer';
-export { SplitView } from './SplitView/SplitView';
-export type { SplitViewOptions } from './SplitView/SplitView';
-export { useSplitView } from './SplitView/useSplitView';
-export type { NavigationAppearance } from './types';
-export type { ScreenOptions, ActiveRoute, StackPresentationTypes, NavigationStackOptions, } from './types';
-export { Router } from './Router';
-export { Navigation } from './Navigation';
-export { createController } from './createController';
-export type { Controller, ComponentWithController } from './createController';
-export { NavigationStack } from './NavigationStack';
-export type { HistoryItem } from './types';
-export { StackRenderer } from './StackRenderer';
-export { useRouter, useCurrentRoute, useParams, useQueryParams, useRoute, } from './RouterContext';
-//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/navigationNode.d.ts

@@ -1,41 +0,0 @@
-import type { ScreenOptions, QueryPattern } from './types';
-import type { Controller } from './createController';
-import type React from 'react';
-export type NodeRoute = {
-    routeId: string;
-    path: string;
-    pathnamePattern: string;
-    isWildcardPath: boolean;
-    queryPattern: QueryPattern | null;
-    baseSpecificity: number;
-    matchPath: (path: string) => false | {
-        params: Record<string, any>;
-    };
-    component: React.ComponentType<any>;
-    controller?: Controller<any, any>;
-    options?: ScreenOptions;
-    childNode?: NavigationNode;
-};
-export type NodeChild = {
-    prefix: string;
-    node: NavigationNode;
-    onMatch?: () => void;
-};
-export interface NavigationNode {
-    getId(): string;
-    getNodeRoutes(): NodeRoute[];
-    getNodeChildren(): NodeChild[];
-    getRenderer(): React.ComponentType<any>;
-    getActiveChildId?: () => string | undefined;
-    switchToRoute?: (routeId: string) => void;
-    hasRoute?: (routeId: string) => boolean;
-    setActiveChildByRoute?: (routeId: string) => void;
-    seed?: () => {
-        routeId: string;
-        params?: Record<string, unknown>;
-        path: string;
-        stackId?: string;
-    } | null;
-    getDefaultOptions?: () => ScreenOptions | undefined;
-}
-//# sourceMappingURL=navigationNode.d.ts.map

package/lib/typescript/src/types.d.ts

@@ -1,140 +0,0 @@
-import type { ColorValue, StyleProp, ViewStyle, TextStyle } from 'react-native';
-import type { TabsScreenProps, ScreenProps as RNSScreenProps, ScreenStackHeaderConfigProps, TabBarItemLabelVisibilityMode, TabBarMinimizeBehavior, TabBarControllerMode, TabAccessoryComponentFactory, TabsScreenBlurEffect } from 'react-native-screens';
-export type StackPresentationTypes = 'push' | 'modal' | 'modalRight' | 'transparentModal' | 'containedModal' | 'containedTransparentModal' | 'fullScreenModal' | 'formSheet' | 'pageSheet' | 'sheet';
-/**
- * Presentations that behave like modals (overlay on top of content).
- */
-export declare const MODAL_LIKE_PRESENTATIONS: ReadonlySet<StackPresentationTypes>;
-/**
- * Check if a presentation type is modal-like (renders as overlay).
- */
-export declare function isModalLikePresentation(presentation: StackPresentationTypes | undefined): boolean;
-export type TabItem = Omit<TabsScreenProps, 'isFocused' | 'children'>;
-export type NavigationState<Route extends TabItem> = {
-    index: number;
-    routes: Route[];
-};
-export type TabBarIcon = {
-    sfSymbolName?: string;
-} | string;
-export type ScreenOptions = Partial<Omit<RNSScreenProps, 'stackPresentation'>> & {
-    header?: ScreenStackHeaderConfigProps;
-    stackPresentation?: StackPresentationTypes;
-    convertModalToSheetForAndroid?: boolean;
-    syncWithUrl?: boolean;
-    tabBarIcon?: TabBarIcon;
-    animated?: boolean;
-    /**
-     * Allows pushing multiple instances of the same screen (same routeId) onto a stack.
-     *
-     * By default, Router.navigate() will behave like "replace" when targeting the currently
-     * active routeId in the same stack (i.e. treat it as "same screen, new data").
-     * Set this to true to force "push" even when navigating to the active routeId.
-     */
-    allowMultipleInstances?: boolean;
-    /**
-     * Allows Router.goBack() to pop the last (root) screen of a stack.
-     * Useful for secondary stacks in split-view / overlays.
-     */
-    allowRootPop?: boolean;
-    /**
-     * Maximum width for modal presentation on web (in pixels).
-     * Only applies to modal-like presentations on web platform.
-     */
-    maxWidth?: number;
-};
-export type NavigationStackOptions = ScreenOptions & {
-    /**
-     * Optional React component to wrap the entire stack renderer.
-     * Useful for providing context (theme, auth, etc.) to all screens in the stack.
-     */
-    provider?: React.ComponentType<{
-        children: React.ReactNode;
-    }>;
-};
-export type HistoryItem = {
-    key: string;
-    routeId: string;
-    component: React.ComponentType<any>;
-    options?: ScreenOptions;
-    params?: Record<string, unknown>;
-    query?: Record<string, unknown>;
-    passProps?: Record<string, unknown>;
-    stackId?: string;
-    pattern?: string;
-    path?: string;
-};
-export type ActiveRoute = {
-    routeId: string;
-    stackId?: string;
-    tabIndex?: number;
-    path?: string;
-    params?: Record<string, unknown>;
-    query?: Record<string, unknown>;
-} | null;
-export type QueryToken = {
-    type: 'const';
-    value: string;
-} | {
-    type: 'param';
-    name: string;
-};
-export type QueryPattern = Record<string, QueryToken>;
-export type CompiledRoute = {
-    routeId: string;
-    path: string;
-    pathnamePattern: string;
-    isWildcardPath: boolean;
-    queryPattern: QueryPattern | null;
-    baseSpecificity: number;
-    matchPath: (path: string) => false | {
-        params: Record<string, any>;
-    };
-    component: React.ComponentType<any>;
-    controller?: import('./createController').Controller<any, any>;
-    options?: ScreenOptions;
-    stackId?: string;
-    childNode?: import('./navigationNode').NavigationNode;
-};
-export type TabBarConfig = {
-    tabBarMinimizeBehavior?: TabBarMinimizeBehavior;
-    bottomAccessory?: TabAccessoryComponentFactory;
-    experimentalControlNavigationStateInJS?: boolean;
-};
-export type SheetAppearance = {
-    androidFullScreenTopInset?: number;
-    backgroundColor?: ColorValue;
-    cornerRadius?: number;
-};
-export interface NavigationAppearance {
-    tabBar?: {
-        backgroundColor?: ColorValue;
-        badgeBackgroundColor?: ColorValue;
-        iconColor?: ColorValue;
-        iconColorActive?: ColorValue;
-        androidActiveIndicatorEnabled?: boolean;
-        androidActiveIndicatorColor?: ColorValue;
-        androidRippleColor?: ColorValue;
-        labelVisibilityMode?: TabBarItemLabelVisibilityMode;
-        iOSShadowColor?: ColorValue;
-        hidden?: boolean;
-        tintColor?: ColorValue;
-        controllerMode?: TabBarControllerMode;
-        minimizeBehavior?: TabBarMinimizeBehavior;
-        nativeContainerBackgroundColor?: ColorValue;
-        iOSBlurEffect?: TabsScreenBlurEffect;
-        title: {
-            fontFamily?: TextStyle['fontFamily'];
-            fontSize?: TextStyle['fontSize'];
-            fontWeight?: TextStyle['fontWeight'];
-            fontStyle?: TextStyle['fontStyle'];
-            color?: TextStyle['color'];
-            activeColor?: TextStyle['color'];
-            activeFontSize?: TextStyle['fontSize'];
-        };
-    };
-    screen?: StyleProp<ViewStyle>;
-    header?: ScreenStackHeaderConfigProps;
-    sheet?: SheetAppearance;
-}
-//# sourceMappingURL=types.d.ts.map