@kb-labs/devkit 1.0.0 → 1.2.0

package/bin/devkit-types-order.mjs

@@ -24,6 +24,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages as _findPackagePaths } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -56,37 +59,13 @@ const options = {
 };
 
 /**
- * Find all packages
+ * Find all packages (returns objects with path, dir)
  */
 function findPackages(rootDir) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push({
-          path: packageJsonPath,
-          dir: path.join(packagesDir, pkgDir.name),
-        });
-      }
-    }
-  }
-
-  return packages;
+  return _findPackagePaths(rootDir).map((pkgPath) => ({
+    path: pkgPath,
+    dir: path.dirname(pkgPath),
+  }));
 }
 
 /**

package/bin/devkit-validate-naming.mjs

@@ -13,6 +13,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages as _findPackagePaths } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -93,41 +96,12 @@ function validatePackage(packageJsonPath, repoName) {
 }
 
 function findPackages(rootDir) {
-  const packages = [];
-
-  // Find all kb-labs-* directories
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const repoName = extractRepoName(entry.name);
-    if (!repoName) {continue;}
-
-    // Find all package.json files in packages/
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push({
-          path: packageJsonPath,
-          repoName,
-          repoPath: entry.name,
-        });
-      }
-    }
-  }
-
-  return packages;
+  return _findPackagePaths(rootDir).map((pkgPath) => {
+    const parts = pkgPath.split(path.sep);
+    const repoDir = parts.find((p) => p.startsWith('kb-labs-')) || 'unknown';
+    const repoName = extractRepoName(repoDir);
+    return { path: pkgPath, repoName, repoPath: repoDir };
+  }).filter((p) => p.repoName);
 }
 
 function main() {

package/bin/devkit-visualize.mjs

@@ -20,6 +20,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
+// Shared package discovery — supports both flat and categorized layouts
+import { findPackages } from './lib/find-packages.mjs';
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 // ANSI colors
@@ -49,40 +52,6 @@ const options = {
   all: !args.includes('--graph') && !args.includes('--stats') && !args.includes('--tree'),
 };
 
-/**
- * Find all packages in monorepo
- */
-function findPackages(rootDir, filterPackage) {
-  const packages = [];
-  const entries = fs.readdirSync(rootDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (!entry.isDirectory() || !entry.name.startsWith('kb-labs-')) {continue;}
-
-    const repoPath = path.join(rootDir, entry.name);
-    const packagesDir = path.join(repoPath, 'packages');
-
-    if (!fs.existsSync(packagesDir)) {continue;}
-
-    const packageDirs = fs.readdirSync(packagesDir, { withFileTypes: true });
-
-    for (const pkgDir of packageDirs) {
-      if (!pkgDir.isDirectory()) {continue;}
-
-      // Filter by package name if specified
-      if (filterPackage && pkgDir.name !== filterPackage) {continue;}
-
-      const packageJsonPath = path.join(packagesDir, pkgDir.name, 'package.json');
-
-      if (fs.existsSync(packageJsonPath)) {
-        packages.push(packageJsonPath);
-      }
-    }
-  }
-
-  return packages;
-}
-
 /**
  * Build dependency graph
  */

package/bin/lib/find-packages.mjs

@@ -0,0 +1,77 @@
+/**
+ * Shared package discovery for KB Labs workspace.
+ *
+ * Supports both flat and categorized workspace layouts.
+ * All devkit tools should import this instead of inlining their own findPackages.
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+const CATEGORIES = ['platform', 'plugins', 'infra', 'templates', 'installer', 'sites'];
+
+/**
+ * Find all KB Labs packages in the workspace.
+ *
+ * Scans for kb-labs-* directories in:
+ * Scans root level (flat: kb-labs-*) and category level (platform/kb-labs-*, plugins/kb-labs-*, etc.).
+ * Also scans apps/ directories for app-style packages.
+ *
+ * @param {string} rootDir - Workspace root directory
+ * @param {string} [filterPackage] - Optional package name filter (e.g., 'core-cli')
+ * @returns {string[]} Array of package.json file paths
+ */
+export function findPackages(rootDir, filterPackage) {
+  const packages = [];
+
+  // Collect all repo directories (both flat and categorized)
+  const repoDirs = [];
+
+  const rootEntries = fs.readdirSync(rootDir, { withFileTypes: true });
+  for (const entry of rootEntries) {
+    if (!entry.isDirectory()) continue;
+
+    if (entry.name.startsWith('kb-labs-')) {
+      // Flat layout: kb-labs-* at root
+      repoDirs.push(path.join(rootDir, entry.name));
+    } else if (CATEGORIES.includes(entry.name)) {
+      // Categorized layout: platform/kb-labs-*, plugins/kb-labs-*, etc.
+      const categoryPath = path.join(rootDir, entry.name);
+      try {
+        const categoryEntries = fs.readdirSync(categoryPath, { withFileTypes: true });
+        for (const catEntry of categoryEntries) {
+          if (catEntry.isDirectory() && catEntry.name.startsWith('kb-labs-')) {
+            repoDirs.push(path.join(categoryPath, catEntry.name));
+          }
+        }
+      } catch {
+        // Category dir not readable, skip
+      }
+    }
+  }
+
+  // Scan each repo for packages/ and apps/ subdirectories
+  for (const repoPath of repoDirs) {
+    for (const subdir of ['packages', 'apps']) {
+      const pkgsDir = path.join(repoPath, subdir);
+      if (!fs.existsSync(pkgsDir)) continue;
+
+      try {
+        const pkgDirs = fs.readdirSync(pkgsDir, { withFileTypes: true });
+        for (const pkgDir of pkgDirs) {
+          if (!pkgDir.isDirectory()) continue;
+          if (filterPackage && pkgDir.name !== filterPackage) continue;
+
+          const packageJsonPath = path.join(pkgsDir, pkgDir.name, 'package.json');
+          if (fs.existsSync(packageJsonPath)) {
+            packages.push(packageJsonPath);
+          }
+        }
+      } catch {
+        // Dir not readable, skip
+      }
+    }
+  }
+
+  return packages;
+}

package/eslint/node.js

@@ -18,7 +18,9 @@ export default [
       '**/*.d.ts',
       '**/scripts/**',
       '**/eslint.config.*',
-      '**/bootstrap.js'
+      '**/tsup.config.*',
+      '**/bootstrap.js',
+      '**/tsup.config.bundled_*.mjs'
     ]
   },
 

package/eslint/plugin.js

@@ -0,0 +1,51 @@
+/**
+ * Strict ESLint preset for KB Labs plugins.
+ *
+ * Extends the base node.js preset with architectural boundary enforcement:
+ * plugins can only import from @kb-labs/sdk and their own internal packages.
+ *
+ * Usage in plugin's eslint.config.js:
+ *   import pluginPreset from '@kb-labs/devkit/eslint/plugin.js';
+ *   export default [...pluginPreset];
+ */
+
+import nodePreset from './node.js'
+
+// Packages that plugins are allowed to import from
+const ALLOWED_EXTERNAL = [
+  '@kb-labs/sdk',
+]
+
+// Platform internals that plugins must NOT import directly
+const FORBIDDEN_PATTERNS = [
+  '@kb-labs/core-*',
+  '@kb-labs/cli-*',
+  '@kb-labs/shared-*',
+  '@kb-labs/plugin-*',
+  '@kb-labs/workflow-*',
+  '@kb-labs/rest-api-*',
+  '@kb-labs/studio-*',
+  '@kb-labs/adapters-*',
+  '@kb-labs/gateway-*',
+  '@kb-labs/host-agent-*',
+  '@kb-labs/state-*',
+  '@kb-labs/tenant',
+  '@kb-labs/perm-*',
+]
+
+export default [
+  ...nodePreset,
+
+  {
+    rules: {
+      'no-restricted-imports': ['error', {
+        patterns: FORBIDDEN_PATTERNS.map(pattern => ({
+          group: [pattern],
+          message: `Plugins must depend only on @kb-labs/sdk. Direct imports from platform internals are not allowed. Re-export what you need through SDK.`,
+        })),
+      }],
+    },
+  },
+]
+
+export { ALLOWED_EXTERNAL, FORBIDDEN_PATTERNS }

package/eslint/react.js

@@ -17,7 +17,8 @@ export default [
       '**/*.config.js',
       '**/*.config.ts',
       '**/vitest-setup.ts',
-      '**/vitest.setup.ts'
+      '**/vitest.setup.ts',
+      '**/tsup.config.bundled_*.mjs'
     ]
   },
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kb-labs/devkit",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "type": "module",
   "description": "Shared developer toolkit for KB Labs projects: TS/ESLint/Prettier/Vitest/Tsup presets and reusable GitHub Actions.",
   "files": [
@@ -65,8 +65,10 @@
     "./eslint/": "./eslint/",
     "./eslint/node.js": "./eslint/node.js",
     "./eslint/react.js": "./eslint/react.js",
+    "./eslint/plugin.js": "./eslint/plugin.js",
     "./eslint/node": "./eslint/node.js",
     "./eslint/react": "./eslint/react.js",
+    "./eslint/plugin": "./eslint/plugin.js",
     "./prettier/": "./prettier/",
     "./prettier/index.json": "./prettier/index.json",
     "./vitest/": "./vitest/",
@@ -101,6 +103,26 @@
     "./tsup/external-sync": "./tsup/external-sync.mjs",
     "./sync": "./sync/index.mjs"
   },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "echo \"@kb-labs/devkit: nothing to build\"",
+    "lint": "echo \"@kb-labs/devkit: lint skipped (plain JS/MJS, not TS project)\" && exit 0",
+    "lint:fix": "eslint . --fix --ignore-pattern 'dist/**'",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest --passWithNoTests",
+    "paths": "node ./bin/devkit-paths.mjs",
+    "fixtures": "node scripts/fixtures.js –help",
+    "fixtures:check": "node scripts/fixtures.js –action=check",
+    "fixtures:lint": "node scripts/fixtures.js –action=lint",
+    "fixtures:test": "node scripts/fixtures.js –action=test",
+    "fixtures:build": "node scripts/fixtures.js –action=build",
+    "fixtures:bootstrap": "node scripts/fixtures.js –action=bootstrap",
+    "fixtures:clean": "node scripts/fixtures.js –action=clean",
+    "fixtures:ci": "node scripts/fixtures.js –action=check –since=${GITHUB_BASE_REF:-origin/main} –concurrency=3 || node scripts/fixtures.js –action=check",
+    "postinstall": "kb-devkit-tsup-external --generate || true",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "type-check": "echo \"@kb-labs/devkit: type-check skipped (plain JS/MJS, not TS project)\" && exit 0"
+  },
   "peerDependencies": {
     "@playwright/test": "*",
     "eslint": "^9.35.0",
@@ -135,11 +157,14 @@
   "dependencies": {
     "eslint-import-resolver-typescript": "^3.10.1",
     "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-jsx-a11y": "^6.10.0",
+    "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-unused-imports": "^4.1.4",
     "glob": "^11.0.0",
     "yaml": "^2.8.0"
   },
   "devDependencies": {
+    "@kb-labs/devkit": "link:./",
     "@types/node": "^24.3.3",
     "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^9.35.0",
@@ -152,9 +177,9 @@
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.44.0",
-    "vitest": "^3.2.4",
-    "@kb-labs/devkit": "1.0.0"
+    "vitest": "^3.2.4"
   },
+  "packageManager": "pnpm@9.11.0+sha512.0a203ffaed5a3f63242cd064c8fb5892366c103e328079318f78062f24ea8c9d50bc6a47aa3567cabefd824d170e78fa2745ed1f16b132e16436146b7688f19b",
   "engines": {
     "node": ">=20.0.0",
     "pnpm": ">=9.11.0"
@@ -162,25 +187,5 @@
   "license": "MIT",
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "clean": "rimraf dist",
-    "build": "echo \"@kb-labs/devkit: nothing to build\"",
-    "lint": "eslint . --ignore-pattern 'dist/**'",
-    "lint:fix": "eslint . --fix --ignore-pattern 'dist/**'",
-    "test": "vitest run --passWithNoTests",
-    "test:watch": "vitest --passWithNoTests",
-    "paths": "node ./bin/devkit-paths.mjs",
-    "fixtures": "node scripts/fixtures.js –help",
-    "fixtures:check": "node scripts/fixtures.js –action=check",
-    "fixtures:lint": "node scripts/fixtures.js –action=lint",
-    "fixtures:test": "node scripts/fixtures.js –action=test",
-    "fixtures:build": "node scripts/fixtures.js –action=build",
-    "fixtures:bootstrap": "node scripts/fixtures.js –action=bootstrap",
-    "fixtures:clean": "node scripts/fixtures.js –action=clean",
-    "fixtures:ci": "node scripts/fixtures.js –action=check –since=${GITHUB_BASE_REF:-origin/main} –concurrency=3 || node scripts/fixtures.js –action=check",
-    "postinstall": "kb-devkit-tsup-external --generate || true",
-    "dev": "tsup --config tsup.config.ts --watch",
-    "type-check": "tsc --noEmit"
   }
-}
+}

package/sync/index.mjs

@@ -1,6 +1,6 @@
 // Public API: sync runner used by bin and by consumers via import('@kb-labs/devkit/sync')
 import { createHash } from 'node:crypto';
-import { cp, mkdir, readFile, readdir, writeFile, access } from 'node:fs/promises';
+import { cp, mkdir, readFile, readdir, writeFile, access, chmod } from 'node:fs/promises';
 import { dirname, join, resolve, relative } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import process from 'node:process';
@@ -57,7 +57,12 @@ const BASE_MAP = {
     from: resolve(DEVKIT_ROOT, 'templates/configs'),
     to: (root) => root, // Root of package
     type: 'configs', // Special type for config drift checking
-  }
+  },
+  hooks: {
+    from: resolve(DEVKIT_ROOT, 'scripts/hooks'),
+    to: (root) => resolve(root, 'scripts/hooks'),
+    type: 'hooks', // Special type: also installs into .git/hooks/
+  },
 };
 
 function resolveFromDevkit(p) {
@@ -231,7 +236,7 @@ async function runCheck(root, effectiveMap, targets, { verbose, scope }) {
   for (const key of targets) {
     const { from, to, type } = effectiveMap[key];
     const dst = to(root);
-    const res = await comparePaths(from, dst, type);
+    const res = await comparePaths(from, dst, type === 'hooks' ? 'dir' : type);
 
     const changed = (res.diffs.length + res.onlySrc.length + (considerOnlyDst ? res.onlyDst.length : 0)) > 0;
     const item = {
@@ -373,6 +378,7 @@ async function runSync(root, effectiveMap, targets, { force, verbose, dryRun })
         return [sf, join(dst, rel)];
       });
     }
+    const isHooks = type === 'hooks';
     const beforeState = await Promise.all(filePairs.map(async ([srcFile, dstFile]) => {
       const existed = await exists(dstFile);
       const hb = existed ? await sha256File(dstFile).catch(() => null) : null;
@@ -404,6 +410,24 @@ async function runSync(root, effectiveMap, targets, { force, verbose, dryRun })
     details.push({ key, action: 'synced', from, dst, type });
     log(`→ ${key}: ${created} created, ${updated} updated, ${keptF} kept`);
     log(`synced ${key} -> ${dst}`);
+
+    // For hooks: also install into .git/hooks/ and chmod +x
+    if (isHooks) {
+      const gitHooksDir = resolve(root, '.git', 'hooks');
+      const gitDirExists = await exists(resolve(root, '.git'));
+      if (gitDirExists) {
+        await mkdir(gitHooksDir, { recursive: true });
+        for (const [, dstFile] of filePairs) {
+          const hookName = dstFile.slice(dst.length + 1);
+          const gitHookDst = join(gitHooksDir, hookName);
+          await cp(dstFile, gitHookDst, { force: true });
+          await chmod(gitHookDst, 0o755);
+        }
+        log(`hooks installed into .git/hooks/`);
+      } else {
+        warn(`skip .git/hooks install — no .git directory found at ${root}`);
+      }
+    }
   }
   const finishedAt = Date.now();
   log('sync done', summary, `(force=${force}, dry-run=${!!dryRun})`);

package/tsconfig/dist/tsconfig.tools.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../../kb-labs-sdk/tsup.config.ts","../../../kb-labs-sdk/vitest.config.ts","../../../kb-labs-sdk/packages/sdk/tsup.config.ts","../../../kb-labs-sdk/packages/sdk/dist/index.d.ts","../../../kb-labs-sdk/packages/sdk/dist/testing/index.d.ts","../../../kb-labs-sdk/packages/sdk/src/index.ts","../../../kb-labs-sdk/packages/sdk/src/__tests__/exports.snapshot.test.ts","../../../kb-labs-sdk/packages/sdk/src/command/index.ts","../../../kb-labs-sdk/packages/sdk/src/manifest/index.ts","../../../kb-labs-sdk/packages/sdk/src/test/create-test-context.ts","../../../kb-labs-sdk/packages/sdk/src/test/index.ts","../../../kb-labs-sdk/packages/sdk/src/testing/index.ts","../../../kb-labs-sdk/packages/sdk/src/utils/index.ts","../../../kb-labs-sdk/eslint.config.js","../../../kb-labs-sdk/packages/sdk/eslint.config.js","../../../kb-labs-sdk/packages/sdk/dist/index.js","../../../kb-labs-sdk/packages/sdk/dist/testing/index.js","../../../kb-labs-sdk/packages/sdk/tsup.config.bundled_x0ijv4r35mr.mjs","../../../kb-labs-sdk/scripts/devkit-sync.mjs"],"errors":true,"version":"5.9.3"}
+{"root":["../../../kb-labs-sdk/tsup.config.bin.ts","../../../kb-labs-sdk/tsup.config.cli.ts","../../../kb-labs-sdk/tsup.config.dual.ts","../../../kb-labs-sdk/tsup.config.ts","../../../kb-labs-sdk/vitest.config.ts","../../../kb-labs-sdk/packages/sdk/tsup.config.ts","../../../kb-labs-sdk/packages/sdk/dist/index.d.ts","../../../kb-labs-sdk/packages/sdk/dist/command/index.d.ts","../../../kb-labs-sdk/packages/sdk/dist/contracts/index.d.ts","../../../kb-labs-sdk/packages/sdk/dist/hooks/index.d.ts","../../../kb-labs-sdk/packages/sdk/dist/manifest/index.d.ts","../../../kb-labs-sdk/packages/sdk/dist/testing/index.d.ts","../../../kb-labs-sdk/packages/sdk/dist/types/index.d.ts","../../../kb-labs-sdk/packages/sdk/src/index.ts","../../../kb-labs-sdk/packages/sdk/src/__tests__/deep-behavior.test.ts","../../../kb-labs-sdk/packages/sdk/src/__tests__/entrypoint-contracts.test.ts","../../../kb-labs-sdk/packages/sdk/src/__tests__/exports.snapshot.test.ts","../../../kb-labs-sdk/packages/sdk/src/__type-tests__/sdk-typing.type-test.ts","../../../kb-labs-sdk/packages/sdk/src/command/index.ts","../../../kb-labs-sdk/packages/sdk/src/contracts/index.ts","../../../kb-labs-sdk/packages/sdk/src/hooks/index.ts","../../../kb-labs-sdk/packages/sdk/src/manifest/index.ts","../../../kb-labs-sdk/packages/sdk/src/test/create-test-context.ts","../../../kb-labs-sdk/packages/sdk/src/test/index.ts","../../../kb-labs-sdk/packages/sdk/src/testing/index.ts","../../../kb-labs-sdk/packages/sdk/src/types/index.ts","../../../kb-labs-sdk/packages/sdk/src/utils/index.ts","../../../kb-labs-sdk/eslint.config.js","../../../kb-labs-sdk/packages/sdk/eslint.config.js","../../../kb-labs-sdk/packages/sdk/dist/index.js","../../../kb-labs-sdk/packages/sdk/dist/command/index.js","../../../kb-labs-sdk/packages/sdk/dist/contracts/index.js","../../../kb-labs-sdk/packages/sdk/dist/hooks/index.js","../../../kb-labs-sdk/packages/sdk/dist/manifest/index.js","../../../kb-labs-sdk/packages/sdk/dist/testing/index.js","../../../kb-labs-sdk/packages/sdk/dist/types/index.js","../../../kb-labs-sdk/packages/sdk/scripts/check-api-removals.mjs","../../../kb-labs-sdk/packages/sdk/scripts/generate-export-glossary.mjs","../../../kb-labs-sdk/scripts/devkit-sync.mjs"],"errors":true,"version":"5.9.3"}

package/tsconfig/node.json

@@ -4,7 +4,8 @@
     "outDir": "dist",
     "declaration": true,
     "declarationMap": true,
-    "skipLibCheck": true
+    "skipLibCheck": true,
+    "types": ["node"]
   },
   "include": [
     "src"

package/tsup/bin.js

@@ -169,4 +169,9 @@ export default defineConfig({
   banner: {
     js: '#!/usr/bin/env node',
   },
+  ignoreWatch: [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/.git/**',
+  ],
 });

package/tsup/dual.js

@@ -152,4 +152,9 @@ export default defineConfig({
     ...externalList, // Explicitly listed packages (workspace + local deps)
     /^@kb-labs\//, // Force all @kb-labs packages to be external
   ],
+  ignoreWatch: [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/.git/**',
+  ],
 })

package/tsup/node.js

@@ -1,8 +1,40 @@
 import { defineConfig } from 'tsup'
 import { readTsupExternalSync } from './external-sync.mjs'
-import { readFileSync } from 'node:fs'
+import { readFileSync, existsSync } from 'node:fs'
 import { join } from 'node:path'
 
+/**
+ * Derive tsup entry points from package.json exports field.
+ * Maps each export value like "./dist/foo.js" → "src/foo.ts" (or root "foo.ts").
+ * Falls back to ['src/index.ts'] if no exports or src file not found.
+ */
+function resolveEntryFromExports() {
+  try {
+    const pkgPath = join(process.cwd(), 'package.json')
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+    const exportsMap = pkg.exports ?? {}
+    const srcFiles = new Set()
+
+    for (const condition of Object.values(exportsMap)) {
+      // condition can be a string or { import, types, require, ... }
+      const importPath = typeof condition === 'string' ? condition
+        : (condition.import ?? condition.default ?? null)
+      if (!importPath || typeof importPath !== 'string') continue
+
+      // "./dist/foo.js" → "foo", then try "src/foo.ts" or "foo.ts"
+      const base = importPath.replace(/^\.\/dist\//, '').replace(/\.js$/, '')
+      const candidates = [`src/${base}.ts`, `${base}.ts`]
+      for (const c of candidates) {
+        if (existsSync(join(process.cwd(), c))) { srcFiles.add(c); break }
+      }
+    }
+
+    return srcFiles.size > 0 ? Array.from(srcFiles) : ['src/index.ts']
+  } catch {
+    return ['src/index.ts']
+  }
+}
+
 function resolveExternalDependencies() {
   try {
     const pkgPath = join(process.cwd(), 'package.json')
@@ -32,11 +64,12 @@ function getExternal() {
   return resolveExternalDependencies()
 }
 
-// Pre-compute external list once at module load time
+// Pre-compute external list and entry once at module load time
 const externalList = getExternal()
+const entryFromExports = resolveEntryFromExports()
 
 export default defineConfig({
-  entry: ['src/index.ts'],
+  entry: entryFromExports,
   format: ['esm'],
   target: 'es2022',
   sourcemap: true,
@@ -48,6 +81,11 @@ export default defineConfig({
   splitting: false,
   skipNodeModulesBundle: true,
   shims: false,
+  ignoreWatch: [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/.git/**',
+  ],
   // Mark all node_modules packages as external (including transitive deps)
   // Use noExternal: [] to prevent bundling any node_modules packages
   // This is more reliable than regex for ensuring transitive deps stay external

package/tsup/react-lib.js

@@ -13,6 +13,11 @@ export default defineConfig({
   outDir: 'dist',
   splitting: false,
   skipNodeModulesBundle: true,
-  shims: false
+  shims: false,
+  ignoreWatch: [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/.git/**',
+  ],
 })
 

package/tsup/sdk.js

@@ -115,4 +115,9 @@ export default defineConfig({
     // CJS packages with dynamic require
     ...PROBLEMATIC_CJS_PACKAGES,
   ],
+  ignoreWatch: [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/.git/**',
+  ],
 });