@kosmojs/dev 0.0.10 → 0.0.20

package/pkg/src/{base-plugin/routes → routes-factory}/resolve.d.ts

@@ -1,4 +1,4 @@
-import { type PluginOptionsResolved, type ResolvedEntry, type RouteEntry } from "@kosmojs/devlib";
+import type { PluginOptionsResolved, ResolvedEntry, RouteEntry } from "../types";
 export type ResolverSignature = {
     name: string;
     handler: (updatedFile?: string) => Promise<ResolvedEntry>;
@@ -12,12 +12,12 @@ export declare const PAGE_INDEX_PATTERN = "index.{tsx,vue}";
 export declare const PAGE_LAYOUT_BASENAME = "layout";
 export declare const PAGE_LAYOUT_PATTERN = "layout.{tsx,vue}";
 export declare const scanRoutes: ({ appRoot, sourceFolder, }: Pick<PluginOptionsResolved, "appRoot" | "sourceFolder">) => Promise<string[]>;
-export declare const isRouteFile: (file: string, { appRoot, sourceFolder, }: Pick<PluginOptionsResolved, "appRoot" | "sourceFolder">) => [folder: string, file: string] | undefined;
+export declare const isRouteFile: (file: string, { appRoot, sourceFolder, }: Pick<PluginOptionsResolved, "appRoot" | "sourceFolder">) => [folder: string, file: string] | false;
 export declare const isApiRoute: (file: string) => boolean;
 export declare const isApiUse: (file: string) => boolean;
 export declare const isPageRoute: (file: string) => boolean;
 export declare const isPageLayout: (file: string) => boolean;
-export declare const createRouteEntry: (_file: string, { appRoot, sourceFolder, }: Pick<PluginOptionsResolved, "appRoot" | "sourceFolder">) => RouteEntry | undefined;
+export declare const createRouteEntry: (fileFullpath: string, { appRoot, sourceFolder, }: Pick<PluginOptionsResolved, "appRoot" | "sourceFolder">) => RouteEntry | undefined;
 type ResolverFactory = (pluginOptions: PluginOptionsResolved) => (entry: RouteEntry) => ResolverSignature;
 export declare const pageLayoutResolverFactory: ResolverFactory;
 export declare const pageRouteResolverFactory: ResolverFactory;

package/pkg/src/stub-generator/index.d.ts

@@ -1,4 +1,4 @@
-import { type GeneratorConstructor } from "@kosmojs/devlib";
+import type { GeneratorConstructor } from "../types";
 /**
  * Generates stub files required by various generators.
  * Ensures cross-generator dependencies remain resolvable

package/pkg/src/typebox.d.ts

@@ -0,0 +1,2 @@
+import type { PluginOptionsResolved } from "./types";
+export declare const typeboxLiteralText: (text: string, options: Pick<PluginOptionsResolved, "refineTypeName">) => string;

package/pkg/src/types.d.ts

@@ -0,0 +1,288 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ResolvedType } from "tfusion";
+import type { ResolvedConfig } from "vite";
+export type PluginOptions = {
+    generators?: Array<GeneratorConstructor>;
+    formatters?: Array<FormatterConstructor>;
+    /**
+     * Name to use for custom runtime validation refinements.
+     * @default "TRefine"
+     * */
+    refineTypeName?: string;
+};
+export type PluginOptionsResolved = {
+    baseurl: string;
+    apiurl: string;
+    appRoot: string;
+    sourceFolder: string;
+    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">;
+export type PathToken = {
+    orig: string;
+    base: string;
+    path: string;
+    ext: string;
+    param?: {
+        name: string;
+        const: string;
+        isRequired?: boolean;
+        isOptional?: boolean;
+        isRest?: boolean;
+    };
+};
+/**
+ * route entry as found in file-system, before any processing
+ * */
+export type RouteEntry = {
+    id: string;
+    name: string;
+    folder: string;
+    file: string;
+    fileFullpath: string;
+    pathTokens: Array<PathToken>;
+};
+export type NestedRouteEntry = {
+    index: Omit<RouteEntry, "fileFullpath"> | undefined;
+    layout: Omit<RouteEntry, "fileFullpath"> | undefined;
+    parent: string | undefined;
+    children: Array<NestedRouteEntry>;
+};
+export type ApiRoute = RouteEntry & {
+    params: {
+        id: string;
+        schema: Array<Required<PathToken>["param"]>;
+        resolvedType: ResolvedType | undefined;
+    };
+    numericParams: Array<string>;
+    optionalParams: boolean;
+    methods: Array<string>;
+    typeDeclarations: Array<TypeDeclaration>;
+    payloadTypes: Array<PayloadType>;
+    responseTypes: Array<ResponseType>;
+    referencedFiles: Array<string>;
+};
+export type ApiUse = RouteEntry;
+export type PageRoute = RouteEntry & {
+    params: {
+        schema: Array<Required<PathToken>["param"]>;
+    };
+};
+export type PageLayout = RouteEntry;
+export type ResolvedEntry = {
+    kind: "apiRoute";
+    entry: ApiRoute;
+} | {
+    kind: "apiUse";
+    entry: ApiUse;
+} | {
+    kind: "pageRoute";
+    entry: PageRoute;
+} | {
+    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 TypeDeclaration = {
+    text: string;
+    importDeclaration?: {
+        name: string;
+        alias?: string | undefined;
+        path: string;
+    };
+    exportDeclaration?: {
+        name: string;
+        alias?: string | undefined;
+        path?: string | undefined;
+    };
+    typeAliasDeclaration?: {
+        name: string;
+    };
+    interfaceDeclaration?: {
+        name: string;
+    };
+    enumDeclaration?: {
+        name: string;
+    };
+};
+export type PathParams = {
+    text: string;
+    properties: Array<{
+        name: string;
+        type: string;
+    }>;
+};
+export type WatcherEvent = {
+    kind: "create" | "update" | "delete";
+    file: string;
+};
+export type WatchHandler = (entries: Array<ResolvedEntry>, event?: WatcherEvent) => Promise<void>;
+type GeneratorFactoryReturn = {
+    watch: WatchHandler;
+    build: (entries: Array<ResolvedEntry>) => Promise<void>;
+};
+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";
+    name: string;
+    /**
+     * Specifies the module import path and provided config for worker thread imports.
+     *
+     * In development mode, generators run inside a worker thread.
+     * Since functions cannot be directly passed to worker threads,
+     * this provides the module assets for the worker to dynamically import the generator.
+     * */
+    moduleImport: string;
+    moduleConfig: unknown;
+    factory: GeneratorFactory;
+    options?: {
+        /**
+         * Enables type resolution for generators that require fully resolved type information.
+         *
+         * When `true`, types are resolved to their flattened representations before
+         * generator execution, making complete type data available.
+         * */
+        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: {
+        url: URL;
+    }) => R | Promise<R>;
+};
+export type RouterFactory<AppT, RouteT, RouterT> = (factory: (app: AppT, routes: Array<RouteT>) => RouterSetup<RouterT> | Promise<RouterSetup<RouterT>>) => (app: AppT, routes: Array<RouteT>, ssrOpts?: {
+    url: URL;
+}) => RouterT | Promise<RouterT>;
+type RenderSetup = {
+    clientRender: () => void | Promise<void>;
+    serverRender: () => void | Promise<void>;
+};
+export type RenderFactory = (factory: () => RenderSetup | Promise<RenderSetup>) => void | Promise<void>;
+/**
+ * Minimal shape of Vite's manifest.json entries.
+ * */
+export type SSRManifestEntry = {
+    file: string;
+    src?: string;
+    isEntry?: boolean;
+    isDynamicEntry?: boolean;
+    css?: string[];
+    assets?: string[];
+    imports?: string[];
+    dynamicImports?: string[];
+};
+/**
+ * SSR environment options passed to user-defined
+ * renderToString / renderToStream functions.
+ * */
+export type SSROptions = {
+    template: string;
+    manifest: Record<string, SSRManifestEntry>;
+    criticalCss: Array<{
+        text: string;
+        path: string;
+    }>;
+    request: IncomingMessage;
+    response: ServerResponse;
+};
+/**
+ * Return type for string-based SSR rendering.
+ *
+ * - `head` is optional, user may choose to:
+ *    - insert the provided critical CSS (opt.criticalCss),
+ *    - override it (e.g. remove some styles),
+ *    - or supply additional <meta>/<link>/<style> tags.
+ *
+ * - `html` is the main server-rendered body markup for hydration.
+ * */
+export type SSRStringReturn = {
+    head?: string;
+    html: string;
+};
+/**
+ * SSR string mode
+ *
+ * Returns head + html, synchronously or async.
+ *
+ * The server will:
+ * - insert returned `head` into the HTML template
+ * - place returned `html` into the body placeholder
+ * */
+export type SSRString = (url: URL, opt: SSROptions) => SSRStringReturn | Promise<SSRStringReturn>;
+/**
+ * SSR stream mode
+ *
+ * Writes directly to the HTTP response.
+ *
+ * Responsibility of the user/render function:
+ * - insert head + critical CSS at the correct time (before first flush)
+ * - manage partial flushing, suspense boundaries, etc.
+ *
+ * The server will NOT modify the response body in this mode,
+ * thus the renderer **must call `response.end()`** when streaming is finished,
+ * otherwise the HTTP request will remain open and the client will hang.
+ * */
+export type SSRStream = (url: URL, opt: SSROptions) => void | Promise<void>;
+/**
+ * Default exported object from the SSR entry module (e.g. entry/server.ts).
+ * */
+export type SSRSetup = {
+    /**
+     * The server calls render functions with current request URL and SSROptions.
+     *
+     * If both are provided, `renderToStream` takes precedence since streaming
+     * enables earlier flushing and improved Time-to-First-Byte (TTFB).
+     * `renderToString` will only be used if a streaming renderer is not available.
+     * */
+    renderToString?: SSRString;
+    renderToStream?: SSRStream;
+    /**
+     * Controls whether the SSR server should handle static asset requests (JS, CSS, images, fonts, etc.)
+     *
+     *   true  (default)
+     *     → All built client assets are served directly from memory by SSR server.
+     *     → Easiest setup - no external file server required.
+     *
+     *   false
+     *     → A reverse proxy/CDN *must* serve all static files.
+     *     → Otherwise any asset URL requested from browser (JS/CSS/img) will return `404`.
+     *
+     * Notes:
+     *   - `criticalCss.text` can still be inlined regardless of this setting.
+     *   - `criticalCss.url` remains provided for `<link>` usage,
+     *     but loading that URL is the responsibility of the external static server.
+     *
+     * This option enables deployments where SSR and static delivery
+     * are cleanly separated (e.g., Node behind nginx / cloud static hosting).
+     * */
+    serveStaticAssets?: boolean;
+};
+export type SSRFactory = (factory: () => SSRSetup | Promise<SSRSetup>) => SSRSetup | Promise<SSRSetup>;
+export {};

package/pkg/stub-generator/index.js

@@ -1,9 +1,149 @@
 // src/stub-generator/index.ts
-import { dirname } from "node:path";
-import {
-  pathResolver,
-  renderToFile
-} from "@kosmojs/devlib";
+import { dirname as dirname2 } from "node:path";
+
+// src/paths.ts
+import { join } from "node:path";
+
+// src/defaults.ts
+var defaults = {
+  appPrefix: "~",
+  srcPrefix: "@",
+  libPrefix: "_",
+  coreDir: "core",
+  srcDir: "src",
+  libDir: "lib",
+  configDir: "config",
+  apiDir: "api",
+  pagesDir: "pages",
+  entryDir: "entry",
+  fetchDir: "fetch"
+};
+
+// src/paths.ts
+var pathResolver = ({
+  appRoot,
+  sourceFolder
+}) => {
+  const createPath = (...a) => {
+    return appRoot ? join(appRoot, ...a) : join(...a);
+  };
+  const createImport = {
+    coreApi(...a) {
+      return join(defaults.appPrefix, defaults.coreDir, defaults.apiDir, ...a);
+    },
+    src(...a) {
+      return join(defaults.srcPrefix, sourceFolder, ...a);
+    },
+    config(...a) {
+      return this.src(defaults.configDir, ...a);
+    },
+    api(...a) {
+      return this.src(defaults.apiDir, ...a);
+    },
+    pages(...a) {
+      return this.src(defaults.pagesDir, ...a);
+    },
+    lib(...a) {
+      return join(defaults.libPrefix, sourceFolder, ...a);
+    },
+    libApi(...a) {
+      return this.lib(defaults.apiDir, ...a);
+    },
+    libEntry(...a) {
+      return this.lib(defaults.entryDir, ...a);
+    },
+    fetch(...a) {
+      return this.lib(defaults.fetchDir, ...a);
+    }
+  };
+  return {
+    createPath: {
+      coreApi(...a) {
+        return createPath(defaults.coreDir, defaults.apiDir, ...a);
+      },
+      src(...a) {
+        return createPath(defaults.srcDir, sourceFolder, ...a);
+      },
+      api(...a) {
+        return this.src(defaults.apiDir, ...a);
+      },
+      pages(...a) {
+        return this.src(defaults.pagesDir, ...a);
+      },
+      config(...a) {
+        return this.src(defaults.configDir, ...a);
+      },
+      entry(...a) {
+        return this.src(defaults.entryDir, ...a);
+      },
+      lib(...a) {
+        return createPath(defaults.libDir, defaults.srcDir, sourceFolder, ...a);
+      },
+      libApi(...a) {
+        return this.lib(defaults.apiDir, ...a);
+      },
+      libEntry(...a) {
+        return this.lib(defaults.entryDir, ...a);
+      },
+      libPages(...a) {
+        return this.lib(defaults.pagesDir, ...a);
+      },
+      fetch(...a) {
+        return this.lib(defaults.fetchDir, ...a);
+      }
+    },
+    createImport,
+    createImportHelper: (key, ...a) => {
+      return createImport[key](...a.slice(0, -1));
+    }
+  };
+};
+
+// src/render.ts
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join as join2 } from "node:path";
+import crc from "crc/crc32";
+import handlebars from "handlebars";
+
+// src/fs.ts
+import { access, constants } from "node:fs/promises";
+var pathExists = async (path) => {
+  try {
+    await access(path, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+// src/render.ts
+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);
+  if (await pathExists(file)) {
+    const { overwrite = true } = { ...options };
+    if (overwrite === false) {
+      return;
+    }
+    const fileContent = await readFile(file, "utf8");
+    if (typeof overwrite === "function" && !overwrite(fileContent)) {
+      return;
+    }
+    if (crc(content) === crc(fileContent)) {
+      return;
+    }
+  }
+  await mkdir(dirname(file), { recursive: true });
+  await writeFile(file, content, "utf8");
+};
 
 // load-as-text:/volumes/studio/OpenSource/KosmoJS/Kosmo/packages/core/dev/src/stub-generator/templates/env.d.ts
 var env_d_default = '/**\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';
@@ -21,28 +161,30 @@ var stub_generator_default = () => {
     moduleImport: import.meta.filename,
     moduleConfig: void 0,
     async factory({ appRoot, sourceFolder }) {
-      return {
-        async watchHandler(entries) {
-          const { resolve } = pathResolver({ appRoot, sourceFolder });
-          await renderToFile(resolve("libDir", "env.d.ts"), env_d_default, {});
-          await renderToFile(
-            resolve("libDir", ".gitignore"),
-            gitignore_default,
-            {},
-            { overwrite: false }
-          );
-          for (const { kind, entry } of entries) {
-            if (kind === "apiRoute") {
-              await renderToFile(
-                resolve("apiLibDir", dirname(entry.file), "schemas.ts"),
-                schemas_default,
-                { route: entry },
-                { overwrite: false }
-              );
-            }
+      const generateLibFiles = async (entries) => {
+        const { createPath } = pathResolver({ appRoot, sourceFolder });
+        await renderToFile(createPath.lib("../env.d.ts"), env_d_default, {});
+        await renderToFile(
+          createPath.lib("../.gitignore"),
+          gitignore_default,
+          {},
+          { overwrite: false }
+        );
+        for (const { kind, entry } of entries) {
+          if (kind === "apiRoute") {
+            await renderToFile(
+              createPath.libApi(dirname2(entry.file), "schemas.ts"),
+              schemas_default,
+              { route: entry },
+              { overwrite: false }
+            );
           }
         }
       };
+      return {
+        watch: generateLibFiles,
+        build: generateLibFiles
+      };
     }
   };
 };

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/stub-generator/index.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 {\n  type GeneratorConstructor,\n  pathResolver,\n  renderToFile,\n} from \"@kosmojs/devlib\";\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      return {\n        async watchHandler(entries) {\n          const { resolve } = pathResolver({ appRoot, sourceFolder });\n\n          /**\n           * expose TRefine as a global type.\n           * not supposed to be overriden by generators.\n           * */\n          await renderToFile(resolve(\"libDir\", \"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            resolve(\"libDir\", \".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                resolve(\"apiLibDir\", dirname(entry.file), \"schemas.ts\"),\n                schemasTpl,\n                { route: entry },\n                { overwrite: false },\n              );\n            }\n          }\n        },\n      };\n    },\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,eAAe;AAExB;AAAA,EAEE;AAAA,EACA;AAAA,OACK;;;ACNP;;;ACAA;;;ACAA;;;AHiBA,IAAO,yBAAQ,MAA4B;AACzC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,cAAc,YAAY;AAAA,IAC1B,cAAc;AAAA,IACd,MAAM,QAAQ,EAAE,SAAS,aAAa,GAAG;AACvC,aAAO;AAAA,QACL,MAAM,aAAa,SAAS;AAC1B,gBAAM,EAAE,QAAQ,IAAI,aAAa,EAAE,SAAS,aAAa,CAAC;AAM1D,gBAAM,aAAa,QAAQ,UAAU,UAAU,GAAG,eAAQ,CAAC,CAAC;AAM5D,gBAAM;AAAA,YACJ,QAAQ,UAAU,YAAY;AAAA,YAC9B;AAAA,YACA,CAAC;AAAA,YACD,EAAE,WAAW,MAAM;AAAA,UACrB;AAEA,qBAAW,EAAE,MAAM,MAAM,KAAK,SAAS;AACrC,gBAAI,SAAS,YAAY;AAIvB,oBAAM;AAAA,gBACJ,QAAQ,aAAa,QAAQ,MAAM,IAAI,GAAG,YAAY;AAAA,gBACtD;AAAA,gBACA,EAAE,OAAO,MAAM;AAAA,gBACf,EAAE,WAAW,MAAM;AAAA,cACrB;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
-  "names": []
+  "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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",
+  "names": ["dirname", "join", "dirname"]
 }

package/pkg/test/routes/{base.d.ts → index.d.ts}

@@ -1,4 +1,4 @@
-import type { PluginOptionsResolved } from "@kosmojs/devlib";
+import type { PluginOptionsResolved } from "../../src/types";
 export declare const appRoot: string;
-export declare const sourceFolder = "@src";
+export declare const sourceFolder = "test";
 export declare const pluginOptions: Pick<PluginOptionsResolved, "appRoot" | "sourceFolder">;