divoom-timesgate-sdk 0.1.0

package/dist/image/index.cjs

@@ -0,0 +1,515 @@
+'use strict';
+
+var sharp4 = require('sharp');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var sharp4__default = /*#__PURE__*/_interopDefault(sharp4);
+
+// src/image/load.ts
+
+// src/errors.ts
+var DivoomError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "DivoomError";
+  }
+};
+var DivoomValidationError = class extends DivoomError {
+  constructor(message) {
+    super(message);
+    this.name = "DivoomValidationError";
+  }
+};
+var DivoomConnectionError = class extends DivoomError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "DivoomConnectionError";
+  }
+};
+var DivoomTimeoutError = class extends DivoomError {
+  /** The command that timed out. */
+  command;
+  /** The timeout budget, in milliseconds, that was exceeded. */
+  timeoutMs;
+  constructor(command, timeoutMs) {
+    super(`Command "${command}" timed out after ${timeoutMs}ms.`);
+    this.name = "DivoomTimeoutError";
+    this.command = command;
+    this.timeoutMs = timeoutMs;
+  }
+};
+
+// src/constants.ts
+var PANEL_COUNT = 5;
+var PANEL_SIZE = 128;
+
+// src/utils.ts
+async function drainBody(response) {
+  try {
+    await response.body?.cancel?.();
+  } catch {
+  }
+}
+function assertIntInRange(value, min, max, label) {
+  if (!Number.isInteger(value) || value < min || value > max) {
+    throw new DivoomValidationError(
+      `${label} must be an integer between ${min} and ${max} (received ${String(value)}).`
+    );
+  }
+}
+function assertPanelIndex(value) {
+  if (!Number.isInteger(value) || value < 0 || value >= PANEL_COUNT) {
+    throw new DivoomValidationError(
+      `panel must be an integer between 0 and ${PANEL_COUNT - 1} (received ${String(value)}).`
+    );
+  }
+}
+function assertNonEmptyString(value, label) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new DivoomValidationError(`${label} must be a non-empty string.`);
+  }
+}
+
+// src/image/load.ts
+var DEFAULT_FETCH_TIMEOUT_MS = 15e3;
+var DEFAULT_MAX_IMAGE_BYTES = 64 * 1024 * 1024;
+var MAX_REDIRECTS = 5;
+function isSharp(value) {
+  return typeof value === "object" && value !== null && typeof value.toBuffer === "function" && typeof value.resize === "function";
+}
+async function readCapped(response, maxBytes, url) {
+  const body = response.body;
+  if (!body) {
+    const buffer = Buffer.from(await response.arrayBuffer());
+    if (buffer.byteLength > maxBytes) {
+      throw new DivoomValidationError(`Image at ${url} exceeds the ${maxBytes}-byte limit.`);
+    }
+    return buffer;
+  }
+  const reader = body.getReader();
+  const chunks = [];
+  let total = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (value) {
+      total += value.byteLength;
+      if (total > maxBytes) {
+        await reader.cancel();
+        throw new DivoomValidationError(`Image at ${url} exceeds the ${maxBytes}-byte limit.`);
+      }
+      chunks.push(value);
+    }
+  }
+  return Buffer.concat(chunks);
+}
+async function fetchImageBytes(url, options) {
+  const timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;
+  const maxBytes = options.maxBytes ?? DEFAULT_MAX_IMAGE_BYTES;
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    let currentUrl = url;
+    for (let hop = 0; ; hop += 1) {
+      const response = await fetchImpl(currentUrl, {
+        signal: controller.signal,
+        redirect: "manual"
+      });
+      if (response.status >= 300 && response.status < 400) {
+        const location = response.headers.get("location");
+        await drainBody(response);
+        if (!location) {
+          throw new DivoomConnectionError(
+            `Image redirect from ${currentUrl} is missing a Location header.`
+          );
+        }
+        if (hop >= MAX_REDIRECTS) {
+          throw new DivoomConnectionError(`Too many redirects downloading image from ${url}.`);
+        }
+        const next = new URL(location, currentUrl).toString();
+        if (!/^https?:\/\//i.test(next)) {
+          throw new DivoomValidationError(
+            `Refusing to follow a non-http(s) image redirect to "${next}".`
+          );
+        }
+        currentUrl = next;
+        continue;
+      }
+      if (!response.ok) {
+        await drainBody(response);
+        throw new DivoomConnectionError(
+          `Failed to download image from ${currentUrl} (HTTP ${response.status}).`
+        );
+      }
+      const declared = Number(response.headers.get("content-length"));
+      if (Number.isFinite(declared) && declared > maxBytes) {
+        await drainBody(response);
+        throw new DivoomValidationError(
+          `Image at ${currentUrl} is ${declared} bytes, exceeding the ${maxBytes}-byte limit.`
+        );
+      }
+      return await readCapped(response, maxBytes, currentUrl);
+    }
+  } catch (error) {
+    if (error instanceof DivoomError) throw error;
+    if (controller.signal.aborted) {
+      throw new DivoomTimeoutError(`GET ${url}`, timeoutMs);
+    }
+    throw new DivoomConnectionError(`Failed to download image from ${url}.`, { cause: error });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function loadImage(source, options = {}) {
+  if (isSharp(source)) {
+    return source.clone();
+  }
+  if (typeof source === "string") {
+    if (/^https?:\/\//i.test(source)) {
+      return sharp4__default.default(await fetchImageBytes(source, options));
+    }
+    return sharp4__default.default(source);
+  }
+  if (Buffer.isBuffer(source) || source instanceof Uint8Array) {
+    return sharp4__default.default(source);
+  }
+  throw new DivoomValidationError(
+    "Unsupported image source. Provide a file path, an http(s) URL, a Buffer/Uint8Array, or a sharp instance."
+  );
+}
+
+// src/image/color.ts
+function hexToRgb(hex) {
+  const cleaned = hex.replace(/^#/, "").trim();
+  const full = cleaned.length === 3 ? cleaned.split("").map((c) => c + c).join("") : cleaned;
+  if (!/^[0-9a-fA-F]{6}$/.test(full)) {
+    throw new DivoomValidationError(`Invalid hex color: "${hex}".`);
+  }
+  const value = Number.parseInt(full, 16);
+  return [value >> 16 & 255, value >> 8 & 255, value & 255];
+}
+function rgbToHex([r, g, b]) {
+  const channel = (n) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, "0");
+  return `#${channel(r)}${channel(g)}${channel(b)}`.toUpperCase();
+}
+function mixRgb(a, b, t) {
+  const clamped = Math.max(0, Math.min(1, t));
+  return [
+    a[0] + (b[0] - a[0]) * clamped,
+    a[1] + (b[1] - a[1]) * clamped,
+    a[2] + (b[2] - a[2]) * clamped
+  ];
+}
+function scaleRgb([r, g, b], factor) {
+  return [r * factor, g * factor, b * factor];
+}
+async function getAccentColor(source, fallback = "#1DB954") {
+  const { data, info } = await (await loadImage(source)).resize(32, 32, { fit: "cover" }).flatten({ background: "#000000" }).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+  const channels = info.channels;
+  let best = null;
+  let bestSaturation = 0;
+  for (let i = 0; i + 2 < data.length; i += channels) {
+    const r = data[i] ?? 0;
+    const g = data[i + 1] ?? 0;
+    const b = data[i + 2] ?? 0;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    if (max === 0) continue;
+    const saturation = (max - min) / max;
+    if (saturation > bestSaturation && max > 80) {
+      bestSaturation = saturation;
+      best = [r, g, b];
+    }
+  }
+  return best ? rgbToHex(best) : fallback;
+}
+
+// src/image/encode.ts
+async function finalizeFrame(pipeline, options) {
+  const format = options.format ?? "jpeg";
+  let buffer;
+  if (format === "png") {
+    buffer = await pipeline.png({ compressionLevel: 9 }).toBuffer();
+  } else {
+    buffer = await pipeline.flatten({ background: options.background ?? "#000000" }).jpeg({
+      quality: options.quality ?? 95,
+      chromaSubsampling: options.chromaSubsampling ?? "4:4:4"
+    }).toBuffer();
+  }
+  return {
+    data: buffer.toString("base64"),
+    buffer,
+    format,
+    width: options.size,
+    height: options.size
+  };
+}
+async function encodePanel(source, options = {}) {
+  const size = options.size ?? PANEL_SIZE;
+  assertIntInRange(size, 1, 4096, "size");
+  const pipeline = (await loadImage(source)).resize(size, size, {
+    fit: options.fit ?? "cover",
+    kernel: options.kernel ?? "lanczos3",
+    background: options.background ?? "#000000"
+  });
+  return finalizeFrame(pipeline, { ...options, size });
+}
+async function solidFrame(color, options = {}) {
+  const size = options.size ?? PANEL_SIZE;
+  assertIntInRange(size, 1, 4096, "size");
+  const [r, g, b] = hexToRgb(color);
+  const pipeline = sharp4__default.default({
+    create: { width: size, height: size, channels: 3, background: { r, g, b } }
+  });
+  return finalizeFrame(pipeline, { ...options, size });
+}
+
+// src/image/art.ts
+async function prepareAlbumArt(source, options = {}) {
+  const size = options.size ?? PANEL_SIZE;
+  const style = options.style ?? "smooth";
+  const base = await loadImage(source);
+  const pipeline = style === "pixel" ? base.resize(32, 32, { kernel: "nearest", fit: "cover" }).resize(size, size, { kernel: "nearest" }).modulate({ saturation: 1.5 }) : base.resize(size, size, { kernel: "lanczos3", fit: "cover" }).modulate({ saturation: 1.15 }).linear(1.05, -6.4).sharpen({ sigma: 1 });
+  return finalizeFrame(pipeline, { ...options, size });
+}
+async function splitImageAcrossPanels(source, options = {}) {
+  const panels = options.panels ?? [0, 1, 2, 3, 4];
+  const size = options.size ?? PANEL_SIZE;
+  assertIntInRange(size, 1, 4096, "size");
+  const layout = options.layout ?? "horizontal";
+  if (panels.length > PANEL_COUNT) {
+    throw new DivoomValidationError(
+      `splitImageAcrossPanels supports at most ${PANEL_COUNT} panels (received ${panels.length}).`
+    );
+  }
+  panels.forEach(assertPanelIndex);
+  const count = panels.length;
+  if (count === 0) {
+    return [];
+  }
+  const base = await loadImage(source);
+  const resized = layout === "horizontal" ? base.resize(size * count, size, { fit: "cover", kernel: "lanczos3" }) : base.resize(size, size * count, { fit: "cover", kernel: "lanczos3" });
+  const canvas = await resized.png().toBuffer();
+  const results = [];
+  for (let i = 0; i < count; i += 1) {
+    const panel = panels[i];
+    if (panel === void 0) continue;
+    const tile = sharp4__default.default(canvas).extract({
+      left: layout === "horizontal" ? i * size : 0,
+      top: layout === "vertical" ? i * size : 0,
+      width: size,
+      height: size
+    });
+    results.push({ panel, frame: await finalizeFrame(tile, { ...options, size }) });
+  }
+  return results;
+}
+var MAX_PANEL_SIZE = 4096;
+function escapeMarkup(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function normalizeHex(color) {
+  return rgbToHex(hexToRgb(color));
+}
+async function renderText(opts) {
+  const markup = `<span foreground="${normalizeHex(opts.color)}"${opts.bold ? ' weight="bold"' : ""}>${escapeMarkup(opts.text)}</span>`;
+  const textInput = {
+    text: markup,
+    font: `${opts.family} ${opts.size}`,
+    rgba: true,
+    align: opts.align ?? "left",
+    width: Math.max(1, Math.round(opts.width)),
+    wrap: "word"
+  };
+  if (opts.maxHeight !== void 0) {
+    textInput.height = Math.max(1, Math.round(opts.maxHeight));
+  }
+  const buffer = await sharp4__default.default({ text: textInput }).png().toBuffer();
+  const meta = await sharp4__default.default(buffer).metadata();
+  return { buffer, width: meta.width ?? 0, height: meta.height ?? 0 };
+}
+async function fitOverlay(buffer, top, left, size) {
+  const safeTop = Math.max(0, Math.min(Math.round(top), size - 1));
+  const safeLeft = Math.max(0, Math.min(Math.round(left), size - 1));
+  const maxW = size - safeLeft;
+  const maxH = size - safeTop;
+  const meta = await sharp4__default.default(buffer).metadata();
+  if ((meta.width ?? 0) <= maxW && (meta.height ?? 0) <= maxH) {
+    return { input: buffer, top: safeTop, left: safeLeft };
+  }
+  const clamped = await sharp4__default.default(buffer).resize(maxW, maxH, { fit: "inside", withoutEnlargement: true }).png().toBuffer();
+  return { input: clamped, top: safeTop, left: safeLeft };
+}
+async function renderFittedTitle(text, family, width, budget, size) {
+  const candidates = [0.25, 0.21, 0.18, 0.16, 0.14].map((f) => Math.max(10, Math.round(size * f)));
+  for (const fontSize2 of candidates) {
+    const rendered = await renderText({
+      text,
+      family,
+      size: fontSize2,
+      color: "#FFFFFF",
+      bold: true,
+      width
+    });
+    if (rendered.height <= budget && rendered.width <= width) {
+      return rendered;
+    }
+  }
+  const fontSize = Math.max(10, Math.round(size * 0.14));
+  return renderText({
+    text,
+    family,
+    size: fontSize,
+    color: "#FFFFFF",
+    bold: true,
+    width,
+    maxHeight: Math.max(fontSize, budget)
+  });
+}
+function buildBackground(background, accent, size) {
+  if (background === "solid") {
+    const [r, g, b] = accent;
+    return sharp4__default.default({ create: { width: size, height: size, channels: 3, background: { r, g, b } } });
+  }
+  if (background !== "gradient") {
+    const [r, g, b] = hexToRgb(background);
+    return sharp4__default.default({ create: { width: size, height: size, channels: 3, background: { r, g, b } } });
+  }
+  const [tr, tg, tb] = scaleRgb(accent, 0.3).map(Math.round);
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}">
+    <defs><linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="rgb(${tr},${tg},${tb})"/>
+      <stop offset="1" stop-color="rgb(8,8,10)"/>
+    </linearGradient></defs>
+    <rect width="${size}" height="${size}" fill="url(#bg)"/>
+  </svg>`;
+  return sharp4__default.default(Buffer.from(svg)).resize(size, size);
+}
+function buildShapes(opts) {
+  const { size, margin, accent, eyebrowY, hasEyebrow, progress, barY } = opts;
+  const [r, g, b] = accent;
+  const accentCss = `rgb(${r},${g},${b})`;
+  const parts = [];
+  if (hasEyebrow) {
+    const t = Math.round(size * 0.045);
+    const y = eyebrowY;
+    parts.push(
+      `<polygon points="${margin},${y} ${margin},${y + t} ${margin + t},${y + t / 2}" fill="${accentCss}"/>`
+    );
+  }
+  if (progress !== void 0) {
+    const x0 = margin;
+    const x1 = size - margin;
+    const p = Math.max(0, Math.min(1, progress));
+    const fx = x0 + (x1 - x0) * p;
+    const [tr, tg, tb] = scaleRgb(accent, 0.45).map(Math.round);
+    parts.push(
+      `<line x1="${x0}" y1="${barY}" x2="${x1}" y2="${barY}" stroke="rgb(${tr},${tg},${tb})" stroke-width="3" stroke-linecap="round"/>`,
+      `<line x1="${x0}" y1="${barY}" x2="${fx}" y2="${barY}" stroke="${accentCss}" stroke-width="3" stroke-linecap="round"/>`
+    );
+  }
+  return Buffer.from(
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}">${parts.join("")}</svg>`
+  );
+}
+async function renderTextPanel(options) {
+  const size = options.size ?? PANEL_SIZE;
+  assertIntInRange(size, 1, MAX_PANEL_SIZE, "size");
+  assertNonEmptyString(options.title, "title");
+  const family = options.font ?? "DejaVu Sans";
+  const accentHex = options.accent ?? "#1DB954";
+  const accent = hexToRgb(accentHex);
+  const margin = Math.round(size * 0.055);
+  const maxWidth = Math.max(1, size - margin * 2);
+  const eyebrowText = options.eyebrow?.trim();
+  const subtitleText = options.subtitle?.trim();
+  const overlays = [];
+  let contentTop = margin;
+  const eyebrowY = margin + Math.round(size * 0.015);
+  if (eyebrowText) {
+    const glyph = Math.round(size * 0.045);
+    const eyebrowMaxHeight = Math.max(glyph, Math.round(size * 0.12));
+    const eyebrow = await renderText({
+      text: eyebrowText.toUpperCase(),
+      family,
+      size: Math.max(7, Math.round(size * 0.07)),
+      color: accentHex,
+      bold: true,
+      width: Math.max(1, maxWidth - glyph)
+    });
+    overlays.push({
+      buffer: eyebrow.buffer,
+      top: eyebrowY,
+      left: margin + glyph + Math.round(size * 0.03)
+    });
+    contentTop = eyebrowY + Math.min(Math.max(eyebrow.height, glyph), eyebrowMaxHeight) + Math.round(size * 0.03);
+  }
+  contentTop = Math.min(contentTop, size - Math.round(size * 0.2));
+  const hasProgress = typeof options.progress === "number";
+  const barY = size - Math.round(size * 0.08);
+  const bottomLimit = hasProgress ? barY - Math.round(size * 0.06) : size - margin;
+  let subtitleTop = bottomLimit;
+  if (subtitleText) {
+    const subSize = Math.max(9, Math.round(size * 0.11));
+    const maxSubHeight = subSize * 2 + 4;
+    let subtitle = await renderText({
+      text: subtitleText,
+      family,
+      size: subSize,
+      color: accentHex,
+      width: maxWidth
+    });
+    if (subtitle.height > maxSubHeight) {
+      const cropped = await sharp4__default.default(subtitle.buffer).extract({ left: 0, top: 0, width: subtitle.width, height: maxSubHeight }).png().toBuffer();
+      subtitle = { buffer: cropped, width: subtitle.width, height: maxSubHeight };
+    }
+    subtitleTop = Math.max(contentTop, bottomLimit - subtitle.height);
+    overlays.push({ buffer: subtitle.buffer, top: subtitleTop, left: margin });
+  }
+  const titleBottom = subtitleText ? subtitleTop : bottomLimit;
+  const titleBudget = Math.max(
+    Math.round(size * 0.12),
+    titleBottom - contentTop - Math.round(size * 0.03)
+  );
+  const title = await renderFittedTitle(options.title, family, maxWidth, titleBudget, size);
+  overlays.push({ buffer: title.buffer, top: contentTop, left: margin });
+  const composites = [
+    {
+      input: buildShapes({
+        size,
+        margin,
+        accent,
+        eyebrowY,
+        hasEyebrow: Boolean(eyebrowText),
+        progress: options.progress,
+        barY
+      }),
+      top: 0,
+      left: 0
+    }
+  ];
+  for (const overlay of overlays) {
+    composites.push(await fitOverlay(overlay.buffer, overlay.top, overlay.left, size));
+  }
+  const pipeline = buildBackground(options.background ?? "gradient", accent, size).composite(
+    composites
+  );
+  return finalizeFrame(pipeline, { ...options, size });
+}
+
+exports.encodePanel = encodePanel;
+exports.finalizeFrame = finalizeFrame;
+exports.getAccentColor = getAccentColor;
+exports.hexToRgb = hexToRgb;
+exports.loadImage = loadImage;
+exports.mixRgb = mixRgb;
+exports.prepareAlbumArt = prepareAlbumArt;
+exports.renderTextPanel = renderTextPanel;
+exports.rgbToHex = rgbToHex;
+exports.scaleRgb = scaleRgb;
+exports.solidFrame = solidFrame;
+exports.splitImageAcrossPanels = splitImageAcrossPanels;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/image/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors.ts","../../src/constants.ts","../../src/utils.ts","../../src/image/load.ts","../../src/image/color.ts","../../src/image/encode.ts","../../src/image/art.ts","../../src/image/split.ts","../../src/image/text.ts"],"names":["sharp","fontSize"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Error hierarchy for the Divoom Times Gate SDK.\n *\n * Every error thrown by the SDK extends {@link DivoomError}, so you can catch\n * the whole family with a single `instanceof DivoomError` check, or narrow to a\n * specific subclass when you need to react differently (e.g. retry on a\n * timeout, but surface a validation mistake to the user).\n *\n * @packageDocumentation\n */\n\n/** Base class for every error thrown by the SDK. */\nexport class DivoomError extends Error {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options as ErrorOptions | undefined);\n    this.name = 'DivoomError';\n  }\n}\n\n/** Thrown when arguments fail validation before a request is ever sent. */\nexport class DivoomValidationError extends DivoomError {\n  constructor(message: string) {\n    super(message);\n    this.name = 'DivoomValidationError';\n  }\n}\n\n/** Thrown when the device cannot be reached (DNS, connection refused, etc.). */\nexport class DivoomConnectionError extends DivoomError {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = 'DivoomConnectionError';\n  }\n}\n\n/** Thrown when a request does not complete within the configured timeout. */\nexport class DivoomTimeoutError extends DivoomError {\n  /** The command that timed out. */\n  readonly command: string;\n  /** The timeout budget, in milliseconds, that was exceeded. */\n  readonly timeoutMs: number;\n\n  constructor(command: string, timeoutMs: number) {\n    super(`Command \"${command}\" timed out after ${timeoutMs}ms.`);\n    this.name = 'DivoomTimeoutError';\n    this.command = command;\n    this.timeoutMs = timeoutMs;\n  }\n}\n\n/** Thrown when the device responds with a non-2xx HTTP status. */\nexport class DivoomHttpError extends DivoomError {\n  /** The HTTP status code returned by the device. */\n  readonly status: number;\n  /** The command that produced the error. */\n  readonly command: string;\n  /** The full request URL. */\n  readonly url: string;\n\n  constructor(status: number, command: string, url: string) {\n    super(`Times Gate returned HTTP ${status} for command \"${command}\" (${url}).`);\n    this.name = 'DivoomHttpError';\n    this.status = status;\n    this.command = command;\n    this.url = url;\n  }\n}\n\n/**\n * Thrown when a Divoom **cloud** API (`app.divoom-gz.com`) reports a non-zero\n * `ReturnCode`.\n */\nexport class DivoomCloudError extends DivoomError {\n  /** The non-zero `ReturnCode` reported by the cloud API. */\n  readonly returnCode: number;\n  /** The cloud endpoint path that failed. */\n  readonly endpoint: string;\n  /** The `ReturnMessage`, when provided. */\n  readonly returnMessage?: string;\n\n  constructor(returnCode: number, endpoint: string, returnMessage?: string) {\n    super(\n      `Divoom cloud endpoint \"${endpoint}\" failed with ReturnCode ${returnCode}` +\n        (returnMessage ? `: ${returnMessage}` : '.'),\n    );\n    this.name = 'DivoomCloudError';\n    this.returnCode = returnCode;\n    this.endpoint = endpoint;\n    this.returnMessage = returnMessage;\n  }\n}\n\n/**\n * Thrown when the device accepts the request but reports a non-zero\n * `error_code` in the response body.\n */\nexport class DivoomDeviceError extends DivoomError {\n  /** The non-zero `error_code` reported by the device. */\n  readonly errorCode: number;\n  /** The command that was rejected. */\n  readonly command: string;\n  /** The raw response body returned by the device. */\n  readonly response: unknown;\n\n  constructor(errorCode: number, command: string, response: unknown) {\n    super(\n      `Times Gate rejected command \"${command}\" with error_code ${errorCode}. ` +\n        `This often means the LocalToken is missing or incorrect for a command that requires it.`,\n    );\n    this.name = 'DivoomDeviceError';\n    this.errorCode = errorCode;\n    this.command = command;\n    this.response = response;\n  }\n}\n","/**\n * Device-level constants for the Divoom Times Gate.\n *\n * @packageDocumentation\n */\n\n/** The Times Gate has five individually-addressable LCD panels. */\nexport const PANEL_COUNT = 5;\n\n/** Each panel renders a square {@link PANEL_SIZE}×{@link PANEL_SIZE} image. */\nexport const PANEL_SIZE = 128;\n\n/** Default HTTP port for hardware version 400 devices. */\nexport const DEFAULT_PORT = 80;\n\n/** Default request path for hardware version 400 devices (`http://IP:80/post`). */\nexport const DEFAULT_PATH = '/post';\n\n/** HTTP port for hardware version 402 devices. */\nexport const HARDWARE_402_PORT = 9000;\n\n/** Request path for hardware version 402 devices (`http://IP:9000/divoom_api`). */\nexport const HARDWARE_402_PATH = '/divoom_api';\n\n/**\n * Divoom's cloud endpoint that returns every Divoom device currently visible\n * on the same LAN as the caller. Used by {@link discoverDevices}.\n */\nexport const LAN_DISCOVERY_URL = 'https://app.divoom-gz.com/Device/ReturnSameLANDevice';\n","/**\n * Small, dependency-free helpers shared across the SDK: argument validation,\n * panel-mask construction, and a monotonic PicID generator.\n *\n * @packageDocumentation\n */\n\nimport { PANEL_COUNT } from './constants';\nimport { DivoomValidationError } from './errors';\nimport type { LcdArray, PanelIndex } from './types/common';\n\n/** Resolves after `ms` milliseconds. */\nexport const delay = (ms: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n\n/**\n * Best-effort release of a fetch `Response` body on error paths where it is\n * never read, so the underlying socket returns to the connection pool instead of\n * being pinned until garbage collection. Never throws.\n */\nexport async function drainBody(response: {\n  body?: { cancel?: () => Promise<unknown> } | null;\n}): Promise<void> {\n  try {\n    await response.body?.cancel?.();\n  } catch {\n    // ignore — releasing the body is best-effort\n  }\n}\n\n/**\n * Asserts that `value` is an integer within `[min, max]`, throwing a\n * {@link DivoomValidationError} otherwise.\n */\nexport function assertIntInRange(value: number, min: number, max: number, label: string): void {\n  if (!Number.isInteger(value) || value < min || value > max) {\n    throw new DivoomValidationError(\n      `${label} must be an integer between ${min} and ${max} (received ${String(value)}).`,\n    );\n  }\n}\n\n/** Asserts that `value` is a valid {@link PanelIndex} (`0`–`4`). */\nexport function assertPanelIndex(value: number): asserts value is PanelIndex {\n  if (!Number.isInteger(value) || value < 0 || value >= PANEL_COUNT) {\n    throw new DivoomValidationError(\n      `panel must be an integer between 0 and ${PANEL_COUNT - 1} (received ${String(value)}).`,\n    );\n  }\n}\n\n/** Asserts that `value` is a non-empty string after trimming. */\nexport function assertNonEmptyString(value: unknown, label: string): asserts value is string {\n  if (typeof value !== 'string' || value.trim().length === 0) {\n    throw new DivoomValidationError(`${label} must be a non-empty string.`);\n  }\n}\n\n/**\n * Builds a panel selection mask for a single panel.\n *\n * @example\n * ```ts\n * panelToLcdArray(2); // → [0, 0, 1, 0, 0]\n * ```\n */\nexport function panelToLcdArray(panel: PanelIndex): LcdArray {\n  assertPanelIndex(panel);\n  const arr: LcdArray = [0, 0, 0, 0, 0];\n  arr[panel] = 1;\n  return arr;\n}\n\n/**\n * Builds a panel selection mask from a set of panels.\n *\n * @example\n * ```ts\n * panelsToLcdArray([0, 4]); // → [1, 0, 0, 0, 1]\n * ```\n */\nexport function panelsToLcdArray(panels: Iterable<PanelIndex>): LcdArray {\n  const arr: LcdArray = [0, 0, 0, 0, 0];\n  for (const panel of panels) {\n    assertPanelIndex(panel);\n    arr[panel] = 1;\n  }\n  return arr;\n}\n\n/**\n * Generates strictly-increasing PicIDs for image uploads. The Times Gate caches\n * frames by ID, so every pushed frame needs a fresh, monotonically growing ID.\n *\n * Uniqueness within a single generator comes from the `+10` step taken on every\n * `next()` call; the per-panel offset only spaces consecutive IDs apart and is\n * not what prevents collisions. The generator is seeded from the current time in\n * seconds, so two *separate* generators created within the same second can\n * produce overlapping IDs — share one generator if you need cross-instance\n * uniqueness (or seed from the device via `Draw/GetHttpGifId`).\n */\nexport class PicIdGenerator {\n  private base: number;\n\n  constructor(seed: number = Math.floor(Date.now() / 1000)) {\n    this.base = seed;\n  }\n\n  /** Returns the next unique PicID for the given panel. */\n  next(panel = 0): number {\n    this.base += 10;\n    return this.base + panel;\n  }\n}\n","/**\n * Turns any {@link ImageSource} into a `sharp` pipeline.\n *\n * @remarks\n * **Trust model.** A `string` source is treated as an `http(s)` URL when it\n * starts with that scheme, and otherwise as a **local file path**. Do not pass\n * untrusted/attacker-influenced strings here: a URL can trigger a server-side\n * request (SSRF) and a path can read arbitrary local files. URL downloads are\n * bounded by a timeout and a maximum size, but callers handling untrusted input\n * should validate/allowlist the source themselves (and prefer passing a\n * `Buffer` you fetched under your own controls).\n *\n * @packageDocumentation\n */\n\nimport sharp, { type Sharp } from 'sharp';\nimport {\n  DivoomConnectionError,\n  DivoomError,\n  DivoomTimeoutError,\n  DivoomValidationError,\n} from '../errors';\nimport type { FetchLike } from '../types/common';\nimport { drainBody } from '../utils';\nimport type { ImageSource } from './types';\n\n/** Default per-download timeout for URL sources. */\nconst DEFAULT_FETCH_TIMEOUT_MS = 15_000;\n\n/** Default maximum download size for URL sources (64 MiB). */\nconst DEFAULT_MAX_IMAGE_BYTES = 64 * 1024 * 1024;\n\n/** Maximum redirect hops followed when downloading a URL image. */\nconst MAX_REDIRECTS = 5;\n\n/** Options controlling how URL image sources are downloaded. */\nexport interface LoadImageOptions {\n  /** Per-download timeout in milliseconds (URL sources only). Defaults to `15000`. */\n  timeoutMs?: number;\n  /** Maximum bytes to download before aborting (URL sources only). Defaults to 64 MiB. */\n  maxBytes?: number;\n  /** A custom `fetch` for URL sources. Defaults to the global `fetch`. */\n  fetch?: FetchLike;\n}\n\n/** Duck-types a `sharp` instance without relying on `instanceof`. */\nfunction isSharp(value: unknown): value is Sharp {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as Sharp).toBuffer === 'function' &&\n    typeof (value as Sharp).resize === 'function'\n  );\n}\n\n/** Reads a response body, aborting if it exceeds `maxBytes`. */\nasync function readCapped(\n  response: Awaited<ReturnType<FetchLike>>,\n  maxBytes: number,\n  url: string,\n): Promise<Buffer> {\n  const body = response.body;\n  if (!body) {\n    const buffer = Buffer.from(await response.arrayBuffer());\n    if (buffer.byteLength > maxBytes) {\n      throw new DivoomValidationError(`Image at ${url} exceeds the ${maxBytes}-byte limit.`);\n    }\n    return buffer;\n  }\n\n  const reader = body.getReader();\n  const chunks: Uint8Array[] = [];\n  let total = 0;\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    if (value) {\n      total += value.byteLength;\n      if (total > maxBytes) {\n        await reader.cancel();\n        throw new DivoomValidationError(`Image at ${url} exceeds the ${maxBytes}-byte limit.`);\n      }\n      chunks.push(value);\n    }\n  }\n  return Buffer.concat(chunks);\n}\n\n/** Downloads an `http(s)` image with a timeout and size cap, returning its bytes. */\nasync function fetchImageBytes(url: string, options: LoadImageOptions): Promise<Buffer> {\n  const timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n  const maxBytes = options.maxBytes ?? DEFAULT_MAX_IMAGE_BYTES;\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  try {\n    // Follow redirects manually so every hop is re-validated as http(s): a\n    // default 'follow' would silently chase a 3xx to file://, or to an\n    // unexpected host, widening the SSRF surface. The chain is capped.\n    let currentUrl = url;\n    for (let hop = 0; ; hop += 1) {\n      const response = await fetchImpl(currentUrl, {\n        signal: controller.signal,\n        redirect: 'manual',\n      });\n\n      if (response.status >= 300 && response.status < 400) {\n        const location = response.headers.get('location');\n        await drainBody(response);\n        if (!location) {\n          throw new DivoomConnectionError(\n            `Image redirect from ${currentUrl} is missing a Location header.`,\n          );\n        }\n        if (hop >= MAX_REDIRECTS) {\n          throw new DivoomConnectionError(`Too many redirects downloading image from ${url}.`);\n        }\n        const next = new URL(location, currentUrl).toString();\n        if (!/^https?:\\/\\//i.test(next)) {\n          throw new DivoomValidationError(\n            `Refusing to follow a non-http(s) image redirect to \"${next}\".`,\n          );\n        }\n        currentUrl = next;\n        continue;\n      }\n\n      if (!response.ok) {\n        await drainBody(response);\n        throw new DivoomConnectionError(\n          `Failed to download image from ${currentUrl} (HTTP ${response.status}).`,\n        );\n      }\n      const declared = Number(response.headers.get('content-length'));\n      if (Number.isFinite(declared) && declared > maxBytes) {\n        await drainBody(response);\n        throw new DivoomValidationError(\n          `Image at ${currentUrl} is ${declared} bytes, exceeding the ${maxBytes}-byte limit.`,\n        );\n      }\n      return await readCapped(response, maxBytes, currentUrl);\n    }\n  } catch (error) {\n    if (error instanceof DivoomError) throw error;\n    if (controller.signal.aborted) {\n      throw new DivoomTimeoutError(`GET ${url}`, timeoutMs);\n    }\n    throw new DivoomConnectionError(`Failed to download image from ${url}.`, { cause: error });\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\n/**\n * Resolves an {@link ImageSource} to a `sharp` pipeline. Existing pipelines are\n * cloned so callers can reuse the original safely.\n *\n * @param source - A file path, an `http(s)` URL, raw bytes, or a `sharp` instance.\n *   See the module-level note on the URL/path trust model before passing\n *   untrusted input.\n * @param options - Download controls for URL sources (timeout, size cap, fetch).\n * @throws {@link DivoomValidationError} for unsupported sources or oversized downloads.\n * @throws {@link DivoomConnectionError} when a URL cannot be downloaded.\n * @throws {@link DivoomTimeoutError} when a download exceeds `timeoutMs`.\n */\nexport async function loadImage(\n  source: ImageSource,\n  options: LoadImageOptions = {},\n): Promise<Sharp> {\n  if (isSharp(source)) {\n    return source.clone();\n  }\n  if (typeof source === 'string') {\n    if (/^https?:\\/\\//i.test(source)) {\n      return sharp(await fetchImageBytes(source, options));\n    }\n    return sharp(source);\n  }\n  if (Buffer.isBuffer(source) || source instanceof Uint8Array) {\n    return sharp(source);\n  }\n  throw new DivoomValidationError(\n    'Unsupported image source. Provide a file path, an http(s) URL, a Buffer/Uint8Array, or a sharp instance.',\n  );\n}\n","/**\n * Color helpers: hex⇄RGB conversion, mixing, and accent extraction from\n * artwork (used to tint the now-playing panels).\n *\n * @packageDocumentation\n */\n\nimport { DivoomValidationError } from '../errors';\nimport { loadImage } from './load';\nimport type { ImageSource } from './types';\n\n/** An `[r, g, b]` triple with each channel in `0`–`255`. */\nexport type Rgb = [number, number, number];\n\n/** Parses a `#RGB` or `#RRGGBB` hex string into an {@link Rgb} triple. */\nexport function hexToRgb(hex: string): Rgb {\n  const cleaned = hex.replace(/^#/, '').trim();\n  const full =\n    cleaned.length === 3\n      ? cleaned\n          .split('')\n          .map((c) => c + c)\n          .join('')\n      : cleaned;\n  if (!/^[0-9a-fA-F]{6}$/.test(full)) {\n    throw new DivoomValidationError(`Invalid hex color: \"${hex}\".`);\n  }\n  const value = Number.parseInt(full, 16);\n  return [(value >> 16) & 0xff, (value >> 8) & 0xff, value & 0xff];\n}\n\n/** Formats an {@link Rgb} triple as an uppercase `#RRGGBB` string. */\nexport function rgbToHex([r, g, b]: Rgb): string {\n  const channel = (n: number): string =>\n    Math.max(0, Math.min(255, Math.round(n)))\n      .toString(16)\n      .padStart(2, '0');\n  return `#${channel(r)}${channel(g)}${channel(b)}`.toUpperCase();\n}\n\n/** Linearly interpolates between two colors (`t` in `0`–`1`). */\nexport function mixRgb(a: Rgb, b: Rgb, t: number): Rgb {\n  const clamped = Math.max(0, Math.min(1, t));\n  return [\n    a[0] + (b[0] - a[0]) * clamped,\n    a[1] + (b[1] - a[1]) * clamped,\n    a[2] + (b[2] - a[2]) * clamped,\n  ];\n}\n\n/** Scales every channel of a color by `factor`. */\nexport function scaleRgb([r, g, b]: Rgb, factor: number): Rgb {\n  return [r * factor, g * factor, b * factor];\n}\n\n/**\n * Extracts a vivid accent color from artwork — the most saturated reasonably\n * bright pixel — for tinting backgrounds and progress bars. Mirrors the proven\n * heuristic from the reference now-playing app.\n *\n * @param source - The artwork to sample.\n * @param fallback - Returned when no saturated pixel is found. Defaults to\n *   Spotify green (`#1DB954`).\n */\nexport async function getAccentColor(source: ImageSource, fallback = '#1DB954'): Promise<string> {\n  const { data, info } = await (\n    await loadImage(source)\n  )\n    .resize(32, 32, { fit: 'cover' })\n    // Composite over black before dropping alpha, so transparent regions don't\n    // sample arbitrary RGB and skew the saturation search.\n    .flatten({ background: '#000000' })\n    .removeAlpha()\n    .raw()\n    .toBuffer({ resolveWithObject: true });\n\n  const channels = info.channels;\n  let best: Rgb | null = null;\n  let bestSaturation = 0;\n\n  for (let i = 0; i + 2 < data.length; i += channels) {\n    const r = data[i] ?? 0;\n    const g = data[i + 1] ?? 0;\n    const b = data[i + 2] ?? 0;\n    const max = Math.max(r, g, b);\n    const min = Math.min(r, g, b);\n    if (max === 0) continue;\n    const saturation = (max - min) / max;\n    if (saturation > bestSaturation && max > 80) {\n      bestSaturation = saturation;\n      best = [r, g, b];\n    }\n  }\n\n  return best ? rgbToHex(best) : fallback;\n}\n","/**\n * Frame encoding: resize-and-encode any source to a panel-ready\n * {@link EncodedFrame}, plus a helper for solid-color frames.\n *\n * @packageDocumentation\n */\n\nimport sharp, { type Sharp } from 'sharp';\nimport { PANEL_SIZE } from '../constants';\nimport { assertIntInRange } from '../utils';\nimport { hexToRgb } from './color';\nimport { loadImage } from './load';\nimport type { EncodeOptions, EncodedFrame, EncodePanelOptions, ImageSource } from './types';\n\n/**\n * Encodes an already-sized `sharp` pipeline into an {@link EncodedFrame},\n * applying the SDK's default high-quality JPEG settings (q95, 4:4:4 chroma).\n *\n * @internal Shared by the higher-level helpers; exported for advanced use.\n */\nexport async function finalizeFrame(\n  pipeline: Sharp,\n  options: EncodeOptions & { size: number },\n): Promise<EncodedFrame> {\n  const format = options.format ?? 'jpeg';\n  let buffer: Buffer;\n\n  if (format === 'png') {\n    buffer = await pipeline.png({ compressionLevel: 9 }).toBuffer();\n  } else {\n    buffer = await pipeline\n      .flatten({ background: options.background ?? '#000000' })\n      .jpeg({\n        quality: options.quality ?? 95,\n        chromaSubsampling: options.chromaSubsampling ?? '4:4:4',\n      })\n      .toBuffer();\n  }\n\n  return {\n    data: buffer.toString('base64'),\n    buffer,\n    format,\n    width: options.size,\n    height: options.size,\n  };\n}\n\n/**\n * Resizes and encodes any {@link ImageSource} into a single square panel frame.\n *\n * @example\n * ```ts\n * const frame = await encodePanel('./album.jpg'); // 128×128 JPEG, q95\n * await client.draw.sendImage(0, frame.data);\n * ```\n */\nexport async function encodePanel(\n  source: ImageSource,\n  options: EncodePanelOptions = {},\n): Promise<EncodedFrame> {\n  const size = options.size ?? PANEL_SIZE;\n  assertIntInRange(size, 1, 4096, 'size');\n  const pipeline = (await loadImage(source)).resize(size, size, {\n    fit: options.fit ?? 'cover',\n    kernel: options.kernel ?? 'lanczos3',\n    background: options.background ?? '#000000',\n  });\n  return finalizeFrame(pipeline, { ...options, size });\n}\n\n/**\n * Produces a solid-color panel frame — handy for clearing a panel or showing a\n * status color.\n *\n * @example\n * ```ts\n * await client.draw.sendImage(1, (await solidFrame('#000000')).data); // blank\n * ```\n */\nexport async function solidFrame(\n  color: string,\n  options: EncodeOptions = {},\n): Promise<EncodedFrame> {\n  const size = options.size ?? PANEL_SIZE;\n  assertIntInRange(size, 1, 4096, 'size');\n  const [r, g, b] = hexToRgb(color);\n  const pipeline = sharp({\n    create: { width: size, height: size, channels: 3, background: { r, g, b } },\n  });\n  return finalizeFrame(pipeline, { ...options, size });\n}\n","/**\n * Album-art styling — the two looks from the reference now-playing app:\n * a crisp \"smooth\" treatment and a chunky \"pixel\" treatment.\n *\n * @packageDocumentation\n */\n\nimport { PANEL_SIZE } from '../constants';\nimport { finalizeFrame } from './encode';\nimport { loadImage } from './load';\nimport type { EncodeOptions, EncodedFrame, ImageSource } from './types';\n\n/** Visual treatment applied by {@link prepareAlbumArt}. */\nexport type AlbumArtStyle = 'smooth' | 'pixel';\n\n/** Options for {@link prepareAlbumArt}. */\nexport interface PrepareAlbumArtOptions extends EncodeOptions {\n  /**\n   * `\"smooth\"` (default) gently boosts saturation/contrast and unsharp-masks for\n   * a clean look; `\"pixel\"` downsamples to 32×32 nearest-neighbour for a retro,\n   * blocky aesthetic.\n   */\n  style?: AlbumArtStyle;\n}\n\n/**\n * Prepares album/cover artwork for a panel, matching the look of the reference\n * Spotify app.\n *\n * @example\n * ```ts\n * const art = await prepareAlbumArt(coverUrl, { style: 'smooth' });\n * await client.draw.sendImage(0, art.data);\n * ```\n */\nexport async function prepareAlbumArt(\n  source: ImageSource,\n  options: PrepareAlbumArtOptions = {},\n): Promise<EncodedFrame> {\n  const size = options.size ?? PANEL_SIZE;\n  const style = options.style ?? 'smooth';\n  const base = await loadImage(source);\n\n  const pipeline =\n    style === 'pixel'\n      ? base\n          .resize(32, 32, { kernel: 'nearest', fit: 'cover' })\n          .resize(size, size, { kernel: 'nearest' })\n          .modulate({ saturation: 1.5 })\n      : base\n          .resize(size, size, { kernel: 'lanczos3', fit: 'cover' })\n          .modulate({ saturation: 1.15 })\n          // contrast ≈ 1.05 around mid-grey: out = 1.05·in − (128·0.05)\n          .linear(1.05, -(128 * 0.05))\n          .sharpen({ sigma: 1.0 });\n\n  return finalizeFrame(pipeline, { ...options, size });\n}\n","/**\n * Split one image across several panels to create a single wide (or tall)\n * canvas spanning the Times Gate.\n *\n * @packageDocumentation\n */\n\nimport sharp from 'sharp';\nimport { PANEL_COUNT, PANEL_SIZE } from '../constants';\nimport { DivoomValidationError } from '../errors';\nimport type { PanelIndex } from '../types/common';\nimport { assertIntInRange, assertPanelIndex } from '../utils';\nimport { finalizeFrame } from './encode';\nimport { loadImage } from './load';\nimport type { EncodeOptions, EncodedFrame, ImageSource } from './types';\n\n/** A frame paired with the panel it belongs on. */\nexport interface PanelFrame {\n  /** The target panel index. */\n  panel: PanelIndex;\n  /** The encoded frame for that panel. */\n  frame: EncodedFrame;\n}\n\n/** Options for {@link splitImageAcrossPanels}. */\nexport interface SplitOptions extends EncodeOptions {\n  /** Panels to span, in visual order. Defaults to all five (`[0,1,2,3,4]`). */\n  panels?: PanelIndex[];\n  /**\n   * `\"horizontal\"` (default) lays the image out left-to-right across panels;\n   * `\"vertical\"` stacks top-to-bottom.\n   */\n  layout?: 'horizontal' | 'vertical';\n}\n\n/**\n * Slices a single image into one square frame per panel, so a panorama spans\n * the whole device.\n *\n * @example\n * ```ts\n * const tiles = await splitImageAcrossPanels('./wide-banner.png');\n * for (const { panel, frame } of tiles) {\n *   await client.draw.sendImage(panel, frame.data);\n * }\n * ```\n */\nexport async function splitImageAcrossPanels(\n  source: ImageSource,\n  options: SplitOptions = {},\n): Promise<PanelFrame[]> {\n  const panels = options.panels ?? [0, 1, 2, 3, 4];\n  const size = options.size ?? PANEL_SIZE;\n  assertIntInRange(size, 1, 4096, 'size');\n  const layout = options.layout ?? 'horizontal';\n  // Bound the canvas: at most one tile per physical panel, each a valid index.\n  // (The PanelIndex[] type is erased at runtime, so validate the real values.)\n  if (panels.length > PANEL_COUNT) {\n    throw new DivoomValidationError(\n      `splitImageAcrossPanels supports at most ${PANEL_COUNT} panels (received ${panels.length}).`,\n    );\n  }\n  panels.forEach(assertPanelIndex);\n  const count = panels.length;\n\n  if (count === 0) {\n    return [];\n  }\n\n  const base = await loadImage(source);\n  const resized =\n    layout === 'horizontal'\n      ? base.resize(size * count, size, { fit: 'cover', kernel: 'lanczos3' })\n      : base.resize(size, size * count, { fit: 'cover', kernel: 'lanczos3' });\n\n  // Encode once losslessly, then extract each tile from the buffer.\n  const canvas = await resized.png().toBuffer();\n\n  const results: PanelFrame[] = [];\n  for (let i = 0; i < count; i += 1) {\n    const panel = panels[i];\n    if (panel === undefined) continue;\n    const tile = sharp(canvas).extract({\n      left: layout === 'horizontal' ? i * size : 0,\n      top: layout === 'vertical' ? i * size : 0,\n      width: size,\n      height: size,\n    });\n    results.push({ panel, frame: await finalizeFrame(tile, { ...options, size }) });\n  }\n  return results;\n}\n","/**\n * Renders a designed \"now-playing\"-style text panel: a tinted gradient\n * background, an optional eyebrow with a play glyph, an auto-fitted title, a\n * subtitle, and an optional progress bar. Text is rendered with Pango (via\n * sharp) for crisp, properly-wrapped output that doesn't depend on the host's\n * system fonts the way the original Python reference did.\n *\n * @packageDocumentation\n */\n\nimport sharp, { type CreateText, type OverlayOptions, type Sharp } from 'sharp';\nimport { PANEL_SIZE } from '../constants';\nimport { assertIntInRange, assertNonEmptyString } from '../utils';\nimport { hexToRgb, rgbToHex, type Rgb, scaleRgb } from './color';\nimport { finalizeFrame } from './encode';\nimport type { EncodeOptions, EncodedFrame } from './types';\n\n/** Options for {@link renderTextPanel}. */\nexport interface RenderTextPanelOptions extends EncodeOptions {\n  /** The headline text (e.g. a track title). Auto-sized to fit. */\n  title: string;\n  /** Secondary text below the title (e.g. an artist). Optional. */\n  subtitle?: string;\n  /** Small uppercase label above the title (e.g. `\"NOW PLAYING\"`). Optional. */\n  eyebrow?: string;\n  /** Accent color (hex) used for the tint, eyebrow, subtitle and bar. Defaults to `#1DB954`. */\n  accent?: string;\n  /** Progress fraction `0`–`1`. When set, a progress bar is drawn. */\n  progress?: number;\n  /**\n   * Background style: `\"gradient\"` (default, an accent-tinted vertical fade),\n   * `\"solid\"` (a flat accent), or any hex string for a custom flat color.\n   */\n  background?: 'gradient' | 'solid' | string;\n  /** Pango font family. Defaults to `\"DejaVu Sans\"`. */\n  font?: string;\n}\n\ninterface RenderedText {\n  buffer: Buffer;\n  width: number;\n  height: number;\n}\n\n/** Largest panel edge we'll render, as a sanity bound. */\nconst MAX_PANEL_SIZE = 4096;\n\n/** Escapes a string for safe inclusion in Pango markup. */\nfunction escapeMarkup(text: string): string {\n  return text\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;');\n}\n\n/**\n * Validates and canonicalizes a color to `#RRGGBB` _inside_ the markup builder,\n * so the rendered Pango span can never be poisoned by an unexpected color value\n * regardless of how callers validate upstream. Throws on a non-hex color.\n */\nfunction normalizeHex(color: string): string {\n  return rgbToHex(hexToRgb(color));\n}\n\n/** Renders a single run of text with Pango and reports its true rendered size. */\nasync function renderText(opts: {\n  text: string;\n  family: string;\n  size: number;\n  color: string;\n  bold?: boolean;\n  width: number;\n  maxHeight?: number;\n  align?: 'left' | 'center' | 'right';\n}): Promise<RenderedText> {\n  const markup = `<span foreground=\"${normalizeHex(opts.color)}\"${\n    opts.bold ? ' weight=\"bold\"' : ''\n  }>${escapeMarkup(opts.text)}</span>`;\n\n  const textInput: CreateText = {\n    text: markup,\n    font: `${opts.family} ${opts.size}`,\n    rgba: true,\n    align: opts.align ?? 'left',\n    width: Math.max(1, Math.round(opts.width)),\n    wrap: 'word',\n  };\n  if (opts.maxHeight !== undefined) {\n    textInput.height = Math.max(1, Math.round(opts.maxHeight));\n  }\n\n  const buffer = await sharp({ text: textInput }).png().toBuffer();\n  const meta = await sharp(buffer).metadata();\n  return { buffer, width: meta.width ?? 0, height: meta.height ?? 0 };\n}\n\n/**\n * Guarantees an overlay fits inside the panel at its placement, shrinking it\n * (preserving aspect ratio) if Pango overflowed the soft wrap width or the\n * vertical budget. Without this, `sharp.composite` throws when an unbreakable\n * token (a long word/URL/CJK run) renders wider than the panel.\n */\nasync function fitOverlay(\n  buffer: Buffer,\n  top: number,\n  left: number,\n  size: number,\n): Promise<OverlayOptions> {\n  const safeTop = Math.max(0, Math.min(Math.round(top), size - 1));\n  const safeLeft = Math.max(0, Math.min(Math.round(left), size - 1));\n  const maxW = size - safeLeft;\n  const maxH = size - safeTop;\n\n  const meta = await sharp(buffer).metadata();\n  if ((meta.width ?? 0) <= maxW && (meta.height ?? 0) <= maxH) {\n    return { input: buffer, top: safeTop, left: safeLeft };\n  }\n  const clamped = await sharp(buffer)\n    .resize(maxW, maxH, { fit: 'inside', withoutEnlargement: true })\n    .png()\n    .toBuffer();\n  return { input: clamped, top: safeTop, left: safeLeft };\n}\n\n/** Picks the largest title size whose rendered text fits the width and budget. */\nasync function renderFittedTitle(\n  text: string,\n  family: string,\n  width: number,\n  budget: number,\n  size: number,\n): Promise<RenderedText> {\n  const candidates = [0.25, 0.21, 0.18, 0.16, 0.14].map((f) => Math.max(10, Math.round(size * f)));\n  for (const fontSize of candidates) {\n    const rendered = await renderText({\n      text,\n      family,\n      size: fontSize,\n      color: '#FFFFFF',\n      bold: true,\n      width,\n    });\n    if (rendered.height <= budget && rendered.width <= width) {\n      return rendered;\n    }\n  }\n  // Nothing fit cleanly (e.g. an unbreakable token). Render the smallest size,\n  // bounded vertically; `fitOverlay` clamps any residual width overflow.\n  const fontSize = Math.max(10, Math.round(size * 0.14));\n  return renderText({\n    text,\n    family,\n    size: fontSize,\n    color: '#FFFFFF',\n    bold: true,\n    width,\n    maxHeight: Math.max(fontSize, budget),\n  });\n}\n\n/** Builds the accent-tinted background pipeline. */\nfunction buildBackground(background: string, accent: Rgb, size: number): Sharp {\n  if (background === 'solid') {\n    const [r, g, b] = accent;\n    return sharp({ create: { width: size, height: size, channels: 3, background: { r, g, b } } });\n  }\n  if (background !== 'gradient') {\n    const [r, g, b] = hexToRgb(background);\n    return sharp({ create: { width: size, height: size, channels: 3, background: { r, g, b } } });\n  }\n  const [tr, tg, tb] = scaleRgb(accent, 0.3).map(Math.round) as [number, number, number];\n  const svg = `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${size}\" height=\"${size}\">\n    <defs><linearGradient id=\"bg\" x1=\"0\" y1=\"0\" x2=\"0\" y2=\"1\">\n      <stop offset=\"0\" stop-color=\"rgb(${tr},${tg},${tb})\"/>\n      <stop offset=\"1\" stop-color=\"rgb(8,8,10)\"/>\n    </linearGradient></defs>\n    <rect width=\"${size}\" height=\"${size}\" fill=\"url(#bg)\"/>\n  </svg>`;\n  return sharp(Buffer.from(svg)).resize(size, size);\n}\n\n/** Builds the SVG overlay carrying the play glyph and progress bar. */\nfunction buildShapes(opts: {\n  size: number;\n  margin: number;\n  accent: Rgb;\n  eyebrowY: number;\n  hasEyebrow: boolean;\n  progress: number | undefined;\n  barY: number;\n}): Buffer {\n  const { size, margin, accent, eyebrowY, hasEyebrow, progress, barY } = opts;\n  const [r, g, b] = accent;\n  const accentCss = `rgb(${r},${g},${b})`;\n  const parts: string[] = [];\n\n  if (hasEyebrow) {\n    const t = Math.round(size * 0.045);\n    const y = eyebrowY;\n    parts.push(\n      `<polygon points=\"${margin},${y} ${margin},${y + t} ${margin + t},${y + t / 2}\" fill=\"${accentCss}\"/>`,\n    );\n  }\n\n  if (progress !== undefined) {\n    const x0 = margin;\n    const x1 = size - margin;\n    const p = Math.max(0, Math.min(1, progress));\n    const fx = x0 + (x1 - x0) * p;\n    const [tr, tg, tb] = scaleRgb(accent, 0.45).map(Math.round) as [number, number, number];\n    parts.push(\n      `<line x1=\"${x0}\" y1=\"${barY}\" x2=\"${x1}\" y2=\"${barY}\" stroke=\"rgb(${tr},${tg},${tb})\" stroke-width=\"3\" stroke-linecap=\"round\"/>`,\n      `<line x1=\"${x0}\" y1=\"${barY}\" x2=\"${fx}\" y2=\"${barY}\" stroke=\"${accentCss}\" stroke-width=\"3\" stroke-linecap=\"round\"/>`,\n    );\n  }\n\n  return Buffer.from(\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${size}\" height=\"${size}\">${parts.join('')}</svg>`,\n  );\n}\n\n/**\n * Renders a designed now-playing-style panel and returns an\n * {@link EncodedFrame} ready for a panel. Overly long titles/subtitles are\n * shrunk to fit rather than overflowing the panel.\n *\n * @example\n * ```ts\n * const panel = await renderTextPanel({\n *   eyebrow: 'Now Playing',\n *   title: 'Bohemian Rhapsody',\n *   subtitle: 'Queen',\n *   accent: '#E94F37',\n *   progress: 0.42,\n * });\n * await client.draw.sendImage(1, panel.data);\n * ```\n */\nexport async function renderTextPanel(options: RenderTextPanelOptions): Promise<EncodedFrame> {\n  const size = options.size ?? PANEL_SIZE;\n  assertIntInRange(size, 1, MAX_PANEL_SIZE, 'size');\n  assertNonEmptyString(options.title, 'title');\n\n  const family = options.font ?? 'DejaVu Sans';\n  const accentHex = options.accent ?? '#1DB954';\n  const accent = hexToRgb(accentHex);\n  const margin = Math.round(size * 0.055);\n  const maxWidth = Math.max(1, size - margin * 2);\n\n  // Blank optional runs are skipped (Pango rejects empty text).\n  const eyebrowText = options.eyebrow?.trim();\n  const subtitleText = options.subtitle?.trim();\n\n  // Collected as raw placements, then each is clamped to the panel via fitOverlay.\n  const overlays: Array<{ buffer: Buffer; top: number; left: number }> = [];\n\n  // Eyebrow ---------------------------------------------------------------\n  let contentTop = margin;\n  const eyebrowY = margin + Math.round(size * 0.015);\n  if (eyebrowText) {\n    const glyph = Math.round(size * 0.045);\n    const eyebrowMaxHeight = Math.max(glyph, Math.round(size * 0.12));\n    const eyebrow = await renderText({\n      text: eyebrowText.toUpperCase(),\n      family,\n      size: Math.max(7, Math.round(size * 0.07)),\n      color: accentHex,\n      bold: true,\n      width: Math.max(1, maxWidth - glyph),\n    });\n    overlays.push({\n      buffer: eyebrow.buffer,\n      top: eyebrowY,\n      left: margin + glyph + Math.round(size * 0.03),\n    });\n    contentTop =\n      eyebrowY +\n      Math.min(Math.max(eyebrow.height, glyph), eyebrowMaxHeight) +\n      Math.round(size * 0.03);\n  }\n  // Always leave vertical room for the title.\n  contentTop = Math.min(contentTop, size - Math.round(size * 0.2));\n\n  // Progress bar + bottom limit ------------------------------------------\n  const hasProgress = typeof options.progress === 'number';\n  const barY = size - Math.round(size * 0.08);\n  const bottomLimit = hasProgress ? barY - Math.round(size * 0.06) : size - margin;\n\n  // Subtitle (rendered first so we know its height) ----------------------\n  let subtitleTop = bottomLimit;\n  if (subtitleText) {\n    const subSize = Math.max(9, Math.round(size * 0.11));\n    const maxSubHeight = subSize * 2 + 4;\n    // Render at the chosen size WITHOUT a CreateText `height`: setting `height`\n    // makes Pango auto-fit (scale) the glyphs to fill the box, which balloons\n    // short subtitles to ~2.5× their intended size. Cap to ~two lines by\n    // cropping the rendered buffer instead.\n    let subtitle = await renderText({\n      text: subtitleText,\n      family,\n      size: subSize,\n      color: accentHex,\n      width: maxWidth,\n    });\n    if (subtitle.height > maxSubHeight) {\n      const cropped = await sharp(subtitle.buffer)\n        .extract({ left: 0, top: 0, width: subtitle.width, height: maxSubHeight })\n        .png()\n        .toBuffer();\n      subtitle = { buffer: cropped, width: subtitle.width, height: maxSubHeight };\n    }\n    subtitleTop = Math.max(contentTop, bottomLimit - subtitle.height);\n    overlays.push({ buffer: subtitle.buffer, top: subtitleTop, left: margin });\n  }\n\n  // Title (fills the remaining vertical budget) --------------------------\n  const titleBottom = subtitleText ? subtitleTop : bottomLimit;\n  const titleBudget = Math.max(\n    Math.round(size * 0.12),\n    titleBottom - contentTop - Math.round(size * 0.03),\n  );\n  const title = await renderFittedTitle(options.title, family, maxWidth, titleBudget, size);\n  overlays.push({ buffer: title.buffer, top: contentTop, left: margin });\n\n  // Composite: shapes underlay, then every text overlay clamped to the panel.\n  const composites: OverlayOptions[] = [\n    {\n      input: buildShapes({\n        size,\n        margin,\n        accent,\n        eyebrowY,\n        hasEyebrow: Boolean(eyebrowText),\n        progress: options.progress,\n        barY,\n      }),\n      top: 0,\n      left: 0,\n    },\n  ];\n  for (const overlay of overlays) {\n    composites.push(await fitOverlay(overlay.buffer, overlay.top, overlay.left, size));\n  }\n\n  const pipeline = buildBackground(options.background ?? 'gradient', accent, size).composite(\n    composites,\n  );\n  return finalizeFrame(pipeline, { ...options, size });\n}\n"]}