@commercetools/nimbus-docs-build 0.0.0-canary-20251201100514 → 0.0.0-canary-20251201161148

package/dist/parsers/index.d.ts

@@ -5,4 +5,5 @@ export * from "./parse-mdx.js";
 export * from "./parse-types.js";
 export * from "./filter-props.js";
 export * from "./process-types.js";
+export * from "./test-extractor.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/parsers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/parsers/index.js

@@ -5,4 +5,5 @@ export * from "./parse-mdx.js";
 export * from "./parse-types.js";
 export * from "./filter-props.js";
 export * from "./process-types.js";
+export * from "./test-extractor.js";
 //# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/parsers/parse-mdx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-mdx.d.ts","sourceRoot":"","sources":["../../src/parsers/parse-mdx.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,iBAAiB,CAAC;AA8E5D;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA8F7B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAkBnC"}
+{"version":3,"file":"parse-mdx.d.ts","sourceRoot":"","sources":["../../src/parsers/parse-mdx.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,iBAAiB,CAAC;AA6M5D;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAmG7B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAkBnC"}

package/dist/parsers/parse-mdx.js

@@ -12,6 +12,92 @@ import remarkFlexibleToc from "remark-flexible-toc";
 import { mdxDocumentSchema } from "../schemas/mdx-document.js";
 import { menuToPath, getPathFromMonorepoRoot } from "../utils/index.js";
 import { validateFilePath } from "../utils/validate-file-path.js";
+import { extractTestSections } from "./test-extractor.js";
+/**
+ * Resolve the path to a .docs.spec.ts file from an MDX file path
+ * @param mdxFilePath - Absolute path to the MDX file
+ * @param testFileName - Name of the test file from the {{docs-tests:}} token
+ * @returns Absolute path to the test file
+ */
+const resolveTestFilePath = (mdxFilePath, testFileName) => {
+    const mdxDir = path.dirname(mdxFilePath);
+    return path.join(mdxDir, testFileName);
+};
+/**
+ * Generate markdown section from a test section
+ * @param section - Extracted test section
+ * @returns Markdown string with heading, description, and code block
+ */
+const generateMarkdownSection = (section) => {
+    const lines = [];
+    // Add heading
+    lines.push(`### ${section.title}`);
+    lines.push("");
+    // Add description if present
+    if (section.description) {
+        lines.push(section.description);
+        lines.push("");
+    }
+    // Add code block with full, unmodified code
+    lines.push("```tsx");
+    // Add imports (deduplicated)
+    const uniqueImports = Array.from(new Set(section.imports));
+    if (uniqueImports.length > 0) {
+        lines.push(uniqueImports.join("\n"));
+        lines.push("");
+    }
+    // Add test code (unmodified - show exactly what developers write)
+    lines.push(section.code);
+    lines.push("```");
+    lines.push("");
+    return lines.join("\n");
+};
+/**
+ * Inject test sections into MDX content by replacing {{docs-tests:}} tokens
+ * @param mdxContent - MDX content that may contain {{docs-tests:}} tokens
+ * @param mdxFilePath - Absolute path to the MDX file (for resolving test file paths)
+ * @returns MDX content with test sections injected
+ */
+const injectTestSections = async (mdxContent, mdxFilePath) => {
+    // Pattern: {{docs-tests: filename.docs.spec.ts}}
+    const tokenPattern = /\{\{docs-tests:\s*([^}]+)\}\}/g;
+    let result = mdxContent;
+    const matches = mdxContent.matchAll(tokenPattern);
+    for (const match of matches) {
+        const [fullMatch, testFileName] = match;
+        try {
+            // Resolve test file path
+            const testFilePath = resolveTestFilePath(mdxFilePath, testFileName.trim());
+            // Check if test file exists
+            try {
+                await fs.access(testFilePath);
+            }
+            catch {
+                console.warn(`Test file not found: ${testFilePath} (referenced in ${path.basename(mdxFilePath)})`);
+                // Leave token in place if file doesn't exist
+                continue;
+            }
+            // Extract test sections
+            const sections = await extractTestSections(testFilePath);
+            if (sections.length === 0) {
+                console.warn(`No test sections found in ${testFileName} (add @docs-section JSDoc tags)`);
+                // Leave token in place if no sections found
+                continue;
+            }
+            // Generate markdown for all sections
+            const sectionMarkdown = sections
+                .map((section) => generateMarkdownSection(section))
+                .join("\n");
+            // Replace token with generated markdown
+            result = result.replace(fullMatch, sectionMarkdown);
+        }
+        catch (error) {
+            console.error(`Error processing test file ${testFileName}:`, error instanceof Error ? error.message : error);
+            // Leave token in place on error
+        }
+    }
+    return result;
+};
 /**
  * Generate table of contents from MDX content (without frontmatter)
  * @param content - The MDX content string with frontmatter already removed
@@ -62,7 +148,11 @@ const getViewMdxFiles = async (baseMdxPath) => {
 const parseSingleMdx = async (filePath) => {
     try {
         const content = await fs.readFile(filePath, "utf8");
-        const { data: frontmatter, content: mdx } = matter(content);
+        const { data: frontmatter, content: mdxContent } = matter(content);
+        // Inject test sections if {{docs-tests:}} tokens are present
+        const mdx = mdxContent.includes("{{docs-tests:")
+            ? await injectTestSections(mdxContent, filePath)
+            : mdxContent;
         const toc = await generateToc(mdx);
         return { mdx, toc, frontmatter };
     }
@@ -92,7 +182,11 @@ export async function parseMdxFile(filePath) {
         }
         // Read main file content
         const content = await fs.readFile(filePath, "utf8");
-        const { data: meta, content: mdx } = matter(content);
+        const { data: meta, content: mdxContent } = matter(content);
+        // Inject test sections if {{docs-tests:}} tokens are present
+        const mdx = mdxContent.includes("{{docs-tests:")
+            ? await injectTestSections(mdxContent, filePath)
+            : mdxContent;
         // Generate TOC for main file
         const toc = await generateToc(mdx);
         // Get relative path from monorepo root

package/dist/parsers/parse-mdx.js.map

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

package/dist/parsers/test-extractor.d.ts

@@ -0,0 +1,14 @@
+import type { TestSection } from "../types/test-section.js";
+/**
+ * Extracts test sections from a .docs.spec.ts file for documentation injection
+ *
+ * Finds describe() blocks with JSDoc @docs-section tags and extracts:
+ * - Metadata from JSDoc tags
+ * - Full source code of the describe block
+ * - Required imports
+ *
+ * @param testFilePath - Absolute path to the .docs.spec.ts file
+ * @returns Array of test sections sorted by order
+ */
+export declare function extractTestSections(testFilePath: string): Promise<TestSection[]>;
+//# sourceMappingURL=test-extractor.d.ts.map

package/dist/parsers/test-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-extractor.d.ts","sourceRoot":"","sources":["../../src/parsers/test-extractor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CA2DxB"}

package/dist/parsers/test-extractor.js

@@ -0,0 +1,169 @@
+import { readFile } from "node:fs/promises";
+import { parse } from "@typescript-eslint/typescript-estree";
+/**
+ * Extracts test sections from a .docs.spec.ts file for documentation injection
+ *
+ * Finds describe() blocks with JSDoc @docs-section tags and extracts:
+ * - Metadata from JSDoc tags
+ * - Full source code of the describe block
+ * - Required imports
+ *
+ * @param testFilePath - Absolute path to the .docs.spec.ts file
+ * @returns Array of test sections sorted by order
+ */
+export async function extractTestSections(testFilePath) {
+    // Read the test file
+    const sourceCode = await readFile(testFilePath, "utf-8");
+    const lines = sourceCode.split("\n");
+    // Parse TypeScript to AST (with JSX support)
+    const ast = parse(sourceCode, {
+        loc: true,
+        range: true,
+        comment: true,
+        tokens: false,
+        jsx: true, // Enable JSX parsing for .tsx files
+    });
+    // Extract all import statements
+    const imports = extractImports(ast, lines);
+    // Find all describe() blocks with @docs-section tags
+    const sections = [];
+    if (ast.comments) {
+        // Visit all nodes in the AST
+        visit(ast, (node) => {
+            // Find describe() call expressions
+            if (node.type === "ExpressionStatement" &&
+                node.expression.type === "CallExpression" &&
+                node.expression.callee.type === "Identifier" &&
+                node.expression.callee.name === "describe") {
+                // Look for preceding JSDoc comment
+                const comment = findPrecedingComment(node, ast.comments || []);
+                if (comment) {
+                    const metadata = parseJSDocMetadata(comment.value);
+                    // Only include if has @docs-section tag
+                    if (metadata.section) {
+                        const { code, startLine, endLine } = extractCodeBlock(node, lines);
+                        sections.push({
+                            id: metadata.section,
+                            title: metadata.title || metadata.section,
+                            description: metadata.description || "",
+                            order: metadata.order ?? 999,
+                            code,
+                            imports,
+                            sourceFile: testFilePath,
+                            startLine,
+                            endLine,
+                        });
+                    }
+                }
+            }
+        });
+    }
+    // Sort by order
+    return sections.sort((a, b) => a.order - b.order);
+}
+/**
+ * Extract all import statements from the AST
+ */
+function extractImports(ast, lines) {
+    const imports = [];
+    for (const node of ast.body) {
+        if (node.type === "ImportDeclaration" && node.loc) {
+            // Extract the full import statement from source
+            const importLines = lines.slice(node.loc.start.line - 1, node.loc.end.line);
+            imports.push(importLines.join("\n"));
+        }
+    }
+    return imports;
+}
+/**
+ * Find the JSDoc comment immediately preceding a node
+ */
+function findPrecedingComment(node, comments) {
+    if (!node.loc)
+        return null;
+    // Find the last comment that ends before this node starts
+    let precedingComment = null;
+    for (const comment of comments) {
+        if (!comment.loc)
+            continue;
+        // Comment must end before node starts
+        if (comment.loc.end.line < node.loc.start.line) {
+            // Must be a JSDoc comment (block comment starting with **)
+            if (comment.type === "Block" && comment.value.startsWith("*")) {
+                precedingComment = comment;
+            }
+        }
+    }
+    return precedingComment;
+}
+/**
+ * Parse JSDoc tags from a comment
+ */
+function parseJSDocMetadata(commentValue) {
+    const metadata = {};
+    // Remove leading * from each line
+    const lines = commentValue
+        .split("\n")
+        .map((line) => line.trim().replace(/^\*\s?/, ""));
+    for (const line of lines) {
+        // Extract @docs-section
+        const sectionMatch = line.match(/@docs-section\s+(\S+)/);
+        if (sectionMatch) {
+            metadata.section = sectionMatch[1];
+        }
+        // Extract @docs-title
+        const titleMatch = line.match(/@docs-title\s+(.+)/);
+        if (titleMatch) {
+            metadata.title = titleMatch[1].trim();
+        }
+        // Extract @docs-description
+        const descriptionMatch = line.match(/@docs-description\s+(.+)/);
+        if (descriptionMatch) {
+            metadata.description = descriptionMatch[1].trim();
+        }
+        // Extract @docs-order
+        const orderMatch = line.match(/@docs-order\s+(\d+)/);
+        if (orderMatch) {
+            metadata.order = parseInt(orderMatch[1], 10);
+        }
+    }
+    return metadata;
+}
+/**
+ * Extract the full source code of a describe() block
+ */
+function extractCodeBlock(node, lines) {
+    if (!node.loc) {
+        return { code: "", startLine: 0, endLine: 0 };
+    }
+    const startLine = node.loc.start.line;
+    const endLine = node.loc.end.line;
+    // Extract lines (loc is 1-indexed, array is 0-indexed)
+    const codeLines = lines.slice(startLine - 1, endLine);
+    const code = codeLines.join("\n");
+    return { code, startLine, endLine };
+}
+/**
+ * Simple AST visitor helper
+ */
+function visit(node, callback) {
+    callback(node);
+    // Recursively visit all child nodes
+    for (const key of Object.keys(node)) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const value = node[key];
+        if (value && typeof value === "object") {
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    if (item && typeof item === "object" && "type" in item) {
+                        visit(item, callback);
+                    }
+                }
+            }
+            else if ("type" in value) {
+                visit(value, callback);
+            }
+        }
+    }
+}
+//# sourceMappingURL=test-extractor.js.map

package/dist/parsers/test-extractor.js.map

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

package/dist/types/index.d.ts

@@ -3,5 +3,6 @@
  */
 export * from "./mdx.js";
 export * from "./config.js";
+export * from "./test-section.js";
 export type { LifecycleState } from "../schemas/lifecycle-states.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/types/index.js

@@ -3,4 +3,5 @@
  */
 export * from "./mdx.js";
 export * from "./config.js";
+export * from "./test-section.js";
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

package/dist/types/test-section.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Test section extracted from .docs.spec.ts files for documentation injection
+ */
+export interface TestSection {
+    /** Unique identifier for the section (from @docs-section tag) */
+    id: string;
+    /** Display title for the section (from @docs-title tag) */
+    title: string;
+    /** Description explaining what these tests demonstrate (from @docs-description tag) */
+    description: string;
+    /** Sort order for display in documentation (from @docs-order tag) */
+    order: number;
+    /** Full source code of the describe block including tests */
+    code: string;
+    /** Import statements required for this test section */
+    imports: string[];
+    /** Source file path for debugging and error messages */
+    sourceFile: string;
+    /** Line number where this section starts in the source file */
+    startLine: number;
+    /** Line number where this section ends in the source file */
+    endLine: number;
+}
+/**
+ * Parsed JSDoc tags from test describe blocks
+ */
+export interface TestSectionMetadata {
+    /** @docs-section tag value */
+    section?: string;
+    /** @docs-title tag value */
+    title?: string;
+    /** @docs-description tag value */
+    description?: string;
+    /** @docs-order tag value (parsed to number) */
+    order?: number;
+}
+//# sourceMappingURL=test-section.d.ts.map

package/dist/types/test-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-section.d.ts","sourceRoot":"","sources":["../../src/types/test-section.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IAEX,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IAEd,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAC;IAEpB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IAEd,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IAEb,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IAEnB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAElB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/test-section.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-section.js.map

package/dist/types/test-section.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercetools/nimbus-docs-build",
-  "version": "0.0.0-canary-20251201100514",
+  "version": "0.0.0-canary-20251201161148",
   "description": "Documentation build system for Nimbus design system - handles MDX parsing, TypeScript type extraction, and documentation generation",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,6 +20,8 @@
     "README.md"
   ],
   "dependencies": {
+    "@typescript-eslint/types": "^8.48.0",
+    "@typescript-eslint/typescript-estree": "^8.48.0",
     "gray-matter": "^4.0.3",
     "react-docgen-typescript": "^2.4.0",
     "remark": "^15.0.1",