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

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

@@ -0,0 +1,20 @@
+/**
+ * MDX Parser for Documentation Build System
+ *
+ * Parses MDX files with frontmatter, generates table of contents,
+ * and supports multi-view documentation (e.g., *.dev.mdx, *.api.mdx)
+ */
+import type { MdxDocument } from "../types/mdx.js";
+/**
+ * Parse a single MDX file and return structured document data
+ * Supports multi-view documentation (e.g., button.dev.mdx, button.api.mdx)
+ *
+ * @param filePath - Absolute path to MDX file (should be from trusted source like file discovery)
+ * @note This function reads from discovered MDX files within the packages directory
+ */
+export declare function parseMdxFile(filePath: string): Promise<MdxDocument | null>;
+/**
+ * Parse all MDX files and return a map of documents
+ */
+export declare function parseAllMdx(mdxFiles: string[]): Promise<Map<string, MdxDocument>>;
+//# sourceMappingURL=parse-mdx.d.ts.map

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

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

package/dist/parsers/parse-mdx.js

@@ -0,0 +1,172 @@
+/**
+ * MDX Parser for Documentation Build System
+ *
+ * Parses MDX files with frontmatter, generates table of contents,
+ * and supports multi-view documentation (e.g., *.dev.mdx, *.api.mdx)
+ */
+import fs from "fs/promises";
+import path from "path";
+import matter from "gray-matter";
+import { remark } from "remark";
+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";
+/**
+ * Generate table of contents from MDX content (without frontmatter)
+ * @param content - The MDX content string with frontmatter already removed
+ */
+const generateToc = async (content) => {
+    const toc = [];
+    await remark().use(remarkFlexibleToc, { tocRef: toc }).process(content);
+    return toc || [];
+};
+/**
+ * Get all view MDX files for the given base .mdx file
+ * Returns array of objects with key and filePath
+ * e.g., button.dev.mdx -> { key: "dev", filePath: "..." }
+ */
+const getViewMdxFiles = async (baseMdxPath) => {
+    const dir = path.dirname(baseMdxPath);
+    const basename = path.basename(baseMdxPath, ".mdx");
+    try {
+        const files = await fs.readdir(dir);
+        const viewFiles = files
+            .filter((file) => {
+            // Match pattern: component-name.{key}.mdx
+            const regex = new RegExp(`^${basename}\\.([^.]+)\\.mdx$`);
+            return regex.test(file);
+        })
+            .map((file) => {
+            // Extract key from filename
+            const regex = new RegExp(`^${basename}\\.([^.]+)\\.mdx$`);
+            const match = file.match(regex);
+            const key = match ? match[1] : "";
+            return {
+                key,
+                filePath: validateFilePath(dir, file),
+            };
+        });
+        return viewFiles;
+    }
+    catch {
+        return [];
+    }
+};
+/**
+ * Parse a single MDX file and return its content, frontmatter, and TOC
+ *
+ * @param filePath - Absolute path to MDX file (should be pre-validated by caller)
+ * @note Callers must ensure filePath is validated to prevent path traversal
+ */
+const parseSingleMdx = async (filePath) => {
+    try {
+        const content = await fs.readFile(filePath, "utf8");
+        const { data: frontmatter, content: mdx } = matter(content);
+        const toc = await generateToc(mdx);
+        return { mdx, toc, frontmatter };
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Parse a single MDX file and return structured document data
+ * Supports multi-view documentation (e.g., button.dev.mdx, button.api.mdx)
+ *
+ * @param filePath - Absolute path to MDX file (should be from trusted source like file discovery)
+ * @note This function reads from discovered MDX files within the packages directory
+ */
+export async function parseMdxFile(filePath) {
+    try {
+        // Skip node_modules
+        if (filePath.includes("node_modules")) {
+            return null;
+        }
+        // Skip view files (*.{key}.mdx) as they will be processed with their main .mdx file
+        const basename = path.basename(filePath);
+        const nameWithoutMdx = basename.replace(/\.mdx$/, "");
+        if (nameWithoutMdx.includes(".")) {
+            // This is a view file, skip it
+            return null;
+        }
+        // Read main file content
+        const content = await fs.readFile(filePath, "utf8");
+        const { data: meta, content: mdx } = matter(content);
+        // Generate TOC for main file
+        const toc = await generateToc(mdx);
+        // Get relative path from monorepo root
+        const repoPath = await getPathFromMonorepoRoot(filePath);
+        // Get tab metadata from main file frontmatter (with defaults)
+        const mainTabTitle = meta["tab-title"] ||
+            meta["tabTitle"] ||
+            "Overview";
+        const mainTabOrder = meta["tab-order"] || meta["tabOrder"] || 0;
+        // Discover all view files (e.g., button.dev.mdx, button.api.mdx)
+        const viewFiles = await getViewMdxFiles(filePath);
+        // Build tabs array and views object
+        const tabs = [
+            { key: "overview", title: mainTabTitle, order: mainTabOrder },
+        ];
+        const views = {
+            overview: { mdx, toc },
+        };
+        // Parse each view file
+        for (const { key, filePath: viewFilePath } of viewFiles) {
+            const viewData = await parseSingleMdx(viewFilePath);
+            if (viewData) {
+                const { mdx: viewMdx, toc: viewToc, frontmatter: viewMeta } = viewData;
+                // Get tab metadata from view file frontmatter (with defaults)
+                const tabTitle = viewMeta["tab-title"] ||
+                    viewMeta["tabTitle"] ||
+                    key;
+                const tabOrder = viewMeta["tab-order"] ||
+                    viewMeta["tabOrder"] ||
+                    999;
+                tabs.push({ key, title: tabTitle, order: tabOrder });
+                views[key] = { mdx: viewMdx, toc: viewToc };
+            }
+        }
+        // Sort tabs by order (ascending)
+        tabs.sort((a, b) => a.order - b.order);
+        // Build document structure
+        const document = {
+            meta: {
+                ...meta,
+                repoPath,
+                order: meta.order || 999,
+                route: menuToPath(meta.menu || []),
+                toc,
+                tabs,
+            },
+            mdx,
+            views,
+        };
+        // Validate with Zod
+        const validatedDoc = mdxDocumentSchema.parse(document);
+        return validatedDoc;
+    }
+    catch (error) {
+        console.error(`Error parsing MDX file ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Parse all MDX files and return a map of documents
+ */
+export async function parseAllMdx(mdxFiles) {
+    const docs = new Map();
+    // Parse all files in parallel
+    const results = await Promise.all(mdxFiles.map(async (filePath) => {
+        const doc = await parseMdxFile(filePath);
+        return { filePath, doc };
+    }));
+    // Collect results
+    for (const { doc } of results) {
+        if (!doc)
+            continue;
+        docs.set(doc.meta.repoPath, doc);
+    }
+    return docs;
+}
+//# sourceMappingURL=parse-mdx.js.map

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

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

package/dist/parsers/parse-types.d.ts

@@ -0,0 +1,24 @@
+import type { ComponentDoc } from "react-docgen-typescript";
+import type { DocsBuilderConfig } from "../types/config.js";
+/**
+ * Parse TypeScript files and extract component props
+ * @param config - Configuration with componentIndexPath and optional propFilter
+ * @returns Array of processed component docs
+ */
+export declare function parseTypes(config: Pick<DocsBuilderConfig, "sources" | "propFilter">): Promise<ComponentDoc[]>;
+/**
+ * Parse types and write to a single output file
+ * @param componentIndexPath - Path to component index file
+ * @param outputPath - Path to write types JSON
+ * @param propFilter - Optional custom prop filter
+ */
+export declare function parseTypesToFile(componentIndexPath: string, outputPath: string, propFilter?: DocsBuilderConfig["propFilter"]): Promise<void>;
+/**
+ * Parse types and write individual component type files
+ * @param componentIndexPath - Path to component index file
+ * @param outputDir - Directory to write individual type files
+ * @param propFilter - Optional custom prop filter
+ * @returns Manifest mapping component names to filenames
+ */
+export declare function parseTypesToFiles(componentIndexPath: string, outputDir: string, propFilter?: DocsBuilderConfig["propFilter"]): Promise<Record<string, string>>;
+//# sourceMappingURL=parse-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-types.d.ts","sourceRoot":"","sources":["../../src/parsers/parse-types.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,YAAY,CAAC,GACxD,OAAO,CAAC,YAAY,EAAE,CAAC,CAyBzB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,kBAAkB,EAAE,MAAM,EAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,iBAAiB,CAAC,YAAY,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,iBAAiB,CAAC,YAAY,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA+BjC"}

package/dist/parsers/parse-types.js

@@ -0,0 +1,83 @@
+/**
+ * TypeScript Props Parser
+ *
+ * Extracts component prop types using react-docgen-typescript
+ * with access to proper tsconfig paths
+ */
+import fs from "fs/promises";
+import docgen from "react-docgen-typescript";
+import { processComponentTypes } from "./process-types.js";
+/**
+ * Parse TypeScript files and extract component props
+ * @param config - Configuration with componentIndexPath and optional propFilter
+ * @returns Array of processed component docs
+ */
+export async function parseTypes(config) {
+    try {
+        const indexPath = config.sources.componentIndexPath;
+        if (!indexPath) {
+            throw new Error("componentIndexPath is required for type parsing");
+        }
+        // Configure parser options
+        const options = {
+            savePropValueAsString: true,
+            shouldExtractLiteralValuesFromEnum: true,
+            shouldRemoveUndefinedFromOptional: true,
+        };
+        // Parse all types from the index file
+        const rawTypes = docgen.parse(indexPath, options);
+        // Process types (filter + enrich)
+        const processedTypes = processComponentTypes(rawTypes, config.propFilter);
+        return processedTypes;
+    }
+    catch (error) {
+        console.error("Error parsing types:", error);
+        throw error;
+    }
+}
+/**
+ * Parse types and write to a single output file
+ * @param componentIndexPath - Path to component index file
+ * @param outputPath - Path to write types JSON
+ * @param propFilter - Optional custom prop filter
+ */
+export async function parseTypesToFile(componentIndexPath, outputPath, propFilter) {
+    const processedTypes = await parseTypes({
+        sources: { packagesDir: "", componentIndexPath },
+        propFilter,
+    });
+    await fs.writeFile(outputPath, JSON.stringify(processedTypes, null, 2));
+}
+/**
+ * Parse types and write individual component type files
+ * @param componentIndexPath - Path to component index file
+ * @param outputDir - Directory to write individual type files
+ * @param propFilter - Optional custom prop filter
+ * @returns Manifest mapping component names to filenames
+ */
+export async function parseTypesToFiles(componentIndexPath, outputDir, propFilter) {
+    const processedTypes = await parseTypes({
+        sources: { packagesDir: "", componentIndexPath },
+        propFilter,
+    });
+    // Ensure output directory exists
+    await fs.mkdir(outputDir, { recursive: true });
+    // Write individual component type files and build manifest
+    const manifest = {};
+    for (const componentDoc of processedTypes) {
+        const componentName = componentDoc.displayName;
+        if (!componentName)
+            continue;
+        const filename = `${componentName}.json`;
+        const filePath = `${outputDir}/${filename}`;
+        // Write individual component type file
+        await fs.writeFile(filePath, JSON.stringify(componentDoc, null, 2));
+        // Add to manifest (without .json extension, similar to routes)
+        manifest[componentName] = componentName;
+    }
+    // Write manifest file
+    const manifestPath = `${outputDir}/manifest.json`;
+    await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2));
+    return manifest;
+}
+//# sourceMappingURL=parse-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-types.js","sourceRoot":"","sources":["../../src/parsers/parse-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,MAAM,MAAM,yBAAyB,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAyD;IAEzD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,2BAA2B;QAC3B,MAAM,OAAO,GAAG;YACd,qBAAqB,EAAE,IAAI;YAC3B,kCAAkC,EAAE,IAAI;YACxC,iCAAiC,EAAE,IAAI;SACxC,CAAC;QAEF,sCAAsC;QACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAElD,kCAAkC;QAClC,MAAM,cAAc,GAAG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAE1E,OAAO,cAAc,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,kBAA0B,EAC1B,UAAkB,EAClB,UAA4C;IAE5C,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC;QACtC,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,kBAAkB,EAAE;QAChD,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,kBAA0B,EAC1B,SAAiB,EACjB,UAA4C;IAE5C,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC;QACtC,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,kBAAkB,EAAE;QAChD,UAAU;KACX,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,2DAA2D;IAC3D,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAE5C,KAAK,MAAM,YAAY,IAAI,cAAc,EAAE,CAAC;QAC1C,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC;QAC/C,IAAI,CAAC,aAAa;YAAE,SAAS;QAE7B,MAAM,QAAQ,GAAG,GAAG,aAAa,OAAO,CAAC;QACzC,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC;QAE5C,uCAAuC;QACvC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEpE,+DAA+D;QAC/D,QAAQ,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;IAC1C,CAAC;IAED,sBAAsB;IACtB,MAAM,YAAY,GAAG,GAAG,SAAS,gBAAgB,CAAC;IAClD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEpE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/parsers/process-types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Post-processing pipeline for react-docgen-typescript output.
+ * Applies metadata enrichment and filtering in a single in-memory pass.
+ */
+import type { ComponentDoc, PropItem } from "react-docgen-typescript";
+/**
+ * Process parsed component types in a single pass:
+ * 1. Filter out unwanted props
+ * 2. Analyze filtered props to generate component-level metadata
+ * 3. Return component with metadata and filtered props
+ *
+ * This is a single-pass, in-memory operation with no disk I/O.
+ *
+ * @param rawParsedTypes - Raw output from react-docgen-typescript
+ * @param customPropFilter - Optional custom prop filter function
+ * @returns Processed component docs with filtered props and enriched metadata
+ */
+export declare const processComponentTypes: (rawParsedTypes: ComponentDoc[], customPropFilter?: (prop: PropItem) => boolean) => ComponentDoc[];
+//# sourceMappingURL=process-types.d.ts.map

package/dist/parsers/process-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-types.d.ts","sourceRoot":"","sources":["../../src/parsers/process-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAmBtE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAChC,gBAAgB,YAAY,EAAE,EAC9B,mBAAmB,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,KAC7C,YAAY,EAoBd,CAAC"}

package/dist/parsers/process-types.js

@@ -0,0 +1,44 @@
+import { shouldFilterProp } from "./filter-props.js";
+/**
+ * Enrich component with metadata based on JSDoc tags and props.
+ * This adds aggregate information about the component at the top level.
+ *
+ * @param component - The component doc from react-docgen-typescript
+ * @returns Component-level metadata
+ */
+const enrichComponent = (component) => {
+    // Check if component has @supportsStyleProps JSDoc tag
+    const supportsStyleProps = "supportsStyleProps" in (component.tags || {});
+    return {
+        supportsStyleProps,
+    };
+};
+/**
+ * Process parsed component types in a single pass:
+ * 1. Filter out unwanted props
+ * 2. Analyze filtered props to generate component-level metadata
+ * 3. Return component with metadata and filtered props
+ *
+ * This is a single-pass, in-memory operation with no disk I/O.
+ *
+ * @param rawParsedTypes - Raw output from react-docgen-typescript
+ * @param customPropFilter - Optional custom prop filter function
+ * @returns Processed component docs with filtered props and enriched metadata
+ */
+export const processComponentTypes = (rawParsedTypes, customPropFilter) => {
+    return rawParsedTypes.map((component) => {
+        // Use custom filter if provided, otherwise use default
+        const filterFn = customPropFilter || shouldFilterProp;
+        // Step 1: Filter props
+        const filteredProps = Object.fromEntries(Object.entries(component.props).filter(([, prop]) => filterFn(prop)));
+        // Step 2: Generate component-level metadata from JSDoc tags and filtered props
+        const metadata = enrichComponent(component);
+        // Step 3: Return component with metadata and filtered props
+        return {
+            ...component,
+            ...metadata,
+            props: filteredProps,
+        };
+    });
+};
+//# sourceMappingURL=process-types.js.map

package/dist/parsers/process-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-types.js","sourceRoot":"","sources":["../../src/parsers/process-types.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,CAAC,SAAuB,EAA2B,EAAE;IAC3E,uDAAuD;IACvD,MAAM,kBAAkB,GAAG,oBAAoB,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAE1E,OAAO;QACL,kBAAkB;KACnB,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,cAA8B,EAC9B,gBAA8C,EAC9B,EAAE;IAClB,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QACtC,uDAAuD;QACvD,MAAM,QAAQ,GAAG,gBAAgB,IAAI,gBAAgB,CAAC;QAEtD,uBAAuB;QACvB,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CACtC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACrE,CAAC;QAEF,+EAA+E;QAC/E,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QAE5C,4DAA4D;QAC5D,OAAO;YACL,GAAG,SAAS;YACZ,GAAG,QAAQ;YACX,KAAK,EAAE,aAAa;SACrB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Schema exports for documentation validation
+ */
+export * from "./lifecycle-states.js";
+export * from "./mdx-document.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/schemas/index.js

@@ -0,0 +1,6 @@
+/**
+ * Schema exports for documentation validation
+ */
+export * from "./lifecycle-states.js";
+export * from "./mdx-document.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

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

package/dist/schemas/lifecycle-states.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Lifecycle state definitions for components and features
+ */
+export declare const lifecycleStates: readonly ["Experimental", "Alpha", "Beta", "Stable", "Deprecated", "EOL"];
+export type LifecycleState = (typeof lifecycleStates)[number];
+type LifecycleStateDescription = {
+    [K in LifecycleState]: {
+        label: string;
+        description: string;
+        order: number;
+        colorPalette: string;
+    };
+};
+export declare const lifecycleStateDescriptions: LifecycleStateDescription;
+export {};
+//# sourceMappingURL=lifecycle-states.d.ts.map

package/dist/schemas/lifecycle-states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-states.d.ts","sourceRoot":"","sources":["../../src/schemas/lifecycle-states.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,eAAe,2EAOlB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,KAAK,yBAAyB,GAAG;KAC9B,CAAC,IAAI,cAAc,GAAG;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;KACtB;CACF,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,yBA2CxC,CAAC"}

package/dist/schemas/lifecycle-states.js

@@ -0,0 +1,50 @@
+/**
+ * Lifecycle state definitions for components and features
+ */
+export const lifecycleStates = [
+    "Experimental",
+    "Alpha",
+    "Beta",
+    "Stable",
+    "Deprecated",
+    "EOL",
+];
+export const lifecycleStateDescriptions = {
+    Experimental: {
+        label: "Experimental",
+        description: "Highly unstable, may be removed entirely without notice. Not for production use.",
+        order: 1,
+        colorPalette: "red",
+    },
+    Alpha: {
+        label: "Alpha",
+        description: "Still highly unstable with known bugs. Not for production use.",
+        order: 2,
+        colorPalette: "orange",
+    },
+    Beta: {
+        label: "Beta",
+        description: "More stable but subject to breaking changes. Use with caution in non-critical production.",
+        order: 3,
+        colorPalette: "amber",
+    },
+    Stable: {
+        label: "Stable",
+        description: "Production-ready, thoroughly tested, and actively maintained.",
+        order: 4,
+        colorPalette: "grass",
+    },
+    Deprecated: {
+        label: "Deprecated",
+        description: "Not for new development. Will be removed in a future version.",
+        order: 5,
+        colorPalette: "neutral",
+    },
+    EOL: {
+        label: "End-of-Life",
+        description: "No longer available. Element has been removed from the library.",
+        order: 6,
+        colorPalette: "blackAlpha",
+    },
+};
+//# sourceMappingURL=lifecycle-states.js.map

package/dist/schemas/lifecycle-states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-states.js","sourceRoot":"","sources":["../../src/schemas/lifecycle-states.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc;IACd,OAAO;IACP,MAAM;IACN,QAAQ;IACR,YAAY;IACZ,KAAK;CACG,CAAC;AAaX,MAAM,CAAC,MAAM,0BAA0B,GAA8B;IACnE,YAAY,EAAE;QACZ,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,kFAAkF;QACpF,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,KAAK;KACpB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,WAAW,EACT,gEAAgE;QAClE,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,QAAQ;KACvB;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM;QACb,WAAW,EACT,2FAA2F;QAC7F,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,OAAO;KACtB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,WAAW,EACT,+DAA+D;QACjE,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,OAAO;KACtB;IACD,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,+DAA+D;QACjE,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,SAAS;KACxB;IACD,GAAG,EAAE;QACH,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,iEAAiE;QACnE,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,YAAY;KAC3B;CACF,CAAC"}