@mimir-labs/core 0.4.0 → 0.5.0

package/dist/implementation/knowledge/persistence-policy.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DescriptorPersistencePolicy = void 0;
+const EMPTY_REACT = {
+    forwardRef: false,
+    memo: false,
+    lazy: false,
+    suspense: false,
+    portal: false,
+    errorBoundary: false,
+    context: false,
+    provider: false,
+    customHook: false
+};
+function firstObject(graph, subject, predicate) {
+    return graph.factsFor(subject, predicate)[0]?.object;
+}
+class DescriptorPersistencePolicy {
+    excludedRelationshipTypes;
+    constructor(excludedRelationshipTypes = new Set(["imports", "exports"])) {
+        this.excludedRelationshipTypes = excludedRelationshipTypes;
+    }
+    select(graph) {
+        return graph.facts("resource")
+            .map((fact) => ({ subject: fact.subject, resource: fact.object }))
+            .filter(({ resource }) => resource.classification.generateDescriptor)
+            .map(({ subject, resource }) => {
+            const publicApi = firstObject(graph, subject, "public-api");
+            const relationships = graph.factsFor(subject, "relationship")
+                .map((fact) => fact.object)
+                .filter((relationship) => !this.excludedRelationshipTypes.has(relationship.type));
+            const examples = graph.factsFor(subject, "example").map((fact) => fact.object);
+            return {
+                resource,
+                props: publicApi?.props ?? {},
+                api: publicApi?.api,
+                relationships,
+                examples,
+                variants: [...new Set(examples.map((example) => example.story))].sort((a, b) => a.localeCompare(b)),
+                storyFiles: [...new Set(examples.map((example) => example.source.file))].sort((a, b) => a.localeCompare(b)),
+                react: firstObject(graph, subject, "react-patterns") ?? EMPTY_REACT,
+                metadata: {
+                    confidence: resource.classification.confidence,
+                    extractorVersion: "1.0.0"
+                }
+            };
+        });
+    }
+}
+exports.DescriptorPersistencePolicy = DescriptorPersistencePolicy;
+//# sourceMappingURL=persistence-policy.js.map

package/dist/implementation/knowledge/persistence-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-policy.js","sourceRoot":"","sources":["../../../src/implementation/knowledge/persistence-policy.ts"],"names":[],"mappings":";;;AA2BA,MAAM,WAAW,GAA2B;IAC1C,UAAU,EAAE,KAAK;IACjB,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,KAAK;IACb,aAAa,EAAE,KAAK;IACpB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,KAAK;IACf,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,SAAS,WAAW,CAAI,KAA2B,EAAE,OAAe,EAAE,SAA0D;IAC9H,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,MAAuB,CAAC;AACxE,CAAC;AAED,MAAa,2BAA2B;IAEnB;IADnB,YACmB,4BAAwE,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAAvG,8BAAyB,GAAzB,yBAAyB,CAA8E;IACvH,CAAC;IAEJ,MAAM,CAAC,KAA2B;QAChC,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;aAC3B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAgC,EAAE,CAAC,CAAC;aAC3F,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,kBAAkB,CAAC;aACpE,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC7B,MAAM,SAAS,GAAG,WAAW,CAAoE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YAC/H,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;iBAC1D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAA+B,CAAC;iBACnD,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;YACpF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAA0B,CAAC,CAAC;YACnG,OAAO;gBACL,QAAQ;gBACR,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE;gBAC7B,GAAG,EAAE,SAAS,EAAE,GAAG;gBACnB,aAAa;gBACb,QAAQ;gBACR,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;gBACnG,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;gBAC3G,KAAK,EAAE,WAAW,CAAyB,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,IAAI,WAAW;gBAC3F,QAAQ,EAAE;oBACR,UAAU,EAAE,QAAQ,CAAC,cAAc,CAAC,UAAU;oBAC9C,gBAAgB,EAAE,OAAO;iBAC1B;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;CACF;AA/BD,kEA+BC"}

package/dist/implementation/knowledge/providers.d.ts

@@ -0,0 +1,36 @@
+import type { KnowledgeFact, KnowledgeGraphReader, KnowledgeProvider, KnowledgeWorkspace } from "./model";
+export declare class SemanticDiscoveryProvider implements KnowledgeProvider {
+    readonly id = "semantic-discovery";
+    readonly provides: readonly ["resource", "classification"];
+    collect(workspace: KnowledgeWorkspace, _graph: KnowledgeGraphReader): Promise<KnowledgeFact[]>;
+}
+export declare class PublicApiProvider implements KnowledgeProvider {
+    readonly id = "public-api";
+    readonly requires: readonly ["resource"];
+    readonly provides: readonly ["public-api"];
+    collect(workspace: KnowledgeWorkspace, graph: KnowledgeGraphReader): Promise<KnowledgeFact[]>;
+}
+export declare class StorybookProvider implements KnowledgeProvider {
+    readonly id = "storybook";
+    readonly requires: readonly ["resource"];
+    readonly provides: readonly ["example"];
+    collect(workspace: KnowledgeWorkspace, graph: KnowledgeGraphReader): Promise<KnowledgeFact[]>;
+}
+export declare class RelationshipProvider implements KnowledgeProvider {
+    readonly id = "relationships";
+    readonly requires: readonly ["resource"];
+    readonly provides: readonly ["relationship"];
+    collect(workspace: KnowledgeWorkspace, graph: KnowledgeGraphReader): Promise<KnowledgeFact[]>;
+}
+export declare class ReactProvider implements KnowledgeProvider {
+    readonly id = "react";
+    readonly requires: readonly ["resource"];
+    readonly provides: readonly ["react-patterns"];
+    collect(workspace: KnowledgeWorkspace, graph: KnowledgeGraphReader): Promise<KnowledgeFact[]>;
+}
+export declare class DesignTokenProvider implements KnowledgeProvider {
+    readonly id = "design-tokens";
+    readonly requires: readonly ["resource"];
+    readonly provides: readonly ["design-tokens"];
+    collect(workspace: KnowledgeWorkspace, graph: KnowledgeGraphReader): Promise<KnowledgeFact[]>;
+}

package/dist/implementation/knowledge/providers.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DesignTokenProvider = exports.ReactProvider = exports.RelationshipProvider = exports.StorybookProvider = exports.PublicApiProvider = exports.SemanticDiscoveryProvider = void 0;
+const resource_identity_1 = require("../resource-identity");
+const design_token_extractor_1 = require("../resource-discovery/design-token-extractor");
+const react_pattern_extractor_1 = require("../resource-discovery/react-pattern-extractor");
+const relationship_extractor_1 = require("../resource-discovery/relationship-extractor");
+const storybook_extractor_1 = require("../resource-discovery/storybook-extractor");
+const typescript_extractor_1 = require("../resource-discovery/typescript-extractor");
+const typescript_public_api_extractor_1 = require("../resource-discovery/typescript-public-api-extractor");
+function analysis(workspace) {
+    return { cwd: workspace.cwd, program: workspace.program, checker: workspace.checker };
+}
+function subjectFor(resource) {
+    return (0, resource_identity_1.createResourceId)(resource.packageName, resource.classification.kind, resource.name);
+}
+function resources(graph) {
+    return graph.facts("resource").map((fact) => fact.object);
+}
+class SemanticDiscoveryProvider {
+    id = "semantic-discovery";
+    provides = ["resource", "classification"];
+    async collect(workspace, _graph) {
+        const found = await (0, typescript_extractor_1.discoverTypeScriptResources)(workspace.cwd, workspace.packageName, workspace.discovery, analysis(workspace));
+        return found.flatMap((resource) => [
+            {
+                subject: subjectFor(resource),
+                predicate: "resource",
+                object: resource,
+                confidence: resource.classification.confidence,
+                source: "typescript",
+                evidence: resource.classification.reasons.map((detail) => ({ kind: "classification-signal", detail, file: resource.filePath, symbol: resource.name }))
+            },
+            {
+                subject: subjectFor(resource),
+                predicate: "classification",
+                object: resource.classification,
+                confidence: resource.classification.confidence,
+                source: "typescript",
+                evidence: resource.classification.reasons.map((detail) => ({ kind: "classification-signal", detail, file: resource.filePath, symbol: resource.name }))
+            }
+        ]);
+    }
+}
+exports.SemanticDiscoveryProvider = SemanticDiscoveryProvider;
+class PublicApiProvider {
+    id = "public-api";
+    requires = ["resource"];
+    provides = ["public-api"];
+    async collect(workspace, graph) {
+        const discovered = resources(graph);
+        const components = discovered.map((resource) => ({ ...resource, props: {} }));
+        const extracted = await (0, typescript_public_api_extractor_1.extractTypeScriptPublicApi)(workspace.cwd, components, analysis(workspace));
+        return discovered.flatMap((resource) => {
+            const api = extracted.get((0, typescript_public_api_extractor_1.getComponentPublicApiKey)(resource));
+            return api ? [{
+                    subject: subjectFor(resource),
+                    predicate: "public-api",
+                    object: { api: api.api, props: api.props },
+                    confidence: 1,
+                    source: "typescript",
+                    evidence: [{ kind: "public-export", detail: resource.importName, file: resource.filePath, symbol: resource.name }]
+                }] : [];
+        });
+    }
+}
+exports.PublicApiProvider = PublicApiProvider;
+class StorybookProvider {
+    id = "storybook";
+    requires = ["resource"];
+    provides = ["example"];
+    async collect(workspace, graph) {
+        const facts = await (0, storybook_extractor_1.extractStorybookFacts)(analysis(workspace));
+        return resources(graph).flatMap((resource) => (facts.examplesByComponent[resource.name] ?? []).map((example) => ({
+            subject: subjectFor(resource),
+            predicate: "example",
+            object: example,
+            confidence: 1,
+            source: "storybook",
+            evidence: [{ kind: "exported-story", detail: example.story, file: example.source.file, symbol: example.name }]
+        })));
+    }
+}
+exports.StorybookProvider = StorybookProvider;
+class RelationshipProvider {
+    id = "relationships";
+    requires = ["resource"];
+    provides = ["relationship"];
+    async collect(workspace, graph) {
+        const discovered = resources(graph);
+        const extracted = (0, relationship_extractor_1.extractRelationships)(analysis(workspace), discovered);
+        return discovered.flatMap((resource) => (extracted.get((0, typescript_public_api_extractor_1.getComponentPublicApiKey)(resource)) ?? []).map((relationship) => ({
+            subject: subjectFor(resource),
+            predicate: "relationship",
+            object: relationship,
+            confidence: relationship.confidence,
+            source: "typescript",
+            evidence: [{ kind: "ast-reference", detail: relationship.type, file: resource.filePath, symbol: resource.name }]
+        })));
+    }
+}
+exports.RelationshipProvider = RelationshipProvider;
+class ReactProvider {
+    id = "react";
+    requires = ["resource"];
+    provides = ["react-patterns"];
+    async collect(workspace, graph) {
+        const discovered = resources(graph);
+        const extracted = (0, react_pattern_extractor_1.extractReactPatterns)(analysis(workspace), discovered);
+        return discovered.flatMap((resource) => {
+            const patterns = extracted.get((0, typescript_public_api_extractor_1.getComponentPublicApiKey)(resource));
+            if (!patterns)
+                return [];
+            const evidence = Object.entries(patterns)
+                .filter(([, present]) => present)
+                .map(([pattern]) => ({ kind: "react-pattern", detail: pattern, file: resource.filePath, symbol: resource.name }));
+            return [{
+                    subject: subjectFor(resource),
+                    predicate: "react-patterns",
+                    object: patterns,
+                    confidence: 1,
+                    source: "react",
+                    evidence
+                }];
+        });
+    }
+}
+exports.ReactProvider = ReactProvider;
+class DesignTokenProvider {
+    id = "design-tokens";
+    requires = ["resource"];
+    provides = ["design-tokens"];
+    async collect(workspace, graph) {
+        const discovered = resources(graph);
+        const extracted = (0, design_token_extractor_1.extractDesignTokens)(analysis(workspace), discovered);
+        return discovered.flatMap((resource) => {
+            const tokens = extracted.get((0, typescript_public_api_extractor_1.getComponentPublicApiKey)(resource));
+            return tokens ? [{
+                    subject: subjectFor(resource),
+                    predicate: "design-tokens",
+                    object: tokens,
+                    confidence: resource.classification.confidence,
+                    source: "design-tokens",
+                    evidence: [{ kind: "static-token-object", detail: "Statically resolved token values", file: resource.filePath, symbol: resource.name }]
+                }] : [];
+        });
+    }
+}
+exports.DesignTokenProvider = DesignTokenProvider;
+//# sourceMappingURL=providers.js.map

package/dist/implementation/knowledge/providers.js.map

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

package/dist/implementation/resource-discovery/design-token-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { DiscoveredResourceFact, ExtractedDesignTokens } from "../contracts/resource";
+import type { TypeScriptAnalysis } from "./typescript-analysis";
+export declare function extractDesignTokens(analysis: TypeScriptAnalysis, resources: DiscoveredResourceFact[]): Map<string, ExtractedDesignTokens>;

package/dist/implementation/resource-discovery/design-token-extractor.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractDesignTokens = extractDesignTokens;
+const node_path_1 = __importDefault(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+const CATEGORY_NAMES = {
+    color: "colors", colors: "colors", palette: "colors", spacing: "spacing", space: "spacing",
+    typography: "typography", font: "typography", radius: "radius", radii: "radius",
+    shadow: "shadows", shadows: "shadows", zindex: "zIndex", breakpoint: "breakpoints", breakpoints: "breakpoints"
+};
+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))
+                return undefined;
+            const name = property.name.getText().replace(/^['"]|['"]$/g, "");
+            const child = staticValue(property.initializer);
+            if (child === undefined)
+                return undefined;
+            value[name] = child;
+        }
+        return value;
+    }
+    return undefined;
+}
+function extractDesignTokens(analysis, resources) {
+    const result = new Map();
+    for (const resource of resources) {
+        if (resource.classification.kind !== "token" && resource.classification.kind !== "theme")
+            continue;
+        const sourceFile = analysis.program.getSourceFile(node_path_1.default.join(analysis.cwd, resource.filePath));
+        if (!sourceFile)
+            continue;
+        const tokens = {};
+        const visit = (node) => {
+            if (typescript_1.default.isVariableDeclaration(node) && typescript_1.default.isIdentifier(node.name) && node.initializer) {
+                const category = CATEGORY_NAMES[node.name.text.toLowerCase()];
+                const value = staticValue(node.initializer);
+                if (category && value && typeof value === "object" && !Array.isArray(value))
+                    tokens[category] = value;
+                if (typescript_1.default.isObjectLiteralExpression(node.initializer)) {
+                    for (const property of node.initializer.properties) {
+                        if (!typescript_1.default.isPropertyAssignment(property))
+                            continue;
+                        const nestedCategory = CATEGORY_NAMES[property.name.getText().replace(/^['"]|['"]$/g, "").toLowerCase()];
+                        const nestedValue = staticValue(property.initializer);
+                        if (nestedCategory && nestedValue && typeof nestedValue === "object" && !Array.isArray(nestedValue)) {
+                            tokens[nestedCategory] = nestedValue;
+                        }
+                    }
+                }
+            }
+            typescript_1.default.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+        result.set(`${resource.filePath}::${resource.name}`, tokens);
+    }
+    return result;
+}
+//# sourceMappingURL=design-token-extractor.js.map

package/dist/implementation/resource-discovery/design-token-extractor.js.map

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

package/dist/implementation/resource-discovery/react-pattern-extractor.d.ts

@@ -0,0 +1,3 @@
+import type { DiscoveredResourceFact, ExtractedReactPatterns } from "../contracts/resource";
+import type { TypeScriptAnalysis } from "./typescript-analysis";
+export declare function extractReactPatterns(analysis: TypeScriptAnalysis, resources: DiscoveredResourceFact[]): Map<string, ExtractedReactPatterns>;

package/dist/implementation/resource-discovery/react-pattern-extractor.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractReactPatterns = extractReactPatterns;
+const node_path_1 = __importDefault(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+function extractReactPatterns(analysis, resources) {
+    const result = new Map();
+    for (const resource of resources) {
+        const sourceFile = analysis.program.getSourceFile(node_path_1.default.join(analysis.cwd, resource.filePath));
+        const patterns = {
+            forwardRef: false, memo: false, lazy: false, suspense: false, portal: false,
+            errorBoundary: false, context: false, provider: false, customHook: /^use[A-Z]/.test(resource.name)
+        };
+        const visit = (node) => {
+            if (typescript_1.default.isIdentifier(node)) {
+                if (node.text === "forwardRef")
+                    patterns.forwardRef = true;
+                else if (node.text === "memo")
+                    patterns.memo = true;
+                else if (node.text === "lazy")
+                    patterns.lazy = true;
+                else if (node.text === "Suspense")
+                    patterns.suspense = true;
+                else if (node.text === "createPortal")
+                    patterns.portal = true;
+                else if (node.text === "createContext")
+                    patterns.context = true;
+                else if (node.text === "Provider")
+                    patterns.provider = true;
+            }
+            if (typescript_1.default.isClassDeclaration(node) && node.members.some((member) => typescript_1.default.isMethodDeclaration(member) && member.name.getText() === "componentDidCatch"))
+                patterns.errorBoundary = true;
+            typescript_1.default.forEachChild(node, visit);
+        };
+        if (sourceFile) {
+            const moduleSymbol = analysis.checker.getSymbolAtLocation(sourceFile);
+            const exported = moduleSymbol && analysis.checker.getExportsOfModule(moduleSymbol).find((item) => item.getName() === resource.importName);
+            const symbol = exported && (exported.flags & typescript_1.default.SymbolFlags.Alias ? analysis.checker.getAliasedSymbol(exported) : exported);
+            for (const declaration of symbol?.declarations ?? [])
+                visit(declaration);
+        }
+        result.set(`${resource.filePath}::${resource.name}`, patterns);
+    }
+    return result;
+}
+//# sourceMappingURL=react-pattern-extractor.js.map

package/dist/implementation/resource-discovery/react-pattern-extractor.js.map

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

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

@@ -0,0 +1,3 @@
+import type { DiscoveredResourceFact, ExtractedRelationship } from "../contracts/resource";
+import type { TypeScriptAnalysis } from "./typescript-analysis";
+export declare function extractRelationships(analysis: TypeScriptAnalysis, resources: DiscoveredResourceFact[]): Map<string, ExtractedRelationship[]>;

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

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractRelationships = extractRelationships;
+const node_path_1 = __importDefault(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+function normalize(value) {
+    return value.split(node_path_1.default.sep).join("/");
+}
+function extractRelationships(analysis, resources) {
+    const resourceByDeclaration = new Map();
+    const declarationsByResource = new Map();
+    const resourceByName = new Map(resources.map((resource) => [resource.name, resource]));
+    for (const resource of resources) {
+        const sourceFile = analysis.program.getSourceFile(node_path_1.default.join(analysis.cwd, resource.filePath));
+        const moduleSymbol = sourceFile && analysis.checker.getSymbolAtLocation(sourceFile);
+        const exported = moduleSymbol && analysis.checker.getExportsOfModule(moduleSymbol).find((item) => item.getName() === resource.importName);
+        const symbol = exported && (exported.flags & typescript_1.default.SymbolFlags.Alias ? analysis.checker.getAliasedSymbol(exported) : exported);
+        const declarations = symbol?.declarations ?? [];
+        declarationsByResource.set(`${normalize(resource.filePath)}::${resource.name}`, declarations);
+        for (const declaration of declarations)
+            resourceByDeclaration.set(declaration, resource);
+    }
+    const result = new Map();
+    for (const resource of resources) {
+        const sourceFile = analysis.program.getSourceFile(node_path_1.default.join(analysis.cwd, resource.filePath));
+        if (!sourceFile)
+            continue;
+        const relationships = new Map();
+        const add = (type, target, confidence) => {
+            const targetId = typeof target === "string" ? target : `local.${target.classification.kind}.${target.name.toLowerCase()}`;
+            relationships.set(`${type}:${targetId}`, { type, target: targetId, confidence });
+        };
+        const visit = (node) => {
+            if (typescript_1.default.isImportDeclaration(node) && typescript_1.default.isStringLiteral(node.moduleSpecifier))
+                add("imports", node.moduleSpecifier.text, 1);
+            if (typescript_1.default.isExportDeclaration(node) && node.moduleSpecifier && typescript_1.default.isStringLiteral(node.moduleSpecifier))
+                add("exports", node.moduleSpecifier.text, 1);
+            if (typescript_1.default.isIdentifier(node)) {
+                let symbol = analysis.checker.getSymbolAtLocation(node);
+                if (symbol?.flags && symbol.flags & typescript_1.default.SymbolFlags.Alias)
+                    symbol = analysis.checker.getAliasedSymbol(symbol);
+                const target = symbol?.declarations?.map((declaration) => resourceByDeclaration.get(declaration)).find(Boolean);
+                if (target && target.name !== resource.name) {
+                    const type = typescript_1.default.isJsxOpeningElement(node.parent) || typescript_1.default.isJsxSelfClosingElement(node.parent)
+                        ? resource.classification.kind === "page" || resource.classification.kind === "template" ? "composes" : "uses"
+                        : typescript_1.default.isTypeReferenceNode(node.parent) ? "references" : "dependsOn";
+                    add(type, target, 1);
+                }
+            }
+            if (typescript_1.default.isPropertyAccessExpression(node)) {
+                const name = node.name.text;
+                const target = resourceByName.get(node.expression.getText(sourceFile));
+                if (name === "Provider" && target)
+                    add("provides", target, 1);
+            }
+            if (typescript_1.default.isCallExpression(node)) {
+                const callName = typescript_1.default.isIdentifier(node.expression) ? node.expression.text : typescript_1.default.isPropertyAccessExpression(node.expression) ? node.expression.name.text : "";
+                if (callName === "useContext" && node.arguments[0] && typescript_1.default.isIdentifier(node.arguments[0])) {
+                    const target = resourceByName.get(node.arguments[0].text);
+                    if (target)
+                        add("consumes", target, 1);
+                }
+            }
+            typescript_1.default.forEachChild(node, visit);
+        };
+        for (const statement of sourceFile.statements) {
+            if (typescript_1.default.isImportDeclaration(statement) || typescript_1.default.isExportDeclaration(statement))
+                visit(statement);
+        }
+        const key = `${normalize(resource.filePath)}::${resource.name}`;
+        for (const declaration of declarationsByResource.get(key) ?? [])
+            visit(declaration);
+        result.set(key, [...relationships.values()].sort((a, b) => `${a.type}:${a.target}`.localeCompare(`${b.type}:${b.target}`)));
+    }
+    return result;
+}
+//# sourceMappingURL=relationship-extractor.js.map

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

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

package/dist/implementation/resource-discovery/semantic-resource-classifier.d.ts

@@ -0,0 +1,23 @@
+import type { ResourceClassification, SemanticResourceKind } from "../contracts/resource";
+export type ResourceClassificationPolicy = {
+    include: Set<SemanticResourceKind>;
+    exclude: Set<SemanticResourceKind>;
+};
+export type SemanticResourceSignals = {
+    name: string;
+    filePath: string;
+    isPublicExport: boolean;
+    hasReactImport: boolean;
+    hasJsx: boolean;
+    hasCreateContextCall: boolean;
+    hasStyledImport: boolean;
+    hasStyledCall: boolean;
+    hasStorybookImport: boolean;
+    extension: string;
+};
+export declare function defaultResourceClassificationPolicy(): ResourceClassificationPolicy;
+export declare function mergeClassificationPolicy(config?: {
+    include?: SemanticResourceKind[];
+    exclude?: SemanticResourceKind[];
+}): ResourceClassificationPolicy;
+export declare function classifyResource(signals: SemanticResourceSignals, policy: ResourceClassificationPolicy): ResourceClassification;