@arraypress/covers 1.4.0 → 1.5.1

package/schema/recipe.schema.json

@@ -709,6 +709,7 @@
             "pinch",
             "fisheye",
             "glass",
+            "fluted",
             "displace",
             "kaleidoscope",
             "mirror",
@@ -737,6 +738,7 @@
             "crt",
             "vhs",
             "jpeg",
+            "print",
             "newsprint",
             "chromatic",
             "rgbSplit",
@@ -2589,6 +2591,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 +4226,97 @@
             }
           }
         },
+        {
+          "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": {
@@ -4879,7 +5063,9 @@
             "tear",
             "texture",
             "mosaic",
-            "marks"
+            "marks",
+            "outline",
+            "construction"
           ]
         },
         "id": {
@@ -9384,6 +9570,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';
@@ -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

@@ -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). */

package/src/layers/construction.d.ts

@@ -0,0 +1,34 @@
+// The `construction` layer.
+import type { Color, Length, BaseLayer } from '../index.js';
+import type { RenderContext, Markup } from '../render/context.js';
+
+export interface ConstructionLayer extends BaseLayer {
+  type: 'construction';
+  /** The mark's paths, on a 512 grid. */
+  markup: string;
+  /** The box the sheet fills (default the canvas); the mark is centred in it. */
+  x?: Length | `${number}%`; y?: Length | `${number}%`; width?: Length | `${number}%`; height?: Length | `${number}%`;
+  /** The share of the box's shorter side the mark's longest side takes. Default 0.6. */
+  size?: number;
+  /** Grid cells across the mark's longest side; 0 none. Default 8. */
+  grid?: number;
+  /** The most circles read from its curves. Default 6. */
+  circles?: number;
+  /** The most lines read from its straight edges. Default 6. */
+  lines?: number;
+  /** The guides. Default the palette's accent. */
+  color?: Color;
+  /** Default `color`. */
+  gridColor?: Color;
+  /** Default 0.3. */
+  gridOpacity?: number;
+  /** Default the palette's text; `'none'` leaves the mark out. */
+  markColor?: Color | 'none';
+  /** The guides' opacity over the mark, 0–1. Default 0.4. */
+  over?: number;
+  /** Guide width. Default `'0.15vmin'`. */
+  stroke?: Length;
+}
+
+/** Draw a mark over its own construction: grid, box, centre cross, its circles and lines. */
+export function construction(layer: ConstructionLayer, ctx: RenderContext): Markup;