@vendure-io/docs-provider 0.8.2 → 0.10.0

package/dist/testing/index.d.ts

@@ -1,7 +1,11 @@
 import { MdxCompilationResult, MdxTestReport } from './types';
-export type { CompileMdxOptions, MdxCompilationResult, MdxTestReport, TestManifestOptions, } from './types';
+export type { AdmonitionError, AdmonitionValidationReport, CodeLanguageError, CodeLanguageValidationReport, CompileMdxOptions, FrontmatterError, FrontmatterValidationReport, MdxCompilationResult, MdxTestReport, TestManifestOptions, TestRunnerOptions, TestRunnerReport, ValidateAdmonitionsOptions, ValidateCodeLanguagesOptions, ValidateFrontmatterOptions, } from './types';
 export { compileMdx, getDefaultRehypePlugins, getDefaultRemarkPlugins } from './mdx-compiler';
+export { formatTestRunnerReport, runAllTests } from './run-all-tests';
 export { testManifestMdx } from './test-manifest';
+export { ADMONITION_TYPES, formatAdmonitionReport, INVALID_ADMONITION_PATTERN, validateAdmonitions, } from './validate-admonitions';
+export { formatCodeLanguageReport, getCanonicalLanguage, isValidCodeLanguage, LANGUAGE_ALIASES, SHIKI_BUNDLED_LANGUAGES, validateCodeLanguages, } from './validate-code-languages';
+export { formatFrontmatterReport, validateFrontmatter } from './validate-frontmatter';
 /**
  * Format a test report for console output.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAGlE,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,UAAQ,GAAG,MAAM,CAgE/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,oBAAoB,KACzB,IAAI,CAcR"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAGlE,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,iBAAiB,EACjB,4BAA4B,EAC5B,iBAAiB,EACjB,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAC7F,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAErF;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,UAAQ,GAAG,MAAM,CAgE/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,oBAAoB,KACzB,IAAI,CAcR"}

package/dist/testing/run-all-tests.d.ts

@@ -0,0 +1,56 @@
+import { DocsPackageManifest } from '../types';
+import { TestRunnerOptions, TestRunnerReport } from './types';
+/**
+ * Run all documentation validation tests on a manifest.
+ *
+ * This function runs all validators in sequence (fast validators first):
+ * 1. Frontmatter validation (fast, catches missing/invalid metadata)
+ * 2. Admonition validation (fast, regex-based)
+ * 3. Code language validation (fast, regex-based)
+ * 4. MDX compilation (slowest, full AST parsing)
+ *
+ * By default, all validators are enabled. Pass `false` to skip specific validators.
+ *
+ * @param manifest - The documentation package manifest to test
+ * @param options - Optional configuration for the test runner
+ * @returns A unified report containing results from all validators
+ *
+ * @example
+ * ```typescript
+ * // Minimal usage - runs ALL validators by default
+ * import { manifest } from '../src/manifest'
+ * import { runAllTests } from '@vendure-io/docs-provider/testing'
+ *
+ * runAllTests(manifest)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With options
+ * import { manifest } from '../src/manifest'
+ * import { runAllTests } from '@vendure-io/docs-provider/testing'
+ *
+ * runAllTests(manifest, {
+ *   verbose: true,      // Show all files, not just failures
+ *   failFast: true,     // Stop on first error
+ *   frontmatter: false, // Skip frontmatter validation
+ *   mdx: { /* pass options to MDX validator *\/ },
+ * })
+ * ```
+ */
+export declare function runAllTests(manifest: DocsPackageManifest, options?: TestRunnerOptions): Promise<TestRunnerReport>;
+/**
+ * Format a unified test runner report for console output.
+ *
+ * @param report - The test runner report to format
+ * @param verbose - If true, show details for all files. If false, only show failures.
+ * @returns A formatted string suitable for console output
+ *
+ * @example
+ * ```typescript
+ * const report = await runAllTests(manifest, { exit: false, silent: true })
+ * console.log(formatTestRunnerReport(report, true))
+ * ```
+ */
+export declare function formatTestRunnerReport(report: TestRunnerReport, verbose?: boolean): string;
+//# sourceMappingURL=run-all-tests.d.ts.map

package/dist/testing/run-all-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-all-tests.d.ts","sourceRoot":"","sources":["../../src/testing/run-all-tests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAGnD,OAAO,KAAK,EAEV,iBAAiB,EACjB,gBAAgB,EAIjB,MAAM,SAAS,CAAA;AAKhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAqF3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,UAAQ,GAAG,MAAM,CAiKxF"}

package/dist/testing/types.d.ts

@@ -73,4 +73,214 @@ export interface CompileMdxOptions {
      */
     rehypePlugins?: PluggableList;
 }
+/**
+ * Error found during admonition syntax validation
+ */
+export interface AdmonitionError {
+    /** Relative path to the file from the manifest basePath */
+    file: string;
+    /** Absolute path to the file */
+    absolutePath: string;
+    /** Line number where the error was found (1-indexed) */
+    line: number;
+    /** Column number where the error was found (1-indexed) */
+    column: number;
+    /** The full content of the line containing the error */
+    content: string;
+    /** The type of admonition (warning, info, tip, etc.) */
+    admonitionType: string;
+    /** The label that was incorrectly space-separated */
+    label: string;
+    /** Suggested fix using bracket syntax */
+    suggestion: string;
+}
+/**
+ * Report from validating admonition syntax in a manifest
+ */
+export interface AdmonitionValidationReport {
+    /** Package ID from the manifest */
+    packageId: string;
+    /** Number of files that were scanned */
+    filesScanned: number;
+    /** List of validation errors found */
+    errors: AdmonitionError[];
+    /** Total time taken for validation in milliseconds */
+    totalTime: number;
+}
+/**
+ * Options for validating admonition syntax
+ */
+export interface ValidateAdmonitionsOptions {
+    /**
+     * Stop on first error.
+     * @default false
+     */
+    failFast?: boolean;
+    /**
+     * Callback invoked for each error found.
+     * Useful for real-time reporting.
+     */
+    onError?: (error: AdmonitionError) => void;
+}
+/**
+ * Error found during code language validation
+ */
+export interface CodeLanguageError {
+    /** Relative path to the file from the manifest basePath */
+    file: string;
+    /** Absolute path to the file */
+    absolutePath: string;
+    /** Line number where the code block starts (1-indexed) */
+    line: number;
+    /** The invalid language identifier found */
+    language: string;
+    /** The full code fence line */
+    content: string;
+    /** Suggested fix if there's a known alias */
+    suggestion?: string;
+}
+/**
+ * Report from validating code block languages in a manifest
+ */
+export interface CodeLanguageValidationReport {
+    /** Package ID from the manifest */
+    packageId: string;
+    /** Number of files that were scanned */
+    filesScanned: number;
+    /** Total number of code blocks found */
+    codeBlocksFound: number;
+    /** List of validation errors found */
+    errors: CodeLanguageError[];
+    /** Total time taken for validation in milliseconds */
+    totalTime: number;
+}
+/**
+ * Options for validating code block languages
+ */
+export interface ValidateCodeLanguagesOptions {
+    /**
+     * Stop on first error.
+     * @default false
+     */
+    failFast?: boolean;
+    /**
+     * Callback invoked for each error found.
+     * Useful for real-time reporting.
+     */
+    onError?: (error: CodeLanguageError) => void;
+    /**
+     * Additional language aliases to consider valid.
+     * Maps alias to the actual Shiki language name.
+     */
+    additionalAliases?: Record<string, string>;
+    /**
+     * Additional languages to consider valid (custom grammars).
+     */
+    additionalLanguages?: string[];
+}
+/**
+ * Error found during frontmatter validation
+ */
+export interface FrontmatterError {
+    /** Relative path to the file from the manifest basePath */
+    file: string;
+    /** Absolute path to the file */
+    absolutePath: string;
+    /** Zod validation issues or parsing error message */
+    issues: string[];
+}
+/**
+ * Report from validating frontmatter in a manifest
+ */
+export interface FrontmatterValidationReport {
+    /** Package ID from the manifest */
+    packageId: string;
+    /** Number of files that were scanned */
+    filesScanned: number;
+    /** List of validation errors found */
+    errors: FrontmatterError[];
+    /** Total time taken for validation in milliseconds */
+    totalTime: number;
+}
+/**
+ * Options for validating frontmatter
+ */
+export interface ValidateFrontmatterOptions {
+    /**
+     * Stop on first error.
+     * @default false
+     */
+    failFast?: boolean;
+    /**
+     * Callback invoked for each error found.
+     * Useful for real-time reporting.
+     */
+    onError?: (error: FrontmatterError) => void;
+}
+/**
+ * Options for the unified test runner
+ */
+export interface TestRunnerOptions {
+    /**
+     * Show detailed output for all files (not just failures).
+     * @default false
+     */
+    verbose?: boolean;
+    /**
+     * Stop on first error in any validator.
+     * @default false
+     */
+    failFast?: boolean;
+    /**
+     * Auto-exit process with appropriate code after completion.
+     * @default true
+     */
+    exit?: boolean;
+    /**
+     * Suppress all console output.
+     * @default false
+     */
+    silent?: boolean;
+    /**
+     * MDX compilation options, or false to skip MDX compilation.
+     * @default true (run with default options)
+     */
+    mdx?: boolean | TestManifestOptions;
+    /**
+     * Admonition validation options, or false to skip validation.
+     * @default true (run with default options)
+     */
+    admonitions?: boolean | ValidateAdmonitionsOptions;
+    /**
+     * Code language validation options, or false to skip validation.
+     * @default true (run with default options)
+     */
+    codeLanguages?: boolean | ValidateCodeLanguagesOptions;
+    /**
+     * Frontmatter validation options, or false to skip validation.
+     * @default true (run with default options)
+     */
+    frontmatter?: boolean | ValidateFrontmatterOptions;
+}
+/**
+ * Report from the unified test runner
+ */
+export interface TestRunnerReport {
+    /** Package ID from the manifest */
+    packageId: string;
+    /** Frontmatter validation report (if run) */
+    frontmatter?: FrontmatterValidationReport;
+    /** Admonition validation report (if run) */
+    admonitions?: AdmonitionValidationReport;
+    /** Code language validation report (if run) */
+    codeLanguages?: CodeLanguageValidationReport;
+    /** MDX compilation test report (if run) */
+    mdx?: MdxTestReport;
+    /** Total number of errors across all validators */
+    totalErrors: number;
+    /** Total time taken for all validations in milliseconds */
+    totalTime: number;
+    /** Whether all validations passed */
+    success: boolean;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/testing/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,OAAO,EAAE,oBAAoB,EAAE,CAAA;IAC/B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAA;CACpF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/testing/types.ts"],"names":[],"mappings":"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"}

package/dist/testing/validate-admonitions.d.ts

@@ -0,0 +1,59 @@
+import { DocsPackageManifest } from '../types';
+import { AdmonitionValidationReport, ValidateAdmonitionsOptions } from './types';
+/**
+ * Supported admonition types in remark-directive
+ */
+export declare const ADMONITION_TYPES: readonly ["warning", "info", "tip", "note", "caution", "danger"];
+/**
+ * Pattern that matches invalid admonition syntax with space-separated labels.
+ *
+ * Valid: :::warning[Deprecated]
+ * Invalid: :::warning Deprecated
+ *
+ * This pattern captures:
+ * - Group 1: The admonition type (warning, info, tip, etc.)
+ * - Group 2: The label text (everything after the space until end of line)
+ */
+export declare const INVALID_ADMONITION_PATTERN: RegExp;
+/**
+ * Validate admonition syntax in all MDX files of a manifest.
+ *
+ * The remark-directive v4 plugin requires square bracket syntax for labels:
+ * - Valid: `:::warning[Deprecated]`
+ * - Invalid: `:::warning Deprecated`
+ *
+ * This function scans all MDX files in the manifest and reports any
+ * admonitions using the invalid space-separated label syntax.
+ *
+ * @param manifest - The documentation package manifest to validate
+ * @param options - Optional configuration for validation
+ * @returns A report containing all validation errors
+ *
+ * @example
+ * ```typescript
+ * import { manifest } from '../src/manifest'
+ * import { validateAdmonitions, formatAdmonitionReport } from '@vendure-io/docs-provider/testing'
+ *
+ * const report = validateAdmonitions(manifest)
+ *
+ * if (report.errors.length > 0) {
+ *   console.error(formatAdmonitionReport(report))
+ *   process.exit(1)
+ * }
+ * ```
+ */
+export declare function validateAdmonitions(manifest: DocsPackageManifest, options?: ValidateAdmonitionsOptions): AdmonitionValidationReport;
+/**
+ * Format an admonition validation report for console output.
+ *
+ * @param report - The validation report to format
+ * @returns A formatted string suitable for console output
+ *
+ * @example
+ * ```typescript
+ * const report = validateAdmonitions(manifest)
+ * console.log(formatAdmonitionReport(report))
+ * ```
+ */
+export declare function formatAdmonitionReport(report: AdmonitionValidationReport): string;
+//# sourceMappingURL=validate-admonitions.d.ts.map

package/dist/testing/validate-admonitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-admonitions.d.ts","sourceRoot":"","sources":["../../src/testing/validate-admonitions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD,OAAO,KAAK,EAEV,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,eAAO,MAAM,gBAAgB,kEAAmE,CAAA;AAEhG;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,QAEtC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,CAAC,EAAE,0BAA0B,GACnC,0BAA0B,CAuD5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CAsCjF"}

package/dist/testing/validate-code-languages.d.ts

@@ -0,0 +1,86 @@
+import { DocsPackageManifest } from '../types';
+import { CodeLanguageValidationReport, ValidateCodeLanguagesOptions } from './types';
+/**
+ * Shiki bundled languages (as of shiki v3.22.0)
+ * This list includes both primary language identifiers and their aliases.
+ *
+ * @see https://shiki.style/languages
+ */
+export declare const SHIKI_BUNDLED_LANGUAGES: Set<string>;
+/**
+ * Common language aliases that are NOT in Shiki's bundle but are commonly used.
+ * These map to their correct Shiki language name.
+ */
+export declare const LANGUAGE_ALIASES: Record<string, string>;
+/**
+ * Validate code block languages in all MDX files of a manifest.
+ *
+ * This function scans all MDX files in the manifest and reports any
+ * code blocks using unsupported language identifiers that Shiki
+ * cannot highlight.
+ *
+ * @param manifest - The documentation package manifest to validate
+ * @param options - Optional configuration for validation
+ * @returns A report containing all validation errors
+ *
+ * @example
+ * ```typescript
+ * import { manifest } from '../src/manifest'
+ * import { validateCodeLanguages, formatCodeLanguageReport } from '@vendure-io/docs-provider/testing'
+ *
+ * const report = validateCodeLanguages(manifest)
+ *
+ * if (report.errors.length > 0) {
+ *   console.error(formatCodeLanguageReport(report))
+ *   process.exit(1)
+ * }
+ * ```
+ */
+export declare function validateCodeLanguages(manifest: DocsPackageManifest, options?: ValidateCodeLanguagesOptions): CodeLanguageValidationReport;
+/**
+ * Check if a single language identifier is valid.
+ *
+ * @param language - The language identifier to check
+ * @param options - Optional additional aliases and languages
+ * @returns True if the language is supported, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { isValidCodeLanguage } from '@vendure-io/docs-provider/testing'
+ *
+ * console.log(isValidCodeLanguage('typescript')) // true
+ * console.log(isValidCodeLanguage('env'))        // false (use 'dotenv')
+ * console.log(isValidCodeLanguage('foobar'))     // false
+ * ```
+ */
+export declare function isValidCodeLanguage(language: string, options?: Pick<ValidateCodeLanguagesOptions, 'additionalAliases' | 'additionalLanguages'>): boolean;
+/**
+ * Get the canonical Shiki language name for an alias.
+ *
+ * @param language - The language identifier (may be an alias)
+ * @returns The canonical language name, or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * import { getCanonicalLanguage } from '@vendure-io/docs-provider/testing'
+ *
+ * console.log(getCanonicalLanguage('ts'))   // 'typescript' (Shiki handles this)
+ * console.log(getCanonicalLanguage('env'))  // 'dotenv'
+ * console.log(getCanonicalLanguage('foo'))  // undefined
+ * ```
+ */
+export declare function getCanonicalLanguage(language: string): string | undefined;
+/**
+ * Format a code language validation report for console output.
+ *
+ * @param report - The validation report to format
+ * @returns A formatted string suitable for console output
+ *
+ * @example
+ * ```typescript
+ * const report = validateCodeLanguages(manifest)
+ * console.log(formatCodeLanguageReport(report))
+ * ```
+ */
+export declare function formatCodeLanguageReport(report: CodeLanguageValidationReport): string;
+//# sourceMappingURL=validate-code-languages.d.ts.map

package/dist/testing/validate-code-languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-code-languages.d.ts","sourceRoot":"","sources":["../../src/testing/validate-code-languages.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD,OAAO,KAAK,EAEV,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,SAAS,CAAA;AAEhB;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,aA0UlC,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUnD,CAAA;AAaD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,CAAC,EAAE,4BAA4B,GACrC,4BAA4B,CAiF9B;AAgDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,4BAA4B,EAAE,mBAAmB,GAAG,qBAAqB,CAAC,GACxF,OAAO,CAwBT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAczE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,4BAA4B,GAAG,MAAM,CAmDrF"}

package/dist/testing/validate-frontmatter.d.ts

@@ -0,0 +1,40 @@
+import { DocsPackageManifest } from '../types';
+import { FrontmatterValidationReport, ValidateFrontmatterOptions } from './types';
+/**
+ * Validate frontmatter in all MDX files of a manifest.
+ *
+ * This function scans all MDX files in the manifest and validates their
+ * frontmatter against the DocPageMeta schema using Zod.
+ *
+ * @param manifest - The documentation package manifest to validate
+ * @param options - Optional configuration for validation
+ * @returns A report containing all validation errors
+ *
+ * @example
+ * ```typescript
+ * import { manifest } from '../src/manifest'
+ * import { validateFrontmatter, formatFrontmatterReport } from '@vendure-io/docs-provider/testing'
+ *
+ * const report = validateFrontmatter(manifest)
+ *
+ * if (report.errors.length > 0) {
+ *   console.error(formatFrontmatterReport(report))
+ *   process.exit(1)
+ * }
+ * ```
+ */
+export declare function validateFrontmatter(manifest: DocsPackageManifest, options?: ValidateFrontmatterOptions): FrontmatterValidationReport;
+/**
+ * Format a frontmatter validation report for console output.
+ *
+ * @param report - The validation report to format
+ * @returns A formatted string suitable for console output
+ *
+ * @example
+ * ```typescript
+ * const report = validateFrontmatter(manifest)
+ * console.log(formatFrontmatterReport(report))
+ * ```
+ */
+export declare function formatFrontmatterReport(report: FrontmatterValidationReport): string;
+//# sourceMappingURL=validate-frontmatter.d.ts.map

package/dist/testing/validate-frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-frontmatter.d.ts","sourceRoot":"","sources":["../../src/testing/validate-frontmatter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD,OAAO,KAAK,EAEV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,CAAC,EAAE,0BAA0B,GACnC,2BAA2B,CA6C7B;AAoCD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,2BAA2B,GAAG,MAAM,CA0CnF"}

package/dist/testing.cjs

@@ -1,4 +1,14 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k=require("@mdx-js/mdx"),F=require("rehype-slug"),w=require("remark-directive"),M=require("remark-gfm"),p=require("unist-util-visit"),x=require("fs/promises"),R=require("./manifest-BkO3d77g.cjs"),$={info:"info",note:"note",tip:"tip",warning:"warning",caution:"caution",danger:"danger"},D={info:"Info",note:"Note",tip:"Tip",warning:"Warning",caution:"Caution",danger:"Danger"},I=()=>s=>{p.visit(s,"containerDirective",t=>{var a;const e=t.name.toLowerCase();if(!(e in $))return;const i=$[e];let r;if(t.children.length>0){const l=t.children[0];if(l.type==="paragraph"&&"data"in l&&((a=l.data)==null?void 0:a.directiveLabel)===!0){const u=[];for(const o of l.children)o.type==="text"&&u.push(o.value);u.length>0&&(r=u.join("")),t.children=t.children.slice(1)}}const n=r||D[e],c=t.data||(t.data={});c.hName="Callout",c.hProperties={type:i,title:n}})};function E(){return s=>{p.visit(s,"code",t=>{if(!t.meta)return;const e=t.meta.match(/(?:title|filename)=["']([^"']+)["']/);if(!e)return;const i=e[1];t.value.trim().startsWith("// filename:")||(t.value=`// filename: ${i}
-${t.value}`)})}}const S=()=>s=>{const t=[];p.visit(s,"html",(e,i,r)=>{i!==void 0&&r&&typeof e.value=="string"&&e.value.trim().startsWith("<!--")&&e.value.trim().endsWith("-->")&&t.push(i)});for(const e of t.reverse())s.children.splice(e,1)},b=["@theme/Tabs","@theme/TabItem"],C=()=>s=>{const t=[];p.visit(s,"mdxjsEsm",e=>{const i=e.value;b.some(n=>i.includes(`from '${n}'`)||i.includes(`from "${n}"`))&&t.push(e)});for(const e of t){const i=s.children.indexOf(e);i!==-1&&s.children.splice(i,1)}};function v(){return[M,w,I,E,C,S]}function T(){return[F]}async function y(s,t,e){var c,a,l,u;const i=performance.now(),r=(e==null?void 0:e.remarkPlugins)??v(),n=(e==null?void 0:e.rehypePlugins)??T();try{return await k.compile(s,{remarkPlugins:r,rehypePlugins:n,outputFormat:"function-body",development:!1}),{filePath:t,success:!0,compilationTime:performance.now()-i}}catch(o){const f=performance.now()-i;let h="Unknown compilation error",d,g;if(o instanceof Error){h=o.message;const m=o;if(m.line!==void 0?d=m.line:((a=(c=m.position)==null?void 0:c.start)==null?void 0:a.line)!==void 0&&(d=m.position.start.line),m.column!==void 0?g=m.column:((u=(l=m.position)==null?void 0:l.start)==null?void 0:u.column)!==void 0&&(g=m.position.start.column),d===void 0){const P=h.match(/\((\d+):(\d+)\)/);P&&(d=parseInt(P[1],10),g=parseInt(P[2],10))}}return{filePath:t,success:!1,error:h,line:d,column:g,compilationTime:f}}}async function L(s,t){const e=performance.now(),i=R.getLeafNodes(s),r=[];let n=0,c=0;for(let a=0;a<i.length;a++){const l=i[a];if(!l.file)continue;const u=l.file;try{const o=await x.readFile(u,"utf-8"),f=await y(o,l.file,{remarkPlugins:t==null?void 0:t.remarkPlugins,rehypePlugins:t==null?void 0:t.rehypePlugins});if(r.push(f),f.success?n++:c++,t!=null&&t.onProgress&&t.onProgress(a+1,i.length,f),t!=null&&t.failFast&&!f.success)break}catch(o){const f=o instanceof Error?o.message:"Unknown error reading file",h={filePath:l.file,success:!1,error:`Failed to read file: ${f}`,compilationTime:0};if(r.push(h),c++,t!=null&&t.onProgress&&t.onProgress(a+1,i.length,h),t!=null&&t.failFast)break}}return{packageId:s.id,totalFiles:r.length,passed:n,failed:c,results:r,totalTime:performance.now()-e}}function q(s,t=!1){const e=[];e.push(""),e.push(`MDX Compilation Report: ${s.packageId}`),e.push("=".repeat(50)),e.push("");const i=s.totalFiles>0?(s.passed/s.totalFiles*100).toFixed(1):"0";if(e.push(`Total files: ${s.totalFiles}`),e.push(`Passed: ${s.passed} (${i}%)`),e.push(`Failed: ${s.failed}`),e.push(`Total time: ${s.totalTime.toFixed(2)}ms`),e.push(""),t){e.push("Results:"),e.push("-".repeat(50));for(const r of s.results){const n=r.success?"[PASS]":"[FAIL]",c=`(${r.compilationTime.toFixed(2)}ms)`;if(e.push(`${n} ${r.filePath} ${c}`),!r.success&&r.error){const a=r.line?` (line ${r.line}${r.column?`:${r.column}`:""})`:"";e.push(`       Error${a}: ${r.error}`)}}}else if(s.failed>0){e.push("Failures:"),e.push("-".repeat(50));for(const r of s.results.filter(n=>!n.success))if(e.push(`[FAIL] ${r.filePath}`),r.error){const n=r.line?` (line ${r.line}${r.column?`:${r.column}`:""})`:"";e.push(`       Error${n}: ${r.error}`)}}return e.push(""),s.failed===0?e.push("All MDX files compiled successfully!"):e.push(`${s.failed} file(s) failed to compile.`),e.push(""),e.join(`
-`)}function A(){return(s,t,e)=>{const i=e.success?"✓":"✗",r=(s/t*100).toFixed(0);process.stdout.write(`\r[${s}/${t}] (${r}%) ${i} ${e.filePath}`),process.stdout.write("\x1B[K"),s===t&&process.stdout.write(`
-`)}}exports.compileMdx=y;exports.createProgressReporter=A;exports.formatTestReport=q;exports.getDefaultRehypePlugins=T;exports.getDefaultRemarkPlugins=v;exports.testManifestMdx=L;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const q=require("@mdx-js/mdx"),C=require("rehype-slug"),M=require("remark-directive"),O=require("remark-gfm"),$=require("unist-util-visit"),_=require("fs/promises"),y=require("./manifest-BkO3d77g.cjs"),k=require("node:fs"),T=require("node:path"),w=require("./frontmatter-QFErVd9b.cjs"),L={info:"info",note:"note",tip:"tip",warning:"warning",caution:"caution",danger:"danger"},U={info:"Info",note:"Note",tip:"Tip",warning:"Warning",caution:"Caution",danger:"Danger"},V=()=>s=>{$.visit(s,"containerDirective",e=>{var u;const t=e.name.toLowerCase();if(!(t in L))return;const n=L[t];let r;if(e.children.length>0){const l=e.children[0];if(l.type==="paragraph"&&"data"in l&&((u=l.data)==null?void 0:u.directiveLabel)===!0){const c=[];for(const d of l.children)d.type==="text"&&c.push(d.value);c.length>0&&(r=c.join("")),e.children=e.children.slice(1)}}const a=r||U[t],i=e.data||(e.data={});i.hName="Callout",i.hProperties={type:n,title:a}})};function z(){return s=>{$.visit(s,"code",e=>{if(!e.meta)return;const t=e.meta.match(/(?:title|filename)=["']([^"']+)["']/);if(!t)return;const n=t[1];e.value.trim().startsWith("// filename:")||(e.value=`// filename: ${n}
+${e.value}`)})}}const G=()=>s=>{const e=[];$.visit(s,"html",(t,n,r)=>{n!==void 0&&r&&typeof t.value=="string"&&t.value.trim().startsWith("<!--")&&t.value.trim().endsWith("-->")&&e.push(n)});for(const t of e.reverse())s.children.splice(t,1)},B=["@theme/Tabs","@theme/TabItem"],W=()=>s=>{const e=[];$.visit(s,"mdxjsEsm",t=>{const n=t.value;B.some(a=>n.includes(`from '${a}'`)||n.includes(`from "${a}"`))&&e.push(t)});for(const t of e){const n=s.children.indexOf(t);n!==-1&&s.children.splice(n,1)}};function F(){return[O,M,V,z,W,G]}function E(){return[C]}async function A(s,e,t){var i,u,l,c;const n=performance.now(),r=(t==null?void 0:t.remarkPlugins)??F(),a=(t==null?void 0:t.rehypePlugins)??E();try{return await q.compile(s,{remarkPlugins:r,rehypePlugins:a,outputFormat:"function-body",development:!1}),{filePath:e,success:!0,compilationTime:performance.now()-n}}catch(d){const o=performance.now()-n;let h="Unknown compilation error",f,g;if(d instanceof Error){h=d.message;const m=d;if(m.line!==void 0?f=m.line:((u=(i=m.position)==null?void 0:i.start)==null?void 0:u.line)!==void 0&&(f=m.position.start.line),m.column!==void 0?g=m.column:((c=(l=m.position)==null?void 0:l.start)==null?void 0:c.column)!==void 0&&(g=m.position.start.column),f===void 0){const p=h.match(/\((\d+):(\d+)\)/);p&&(f=parseInt(p[1],10),g=parseInt(p[2],10))}}return{filePath:e,success:!1,error:h,line:f,column:g,compilationTime:o}}}async function j(s,e){const t=performance.now(),n=y.getLeafNodes(s),r=[];let a=0,i=0;for(let u=0;u<n.length;u++){const l=n[u];if(!l.file)continue;const c=l.file;try{const d=await _.readFile(c,"utf-8"),o=await A(d,l.file,{remarkPlugins:e==null?void 0:e.remarkPlugins,rehypePlugins:e==null?void 0:e.rehypePlugins});if(r.push(o),o.success?a++:i++,e!=null&&e.onProgress&&e.onProgress(u+1,n.length,o),e!=null&&e.failFast&&!o.success)break}catch(d){const o=d instanceof Error?d.message:"Unknown error reading file",h={filePath:l.file,success:!1,error:`Failed to read file: ${o}`,compilationTime:0};if(r.push(h),i++,e!=null&&e.onProgress&&e.onProgress(u+1,n.length,h),e!=null&&e.failFast)break}}return{packageId:s.id,totalFiles:r.length,passed:a,failed:i,results:r,totalTime:performance.now()-t}}const P=["warning","info","tip","note","caution","danger"],I=new RegExp(`^:::(${P.join("|")}) ([A-Z].*)$`);function S(s,e){const t=performance.now(),n=[],r=y.getLeafNodes(s);let a=0;for(const i of r){if(!i.file)continue;a++;const l=k.readFileSync(i.file,"utf-8").split(`
+`);for(let c=0;c<l.length;c++){const d=l[c],o=d.match(I);if(o){const[,h,f]=o,g={file:s.basePath?T.relative(s.basePath,i.file):i.file,absolutePath:i.file,line:c+1,column:1,content:d.trim(),admonitionType:h,label:f,suggestion:`:::${h}[${f}]`};if(n.push(g),e!=null&&e.onError&&e.onError(g),e!=null&&e.failFast&&n.length>0)return{packageId:s.id,filesScanned:a,errors:n,totalTime:performance.now()-t}}}}return{packageId:s.id,filesScanned:a,errors:n,totalTime:performance.now()-t}}function X(s){const e=[];if(e.push(""),e.push(`Admonition Syntax Report: ${s.packageId}`),e.push("=".repeat(50)),e.push(""),e.push(`Files scanned: ${s.filesScanned}`),e.push(`Errors found: ${s.errors.length}`),e.push(`Total time: ${s.totalTime.toFixed(2)}ms`),e.push(""),s.errors.length===0)return e.push("All admonitions use correct bracket syntax!"),e.push(""),e.join(`
+`);e.push("Errors:"),e.push("-".repeat(50)),e.push("");for(const t of s.errors)e.push(`  ${t.file}:${t.line}`),e.push(`    ${t.content}`),e.push(`    Fix: ${t.suggestion}`),e.push("");return e.push("Admonitions with custom titles must use bracket syntax:"),e.push("  Before: :::warning Deprecated"),e.push("  After:  :::warning[Deprecated]"),e.push(""),e.push("See: https://github.com/remarkjs/remark-directive"),e.push(""),e.join(`
+`)}const x=new Set(["abap","actionscript-3","ada","angular-html","angular-ts","apache","apex","apl","applescript","ara","asciidoc","asm","astro","awk","ballerina","bat","beancount","berry","bibtex","bicep","blade","bsl","c","c3","cadence","cairo","clarity","clojure","cmake","cobol","codeowners","codeql","coffee","common-lisp","coq","cpp","crystal","csharp","css","csv","cue","cypher","d","dart","dax","desktop","diff","docker","dotenv","dream-maker","edge","elixir","elm","emacs-lisp","erb","erlang","fennel","fish","fluent","fortran-fixed-form","fortran-free-form","fsharp","gdresource","gdscript","gdshader","genie","gherkin","git-commit","git-rebase","gleam","glimmer-js","glimmer-ts","glsl","gn","gnuplot","go","graphql","groovy","hack","haml","handlebars","haskell","haxe","hcl","hjson","hlsl","html","html-derivative","http","hurl","hxml","hy","imba","ini","java","javascript","jinja","jison","json","json5","jsonc","jsonl","jsonnet","jssm","jsx","julia","kdl","kotlin","kusto","latex","lean","less","liquid","llvm","log","logo","lua","luau","make","markdown","marko","matlab","mdc","mdx","mermaid","mipsasm","mojo","moonbit","move","narrat","nextflow","nginx","nim","nix","nushell","objective-c","objective-cpp","ocaml","odin","openscad","pascal","perl","php","pkl","plsql","po","polar","postcss","powerquery","powershell","prisma","prolog","proto","pug","puppet","purescript","python","qml","qmldir","qss","r","racket","raku","razor","reg","regexp","rel","riscv","ron","rosmsg","rst","ruby","rust","sas","sass","scala","scheme","scss","sdbl","shaderlab","shellscript","shellsession","smalltalk","solidity","soy","sparql","splunk","sql","ssh-config","stata","stylus","surrealql","svelte","swift","system-verilog","systemd","talonscript","tasl","tcl","templ","terraform","tex","toml","ts-tags","tsv","tsx","turtle","twig","typescript","typespec","typst","v","vala","vb","verilog","vhdl","viml","vue","vue-html","vue-vine","vyper","wasm","wenyan","wgsl","wikitext","wit","wolfram","xml","xsl","yaml","zenscript","zig","adoc","batch","be","1c","cdc","clj","ql","coffeescript","lisp","c++","c#","cs","cql","dockerfile","elisp","erl","ftl","f","for","f77","f90","f95","f03","f08","f18","f#","fs","tscn","tres","gd","gjs","gts","gql","hbs","hs","properties","js","cjs","mjs","fsl","jl","kt","kts","kql","lean4","makefile","md","mmd","mips","mbt","mbti","nar","nf","nu","objc","scad","pot","potx","ps","ps1","protobuf","jade","py","perl6","regex","rb","rs","1c-query","shader","bash","sh","shell","zsh","console","closure-templates","spl","styl","surql","talon","tf","tfvars","lit","ts","cts","mts","tsp","typ","cmd","vim","vimscript","vy","文言","mediawiki","wiki","wl","yml"]),v={env:"dotenv",text:"ini",plaintext:"ini",txt:"ini",plain:"ini",terminal:"shellscript",term:"shellscript",cURL:"bash",curl:"bash"},K=/^```(\w[\w+#-]*)?/;function R(s,e){const t=performance.now(),n=[],r=y.getLeafNodes(s),a=new Set(x);if(e!=null&&e.additionalLanguages)for(const c of e.additionalLanguages)a.add(c.toLowerCase());const i={...v,...e==null?void 0:e.additionalAliases};let u=0,l=0;for(const c of r){if(!c.file)continue;u++;const o=k.readFileSync(c.file,"utf-8").split(`
+`);for(let h=0;h<o.length;h++){const f=o[h],g=f.match(K);if(g){l++;const m=g[1];if(!m)continue;const p=m.toLowerCase();if(!(a.has(p)||p in i)){const b={file:s.basePath?T.relative(s.basePath,c.file):c.file,absolutePath:c.file,line:h+1,language:m,content:f.trim(),suggestion:H(p,a,i)};if(n.push(b),e!=null&&e.onError&&e.onError(b),e!=null&&e.failFast&&n.length>0)return{packageId:s.id,filesScanned:u,codeBlocksFound:l,errors:n,totalTime:performance.now()-t}}}}}return{packageId:s.id,filesScanned:u,codeBlocksFound:l,errors:n,totalTime:performance.now()-t}}function H(s,e,t){if(s in t)return`Use '${t[s]}' instead of '${s}'`;const n={typescript:"ts",javascript:"js","node.js":"javascript",nodejs:"javascript","c-sharp":"csharp","c-plus-plus":"cpp",py3:"python",python3:"python",bash4:"bash",zshell:"zsh",cfg:"ini",conf:"ini",config:"ini",env:"dotenv",".env":"dotenv"};if(s in n)return`Use '${n[s]}' instead of '${s}'`;for(const r of e)if(r.includes(s)||s.includes(r))return`Did you mean '${r}'?`}function Y(s,e){var n;const t=s.toLowerCase();return!!(x.has(t)||t in v||(n=e==null?void 0:e.additionalLanguages)!=null&&n.includes(t)||e!=null&&e.additionalAliases&&t in e.additionalAliases)}function Z(s){const e=s.toLowerCase();if(e in v)return v[e];if(x.has(e))return e}function J(s){const e=[];if(e.push(""),e.push(`Code Language Validation Report: ${s.packageId}`),e.push("=".repeat(50)),e.push(""),e.push(`Files scanned: ${s.filesScanned}`),e.push(`Code blocks found: ${s.codeBlocksFound}`),e.push(`Invalid languages: ${s.errors.length}`),e.push(`Total time: ${s.totalTime.toFixed(2)}ms`),e.push(""),s.errors.length===0)return e.push("All code blocks use valid language identifiers!"),e.push(""),e.join(`
+`);e.push("Errors:"),e.push("-".repeat(50)),e.push("");const t=new Map;for(const n of s.errors){const r=t.get(n.language)??[];r.push(n),t.set(n.language,r)}for(const[n,r]of t){const a=r[0].suggestion;e.push(`  Language: '${n}'${a?` - ${a}`:" (unsupported)"}`),e.push(`  Found in ${r.length} location(s):`);for(const i of r)e.push(`    - ${i.file}:${i.line}`);e.push("")}return e.push("Common fixes:"),e.push("  - 'env' → 'dotenv' (for .env files)"),e.push("  - 'text' → remove language or use 'ini' for config-like content"),e.push("  - 'terminal' → 'bash' or 'shell'"),e.push(""),e.push("See supported languages: https://shiki.style/languages"),e.push(""),e.join(`
+`)}function D(s,e){const t=performance.now(),n=[],r=y.getLeafNodes(s);let a=0;for(const i of r){if(!i.file)continue;a++;const u=k.readFileSync(i.file,"utf-8");try{w.parseFrontmatter(u,i.file)}catch(l){const c={file:s.basePath?T.relative(s.basePath,i.file):i.file,absolutePath:i.file,issues:Q(l)};if(n.push(c),e!=null&&e.onError&&e.onError(c),e!=null&&e.failFast&&n.length>0)return{packageId:s.id,filesScanned:a,errors:n,totalTime:performance.now()-t}}}return{packageId:s.id,filesScanned:a,errors:n,totalTime:performance.now()-t}}function Q(s){if(s instanceof w.FrontmatterParseError){const e=s.message,t=e.split(`
+`),n=[];for(const r of t){const a=r.trim();a.startsWith("- ")&&n.push(a.slice(2))}return n.length===0?[e]:n}return s instanceof Error?[s.message]:["Unknown error"]}function ee(s){const e=[];if(e.push(""),e.push(`Frontmatter Validation Report: ${s.packageId}`),e.push("=".repeat(50)),e.push(""),e.push(`Files scanned: ${s.filesScanned}`),e.push(`Errors found: ${s.errors.length}`),e.push(`Total time: ${s.totalTime.toFixed(2)}ms`),e.push(""),s.errors.length===0)return e.push("All files have valid frontmatter!"),e.push(""),e.join(`
+`);e.push("Errors:"),e.push("-".repeat(50)),e.push("");for(const t of s.errors){e.push(`  ${t.file}`);for(const n of t.issues)e.push(`    - ${n}`);e.push("")}return e.push("Frontmatter requirements:"),e.push("  - title: Required, non-empty string"),e.push("  - description: Optional string"),e.push("  - keywords: Optional array of strings"),e.push("  - sidebarLabel: Optional string"),e.push("  - hidden: Optional boolean"),e.push("  - order: Optional integer"),e.push("  - lastModified: Optional ISO 8601 datetime"),e.push(""),e.join(`
+`)}async function se(s,e){const t=performance.now(),{verbose:n=!1,failFast:r=!1,exit:a=!0,silent:i=!1,mdx:u=!0,admonitions:l=!0,codeLanguages:c=!0,frontmatter:d=!0}=e??{},o={packageId:s.id,totalErrors:0,totalTime:0,success:!0},h=()=>r&&o.totalErrors>0;if(d!==!1&&!h()){const f=typeof d=="object"?d:{};r&&(f.failFast=!0),o.frontmatter=D(s,f),o.totalErrors+=o.frontmatter.errors.length}if(l!==!1&&!h()){const f=typeof l=="object"?l:{};r&&(f.failFast=!0),o.admonitions=S(s,f),o.totalErrors+=o.admonitions.errors.length}if(c!==!1&&!h()){const f=typeof c=="object"?c:{};r&&(f.failFast=!0),o.codeLanguages=R(s,f),o.totalErrors+=o.codeLanguages.errors.length}if(u!==!1&&!h()){const f=typeof u=="object"?u:{};r&&(f.failFast=!0),o.mdx=await j(s,f),o.totalErrors+=o.mdx.failed}return o.totalTime=performance.now()-t,o.success=o.totalErrors===0,i||console.log(N(o,n)),a&&process.exit(o.success?0:1),o}function N(s,e=!1){const t=[];t.push(""),t.push(`Documentation Test Report: ${s.packageId}`),t.push("=".repeat(60)),t.push(""),t.push("Summary"),t.push("-".repeat(60));const n=[];s.frontmatter&&n.push({name:"Frontmatter",errors:s.frontmatter.errors.length,time:s.frontmatter.totalTime,details:`${s.frontmatter.filesScanned} files`}),s.admonitions&&n.push({name:"Admonitions",errors:s.admonitions.errors.length,time:s.admonitions.totalTime,details:`${s.admonitions.filesScanned} files`}),s.codeLanguages&&n.push({name:"Code Languages",errors:s.codeLanguages.errors.length,time:s.codeLanguages.totalTime,details:`${s.codeLanguages.codeBlocksFound} blocks`}),s.mdx&&n.push({name:"MDX Compilation",errors:s.mdx.failed,time:s.mdx.totalTime,details:`${s.mdx.passed}/${s.mdx.totalFiles} passed`});for(const r of n){const a=r.errors===0?"✓":"✗",i=r.errors===0?"OK":`${r.errors} error${r.errors>1?"s":""}`;t.push(`  ${a} ${r.name.padEnd(16)} ${i.padEnd(12)} (${r.details})`)}if(t.push(""),t.push(`Total errors: ${s.totalErrors}`),t.push(`Total time: ${s.totalTime.toFixed(2)}ms`),t.push(""),s.totalErrors>0||e){if(t.push("Details"),t.push("-".repeat(60)),s.frontmatter&&(s.frontmatter.errors.length>0||e))if(t.push(""),t.push("Frontmatter Validation:"),s.frontmatter.errors.length===0)t.push("  All files have valid frontmatter.");else for(const r of s.frontmatter.errors){t.push(`  [FAIL] ${r.file}`);for(const a of r.issues)t.push(`         ${a}`)}if(s.admonitions&&(s.admonitions.errors.length>0||e))if(t.push(""),t.push("Admonition Validation:"),s.admonitions.errors.length===0)t.push("  All admonitions use correct syntax.");else for(const r of s.admonitions.errors)t.push(`  [FAIL] ${r.file}:${r.line}`),t.push(`         ${r.content}`),t.push(`         Fix: ${r.suggestion}`);if(s.codeLanguages&&(s.codeLanguages.errors.length>0||e))if(t.push(""),t.push("Code Language Validation:"),s.codeLanguages.errors.length===0)t.push("  All code blocks use valid languages.");else{const r=new Map;for(const a of s.codeLanguages.errors){const i=r.get(a.language)??[];i.push(a),r.set(a.language,i)}for(const[a,i]of r){const u=i[0].suggestion;t.push(`  Language '${a}'${u?` - ${u}`:" (unsupported)"}`);for(const l of i)t.push(`    - ${l.file}:${l.line}`)}}if(s.mdx&&(s.mdx.failed>0||e)){if(t.push(""),t.push("MDX Compilation:"),s.mdx.failed===0)t.push("  All MDX files compiled successfully.");else for(const r of s.mdx.results)if(r.success)e&&t.push(`  [PASS] ${r.filePath}`);else if(t.push(`  [FAIL] ${r.filePath}`),r.error){const a=r.line?` (line ${r.line}${r.column?`:${r.column}`:""})`:"";t.push(`         Error${a}: ${r.error}`)}}}return t.push(""),s.success?t.push("✔ All documentation tests passed!"):t.push(`✖ ${s.totalErrors} error${s.totalErrors>1?"s":""} found.`),t.push(""),t.join(`
+`)}function te(s,e=!1){const t=[];t.push(""),t.push(`MDX Compilation Report: ${s.packageId}`),t.push("=".repeat(50)),t.push("");const n=s.totalFiles>0?(s.passed/s.totalFiles*100).toFixed(1):"0";if(t.push(`Total files: ${s.totalFiles}`),t.push(`Passed: ${s.passed} (${n}%)`),t.push(`Failed: ${s.failed}`),t.push(`Total time: ${s.totalTime.toFixed(2)}ms`),t.push(""),e){t.push("Results:"),t.push("-".repeat(50));for(const r of s.results){const a=r.success?"[PASS]":"[FAIL]",i=`(${r.compilationTime.toFixed(2)}ms)`;if(t.push(`${a} ${r.filePath} ${i}`),!r.success&&r.error){const u=r.line?` (line ${r.line}${r.column?`:${r.column}`:""})`:"";t.push(`       Error${u}: ${r.error}`)}}}else if(s.failed>0){t.push("Failures:"),t.push("-".repeat(50));for(const r of s.results.filter(a=>!a.success))if(t.push(`[FAIL] ${r.filePath}`),r.error){const a=r.line?` (line ${r.line}${r.column?`:${r.column}`:""})`:"";t.push(`       Error${a}: ${r.error}`)}}return t.push(""),s.failed===0?t.push("All MDX files compiled successfully!"):t.push(`${s.failed} file(s) failed to compile.`),t.push(""),t.join(`
+`)}function re(){return(s,e,t)=>{const n=t.success?"✓":"✗",r=(s/e*100).toFixed(0);process.stdout.write(`\r[${s}/${e}] (${r}%) ${n} ${t.filePath}`),process.stdout.write("\x1B[K"),s===e&&process.stdout.write(`
+`)}}exports.ADMONITION_TYPES=P;exports.INVALID_ADMONITION_PATTERN=I;exports.LANGUAGE_ALIASES=v;exports.SHIKI_BUNDLED_LANGUAGES=x;exports.compileMdx=A;exports.createProgressReporter=re;exports.formatAdmonitionReport=X;exports.formatCodeLanguageReport=J;exports.formatFrontmatterReport=ee;exports.formatTestReport=te;exports.formatTestRunnerReport=N;exports.getCanonicalLanguage=Z;exports.getDefaultRehypePlugins=E;exports.getDefaultRemarkPlugins=F;exports.isValidCodeLanguage=Y;exports.runAllTests=se;exports.testManifestMdx=j;exports.validateAdmonitions=S;exports.validateCodeLanguages=R;exports.validateFrontmatter=D;