@giveitsmaller/contracts 0.48.0 → 0.50.0

package/operations/schemas/text_watermark.yaml

@@ -15,14 +15,13 @@ operation:
       pattern); rotation default -45° and tile_spacing controls density.
 
     Stable today for image/jpeg, image/png, image/webp inputs. TIFF
-    (image/tiff) and BMP (image/bmp) inputs are advertised as `planned`
-    via the parallel `image_tiff` / `image_bmp` mime_groups — both are
-    already decodable and the worker's encode arms are a cheap add
-    (shared `image`-crate encoders), so each flips to `stable` once its
-    arm ships and is proven. Output mirrors the input format
-    (`produces: same_as_input`), so a format is only advertised when the
-    worker can both decode AND encode it; HEIC/AVIF (no encoder) and SVG
-    (cannot re-emit svg from a rasterised composite) stay out of scope.
+    (image/tiff) and BMP (image/bmp) inputs are now `stable` too (flipped
+    planned->stable 2026-06-30 on the lambdas staging proof, UANjD38A /
+    #296) via the parallel `image_tiff` / `image_bmp` mime_groups. Output
+    mirrors the input format (`produces: same_as_input`), so a format is
+    only advertised when the worker can both decode AND encode it;
+    HEIC/AVIF (no encoder) and SVG (cannot re-emit svg from a rasterised
+    composite) stay out of scope.
   default: false
   input_model: single
   sole_op: true   # bypasses V1 chain validation — must be the only operation in its job (ADR-0025)
@@ -158,14 +157,14 @@ operation:
             `color` already encodes transparency, so opacity is usually
             left at 1.0 and transparency is set via the color hex.
 
-    # TIFF input — separate group because backend support ships in its own
-    # wave: the format is already decodable, but the encode arm (shared
-    # `image`-crate TiffEncoder) is pending. Tagged `planned` until the arm
-    # ships and is proven, then flips to `stable` (cross-repo UANjD38A).
+    # TIFF input — separate group (its backend arm shipped in its own wave).
+    # Now STABLE (flipped 2026-06-30 — see the group comment below).
     # Text-rendering options are format-independent, so the shape mirrors
     # the canonical `image` group exactly.
     image_tiff:
-      availability: planned
+      # planned->stable 2026-06-30 (UANjD38A): lambdas staging-proved the TIFF
+      # text-watermark encode (composited + decodable as TIFF, PR #296 c664d80;
+      # encoder shipped dark in #274). Manifest lists image/tiff in accepts + outputs.
       mimes:
         - image/tiff
       options:
@@ -284,11 +283,12 @@ operation:
             `color` already encodes transparency, so opacity is usually
             left at 1.0 and transparency is set via the color hex.
 
-    # BMP input — separate group for the same reason as image_tiff: decode
-    # is ready, the encode arm (shared `image`-crate BmpEncoder) is pending.
-    # Tagged `planned` until the arm ships and is proven (cross-repo UANjD38A).
+    # BMP input — separate group for the same reason as image_tiff. Now
+    # STABLE (flipped 2026-06-30 — see the group comment below).
     image_bmp:
-      availability: planned
+      # planned->stable 2026-06-30 (UANjD38A): lambdas staging-proved the BMP
+      # text-watermark encode (composited + decodable as BMP, PR #296 c664d80;
+      # encoder shipped dark in #274). Manifest lists image/bmp in accepts + outputs.
       mimes:
         - image/bmp
       options:

package/operations/schemas/thumbnail.yaml

@@ -17,12 +17,12 @@ operation:
         - image/bmp
         - image/avif
         - image/heic
-      per_mime_availability:
-        # avif/heic decode shipped in the thumbnail-image worker via libheif
-        # (lambdas w34Taquf, #210). beta: live + opt-in, shape-stable.
-        # Re-add after the v2.67.0 interim crash-window drop (aYPbNVKD Phase 2).
-        image/avif: { availability: beta }
-        image/heic: { availability: beta }
+      # avif/heic decode in the thumbnail-image worker via libheif (lambdas
+      # w34Taquf, #210) is now GA-STABLE — no per_mime_availability tag = stable
+      # (the group default), promoted beta→stable 2026-06-30 on the lambdas GA
+      # attestation: libheif decode LIVE on staging since 2026-06-14, e2e
+      # decode-smoke green, zero decode failures since. Standard files are GA;
+      # exotic variants (10-bit / HDR / multi-image HEIC) decode best-effort.
       # Output-area wall (lambdas thumbnail-image MAX_OUTPUT_PIXELS): the FE
       # pre-validates width*height <= max_output_pixels. The per-axis max (16384)
       # is NOT the real limit — e.g. 6000x6000 (36MP) is rejected though each axis
@@ -36,72 +36,20 @@ operation:
           type: integer
           min: 1
           max: 16384
-          required: true
-          description: "Target width in pixels (1-16384; width*height <= 16MP). For image input this is a full resize, not just a small preview."
-        height:
-          type: integer
-          min: 1
-          max: 16384
-          required: true
-          description: "Target height in pixels (1-16384; width*height <= 16MP). For image input this is a full resize, not just a small preview."
-        fit:
-          type: enum
-          values: [max, crop, scale]
-          default: crop
-          description: "Resize mode"
-        format:
-          type: enum
-          values: [jpg, png, webp]
-          default: jpg
-          description: "Output format for the thumbnail"
-        quality:
-          type: integer
-          min: 1
-          max: 100
-          default: 85
-          depends_on: { format: [jpg, webp] }
-          description: "Output quality for lossy thumbnail formats (jpg/webp): higher = better quality, larger file. Ignored for png (lossless)."
-        background:
-          type: string
-          pattern: "^#[0-9a-fA-F]{6}$"
-          depends_on: { format: jpg }
           description: >-
-            Background colour as a 6-digit hex (`#RRGGBB`, e.g. `#ffffff`) for a
-            transparent image (e.g. PNG/WebP with alpha) resized to an opaque JPG
-            thumbnail — the alpha-flatten fill colour. Mirrors
-            convert.image.background. HEX ONLY: a non-hex value (e.g. a CSS named
-            colour) is rejected rather than advertising an inert free-form string.
-            When omitted, transparency is flattened onto white. JPG output only:
-            PNG/WebP keep alpha, so the flatten (and this option) do not apply.
-
-    # SVG input (planned, UANjD38A). SVG is split into its own parallel mime_group
-    # (group-level `availability: planned`, which the API gates -> feature_not_available)
-    # rather than tagged inside the stable `image` group, because per-MIME planned is
-    # advisory/not enforced. SVG rasterises to a bitmap cleanly, so render->resize for
-    # thumbnail is feasible. Flip planned -> stable
-    # (or beta) once the worker proves svg-rasterise input. Shares the `image` group's
-    # option shape (FORMAT.md "Parallel groups").
-    image_svg:
-      availability: planned
-      mimes:
-        - image/svg+xml
-      max_output_pixels: 16000000
-      options:
-        # IMAGE input is a full resizer (Lanczos): width/height accept the
-        # worker's real 1-16384px range (area-capped above) — this op is the
-        # image-resize path, surfaced in the UI as "Resize", not only thumbnails.
-        width:
-          type: integer
-          min: 1
-          max: 16384
-          required: true
-          description: "Target width in pixels (1-16384; width*height <= 16MP). For image input this is a full resize, not just a small preview."
+            Target width in pixels (1-16384; width*height <= 16MP). For image input
+            this is a full resize, not just a small preview. Optional — when omitted
+            the server applies an aspect-preserving default (both omitted → longest
+            edge 320px; only one of width/height provided → the other is derived from
+            the source aspect ratio), so non-square images are never distorted.
         height:
           type: integer
           min: 1
           max: 16384
-          required: true
-          description: "Target height in pixels (1-16384; width*height <= 16MP). For image input this is a full resize, not just a small preview."
+          description: >-
+            Target height in pixels (1-16384; width*height <= 16MP). For image input
+            this is a full resize. Optional — see `width` for the omitted-default
+            (aspect-preserving) behaviour.
         fit:
           type: enum
           values: [max, crop, scale]
@@ -117,8 +65,15 @@ operation:
           min: 1
           max: 100
           default: 85
-          depends_on: { format: [jpg, webp] }
-          description: "Output quality for lossy thumbnail formats (jpg/webp): higher = better quality, larger file. Ignored for png (lossless)."
+          depends_on: { format: [jpg, webp, png] }
+          description: >-
+            Output quality for lossy thumbnail formats (jpg / webp / png): higher =
+            better quality, larger file. For PNG, `quality` < 100 applies lossy palette
+            quantization (imagequant — transparency preserved); `quality: 100` keeps the
+            PNG lossless. Per-format effective default (server-resolved when `quality`
+            is unset, per ADR-0020 D1): PNG → 70 (more aggressive — thumbnails target
+            small files), jpg/webp → 85. The schema `default` is the nominal jpg/webp
+            value (85); the FE shows 70 as the initial PNG slider value.
         background:
           type: string
           pattern: "^#[0-9a-fA-F]{6}$"
@@ -175,14 +130,18 @@ operation:
           type: integer
           min: 1
           max: 16384
-          required: true
-          description: "Target width in pixels (1-16384; width*height <= 16MP). Rounded down to an even number."
+          description: >-
+            Target width in pixels (1-16384; width*height <= 16MP). Rounded down to an
+            even number. Optional — when omitted the server applies an aspect-preserving
+            default (both omitted → longest edge 320px; only one of width/height
+            provided → the other is derived from the source aspect ratio).
         height:
           type: integer
           min: 1
           max: 16384
-          required: true
-          description: "Target height in pixels (1-16384; width*height <= 16MP). Rounded down to an even number."
+          description: >-
+            Target height in pixels (1-16384; width*height <= 16MP). Rounded down to an
+            even number. Optional — see `width` for the omitted-default behaviour.
         fit:
           type: enum
           values: [max, crop, scale]
@@ -237,14 +196,18 @@ operation:
           type: integer
           min: 1
           max: 16384
-          required: true
-          description: "Target width in pixels (1-16384; width*height <= 16MP)."
+          description: >-
+            Target width in pixels (1-16384; width*height <= 16MP). Optional — when
+            omitted the server applies an aspect-preserving default (both omitted →
+            longest edge 320px; only one of width/height provided → the other is
+            derived from the source aspect ratio).
         height:
           type: integer
           min: 1
           max: 16384
-          required: true
-          description: "Target height in pixels (1-16384; width*height <= 16MP)."
+          description: >-
+            Target height in pixels (1-16384; width*height <= 16MP). Optional — see
+            `width` for the omitted-default behaviour.
         fit:
           type: enum
           values: [max, crop, scale]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giveitsmaller/contracts",
-  "version": "0.48.0",
+  "version": "0.50.0",
   "description": "Generated contract types for GISL (Give It Smaller)",
   "license": "MIT",
   "type": "module",