@devp0nt/route0 1.0.0-next.1

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2025 Sergei Dmitriev, https://p0nt.dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/cjs/index.d.cts

@@ -0,0 +1,99 @@
+declare class Route0<TPathOriginalDefinition extends string, TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>, TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>, TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>> {
+    pathOriginalDefinition: TPathOriginalDefinition;
+    private pathDefinition;
+    paramsDefinition: TParamsDefinition;
+    queryDefinition: TQueryDefinition;
+    baseUrl: string;
+    private constructor();
+    static create<TPathOriginalDefinition extends string, TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>, TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>, TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>>(definition: TPathOriginalDefinition, config?: Route0.RouteConfigInput): Route0.Callable<Route0<TPathOriginalDefinition, TPathDefinition, TParamsDefinition, TQueryDefinition>>;
+    private static _splitPathDefinitionAndQueryTailDefinition;
+    private static _getAbsPath;
+    private static _getPathDefinitionByOriginalDefinition;
+    private static _getParamsDefinitionByRouteDefinition;
+    private static _getQueryDefinitionByRouteDefinition;
+    static overrideMany<T extends Record<string, Route0<any, any, any, any>>>(routes: T, config: Route0.RouteConfigInput): T;
+    extend<TSuffixDefinition extends string>(suffixDefinition: TSuffixDefinition): Route0.Callable<Route0<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>, Route0._PathDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>, Route0._ParamsDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>, Route0._QueryDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>>>;
+    get(input: Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithParamsInput<TParamsDefinition, {
+        query?: undefined;
+        abs?: false;
+    }>>): Route0._OnlyIfHasParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithParamsInput<TParamsDefinition, {
+        query: Route0._QueryInput<TQueryDefinition>;
+        abs?: false;
+    }>>): Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithParamsInput<TParamsDefinition, {
+        query?: undefined;
+        abs: true;
+    }>>): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithParamsInput<TParamsDefinition, {
+        query: Route0._QueryInput<TQueryDefinition>;
+        abs: true;
+    }>>): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>;
+    get(...args: Route0._OnlyIfNoParams<TParamsDefinition, [], [never]>): Route0._PathOnlyRouteValue<TPathOriginalDefinition>;
+    get(input: Route0._OnlyIfNoParams<TParamsDefinition, {
+        query?: undefined;
+        abs?: false;
+    }>): Route0._OnlyIfNoParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfNoParams<TParamsDefinition, {
+        query: Route0._QueryInput<TQueryDefinition>;
+        abs?: false;
+    }>): Route0._OnlyIfNoParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfNoParams<TParamsDefinition, {
+        query?: undefined;
+        abs: true;
+    }>): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfNoParams<TParamsDefinition, {
+        query: Route0._QueryInput<TQueryDefinition>;
+        abs: true;
+    }>): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>;
+    getDefinition(): TPathDefinition;
+    clone(config?: Route0.RouteConfigInput): Route0<TPathOriginalDefinition, Route0._TrimQueryTailDefinition<TPathOriginalDefinition>, Route0._ParamsDefinition<TPathOriginalDefinition>, Route0._QueryDefinition<TPathOriginalDefinition>>;
+}
+declare namespace Route0 {
+    type Callable<T extends Route0<any, any, any, any>> = T & T['get'];
+    type RouteConfigInput = {
+        baseUrl?: string;
+    };
+    type Params<TRoute0 extends Route0<any, any, any, any>> = {
+        [K in keyof TRoute0['paramsDefinition']]: string;
+    };
+    type Query<TRoute0 extends Route0<any, any, any, any>> = Partial<{
+        [K in keyof TRoute0['queryDefinition']]: string | undefined;
+    } & Record<string, string | undefined>>;
+    type _TrimQueryTailDefinition<S extends string> = S extends `${infer P}&${string}` ? P : S;
+    type _QueryTailDefinitionWithoutFirstAmp<S extends string> = S extends `${string}&${infer T}` ? T : '';
+    type _QueryTailDefinitionWithFirstAmp<S extends string> = S extends `${string}&${infer T}` ? `&${T}` : '';
+    type _AmpSplit<S extends string> = S extends `${infer A}&${infer B}` ? A | _AmpSplit<B> : S;
+    type _NonEmpty<T> = [T] extends ['' | never] ? never : T;
+    type _ExtractPathParams<S extends string> = S extends `${string}:${infer After}` ? After extends `${infer Name}/${infer Rest}` ? Name | _ExtractPathParams<`/${Rest}`> : After : never;
+    type _ReplacePathParams<S extends string> = S extends `${infer Head}:${infer Tail}` ? Tail extends `${infer _Param}/${infer Rest}` ? _ReplacePathParams<`${Head}${string}/${Rest}`> : `${Head}${string}` : S;
+    type _DedupeSlashes<S extends string> = S extends `${infer A}//${infer B}` ? _DedupeSlashes<`${A}/${B}`> : S;
+    type _EmptyRecord = Record<never, never>;
+    type _JoinPath<Parent extends string, Suffix extends string> = _DedupeSlashes<Route0._PathDefinition<Parent> extends infer A extends string ? _PathDefinition<Suffix> extends infer B extends string ? A extends '' ? B extends '' ? '' : B extends `/${string}` ? B : `/${B}` : B extends '' ? A : A extends `${string}/` ? `${A}${B}` : B extends `/${string}` ? `${A}${B}` : `${A}/${B}` : never : never>;
+    type _OnlyIfNoParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? Yes : No;
+    type _OnlyIfHasParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? No : Yes;
+    type _PathDefinition<TPathOriginalDefinition extends string> = _TrimQueryTailDefinition<TPathOriginalDefinition>;
+    type _ParamsDefinition<TPathOriginalDefinition extends string> = _ExtractPathParams<_PathDefinition<TPathOriginalDefinition>> extends infer U ? [U] extends [never] ? _EmptyRecord : {
+        [K in Extract<U, string>]: true;
+    } : _EmptyRecord;
+    type _QueryDefinition<TPathOriginalDefinition extends string> = _NonEmpty<_QueryTailDefinitionWithoutFirstAmp<TPathOriginalDefinition>> extends infer Tail extends string ? _AmpSplit<Tail> extends infer U ? [U] extends [never] ? _EmptyRecord : {
+        [K in Extract<U, string>]: true;
+    } : _EmptyRecord : _EmptyRecord;
+    type _RoutePathOriginalDefinitionExtended<TSourcePathOriginalDefinition extends string, TSuffixPathOriginalDefinition extends string> = `${_JoinPath<TSourcePathOriginalDefinition, TSuffixPathOriginalDefinition>}${_QueryTailDefinitionWithFirstAmp<TSuffixPathOriginalDefinition>}`;
+    type _ParamsInput<TParamsDefinition extends object> = {
+        [K in keyof TParamsDefinition]: string | number;
+    };
+    type _QueryInput<TQueryDefinition extends object> = Partial<{
+        [K in keyof TQueryDefinition]: string | number;
+    }> & Record<string, string | number>;
+    type _WithParamsInput<TParamsDefinition extends object, T extends {
+        query?: _QueryInput<any>;
+        abs?: boolean;
+    }> = _ParamsInput<TParamsDefinition> & T;
+    type _PathOnlyRouteValue<TPathOriginalDefinition extends string> = `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}`;
+    type _WithQueryRouteValue<TPathOriginalDefinition extends string> = `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}?${string}`;
+    type _AbsolutePathOnlyRouteValue<TPathOriginalDefinition extends string> = `${string}${_PathOnlyRouteValue<TPathOriginalDefinition>}`;
+    type _AbsoluteWithQueryRouteValue<TPathOriginalDefinition extends string> = `${string}${_WithQueryRouteValue<TPathOriginalDefinition>}`;
+}
+
+export { Route0 };

package/dist/cjs/index.js

@@ -0,0 +1,158 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  Route0: () => Route0
+});
+module.exports = __toCommonJS(index_exports);
+class Route0 {
+  pathOriginalDefinition;
+  pathDefinition;
+  paramsDefinition;
+  queryDefinition;
+  baseUrl;
+  constructor(definition, config = {}) {
+    this.pathOriginalDefinition = definition;
+    this.pathDefinition = Route0._getPathDefinitionByOriginalDefinition(definition);
+    this.paramsDefinition = Route0._getParamsDefinitionByRouteDefinition(definition);
+    this.queryDefinition = Route0._getQueryDefinitionByRouteDefinition(definition);
+    const { baseUrl } = config;
+    if (baseUrl && typeof baseUrl === "string" && baseUrl.length) {
+      this.baseUrl = baseUrl;
+    } else {
+      const g = globalThis;
+      if (g?.location?.origin) {
+        this.baseUrl = g.location.origin;
+      } else {
+        this.baseUrl = "https://example.com";
+      }
+    }
+  }
+  static create(definition, config) {
+    const original = new Route0(
+      definition,
+      config
+    );
+    const callable = original.get.bind(original);
+    const proxy = new Proxy(callable, {
+      get(_target, prop, receiver) {
+        const value = original[prop];
+        if (typeof value === "function") {
+          return value.bind(original);
+        }
+        return value;
+      },
+      set(_target, prop, value, receiver) {
+        ;
+        original[prop] = value;
+        return true;
+      },
+      has(_target, prop) {
+        return prop in original;
+      }
+    });
+    Object.setPrototypeOf(proxy, Route0.prototype);
+    return proxy;
+  }
+  static _splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition) {
+    const i = pathOriginalDefinition.indexOf("&");
+    if (i === -1) return { pathDefinition: pathOriginalDefinition, queryTailDefinition: "" };
+    return {
+      pathDefinition: pathOriginalDefinition.slice(0, i),
+      queryTailDefinition: pathOriginalDefinition.slice(i)
+    };
+  }
+  static _getAbsPath(baseUrl, pathWithQuery) {
+    return new URL(pathWithQuery, baseUrl).toString().replace(/\/$/, "");
+  }
+  static _getPathDefinitionByOriginalDefinition(pathOriginalDefinition) {
+    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition);
+    return pathDefinition;
+  }
+  static _getParamsDefinitionByRouteDefinition(pathOriginalDefinition) {
+    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition);
+    const matches = Array.from(pathDefinition.matchAll(/:([A-Za-z0-9_]+)/g));
+    const paramsDefinition = Object.fromEntries(matches.map((m) => [m[1], true]));
+    return paramsDefinition;
+  }
+  static _getQueryDefinitionByRouteDefinition(pathOriginalDefinition) {
+    const { queryTailDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition);
+    if (!queryTailDefinition) {
+      return {};
+    }
+    const keys = queryTailDefinition.split("&").map(Boolean);
+    const queryDefinition = Object.fromEntries(keys.map((k) => [k, true]));
+    return queryDefinition;
+  }
+  static overrideMany(routes, config) {
+    const result = {};
+    for (const [key, value] of Object.entries(routes)) {
+      ;
+      result[key] = value.clone(config);
+    }
+    return result;
+  }
+  extend(suffixDefinition) {
+    const { pathDefinition: parentPathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(
+      this.pathOriginalDefinition
+    );
+    const { pathDefinition: suffixPathDefinition, queryTailDefinition: suffixQueryTailDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(suffixDefinition);
+    const pathDefinition = `${parentPathDefinition}/${suffixPathDefinition}`.replace(/\/{2,}/g, "/");
+    const pathOriginalDefinition = `${pathDefinition}${suffixQueryTailDefinition}`;
+    return Route0.create(pathOriginalDefinition, { baseUrl: this.baseUrl });
+  }
+  // implementation
+  get(...args) {
+    const { queryInput, paramsInput, absInput } = (() => {
+      if (args.length === 0) {
+        return { queryInput: {}, paramsInput: {}, absInput: false };
+      }
+      const input = args[0];
+      if (typeof input !== "object" || input === null) {
+        return { queryInput: {}, paramsInput: {}, absInput: false };
+      }
+      const { query, abs, ...params } = input;
+      return { queryInput: query || {}, paramsInput: params, absInput: abs ?? false };
+    })();
+    const neededParamsKeys = Object.keys(this.paramsDefinition);
+    const providedParamsKeys = Object.keys(paramsInput);
+    const notProvidedKeys = neededParamsKeys.filter((k) => !providedParamsKeys.includes(k));
+    if (notProvidedKeys.length) {
+      Object.assign(paramsInput, Object.fromEntries(notProvidedKeys.map((k) => [k, "undefined"])));
+    }
+    let url = String(this.pathDefinition);
+    url = url.replace(/:([A-Za-z0-9_]+)/g, (_m, k) => encodeURIComponent(String(paramsInput?.[k] ?? "")));
+    const queryInputStringified = Object.fromEntries(Object.entries(queryInput).map(([k, v]) => [k, String(v)]));
+    url = [url, new URLSearchParams(queryInputStringified).toString()].filter(Boolean).join("?");
+    url = url.replace(/\/{2,}/g, "/");
+    url = absInput ? Route0._getAbsPath(this.baseUrl, url) : url;
+    return url;
+  }
+  getDefinition() {
+    return this.pathDefinition;
+  }
+  clone(config) {
+    return new Route0(this.pathOriginalDefinition, config);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Route0
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["// TODO: use splats in param definition \"*\"\n// TODO: ? check extend for query only .extend('&x&z')\n// TODO: .create(route, {useQuery, useParams})\n// TODO: Из пас экзакт, из пасвизквери экзает, из чилдрен, из парент, из экзактОр\n// TODO: isEqual, isChildren, isParent\n// TODO: extractParams, extractQuery\n// TODO: getPathDefinition respecting definitionParamPrefix, definitionQueryPrefix\n// TODO: prepend\n// TODO: Route0.createTree({base:{self: x, children: ...})\n// TODO: overrideTree\n// TODO: .create(route, {baseUrl, useLocation})\n// TODO: ? optional path params as @\n// TODO: prependMany, extendMany, overrideMany, with types\n\nexport class Route0<\n  TPathOriginalDefinition extends string,\n  TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>,\n  TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>,\n  TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>,\n> {\n  pathOriginalDefinition: TPathOriginalDefinition\n  private pathDefinition: TPathDefinition\n  paramsDefinition: TParamsDefinition\n  queryDefinition: TQueryDefinition\n  baseUrl: string\n\n  private constructor(definition: TPathOriginalDefinition, config: Route0.RouteConfigInput = {}) {\n    this.pathOriginalDefinition = definition as TPathOriginalDefinition\n    this.pathDefinition = Route0._getPathDefinitionByOriginalDefinition(definition) as TPathDefinition\n    this.paramsDefinition = Route0._getParamsDefinitionByRouteDefinition(definition) as TParamsDefinition\n    this.queryDefinition = Route0._getQueryDefinitionByRouteDefinition(definition) as TQueryDefinition\n\n    const { baseUrl } = config\n    if (baseUrl && typeof baseUrl === 'string' && baseUrl.length) {\n      this.baseUrl = baseUrl\n    } else {\n      const g = globalThis as unknown as { location?: { origin?: string } }\n      if (g?.location?.origin) {\n        this.baseUrl = g.location.origin\n      } else {\n        this.baseUrl = 'https://example.com'\n      }\n    }\n  }\n\n  static create<\n    TPathOriginalDefinition extends string,\n    TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>,\n    TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>,\n    TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>,\n  >(\n    definition: TPathOriginalDefinition,\n    config?: Route0.RouteConfigInput,\n  ): Route0.Callable<Route0<TPathOriginalDefinition, TPathDefinition, TParamsDefinition, TQueryDefinition>> {\n    const original = new Route0<TPathOriginalDefinition, TPathDefinition, TParamsDefinition, TQueryDefinition>(\n      definition,\n      config,\n    )\n    const callable = original.get.bind(original)\n    const proxy = new Proxy(callable, {\n      get(_target, prop, receiver) {\n        const value = (original as any)[prop]\n        if (typeof value === 'function') {\n          return value.bind(original)\n        }\n        return value\n      },\n      set(_target, prop, value, receiver) {\n        ;(original as any)[prop] = value\n        return true\n      },\n      has(_target, prop) {\n        return prop in original\n      },\n    })\n    Object.setPrototypeOf(proxy, Route0.prototype)\n    return proxy as never\n  }\n\n  private static _splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition: string) {\n    const i = pathOriginalDefinition.indexOf('&')\n    if (i === -1) return { pathDefinition: pathOriginalDefinition, queryTailDefinition: '' }\n    return {\n      pathDefinition: pathOriginalDefinition.slice(0, i),\n      queryTailDefinition: pathOriginalDefinition.slice(i),\n    }\n  }\n\n  private static _getAbsPath(baseUrl: string, pathWithQuery: string) {\n    return new URL(pathWithQuery, baseUrl).toString().replace(/\\/$/, '')\n  }\n\n  private static _getPathDefinitionByOriginalDefinition<TPathOriginalDefinition extends string>(\n    pathOriginalDefinition: TPathOriginalDefinition,\n  ) {\n    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition)\n    return pathDefinition as Route0._PathDefinition<TPathOriginalDefinition>\n  }\n\n  private static _getParamsDefinitionByRouteDefinition<TPathOriginalDefinition extends string>(\n    pathOriginalDefinition: TPathOriginalDefinition,\n  ) {\n    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition)\n    const matches = Array.from(pathDefinition.matchAll(/:([A-Za-z0-9_]+)/g))\n    const paramsDefinition = Object.fromEntries(matches.map((m) => [m[1], true]))\n    return paramsDefinition as Route0._ParamsDefinition<TPathOriginalDefinition>\n  }\n\n  private static _getQueryDefinitionByRouteDefinition<TPathOriginalDefinition extends string>(\n    pathOriginalDefinition: TPathOriginalDefinition,\n  ) {\n    const { queryTailDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition)\n    if (!queryTailDefinition) {\n      return {} as Route0._QueryDefinition<TPathOriginalDefinition>\n    }\n    const keys = queryTailDefinition.split('&').map(Boolean)\n    const queryDefinition = Object.fromEntries(keys.map((k) => [k, true]))\n    return queryDefinition as Route0._QueryDefinition<TPathOriginalDefinition>\n  }\n\n  static overrideMany<T extends Record<string, Route0<any, any, any, any>>>(\n    routes: T,\n    config: Route0.RouteConfigInput,\n  ): T {\n    const result = {} as T\n    for (const [key, value] of Object.entries(routes)) {\n      ;(result as any)[key] = value.clone(config)\n    }\n    return result\n  }\n\n  extend<TSuffixDefinition extends string>(\n    suffixDefinition: TSuffixDefinition,\n  ): Route0.Callable<\n    Route0<\n      Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>,\n      Route0._PathDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,\n      Route0._ParamsDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,\n      Route0._QueryDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>\n    >\n  > {\n    const { pathDefinition: parentPathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(\n      this.pathOriginalDefinition,\n    )\n    const { pathDefinition: suffixPathDefinition, queryTailDefinition: suffixQueryTailDefinition } =\n      Route0._splitPathDefinitionAndQueryTailDefinition(suffixDefinition)\n    const pathDefinition = `${parentPathDefinition}/${suffixPathDefinition}`.replace(/\\/{2,}/g, '/')\n    const pathOriginalDefinition =\n      `${pathDefinition}${suffixQueryTailDefinition}` as Route0._RoutePathOriginalDefinitionExtended<\n        TPathOriginalDefinition,\n        TSuffixDefinition\n      >\n    return Route0.create<\n      Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>,\n      Route0._PathDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,\n      Route0._ParamsDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,\n      Route0._QueryDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>\n    >(pathOriginalDefinition, { baseUrl: this.baseUrl })\n  }\n\n  // has params\n  get(\n    input: Route0._OnlyIfHasParams<\n      TParamsDefinition,\n      Route0._WithParamsInput<TParamsDefinition, { query?: undefined; abs?: false }>\n    >,\n  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfHasParams<\n      TParamsDefinition,\n      Route0._WithParamsInput<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs?: false }>\n    >,\n  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfHasParams<\n      TParamsDefinition,\n      Route0._WithParamsInput<TParamsDefinition, { query?: undefined; abs: true }>\n    >,\n  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfHasParams<\n      TParamsDefinition,\n      Route0._WithParamsInput<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs: true }>\n    >,\n  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>\n\n  // no params\n  get(\n    ...args: Route0._OnlyIfNoParams<TParamsDefinition, [], [never]>\n  ): Route0._PathOnlyRouteValue<TPathOriginalDefinition>\n  get(\n    input: Route0._OnlyIfNoParams<TParamsDefinition, { query?: undefined; abs?: false }>,\n  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfNoParams<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs?: false }>,\n  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfNoParams<TParamsDefinition, { query?: undefined; abs: true }>,\n  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfNoParams<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs: true }>,\n  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>\n\n  // implementation\n  get(...args: any[]): string {\n    const { queryInput, paramsInput, absInput } = ((): {\n      queryInput: Record<string, string | number>\n      paramsInput: Record<string, string | number>\n      absInput: boolean\n    } => {\n      if (args.length === 0) {\n        return { queryInput: {}, paramsInput: {}, absInput: false }\n      }\n      const input = args[0]\n      if (typeof input !== 'object' || input === null) {\n        // throw new Error(\"Invalid get route input: expected object\")\n        return { queryInput: {}, paramsInput: {}, absInput: false }\n      }\n      const { query, abs, ...params } = input\n      return { queryInput: query || {}, paramsInput: params, absInput: abs ?? false }\n    })()\n\n    // validate params\n    const neededParamsKeys = Object.keys(this.paramsDefinition)\n    const providedParamsKeys = Object.keys(paramsInput)\n    const notProvidedKeys = neededParamsKeys.filter((k) => !providedParamsKeys.includes(k))\n    if (notProvidedKeys.length) {\n      // throw new Error(`Missing params: not defined keys ${notProvidedKeys.map((k) => `\"${k}\"`).join(\", \")}.`)\n      Object.assign(paramsInput, Object.fromEntries(notProvidedKeys.map((k) => [k, 'undefined'])))\n    }\n\n    // create url\n    let url = String(this.pathDefinition)\n    // replace params\n    url = url.replace(/:([A-Za-z0-9_]+)/g, (_m, k) => encodeURIComponent(String(paramsInput?.[k] ?? '')))\n    // query params\n    const queryInputStringified = Object.fromEntries(Object.entries(queryInput).map(([k, v]) => [k, String(v)]))\n    url = [url, new URLSearchParams(queryInputStringified).toString()].filter(Boolean).join('?')\n    // dedupe slashes\n    url = url.replace(/\\/{2,}/g, '/')\n    // absolute\n    url = absInput ? Route0._getAbsPath(this.baseUrl, url) : url\n\n    return url\n  }\n\n  getDefinition() {\n    return this.pathDefinition\n  }\n\n  clone(config?: Route0.RouteConfigInput) {\n    return new Route0(this.pathOriginalDefinition, config)\n  }\n}\n\nexport namespace Route0 {\n  export type Callable<T extends Route0<any, any, any, any>> = T & T['get']\n  export type RouteConfigInput = {\n    baseUrl?: string\n  }\n  export type Params<TRoute0 extends Route0<any, any, any, any>> = {\n    [K in keyof TRoute0['paramsDefinition']]: string\n  }\n  export type Query<TRoute0 extends Route0<any, any, any, any>> = Partial<\n    {\n      [K in keyof TRoute0['queryDefinition']]: string | undefined\n    } & Record<string, string | undefined>\n  >\n\n  export type _TrimQueryTailDefinition<S extends string> = S extends `${infer P}&${string}` ? P : S\n  export type _QueryTailDefinitionWithoutFirstAmp<S extends string> = S extends `${string}&${infer T}` ? T : ''\n  export type _QueryTailDefinitionWithFirstAmp<S extends string> = S extends `${string}&${infer T}` ? `&${T}` : ''\n  export type _AmpSplit<S extends string> = S extends `${infer A}&${infer B}` ? A | _AmpSplit<B> : S\n  export type _NonEmpty<T> = [T] extends ['' | never] ? never : T\n  export type _ExtractPathParams<S extends string> = S extends `${string}:${infer After}`\n    ? After extends `${infer Name}/${infer Rest}`\n      ? Name | _ExtractPathParams<`/${Rest}`>\n      : After\n    : never\n  export type _ReplacePathParams<S extends string> = S extends `${infer Head}:${infer Tail}`\n    ? Tail extends `${infer _Param}/${infer Rest}`\n      ? _ReplacePathParams<`${Head}${string}/${Rest}`>\n      : `${Head}${string}`\n    : S\n  export type _DedupeSlashes<S extends string> = S extends `${infer A}//${infer B}` ? _DedupeSlashes<`${A}/${B}`> : S\n  export type _EmptyRecord = Record<never, never>\n  export type _JoinPath<Parent extends string, Suffix extends string> = _DedupeSlashes<\n    Route0._PathDefinition<Parent> extends infer A extends string\n      ? _PathDefinition<Suffix> extends infer B extends string\n        ? A extends ''\n          ? B extends ''\n            ? ''\n            : B extends `/${string}`\n              ? B\n              : `/${B}`\n          : B extends ''\n            ? A\n            : A extends `${string}/`\n              ? `${A}${B}`\n              : B extends `/${string}`\n                ? `${A}${B}`\n                : `${A}/${B}`\n        : never\n      : never\n  >\n\n  export type _OnlyIfNoParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? Yes : No\n  export type _OnlyIfHasParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? No : Yes\n\n  export type _PathDefinition<TPathOriginalDefinition extends string> =\n    _TrimQueryTailDefinition<TPathOriginalDefinition>\n  export type _ParamsDefinition<TPathOriginalDefinition extends string> = _ExtractPathParams<\n    _PathDefinition<TPathOriginalDefinition>\n  > extends infer U\n    ? [U] extends [never]\n      ? _EmptyRecord\n      : { [K in Extract<U, string>]: true }\n    : _EmptyRecord\n  export type _QueryDefinition<TPathOriginalDefinition extends string> = _NonEmpty<\n    _QueryTailDefinitionWithoutFirstAmp<TPathOriginalDefinition>\n  > extends infer Tail extends string\n    ? _AmpSplit<Tail> extends infer U\n      ? [U] extends [never]\n        ? _EmptyRecord\n        : { [K in Extract<U, string>]: true }\n      : _EmptyRecord\n    : _EmptyRecord\n  export type _RoutePathOriginalDefinitionExtended<\n    TSourcePathOriginalDefinition extends string,\n    TSuffixPathOriginalDefinition extends string,\n  > = `${_JoinPath<TSourcePathOriginalDefinition, TSuffixPathOriginalDefinition>}${_QueryTailDefinitionWithFirstAmp<TSuffixPathOriginalDefinition>}`\n\n  export type _ParamsInput<TParamsDefinition extends object> = {\n    [K in keyof TParamsDefinition]: string | number\n  }\n  export type _QueryInput<TQueryDefinition extends object> = Partial<{\n    [K in keyof TQueryDefinition]: string | number\n  }> &\n    Record<string, string | number>\n  export type _WithParamsInput<\n    TParamsDefinition extends object,\n    T extends {\n      query?: _QueryInput<any>\n      abs?: boolean\n    },\n  > = _ParamsInput<TParamsDefinition> & T\n\n  export type _PathOnlyRouteValue<TPathOriginalDefinition extends string> =\n    `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}`\n  export type _WithQueryRouteValue<TPathOriginalDefinition extends string> =\n    `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}?${string}`\n  export type _AbsolutePathOnlyRouteValue<TPathOriginalDefinition extends string> =\n    `${string}${_PathOnlyRouteValue<TPathOriginalDefinition>}`\n  export type _AbsoluteWithQueryRouteValue<TPathOriginalDefinition extends string> =\n    `${string}${_WithQueryRouteValue<TPathOriginalDefinition>}`\n}\n"],"mappings":"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","names":[]}

package/dist/esm/index.d.ts

@@ -0,0 +1,99 @@
+declare class Route0<TPathOriginalDefinition extends string, TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>, TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>, TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>> {
+    pathOriginalDefinition: TPathOriginalDefinition;
+    private pathDefinition;
+    paramsDefinition: TParamsDefinition;
+    queryDefinition: TQueryDefinition;
+    baseUrl: string;
+    private constructor();
+    static create<TPathOriginalDefinition extends string, TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>, TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>, TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>>(definition: TPathOriginalDefinition, config?: Route0.RouteConfigInput): Route0.Callable<Route0<TPathOriginalDefinition, TPathDefinition, TParamsDefinition, TQueryDefinition>>;
+    private static _splitPathDefinitionAndQueryTailDefinition;
+    private static _getAbsPath;
+    private static _getPathDefinitionByOriginalDefinition;
+    private static _getParamsDefinitionByRouteDefinition;
+    private static _getQueryDefinitionByRouteDefinition;
+    static overrideMany<T extends Record<string, Route0<any, any, any, any>>>(routes: T, config: Route0.RouteConfigInput): T;
+    extend<TSuffixDefinition extends string>(suffixDefinition: TSuffixDefinition): Route0.Callable<Route0<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>, Route0._PathDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>, Route0._ParamsDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>, Route0._QueryDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>>>;
+    get(input: Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithParamsInput<TParamsDefinition, {
+        query?: undefined;
+        abs?: false;
+    }>>): Route0._OnlyIfHasParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithParamsInput<TParamsDefinition, {
+        query: Route0._QueryInput<TQueryDefinition>;
+        abs?: false;
+    }>>): Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithParamsInput<TParamsDefinition, {
+        query?: undefined;
+        abs: true;
+    }>>): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithParamsInput<TParamsDefinition, {
+        query: Route0._QueryInput<TQueryDefinition>;
+        abs: true;
+    }>>): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>;
+    get(...args: Route0._OnlyIfNoParams<TParamsDefinition, [], [never]>): Route0._PathOnlyRouteValue<TPathOriginalDefinition>;
+    get(input: Route0._OnlyIfNoParams<TParamsDefinition, {
+        query?: undefined;
+        abs?: false;
+    }>): Route0._OnlyIfNoParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfNoParams<TParamsDefinition, {
+        query: Route0._QueryInput<TQueryDefinition>;
+        abs?: false;
+    }>): Route0._OnlyIfNoParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfNoParams<TParamsDefinition, {
+        query?: undefined;
+        abs: true;
+    }>): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>;
+    get(input: Route0._OnlyIfNoParams<TParamsDefinition, {
+        query: Route0._QueryInput<TQueryDefinition>;
+        abs: true;
+    }>): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>;
+    getDefinition(): TPathDefinition;
+    clone(config?: Route0.RouteConfigInput): Route0<TPathOriginalDefinition, Route0._TrimQueryTailDefinition<TPathOriginalDefinition>, Route0._ParamsDefinition<TPathOriginalDefinition>, Route0._QueryDefinition<TPathOriginalDefinition>>;
+}
+declare namespace Route0 {
+    type Callable<T extends Route0<any, any, any, any>> = T & T['get'];
+    type RouteConfigInput = {
+        baseUrl?: string;
+    };
+    type Params<TRoute0 extends Route0<any, any, any, any>> = {
+        [K in keyof TRoute0['paramsDefinition']]: string;
+    };
+    type Query<TRoute0 extends Route0<any, any, any, any>> = Partial<{
+        [K in keyof TRoute0['queryDefinition']]: string | undefined;
+    } & Record<string, string | undefined>>;
+    type _TrimQueryTailDefinition<S extends string> = S extends `${infer P}&${string}` ? P : S;
+    type _QueryTailDefinitionWithoutFirstAmp<S extends string> = S extends `${string}&${infer T}` ? T : '';
+    type _QueryTailDefinitionWithFirstAmp<S extends string> = S extends `${string}&${infer T}` ? `&${T}` : '';
+    type _AmpSplit<S extends string> = S extends `${infer A}&${infer B}` ? A | _AmpSplit<B> : S;
+    type _NonEmpty<T> = [T] extends ['' | never] ? never : T;
+    type _ExtractPathParams<S extends string> = S extends `${string}:${infer After}` ? After extends `${infer Name}/${infer Rest}` ? Name | _ExtractPathParams<`/${Rest}`> : After : never;
+    type _ReplacePathParams<S extends string> = S extends `${infer Head}:${infer Tail}` ? Tail extends `${infer _Param}/${infer Rest}` ? _ReplacePathParams<`${Head}${string}/${Rest}`> : `${Head}${string}` : S;
+    type _DedupeSlashes<S extends string> = S extends `${infer A}//${infer B}` ? _DedupeSlashes<`${A}/${B}`> : S;
+    type _EmptyRecord = Record<never, never>;
+    type _JoinPath<Parent extends string, Suffix extends string> = _DedupeSlashes<Route0._PathDefinition<Parent> extends infer A extends string ? _PathDefinition<Suffix> extends infer B extends string ? A extends '' ? B extends '' ? '' : B extends `/${string}` ? B : `/${B}` : B extends '' ? A : A extends `${string}/` ? `${A}${B}` : B extends `/${string}` ? `${A}${B}` : `${A}/${B}` : never : never>;
+    type _OnlyIfNoParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? Yes : No;
+    type _OnlyIfHasParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? No : Yes;
+    type _PathDefinition<TPathOriginalDefinition extends string> = _TrimQueryTailDefinition<TPathOriginalDefinition>;
+    type _ParamsDefinition<TPathOriginalDefinition extends string> = _ExtractPathParams<_PathDefinition<TPathOriginalDefinition>> extends infer U ? [U] extends [never] ? _EmptyRecord : {
+        [K in Extract<U, string>]: true;
+    } : _EmptyRecord;
+    type _QueryDefinition<TPathOriginalDefinition extends string> = _NonEmpty<_QueryTailDefinitionWithoutFirstAmp<TPathOriginalDefinition>> extends infer Tail extends string ? _AmpSplit<Tail> extends infer U ? [U] extends [never] ? _EmptyRecord : {
+        [K in Extract<U, string>]: true;
+    } : _EmptyRecord : _EmptyRecord;
+    type _RoutePathOriginalDefinitionExtended<TSourcePathOriginalDefinition extends string, TSuffixPathOriginalDefinition extends string> = `${_JoinPath<TSourcePathOriginalDefinition, TSuffixPathOriginalDefinition>}${_QueryTailDefinitionWithFirstAmp<TSuffixPathOriginalDefinition>}`;
+    type _ParamsInput<TParamsDefinition extends object> = {
+        [K in keyof TParamsDefinition]: string | number;
+    };
+    type _QueryInput<TQueryDefinition extends object> = Partial<{
+        [K in keyof TQueryDefinition]: string | number;
+    }> & Record<string, string | number>;
+    type _WithParamsInput<TParamsDefinition extends object, T extends {
+        query?: _QueryInput<any>;
+        abs?: boolean;
+    }> = _ParamsInput<TParamsDefinition> & T;
+    type _PathOnlyRouteValue<TPathOriginalDefinition extends string> = `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}`;
+    type _WithQueryRouteValue<TPathOriginalDefinition extends string> = `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}?${string}`;
+    type _AbsolutePathOnlyRouteValue<TPathOriginalDefinition extends string> = `${string}${_PathOnlyRouteValue<TPathOriginalDefinition>}`;
+    type _AbsoluteWithQueryRouteValue<TPathOriginalDefinition extends string> = `${string}${_WithQueryRouteValue<TPathOriginalDefinition>}`;
+}
+
+export { Route0 };

package/dist/esm/index.js

@@ -0,0 +1,134 @@
+class Route0 {
+  pathOriginalDefinition;
+  pathDefinition;
+  paramsDefinition;
+  queryDefinition;
+  baseUrl;
+  constructor(definition, config = {}) {
+    this.pathOriginalDefinition = definition;
+    this.pathDefinition = Route0._getPathDefinitionByOriginalDefinition(definition);
+    this.paramsDefinition = Route0._getParamsDefinitionByRouteDefinition(definition);
+    this.queryDefinition = Route0._getQueryDefinitionByRouteDefinition(definition);
+    const { baseUrl } = config;
+    if (baseUrl && typeof baseUrl === "string" && baseUrl.length) {
+      this.baseUrl = baseUrl;
+    } else {
+      const g = globalThis;
+      if (g?.location?.origin) {
+        this.baseUrl = g.location.origin;
+      } else {
+        this.baseUrl = "https://example.com";
+      }
+    }
+  }
+  static create(definition, config) {
+    const original = new Route0(
+      definition,
+      config
+    );
+    const callable = original.get.bind(original);
+    const proxy = new Proxy(callable, {
+      get(_target, prop, receiver) {
+        const value = original[prop];
+        if (typeof value === "function") {
+          return value.bind(original);
+        }
+        return value;
+      },
+      set(_target, prop, value, receiver) {
+        ;
+        original[prop] = value;
+        return true;
+      },
+      has(_target, prop) {
+        return prop in original;
+      }
+    });
+    Object.setPrototypeOf(proxy, Route0.prototype);
+    return proxy;
+  }
+  static _splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition) {
+    const i = pathOriginalDefinition.indexOf("&");
+    if (i === -1) return { pathDefinition: pathOriginalDefinition, queryTailDefinition: "" };
+    return {
+      pathDefinition: pathOriginalDefinition.slice(0, i),
+      queryTailDefinition: pathOriginalDefinition.slice(i)
+    };
+  }
+  static _getAbsPath(baseUrl, pathWithQuery) {
+    return new URL(pathWithQuery, baseUrl).toString().replace(/\/$/, "");
+  }
+  static _getPathDefinitionByOriginalDefinition(pathOriginalDefinition) {
+    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition);
+    return pathDefinition;
+  }
+  static _getParamsDefinitionByRouteDefinition(pathOriginalDefinition) {
+    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition);
+    const matches = Array.from(pathDefinition.matchAll(/:([A-Za-z0-9_]+)/g));
+    const paramsDefinition = Object.fromEntries(matches.map((m) => [m[1], true]));
+    return paramsDefinition;
+  }
+  static _getQueryDefinitionByRouteDefinition(pathOriginalDefinition) {
+    const { queryTailDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition);
+    if (!queryTailDefinition) {
+      return {};
+    }
+    const keys = queryTailDefinition.split("&").map(Boolean);
+    const queryDefinition = Object.fromEntries(keys.map((k) => [k, true]));
+    return queryDefinition;
+  }
+  static overrideMany(routes, config) {
+    const result = {};
+    for (const [key, value] of Object.entries(routes)) {
+      ;
+      result[key] = value.clone(config);
+    }
+    return result;
+  }
+  extend(suffixDefinition) {
+    const { pathDefinition: parentPathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(
+      this.pathOriginalDefinition
+    );
+    const { pathDefinition: suffixPathDefinition, queryTailDefinition: suffixQueryTailDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(suffixDefinition);
+    const pathDefinition = `${parentPathDefinition}/${suffixPathDefinition}`.replace(/\/{2,}/g, "/");
+    const pathOriginalDefinition = `${pathDefinition}${suffixQueryTailDefinition}`;
+    return Route0.create(pathOriginalDefinition, { baseUrl: this.baseUrl });
+  }
+  // implementation
+  get(...args) {
+    const { queryInput, paramsInput, absInput } = (() => {
+      if (args.length === 0) {
+        return { queryInput: {}, paramsInput: {}, absInput: false };
+      }
+      const input = args[0];
+      if (typeof input !== "object" || input === null) {
+        return { queryInput: {}, paramsInput: {}, absInput: false };
+      }
+      const { query, abs, ...params } = input;
+      return { queryInput: query || {}, paramsInput: params, absInput: abs ?? false };
+    })();
+    const neededParamsKeys = Object.keys(this.paramsDefinition);
+    const providedParamsKeys = Object.keys(paramsInput);
+    const notProvidedKeys = neededParamsKeys.filter((k) => !providedParamsKeys.includes(k));
+    if (notProvidedKeys.length) {
+      Object.assign(paramsInput, Object.fromEntries(notProvidedKeys.map((k) => [k, "undefined"])));
+    }
+    let url = String(this.pathDefinition);
+    url = url.replace(/:([A-Za-z0-9_]+)/g, (_m, k) => encodeURIComponent(String(paramsInput?.[k] ?? "")));
+    const queryInputStringified = Object.fromEntries(Object.entries(queryInput).map(([k, v]) => [k, String(v)]));
+    url = [url, new URLSearchParams(queryInputStringified).toString()].filter(Boolean).join("?");
+    url = url.replace(/\/{2,}/g, "/");
+    url = absInput ? Route0._getAbsPath(this.baseUrl, url) : url;
+    return url;
+  }
+  getDefinition() {
+    return this.pathDefinition;
+  }
+  clone(config) {
+    return new Route0(this.pathOriginalDefinition, config);
+  }
+}
+export {
+  Route0
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["// TODO: use splats in param definition \"*\"\n// TODO: ? check extend for query only .extend('&x&z')\n// TODO: .create(route, {useQuery, useParams})\n// TODO: Из пас экзакт, из пасвизквери экзает, из чилдрен, из парент, из экзактОр\n// TODO: isEqual, isChildren, isParent\n// TODO: extractParams, extractQuery\n// TODO: getPathDefinition respecting definitionParamPrefix, definitionQueryPrefix\n// TODO: prepend\n// TODO: Route0.createTree({base:{self: x, children: ...})\n// TODO: overrideTree\n// TODO: .create(route, {baseUrl, useLocation})\n// TODO: ? optional path params as @\n// TODO: prependMany, extendMany, overrideMany, with types\n\nexport class Route0<\n  TPathOriginalDefinition extends string,\n  TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>,\n  TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>,\n  TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>,\n> {\n  pathOriginalDefinition: TPathOriginalDefinition\n  private pathDefinition: TPathDefinition\n  paramsDefinition: TParamsDefinition\n  queryDefinition: TQueryDefinition\n  baseUrl: string\n\n  private constructor(definition: TPathOriginalDefinition, config: Route0.RouteConfigInput = {}) {\n    this.pathOriginalDefinition = definition as TPathOriginalDefinition\n    this.pathDefinition = Route0._getPathDefinitionByOriginalDefinition(definition) as TPathDefinition\n    this.paramsDefinition = Route0._getParamsDefinitionByRouteDefinition(definition) as TParamsDefinition\n    this.queryDefinition = Route0._getQueryDefinitionByRouteDefinition(definition) as TQueryDefinition\n\n    const { baseUrl } = config\n    if (baseUrl && typeof baseUrl === 'string' && baseUrl.length) {\n      this.baseUrl = baseUrl\n    } else {\n      const g = globalThis as unknown as { location?: { origin?: string } }\n      if (g?.location?.origin) {\n        this.baseUrl = g.location.origin\n      } else {\n        this.baseUrl = 'https://example.com'\n      }\n    }\n  }\n\n  static create<\n    TPathOriginalDefinition extends string,\n    TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>,\n    TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>,\n    TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>,\n  >(\n    definition: TPathOriginalDefinition,\n    config?: Route0.RouteConfigInput,\n  ): Route0.Callable<Route0<TPathOriginalDefinition, TPathDefinition, TParamsDefinition, TQueryDefinition>> {\n    const original = new Route0<TPathOriginalDefinition, TPathDefinition, TParamsDefinition, TQueryDefinition>(\n      definition,\n      config,\n    )\n    const callable = original.get.bind(original)\n    const proxy = new Proxy(callable, {\n      get(_target, prop, receiver) {\n        const value = (original as any)[prop]\n        if (typeof value === 'function') {\n          return value.bind(original)\n        }\n        return value\n      },\n      set(_target, prop, value, receiver) {\n        ;(original as any)[prop] = value\n        return true\n      },\n      has(_target, prop) {\n        return prop in original\n      },\n    })\n    Object.setPrototypeOf(proxy, Route0.prototype)\n    return proxy as never\n  }\n\n  private static _splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition: string) {\n    const i = pathOriginalDefinition.indexOf('&')\n    if (i === -1) return { pathDefinition: pathOriginalDefinition, queryTailDefinition: '' }\n    return {\n      pathDefinition: pathOriginalDefinition.slice(0, i),\n      queryTailDefinition: pathOriginalDefinition.slice(i),\n    }\n  }\n\n  private static _getAbsPath(baseUrl: string, pathWithQuery: string) {\n    return new URL(pathWithQuery, baseUrl).toString().replace(/\\/$/, '')\n  }\n\n  private static _getPathDefinitionByOriginalDefinition<TPathOriginalDefinition extends string>(\n    pathOriginalDefinition: TPathOriginalDefinition,\n  ) {\n    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition)\n    return pathDefinition as Route0._PathDefinition<TPathOriginalDefinition>\n  }\n\n  private static _getParamsDefinitionByRouteDefinition<TPathOriginalDefinition extends string>(\n    pathOriginalDefinition: TPathOriginalDefinition,\n  ) {\n    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition)\n    const matches = Array.from(pathDefinition.matchAll(/:([A-Za-z0-9_]+)/g))\n    const paramsDefinition = Object.fromEntries(matches.map((m) => [m[1], true]))\n    return paramsDefinition as Route0._ParamsDefinition<TPathOriginalDefinition>\n  }\n\n  private static _getQueryDefinitionByRouteDefinition<TPathOriginalDefinition extends string>(\n    pathOriginalDefinition: TPathOriginalDefinition,\n  ) {\n    const { queryTailDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition)\n    if (!queryTailDefinition) {\n      return {} as Route0._QueryDefinition<TPathOriginalDefinition>\n    }\n    const keys = queryTailDefinition.split('&').map(Boolean)\n    const queryDefinition = Object.fromEntries(keys.map((k) => [k, true]))\n    return queryDefinition as Route0._QueryDefinition<TPathOriginalDefinition>\n  }\n\n  static overrideMany<T extends Record<string, Route0<any, any, any, any>>>(\n    routes: T,\n    config: Route0.RouteConfigInput,\n  ): T {\n    const result = {} as T\n    for (const [key, value] of Object.entries(routes)) {\n      ;(result as any)[key] = value.clone(config)\n    }\n    return result\n  }\n\n  extend<TSuffixDefinition extends string>(\n    suffixDefinition: TSuffixDefinition,\n  ): Route0.Callable<\n    Route0<\n      Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>,\n      Route0._PathDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,\n      Route0._ParamsDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,\n      Route0._QueryDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>\n    >\n  > {\n    const { pathDefinition: parentPathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(\n      this.pathOriginalDefinition,\n    )\n    const { pathDefinition: suffixPathDefinition, queryTailDefinition: suffixQueryTailDefinition } =\n      Route0._splitPathDefinitionAndQueryTailDefinition(suffixDefinition)\n    const pathDefinition = `${parentPathDefinition}/${suffixPathDefinition}`.replace(/\\/{2,}/g, '/')\n    const pathOriginalDefinition =\n      `${pathDefinition}${suffixQueryTailDefinition}` as Route0._RoutePathOriginalDefinitionExtended<\n        TPathOriginalDefinition,\n        TSuffixDefinition\n      >\n    return Route0.create<\n      Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>,\n      Route0._PathDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,\n      Route0._ParamsDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,\n      Route0._QueryDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>\n    >(pathOriginalDefinition, { baseUrl: this.baseUrl })\n  }\n\n  // has params\n  get(\n    input: Route0._OnlyIfHasParams<\n      TParamsDefinition,\n      Route0._WithParamsInput<TParamsDefinition, { query?: undefined; abs?: false }>\n    >,\n  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfHasParams<\n      TParamsDefinition,\n      Route0._WithParamsInput<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs?: false }>\n    >,\n  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfHasParams<\n      TParamsDefinition,\n      Route0._WithParamsInput<TParamsDefinition, { query?: undefined; abs: true }>\n    >,\n  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfHasParams<\n      TParamsDefinition,\n      Route0._WithParamsInput<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs: true }>\n    >,\n  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>\n\n  // no params\n  get(\n    ...args: Route0._OnlyIfNoParams<TParamsDefinition, [], [never]>\n  ): Route0._PathOnlyRouteValue<TPathOriginalDefinition>\n  get(\n    input: Route0._OnlyIfNoParams<TParamsDefinition, { query?: undefined; abs?: false }>,\n  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfNoParams<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs?: false }>,\n  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfNoParams<TParamsDefinition, { query?: undefined; abs: true }>,\n  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>\n  get(\n    input: Route0._OnlyIfNoParams<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs: true }>,\n  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>\n\n  // implementation\n  get(...args: any[]): string {\n    const { queryInput, paramsInput, absInput } = ((): {\n      queryInput: Record<string, string | number>\n      paramsInput: Record<string, string | number>\n      absInput: boolean\n    } => {\n      if (args.length === 0) {\n        return { queryInput: {}, paramsInput: {}, absInput: false }\n      }\n      const input = args[0]\n      if (typeof input !== 'object' || input === null) {\n        // throw new Error(\"Invalid get route input: expected object\")\n        return { queryInput: {}, paramsInput: {}, absInput: false }\n      }\n      const { query, abs, ...params } = input\n      return { queryInput: query || {}, paramsInput: params, absInput: abs ?? false }\n    })()\n\n    // validate params\n    const neededParamsKeys = Object.keys(this.paramsDefinition)\n    const providedParamsKeys = Object.keys(paramsInput)\n    const notProvidedKeys = neededParamsKeys.filter((k) => !providedParamsKeys.includes(k))\n    if (notProvidedKeys.length) {\n      // throw new Error(`Missing params: not defined keys ${notProvidedKeys.map((k) => `\"${k}\"`).join(\", \")}.`)\n      Object.assign(paramsInput, Object.fromEntries(notProvidedKeys.map((k) => [k, 'undefined'])))\n    }\n\n    // create url\n    let url = String(this.pathDefinition)\n    // replace params\n    url = url.replace(/:([A-Za-z0-9_]+)/g, (_m, k) => encodeURIComponent(String(paramsInput?.[k] ?? '')))\n    // query params\n    const queryInputStringified = Object.fromEntries(Object.entries(queryInput).map(([k, v]) => [k, String(v)]))\n    url = [url, new URLSearchParams(queryInputStringified).toString()].filter(Boolean).join('?')\n    // dedupe slashes\n    url = url.replace(/\\/{2,}/g, '/')\n    // absolute\n    url = absInput ? Route0._getAbsPath(this.baseUrl, url) : url\n\n    return url\n  }\n\n  getDefinition() {\n    return this.pathDefinition\n  }\n\n  clone(config?: Route0.RouteConfigInput) {\n    return new Route0(this.pathOriginalDefinition, config)\n  }\n}\n\nexport namespace Route0 {\n  export type Callable<T extends Route0<any, any, any, any>> = T & T['get']\n  export type RouteConfigInput = {\n    baseUrl?: string\n  }\n  export type Params<TRoute0 extends Route0<any, any, any, any>> = {\n    [K in keyof TRoute0['paramsDefinition']]: string\n  }\n  export type Query<TRoute0 extends Route0<any, any, any, any>> = Partial<\n    {\n      [K in keyof TRoute0['queryDefinition']]: string | undefined\n    } & Record<string, string | undefined>\n  >\n\n  export type _TrimQueryTailDefinition<S extends string> = S extends `${infer P}&${string}` ? P : S\n  export type _QueryTailDefinitionWithoutFirstAmp<S extends string> = S extends `${string}&${infer T}` ? T : ''\n  export type _QueryTailDefinitionWithFirstAmp<S extends string> = S extends `${string}&${infer T}` ? `&${T}` : ''\n  export type _AmpSplit<S extends string> = S extends `${infer A}&${infer B}` ? A | _AmpSplit<B> : S\n  export type _NonEmpty<T> = [T] extends ['' | never] ? never : T\n  export type _ExtractPathParams<S extends string> = S extends `${string}:${infer After}`\n    ? After extends `${infer Name}/${infer Rest}`\n      ? Name | _ExtractPathParams<`/${Rest}`>\n      : After\n    : never\n  export type _ReplacePathParams<S extends string> = S extends `${infer Head}:${infer Tail}`\n    ? Tail extends `${infer _Param}/${infer Rest}`\n      ? _ReplacePathParams<`${Head}${string}/${Rest}`>\n      : `${Head}${string}`\n    : S\n  export type _DedupeSlashes<S extends string> = S extends `${infer A}//${infer B}` ? _DedupeSlashes<`${A}/${B}`> : S\n  export type _EmptyRecord = Record<never, never>\n  export type _JoinPath<Parent extends string, Suffix extends string> = _DedupeSlashes<\n    Route0._PathDefinition<Parent> extends infer A extends string\n      ? _PathDefinition<Suffix> extends infer B extends string\n        ? A extends ''\n          ? B extends ''\n            ? ''\n            : B extends `/${string}`\n              ? B\n              : `/${B}`\n          : B extends ''\n            ? A\n            : A extends `${string}/`\n              ? `${A}${B}`\n              : B extends `/${string}`\n                ? `${A}${B}`\n                : `${A}/${B}`\n        : never\n      : never\n  >\n\n  export type _OnlyIfNoParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? Yes : No\n  export type _OnlyIfHasParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? No : Yes\n\n  export type _PathDefinition<TPathOriginalDefinition extends string> =\n    _TrimQueryTailDefinition<TPathOriginalDefinition>\n  export type _ParamsDefinition<TPathOriginalDefinition extends string> = _ExtractPathParams<\n    _PathDefinition<TPathOriginalDefinition>\n  > extends infer U\n    ? [U] extends [never]\n      ? _EmptyRecord\n      : { [K in Extract<U, string>]: true }\n    : _EmptyRecord\n  export type _QueryDefinition<TPathOriginalDefinition extends string> = _NonEmpty<\n    _QueryTailDefinitionWithoutFirstAmp<TPathOriginalDefinition>\n  > extends infer Tail extends string\n    ? _AmpSplit<Tail> extends infer U\n      ? [U] extends [never]\n        ? _EmptyRecord\n        : { [K in Extract<U, string>]: true }\n      : _EmptyRecord\n    : _EmptyRecord\n  export type _RoutePathOriginalDefinitionExtended<\n    TSourcePathOriginalDefinition extends string,\n    TSuffixPathOriginalDefinition extends string,\n  > = `${_JoinPath<TSourcePathOriginalDefinition, TSuffixPathOriginalDefinition>}${_QueryTailDefinitionWithFirstAmp<TSuffixPathOriginalDefinition>}`\n\n  export type _ParamsInput<TParamsDefinition extends object> = {\n    [K in keyof TParamsDefinition]: string | number\n  }\n  export type _QueryInput<TQueryDefinition extends object> = Partial<{\n    [K in keyof TQueryDefinition]: string | number\n  }> &\n    Record<string, string | number>\n  export type _WithParamsInput<\n    TParamsDefinition extends object,\n    T extends {\n      query?: _QueryInput<any>\n      abs?: boolean\n    },\n  > = _ParamsInput<TParamsDefinition> & T\n\n  export type _PathOnlyRouteValue<TPathOriginalDefinition extends string> =\n    `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}`\n  export type _WithQueryRouteValue<TPathOriginalDefinition extends string> =\n    `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}?${string}`\n  export type _AbsolutePathOnlyRouteValue<TPathOriginalDefinition extends string> =\n    `${string}${_PathOnlyRouteValue<TPathOriginalDefinition>}`\n  export type _AbsoluteWithQueryRouteValue<TPathOriginalDefinition extends string> =\n    `${string}${_WithQueryRouteValue<TPathOriginalDefinition>}`\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@devp0nt/route0",
+  "license": "MIT",
+  "author": {
+    "name": "Sergei Dmitriev",
+    "url": "https://p0nt.dev"
+  },
+  "homepage": "https://github.com/devp0nt/route0#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devp0nt/route0.git"
+  },
+  "bugs": {
+    "url": "https://github.com/devp0nt/route0/issues"
+  },
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsc --watch --preserveWatchOutput --project tsconfig.build.json",
+    "build": "tsup",
+    "build:test:esm": "tsup --outDir dist-test/esm --tsconfig tsconfig.build.test.json --format esm src",
+    "build:test:esm:watch": "bun run build:test:esm --watch",
+    "build:test:cjs": "tsup --outDir dist-test/cjs --tsconfig tsconfig.build.test.json --format cjs src",
+    "build:test:cjs:watch": "bun run build:test:cjs --watch",
+    "build:test": "bun run build:test:esm && bun run build:test:cjs",
+    "build:test:watch": "bun run build:test:esm:watch & bun run build:test:cjs:watch",
+    "build:all": "bun run build && bun run build:test",
+    "test": "bun test src",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "test:dist:esm": "bun test dist-test/esm",
+    "test:dist:esm:watch": "bun run test:dist:esm --watch",
+    "test:dist:esm:build:watch": "bun build:test:esm:watch --no-clean & bun test:dist:esm:watch",
+    "test:dist:cjs": "bun test dist-test/cjs",
+    "test:dist:cjs:watch": "bun run test:dist:cjs --watch",
+    "test:dist:cjs:build:watch": "bun build:test:cjs:watch --no-clean & bun test:dist:cjs:watch",
+    "test:dist": "bun run test:dist:esm && bun run test:dist:cjs",
+    "test:dist:watch": "bun run test:dist:esm:watch & bun run test:dist:cjs:watch",
+    "test:dist:build:watch": "bun build:test:watch & bun test:dist:watch",
+    "test:all": "bun run test && bun run test:dist",
+    "test:all:watch": "bun run test:watch & bun run test:dist:watch",
+    "test:all:build": "bun run build:all && bun run test:all",
+    "test:all:build:watch": "bun run build:all:watch & bun run test:all:watch",
+    "lint": "biome check --write",
+    "types:build": "tsc --noEmit --project tsconfig.build.json",
+    "types:dev": "tsc --noEmit",
+    "types": "bun run types:dev",
+    "pack:dry": "npm pack --dry-run",
+    "prepare": "husky"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@biomejs/biome": "^2.2.4",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.6",
+    "@semantic-release/npm": "^12.0.2",
+    "@types/bun": "^1.2.22",
+    "@types/node": "^20.0.0",
+    "cross-env": "^10.0.0",
+    "husky": "^9.1.7",
+    "semantic-release": "^24.2.8",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "bun": ">=1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "1.0.0-next.1"
+}

package/src/index.test.ts

@@ -0,0 +1,206 @@
+import { describe, expect, expectTypeOf, it } from 'bun:test'
+import { Route0 } from './index.js'
+
+describe('route0', () => {
+  it('simple', () => {
+    const route0 = Route0.create('/')
+    const path = route0.get()
+    expect(route0).toBeInstanceOf(Route0)
+    expectTypeOf<typeof path>().toEqualTypeOf<'/'>()
+    expect(path).toBe('/')
+  })
+
+  it('simple, callable', () => {
+    const route0 = Route0.create('/')
+    const path = route0()
+    expect(route0).toBeInstanceOf(Route0)
+    expectTypeOf<typeof path>().toEqualTypeOf<'/'>()
+    expect(path).toBe('/')
+  })
+
+  it('simple any query', () => {
+    const route0 = Route0.create('/')
+    const path = route0.get({ query: { q: '1' } })
+    expectTypeOf<typeof path>().toEqualTypeOf<`/?${string}`>()
+    expect(path).toBe('/?q=1')
+  })
+
+  it('params', () => {
+    const route0 = Route0.create('/prefix/:x/some/:y/:z')
+    const path = route0.get({ x: '1', y: 2, z: '3' })
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix/${string}/some/${string}/${string}`>()
+    expect(path).toBe('/prefix/1/some/2/3')
+  })
+
+  it('params and any query', () => {
+    const route0 = Route0.create('/prefix/:x/some/:y/:z')
+    const path = route0.get({ x: '1', y: 2, z: '3', query: { q: '1' } })
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix/${string}/some/${string}/${string}?${string}`>()
+    expect(path).toBe('/prefix/1/some/2/3?q=1')
+  })
+
+  it('query', () => {
+    const route0 = Route0.create('/prefix&y&z')
+    expectTypeOf<(typeof route0)['queryDefinition']>().toEqualTypeOf<{ y: true; z: true }>()
+    const path = route0.get({ query: { y: '1', z: '2' } })
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix?${string}`>()
+    expect(path).toBe('/prefix?y=1&z=2')
+  })
+
+  it('params and query', () => {
+    const route0 = Route0.create('/prefix/:x/some/:y/:z&z&c')
+    const path = route0.get({ x: '1', y: '2', z: '3', query: { z: '4', c: '5' } })
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix/${string}/some/${string}/${string}?${string}`>()
+    expect(path).toBe('/prefix/1/some/2/3?z=4&c=5')
+  })
+
+  it('params and query and any query', () => {
+    const route0 = Route0.create('/prefix/:x/some/:y/:z&z&c')
+    const path = route0.get({ x: '1', y: '2', z: '3', query: { z: '4', c: '5', o: '6' } })
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix/${string}/some/${string}/${string}?${string}`>()
+    expect(path).toBe('/prefix/1/some/2/3?z=4&c=5&o=6')
+  })
+
+  it('simple extend', () => {
+    const route0 = Route0.create('/prefix')
+    const route1 = route0.extend('/suffix')
+    const path = route1.get()
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix/suffix`>()
+    expect(path).toBe('/prefix/suffix')
+  })
+
+  it('simple extend double slash', () => {
+    const route0 = Route0.create('/')
+    const route1 = route0.extend('/suffix1/')
+    const route2 = route1.extend('/suffix2')
+    const path = route2.get()
+    expectTypeOf<typeof path>().toEqualTypeOf<`/suffix1/suffix2`>()
+    expect(path).toBe('/suffix1/suffix2')
+  })
+
+  it('simple extend no slash', () => {
+    const route0 = Route0.create('/')
+    const route1 = route0.extend('suffix1')
+    const route2 = route1.extend('suffix2')
+    const path = route2.get()
+    expectTypeOf<typeof path>().toEqualTypeOf<`/suffix1/suffix2`>()
+    expect(path).toBe('/suffix1/suffix2')
+  })
+
+  it('extend with params', () => {
+    const route0 = Route0.create('/prefix/:x')
+    const route1 = route0.extend('/suffix/:y')
+    const path = route1.get({ x: '1', y: '2' })
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix/${string}/suffix/${string}`>()
+    expect(path).toBe('/prefix/1/suffix/2')
+  })
+
+  it('extend with search params', () => {
+    const route0 = Route0.create('/prefix&y&z')
+    const route1 = route0.extend('/suffix&z&c')
+    const path = route1.get({ query: { y: '2', c: '3', a: '4' } })
+    expectTypeOf<(typeof route1)['queryDefinition']>().toEqualTypeOf<{
+      z: true
+      c: true
+    }>()
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix/suffix?${string}`>()
+    expect(path).toBe('/prefix/suffix?y=2&c=3&a=4')
+    const path1 = route1.get()
+    expectTypeOf<typeof path1>().toEqualTypeOf<`/prefix/suffix`>()
+    expect(path1).toBe('/prefix/suffix')
+  })
+
+  it('extend with params and query', () => {
+    const route0 = Route0.create('/prefix/:id&y&z')
+    const route1 = route0.extend('/:sn/suffix&z&c')
+    const path = route1.get({ id: 'myid', sn: 'mysn', query: { y: '2', c: '3', a: '4' } })
+    expectTypeOf<(typeof route1)['queryDefinition']>().toEqualTypeOf<{
+      z: true
+      c: true
+    }>()
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix/${string}/${string}/suffix?${string}`>()
+    expect(path).toBe('/prefix/myid/mysn/suffix?y=2&c=3&a=4')
+    const path1 = route1.get({ id: 'myid', sn: 'mysn' })
+    expectTypeOf<typeof path1>().toEqualTypeOf<`/prefix/${string}/${string}/suffix`>()
+    expect(path1).toBe('/prefix/myid/mysn/suffix')
+  })
+
+  it('extend with params and query, callable', () => {
+    const route0 = Route0.create('/prefix/:id&y&z')
+    const route1 = route0.extend('/:sn/suffix&z&c')
+    const path = route1({ id: 'myid', sn: 'mysn', query: { y: '2', c: '3', a: '4' } })
+    expectTypeOf<(typeof route1)['queryDefinition']>().toEqualTypeOf<{
+      z: true
+      c: true
+    }>()
+    expectTypeOf<typeof path>().toEqualTypeOf<`/prefix/${string}/${string}/suffix?${string}`>()
+    expect(path).toBe('/prefix/myid/mysn/suffix?y=2&c=3&a=4')
+    const path1 = route1({ id: 'myid', sn: 'mysn' })
+    expectTypeOf<typeof path1>().toEqualTypeOf<`/prefix/${string}/${string}/suffix`>()
+    expect(path1).toBe('/prefix/myid/mysn/suffix')
+  })
+
+  it('abs default', () => {
+    const route0 = Route0.create('/path')
+    const path = route0.get({ abs: true })
+    expectTypeOf<typeof path>().toEqualTypeOf<`${string}/path`>()
+    expect(path).toBe('https://example.com/path')
+  })
+
+  it('abs set', () => {
+    const route0 = Route0.create('/path', { baseUrl: 'https://x.com' })
+    const path = route0.get({ abs: true })
+    expectTypeOf<typeof path>().toEqualTypeOf<`${string}/path`>()
+    expect(path).toBe('https://x.com/path')
+  })
+
+  it('abs override', () => {
+    const route0 = Route0.create('/path', { baseUrl: 'https://x.com' })
+    route0.baseUrl = 'https://y.com'
+    const path = route0.get({ abs: true })
+    expectTypeOf<typeof path>().toEqualTypeOf<`${string}/path`>()
+    expect(path).toBe('https://y.com/path')
+  })
+
+  it('abs override extend', () => {
+    const route0 = Route0.create('/path', { baseUrl: 'https://x.com' })
+    route0.baseUrl = 'https://y.com'
+    const route1 = route0.extend('/suffix')
+    const path = route1.get({ abs: true })
+    expectTypeOf<typeof path>().toEqualTypeOf<`${string}/path/suffix`>()
+    expect(path).toBe('https://y.com/path/suffix')
+  })
+
+  it('abs override many', () => {
+    const route0 = Route0.create('/path', { baseUrl: 'https://x.com' })
+    const route1 = route0.extend('/suffix')
+    const routes = {
+      r0: route0,
+      r1: route1,
+    }
+    const routes2 = Route0.overrideMany(routes, { baseUrl: 'https://z.com' })
+    const path = routes2.r1.get({ abs: true })
+    expectTypeOf<typeof path>().toEqualTypeOf<`${string}/path/suffix`>()
+    expect(path).toBe('https://z.com/path/suffix')
+  })
+
+  it('type errors: require params when defined', () => {
+    const rWith = Route0.create('/a/:id')
+    // @ts-expect-error missing required path params
+    expect(rWith.get()).toBe('/a/undefined')
+
+    // @ts-expect-error missing required path params
+    expect(rWith.get({})).toBe('/a/undefined')
+    // @ts-expect-error missing required path params (object form abs)
+    expect(rWith.get({ abs: true })).toBe('https://example.com/a/undefined')
+    // @ts-expect-error missing required path params (object form query)
+    expect(rWith.get({ query: { q: '1' } })).toBe('/a/undefined?q=1')
+
+    // @ts-expect-error params can not be sent as object value it should be argument
+    rWith.get({ params: { id: '1' } }) // not throw becouse this will not used
+
+    const rNo = Route0.create('/b')
+    // @ts-expect-error no path params allowed for this route (shorthand)
+    expect(rNo.get({ id: '1' })).toBe('/b')
+  })
+})

package/src/index.ts

@@ -0,0 +1,356 @@
+// TODO: use splats in param definition "*"
+// TODO: ? check extend for query only .extend('&x&z')
+// TODO: .create(route, {useQuery, useParams})
+// TODO: Из пас экзакт, из пасвизквери экзает, из чилдрен, из парент, из экзактОр
+// TODO: isEqual, isChildren, isParent
+// TODO: extractParams, extractQuery
+// TODO: getPathDefinition respecting definitionParamPrefix, definitionQueryPrefix
+// TODO: prepend
+// TODO: Route0.createTree({base:{self: x, children: ...})
+// TODO: overrideTree
+// TODO: .create(route, {baseUrl, useLocation})
+// TODO: ? optional path params as @
+// TODO: prependMany, extendMany, overrideMany, with types
+
+export class Route0<
+  TPathOriginalDefinition extends string,
+  TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>,
+  TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>,
+  TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>,
+> {
+  pathOriginalDefinition: TPathOriginalDefinition
+  private pathDefinition: TPathDefinition
+  paramsDefinition: TParamsDefinition
+  queryDefinition: TQueryDefinition
+  baseUrl: string
+
+  private constructor(definition: TPathOriginalDefinition, config: Route0.RouteConfigInput = {}) {
+    this.pathOriginalDefinition = definition as TPathOriginalDefinition
+    this.pathDefinition = Route0._getPathDefinitionByOriginalDefinition(definition) as TPathDefinition
+    this.paramsDefinition = Route0._getParamsDefinitionByRouteDefinition(definition) as TParamsDefinition
+    this.queryDefinition = Route0._getQueryDefinitionByRouteDefinition(definition) as TQueryDefinition
+
+    const { baseUrl } = config
+    if (baseUrl && typeof baseUrl === 'string' && baseUrl.length) {
+      this.baseUrl = baseUrl
+    } else {
+      const g = globalThis as unknown as { location?: { origin?: string } }
+      if (g?.location?.origin) {
+        this.baseUrl = g.location.origin
+      } else {
+        this.baseUrl = 'https://example.com'
+      }
+    }
+  }
+
+  static create<
+    TPathOriginalDefinition extends string,
+    TPathDefinition extends Route0._PathDefinition<TPathOriginalDefinition>,
+    TParamsDefinition extends Route0._ParamsDefinition<TPathOriginalDefinition>,
+    TQueryDefinition extends Route0._QueryDefinition<TPathOriginalDefinition>,
+  >(
+    definition: TPathOriginalDefinition,
+    config?: Route0.RouteConfigInput,
+  ): Route0.Callable<Route0<TPathOriginalDefinition, TPathDefinition, TParamsDefinition, TQueryDefinition>> {
+    const original = new Route0<TPathOriginalDefinition, TPathDefinition, TParamsDefinition, TQueryDefinition>(
+      definition,
+      config,
+    )
+    const callable = original.get.bind(original)
+    const proxy = new Proxy(callable, {
+      get(_target, prop, receiver) {
+        const value = (original as any)[prop]
+        if (typeof value === 'function') {
+          return value.bind(original)
+        }
+        return value
+      },
+      set(_target, prop, value, receiver) {
+        ;(original as any)[prop] = value
+        return true
+      },
+      has(_target, prop) {
+        return prop in original
+      },
+    })
+    Object.setPrototypeOf(proxy, Route0.prototype)
+    return proxy as never
+  }
+
+  private static _splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition: string) {
+    const i = pathOriginalDefinition.indexOf('&')
+    if (i === -1) return { pathDefinition: pathOriginalDefinition, queryTailDefinition: '' }
+    return {
+      pathDefinition: pathOriginalDefinition.slice(0, i),
+      queryTailDefinition: pathOriginalDefinition.slice(i),
+    }
+  }
+
+  private static _getAbsPath(baseUrl: string, pathWithQuery: string) {
+    return new URL(pathWithQuery, baseUrl).toString().replace(/\/$/, '')
+  }
+
+  private static _getPathDefinitionByOriginalDefinition<TPathOriginalDefinition extends string>(
+    pathOriginalDefinition: TPathOriginalDefinition,
+  ) {
+    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition)
+    return pathDefinition as Route0._PathDefinition<TPathOriginalDefinition>
+  }
+
+  private static _getParamsDefinitionByRouteDefinition<TPathOriginalDefinition extends string>(
+    pathOriginalDefinition: TPathOriginalDefinition,
+  ) {
+    const { pathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition)
+    const matches = Array.from(pathDefinition.matchAll(/:([A-Za-z0-9_]+)/g))
+    const paramsDefinition = Object.fromEntries(matches.map((m) => [m[1], true]))
+    return paramsDefinition as Route0._ParamsDefinition<TPathOriginalDefinition>
+  }
+
+  private static _getQueryDefinitionByRouteDefinition<TPathOriginalDefinition extends string>(
+    pathOriginalDefinition: TPathOriginalDefinition,
+  ) {
+    const { queryTailDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(pathOriginalDefinition)
+    if (!queryTailDefinition) {
+      return {} as Route0._QueryDefinition<TPathOriginalDefinition>
+    }
+    const keys = queryTailDefinition.split('&').map(Boolean)
+    const queryDefinition = Object.fromEntries(keys.map((k) => [k, true]))
+    return queryDefinition as Route0._QueryDefinition<TPathOriginalDefinition>
+  }
+
+  static overrideMany<T extends Record<string, Route0<any, any, any, any>>>(
+    routes: T,
+    config: Route0.RouteConfigInput,
+  ): T {
+    const result = {} as T
+    for (const [key, value] of Object.entries(routes)) {
+      ;(result as any)[key] = value.clone(config)
+    }
+    return result
+  }
+
+  extend<TSuffixDefinition extends string>(
+    suffixDefinition: TSuffixDefinition,
+  ): Route0.Callable<
+    Route0<
+      Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>,
+      Route0._PathDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,
+      Route0._ParamsDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,
+      Route0._QueryDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>
+    >
+  > {
+    const { pathDefinition: parentPathDefinition } = Route0._splitPathDefinitionAndQueryTailDefinition(
+      this.pathOriginalDefinition,
+    )
+    const { pathDefinition: suffixPathDefinition, queryTailDefinition: suffixQueryTailDefinition } =
+      Route0._splitPathDefinitionAndQueryTailDefinition(suffixDefinition)
+    const pathDefinition = `${parentPathDefinition}/${suffixPathDefinition}`.replace(/\/{2,}/g, '/')
+    const pathOriginalDefinition =
+      `${pathDefinition}${suffixQueryTailDefinition}` as Route0._RoutePathOriginalDefinitionExtended<
+        TPathOriginalDefinition,
+        TSuffixDefinition
+      >
+    return Route0.create<
+      Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>,
+      Route0._PathDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,
+      Route0._ParamsDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>,
+      Route0._QueryDefinition<Route0._RoutePathOriginalDefinitionExtended<TPathOriginalDefinition, TSuffixDefinition>>
+    >(pathOriginalDefinition, { baseUrl: this.baseUrl })
+  }
+
+  // has params
+  get(
+    input: Route0._OnlyIfHasParams<
+      TParamsDefinition,
+      Route0._WithParamsInput<TParamsDefinition, { query?: undefined; abs?: false }>
+    >,
+  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>
+  get(
+    input: Route0._OnlyIfHasParams<
+      TParamsDefinition,
+      Route0._WithParamsInput<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs?: false }>
+    >,
+  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>
+  get(
+    input: Route0._OnlyIfHasParams<
+      TParamsDefinition,
+      Route0._WithParamsInput<TParamsDefinition, { query?: undefined; abs: true }>
+    >,
+  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>
+  get(
+    input: Route0._OnlyIfHasParams<
+      TParamsDefinition,
+      Route0._WithParamsInput<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs: true }>
+    >,
+  ): Route0._OnlyIfHasParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>
+
+  // no params
+  get(
+    ...args: Route0._OnlyIfNoParams<TParamsDefinition, [], [never]>
+  ): Route0._PathOnlyRouteValue<TPathOriginalDefinition>
+  get(
+    input: Route0._OnlyIfNoParams<TParamsDefinition, { query?: undefined; abs?: false }>,
+  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._PathOnlyRouteValue<TPathOriginalDefinition>>
+  get(
+    input: Route0._OnlyIfNoParams<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs?: false }>,
+  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._WithQueryRouteValue<TPathOriginalDefinition>>
+  get(
+    input: Route0._OnlyIfNoParams<TParamsDefinition, { query?: undefined; abs: true }>,
+  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsolutePathOnlyRouteValue<TPathOriginalDefinition>>
+  get(
+    input: Route0._OnlyIfNoParams<TParamsDefinition, { query: Route0._QueryInput<TQueryDefinition>; abs: true }>,
+  ): Route0._OnlyIfNoParams<TParamsDefinition, Route0._AbsoluteWithQueryRouteValue<TPathOriginalDefinition>>
+
+  // implementation
+  get(...args: any[]): string {
+    const { queryInput, paramsInput, absInput } = ((): {
+      queryInput: Record<string, string | number>
+      paramsInput: Record<string, string | number>
+      absInput: boolean
+    } => {
+      if (args.length === 0) {
+        return { queryInput: {}, paramsInput: {}, absInput: false }
+      }
+      const input = args[0]
+      if (typeof input !== 'object' || input === null) {
+        // throw new Error("Invalid get route input: expected object")
+        return { queryInput: {}, paramsInput: {}, absInput: false }
+      }
+      const { query, abs, ...params } = input
+      return { queryInput: query || {}, paramsInput: params, absInput: abs ?? false }
+    })()
+
+    // validate params
+    const neededParamsKeys = Object.keys(this.paramsDefinition)
+    const providedParamsKeys = Object.keys(paramsInput)
+    const notProvidedKeys = neededParamsKeys.filter((k) => !providedParamsKeys.includes(k))
+    if (notProvidedKeys.length) {
+      // throw new Error(`Missing params: not defined keys ${notProvidedKeys.map((k) => `"${k}"`).join(", ")}.`)
+      Object.assign(paramsInput, Object.fromEntries(notProvidedKeys.map((k) => [k, 'undefined'])))
+    }
+
+    // create url
+    let url = String(this.pathDefinition)
+    // replace params
+    url = url.replace(/:([A-Za-z0-9_]+)/g, (_m, k) => encodeURIComponent(String(paramsInput?.[k] ?? '')))
+    // query params
+    const queryInputStringified = Object.fromEntries(Object.entries(queryInput).map(([k, v]) => [k, String(v)]))
+    url = [url, new URLSearchParams(queryInputStringified).toString()].filter(Boolean).join('?')
+    // dedupe slashes
+    url = url.replace(/\/{2,}/g, '/')
+    // absolute
+    url = absInput ? Route0._getAbsPath(this.baseUrl, url) : url
+
+    return url
+  }
+
+  getDefinition() {
+    return this.pathDefinition
+  }
+
+  clone(config?: Route0.RouteConfigInput) {
+    return new Route0(this.pathOriginalDefinition, config)
+  }
+}
+
+export namespace Route0 {
+  export type Callable<T extends Route0<any, any, any, any>> = T & T['get']
+  export type RouteConfigInput = {
+    baseUrl?: string
+  }
+  export type Params<TRoute0 extends Route0<any, any, any, any>> = {
+    [K in keyof TRoute0['paramsDefinition']]: string
+  }
+  export type Query<TRoute0 extends Route0<any, any, any, any>> = Partial<
+    {
+      [K in keyof TRoute0['queryDefinition']]: string | undefined
+    } & Record<string, string | undefined>
+  >
+
+  export type _TrimQueryTailDefinition<S extends string> = S extends `${infer P}&${string}` ? P : S
+  export type _QueryTailDefinitionWithoutFirstAmp<S extends string> = S extends `${string}&${infer T}` ? T : ''
+  export type _QueryTailDefinitionWithFirstAmp<S extends string> = S extends `${string}&${infer T}` ? `&${T}` : ''
+  export type _AmpSplit<S extends string> = S extends `${infer A}&${infer B}` ? A | _AmpSplit<B> : S
+  export type _NonEmpty<T> = [T] extends ['' | never] ? never : T
+  export type _ExtractPathParams<S extends string> = S extends `${string}:${infer After}`
+    ? After extends `${infer Name}/${infer Rest}`
+      ? Name | _ExtractPathParams<`/${Rest}`>
+      : After
+    : never
+  export type _ReplacePathParams<S extends string> = S extends `${infer Head}:${infer Tail}`
+    ? Tail extends `${infer _Param}/${infer Rest}`
+      ? _ReplacePathParams<`${Head}${string}/${Rest}`>
+      : `${Head}${string}`
+    : S
+  export type _DedupeSlashes<S extends string> = S extends `${infer A}//${infer B}` ? _DedupeSlashes<`${A}/${B}`> : S
+  export type _EmptyRecord = Record<never, never>
+  export type _JoinPath<Parent extends string, Suffix extends string> = _DedupeSlashes<
+    Route0._PathDefinition<Parent> extends infer A extends string
+      ? _PathDefinition<Suffix> extends infer B extends string
+        ? A extends ''
+          ? B extends ''
+            ? ''
+            : B extends `/${string}`
+              ? B
+              : `/${B}`
+          : B extends ''
+            ? A
+            : A extends `${string}/`
+              ? `${A}${B}`
+              : B extends `/${string}`
+                ? `${A}${B}`
+                : `${A}/${B}`
+        : never
+      : never
+  >
+
+  export type _OnlyIfNoParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? Yes : No
+  export type _OnlyIfHasParams<TParams extends object, Yes, No = never> = keyof TParams extends never ? No : Yes
+
+  export type _PathDefinition<TPathOriginalDefinition extends string> =
+    _TrimQueryTailDefinition<TPathOriginalDefinition>
+  export type _ParamsDefinition<TPathOriginalDefinition extends string> = _ExtractPathParams<
+    _PathDefinition<TPathOriginalDefinition>
+  > extends infer U
+    ? [U] extends [never]
+      ? _EmptyRecord
+      : { [K in Extract<U, string>]: true }
+    : _EmptyRecord
+  export type _QueryDefinition<TPathOriginalDefinition extends string> = _NonEmpty<
+    _QueryTailDefinitionWithoutFirstAmp<TPathOriginalDefinition>
+  > extends infer Tail extends string
+    ? _AmpSplit<Tail> extends infer U
+      ? [U] extends [never]
+        ? _EmptyRecord
+        : { [K in Extract<U, string>]: true }
+      : _EmptyRecord
+    : _EmptyRecord
+  export type _RoutePathOriginalDefinitionExtended<
+    TSourcePathOriginalDefinition extends string,
+    TSuffixPathOriginalDefinition extends string,
+  > = `${_JoinPath<TSourcePathOriginalDefinition, TSuffixPathOriginalDefinition>}${_QueryTailDefinitionWithFirstAmp<TSuffixPathOriginalDefinition>}`
+
+  export type _ParamsInput<TParamsDefinition extends object> = {
+    [K in keyof TParamsDefinition]: string | number
+  }
+  export type _QueryInput<TQueryDefinition extends object> = Partial<{
+    [K in keyof TQueryDefinition]: string | number
+  }> &
+    Record<string, string | number>
+  export type _WithParamsInput<
+    TParamsDefinition extends object,
+    T extends {
+      query?: _QueryInput<any>
+      abs?: boolean
+    },
+  > = _ParamsInput<TParamsDefinition> & T
+
+  export type _PathOnlyRouteValue<TPathOriginalDefinition extends string> =
+    `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}`
+  export type _WithQueryRouteValue<TPathOriginalDefinition extends string> =
+    `${_ReplacePathParams<_PathDefinition<TPathOriginalDefinition>>}?${string}`
+  export type _AbsolutePathOnlyRouteValue<TPathOriginalDefinition extends string> =
+    `${string}${_PathOnlyRouteValue<TPathOriginalDefinition>}`
+  export type _AbsoluteWithQueryRouteValue<TPathOriginalDefinition extends string> =
+    `${string}${_WithQueryRouteValue<TPathOriginalDefinition>}`
+}