@aglyn/aglyn 1.0.0-beta.220 → 1.0.0-beta.222

package/src/lib/app-utils/site-icon-set.d.ts

@@ -0,0 +1,195 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Every icon a published site serves, derived from the one file its author
+ * uploaded (AGL-3484).
+ *
+ * A site's Favicon and App icon are a single media reference each. A browser
+ * tab draws 16px, iOS a 180px touch icon, an installer anything from 48px to
+ * 512px plus a maskable tile — and every one of them used to download the
+ * original upload, a 512×512 PNG to paint a 16px tab. This module is the
+ * grammar of the derived set: which sizes exist, how each is addressed on the
+ * media CDN, and which `<link>` and manifest entries describe them. The pixels
+ * are drawn by `site-icon-render.ts` in `@aglyn/tenant-data-admin`, behind the
+ * `?icon=` representation of `serveMediaCdn`; the tenant layout, manifest and
+ * `/favicon.ico` route build their URLs here, so the three can never name a
+ * size the renderer does not draw.
+ *
+ * ## Addressing
+ *
+ * A derived icon is the asset's own stable CDN URL plus three parameters:
+ *
+ *  - `icon` — the {@link SiteIconSpec}, e.g. `png-32`, `flat-180`,
+ *    `maskable-512` or `ico`. Only the sizes listed below parse, so the cache
+ *    key space is bounded and nobody can ask the renderer for a 20000px tile.
+ *  - `bg` — the plate color, six hex digits, for the two plates that have one.
+ *  - `v` — the asset's `contentHash`. With it the response is cached for a
+ *    year; a DAM Replace changes the hash, so the next render names a new URL
+ *    and the old one is never asked for again. A stale `v` that does arrive
+ *    redirects to the current one.
+ */
+/** The CDN query parameter that selects a derived icon. */
+export declare const SITE_ICON_PARAM = "icon";
+/** The plate color of a flattened or maskable icon, six hex digits. */
+export declare const SITE_ICON_BACKGROUND_PARAM = "bg";
+/** The asset's `contentHash`, which keys the year-long cache. */
+export declare const SITE_ICON_VERSION_PARAM = "v";
+/** Tab, bookmark and taskbar sizes, as `<link rel="icon" type="image/png">`. */
+export declare const FAVICON_PNG_SIZES: readonly [16, 32, 48];
+/** The images packed into the site's `/favicon.ico`. */
+export declare const FAVICON_ICO_SIZES: readonly [16, 32, 48];
+/** iPhone (180), iPad Pro (167) and iPad (152) home-screen icons. */
+export declare const APPLE_TOUCH_ICON_SIZES: readonly [180, 167, 152];
+/** The manifest's `purpose: "any"` set. */
+export declare const MANIFEST_ICON_SIZES: readonly [48, 72, 96, 128, 144, 152, 192, 256, 384, 512];
+/** The manifest's `purpose: "maskable"` set. */
+export declare const MANIFEST_MASKABLE_ICON_SIZES: readonly [192, 512];
+/**
+ * The diameter of the maskable safe zone, as a fraction of the icon.
+ *
+ * The Web App Manifest spec promises only a centered circle of 40% radius
+ * survives every launcher mask. A mark's box is therefore fitted inside the
+ * square INSCRIBED in that circle — {@link maskableMarkSize} — so even its
+ * corners stay uncropped on a circle mask.
+ */
+export declare const MASKABLE_SAFE_ZONE = 0.8;
+/** The plate of a site with no theme background: white, like the manifest's. */
+export declare const DEFAULT_SITE_ICON_BACKGROUND = "ffffff";
+/**
+ * One derived icon.
+ *
+ *  - `transparent` — the mark center-fit on a transparent square. Favicons
+ *    and the manifest's `any` set.
+ *  - `flat` — the same, flattened onto the theme background. iOS renders
+ *    transparency black, so every apple-touch-icon is one of these.
+ *  - `maskable` — the mark inside the safe zone on the theme background.
+ *  - `ico` — the {@link FAVICON_ICO_SIZES} transparent PNGs in one ICO.
+ */
+export type SiteIconSpec = {
+    plate: 'transparent' | 'flat' | 'maskable';
+    size: number;
+} | {
+    plate: 'ico';
+};
+/** The spec's spelling in the `icon` parameter. */
+export declare function formatSiteIconSpec(spec: SiteIconSpec): string;
+/**
+ * Reads the `icon` parameter back; `null` for anything this module would not
+ * have written — an unknown plate, or a size outside that plate's list.
+ */
+export declare function parseSiteIconSpec(value: unknown): SiteIconSpec | null;
+/** Whether a spec is drawn on the theme background rather than transparency. */
+export declare function siteIconUsesBackground(spec: SiteIconSpec): boolean;
+/** The served type of a derived icon. */
+export declare function siteIconContentType(spec: SiteIconSpec): string;
+/**
+ * The side of the box a maskable icon's mark is fitted into: the square
+ * inscribed in the {@link MASKABLE_SAFE_ZONE} circle, so no launcher mask can
+ * reach any part of it.
+ */
+export declare function maskableMarkSize(size: number): number;
+/**
+ * A theme color as the `bg` parameter carries it: six lowercase hex digits,
+ * or `undefined` for anything that is not a plain color.
+ *
+ * A theme's `background.default` is free CSS text. `#rgb`, `#rrggbb`,
+ * `#rrggbbaa` (alpha dropped — a plate is opaque by definition) and `rgb()` /
+ * `rgba()` are read; a gradient, a `var()` or a named color is not a color
+ * this module can put in a URL, and the caller's default stands in.
+ */
+export declare function normalizeSiteIconBackground(value: unknown): string | undefined;
+/**
+ * What one read of the source asset's media document says, or `null` when it
+ * was not read (a raw URL, or a failed read).
+ */
+export interface SiteIconSourceFacts {
+    /** The upload's MIME type. */
+    contentType?: string;
+    /** The upload's content hash — the cache key a DAM Replace changes. */
+    contentHash?: string;
+}
+/**
+ * Whether the derived set can be drawn from this source.
+ *
+ * Only an asset our CDN serves has a renderer behind it; a hotlinked or raw
+ * storage URL is linked as it is, exactly as before. A known non-image or an
+ * ICO (which `sharp` cannot decode) passes through too. Unknown facts derive
+ * anyway: the renderer redirects to the original for anything it cannot draw,
+ * so a failed read costs a hop, never a broken icon.
+ */
+export declare function siteIconDerivable(src: string | undefined | null, facts?: SiteIconSourceFacts | null): boolean;
+/**
+ * Whether the renderer can draw from an upload of this MIME type: any image
+ * `sharp` decodes, SVG included (it is rasterized at each size).
+ */
+export declare function siteIconSourceTypeDerivable(type: unknown): boolean;
+/** Whether the source is an SVG, which also passes through as `sizes="any"`. */
+export declare function siteIconIsSvg(src: string | undefined | null, facts?: SiteIconSourceFacts | null): boolean;
+/**
+ * The URL of one derived icon of `src`, or `undefined` when `src` is not a
+ * CDN URL and so has no renderer behind it.
+ *
+ * The parameters merge into a query `src` already carries — a signed private
+ * asset's `exp`/`sig` — and their order is fixed, so one icon has one URL and
+ * one cache entry.
+ */
+export declare function siteIconSrc(src: string | undefined | null, spec: SiteIconSpec, options?: {
+    background?: string | null;
+    version?: string | null;
+}): string | undefined;
+/** One `<link>` the layout emits. */
+export interface SiteIconLink {
+    rel: 'icon' | 'apple-touch-icon';
+    href: string;
+    type?: string;
+    sizes?: string;
+}
+/**
+ * The `<link rel="icon">` set for a favicon source.
+ *
+ * Derivable: a PNG per {@link FAVICON_PNG_SIZES}, each with its real `type`
+ * and `sizes`, then the SVG itself as `sizes="any"` when the source is one —
+ * last, so a browser that draws SVG favicons prefers it and one that does not
+ * already has its PNG. Anything else is the single link it always was.
+ */
+export declare function siteFaviconLinks(src: string | undefined | null, facts?: SiteIconSourceFacts | null): SiteIconLink[];
+/**
+ * The `<link rel="apple-touch-icon">` set: each of
+ * {@link APPLE_TOUCH_ICON_SIZES}, flattened onto `background`, or the single
+ * pass-through link for a source with no renderer behind it.
+ */
+export declare function siteAppleTouchIconLinks(src: string | undefined | null, facts?: SiteIconSourceFacts | null, background?: string | null): SiteIconLink[];
+/** One entry of the manifest's `icons`. */
+export interface SiteManifestIcon {
+    src: string;
+    sizes: string;
+    type?: string;
+    purpose: 'any' | 'maskable';
+}
+/**
+ * The manifest's whole `icons` array for one source, which the caller has
+ * already made ABSOLUTE (an installer fetches icons with no page to resolve
+ * against).
+ *
+ * Derivable: every {@link MANIFEST_ICON_SIZES} size as `purpose: "any"`, then
+ * {@link MANIFEST_MASKABLE_ICON_SIZES} as `purpose: "maskable"` on
+ * `background`, then the SVG as `sizes: "any"` when the source is one. Each
+ * `sizes` is a measurement, because the renderer draws exactly that square.
+ * Anything else is the single `sizes: "any"` entry it always was: nothing
+ * measured it, so nothing may claim a pixel size for it (AGL-2204).
+ */
+export declare function siteManifestIcons(src: string | undefined | null, facts?: SiteIconSourceFacts | null, background?: string | null): SiteManifestIcon[];

package/src/lib/app-utils/site-icon-set.js

@@ -0,0 +1,351 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { MEDIA_CDN_SEGMENT } from "./media-cdn-scope.js";
+import { isMediaCdnUrl } from "./media-ref.js";
+/**
+ * Every icon a published site serves, derived from the one file its author
+ * uploaded (AGL-3484).
+ *
+ * A site's Favicon and App icon are a single media reference each. A browser
+ * tab draws 16px, iOS a 180px touch icon, an installer anything from 48px to
+ * 512px plus a maskable tile — and every one of them used to download the
+ * original upload, a 512×512 PNG to paint a 16px tab. This module is the
+ * grammar of the derived set: which sizes exist, how each is addressed on the
+ * media CDN, and which `<link>` and manifest entries describe them. The pixels
+ * are drawn by `site-icon-render.ts` in `@aglyn/tenant-data-admin`, behind the
+ * `?icon=` representation of `serveMediaCdn`; the tenant layout, manifest and
+ * `/favicon.ico` route build their URLs here, so the three can never name a
+ * size the renderer does not draw.
+ *
+ * ## Addressing
+ *
+ * A derived icon is the asset's own stable CDN URL plus three parameters:
+ *
+ *  - `icon` — the {@link SiteIconSpec}, e.g. `png-32`, `flat-180`,
+ *    `maskable-512` or `ico`. Only the sizes listed below parse, so the cache
+ *    key space is bounded and nobody can ask the renderer for a 20000px tile.
+ *  - `bg` — the plate color, six hex digits, for the two plates that have one.
+ *  - `v` — the asset's `contentHash`. With it the response is cached for a
+ *    year; a DAM Replace changes the hash, so the next render names a new URL
+ *    and the old one is never asked for again. A stale `v` that does arrive
+ *    redirects to the current one.
+ */ /** The CDN query parameter that selects a derived icon. */ export const SITE_ICON_PARAM = 'icon';
+/** The plate color of a flattened or maskable icon, six hex digits. */ export const SITE_ICON_BACKGROUND_PARAM = 'bg';
+/** The asset's `contentHash`, which keys the year-long cache. */ export const SITE_ICON_VERSION_PARAM = 'v';
+/** Tab, bookmark and taskbar sizes, as `<link rel="icon" type="image/png">`. */ export const FAVICON_PNG_SIZES = [
+    16,
+    32,
+    48
+];
+/** The images packed into the site's `/favicon.ico`. */ export const FAVICON_ICO_SIZES = [
+    16,
+    32,
+    48
+];
+/** iPhone (180), iPad Pro (167) and iPad (152) home-screen icons. */ export const APPLE_TOUCH_ICON_SIZES = [
+    180,
+    167,
+    152
+];
+/** The manifest's `purpose: "any"` set. */ export const MANIFEST_ICON_SIZES = [
+    48,
+    72,
+    96,
+    128,
+    144,
+    152,
+    192,
+    256,
+    384,
+    512
+];
+/** The manifest's `purpose: "maskable"` set. */ export const MANIFEST_MASKABLE_ICON_SIZES = [
+    192,
+    512
+];
+/**
+ * The diameter of the maskable safe zone, as a fraction of the icon.
+ *
+ * The Web App Manifest spec promises only a centered circle of 40% radius
+ * survives every launcher mask. A mark's box is therefore fitted inside the
+ * square INSCRIBED in that circle — {@link maskableMarkSize} — so even its
+ * corners stay uncropped on a circle mask.
+ */ export const MASKABLE_SAFE_ZONE = 0.8;
+/** The plate of a site with no theme background: white, like the manifest's. */ export const DEFAULT_SITE_ICON_BACKGROUND = 'ffffff';
+const PLATE_SIZES = {
+    transparent: [
+        ...new Set([
+            ...FAVICON_PNG_SIZES,
+            ...MANIFEST_ICON_SIZES
+        ])
+    ],
+    flat: APPLE_TOUCH_ICON_SIZES,
+    maskable: MANIFEST_MASKABLE_ICON_SIZES
+};
+const PLATE_PREFIX = {
+    transparent: 'png',
+    flat: 'flat',
+    maskable: 'maskable'
+};
+/** The spec's spelling in the `icon` parameter. */ export function formatSiteIconSpec(spec) {
+    return spec.plate === 'ico' ? 'ico' : `${PLATE_PREFIX[spec.plate]}-${spec.size}`;
+}
+/**
+ * Reads the `icon` parameter back; `null` for anything this module would not
+ * have written — an unknown plate, or a size outside that plate's list.
+ */ export function parseSiteIconSpec(value) {
+    const raw = Array.isArray(value) ? value[0] : value;
+    if (typeof raw !== 'string') return null;
+    if (raw === 'ico') return {
+        plate: 'ico'
+    };
+    const match = /^(png|flat|maskable)-(\d{1,4})$/.exec(raw);
+    if (!match) return null;
+    const plate = Object.keys(PLATE_PREFIX).find((key)=>PLATE_PREFIX[key] === match[1]);
+    const size = Number(match[2]);
+    if (!plate || !PLATE_SIZES[plate].includes(size)) return null;
+    return {
+        plate,
+        size
+    };
+}
+/** Whether a spec is drawn on the theme background rather than transparency. */ export function siteIconUsesBackground(spec) {
+    return spec.plate === 'flat' || spec.plate === 'maskable';
+}
+/** The served type of a derived icon. */ export function siteIconContentType(spec) {
+    return spec.plate === 'ico' ? 'image/x-icon' : 'image/png';
+}
+/**
+ * The side of the box a maskable icon's mark is fitted into: the square
+ * inscribed in the {@link MASKABLE_SAFE_ZONE} circle, so no launcher mask can
+ * reach any part of it.
+ */ export function maskableMarkSize(size) {
+    return Math.floor(size * MASKABLE_SAFE_ZONE / Math.SQRT2);
+}
+const HEX = /^#?([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+const RGB = /^rgba?\(\s*(\d{1,3})\s*[, ]\s*(\d{1,3})\s*[, ]\s*(\d{1,3})/i;
+/**
+ * A theme color as the `bg` parameter carries it: six lowercase hex digits,
+ * or `undefined` for anything that is not a plain color.
+ *
+ * A theme's `background.default` is free CSS text. `#rgb`, `#rrggbb`,
+ * `#rrggbbaa` (alpha dropped — a plate is opaque by definition) and `rgb()` /
+ * `rgba()` are read; a gradient, a `var()` or a named color is not a color
+ * this module can put in a URL, and the caller's default stands in.
+ */ export function normalizeSiteIconBackground(value) {
+    if (typeof value !== 'string') return undefined;
+    const trimmed = value.trim();
+    const hex = HEX.exec(trimmed);
+    if (hex) {
+        const digits = hex[1].toLowerCase();
+        if (digits.length === 3) {
+            return digits.split('').map((digit)=>digit + digit).join('');
+        }
+        return digits.slice(0, 6);
+    }
+    const rgb = RGB.exec(trimmed);
+    if (rgb) {
+        const channels = rgb.slice(1, 4).map(Number);
+        if (channels.some((channel)=>channel > 255)) return undefined;
+        return channels.map((channel)=>channel.toString(16).padStart(2, '0')).join('');
+    }
+    return undefined;
+}
+/** Types `sharp` cannot decode, which therefore pass through as uploaded. */ const UNDERIVABLE_TYPES = new Set([
+    'image/x-icon',
+    'image/vnd.microsoft.icon'
+]);
+/**
+ * Whether the derived set can be drawn from this source.
+ *
+ * Only an asset our CDN serves has a renderer behind it; a hotlinked or raw
+ * storage URL is linked as it is, exactly as before. A known non-image or an
+ * ICO (which `sharp` cannot decode) passes through too. Unknown facts derive
+ * anyway: the renderer redirects to the original for anything it cannot draw,
+ * so a failed read costs a hop, never a broken icon.
+ */ export function siteIconDerivable(src, facts) {
+    if (!src || !isMediaCdnUrl(src)) return false;
+    const type = facts == null ? void 0 : facts.contentType;
+    return !type || siteIconSourceTypeDerivable(type);
+}
+/**
+ * Whether the renderer can draw from an upload of this MIME type: any image
+ * `sharp` decodes, SVG included (it is rasterized at each size).
+ */ export function siteIconSourceTypeDerivable(type) {
+    return typeof type === 'string' && type.startsWith('image/') && !UNDERIVABLE_TYPES.has(type);
+}
+/** Whether the source is an SVG, which also passes through as `sizes="any"`. */ export function siteIconIsSvg(src, facts) {
+    var _src_split_;
+    if (!src) return false;
+    if (facts == null ? void 0 : facts.contentType) return facts.contentType === 'image/svg+xml';
+    if (isMediaCdnUrl(src)) return false;
+    return /\.svg$/i.test((_src_split_ = src.split(/[?#]/)[0]) != null ? _src_split_ : '');
+}
+/**
+ * The URL of one derived icon of `src`, or `undefined` when `src` is not a
+ * CDN URL and so has no renderer behind it.
+ *
+ * The parameters merge into a query `src` already carries — a signed private
+ * asset's `exp`/`sig` — and their order is fixed, so one icon has one URL and
+ * one cache entry.
+ */ export function siteIconSrc(src, spec, options = {}) {
+    if (!src || !isMediaCdnUrl(src)) return undefined;
+    const params = [
+        [
+            SITE_ICON_PARAM,
+            formatSiteIconSpec(spec)
+        ]
+    ];
+    if (siteIconUsesBackground(spec)) {
+        var _normalizeSiteIconBackground;
+        params.push([
+            SITE_ICON_BACKGROUND_PARAM,
+            (_normalizeSiteIconBackground = normalizeSiteIconBackground(options.background)) != null ? _normalizeSiteIconBackground : DEFAULT_SITE_ICON_BACKGROUND
+        ]);
+    }
+    if (options.version && MEDIA_CDN_SEGMENT.test(options.version)) {
+        params.push([
+            SITE_ICON_VERSION_PARAM,
+            options.version
+        ]);
+    }
+    const query = params.map(([key, value])=>`${key}=${value}`).join('&');
+    return `${src}${src.includes('?') ? '&' : '?'}${query}`;
+}
+const square = (size)=>`${size}x${size}`;
+/**
+ * The `<link rel="icon">` set for a favicon source.
+ *
+ * Derivable: a PNG per {@link FAVICON_PNG_SIZES}, each with its real `type`
+ * and `sizes`, then the SVG itself as `sizes="any"` when the source is one —
+ * last, so a browser that draws SVG favicons prefers it and one that does not
+ * already has its PNG. Anything else is the single link it always was.
+ */ export function siteFaviconLinks(src, facts) {
+    if (!src) return [];
+    const svg = siteIconIsSvg(src, facts);
+    const passThrough = _extends({
+        rel: 'icon',
+        href: src
+    }, svg ? {
+        type: 'image/svg+xml',
+        sizes: 'any'
+    } : {});
+    if (!siteIconDerivable(src, facts)) return [
+        passThrough
+    ];
+    const version = facts == null ? void 0 : facts.contentHash;
+    return [
+        ...FAVICON_PNG_SIZES.map((size)=>{
+            var _siteIconSrc;
+            return {
+                rel: 'icon',
+                href: (_siteIconSrc = siteIconSrc(src, {
+                    plate: 'transparent',
+                    size
+                }, {
+                    version
+                })) != null ? _siteIconSrc : src,
+                type: 'image/png',
+                sizes: square(size)
+            };
+        }),
+        ...svg ? [
+            passThrough
+        ] : []
+    ];
+}
+/**
+ * The `<link rel="apple-touch-icon">` set: each of
+ * {@link APPLE_TOUCH_ICON_SIZES}, flattened onto `background`, or the single
+ * pass-through link for a source with no renderer behind it.
+ */ export function siteAppleTouchIconLinks(src, facts, background) {
+    if (!src) return [];
+    if (!siteIconDerivable(src, facts)) {
+        return [
+            {
+                rel: 'apple-touch-icon',
+                href: src
+            }
+        ];
+    }
+    const version = facts == null ? void 0 : facts.contentHash;
+    return APPLE_TOUCH_ICON_SIZES.map((size)=>{
+        var _siteIconSrc;
+        return {
+            rel: 'apple-touch-icon',
+            href: (_siteIconSrc = siteIconSrc(src, {
+                plate: 'flat',
+                size
+            }, {
+                background,
+                version
+            })) != null ? _siteIconSrc : src,
+            sizes: square(size)
+        };
+    });
+}
+/**
+ * The manifest's whole `icons` array for one source, which the caller has
+ * already made ABSOLUTE (an installer fetches icons with no page to resolve
+ * against).
+ *
+ * Derivable: every {@link MANIFEST_ICON_SIZES} size as `purpose: "any"`, then
+ * {@link MANIFEST_MASKABLE_ICON_SIZES} as `purpose: "maskable"` on
+ * `background`, then the SVG as `sizes: "any"` when the source is one. Each
+ * `sizes` is a measurement, because the renderer draws exactly that square.
+ * Anything else is the single `sizes: "any"` entry it always was: nothing
+ * measured it, so nothing may claim a pixel size for it (AGL-2204).
+ */ export function siteManifestIcons(src, facts, background) {
+    if (!src) return [];
+    const svg = siteIconIsSvg(src, facts);
+    const passThrough = _extends({
+        src,
+        sizes: 'any'
+    }, svg ? {
+        type: 'image/svg+xml'
+    } : {}, {
+        purpose: 'any'
+    });
+    if (!siteIconDerivable(src, facts)) return [
+        passThrough
+    ];
+    const version = facts == null ? void 0 : facts.contentHash;
+    const entry = (plate, size)=>{
+        var _siteIconSrc;
+        return {
+            src: (_siteIconSrc = siteIconSrc(src, {
+                plate,
+                size
+            }, {
+                background,
+                version
+            })) != null ? _siteIconSrc : src,
+            sizes: square(size),
+            type: 'image/png',
+            purpose: plate === 'maskable' ? 'maskable' : 'any'
+        };
+    };
+    return [
+        ...MANIFEST_ICON_SIZES.map((size)=>entry('transparent', size)),
+        ...MANIFEST_MASKABLE_ICON_SIZES.map((size)=>entry('maskable', size)),
+        ...svg ? [
+            passThrough
+        ] : []
+    ];
+}
+
+//# sourceMappingURL=site-icon-set.js.map

package/src/lib/app-utils/site-icon-set.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/site-icon-set.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { MEDIA_CDN_SEGMENT } from './media-cdn-scope'\nimport { isMediaCdnUrl } from './media-ref'\n\n/**\n * Every icon a published site serves, derived from the one file its author\n * uploaded (AGL-3484).\n *\n * A site's Favicon and App icon are a single media reference each. A browser\n * tab draws 16px, iOS a 180px touch icon, an installer anything from 48px to\n * 512px plus a maskable tile — and every one of them used to download the\n * original upload, a 512×512 PNG to paint a 16px tab. This module is the\n * grammar of the derived set: which sizes exist, how each is addressed on the\n * media CDN, and which `<link>` and manifest entries describe them. The pixels\n * are drawn by `site-icon-render.ts` in `@aglyn/tenant-data-admin`, behind the\n * `?icon=` representation of `serveMediaCdn`; the tenant layout, manifest and\n * `/favicon.ico` route build their URLs here, so the three can never name a\n * size the renderer does not draw.\n *\n * ## Addressing\n *\n * A derived icon is the asset's own stable CDN URL plus three parameters:\n *\n *  - `icon` — the {@link SiteIconSpec}, e.g. `png-32`, `flat-180`,\n *    `maskable-512` or `ico`. Only the sizes listed below parse, so the cache\n *    key space is bounded and nobody can ask the renderer for a 20000px tile.\n *  - `bg` — the plate color, six hex digits, for the two plates that have one.\n *  - `v` — the asset's `contentHash`. With it the response is cached for a\n *    year; a DAM Replace changes the hash, so the next render names a new URL\n *    and the old one is never asked for again. A stale `v` that does arrive\n *    redirects to the current one.\n */\n\n/** The CDN query parameter that selects a derived icon. */\nexport const SITE_ICON_PARAM = 'icon'\n/** The plate color of a flattened or maskable icon, six hex digits. */\nexport const SITE_ICON_BACKGROUND_PARAM = 'bg'\n/** The asset's `contentHash`, which keys the year-long cache. */\nexport const SITE_ICON_VERSION_PARAM = 'v'\n\n/** Tab, bookmark and taskbar sizes, as `<link rel=\"icon\" type=\"image/png\">`. */\nexport const FAVICON_PNG_SIZES = [16, 32, 48] as const\n/** The images packed into the site's `/favicon.ico`. */\nexport const FAVICON_ICO_SIZES = [16, 32, 48] as const\n/** iPhone (180), iPad Pro (167) and iPad (152) home-screen icons. */\nexport const APPLE_TOUCH_ICON_SIZES = [180, 167, 152] as const\n/** The manifest's `purpose: \"any\"` set. */\nexport const MANIFEST_ICON_SIZES = [\n  48, 72, 96, 128, 144, 152, 192, 256, 384, 512,\n] as const\n/** The manifest's `purpose: \"maskable\"` set. */\nexport const MANIFEST_MASKABLE_ICON_SIZES = [192, 512] as const\n\n/**\n * The diameter of the maskable safe zone, as a fraction of the icon.\n *\n * The Web App Manifest spec promises only a centered circle of 40% radius\n * survives every launcher mask. A mark's box is therefore fitted inside the\n * square INSCRIBED in that circle — {@link maskableMarkSize} — so even its\n * corners stay uncropped on a circle mask.\n */\nexport const MASKABLE_SAFE_ZONE = 0.8\n\n/** The plate of a site with no theme background: white, like the manifest's. */\nexport const DEFAULT_SITE_ICON_BACKGROUND = 'ffffff'\n\n/**\n * One derived icon.\n *\n *  - `transparent` — the mark center-fit on a transparent square. Favicons\n *    and the manifest's `any` set.\n *  - `flat` — the same, flattened onto the theme background. iOS renders\n *    transparency black, so every apple-touch-icon is one of these.\n *  - `maskable` — the mark inside the safe zone on the theme background.\n *  - `ico` — the {@link FAVICON_ICO_SIZES} transparent PNGs in one ICO.\n */\nexport type SiteIconSpec =\n  | { plate: 'transparent' | 'flat' | 'maskable'; size: number }\n  | { plate: 'ico' }\n\nconst PLATE_SIZES: Record<\n  Exclude<SiteIconSpec['plate'], 'ico'>,\n  readonly number[]\n> = {\n  transparent: [...new Set([...FAVICON_PNG_SIZES, ...MANIFEST_ICON_SIZES])],\n  flat: APPLE_TOUCH_ICON_SIZES,\n  maskable: MANIFEST_MASKABLE_ICON_SIZES,\n}\n\nconst PLATE_PREFIX = {\n  transparent: 'png',\n  flat: 'flat',\n  maskable: 'maskable',\n} as const\n\n/** The spec's spelling in the `icon` parameter. */\nexport function formatSiteIconSpec(spec: SiteIconSpec): string {\n  return spec.plate === 'ico' ? 'ico' : `${PLATE_PREFIX[spec.plate]}-${spec.size}`\n}\n\n/**\n * Reads the `icon` parameter back; `null` for anything this module would not\n * have written — an unknown plate, or a size outside that plate's list.\n */\nexport function parseSiteIconSpec(value: unknown): SiteIconSpec | null {\n  const raw = Array.isArray(value) ? value[0] : value\n  if (typeof raw !== 'string') return null\n  if (raw === 'ico') return { plate: 'ico' }\n  const match = /^(png|flat|maskable)-(\\d{1,4})$/.exec(raw)\n  if (!match) return null\n  const plate = (Object.keys(PLATE_PREFIX) as Array<keyof typeof PLATE_PREFIX>)\n    .find((key) => PLATE_PREFIX[key] === match[1])\n  const size = Number(match[2])\n  if (!plate || !PLATE_SIZES[plate].includes(size)) return null\n  return { plate, size }\n}\n\n/** Whether a spec is drawn on the theme background rather than transparency. */\nexport function siteIconUsesBackground(spec: SiteIconSpec): boolean {\n  return spec.plate === 'flat' || spec.plate === 'maskable'\n}\n\n/** The served type of a derived icon. */\nexport function siteIconContentType(spec: SiteIconSpec): string {\n  return spec.plate === 'ico' ? 'image/x-icon' : 'image/png'\n}\n\n/**\n * The side of the box a maskable icon's mark is fitted into: the square\n * inscribed in the {@link MASKABLE_SAFE_ZONE} circle, so no launcher mask can\n * reach any part of it.\n */\nexport function maskableMarkSize(size: number): number {\n  return Math.floor((size * MASKABLE_SAFE_ZONE) / Math.SQRT2)\n}\n\nconst HEX = /^#?([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i\nconst RGB = /^rgba?\\(\\s*(\\d{1,3})\\s*[, ]\\s*(\\d{1,3})\\s*[, ]\\s*(\\d{1,3})/i\n\n/**\n * A theme color as the `bg` parameter carries it: six lowercase hex digits,\n * or `undefined` for anything that is not a plain color.\n *\n * A theme's `background.default` is free CSS text. `#rgb`, `#rrggbb`,\n * `#rrggbbaa` (alpha dropped — a plate is opaque by definition) and `rgb()` /\n * `rgba()` are read; a gradient, a `var()` or a named color is not a color\n * this module can put in a URL, and the caller's default stands in.\n */\nexport function normalizeSiteIconBackground(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined\n  const trimmed = value.trim()\n  const hex = HEX.exec(trimmed)\n  if (hex) {\n    const digits = hex[1].toLowerCase()\n    if (digits.length === 3) {\n      return digits\n        .split('')\n        .map((digit) => digit + digit)\n        .join('')\n    }\n    return digits.slice(0, 6)\n  }\n  const rgb = RGB.exec(trimmed)\n  if (rgb) {\n    const channels = rgb.slice(1, 4).map(Number)\n    if (channels.some((channel) => channel > 255)) return undefined\n    return channels\n      .map((channel) => channel.toString(16).padStart(2, '0'))\n      .join('')\n  }\n  return undefined\n}\n\n/**\n * What one read of the source asset's media document says, or `null` when it\n * was not read (a raw URL, or a failed read).\n */\nexport interface SiteIconSourceFacts {\n  /** The upload's MIME type. */\n  contentType?: string\n  /** The upload's content hash — the cache key a DAM Replace changes. */\n  contentHash?: string\n}\n\n/** Types `sharp` cannot decode, which therefore pass through as uploaded. */\nconst UNDERIVABLE_TYPES: ReadonlySet<string> = new Set([\n  'image/x-icon',\n  'image/vnd.microsoft.icon',\n])\n\n/**\n * Whether the derived set can be drawn from this source.\n *\n * Only an asset our CDN serves has a renderer behind it; a hotlinked or raw\n * storage URL is linked as it is, exactly as before. A known non-image or an\n * ICO (which `sharp` cannot decode) passes through too. Unknown facts derive\n * anyway: the renderer redirects to the original for anything it cannot draw,\n * so a failed read costs a hop, never a broken icon.\n */\nexport function siteIconDerivable(\n  src: string | undefined | null,\n  facts?: SiteIconSourceFacts | null,\n): boolean {\n  if (!src || !isMediaCdnUrl(src)) return false\n  const type = facts?.contentType\n  return !type || siteIconSourceTypeDerivable(type)\n}\n\n/**\n * Whether the renderer can draw from an upload of this MIME type: any image\n * `sharp` decodes, SVG included (it is rasterized at each size).\n */\nexport function siteIconSourceTypeDerivable(type: unknown): boolean {\n  return (\n    typeof type === 'string' &&\n    type.startsWith('image/') &&\n    !UNDERIVABLE_TYPES.has(type)\n  )\n}\n\n/** Whether the source is an SVG, which also passes through as `sizes=\"any\"`. */\nexport function siteIconIsSvg(\n  src: string | undefined | null,\n  facts?: SiteIconSourceFacts | null,\n): boolean {\n  if (!src) return false\n  if (facts?.contentType) return facts.contentType === 'image/svg+xml'\n  if (isMediaCdnUrl(src)) return false\n  return /\\.svg$/i.test(src.split(/[?#]/)[0] ?? '')\n}\n\n/**\n * The URL of one derived icon of `src`, or `undefined` when `src` is not a\n * CDN URL and so has no renderer behind it.\n *\n * The parameters merge into a query `src` already carries — a signed private\n * asset's `exp`/`sig` — and their order is fixed, so one icon has one URL and\n * one cache entry.\n */\nexport function siteIconSrc(\n  src: string | undefined | null,\n  spec: SiteIconSpec,\n  options: { background?: string | null; version?: string | null } = {},\n): string | undefined {\n  if (!src || !isMediaCdnUrl(src)) return undefined\n  const params: Array<[string, string]> = [\n    [SITE_ICON_PARAM, formatSiteIconSpec(spec)],\n  ]\n  if (siteIconUsesBackground(spec)) {\n    params.push([\n      SITE_ICON_BACKGROUND_PARAM,\n      normalizeSiteIconBackground(options.background) ??\n        DEFAULT_SITE_ICON_BACKGROUND,\n    ])\n  }\n  if (options.version && MEDIA_CDN_SEGMENT.test(options.version)) {\n    params.push([SITE_ICON_VERSION_PARAM, options.version])\n  }\n  const query = params.map(([key, value]) => `${key}=${value}`).join('&')\n  return `${src}${src.includes('?') ? '&' : '?'}${query}`\n}\n\n/** One `<link>` the layout emits. */\nexport interface SiteIconLink {\n  rel: 'icon' | 'apple-touch-icon'\n  href: string\n  type?: string\n  sizes?: string\n}\n\nconst square = (size: number) => `${size}x${size}`\n\n/**\n * The `<link rel=\"icon\">` set for a favicon source.\n *\n * Derivable: a PNG per {@link FAVICON_PNG_SIZES}, each with its real `type`\n * and `sizes`, then the SVG itself as `sizes=\"any\"` when the source is one —\n * last, so a browser that draws SVG favicons prefers it and one that does not\n * already has its PNG. Anything else is the single link it always was.\n */\nexport function siteFaviconLinks(\n  src: string | undefined | null,\n  facts?: SiteIconSourceFacts | null,\n): SiteIconLink[] {\n  if (!src) return []\n  const svg = siteIconIsSvg(src, facts)\n  const passThrough: SiteIconLink = {\n    rel: 'icon',\n    href: src,\n    ...(svg ? { type: 'image/svg+xml', sizes: 'any' } : {}),\n  }\n  if (!siteIconDerivable(src, facts)) return [passThrough]\n  const version = facts?.contentHash\n  return [\n    ...FAVICON_PNG_SIZES.map((size) => ({\n      rel: 'icon' as const,\n      href: siteIconSrc(src, { plate: 'transparent', size }, { version }) ?? src,\n      type: 'image/png',\n      sizes: square(size),\n    })),\n    ...(svg ? [passThrough] : []),\n  ]\n}\n\n/**\n * The `<link rel=\"apple-touch-icon\">` set: each of\n * {@link APPLE_TOUCH_ICON_SIZES}, flattened onto `background`, or the single\n * pass-through link for a source with no renderer behind it.\n */\nexport function siteAppleTouchIconLinks(\n  src: string | undefined | null,\n  facts?: SiteIconSourceFacts | null,\n  background?: string | null,\n): SiteIconLink[] {\n  if (!src) return []\n  if (!siteIconDerivable(src, facts)) {\n    return [{ rel: 'apple-touch-icon', href: src }]\n  }\n  const version = facts?.contentHash\n  return APPLE_TOUCH_ICON_SIZES.map((size) => ({\n    rel: 'apple-touch-icon' as const,\n    href:\n      siteIconSrc(src, { plate: 'flat', size }, { background, version }) ?? src,\n    sizes: square(size),\n  }))\n}\n\n/** One entry of the manifest's `icons`. */\nexport interface SiteManifestIcon {\n  src: string\n  sizes: string\n  type?: string\n  purpose: 'any' | 'maskable'\n}\n\n/**\n * The manifest's whole `icons` array for one source, which the caller has\n * already made ABSOLUTE (an installer fetches icons with no page to resolve\n * against).\n *\n * Derivable: every {@link MANIFEST_ICON_SIZES} size as `purpose: \"any\"`, then\n * {@link MANIFEST_MASKABLE_ICON_SIZES} as `purpose: \"maskable\"` on\n * `background`, then the SVG as `sizes: \"any\"` when the source is one. Each\n * `sizes` is a measurement, because the renderer draws exactly that square.\n * Anything else is the single `sizes: \"any\"` entry it always was: nothing\n * measured it, so nothing may claim a pixel size for it (AGL-2204).\n */\nexport function siteManifestIcons(\n  src: string | undefined | null,\n  facts?: SiteIconSourceFacts | null,\n  background?: string | null,\n): SiteManifestIcon[] {\n  if (!src) return []\n  const svg = siteIconIsSvg(src, facts)\n  const passThrough: SiteManifestIcon = {\n    src,\n    sizes: 'any',\n    ...(svg ? { type: 'image/svg+xml' } : {}),\n    purpose: 'any',\n  }\n  if (!siteIconDerivable(src, facts)) return [passThrough]\n  const version = facts?.contentHash\n  const entry = (\n    plate: 'transparent' | 'maskable',\n    size: number,\n  ): SiteManifestIcon => ({\n    src: siteIconSrc(src, { plate, size }, { background, version }) ?? src,\n    sizes: square(size),\n    type: 'image/png',\n    purpose: plate === 'maskable' ? 'maskable' : 'any',\n  })\n  return [\n    ...MANIFEST_ICON_SIZES.map((size) => entry('transparent', size)),\n    ...MANIFEST_MASKABLE_ICON_SIZES.map((size) => entry('maskable', size)),\n    ...(svg ? [passThrough] : []),\n  ]\n}\n"],"names":["MEDIA_CDN_SEGMENT","isMediaCdnUrl","SITE_ICON_PARAM","SITE_ICON_BACKGROUND_PARAM","SITE_ICON_VERSION_PARAM","FAVICON_PNG_SIZES","FAVICON_ICO_SIZES","APPLE_TOUCH_ICON_SIZES","MANIFEST_ICON_SIZES","MANIFEST_MASKABLE_ICON_SIZES","MASKABLE_SAFE_ZONE","DEFAULT_SITE_ICON_BACKGROUND","PLATE_SIZES","transparent","Set","flat","maskable","PLATE_PREFIX","formatSiteIconSpec","spec","plate","size","parseSiteIconSpec","value","raw","Array","isArray","match","exec","Object","keys","find","key","Number","includes","siteIconUsesBackground","siteIconContentType","maskableMarkSize","Math","floor","SQRT2","HEX","RGB","normalizeSiteIconBackground","undefined","trimmed","trim","hex","digits","toLowerCase","length","split","map","digit","join","slice","rgb","channels","some","channel","toString","padStart","UNDERIVABLE_TYPES","siteIconDerivable","src","facts","type","contentType","siteIconSourceTypeDerivable","startsWith","has","siteIconIsSvg","test","siteIconSrc","options","params","push","background","version","query","square","siteFaviconLinks","svg","passThrough","rel","href","sizes","contentHash","siteAppleTouchIconLinks","siteManifestIcons","purpose","entry"],"mappings":"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"}