@vizejs/wasm 0.100.0 → 0.102.0

package/index.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Vize - WASM bindings
+ *
+ * This package provides WebAssembly bindings for the Vue compiler implemented in Rust.
+ */
+
+/** Compiler options for template compilation */
+export interface CompilerOptions {
+  /** Output mode: "module" or "function" */
+  mode?: "module" | "function";
+  /** Whether to prefix identifiers */
+  prefixIdentifiers?: boolean;
+  /** Whether to hoist static nodes */
+  hoistStatic?: boolean;
+  /** Whether to cache event handlers */
+  cacheHandlers?: boolean;
+  /** Scope ID for scoped CSS */
+  scopeId?: string;
+  /** Whether in SSR mode */
+  ssr?: boolean;
+  /** Whether to generate source map */
+  sourceMap?: boolean;
+  /** Filename for source map */
+  filename?: string;
+  /** Output mode: "vdom" or "vapor" */
+  outputMode?: "vdom" | "vapor";
+  /** Whether the template contains TypeScript */
+  isTs?: boolean;
+}
+
+/** Result of template compilation */
+export interface CompileResult {
+  /** Generated code */
+  code: string;
+  /** Preamble code (imports) */
+  preamble: string;
+  /** AST (serialized) */
+  ast: object;
+  /** Source map */
+  map?: object | null;
+  /** Used helpers */
+  helpers: string[];
+  /** Template strings for Vapor mode static parts */
+  templates?: string[];
+}
+
+/** SFC block (template, script, style) */
+export interface SfcBlock {
+  /** Block content */
+  content: string;
+  /** Source location */
+  loc: { start: number; end: number };
+  /** Language (e.g., "ts", "scss") */
+  lang?: string;
+  /** External source URL */
+  src?: string;
+  /** Block attributes */
+  attrs: Record<string, string | true>;
+}
+
+/** SFC script block */
+export interface SfcScriptBlock extends SfcBlock {
+  /** Whether this is a setup script */
+  setup: boolean;
+}
+
+/** SFC style block */
+export interface SfcStyleBlock extends SfcBlock {
+  /** Whether the style is scoped */
+  scoped: boolean;
+  /** CSS module name */
+  module?: string | true;
+}
+
+/** Compile-time macro artifact extracted from an SFC */
+export interface MacroArtifact {
+  /** Stable artifact kind */
+  kind: string;
+  /** Macro call name */
+  name: string;
+  /** Full macro call source */
+  source: string;
+  /** Extracted macro payload source */
+  content: string;
+  /** Ready-to-load virtual module code */
+  moduleCode?: string;
+  /** Absolute start offset in the SFC source */
+  start: number;
+  /** Absolute end offset in the SFC source */
+  end: number;
+}
+
+/** SFC descriptor (parsed .vue file) */
+export interface SfcDescriptor {
+  /** Filename */
+  filename: string;
+  /** Original source */
+  source: string;
+  /** Template block */
+  template?: SfcBlock;
+  /** Script block */
+  script?: SfcScriptBlock;
+  /** Script setup block */
+  scriptSetup?: SfcScriptBlock;
+  /** Style blocks */
+  styles: SfcStyleBlock[];
+  /** Custom blocks */
+  customBlocks: Array<{
+    type: string;
+    content: string;
+    attrs: Record<string, string | true>;
+  }>;
+}
+
+/** SFC parse options */
+export interface SfcParseOptions {
+  /** Filename for the SFC */
+  filename?: string;
+}
+
+/** SFC compile options */
+export interface SfcCompileOptions extends CompilerOptions {
+  /** Filename for the SFC */
+  filename?: string;
+}
+
+/** Result of SFC compilation */
+export interface SfcCompileResult {
+  /** Parsed SFC descriptor */
+  descriptor: SfcDescriptor;
+  /** Compiled template result */
+  template?: CompileResult;
+  /** Compiled script result */
+  script: {
+    /** Generated JavaScript code */
+    code: string;
+    /** Binding metadata */
+    bindings?: object;
+  };
+  /** Generated CSS */
+  css?: string;
+  /** Compilation errors */
+  errors: string[];
+  /** Compilation warnings */
+  warnings: string[];
+  /** Compile-time macro artifacts */
+  macroArtifacts?: MacroArtifact[];
+}
+
+/** CSS compile options */
+export interface CssCompileOptions {
+  /** Scope ID for scoped CSS */
+  scopeId?: string;
+  /** Whether to scope the CSS */
+  scoped?: boolean;
+  /** Whether to minify */
+  minify?: boolean;
+  /** Whether to generate source map */
+  sourceMap?: boolean;
+  /** Filename for source map */
+  filename?: string;
+  /** Browser targets for CSS transformations */
+  targets?: {
+    chrome?: number;
+    firefox?: number;
+    safari?: number;
+    edge?: number;
+    ios?: number;
+    android?: number;
+  };
+}
+
+/** Result of CSS compilation */
+export interface CssCompileResult {
+  /** Generated CSS code */
+  code: string;
+  /** Source map (if requested) */
+  map?: string;
+  /** CSS variables used via v-bind() */
+  cssVars: string[];
+  /** Compilation errors */
+  errors: string[];
+  /** Compilation warnings */
+  warnings: string[];
+}
+
+/** WASM Compiler class */
+export declare class Compiler {
+  constructor();
+
+  /** Compile template to VDom render function */
+  compile(template: string, options?: CompilerOptions): CompileResult;
+
+  /** Compile template to Vapor mode */
+  compileVapor(template: string, options?: CompilerOptions): CompileResult;
+
+  /** Parse template to AST */
+  parse(template: string, options?: CompilerOptions): object;
+
+  /** Parse SFC (.vue file) */
+  parseSfc(source: string, options?: SfcParseOptions): SfcDescriptor;
+
+  /** Compile SFC (.vue file) */
+  compileSfc(source: string, options?: SfcCompileOptions): SfcCompileResult;
+
+  /** Compile CSS with LightningCSS */
+  compileCss(css: string, options?: CssCompileOptions): CssCompileResult;
+
+  /** Free the WASM memory (called automatically via Symbol.dispose) */
+  free(): void;
+
+  /** Disposable interface */
+  [Symbol.dispose](): void;
+}
+
+/** Compile template to VDom render function */
+export declare function compile(
+  template: string,
+  options?: CompilerOptions
+): CompileResult;
+
+/** Compile template to Vapor mode */
+export declare function compileVapor(
+  template: string,
+  options?: CompilerOptions
+): CompileResult;
+
+/** Parse template to AST */
+export declare function parseTemplate(
+  template: string,
+  options?: CompilerOptions
+): object;
+
+/** Parse SFC (.vue file) */
+export declare function parseSfc(
+  source: string,
+  options?: SfcParseOptions
+): SfcDescriptor;
+
+/** Compile SFC (.vue file) */
+export declare function compileSfc(
+  source: string,
+  options?: SfcCompileOptions
+): SfcCompileResult;
+
+/** Compile CSS with LightningCSS */
+export declare function compileCss(
+  css: string,
+  options?: CssCompileOptions
+): CssCompileResult;
+
+/** Initialize the WASM module */
+export declare function init(
+  moduleOrPath?: RequestInfo | URL | Response | BufferSource | WebAssembly.Module
+): Promise<void>;
+
+/** Check if the WASM module is initialized */
+export declare function isInitialized(): boolean;
+
+export default init;

package/index.js

@@ -0,0 +1,227 @@
+/**
+ * Vize - WASM bindings
+ *
+ * This module provides WebAssembly bindings for the Vue compiler implemented in Rust.
+ */
+
+import initWasm, {
+  Compiler as WasmCompiler,
+  compile as wasmCompile,
+  compileVapor as wasmCompileVapor,
+  parseTemplate as wasmParseTemplate,
+  parseSfc as wasmParseSfc,
+  compileSfc as wasmCompileSfc,
+  compileCss as wasmCompileCss,
+} from "./vize_vitrine.js";
+
+let initialized = false;
+let initPromise = null;
+
+/**
+ * Initialize the WASM module.
+ * Must be called before using any other functions.
+ *
+ * @param {RequestInfo | URL | Response | BufferSource | WebAssembly.Module} [moduleOrPath]
+ * @returns {Promise<void>}
+ */
+export async function init(moduleOrPath) {
+  if (initialized) {
+    return;
+  }
+
+  if (initPromise) {
+    return initPromise;
+  }
+
+  initPromise = initWasm(moduleOrPath).then(() => {
+    initialized = true;
+  });
+
+  return initPromise;
+}
+
+/**
+ * Check if the WASM module is initialized.
+ *
+ * @returns {boolean}
+ */
+export function isInitialized() {
+  return initialized;
+}
+
+/**
+ * Ensure WASM is initialized, throwing if not.
+ */
+function ensureInitialized() {
+  if (!initialized) {
+    throw new Error(
+      "WASM module not initialized. Call `await init()` first."
+    );
+  }
+}
+
+/**
+ * WASM Compiler class wrapper.
+ */
+export class Compiler {
+  #inner;
+
+  constructor() {
+    ensureInitialized();
+    this.#inner = new WasmCompiler();
+  }
+
+  /**
+   * Compile template to VDom render function.
+   *
+   * @param {string} template
+   * @param {object} [options]
+   * @returns {object}
+   */
+  compile(template, options = {}) {
+    return this.#inner.compile(template, options);
+  }
+
+  /**
+   * Compile template to Vapor mode.
+   *
+   * @param {string} template
+   * @param {object} [options]
+   * @returns {object}
+   */
+  compileVapor(template, options = {}) {
+    return this.#inner.compileVapor(template, options);
+  }
+
+  /**
+   * Parse template to AST.
+   *
+   * @param {string} template
+   * @param {object} [options]
+   * @returns {object}
+   */
+  parse(template, options = {}) {
+    return this.#inner.parse(template, options);
+  }
+
+  /**
+   * Parse SFC (.vue file).
+   *
+   * @param {string} source
+   * @param {object} [options]
+   * @returns {object}
+   */
+  parseSfc(source, options = {}) {
+    return this.#inner.parseSfc(source, options);
+  }
+
+  /**
+   * Compile SFC (.vue file).
+   *
+   * @param {string} source
+   * @param {object} [options]
+   * @returns {object}
+   */
+  compileSfc(source, options = {}) {
+    return this.#inner.compileSfc(source, options);
+  }
+
+  /**
+   * Compile CSS with LightningCSS.
+   *
+   * @param {string} css
+   * @param {object} [options]
+   * @returns {object}
+   */
+  compileCss(css, options = {}) {
+    return this.#inner.compileCss(css, options);
+  }
+
+  /**
+   * Free the WASM memory.
+   */
+  free() {
+    this.#inner.free();
+  }
+
+  /**
+   * Disposable interface.
+   */
+  [Symbol.dispose]() {
+    this.free();
+  }
+}
+
+/**
+ * Compile template to VDom render function.
+ *
+ * @param {string} template
+ * @param {object} [options]
+ * @returns {object}
+ */
+export function compile(template, options = {}) {
+  ensureInitialized();
+  return wasmCompile(template, options);
+}
+
+/**
+ * Compile template to Vapor mode.
+ *
+ * @param {string} template
+ * @param {object} [options]
+ * @returns {object}
+ */
+export function compileVapor(template, options = {}) {
+  ensureInitialized();
+  return wasmCompileVapor(template, options);
+}
+
+/**
+ * Parse template to AST.
+ *
+ * @param {string} template
+ * @param {object} [options]
+ * @returns {object}
+ */
+export function parseTemplate(template, options = {}) {
+  ensureInitialized();
+  return wasmParseTemplate(template, options);
+}
+
+/**
+ * Parse SFC (.vue file).
+ *
+ * @param {string} source
+ * @param {object} [options]
+ * @returns {object}
+ */
+export function parseSfc(source, options = {}) {
+  ensureInitialized();
+  return wasmParseSfc(source, options);
+}
+
+/**
+ * Compile SFC (.vue file).
+ *
+ * @param {string} source
+ * @param {object} [options]
+ * @returns {object}
+ */
+export function compileSfc(source, options = {}) {
+  ensureInitialized();
+  return wasmCompileSfc(source, options);
+}
+
+/**
+ * Compile CSS with LightningCSS.
+ *
+ * @param {string} css
+ * @param {object} [options]
+ * @returns {object}
+ */
+export function compileCss(css, options = {}) {
+  ensureInitialized();
+  return wasmCompileCss(css, options);
+}
+
+export default init;

package/package.json

@@ -1,23 +1,42 @@
 {
   "name": "@vizejs/wasm",
-  "type": "module",
+  "version": "0.102.0",
   "description": "Vize WASM bindings for browser environments",
-  "version": "0.100.0",
+  "homepage": "https://github.com/ubugeeei/vize",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ubugeeei/vize.git",
     "directory": "npm/vize-wasm"
   },
-  "homepage": "https://github.com/ubugeeei/vize",
   "files": [
+    "index.js",
+    "index.d.ts",
     "vize_vitrine_bg.wasm",
     "vize_vitrine.js",
-    "vize_vitrine.d.ts"
+    "vize_vitrine.d.ts",
+    "snippets/**"
   ],
-  "main": "vize_vitrine.js",
-  "types": "vize_vitrine.d.ts",
+  "type": "module",
   "sideEffects": [
     "./snippets/*"
-  ]
+  ],
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./vize_vitrine.js": {
+      "types": "./vize_vitrine.d.ts",
+      "import": "./vize_vitrine.js",
+      "default": "./vize_vitrine.js"
+    },
+    "./vize_vitrine_bg.wasm": "./vize_vitrine_bg.wasm"
+  },
+  "engines": {
+    "node": ">=22"
+  }
 }