clanka 0.5.2 → 0.6.0

package/dist/Image.test.js

@@ -0,0 +1,142 @@
+import * as Photon from "@silvia-odwyer/photon-node";
+import { assert, describe, it } from "@effect/vitest";
+import * as Effect from "effect/Effect";
+import * as Encoding from "effect/Encoding";
+import * as Option from "effect/Option";
+import { vi } from "vitest";
+import * as Image from "./Image.js";
+import { dimensions, encodePng, noisePixel, oversizedFrameHeaders, oversizedHeaders, supportedImages, tinyPng, } from "./fixtures/TestImages.js";
+/** Optionally block decoding so crafted headers can never reach Photon. */
+const withDecoderSpy = (f, blockDecoding = false) => Effect.suspend(() => {
+    const spy = vi.spyOn(Photon.PhotonImage, "new_from_byteslice");
+    if (blockDecoding) {
+        spy.mockImplementation(() => {
+            throw new Error("Header-only fixture must not reach the decoder");
+        });
+    }
+    return f(() => spy.mock.calls.length).pipe(Effect.ensuring(Effect.sync(() => spy.mockRestore())));
+});
+const base64Length = (bytes) => Encoding.encodeBase64(bytes).length;
+describe("Image.prepare", () => {
+    it.effect("passes an in-limit image through unchanged", () => Effect.gen(function* () {
+        assert.strictEqual(Image.maxDimension, 2000);
+        assert.strictEqual(Image.maxBytes, 5 * 1024 * 1024);
+        const prepared = yield* Image.prepare({
+            data: tinyPng,
+            mediaType: "image/png",
+        });
+        assert.deepStrictEqual(prepared, {
+            data: tinyPng,
+            mediaType: "image/png",
+        });
+    }));
+    it.effect("resizes to the dimension cap while preserving aspect ratio", () => Effect.gen(function* () {
+        const prepared = yield* Image.prepare({
+            data: encodePng({ width: 2500, height: 100 }),
+            mediaType: "image/png",
+        });
+        assert.deepStrictEqual(dimensions(prepared.data), {
+            width: 2000,
+            height: 80,
+        });
+        assert.isAtMost(base64Length(prepared.data), Image.maxBytes);
+    }));
+    it.effect("re-encodes an image over the base64 byte cap", () => Effect.gen(function* () {
+        // Exercise the byte budget independently of the dimension cap, without a multi-MB fixture.
+        const data = encodePng({ width: 64, height: 64, pixel: noisePixel });
+        const limits = { maxDimension: 64, maxBytes: 2000 };
+        assert.isAbove(base64Length(data), limits.maxBytes);
+        const prepared = yield* Image.prepare({
+            data,
+            mediaType: "image/png",
+            limits,
+        });
+        assert.isAtMost(base64Length(prepared.data), limits.maxBytes);
+        const size = dimensions(prepared.data);
+        assert.isAtMost(size.width, limits.maxDimension);
+        assert.isAtMost(size.height, limits.maxDimension);
+    }));
+    it.effect("rejects an image that cannot fit even after resizing", () => Effect.gen(function* () {
+        const error = yield* Effect.flip(Image.prepare({
+            data: tinyPng,
+            mediaType: "image/png",
+            limits: { maxDimension: 2, maxBytes: 40 },
+        }));
+        assert.strictEqual(error._tag, "ImageError");
+        assert.strictEqual(error.reason, "TooLarge");
+    }));
+    it.effect("rejects undecodable bytes with a typed error", () => Effect.gen(function* () {
+        const error = yield* Effect.flip(Image.prepare({
+            data: new TextEncoder().encode("not a png"),
+            mediaType: "image/png",
+        }));
+        assert.strictEqual(error._tag, "ImageError");
+        assert.strictEqual(error.reason, "Decode");
+    }));
+});
+// =============================================================================
+// Input budget: what may reach the decoder at all
+//
+// Two bounds sit in front of Photon on every path. `maxInputBytes` caps the
+// encoded input (20 MiB, the same number the HTTP fetch already uses), and
+// `maxInputPixels` caps the canvas declared in the image header, because a
+// small, highly compressible file can expand to gigabytes of RGBA inside the
+// decoder before `prepare` ever reads a width. Both checks run before any
+// decoding; the fixtures below have no pixels, so a decoder call would fail.
+// =============================================================================
+describe("Image input budget", () => {
+    it("pins the shared ceilings", () => {
+        assert.strictEqual(Image.maxInputBytes, 20 * 1024 * 1024);
+        assert.strictEqual(Image.maxInputPixels, 50_000_000);
+    });
+    it.effect("reads dimensions from the header without decoding", () => withDecoderSpy((decoderCalls) => Effect.sync(() => {
+        for (const image of supportedImages) {
+            assert.deepStrictEqual(Option.getOrThrow(Image.dimensions(image.data)), dimensions(image.data), image.mediaType);
+        }
+        // `dimensions` above is the Photon-backed fixture helper; reset.
+        const baseline = decoderCalls();
+        for (const header of oversizedHeaders) {
+            assert.deepStrictEqual(Image.dimensions(header.data), Option.some({ width: header.width, height: header.height }), header.mediaType);
+        }
+        assert.deepStrictEqual(Image.dimensions(new TextEncoder().encode("not an image")), Option.none());
+        assert.strictEqual(decoderCalls(), baseline);
+    })));
+    it.effect("rejects an oversized canvas in every format before decoding", () => withDecoderSpy((decoderCalls) => Effect.gen(function* () {
+        const headers = [...oversizedHeaders, ...oversizedFrameHeaders];
+        const results = [];
+        for (const header of headers) {
+            assert.isAbove(header.width * header.height, Image.maxInputPixels);
+            const baseline = decoderCalls();
+            const error = yield* Effect.flip(Image.prepare({ data: header.data, mediaType: header.mediaType }));
+            results.push({
+                mediaType: header.mediaType,
+                tag: error._tag,
+                reason: error.reason,
+                decoderCalls: decoderCalls() - baseline,
+            });
+        }
+        assert.deepStrictEqual(results, headers.map((header) => ({
+            mediaType: header.mediaType,
+            tag: "ImageError",
+            reason: "TooLarge",
+            decoderCalls: 0,
+        })));
+    }), true));
+    it.effect("rejects input over the byte ceiling before decoding", () => withDecoderSpy((decoderCalls) => Effect.gen(function* () {
+        // A real PNG header followed by padding: over the ceiling by one byte.
+        const data = new Uint8Array(20 * 1024 * 1024 + 1);
+        data.set(tinyPng);
+        const error = yield* Effect.flip(Image.prepare({ data, mediaType: "image/png" }));
+        assert.strictEqual(error._tag, "ImageError");
+        assert.strictEqual(error.reason, "TooLarge");
+        assert.strictEqual(decoderCalls(), 0, "the decoder must not run");
+    })));
+    it.effect("does not send undecodable bytes to the decoder", () => withDecoderSpy((decoderCalls) => Effect.gen(function* () {
+        yield* Effect.flip(Image.prepare({
+            data: new TextEncoder().encode("not a png"),
+            mediaType: "image/png",
+        }));
+        assert.strictEqual(decoderCalls(), 0);
+    })));
+});
+//# sourceMappingURL=Image.test.js.map

package/dist/Image.test.js.map

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

package/dist/fixtures/TestImages.d.ts

@@ -0,0 +1,73 @@
+export declare const encodePng: (options: {
+    readonly width: number;
+    readonly height: number;
+    readonly pixel?: (x: number, y: number) => readonly [number, number, number];
+}) => Uint8Array;
+export declare const noisePixel: (x: number, y: number) => readonly [number, number, number];
+export declare const tinyPng: Uint8Array<ArrayBufferLike>;
+export declare const tinyJpeg: Uint8Array<ArrayBufferLike>;
+export declare const tinyWebp: Uint8Array<ArrayBufferLike>;
+/** Two 4x2 frames (red, then blue), each displayed for 100ms, looping forever. */
+export declare const animatedGif: Uint8Array<ArrayBuffer>;
+export declare const supportedImages: readonly [{
+    readonly fileName: "shot.png";
+    readonly mediaType: "image/png";
+    readonly data: Uint8Array<ArrayBufferLike>;
+}, {
+    readonly fileName: "photo.jpeg";
+    readonly mediaType: "image/jpeg";
+    readonly data: Uint8Array<ArrayBufferLike>;
+}, {
+    readonly fileName: "animated.gif";
+    readonly mediaType: "image/gif";
+    readonly data: Uint8Array<ArrayBuffer>;
+}, {
+    readonly fileName: "picture.webp";
+    readonly mediaType: "image/webp";
+    readonly data: Uint8Array<ArrayBufferLike>;
+}];
+/**
+ * Header-only fixtures that declare canvases far over any sane pixel budget.
+ * They carry no pixel data, so nothing can decode them: a test that passes
+ * one to the decoder is a test that would decode a bomb.
+ */
+export declare const oversizedHeaders: readonly [{
+    readonly mediaType: "image/png";
+    readonly width: 16384;
+    readonly height: 16384;
+    readonly data: Uint8Array<ArrayBuffer>;
+}, {
+    readonly mediaType: "image/jpeg";
+    readonly width: 65535;
+    readonly height: 65535;
+    readonly data: Uint8Array<ArrayBuffer>;
+}, {
+    readonly mediaType: "image/gif";
+    readonly width: 65535;
+    readonly height: 65535;
+    readonly data: Uint8Array<ArrayBuffer>;
+}, {
+    readonly mediaType: "image/webp";
+    readonly width: 16384;
+    readonly height: 16384;
+    readonly data: Uint8Array<ArrayBuffer>;
+}];
+/** Small container canvases hiding 8000x8000 frames, with no pixel payload. */
+export declare const oversizedFrameHeaders: readonly [{
+    readonly mediaType: "image/webp";
+    readonly width: 8000;
+    readonly height: 8000;
+    readonly data: Uint8Array<ArrayBuffer>;
+}, {
+    readonly mediaType: "image/gif";
+    readonly width: 8000;
+    readonly height: 8000;
+    readonly data: Uint8Array<ArrayBuffer>;
+}];
+export declare const dimensions: (bytes: Uint8Array) => {
+    width: number;
+    height: number;
+};
+export declare const bytesOf: (data: string | Uint8Array | URL) => Uint8Array;
+export declare const equalBytes: (a: Uint8Array, b: Uint8Array) => boolean;
+//# sourceMappingURL=TestImages.d.ts.map

package/dist/fixtures/TestImages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestImages.d.ts","sourceRoot":"","sources":["../../src/fixtures/TestImages.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS,YAAa;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7E,KAAG,UAiBH,CAAA;AAED,eAAO,MAAM,UAAU,MAClB,MAAM,KACN,MAAM,KACR,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAKlC,CAAA;AAED,eAAO,MAAM,OAAO,6BAAqC,CAAA;AAYzD,eAAO,MAAM,QAAQ,6BAAe,CAAA;AACpC,eAAO,MAAM,QAAQ,6BAAe,CAAA;AAEpC,kFAAkF;AAClF,eAAO,MAAM,WAAW,yBAWtB,CAAA;AAEF,eAAO,MAAM,eAAe;aAExB,QAAQ,EAAE,UAAU;aACpB,SAAS,EAAE,WAAW;aACtB,IAAI;;aAGJ,QAAQ,EAAE,YAAY;aACtB,SAAS,EAAE,YAAY;aACvB,IAAI;;aAGJ,QAAQ,EAAE,cAAc;aACxB,SAAS,EAAE,WAAW;aACtB,IAAI;;aAGJ,QAAQ,EAAE,cAAc;aACxB,SAAS,EAAE,YAAY;aACvB,IAAI;EAEE,CAAA;AA6GV;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;aAEzB,SAAS,EAAE,WAAW;aACtB,KAAK,EAAE,KAAK;aACZ,MAAM,EAAE,KAAK;aACb,IAAI;;aAGJ,SAAS,EAAE,YAAY;aACvB,KAAK,EAAE,KAAK;aACZ,MAAM,EAAE,KAAK;aACb,IAAI;;aAGJ,SAAS,EAAE,WAAW;aACtB,KAAK,EAAE,KAAK;aACZ,MAAM,EAAE,KAAK;aACb,IAAI;;aAGJ,SAAS,EAAE,YAAY;aACvB,KAAK,EAAE,KAAK;aACZ,MAAM,EAAE,KAAK;aACb,IAAI;EAEE,CAAA;AAEV,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB;aAE9B,SAAS,EAAE,YAAY;aACvB,KAAK,EAAE,IAAI;aACX,MAAM,EAAE,IAAI;aACZ,IAAI;;aAaJ,SAAS,EAAE,WAAW;aACtB,KAAK,EAAE,IAAI;aACX,MAAM,EAAE,IAAI;aACZ,IAAI;EAaE,CAAA;AAEV,eAAO,MAAM,UAAU,UAAW,UAAU;;;CAO3C,CAAA;AAED,eAAO,MAAM,OAAO,SAAU,MAAM,GAAG,UAAU,GAAG,GAAG,KAAG,UASzD,CAAA;AAED,eAAO,MAAM,UAAU,MAAO,UAAU,KAAK,UAAU,KAAG,OACI,CAAA"}

package/dist/fixtures/TestImages.js

@@ -0,0 +1,263 @@
+import * as Photon from "@silvia-odwyer/photon-node";
+import * as Zlib from "node:zlib";
+import * as Encoding from "effect/Encoding";
+export const encodePng = (options) => {
+    const { width, height } = options;
+    const pixels = new Uint8Array(width * height * 4);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            pixels.set([...(options.pixel?.(x, y) ?? [200, 30, 30]), 255], (y * width + x) * 4);
+        }
+    }
+    const image = new Photon.PhotonImage(pixels, width, height);
+    try {
+        return image.get_bytes();
+    }
+    finally {
+        image.free();
+    }
+};
+export const noisePixel = (x, y) => {
+    let h = (x * 374761393 + y * 668265263) | 0;
+    h = Math.imul(h ^ (h >>> 13), 1274126177);
+    h ^= h >>> 16;
+    return [h & 0xff, (h >>> 8) & 0xff, (h >>> 16) & 0xff];
+};
+export const tinyPng = encodePng({ width: 4, height: 3 });
+const encodeOtherFormats = () => {
+    const image = Photon.PhotonImage.new_from_byteslice(tinyPng);
+    try {
+        return { jpeg: image.get_bytes_jpeg(85), webp: image.get_bytes_webp() };
+    }
+    finally {
+        image.free();
+    }
+};
+const encoded = encodeOtherFormats();
+export const tinyJpeg = encoded.jpeg;
+export const tinyWebp = encoded.webp;
+/** Two 4x2 frames (red, then blue), each displayed for 100ms, looping forever. */
+export const animatedGif = new Uint8Array([
+    // GIF89a, logical screen, and a two-colour global palette.
+    71, 73, 70, 56, 57, 97, 4, 0, 2, 0, 128, 0, 0, 255, 0, 0, 0, 0, 255,
+    // NETSCAPE2.0 loop extension.
+    33, 255, 11, 78, 69, 84, 83, 67, 65, 80, 69, 50, 46, 48, 3, 1, 0, 0, 0,
+    // Frame 1: graphics control, image descriptor, and LZW pixels.
+    33, 249, 4, 0, 10, 0, 0, 0, 44, 0, 0, 0, 0, 4, 0, 2, 0, 0, 2, 7, 4, 65, 16, 4,
+    65, 16, 5, 0,
+    // Frame 2 uses the blue palette entry.
+    33, 249, 4, 0, 10, 0, 0, 0, 44, 0, 0, 0, 0, 4, 0, 2, 0, 0, 2, 7, 12, 195, 48,
+    12, 195, 48, 5, 0, 59,
+]);
+export const supportedImages = [
+    {
+        fileName: "shot.png",
+        mediaType: "image/png",
+        data: tinyPng,
+    },
+    {
+        fileName: "photo.jpeg",
+        mediaType: "image/jpeg",
+        data: tinyJpeg,
+    },
+    {
+        fileName: "animated.gif",
+        mediaType: "image/gif",
+        data: animatedGif,
+    },
+    {
+        fileName: "picture.webp",
+        mediaType: "image/webp",
+        data: tinyWebp,
+    },
+];
+const ascii = (text) => Array.from(text, (c) => c.charCodeAt(0));
+const u16be = (n) => [(n >>> 8) & 0xff, n & 0xff];
+const u16le = (n) => [n & 0xff, (n >>> 8) & 0xff];
+const u24le = (n) => [n & 0xff, (n >>> 8) & 0xff, (n >>> 16) & 0xff];
+const u32be = (n) => [
+    (n >>> 24) & 0xff,
+    (n >>> 16) & 0xff,
+    (n >>> 8) & 0xff,
+    n & 0xff,
+];
+const u32le = (n) => [
+    n & 0xff,
+    (n >>> 8) & 0xff,
+    (n >>> 16) & 0xff,
+    (n >>> 24) & 0xff,
+];
+const pngHeader = (width, height) => {
+    const ihdr = [
+        ...ascii("IHDR"),
+        ...u32be(width),
+        ...u32be(height),
+        8,
+        6,
+        0,
+        0,
+        0,
+    ];
+    return new Uint8Array([
+        0x89,
+        0x50,
+        0x4e,
+        0x47,
+        0x0d,
+        0x0a,
+        0x1a,
+        0x0a,
+        ...u32be(13),
+        ...ihdr,
+        ...u32be(Zlib.crc32(new Uint8Array(ihdr))),
+    ]);
+};
+const jpegHeader = (width, height) => new Uint8Array([
+    0xff,
+    0xd8,
+    // APP0 / JFIF, as emitted by most encoders, so the parser must skip it.
+    0xff,
+    0xe0,
+    ...u16be(16),
+    ...ascii("JFIF"),
+    0,
+    1,
+    2,
+    0,
+    0,
+    1,
+    0,
+    1,
+    0,
+    0,
+    // SOF0: length 17, 8-bit precision, height, width, 3 components.
+    0xff,
+    0xc0,
+    ...u16be(17),
+    8,
+    ...u16be(height),
+    ...u16be(width),
+    3,
+    1,
+    0x22,
+    0,
+    2,
+    0x11,
+    1,
+    3,
+    0x11,
+    1,
+]);
+const gifHeader = (width, height) => new Uint8Array([
+    ...ascii("GIF89a"),
+    ...u16le(width),
+    ...u16le(height),
+    0,
+    0,
+    0,
+]);
+/** Extended (VP8X) container, the only WebP form that carries a canvas size. */
+const webpHeader = (width, height) => new Uint8Array([
+    ...ascii("RIFF"),
+    ...u32le(22),
+    ...ascii("WEBP"),
+    ...ascii("VP8X"),
+    ...u32le(10),
+    0,
+    0,
+    0,
+    0,
+    ...u24le(width - 1),
+    ...u24le(height - 1),
+]);
+/**
+ * Header-only fixtures that declare canvases far over any sane pixel budget.
+ * They carry no pixel data, so nothing can decode them: a test that passes
+ * one to the decoder is a test that would decode a bomb.
+ */
+export const oversizedHeaders = [
+    {
+        mediaType: "image/png",
+        width: 16384,
+        height: 16384,
+        data: pngHeader(16384, 16384),
+    },
+    {
+        mediaType: "image/jpeg",
+        width: 65535,
+        height: 65535,
+        data: jpegHeader(65535, 65535),
+    },
+    {
+        mediaType: "image/gif",
+        width: 65535,
+        height: 65535,
+        data: gifHeader(65535, 65535),
+    },
+    {
+        mediaType: "image/webp",
+        width: 16384,
+        height: 16384,
+        data: webpHeader(16384, 16384),
+    },
+];
+/** Small container canvases hiding 8000x8000 frames, with no pixel payload. */
+export const oversizedFrameHeaders = [
+    {
+        mediaType: "image/webp",
+        width: 8000,
+        height: 8000,
+        data: new Uint8Array([
+            ...ascii("RIFF"),
+            ...u32le(36),
+            ...webpHeader(1, 1).subarray(8),
+            ...ascii("VP8L"),
+            ...u32le(5),
+            0x2f,
+            // VP8L packs width-1 and height-1 into 14 bits each.
+            ...u32le(7999 | (7999 << 14)),
+            0, // RIFF chunk padding, not pixel data.
+        ]),
+    },
+    {
+        mediaType: "image/gif",
+        width: 8000,
+        height: 8000,
+        data: new Uint8Array([
+            ...gifHeader(1, 1),
+            0x2c, // Image descriptor.
+            ...u16le(0),
+            ...u16le(0),
+            ...u16le(8000),
+            ...u16le(8000),
+            0, // No local colour table.
+            2,
+            0, // LZW minimum code size and empty data sub-block.
+            0x3b, // Trailer.
+        ]),
+    },
+];
+export const dimensions = (bytes) => {
+    const image = Photon.PhotonImage.new_from_byteslice(bytes);
+    try {
+        return { width: image.get_width(), height: image.get_height() };
+    }
+    finally {
+        image.free();
+    }
+};
+export const bytesOf = (data) => {
+    if (data instanceof Uint8Array)
+        return data;
+    if (data instanceof URL)
+        throw new Error(`Expected inline data, got ${data}`);
+    const base64 = data.startsWith("data:")
+        ? data.slice(data.indexOf(",") + 1)
+        : data;
+    const decoded = Encoding.decodeBase64(base64);
+    if (decoded._tag === "Failure")
+        throw new Error("Invalid base64 image data");
+    return decoded.success;
+};
+export const equalBytes = (a, b) => a.length === b.length && a.every((byte, i) => byte === b[i]);
+//# sourceMappingURL=TestImages.js.map

package/dist/fixtures/TestImages.js.map

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

package/dist/index.d.ts

@@ -31,6 +31,10 @@ export * as CodeChunker from "./CodeChunker.ts";
  * @since 1.0.0
  */
 export * as Compaction from "./Compaction.ts";
+/**
+ * @since 1.0.0
+ */
+export * as Image from "./Image.ts";
 /**
  * @since 1.0.0
  */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAE/B;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAE/B;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -31,6 +31,10 @@ export * as CodeChunker from "./CodeChunker.js";
  * @since 1.0.0
  */
 export * as Compaction from "./Compaction.js";
+/**
+ * @since 1.0.0
+ */
+export * as Image from "./Image.js";
 /**
  * @since 1.0.0
  */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAE/B;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAE/B;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AAEvD;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clanka",
   "type": "module",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "publishConfig": {
     "access": "public"
   },
@@ -26,6 +26,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
+    "@silvia-odwyer/photon-node": "^0.3.4",
     "@vscode/ripgrep": "^1.18.0",
     "chalk": "^6.0.0",
     "glob": "^13.0.6",