@kosmojs/dev 0.0.20 → 0.0.21

package/pkg/{src/routes-factory → routes-factory}/index.d.ts

@@ -1,5 +1,6 @@
 import type { PluginOptionsResolved } from "../types";
 import { type ResolverSignature } from "./resolve";
+export * from "./base";
 export * from "./nesting";
 export * from "./resolve";
 export declare const routesFactory: (pluginOptions: PluginOptionsResolved) => Promise<{

package/pkg/stub-generator/index.js

@@ -51,9 +51,6 @@ var pathResolver = ({
     },
     libEntry(...a) {
       return this.lib(defaults.entryDir, ...a);
-    },
-    fetch(...a) {
-      return this.lib(defaults.fetchDir, ...a);
     }
   };
   return {
@@ -87,9 +84,6 @@ var pathResolver = ({
       },
       libPages(...a) {
         return this.lib(defaults.pagesDir, ...a);
-      },
-      fetch(...a) {
-        return this.lib(defaults.fetchDir, ...a);
       }
     },
     createImport,
@@ -121,13 +115,8 @@ var render = (template, context, options) => {
   const { noEscape = true, renderer = handlebars } = { ...options };
   return renderer.compile(template, { noEscape })(context);
 };
-var renderAsFile = (file, template, context, options) => {
-  const { formatters, ...renderOpts } = { ...options };
-  const content = render(template, context, renderOpts);
-  return Array.isArray(formatters) ? formatters.reduce((c, f) => f(c, file), content) : content;
-};
 var renderToFile = async (file, template, context, options) => {
-  const content = renderAsFile(file, template, context, options);
+  const content = render(template, context, options);
   if (await pathExists(file)) {
     const { overwrite = true } = { ...options };
     if (overwrite === false) {

package/pkg/stub-generator/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/stub-generator/index.ts", "../../src/paths.ts", "../../src/defaults.ts", "../../src/render.ts", "../../src/fs.ts", "load-as-text:/volumes/studio/OpenSource/KosmoJS/Kosmo/packages/core/dev/src/stub-generator/templates/env.d.ts", "../../src/stub-generator/templates/gitignore.hbs", "../../src/stub-generator/templates/schemas.hbs"],
-  "sourcesContent": ["import { dirname } from \"node:path\";\n\nimport { pathResolver } from \"@/paths\";\nimport { renderToFile } from \"@/render\";\nimport type { GeneratorConstructor, ResolvedEntry } from \"@/types\";\n\nimport envTpl from \"./templates/env.d.ts?as=text\";\nimport gitignoreTpl from \"./templates/gitignore.hbs\";\nimport schemasTpl from \"./templates/schemas.hbs\";\n\n/**\n * Generates stub files required by various generators.\n * Ensures cross-generator dependencies remain resolvable\n * even if specialized generators supposed to generate these files are not installed.\n * */\nexport default (): GeneratorConstructor => {\n  return {\n    name: \"Stub\",\n    moduleImport: import.meta.filename,\n    moduleConfig: undefined,\n    async factory({ appRoot, sourceFolder }) {\n      const generateLibFiles = async (entries: Array<ResolvedEntry>) => {\n        const { createPath } = pathResolver({ appRoot, sourceFolder });\n\n        /**\n         * expose TRefine as a global type.\n         * not supposed to be overriden by generators.\n         * */\n        await renderToFile(createPath.lib(\"../env.d.ts\"), envTpl, {});\n\n        /**\n         * deploy a default gitignore file that ignore everything,\n         * except cache.json files; if file exists, do not override.\n         * */\n        await renderToFile(\n          createPath.lib(\"../.gitignore\"),\n          gitignoreTpl,\n          {},\n          { overwrite: false },\n        );\n\n        for (const { kind, entry } of entries) {\n          if (kind === \"apiRoute\") {\n            // Generating stub schemas file.\n            // It is required by various generators, e.g. api-generator, fetch-generator.\n            // Specialized generators (e.g. typebox-generator) may override this later.\n            await renderToFile(\n              createPath.libApi(dirname(entry.file), \"schemas.ts\"),\n              schemasTpl,\n              { route: entry },\n              { overwrite: false },\n            );\n          }\n        }\n      };\n\n      return {\n        watch: generateLibFiles,\n        build: generateLibFiles,\n      };\n    },\n  };\n};\n", "import { join } from \"node:path\";\n\nimport { defaults } from \"./defaults\";\n\ntype CreateImport = Record<\n  | \"coreApi\"\n  | \"src\"\n  | \"config\"\n  | \"api\"\n  | \"pages\"\n  | \"fetch\"\n  | \"lib\"\n  | \"libApi\"\n  | \"libEntry\",\n  (...a: Array<string>) => string\n>;\n\nexport const createTsconfigPaths = (prefix: string) => {\n  return {\n    [`${defaults.appPrefix}/*`]: [`${prefix}/*`],\n    [`${defaults.srcPrefix}/*`]: [`${prefix}/${defaults.srcDir}/*`],\n    [`${defaults.libPrefix}/*`]: [\n      `${prefix}/${defaults.libDir}/${defaults.srcDir}/*`,\n    ],\n  };\n};\n\nexport const pathResolver = ({\n  appRoot,\n  sourceFolder,\n}: {\n  appRoot?: string;\n  sourceFolder: string;\n}): {\n  createPath: Record<\n    | \"coreApi\"\n    | \"src\"\n    | \"config\"\n    | \"api\"\n    | \"pages\"\n    | \"entry\"\n    | \"fetch\"\n    | \"lib\"\n    | \"libApi\"\n    | \"libEntry\"\n    | \"libPages\",\n    (...a: Array<string>) => string\n  >;\n  createImport: CreateImport;\n  createImportHelper: (k: keyof CreateImport, ...a: Array<string>) => string;\n} => {\n  const createPath = (...a: Array<string>) => {\n    return appRoot ? join(appRoot, ...a) : join(...a);\n  };\n\n  const createImport: CreateImport = {\n    coreApi(...a) {\n      return join(defaults.appPrefix, defaults.coreDir, defaults.apiDir, ...a);\n    },\n    src(...a) {\n      return join(defaults.srcPrefix, sourceFolder, ...a);\n    },\n    config(...a) {\n      return this.src(defaults.configDir, ...a);\n    },\n    api(...a) {\n      return this.src(defaults.apiDir, ...a);\n    },\n    pages(...a) {\n      return this.src(defaults.pagesDir, ...a);\n    },\n    lib(...a) {\n      return join(defaults.libPrefix, sourceFolder, ...a);\n    },\n    libApi(...a) {\n      return this.lib(defaults.apiDir, ...a);\n    },\n    libEntry(...a) {\n      return this.lib(defaults.entryDir, ...a);\n    },\n    fetch(...a) {\n      return this.lib(defaults.fetchDir, ...a);\n    },\n  };\n\n  return {\n    createPath: {\n      coreApi(...a) {\n        return createPath(defaults.coreDir, defaults.apiDir, ...a);\n      },\n      src(...a) {\n        return createPath(defaults.srcDir, sourceFolder, ...a);\n      },\n      api(...a) {\n        return this.src(defaults.apiDir, ...a);\n      },\n      pages(...a) {\n        return this.src(defaults.pagesDir, ...a);\n      },\n      config(...a) {\n        return this.src(defaults.configDir, ...a);\n      },\n      entry(...a) {\n        return this.src(defaults.entryDir, ...a);\n      },\n      lib(...a) {\n        return createPath(defaults.libDir, defaults.srcDir, sourceFolder, ...a);\n      },\n      libApi(...a) {\n        return this.lib(defaults.apiDir, ...a);\n      },\n      libEntry(...a) {\n        return this.lib(defaults.entryDir, ...a);\n      },\n      libPages(...a) {\n        return this.lib(defaults.pagesDir, ...a);\n      },\n      fetch(...a) {\n        return this.lib(defaults.fetchDir, ...a);\n      },\n    },\n    createImport,\n    createImportHelper: (key, ...a) => {\n      // Handlebars always appends an options object as the last argument,\n      // slice it off before passing args to createImport\n      return createImport[key](...a.slice(0, -1));\n    },\n  };\n};\n", "export const defaults = {\n  appPrefix: \"~\",\n  srcPrefix: \"@\",\n  libPrefix: \"_\",\n\n  coreDir: \"core\",\n  srcDir: \"src\",\n  libDir: \"lib\",\n\n  configDir: \"config\",\n  apiDir: \"api\",\n  pagesDir: \"pages\",\n  entryDir: \"entry\",\n  fetchDir: \"fetch\",\n};\n", "import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\n\nimport crc from \"crc/crc32\";\nimport handlebars from \"handlebars\";\n\nimport { pathExists } from \"./fs\";\n\nexport type RenderOptions = {\n  noEscape?: boolean;\n  // handlebars instance\n  renderer?: typeof handlebars;\n};\n\nexport type FactoryOptions = RenderOptions & {\n  /**\n   * Controls whether to overwrite an existing file.\n   * - `false`: skip writing if the file already exists\n   * - `true` (default): always overwrite\n   * - function: custom logic to decide whether to overwrite, based on current file content\n   */\n  overwrite?: boolean | ((fileContent: string) => boolean);\n  formatters?: Array<Formatter>;\n};\n\ntype Formatter = (content: string, file: string) => string;\n\nexport const render = <Context = object>(\n  template: string,\n  context: Context,\n  options?: RenderOptions,\n): string => {\n  const { noEscape = true, renderer = handlebars } = { ...options };\n  return renderer.compile(template, { noEscape })(context);\n};\n\nexport const renderAsFile = <Context = object>(\n  file: string,\n  template: string,\n  context: Context,\n  options?: Omit<FactoryOptions, \"overwrite\">,\n): string => {\n  const { formatters, ...renderOpts } = { ...options };\n  const content = render(template, context, renderOpts);\n  return Array.isArray(formatters)\n    ? formatters.reduce((c, f) => f(c, file), content)\n    : content;\n};\n\nexport const renderToFile = async <Context = object>(\n  file: string,\n  template: string,\n  context: Context,\n  options?: FactoryOptions,\n): Promise<void> => {\n  const content = renderAsFile(file, template, context, options);\n\n  /**\n   * Two fs calls (exists + read) are worth it to avoid touching the file\n   * and triggering watchers unnecessarily.\n   * */\n  if (await pathExists(file)) {\n    const { overwrite = true } = { ...options };\n    if (overwrite === false) {\n      return;\n    }\n    const fileContent = await readFile(file, \"utf8\");\n    if (typeof overwrite === \"function\" && !overwrite(fileContent)) {\n      return;\n    }\n    if (crc(content) === crc(fileContent)) {\n      return;\n    }\n  }\n\n  await mkdir(dirname(file), { recursive: true });\n  await writeFile(file, content, \"utf8\");\n};\n\nexport const renderFactory = (\n  options?: FactoryOptions & {\n    outdir?: string;\n    partials?: Record<string, string>;\n    helpers?: Record<string, (...a: Array<never>) => unknown>;\n  },\n) => {\n  const renderer = handlebars.create();\n  if (options?.partials) {\n    renderer.registerPartial(options.partials as never);\n  }\n  if (options?.helpers) {\n    renderer.registerHelper(options.helpers as never);\n  }\n  return {\n    render<Context = object>(\n      template: string,\n      context: Context,\n      selfOoptions?: FactoryOptions,\n    ) {\n      return render(template, context, {\n        renderer,\n        ...options,\n        ...selfOoptions,\n      });\n    },\n    async renderToFile<Context = object>(\n      file: string,\n      template: string,\n      context: Context,\n      selfOoptions?: FactoryOptions,\n    ) {\n      return renderToFile(\n        options?.outdir ? join(options.outdir, file) : file,\n        template,\n        context,\n        { renderer, ...options, ...selfOoptions },\n      );\n    },\n  };\n};\n", "import { access, constants } from \"node:fs/promises\";\n\nexport const pathExists = async (path: string): Promise<boolean> => {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n};\n", "/**\n * Enhances base TypeScript types with JSON Schema validation constraints.\n * Allows declaring refined types that carry validation metadata for runtime\n * schema validation while maintaining full TypeScript type safety.\n *\n * Useful for generating validation schemas and ensuring\n * data conforms to specific business rules beyond basic type checking.\n * */\nexport declare global {\n  type TRefine<\n    T extends unknown[] | number | string | object,\n    _ extends T extends unknown[]\n      ? TArrayOptions\n      : T extends number\n        ? TNumberOptions\n        : T extends string\n          ? TStringOptions\n          : TObjectOptions,\n  > = T;\n}\n\n/**\n * Type definitions inspired by and gently adapted from TypeBox.\n * Original TypeBox created by sinclairzx81: https://github.com/sinclairzx81/typebox\n * TypeBox is licensed under MIT: https://github.com/sinclairzx81/typebox/blob/main/license\n *\n * These types provide JSON Schema compatible type refinements for TypeScript.\n * */\ninterface TSchema {}\n\n// ------------------------------------------------------------------\n// ObjectOptions\n// ------------------------------------------------------------------\ninterface TObjectOptions {\n  /**\n   * Defines whether additional properties are allowed beyond those explicitly defined in `properties`.\n   */\n  additionalProperties?: TSchema | boolean;\n  /**\n   * The minimum number of properties required in the object.\n   */\n  minProperties?: number;\n  /**\n   * The maximum number of properties allowed in the object.\n   */\n  maxProperties?: number;\n  /**\n   * Defines conditional requirements for properties.\n   */\n  dependencies?: Record<string, boolean | TSchema | string[]>;\n  /**\n   * Specifies properties that *must* be present if a given property is present.\n   */\n  dependentRequired?: Record<string, string[]>;\n  /**\n   * Defines schemas that apply if a specific property is present.\n   */\n  dependentSchemas?: Record<string, TSchema>;\n  /**\n   * Maps regular expressions to schemas properties matching a pattern must validate against the schema.\n   */\n  patternProperties?: Record<string, TSchema>;\n  /**\n   * A schema that all property names within the object must validate against.\n   */\n  propertyNames?: TSchema;\n}\n\n// ------------------------------------------------------------------\n// ArrayOptions\n// ------------------------------------------------------------------\ninterface TArrayOptions {\n  /**\n   * The minimum number of items allowed in the array.\n   */\n  minItems?: number;\n  /**\n   * The maximum number of items allowed in the array.\n   */\n  maxItems?: number;\n  /**\n   * A schema that at least one item in the array must validate against.\n   */\n  contains?: TSchema;\n  /**\n   * The minimum number of array items that must validate against the `contains` schema.\n   */\n  minContains?: number;\n  /**\n   * The maximum number of array items that may validate against the `contains` schema.\n   */\n  maxContains?: number;\n  /**\n   * An array of schemas, where each schema in `prefixItems` validates against items at corresponding positions from the beginning of the array.\n   */\n  prefixItems?: TSchema[];\n  /**\n   * If `true`, all items in the array must be unique.\n   */\n  uniqueItems?: boolean;\n}\n\n// ------------------------------------------------------------------\n// NumberOptions\n// ------------------------------------------------------------------\ninterface TNumberOptions {\n  /**\n   * Specifies an exclusive upper limit for the number (number must be less than this value).\n   */\n  exclusiveMaximum?: number | bigint;\n  /**\n   * Specifies an exclusive lower limit for the number (number must be greater than this value).\n   */\n  exclusiveMinimum?: number | bigint;\n  /**\n   * Specifies an inclusive upper limit for the number (number must be less than or equal to this value).\n   */\n  maximum?: number | bigint;\n  /**\n   * Specifies an inclusive lower limit for the number (number must be greater than or equal to this value).\n   */\n  minimum?: number | bigint;\n  /**\n   * Specifies that the number must be a multiple of this value.\n   */\n  multipleOf?: number | bigint;\n}\n\n// ------------------------------------------------------------------\n// StringOptions\n// ------------------------------------------------------------------\ntype TFormat =\n  | \"date-time\"\n  | \"date\"\n  | \"duration\"\n  | \"email\"\n  | \"hostname\"\n  | \"idn-email\"\n  | \"idn-hostname\"\n  | \"ipv4\"\n  | \"ipv6\"\n  | \"iri-reference\"\n  | \"iri\"\n  | \"json-pointer-uri-fragment\"\n  | \"json-pointer\"\n  | \"json-string\"\n  | \"regex\"\n  | \"relative-json-pointer\"\n  | \"time\"\n  | \"uri-reference\"\n  | \"uri-template\"\n  | \"url\"\n  | \"uuid\";\n\ninterface TStringOptions {\n  /**\n   * Specifies the expected string format.\n   *\n   * Common values include:\n   * - `base64` \u2013 Base64-encoded string.\n   * - `date-time` \u2013 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time format.\n   * - `date` \u2013 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date (YYYY-MM-DD).\n   * - `duration` \u2013 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) duration format.\n   * - `email` \u2013 RFC 5321/5322 compliant email address.\n   * - `hostname` \u2013 RFC 1034/1035 compliant host name.\n   * - `idn-email` \u2013 Internationalized email address.\n   * - `idn-hostname` \u2013 Internationalized host name.\n   * - `ipv4` \u2013 IPv4 address.\n   * - `ipv6` \u2013 IPv6 address.\n   * - `iri` / `iri-reference` \u2013 Internationalized Resource Identifier.\n   * - `json-pointer` / `json-pointer-uri-fragment` \u2013 JSON Pointer format.\n   * - `json-string` \u2013 String containing valid JSON.\n   * - `regex` \u2013 Regular expression syntax.\n   * - `relative-json-pointer` \u2013 Relative JSON Pointer format.\n   * - `time` \u2013 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time (HH:MM:SS).\n   * - `uri-reference` / `uri-template` \u2013 URI reference or template.\n   * - `url` \u2013 Web URL format.\n   * - `uuid` \u2013 RFC 4122 UUID string.\n   *\n   * May also be a custom format string.\n   */\n  format?: TFormat;\n  /**\n   * Specifies the minimum number of characters allowed in the string.\n   * Must be a non-negative integer.\n   */\n  minLength?: number;\n  /**\n   * Specifies the maximum number of characters allowed in the string.\n   * Must be a non-negative integer.\n   */\n  maxLength?: number;\n  /**\n   * Specifies a regular expression pattern that the string value must match.\n   * Can be provided as a string (ECMA-262 regex syntax) or a `RegExp` object.\n   */\n  pattern?: string | RegExp;\n}\n", "# Ignore all files\n*\n\n# But don't ignore directories (so Git can traverse them)\n!*/\n\n# And don't ignore these files at any depth\n!cache.json\n!types.ts\n", "// stub schemas, specialized generators supposed to overwrite this file\nimport type { ValidationSchemas } from \"@kosmojs/api\";\nexport type { ValidationSchemas };\nexport const validationSchemas: ValidationSchemas = {};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { dirname } from \"node:path\";\n\nimport { pathResolver } from \"../paths\";\nimport { renderToFile } from \"../render\";\nimport type { GeneratorConstructor, ResolvedEntry } from \"../types\";\n\nimport envTpl from \"./templates/env.d.ts?as=text\";\nimport gitignoreTpl from \"./templates/gitignore.hbs\";\nimport schemasTpl from \"./templates/schemas.hbs\";\n\n/**\n * Generates stub files required by various generators.\n * Ensures cross-generator dependencies remain resolvable\n * even if specialized generators supposed to generate these files are not installed.\n * */\nexport default (): GeneratorConstructor => {\n  return {\n    name: \"Stub\",\n    moduleImport: import.meta.filename,\n    moduleConfig: undefined,\n    async factory({ appRoot, sourceFolder }) {\n      const generateLibFiles = async (entries: Array<ResolvedEntry>) => {\n        const { createPath } = pathResolver({ appRoot, sourceFolder });\n\n        /**\n         * expose TRefine as a global type.\n         * not supposed to be overriden by generators.\n         * */\n        await renderToFile(createPath.lib(\"../env.d.ts\"), envTpl, {});\n\n        /**\n         * deploy a default gitignore file that ignore everything,\n         * except cache.json files; if file exists, do not override.\n         * */\n        await renderToFile(\n          createPath.lib(\"../.gitignore\"),\n          gitignoreTpl,\n          {},\n          { overwrite: false },\n        );\n\n        for (const { kind, entry } of entries) {\n          if (kind === \"apiRoute\") {\n            // Generating stub schemas file.\n            // It is required by various generators, e.g. api-generator, fetch-generator.\n            // Specialized generators (e.g. typebox-generator) may override this later.\n            await renderToFile(\n              createPath.libApi(dirname(entry.file), \"schemas.ts\"),\n              schemasTpl,\n              { route: entry },\n              { overwrite: false },\n            );\n          }\n        }\n      };\n\n      return {\n        watch: generateLibFiles,\n        build: generateLibFiles,\n      };\n    },\n  };\n};\n", "import { join } from \"node:path\";\n\nimport { defaults } from \"./defaults\";\n\ntype CreateImport = Record<\n  | \"coreApi\"\n  | \"src\"\n  | \"config\"\n  | \"api\"\n  | \"pages\"\n  | \"lib\"\n  | \"libApi\"\n  | \"libEntry\",\n  (...a: Array<string>) => string\n>;\n\nexport const createTsconfigPaths = (prefix: string) => {\n  return {\n    [`${defaults.appPrefix}/*`]: [`${prefix}/*`],\n    [`${defaults.srcPrefix}/*`]: [`${prefix}/${defaults.srcDir}/*`],\n    [`${defaults.libPrefix}/*`]: [\n      `${prefix}/${defaults.libDir}/${defaults.srcDir}/*`,\n    ],\n  };\n};\n\nexport const pathResolver = ({\n  appRoot,\n  sourceFolder,\n}: {\n  appRoot?: string;\n  sourceFolder: string;\n}): {\n  createPath: Record<\n    | \"coreApi\"\n    | \"src\"\n    | \"config\"\n    | \"api\"\n    | \"pages\"\n    | \"entry\"\n    | \"lib\"\n    | \"libApi\"\n    | \"libEntry\"\n    | \"libPages\",\n    (...a: Array<string>) => string\n  >;\n  createImport: CreateImport;\n  createImportHelper: (k: keyof CreateImport, ...a: Array<string>) => string;\n} => {\n  const createPath = (...a: Array<string>) => {\n    return appRoot ? join(appRoot, ...a) : join(...a);\n  };\n\n  const createImport: CreateImport = {\n    coreApi(...a) {\n      return join(defaults.appPrefix, defaults.coreDir, defaults.apiDir, ...a);\n    },\n    src(...a) {\n      return join(defaults.srcPrefix, sourceFolder, ...a);\n    },\n    config(...a) {\n      return this.src(defaults.configDir, ...a);\n    },\n    api(...a) {\n      return this.src(defaults.apiDir, ...a);\n    },\n    pages(...a) {\n      return this.src(defaults.pagesDir, ...a);\n    },\n    lib(...a) {\n      return join(defaults.libPrefix, sourceFolder, ...a);\n    },\n    libApi(...a) {\n      return this.lib(defaults.apiDir, ...a);\n    },\n    libEntry(...a) {\n      return this.lib(defaults.entryDir, ...a);\n    },\n  };\n\n  return {\n    createPath: {\n      coreApi(...a) {\n        return createPath(defaults.coreDir, defaults.apiDir, ...a);\n      },\n      src(...a) {\n        return createPath(defaults.srcDir, sourceFolder, ...a);\n      },\n      api(...a) {\n        return this.src(defaults.apiDir, ...a);\n      },\n      pages(...a) {\n        return this.src(defaults.pagesDir, ...a);\n      },\n      config(...a) {\n        return this.src(defaults.configDir, ...a);\n      },\n      entry(...a) {\n        return this.src(defaults.entryDir, ...a);\n      },\n      lib(...a) {\n        return createPath(defaults.libDir, defaults.srcDir, sourceFolder, ...a);\n      },\n      libApi(...a) {\n        return this.lib(defaults.apiDir, ...a);\n      },\n      libEntry(...a) {\n        return this.lib(defaults.entryDir, ...a);\n      },\n      libPages(...a) {\n        return this.lib(defaults.pagesDir, ...a);\n      },\n    },\n    createImport,\n    createImportHelper: (key, ...a) => {\n      // Handlebars always appends an options object as the last argument,\n      // slice it off before passing args to createImport\n      return createImport[key](...a.slice(0, -1));\n    },\n  };\n};\n", "export const defaults = {\n  appPrefix: \"~\",\n  srcPrefix: \"@\",\n  libPrefix: \"_\",\n\n  coreDir: \"core\",\n  srcDir: \"src\",\n  libDir: \"lib\",\n\n  configDir: \"config\",\n  apiDir: \"api\",\n  pagesDir: \"pages\",\n  entryDir: \"entry\",\n  fetchDir: \"fetch\",\n};\n", "import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\n\nimport crc from \"crc/crc32\";\nimport handlebars from \"handlebars\";\n\nimport { pathExists } from \"./fs\";\nimport type { PageRoute } from \"./types\";\n\nexport type RenderOptions = {\n  noEscape?: boolean;\n  // handlebars instance\n  renderer?: typeof handlebars;\n};\n\nexport type FactoryOptions = RenderOptions & {\n  /**\n   * Controls whether to overwrite an existing file.\n   * - `false`: skip writing if the file already exists\n   * - `true` (default): always overwrite\n   * - function: custom logic to decide whether to overwrite, based on current file content\n   */\n  overwrite?: boolean | ((fileContent: string) => boolean);\n};\n\nexport const render = <Context = object>(\n  template: string,\n  context: Context,\n  options?: RenderOptions,\n): string => {\n  const { noEscape = true, renderer = handlebars } = { ...options };\n  return renderer.compile(template, { noEscape })(context);\n};\n\nexport const renderToFile = async <Context = object>(\n  file: string,\n  template: string,\n  context: Context,\n  options?: FactoryOptions,\n): Promise<void> => {\n  const content = render(template, context, options);\n\n  /**\n   * Two fs calls (exists + read) are worth it to avoid touching the file\n   * and triggering watchers unnecessarily.\n   * */\n  if (await pathExists(file)) {\n    const { overwrite = true } = { ...options };\n    if (overwrite === false) {\n      return;\n    }\n    const fileContent = await readFile(file, \"utf8\");\n    if (typeof overwrite === \"function\" && !overwrite(fileContent)) {\n      return;\n    }\n    if (crc(content) === crc(fileContent)) {\n      return;\n    }\n  }\n\n  await mkdir(dirname(file), { recursive: true });\n  await writeFile(file, content, \"utf8\");\n};\n\nexport const renderFactory = (\n  options?: FactoryOptions & {\n    outdir?: string;\n    partials?: Record<string, string>;\n    helpers?: Record<string, (...a: Array<never>) => unknown>;\n  },\n) => {\n  const renderer = handlebars.create();\n\n  renderer.registerPartial({ ...options?.partials } as never);\n\n  renderer.registerHelper({ ...options?.helpers } as never);\n\n  return {\n    render<Context = object>(\n      template: string,\n      context: Context,\n      selfOoptions?: FactoryOptions,\n    ) {\n      return render(template, context, {\n        renderer,\n        ...options,\n        ...selfOoptions,\n      });\n    },\n    async renderToFile<Context = object>(\n      file: string,\n      template: string,\n      context: Context,\n      selfOoptions?: FactoryOptions,\n    ) {\n      return renderToFile(\n        options?.outdir ? join(options.outdir, file) : file,\n        template,\n        context,\n        { renderer, ...options, ...selfOoptions },\n      );\n    },\n  };\n};\n\nexport const renderHelpers = {\n  createParamsLiteral: (params: PageRoute[\"params\"]) => {\n    return params.schema\n      .map((p) => {\n        return p.kind === \"splat\"\n          ? `${p.const}?: Array<string | number>`\n          : p.kind === \"optional\"\n            ? `${p.const}?: string | number`\n            : `${p.const}: string | number`;\n      })\n      .join(\", \");\n  },\n};\n", "import { access, constants } from \"node:fs/promises\";\n\nexport const pathExists = async (path: string): Promise<boolean> => {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n};\n", "/**\n * Enhances base TypeScript types with JSON Schema validation constraints.\n * Allows declaring refined types that carry validation metadata for runtime\n * schema validation while maintaining full TypeScript type safety.\n *\n * Useful for generating validation schemas and ensuring\n * data conforms to specific business rules beyond basic type checking.\n * */\nexport declare global {\n  type TRefine<\n    T extends unknown[] | number | string | object,\n    _ extends T extends unknown[]\n      ? TArrayOptions\n      : T extends number\n        ? TNumberOptions\n        : T extends string\n          ? TStringOptions\n          : TObjectOptions,\n  > = T;\n}\n\n/**\n * Type definitions inspired by and gently adapted from TypeBox.\n * Original TypeBox created by sinclairzx81: https://github.com/sinclairzx81/typebox\n * TypeBox is licensed under MIT: https://github.com/sinclairzx81/typebox/blob/main/license\n *\n * These types provide JSON Schema compatible type refinements for TypeScript.\n * */\ninterface TSchema {}\n\n// ------------------------------------------------------------------\n// ObjectOptions\n// ------------------------------------------------------------------\ninterface TObjectOptions {\n  /**\n   * Defines whether additional properties are allowed beyond those explicitly defined in `properties`.\n   */\n  additionalProperties?: TSchema | boolean;\n  /**\n   * The minimum number of properties required in the object.\n   */\n  minProperties?: number;\n  /**\n   * The maximum number of properties allowed in the object.\n   */\n  maxProperties?: number;\n  /**\n   * Defines conditional requirements for properties.\n   */\n  dependencies?: Record<string, boolean | TSchema | string[]>;\n  /**\n   * Specifies properties that *must* be present if a given property is present.\n   */\n  dependentRequired?: Record<string, string[]>;\n  /**\n   * Defines schemas that apply if a specific property is present.\n   */\n  dependentSchemas?: Record<string, TSchema>;\n  /**\n   * Maps regular expressions to schemas properties matching a pattern must validate against the schema.\n   */\n  patternProperties?: Record<string, TSchema>;\n  /**\n   * A schema that all property names within the object must validate against.\n   */\n  propertyNames?: TSchema;\n}\n\n// ------------------------------------------------------------------\n// ArrayOptions\n// ------------------------------------------------------------------\ninterface TArrayOptions {\n  /**\n   * The minimum number of items allowed in the array.\n   */\n  minItems?: number;\n  /**\n   * The maximum number of items allowed in the array.\n   */\n  maxItems?: number;\n  /**\n   * A schema that at least one item in the array must validate against.\n   */\n  contains?: TSchema;\n  /**\n   * The minimum number of array items that must validate against the `contains` schema.\n   */\n  minContains?: number;\n  /**\n   * The maximum number of array items that may validate against the `contains` schema.\n   */\n  maxContains?: number;\n  /**\n   * An array of schemas, where each schema in `prefixItems` validates against items at corresponding positions from the beginning of the array.\n   */\n  prefixItems?: TSchema[];\n  /**\n   * If `true`, all items in the array must be unique.\n   */\n  uniqueItems?: boolean;\n}\n\n// ------------------------------------------------------------------\n// NumberOptions\n// ------------------------------------------------------------------\ninterface TNumberOptions {\n  /**\n   * Specifies an exclusive upper limit for the number (number must be less than this value).\n   */\n  exclusiveMaximum?: number | bigint;\n  /**\n   * Specifies an exclusive lower limit for the number (number must be greater than this value).\n   */\n  exclusiveMinimum?: number | bigint;\n  /**\n   * Specifies an inclusive upper limit for the number (number must be less than or equal to this value).\n   */\n  maximum?: number | bigint;\n  /**\n   * Specifies an inclusive lower limit for the number (number must be greater than or equal to this value).\n   */\n  minimum?: number | bigint;\n  /**\n   * Specifies that the number must be a multiple of this value.\n   */\n  multipleOf?: number | bigint;\n}\n\n// ------------------------------------------------------------------\n// StringOptions\n// ------------------------------------------------------------------\ntype TFormat =\n  | \"date-time\"\n  | \"date\"\n  | \"duration\"\n  | \"email\"\n  | \"hostname\"\n  | \"idn-email\"\n  | \"idn-hostname\"\n  | \"ipv4\"\n  | \"ipv6\"\n  | \"iri-reference\"\n  | \"iri\"\n  | \"json-pointer-uri-fragment\"\n  | \"json-pointer\"\n  | \"json-string\"\n  | \"regex\"\n  | \"relative-json-pointer\"\n  | \"time\"\n  | \"uri-reference\"\n  | \"uri-template\"\n  | \"url\"\n  | \"uuid\";\n\ninterface TStringOptions {\n  /**\n   * Specifies the expected string format.\n   *\n   * Common values include:\n   * - `base64` \u2013 Base64-encoded string.\n   * - `date-time` \u2013 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date-time format.\n   * - `date` \u2013 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date (YYYY-MM-DD).\n   * - `duration` \u2013 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) duration format.\n   * - `email` \u2013 RFC 5321/5322 compliant email address.\n   * - `hostname` \u2013 RFC 1034/1035 compliant host name.\n   * - `idn-email` \u2013 Internationalized email address.\n   * - `idn-hostname` \u2013 Internationalized host name.\n   * - `ipv4` \u2013 IPv4 address.\n   * - `ipv6` \u2013 IPv6 address.\n   * - `iri` / `iri-reference` \u2013 Internationalized Resource Identifier.\n   * - `json-pointer` / `json-pointer-uri-fragment` \u2013 JSON Pointer format.\n   * - `json-string` \u2013 String containing valid JSON.\n   * - `regex` \u2013 Regular expression syntax.\n   * - `relative-json-pointer` \u2013 Relative JSON Pointer format.\n   * - `time` \u2013 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time (HH:MM:SS).\n   * - `uri-reference` / `uri-template` \u2013 URI reference or template.\n   * - `url` \u2013 Web URL format.\n   * - `uuid` \u2013 RFC 4122 UUID string.\n   *\n   * May also be a custom format string.\n   */\n  format?: TFormat;\n  /**\n   * Specifies the minimum number of characters allowed in the string.\n   * Must be a non-negative integer.\n   */\n  minLength?: number;\n  /**\n   * Specifies the maximum number of characters allowed in the string.\n   * Must be a non-negative integer.\n   */\n  maxLength?: number;\n  /**\n   * Specifies a regular expression pattern that the string value must match.\n   * Can be provided as a string (ECMA-262 regex syntax) or a `RegExp` object.\n   */\n  pattern?: string | RegExp;\n}\n", "# Ignore all files\n*\n\n# But don't ignore directories (so Git can traverse them)\n!*/\n\n# And don't ignore these files at any depth\n!cache.json\n!types.ts\n", "// stub schemas, specialized generators supposed to overwrite this file\nimport type { ValidationSchemas } from \"@kosmojs/api\";\nexport type { ValidationSchemas };\nexport const validationSchemas: ValidationSchemas = {};\n"],
+  "mappings": ";AAAA,SAAS,WAAAA,gBAAe;;;ACAxB,SAAS,YAAY;;;ACAd,IAAM,WAAW;AAAA,EACtB,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EAEX,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,QAAQ;AAAA,EAER,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,UAAU;AAAA,EACV,UAAU;AACZ;;;ADYO,IAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AACF,MAmBK;AACH,QAAM,aAAa,IAAI,MAAqB;AAC1C,WAAO,UAAU,KAAK,SAAS,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC;AAAA,EAClD;AAEA,QAAM,eAA6B;AAAA,IACjC,WAAW,GAAG;AACZ,aAAO,KAAK,SAAS,WAAW,SAAS,SAAS,SAAS,QAAQ,GAAG,CAAC;AAAA,IACzE;AAAA,IACA,OAAO,GAAG;AACR,aAAO,KAAK,SAAS,WAAW,cAAc,GAAG,CAAC;AAAA,IACpD;AAAA,IACA,UAAU,GAAG;AACX,aAAO,KAAK,IAAI,SAAS,WAAW,GAAG,CAAC;AAAA,IAC1C;AAAA,IACA,OAAO,GAAG;AACR,aAAO,KAAK,IAAI,SAAS,QAAQ,GAAG,CAAC;AAAA,IACvC;AAAA,IACA,SAAS,GAAG;AACV,aAAO,KAAK,IAAI,SAAS,UAAU,GAAG,CAAC;AAAA,IACzC;AAAA,IACA,OAAO,GAAG;AACR,aAAO,KAAK,SAAS,WAAW,cAAc,GAAG,CAAC;AAAA,IACpD;AAAA,IACA,UAAU,GAAG;AACX,aAAO,KAAK,IAAI,SAAS,QAAQ,GAAG,CAAC;AAAA,IACvC;AAAA,IACA,YAAY,GAAG;AACb,aAAO,KAAK,IAAI,SAAS,UAAU,GAAG,CAAC;AAAA,IACzC;AAAA,EACF;AAEA,SAAO;AAAA,IACL,YAAY;AAAA,MACV,WAAW,GAAG;AACZ,eAAO,WAAW,SAAS,SAAS,SAAS,QAAQ,GAAG,CAAC;AAAA,MAC3D;AAAA,MACA,OAAO,GAAG;AACR,eAAO,WAAW,SAAS,QAAQ,cAAc,GAAG,CAAC;AAAA,MACvD;AAAA,MACA,OAAO,GAAG;AACR,eAAO,KAAK,IAAI,SAAS,QAAQ,GAAG,CAAC;AAAA,MACvC;AAAA,MACA,SAAS,GAAG;AACV,eAAO,KAAK,IAAI,SAAS,UAAU,GAAG,CAAC;AAAA,MACzC;AAAA,MACA,UAAU,GAAG;AACX,eAAO,KAAK,IAAI,SAAS,WAAW,GAAG,CAAC;AAAA,MAC1C;AAAA,MACA,SAAS,GAAG;AACV,eAAO,KAAK,IAAI,SAAS,UAAU,GAAG,CAAC;AAAA,MACzC;AAAA,MACA,OAAO,GAAG;AACR,eAAO,WAAW,SAAS,QAAQ,SAAS,QAAQ,cAAc,GAAG,CAAC;AAAA,MACxE;AAAA,MACA,UAAU,GAAG;AACX,eAAO,KAAK,IAAI,SAAS,QAAQ,GAAG,CAAC;AAAA,MACvC;AAAA,MACA,YAAY,GAAG;AACb,eAAO,KAAK,IAAI,SAAS,UAAU,GAAG,CAAC;AAAA,MACzC;AAAA,MACA,YAAY,GAAG;AACb,eAAO,KAAK,IAAI,SAAS,UAAU,GAAG,CAAC;AAAA,MACzC;AAAA,IACF;AAAA,IACA;AAAA,IACA,oBAAoB,CAAC,QAAQ,MAAM;AAGjC,aAAO,aAAa,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC;AAAA,IAC5C;AAAA,EACF;AACF;;;AExHA,SAAS,OAAO,UAAU,iBAAiB;AAC3C,SAAS,SAAS,QAAAC,aAAY;AAE9B,OAAO,SAAS;AAChB,OAAO,gBAAgB;;;ACJvB,SAAS,QAAQ,iBAAiB;AAE3B,IAAM,aAAa,OAAO,SAAmC;AAClE,MAAI;AACF,UAAM,OAAO,MAAM,UAAU,IAAI;AACjC,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;ADgBO,IAAM,SAAS,CACpB,UACA,SACA,YACW;AACX,QAAM,EAAE,WAAW,MAAM,WAAW,WAAW,IAAI,EAAE,GAAG,QAAQ;AAChE,SAAO,SAAS,QAAQ,UAAU,EAAE,SAAS,CAAC,EAAE,OAAO;AACzD;AAEO,IAAM,eAAe,OAC1B,MACA,UACA,SACA,YACkB;AAClB,QAAM,UAAU,OAAO,UAAU,SAAS,OAAO;AAMjD,MAAI,MAAM,WAAW,IAAI,GAAG;AAC1B,UAAM,EAAE,YAAY,KAAK,IAAI,EAAE,GAAG,QAAQ;AAC1C,QAAI,cAAc,OAAO;AACvB;AAAA,IACF;AACA,UAAM,cAAc,MAAM,SAAS,MAAM,MAAM;AAC/C,QAAI,OAAO,cAAc,cAAc,CAAC,UAAU,WAAW,GAAG;AAC9D;AAAA,IACF;AACA,QAAI,IAAI,OAAO,MAAM,IAAI,WAAW,GAAG;AACrC;AAAA,IACF;AAAA,EACF;AAEA,QAAM,MAAM,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AAC9C,QAAM,UAAU,MAAM,SAAS,MAAM;AACvC;;;AE9DA;;;ACAA;;;ACAA;;;APeA,IAAO,yBAAQ,MAA4B;AACzC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,cAAc,YAAY;AAAA,IAC1B,cAAc;AAAA,IACd,MAAM,QAAQ,EAAE,SAAS,aAAa,GAAG;AACvC,YAAM,mBAAmB,OAAO,YAAkC;AAChE,cAAM,EAAE,WAAW,IAAI,aAAa,EAAE,SAAS,aAAa,CAAC;AAM7D,cAAM,aAAa,WAAW,IAAI,aAAa,GAAG,eAAQ,CAAC,CAAC;AAM5D,cAAM;AAAA,UACJ,WAAW,IAAI,eAAe;AAAA,UAC9B;AAAA,UACA,CAAC;AAAA,UACD,EAAE,WAAW,MAAM;AAAA,QACrB;AAEA,mBAAW,EAAE,MAAM,MAAM,KAAK,SAAS;AACrC,cAAI,SAAS,YAAY;AAIvB,kBAAM;AAAA,cACJ,WAAW,OAAOC,SAAQ,MAAM,IAAI,GAAG,YAAY;AAAA,cACnD;AAAA,cACA,EAAE,OAAO,MAAM;AAAA,cACf,EAAE,WAAW,MAAM;AAAA,YACrB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,aAAO;AAAA,QACL,OAAO;AAAA,QACP,OAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AACF;",
   "names": ["dirname", "join", "dirname"]
 }

package/pkg/{src/types.d.ts → types.d.ts}

@@ -1,9 +1,9 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { ResolvedType } from "tfusion";
 import type { ResolvedConfig } from "vite";
+import type { HTTPMethod, ValidationTarget } from "@kosmojs/api";
 export type PluginOptions = {
     generators?: Array<GeneratorConstructor>;
-    formatters?: Array<FormatterConstructor>;
     /**
      * Name to use for custom runtime validation refinements.
      * @default "TRefine"
@@ -18,25 +18,28 @@ export type PluginOptionsResolved = {
     outDir: string;
     command: ResolvedConfig["command"];
     generators: Array<GeneratorConstructor>;
-    formatters: Array<Formatter>;
     refineTypeName: string;
     watcher: {
         delay: number;
         options?: import("vite").WatchOptions;
     };
-} & Omit<PluginOptions, "generators" | "formatters" | "refineTypeName">;
+} & Omit<PluginOptions, "generators" | "refineTypeName">;
+export type PathTokenStaticPart = {
+    type: "static";
+    value: string;
+};
+export type PathTokenParamPart = {
+    type: "param";
+    kind: "required" | "optional" | "splat";
+    name: string;
+    /** codegen-safe identifier: sanitized name + crc suffix when needed */
+    const: string;
+};
 export type PathToken = {
+    kind: "static" | "param" | "mixed";
     orig: string;
-    base: string;
-    path: string;
-    ext: string;
-    param?: {
-        name: string;
-        const: string;
-        isRequired?: boolean;
-        isOptional?: boolean;
-        isRest?: boolean;
-    };
+    pattern: string;
+    parts: Array<PathTokenStaticPart | PathTokenParamPart>;
 };
 /**
  * route entry as found in file-system, before any processing
@@ -48,6 +51,7 @@ export type RouteEntry = {
     file: string;
     fileFullpath: string;
     pathTokens: Array<PathToken>;
+    pathPattern: string;
 };
 export type NestedRouteEntry = {
     index: Omit<RouteEntry, "fileFullpath"> | undefined;
@@ -58,21 +62,20 @@ export type NestedRouteEntry = {
 export type ApiRoute = RouteEntry & {
     params: {
         id: string;
-        schema: Array<Required<PathToken>["param"]>;
+        schema: Array<PathTokenParamPart>;
         resolvedType: ResolvedType | undefined;
     };
     numericParams: Array<string>;
     optionalParams: boolean;
     methods: Array<string>;
     typeDeclarations: Array<TypeDeclaration>;
-    payloadTypes: Array<PayloadType>;
-    responseTypes: Array<ResponseType>;
+    validationDefinitions: Array<ValidationDefinition>;
     referencedFiles: Array<string>;
 };
 export type ApiUse = RouteEntry;
 export type PageRoute = RouteEntry & {
     params: {
-        schema: Array<Required<PathToken>["param"]>;
+        schema: Array<PathTokenParamPart>;
     };
 };
 export type PageLayout = RouteEntry;
@@ -89,20 +92,34 @@ export type ResolvedEntry = {
     kind: "pageLayout";
     entry: PageLayout;
 };
-export type PayloadType = {
-    id: string;
-    responseTypeId?: string | undefined;
-    method: string;
-    skipValidation: boolean;
-    isOptional: boolean;
-    resolvedType: ResolvedType | undefined;
-};
-export type ResponseType = {
-    id: string;
-    method: string;
-    skipValidation: boolean;
-    resolvedType: ResolvedType | undefined;
-};
+export type ValidationDefinition = {
+    method: HTTPMethod;
+    runtimeValidation?: boolean | undefined;
+    customErrors?: Record<string, string> | undefined;
+} & ({
+    target: "response";
+    variants: Array<{
+        id: string;
+        status: number;
+        contentType: string | undefined;
+        body: string | undefined;
+        resolvedType?: ResolvedType | undefined;
+    }>;
+} | {
+    target: Exclude<ValidationTarget, "response">;
+    contentType?: string | undefined;
+    schema: {
+        id: string;
+        text: string;
+        resolvedType?: ResolvedType | undefined;
+    };
+});
+export type RequestValidationDefinition = Exclude<ValidationDefinition, {
+    target: "response";
+}>;
+export type ResponseValidationDefinition = Extract<ValidationDefinition, {
+    target: "response";
+}>;
 export type TypeDeclaration = {
     text: string;
     importDeclaration?: {
@@ -143,7 +160,7 @@ type GeneratorFactoryReturn = {
 };
 export type GeneratorFactory<T = undefined> = T extends undefined ? (options: PluginOptionsResolved) => Promise<GeneratorFactoryReturn> : (options: PluginOptionsResolved, extra: T) => Promise<GeneratorFactoryReturn>;
 export type GeneratorConstructor = {
-    kind?: "api" | "fetch" | "ssr";
+    slot?: "api" | "fetch" | "ssr";
     name: string;
     /**
      * Specifies the module import path and provided config for worker thread imports.
@@ -155,6 +172,12 @@ export type GeneratorConstructor = {
     moduleImport: string;
     moduleConfig: unknown;
     factory: GeneratorFactory;
+    /**
+     * Package dependencies required by this generator.
+     * The dev plugin checks installation status before running.
+     * */
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
     options?: {
         /**
          * Enables type resolution for generators that require fully resolved type information.
@@ -165,12 +188,6 @@ export type GeneratorConstructor = {
         resolveTypes?: boolean;
     };
 };
-export type Formatter = (text: string, filePath: string) => string;
-export type FormatterConstructor<ModuleConfig extends object | undefined = undefined> = {
-    moduleImport: string;
-    moduleConfig: ModuleConfig;
-    formatter: Formatter;
-};
 type RouterSetup<R> = {
     clientRouter: () => R | Promise<R>;
     serverRouter: (ssrOpts: {

package/pkg/src/routes-factory/base.d.ts

@@ -1,17 +0,0 @@
-import type { PathToken, RouteEntry } from "../types";
-export declare const pathTokensFactory: (path: string) => Array<PathToken>;
-/**
- * Sort routes so that more specific (static) paths come before dynamic ones.
- *
- * This is important because dynamic segments
- * (e.g., `:id` or `*catchall`) are more general,
- * and can match values that should be routed to more specific static paths.
- *
- * For example, given:
- *   - `/users/account`
- *   - `/users/:id`
- *
- * If `/users/:id` comes first, visiting `/users/account` would incorrectly match it,
- * treating "account" as an `id`. So static routes must take precedence.
- * */
-export declare const sortRoutes: (a: Pick<RouteEntry, "name" | "pathTokens">, b: Pick<RouteEntry, "name" | "pathTokens">) => number;

package/pkg/test/@fixtures/app/lib/@src/{api}/articles/[...path]/index.ts/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT3255961905 = {
-    "path"?: Array<string>;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/articles/[...path]/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT3255961905 = {
-    "path"?: Array<string>;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/books/[category]/[[author]]/index.ts/types.d.ts

@@ -1,4 +0,0 @@
-export type ParamsT1336054126 = {
-    "category": string;
-    "author"?: string;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/books/[category]/[[author]]/types.d.ts

@@ -1,4 +0,0 @@
-export type ParamsT1336054126 = {
-    "category": string;
-    "author"?: string;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/books/[category]/index.ts/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT3178169874 = {
-    "category": string;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/books/[category]/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT3178169874 = {
-    "category": string;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/books/index.ts/types.d.ts

@@ -1 +0,0 @@
-export type ParamsT1243294354 = {};

package/pkg/test/@fixtures/app/lib/@src/{api}/books/types.d.ts

@@ -1 +0,0 @@
-export type ParamsT1243294354 = {};

package/pkg/test/@fixtures/app/lib/@src/{api}/files/[[folder]]/[[id]].json/index.ts/types.d.ts

@@ -1,4 +0,0 @@
-export type ParamsT3712977113 = {
-    "folder"?: string;
-    "id"?: string;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/files/[[folder]]/[[id]].json/types.d.ts

@@ -1,4 +0,0 @@
-export type ParamsT3712977113 = {
-    "folder"?: string;
-    "id"?: string;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/files/[[folder]]/index.ts/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT3375119921 = {
-    "folder"?: string;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/files/[[folder]]/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT3375119921 = {
-    "folder"?: string;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/index/index.ts/types.d.ts

@@ -1 +0,0 @@
-export type ParamsT2155046657 = {};

package/pkg/test/@fixtures/app/lib/@src/{api}/index/types.d.ts

@@ -1 +0,0 @@
-export type ParamsT2155046657 = {};

package/pkg/test/@fixtures/app/lib/@src/{api}/pages/[...path].html/index.ts/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT163275439 = {
-    "path"?: Array<string>;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/pages/[...path].html/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT163275439 = {
-    "path"?: Array<string>;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/users/[id].json/index.ts/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT2999293711 = {
-    "id": string;
-};

package/pkg/test/@fixtures/app/lib/@src/{api}/users/[id].json/types.d.ts

@@ -1,3 +0,0 @@
-export type ParamsT2999293711 = {
-    "id": string;
-};