@vizejs/native 0.425.1 → 0.426.0

package/index.d.ts

@@ -706,6 +706,107 @@ export interface LintResultNapi {
   timeMs: number;
 }
 
+/** A plugin as the SDK's `definePlugin` hands it to the host. */
+export interface JsPluginNapi {
+  name: string;
+  version: string;
+  /** The SDK's digest of the plugin's rule sources. */
+  fingerprint: string;
+  visit?: Array<string>;
+  demands?: Array<string>;
+  /** Configuration and ambient values read by the rule. Required for caching. */
+  cacheInputs?: Array<PluginCacheInputNapi>;
+  /** `(batchJson) => reportsJson` — one call per document. */
+  run: (arg: string) => string;
+}
+
+/** One stable value a cached JS plugin declares it reads outside the batch. */
+export interface PluginCacheInputNapi {
+  name: string;
+  value: string;
+}
+
+export interface PluginLintOptionsNapi {
+  filename?: string;
+  /** Reuse a result whose content key this process has already seen. */
+  cache?: boolean;
+  /** Optional directory for reusing results across Node processes. */
+  cacheDir?: string;
+}
+
+export interface PluginDiagnosticNapi {
+  ruleId: string;
+  plugin: string;
+  severity: string;
+  message: string;
+  start: number;
+  end: number;
+  line: number;
+  column: number;
+  endLine: number;
+  endColumn: number;
+}
+
+/** One plugin's cost in this lint run. */
+export interface PluginCostNapi {
+  name: string;
+  version: string;
+  contentKey: string;
+  /** Nodes in the plugin's batch (0 when served from the cache). */
+  nodes: number;
+  batchBytes: number;
+  reports: number;
+  cached: boolean;
+  /** Host time for this plugin: batch build, the JS call, report mapping. */
+  elapsedNs: number;
+  /** The JS call alone. */
+  jsNs: number;
+}
+
+export interface PluginLintOutputNapi {
+  filename: string;
+  diagnostics: Array<PluginDiagnosticNapi>;
+  plugins: Array<PluginCostNapi>;
+}
+
+/**
+ * Lint one SFC with JS plugins: one batch and one call per plugin, every
+ * plugin's cost attributed, diagnostics in the host's one order.
+ */
+export declare function lintWithPlugins(
+  source: string,
+  plugins: Array<JsPluginNapi>,
+  options?: PluginLintOptionsNapi | undefined | null,
+): PluginLintOutputNapi;
+
+/**
+ * The proxy arm the spike measured and rejected: the same document behind
+ * a handle whose every read is one napi call.
+ */
+export declare class PluginDocumentHandle {
+  /** How many nodes the document has (ids are `0..count`). */
+  count(): number;
+  kind(id: number): string | null;
+  /** The owning node, or -1. */
+  parent(id: number): number;
+  /** `name`, `value`, `alias.value`, `alias.key` or `alias.index`. */
+  field(id: number, key: string): string | null;
+  /** The names scope `id` binds (`templateScopes`), or `null`. */
+  scope(id: number): Array<ScopeEntryNapi> | null;
+}
+
+/** Open the proxy-arm handle over one SFC, computing `templateScopes`. */
+export declare function openPluginDocument(
+  source: string,
+  filename?: string | undefined | null,
+): PluginDocumentHandle;
+
+/** One `templateScopes` entry on the proxy arm. */
+export interface ScopeEntryNapi {
+  name: string;
+  position: string;
+}
+
 export interface MacroArtifactNapi {
   kind: string;
   name: string;

package/index.js

@@ -5,6 +5,7 @@
 const nativeBinding = require("./native-binding");
 
 module.exports = nativeBinding;
+module.exports.PluginDocumentHandle = nativeBinding.PluginDocumentHandle;
 module.exports.applyViteDefineReplacements = nativeBinding.applyViteDefineReplacements;
 module.exports.artToCsf = nativeBinding.artToCsf;
 module.exports.buildDesignTokenMap = nativeBinding.buildDesignTokenMap;
@@ -52,6 +53,7 @@ module.exports.isSfcImportableAssetUrl = nativeBinding.isSfcImportableAssetUrl;
 module.exports.isViteBareSpecifier = nativeBinding.isViteBareSpecifier;
 module.exports.lint = nativeBinding.lint;
 module.exports.lintPatinaSfc = nativeBinding.lintPatinaSfc;
+module.exports.lintWithPlugins = nativeBinding.lintWithPlugins;
 module.exports.normalizeViteCssModuleFilename = nativeBinding.normalizeViteCssModuleFilename;
 module.exports.normalizeViteDevMiddlewareUrl = nativeBinding.normalizeViteDevMiddlewareUrl;
 module.exports.normalizeViteFsIdForBuild = nativeBinding.normalizeViteFsIdForBuild;
@@ -60,6 +62,7 @@ module.exports.normalizeViteRequireBase = nativeBinding.normalizeViteRequireBase
 module.exports.normalizeViteResolvedVuePath = nativeBinding.normalizeViteResolvedVuePath;
 module.exports.normalizeViteVirtualVueModuleId = nativeBinding.normalizeViteVirtualVueModuleId;
 module.exports.normalizeVizeConfig = nativeBinding.normalizeVizeConfig;
+module.exports.openPluginDocument = nativeBinding.openPluginDocument;
 module.exports.parseArt = nativeBinding.parseArt;
 module.exports.parseArtStatusWarnings = nativeBinding.parseArtStatusWarnings;
 module.exports.parseCssAst = nativeBinding.parseCssAst;

package/package.json

@@ -47,14 +47,14 @@
     ]
   },
   "optionalDependencies": {
-    "@vizejs/native-darwin-arm64": "0.425.1",
-    "@vizejs/native-darwin-x64": "0.425.1",
-    "@vizejs/native-linux-arm64-gnu": "0.425.1",
-    "@vizejs/native-linux-arm64-musl": "0.425.1",
-    "@vizejs/native-linux-x64-gnu": "0.425.1",
-    "@vizejs/native-linux-x64-musl": "0.425.1",
-    "@vizejs/native-win32-arm64-msvc": "0.425.1",
-    "@vizejs/native-win32-x64-msvc": "0.425.1"
+    "@vizejs/native-darwin-arm64": "0.426.0",
+    "@vizejs/native-darwin-x64": "0.426.0",
+    "@vizejs/native-linux-arm64-gnu": "0.426.0",
+    "@vizejs/native-linux-arm64-musl": "0.426.0",
+    "@vizejs/native-linux-x64-gnu": "0.426.0",
+    "@vizejs/native-linux-x64-musl": "0.426.0",
+    "@vizejs/native-win32-arm64-msvc": "0.426.0",
+    "@vizejs/native-win32-x64-msvc": "0.426.0"
   },
   "publishConfig": {
     "access": "public"
@@ -65,7 +65,7 @@
     "url": "https://github.com/ubugeeei-prod/vize"
   },
   "types": "index.d.ts",
-  "version": "0.425.1",
+  "version": "0.426.0",
   "scripts": {
     "build": "node ./scripts/build-local.mjs --release",
     "build:ci": "napi build --platform --profile ci --manifest-path ../../crates/vize_vitrine/Cargo.toml -p vize_vitrine --features napi,legacy --output-dir . && node ./scripts/sync-entrypoint.mjs",