@arraypress/covers 1.4.0 → 1.6.1

package/schema/recipe.schema.json

@@ -709,6 +709,7 @@
             "pinch",
             "fisheye",
             "glass",
+            "fluted",
             "displace",
             "kaleidoscope",
             "mirror",
@@ -737,6 +738,8 @@
             "crt",
             "vhs",
             "jpeg",
+            "print",
+            "halftoneFade",
             "newsprint",
             "chromatic",
             "rgbSplit",
@@ -2589,6 +2592,97 @@
             }
           }
         },
+        {
+          "if": {
+            "properties": {
+              "kind": {
+                "const": "fluted"
+              }
+            },
+            "required": [
+              "kind"
+            ]
+          },
+          "then": {
+            "properties": {
+              "preset": {
+                "$ref": "#/$defs/value",
+                "description": "fluted (default) | reeded-soft | reeded-deep | reeded-prism"
+              },
+              "profile": {
+                "$ref": "#/$defs/value",
+                "description": "concave (flutes: squeezed upright, legible) | convex (reeds: turned over)"
+              },
+              "ribs": {
+                "$ref": "#/$defs/value",
+                "description": "Count across the frame."
+              },
+              "width": {
+                "$ref": "#/$defs/value",
+                "description": "Length: each rib (wins over ribs)."
+              },
+              "refraction": {
+                "$ref": "#/$defs/value",
+                "description": "How strongly each rib bends what is behind it: how far its edge looks, in rib widths (about 1 legible; convex past 2: deep)."
+              },
+              "stretch": {
+                "$ref": "#/$defs/value",
+                "description": "Length: the defocus, smeared along the ribs (a little across), mostly at rib edges."
+              },
+              "chroma": {
+                "$ref": "#/$defs/value",
+                "description": "0–1+: colours parted where bright content meets a rib edge."
+              },
+              "ridge": {
+                "$ref": "#/$defs/value",
+                "description": "0–1: a specular kiss down each rib, only over bright content (about 0.1)."
+              },
+              "grain": {
+                "$ref": "#/$defs/value",
+                "description": "0–1."
+              },
+              "angle": {
+                "$ref": "#/$defs/value",
+                "description": "Degrees (0: upright ribs, 90: level)."
+              },
+              "seed": {
+                "$ref": "#/$defs/value",
+                "description": "Number or string."
+              },
+              "mask": {
+                "$ref": "#/$defs/value",
+                "description": "{ gradient: linear | radial | band, from, to, center, angle, aspect, invert, ease } or { layers, invert }: where the effect applies."
+              },
+              "colorSpace": {
+                "$ref": "#/$defs/value",
+                "description": "sRGB (default) | linearRGB: where filter primitives do their arithmetic."
+              },
+              "pad": {
+                "$ref": "#/$defs/value",
+                "description": "Filter region padding, a fraction of the canvas."
+              }
+            },
+            "propertyNames": {
+              "enum": [
+                "preset",
+                "profile",
+                "ribs",
+                "width",
+                "refraction",
+                "stretch",
+                "chroma",
+                "ridge",
+                "grain",
+                "angle",
+                "seed",
+                "kind",
+                "mask",
+                "colorSpace",
+                "pad"
+              ]
+            }
+          }
+        },
         {
           "if": {
             "properties": {
@@ -4133,6 +4227,188 @@
             }
           }
         },
+        {
+          "if": {
+            "properties": {
+              "kind": {
+                "const": "print"
+              }
+            },
+            "required": [
+              "kind"
+            ]
+          },
+          "then": {
+            "properties": {
+              "finish": {
+                "$ref": "#/$defs/value",
+                "description": "letterpress (default) | riso | stamp"
+              },
+              "amount": {
+                "$ref": "#/$defs/value",
+                "description": "0–1+: scales breakup, specks, uneven, squeeze and grain. Default 1."
+              },
+              "rough": {
+                "$ref": "#/$defs/value",
+                "description": "Length: edge wobble."
+              },
+              "edge": {
+                "$ref": "#/$defs/value",
+                "description": "Length: how far in from the outline ink breaks up."
+              },
+              "breakup": {
+                "$ref": "#/$defs/value",
+                "description": "0–1."
+              },
+              "specks": {
+                "$ref": "#/$defs/value",
+                "description": "0–1: holes in the body."
+              },
+              "size": {
+                "$ref": "#/$defs/value",
+                "description": "Length: the speck and breakup scale."
+              },
+              "uneven": {
+                "$ref": "#/$defs/value",
+                "description": "0–1: coverage."
+              },
+              "squeeze": {
+                "$ref": "#/$defs/value",
+                "description": "0–1: a denser rim."
+              },
+              "grain": {
+                "$ref": "#/$defs/value",
+                "description": "0–1."
+              },
+              "seed": {
+                "$ref": "#/$defs/value",
+                "description": "Number."
+              },
+              "mask": {
+                "$ref": "#/$defs/value",
+                "description": "{ gradient: linear | radial | band, from, to, center, angle, aspect, invert, ease } or { layers, invert }: where the effect applies."
+              },
+              "colorSpace": {
+                "$ref": "#/$defs/value",
+                "description": "sRGB (default) | linearRGB: where filter primitives do their arithmetic."
+              },
+              "pad": {
+                "$ref": "#/$defs/value",
+                "description": "Filter region padding, a fraction of the canvas."
+              }
+            },
+            "propertyNames": {
+              "enum": [
+                "finish",
+                "amount",
+                "rough",
+                "edge",
+                "breakup",
+                "specks",
+                "size",
+                "uneven",
+                "squeeze",
+                "grain",
+                "seed",
+                "kind",
+                "mask",
+                "colorSpace",
+                "pad"
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "kind": {
+                "const": "halftoneFade"
+              }
+            },
+            "required": [
+              "kind"
+            ]
+          },
+          "then": {
+            "properties": {
+              "color": {
+                "$ref": "#/$defs/value",
+                "description": "The dots: a colour, none (they erase), or the colour round the edge (default)."
+              },
+              "direction": {
+                "$ref": "#/$defs/value",
+                "description": "up (default: dissolves from the bottom) | down | left | right | radial (from the edges in)"
+              },
+              "angle": {
+                "$ref": "#/$defs/value",
+                "description": "Degrees the dissolve travels (0 along x, 90 down); wins over direction."
+              },
+              "start": {
+                "$ref": "#/$defs/value",
+                "description": "0–1 along the fade: where the dots begin. Default 0.45."
+              },
+              "end": {
+                "$ref": "#/$defs/value",
+                "description": "0–1: where they have merged into solid. Default 0.92."
+              },
+              "curve": {
+                "$ref": "#/$defs/value",
+                "description": "linear (default) | ease-in | ease-out | smooth"
+              },
+              "cell": {
+                "$ref": "#/$defs/value",
+                "description": "Length: the dot pitch. Default \"2.2vmin\"."
+              },
+              "grid": {
+                "$ref": "#/$defs/value",
+                "description": "diamond (default, a 45° screen) | square"
+              },
+              "shape": {
+                "$ref": "#/$defs/value",
+                "description": "dot (default) | square | diamond"
+              },
+              "jitter": {
+                "$ref": "#/$defs/value",
+                "description": "0–1: dot sizes varied, a few strays above start."
+              },
+              "seed": {
+                "$ref": "#/$defs/value",
+                "description": "Number or string."
+              },
+              "mask": {
+                "$ref": "#/$defs/value",
+                "description": "{ gradient: linear | radial | band, from, to, center, angle, aspect, invert, ease } or { layers, invert }: where the effect applies."
+              },
+              "colorSpace": {
+                "$ref": "#/$defs/value",
+                "description": "sRGB (default) | linearRGB: where filter primitives do their arithmetic."
+              },
+              "pad": {
+                "$ref": "#/$defs/value",
+                "description": "Filter region padding, a fraction of the canvas."
+              }
+            },
+            "propertyNames": {
+              "enum": [
+                "color",
+                "direction",
+                "angle",
+                "start",
+                "end",
+                "curve",
+                "cell",
+                "grid",
+                "shape",
+                "jitter",
+                "seed",
+                "kind",
+                "mask",
+                "colorSpace",
+                "pad"
+              ]
+            }
+          }
+        },
         {
           "if": {
             "properties": {
@@ -4879,7 +5155,9 @@
             "tear",
             "texture",
             "mosaic",
-            "marks"
+            "marks",
+            "outline",
+            "construction"
           ]
         },
         "id": {
@@ -5476,7 +5754,7 @@
               },
               "focus": {
                 "$ref": "#/$defs/value",
-                "description": "An anchor, attention or entropy."
+                "description": "An anchor, attention or entropy; [x, y] (0–1 in the photo) to centre that point; subject: a cut-out's head centred across, its top at the box's top."
               },
               "region": {
                 "$ref": "#/$defs/value",
@@ -9384,6 +9662,282 @@
               ]
             }
           }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "outline"
+              }
+            },
+            "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."
+              },
+              "size": {
+                "$ref": "#/$defs/value",
+                "description": "Share of the box's shorter side the whole takes. Default 1."
+              },
+              "lines": {
+                "$ref": "#/$defs/value",
+                "description": "Contour lines, 0–8: the outline and more round it (0: the mark solid). Default 4."
+              },
+              "gap": {
+                "$ref": "#/$defs/value",
+                "description": "Between lines, a share of the mark's longest side. Default 0.05."
+              },
+              "direction": {
+                "$ref": "#/$defs/value",
+                "description": "out (default) | in"
+              },
+              "stroke": {
+                "$ref": "#/$defs/value",
+                "description": "Line width. Default \"0.4vmin\"."
+              },
+              "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",
+                "markup",
+                "x",
+                "y",
+                "width",
+                "height",
+                "size",
+                "lines",
+                "gap",
+                "direction",
+                "stroke",
+                "color",
+                "opacity",
+                "blend",
+                "seed",
+                "transform",
+                "effects",
+                "mask",
+                "knockout",
+                "clip",
+                "area",
+                "motion"
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "construction"
+              }
+            },
+            "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."
+              },
+              "size": {
+                "$ref": "#/$defs/value",
+                "description": "Share of the box's shorter side the mark's longest side takes. Default 0.6."
+              },
+              "grid": {
+                "$ref": "#/$defs/value",
+                "description": "Grid cells across the mark's longest side; 0 none. Default 8."
+              },
+              "circles": {
+                "$ref": "#/$defs/value",
+                "description": "The most circles read from its curves. Default 6."
+              },
+              "lines": {
+                "$ref": "#/$defs/value",
+                "description": "The most lines read from its straight edges. Default 6."
+              },
+              "color": {
+                "$ref": "#/$defs/value",
+                "description": "The guides. Default @accent."
+              },
+              "gridColor": {
+                "$ref": "#/$defs/value",
+                "description": "Default color."
+              },
+              "gridOpacity": {
+                "$ref": "#/$defs/value",
+                "description": "Default 0.3."
+              },
+              "markColor": {
+                "$ref": "#/$defs/value",
+                "description": "Default @text; \"none\" leaves the mark out."
+              },
+              "over": {
+                "$ref": "#/$defs/value",
+                "description": "The guides' opacity over the mark, 0–1. Default 0.4."
+              },
+              "stroke": {
+                "$ref": "#/$defs/value",
+                "description": "Guide width. Default \"0.15vmin\"."
+              },
+              "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",
+                "size",
+                "grid",
+                "circles",
+                "lines",
+                "color",
+                "gridColor",
+                "gridOpacity",
+                "markColor",
+                "over",
+                "stroke",
+                "opacity",
+                "blend",
+                "seed",
+                "transform",
+                "effects",
+                "mask",
+                "knockout",
+                "clip",
+                "area",
+                "motion"
+              ]
+            }
+          }
         }
       ]
     }

package/src/index.d.ts

@@ -14,12 +14,12 @@ import type { RepeatLayer } from './layers/repeat.js';
 import type { TextSpan } from './type/spans.js';
 import type { GlyphControl } from './type/glyphs.js';
 import type { Cut } from './formats/cut.js';
-import type { ShapeLayer, SvgLayer, TableLayer, BarcodeLayer, PerforationLayer, TearLayer, TextureLayer, MosaicLayer, MarksLayer } from './layers/index.js';
+import type { ShapeLayer, SvgLayer, TableLayer, BarcodeLayer, PerforationLayer, TearLayer, TextureLayer, MosaicLayer, MarksLayer, OutlineLayer, ConstructionLayer } from './layers/index.js';
 import type { Zones, PrintInfo, FormatName } from './formats/index.js';
 import type { Motion, MotionPreset, Easing } from './animate/index.js';
 
 export type { RepeatLayer, DefsLayer, UseLayer, TextSpan, GlyphControl, Cut, Motion, MotionPreset, Easing };
-export type { Color, Length, Rng, LayerTransform, EffectKind, Paint, TextPath, GroupLayer, ShapeLayer, SvgLayer, TableLayer, BarcodeLayer, PerforationLayer, TearLayer, TextureLayer, MosaicLayer, MarksLayer, Zones, PrintInfo, FormatName };
+export type { Color, Length, Rng, LayerTransform, EffectKind, Paint, TextPath, GroupLayer, ShapeLayer, SvgLayer, TableLayer, BarcodeLayer, PerforationLayer, TearLayer, TextureLayer, MosaicLayer, MarksLayer, OutlineLayer, ConstructionLayer, Zones, PrintInfo, FormatName };
 export type { ShapeSpec, TableCell } from './layers/index.js';
 export type { Format } from './formats/index.js';
 export type { LintIssue } from './lint/index.js';
@@ -259,8 +259,8 @@ export interface ImageLayer extends BaseLayer {
   y?: Length | `${number}%`;
   width?: Length | `${number}%`;
   height?: Length | `${number}%`;
-  /** Crop focus: an anchor, or (with sharp) `'attention'` / `'entropy'`. Default `'center'`. */
-  focus?: Anchor | 'attention' | 'entropy';
+  /** Crop focus: an anchor, or (with sharp) `'attention'` / `'entropy'`; or (with sharp) a point centred in the box, `[x, y]` 0–1 in the photo, or `'subject'`, a cut-out's head centred across with its top at the box's top. Default `'center'`. */
+  focus?: Anchor | 'attention' | 'entropy' | 'subject' | [number, number];
   /** Default the whole canvas. */
   region?: Region;
   /** Map tones to two colours (shadows, highlights); `true` derives them from the palette. */
@@ -720,7 +720,7 @@ export interface RuleLayer extends BaseLayer {
 }
 
 export type Layer =
-  | GroupLayer | ShapeLayer | SvgLayer | TableLayer | BarcodeLayer | PerforationLayer | TearLayer | TextureLayer | MosaicLayer | MarksLayer
+  | GroupLayer | ShapeLayer | SvgLayer | TableLayer | BarcodeLayer | PerforationLayer | TearLayer | TextureLayer | MosaicLayer | MarksLayer | OutlineLayer | ConstructionLayer
   | InkLayer | DitherLayer | ContourLayer | WaveformLayer | TilesLayer | RuleLayer
   | DiagramLayer | PaperLayer | ScribbleLayer
   | SolidLayer | LinearLayer | RadialLayer | MeshLayer | StripesLayer | ImageLayer

package/src/layer-options.js

@@ -14,7 +14,7 @@ export const LAYER_OPTIONS = {
   radial: { colors: 'Centre → edge.', x: 'Centre x, 0–1.', y: 'Centre y, 0–1.', radius: 'Length. Default "80vmax".', ease: 'Default true.' },
   mesh: { colors: 'Blob colours.', hues: 'Distinct colours to use. Default 3.', hueSpan: 'Keep the colours within this many degrees of hue (OKLCH): neighbouring hues only.', count: 'Blobs. Default 4.', blur: 'Length. Default "11vmax".', spread: '0–1. Default 1 (sweep), 0.7 (ring).', size: '[min, max] radius, fractions of the longer side.', base: 'Fill under the fields: "auto" (a gradient across the sweep between the first two colours; default), "bg", a colour, or null.', arrangement: 'sweep (default: long fields along one direction) | ring', angle: 'Sweep direction in degrees. Default seeded.', streak: 'How much more the sweep blurs along than across. Default 1.5.', tone: '{ l: [min, max], c: [min, max] }: pull colours into an OKLCH band.', fold: 'true or { color, to, position, bend, softness, sheen }: a second field meeting the first along a soft curve.', streaks: 'Thin light motion streaks along the sweep. Default 0.', from: 'A photo (path or bytes) to take the colours from (needs sharp).', blobs: 'Explicit [{ x, y, r, squash, rotate, color, opacity }].' },
   stripes: { direction: 'vertical | horizontal | diagonal', angle: 'For diagonal.', count: 'Stripes. Default 8.', widths: 'even | random | taper | [weights]', taper: 'Ratio for widths: taper.', colors: 'Cycled.', gap: 'Length.', radius: 'Length.', region: '{ x, y, width, height } fractions.', regionRadius: 'Length.' },
-  image: { x: 'Box left, px or "%" (with y, width, height: an explicit box instead of region).', y: 'Box top.', width: 'Box width.', height: 'Box height.', src: 'A local path, data: URI, URL (where allowed) or bytes ("{image}").', fit: 'cover | contain | stretch', focus: 'An anchor, attention or entropy.', region: 'Fractions.', duotone: 'true or [shadow, highlight].', grayscale: 'boolean', normalize: 'Stretch tones first.', tint: 'A colour or { color, amount, blend }.', blur: 'Length.' },
+  image: { x: 'Box left, px or "%" (with y, width, height: an explicit box instead of region).', y: 'Box top.', width: 'Box width.', height: 'Box height.', src: 'A local path, data: URI, URL (where allowed) or bytes ("{image}").', fit: 'cover | contain | stretch', focus: 'An anchor, attention or entropy; [x, y] (0–1 in the photo) to centre that point; subject: a cut-out\'s head centred across, its top at the box\'s top.', region: 'Fractions.', duotone: 'true or [shadow, highlight].', grayscale: 'boolean', normalize: 'Stretch tones first.', tint: 'A colour or { color, amount, blend }.', blur: 'Length.' },
   grain: { amount: '0–1. Default 0.08.', size: 'Grain px. Default 1.', monochrome: 'Default true.', vary: '"edges": heavier toward the edges (spray paint).' },
   pattern: { kind: 'grid | dots | lines | rings | waves', size: 'Cell. Length.', stroke: 'Length.', color: 'Default @text.', angle: 'For lines.', center: '{ x, y } fractions.', wavelength: 'Length.', amplitude: 'Length.', fade: 'none | radial | edges | top | bottom | left | right', dash: 'dotted | dashed | [on, off] lengths.', divisions: 'Grid/lines: N equal cells (inner lines only) instead of size; [cols, rows] for a design grid.', gaps: '[{ x, y, width, height }] fractions the lines break around.', region: 'Fractions.' },
   shapes: { kind: 'circle | square | pill | mixed', count: 'Default 6.', size: '[min, max] lengths.', colors: 'Cycled.', placement: 'scatter | row | column', items: '[{ kind, x, y, size, color, rotate, opacity }]', region: 'Fractions.', rotate: 'Tilt squares and pills.', radius: 'Square corner, fraction of size.', outline: 'true or a width.' },
@@ -45,6 +45,8 @@ export const LAYER_OPTIONS = {
   texture: { kind: 'paper | creases | concrete | speck | wood | folds | dust', color: 'Fibre, aggregate or dust colour.', amount: 'Paper: fibre density.', frequency: 'Noise frequency (number or [x, y]).', octaves: 'Noise octaves.', depth: 'Creases: relief.', azimuth: 'Creases: light direction.', elevation: 'Creases: light height.', x: 'Folds: vertical fold positions, fractions.', y: 'Folds: horizontal fold positions, fractions.', width: 'Folds: band width.', strength: 'Folds: shading.', count: 'Dust: specks.', size: 'Dust: [min, max] radius.', region: 'Clip to { x, y, width, height } (px or "%").' },
   mosaic: { markup: 'The mark\'s paths (512 grid).', x: 'Box x, px or %.', y: 'Box y.', width: 'Box width (default the canvas).', height: 'Box height.', cells: 'Cells across the mark\'s longest side, 4–48. Default 10.', gap: 'Gap between cells, a share of a cell. Default 0.12.', radius: 'Cell corner radius, a share of a cell. Default 0.', drop: 'Share of filled cells left out (seeded), 0–0.9. Default 0.12.', color: 'Default @accent.', accent: 'asterisk | dot: a small glyph in one empty cell beside the mark.', accentColor: 'Default color.' },
   marks: { marks: 'The marks: paths on a 512 grid (or { markup }).', cols: 'Default from the count: 3 × 3 up to 10 × 7.', rows: 'Default from the count.', x: 'Box x, px or %.', y: 'Box y.', width: 'Box width (default the canvas).', height: 'Box height.', size: 'Share of a cell a mark\'s area takes. Default 0.5.', optical: 'false: fit each mark\'s bounds to the same box instead. Default true.', color: 'Default @text.' },
+  outline: { markup: 'The mark\'s paths (512 grid).', x: 'Box x, px or %.', y: 'Box y.', width: 'Box width (default the canvas).', height: 'Box height.', size: 'Share of the box\'s shorter side the whole takes. Default 1.', lines: 'Contour lines, 0–8: the outline and more round it (0: the mark solid). Default 4.', gap: 'Between lines, a share of the mark\'s longest side. Default 0.05.', direction: 'out (default) | in', stroke: 'Line width. Default "0.4vmin".', color: 'Default @text.' },
+  construction: { markup: 'The mark\'s paths (512 grid).', x: 'Box x, px or %.', y: 'Box y.', width: 'Box width (default the canvas).', height: 'Box height.', size: 'Share of the box\'s shorter side the mark\'s longest side takes. Default 0.6.', grid: 'Grid cells across the mark\'s longest side; 0 none. Default 8.', circles: 'The most circles read from its curves. Default 6.', lines: 'The most lines read from its straight edges. Default 6.', color: 'The guides. Default @accent.', gridColor: 'Default color.', gridOpacity: 'Default 0.3.', markColor: 'Default @text; "none" leaves the mark out.', over: 'The guides\' opacity over the mark, 0–1. Default 0.4.', stroke: 'Guide width. Default "0.15vmin".' },
 };
 
 /** @type {Record<string, string>} Options every layer takes (besides type, id and when). */