@cogenta/render 0.1.0

package/dist/images/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/images/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAoC,MAAM,eAAe,CAAA;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE1F,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAEpG,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACvF,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEtF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAgBrD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAM5E;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAO,GAAyB,EAAE;IAElC,MAAM,QAAQ,GAAG,oBAAoB,CAAgC;QACnE,IAAI,EAAE,QAAQ;QACd,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;KACpE,CAAC,CAAA;IAEF,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAA;IAEpC,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/images/pipeline.d.ts

@@ -0,0 +1,51 @@
+import { type SourceOptions } from './srcset.js';
+import { type VariantStore } from './store.js';
+import { type FocalPoint, type ImageFit, type ImageFormat, type ImageOptions, type ImageSource, type ImageTransformer, type MediaAsset, type RenderedVariant } from './types.js';
+/**
+ * The lazy half of the pipeline.
+ *
+ * `source()` does no work at all — it returns URLs — and `variant()` does the
+ * work the first time a browser follows one of them. That split is the answer to
+ * the spec's warning: nothing is generated at build time, so a site with ten
+ * thousand images and five widths does not have fifty thousand files to produce
+ * before it can deploy. What it has is a cache that fills with the variants
+ * someone actually looked at.
+ */
+export interface VariantParameters {
+    readonly id: string;
+    readonly width?: number | undefined;
+    readonly height?: number | undefined;
+    readonly format?: ImageFormat | undefined;
+    readonly fit?: ImageFit | undefined;
+    /**
+     * From the media entity, resolved by the caller. It is not a URL parameter:
+     * see the note in `srcset.ts`.
+     */
+    readonly focal?: FocalPoint | null | undefined;
+}
+export interface ImagePipelineOptions {
+    readonly transformer: ImageTransformer;
+    /** Reads the original bytes. The pipeline never touches storage itself. */
+    readonly load: (id: string) => Promise<Uint8Array>;
+    readonly store?: VariantStore | undefined;
+    readonly source?: SourceOptions | undefined;
+    readonly quality?: number | undefined;
+}
+export interface ImagePipeline {
+    readonly driver: string;
+    /** Contract D's `ctx.image()`. Pure: builds URLs, generates nothing. */
+    source(media: MediaAsset, options?: ImageOptions): ImageSource;
+    /** What `/_image` calls. Generates on first ask, then serves from the store. */
+    variant(parameters: VariantParameters): Promise<RenderedVariant>;
+}
+export declare function variantKey(parameters: VariantParameters, quality: number): string;
+export declare function createImagePipeline(options: ImagePipelineOptions): ImagePipeline;
+/**
+ * The query string of `/_image`, turned into parameters, or refused.
+ *
+ * Kept next to `variantUrl` in spirit: one function writes the URL, this one
+ * reads it, and a public URL is untrusted input like any other — `w=1e9` and
+ * `f=../../etc/passwd` arrive here, not at a decoder.
+ */
+export declare function parseVariantParameters(query: URLSearchParams): VariantParameters;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/images/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/images/pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AACxE,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;GASG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IACnC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAAA;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAA;IACtC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,wEAAwE;IACxE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAAA;IAC9D,gFAAgF;IAChF,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACjE;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAWjF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAqDhF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,CA0BhF"}

package/dist/images/pipeline.js

@@ -0,0 +1,105 @@
+import { invalidOptionError } from './errors.js';
+import { DEFAULT_QUALITY, planTransform } from './geometry.js';
+import { describeMedia } from './srcset.js';
+import { createMemoryVariantStore } from './store.js';
+import { IMAGE_FORMATS, } from './types.js';
+export function variantKey(parameters, quality) {
+    const focal = parameters.focal;
+    return [
+        parameters.id,
+        `w=${parameters.width ?? ''}`,
+        `h=${parameters.height ?? ''}`,
+        `f=${parameters.format ?? ''}`,
+        `fit=${parameters.fit ?? ''}`,
+        `q=${quality}`,
+        `focal=${focal === undefined || focal === null ? '' : `${focal.x},${focal.y}`}`,
+    ].join('|');
+}
+export function createImagePipeline(options) {
+    const store = options.store ?? createMemoryVariantStore();
+    const quality = options.quality ?? DEFAULT_QUALITY;
+    const sourceOptions = options.source ?? {};
+    const { transformer } = options;
+    /**
+     * Requests for a variant that is being generated right now.
+     *
+     * Without this, a page with one hero image and twenty simultaneous visitors
+     * decodes that image twenty times. It is the difference between a cold cache
+     * costing one render and costing as many renders as there are readers.
+     */
+    const inFlight = new Map();
+    async function generate(key, parameters) {
+        const bytes = await options.load(parameters.id);
+        const metadata = await transformer.metadata(bytes);
+        const request = {
+            width: parameters.width,
+            height: parameters.height,
+            format: parameters.format,
+            fit: parameters.fit,
+            focal: parameters.focal,
+            quality,
+        };
+        const variant = await transformer.transform(bytes, planTransform(metadata, request));
+        await store.set(key, variant);
+        return variant;
+    }
+    return {
+        driver: transformer.name,
+        source: (media, imageOptions) => describeMedia(media, imageOptions ?? {}, sourceOptions),
+        variant: async (parameters) => {
+            const key = variantKey(parameters, quality);
+            const cached = await store.get(key);
+            if (cached !== null)
+                return cached;
+            const running = inFlight.get(key);
+            if (running !== undefined)
+                return running;
+            const work = generate(key, parameters).finally(() => {
+                inFlight.delete(key);
+            });
+            inFlight.set(key, work);
+            return work;
+        },
+    };
+}
+/**
+ * The query string of `/_image`, turned into parameters, or refused.
+ *
+ * Kept next to `variantUrl` in spirit: one function writes the URL, this one
+ * reads it, and a public URL is untrusted input like any other — `w=1e9` and
+ * `f=../../etc/passwd` arrive here, not at a decoder.
+ */
+export function parseVariantParameters(query) {
+    const id = query.get('id');
+    if (id === null || id === '') {
+        throw invalidOptionError('An image request must name the media it wants.', { query: 'id' });
+    }
+    const format = query.get('f');
+    if (format !== null && !IMAGE_FORMATS.includes(format)) {
+        throw invalidOptionError(`"${format}" is not a format Cogenta can produce.`, {
+            format,
+            supported: IMAGE_FORMATS,
+        });
+    }
+    const fit = query.get('fit');
+    if (fit !== null && fit !== 'cover' && fit !== 'contain') {
+        throw invalidOptionError(`"${fit}" is not an image fit. Use "cover" or "contain".`, { fit });
+    }
+    return {
+        id,
+        ...(query.has('w') ? { width: readInteger(query.get('w'), 'w') } : {}),
+        ...(query.has('h') ? { height: readInteger(query.get('h'), 'h') } : {}),
+        ...(format === null ? {} : { format: format }),
+        ...(fit === null ? {} : { fit }),
+    };
+}
+function readInteger(raw, name) {
+    const value = Number(raw);
+    if (raw === null || raw.trim() === '' || !Number.isInteger(value)) {
+        throw invalidOptionError(`The "${name}" of an image request must be a whole number.`, {
+            [name]: raw,
+        });
+    }
+    return value;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/images/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/images/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/images/sharp.d.ts

@@ -0,0 +1,57 @@
+import { type Driver } from '@cogenta/core';
+import type { ImageConfig, ImageTransformer } from './types.js';
+/**
+ * The optimal tier: `sharp`, which links a native libvips.
+ *
+ * An **optional peer dependency**, loaded dynamically, and never a hard one.
+ * Rule R10 is explicit and the L3 spec repeats it: `sharp` does not install on
+ * ARM, on musl, or on shared hosting. Depending on it directly would mean a
+ * `pnpm install` that fails on the hosts Cogenta exists to run on, so its
+ * absence is a normal outcome here — it is what makes the registry fall through
+ * to the WASM tier.
+ *
+ * Its types are declared structurally rather than imported, so that a site
+ * without `sharp` installed can still typecheck against `@cogenta/render`.
+ */
+interface SharpMetadataLike {
+    readonly width?: number | undefined;
+    readonly height?: number | undefined;
+    readonly hasAlpha?: boolean | undefined;
+}
+interface SharpInstanceLike {
+    metadata(): Promise<SharpMetadataLike>;
+    extract(rect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    }): SharpInstanceLike;
+    resize(options: {
+        width: number;
+        height: number;
+        fit: 'fill';
+    }): SharpInstanceLike;
+    flatten(options: {
+        background: string;
+    }): SharpInstanceLike;
+    toFormat(format: string, options?: Readonly<Record<string, unknown>>): SharpInstanceLike;
+    toBuffer(options: {
+        resolveWithObject: true;
+    }): Promise<{
+        data: Uint8Array;
+        info: {
+            width: number;
+            height: number;
+        };
+    }>;
+}
+type SharpFactory = (input: Uint8Array) => SharpInstanceLike;
+/**
+ * Loads `sharp` if the host application installed it. `null` is a normal
+ * answer, not an error.
+ */
+export declare function loadSharpModule(): Promise<SharpFactory | null>;
+export declare function createSharpTransformer(sharp: SharpFactory): ImageTransformer;
+export declare function sharpImageDriver(): Driver<ImageTransformer, ImageConfig>;
+export {};
+//# sourceMappingURL=sharp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sharp.d.ts","sourceRoot":"","sources":["../../src/images/sharp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAqB,MAAM,eAAe,CAAA;AAG5E,OAAO,KAAK,EACV,WAAW,EAGX,gBAAgB,EAGjB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;GAYG;AAEH,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACxC;AAED,UAAU,iBAAiB;IACzB,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACtC,OAAO,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAAA;IAC9F,MAAM,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAAA;IAClF,OAAO,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAAA;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAA;IACxF,QAAQ,CAAC,OAAO,EAAE;QAChB,iBAAiB,EAAE,IAAI,CAAA;KACxB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;CAC3E;AAED,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,iBAAiB,CAAA;AAE5D;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAOpE;AAMD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAiF5E;AAgBD,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAiCxE"}

package/dist/images/sharp.js

@@ -0,0 +1,139 @@
+import { CogentaError } from '@cogenta/core';
+import { decodeFailedError, encodeFailedError, unsupportedFormatError } from './errors.js';
+import { contentTypeOf, sniffImageFormat } from './format.js';
+/**
+ * Loads `sharp` if the host application installed it. `null` is a normal
+ * answer, not an error.
+ */
+export async function loadSharpModule() {
+    try {
+        const module = (await import('sharp'));
+        return module.default;
+    }
+    catch {
+        return null;
+    }
+}
+function encoderOptions(format, quality) {
+    return format === 'png' ? { compressionLevel: 9 } : { quality };
+}
+export function createSharpTransformer(sharp) {
+    function open(bytes, mediaId) {
+        if (sniffImageFormat(bytes) === null)
+            throw unsupportedFormatError(bytes, mediaId);
+        return sharp(bytes);
+    }
+    return {
+        name: 'sharp',
+        tier: 'optimal',
+        metadata: async (bytes) => {
+            const format = sniffImageFormat(bytes);
+            if (format === null)
+                throw unsupportedFormatError(bytes, 'this file');
+            let described;
+            try {
+                described = await open(bytes, 'this file').metadata();
+            }
+            catch (error) {
+                throw decodeFailedError('this file', error);
+            }
+            const { width, height } = described;
+            if (width === undefined || height === undefined) {
+                throw decodeFailedError('this file', 'sharp reported no intrinsic size');
+            }
+            return { width, height, format };
+        },
+        transform: async (bytes, operation) => {
+            let pipeline = open(bytes, 'this file');
+            let described;
+            try {
+                described = await pipeline.metadata();
+            }
+            catch (error) {
+                throw decodeFailedError('this file', error);
+            }
+            const { crop, resize } = operation;
+            if (crop !== null)
+                pipeline = pipeline.extract(crop);
+            if (resize !== null) {
+                // `fill` on purpose: the crop rectangle already carries the aspect
+                // ratio, decided by the shared geometry. Letting sharp fit the box a
+                // second time would let the two tiers disagree.
+                pipeline = pipeline.resize({ width: resize.width, height: resize.height, fit: 'fill' });
+            }
+            // JPEG has no alpha. sharp drops the channel silently, which turns a
+            // transparent background black; the WASM tier flattens onto white. Doing
+            // it explicitly makes both tiers produce the same picture.
+            if (operation.format === 'jpeg' && described.hasAlpha === true) {
+                pipeline = pipeline.flatten({ background: '#ffffff' });
+            }
+            try {
+                const { data, info } = await pipeline
+                    .toFormat(operation.format, encoderOptions(operation.format, operation.quality))
+                    .toBuffer({ resolveWithObject: true });
+                return {
+                    bytes: data,
+                    width: info.width,
+                    height: info.height,
+                    format: operation.format,
+                    contentType: contentTypeOf(operation.format),
+                };
+            }
+            catch (error) {
+                // A truncated file survives `metadata()` — the header is intact — and
+                // fails here, when the pixels are actually read.
+                throw isDecodeFailure(error)
+                    ? decodeFailedError('this file', error)
+                    : encodeFailedError('this file', operation.format, 'sharp', error);
+            }
+        },
+        dispose: async () => {
+            // sharp holds a process-wide thread pool that other selections share.
+        },
+    };
+}
+/** libvips says so in words, and the words are the only signal sharp gives. */
+function isDecodeFailure(error) {
+    const message = error instanceof Error ? error.message.toLowerCase() : '';
+    return (message.includes('unsupported image format') ||
+        message.includes('input buffer') ||
+        message.includes('corrupt') ||
+        message.includes('premature') ||
+        message.includes('bad seek') ||
+        message.includes('truncated') ||
+        message.includes('not enough data'));
+}
+export function sharpImageDriver() {
+    let instance;
+    return {
+        name: 'sharp',
+        tier: 'optimal',
+        available: async () => (await loadSharpModule()) !== null,
+        init: async () => {
+            if (instance === undefined) {
+                const sharp = await loadSharpModule();
+                if (sharp === null) {
+                    throw new CogentaError({
+                        code: 'DRIVER_UNAVAILABLE',
+                        message: 'The sharp image driver was asked for, but sharp is not installed.',
+                        hint: 'Run `pnpm add sharp`, or leave images.driver on "auto" to use the WebAssembly pipeline, which needs nothing.',
+                        details: { need: 'images', driver: 'sharp' },
+                    });
+                }
+                instance = createSharpTransformer(sharp);
+            }
+            return instance;
+        },
+        dispose: async () => {
+            await instance?.dispose();
+            instance = undefined;
+        },
+        health: async () => ({
+            status: 'ok',
+            driver: 'sharp',
+            tier: 'optimal',
+            message: 'Images are resized by the native libvips behind sharp.',
+        }),
+    };
+}
+//# sourceMappingURL=sharp.js.map

package/dist/images/sharp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp.js","sourceRoot":"","sources":["../../src/images/sharp.ts"],"names":[],"mappings":"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"}

package/dist/images/srcset.d.ts

@@ -0,0 +1,33 @@
+import type { ImageOptions, ImageSource, MediaAsset } from './types.js';
+/**
+ * What `ctx.image()` returns, and it returns it **without generating anything**.
+ *
+ * The spec's warning is the whole design here: variants are N formats × M widths
+ * × K contents, and a build that materialises that product does not finish. So a
+ * theme only ever gets URLs, and a variant is rendered the first time a browser
+ * asks for it — then cached. A page that nobody visits costs nothing.
+ *
+ * The widths are a fixed ladder rather than anything derived from the request,
+ * for the same reason: a countable set of variants can be cached, warmed and
+ * purged, and an open-ended one cannot.
+ */
+export declare const SRCSET_WIDTHS: readonly number[];
+export interface SourceOptions {
+    /** Where image variants are served from. */
+    readonly endpoint?: string | undefined;
+    /** Where originals are served from — videos, and anything not resized. */
+    readonly mediaEndpoint?: string | undefined;
+    readonly widths?: readonly number[] | undefined;
+}
+export declare function variantUrl(endpoint: string, media: MediaAsset, width: number, options: ImageOptions): string;
+/** The ladder, capped at the intrinsic width, with the asked-for width always in it. */
+export declare function candidateWidths(requested: number, intrinsic: number | undefined, ladder?: readonly number[]): readonly number[];
+/**
+ * Contract D's `ImageSource` for one media entity.
+ *
+ * A video is not resized. It returns `kind: 'video'`, an empty `srcset` — there
+ * is no responsive source set to offer for a video element — and its poster if
+ * the media has one.
+ */
+export declare function describeMedia(media: MediaAsset, options?: ImageOptions, config?: SourceOptions): ImageSource;
+//# sourceMappingURL=srcset.d.ts.map

package/dist/images/srcset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"srcset.d.ts","sourceRoot":"","sources":["../../src/images/srcset.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAgC,CAAA;AAE3E,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAChD;AASD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,MAAM,CAUR;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,GAAE,SAAS,MAAM,EAAkB,GACxC,SAAS,MAAM,EAAE,CAInB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,YAAiB,EAC1B,MAAM,GAAE,aAAkB,GACzB,WAAW,CA8Bb"}

package/dist/images/srcset.js

@@ -0,0 +1,94 @@
+import { missingSizeError } from './errors.js';
+/**
+ * What `ctx.image()` returns, and it returns it **without generating anything**.
+ *
+ * The spec's warning is the whole design here: variants are N formats × M widths
+ * × K contents, and a build that materialises that product does not finish. So a
+ * theme only ever gets URLs, and a variant is rendered the first time a browser
+ * asks for it — then cached. A page that nobody visits costs nothing.
+ *
+ * The widths are a fixed ladder rather than anything derived from the request,
+ * for the same reason: a countable set of variants can be cached, warmed and
+ * purged, and an open-ended one cannot.
+ */
+export const SRCSET_WIDTHS = [320, 640, 960, 1280, 1920];
+const DEFAULT_ENDPOINT = '/_image';
+const DEFAULT_MEDIA_ENDPOINT = '/_media';
+function originalUrl(media, mediaEndpoint) {
+    return media.url ?? `${mediaEndpoint}/${encodeURIComponent(media.id)}`;
+}
+export function variantUrl(endpoint, media, width, options) {
+    const parameters = new URLSearchParams({ id: media.id, w: String(width) });
+    if (options.height !== undefined)
+        parameters.set('h', String(options.height));
+    if (options.format !== undefined)
+        parameters.set('f', options.format);
+    if (options.fit !== undefined)
+        parameters.set('fit', options.fit);
+    // The focal point is deliberately absent: the endpoint reads it from the media
+    // entity. Putting it in the URL would let a visitor choose the crop, and would
+    // multiply the cache keys of every image by the number of points someone
+    // cares to try.
+    return `${endpoint}?${parameters.toString()}`;
+}
+/** The ladder, capped at the intrinsic width, with the asked-for width always in it. */
+export function candidateWidths(requested, intrinsic, ladder = SRCSET_WIDTHS) {
+    const ceiling = intrinsic ?? requested;
+    const offered = ladder.filter((width) => width <= ceiling);
+    return [...new Set([...offered, Math.min(requested, ceiling)])].sort((a, b) => a - b);
+}
+/**
+ * Contract D's `ImageSource` for one media entity.
+ *
+ * A video is not resized. It returns `kind: 'video'`, an empty `srcset` — there
+ * is no responsive source set to offer for a video element — and its poster if
+ * the media has one.
+ */
+export function describeMedia(media, options = {}, config = {}) {
+    const endpoint = config.endpoint ?? DEFAULT_ENDPOINT;
+    const mediaEndpoint = config.mediaEndpoint ?? DEFAULT_MEDIA_ENDPOINT;
+    const { width, height } = declaredSize(media, options);
+    if (media.kind === 'video') {
+        const poster = media.poster;
+        return {
+            kind: 'video',
+            src: originalUrl(media, mediaEndpoint),
+            srcset: '',
+            width,
+            height,
+            alt: media.alt ?? '',
+            focal: media.focal ?? null,
+            ...(poster === undefined ? {} : { poster }),
+        };
+    }
+    const widths = candidateWidths(width, media.width, config.widths ?? SRCSET_WIDTHS);
+    return {
+        kind: 'image',
+        src: variantUrl(endpoint, media, width, options),
+        srcset: widths.map((w) => `${variantUrl(endpoint, media, w, options)} ${w}w`).join(', '),
+        width,
+        height,
+        alt: media.alt ?? '',
+        focal: media.focal ?? null,
+    };
+}
+/**
+ * The size the `<img>` or `<video>` declares, which is what reserves the space
+ * before the file arrives. Refusing to guess is the point: a missing size is a
+ * layout shift, and a layout shift is a Lighthouse failure the site owner cannot
+ * diagnose from the rendered page.
+ */
+function declaredSize(media, options) {
+    const width = options.width ?? media.width;
+    const height = options.height ??
+        (width !== undefined &&
+            media.width !== undefined &&
+            media.height !== undefined &&
+            media.width > 0
+            ? Math.round((media.height / media.width) * width)
+            : media.height);
+    if (width === undefined || height === undefined)
+        throw missingSizeError(media.id);
+    return { width, height };
+}
+//# sourceMappingURL=srcset.js.map

package/dist/images/srcset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"srcset.js","sourceRoot":"","sources":["../../src/images/srcset.ts"],"names":[],"mappings":"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"}

package/dist/images/store.d.ts

@@ -0,0 +1,32 @@
+import type { RenderedVariant } from './types.js';
+/**
+ * Where a generated variant lands so it is never generated twice.
+ *
+ * An interface rather than a concrete cache, because the right answer differs
+ * per deployment: a single Node process wants memory, a static build wants the
+ * output directory, a fleet wants the object store. The default below is the one
+ * that needs nothing, which is the same reasoning rule R1 applies everywhere
+ * else.
+ *
+ * `CacheDriver` from `@cogenta/core` is deliberately *not* reused: it serialises
+ * its values as JSON, and a JPEG round-tripped through JSON is no longer a JPEG.
+ */
+export interface VariantStore {
+    get(key: string): Promise<RenderedVariant | null>;
+    set(key: string, variant: RenderedVariant): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface MemoryVariantStoreOptions {
+    /** Total bytes of variants held before the least recently used are dropped. */
+    readonly maxBytes?: number;
+}
+/**
+ * In-process, least-recently-used, bounded by bytes rather than by entry count.
+ *
+ * Bounded by bytes because that is the thing that runs out: a thousand thumbnails
+ * and a thousand hero images are the same number of entries and two orders of
+ * magnitude apart in memory. The spec's warning about variants exploding is
+ * about exactly this.
+ */
+export declare function createMemoryVariantStore(options?: MemoryVariantStoreOptions): VariantStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/images/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/images/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;IACjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAID;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,yBAA8B,GAAG,YAAY,CA4C9F"}

package/dist/images/store.js

@@ -0,0 +1,54 @@
+const DEFAULT_MAX_BYTES = 64 * 1024 * 1024;
+/**
+ * In-process, least-recently-used, bounded by bytes rather than by entry count.
+ *
+ * Bounded by bytes because that is the thing that runs out: a thousand thumbnails
+ * and a thousand hero images are the same number of entries and two orders of
+ * magnitude apart in memory. The spec's warning about variants exploding is
+ * about exactly this.
+ */
+export function createMemoryVariantStore(options = {}) {
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    const entries = new Map();
+    let held = 0;
+    function drop(key) {
+        const existing = entries.get(key);
+        if (existing === undefined)
+            return;
+        held -= existing.bytes.byteLength;
+        entries.delete(key);
+    }
+    function evict() {
+        for (const key of entries.keys()) {
+            if (held <= maxBytes)
+                return;
+            drop(key);
+        }
+    }
+    return {
+        get: async (key) => {
+            const found = entries.get(key);
+            if (found === undefined)
+                return null;
+            // Re-inserting moves it to the end, which is what makes the Map an LRU.
+            entries.delete(key);
+            entries.set(key, found);
+            return found;
+        },
+        set: async (key, variant) => {
+            drop(key);
+            // A variant larger than the whole budget is served but not kept: caching
+            // it would evict everything else to hold one file.
+            if (variant.bytes.byteLength > maxBytes)
+                return;
+            entries.set(key, variant);
+            held += variant.bytes.byteLength;
+            evict();
+        },
+        clear: async () => {
+            entries.clear();
+            held = 0;
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/images/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/images/store.ts"],"names":[],"mappings":"AAyBA,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAE1C;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAO,GAA8B,EAAE;IAC9E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAA;IACtD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAA;IAClD,IAAI,IAAI,GAAG,CAAC,CAAA;IAEZ,SAAS,IAAI,CAAC,GAAW;QACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAM;QAClC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAA;QACjC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACrB,CAAC;IAED,SAAS,KAAK;QACZ,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACjC,IAAI,IAAI,IAAI,QAAQ;gBAAE,OAAM;YAC5B,IAAI,CAAC,GAAG,CAAC,CAAA;QACX,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,GAAW,EAAmC,EAAE;YAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC9B,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAA;YACpC,wEAAwE;YACxE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACnB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,GAAG,EAAE,KAAK,EAAE,GAAW,EAAE,OAAwB,EAAiB,EAAE;YAClE,IAAI,CAAC,GAAG,CAAC,CAAA;YACT,yEAAyE;YACzE,mDAAmD;YACnD,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,QAAQ;gBAAE,OAAM;YAC/C,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YACzB,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,CAAA;YAChC,KAAK,EAAE,CAAA;QACT,CAAC;QAED,KAAK,EAAE,KAAK,IAAmB,EAAE;YAC/B,OAAO,CAAC,KAAK,EAAE,CAAA;YACf,IAAI,GAAG,CAAC,CAAA;QACV,CAAC;KACF,CAAA;AACH,CAAC"}