@mimir-labs/core 0.3.0 → 0.5.0

package/dist/implementation/resource-discovery/storybook-extractor.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractStorybookFacts = extractStorybookFacts;
+const node_path_1 = __importDefault(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+const typescript_analysis_1 = require("./typescript-analysis");
+function normalize(value) { return value.split(node_path_1.default.sep).join("/"); }
+function staticValue(node) {
+    if (typescript_1.default.isStringLiteral(node) || typescript_1.default.isNoSubstitutionTemplateLiteral(node))
+        return node.text;
+    if (typescript_1.default.isNumericLiteral(node))
+        return Number(node.text);
+    if (node.kind === typescript_1.default.SyntaxKind.TrueKeyword)
+        return true;
+    if (node.kind === typescript_1.default.SyntaxKind.FalseKeyword)
+        return false;
+    if (node.kind === typescript_1.default.SyntaxKind.NullKeyword)
+        return null;
+    if (typescript_1.default.isArrayLiteralExpression(node)) {
+        const values = node.elements.map((item) => typescript_1.default.isExpression(item) ? staticValue(item) : undefined);
+        return values.every((item) => item !== undefined) ? values : undefined;
+    }
+    if (typescript_1.default.isObjectLiteralExpression(node)) {
+        const value = {};
+        for (const property of node.properties) {
+            if (!typescript_1.default.isPropertyAssignment(property))
+                continue;
+            const child = staticValue(property.initializer);
+            if (child !== undefined)
+                value[property.name.getText().replace(/^['"]|['"]$/g, "")] = child;
+        }
+        return value;
+    }
+    return undefined;
+}
+function property(object, name) {
+    return object.properties.find((item) => typescript_1.default.isPropertyAssignment(item) && item.name.getText().replace(/^['"]|['"]$/g, "") === name);
+}
+async function extractStorybookFacts(input) {
+    const analysis = typeof input === "string" ? await (0, typescript_analysis_1.createTypeScriptAnalysis)(input) : input;
+    const facts = { variantsByComponent: {}, storyFilesByComponent: {}, examplesByComponent: {} };
+    for (const sourceFile of analysis.program.getSourceFiles()) {
+        if (sourceFile.isDeclarationFile || !sourceFile.fileName.includes(".stories."))
+            continue;
+        let componentName;
+        const objects = new Map();
+        for (const statement of sourceFile.statements) {
+            if (!typescript_1.default.isVariableStatement(statement))
+                continue;
+            for (const declaration of statement.declarationList.declarations) {
+                if (typescript_1.default.isIdentifier(declaration.name) && declaration.initializer && typescript_1.default.isObjectLiteralExpression(declaration.initializer)) {
+                    objects.set(declaration.name.text, declaration.initializer);
+                }
+            }
+        }
+        for (const statement of sourceFile.statements) {
+            if (!typescript_1.default.isExportAssignment(statement))
+                continue;
+            const meta = typescript_1.default.isObjectLiteralExpression(statement.expression)
+                ? statement.expression
+                : typescript_1.default.isIdentifier(statement.expression) ? objects.get(statement.expression.text) : undefined;
+            if (!meta)
+                continue;
+            const component = property(meta, "component")?.initializer;
+            if (component && typescript_1.default.isIdentifier(component))
+                componentName = component.text;
+        }
+        if (!componentName)
+            continue;
+        const file = normalize(node_path_1.default.relative(analysis.cwd, sourceFile.fileName));
+        const variants = [];
+        const examples = [];
+        for (const statement of sourceFile.statements) {
+            if (!typescript_1.default.isVariableStatement(statement) || !statement.modifiers?.some((item) => item.kind === typescript_1.default.SyntaxKind.ExportKeyword))
+                continue;
+            for (const declaration of statement.declarationList.declarations) {
+                if (!typescript_1.default.isIdentifier(declaration.name))
+                    continue;
+                const name = declaration.name.text;
+                variants.push(name);
+                const object = declaration.initializer && typescript_1.default.isObjectLiteralExpression(declaration.initializer) ? declaration.initializer : undefined;
+                const argsValue = object && property(object, "args")?.initializer;
+                const decoratorsValue = object && property(object, "decorators")?.initializer;
+                const args = argsValue && staticValue(argsValue);
+                examples.push({
+                    name, source: { file }, story: name,
+                    ...(args && typeof args === "object" && !Array.isArray(args) ? { args } : {}),
+                    ...(decoratorsValue && typescript_1.default.isArrayLiteralExpression(decoratorsValue) ? { decorators: decoratorsValue.elements.map((item) => item.getText(sourceFile)) } : {}),
+                    ...(object && property(object, "play") ? { play: true } : {})
+                });
+            }
+        }
+        facts.variantsByComponent[componentName] = [...new Set([...(facts.variantsByComponent[componentName] ?? []), ...variants])].sort();
+        facts.storyFilesByComponent[componentName] = [...new Set([...(facts.storyFilesByComponent[componentName] ?? []), file])].sort();
+        facts.examplesByComponent[componentName] = [...(facts.examplesByComponent[componentName] ?? []), ...examples];
+    }
+    return facts;
+}
+//# sourceMappingURL=storybook-extractor.js.map

package/dist/implementation/resource-discovery/storybook-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storybook-extractor.js","sourceRoot":"","sources":["../../../src/implementation/resource-discovery/storybook-extractor.ts"],"names":[],"mappings":"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"}

package/dist/implementation/resource-discovery/typescript-analysis.d.ts

@@ -0,0 +1,7 @@
+import ts from "typescript";
+export type TypeScriptAnalysis = {
+    cwd: string;
+    program: ts.Program;
+    checker: ts.TypeChecker;
+};
+export declare function createTypeScriptAnalysis(cwd: string): Promise<TypeScriptAnalysis>;

package/dist/implementation/resource-discovery/typescript-analysis.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTypeScriptAnalysis = createTypeScriptAnalysis;
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = require("node:fs/promises");
+const typescript_1 = __importDefault(require("typescript"));
+const TS_EXTENSIONS = new Set([".ts", ".tsx"]);
+async function collectFiles(dir) {
+    const entries = await (0, promises_1.readdir)(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const absolutePath = node_path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === "node_modules" || entry.name === "dist" || entry.name.startsWith("."))
+                continue;
+            files.push(...(await collectFiles(absolutePath)));
+        }
+        else if (entry.isFile() && TS_EXTENSIONS.has(node_path_1.default.extname(entry.name))) {
+            files.push(absolutePath);
+        }
+    }
+    return files;
+}
+async function createTypeScriptAnalysis(cwd) {
+    const files = await collectFiles(cwd);
+    const program = typescript_1.default.createProgram(files, {
+        target: typescript_1.default.ScriptTarget.ES2022,
+        module: typescript_1.default.ModuleKind.CommonJS,
+        moduleResolution: typescript_1.default.ModuleResolutionKind.NodeJs,
+        strict: true,
+        jsx: typescript_1.default.JsxEmit.ReactJSX,
+        skipLibCheck: true,
+        esModuleInterop: true,
+        allowSyntheticDefaultImports: true,
+        resolveJsonModule: true
+    });
+    return { cwd, program, checker: program.getTypeChecker() };
+}
+//# sourceMappingURL=typescript-analysis.js.map

package/dist/implementation/resource-discovery/typescript-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-analysis.js","sourceRoot":"","sources":["../../../src/implementation/resource-discovery/typescript-analysis.ts"],"names":[],"mappings":";;;;;AA2BA,4DAcC;AAzCD,0DAA6B;AAC7B,+CAA2C;AAC3C,4DAA4B;AAE5B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAQ/C,KAAK,UAAU,YAAY,CAAC,GAAW;IACrC,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACnG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,aAAa,CAAC,GAAG,CAAC,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACzE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAEM,KAAK,UAAU,wBAAwB,CAAC,GAAW;IACxD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,oBAAE,CAAC,aAAa,CAAC,KAAK,EAAE;QACtC,MAAM,EAAE,oBAAE,CAAC,YAAY,CAAC,MAAM;QAC9B,MAAM,EAAE,oBAAE,CAAC,UAAU,CAAC,QAAQ;QAC9B,gBAAgB,EAAE,oBAAE,CAAC,oBAAoB,CAAC,MAAM;QAChD,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,oBAAE,CAAC,OAAO,CAAC,QAAQ;QACxB,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,IAAI;QACrB,4BAA4B,EAAE,IAAI;QAClC,iBAAiB,EAAE,IAAI;KACxB,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;AAC7D,CAAC"}

package/dist/implementation/resource-discovery/typescript-extractor.d.ts

@@ -0,0 +1,8 @@
+import type { DiscoveredResourceFact, ExtractedComponentFact, SemanticResourceKind } from "../contracts/resource";
+import { type TypeScriptAnalysis } from "./typescript-analysis";
+export type TypeScriptResourceDiscoveryOptions = {
+    includeKinds?: SemanticResourceKind[];
+    excludeKinds?: SemanticResourceKind[];
+};
+export declare function discoverTypeScriptResources(cwd: string, packageName: string, options?: TypeScriptResourceDiscoveryOptions, analysis?: TypeScriptAnalysis): Promise<DiscoveredResourceFact[]>;
+export declare function extractTypeScriptComponents(cwd: string, packageName: string, options?: TypeScriptResourceDiscoveryOptions): Promise<ExtractedComponentFact[]>;

package/dist/implementation/resource-discovery/typescript-extractor.js

@@ -0,0 +1,195 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverTypeScriptResources = discoverTypeScriptResources;
+exports.extractTypeScriptComponents = extractTypeScriptComponents;
+const path_1 = __importDefault(require("path"));
+const typescript_1 = __importDefault(require("typescript"));
+const semantic_resource_classifier_1 = require("./semantic-resource-classifier");
+const typescript_analysis_1 = require("./typescript-analysis");
+function normalizeSlashes(value) {
+    return value.split(path_1.default.sep).join("/");
+}
+function sourceFileHasModuleImport(sourceFile, predicate) {
+    for (const statement of sourceFile.statements) {
+        if (!typescript_1.default.isImportDeclaration(statement) || !typescript_1.default.isStringLiteral(statement.moduleSpecifier)) {
+            continue;
+        }
+        const modulePath = statement.moduleSpecifier.text;
+        if (predicate(modulePath)) {
+            return true;
+        }
+    }
+    return false;
+}
+function declarationContainsSignal(declaration, predicate) {
+    let found = false;
+    const visit = (node) => {
+        if (found) {
+            return;
+        }
+        if (predicate(node)) {
+            found = true;
+            return;
+        }
+        typescript_1.default.forEachChild(node, visit);
+    };
+    visit(declaration);
+    return found;
+}
+function hasJsxInDeclaration(declaration) {
+    return declarationContainsSignal(declaration, (node) => typescript_1.default.isJsxElement(node) || typescript_1.default.isJsxSelfClosingElement(node) || typescript_1.default.isJsxFragment(node));
+}
+function hasCreateContextCall(declaration) {
+    return declarationContainsSignal(declaration, (node) => {
+        if (!typescript_1.default.isCallExpression(node)) {
+            return false;
+        }
+        if (typescript_1.default.isIdentifier(node.expression)) {
+            return node.expression.text === "createContext";
+        }
+        return typescript_1.default.isPropertyAccessExpression(node.expression) && node.expression.name.text === "createContext";
+    });
+}
+function hasStyledCall(declaration) {
+    return declarationContainsSignal(declaration, (node) => {
+        if (!typescript_1.default.isCallExpression(node)) {
+            return false;
+        }
+        if (typescript_1.default.isIdentifier(node.expression) && node.expression.text === "styled") {
+            return true;
+        }
+        return typescript_1.default.isPropertyAccessExpression(node.expression) && typescript_1.default.isIdentifier(node.expression.expression)
+            ? node.expression.expression.text === "styled"
+            : false;
+    });
+}
+function getExportSymbol(checker, sourceFile, exportSymbol) {
+    const importName = exportSymbol.getName();
+    if ((exportSymbol.flags & typescript_1.default.SymbolFlags.Alias) !== 0) {
+        const aliased = checker.getAliasedSymbol(exportSymbol);
+        return {
+            symbol: aliased,
+            importName
+        };
+    }
+    const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
+    if (!moduleSymbol) {
+        return null;
+    }
+    return {
+        symbol: exportSymbol,
+        importName
+    };
+}
+function keyForDiscoveredResource(resource) {
+    return `${resource.filePath}::${resource.name}`;
+}
+function shouldIgnoreSourceFile(sourceFile, cwd) {
+    if (sourceFile.isDeclarationFile) {
+        return true;
+    }
+    const relative = normalizeSlashes(path_1.default.relative(cwd, sourceFile.fileName));
+    return relative.startsWith("../") || relative === "..";
+}
+async function discoverTypeScriptResources(cwd, packageName, options = {}, analysis) {
+    const resolvedAnalysis = analysis ?? (await (0, typescript_analysis_1.createTypeScriptAnalysis)(cwd));
+    const { program, checker } = resolvedAnalysis;
+    const policy = (0, semantic_resource_classifier_1.mergeClassificationPolicy)({
+        include: options.includeKinds,
+        exclude: options.excludeKinds
+    });
+    const sourceSignalsCache = new Map();
+    const resolveSourceSignals = (sourceFile) => {
+        const key = sourceFile.fileName;
+        const cached = sourceSignalsCache.get(key);
+        if (cached) {
+            return cached;
+        }
+        const resolved = {
+            hasReactImport: sourceFileHasModuleImport(sourceFile, (modulePath) => modulePath === "react" || modulePath.startsWith("react/")),
+            hasStorybookImport: sourceFileHasModuleImport(sourceFile, (modulePath) => modulePath.includes("storybook") || modulePath.includes("@stories")),
+            hasStyledImport: sourceFileHasModuleImport(sourceFile, (modulePath) => modulePath === "styled-components" ||
+                modulePath === "@emotion/styled" ||
+                modulePath.includes("styled"))
+        };
+        sourceSignalsCache.set(key, resolved);
+        return resolved;
+    };
+    const resources = new Map();
+    for (const sourceFile of program.getSourceFiles()) {
+        if (shouldIgnoreSourceFile(sourceFile, cwd)) {
+            continue;
+        }
+        const relativePath = normalizeSlashes(path_1.default.relative(cwd, sourceFile.fileName));
+        const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
+        if (!moduleSymbol) {
+            continue;
+        }
+        for (const exported of checker.getExportsOfModule(moduleSymbol)) {
+            const resolved = getExportSymbol(checker, sourceFile, exported);
+            if (!resolved) {
+                continue;
+            }
+            const declaration = resolved.symbol.valueDeclaration ?? resolved.symbol.declarations?.[0];
+            if (!declaration) {
+                continue;
+            }
+            const declarationFile = declaration.getSourceFile();
+            if (shouldIgnoreSourceFile(declarationFile, cwd)) {
+                continue;
+            }
+            const declarationSourceSignals = resolveSourceSignals(declarationFile);
+            const declarationFilePath = normalizeSlashes(path_1.default.relative(cwd, declarationFile.fileName));
+            const name = resolved.symbol.getName();
+            const signals = {
+                name,
+                filePath: declarationFilePath,
+                isPublicExport: true,
+                hasReactImport: declarationSourceSignals.hasReactImport,
+                hasJsx: hasJsxInDeclaration(declaration),
+                hasCreateContextCall: hasCreateContextCall(declaration),
+                hasStyledImport: declarationSourceSignals.hasStyledImport,
+                hasStyledCall: hasStyledCall(declaration),
+                hasStorybookImport: declarationSourceSignals.hasStorybookImport,
+                extension: path_1.default.extname(declarationFilePath)
+            };
+            const classification = (0, semantic_resource_classifier_1.classifyResource)(signals, policy);
+            const candidate = {
+                name,
+                filePath: declarationFilePath,
+                importName: resolved.importName,
+                packageName,
+                classification
+            };
+            const key = keyForDiscoveredResource(candidate);
+            const previous = resources.get(key);
+            if (!previous || candidate.classification.confidence > previous.classification.confidence) {
+                resources.set(key, candidate);
+            }
+        }
+    }
+    return [...resources.values()].sort((a, b) => {
+        const byFile = a.filePath.localeCompare(b.filePath);
+        if (byFile !== 0) {
+            return byFile;
+        }
+        return a.name.localeCompare(b.name);
+    });
+}
+async function extractTypeScriptComponents(cwd, packageName, options = {}) {
+    const resources = await discoverTypeScriptResources(cwd, packageName, options);
+    return resources
+        .filter((resource) => resource.classification.generateDescriptor)
+        .map((resource) => ({
+        name: resource.name,
+        filePath: resource.filePath,
+        importName: resource.importName,
+        packageName: resource.packageName,
+        props: {}
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=typescript-extractor.js.map

package/dist/implementation/resource-discovery/typescript-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-extractor.js","sourceRoot":"","sources":["../../../src/implementation/resource-discovery/typescript-extractor.ts"],"names":[],"mappings":"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"}

package/dist/implementation/resource-discovery/typescript-public-api-extractor.d.ts

@@ -0,0 +1,11 @@
+import type { ExtractedComponentFact, ExtractedProp, PublicComponentApi } from "../contracts/resource";
+import { type TypeScriptAnalysis } from "./typescript-analysis";
+type ExtractedPublicApiFact = {
+    name: string;
+    filePath: string;
+    api: PublicComponentApi;
+    props: Record<string, ExtractedProp>;
+};
+export declare function extractTypeScriptPublicApi(cwd: string, components: ExtractedComponentFact[], analysis?: TypeScriptAnalysis): Promise<Map<string, ExtractedPublicApiFact>>;
+export declare function getComponentPublicApiKey(component: Pick<ExtractedComponentFact, "filePath" | "name">): string;
+export {};