@dudousxd/nestjs-codegen 0.27.1 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @dudousxd/nestjs-codegen
 
+## 0.28.0
+
+### Minor Changes
+
+- [#111](https://github.com/DavideCarvalho/nestjs-codegen/pull/111) [`26529df`](https://github.com/DavideCarvalho/nestjs-codegen/commit/26529df5f6fd1f91148217f9149da41de49fc8ca) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - New built-in `genuiSandboxKit()` extension: writes the generative-UI sandbox-kit docs (`.genui/sandbox-kit.json`, the component names and props of your shadcn `components/ui` read from their TypeScript types) for `@dudousxd/nestjs-agent`, on every generate and in watch mode. It calls `writeSandboxKitDocs` from the optional peer `@dudousxd/nestjs-agent-core/genui/kit` (>=0.52.0), or a `generate` function you pass.
+
+  Watch mode now also watches the files extensions declare with `ctx.trackInput` (so editing an extension's out-of-glob dependency, such as a filter class or a kit component, regenerates without waiting for an unrelated change), and a tracked directory hashes as its file listing, so adding a file to it invalidates the skip-when-unchanged check.
+
+## 0.27.2
+
+### Patch Changes
+
+- [#105](https://github.com/DavideCarvalho/nestjs-codegen/pull/105) [`12be710`](https://github.com/DavideCarvalho/nestjs-codegen/commit/12be710f3c21ccc2e058d901a9921a72587ad939) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Follow relative imports inside declaration files to their declarations: `./chunk.cjs` resolves to `chunk.d.cts` (and `.cts`), `./chunk.mjs` to `chunk.d.mts`, `./chunk.js` to `chunk.d.ts` — after the source candidates, as before. A package's bundled `index.d.cts` imports its chunks by runtime name, and those types came out `unknown`.
+
 ## 0.27.1
 
 ### Patch Changes

package/README.md

@@ -116,6 +116,29 @@ const create = useMutation(api.users.create().mutationOptions());
 | [`@dudousxd/nestjs-filter-codegen`](https://www.npmjs.com/package/@dudousxd/nestjs-filter-codegen) | Extension — typed `filterQuery` helpers from the [nestjs-filter](https://github.com/DavideCarvalho/nestjs-filter) repo. |
 | [`@dudousxd/nestjs-inertia-codegen-extension`](https://www.npmjs.com/package/@dudousxd/nestjs-inertia-codegen-extension) | Extension — Inertia `router` / navigate output from the nestjs-inertia repo. |
 
+### Generative-UI sandbox kit (built in)
+
+`genuiSandboxKit()` writes the sandbox-kit docs that
+[`@dudousxd/nestjs-agent`](https://github.com/DavideCarvalho/nestjs-agent) uses to render
+generative UI with your design-system components: the names and props of your shadcn
+`components/ui` (read from their TypeScript types) go to `.genui/sandbox-kit.json`, on every
+generate and in watch mode. It needs the optional peer `@dudousxd/nestjs-agent-core`
+(>=0.52.0).
+
+```ts
+import { defineConfig, genuiSandboxKit } from '@dudousxd/nestjs-codegen';
+
+export default defineConfig({
+  contracts: { glob: 'src/**/*.controller.ts' },
+  codegen: { outDir: 'src/generated' },
+  extensions: [genuiSandboxKit({ include: 'web/components/ui/*.tsx', css: 'web/styles/globals.css' })],
+});
+```
+
+Options: `entry`, `include` (default: the first shadcn `components/ui` dir found), `css`,
+`tsconfig`, `output` (default `.genui/sandbox-kit.json`, relative to the app cwd), and
+`generate` to inject the docs writer.
+
 Write your own against the `@dudousxd/nestjs-codegen/extension` contract:
 
 ```ts

package/dist/cli/main.cjs

@@ -708,12 +708,18 @@ function findTypeInFile(name, file) {
 function resolveModuleSpecifier(moduleSpecifier, sourceFile, project) {
   if (moduleSpecifier.startsWith(".")) {
     const dir = (0, import_node_path4.dirname)(sourceFile.getFilePath());
-    const noExt = moduleSpecifier.replace(/\.(js|ts)$/, "");
-    return [
-      (0, import_node_path4.resolve)(dir, `${noExt}.ts`),
+    const ext = /\.(c|m)?(j|t)sx?$/.exec(moduleSpecifier)?.[0];
+    const base = ext ? moduleSpecifier.slice(0, -ext.length) : moduleSpecifier;
+    const flavour = ext?.startsWith(".c") ? "c" : ext?.startsWith(".m") ? "m" : "";
+    const candidates = [
+      (0, import_node_path4.resolve)(dir, `${base}.${flavour}ts`),
+      ...flavour === "" ? [(0, import_node_path4.resolve)(dir, `${base}.tsx`)] : [],
       (0, import_node_path4.resolve)(dir, `${moduleSpecifier}.ts`),
-      (0, import_node_path4.resolve)(dir, moduleSpecifier, "index.ts")
+      (0, import_node_path4.resolve)(dir, moduleSpecifier, "index.ts"),
+      (0, import_node_path4.resolve)(dir, `${base}.d.${flavour}ts`),
+      ...ext === void 0 ? [(0, import_node_path4.resolve)(dir, moduleSpecifier, "index.d.ts")] : []
     ];
+    return [...new Set(candidates)];
   }
   const ctx = _ctxFor(project);
   const baseUrl = ctx.pathsBase ?? ctx.projectRoot;
@@ -5657,14 +5663,26 @@ async function computeInputsHash(config, extraInputs = []) {
     hash.update("\n");
   }
   for (const file of extra) {
-    const contents = await (0, import_promises11.readFile)((0, import_node_path15.join)(cwd, file), "utf8").catch(() => null);
     hash.update(`extra:${file}
 `);
-    hash.update(contents ?? "\0missing");
+    hash.update(await readTrackedInput((0, import_node_path15.join)(cwd, file)));
     hash.update("\n");
   }
   return hash.digest("hex");
 }
+async function readTrackedInput(path) {
+  try {
+    return await (0, import_promises11.readFile)(path, "utf8");
+  } catch (err) {
+    if (err.code !== "EISDIR") return "\0missing";
+  }
+  try {
+    const entries = await (0, import_promises11.readdir)(path);
+    return `\0dir:${entries.sort().join("\n")}`;
+  } catch {
+    return "\0missing";
+  }
+}
 async function readManifest(outDir) {
   try {
     const raw = await (0, import_promises11.readFile)((0, import_node_path15.join)(outDir, MANIFEST_FILE), "utf8");
@@ -5902,11 +5920,36 @@ async function watch(config, onChange, options = {}) {
     }
     return discovery;
   }
+  const trackedWatcher = import_chokidar.default.watch([], {
+    ignoreInitial: true,
+    persistent: true,
+    awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
+  });
+  const trackedPaths = /* @__PURE__ */ new Set();
+  async function syncTrackedInputs() {
+    const manifest = await readManifest(config.codegen.outDir);
+    const fresh = [];
+    for (const path of manifest?.extraInputs ?? []) {
+      const abs = (0, import_node_path18.resolve)(config.codegen.cwd, path);
+      if (trackedPaths.has(abs)) continue;
+      trackedPaths.add(abs);
+      fresh.push(abs);
+    }
+    if (fresh.length > 0) trackedWatcher.add(fresh);
+  }
+  async function generateAndTrack(routes) {
+    try {
+      await generate(config, routes, entryPoint);
+    } finally {
+      await syncTrackedInputs().catch(() => {
+      });
+    }
+  }
   async function runInitialPass() {
     try {
       const initialRoutes = (await getDiscovery()).discover();
       lastRoutes = initialRoutes;
-      await generate(config, initialRoutes, entryPoint);
+      await generateAndTrack(initialRoutes);
     } catch (err) {
       if (err instanceof DriftGuardError) {
         console.error(err.message);
@@ -5916,7 +5959,7 @@ async function watch(config, onChange, options = {}) {
         `[nestjs-codegen] Initial route discovery failed, falling back to pages-only: ${err instanceof Error ? err.message : String(err)}`
       );
       try {
-        await generate(config, lastRoutes, entryPoint);
+        await generateAndTrack(lastRoutes);
       } catch {
       }
     }
@@ -5949,7 +5992,7 @@ async function watch(config, onChange, options = {}) {
     pagesDebounceTimer = setTimeout(async () => {
       pagesDebounceTimer = void 0;
       try {
-        await generate(config, lastRoutes, entryPoint);
+        await generateAndTrack(lastRoutes);
       } catch (err) {
         console.error(
           "[nestjs-codegen] Pages generation failed:",
@@ -5981,7 +6024,7 @@ async function watch(config, onChange, options = {}) {
       try {
         const routes = await (await getDiscovery()).rediscover(changed);
         lastRoutes = routes;
-        await generate(config, routes, entryPoint);
+        await generateAndTrack(routes);
       } catch (err) {
         console.error(
           "[nestjs-codegen] Contracts generation failed:",
@@ -6002,6 +6045,9 @@ async function watch(config, onChange, options = {}) {
   formsWatcher.on("add", (p) => scheduleContractsRegenerate(p));
   formsWatcher.on("change", (p) => scheduleContractsRegenerate(p));
   formsWatcher.on("unlink", (p) => scheduleContractsRegenerate(p));
+  trackedWatcher.on("add", (p) => scheduleContractsRegenerate(p));
+  trackedWatcher.on("change", (p) => scheduleContractsRegenerate(p));
+  trackedWatcher.on("unlink", (p) => scheduleContractsRegenerate(p));
   return {
     close: async () => {
       if (pagesDebounceTimer !== void 0) {
@@ -6015,13 +6061,14 @@ async function watch(config, onChange, options = {}) {
       await pagesWatcher.close();
       await contractsWatcher.close();
       await formsWatcher.close();
+      await trackedWatcher.close();
       await lock.release();
     }
   };
 }
 
 // src/index.ts
-var VERSION = "0.27.1";
+var VERSION = "0.28.0";
 
 // src/cli/codegen.ts
 async function runCodegen(opts = {}) {
@@ -6029,9 +6076,9 @@ async function runCodegen(opts = {}) {
   const config = await loadConfig(cwd);
   if (opts.watch) {
     const watcher = await watch(config, void 0, { entryPoint: "cli" });
-    await new Promise((resolve5) => {
+    await new Promise((resolve6) => {
       function onSignal() {
-        watcher.close().then(resolve5).catch(resolve5);
+        watcher.close().then(resolve6).catch(resolve6);
       }
       process.once("SIGINT", onSignal);
       process.once("SIGTERM", onSignal);
@@ -6161,16 +6208,16 @@ async function detectPackageManager(cwd) {
 }
 async function promptFramework() {
   if (!process.stdin.isTTY) return "react";
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     const rl = (0, import_node_readline.createInterface)({ input: process.stdin, output: process.stdout });
     rl.question(
       "[nestjs-codegen] Which frontend framework? (react/vue/svelte) [react]: ",
       (answer) => {
         rl.close();
         const trimmed = answer.trim().toLowerCase();
-        if (trimmed === "vue") resolve5("vue");
-        else if (trimmed === "svelte") resolve5("svelte");
-        else resolve5("react");
+        if (trimmed === "vue") resolve6("vue");
+        else if (trimmed === "svelte") resolve6("svelte");
+        else resolve6("react");
       }
     );
   });