@vizejs/wasm 0.290.0 → 0.302.0

package/index.d.ts

@@ -4,6 +4,54 @@
  * This package provides WebAssembly bindings for the Vue compiler implemented in Rust.
  */
 
+import type { FormatOptions, FormatResult, LintOptions, LintResult } from "./lint-format.js";
+
+export type {
+  FormatOptions,
+  FormatResult,
+  LintDiagnostic,
+  LintOptions,
+  LintPosition,
+  LintPreset,
+  LintResult,
+} from "./lint-format.js";
+
+/** Binding classification accepted by template identifier rewriting. */
+export type BindingType =
+  | "setup-let"
+  | "setup-maybe-ref"
+  | "setup-ref"
+  | "setup-reactive-const"
+  | "setup-const"
+  | "props"
+  | "props-aliased"
+  | "data"
+  | "options"
+  | "literal-const"
+  | "js-global-universal"
+  | "js-global-browser"
+  | "js-global-node"
+  | "js-global-deno"
+  | "js-global-bun"
+  | "vue-global"
+  | "external-module";
+
+export interface BindingMetadata {
+  bindings: Record<string, BindingType>;
+  propsAliases: Record<string, string>;
+  isScriptSetup: boolean;
+}
+
+/** Source Map v3 emitted for a directly compiled VDOM template. */
+export interface SourceMap {
+  version: 3;
+  file: string;
+  sources: string[];
+  sourcesContent: string[];
+  names: string[];
+  mappings: string;
+}
+
 /** Compiler options for template compilation */
 export interface CompilerOptions {
   /** Output mode: "module" or "function" */
@@ -18,9 +66,9 @@ export interface CompilerOptions {
   scopeId?: string;
   /** Whether in SSR mode */
   ssr?: boolean;
-  /** Whether to generate source map */
+  /** Whether to generate a source map for direct VDOM template compilation */
   sourceMap?: boolean;
-  /** Filename for source map */
+  /** Filename used for source-map identity, SFC parsing, and generated module IDs */
   filename?: string;
   /** Output mode: "vdom" or "vapor" */
   outputMode?: "vdom" | "vapor";
@@ -28,7 +76,21 @@ export interface CompilerOptions {
   isTs?: boolean;
   /** Whether the template targets a custom renderer instead of the DOM. */
   customRenderer?: boolean;
-  /** Enable Vue parser quirk compatibility for known edge cases. */
+  /** Template syntax compatibility mode. */
+  templateSyntax?: "standard" | "strict" | "quirks";
+  /** Enable Vue in-tag comments (`// ...`) inside opening tags. */
+  experimentalInTagComments?: boolean;
+  /** Enable `v-match` / `v-case` patterned template desugaring. */
+  experimentalPatternedTemplate?: boolean;
+  /** Runtime package imported by generated VDOM modules and SFC client output. */
+  runtimeModuleName?: string;
+  /** Runtime global read by function-mode VDOM and standalone SFC client output. */
+  runtimeGlobalName?: string;
+  /** SFC TypeScript output handling. */
+  scriptExt?: "preserve" | "downcompile";
+  /** Script binding information used by direct template compilation. */
+  bindingMetadata?: BindingMetadata;
+  /** @deprecated Use `templateSyntax: "quirks"`. */
   vueParserQuirks?: boolean;
 }
 
@@ -40,8 +102,8 @@ export interface CompileResult {
   preamble: string;
   /** AST (serialized) */
   ast: object;
-  /** Source map */
-  map?: object | null;
+  /** Source map, present when `sourceMap` is enabled for VDOM output. */
+  map?: SourceMap;
   /** Used helpers */
   helpers: string[];
   /** Template strings for Vapor mode static parts */
@@ -123,10 +185,7 @@ export interface SfcParseOptions {
 }
 
 /** SFC compile options */
-export interface SfcCompileOptions extends CompilerOptions {
-  /** Filename for the SFC */
-  filename?: string;
-}
+export interface SfcCompileOptions extends CompilerOptions {}
 
 /** Result of SFC compilation */
 export interface SfcCompileResult {
@@ -139,7 +198,7 @@ export interface SfcCompileResult {
     /** Generated JavaScript code */
     code: string;
     /** Binding metadata */
-    bindings?: object;
+    bindings?: BindingMetadata;
   };
   /** Generated CSS */
   css?: string;
@@ -149,6 +208,8 @@ export interface SfcCompileResult {
   warnings: string[];
   /** Compile-time macro artifacts */
   macroArtifacts?: MacroArtifact[];
+  /** Flat binding map for feeding a later template-only compile. */
+  bindingMetadata?: Record<string, BindingType>;
 }
 
 /** JSX/TSX compile options */
@@ -248,50 +309,35 @@ export declare class Compiler {
 }
 
 /** Compile template to VDom render function */
-export declare function compile(
-  template: string,
-  options?: CompilerOptions
-): CompileResult;
+export declare function compile(template: string, options?: CompilerOptions): CompileResult;
 
 /** Compile template to Vapor mode */
-export declare function compileVapor(
-  template: string,
-  options?: CompilerOptions
-): CompileResult;
+export declare function compileVapor(template: string, options?: CompilerOptions): CompileResult;
 
 /** Parse template to AST */
-export declare function parseTemplate(
-  template: string,
-  options?: CompilerOptions
-): object;
+export declare function parseTemplate(template: string, options?: CompilerOptions): object;
 
 /** Parse SFC (.vue file) */
-export declare function parseSfc(
-  source: string,
-  options?: SfcParseOptions
-): SfcDescriptor;
+export declare function parseSfc(source: string, options?: SfcParseOptions): SfcDescriptor;
 
 /** Compile SFC (.vue file) */
-export declare function compileSfc(
-  source: string,
-  options?: SfcCompileOptions
-): SfcCompileResult;
+export declare function compileSfc(source: string, options?: SfcCompileOptions): SfcCompileResult;
 
 /** Compile JSX/TSX to render code */
-export declare function compileJsx(
-  source: string,
-  options?: JsxCompileOptions
-): JsxCompileResult;
+export declare function compileJsx(source: string, options?: JsxCompileOptions): JsxCompileResult;
 
 /** Compile CSS with LightningCSS */
-export declare function compileCss(
-  css: string,
-  options?: CssCompileOptions
-): CssCompileResult;
+export declare function compileCss(css: string, options?: CssCompileOptions): CssCompileResult;
+
+/** Lint a Vue SFC */
+export declare function lintSfc(source: string, options?: LintOptions): LintResult;
+
+/** Format a Vue SFC */
+export declare function formatSfc(source: string, options?: FormatOptions): FormatResult;
 
 /** Initialize the WASM module */
 export declare function init(
-  moduleOrPath?: RequestInfo | URL | Response | BufferSource | WebAssembly.Module
+  moduleOrPath?: RequestInfo | URL | Response | BufferSource | WebAssembly.Module,
 ): Promise<void>;
 
 /** Check if the WASM module is initialized */

package/index.js

@@ -13,6 +13,8 @@ import initWasm, {
   compileSfc as wasmCompileSfc,
   compileJsx as wasmCompileJsx,
   compileCss as wasmCompileCss,
+  lintSfc as wasmLintSfc,
+  formatSfc as wasmFormatSfc,
 } from "./vize_vitrine.js";
 
 let initialized = false;
@@ -34,9 +36,17 @@ export async function init(moduleOrPath) {
     return initPromise;
   }
 
-  initPromise = initWasm(moduleOrPath).then(() => {
-    initialized = true;
-  });
+  const initOptions =
+    moduleOrPath === undefined ? undefined : { module_or_path: moduleOrPath };
+  initPromise = initWasm(initOptions).then(
+    () => {
+      initialized = true;
+    },
+    (error) => {
+      initPromise = null;
+      throw error;
+    }
+  );
 
   return initPromise;
 }
@@ -237,4 +247,28 @@ export function compileCss(css, options = {}) {
   return wasmCompileCss(css, options);
 }
 
+/**
+ * Lint a Vue SFC.
+ *
+ * @param {string} source
+ * @param {object} [options]
+ * @returns {object}
+ */
+export function lintSfc(source, options = {}) {
+  ensureInitialized();
+  return wasmLintSfc(source, options);
+}
+
+/**
+ * Format a Vue SFC.
+ *
+ * @param {string} source
+ * @param {object} [options]
+ * @returns {object}
+ */
+export function formatSfc(source, options = {}) {
+  ensureInitialized();
+  return wasmFormatSfc(source, options);
+}
+
 export default init;

package/lint-format.d.ts

@@ -0,0 +1,93 @@
+/** Built-in lint preset. */
+export type LintPreset =
+  | "general-recommended"
+  | "happy-path"
+  | "essential"
+  | "incremental"
+  | "ecosystem"
+  | "opinionated"
+  | "nuxt";
+
+/** Options for linting a Vue SFC. */
+export interface LintOptions {
+  /** Filename reported in the result (default: "anonymous.vue"). */
+  filename?: string;
+  /** Built-in lint preset (default: "ecosystem"). */
+  preset?: LintPreset;
+  /** Run only the named rules. */
+  enabledRules?: string[];
+  /** Locale for diagnostic messages (default: "en"). */
+  locale?: "en" | "ja" | "zh";
+}
+
+/** One-based source position reported by the linter. */
+export interface LintPosition {
+  /** One-based line number. */
+  line: number;
+  /** One-based column number. */
+  column: number;
+  /** Byte offset in the original source. */
+  offset: number;
+}
+
+/** Diagnostic reported by the linter. */
+export interface LintDiagnostic {
+  /** Rule that produced the diagnostic. */
+  rule: string;
+  /** Diagnostic severity. */
+  severity: "error" | "warning";
+  /** Localized diagnostic message. */
+  message: string;
+  /** Location in the original source. */
+  location: {
+    start: LintPosition;
+    end: LintPosition;
+  };
+  /** Optional remediation hint. */
+  help: string | undefined;
+}
+
+/** Result of linting a Vue SFC. */
+export interface LintResult {
+  /** Filename associated with the source. */
+  filename: string;
+  /** Number of error diagnostics. */
+  errorCount: number;
+  /** Number of warning diagnostics. */
+  warningCount: number;
+  /** Diagnostics in source order. */
+  diagnostics: LintDiagnostic[];
+}
+
+/** Options for formatting a Vue SFC. */
+export interface FormatOptions {
+  printWidth?: number;
+  tabWidth?: number;
+  useTabs?: boolean;
+  semi?: boolean;
+  singleQuote?: boolean;
+  jsxSingleQuote?: boolean;
+  trailingComma?: "none" | "es5" | "all";
+  bracketSpacing?: boolean;
+  bracketSameLine?: boolean;
+  arrowParens?: "always" | "avoid";
+  endOfLine?: "lf" | "crlf" | "cr" | "auto";
+  quoteProps?: "as-needed" | "consistent" | "preserve";
+  singleAttributePerLine?: boolean;
+  vueIndentScriptAndStyle?: boolean;
+  sortAttributes?: boolean;
+  attributeSortOrder?: "alphabetical" | "as-written";
+  mergeBindAndNonBindAttrs?: boolean;
+  maxAttributesPerLine?: number | null;
+  attributeGroups?: string[][] | null;
+  normalizeDirectiveShorthands?: boolean;
+  sortBlocks?: boolean;
+}
+
+/** Result of formatting a Vue SFC. */
+export interface FormatResult {
+  /** Formatted source. */
+  code: string;
+  /** Whether the source changed. */
+  changed: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizejs/wasm",
-  "version": "0.290.0",
+  "version": "0.302.0",
   "description": "Vize WASM bindings for browser environments",
   "homepage": "https://github.com/ubugeeei-prod/vize",
   "bugs": {
@@ -15,6 +15,7 @@
   "files": [
     "index.js",
     "index.d.ts",
+    "lint-format.d.ts",
     "vize_vitrine_bg.wasm",
     "vize_vitrine.js",
     "vize_vitrine.d.ts",