@nifrajs/image 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nifra Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# @nifrajs/image
+
+Image optimization for nifra — a CLS-safe responsive <Image> + pluggable loaders (CDN or self-hosted) + pure-JS dimension reading. Zero-dependency core; optional Bun.Image-backed resize endpoint at @nifrajs/image/server.
+
+Part of the **[nifra](https://nifra.dev)** full-stack TypeScript framework — one core, five UI libraries, every runtime. Scaffold a new app with `bun create nifra`.
+
+## Install
+
+```sh
+bun add @nifrajs/image
+```
+
+## Docs
+
+- Reference: <https://nifra.dev/docs>
+- AI-readable: <https://nifra.dev/llms.txt>
+
+MIT

package/dist/backend.d.ts

@@ -0,0 +1,128 @@
+/**
+ * `@nifrajs/image/backends` — the codec seam + the official {@link ImageBackend} implementations, kept
+ * **dependency-free and edge-safe** (no `node:` imports), so the WASM backend can run on Workers /
+ * Vercel-Edge / Deno-Deploy. `createImageHandler` (in `@nifrajs/image/server`, Node-only — it touches the
+ * filesystem) consumes this seam and owns all request-level security; a backend only
+ * decodes/resizes/encodes and translates codec failures into {@link ImageProcessingError}.
+ *
+ * Pick a backend for your runtime:
+ * - {@link bunImageBackend} — `Bun.Image` (libjpeg-turbo / libspng / libwebp). Bun servers.
+ * - {@link sharpImageBackend} — pass your `sharp` import. Node servers.
+ * - {@link wasmImageBackend} — pass WASM codecs (e.g. jSquash). Any runtime, including the edge.
+ */
+/** Output formats nifra's endpoint can emit. AVIF is intentionally excluded — `Bun.Image` reports
+ * `ERR_IMAGE_FORMAT_UNSUPPORTED` for AVIF encode on common platforms, so offering it would 500. */
+export type OutputFormat = "webp" | "jpeg" | "png";
+export declare const CONTENT_TYPE: Record<OutputFormat, string>;
+/** Header-only probe of a source image: intrinsic dimensions + decoded format. Must be cheap (no full
+ * decode) — it gates the decompression-bomb and no-upscale checks before the expensive resize. */
+export interface ImageProbe {
+    readonly width: number;
+    readonly height: number;
+    /** Lowercased source format as the codec sees it (`"png"`, `"jpeg"`, `"webp"`, `"gif"`, …). */
+    readonly format: string;
+}
+export interface ResizeInput {
+    readonly bytes: Uint8Array;
+    /** Target width in px — already clamped to `[1, maxWidth]` **and** to the source's intrinsic width
+     * (the handler never asks a backend to upscale). Aspect ratio is preserved. */
+    readonly width: number;
+    /** Encoder quality `1..100` (ignored for lossless `png`). */
+    readonly quality: number;
+    readonly format: OutputFormat;
+}
+export interface ResizeOutput {
+    readonly bytes: Uint8Array;
+    readonly contentType: string;
+    readonly format: OutputFormat;
+}
+/**
+ * The codec seam. The handler owns all request-level security (validation, SSRF, byte/pixel caps,
+ * concurrency, caching); a backend only decodes/resizes/encodes. Backends MUST translate codec failures
+ * into {@link ImageProcessingError} so the handler can map them to stable HTTP statuses.
+ */
+export interface ImageBackend {
+    /** Cheap, header-only metadata read. Throws {@link ImageProcessingError} (`decode` / `too_large`). */
+    probe(bytes: Uint8Array): Promise<ImageProbe>;
+    /** Decode → resize to `input.width` (aspect-preserving) → encode to `input.format`. */
+    transform(input: ResizeInput): Promise<ResizeOutput>;
+}
+/** Normalized, backend-agnostic processing failure. Lets the handler map codec errors to HTTP status
+ * without coupling to any one codec's error codes. */
+export declare class ImageProcessingError extends Error {
+    readonly kind: "decode" | "too_large" | "unsupported";
+    constructor(kind: "decode" | "too_large" | "unsupported", message: string);
+}
+/**
+ * {@link ImageBackend} backed by `Bun.Image` (libjpeg-turbo / libspng / libwebp, decoded off the main
+ * thread). Requires the Bun runtime. The default backend of `createImageHandler`.
+ */
+export declare function bunImageBackend(): ImageBackend;
+/** The slice of a [sharp](https://sharp.pixelplumbing.com) instance this backend uses. Declared
+ * structurally so `@nifrajs/image` has no dependency on sharp — pass your own `sharp` import. */
+export type SharpLike = (input: Uint8Array) => SharpInstance;
+interface SharpInstance {
+    metadata(): Promise<{
+        width?: number;
+        height?: number;
+        format?: string;
+    }>;
+    resize(options: {
+        width: number;
+        withoutEnlargement?: boolean;
+    }): SharpInstance;
+    webp(options: {
+        quality: number;
+    }): SharpInstance;
+    jpeg(options: {
+        quality: number;
+    }): SharpInstance;
+    png(): SharpInstance;
+    toBuffer(): Promise<Uint8Array>;
+}
+/**
+ * {@link ImageBackend} backed by [sharp](https://sharp.pixelplumbing.com) (libvips) for Node servers.
+ * Pass your `sharp` import — `@nifrajs/image` never imports it, so it stays dependency-free and you control
+ * the version:
+ *
+ * ```ts
+ * import sharp from "sharp"
+ * createImageHandler({ backend: sharpImageBackend(sharp), root: "./public" })
+ * ```
+ */
+export declare function sharpImageBackend(sharp: SharpLike): ImageBackend;
+/** A decoded image: RGBA pixels + dimensions — the lingua franca of WASM codecs (jSquash, Photon, …). */
+export interface DecodedImage {
+    /** RGBA bytes, length `width * height * 4`. */
+    readonly data: Uint8Array;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Pluggable WASM codec set — decode/resize/encode. Declared structurally so `@nifrajs/image` depends on no
+ * WASM library; wire your own (jSquash is the common pure-WASM, edge-safe choice). The handler probes
+ * dimensions from the source header (bomb-safe), so `decode` runs only inside `transform`.
+ */
+export interface WasmImageCodecs {
+    /** Decode any supported encoded image → RGBA. Throw on undecodable input. */
+    decode(bytes: Uint8Array): Promise<DecodedImage> | DecodedImage;
+    /** Resize RGBA to the target dimensions (the handler keeps the aspect ratio). */
+    resize(image: DecodedImage, width: number, height: number): Promise<DecodedImage> | DecodedImage;
+    /** Encode RGBA → the target format's bytes. */
+    encode(image: DecodedImage, format: OutputFormat, quality: number): Promise<Uint8Array> | Uint8Array;
+}
+/**
+ * {@link ImageBackend} backed by injected WASM codecs — the only backend that runs on the **edge**
+ * (Workers / Vercel-Edge / Deno-Deploy), where neither `Bun.Image` nor sharp exists. `probe` reads the
+ * source header via nifra's dependency-free reader (so decompression bombs are rejected before any
+ * decode); `transform` decodes → resizes (aspect-preserving) → encodes through your codecs.
+ *
+ * ```ts
+ * import decode from "@jsquash/jpeg/decode"; import resize from "@jsquash/resize"
+ * import encodeWebp from "@jsquash/webp/encode" // …+ png/jpeg encoders
+ * const backend = wasmImageBackend({ decode, resize: (img, w, h) => resize(img, { width: w, height: h }), encode })
+ * ```
+ */
+export declare function wasmImageBackend(codecs: WasmImageCodecs): ImageBackend;
+export {};
+//# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

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

package/dist/backend.js

@@ -0,0 +1,170 @@
+/**
+ * `@nifrajs/image/backends` — the codec seam + the official {@link ImageBackend} implementations, kept
+ * **dependency-free and edge-safe** (no `node:` imports), so the WASM backend can run on Workers /
+ * Vercel-Edge / Deno-Deploy. `createImageHandler` (in `@nifrajs/image/server`, Node-only — it touches the
+ * filesystem) consumes this seam and owns all request-level security; a backend only
+ * decodes/resizes/encodes and translates codec failures into {@link ImageProcessingError}.
+ *
+ * Pick a backend for your runtime:
+ * - {@link bunImageBackend} — `Bun.Image` (libjpeg-turbo / libspng / libwebp). Bun servers.
+ * - {@link sharpImageBackend} — pass your `sharp` import. Node servers.
+ * - {@link wasmImageBackend} — pass WASM codecs (e.g. jSquash). Any runtime, including the edge.
+ */
+import { imageDimensions } from "./dimensions.js";
+export const CONTENT_TYPE = {
+    webp: "image/webp",
+    jpeg: "image/jpeg",
+    png: "image/png",
+};
+/** Normalized, backend-agnostic processing failure. Lets the handler map codec errors to HTTP status
+ * without coupling to any one codec's error codes. */
+export class ImageProcessingError extends Error {
+    kind;
+    constructor(kind, message) {
+        super(message);
+        this.kind = kind;
+        this.name = "ImageProcessingError";
+    }
+}
+/**
+ * {@link ImageBackend} backed by `Bun.Image` (libjpeg-turbo / libspng / libwebp, decoded off the main
+ * thread). Requires the Bun runtime. The default backend of `createImageHandler`.
+ */
+export function bunImageBackend() {
+    if (typeof globalThis.Bun === "undefined") {
+        throw new Error("[nifra/image] bunImageBackend() requires the Bun runtime");
+    }
+    const Image = globalThis.Bun.Image;
+    return {
+        async probe(bytes) {
+            try {
+                const md = await new Image(bytes).metadata();
+                return { width: md.width, height: md.height, format: String(md.format).toLowerCase() };
+            }
+            catch (err) {
+                throw toBunError(err);
+            }
+        },
+        async transform({ bytes, width, quality, format }) {
+            try {
+                const img = new Image(bytes).resize(width);
+                const encoded = format === "webp"
+                    ? img.webp({ quality })
+                    : format === "jpeg"
+                        ? img.jpeg({ quality })
+                        : img.png();
+                const out = await encoded.bytes();
+                return { bytes: out, contentType: CONTENT_TYPE[format], format };
+            }
+            catch (err) {
+                throw toBunError(err);
+            }
+        },
+    };
+}
+/** Map a `Bun.Image` failure to a normalized {@link ImageProcessingError}. */
+function toBunError(err) {
+    if (err instanceof ImageProcessingError)
+        return err;
+    const code = err?.code ?? "";
+    if (code === "ERR_IMAGE_TOO_MANY_PIXELS") {
+        return new ImageProcessingError("too_large", "source image exceeds the codec pixel limit");
+    }
+    if (code === "ERR_IMAGE_FORMAT_UNSUPPORTED") {
+        return new ImageProcessingError("unsupported", "image format not supported by the codec");
+    }
+    return new ImageProcessingError("decode", "source is not a decodable image");
+}
+/**
+ * {@link ImageBackend} backed by [sharp](https://sharp.pixelplumbing.com) (libvips) for Node servers.
+ * Pass your `sharp` import — `@nifrajs/image` never imports it, so it stays dependency-free and you control
+ * the version:
+ *
+ * ```ts
+ * import sharp from "sharp"
+ * createImageHandler({ backend: sharpImageBackend(sharp), root: "./public" })
+ * ```
+ */
+export function sharpImageBackend(sharp) {
+    return {
+        async probe(bytes) {
+            try {
+                const md = await sharp(bytes).metadata();
+                if (md.width === undefined || md.height === undefined) {
+                    throw new ImageProcessingError("decode", "sharp could not read image dimensions");
+                }
+                return { width: md.width, height: md.height, format: String(md.format ?? "").toLowerCase() };
+            }
+            catch (err) {
+                throw toSharpError(err);
+            }
+        },
+        async transform({ bytes, width, quality, format }) {
+            try {
+                // `withoutEnlargement` is belt-and-braces: the handler already clamps width ≤ intrinsic.
+                const pipeline = sharp(bytes).resize({ width, withoutEnlargement: true });
+                const encoded = format === "webp"
+                    ? pipeline.webp({ quality })
+                    : format === "jpeg"
+                        ? pipeline.jpeg({ quality })
+                        : pipeline.png();
+                return { bytes: await encoded.toBuffer(), contentType: CONTENT_TYPE[format], format };
+            }
+            catch (err) {
+                throw toSharpError(err);
+            }
+        },
+    };
+}
+/** Map a sharp failure to a normalized {@link ImageProcessingError} by its message. */
+function toSharpError(err) {
+    if (err instanceof ImageProcessingError)
+        return err;
+    const message = (err instanceof Error ? err.message : "").toLowerCase();
+    if (message.includes("pixel limit") || message.includes("too large")) {
+        return new ImageProcessingError("too_large", "source image exceeds sharp's pixel limit");
+    }
+    if (message.includes("unsupported image format") || message.includes("bad seek")) {
+        return new ImageProcessingError("decode", "sharp could not decode the source image");
+    }
+    return new ImageProcessingError("decode", "sharp failed to process the image");
+}
+/**
+ * {@link ImageBackend} backed by injected WASM codecs — the only backend that runs on the **edge**
+ * (Workers / Vercel-Edge / Deno-Deploy), where neither `Bun.Image` nor sharp exists. `probe` reads the
+ * source header via nifra's dependency-free reader (so decompression bombs are rejected before any
+ * decode); `transform` decodes → resizes (aspect-preserving) → encodes through your codecs.
+ *
+ * ```ts
+ * import decode from "@jsquash/jpeg/decode"; import resize from "@jsquash/resize"
+ * import encodeWebp from "@jsquash/webp/encode" // …+ png/jpeg encoders
+ * const backend = wasmImageBackend({ decode, resize: (img, w, h) => resize(img, { width: w, height: h }), encode })
+ * ```
+ */
+export function wasmImageBackend(codecs) {
+    return {
+        async probe(bytes) {
+            const info = imageDimensions(bytes); // header-only — never allocates a decoded buffer
+            if (info === null) {
+                throw new ImageProcessingError("decode", "unrecognized image header");
+            }
+            return { width: info.width, height: info.height, format: info.format };
+        },
+        async transform({ bytes, width, quality, format }) {
+            try {
+                const decoded = await codecs.decode(bytes);
+                // Aspect-preserving: the handler hands a width already clamped to the intrinsic width.
+                const height = Math.max(1, Math.round((decoded.height * width) / decoded.width));
+                const resized = width === decoded.width ? decoded : await codecs.resize(decoded, width, height);
+                const out = await codecs.encode(resized, format, quality);
+                return { bytes: out, contentType: CONTENT_TYPE[format], format };
+            }
+            catch (err) {
+                if (err instanceof ImageProcessingError)
+                    throw err;
+                throw new ImageProcessingError("decode", "wasm codec failed to process the image");
+            }
+        },
+    };
+}
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAMjD,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;CACjB,CAAA;AAuCD;sDACsD;AACtD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAElC;IADX,YACW,IAA4C,EACrD,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAA;QAHL,SAAI,GAAJ,IAAI,CAAwC;QAIrD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAmBD;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,OAAQ,UAAgC,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC7E,CAAC;IACD,MAAM,KAAK,GAAI,UAA0D,CAAC,GAAG,CAAC,KAAK,CAAA;IACnF,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAA;gBAC5C,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAA;YACxF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE;YAC/C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC1C,MAAM,OAAO,GACX,MAAM,KAAK,MAAM;oBACf,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;oBACvB,CAAC,CAAC,MAAM,KAAK,MAAM;wBACjB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;wBACvB,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;gBACjB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;gBACjC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;YAClE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS,UAAU,CAAC,GAAY;IAC9B,IAAI,GAAG,YAAY,oBAAoB;QAAE,OAAO,GAAG,CAAA;IACnD,MAAM,IAAI,GAAI,GAAgC,EAAE,IAAI,IAAI,EAAE,CAAA;IAC1D,IAAI,IAAI,KAAK,2BAA2B,EAAE,CAAC;QACzC,OAAO,IAAI,oBAAoB,CAAC,WAAW,EAAE,4CAA4C,CAAC,CAAA;IAC5F,CAAC;IACD,IAAI,IAAI,KAAK,8BAA8B,EAAE,CAAC;QAC5C,OAAO,IAAI,oBAAoB,CAAC,aAAa,EAAE,yCAAyC,CAAC,CAAA;IAC3F,CAAC;IACD,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,iCAAiC,CAAC,CAAA;AAC9E,CAAC;AAgBD;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAChD,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAA;gBACxC,IAAI,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBACtD,MAAM,IAAI,oBAAoB,CAAC,QAAQ,EAAE,uCAAuC,CAAC,CAAA;gBACnF,CAAC;gBACD,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAA;YAC9F,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,YAAY,CAAC,GAAG,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE;YAC/C,IAAI,CAAC;gBACH,yFAAyF;gBACzF,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAA;gBACzE,MAAM,OAAO,GACX,MAAM,KAAK,MAAM;oBACf,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;oBAC5B,CAAC,CAAC,MAAM,KAAK,MAAM;wBACjB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;wBAC5B,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAA;gBACtB,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;YACvF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,YAAY,CAAC,GAAG,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,uFAAuF;AACvF,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,GAAG,YAAY,oBAAoB;QAAE,OAAO,GAAG,CAAA;IACnD,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACvE,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACrE,OAAO,IAAI,oBAAoB,CAAC,WAAW,EAAE,0CAA0C,CAAC,CAAA;IAC1F,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjF,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,yCAAyC,CAAC,CAAA;IACtF,CAAC;IACD,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,mCAAmC,CAAC,CAAA;AAChF,CAAC;AA8BD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA,CAAC,iDAAiD;YACrF,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,oBAAoB,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAA;YACvE,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;QACxE,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE;YAC/C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC1C,uFAAuF;gBACvF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;gBAChF,MAAM,OAAO,GACX,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;gBACjF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;gBACzD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;YAClE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,oBAAoB;oBAAE,MAAM,GAAG,CAAA;gBAClD,MAAM,IAAI,oBAAoB,CAAC,QAAQ,EAAE,wCAAwC,CAAC,CAAA;YACpF,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/dimensions.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Read an image's intrinsic dimensions from its file **header**, in pure JS — no decode, no codec, no
+ * dependency. Supports PNG, JPEG, GIF, and WebP (VP8/VP8L/VP8X). Used to give `<Image>` CLS-safe
+ * `width`/`height` (build-time tooling can pre-read them into a manifest).
+ */
+export type ImageFormat = "png" | "jpeg" | "gif" | "webp";
+export interface ImageInfo {
+    readonly width: number;
+    readonly height: number;
+    readonly format: ImageFormat;
+}
+/** Parse intrinsic dimensions + format from image header bytes, or `null` if unrecognized/too short. */
+export declare function imageDimensions(bytes: Uint8Array): ImageInfo | null;
+/**
+ * Read just the leading bytes of an image file (via the platform `Bun.file`/`fetch` blob) and parse its
+ * dimensions. Build-time tooling: pre-read dimensions into a manifest so `<Image>` is CLS-safe without
+ * hardcoding sizes. Reads at most `maxBytes` (default 64 KB — enough for any header).
+ */
+export declare function readImageDimensions(source: {
+    arrayBuffer(): Promise<ArrayBuffer>;
+    stream?: () => ReadableStream<Uint8Array>;
+}, maxBytes?: number): Promise<ImageInfo | null>;
+//# sourceMappingURL=dimensions.d.ts.map

package/dist/dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../src/dimensions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;AAEzD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B;AA6DD,wGAAwG;AACxG,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAInE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE;IAAE,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,cAAc,CAAC,UAAU,CAAC,CAAA;CAAE,EAC1F,QAAQ,SAAS,GAChB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAyC3B"}

package/dist/dimensions.js

@@ -0,0 +1,113 @@
+const png = (b, dv) => {
+    // 8-byte signature, then IHDR (length+type), then width/height as big-endian uint32 @16/@20.
+    if (b.length < 24 || b[0] !== 0x89 || b[1] !== 0x50 || b[2] !== 0x4e || b[3] !== 0x47)
+        return null;
+    return { width: dv.getUint32(16), height: dv.getUint32(20), format: "png" };
+};
+const gif = (b, dv) => {
+    // 'GIF', then the logical-screen width/height as little-endian uint16 @6/@8.
+    if (b.length < 10 || b[0] !== 0x47 || b[1] !== 0x49 || b[2] !== 0x46)
+        return null;
+    return { width: dv.getUint16(6, true), height: dv.getUint16(8, true), format: "gif" };
+};
+const jpeg = (b, dv) => {
+    if (b.length < 4 || b[0] !== 0xff || b[1] !== 0xd8)
+        return null;
+    let offset = 2;
+    while (offset + 9 < b.length) {
+        if (dv.getUint8(offset) !== 0xff)
+            return null; // not aligned on a marker → malformed
+        const marker = dv.getUint8(offset + 1);
+        // SOF0..SOF15 carry the frame's height/width — except DHT(c4)/DNL(c8)/DAC(cc).
+        if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {
+            return { height: dv.getUint16(offset + 5), width: dv.getUint16(offset + 7), format: "jpeg" };
+        }
+        offset += 2 + dv.getUint16(offset + 2); // skip this segment (2-byte marker + segment length)
+    }
+    return null;
+};
+const webp = (b, dv) => {
+    // 'RIFF' .... 'WEBP' then a VP8 / VP8L / VP8X chunk.
+    if (b.length < 30 || b[0] !== 0x52 || b[1] !== 0x49 || b[8] !== 0x57 || b[9] !== 0x45)
+        return null;
+    const chunk = String.fromCharCode(b[12], b[13], b[14], b[15]);
+    if (chunk === "VP8 ") {
+        // lossy: 14-bit width/height (little-endian) at @26/@28, masked to 14 bits.
+        return {
+            width: dv.getUint16(26, true) & 0x3fff,
+            height: dv.getUint16(28, true) & 0x3fff,
+            format: "webp",
+        };
+    }
+    if (chunk === "VP8L") {
+        // lossless: after the 0x2f signature @20, 14-bit (width-1) then 14-bit (height-1), bit-packed LE.
+        if (b[20] !== 0x2f)
+            return null;
+        const bits = dv.getUint32(21, true);
+        return { width: (bits & 0x3fff) + 1, height: ((bits >> 14) & 0x3fff) + 1, format: "webp" };
+    }
+    if (chunk === "VP8X") {
+        // extended: 24-bit (width-1) then 24-bit (height-1), little-endian, at @24/@27.
+        const w = b[24] | (b[25] << 8) | (b[26] << 16);
+        const h = b[27] | (b[28] << 8) | (b[29] << 16);
+        return { width: w + 1, height: h + 1, format: "webp" };
+    }
+    return null;
+};
+/** Parse intrinsic dimensions + format from image header bytes, or `null` if unrecognized/too short. */
+export function imageDimensions(bytes) {
+    if (bytes.length < 4)
+        return null;
+    const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    return png(bytes, dv) ?? gif(bytes, dv) ?? jpeg(bytes, dv) ?? webp(bytes, dv);
+}
+/**
+ * Read just the leading bytes of an image file (via the platform `Bun.file`/`fetch` blob) and parse its
+ * dimensions. Build-time tooling: pre-read dimensions into a manifest so `<Image>` is CLS-safe without
+ * hardcoding sizes. Reads at most `maxBytes` (default 64 KB — enough for any header).
+ */
+export async function readImageDimensions(source, maxBytes = 65_536) {
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+        throw new Error("[nifra/image] readImageDimensions: maxBytes must be a positive safe integer");
+    }
+    if (source.stream !== undefined) {
+        const reader = source.stream().getReader();
+        const chunks = [];
+        let total = 0;
+        let reachedEof = false;
+        try {
+            while (total < maxBytes) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    reachedEof = true;
+                    break;
+                }
+                const remaining = maxBytes - total;
+                const chunk = value.byteLength > remaining ? value.subarray(0, remaining) : value;
+                chunks.push(chunk);
+                total += chunk.byteLength;
+                if (value.byteLength > remaining) {
+                    await reader.cancel();
+                    reachedEof = true;
+                    break;
+                }
+            }
+            if (!reachedEof)
+                await reader.cancel();
+        }
+        finally {
+            reader.releaseLock();
+        }
+        const bytes = new Uint8Array(total);
+        let offset = 0;
+        for (const chunk of chunks) {
+            bytes.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return imageDimensions(bytes);
+    }
+    const buf = await source.arrayBuffer();
+    const bytes = new Uint8Array(buf);
+    return imageDimensions(bytes.length > maxBytes ? bytes.subarray(0, maxBytes) : bytes);
+}
+//# sourceMappingURL=dimensions.js.map

package/dist/dimensions.js.map

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

package/dist/html.d.ts

@@ -0,0 +1,21 @@
+import type { ResolvedImage } from "./resolve.js";
+/** Plain lowercase HTML `<img>` attributes (`srcset`/`fetchpriority`, not React's camelCase). */
+export interface HtmlImageAttrs {
+    readonly src: string;
+    readonly width: number;
+    readonly height: number;
+    readonly alt: string;
+    readonly loading: "lazy" | "eager";
+    readonly decoding: "async";
+    readonly srcset?: string;
+    readonly sizes?: string;
+    readonly fetchpriority?: "high";
+}
+/**
+ * Map a {@link ResolvedImage} to plain lowercase HTML `<img>` attribute names — `srcset` (not React's
+ * `srcSet`), `fetchpriority` (not `fetchPriority`) — dropping unset optionals. For the adapters that
+ * spread attributes straight onto a host element (Solid / Vue / Svelte / Preact); React consumes
+ * `ResolvedImage` directly because it requires the camelCased prop names.
+ */
+export declare function toHtmlAttrs(resolved: ResolvedImage): HtmlImageAttrs;
+//# sourceMappingURL=html.d.ts.map

package/dist/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,cAAc,CAyBnE"}

package/dist/html.js

@@ -0,0 +1,26 @@
+/**
+ * Map a {@link ResolvedImage} to plain lowercase HTML `<img>` attribute names — `srcset` (not React's
+ * `srcSet`), `fetchpriority` (not `fetchPriority`) — dropping unset optionals. For the adapters that
+ * spread attributes straight onto a host element (Solid / Vue / Svelte / Preact); React consumes
+ * `ResolvedImage` directly because it requires the camelCased prop names.
+ */
+export function toHtmlAttrs(resolved) {
+    // Build the required attrs, then add optionals only when present (exactOptionalPropertyTypes:
+    // never assign an explicit `undefined`). The result is safe to spread onto an <img>.
+    const attrs = {
+        src: resolved.src,
+        width: resolved.width,
+        height: resolved.height,
+        alt: resolved.alt,
+        loading: resolved.loading,
+        decoding: resolved.decoding,
+    };
+    if (resolved.srcSet !== undefined)
+        attrs.srcset = resolved.srcSet;
+    if (resolved.sizes !== undefined)
+        attrs.sizes = resolved.sizes;
+    if (resolved.fetchPriority !== undefined)
+        attrs.fetchpriority = resolved.fetchPriority;
+    return attrs;
+}
+//# sourceMappingURL=html.js.map

package/dist/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAuB;IACjD,8FAA8F;IAC9F,qFAAqF;IACrF,MAAM,KAAK,GAUP;QACF,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAA;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;IACjE,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;IAC9D,IAAI,QAAQ,CAAC,aAAa,KAAK,SAAS;QAAE,KAAK,CAAC,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAA;IACtF,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `@nifrajs/image` — image optimization for nifra. A CLS-safe responsive `<Image>` (per-adapter) built on
+ * the pure attribute builder `resolveImage`, pluggable CDN `ImageLoader`s (Cloudflare Images + an
+ * identity default), and dependency-free intrinsic-dimension reading. nifra bundles no image codec; the
+ * resize is delegated to the edge CDN via the loader. Per-adapter `<Image>` lives in the adapter packages.
+ */
+export { type ImageFormat, type ImageInfo, imageDimensions, readImageDimensions, } from "./dimensions.js";
+export { type HtmlImageAttrs, toHtmlAttrs } from "./html.js";
+export { type CloudflareLoaderOptions, cloudflareLoader, type ImageLoader, type ImageProps, identityLoader, type ResolvedImage, resolveImage, type SelfHostedLoaderOptions, type SignImageUrlOptions, selfHostedLoader, signImageUrl, } from "./resolve.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,KAAK,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EACL,KAAK,uBAAuB,EAC5B,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,cAAc,EACd,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,YAAY,GACb,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * `@nifrajs/image` — image optimization for nifra. A CLS-safe responsive `<Image>` (per-adapter) built on
+ * the pure attribute builder `resolveImage`, pluggable CDN `ImageLoader`s (Cloudflare Images + an
+ * identity default), and dependency-free intrinsic-dimension reading. nifra bundles no image codec; the
+ * resize is delegated to the edge CDN via the loader. Per-adapter `<Image>` lives in the adapter packages.
+ */
+export { imageDimensions, readImageDimensions, } from "./dimensions.js";
+export { toHtmlAttrs } from "./html.js";
+export { cloudflareLoader, identityLoader, resolveImage, selfHostedLoader, signImageUrl, } from "./resolve.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGL,eAAe,EACf,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAuB,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5D,OAAO,EAEL,gBAAgB,EAGhB,cAAc,EAEd,YAAY,EAGZ,gBAAgB,EAChB,YAAY,GACb,MAAM,cAAc,CAAA"}