@ossido-labs/ossido-router 0.1.0

package/dist/esm/utils/preload-route-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload-route-chain.js","names":[],"sources":["../../../src/utils/preload-route-chain.ts"],"sourcesContent":["import type { Route } from '../route';\nimport type { RouterInstanceType } from '../router';\n\nimport { matchRoute } from './match-route';\n\n/**\n * Preload the code of the route matching `pathname` and of every layout that\n * wraps it, so a subsequent render commits the components eagerly instead of\n * suspending on their `React.lazy` chunk.\n *\n * Used ahead of the *initial* render on both sides — the server before\n * streaming (a suspending route would push the page content into an\n * out-of-order late chunk, painting an empty shell first) and the client\n * before hydration (so the first client render matches that inline HTML).\n * Client-side navigation has its own preload in `RouterContext`.\n *\n * A failed chunk load resolves anyway: the render then falls back to the lazy\n * component, which surfaces the load error through the route's error boundary.\n */\nexport async function preloadRouteChain(\n  router: RouterInstanceType,\n  pathname?: string,\n): Promise<void> {\n  const matched = matchRoute(router.routesById, pathname);\n  if (!matched) return;\n\n  const pending: Array<Promise<void>> = [];\n  for (\n    let node: Route | undefined = matched;\n    node;\n    node = node.isRoot ? undefined : node.options.getParentRoute?.()\n  ) {\n    const preload = node.component.preload;\n    if (preload) pending.push(preload().catch(() => undefined));\n  }\n\n  await Promise.all(pending);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,eAAsB,kBACpB,QACA,UACe;CACf,MAAM,UAAU,WAAW,OAAO,YAAY,QAAQ;CACtD,IAAI,CAAC,SAAS;CAEd,MAAM,UAAgC,CAAC;CACvC,KACE,IAAI,OAA0B,SAC9B,MACA,OAAO,KAAK,SAAS,SAAY,KAAK,QAAQ,iBAAiB,GAC/D;EACA,MAAM,UAAU,KAAK,UAAU;EAC/B,IAAI,SAAS,QAAQ,KAAK,QAAQ,CAAC,CAAC,YAAY,MAAS,CAAC;CAC5D;CAEA,MAAM,QAAQ,IAAI,OAAO;AAC3B"}

package/dist/esm/utils/view-transition.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Whether the app opted into view transitions at build time. Baked in via the
+ * vite `define` (`__OSSIDO_VIEW_TRANSITIONS__`); `false` when the define is
+ * absent (tests / SSR), keeping transitions opt-in.
+ */
+export declare const VIEW_TRANSITIONS_ENABLED: boolean;
+/**
+ * Run a router `commit` inside `document.startViewTransition` when `enabled`, the
+ * API is supported, and the user hasn't requested reduced motion — otherwise run
+ * it directly.
+ *
+ * The commit's React state updates are wrapped in `flushSync` so the DOM shows
+ * the new page before the API captures its "after" snapshot; React state updates
+ * are async and wouldn't be applied in time otherwise. This is safe because the
+ * router prefetches the destination's data + code before committing, so the new
+ * route renders synchronously (no Suspense fallback flash).
+ */
+export declare function runCommit(commit: () => void, enabled: boolean): void;

package/dist/esm/utils/view-transition.js

@@ -0,0 +1,35 @@
+import { flushSync } from "react-dom";
+
+//#region src/utils/view-transition.ts
+/**
+* Whether the app opted into view transitions at build time. Baked in via the
+* vite `define` (`__OSSIDO_VIEW_TRANSITIONS__`); `false` when the define is
+* absent (tests / SSR), keeping transitions opt-in.
+*/
+const VIEW_TRANSITIONS_ENABLED = typeof __OSSIDO_VIEW_TRANSITIONS__ !== "undefined" && __OSSIDO_VIEW_TRANSITIONS__;
+/**
+* Run a router `commit` inside `document.startViewTransition` when `enabled`, the
+* API is supported, and the user hasn't requested reduced motion — otherwise run
+* it directly.
+*
+* The commit's React state updates are wrapped in `flushSync` so the DOM shows
+* the new page before the API captures its "after" snapshot; React state updates
+* are async and wouldn't be applied in time otherwise. This is safe because the
+* router prefetches the destination's data + code before committing, so the new
+* route renders synchronously (no Suspense fallback flash).
+*/
+function runCommit(commit, enabled) {
+	const doc = typeof document !== "undefined" ? document : void 0;
+	const prefersReducedMotion = typeof window !== "undefined" && window.matchMedia?.("(prefers-reduced-motion: reduce)").matches === true;
+	if (enabled && doc?.startViewTransition && !prefersReducedMotion) {
+		doc.startViewTransition(() => {
+			flushSync(commit);
+		});
+		return;
+	}
+	commit();
+}
+
+//#endregion
+export { VIEW_TRANSITIONS_ENABLED, runCommit };
+//# sourceMappingURL=view-transition.js.map

package/dist/esm/utils/view-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-transition.js","names":[],"sources":["../../../src/utils/view-transition.ts"],"sourcesContent":["import { flushSync } from 'react-dom';\n\ndeclare const __OSSIDO_VIEW_TRANSITIONS__: boolean;\n\n/**\n * Whether the app opted into view transitions at build time. Baked in via the\n * vite `define` (`__OSSIDO_VIEW_TRANSITIONS__`); `false` when the define is\n * absent (tests / SSR), keeping transitions opt-in.\n */\nexport const VIEW_TRANSITIONS_ENABLED =\n  typeof __OSSIDO_VIEW_TRANSITIONS__ !== 'undefined' &&\n  __OSSIDO_VIEW_TRANSITIONS__;\n\n/** A `Document` that may expose the View Transitions API. */\ninterface ViewTransitionDocument {\n  startViewTransition?: (callback: () => void) => unknown;\n}\n\n/**\n * Run a router `commit` inside `document.startViewTransition` when `enabled`, the\n * API is supported, and the user hasn't requested reduced motion — otherwise run\n * it directly.\n *\n * The commit's React state updates are wrapped in `flushSync` so the DOM shows\n * the new page before the API captures its \"after\" snapshot; React state updates\n * are async and wouldn't be applied in time otherwise. This is safe because the\n * router prefetches the destination's data + code before committing, so the new\n * route renders synchronously (no Suspense fallback flash).\n */\nexport function runCommit(commit: () => void, enabled: boolean): void {\n  const doc =\n    typeof document !== 'undefined'\n      ? (document as unknown as ViewTransitionDocument)\n      : undefined;\n\n  const prefersReducedMotion =\n    typeof window !== 'undefined' &&\n    window.matchMedia?.('(prefers-reduced-motion: reduce)').matches === true;\n\n  if (enabled && doc?.startViewTransition && !prefersReducedMotion) {\n    doc.startViewTransition(() => {\n      flushSync(commit);\n    });\n    return;\n  }\n\n  commit();\n}\n"],"mappings":";;;;;;;;AASA,MAAa,2BACX,OAAO,gCAAgC,eACvC;;;;;;;;;;;;AAkBF,SAAgB,UAAU,QAAoB,SAAwB;CACpE,MAAM,MACJ,OAAO,aAAa,cACf,WACD;CAEN,MAAM,uBACJ,OAAO,WAAW,eAClB,OAAO,aAAa,kCAAkC,CAAC,CAAC,YAAY;CAEtE,IAAI,WAAW,KAAK,uBAAuB,CAAC,sBAAsB;EAChE,IAAI,0BAA0B;GAC5B,UAAU,MAAM;EAClB,CAAC;EACD;CACF;CAEA,OAAO;AACT"}

package/dist/esm/utils.d.ts

@@ -0,0 +1,6 @@
+import type { Segment } from './types';
+export declare function joinPaths(paths: Array<string | undefined>): string;
+export declare function parsePathname(pathname?: string): Array<Segment>;
+export declare function trimPathLeft(path: string): string;
+export declare function trimPathRight(path: string): string;
+export declare function trimPath(path: string): string;

package/dist/esm/utils.js

@@ -0,0 +1,20 @@
+//#region src/utils.ts
+function joinPaths(paths) {
+	return cleanPath(paths.filter(Boolean).join("/"));
+}
+function cleanPath(path) {
+	return path.replace(/\/{2,}/g, "/");
+}
+function trimPathLeft(path) {
+	return path === "/" ? path : path.replace(/^\/{1,}/, "");
+}
+function trimPathRight(path) {
+	return path === "/" ? path : path.replace(/\/{1,}$/, "");
+}
+function trimPath(path) {
+	return trimPathRight(trimPathLeft(path));
+}
+
+//#endregion
+export { joinPaths, trimPath, trimPathLeft, trimPathRight };
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/utils.ts"],"sourcesContent":["import type { Segment } from './types';\n\nexport function joinPaths(paths: Array<string | undefined>): string {\n  return cleanPath(paths.filter(Boolean).join('/'));\n}\n\nfunction cleanPath(path: string): string {\n  // remove double slashes\n  return path.replace(/\\/{2,}/g, '/');\n}\n\nexport function parsePathname(pathname?: string): Array<Segment> {\n  if (!pathname) {\n    return [];\n  }\n\n  pathname = cleanPath(pathname);\n\n  const segments: Array<Segment> = [];\n\n  if (pathname.slice(0, 1) === '/') {\n    pathname = pathname.substring(1);\n    segments.push({\n      type: 'pathname',\n      value: '/',\n    });\n  }\n\n  if (!pathname) {\n    return segments;\n  }\n\n  // Remove empty segments and '.' segments\n  const split = pathname.split('/').filter(Boolean);\n\n  segments.push(\n    ...split.map((part): Segment => {\n      if (part === '$' || part === '*') {\n        return {\n          type: 'wildcard',\n          value: part,\n        };\n      }\n\n      if (part.charAt(0) === '$') {\n        return {\n          type: 'param',\n          value: part,\n        };\n      }\n\n      return {\n        type: 'pathname',\n        value: part,\n      };\n    }),\n  );\n\n  if (pathname.slice(-1) === '/') {\n    pathname = pathname.substring(1);\n    segments.push({\n      type: 'pathname',\n      value: '/',\n    });\n  }\n\n  return segments;\n}\nexport function trimPathLeft(path: string): string {\n  return path === '/' ? path : path.replace(/^\\/{1,}/, '');\n}\nexport function trimPathRight(path: string): string {\n  return path === '/' ? path : path.replace(/\\/{1,}$/, '');\n}\nexport function trimPath(path: string): string {\n  return trimPathRight(trimPathLeft(path));\n}\n"],"mappings":";AAEA,SAAgB,UAAU,OAA0C;CAClE,OAAO,UAAU,MAAM,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC;AAClD;AAEA,SAAS,UAAU,MAAsB;CAEvC,OAAO,KAAK,QAAQ,WAAW,GAAG;AACpC;AA2DA,SAAgB,aAAa,MAAsB;CACjD,OAAO,SAAS,MAAM,OAAO,KAAK,QAAQ,WAAW,EAAE;AACzD;AACA,SAAgB,cAAc,MAAsB;CAClD,OAAO,SAAS,MAAM,OAAO,KAAK,QAAQ,WAAW,EAAE;AACzD;AACA,SAAgB,SAAS,MAAsB;CAC7C,OAAO,cAAc,aAAa,IAAI,CAAC;AACzC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@ossido-labs/ossido-router",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "React routing component for the framework ossido. Ossido is the react/rust fullstack framework",
+  "homepage": "https://ossido.dev",
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown && tsc -p tsconfig.build.json",
+    "prepack": "bun run build",
+    "lint": "oxlint",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "typecheck": "tsc --noEmit",
+    "test:watch": "vitest",
+    "test": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ossido-labs/ossido.git",
+    "directory": "packages/ossido-router"
+  },
+  "keywords": [],
+  "author": "Chris Schofield <chris@childishforces.com>",
+  "license": "MIT",
+  "type": "module",
+  "types": "dist/esm/index.d.ts",
+  "main": "dist/esm/index.js",
+  "module": "dist/esm/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "default": "./dist/esm/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "dependencies": {
+    "react-intersection-observer": "^9.13.0",
+    "@ossido-labs/ossido-ui": "0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "16.3.0",
+    "@types/react": "19.1.8",
+    "@types/react-dom": "19.1.6",
+    "@vitejs/plugin-react-swc": "4.3.2",
+    "happy-dom": "18.0.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "tsdown": "0.22.14",
+    "vite": "^8.1.5",
+    "vite-config": "1.0.0",
+    "vitest": "4.1.10"
+  }
+}