@aleph-alpha/lib-mcp 1.7.0 → 2.1.0

package/dist/scripts/generate-component-meta.js

@@ -15,20 +15,39 @@ import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = path.dirname(__filename);
-function findUiLibraryRoot() {
-  const possiblePaths = [
-    // Monorepo development: from packages/lib-mcp/dist/utils -> packages/ui-library
-    path.resolve(__dirname, "../../../ui-library"),
-    // Installed as dependency: from node_modules/@aleph-alpha/lib-mcp/dist/utils -> node_modules/@aleph-alpha/ui-library
-    path.resolve(__dirname, "../../@aleph-alpha/ui-library"),
-    // Alternative: resolve from cwd
-    path.join(process.cwd(), "node_modules/@aleph-alpha/ui-library")
+function findInMonorepo(startDir, packageName) {
+  let current = startDir;
+  for (let i = 0; i < 10; i++) {
+    const candidate = path.join(current, "packages", packageName);
+    if (fs.existsSync(path.join(candidate, "package.json"))) {
+      return candidate;
+    }
+    const parent = path.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return null;
+}
+function resolveWorkspacePackage(packageName, scope = "@aleph-alpha") {
+  const fromDirname = findInMonorepo(__dirname, packageName);
+  if (fromDirname) return fromDirname;
+  const fromCwd = findInMonorepo(process.cwd(), packageName);
+  if (fromCwd) return fromCwd;
+  const nodeModulesCandidates = [
+    path.resolve(__dirname, `../../${scope}/${packageName}`),
+    path.resolve(__dirname, `../../../${scope}/${packageName}`),
+    path.join(process.cwd(), `node_modules/${scope}/${packageName}`)
   ];
-  for (const pkgPath of possiblePaths) {
+  for (const pkgPath of nodeModulesCandidates) {
     if (fs.existsSync(path.join(pkgPath, "package.json"))) {
       return pkgPath;
     }
   }
+  return null;
+}
+function findUiLibraryRoot() {
+  const pkgPath = resolveWorkspacePackage("ui-library");
+  if (pkgPath) return pkgPath;
   throw new Error("Could not find @aleph-alpha/ui-library. Is it installed?");
 }
 function getLibrarySourcePath() {
@@ -41,6 +60,21 @@ function getLibrarySourcePath() {
     "Could not find UI library source directory. Is the package installed correctly?"
   );
 }
+function findChatKitRoot() {
+  const pkgPath = resolveWorkspacePackage("chat-kit");
+  if (pkgPath) return pkgPath;
+  throw new Error("Could not find @aleph-alpha/chat-kit. Is it installed?");
+}
+function getChatKitSourcePath() {
+  const chatKitRoot = findChatKitRoot();
+  const srcPath = path.join(chatKitRoot, "src");
+  if (fs.existsSync(srcPath)) {
+    return srcPath;
+  }
+  throw new Error(
+    "Could not find chat-kit source directory. Is the package installed correctly?"
+  );
+}
 function getPackageRoot() {
   const pkgRoot = path.resolve(__dirname, "../..");
   if (fs.existsSync(path.join(pkgRoot, "package.json"))) {
@@ -52,6 +86,10 @@ function getPackageRoot() {
 // src/utils/file-utils.ts
 import * as fs2 from "node:fs";
 
+// src/utils/constants.ts
+var COMPONENT_PREFIX = "Ui";
+var CHAT_KIT_PREFIX = "Ck";
+
 // src/constants.ts
 function detectCategoryDirs() {
   const srcPath = getSrcPath();
@@ -59,11 +97,15 @@ function detectCategoryDirs() {
     return [];
   }
   const entries = fs3.readdirSync(srcPath, { withFileTypes: true });
-  return entries.filter((entry) => entry.isDirectory()).filter((entry) => !entry.name.startsWith(".") && entry.name !== "node_modules").filter((entry) => {
+  return entries.filter((entry) => entry.isDirectory()).filter(
+    (entry) => !entry.name.startsWith(".") && entry.name !== "node_modules"
+  ).filter((entry) => {
     try {
       const dirPath = path2.join(srcPath, entry.name);
       const subEntries = fs3.readdirSync(dirPath, { withFileTypes: true });
-      return subEntries.some((sub) => sub.isDirectory() && sub.name.startsWith("Ui"));
+      return subEntries.some(
+        (sub) => sub.isDirectory() && sub.name.startsWith(COMPONENT_PREFIX)
+      );
     } catch {
       return false;
     }
@@ -75,6 +117,47 @@ function getCategoryDirs() {
   cachedCategoryDirs = detectCategoryDirs();
   return cachedCategoryDirs;
 }
+function detectChatKitCategoryDirs() {
+  const srcPath = getChatKitSrcPath();
+  if (!srcPath || !fs3.existsSync(srcPath)) {
+    return [];
+  }
+  const categories = [];
+  const walk = (dir, relative, depth) => {
+    let entries;
+    try {
+      entries = fs3.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    const hasChatKitSubdirs = entries.some(
+      (sub) => sub.isDirectory() && sub.name.startsWith(CHAT_KIT_PREFIX)
+    );
+    if (hasChatKitSubdirs && relative) {
+      categories.push(relative);
+      return;
+    }
+    if (depth >= 2) return;
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+      if (entry.name.startsWith(CHAT_KIT_PREFIX)) continue;
+      walk(
+        path2.join(dir, entry.name),
+        relative ? path2.join(relative, entry.name) : entry.name,
+        depth + 1
+      );
+    }
+  };
+  walk(srcPath, "", 0);
+  return categories;
+}
+var cachedChatKitCategoryDirs = null;
+function getChatKitCategoryDirs() {
+  if (cachedChatKitCategoryDirs) return cachedChatKitCategoryDirs;
+  cachedChatKitCategoryDirs = detectChatKitCategoryDirs();
+  return cachedChatKitCategoryDirs;
+}
 function getSrcPath() {
   try {
     return getLibrarySourcePath();
@@ -82,6 +165,13 @@ function getSrcPath() {
     return null;
   }
 }
+function getChatKitSrcPath() {
+  try {
+    return getChatKitSourcePath();
+  } catch {
+    return null;
+  }
+}
 
 // src/scripts/generate-component-meta.ts
 function escapeRegex(str) {
@@ -91,6 +181,10 @@ var __filename2 = fileURLToPath2(import.meta.url);
 var __dirname2 = path3.dirname(__filename2);
 var PACKAGE_ROOT = getPackageRoot();
 var OUTPUT_PATH = path3.join(PACKAGE_ROOT, "components-meta.json");
+var CHAT_KIT_OUTPUT_PATH = path3.join(
+  PACKAGE_ROOT,
+  "chat-kit-components-meta.json"
+);
 function extractJSDocTags(content, interfaceName) {
   const declarationRegex = new RegExp(
     `export\\s+(?:interface|type)\\s+${escapeRegex(interfaceName)}\\b`
@@ -138,12 +232,12 @@ function extractJSDocTags(content, interfaceName) {
   return { description, useCases, keywords, related, category };
 }
 function extractKeywordsFromName(componentName) {
-  const name = componentName.replace(/^Ui/, "");
+  const name = componentName.replace(/^(?:Ui|Ck)/, "");
   return name.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase().split(/\s+/).filter((word) => word.length > 2);
 }
 function extractProps(content, interfaceName) {
   const regex = new RegExp(
-    `export\\s+interface\\s+${escapeRegex(interfaceName)}\\s*\\{([\\s\\S]*?)\\n\\}`,
+    `export\\s+interface\\s+${escapeRegex(interfaceName)}\\s*(?:<(?:\\{[^}]*\\}|[^>])*>)?\\s*\\{([\\s\\S]*?)\\n\\}`,
     "m"
   );
   const match = content.match(regex);
@@ -178,13 +272,17 @@ function processComponent(componentDir, componentName) {
     typesContent = fs4.readFileSync(typesPath, "utf-8");
   }
   const escapedName = escapeRegex(componentName);
-  const exactPropsRegex = new RegExp(`export\\s+(?:interface|type)\\s+(${escapedName}Props)\\b`);
+  const exactPropsRegex = new RegExp(
+    `export\\s+(?:interface|type)\\s+(${escapedName}Props)\\b`
+  );
   const exactMatch = typesContent.match(exactPropsRegex);
   const subComponentPropsRegex = new RegExp(
     `export\\s+(?:interface|type)\\s+(${escapedName}\\w*Props)\\b`
   );
   const subComponentMatch = typesContent.match(subComponentPropsRegex);
-  const anyPropsMatch = typesContent.match(/export\s+(?:interface|type)\s+(Ui\w+Props)/);
+  const anyPropsMatch = typesContent.match(
+    /export\s+(?:interface|type)\s+((?:Ui|Ck)\w+Props)/
+  );
   const interfaceName = exactMatch?.[1] || subComponentMatch?.[1] || anyPropsMatch?.[1] || `${componentName}Props`;
   const jsdocData = extractJSDocTags(typesContent, interfaceName);
   const nameKeywords = extractKeywordsFromName(componentName);
@@ -217,7 +315,7 @@ function scanComponents() {
     const entries = fs4.readdirSync(categoryPath, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
-      if (!entry.name.startsWith("Ui")) continue;
+      if (!entry.name.startsWith(COMPONENT_PREFIX)) continue;
       if (entry.name === "shadcn") continue;
       const componentDir = path3.join(categoryPath, entry.name);
       const componentMeta = processComponent(componentDir, entry.name);
@@ -228,19 +326,58 @@ function scanComponents() {
   }
   return meta;
 }
+function scanChatKitComponents() {
+  const meta = {};
+  let srcPath;
+  try {
+    srcPath = getChatKitSourcePath();
+  } catch (e) {
+    console.warn(`  \u26A0\uFE0F  Skipping chat-kit scan: ${e.message}`);
+    return meta;
+  }
+  for (const category of getChatKitCategoryDirs()) {
+    const categoryPath = path3.join(srcPath, category);
+    if (!fs4.existsSync(categoryPath)) continue;
+    const entries = fs4.readdirSync(categoryPath, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (!entry.name.startsWith(CHAT_KIT_PREFIX)) continue;
+      const componentDir = path3.join(categoryPath, entry.name);
+      const componentMeta = processComponent(componentDir, entry.name);
+      if (componentMeta) {
+        meta[entry.name] = componentMeta;
+      }
+    }
+  }
+  return meta;
+}
+function summarize(label, meta) {
+  const total = Object.keys(meta).length;
+  const withUseCases = Object.values(meta).filter(
+    (m) => m.useCases.length > 0
+  ).length;
+  const withKeywords = Object.values(meta).filter(
+    (m) => m.keywords.length > 0
+  ).length;
+  console.log(`
+${label} summary:`);
+  console.log(`  Components with @useCases: ${withUseCases}/${total}`);
+  console.log(`  Components with keywords: ${withKeywords}/${total}`);
+}
 function main() {
-  console.log("Scanning components...");
+  console.log("Scanning ui-library components...");
   const meta = scanComponents();
-  console.log(`Found ${Object.keys(meta).length} components`);
+  console.log(`Found ${Object.keys(meta).length} ui-library components`);
   console.log(`Writing to ${OUTPUT_PATH}...`);
   fs4.writeFileSync(OUTPUT_PATH, JSON.stringify(meta, null, 2));
-  console.log("Done!");
-  const withUseCases = Object.values(meta).filter((m) => m.useCases.length > 0).length;
-  const withKeywords = Object.values(meta).filter((m) => m.keywords.length > 0).length;
-  console.log(`
-Summary:`);
-  console.log(`  Components with @useCases: ${withUseCases}/${Object.keys(meta).length}`);
-  console.log(`  Components with keywords: ${withKeywords}/${Object.keys(meta).length}`);
+  console.log("\nScanning chat-kit components...");
+  const chatKitMeta = scanChatKitComponents();
+  console.log(`Found ${Object.keys(chatKitMeta).length} chat-kit components`);
+  console.log(`Writing to ${CHAT_KIT_OUTPUT_PATH}...`);
+  fs4.writeFileSync(CHAT_KIT_OUTPUT_PATH, JSON.stringify(chatKitMeta, null, 2));
+  console.log("\nDone!");
+  summarize("ui-library", meta);
+  summarize("chat-kit", chatKitMeta);
 }
 var isMain = import.meta.url === `file://${process.argv[1]}`;
 if (isMain) {