@functional-examples/javascript 0.0.0-alpha.1

package/dist/extractor.d.ts

@@ -0,0 +1,15 @@
+import type { Extractor } from '@functional-examples/devkit';
+/**
+ * Create a JavaScript/TypeScript extractor.
+ *
+ * This extractor:
+ * - Receives pre-filtered candidates (files and directories)
+ * - For directories with package.json: treats as multi-file package example
+ * - For files with frontmatter: treats as single-file example
+ * - Extracts metadata from package.json or frontmatter
+ * - Loads raw content into ExampleFile
+ * - Respects exclude patterns (default: node_modules, .git, dist, build)
+ * - Tracks claimed files for conflict detection
+ */
+export declare function createJavaScriptExtractor(): Extractor;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../src/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,SAAS,EAIV,MAAM,6BAA6B,CAAC;AAigBrC;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,IAAI,SAAS,CAqPrD"}

package/dist/extractor.js

@@ -0,0 +1,589 @@
+import { createMatcher, glob, parseJson, parseYaml, } from '@functional-examples/devkit';
+import dependencyTree from 'dependency-tree';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+const EXTRACTOR_NAME = 'javascript-extractor';
+/** Default patterns to exclude from file scanning */
+const DEFAULT_EXCLUDE_PATTERNS = [
+    '**/node_modules/**',
+    '**/.git/**',
+    '**/dist/**',
+    '**/build/**',
+];
+/** Default directories to skip when processing directory candidates */
+const DEFAULT_EXCLUDED_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+]);
+/** File extensions to scan for JavaScript/TypeScript examples */
+const FILE_PATTERNS = [
+    '**/*.ts',
+    '**/*.tsx',
+    '**/*.js',
+    '**/*.jsx',
+    '**/*.mjs',
+    '**/*.cjs',
+    '**/*.mts',
+    '**/*.cts',
+];
+/** File extensions this extractor handles */
+const FILE_EXTENSIONS = [
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.mts',
+    '.cts',
+];
+/** Pattern matching line comment frontmatter start: // --- */
+const LINE_COMMENT_START = /^[ \t]*\/\/\s*---\s*$/;
+/** Pattern matching line comment frontmatter end: // --- */
+const LINE_COMMENT_END = /^[ \t]*\/\/\s*---\s*$/;
+/** Pattern matching line comment content: // <content> */
+const LINE_COMMENT_CONTENT = /^[ \t]*\/\/\s?(.*)$/;
+/** Pattern matching block comment frontmatter start: /* --- */
+const BLOCK_COMMENT_START = /^[ \t]*\/\*\s*---\s*$/;
+/** Pattern matching block comment frontmatter end: --- */
+const BLOCK_COMMENT_END = /^[ \t]*---\s*\*\/\s*$/;
+/**
+ * Try to extract line comment style frontmatter from the start of the file.
+ */
+async function extractLineCommentFrontmatter(lines) {
+    if (lines.length < 2)
+        return null;
+    if (!LINE_COMMENT_START.test(lines[0])) {
+        return null;
+    }
+    const yamlLines = [];
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (LINE_COMMENT_END.test(line)) {
+            endIndex = i;
+            break;
+        }
+        const match = line.match(LINE_COMMENT_CONTENT);
+        if (match) {
+            yamlLines.push(match[1]);
+        }
+        else {
+            return null;
+        }
+    }
+    if (endIndex === -1) {
+        return null;
+    }
+    const yamlContent = yamlLines.join('\n');
+    const metadata = yamlContent.trim()
+        ? (await parseYaml(yamlContent)) ?? {}
+        : {};
+    return { metadata };
+}
+/**
+ * Try to extract block comment style frontmatter from the start of the file.
+ */
+async function extractBlockCommentFrontmatter(lines) {
+    if (lines.length < 2)
+        return null;
+    if (!BLOCK_COMMENT_START.test(lines[0])) {
+        return null;
+    }
+    const yamlLines = [];
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (BLOCK_COMMENT_END.test(line)) {
+            endIndex = i;
+            break;
+        }
+        yamlLines.push(line);
+    }
+    if (endIndex === -1) {
+        return null;
+    }
+    const yamlContent = yamlLines.join('\n');
+    const metadata = yamlContent.trim()
+        ? (await parseYaml(yamlContent)) ?? {}
+        : {};
+    return { metadata };
+}
+/**
+ * Extract frontmatter from file content.
+ */
+async function extractFrontmatter(content) {
+    const lines = content.split('\n');
+    const result = (await extractLineCommentFrontmatter(lines)) ??
+        (await extractBlockCommentFrontmatter(lines));
+    if (!result) {
+        return null;
+    }
+    return result.metadata;
+}
+/**
+ * Check if metadata has valid required fields (id and title as strings).
+ */
+function hasValidMetadata(metadata) {
+    return (typeof metadata.id === 'string' &&
+        metadata.id.length > 0 &&
+        typeof metadata.title === 'string' &&
+        metadata.title.length > 0);
+}
+/**
+ * Strip npm scope from package name.
+ * @example "@examples/foo" -> "foo"
+ * @example "my-package" -> "my-package"
+ */
+function stripScope(name) {
+    if (name.startsWith('@')) {
+        const slashIndex = name.indexOf('/');
+        if (slashIndex !== -1) {
+            return name.slice(slashIndex + 1);
+        }
+    }
+    return name;
+}
+/**
+ * Recursively extract all file paths from exports field.
+ * Handles string, object with conditions, and nested export maps.
+ */
+function extractExportPaths(exports) {
+    if (!exports) {
+        return [];
+    }
+    if (typeof exports === 'string') {
+        return [exports];
+    }
+    if (typeof exports === 'object') {
+        const paths = [];
+        for (const value of Object.values(exports)) {
+            paths.push(...extractExportPaths(value));
+        }
+        return paths;
+    }
+    return [];
+}
+/**
+ * Check if a file exists.
+ */
+async function fileExists(filePath) {
+    try {
+        const stat = await fs.stat(filePath);
+        return stat.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read and parse a package.json file.
+ * Returns the parsed package, a parse error, or null if the file can't be read.
+ */
+async function readPackageJson(packageJsonPath) {
+    let content;
+    try {
+        content = await fs.readFile(packageJsonPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    try {
+        return { pkg: (await parseJson(content, packageJsonPath)) };
+    }
+    catch (e) {
+        return {
+            error: `Failed to parse package.json: ${e.message}`,
+        };
+    }
+}
+/**
+ * Strip the functional-examples key from package.json content for output.
+ */
+function stripFunctionalExamplesKey(packageJsonContent) {
+    try {
+        const pkg = JSON.parse(packageJsonContent);
+        delete pkg['functional-examples'];
+        return JSON.stringify(pkg, null, 2);
+    }
+    catch {
+        return packageJsonContent;
+    }
+}
+/**
+ * Use dependency-tree to trace imports from an entry file.
+ * Returns absolute paths of all traced dependencies within the example directory.
+ */
+function traceDependencies(entryPath, exampleDir) {
+    try {
+        const tree = dependencyTree({
+            filename: entryPath,
+            directory: exampleDir,
+            nodeModulesConfig: {
+                // Don't trace into node_modules
+                entry: 'module',
+            },
+        });
+        // Flatten the dependency tree to get all unique file paths
+        // Only include files within the example directory
+        const files = new Set();
+        function collectFiles(node) {
+            if (typeof node === 'string') {
+                // Only add files within the example directory
+                if (node.startsWith(exampleDir) && !node.includes('node_modules')) {
+                    files.add(node);
+                }
+                return;
+            }
+            for (const [filePath, deps] of Object.entries(node)) {
+                // Only add files within the example directory
+                if (filePath &&
+                    typeof filePath === 'string' &&
+                    filePath.startsWith(exampleDir) &&
+                    !filePath.includes('node_modules')) {
+                    files.add(filePath);
+                }
+                if (deps) {
+                    collectFiles(deps);
+                }
+            }
+        }
+        collectFiles(tree);
+        return Array.from(files);
+    }
+    catch {
+        // If dependency tracing fails, just return the entry file
+        return [entryPath];
+    }
+}
+/**
+ * Collect files for a multi-file package example.
+ */
+async function collectPackageFiles(exampleDir, pkg, options) {
+    const collectedFiles = new Set();
+    const packageJsonPath = path.join(exampleDir, 'package.json');
+    // Always include package.json
+    collectedFiles.add(packageJsonPath);
+    // Always include README.md if it exists
+    for (const readmeName of ['README.md', 'README', 'readme.md']) {
+        const readmePath = path.join(exampleDir, readmeName);
+        if (await fileExists(readmePath)) {
+            collectedFiles.add(readmePath);
+            break;
+        }
+    }
+    // Collect entry points to trace
+    const entryPoints = [];
+    // Add main field
+    if (pkg.main) {
+        const mainPath = path.resolve(exampleDir, pkg.main);
+        if (await fileExists(mainPath)) {
+            entryPoints.push(mainPath);
+        }
+    }
+    // Add module field
+    if (pkg.module) {
+        const modulePath = path.resolve(exampleDir, pkg.module);
+        if (await fileExists(modulePath)) {
+            entryPoints.push(modulePath);
+        }
+    }
+    // Add types field
+    if (pkg.types) {
+        const typesPath = path.resolve(exampleDir, pkg.types);
+        if (await fileExists(typesPath)) {
+            entryPoints.push(typesPath);
+        }
+    }
+    // Add exports field paths
+    if (pkg.exports) {
+        const exportPaths = extractExportPaths(pkg.exports);
+        for (const exportPath of exportPaths) {
+            if (exportPath.startsWith('.')) {
+                const resolvedPath = path.resolve(exampleDir, exportPath);
+                if (await fileExists(resolvedPath)) {
+                    entryPoints.push(resolvedPath);
+                }
+            }
+        }
+    }
+    // Trace dependencies from all entry points
+    for (const entryPath of entryPoints) {
+        const tracedFiles = traceDependencies(entryPath, exampleDir);
+        for (const file of tracedFiles) {
+            collectedFiles.add(file);
+        }
+    }
+    // Include files from files array using fast-glob
+    if (pkg.files && pkg.files.length > 0) {
+        try {
+            const excludePatterns = [
+                ...DEFAULT_EXCLUDE_PATTERNS,
+                ...(options.exclude ?? []),
+            ];
+            const filesFromGlob = await glob(pkg.files, {
+                cwd: exampleDir,
+                absolute: true,
+                ignore: excludePatterns,
+                onlyFiles: true,
+            });
+            for (const file of filesFromGlob) {
+                collectedFiles.add(file);
+            }
+        }
+        catch {
+            // Ignore glob errors
+        }
+    }
+    // Check if we have any files besides package.json and README
+    const sourceFiles = Array.from(collectedFiles).filter((f) => !f.endsWith('package.json') && !f.toLowerCase().includes('readme'));
+    if (sourceFiles.length === 0 &&
+        entryPoints.length === 0 &&
+        (!pkg.files || pkg.files.length === 0)) {
+        return {
+            files: [],
+            error: 'No files could be determined for example. Add main, module, exports, or files field to package.json.',
+        };
+    }
+    return { files: Array.from(collectedFiles) };
+}
+/**
+ * Extract metadata from a package.json file per the design doc.
+ */
+function extractPackageMetadata(pkg) {
+    // name field is required
+    if (!pkg.name || typeof pkg.name !== 'string') {
+        return null;
+    }
+    const functionalExamples = pkg['functional-examples'] ?? {};
+    const { title: feTitle, ...restFunctionalExamples } = functionalExamples;
+    // Strip scope from name for id
+    const id = stripScope(pkg.name);
+    // Title: functional-examples.title overrides, fallback to name
+    const title = typeof feTitle === 'string' ? feTitle : id;
+    // Description: direct from package.json
+    const description = typeof pkg.description === 'string' ? pkg.description : undefined;
+    // Tags: from keywords array
+    const tags = Array.isArray(pkg.keywords)
+        ? pkg.keywords.filter((k) => typeof k === 'string')
+        : undefined;
+    // Metadata: spread remaining functional-examples fields
+    const metadata = { ...restFunctionalExamples };
+    return {
+        id,
+        title,
+        description,
+        tags,
+        metadata,
+    };
+}
+/**
+ * Create a JavaScript/TypeScript extractor.
+ *
+ * This extractor:
+ * - Receives pre-filtered candidates (files and directories)
+ * - For directories with package.json: treats as multi-file package example
+ * - For files with frontmatter: treats as single-file example
+ * - Extracts metadata from package.json or frontmatter
+ * - Loads raw content into ExampleFile
+ * - Respects exclude patterns (default: node_modules, .git, dist, build)
+ * - Tracks claimed files for conflict detection
+ */
+export function createJavaScriptExtractor() {
+    async function tryExtractFromFile(absolutePath, rootPath) {
+        let content;
+        try {
+            content = await fs.readFile(absolutePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+        const metadata = await extractFrontmatter(content);
+        if (!metadata || !hasValidMetadata(metadata)) {
+            return null;
+        }
+        const { id, title, description, ...restMetadata } = metadata;
+        const relativePath = path.relative(rootPath, absolutePath);
+        return {
+            id,
+            title,
+            description: typeof description === 'string' ? description : undefined,
+            rootPath: absolutePath,
+            files: [{ absolutePath, relativePath, raw: content }],
+            metadata: restMetadata,
+            extractorName: EXTRACTOR_NAME,
+        };
+    }
+    async function tryExtractFromPackageJson(packageJsonPath, options) {
+        const exampleDir = path.dirname(packageJsonPath);
+        const readResult = await readPackageJson(packageJsonPath);
+        if (!readResult) {
+            return null;
+        }
+        if ('error' in readResult) {
+            return {
+                error: {
+                    path: packageJsonPath,
+                    message: readResult.error,
+                },
+            };
+        }
+        const pkg = readResult.pkg;
+        const extracted = extractPackageMetadata(pkg);
+        if (!extracted) {
+            // No valid name field - not a valid package example
+            return null;
+        }
+        const { id, title, description, tags, metadata } = extracted;
+        // Collect files for this package example
+        const { files: filePaths, error: collectError } = await collectPackageFiles(exampleDir, pkg, options);
+        if (collectError) {
+            return {
+                error: {
+                    path: packageJsonPath,
+                    message: collectError,
+                },
+            };
+        }
+        // Build ExampleFile array
+        const exampleFiles = [];
+        for (const filePath of filePaths) {
+            try {
+                let raw = await fs.readFile(filePath, 'utf-8');
+                // Strip functional-examples key from package.json
+                if (filePath.endsWith('package.json')) {
+                    raw = stripFunctionalExamplesKey(raw);
+                }
+                const relativePath = path.relative(exampleDir, filePath);
+                exampleFiles.push({
+                    absolutePath: filePath,
+                    relativePath,
+                    raw,
+                });
+            }
+            catch {
+                // Skip files that can't be read
+            }
+        }
+        // Include tags in metadata if present
+        const finalMetadata = { ...metadata };
+        if (tags && tags.length > 0) {
+            finalMetadata.tags = tags;
+        }
+        const example = {
+            id,
+            title,
+            description,
+            rootPath: exampleDir,
+            files: exampleFiles,
+            metadata: finalMetadata,
+            extractorName: EXTRACTOR_NAME,
+        };
+        return { example, files: filePaths };
+    }
+    return {
+        name: EXTRACTOR_NAME,
+        async extract(candidates, options) {
+            const examples = [];
+            const claimedFiles = new Set();
+            const errors = [];
+            for (const candidate of candidates) {
+                if (options.signal?.aborted)
+                    break;
+                const fullPath = path.join(candidate.parentPath, candidate.name);
+                // Handle file candidates
+                if (candidate.isFile()) {
+                    // Check if it's a package.json file - resolve to parent directory
+                    if (candidate.name === 'package.json') {
+                        const result = await tryExtractFromPackageJson(fullPath, options);
+                        if (result) {
+                            if ('error' in result) {
+                                errors.push(result.error);
+                            }
+                            else {
+                                examples.push(result.example);
+                                for (const file of result.files) {
+                                    claimedFiles.add(file);
+                                }
+                            }
+                        }
+                        continue;
+                    }
+                    // Handle regular JS/TS files with frontmatter
+                    const ext = path.extname(candidate.name);
+                    if (!FILE_EXTENSIONS.includes(ext))
+                        continue;
+                    const example = await tryExtractFromFile(fullPath, options.rootPath);
+                    if (example) {
+                        examples.push(example);
+                        claimedFiles.add(fullPath);
+                    }
+                    continue;
+                }
+                // Handle directory candidates
+                if (candidate.isDirectory()) {
+                    // Skip excluded directories (default ones)
+                    if (DEFAULT_EXCLUDED_DIRS.has(candidate.name)) {
+                        continue;
+                    }
+                    // Skip directories matching custom exclude patterns
+                    const excludePatterns = options.exclude ?? [];
+                    const relativeDirPath = path.relative(options.rootPath, fullPath);
+                    const pathsToCheck = [
+                        candidate.name,
+                        relativeDirPath,
+                        `${relativeDirPath}/`,
+                        `${candidate.name}/`,
+                    ];
+                    const matchers = await Promise.all(excludePatterns.map((pattern) => createMatcher(pattern)));
+                    const isExcluded = matchers.some((matcher) => {
+                        return pathsToCheck.some((p) => matcher(p));
+                    });
+                    if (isExcluded) {
+                        continue;
+                    }
+                    // Check for package.json in the directory
+                    const packageJsonPath = path.join(fullPath, 'package.json');
+                    if (await fileExists(packageJsonPath)) {
+                        const result = await tryExtractFromPackageJson(packageJsonPath, options);
+                        if (result) {
+                            if ('error' in result) {
+                                errors.push(result.error);
+                            }
+                            else {
+                                examples.push(result.example);
+                                for (const file of result.files) {
+                                    claimedFiles.add(file);
+                                }
+                            }
+                        }
+                        // If package.json was found, don't also scan for single-file examples
+                        continue;
+                    }
+                    // No package.json - fall back to scanning for single-file examples with frontmatter
+                    const fileExcludePatterns = [
+                        ...DEFAULT_EXCLUDE_PATTERNS,
+                        ...(options.exclude ?? []),
+                    ];
+                    const files = await glob(FILE_PATTERNS, {
+                        cwd: fullPath,
+                        absolute: true,
+                        ignore: fileExcludePatterns,
+                        onlyFiles: true,
+                    });
+                    for (const filePath of files) {
+                        const example = await tryExtractFromFile(filePath, options.rootPath);
+                        if (example) {
+                            examples.push(example);
+                            claimedFiles.add(filePath);
+                        }
+                    }
+                }
+            }
+            return { examples, errors, claimedFiles };
+        },
+    };
+}
+//# sourceMappingURL=extractor.js.map

package/dist/extractor.js.map

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

package/dist/frontmatter.d.ts

@@ -0,0 +1,21 @@
+import { type FileContentsParser } from '@functional-examples/devkit';
+/**
+ * Create a FileContentsParser that extracts YAML frontmatter from JavaScript/TypeScript files.
+ *
+ * Supports two formats:
+ * 1. Line comment style:
+ *    // ---
+ *    // title: Example
+ *    // ---
+ *
+ * 2. Block comment wrapped style:
+ *    /* ---
+ *    title: Example
+ *    --- *\/
+ *
+ * Frontmatter must be at the very start of the file (line 1).
+ * Extracted metadata is merged into context.metadata.
+ * The frontmatter block is stripped from context.parsed.
+ */
+export declare function createFrontmatterParser(): FileContentsParser;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,6BAA6B,CAAC;AA+HrC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,IAAI,kBAAkB,CAkC5D"}

package/dist/frontmatter.js

@@ -0,0 +1,145 @@
+import { parseYaml, } from '@functional-examples/devkit';
+/** Pattern matching line comment frontmatter start: // --- */
+const LINE_COMMENT_START = /^[ \t]*\/\/\s*---\s*$/;
+/** Pattern matching line comment frontmatter end: // --- */
+const LINE_COMMENT_END = /^[ \t]*\/\/\s*---\s*$/;
+/** Pattern matching line comment content: // <content> */
+const LINE_COMMENT_CONTENT = /^[ \t]*\/\/\s?(.*)$/;
+/** Pattern matching block comment frontmatter start: /* --- */
+const BLOCK_COMMENT_START = /^[ \t]*\/\*\s*---\s*$/;
+/** Pattern matching block comment frontmatter end: --- */
+const BLOCK_COMMENT_END = /^[ \t]*---\s*\*\/\s*$/;
+/**
+ * Try to extract line comment style frontmatter from the start of the file.
+ * Format:
+ * // ---
+ * // key: value
+ * // ---
+ */
+async function extractLineCommentFrontmatter(lines) {
+    if (lines.length < 2)
+        return null;
+    // First line must be // ---
+    if (!LINE_COMMENT_START.test(lines[0])) {
+        return null;
+    }
+    // Find closing delimiter
+    const yamlLines = [];
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        // Check for closing delimiter
+        if (LINE_COMMENT_END.test(line)) {
+            endIndex = i;
+            break;
+        }
+        // Extract content from line comment
+        const match = line.match(LINE_COMMENT_CONTENT);
+        if (match) {
+            yamlLines.push(match[1]);
+        }
+        else {
+            // Non-comment line before closing delimiter - invalid frontmatter
+            return null;
+        }
+    }
+    if (endIndex === -1) {
+        // No closing delimiter found
+        return null;
+    }
+    const yamlContent = yamlLines.join('\n');
+    const metadata = yamlContent.trim()
+        ? (await parseYaml(yamlContent)) ?? {}
+        : {};
+    return {
+        metadata,
+        linesConsumed: endIndex + 1,
+    };
+}
+/**
+ * Try to extract block comment style frontmatter from the start of the file.
+ * Format:
+ * /* ---
+ * key: value
+ * --- *\/
+ */
+async function extractBlockCommentFrontmatter(lines) {
+    if (lines.length < 2)
+        return null;
+    // First line must be /* ---
+    if (!BLOCK_COMMENT_START.test(lines[0])) {
+        return null;
+    }
+    // Find closing delimiter
+    const yamlLines = [];
+    let endIndex = -1;
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        // Check for closing delimiter
+        if (BLOCK_COMMENT_END.test(line)) {
+            endIndex = i;
+            break;
+        }
+        // Content lines are raw YAML (no prefix stripping needed)
+        yamlLines.push(line);
+    }
+    if (endIndex === -1) {
+        // No closing delimiter found
+        return null;
+    }
+    const yamlContent = yamlLines.join('\n');
+    const metadata = yamlContent.trim()
+        ? (await parseYaml(yamlContent)) ?? {}
+        : {};
+    return {
+        metadata,
+        linesConsumed: endIndex + 1,
+    };
+}
+/**
+ * Create a FileContentsParser that extracts YAML frontmatter from JavaScript/TypeScript files.
+ *
+ * Supports two formats:
+ * 1. Line comment style:
+ *    // ---
+ *    // title: Example
+ *    // ---
+ *
+ * 2. Block comment wrapped style:
+ *    /* ---
+ *    title: Example
+ *    --- *\/
+ *
+ * Frontmatter must be at the very start of the file (line 1).
+ * Extracted metadata is merged into context.metadata.
+ * The frontmatter block is stripped from context.parsed.
+ */
+export function createFrontmatterParser() {
+    return {
+        name: 'javascript-frontmatter-parser',
+        async parse(context) {
+            const lines = context.parsed.split('\n');
+            // Try line comment style first, then block comment style
+            const result = (await extractLineCommentFrontmatter(lines)) ??
+                (await extractBlockCommentFrontmatter(lines));
+            if (!result) {
+                // No frontmatter found, return context unchanged
+                return context;
+            }
+            // Strip frontmatter lines from parsed content
+            const remainingLines = lines.slice(result.linesConsumed);
+            const parsed = remainingLines.join('\n');
+            // Merge extracted metadata with existing metadata
+            const metadata = {
+                ...context.metadata,
+                ...result.metadata,
+            };
+            return {
+                ...context,
+                parsed,
+                metadata,
+            };
+        },
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import type { Plugin } from '@functional-examples/devkit';
+export declare const JAVASCRIPT_EXTENSIONS: readonly [".js", ".jsx", ".mjs", ".cjs", ".ts", ".tsx", ".mts", ".cts"];
+export { createJavaScriptParser } from './parser.js';
+export { createFrontmatterParser } from './frontmatter.js';
+export { createJavaScriptExtractor } from './extractor.js';
+/**
+ * Options for the JavaScript plugin.
+ */
+export interface JavaScriptPluginOptions {
+    /** Skip frontmatter extraction (default: false) */
+    skipFrontmatter?: boolean;
+    /** Skip region extraction (default: false) */
+    skipRegions?: boolean;
+}
+/**
+ * Create a JavaScript/TypeScript plugin for functional-examples.
+ *
+ * This plugin:
+ * - Handles .js, .jsx, .mjs, .cjs, .ts, .tsx, .mts, .cts files
+ * - Extracts YAML frontmatter from line/block comments
+ * - Extracts code regions from #region/#endregion markers
+ * - Provides a single-file extractor for discovering examples
+ *
+ * The combined parser runs frontmatter parsing FIRST, then region parsing.
+ * This ensures frontmatter is stripped before region markers are processed.
+ *
+ * @param options - Optional plugin configuration
+ * @returns A configured JavaScript plugin
+ */
+export declare function createJavaScriptPlugin(options?: JavaScriptPluginOptions): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAIP,MAAM,6BAA6B,CAAC;AAKrC,eAAO,MAAM,qBAAqB,yEASxB,CAAC;AAEX,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA6DD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,uBAAuB,GAChC,MAAM,CAsCR"}

package/dist/index.js

@@ -0,0 +1,120 @@
+import { createJavaScriptParser } from './parser.js';
+import { createFrontmatterParser } from './frontmatter.js';
+import { createJavaScriptExtractor } from './extractor.js';
+export const JAVASCRIPT_EXTENSIONS = [
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.ts',
+    '.tsx',
+    '.mts',
+    '.cts',
+];
+export { createJavaScriptParser } from './parser.js';
+export { createFrontmatterParser } from './frontmatter.js';
+export { createJavaScriptExtractor } from './extractor.js';
+/**
+ * JSON Schema for JavaScript plugin options.
+ */
+const OPTIONS_SCHEMA = JSON.stringify({
+    type: 'object',
+    properties: {
+        skipFrontmatter: {
+            type: 'boolean',
+            description: 'Skip frontmatter parsing',
+        },
+        skipRegions: {
+            type: 'boolean',
+            description: 'Skip region parsing',
+        },
+    },
+});
+/**
+ * JSON Schema for metadata this plugin expects.
+ */
+const METADATA_SCHEMA = JSON.stringify({
+    type: 'object',
+    properties: {
+        id: {
+            type: 'string',
+            description: 'Unique example identifier',
+        },
+        title: {
+            type: 'string',
+            description: 'Example title',
+        },
+        description: {
+            type: 'string',
+            description: 'Example description',
+        },
+    },
+    required: ['id', 'title'],
+});
+/**
+ * Validate metadata extracted by this plugin.
+ * Note: id and title are validated by the extractor and are top-level example fields,
+ * not part of the metadata object passed here.
+ */
+function validateMetadata(metadata) {
+    const errors = [];
+    // Validate tags array if present
+    if (metadata.tags !== undefined) {
+        if (!Array.isArray(metadata.tags)) {
+            errors.push({ path: 'tags', message: 'must be an array' });
+        }
+        else if (!metadata.tags.every((t) => typeof t === 'string')) {
+            errors.push({ path: 'tags', message: 'must be an array of strings' });
+        }
+    }
+    return { success: errors.length === 0, errors };
+}
+/**
+ * Create a JavaScript/TypeScript plugin for functional-examples.
+ *
+ * This plugin:
+ * - Handles .js, .jsx, .mjs, .cjs, .ts, .tsx, .mts, .cts files
+ * - Extracts YAML frontmatter from line/block comments
+ * - Extracts code regions from #region/#endregion markers
+ * - Provides a single-file extractor for discovering examples
+ *
+ * The combined parser runs frontmatter parsing FIRST, then region parsing.
+ * This ensures frontmatter is stripped before region markers are processed.
+ *
+ * @param options - Optional plugin configuration
+ * @returns A configured JavaScript plugin
+ */
+export function createJavaScriptPlugin(options) {
+    const { skipFrontmatter = false, skipRegions = false } = options ?? {};
+    // Create a combined parser that chains frontmatter → regions
+    const combinedParser = {
+        name: 'javascript-combined-parser',
+        async parse(context) {
+            let result = context;
+            // Run frontmatter parser first (extracts metadata, strips frontmatter)
+            if (!skipFrontmatter) {
+                result = await createFrontmatterParser().parse(result);
+            }
+            // Run region parser second (extracts hunks, strips markers)
+            if (!skipRegions) {
+                result = createJavaScriptParser().parse(result);
+            }
+            return result;
+        },
+    };
+    return {
+        name: 'javascript',
+        extensions: [...JAVASCRIPT_EXTENSIONS],
+        extractor: createJavaScriptExtractor(),
+        fileContentsParser: combinedParser,
+        schemas: {
+            options: OPTIONS_SCHEMA,
+            metadata: METADATA_SCHEMA,
+        },
+        validators: {
+            metadata: validateMetadata,
+        },
+        _options: options,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,7 @@
+import type { FileContentsParser } from '@functional-examples/devkit';
+/**
+ * Create a FileContentsParser for JavaScript/TypeScript files.
+ * Handles region extraction and marker stripping.
+ */
+export declare function createJavaScriptParser(): FileContentsParser;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,6BAA6B,CAAC;AAcrC;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,CA2D3D"}

package/dist/parser.js

@@ -0,0 +1,59 @@
+const LINE_COMMENT_REGION = /^[ \t]*\/\/\s*#region\s+(\S+)\s*$/;
+const LINE_COMMENT_ENDREGION = /^[ \t]*\/\/\s*#endregion(?:\s+(\S+))?\s*$/;
+const BLOCK_COMMENT_REGION = /^[ \t]*\/\*\s*#region\s+(\S+)\s*\*\/\s*$/;
+const BLOCK_COMMENT_ENDREGION = /^[ \t]*\/\*\s*#endregion(?:\s+(\S+))?\s*\*\/\s*$/;
+/**
+ * Create a FileContentsParser for JavaScript/TypeScript files.
+ * Handles region extraction and marker stripping.
+ */
+export function createJavaScriptParser() {
+    return {
+        name: 'javascript-parser',
+        parse(context) {
+            const lines = context.parsed.split('\n');
+            const hunks = [];
+            const outputLines = [];
+            const regionStack = [];
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                const lineNum = i + 1;
+                // Check for region start
+                const startMatch = line.match(LINE_COMMENT_REGION) || line.match(BLOCK_COMMENT_REGION);
+                if (startMatch) {
+                    regionStack.push({
+                        id: startMatch[1],
+                        startLine: lineNum,
+                        lines: [],
+                    });
+                    continue; // Don't include marker in output
+                }
+                // Check for region end
+                const endMatch = line.match(LINE_COMMENT_ENDREGION) ||
+                    line.match(BLOCK_COMMENT_ENDREGION);
+                if (endMatch) {
+                    const current = regionStack.pop();
+                    if (current) {
+                        hunks.push({
+                            id: current.id,
+                            content: current.lines.join('\n'),
+                            startLine: current.startLine,
+                            endLine: lineNum,
+                        });
+                    }
+                    continue; // Don't include marker in output
+                }
+                // Regular line - add to output and any active regions
+                outputLines.push(line);
+                for (const region of regionStack) {
+                    region.lines.push(line);
+                }
+            }
+            return {
+                ...context,
+                parsed: outputLines.join('\n'),
+                hunks,
+            };
+        },
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAMA,MAAM,mBAAmB,GAAG,mCAAmC,CAAC;AAChE,MAAM,sBAAsB,GAAG,2CAA2C,CAAC;AAC3E,MAAM,oBAAoB,GAAG,0CAA0C,CAAC;AACxE,MAAM,uBAAuB,GAC3B,kDAAkD,CAAC;AAQrD;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,IAAI,EAAE,mBAAmB;QAEzB,KAAK,CAAC,OAAyB;YAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,KAAK,GAAmB,EAAE,CAAC;YACjC,MAAM,WAAW,GAAa,EAAE,CAAC;YACjC,MAAM,WAAW,GAAkB,EAAE,CAAC;YAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;gBAEtB,yBAAyB;gBACzB,MAAM,UAAU,GACd,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;gBAEtE,IAAI,UAAU,EAAE,CAAC;oBACf,WAAW,CAAC,IAAI,CAAC;wBACf,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;wBACjB,SAAS,EAAE,OAAO;wBAClB,KAAK,EAAE,EAAE;qBACV,CAAC,CAAC;oBACH,SAAS,CAAC,iCAAiC;gBAC7C,CAAC;gBAED,uBAAuB;gBACvB,MAAM,QAAQ,GACZ,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC;oBAClC,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBAEtC,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;oBAClC,IAAI,OAAO,EAAE,CAAC;wBACZ,KAAK,CAAC,IAAI,CAAC;4BACT,EAAE,EAAE,OAAO,CAAC,EAAE;4BACd,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;4BACjC,SAAS,EAAE,OAAO,CAAC,SAAS;4BAC5B,OAAO,EAAE,OAAO;yBACjB,CAAC,CAAC;oBACL,CAAC;oBACD,SAAS,CAAC,iCAAiC;gBAC7C,CAAC;gBAED,sDAAsD;gBACtD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvB,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;oBACjC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YAED,OAAO;gBACL,GAAG,OAAO;gBACV,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC9B,KAAK;aACN,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@functional-examples/javascript",
+  "version": "0.0.0-alpha.1",
+  "description": "JavaScript/TypeScript plugin for functional-examples",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "vitest": "^1.3.1",
+    "@functional-examples/devkit": "0.0.0-alpha.1"
+  },
+  "dependencies": {
+    "dependency-tree": "^11.0.0",
+    "picomatch": "^4.0.3",
+    "tinyglobby": "^0.2.15",
+    "yaml": "^2.7.1",
+    "@functional-examples/devkit": "0.0.0-alpha.1"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Craigory Coppola",
+    "url": "https://craigory.dev"
+  },
+  "homepage": "https://craigory.dev/functional-examples",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentEnder/functional-examples.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AgentEnder/functional-examples/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.lib.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}