vize 0.291.0 → 0.303.0

package/dist/{config-D1BwAgHh.mjs → config-CqEev07u.mjs}

@@ -1,12 +1,12 @@
 import { createRequire } from "node:module";
-import * as fs from "node:fs";
-import * as path from "node:path";
+import * as fs$1 from "node:fs";
+import * as path$1 from "node:path";
 import { randomUUID } from "node:crypto";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { transform } from "oxc-transform";
 import { execFileSync } from "node:child_process";
 //#region src/config/pkl.js
-const PACKAGE_ROOT$1 = path.resolve(fileURLToPath(new URL(".", import.meta.url)), "../..");
+const PACKAGE_ROOT$1 = path$1.resolve(fileURLToPath(new URL(".", import.meta.url)), "../..");
 const DOCUMENTED_PKL_SCHEMA_IMPORT_RE = /^(\s*(?:amends|import)\s+)(["'])node_modules\/vize\/pkl\/(VizeConfig\.pkl|vize\.pkl)\2/gm;
 /**
 * Evaluate a `vize.config.pkl` file and return its JSON representation.
@@ -33,7 +33,7 @@ function loadPklConfigJson(filePath) {
 			"json",
 			evalFilePath
 		], {
-			cwd: path.dirname(filePath),
+			cwd: path$1.dirname(filePath),
 			encoding: "utf-8",
 			stdio: [
 				"ignore",
@@ -45,21 +45,21 @@ function loadPklConfigJson(filePath) {
 	} catch (error) {
 		throw new Error(`Failed to evaluate vize PKL config at ${filePath}: ${getErrorMessage$1(error)}`);
 	} finally {
-		if (patchedFilePath) fs.rmSync(patchedFilePath, { force: true });
+		if (patchedFilePath) fs$1.rmSync(patchedFilePath, { force: true });
 	}
 }
 function findPklBinary() {
 	try {
 		const pklPkgPath = import.meta.resolve?.("@pkl-community/pkl");
 		if (pklPkgPath) {
-			const pklLibDir = path.dirname(fileURLToPath(pklPkgPath));
-			const pklPackageDir = path.dirname(pklLibDir);
+			const pklLibDir = path$1.dirname(fileURLToPath(pklPkgPath));
+			const pklPackageDir = path$1.dirname(pklLibDir);
 			const candidates = [
-				path.join(pklLibDir, "main.js"),
-				path.join(pklPackageDir, "pkl"),
-				path.join(pklPackageDir, "pkl.exe")
+				path$1.join(pklLibDir, "main.js"),
+				path$1.join(pklPackageDir, "pkl"),
+				path$1.join(pklPackageDir, "pkl.exe")
 			];
-			for (const candidate of candidates) if (fs.existsSync(candidate)) try {
+			for (const candidate of candidates) if (fs$1.existsSync(candidate)) try {
 				execFileSync(candidate, ["--version"], { stdio: "ignore" });
 				return candidate;
 			} catch {}
@@ -73,20 +73,20 @@ function findPklBinary() {
 	}
 }
 function createPklConfigWithBundledSchemaImports(filePath) {
-	const configDir = path.dirname(filePath);
-	const source = fs.readFileSync(filePath, "utf-8");
+	const configDir = path$1.dirname(filePath);
+	const source = fs$1.readFileSync(filePath, "utf-8");
 	let patched = false;
 	const content = source.replace(DOCUMENTED_PKL_SCHEMA_IMPORT_RE, (match, prefix, quote, schemaFile) => {
-		const projectSchemaPath = path.join(configDir, "node_modules", "vize", "pkl", schemaFile);
-		if (fs.existsSync(projectSchemaPath)) return match;
-		const bundledSchemaPath = path.join(PACKAGE_ROOT$1, "pkl", schemaFile);
-		if (!fs.existsSync(bundledSchemaPath)) return match;
+		const projectSchemaPath = path$1.join(configDir, "node_modules", "vize", "pkl", schemaFile);
+		if (fs$1.existsSync(projectSchemaPath)) return match;
+		const bundledSchemaPath = path$1.join(PACKAGE_ROOT$1, "pkl", schemaFile);
+		if (!fs$1.existsSync(bundledSchemaPath)) return match;
 		patched = true;
 		return `${prefix}${quote}${pathToFileURL(bundledSchemaPath).href}${quote}`;
 	});
 	if (!patched) return null;
-	const tempFile = path.join(configDir, `.vize-config-${process.pid}-${Date.now()}-${randomUUID()}.pkl`);
-	fs.writeFileSync(tempFile, content, {
+	const tempFile = path$1.join(configDir, `.vize-config-${process.pid}-${Date.now()}-${randomUUID()}.pkl`);
+	fs$1.writeFileSync(tempFile, content, {
 		flag: "wx",
 		mode: 384
 	});
@@ -110,9 +110,9 @@ const DEFAULT_CONFIG_ENV = {
 	mode: "development",
 	command: "serve"
 };
-const PACKAGE_ROOT = path.resolve(fileURLToPath(new URL(".", import.meta.url)), "..");
-const VIZE_CONFIG_JSON_SCHEMA_PATH = path.join(PACKAGE_ROOT, "schemas", "vize.config.schema.json");
-const VIZE_CONFIG_PKL_SCHEMA_PATH = path.join(PACKAGE_ROOT, "pkl", "vize.pkl");
+const PACKAGE_ROOT = path$1.resolve(fileURLToPath(new URL(".", import.meta.url)), "..");
+const VIZE_CONFIG_JSON_SCHEMA_PATH = path$1.join(PACKAGE_ROOT, "schemas", "vize.config.schema.json");
+const VIZE_CONFIG_PKL_SCHEMA_PATH = path$1.join(PACKAGE_ROOT, "pkl", "vize.pkl");
 /**
 * Define a Vize configuration with type checking.
 * Accepts a plain object or a function that receives ConfigEnv.
@@ -127,8 +127,8 @@ async function loadConfig(root, options = {}) {
 	const { mode = "root", configFile, env } = options;
 	if (mode === "none") return null;
 	if (configFile) {
-		const absolutePath = path.isAbsolute(configFile) ? configFile : path.resolve(root, configFile);
-		if (fs.existsSync(absolutePath)) return loadConfigFile(absolutePath, env);
+		const absolutePath = path$1.isAbsolute(configFile) ? configFile : path$1.resolve(root, configFile);
+		if (fs$1.existsSync(absolutePath)) return loadConfigFile(absolutePath, env);
 		return null;
 	}
 	if (mode === "auto") return loadConfigFromDirAuto(root, env);
@@ -136,29 +136,29 @@ async function loadConfig(root, options = {}) {
 }
 async function loadConfigFromDir(dir, env) {
 	for (const name of CONFIG_FILE_NAMES) {
-		const filePath = path.join(dir, name);
-		if (!fs.existsSync(filePath)) continue;
+		const filePath = path$1.join(dir, name);
+		if (!fs$1.existsSync(filePath)) continue;
 		const config = await loadConfigFile(filePath, env);
 		if (config !== null) return config;
 	}
 	return null;
 }
 async function loadConfigFromDirAuto(startDir, env) {
-	let currentDir = path.resolve(startDir);
+	let currentDir = path$1.resolve(startDir);
 	while (true) {
 		const config = await loadConfigFromDir(currentDir, env);
 		if (config !== null) return config;
-		const parentDir = path.dirname(currentDir);
+		const parentDir = path$1.dirname(currentDir);
 		if (parentDir === currentDir) return null;
 		currentDir = parentDir;
 	}
 }
 async function loadConfigFile(filePath, env) {
-	const absolutePath = path.resolve(filePath);
-	if (!fs.existsSync(absolutePath)) return null;
-	const ext = path.extname(absolutePath);
+	const absolutePath = path$1.resolve(filePath);
+	if (!fs$1.existsSync(absolutePath)) return null;
+	const ext = path$1.extname(absolutePath);
 	if (ext === ".pkl") return loadPklConfig(absolutePath);
-	if (ext === ".json") return parseJsonConfig(fs.readFileSync(absolutePath, "utf-8"), absolutePath);
+	if (ext === ".json") return parseJsonConfig(fs$1.readFileSync(absolutePath, "utf-8"), absolutePath);
 	if (ext === ".ts") return loadTypeScriptConfig(absolutePath, env);
 	return loadESMConfig(absolutePath, env);
 }
@@ -171,9 +171,9 @@ async function resolveConfigExport(exported, env) {
 	return normalizeLoadedConfig(exported);
 }
 async function loadTypeScriptConfig(filePath, env) {
-	const result = await transform(filePath, fs.readFileSync(filePath, "utf-8"), { typescript: { onlyRemoveTypeImports: true } });
-	const tempFile = path.join(path.dirname(filePath), `.vize-config-${process.pid}-${Date.now()}-${randomUUID()}.mjs`);
-	fs.writeFileSync(tempFile, result.code, {
+	const result = await transform(filePath, fs$1.readFileSync(filePath, "utf-8"), { typescript: { onlyRemoveTypeImports: true } });
+	const tempFile = path$1.join(path$1.dirname(filePath), `.vize-config-${process.pid}-${Date.now()}-${randomUUID()}.mjs`);
+	fs$1.writeFileSync(tempFile, result.code, {
 		flag: "wx",
 		mode: 384
 	});
@@ -181,7 +181,7 @@ async function loadTypeScriptConfig(filePath, env) {
 		const module = await importFresh(tempFile);
 		return resolveConfigExport(module.default || module, env);
 	} finally {
-		fs.rmSync(tempFile, { force: true });
+		fs$1.rmSync(tempFile, { force: true });
 	}
 }
 async function loadESMConfig(filePath, env) {
@@ -190,7 +190,7 @@ async function loadESMConfig(filePath, env) {
 }
 async function importFresh(filePath) {
 	const fileUrl = pathToFileURL(filePath);
-	fileUrl.searchParams.set("t", String(fs.statSync(filePath).mtimeMs));
+	fileUrl.searchParams.set("t", String(fs$1.statSync(filePath).mtimeMs));
 	return import(fileUrl.href);
 }
 function parseJsonConfig(content, filePath) {
@@ -220,4 +220,4 @@ function normalizeGlobalTypes(config) {
 //#endregion
 export { loadConfig as a, defineConfig as i, VIZE_CONFIG_JSON_SCHEMA_PATH as n, normalizeGlobalTypes as o, VIZE_CONFIG_PKL_SCHEMA_PATH as r, resolveConfigExport as s, CONFIG_FILE_NAMES as t };
 
-//# sourceMappingURL=config-D1BwAgHh.mjs.map
+//# sourceMappingURL=config-CqEev07u.mjs.map

package/dist/config-CqEev07u.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-CqEev07u.mjs","names":["PACKAGE_ROOT","path","getErrorMessage","fs","path","fs"],"sources":["../src/config/pkl.js","../src/config.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { execFileSync } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\n\nconst PACKAGE_ROOT = path.resolve(fileURLToPath(new URL(\".\", import.meta.url)), \"../..\");\n\nconst DOCUMENTED_PKL_SCHEMA_IMPORT_RE =\n  /^(\\s*(?:amends|import)\\s+)([\"'])node_modules\\/vize\\/pkl\\/(VizeConfig\\.pkl|vize\\.pkl)\\2/gm;\n\n/**\n * Evaluate a `vize.config.pkl` file and return its JSON representation.\n *\n * The npm-facing loader keeps PKL execution in Node because it needs package\n * resolution for `@pkl-community/pkl`, but all structural config normalization\n * happens in Rust after this function returns. A missing PKL runtime returns\n * `null` so config discovery can fall through to lower-priority formats; an\n * evaluation failure throws because a present PKL config should not silently be\n * ignored.\n */\nexport function loadPklConfigJson(filePath) {\n  const pklBin = findPklBinary();\n  if (!pklBin) {\n    console.warn(\n      \"[vize] pkl CLI not found. Install @pkl-community/pkl or add pkl to PATH. \" +\n        \"Falling back to the next config format.\",\n    );\n    return null;\n  }\n\n  const patchedFilePath = createPklConfigWithBundledSchemaImports(filePath);\n  const evalFilePath = patchedFilePath ?? filePath;\n  try {\n    return execFileSync(pklBin, [\"eval\", \"-f\", \"json\", evalFilePath], {\n      cwd: path.dirname(filePath),\n      encoding: \"utf-8\",\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      timeout: 30_000,\n    });\n  } catch (error) {\n    throw new Error(`Failed to evaluate vize PKL config at ${filePath}: ${getErrorMessage(error)}`);\n  } finally {\n    if (patchedFilePath) {\n      fs.rmSync(patchedFilePath, { force: true });\n    }\n  }\n}\n\nfunction findPklBinary() {\n  try {\n    const pklPkgPath = import.meta.resolve?.(\"@pkl-community/pkl\");\n    if (pklPkgPath) {\n      const pklLibDir = path.dirname(fileURLToPath(pklPkgPath));\n      const pklPackageDir = path.dirname(pklLibDir);\n      const candidates = [\n        path.join(pklLibDir, \"main.js\"),\n        path.join(pklPackageDir, \"pkl\"),\n        path.join(pklPackageDir, \"pkl.exe\"),\n      ];\n\n      for (const candidate of candidates) {\n        if (fs.existsSync(candidate)) {\n          try {\n            execFileSync(candidate, [\"--version\"], { stdio: \"ignore\" });\n            return candidate;\n          } catch {\n            // Keep looking: the shim can exist when its runtime is unavailable.\n          }\n        }\n      }\n    }\n  } catch {\n    // Fall back to PATH below.\n  }\n\n  try {\n    execFileSync(\"pkl\", [\"--version\"], { stdio: \"ignore\" });\n    return \"pkl\";\n  } catch {\n    return null;\n  }\n}\n\nfunction createPklConfigWithBundledSchemaImports(filePath) {\n  const configDir = path.dirname(filePath);\n  const source = fs.readFileSync(filePath, \"utf-8\");\n  let patched = false;\n\n  const content = source.replace(\n    DOCUMENTED_PKL_SCHEMA_IMPORT_RE,\n    (match, prefix, quote, schemaFile) => {\n      const projectSchemaPath = path.join(configDir, \"node_modules\", \"vize\", \"pkl\", schemaFile);\n      if (fs.existsSync(projectSchemaPath)) {\n        return match;\n      }\n\n      const bundledSchemaPath = path.join(PACKAGE_ROOT, \"pkl\", schemaFile);\n      if (!fs.existsSync(bundledSchemaPath)) {\n        return match;\n      }\n\n      patched = true;\n      return `${prefix}${quote}${pathToFileURL(bundledSchemaPath).href}${quote}`;\n    },\n  );\n\n  if (!patched) {\n    return null;\n  }\n\n  const tempFile = path.join(\n    configDir,\n    `.vize-config-${process.pid}-${Date.now()}-${randomUUID()}.pkl`,\n  );\n  fs.writeFileSync(tempFile, content, { flag: \"wx\", mode: 0o600 });\n  return tempFile;\n}\n\nfunction getErrorMessage(error) {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n","import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport { createRequire } from \"node:module\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { transform } from \"oxc-transform\";\nimport type {\n  ResolvedVizeConfig,\n  LoadConfigOptions,\n  UserConfigExport,\n  ConfigEnv,\n  GlobalTypesConfig,\n  GlobalTypeDeclaration,\n} from \"./types/index.js\";\nimport { loadPklConfigJson } from \"./config/pkl.js\";\n\ntype NativeConfigHelpers = {\n  normalizeVizeConfig(value: unknown): unknown;\n};\n\nconst require = createRequire(import.meta.url);\nconst native = require(\"@vizejs/native\") as NativeConfigHelpers;\n\nexport const CONFIG_FILE_NAMES = [\n  \"vize.config.pkl\",\n  \"vize.config.ts\",\n  \"vize.config.js\",\n  \"vize.config.mjs\",\n  \"vize.config.json\",\n] as const;\n\nconst DEFAULT_CONFIG_ENV: ConfigEnv = {\n  mode: \"development\",\n  command: \"serve\",\n};\n\nconst PACKAGE_ROOT = path.resolve(fileURLToPath(new URL(\".\", import.meta.url)), \"..\");\n\nexport const VIZE_CONFIG_JSON_SCHEMA_PATH = path.join(\n  PACKAGE_ROOT,\n  \"schemas\",\n  \"vize.config.schema.json\",\n);\n\nexport const VIZE_CONFIG_PKL_SCHEMA_PATH = path.join(PACKAGE_ROOT, \"pkl\", \"vize.pkl\");\n\n/**\n * Define a Vize configuration with type checking.\n * Accepts a plain object or a function that receives ConfigEnv.\n */\nexport function defineConfig(config: UserConfigExport): UserConfigExport {\n  return config;\n}\n\n/**\n * Load `vize.config.*` from the specified directory.\n */\nexport async function loadConfig(\n  root: string,\n  options: LoadConfigOptions = {},\n): Promise<ResolvedVizeConfig | null> {\n  const { mode = \"root\", configFile, env } = options;\n\n  if (mode === \"none\") {\n    return null;\n  }\n\n  if (configFile) {\n    const absolutePath = path.isAbsolute(configFile) ? configFile : path.resolve(root, configFile);\n    if (fs.existsSync(absolutePath)) {\n      return loadConfigFile(absolutePath, env);\n    }\n    return null;\n  }\n\n  if (mode === \"auto\") {\n    return loadConfigFromDirAuto(root, env);\n  }\n\n  return loadConfigFromDir(root, env);\n}\n\nasync function loadConfigFromDir(dir: string, env?: ConfigEnv): Promise<ResolvedVizeConfig | null> {\n  for (const name of CONFIG_FILE_NAMES) {\n    const filePath = path.join(dir, name);\n    if (!fs.existsSync(filePath)) {\n      continue;\n    }\n\n    const config = await loadConfigFile(filePath, env);\n    if (config !== null) {\n      return config;\n    }\n  }\n  return null;\n}\n\nasync function loadConfigFromDirAuto(\n  startDir: string,\n  env?: ConfigEnv,\n): Promise<ResolvedVizeConfig | null> {\n  let currentDir = path.resolve(startDir);\n\n  while (true) {\n    const config = await loadConfigFromDir(currentDir, env);\n    if (config !== null) {\n      return config;\n    }\n\n    const parentDir = path.dirname(currentDir);\n    if (parentDir === currentDir) {\n      return null;\n    }\n\n    currentDir = parentDir;\n  }\n}\n\nasync function loadConfigFile(\n  filePath: string,\n  env?: ConfigEnv,\n): Promise<ResolvedVizeConfig | null> {\n  const absolutePath = path.resolve(filePath);\n  if (!fs.existsSync(absolutePath)) {\n    return null;\n  }\n\n  const ext = path.extname(absolutePath);\n\n  if (ext === \".pkl\") {\n    return loadPklConfig(absolutePath);\n  }\n\n  if (ext === \".json\") {\n    const content = fs.readFileSync(absolutePath, \"utf-8\");\n    return parseJsonConfig(content, absolutePath);\n  }\n\n  if (ext === \".ts\") {\n    return loadTypeScriptConfig(absolutePath, env);\n  }\n\n  return loadESMConfig(absolutePath, env);\n}\n\nfunction loadPklConfig(filePath: string): ResolvedVizeConfig | null {\n  const output = loadPklConfigJson(filePath);\n  return output === null ? null : parseJsonConfig(output, filePath);\n}\n\nexport async function resolveConfigExport(\n  exported: UserConfigExport,\n  env?: ConfigEnv,\n): Promise<ResolvedVizeConfig> {\n  if (typeof exported === \"function\") {\n    return normalizeLoadedConfig(await exported(env ?? DEFAULT_CONFIG_ENV));\n  }\n\n  return normalizeLoadedConfig(exported);\n}\n\nasync function loadTypeScriptConfig(\n  filePath: string,\n  env?: ConfigEnv,\n): Promise<ResolvedVizeConfig> {\n  const source = fs.readFileSync(filePath, \"utf-8\");\n  const result = await transform(filePath, source, {\n    typescript: {\n      onlyRemoveTypeImports: true,\n    },\n  });\n\n  const tempFile = path.join(\n    path.dirname(filePath),\n    `.vize-config-${process.pid}-${Date.now()}-${randomUUID()}.mjs`,\n  );\n  fs.writeFileSync(tempFile, result.code, { flag: \"wx\", mode: 0o600 });\n\n  try {\n    const module = await importFresh(tempFile);\n    const exported: UserConfigExport = module.default || module;\n    return resolveConfigExport(exported, env);\n  } finally {\n    fs.rmSync(tempFile, { force: true });\n  }\n}\n\nasync function loadESMConfig(filePath: string, env?: ConfigEnv): Promise<ResolvedVizeConfig> {\n  const module = await importFresh(filePath);\n  const exported: UserConfigExport = module.default || module;\n  return resolveConfigExport(exported, env);\n}\n\nasync function importFresh(filePath: string): Promise<Record<string, unknown>> {\n  const fileUrl = pathToFileURL(filePath);\n  fileUrl.searchParams.set(\"t\", String(fs.statSync(filePath).mtimeMs));\n  return import(fileUrl.href);\n}\n\nfunction parseJsonConfig(content: string, filePath: string): ResolvedVizeConfig {\n  try {\n    return normalizeLoadedConfig(JSON.parse(content));\n  } catch (error) {\n    throw new Error(`Failed to parse vize config JSON at ${filePath}: ${getErrorMessage(error)}`);\n  }\n}\n\nfunction normalizeLoadedConfig(config: unknown): ResolvedVizeConfig {\n  return native.normalizeVizeConfig(config ?? null) as ResolvedVizeConfig;\n}\n\nfunction getErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n\n/**\n * Normalize GlobalTypesConfig shorthand strings to GlobalTypeDeclaration objects\n */\nexport function normalizeGlobalTypes(\n  config: GlobalTypesConfig,\n): Record<string, GlobalTypeDeclaration> {\n  const resolvedConfig =\n    \"types\" in config &&\n    typeof config.types === \"object\" &&\n    config.types !== null &&\n    !Array.isArray(config.types)\n      ? config.types\n      : config;\n\n  const result: Record<string, GlobalTypeDeclaration> = {};\n  for (const [key, value] of Object.entries(resolvedConfig)) {\n    if (typeof value === \"string\") {\n      result[key] = { type: value };\n    } else {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n"],"mappings":"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"}

package/dist/config.mjs

@@ -1,2 +1,2 @@
-import { a as loadConfig, i as defineConfig, n as VIZE_CONFIG_JSON_SCHEMA_PATH, o as normalizeGlobalTypes, r as VIZE_CONFIG_PKL_SCHEMA_PATH, s as resolveConfigExport, t as CONFIG_FILE_NAMES } from "./config-D1BwAgHh.mjs";
+import { a as loadConfig, i as defineConfig, n as VIZE_CONFIG_JSON_SCHEMA_PATH, o as normalizeGlobalTypes, r as VIZE_CONFIG_PKL_SCHEMA_PATH, s as resolveConfigExport, t as CONFIG_FILE_NAMES } from "./config-CqEev07u.mjs";
 export { CONFIG_FILE_NAMES, VIZE_CONFIG_JSON_SCHEMA_PATH, VIZE_CONFIG_PKL_SCHEMA_PATH, defineConfig, loadConfig, normalizeGlobalTypes, resolveConfigExport };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as loadConfig, i as defineConfig, n as VIZE_CONFIG_JSON_SCHEMA_PATH, o as normalizeGlobalTypes, r as VIZE_CONFIG_PKL_SCHEMA_PATH, s as resolveConfigExport, t as CONFIG_FILE_NAMES } from "./config-D1BwAgHh.mjs";
+import { a as loadConfig, i as defineConfig, n as VIZE_CONFIG_JSON_SCHEMA_PATH, o as normalizeGlobalTypes, r as VIZE_CONFIG_PKL_SCHEMA_PATH, s as resolveConfigExport, t as CONFIG_FILE_NAMES } from "./config-CqEev07u.mjs";
 export { CONFIG_FILE_NAMES, VIZE_CONFIG_JSON_SCHEMA_PATH, VIZE_CONFIG_PKL_SCHEMA_PATH, defineConfig, loadConfig, normalizeGlobalTypes, resolveConfigExport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vize",
-  "version": "0.291.0",
+  "version": "0.303.0",
   "description": "Vize - High-performance Vue.js toolchain in Rust",
   "keywords": [
     "cli",
@@ -22,7 +22,8 @@
     "directory": "npm/cli"
   },
   "bin": {
-    "vize": "bin/vize"
+    "vize": "bin/vize",
+    "vz": "bin/vize"
   },
   "files": [
     "bin",
@@ -52,7 +53,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@vizejs/native": "0.291.0",
+    "@vizejs/native": "0.303.0",
     "oxc-transform": "0.130.0"
   },
   "devDependencies": {
@@ -83,11 +84,19 @@
   "engines": {
     "node": ">=22"
   },
+  "tsContentMapper": {
+    "exec": [
+      "node",
+      "./bin/vize",
+      "content-mapper"
+    ]
+  },
   "scripts": {
     "build": "vp run --workspace-root generate:rule-types && vp pack",
-    "check": "vp check src vite.config.ts",
-    "check:fix": "vp check --fix src vite.config.ts",
-    "fmt": "vp fmt --write src vite.config.ts",
-    "generate:rule-types": "vp run --workspace-root generate:rule-types"
+    "check": "vp check src tests vite.config.ts",
+    "check:fix": "vp check --fix src tests vite.config.ts",
+    "fmt": "vp fmt --write src tests vite.config.ts",
+    "generate:rule-types": "vp run --workspace-root generate:rule-types",
+    "test": "vp pack && vp test run tests/setup.test.ts"
   }
 }

package/src/cli.ts

@@ -1,6 +1,19 @@
 import { createRequire } from "node:module";
 
+import { runSetupCli } from "./setup.js";
+
 const require = createRequire(import.meta.url);
-const native = require("@vizejs/native") as typeof import("@vizejs/native");
 
-native.runCli(process.argv.slice(2));
+try {
+  const args = process.argv.slice(2);
+  if (args[0] === "setup") {
+    runSetupCli(args.slice(1));
+  } else {
+    const native = require("@vizejs/native") as typeof import("@vizejs/native");
+    native.runCli(args);
+  }
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`[vize] ${message}\n`);
+  process.exitCode = 1;
+}

package/src/setup/config.ts

@@ -0,0 +1,187 @@
+import fs from "node:fs";
+import path from "node:path";
+
+export const VIZE_CONFIG_FILES = [
+  "vize.config.pkl",
+  "vize.config.ts",
+  "vize.config.js",
+  "vize.config.mjs",
+  "vize.config.json",
+] as const;
+
+export const OXLINT_CONFIG_FILES = [
+  ".oxlintrc.json",
+  ".oxlintrc.jsonc",
+  "oxlint.config.ts",
+  "oxlint.config.mts",
+  "oxlint.config.js",
+  "oxlint.config.mjs",
+  "oxlint.config.cjs",
+  "oxlint.config.cts",
+] as const;
+
+export const REQUIRED_DEV_DEPENDENCIES = [
+  "vize",
+  "@vizejs/vite-plugin",
+  "@vizejs/vite-plugin-musea",
+  "oxlint",
+  "oxlint-plugin-vize",
+] as const;
+
+export const DEFAULT_SCRIPTS = {
+  "vize:build": "vize build src",
+  "vize:fmt": "vize fmt --check src",
+  "vize:fmt:fix": "vize fmt --write src",
+  "vize:lint": "vize lint --preset happy-path --max-warnings 0 src",
+  "vize:check": "vize check src",
+  "vize:musea": "vize musea",
+  "vize:ready": "vize ready src",
+} as const;
+
+export const DEFAULT_VIZE_CONFIG = `import { defineConfig } from "vize";
+
+export default defineConfig({
+  compiler: {
+    templateSyntax: "standard",
+  },
+  linter: {
+    preset: "happy-path",
+  },
+  typeChecker: {
+    enabled: true,
+    strict: true,
+  },
+  vite: {
+    scanPatterns: ["src/**/*.vue"],
+  },
+});
+`;
+
+export const DEFAULT_OXLINT_CONFIG = `import { defineConfig } from "oxlint";
+import { configs } from "oxlint-plugin-vize";
+
+export default defineConfig({
+  plugins: ["vue"],
+  jsPlugins: ["oxlint-plugin-vize"],
+  settings: {
+    vize: {
+      preset: "general-recommended",
+      helpLevel: "short",
+    },
+  },
+  rules: configs.recommended,
+});
+`;
+
+type JsonObject = Record<string, unknown>;
+
+export interface PlannedFile {
+  readonly filename: string;
+  readonly source: string;
+}
+
+export function readRequiredFile(filename: string, message: string): string {
+  try {
+    return fs.readFileSync(filename, "utf8");
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      throw new Error(`${message}: ${filename}`, { cause: error });
+    }
+    throw error;
+  }
+}
+
+export function parsePackageJson(filename: string, source: string): JsonObject {
+  try {
+    const parsed = JSON.parse(source) as unknown;
+    if (!isJsonObject(parsed)) {
+      throw new Error("package.json must contain an object");
+    }
+    return parsed;
+  } catch (error) {
+    throw new Error(`Invalid package.json: ${filename}`, { cause: error });
+  }
+}
+
+export function detectJsonIndent(source: string): string | number {
+  const match = source.match(/^[\t ]+(?=")/mu);
+  return match?.[0] ?? 2;
+}
+
+export function dependencyNames(packageJson: JsonObject): Set<string> {
+  const names = new Set<string>();
+  for (const field of ["dependencies", "devDependencies", "optionalDependencies"] as const) {
+    const dependencies = packageJson[field];
+    if (!isJsonObject(dependencies)) {
+      continue;
+    }
+    for (const name of Object.keys(dependencies)) {
+      names.add(name);
+    }
+  }
+  return names;
+}
+
+export function addDefaultScripts(packageJson: JsonObject): {
+  readonly addedScripts: string[];
+  readonly preservedScripts: string[];
+} {
+  if (packageJson.scripts !== undefined && !isJsonObject(packageJson.scripts)) {
+    throw new Error("package.json scripts must contain an object");
+  }
+
+  const scripts = (packageJson.scripts ?? {}) as JsonObject;
+  const addedScripts: string[] = [];
+  const preservedScripts: string[] = [];
+  for (const [name, command] of Object.entries(DEFAULT_SCRIPTS)) {
+    if (name in scripts) {
+      preservedScripts.push(name);
+      continue;
+    }
+    scripts[name] = command;
+    addedScripts.push(name);
+  }
+  if (addedScripts.length > 0) {
+    packageJson.scripts = scripts;
+  }
+  return { addedScripts, preservedScripts };
+}
+
+export function planGeneratedConfig(
+  root: string,
+  candidates: readonly string[],
+  generatedName: string,
+  source: string,
+  plannedFiles: PlannedFile[],
+  createdFiles: string[],
+  preservedFiles: string[],
+): void {
+  const existing = candidates.find((candidate) => fs.existsSync(path.join(root, candidate)));
+  if (existing) {
+    preservedFiles.push(existing);
+    return;
+  }
+  plannedFiles.push({ filename: path.join(root, generatedName), source });
+  createdFiles.push(generatedName);
+}
+
+export function atomicWriteFile(filename: string, source: string): void {
+  const temporary = path.join(
+    path.dirname(filename),
+    `.${path.basename(filename)}.${process.pid}.${Date.now()}.tmp`,
+  );
+  try {
+    fs.writeFileSync(temporary, source, { encoding: "utf8", flag: "wx" });
+    fs.renameSync(temporary, filename);
+  } finally {
+    fs.rmSync(temporary, { force: true });
+  }
+}
+
+function isJsonObject(value: unknown): value is JsonObject {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function isNodeError(value: unknown): value is NodeJS.ErrnoException {
+  return value instanceof Error;
+}

package/src/setup/vite.ts

@@ -0,0 +1,159 @@
+import fs from "node:fs";
+import path from "node:path";
+
+import type { PlannedFile } from "./config.js";
+
+const VITE_CONFIG_FILES = [
+  "vite.config.ts",
+  "vite.config.mts",
+  "vite.config.js",
+  "vite.config.mjs",
+] as const;
+
+const VITE_PLUS_LINT_IMPORT =
+  'import { configs as vizePlusLintConfigs } from "oxlint-plugin-vize";\n';
+
+const VITE_PLUS_LINT_BLOCK = `  lint: {
+    plugins: ["vue"],
+    jsPlugins: ["oxlint-plugin-vize"],
+    settings: {
+      vize: {
+        preset: "general-recommended",
+        helpLevel: "short",
+      },
+    },
+    rules: vizePlusLintConfigs.recommended,
+  },
+`;
+
+export interface ViteMigrationPlan {
+  readonly file: PlannedFile | null;
+  readonly preserved: string | null;
+  readonly removesOfficialPlugin: boolean;
+  readonly enablesVitePlusLint: boolean;
+  readonly hasVitePlusLint: boolean;
+  readonly usesVitePlus: boolean;
+}
+
+export function planViteMigration(
+  root: string,
+  mayConfigureVitePlusLint: boolean,
+): ViteMigrationPlan {
+  const existing = VITE_CONFIG_FILES.filter((candidate) =>
+    fs.existsSync(path.join(root, candidate)),
+  );
+  if (existing.length === 0) {
+    return {
+      file: null,
+      preserved: null,
+      removesOfficialPlugin: false,
+      enablesVitePlusLint: false,
+      hasVitePlusLint: false,
+      usesVitePlus: false,
+    };
+  }
+  if (existing.length > 1) {
+    return {
+      file: null,
+      preserved: `Vite configs (${existing.join(", ")})`,
+      removesOfficialPlugin: false,
+      enablesVitePlusLint: false,
+      hasVitePlusLint: false,
+      usesVitePlus: false,
+    };
+  }
+
+  const relativeFilename = existing[0]!;
+  const filename = path.join(root, relativeFilename);
+  const source = fs.readFileSync(filename, "utf8");
+  const usesVitePlus = /from\s+["']vite-plus["']/u.test(source);
+  let migratedSource = source;
+  let removesOfficialPlugin = false;
+  let preserved: string | null = null;
+
+  if (!source.includes("@vizejs/vite-plugin")) {
+    const importPattern =
+      /^([^\S\r\n]*import[^\S\r\n]+)([$A-Z_a-z][$\w]*)([^\S\r\n]+from[^\S\r\n]+)(["'])@vitejs\/plugin-vue\4([^\S\r\n]*;?[^\S\r\n]*)$/gmu;
+    const imports = [...source.matchAll(importPattern)];
+    if (imports.length === 1) {
+      const localName = imports[0]![2]!;
+      const zeroArgumentCallPattern = new RegExp(
+        `\\b${escapeRegExp(localName)}\\s*\\(\\s*\\)`,
+        "gu",
+      );
+      const calls = [...source.matchAll(zeroArgumentCallPattern)];
+      const importIndex = imports[0]!.index!;
+      const importSource = imports[0]![0];
+      const sourceWithoutExpectedUse =
+        source.slice(0, importIndex) +
+        source.slice(importIndex + importSource.length).replace(zeroArgumentCallPattern, "");
+      const hasOtherUses = new RegExp(`\\b${escapeRegExp(localName)}\\b`, "u").test(
+        sourceWithoutExpectedUse,
+      );
+      if (calls.length === 1 && !hasOtherUses) {
+        migratedSource = source.replace(importPattern, `$1$2$3$4@vizejs/vite-plugin$4$5`);
+        removesOfficialPlugin = true;
+      } else {
+        preserved = relativeFilename;
+      }
+    } else if (source.includes("@vitejs/plugin-vue")) {
+      preserved = relativeFilename;
+    }
+  }
+
+  const hadVitePlusLint = usesVitePlus && source.includes("oxlint-plugin-vize");
+  let enablesVitePlusLint = false;
+  if (mayConfigureVitePlusLint && !hadVitePlusLint && canInjectVitePlusLint(migratedSource)) {
+    const injectedSource = injectVitePlusLint(migratedSource);
+    if (injectedSource !== null) {
+      migratedSource = injectedSource;
+      enablesVitePlusLint = true;
+    }
+  }
+
+  return {
+    file: migratedSource === source ? null : { filename, source: migratedSource },
+    preserved:
+      preserved ??
+      (migratedSource === source && source.includes("@vizejs/vite-plugin")
+        ? relativeFilename
+        : null),
+    removesOfficialPlugin,
+    enablesVitePlusLint,
+    hasVitePlusLint: hadVitePlusLint || enablesVitePlusLint,
+    usesVitePlus,
+  };
+}
+
+function canInjectVitePlusLint(source: string): boolean {
+  if (
+    !/from\s+["']vite-plus["']/u.test(source) ||
+    /^\s*lint\s*:/mu.test(source) ||
+    /\bvizePlusLintConfigs\b/u.test(source)
+  ) {
+    return false;
+  }
+  return [...source.matchAll(/\bdefineConfig\s*\(\s*\{/gu)].length === 1;
+}
+
+function injectVitePlusLint(source: string): string | null {
+  const importLines = [
+    ...source.matchAll(
+      /^import[^\r\n]*(?:from\s+["'][^"']+["']|["'][^"']+["'])\s*;?[^\S\r\n]*(?:\r?\n|$)/gmu,
+    ),
+  ];
+  const lastImport = importLines.at(-1);
+  if (!lastImport || lastImport.index === undefined) {
+    return null;
+  }
+  const importEnd = lastImport.index + lastImport[0].length;
+  const withImport = source.slice(0, importEnd) + VITE_PLUS_LINT_IMPORT + source.slice(importEnd);
+  return withImport.replace(
+    /\bdefineConfig\s*\(\s*\{/u,
+    (opening) => `${opening}\n${VITE_PLUS_LINT_BLOCK}`,
+  );
+}
+
+function escapeRegExp(value: string): string {
+  return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}