@kensio/colophon 2.2.0 → 2.4.0

package/dist/templates/code/spans.js

@@ -0,0 +1,36 @@
+import { escapeXml } from "../../layout/index.js";
+/** Fraction of the font size the baseline sits below the glyph box top. */
+const ascentRatio = 0.78;
+function tokenSpan(token, x, charWidth, foreground) {
+    const fill = token.color ?? foreground;
+    const opacity = token.opacity === undefined
+        ? ""
+        : ` fill-opacity="${String(token.opacity)}"`;
+    const weight = token.bold ? ` font-weight="700"` : "";
+    const style = token.italic ? ` font-style="italic"` : "";
+    return (`<tspan x="${String(Math.round(x + token.column * charWidth))}"` +
+        ` fill="${fill}"${opacity}${weight}${style}>` +
+        `${escapeXml(token.text)}</tspan>`);
+}
+/**
+ * The snippet as one `<text>` element per line, each token positioned
+ * absolutely from its character column so indentation survives SVG text flow.
+ */
+export function codeBody(lines, metrics) {
+    const { originX, originY, fontSize, charWidth, step } = metrics;
+    return lines
+        .map((tokens, index) => {
+        if (tokens.length === 0) {
+            return "";
+        }
+        const baseline = Math.round(originY + index * step + (step - fontSize) / 2 + fontSize * ascentRatio);
+        const spans = tokens
+            .map((token) => tokenSpan(token, originX, charWidth, metrics.foreground))
+            .join("");
+        return (`<text y="${String(baseline)}" xml:space="preserve"` +
+            ` font-family="${escapeXml(metrics.fontFamily)}"` +
+            ` font-size="${String(fontSize)}">${spans}</text>`);
+    })
+        .join("");
+}
+//# sourceMappingURL=spans.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spans.js","sourceRoot":"","sources":["../../../src/templates/code/spans.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,2EAA2E;AAC3E,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB,SAAS,SAAS,CAChB,KAAgB,EAChB,CAAS,EACT,SAAiB,EACjB,UAAkB;IAElB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC;IACvC,MAAM,OAAO,GACX,KAAK,CAAC,OAAO,KAAK,SAAS;QACzB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzD,OAAO,CACL,aAAa,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG;QAChE,UAAU,IAAI,IAAI,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG;QAC7C,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CACnC,CAAC;AACJ,CAAC;AAeD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAwC,EACxC,OAAoB;IAEpB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEhE,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACrB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,GAAG,WAAW,CACxE,CAAC;QACF,MAAM,KAAK,GAAG,MAAM;aACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACb,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CACzD;aACA,IAAI,CAAC,EAAE,CAAC,CAAC;QAEZ,OAAO,CACL,YAAY,MAAM,CAAC,QAAQ,CAAC,wBAAwB;YACpD,iBAAiB,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG;YACjD,eAAe,MAAM,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CACnD,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { Dimensions, ResolvedConfig } from "../../types.js";
+/**
+ * Tell the author when the snippet did not fit. Nothing in a finished image
+ * says the sample continued, so silent truncation is how a half-a-function
+ * share card ends up on someone else's timeline.
+ */
+export declare function warnIfTruncated(config: ResolvedConfig, dimensions: Dimensions, counts: {
+    readonly dropped: number;
+    readonly clipped: number;
+}, total: number): void;
+//# sourceMappingURL=warn.d.ts.map

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

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

package/dist/templates/code/warn.js

@@ -0,0 +1,24 @@
+function plural(count, noun) {
+    return `${String(count)} ${noun}${count === 1 ? "" : "s"}`;
+}
+/**
+ * Tell the author when the snippet did not fit. Nothing in a finished image
+ * 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) {
+    const parts = [];
+    if (counts.dropped > 0) {
+        parts.push(`${String(counts.dropped)} of ${plural(total, "line")} dropped`);
+    }
+    if (counts.clipped > 0) {
+        parts.push(`${plural(counts.clipped, "line")} clipped to the panel width`);
+    }
+    if (parts.length === 0) {
+        return;
+    }
+    config.onWarning(`code snippet 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.`);
+}
+//# sourceMappingURL=warn.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { MeasureText } from "../../types.js";
+/**
+ * Width of one character as a fraction of the font size.
+ *
+ * The template lays every token out on a character grid, so this is what says
+ * where each column falls. Measuring a digit is enough because the face is
+ * monospace: whichever character is measured, the advance is the same.
+ */
+export declare function charWidthRatio(measure: MeasureText, fontFamily: string): number;
+//# sourceMappingURL=width.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"width.d.ts","sourceRoot":"","sources":["../../../src/templates/code/width.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAalD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,CAOR"}

package/dist/templates/code/width.js

@@ -0,0 +1,26 @@
+/**
+ * Advance width to assume when the monospace stack names no font the build
+ * loaded. `0.6` suits most monospace faces, including Source Code Pro, Menlo
+ * and DejaVu Sans Mono; Consolas is nearer `0.55`.
+ *
+ * This used to be `config.code.charWidthRatio`, a number every project had to
+ * work out for itself and keep in step with its font. It is a fallback now:
+ * supply the face as a file and the real advance is read from it.
+ */
+const fallbackRatio = 0.6;
+/**
+ * Width of one character as a fraction of the font size.
+ *
+ * The template lays every token out on a character grid, so this is what says
+ * where each column falls. Measuring a digit is enough because the face is
+ * monospace: whichever character is measured, the advance is the same.
+ */
+export function charWidthRatio(measure, fontFamily) {
+    return measure("0", {
+        fontFamily,
+        fontSize: 1,
+        fontWeight: 400,
+        fallbackRatio,
+    });
+}
+//# sourceMappingURL=width.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"width.js","sourceRoot":"","sources":["../../../src/templates/code/width.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAoB,EACpB,UAAkB;IAElB,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,UAAU;QACV,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,GAAG;QACf,aAAa;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/templates/footer.d.ts

@@ -0,0 +1,29 @@
+import type { ResolvedConfig } from "../types.js";
+/**
+ * Where and how a template wants its footer drawn. Every template places the
+ * footer differently; what they share is that a config with no footer, or an
+ * empty one, draws nothing at all.
+ */
+export interface FooterPlacement {
+    readonly x: number;
+    readonly y: number;
+    readonly fontSize: number;
+    readonly opacity: number;
+    readonly anchor?: "start" | "middle" | "end";
+}
+/**
+ * The baseline of a footer sitting on the bottom margin.
+ *
+ * The margin is where the line's ink stops rather than where its baseline
+ * goes, so the last line of an image keeps the same clear space below it as
+ * the content beside it has either side, and the descenders stay inside it.
+ */
+export declare function footerBaseline(height: number, pad: number, fontSize: number): number;
+/** Whether the config carries a footer worth drawing. */
+export declare function hasFooter(config: ResolvedConfig): boolean;
+/**
+ * The configured footer as a `<text>` element, or an empty string when there
+ * is none. Templates call this unconditionally and let it decide.
+ */
+export declare function footerElement(config: ResolvedConfig, placement: FooterPlacement): string;
+//# sourceMappingURL=footer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../../src/templates/footer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,eAAe,GACzB,MAAM,CAeR"}

package/dist/templates/footer.js

@@ -0,0 +1,35 @@
+import { baselineFor, textElement } from "../layout/index.js";
+/**
+ * The baseline of a footer sitting on the bottom margin.
+ *
+ * The margin is where the line's ink stops rather than where its baseline
+ * goes, so the last line of an image keeps the same clear space below it as
+ * the content beside it has either side, and the descenders stay inside it.
+ */
+export function footerBaseline(height, pad, fontSize) {
+    return baselineFor(height - pad - fontSize, fontSize);
+}
+/** Whether the config carries a footer worth drawing. */
+export function hasFooter(config) {
+    return config.footer !== undefined && config.footer !== "";
+}
+/**
+ * The configured footer as a `<text>` element, or an empty string when there
+ * is none. Templates call this unconditionally and let it decide.
+ */
+export function footerElement(config, placement) {
+    if (!hasFooter(config)) {
+        return "";
+    }
+    return textElement(config.footer ?? "", {
+        x: placement.x,
+        y: placement.y,
+        fontFamily: config.fontFamily,
+        fontSize: placement.fontSize,
+        fontWeight: 500,
+        fill: config.colors.foreground,
+        fillOpacity: placement.opacity,
+        ...(placement.anchor !== undefined && { anchor: placement.anchor }),
+    });
+}
+//# sourceMappingURL=footer.js.map

package/dist/templates/footer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer.js","sourceRoot":"","sources":["../../src/templates/footer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgB9D;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,GAAW,EACX,QAAgB;IAEhB,OAAO,WAAW,CAAC,MAAM,GAAG,GAAG,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,MAAsB;IAC9C,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAsB,EACtB,SAA0B;IAE1B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE;QACtC,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;QAC9B,WAAW,EAAE,SAAS,CAAC,OAAO;QAC9B,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;KACpE,CAAC,CAAC;AACL,CAAC"}

package/dist/templates/index.d.ts

@@ -4,8 +4,8 @@ import type { Template } from "../types.js";
  * via `config.templates`.
  */
 export declare const builtinTemplates: Readonly<Record<string, Template>>;
-export { bannerTemplate } from "./banner.js";
-export { cardTemplate } from "./card.js";
-export { codeTemplate } from "./code.js";
-export { optionalString } from "./props.js";
+export { bannerTemplate } from "./banner/index.js";
+export { cardTemplate } from "./card/index.js";
+export { codeTemplate } from "./code/index.js";
+export { optionalString } from "../props.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAI/D,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAI/D,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/templates/index.js

@@ -1,6 +1,6 @@
-import { bannerTemplate } from "./banner.js";
-import { cardTemplate } from "./card.js";
-import { codeTemplate } from "./code.js";
+import { bannerTemplate } from "./banner/index.js";
+import { cardTemplate } from "./card/index.js";
+import { codeTemplate } from "./code/index.js";
 /**
  * Templates registered out of the box. Projects can add to or override these
  * via `config.templates`.
@@ -10,8 +10,8 @@ export const builtinTemplates = {
     [cardTemplate.name]: cardTemplate,
     [codeTemplate.name]: codeTemplate,
 };
-export { bannerTemplate } from "./banner.js";
-export { cardTemplate } from "./card.js";
-export { codeTemplate } from "./code.js";
-export { optionalString } from "./props.js";
+export { bannerTemplate } from "./banner/index.js";
+export { cardTemplate } from "./card/index.js";
+export { codeTemplate } from "./code/index.js";
+export { optionalString } from "../props.js";
 //# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuC;IAClE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,cAAc;IACrC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,YAAY;IACjC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,YAAY;CAClC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuC;IAClE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,cAAc;IACrC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,YAAY;IACjC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,YAAY;CAClC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/templates/logo.d.ts

@@ -0,0 +1,15 @@
+import type { Rect } from "../layout/index.js";
+import type { Dimensions, ImageAsset } from "../types.js";
+/**
+ * Where the logo goes, or nothing where there is none.
+ *
+ * Its height comes from the image being drawn rather than from the logo's own
+ * pixels, so the same file works on a square and a landscape, and its width
+ * follows from the proportions of the picture. A logo whose format does not
+ * state its size is drawn in a square, where a wordmark will sit small in the
+ * middle rather than being stretched to fit.
+ */
+export declare function logoRect(logo: ImageAsset | undefined, dimensions: Dimensions, pad: number, align: "start" | "middle"): Rect | undefined;
+/** The logo drawn in the rectangle it was given, whole rather than cropped. */
+export declare function logoElement(logo: ImageAsset | undefined, rect: Rect | undefined): string;
+//# sourceMappingURL=logo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../../src/templates/logo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK1D;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GAAG,QAAQ,GACxB,IAAI,GAAG,SAAS,CAalB;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,IAAI,EAAE,IAAI,GAAG,SAAS,GACrB,MAAM,CAIR"}

package/dist/templates/logo.js

@@ -0,0 +1,30 @@
+import { image } from "../layout/index.js";
+/** The logo's height, as a fraction of the image's. */
+const logoScale = 0.075;
+/**
+ * Where the logo goes, or nothing where there is none.
+ *
+ * Its height comes from the image being drawn rather than from the logo's own
+ * pixels, so the same file works on a square and a landscape, and its width
+ * follows from the proportions of the picture. A logo whose format does not
+ * state its size is drawn in a square, where a wordmark will sit small in the
+ * middle rather than being stretched to fit.
+ */
+export function logoRect(logo, dimensions, pad, align) {
+    if (logo === undefined) {
+        return undefined;
+    }
+    const height = Math.round(dimensions.height * logoScale);
+    const width = Math.round(height * logo.aspect);
+    const x = align === "middle"
+        ? Math.round((dimensions.width - width) / 2)
+        : dimensions.width - pad - width;
+    return { x, y: pad, width, height };
+}
+/** The logo drawn in the rectangle it was given, whole rather than cropped. */
+export function logoElement(logo, rect) {
+    return logo === undefined || rect === undefined
+        ? ""
+        : image(rect, logo.href, { fit: "contain" });
+}
+//# sourceMappingURL=logo.js.map

package/dist/templates/logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.js","sourceRoot":"","sources":["../../src/templates/logo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,uDAAuD;AACvD,MAAM,SAAS,GAAG,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CACtB,IAA4B,EAC5B,UAAsB,EACtB,GAAW,EACX,KAAyB;IAEzB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,GACL,KAAK,KAAK,QAAQ;QAChB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,CAAC,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;IAErC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CACzB,IAA4B,EAC5B,IAAsB;IAEtB,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;QAC7C,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/templates/measure.d.ts

@@ -0,0 +1,11 @@
+import type { MeasureAt } from "../text/index.js";
+import type { MeasureText } from "../types.js";
+/**
+ * Bind a measurer to one family and weight, leaving only the size open.
+ *
+ * That is the shape fitting text wants, since choosing a size is the whole of
+ * what it varies, and it keeps a template from repeating the family and weight
+ * on every call.
+ */
+export declare function measureIn(measure: MeasureText, fontFamily: string, fontWeight: number): MeasureAt;
+//# sourceMappingURL=measure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/templates/measure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,SAAS,CAGX"}

package/dist/templates/measure.js

@@ -0,0 +1,11 @@
+/**
+ * Bind a measurer to one family and weight, leaving only the size open.
+ *
+ * That is the shape fitting text wants, since choosing a size is the whole of
+ * what it varies, and it keeps a template from repeating the family and weight
+ * on every call.
+ */
+export function measureIn(measure, fontFamily, fontWeight) {
+    return (text, fontSize) => measure(text, { fontFamily, fontSize, fontWeight });
+}
+//# sourceMappingURL=measure.js.map

package/dist/templates/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.js","sourceRoot":"","sources":["../../src/templates/measure.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,OAAoB,EACpB,UAAkB,EAClB,UAAkB;IAElB,OAAO,CAAC,IAAY,EAAE,QAAgB,EAAU,EAAE,CAChD,OAAO,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;AACxD,CAAC"}

package/dist/templates/props.d.ts

@@ -1,7 +1,7 @@
 /**
  * Read a prop as a string, coercing the scalar types YAML frontmatter yields
- * (numbers, booleans) and returning `undefined` for anything else — templates
- * treat "not a usable string" and "absent" the same way.
+ * (numbers, booleans) and returning `undefined` for anything else, since
+ * templates treat "not a usable string" and "absent" the same way.
  */
 export declare function optionalString(value: unknown): string | undefined;
 //# sourceMappingURL=props.d.ts.map

package/dist/templates/props.js

@@ -1,7 +1,7 @@
 /**
  * Read a prop as a string, coercing the scalar types YAML frontmatter yields
- * (numbers, booleans) and returning `undefined` for anything else — templates
- * treat "not a usable string" and "absent" the same way.
+ * (numbers, booleans) and returning `undefined` for anything else, since
+ * templates treat "not a usable string" and "absent" the same way.
  */
 export function optionalString(value) {
     if (typeof value === "string") {

package/dist/templates/text.d.ts

@@ -0,0 +1,37 @@
+import type { MeasureText } from "../types.js";
+/** One group of a template's text: the space it has and how it is drawn. */
+export interface TextBlock {
+    readonly maxWidth: number;
+    readonly maxLines: number;
+    readonly fontSize: number;
+    /**
+     * Fraction of `fontSize` this group may shrink to before it is cut instead.
+     * The title of a layout has the furthest to fall, because it is the line
+     * worth keeping whole; a subtitle that has shrunk much has stopped being
+     * readable in a feed, so it may as well lose its tail.
+     */
+    readonly floor: number;
+    readonly fontWeight: number;
+}
+/** A block along with how the lines it produces are drawn. */
+export interface StyledBlock extends TextBlock {
+    readonly opacity: number;
+    /** Space inserted before the group's first line, to separate it from the last. */
+    readonly gapBefore?: number;
+}
+/** One line of a template's text block, ready to be stacked and drawn. */
+export interface TextLine {
+    readonly text: string;
+    readonly fontSize: number;
+    readonly fontWeight: number;
+    readonly opacity: number;
+    readonly gapBefore?: number;
+}
+/**
+ * Fit one group of a template's text, from a prop that may not be there, and
+ * return its lines. Each group is fitted on its own, so a long title shrinking
+ * does not drag the subtitle down with it. A group whose prop is absent or
+ * empty produces no lines at all.
+ */
+export declare function blockLines(value: unknown, measure: MeasureText, fontFamily: string, block: StyledBlock): TextLine[];
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/templates/text.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,0EAA0E;AAC1E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,GACjB,QAAQ,EAAE,CAoBZ"}

package/dist/templates/text.js

@@ -0,0 +1,26 @@
+import { fitText } from "../text/index.js";
+import { measureIn } from "./measure.js";
+import { optionalString } from "./props.js";
+/**
+ * Fit one group of a template's text, from a prop that may not be there, and
+ * return its lines. Each group is fitted on its own, so a long title shrinking
+ * does not drag the subtitle down with it. A group whose prop is absent or
+ * empty produces no lines at all.
+ */
+export function blockLines(value, measure, fontFamily, block) {
+    const fitted = fitText(optionalString(value) ?? "", measureIn(measure, fontFamily, block.fontWeight), {
+        maxWidth: block.maxWidth,
+        maxLines: block.maxLines,
+        fontSize: block.fontSize,
+        minFontSize: Math.round(block.fontSize * block.floor),
+    });
+    return fitted.lines.map((text, index) => ({
+        text,
+        fontSize: fitted.fontSize,
+        fontWeight: block.fontWeight,
+        opacity: block.opacity,
+        ...(index === 0 &&
+            block.gapBefore !== undefined && { gapBefore: block.gapBefore }),
+    }));
+}
+//# sourceMappingURL=text.js.map

package/dist/templates/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/templates/text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiC5C;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,KAAc,EACd,OAAoB,EACpB,UAAkB,EAClB,KAAkB;IAElB,MAAM,MAAM,GAAe,OAAO,CAChC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,EAC3B,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EAChD;QACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC;KACtD,CACF,CAAC;IAEF,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,KAAK,CAAC;YACb,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;KACnE,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/text/break.d.ts

@@ -0,0 +1,11 @@
+import type { MeasureLine } from "./wrap.js";
+/**
+ * Break one word across as many lines as it takes, for a word that is wider
+ * than the line it has to fit on. A URL, a compound German noun, or a whole
+ * Japanese sentence, which has no spaces to break at in the first place.
+ *
+ * Always returns at least one piece, even where a single character is wider
+ * than the line: overflowing by one glyph beats looping forever.
+ */
+export declare function breakWord(word: string, maxWidth: number, measure: MeasureLine): string[];
+//# sourceMappingURL=break.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"break.d.ts","sourceRoot":"","sources":["../../src/text/break.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAS7C;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,MAAM,EAAE,CAgBV"}

package/dist/text/break.js

@@ -0,0 +1,30 @@
+/**
+ * Grapheme segmentation, so a break never lands inside an emoji or between a
+ * letter and the accent that belongs to it. Built once, since a build breaks
+ * a great many words and the segmenter carries locale data with it.
+ */
+const graphemes = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+/**
+ * Break one word across as many lines as it takes, for a word that is wider
+ * than the line it has to fit on. A URL, a compound German noun, or a whole
+ * Japanese sentence, which has no spaces to break at in the first place.
+ *
+ * Always returns at least one piece, even where a single character is wider
+ * than the line: overflowing by one glyph beats looping forever.
+ */
+export function breakWord(word, maxWidth, measure) {
+    const pieces = [];
+    let current = "";
+    for (const { segment } of graphemes.segment(word)) {
+        const next = current + segment;
+        if (current !== "" && measure(next) > maxWidth) {
+            pieces.push(current);
+            current = segment;
+        }
+        else {
+            current = next;
+        }
+    }
+    return current === "" ? [word] : [...pieces, current];
+}
+//# sourceMappingURL=break.js.map

package/dist/text/break.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"break.js","sourceRoot":"","sources":["../../src/text/break.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,QAAgB,EAChB,OAAoB;IAEpB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;QAE/B,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/text/element.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Attributes accepted by {@link textElement}. Colour and opacity are optional.
+ */
+export interface TextAttributes {
+    readonly x: number;
+    readonly y: number;
+    readonly fontFamily: string;
+    readonly fontSize: number;
+    readonly fontWeight: number;
+    readonly fill: string;
+    readonly fillOpacity?: number;
+    readonly anchor?: "start" | "middle" | "end";
+}
+/**
+ * Build a single `<text>` element. The content is XML-escaped.
+ */
+export declare function textElement(content: string, attributes: TextAttributes): string;
+//# sourceMappingURL=element.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../src/text/element.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,cAAc,GACzB,MAAM,CAkBR"}

package/dist/text/element.js

@@ -0,0 +1,19 @@
+import { escapeXml } from "./escape.js";
+/**
+ * Build a single `<text>` element. The content is XML-escaped.
+ */
+export function textElement(content, attributes) {
+    const opacity = attributes.fillOpacity === undefined
+        ? ""
+        : ` fill-opacity="${String(attributes.fillOpacity)}"`;
+    const anchor = attributes.anchor === undefined
+        ? ""
+        : ` text-anchor="${attributes.anchor}"`;
+    return (`<text x="${String(attributes.x)}" y="${String(attributes.y)}"` +
+        ` font-family="${escapeXml(attributes.fontFamily)}"` +
+        ` font-size="${String(attributes.fontSize)}"` +
+        ` font-weight="${String(attributes.fontWeight)}"` +
+        ` fill="${attributes.fill}"${opacity}${anchor}>` +
+        `${escapeXml(content)}</text>`);
+}
+//# sourceMappingURL=element.js.map

package/dist/text/element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.js","sourceRoot":"","sources":["../../src/text/element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgBxC;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,UAA0B;IAE1B,MAAM,OAAO,GACX,UAAU,CAAC,WAAW,KAAK,SAAS;QAClC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,kBAAkB,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC;IAC1D,MAAM,MAAM,GACV,UAAU,CAAC,MAAM,KAAK,SAAS;QAC7B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,iBAAiB,UAAU,CAAC,MAAM,GAAG,CAAC;IAE5C,OAAO,CACL,YAAY,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;QAC/D,iBAAiB,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG;QACpD,eAAe,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG;QAC7C,iBAAiB,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG;QACjD,UAAU,UAAU,CAAC,IAAI,IAAI,OAAO,GAAG,MAAM,GAAG;QAChD,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAC/B,CAAC;AACJ,CAAC"}

package/dist/text/escape.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Escape a string for safe inclusion in SVG/XML text content or attributes.
+ */
+export declare function escapeXml(value: string): string;
+//# sourceMappingURL=escape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../src/text/escape.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C"}

package/dist/text/escape.js

@@ -0,0 +1,12 @@
+/**
+ * Escape a string for safe inclusion in SVG/XML text content or attributes.
+ */
+export function escapeXml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+//# sourceMappingURL=escape.js.map

package/dist/text/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../src/text/escape.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/B,CAAC"}

package/dist/text/fit.d.ts

@@ -0,0 +1,30 @@
+/** The width a run of text would be drawn at, at a given font size. */
+export type MeasureAt = (text: string, fontSize: number) => number;
+/** The space a block of text has, and the sizes it may be drawn at. */
+export interface FitOptions {
+    readonly maxWidth: number;
+    readonly maxLines: number;
+    /** The size to draw at when the text fits at it. */
+    readonly fontSize: number;
+    /** The size below which shrinking costs more legibility than it is worth. */
+    readonly minFontSize: number;
+}
+/** A block of text with the size it turned out to fit at. */
+export interface FittedText {
+    readonly lines: readonly string[];
+    readonly fontSize: number;
+}
+/**
+ * Wrap text into the space it has, shrinking it until it fits.
+ *
+ * The alternative, and what Colophon did before it could measure anything, is
+ * to wrap at one size and drop whatever is left over. That reads as a mistake
+ * rather than a design: a long title loses its last few words, and the image
+ * says something the post does not. Shrinking keeps the words.
+ *
+ * It only shrinks so far, because a title small enough to fit anything is a
+ * title nobody reads in a feed. Text that still does not fit at the floor is
+ * cut to `maxLines` as before.
+ */
+export declare function fitText(text: string, measure: MeasureAt, options: FitOptions): FittedText;
+//# sourceMappingURL=fit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fit.d.ts","sourceRoot":"","sources":["../../src/text/fit.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnE,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,UAAU,GAClB,UAAU,CAiBZ"}