@kosmojs/lib 0.5.0 → 0.6.2

package/pkg/paths.d.ts

@@ -1,11 +1,9 @@
-import { type SourceFolder } from "@kosmojs/core";
+import { type ProjectSettings, type SourceFolder } from "@kosmojs/core";
 type Options = {
     origin: "src" | "lib";
 };
 type CreateImport = Record<"src" | "api" | "entry" | "pages" | "lib" | "libCore" | "libApi" | "libEntry", (a: Array<string>, o: Options) => string>;
-export declare const pathResolver: (sourceFolder: Omit<SourceFolder, "root"> & {
-    root?: string | undefined;
-}) => {
+export declare const pathResolver: ({ root, distDir }: ProjectSettings, { name }: SourceFolder) => {
     createPath: Record<"src" | "api" | "pages" | "entry" | "lib" | "libCore" | "libApi" | "libEntry" | "libPages" | "distDir", (...a: Array<string>) => string>;
     createImport: CreateImport;
     createImportHelpers: (o: Options) => {

package/pkg/ports.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Probe whether a single TCP port is free on given host.
+ *
+ * Resolves `true` only after the probe server has fully closed,
+ * so the caller can immediately rebind without racing the OS.
+ * `unref()` keeps a dangling probe from holding the event loop open.
+ * */
+export declare const isPortFree: (host: string, port: number, timeoutMs?: number) => Promise<boolean>;
+/**
+ * Find `count` consecutive free ports by probing random offsets within minPort..maxPort.
+ * Each attempt picks a uniformly random start, probes the whole window,
+ * and returns it only if every port is free.
+ * Failed attempts are cheap because only the window is probed - no full-range scan.
+ * */
+export declare const findFreePortRange: (host: string, count: number, { minPort, maxPort, attempts, }?: {
+    minPort?: number;
+    maxPort?: number;
+    attempts?: number;
+}) => Promise<Array<number>>;

package/pkg/routes/base.d.ts

@@ -1,4 +1,4 @@
-import { type ResolvedEntry, type RouteEntry, type SourceFolder } from "@kosmojs/core";
+import { type ProjectSettings, type ResolvedEntry, type RouteEntry, type SourceFolder } from "@kosmojs/core";
 export type ResolverSignature = {
     name: string;
     handler: (updatedFile?: string) => Promise<ResolvedEntry>;
@@ -11,13 +11,13 @@ export declare const PAGE_INDEX_BASENAME = "index";
 export declare const PAGE_INDEX_PATTERN = "index.{tsx,vue,svelte,mdx,md}";
 export declare const PAGE_LAYOUT_BASENAME = "layout";
 export declare const PAGE_LAYOUT_PATTERN = "layout.{tsx,vue,svelte,mdx}";
-export declare const scanRoutes: (sourceFolder: SourceFolder) => Promise<string[]>;
-export declare const isRouteFile: (file: string, sourceFolder: SourceFolder) => [folder: string, file: string] | false;
+export declare const scanRoutes: (projectSettings: ProjectSettings, sourceFolder: SourceFolder) => Promise<string[]>;
+export declare const isRouteFile: (projectSettings: ProjectSettings, sourceFolder: SourceFolder, file: string) => [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: (fileFullpath: string, sourceFolder: SourceFolder) => RouteEntry | undefined;
+export declare const createRouteEntry: (projectSettings: ProjectSettings, sourceFolder: SourceFolder, fileFullpath: string) => RouteEntry | undefined;
 /**
  * Compare two route entries for registration order.
  *

package/pkg/routes/index.d.ts

@@ -1,9 +1,9 @@
-import { type RouteResolverCacheFactory, type SourceFolder } from "@kosmojs/core";
+import { type ProjectSettings, type RouteResolverCacheFactory, type SourceFolder } from "@kosmojs/core";
 import { type ResolverSignature } from "./base";
 export * from "./base";
 export * from "./nesting";
 export * from "./paths";
-export declare const routesFactory: (sourceFolder: SourceFolder, cacheFactory?: RouteResolverCacheFactory) => Promise<{
+export declare const routesFactory: (projectSettings: ProjectSettings, sourceFolder: SourceFolder, cacheFactory?: RouteResolverCacheFactory) => Promise<{
     resolvers: Map<string, ResolverSignature>;
     resolversFactory: (routeFiles: Array<string>) => Map<string, ResolverSignature>;
 }>;

package/pkg/routes/resolve.d.ts

@@ -1,3 +1,3 @@
-import { type RouteEntry, type RouteResolverCacheFactory, type SourceFolder } from "@kosmojs/core";
+import { type ProjectSettings, type RouteEntry, type RouteResolverCacheFactory, type SourceFolder } from "@kosmojs/core";
 import type { ResolverSignature } from "./base";
-export declare const resolverFactory: (sourceFolder: SourceFolder, cacheFactory?: RouteResolverCacheFactory) => Record<"pageLayoutResolver" | "pageRouteResolver" | "apiUseResolver" | "apiRouteResolver", (entry: RouteEntry) => ResolverSignature>;
+export declare const resolverFactory: (projectSettings: ProjectSettings, sourceFolder: SourceFolder, cacheFactory?: RouteResolverCacheFactory) => Record<"pageLayoutResolver" | "pageRouteResolver" | "apiUseResolver" | "apiRouteResolver", (entry: RouteEntry) => ResolverSignature>;

package/pkg/tsconfig.d.ts

@@ -0,0 +1,65 @@
+export declare const generateTsconfig: ({ dependencies, devDependencies, }: Record<"dependencies" | "devDependencies", Record<string, string>>, sourceFolder?: string) => {
+    include: string[];
+    compilerOptions: {
+        moduleResolution: string;
+        module: string;
+        target: string;
+        strict: boolean;
+        exactOptionalPropertyTypes: boolean;
+        noImplicitAny: boolean;
+        noImplicitThis: boolean;
+        noImplicitOverride: boolean;
+        noImplicitReturns: boolean;
+        noUnusedLocals: boolean;
+        noUnusedParameters: boolean;
+        allowArbitraryExtensions: boolean;
+        allowImportingTsExtensions: boolean;
+        allowUnreachableCode: boolean;
+        allowUnusedLabels: boolean;
+        useUnknownInCatchVariables: boolean;
+        noFallthroughCasesInSwitch: boolean;
+        noUncheckedSideEffectImports: boolean;
+        resolveJsonModule: boolean;
+        esModuleInterop: boolean;
+        verbatimModuleSyntax: boolean;
+        skipLibCheck: boolean;
+        noEmit: boolean;
+        types: string[];
+        paths: {
+            [x: string]: string[];
+        };
+    };
+    exclude?: never;
+} | {
+    include?: never;
+    exclude: string[];
+    compilerOptions: {
+        types: string[];
+        moduleResolution: string;
+        module: string;
+        target: string;
+        strict: boolean;
+        exactOptionalPropertyTypes: boolean;
+        noImplicitAny: boolean;
+        noImplicitThis: boolean;
+        noImplicitOverride: boolean;
+        noImplicitReturns: boolean;
+        noUnusedLocals: boolean;
+        noUnusedParameters: boolean;
+        allowArbitraryExtensions: boolean;
+        allowImportingTsExtensions: boolean;
+        allowUnreachableCode: boolean;
+        allowUnusedLabels: boolean;
+        useUnknownInCatchVariables: boolean;
+        noFallthroughCasesInSwitch: boolean;
+        noUncheckedSideEffectImports: boolean;
+        resolveJsonModule: boolean;
+        esModuleInterop: boolean;
+        verbatimModuleSyntax: boolean;
+        skipLibCheck: boolean;
+        noEmit: boolean;
+        paths: {
+            [x: string]: string[];
+        };
+    };
+};

package/pkg/vite.d.ts

@@ -1,5 +1,5 @@
 import type { Plugin } from "vite";
-import { type ProjectSettings, type SourceFolder } from "@kosmojs/core";
+import type { ChassisCommand, ProjectSettings, SourceFolder } from "@kosmojs/core";
 /**
  * Resolves Kosmo's generated import prefixes to absolute file paths.
  *
@@ -52,7 +52,7 @@ import { type ProjectSettings, type SourceFolder } from "@kosmojs/core";
  * tsconfig generator uses, so alias resolution here can never drift from the
  * paths that were written into the generated tsconfig.
  * */
-export declare const tsconfigPaths: (sourceFolder: SourceFolder) => Plugin;
+export declare const tsconfigPaths: (projectSettings: ProjectSettings, sourceFolder: SourceFolder) => Plugin;
 declare const nodePrefix: () => Plugin;
 /**
  * Resolves the CSR/SSR variant of env-sensitive modules.
@@ -68,13 +68,14 @@ declare const nodePrefix: () => Plugin;
  *
  * Generators declare their modules via `factory.virtualModules()`.
  * */
-export declare const virtualModules: (sourceFolder: SourceFolder, { kind, command, }: {
+export declare const virtualModules: (projectSettings: ProjectSettings, sourceFolder: SourceFolder, { kind, command }: {
     kind: "csr" | "ssr";
-    command: ProjectSettings["command"];
+    command: ChassisCommand;
 }) => Plugin;
 export declare const vitePlugins: {
     tsconfigPaths: typeof tsconfigPaths;
     nodePrefix: typeof nodePrefix;
     virtualModules: typeof virtualModules;
 };
+export declare const cacheDir: ({ root }: ProjectSettings, { name }: SourceFolder, target: `frontend:${ChassisCommand}` | `backend:${ChassisCommand}` | "sidecar") => string;
 export {};