@kensio/colophon 2.3.0 → 2.5.0

package/dist/layout/stack.d.ts

@@ -0,0 +1,14 @@
+import type { Align, Extent, Rect } from "./types.js";
+/** A stacked item's rectangle, and which item it belongs to. */
+export interface StackedRect extends Rect {
+    readonly index: number;
+}
+/**
+ * Stack items down an area and give each one its rectangle.
+ *
+ * Each keeps the full width of the area, because the vertical placement is the
+ * only decision being made here. An item that wants less width draws itself
+ * narrower, or puts a `row` inside the rectangle it was given.
+ */
+export declare function stack(items: readonly Extent[], area: Rect, align?: Align): readonly StackedRect[];
+//# sourceMappingURL=stack.d.ts.map

package/dist/layout/stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../src/layout/stack.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEtD,gEAAgE;AAChE,MAAM,WAAW,WAAY,SAAQ,IAAI;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,EAAE,IAAI,EACV,KAAK,GAAE,KAAgB,GACtB,SAAS,WAAW,EAAE,CAcxB"}

package/dist/layout/stack.js

@@ -0,0 +1,19 @@
+import { distribute } from "./distribute.js";
+/**
+ * Stack items down an area and give each one its rectangle.
+ *
+ * Each keeps the full width of the area, because the vertical placement is the
+ * only decision being made here. An item that wants less width draws itself
+ * narrower, or puts a `row` inside the rectangle it was given.
+ */
+export function stack(items, area, align = "centre") {
+    const placed = distribute(items, { start: area.y, end: area.y + area.height }, align);
+    return placed.map((placement, index) => ({
+        x: area.x,
+        y: placement.start,
+        width: area.width,
+        height: items[index]?.size ?? 0,
+        index: placement.index,
+    }));
+}
+//# sourceMappingURL=stack.js.map

package/dist/layout/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../src/layout/stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQ7C;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CACnB,KAAwB,EACxB,IAAU,EACV,KAAK,GAAU,QAAQ;IAEvB,MAAM,MAAM,GAAG,UAAU,CACvB,KAAK,EACL,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,EAC5C,KAAK,CACN,CAAC;IAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACvC,CAAC,EAAE,IAAI,CAAC,CAAC;QACT,CAAC,EAAE,SAAS,CAAC,KAAK;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC;QAC/B,KAAK,EAAE,SAAS,CAAC,KAAK;KACvB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/layout/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * A rectangle in image coordinates, which is what every primitive here takes
+ * and returns. Templates are handed the image's `dimensions` and work down
+ * from there, so a rectangle is the one shape they all have in common.
+ */
+export interface Rect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * A stretch of one axis: top and bottom for a stack, left and right for a row.
+ * `start` is the smaller coordinate, so it is the top or the left edge.
+ */
+export interface Span {
+    readonly start: number;
+    readonly end: number;
+}
+/**
+ * Where a group of items sits within the space it was given. `centre` is the
+ * default everywhere, because a share image is looked at rather than read down,
+ * and the middle is where the eye goes.
+ */
+export type Align = "start" | "centre" | "end";
+/**
+ * How much of an axis one item takes, and how much clear space goes before it.
+ * A gap on the first item is space at the head of the group.
+ */
+export interface Extent {
+    readonly size: number;
+    readonly gapBefore?: number;
+}
+/** Where an item ended up: its start coordinate along the axis. */
+export interface Placed {
+    readonly start: number;
+    readonly index: number;
+}
+/** Fill, corners and stroke for a rectangle. Every field is optional. */
+export interface BoxStyle {
+    readonly fill?: string;
+    readonly fillOpacity?: number;
+    /** Corner radius. Omit for square corners. */
+    readonly radius?: number;
+    readonly stroke?: string;
+    readonly strokeOpacity?: number;
+    readonly strokeWidth?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/layout/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/layout/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,mEAAmE;AACnE,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/layout/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/layout/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/layout/types.ts"],"names":[],"mappings":""}

package/dist/manifest/build.d.ts

@@ -4,7 +4,7 @@ import type { Manifest } from "../types.js";
  * Build the manifest for a planned build.
  *
  * It is built from the jobs rather than from what was written, so a rebuild
- * that skips every image still describes the whole site — the manifest says
+ * that skips every image still describes the whole site. The manifest says
  * what exists, not what happened this time.
  *
  * Pages are sorted by slug, and each page's images by size name, so a manifest

package/dist/manifest/build.js

@@ -27,7 +27,7 @@ function drafts(jobs) {
  * Build the manifest for a planned build.
  *
  * It is built from the jobs rather than from what was written, so a rebuild
- * that skips every image still describes the whole site — the manifest says
+ * that skips every image still describes the whole site. The manifest says
  * what exists, not what happened this time.
  *
  * Pages are sorted by slug, and each page's images by size name, so a manifest

package/dist/manifest/index.d.ts

@@ -13,7 +13,7 @@ export interface PlannedManifest {
  *
  * Built while planning rather than from the results, so that a site with two
  * pages sharing a slug hears about it before rendering the tree rather than
- * after — the same reason the output paths are checked up front.
+ * after. That is the same reason the output paths are checked up front.
  */
 export declare function planManifest(manifestPath: string | undefined, jobs: readonly RenderJob[]): PlannedManifest | undefined;
 /**

package/dist/manifest/index.js

@@ -7,7 +7,7 @@ export { buildManifest } from "./build.js";
  *
  * Built while planning rather than from the results, so that a site with two
  * pages sharing a slug hears about it before rendering the tree rather than
- * after — the same reason the output paths are checked up front.
+ * after. That is the same reason the output paths are checked up front.
  */
 export function planManifest(manifestPath, jobs) {
     return manifestPath === undefined

package/dist/manifest/order.d.ts

@@ -4,7 +4,7 @@
  *
  * The manifest is written into a site's repository and committed, so the order
  * has to be the same on a laptop and on CI. `localeCompare` reads the default
- * locale, and locales disagree about case and accented letters — a slug of
+ * locale, and locales disagree about case and accented letters, so a slug of
  * `Über` or `MyPost` could sort one way in development and another in the
  * build, leaving a diff that says nothing happened.
  */

package/dist/manifest/order.js

@@ -4,7 +4,7 @@
  *
  * The manifest is written into a site's repository and committed, so the order
  * has to be the same on a laptop and on CI. `localeCompare` reads the default
- * locale, and locales disagree about case and accented letters — a slug of
+ * locale, and locales disagree about case and accented letters, so a slug of
  * `Über` or `MyPost` could sort one way in development and another in the
  * build, leaving a diff that says nothing happened.
  */

package/dist/manifest/page.d.ts

@@ -5,8 +5,8 @@ import type { ManifestPage } from "../types.js";
  * of them so far.
  *
  * A page is created from its first job rather than from an empty list, so
- * there is never a page without images to explain away — `widest` has to name
- * one of them.
+ * there is never a page without images to explain away, since `widest` has to
+ * name one of them.
  */
 export interface PageDraft {
     readonly jobs: RenderJob[];

package/dist/manifest/page.js

@@ -21,9 +21,9 @@ export function addToPage(page, 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 — 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.
+ * 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))];

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/tags.d.ts

@@ -3,14 +3,14 @@ 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, a large card promising an image that
- * is square.
+ * 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 — a props mapper returning `undefined` is how a
- * site says so — and a template asking about one should not have to know in
- * advance.
+ * 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,

package/dist/meta/tags.js

@@ -30,14 +30,14 @@ function imageUrl(slug, image, options) {
  * 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, a large card promising an image that
- * is square.
+ * 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 — a props mapper returning `undefined` is how a
- * site says so — and a template asking about one should not have to know in
- * advance.
+ * 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,

package/dist/meta/url.d.ts

@@ -6,10 +6,10 @@
  * 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 — 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.
+ * 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.js

@@ -15,10 +15,10 @@ function schemeOf(url) {
  * 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 — 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.
+ * 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 function absoluteUrl(url, baseUrl) {
     if (baseUrl === undefined || schemed.test(url)) {

package/dist/placement/check.d.ts

@@ -6,7 +6,7 @@ import type { Placement } from "../types.js";
  * JavaScript with nothing checking it, and none of these omissions fails
  * anywhere near the config: a missing `dir` surfaces as a complaint about an
  * argument to `path`, and the rest as something not being a function. Key
- * validation is no help either — it is the option that is not there.
+ * validation is no help either, since it is the option that is not there.
  *
  * This sits here rather than in `validate/`, which checks keys and the names
  * of closed sets, for the reason `fonts/resolve.ts` does: what a value has to