@zenuml/core 3.48.1 → 3.48.2

package/dist/cli/zenuml.mjs

@@ -12758,6 +12758,13 @@ Examples:
   zenuml --parse -i diagram.zenuml
   zenuml -i readme.md --md
   zenuml -i readme.md --md -e png
+
+PNG output requires the optional Playwright runtime and a Chromium browser:
+  npm install playwright-core
+  npx playwright-core install chromium
+
+To use an existing Chrome/Chromium binary:
+  ZENUML_CHROMIUM_PATH=/path/to/chrome zenuml -i diagram.zenuml -o output.png
 `.trimStart();
   process.stdout.write(help);
 }
@@ -12899,11 +12906,42 @@ function loadConfigFile(filePath) {
   }
 }
 let _browser = null;
+function pngRuntimeHelp(detail) {
+  return [
+    detail,
+    "",
+    "PNG output requires Playwright's Chromium runtime.",
+    "Install it with:",
+    "  npm install playwright-core",
+    "  npx playwright-core install chromium",
+    "",
+    "Or point ZenUML at an existing Chrome/Chromium binary:",
+    "  ZENUML_CHROMIUM_PATH=/path/to/chrome zenuml -i diagram.zenuml -o diagram.png"
+  ].join("\n");
+}
 async function getPlaywrightBrowser() {
   if (_browser) return _browser;
-  const { chromium } = await import('playwright-core');
-  _browser = await chromium.launch();
-  return _browser;
+  let playwright;
+  try {
+    playwright = await import('playwright-core');
+  } catch (error) {
+    throw new Error(
+      pngRuntimeHelp(
+        `Cannot load optional dependency "playwright-core": ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
+  const executablePath = process.env["ZENUML_CHROMIUM_PATH"];
+  try {
+    _browser = await playwright.chromium.launch(executablePath ? { executablePath } : void 0);
+    return _browser;
+  } catch (error) {
+    throw new Error(
+      pngRuntimeHelp(
+        `Cannot launch Chromium${executablePath ? ` at ${executablePath}` : ""}: ${error instanceof Error ? error.message : String(error)}`
+      )
+    );
+  }
 }
 async function closeBrowser() {
   if (_browser) {