@kosmojs/lib 0.0.26

package/LICENSE

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

package/README.md

@@ -0,0 +1,17 @@
+# @kosmojs/lib
+
+TODO: Add package description
+
+## Installation
+
+```sh
+npm install -D @kosmojs/lib
+```
+
+## Documentation
+
+See [kosmojs.dev](https://kosmojs.dev)
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,39 @@
+{
+  "type": "module",
+  "name": "@kosmojs/lib",
+  "version": "0.0.26",
+  "author": "Slee Woo",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "pkg/*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./pkg/index.d.ts",
+      "default": "./pkg/index.js"
+    }
+  },
+  "dependencies": {
+    "@topcli/spinner": "^4.2.1",
+    "crc": "^4.3.2",
+    "handlebars": "^4.7.8",
+    "mime-types": "^3.0.2",
+    "path-to-regexp": "^8.3.0",
+    "picomatch": "^4.0.4",
+    "tfusion": "^0.0.23",
+    "ts-morph": "^27.0.2",
+    "@kosmojs/api": "^0.0.26"
+  },
+  "devDependencies": {
+    "@types/mime-types": "^3.0.1",
+    "@types/picomatch": "^4.0.2",
+    "vite": "^8.0.2"
+  },
+  "scripts": {
+    "build": "esbuilder src/index.ts",
+    "test": "vitest --root ../../.. --project core/lib"
+  }
+}

package/pkg/ast.d.ts

@@ -0,0 +1,41 @@
+import { flattener } from "tfusion";
+import { type CallExpression, Project, type ProjectOptions, type SourceFile } from "ts-morph";
+import { type HTTPMethod } from "@kosmojs/api";
+import type { ApiRoute, SourceFolder, TypeDeclaration, ValidationDefinition } from "./types";
+type PathResolver = (path: string) => string;
+export declare const astFactory: () => {
+    createProject: (opts?: ProjectOptions) => Project;
+    extractDefaultExport: (sourceFile: SourceFile) => CallExpression | undefined;
+    extractParamsRefinements: (callExpression: CallExpression) => Array<{
+        index: number;
+        text: string;
+    }> | undefined;
+    extractRouteMethods: (route: Pick<ApiRoute, "id" | "name">, callExpression: CallExpression) => Array<{
+        method: HTTPMethod;
+        validationDefinitions: Array<ValidationDefinition>;
+    }>;
+    extractTypeDeclarations: (sourceFile: SourceFile, opts?: {
+        relpathResolver?: PathResolver;
+        withReferencedFiles?: boolean;
+    }) => [d: Array<TypeDeclaration>, f?: Array<string>];
+    resolveRouteSignature: (route: Pick<ApiRoute, "id" | "name" | "fileFullpath" | "optionalParams">, opts?: {
+        relpathResolver?: PathResolver;
+        sourceFile?: SourceFile;
+        withReferencedFiles?: boolean;
+    }) => Promise<{
+        typeDeclarations: TypeDeclaration[];
+        paramsRefinements: {
+            index: number;
+            text: string;
+        }[] | undefined;
+        methods: ("HEAD" | "OPTIONS" | "GET" | "PUT" | "PATCH" | "POST" | "DELETE")[];
+        validationDefinitions: ValidationDefinition[];
+        referencedFiles: string[] | undefined;
+    }>;
+    typeResolverFactory: ({ root }: SourceFolder) => {
+        getSourceFile: (fileFullpath: string) => SourceFile;
+        refreshSourceFile: (fileFullpath: string) => Promise<void>;
+        literalTypesResolver: (literalTypes: string, options: Parameters<typeof flattener>[2]) => import("tfusion").ResolvedType[];
+    };
+};
+export {};

package/pkg/defaults.d.ts

@@ -0,0 +1,14 @@
+export declare const defaults: {
+    appPrefix: string;
+    srcPrefix: string;
+    libPrefix: string;
+    coreDir: string;
+    srcDir: string;
+    libDir: string;
+    configDir: string;
+    apiDir: string;
+    pagesDir: string;
+    entryDir: string;
+    fetchDir: string;
+    refineTypeName: string;
+};

package/pkg/generators.d.ts

@@ -0,0 +1,58 @@
+import type { DefineGenerator, DefineGeneratorFactory, GeneratorMeta } from "./types";
+export declare const GENERATOR_META: unique symbol;
+/**
+ * Define a generator with metadata stored internally.
+ *
+ * Metadata is attached to both the generator module and its instances,
+ * accessible via `getGeneratorMeta()`
+ *
+ * **User-facing API:**
+ * ```ts
+ * import { defineConfig, ssrGenerator } from "@kosmojs/dev";
+ *
+ * export default defineConfig({
+ *   generators: [ssrGenerator()], // Clean instantiation
+ * });
+ * ```
+ *
+ * **Internal dev plugin usage:**
+ * ```ts
+ * import { getGeneratorMeta } from "@kosmojs/lib";
+ *
+ * // Read module metadata before instantiation
+ * const meta = getGeneratorMeta(ssrGenerator);
+ * console.log(meta?.slot); // "ssr"
+ *
+ * // Read instance metadata after instantiation
+ * for (const generator of config.generators) {
+ *   const meta = getGeneratorMeta(generator);
+ *   if (meta?.dependencies) {
+ *     // Check/install dependencies
+ *   }
+ * }
+ * ```
+ *
+ * @example Define a generator
+ * ```ts
+ * import { defineGenerator } from "@kosmojs/lib";
+ *
+ * export default defineGenerator(
+ *   () => {
+ *     return async (sourceFolder) => {
+ *       // Generator logic
+ *     };
+ *   },
+ *   {
+ *     name: "Example",
+ *     slot: "example",
+ *     dependencies: {
+ *       "some-package": "^1.0.0"
+ *     }
+ *   }
+ * );
+ * ```
+ * */
+export declare const defineGenerator: DefineGenerator;
+export declare const isGenerator: (fn: Function) => fn is Function & Record<typeof GENERATOR_META, unknown>;
+export declare const getGeneratorMeta: (fn: Function) => GeneratorMeta | undefined;
+export declare const defineGeneratorFactory: DefineGeneratorFactory;

package/pkg/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./ast";
+export * from "./defaults";
+export * from "./generators";
+export * from "./paths";
+export * from "./render";
+export * from "./routes";
+export * from "./spinner";
+export * from "./typebox";
+export * from "./types";