@nhtio/adk 0.1.0-master-2a4e1bd2 → 0.1.0-master-cd595e6f

package/batteries/media.mjs

@@ -3,7 +3,7 @@ import "../guards.mjs";
 import { resampleTo } from "../lib/utils/audio.mjs";
 import { EMPTY_MIME, PCM_MIME, bytesToPcm, implementsMediaEngine, pcmToBytes } from "./media/contracts.mjs";
 import { a as E_MEDIA_NOT_PIPE_EXPRESSIBLE, c as E_MEDIA_STEP_UNAVAILABLE, d as E_MEDIA_UNSUPPORTED_OP, i as E_MEDIA_MISSING_ARG, l as E_MEDIA_UNKNOWN_ARG, n as E_MEDIA_BAD_ARG, o as E_MEDIA_PIPE_SYNTAX, r as E_MEDIA_ENGINE_REQUIRED, s as E_MEDIA_STEP_FAILED, t as E_INVALID_MEDIA_PIPELINE_CONFIG, u as E_MEDIA_UNKNOWN_VERB } from "../exceptions-7Kh_BCpv.mjs";
-import { a as VERBS, c as suggestVerbs, d as isMediaRef, f as isRegExpRef, i as FOLDED_VERBS, l as canonicalFlags, m as toPipe, n as validateOps, o as VERB_INDEX, p as toOps, r as validateSegments, s as foldVerb, t as availableVerbs, u as fromOps } from "../validate-lzy9nG_E.mjs";
+import { a as VERBS, c as suggestVerbs, d as isMediaRef, f as isRegExpRef, i as FOLDED_VERBS, l as canonicalFlags, m as toPipe, n as validateOps, o as VERB_INDEX, p as toOps, r as validateSegments, s as foldVerb, t as availableVerbs, u as fromOps } from "../validate-Bi7FGjoq.mjs";
 import { a as parseStructuredPatch, c as runOnion, i as normalizeWorkspacePath, o as decodeText, r as isStructuredPatch, s as isTextual, t as applyOperations } from "../patch-BbC0U8aR.mjs";
 import { a as replaceExtension, i as familyOf, n as MIME, o as unsupportedForMutationReason, r as SPREADSHEET_MIMES, t as EXT_TO_MIME } from "../formats-CCylUHZw.mjs";
 import { validator } from "@nhtio/validation";
@@ -645,6 +645,10 @@ var ImageNamespace = class {
 	stripMetadata() {
 		return this.#chain.withOp("image.strip_metadata", {});
 	}
+	/** Draw vector primitives and text over the image. */
+	annotate(shapes) {
+		return this.#chain.withOp("image.annotate", { shapes });
+	}
 };
 /** `audio.*` verbs. */
 var AudioNamespace = class {
@@ -2490,6 +2494,7 @@ var requestedOps = (request) => {
 	if (request.rotate !== void 0) ops.push("rotate");
 	if (request.flip) ops.push("flip");
 	if (request.stripMetadata) ops.push("strip_metadata");
+	if (request.annotate) ops.push("annotate");
 	return ops;
 };
 /**
@@ -2747,7 +2752,8 @@ var IMAGE_VERBS = new Set([
 	"image.format",
 	"image.rotate",
 	"image.flip",
-	"image.strip_metadata"
+	"image.strip_metadata",
+	"image.annotate"
 ]);
 var requireImage = (ctx, verb) => {
 	if (!ctx.payload.mimeType.toLowerCase().startsWith("image/")) fail(verb, `image operations expect an image; the media is ${ctx.payload.mimeType}`);
@@ -2794,6 +2800,63 @@ var foldImageStep = (ctx, fused) => {
 			...fused,
 			stripMetadata: true
 		};
+		case "image.annotate": {
+			const shapes = args.shapes;
+			if (!Array.isArray(shapes)) fail("image annotate", "shapes must be an array");
+			const shapeList = shapes;
+			for (const value of shapeList) {
+				if (!isObject(value) || typeof value.type !== "string") fail("image annotate", "each shape must have a type");
+				const shape = value;
+				const type = shape.type;
+				if (![
+					"rect",
+					"line",
+					"arrow",
+					"ellipse",
+					"text"
+				].includes(type)) fail("image annotate", `unsupported shape type "${type}"`);
+				const required = type === "rect" ? [
+					"x",
+					"y",
+					"width",
+					"height"
+				] : type === "line" || type === "arrow" ? [
+					"x1",
+					"y1",
+					"x2",
+					"y2"
+				] : type === "ellipse" ? [
+					"cx",
+					"cy",
+					"rx",
+					"ry"
+				] : [
+					"x",
+					"y",
+					"text"
+				];
+				for (const key of required) {
+					if (!(key in shape) || key !== "text" && typeof shape[key] !== "number" || key === "text" && typeof shape[key] !== "string") fail("image annotate", `shape ${type} requires ${key}`);
+					if (key !== "text" && !Number.isFinite(shape[key])) fail("image annotate", `${type}.${key} must be finite`);
+					if ([
+						"width",
+						"height",
+						"rx",
+						"ry"
+					].includes(key) && shape[key] <= 0) fail("image annotate", `${type}.${key} must be positive`);
+				}
+				for (const key of ["strokeWidth", "size"]) if (key in shape && (typeof shape[key] !== "number" || !Number.isFinite(shape[key]) || shape[key] <= 0)) fail("image annotate", `${type}.${key} must be a positive finite number`);
+				for (const key of [
+					"color",
+					"fill",
+					"font"
+				]) if (key in shape && typeof shape[key] !== "string") fail("image annotate", `${type}.${key} must be text`);
+			}
+			return {
+				...fused,
+				annotate: [...fused.annotate ?? [], ...shapeList]
+			};
+		}
 		default: return fused;
 	}
 };
@@ -2884,6 +2947,7 @@ var IMAGE_AUDIO_STEPS = [
 	["image.rotate", imageStep],
 	["image.flip", imageStep],
 	["image.strip_metadata", imageStep],
+	["image.annotate", imageStep],
 	["audio.transcribe", audioTranscribeStep]
 ];
 //#endregion