@kensio/colophon 2.11.0 → 2.12.0

package/dist/texture/pattern.js

@@ -1,21 +1,16 @@
-/** Used where the palette did not supply one, so a texture always draws. */
-const fallbackColor = "#ffffff";
+import { fallbackColor } from "./color.js";
+import { tile } from "./tile.js";
 const dotDefaults = { opacity: 0.08, size: 5, gap: 44 };
 const ruleDefaults = { opacity: 0.06, width: 2, gap: 28, angle: 45 };
+const crossDefaults = { opacity: 0.09, size: 9, width: 1.5, gap: 48 };
 /**
- * A tiled pattern over the whole image: the `<pattern>` under the given `id`,
- * and the rect that fills with it.
+ * How much fainter the crossing set of rules is than the first.
+ *
+ * The same figure the two sets of rings in `waves` use, and for the same
+ * reason: two sets at one opacity read as two sets, and dropping one of them
+ * is what turns the crossings into a surface with a weave to it.
  */
-function tile(id, gap, contents, transform, dimensions, opacity) {
-    const { width, height } = dimensions;
-    const size = String(gap);
-    return (`<defs>` +
-        `<pattern id="${id}" width="${size}" height="${size}"` +
-        ` patternUnits="userSpaceOnUse"${transform}>${contents}</pattern>` +
-        `</defs>` +
-        `<rect width="${String(width)}" height="${String(height)}"` +
-        ` fill="url(#${id})" opacity="${String(opacity)}"/>`);
-}
+const crossScale = 0.65;
 /** A grid of dots, one to a tile. */
 export function dotsSvg(texture, dimensions, id) {
     const gap = texture.gap ?? dotDefaults.gap;
@@ -25,6 +20,25 @@ export function dotsSvg(texture, dimensions, id) {
         ` fill="${texture.color ?? fallbackColor}"/>`;
     return tile(id, gap, dot, "", dimensions, texture.opacity ?? dotDefaults.opacity);
 }
+/**
+ * A small cross where each line of a grid would meet, one to a tile.
+ *
+ * It is the dot grid with a little more to look at, and it costs the same: the
+ * mark is two strokes rather than a fill, and the tile is square to the image
+ * either way.
+ */
+export function crossesSvg(texture, dimensions, id) {
+    const gap = texture.gap ?? crossDefaults.gap;
+    const centre = gap / 2;
+    const arm = (texture.size ?? crossDefaults.size) / 2;
+    const from = String(centre - arm);
+    const to = String(centre + arm);
+    const cross = `<path d="M${from} ${String(centre)}H${to}M${String(centre)} ${from}V${to}"` +
+        ` stroke="${texture.color ?? fallbackColor}"` +
+        ` stroke-width="${String(texture.width ?? crossDefaults.width)}"` +
+        ` fill="none"/>`;
+    return tile(id, gap, cross, "", dimensions, texture.opacity ?? crossDefaults.opacity);
+}
 /**
  * Ruled lines, one to a tile, rotated as a set.
  *
@@ -40,6 +54,14 @@ export function rulesSvg(texture, dimensions, id) {
         ` stroke="${texture.color ?? fallbackColor}"` +
         ` stroke-width="${String(texture.width ?? ruleDefaults.width)}"/>`;
     const angle = texture.angle ?? ruleDefaults.angle;
-    return tile(id, gap, line, ` patternTransform="rotate(${String(angle)})"`, dimensions, texture.opacity ?? ruleDefaults.opacity);
+    const opacity = texture.opacity ?? ruleDefaults.opacity;
+    const set = (name, at, alpha) => tile(name, gap, line, ` patternTransform="rotate(${String(at)})"`, dimensions, alpha);
+    if (texture.cross !== true) {
+        // One set keeps the id it always had, so that the common case draws what
+        // it drew before, down to the byte.
+        return set(id, angle, opacity);
+    }
+    return (set(`${id}a`, angle, opacity) +
+        set(`${id}b`, -angle, Math.round(opacity * crossScale * 1000) / 1000));
 }
 //# sourceMappingURL=pattern.js.map

package/dist/texture/pattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../src/texture/pattern.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC,MAAM,WAAW,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;AACxD,MAAM,YAAY,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAErE;;;GAGG;AACH,SAAS,IAAI,CACX,EAAU,EACV,GAAW,EACX,QAAgB,EAChB,SAAiB,EACjB,UAAsB,EACtB,OAAe;IAEf,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAEzB,OAAO,CACL,QAAQ;QACR,gBAAgB,EAAE,YAAY,IAAI,aAAa,IAAI,GAAG;QACtD,iCAAiC,SAAS,IAAI,QAAQ,YAAY;QAClE,SAAS;QACT,gBAAgB,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG;QAC3D,eAAe,EAAE,eAAe,MAAM,CAAC,OAAO,CAAC,KAAK,CACrD,CAAC;AACJ,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,OAAO,CACrB,OAAoD,EACpD,UAAsB,EACtB,EAAU;IAEV,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,GAAG,GACP,eAAe,MAAM,SAAS,MAAM,GAAG;QACvC,OAAO,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG;QACxD,UAAU,OAAO,CAAC,KAAK,IAAI,aAAa,KAAK,CAAC;IAEhD,OAAO,IAAI,CACT,EAAE,EACF,GAAG,EACH,GAAG,EACH,EAAE,EACF,UAAU,EACV,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,CACvC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAqD,EACrD,UAAsB,EACtB,EAAU;IAEV,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1B,MAAM,IAAI,GACR,aAAa,CAAC,gBAAgB,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,GAAG;QACtD,YAAY,OAAO,CAAC,KAAK,IAAI,aAAa,GAAG;QAC7C,kBAAkB,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC;IACrE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC;IAElD,OAAO,IAAI,CACT,EAAE,EACF,GAAG,EACH,IAAI,EACJ,6BAA6B,MAAM,CAAC,KAAK,CAAC,IAAI,EAC9C,UAAU,EACV,OAAO,CAAC,OAAO,IAAI,YAAY,CAAC,OAAO,CACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../src/texture/pattern.ts"],"names":[],"mappings":"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"}

package/dist/texture/rays.d.ts

@@ -0,0 +1,13 @@
+import type { Dimensions, Texture } from "../types.js";
+/**
+ * Straight lines fanning out from one point.
+ *
+ * The rays are spread around the whole circle rather than over the angle that
+ * happens to face the image, so moving the origin changes what is seen without
+ * changing how close together the lines are. Nothing clips the ones that point
+ * away: they are outside the SVG's viewport and are simply not painted.
+ */
+export declare function raysSvg(texture: Extract<Texture, {
+    readonly type: "rays";
+}>, dimensions: Dimensions): string;
+//# sourceMappingURL=rays.d.ts.map

package/dist/texture/rays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rays.d.ts","sourceRoot":"","sources":["../../src/texture/rays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAkBvD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACpD,UAAU,EAAE,UAAU,GACrB,MAAM,CA0BR"}

package/dist/texture/rays.js

@@ -0,0 +1,36 @@
+import { fallbackColor } from "./color.js";
+const rayDefaults = { opacity: 0.07, width: 2, count: 36, x: 0.5, y: 1.15 };
+/** How far a ray has to run to leave the image from where it starts. */
+function reach(origin, dimensions) {
+    return Math.hypot(Math.max(origin.x, dimensions.width - origin.x), Math.max(origin.y, dimensions.height - origin.y));
+}
+/**
+ * Straight lines fanning out from one point.
+ *
+ * The rays are spread around the whole circle rather than over the angle that
+ * happens to face the image, so moving the origin changes what is seen without
+ * changing how close together the lines are. Nothing clips the ones that point
+ * away: they are outside the SVG's viewport and are simply not painted.
+ */
+export function raysSvg(texture, dimensions) {
+    const count = Math.max(1, Math.round(texture.count ?? rayDefaults.count));
+    const origin = {
+        x: dimensions.width * (texture.x ?? rayDefaults.x),
+        y: dimensions.height * (texture.y ?? rayDefaults.y),
+    };
+    const length = reach(origin, dimensions);
+    let rays = "";
+    for (let ray = 0; ray < count; ray += 1) {
+        const angle = (ray / count) * Math.PI * 2;
+        rays +=
+            `<line x1="${String(Math.round(origin.x))}"` +
+                ` y1="${String(Math.round(origin.y))}"` +
+                ` x2="${String(Math.round(origin.x + Math.cos(angle) * length))}"` +
+                ` y2="${String(Math.round(origin.y + Math.sin(angle) * length))}"/>`;
+    }
+    return (`<g stroke="${texture.color ?? fallbackColor}"` +
+        ` stroke-width="${String(texture.width ?? rayDefaults.width)}"` +
+        ` opacity="${String(texture.opacity ?? rayDefaults.opacity)}">` +
+        `${rays}</g>`);
+}
+//# sourceMappingURL=rays.js.map

package/dist/texture/rays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rays.js","sourceRoot":"","sources":["../../src/texture/rays.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;AAO5E,wEAAwE;AACxE,SAAS,KAAK,CAAC,MAAc,EAAE,UAAsB;IACnD,OAAO,IAAI,CAAC,KAAK,CACf,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAC/C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CACjD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CACrB,OAAoD,EACpD,UAAsB;IAEtB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG;QACb,CAAC,EAAE,UAAU,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC;QAClD,CAAC,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC;KACpD,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEzC,IAAI,IAAI,GAAG,EAAE,CAAC;IAEd,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAE1C,IAAI;YACF,aAAa,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG;gBAC5C,QAAQ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG;gBACvC,QAAQ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG;gBAClE,QAAQ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC;IACzE,CAAC;IAED,OAAO,CACL,cAAc,OAAO,CAAC,KAAK,IAAI,aAAa,GAAG;QAC/C,kBAAkB,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG;QAC/D,aAAa,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI;QAC/D,GAAG,IAAI,MAAM,CACd,CAAC;AACJ,CAAC"}

package/dist/texture/resolve.d.ts

@@ -3,10 +3,11 @@ import type { BrandColors, Texture } from "../types.js";
  * Fill in the colour a texture left open, from the palette it will be drawn
  * over.
  *
- * A dot grid or a set of rules has to be the foreground colour by default,
- * because that is the one colour known to contrast with the background: a
- * fixed white would disappear on a light theme, which is a texture that
- * silently does nothing. Grain has no colour to fill in, being noise.
+ * A dot grid, a set of rules or a set of rings has to be the foreground colour
+ * by default, because that is the one colour known to contrast with the
+ * background: a fixed white would disappear on a light theme, which is a
+ * texture that silently does nothing. Grain has no colour to fill in, being
+ * noise.
  *
  * It happens here rather than while drawing so that the resolved config says
  * what will actually be drawn, which is also what the rebuild stamp hashes: a

package/dist/texture/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/texture/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,OAAO,GAAG,SAAS,CAMrB"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/texture/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,OAAO,GAAG,SAAS,CAMrB"}

package/dist/texture/resolve.js

@@ -2,10 +2,11 @@
  * Fill in the colour a texture left open, from the palette it will be drawn
  * over.
  *
- * A dot grid or a set of rules has to be the foreground colour by default,
- * because that is the one colour known to contrast with the background: a
- * fixed white would disappear on a light theme, which is a texture that
- * silently does nothing. Grain has no colour to fill in, being noise.
+ * A dot grid, a set of rules or a set of rings has to be the foreground colour
+ * by default, because that is the one colour known to contrast with the
+ * background: a fixed white would disappear on a light theme, which is a
+ * texture that silently does nothing. Grain has no colour to fill in, being
+ * noise.
  *
  * It happens here rather than while drawing so that the resolved config says
  * what will actually be drawn, which is also what the rebuild stamp hashes: a

package/dist/texture/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/texture/resolve.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA4B,EAC5B,MAA6B;IAE7B,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACtD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC;AAClD,CAAC"}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/texture/resolve.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA4B,EAC5B,MAA6B;IAE7B,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACtD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/texture/scallops.d.ts

@@ -0,0 +1,14 @@
+import type { Dimensions, Texture } from "../types.js";
+/**
+ * Fish scales: rows of arcs, each row offset by half a scale from the one
+ * above, which is what makes them read as overlapping rather than as stacked
+ * semicircles.
+ *
+ * The tile holds two rows for that reason: one repeat has to contain both the
+ * offset row and the row it is offset from, since a `<pattern>` cannot stagger
+ * its own rows.
+ */
+export declare function scallopsSvg(texture: Extract<Texture, {
+    readonly type: "scallops";
+}>, dimensions: Dimensions, id: string): string;
+//# sourceMappingURL=scallops.d.ts.map

package/dist/texture/scallops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scallops.d.ts","sourceRoot":"","sources":["../../src/texture/scallops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAcvD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,EACxD,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,MAAM,GACT,MAAM,CAqBR"}

package/dist/texture/scallops.js

@@ -0,0 +1,29 @@
+import { fallbackColor } from "./color.js";
+import { tile } from "./tile.js";
+const scallopDefaults = { opacity: 0.07, width: 2, size: 40 };
+/** One arc of a row, bulging downwards from the two points it spans. */
+function scallop(cx, y, radius) {
+    return (`M${String(cx - radius)} ${String(y)}` +
+        `A${String(radius)} ${String(radius)} 0 0 0 ${String(cx + radius)} ${String(y)}`);
+}
+/**
+ * Fish scales: rows of arcs, each row offset by half a scale from the one
+ * above, which is what makes them read as overlapping rather than as stacked
+ * semicircles.
+ *
+ * The tile holds two rows for that reason: one repeat has to contain both the
+ * offset row and the row it is offset from, since a `<pattern>` cannot stagger
+ * its own rows.
+ */
+export function scallopsSvg(texture, dimensions, id) {
+    const size = texture.size ?? scallopDefaults.size;
+    const radius = size / 2;
+    const rows = scallop(radius, 0, radius) +
+        scallop(0, radius, radius) +
+        scallop(size, radius, radius);
+    const arcs = `<path d="${rows}" stroke="${texture.color ?? fallbackColor}"` +
+        ` stroke-width="${String(texture.width ?? scallopDefaults.width)}"` +
+        ` fill="none"/>`;
+    return tile(id, size, arcs, "", dimensions, texture.opacity ?? scallopDefaults.opacity);
+}
+//# sourceMappingURL=scallops.js.map

package/dist/texture/scallops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scallops.js","sourceRoot":"","sources":["../../src/texture/scallops.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,eAAe,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAE9D,wEAAwE;AACxE,SAAS,OAAO,CAAC,EAAU,EAAE,CAAS,EAAE,MAAc;IACpD,OAAO,CACL,IAAI,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE;QACtC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CACjF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,OAAwD,EACxD,UAAsB,EACtB,EAAU;IAEV,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC;IACxB,MAAM,IAAI,GACR,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC;QAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC;QAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,MAAM,IAAI,GACR,YAAY,IAAI,aAAa,OAAO,CAAC,KAAK,IAAI,aAAa,GAAG;QAC9D,kBAAkB,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG;QACnE,gBAAgB,CAAC;IAEnB,OAAO,IAAI,CACT,EAAE,EACF,IAAI,EACJ,IAAI,EACJ,EAAE,EACF,UAAU,EACV,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,OAAO,CAC3C,CAAC;AACJ,CAAC"}

package/dist/texture/tile.d.ts

@@ -0,0 +1,14 @@
+import type { Dimensions } from "../types.js";
+/**
+ * A tiled pattern over the whole image: the `<pattern>` under the given `id`,
+ * and the rect that fills with it.
+ *
+ * A tile is what makes a treatment cheap to store as well as to draw. PNG
+ * compresses along a row, and a repeating tile means a row that repeats, which
+ * is the difference between the dot grid's 20KB and the half a megabyte a
+ * pattern that never repeats costs.
+ */
+export declare function tile(id: string, 
+/** The repeat: one number for a square tile, or both sides where it is not. */
+gap: number | Dimensions, contents: string, transform: string, dimensions: Dimensions, opacity: number): string;
+//# sourceMappingURL=tile.d.ts.map

package/dist/texture/tile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile.d.ts","sourceRoot":"","sources":["../../src/texture/tile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAClB,EAAE,EAAE,MAAM;AACV,+EAA+E;AAC/E,GAAG,EAAE,MAAM,GAAG,UAAU,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,CAcR"}

package/dist/texture/tile.js

@@ -0,0 +1,23 @@
+/**
+ * A tiled pattern over the whole image: the `<pattern>` under the given `id`,
+ * and the rect that fills with it.
+ *
+ * A tile is what makes a treatment cheap to store as well as to draw. PNG
+ * compresses along a row, and a repeating tile means a row that repeats, which
+ * is the difference between the dot grid's 20KB and the half a megabyte a
+ * pattern that never repeats costs.
+ */
+export function tile(id, 
+/** The repeat: one number for a square tile, or both sides where it is not. */
+gap, contents, transform, dimensions, opacity) {
+    const { width, height } = dimensions;
+    const repeat = typeof gap === "number" ? { width: gap, height: gap } : { ...gap };
+    return (`<defs>` +
+        `<pattern id="${id}" width="${String(repeat.width)}"` +
+        ` height="${String(repeat.height)}"` +
+        ` patternUnits="userSpaceOnUse"${transform}>${contents}</pattern>` +
+        `</defs>` +
+        `<rect width="${String(width)}" height="${String(height)}"` +
+        ` fill="url(#${id})" opacity="${String(opacity)}"/>`);
+}
+//# sourceMappingURL=tile.js.map

package/dist/texture/tile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile.js","sourceRoot":"","sources":["../../src/texture/tile.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAClB,EAAU;AACV,+EAA+E;AAC/E,GAAwB,EACxB,QAAgB,EAChB,SAAiB,EACjB,UAAsB,EACtB,OAAe;IAEf,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IACrC,MAAM,MAAM,GACV,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;IAErE,OAAO,CACL,QAAQ;QACR,gBAAgB,EAAE,YAAY,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG;QACrD,YAAY,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG;QACpC,iCAAiC,SAAS,IAAI,QAAQ,YAAY;QAClE,SAAS;QACT,gBAAgB,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG;QAC3D,eAAe,EAAE,eAAe,MAAM,CAAC,OAAO,CAAC,KAAK,CACrD,CAAC;AACJ,CAAC"}

package/dist/texture/topographic/contours.d.ts

@@ -0,0 +1,13 @@
+import type { Dimensions } from "../../types.js";
+/**
+ * One contour of the landscape, as the segments where the ground passes
+ * through a given height.
+ *
+ * This is marching squares: the field is sampled on a grid, and each cell
+ * contributes the piece of the line that crosses it. Drawing the segments
+ * separately rather than joining them into loops costs a little more markup
+ * and saves the bookkeeping of walking a contour from cell to cell, which
+ * would not change the picture.
+ */
+export declare function contourAt(level: number, step: number, dimensions: Dimensions, seed: number, relief: number): string;
+//# sourceMappingURL=contours.d.ts.map

package/dist/texture/topographic/contours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contours.d.ts","sourceRoot":"","sources":["../../../src/texture/topographic/contours.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAyEjD;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,MAAM,CAmBR"}

package/dist/texture/topographic/contours.js

@@ -0,0 +1,72 @@
+import { height } from "./field.js";
+/**
+ * Where between two corners the contour crosses, by how far each of them is
+ * above or below the level. Interpolating rather than taking the midpoint is
+ * what makes the line smooth instead of stepped.
+ */
+function between(a, b, above, below) {
+    const along = above / (above - below);
+    return { x: a.x + (b.x - a.x) * along, y: a.y + (b.y - a.y) * along };
+}
+/** The corners of one cell, clockwise from the top left. */
+function corners(x, y, step) {
+    return [
+        { x, y },
+        { x: x + step, y },
+        { x: x + step, y: y + step },
+        { x, y: y + step },
+    ];
+}
+/**
+ * The segments of one contour crossing one cell.
+ *
+ * Which edges it crosses is decided by which corners are above the level, read
+ * as four bits. The two ambiguous cases, where opposite corners are above and
+ * the other two below, are drawn as two separate segments: a saddle can be
+ * joined either way and this is the reading that never crosses itself.
+ */
+function cell(values, points, level) {
+    const above = values.map((value) => value > level);
+    const edges = [];
+    for (const [index, isAbove] of above.entries()) {
+        const next = (index + 1) % 4;
+        if (isAbove !== above[next]) {
+            edges.push(between(points[index], points[next], values[index] - level, values[next] - level));
+        }
+    }
+    if (edges.length === 2) {
+        return [[edges[0], edges[1]]];
+    }
+    return edges.length === 4
+        ? [
+            [edges[0], edges[1]],
+            [edges[2], edges[3]],
+        ]
+        : [];
+}
+/**
+ * One contour of the landscape, as the segments where the ground passes
+ * through a given height.
+ *
+ * This is marching squares: the field is sampled on a grid, and each cell
+ * contributes the piece of the line that crosses it. Drawing the segments
+ * separately rather than joining them into loops costs a little more markup
+ * and saves the bookkeeping of walking a contour from cell to cell, which
+ * would not change the picture.
+ */
+export function contourAt(level, step, dimensions, seed, relief) {
+    let path = "";
+    for (let y = -step; y < dimensions.height + step; y += step) {
+        for (let x = -step; x < dimensions.width + step; x += step) {
+            const points = corners(x, y, step);
+            const values = points.map((point) => height(point.x, point.y, seed) * relief);
+            for (const [from, to] of cell(values, points, level)) {
+                path +=
+                    `M${String(Math.round(from.x))} ${String(Math.round(from.y))}` +
+                        `L${String(Math.round(to.x))} ${String(Math.round(to.y))}`;
+            }
+        }
+    }
+    return path;
+}
+//# sourceMappingURL=contours.js.map

package/dist/texture/topographic/contours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contours.js","sourceRoot":"","sources":["../../../src/texture/topographic/contours.ts"],"names":[],"mappings":"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"}

package/dist/texture/topographic/field.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The height of the ground at a point, from -1 to 1.
+ *
+ * `seed` shifts each wave's phase by a different amount, so one number picks a
+ * whole landscape and the same number always picks the same one.
+ */
+export declare function height(x: number, y: number, seed: number): number;
+//# sourceMappingURL=field.d.ts.map

package/dist/texture/topographic/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../src/texture/topographic/field.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASjE"}

package/dist/texture/topographic/field.js

@@ -0,0 +1,29 @@
+/**
+ * The waves the ground is made of: how far one runs before it repeats, which
+ * way it runs, and how much of the height it accounts for.
+ *
+ * Three at unrelated wavelengths and angles is enough to read as terrain
+ * rather than as a pattern. Deliberately not random: the rebuild stamp assumes
+ * one config draws one picture, so a texture that rolled dice would come out
+ * different every time nothing had changed.
+ */
+const waves = [
+    { length: 260, dx: 1, dy: 0.35, weight: 0.5 },
+    { length: 170, dx: -0.4, dy: 1, weight: 0.32 },
+    { length: 95, dx: 0.7, dy: -0.8, weight: 0.18 },
+];
+/**
+ * The height of the ground at a point, from -1 to 1.
+ *
+ * `seed` shifts each wave's phase by a different amount, so one number picks a
+ * whole landscape and the same number always picks the same one.
+ */
+export function height(x, y, seed) {
+    let sum = 0;
+    for (const [index, wave] of waves.entries()) {
+        const along = (x * wave.dx + y * wave.dy) / wave.length;
+        sum += wave.weight * Math.sin(along + seed * (index + 1) * 1.7);
+    }
+    return sum;
+}
+//# sourceMappingURL=field.js.map

package/dist/texture/topographic/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../../src/texture/topographic/field.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,KAAK,GAAG;IACZ,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAC7C,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;IAC9C,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;CAChD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,CAAS,EAAE,IAAY;IACvD,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACxD,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/texture/topographic/index.d.ts

@@ -0,0 +1,17 @@
+import type { Dimensions, Texture } from "../../types.js";
+/**
+ * Contour lines, the look of a map: the height of a made-up landscape, drawn
+ * every `gap` pixels of it.
+ *
+ * These are the real thing rather than rings pretending: the field is sampled
+ * on a grid and each contour is the line where the ground passes through one
+ * height, so the shapes close where the ground has a summit, run off the edge
+ * where it keeps rising, and never cross each other. An earlier attempt drew
+ * circles pushed in and out by the same field, and no amount of pushing made
+ * it read as anything but a wobbly bullseye: what makes a map is that the
+ * shapes owe nothing to a centre.
+ */
+export declare function topographicSvg(texture: Extract<Texture, {
+    readonly type: "topographic";
+}>, dimensions: Dimensions): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/texture/topographic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/texture/topographic/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAqB1D;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,EAC3D,UAAU,EAAE,UAAU,GACrB,MAAM,CAsBR"}

package/dist/texture/topographic/index.js

@@ -0,0 +1,48 @@
+import { fallbackColor } from "../color.js";
+import { contourAt } from "./contours.js";
+const contourDefaults = {
+    opacity: 0.1,
+    width: 1.5,
+    gap: 34,
+    relief: 5,
+    seed: 1,
+};
+/**
+ * How finely the ground is sampled, as a fraction of the gap between contours.
+ *
+ * The cells have to be smaller than the features the field has, or the lines
+ * come out as polygons. Below about a third of the gap the picture stops
+ * changing and only the markup grows.
+ */
+const sampleScale = 0.5;
+/**
+ * Contour lines, the look of a map: the height of a made-up landscape, drawn
+ * every `gap` pixels of it.
+ *
+ * These are the real thing rather than rings pretending: the field is sampled
+ * on a grid and each contour is the line where the ground passes through one
+ * height, so the shapes close where the ground has a summit, run off the edge
+ * where it keeps rising, and never cross each other. An earlier attempt drew
+ * circles pushed in and out by the same field, and no amount of pushing made
+ * it read as anything but a wobbly bullseye: what makes a map is that the
+ * shapes owe nothing to a centre.
+ */
+export function topographicSvg(texture, dimensions) {
+    const gap = texture.gap ?? contourDefaults.gap;
+    const relief = gap * (texture.relief ?? contourDefaults.relief);
+    const seed = texture.seed ?? contourDefaults.seed;
+    const step = Math.max(2, Math.round(gap * sampleScale));
+    let lines = "";
+    // The field runs from -relief to relief, so the levels either side of nought
+    // are what fits in it. One at nought as well would draw the coastline twice
+    // over, since the sum of the waves sits there more often than anywhere else.
+    for (let level = gap / 2; level < relief; level += gap) {
+        lines += contourAt(level, step, dimensions, seed, relief);
+        lines += contourAt(-level, step, dimensions, seed, relief);
+    }
+    return (`<path d="${lines}" fill="none"` +
+        ` stroke="${texture.color ?? fallbackColor}"` +
+        ` stroke-width="${String(texture.width ?? contourDefaults.width)}"` +
+        ` opacity="${String(texture.opacity ?? contourDefaults.opacity)}"/>`);
+}
+//# sourceMappingURL=index.js.map

package/dist/texture/topographic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/texture/topographic/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,eAAe,GAAG;IACtB,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,GAAG;IACV,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACR,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA2D,EAC3D,UAAsB;IAEtB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC;IAExD,IAAI,KAAK,GAAG,EAAE,CAAC;IAEf,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,KAAK,IAAI,KAAK,GAAG,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,GAAG,EAAE,CAAC;QACvD,KAAK,IAAI,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,KAAK,IAAI,SAAS,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,CACL,YAAY,KAAK,eAAe;QAChC,YAAY,OAAO,CAAC,KAAK,IAAI,aAAa,GAAG;QAC7C,kBAAkB,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG;QACnE,aAAa,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,CACrE,CAAC;AACJ,CAAC"}

package/dist/texture/waves.d.ts

@@ -0,0 +1,18 @@
+import type { Dimensions, Texture } from "../types.js";
+/**
+ * Two sets of concentric rings, one from the middle of each side edge.
+ *
+ * Unlike the dot grid and the ruled lines this is not a tile, and it cannot be
+ * one: what makes it worth looking at is the interference between the two
+ * sets, which is different everywhere on the image.
+ *
+ * It is a few dozen circles to draw and expensive to store, which are not the
+ * same thing. Antialiased curves put a different set of colours in every row,
+ * so a 1200x1200 PNG goes from around 80KB to around 620KB at the default gap,
+ * against 100KB for the dot grid. `gap` is the only real lever on that, and
+ * the docs say so.
+ */
+export declare function wavesSvg(texture: Extract<Texture, {
+    readonly type: "waves";
+}>, dimensions: Dimensions): string;
+//# sourceMappingURL=waves.d.ts.map

package/dist/texture/waves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waves.d.ts","sourceRoot":"","sources":["../../src/texture/waves.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA4DvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,EACrD,UAAU,EAAE,UAAU,GACrB,MAAM,CAaR"}

package/dist/texture/waves.js

@@ -0,0 +1,55 @@
+import { fallbackColor } from "./color.js";
+const wavesDefaults = { opacity: 0.14, width: 2, gap: 24 };
+/**
+ * How much fainter the set drawn from the right is than the set from the left.
+ *
+ * Two sets at one opacity read as two sets of rings, because the eye follows
+ * whichever arc it is on. Dropping one of them is what turns the crossings
+ * into a single surface with a grain to it, and it is the same trick that
+ * keeps a flat tile from reading as graph paper.
+ */
+const secondaryScale = 0.65;
+/**
+ * Rings around one centre at `gap` apart, out to the furthest corner of the
+ * image, which is where the pattern stops being able to cover anything.
+ *
+ * Nothing clips them: a circle drawn past the edge of the image is outside the
+ * SVG's viewport and simply is not painted.
+ */
+function rings(centre, dimensions, gap) {
+    const furthest = Math.hypot(Math.max(centre.x, dimensions.width - centre.x), Math.max(centre.y, dimensions.height - centre.y));
+    let out = "";
+    for (let ring = 1; ring * gap <= furthest; ring += 1) {
+        out +=
+            `<circle cx="${String(centre.x)}" cy="${String(centre.y)}"` +
+                ` r="${String(Math.round(ring * gap))}"/>`;
+    }
+    return out;
+}
+/** One set of rings, with the stroke named once on the group. */
+function family(centre, dimensions, texture, opacity) {
+    const gap = texture.gap ?? wavesDefaults.gap;
+    return (`<g fill="none" stroke="${texture.color ?? fallbackColor}"` +
+        ` stroke-width="${String(texture.width ?? wavesDefaults.width)}"` +
+        ` opacity="${String(opacity)}">${rings(centre, dimensions, gap)}</g>`);
+}
+/**
+ * Two sets of concentric rings, one from the middle of each side edge.
+ *
+ * Unlike the dot grid and the ruled lines this is not a tile, and it cannot be
+ * one: what makes it worth looking at is the interference between the two
+ * sets, which is different everywhere on the image.
+ *
+ * It is a few dozen circles to draw and expensive to store, which are not the
+ * same thing. Antialiased curves put a different set of colours in every row,
+ * so a 1200x1200 PNG goes from around 80KB to around 620KB at the default gap,
+ * against 100KB for the dot grid. `gap` is the only real lever on that, and
+ * the docs say so.
+ */
+export function wavesSvg(texture, dimensions) {
+    const opacity = texture.opacity ?? wavesDefaults.opacity;
+    const middle = Math.round(dimensions.height / 2);
+    return (family({ x: 0, y: middle }, dimensions, texture, opacity) +
+        family({ x: dimensions.width, y: middle }, dimensions, texture, Math.round(opacity * secondaryScale * 1000) / 1000));
+}
+//# sourceMappingURL=waves.js.map

package/dist/texture/waves.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waves.js","sourceRoot":"","sources":["../../src/texture/waves.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,aAAa,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,cAAc,GAAG,IAAI,CAAC;AAO5B;;;;;;GAMG;AACH,SAAS,KAAK,CAAC,MAAc,EAAE,UAAsB,EAAE,GAAW;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAC/C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CACjD,CAAC;IAEF,IAAI,GAAG,GAAG,EAAE,CAAC;IAEb,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,GAAG,IAAI,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACrD,GAAG;YACD,eAAe,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG;gBAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC;IAC/C,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iEAAiE;AACjE,SAAS,MAAM,CACb,MAAc,EACd,UAAsB,EACtB,OAAqD,EACrD,OAAe;IAEf,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC;IAE7C,OAAO,CACL,0BAA0B,OAAO,CAAC,KAAK,IAAI,aAAa,GAAG;QAC3D,kBAAkB,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG;QACjE,aAAa,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CACtE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAqD,EACrD,UAAsB;IAEtB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEjD,OAAO,CACL,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC;QACzD,MAAM,CACJ,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAClC,UAAU,EACV,OAAO,EACP,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,cAAc,GAAG,IAAI,CAAC,GAAG,IAAI,CACnD,CACF,CAAC;AACJ,CAAC"}