functional-examples 0.0.0-alpha.1

package/dist/extractors/meta-yml.js

@@ -0,0 +1,65 @@
+/**
+ * meta.yml extractor for directory-based examples.
+ *
+ * Expected structure:
+ * ```
+ * examples/
+ *   my-example/
+ *     meta.yml
+ *     main.ts
+ *     helper.ts
+ * ```
+ */
+import YAML from 'yaml';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Extractor for directory-based examples with meta.yml.
+ * Used by isolated-workers pattern.
+ */
+export class MetaYmlExtractor {
+    name = 'meta-yml';
+    canExtract(context) {
+        // Must be a directory with meta.yml
+        return context.isDirectory && (context.entries?.includes('meta.yml') ?? false);
+    }
+    async extract(context) {
+        const metaPath = path.join(context.path, 'meta.yml');
+        const metaContent = await fs.readFile(metaPath, 'utf-8');
+        const parsed = YAML.parse(metaContent);
+        // Generate ID from directory name if not provided
+        const dirName = path.basename(context.path);
+        const metadata = {
+            id: dirName,
+            title: dirName,
+            ...parsed,
+        };
+        // Collect all files except meta.yml and any content file
+        const contentFileName = parsed.contentFile ?? 'content.md';
+        const excludedFiles = new Set(['meta.yml', contentFileName]);
+        const files = [];
+        await this.collectFiles(context.path, context.path, excludedFiles, files);
+        return {
+            metadata,
+            files,
+        };
+    }
+    async collectFiles(rootPath, currentPath, excludedFiles, collected) {
+        const entries = await fs.readdir(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentPath, entry.name);
+            const relativePath = path.relative(rootPath, fullPath);
+            if (entry.isDirectory()) {
+                await this.collectFiles(rootPath, fullPath, excludedFiles, collected);
+            }
+            else if (!excludedFiles.has(entry.name)) {
+                const contents = await fs.readFile(fullPath, 'utf-8');
+                collected.push({
+                    path: relativePath,
+                    contents,
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=meta-yml.js.map

package/dist/extractors/meta-yml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-yml.js","sourceRoot":"","sources":["../../src/extractors/meta-yml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,UAAU,CAAC;IAE3B,UAAU,CAAC,OAA0B;QACnC,oCAAoC;QACpC,OAAO,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA0B;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAA4B,CAAC;QAElE,kDAAkD;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG;YACf,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,OAAO;YACd,GAAG,MAAM;SACV,CAAC;QAEF,yDAAyD;QACzD,MAAM,eAAe,GAAI,MAAmC,CAAC,WAAW,IAAI,YAAY,CAAC;QACzF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;QAE7D,MAAM,KAAK,GAAkB,EAAE,CAAC;QAChC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;QAE1E,OAAO;YACL,QAAQ;YACR,KAAK;SACN,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,QAAgB,EAChB,WAAmB,EACnB,aAA0B,EAC1B,SAAwB;QAExB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAEvD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;YACxE,CAAC;iBAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACtD,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,YAAY;oBAClB,QAAQ;iBACT,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/extractors/registry.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Registry for metadata extractors (function-based with lazy loading)
+ */
+import type { BaseMetadata } from '../types/index.js';
+import type { ExtractionContext, ExtractedMetadata, MetadataExtractorFunction } from './types.js';
+/**
+ * Registry that holds metadata extractors and dispatches extraction requests.
+ * Extractors are tried in registration order; first match wins.
+ */
+export declare class ExtractorRegistry<TMetadata extends BaseMetadata = BaseMetadata> {
+    private entries;
+    private loadedExtractors;
+    /**
+     * Register a new extractor (immediate loading)
+     */
+    register(extractor: MetadataExtractorFunction<TMetadata>): this;
+    /**
+     * Register a lazy extractor reference (loaded on first use)
+     */
+    registerLazy(ref: string | {
+        module: string;
+    }, basePath?: string): this;
+    /**
+     * Get all registered extractors (immediate only)
+     */
+    getExtractors(): readonly MetadataExtractorFunction<TMetadata>[];
+    /**
+     * Find first extractor that can handle given context
+     */
+    findExtractor(context: ExtractionContext): Promise<MetadataExtractorFunction<TMetadata> | undefined>;
+    /**
+     * Extract metadata using first matching extractor
+     */
+    extract(context: ExtractionContext): Promise<ExtractedMetadata<TMetadata>>;
+    /**
+     * Clear module cache (for testing or config reload)
+     */
+    clearCache(): void;
+    /**
+     * Get extractor from entry, loading lazily if needed
+     */
+    private getExtractorForEntry;
+    /**
+     * Check if extractor can handle context
+     */
+    private checkCanExtract;
+    /**
+     * Perform extraction using extractor
+     */
+    private performExtract;
+}
+/**
+ * Create a registry with default extractors:
+ * - MetaYmlExtractor (for directory-based examples with meta.yml)
+ * - YamlFrontmatterExtractor (for single-file examples with YAML frontmatter)
+ */
+export declare function createDefaultRegistry(): ExtractorRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/extractors/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/extractors/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAqBpB;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,SAAS,SAAS,YAAY,GAAG,YAAY;IAC1E,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,gBAAgB,CACZ;IAEZ;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC,SAAS,CAAC,GAAG,IAAI;IAK/D;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvE;;OAEG;IACH,aAAa,IAAI,SAAS,yBAAyB,CAAC,SAAS,CAAC,EAAE;IAYhE;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,yBAAyB,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAW5D;;OAEG;IACG,OAAO,CACX,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAYxC;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;YACW,oBAAoB;IA0BlC;;OAEG;YACW,eAAe;IAc7B;;OAEG;YACW,cAAc;CAM7B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,CAIzD"}

package/dist/extractors/registry.js

@@ -0,0 +1,114 @@
+/**
+ * Registry for metadata extractors (function-based with lazy loading)
+ */
+import { createYamlFrontmatterExtractor } from './yaml-frontmatter-fn.js';
+import { createMetaYmlExtractor } from './meta-yml-fn.js';
+import { loadExtractor, clearCache } from './loader.js';
+/**
+ * Registry that holds metadata extractors and dispatches extraction requests.
+ * Extractors are tried in registration order; first match wins.
+ */
+export class ExtractorRegistry {
+    entries = [];
+    loadedExtractors = new Map();
+    /**
+     * Register a new extractor (immediate loading)
+     */
+    register(extractor) {
+        this.entries.push({ type: 'immediate', extractor });
+        return this;
+    }
+    /**
+     * Register a lazy extractor reference (loaded on first use)
+     */
+    registerLazy(ref, basePath) {
+        this.entries.push({ type: 'lazy', ref, basePath });
+        return this;
+    }
+    /**
+     * Get all registered extractors (immediate only)
+     */
+    getExtractors() {
+        const immediateEntries = this.entries.filter((entry) => entry.type === 'immediate');
+        return immediateEntries.map((e) => e.extractor);
+    }
+    /**
+     * Find first extractor that can handle given context
+     */
+    async findExtractor(context) {
+        for (const entry of this.entries) {
+            const extractor = await this.getExtractorForEntry(entry, context);
+            if (!extractor)
+                continue;
+            const canExtract = await this.checkCanExtract(extractor, context);
+            if (canExtract)
+                return extractor;
+        }
+        return undefined;
+    }
+    /**
+     * Extract metadata using first matching extractor
+     */
+    async extract(context) {
+        const extractor = await this.findExtractor(context);
+        if (!extractor) {
+            throw new Error(`No extractor found for ${context.isDirectory ? 'directory' : 'file'}: ${context.path}`);
+        }
+        return await this.performExtract(extractor, context);
+    }
+    /**
+     * Clear module cache (for testing or config reload)
+     */
+    clearCache() {
+        this.loadedExtractors.clear();
+        clearCache();
+    }
+    /**
+     * Get extractor from entry, loading lazily if needed
+     */
+    async getExtractorForEntry(entry, _context) {
+        if (entry.type === 'immediate') {
+            return entry.extractor;
+        }
+        const cacheKey = typeof entry.ref === 'string' ? entry.ref : entry.ref.module;
+        if (this.loadedExtractors.has(cacheKey)) {
+            return this.loadedExtractors.get(cacheKey);
+        }
+        try {
+            const extractor = (await loadExtractor(entry.ref, entry.basePath || process.cwd()));
+            this.loadedExtractors.set(cacheKey, extractor);
+            return extractor;
+        }
+        catch (error) {
+            return undefined;
+        }
+    }
+    /**
+     * Check if extractor can handle context
+     */
+    async checkCanExtract(extractor, context) {
+        if ('canExtract' in extractor &&
+            typeof extractor.canExtract === 'function') {
+            const result = extractor.canExtract(context);
+            return result instanceof Promise ? await result : result;
+        }
+        return true;
+    }
+    /**
+     * Perform extraction using extractor
+     */
+    async performExtract(extractor, context) {
+        return extractor(context);
+    }
+}
+/**
+ * Create a registry with default extractors:
+ * - MetaYmlExtractor (for directory-based examples with meta.yml)
+ * - YamlFrontmatterExtractor (for single-file examples with YAML frontmatter)
+ */
+export function createDefaultRegistry() {
+    return new ExtractorRegistry()
+        .register(createMetaYmlExtractor())
+        .register(createYamlFrontmatterExtractor());
+}
+//# sourceMappingURL=registry.js.map

package/dist/extractors/registry.js.map

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

package/dist/extractors/registry.spec.d.ts

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

package/dist/extractors/registry.spec.d.ts.map

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

package/dist/extractors/registry.spec.js

@@ -0,0 +1,102 @@
+import { describe, it, expect } from 'vitest';
+import { ExtractorRegistry, createDefaultRegistry } from './registry.js';
+/**
+ * Helper to create a mock extractor for testing
+ */
+function createMockExtractor(name, canExtract, metadata) {
+    const fn = () => Promise.resolve({ metadata, files: [] });
+    fn.name = name;
+    fn.canExtract = () => canExtract;
+    return fn;
+}
+describe('ExtractorRegistry', () => {
+    describe('register', () => {
+        it('allows chaining registrations', () => {
+            const registry = new ExtractorRegistry();
+            const extractor1 = createMockExtractor('test1', false, {
+                id: '1',
+                title: '1',
+            });
+            const extractor2 = createMockExtractor('test2', false, {
+                id: '2',
+                title: '2',
+            });
+            const result = registry.register(extractor1).register(extractor2);
+            expect(result).toBe(registry);
+            expect(registry.getExtractors()).toHaveLength(2);
+        });
+    });
+    describe('findExtractor', () => {
+        it('returns first matching extractor', async () => {
+            const registry = new ExtractorRegistry();
+            const extractor1 = createMockExtractor('never-matches', false, {
+                id: '1',
+                title: '1',
+            });
+            const extractor2 = createMockExtractor('always-matches', true, {
+                id: '2',
+                title: '2',
+            });
+            registry.register(extractor1).register(extractor2);
+            const context = { path: '/test', isDirectory: false };
+            const found = await registry.findExtractor(context);
+            expect(found?.name).toBe('always-matches');
+        });
+        it('returns undefined when no extractor matches', async () => {
+            const registry = new ExtractorRegistry();
+            const extractor = createMockExtractor('never-matches', false, {
+                id: '1',
+                title: '1',
+            });
+            registry.register(extractor);
+            const context = { path: '/test', isDirectory: false };
+            const found = await registry.findExtractor(context);
+            expect(found).toBeUndefined();
+        });
+    });
+    describe('extract', () => {
+        it('uses first matching extractor', async () => {
+            const registry = new ExtractorRegistry();
+            const fn = () => Promise.resolve({
+                metadata: { id: 'test-id', title: 'Test Title' },
+                files: [{ path: 'test.ts', contents: 'code' }],
+            });
+            fn.name = 'test';
+            fn.canExtract = () => true;
+            registry.register(fn);
+            const context = { path: '/test', isDirectory: false };
+            const result = await registry.extract(context);
+            expect(result.metadata.id).toBe('test-id');
+            expect(result.metadata.title).toBe('Test Title');
+        });
+        it('throws when no extractor matches', async () => {
+            const registry = new ExtractorRegistry();
+            const context = { path: '/test', isDirectory: false };
+            await expect(registry.extract(context)).rejects.toThrow('No extractor found for file: /test');
+        });
+        it('throws with directory message for directories', async () => {
+            const registry = new ExtractorRegistry();
+            const context = { path: '/test', isDirectory: true };
+            await expect(registry.extract(context)).rejects.toThrow('No extractor found for directory: /test');
+        });
+    });
+    describe('createDefaultRegistry', () => {
+        it('includes meta-yml extractor', () => {
+            const registry = createDefaultRegistry();
+            const extractors = registry.getExtractors();
+            expect(extractors.some((e) => e.name === 'meta-yml')).toBe(true);
+        });
+        it('includes yaml-frontmatter extractor', () => {
+            const registry = createDefaultRegistry();
+            const extractors = registry.getExtractors();
+            expect(extractors.some((e) => e.name === 'yaml-frontmatter')).toBe(true);
+        });
+        it('prioritizes meta-yml over yaml-frontmatter', () => {
+            const registry = createDefaultRegistry();
+            const extractors = registry.getExtractors();
+            const names = extractors.map((e) => e.name);
+            expect(names.indexOf('meta-yml')).toBeLessThan(names.indexOf('yaml-frontmatter'));
+        });
+    });
+});
+//# sourceMappingURL=registry.spec.js.map

package/dist/extractors/registry.spec.js.map

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

package/dist/extractors/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Types for metadata extraction system (legacy)
+ *
+ * Note: The main extractor types are now in ../types/index.ts.
+ * These types remain for backward compatibility during transition.
+ */
+import type { BaseMetadata, ExampleFile } from '../types/index.js';
+/**
+ * Context provided to extractors for metadata extraction (legacy)
+ * @deprecated Use the new Extractor interface from ../types/index.js
+ */
+export interface ExtractionContext {
+    /** Absolute path to file or directory being examined */
+    path: string;
+    /** Whether this is a directory */
+    isDirectory: boolean;
+    /** File contents (for single-file examples) */
+    content?: string;
+    /** Directory entries (for directory-based examples) */
+    entries?: string[];
+}
+/**
+ * Result of metadata extraction (legacy)
+ * @deprecated Use ExtractorResult from ../types/index.js
+ */
+export interface ExtractedMetadata<TMetadata extends BaseMetadata = BaseMetadata> {
+    /** The extracted metadata */
+    metadata: TMetadata;
+    /** Files belonging to this example */
+    files: ExampleFile[];
+    /** Content with metadata removed (for frontmatter extraction) */
+    strippedContent?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/extractors/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAChC,SAAS,SAAS,YAAY,GAAG,YAAY;IAE7C,6BAA6B;IAC7B,QAAQ,EAAE,SAAS,CAAC;IACpB,sCAAsC;IACtC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/extractors/types.js

@@ -0,0 +1,8 @@
+/**
+ * Types for metadata extraction system (legacy)
+ *
+ * Note: The main extractor types are now in ../types/index.ts.
+ * These types remain for backward compatibility during transition.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extractors/types.js.map

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

package/dist/extractors/yaml-frontmatter-fn.d.ts

@@ -0,0 +1,18 @@
+/**
+ * YAML frontmatter extractor for single-file examples (function-based).
+ *
+ * Supports frontmatter in comment blocks:
+ * ```typescript
+ * // ---
+ * // title: Example Title
+ * // description: What this demonstrates
+ * // ---
+ * ```
+ */
+import type { MetadataExtractorFunction } from './types.js';
+import type { BaseMetadata } from '../types/index.js';
+/**
+ * Extractor for YAML frontmatter in single-file examples.
+ */
+export declare function createYamlFrontmatterExtractor<TMetadata extends BaseMetadata = BaseMetadata>(): MetadataExtractorFunction<TMetadata>;
+//# sourceMappingURL=yaml-frontmatter-fn.d.ts.map

package/dist/extractors/yaml-frontmatter-fn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-frontmatter-fn.d.ts","sourceRoot":"","sources":["../../src/extractors/yaml-frontmatter-fn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOtD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,SAAS,YAAY,GAAG,YAAY,KAC1C,yBAAyB,CAAC,SAAS,CAAC,CA4DxC"}

package/dist/extractors/yaml-frontmatter-fn.js

@@ -0,0 +1,73 @@
+/**
+ * YAML frontmatter extractor for single-file examples (function-based).
+ *
+ * Supports frontmatter in comment blocks:
+ * ```typescript
+ * // ---
+ * // title: Example Title
+ * // description: What this demonstrates
+ * // ---
+ * ```
+ */
+import YAML from 'yaml';
+import path from 'node:path';
+/** Pattern to detect frontmatter start */
+const FRONTMATTER_START = /^\/\/\s*---\s*$/;
+/** Pattern to detect frontmatter end */
+const FRONTMATTER_END = /^\/\/\s*---\s*$/;
+/**
+ * Extractor for YAML frontmatter in single-file examples.
+ */
+export function createYamlFrontmatterExtractor() {
+    const extractor = async (context) => {
+        if (context.isDirectory || !context.content) {
+            return undefined;
+        }
+        const lines = context.content.split('\n');
+        const firstLine = lines[0]?.trimEnd();
+        if (!firstLine || !FRONTMATTER_START.test(firstLine)) {
+            return undefined;
+        }
+        const frontmatterLines = [];
+        let lineIndex = 1;
+        while (lineIndex < lines.length) {
+            const line = lines[lineIndex].trimEnd();
+            if (FRONTMATTER_END.test(line)) {
+                lineIndex++;
+                break;
+            }
+            frontmatterLines.push(line.replace(/^\/\/\s?/, ''));
+            lineIndex++;
+        }
+        const yamlContent = frontmatterLines.join('\n');
+        const parsed = YAML.parse(yamlContent);
+        const filename = path.basename(context.path);
+        const defaultId = filename.replace(/\.[^.]+$/, '').replace(/\//g, '-');
+        const metadata = {
+            id: defaultId,
+            title: defaultId,
+            ...parsed,
+        };
+        const strippedContent = lines.slice(lineIndex).join('\n');
+        return {
+            metadata,
+            files: [
+                {
+                    path: path.basename(context.path),
+                    contents: strippedContent,
+                },
+            ],
+            strippedContent,
+        };
+    };
+    extractor.name = 'yaml-frontmatter';
+    extractor.canExtract = (context) => {
+        if (context.isDirectory || !context.content)
+            return false;
+        const lines = context.content.split('\n');
+        const firstLine = lines[0]?.trimEnd();
+        return FRONTMATTER_START.test(firstLine ?? '');
+    };
+    return extractor;
+}
+//# sourceMappingURL=yaml-frontmatter-fn.js.map

package/dist/extractors/yaml-frontmatter-fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-frontmatter-fn.js","sourceRoot":"","sources":["../../src/extractors/yaml-frontmatter-fn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,0CAA0C;AAC1C,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAC5C,wCAAwC;AACxC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,8BAA8B;IAG5C,MAAM,SAAS,GAAyC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxE,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC5C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC,SAAS,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,gBAAgB,GAAa,EAAE,CAAC;QACtC,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,OAAO,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,SAAS,EAAE,CAAC;gBACZ,MAAM;YACR,CAAC;YACD,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YACpD,SAAS,EAAE,CAAC;QACd,CAAC;QAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAA4B,CAAC;QAElE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAEvE,MAAM,QAAQ,GAAG;YACf,EAAE,EAAE,SAAS;YACb,KAAK,EAAE,SAAS;YAChB,GAAG,MAAM;SACG,CAAC;QAEf,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1D,OAAO;YACL,QAAQ;YACR,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;oBACjC,QAAQ,EAAE,eAAe;iBAC1B;aACF;YACD,eAAe;SAChB,CAAC;IACJ,CAAC,CAAC;IAEF,SAAS,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACpC,SAAS,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,EAAE;QACjC,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QACtC,OAAO,iBAAiB,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/extractors/yaml-frontmatter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * YAML frontmatter extractor for single-file examples.
+ *
+ * Supports frontmatter in comment blocks:
+ * ```typescript
+ * // ---
+ * // title: Example Title
+ * // description: What this demonstrates
+ * // ---
+ * ```
+ */
+import type { MetadataExtractor, ExtractionContext, ExtractedMetadata } from './types.js';
+/**
+ * Extractor for YAML frontmatter in single-file examples.
+ * Used by cli-forge and flexibench patterns.
+ */
+export declare class YamlFrontmatterExtractor implements MetadataExtractor {
+    readonly name = "yaml-frontmatter";
+    canExtract(context: ExtractionContext): boolean;
+    extract(context: ExtractionContext): Promise<ExtractedMetadata>;
+}
+//# sourceMappingURL=yaml-frontmatter.d.ts.map

package/dist/extractors/yaml-frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-frontmatter.d.ts","sourceRoot":"","sources":["../../src/extractors/yaml-frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQ1F;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,sBAAsB;IAEnC,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO;IAYzC,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwDtE"}

package/dist/extractors/yaml-frontmatter.js

@@ -0,0 +1,83 @@
+/**
+ * YAML frontmatter extractor for single-file examples.
+ *
+ * Supports frontmatter in comment blocks:
+ * ```typescript
+ * // ---
+ * // title: Example Title
+ * // description: What this demonstrates
+ * // ---
+ * ```
+ */
+import YAML from 'yaml';
+import path from 'node:path';
+/** Pattern to detect frontmatter start */
+const FRONTMATTER_START = /^\/\/\s*---\s*$/;
+/** Pattern to detect frontmatter end */
+const FRONTMATTER_END = /^\/\/\s*---\s*$/;
+/**
+ * Extractor for YAML frontmatter in single-file examples.
+ * Used by cli-forge and flexibench patterns.
+ */
+export class YamlFrontmatterExtractor {
+    name = 'yaml-frontmatter';
+    canExtract(context) {
+        // Only works on files with content
+        if (context.isDirectory || !context.content) {
+            return false;
+        }
+        // Check if first non-empty line is frontmatter start
+        const lines = context.content.split('\n');
+        const firstLine = lines[0]?.trimEnd();
+        return FRONTMATTER_START.test(firstLine ?? '');
+    }
+    async extract(context) {
+        if (!context.content) {
+            throw new Error('No content provided for frontmatter extraction');
+        }
+        const lines = context.content.split('\n');
+        const frontmatterLines = [];
+        let lineIndex = 0;
+        // Skip the opening ---
+        const firstLine = lines[lineIndex]?.trimEnd();
+        if (!firstLine || !FRONTMATTER_START.test(firstLine)) {
+            throw new Error('Content does not start with frontmatter marker');
+        }
+        lineIndex++;
+        // Collect frontmatter lines until closing ---
+        while (lineIndex < lines.length) {
+            const line = lines[lineIndex].trimEnd();
+            if (FRONTMATTER_END.test(line)) {
+                lineIndex++;
+                break;
+            }
+            // Strip the leading // and optional space
+            frontmatterLines.push(line.replace(/^\/\/\s?/, ''));
+            lineIndex++;
+        }
+        // Parse YAML
+        const yamlContent = frontmatterLines.join('\n');
+        const parsed = YAML.parse(yamlContent);
+        // Generate ID from filename if not provided
+        const filename = path.basename(context.path);
+        const defaultId = filename.replace(/\.[^.]+$/, '').replace(/\//g, '-');
+        const metadata = {
+            id: defaultId,
+            title: defaultId,
+            ...parsed,
+        };
+        // Content after frontmatter
+        const strippedContent = lines.slice(lineIndex).join('\n');
+        return {
+            metadata,
+            files: [
+                {
+                    path: path.basename(context.path),
+                    contents: strippedContent,
+                },
+            ],
+            strippedContent,
+        };
+    }
+}
+//# sourceMappingURL=yaml-frontmatter.js.map

package/dist/extractors/yaml-frontmatter.js.map

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

package/dist/extractors/yaml-frontmatter.spec.d.ts

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

package/dist/extractors/yaml-frontmatter.spec.d.ts.map

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