@supernovaio/cli 2.0.39 → 2.0.41

package/dist/code-analyzer/analyzers/static-components.js

@@ -0,0 +1,399 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2d262f78-ace0-5edb-971a-e5a64f11140a")}catch(e){}}();
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+import { globSync } from "glob";
+import * as ts from "typescript";
+import { analyzeComponents } from "../components/analyze.js";
+import { componentKeyFrom } from "./helpers.js";
+function getWorkspacePatterns(packageJson) {
+    const raw = packageJson.workspaces;
+    if (!raw) {
+        return [];
+    }
+    return Array.isArray(raw) ? raw : (raw.packages ?? []);
+}
+const ignoredReferenceTypeNames = new Set([
+    "AbortSignal",
+    "Array",
+    "ArrayBuffer",
+    "Blob",
+    "Booleanish",
+    "ChangeEvent",
+    "ClassName",
+    "CSSProperties",
+    "Date",
+    "ElementType",
+    "Error",
+    "Event",
+    "Exclude",
+    "Extract",
+    "FocusEvent",
+    "FormEvent",
+    "HTMLElement",
+    "HTMLInputElement",
+    "HTMLLabelElement",
+    "IntersectionObserver",
+    "JSX",
+    "KeyboardEvent",
+    "LegacyRef",
+    "Map",
+    "MouseEvent",
+    "NonNullable",
+    "Omit",
+    "Partial",
+    "Pick",
+    "PointerEvent",
+    "Promise",
+    "PropsWithChildren",
+    "Readonly",
+    "Record",
+    "Ref",
+    "RefObject",
+    "Required",
+    "ReturnType",
+    "Set",
+    "String",
+    "SubmitEvent",
+    "SyntheticEvent",
+    "Uint8Array",
+    "URL",
+]);
+function serializePropType(type) {
+    if (type == null) {
+        return "unknown";
+    }
+    if (typeof type === "string") {
+        return type;
+    }
+    if (typeof type === "object") {
+        const maybeRaw = type.raw;
+        if (typeof maybeRaw === "string" && maybeRaw.trim().length > 0) {
+            return maybeRaw.replaceAll(/\s+/g, " ").trim();
+        }
+    }
+    return JSON.stringify(type).replaceAll(/\s+/g, " ").trim();
+}
+function isLikelyReactNativeProp(property) {
+    const declarations = property.declarations ?? [];
+    if (declarations.length === 0) {
+        return false;
+    }
+    return declarations.every(declaration => {
+        const file = declaration.fileName;
+        return (file.includes("node_modules/@types/react") ||
+            file.includes("node_modules/react") ||
+            file.includes("node_modules/@types/react-dom"));
+    });
+}
+function shouldIncludeProp(property) {
+    if (!isLikelyReactNativeProp(property)) {
+        return true;
+    }
+    return property.description.trim().length > 0;
+}
+function extractTypeReferences(typeText) {
+    const matches = typeText.match(/\b[A-Z][A-Za-z0-9_]*\b/g) ?? [];
+    return [...new Set(matches.filter(token => !ignoredReferenceTypeNames.has(token)))];
+}
+function resolveRelativeImportPath(fromFilePath, moduleSpecifier) {
+    if (!moduleSpecifier.startsWith(".")) {
+        return null;
+    }
+    const basePath = path.resolve(path.dirname(fromFilePath), moduleSpecifier);
+    const candidates = [
+        basePath,
+        `${basePath}.ts`,
+        `${basePath}.tsx`,
+        `${basePath}.d.ts`,
+        path.join(basePath, "index.ts"),
+        path.join(basePath, "index.tsx"),
+        path.join(basePath, "index.d.ts"),
+    ];
+    return candidates.find(candidate => ts.sys.fileExists(candidate)) ?? null;
+}
+function collectImportedTypeBindings(filePath) {
+    const sourceText = ts.sys.readFile(filePath);
+    if (!sourceText) {
+        return new Map();
+    }
+    const scriptKind = filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, scriptKind);
+    const imports = new Map();
+    for (const statement of sourceFile.statements) {
+        if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {
+            continue;
+        }
+        const resolvedImportPath = resolveRelativeImportPath(filePath, statement.moduleSpecifier.text);
+        if (!resolvedImportPath) {
+            continue;
+        }
+        const namedBindings = statement.importClause?.namedBindings;
+        if (!namedBindings || !ts.isNamedImports(namedBindings)) {
+            continue;
+        }
+        for (const element of namedBindings.elements) {
+            const localName = element.name.getText(sourceFile);
+            const importedName = element.propertyName ? element.propertyName.getText(sourceFile) : localName;
+            imports.set(localName, { importedName, sourceFilePath: resolvedImportPath });
+        }
+    }
+    return imports;
+}
+function collectRelativeImportSourceFiles(filePath) {
+    const sourceText = ts.sys.readFile(filePath);
+    if (!sourceText) {
+        return [];
+    }
+    const scriptKind = filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, scriptKind);
+    const importSourceFiles = new Set();
+    for (const statement of sourceFile.statements) {
+        if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {
+            continue;
+        }
+        const resolvedImportPath = resolveRelativeImportPath(filePath, statement.moduleSpecifier.text);
+        if (resolvedImportPath) {
+            importSourceFiles.add(resolvedImportPath);
+        }
+    }
+    return [...importSourceFiles];
+}
+function collectLocalTypeDeclarations(filePath) {
+    const sourceText = ts.sys.readFile(filePath);
+    if (!sourceText) {
+        return new Map();
+    }
+    const scriptKind = filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, scriptKind);
+    const declarations = new Map();
+    const collectNode = (node) => {
+        if (ts.isInterfaceDeclaration(node) || ts.isTypeAliasDeclaration(node)) {
+            const start = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+            const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
+            const declaration = {
+                definition: node.getText(sourceFile).trim(),
+                lineEnd: end.line + 1,
+                lineStart: start.line + 1,
+                name: node.name.getText(sourceFile),
+            };
+            declarations.set(declaration.name, declaration);
+        }
+    };
+    for (const statement of sourceFile.statements) {
+        collectNode(statement);
+    }
+    return declarations;
+}
+function resolveLinkedTypes(component, sourceRootDir) {
+    const fileCandidates = [
+        path.resolve(sourceRootDir, component.componentPath),
+        path.resolve(sourceRootDir, "src", component.componentPath),
+    ];
+    const componentFilePath = fileCandidates.find(candidate => ts.sys.fileExists(candidate));
+    if (!componentFilePath) {
+        return [];
+    }
+    const declarationsByFile = new Map();
+    const importsByFile = new Map();
+    const importSourceFilesByFile = new Map();
+    const ensureFileData = (filePath) => {
+        if (!declarationsByFile.has(filePath)) {
+            declarationsByFile.set(filePath, collectLocalTypeDeclarations(filePath));
+        }
+        if (!importsByFile.has(filePath)) {
+            importsByFile.set(filePath, collectImportedTypeBindings(filePath));
+        }
+        if (!importSourceFilesByFile.has(filePath)) {
+            importSourceFilesByFile.set(filePath, collectRelativeImportSourceFiles(filePath));
+        }
+    };
+    ensureFileData(componentFilePath);
+    const queue = [];
+    const seen = new Set();
+    for (const property of Object.values(component.properties)) {
+        const serialized = serializePropType(property.type);
+        for (const reference of extractTypeReferences(serialized)) {
+            queue.push({ contextFilePath: componentFilePath, typeName: reference });
+        }
+    }
+    const resolved = [];
+    const added = new Set();
+    const toDisplaySourcePath = (filePath) => {
+        const sourceRelative = path.relative(sourceRootDir, filePath).replaceAll(path.sep, "/");
+        return sourceRelative.startsWith("src/") ? sourceRelative.slice(4) : sourceRelative;
+    };
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (!current) {
+            continue;
+        }
+        const stateKey = `${current.contextFilePath}::${current.typeName}`;
+        if (seen.has(stateKey)) {
+            continue;
+        }
+        seen.add(stateKey);
+        ensureFileData(current.contextFilePath);
+        const fileDeclarations = declarationsByFile.get(current.contextFilePath) ?? new Map();
+        const declaration = fileDeclarations.get(current.typeName);
+        if (declaration) {
+            const addedKey = `${current.contextFilePath}::${declaration.name}`;
+            if (!added.has(addedKey)) {
+                resolved.push({
+                    definition: declaration.definition,
+                    lineEnd: declaration.lineEnd,
+                    lineStart: declaration.lineStart,
+                    name: declaration.name,
+                    sourcePath: toDisplaySourcePath(current.contextFilePath),
+                });
+                added.add(addedKey);
+            }
+            for (const nestedReference of extractTypeReferences(declaration.definition)) {
+                if (fileDeclarations.has(nestedReference)) {
+                    queue.push({ contextFilePath: current.contextFilePath, typeName: nestedReference });
+                }
+            }
+            continue;
+        }
+        const fileImports = importsByFile.get(current.contextFilePath) ?? new Map();
+        const importedBinding = fileImports.get(current.typeName);
+        if (importedBinding) {
+            queue.push({ contextFilePath: importedBinding.sourceFilePath, typeName: importedBinding.importedName });
+            continue;
+        }
+        const candidateFiles = importSourceFilesByFile.get(current.contextFilePath) ?? [];
+        const matchingFiles = [];
+        for (const candidateFilePath of candidateFiles) {
+            ensureFileData(candidateFilePath);
+            const declarations = declarationsByFile.get(candidateFilePath);
+            if (declarations?.has(current.typeName)) {
+                matchingFiles.push(candidateFilePath);
+            }
+        }
+        if (matchingFiles.length === 1) {
+            queue.push({ contextFilePath: matchingFiles[0], typeName: current.typeName });
+        }
+    }
+    return resolved.sort((a, b) => {
+        if (a.name === b.name) {
+            return a.sourcePath.localeCompare(b.sourcePath);
+        }
+        return a.name.localeCompare(b.name);
+    });
+}
+function mapProps(component) {
+    return Object.values(component.properties)
+        .filter(property => shouldIncludeProp(property))
+        .map(property => ({
+        name: property.name,
+        required: property.required,
+        type: serializePropType(property.type),
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function resolveWorkspacePackageDirectory(projectRoot, importFrom) {
+    const rootPackageJsonPath = path.join(projectRoot, "package.json");
+    if (!(await fileExists(rootPackageJsonPath))) {
+        return null;
+    }
+    const rootPackageJson = JSON.parse(await readFile(rootPackageJsonPath, "utf8"));
+    const workspacePatterns = getWorkspacePatterns(rootPackageJson);
+    for (const workspacePattern of workspacePatterns) {
+        const packageJsonFiles = globSync(`${workspacePattern}/package.json`, {
+            absolute: true,
+            cwd: projectRoot,
+            nodir: true,
+        });
+        for (const packageJsonFile of packageJsonFiles) {
+            const packageJson = JSON.parse(await readFile(packageJsonFile, "utf8"));
+            if (packageJson.name === importFrom) {
+                return path.dirname(packageJsonFile);
+            }
+        }
+    }
+    return null;
+}
+async function analyzeComponentsFromBestTarget(projectRoot, importFrom) {
+    const localWorkspacePackageDir = await resolveWorkspacePackageDirectory(projectRoot, importFrom);
+    const candidates = [];
+    if (localWorkspacePackageDir) {
+        const sourceDir = path.join(localWorkspacePackageDir, "src");
+        if ((await fileExists(path.join(sourceDir, "index.ts"))) || (await fileExists(path.join(sourceDir, "index.tsx")))) {
+            candidates.push({ importFrom: "src", rootDir: localWorkspacePackageDir });
+        }
+        candidates.push({ importFrom: ".", rootDir: localWorkspacePackageDir });
+    }
+    candidates.push({ importFrom, rootDir: projectRoot });
+    let lastError;
+    for (const candidate of candidates) {
+        try {
+            const components = await analyzeComponents({
+                importFrom: candidate.importFrom,
+                rootDir: candidate.rootDir,
+            });
+            if (components.length > 0) {
+                return {
+                    components,
+                    sourceRootDir: candidate.rootDir,
+                };
+            }
+        }
+        catch (error) {
+            lastError = error;
+            continue;
+        }
+    }
+    if (lastError) {
+        throw lastError;
+    }
+    return {
+        components: [],
+        sourceRootDir: projectRoot,
+    };
+}
+export async function analyzeStaticComponents(projectRoot, importFrom) {
+    const { components, sourceRootDir } = await analyzeComponentsFromBestTarget(projectRoot, importFrom);
+    const descriptors = [];
+    const jsdocByComponentKey = {};
+    const typescriptApiByComponentKey = {};
+    const existingKeys = new Set();
+    for (const component of components.sort((a, b) => a.exportName.localeCompare(b.exportName))) {
+        const componentKey = componentKeyFrom(component.exportName, component.componentPath, existingKeys);
+        descriptors.push({
+            componentKey,
+            componentPath: component.componentPath,
+            exportName: component.exportName,
+        });
+        if (component.description.trim().length > 0) {
+            jsdocByComponentKey[componentKey] = {
+                description: component.description,
+                sourcePath: component.componentPath,
+            };
+        }
+        const props = mapProps(component);
+        if (props.length > 0) {
+            const linkedTypes = resolveLinkedTypes(component, sourceRootDir);
+            typescriptApiByComponentKey[componentKey] = {
+                linkedTypes,
+                props,
+                sourcePath: component.componentPath,
+            };
+        }
+    }
+    return {
+        components: descriptors.sort((a, b) => a.componentKey.localeCompare(b.componentKey)),
+        jsdocByComponentKey,
+        typescriptApiByComponentKey,
+    };
+}
+//# sourceMappingURL=static-components.js.map
+//# debugId=2d262f78-ace0-5edb-971a-e5a64f11140a

package/dist/code-analyzer/analyzers/static-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-components.js","sources":["../../../src/code-analyzer/analyzers/static-components.ts"],"sourceRoot":"","sourcesContent":["import { access, readFile } from \"node:fs/promises\"\nimport path from \"node:path\"\nimport { globSync } from \"glob\"\nimport * as ts from \"typescript\"\n\nimport { analyzeComponents } from \"../components/analyze.js\"\nimport { Component, ComponentProperty } from \"../components/types.js\"\nimport { componentKeyFrom } from \"./helpers.js\"\nimport {\n  ComponentApiProperty,\n  ComponentDescriptor,\n  JsDocRecord,\n  LinkedTypeRecord,\n  StaticComponentAnalyzerResult,\n} from \"./types.js\"\n\ntype WorkspacePackageJson = {\n  name?: string\n  workspaces?: string[] | { packages?: string[] }\n}\n\nfunction getWorkspacePatterns(packageJson: WorkspacePackageJson): string[] {\n  const raw = packageJson.workspaces\n  if (!raw) {\n    return []\n  }\n\n  return Array.isArray(raw) ? raw : (raw.packages ?? [])\n}\n\ntype AnalyzeTarget = {\n  importFrom: string\n  rootDir: string\n}\n\ntype AnalyzeComponentsResult = {\n  components: Component[]\n  sourceRootDir: string\n}\n\ntype LocalTypeDeclaration = {\n  definition: string\n  lineEnd: number\n  lineStart: number\n  name: string\n}\n\ntype ImportedTypeBinding = {\n  importedName: string\n  sourceFilePath: string\n}\n\nconst ignoredReferenceTypeNames = new Set([\n  \"AbortSignal\",\n  \"Array\",\n  \"ArrayBuffer\",\n  \"Blob\",\n  \"Booleanish\",\n  \"ChangeEvent\",\n  \"ClassName\",\n  \"CSSProperties\",\n  \"Date\",\n  \"ElementType\",\n  \"Error\",\n  \"Event\",\n  \"Exclude\",\n  \"Extract\",\n  \"FocusEvent\",\n  \"FormEvent\",\n  \"HTMLElement\",\n  \"HTMLInputElement\",\n  \"HTMLLabelElement\",\n  \"IntersectionObserver\",\n  \"JSX\",\n  \"KeyboardEvent\",\n  \"LegacyRef\",\n  \"Map\",\n  \"MouseEvent\",\n  \"NonNullable\",\n  \"Omit\",\n  \"Partial\",\n  \"Pick\",\n  \"PointerEvent\",\n  \"Promise\",\n  \"PropsWithChildren\",\n  \"Readonly\",\n  \"Record\",\n  \"Ref\",\n  \"RefObject\",\n  \"Required\",\n  \"ReturnType\",\n  \"Set\",\n  \"String\",\n  \"SubmitEvent\",\n  \"SyntheticEvent\",\n  \"Uint8Array\",\n  \"URL\",\n])\n\nfunction serializePropType(type: unknown): string {\n  if (type == null) {\n    return \"unknown\"\n  }\n\n  if (typeof type === \"string\") {\n    return type\n  }\n\n  if (typeof type === \"object\") {\n    const maybeRaw = (type as { raw?: unknown }).raw\n    if (typeof maybeRaw === \"string\" && maybeRaw.trim().length > 0) {\n      return maybeRaw.replaceAll(/\\s+/g, \" \").trim()\n    }\n  }\n\n  return JSON.stringify(type).replaceAll(/\\s+/g, \" \").trim()\n}\n\nfunction isLikelyReactNativeProp(property: ComponentProperty): boolean {\n  const declarations = property.declarations ?? []\n  if (declarations.length === 0) {\n    return false\n  }\n\n  return declarations.every(declaration => {\n    const file = declaration.fileName\n    return (\n      file.includes(\"node_modules/@types/react\") ||\n      file.includes(\"node_modules/react\") ||\n      file.includes(\"node_modules/@types/react-dom\")\n    )\n  })\n}\n\nfunction shouldIncludeProp(property: ComponentProperty): boolean {\n  if (!isLikelyReactNativeProp(property)) {\n    return true\n  }\n\n  return property.description.trim().length > 0\n}\n\nfunction extractTypeReferences(typeText: string): string[] {\n  const matches = typeText.match(/\\b[A-Z][A-Za-z0-9_]*\\b/g) ?? []\n  return [...new Set(matches.filter(token => !ignoredReferenceTypeNames.has(token)))]\n}\n\nfunction resolveRelativeImportPath(fromFilePath: string, moduleSpecifier: string): string | null {\n  if (!moduleSpecifier.startsWith(\".\")) {\n    return null\n  }\n\n  const basePath = path.resolve(path.dirname(fromFilePath), moduleSpecifier)\n  const candidates = [\n    basePath,\n    `${basePath}.ts`,\n    `${basePath}.tsx`,\n    `${basePath}.d.ts`,\n    path.join(basePath, \"index.ts\"),\n    path.join(basePath, \"index.tsx\"),\n    path.join(basePath, \"index.d.ts\"),\n  ]\n\n  return candidates.find(candidate => ts.sys.fileExists(candidate)) ?? null\n}\n\nfunction collectImportedTypeBindings(filePath: string): Map<string, ImportedTypeBinding> {\n  const sourceText = ts.sys.readFile(filePath)\n  if (!sourceText) {\n    return new Map<string, ImportedTypeBinding>()\n  }\n\n  const scriptKind = filePath.endsWith(\".tsx\") ? ts.ScriptKind.TSX : ts.ScriptKind.TS\n  const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, scriptKind)\n  const imports = new Map<string, ImportedTypeBinding>()\n\n  for (const statement of sourceFile.statements) {\n    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {\n      continue\n    }\n\n    const resolvedImportPath = resolveRelativeImportPath(filePath, statement.moduleSpecifier.text)\n    if (!resolvedImportPath) {\n      continue\n    }\n\n    const namedBindings = statement.importClause?.namedBindings\n    if (!namedBindings || !ts.isNamedImports(namedBindings)) {\n      continue\n    }\n\n    for (const element of namedBindings.elements) {\n      const localName = element.name.getText(sourceFile)\n      const importedName = element.propertyName ? element.propertyName.getText(sourceFile) : localName\n      imports.set(localName, { importedName, sourceFilePath: resolvedImportPath })\n    }\n  }\n\n  return imports\n}\n\nfunction collectRelativeImportSourceFiles(filePath: string): string[] {\n  const sourceText = ts.sys.readFile(filePath)\n  if (!sourceText) {\n    return []\n  }\n\n  const scriptKind = filePath.endsWith(\".tsx\") ? ts.ScriptKind.TSX : ts.ScriptKind.TS\n  const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, scriptKind)\n  const importSourceFiles = new Set<string>()\n\n  for (const statement of sourceFile.statements) {\n    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {\n      continue\n    }\n\n    const resolvedImportPath = resolveRelativeImportPath(filePath, statement.moduleSpecifier.text)\n    if (resolvedImportPath) {\n      importSourceFiles.add(resolvedImportPath)\n    }\n  }\n\n  return [...importSourceFiles]\n}\n\nfunction collectLocalTypeDeclarations(filePath: string): Map<string, LocalTypeDeclaration> {\n  const sourceText = ts.sys.readFile(filePath)\n  if (!sourceText) {\n    return new Map<string, LocalTypeDeclaration>()\n  }\n\n  const scriptKind = filePath.endsWith(\".tsx\") ? ts.ScriptKind.TSX : ts.ScriptKind.TS\n  const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, scriptKind)\n  const declarations = new Map<string, LocalTypeDeclaration>()\n\n  const collectNode = (node: ts.Node): void => {\n    if (ts.isInterfaceDeclaration(node) || ts.isTypeAliasDeclaration(node)) {\n      const start = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile))\n      const end = sourceFile.getLineAndCharacterOfPosition(node.getEnd())\n      const declaration = {\n        definition: node.getText(sourceFile).trim(),\n        lineEnd: end.line + 1,\n        lineStart: start.line + 1,\n        name: node.name.getText(sourceFile),\n      }\n      declarations.set(declaration.name, declaration)\n    }\n  }\n\n  for (const statement of sourceFile.statements) {\n    collectNode(statement)\n  }\n\n  return declarations\n}\n\nfunction resolveLinkedTypes(component: Component, sourceRootDir: string): LinkedTypeRecord[] {\n  const fileCandidates = [\n    path.resolve(sourceRootDir, component.componentPath),\n    path.resolve(sourceRootDir, \"src\", component.componentPath),\n  ]\n  const componentFilePath = fileCandidates.find(candidate => ts.sys.fileExists(candidate))\n  if (!componentFilePath) {\n    return []\n  }\n\n  const declarationsByFile = new Map<string, Map<string, LocalTypeDeclaration>>()\n  const importsByFile = new Map<string, Map<string, ImportedTypeBinding>>()\n  const importSourceFilesByFile = new Map<string, string[]>()\n\n  const ensureFileData = (filePath: string): void => {\n    if (!declarationsByFile.has(filePath)) {\n      declarationsByFile.set(filePath, collectLocalTypeDeclarations(filePath))\n    }\n\n    if (!importsByFile.has(filePath)) {\n      importsByFile.set(filePath, collectImportedTypeBindings(filePath))\n    }\n\n    if (!importSourceFilesByFile.has(filePath)) {\n      importSourceFilesByFile.set(filePath, collectRelativeImportSourceFiles(filePath))\n    }\n  }\n\n  ensureFileData(componentFilePath)\n  const queue: Array<{ contextFilePath: string; typeName: string }> = []\n  const seen = new Set<string>()\n\n  for (const property of Object.values(component.properties)) {\n    const serialized = serializePropType(property.type)\n    for (const reference of extractTypeReferences(serialized)) {\n      queue.push({ contextFilePath: componentFilePath, typeName: reference })\n    }\n  }\n\n  const resolved: LinkedTypeRecord[] = []\n  const added = new Set<string>()\n\n  const toDisplaySourcePath = (filePath: string): string => {\n    const sourceRelative = path.relative(sourceRootDir, filePath).replaceAll(path.sep, \"/\")\n    return sourceRelative.startsWith(\"src/\") ? sourceRelative.slice(4) : sourceRelative\n  }\n\n  while (queue.length > 0) {\n    const current = queue.shift()\n    if (!current) {\n      continue\n    }\n\n    const stateKey = `${current.contextFilePath}::${current.typeName}`\n    if (seen.has(stateKey)) {\n      continue\n    }\n\n    seen.add(stateKey)\n\n    ensureFileData(current.contextFilePath)\n    const fileDeclarations = declarationsByFile.get(current.contextFilePath) ?? new Map()\n    const declaration = fileDeclarations.get(current.typeName)\n\n    if (declaration) {\n      const addedKey = `${current.contextFilePath}::${declaration.name}`\n      if (!added.has(addedKey)) {\n        resolved.push({\n          definition: declaration.definition,\n          lineEnd: declaration.lineEnd,\n          lineStart: declaration.lineStart,\n          name: declaration.name,\n          sourcePath: toDisplaySourcePath(current.contextFilePath),\n        })\n        added.add(addedKey)\n      }\n\n      // Expand only nested local declarations from the same file to avoid noisy dependency explosion.\n      for (const nestedReference of extractTypeReferences(declaration.definition)) {\n        if (fileDeclarations.has(nestedReference)) {\n          queue.push({ contextFilePath: current.contextFilePath, typeName: nestedReference })\n        }\n      }\n\n      continue\n    }\n\n    const fileImports = importsByFile.get(current.contextFilePath) ?? new Map()\n    const importedBinding = fileImports.get(current.typeName)\n    if (importedBinding) {\n      queue.push({ contextFilePath: importedBinding.sourceFilePath, typeName: importedBinding.importedName })\n      continue\n    }\n\n    // Fallback: unresolved type may come transitively from a locally imported file\n    // (e.g. prop type is Responsive<Size>, where Size is declared in an imported types file).\n    const candidateFiles = importSourceFilesByFile.get(current.contextFilePath) ?? []\n    const matchingFiles: string[] = []\n    for (const candidateFilePath of candidateFiles) {\n      ensureFileData(candidateFilePath)\n      const declarations = declarationsByFile.get(candidateFilePath)\n      if (declarations?.has(current.typeName)) {\n        matchingFiles.push(candidateFilePath)\n      }\n    }\n\n    if (matchingFiles.length === 1) {\n      queue.push({ contextFilePath: matchingFiles[0], typeName: current.typeName })\n    }\n  }\n\n  return resolved.sort((a, b) => {\n    if (a.name === b.name) {\n      return a.sourcePath.localeCompare(b.sourcePath)\n    }\n\n    return a.name.localeCompare(b.name)\n  })\n}\n\nfunction mapProps(component: Component): ComponentApiProperty[] {\n  return Object.values(component.properties)\n    .filter(property => shouldIncludeProp(property))\n    .map(property => ({\n      name: property.name,\n      required: property.required,\n      type: serializePropType(property.type),\n    }))\n    .sort((a, b) => a.name.localeCompare(b.name))\n}\n\nasync function fileExists(filePath: string): Promise<boolean> {\n  try {\n    await access(filePath)\n    return true\n  } catch {\n    return false\n  }\n}\n\nasync function resolveWorkspacePackageDirectory(projectRoot: string, importFrom: string): Promise<string | null> {\n  const rootPackageJsonPath = path.join(projectRoot, \"package.json\")\n  if (!(await fileExists(rootPackageJsonPath))) {\n    return null\n  }\n\n  const rootPackageJson = JSON.parse(await readFile(rootPackageJsonPath, \"utf8\")) as WorkspacePackageJson\n  const workspacePatterns = getWorkspacePatterns(rootPackageJson)\n\n  for (const workspacePattern of workspacePatterns) {\n    const packageJsonFiles = globSync(`${workspacePattern}/package.json`, {\n      absolute: true,\n      cwd: projectRoot,\n      nodir: true,\n    })\n\n    for (const packageJsonFile of packageJsonFiles) {\n      const packageJson = JSON.parse(await readFile(packageJsonFile, \"utf8\")) as WorkspacePackageJson\n      if (packageJson.name === importFrom) {\n        return path.dirname(packageJsonFile)\n      }\n    }\n  }\n\n  return null\n}\n\nasync function analyzeComponentsFromBestTarget(projectRoot: string, importFrom: string): Promise<AnalyzeComponentsResult> {\n  const localWorkspacePackageDir = await resolveWorkspacePackageDirectory(projectRoot, importFrom)\n\n  const candidates: AnalyzeTarget[] = []\n  if (localWorkspacePackageDir) {\n    const sourceDir = path.join(localWorkspacePackageDir, \"src\")\n    if ((await fileExists(path.join(sourceDir, \"index.ts\"))) || (await fileExists(path.join(sourceDir, \"index.tsx\")))) {\n      candidates.push({ importFrom: \"src\", rootDir: localWorkspacePackageDir })\n    }\n\n    candidates.push({ importFrom: \".\", rootDir: localWorkspacePackageDir })\n  }\n\n  candidates.push({ importFrom, rootDir: projectRoot })\n\n  let lastError: unknown\n\n  for (const candidate of candidates) {\n    try {\n      const components = await analyzeComponents({\n        importFrom: candidate.importFrom,\n        rootDir: candidate.rootDir,\n      })\n\n      if (components.length > 0) {\n        return {\n          components,\n          sourceRootDir: candidate.rootDir,\n        }\n      }\n    } catch (error) {\n      lastError = error\n      continue\n    }\n  }\n\n  if (lastError) {\n    throw lastError\n  }\n\n  return {\n    components: [],\n    sourceRootDir: projectRoot,\n  }\n}\n\nexport async function analyzeStaticComponents(projectRoot: string, importFrom: string): Promise<StaticComponentAnalyzerResult> {\n  const { components, sourceRootDir } = await analyzeComponentsFromBestTarget(projectRoot, importFrom)\n\n  const descriptors: ComponentDescriptor[] = []\n  const jsdocByComponentKey: Record<string, JsDocRecord> = {}\n  const typescriptApiByComponentKey: StaticComponentAnalyzerResult[\"typescriptApiByComponentKey\"] = {}\n  const existingKeys = new Set<string>()\n\n  for (const component of components.sort((a, b) => a.exportName.localeCompare(b.exportName))) {\n    const componentKey = componentKeyFrom(component.exportName, component.componentPath, existingKeys)\n\n    descriptors.push({\n      componentKey,\n      componentPath: component.componentPath,\n      exportName: component.exportName,\n    })\n\n    if (component.description.trim().length > 0) {\n      jsdocByComponentKey[componentKey] = {\n        description: component.description,\n        sourcePath: component.componentPath,\n      }\n    }\n\n    const props = mapProps(component)\n    if (props.length > 0) {\n      const linkedTypes = resolveLinkedTypes(component, sourceRootDir)\n      typescriptApiByComponentKey[componentKey] = {\n        linkedTypes,\n        props,\n        sourcePath: component.componentPath,\n      }\n    }\n  }\n\n  return {\n    components: descriptors.sort((a, b) => a.componentKey.localeCompare(b.componentKey)),\n    jsdocByComponentKey,\n    typescriptApiByComponentKey,\n  }\n}\n"],"names":[],"mappings":"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","debug_id":"2d262f78-ace0-5edb-971a-e5a64f11140a"}

package/dist/code-analyzer/analyzers/storybook-docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDescriptor, DocRecord } from "./types.js";
+export declare function analyzeStorybookDocs(projectRoot: string, components: ComponentDescriptor[], excludePaths?: string[]): Promise<Record<string, DocRecord[]>>;
+//# sourceMappingURL=storybook-docs.d.ts.map

package/dist/code-analyzer/analyzers/storybook-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook-docs.d.ts","sourceRoot":"","sources":["../../../src/code-analyzer/analyzers/storybook-docs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AA8G3D,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,mBAAmB,EAAE,EACjC,YAAY,GAAE,MAAM,EAAO,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAuFtC"}

package/dist/code-analyzer/analyzers/storybook-docs.js

@@ -0,0 +1,163 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0ce14f9a-c743-50b2-959b-559515b5fa6c")}catch(e){}}();
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { collectFiles, toRelative } from "./helpers.js";
+const docsPattern = "**/*.{md,mdx}";
+const snippetWindowBefore = 3;
+const snippetWindowAfter = 8;
+const maxReferenceSnippetsPerFile = 3;
+function extractTitle(content) {
+    const headingMatch = content.match(/^#\s+(.+)$/m);
+    if (headingMatch?.[1]) {
+        return headingMatch[1].trim();
+    }
+    const metaMatch = content.match(/<Meta\s+title=["']([^"']+)["']/);
+    return metaMatch?.[1]?.trim();
+}
+function escapeRegex(input) {
+    return input.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw `\$&`);
+}
+function toPosix(input) {
+    return input.split(path.sep).join("/");
+}
+function lineAt(content, index) {
+    return content.slice(0, index).split("\n").length;
+}
+function normalizeLine(input) {
+    return input.replaceAll(/\s+/g, " ").trim().toLowerCase();
+}
+function createSnippet(content, line) {
+    const lines = content.split("\n");
+    const lineIndex = Math.max(0, Math.min(lines.length - 1, line - 1));
+    let lineStart = Math.max(1, line - snippetWindowBefore);
+    let lineEnd = Math.min(lines.length, line + snippetWindowAfter);
+    for (let i = lineIndex; i >= lineStart - 1; i -= 1) {
+        if (lines[i]?.trim() === "") {
+            lineStart = i + 2;
+            break;
+        }
+    }
+    for (let i = lineIndex; i <= lineEnd - 1; i += 1) {
+        if (lines[i]?.trim() === "") {
+            lineEnd = i;
+            break;
+        }
+    }
+    if (lineStart > lineEnd) {
+        lineStart = line;
+        lineEnd = line;
+    }
+    const snippet = lines.slice(lineStart - 1, lineEnd).join("\n").trimEnd();
+    return { lineEnd, lineStart, snippet };
+}
+function classifyDocRecord(relativePath, component, content) {
+    const normalizedPath = toPosix(relativePath).toLowerCase();
+    const componentPath = toPosix(component.componentPath).toLowerCase();
+    const componentDir = path.posix.dirname(componentPath);
+    const fileName = path.posix.basename(normalizedPath);
+    const exportName = component.exportName.toLowerCase();
+    const title = extractTitle(content);
+    const normalizedTitle = title ? normalizeLine(title) : "";
+    const componentToken = normalizeLine(component.exportName);
+    const inComponentDir = normalizedPath.startsWith(`${componentDir}/`);
+    const isReadme = fileName === "readme.md" || fileName === "readme.mdx";
+    const isDocsLike = fileName.startsWith("docs.") || fileName.endsWith(".docs.md") || fileName.endsWith(".docs.mdx");
+    const fileContainsName = fileName.includes(exportName);
+    const titleContainsName = normalizedTitle.includes(componentToken);
+    if (inComponentDir && isReadme) {
+        return { kind: "doc", score: 100 };
+    }
+    if (inComponentDir && isDocsLike) {
+        return { kind: "doc", score: 95 };
+    }
+    if (inComponentDir) {
+        return { kind: "doc", score: 90 };
+    }
+    if (fileContainsName || titleContainsName) {
+        return { kind: "doc", score: 80 };
+    }
+    if (normalizedPath.includes("/docs/") || normalizedPath.includes("/documentation/")) {
+        return { kind: "reference", score: 40 };
+    }
+    if (normalizedPath.includes("/storybook/") || normalizedPath.includes(".stories.")) {
+        return { kind: "reference", score: 35 };
+    }
+    return { kind: "reference", score: 20 };
+}
+export async function analyzeStorybookDocs(projectRoot, components, excludePaths = []) {
+    const files = await collectFiles({
+        excludePaths,
+        pattern: docsPattern,
+        projectRoot,
+    });
+    const records = {};
+    for (const file of files) {
+        const content = await readFile(file, "utf8");
+        const title = extractTitle(content);
+        const relativePath = toRelative(projectRoot, file);
+        for (const component of components) {
+            const classification = classifyDocRecord(relativePath, component, content);
+            const componentPattern = new RegExp(`\\b${escapeRegex(component.exportName)}\\b`, "gm");
+            const matches = [...content.matchAll(componentPattern)];
+            const isFullDoc = classification.kind === "doc";
+            if (!isFullDoc && matches.length === 0) {
+                continue;
+            }
+            if (!records[component.componentKey]) {
+                records[component.componentKey] = [];
+            }
+            if (isFullDoc) {
+                const firstMatchIndex = typeof matches[0]?.index === "number" ? matches[0].index : 0;
+                const line = lineAt(content, firstMatchIndex);
+                records[component.componentKey].push({
+                    content,
+                    docPath: relativePath,
+                    kind: "doc",
+                    lineEnd: line,
+                    lineStart: line,
+                    score: classification.score,
+                    title,
+                });
+                continue;
+            }
+            const snippetMatches = matches.slice(0, maxReferenceSnippetsPerFile);
+            for (const match of snippetMatches) {
+                if (typeof match.index !== "number") {
+                    continue;
+                }
+                const matchLine = lineAt(content, match.index);
+                const snippet = createSnippet(content, matchLine);
+                records[component.componentKey].push({
+                    docPath: relativePath,
+                    kind: "reference",
+                    lineEnd: snippet.lineEnd,
+                    lineStart: snippet.lineStart,
+                    score: classification.score,
+                    snippet: snippet.snippet,
+                    title,
+                });
+            }
+        }
+    }
+    for (const componentKey of Object.keys(records)) {
+        records[componentKey] = records[componentKey].sort((a, b) => {
+            if (a.score !== b.score) {
+                return b.score - a.score;
+            }
+            if (a.kind !== b.kind) {
+                return a.kind === "doc" ? -1 : 1;
+            }
+            if (a.docPath === b.docPath) {
+                if (a.lineStart === b.lineStart) {
+                    return a.lineEnd - b.lineEnd;
+                }
+                return a.lineStart - b.lineStart;
+            }
+            return a.docPath.localeCompare(b.docPath);
+        });
+    }
+    return records;
+}
+//# sourceMappingURL=storybook-docs.js.map
+//# debugId=0ce14f9a-c743-50b2-959b-559515b5fa6c