@kosmojs/lib 0.4.4 → 0.5.2

package/README.md

@@ -1,16 +1,23 @@
 # @kosmojs/lib
 
-TODO: Add package description
+Internal toolkit shared by the CLI and the generators.
 
-## Installation
+## Scope
 
-```sh
-npm install -D @kosmojs/lib
-```
+Published because [`@kosmojs/cli`](https://www.npmjs.com/package/@kosmojs/cli),
+[`@kosmojs/dev`](https://www.npmjs.com/package/@kosmojs/dev) and the generators depend on it - **not** intended for direct use.
+It carries no stability guarantee across releases and can change shape in a patch.
+
+It holds the pieces those packages need in common: TypeScript AST helpers for resolving validation types,
+the generator base and file-deployment helpers, path and route utilities, the Handlebars render layer, and Vite helpers.
+
+If you are writing a generator, depend on the documented contract in `@kosmojs/core/generators` instead.
 
 ## Documentation
 
-See [kosmojs.dev](https://kosmojs.dev)
+- [Why code generation](https://kosmojs.dev/essentials/why-codegen.html)
+
+Full documentation at [kosmojs.dev](https://kosmojs.dev).
 
 ## License
 

package/package.json

@@ -1,7 +1,8 @@
 {
   "type": "module",
   "name": "@kosmojs/lib",
-  "version": "0.4.4",
+  "version": "0.5.2",
+  "description": "Shared internals for the KosmoJS CLI and generators (not a public API)",
   "author": "Slee Woo",
   "license": "MIT",
   "repository": {
@@ -19,22 +20,23 @@
     }
   },
   "dependencies": {
-    "@kosmojs/core": "^0.4.4",
-    "@topcli/spinner": "^4.2.1",
+    "@kosmojs/core": "^0.5.2",
+    "@topcli/spinner": "^5.0.0",
     "crc": "^4.3.2",
     "handlebars": "^4.7.9",
     "mrmime": "^2.0.1",
+    "oxfmt": "^0.67.0",
     "path-to-regexp": "^8.4.2",
-    "picomatch": "^4.0.5",
+    "picomatch": "^4.0.7",
     "tfusion": "^0.2.2",
     "tinyglobby": "^0.2.17",
     "ts-morph": "^28.0.0"
   },
   "devDependencies": {
     "@koa/router": "^15.7.0",
-    "@kosmojs/lib": "^0.4.4",
+    "@kosmojs/lib": "^0.5.2",
     "@types/picomatch": "^4.0.3",
-    "hono": "^4.13.3",
+    "hono": "^4.13.7",
     "rou3": "^0.9.2",
     "vite": "^8.2.2"
   },

package/pkg/format.d.ts

@@ -0,0 +1,2 @@
+import { type FormatConfig } from "oxfmt";
+export declare const formatCode: (code: string, filename: string, config?: FormatConfig) => Promise<string>;

package/pkg/generators.d.ts

@@ -1,7 +1,7 @@
-import type { GeneratorFactory, GeneratorSignature, ResolvedEntry, SourceFolder, VirtualModule, WatcherEvent } from "@kosmojs/core";
-export declare const defineGenerator: <O extends object, R extends boolean = false>({ meta, factory, dependencies, devDependencies, }: Omit<GeneratorSignature, "factory"> & {
+import type { GeneratorFactory, GeneratorSignature, ResolvedEntry, SourceFolder, WatcherEvent } from "@kosmojs/core";
+export declare const defineGenerator: <O extends object, R extends boolean = false>({ meta, factory, dependencies, devDependencies, }: Omit<GeneratorSignature<O>, "factory"> & {
     factory: (f: SourceFolder, o?: O) => GeneratorFactory;
-}) => [R] extends [true] ? ((o: O) => GeneratorSignature) & Pick<GeneratorSignature, "meta" | "dependencies" | "devDependencies"> : ((o?: O) => GeneratorSignature) & Pick<GeneratorSignature, "meta" | "dependencies" | "devDependencies">;
+}) => [R] extends [true] ? (o: O) => GeneratorSignature<O> : (o?: O) => GeneratorSignature<O>;
 export declare const defineGeneratorFactory: <O extends object>(factory: (f: SourceFolder, o?: O) => GeneratorFactory) => (f: SourceFolder, o?: O) => GeneratorFactory;
 /**
  * Filter watched API routes by event.
@@ -25,9 +25,3 @@ export declare const createWatchedApiRouteEntriesFilter: (event: WatcherEvent |
  *    and any route referencing the updated file (shared types).
  * */
 export declare const createWatchedPageRouteEntriesFilter: (event: WatcherEvent | undefined, eventsOfInterest: Array<WatcherEvent["kind"]>) => ({ kind, entry }: ResolvedEntry) => boolean;
-/**
- * Gather virtual modules declared by a folder's generators.
- * Feed the result to `vitePlugins.virtualModules()`,
- * with `kind: "ssr"` on the SSR builds and `kind: "csr"` everywhere else.
- * */
-export declare const collectVirtualModules: (sourceFolder: SourceFolder, generators: Array<GeneratorSignature>) => Array<VirtualModule>;

package/pkg/generic.d.ts

@@ -1,3 +1,4 @@
 import { type UserConfig } from "vite";
 export declare const mergeConfigs: (...configs: Array<UserConfig | undefined>) => UserConfig;
 export declare const escapeTemplateLiterals: (origin: string) => string;
+export declare const containsPathTraversalPatterns: (str: string) => boolean;

package/pkg/index.d.ts

@@ -1,8 +1,10 @@
 export * from "./ast";
+export * from "./format";
 export * from "./generators";
 export * from "./generic";
 export * from "./paths";
 export * from "./render";
 export * from "./routes";
 export * from "./spinner";
+export * from "./tsconfig";
 export * from "./vite";