@vielzeug/wayfinder 2.0.0 → 2.2.0

package/dist/devtools.d.ts

@@ -1,47 +0,0 @@
-/**
- * @vielzeug/wayfinder — debug utilities for router navigation visualisation.
- *
- * Import from the dedicated sub-path so it is tree-shaken from production bundles:
- * ```ts
- * import { debugRouter } from '@vielzeug/wayfinder/devtools';
- * ```
- */
-import type { Router, RouterOptions, RouteTable } from './index';
-/** Options for {@link debugRouter}. Extends {@link RouterOptions} with debug-specific settings. */
-export interface DebugRouterOptions<TRoutes extends RouteTable, TMeta = unknown, TComponent = unknown> extends RouterOptions<TRoutes, TMeta, TComponent> {
-    /**
-     * Label used in log prefixes. Defaults to `'nav'`, producing `[wayfinder:nav]`.
-     * Useful when running multiple routers (e.g. a main router and a modal router)
-     * so their log output can be distinguished:
-     * ```ts
-     * debugRouter({ label: 'modal', routes });
-     * // [wayfinder:modal] loading  /confirm
-     * ```
-     */
-    label?: string;
-}
-/**
- * Creates a {@link Router} with navigation lifecycle logging pre-wired to `console.debug`.
- *
- * Equivalent to `createRouter(options)` with a `subscribe` listener attached, but imported
- * from a dedicated sub-path so `console.debug` references are tree-shaken from production
- * bundles when this sub-path is not imported.
- *
- * Logs every navigation state change with `[wayfinder:<label>]` prefixes showing the pathname,
- * status (`loading` → `idle` / `error`), and matched route names.
- *
- * @example
- * ```ts
- * import { debugRouter } from '@vielzeug/wayfinder/devtools';
- *
- * const router = debugRouter({ routes });
- * // [wayfinder:nav] loading  /users
- * // [wayfinder:nav] idle     /users  [users]
- *
- * // Multi-router setup:
- * const modal = debugRouter({ label: 'modal', routes: modalRoutes });
- * // [wayfinder:modal] loading  /confirm
- * ```
- */
-export declare function debugRouter<const TRoutes extends RouteTable, TMeta = unknown, TComponent = unknown>(options: DebugRouterOptions<TRoutes, TMeta, TComponent>): Router<TRoutes, TMeta, TComponent>;
-//# sourceMappingURL=devtools.d.ts.map

package/dist/devtools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAc,UAAU,EAAE,MAAM,SAAS,CAAC;AAI7E,mGAAmG;AACnG,MAAM,WAAW,kBAAkB,CACjC,OAAO,SAAS,UAAU,EAC1B,KAAK,GAAG,OAAO,EACf,UAAU,GAAG,OAAO,CACpB,SAAQ,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC;IACjD;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,OAAO,SAAS,UAAU,EAAE,KAAK,GAAG,OAAO,EAAE,UAAU,GAAG,OAAO,EACjG,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,GACtD,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAsBpC"}

package/dist/devtools.js

@@ -1,13 +0,0 @@
-import { createRouter as e } from "./router.js";
-//#region src/devtools.ts
-function t(t) {
-	let { label: n = "nav", ...r } = t, i = e(r), a = `[wayfinder:${n}]`;
-	return i.subscribe((e) => {
-		let t = e.matches.map((e) => e.name).filter(Boolean).join(", "), n = t ? `  [${t}]` : "";
-		e.status === "error" ? console.debug(`${a} error    ${e.location.pathname}${n}`, e.error) : console.debug(`${a} ${e.status.padEnd(8)} ${e.location.pathname}${n}`);
-	}), i;
-}
-//#endregion
-export { t as debugRouter };
-
-//# sourceMappingURL=devtools.js.map

package/dist/devtools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"devtools.js","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @vielzeug/wayfinder — debug utilities for router navigation visualisation.\n *\n * Import from the dedicated sub-path so it is tree-shaken from production bundles:\n * ```ts\n * import { debugRouter } from '@vielzeug/wayfinder/devtools';\n * ```\n */\n\nimport type { Router, RouterOptions, RouteState, RouteTable } from './index';\n\nimport { createRouter } from './router';\n\n/** Options for {@link debugRouter}. Extends {@link RouterOptions} with debug-specific settings. */\nexport interface DebugRouterOptions<\n  TRoutes extends RouteTable,\n  TMeta = unknown,\n  TComponent = unknown,\n> extends RouterOptions<TRoutes, TMeta, TComponent> {\n  /**\n   * Label used in log prefixes. Defaults to `'nav'`, producing `[wayfinder:nav]`.\n   * Useful when running multiple routers (e.g. a main router and a modal router)\n   * so their log output can be distinguished:\n   * ```ts\n   * debugRouter({ label: 'modal', routes });\n   * // [wayfinder:modal] loading  /confirm\n   * ```\n   */\n  label?: string;\n}\n\n/**\n * Creates a {@link Router} with navigation lifecycle logging pre-wired to `console.debug`.\n *\n * Equivalent to `createRouter(options)` with a `subscribe` listener attached, but imported\n * from a dedicated sub-path so `console.debug` references are tree-shaken from production\n * bundles when this sub-path is not imported.\n *\n * Logs every navigation state change with `[wayfinder:<label>]` prefixes showing the pathname,\n * status (`loading` → `idle` / `error`), and matched route names.\n *\n * @example\n * ```ts\n * import { debugRouter } from '@vielzeug/wayfinder/devtools';\n *\n * const router = debugRouter({ routes });\n * // [wayfinder:nav] loading  /users\n * // [wayfinder:nav] idle     /users  [users]\n *\n * // Multi-router setup:\n * const modal = debugRouter({ label: 'modal', routes: modalRoutes });\n * // [wayfinder:modal] loading  /confirm\n * ```\n */\nexport function debugRouter<const TRoutes extends RouteTable, TMeta = unknown, TComponent = unknown>(\n  options: DebugRouterOptions<TRoutes, TMeta, TComponent>,\n): Router<TRoutes, TMeta, TComponent> {\n  const { label = 'nav', ...routerOptions } = options;\n  const router = createRouter<TRoutes, TMeta, TComponent>(routerOptions);\n  const prefix = `[wayfinder:${label}]`;\n\n  const log = (state: RouteState<TMeta, TComponent>): void => {\n    const names = state.matches\n      .map((m) => m.name)\n      .filter(Boolean)\n      .join(', ');\n    const suffix = names ? `  [${names}]` : '';\n\n    if (state.status === 'error') {\n      console.debug(`${prefix} error    ${state.location.pathname}${suffix}`, state.error);\n    } else {\n      console.debug(`${prefix} ${state.status.padEnd(8)} ${state.location.pathname}${suffix}`);\n    }\n  };\n\n  router.subscribe(log);\n\n  return router;\n}\n"],"mappings":";;AAsDA,SAAgB,EACd,GACoC;CACpC,IAAM,EAAE,WAAQ,OAAO,GAAG,MAAkB,GACtC,IAAS,EAAyC,CAAa,GAC/D,IAAS,cAAc,EAAM;CAkBnC,OAFA,EAAO,WAdM,MAA+C;EAC1D,IAAM,IAAQ,EAAM,QACjB,KAAK,MAAM,EAAE,IAAI,CAAC,CAClB,OAAO,OAAO,CAAC,CACf,KAAK,IAAI,GACN,IAAS,IAAQ,MAAM,EAAM,KAAK;EAExC,AAAI,EAAM,WAAW,UACnB,QAAQ,MAAM,GAAG,EAAO,YAAY,EAAM,SAAS,WAAW,KAAU,EAAM,KAAK,IAEnF,QAAQ,MAAM,GAAG,EAAO,GAAG,EAAM,OAAO,OAAO,CAAC,EAAE,GAAG,EAAM,SAAS,WAAW,GAAQ;CAE3F,CAEoB,GAEb;AACT"}