@kensio/colophon 2.1.0 → 2.3.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,SAAS,SAAS,EAAE,GACzB,eAAe,GAAG,SAAS,CAI7B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,eAAe,GAAG,SAAS,GACpC,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/manifest/index.js

@@ -0,0 +1,31 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { buildManifest } from "./build.js";
+export { buildManifest } from "./build.js";
+/**
+ * Work out the manifest a build will write, if any.
+ *
+ * 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.
+ */
+export function planManifest(manifestPath, jobs) {
+    return manifestPath === undefined
+        ? undefined
+        : { path: manifestPath, data: buildManifest(jobs) };
+}
+/**
+ * Write the manifest, creating whatever directories its path needs.
+ *
+ * Indented, with a trailing newline: it is written into a site's data
+ * directory, where it is read by people as well as by templates, and a diff of
+ * one long line says nothing about what changed.
+ */
+export async function writeManifest(manifest) {
+    if (manifest === undefined) {
+        return;
+    }
+    await mkdir(path.dirname(manifest.path), { recursive: true });
+    await writeFile(manifest.path, `${JSON.stringify(manifest.data, undefined, 2)}\n`);
+}
+//# sourceMappingURL=index.js.map

package/dist/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAU3C;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,YAAgC,EAChC,IAA0B;IAE1B,OAAO,YAAY,KAAK,SAAS;QAC/B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAqC;IAErC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,SAAS,CACb,QAAQ,CAAC,IAAI,EACb,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CACnD,CAAC;AACJ,CAAC"}

package/dist/manifest/order.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Order two names by code unit, rather than by whatever the machine's locale
+ * would say.
+ *
+ * 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
+ * `Über` or `MyPost` could sort one way in development and another in the
+ * build, leaving a diff that says nothing happened.
+ */
+export declare function byName(a: string, b: string): number;
+//# sourceMappingURL=order.d.ts.map

package/dist/manifest/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../src/manifest/order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/manifest/order.js

@@ -0,0 +1,17 @@
+/**
+ * Order two names by code unit, rather than by whatever the machine's locale
+ * would say.
+ *
+ * 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
+ * `Über` or `MyPost` could sort one way in development and another in the
+ * build, leaving a diff that says nothing happened.
+ */
+export function byName(a, b) {
+    if (a === b) {
+        return 0;
+    }
+    return a < b ? -1 : 1;
+}
+//# sourceMappingURL=order.js.map

package/dist/manifest/order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../src/manifest/order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,CAAS;IACzC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/manifest/page.d.ts

@@ -0,0 +1,24 @@
+import type { RenderJob } from "../generate/job.js";
+import type { ManifestPage } from "../types.js";
+/**
+ * One page as it is collected: the jobs that draw it, and the most landscape
+ * 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.
+ */
+export interface PageDraft {
+    readonly jobs: RenderJob[];
+    widest: RenderJob;
+}
+/** Start a page off from the first job that draws it. */
+export declare function startPage(job: RenderJob): PageDraft;
+/**
+ * Add another size of the same page. Ties keep the size configured first,
+ * since `>` leaves the incumbent in place.
+ */
+export declare function addToPage(page: PageDraft, job: RenderJob): void;
+/** Finish a page: its images by size name, sorted, plus what they add up to. */
+export declare function toPage(slug: string, page: PageDraft): ManifestPage;
+//# sourceMappingURL=page.d.ts.map

package/dist/manifest/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/manifest/page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAC;AAG/D;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;CACnB;AAOD,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAEnD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAM/D;AA8BD,gFAAgF;AAChF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,YAAY,CAclE"}

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 — 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/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, 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.
+ *
+ * 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, 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.
+ *
+ * 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 — 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"}

package/dist/meta/url.js

@@ -0,0 +1,34 @@
+/**
+ * A URL that names its own scheme. Schemes are case-insensitive, so `HTTPS://`
+ * is as absolute as `https://` and prefixing it would produce nonsense.
+ */
+const schemed = /^[a-z][a-z\d+.-]*:\/\//i;
+/** The scheme a base URL is served over, `https:` included. */
+function schemeOf(url) {
+    return /^[a-z][a-z\d+.-]*:/i.exec(url)?.[0];
+}
+/**
+ * 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 — 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)) {
+        return url;
+    }
+    if (url.startsWith("//")) {
+        const scheme = schemeOf(baseUrl);
+        return scheme === undefined ? url : `${scheme}${url}`;
+    }
+    const base = baseUrl.replace(/\/+$/, "");
+    return url.startsWith("/") ? `${base}${url}` : `${base}/${url}`;
+}
+//# sourceMappingURL=url.js.map

package/dist/meta/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/meta/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,GAAG,yBAAyB,CAAC;AAE1C,+DAA+D;AAC/D,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,OAA2B;IAClE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEzC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;AAClE,CAAC"}

package/dist/placement/check.d.ts

@@ -0,0 +1,16 @@
+import type { Placement } from "../types.js";
+/**
+ * Reject a placement that cannot place anything.
+ *
+ * The types require all of this, but a CLI user's config module is plain
+ * 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.
+ *
+ * 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
+ * be is known by whatever is about to use it.
+ */
+export declare function assertPlacement(placement: Placement): void;
+//# sourceMappingURL=check.d.ts.map

package/dist/placement/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/placement/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CA+C1D"}

package/dist/placement/check.js

@@ -0,0 +1,40 @@
+/**
+ * Reject a placement that cannot place anything.
+ *
+ * The types require all of this, but a CLI user's config module is plain
+ * 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.
+ *
+ * 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
+ * be is known by whatever is about to use it.
+ */
+export function assertPlacement(placement) {
+    const declared = placement;
+    if (declared.urlBase !== undefined && typeof declared.urlBase !== "string") {
+        throw new TypeError(`placement urlBase must be a string; it is prefixed to each image's path.`);
+    }
+    if (declared.hash !== undefined && typeof declared.hash !== "boolean") {
+        throw new TypeError(`placement hash must be true or false. Anything else reads as neither,` +
+            ` so the images would be written unhashed without a word about it.`);
+    }
+    if (placement.strategy === "public-dir") {
+        if (typeof declared.dir !== "string" || declared.dir === "") {
+            throw new TypeError(`placement "public-dir" needs a "dir" to write the images into.`);
+        }
+        return;
+    }
+    if (placement.strategy !== "custom") {
+        return;
+    }
+    if (typeof declared.path !== "function") {
+        throw new TypeError(`placement "custom" needs a "path" function saying where each image goes.`);
+    }
+    if (declared.url !== undefined && typeof declared.url !== "function") {
+        throw new TypeError(`placement "custom" takes a "url" function, or none at all for images` +
+            ` that are written but not served.`);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/placement/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/placement/check.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,MAAM,QAAQ,GAAG,SAMhB,CAAC;IAEF,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3E,MAAM,IAAI,SAAS,CACjB,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CACjB,uEAAuE;YACrE,mEAAmE,CACtE,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACxC,IAAI,OAAO,QAAQ,CAAC,GAAG,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC;YAC5D,MAAM,IAAI,SAAS,CACjB,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACxC,MAAM,IAAI,SAAS,CACjB,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACrE,MAAM,IAAI,SAAS,CACjB,sEAAsE;YACpE,mCAAmC,CACtC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/placement/index.d.ts

@@ -0,0 +1,29 @@
+import type { ContentFile, OutputSize, Placement } from "../types.js";
+export { besideContent, imageName } from "./relative.js";
+/**
+ * Where one image ends up: the path its bytes are written to, and the URL it
+ * is served at, if the placement knows one.
+ */
+export interface PlacedImage {
+    readonly path: string;
+    readonly url: string | undefined;
+}
+/**
+ * Places each image of a build.
+ *
+ * The stamp is handed over whether or not the placement wants it: it is what a
+ * hashed filename is built from, and a placement that does not hash simply
+ * ignores it.
+ */
+export type Placer = (file: ContentFile, size: OutputSize, stamp: string) => PlacedImage;
+/**
+ * Build the function that places every image of a build.
+ *
+ * The strategies differ only in the root an image is placed under and whether
+ * it keeps the directories its post sits in: `beside-content` keeps them,
+ * which is the page-bundle convention, and `public-dir` drops them so that a
+ * flat directory can be served as one. Either way the same relative path
+ * makes the disk path and the URL, so the two cannot drift apart.
+ */
+export declare function createPlacer(placement: Placement | undefined, contentDir: string): Placer;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/placement/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAItE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG,CACnB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,KACV,WAAW,CAAC;AAyBjB;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM,GACjB,MAAM,CAkCR"}

package/dist/placement/index.js

@@ -0,0 +1,61 @@
+import path from "node:path";
+import { assertPlacement } from "./check.js";
+import { besideContent, imageName } from "./relative.js";
+export { besideContent, imageName } from "./relative.js";
+/**
+ * Prefix a `urlBase` onto an image's path under the root that placed it.
+ *
+ * No base, no URL: a directory on disk does not say how — or whether — it is
+ * served, and a URL Colophon invented would be worse than the gap it fills,
+ * since the whole point of writing one down is that a site can trust it.
+ */
+function toUrl(urlBase, relative) {
+    if (urlBase === undefined) {
+        return undefined;
+    }
+    return `${urlBase.replace(/\/+$/, "")}/${relative}`;
+}
+/** Join a path that uses URL separators back into a platform path. */
+function under(root, relative) {
+    return path.join(root, ...relative.split("/"));
+}
+/**
+ * Build the function that places every image of a build.
+ *
+ * The strategies differ only in the root an image is placed under and whether
+ * it keeps the directories its post sits in: `beside-content` keeps them,
+ * which is the page-bundle convention, and `public-dir` drops them so that a
+ * flat directory can be served as one. Either way the same relative path
+ * makes the disk path and the URL, so the two cannot drift apart.
+ */
+export function createPlacer(placement, contentDir) {
+    if (placement !== undefined) {
+        assertPlacement(placement);
+    }
+    if (placement === undefined || placement.strategy === "beside-content") {
+        const urlBase = placement?.urlBase;
+        const isHashes = placement?.hash === true;
+        return (file, size, stamp) => {
+            const relative = besideContent(file, size, isHashes ? stamp : undefined);
+            return {
+                path: under(contentDir, relative),
+                url: toUrl(urlBase, relative),
+            };
+        };
+    }
+    if (placement.strategy === "public-dir") {
+        const isHashes = placement.hash === true;
+        return (file, size, stamp) => {
+            const relative = imageName(file, size, isHashes ? stamp : undefined);
+            return {
+                path: under(placement.dir, relative),
+                url: toUrl(placement.urlBase, relative),
+            };
+        };
+    }
+    return (file, size) => ({
+        path: placement.path(file, size),
+        url: placement.url?.(file, size),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/placement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/placement/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAwBzD;;;;;;GAMG;AACH,SAAS,KAAK,CACZ,OAA2B,EAC3B,QAAgB;IAEhB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;AACtD,CAAC;AAED,sEAAsE;AACtE,SAAS,KAAK,CAAC,IAAY,EAAE,QAAgB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAgC,EAChC,UAAkB;IAElB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,eAAe,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;QACvE,MAAM,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC;QACnC,MAAM,QAAQ,GAAG,SAAS,EAAE,IAAI,KAAK,IAAI,CAAC;QAE1C,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACzE,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC;gBACjC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;aAC9B,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC;QAEzC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACrE,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC;gBACpC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;aACxC,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACtB,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAChC,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/placement/relative.d.ts

@@ -0,0 +1,31 @@
+import type { ContentFile, OutputSize } from "../types.js";
+/**
+ * The filename one image is written under: `<slug>-<size>.png`, or
+ * `<slug>-<size>.<hash>.png` where the placement asks for a hash. The slug
+ * carries the post's keywords, and the size name keeps every image of a post
+ * distinct (`my-post-og.png`, `my-post-square.png`).
+ *
+ * A slug carrying directories of its own — what the `route` strategy produces,
+ * and what a frontmatter `slug` of `docs/intro` means — puts them in the name,
+ * so the image's path mirrors the route wherever it is placed.
+ *
+ * The digest is the image's rebuild stamp: the props, the config and the size
+ * it is drawn from. Hashing the rendered bytes would be a truer name, but they
+ * are not known until the image has been rendered, and the point of the stamp
+ * is not rendering the ones that have not changed.
+ */
+export declare function imageName(file: ContentFile, size: OutputSize, hash: string | undefined): string;
+/**
+ * Where an image goes relative to the content root, in URL form.
+ *
+ * Slashes rather than the platform's separator, because this is also what a
+ * URL is built from: a Windows build must not serve `posts\my-post\a.png`.
+ * The disk path is joined back up per platform by whoever places it.
+ *
+ * A slug with directories of its own is placed from the content root, so its
+ * path mirrors the route. Resolving it beside the file would repeat the
+ * directories already in the slug, putting `services/iam` under
+ * `content/services/iam/`.
+ */
+export declare function besideContent(file: ContentFile, size: OutputSize, hash: string | undefined): string;
+//# sourceMappingURL=relative.d.ts.map

package/dist/placement/relative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../src/placement/relative.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAW3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CAMR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CAYR"}