@v-miniapp/router 1.0.5

package/dist/stores/router.d.ts

@@ -0,0 +1,51 @@
+import { IHistory, INavigate } from '../types/navigation';
+import { IRouterConfig, IRouterAppState, IRouterPageState } from '../types/router';
+import { EventEmitter } from '../utils/event-emitter';
+export type IRouterStoreState = {
+    config: IRouterConfig;
+    initialized: boolean;
+    appState: IRouterAppState;
+    pageStates: Partial<Record<string, IRouterPageState>>;
+    histories: IHistory[];
+    init: (config: IRouterConfig) => void;
+    navigate: INavigate;
+};
+type IBeforeHistoryChangeData = {
+    history: IHistory;
+    histories: IHistory[];
+    nextHistory: IHistory;
+    nextHistories: IHistory[];
+};
+type IAfterHistoryChangeData = {
+    history: IHistory;
+    histories: IHistory[];
+    prevHistory: IHistory;
+    prevHistories: IHistory[];
+};
+type IAfterInitData = {
+    history: IHistory;
+    histories: IHistory[];
+};
+type INavigateData = {
+    to: string;
+    options?: {
+        replace?: boolean;
+        params?: Record<string, string>;
+        state?: any;
+    };
+} | {
+    to: number;
+};
+type IBeforeNavigateData = IBeforeHistoryChangeData & INavigateData;
+type IAfterNavigateData = IAfterHistoryChangeData & INavigateData;
+export declare const routerEvents: EventEmitter<{
+    beforeHistoryChange: IBeforeHistoryChangeData;
+    beforeHistoryChangeP2: IBeforeHistoryChangeData;
+    afterHistoryChange: IAfterHistoryChangeData;
+    afterHistoryChangeP2: IAfterHistoryChangeData;
+    afterInit: IAfterInitData;
+    beforeNavigate: IBeforeNavigateData;
+    afterNavigate: IAfterNavigateData;
+}>;
+export declare const useRouterStore: import('zustand').UseBoundStore<import('zustand').StoreApi<IRouterStoreState>>;
+export {};

package/dist/stores/router.selector.d.ts

@@ -0,0 +1,11 @@
+import { IRouterStoreState } from './router';
+export declare const historiesSelector: (state: IRouterStoreState) => import('..').IHistory[];
+export declare const lastHistorySelector: (state: IRouterStoreState) => import('..').IHistory;
+export declare const historySelector: (locationKey: string | null) => (state: IRouterStoreState) => import('..').IHistory | undefined;
+export declare const lastLocationSelector: (state: IRouterStoreState) => import('..').ILocation;
+export declare const pageStatesSelector: (state: IRouterStoreState) => Partial<Record<string, import('..').IRouterPageState>>;
+export declare const pageStateSelector: (locationKey: string | null) => (state: IRouterStoreState) => import('..').IRouterPageState | undefined;
+export declare const lastPageStateSelector: (state: IRouterStoreState) => import('..').IRouterPageState | undefined;
+export declare const pageConfigsSelector: (state: IRouterStoreState) => import('..').IRouterPageConfig[];
+export declare const pageConfigSelector: (locationKey: string | null) => (state: IRouterStoreState) => import('..').IRouterPageConfig | undefined;
+export declare const lastPageConfigSelector: (state: IRouterStoreState) => import('..').IRouterPageConfig | undefined;

package/dist/styles.css

@@ -0,0 +1 @@
+:root{--vt-duration: 0s;--vt-timing: ease-in-out;--vt-new-name: vt-slide-in-forward;--vt-old-name: vt-slide-out-forward;--vt-new-index: 1;--vt-old-index: 0}.vsf-page-container{position:relative;left:0;top:0;right:0;min-height:100%;z-index:999;display:flex;flex-direction:column}.vsf-page-detail{min-height:100%;background-color:var(--color-background-app, #f5f5f5);transform:translateY(0)}.vsf-app .vsf-page-container{bottom:0}.vsf-app .vsf-page-detail{position:absolute!important;inset:0;z-index:0}.vsf-app .view-transition-new{z-index:var(--vt-new-index)}.vsf-app .view-transition-old{z-index:var(--vt-old-index)}.view-transition-new{animation:var(--vt-new-name) var(--vt-duration) var(--vt-timing) forwards;z-index:var(--vt-new-index)}::view-transition-new(root){animation:var(--vt-new-name) var(--vt-duration) var(--vt-timing) forwards;z-index:var(--vt-new-index)}.view-transition-old{animation:var(--vt-old-name) var(--vt-duration) var(--vt-timing) forwards;z-index:var(--vt-old-index)}::view-transition-old(root){animation:var(--vt-old-name) var(--vt-duration) var(--vt-timing) forwards;z-index:var(--vt-old-index)}@keyframes vt-slide_left-in-forward{0%{transform:translate(100%)}to{transform:translate(0)}}@keyframes vt-slide_left-out-forward{to{transform:translate(-20%)}}@keyframes vt-slide_left-in-back{0%{transform:translate(-20%)}to{transform:translate(0)}}@keyframes vt-slide_left-out-back{to{transform:translate(100%)}}@keyframes vt-slide_up-in-forward{0%{transform:translateY(100%)}to{transform:translate(0)}}@keyframes vt-slide_up-out-forward{0%{transform:translate(0)}to{transform:translate(0)}}@keyframes vt-slide_up-in-back{0%{transform:translate(0)}to{transform:translate(0)}}@keyframes vt-slide_up-out-back{0%{transform:translate(0)}to{transform:translateY(100%)}}@keyframes vt-fade_in-in-forward{0%{opacity:0}to{opacity:1}}@keyframes vt-fade_in-out-forward{0%{opacity:1}to{opacity:0}}@keyframes vt-fade_in-in-back{0%{opacity:0}to{opacity:1}}@keyframes vt-fade_in-out-back{0%{opacity:1}to{opacity:0}}

package/dist/styles.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './router';
+export * from './navigation';

package/dist/types/navigation.d.ts

@@ -0,0 +1,29 @@
+import { IAnimationState, IRouterPageState } from './router';
+export type INavigatePathnameOptions = {
+    replace?: boolean;
+    params?: Record<string, string>;
+    state?: any;
+} & IRouterPageState;
+export type INavigateDeltaOptions = {
+    animation?: IAnimationState;
+};
+export type INavigate = {
+    (to: string, options?: INavigatePathnameOptions): void;
+    (to: number, options?: INavigateDeltaOptions): void;
+};
+export type IHistoryAction = 'POP' | 'REPLACE' | 'PUSH';
+export type ILocation = {
+    key: string;
+    pathname: string;
+    params?: Record<string, string>;
+    state?: any;
+};
+export type IHistoryState = {
+    locations: ILocation[];
+    idx: number;
+    type: 'vsf-router';
+};
+export type IHistory = {
+    action: IHistoryAction;
+    location: ILocation;
+};

package/dist/types/router.d.ts

@@ -0,0 +1,46 @@
+import { ComponentType, PropsWithChildren } from 'react';
+export type INavigationAnimationType = 'none' | 'slide_up' | 'slide_left' | 'fade_in';
+export type INavigationAnimationMode = 'view-transition' | 'style-transition';
+export type IAnimationState = {
+    type?: INavigationAnimationType;
+};
+export type IAnimationConfig = {
+    type?: INavigationAnimationType;
+    mode?: INavigationAnimationMode;
+};
+export type IKeepAliveState = {
+    enable?: boolean;
+    maxStack?: number;
+    freeze?: boolean;
+    freezeDelay?: number;
+};
+export type ILayout = ComponentType<PropsWithChildren>;
+export type IRouterAppState = {
+    animation?: IAnimationState;
+    keepAlive?: IKeepAliveState;
+    Layouts?: ILayout[];
+};
+export type IRouterPageState = {
+    animation?: IAnimationState;
+    keepAlive?: boolean;
+    freeze?: boolean;
+    freezeDelay?: number;
+    Layouts?: ILayout[];
+};
+export type IRouterPageConfig = {
+    title?: string;
+    pathname: string;
+    Component: ComponentType;
+    Layouts?: ILayout[];
+    bottomTabBarId?: string;
+    animation?: IAnimationConfig;
+} & Omit<IRouterPageState, 'animation'>;
+export type IRouterConfig = {
+    pages: IRouterPageConfig[];
+    navigation?: {
+        alwaysRootPage?: boolean;
+    };
+    NotFoundPage?: ComponentType;
+    ErrorPage?: ComponentType;
+    animation?: IAnimationConfig;
+} & Omit<IRouterAppState, 'animation'>;

package/dist/utils/analytic.d.ts

@@ -0,0 +1,14 @@
+export declare const AnalyticEventName: {
+    readonly PAGE_VIEW: "page_view";
+    readonly NAVIGATION: "navigation";
+};
+export type IAnalyticEventName = (typeof AnalyticEventName)[keyof typeof AnalyticEventName];
+type IAnalyticOptions = {
+    event: IAnalyticEventName;
+    params: Record<string, unknown>;
+};
+declare class Analytic {
+    sendEvent(options: IAnalyticOptions): any;
+}
+export declare const analytic: Analytic;
+export {};

package/dist/utils/animation.d.ts

@@ -0,0 +1,4 @@
+import { INavigationAnimationType } from '../types/router';
+import { IHistoryAction } from '../types/navigation';
+export declare const ANIMATION_DURATION = 250;
+export declare const setupAnimation: (animationType: INavigationAnimationType, action: IHistoryAction) => void;

package/dist/utils/classname.d.ts

@@ -0,0 +1,2 @@
+import { default as classnames } from 'classnames';
+export { classnames as classNames };

package/dist/utils/deep-clone.d.ts

@@ -0,0 +1 @@
+export declare const deepCloneWithoutComponent: <T>(value: T) => T;

package/dist/utils/event-emitter.d.ts

@@ -0,0 +1,11 @@
+export type IEventHandler<Data> = (data: Data) => void;
+export declare class EventEmitter<IEventMapping extends Record<string, any>> {
+    private emitCustomEvent?;
+    constructor(options?: {
+        emitCustomEvent?: boolean;
+    });
+    private listeners;
+    on<T extends keyof IEventMapping>(event: T, handler: IEventHandler<IEventMapping[T]>): () => void;
+    off<T extends keyof IEventMapping>(event: T, handler: IEventHandler<IEventMapping[T]>): void;
+    emit<T extends keyof IEventMapping>(event: T, payload: IEventMapping[T]): void;
+}

package/dist/utils/history.d.ts

@@ -0,0 +1,7 @@
+import { IRouterPageConfig, IRouterConfig } from '../types/router';
+import { IHistory, IHistoryState, ILocation } from '../types/navigation';
+export declare const PAGE_PATH_NAME = "__pagePath";
+export declare const initHistories: (config: IRouterConfig) => IHistory[];
+export declare const getPageByPathname: (pages: IRouterPageConfig[], pathname: string) => IRouterPageConfig | undefined;
+export declare const getHistoryState: (histories: IHistory[]) => IHistoryState;
+export declare const getUrlFromLocation: (location: ILocation) => URL;

package/dist/utils/url.d.ts

@@ -0,0 +1 @@
+export declare function objectToSearchString(params?: Record<string, any>): string;

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@v-miniapp/router",
+  "version": "1.0.5",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "style": "./dist/styles.css"
+    },
+    "./*": "./dist/*"
+  },
+  "dependencies": {
+    "@types/lodash": "^4.17.23",
+    "classnames": "^2.5.1",
+    "lodash": "^4.17.23",
+    "nanoid": "^5.1.6",
+    "react-freeze": "^1.0.4",
+    "zustand": "^5.0.9"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}