@budarin/use-route 1.3.3 → 1.3.5

package/dist/native-api-types.js

@@ -1,9 +1,2 @@
-/**
- * Временные объявления нативного API до появления типов в lib.dom.
- * Когда URLPattern и Navigation API появятся в TypeScript lib.dom — удалить этот файл
- * и убрать реэкспорт из types.ts (или перейти на типы из lib).
- *
- * Источники: WHATWG URL Pattern Standard, MDN/WHATWG Navigation API.
- */
 export {};
 //# sourceMappingURL=native-api-types.js.map

package/dist/native-api-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-api-types.js","sourceRoot":"","sources":["../src/native-api-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuEH,OAAO,EAAE,CAAC"}
+{"version":3,"file":"native-api-types.js","sourceRoot":"","sources":["../src/native-api-types.ts"],"names":[],"mappings":"AA6EA,OAAO,EAAE,CAAC"}

package/dist/types.d.ts

@@ -1,69 +1,46 @@
-/** Строка — полный URL. */
 export type UrlString = string;
-/** Строка — паттерн пути (например '/users/:id'). */
 export type PathPattern = string;
-/** Строка — pathname, часть пути URL (например '/users/123'). */
 export type Pathname = string;
-/** Ключ записи в Navigation API (history entry key). */
 export type NavigationEntryKey = string;
-/** Индекс в истории навигации. */
 export type HistoryIndex = number;
-/** Имя параметра маршрута (ключ в params). */
 export type RouteParamName = string;
-/** Значение параметра маршрута (сегмент pathname). */
 export type RouteParamValue = string;
-/** Параметры маршрута: имя параметра → значение (из pathname по паттерну). */
 export type RouteParams = Record<RouteParamName, RouteParamValue>;
-/** Функция-матчер пути: pathname → matched и params. Для иерархических/кастомных маршрутов. */
 export type PathMatcher = (pathname: Pathname) => {
     matched: boolean;
     params: RouteParams;
 };
-/** Извлекает тип params из строки паттерна: '/users/:id' → { id: string } */
 export type ExtractRouteParams<T extends string> = T extends `${string}:${infer Param}/${infer Rest}` ? {
     [K in Param]: string;
 } & ExtractRouteParams<`/${Rest}`> : T extends `${string}:${infer Param}` ? {
     [K in Param]: string;
 } : Record<string, never>;
-/** Тип params для useRoute(pattern): литерал пути → типизированные ключи; PathMatcher → RouteParams; иначе {} */
 export type ParamsForPath<P> = P extends PathMatcher ? RouteParams : [P] extends [string] ? string extends P ? RouteParams : ExtractRouteParams<P> : Record<string, never>;
 export interface RouterState {
     location: UrlString;
     pathname: Pathname;
-    /** Только чтение. Мутировать не следует — не меняет реальный URL. */
     searchParams: URLSearchParams;
     params: RouteParams;
     historyIndex: HistoryIndex;
-    /** State текущей записи истории (getState() / history.state). */
     state?: unknown;
-    /** true, если передан pattern и он совпал с pathname; false при несовпадении; undefined, если pattern не передан */
     matched?: boolean;
 }
 export interface NavigateOptions {
-    /** 'replace' — заменить текущую запись, 'push' — новая запись, 'auto' — по умолчанию (браузер решает). */
     history?: 'push' | 'replace' | 'auto';
-    /** Состояние записи в истории (Navigation API): произвольные данные, связанные с этим переходом; можно прочитать из currentEntry.getState() после навигации. Передаётся в navigate и replace в одном поле options.state. */
     state?: unknown;
-    /** Full path prefix for this call. Overrides everything. '' or '/' = no prefix (e.g. other app). Otherwise this path is the prefix. Use for leaving app or explicit full path. */
     base?: string;
-    /** Section override for this call. '' = app root (global base only, no section). '/path' = that section under global base. Ignored if base is set. */
     section?: string;
 }
-/** useRoute options: section (subtree under global base). pathname without section prefix; navigate(to) adds global base + section. */
 export interface UseRouteOptions {
-    /** Section path under global base (e.g. '/dashboard'). pathname returned without this prefix; navigate(to) adds globalBase + section. '' = app root. Combined with configureRouter.base, not replacing it. */
     section?: string;
 }
 export type UseRouteReturn<P extends string | PathMatcher | undefined = undefined> = Omit<RouterState, 'params'> & {
     params: ParamsForPath<P>;
-    /** Резолвится при commit навигации (не обязательно при полном finish, см. Navigation API). */
     navigate: (to: string | URL, options?: NavigateOptions) => Promise<void>;
     back: () => void;
     forward: () => void;
     go: (delta: number) => void;
-    /** Same as navigate(to, { ...options, history: 'replace' }). Options same as navigate (state, base, section); history ignored. */
     replace: (to: string | URL, options?: NavigateOptions) => Promise<void>;
-    /** Обновляет state текущей записи истории без навигации (Navigation API updateCurrentEntry / history.replaceState). */
     updateState: (state: unknown) => void;
     canGoBack: (steps?: number) => boolean;
     canGoForward: (steps?: number) => boolean;
@@ -77,28 +54,13 @@ export interface Logger {
     error(...args: unknown[]): void;
 }
 export interface RouterConfig {
-    /** Максимальное количество URL в кэше (по умолчанию: 50) */
     urlCacheLimit: number;
-    /** Значение history по умолчанию для всех вызовов navigate() (по умолчанию: 'auto') */
     defaultHistory?: 'push' | 'replace' | 'auto';
-    /** Логгер (по умолчанию: console) */
     logger?: Logger;
-    /** Базовый путь приложения (например '/app'). pathname возвращается без base; navigate(to) добавляет base к относительным путям. */
     base?: string;
-    /** Начальный URL для SSR: при рендере на сервере (нет window) используется этот URL для pathname/searchParams. Задаётся один раз перед рендером запроса (например request.url). */
     initialLocation?: string;
 }
-/**
- * Настройка глобальной конфигурации роутера
- * Вызывается один раз при инициализации приложения
- */
 export declare function configureRouter(config: Partial<RouterConfig>): void;
-/**
- * Получить текущую конфигурацию (для внутреннего использования)
- */
 export declare function getRouterConfig(): RouterConfig;
-/**
- * Получить логгер (config.logger ?? console)
- */
 export declare function getLogger(): Logger;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,23 +1,12 @@
-// Внутренняя конфигурация (не экспортируется)
 let routerConfig = {
     urlCacheLimit: 50,
 };
-/**
- * Настройка глобальной конфигурации роутера
- * Вызывается один раз при инициализации приложения
- */
 export function configureRouter(config) {
     routerConfig = { ...routerConfig, ...config };
 }
-/**
- * Получить текущую конфигурацию (для внутреннего использования)
- */
 export function getRouterConfig() {
     return routerConfig;
 }
-/**
- * Получить логгер (config.logger ?? console)
- */
 export function getLogger() {
     return routerConfig.logger ?? console;
 }

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuHA,8CAA8C;AAC9C,IAAI,YAAY,GAAiB;IAC7B,aAAa,EAAE,EAAE;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6B;IACzD,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,EAAE,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC3B,OAAO,YAAY,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACrB,OAAO,YAAY,CAAC,MAAM,IAAI,OAAO,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwHA,IAAI,YAAY,GAAiB;IAC7B,aAAa,EAAE,EAAE;CACpB,CAAC;AAMF,MAAM,UAAU,eAAe,CAAC,MAA6B;IACzD,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,EAAE,CAAC;AAClD,CAAC;AAKD,MAAM,UAAU,eAAe;IAC3B,OAAO,YAAY,CAAC;AACxB,CAAC;AAKD,MAAM,UAAU,SAAS;IACrB,OAAO,YAAY,CAAC,MAAM,IAAI,OAAO,CAAC;AAC1C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@budarin/use-route",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",