@cosmicdrift/kumiko-types 0.191.0 → 0.192.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.191.0",
+  "version": "0.192.0",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren. Enthaelt keine identitaets-sensitiven Runtime-Werte mehr (Error-Klassen leben seit #1629 in kumiko-framework, Brand-Symbole nutzen Symbol.for) und ist deshalb eine plain dependency, keine peerDependency.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/derivatives-types.ts

@@ -4,6 +4,18 @@
 export type VariantFit = "cover" | "inside" | "contain";
 export type VariantFormat = "webp" | "avif" | "jpeg";
 
+// Rectangle in relative coordinates (0…1 of width/height) so it survives a
+// resize. Burning blur into plates/faces needs coordinates that only exist at
+// runtime (detection + user correction), so they ride in the spec instead of a
+// field declaration — the spec hash keys the cache, so corrected regions
+// automatically yield a fresh URL.
+export type BlurRegion = {
+  readonly x: number;
+  readonly y: number;
+  readonly width: number;
+  readonly height: number;
+};
+
 export type VariantSpec = {
   // Default "inside" when omitted (renderer-side default, Schnitt 2).
   readonly fit?: VariantFit;
@@ -14,6 +26,7 @@ export type VariantSpec = {
   readonly quality?: number;
   // Whole-image blur radius.
   readonly blur?: number;
+  readonly blurRegions?: readonly BlurRegion[];
 };
 
 // A renderer turns the original bytes + a spec into the derived bytes for one

package/src/fields.ts

@@ -1,5 +1,7 @@
 // --- Field Types ---
 
+import type { VariantSpec } from "./derivatives-types";
+
 // OwnershipMap is declared in ./ownership.ts — field-access maps to
 // per-role ownership rules. A legacy `readonly string[]` form is still
 // accepted at the type layer during migration: features that pass an
@@ -598,7 +600,10 @@ export type ImageFieldDef = {
   readonly required?: boolean;
   readonly maxSize?: string;
   readonly accept?: readonly string[];
-  readonly thumbnails?: boolean;
+  /** Named derived versions of the uploaded image. The name is the only
+   *  thing a caller may ask for — the spec lives here, never in a request,
+   *  so nobody can drive arbitrary renders. Boot-validated. */
+  readonly variants?: Readonly<Record<string, VariantSpec>>;
   readonly access?: FieldAccess;
 };
 
@@ -615,7 +620,7 @@ export type ImagesFieldDef = {
   readonly maxSize?: string;
   readonly accept?: readonly string[];
   readonly maxCount?: number;
-  readonly thumbnails?: boolean;
+  readonly variants?: Readonly<Record<string, VariantSpec>>;
   readonly access?: FieldAccess;
 };