@levischuck/tiny-png 0.0.1

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Levi Schuck
+
+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,48 @@
+# tiny-png
+
+A minimal, dependency-free TypeScript PNG encoder for indexed color images.
+
+## Usage
+
+```typescript
+import { indexedPng } from '@levischuck/tiny-png';
+
+// Create an indexed PNG from pixel data
+// Input is a Uint8Array where each byte is a palette index
+const width = 100;
+const height = 100;
+const pixels = new Uint8Array(width * height);
+// ... fill pixels with palette indices (0, 1, 2, etc.)
+
+// Define color palette: [R, G, B] tuples
+const colors: [number, number, number][] = [
+  [255, 255, 255], // Index 0: white
+  [0, 0, 0],       // Index 1: black
+  [255, 0, 0],     // Index 2: red
+];
+
+const pngBytes = await indexedPng(pixels, width, height, colors);
+
+// Write to file
+await Bun.write('output.png', pngBytes);
+```
+
+## API
+
+### `indexedPng(input: Uint8Array, width: number, height: number, colors: [number, number, number][]): Promise<Uint8Array>`
+
+Generates an indexed-color PNG image.
+
+**Parameters:**
+- `input` - Pixel data as a Uint8Array where each byte is a palette index
+- `width` - Image width in pixels
+- `height` - Image height in pixels
+- `colors` - Color palette as an array of `[R, G, B]` tuples (0-255)
+
+**Returns:** Promise resolving to PNG file bytes as a Uint8Array
+
+**Throws:** Error if the color palette doesn't have enough colors for the highest index in the input data.
+
+## License
+
+MIT Licensed.

package/dist/bytes.d.ts

@@ -0,0 +1 @@
+export declare function concat(...bytes: Uint8Array[]): Uint8Array;

package/dist/compress.d.ts

@@ -0,0 +1 @@
+export declare function deflate(uncompressed: Uint8Array<ArrayBuffer>): Promise<Uint8Array>;

package/dist/crc.d.ts

@@ -0,0 +1 @@
+export declare function crc32(data: Uint8Array): number;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare function indexedPng(input: Uint8Array, width: number, height: number, colors: [number, number, number][]): Promise<Uint8Array>;

package/dist/index.js

@@ -0,0 +1,79 @@
+function x(...r) {
+  const e = new Uint8Array(
+    r.reduceRight((o, i) => o + i.length, 0)
+  );
+  let t = 0;
+  for (const o of r)
+    e.set(o, t), t += o.length;
+  return e;
+}
+async function E(r) {
+  const e = new CompressionStream("deflate"), t = e.writable.getWriter();
+  t.write(r), t.close();
+  const o = e.readable.getReader(), i = [];
+  let a = 0;
+  for (; ; ) {
+    const { done: s, value: l } = await o.read();
+    if (s) break;
+    i.push(l), a += l.length;
+  }
+  const c = new Uint8Array(a);
+  let u = 0;
+  for (const s of i)
+    c.set(s, u), u += s.length;
+  return c;
+}
+const h = new Uint32Array(256);
+for (let r = 0; r < 256; r++) {
+  let e = r;
+  for (let t = 0; t < 8; t++)
+    e = e & 1 ? 3988292384 ^ e >>> 1 : e >>> 1;
+  h[r] = e;
+}
+function V(r) {
+  let e = 4294967295;
+  for (let t = 0; t < r.length; t++)
+    e = h[(e ^ r[t]) & 255] ^ e >>> 8;
+  return (e ^ 4294967295) >>> 0;
+}
+const k = new TextEncoder();
+function w(r, e) {
+  const t = new Uint8Array(8 + e.length + 4), o = new DataView(t.buffer);
+  o.setUint32(0, e.length), t.set(k.encode(r), 4), t.set(e, 8);
+  const i = V(t.subarray(4, t.length - 4));
+  return o.setUint32(t.length - 4, i), t;
+}
+async function v(r, e, t, o) {
+  const i = new DataView(r.buffer), a = i.byteLength;
+  let c = 0;
+  for (let n = 0; n < a; n++) {
+    const f = i.getUint8(n);
+    f > c && (c = f);
+  }
+  if (o.length <= c)
+    throw new Error(
+      `Color palette does not have enough colors (${c + 1}). Only ${o.length} were given!`
+    );
+  if (a != e * t)
+    throw new Error(
+      `Input does not match dimensions ${e}x${t}. Only ${a} bytes were given when ${e * t} are expected!`
+    );
+  if (a == 0)
+    throw new Error("Received empty input");
+  const u = new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]), s = new Uint8Array(13), l = new DataView(s.buffer);
+  l.setUint32(0, e), l.setUint32(4, t), s[8] = 8, s[9] = 3, s[10] = 0, s[11] = 0, s[12] = 0;
+  const y = w("IHDR", s), p = new Uint8Array(o.length * 3), g = new DataView(p.buffer);
+  for (let n = 0; n <= c; n++)
+    g.setUint8(n * 3, o[n][0]), g.setUint8(n * 3 + 1, o[n][1]), g.setUint8(n * 3 + 2, o[n][2]);
+  const D = w("PLTE", p), d = e + 1, U = new Uint8Array(d * t), b = new DataView(U.buffer);
+  for (let n = 0; n < t; n++) {
+    U[n * d] = 0;
+    for (let f = 0; f < e; f++)
+      b.setUint8(n * d + 1 + f, i.getUint8(n * e + f));
+  }
+  const A = w("IDAT", await E(U)), m = w("IEND", new Uint8Array(0));
+  return x(u, y, D, A, m);
+}
+export {
+  v as indexedPng
+};

package/dist/pngBytes.d.ts

@@ -0,0 +1 @@
+export declare function pngChunk(type: string, data: Uint8Array): Uint8Array;

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@levischuck/tiny-png",
+  "version": "0.0.1",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/levischuck/tiny-packages.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.txt"
+  ],
+  "keywords": [
+    "png",
+    "encoder"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}