@kensio/colophon 2.4.0 → 2.6.0

package/dist/templates/wordmark/mark.js

@@ -0,0 +1,30 @@
+import { image } from "../../layout/index.js";
+/** The mark's height, as a fraction of the image's. */
+const markScale = 0.2;
+/**
+ * How tall the mark is drawn, or nothing at all where the project configured
+ * no logo, which is what takes the mark and the gap under it out of the stack.
+ */
+export function markHeight(logo, imageHeight) {
+    return logo === undefined ? 0 : Math.round(imageHeight * markScale);
+}
+/**
+ * The mark, centred in the slot the stack gave it.
+ *
+ * Its width comes from the height it was allotted and the proportions of the
+ * file, as it does in the corner of every other template, so one logo works on
+ * a square and a landscape alike.
+ */
+export function markElement(logo, slot) {
+    if (logo === undefined || slot === undefined || slot.height === 0) {
+        return "";
+    }
+    const width = Math.round(slot.height * logo.aspect);
+    return image({
+        x: Math.round(slot.x + (slot.width - width) / 2),
+        y: slot.y,
+        width,
+        height: slot.height,
+    }, logo.href, { fit: "contain" });
+}
+//# sourceMappingURL=mark.js.map

package/dist/templates/wordmark/mark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark.js","sourceRoot":"","sources":["../../../src/templates/wordmark/mark.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAI9C,uDAAuD;AACvD,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,IAA4B,EAC5B,WAAmB;IAEnB,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,IAA4B,EAC5B,IAAsB;IAEtB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAEpD,OAAO,KAAK,CACV;QACE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAChD,CAAC,EAAE,IAAI,CAAC,CAAC;QACT,KAAK;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,EACD,IAAI,CAAC,IAAI,EACT,EAAE,GAAG,EAAE,SAAS,EAAE,CACnB,CAAC;AACJ,CAAC"}

package/dist/text/clamp.d.ts

@@ -0,0 +1,12 @@
+import type { MeasureAt } from "./fit.js";
+/**
+ * Cut one line to the width it has, marking the cut with an ellipsis.
+ *
+ * This is what a line that may not wrap does instead of wrapping: a bullet in
+ * a list of changes, a breadcrumb, a window title. Shrinking is the better
+ * answer wherever there is room for it, which is what `fitText` is for and why
+ * most text goes through that instead. A line set alongside others at the same
+ * size cannot shrink on its own without looking like a mistake.
+ */
+export declare function clampLine(text: string, maxWidth: number, measure: MeasureAt, fontSize: number): string;
+//# sourceMappingURL=clamp.d.ts.map

package/dist/text/clamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../../src/text/clamp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CA8BR"}

package/dist/text/clamp.js

@@ -0,0 +1,41 @@
+import { ellipsis } from "./ellipsis.js";
+/**
+ * Cut one line to the width it has, marking the cut with an ellipsis.
+ *
+ * This is what a line that may not wrap does instead of wrapping: a bullet in
+ * a list of changes, a breadcrumb, a window title. Shrinking is the better
+ * answer wherever there is room for it, which is what `fitText` is for and why
+ * most text goes through that instead. A line set alongside others at the same
+ * size cannot shrink on its own without looking like a mistake.
+ */
+export function clampLine(text, maxWidth, measure, fontSize) {
+    const full = measure(text, fontSize);
+    if (full <= maxWidth || text === "") {
+        return text;
+    }
+    const isWithin = (length) => measure(text.slice(0, length) + ellipsis, fontSize) <= maxWidth;
+    // Start from what the width would be if every character were as wide as the
+    // average, then walk to the real answer. A proportional face makes that a
+    // guess rather than a result, so it is corrected in both directions. The
+    // floor of nought is what stops a caller with no room left, which is a width
+    // that has come out negative, reaching `slice` with a negative length and
+    // being cut from the wrong end.
+    let kept = Math.max(0, Math.min(text.length, Math.floor((text.length * maxWidth) / full)));
+    while (kept < text.length && isWithin(kept + 1)) {
+        kept += 1;
+    }
+    while (kept > 0 && !isWithin(kept)) {
+        kept -= 1;
+    }
+    return withoutSplitPair(text.slice(0, kept)).trimEnd() + ellipsis;
+}
+/**
+ * Drop a trailing lone surrogate, which is what cutting by string index does
+ * to a character outside the basic plane: an emoji in a changelog entry is two
+ * units long, and half of one is not a character at all. Escaping it would put
+ * an unpaired surrogate in the document.
+ */
+function withoutSplitPair(text) {
+    return /[\uD800-\uDBFF]$/.test(text) ? text.slice(0, -1) : text;
+}
+//# sourceMappingURL=clamp.js.map

package/dist/text/clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../src/text/clamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,QAAgB,EAChB,OAAkB,EAClB,QAAgB;IAEhB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAErC,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAW,EAAE,CAC3C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC;IAElE,4EAA4E;IAC5E,0EAA0E;IAC1E,yEAAyE;IACzE,6EAA6E;IAC7E,0EAA0E;IAC1E,gCAAgC;IAChC,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CACjB,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,CACnE,CAAC;IAEF,OAAO,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IAED,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC"}

package/dist/text/ellipsis.d.ts

@@ -0,0 +1,3 @@
+/** The mark a truncated line or block ends with. */
+export declare const ellipsis = "\u2026";
+//# sourceMappingURL=ellipsis.d.ts.map

package/dist/text/ellipsis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ellipsis.d.ts","sourceRoot":"","sources":["../../src/text/ellipsis.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,eAAO,MAAM,QAAQ,WAAM,CAAC"}

package/dist/text/ellipsis.js

@@ -0,0 +1,3 @@
+/** The mark a truncated line or block ends with. */
+export const ellipsis = "…";
+//# sourceMappingURL=ellipsis.js.map

package/dist/text/ellipsis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ellipsis.js","sourceRoot":"","sources":["../../src/text/ellipsis.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC"}

package/dist/text/index.d.ts

@@ -2,6 +2,8 @@ export { escapeXml } from "./escape.js";
 export { textElement } from "./element.js";
 export type { TextAttributes } from "./element.js";
 export { breakWord } from "./break.js";
+export { clampLine } from "./clamp.js";
+export { ellipsis } from "./ellipsis.js";
 export { fitText } from "./fit.js";
 export type { FitOptions, FittedText, MeasureAt } from "./fit.js";
 export { wrapText } from "./wrap.js";

package/dist/text/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/text/index.js

@@ -1,6 +1,8 @@
 export { escapeXml } from "./escape.js";
 export { textElement } from "./element.js";
 export { breakWord } from "./break.js";
+export { clampLine } from "./clamp.js";
+export { ellipsis } from "./ellipsis.js";
 export { fitText } from "./fit.js";
 export { wrapText } from "./wrap.js";
 //# sourceMappingURL=index.js.map

package/dist/text/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/texture/grain.d.ts

@@ -0,0 +1,17 @@
+import type { Dimensions, Texture } from "../types.js";
+/**
+ * Film grain, from one turbulence filter.
+ *
+ * `scale` is roughly the size of a speck in pixels, which is what someone
+ * tuning this actually wants to think about; the filter wants the reciprocal
+ * of that, so the two are inverses of each other. Three octaves is enough to
+ * stop the noise looking regular and cheap enough not to notice.
+ *
+ * The noise is desaturated to grey, since coloured specks over a brand colour
+ * read as a rendering fault rather than as grain. Grey does lighten what is
+ * under it a little, which is why the default opacity is as low as it is.
+ */
+export declare function grainSvg(texture: Extract<Texture, {
+    readonly type: "grain";
+}>, dimensions: Dimensions, id: string): string;
+//# sourceMappingURL=grain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grain.d.ts","sourceRoot":"","sources":["../../src/texture/grain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKvD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,EACrD,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,MAAM,GACT,MAAM,CAgBR"}

package/dist/texture/grain.js

@@ -0,0 +1,29 @@
+const defaultOpacity = 0.1;
+const defaultScale = 1.4;
+/**
+ * Film grain, from one turbulence filter.
+ *
+ * `scale` is roughly the size of a speck in pixels, which is what someone
+ * tuning this actually wants to think about; the filter wants the reciprocal
+ * of that, so the two are inverses of each other. Three octaves is enough to
+ * stop the noise looking regular and cheap enough not to notice.
+ *
+ * The noise is desaturated to grey, since coloured specks over a brand colour
+ * read as a rendering fault rather than as grain. Grey does lighten what is
+ * under it a little, which is why the default opacity is as low as it is.
+ */
+export function grainSvg(texture, dimensions, id) {
+    const { width, height } = dimensions;
+    const frequency = 1 / (texture.scale ?? defaultScale);
+    return (`<defs>` +
+        `<filter id="${id}" x="0" y="0" width="100%" height="100%">` +
+        `<feTurbulence type="fractalNoise" baseFrequency="${frequency.toFixed(3)}"` +
+        ` numOctaves="3" stitchTiles="stitch"/>` +
+        `<feColorMatrix type="saturate" values="0"/>` +
+        `</filter>` +
+        `</defs>` +
+        `<rect width="${String(width)}" height="${String(height)}"` +
+        ` filter="url(#${id})"` +
+        ` opacity="${String(texture.opacity ?? defaultOpacity)}"/>`);
+}
+//# sourceMappingURL=grain.js.map

package/dist/texture/grain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grain.js","sourceRoot":"","sources":["../../src/texture/grain.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAqD,EACrD,UAAsB,EACtB,EAAU;IAEV,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IACrC,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;IAEtD,OAAO,CACL,QAAQ;QACR,eAAe,EAAE,2CAA2C;QAC5D,oDAAoD,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAC3E,wCAAwC;QACxC,6CAA6C;QAC7C,WAAW;QACX,SAAS;QACT,gBAAgB,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,GAAG;QAC3D,iBAAiB,EAAE,IAAI;QACvB,aAAa,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,CAC5D,CAAC;AACJ,CAAC"}

package/dist/texture/index.d.ts

@@ -0,0 +1,11 @@
+import type { Dimensions, Texture } from "../types.js";
+export { resolveTexture } from "./resolve.js";
+/**
+ * Render the treatment laid over a background as SVG, naming whatever it needs
+ * in `<defs>` after the given `id`.
+ *
+ * It is drawn between the background and whatever a template draws, so a
+ * texture never comes between a headline and the reader.
+ */
+export declare function textureSvg(texture: Texture, dimensions: Dimensions, id: string): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/texture/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAIvD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,MAAM,GACT,MAAM,CAUR"}

package/dist/texture/index.js

@@ -0,0 +1,20 @@
+import { grainSvg } from "./grain.js";
+import { dotsSvg, rulesSvg } from "./pattern.js";
+export { resolveTexture } from "./resolve.js";
+/**
+ * Render the treatment laid over a background as SVG, naming whatever it needs
+ * in `<defs>` after the given `id`.
+ *
+ * It is drawn between the background and whatever a template draws, so a
+ * texture never comes between a headline and the reader.
+ */
+export function textureSvg(texture, dimensions, id) {
+    if (texture.type === "grain") {
+        return grainSvg(texture, dimensions, id);
+    }
+    if (texture.type === "dots") {
+        return dotsSvg(texture, dimensions, id);
+    }
+    return rulesSvg(texture, dimensions, id);
+}
+//# sourceMappingURL=index.js.map

package/dist/texture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/texture/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,OAAgB,EAChB,UAAsB,EACtB,EAAU;IAEV,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/texture/pattern.d.ts

@@ -0,0 +1,17 @@
+import type { Dimensions, Texture } from "../types.js";
+/** A grid of dots, one to a tile. */
+export declare function dotsSvg(texture: Extract<Texture, {
+    readonly type: "dots";
+}>, dimensions: Dimensions, id: string): string;
+/**
+ * Ruled lines, one to a tile, rotated as a set.
+ *
+ * The line runs down the middle of its tile rather than along the edge, so
+ * that the whole of its width is inside the tile: a stroke centred on the edge
+ * would have half of itself outside the tile, where the pattern does not
+ * repeat it, and the lines would come out half as thick as asked for.
+ */
+export declare function rulesSvg(texture: Extract<Texture, {
+    readonly type: "rules";
+}>, dimensions: Dimensions, id: string): string;
+//# sourceMappingURL=pattern.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../src/texture/pattern.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAiCvD,qCAAqC;AACrC,wBAAgB,OAAO,CACrB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACpD,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,MAAM,GACT,MAAM,CAgBR;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,EACrD,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,MAAM,GACT,MAAM,CAiBR"}

package/dist/texture/pattern.js

@@ -0,0 +1,45 @@
+/** Used where the palette did not supply one, so a texture always draws. */
+const fallbackColor = "#ffffff";
+const dotDefaults = { opacity: 0.08, size: 5, gap: 44 };
+const ruleDefaults = { opacity: 0.06, width: 2, gap: 28, angle: 45 };
+/**
+ * A tiled pattern over the whole image: the `<pattern>` under the given `id`,
+ * and the rect that fills with 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)}"/>`);
+}
+/** A grid of dots, one to a tile. */
+export function dotsSvg(texture, dimensions, id) {
+    const gap = texture.gap ?? dotDefaults.gap;
+    const centre = String(gap / 2);
+    const dot = `<circle cx="${centre}" cy="${centre}"` +
+        ` r="${String((texture.size ?? dotDefaults.size) / 2)}"` +
+        ` fill="${texture.color ?? fallbackColor}"/>`;
+    return tile(id, gap, dot, "", dimensions, texture.opacity ?? dotDefaults.opacity);
+}
+/**
+ * Ruled lines, one to a tile, rotated as a set.
+ *
+ * The line runs down the middle of its tile rather than along the edge, so
+ * that the whole of its width is inside the tile: a stroke centred on the edge
+ * would have half of itself outside the tile, where the pattern does not
+ * repeat it, and the lines would come out half as thick as asked for.
+ */
+export function rulesSvg(texture, dimensions, id) {
+    const gap = texture.gap ?? ruleDefaults.gap;
+    const x = String(gap / 2);
+    const line = `<line x1="${x}" y1="0" x2="${x}" y2="${String(gap)}"` +
+        ` 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);
+}
+//# sourceMappingURL=pattern.js.map

package/dist/texture/pattern.js.map

@@ -0,0 +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"}

package/dist/texture/resolve.d.ts

@@ -0,0 +1,16 @@
+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.
+ *
+ * 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
+ * palette change then re-renders the texture that follows it.
+ */
+export declare function resolveTexture(texture: Texture | undefined, colors: Required<BrandColors>): Texture | undefined;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +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"}

package/dist/texture/resolve.js

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ *
+ * 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
+ * palette change then re-renders the texture that follows it.
+ */
+export function resolveTexture(texture, colors) {
+    if (texture === undefined || texture.type === "grain") {
+        return texture;
+    }
+    return { color: colors.foreground, ...texture };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/texture/resolve.js.map

@@ -0,0 +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"}

package/dist/theme/index.d.ts

@@ -0,0 +1,27 @@
+import type { BrandColors, ColophonConfig, ThemeName } from "../types.js";
+export { themeNames } from "./presets.js";
+/**
+ * The palette a theme brings, or `undefined` where there is no theme.
+ *
+ * It is what a partial override merges over, so that a size asking for one
+ * darker shade keeps the rest of the look rather than dropping back to the
+ * neutral default palette.
+ */
+export declare function themePalette(theme: ThemeName | undefined): Required<BrandColors> | undefined;
+/**
+ * Fill in the fields a theme supplies and the config did not name.
+ *
+ * A theme is applied by merging rather than by resolving, so that everything
+ * downstream sees an ordinary config and nothing else in the package has to
+ * know that themes exist. Whatever the config sets wins, field by field: this
+ * is `colors`, `background` and `texture` as defaults, not as a look that
+ * cannot be argued with.
+ *
+ * The consequence worth knowing is that a config naming its own `colors`
+ * alongside a theme keeps the theme's background as it was written, so the
+ * accent colour changes and the picture behind it does not. That follows from
+ * the merge, and it is the honest reading of a theme: the background is part
+ * of the look rather than something derived from the palette.
+ */
+export declare function applyTheme(config: ColophonConfig): ColophonConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/theme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,GAAG,SAAS,GAC3B,QAAQ,CAAC,WAAW,CAAC,GAAG,SAAS,CAEnC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAcjE"}

package/dist/theme/index.js

@@ -0,0 +1,41 @@
+import { THEMES } from "./presets.js";
+export { themeNames } from "./presets.js";
+/**
+ * The palette a theme brings, or `undefined` where there is no theme.
+ *
+ * It is what a partial override merges over, so that a size asking for one
+ * darker shade keeps the rest of the look rather than dropping back to the
+ * neutral default palette.
+ */
+export function themePalette(theme) {
+    return theme === undefined ? undefined : THEMES[theme].colors;
+}
+/**
+ * Fill in the fields a theme supplies and the config did not name.
+ *
+ * A theme is applied by merging rather than by resolving, so that everything
+ * downstream sees an ordinary config and nothing else in the package has to
+ * know that themes exist. Whatever the config sets wins, field by field: this
+ * is `colors`, `background` and `texture` as defaults, not as a look that
+ * cannot be argued with.
+ *
+ * The consequence worth knowing is that a config naming its own `colors`
+ * alongside a theme keeps the theme's background as it was written, so the
+ * accent colour changes and the picture behind it does not. That follows from
+ * the merge, and it is the honest reading of a theme: the background is part
+ * of the look rather than something derived from the palette.
+ */
+export function applyTheme(config) {
+    const theme = config.theme === undefined ? undefined : THEMES[config.theme];
+    if (theme === undefined) {
+        return config;
+    }
+    return {
+        ...config,
+        ...(config.colors === undefined && { colors: theme.colors }),
+        ...(config.background === undefined && { background: theme.background }),
+        ...(config.texture === undefined &&
+            theme.texture !== undefined && { texture: theme.texture }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,KAA4B;IAE5B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,MAAsB;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC5D,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QACxE,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS;YAC9B,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/theme/presets.d.ts

@@ -0,0 +1,38 @@
+import type { Background, BrandColors, Texture, ThemeName } from "../types.js";
+/**
+ * What a named theme sets. Every field is an ordinary config option, because
+ * that is all a theme is: a set of defaults for fields a project could have
+ * written out itself, and would rather not.
+ */
+export interface Theme {
+    readonly colors: Required<BrandColors>;
+    readonly background: Background;
+    readonly texture?: Texture;
+}
+/**
+ * The curated set.
+ *
+ * Each one is a whole look rather than a palette, which is why the background
+ * is written out here instead of being derived from the colours: `midnight`
+ * without its mesh and `slate` without its dot grid are the same flat image in
+ * two shades of navy. Deriving would also mean a theme could only ever be the
+ * one gradient the defaults already give.
+ *
+ * Six of them are dark, since white text on a deep background is what a share
+ * image is usually asked to be, and two are light, because a site whose own
+ * pages are light has nothing to reach for otherwise.
+ *
+ * None of them turns grain on, though it is the treatment they would most
+ * obviously want. Per-pixel noise does not compress, and it takes a
+ * 1200x1200 PNG from around 600KB to a little over 2MB: a cost worth paying
+ * on purpose, and not one to hand someone who picked a theme by its name and
+ * is committing the images next to their posts.
+ */
+export declare const THEMES: Readonly<Record<ThemeName, Theme>>;
+/**
+ * The theme names, for validation and for anything listing them. Asserted
+ * rather than written out again, because `Object.keys` loses the key type and
+ * a second copy of the list is one that can drift from the set above.
+ */
+export declare const themeNames: readonly ThemeName[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/theme/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/theme/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE/E;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAkIrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAA0B,SAAS,SAAS,EAAE,CAAC"}