functional-examples 0.0.0-alpha.1

package/dist/scanner/scanner.js

@@ -0,0 +1,296 @@
+/**
+ * Core scanner that orchestrates multiple extractors
+ */
+import { minimatch } from 'minimatch';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { createInitialContext, runParsePipeline } from '../plugins/pipeline.js';
+import { validateExampleMetadata } from '../plugins/validation.js';
+import { createSchemaValidator } from '../schema/validator.js';
+import { DefaultMap, iter, } from '../types/index.js';
+import { resolveCandidates } from './candidates.js';
+/**
+ * Scan a directory for examples using the provided extractors.
+ *
+ * The scanner:
+ * 1. Runs all extractors in parallel against the root
+ * 2. Collects claimed files and detects conflicts
+ * 3. Resolves conflicts via path mappings (or errors if unresolved)
+ * 4. Applies include/exclude filters AFTER extraction
+ * 5. Returns unified results
+ *
+ * @example
+ * ```typescript
+ * import { resolveConfig, scanExamples } from 'functional-examples';
+ *
+ * const config = await resolveConfig({ root: './examples' });
+ * const result = await scanExamples(config);
+ *
+ * for (const example of result.examples) {
+ *   console.log(example.title);
+ * }
+ * ```
+ */
+export async function scanExamples(config) {
+    const startTime = Date.now();
+    const { root: configRoot, pathMappings = [], registry, metadata: metadataSchema, } = config;
+    const { include, exclude, root: scanRoot } = config.scan;
+    const root = scanRoot ?? configRoot;
+    console.log({ root, scanRoot, configRoot });
+    // Resolve candidates from include/exclude patterns
+    // Default to '*' if no include patterns specified (match direct children)
+    const candidates = await resolveCandidates(root, include.length > 0 ? include : ['*'], exclude);
+    // Collect all extractors from the registry
+    const allExtractors = registry.getExtractors();
+    if (allExtractors.length === 0) {
+        return {
+            examples: [],
+            errors: [
+                {
+                    path: root,
+                    message: 'No extractors provided',
+                },
+            ],
+            conflicts: [],
+            stats: {
+                filesClaimed: 0,
+                examplesFound: 0,
+                conflictsDetected: 0,
+                conflictsResolved: 0,
+                durationMs: Date.now() - startTime,
+            },
+        };
+    }
+    // Step 1: Run all extractors in parallel
+    const extractorResults = await runExtractorsInParallel(allExtractors, candidates, {
+        rootPath: root,
+        exclude,
+    });
+    // Step 2: Build file claim map (file -> [extractor names])
+    const fileClaimMap = buildFileClaimMap(extractorResults);
+    // Step 3: Detect and resolve conflicts
+    const { conflicts, resolvedConflicts, unresolvedConflicts } = resolveConflicts(fileClaimMap, pathMappings);
+    // Step 4: Filter examples based on conflict resolution
+    const allExamples = extractorResults.flatMap((r) => r.examples);
+    const filteredExamples = filterExamplesByConflicts(allExamples, unresolvedConflicts, resolvedConflicts);
+    // Step 5: No post-extraction filtering - include/exclude only affect candidate resolution
+    // Step 6: Convert to ScannedExample (compute displayPath)
+    const scannedExamples = filteredExamples.map((example) => ({
+        ...example,
+        displayPath: path.relative(root, example.rootPath) || '.',
+        metadata: example.metadata,
+    }));
+    // Build lookup for examples by ID
+    const examplesById = new Map(scannedExamples.map((ex) => [ex.id, ex]));
+    // Step 7: Initialize error accumulator (displayPath -> source -> messages[])
+    const errorsByPath = new DefaultMap(() => new DefaultMap(() => []));
+    // Helper to add errors to the accumulator
+    const addError = (displayPath, source, message) => {
+        errorsByPath.get(displayPath).get(source).push(message);
+    };
+    // Collect extractor errors
+    for (const result of extractorResults) {
+        for (const error of result.errors) {
+            const displayPath = path.relative(root, error.path) || error.path;
+            addError(displayPath, result.extractorName, error.message);
+        }
+    }
+    // Collect unresolved conflict errors
+    for (const conflict of unresolvedConflicts) {
+        const displayPath = path.relative(root, conflict.filePath) || '.';
+        addError(displayPath, 'conflict', `File claimed by multiple extractors: ${conflict.claimants.join(', ')}. Add a pathMapping to resolve.`);
+    }
+    // Step 8: Process file contents through parser pipelines
+    for (const example of scannedExamples) {
+        for (const file of example.files) {
+            const ext = path.extname(file.absolutePath);
+            const parsers = registry.getParsersForExtension(ext);
+            if (parsers.length > 0) {
+                // Load file content if not already loaded
+                if (file.raw === undefined) {
+                    file.raw = await fs.readFile(file.absolutePath, 'utf-8');
+                }
+                const ctx = createInitialContext(file.absolutePath, file.raw);
+                const result = await runParsePipeline(ctx, parsers);
+                file.parsed = result.parsed;
+                file.hunks = result.hunks;
+            }
+        }
+    }
+    // Step 9: Run plugin metadata validators
+    const metadataValidators = registry.getMetadataValidators();
+    if (metadataValidators.length > 0) {
+        const validationResult = validateExampleMetadata({
+            validators: metadataValidators,
+            examples: scannedExamples.map((e) => ({
+                id: e.id,
+                metadata: e.metadata,
+            })),
+        });
+        for (const error of validationResult.errors) {
+            const example = examplesById.get(error.exampleId);
+            if (example) {
+                addError(example.displayPath, error.pluginName, error.message);
+            }
+        }
+    }
+    // Step 10: Run config metadata schema validation (AJV)
+    if (metadataSchema) {
+        const validateSchema = createSchemaValidator(metadataSchema);
+        for (const example of scannedExamples) {
+            const result = validateSchema(example.metadata);
+            if (!result.success) {
+                for (const error of result.errors) {
+                    addError(example.displayPath, 'config.metadata', `${error.path || '(root)'}: ${error.message}`);
+                }
+            }
+        }
+    }
+    // Step 11: Flatten errors into final array
+    const errors = iter(errorsByPath.entries())
+        .map(([displayPath, sourceErrors]) => ({
+        path: displayPath,
+        message: iter(sourceErrors.entries())
+            .map(([source, msgs]) => iter(msgs)
+            .map((msg) => `    ${msg}`)
+            .prefix([`  [${source}]:`]))
+            .flat()
+            .join('\n'),
+    }))
+        .collect();
+    // for (const [displayPath, sourceErrors] of errorsByPath.entries()) {
+    //   const lines: string[] = [];
+    //   for (const [source, msgs] of sourceErrors.entries()) {
+    //     lines.push(`  [${source}]:`);
+    //     for (const msg of msgs) {
+    //       lines.push(`    ${msg}`);
+    //     }
+    //   }
+    //   errors.push({ path: displayPath, message: lines.join('\n') });
+    // }
+    return {
+        examples: scannedExamples,
+        errors,
+        conflicts,
+        stats: {
+            filesClaimed: fileClaimMap.size,
+            examplesFound: scannedExamples.length,
+            conflictsDetected: conflicts.length,
+            conflictsResolved: resolvedConflicts.length,
+            durationMs: Date.now() - startTime,
+        },
+    };
+}
+/**
+ * Run all extractors in parallel
+ */
+async function runExtractorsInParallel(extractors, candidates, options) {
+    const results = await Promise.all(extractors.map(async (extractor) => {
+        try {
+            const result = await extractor.extract(candidates, options);
+            return { ...result, extractorName: extractor.name };
+        }
+        catch (error) {
+            // Extractor threw unexpectedly - wrap as error result
+            return {
+                examples: [],
+                errors: [
+                    {
+                        path: options.rootPath,
+                        message: `Extractor "${extractor.name}" failed: ${error.message}`,
+                        cause: error,
+                    },
+                ],
+                claimedFiles: new Set(),
+                extractorName: extractor.name,
+            };
+        }
+    }));
+    return results;
+}
+/**
+ * Build a map of file path -> extractor names that claimed it
+ */
+function buildFileClaimMap(results) {
+    const fileClaimMap = new Map();
+    for (const result of results) {
+        for (const file of result.claimedFiles) {
+            const existing = fileClaimMap.get(file) ?? [];
+            existing.push(result.extractorName);
+            fileClaimMap.set(file, existing);
+        }
+    }
+    return fileClaimMap;
+}
+/**
+ * Detect conflicts and attempt resolution via path mappings
+ */
+function resolveConflicts(fileClaimMap, pathMappings) {
+    const conflicts = [];
+    const resolvedConflicts = [];
+    const unresolvedConflicts = [];
+    for (const [filePath, claimants] of fileClaimMap) {
+        if (claimants.length <= 1)
+            continue;
+        // This is a conflict - try to resolve via path mappings
+        let resolved = false;
+        for (const mapping of pathMappings) {
+            if (minimatch(filePath, mapping.pattern)) {
+                if (claimants.includes(mapping.extractor)) {
+                    const conflict = {
+                        filePath,
+                        claimants,
+                        resolution: 'path-mapping',
+                        winner: mapping.extractor,
+                    };
+                    conflicts.push(conflict);
+                    resolvedConflicts.push(conflict);
+                    resolved = true;
+                    break;
+                }
+            }
+        }
+        if (!resolved) {
+            const conflict = {
+                filePath,
+                claimants,
+                resolution: 'error',
+            };
+            conflicts.push(conflict);
+            unresolvedConflicts.push(conflict);
+        }
+    }
+    return { conflicts, resolvedConflicts, unresolvedConflicts };
+}
+/**
+ * Filter examples based on conflict resolution.
+ * - Remove examples containing files from unresolved conflicts
+ * - For resolved conflicts, keep only the winning extractor's examples
+ */
+function filterExamplesByConflicts(examples, unresolvedConflicts, resolvedConflicts) {
+    const unresolvedFiles = new Set(unresolvedConflicts.map((c) => c.filePath));
+    // Build map of file -> winning extractor for resolved conflicts
+    const winnerMap = new Map();
+    for (const conflict of resolvedConflicts) {
+        if (conflict.winner) {
+            winnerMap.set(conflict.filePath, conflict.winner);
+        }
+    }
+    return examples.filter((example) => {
+        // Check if any file in this example is part of an unresolved conflict
+        const hasUnresolvedFile = example.files.some((f) => unresolvedFiles.has(f.absolutePath));
+        if (hasUnresolvedFile) {
+            return false;
+        }
+        // Check if any file in this example is part of a resolved conflict
+        // where this extractor is NOT the winner
+        for (const file of example.files) {
+            const winner = winnerMap.get(file.absolutePath);
+            if (winner && winner !== example.extractorName) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner/scanner.js.map

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

package/dist/scanner/scanner.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scanner.spec.d.ts.map

package/dist/scanner/scanner.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.spec.d.ts","sourceRoot":"","sources":["../../src/scanner/scanner.spec.ts"],"names":[],"mappings":""}

package/dist/scanner/scanner.spec.js

@@ -0,0 +1,262 @@
+import { describe, it, expect, vi } from 'vitest';
+import { scanExamples } from './scanner.js';
+/**
+ * Create a mock extractor for testing
+ */
+function createMockExtractor(name, result) {
+    return {
+        name,
+        extract: vi.fn().mockResolvedValue({
+            examples: [],
+            errors: [],
+            claimedFiles: new Set(),
+            ...result,
+        }),
+    };
+}
+/**
+ * Create a mock example for testing
+ */
+function createMockExample(id, extractorName, files) {
+    return {
+        id,
+        title: `Example ${id}`,
+        rootPath: `/test/${id}`,
+        files: files.map((f) => ({
+            absolutePath: f,
+            relativePath: f.split('/').pop() ?? f,
+        })),
+        metadata: {},
+        extractorName,
+    };
+}
+describe('scanExamples', () => {
+    describe('basic operation', () => {
+        it('returns empty result when no extractors provided', async () => {
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [],
+            });
+            expect(result.examples).toEqual([]);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].message).toBe('No extractors provided');
+        });
+        it('runs extractors in parallel and collects results', async () => {
+            const example1 = createMockExample('ex1', 'extractor-a', ['/test/a.ts']);
+            const example2 = createMockExample('ex2', 'extractor-b', ['/test/b.ts']);
+            const extractorA = createMockExtractor('extractor-a', {
+                examples: [example1],
+                claimedFiles: new Set(['/test/a.ts']),
+            });
+            const extractorB = createMockExtractor('extractor-b', {
+                examples: [example2],
+                claimedFiles: new Set(['/test/b.ts']),
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractorA, extractorB],
+            });
+            expect(extractorA.extract).toHaveBeenCalledWith('/test', expect.any(Object));
+            expect(extractorB.extract).toHaveBeenCalledWith('/test', expect.any(Object));
+            expect(result.examples).toHaveLength(2);
+            expect(result.examples.map((e) => e.id)).toEqual(['ex1', 'ex2']);
+            expect(result.errors).toHaveLength(0);
+            expect(result.conflicts).toHaveLength(0);
+        });
+        it('collects errors from extractors', async () => {
+            const extractor = createMockExtractor('extractor-a', {
+                errors: [{ path: '/test/bad.ts', message: 'Invalid syntax' }],
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractor],
+            });
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].message).toBe('Invalid syntax');
+        });
+        it('handles extractor exceptions gracefully', async () => {
+            const extractor = {
+                name: 'failing-extractor',
+                extract: vi.fn().mockRejectedValue(new Error('Extractor crashed')),
+            };
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractor],
+            });
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].message).toContain('Extractor "failing-extractor" failed');
+            expect(result.errors[0].message).toContain('Extractor crashed');
+        });
+    });
+    describe('conflict detection', () => {
+        it('detects when multiple extractors claim the same file', async () => {
+            const sharedFile = '/test/shared.ts';
+            const example1 = createMockExample('ex1', 'extractor-a', [sharedFile]);
+            const example2 = createMockExample('ex2', 'extractor-b', [sharedFile]);
+            const extractorA = createMockExtractor('extractor-a', {
+                examples: [example1],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const extractorB = createMockExtractor('extractor-b', {
+                examples: [example2],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractorA, extractorB],
+            });
+            expect(result.conflicts).toHaveLength(1);
+            expect(result.conflicts[0].filePath).toBe(sharedFile);
+            expect(result.conflicts[0].claimants).toEqual(['extractor-a', 'extractor-b']);
+            expect(result.conflicts[0].resolution).toBe('error');
+            expect(result.stats.conflictsDetected).toBe(1);
+            expect(result.stats.conflictsResolved).toBe(0);
+        });
+        it('adds error for unresolved conflicts', async () => {
+            const sharedFile = '/test/shared.ts';
+            const extractorA = createMockExtractor('extractor-a', {
+                examples: [createMockExample('ex1', 'extractor-a', [sharedFile])],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const extractorB = createMockExtractor('extractor-b', {
+                examples: [createMockExample('ex2', 'extractor-b', [sharedFile])],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractorA, extractorB],
+            });
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].message).toContain('claimed by multiple extractors');
+            expect(result.errors[0].message).toContain('extractor-a');
+            expect(result.errors[0].message).toContain('extractor-b');
+        });
+        it('excludes examples with conflicting files from results', async () => {
+            const sharedFile = '/test/shared.ts';
+            const extractorA = createMockExtractor('extractor-a', {
+                examples: [createMockExample('ex1', 'extractor-a', [sharedFile])],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const extractorB = createMockExtractor('extractor-b', {
+                examples: [createMockExample('ex2', 'extractor-b', [sharedFile])],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractorA, extractorB],
+            });
+            // Both examples should be excluded due to unresolved conflict
+            expect(result.examples).toHaveLength(0);
+        });
+    });
+    describe('conflict resolution via path mappings', () => {
+        it('resolves conflicts using path mappings', async () => {
+            const sharedFile = '/test/cli-forge/example.ts';
+            const example1 = createMockExample('ex1', 'frontmatter', [sharedFile]);
+            const example2 = createMockExample('ex2', 'meta-yml', [sharedFile]);
+            const extractorA = createMockExtractor('frontmatter', {
+                examples: [example1],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const extractorB = createMockExtractor('meta-yml', {
+                examples: [example2],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractorA, extractorB],
+                pathMappings: [
+                    { pattern: '**/cli-forge/**', extractor: 'frontmatter' },
+                ],
+            });
+            expect(result.conflicts).toHaveLength(1);
+            expect(result.conflicts[0].resolution).toBe('path-mapping');
+            expect(result.conflicts[0].winner).toBe('frontmatter');
+            expect(result.stats.conflictsResolved).toBe(1);
+            // Only the winning extractor's example should be included
+            expect(result.examples).toHaveLength(1);
+            expect(result.examples[0].extractorName).toBe('frontmatter');
+        });
+        it('ignores path mappings that do not match any claimant', async () => {
+            const sharedFile = '/test/shared.ts';
+            const extractorA = createMockExtractor('extractor-a', {
+                examples: [createMockExample('ex1', 'extractor-a', [sharedFile])],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const extractorB = createMockExtractor('extractor-b', {
+                examples: [createMockExample('ex2', 'extractor-b', [sharedFile])],
+                claimedFiles: new Set([sharedFile]),
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractorA, extractorB],
+                pathMappings: [
+                    // This mapping specifies an extractor that didn't claim the file
+                    { pattern: '**/*.ts', extractor: 'non-existent' },
+                ],
+            });
+            // Conflict remains unresolved
+            expect(result.conflicts[0].resolution).toBe('error');
+        });
+    });
+    describe('include/exclude filtering', () => {
+        it('excludes examples matching exclude patterns', async () => {
+            const example1 = createMockExample('ex1', 'extractor', ['/test/src/a.ts']);
+            const example2 = createMockExample('ex2', 'extractor', ['/test/dist/b.ts']);
+            example1.rootPath = '/test/src/a.ts';
+            example2.rootPath = '/test/dist/b.ts';
+            const extractor = createMockExtractor('extractor', {
+                examples: [example1, example2],
+                claimedFiles: new Set(['/test/src/a.ts', '/test/dist/b.ts']),
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractor],
+                exclude: ['**/dist/**'],
+            });
+            expect(result.examples).toHaveLength(1);
+            expect(result.examples[0].id).toBe('ex1');
+        });
+        it('includes only examples matching include patterns', async () => {
+            const example1 = createMockExample('ex1', 'extractor', ['/test/examples/a.ts']);
+            const example2 = createMockExample('ex2', 'extractor', ['/test/src/b.ts']);
+            example1.rootPath = '/test/examples/a.ts';
+            example2.rootPath = '/test/src/b.ts';
+            const extractor = createMockExtractor('extractor', {
+                examples: [example1, example2],
+                claimedFiles: new Set(['/test/examples/a.ts', '/test/src/b.ts']),
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractor],
+                include: ['**/examples/**'],
+            });
+            expect(result.examples).toHaveLength(1);
+            expect(result.examples[0].id).toBe('ex1');
+        });
+    });
+    describe('statistics', () => {
+        it('reports accurate statistics', async () => {
+            const example1 = createMockExample('ex1', 'extractor-a', ['/test/a.ts', '/test/b.ts']);
+            const example2 = createMockExample('ex2', 'extractor-b', ['/test/c.ts']);
+            const extractorA = createMockExtractor('extractor-a', {
+                examples: [example1],
+                claimedFiles: new Set(['/test/a.ts', '/test/b.ts']),
+            });
+            const extractorB = createMockExtractor('extractor-b', {
+                examples: [example2],
+                claimedFiles: new Set(['/test/c.ts']),
+            });
+            const result = await scanExamples({
+                root: '/test',
+                extractors: [extractorA, extractorB],
+            });
+            expect(result.stats.filesClaimed).toBe(3);
+            expect(result.stats.examplesFound).toBe(2);
+            expect(result.stats.conflictsDetected).toBe(0);
+            expect(result.stats.conflictsResolved).toBe(0);
+            expect(result.stats.durationMs).toBeGreaterThanOrEqual(0);
+        });
+    });
+});
+//# sourceMappingURL=scanner.spec.js.map

package/dist/scanner/scanner.spec.js.map

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

package/dist/scanner/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Scanner types for orchestrating extractors
+ */
+import type { ExtractorError, ScannedExample } from '../types/index.js';
+export type { PathMapping } from '../types/index.js';
+/**
+ * Conflict when multiple extractors claim the same file
+ */
+export interface FileConflict {
+    /** The conflicting file path */
+    filePath: string;
+    /** Extractors that claimed this file */
+    claimants: string[];
+    /** How the conflict was resolved (if at all) */
+    resolution?: 'path-mapping' | 'error';
+    /** Winner extractor name (if resolved) */
+    winner?: string;
+}
+/**
+ * Result of scanning for examples
+ */
+export interface ScanResult<TMetadata = Record<string, unknown>> {
+    /** All discovered examples (with computed fields like displayPath) */
+    examples: ScannedExample<TMetadata>[];
+    /** Errors from all extractors */
+    errors: ExtractorError[];
+    /** File conflicts (including resolved ones) */
+    conflicts: FileConflict[];
+    /** Scan statistics */
+    stats: {
+        /** Total files claimed by extractors */
+        filesClaimed: number;
+        /** Total examples found */
+        examplesFound: number;
+        /** Number of conflicts detected */
+        conflictsDetected: number;
+        /** Number of conflicts resolved */
+        conflictsResolved: number;
+        /** Duration in milliseconds */
+        durationMs: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scanner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scanner/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACf,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IACtC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,sEAAsE;IACtE,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;IACtC,iCAAiC;IACjC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,+CAA+C;IAC/C,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,sBAAsB;IACtB,KAAK,EAAE;QACL,wCAAwC;QACxC,YAAY,EAAE,MAAM,CAAC;QACrB,2BAA2B;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,mCAAmC;QACnC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mCAAmC;QACnC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,+BAA+B;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}

package/dist/scanner/types.js

@@ -0,0 +1,5 @@
+/**
+ * Scanner types for orchestrating extractors
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scanner/types.js.map

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