@cogenta/render 0.1.0

package/dist/context/render-context.js

@@ -0,0 +1,152 @@
+import { CogentaError } from '@cogenta/core';
+/** Widths a responsive image is offered in. Fixed, so that variants stay countable. */
+const SRCSET_WIDTHS = [320, 640, 960, 1280, 1920];
+const DEFAULT_IMAGE_ENDPOINT = '/_image';
+export function createRenderContext(options) {
+    const site = options.site;
+    const locale = options.locale;
+    const url = typeof options.url === 'string' ? new URL(options.url, site.url) : options.url;
+    const messages = options.messages ?? {};
+    const imageEndpoint = options.imageEndpoint ?? DEFAULT_IMAGE_ENDPOINT;
+    if (!site.locales.includes(locale)) {
+        throw new CogentaError({
+            code: 'CONFIG_INVALID',
+            message: `Cannot render locale "${locale}": the site declares ${site.locales.join(', ')}.`,
+            hint: 'Add the locale to site.locales, or render one the site knows about.',
+            details: { locale, locales: site.locales },
+        });
+    }
+    return {
+        site: {
+            name: site.name,
+            url: site.url,
+            locales: site.locales,
+            defaultLocale: site.defaultLocale,
+        },
+        locale,
+        url,
+        content: options.content,
+        t(key, values) {
+            const template = messages[locale]?.[key] ?? messages[site.defaultLocale]?.[key] ?? key;
+            return values === undefined ? template : interpolate(template, values);
+        },
+        image(media, imageOptions) {
+            return buildImageSource(imageEndpoint, media, imageOptions ?? {});
+        },
+        link(target) {
+            return resolveLink(target, {
+                locale,
+                defaultLocale: site.defaultLocale,
+                resolveEntryPath: options.resolveEntryPath,
+            });
+        },
+    };
+}
+/** `{name}` only. A template language in a theme string is a template language to secure. */
+function interpolate(template, values) {
+    return template.replace(/\{(\w+)\}/gu, (match, name) => {
+        const value = values[name];
+        return value === undefined ? match : String(value);
+    });
+}
+function resolveLink(target, resolution) {
+    if (typeof target === 'string') {
+        // An absolute or protocol-relative target is left exactly as written: it
+        // leaves the site, so localising it would be wrong.
+        if (/^([a-z][a-z0-9+.-]*:|\/\/|#)/iu.test(target))
+            return target;
+        return localise(target, resolution);
+    }
+    if ('path' in target)
+        return localise(target.path, resolution);
+    const resolve = resolution.resolveEntryPath;
+    if (resolve === undefined) {
+        throw new CogentaError({
+            code: 'CONTENT_ROUTE_INVALID',
+            message: `This render context cannot resolve the URL of ${target.collection}/${target.id}.`,
+            hint: 'The host must supply resolveEntryPath when a theme links to entries.',
+            details: { collection: target.collection, id: target.id },
+        });
+    }
+    const path = resolve(target);
+    if (path === null) {
+        // A dangling internal link is a content problem the site owner can fix,
+        // and contract A wants it detectable. Emitting `#` instead would ship a
+        // broken page that nobody notices.
+        throw new CogentaError({
+            code: 'CONTENT_NOT_FOUND',
+            message: `Nothing to link to: ${target.collection}/${target.id} has no route.`,
+            hint: 'The entry was deleted, is not published in this locale, or its collection has no routing pattern.',
+            details: { collection: target.collection, id: target.id },
+        });
+    }
+    return localise(path, resolution);
+}
+/** The default locale owns the bare path; every other locale is prefixed. */
+function localise(path, resolution) {
+    const clean = path.startsWith('/') ? path : `/${path}`;
+    if (resolution.locale === resolution.defaultLocale)
+        return clean;
+    return clean === '/' ? `/${resolution.locale}` : `/${resolution.locale}${clean}`;
+}
+function buildImageSource(endpoint, media, options) {
+    const width = options.width ?? media.width;
+    if (width === undefined) {
+        throw new CogentaError({
+            code: 'CONTENT_INVALID',
+            message: `The media ${media.id} has no width, and none was asked for.`,
+            hint: 'Pass a width to ctx.image(), or re-scan the media so that its intrinsic size is stored. A width is required: an image without one shifts the layout while it loads.',
+            details: { media: media.id },
+        });
+    }
+    const height = options.height ?? scaledHeight(media, width);
+    const candidates = SRCSET_WIDTHS.filter((candidate) => media.width === undefined || candidate <= media.width);
+    const widths = [...new Set([...candidates, width])].sort((a, b) => a - b);
+    // A video is not resized and has no responsive source set: `kind` is what
+    // lets a theme render <video> instead of a broken <img> (contract D,
+    // theme@1.1). Without it every video in a hero renders as a broken image.
+    const kind = media.kind === 'video' ? 'video' : 'image';
+    if (kind === 'video') {
+        return {
+            kind,
+            src: variantUrl(endpoint, media, width, options),
+            srcset: '',
+            width,
+            height,
+            alt: media.alt ?? '',
+            focal: media.focal ?? null,
+            ...(media.poster === undefined ? {} : { poster: media.poster }),
+        };
+    }
+    return {
+        kind,
+        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,
+    };
+}
+function scaledHeight(media, width) {
+    if (media.width === undefined || media.height === undefined || media.width === 0) {
+        throw new CogentaError({
+            code: 'CONTENT_INVALID',
+            message: `The media ${media.id} has no intrinsic size, so no height can be derived.`,
+            hint: 'Pass width and height to ctx.image(), or re-scan the media so that its size is stored.',
+            details: { media: media.id },
+        });
+    }
+    return Math.round((media.height / media.width) * width);
+}
+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);
+    return `${endpoint}?${parameters.toString()}`;
+}
+//# sourceMappingURL=render-context.js.map

package/dist/context/render-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../../src/context/render-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAiC5C,uFAAuF;AACvF,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAU,CAAA;AAC1D,MAAM,sBAAsB,GAAG,SAAS,CAAA;AAExC,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IACzB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC7B,MAAM,GAAG,GAAG,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA;IAC1F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAA;IACvC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAA;IAErE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,yBAAyB,MAAM,wBAAwB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC1F,IAAI,EAAE,qEAAqE;YAC3E,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SAC3C,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC;QACD,MAAM;QACN,GAAG;QACH,OAAO,EAAE,OAAO,CAAC,OAAO;QAExB,CAAC,CAAC,GAAG,EAAE,MAAM;YACX,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAA;YACtF,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACxE,CAAC;QAED,KAAK,CAAC,KAAK,EAAE,YAAY;YACvB,OAAO,gBAAgB,CAAC,aAAa,EAAE,KAAK,EAAE,YAAY,IAAI,EAAE,CAAC,CAAA;QACnE,CAAC;QAED,IAAI,CAAC,MAAM;YACT,OAAO,WAAW,CAAC,MAAM,EAAE;gBACzB,MAAM;gBACN,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;aAC3C,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC;AAED,6FAA6F;AAC7F,SAAS,WAAW,CAAC,QAAgB,EAAE,MAAiD;IACtF,OAAO,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAC1B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;AACJ,CAAC;AAUD,SAAS,WAAW,CAAC,MAAkB,EAAE,UAA0B;IACjE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,yEAAyE;QACzE,oDAAoD;QACpD,IAAI,gCAAgC,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAA;QAChE,OAAO,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,MAAM,IAAI,MAAM;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAE9D,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAA;IAC3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,iDAAiD,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,EAAE,GAAG;YAC3F,IAAI,EAAE,sEAAsE;YAC5E,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;SAC1D,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,wEAAwE;QACxE,wEAAwE;QACxE,mCAAmC;QACnC,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,uBAAuB,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,EAAE,gBAAgB;YAC9E,IAAI,EAAE,mGAAmG;YACzG,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;SAC1D,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;AACnC,CAAC;AAED,6EAA6E;AAC7E,SAAS,QAAQ,CAAC,IAAY,EAAE,UAA0B;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;IACtD,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,aAAa;QAAE,OAAO,KAAK,CAAA;IAChE,OAAO,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,KAAK,EAAE,CAAA;AAClF,CAAC;AAED,SAAS,gBAAgB,CACvB,QAAgB,EAChB,KAAqB,EACrB,OAAqB;IAErB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAA;IAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,aAAa,KAAK,CAAC,EAAE,wCAAwC;YACtE,IAAI,EAAE,qKAAqK;YAC3K,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;SAC7B,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAC3D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CACrC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,IAAI,KAAK,CAAC,KAAK,CACrE,CAAA;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAEzE,0EAA0E;IAC1E,qEAAqE;IACrE,0EAA0E;IAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IAEvD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,OAAO;YACL,IAAI;YACJ,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC;YAChD,MAAM,EAAE,EAAE;YACV,KAAK;YACL,MAAM;YACN,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;YAC1B,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;SAChE,CAAA;IACH,CAAC;IAED,OAAO;QACL,IAAI;QACJ,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC;QAChD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACxF,KAAK;QACL,MAAM;QACN,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;KAC3B,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAqB,EAAE,KAAa;IACxD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,aAAa,KAAK,CAAC,EAAE,sDAAsD;YACpF,IAAI,EAAE,wFAAwF;YAC9F,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;SAC7B,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAA;AACzD,CAAC;AAED,SAAS,UAAU,CACjB,QAAgB,EAChB,KAAqB,EACrB,KAAa,EACb,OAAqB;IAErB,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAC7E,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACrE,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IACjE,OAAO,GAAG,QAAQ,IAAI,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAA;AAC/C,CAAC"}

package/dist/context/types.d.ts

@@ -0,0 +1,49 @@
+import type { ContentClient, MediaReference } from '../content/types.js';
+/**
+ * Contract D's `RenderContext`, frozen at `theme@1.0`.
+ *
+ * This declaration is the contract, transcribed. Adding an entry is a minor
+ * version; changing one is major. Nothing is added here "for later": what a
+ * theme can reach is what the sandbox has to defend, so the smallest surface
+ * that renders a site is the right one.
+ *
+ * Notably absent, and absent on purpose: the database, the configuration, the
+ * secrets, the filesystem, the logger, the request headers.
+ */
+export interface RenderContext {
+    readonly site: {
+        readonly name: string;
+        readonly url: string;
+        readonly locales: readonly string[];
+        readonly defaultLocale: string;
+    };
+    /** The locale being rendered. */
+    readonly locale: string;
+    /** The URL being rendered, already resolved. */
+    readonly url: URL;
+    /** Translation. An unknown key returns the key, never an empty string. */
+    t(key: string, values?: Readonly<Record<string, string | number>>): string;
+    /** Image variants. Returns what a responsive `<img>` needs, nothing more. */
+    image(media: MediaReference, options?: ImageOptions): ImageSource;
+    /** URL of an entry, of a path, or of an external target. Locale-aware. */
+    link(target: LinkTarget): string;
+    /** Read-only content access. The only door to data a theme has. */
+    readonly content: ContentClient;
+}
+export type LinkTarget = {
+    collection: string;
+    id: string;
+} | {
+    path: string;
+} | string;
+/**
+ * Contract D's image types live with the pipeline that produces them.
+ *
+ * They were briefly declared here as well, at `theme@1.0` — without `kind`,
+ * which `theme@1.1` added so a theme can tell an image from a video. Two
+ * declarations of a frozen type is how one of them silently falls behind, and
+ * this one had already done so.
+ */
+import type { ImageOptions, ImageSource } from '../images/types.js';
+export type { ImageOptions, ImageSource };
+//# sourceMappingURL=types.d.ts.map

package/dist/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAExE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;QACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;KAC/B,CAAA;IACD,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IAEjB,0EAA0E;IAC1E,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAA;IAE1E,6EAA6E;IAC7E,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,CAAA;IAEjE,0EAA0E;IAC1E,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAA;IAEhC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAChC;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAA;AAEvF;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEnE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,CAAA"}

package/dist/context/types.js

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

package/dist/context/types.js.map

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

package/dist/images/errors.d.ts

@@ -0,0 +1,20 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * Every failure the pipeline can produce, in one place.
+ *
+ * Both tiers raise the *same* error for the same cause, because a caller that
+ * branches on `code` must not have to know which tier is installed. libvips
+ * reports a decode failure as a WebAssembly exception in one tier and as a
+ * plain `Error` in the other; neither shape reaches the caller.
+ *
+ * There is no `IMAGE_*` entry in `ERROR_CODES` yet — adding one means touching
+ * `@cogenta/core`, which is a separate change — so these reuse the existing
+ * codes with the meanings they already carry: the input is at fault
+ * (`CONTENT_INVALID`), or the pipeline is (`INTERNAL`).
+ */
+export declare function unsupportedFormatError(bytes: Uint8Array, mediaId: string): CogentaError;
+export declare function decodeFailedError(mediaId: string, cause: unknown): CogentaError;
+export declare function encodeFailedError(mediaId: string, format: string, driver: string, cause: unknown): CogentaError;
+export declare function invalidOptionError(message: string, details: Record<string, unknown>): CogentaError;
+export declare function missingSizeError(mediaId: string): CogentaError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/images/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG5C;;;;;;;;;;;;GAYG;AAEH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAOvF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAQ/E;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,YAAY,CAQd;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,YAAY,CAOd;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAO9D"}

package/dist/images/errors.js

@@ -0,0 +1,58 @@
+import { CogentaError } from '@cogenta/core';
+import { describeContainer } from './format.js';
+/**
+ * Every failure the pipeline can produce, in one place.
+ *
+ * Both tiers raise the *same* error for the same cause, because a caller that
+ * branches on `code` must not have to know which tier is installed. libvips
+ * reports a decode failure as a WebAssembly exception in one tier and as a
+ * plain `Error` in the other; neither shape reaches the caller.
+ *
+ * There is no `IMAGE_*` entry in `ERROR_CODES` yet — adding one means touching
+ * `@cogenta/core`, which is a separate change — so these reuse the existing
+ * codes with the meanings they already carry: the input is at fault
+ * (`CONTENT_INVALID`), or the pipeline is (`INTERNAL`).
+ */
+export function unsupportedFormatError(bytes, mediaId) {
+    return new CogentaError({
+        code: 'CONTENT_INVALID',
+        message: `The media ${mediaId} is ${describeContainer(bytes)}, which Cogenta cannot resize.`,
+        hint: 'Upload the image as AVIF, WebP, JPEG or PNG. Animated GIFs and SVGs are served untouched instead of being resized — do not send them through ctx.image().',
+        details: { media: mediaId },
+    });
+}
+export function decodeFailedError(mediaId, cause) {
+    return new CogentaError({
+        code: 'CONTENT_INVALID',
+        message: `The media ${mediaId} announces a format Cogenta supports but could not be decoded.`,
+        hint: 'The file is truncated or corrupted. Re-upload it, and check the storage driver if this happens to more than one image.',
+        cause,
+        details: { media: mediaId },
+    });
+}
+export function encodeFailedError(mediaId, format, driver, cause) {
+    return new CogentaError({
+        code: 'INTERNAL',
+        message: `The ${driver} image driver could not encode ${mediaId} as ${format}.`,
+        hint: 'Ask for a different format — every build of libvips can write JPEG, PNG and WebP, while AVIF depends on how the codec was built. `cogenta doctor` reports which driver is running.',
+        cause,
+        details: { media: mediaId, format, driver },
+    });
+}
+export function invalidOptionError(message, details) {
+    return new CogentaError({
+        code: 'CONTENT_INVALID',
+        message,
+        hint: 'Fix the arguments passed to ctx.image(), or the query string of the /_image request that produced them.',
+        details,
+    });
+}
+export function missingSizeError(mediaId) {
+    return new CogentaError({
+        code: 'CONTENT_INVALID',
+        message: `The media ${mediaId} has no intrinsic size, and none was asked for.`,
+        hint: 'Pass width and height to ctx.image(), or re-scan the media so that its size is stored. A size is required: an image without one shifts the layout while it loads.',
+        details: { media: mediaId },
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/images/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/images/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;;;;;;GAYG;AAEH,MAAM,UAAU,sBAAsB,CAAC,KAAiB,EAAE,OAAe;IACvE,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,aAAa,OAAO,OAAO,iBAAiB,CAAC,KAAK,CAAC,gCAAgC;QAC5F,IAAI,EAAE,2JAA2J;QACjK,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KAC5B,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,KAAc;IAC/D,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,aAAa,OAAO,gEAAgE;QAC7F,IAAI,EAAE,wHAAwH;QAC9H,KAAK;QACL,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KAC5B,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,MAAc,EACd,MAAc,EACd,KAAc;IAEd,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO,MAAM,kCAAkC,OAAO,OAAO,MAAM,GAAG;QAC/E,IAAI,EAAE,oLAAoL;QAC1L,KAAK;QACL,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;KAC5C,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,OAAgC;IAEhC,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,iBAAiB;QACvB,OAAO;QACP,IAAI,EAAE,yGAAyG;QAC/G,OAAO;KACR,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,aAAa,OAAO,iDAAiD;QAC9E,IAAI,EAAE,mKAAmK;QACzK,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KAC5B,CAAC,CAAA;AACJ,CAAC"}

package/dist/images/format.d.ts

@@ -0,0 +1,18 @@
+import { describeContainer, sniffImageFormat } from '@cogenta/core';
+import type { ImageFormat } from './types.js';
+/**
+ * Container sniffing itself now lives in `@cogenta/core` — the media upload
+ * route (`@cogenta/api`) needs the exact same magic-byte sniff, and depending
+ * on this package for four byte-signature checks would pull in Astro/sharp
+ * for no reason. This file re-exports it so the pipeline's own call sites
+ * are unchanged, and keeps the output-format concerns (MIME type, file
+ * suffix) that only the pipeline needs.
+ *
+ * `SniffedImageFormat` (core) and `ImageFormat` (here) are the same literal
+ * union by construction; re-exporting keeps one canonical implementation
+ * without forcing every caller through the same type alias.
+ */
+export { describeContainer, sniffImageFormat };
+export declare function contentTypeOf(format: ImageFormat): string;
+export declare function suffixOf(format: ImageFormat): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/images/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;AAiB9C,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEpD"}

package/dist/images/format.js

@@ -0,0 +1,34 @@
+import { describeContainer, sniffImageFormat } from '@cogenta/core';
+/**
+ * Container sniffing itself now lives in `@cogenta/core` — the media upload
+ * route (`@cogenta/api`) needs the exact same magic-byte sniff, and depending
+ * on this package for four byte-signature checks would pull in Astro/sharp
+ * for no reason. This file re-exports it so the pipeline's own call sites
+ * are unchanged, and keeps the output-format concerns (MIME type, file
+ * suffix) that only the pipeline needs.
+ *
+ * `SniffedImageFormat` (core) and `ImageFormat` (here) are the same literal
+ * union by construction; re-exporting keeps one canonical implementation
+ * without forcing every caller through the same type alias.
+ */
+export { describeContainer, sniffImageFormat };
+const MIME = {
+    avif: 'image/avif',
+    webp: 'image/webp',
+    jpeg: 'image/jpeg',
+    png: 'image/png',
+};
+/** Suffix libvips and sharp both understand for an output format. */
+const SUFFIX = {
+    avif: '.avif',
+    webp: '.webp',
+    jpeg: '.jpg',
+    png: '.png',
+};
+export function contentTypeOf(format) {
+    return MIME[format];
+}
+export function suffixOf(format) {
+    return SUFFIX[format];
+}
+//# sourceMappingURL=format.js.map

package/dist/images/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/images/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGnE;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;AAE9C,MAAM,IAAI,GAA0C;IAClD,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;CACjB,CAAA;AAED,qEAAqE;AACrE,MAAM,MAAM,GAA0C;IACpD,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,MAAM;CACZ,CAAA;AAED,MAAM,UAAU,aAAa,CAAC,MAAmB;IAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAmB;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAA;AACvB,CAAC"}

package/dist/images/geometry.d.ts

@@ -0,0 +1,46 @@
+import type { FocalPoint, ImageFit, ImageFormat, ImageMetadata, Rect, Size, TransformOperation } from './types.js';
+/**
+ * Everything geometric, decided here and only here.
+ *
+ * Both tiers receive a `TransformOperation` with the crop rectangle and the
+ * output size already in pixels. Neither is asked to interpret `cover`, a focal
+ * point, or "what should the height be" — those answers must not depend on which
+ * codec a host managed to install.
+ */
+/**
+ * The largest side the pipeline will produce.
+ *
+ * `/_image?w=…` is a public URL: without a ceiling, one request for a 40000px
+ * variant is a memory exhaustion, and a loop over widths is a cache-filling
+ * attack. 8192 is generous for a 5K display at 2x.
+ */
+export declare const MAX_DIMENSION = 8192;
+export declare const DEFAULT_QUALITY = 80;
+export interface VariantRequest {
+    readonly width?: number | undefined;
+    readonly height?: number | undefined;
+    readonly format?: ImageFormat | undefined;
+    readonly fit?: ImageFit | undefined;
+    /** From the media entity, never from the theme: contract D is explicit. */
+    readonly focal?: FocalPoint | null | undefined;
+    readonly quality?: number | undefined;
+}
+/**
+ * The crop a `cover` fit implies, centred on the focal point.
+ *
+ * The focal point is *kept in frame*, not centred: pushing it to the middle
+ * would slide the crop off the image for a face near an edge, and clamping the
+ * result is what stops that. A missing focal point means the middle, which is
+ * what every naive implementation does and what this one falls back to.
+ */
+export declare function focalCrop(source: Size, target: Size, focal: FocalPoint | null): Rect;
+/**
+ * Turns a request into an operation, or refuses it.
+ *
+ * Never upscales. A variant larger than its source costs bytes and buys nothing
+ * but blur, and a `srcset` that offers one makes the browser download it.
+ */
+export declare function planTransform(source: ImageMetadata, request: VariantRequest): TransformOperation;
+/** The size the operation produces, without touching a pixel. */
+export declare function outputSize(source: ImageMetadata, operation: TransformOperation): Size;
+//# sourceMappingURL=geometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/images/geometry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,aAAa,EACb,IAAI,EACJ,IAAI,EACJ,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAEnB;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,OAAO,CAAA;AAEjC,eAAO,MAAM,eAAe,KAAK,CAAA;AAEjC,MAAM,WAAW,cAAc;IAC7B,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,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACtC;AAwCD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAoBpF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,kBAAkB,CAqChG;AAgBD,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAIrF"}

package/dist/images/geometry.js

@@ -0,0 +1,127 @@
+import { invalidOptionError } from './errors.js';
+/**
+ * Everything geometric, decided here and only here.
+ *
+ * Both tiers receive a `TransformOperation` with the crop rectangle and the
+ * output size already in pixels. Neither is asked to interpret `cover`, a focal
+ * point, or "what should the height be" — those answers must not depend on which
+ * codec a host managed to install.
+ */
+/**
+ * The largest side the pipeline will produce.
+ *
+ * `/_image?w=…` is a public URL: without a ceiling, one request for a 40000px
+ * variant is a memory exhaustion, and a loop over widths is a cache-filling
+ * attack. 8192 is generous for a 5K display at 2x.
+ */
+export const MAX_DIMENSION = 8192;
+export const DEFAULT_QUALITY = 80;
+function assertDimension(value, name) {
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) {
+        throw invalidOptionError(`An image ${name} must be a whole number of pixels, not ${value}.`, {
+            [name]: value,
+        });
+    }
+    if (value > MAX_DIMENSION) {
+        throw invalidOptionError(`An image ${name} of ${value}px is above the ${MAX_DIMENSION}px Cogenta will render.`, { [name]: value, max: MAX_DIMENSION });
+    }
+}
+function assertFocal(focal) {
+    const outside = [focal.x, focal.y].some((value) => !Number.isFinite(value) || value < 0 || value > 1);
+    if (outside) {
+        throw invalidOptionError(`A focal point is expressed as fractions of the image, between 0 and 1 — got (${focal.x}, ${focal.y}).`, { focal });
+    }
+}
+function clampQuality(quality) {
+    if (quality === undefined)
+        return DEFAULT_QUALITY;
+    if (!Number.isFinite(quality) || quality < 1 || quality > 100) {
+        throw invalidOptionError(`An encoder quality must be between 1 and 100, not ${quality}.`, {
+            quality,
+        });
+    }
+    return Math.round(quality);
+}
+const atLeastOne = (value) => Math.max(1, Math.round(value));
+/**
+ * The crop a `cover` fit implies, centred on the focal point.
+ *
+ * The focal point is *kept in frame*, not centred: pushing it to the middle
+ * would slide the crop off the image for a face near an edge, and clamping the
+ * result is what stops that. A missing focal point means the middle, which is
+ * what every naive implementation does and what this one falls back to.
+ */
+export function focalCrop(source, target, focal) {
+    const targetRatio = target.width / target.height;
+    const sourceRatio = source.width / source.height;
+    const width = sourceRatio > targetRatio ? atLeastOne(source.height * targetRatio) : source.width;
+    const height = sourceRatio > targetRatio ? source.height : atLeastOne(source.width / targetRatio);
+    const cropWidth = Math.min(width, source.width);
+    const cropHeight = Math.min(height, source.height);
+    const point = focal ?? { x: 0.5, y: 0.5 };
+    const clamp = (value, span, extent) => Math.max(0, Math.min(extent - span, Math.round(value)));
+    return {
+        left: clamp(point.x * source.width - cropWidth / 2, cropWidth, source.width),
+        top: clamp(point.y * source.height - cropHeight / 2, cropHeight, source.height),
+        width: cropWidth,
+        height: cropHeight,
+    };
+}
+/**
+ * Turns a request into an operation, or refuses it.
+ *
+ * Never upscales. A variant larger than its source costs bytes and buys nothing
+ * but blur, and a `srcset` that offers one makes the browser download it.
+ */
+export function planTransform(source, request) {
+    const format = request.format ?? source.format;
+    const quality = clampQuality(request.quality);
+    const focal = request.focal ?? null;
+    if (focal !== null)
+        assertFocal(focal);
+    if (request.width !== undefined)
+        assertDimension(request.width, 'width');
+    if (request.height !== undefined)
+        assertDimension(request.height, 'height');
+    const identity = { crop: null, resize: null, format, quality };
+    if (request.width === undefined && request.height === undefined)
+        return identity;
+    if (request.width !== undefined && request.height !== undefined) {
+        if ((request.fit ?? 'cover') === 'contain') {
+            // `contain` never crops: the whole image survives, and the caller gets
+            // back the size it actually got rather than the box it asked for.
+            const scale = Math.min(request.width / source.width, request.height / source.height, 1);
+            return withResize(source, scaleOf(source, scale), format, quality);
+        }
+        const crop = focalCrop(source, { width: request.width, height: request.height }, focal);
+        const scale = Math.min(request.width / crop.width, 1);
+        const resize = scaleOf(crop, scale);
+        const cropIsWhole = crop.width === source.width && crop.height === source.height;
+        return {
+            crop: cropIsWhole ? null : crop,
+            resize: resize.width === crop.width && resize.height === crop.height ? null : resize,
+            format,
+            quality,
+        };
+    }
+    const scale = request.width === undefined
+        ? Math.min((request.height ?? source.height) / source.height, 1)
+        : Math.min(request.width / source.width, 1);
+    return withResize(source, scaleOf(source, scale), format, quality);
+}
+function scaleOf(size, scale) {
+    return { width: atLeastOne(size.width * scale), height: atLeastOne(size.height * scale) };
+}
+function withResize(source, resize, format, quality) {
+    const unchanged = resize.width === source.width && resize.height === source.height;
+    return { crop: null, resize: unchanged ? null : resize, format, quality };
+}
+/** The size the operation produces, without touching a pixel. */
+export function outputSize(source, operation) {
+    if (operation.resize !== null)
+        return operation.resize;
+    if (operation.crop !== null)
+        return { width: operation.crop.width, height: operation.crop.height };
+    return { width: source.width, height: source.height };
+}
+//# sourceMappingURL=geometry.js.map

package/dist/images/geometry.js.map

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

package/dist/images/index.d.ts

@@ -0,0 +1,29 @@
+import { type DriverRegistry, type Logger } from '@cogenta/core';
+import type { ImageConfig, ImageTransformer } from './types.js';
+export { decodeFailedError, unsupportedFormatError } from './errors.js';
+export { contentTypeOf, describeContainer, sniffImageFormat, suffixOf } from './format.js';
+export type { VariantRequest } from './geometry.js';
+export { DEFAULT_QUALITY, focalCrop, MAX_DIMENSION, outputSize, planTransform } from './geometry.js';
+export type { ImagePipeline, ImagePipelineOptions, VariantParameters } from './pipeline.js';
+export { createImagePipeline, parseVariantParameters, variantKey } from './pipeline.js';
+export { createSharpTransformer, loadSharpModule, sharpImageDriver } from './sharp.js';
+export type { SourceOptions } from './srcset.js';
+export { candidateWidths, describeMedia, SRCSET_WIDTHS, variantUrl } from './srcset.js';
+export type { MemoryVariantStoreOptions, VariantStore } from './store.js';
+export { createMemoryVariantStore } from './store.js';
+export type { FocalPoint, ImageConfig, ImageFit, ImageFormat, ImageMetadata, ImageOptions, ImageSource, ImageTransformer, MediaAsset, Rect, RenderedVariant, Size, TransformOperation, } from './types.js';
+export { IMAGE_FORMATS } from './types.js';
+export { createWasmTransformer, loadVips, wasmImageDriver } from './wasm.js';
+export interface ImageRegistryOptions {
+    readonly logger?: Logger;
+}
+/**
+ * The image drivers Cogenta ships, in tier order.
+ *
+ * `sharp` first when it is installed, WebAssembly libvips otherwise — and the
+ * fallback is not a courtesy. Rule R10 and the L3 spec both say it plainly:
+ * `sharp` does not install everywhere, so the tier that always works is the one
+ * the default install gets.
+ */
+export declare function createImageRegistry(options?: ImageRegistryOptions): DriverRegistry<ImageTransformer, ImageConfig>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/images/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtF,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAG/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC1F,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACpG,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAC3F,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACvF,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACtF,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACvF,YAAY,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AACrD,YAAY,EACV,UAAU,EACV,WAAW,EACX,QAAQ,EACR,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,IAAI,EACJ,eAAe,EACf,IAAI,EACJ,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAE5E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,cAAc,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAU/C"}

package/dist/images/index.js

@@ -0,0 +1,30 @@
+import { createDriverRegistry } from '@cogenta/core';
+import { sharpImageDriver } from './sharp.js';
+import { wasmImageDriver } from './wasm.js';
+export { decodeFailedError, unsupportedFormatError } from './errors.js';
+export { contentTypeOf, describeContainer, sniffImageFormat, suffixOf } from './format.js';
+export { DEFAULT_QUALITY, focalCrop, MAX_DIMENSION, outputSize, planTransform } from './geometry.js';
+export { createImagePipeline, parseVariantParameters, variantKey } from './pipeline.js';
+export { createSharpTransformer, loadSharpModule, sharpImageDriver } from './sharp.js';
+export { candidateWidths, describeMedia, SRCSET_WIDTHS, variantUrl } from './srcset.js';
+export { createMemoryVariantStore } from './store.js';
+export { IMAGE_FORMATS } from './types.js';
+export { createWasmTransformer, loadVips, wasmImageDriver } from './wasm.js';
+/**
+ * The image drivers Cogenta ships, in tier order.
+ *
+ * `sharp` first when it is installed, WebAssembly libvips otherwise — and the
+ * fallback is not a courtesy. Rule R10 and the L3 spec both say it plainly:
+ * `sharp` does not install everywhere, so the tier that always works is the one
+ * the default install gets.
+ */
+export function createImageRegistry(options = {}) {
+    const registry = createDriverRegistry({
+        need: 'images',
+        ...(options.logger === undefined ? {} : { logger: options.logger }),
+    });
+    registry.register(sharpImageDriver());
+    registry.register(wasmImageDriver());
+    return registry;
+}
+//# sourceMappingURL=index.js.map