@kensio/colophon 2.2.0 → 2.4.0

package/dist/manifest/page.js

@@ -0,0 +1,55 @@
+import { byName } from "./order.js";
+/** How landscape an image is. The most landscape one is what `widest` names. */
+function ratio(job) {
+    return job.size.width / job.size.height;
+}
+/** Start a page off from the first job that draws it. */
+export function startPage(job) {
+    return { jobs: [job], widest: job };
+}
+/**
+ * Add another size of the same page. Ties keep the size configured first,
+ * since `>` leaves the incumbent in place.
+ */
+export function addToPage(page, job) {
+    page.jobs.push(job);
+    if (ratio(job) > ratio(page.widest)) {
+        page.widest = job;
+    }
+}
+/**
+ * Reject two pages sharing a slug.
+ *
+ * The manifest is keyed by slug, so a site looking a page up would find
+ * whichever was written last. That is an image quietly belonging to the wrong
+ * post, which is worse than no manifest at all. Their images may well be
+ * distinct on disk, so nothing else in the build has any reason to complain.
+ */
+function assertOnePage(slug, page) {
+    const paths = [...new Set(page.jobs.map((job) => job.contentPath))];
+    if (paths.length > 1) {
+        throw new Error(`Two pages share the slug "${slug}": ${paths.join(" and ")}. The` +
+            ` manifest is keyed by slug, so they cannot both be found. Give one a` +
+            ` slug of its own, or use slugStrategy: "route".`);
+    }
+}
+function toImage(job) {
+    return {
+        ...(job.url !== undefined && { url: job.url }),
+        width: job.size.width,
+        height: job.size.height,
+    };
+}
+/** Finish a page: its images by size name, sorted, plus what they add up to. */
+export function toPage(slug, page) {
+    assertOnePage(slug, page);
+    const title = page.widest.props.title;
+    return {
+        images: Object.fromEntries(page.jobs
+            .map((job) => [job.size.name, toImage(job)])
+            .toSorted(([a], [b]) => byName(a, b))),
+        widest: page.widest.size.name,
+        ...(typeof title === "string" && title !== "" && { alt: title }),
+    };
+}
+//# sourceMappingURL=page.js.map

package/dist/manifest/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/manifest/page.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAepC,gFAAgF;AAChF,SAAS,KAAK,CAAC,GAAc;IAC3B,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;AAC1C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,GAAc;IACtC,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAe,EAAE,GAAc;IACvD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEpB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,IAAY,EAAE,IAAe;IAClD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAEpE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;YAC/D,sEAAsE;YACtE,iDAAiD,CACpD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,GAAc;IAC7B,OAAO;QACL,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QAC9C,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK;QACrB,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;KACxB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAe;IAClD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;IAEtC,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,WAAW,CACxB,IAAI,CAAC,IAAI;aACN,GAAG,CAAC,CAAC,GAAG,EAA2B,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;aACpE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACxC;QACD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;QAC7B,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/dist/measure/estimate.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Width of `text` when there is no font to measure it in, either because none
+ * were configured or because the stack names one the build did not load.
+ *
+ * It is a guess, and a build that wants text laid out to the pixel supplies
+ * the font as a file. What it is not is a guess a template has to make: the
+ * one ratio lives here, where the reason for it can be written down once.
+ */
+export declare function estimateWidth(text: string, fontSize: number, weight: number, ratio?: number): number;
+//# sourceMappingURL=estimate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/measure/estimate.ts"],"names":[],"mappings":"AA8CA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,SAAe,GACnB,MAAM,CAQR"}

package/dist/measure/estimate.js

@@ -0,0 +1,58 @@
+/**
+ * Advance width to assume for proportional text, as a fraction of the font
+ * size. It is the average over the sort of text a share image carries, mostly
+ * lower-case Latin with spaces, for the sans-serif faces a site is likely to
+ * use. Nothing here is exact, which is the point of measuring instead.
+ */
+const defaultRatio = 0.52;
+/**
+ * Characters that occupy a full em rather than a fraction of one: the CJK
+ * ranges, Hangul, kana, the fullwidth forms and emoji.
+ *
+ * Estimating these at the Latin ratio is what makes a Japanese title overflow
+ * by nearly half its width, and no per-template fudge factor can be right for
+ * both scripts at once. Widths of the scripts in between, such as Devanagari,
+ * are still guesses; those want a font file, which is what measuring is for.
+ */
+const wideRanges = [
+    [0x11_00, 0x11_5f], // Hangul Jamo
+    [0x2e_80, 0x30_3e], // CJK radicals and punctuation
+    [0x30_41, 0x33_ff], // Kana through the CJK compatibility forms
+    [0x34_00, 0x4d_bf], // CJK extension A
+    [0x4e_00, 0x9f_ff], // CJK unified ideographs
+    [0xa0_00, 0xa4_cf], // Yi
+    [0xac_00, 0xd7_a3], // Hangul syllables
+    [0xf9_00, 0xfa_ff], // CJK compatibility ideographs
+    [0xfe_30, 0xfe_4f], // CJK compatibility forms
+    [0xff_00, 0xff_60], // Fullwidth forms, but not the halfwidth kana after them
+    [0xff_e0, 0xff_e6], // Fullwidth currency and bar symbols
+    [0x1_f3_00, 0x1_fa_ff], // Emoji
+    [0x2_00_00, 0x3_ff_fd], // CJK extensions B onwards
+];
+function isWide(character) {
+    const point = character.codePointAt(0) ?? 0;
+    return wideRanges.some(([from, to]) => point >= from && point <= to);
+}
+/**
+ * How much wider a face gets as its weight rises. A bold cut of a family runs
+ * around a tenth wider than its regular; heavier than bold, little more.
+ */
+function weightFactor(weight) {
+    return 1 + Math.min(Math.max(weight - 400, 0) / 400, 1) * 0.1;
+}
+/**
+ * Width of `text` when there is no font to measure it in, either because none
+ * were configured or because the stack names one the build did not load.
+ *
+ * It is a guess, and a build that wants text laid out to the pixel supplies
+ * the font as a file. What it is not is a guess a template has to make: the
+ * one ratio lives here, where the reason for it can be written down once.
+ */
+export function estimateWidth(text, fontSize, weight, ratio = defaultRatio) {
+    let ems = 0;
+    for (const character of text) {
+        ems += isWide(character) ? 1 : ratio;
+    }
+    return ems * fontSize * weightFactor(weight);
+}
+//# sourceMappingURL=estimate.js.map

package/dist/measure/estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.js","sourceRoot":"","sources":["../../src/measure/estimate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B;;;;;;;;GAQG;AACH,MAAM,UAAU,GAA2C;IACzD,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc;IAClC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,+BAA+B;IACnD,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,2CAA2C;IAC/D,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB;IACtC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAC7C,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,KAAK;IACzB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB;IACvC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,+BAA+B;IACnD,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,0BAA0B;IAC9C,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,yDAAyD;IAC7E,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,qCAAqC;IACzD,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,QAAQ;IAChC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,2BAA2B;CACpD,CAAC;AAEF,SAAS,MAAM,CAAC,SAAiB;IAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,QAAgB,EAChB,MAAc,EACd,KAAK,GAAG,YAAY;IAEpB,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC;IAED,OAAO,GAAG,GAAG,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC"}

package/dist/measure/faces.d.ts

@@ -0,0 +1,15 @@
+import type { Font } from "fontkit";
+import type { FontSource, WarningHandler } from "../types.js";
+/**
+ * One face loaded for measurement: the font itself, plus the family and weight
+ * it declares. Both are read from the file rather than from config, for the
+ * reason {@link FontSource} gives: the file is what the rasteriser matches on.
+ */
+export interface Face {
+    readonly family: string;
+    readonly weight: number;
+    readonly font: Font;
+}
+/** Every face the configured fonts hold, in the order they were configured. */
+export declare function loadFaces(fonts: readonly FontSource[], onWarning: WarningHandler): Promise<readonly Face[]>;
+//# sourceMappingURL=faces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"faces.d.ts","sourceRoot":"","sources":["../../src/measure/faces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAuFD,+EAA+E;AAC/E,wBAAsB,SAAS,CAC7B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAM1B"}

package/dist/measure/faces.js

@@ -0,0 +1,70 @@
+import { create, open } from "fontkit";
+/**
+ * Parsed faces, keyed by the font file's path. A build renders many images
+ * from one config, so without this every image would parse every font again.
+ */
+const byPath = new Map();
+/**
+ * The same for fonts supplied as bytes, keyed by the array itself. A config
+ * holds one of these and hands it to every render, so identity is enough here
+ * and hashing the bytes would cost more than the parse it saves.
+ */
+const byData = new WeakMap();
+/**
+ * What a face declares about itself. The types say both of these are always
+ * there, and a font file is data: one missing its name or its `OS/2` table
+ * would otherwise take the build down inside `selectFace`, rather than being
+ * measured as well as it can be. A face with no family name matches no stack,
+ * so it is only ever reached as the fallback that the first configured font is.
+ */
+function toFace(font) {
+    const declared = font;
+    return {
+        family: declared.familyName ?? "",
+        weight: declared["OS/2"]?.usWeightClass ?? 400,
+        font,
+    };
+}
+/** A collection file holds several faces; a plain font file holds one. */
+function facesOf(loaded) {
+    return "fonts" in loaded
+        ? loaded.fonts.map((font) => toFace(font))
+        : [toFace(loaded)];
+}
+/**
+ * Parse one configured font for measurement, or report that it could not be.
+ *
+ * A file the rasteriser accepts and this cannot is rare, but it is not fatal:
+ * the image still renders, and its text is laid out from estimates instead. It
+ * is worth saying so, because wrapping that is quietly approximate is exactly
+ * what supplying a font file was meant to stop. The warning goes through the
+ * cache below, so a build says it once per file rather than once per image.
+ */
+async function load(font, onWarning) {
+    try {
+        return facesOf("data" in font ? create(Buffer.from(font.data)) : await open(font.path));
+    }
+    catch (error) {
+        const name = "data" in font ? (font.family ?? "font data") : font.path;
+        const reason = error instanceof Error ? error.message : String(error);
+        onWarning(`could not read ${name} for text measurement, so text drawn in it is` +
+            ` wrapped from estimates instead: ${reason}`);
+        return [];
+    }
+}
+function cached(font, onWarning) {
+    if ("data" in font) {
+        const pending = byData.get(font.data) ?? load(font, onWarning);
+        byData.set(font.data, pending);
+        return pending;
+    }
+    const pending = byPath.get(font.path) ?? load(font, onWarning);
+    byPath.set(font.path, pending);
+    return pending;
+}
+/** Every face the configured fonts hold, in the order they were configured. */
+export async function loadFaces(fonts, onWarning) {
+    const loaded = await Promise.all(fonts.map(async (font) => cached(font, onWarning)));
+    return loaded.flat();
+}
+//# sourceMappingURL=faces.js.map

package/dist/measure/faces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faces.js","sourceRoot":"","sources":["../../src/measure/faces.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAevC;;;GAGG;AACH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,GAAG,IAAI,OAAO,EAAwC,CAAC;AAEnE;;;;;;GAMG;AACH,SAAS,MAAM,CAAC,IAAU;IACxB,MAAM,QAAQ,GAAG,IAKhB,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,UAAU,IAAI,EAAE;QACjC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,IAAI,GAAG;QAC9C,IAAI;KACL,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,OAAO,CAAC,MAAyC;IACxD,OAAO,OAAO,IAAI,MAAM;QACtB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,IAAI,CACjB,IAAgB,EAChB,SAAyB;IAEzB,IAAI,CAAC;QACH,OAAO,OAAO,CACZ,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CACxE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACvE,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,SAAS,CACP,kBAAkB,IAAI,+CAA+C;YACnE,oCAAoC,MAAM,EAAE,CAC/C,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CACb,IAAgB,EAChB,SAAyB;IAEzB,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAA4B,EAC5B,SAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CACnD,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/dist/measure/index.d.ts

@@ -0,0 +1,16 @@
+import type { MeasureText, ResolvedConfig } from "../types.js";
+export type { Face } from "./faces.js";
+/**
+ * A {@link MeasureText} for the fonts a build is rendering with.
+ *
+ * Widths are held per em and multiplied by the font size on the way out, which
+ * is what makes fitting text affordable: choosing a size means wrapping the
+ * same words several times over, and only the last multiplication differs.
+ * Text is unhinted at these sizes, so the scaling is exact rather than close.
+ *
+ * The cache lives for as long as the measurer, which is one image. Titles
+ * repeat across the sizes of an image and rarely between images, so a longer
+ * life would hold a build's worth of strings to save very little.
+ */
+export declare function createMeasurer(config: ResolvedConfig): Promise<MeasureText>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/measure/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAa,MAAM,aAAa,CAAC;AAO1E,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AA8CvC;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAgBtB"}

package/dist/measure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/measure/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC;;;;;;;;GAQG;AACH,SAAS,OAAO,CACd,KAAsB,EACtB,KAAgB,EAChB,cAAuB;IAEvB,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;IAEvC,OAAO,CACL,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC;QAC3C,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,SAAS,SAAS,CAChB,IAAY,EACZ,KAAgB,EAChB,KAAsB,EACtB,cAAuB;IAEvB,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAEtD,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QACrD,GAAG;YACD,GAAG,CAAC,IAAI,KAAK,SAAS;gBACpB,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC;gBACzD,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAsB;IAEtB,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,OAAO,CAAC,IAAY,EAAE,KAAgB,EAAU,EAAE;QAChD,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAClH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,CAAC;QAED,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC9D,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpB,OAAO,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC"}

package/dist/measure/runs.d.ts

@@ -0,0 +1,17 @@
+import type { Face } from "./faces.js";
+/**
+ * A stretch of text and the face that will draw it, or no face where nothing
+ * loaded covers it and the width has to be estimated.
+ */
+export interface TextRun {
+    readonly text: string;
+    readonly face: Face | undefined;
+}
+/** Advance width of `text` in `face`, as a multiple of the font size. */
+export declare function emWidth(text: string, face: Face): number;
+/**
+ * Split `text` into the longest runs that one face can draw. Text a build has
+ * supplied fonts for comes back as a single run, which is the common case.
+ */
+export declare function coverageRuns(text: string, primary: Face | undefined, faces: readonly Face[]): readonly TextRun[];
+//# sourceMappingURL=runs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/measure/runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;CACjC;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAExD;AA0BD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,GAAG,SAAS,EACzB,KAAK,EAAE,SAAS,IAAI,EAAE,GACrB,SAAS,OAAO,EAAE,CAepB"}

package/dist/measure/runs.js

@@ -0,0 +1,39 @@
+/** Advance width of `text` in `face`, as a multiple of the font size. */
+export function emWidth(text, face) {
+    return face.font.layout(text).advanceWidth / face.font.unitsPerEm;
+}
+/**
+ * The face that will draw one character: the one the style resolved to, or the
+ * first other loaded face holding a glyph for it. This is what the rasteriser
+ * does with a missing glyph, and measuring a Japanese title against a Latin
+ * face that has none of it would be worse than not measuring at all.
+ */
+function coveringFace(character, primary, faces) {
+    const point = character.codePointAt(0);
+    if (point === undefined) {
+        return primary;
+    }
+    if (primary?.font.hasGlyphForCodePoint(point) === true) {
+        return primary;
+    }
+    return faces.find((face) => face.font.hasGlyphForCodePoint(point));
+}
+/**
+ * Split `text` into the longest runs that one face can draw. Text a build has
+ * supplied fonts for comes back as a single run, which is the common case.
+ */
+export function coverageRuns(text, primary, faces) {
+    const runs = [];
+    for (const character of text) {
+        const face = coveringFace(character, primary, faces);
+        const last = runs.at(-1);
+        if (last === undefined || last.face !== face) {
+            runs.push({ text: character, face });
+        }
+        else {
+            runs[runs.length - 1] = { text: last.text + character, face };
+        }
+    }
+    return runs;
+}
+//# sourceMappingURL=runs.js.map

package/dist/measure/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/measure/runs.ts"],"names":[],"mappings":"AAWA,yEAAyE;AACzE,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAU;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CACnB,SAAiB,EACjB,OAAyB,EACzB,KAAsB;IAEtB,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAEvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,EAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,OAAyB,EACzB,KAAsB;IAEtB,MAAM,IAAI,GAAc,EAAE,CAAC;IAE3B,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/measure/select.d.ts

@@ -0,0 +1,13 @@
+import type { Face } from "./faces.js";
+/**
+ * The families named by a CSS-style stack, in order and unquoted, so that
+ * `'"JetBrains Mono", Menlo, monospace'` becomes three names to try.
+ */
+export declare function familyNames(stack: string): readonly string[];
+/**
+ * The face a style resolves to, or `undefined` when the stack names nothing
+ * that was loaded. Families are tried in the order the stack lists them, which
+ * is what a stack means.
+ */
+export declare function selectFace(faces: readonly Face[], stack: string, weight: number): Face | undefined;
+//# sourceMappingURL=select.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/measure/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAU5D;AA4BD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,GAAG,SAAS,CAUlB"}

package/dist/measure/select.js

@@ -0,0 +1,47 @@
+/**
+ * The families named by a CSS-style stack, in order and unquoted, so that
+ * `'"JetBrains Mono", Menlo, monospace'` becomes three names to try.
+ */
+export function familyNames(stack) {
+    return stack
+        .split(",")
+        .map((name) => name
+        .trim()
+        .replaceAll(/^["']|["']$/g, "")
+        .trim())
+        .filter((name) => name !== "");
+}
+/** Faces belonging to one family, matched as the rasteriser matches them. */
+function inFamily(faces, family) {
+    const wanted = family.toLowerCase();
+    return faces.filter((face) => face.family.toLowerCase() === wanted);
+}
+/**
+ * The face nearest the requested weight. A family supplying only a regular cut
+ * is drawn in that cut by the rasteriser rather than being emboldened, so
+ * measuring the nearest weight is measuring what will actually appear.
+ */
+function nearestWeight(faces, weight) {
+    let best = faces[0];
+    for (const face of faces) {
+        if (Math.abs(face.weight - weight) < Math.abs(best.weight - weight)) {
+            best = face;
+        }
+    }
+    return best;
+}
+/**
+ * The face a style resolves to, or `undefined` when the stack names nothing
+ * that was loaded. Families are tried in the order the stack lists them, which
+ * is what a stack means.
+ */
+export function selectFace(faces, stack, weight) {
+    for (const family of familyNames(stack)) {
+        const [first, ...rest] = inFamily(faces, family);
+        if (first !== undefined) {
+            return nearestWeight([first, ...rest], weight);
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=select.js.map

package/dist/measure/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/measure/select.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACZ,IAAI;SACD,IAAI,EAAE;SACN,UAAU,CAAC,cAAc,EAAE,EAAE,CAAC;SAC9B,IAAI,EAAE,CACV;SACA,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,6EAA6E;AAC7E,SAAS,QAAQ,CAAC,KAAsB,EAAE,MAAc;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CACpB,KAAiC,EACjC,MAAc;IAEd,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;YACpE,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,KAAsB,EACtB,KAAa,EACb,MAAc;IAEd,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAEjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/meta/html.d.ts

@@ -0,0 +1,14 @@
+import type { Manifest, MetaTagOptions } from "../types.js";
+/**
+ * The social meta tags for one page, rendered as HTML.
+ *
+ * The same tags as {@link metaTags}, for a template that writes strings rather
+ * than a component that spreads attributes. Content is escaped: alt text comes
+ * from a post's title, and a title containing an apostrophe or an ampersand is
+ * ordinary rather than exotic.
+ *
+ * Newline-separated and with no trailing newline, so it drops into a `<head>`
+ * at whatever indentation the template is already using.
+ */
+export declare function metaTagsHtml(manifest: Manifest, slug: string, options?: MetaTagOptions): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/meta/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/meta/html.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAW,cAAc,EAAE,MAAM,aAAa,CAAC;AAWrE;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAIR"}

package/dist/meta/html.js

@@ -0,0 +1,24 @@
+import { escapeXml } from "../text/escape.js";
+import { metaTags } from "./tags.js";
+/** One tag as HTML, with whichever naming attribute it carries. */
+function toHtml(tag) {
+    const [attribute, name] = "property" in tag ? ["property", tag.property] : ["name", tag.name];
+    return `<meta ${attribute}="${escapeXml(name)}" content="${escapeXml(tag.content)}">`;
+}
+/**
+ * The social meta tags for one page, rendered as HTML.
+ *
+ * The same tags as {@link metaTags}, for a template that writes strings rather
+ * than a component that spreads attributes. Content is escaped: alt text comes
+ * from a post's title, and a title containing an apostrophe or an ampersand is
+ * ordinary rather than exotic.
+ *
+ * Newline-separated and with no trailing newline, so it drops into a `<head>`
+ * at whatever indentation the template is already using.
+ */
+export function metaTagsHtml(manifest, slug, options) {
+    return metaTags(manifest, slug, options)
+        .map((tag) => toHtml(tag))
+        .join("\n");
+}
+//# sourceMappingURL=html.js.map

package/dist/meta/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/meta/html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,mEAAmE;AACnE,SAAS,MAAM,CAAC,GAAY;IAC1B,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,GACrB,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAEtE,OAAO,SAAS,SAAS,KAAK,SAAS,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;AACxF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAkB,EAClB,IAAY,EACZ,OAAwB;IAExB,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;SACrC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SACzB,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/meta/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Social meta tags, built from the manifest a build wrote.
+ *
+ * Importable on its own as `@kensio/colophon/meta`: emitting tags reads a JSON
+ * file and needs none of the rendering machinery, and a site's templates
+ * should not load a rasteriser and a syntax highlighter to write a `<head>`.
+ */
+export { metaTagsHtml } from "./html.js";
+export { metaTags } from "./tags.js";
+export { absoluteUrl } from "./url.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/meta/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/meta/index.js

@@ -0,0 +1,11 @@
+/**
+ * Social meta tags, built from the manifest a build wrote.
+ *
+ * Importable on its own as `@kensio/colophon/meta`: emitting tags reads a JSON
+ * file and needs none of the rendering machinery, and a site's templates
+ * should not load a rasteriser and a syntax highlighter to write a `<head>`.
+ */
+export { metaTagsHtml } from "./html.js";
+export { metaTags } from "./tags.js";
+export { absoluteUrl } from "./url.js";
+//# sourceMappingURL=index.js.map

package/dist/meta/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/meta/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/meta/tags.d.ts

@@ -0,0 +1,21 @@
+import type { Manifest, MetaTag, MetaTagOptions } from "../types.js";
+/**
+ * The social meta tags for one page of a {@link Manifest}.
+ *
+ * Generating the image is half the job: a site still has to write the tags,
+ * and every site ends up with slightly different results: a missing width, a
+ * relative URL a crawler cannot resolve, or a large card promising an image
+ * that is square.
+ *
+ * A page the manifest does not have gets no tags rather than an error. Not
+ * every page has a share image, and a props mapper returning `undefined` is
+ * how a site says so, so a template asking about one should not have to know
+ * in advance.
+ *
+ * Alt text is emitted for both platforms when the page has any. Twitter reads
+ * its own `twitter:image:alt` rather than falling back to the Open Graph one,
+ * so leaving it out would mean no alt text on the platform, which is most of
+ * the reason for carrying it this far.
+ */
+export declare function metaTags(manifest: Manifest, slug: string, options?: MetaTagOptions): readonly MetaTag[];
+//# sourceMappingURL=tags.d.ts.map

package/dist/meta/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/meta/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAGR,OAAO,EACP,cAAc,EACf,MAAM,aAAa,CAAC;AA4CrB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,SAAS,OAAO,EAAE,CA2BpB"}

package/dist/meta/tags.js

@@ -0,0 +1,72 @@
+import { absoluteUrl } from "./url.js";
+/**
+ * How landscape an image has to be for a large Twitter card.
+ *
+ * `summary_large_image` is specified for 2:1 and the Open Graph landscape is
+ * 1.91:1, so both clear this; a 1:1 square and a 4:3 do not, and are shown
+ * better by `summary` than by a large card that crops them. Choosing between
+ * the two is a check every site writes for itself, usually by hardcoding the
+ * answer for whichever image it happens to have.
+ */
+const largeCardRatio = 1.5;
+/** The image a page's tags describe: the most landscape one it has. */
+function chooseImage(slug, page) {
+    const image = page.images[page.widest];
+    if (image === undefined) {
+        throw new Error(`The manifest page "${slug}" names "${page.widest}" as its widest` +
+            ` image but has no image by that name.`);
+    }
+    return image;
+}
+/** The URL to point at, or a complaint that there is none to point at. */
+function imageUrl(slug, image, options) {
+    if (image.url === undefined) {
+        throw new Error(`The manifest has no URL for "${slug}", so there is nothing to point a` +
+            ` meta tag at. Set placement.urlBase, which is what records one.`);
+    }
+    return absoluteUrl(image.url, options?.baseUrl);
+}
+/**
+ * The social meta tags for one page of a {@link Manifest}.
+ *
+ * Generating the image is half the job: a site still has to write the tags,
+ * and every site ends up with slightly different results: a missing width, a
+ * relative URL a crawler cannot resolve, or a large card promising an image
+ * that is square.
+ *
+ * A page the manifest does not have gets no tags rather than an error. Not
+ * every page has a share image, and a props mapper returning `undefined` is
+ * how a site says so, so a template asking about one should not have to know
+ * in advance.
+ *
+ * Alt text is emitted for both platforms when the page has any. Twitter reads
+ * its own `twitter:image:alt` rather than falling back to the Open Graph one,
+ * so leaving it out would mean no alt text on the platform, which is most of
+ * the reason for carrying it this far.
+ */
+export function metaTags(manifest, slug, options) {
+    const page = manifest.pages[slug];
+    if (page === undefined) {
+        return [];
+    }
+    const image = chooseImage(slug, page);
+    const url = imageUrl(slug, image, options);
+    const isLarge = image.width / image.height >= largeCardRatio;
+    return [
+        { property: "og:image", content: url },
+        { property: "og:image:width", content: String(image.width) },
+        { property: "og:image:height", content: String(image.height) },
+        ...(page.alt === undefined
+            ? []
+            : [{ property: "og:image:alt", content: page.alt }]),
+        {
+            name: "twitter:card",
+            content: isLarge ? "summary_large_image" : "summary",
+        },
+        { name: "twitter:image", content: url },
+        ...(page.alt === undefined
+            ? []
+            : [{ name: "twitter:image:alt", content: page.alt }]),
+    ];
+}
+//# sourceMappingURL=tags.js.map

package/dist/meta/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/meta/tags.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,uEAAuE;AACvE,SAAS,WAAW,CAAC,IAAY,EAAE,IAAkB;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,YAAY,IAAI,CAAC,MAAM,iBAAiB;YAChE,uCAAuC,CAC1C,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0EAA0E;AAC1E,SAAS,QAAQ,CACf,IAAY,EACZ,KAAoB,EACpB,OAAmC;IAEnC,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,mCAAmC;YACrE,iEAAiE,CACpE,CAAC;IACJ,CAAC;IAED,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CACtB,QAAkB,EAClB,IAAY,EACZ,OAAwB;IAExB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,cAAc,CAAC;IAE7D,OAAO;QACL,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;QACtC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAC5D,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;QAC9D,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACtD;YACE,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS;SACrD;QACD,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,EAAE;QACvC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;KACxD,CAAC;AACJ,CAAC"}

package/dist/meta/url.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Resolve an image URL against the site's base.
+ *
+ * Open Graph wants an absolute URL: a crawler reads the tag out of the page
+ * and has nothing to resolve a relative one against. A manifest holds whatever
+ * the placement's `urlBase` said, which is usually site-relative, so this is
+ * where the two halves meet.
+ *
+ * A URL that names its own scheme is returned untouched, since a placement
+ * pointing at a CDN has said everything there is to say. A scheme-relative one
+ * (`//cdn`) has not: it is relative to the page's scheme, which is exactly what
+ * a crawler reading the tag elsewhere does not have, so it borrows the base's.
+ */
+export declare function absoluteUrl(url: string, baseUrl: string | undefined): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/meta/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/meta/url.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAa5E"}