@arraypress/covers 1.3.1 → 1.4.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to `@arraypress/covers` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.0] — 2026-11-06
+
+Three flyers that set on any canvas, and the layers they stand on. Every published recipe renders as before (185 SVGs, flyers at 4:5 and as release covers plus the built-ins, byte-identical to 1.3.1).
+
+### Added
+
+- **Three flyers**, drawn on a 400-wide grid as tall as the canvas, so they set at 4:5, 1:1, 9:16 and A-series portrait alike: `grid-poster` (a Swiss grid poster: a photo washed in one colour or a grainy field, a hairline grid of five columns whose rows follow the aspect, meta in its cells, the mark on a tile in one cell, a two-weight headline fitted to four columns), `logofolio` (a collection sheet: a title and meta over a grid of up to 70 marks, optically sized the same) and `pixel-mosaic` (the mark rastered into big neon cells over a greyscale photo, a few left out by seed, the name huge across the foot).
+- **`mosaic` layer**: a mark rastered into square cells drawn apart, following its shape (`@logomarks/core`'s pixelate); `cells`, `gap`, `drop` (a seeded share left out), `accent` (an asterisk or dot in one empty cell).
+- **`marks` layer**: a set of marks on an even grid, each optically sized by its real bounds and ink and held to its cell; columns and rows from the count (3 × 3 to 10 × 7).
+- **Text lines as spans**: a `content` array may hold span objects, one a line (`[{ content: 'Signal', bold: true }, 'over the']`); `bold: true` on any span sets it at the layer's `boldWeight` (700).
+- **JSON**: `round`, `floor` and `ceil` operators (a grid's row count from the canvas).
+- `pattern` takes `divisions: [cols, rows]` for a design grid.
+- `≠` in the built-in symbols, for fonts whose Latin subset lacks it.
+
+### Changed
+
+- Depends on `@logomarks/core` `^0.1.5` (pixelate without a canvas).
+
 ## [1.3.1] — 2026-11-06
 
 ### Changed

package/README.md

@@ -36,7 +36,7 @@ await writeFile('public/covers/introducing-covers.webp', webp);
 - [API](https://github.com/arraypress/covers/blob/main/docs/api.md): every export and cover option
 - [Layers](https://github.com/arraypress/covers/blob/main/docs/layers.md): mesh, grain, text, diagrams, riso inks, dithers, poster type and more
 - [Effects](https://github.com/arraypress/covers/blob/main/docs/effects.md): filters and pixel effects on any layer, masks, paints
-- [Recipes](https://github.com/arraypress/covers/blob/main/docs/recipes.md): seventeen built-ins, 84 flyers and release covers, your own
+- [Recipes](https://github.com/arraypress/covers/blob/main/docs/recipes.md): seventeen built-ins, 87 flyers and release covers, your own
 - [JSON recipes](https://github.com/arraypress/covers/blob/main/docs/json-recipes.md): a cover style as data, with no JavaScript
 - [Palettes](https://github.com/arraypress/covers/blob/main/docs/palettes.md): presets, one accent, a theme's tokens
 - [Formats, print and brand kits](https://github.com/arraypress/covers/blob/main/docs/formats.md): social sizes with safe zones, print with bleed, `kit`, `lint`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arraypress/covers",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "Covers, flyers, posters, release art, social formats and print stationery from one seed and a stack of layers: mesh gradients, grain, riso inks and halftones, knockout and justified type, torn paper, barcodes, safe zones and bleed, as SVG or WebP/PNG/AVIF/JPEG. Recipes are JSON. Runs in Node, browsers and Cloudflare Workers.",
   "type": "module",
   "main": "src/index.js",
@@ -85,6 +85,7 @@
   },
   "dependencies": {
     "@arraypress/color-utils": "^1.3.0",
+    "@logomarks/core": "^0.1.5",
     "@logomarks/image-effects": "^0.1.1",
     "harfbuzzjs": "^1.6.3"
   },

package/recipes/flyers/grid-poster.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "../../schema/recipe.schema.json",
+  "name": "grid-poster",
+  "description": "Swiss grid poster: a moody full-bleed photo washed in one strong colour (or, with no photo, a grainy gradient field in it), a hairline grid of five columns over the whole sheet, tiny meta hung in its cells (series, handle and year across the top; a label, a code and coordinates on the middle row; the credit and a save prompt along the foot), the mark small on a white tile in one cell, and a big uppercase headline whose lines alternate bold and light, fitted to the four columns right of the first column line, with a small sub-line under it. The grid is drawn on a 400-wide design grid as tall as the canvas, so its rows follow the aspect: eight at 4:5, six at 1:1, eleven at 9:16. Headline lines are strings or { content, bold }.",
+  "params": {
+    "name": "Kestrel",
+    "headline": [
+      { "content": "Signal", "bold": true },
+      { "content": "over the", "bold": false },
+      { "content": "noise", "bold": true }
+    ],
+    "sub": "Visibility ≠ Clarity",
+    "series": "",
+    "handle": "",
+    "year": "©2026",
+    "label": "Edition",
+    "code": "Nº 014",
+    "coords": "51.5072° N\n0.1276° W",
+    "credit": "",
+    "save": "Save this for later",
+    "wash": "#ff5a1f",
+    "ink": "#ffffff",
+    "tile": "#ffffff",
+    "markColor": ""
+  },
+  "vars": {
+    "h": { "mul": [400, { "div": ["@height", "@width"] }] },
+    "rows": { "max": [4, { "round": { "div": ["$h", 62.5] } }] },
+    "rowH": { "div": ["$h", "$rows"] },
+    "mid": { "floor": { "div": [{ "sub": ["$rows", 1] }, 2] } },
+    "midTop": { "mul": ["$mid", "$rowH"] },
+    "footTop": { "sub": ["$h", "$rowH"] },
+    "deep": { "readable": ["{ink}", { "tone": ["{wash}", { "l": [0.5, 0.58] }] }, { "tone": ["{wash}", { "l": [0.12, 0.2] }] }] },
+    "glow": { "tone": ["{wash}", { "l": [0.72, 0.8] }] },
+    "markInk": { "if": "markColor", "then": "{markColor}", "else": { "tone": ["{wash}", { "l": [0.3, 0.58] }] } }
+  },
+  "layers": [
+    { "id": "photo", "type": "image", "when": "photo", "src": "{photo}", "fit": "cover", "duotone": ["$deep", "{wash}"] },
+    { "id": "field", "type": "radial", "when": { "not": "photo" }, "colors": ["$glow", "{wash}", "$deep"], "radius": "110vmax" },
+    { "id": "fieldGrain", "type": "grain", "when": { "not": "photo" }, "amount": 0.16, "vary": "edges" },
+    {
+      "id": "poster",
+      "type": "group",
+      "viewBox": [0, 0, 400, "$h"],
+      "fit": "contain",
+      "layers": [
+        { "id": "grid", "type": "pattern", "kind": "grid", "divisions": [5, "$rows"], "color": "{ink}", "stroke": 0.5, "opacity": 0.12 },
+        { "id": "tile", "type": "shape", "kind": "rect", "x": 6, "y": { "add": ["$rowH", 6] }, "width": 68, "height": { "sub": ["$rowH", 12] }, "fill": "{tile}", "when": "mark" },
+        {
+          "id": "mark",
+          "type": "icon",
+          "when": "mark",
+          "markup": "{mark}",
+          "size": { "mul": ["$rowH", 0.56] },
+          "x": { "sub": [40, { "mul": ["$rowH", 0.28] }] },
+          "y": { "mul": ["$rowH", 1.22] },
+          "color": "$markInk"
+        },
+        { "id": "series", "type": "text", "content": { "if": "series", "then": "{series}", "else": "{name} — Series" }, "font": "Inter Tight", "weight": 700, "size": 7, "letterSpacing": 0, "lineHeight": 1.25, "x": 6, "y": 12, "maxWidth": 68, "color": "{ink}" },
+        { "id": "handle", "type": "text", "content": { "if": "handle", "then": "{handle}", "else": { "join": [["@@", { "lower": "{name}" }], ""] } }, "font": "Inter Tight", "weight": 500, "size": 7, "letterSpacing": 0, "lineHeight": 1.25, "x": 200, "y": 12, "align": "center", "maxWidth": 68, "color": "{ink}" },
+        { "id": "year", "type": "text", "content": "{year}", "when": "year", "font": "Inter Tight", "weight": 500, "size": 7, "letterSpacing": 0, "lineHeight": 1.25, "x": 394, "y": 12, "align": "right", "maxWidth": 68, "color": "{ink}" },
+        { "id": "label", "type": "text", "content": "{label}", "when": "label", "font": "Inter Tight", "weight": 700, "size": 7, "letterSpacing": 0, "lineHeight": 1.25, "x": 6, "y": { "add": ["$midTop", 12] }, "maxWidth": 68, "color": "{ink}" },
+        { "id": "code", "type": "text", "content": "{code}", "when": "code", "font": "Inter Tight", "weight": 500, "size": 7, "letterSpacing": 0, "lineHeight": 1.25, "x": 86, "y": { "add": ["$midTop", 12] }, "maxWidth": 68, "color": "{ink}" },
+        { "id": "coords", "type": "text", "content": "{coords}", "when": "coords", "font": "Inter Tight", "weight": 500, "size": 7, "letterSpacing": 0, "lineHeight": 1.25, "x": 394, "y": { "add": ["$midTop", 12] }, "align": "right", "maxWidth": 68, "color": "{ink}" },
+        {
+          "id": "headline",
+          "type": "text",
+          "content": "{headline}",
+          "transform": "uppercase",
+          "font": "Inter Tight",
+          "weight": 300,
+          "boldWeight": 800,
+          "size": 60,
+          "lineHeight": 0.92,
+          "letterSpacing": -0.035,
+          "fit": "width",
+          "maxWidth": 308,
+          "maxHeight": { "sub": [{ "mul": [{ "sub": ["$rows", { "add": ["$mid", 2] }] }, "$rowH"] }, 12] },
+          "anchor": "bottom-left",
+          "margin": 0,
+          "offset": { "x": 86, "y": { "mul": [-1, { "add": ["$rowH", 6] }] } },
+          "color": "{ink}"
+        },
+        { "id": "credit", "type": "text", "content": { "if": "credit", "then": "{credit}", "else": "Made by {name}" }, "font": "Inter Tight", "weight": 500, "size": 7, "letterSpacing": 0, "lineHeight": 1.25, "x": 6, "y": { "add": ["$footTop", 12] }, "maxWidth": 68, "color": "{ink}" },
+        { "id": "sub", "type": "text", "content": "{sub}", "when": "sub", "font": "Inter Tight", "weight": 600, "size": 10, "letterSpacing": -0.01, "lineHeight": 1.15, "x": 86, "y": { "add": ["$footTop", 13.5] }, "maxWidth": 228, "color": "{ink}" },
+        { "id": "save", "type": "text", "content": "{save}", "when": "save", "font": "Inter Tight", "weight": 500, "size": 7, "letterSpacing": 0, "lineHeight": 1.25, "x": 394, "y": { "add": ["$footTop", 12] }, "align": "right", "maxWidth": 68, "color": "{ink}" }
+      ]
+    },
+    { "id": "print", "type": "grain", "amount": 0.05, "size": 1.5 }
+  ]
+}

package/recipes/flyers/logofolio.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "../../schema/recipe.schema.json",
+  "name": "logofolio",
+  "description": "Logofolio, a collection sheet: a dark ground (or any colour), a small sub-title and a meta line across the top over a hairline, a big title fitted to the width, and the marks on an even grid of square cells, every mark optically sized the same (by its real bounds and how much it inks, not its 512 grid), centred so the margins match; columns and rows come from the count (3 × 3 up to 10 × 7) unless given. An optional footer line and the count sit under a second hairline. Drawn on a 400-wide grid as tall as the canvas, so it sets at 4:5, 1:1 and A-series portrait alike. For presenting a set, or a grid of marks for social.",
+  "requires": ["marks"],
+  "params": {
+    "title": "Logofolio",
+    "subtitle": "Selected work — Logo collection",
+    "meta": "Selected symbols 2020–2026",
+    "marks": [],
+    "cols": 0,
+    "rows": 0,
+    "footer": "",
+    "ground": "#0e0e0f",
+    "ink": "#f2efe8"
+  },
+  "vars": {
+    "h": { "mul": [400, { "div": ["@height", "@width"] }] },
+    "count": { "length": "{marks}" }
+  },
+  "layers": [
+    { "id": "ground", "type": "solid", "color": "{ground}" },
+    {
+      "id": "sheet",
+      "type": "group",
+      "viewBox": [0, 0, 400, "$h"],
+      "fit": "contain",
+      "layers": [
+        { "id": "subtitle", "type": "text", "content": "{subtitle}", "when": "subtitle", "font": "Inter Tight", "weight": 500, "size": 7.5, "letterSpacing": 0, "x": 16, "y": 24, "maxWidth": 200, "maxLines": 1, "color": "{ink}" },
+        { "id": "meta", "type": "text", "content": "{meta}", "when": "meta", "font": "Inter Tight", "weight": 500, "size": 7.5, "letterSpacing": 0, "x": 384, "y": 24, "align": "right", "maxWidth": 160, "maxLines": 1, "color": "{ink}", "opacity": 0.7 },
+        { "id": "rules", "type": "shape", "stroke": "{ink}", "strokeWidth": 0.5, "opacity": 0.35, "items": [
+          { "kind": "line", "x1": 16, "y1": 33, "x2": 384, "y2": 33 },
+          { "kind": "line", "x1": 16, "y1": { "sub": ["$h", 36] }, "x2": 384, "y2": { "sub": ["$h", 36] } }
+        ] },
+        {
+          "id": "title",
+          "type": "text",
+          "content": "{title}",
+          "transform": "uppercase",
+          "font": "Inter Tight",
+          "weight": 800,
+          "size": 60,
+          "lineHeight": 0.92,
+          "letterSpacing": -0.045,
+          "fit": "width",
+          "maxWidth": 368,
+          "maxHeight": 64,
+          "anchor": "top-left",
+          "margin": 0,
+          "offset": { "x": 16, "y": 46 },
+          "color": "{ink}"
+        },
+        { "id": "marks", "type": "marks", "marks": "{marks}", "cols": "{cols}", "rows": "{rows}", "x": 16, "y": 128, "width": 368, "height": { "sub": ["$h", 176] }, "size": 0.42, "color": "{ink}" },
+        { "id": "footer", "type": "text", "content": "{footer}", "when": "footer", "font": "Inter Tight", "weight": 500, "size": 7.5, "letterSpacing": 0, "x": 16, "y": { "sub": ["$h", 18] }, "maxWidth": 260, "maxLines": 1, "color": "{ink}" },
+        { "id": "count", "type": "text", "content": { "join": [["(", "$count", ")"], ""] }, "font": "Inter Tight", "weight": 500, "size": 7.5, "letterSpacing": 0, "x": 384, "y": { "sub": ["$h", 18] }, "align": "right", "color": "{ink}", "opacity": 0.7 }
+      ]
+    },
+    { "id": "print", "type": "grain", "amount": 0.035, "size": 1.5 }
+  ]
+}

package/recipes/flyers/pixel-mosaic.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "../../schema/recipe.schema.json",
+  "name": "pixel-mosaic",
+  "description": "Pixel mosaic poster: a greyscale portrait full-bleed (or a grainy grey field with no photo), the mark enlarged to about 80% of the width and rastered into big square cells in one neon ink (lime by default) that follow the mark's own shape (@logomarks/core's pixelate), the photo showing between the cells and through a seeded few left out, a small asterisk or dot in one empty cell beside it, the name huge and bold across the foot fitted to the width, and a small meta row under it: a ® (or the mark, small), two short labels and a volume, right-aligned. Drawn on a 400-wide grid as tall as the canvas, so it sets at 4:5, 1:1 and 9:16; which cells drop out follows the seed.",
+  "params": {
+    "name": "Kestrel",
+    "labels": ["Visual identity", "Pixel series"],
+    "volume": "Vol. 116",
+    "badge": "®",
+    "neon": "#c8ff2e",
+    "ink": "#ffffff",
+    "cells": 11,
+    "drop": 0.12,
+    "accent": "asterisk"
+  },
+  "vars": {
+    "h": { "mul": [400, { "div": ["@height", "@width"] }] }
+  },
+  "layers": [
+    { "id": "photo", "type": "image", "when": "photo", "src": "{photo}", "fit": "cover", "grayscale": true },
+    { "id": "shade", "type": "linear", "when": "photo", "angle": 180, "colors": ["#000000", "#000000"], "opacities": [0, 0.55] },
+    { "id": "field", "type": "radial", "when": { "not": "photo" }, "colors": ["#6b6b6b", "#3a3a3a", "#141414"], "radius": "100vmax" },
+    { "id": "fieldGrain", "type": "grain", "when": { "not": "photo" }, "amount": 0.18, "vary": "edges" },
+    {
+      "id": "poster",
+      "type": "group",
+      "viewBox": [0, 0, 400, "$h"],
+      "fit": "contain",
+      "layers": [
+        { "id": "mosaic", "type": "mosaic", "when": "mark", "markup": "{mark}", "x": 40, "y": 28, "width": 320, "height": { "sub": ["$h", 164] }, "cells": "{cells}", "drop": "{drop}", "accent": "{accent}", "color": "{neon}" },
+        {
+          "id": "title",
+          "type": "text",
+          "content": "{name}",
+          "transform": "uppercase",
+          "font": "Inter Tight",
+          "weight": 900,
+          "size": 80,
+          "lineHeight": 0.9,
+          "letterSpacing": -0.05,
+          "fit": "width",
+          "maxWidth": 368,
+          "maxHeight": 92,
+          "anchor": "bottom-left",
+          "margin": 0,
+          "offset": { "x": 16, "y": -34 },
+          "color": "{ink}"
+        },
+        { "id": "badge", "type": "text", "when": { "all": ["badge", { "not": { "badge": "mark" } }] }, "content": "{badge}", "font": "Inter Tight", "weight": 600, "size": 9, "letterSpacing": 0, "x": 16, "y": { "sub": ["$h", 16] }, "color": "{ink}" },
+        { "id": "badgeMark", "type": "icon", "when": { "all": ["mark", { "badge": "mark" }] }, "markup": "{mark}", "x": 15, "y": { "sub": ["$h", 25.5] }, "size": 11, "color": "{ink}" },
+        { "id": "label1", "type": "text", "content": "{labels.0}", "when": "labels.0", "transform": "uppercase", "font": "Inter Tight", "weight": 600, "size": 6.5, "letterSpacing": 0.04, "x": 108, "y": { "sub": ["$h", 16] }, "maxWidth": 86, "maxLines": 1, "color": "{ink}" },
+        { "id": "label2", "type": "text", "content": "{labels.1}", "when": "labels.1", "transform": "uppercase", "font": "Inter Tight", "weight": 600, "size": 6.5, "letterSpacing": 0.04, "x": 200, "y": { "sub": ["$h", 16] }, "maxWidth": 86, "maxLines": 1, "color": "{ink}" },
+        { "id": "volume", "type": "text", "content": "{volume}", "when": "volume", "transform": "uppercase", "font": "Inter Tight", "weight": 600, "size": 6.5, "letterSpacing": 0.04, "x": 384, "y": { "sub": ["$h", 16] }, "align": "right", "maxWidth": 86, "maxLines": 1, "color": "{ink}" }
+      ]
+    },
+    { "id": "print", "type": "grain", "amount": 0.05, "size": 1.5 }
+  ]
+}

package/schema/recipe.schema.json

@@ -370,6 +370,45 @@
             }
           }
         },
+        {
+          "type": "object",
+          "description": "To the nearest whole number.",
+          "required": [
+            "round"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "round": {
+              "$ref": "#/$defs/value"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "description": "Down to a whole number.",
+          "required": [
+            "floor"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "floor": {
+              "$ref": "#/$defs/value"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "description": "Up to a whole number.",
+          "required": [
+            "ceil"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "ceil": {
+              "$ref": "#/$defs/value"
+            }
+          }
+        },
         {
           "type": "object",
           "description": "[from, to, steps, amount?]: steps colours from one toward the other.",
@@ -4838,7 +4877,9 @@
             "barcode",
             "perforation",
             "tear",
-            "texture"
+            "texture",
+            "mosaic",
+            "marks"
           ]
         },
         "id": {
@@ -5682,7 +5723,7 @@
               },
               "divisions": {
                 "$ref": "#/$defs/value",
-                "description": "Grid/lines: N equal cells (inner lines only) instead of size."
+                "description": "Grid/lines: N equal cells (inner lines only) instead of size; [cols, rows] for a design grid."
               },
               "gaps": {
                 "$ref": "#/$defs/value",
@@ -6056,7 +6097,7 @@
             "properties": {
               "content": {
                 "$ref": "#/$defs/value",
-                "description": "The text (\"{title}\")."
+                "description": "The text (\"{title}\"); an array is a line per item, an item may be a span ({ content, bold })."
               },
               "font": {
                 "$ref": "#/$defs/value",
@@ -6066,6 +6107,10 @@
                 "$ref": "#/$defs/value",
                 "description": "Default 600."
               },
+              "boldWeight": {
+                "$ref": "#/$defs/value",
+                "description": "The weight of spans and lines marked bold: true. Default 700."
+              },
               "style": {
                 "$ref": "#/$defs/value",
                 "description": "normal | italic"
@@ -6220,7 +6265,7 @@
               },
               "spans": {
                 "$ref": "#/$defs/value",
-                "description": "[{ content, font, weight, style, axes, scale, size, color, letterSpacing, dy }]: mixed runs on the same lines."
+                "description": "[{ content, font, weight, bold, style, axes, scale, size, color, letterSpacing, dy }]: mixed runs on the same lines."
               },
               "glyphs": {
                 "$ref": "#/$defs/value",
@@ -6291,6 +6336,7 @@
                 "content",
                 "font",
                 "weight",
+                "boldWeight",
                 "style",
                 "size",
                 "minSize",
@@ -9082,6 +9128,262 @@
               ]
             }
           }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "mosaic"
+              }
+            },
+            "required": [
+              "type"
+            ]
+          },
+          "then": {
+            "properties": {
+              "markup": {
+                "$ref": "#/$defs/value",
+                "description": "The mark's paths (512 grid)."
+              },
+              "x": {
+                "$ref": "#/$defs/value",
+                "description": "Box x, px or %."
+              },
+              "y": {
+                "$ref": "#/$defs/value",
+                "description": "Box y."
+              },
+              "width": {
+                "$ref": "#/$defs/value",
+                "description": "Box width (default the canvas)."
+              },
+              "height": {
+                "$ref": "#/$defs/value",
+                "description": "Box height."
+              },
+              "cells": {
+                "$ref": "#/$defs/value",
+                "description": "Cells across the mark's longest side, 4–48. Default 10."
+              },
+              "gap": {
+                "$ref": "#/$defs/value",
+                "description": "Gap between cells, a share of a cell. Default 0.12."
+              },
+              "radius": {
+                "$ref": "#/$defs/value",
+                "description": "Cell corner radius, a share of a cell. Default 0."
+              },
+              "drop": {
+                "$ref": "#/$defs/value",
+                "description": "Share of filled cells left out (seeded), 0–0.9. Default 0.12."
+              },
+              "color": {
+                "$ref": "#/$defs/value",
+                "description": "Default @accent."
+              },
+              "accent": {
+                "$ref": "#/$defs/value",
+                "description": "asterisk | dot: a small glyph in one empty cell beside the mark."
+              },
+              "accentColor": {
+                "$ref": "#/$defs/value",
+                "description": "Default color."
+              },
+              "opacity": {
+                "$ref": "#/$defs/value",
+                "description": "0–1."
+              },
+              "blend": {
+                "$ref": "#/$defs/value",
+                "description": "A CSS mix-blend-mode."
+              },
+              "seed": {
+                "$ref": "#/$defs/value",
+                "description": "This layer's own random stream."
+              },
+              "transform": {
+                "$ref": "#/$defs/value",
+                "description": "{ translate, rotate, scale, skewX, skewY, mirror: x | y, origin } (on text, a case keyword is still the case)."
+              },
+              "effects": {
+                "$ref": "#/$defs/effects",
+                "description": "[{ kind, mask, colorSpace, … }]: filters, pixel effects and copies, in order (see docs/effects.md; kinds in EFFECTS)."
+              },
+              "mask": {
+                "$ref": "#/$defs/value",
+                "description": "Layers whose luminance masks this one (white shows)."
+              },
+              "knockout": {
+                "$ref": "#/$defs/value",
+                "description": "Layers cut out of this one."
+              },
+              "clip": {
+                "$ref": "#/$defs/value",
+                "description": "Layers this one shows only inside."
+              },
+              "area": {
+                "$ref": "#/$defs/value",
+                "description": "trim | safe | bleed, or { x, y, width, height } fractions: draw the layer in that box."
+              },
+              "motion": {
+                "$ref": "#/$defs/motion",
+                "description": "A motion, a preset name (drift | spin | breathe | blink | marquee), or a list: plays in the SVG as CSS keyframes (see MOTION_OPTIONS)."
+              }
+            },
+            "propertyNames": {
+              "enum": [
+                "type",
+                "id",
+                "when",
+                "markup",
+                "x",
+                "y",
+                "width",
+                "height",
+                "cells",
+                "gap",
+                "radius",
+                "drop",
+                "color",
+                "accent",
+                "accentColor",
+                "opacity",
+                "blend",
+                "seed",
+                "transform",
+                "effects",
+                "mask",
+                "knockout",
+                "clip",
+                "area",
+                "motion"
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "marks"
+              }
+            },
+            "required": [
+              "type"
+            ]
+          },
+          "then": {
+            "properties": {
+              "marks": {
+                "$ref": "#/$defs/value",
+                "description": "The marks: paths on a 512 grid (or { markup })."
+              },
+              "cols": {
+                "$ref": "#/$defs/value",
+                "description": "Default from the count: 3 × 3 up to 10 × 7."
+              },
+              "rows": {
+                "$ref": "#/$defs/value",
+                "description": "Default from the count."
+              },
+              "x": {
+                "$ref": "#/$defs/value",
+                "description": "Box x, px or %."
+              },
+              "y": {
+                "$ref": "#/$defs/value",
+                "description": "Box y."
+              },
+              "width": {
+                "$ref": "#/$defs/value",
+                "description": "Box width (default the canvas)."
+              },
+              "height": {
+                "$ref": "#/$defs/value",
+                "description": "Box height."
+              },
+              "size": {
+                "$ref": "#/$defs/value",
+                "description": "Share of a cell a mark's area takes. Default 0.5."
+              },
+              "optical": {
+                "$ref": "#/$defs/value",
+                "description": "false: fit each mark's bounds to the same box instead. Default true."
+              },
+              "color": {
+                "$ref": "#/$defs/value",
+                "description": "Default @text."
+              },
+              "opacity": {
+                "$ref": "#/$defs/value",
+                "description": "0–1."
+              },
+              "blend": {
+                "$ref": "#/$defs/value",
+                "description": "A CSS mix-blend-mode."
+              },
+              "seed": {
+                "$ref": "#/$defs/value",
+                "description": "This layer's own random stream."
+              },
+              "transform": {
+                "$ref": "#/$defs/value",
+                "description": "{ translate, rotate, scale, skewX, skewY, mirror: x | y, origin } (on text, a case keyword is still the case)."
+              },
+              "effects": {
+                "$ref": "#/$defs/effects",
+                "description": "[{ kind, mask, colorSpace, … }]: filters, pixel effects and copies, in order (see docs/effects.md; kinds in EFFECTS)."
+              },
+              "mask": {
+                "$ref": "#/$defs/value",
+                "description": "Layers whose luminance masks this one (white shows)."
+              },
+              "knockout": {
+                "$ref": "#/$defs/value",
+                "description": "Layers cut out of this one."
+              },
+              "clip": {
+                "$ref": "#/$defs/value",
+                "description": "Layers this one shows only inside."
+              },
+              "area": {
+                "$ref": "#/$defs/value",
+                "description": "trim | safe | bleed, or { x, y, width, height } fractions: draw the layer in that box."
+              },
+              "motion": {
+                "$ref": "#/$defs/motion",
+                "description": "A motion, a preset name (drift | spin | breathe | blink | marquee), or a list: plays in the SVG as CSS keyframes (see MOTION_OPTIONS)."
+              }
+            },
+            "propertyNames": {
+              "enum": [
+                "type",
+                "id",
+                "when",
+                "marks",
+                "cols",
+                "rows",
+                "x",
+                "y",
+                "width",
+                "height",
+                "size",
+                "optical",
+                "color",
+                "opacity",
+                "blend",
+                "seed",
+                "transform",
+                "effects",
+                "mask",
+                "knockout",
+                "clip",
+                "area",
+                "motion"
+              ]
+            }
+          }
         }
       ]
     }