@auto-engineer/design-system-importer 0.6.5 → 0.7.0

package/dist/index.js

@@ -1,283 +1,8 @@
-import * as path from 'path';
-import * as fs from 'fs/promises';
-import * as dotenv from 'dotenv';
-import { fileURLToPath } from 'url';
-import * as Figma from 'figma-api';
-import { FigmaComponentsBuilder } from './FigmaComponentsBuilder.js';
-import createDebug from 'debug';
-// import { AIProvider, generateTextWithAI } from '@auto-engineer/ai-gateway';
-const debug = createDebug('design-system-importer');
-const debugFiles = createDebug('design-system-importer:files');
-const debugFigma = createDebug('design-system-importer:figma');
-const debugMarkdown = createDebug('design-system-importer:markdown');
-const debugComponents = createDebug('design-system-importer:components');
-const debugCopy = createDebug('design-system-importer:copy');
-dotenv.config();
-debug('Design system importer initialized');
-const __filename = fileURLToPath(import.meta.url);
-debugFigma('Initializing Figma API with personal access token');
-const api = new Figma.Api({
-    personalAccessToken: process.env.FIGMA_PERSONAL_TOKEN,
-});
-debugFigma('Figma API initialized');
-async function getAllTsxFiles(dir) {
-    debugFiles('Scanning directory for TSX files: %s', dir);
-    let results = [];
-    try {
-        const entries = await fs.readdir(dir, { withFileTypes: true });
-        debugFiles('Found %d entries in %s', entries.length, dir);
-        for (const entry of entries) {
-            const fullPath = path.join(dir, entry.name);
-            if (entry.isDirectory()) {
-                debugFiles('Entering subdirectory: %s', entry.name);
-                const subResults = await getAllTsxFiles(fullPath);
-                results = results.concat(subResults);
-                debugFiles('Found %d TSX files in %s', subResults.length, entry.name);
-            }
-            else if (entry.isFile() && entry.name.endsWith('.tsx')) {
-                debugFiles('Found TSX file: %s', entry.name);
-                results.push(fullPath);
-            }
-        }
-    }
-    catch (error) {
-        debugFiles('Error reading directory %s: %O', dir, error);
-    }
-    debugFiles('Total TSX files found in %s: %d', dir, results.length);
-    return results;
-}
-function getComponentNameFromFile(filePath) {
-    debugComponents('Extracting component name from: %s', filePath);
-    const file = path.basename(filePath, '.tsx');
-    // Capitalize first letter
-    const componentName = file.charAt(0).toUpperCase() + file.slice(1);
-    debugComponents('Component name: %s', componentName);
-    return componentName;
-}
-export async function generateDesignSystemMarkdown(inputDir, outputDir) {
-    debugMarkdown('Generating design system markdown from: %s to: %s', inputDir, outputDir);
-    const files = await getAllTsxFiles(inputDir);
-    if (files.length === 0) {
-        debugMarkdown('WARNING: No .tsx files found in input directory');
-        console.warn('No .tsx files found in input directory.');
-        return;
-    }
-    debugMarkdown('Processing %d TSX files', files.length);
-    const componentNames = files.map(getComponentNameFromFile).sort();
-    debugMarkdown('Found %d unique components', componentNames.length);
-    let md = '# Design System\n\n## Components\n\n';
-    for (const name of componentNames) {
-        md += `- ${name}\n`;
-        debugMarkdown('Added component to markdown: %s', name);
-    }
-    debugMarkdown('Creating output directory: %s', outputDir);
-    await fs.mkdir(outputDir, { recursive: true });
-    const outPath = path.join(outputDir, 'design-system.md');
-    debugMarkdown('Writing markdown to: %s', outPath);
-    await fs.writeFile(outPath, md);
-    debugMarkdown('Markdown file written successfully, size: %d bytes', md.length);
-}
-export * from './commands/import-design-system.js';
-export { CLI_MANIFEST } from './cli-manifest.js';
-async function copyFile(inputDir, outputDir, file) {
-    const srcPath = path.join(inputDir, file);
-    const destPath = path.join(outputDir, file);
-    debugCopy('Attempting to copy file: %s from %s to %s', file, inputDir, outputDir);
-    // Check if source file exists
-    try {
-        await fs.access(srcPath);
-        debugCopy('Source file exists: %s', srcPath);
-        debugCopy('Creating output directory: %s', outputDir);
-        await fs.mkdir(outputDir, { recursive: true });
-        await fs.copyFile(srcPath, destPath);
-        debugCopy('Successfully copied %s to %s', file, destPath);
-    }
-    catch (error) {
-        // File doesn't exist, skip copying
-        debugCopy('File %s not found in %s, error: %O', file, inputDir, error);
-        console.log(`File ${file} not found in ${inputDir}, skipping...`, error);
-    }
-}
-export async function copyDesignSystemDocsAndUserPreferences(inputDir, outputDir) {
-    debugCopy('Copying design system docs from %s to %s', inputDir, outputDir);
-    // Ensure output directory exists
-    debugCopy('Creating output directory: %s', outputDir);
-    await fs.mkdir(outputDir, { recursive: true });
-    // Try to copy existing files
-    debugCopy('Copying design-system.md...');
-    await copyFile(inputDir, outputDir, 'design-system.md');
-    debugCopy('Copying design-system-principles.md...');
-    await copyFile(inputDir, outputDir, 'design-system-principles.md');
-    // If design-system.md doesn't exist in output, try to generate it from TSX files
-    const designSystemPath = path.join(outputDir, 'design-system.md');
-    debugCopy('Checking if design-system.md exists at: %s', designSystemPath);
-    try {
-        await fs.access(designSystemPath);
-        debugCopy('design-system.md already exists');
-    }
-    catch {
-        debugCopy('design-system.md does not exist, attempting to generate from TSX files');
-        // File doesn't exist, try to generate from TSX files if inputDir exists
-        try {
-            await fs.access(inputDir);
-            debugCopy('Input directory is accessible: %s', inputDir);
-            const files = await getAllTsxFiles(inputDir);
-            if (files.length > 0) {
-                debugCopy('Found %d TSX files, generating design-system.md', files.length);
-                await generateDesignSystemMarkdown(inputDir, outputDir);
-                console.log(`Generated design-system.md from ${files.length} component files`);
-            }
-            else {
-                debugCopy('No TSX files found in %s', inputDir);
-                console.log(`No .tsx files found in ${inputDir} to generate design-system.md`);
-            }
-        }
-        catch (error) {
-            debugCopy('Input directory %s not accessible: %O', inputDir, error);
-            console.log(`Input directory ${inputDir} not accessible`);
-        }
-    }
-    debugCopy('Design system docs copy/generation complete');
-}
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-async function getFigmaComponents() {
-    debugFigma('Fetching Figma components from file: %s', process.env.FIGMA_FILE_ID);
-    let components = [];
-    try {
-        debugFigma('Making API call to Figma...');
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        const response = await api.getFileComponentSets({ file_key: process.env.FIGMA_FILE_ID });
-        debugFigma('Figma API response received');
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment,@typescript-eslint/no-unsafe-call,@typescript-eslint/no-unsafe-member-access
-        components = response.meta.component_sets.map((component) => {
-            debugFigma('Processing component: %s', component.name);
-            return {
-                name: component.name,
-                description: component.description,
-                thumbnail: component.thumbnail_url,
-            };
-        });
-        debugFigma('Successfully fetched %d components from Figma', components.length);
-        console.log('figma response: ', response);
-    }
-    catch (e) {
-        debugFigma('ERROR: Failed to fetch Figma components: %O', e);
-        console.error(e);
-    }
-    console.log(components.length);
-    return components;
-}
-export function generateMarkdownFromComponents(components) {
-    debugMarkdown('Generating markdown from %d components', components.length);
-    let md = '# Design System\n\n## Components\n\n';
-    if (components.length === 0) {
-        debugMarkdown('WARNING: No components found to generate markdown');
-        console.warn('No components found');
-    }
-    for (const [index, component] of components.entries()) {
-        debugMarkdown('Processing component %d/%d: %s', index + 1, components.length, component.name);
-        md += `### ${component.name}\nDescription: ${component.description}\nImage: ![${component.name} image](${component.thumbnail})\n\n`;
-        debugMarkdown('Added component %s with description length: %d', component.name, component.description.length);
-    }
-    debugMarkdown('Generated markdown document, total size: %d bytes', md.length);
-    return md;
-}
-export var ImportStrategy;
-(function (ImportStrategy) {
-    ImportStrategy["WITH_COMPONENTS"] = "WITH_COMPONENTS";
-    ImportStrategy["WITH_COMPONENT_SETS"] = "WITH_COMPONENT_SETS";
-    ImportStrategy["WITH_ALL_FIGMA_INSTANCES"] = "WITH_ALL_FIGMA_INSTANCES";
-})(ImportStrategy || (ImportStrategy = {}));
-export async function importDesignSystemComponentsFromFigma(outputDir, strategy = ImportStrategy.WITH_COMPONENT_SETS, filterFn) {
-    debug('Starting Figma design system import');
-    debug('Output directory: %s', outputDir);
-    debug('Import strategy: %s', strategy);
-    debug('Filter function provided: %s', filterFn ? 'yes' : 'no');
-    const figmaComponentsBuilder = new FigmaComponentsBuilder();
-    debugComponents('FigmaComponentsBuilder instance created');
-    if (strategy === ImportStrategy.WITH_COMPONENTS) {
-        debugComponents('Using strategy: WITH_COMPONENTS');
-        await figmaComponentsBuilder.withFigmaComponents();
-    }
-    else if (strategy === ImportStrategy.WITH_COMPONENT_SETS) {
-        debugComponents('Using strategy: WITH_COMPONENT_SETS');
-        await figmaComponentsBuilder.withFigmaComponentSets();
-    }
-    else if (strategy === ImportStrategy.WITH_ALL_FIGMA_INSTANCES) {
-        debugComponents('Using strategy: WITH_ALL_FIGMA_INSTANCES');
-        await figmaComponentsBuilder.withAllFigmaInstanceNames();
-    }
-    debugComponents('Strategy applied successfully');
-    // figmaComponentsBuilder.withFilteredNamesForMui();
-    // figmaComponentsBuilder.withFilteredNamesForShadcn();
-    if (filterFn) {
-        debugComponents('Applying custom filter function');
-        figmaComponentsBuilder.withFilter(filterFn);
-    }
-    debugComponents('Building Figma components...');
-    const figmaComponents = figmaComponentsBuilder.build();
-    debugComponents('Built %d Figma components', figmaComponents.length);
-    console.log(figmaComponents.length);
-    debugMarkdown('Generating markdown from Figma components');
-    const generatedComponentsMDFile = generateMarkdownFromComponents(figmaComponents);
-    debugMarkdown('Markdown generated, size: %d bytes', generatedComponentsMDFile.length);
-    // const mdWithImageAnalysis = await generateTextWithAI(
-    //   `
-    // Given this markdown file content:
-    // ${generatedComponentsMDFile}
-    //
-    // ------ INSTRUCTIONS -------
-    // !IMPORTANT: Only return with Markdown content, nothing else, I will be putting this straight in a .md file. Don't even start the file with \`\`\`markdown
-    // For every component Image: Analyze the given image and add to the given component.
-    // - add more content to the "Description:" part of the component.
-    // - add "Hierarchy:" part under the component, returning the parts a component is build of. like [Button, Input]
-    // `,
-    //   AIProvider.OpenAI,
-    //   { temperature: 0.2, maxTokens: 8000 },
-    // );
-    // await fs.mkdir(outputDir, { recursive: true });
-    // Parse the outputDir to determine if it's a file path or directory
-    const isFilePath = outputDir.endsWith('.md');
-    const actualOutputDir = isFilePath ? path.dirname(outputDir) : outputDir;
-    const fileName = isFilePath ? path.basename(outputDir) : 'design-system.md';
-    debugFiles('Creating output directory: %s', actualOutputDir);
-    await fs.mkdir(actualOutputDir, { recursive: true });
-    const outPath = path.join(actualOutputDir, fileName);
-    debugFiles('Writing markdown to: %s', outPath);
-    await fs.writeFile(outPath, generatedComponentsMDFile);
-    debugFiles('Design system markdown written successfully');
-    debug('Figma design system import complete');
-}
-// Check if this file is being run directly
-if (process.argv[1] === __filename) {
-    const [, , outputDir] = process.argv;
-    if (!outputDir) {
-        console.error('Usage: tsx src/index.ts <outputDir>');
-        process.exit(1);
-    }
-    // generateDesignSystemMarkdown(inputDir, outputDir)
-    //   .then(() => {
-    //     console.log(`design-system.md generated in ${outputDir}`);
-    //   })
-    //   .catch((err) => {
-    //     console.error('Error generating design-system.md:', err);
-    //     process.exit(1);
-    //   });
-    // copyDesignSystemDocsAndUserPreferences(inputDir, outputDir)
-    //   .then(() => {
-    //     console.log(`design-system.md copied to ${outputDir}`);
-    //   })
-    //   .catch((err) => {
-    //     console.error('Error copying design-system.md:', err);
-    //     process.exit(1);
-    //   });
-    importDesignSystemComponentsFromFigma(outputDir)
-        .then(() => {
-        console.log(`design-system.md generated to ${outputDir}`);
-    })
-        .catch((err) => {
-        console.error('Error generating design-system.md:', err);
-        process.exit(1);
-    });
-}
+// Barrel exports
+export { generateDesignSystemMarkdown } from './markdown-generator.js';
+export { copyDesignSystemDocsAndUserPreferences } from './file-operations.js';
+export { importDesignSystemComponentsFromFigma, ImportStrategy } from './figma-importer.js';
+// Command exports
+import importDesignSystemHandler from './commands/import-design-system.js';
+export const COMMANDS = [importDesignSystemHandler];
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,sCAAsC,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,qCAAqC,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG5F,kBAAkB;AAClB,OAAO,yBAAyB,MAAM,oCAAoC,CAAC;AAC3E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,yBAAyB,CAAC,CAAC"}

package/dist/markdown-generator.d.ts

@@ -0,0 +1,7 @@
+export declare function generateDesignSystemMarkdown(inputDir: string, outputDir: string): Promise<void>;
+export declare function generateMarkdownFromComponents(components: {
+    name: string;
+    description: string;
+    thumbnail: string;
+}[]): string;
+//# sourceMappingURL=markdown-generator.d.ts.map

package/dist/markdown-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-generator.d.ts","sourceRoot":"","sources":["../src/markdown-generator.ts"],"names":[],"mappings":"AAOA,wBAAsB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BrG;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,GACrE,MAAM,CAiBR"}

package/dist/markdown-generator.js

@@ -0,0 +1,44 @@
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import createDebug from 'debug';
+import { getAllTsxFiles, getComponentNameFromFile } from './file-operations.js';
+const debugMarkdown = createDebug('design-system-importer:markdown');
+export async function generateDesignSystemMarkdown(inputDir, outputDir) {
+    debugMarkdown('Generating design system markdown from: %s to: %s', inputDir, outputDir);
+    const files = await getAllTsxFiles(inputDir);
+    if (files.length === 0) {
+        debugMarkdown('WARNING: No .tsx files found in input directory');
+        console.warn('No .tsx files found in input directory.');
+        return;
+    }
+    debugMarkdown('Processing %d TSX files', files.length);
+    const componentNames = files.map(getComponentNameFromFile).sort();
+    debugMarkdown('Found %d unique components', componentNames.length);
+    let md = '# Design System\n\n## Components\n\n';
+    for (const name of componentNames) {
+        md += `- ${name}\n`;
+        debugMarkdown('Added component to markdown: %s', name);
+    }
+    debugMarkdown('Creating output directory: %s', outputDir);
+    await fs.mkdir(outputDir, { recursive: true });
+    const outPath = path.join(outputDir, 'design-system.md');
+    debugMarkdown('Writing markdown to: %s', outPath);
+    await fs.writeFile(outPath, md);
+    debugMarkdown('Markdown file written successfully, size: %d bytes', md.length);
+}
+export function generateMarkdownFromComponents(components) {
+    debugMarkdown('Generating markdown from %d components', components.length);
+    let md = '# Design System\n\n## Components\n\n';
+    if (components.length === 0) {
+        debugMarkdown('WARNING: No components found to generate markdown');
+        console.warn('No components found');
+    }
+    for (const [index, component] of components.entries()) {
+        debugMarkdown('Processing component %d/%d: %s', index + 1, components.length, component.name);
+        md += `### ${component.name}\nDescription: ${component.description}\nImage: ![${component.name} image](${component.thumbnail})\n\n`;
+        debugMarkdown('Added component %s with description length: %d', component.name, component.description.length);
+    }
+    debugMarkdown('Generated markdown document, total size: %d bytes', md.length);
+    return md;
+}
+//# sourceMappingURL=markdown-generator.js.map

package/dist/markdown-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-generator.js","sourceRoot":"","sources":["../src/markdown-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,WAAW,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,aAAa,GAAG,WAAW,CAAC,iCAAiC,CAAC,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,QAAgB,EAAE,SAAiB;IACpF,aAAa,CAAC,mDAAmD,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAExF,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,aAAa,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACxD,OAAO;IACT,CAAC;IAED,aAAa,CAAC,yBAAyB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,aAAa,CAAC,4BAA4B,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAEnE,IAAI,EAAE,GAAG,sCAAsC,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,EAAE,IAAI,KAAK,IAAI,IAAI,CAAC;QACpB,aAAa,CAAC,iCAAiC,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,aAAa,CAAC,+BAA+B,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACzD,aAAa,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChC,aAAa,CAAC,oDAAoD,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,UAAsE;IAEtE,aAAa,CAAC,wCAAwC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3E,IAAI,EAAE,GAAG,sCAAsC,CAAC;IAEhD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,aAAa,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACtD,aAAa,CAAC,gCAAgC,EAAE,KAAK,GAAG,CAAC,EAAE,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9F,EAAE,IAAI,OAAO,SAAS,CAAC,IAAI,kBAAkB,SAAS,CAAC,WAAW,cAAc,SAAS,CAAC,IAAI,WAAW,SAAS,CAAC,SAAS,OAAO,CAAC;QACpI,aAAa,CAAC,gDAAgD,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChH,CAAC;IAED,aAAa,CAAC,mDAAmD,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAC9E,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auto-engineer/design-system-importer",
-  "version": "0.6.5",
+  "version": "0.7.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,12 +14,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@auto-engineer/message-bus": "^0.5.5",
+    "@auto-engineer/message-bus": "^0.6.0",
     "figma-api": "2.0.2-beta",
     "tsx": "^3.12.7"
   },
   "devDependencies": {
-    "@auto-engineer/cli": "^0.7.6"
+    "@auto-engineer/cli": "^0.8.0"
   },
   "scripts": {
     "start": "tsx src/index.ts",

package/src/commands/import-design-system.ts

@@ -1,4 +1,4 @@
-import { type CommandHandler, type Command, type Event } from '@auto-engineer/message-bus';
+import { type Command, type Event, defineCommandHandler } from '@auto-engineer/message-bus';
 import { importDesignSystemComponentsFromFigma, ImportStrategy, type FilterFunctionType } from '../index';
 import { FilterLoader } from '../utils/FilterLoader';
 import createDebug from 'debug';
@@ -32,6 +32,44 @@ export type DesignSystemImportFailedEvent = Event<
   }
 >;
 
+export const commandHandler = defineCommandHandler<ImportDesignSystemCommand>({
+  name: 'ImportDesignSystem',
+  alias: 'import:design-system',
+  description: 'Import Figma design system',
+  category: 'import',
+  fields: {
+    outputDir: {
+      description: 'Source directory for design system',
+      required: true,
+    },
+    strategy: {
+      description: 'Import mode (e.g., WITH_COMPONENT_SETS)',
+      required: false,
+    },
+    filterPath: {
+      description: 'Optional filter file',
+      required: false,
+    },
+  },
+  examples: [
+    '$ auto import:design-system --output-dir=./.context --strategy=WITH_COMPONENT_SETS --filter-path=./shadcn-filter.ts',
+  ],
+  handle: async (
+    command: ImportDesignSystemCommand,
+  ): Promise<DesignSystemImportedEvent | DesignSystemImportFailedEvent> => {
+    debug('CommandHandler executing for ImportDesignSystem');
+    const result = await handleImportDesignSystemCommandInternal(command);
+    if (result.type === 'DesignSystemImported') {
+      debug('Command handler completed: success');
+      debugResult('Design system imported successfully to %s', result.data.outputDir);
+    } else {
+      debug('Command handler completed: failure - %s', result.data.error);
+      debugResult('Failed: %s', result.data.error);
+    }
+    return result;
+  },
+});
+
 // Handler
 async function loadFilterFunction(filterPath?: string): Promise<FilterFunctionType | undefined> {
   if (typeof filterPath !== 'string' || filterPath.trim().length === 0) {
@@ -124,36 +162,5 @@ async function handleImportDesignSystemCommandInternal(
   }
 }
 
-const importDesignSystemCommandHandler: CommandHandler<ImportDesignSystemCommand> = {
-  name: 'ImportDesignSystem',
-  handle: async (
-    command: ImportDesignSystemCommand,
-  ): Promise<DesignSystemImportedEvent | DesignSystemImportFailedEvent> => {
-    debug('CommandHandler executing for ImportDesignSystem');
-    const result = await handleImportDesignSystemCommandInternal(command);
-    if (result.type === 'DesignSystemImported') {
-      debug('Command handler completed: success');
-      debugResult('Design system imported successfully to %s', result.data.outputDir);
-    } else {
-      debug('Command handler completed: failure - %s', result.data.error);
-      debugResult('Failed: %s', result.data.error);
-    }
-    return result;
-  },
-};
-
-// CLI manifest entry for this command
-export const importDesignSystemManifest = {
-  handler: () => Promise.resolve({ default: importDesignSystemCommandHandler }),
-  description: 'Import Figma design system',
-  usage: 'import:design-system <src> <mode> [filter]',
-  examples: ['$ auto import:design-system ./.context WITH_COMPONENT_SETS ./shadcn-filter.ts'],
-  args: [
-    { name: 'src', description: 'Source directory for design system', required: true },
-    { name: 'mode', description: 'Import mode (e.g., WITH_COMPONENT_SETS)', required: true },
-    { name: 'filter', description: 'Optional filter file', required: false },
-  ],
-};
-
 // Default export is the command handler
-export default importDesignSystemCommandHandler;
+export default commandHandler;

package/src/figma-api.ts

@@ -0,0 +1,46 @@
+import * as dotenv from 'dotenv';
+import * as Figma from 'figma-api';
+import createDebug from 'debug';
+
+dotenv.config();
+
+const debugFigma = createDebug('design-system-importer:figma');
+
+debugFigma('Initializing Figma API with personal access token');
+const api = new Figma.Api({
+  personalAccessToken: process.env.FIGMA_PERSONAL_TOKEN as string,
+});
+debugFigma('Figma API initialized');
+
+export async function getFigmaComponents(): Promise<{ name: string; description: string; thumbnail: string }[]> {
+  debugFigma('Fetching Figma components from file: %s', process.env.FIGMA_FILE_ID);
+  let components: { name: string; description: string; thumbnail: string }[] = [];
+
+  try {
+    debugFigma('Making API call to Figma...');
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const response = await api.getFileComponentSets({ file_key: process.env.FIGMA_FILE_ID });
+    debugFigma('Figma API response received');
+
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+    components = response.meta.component_sets.map(
+      (component: { name: string; description: string; thumbnail_url: string }) => {
+        debugFigma('Processing component: %s', component.name);
+        return {
+          name: component.name,
+          description: component.description,
+          thumbnail: component.thumbnail_url,
+        };
+      },
+    );
+
+    debugFigma('Successfully fetched %d components from Figma', components.length);
+    console.log('figma response: ', response);
+  } catch (e) {
+    debugFigma('ERROR: Failed to fetch Figma components: %O', e);
+    console.error(e);
+  }
+
+  console.log(components.length);
+  return components;
+}

package/src/figma-importer.ts

@@ -0,0 +1,91 @@
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import createDebug from 'debug';
+import { FigmaComponentsBuilder, type FilterFunctionType } from './FigmaComponentsBuilder.js';
+import { generateMarkdownFromComponents } from './markdown-generator.js';
+
+const debug = createDebug('design-system-importer');
+const debugComponents = createDebug('design-system-importer:components');
+const debugMarkdown = createDebug('design-system-importer:markdown');
+const debugFiles = createDebug('design-system-importer:files');
+
+export enum ImportStrategy {
+  WITH_COMPONENTS = 'WITH_COMPONENTS',
+  WITH_COMPONENT_SETS = 'WITH_COMPONENT_SETS',
+  WITH_ALL_FIGMA_INSTANCES = 'WITH_ALL_FIGMA_INSTANCES',
+}
+
+export async function importDesignSystemComponentsFromFigma(
+  outputDir: string,
+  strategy: ImportStrategy = ImportStrategy.WITH_COMPONENT_SETS,
+  filterFn?: FilterFunctionType,
+): Promise<void> {
+  debug('Starting Figma design system import');
+  debug('Output directory: %s', outputDir);
+  debug('Import strategy: %s', strategy);
+  debug('Filter function provided: %s', filterFn ? 'yes' : 'no');
+
+  const figmaComponentsBuilder = new FigmaComponentsBuilder();
+  debugComponents('FigmaComponentsBuilder instance created');
+
+  if (strategy === ImportStrategy.WITH_COMPONENTS) {
+    debugComponents('Using strategy: WITH_COMPONENTS');
+    await figmaComponentsBuilder.withFigmaComponents();
+  } else if (strategy === ImportStrategy.WITH_COMPONENT_SETS) {
+    debugComponents('Using strategy: WITH_COMPONENT_SETS');
+    await figmaComponentsBuilder.withFigmaComponentSets();
+  } else if (strategy === ImportStrategy.WITH_ALL_FIGMA_INSTANCES) {
+    debugComponents('Using strategy: WITH_ALL_FIGMA_INSTANCES');
+    await figmaComponentsBuilder.withAllFigmaInstanceNames();
+  }
+  debugComponents('Strategy applied successfully');
+
+  // figmaComponentsBuilder.withFilteredNamesForMui();
+  // figmaComponentsBuilder.withFilteredNamesForShadcn();
+
+  if (filterFn) {
+    debugComponents('Applying custom filter function');
+    figmaComponentsBuilder.withFilter(filterFn);
+  }
+
+  debugComponents('Building Figma components...');
+  const figmaComponents = figmaComponentsBuilder.build();
+  debugComponents('Built %d Figma components', figmaComponents.length);
+
+  console.log(figmaComponents.length);
+
+  debugMarkdown('Generating markdown from Figma components');
+  const generatedComponentsMDFile = generateMarkdownFromComponents(figmaComponents);
+  debugMarkdown('Markdown generated, size: %d bytes', generatedComponentsMDFile.length);
+
+  // const mdWithImageAnalysis = await generateTextWithAI(
+  //   `
+  // Given this markdown file content:
+  // ${generatedComponentsMDFile}
+  //
+  // ------ INSTRUCTIONS -------
+  // !IMPORTANT: Only return with Markdown content, nothing else, I will be putting this straight in a .md file. Don't even start the file with \`\`\`markdown
+  // For every component Image: Analyze the given image and add to the given component.
+  // - add more content to the "Description:" part of the component.
+  // - add "Hierarchy:" part under the component, returning the parts a component is build of. like [Button, Input]
+  // `,
+  //   AIProvider.OpenAI,
+  //   { temperature: 0.2, maxTokens: 8000 },
+  // );
+  // await fs.mkdir(outputDir, { recursive: true });
+
+  // Parse the outputDir to determine if it's a file path or directory
+  const isFilePath = outputDir.endsWith('.md');
+  const actualOutputDir = isFilePath ? path.dirname(outputDir) : outputDir;
+  const fileName = isFilePath ? path.basename(outputDir) : 'design-system.md';
+
+  debugFiles('Creating output directory: %s', actualOutputDir);
+  await fs.mkdir(actualOutputDir, { recursive: true });
+
+  const outPath = path.join(actualOutputDir, fileName);
+  debugFiles('Writing markdown to: %s', outPath);
+  await fs.writeFile(outPath, generatedComponentsMDFile);
+  debugFiles('Design system markdown written successfully');
+
+  debug('Figma design system import complete');
+}