@thi.ng/imago 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-25T14:07:53Z
+- **Last updated**: 2024-02-27T20:35:06Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [0.4.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/imago@0.4.0) (2024-02-27)
+
+#### 🚀 Features
+
+- add blurhash output option, update deps ([b7ffedd](https://github.com/thi-ng/umbrella/commit/b7ffedd))
+
 ## [0.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/imago@0.3.0) (2024-02-23)
 
 #### 🚀 Features

package/README.md

@@ -76,9 +76,10 @@ The following pipeline performs these steps (in sequence):
 - proportionally resize image to 1920px (longest side by default)
 - overlay bitmap logo layer, positioned at 45% left / 5% bottom
 - add custom EXIF metadata
-- output this current stage as high quality AVIF (using templated output path)
+- output this current stage as high quality AVIF (and record expanded output path)
 - crop center square region
-- output as JPEG thumbnail
+- output as JPEG thumbnail (and record in outputs)
+- compute [blurhash](https://github.com/thi-ng/umbrella/blob/develop/packages/blurhash) (and record in outputs)
 
 ```json tangle:export/readme-example1.json
 [
@@ -113,7 +114,8 @@ The following pipeline performs these steps (in sequence):
         "avif": { "quality": 80 }
     },
     { "op": "crop", "size": [240, 240], "gravity": "c" },
-    { "op": "output", "id": "thumb", "path": "{name}-thumb.jpg" }
+    { "op": "output", "id": "thumb", "path": "{name}-thumb.jpg" },
+    { "op": "output", "id": "hash", "path": "", blurhash: { detail: 4 } }
 ]
 ```
 
@@ -232,6 +234,11 @@ File output in any of these formats:
 - tiff
 - webp
 
+Alternatively, a
+[blurhash](https://github.com/thi-ng/umbrella/blob/develop/packages/blurhash) of
+the image can be computed and stored in the outputs. In this case, no file will
+be written.
+
 #### Templated output paths
 
 Output paths can contain `{id}`-templated parts which will be replaced/expanded.
@@ -302,12 +309,13 @@ For Node.js REPL:
 const imago = await import("@thi.ng/imago");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 4.06 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 4.16 KB
 
 ## Dependencies
 
 - [@thi.ng/api](https://github.com/thi-ng/umbrella/tree/develop/packages/api)
 - [@thi.ng/associative](https://github.com/thi-ng/umbrella/tree/develop/packages/associative)
+- [@thi.ng/blurhash](https://github.com/thi-ng/umbrella/tree/develop/packages/blurhash)
 - [@thi.ng/checks](https://github.com/thi-ng/umbrella/tree/develop/packages/checks)
 - [@thi.ng/date](https://github.com/thi-ng/umbrella/tree/develop/packages/date)
 - [@thi.ng/defmulti](https://github.com/thi-ng/umbrella/tree/develop/packages/defmulti)

package/api.d.ts

@@ -129,6 +129,15 @@ export interface OutputSpec extends ProcSpec {
      */
     path: string;
     avif?: AvifOptions;
+    blurhash?: {
+        /**
+         * Blurhash detail setting in 1-9 range, possibly given separately for
+         * X/Y axis.
+         *
+         * @defaultValue 4
+         */
+        detail?: number | [number, number];
+    };
     gif?: GifOptions;
     jp2?: Jp2Options;
     jpeg?: JpegOptions;

package/ops/output.js

@@ -1,11 +1,16 @@
+import { encode } from "@thi.ng/blurhash";
 import { writeFile, writeJSON } from "@thi.ng/file-io";
 import { join, resolve } from "node:path";
 import { formatPath } from "../path.js";
-import { isPlainObject } from "@thi.ng/checks";
+import { isNumber, isPlainObject } from "@thi.ng/checks";
 const outputProc = async (spec, input, ctx) => {
   const opts = spec;
   const outDir = resolve(ctx.opts.outDir || ".");
   let output = input.clone();
+  if (opts.blurhash) {
+    await outputBlurHash(opts, output, ctx);
+    return [input, false];
+  }
   if (opts.raw) {
     await outputRaw(opts, output, ctx, outDir);
     return [input, false];
@@ -76,7 +81,7 @@ const outputRaw = async (opts, output, ctx, outDir) => {
   const { alpha = false, meta = false } = isPlainObject(opts.raw) ? opts.raw : {};
   if (alpha)
     output = output.ensureAlpha();
-  const { data, info } = await output.raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await output.ensureAlpha().raw().toBuffer({ resolveWithObject: true });
   const path = join(outDir, formatPath(opts.path, ctx, opts, data));
   writeFile(path, data, null, ctx.logger);
   ctx.outputs[opts.id] = path;
@@ -90,6 +95,20 @@ const outputRaw = async (opts, output, ctx, outDir) => {
     );
   }
 };
+const outputBlurHash = async (opts, output, ctx) => {
+  const { data, info } = await output.ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+  const detail = opts.blurhash.detail || 4;
+  const [dx, dy] = isNumber(detail) ? [detail, detail] : detail;
+  const hash = encode(
+    new Uint32Array(data.buffer),
+    info.width,
+    info.height,
+    dx,
+    dy
+  );
+  ctx.outputs[opts.id] = hash;
+  ctx.logger.debug("computed blurhash:", hash);
+};
 export {
   outputProc
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/imago",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "JSON & API-based declarative and extensible image processing trees/pipelines",
   "type": "module",
   "module": "./index.js",
@@ -37,6 +37,7 @@
   "dependencies": {
     "@thi.ng/api": "^8.9.26",
     "@thi.ng/associative": "^6.3.43",
+    "@thi.ng/blurhash": "^0.1.11",
     "@thi.ng/checks": "^3.5.0",
     "@thi.ng/date": "^2.7.1",
     "@thi.ng/defmulti": "^3.0.26",
@@ -125,5 +126,5 @@
     "status": "alpha",
     "year": 2024
   },
-  "gitHead": "6e20f80dd9df1c8055ffa3c1e4d6f7598add0c0b\n"
+  "gitHead": "41860743a21093aa13b6b7f4e36cd5e2e934d159\n"
 }