favicon-env 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { E as EnvFaviconOptions, a as EnvRule, b as EnvTint } from './ssr-CI5GvAY9.js';
+export { A as AutoOptions, B as Badge, c as BadgeCorner, d as BadgeTextFn, e as EnvConfig, R as RuleBadge, f as faviconDataUri, s as svgToDataUri, t as tintSvg } from './ssr-CI5GvAY9.js';
+
+/**
+ * Return the tint of the first `rule` whose `match` matches `url`, or `null` if
+ * none do. A `RegExp` `match` is tested against `url.host` and its captures are
+ * interpolated into `badge.text` (`$1`, `$<name>`); a function `match` receives
+ * the `URL`. Exposed so the same rules can drive server-side rendering from a
+ * request URL — pair the result with `favicon-env/ssr`'s `faviconDataUri`.
+ */
+declare function matchRules(rules: EnvRule[], url: URL): EnvTint | null;
+/**
+ * Tint / decorate the page favicon for the current environment. Resolves a tint
+ * from `rules` (URL match) → `auto` → `environments`/`detect`, then reads the
+ * existing `<link rel="icon">` (or a per-env `src` / `options.source`), redraws
+ * it on a `<canvas>` with the hue / filter / badge, and swaps in the result as a
+ * PNG data URL.
+ *
+ * A no-op during SSR (no `document`) or when nothing resolves. Works with any
+ * favicon format (svg / png / ico). A custom `src` with no recolour or badge is
+ * swapped in directly, skipping the canvas — which avoids cross-origin taint and
+ * keeps vector sources sharp. If a canvas source is cross-origin without CORS
+ * headers the canvas is tainted and the favicon is left untouched.
+ *
+ * @returns a promise that resolves once the swap has been attempted.
+ */
+declare function envFavicon(options?: EnvFaviconOptions): Promise<void>;
+
+/**
+ * Default environment heuristic, based on `location.hostname`:
+ *
+ * - `localhost`, `127.0.0.1`, `::1`, `*.local`, `*.localhost`, a raw IPv4 → `'dev'`
+ * - a `staging` / `stg` / `qa` / `uat` / `preview` / `preprod` / `test` / `dev`
+ *   segment anywhere in the host → `'staging'`
+ * - anything else → `'prod'`
+ *
+ * It's intentionally simple. Pass your own `detect` to `envFavicon` when your
+ * hostnames don't follow these conventions.
+ *
+ * @param hostname override the host to classify (defaults to `location.hostname`)
+ */
+declare function defaultDetect(hostname?: string): string;
+
+/**
+ * Deterministic hue (0–359) derived from a string via FNV-1a. Stable across
+ * loads and well distributed, so distinct inputs (e.g. `location.host` values)
+ * get distinct colours. Powers `envFavicon`'s auto mode.
+ *
+ * @param input  the string to hash (e.g. `location.host`)
+ * @param offset extra degrees added to the result, to shift the whole palette
+ */
+declare function hashHue(input: string, offset?: number): number;
+
+export { EnvFaviconOptions, EnvRule, EnvTint, defaultDetect, envFavicon, hashHue, matchRules };

package/dist/index.js

@@ -0,0 +1,229 @@
+import { normalizeBadge, cssFilter, DEFAULT_BADGE_COLOR, badgeText, placeBadge, contrastColor } from './chunk-NRMMGQRU.js';
+export { faviconDataUri, svgToDataUri, tintSvg } from './chunk-NRMMGQRU.js';
+
+// src/detect.ts
+function defaultDetect(hostname = typeof location === "undefined" ? "" : location.hostname) {
+  const h = hostname.toLowerCase();
+  if (h === "localhost" || h === "127.0.0.1" || h === "::1" || h === "[::1]" || h.endsWith(".local") || h.endsWith(".localhost") || /^\d{1,3}(?:\.\d{1,3}){3}$/.test(h)) {
+    return "dev";
+  }
+  if (/(?:^|[.-])(?:staging|stg|qa|uat|preview|preprod|test|dev)(?:[.-]|$)/.test(h)) {
+    return "staging";
+  }
+  return "prod";
+}
+
+// src/hash.ts
+function hashHue(input, offset = 0) {
+  let h = 2166136261;
+  for (let i = 0; i < input.length; i += 1) {
+    h ^= input.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return ((h >>> 0) % 360 + offset % 360 + 360) % 360;
+}
+
+// src/tint.ts
+var ICON_LINK = 'link[rel~="icon"]';
+var originalSource;
+function currentIconHref() {
+  const links = document.querySelectorAll(ICON_LINK);
+  const last = links.item(links.length - 1);
+  return last?.href || void 0;
+}
+function interpolate(template, match) {
+  return template.replace(
+    /\$(?:(\d+)|<([^>]+)>)/g,
+    (_full, index, name) => name == null ? match[Number(index)] ?? "" : match.groups?.[name] ?? ""
+  );
+}
+function resolveRuleBadge(badge, match, url) {
+  if (typeof badge === "string") return { color: badge };
+  const { text, ...rest } = badge;
+  let resolved;
+  if (typeof text === "function") resolved = text(match, url);
+  else if (typeof text === "string" && match) resolved = interpolate(text, match);
+  else resolved = text;
+  return { ...rest, text: resolved };
+}
+function ruleToTint(rule, match, url) {
+  const tint = {};
+  if (rule.hue != null) tint.hue = rule.hue;
+  if (rule.filter) tint.filter = rule.filter;
+  if (rule.src) tint.src = rule.src;
+  if (rule.badge != null) tint.badge = resolveRuleBadge(rule.badge, match, url);
+  return tint;
+}
+function matchRules(rules, url) {
+  for (const rule of rules) {
+    if (typeof rule.match === "function") {
+      if (rule.match(url)) return ruleToTint(rule, null, url);
+    } else {
+      const m = url.host.match(rule.match);
+      if (m) return ruleToTint(rule, m, url);
+    }
+  }
+  return null;
+}
+function resolveTint(options) {
+  const url = typeof location === "undefined" ? null : new URL(location.href);
+  if (options.rules && url) {
+    const matched = matchRules(options.rules, url);
+    if (matched) return matched;
+  }
+  if (options.auto) {
+    const offset = typeof options.auto === "object" ? options.auto.offset ?? 0 : 0;
+    return { hue: hashHue(url?.host ?? "", offset) };
+  }
+  const env = (options.detect ?? defaultDetect)();
+  const tint = env ? options.environments?.[env] : void 0;
+  return tint || null;
+}
+function inferType(src) {
+  if (src.startsWith("data:")) return /^data:([^;,]+)/.exec(src)?.[1];
+  if (/\.svg(?:[?#]|$)/i.test(src)) return "image/svg+xml";
+  if (/\.png(?:[?#]|$)/i.test(src)) return "image/png";
+  if (/\.ico(?:[?#]|$)/i.test(src)) return "image/x-icon";
+  return void 0;
+}
+function applyFavicon(href, type) {
+  document.querySelectorAll(ICON_LINK).forEach((link2) => link2.remove());
+  const link = document.createElement("link");
+  link.rel = "icon";
+  if (type) link.type = type;
+  link.href = href;
+  link.dataset.faviconEnv = "";
+  document.head.append(link);
+}
+function contrastText(ctx, background) {
+  ctx.fillStyle = background;
+  return contrastColor(ctx.fillStyle);
+}
+function traceRoundRect(ctx, x, y, w, h, r) {
+  const rr = Math.min(r, w / 2, h / 2);
+  ctx.beginPath();
+  ctx.moveTo(x + rr, y);
+  ctx.arcTo(x + w, y, x + w, y + h, rr);
+  ctx.arcTo(x + w, y + h, x, y + h, rr);
+  ctx.arcTo(x, y + h, x, y, rr);
+  ctx.arcTo(x, y, x + w, y, rr);
+  ctx.closePath();
+}
+function drawBadge(ctx, size, badge) {
+  const color = badge.color ?? DEFAULT_BADGE_COLOR;
+  const text = badgeText(badge);
+  const family = 'system-ui, -apple-system, "Segoe UI", sans-serif';
+  if (badge.shape === "cover") {
+    traceRoundRect(ctx, 0, 0, size, size, Math.round(size * 0.2));
+    ctx.fillStyle = color;
+    ctx.fill();
+    if (text) {
+      const maxWidth2 = size * 0.84;
+      let fontSize2 = Math.round(size * 0.62);
+      ctx.font = `700 ${fontSize2}px ${family}`;
+      const textWidth = ctx.measureText(text).width;
+      if (textWidth > maxWidth2) {
+        fontSize2 = Math.max(7, Math.floor(fontSize2 * (maxWidth2 / textWidth)));
+        ctx.font = `700 ${fontSize2}px ${family}`;
+      }
+      ctx.fillStyle = badge.textColor ?? contrastText(ctx, color);
+      ctx.textAlign = "center";
+      ctx.textBaseline = "middle";
+      ctx.fillText(text, size / 2, size / 2);
+    }
+    return;
+  }
+  const corner = badge.corner ?? "bottom-right";
+  const h = Math.round(size * (badge.size ?? 0.5));
+  const margin = Math.round(size * 0.02);
+  const maxWidth = size - margin * 2;
+  const pad = Math.round(h * 0.5);
+  let fontSize = Math.round(h * 0.66);
+  ctx.font = `700 ${fontSize}px ${family}`;
+  let w = text ? Math.max(h, Math.ceil(ctx.measureText(text).width) + pad) : h;
+  if (w > maxWidth) {
+    fontSize = Math.max(7, Math.floor(fontSize * (maxWidth / w)));
+    ctx.font = `700 ${fontSize}px ${family}`;
+    w = Math.min(maxWidth, Math.max(h, Math.ceil(ctx.measureText(text).width) + pad));
+  }
+  const [px, py] = placeBadge(corner, size, size, w, h, margin);
+  const x = Math.round(px);
+  const y = Math.round(py);
+  const radius = text ? Math.min(h / 2, size * 0.24) : h / 2;
+  traceRoundRect(ctx, x, y, w, h, radius);
+  ctx.fillStyle = color;
+  ctx.fill();
+  ctx.lineWidth = Math.max(1, size * 0.03);
+  ctx.strokeStyle = "rgba(0, 0, 0, 0.35)";
+  ctx.stroke();
+  if (text) {
+    ctx.fillStyle = badge.textColor ?? contrastText(ctx, color);
+    ctx.textAlign = "center";
+    ctx.textBaseline = "middle";
+    ctx.fillText(text, x + w / 2, y + h / 2);
+  }
+}
+function envFavicon(options = {}) {
+  if (typeof document === "undefined" || typeof HTMLCanvasElement === "undefined") {
+    return Promise.resolve();
+  }
+  const tint = resolveTint(options);
+  if (!tint) return Promise.resolve();
+  const badge = tint.badge != null ? normalizeBadge(tint.badge) : void 0;
+  const size = options.size ?? 64;
+  const cover = badge?.shape === "cover";
+  const alpha = badge?.opacity ?? 1;
+  if (cover && alpha >= 1) {
+    const canvas = document.createElement("canvas");
+    canvas.width = size;
+    canvas.height = size;
+    const ctx = canvas.getContext("2d");
+    if (ctx) {
+      drawBadge(ctx, size, badge);
+      applyFavicon(canvas.toDataURL("image/png"), "image/png");
+    }
+    return Promise.resolve();
+  }
+  const needsCanvas = tint.hue != null || Boolean(tint.filter) || Boolean(badge);
+  if (!needsCanvas) {
+    if (tint.src) applyFavicon(tint.src, inferType(tint.src));
+    return Promise.resolve();
+  }
+  originalSource ?? (originalSource = currentIconHref());
+  const source = tint.src ?? options.source ?? originalSource ?? "/favicon.ico";
+  return new Promise((resolve) => {
+    const img = new Image();
+    img.crossOrigin = "anonymous";
+    img.decoding = "async";
+    img.addEventListener("error", () => resolve());
+    img.addEventListener("load", () => {
+      try {
+        const canvas = document.createElement("canvas");
+        canvas.width = size;
+        canvas.height = size;
+        const ctx = canvas.getContext("2d");
+        if (ctx) {
+          if (!cover) {
+            const filter = cssFilter(tint);
+            if (filter) ctx.filter = filter;
+          }
+          ctx.drawImage(img, 0, 0, size, size);
+          ctx.filter = "none";
+          if (badge) {
+            ctx.globalAlpha = alpha;
+            drawBadge(ctx, size, badge);
+            ctx.globalAlpha = 1;
+          }
+          applyFavicon(canvas.toDataURL("image/png"), "image/png");
+        }
+      } catch {
+      }
+      resolve();
+    });
+    img.src = source;
+  });
+}
+
+export { defaultDetect, envFavicon, hashHue, matchRules };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/detect.ts","../src/hash.ts","../src/tint.ts"],"names":["link","maxWidth","fontSize"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Default environment heuristic, based on `location.hostname`:\n *\n * - `localhost`, `127.0.0.1`, `::1`, `*.local`, `*.localhost`, a raw IPv4 → `'dev'`\n * - a `staging` / `stg` / `qa` / `uat` / `preview` / `preprod` / `test` / `dev`\n *   segment anywhere in the host → `'staging'`\n * - anything else → `'prod'`\n *\n * It's intentionally simple. Pass your own `detect` to `envFavicon` when your\n * hostnames don't follow these conventions.\n *\n * @param hostname override the host to classify (defaults to `location.hostname`)\n */\nexport function defaultDetect(\n  hostname: string = typeof location === 'undefined' ? '' : location.hostname,\n): string {\n  const h = hostname.toLowerCase();\n  if (\n    h === 'localhost' ||\n    h === '127.0.0.1' ||\n    h === '::1' ||\n    h === '[::1]' ||\n    h.endsWith('.local') ||\n    h.endsWith('.localhost') ||\n    /^\\d{1,3}(?:\\.\\d{1,3}){3}$/.test(h)\n  ) {\n    return 'dev';\n  }\n  if (/(?:^|[.-])(?:staging|stg|qa|uat|preview|preprod|test|dev)(?:[.-]|$)/.test(h)) {\n    return 'staging';\n  }\n  return 'prod';\n}\n","/**\n * Deterministic hue (0–359) derived from a string via FNV-1a. Stable across\n * loads and well distributed, so distinct inputs (e.g. `location.host` values)\n * get distinct colours. Powers `envFavicon`'s auto mode.\n *\n * @param input  the string to hash (e.g. `location.host`)\n * @param offset extra degrees added to the result, to shift the whole palette\n */\nexport function hashHue(input: string, offset = 0): number {\n  let h = 0x811c9dc5;\n  for (let i = 0; i < input.length; i += 1) {\n    h ^= input.charCodeAt(i);\n    h = Math.imul(h, 0x01000193);\n  }\n  return (((h >>> 0) % 360) + (offset % 360) + 360) % 360;\n}\n","import { badgeText, DEFAULT_BADGE_COLOR, normalizeBadge, placeBadge } from './badge';\nimport { contrastColor } from './color';\nimport { defaultDetect } from './detect';\nimport { cssFilter } from './filter';\nimport { hashHue } from './hash';\nimport type { Badge, EnvFaviconOptions, EnvRule, EnvTint, RuleBadge } from './types';\n\n/** Selector for the favicon `<link>`(s) we read from and replace. */\nconst ICON_LINK = 'link[rel~=\"icon\"]';\n\n/** Remembered original favicon href, so repeat calls don't tint an already-tinted icon. */\nlet originalSource: string | undefined;\n\nfunction currentIconHref(): string | undefined {\n  const links = document.querySelectorAll<HTMLLinkElement>(ICON_LINK);\n  const last = links.item(links.length - 1);\n  return last?.href || undefined;\n}\n\n/** Fill `$1` / `$<name>` placeholders in a template from a regex match. */\nfunction interpolate(template: string, match: RegExpMatchArray): string {\n  return template.replace(/\\$(?:(\\d+)|<([^>]+)>)/g, (_full, index, name) =>\n    name == null ? (match[Number(index)] ?? '') : (match.groups?.[name] ?? ''),\n  );\n}\n\nfunction resolveRuleBadge(\n  badge: string | RuleBadge,\n  match: RegExpMatchArray | null,\n  url: URL,\n): Badge {\n  if (typeof badge === 'string') return { color: badge };\n  const { text, ...rest } = badge;\n  let resolved: string | number | undefined;\n  if (typeof text === 'function') resolved = text(match, url);\n  else if (typeof text === 'string' && match) resolved = interpolate(text, match);\n  else resolved = text;\n  return { ...rest, text: resolved };\n}\n\nfunction ruleToTint(rule: EnvRule, match: RegExpMatchArray | null, url: URL): EnvTint {\n  const tint: EnvTint = {};\n  if (rule.hue != null) tint.hue = rule.hue;\n  if (rule.filter) tint.filter = rule.filter;\n  if (rule.src) tint.src = rule.src;\n  if (rule.badge != null) tint.badge = resolveRuleBadge(rule.badge, match, url);\n  return tint;\n}\n\n/**\n * Return the tint of the first `rule` whose `match` matches `url`, or `null` if\n * none do. A `RegExp` `match` is tested against `url.host` and its captures are\n * interpolated into `badge.text` (`$1`, `$<name>`); a function `match` receives\n * the `URL`. Exposed so the same rules can drive server-side rendering from a\n * request URL — pair the result with `favicon-env/ssr`'s `faviconDataUri`.\n */\nexport function matchRules(rules: EnvRule[], url: URL): EnvTint | null {\n  for (const rule of rules) {\n    if (typeof rule.match === 'function') {\n      if (rule.match(url)) return ruleToTint(rule, null, url);\n    } else {\n      const m = url.host.match(rule.match);\n      if (m) return ruleToTint(rule, m, url);\n    }\n  }\n  return null;\n}\n\nfunction resolveTint(options: EnvFaviconOptions): EnvTint | null {\n  const url = typeof location === 'undefined' ? null : new URL(location.href);\n  if (options.rules && url) {\n    const matched = matchRules(options.rules, url);\n    if (matched) return matched;\n  }\n  if (options.auto) {\n    const offset = typeof options.auto === 'object' ? (options.auto.offset ?? 0) : 0;\n    return { hue: hashHue(url?.host ?? '', offset) };\n  }\n  const env = (options.detect ?? defaultDetect)();\n  const tint = env ? options.environments?.[env] : undefined;\n  return tint || null;\n}\n\nfunction inferType(src: string): string | undefined {\n  if (src.startsWith('data:')) return /^data:([^;,]+)/.exec(src)?.[1];\n  if (/\\.svg(?:[?#]|$)/i.test(src)) return 'image/svg+xml';\n  if (/\\.png(?:[?#]|$)/i.test(src)) return 'image/png';\n  if (/\\.ico(?:[?#]|$)/i.test(src)) return 'image/x-icon';\n  return undefined;\n}\n\nfunction applyFavicon(href: string, type?: string): void {\n  document.querySelectorAll(ICON_LINK).forEach((link) => link.remove());\n  const link = document.createElement('link');\n  link.rel = 'icon';\n  if (type) link.type = type;\n  link.href = href;\n  link.dataset.faviconEnv = '';\n  document.head.append(link);\n}\n\nfunction contrastText(ctx: CanvasRenderingContext2D, background: string): string {\n  ctx.fillStyle = background; // canvas normalises any CSS colour to #rrggbb / rgba(…)\n  return contrastColor(ctx.fillStyle);\n}\n\nfunction traceRoundRect(\n  ctx: CanvasRenderingContext2D,\n  x: number,\n  y: number,\n  w: number,\n  h: number,\n  r: number,\n): void {\n  const rr = Math.min(r, w / 2, h / 2);\n  ctx.beginPath();\n  ctx.moveTo(x + rr, y);\n  ctx.arcTo(x + w, y, x + w, y + h, rr);\n  ctx.arcTo(x + w, y + h, x, y + h, rr);\n  ctx.arcTo(x, y + h, x, y, rr);\n  ctx.arcTo(x, y, x + w, y, rr);\n  ctx.closePath();\n}\n\nfunction drawBadge(ctx: CanvasRenderingContext2D, size: number, badge: Badge): void {\n  const color = badge.color ?? DEFAULT_BADGE_COLOR;\n  const text = badgeText(badge);\n  const family = 'system-ui, -apple-system, \"Segoe UI\", sans-serif';\n\n  // `shape: 'cover'` fills the whole icon and centres the number as big as it fits.\n  if (badge.shape === 'cover') {\n    traceRoundRect(ctx, 0, 0, size, size, Math.round(size * 0.2));\n    ctx.fillStyle = color;\n    ctx.fill();\n    if (text) {\n      const maxWidth = size * 0.84;\n      let fontSize = Math.round(size * 0.62);\n      ctx.font = `700 ${fontSize}px ${family}`;\n      const textWidth = ctx.measureText(text).width;\n      if (textWidth > maxWidth) {\n        fontSize = Math.max(7, Math.floor(fontSize * (maxWidth / textWidth)));\n        ctx.font = `700 ${fontSize}px ${family}`;\n      }\n      ctx.fillStyle = badge.textColor ?? contrastText(ctx, color);\n      ctx.textAlign = 'center';\n      ctx.textBaseline = 'middle';\n      ctx.fillText(text, size / 2, size / 2);\n    }\n    return;\n  }\n\n  const corner = badge.corner ?? 'bottom-right';\n  const h = Math.round(size * (badge.size ?? 0.5));\n  const margin = Math.round(size * 0.02);\n  const maxWidth = size - margin * 2;\n  const pad = Math.round(h * 0.5);\n  // A dot / short label sits in a pill that widens (then the font shrinks) to fit\n  // longer text. Bump badge.size + corner:'center' to make a number dominate.\n  let fontSize = Math.round(h * 0.66);\n  ctx.font = `700 ${fontSize}px ${family}`;\n  let w = text ? Math.max(h, Math.ceil(ctx.measureText(text).width) + pad) : h;\n  if (w > maxWidth) {\n    fontSize = Math.max(7, Math.floor(fontSize * (maxWidth / w)));\n    ctx.font = `700 ${fontSize}px ${family}`;\n    w = Math.min(maxWidth, Math.max(h, Math.ceil(ctx.measureText(text).width) + pad));\n  }\n  const [px, py] = placeBadge(corner, size, size, w, h, margin);\n  const x = Math.round(px);\n  const y = Math.round(py);\n  const radius = text ? Math.min(h / 2, size * 0.24) : h / 2;\n\n  traceRoundRect(ctx, x, y, w, h, radius);\n  ctx.fillStyle = color;\n  ctx.fill();\n  ctx.lineWidth = Math.max(1, size * 0.03);\n  ctx.strokeStyle = 'rgba(0, 0, 0, 0.35)';\n  ctx.stroke();\n\n  if (text) {\n    ctx.fillStyle = badge.textColor ?? contrastText(ctx, color);\n    ctx.textAlign = 'center';\n    ctx.textBaseline = 'middle';\n    ctx.fillText(text, x + w / 2, y + h / 2);\n  }\n}\n\n/**\n * Tint / decorate the page favicon for the current environment. Resolves a tint\n * from `rules` (URL match) → `auto` → `environments`/`detect`, then reads the\n * existing `<link rel=\"icon\">` (or a per-env `src` / `options.source`), redraws\n * it on a `<canvas>` with the hue / filter / badge, and swaps in the result as a\n * PNG data URL.\n *\n * A no-op during SSR (no `document`) or when nothing resolves. Works with any\n * favicon format (svg / png / ico). A custom `src` with no recolour or badge is\n * swapped in directly, skipping the canvas — which avoids cross-origin taint and\n * keeps vector sources sharp. If a canvas source is cross-origin without CORS\n * headers the canvas is tainted and the favicon is left untouched.\n *\n * @returns a promise that resolves once the swap has been attempted.\n */\nexport function envFavicon(options: EnvFaviconOptions = {}): Promise<void> {\n  if (typeof document === 'undefined' || typeof HTMLCanvasElement === 'undefined') {\n    return Promise.resolve();\n  }\n  const tint = resolveTint(options);\n  if (!tint) return Promise.resolve();\n\n  const badge = tint.badge != null ? normalizeBadge(tint.badge) : undefined;\n  const size = options.size ?? 64;\n  const cover = badge?.shape === 'cover';\n  const alpha = badge?.opacity ?? 1;\n\n  // An opaque `cover` replaces the icon entirely — no base image needed, so draw\n  // it synchronously. A translucent cover falls through to composite over the base.\n  if (cover && alpha >= 1) {\n    const canvas = document.createElement('canvas');\n    canvas.width = size;\n    canvas.height = size;\n    const ctx = canvas.getContext('2d');\n    if (ctx) {\n      drawBadge(ctx, size, badge);\n      applyFavicon(canvas.toDataURL('image/png'), 'image/png');\n    }\n    return Promise.resolve();\n  }\n\n  // Plain image swap: a custom `src` with nothing to composite skips the canvas.\n  const needsCanvas = tint.hue != null || Boolean(tint.filter) || Boolean(badge);\n  if (!needsCanvas) {\n    if (tint.src) applyFavicon(tint.src, inferType(tint.src));\n    return Promise.resolve();\n  }\n\n  originalSource ??= currentIconHref();\n  const source = tint.src ?? options.source ?? originalSource ?? '/favicon.ico';\n\n  return new Promise<void>((resolve) => {\n    const img = new Image();\n    img.crossOrigin = 'anonymous';\n    img.decoding = 'async';\n    img.addEventListener('error', () => resolve());\n    img.addEventListener('load', () => {\n      try {\n        const canvas = document.createElement('canvas');\n        canvas.width = size;\n        canvas.height = size;\n        const ctx = canvas.getContext('2d');\n        if (ctx) {\n          // `cover` ignores the hue/filter (it's replacing the icon); a plain tint\n          // applies it to the base. The base is always drawn here — a translucent\n          // cover shows it through.\n          if (!cover) {\n            const filter = cssFilter(tint);\n            if (filter) ctx.filter = filter;\n          }\n          ctx.drawImage(img, 0, 0, size, size);\n          ctx.filter = 'none';\n          if (badge) {\n            ctx.globalAlpha = alpha;\n            drawBadge(ctx, size, badge);\n            ctx.globalAlpha = 1;\n          }\n          applyFavicon(canvas.toDataURL('image/png'), 'image/png');\n        }\n      } catch {\n        // Tainted canvas (cross-origin source without CORS headers) or an\n        // unsupported API — leave the existing favicon in place.\n      }\n      resolve();\n    });\n    img.src = source;\n  });\n}\n"]}

package/dist/ssr-CI5GvAY9.d.ts

@@ -0,0 +1,122 @@
+/** A tint / decoration to apply to the favicon for a given environment. */
+interface EnvTint {
+    /** Hue rotation in degrees applied to the whole icon (e.g. `120`). */
+    hue?: number;
+    /**
+     * Explicit CSS filter string, e.g. `'hue-rotate(120deg) saturate(1.4)'`.
+     * Takes precedence over `hue` when both are set.
+     */
+    filter?: string;
+    /**
+     * Use this image URL (or data URI) as the base for this environment, instead
+     * of the page's current favicon — e.g. a different logo for staging. Any
+     * `hue` / `filter` / `badge` is composited on top of it.
+     */
+    src?: string;
+    /**
+     * A corner badge. A `string` is shorthand for a dot of that colour; an object
+     * (`Badge`) can also carry `text`, such as a PR number, rendered as a pill.
+     */
+    badge?: string | Badge;
+}
+/** A badge drawn on top of the icon. */
+interface Badge {
+    /** Text to render, e.g. a PR number (`344`, `'#344'`). Omit for a plain dot. */
+    text?: string | number;
+    /** Background colour. Default `'#ef4444'`. */
+    color?: string;
+    /** Text colour. Default: auto — black or white, whichever contrasts with `color`. */
+    textColor?: string;
+    /**
+     * `'pill'` (default) draws a rounded badge on top of your icon, placed by
+     * `corner` / `size`. `'cover'` replaces the whole icon with the colour + a big
+     * centred number — nothing of the base shows through, so it reads at 16px.
+     */
+    shape?: 'pill' | 'cover';
+    /** Where a pill sits. Default `'bottom-right'`; `'center'` overlays the icon. */
+    corner?: BadgeCorner;
+    /** Pill height as a fraction of the icon (0–1). Default `0.5`. (Ignored by `'cover'`.) */
+    size?: number;
+    /** Badge opacity, 0–1 (default `1`). With `shape: 'cover'`, below `1` lets the icon show through. */
+    opacity?: number;
+}
+type BadgeCorner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+/** Per-environment config. `false` / `null` / omitted leaves the favicon untouched. */
+type EnvConfig = EnvTint | false | null | undefined;
+/** Computes badge text from a regex match (if any) and the current URL. */
+type BadgeTextFn = (match: RegExpMatchArray | null, url: URL) => string | number;
+/**
+ * A `Badge` for use in a `rule`, whose `text` may additionally be a function, or
+ * a template with `$1` / `$<name>` placeholders filled from the rule's regex
+ * captures — e.g. `'#$1'` against `/^pr-(\d+)\./`.
+ */
+type RuleBadge = Omit<Badge, 'text'> & {
+    text?: string | number | BadgeTextFn;
+};
+/**
+ * A URL-matching rule. When `match` matches, this rule's tint is applied (and no
+ * later rule is tried). Rules are checked in order, before `auto` and
+ * `environments`/`detect`.
+ */
+type EnvRule = Omit<EnvTint, 'badge'> & {
+    /**
+     * A `RegExp` (tested against `location.host`, i.e. `hostname:port`) or a
+     * function receiving the full `URL`. Regex captures feed `badge.text`.
+     */
+    match: RegExp | ((url: URL) => boolean);
+    /** Badge whose `text` may be a `$1` / `$<name>` template or a function of the match. */
+    badge?: string | RuleBadge;
+};
+/** Options for `envFavicon`. */
+interface EnvFaviconOptions {
+    /** Map of environment name → tint. A missing entry (or `false`) means "leave as-is". */
+    environments?: Record<string, EnvConfig>;
+    /**
+     * URL-matching rules, checked in order before `auto` / `environments`. The
+     * first rule whose `match` matches wins, and its regex captures can be
+     * interpolated into `badge.text` (e.g. a PR number). Great for preview deploys.
+     */
+    rules?: EnvRule[];
+    /**
+     * Return the current environment name (a key of `environments`). Defaults to
+     * `defaultDetect`, a `location.hostname` heuristic.
+     */
+    detect?: () => string | undefined;
+    /**
+     * Auto mode: ignore `environments` and derive a *stable, unique* hue from
+     * `location.host`, so every origin/port gets its own colour with no config.
+     * Pass an `AutoOptions` object to tune it.
+     */
+    auto?: boolean | AutoOptions;
+    /** Favicon source URL. Defaults to the page's current icon, then `/favicon.ico`. */
+    source?: string;
+    /** Canvas raster size in px. Default `64`. */
+    size?: number;
+}
+/** Tuning for `EnvFaviconOptions.auto`. */
+interface AutoOptions {
+    /** Extra hue offset (deg) added to the derived hue — shifts the whole palette. */
+    offset?: number;
+}
+
+/**
+ * Return `svg` (an SVG *string*) with the environment's tint and/or badge baked
+ * in — the form that survives being rendered as an `<img>` / favicon, with no
+ * first-paint flash. The tint is a CSS `filter` on a wrapping group; the badge
+ * is an appended `<g>` positioned via the SVG's `viewBox` (a badge is skipped if
+ * no `viewBox` or `width`/`height` can be read).
+ *
+ * Returns the SVG unchanged when `tint` is falsy, has nothing to apply, or the
+ * input isn't a recognisable `<svg>…</svg>` document.
+ */
+declare function tintSvg(svg: string, tint: EnvConfig): string;
+/** Percent-encode an SVG string as a `data:` URI suitable for a favicon `href`. */
+declare function svgToDataUri(svg: string): string;
+/**
+ * Convenience: `tintSvg` + `svgToDataUri`. Give it your favicon SVG and the
+ * config for the current build's environment; get back a ready-to-use
+ * `<link rel="icon" href="…">` value with no first-paint flash.
+ */
+declare function faviconDataUri(svg: string, tint: EnvConfig): string;
+
+export { type AutoOptions as A, type Badge as B, type EnvFaviconOptions as E, type RuleBadge as R, type EnvRule as a, type EnvTint as b, type BadgeCorner as c, type BadgeTextFn as d, type EnvConfig as e, faviconDataUri as f, svgToDataUri as s, tintSvg as t };

package/dist/ssr.d.ts

@@ -0,0 +1 @@
+export { f as faviconDataUri, s as svgToDataUri, t as tintSvg } from './ssr-CI5GvAY9.js';

package/dist/ssr.js

@@ -0,0 +1,3 @@
+export { faviconDataUri, svgToDataUri, tintSvg } from './chunk-NRMMGQRU.js';
+//# sourceMappingURL=ssr.js.map
+//# sourceMappingURL=ssr.js.map

package/dist/ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ssr.js"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "favicon-env",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Tint your favicon per environment (dev/staging/prod) so you can tell instances apart at a glance. Runtime canvas mode + build-time SVG mode. Zero dependencies.",
+  "license": "MIT",
+  "author": "Amir Abushanab",
+  "keywords": [
+    "favicon",
+    "environment",
+    "env",
+    "dev",
+    "staging",
+    "hue",
+    "tint",
+    "canvas",
+    "developer-experience",
+    "dx",
+    "tanstack-intent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amir-abushanab/favicon-env.git"
+  },
+  "homepage": "https://github.com/amir-abushanab/favicon-env#readme",
+  "bugs": "https://github.com/amir-abushanab/favicon-env/issues",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./ssr": {
+      "types": "./dist/ssr.d.ts",
+      "import": "./dist/ssr.js"
+    },
+    "./global": "./dist/favicon-env.global.js"
+  },
+  "unpkg": "./dist/favicon-env.global.js",
+  "jsdelivr": "./dist/favicon-env.global.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "skills",
+    "!skills/_artifacts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm check"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.0",
+    "@tanstack/intent": "^0.3.5",
+    "dependency-cruiser": "^18.0.0",
+    "knip": "^6.24.0",
+    "oxfmt": "^0.57.0",
+    "oxlint": "^1.72.0",
+    "publint": "^0.3.21",
+    "simple-git-hooks": "^2.13.1",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "node scripts/serve.mjs --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint src",
+    "format": "oxfmt src",
+    "knip": "knip",
+    "depcruise": "depcruise src",
+    "check": "oxfmt --check src && oxlint src && knip && depcruise src",
+    "publint": "publint --strict",
+    "intent:validate": "intent validate skills",
+    "pretest": "pnpm build",
+    "test": "node --test",
+    "ncu": "pnpm dlx npm-check-updates",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
+  }
+}