@kensio/colophon 2.5.0 → 2.6.0

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"}

package/dist/templates/frame.d.ts

@@ -0,0 +1,68 @@
+import type { Rect } from "../layout/index.js";
+import type { Dimensions, ImageAsset, ResolvedConfig } from "../types.js";
+/**
+ * The measurements every template starts from: where its margins are, and what
+ * the line along the bottom leaves it.
+ *
+ * Each of the built-ins worked these out for itself, which was fine while there
+ * were three of them and is nine copies of the same arithmetic now. The values
+ * are the ones the layouts already used, so what this replaces is the repetition
+ * rather than the decisions.
+ */
+export interface Frame {
+    /** The margin, applied to every edge. */
+    readonly pad: number;
+    readonly footerFontSize: number;
+    /** The whole image, as the rectangle the content is inset from. */
+    readonly full: Rect;
+    /**
+     * Vertical room to leave below the content, which is the footer line plus
+     * its clear space, or nothing at all where there is no footer to draw.
+     */
+    readonly footerRoom: number;
+    /** The baseline that footer sits on, whether or not there is one. */
+    readonly footerY: number;
+}
+/** What a template can tell the frame about itself. */
+export interface FrameOptions {
+    /** The margin, as a fraction of the image's width. */
+    readonly padScale?: number;
+    /**
+     * Whether the template draws something of its own on the bottom line, such
+     * as a byline, so the room is left for it even where the config has no
+     * footer and the post has no avatar.
+     */
+    readonly footer?: boolean;
+}
+/**
+ * Work out a template's frame. The avatar counts as a footer even where the
+ * config carries no text, since the picture is drawn on the same line and
+ * needs the same room.
+ */
+export declare function imageFrame(dimensions: Dimensions, config: ResolvedConfig, avatar: ImageAsset | undefined, options?: FrameOptions): Frame;
+/**
+ * The room a mark along the top of the image takes, including the clear space
+ * under it, or nothing at all where there is no mark.
+ *
+ * A height of nothing is the same as no mark, since the gap under a mark that
+ * is not there is the space a template would then be reserving for nobody.
+ */
+export declare function markRoom(height: number | undefined, gap: number): number;
+/**
+ * The space a template's content has: the whole image, less the margins, less
+ * whatever sits along the top, less the footer line.
+ *
+ * `top` is what {@link markRoom} worked out, or whatever else the template put
+ * up there. It is extra: the margin is added here, so a template with nothing
+ * along the top passes nothing.
+ */
+export declare function contentArea(frame: Frame, top?: number): Rect;
+/**
+ * A gap that is only there when the thing before it is.
+ *
+ * Stacking a group that a post may not have given anything to means the space
+ * above it has to disappear along with it, or the layout keeps a hole where
+ * the missing part was.
+ */
+export declare function gapAfter(size: number, gap: number): number;
+//# sourceMappingURL=frame.d.ts.map

package/dist/templates/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/templates/frame.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAW1E;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,GAAE,YAAiB,GACzB,KAAK,CAcP;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,SAAI,GAAG,IAAI,CAOvD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D"}