@mimir-labs/core 0.1.0

package/dist/implementation/generation/extractors/typescript-extractor.js

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTypeScriptComponents = extractTypeScriptComponents;
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = require("node:fs/promises");
+const fs_1 = require("../../io/fs");
+const TS_EXTENSIONS = new Set([".ts", ".tsx"]);
+function isPascalCase(name) {
+    return /^[A-Z][A-Za-z0-9]*$/.test(name);
+}
+function normalizeSlashes(value) {
+    return value.split(node_path_1.default.sep).join("/");
+}
+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)));
+            continue;
+        }
+        if (entry.isFile() &&
+            TS_EXTENSIONS.has(node_path_1.default.extname(entry.name)) &&
+            !entry.name.includes(".stories.")) {
+            files.push(absolutePath);
+        }
+    }
+    return files;
+}
+function extractExportedNames(content) {
+    const names = new Set();
+    const patterns = [
+        /export\s+function\s+([A-Z][A-Za-z0-9_]*)\s*\(/g,
+        /export\s+const\s+([A-Z][A-Za-z0-9_]*)\s*[:=]/g,
+        /export\s+class\s+([A-Z][A-Za-z0-9_]*)\s+/g,
+        /export\s+\{\s*([^}]+)\s*\}/g
+    ];
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            if (pattern.source.includes("[^}]+")) {
+                const tokens = match[1].split(",").map((item) => item.trim());
+                for (const token of tokens) {
+                    const aliasParts = token.split(/\s+as\s+/i).map((part) => part.trim());
+                    const candidate = aliasParts[aliasParts.length - 1];
+                    if (isPascalCase(candidate)) {
+                        names.add(candidate);
+                    }
+                }
+            }
+            else {
+                const candidate = match[1];
+                if (isPascalCase(candidate)) {
+                    names.add(candidate);
+                }
+            }
+        }
+    }
+    return [...names].sort((a, b) => a.localeCompare(b));
+}
+function parsePropsBlock(block) {
+    const result = {};
+    const lines = block.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        const match = /^([A-Za-z_][A-Za-z0-9_]*)\??:\s*([^;]+);?$/.exec(trimmed);
+        if (!match) {
+            continue;
+        }
+        const propName = match[1];
+        const propType = match[2].trim();
+        const optional = trimmed.includes("?:");
+        result[propName] = {
+            name: propName,
+            type: propType,
+            required: !optional
+        };
+    }
+    return result;
+}
+function extractProps(content, componentName) {
+    const interfacePattern = new RegExp(`interface\\s+${componentName}Props\\s*\\{([\\s\\S]*?)\\}`, "m");
+    const typePattern = new RegExp(`type\\s+${componentName}Props\\s*=\\s*\\{([\\s\\S]*?)\\}`, "m");
+    const interfaceMatch = interfacePattern.exec(content);
+    if (interfaceMatch) {
+        return parsePropsBlock(interfaceMatch[1]);
+    }
+    const typeMatch = typePattern.exec(content);
+    if (typeMatch) {
+        return parsePropsBlock(typeMatch[1]);
+    }
+    return {};
+}
+async function extractTypeScriptComponents(cwd, packageName) {
+    const sourceDir = node_path_1.default.join(cwd, "src");
+    const files = await collectFiles(sourceDir);
+    const components = [];
+    for (const filePath of files) {
+        const content = await (0, fs_1.readText)(filePath);
+        const exportedNames = extractExportedNames(content);
+        if (exportedNames.length === 0) {
+            continue;
+        }
+        const relativeFilePath = normalizeSlashes(node_path_1.default.relative(cwd, filePath));
+        for (const exportedName of exportedNames) {
+            components.push({
+                name: exportedName,
+                filePath: relativeFilePath,
+                importName: exportedName,
+                packageName,
+                props: extractProps(content, exportedName)
+            });
+        }
+    }
+    const unique = new Map();
+    for (const component of components) {
+        const key = component.name;
+        const previous = unique.get(key);
+        if (!previous) {
+            unique.set(key, component);
+            continue;
+        }
+        const previousScore = Object.keys(previous.props).length + (previous.filePath.endsWith("/index.ts") ? 0 : 1);
+        const candidateScore = Object.keys(component.props).length + (component.filePath.endsWith("/index.ts") ? 0 : 1);
+        if (candidateScore > previousScore) {
+            unique.set(key, component);
+        }
+    }
+    return [...unique.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=typescript-extractor.js.map

package/dist/implementation/generation/extractors/typescript-extractor.js.map

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

package/dist/implementation/generation/generate-service.d.ts

@@ -0,0 +1,6 @@
+import type { GenerateReport } from "./types";
+type GenerateOptions = {
+    force?: boolean;
+};
+export declare function generateApsFromEvidence(cwd: string, options?: GenerateOptions): Promise<GenerateReport>;
+export {};

package/dist/implementation/generation/generate-service.js

@@ -0,0 +1,121 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateApsFromEvidence = generateApsFromEvidence;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_1 = require("../io/fs");
+const json_1 = require("../io/json");
+const compatibility_1 = require("../../protocol/compatibility");
+const governance_1 = require("../../protocol/governance");
+const readme_extractor_1 = require("./extractors/readme-extractor");
+const storybook_extractor_1 = require("./extractors/storybook-extractor");
+const typescript_extractor_1 = require("./extractors/typescript-extractor");
+const component_builder_1 = require("./resource-builders/component-builder");
+const example_builder_1 = require("./resource-builders/example-builder");
+const APS_MANIFEST_RELATIVE_PATH = "./dist/aps/manifest.json";
+function hasHumanMetadata(component) {
+    return component.description.trim() !== "" && component.whenToUse.length > 0 && component.whenNotToUse.length > 0;
+}
+function toUniqueSorted(values) {
+    return [...new Set(values)].sort((a, b) => a.localeCompare(b));
+}
+async function readPackageName(cwd) {
+    const packageJsonPath = node_path_1.default.join(cwd, "package.json");
+    const packageJson = await (0, fs_1.readJson)(packageJsonPath);
+    if (typeof packageJson.name !== "string" || packageJson.name.trim() === "") {
+        throw new Error("package.json name is required for generation");
+    }
+    return packageJson.name;
+}
+async function ensureProviderDiscoverability(cwd) {
+    const warnings = [];
+    const packageJsonPath = node_path_1.default.join(cwd, "package.json");
+    const packageJson = await (0, fs_1.readJson)(packageJsonPath);
+    let changed = false;
+    if (!(0, json_1.isObject)(packageJson.aps)) {
+        packageJson.aps = {};
+        changed = true;
+    }
+    const aps = packageJson.aps;
+    if (aps.version === undefined) {
+        aps.version = 1;
+        changed = true;
+        warnings.push("APS config version was missing and has been set to 1.");
+    }
+    if (aps.manifest !== APS_MANIFEST_RELATIVE_PATH) {
+        const previous = typeof aps.manifest === "string" ? aps.manifest : "(not set)";
+        aps.manifest = APS_MANIFEST_RELATIVE_PATH;
+        changed = true;
+        warnings.push(`APS manifest path updated from '${previous}' to '${APS_MANIFEST_RELATIVE_PATH}' for consistency with generated resources.`);
+    }
+    if ((0, json_1.isObject)(packageJson.exports)) {
+        const exportsMap = packageJson.exports;
+        if (exportsMap["./package.json"] !== "./package.json") {
+            exportsMap["./package.json"] = "./package.json";
+            changed = true;
+            warnings.push("Added exports['./package.json'] for provider discovery compatibility.");
+        }
+    }
+    else if (packageJson.exports !== undefined) {
+        warnings.push("Package exports is not an object. Could not add exports['./package.json']; configure it manually for discovery compatibility.");
+    }
+    if (changed) {
+        await (0, fs_1.writeJson)(packageJsonPath, packageJson);
+    }
+    return warnings;
+}
+async function generateApsFromEvidence(cwd, options = {}) {
+    const packageName = await readPackageName(cwd);
+    const outputDir = node_path_1.default.join(cwd, "dist", "aps");
+    const manifestPath = node_path_1.default.join(outputDir, "manifest.json");
+    const componentsPath = node_path_1.default.join(outputDir, "components.json");
+    const alreadyExists = (await (0, fs_1.fileExists)(manifestPath)) || (await (0, fs_1.fileExists)(componentsPath));
+    if (alreadyExists && !options.force) {
+        throw new Error("APS resources already exist in dist/aps. Re-run with --force to replace existing generated resources.");
+    }
+    const discoverabilityWarnings = await ensureProviderDiscoverability(cwd);
+    await (0, fs_1.ensureDir)(outputDir);
+    const [typescriptComponents, storybookFacts, readmeFacts] = await Promise.all([
+        (0, typescript_extractor_1.extractTypeScriptComponents)(cwd, packageName),
+        (0, storybook_extractor_1.extractStorybookFacts)(cwd),
+        (0, readme_extractor_1.extractReadmeFacts)(cwd)
+    ]);
+    const components = typescriptComponents.map((component) => (0, component_builder_1.buildComponentResource)(component, storybookFacts, readmeFacts));
+    const exampleResult = (0, example_builder_1.buildExamplesNotImplemented)();
+    const output = {
+        components,
+        warnings: [...exampleResult.warnings, ...discoverabilityWarnings],
+        missingHumanMetadata: toUniqueSorted(components
+            .filter((component) => !hasHumanMetadata(component))
+            .map((component) => component.name))
+    };
+    const manifest = {
+        version: 1,
+        components
+    };
+    await (0, fs_1.writeJson)(componentsPath, {
+        components
+    });
+    await (0, fs_1.writeJson)(manifestPath, manifest);
+    const validateResult = (0, compatibility_1.validateApsManifest)(manifest);
+    const governanceResult = (0, governance_1.validateGovernance)(manifest);
+    return {
+        outputDir,
+        generatedResources: output.components.length,
+        warnings: output.warnings,
+        missingHumanMetadata: output.missingHumanMetadata,
+        validate: {
+            valid: validateResult.valid,
+            errors: validateResult.errors,
+            warnings: validateResult.warnings
+        },
+        governance: {
+            valid: governanceResult.valid,
+            errors: governanceResult.errors,
+            warnings: governanceResult.warnings
+        }
+    };
+}
+//# sourceMappingURL=generate-service.js.map

package/dist/implementation/generation/generate-service.js.map

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

package/dist/implementation/generation/provenance/provenance-builder.d.ts

@@ -0,0 +1,6 @@
+import type { FieldEvidence } from "../types";
+export declare function fromTypeScript(sourceRef: string): FieldEvidence;
+export declare function fromPackageJson(): FieldEvidence;
+export declare function fromStorybook(sourceRef: string): FieldEvidence;
+export declare function fromReadme(sourceRef: string): FieldEvidence;
+export declare function missingHumanSource(fieldName: string): FieldEvidence;

package/dist/implementation/generation/provenance/provenance-builder.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromTypeScript = fromTypeScript;
+exports.fromPackageJson = fromPackageJson;
+exports.fromStorybook = fromStorybook;
+exports.fromReadme = fromReadme;
+exports.missingHumanSource = missingHumanSource;
+function fromTypeScript(sourceRef) {
+    return {
+        sourceType: "typescript",
+        sourceRef,
+        confidence: "high"
+    };
+}
+function fromPackageJson() {
+    return {
+        sourceType: "package",
+        sourceRef: "package.json",
+        confidence: "high"
+    };
+}
+function fromStorybook(sourceRef) {
+    return {
+        sourceType: "storybook",
+        sourceRef,
+        confidence: "medium"
+    };
+}
+function fromReadme(sourceRef) {
+    return {
+        sourceType: "readme",
+        sourceRef,
+        confidence: "medium"
+    };
+}
+function missingHumanSource(fieldName) {
+    return {
+        sourceType: "human",
+        sourceRef: "missing",
+        confidence: "low",
+        note: `Missing human-authored source for '${fieldName}'`
+    };
+}
+//# sourceMappingURL=provenance-builder.js.map

package/dist/implementation/generation/provenance/provenance-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance-builder.js","sourceRoot":"","sources":["../../../../src/implementation/generation/provenance/provenance-builder.ts"],"names":[],"mappings":";;AAEA,wCAMC;AAED,0CAMC;AAED,sCAMC;AAED,gCAMC;AAED,gDAOC;AAvCD,SAAgB,cAAc,CAAC,SAAiB;IAC9C,OAAO;QACL,UAAU,EAAE,YAAY;QACxB,SAAS;QACT,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe;IAC7B,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAAC,SAAiB;IAC7C,OAAO;QACL,UAAU,EAAE,WAAW;QACvB,SAAS;QACT,UAAU,EAAE,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED,SAAgB,UAAU,CAAC,SAAiB;IAC1C,OAAO;QACL,UAAU,EAAE,QAAQ;QACpB,SAAS;QACT,UAAU,EAAE,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,SAAiB;IAClD,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,sCAAsC,SAAS,GAAG;KACzD,CAAC;AACJ,CAAC"}

package/dist/implementation/generation/resource-builders/component-builder.d.ts

@@ -0,0 +1,2 @@
+import type { ExtractedComponentFact, GeneratedComponentResource, ReadmeFacts, StorybookFacts } from "../types";
+export declare function buildComponentResource(component: ExtractedComponentFact, storybook: StorybookFacts, readme: ReadmeFacts): GeneratedComponentResource;

package/dist/implementation/generation/resource-builders/component-builder.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildComponentResource = buildComponentResource;
+const provenance_builder_1 = require("../provenance/provenance-builder");
+function sanitizeSegment(value) {
+    return value
+        .toLowerCase()
+        .replace(/^@/, "")
+        .replace(/[^a-z0-9]+/g, "")
+        .trim();
+}
+function splitPackageName(packageName) {
+    if (packageName.startsWith("@")) {
+        const parts = packageName.split("/");
+        const org = sanitizeSegment(parts[0] ?? "local");
+        const pkg = sanitizeSegment(parts[1] ?? "package");
+        return { org: org || "local", pkg: pkg || "package" };
+    }
+    return {
+        org: "local",
+        pkg: sanitizeSegment(packageName) || "package"
+    };
+}
+function createDeterministicId(packageName, componentName) {
+    const { org, pkg } = splitPackageName(packageName);
+    const name = sanitizeSegment(componentName) || "component";
+    return `${org}.${pkg}.component.${name}`;
+}
+function buildComponentResource(component, storybook, readme) {
+    const description = readme.descriptionsByComponent[component.name] ?? "";
+    const variants = storybook.variantsByComponent[component.name] ?? [];
+    const storyFiles = storybook.storyFilesByComponent[component.name] ?? [];
+    const evidenceByField = {
+        id: { evidence: [(0, provenance_builder_1.fromPackageJson)()] },
+        name: { evidence: [(0, provenance_builder_1.fromTypeScript)(component.filePath)] },
+        package: { evidence: [(0, provenance_builder_1.fromPackageJson)()] },
+        import: { evidence: [(0, provenance_builder_1.fromTypeScript)(component.filePath)] },
+        description: {
+            evidence: description !== ""
+                ? [(0, provenance_builder_1.fromReadme)("README.md")]
+                : [(0, provenance_builder_1.missingHumanSource)("description")]
+        },
+        props: { evidence: [(0, provenance_builder_1.fromTypeScript)(component.filePath)] },
+        variants: {
+            evidence: variants.length > 0 && storyFiles.length > 0
+                ? storyFiles.map((file) => (0, provenance_builder_1.fromStorybook)(file))
+                : [(0, provenance_builder_1.missingHumanSource)("variants")]
+        },
+        whenToUse: { evidence: [(0, provenance_builder_1.missingHumanSource)("whenToUse")] },
+        whenNotToUse: { evidence: [(0, provenance_builder_1.missingHumanSource)("whenNotToUse")] }
+    };
+    return {
+        type: "component",
+        id: createDeterministicId(component.packageName, component.name),
+        name: component.name,
+        package: component.packageName,
+        import: component.importName,
+        description,
+        props: component.props,
+        variants,
+        whenToUse: [],
+        whenNotToUse: [],
+        governance: {
+            fields: evidenceByField
+        }
+    };
+}
+//# sourceMappingURL=component-builder.js.map

package/dist/implementation/generation/resource-builders/component-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-builder.js","sourceRoot":"","sources":["../../../../src/implementation/generation/resource-builders/component-builder.ts"],"names":[],"mappings":";;AA0CA,wDA8CC;AAxFD,yEAM0C;AAQ1C,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;QACnD,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,SAAS,EAAE,CAAC;IACxD,CAAC;IAED,OAAO;QACL,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,eAAe,CAAC,WAAW,CAAC,IAAI,SAAS;KAC/C,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB,EAAE,aAAqB;IACvE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,eAAe,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC;IAC3D,OAAO,GAAG,GAAG,IAAI,GAAG,cAAc,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,SAAgB,sBAAsB,CACpC,SAAiC,EACjC,SAAyB,EACzB,MAAmB;IAEnB,MAAM,WAAW,GAAG,MAAM,CAAC,uBAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACzE,MAAM,QAAQ,GAAG,SAAS,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrE,MAAM,UAAU,GAAG,SAAS,CAAC,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAEzE,MAAM,eAAe,GAAuE;QAC1F,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,oCAAe,GAAE,CAAC,EAAE;QACrC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,mCAAc,EAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE;QACxD,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,oCAAe,GAAE,CAAC,EAAE;QAC1C,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,mCAAc,EAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE;QAC1D,WAAW,EAAE;YACX,QAAQ,EACN,WAAW,KAAK,EAAE;gBAChB,CAAC,CAAC,CAAC,IAAA,+BAAU,EAAC,WAAW,CAAC,CAAC;gBAC3B,CAAC,CAAC,CAAC,IAAA,uCAAkB,EAAC,aAAa,CAAC,CAAC;SAC1C;QACD,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,mCAAc,EAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE;QACzD,QAAQ,EAAE;YACR,QAAQ,EACN,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBAC1C,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,kCAAa,EAAC,IAAI,CAAC,CAAC;gBAC/C,CAAC,CAAC,CAAC,IAAA,uCAAkB,EAAC,UAAU,CAAC,CAAC;SACvC;QACD,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,uCAAkB,EAAC,WAAW,CAAC,CAAC,EAAE;QAC1D,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,IAAA,uCAAkB,EAAC,cAAc,CAAC,CAAC,EAAE;KACjE,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,qBAAqB,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC;QAChE,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EAAE,SAAS,CAAC,WAAW;QAC9B,MAAM,EAAE,SAAS,CAAC,UAAU;QAC5B,WAAW;QACX,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,QAAQ;QACR,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE;YACV,MAAM,EAAE,eAAe;SACxB;KACF,CAAC;AACJ,CAAC"}

package/dist/implementation/generation/resource-builders/example-builder.d.ts

@@ -0,0 +1,5 @@
+export type ExampleBuilderResult = {
+    generated: 0;
+    warnings: string[];
+};
+export declare function buildExamplesNotImplemented(): ExampleBuilderResult;

package/dist/implementation/generation/resource-builders/example-builder.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExamplesNotImplemented = buildExamplesNotImplemented;
+function buildExamplesNotImplemented() {
+    return {
+        generated: 0,
+        warnings: ["Example generation is intentionally not implemented in v1."]
+    };
+}
+//# sourceMappingURL=example-builder.js.map

package/dist/implementation/generation/resource-builders/example-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-builder.js","sourceRoot":"","sources":["../../../../src/implementation/generation/resource-builders/example-builder.ts"],"names":[],"mappings":";;AAKA,kEAKC;AALD,SAAgB,2BAA2B;IACzC,OAAO;QACL,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC,4DAA4D,CAAC;KACzE,CAAC;AACJ,CAAC"}

package/dist/implementation/generation/types.d.ts

@@ -0,0 +1,80 @@
+export type EvidenceConfidence = "high" | "medium" | "low";
+export type FieldEvidence = {
+    sourceType: string;
+    sourceRef: string;
+    confidence: EvidenceConfidence;
+    note?: string;
+};
+export type GeneratedField<T> = {
+    value: T;
+    evidence: FieldEvidence[];
+};
+export type ExtractedProp = {
+    name: string;
+    type?: string;
+    required?: boolean;
+};
+export type ExtractedComponentFact = {
+    name: string;
+    filePath: string;
+    importName: string;
+    packageName: string;
+    props: Record<string, ExtractedProp>;
+};
+export type StorybookFacts = {
+    variantsByComponent: Record<string, string[]>;
+    storyFilesByComponent: Record<string, string[]>;
+};
+export type ReadmeFacts = {
+    descriptionsByComponent: Record<string, string>;
+};
+export type GeneratedComponentResource = {
+    type: "component";
+    id: string;
+    name: string;
+    package: string;
+    import: string;
+    description: string;
+    props: Record<string, ExtractedProp>;
+    variants: string[];
+    whenToUse: string[];
+    whenNotToUse: string[];
+    governance: {
+        fields: Record<string, {
+            evidence: FieldEvidence[];
+        }>;
+    };
+};
+export type GenerateOutput = {
+    components: GeneratedComponentResource[];
+    warnings: string[];
+    missingHumanMetadata: string[];
+};
+export type GenerateReport = {
+    outputDir: string;
+    generatedResources: number;
+    warnings: string[];
+    missingHumanMetadata: string[];
+    validate: {
+        valid: boolean;
+        errors: Array<{
+            code: string;
+            path: string;
+            message: string;
+        }>;
+        warnings: string[];
+    };
+    governance?: {
+        valid: boolean;
+        errors: Array<{
+            code: string;
+            path: string;
+            message: string;
+        }>;
+        warnings: Array<{
+            code: string;
+            path: string;
+            message: string;
+        }>;
+    };
+};

package/dist/implementation/generation/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/implementation/generation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/implementation/generation/types.ts"],"names":[],"mappings":""}

package/dist/implementation/generators/aps-generator.d.ts

@@ -0,0 +1,7 @@
+import type { GenerateReport } from "../generation/types";
+import type { MimirGenerator } from "./types";
+type ApsGenerateOptions = {
+    force?: boolean;
+};
+export declare const apsGenerator: MimirGenerator<ApsGenerateOptions, GenerateReport>;
+export {};

package/dist/implementation/generators/aps-generator.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apsGenerator = void 0;
+const generate_service_1 = require("../generation/generate-service");
+exports.apsGenerator = {
+    name: "aps",
+    async generate(cwd, options) {
+        return (0, generate_service_1.generateApsFromEvidence)(cwd, options ?? {});
+    }
+};
+//# sourceMappingURL=aps-generator.js.map

package/dist/implementation/generators/aps-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aps-generator.js","sourceRoot":"","sources":["../../../src/implementation/generators/aps-generator.ts"],"names":[],"mappings":";;;AAAA,qEAAyE;AAQ5D,QAAA,YAAY,GAAuD;IAC9E,IAAI,EAAE,KAAK;IACX,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,OAA4B;QACtD,OAAO,IAAA,0CAAuB,EAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;CACF,CAAC"}

package/dist/implementation/generators/index.d.ts

@@ -0,0 +1,4 @@
+import type { MimirGenerator } from "./types";
+export type { MimirGenerator } from "./types";
+export declare function registerGenerator(generator: MimirGenerator, makeDefault?: boolean): void;
+export declare function resolveGenerator(name?: string): MimirGenerator;

package/dist/implementation/generators/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGenerator = registerGenerator;
+exports.resolveGenerator = resolveGenerator;
+const aps_generator_1 = require("./aps-generator");
+const registry_1 = require("./registry");
+const generatorRegistry = new registry_1.GeneratorRegistry();
+generatorRegistry.register(aps_generator_1.apsGenerator, true);
+function registerGenerator(generator, makeDefault = false) {
+    generatorRegistry.register(generator, makeDefault);
+}
+function resolveGenerator(name) {
+    return generatorRegistry.resolve(name);
+}
+//# sourceMappingURL=index.js.map

package/dist/implementation/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/implementation/generators/index.ts"],"names":[],"mappings":";;AASA,8CAEC;AAED,4CAEC;AAfD,mDAA+C;AAC/C,yCAA+C;AAG/C,MAAM,iBAAiB,GAAG,IAAI,4BAAiB,EAAE,CAAC;AAClD,iBAAiB,CAAC,QAAQ,CAAC,4BAAY,EAAE,IAAI,CAAC,CAAC;AAI/C,SAAgB,iBAAiB,CAAC,SAAyB,EAAE,WAAW,GAAG,KAAK;IAC9E,iBAAiB,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAa;IAC5C,OAAO,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/implementation/generators/registry.d.ts

@@ -0,0 +1,8 @@
+import type { MimirGenerator } from "./types";
+export declare class GeneratorRegistry {
+    private readonly generatorsByName;
+    private defaultName?;
+    register(generator: MimirGenerator, makeDefault?: boolean): void;
+    resolve(name?: string): MimirGenerator;
+    private normalize;
+}

package/dist/implementation/generators/registry.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneratorRegistry = void 0;
+class GeneratorRegistry {
+    generatorsByName = new Map();
+    defaultName;
+    register(generator, makeDefault = false) {
+        const normalized = this.normalize(generator.name);
+        this.generatorsByName.set(normalized, generator);
+        if (!this.defaultName || makeDefault) {
+            this.defaultName = normalized;
+        }
+    }
+    resolve(name) {
+        const requested = typeof name === "string" && name.trim() !== "" ? this.normalize(name) : this.defaultName;
+        if (!requested) {
+            throw new Error("No generators registered.");
+        }
+        const generator = this.generatorsByName.get(requested);
+        if (!generator) {
+            throw new Error(`Unknown generator '${name}'.`);
+        }
+        return generator;
+    }
+    normalize(value) {
+        return value.trim().toLowerCase();
+    }
+}
+exports.GeneratorRegistry = GeneratorRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/implementation/generators/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/implementation/generators/registry.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IACX,gBAAgB,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9D,WAAW,CAAU;IAE7B,QAAQ,CAAC,SAAyB,EAAE,WAAW,GAAG,KAAK;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAEjD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAa;QACnB,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;QAE3G,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,IAAI,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;CACF;AA/BD,8CA+BC"}

package/dist/implementation/generators/types.d.ts

@@ -0,0 +1,4 @@
+export interface MimirGenerator<TOptions = unknown, TResult = unknown> {
+    name: string;
+    generate(cwd: string, options?: TOptions): Promise<TResult>;
+}

package/dist/implementation/generators/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/implementation/generators/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/implementation/generators/types.ts"],"names":[],"mappings":""}