path-router-red 0.4.0

package/dist/PathRouter/types.d.ts

@@ -0,0 +1,91 @@
+import type { ComponentType, LazyExoticComponent, ReactNode, RefAttributes } from "react";
+import type { Location, NavigateOptions } from "react-router-dom";
+export type NestedKeyOf<ObjectType extends object, StopKey extends string> = {
+    [Key in keyof ObjectType & (string | number)]: ObjectType[Key] extends object ? Key extends StopKey ? never : `${Key}` | `${Key}/${NestedKeyOf<ObjectType[Key], StopKey>}` : `${Key}`;
+}[keyof ObjectType & (string | number)];
+export type PageData = {
+    component?: ComponentType<any> | LazyExoticComponent<ComponentType<any>>;
+    redirect?: string;
+} & Record<string, any>;
+export interface ModalProps {
+    onClose: () => void;
+}
+export interface ModalData {
+    component?: ComponentType<ModalProps> | LazyExoticComponent<ComponentType<ModalProps>>;
+}
+export interface PageContent {
+    data?: PageData;
+}
+export interface BreadCrumbsPage {
+    [path: string]: ExtendedPage;
+}
+export type ExtendedPage = BreadCrumbsPage | PageContent;
+export interface PagesRoute {
+    [path: string]: ExtendedPage;
+}
+export type ModalRoutes = Record<string, ModalData>;
+export interface RouterConfig<P extends PagesRoute = PagesRoute, M extends ModalRoutes = ModalRoutes> {
+    pages: P;
+    modals?: M;
+}
+/** Extract typed page paths from a user config. */
+export type PathNamesOf<C extends RouterConfig<any, any>> = C extends RouterConfig<infer P, any> ? NestedKeyOf<P, "data"> : string;
+/** Extract typed modal names from a user config. */
+export type ModalNamesOf<C extends RouterConfig<any, any>> = C extends RouterConfig<any, infer M> ? Extract<keyof M, string> : string;
+export type SearchParams = Record<string, string[]>;
+export interface SearchParamsState {
+    [key: string]: string | string[];
+}
+export interface ModalState {
+    path: string;
+    name?: string;
+    breadCrumbs: string[];
+    isOpen: boolean;
+}
+export interface PathContextType<C extends RouterConfig<any, any> = RouterConfig<any, any>> {
+    page: {
+        path: string;
+        navigate: (path: PathNamesOf<C>, options?: NavigateOptions) => void;
+        isHavePrevHistory: boolean;
+    };
+    modal: {
+        open: (name: ModalNamesOf<C>, breadCrumbs?: string[]) => void;
+        close: () => void;
+        /** Full modal path including modal name, e.g. "test/sub" */
+        path: string;
+        name?: string;
+        /** Sub-crumbs without modal name */
+        breadCrumbs: string[];
+        isOpen: boolean;
+    };
+    searchParams: {
+        params: SearchParams;
+        /** Merge: string -> set; array -> append */
+        change: (searchParams: SearchParamsState) => void;
+        /** Replace fully: each key is set to provided value(s) */
+        set: (searchParams: SearchParamsState) => void;
+        delete: (key: string) => void;
+        clear: () => void;
+    };
+    defaultLocation: Location;
+}
+export interface ModalWrapperRef {
+    handleCloseWithAnimation: () => void;
+}
+export interface ModalWrapperProps {
+    modalName?: string;
+    isOpen: boolean;
+    onClose: () => void;
+    children?: ReactNode;
+}
+/**
+ * Wrapper plugin component.
+ *
+ * Accepts both a `forwardRef`-wrapped component (the container will call
+ * `ref.current.handleCloseWithAnimation()` when available) and a plain
+ * function component that simply ignores the ref. `RefAttributes` keeps
+ * `ref` as an optional prop, so any `ComponentType<ModalWrapperProps>`
+ * structurally satisfies this signature in React 19.
+ */
+export type ModalWrapperComponent = ComponentType<ModalWrapperProps & RefAttributes<ModalWrapperRef>>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/PathRouter/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/PathRouter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/PathRouter/types.ts"],"names":[],"mappings":""}

package/dist/PathRouter/utils/clearSlash.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Normalize path:
+ *  - collapse internal "//" sequences to a single "/"
+ *  - guarantee a single leading "/"
+ *  - strip trailing "/" (root "/" stays as "/")
+ */
+export declare const clearSlash: (path: string) => string;
+//# sourceMappingURL=clearSlash.d.ts.map

package/dist/PathRouter/utils/clearSlash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearSlash.d.ts","sourceRoot":"","sources":["../../../src/PathRouter/utils/clearSlash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,MASzC,CAAC"}

package/dist/PathRouter/utils/clearSlash.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearSlash = void 0;
+/**
+ * Normalize path:
+ *  - collapse internal "//" sequences to a single "/"
+ *  - guarantee a single leading "/"
+ *  - strip trailing "/" (root "/" stays as "/")
+ */
+const clearSlash = (path) => {
+    if (!path)
+        return "/";
+    let p = path.replace(/\/{2,}/g, "/");
+    if (!p.startsWith("/"))
+        p = "/" + p;
+    if (p.length > 1 && p.endsWith("/"))
+        p = p.replace(/\/+$/, "");
+    return p;
+};
+exports.clearSlash = clearSlash;
+//# sourceMappingURL=clearSlash.js.map

package/dist/PathRouter/utils/clearSlash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearSlash.js","sourceRoot":"","sources":["../../../src/PathRouter/utils/clearSlash.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;IACjD,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IAEtB,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAErC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE/D,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AATW,QAAA,UAAU,cASrB"}

package/dist/PathRouter/utils/createRoute.d.ts

@@ -0,0 +1,16 @@
+import { type PageData, type RouterConfig } from "../types";
+/**
+ * Flatten a nested page config into a list of `{ pathName, data }`,
+ * and produce a flat list for modals as well.
+ */
+export declare const createRoute: (config: RouterConfig<any, any>) => {
+    pages: {
+        pathName: string;
+        data: PageData;
+    }[];
+    modals: {
+        pathName: string;
+        data: import("../types").ModalData;
+    }[];
+};
+//# sourceMappingURL=createRoute.d.ts.map

package/dist/PathRouter/utils/createRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRoute.d.ts","sourceRoot":"","sources":["../../../src/PathRouter/utils/createRoute.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,QAAQ,EAEb,KAAK,YAAY,EACjB,MAAM,UAAU,CAAC;AAKlB;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC;;kBACzB,MAAM;cAAQ,QAAQ;;;;;;CAoCtD,CAAC"}

package/dist/PathRouter/utils/createRoute.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRoute = void 0;
+const objectIsEmpty = (obj) => Object.keys(obj).length === 0;
+/**
+ * Flatten a nested page config into a list of `{ pathName, data }`,
+ * and produce a flat list for modals as well.
+ */
+const createRoute = (config) => {
+    const pagesRoutes = [];
+    const walk = (route, currentPath) => {
+        Object.entries(route).forEach(([pathName, content]) => {
+            if (content?.data) {
+                pagesRoutes.push({
+                    pathName: currentPath + pathName,
+                    data: { ...content.data },
+                });
+            }
+            if (content &&
+                !objectIsEmpty(content) &&
+                !content.component &&
+                !content.redirect) {
+                const newPath = currentPath + pathName;
+                walk(content, newPath + (newPath[newPath.length - 1] !== "/" ? "/" : ""));
+            }
+        });
+    };
+    walk(config.pages, "");
+    const modalsList = Object.entries((config.modals || {})).map(([pathName, data]) => ({ pathName, data }));
+    return {
+        pages: pagesRoutes,
+        modals: modalsList,
+    };
+};
+exports.createRoute = createRoute;
+//# sourceMappingURL=createRoute.js.map

package/dist/PathRouter/utils/createRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRoute.js","sourceRoot":"","sources":["../../../src/PathRouter/utils/createRoute.ts"],"names":[],"mappings":";;;AAQA,MAAM,aAAa,GAAG,CAAC,GAAwB,EAAE,EAAE,CACjD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAEhC;;;GAGG;AACI,MAAM,WAAW,GAAG,CAAC,MAA8B,EAAE,EAAE;IAC5D,MAAM,WAAW,GAA2C,EAAE,CAAC;IAE/D,MAAM,IAAI,GAAG,CAAC,KAAgC,EAAE,WAAmB,EAAE,EAAE;QACrE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAgB,EAAE,EAAE;YACnE,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;gBAClB,WAAW,CAAC,IAAI,CAAC;oBACf,QAAQ,EAAE,WAAW,GAAG,QAAQ;oBAChC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAc;iBACtC,CAAC,CAAC;YACL,CAAC;YAED,IACE,OAAO;gBACP,CAAC,aAAa,CAAC,OAAO,CAAC;gBACvB,CAAC,OAAO,CAAC,SAAS;gBAClB,CAAC,OAAO,CAAC,QAAQ,EACjB,CAAC;gBACD,MAAM,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;gBACvC,IAAI,CACF,OAAO,EACP,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC3D,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEvB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAC/B,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAgB,CACrC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAElD,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,UAAU;KACnB,CAAC;AACJ,CAAC,CAAC;AArCW,QAAA,WAAW,eAqCtB"}

package/dist/PathRouter/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./clearSlash";
+export * from "./parseSearch";
+export * from "./setters";
+export * from "./createRoute";
+//# sourceMappingURL=index.d.ts.map

package/dist/PathRouter/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/PathRouter/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/PathRouter/utils/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./clearSlash"), exports);
+__exportStar(require("./parseSearch"), exports);
+__exportStar(require("./setters"), exports);
+__exportStar(require("./createRoute"), exports);
+//# sourceMappingURL=index.js.map

package/dist/PathRouter/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/PathRouter/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,gDAA8B;AAC9B,4CAA0B;AAC1B,gDAA8B"}

package/dist/PathRouter/utils/parseSearch.d.ts

@@ -0,0 +1,4 @@
+import { type Location } from "react-router-dom";
+import { type SearchParamsState } from "../types";
+export declare const parseSearchParams: (searchParams: SearchParamsState, location: Location) => URLSearchParams;
+//# sourceMappingURL=parseSearch.d.ts.map

package/dist/PathRouter/utils/parseSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSearch.d.ts","sourceRoot":"","sources":["../../../src/PathRouter/utils/parseSearch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,eAAO,MAAM,iBAAiB,GAC5B,cAAc,iBAAiB,EAC/B,UAAU,QAAQ,oBASnB,CAAC"}

package/dist/PathRouter/utils/parseSearch.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSearchParams = void 0;
+const parseSearchParams = (searchParams, location) => {
+    const params = new URLSearchParams(location.search);
+    Object.entries(searchParams).forEach(([key, values]) => {
+        if (typeof values === "string")
+            params.set(key, values);
+        else
+            values.forEach((value) => params.append(key, value));
+    });
+    return params;
+};
+exports.parseSearchParams = parseSearchParams;
+//# sourceMappingURL=parseSearch.js.map

package/dist/PathRouter/utils/parseSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSearch.js","sourceRoot":"","sources":["../../../src/PathRouter/utils/parseSearch.ts"],"names":[],"mappings":";;;AAGO,MAAM,iBAAiB,GAAG,CAC/B,YAA+B,EAC/B,QAAkB,EAClB,EAAE;IACF,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE;QACrD,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;;YACnD,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAXW,QAAA,iBAAiB,qBAW5B"}

package/dist/PathRouter/utils/setters.d.ts

@@ -0,0 +1,9 @@
+import type { ModalData, PageData } from "../types";
+export * from "./createRoute";
+/** Wrap a page descriptor so the route tree can detect leaves via `data`. */
+export declare const setPage: <const T extends PageData>(data: T) => {
+    data: T;
+};
+/** Identity helper that gives nice inference for modal descriptors. */
+export declare const setModal: <const T extends ModalData>(data: T) => T;
+//# sourceMappingURL=setters.d.ts.map

package/dist/PathRouter/utils/setters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setters.d.ts","sourceRoot":"","sources":["../../../src/PathRouter/utils/setters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpD,cAAc,eAAe,CAAC;AAE9B,6EAA6E;AAC7E,eAAO,MAAM,OAAO,GAAI,KAAK,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,CAAC;;CAAe,CAAC;AAEzE,uEAAuE;AACvE,eAAO,MAAM,QAAQ,GAAI,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,CAAC,KAAG,CAAS,CAAC"}

package/dist/PathRouter/utils/setters.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setModal = exports.setPage = void 0;
+__exportStar(require("./createRoute"), exports);
+/** Wrap a page descriptor so the route tree can detect leaves via `data`. */
+const setPage = (data) => ({ data });
+exports.setPage = setPage;
+/** Identity helper that gives nice inference for modal descriptors. */
+const setModal = (data) => data;
+exports.setModal = setModal;
+//# sourceMappingURL=setters.js.map

package/dist/PathRouter/utils/setters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setters.js","sourceRoot":"","sources":["../../../src/PathRouter/utils/setters.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,gDAA8B;AAE9B,6EAA6E;AACtE,MAAM,OAAO,GAAG,CAA2B,IAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAA5D,QAAA,OAAO,WAAqD;AAEzE,uEAAuE;AAChE,MAAM,QAAQ,GAAG,CAA4B,IAAO,EAAK,EAAE,CAAC,IAAI,CAAC;AAA3D,QAAA,QAAQ,YAAmD"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./PathRouter";
+//# 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,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./PathRouter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "path-router-red",
+  "version": "0.4.0",
+  "private": false,
+  "description": "Type-safe routing layer",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "RED_TR",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tterryrice-beep/path-router.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tterryrice-beep/path-router/issues"
+  },
+  "homepage": "https://github.com/tterryrice-beep/path-router#readme",
+  "devDependencies": {
+    "@types/events": "^3.0.3",
+    "@types/react": "^19.2.17",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "events": "^3.3.0",
+    "react": "^19.2.7",
+    "react-router-dom": "^7.18.0"
+  }
+}

package/src/PathRouter/Container/ModalsContainer.tsx

@@ -0,0 +1,92 @@
+import React, { Fragment, Suspense, useEffect, useRef } from "react";
+import { Routes, Route, Navigate } from "react-router-dom";
+
+import { usePath } from "../Provider/usePath";
+import { clearSlash } from "../utils/clearSlash";
+import type {
+  ModalData,
+  ModalWrapperComponent,
+  ModalWrapperRef,
+} from "../types";
+
+export interface ModalContainerProps {
+  paths: { pathName: string; data: ModalData }[];
+  /**
+   * Optional wrapper around the modal contents (e.g. an animated popup).
+   * If omitted, the modal component is rendered directly.
+   */
+  ModalWrapper?: ModalWrapperComponent;
+  /** Fallback shown by `Suspense` while a lazy modal is loading. */
+  fallback?: React.ReactNode;
+}
+
+export const ModalsContainer: React.FC<ModalContainerProps> = ({
+  paths,
+  ModalWrapper,
+  fallback = null,
+}) => {
+  const { page, modal } = usePath();
+  const { name: modalName, isOpen, close } = modal;
+  const modalRef = useRef<ModalWrapperRef | null>(null);
+
+  const hasMatchingComponent =
+    !!modalName &&
+    paths.some(
+      ({ pathName, data }) => pathName === modalName && !!data.component,
+    );
+
+  useEffect(() => {
+    if (isOpen && !hasMatchingComponent) {
+      close();
+    }
+  }, [isOpen, hasMatchingComponent, close]);
+
+  if (!modalName) return null;
+
+  const routesLocation = clearSlash(`${page.path}/${modalName}`);
+
+  const handleClose = () =>
+    modalRef.current?.handleCloseWithAnimation
+      ? modalRef.current.handleCloseWithAnimation()
+      : close();
+
+  const content = (
+    <Suspense fallback={fallback}>
+      <Routes location={routesLocation}>
+        {paths.map(({ pathName, data }, i) => {
+          const { component: Component } = data;
+          if (!Component) {
+            return (
+              <Route
+                key={`modals/${pathName}_${i}`}
+                path={clearSlash(`${page.path}/${pathName}`)}
+                element={<Navigate to="/" replace />}
+              />
+            );
+          }
+          return (
+            <Route
+              key={`modals/${pathName}_${i}`}
+              path={clearSlash(`${page.path}/${pathName}`)}
+              element={<Component onClose={handleClose} />}
+            />
+          );
+        })}
+      </Routes>
+    </Suspense>
+  );
+
+  if (!ModalWrapper) {
+    return isOpen ? <Fragment>{content}</Fragment> : null;
+  }
+
+  return (
+    <ModalWrapper
+      ref={modalRef}
+      modalName={modalName}
+      isOpen={isOpen}
+      onClose={close}>
+      {content}
+    </ModalWrapper>
+  );
+};

package/src/PathRouter/Container/RouterContainer.tsx

@@ -0,0 +1,66 @@
+import React, { type ReactNode, Suspense, useMemo } from "react";
+import { Routes as Switch, Route, Navigate } from "react-router-dom";
+
+import { usePath } from "../Provider/usePath";
+import { createRoute } from "../utils/createRoute";
+
+import { ModalsContainer } from "./ModalsContainer";
+import type { ModalWrapperComponent, RouterConfig } from "../types";
+
+export interface PathRouterProps<C extends RouterConfig<any, any>> {
+  /** Pages + modals tree built with `setPage` / `setModal`. */
+  config: C;
+  /**
+   * Optional component used to wrap modal content (animated popup, etc.).
+   * The package will pass it `{ modalName, isOpen, onClose, children }`
+   * and read `handleCloseWithAnimation()` from its forwarded ref.
+   */
+  ModalWrapper?: ModalWrapperComponent;
+  /** Suspense fallback shown while pages / modals are loading. */
+  fallback?: ReactNode;
+}
+
+export const PathRouterContainer = <C extends RouterConfig<any, any>>({
+  config,
+  ModalWrapper,
+  fallback = null,
+}: PathRouterProps<C>) => {
+  const { modal } = usePath();
+
+  const { pages, modals } = useMemo(() => createRoute(config), [config]);
+
+  return (
+    <>
+      <Suspense fallback={fallback}>
+        <Switch>
+          {pages.map(({ pathName, data }, i) => {
+            const { component: Component, redirect } = data;
+            const isRedirect = Boolean(!Component || redirect);
+
+            return (
+              <Route
+                key={`routes/${pathName}_${i}`}
+                path={pathName}
+                element={
+                  !isRedirect && Component ? (
+                    <Component />
+                  ) : (
+                    <Navigate to={redirect || "/"} replace />
+                  )
+                }
+              />
+            );
+          })}
+        </Switch>
+      </Suspense>
+
+      {modal.isOpen && (
+        <ModalsContainer
+          paths={modals}
+          ModalWrapper={ModalWrapper}
+          fallback={fallback}
+        />
+      )}
+    </>
+  );
+};

package/src/PathRouter/Container/index.ts

@@ -0,0 +1 @@
+export * from "./RouterContainer";