nimiq-branding-cli 1.2.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nimiq-branding-cli",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "nq — pixel-verified Nimiq UI component registry + CLI. 39 components (Vue 3 + plain HTML) diffed against the real Nimiq apps, plus the team's real asset library. Unofficial community tool.",
   "type": "module",
   "bin": {

package/scripts/_browser.mjs

@@ -0,0 +1,27 @@
+// Shared browser bootstrap for `nq lint` and `nq verify`.
+// Playwright is intentionally NOT a runtime dependency (it pulls a ~hundreds-of-MB browser),
+// so we load it lazily and, if it's missing, print a one-line fix instead of a raw stack
+// trace. Exit code 2 = "setup needed", distinct from lint's 1 = violations / 0 = clean.
+export async function launchChromium(cmd = 'this command') {
+  let chromium;
+  try {
+    ({ chromium } = await import('playwright'));
+  } catch {
+    console.error(
+      `\nnq: ${cmd} needs Playwright (a headless browser) to render pages.\n` +
+      `It isn't bundled, to keep installs light. One-time setup:\n\n` +
+      `  npm i -g playwright && npx playwright install chromium\n\n` +
+      `Then re-run. Only \`nq lint\` and \`nq verify\` need it — the rest of nq works without it.\n`,
+    );
+    process.exit(2);
+  }
+  try {
+    return await chromium.launch();
+  } catch (e) {
+    if (/Executable doesn't exist|playwright install|please run the following/i.test(String(e))) {
+      console.error(`\nnq: Playwright is installed but its browser isn't. Run:\n\n  npx playwright install chromium\n`);
+      process.exit(2);
+    }
+    throw e;
+  }
+}

package/scripts/lint.mjs

@@ -247,8 +247,8 @@ export async function lint(target, opts = {}) {
   if (!isUrl && !existsSync(filePath)) throw new Error(`no such file: ${target}`);
   const url = isUrl ? target : pathToFileURL(filePath).href;
 
-  const { chromium } = await import('playwright');
-  const browser = await chromium.launch();
+  const { launchChromium } = await import('./_browser.mjs');
+  const browser = await launchChromium('nq lint');
   const out = (s = '') => console.log(s);
   let errorCount = 0, warnCount = 0;
   try {

package/scripts/verify.mjs

@@ -18,7 +18,7 @@ export async function verify(name) {
   if (!existsSync(demo)) return { status: 'skip', reason: 'no html/demo.html' };
   if (!existsSync(ref)) return { status: 'skip', reason: 'no reference.png' };
 
-  const { chromium } = await import('playwright');
+  const { launchChromium } = await import('./_browser.mjs');
   const { PNG } = await import('pngjs');
   const pixelmatch = (await import('pixelmatch')).default;
 
@@ -26,7 +26,7 @@ export async function verify(name) {
   const viewport = v.viewport ?? { width: 800, height: 600 };
   const threshold = v.maxDiffPct ?? 1.0; // percent of pixels allowed to differ
 
-  const browser = await chromium.launch();
+  const browser = await launchChromium('nq verify');
   try {
     const page = await browser.newPage({ viewport, deviceScaleFactor: v.scale ?? 2 });
     await page.goto('file://' + demo);