vize 0.48.0 → 0.52.0

package/README.md

@@ -1,46 +1,30 @@
 # Vize
 
-High-performance Vue.js toolchain in Rust.
+The `vize` npm package provides:
 
-## Installation
-
-```bash
-# Install globally
-npm install -g vize
+- shared config utilities (`defineConfig`, `loadConfig`)
+- the native `vize lint` command
 
-# Or add it to a project
-npm install -D vize
+For Vite integration, pair it with `@vizejs/vite-plugin`.
+For the full Rust-native CLI (`build`, `fmt`, `check`, `lsp`, `ide`), install the Rust `vize`
+binary with `cargo install vize`.
 
-# Or install from GitHub
-npm install -g github:ubugeeei/vize
-```
-
-If you use `@vizejs/vite-plugin` and want one shared config for both the plugin and the `vize`
-CLI, install both packages in the project and put your config in `vize.config.*`.
-
-## Usage
+## Installation
 
 ```bash
-vize [COMMAND] [OPTIONS]
+pnpm add -D vize
 ```
 
-| 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 |
+## CLI
+
+The npm CLI currently exposes `lint`:
 
 ```bash
-vize --help           # Show help
-vize <command> --help # Show command-specific help
+pnpm exec vize lint src
+pnpm exec vize lint --preset opinionated --help-level short src
 ```
 
-## Config
-
-`vize` looks for these files in the project root:
+Shared config discovery is supported for the npm CLI:
 
 - `vize.config.ts`
 - `vize.config.js`
@@ -48,8 +32,6 @@ vize <command> --help # Show command-specific help
 - `vize.config.pkl`
 - `vize.config.json`
 
-TypeScript config:
-
 ```ts
 import { defineConfig } from "vize";
 
@@ -60,55 +42,29 @@ export default defineConfig({
 });
 ```
 
-PKL config:
-
-```pkl
-amends "node_modules/vize/pkl/vize.pkl"
-
-linter {
-  preset = "opinionated"
-}
-```
+Override config discovery with `--config`, or disable it with `--no-config`.
 
-JSON config with schema:
+## Programmatic Config Helpers
 
-```json
-{
-  "$schema": "./node_modules/vize/schemas/vize.config.schema.json",
-  "linter": {
-    "preset": "opinionated"
-  }
-}
-```
-
-The npm CLI currently applies shared config to the `lint` command. You can override discovery with
-`vize lint --config path/to/vize.config.ts` or skip config loading with `vize lint --no-config`.
+```ts
+import { defineConfig, loadConfig } from "vize";
 
-## Examples
+export default defineConfig({
+  linter: {
+    preset: "happy-path",
+  },
+});
 
-```bash
-vize                              # Compile ./**/*.vue to ./dist
-vize build src/**/*.vue -o out    # Custom input/output
-vize build --ssr                  # SSR mode
-vize build --profile              # Parse, transform, codegen, and I/O profile
-vize fmt --check                  # Check formatting
-vize fmt --check --profile        # Formatter timing profile
-vize lint --fix                   # Auto-fix lint issues
-vize lint --profile               # Rule hook, Croquis, and type-aware timing profile
-vize check --strict               # Strict type checking
-vize check --profile src          # Virtual TS, Croquis, and Corsa timing profile
+const config = await loadConfig(process.cwd());
 ```
 
-Profile output includes hot files and internal operation timings, so compiler, linter, typecheck,
-Croquis, and Corsa costs are visible in the same report style.
-
-## Alternative Installation
+## Related Packages
 
-If npm installation fails, you can install via Cargo:
-
-```bash
-cargo install vize
-```
+- `@vizejs/vite-plugin`
+- `@vizejs/native`
+- `@vizejs/wasm`
+- `@vizejs/nuxt`
+- `@vizejs/vite-plugin-musea`
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vize",
-  "version": "0.48.0",
+  "version": "0.52.0",
   "description": "Vize - High-performance Vue.js toolchain in Rust",
   "keywords": [
     "cli",
@@ -53,22 +53,23 @@
     "vite-plus": "latest"
   },
   "optionalDependencies": {
-    "@vizejs/native-darwin-arm64": "0.48.0",
-    "@vizejs/native-darwin-x64": "0.48.0",
-    "@vizejs/native-linux-arm64-gnu": "0.48.0",
-    "@vizejs/native-linux-arm64-musl": "0.48.0",
-    "@vizejs/native-linux-x64-gnu": "0.48.0",
-    "@vizejs/native-linux-x64-musl": "0.48.0",
-    "@vizejs/native-win32-arm64-msvc": "0.48.0",
-    "@vizejs/native-win32-x64-msvc": "0.48.0"
+    "@vizejs/native-darwin-arm64": "0.52.0",
+    "@vizejs/native-darwin-x64": "0.52.0",
+    "@vizejs/native-linux-arm64-gnu": "0.52.0",
+    "@vizejs/native-linux-arm64-musl": "0.52.0",
+    "@vizejs/native-linux-x64-gnu": "0.52.0",
+    "@vizejs/native-linux-x64-musl": "0.52.0",
+    "@vizejs/native-win32-arm64-msvc": "0.52.0",
+    "@vizejs/native-win32-x64-msvc": "0.52.0"
   },
   "engines": {
     "node": ">=18"
   },
   "scripts": {
-    "build": "vp pack",
+    "build": "vp run 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"
+    "fmt": "vp fmt --write src vite.config.ts",
+    "generate:rule-types": "node --experimental-strip-types ../../scripts/generate-vize-rule-types.ts"
   }
 }

package/pkl/vize.pkl

@@ -65,12 +65,26 @@ class FormatterConfig {
 
 class LspConfig {
   enabled: Boolean? = null
+  lint: Boolean? = null
+  /// Deprecated: use `lint`.
   diagnostics: Boolean? = null
+  typecheck: Boolean? = null
+  editor: Boolean? = null
   completion: Boolean? = null
   hover: Boolean? = null
   definition: Boolean? = null
+  references: Boolean? = null
+  documentSymbols: Boolean? = null
+  workspaceSymbols: Boolean? = null
   formatting: Boolean? = null
   codeActions: Boolean? = null
+  rename: Boolean? = null
+  codeLens: Boolean? = null
+  semanticTokens: Boolean? = null
+  documentLinks: Boolean? = null
+  foldingRanges: Boolean? = null
+  inlayHints: Boolean? = null
+  fileRename: Boolean? = null
   corsa: Boolean? = null
 }
 

package/schemas/vize.config.schema.json

@@ -210,8 +210,21 @@
         "enabled": {
           "type": "boolean"
         },
+        "lint": {
+          "type": "boolean",
+          "description": "Enable Vize linter diagnostics in the LSP. Defaults to false."
+        },
         "diagnostics": {
-          "type": "boolean"
+          "type": "boolean",
+          "description": "Deprecated alias for lint. Defaults to false."
+        },
+        "typecheck": {
+          "type": "boolean",
+          "description": "Enable type checking diagnostics and type-aware LSP integration. Defaults to false."
+        },
+        "editor": {
+          "type": "boolean",
+          "description": "Enable the editor assistance bundle: completion, hover, navigation, symbols, rename, code lens, semantic tokens, links, folding, inlay hints, and file rename handling. Formatting remains separately opt-in."
         },
         "completion": {
           "type": "boolean"
@@ -222,12 +235,42 @@
         "definition": {
           "type": "boolean"
         },
+        "references": {
+          "type": "boolean"
+        },
+        "documentSymbols": {
+          "type": "boolean"
+        },
+        "workspaceSymbols": {
+          "type": "boolean"
+        },
         "formatting": {
           "type": "boolean"
         },
         "codeActions": {
           "type": "boolean"
         },
+        "rename": {
+          "type": "boolean"
+        },
+        "codeLens": {
+          "type": "boolean"
+        },
+        "semanticTokens": {
+          "type": "boolean"
+        },
+        "documentLinks": {
+          "type": "boolean"
+        },
+        "foldingRanges": {
+          "type": "boolean"
+        },
+        "inlayHints": {
+          "type": "boolean"
+        },
+        "fileRename": {
+          "type": "boolean"
+        },
         "corsa": {
           "type": "boolean"
         }
@@ -342,10 +385,7 @@
     "globalTypesConfig": {
       "type": "object",
       "additionalProperties": {
-        "oneOf": [
-          { "type": "string" },
-          { "$ref": "#/$defs/globalTypeDeclaration" }
-        ]
+        "oneOf": [{ "type": "string" }, { "$ref": "#/$defs/globalTypeDeclaration" }]
       }
     }
   }

package/src/cli.ts

@@ -1,8 +1,12 @@
-import { createRequire } from "module";
-import { readFileSync } from "fs";
+import { readFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import * as path from "node:path";
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
 import { loadConfig } from "./config.js";
 
 const require = createRequire(import.meta.url);
+const WORKSPACE_BINDING_PATH = "../../vize-native";
 
 // ============================================================================
 // Native binding loader (oxlint pattern)
@@ -73,14 +77,54 @@ interface NativeBinding {
 }
 
 function loadNative(): NativeBinding {
-  const pkg = getBindingPackageName();
+  const attemptedPackages = getAttemptedPackages();
+  let lastError: unknown = null;
+
+  for (const packageName of attemptedPackages) {
+    try {
+      const binding = require(packageName) as Partial<NativeBinding>;
+      if (typeof binding.lint !== "function") {
+        throw new Error(`${packageName} does not expose the lint binding.`);
+      }
+      return binding as NativeBinding;
+    } catch (error) {
+      lastError = error;
+    }
+  }
+
+  console.error(`Failed to load native binding. Tried: ${attemptedPackages.join(", ")}`);
+  console.error("Try reinstalling: npm install vize");
+  throw lastError instanceof Error ? lastError : new Error("Failed to load native binding");
+}
+
+function getAttemptedPackages(): readonly string[] {
+  const platformBindingPackage = getBindingPackageName();
+  return shouldPreferWorkspaceBinding(resolveWorkspaceBindingPath())
+    ? [WORKSPACE_BINDING_PATH, platformBindingPackage]
+    : [platformBindingPackage, WORKSPACE_BINDING_PATH];
+}
+
+function resolveWorkspaceBindingPath(): string | null {
   try {
-    return require(pkg);
-  } catch (e) {
-    console.error(`Failed to load native binding: ${pkg}`);
-    console.error("Try reinstalling: npm install vize");
-    throw e;
+    return require.resolve(WORKSPACE_BINDING_PATH);
+  } catch {
+    return null;
+  }
+}
+
+function shouldPreferWorkspaceBinding(resolvedPath: string | null): boolean {
+  const override = process.env.VIZE_PREFER_WORKSPACE_BINDING;
+  if (override === "1" || override === "true") {
+    return true;
+  }
+  if (override === "0" || override === "false") {
+    return false;
   }
+  if (resolvedPath == null) {
+    return false;
+  }
+
+  return resolvedPath.includes(`${path.sep}npm${path.sep}vize-native${path.sep}`);
 }
 
 // ============================================================================
@@ -115,6 +159,52 @@ interface ParsedLintCommand {
   sharedConfig: SharedConfigOptions;
 }
 
+function printUsage(): void {
+  console.error("Usage: vize <command> [options]");
+  console.error("Commands: lint, musea");
+}
+
+function resolvePackageBinaryFromCwd(packageName: string, binName: string = packageName): string {
+  const cwdRequire = createRequire(pathToFileURL(path.join(process.cwd(), "package.json")).href);
+  const packageJsonPath = cwdRequire.resolve(`${packageName}/package.json`);
+  const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8")) as {
+    bin?: string | Record<string, string>;
+  };
+
+  const bin = typeof packageJson.bin === "string" ? packageJson.bin : packageJson.bin?.[binName];
+
+  if (!bin) {
+    throw new Error(`Could not resolve binary '${binName}' from package '${packageName}'`);
+  }
+
+  return path.resolve(path.dirname(packageJsonPath), bin);
+}
+
+function runMusea(args: string[]): void {
+  const isHelp = args.includes("--help") || args.includes("-h");
+  if (isHelp) {
+    console.error("Usage: vize musea [--build] [...vite options]");
+    console.error("  --build    Run `vite build` instead of `vite dev`");
+    return;
+  }
+
+  const isBuild = args.includes("--build");
+  const viteArgs = args.filter((arg) => arg !== "--build");
+  const viteCommand = isBuild ? "build" : "dev";
+  const viteBin = resolvePackageBinaryFromCwd("vite");
+  const result = spawnSync(process.execPath, [viteBin, viteCommand, ...viteArgs], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    env: process.env,
+  });
+
+  if (result.error) {
+    throw result.error;
+  }
+
+  process.exit(result.status ?? 1);
+}
+
 function parseLintCommand(args: string[]): ParsedLintCommand {
   const patterns: string[] = [];
   const options: LintOptions = {};
@@ -216,14 +306,14 @@ async function runLint(args: string[]): Promise<void> {
 // ============================================================================
 
 const NAPI_COMMANDS = new Set(["lint"]);
+const JS_COMMANDS = new Set(["musea"]);
 
 async function main(): Promise<void> {
   const args = process.argv.slice(2);
   const command = args[0];
 
-  if (!command) {
-    console.error("Usage: vize <command> [options]");
-    console.error("Commands: lint");
+  if (!command || command === "--help" || command === "-h") {
+    printUsage();
     process.exit(1);
   }
 
@@ -234,7 +324,15 @@ async function main(): Promise<void> {
         await runLint(commandArgs);
         break;
     }
+  } else if (JS_COMMANDS.has(command)) {
+    const commandArgs = args.slice(1);
+    switch (command) {
+      case "musea":
+        runMusea(commandArgs);
+        break;
+    }
   } else {
+    printUsage();
     console.error(`Unknown command: ${command}`);
     console.error(
       "For commands not yet available via NAPI, install from source: cargo install vize",
@@ -243,7 +341,35 @@ async function main(): Promise<void> {
   }
 }
 
-void main().catch((error) => {
-  console.error(error instanceof Error ? error.message : String(error));
-  process.exit(1);
-});
+if (!import.meta.vitest) {
+  void main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  });
+}
+
+if (import.meta.vitest) {
+  const { describe, expect, it } = import.meta.vitest;
+
+  describe("shouldPreferWorkspaceBinding", () => {
+    it("detects the local workspace native package", () => {
+      expect(
+        shouldPreferWorkspaceBinding(
+          `${path.sep}Users${path.sep}example${path.sep}repo${path.sep}npm${path.sep}vize-native${path.sep}index.js`,
+        ),
+      ).toBe(true);
+    });
+
+    it("ignores published platform packages", () => {
+      expect(
+        shouldPreferWorkspaceBinding(
+          `${path.sep}repo${path.sep}node_modules${path.sep}.pnpm${path.sep}@vizejs+native-darwin-arm64${path.sep}node_modules${path.sep}@vizejs${path.sep}native-darwin-arm64${path.sep}index.js`,
+        ),
+      ).toBe(false);
+    });
+
+    it("returns false when the fallback package cannot be resolved", () => {
+      expect(shouldPreferWorkspaceBinding(null)).toBe(false);
+    });
+  });
+}

package/src/index.ts

@@ -28,6 +28,8 @@ export type {
   LintPreset,
   RuleSeverity,
   RuleCategory,
+  LintRuleName,
+  LintRulesConfig,
 } from "./types/index.js";
 
 // Config utilities

package/src/types/index.ts

@@ -8,6 +8,8 @@ export type {
   VizeConfig,
 } from "./core.js";
 
+export type { LintRuleName, LintRulesConfig } from "./rules.js";
+
 export type { CompilerConfig, VitePluginConfig } from "./compiler.js";
 
 export type { LinterConfig, TypeCheckerConfig, FormatterConfig, LspConfig } from "./tools.js";

package/src/types/rules.ts

@@ -0,0 +1,121 @@
+// This file is generated by scripts/generate-vize-rule-types.ts.
+// Do not edit it by hand.
+
+import type { RuleSeverity } from "./core.js";
+
+export const LINT_RULE_NAMES = [
+  "a11y/alt-text",
+  "a11y/anchor-has-content",
+  "a11y/anchor-is-valid",
+  "a11y/aria-props",
+  "a11y/aria-role",
+  "a11y/aria-unsupported-elements",
+  "a11y/click-events-have-key-events",
+  "a11y/form-control-has-label",
+  "a11y/heading-has-content",
+  "a11y/heading-levels",
+  "a11y/iframe-has-title",
+  "a11y/img-alt",
+  "a11y/interactive-supports-focus",
+  "a11y/label-has-for",
+  "a11y/landmark-roles",
+  "a11y/media-has-caption",
+  "a11y/mouse-events-have-key-events",
+  "a11y/no-access-key",
+  "a11y/no-aria-hidden-on-focusable",
+  "a11y/no-autofocus",
+  "a11y/no-distracting-elements",
+  "a11y/no-i-for-icon",
+  "a11y/no-redundant-roles",
+  "a11y/no-refer-to-non-existent-id",
+  "a11y/no-role-presentation-on-focusable",
+  "a11y/no-static-element-interactions",
+  "a11y/placeholder-label-option",
+  "a11y/role-has-required-aria-props",
+  "a11y/tabindex-no-positive",
+  "a11y/use-list",
+  "html/deprecated-attr",
+  "html/deprecated-element",
+  "html/id-duplication",
+  "html/no-consecutive-br",
+  "html/no-duplicate-dt",
+  "html/no-empty-palpable-content",
+  "html/require-datetime",
+  "script/no-get-current-instance",
+  "script/no-next-tick",
+  "script/no-options-api",
+  "ssr/no-browser-globals-in-ssr",
+  "ssr/no-hydration-mismatch",
+  "type/no-floating-promises",
+  "type/no-unsafe-template-binding",
+  "type/require-typed-emits",
+  "type/require-typed-props",
+  "vapor/no-inline-template",
+  "vapor/no-suspense",
+  "vapor/no-vue-lifecycle-events",
+  "vapor/prefer-static-class",
+  "vapor/require-vapor-attribute",
+  "vue/attribute-hyphenation",
+  "vue/attribute-order",
+  "vue/component-definition-name-casing",
+  "vue/component-name-in-template-casing",
+  "vue/html-quotes",
+  "vue/html-self-closing",
+  "vue/multi-word-component-names",
+  "vue/mustache-interpolation-spacing",
+  "vue/no-boolean-attr-value",
+  "vue/no-child-content",
+  "vue/no-dupe-v-else-if",
+  "vue/no-duplicate-attributes",
+  "vue/no-inline-style",
+  "vue/no-lone-template",
+  "vue/no-multi-spaces",
+  "vue/no-mutating-props",
+  "vue/no-preprocessor-lang",
+  "vue/no-reserved-component-names",
+  "vue/no-script-non-standard-lang",
+  "vue/no-src-attribute",
+  "vue/no-template-key",
+  "vue/no-template-lang",
+  "vue/no-template-shadow",
+  "vue/no-textarea-mustache",
+  "vue/no-unsafe-url",
+  "vue/no-unused-components",
+  "vue/no-unused-properties",
+  "vue/no-unused-vars",
+  "vue/no-use-v-if-with-v-for",
+  "vue/no-useless-template-attributes",
+  "vue/no-v-html",
+  "vue/no-v-text-v-html-on-component",
+  "vue/permitted-contents",
+  "vue/prefer-props-shorthand",
+  "vue/prop-name-casing",
+  "vue/require-component-is",
+  "vue/require-component-registration",
+  "vue/require-scoped-style",
+  "vue/require-v-for-key",
+  "vue/scoped-event-names",
+  "vue/sfc-element-order",
+  "vue/single-style-block",
+  "vue/use-unique-element-ids",
+  "vue/use-v-on-exact",
+  "vue/v-bind-style",
+  "vue/v-on-style",
+  "vue/v-slot-style",
+  "vue/valid-attribute-name",
+  "vue/valid-v-bind",
+  "vue/valid-v-else",
+  "vue/valid-v-for",
+  "vue/valid-v-if",
+  "vue/valid-v-memo",
+  "vue/valid-v-model",
+  "vue/valid-v-on",
+  "vue/valid-v-show",
+  "vue/valid-v-slot",
+  "vue/warn-custom-block",
+  "vue/warn-custom-directive",
+] as const;
+
+export type LintRuleName = (typeof LINT_RULE_NAMES)[number];
+
+export type LintRulesConfig = Partial<Record<LintRuleName, RuleSeverity>>;