@forge/react 11.16.2-next.1 → 11.16.2-next.1-experimental-49a346a

package/out/router/hooks/useNavigate.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useNavigate = void 0;
+const react_1 = require("react");
+const RouterContext_1 = require("../components/RouterContext");
+const resolvePath = (currentPathname, to) => {
+    if (to.startsWith('/')) {
+        return to;
+    }
+    const currentPath = currentPathname.endsWith('/') ? currentPathname.slice(0, -1) : currentPathname;
+    const combined = currentPath + '/' + to;
+    const segments = combined.split('/').filter(Boolean);
+    const resolved = [];
+    for (const segment of segments) {
+        if (segment === '..') {
+            resolved.pop();
+        }
+        else if (segment !== '.') {
+            resolved.push(segment);
+        }
+    }
+    return '/' + resolved.join('/');
+};
+const useNavigate = () => {
+    const context = (0, react_1.useContext)(RouterContext_1.RouterContext);
+    if (!context) {
+        throw new Error('useNavigate must be used within a Router component');
+    }
+    const { history } = context;
+    const navigate = (0, react_1.useCallback)((to, options) => {
+        if (typeof to === 'number') {
+            history.go(to);
+            return;
+        }
+        const path = resolvePath(history.location.pathname, to);
+        if (options?.replace) {
+            history.replace(path);
+        }
+        else {
+            history.push(path);
+        }
+    }, [history]);
+    return navigate;
+};
+exports.useNavigate = useNavigate;

package/out/router/hooks/useParams.d.ts

@@ -0,0 +1,2 @@
+export declare const useParams: () => Record<string, string>;
+//# sourceMappingURL=useParams.d.ts.map

package/out/router/hooks/useParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useParams.d.ts","sourceRoot":"","sources":["../../../src/router/hooks/useParams.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,SAAS,QAAO,OAAO,MAAM,EAAE,MAAM,CAMjD,CAAC"}

package/out/router/hooks/useParams.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useParams = void 0;
+const react_1 = require("react");
+const ParamsContext_1 = require("../components/ParamsContext");
+const useParams = () => {
+    const context = (0, react_1.useContext)(ParamsContext_1.ParamsContext);
+    if (context === null) {
+        throw new Error('useParams must be used within a Route component');
+    }
+    return context;
+};
+exports.useParams = useParams;

package/out/router/index.d.ts

@@ -0,0 +1,5 @@
+export { Router, Route, type RouterProps, type RouteProps } from './components';
+export { useNavigate } from './hooks/useNavigate';
+export { useLocation } from './hooks/useLocation';
+export { useParams } from './hooks/useParams';
+//# sourceMappingURL=index.d.ts.map

package/out/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/out/router/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useParams = exports.useLocation = exports.useNavigate = exports.Route = exports.Router = void 0;
+var components_1 = require("./components");
+Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return components_1.Router; } });
+Object.defineProperty(exports, "Route", { enumerable: true, get: function () { return components_1.Route; } });
+var useNavigate_1 = require("./hooks/useNavigate");
+Object.defineProperty(exports, "useNavigate", { enumerable: true, get: function () { return useNavigate_1.useNavigate; } });
+var useLocation_1 = require("./hooks/useLocation");
+Object.defineProperty(exports, "useLocation", { enumerable: true, get: function () { return useLocation_1.useLocation; } });
+var useParams_1 = require("./hooks/useParams");
+Object.defineProperty(exports, "useParams", { enumerable: true, get: function () { return useParams_1.useParams; } });

package/out/router/utils/__test__/matchPath.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=matchPath.test.d.ts.map

package/out/router/utils/__test__/matchPath.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchPath.test.d.ts","sourceRoot":"","sources":["../../../../src/router/utils/__test__/matchPath.test.ts"],"names":[],"mappings":""}

package/out/router/utils/__test__/matchPath.test.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const matchPath_1 = require("../matchPath");
+describe('matchPath', () => {
+    it('matches exact static paths', () => {
+        expect((0, matchPath_1.matchPath)('/', '/')).toEqual({ params: {} });
+        expect((0, matchPath_1.matchPath)('/settings', '/settings')).toEqual({ params: {} });
+    });
+    it('returns null for non-matching static paths', () => {
+        expect((0, matchPath_1.matchPath)('/settings', '/about')).toBeNull();
+        expect((0, matchPath_1.matchPath)('/settings', '/')).toBeNull();
+    });
+    it('extracts a single param', () => {
+        expect((0, matchPath_1.matchPath)('/posts/:id', '/posts/123')).toEqual({ params: { id: '123' } });
+    });
+    it('extracts multiple params', () => {
+        expect((0, matchPath_1.matchPath)('/posts/:postId/comments/:commentId', '/posts/42/comments/7')).toEqual({
+            params: { postId: '42', commentId: '7' }
+        });
+    });
+    it('returns null when segment count differs', () => {
+        expect((0, matchPath_1.matchPath)('/posts/:id', '/posts')).toBeNull();
+        expect((0, matchPath_1.matchPath)('/posts/:id', '/posts/123/extra')).toBeNull();
+    });
+    it('returns null when static segments do not match', () => {
+        expect((0, matchPath_1.matchPath)('/posts/:id', '/users/123')).toBeNull();
+    });
+    it('matches paths with mixed static and dynamic segments', () => {
+        expect((0, matchPath_1.matchPath)('/users/:userId/posts/:postId', '/users/alice/posts/99')).toEqual({
+            params: { userId: 'alice', postId: '99' }
+        });
+    });
+    it('matches catchall pattern and captures remaining segments', () => {
+        expect((0, matchPath_1.matchPath)('/files/*', '/files/docs/report.pdf')).toEqual({
+            params: { '*': 'docs/report.pdf' }
+        });
+    });
+    it('matches catchall with empty remainder', () => {
+        expect((0, matchPath_1.matchPath)('/files/*', '/files')).toEqual({
+            params: { '*': '' }
+        });
+    });
+    it('matches bare catchall against any path', () => {
+        expect((0, matchPath_1.matchPath)('*', '/anything/at/all')).toEqual({
+            params: { '*': 'anything/at/all' }
+        });
+    });
+    it('matches catchall combined with dynamic params', () => {
+        expect((0, matchPath_1.matchPath)('/posts/:id/*', '/posts/42/comments/7')).toEqual({
+            params: { id: '42', '*': 'comments/7' }
+        });
+    });
+    it('returns null when static segments before catchall do not match', () => {
+        expect((0, matchPath_1.matchPath)('/files/*', '/users/alice')).toBeNull();
+    });
+});

package/out/router/utils/matchPath.d.ts

@@ -0,0 +1,5 @@
+export interface MatchResult {
+    params: Record<string, string>;
+}
+export declare const matchPath: (pattern: string, pathname: string) => MatchResult | null;
+//# sourceMappingURL=matchPath.d.ts.map

package/out/router/utils/matchPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchPath.d.ts","sourceRoot":"","sources":["../../../src/router/utils/matchPath.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,SAAS,YAAa,MAAM,YAAY,MAAM,KAAG,WAAW,GAAG,IAiC3E,CAAC"}

package/out/router/utils/matchPath.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchPath = void 0;
+const matchPath = (pattern, pathname) => {
+    const patternSegments = pattern.split('/').filter(Boolean);
+    const pathSegments = pathname.split('/').filter(Boolean);
+    const hasCatchall = patternSegments.length > 0 && patternSegments[patternSegments.length - 1] === '*';
+    const matchSegments = hasCatchall ? patternSegments.slice(0, -1) : patternSegments;
+    if (hasCatchall) {
+        if (pathSegments.length < matchSegments.length) {
+            return null;
+        }
+    }
+    else if (patternSegments.length !== pathSegments.length) {
+        return null;
+    }
+    const params = {};
+    for (let i = 0; i < matchSegments.length; i++) {
+        const patternSegment = matchSegments[i];
+        const pathSegment = pathSegments[i];
+        if (patternSegment.startsWith(':')) {
+            const paramName = patternSegment.slice(1);
+            params[paramName] = pathSegment;
+        }
+        else if (patternSegment !== pathSegment) {
+            return null;
+        }
+    }
+    if (hasCatchall) {
+        params['*'] = pathSegments.slice(matchSegments.length).join('/');
+    }
+    return { params };
+};
+exports.matchPath = matchPath;

package/out/router/utils/test-utils.d.ts

@@ -0,0 +1,10 @@
+import { History } from 'history';
+/**
+ * Creates a mock history object that emulates the v4 history API.
+ * The bridge returns a v4-style history object at runtime where `listen`
+ * calls back with `location` directly, but `createMemoryHistory` from
+ * the installed history v5 package passes `{ action, location }`.
+ * This wrapper adapts the v5 listener to behave like v4.
+ */
+export declare const createMockHistory: (initialPath?: string) => History;
+//# sourceMappingURL=test-utils.d.ts.map

package/out/router/utils/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/router/utils/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,4BAAwB,OAYrD,CAAC"}

package/out/router/utils/test-utils.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMockHistory = void 0;
+const history_1 = require("history");
+/**
+ * Creates a mock history object that emulates the v4 history API.
+ * The bridge returns a v4-style history object at runtime where `listen`
+ * calls back with `location` directly, but `createMemoryHistory` from
+ * the installed history v5 package passes `{ action, location }`.
+ * This wrapper adapts the v5 listener to behave like v4.
+ */
+const createMockHistory = (initialPath = '/') => {
+    const history = (0, history_1.createMemoryHistory)({ initialEntries: [initialPath] });
+    const originalListen = history.listen.bind(history);
+    history.listen = (callback) => {
+        return originalListen(({ location }) => callback(location));
+    };
+    jest.spyOn(history, 'push');
+    jest.spyOn(history, 'replace');
+    jest.spyOn(history, 'go');
+    return history;
+};
+exports.createMockHistory = createMockHistory;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forge/react",
-  "version": "11.16.2-next.1",
+  "version": "11.16.2-next.1-experimental-49a346a",
   "description": "Forge React reconciler",
   "author": "Atlassian",
   "license": "SEE LICENSE IN LICENSE.txt",
@@ -26,13 +26,17 @@
     "./global": {
       "types": "./out/components/global/index.d.ts",
       "default": "./out/components/global/index.js"
+    },
+    "./router": {
+      "types": "./out/router/index.d.ts",
+      "default": "./out/router/index.js"
     }
   },
   "dependencies": {
     "@atlaskit/adf-schema": "^48.0.0",
     "@atlaskit/adf-utils": "^19.19.0",
     "@atlaskit/forge-react-types": "^1.3.0",
-    "@forge/bridge": "^5.17.0-next.1",
+    "@forge/bridge": "^5.17.0-next.6-experimental-49a346a",
     "@forge/egress": "^2.3.2",
     "@forge/i18n": "0.0.7",
     "@types/react": "^18.2.64",
@@ -46,6 +50,7 @@
   },
   "devDependencies": {
     "@testing-library/react-hooks": "^8.0.1",
+    "history": "5.3.0",
     "ts-morph": "^22.0.0",
     "ts-node": "^10.9.2"
   },