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

package/dist/cache/build-cache.js

@@ -0,0 +1,147 @@
+/**
+ * Build Cache System
+ *
+ * Implements incremental builds by tracking file hashes and
+ * only rebuilding changed content.
+ */
+import fs from "fs/promises";
+import path from "path";
+import crypto from "crypto";
+import { validateFilePath } from "../utils/validate-file-path.js";
+const DEFAULT_CACHE_DIR = ".cache";
+const CACHE_FILENAME = "build-cache.json";
+/**
+ * Get cache file path
+ */
+function getCachePath(cacheDir) {
+    const dir = cacheDir || DEFAULT_CACHE_DIR;
+    // Validate cache directory path to prevent traversal
+    const baseDir = process.cwd();
+    return validateFilePath(baseDir, dir, CACHE_FILENAME);
+}
+/**
+ * Calculate file hash for cache validation
+ *
+ * @param filePath - Absolute path to file (should be pre-validated by caller)
+ * @note Callers must ensure filePath is validated to prevent path traversal
+ */
+export async function calculateFileHash(filePath) {
+    const content = await fs.readFile(filePath, "utf-8");
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+/**
+ * Load build cache from disk
+ */
+export async function loadCache(cacheDir) {
+    try {
+        const cachePath = getCachePath(cacheDir);
+        const cacheFileDir = path.dirname(cachePath);
+        await fs.mkdir(cacheFileDir, { recursive: true });
+        const content = await fs.readFile(cachePath, "utf-8");
+        const data = JSON.parse(content);
+        return {
+            version: data.version || "1.0.0",
+            files: new Map(Object.entries(data.files || {})),
+        };
+    }
+    catch {
+        // Cache doesn't exist or is invalid, return empty cache
+        return {
+            version: "1.0.0",
+            files: new Map(),
+        };
+    }
+}
+/**
+ * Save build cache to disk
+ */
+export async function saveCache(cache, cacheDir) {
+    const cachePath = getCachePath(cacheDir);
+    const cacheFileDir = path.dirname(cachePath);
+    await fs.mkdir(cacheFileDir, { recursive: true });
+    const data = {
+        version: cache.version,
+        files: Object.fromEntries(cache.files),
+    };
+    await fs.writeFile(cachePath, JSON.stringify(data, null, 2), "utf-8");
+}
+/**
+ * Check if a file needs rebuilding
+ */
+export async function needsRebuild(filePath, cache) {
+    try {
+        const currentHash = await calculateFileHash(filePath);
+        const cacheEntry = cache.files.get(filePath);
+        // No cache entry = needs build
+        if (!cacheEntry)
+            return true;
+        // Hash changed = needs rebuild
+        if (cacheEntry.hash !== currentHash)
+            return true;
+        // Check if output still exists
+        try {
+            await fs.access(cacheEntry.outputPath);
+            return false; // Output exists and hash matches
+        }
+        catch {
+            return true; // Output missing, needs rebuild
+        }
+    }
+    catch {
+        // Error reading file, assume needs rebuild
+        return true;
+    }
+}
+/**
+ * Update cache entry for a file
+ */
+export function updateCacheEntry(cache, filePath, hash, outputPath) {
+    cache.files.set(filePath, {
+        hash,
+        timestamp: Date.now(),
+        outputPath,
+    });
+}
+/**
+ * Clear stale cache entries (files that no longer exist)
+ */
+export async function cleanCache(cache, validFiles) {
+    const validSet = new Set(validFiles);
+    for (const [filePath] of cache.files) {
+        if (!validSet.has(filePath)) {
+            cache.files.delete(filePath);
+        }
+    }
+}
+/**
+ * Get cache statistics
+ */
+export function getCacheStats(cache) {
+    let oldestEntry = Date.now();
+    let newestEntry = 0;
+    for (const [, entry] of cache.files) {
+        if (entry.timestamp < oldestEntry)
+            oldestEntry = entry.timestamp;
+        if (entry.timestamp > newestEntry)
+            newestEntry = entry.timestamp;
+    }
+    return {
+        totalFiles: cache.files.size,
+        oldestEntry,
+        newestEntry,
+    };
+}
+/**
+ * Clear entire cache
+ */
+export async function clearCache(cacheDir) {
+    try {
+        const dir = cacheDir || DEFAULT_CACHE_DIR;
+        await fs.rm(dir, { recursive: true, force: true });
+        console.log("✓ Build cache cleared");
+    }
+    catch (error) {
+        console.warn("Warning: Could not clear cache:", error);
+    }
+}
+//# sourceMappingURL=build-cache.js.map

package/dist/cache/build-cache.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Cache exports
+ */
+export * from "./build-cache.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cache/index.js

@@ -0,0 +1,5 @@
+/**
+ * Cache exports
+ */
+export * from "./build-cache.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

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

package/dist/generators/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generator exports
+ */
+export * from "./routes.js";
+export * from "./search.js";
+export * from "./robots.js";
+export * from "./sitemap.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/generators/index.js

@@ -0,0 +1,8 @@
+/**
+ * Generator exports
+ */
+export * from "./routes.js";
+export * from "./search.js";
+export * from "./robots.js";
+export * from "./sitemap.js";
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

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

package/dist/generators/robots.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate robots.txt
+ */
+export declare function generateRobots(baseUrl: string, outputPath: string): Promise<void>;
+//# sourceMappingURL=robots.d.ts.map

package/dist/generators/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../src/generators/robots.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/generators/robots.js

@@ -0,0 +1,34 @@
+/**
+ * Robots.txt Generator
+ *
+ * Generates robots.txt for SEO and crawler control
+ */
+import fs from "fs/promises";
+import path from "path";
+import { validateFilePath } from "../utils/validate-file-path.js";
+/**
+ * Generate robots.txt
+ */
+export async function generateRobots(baseUrl, outputPath) {
+    const robots = `# Nimbus Documentation Robots.txt
+# Allow all crawlers
+User-agent: *
+Allow: /
+
+# Sitemap location
+Sitemap: ${baseUrl}/sitemap.xml
+
+# Crawl rate (optional)
+Crawl-delay: 1
+
+# Disallow private/internal routes if any
+# Disallow: /api/
+# Disallow: /internal/
+`;
+    // Validate output path to prevent traversal
+    const outputDir = path.dirname(outputPath);
+    const validatedPath = validateFilePath(outputDir, path.basename(outputPath));
+    await fs.writeFile(validatedPath, robots, "utf-8");
+    console.log(`✓ Generated robots.txt`);
+}
+//# sourceMappingURL=robots.js.map

package/dist/generators/robots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../../src/generators/robots.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,UAAkB;IAElB,MAAM,MAAM,GAAG;;;;;;WAMN,OAAO;;;;;;;;CAQjB,CAAC;IAEA,4CAA4C;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7E,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AACxC,CAAC"}

package/dist/generators/routes.d.ts

@@ -0,0 +1,6 @@
+import type { MdxDocument, RouteManifest } from "../types/mdx.js";
+/**
+ * Generate route manifest from parsed documents
+ */
+export declare function generateRouteManifest(docs: Map<string, MdxDocument>, outputPath: string): Promise<RouteManifest>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/generators/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/generators/routes.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EAGd,MAAM,iBAAiB,CAAC;AAKzB;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CA+ExB"}

package/dist/generators/routes.js

@@ -0,0 +1,77 @@
+/**
+ * Route Manifest Generator
+ *
+ * Generates route configuration from parsed MDX documents
+ */
+import fs from "fs/promises";
+import path from "path";
+import { routeManifestSchema } from "../schemas/mdx-document.js";
+import { flog } from "../utils/logger.js";
+import { validateFilePath } from "../utils/validate-file-path.js";
+/**
+ * Generate route manifest from parsed documents
+ */
+export async function generateRouteManifest(docs, outputPath) {
+    const routes = [];
+    const categoriesMap = new Map();
+    // Process each document
+    for (const [, doc] of docs) {
+        const { meta } = doc;
+        const category = meta.menu[0] || "Uncategorized";
+        const routePath = `/${meta.route}`;
+        // Create route info
+        const route = {
+            path: routePath,
+            id: meta.id,
+            title: meta.title,
+            description: meta.description || "",
+            lifecycleState: meta.lifecycleState,
+            category,
+            tags: meta.tags || [],
+            menu: meta.menu,
+            order: meta.order || 999,
+            chunkName: `route-${meta.route.replace(/\//g, "-")}`,
+            icon: meta.icon,
+            tabs: meta.tabs || [],
+        };
+        routes.push(route);
+        // Build categories
+        if (!categoriesMap.has(category)) {
+            categoriesMap.set(category, {
+                id: category.toLowerCase().replace(/\s+/g, "-"),
+                label: category,
+                order: 999,
+                items: [],
+            });
+        }
+        categoriesMap.get(category).items.push(route);
+    }
+    // Convert categories map to array and sort
+    const categories = Array.from(categoriesMap.values()).sort((a, b) => a.order - b.order);
+    // Build navigation structure
+    const navigation = categories.reduce((acc, category) => {
+        acc[category.id] = {
+            label: category.label,
+            items: category.items.map((item) => ({
+                id: item.id,
+                title: item.title,
+                path: item.path,
+            })),
+        };
+        return acc;
+    }, {});
+    const manifest = {
+        routes,
+        categories,
+        navigation,
+    };
+    // Validate
+    const validatedManifest = routeManifestSchema.parse(manifest);
+    // Write to disk
+    const outputDir = path.dirname(outputPath);
+    const validatedPath = validateFilePath(outputDir, path.basename(outputPath));
+    await fs.writeFile(validatedPath, JSON.stringify(validatedManifest, null, 2));
+    flog(`[Routes] Generated manifest with ${routes.length} routes`);
+    return validatedManifest;
+}
+//# sourceMappingURL=routes.js.map

package/dist/generators/routes.js.map

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

package/dist/generators/search.d.ts

@@ -0,0 +1,6 @@
+import type { MdxDocument } from "../types/mdx.js";
+/**
+ * Generate search index from parsed documents
+ */
+export declare function generateSearchIndex(docs: Map<string, MdxDocument>, outputPath: string): Promise<void>;
+//# sourceMappingURL=search.d.ts.map

package/dist/generators/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/generators/search.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAkBnD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/generators/search.js

@@ -0,0 +1,44 @@
+/**
+ * Search Index Generator
+ *
+ * Generates a searchable index from documentation
+ */
+import fs from "fs/promises";
+import path from "path";
+import { flog } from "../utils/logger.js";
+import { validateFilePath } from "../utils/validate-file-path.js";
+/**
+ * Strip markdown formatting from text
+ */
+function stripMarkdown(text) {
+    return text
+        .replace(/#{1,6}\s/g, "") // Remove headers
+        .replace(/\*\*([^*]+)\*\*/g, "$1") // Remove bold
+        .replace(/\*([^*]+)\*/g, "$1") // Remove italic
+        .replace(/`([^`]+)`/g, "$1") // Remove code
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1") // Remove links
+        .replace(/!\[([^\]]*)\]\([^)]+\)/g, "") // Remove images
+        .trim();
+}
+/**
+ * Generate search index from parsed documents
+ */
+export async function generateSearchIndex(docs, outputPath) {
+    const searchItems = Array.from(docs.values())
+        .map((doc) => ({
+        id: doc.meta.id,
+        title: doc.meta.title,
+        description: doc.meta.description || "",
+        tags: doc.meta.tags || [],
+        route: doc.meta.route,
+        menu: doc.meta.menu,
+        // Strip markdown and truncate content for search (first 500 chars)
+        content: stripMarkdown(doc.mdx).slice(0, 500),
+    }))
+        .sort((a, b) => a.id.localeCompare(b.id));
+    const outputDir = path.dirname(outputPath);
+    const validatedPath = validateFilePath(outputDir, path.basename(outputPath));
+    await fs.writeFile(validatedPath, JSON.stringify(searchItems, null, 2));
+    flog(`[Search] Generated index with ${searchItems.length} items`);
+}
+//# sourceMappingURL=search.js.map

package/dist/generators/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/generators/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,iBAAiB;SAC1C,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,cAAc;SAChD,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,gBAAgB;SAC9C,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,cAAc;SAC1C,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC,eAAe;SACvD,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC,gBAAgB;SACvD,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAA8B,EAC9B,UAAkB;IAElB,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;SAC1C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE;QACf,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK;QACrB,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE;QACvC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE;QACzB,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK;QACrB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI;QACnB,mEAAmE;QACnE,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;KAC9C,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7E,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAExE,IAAI,CAAC,iCAAiC,WAAW,CAAC,MAAM,QAAQ,CAAC,CAAC;AACpE,CAAC"}

package/dist/generators/sitemap.d.ts

@@ -0,0 +1,6 @@
+import type { RouteManifest } from "../types/mdx.js";
+/**
+ * Generate sitemap.xml from route manifest
+ */
+export declare function generateSitemap(manifest: RouteManifest, baseUrl: string, outputPath: string): Promise<void>;
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/generators/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/generators/sitemap.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/generators/sitemap.js

@@ -0,0 +1,33 @@
+/**
+ * Sitemap Generator
+ *
+ * Generates sitemap.xml for SEO
+ */
+import fs from "fs/promises";
+import path from "path";
+import { validateFilePath } from "../utils/validate-file-path.js";
+/**
+ * Generate sitemap.xml from route manifest
+ */
+export async function generateSitemap(manifest, baseUrl, outputPath) {
+    const urls = manifest.routes.map((route) => {
+        const lastmod = new Date().toISOString().split("T")[0];
+        const priority = route.path === "/" ? "1.0" : "0.8";
+        const changefreq = "weekly";
+        return `  <url>
+    <loc>${baseUrl}${route.path}</loc>
+    <lastmod>${lastmod}</lastmod>
+    <changefreq>${changefreq}</changefreq>
+    <priority>${priority}</priority>
+  </url>`;
+    });
+    const sitemap = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls.join("\n")}
+</urlset>`;
+    const outputDir = path.dirname(outputPath);
+    const validatedPath = validateFilePath(outputDir, path.basename(outputPath));
+    await fs.writeFile(validatedPath, sitemap, "utf-8");
+    console.log(`✓ Generated sitemap with ${urls.length} URLs`);
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/generators/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../../src/generators/sitemap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAuB,EACvB,OAAe,EACf,UAAkB;IAElB,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACzC,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACpD,MAAM,UAAU,GAAG,QAAQ,CAAC;QAE5B,OAAO;WACA,OAAO,GAAG,KAAK,CAAC,IAAI;eAChB,OAAO;kBACJ,UAAU;gBACZ,QAAQ;SACf,CAAC;IACR,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG;;EAEhB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;UACP,CAAC;IAET,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7E,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC;AAC9D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @commercetools/nimbus-docs-build
+ *
+ * Documentation build system for Nimbus design system
+ *
+ * @packageDocumentation
+ */
+export { build } from "./builders/build.js";
+export { buildMdx, buildTypes, buildManifest, buildSeo, } from "./builders/index.js";
+export { parseMdxFile, parseAllMdx, parseTypes, parseTypesToFile, parseTypesToFiles, } from "./parsers/index.js";
+export { generateRouteManifest, generateSearchIndex, generateRobots, generateSitemap, } from "./generators/index.js";
+export { validateContent } from "./validation/index.js";
+export { loadCache, saveCache, needsRebuild, updateCacheEntry, cleanCache, getCacheStats, clearCache, calculateFileHash, } from "./cache/index.js";
+export { optimizeAssets } from "./assets/index.js";
+export { flog, errorLog, warnLog, successLog, sluggify, menuToPath, findMonorepoRoot, getPathFromMonorepoRoot, findFiles, findFilesByExtensions, validateFilePath, } from "./utils/index.js";
+export * from "./schemas/index.js";
+export * from "./types/index.js";
+export type { ComponentDoc, PropItem } from "react-docgen-typescript";
+//# 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;;;;;;GAMG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C,OAAO,EACL,QAAQ,EACR,UAAU,EACV,aAAa,EACb,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,UAAU,EACV,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,UAAU,EACV,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,SAAS,EACT,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @commercetools/nimbus-docs-build
+ *
+ * Documentation build system for Nimbus design system
+ *
+ * @packageDocumentation
+ */
+// Main build function
+export { build } from "./builders/build.js";
+// Individual builders (for advanced usage)
+export { buildMdx, buildTypes, buildManifest, buildSeo, } from "./builders/index.js";
+// Parsers
+export { parseMdxFile, parseAllMdx, parseTypes, parseTypesToFile, parseTypesToFiles, } from "./parsers/index.js";
+// Generators
+export { generateRouteManifest, generateSearchIndex, generateRobots, generateSitemap, } from "./generators/index.js";
+// Validation
+export { validateContent } from "./validation/index.js";
+// Cache utilities
+export { loadCache, saveCache, needsRebuild, updateCacheEntry, cleanCache, getCacheStats, clearCache, calculateFileHash, } from "./cache/index.js";
+// Asset optimization
+export { optimizeAssets } from "./assets/index.js";
+// Utilities
+export { flog, errorLog, warnLog, successLog, sluggify, menuToPath, findMonorepoRoot, getPathFromMonorepoRoot, findFiles, findFilesByExtensions, validateFilePath, } from "./utils/index.js";
+// Schemas and types
+export * from "./schemas/index.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sBAAsB;AACtB,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,2CAA2C;AAC3C,OAAO,EACL,QAAQ,EACR,UAAU,EACV,aAAa,EACb,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAE7B,UAAU;AACV,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,aAAa;AACb,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,kBAAkB;AAClB,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,UAAU,EACV,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,qBAAqB;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,YAAY;AACZ,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,UAAU,EACV,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,SAAS,EACT,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/parsers/filter-props.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Prop filtering logic extracted from react-docgen-typescript parsing.
+ * Filters out inherited HTML, React, Chakra, and ARIA props to show only
+ * component-specific props in documentation.
+ */
+import type { PropItem } from "react-docgen-typescript";
+/**
+ * Determines whether a prop should be filtered out of documentation.
+ * Returns true if the prop should be KEPT, false if it should be FILTERED.
+ *
+ * @param prop - The prop item from react-docgen-typescript
+ * @returns true if prop should be kept, false if it should be filtered
+ */
+export declare const shouldFilterProp: (prop: PropItem) => boolean;
+//# sourceMappingURL=filter-props.d.ts.map

package/dist/parsers/filter-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-props.d.ts","sourceRoot":"","sources":["../../src/parsers/filter-props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,QAAQ,KAAG,OAqDjD,CAAC"}

package/dist/parsers/filter-props.js

@@ -0,0 +1,50 @@
+/**
+ * Determines whether a prop should be filtered out of documentation.
+ * Returns true if the prop should be KEPT, false if it should be FILTERED.
+ *
+ * @param prop - The prop item from react-docgen-typescript
+ * @returns true if prop should be kept, false if it should be filtered
+ */
+export const shouldFilterProp = (prop) => {
+    // React Key attribute
+    const isReactKeyAttribute = prop.name === "key";
+    // All HTML attributes
+    const isHTMLAttribute = prop.parent?.name === "HTMLAttributes";
+    // HTML-Event listener
+    const isDOMAttribute = prop.parent?.name === "DOMAttributes";
+    // ButtonHTMLAttributes
+    const isButtonAttribute = prop.parent?.name === "ButtonHTMLAttributes";
+    // GlobalDOMEvents
+    const isGlobalDOMEvent = prop.parent?.name === "GlobalDOMEvents";
+    // GlobalDOMAttribute
+    const isGlobalDOMAttribute = prop.parent?.name === "GlobalDOMAttributes";
+    // Chakra related props
+    const isChakraSystemProperty = prop.parent?.name === "SystemProperties";
+    const isChakraCondition = prop.parent?.name === "Conditions";
+    const isSlotRecipeDefinition = prop.name === "recipe";
+    // Default accessibility props
+    const isAriaAttribute = prop.parent?.name === "AriaAttributes";
+    /**
+     * Fallback props: When standard HTML attribute names (e.g., "height") are
+     * repurposed for style APIs, their actual DOM equivalents are generated
+     * as "HtmlProps" (e.g., "htmlHeight") to avoid conflicts.
+     */
+    const isHtmlFallbackProp = prop.parent?.name === "HtmlProps";
+    // Exclude redundant props
+    if (isReactKeyAttribute ||
+        isHTMLAttribute ||
+        isDOMAttribute ||
+        isButtonAttribute ||
+        isGlobalDOMEvent ||
+        isGlobalDOMAttribute ||
+        isAriaAttribute ||
+        isChakraSystemProperty ||
+        isChakraCondition ||
+        isSlotRecipeDefinition ||
+        isHtmlFallbackProp) {
+        return false;
+    }
+    // Keep all other props
+    return true;
+};
+//# sourceMappingURL=filter-props.js.map

package/dist/parsers/filter-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-props.js","sourceRoot":"","sources":["../../src/parsers/filter-props.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAc,EAAW,EAAE;IAC1D,sBAAsB;IACtB,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;IAEhD,sBAAsB;IACtB,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,gBAAgB,CAAC;IAE/D,sBAAsB;IACtB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,eAAe,CAAC;IAE7D,uBAAuB;IACvB,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,sBAAsB,CAAC;IAEvE,kBAAkB;IAClB,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,iBAAiB,CAAC;IAEjE,qBAAqB;IACrB,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,qBAAqB,CAAC;IAEzE,uBAAuB;IACvB,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,kBAAkB,CAAC;IACxE,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,YAAY,CAAC;IAC7D,MAAM,sBAAsB,GAAG,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;IAEtD,8BAA8B;IAC9B,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,gBAAgB,CAAC;IAE/D;;;;OAIG;IACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,WAAW,CAAC;IAE7D,0BAA0B;IAC1B,IACE,mBAAmB;QACnB,eAAe;QACf,cAAc;QACd,iBAAiB;QACjB,gBAAgB;QAChB,oBAAoB;QACpB,eAAe;QACf,sBAAsB;QACtB,iBAAiB;QACjB,sBAAsB;QACtB,kBAAkB,EAClB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uBAAuB;IACvB,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/parsers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Parser exports
+ */
+export * from "./parse-mdx.js";
+export * from "./parse-types.js";
+export * from "./filter-props.js";
+export * from "./process-types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/parsers/index.js

@@ -0,0 +1,8 @@
+/**
+ * Parser exports
+ */
+export * from "./parse-mdx.js";
+export * from "./parse-types.js";
+export * from "./filter-props.js";
+export * from "./process-types.js";
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +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"}