gazetta 0.5.0 → 0.7.0

package/dist/themes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.d.ts","sourceRoot":"","sources":["../src/themes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG5D,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;CAChB;AAQD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMnD;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,IAAI,CA8B3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,cAAc,GAAG,IAAI,CAGrH"}

package/dist/themes.js

@@ -0,0 +1,85 @@
+import { isValidLocale } from './locale.js';
+/**
+ * Theme name pattern: lowercase ASCII letters, digits, hyphens, underscores.
+ * No dots (collide with filename composition), no whitespace, non-empty.
+ */
+const THEME_PATTERN = /^[a-z][a-z0-9_-]*$/;
+/**
+ * Validate a theme name as it would appear in storage / filenames.
+ *
+ * Strict on input — does NOT normalize. Mixed case, leading dots, etc.
+ * fail. Callers that want lenient parsing should `normalizeTheme` first
+ * and then check.
+ *
+ * Rejects:
+ *   - empty / whitespace
+ *   - dots (would collide with filename suffix scheme)
+ *   - any uppercase character (filenames must be normalized to lowercase
+ *     before reaching storage; uppercase reaching this validator is a bug)
+ *   - BCP 47 locale codes (would be ambiguous in filename composition —
+ *     `hero.asset.en.json` could be locale `en` or theme `en`)
+ */
+export function isValidTheme(theme) {
+    if (!THEME_PATTERN.test(theme))
+        return false;
+    // Theme names must not collide with valid BCP 47 locale codes.
+    // `en`, `fr`, `pt-br`, etc. are reserved for the locale dimension.
+    if (isValidLocale(theme))
+        return false;
+    return true;
+}
+/** Normalize a theme name to lowercase for filenames. */
+export function normalizeTheme(theme) {
+    return theme.toLowerCase();
+}
+/**
+ * Resolve theme settings from a site manifest. Throws when the config is
+ * present but invalid (collision with locale codes, malformed names) so
+ * misconfiguration surfaces at boot rather than silently at render time.
+ *
+ * Returns `null` when `themes` is unset — that's the "no theme dimension
+ * for this site" signal. Asset overrides keyed by theme are rejected
+ * downstream when this is null.
+ */
+export function resolveSiteThemes(site) {
+    const config = site.themes;
+    if (!config)
+        return null;
+    if (!Array.isArray(config.supported) || config.supported.length === 0) {
+        throw new Error('themes.supported must be a non-empty array of theme names');
+    }
+    const supported = [];
+    for (const raw of config.supported) {
+        const norm = normalizeTheme(raw);
+        if (!isValidTheme(norm)) {
+            throw new Error(`Invalid theme name "${raw}". Must be lowercase ASCII (a-z, 0-9, -, _), ` +
+                `start with a letter, and not collide with BCP 47 locale codes.`);
+        }
+        if (supported.includes(norm)) {
+            throw new Error(`Duplicate theme name "${norm}" in themes.supported`);
+        }
+        supported.push(norm);
+    }
+    const defaultRaw = config.default ?? supported[0];
+    const defaultTheme = normalizeTheme(defaultRaw);
+    if (!supported.includes(defaultTheme)) {
+        throw new Error(`themes.default "${config.default}" is not in themes.supported [${supported.join(', ')}]`);
+    }
+    return { supported, default: defaultTheme };
+}
+/**
+ * Subset themes to a config — used when a target overrides the site's theme
+ * set. Falls back to the site's resolved themes when the target doesn't
+ * narrow.
+ *
+ * v1 doesn't expose target-level theme override (assets are global to the
+ * site's theme set). The function is here for symmetry with locale
+ * resolution and future-proofs the API when targets may want to ship a
+ * subset (e.g. a target that only serves light mode).
+ */
+export function resolveTargetThemes(siteThemes, override) {
+    if (override)
+        return resolveSiteThemes({ name: '', themes: override });
+    return siteThemes;
+}
+//# sourceMappingURL=themes.js.map

package/dist/themes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themes.js","sourceRoot":"","sources":["../src/themes.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAU3C;;;GAGG;AACH,MAAM,aAAa,GAAG,oBAAoB,CAAA;AAE1C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC5C,+DAA+D;IAC/D,mEAAmE;IACnE,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,OAAO,IAAI,CAAA;AACb,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,WAAW,EAAE,CAAA;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAkB;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC1B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAExB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IAED,MAAM,SAAS,GAAa,EAAE,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,uBAAuB,GAAG,+CAA+C;gBACvE,gEAAgE,CACnE,CAAA;QACH,CAAC;QACD,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,uBAAuB,CAAC,CAAA;QACvE,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,CAAE,CAAA;IAClD,MAAM,YAAY,GAAG,cAAc,CAAC,UAAU,CAAC,CAAA;IAC/C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,OAAO,iCAAiC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC5G,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;AAC7C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAiC,EAAE,QAAuB;IAC5F,IAAI,QAAQ;QAAE,OAAO,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAkB,CAAC,CAAA;IACtF,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/transforms/adapter.d.ts

@@ -0,0 +1,115 @@
+/**
+ * TransformAdapter — delivery strategy for asset bytes.
+ *
+ * Per Q8 lock, an adapter owns three coupled concerns:
+ *   1. URL composition for the primary asset URL and srcset (where
+ *      different from the origin's pre-generated ladder)
+ *   2. Cache policy for the URLs it produces (since cache semantics
+ *      depend on whether bytes are origin-served vs CDN-served)
+ *   3. Optional server-side route mounting for adapters that mediate
+ *      delivery (e.g. proxy adapters that route through our origin)
+ *
+ * # Why all three on one interface
+ *
+ * URL + cache + delivery are coupled. The hardcoded
+ * `Cache-Control: immutable` in the serve-route was correct for the
+ * sharp adapter but wrong for any adapter that signs URLs with a
+ * short-TTL HMAC (future imgproxy) or routes through a CDN with its
+ * own cache (cloudflare). Co-locating the policy with the URL builder
+ * keeps the contract honest.
+ *
+ * # Why mountRoutes is optional
+ *
+ * Origin-passthrough (sharp) and CDN adapters (cloudflare) don't need
+ * server-side routes — the existing `assets/serve-route.ts` handles
+ * origin bytes; the CDN handles its own. Future proxy adapters
+ * (imgproxy, signed-URL workers) would implement `mountRoutes` to
+ * add their own handlers.
+ *
+ * # Why required (not optional) in the resolver context
+ *
+ * Adapter is always present. Resolver code paths don't branch on
+ * "does an adapter exist" — the factory at boot constructs one
+ * (defaulting to `sharpAdapter`), and every URL goes through it.
+ * Eliminates the conditional URL construction throughout the resolver.
+ */
+import type { Hono } from 'hono';
+import type { Selector } from '../schema/dimensions.js';
+import type { AssetVariant } from '../schema/types.js';
+/**
+ * Input for adapter URL builders. Carries everything an adapter could
+ * possibly need; concrete adapters pick what they use. The sharp
+ * adapter reads `variants` for srcset; the cloudflare adapter reads
+ * `width`/`height` to skip upscaling but ignores `variants`.
+ */
+export interface AssetUrlInput {
+    /** Asset name (the canonical identifier). */
+    name: string;
+    /** 8-char SHA-256 prefix of the bytes. For locale-bytes overrides this is the override's hash. */
+    hash: string;
+    /** File extension without the dot (e.g., 'jpg'). */
+    ext: string;
+    /** Selector identifying which override these bytes are (null = default). */
+    selector: Selector | null;
+    /** Optional site URL — absolute prefix for cross-origin delivery. */
+    siteUrl?: string;
+    /** Pre-generated variants from the manifest. Adapters that ignore this (cloudflare) don't read it. */
+    variants: readonly AssetVariant[];
+    /** Source width in pixels. Null for non-images. */
+    width: number | null;
+    /** Source height in pixels. Null for non-images. */
+    height: number | null;
+}
+/**
+ * Cache headers an adapter dictates for the URLs it produced. The
+ * asset-serve route applies these when serving origin bytes; CDN
+ * adapters return the same policy for documentation (the CDN owns
+ * actual caching, but the origin response still carries headers
+ * because the CDN re-emits or honors them depending on config).
+ */
+export interface CachePolicy {
+    /** `Cache-Control` header value. */
+    cacheControl: string;
+    /** Optional `Vary` header (theme/locale-aware delivery, format negotiation). */
+    vary?: string;
+}
+/**
+ * Delivery strategy for asset bytes. Per-target — wired into the
+ * resolver context at boot via the `transforms` factory.
+ */
+export interface TransformAdapter {
+    /** Stable identifier — used in telemetry, logs, and adapter selection. */
+    readonly name: string;
+    /**
+     * Build the primary URL for an asset's bytes-of-record. This is the
+     * URL that goes into `<img src>`, `<a href>`, or `@font-face src`.
+     */
+    primaryUrl(input: AssetUrlInput): string;
+    /**
+     * Build a `srcset` string for responsive image delivery, OR return
+     * null when responsive delivery isn't supported (non-image assets,
+     * or images with no variant ladder).
+     *
+     * Adapter decides ladder semantics:
+     *   - sharp adapter reads `input.variants` (pre-generated at upload)
+     *   - cloudflare adapter generates ladder from a width set the
+     *     adapter chooses (typically 400/800/1200/1600)
+     */
+    srcset(input: AssetUrlInput): string | null;
+    /**
+     * Cache policy for a URL this adapter produced. Returned headers
+     * are applied by whichever serving layer handles the URL — origin
+     * route for origin-served adapters, propagated to CDN config for
+     * upstream adapters.
+     */
+    cachePolicy(input: AssetUrlInput): CachePolicy;
+    /**
+     * Mount adapter-specific server-side routes. Called once per app
+     * construction by the bootstrap. Origin-passthrough adapters
+     * (sharp) and pure CDN adapters (cloudflare) leave this undefined;
+     * mediating adapters (future imgproxy, signed URL workers)
+     * implement it.
+     */
+    mountRoutes?(app: Hono): void;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/transforms/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/transforms/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,4EAA4E;IAC5E,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IACzB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sGAAsG;IACtG,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IACjC,mDAAmD;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,oDAAoD;IACpD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAA;IAExC;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAAA;IAE3C;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CAAA;IAE9C;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAA;CAC9B"}

package/dist/transforms/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/transforms/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/transforms/adapter.ts"],"names":[],"mappings":""}

package/dist/transforms/cloudflare.d.ts

@@ -0,0 +1,17 @@
+import type { TransformAdapter } from './adapter.js';
+export interface CloudflareAdapterOptions {
+    /**
+     * The zone (hostname) where `/cdn-cgi/image/` is served. Typically
+     * the same hostname as `siteUrl`. Required — without it we can't
+     * compose a CDN URL.
+     */
+    zone: string;
+}
+/**
+ * Build a Cloudflare-Images-flavored TransformAdapter for the given zone.
+ * Factory function (not a singleton) because the zone is per-target —
+ * sites with multiple Cloudflare zones get one adapter instance per
+ * configured target.
+ */
+export declare function createCloudflareAdapter(opts: CloudflareAdapterOptions): TransformAdapter;
+//# sourceMappingURL=cloudflare.d.ts.map

package/dist/transforms/cloudflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../src/transforms/cloudflare.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAA8B,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAYhF,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG,gBAAgB,CAgCxF"}

package/dist/transforms/cloudflare.js

@@ -0,0 +1,110 @@
+/**
+ * Cloudflare Images transform adapter.
+ *
+ * Routes URLs through Cloudflare's `/cdn-cgi/image/` endpoint at the
+ * configured zone. Cloudflare fetches the origin URL (the asset bytes
+ * served from the target's storage), applies the requested transforms
+ * (resize, format conversion, quality), and returns the transformed
+ * bytes to the browser.
+ *
+ * URL shape:
+ *   https://{zone}/cdn-cgi/image/{params}/{originUrl}
+ *
+ * Where params is a comma-separated list (e.g. `format=auto,width=800`).
+ * For the primary URL we use `format=auto` only — Cloudflare picks the
+ * best supported format (AVIF, WebP, JPEG) per the browser's Accept
+ * header. For srcset entries we add `width={W}` per ladder rung.
+ *
+ * # Why a fixed ladder
+ *
+ * Sharp generates 400/800/1200/1600 widths at upload. Cloudflare can
+ * generate any width on the fly, but srcset still needs a concrete
+ * ladder for the browser to pick from. We use the same widths as the
+ * sharp adapter — consistent visual delivery between targets that
+ * happen to use different adapters.
+ *
+ * # Why `Vary: Accept`
+ *
+ * `format=auto` returns AVIF or WebP per browser support. Caches MUST
+ * vary on `Accept` to avoid serving an AVIF response to a WebP-only
+ * browser. The cache policy carries that header.
+ *
+ * # What this adapter ignores
+ *
+ * `input.variants` — Cloudflare generates widths on demand; the
+ * pre-generated ladder is irrelevant. Sites that use Cloudflare can
+ * still upload variants (they cost nothing on egress, just a tiny bit
+ * of storage), but the URLs the browser receives won't reference them.
+ */
+import { buildAssetUrl } from '../assets/url.js';
+/** Widths the srcset ladder generates. Same as sharp's `VARIANT_WIDTHS`. */
+const LADDER_WIDTHS = [400, 800, 1200, 1600];
+const CDN_CACHE_POLICY = {
+    cacheControl: 'public, max-age=31536000, immutable',
+    // Cloudflare's `format=auto` returns different bytes per Accept header;
+    // caches must vary or they'll serve AVIF to WebP-only clients.
+    vary: 'Accept',
+};
+/**
+ * Build a Cloudflare-Images-flavored TransformAdapter for the given zone.
+ * Factory function (not a singleton) because the zone is per-target —
+ * sites with multiple Cloudflare zones get one adapter instance per
+ * configured target.
+ */
+export function createCloudflareAdapter(opts) {
+    if (!opts.zone || typeof opts.zone !== 'string') {
+        throw new Error('cloudflareAdapter requires a `zone` (e.g. "cdn.example.com")');
+    }
+    const zone = opts.zone.replace(/^https?:\/\//, '').replace(/\/+$/, '');
+    return {
+        name: 'cloudflare',
+        primaryUrl(input) {
+            const origin = absoluteOriginUrl(input);
+            // Primary URL uses format=auto only — no width; the browser gets
+            // the source-resolution version (within Cloudflare's max).
+            return `https://${zone}/cdn-cgi/image/format=auto/${origin}`;
+        },
+        srcset(input) {
+            // No srcset for non-images — same skip rule as sharp adapter.
+            // We detect by extension; future kinds can refine this.
+            if (!isImageExt(input.ext))
+                return null;
+            // Skip widths larger than the source image (no point upscaling).
+            const sourceWidth = input.width ?? Infinity;
+            const widths = LADDER_WIDTHS.filter(w => w <= sourceWidth);
+            if (widths.length === 0)
+                return null;
+            const origin = absoluteOriginUrl(input);
+            return widths.map(w => `https://${zone}/cdn-cgi/image/format=auto,width=${w}/${origin} ${w}w`).join(', ');
+        },
+        cachePolicy(_input) {
+            return CDN_CACHE_POLICY;
+        },
+    };
+}
+/**
+ * Compose the absolute origin URL for the asset bytes — the URL
+ * Cloudflare fetches from. Always absolute because Cloudflare's
+ * `/cdn-cgi/image/` endpoint requires it. When `siteUrl` isn't set
+ * the adapter can't function — origin URLs need to be reachable
+ * from Cloudflare's edge.
+ */
+function absoluteOriginUrl(input) {
+    if (!input.siteUrl) {
+        throw new Error(`cloudflareAdapter requires siteUrl on the resolve context — Cloudflare needs an absolute origin URL to fetch.`);
+    }
+    // Use buildAssetUrl for path composition (handles selector suffix);
+    // it returns the full URL when siteUrl is set.
+    return buildAssetUrl({
+        name: input.name,
+        hash: input.hash,
+        ext: input.ext,
+        siteUrl: input.siteUrl,
+        selector: input.selector,
+    });
+}
+/** Whether the extension is one Cloudflare can transform. */
+function isImageExt(ext) {
+    return ext === 'jpg' || ext === 'jpeg' || ext === 'png' || ext === 'webp' || ext === 'avif' || ext === 'gif';
+}
+//# sourceMappingURL=cloudflare.js.map

package/dist/transforms/cloudflare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.js","sourceRoot":"","sources":["../../src/transforms/cloudflare.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhD,4EAA4E;AAC5E,MAAM,aAAa,GAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAE/D,MAAM,gBAAgB,GAAgB;IACpC,YAAY,EAAE,qCAAqC;IACnD,wEAAwE;IACxE,+DAA+D;IAC/D,IAAI,EAAE,QAAQ;CACf,CAAA;AAWD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA8B;IACpE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;IACjF,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAEtE,OAAO;QACL,IAAI,EAAE,YAAY;QAElB,UAAU,CAAC,KAAoB;YAC7B,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;YACvC,iEAAiE;YACjE,2DAA2D;YAC3D,OAAO,WAAW,IAAI,8BAA8B,MAAM,EAAE,CAAA;QAC9D,CAAC;QAED,MAAM,CAAC,KAAoB;YACzB,8DAA8D;YAC9D,wDAAwD;YACxD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAA;YACvC,iEAAiE;YACjE,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,IAAI,QAAQ,CAAA;YAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,CAAA;YAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAA;YACpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;YACvC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,IAAI,oCAAoC,CAAC,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3G,CAAC;QAED,WAAW,CAAC,MAAqB;YAC/B,OAAO,gBAAgB,CAAA;QACzB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,KAAoB;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,+GAA+G,CAChH,CAAA;IACH,CAAC;IACD,oEAAoE;IACpE,+CAA+C;IAC/C,OAAO,aAAa,CAAC;QACnB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAA;AACJ,CAAC;AAED,6DAA6D;AAC7D,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,KAAK,CAAA;AAC9G,CAAC"}

package/dist/transforms/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Transform-adapter factory.
+ *
+ * One switch over `target.transforms?.adapter`, the only place that
+ * knows adapter names. Adding a new adapter is one new module + one
+ * case here — no edits to resolver, walker, kind resolvers, or
+ * serve-route.
+ *
+ * Default (no `transforms` config) = `sharpAdapter`. This matches the
+ * pre-step-18 hardcoded behavior — sites that don't opt into a CDN
+ * adapter get the same URLs and cache headers they had before.
+ */
+import type { TargetConfig } from '../types.js';
+import type { TransformAdapter } from './adapter.js';
+/**
+ * Construct a `TransformAdapter` from a target's config. Throws on
+ * unknown adapter names so misconfiguration surfaces at boot, not
+ * silently at render time.
+ */
+export declare function buildTransformAdapter(target: TargetConfig): TransformAdapter;
+export type { AssetUrlInput, CachePolicy, TransformAdapter } from './adapter.js';
+export { sharpAdapter } from './sharp.js';
+export { createCloudflareAdapter, type CloudflareAdapterOptions } from './cloudflare.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transforms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAIpD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CAkB5E;AAGD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/transforms/index.js

@@ -0,0 +1,30 @@
+import { sharpAdapter } from './sharp.js';
+import { createCloudflareAdapter } from './cloudflare.js';
+/**
+ * Construct a `TransformAdapter` from a target's config. Throws on
+ * unknown adapter names so misconfiguration surfaces at boot, not
+ * silently at render time.
+ */
+export function buildTransformAdapter(target) {
+    const config = target.transforms;
+    if (!config || config.adapter === 'sharp')
+        return sharpAdapter;
+    switch (config.adapter) {
+        case 'cloudflare': {
+            if (!config.zone) {
+                throw new Error('transforms.adapter "cloudflare" requires a `zone` field (e.g. "cdn.example.com")');
+            }
+            return createCloudflareAdapter({ zone: config.zone });
+        }
+        default: {
+            // Exhaustive check — TypeScript ensures we don't miss a known adapter.
+            // Runtime fallthrough is for when site.yaml carries an adapter name
+            // this build doesn't know.
+            const unknown = config.adapter;
+            throw new Error(`Unknown transforms.adapter "${unknown}". Supported: sharp, cloudflare.`);
+        }
+    }
+}
+export { sharpAdapter } from './sharp.js';
+export { createCloudflareAdapter } from './cloudflare.js';
+//# sourceMappingURL=index.js.map

package/dist/transforms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAEzD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAA;IAChC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO;QAAE,OAAO,YAAY,CAAA;IAC9D,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAA;YACrG,CAAC;YACD,OAAO,uBAAuB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACvD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,uEAAuE;YACvE,oEAAoE;YACpE,2BAA2B;YAC3B,MAAM,OAAO,GAAI,MAA8B,CAAC,OAAO,CAAA;YACvD,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,kCAAkC,CAAC,CAAA;QAC3F,CAAC;IACH,CAAC;AACH,CAAC;AAID,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAiC,MAAM,iBAAiB,CAAA"}

package/dist/transforms/sharp.d.ts

@@ -0,0 +1,3 @@
+import type { TransformAdapter } from './adapter.js';
+export declare const sharpAdapter: TransformAdapter;
+//# sourceMappingURL=sharp.d.ts.map

package/dist/transforms/sharp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp.d.ts","sourceRoot":"","sources":["../../src/transforms/sharp.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAA8B,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAMhF,eAAO,MAAM,YAAY,EAAE,gBAqB1B,CAAA"}

package/dist/transforms/sharp.js

@@ -0,0 +1,43 @@
+/**
+ * Default `TransformAdapter`: origin bytes + pre-generated variant ladder.
+ *
+ * Bytes are served from the target's storage via `assets/serve-route.ts`.
+ * Variants are pre-generated at upload by sharp (see `assets/variants.ts`)
+ * and listed in the manifest's `variants` array. Both URLs and srcset
+ * descriptors point at origin paths — the CDN, if any, caches as-is.
+ *
+ * Cache policy: `public, max-age=31536000, immutable`. Safe because
+ * hash-in-path is content-addressed — new bytes mean a new URL, so
+ * the URL's response is genuinely immutable.
+ *
+ * Single responsibility: wrap `buildAssetUrl` + `buildSrcset` from
+ * `assets/url.ts` behind the `TransformAdapter` interface. No extra
+ * logic — the adapter is the right shape for swap-out, and the URL
+ * helpers stay reusable for tests and future adapters that compose
+ * origin URLs (cloudflare prefixes them; imgproxy wraps them).
+ */
+import { buildAssetUrl, buildSrcset } from '../assets/url.js';
+const IMMUTABLE_CACHE = {
+    cacheControl: 'public, max-age=31536000, immutable',
+};
+export const sharpAdapter = {
+    name: 'sharp',
+    primaryUrl(input) {
+        return buildAssetUrl({
+            name: input.name,
+            hash: input.hash,
+            ext: input.ext,
+            siteUrl: input.siteUrl,
+            selector: input.selector,
+        });
+    },
+    srcset(input) {
+        if (input.variants.length === 0)
+            return null;
+        return buildSrcset(input.variants, input.siteUrl);
+    },
+    cachePolicy(_input) {
+        return IMMUTABLE_CACHE;
+    },
+};
+//# sourceMappingURL=sharp.js.map

package/dist/transforms/sharp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp.js","sourceRoot":"","sources":["../../src/transforms/sharp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAG7D,MAAM,eAAe,GAAgB;IACnC,YAAY,EAAE,qCAAqC;CACpD,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,IAAI,EAAE,OAAO;IAEb,UAAU,CAAC,KAAoB;QAC7B,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CAAC,KAAoB;QACzB,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QAC5C,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IACnD,CAAC;IAED,WAAW,CAAC,MAAqB;QAC/B,OAAO,eAAe,CAAA;IACxB,CAAC;CACF,CAAA"}