@kensio/colophon 2.4.0 → 2.6.0

package/dist/templates/byline.js

@@ -0,0 +1,45 @@
+import { measureIn, textElement } from "../layout/index.js";
+import { portraitImage, portraitRow } from "./portrait.js";
+/** Unique within one image, which is as many bylines as a template draws. */
+const avatarId = "colophon-byline";
+/**
+ * A line of the template's own words with the post's avatar before it: an
+ * author and a date on an article, the person a quotation is from.
+ *
+ * This is `attribution` with the text opened up. The footer says who published
+ * the site and is the same on every image; a byline says who wrote this one,
+ * so it comes from the props. Both are a picture and a line of type on one
+ * baseline, and both are drawn by {@link portraitRow}.
+ */
+export function byline(text, placement, style, avatar, measure) {
+    if (text === "" && avatar === undefined) {
+        return "";
+    }
+    const attributes = {
+        fontFamily: style.fontFamily,
+        fontSize: placement.fontSize,
+        fontWeight: style.fontWeight,
+        fill: style.fill,
+        fillOpacity: placement.opacity,
+    };
+    if (avatar === undefined) {
+        return textElement(text, {
+            ...attributes,
+            x: placement.x,
+            y: placement.y,
+            ...(placement.anchor !== undefined && { anchor: placement.anchor }),
+        });
+    }
+    const width = text === ""
+        ? 0
+        : measureIn(measure, style.fontFamily, style.fontWeight)(text, placement.fontSize);
+    const { rect, labelX } = portraitRow(placement, width);
+    return (portraitImage(avatar, rect, avatarId) +
+        textElement(text, {
+            ...attributes,
+            x: labelX,
+            y: placement.y,
+            anchor: "start",
+        }));
+}
+//# sourceMappingURL=byline.js.map

package/dist/templates/byline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byline.js","sourceRoot":"","sources":["../../src/templates/byline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3D,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AASnC;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CACpB,IAAY,EACZ,SAA4B,EAC5B,KAAkB,EAClB,MAA8B,EAC9B,OAAoB;IAEpB,IAAI,IAAI,KAAK,EAAE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,SAAS,CAAC,OAAO;KAC/B,CAAC;IAEF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,WAAW,CAAC,IAAI,EAAE;YACvB,GAAG,UAAU;YACb,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;SACpE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GACT,IAAI,KAAK,EAAE;QACT,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,SAAS,CACP,OAAO,EACP,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,CACjB,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAEvD,OAAO,CACL,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC;QACrC,WAAW,CAAC,IAAI,EAAE;YAChB,GAAG,UAAU;YACb,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,MAAM,EAAE,OAAO;SAChB,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/templates/code/clip.js

@@ -1,4 +1,4 @@
-import { ellipsis } from "./ellipsis.js";
+import { ellipsis } from "../../text/ellipsis.js";
 /**
  * Clip a line to the columns that fit, ending it with an ellipsis. The font
  * size is floored for legibility, so a wide enough snippet can still overrun

package/dist/templates/code/clip.js.map

@@ -1 +1 @@
-{"version":3,"file":"clip.js","sourceRoot":"","sources":["../../../src/templates/code/clip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,MAA4B,EAC5B,UAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QACvE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAEvC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC;QAC3E,MAAM;IACR,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,KAAwC,EACxC,UAAkB;IAElB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAE1C,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"clip.js","sourceRoot":"","sources":["../../../src/templates/code/clip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,MAA4B,EAC5B,UAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QACvE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAEvC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC;QAC3E,MAAM;IACR,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,KAAwC,EACxC,UAAkB;IAElB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAE1C,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/templates/code/fit.js

@@ -1,4 +1,4 @@
-import { ellipsis } from "./ellipsis.js";
+import { ellipsis } from "../../text/ellipsis.js";
 /**
  * Pick the largest font size that fits the snippet in the panel on both axes,
  * clamped to the configured bounds.

package/dist/templates/code/fit.js.map

@@ -1 +1 @@
-{"version":3,"file":"fit.js","sourceRoot":"","sources":["../../../src/templates/code/fit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,WAA4B,EAC5B,IAAgB,EAChB,UAAkB,EAClB,MAAsB,EACtB,cAAsB;IAEtB,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAE/D,MAAM,OAAO,GACX,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC,CAAC;IACvE,MAAM,QAAQ,GACZ,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwC;IACnE,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM;QACN,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAwC,EACxC,UAAkB,EAClB,IAAY;IAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC;IAE5D,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE1E,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"fit.js","sourceRoot":"","sources":["../../../src/templates/code/fit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,WAA4B,EAC5B,IAAgB,EAChB,UAAkB,EAClB,MAAsB,EACtB,cAAsB;IAEtB,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAE/D,MAAM,OAAO,GACX,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC,CAAC;IACvE,MAAM,QAAQ,GACZ,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwC;IACnE,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM;QACN,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAwC,EACxC,UAAkB,EAClB,IAAY;IAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC;IAE5D,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE1E,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/templates/code/warn.d.ts

@@ -7,5 +7,5 @@ import type { Dimensions, ResolvedConfig } from "../../types.js";
 export declare function warnIfTruncated(config: ResolvedConfig, dimensions: Dimensions, counts: {
     readonly dropped: number;
     readonly clipped: number;
-}, total: number): void;
+}, total: number, subject?: string): void;
 //# sourceMappingURL=warn.d.ts.map

package/dist/templates/code/warn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"warn.d.ts","sourceRoot":"","sources":["../../../src/templates/code/warn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMjE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC9D,KAAK,EAAE,MAAM,GACZ,IAAI,CAoBN"}
+{"version":3,"file":"warn.d.ts","sourceRoot":"","sources":["../../../src/templates/code/warn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMjE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC9D,KAAK,EAAE,MAAM,EACb,OAAO,SAAiB,GACvB,IAAI,CAoBN"}

package/dist/templates/code/warn.js

@@ -6,7 +6,7 @@ function plural(count, noun) {
  * says the sample continued, so silent truncation is how a half-a-function
  * share card ends up on someone else's timeline.
  */
-export function warnIfTruncated(config, dimensions, counts, total) {
+export function warnIfTruncated(config, dimensions, counts, total, subject = "code snippet") {
     const parts = [];
     if (counts.dropped > 0) {
         parts.push(`${String(counts.dropped)} of ${plural(total, "line")} dropped`);
@@ -17,7 +17,7 @@ export function warnIfTruncated(config, dimensions, counts, total) {
     if (parts.length === 0) {
         return;
     }
-    config.onWarning(`code snippet does not fit the ${String(dimensions.width)}x${String(dimensions.height)}` +
+    config.onWarning(`${subject} does not fit the ${String(dimensions.width)}x${String(dimensions.height)}` +
         ` image at a legible size: ${parts.join(", ")}.` +
         ` Shorten the sample, or lower code.minFontScale to fit it in smaller.`);
 }

package/dist/templates/code/warn.js.map

@@ -1 +1 @@
-{"version":3,"file":"warn.js","sourceRoot":"","sources":["../../../src/templates/code/warn.ts"],"names":[],"mappings":"AAEA,SAAS,MAAM,CAAC,KAAa,EAAE,IAAY;IACzC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAsB,EACtB,UAAsB,EACtB,MAA8D,EAC9D,KAAa;IAEb,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,6BAA6B,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IAED,MAAM,CAAC,SAAS,CACd,iCAAiC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACtF,6BAA6B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAChD,uEAAuE,CAC1E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"warn.js","sourceRoot":"","sources":["../../../src/templates/code/warn.ts"],"names":[],"mappings":"AAEA,SAAS,MAAM,CAAC,KAAa,EAAE,IAAY;IACzC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAsB,EACtB,UAAsB,EACtB,MAA8D,EAC9D,KAAa,EACb,OAAO,GAAG,cAAc;IAExB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,6BAA6B,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IAED,MAAM,CAAC,SAAS,CACd,GAAG,OAAO,qBAAqB,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACpF,6BAA6B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAChD,uEAAuE,CAC1E,CAAC;AACJ,CAAC"}

package/dist/templates/docs/chrome.d.ts

@@ -0,0 +1,17 @@
+import type { Dimensions, MeasureText, MetaImageProps, ResolvedConfig } from "../../types.js";
+/** The trail and the rule under it, along with the room the two take. */
+export interface Chrome {
+    readonly svg: string;
+    /** How far down the image the content below it may start. */
+    readonly bottom: number;
+}
+/**
+ * The trail through the documentation and the rule under it.
+ *
+ * The rule is only drawn where there is a trail above it to separate, since a
+ * line across an image with nothing above it is decoration rather than
+ * structure. `room` is what the trail leaves for the title, and it is nothing
+ * at all when the post named no breadcrumb.
+ */
+export declare function docsChrome(props: MetaImageProps, config: ResolvedConfig, dimensions: Dimensions, pad: number, reserved: number, measure: MeasureText): Chrome;
+//# sourceMappingURL=chrome.d.ts.map

package/dist/templates/docs/chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../../../src/templates/docs/chrome.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACf,MAAM,gBAAgB,CAAC;AAYxB,yEAAyE;AACzE,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,MAAM,CAsCR"}

package/dist/templates/docs/chrome.js

@@ -0,0 +1,44 @@
+import { baselineFor, box, measureIn, stringList, textElement, } from "../../layout/index.js";
+import { crumbLine } from "./crumbs.js";
+/** The trail's size, as a fraction of the image's height. */
+const trailScale = 0.036;
+/** Where the rule under the trail goes, as a fraction of the height. */
+const ruleOffset = 0.058;
+/** Clear space between the rule and the title, as a fraction of the height. */
+const ruleGap = 0.05;
+/**
+ * The trail through the documentation and the rule under it.
+ *
+ * The rule is only drawn where there is a trail above it to separate, since a
+ * line across an image with nothing above it is decoration rather than
+ * structure. `room` is what the trail leaves for the title, and it is nothing
+ * at all when the post named no breadcrumb.
+ */
+export function docsChrome(props, config, dimensions, pad, reserved, measure) {
+    const { width, height } = dimensions;
+    const fontSize = Math.round(height * trailScale);
+    const trail = crumbLine(stringList(props["breadcrumb"]), width - pad * 2 - reserved, measureIn(measure, config.fontFamily, 600), fontSize);
+    if (trail === undefined) {
+        return { svg: "", bottom: 0 };
+    }
+    const ruleY = pad + Math.round(height * ruleOffset);
+    return {
+        svg: textElement(trail, {
+            x: pad,
+            y: baselineFor(pad, fontSize),
+            fontFamily: config.fontFamily,
+            fontSize,
+            fontWeight: 600,
+            fill: config.colors.foreground,
+            fillOpacity: 0.72,
+        }) +
+            box({
+                x: pad,
+                y: ruleY,
+                width: width - pad * 2,
+                height: Math.max(1, Math.round(height * 0.003)),
+            }, { fill: config.colors.foreground, fillOpacity: 0.22 }),
+        bottom: ruleY + Math.round(height * ruleGap),
+    };
+}
+//# sourceMappingURL=chrome.js.map

package/dist/templates/docs/chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.js","sourceRoot":"","sources":["../../../src/templates/docs/chrome.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,GAAG,EACH,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,6DAA6D;AAC7D,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB,wEAAwE;AACxE,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB,+EAA+E;AAC/E,MAAM,OAAO,GAAG,IAAI,CAAC;AASrB;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,KAAqB,EACrB,MAAsB,EACtB,UAAsB,EACtB,GAAW,EACX,QAAgB,EAChB,OAAoB;IAEpB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,SAAS,CACrB,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAC/B,KAAK,GAAG,GAAG,GAAG,CAAC,GAAG,QAAQ,EAC1B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,EAC1C,QAAQ,CACT,CAAC;IAEF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAEpD,OAAO;QACL,GAAG,EACD,WAAW,CAAC,KAAK,EAAE;YACjB,CAAC,EAAE,GAAG;YACN,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ;YACR,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;YAC9B,WAAW,EAAE,IAAI;SAClB,CAAC;YACF,GAAG,CACD;gBACE,CAAC,EAAE,GAAG;gBACN,CAAC,EAAE,KAAK;gBACR,KAAK,EAAE,KAAK,GAAG,GAAG,GAAG,CAAC;gBACtB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;aAChD,EACD,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CACtD;QACH,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/templates/docs/crumbs.d.ts

@@ -0,0 +1,14 @@
+import type { MeasureAt } from "../../layout/index.js";
+/**
+ * The breadcrumb as one line, narrow enough for the width it has.
+ *
+ * Segments are dropped from the front rather than the back, and an ellipsis
+ * put in their place. The trail's last segments say where the page sits and
+ * its first say which site it is on, and the reader can see the site from
+ * everything else in the image.
+ *
+ * It is never wrapped or shrunk. A breadcrumb is chrome: two lines of it would
+ * be competing with the title, which is the thing being shared.
+ */
+export declare function crumbLine(parts: readonly string[], maxWidth: number, measure: MeasureAt, fontSize: number): string | undefined;
+//# sourceMappingURL=crumbs.d.ts.map

package/dist/templates/docs/crumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crumbs.d.ts","sourceRoot":"","sources":["../../../src/templates/docs/crumbs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQvD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAiBpB"}

package/dist/templates/docs/crumbs.js

@@ -0,0 +1,32 @@
+import { clampLine } from "../../layout/index.js";
+/** What goes between two segments of the trail. */
+const separator = " / ";
+/** What stands for the segments that were dropped. */
+const elided = "…";
+/**
+ * The breadcrumb as one line, narrow enough for the width it has.
+ *
+ * Segments are dropped from the front rather than the back, and an ellipsis
+ * put in their place. The trail's last segments say where the page sits and
+ * its first say which site it is on, and the reader can see the site from
+ * everything else in the image.
+ *
+ * It is never wrapped or shrunk. A breadcrumb is chrome: two lines of it would
+ * be competing with the title, which is the thing being shared.
+ */
+export function crumbLine(parts, maxWidth, measure, fontSize) {
+    if (parts.length === 0) {
+        return undefined;
+    }
+    for (let from = 0; from < parts.length; from += 1) {
+        const kept = parts.slice(from);
+        const line = (from === 0 ? kept : [elided, ...kept]).join(separator);
+        if (measure(line, fontSize) <= maxWidth) {
+            return line;
+        }
+    }
+    // Not even the last segment on its own fits, so it is cut to the width
+    // rather than drawn past the margin.
+    return clampLine(parts.at(-1) ?? "", maxWidth, measure, fontSize);
+}
+//# sourceMappingURL=crumbs.js.map

package/dist/templates/docs/crumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crumbs.js","sourceRoot":"","sources":["../../../src/templates/docs/crumbs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,mDAAmD;AACnD,MAAM,SAAS,GAAG,KAAK,CAAC;AAExB,sDAAsD;AACtD,MAAM,MAAM,GAAG,GAAG,CAAC;AAEnB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CACvB,KAAwB,EACxB,QAAgB,EAChB,OAAkB,EAClB,QAAgB;IAEhB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAErE,IAAI,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,QAAQ,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,qCAAqC;IACrC,OAAO,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACpE,CAAC"}

package/dist/templates/docs/index.d.ts

@@ -0,0 +1,13 @@
+import type { Template } from "../../types.js";
+/**
+ * A reference page: the trail through the documentation that leads to it, a
+ * rule, then the page's title and summary.
+ *
+ * Docs pages share badly. Their titles are short and often ambiguous on their
+ * own, since "Fonts" or "Configuration" says nothing about which project's,
+ * and the trail above the title is what a reader needs to place them. It reads
+ * `breadcrumb`, which may be a list or a single string, along with the usual
+ * `title` and `subtitle`.
+ */
+export declare const docsTemplate: Template;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/docs/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,gBAAgB,CAAC;AAOhE;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,EAAE,QAqD1B,CAAC"}

package/dist/templates/docs/index.js

@@ -0,0 +1,47 @@
+import { drawLines } from "../../layout/index.js";
+import { footerLine } from "../bottom.js";
+import { contentArea, imageFrame, markRoom } from "../frame.js";
+import { logoElement, logoRect } from "../logo.js";
+import { docsChrome } from "./chrome.js";
+import { docsLines } from "./lines.js";
+/**
+ * A reference page: the trail through the documentation that leads to it, a
+ * rule, then the page's title and summary.
+ *
+ * Docs pages share badly. Their titles are short and often ambiguous on their
+ * own, since "Fonts" or "Configuration" says nothing about which project's,
+ * and the trail above the title is what a reader needs to place them. It reads
+ * `breadcrumb`, which may be a list or a single string, along with the usual
+ * `title` and `subtitle`.
+ */
+export const docsTemplate = {
+    name: "docs",
+    render({ props, config, dimensions, measure, logo, avatar, }) {
+        const { width, height } = dimensions;
+        const { fontFamily, colors } = config;
+        const frame = imageFrame(dimensions, config, avatar);
+        const { pad } = frame;
+        const mark = logoRect(logo, dimensions, pad, "start");
+        const chrome = docsChrome(props, config, dimensions, pad, markRoom(mark?.width, pad / 2), measure);
+        // The title starts below whichever of the trail and the logo reaches
+        // furthest down. Both are measured from the top of the image, so the room
+        // the content area is asked for is the larger of the two, less the margin
+        // it adds back.
+        const belowMark = markRoom(mark?.height, Math.round(height * 0.03));
+        const belowTrail = Math.max(0, chrome.bottom - pad);
+        const area = contentArea(frame, Math.max(belowMark, belowTrail));
+        const body = drawLines(docsLines(props, {
+            measure,
+            fontFamily,
+            contentWidth: area.width,
+            titleFs: Math.round(height * 0.088),
+            summaryFs: Math.round(height * 0.044),
+            height,
+        }), area, { fontFamily, fill: colors.foreground, lineHeight: 1.28 });
+        return (chrome.svg +
+            logoElement(logo, mark) +
+            body +
+            footerLine(config, frame, width, avatar, measure));
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/templates/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAa;IACpC,IAAI,EAAE,MAAM;IACZ,MAAM,CAAC,EACL,KAAK,EACL,MAAM,EACN,UAAU,EACV,OAAO,EACP,IAAI,EACJ,MAAM,GACU;QAChB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;QACrC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;QACtB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,UAAU,CACvB,KAAK,EACL,MAAM,EACN,UAAU,EACV,GAAG,EACH,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,EAC9B,OAAO,CACR,CAAC;QAEF,qEAAqE;QACrE,0EAA0E;QAC1E,0EAA0E;QAC1E,gBAAgB;QAChB,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;QAEjE,MAAM,IAAI,GAAG,SAAS,CACpB,SAAS,CAAC,KAAK,EAAE;YACf,OAAO;YACP,UAAU;YACV,YAAY,EAAE,IAAI,CAAC,KAAK;YACxB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YACnC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YACrC,MAAM;SACP,CAAC,EACF,IAAI,EACJ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAC1D,CAAC;QAEF,OAAO,CACL,MAAM,CAAC,GAAG;YACV,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;YACvB,IAAI;YACJ,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAClD,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/templates/docs/lines.d.ts

@@ -0,0 +1,14 @@
+import type { TextLine } from "../../layout/index.js";
+import type { MeasureText, MetaImageProps } from "../../types.js";
+/** The space the page's text has, and how to measure it into it. */
+export interface DocsText {
+    readonly measure: MeasureText;
+    readonly fontFamily: string;
+    readonly contentWidth: number;
+    readonly titleFs: number;
+    readonly summaryFs: number;
+    readonly height: number;
+}
+/** The page title, then the summary under it. */
+export declare function docsLines(props: MetaImageProps, text: DocsText): TextLine[];
+//# sourceMappingURL=lines.d.ts.map

package/dist/templates/docs/lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../../src/templates/docs/lines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOlE,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAsB3E"}

package/dist/templates/docs/lines.js

@@ -0,0 +1,29 @@
+import { blockLines } from "../../layout/index.js";
+const maxTitleLines = 3;
+const maxSummaryLines = 3;
+const titleFloor = 0.62;
+const summaryFloor = 0.8;
+/** The page title, then the summary under it. */
+export function docsLines(props, text) {
+    const { measure, fontFamily, contentWidth } = text;
+    return [
+        ...blockLines(props.title, measure, fontFamily, {
+            maxWidth: contentWidth,
+            maxLines: maxTitleLines,
+            fontSize: text.titleFs,
+            floor: titleFloor,
+            fontWeight: 800,
+            opacity: 1,
+        }),
+        ...blockLines(props.subtitle, measure, fontFamily, {
+            maxWidth: contentWidth,
+            maxLines: maxSummaryLines,
+            fontSize: text.summaryFs,
+            floor: summaryFloor,
+            fontWeight: 500,
+            opacity: 0.85,
+            gapBefore: Math.round(text.height * 0.035),
+        }),
+    ];
+}
+//# sourceMappingURL=lines.js.map

package/dist/templates/docs/lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.js","sourceRoot":"","sources":["../../../src/templates/docs/lines.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,YAAY,GAAG,GAAG,CAAC;AAYzB,iDAAiD;AACjD,MAAM,UAAU,SAAS,CAAC,KAAqB,EAAE,IAAc;IAC7D,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAEnD,OAAO;QACL,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE;YAC9C,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,aAAa;YACvB,QAAQ,EAAE,IAAI,CAAC,OAAO;YACtB,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,CAAC;SACX,CAAC;QACF,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE;YACjD,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,eAAe;YACzB,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,KAAK,EAAE,YAAY;YACnB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;SAC3C,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/templates/event/index.d.ts

@@ -0,0 +1,12 @@
+import type { Template } from "../../types.js";
+/**
+ * A talk, a meetup or a workshop: the date on a plate, then what it is and
+ * where. Reads `date`, `title` and `location`.
+ *
+ * The date is set apart on the accent colour rather than being another line of
+ * text, because it is the one thing a reader is scanning for. Nothing here
+ * parses or formats it: whatever the post wrote is what is drawn, since a
+ * build cannot know which locale or how much precision the event wants.
+ */
+export declare const eventTemplate: Template;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/event/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/event/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,gBAAgB,CAAC;AAUhE;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,QA2D3B,CAAC"}

package/dist/templates/event/index.js

@@ -0,0 +1,59 @@
+import { linesHeight, optionalString, stack } from "../../layout/index.js";
+import { drawSlot, footerLine } from "../bottom.js";
+import { contentArea, gapAfter, imageFrame, markRoom } from "../frame.js";
+import { logoElement, logoRect } from "../logo.js";
+import { eventLines } from "./lines.js";
+import { datePlate, plateHeight, plateStyle } from "./plate.js";
+/** How the lines of the title and location are stacked. */
+const lineHeight = 1.24;
+/**
+ * A talk, a meetup or a workshop: the date on a plate, then what it is and
+ * where. Reads `date`, `title` and `location`.
+ *
+ * The date is set apart on the accent colour rather than being another line of
+ * text, because it is the one thing a reader is scanning for. Nothing here
+ * parses or formats it: whatever the post wrote is what is drawn, since a
+ * build cannot know which locale or how much precision the event wants.
+ */
+export const eventTemplate = {
+    name: "event",
+    render({ props, config, dimensions, measure, logo, avatar, }) {
+        const { width, height } = dimensions;
+        const { fontFamily, colors } = config;
+        const frame = imageFrame(dimensions, config, avatar, {
+            padScale: 0.09,
+        });
+        const { pad } = frame;
+        const mark = logoRect(logo, dimensions, pad, "middle");
+        const area = contentArea(frame, markRoom(mark?.height, pad / 2));
+        const lines = eventLines(props, {
+            measure,
+            fontFamily,
+            contentWidth: area.width,
+            titleFs: Math.round(height * 0.095),
+            locationFs: Math.round(height * 0.045),
+            height,
+        });
+        const date = optionalString(props["date"]) ?? "";
+        const plate = plateHeight(date, height);
+        const [dateSlot, textSlot] = stack([
+            { size: plate },
+            {
+                size: linesHeight(lines, lineHeight),
+                gapBefore: gapAfter(plate, Math.round(height * 0.045)),
+            },
+        ], area);
+        const body = drawSlot(lines, textSlot, {
+            fontFamily,
+            fill: colors.foreground,
+            lineHeight,
+            anchor: "middle",
+        });
+        const footer = footerLine(config, frame, width, avatar, measure, "middle");
+        return (logoElement(logo, mark) +
+            datePlate(date, dateSlot, plateStyle(config), measure) +
+            body +
+            footer);
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/templates/event/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/event/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE3E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE,2DAA2D;AAC3D,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAa;IACrC,IAAI,EAAE,OAAO;IACb,MAAM,CAAC,EACL,KAAK,EACL,MAAM,EACN,UAAU,EACV,OAAO,EACP,IAAI,EACJ,MAAM,GACU;QAChB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;QACrC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE;YACnD,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;QACtB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAEjE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE;YAC9B,OAAO;YACP,UAAU;YACV,YAAY,EAAE,IAAI,CAAC,KAAK;YACxB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YACnC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YACtC,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAExC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,KAAK,CAChC;YACE,EAAE,IAAI,EAAE,KAAK,EAAE;YACf;gBACE,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC;gBACpC,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;aACvD;SACF,EACD,IAAI,CACL,CAAC;QAEF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE;YACrC,UAAU;YACV,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,UAAU;YACV,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE3E,OAAO,CACL,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;YACvB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;YACtD,IAAI;YACJ,MAAM,CACP,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/templates/event/lines.d.ts

@@ -0,0 +1,14 @@
+import type { TextLine } from "../../layout/index.js";
+import type { MeasureText, MetaImageProps } from "../../types.js";
+/** The space the event's text has, and how to measure it into it. */
+export interface EventText {
+    readonly measure: MeasureText;
+    readonly fontFamily: string;
+    readonly contentWidth: number;
+    readonly titleFs: number;
+    readonly locationFs: number;
+    readonly height: number;
+}
+/** What the event is, then where it is. */
+export declare function eventLines(props: MetaImageProps, text: EventText): TextLine[];
+//# sourceMappingURL=lines.d.ts.map

package/dist/templates/event/lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../../src/templates/event/lines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOlE,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2CAA2C;AAC3C,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,EAAE,CAsB7E"}

package/dist/templates/event/lines.js

@@ -0,0 +1,29 @@
+import { blockLines } from "../../layout/index.js";
+const maxTitleLines = 3;
+const maxLocationLines = 2;
+const titleFloor = 0.6;
+const locationFloor = 0.8;
+/** What the event is, then where it is. */
+export function eventLines(props, text) {
+    const { measure, fontFamily, contentWidth } = text;
+    return [
+        ...blockLines(props.title, measure, fontFamily, {
+            maxWidth: contentWidth,
+            maxLines: maxTitleLines,
+            fontSize: text.titleFs,
+            floor: titleFloor,
+            fontWeight: 800,
+            opacity: 1,
+        }),
+        ...blockLines(props["location"], measure, fontFamily, {
+            maxWidth: contentWidth,
+            maxLines: maxLocationLines,
+            fontSize: text.locationFs,
+            floor: locationFloor,
+            fontWeight: 500,
+            opacity: 0.85,
+            gapBefore: Math.round(text.height * 0.035),
+        }),
+    ];
+}
+//# sourceMappingURL=lines.js.map

package/dist/templates/event/lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.js","sourceRoot":"","sources":["../../../src/templates/event/lines.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,aAAa,GAAG,GAAG,CAAC;AAY1B,2CAA2C;AAC3C,MAAM,UAAU,UAAU,CAAC,KAAqB,EAAE,IAAe;IAC/D,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAEnD,OAAO;QACL,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE;YAC9C,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,aAAa;YACvB,QAAQ,EAAE,IAAI,CAAC,OAAO;YACtB,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,CAAC;SACX,CAAC;QACF,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE;YACpD,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,gBAAgB;YAC1B,QAAQ,EAAE,IAAI,CAAC,UAAU;YACzB,KAAK,EAAE,aAAa;YACpB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;SAC3C,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/templates/event/plate.d.ts

@@ -0,0 +1,16 @@
+import type { Rect } from "../../layout/index.js";
+import type { MeasureText, ResolvedConfig } from "../../types.js";
+import type { PillStyle } from "../pill.js";
+/** How the date's plate is filled and set. */
+export declare function plateStyle(config: ResolvedConfig): PillStyle;
+/** How tall the plate is, or nothing at all where the post named no date. */
+export declare function plateHeight(date: string, imageHeight: number): number;
+/**
+ * The date on its plate, centred in the slot the stack gave it, or nothing
+ * where the post named no date.
+ *
+ * The slot is the full width of the content area, since that is what a stack
+ * hands back, and the plate is only as wide as the words on it.
+ */
+export declare function datePlate(date: string, slot: Rect | undefined, style: PillStyle, measure: MeasureText): string;
+//# sourceMappingURL=plate.d.ts.map

package/dist/templates/event/plate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plate.d.ts","sourceRoot":"","sources":["../../../src/templates/event/plate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAO5D;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,GACnB,MAAM,CAiBR"}

package/dist/templates/event/plate.js

@@ -0,0 +1,36 @@
+import { pill, pillWidth } from "../pill.js";
+/** The plate's height, as a fraction of the image's. */
+const plateScale = 0.07;
+/** How the date's plate is filled and set. */
+export function plateStyle(config) {
+    return {
+        fontFamily: config.fontFamily,
+        fontWeight: 700,
+        fill: config.colors.foreground,
+        background: config.colors.brandWarm,
+    };
+}
+/** How tall the plate is, or nothing at all where the post named no date. */
+export function plateHeight(date, imageHeight) {
+    return date === "" ? 0 : Math.round(imageHeight * plateScale);
+}
+/**
+ * The date on its plate, centred in the slot the stack gave it, or nothing
+ * where the post named no date.
+ *
+ * The slot is the full width of the content area, since that is what a stack
+ * hands back, and the plate is only as wide as the words on it.
+ */
+export function datePlate(date, slot, style, measure) {
+    if (date === "" || slot === undefined || slot.height === 0) {
+        return "";
+    }
+    const width = pillWidth(date, slot.height, style, measure);
+    return pill(date, {
+        x: Math.round(slot.x + (slot.width - width) / 2),
+        y: slot.y,
+        width,
+        height: slot.height,
+    }, style);
+}
+//# sourceMappingURL=plate.js.map

package/dist/templates/event/plate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plate.js","sourceRoot":"","sources":["../../../src/templates/event/plate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7C,wDAAwD;AACxD,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CAAC,MAAsB;IAC/C,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;QAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS;KACpC,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,WAAmB;IAC3D,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,UAAU,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,IAAsB,EACtB,KAAgB,EAChB,OAAoB;IAEpB,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAE3D,OAAO,IAAI,CACT,IAAI,EACJ;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,KAAK,CACN,CAAC;AACJ,CAAC"}