vize 0.0.1-alpha.100

package/README.md

@@ -0,0 +1,56 @@
+# Vize
+
+High-performance Vue.js toolchain in Rust.
+
+## Installation
+
+```bash
+# Install from npm
+npm install -g vize
+
+# Or install from GitHub
+npm install -g github:vizejs/vize
+```
+
+## Usage
+
+```bash
+vize [COMMAND] [OPTIONS]
+```
+
+| Command | Description                            |
+| ------- | -------------------------------------- |
+| `build` | Compile Vue SFC files (default)        |
+| `fmt`   | Format Vue SFC files                   |
+| `lint`  | Lint Vue SFC files                     |
+| `check` | Type check Vue SFC files               |
+| `musea` | Start component gallery server         |
+| `lsp`   | Start Language Server Protocol server  |
+
+```bash
+vize --help           # Show help
+vize <command> --help # Show command-specific help
+```
+
+## Examples
+
+```bash
+vize                              # Compile ./**/*.vue to ./dist
+vize build src/**/*.vue -o out    # Custom input/output
+vize build --ssr                  # SSR mode
+vize fmt --check                  # Check formatting
+vize lint --fix                   # Auto-fix lint issues
+vize check --strict               # Strict type checking
+```
+
+## Alternative Installation
+
+If npm installation fails, you can install via Cargo:
+
+```bash
+cargo install vize
+```
+
+## License
+
+MIT

package/bin/vize

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+import { spawn } from "child_process";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { existsSync } from "fs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const binaryName = process.platform === "win32" ? "vize.exe" : "vize";
+const binaryPath = join(__dirname, binaryName);
+
+if (!existsSync(binaryPath)) {
+  console.error("Vize binary not found. Please reinstall the package.");
+  console.error("npm uninstall -g vize && npm install -g vize");
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+child.on("error", (err) => {
+  console.error(`Failed to start Vize: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("close", (code) => {
+  process.exit(code ?? 0);
+});

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "vize",
+  "version": "0.0.1-alpha.100",
+  "description": "Vize - High-performance Vue.js toolchain in Rust",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./config": {
+      "import": "./dist/config.js",
+      "types": "./dist/config.d.ts"
+    }
+  },
+  "bin": {
+    "vize": "bin/vize"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "dist",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ubugeeei/vize"
+  },
+  "keywords": [
+    "vue",
+    "compiler",
+    "rust",
+    "cli",
+    "vize",
+    "formatter",
+    "linter"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "oxc-transform": "^0.56.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsdown": "^0.9.0",
+    "typescript": "~5.6.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "postinstall": "node scripts/postinstall.js",
+    "lint": "oxlint --deny-warnings --type-aware --tsconfig tsconfig.json",
+    "lint:fix": "oxlint --type-aware --tsconfig tsconfig.json --fix",
+    "fmt": "oxfmt --write src",
+    "fmt:check": "oxfmt src"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+
+import { createWriteStream, chmodSync, existsSync, mkdirSync, unlinkSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { pipeline } from "stream/promises";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJson = await import("../package.json", { with: { type: "json" } });
+const version = packageJson.default.version;
+
+const REPO = "vizejs/vize";
+
+const PLATFORMS = {
+  "darwin-x64": {
+    target: "x86_64-apple-darwin",
+    filename: "vize-x86_64-apple-darwin.tar.gz",
+  },
+  "darwin-arm64": {
+    target: "aarch64-apple-darwin",
+    filename: "vize-aarch64-apple-darwin.tar.gz",
+  },
+  "linux-x64": {
+    target: "x86_64-unknown-linux-gnu",
+    filename: "vize-x86_64-unknown-linux-gnu.tar.gz",
+  },
+  "linux-arm64": {
+    target: "aarch64-unknown-linux-gnu",
+    filename: "vize-aarch64-unknown-linux-gnu.tar.gz",
+  },
+  "win32-x64": {
+    target: "x86_64-pc-windows-msvc",
+    filename: "vize-x86_64-pc-windows-msvc.zip",
+  },
+  "win32-arm64": {
+    target: "aarch64-pc-windows-msvc",
+    filename: "vize-aarch64-pc-windows-msvc.zip",
+  },
+};
+
+async function main() {
+  // Skip in CI environment - binary is built separately and not available during pnpm install
+  if (process.env.CI) {
+    console.log("CI environment detected, skipping binary download.");
+    return;
+  }
+
+  const platform = `${process.platform}-${process.arch}`;
+  const config = PLATFORMS[platform];
+
+  if (!config) {
+    console.error(`Unsupported platform: ${platform}`);
+    console.error(`Supported platforms: ${Object.keys(PLATFORMS).join(", ")}`);
+    console.error(
+      "\nYou can install the CLI from source using: cargo install vize"
+    );
+    process.exit(1);
+  }
+
+  const binDir = join(__dirname, "..", "bin");
+  const binaryName = process.platform === "win32" ? "vize.exe" : "vize";
+  const binaryPath = join(binDir, binaryName);
+
+  // Skip if binary already exists (for local development)
+  if (existsSync(binaryPath)) {
+    console.log("Vize binary already exists, skipping download.");
+    return;
+  }
+
+  if (!existsSync(binDir)) {
+    mkdirSync(binDir, { recursive: true });
+  }
+
+  const tag = `v${version}`;
+  const downloadUrl = `https://github.com/${REPO}/releases/download/${tag}/${config.filename}`;
+
+  console.log(`Downloading Vize ${version} for ${platform}...`);
+  console.log(`URL: ${downloadUrl}`);
+
+  try {
+    const response = await fetch(downloadUrl);
+
+    if (!response.ok) {
+      throw new Error(`Failed to download: ${response.status} ${response.statusText}`);
+    }
+
+    const tempFile = join(binDir, config.filename);
+
+    // Download to temp file
+    const fileStream = createWriteStream(tempFile);
+    await pipeline(response.body, fileStream);
+
+    // Extract based on file type
+    if (config.filename.endsWith(".tar.gz")) {
+      await extractTarGz(tempFile, binDir, binaryName);
+    } else if (config.filename.endsWith(".zip")) {
+      await extractZip(tempFile, binDir, binaryName);
+    }
+
+    // Clean up temp file
+    unlinkSync(tempFile);
+
+    // Make executable on Unix
+    if (process.platform !== "win32") {
+      chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`Vize ${version} installed successfully!`);
+  } catch (error) {
+    console.error(`Failed to install Vize: ${error.message}`);
+    console.error(
+      "\nYou can install the CLI from source using: cargo install vize"
+    );
+    process.exit(1);
+  }
+}
+
+async function extractTarGz(archivePath, destDir, binaryName) {
+  const { execSync } = await import("child_process");
+  execSync(`tar -xzf "${archivePath}" -C "${destDir}"`, { stdio: "inherit" });
+
+  // The archive contains a 'vize' binary directly
+  // If not in place, move it
+  const extractedPath = join(destDir, "vize");
+  const targetPath = join(destDir, binaryName);
+  if (extractedPath !== targetPath && existsSync(extractedPath)) {
+    const { renameSync } = await import("fs");
+    renameSync(extractedPath, targetPath);
+  }
+}
+
+async function extractZip(archivePath, destDir, _binaryName) {
+  const { execSync } = await import("child_process");
+  execSync(`unzip -o "${archivePath}" -d "${destDir}"`, { stdio: "inherit" });
+}
+
+void main();

package/src/config.ts

@@ -0,0 +1,192 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { pathToFileURL } from "node:url";
+import { transform } from "oxc-transform";
+import type {
+  VizeConfig,
+  LoadConfigOptions,
+  UserConfigExport,
+  ConfigEnv,
+  GlobalTypesConfig,
+  GlobalTypeDeclaration,
+} from "./types.js";
+
+const CONFIG_FILE_NAMES = [
+  "vize.config.ts",
+  "vize.config.js",
+  "vize.config.mjs",
+  "vize.config.json",
+];
+
+const DEFAULT_CONFIG_ENV: ConfigEnv = {
+  mode: "development",
+  command: "serve",
+};
+
+/**
+ * Define a Vize configuration with type checking.
+ * Accepts a plain object or a function that receives ConfigEnv.
+ */
+export function defineConfig(config: UserConfigExport): UserConfigExport {
+  return config;
+}
+
+/**
+ * Load vize.config file from the specified directory
+ */
+export async function loadConfig(
+  root: string,
+  options: LoadConfigOptions = {},
+): Promise<VizeConfig | null> {
+  const { mode = "root", configFile, env } = options;
+
+  if (mode === "none") {
+    return null;
+  }
+
+  // Custom config file path
+  if (configFile) {
+    const absolutePath = path.isAbsolute(configFile) ? configFile : path.resolve(root, configFile);
+    if (fs.existsSync(absolutePath)) {
+      return loadConfigFile(absolutePath, env);
+    }
+    return null;
+  }
+
+  // Search for config file
+  if (mode === "auto") {
+    const configPath = findConfigFileAuto(root);
+    if (!configPath) {
+      return null;
+    }
+    return loadConfigFile(configPath, env);
+  }
+
+  // mode === "root"
+  const configPath = findConfigFileInDir(root);
+  if (!configPath) {
+    return null;
+  }
+  return loadConfigFile(configPath, env);
+}
+
+/**
+ * Find config file in a specific directory
+ */
+function findConfigFileInDir(dir: string): string | null {
+  for (const name of CONFIG_FILE_NAMES) {
+    const filePath = path.join(dir, name);
+    if (fs.existsSync(filePath)) {
+      return filePath;
+    }
+  }
+  return null;
+}
+
+/**
+ * Find config file by searching from cwd upward
+ */
+function findConfigFileAuto(startDir: string): string | null {
+  let currentDir = path.resolve(startDir);
+  const root = path.parse(currentDir).root;
+
+  while (currentDir !== root) {
+    const configPath = findConfigFileInDir(currentDir);
+    if (configPath) {
+      return configPath;
+    }
+    currentDir = path.dirname(currentDir);
+  }
+
+  return null;
+}
+
+/**
+ * Load and evaluate a config file
+ */
+async function loadConfigFile(filePath: string, env?: ConfigEnv): Promise<VizeConfig | null> {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  const ext = path.extname(filePath);
+
+  if (ext === ".json") {
+    const content = fs.readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+  }
+
+  if (ext === ".ts") {
+    return loadTypeScriptConfig(filePath, env);
+  }
+
+  // .js, .mjs - ESM
+  return loadESMConfig(filePath, env);
+}
+
+/**
+ * Resolve a UserConfigExport to a VizeConfig
+ */
+async function resolveConfigExport(
+  exported: UserConfigExport,
+  env?: ConfigEnv,
+): Promise<VizeConfig> {
+  if (typeof exported === "function") {
+    return exported(env ?? DEFAULT_CONFIG_ENV);
+  }
+  return exported;
+}
+
+/**
+ * Load TypeScript config file using oxc-transform
+ */
+async function loadTypeScriptConfig(filePath: string, env?: ConfigEnv): Promise<VizeConfig> {
+  const source = fs.readFileSync(filePath, "utf-8");
+  const result = transform(filePath, source, {
+    typescript: {
+      onlyRemoveTypeImports: true,
+    },
+  });
+
+  const code = result.code;
+
+  // Write to temp file and import (use Date.now() to avoid race conditions)
+  const tempFile = filePath.replace(/\.ts$/, `.temp.${Date.now()}.mjs`);
+  fs.writeFileSync(tempFile, code);
+
+  try {
+    const fileUrl = pathToFileURL(tempFile).href;
+    const module = await import(fileUrl);
+    const exported: UserConfigExport = module.default || module;
+    return resolveConfigExport(exported, env);
+  } finally {
+    fs.unlinkSync(tempFile);
+  }
+}
+
+/**
+ * Load ESM config file
+ */
+async function loadESMConfig(filePath: string, env?: ConfigEnv): Promise<VizeConfig> {
+  const fileUrl = pathToFileURL(filePath).href;
+  const module = await import(fileUrl);
+  const exported: UserConfigExport = module.default || module;
+  return resolveConfigExport(exported, env);
+}
+
+/**
+ * Normalize GlobalTypesConfig shorthand strings to GlobalTypeDeclaration objects
+ */
+export function normalizeGlobalTypes(
+  config: GlobalTypesConfig,
+): Record<string, GlobalTypeDeclaration> {
+  const result: Record<string, GlobalTypeDeclaration> = {};
+  for (const [key, value] of Object.entries(config)) {
+    if (typeof value === "string") {
+      result[key] = { type: value };
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+/**
+ * Vize - High-performance Vue.js toolchain in Rust
+ *
+ * This package provides:
+ * - CLI binary for compilation, linting, and formatting
+ * - Configuration utilities for programmatic use
+ */
+
+// Types
+export type {
+  VizeConfig,
+  CompilerConfig,
+  VitePluginConfig,
+  LinterConfig,
+  TypeCheckerConfig,
+  FormatterConfig,
+  LspConfig,
+  MuseaConfig,
+  MuseaVrtConfig,
+  MuseaA11yConfig,
+  MuseaAutogenConfig,
+  GlobalTypesConfig,
+  GlobalTypeDeclaration,
+  LoadConfigOptions,
+  ConfigEnv,
+  UserConfigExport,
+  MaybePromise,
+  RuleSeverity,
+  RuleCategory,
+} from "./types.js";
+
+// Config utilities
+export { defineConfig, loadConfig, normalizeGlobalTypes } from "./config.js";

package/src/types.ts

@@ -0,0 +1,515 @@
+// ============================================================================
+// Dynamic config support
+// ============================================================================
+
+export type MaybePromise<T> = T | Promise<T>;
+
+export interface ConfigEnv {
+  mode: string;
+  command: "serve" | "build" | "check" | "lint" | "fmt";
+  isSsrBuild?: boolean;
+}
+
+export type UserConfigExport = VizeConfig | ((env: ConfigEnv) => MaybePromise<VizeConfig>);
+
+// ============================================================================
+// Rule severity
+// ============================================================================
+
+export type RuleSeverity = "off" | "warn" | "error";
+
+export type RuleCategory = "correctness" | "suspicious" | "style" | "perf" | "a11y" | "security";
+
+// ============================================================================
+// VizeConfig
+// ============================================================================
+
+/**
+ * Vize configuration options
+ */
+export interface VizeConfig {
+  /**
+   * Vue compiler options
+   */
+  compiler?: CompilerConfig;
+
+  /**
+   * Vite plugin options
+   */
+  vite?: VitePluginConfig;
+
+  /**
+   * Linter options
+   */
+  linter?: LinterConfig;
+
+  /**
+   * Type checker options
+   */
+  typeChecker?: TypeCheckerConfig;
+
+  /**
+   * Formatter options
+   */
+  formatter?: FormatterConfig;
+
+  /**
+   * LSP options
+   */
+  lsp?: LspConfig;
+
+  /**
+   * Musea component gallery options
+   */
+  musea?: MuseaConfig;
+
+  /**
+   * Global type declarations
+   */
+  globalTypes?: GlobalTypesConfig;
+}
+
+// ============================================================================
+// CompilerConfig
+// ============================================================================
+
+/**
+ * Compiler configuration
+ */
+export interface CompilerConfig {
+  /**
+   * Compilation mode
+   * @default 'module'
+   */
+  mode?: "module" | "function";
+
+  /**
+   * Enable Vapor mode compilation
+   * @default false
+   */
+  vapor?: boolean;
+
+  /**
+   * Enable SSR mode
+   * @default false
+   */
+  ssr?: boolean;
+
+  /**
+   * Enable source map generation
+   * @default true in development, false in production
+   */
+  sourceMap?: boolean;
+
+  /**
+   * Prefix template identifiers with _ctx
+   * @default false
+   */
+  prefixIdentifiers?: boolean;
+
+  /**
+   * Hoist static nodes
+   * @default true
+   */
+  hoistStatic?: boolean;
+
+  /**
+   * Cache v-on handlers
+   * @default true
+   */
+  cacheHandlers?: boolean;
+
+  /**
+   * Enable TypeScript parsing in <script> blocks
+   * @default true
+   */
+  isTs?: boolean;
+
+  /**
+   * Script file extension for generated output
+   * @default 'ts'
+   */
+  scriptExt?: "ts" | "js";
+
+  /**
+   * Module name for runtime imports
+   * @default 'vue'
+   */
+  runtimeModuleName?: string;
+
+  /**
+   * Global variable name for runtime (IIFE builds)
+   * @default 'Vue'
+   */
+  runtimeGlobalName?: string;
+}
+
+// ============================================================================
+// VitePluginConfig
+// ============================================================================
+
+/**
+ * Vite plugin configuration
+ */
+export interface VitePluginConfig {
+  /**
+   * Files to include in compilation
+   * @default /\.vue$/
+   */
+  include?: string | RegExp | (string | RegExp)[];
+
+  /**
+   * Files to exclude from compilation
+   * @default /node_modules/
+   */
+  exclude?: string | RegExp | (string | RegExp)[];
+
+  /**
+   * Glob patterns to scan for .vue files during pre-compilation
+   * @default ['**\/*.vue']
+   */
+  scanPatterns?: string[];
+
+  /**
+   * Glob patterns to ignore during pre-compilation
+   * @default ['node_modules/**', 'dist/**', '.git/**']
+   */
+  ignorePatterns?: string[];
+}
+
+// ============================================================================
+// LinterConfig
+// ============================================================================
+
+/**
+ * Linter configuration
+ */
+export interface LinterConfig {
+  /**
+   * Enable linting
+   */
+  enabled?: boolean;
+
+  /**
+   * Rules to enable/disable
+   */
+  rules?: Record<string, RuleSeverity>;
+
+  /**
+   * Category-level severity overrides
+   */
+  categories?: Partial<Record<RuleCategory, RuleSeverity>>;
+}
+
+// ============================================================================
+// TypeCheckerConfig
+// ============================================================================
+
+/**
+ * Type checker configuration
+ */
+export interface TypeCheckerConfig {
+  /**
+   * Enable type checking
+   * @default false
+   */
+  enabled?: boolean;
+
+  /**
+   * Enable strict mode
+   * @default false
+   */
+  strict?: boolean;
+
+  /**
+   * Check component props
+   * @default true
+   */
+  checkProps?: boolean;
+
+  /**
+   * Check component emits
+   * @default true
+   */
+  checkEmits?: boolean;
+
+  /**
+   * Check template bindings
+   * @default true
+   */
+  checkTemplateBindings?: boolean;
+
+  /**
+   * Path to tsconfig.json
+   * @default auto-detected
+   */
+  tsconfig?: string;
+
+  /**
+   * Path to tsgo binary
+   */
+  tsgoPath?: string;
+}
+
+// ============================================================================
+// FormatterConfig
+// ============================================================================
+
+/**
+ * Formatter configuration
+ */
+export interface FormatterConfig {
+  /**
+   * Max line width
+   * @default 80
+   */
+  printWidth?: number;
+
+  /**
+   * Indentation width
+   * @default 2
+   */
+  tabWidth?: number;
+
+  /**
+   * Use tabs for indentation
+   * @default false
+   */
+  useTabs?: boolean;
+
+  /**
+   * Print semicolons
+   * @default true
+   */
+  semi?: boolean;
+
+  /**
+   * Use single quotes
+   * @default false
+   */
+  singleQuote?: boolean;
+
+  /**
+   * Trailing commas
+   * @default 'all'
+   */
+  trailingComma?: "all" | "none" | "es5";
+}
+
+// ============================================================================
+// LspConfig
+// ============================================================================
+
+/**
+ * LSP configuration
+ */
+export interface LspConfig {
+  /**
+   * Enable LSP
+   * @default true
+   */
+  enabled?: boolean;
+
+  /**
+   * Enable diagnostics
+   * @default true
+   */
+  diagnostics?: boolean;
+
+  /**
+   * Enable completions
+   * @default true
+   */
+  completion?: boolean;
+
+  /**
+   * Enable hover information
+   * @default true
+   */
+  hover?: boolean;
+
+  /**
+   * Enable go-to-definition
+   * @default true
+   */
+  definition?: boolean;
+
+  /**
+   * Enable formatting via LSP
+   * @default true
+   */
+  formatting?: boolean;
+
+  /**
+   * Enable code actions
+   * @default true
+   */
+  codeActions?: boolean;
+
+  /**
+   * Use tsgo for type checking in LSP
+   * @default false
+   */
+  tsgo?: boolean;
+}
+
+// ============================================================================
+// MuseaConfig
+// ============================================================================
+
+/**
+ * VRT (Visual Regression Testing) configuration for Musea
+ */
+export interface MuseaVrtConfig {
+  /**
+   * Threshold for pixel comparison (0-1)
+   * @default 0.1
+   */
+  threshold?: number;
+
+  /**
+   * Output directory for screenshots
+   * @default '__musea_snapshots__'
+   */
+  outDir?: string;
+
+  /**
+   * Viewport sizes
+   */
+  viewports?: Array<{ width: number; height: number; name?: string }>;
+}
+
+/**
+ * A11y configuration for Musea
+ */
+export interface MuseaA11yConfig {
+  /**
+   * Enable a11y checking
+   * @default false
+   */
+  enabled?: boolean;
+
+  /**
+   * Axe-core rules to enable/disable
+   */
+  rules?: Record<string, boolean>;
+}
+
+/**
+ * Autogen configuration for Musea
+ */
+export interface MuseaAutogenConfig {
+  /**
+   * Enable auto-generation of variants
+   * @default false
+   */
+  enabled?: boolean;
+
+  /**
+   * Max variants to generate per component
+   * @default 10
+   */
+  maxVariants?: number;
+}
+
+/**
+ * Musea component gallery configuration
+ */
+export interface MuseaConfig {
+  /**
+   * Glob patterns for art files
+   * @default ['**\/*.art.vue']
+   */
+  include?: string[];
+
+  /**
+   * Glob patterns to exclude
+   * @default ['node_modules/**', 'dist/**']
+   */
+  exclude?: string[];
+
+  /**
+   * Base path for gallery
+   * @default '/__musea__'
+   */
+  basePath?: string;
+
+  /**
+   * Enable Storybook compatibility
+   * @default false
+   */
+  storybookCompat?: boolean;
+
+  /**
+   * Enable inline art detection in .vue files
+   * @default false
+   */
+  inlineArt?: boolean;
+
+  /**
+   * VRT configuration
+   */
+  vrt?: MuseaVrtConfig;
+
+  /**
+   * A11y configuration
+   */
+  a11y?: MuseaA11yConfig;
+
+  /**
+   * Autogen configuration
+   */
+  autogen?: MuseaAutogenConfig;
+}
+
+// ============================================================================
+// GlobalTypesConfig
+// ============================================================================
+
+/**
+ * Global type declaration
+ */
+export interface GlobalTypeDeclaration {
+  /**
+   * TypeScript type string
+   */
+  type: string;
+
+  /**
+   * Default value
+   */
+  defaultValue?: string;
+}
+
+/**
+ * Global types configuration
+ */
+export type GlobalTypesConfig = Record<string, GlobalTypeDeclaration | string>;
+
+// ============================================================================
+// LoadConfigOptions
+// ============================================================================
+
+/**
+ * Options for loading vize.config file
+ */
+export interface LoadConfigOptions {
+  /**
+   * Config file search mode
+   * - 'root': Search only in the specified root directory
+   * - 'auto': Search from cwd upward until finding a config file
+   * - 'none': Don't load config file
+   * @default 'root'
+   */
+  mode?: "root" | "auto" | "none";
+
+  /**
+   * Custom config file path (overrides automatic search)
+   */
+  configFile?: string;
+
+  /**
+   * Config environment for dynamic config resolution
+   */
+  env?: ConfigEnv;
+}