@vizejs/vite-plugin-musea 0.243.0 → 0.263.0

package/dist/index.mjs

@@ -1,14 +1,14 @@
 import { c as createDevSessionToken, d as resolveInside, f as resolveInsideAny, h as validateDevApiRequest, i as generateGalleryScript, l as decodeUrlComponent, m as serializeScriptValue, n as generateGalleryModule, o as HttpError, p as resolveUrlPathInside, r as generateGalleryBody, s as collectRequestBody, u as parseJsonBody } from "./gallery-DIBlUrB6.mjs";
 import { i as MuseaVrtRunner, n as generateVrtJsonReport, r as generateVrtReport } from "./vrt-Cv1PK1EF.mjs";
 import { t as MuseaA11yRunner } from "./a11y-62l8G1tr.mjs";
-import { n as writeArtFile, t as generateArtFile } from "./autogen-Blm3Qy_O.mjs";
+import { n as writeArtFile, t as generateArtFile } from "./autogen-B7_TO0n5.mjs";
 import { createRequire } from "node:module";
 import { transformWithEsbuild } from "vite";
 import fs from "node:fs";
 import path from "node:path";
-import { vizeConfigStore } from "@vizejs/vite-plugin";
-import crypto from "node:crypto";
 import { fileURLToPath } from "node:url";
+import crypto from "node:crypto";
+import { VIZE_CONFIG_FILE_ENV, loadConfig, vizeConfigStore } from "@vizejs/vite-plugin";
 //#region src/native-loader.ts
 /**
 * Native binding loader for @vizejs/native.
@@ -92,15 +92,6 @@ function analyzeSfcFallback(source, _options) {
 	}
 }
 //#endregion
-//#region src/component-source.ts
-function allowedSourceRoots(root, scanRoots = []) {
-	return [...new Set([root, ...scanRoots].map((sourceRoot) => path.resolve(sourceRoot)))];
-}
-function resolveComponentSourcePath(art, artPath, sourceRoots) {
-	const componentPath = art.isInline && art.componentPath ? art.componentPath : art.metadata.component ? path.isAbsolute(art.metadata.component) ? art.metadata.component : path.resolve(path.dirname(artPath), art.metadata.component) : null;
-	return componentPath ? resolveInsideAny(sourceRoots, componentPath, "component path") : null;
-}
-//#endregion
 //#region src/utils.ts
 /**
 * Shared utility functions for the Musea Vite plugin.
@@ -178,16 +169,48 @@ async function generateStorybookFiles(artFiles, root, outDir) {
 	const binding = loadNative();
 	const outputDir = path.resolve(root, outDir);
 	await fs.promises.mkdir(outputDir, { recursive: true });
-	for (const [filePath, _art] of artFiles) try {
+	for (const [filePath, art] of artFiles) try {
 		const source = await fs.promises.readFile(filePath, "utf-8");
 		const csf = binding.artToCsf(source, { filename: filePath });
 		const outputPath = path.join(outputDir, csf.filename);
-		await fs.promises.writeFile(outputPath, csf.code, "utf-8");
+		const code = rewriteStorybookScriptImports(rewriteStorybookComponentImport(csf.code, art, filePath, outputPath), filePath, outputPath);
+		await fs.promises.writeFile(outputPath, code, "utf-8");
 		console.log(`[musea] Generated: ${path.relative(root, outputPath)}`);
 	} catch (e) {
 		console.error(`[musea] Failed to generate CSF for ${filePath}:`, e);
 	}
 }
+function rewriteStorybookComponentImport(code, art, artPath, outputPath) {
+	const component = art.isInline && art.componentPath ? art.componentPath : art.metadata.component;
+	if (!component || isBareImport(component)) return code;
+	const resolvedComponent = path.isAbsolute(component) ? component : path.resolve(path.dirname(artPath), component);
+	let relativeComponent = normalizeGlobPath(path.relative(path.dirname(outputPath), resolvedComponent));
+	if (!relativeComponent.startsWith(".")) relativeComponent = `./${relativeComponent}`;
+	return code.replace(/import\s+(__museaComponent)\s+from\s+(['"])([^'"]+)\2;/, `import $1 from $2${relativeComponent}$2;`);
+}
+function isBareImport(source) {
+	return !source.startsWith(".") && !path.isAbsolute(source);
+}
+/**
+* Rewrite relative import specifiers in the generated Storybook CSF file so that
+* imports lifted verbatim from the art file's `<script setup>` resolve against
+* the generated file's location instead of the original art file's directory.
+*
+* The `__museaComponent` import is already rebased by
+* `rewriteStorybookComponentImport` and is skipped here.
+*/
+function rewriteStorybookScriptImports(code, artPath, outputPath) {
+	const artDir = path.dirname(artPath);
+	const outDir = path.dirname(outputPath);
+	return code.replace(/(import\s+(?:[\s\S]*?)\s+from\s+)(['"])([^'"]+)\2(\s*;?)/g, (match, head, quote, specifier, tail) => {
+		if (!specifier.startsWith(".")) return match;
+		if (/\b__museaComponent\b/.test(head)) return match;
+		const resolved = path.resolve(artDir, specifier);
+		let rebased = normalizeGlobPath(path.relative(outDir, resolved));
+		if (!rebased.startsWith(".")) rebased = `./${rebased}`;
+		return `${head}${quote}${rebased}${quote}${tail}`;
+	});
+}
 function toPascalCase(str) {
 	const pascal = str.normalize("NFKD").replace(/[^\p{L}\p{N}]+/gu, " ").trim().split(/\s+/).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
 	if (!pascal) return "Variant";
@@ -211,346 +234,7 @@ function buildThemeConfig(theme) {
 	return {
 		default: themes[0].name,
 		custom
-	};
-}
-//#endregion
-//#region src/art-module.ts
-/**
-* Art module generation for Musea.
-*
-* Generates the virtual ES modules that represent parsed `.art.vue` files,
-* including variant component definitions and script setup handling.
-*/
-/**
-* Extract the content of the first <script setup> block from a Vue SFC source.
-*/
-function extractScriptSetupContent(source) {
-	return source.match(/<script\s+[^>]*setup[^>]*>([\s\S]*?)<\/script>/)?.[1]?.trim();
-}
-function extractScriptSetupIsolated(source) {
-	const match = source.match(/<script\s+([^>]*)\bsetup\b([^>]*)>/);
-	if (!match) return true;
-	const isolate = `${match[1] ?? ""} ${match[2] ?? ""}`.match(/\bisolate\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/);
-	return (isolate?.[1] ?? isolate?.[2] ?? isolate?.[3]) !== "false";
-}
-function resolveRelativeSpecifier(specifier, artDir) {
-	if (!specifier.startsWith(".")) return specifier;
-	return path.resolve(artDir, specifier);
-}
-function rewriteRelativeImportStatement(statement, artDir) {
-	return statement.replace(/\bfrom\s+(['"])([^'"]+)\1/g, (_match, quote, specifier) => `from ${quote}${resolveRelativeSpecifier(specifier, artDir)}${quote}`).replace(/^(\s*import\s+)(['"])([^'"]+)\2(\s*;?\s*)$/s, (_match, prefix, quote, specifier, suffix) => `${prefix}${quote}${resolveRelativeSpecifier(specifier, artDir)}${quote}${suffix}`);
-}
-function escapeTemplateLiteral(str) {
-	return str.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$/g, "\\$");
-}
-function countCharBalance(source, openChar, closeChar) {
-	let balance = 0;
-	for (const char of source) if (char === openChar) balance++;
-	else if (char === closeChar) balance--;
-	return balance;
-}
-function isCompleteImportStatement(statement) {
-	const trimmed = statement.trim();
-	if (!trimmed.startsWith("import ")) return false;
-	if (countCharBalance(statement, "{", "}") > 0) return false;
-	return /^import\s+[\s\S]+?\s+from\s+['"][^'"]+['"]\s*;?$/s.test(trimmed) || /^import\s+['"][^'"]+['"]\s*;?$/s.test(trimmed);
-}
-function splitTopLevelCommaList(source) {
-	const parts = [];
-	let current = "";
-	let braceDepth = 0;
-	let bracketDepth = 0;
-	let parenDepth = 0;
-	for (const char of source) {
-		if (char === "," && braceDepth === 0 && bracketDepth === 0 && parenDepth === 0) {
-			const trimmed = current.trim();
-			if (trimmed) parts.push(trimmed);
-			current = "";
-			continue;
-		}
-		current += char;
-		if (char === "{") braceDepth++;
-		else if (char === "}") braceDepth--;
-		else if (char === "[") bracketDepth++;
-		else if (char === "]") bracketDepth--;
-		else if (char === "(") parenDepth++;
-		else if (char === ")") parenDepth--;
-	}
-	const trimmed = current.trim();
-	if (trimmed) parts.push(trimmed);
-	return parts;
-}
-function collectImportedNames(statement, returnNames) {
-	const fromMatch = statement.replace(/\s+/g, " ").trim().replace(/;$/, "").match(/^import\s+(type\s+)?(.+?)\s+from\s+['"][^'"]+['"]$/);
-	if (!fromMatch) return;
-	if (fromMatch[1]) return;
-	const specifierParts = splitTopLevelCommaList(fromMatch[2].trim());
-	const defaultOrNamespace = specifierParts[0]?.trim() ?? "";
-	const trailing = specifierParts.slice(1).join(", ").trim();
-	if (defaultOrNamespace && !defaultOrNamespace.startsWith("{")) {
-		const namespaceMatch = defaultOrNamespace.match(/^\*\s+as\s+([A-Za-z_$][\w$]*)$/);
-		if (namespaceMatch) returnNames.add(namespaceMatch[1]);
-		else if (!defaultOrNamespace.startsWith("type ")) returnNames.add(defaultOrNamespace);
-	}
-	const namedBlock = defaultOrNamespace.startsWith("{") ? defaultOrNamespace : trailing.startsWith("{") ? trailing : "";
-	if (!namedBlock) return;
-	const namedContent = namedBlock.slice(1, -1);
-	for (const part of splitTopLevelCommaList(namedContent)) {
-		const trimmed = part.trim();
-		if (!trimmed || trimmed.startsWith("type ")) continue;
-		const alias = trimmed.split(/\s+as\s+/).pop()?.trim();
-		if (alias) returnNames.add(alias);
-	}
-}
-function importDeclaresName(statement, name) {
-	const names = /* @__PURE__ */ new Set();
-	collectImportedNames(statement, names);
-	return names.has(name);
-}
-function collectObjectDestructuredNames(statement, returnNames) {
-	const match = statement.match(/^(?:export\s+)?(?:const|let|var)\s+\{([\s\S]*?)\}\s*=/);
-	if (!match) return;
-	for (const part of splitTopLevelCommaList(match[1])) {
-		let name = part.trim();
-		if (!name) continue;
-		if (name.startsWith("...")) name = name.slice(3).trim();
-		else if (name.includes(":")) name = name.split(":").pop().trim();
-		else if (name.includes("=")) name = name.split("=")[0].trim();
-		if (name.includes("=")) name = name.split("=")[0].trim();
-		if (/^[A-Za-z_$][\w$]*$/.test(name)) returnNames.add(name);
-	}
-}
-function collectArrayDestructuredNames(statement, returnNames) {
-	const match = statement.match(/^(?:export\s+)?(?:const|let|var)\s+\[([\s\S]*?)\]\s*=/);
-	if (!match) return;
-	for (const part of splitTopLevelCommaList(match[1])) {
-		let name = part.trim();
-		if (!name) continue;
-		if (name.startsWith("...")) name = name.slice(3).trim();
-		if (name.includes("=")) name = name.split("=")[0].trim();
-		if (/^[A-Za-z_$][\w$]*$/.test(name)) returnNames.add(name);
-	}
-}
-function collectTopLevelReturnNames(setupBody, returnNames) {
-	let braceDepth = 0;
-	for (let i = 0; i < setupBody.length; i++) {
-		const line = setupBody[i];
-		const trimmed = line.trim();
-		if (braceDepth === 0) {
-			if (/^(?:export\s+)?(?:const|let|var)\s+\{/.test(trimmed)) {
-				const statementLines = [line];
-				let balance = countCharBalance(line, "{", "}") + countCharBalance(line, "[", "]") + countCharBalance(line, "(", ")");
-				while (balance > 0 && i + 1 < setupBody.length) {
-					i++;
-					statementLines.push(setupBody[i]);
-					balance += countCharBalance(setupBody[i], "{", "}") + countCharBalance(setupBody[i], "[", "]") + countCharBalance(setupBody[i], "(", ")");
-				}
-				collectObjectDestructuredNames(statementLines.join("\n"), returnNames);
-				continue;
-			}
-			if (/^(?:export\s+)?(?:const|let|var)\s+\[/.test(trimmed)) {
-				const statementLines = [line];
-				let balance = countCharBalance(line, "{", "}") + countCharBalance(line, "[", "]") + countCharBalance(line, "(", ")");
-				while (balance > 0 && i + 1 < setupBody.length) {
-					i++;
-					statementLines.push(setupBody[i]);
-					balance += countCharBalance(setupBody[i], "{", "}") + countCharBalance(setupBody[i], "[", "]") + countCharBalance(setupBody[i], "(", ")");
-				}
-				collectArrayDestructuredNames(statementLines.join("\n"), returnNames);
-				continue;
-			}
-			const constMatch = trimmed.match(/^(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)/);
-			if (constMatch) returnNames.add(constMatch[1]);
-			const functionMatch = trimmed.match(/^(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)\s*\(/);
-			if (functionMatch) returnNames.add(functionMatch[1]);
-			const classMatch = trimmed.match(/^(?:export\s+)?class\s+([A-Za-z_$][\w$]*)\b/);
-			if (classMatch) returnNames.add(classMatch[1]);
-		}
-		braceDepth += countCharBalance(line, "{", "}");
-	}
-}
-/**
-* Parse script setup content into imports and setup body.
-* Returns the import lines, setup body lines, and all identifiers to expose.
-*/
-function parseScriptSetupForArt(content) {
-	const lines = content.split("\n");
-	const imports = [];
-	const setupBody = [];
-	const returnNames = /* @__PURE__ */ new Set();
-	let currentImport = null;
-	const defineArtComponent = extractDefineArtComponent(content);
-	let defineArtBalance = 0;
-	for (const line of lines) {
-		const trimmed = line.trim();
-		if (defineArtBalance > 0) {
-			defineArtBalance += countCharBalance(line, "(", ")");
-			continue;
-		}
-		if (currentImport) {
-			currentImport.push(line);
-			const statement = currentImport.join("\n");
-			if (isCompleteImportStatement(statement)) {
-				imports.push(statement);
-				collectImportedNames(statement, returnNames);
-				currentImport = null;
-			}
-			continue;
-		}
-		if (trimmed.startsWith("import ")) {
-			currentImport = [line];
-			const statement = currentImport.join("\n");
-			if (isCompleteImportStatement(statement)) {
-				imports.push(statement);
-				collectImportedNames(statement, returnNames);
-				currentImport = null;
-			}
-			continue;
-		}
-		if (isDefineArtLine(trimmed)) {
-			defineArtBalance = Math.max(0, countCharBalance(line, "(", ")"));
-			continue;
-		}
-		setupBody.push(line);
-	}
-	if (currentImport) {
-		const statement = currentImport.join("\n");
-		imports.push(statement);
-		collectImportedNames(statement, returnNames);
-	}
-	collectTopLevelReturnNames(setupBody, returnNames);
-	returnNames.delete("type");
-	if (defineArtComponent.name) returnNames.delete(defineArtComponent.name);
-	return {
-		imports,
-		setupBody,
-		returnNames: [...returnNames],
-		defineArtComponentName: defineArtComponent.name,
-		defineArtComponentSource: defineArtComponent.source
-	};
-}
-function extractDefineArtComponent(content) {
-	const sourceMatch = content.match(/\bdefineArt\s*\(\s*(['"])([^'"]+)\1/);
-	if (sourceMatch) return {
-		name: componentNameFromSource(sourceMatch[2]),
-		source: sourceMatch[2]
-	};
-	return { name: content.match(/\bdefineArt\s*\(\s*([A-Za-z_$][\w$]*)/)?.[1] };
-}
-function componentNameFromSource(source) {
-	const withoutQuery = source.split(/[?#]/, 1)[0] || source;
-	const filename = path.basename(withoutQuery);
-	const extension = path.extname(filename);
-	const name = toPascalCase(extension ? filename.slice(0, -extension.length) : filename);
-	return name === "Variant" ? "MuseaComponent" : name;
-}
-function isDefineArtLine(trimmed) {
-	return /\bdefineArt\s*\(/.test(trimmed);
-}
-function generateArtModule(art, filePath, options = {}) {
-	let componentImportPath;
-	let componentTagName;
-	let componentBindingName = "__MuseaComponent";
-	const scriptSetup = art.scriptSetupContent ? parseScriptSetupForArt(art.scriptSetupContent) : null;
-	const defineArtComponentName = scriptSetup?.defineArtComponentName;
-	const defineArtComponentSource = scriptSetup?.defineArtComponentSource;
-	if (art.isInline && art.componentPath) {
-		componentImportPath = options.root ? resolveComponentSourcePath(art, filePath, allowedSourceRoots(options.root, options.scanRoots ?? [])) ?? void 0 : art.componentPath;
-		componentTagName = "MuseaComponent";
-	} else if (defineArtComponentSource || art.metadata.component) {
-		const componentSource = defineArtComponentSource ?? art.metadata.component;
-		if (componentSource) {
-			const sourceArt = componentSource === art.metadata.component ? art : {
-				...art,
-				metadata: {
-					...art.metadata,
-					component: componentSource
-				}
-			};
-			componentImportPath = options.root ? resolveComponentSourcePath(sourceArt, filePath, allowedSourceRoots(options.root, options.scanRoots ?? [])) ?? void 0 : path.isAbsolute(componentSource) ? componentSource : path.resolve(path.dirname(filePath), componentSource);
-		}
-		componentTagName = defineArtComponentName ?? (art.metadata.component ? componentNameFromSource(art.metadata.component) : "MuseaComponent");
-		componentBindingName = componentTagName;
-	}
-	let code = `
-// Auto-generated module for: ${path.basename(filePath)}
-import { defineComponent, h } from 'vue';
-`;
-	if (scriptSetup) {
-		const artDir = path.dirname(filePath);
-		for (const imp of scriptSetup.imports) {
-			const resolved = rewriteRelativeImportStatement(imp, artDir);
-			code += `${resolved}\n`;
-		}
-	}
-	if (componentImportPath && componentTagName) {
-		if (!scriptSetup?.imports.some((imp) => importDeclaresName(imp, componentBindingName))) code += `import ${componentBindingName} from ${JSON.stringify(componentImportPath)};\n`;
-		code += `export const __component__ = ${componentBindingName};\n`;
-	}
-	code += `
-export const metadata = ${JSON.stringify(art.metadata)};
-export const variants = ${JSON.stringify(art.variants)};
-export const __styles__ = ${JSON.stringify(art.styleBlocks ?? [])};
-`;
-	const hasSetupBody = scriptSetup?.setupBody.some((line) => line.trim().length > 0) ?? false;
-	const hasSetup = !!scriptSetup && (hasSetupBody || scriptSetup.returnNames.length > 0);
-	const setupReturn = `{ ${scriptSetup?.returnNames.join(", ") ?? ""} }`;
-	const isolatedSetup = art.scriptSetupIsolated !== false;
-	if (scriptSetup && hasSetup && !isolatedSetup) code += `
-const __museaSharedSetup = (() => {
-${scriptSetup.setupBody.map((l) => `  ${l}`).join("\n")}
-  return ${setupReturn};
-})();
-`;
-	for (const variant of art.variants) {
-		const variantComponentName = toPascalCase(variant.name);
-		let template = variant.template;
-		if (componentTagName) template = template.replace(/<Self/g, `<${componentTagName}`).replace(/<\/Self>/g, `</${componentTagName}>`);
-		const escapedTemplate = escapeTemplateLiteral(template);
-		const fullTemplate = `<div data-variant="${escapeTemplateLiteral(escapeHtml(variant.name))}">${escapedTemplate}</div>`;
-		const componentNames = /* @__PURE__ */ new Map();
-		if (componentTagName) componentNames.set(componentTagName, componentBindingName);
-		if (scriptSetup) {
-			for (const name of scriptSetup.returnNames) if (/^[A-Z]/.test(name)) componentNames.set(name, name);
-		}
-		const components = componentNames.size > 0 ? `  components: { ${[...componentNames].map(([name, value]) => `${JSON.stringify(name)}: ${value}`).join(", ")} },\n` : "";
-		if (scriptSetup && hasSetup && isolatedSetup) code += `
-export const ${variantComponentName} = defineComponent({
-  name: '${variantComponentName}',
-${components}  setup() {
-${scriptSetup.setupBody.map((l) => `    ${l}`).join("\n")}
-    return ${setupReturn};
-  },
-  template: \`${fullTemplate}\`,
-});
-`;
-		else if (scriptSetup && hasSetup) code += `
-export const ${variantComponentName} = defineComponent({
-  name: '${variantComponentName}',
-${components}  setup() {
-    return __museaSharedSetup;
-  },
-  template: \`${fullTemplate}\`,
-});
-`;
-		else if (componentTagName) code += `
-export const ${variantComponentName} = {
-  name: '${variantComponentName}',
-${components}  template: \`${fullTemplate}\`,
-};
-`;
-		else code += `
-export const ${variantComponentName} = {
-  name: '${variantComponentName}',
-  template: \`${fullTemplate}\`,
-};
-`;
-	}
-	const defaultVariant = art.variants.find((v) => v.isDefault) || art.variants[0];
-	if (defaultVariant) code += `
-export default ${toPascalCase(defaultVariant.name)};
-`;
-	return code;
+	};
 }
 //#endregion
 //#region src/preview/addons.ts
@@ -1169,53 +853,401 @@ function ensureArtStyles(styles) {
     document.head.appendChild(tag);
   }
 }
-
-function renderError(title, error) {
-  container.textContent = '';
-  const root = document.createElement('div');
-  root.className = 'musea-error';
-
-  const titleEl = document.createElement('div');
-  titleEl.className = 'musea-error-title';
-  titleEl.textContent = title;
-  root.appendChild(titleEl);
-
-  const messageEl = document.createElement('div');
-  messageEl.textContent = error instanceof Error ? error.message : String(error);
-  root.appendChild(messageEl);
-
-  container.appendChild(root);
+
+function renderError(title, error) {
+  container.textContent = '';
+  const root = document.createElement('div');
+  root.className = 'musea-error';
+
+  const titleEl = document.createElement('div');
+  titleEl.className = 'musea-error-title';
+  titleEl.textContent = title;
+  root.appendChild(titleEl);
+
+  const messageEl = document.createElement('div');
+  messageEl.textContent = error instanceof Error ? error.message : String(error);
+  root.appendChild(messageEl);
+
+  container.appendChild(root);
+}
+
+async function mount() {
+  try {
+    const VariantComponent = artModule[${variantComponentNameLiteral}];
+    if (!VariantComponent) {
+      throw new Error('Variant component ' + ${variantComponentNameLiteral} + ' not found');
+    }
+
+    const WrappedComponent = {
+      render() {
+        return h(VariantComponent, propsOverride);
+      }
+    };
+
+    const app = createApp(WrappedComponent);
+    ensureArtStyles(artModule.__styles__);
+    ${setupCall}
+    container.innerHTML = '';
+    container.className = 'musea-variant';
+    app.mount(container);
+    console.log('[musea-preview] Mounted variant with props override:', ${variantNameLiteral});
+    __museaInitAddons(container, ${variantNameLiteral}, ${actionEvents});
+  } catch (error) {
+    console.error('[musea-preview] Failed to mount:', error);
+    renderError('Failed to render', error);
+  }
+}
+
+mount();
+`;
+}
+//#endregion
+//#region src/component-source.ts
+function allowedSourceRoots(root, scanRoots = []) {
+	return [...new Set([root, ...scanRoots].map((sourceRoot) => path.resolve(sourceRoot)))];
+}
+function resolveComponentSourcePath(art, artPath, sourceRoots) {
+	const componentPath = art.isInline && art.componentPath ? art.componentPath : art.metadata.component ? path.isAbsolute(art.metadata.component) ? art.metadata.component : path.resolve(path.dirname(artPath), art.metadata.component) : null;
+	return componentPath ? resolveInsideAny(sourceRoots, componentPath, "component path") : null;
+}
+//#endregion
+//#region src/art-module.ts
+/**
+* Art module generation for Musea.
+*
+* Generates the virtual ES modules that represent parsed `.art.vue` files,
+* including variant component definitions and script setup handling.
+*/
+/**
+* Extract the content of the first <script setup> block from a Vue SFC source.
+*/
+function extractScriptSetupContent(source) {
+	return source.match(/<script\s+[^>]*setup[^>]*>([\s\S]*?)<\/script>/)?.[1]?.trim();
+}
+function extractScriptSetupIsolated(source) {
+	const match = source.match(/<script\s+([^>]*)\bsetup\b([^>]*)>/);
+	if (!match) return true;
+	const isolate = `${match[1] ?? ""} ${match[2] ?? ""}`.match(/\bisolate\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/);
+	return (isolate?.[1] ?? isolate?.[2] ?? isolate?.[3]) !== "false";
+}
+function resolveRelativeSpecifier(specifier, artDir) {
+	if (!specifier.startsWith(".")) return specifier;
+	return path.resolve(artDir, specifier);
+}
+function rewriteRelativeImportStatement(statement, artDir) {
+	return statement.replace(/\bfrom\s+(['"])([^'"]+)\1/g, (_match, quote, specifier) => `from ${quote}${resolveRelativeSpecifier(specifier, artDir)}${quote}`).replace(/^(\s*import\s+)(['"])([^'"]+)\2(\s*;?\s*)$/s, (_match, prefix, quote, specifier, suffix) => `${prefix}${quote}${resolveRelativeSpecifier(specifier, artDir)}${quote}${suffix}`);
+}
+function escapeTemplateLiteral(str) {
+	return str.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$/g, "\\$");
+}
+function countCharBalance(source, openChar, closeChar) {
+	let balance = 0;
+	for (const char of source) if (char === openChar) balance++;
+	else if (char === closeChar) balance--;
+	return balance;
+}
+function isCompleteImportStatement(statement) {
+	const trimmed = statement.trim();
+	if (!trimmed.startsWith("import ")) return false;
+	if (countCharBalance(statement, "{", "}") > 0) return false;
+	return /^import\s+[\s\S]+?\s+from\s+['"][^'"]+['"]\s*;?$/s.test(trimmed) || /^import\s+['"][^'"]+['"]\s*;?$/s.test(trimmed);
+}
+function splitTopLevelCommaList(source) {
+	const parts = [];
+	let current = "";
+	let braceDepth = 0;
+	let bracketDepth = 0;
+	let parenDepth = 0;
+	for (const char of source) {
+		if (char === "," && braceDepth === 0 && bracketDepth === 0 && parenDepth === 0) {
+			const trimmed = current.trim();
+			if (trimmed) parts.push(trimmed);
+			current = "";
+			continue;
+		}
+		current += char;
+		if (char === "{") braceDepth++;
+		else if (char === "}") braceDepth--;
+		else if (char === "[") bracketDepth++;
+		else if (char === "]") bracketDepth--;
+		else if (char === "(") parenDepth++;
+		else if (char === ")") parenDepth--;
+	}
+	const trimmed = current.trim();
+	if (trimmed) parts.push(trimmed);
+	return parts;
+}
+function collectImportedNames(statement, returnNames) {
+	const fromMatch = statement.replace(/\s+/g, " ").trim().replace(/;$/, "").match(/^import\s+(type\s+)?(.+?)\s+from\s+['"][^'"]+['"]$/);
+	if (!fromMatch) return;
+	if (fromMatch[1]) return;
+	const specifierParts = splitTopLevelCommaList(fromMatch[2].trim());
+	const defaultOrNamespace = specifierParts[0]?.trim() ?? "";
+	const trailing = specifierParts.slice(1).join(", ").trim();
+	if (defaultOrNamespace && !defaultOrNamespace.startsWith("{")) {
+		const namespaceMatch = defaultOrNamespace.match(/^\*\s+as\s+([A-Za-z_$][\w$]*)$/);
+		if (namespaceMatch) returnNames.add(namespaceMatch[1]);
+		else if (!defaultOrNamespace.startsWith("type ")) returnNames.add(defaultOrNamespace);
+	}
+	const namedBlock = defaultOrNamespace.startsWith("{") ? defaultOrNamespace : trailing.startsWith("{") ? trailing : "";
+	if (!namedBlock) return;
+	const namedContent = namedBlock.slice(1, -1);
+	for (const part of splitTopLevelCommaList(namedContent)) {
+		const trimmed = part.trim();
+		if (!trimmed || trimmed.startsWith("type ")) continue;
+		const alias = trimmed.split(/\s+as\s+/).pop()?.trim();
+		if (alias) returnNames.add(alias);
+	}
+}
+function importDeclaresName(statement, name) {
+	const names = /* @__PURE__ */ new Set();
+	collectImportedNames(statement, names);
+	return names.has(name);
+}
+function collectObjectDestructuredNames(statement, returnNames) {
+	const match = statement.match(/^(?:export\s+)?(?:const|let|var)\s+\{([\s\S]*?)\}\s*=/);
+	if (!match) return;
+	for (const part of splitTopLevelCommaList(match[1])) {
+		let name = part.trim();
+		if (!name) continue;
+		if (name.startsWith("...")) name = name.slice(3).trim();
+		else if (name.includes(":")) name = name.split(":").pop().trim();
+		else if (name.includes("=")) name = name.split("=")[0].trim();
+		if (name.includes("=")) name = name.split("=")[0].trim();
+		if (/^[A-Za-z_$][\w$]*$/.test(name)) returnNames.add(name);
+	}
+}
+function collectArrayDestructuredNames(statement, returnNames) {
+	const match = statement.match(/^(?:export\s+)?(?:const|let|var)\s+\[([\s\S]*?)\]\s*=/);
+	if (!match) return;
+	for (const part of splitTopLevelCommaList(match[1])) {
+		let name = part.trim();
+		if (!name) continue;
+		if (name.startsWith("...")) name = name.slice(3).trim();
+		if (name.includes("=")) name = name.split("=")[0].trim();
+		if (/^[A-Za-z_$][\w$]*$/.test(name)) returnNames.add(name);
+	}
+}
+function collectTopLevelReturnNames(setupBody, returnNames) {
+	let braceDepth = 0;
+	for (let i = 0; i < setupBody.length; i++) {
+		const line = setupBody[i];
+		const trimmed = line.trim();
+		if (braceDepth === 0) {
+			if (/^(?:export\s+)?(?:const|let|var)\s+\{/.test(trimmed)) {
+				const statementLines = [line];
+				let balance = countCharBalance(line, "{", "}") + countCharBalance(line, "[", "]") + countCharBalance(line, "(", ")");
+				while (balance > 0 && i + 1 < setupBody.length) {
+					i++;
+					statementLines.push(setupBody[i]);
+					balance += countCharBalance(setupBody[i], "{", "}") + countCharBalance(setupBody[i], "[", "]") + countCharBalance(setupBody[i], "(", ")");
+				}
+				collectObjectDestructuredNames(statementLines.join("\n"), returnNames);
+				continue;
+			}
+			if (/^(?:export\s+)?(?:const|let|var)\s+\[/.test(trimmed)) {
+				const statementLines = [line];
+				let balance = countCharBalance(line, "{", "}") + countCharBalance(line, "[", "]") + countCharBalance(line, "(", ")");
+				while (balance > 0 && i + 1 < setupBody.length) {
+					i++;
+					statementLines.push(setupBody[i]);
+					balance += countCharBalance(setupBody[i], "{", "}") + countCharBalance(setupBody[i], "[", "]") + countCharBalance(setupBody[i], "(", ")");
+				}
+				collectArrayDestructuredNames(statementLines.join("\n"), returnNames);
+				continue;
+			}
+			const constMatch = trimmed.match(/^(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)/);
+			if (constMatch) returnNames.add(constMatch[1]);
+			const functionMatch = trimmed.match(/^(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)\s*\(/);
+			if (functionMatch) returnNames.add(functionMatch[1]);
+			const classMatch = trimmed.match(/^(?:export\s+)?class\s+([A-Za-z_$][\w$]*)\b/);
+			if (classMatch) returnNames.add(classMatch[1]);
+		}
+		braceDepth += countCharBalance(line, "{", "}");
+	}
+}
+/**
+* Parse script setup content into imports and setup body.
+* Returns the import lines, setup body lines, and all identifiers to expose.
+*/
+function parseScriptSetupForArt(content) {
+	const lines = content.split("\n");
+	const imports = [];
+	const setupBody = [];
+	const returnNames = /* @__PURE__ */ new Set();
+	let currentImport = null;
+	const defineArtComponent = extractDefineArtComponent(content);
+	let defineArtBalance = 0;
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (defineArtBalance > 0) {
+			defineArtBalance += countCharBalance(line, "(", ")");
+			continue;
+		}
+		if (currentImport) {
+			currentImport.push(line);
+			const statement = currentImport.join("\n");
+			if (isCompleteImportStatement(statement)) {
+				imports.push(statement);
+				collectImportedNames(statement, returnNames);
+				currentImport = null;
+			}
+			continue;
+		}
+		if (trimmed.startsWith("import ")) {
+			currentImport = [line];
+			const statement = currentImport.join("\n");
+			if (isCompleteImportStatement(statement)) {
+				imports.push(statement);
+				collectImportedNames(statement, returnNames);
+				currentImport = null;
+			}
+			continue;
+		}
+		if (isDefineArtLine(trimmed)) {
+			defineArtBalance = Math.max(0, countCharBalance(line, "(", ")"));
+			continue;
+		}
+		setupBody.push(line);
+	}
+	if (currentImport) {
+		const statement = currentImport.join("\n");
+		imports.push(statement);
+		collectImportedNames(statement, returnNames);
+	}
+	collectTopLevelReturnNames(setupBody, returnNames);
+	returnNames.delete("type");
+	if (defineArtComponent.name) returnNames.delete(defineArtComponent.name);
+	return {
+		imports,
+		setupBody,
+		returnNames: [...returnNames],
+		defineArtComponentName: defineArtComponent.name,
+		defineArtComponentSource: defineArtComponent.source
+	};
+}
+function extractDefineArtComponent(content) {
+	const sourceMatch = content.match(/\bdefineArt\s*\(\s*(['"])([^'"]+)\1/);
+	if (sourceMatch) return {
+		name: componentNameFromSource(sourceMatch[2]),
+		source: sourceMatch[2]
+	};
+	return { name: content.match(/\bdefineArt\s*\(\s*([A-Za-z_$][\w$]*)/)?.[1] };
 }
-
-async function mount() {
-  try {
-    const VariantComponent = artModule[${variantComponentNameLiteral}];
-    if (!VariantComponent) {
-      throw new Error('Variant component ' + ${variantComponentNameLiteral} + ' not found');
-    }
-
-    const WrappedComponent = {
-      render() {
-        return h(VariantComponent, propsOverride);
-      }
-    };
-
-    const app = createApp(WrappedComponent);
-    ensureArtStyles(artModule.__styles__);
-    ${setupCall}
-    container.innerHTML = '';
-    container.className = 'musea-variant';
-    app.mount(container);
-    console.log('[musea-preview] Mounted variant with props override:', ${variantNameLiteral});
-    __museaInitAddons(container, ${variantNameLiteral}, ${actionEvents});
-  } catch (error) {
-    console.error('[musea-preview] Failed to mount:', error);
-    renderError('Failed to render', error);
-  }
+function componentNameFromSource(source) {
+	const withoutQuery = source.split(/[?#]/, 1)[0] || source;
+	const filename = path.basename(withoutQuery);
+	const extension = path.extname(filename);
+	const name = toPascalCase(extension ? filename.slice(0, -extension.length) : filename);
+	return name === "Variant" ? "MuseaComponent" : name;
 }
-
-mount();
+function isDefineArtLine(trimmed) {
+	return /\bdefineArt\s*\(/.test(trimmed);
+}
+function generateArtModule(art, filePath, options = {}) {
+	let componentImportPath;
+	let componentTagName;
+	let componentBindingName = "__MuseaComponent";
+	const scriptSetup = art.scriptSetupContent ? parseScriptSetupForArt(art.scriptSetupContent) : null;
+	const defineArtComponentName = scriptSetup?.defineArtComponentName;
+	const defineArtComponentSource = scriptSetup?.defineArtComponentSource;
+	if (art.isInline && art.componentPath) {
+		componentImportPath = options.root ? resolveComponentSourcePath(art, filePath, allowedSourceRoots(options.root, options.scanRoots ?? [])) ?? void 0 : art.componentPath;
+		componentTagName = "MuseaComponent";
+	} else if (defineArtComponentSource || art.metadata.component) {
+		const componentSource = defineArtComponentSource ?? art.metadata.component;
+		if (componentSource) {
+			const sourceArt = componentSource === art.metadata.component ? art : {
+				...art,
+				metadata: {
+					...art.metadata,
+					component: componentSource
+				}
+			};
+			componentImportPath = options.root ? resolveComponentSourcePath(sourceArt, filePath, allowedSourceRoots(options.root, options.scanRoots ?? [])) ?? void 0 : path.isAbsolute(componentSource) ? componentSource : path.resolve(path.dirname(filePath), componentSource);
+		}
+		componentTagName = defineArtComponentName ?? (art.metadata.component ? componentNameFromSource(art.metadata.component) : "MuseaComponent");
+		componentBindingName = componentTagName;
+	}
+	let code = `
+// Auto-generated module for: ${path.basename(filePath)}
+import { defineComponent, h } from 'vue';
+`;
+	if (scriptSetup) {
+		const artDir = path.dirname(filePath);
+		for (const imp of scriptSetup.imports) {
+			const resolved = rewriteRelativeImportStatement(imp, artDir);
+			code += `${resolved}\n`;
+		}
+	}
+	if (componentImportPath && componentTagName) {
+		if (!scriptSetup?.imports.some((imp) => importDeclaresName(imp, componentBindingName))) code += `import ${componentBindingName} from ${JSON.stringify(componentImportPath)};\n`;
+		code += `export const __component__ = ${componentBindingName};\n`;
+	}
+	code += `
+export const metadata = ${JSON.stringify(art.metadata)};
+export const variants = ${JSON.stringify(art.variants)};
+export const __styles__ = ${JSON.stringify(art.styleBlocks ?? [])};
+`;
+	const hasSetupBody = scriptSetup?.setupBody.some((line) => line.trim().length > 0) ?? false;
+	const hasSetup = !!scriptSetup && (hasSetupBody || scriptSetup.returnNames.length > 0);
+	const setupReturn = `{ ${scriptSetup?.returnNames.join(", ") ?? ""} }`;
+	const isolatedSetup = art.scriptSetupIsolated !== false;
+	if (scriptSetup && hasSetup && !isolatedSetup) code += `
+const __museaSharedSetup = (() => {
+${scriptSetup.setupBody.map((l) => `  ${l}`).join("\n")}
+  return ${setupReturn};
+})();
+`;
+	for (const variant of art.variants) {
+		const variantComponentName = toPascalCase(variant.name);
+		let template = variant.template;
+		if (componentTagName) template = template.replace(/<Self/g, `<${componentTagName}`).replace(/<\/Self>/g, `</${componentTagName}>`);
+		const escapedTemplate = escapeTemplateLiteral(template);
+		const fullTemplate = `<div data-variant="${escapeTemplateLiteral(escapeHtml(variant.name))}">${escapedTemplate}</div>`;
+		const componentNames = /* @__PURE__ */ new Map();
+		if (componentTagName) componentNames.set(componentTagName, componentBindingName);
+		if (scriptSetup) {
+			for (const name of scriptSetup.returnNames) if (/^[A-Z]/.test(name)) componentNames.set(name, name);
+		}
+		const components = componentNames.size > 0 ? `  components: { ${[...componentNames].map(([name, value]) => `${JSON.stringify(name)}: ${value}`).join(", ")} },\n` : "";
+		if (scriptSetup && hasSetup && isolatedSetup) code += `
+export const ${variantComponentName} = defineComponent({
+  name: '${variantComponentName}',
+${components}  setup() {
+${scriptSetup.setupBody.map((l) => `    ${l}`).join("\n")}
+    return ${setupReturn};
+  },
+  template: \`${fullTemplate}\`,
+});
+`;
+		else if (scriptSetup && hasSetup) code += `
+export const ${variantComponentName} = defineComponent({
+  name: '${variantComponentName}',
+${components}  setup() {
+    return __museaSharedSetup;
+  },
+  template: \`${fullTemplate}\`,
+});
+`;
+		else if (componentTagName) code += `
+export const ${variantComponentName} = {
+  name: '${variantComponentName}',
+${components}  template: \`${fullTemplate}\`,
+};
+`;
+		else code += `
+export const ${variantComponentName} = {
+  name: '${variantComponentName}',
+  template: \`${fullTemplate}\`,
+};
+`;
+	}
+	const defaultVariant = art.variants.find((v) => v.isDefault) || art.variants[0];
+	if (defaultVariant) code += `
+export default ${toPascalCase(defaultVariant.name)};
 `;
+	return code;
 }
 //#endregion
 //#region src/server-middleware.ts
@@ -2109,7 +2141,9 @@ async function processStyleDictionary(config) {
 //#endregion
 //#region src/api-tokens.ts
 function resolveTokensPath(ctx) {
-	return resolveInside(ctx.config.root, ctx.tokensPath, "tokensPath");
+	const allowedRoots = [ctx.config.root, ...ctx.scanRoots];
+	if (ctx.projectRoot) allowedRoots.push(ctx.projectRoot);
+	return resolveInsideAny(allowedRoots, ctx.tokensPath, "tokensPath");
 }
 function sendTokenMutationError(e, sendError) {
 	if (e instanceof HttpError) {
@@ -2894,6 +2928,71 @@ function watchMuseaArtFiles(watcher, files) {
 	watcher.add(targets);
 }
 //#endregion
+//#region src/plugin/vue-alias.ts
+const require = createRequire(import.meta.url);
+function createVueRuntimeCompilerAlias() {
+	return {
+		find: /^vue$/,
+		replacement: resolveVueRuntimeCompiler()
+	};
+}
+function resolveVueRuntimeCompiler() {
+	try {
+		return require.resolve("vue/dist/vue.esm-bundler.js");
+	} catch {
+		return "vue/dist/vue.esm-bundler.js";
+	}
+}
+//#endregion
+//#region src/plugin/storybook-inputs.ts
+function isStorybookTsxInput(filePath) {
+	return /\.(?:stories|story)\.tsx$/i.test(filePath);
+}
+async function scanStorybookTsxInputs(root, include, exclude) {
+	const files = /* @__PURE__ */ new Set();
+	const visitedDirs = /* @__PURE__ */ new Set();
+	async function scan(dir) {
+		const resolvedDir = path.resolve(dir);
+		if (visitedDirs.has(resolvedDir)) return;
+		visitedDirs.add(resolvedDir);
+		let entries;
+		try {
+			entries = await fs.promises.readdir(resolvedDir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			const fullPath = path.join(resolvedDir, entry.name);
+			if (isExcluded(fullPath, entry.name, exclude, root)) continue;
+			if (entry.isDirectory()) await scan(fullPath);
+			else if (entry.isFile() && isStorybookTsxInput(entry.name) && shouldProcess(fullPath, include, exclude, root)) files.add(fullPath);
+		}
+	}
+	for (const scanRoot of resolveScanRoots(root, include)) await scan(scanRoot);
+	return [...files].sort();
+}
+async function assertNoUnsupportedStorybookTsxInputs(root, include, exclude) {
+	const files = await scanStorybookTsxInputs(root, include, exclude);
+	if (files.length > 0) throw new Error(formatUnsupportedStorybookTsxInputError(root, files));
+}
+function formatUnsupportedStorybookTsxInputError(root, files) {
+	return [
+		"[musea] Storybook TSX files matched by include are not supported as Musea art inputs yet.",
+		"Remove *.stories.tsx from musea.include or migrate those stories to .art.vue files.",
+		"Matched files:",
+		`${files.slice(0, 5).map((file) => `  - ${relativePath(root, file)}`).join("\n")}${files.length > 5 ? `\n  ... and ${files.length - 5} more` : ""}`
+	].join("\n");
+}
+function isExcluded(filePath, name, exclude, root) {
+	return exclude.some((pattern) => matchesPathPattern(filePath, pattern, root) || matchGlob(name, pattern));
+}
+function matchesPathPattern(filePath, pattern, root) {
+	return matchGlob(path.isAbsolute(pattern) ? path.resolve(filePath) : path.relative(root, filePath), pattern);
+}
+function relativePath(root, filePath) {
+	return path.relative(root, filePath).split(path.sep).join("/");
+}
+//#endregion
 //#region src/static-data.ts
 function staticPreviewId(artPath, variantName) {
 	return crypto.createHash("sha256").update(artPath).update("\0").update(variantName).digest("hex").slice(0, 20);
@@ -2952,6 +3051,7 @@ function createApiContext(ctx) {
 		artFiles: ctx.artFiles,
 		scanRoots: ctx.scanRoots,
 		tokensPath: ctx.tokensPath,
+		projectRoot: ctx.projectRoot,
 		basePath: ctx.basePath,
 		resolvedPreviewCss: ctx.resolvedPreviewCss,
 		resolvedPreviewSetup: ctx.resolvedPreviewSetup,
@@ -3032,6 +3132,9 @@ const moduleDir = path.dirname(fileURLToPath(import.meta.url));
 function isMuseaStaticBuild() {
 	return process.env[MUSEA_STATIC_BUILD_ENV] === "1";
 }
+function shouldEnableMuseaStaticBuild(command) {
+	return isMuseaStaticBuild() || command === "build";
+}
 function museaStaticBuildInput(input) {
 	const entries = {};
 	if (typeof input === "string") entries[STATIC_USER_INPUT_NAME] = input;
@@ -3047,6 +3150,9 @@ function applyMuseaStaticBuildInput(options) {
 	options.input = museaStaticBuildInput(options.input);
 	return null;
 }
+function museaStaticBuildConfig(input) {
+	return { build: { rollupOptions: { input: museaStaticBuildInput(input) } } };
+}
 function resolveStaticRuntimeId(id) {
 	return id === "virtual:musea-static-runtime" ? RESOLVED_STATIC_RUNTIME : null;
 }
@@ -3233,15 +3339,27 @@ function relativeUrl(fromDir, toFile) {
 	return relative.startsWith(".") ? relative : `./${relative}`;
 }
 //#endregion
-//#region src/plugin/index.ts
-const require = createRequire(import.meta.url);
-function resolveVueRuntimeCompiler() {
+//#region src/plugin/config.ts
+async function resolveMuseaSharedConfig(resolvedConfig) {
+	const sharedConfig = vizeConfigStore.get(resolvedConfig.root);
+	if (sharedConfig) return sharedConfig;
+	const configFile = process.env[VIZE_CONFIG_FILE_ENV];
+	if (!configFile) return null;
 	try {
-		return require.resolve("vue/dist/vue.esm-bundler.js");
-	} catch {
-		return "vue/dist/vue.esm-bundler.js";
+		return await loadConfig(resolvedConfig.root, {
+			configFile,
+			env: {
+				mode: resolvedConfig.mode,
+				command: resolvedConfig.command === "build" ? "build" : "serve",
+				isSsrBuild: !!resolvedConfig.build?.ssr
+			}
+		});
+	} catch (error) {
+		throw new Error(`[musea] Failed to load Vize config from ${configFile}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
 	}
 }
+//#endregion
+//#region src/plugin/art-processing.ts
 function extractArtTagAttributes(source) {
 	const artTagMatch = source.match(/<art\b([\s\S]*?)>/i);
 	if (!artTagMatch) return {};
@@ -3277,6 +3395,62 @@ function extractStyleBlocks(source) {
 	}
 	return styles;
 }
+function formatArtProcessingError(root, filePath, error) {
+	const detail = error instanceof Error ? error.message || error.name : error == null ? "unknown error" : stringifyUnknown(error);
+	return `[musea] Failed to process ${path.relative(root, filePath) || filePath}: ${detail}`;
+}
+function stringifyUnknown(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return value.toString();
+	try {
+		return JSON.stringify(value) ?? "unknown error";
+	} catch {
+		return "unknown error";
+	}
+}
+async function processMuseaArtFile(filePath, ctx) {
+	try {
+		const source = await fs.promises.readFile(filePath, "utf-8");
+		const parsed = loadNative().parseArt(source, { filename: filePath });
+		const customMetadata = extractCustomArtMetadata(source);
+		if (!parsed.variants || parsed.variants.length === 0) return null;
+		const isInline = !filePath.endsWith(".art.vue");
+		return {
+			path: filePath,
+			metadata: {
+				title: parsed.metadata.title || (isInline ? path.basename(filePath, ".vue") : ""),
+				description: parsed.metadata.description,
+				component: isInline ? void 0 : parsed.metadata.component,
+				category: parsed.metadata.category,
+				tags: parsed.metadata.tags,
+				status: parsed.metadata.status,
+				order: parsed.metadata.order,
+				actionEvents: customMetadata.actionEvents ?? parsed.metadata.actionEvents
+			},
+			variants: parsed.variants.map((v) => ({
+				name: v.name,
+				template: v.template,
+				isDefault: v.isDefault,
+				skipVrt: v.skipVrt
+			})),
+			hasScriptSetup: isInline ? false : parsed.hasScriptSetup,
+			scriptSetupContent: !isInline && parsed.hasScriptSetup ? extractScriptSetupContent(source) : void 0,
+			scriptSetupIsolated: !isInline && parsed.hasScriptSetup ? extractScriptSetupIsolated(source) : true,
+			hasScript: parsed.hasScript,
+			styleCount: parsed.styleCount,
+			styleBlocks: isInline ? [] : extractStyleBlocks(source),
+			isInline,
+			componentPath: isInline ? filePath : void 0
+		};
+	} catch (error) {
+		const message = formatArtProcessingError(ctx.root, filePath, error);
+		if (ctx.command === "build") throw new Error(message);
+		(ctx.onError ?? console.error)(message);
+		return null;
+	}
+}
+//#endregion
+//#region src/plugin/index.ts
 function musea(options = {}) {
 	let include = options.include ?? ["**/*.art.vue"];
 	let exclude = options.exclude ?? ["node_modules/**", "dist/**"];
@@ -3285,6 +3459,7 @@ function musea(options = {}) {
 	const storybookOutDir = options.storybookOutDir ?? ".storybook/stories";
 	let inlineArt = options.inlineArt ?? false;
 	const tokensPath = options.tokensPath;
+	const projectRootOption = options.projectRoot;
 	const themeConfig = buildThemeConfig(options.theme);
 	const previewCss = options.previewCss ?? [];
 	const previewSetup = options.previewSetup;
@@ -3295,6 +3470,7 @@ function musea(options = {}) {
 	let resolvedPreviewCss = [];
 	let resolvedPreviewSetup = null;
 	let scanRoots = [];
+	let staticBuildEnabled = isMuseaStaticBuild();
 	const virtualState = {
 		basePath,
 		get inlineArt() {
@@ -3316,13 +3492,18 @@ function musea(options = {}) {
 		apply(_config, env) {
 			return shouldApplyMuseaPlugin(env);
 		},
-		config() {
-			return { resolve: { alias: { vue: resolveVueRuntimeCompiler() } } };
+		config(userConfig, env) {
+			staticBuildEnabled = shouldEnableMuseaStaticBuild(env.command);
+			const staticBuildConfig = staticBuildEnabled ? museaStaticBuildConfig(userConfig.build?.rollupOptions?.input) : {};
+			return {
+				resolve: { alias: [createVueRuntimeCompilerAlias()] },
+				...staticBuildConfig
+			};
 		},
 		options: applyMuseaStaticBuildInput,
-		configResolved(resolvedConfig) {
+		async configResolved(resolvedConfig) {
 			config = resolvedConfig;
-			const vizeConfig = vizeConfigStore.get(resolvedConfig.root);
+			const vizeConfig = await resolveMuseaSharedConfig(resolvedConfig);
 			if (vizeConfig?.musea) {
 				const mc = vizeConfig.musea;
 				if (!options.include && mc.include) include = mc.include;
@@ -3354,6 +3535,7 @@ function musea(options = {}) {
 				artFiles,
 				scanRoots,
 				tokensPath,
+				projectRoot: resolveProjectRoot(projectRootOption, config.root),
 				basePath,
 				resolvedPreviewCss,
 				resolvedPreviewSetup,
@@ -3401,7 +3583,12 @@ function musea(options = {}) {
 					if (address && typeof address === "object") {
 						const protocol = devServer.config.server.https ? "https" : "http";
 						const rawHost = address.address;
-						const url = `${protocol}://${rawHost === "::" || rawHost === "::1" || rawHost === "0.0.0.0" || rawHost === "127.0.0.1" ? "localhost" : rawHost}:${address.port}${basePath}`;
+						const url = `${protocol}://${[
+							"::",
+							"::1",
+							"0.0.0.0",
+							"127.0.0.1"
+						].includes(rawHost) ? "localhost" : rawHost}:${address.port}${basePath}`;
 						console.log();
 						console.log(`  \x1b[36m➜\x1b[0m  \x1b[1mMusea Gallery:\x1b[0m \x1b[36m${url}\x1b[0m`);
 					}
@@ -3410,6 +3597,7 @@ function musea(options = {}) {
 		},
 		async buildStart() {
 			console.log(`[musea] config.root: ${config.root}, include: ${JSON.stringify(include)}`);
+			if (storybookCompat && staticBuildEnabled) await assertNoUnsupportedStorybookTsxInputs(config.root, include, exclude);
 			const files = await scanArtFiles(config.root, include, exclude, inlineArt);
 			console.log(`[musea] Found ${files.length} art files`);
 			if (server) watchMuseaArtFiles(server.watcher, files);
@@ -3423,12 +3611,13 @@ function musea(options = {}) {
 			return loadStaticRuntimeModule(id, artFiles) ?? virtualLoad(id);
 		},
 		async generateBundle(_options, bundle) {
-			if (!isMuseaStaticBuild()) return;
+			if (!staticBuildEnabled) return;
 			await emitStaticGallery((asset) => void this.emitFile(asset), bundle, {
 				config,
 				artFiles,
 				scanRoots,
 				tokensPath,
+				projectRoot: resolveProjectRoot(projectRootOption, config.root),
 				basePath,
 				resolvedPreviewCss,
 				resolvedPreviewSetup,
@@ -3450,46 +3639,19 @@ function musea(options = {}) {
 		handleHotUpdate: createHandleHotUpdate(virtualState)
 	};
 	async function processArtFile(filePath) {
-		try {
-			const source = await fs.promises.readFile(filePath, "utf-8");
-			const parsed = loadNative().parseArt(source, { filename: filePath });
-			const customMetadata = extractCustomArtMetadata(source);
-			if (!parsed.variants || parsed.variants.length === 0) return;
-			const isInline = !filePath.endsWith(".art.vue");
-			const info = {
-				path: filePath,
-				metadata: {
-					title: parsed.metadata.title || (isInline ? path.basename(filePath, ".vue") : ""),
-					description: parsed.metadata.description,
-					component: isInline ? void 0 : parsed.metadata.component,
-					category: parsed.metadata.category,
-					tags: parsed.metadata.tags,
-					status: parsed.metadata.status,
-					order: parsed.metadata.order,
-					actionEvents: customMetadata.actionEvents ?? parsed.metadata.actionEvents
-				},
-				variants: parsed.variants.map((v) => ({
-					name: v.name,
-					template: v.template,
-					isDefault: v.isDefault,
-					skipVrt: v.skipVrt
-				})),
-				hasScriptSetup: isInline ? false : parsed.hasScriptSetup,
-				scriptSetupContent: !isInline && parsed.hasScriptSetup ? extractScriptSetupContent(source) : void 0,
-				scriptSetupIsolated: !isInline && parsed.hasScriptSetup ? extractScriptSetupIsolated(source) : true,
-				hasScript: parsed.hasScript,
-				styleCount: parsed.styleCount,
-				styleBlocks: isInline ? [] : extractStyleBlocks(source),
-				isInline,
-				componentPath: isInline ? filePath : void 0
-			};
-			artFiles.set(filePath, info);
-		} catch (e) {
-			console.error(`[musea] Failed to process ${filePath}:`, e);
-		}
+		const info = await processMuseaArtFile(filePath, {
+			root: config.root,
+			command: config.command
+		});
+		if (info) artFiles.set(filePath, info);
 	}
 	return [mainPlugin];
 }
+function resolveProjectRoot(projectRoot, viteRoot) {
+	if (!projectRoot) return void 0;
+	const absolute = path.isAbsolute(projectRoot) ? projectRoot : path.resolve(viteRoot, projectRoot);
+	return absolute === path.resolve(viteRoot) ? void 0 : absolute;
+}
 //#endregion
 //#region src/index.ts
 var src_default = musea;