@commercetools/nimbus-docs-build 0.0.0-canary-20251107124701

package/dist/utils/file-utils.js

@@ -0,0 +1,111 @@
+/**
+ * File system utility functions
+ */
+import fs from "fs/promises";
+import path from "path";
+/**
+ * Recursively find the monorepo root by checking for "workspaces" in package.json.
+ * @param dir The starting directory to search from.
+ * @returns The absolute path to the monorepo root or null if not found.
+ */
+export async function findMonorepoRoot(dir) {
+    const packageJsonPath = path.join(dir, "package.json");
+    try {
+        const packageJsonContent = await fs.readFile(packageJsonPath, "utf8");
+        const packageJson = JSON.parse(packageJsonContent);
+        if (packageJson.workspaces) {
+            return dir;
+        }
+    }
+    catch {
+        // Ignore errors (e.g., file not found or invalid JSON) and continue
+    }
+    const parentDir = path.dirname(dir);
+    if (parentDir === dir) {
+        // Reached the filesystem root
+        return null;
+    }
+    return findMonorepoRoot(parentDir);
+}
+/**
+ * Get the relative path from the monorepo root to the specified file path.
+ * @param filePath The file path to calculate the relative path for.
+ * @returns The relative path from the monorepo root to the file path.
+ * @throws If the monorepo root cannot be found.
+ */
+export async function getPathFromMonorepoRoot(filePath) {
+    const absoluteFilePath = path.resolve(filePath);
+    const startingDir = path.dirname(absoluteFilePath);
+    const monorepoRoot = await findMonorepoRoot(startingDir);
+    if (!monorepoRoot) {
+        throw new Error('Monorepo root not found. Ensure a package.json with a "workspaces" property exists.');
+    }
+    return path.relative(monorepoRoot, absoluteFilePath);
+}
+/**
+ * Find all files with a specific extension recursively
+ * @param dir Directory to search
+ * @param extension File extension to match (e.g., ".mdx")
+ * @returns Array of file paths
+ */
+export async function findFiles(dir, extension) {
+    const files = [];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip node_modules and dist
+                if (entry.name === "node_modules" || entry.name === "dist") {
+                    continue;
+                }
+                const subFiles = await findFiles(fullPath, extension);
+                files.push(...subFiles);
+            }
+            else if (entry.isFile()) {
+                if (path.extname(entry.name).toLowerCase() === extension.toLowerCase()) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore permission errors
+    }
+    return files;
+}
+/**
+ * Find all files matching multiple extensions
+ * @param dir Directory to search
+ * @param extensions Array of extensions to match
+ * @returns Array of file paths
+ */
+export async function findFilesByExtensions(dir, extensions) {
+    const files = [];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip node_modules and dist directories
+                if (entry.name === "node_modules" || entry.name === "dist") {
+                    continue;
+                }
+                // Recursively search subdirectories
+                const subFiles = await findFilesByExtensions(fullPath, extensions);
+                files.push(...subFiles);
+            }
+            else if (entry.isFile()) {
+                const ext = path.extname(entry.name).toLowerCase();
+                if (extensions.includes(ext)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore permission errors, etc.
+    }
+    return files;
+}
+//# sourceMappingURL=file-utils.js.map

package/dist/utils/file-utils.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility function exports
+ */
+export * from "./logger.js";
+export * from "./sluggify.js";
+export * from "./file-utils.js";
+export * from "./validate-file-path.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * Utility function exports
+ */
+export * from "./logger.js";
+export * from "./sluggify.js";
+export * from "./file-utils.js";
+export * from "./validate-file-path.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Simple logging utilities with colored output
+ */
+export declare const flog: (str: string) => void;
+export declare const errorLog: (str: string) => void;
+export declare const warnLog: (str: string) => void;
+export declare const successLog: (str: string) => void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,IAAI,GAAI,KAAK,MAAM,SAE/B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,SAEnC,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,SAElC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,SAErC,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,16 @@
+/**
+ * Simple logging utilities with colored output
+ */
+export const flog = (str) => {
+    console.log("\x1b[32m%s\x1b[0m", `\n  ➜ ${str}\n`);
+};
+export const errorLog = (str) => {
+    console.error("\x1b[31m%s\x1b[0m", `\n  ✗ ${str}\n`);
+};
+export const warnLog = (str) => {
+    console.warn("\x1b[33m%s\x1b[0m", `\n  ⚠ ${str}\n`);
+};
+export const successLog = (str) => {
+    console.log("\x1b[32m%s\x1b[0m", `\n  ✓ ${str}\n`);
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;IAClC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE;IACtC,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE;IACrC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE;IACxC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/utils/sluggify.d.ts

@@ -0,0 +1,17 @@
+/**
+ * String to URL slug conversion utilities
+ */
+/**
+ * Create a URL-compatible slug from a string
+ * Simple implementation to avoid dependency on 'slug' package
+ * @param str - The string to be converted to a slug
+ * @returns The slugified string
+ */
+export declare const sluggify: (str: string) => string;
+/**
+ * Transforms a menu from an mdx-file's frontmatter to a path
+ * @param menu - The menu array from the frontmatter
+ * @returns The path created by joining the slugified menu items
+ */
+export declare const menuToPath: (menu: string[]) => string;
+//# sourceMappingURL=sluggify.d.ts.map

package/dist/utils/sluggify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sluggify.d.ts","sourceRoot":"","sources":["../../src/utils/sluggify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG,MAOtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,KAAG,MAE3C,CAAC"}

package/dist/utils/sluggify.js

@@ -0,0 +1,26 @@
+/**
+ * String to URL slug conversion utilities
+ */
+/**
+ * Create a URL-compatible slug from a string
+ * Simple implementation to avoid dependency on 'slug' package
+ * @param str - The string to be converted to a slug
+ * @returns The slugified string
+ */
+export const sluggify = (str) => {
+    return str
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, "") // Remove special characters
+        .replace(/[\s_-]+/g, "-") // Replace spaces, underscores with single dash
+        .replace(/^-+|-+$/g, ""); // Remove leading/trailing dashes
+};
+/**
+ * Transforms a menu from an mdx-file's frontmatter to a path
+ * @param menu - The menu array from the frontmatter
+ * @returns The path created by joining the slugified menu items
+ */
+export const menuToPath = (menu) => {
+    return menu.map((item) => sluggify(item)).join("/");
+};
+//# sourceMappingURL=sluggify.js.map

package/dist/utils/sluggify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sluggify.js","sourceRoot":"","sources":["../../src/utils/sluggify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE;IAC9C,OAAO,GAAG;SACP,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,4BAA4B;SACrD,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,+CAA+C;SACxE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,iCAAiC;AAC/D,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAc,EAAU,EAAE;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9D,CAAC,CAAC"}

package/dist/utils/validate-file-path.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Validates that a file path doesn't escape from the base directory.
+ * Prevents path traversal attacks by ensuring the resolved path
+ * stays within the intended base directory.
+ *
+ * @param baseDir - The base directory that the path must remain within
+ * @param pathSegments - Path segments to join and validate
+ * @returns The validated absolute path
+ * @throws Error if path traversal is detected
+ *
+ * @example
+ * ```typescript
+ * // Valid path
+ * validateFilePath('/app/routes', 'component-button.json')
+ * // Returns: '/app/routes/component-button.json'
+ *
+ * // Invalid path (traversal attempt)
+ * validateFilePath('/app/routes', '../../../etc/passwd')
+ * // Throws: Error('Invalid file path: ../../../etc/passwd (traversal detected)')
+ * ```
+ */
+export declare function validateFilePath(baseDir: string, ...pathSegments: string[]): string;
+//# sourceMappingURL=validate-file-path.d.ts.map

package/dist/utils/validate-file-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-file-path.d.ts","sourceRoot":"","sources":["../../src/utils/validate-file-path.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,GAAG,YAAY,EAAE,MAAM,EAAE,GACxB,MAAM,CAwBR"}

package/dist/utils/validate-file-path.js

@@ -0,0 +1,39 @@
+import path from "path";
+/**
+ * Validates that a file path doesn't escape from the base directory.
+ * Prevents path traversal attacks by ensuring the resolved path
+ * stays within the intended base directory.
+ *
+ * @param baseDir - The base directory that the path must remain within
+ * @param pathSegments - Path segments to join and validate
+ * @returns The validated absolute path
+ * @throws Error if path traversal is detected
+ *
+ * @example
+ * ```typescript
+ * // Valid path
+ * validateFilePath('/app/routes', 'component-button.json')
+ * // Returns: '/app/routes/component-button.json'
+ *
+ * // Invalid path (traversal attempt)
+ * validateFilePath('/app/routes', '../../../etc/passwd')
+ * // Throws: Error('Invalid file path: ../../../etc/passwd (traversal detected)')
+ * ```
+ */
+export function validateFilePath(baseDir, ...pathSegments) {
+    // Join all path segments
+    const joined = path.join(...pathSegments);
+    // Normalize to resolve any '..' sequences
+    const normalized = path.normalize(joined);
+    // Resolve to absolute path relative to base directory
+    const resolved = path.resolve(baseDir, normalized);
+    // Get absolute base directory path
+    const absoluteBase = path.resolve(baseDir);
+    // Ensure the resolved path starts with the base directory
+    if (!resolved.startsWith(absoluteBase + path.sep) &&
+        resolved !== absoluteBase) {
+        throw new Error(`Invalid file path: attempted to access '${joined}' outside base directory '${baseDir}'`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=validate-file-path.js.map

package/dist/utils/validate-file-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-file-path.js","sourceRoot":"","sources":["../../src/utils/validate-file-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,GAAG,YAAsB;IAEzB,yBAAyB;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;IAE1C,0CAA0C;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAE1C,sDAAsD;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEnD,mCAAmC;IACnC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3C,0DAA0D;IAC1D,IACE,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC;QAC7C,QAAQ,KAAK,YAAY,EACzB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,2CAA2C,MAAM,6BAA6B,OAAO,GAAG,CACzF,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/validation/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validation exports
+ */
+export * from "./validate-content.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,uBAAuB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,5 @@
+/**
+ * Validation exports
+ */
+export * from "./validate-content.js";
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,uBAAuB,CAAC"}

package/dist/validation/validate-content.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Content Validation
+ *
+ * Validates documentation content for common issues
+ */
+import type { MdxDocument } from "../types/mdx.js";
+import type { ValidationError } from "../types/config.js";
+/**
+ * Validate all documentation content
+ */
+export declare function validateContent(docs: Map<string, MdxDocument>): ValidationError[];
+//# sourceMappingURL=validate-content.d.ts.map

package/dist/validation/validate-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-content.d.ts","sourceRoot":"","sources":["../../src/validation/validate-content.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAC7B,eAAe,EAAE,CAuGnB"}

package/dist/validation/validate-content.js

@@ -0,0 +1,95 @@
+import { flog } from "../utils/logger.js";
+/**
+ * Validate all documentation content
+ */
+export function validateContent(docs) {
+    const errors = [];
+    for (const [filePath, doc] of docs) {
+        // Validate required frontmatter fields
+        if (!doc.meta.id) {
+            errors.push({
+                file: filePath,
+                message: "Missing required field: id",
+                severity: "error",
+            });
+        }
+        if (!doc.meta.title) {
+            errors.push({
+                file: filePath,
+                message: "Missing required field: title",
+                severity: "error",
+            });
+        }
+        // Warn about missing description
+        if (!doc.meta.description) {
+            errors.push({
+                file: filePath,
+                message: "Missing recommended field: description",
+                severity: "warning",
+            });
+        }
+        // Warn about missing tags
+        if (!doc.meta.tags || doc.meta.tags.length === 0) {
+            errors.push({
+                file: filePath,
+                message: "Missing recommended field: tags",
+                severity: "warning",
+            });
+        }
+        // Validate menu structure
+        if (!doc.meta.menu || doc.meta.menu.length === 0) {
+            errors.push({
+                file: filePath,
+                message: "Missing or empty menu array",
+                severity: "error",
+            });
+        }
+        // Check for empty content
+        if (!doc.mdx || doc.mdx.trim().length === 0) {
+            errors.push({
+                file: filePath,
+                message: "Document has no content",
+                severity: "error",
+            });
+        }
+        // Check for broken internal links (basic check)
+        const internalLinkPattern = /\[.*?\]\(\/[^)]+\)/g;
+        const matches = doc.mdx.match(internalLinkPattern);
+        if (matches) {
+            for (const match of matches) {
+                // Extract path
+                const path = match.match(/\((\/[^)]+)\)/)?.[1];
+                if (path &&
+                    !path.startsWith("/images/") &&
+                    !path.startsWith("/public/")) {
+                    // This is an internal doc link - could validate it exists
+                    // For now, just log it as info
+                }
+            }
+        }
+    }
+    // Report validation results
+    const errorCount = errors.filter((e) => e.severity === "error").length;
+    const warningCount = errors.filter((e) => e.severity === "warning").length;
+    if (errorCount > 0) {
+        console.error(`\n❌ Found ${errorCount} validation errors:`);
+        errors
+            .filter((e) => e.severity === "error")
+            .forEach((err) => {
+            console.error(`  ${err.file}: ${err.message}`);
+        });
+    }
+    if (warningCount > 0) {
+        console.warn(`\n⚠️  Found ${warningCount} validation warnings:`);
+        errors
+            .filter((e) => e.severity === "warning")
+            .forEach((err) => {
+            console.warn(`  ${err.file}: ${err.message}`);
+        });
+    }
+    if (errors.length === 0) {
+        flog("[Validation] All content valid ✓");
+    }
+    return errors;
+}
+//# sourceMappingURL=validate-content.js.map

package/dist/validation/validate-content.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@commercetools/nimbus-docs-build",
+  "version": "0.0.0-canary-20251107124701",
+  "description": "Documentation build system for Nimbus design system - handles MDX parsing, TypeScript type extraction, and documentation generation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "react-docgen-typescript": "^2.4.0",
+    "remark": "^15.0.1",
+    "remark-flexible-toc": "^1.2.3",
+    "to-vfile": "^8.0.0",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.1",
+    "typescript": "~5.9.3"
+  },
+  "peerDependencies": {},
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/commercetools/nimbus.git",
+    "directory": "packages/nimbus-docs-build"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}