@vizejs/vite-plugin-musea 0.0.1-alpha.11

package/README.md

@@ -0,0 +1,56 @@
+# @vizejs/vite-plugin-musea
+
+Vite plugin for Musea - Vue component gallery and documentation.
+
+## Installation
+
+```bash
+npm install @vizejs/vite-plugin-musea
+```
+
+## Usage
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite'
+import { musea } from '@vizejs/vite-plugin-musea'
+
+export default defineConfig({
+  plugins: [
+    musea({
+      // Art files pattern
+      include: '**/*.art.vue',
+      // Output directory
+      outDir: '.musea'
+    })
+  ]
+})
+```
+
+## Art File Format
+
+```vue
+<!-- Button.art.vue -->
+<art title="Button" component="./Button.vue">
+  <variant name="Primary" default>
+    <Button variant="primary">Click me</Button>
+  </variant>
+  <variant name="Disabled">
+    <Button disabled>Disabled</Button>
+  </variant>
+</art>
+```
+
+## Commands
+
+```bash
+# Start dev server
+vite dev
+
+# Build gallery
+vite build
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/cli.js

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+import { MuseaVrtRunner, generateVrtJsonReport, generateVrtReport } from "./vrt-DRwtnkE5.js";
+import fs from "node:fs";
+import path from "node:path";
+
+//#region src/cli.ts
+function parseArgs(args) {
+	const options = {
+		update: false,
+		config: "vite.config.ts",
+		output: ".vize",
+		threshold: .1,
+		json: false,
+		ci: false,
+		help: false,
+		baseUrl: "http://localhost:5173"
+	};
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		switch (arg) {
+			case "-u":
+			case "--update":
+				options.update = true;
+				break;
+			case "-c":
+			case "--config":
+				options.config = args[++i] || "vite.config.ts";
+				break;
+			case "-o":
+			case "--output":
+				options.output = args[++i] || ".vize";
+				break;
+			case "-t":
+			case "--threshold":
+				options.threshold = parseFloat(args[++i]) || .1;
+				break;
+			case "--json":
+				options.json = true;
+				break;
+			case "--ci":
+				options.ci = true;
+				break;
+			case "-b":
+			case "--base-url":
+				options.baseUrl = args[++i] || "http://localhost:5173";
+				break;
+			case "-h":
+			case "--help":
+				options.help = true;
+				break;
+		}
+	}
+	return options;
+}
+function printHelp() {
+	console.log(`
+Musea VRT - Visual Regression Testing for Component Gallery
+
+Usage:
+  musea-vrt [options]
+
+Options:
+  -u, --update         Update baseline snapshots with current screenshots
+  -c, --config <path>  Path to vite config file (default: vite.config.ts)
+  -o, --output <dir>   Output directory for reports (default: .vize)
+  -t, --threshold <n>  Diff threshold percentage (default: 0.1)
+  -b, --base-url <url> Base URL for dev server (default: http://localhost:5173)
+  --json               Output JSON report instead of HTML
+  --ci                 CI mode - exit with non-zero code on failures
+  -h, --help           Show this help message
+
+Examples:
+  # Run VRT tests
+  musea-vrt
+
+  # Update baseline snapshots
+  musea-vrt -u
+
+  # Run with custom threshold
+  musea-vrt -t 0.5
+
+  # CI mode with JSON output
+  musea-vrt --ci --json
+
+  # Custom base URL
+  musea-vrt -b http://localhost:3000
+`);
+}
+async function scanArtFiles(root) {
+	const files = [];
+	async function scan(dir) {
+		const entries = await fs.promises.readdir(dir, { withFileTypes: true });
+		for (const entry of entries) {
+			const fullPath = path.join(dir, entry.name);
+			if (entry.name === "node_modules" || entry.name === "dist") continue;
+			if (entry.isDirectory()) await scan(fullPath);
+			else if (entry.isFile() && entry.name.endsWith(".art.vue")) files.push(fullPath);
+		}
+	}
+	await scan(root);
+	return files;
+}
+async function parseArtFile(filePath) {
+	try {
+		const source = await fs.promises.readFile(filePath, "utf-8");
+		const titleMatch = source.match(/<art[^>]*\stitle=["']([^"']+)["']/);
+		const componentMatch = source.match(/<art[^>]*\scomponent=["']([^"']+)["']/);
+		const categoryMatch = source.match(/<art[^>]*\scategory=["']([^"']+)["']/);
+		const variants = [];
+		const variantRegex = /<variant\s+([^>]*)>([\s\S]*?)<\/variant>/g;
+		let match;
+		while ((match = variantRegex.exec(source)) !== null) {
+			const attrs = match[1];
+			const template = match[2].trim();
+			const nameMatch = attrs.match(/name=["']([^"']+)["']/);
+			const isDefault = /\bdefault\b/.test(attrs);
+			const skipVrt = /\bskip-vrt\b/.test(attrs);
+			if (nameMatch) variants.push({
+				name: nameMatch[1],
+				template,
+				isDefault,
+				skipVrt
+			});
+		}
+		return {
+			path: filePath,
+			metadata: {
+				title: titleMatch?.[1] || path.basename(filePath, ".art.vue"),
+				component: componentMatch?.[1],
+				category: categoryMatch?.[1],
+				tags: [],
+				status: "ready"
+			},
+			variants,
+			hasScriptSetup: /<script\s+setup/.test(source),
+			hasScript: /<script(?!\s+setup)/.test(source),
+			styleCount: (source.match(/<style/g) || []).length
+		};
+	} catch (error) {
+		console.error(`Failed to parse ${filePath}:`, error);
+		return null;
+	}
+}
+async function main() {
+	const args = process.argv.slice(2);
+	const options = parseArgs(args);
+	if (options.help) {
+		printHelp();
+		process.exit(0);
+	}
+	const cwd = process.cwd();
+	console.log("\n  Musea VRT");
+	console.log("  =========\n");
+	console.log("  Scanning for art files...");
+	const artFilePaths = await scanArtFiles(cwd);
+	if (artFilePaths.length === 0) {
+		console.log("  No art files found.\n");
+		process.exit(0);
+	}
+	console.log(`  Found ${artFilePaths.length} art file(s)\n`);
+	const artFiles = [];
+	for (const filePath of artFilePaths) {
+		const art = await parseArtFile(filePath);
+		if (art) artFiles.push(art);
+	}
+	const totalVariants = artFiles.reduce((sum, art) => sum + art.variants.filter((v) => !v.skipVrt).length, 0);
+	console.log(`  Testing ${totalVariants} variant(s) across ${artFiles.length} art file(s)\n`);
+	const vrtOptions = {
+		snapshotDir: path.join(options.output, "snapshots"),
+		threshold: options.threshold
+	};
+	const runner = new MuseaVrtRunner(vrtOptions);
+	try {
+		console.log("  Launching browser...");
+		await runner.init();
+		console.log("  Running visual regression tests...\n");
+		const results = await runner.runAllTests(artFiles, options.baseUrl);
+		const summary = runner.getSummary(results);
+		console.log("  Results:");
+		console.log(`  ---------`);
+		console.log(`    Passed:  ${summary.passed}`);
+		console.log(`    Failed:  ${summary.failed}`);
+		console.log(`    New:     ${summary.new}`);
+		console.log(`    Skipped: ${summary.skipped}`);
+		console.log(`    Total:   ${summary.total}`);
+		console.log(`    Duration: ${(summary.duration / 1e3).toFixed(2)}s\n`);
+		if (options.update) {
+			console.log("  Updating baselines...");
+			const updated = await runner.updateBaselines(results);
+			console.log(`  Updated ${updated} baseline(s)\n`);
+		}
+		const reportDir = options.output;
+		await fs.promises.mkdir(reportDir, { recursive: true });
+		if (options.json) {
+			const jsonReport = generateVrtJsonReport(results, summary);
+			const jsonPath = path.join(reportDir, "vrt-report.json");
+			await fs.promises.writeFile(jsonPath, jsonReport);
+			console.log(`  JSON report: ${jsonPath}\n`);
+		} else {
+			const htmlReport = generateVrtReport(results, summary);
+			const htmlPath = path.join(reportDir, "vrt-report.html");
+			await fs.promises.writeFile(htmlPath, htmlReport);
+			console.log(`  HTML report: ${htmlPath}\n`);
+		}
+		if (options.ci && summary.failed > 0) {
+			console.log("  CI mode: Exiting with error due to failures\n");
+			process.exit(1);
+		}
+	} catch (error) {
+		console.error("\n  Error:", error);
+		process.exit(1);
+	} finally {
+		await runner.close();
+	}
+}
+main().catch((error) => {
+	console.error("Fatal error:", error);
+	process.exit(1);
+});
+
+//#endregion
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":["args: string[]","options: CliOptions","root: string","files: string[]","dir: string","filePath: string","variants: ArtFileInfo[\"variants\"]","artFiles: ArtFileInfo[]","vrtOptions: VrtOptions"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Musea VRT CLI\n *\n * Usage:\n *   musea-vrt [options]\n *\n * Options:\n *   -u, --update     Update baseline snapshots\n *   -c, --config     Path to vite config (default: vite.config.ts)\n *   -o, --output     Output directory for reports (default: .vize)\n *   -t, --threshold  Diff threshold percentage (default: 0.1)\n *   --json           Output JSON report instead of HTML\n *   --ci             CI mode - exit with non-zero code on failures\n *   -h, --help       Show help\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { MuseaVrtRunner, generateVrtReport, generateVrtJsonReport } from \"./vrt.js\";\nimport type { ArtFileInfo, VrtOptions } from \"./types.js\";\n\ninterface CliOptions {\n  update: boolean;\n  config: string;\n  output: string;\n  threshold: number;\n  json: boolean;\n  ci: boolean;\n  help: boolean;\n  baseUrl: string;\n}\n\nfunction parseArgs(args: string[]): CliOptions {\n  const options: CliOptions = {\n    update: false,\n    config: \"vite.config.ts\",\n    output: \".vize\",\n    threshold: 0.1,\n    json: false,\n    ci: false,\n    help: false,\n    baseUrl: \"http://localhost:5173\",\n  };\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    switch (arg) {\n      case \"-u\":\n      case \"--update\":\n        options.update = true;\n        break;\n      case \"-c\":\n      case \"--config\":\n        options.config = args[++i] || \"vite.config.ts\";\n        break;\n      case \"-o\":\n      case \"--output\":\n        options.output = args[++i] || \".vize\";\n        break;\n      case \"-t\":\n      case \"--threshold\":\n        options.threshold = parseFloat(args[++i]) || 0.1;\n        break;\n      case \"--json\":\n        options.json = true;\n        break;\n      case \"--ci\":\n        options.ci = true;\n        break;\n      case \"-b\":\n      case \"--base-url\":\n        options.baseUrl = args[++i] || \"http://localhost:5173\";\n        break;\n      case \"-h\":\n      case \"--help\":\n        options.help = true;\n        break;\n    }\n  }\n\n  return options;\n}\n\nfunction printHelp(): void {\n  console.log(`\nMusea VRT - Visual Regression Testing for Component Gallery\n\nUsage:\n  musea-vrt [options]\n\nOptions:\n  -u, --update         Update baseline snapshots with current screenshots\n  -c, --config <path>  Path to vite config file (default: vite.config.ts)\n  -o, --output <dir>   Output directory for reports (default: .vize)\n  -t, --threshold <n>  Diff threshold percentage (default: 0.1)\n  -b, --base-url <url> Base URL for dev server (default: http://localhost:5173)\n  --json               Output JSON report instead of HTML\n  --ci                 CI mode - exit with non-zero code on failures\n  -h, --help           Show this help message\n\nExamples:\n  # Run VRT tests\n  musea-vrt\n\n  # Update baseline snapshots\n  musea-vrt -u\n\n  # Run with custom threshold\n  musea-vrt -t 0.5\n\n  # CI mode with JSON output\n  musea-vrt --ci --json\n\n  # Custom base URL\n  musea-vrt -b http://localhost:3000\n`);\n}\n\nasync function scanArtFiles(root: string): Promise<string[]> {\n  const files: string[] = [];\n\n  async function scan(dir: string): Promise<void> {\n    const entries = await fs.promises.readdir(dir, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = path.join(dir, entry.name);\n\n      // Skip node_modules and dist\n      if (entry.name === \"node_modules\" || entry.name === \"dist\") {\n        continue;\n      }\n\n      if (entry.isDirectory()) {\n        await scan(fullPath);\n      } else if (entry.isFile() && entry.name.endsWith(\".art.vue\")) {\n        files.push(fullPath);\n      }\n    }\n  }\n\n  await scan(root);\n  return files;\n}\n\nasync function parseArtFile(filePath: string): Promise<ArtFileInfo | null> {\n  try {\n    const source = await fs.promises.readFile(filePath, \"utf-8\");\n\n    // Simple parsing - in production, use @vizejs/native\n    const titleMatch = source.match(/<art[^>]*\\stitle=[\"']([^\"']+)[\"']/);\n    const componentMatch = source.match(/<art[^>]*\\scomponent=[\"']([^\"']+)[\"']/);\n    const categoryMatch = source.match(/<art[^>]*\\scategory=[\"']([^\"']+)[\"']/);\n\n    const variants: ArtFileInfo[\"variants\"] = [];\n    const variantRegex = /<variant\\s+([^>]*)>([\\s\\S]*?)<\\/variant>/g;\n    let match;\n\n    while ((match = variantRegex.exec(source)) !== null) {\n      const attrs = match[1];\n      const template = match[2].trim();\n\n      const nameMatch = attrs.match(/name=[\"']([^\"']+)[\"']/);\n      const isDefault = /\\bdefault\\b/.test(attrs);\n      const skipVrt = /\\bskip-vrt\\b/.test(attrs);\n\n      if (nameMatch) {\n        variants.push({\n          name: nameMatch[1],\n          template,\n          isDefault,\n          skipVrt,\n        });\n      }\n    }\n\n    return {\n      path: filePath,\n      metadata: {\n        title: titleMatch?.[1] || path.basename(filePath, \".art.vue\"),\n        component: componentMatch?.[1],\n        category: categoryMatch?.[1],\n        tags: [],\n        status: \"ready\",\n      },\n      variants,\n      hasScriptSetup: /<script\\s+setup/.test(source),\n      hasScript: /<script(?!\\s+setup)/.test(source),\n      styleCount: (source.match(/<style/g) || []).length,\n    };\n  } catch (error) {\n    console.error(`Failed to parse ${filePath}:`, error);\n    return null;\n  }\n}\n\nasync function main(): Promise<void> {\n  const args = process.argv.slice(2);\n  const options = parseArgs(args);\n\n  if (options.help) {\n    printHelp();\n    process.exit(0);\n  }\n\n  const cwd = process.cwd();\n\n  console.log(\"\\n  Musea VRT\");\n  console.log(\"  =========\\n\");\n\n  // Scan for art files\n  console.log(\"  Scanning for art files...\");\n  const artFilePaths = await scanArtFiles(cwd);\n\n  if (artFilePaths.length === 0) {\n    console.log(\"  No art files found.\\n\");\n    process.exit(0);\n  }\n\n  console.log(`  Found ${artFilePaths.length} art file(s)\\n`);\n\n  // Parse art files\n  const artFiles: ArtFileInfo[] = [];\n  for (const filePath of artFilePaths) {\n    const art = await parseArtFile(filePath);\n    if (art) {\n      artFiles.push(art);\n    }\n  }\n\n  // Count total variants\n  const totalVariants = artFiles.reduce(\n    (sum, art) => sum + art.variants.filter((v) => !v.skipVrt).length,\n    0,\n  );\n\n  console.log(`  Testing ${totalVariants} variant(s) across ${artFiles.length} art file(s)\\n`);\n\n  // Initialize VRT runner\n  const vrtOptions: VrtOptions = {\n    snapshotDir: path.join(options.output, \"snapshots\"),\n    threshold: options.threshold,\n  };\n\n  const runner = new MuseaVrtRunner(vrtOptions);\n\n  try {\n    console.log(\"  Launching browser...\");\n    await runner.init();\n\n    console.log(\"  Running visual regression tests...\\n\");\n\n    // Run tests\n    const results = await runner.runAllTests(artFiles, options.baseUrl);\n    const summary = runner.getSummary(results);\n\n    // Print results\n    console.log(\"  Results:\");\n    console.log(`  ---------`);\n    console.log(`    Passed:  ${summary.passed}`);\n    console.log(`    Failed:  ${summary.failed}`);\n    console.log(`    New:     ${summary.new}`);\n    console.log(`    Skipped: ${summary.skipped}`);\n    console.log(`    Total:   ${summary.total}`);\n    console.log(`    Duration: ${(summary.duration / 1000).toFixed(2)}s\\n`);\n\n    // Update baselines if requested\n    if (options.update) {\n      console.log(\"  Updating baselines...\");\n      const updated = await runner.updateBaselines(results);\n      console.log(`  Updated ${updated} baseline(s)\\n`);\n    }\n\n    // Generate report\n    const reportDir = options.output;\n    await fs.promises.mkdir(reportDir, { recursive: true });\n\n    if (options.json) {\n      const jsonReport = generateVrtJsonReport(results, summary);\n      const jsonPath = path.join(reportDir, \"vrt-report.json\");\n      await fs.promises.writeFile(jsonPath, jsonReport);\n      console.log(`  JSON report: ${jsonPath}\\n`);\n    } else {\n      const htmlReport = generateVrtReport(results, summary);\n      const htmlPath = path.join(reportDir, \"vrt-report.html\");\n      await fs.promises.writeFile(htmlPath, htmlReport);\n      console.log(`  HTML report: ${htmlPath}\\n`);\n    }\n\n    // CI mode - exit with error if failures\n    if (options.ci && summary.failed > 0) {\n      console.log(\"  CI mode: Exiting with error due to failures\\n\");\n      process.exit(1);\n    }\n  } catch (error) {\n    console.error(\"\\n  Error:\", error);\n    process.exit(1);\n  } finally {\n    await runner.close();\n  }\n}\n\nmain().catch((error) => {\n  console.error(\"Fatal error:\", error);\n  process.exit(1);\n});\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+import { ArtFileInfo, ArtMetadata, ArtVariant, CsfOutput, MuseaOptions, MuseaVrtRunner$1 as MuseaVrtRunner, ViewportConfig, VrtOptions, VrtResult, VrtSummary, generateVrtJsonReport$1 as generateVrtJsonReport, generateVrtReport$1 as generateVrtReport } from "./vrt-BfuTRv-J.js";
+import { Plugin } from "vite";
+
+//#region src/style-dictionary.d.ts
+/**
+* Style Dictionary integration for Musea.
+* Generates design token documentation from Style Dictionary format.
+*/
+/**
+* Design token value.
+*/
+/**
+ * Style Dictionary integration for Musea.
+ * Generates design token documentation from Style Dictionary format.
+ */
+/**
+ * Design token value.
+ */
+interface DesignToken {
+  value: string | number;
+  type?: string;
+  description?: string;
+  attributes?: Record<string, unknown>;
+}
+/**
+ * Token category (e.g., colors, spacing, typography).
+ */
+interface TokenCategory {
+  name: string;
+  tokens: Record<string, DesignToken>;
+  subcategories?: TokenCategory[];
+}
+/**
+ * Style Dictionary output format.
+ */
+interface StyleDictionaryOutput {
+  categories: TokenCategory[];
+  metadata: {
+    name: string;
+    version?: string;
+    generatedAt: string;
+  };
+}
+/**
+ * Configuration for Style Dictionary integration.
+ */
+interface StyleDictionaryConfig {
+  /**
+   * Path to tokens JSON/JS file or directory.
+   */
+  tokensPath: string;
+  /**
+   * Output format for documentation.
+   * @default 'html'
+   */
+  outputFormat?: "html" | "json" | "markdown";
+  /**
+   * Output directory for generated documentation.
+   * @default '.vize/tokens'
+   */
+  outputDir?: string;
+  /**
+   * Custom token transformations.
+   */
+  transforms?: TokenTransform[];
+}
+/**
+ * Token transformation function.
+ */
+type TokenTransform = (token: DesignToken, path: string[]) => DesignToken;
+/**
+ * Parse Style Dictionary tokens file.
+ */
+declare function parseTokens(tokensPath: string): Promise<TokenCategory[]>;
+/**
+ * Generate HTML documentation for tokens.
+ */
+declare function generateTokensHtml(categories: TokenCategory[]): string;
+/**
+ * Generate Markdown documentation for tokens.
+ */
+declare function generateTokensMarkdown(categories: TokenCategory[]): string;
+/**
+ * Style Dictionary plugin for Musea.
+ */
+declare function processStyleDictionary(config: StyleDictionaryConfig): Promise<StyleDictionaryOutput>; //#endregion
+//#region src/index.d.ts
+/**
+ * Create Musea Vite plugin.
+ */
+declare function musea(options?: MuseaOptions): Plugin[];
+
+//#endregion
+export { ArtFileInfo, ArtMetadata, ArtVariant, CsfOutput, DesignToken, MuseaOptions, MuseaVrtRunner, StyleDictionaryConfig, StyleDictionaryOutput, TokenCategory, ViewportConfig, VrtOptions, VrtResult, VrtSummary, musea as default, generateTokensHtml, generateTokensMarkdown, generateVrtJsonReport, generateVrtReport, musea, parseTokens, processStyleDictionary };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/style-dictionary.ts","../src/index.ts"],"sourcesContent":null,"mappings":";;;;;;;;;;;;;;;;;;UAWiB,WAAA;;;;EAAA,UAAA,CAAA,EAIF,MAJa,CAAA,MAIb,EAAA,OAAM,CAAA;;;;AAMrB;AAA8B,UAAb,aAAA,CAAa;EAAA,IAEL,EAAA,MAAA;EAAW,MAA1B,EAAA,MAAA,CAAA,MAAA,EAAe,WAAf,CAAA;EAAM,aACE,CAAA,EAAA,aAAA,EAAA;AAAa;;;;AAMd,UAAA,qBAAA,CACH;cAAA;;;IAWG,OAAA,CAAA,EAAA,MAAA;;;;AA2BjB;;;AAAqE,UA3BpD,qBAAA,CA2BoD;EAAW;;;;EAK1D;;;;EAAwC,YAAA,CAAA,EAAA,MAAA,GAAA,MAAA,GAAA,UAAA;;;;AAgJ9D;;;;AAkIA;eA7Re;;;AAmUf;;AACU,KA9TE,cAAA,GA8TF,CAAA,KAAA,EA9T2B,WA8T3B,EAAA,IAAA,EAAA,MAAA,EAAA,EAAA,GA9T2D,WA8T3D;;;AACA;iBA1TY,WAAA,sBAAiC,QAAQ;;;;iBAgJ/C,kBAAA,aAA+B;;AC3G/C;;AAA+B,iBD6Of,sBAAA,CC7Oe,UAAA,ED6OoB,aC7OpB,EAAA,CAAA,EAAA,MAAA;;AAA0B;;iBDmRnC,sBAAA,SACZ,wBACP,QAAQ;;;AA5WoB;;iBCuFf,KAAA,WAAe,eAAoB"}