@damian-buho/support-ukraine 1.0.0

package/dist/test/index.test.js

@@ -0,0 +1,656 @@
+// tests/index.test.ts
+import { describe, it, before, beforeEach } from "node:test";
+import assert from "node:assert/strict";
+
+// src/types.ts
+import { z } from "zod";
+var charityTagSchema = z.enum(["military", "humanitarian", "animals"]);
+var charitySchema = z.object({
+  id: z.string().min(1),
+  name: z.string().min(1),
+  tagline: z.string().min(1),
+  url: z.string().url(),
+  tags: z.array(charityTagSchema).min(1)
+});
+var charitiesSchema = z.array(charitySchema);
+
+// src/charities.yaml
+var charities_default = [{ "id": "united24", "name": "United24", "tagline": "Official fundraising platform of Ukraine", "url": "https://u24.gov.ua", "tags": ["humanitarian"] }, { "id": "come-back-alive", "name": "Come Back Alive", "tagline": "Supporting the Ukrainian Armed Forces since 2014", "url": "https://www.comebackalive.in.ua", "tags": ["military"] }, { "id": "razom-for-ukraine", "name": "Razom for Ukraine", "tagline": "Emergency response and humanitarian aid", "url": "https://www.razomforukraine.org", "tags": ["humanitarian"] }, { "id": "ukrainian-red-cross", "name": "Ukrainian Red Cross", "tagline": "Humanitarian assistance in conflict zones", "url": "https://redcross.org.ua/en/", "tags": ["humanitarian"] }, { "id": "nova-ukraine", "name": "Nova Ukraine", "tagline": "Humanitarian aid and advocacy", "url": "https://novaukraine.org", "tags": ["humanitarian"] }, { "id": "voices-of-children", "name": "Voices of Children", "tagline": "Psychological support for children affected by war", "url": "https://voices.org.ua/en/", "tags": ["humanitarian"] }, { "id": "prytula-foundation", "name": "Prytula Foundation", "tagline": "Defence technology and equipment for Ukraine", "url": "https://prytulafoundation.org/en", "tags": ["military"] }, { "id": "army-of-drones", "name": "Army of Drones", "tagline": "Reconnaissance drones for the frontline", "url": "https://armyofdrones.com", "tags": ["military"] }, { "id": "world-central-kitchen", "name": "World Central Kitchen", "tagline": "Fresh meals for people in conflict zones", "url": "https://wck.org/relief/activation-chefs-for-ukraine/", "tags": ["humanitarian"] }, { "id": "cats-of-kyiv", "name": "Cats of Kyiv", "tagline": "Cat shelter rescuing and rehoming cats in Kyiv", "url": "https://cats.kiev.ua", "tags": ["animals"] }, { "id": "uanimals", "name": "UAnimals", "tagline": "Animal rescue and advocacy organization in Ukraine", "url": "https://uanimals.org", "tags": ["animals"] }, { "id": "hospitallers", "name": "Hospitallers Medical Battalion", "tagline": "Ukrainian voluntary paramedics providing first aid and evacuation", "url": "https://www.hospitallers.org.uk", "tags": ["humanitarian"] }, { "id": "sternenko-fund", "name": "Sternenko Fund", "tagline": "FPV drone supply for Ukrainian defence forces", "url": "https://www.sternenkofund.org", "tags": ["military"] }, { "id": "life-robots-ukraine", "name": "Life Robots Ukraine", "tagline": "Robots for demining Ukraine", "url": "https://liferobots.com.ua", "tags": ["humanitarian"] }, { "id": "sirius-shelter", "name": "Sirius", "tagline": "Ukraine's largest animal shelter for dogs and cats", "url": "https://dogcat.com.ua", "tags": ["animals"] }];
+
+// src/styles.scss
+var styles_default = ".support-ukraine-block{width:100%;display:flex;align-items:center;justify-content:center;font-family:system-ui,-apple-system,sans-serif;text-decoration:none;box-sizing:border-box;line-height:1.4;z-index:2147483647;background-color:#0057b7}@media(prefers-color-scheme: dark){.support-ukraine-block{background-color:gold}}.support-ukraine-block--shift{position:relative}.support-ukraine-block--overlap{position:fixed;top:0;left:0}.support-ukraine-block__link{display:inline-flex;align-items:center;flex-wrap:wrap;gap:0 .25em;text-decoration:none;flex:1;height:100%;justify-content:flex-start;text-align:left;padding:1rem 2rem;box-sizing:border-box;color:#fff;text-shadow:0 1px 2px rgba(0,0,0,.4)}@media(prefers-color-scheme: dark){.support-ukraine-block__link{color:#000;text-shadow:0 1px 2px hsla(0,0%,100%,.4)}}.support-ukraine-block__link:hover{opacity:.9}.support-ukraine-block__prefix{white-space:nowrap}.support-ukraine-block__info{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.support-ukraine-block__all{display:inline-flex;align-items:center;text-decoration:none;padding:1rem 2rem;box-sizing:border-box;color:#fff;text-shadow:0 1px 2px rgba(0,0,0,.4);white-space:nowrap;opacity:.8}@media(prefers-color-scheme: dark){.support-ukraine-block__all{color:#000;text-shadow:0 1px 2px hsla(0,0%,100%,.4)}}.support-ukraine-block__all:hover{opacity:1}.support-ukraine-block__all-ellipsis{display:none}@media(max-width: 640px){.support-ukraine-block{flex-wrap:wrap}.support-ukraine-block__link{flex:1 1 100%;padding:.75rem 1.25rem}.support-ukraine-block__info{flex:1 1 100%;white-space:normal;overflow:visible;text-overflow:unset;padding-left:1.5em}.support-ukraine-block__all{display:none}}[dir=rtl] .support-ukraine-block__link{text-align:right;justify-content:flex-end}[dir=rtl] .support-ukraine-block__all{text-align:right}@media(max-width: 640px){[dir=rtl] .support-ukraine-block__info{padding-left:0;padding-right:1.5em}}";
+
+// src/locales/index.ts
+var localeLoaders = {
+  en: () => import("./en-PKQHFIBK.js"),
+  es: () => import("./es-O2475R7Z.js"),
+  fr: () => import("./fr-X6V3WLWM.js"),
+  de: () => import("./de-TH7AAXFP.js"),
+  pt: () => import("./pt-FYGLQOH5.js"),
+  it: () => import("./it-2WUTSGIT.js"),
+  pl: () => import("./pl-6W3JBZBK.js"),
+  nl: () => import("./nl-XSVZSNMF.js"),
+  sv: () => import("./sv-LSP66UWZ.js"),
+  uk: () => import("./uk-TI5W6EQE.js"),
+  ar: () => import("./ar-KPYMLJQQ.js"),
+  zh: () => import("./zh-KPKJOFBN.js"),
+  hi: () => import("./hi-AGHL2F3M.js"),
+  th: () => import("./th-PBC35HRN.js"),
+  ja: () => import("./ja-PRYDFFQ7.js"),
+  ko: () => import("./ko-2G672DOI.js")
+};
+var RTL_LOCALES = ["ar"];
+function resolveLocale(tag) {
+  const base = (tag.split("-", 1)[0] ?? "").toLowerCase();
+  if (Object.hasOwn(localeLoaders, base)) {
+    return base;
+  }
+  return "en";
+}
+
+// src/i18n.ts
+var cache = /* @__PURE__ */ new Map();
+function detectLocale(preferred) {
+  if (preferred) {
+    return resolveLocale(preferred);
+  }
+  if (typeof navigator !== "undefined" && navigator.languages) {
+    for (const tag of navigator.languages) {
+      const resolved = resolveLocale(tag);
+      if (resolved !== "en") {
+        return resolved;
+      }
+    }
+  }
+  if (typeof navigator !== "undefined" && navigator.language) {
+    const resolved = resolveLocale(navigator.language);
+    if (resolved !== "en") {
+      return resolved;
+    }
+  }
+  return "en";
+}
+async function loadLocale(lang) {
+  const code = resolveLocale(lang);
+  const cached = cache.get(code);
+  if (cached) {
+    return cached;
+  }
+  try {
+    const loaded = await localeLoaders[code]();
+    cache.set(code, loaded.default);
+    return loaded.default;
+  } catch {
+    if (code !== "en") {
+      return loadLocale("en");
+    }
+    throw new Error(`[support-ukraine] Failed to load locale "${code}"`);
+  }
+}
+function mergeCharities(base, locale) {
+  return base.map((charity) => {
+    const translated = locale.charities[charity.id];
+    if (translated?.tagline) {
+      return { ...charity, tagline: translated.tagline };
+    }
+    return charity;
+  });
+}
+function isRTL(lang) {
+  const code = resolveLocale(lang);
+  return RTL_LOCALES.includes(code);
+}
+function formatBannerText(charity, messages) {
+  return `\u{1F1FA}\u{1F1E6} ${messages.supportUkraine}: ${charity.name}: ${charity.tagline}`;
+}
+
+// src/index.ts
+var DEFAULT_CHARITIES = charitiesSchema.parse(charities_default);
+var CSS_PREFIX = "support-ukraine-block";
+var STORAGE_KEY = "support-ukraine-seen";
+function readSeen() {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    return raw ? new Set(JSON.parse(raw)) : /* @__PURE__ */ new Set();
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+function writeSeen(seen) {
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify([...seen]));
+  } catch {
+  }
+}
+function updateSeen(mutate) {
+  const seen = readSeen();
+  mutate(seen);
+  writeSeen(seen);
+}
+function randomItem(items) {
+  if (items.length === 0) {
+    throw new Error("randomItem: cannot pick from an empty array");
+  }
+  return items[Math.floor(Math.random() * items.length)];
+}
+function injectStyles() {
+  const id = `${CSS_PREFIX}-styles`;
+  if (document.querySelector(`#${id}`)) {
+    return;
+  }
+  const style = document.createElement("style");
+  style.id = id;
+  style.textContent = styles_default;
+  document.head.append(style);
+}
+async function supportUkraineBlock(options = {}) {
+  const {
+    mode = "shift",
+    fontSize = "0.875rem",
+    tags,
+    dontRepeat = true,
+    isInConsole = true,
+    locale: requestedLocale
+  } = options;
+  injectStyles();
+  const lang = detectLocale(requestedLocale);
+  const messages = await loadLocale(lang);
+  const localizedCharities = mergeCharities(DEFAULT_CHARITIES, messages);
+  let candidates = tags && tags.length > 0 ? localizedCharities.filter((charity2) => charity2.tags.some((t) => tags.includes(t))) : localizedCharities;
+  if (candidates.length === 0) {
+    candidates = localizedCharities;
+  }
+  if (dontRepeat) {
+    updateSeen((seen) => {
+      const unseen = candidates.filter((c) => !seen.has(c.url));
+      if (unseen.length > 0) {
+        candidates = unseen;
+      } else {
+        seen.clear();
+      }
+    });
+  }
+  const charity = randomItem(candidates);
+  if (dontRepeat) {
+    updateSeen((seen) => {
+      seen.add(charity.url);
+    });
+  }
+  const banner = document.createElement("header");
+  banner.className = `${CSS_PREFIX} ${CSS_PREFIX}--${mode}`;
+  banner.lang = lang;
+  if (isRTL(lang)) {
+    banner.setAttribute("dir", "rtl");
+  }
+  const link = document.createElement("a");
+  link.className = `${CSS_PREFIX}__link`;
+  link.href = charity.url;
+  link.target = "_blank";
+  link.rel = "noopener noreferrer";
+  link.style.fontSize = fontSize;
+  const prefix = document.createElement("span");
+  prefix.className = `${CSS_PREFIX}__prefix`;
+  prefix.textContent = `\u{1F1FA}\u{1F1E6} ${messages.supportUkraine}:`;
+  const info = document.createElement("span");
+  info.className = `${CSS_PREFIX}__info`;
+  info.textContent = `${charity.name}: ${charity.tagline}`;
+  link.append(prefix, info);
+  banner.append(link);
+  const allLink = document.createElement("a");
+  allLink.className = `${CSS_PREFIX}__all`;
+  allLink.href = "https://damian-buho.github.io/support-ukraine/";
+  allLink.target = "_blank";
+  allLink.rel = "noopener noreferrer";
+  allLink.style.fontSize = fontSize;
+  const allText = document.createElement("span");
+  allText.className = `${CSS_PREFIX}__all-text`;
+  allText.textContent = messages.allCharities;
+  const allEllipsis = document.createElement("span");
+  allEllipsis.className = `${CSS_PREFIX}__all-ellipsis`;
+  allEllipsis.textContent = "\u2026";
+  allLink.append(allText, allEllipsis);
+  banner.append(allLink);
+  const mount = options.element ?? document.body;
+  mount.prepend(banner);
+  if (isInConsole) {
+    console.info("[support-ukraine] banner", `${charity.name}: ${charity.tagline}`, charity.url);
+  }
+  return banner;
+}
+
+// tests/index.test.ts
+describe("DEFAULT_CHARITIES", () => {
+  it("is a non-empty array", () => {
+    assert.ok(Array.isArray(DEFAULT_CHARITIES));
+    assert.ok(DEFAULT_CHARITIES.length > 0);
+  });
+  it("every charity has id, name, tagline, url, and tags", () => {
+    const validTags = /* @__PURE__ */ new Set(["military", "humanitarian", "animals"]);
+    for (const charity of DEFAULT_CHARITIES) {
+      assert.equal(typeof charity.id, "string", "id must be a string");
+      assert.ok(charity.id.length > 0, "id must not be empty");
+      assert.equal(typeof charity.name, "string", "name must be a string");
+      assert.ok(charity.name.length > 0, "name must not be empty");
+      assert.equal(typeof charity.tagline, "string", "tagline must be a string");
+      assert.ok(charity.tagline.length > 0, "tagline must not be empty");
+      assert.equal(typeof charity.url, "string", "url must be a string");
+      assert.ok(charity.url.startsWith("http"), "url must start with http");
+      assert.ok(Array.isArray(charity.tags), "tags must be an array");
+      assert.ok(charity.tags.length > 0, "tags must not be empty");
+      for (const tag of charity.tags) {
+        assert.ok(validTags.has(tag), `tag "${tag}" must be a valid CharityTag`);
+      }
+    }
+  });
+  it("has at least 5 charities", () => {
+    assert.ok(DEFAULT_CHARITIES.length >= 5);
+  });
+  it("has unique charity ids", () => {
+    const ids = DEFAULT_CHARITIES.map((c) => c.id);
+    const unique = new Set(ids);
+    assert.equal(ids.length, unique.size, "charity ids must be unique");
+  });
+  it("has unique charity names", () => {
+    const names = DEFAULT_CHARITIES.map((c) => c.name);
+    const unique = new Set(names);
+    assert.equal(names.length, unique.size, "charity names must be unique");
+  });
+  it("has charities for each tag", () => {
+    const tags = /* @__PURE__ */ new Set();
+    for (const charity of DEFAULT_CHARITIES) {
+      for (const tag of charity.tags) {
+        tags.add(tag);
+      }
+    }
+    assert.ok(tags.has("military"), "must have at least one military charity");
+    assert.ok(tags.has("humanitarian"), "must have at least one humanitarian charity");
+    assert.ok(tags.has("animals"), "must have at least one animals charity");
+  });
+});
+describe("charitiesSchema", () => {
+  it("accepts valid charity objects", () => {
+    const valid = [
+      {
+        id: "test",
+        name: "Test",
+        tagline: "Helping",
+        url: "https://example.com",
+        tags: ["military"]
+      }
+    ];
+    assert.doesNotThrow(() => charitiesSchema.parse(valid));
+  });
+  it("rejects missing required fields", () => {
+    const incomplete = [{ id: "test" }];
+    assert.throws(() => charitiesSchema.parse(incomplete));
+  });
+  it("rejects invalid url", () => {
+    const bad = [{ id: "t", name: "T", tagline: "T", url: "not-a-url", tags: ["military"] }];
+    assert.throws(() => charitiesSchema.parse(bad));
+  });
+  it("rejects invalid tag", () => {
+    const bad = [{ id: "t", name: "T", tagline: "T", url: "https://x.com", tags: ["invalid"] }];
+    assert.throws(() => charitiesSchema.parse(bad));
+  });
+  it("rejects empty tags array", () => {
+    const bad = [{ id: "t", name: "T", tagline: "T", url: "https://x.com", tags: [] }];
+    assert.throws(() => charitiesSchema.parse(bad));
+  });
+});
+describe("randomItem", () => {
+  it("is a function", () => {
+    assert.equal(typeof randomItem, "function");
+  });
+  it("returns an item from the array", () => {
+    const items = ["a", "b", "c"];
+    for (let index = 0; index < 20; index++) {
+      const result = randomItem(items);
+      assert.ok(items.includes(result));
+    }
+  });
+  it("returns the single item when array has one element", () => {
+    assert.equal(randomItem(["only"]), "only");
+  });
+  it("throws on empty array", () => {
+    assert.throws(() => randomItem([]), /empty array/);
+  });
+});
+describe("resolveLocale", () => {
+  it('returns "en" for English tags', () => {
+    assert.equal(resolveLocale("en"), "en");
+    assert.equal(resolveLocale("en-US"), "en");
+    assert.equal(resolveLocale("en-GB"), "en");
+  });
+  it("resolves supported locales by base tag", () => {
+    assert.equal(resolveLocale("es"), "es");
+    assert.equal(resolveLocale("es-MX"), "es");
+    assert.equal(resolveLocale("fr"), "fr");
+    assert.equal(resolveLocale("fr-CA"), "fr");
+    assert.equal(resolveLocale("ar"), "ar");
+    assert.equal(resolveLocale("zh-CN"), "zh");
+    assert.equal(resolveLocale("ja"), "ja");
+    assert.equal(resolveLocale("ko"), "ko");
+  });
+  it('falls back to "en" for unsupported locales', () => {
+    assert.equal(resolveLocale("xx"), "en");
+    assert.equal(resolveLocale("unknown"), "en");
+  });
+});
+describe("detectLocale", () => {
+  it("returns the preferred locale when provided", () => {
+    assert.equal(detectLocale("es"), "es");
+    assert.equal(detectLocale("fr-CA"), "fr");
+  });
+  it('falls back to "en" when navigator is undefined (Node)', () => {
+    const savedNavigator = navigator;
+    delete globalThis.navigator;
+    assert.equal(detectLocale(), "en");
+    globalThis.navigator = savedNavigator;
+  });
+  it("prefers navigator.languages over navigator.language", () => {
+    const savedNavigator = navigator;
+    globalThis.navigator = {
+      language: "en-US",
+      languages: ["es-MX", "en-US"]
+    };
+    assert.equal(detectLocale(), "es");
+    globalThis.navigator = savedNavigator;
+  });
+  it("falls back to navigator.language when navigator.languages has no match", () => {
+    const savedNavigator = navigator;
+    globalThis.navigator = {
+      language: "fr-CA",
+      languages: ["en-US"]
+    };
+    assert.equal(detectLocale(), "fr");
+    globalThis.navigator = savedNavigator;
+  });
+});
+describe("loadLocale", () => {
+  it("loads the English locale", async () => {
+    const messages = await loadLocale("en");
+    assert.equal(typeof messages.supportUkraine, "string");
+    assert.ok(messages.supportUkraine.length > 0);
+    assert.equal(typeof messages.allCharities, "string");
+    assert.ok(messages.allCharities.length > 0);
+    assert.equal(typeof messages.charities, "object");
+  });
+  it("loads a non-English locale", async () => {
+    const messages = await loadLocale("es");
+    assert.equal(typeof messages.supportUkraine, "string");
+    assert.ok(messages.supportUkraine.length > 0);
+    assert.equal(typeof messages.charities, "object");
+  });
+  it("falls back to English for unknown locale", async () => {
+    const messages = await loadLocale("zz");
+    assert.equal(messages.supportUkraine, "Support Ukraine");
+  });
+});
+describe("mergeCharities", () => {
+  it("merges locale taglines over base charities", async () => {
+    const messages = await loadLocale("es");
+    const merged = mergeCharities(DEFAULT_CHARITIES, messages);
+    assert.equal(merged.length, DEFAULT_CHARITIES.length);
+    const united24 = merged.find((c) => c.id === "united24");
+    assert.ok(united24);
+    assert.notEqual(united24.tagline, DEFAULT_CHARITIES[0].tagline);
+  });
+  it("keeps English tagline when charity id is missing from locale", async () => {
+    const messages = {
+      supportUkraine: "Test",
+      allCharities: "Test",
+      donate: "Test",
+      charities: {}
+    };
+    const merged = mergeCharities(DEFAULT_CHARITIES, messages);
+    for (const [index, item] of merged.entries()) {
+      assert.equal(item.tagline, DEFAULT_CHARITIES[index].tagline);
+    }
+  });
+});
+describe("isRTL", () => {
+  it("returns true for Arabic", () => {
+    assert.equal(isRTL("ar"), true);
+    assert.equal(isRTL("ar-SA"), true);
+  });
+  it("returns false for LTR locales", () => {
+    assert.equal(isRTL("en"), false);
+    assert.equal(isRTL("es"), false);
+    assert.equal(isRTL("fr"), false);
+    assert.equal(isRTL("zh"), false);
+    assert.equal(isRTL("ja"), false);
+  });
+});
+describe("formatBannerText", () => {
+  it("formats the banner text with charity and messages", async () => {
+    const messages = await loadLocale("en");
+    const charity = DEFAULT_CHARITIES[0];
+    const result = formatBannerText(charity, messages);
+    assert.ok(result.includes(charity.name));
+    assert.ok(result.includes(charity.tagline));
+    assert.ok(result.includes(messages.supportUkraine));
+  });
+});
+describe("supportUkraineBlock", () => {
+  it("is a function", () => {
+    assert.equal(typeof supportUkraineBlock, "function");
+  });
+});
+var MockElement = class {
+  _attrs = /* @__PURE__ */ new Map();
+  _children = [];
+  className = "";
+  href = "";
+  textContent = "";
+  style = { fontSize: "" };
+  append(...items) {
+    this._children.push(...items);
+  }
+  prepend(_item) {
+  }
+  setAttribute(name, value) {
+    this._attrs.set(name, value);
+  }
+  getAttribute(name) {
+    return this._attrs.get(name) ?? "";
+  }
+  get firstChild() {
+    return this._children[0];
+  }
+  get lastChild() {
+    return this._children.at(-1);
+  }
+};
+function setupDom() {
+  if (!globalThis.document) {
+    Object.defineProperty(globalThis, "document", {
+      value: {
+        head: { append() {
+        } },
+        body: { prepend() {
+        } },
+        createElement() {
+          return new MockElement();
+        },
+        querySelector() {
+        }
+      },
+      writable: true,
+      configurable: true
+    });
+  }
+}
+var STORAGE_KEY2 = "support-ukraine-seen";
+var storage = { store: /* @__PURE__ */ new Map() };
+function setupStorage() {
+  storage.store = /* @__PURE__ */ new Map();
+  if (!globalThis.localStorage) {
+    Object.defineProperty(globalThis, "localStorage", {
+      value: {
+        getItem(key) {
+          return storage.store.get(key);
+        },
+        setItem(key, value) {
+          storage.store.set(key, value);
+        },
+        clear() {
+          storage.store.clear();
+        }
+      },
+      writable: true,
+      configurable: true
+    });
+  }
+}
+describe("dontRepeat", () => {
+  before(() => {
+    setupDom();
+    setupStorage();
+  });
+  beforeEach(() => {
+    storage.store.clear();
+  });
+  it("does not touch localStorage when dontRepeat is false", async () => {
+    await supportUkraineBlock({ dontRepeat: false });
+    assert.equal(storage.store.size, 0);
+  });
+  it("writes seen URL to localStorage after mounting", async () => {
+    const banner = await supportUkraineBlock({
+      dontRepeat: true,
+      tags: ["animals"]
+    });
+    const seen = JSON.parse(storage.store.get(STORAGE_KEY2) ?? "[]");
+    assert.equal(seen.length, 1);
+    const link = banner.firstChild;
+    assert.equal(seen[0], link.href);
+  });
+  it("avoids repeating charities across calls", async () => {
+    const seenUrls = /* @__PURE__ */ new Set();
+    for (let index = 0; index < 3; index++) {
+      const banner = await supportUkraineBlock({ tags: ["animals"], dontRepeat: true });
+      const link = banner.firstChild;
+      seenUrls.add(link.href);
+    }
+    assert.equal(seenUrls.size, 3, "all 3 animal charities should appear exactly once");
+  });
+  it("resets after all charities have been seen", async () => {
+    await supportUkraineBlock({ tags: ["animals"], dontRepeat: true });
+    await supportUkraineBlock({ tags: ["animals"], dontRepeat: true });
+    const afterFirstCycle = JSON.parse(storage.store.get(STORAGE_KEY2) ?? "[]");
+    assert.equal(afterFirstCycle.length, 2);
+    const banner = await supportUkraineBlock({ tags: ["animals"], dontRepeat: true });
+    const link = banner.firstChild;
+    const animals = DEFAULT_CHARITIES.filter((c) => c.tags.includes("animals"));
+    assert.ok(animals.some((c) => c.url === link.href));
+  });
+  it("works with tags filter", async () => {
+    const military = DEFAULT_CHARITIES.filter((c) => c.tags.includes("military"));
+    const seenUrls = /* @__PURE__ */ new Set();
+    for (let index = 0; index < military.length; index++) {
+      const banner = await supportUkraineBlock({
+        tags: ["military"],
+        dontRepeat: true
+      });
+      const link = banner.firstChild;
+      seenUrls.add(link.href);
+    }
+    assert.equal(seenUrls.size, military.length);
+    for (const url of seenUrls) {
+      assert.ok(
+        military.some((c) => c.url === url),
+        "only military charities shown"
+      );
+    }
+  });
+  it("treats empty tags array as no filter", async () => {
+    const banner = await supportUkraineBlock({
+      tags: [],
+      dontRepeat: false
+    });
+    const link = banner.firstChild;
+    assert.ok(link.href.length > 0, "should mount a banner with a valid charity");
+  });
+  it("falls back to all charities when tags match nothing", async () => {
+    const banner = await supportUkraineBlock({
+      tags: ["nonexistent"],
+      dontRepeat: false
+    });
+    const link = banner.firstChild;
+    assert.ok(link.href.length > 0, "should mount a banner despite no tag match");
+  });
+});
+describe("i18n integration", () => {
+  before(() => {
+    setupDom();
+    setupStorage();
+  });
+  beforeEach(() => {
+    storage.store.clear();
+  });
+  it("banner uses translated text when locale is specified", async () => {
+    const banner = await supportUkraineBlock({
+      locale: "es",
+      tags: ["animals"],
+      dontRepeat: false
+    });
+    const link = banner.firstChild;
+    const info = link.lastChild;
+    const text = info.textContent;
+    assert.ok(text.length > 0, "banner text should not be empty");
+    const animals = DEFAULT_CHARITIES.filter((c) => c.tags.includes("animals"));
+    assert.ok(
+      animals.some((c) => text.includes(c.name)),
+      "should include a charity name"
+    );
+  });
+  it("banner uses English by default", async () => {
+    const savedNavigator = navigator;
+    delete globalThis.navigator;
+    try {
+      const banner = await supportUkraineBlock({
+        tags: ["animals"],
+        dontRepeat: false
+      });
+      const link = banner.firstChild;
+      const prefix = link.firstChild;
+      const text = prefix.textContent;
+      assert.ok(text.includes("Support Ukraine"), "should contain English text");
+    } finally {
+      globalThis.navigator = savedNavigator;
+    }
+  });
+  it('banner has dir="rtl" for Arabic locale', async () => {
+    const banner = await supportUkraineBlock({
+      locale: "ar",
+      tags: ["animals"],
+      dontRepeat: false
+    });
+    const direction = banner.getAttribute(
+      "dir"
+    );
+    assert.equal(direction, "rtl");
+  });
+  it('banner does not have dir="rtl" for LTR locales', async () => {
+    const banner = await supportUkraineBlock({
+      locale: "en",
+      tags: ["animals"],
+      dontRepeat: false
+    });
+    const direction = banner.getAttribute(
+      "dir"
+    );
+    assert.notEqual(direction, "rtl");
+  });
+  it("allCharities link uses translated text", async () => {
+    const banner = await supportUkraineBlock({
+      locale: "es",
+      tags: ["animals"],
+      dontRepeat: false
+    });
+    const allLink = banner.lastChild;
+    const allText = allLink.firstChild;
+    const text = allText.textContent;
+    assert.ok(text.length > 0, "allCharities text should not be empty");
+    assert.notEqual(text, "All charities", "should be translated");
+  });
+});

package/dist/test/it-2WUTSGIT.js

@@ -0,0 +1,5 @@
+// src/locales/it.yaml
+var it_default = { "supportUkraine": "Sostieni l'Ucraina", "allCharities": "Tutte le associazioni", "donate": "Dona", "charities": { "united24": { "tagline": "Piattaforma ufficiale di raccolta fondi dell'Ucraina" }, "come-back-alive": { "tagline": "A sostegno delle forze armate ucraine dal 2014" }, "razom-for-ukraine": { "tagline": "Interventi di emergenza e aiuti umanitari" }, "ukrainian-red-cross": { "tagline": "Assistenza umanitaria nelle zone di conflitto" }, "nova-ukraine": { "tagline": "Aiuti umanitari e tutela dei diritti" }, "voices-of-children": { "tagline": "Supporto psicologico per i bambini colpiti dalla guerra" }, "prytula-foundation": { "tagline": "Tecnologie di difesa e attrezzature per l'Ucraina" }, "medical-hilfe": { "tagline": "Forniture mediche per gli ospedali ucraini" }, "army-of-drones": { "tagline": "Droni da ricognizione per il fronte" }, "world-central-kitchen": { "tagline": "Pasti freschi per le persone nelle zone di conflitto" }, "cats-of-kyiv": { "tagline": "Rifugio che salva e adotta gatti a Kyiv" }, "uanimals": { "tagline": "Organizzazione di salvataggio animali e tutela dei diritti in Ucraina" }, "hospitallers": { "tagline": "Paramedici volontari ucraini che prestano primo soccorso e evacuazione" }, "sternenko-fund": { "tagline": "Fornitura di droni FPV per le forze di difesa ucraine" }, "life-robots-ukraine": { "tagline": "Robot per lo sminamento dell'Ucraina" }, "sirius-shelter": { "tagline": "Il pi\xF9 grande rifugio animale dell'Ucraina per cani e gatti" } } };
+export {
+  it_default as default
+};

package/dist/test/ja-PRYDFFQ7.js

@@ -0,0 +1,5 @@
+// src/locales/ja.yaml
+var ja_default = { "supportUkraine": "\u30A6\u30AF\u30E9\u30A4\u30CA\u3092\u652F\u63F4\u3059\u308B", "allCharities": "\u3059\u3079\u3066\u306E\u6148\u5584\u56E3\u4F53", "donate": "\u5BC4\u4ED8\u3059\u308B", "charities": { "united24": { "tagline": "\u30A6\u30AF\u30E9\u30A4\u30CA\u306E\u516C\u5F0F fundraising \u30D7\u30E9\u30C3\u30C8\u30D5\u30A9\u30FC\u30E0" }, "come-back-alive": { "tagline": "2014\u5E74\u304B\u3089\u30A6\u30AF\u30E9\u30A4\u30CA\u8ECD\u3092\u652F\u63F4" }, "razom-for-ukraine": { "tagline": "\u7DCA\u6025\u5BFE\u5FDC\u3068\u4EBA\u9053\u652F\u63F4" }, "ukrainian-red-cross": { "tagline": "\u7D1B\u4E89\u5730\u57DF\u3067\u306E\u4EBA\u9053\u652F\u63F4" }, "nova-ukraine": { "tagline": "\u4EBA\u9053\u652F\u63F4\u3068\u5553\u767A\u6D3B\u52D5" }, "voices-of-children": { "tagline": "\u6226\u4E89\u306E\u5F71\u97FF\u3092\u53D7\u3051\u305F\u5150\u7AE5\u3078\u306E\u5FC3\u7406\u652F\u63F4" }, "prytula-foundation": { "tagline": "\u30A6\u30AF\u30E9\u30A4\u30CA\u306E\u9632\u885B\u6280\u8853\u3068\u88C5\u5099" }, "medical-hilfe": { "tagline": "\u30A6\u30AF\u30E9\u30A4\u30CA\u75C5\u9662\u3078\u306E\u533B\u7642\u7269\u8CC7" }, "army-of-drones": { "tagline": "\u524D\u7DDA\u5411\u3051\u5075\u5BDF\u30C9\u30ED\u30FC\u30F3" }, "world-central-kitchen": { "tagline": "\u7D1B\u4E89\u5730\u57DF\u306E\u4EBA\u3005\u3078\u306E\u65B0\u9BAE\u306A\u98DF\u4E8B" }, "cats-of-kyiv": { "tagline": "\u30AD\u30FC\u30A6\u306E\u732B\u3092\u4FDD\u8B77\u30FB\u91CC\u89AA\u63A2\u3057\u3092\u3059\u308B\u30B7\u30A7\u30EB\u30BF\u30FC" }, "uanimals": { "tagline": "\u30A6\u30AF\u30E9\u30A4\u30CA\u306E\u52D5\u7269\u4FDD\u8B77\u3068\u5553\u767A\u56E3\u4F53" }, "hospitallers": { "tagline": "\u5FDC\u6025\u51E6\u7F6E\u3068\u907F\u96E3\u3092\u63D0\u4F9B\u3059\u308B\u30A6\u30AF\u30E9\u30A4\u30CA\u306E\u30DC\u30E9\u30F3\u30C6\u30A3\u30A2\u6551\u6025\u968A" }, "sternenko-fund": { "tagline": "\u30A6\u30AF\u30E9\u30A4\u30CA\u9632\u885B\u90E8\u968A\u3078\u306EFPV\u30C9\u30ED\u30FC\u30F3\u4F9B\u7D66" }, "life-robots-ukraine": { "tagline": "\u30A6\u30AF\u30E9\u30A4\u30CA\u306E\u6A5F\u96F7\u9664\u53BB\u3092\u652F\u3048\u308B\u30ED\u30DC\u30C3\u30C8" }, "sirius-shelter": { "tagline": "\u72AC\u3068\u732B\u306E\u305F\u3081\u306E\u30A6\u30AF\u30E9\u30A4\u30CA\u6700\u5927\u306E\u52D5\u7269\u4FDD\u8B77\u65BD\u8A2D" } } };
+export {
+  ja_default as default
+};