@mermanjs/node 0.8.0-alpha.5 → 0.8.0-alpha.6

package/dist/index.d.ts

@@ -7,6 +7,10 @@ export type MermanResourceProfile =
 export interface MermanBindingOptions {
   version?: 2;
   runtime_policy?: "deterministic";
+  environment?: {
+    text_measurement?: "deterministic";
+    [key: string]: unknown;
+  };
   resources?: {
     profile?: MermanResourceProfile;
     limits?: Record<string, number>;
@@ -22,10 +26,17 @@ export interface CreateNodeEngineOptions {
 
 export interface RenderSvgOptions {
   /**
-   * Cancels only while the request is waiting in the JS queue. Work that has started is not
-   * preempted and its Promise settles with the actual operation result.
+   * Cancels queued work immediately and requests cooperative cancellation after Rust work starts.
+   * A queued request rejects with AbortError; a started request rejects with MermanOperationError
+   * carrying canonical cancellation details once transport admission or a renderer checkpoint
+   * observes the request.
    */
   signal?: AbortSignal;
+  /**
+   * Relative monotonic deadline in milliseconds, starting when the Rust transport admits the
+   * operation. Values must be integers from 0 through 4,294,967,295.
+   */
+  timeoutMs?: number;
   /** Raw per-request options JSON merged by the shared binding contract. */
   optionsJson?: string;
 }
@@ -184,9 +195,12 @@ export declare class MermanEngine {
   metadataJson(id: string): string;
   executeOperation(
     request: MermanOperationRequest,
-    options?: Pick<RenderSvgOptions, "signal">,
+    options?: Pick<RenderSvgOptions, "signal" | "timeoutMs">,
   ): Promise<MermanOperationResult>;
-  executeOperationSync(request: MermanOperationRequest): MermanOperationResult;
+  executeOperationSync(
+    request: MermanOperationRequest,
+    options?: Pick<RenderSvgOptions, "timeoutMs">,
+  ): MermanOperationResult;
   dispose(): Promise<void>;
 }
 
@@ -213,12 +227,38 @@ export interface MermanResourceErrorDetails {
   readonly profile: string;
 }
 
+export interface MermanDiagnosticSpan {
+  readonly start: number;
+  readonly end: number;
+  readonly kind: "exact" | "insertion-point" | "fallback" | string;
+}
+
+export interface MermanDiagnosticErrorDetails {
+  readonly code: string;
+  readonly span: MermanDiagnosticSpan | null;
+  readonly field: string | null;
+  readonly diagram_type: string | null;
+  readonly requested_max_width?: number | null;
+  readonly actual_width?: number | null;
+  readonly width_profile?: string | null;
+  readonly fallback_reason?: string | null;
+}
+
+export interface MermanCancellationErrorDetails {
+  readonly reason: "requested" | "deadline_exceeded";
+  /** Renderer phase identifier; new Merman versions may add phases. */
+  readonly phase: string;
+  readonly [key: string]: unknown;
+}
+
 export declare class MermanOperationError extends MermanError {
   readonly status: number | null;
   readonly codeName: string | null;
   readonly kind: "generic" | "unknown-operation" | "missing-capability" | string;
   readonly capabilityId: string | null;
   readonly resourceDetails: MermanResourceErrorDetails | null;
+  readonly diagnosticDetails: MermanDiagnosticErrorDetails | null;
+  readonly cancellationDetails: MermanCancellationErrorDetails | null;
 }
 
 export declare class MermanQueueSaturatedError extends MermanError {
@@ -232,6 +272,10 @@ export declare class MermanMissingPlatformPackageError extends MermanError {
   readonly packageName: string;
   readonly target: string;
 }
+export declare class MermanNativeLoadError extends MermanError {
+  readonly packageName: string;
+  readonly target: string;
+}
 export declare class MermanUnsupportedTargetError extends MermanError {
   readonly platform: string;
   readonly arch: string;

package/dist/index.mjs

@@ -16,6 +16,7 @@ export {
   MermanInvalidTransportError,
   MermanLifecycleError,
   MermanMissingPlatformPackageError,
+  MermanNativeLoadError,
   MermanOperationError,
   MermanQueueSaturatedError,
   MermanUnsupportedTargetError,

package/dist/native-loader.mjs

@@ -3,6 +3,7 @@ import { createRequire } from "node:module";
 import {
   MermanInvalidTransportError,
   MermanMissingPlatformPackageError,
+  MermanNativeLoadError,
   MermanUnsupportedTargetError,
   parseRuntimeCatalogJsonText,
 } from "./errors.mjs";
@@ -79,6 +80,9 @@ export function loadNativeBinding({
     if (isMissingModule(cause)) {
       throw new MermanMissingPlatformPackageError({ packageName, target, cause });
     }
+    if (isNativeLoadFailure(cause)) {
+      throw new MermanNativeLoadError({ packageName, target, cause });
+    }
     throw cause;
   }
 }
@@ -110,3 +114,12 @@ function isMissingModule(error) {
       (error.code === "MODULE_NOT_FOUND" || error.code === "ERR_MODULE_NOT_FOUND"),
   );
 }
+
+function isNativeLoadFailure(error) {
+  if (!error || typeof error !== "object") return false;
+  if (error.code === "ERR_DLOPEN_FAILED") return true;
+  return typeof error.message === "string" &&
+    /(?:GLIBC(?:XX)?_|CXXABI_|invalid ELF|wrong ELF|shared object file|not a valid Win32|mach-?o)/i.test(
+      error.message,
+    );
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mermanjs/node",
-  "version": "0.8.0-alpha.5",
+  "version": "0.8.0-alpha.6",
   "description": "Experimental native Node.js and static-site rendering bindings for Merman.",
   "type": "module",
   "engines": {
@@ -41,10 +41,10 @@
   ],
   "license": "MIT OR Apache-2.0",
   "optionalDependencies": {
-    "@mermanjs/node-darwin-arm64": "0.8.0-alpha.5",
-    "@mermanjs/node-darwin-x64": "0.8.0-alpha.5",
-    "@mermanjs/node-linux-x64-gnu": "0.8.0-alpha.5",
-    "@mermanjs/node-linux-x64-musl": "0.8.0-alpha.5",
-    "@mermanjs/node-win32-x64-msvc": "0.8.0-alpha.5"
+    "@mermanjs/node-darwin-arm64": "0.8.0-alpha.6",
+    "@mermanjs/node-darwin-x64": "0.8.0-alpha.6",
+    "@mermanjs/node-linux-x64-gnu": "0.8.0-alpha.6",
+    "@mermanjs/node-linux-x64-musl": "0.8.0-alpha.6",
+    "@mermanjs/node-win32-x64-msvc": "0.8.0-alpha.6"
   }
 }