@mdbase-dev/ui 0.1.0-beta.125 → 0.1.0-beta.147

package/dist/feedback-data.js

@@ -1,200 +1,397 @@
+import { i18n as _i18n } from "@lingui/core";
+import "./i18n.js";
 export const FEEDBACK_MAX_MESSAGE_LENGTH = 5_000;
 export const FEEDBACK_MAX_SCREENSHOT_BYTES = 3 * 1024 * 1024;
 export const FEEDBACK_ERROR_CODES = ["cancelled", "http_error", "invalid_response", "outcome_unknown", "partial_failure", "timeout", "network_error", "unknown_error", "save_failed", "source_open_failed", "preview_failed"];
 export const feedbackTopics = {
-    problem: { label: "Report a problem", prompt: "What happened?", placeholder: "What were you trying to do?", thanks: "Thanks for the report." },
-    idea: { label: "Suggest an improvement", prompt: "What would you like to improve?", placeholder: "How would it help you?", thanks: "Thanks for the idea." },
-    appreciation: { label: "Share something you like", prompt: "What’s working well for you?", placeholder: "What made a difference?", thanks: "Thanks for the kind words." }
+  problem: {
+    get label() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "hV3yAb",
+        message: "Report a problem"
+      });
+    },
+    get prompt() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "y_K0Dz",
+        message: "What happened?"
+      });
+    },
+    get placeholder() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "zDJycW",
+        message: "What were you trying to do?"
+      });
+    },
+    get thanks() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "GtzbT7",
+        message: "Thanks for the report."
+      });
+    }
+  },
+  idea: {
+    get label() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "aPgjJq",
+        message: "Suggest an improvement"
+      });
+    },
+    get prompt() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "TKM0Sf",
+        message: "What would you like to improve?"
+      });
+    },
+    get placeholder() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "ktO6Lq",
+        message: "How would it help you?"
+      });
+    },
+    get thanks() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "ngIpWJ",
+        message: "Thanks for the idea."
+      });
+    }
+  },
+  appreciation: {
+    get label() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "GaeNkI",
+        message: "Share something you like"
+      });
+    },
+    get prompt() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "nne584",
+        message: "What\u2019s working well for you?"
+      });
+    },
+    get placeholder() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "Dg50Vr",
+        message: "What made a difference?"
+      });
+    },
+    get thanks() {
+      return _i18n._(
+      /** i18n */
+      {
+        id: "UoMXZp",
+        message: "Thanks for the kind words."
+      });
+    }
+  }
 };
 /** Each provider owns its bounded, short-lived error buffer; never accepts messages or request data. */
 export function feedbackEvents(events, now = Date.now()) {
-    return events.filter((event) => { const age = now - Date.parse(event.at); return age >= 0 && age <= 5 * 60_000; }).slice(-30).map(({ at, code, status }) => ({ at, code, ...(status === undefined ? {} : { status }) }));
+  return events.filter(event => {
+    const age = now - Date.parse(event.at);
+    return age >= 0 && age <= 5 * 60_000;
+  }).slice(-30).map(({
+    at,
+    code,
+    status
+  }) => ({
+    at,
+    code,
+    ...(status === undefined ? {} : {
+      status
+    })
+  }));
 }
 export function feedbackDiagnostics(events) {
-    const ua = navigator.userAgent;
-    const family = /Edg\//u.test(ua) ? "Edge" : /Firefox\//u.test(ua) ? "Firefox" : /Chrome\//u.test(ua) ? "Chrome" : /Safari\//u.test(ua) ? "Safari" : "Other";
-    const browserMatch = { Edge: /Edg\/(\d+)/u, Firefox: /Firefox\/(\d+)/u, Chrome: /Chrome\/(\d+)/u, Safari: /Version\/(\d+)/u, Other: /$^/u }[family].exec(ua);
-    return {
-        schema_version: 2,
-        browser: family === "Other" ? "Other" : `${family} ${browserMatch?.[1] ?? "unknown"}`,
-        operating_system: /iPhone|iPad|iPod/u.test(ua) || (/Macintosh/u.test(ua) && navigator.maxTouchPoints > 1) ? "iOS" : /Android/u.test(ua) ? "Android" : /Windows/u.test(ua) ? "Windows" : /Macintosh|Mac OS/u.test(ua) ? "macOS" : /Linux/u.test(ua) ? "Linux" : "Other",
-        viewport: window.innerWidth < 760 ? "compact" : window.innerWidth < 1200 ? "medium" : "wide",
-        events: feedbackEvents(events)
-    };
+  const ua = navigator.userAgent;
+  const family = /Edg\//u.test(ua) ? "Edge" : /Firefox\//u.test(ua) ? "Firefox" : /Chrome\//u.test(ua) ? "Chrome" : /Safari\//u.test(ua) ? "Safari" : "Other";
+  const browserMatch = {
+    Edge: /Edg\/(\d+)/u,
+    Firefox: /Firefox\/(\d+)/u,
+    Chrome: /Chrome\/(\d+)/u,
+    Safari: /Version\/(\d+)/u,
+    Other: /$^/u
+  }[family].exec(ua);
+  return {
+    schema_version: 2,
+    browser: family === "Other" ? "Other" : `${family} ${browserMatch?.[1] ?? "unknown"}`,
+    operating_system: /iPhone|iPad|iPod/u.test(ua) || /Macintosh/u.test(ua) && navigator.maxTouchPoints > 1 ? "iOS" : /Android/u.test(ua) ? "Android" : /Windows/u.test(ua) ? "Windows" : /Macintosh|Mac OS/u.test(ua) ? "macOS" : /Linux/u.test(ua) ? "Linux" : "Other",
+    viewport: window.innerWidth < 760 ? "compact" : window.innerWidth < 1200 ? "medium" : "wide",
+    events: feedbackEvents(events)
+  };
 }
 export function resolveFeedbackEndpoint(configured, development = false) {
-    const value = configured?.trim() || (development ? "http://127.0.0.1:8790/v1/feedback" : "");
-    if (!value)
-        return null;
-    try {
-        const url = new URL(value);
-        if (url.username || url.password || (url.protocol !== "https:" && !(url.protocol === "http:" && ["127.0.0.1", "localhost"].includes(url.hostname))))
-            return null;
-        return url.href;
-    }
-    catch {
-        return null;
-    }
+  const value = configured?.trim() || (development ? "http://127.0.0.1:8790/v1/feedback" : "");
+  if (!value) return null;
+  try {
+    const url = new URL(value);
+    if (url.username || url.password || url.protocol !== "https:" && !(url.protocol === "http:" && ["127.0.0.1", "localhost"].includes(url.hostname))) return null;
+    return url.href;
+  } catch {
+    return null;
+  }
 }
 export function feedbackApplication(product, sourceView, revision, environment) {
-    if (!/^[a-z][a-z0-9_-]{0,63}$/u.test(sourceView))
-        throw new TypeError("Feedback views must be fixed identifiers, not URLs or record paths.");
-    return { product, source_view: sourceView, build_revision: revision && /^[a-zA-Z0-9._-]{1,64}$/u.test(revision) ? revision : null, environment: environment === "staging" || environment === "development" || environment === "lab" ? environment : "production" };
+  if (!/^[a-z][a-z0-9_-]{0,63}$/u.test(sourceView)) throw new TypeError("Feedback views must be fixed identifiers, not URLs or record paths.");
+  return {
+    product,
+    source_view: sourceView,
+    build_revision: revision && /^[a-zA-Z0-9._-]{1,64}$/u.test(revision) ? revision : null,
+    environment: environment === "staging" || environment === "development" || environment === "lab" ? environment : "production"
+  };
 }
 export async function sendFeedback(endpoint, submission, signal) {
-    let response;
-    try {
-        response = await fetch(endpoint, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(submission), credentials: "omit", referrerPolicy: "no-referrer", signal });
-    }
-    catch (error) {
-        if (signal.aborted)
-            throw error;
-        throw new Error("Feedback could not be sent. Check your connection and try again.");
-    }
-    if (response.ok)
-        return;
-    let message = "Feedback could not be sent. Please try again.";
-    try {
-        const result = await response.json();
-        if (typeof result.error?.message === "string" && result.error.message.length <= 200)
-            message = result.error.message;
-    }
-    catch { /* Never reflect infrastructure/provider response bodies. */ }
-    throw new Error(message);
+  let response;
+  try {
+    response = await fetch(endpoint, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify(submission),
+      credentials: "omit",
+      referrerPolicy: "no-referrer",
+      signal
+    });
+  } catch (error) {
+    if (signal.aborted) throw error;
+    throw new Error(_i18n._(
+    /** i18n */
+    {
+      id: "1CWcjd",
+      message: "Feedback could not be sent. Check your connection and try again."
+    }));
+  }
+  if (response.ok) return;
+  let message = _i18n._(
+  /** i18n */
+  {
+    id: "mRd7qL",
+    message: "Feedback could not be sent. Please try again."
+  });
+  try {
+    const result = await response.json();
+    if (typeof result.error?.message === "string" && result.error.message.length <= 200) message = result.error.message;
+  } catch {/* Never reflect infrastructure/provider response bodies. */}
+  throw new Error(message);
+}
+export function screenshotUrl(screenshot) {
+  return `data:${screenshot.media_type};base64,${screenshot.content_base64}`;
 }
-export function screenshotUrl(screenshot) { return `data:${screenshot.media_type};base64,${screenshot.content_base64}`; }
 function bytesToBase64(bytes) {
-    let binary = "";
-    for (let offset = 0; offset < bytes.length; offset += 32_768)
-        binary += String.fromCharCode(...bytes.subarray(offset, offset + 32_768));
-    return btoa(binary);
+  let binary = "";
+  for (let offset = 0; offset < bytes.length; offset += 32_768) binary += String.fromCharCode(...bytes.subarray(offset, offset + 32_768));
+  return btoa(binary);
 }
 export async function screenshotFromCanvas(canvas, type = "image/png") {
-    const blob = await new Promise((resolve, reject) => canvas.toBlob((result) => result ? resolve(result) : reject(new Error("The screenshot could not be created.")), type, type === "image/jpeg" ? 0.9 : undefined));
-    if (blob.size > FEEDBACK_MAX_SCREENSHOT_BYTES)
-        throw new Error("The screenshot is larger than 3 MB. Choose a smaller image.");
-    return { media_type: type, filename: type === "image/png" ? "screenshot.png" : "screenshot.jpg", content_base64: bytesToBase64(new Uint8Array(await blob.arrayBuffer())) };
+  const blob = await new Promise((resolve, reject) => canvas.toBlob(result => result ? resolve(result) : reject(new Error(_i18n._(
+  /** i18n */
+  {
+    id: "DXe-Ku",
+    message: "The screenshot could not be created."
+  }))), type, type === "image/jpeg" ? 0.9 : undefined));
+  if (blob.size > FEEDBACK_MAX_SCREENSHOT_BYTES) throw new Error(_i18n._(
+  /** i18n */
+  {
+    id: "06ZW-I",
+    message: "The screenshot is larger than 3 MB. Choose a smaller image."
+  }));
+  return {
+    media_type: type,
+    filename: type === "image/png" ? "screenshot.png" : "screenshot.jpg",
+    content_base64: bytesToBase64(new Uint8Array(await blob.arrayBuffer()))
+  };
 }
 export async function readFeedbackScreenshot(file) {
-    if (file.size > FEEDBACK_MAX_SCREENSHOT_BYTES)
-        throw new Error("Choose a screenshot smaller than 3 MB.");
-    if (file.type !== "image/png" && file.type !== "image/jpeg")
-        throw new Error("Choose a PNG or JPEG screenshot.");
-    const bytes = new Uint8Array(await file.arrayBuffer());
-    const valid = file.type === "image/png" ? [137, 80, 78, 71, 13, 10, 26, 10].every((v, i) => bytes[i] === v) : bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff;
-    if (!valid)
-        throw new Error("The screenshot does not contain a valid PNG or JPEG image.");
-    const dimensions = rasterDimensions(bytes, file.type);
-    assertImageSize(dimensions.width, dimensions.height); // Reject decompression bombs before browser decoding.
-    const url = URL.createObjectURL(file);
-    try {
-        const image = new Image();
-        image.src = url;
-        await image.decode();
-        assertImageSize(image.naturalWidth, image.naturalHeight);
-        const canvas = document.createElement("canvas");
-        canvas.width = image.naturalWidth;
-        canvas.height = image.naturalHeight;
-        const context = canvas.getContext("2d");
-        if (!context)
-            throw new Error("The screenshot could not be cleaned in this browser.");
-        context.drawImage(image, 0, 0);
-        return await screenshotFromCanvas(canvas, file.type);
-    }
-    finally {
-        URL.revokeObjectURL(url);
-    }
+  if (file.size > FEEDBACK_MAX_SCREENSHOT_BYTES) throw new Error(_i18n._(
+  /** i18n */
+  {
+    id: "88OB58",
+    message: "Choose a screenshot smaller than 3 MB."
+  }));
+  if (file.type !== "image/png" && file.type !== "image/jpeg") throw new Error(_i18n._(
+  /** i18n */
+  {
+    id: "bRZJdX",
+    message: "Choose a PNG or JPEG screenshot."
+  }));
+  const bytes = new Uint8Array(await file.arrayBuffer());
+  const valid = file.type === "image/png" ? [137, 80, 78, 71, 13, 10, 26, 10].every((v, i) => bytes[i] === v) : bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff;
+  if (!valid) throw new Error(_i18n._(
+  /** i18n */
+  {
+    id: "WtBLy2",
+    message: "The screenshot does not contain a valid PNG or JPEG image."
+  }));
+  const dimensions = rasterDimensions(bytes, file.type);
+  assertImageSize(dimensions.width, dimensions.height); // Reject decompression bombs before browser decoding.
+  const url = URL.createObjectURL(file);
+  try {
+    const image = new Image();
+    image.src = url;
+    await image.decode();
+    assertImageSize(image.naturalWidth, image.naturalHeight);
+    const canvas = document.createElement("canvas");
+    canvas.width = image.naturalWidth;
+    canvas.height = image.naturalHeight;
+    const context = canvas.getContext("2d");
+    if (!context) throw new Error(_i18n._(
+    /** i18n */
+    {
+      id: "0LOjOR",
+      message: "The screenshot could not be cleaned in this browser."
+    }));
+    context.drawImage(image, 0, 0);
+    return await screenshotFromCanvas(canvas, file.type);
+  } finally {
+    URL.revokeObjectURL(url);
+  }
 }
 function assertImageSize(width, height) {
-    if (!width || !height || width > 8192 || height > 8192 || width * height > 16_000_000)
-        throw new Error("Choose a screenshot smaller than 16 megapixels.");
+  if (!width || !height || width > 8192 || height > 8192 || width * height > 16_000_000) throw new Error(_i18n._(
+  /** i18n */
+  {
+    id: "BCJqT2",
+    message: "Choose a screenshot smaller than 16 megapixels."
+  }));
 }
 function rasterDimensions(bytes, type) {
-    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-    if (type === "image/png" && bytes.length >= 24 && String.fromCharCode(...bytes.subarray(12, 16)) === "IHDR")
-        return { width: view.getUint32(16), height: view.getUint32(20) };
-    if (type === "image/jpeg") {
-        let offset = 2;
-        while (offset + 4 <= bytes.length) {
-            if (bytes[offset++] !== 0xff)
-                break;
-            while (bytes[offset] === 0xff)
-                offset++;
-            const marker = bytes[offset++];
-            if (marker === 0xd9 || marker === 0xda || marker === undefined || offset + 2 > bytes.length)
-                break;
-            if (marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7))
-                continue;
-            const length = view.getUint16(offset);
-            if (length < 2 || offset + length > bytes.length)
-                break;
-            if ([0xc0, 0xc1, 0xc2, 0xc3, 0xc5, 0xc6, 0xc7, 0xc9, 0xca, 0xcb, 0xcd, 0xce, 0xcf].includes(marker) && length >= 8)
-                return { width: view.getUint16(offset + 5), height: view.getUint16(offset + 3) };
-            offset += length;
-        }
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  if (type === "image/png" && bytes.length >= 24 && String.fromCharCode(...bytes.subarray(12, 16)) === "IHDR") return {
+    width: view.getUint32(16),
+    height: view.getUint32(20)
+  };
+  if (type === "image/jpeg") {
+    let offset = 2;
+    while (offset + 4 <= bytes.length) {
+      if (bytes[offset++] !== 0xff) break;
+      while (bytes[offset] === 0xff) offset++;
+      const marker = bytes[offset++];
+      if (marker === 0xd9 || marker === 0xda || marker === undefined || offset + 2 > bytes.length) break;
+      if (marker === 0x01 || marker >= 0xd0 && marker <= 0xd7) continue;
+      const length = view.getUint16(offset);
+      if (length < 2 || offset + length > bytes.length) break;
+      if ([0xc0, 0xc1, 0xc2, 0xc3, 0xc5, 0xc6, 0xc7, 0xc9, 0xca, 0xcb, 0xcd, 0xce, 0xcf].includes(marker) && length >= 8) return {
+        width: view.getUint16(offset + 5),
+        height: view.getUint16(offset + 3)
+      };
+      offset += length;
     }
-    throw new Error("The screenshot does not contain a valid PNG or JPEG image.");
+  }
+  throw new Error(_i18n._(
+  /** i18n */
+  {
+    id: "WtBLy2",
+    message: "The screenshot does not contain a valid PNG or JPEG image."
+  }));
 }
 async function bounded(promise, milliseconds, signal) {
-    let timer;
-    let abort;
-    try {
-        return await Promise.race([promise, new Promise((_, reject) => {
-                abort = () => reject(new DOMException("Capture cancelled", "AbortError"));
-                if (signal.aborted) {
-                    abort();
-                    return;
-                }
-                signal.addEventListener("abort", abort, { once: true });
-                timer = setTimeout(() => reject(new Error("The screenshot could not be captured. Try again.")), milliseconds);
-            })]);
-    }
-    finally {
-        clearTimeout(timer);
-        if (abort)
-            signal.removeEventListener("abort", abort);
-    }
+  let timer;
+  let abort;
+  try {
+    return await Promise.race([promise, new Promise((_, reject) => {
+      abort = () => reject(new DOMException("Capture cancelled", "AbortError"));
+      if (signal.aborted) {
+        abort();
+        return;
+      }
+      signal.addEventListener("abort", abort, {
+        once: true
+      });
+      timer = setTimeout(() => reject(new Error(_i18n._(
+      /** i18n */
+      {
+        id: "5u4cOF",
+        message: "The screenshot could not be captured. Try again."
+      }))), milliseconds);
+    })]);
+  } finally {
+    clearTimeout(timer);
+    if (abort) signal.removeEventListener("abort", abort);
+  }
 }
 /** Caller closes the native dialog first. Media is always stopped, including cancellation/unmount. */
 export async function captureFeedbackScreenshot(signal) {
-    if (!navigator.mediaDevices?.getDisplayMedia)
-        throw new Error("Screen capture isn’t available in this browser. You can attach an image instead.");
-    await bounded(new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(() => resolve()))), 1000, signal);
-    if (signal.aborted)
-        throw new DOMException("Capture cancelled", "AbortError");
-    // The picker is intentionally not timed out: the user decides whether to grant capture.
-    const stream = await navigator.mediaDevices.getDisplayMedia({ video: { displaySurface: "browser" }, audio: false, preferCurrentTab: true, selfBrowserSurface: "include", surfaceSwitching: "exclude" });
-    const stop = () => stream.getTracks().forEach((track) => track.stop());
-    const video = document.createElement("video");
-    let frameCallback;
-    signal.addEventListener("abort", stop, { once: true });
-    try {
-        if (signal.aborted)
-            throw new DOMException("Capture cancelled", "AbortError");
-        video.muted = true;
-        video.playsInline = true;
-        video.srcObject = stream;
-        const frame = typeof video.requestVideoFrameCallback === "function" ? new Promise((resolve) => { frameCallback = video.requestVideoFrameCallback(() => resolve()); }) : Promise.resolve();
-        await bounded(Promise.all([video.play(), frame]), 5000, signal);
-        if (!video.videoWidth || !video.videoHeight || stream.getVideoTracks()[0]?.readyState === "ended")
-            throw new Error("Screen sharing ended before a screenshot was taken.");
-        const scale = Math.min(1, 1600 / video.videoWidth, 1200 / video.videoHeight);
-        const canvas = document.createElement("canvas");
-        canvas.width = Math.round(video.videoWidth * scale);
-        canvas.height = Math.round(video.videoHeight * scale);
-        const context = canvas.getContext("2d");
-        if (!context)
-            throw new Error("The screenshot could not be created in this browser.");
-        context.drawImage(video, 0, 0, canvas.width, canvas.height);
-        stop(); // Do not leave sharing running during asynchronous PNG encoding.
-        return await screenshotFromCanvas(canvas);
-    }
-    finally {
-        stop();
-        signal.removeEventListener("abort", stop);
-        if (frameCallback !== undefined)
-            video.cancelVideoFrameCallback(frameCallback);
-        video.pause();
-        video.srcObject = null;
-    }
+  if (!navigator.mediaDevices?.getDisplayMedia) throw new Error(_i18n._(
+  /** i18n */
+  {
+    id: "DWBQ45",
+    message: "Screen capture isn\u2019t available in this browser. You can attach an image instead."
+  }));
+  await bounded(new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(() => resolve()))), 1000, signal);
+  if (signal.aborted) throw new DOMException("Capture cancelled", "AbortError");
+  // The picker is intentionally not timed out: the user decides whether to grant capture.
+  const stream = await navigator.mediaDevices.getDisplayMedia({
+    video: {
+      displaySurface: "browser"
+    },
+    audio: false,
+    preferCurrentTab: true,
+    selfBrowserSurface: "include",
+    surfaceSwitching: "exclude"
+  });
+  const stop = () => stream.getTracks().forEach(track => track.stop());
+  const video = document.createElement("video");
+  let frameCallback;
+  signal.addEventListener("abort", stop, {
+    once: true
+  });
+  try {
+    if (signal.aborted) throw new DOMException("Capture cancelled", "AbortError");
+    video.muted = true;
+    video.playsInline = true;
+    video.srcObject = stream;
+    const frame = typeof video.requestVideoFrameCallback === "function" ? new Promise(resolve => {
+      frameCallback = video.requestVideoFrameCallback(() => resolve());
+    }) : Promise.resolve();
+    await bounded(Promise.all([video.play(), frame]), 5000, signal);
+    if (!video.videoWidth || !video.videoHeight || stream.getVideoTracks()[0]?.readyState === "ended") throw new Error(_i18n._(
+    /** i18n */
+    {
+      id: "zJfG-M",
+      message: "Screen sharing ended before a screenshot was taken."
+    }));
+    const scale = Math.min(1, 1600 / video.videoWidth, 1200 / video.videoHeight);
+    const canvas = document.createElement("canvas");
+    canvas.width = Math.round(video.videoWidth * scale);
+    canvas.height = Math.round(video.videoHeight * scale);
+    const context = canvas.getContext("2d");
+    if (!context) throw new Error(_i18n._(
+    /** i18n */
+    {
+      id: "Qymvdk",
+      message: "The screenshot could not be created in this browser."
+    }));
+    context.drawImage(video, 0, 0, canvas.width, canvas.height);
+    stop(); // Do not leave sharing running during asynchronous PNG encoding.
+    return await screenshotFromCanvas(canvas);
+  } finally {
+    stop();
+    signal.removeEventListener("abort", stop);
+    if (frameCallback !== undefined) video.cancelVideoFrameCallback(frameCallback);
+    video.pause();
+    video.srcObject = null;
+  }
 }

package/dist/flock.d.ts

@@ -0,0 +1,63 @@
+import { type MdbaseMarkRect } from "./brand.js";
+/**
+ * The launch flock: small birds fly in from the edges of the screen, land on the
+ * Frontmatter mark as two rows of dots per bar, and close up into the solid bars.
+ * Everything here is a pure function of time, so a frame can be drawn at any moment
+ * and tests can check where the birds end up.
+ */
+/** Seconds. The mark is solid at `solid`; the entrance hands over to the real mark at `end`. */
+export declare const FLOCK_TIMING: {
+    /** Spread of start times; each bird leaves within this window. */
+    readonly spread: 0.45;
+    /** How long each bird is in the air. */
+    readonly flight: 0.85;
+    /** When the first bars start closing up. */
+    readonly close: 1.2;
+    /** Spread of the bars' close-up times, top to bottom with the highlight last. */
+    readonly closeStagger: 0.2;
+    /** How long one bar takes to close up. */
+    readonly closeDuration: 0.3;
+    readonly solid: 1.8;
+    readonly end: 2;
+};
+type FlockBird = Readonly<{
+    /** Index of the bar this bird belongs to in `flockBars`. */
+    bar: number;
+    accent: boolean;
+    /** Landed dot, in mark units (the 120-unit board the mark's rects use). */
+    dotX: number;
+    dotY: number;
+    /** The share of its bar the bird grows into when the bar closes up. */
+    cell: MdbaseMarkRect;
+    seed: number;
+}>;
+type FlockBar = Readonly<{
+    rect: MdbaseMarkRect;
+    accent: boolean;
+}>;
+export declare const flockBars: readonly FlockBar[];
+/** Two rows of dots per bar; each dot's cell tiles its bar exactly. */
+export declare const flockBirds: readonly FlockBird[];
+/** Where the mark sits on screen: its 84-unit artboard (viewBox 18 18 84 84) in pixels. */
+type FlockStage = Readonly<{
+    width: number;
+    height: number;
+    markLeft: number;
+    markTop: number;
+    markSize: number;
+}>;
+type FlockFrame = Readonly<{
+    /** One rectangle per bird still drawn as a bird, in screen pixels. */
+    birds: readonly (MdbaseMarkRect & {
+        accent: boolean;
+    })[];
+    /** Bars that have closed up completely, drawn as the real rectangles. */
+    bars: readonly (MdbaseMarkRect & {
+        accent: boolean;
+    })[];
+}>;
+/** How far bar `index` has closed up at time `t`, 0 to 1. */
+export declare function flockBarClosed(index: number, t: number): number;
+/** Everything to draw at time `t` seconds into the entrance. */
+export declare function flockFrame(stage: FlockStage, t: number): FlockFrame;
+export {};