@dirwell/share-image 0.0.0-stage → 0.0.1-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dirwell contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @dirwell/share-image
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional build-time metadata and 1200 × 630 PNG images. Install this package only when share metadata or image rendering is needed. Core, Plain and the rich themes do not depend on it.
+
+```js
+import { generateExplorer } from "@dirwell/core";
+import { createPlainTheme } from "@dirwell/theme-plain";
+import { createMetadataProvider } from "@dirwell/share-image";
+
+await generateExplorer({
+  sourceDir: "files",
+  outputDir: "public/downloads",
+  theme: createPlainTheme(),
+  metadata: createMetadataProvider(
+    { siteName: "Sample downloads", siteUrl: "https://example.com/downloads/" },
+    { siteName: "Sample downloads", repositoryName: "example/files", imageTheme: "plain" },
+  ),
+});
+```
+
+Omit `imageTheme` for text-only metadata. `image: false` disables any preset; a local File/path/file URL or async callback supplies a custom image. `createShareImage({ theme, title, description })` returns a PNG File. Rendering is lazy, uses bundled Adobe fonts without network/system-font lookup, and retains at most 32 rendered PNGs per process. The existing renderer requires bundled glyph coverage; unsupported text fails instead of silently emitting missing glyphs. Use a custom renderer for other scripts. Per-build image loading is deduplicated; image output paths are validated and conflicting bytes are rejected.
+
+This is a static-build provider. No server image route or runtime image service is implied. All packages remain private until publication setup is completed.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,3 @@
+# Third-party notices
+
+The bundled Adobe Source Sans 3 and Source Serif 4 fonts use the SIL Open Font License 1.1. Their complete copyright and license files are included under `dist/fonts/`. The renderer uses installed fontkit (MIT) and resvg-js (MPL-2.0); their packages include license notices.

package/dist/fonts/SOURCE.json

@@ -0,0 +1,46 @@
+[
+  {
+    "repo": "https://github.com/adobe-fonts/source-sans",
+    "sha": "87b37a2daaed80fcb8e8ccb0085c4d72ddade12e",
+    "path": "OTF/SourceSans3-Regular.otf",
+    "file": "SourceSans3-Regular.otf",
+    "bytes": 334924,
+    "sha256": "08df266400933d3178d081a45f94a08814c3e55b4b7dd2e0ff69cb1329f13ab6"
+  },
+  {
+    "repo": "https://github.com/adobe-fonts/source-sans",
+    "sha": "87b37a2daaed80fcb8e8ccb0085c4d72ddade12e",
+    "path": "OTF/SourceSans3-Light.otf",
+    "file": "SourceSans3-Light.otf",
+    "bytes": 327396,
+    "sha256": "bbfab2c58d46defe8a194634744660ee15d560dcf3d7a8c7bb509936acc618c7"
+  },
+  {
+    "repo": "https://github.com/adobe-fonts/source-sans",
+    "sha": "87b37a2daaed80fcb8e8ccb0085c4d72ddade12e",
+    "path": "LICENSE.md",
+    "file": "source-sans-LICENSE.md",
+    "bytes": 4480,
+    "sha256": "3d78cfa3c4c179a49cbfe4b7603f9683b58d41c3e29f85b5ee9a480e2a057165",
+    "upstreamSha256": "56af9b9c6715597e458284a474dc118a50a4150e9d547c70f7b4a33c3e6a9328",
+    "transformation": "License line endings normalized to LF; license text unchanged"
+  },
+  {
+    "repo": "https://github.com/adobe-fonts/source-serif",
+    "sha": "80d3f8894c09c937bebfa9011247d2e1c79fd6f4",
+    "path": "OTF/SourceSerif4-Regular.otf",
+    "file": "SourceSerif4-Regular.otf",
+    "bytes": 241392,
+    "sha256": "edf160d0d584deee8a3bb2c3371b2a7624ca63580fbe02c57c1f4c91e84d8787"
+  },
+  {
+    "repo": "https://github.com/adobe-fonts/source-serif",
+    "sha": "80d3f8894c09c937bebfa9011247d2e1c79fd6f4",
+    "path": "LICENSE.md",
+    "file": "source-serif-LICENSE.md",
+    "bytes": 4486,
+    "sha256": "58d616db06d9f0540735051efb49b5b3b77c9c0f2f2a37a6b1bf72bd241fec80",
+    "upstreamSha256": "c21d7293d87b6d7ab1d0229a2f55b77f33a7613a6a4e66f6693d68d7d8d09464",
+    "transformation": "License line endings normalized to LF; license text unchanged"
+  }
+]

package/dist/fonts/source-sans-LICENSE.md

@@ -0,0 +1,93 @@
+Copyright 2010-2024 Adobe (http://www.adobe.com/), with Reserved Font Name 'Source'. All Rights Reserved. Source is a trademark of Adobe in the United States and/or other countries.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+
+This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL
+
+---
+
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1. Neither the Font Software nor any of its individual components,
+   in Original or Modified Versions, may be sold by itself.
+
+2. Original or Modified Versions of the Font Software may be bundled,
+   redistributed and/or sold with any software, provided that each copy
+   contains the above copyright notice and this license. These can be
+   included either as stand-alone text files, human-readable headers or
+   in the appropriate machine-readable metadata fields within text or
+   binary files as long as those fields can be easily viewed by the user.
+
+3. No Modified Version of the Font Software may use the Reserved Font
+   Name(s) unless explicit written permission is granted by the corresponding
+   Copyright Holder. This restriction only applies to the primary font name as
+   presented to the users.
+
+4. The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+   Software shall not be used to promote, endorse or advertise any
+   Modified Version, except to acknowledge the contribution(s) of the
+   Copyright Holder(s) and the Author(s) or with their explicit written
+   permission.
+
+5. The Font Software, modified or unmodified, in part or in whole,
+   must be distributed entirely under this license, and must not be
+   distributed under any other license. The requirement for fonts to
+   remain under this license does not apply to any document created
+   using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/fonts/source-serif-LICENSE.md

@@ -0,0 +1,93 @@
+Copyright 2014 - 2023 Adobe (http://www.adobe.com/), with Reserved Font Name ‘Source’. All Rights Reserved. Source is a trademark of Adobe in the United States and/or other countries.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+
+This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL
+
+---
+
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1. Neither the Font Software nor any of its individual components,
+   in Original or Modified Versions, may be sold by itself.
+
+2. Original or Modified Versions of the Font Software may be bundled,
+   redistributed and/or sold with any software, provided that each copy
+   contains the above copyright notice and this license. These can be
+   included either as stand-alone text files, human-readable headers or
+   in the appropriate machine-readable metadata fields within text or
+   binary files as long as those fields can be easily viewed by the user.
+
+3. No Modified Version of the Font Software may use the Reserved Font
+   Name(s) unless explicit written permission is granted by the corresponding
+   Copyright Holder. This restriction only applies to the primary font name as
+   presented to the users.
+
+4. The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+   Software shall not be used to promote, endorse or advertise any
+   Modified Version, except to acknowledge the contribution(s) of the
+   Copyright Holder(s) and the Author(s) or with their explicit written
+   permission.
+
+5. The Font Software, modified or unmodified, in part or in whole,
+   must be distributed entirely under this license, and must not be
+   distributed under any other license. The requirement for fonts to
+   remain under this license does not apply to any document created
+   using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/index.d.mts

@@ -0,0 +1,30 @@
+import { ContentCounts, DirectoryData, MetadataOptions, MetadataProviderFactory, PageMetadata, ThemeMetadataDefaults } from "@dirwell/core";
+//#region src/share-image.d.ts
+interface ShareImageOptions {
+  readonly theme?: "ledger" | "plain" | "crosswave";
+  readonly title: string;
+  readonly description: string;
+  readonly repositoryName?: string;
+  readonly directoryPath?: string;
+}
+//#endregion
+//#region src/share-image-api.d.ts
+/** Render a PNG at build time using the selected built-in theme and bundled fonts. */
+export declare function createShareImage(options: ShareImageOptions): Promise<File>;
+//#endregion
+//#region src/metadata.d.ts
+export declare function countEntries(directory: DirectoryData): ContentCounts;
+export declare function countKinds(kinds: Iterable<string>): ContentCounts;
+export declare function describeContent(counts: ContentCounts): string;
+export declare function repositoryName(repositoryUrl: string): string;
+export declare function createMetadataResolver(options: MetadataOptions, defaults: ThemeMetadataDefaults, counts: ContentCounts, sourceDirectory: string): {
+  assets: Map<string, Uint8Array<ArrayBufferLike>>;
+  resolve(directory: DirectoryData, hrefForOutput: (outputPath: string) => string, pagePath: string): Promise<PageMetadata>;
+};
+//#endregion
+//#region src/index.d.ts
+/** Opt-in build metadata. PNG presets are generated only when defaults.imageTheme is supplied. */
+export declare function createMetadataProvider(options: MetadataOptions, defaults: ThemeMetadataDefaults, sourceDirectory?: string): MetadataProviderFactory;
+//#endregion
+export type { ShareImageOptions };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,176 @@
+import { t as createShareImage } from "./share-image-api-DcmMcWT0.mjs";
+import { escapeHtml } from "@dirwell/core";
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/metadata.ts
+function countEntries(directory) {
+	return countKinds(directory.entries.map((entry) => entry.kind));
+}
+function countKinds(kinds) {
+	let folderCount = 0, fileCount = 0, linkCount = 0;
+	for (const kind of kinds) if (kind === "directory") folderCount++;
+	else if (kind === "file") fileCount++;
+	else if (kind === "symlink") linkCount++;
+	return {
+		folderCount,
+		fileCount,
+		linkCount
+	};
+}
+function describeContent(counts) {
+	const parts = [];
+	for (const [count, noun] of [
+		[counts.folderCount, "folder"],
+		[counts.fileCount, "file"],
+		[counts.linkCount, "link"]
+	]) if (count > 0) parts.push(`${count} ${noun}${count === 1 ? "" : "s"}`);
+	return parts.join(" · ") || "Empty folder";
+}
+function repositoryName(repositoryUrl) {
+	try {
+		return new URL(repositoryUrl).pathname.replace(/^\/+|\/+$/g, "").replace(/\.git$/, "");
+	} catch {
+		return repositoryUrl;
+	}
+}
+function stringValue(value, label) {
+	if (typeof value !== "string") throw new TypeError(`${label} must resolve to a string`);
+	return value;
+}
+function safeOutputPath(value) {
+	if (!value || value.includes("\\") || value.includes("\0") || value.startsWith("/") || /^[a-z]:/i.test(value) || value.split("/").some((part) => !part || part === "." || part === "..")) throw new Error(`Unsafe metadata image outputPath: ${value}`);
+	if (value.startsWith("__dirwell/") && !value.startsWith("__dirwell/metadata/")) throw new Error("Metadata image cannot overwrite reserved Dirwell assets");
+	return value;
+}
+function deployedRoot(value) {
+	if (value === void 0) return void 0;
+	const url = new URL(value);
+	if (!["http:", "https:"].includes(url.protocol) || url.search || url.hash || url.username || url.password) throw new Error("metadata.siteUrl must be an HTTP(S) explorer root without credentials, query, or fragment");
+	if (!url.pathname.endsWith("/")) url.pathname += "/";
+	return url;
+}
+function createMetadataResolver(options, defaults, counts, sourceDirectory) {
+	const site = Object.freeze({
+		...counts,
+		name: stringValue(options.siteName ?? defaults.siteName, "metadata.siteName"),
+		repositoryName: stringValue(options.repositoryName ?? defaults.repositoryName, "metadata.repositoryName")
+	});
+	const siteUrl = deployedRoot(options.siteUrl);
+	const presetTitle = typeof options.title === "string" ? options.title : site.name;
+	const presetDescription = typeof options.description === "string" ? options.description : `Archive totals: ${describeContent(site)}`;
+	const assets = /* @__PURE__ */ new Map();
+	let defaultImage;
+	const fileSources = /* @__PURE__ */ new WeakMap();
+	const pathSources = /* @__PURE__ */ new Map();
+	const loaded = async (bytes, filename) => {
+		const extension = path.extname(filename).toLowerCase();
+		if (![
+			".png",
+			".jpg",
+			".jpeg",
+			".webp",
+			".gif"
+		].includes(extension)) throw new Error("Metadata images must be PNG, JPEG, WebP, or GIF files");
+		return {
+			bytes,
+			extension,
+			digest: createHash("sha256").update(bytes).digest("hex")
+		};
+	};
+	function loadImage(source) {
+		if (source instanceof File) {
+			let image = fileSources.get(source);
+			if (image === void 0) {
+				image = source.arrayBuffer().then((buffer) => loaded(new Uint8Array(buffer), source.name));
+				fileSources.set(source, image);
+			}
+			return image;
+		}
+		if (typeof source !== "string" && !(source instanceof URL)) throw new TypeError("metadata.image.source must be a File, local path, or file URL");
+		if (source instanceof URL && source.protocol !== "file:") throw new Error("metadata.image source URLs must use file:");
+		const input = source instanceof URL ? fileURLToPath(source) : path.resolve(sourceDirectory, source);
+		let image = pathSources.get(input);
+		if (image === void 0) {
+			image = readFile(input).then((bytes) => loaded(bytes, path.basename(input)));
+			pathSources.set(input, image);
+		}
+		return image;
+	}
+	async function imageFor(context) {
+		const configured = options.image === void 0 ? defaults.image : options.image;
+		const isPreset = configured === void 0 && defaults.imageTheme !== void 0;
+		let image = typeof configured === "function" ? await configured(context) : configured;
+		if (image === false) return null;
+		if (configured === void 0) {
+			const preset = defaults.imageTheme;
+			if (preset === void 0) return null;
+			defaultImage ??= import("./share-image-api-BZH7001a.mjs").then(({ createShareImage }) => createShareImage({
+				theme: preset,
+				repositoryName: site.repositoryName,
+				title: presetTitle,
+				description: presetDescription
+			}));
+			image = await defaultImage;
+		}
+		if (image === void 0) throw new TypeError("metadata.image callback must return an image or false");
+		const config = image instanceof File || typeof image === "string" || image instanceof URL ? { source: image } : image;
+		if (!config || typeof config !== "object") throw new TypeError("metadata.image must resolve to a File, local path, file URL, or source object");
+		const { bytes, extension, digest } = await loadImage(config.source);
+		const outputPath = safeOutputPath(config.outputPath ?? `__dirwell/metadata/${digest}${extension}`);
+		const existing = assets.get(outputPath);
+		if (existing !== void 0 && existing !== bytes && !Buffer.from(existing).equals(bytes)) throw new Error(`Conflicting metadata image outputPath: ${outputPath}`);
+		assets.set(outputPath, bytes);
+		return {
+			outputPath,
+			alt: stringValue(config.alt ?? (isPreset ? `${presetTitle}. ${presetDescription}` : context.title), "metadata.image.alt")
+		};
+	}
+	return {
+		assets,
+		async resolve(directory, hrefForOutput, pagePath) {
+			const relativePath = directory.current.relativePath;
+			const context = Object.freeze({
+				site,
+				directory: Object.freeze({
+					...countEntries(directory),
+					relativePath,
+					name: directory.current.name
+				})
+			});
+			const title = stringValue(typeof options.title === "function" ? await options.title(context) : options.title ?? (relativePath ? `${relativePath} · ${site.name}` : site.name), "metadata.title");
+			const description = stringValue(typeof options.description === "function" ? await options.description(context) : options.description ?? (relativePath ? `Browse ${relativePath} in ${site.name}. This folder: ${describeContent(context.directory)}.` : `Browse files in ${site.name}. Archive totals: ${describeContent(site)}.`), "metadata.description");
+			const image = await imageFor(Object.freeze({
+				...context,
+				title,
+				description
+			}));
+			const meta = (key, value, property = false) => `<meta data-dirwell-metadata ${property ? "property" : "name"}="${key}" content="${escapeHtml(value)}">`;
+			let head = `<title>${escapeHtml(title)}</title>${meta("description", description)}${meta("og:title", title, true)}${meta("og:description", description, true)}${meta("og:type", "website", true)}`;
+			if (siteUrl) {
+				const canonical = new URL(pagePath.split("/").map(encodeURIComponent).join("/"), siteUrl).href;
+				head += `${meta("og:url", canonical, true)}<link data-dirwell-metadata rel="canonical" href="${escapeHtml(canonical)}">`;
+			}
+			if (image) {
+				const href = siteUrl ? new URL(image.outputPath.split("/").map(encodeURIComponent).join("/"), siteUrl).href : hrefForOutput(image.outputPath);
+				head += meta("og:image", href, true) + meta("og:image:alt", image.alt, true) + meta("twitter:card", "summary_large_image") + meta("twitter:title", title) + meta("twitter:description", description) + meta("twitter:image", href) + meta("twitter:image:alt", image.alt);
+			}
+			return {
+				title,
+				description,
+				head
+			};
+		}
+	};
+}
+//#endregion
+//#region src/index.ts
+/** Opt-in build metadata. PNG presets are generated only when defaults.imageTheme is supplied. */
+function createMetadataProvider(options, defaults, sourceDirectory = process.cwd()) {
+	return ({ sourceKinds }) => createMetadataResolver(options, defaults, countKinds(sourceKinds.values()), sourceDirectory);
+}
+//#endregion
+export { countEntries, countKinds, createMetadataProvider, createMetadataResolver, createShareImage, describeContent, repositoryName };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/metadata.ts","../src/index.ts"],"sourcesContent":["import { escapeHtml } from \"@dirwell/core\";\nimport { createHash } from \"node:crypto\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { DirectoryData } from \"@dirwell/core\";\n\nimport type {\n  ContentCounts,\n  MetadataContext,\n  ImageSource,\n  MetadataImage,\n  ResolvedMetadataContext,\n  MetadataOptions,\n  ThemeMetadataDefaults,\n  PageMetadata,\n} from \"@dirwell/core\";\nexport type {\n  ContentCounts,\n  MetadataContext,\n  MetadataValue,\n  ImageSource,\n  MetadataImage,\n  ResolvedMetadataContext,\n  MetadataImageValue,\n  MetadataOptions,\n  ThemeMetadataDefaults,\n  PageMetadata,\n} from \"@dirwell/core\";\nexport function countEntries(directory: DirectoryData): ContentCounts {\n  return countKinds(directory.entries.map((entry) => entry.kind));\n}\nexport function countKinds(kinds: Iterable<string>): ContentCounts {\n  let folderCount = 0,\n    fileCount = 0,\n    linkCount = 0;\n  for (const kind of kinds) {\n    if (kind === \"directory\") folderCount++;\n    else if (kind === \"file\") fileCount++;\n    else if (kind === \"symlink\") linkCount++;\n  }\n  return { folderCount, fileCount, linkCount };\n}\nexport function describeContent(counts: ContentCounts): string {\n  const parts: string[] = [];\n  for (const [count, noun] of [\n    [counts.folderCount, \"folder\"],\n    [counts.fileCount, \"file\"],\n    [counts.linkCount, \"link\"],\n  ] as const) {\n    if (count > 0) parts.push(`${count} ${noun}${count === 1 ? \"\" : \"s\"}`);\n  }\n  return parts.join(\" · \") || \"Empty folder\";\n}\nexport function repositoryName(repositoryUrl: string): string {\n  try {\n    return new URL(repositoryUrl).pathname.replace(/^\\/+|\\/+$/g, \"\").replace(/\\.git$/, \"\");\n  } catch {\n    return repositoryUrl;\n  }\n}\n\nfunction stringValue(value: unknown, label: string): string {\n  if (typeof value !== \"string\") throw new TypeError(`${label} must resolve to a string`);\n  return value;\n}\nfunction safeOutputPath(value: string): string {\n  if (\n    !value ||\n    value.includes(\"\\\\\") ||\n    value.includes(\"\\0\") ||\n    value.startsWith(\"/\") ||\n    /^[a-z]:/i.test(value) ||\n    value.split(\"/\").some((part) => !part || part === \".\" || part === \"..\")\n  )\n    throw new Error(`Unsafe metadata image outputPath: ${value}`);\n  if (value.startsWith(\"__dirwell/\") && !value.startsWith(\"__dirwell/metadata/\"))\n    throw new Error(\"Metadata image cannot overwrite reserved Dirwell assets\");\n  return value;\n}\nfunction deployedRoot(value: string | undefined): URL | undefined {\n  if (value === undefined) return undefined;\n  const url = new URL(value);\n  if (\n    ![\"http:\", \"https:\"].includes(url.protocol) ||\n    url.search ||\n    url.hash ||\n    url.username ||\n    url.password\n  )\n    throw new Error(\n      \"metadata.siteUrl must be an HTTP(S) explorer root without credentials, query, or fragment\",\n    );\n  if (!url.pathname.endsWith(\"/\")) url.pathname += \"/\";\n  return url;\n}\nexport function createMetadataResolver(\n  options: MetadataOptions,\n  defaults: ThemeMetadataDefaults,\n  counts: ContentCounts,\n  sourceDirectory: string,\n) {\n  const site = Object.freeze({\n    ...counts,\n    name: stringValue(options.siteName ?? defaults.siteName, \"metadata.siteName\"),\n    repositoryName: stringValue(\n      options.repositoryName ?? defaults.repositoryName,\n      \"metadata.repositoryName\",\n    ),\n  });\n  const siteUrl = deployedRoot(options.siteUrl);\n  const presetTitle = typeof options.title === \"string\" ? options.title : site.name;\n  const presetDescription =\n    typeof options.description === \"string\"\n      ? options.description\n      : `Archive totals: ${describeContent(site)}`;\n  const assets = new Map<string, Uint8Array>();\n  let defaultImage: Promise<File> | undefined;\n  // One source snapshot per build: fixed images should not reread or rehash per page.\n  const fileSources = new WeakMap<\n    File,\n    Promise<{ bytes: Uint8Array; extension: string; digest: string }>\n  >();\n  const pathSources = new Map<\n    string,\n    Promise<{ bytes: Uint8Array; extension: string; digest: string }>\n  >();\n  const loaded = async (bytes: Uint8Array, filename: string) => {\n    const extension = path.extname(filename).toLowerCase();\n    if (![\".png\", \".jpg\", \".jpeg\", \".webp\", \".gif\"].includes(extension))\n      throw new Error(\"Metadata images must be PNG, JPEG, WebP, or GIF files\");\n    return { bytes, extension, digest: createHash(\"sha256\").update(bytes).digest(\"hex\") };\n  };\n  function loadImage(source: ImageSource) {\n    if (source instanceof File) {\n      let image = fileSources.get(source);\n      if (image === undefined) {\n        image = source.arrayBuffer().then((buffer) => loaded(new Uint8Array(buffer), source.name));\n        fileSources.set(source, image);\n      }\n      return image;\n    }\n    if (typeof source !== \"string\" && !(source instanceof URL))\n      throw new TypeError(\"metadata.image.source must be a File, local path, or file URL\");\n    if (source instanceof URL && source.protocol !== \"file:\")\n      throw new Error(\"metadata.image source URLs must use file:\");\n    const input =\n      source instanceof URL ? fileURLToPath(source) : path.resolve(sourceDirectory, source);\n    let image = pathSources.get(input);\n    if (image === undefined) {\n      image = readFile(input).then((bytes) => loaded(bytes, path.basename(input)));\n      pathSources.set(input, image);\n    }\n    return image;\n  }\n\n  async function imageFor(\n    context: ResolvedMetadataContext,\n  ): Promise<{ outputPath: string; alt: string } | null> {\n    const configured = options.image === undefined ? defaults.image : options.image;\n    const isPreset = configured === undefined && defaults.imageTheme !== undefined;\n    let image = typeof configured === \"function\" ? await configured(context) : configured;\n    if (image === false) return null;\n    if (configured === undefined) {\n      const preset = defaults.imageTheme;\n      if (preset === undefined) return null;\n      defaultImage ??= import(\"./share-image-api.ts\").then(({ createShareImage }) =>\n        createShareImage({\n          theme: preset,\n          repositoryName: site.repositoryName,\n          title: presetTitle,\n          description: presetDescription,\n        }),\n      );\n      image = await defaultImage;\n    }\n    if (image === undefined)\n      throw new TypeError(\"metadata.image callback must return an image or false\");\n    const config: MetadataImage =\n      image instanceof File || typeof image === \"string\" || image instanceof URL\n        ? { source: image }\n        : image;\n    if (!config || typeof config !== \"object\")\n      throw new TypeError(\n        \"metadata.image must resolve to a File, local path, file URL, or source object\",\n      );\n    const { bytes, extension, digest } = await loadImage(config.source);\n    const outputPath = safeOutputPath(\n      config.outputPath ?? `__dirwell/metadata/${digest}${extension}`,\n    );\n    const existing = assets.get(outputPath);\n    if (existing !== undefined && existing !== bytes && !Buffer.from(existing).equals(bytes))\n      throw new Error(`Conflicting metadata image outputPath: ${outputPath}`);\n    assets.set(outputPath, bytes);\n    return {\n      outputPath,\n      alt: stringValue(\n        config.alt ?? (isPreset ? `${presetTitle}. ${presetDescription}` : context.title),\n        \"metadata.image.alt\",\n      ),\n    };\n  }\n  return {\n    assets,\n    async resolve(\n      directory: DirectoryData,\n      hrefForOutput: (outputPath: string) => string,\n      pagePath: string,\n    ): Promise<PageMetadata> {\n      const relativePath = directory.current.relativePath;\n      const context: MetadataContext = Object.freeze({\n        site,\n        directory: Object.freeze({\n          ...countEntries(directory),\n          relativePath,\n          name: directory.current.name,\n        }),\n      });\n      const title = stringValue(\n        typeof options.title === \"function\"\n          ? await options.title(context)\n          : (options.title ?? (relativePath ? `${relativePath} · ${site.name}` : site.name)),\n        \"metadata.title\",\n      );\n      const description = stringValue(\n        typeof options.description === \"function\"\n          ? await options.description(context)\n          : (options.description ??\n              (relativePath\n                ? `Browse ${relativePath} in ${site.name}. This folder: ${describeContent(context.directory)}.`\n                : `Browse files in ${site.name}. Archive totals: ${describeContent(site)}.`)),\n        \"metadata.description\",\n      );\n      const image = await imageFor(Object.freeze({ ...context, title, description }));\n      const meta = (key: string, value: string, property = false) =>\n        `<meta data-dirwell-metadata ${property ? \"property\" : \"name\"}=\"${key}\" content=\"${escapeHtml(value)}\">`;\n      let head = `<title>${escapeHtml(title)}</title>${meta(\"description\", description)}${meta(\"og:title\", title, true)}${meta(\"og:description\", description, true)}${meta(\"og:type\", \"website\", true)}`;\n      if (siteUrl) {\n        const canonical = new URL(pagePath.split(\"/\").map(encodeURIComponent).join(\"/\"), siteUrl)\n          .href;\n        head += `${meta(\"og:url\", canonical, true)}<link data-dirwell-metadata rel=\"canonical\" href=\"${escapeHtml(canonical)}\">`;\n      }\n      if (image) {\n        const href = siteUrl\n          ? new URL(image.outputPath.split(\"/\").map(encodeURIComponent).join(\"/\"), siteUrl).href\n          : hrefForOutput(image.outputPath);\n        head +=\n          meta(\"og:image\", href, true) +\n          meta(\"og:image:alt\", image.alt, true) +\n          meta(\"twitter:card\", \"summary_large_image\") +\n          meta(\"twitter:title\", title) +\n          meta(\"twitter:description\", description) +\n          meta(\"twitter:image\", href) +\n          meta(\"twitter:image:alt\", image.alt);\n      }\n      return { title, description, head };\n    },\n  };\n}\n","import type {\n  MetadataOptions,\n  ThemeMetadataDefaults,\n  MetadataProviderFactory,\n} from \"@dirwell/core\";\nimport { countKinds, createMetadataResolver } from \"./metadata.ts\";\nexport { createShareImage } from \"./share-image-api.ts\";\nexport type { ShareImageOptions } from \"./share-image-api.ts\";\nexport {\n  countEntries,\n  countKinds,\n  describeContent,\n  repositoryName,\n  createMetadataResolver,\n} from \"./metadata.ts\";\n/** Opt-in build metadata. PNG presets are generated only when defaults.imageTheme is supplied. */\nexport function createMetadataProvider(\n  options: MetadataOptions,\n  defaults: ThemeMetadataDefaults,\n  sourceDirectory = process.cwd(),\n): MetadataProviderFactory {\n  return ({ sourceKinds }) =>\n    createMetadataResolver(options, defaults, countKinds(sourceKinds.values()), sourceDirectory);\n}\n"],"mappings":"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"}

package/dist/share-image-D2N_4dRw.mjs

@@ -0,0 +1,140 @@
+import { escapeHtml } from "@dirwell/core";
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { create } from "fontkit";
+import { Resvg } from "@resvg/resvg-js";
+//#region src/share-image.ts
+const fontNames = [
+	"SourceSans3-Regular.otf",
+	"SourceSans3-Light.otf",
+	"SourceSerif4-Regular.otf"
+];
+const buffers = await Promise.all(fontNames.map((name) => readFile(new URL(`./fonts/${name}`, import.meta.url))));
+const fonts = buffers.map((bytes) => create(bytes));
+const fontDigest = createHash("sha256").update(Buffer.concat(buffers)).digest("hex");
+const themes = {
+	ledger: {
+		name: "Ledger",
+		face: 0,
+		family: "Source Sans 3",
+		bg: "#f3f0e8",
+		fg: "#171815",
+		muted: "#64655f",
+		rule: "#c9c5ba",
+		weight: 400
+	},
+	plain: {
+		name: "Plain",
+		face: 2,
+		family: "Source Serif 4",
+		bg: "#ffffff",
+		fg: "#171815",
+		muted: "#454545",
+		rule: "#171815",
+		weight: 400
+	},
+	crosswave: {
+		name: "Crosswave",
+		face: 1,
+		family: "Source Sans 3",
+		bg: "#091a3a",
+		fg: "#f7fbff",
+		muted: "#edf4fc",
+		rule: "#edf4fc",
+		weight: 300
+	}
+};
+const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" });
+function width(text, face, size) {
+	const font = fonts[face];
+	return font.layout(text).positions.reduce((sum, position) => sum + position.xAdvance, 0) * size / font.unitsPerEm;
+}
+function fit(value, face, sizes, limit, maxLines = 2) {
+	if (typeof value !== "string") throw new TypeError("Share image text must be a string");
+	const text = Array.from(segmenter.segment(value.slice(0, 16384).normalize("NFC").replace(/\s+/g, " ").trim()), (part) => part.segment);
+	const bounded = text.slice(0, 2048);
+	for (const character of bounded.join("")) {
+		const codePoint = character.codePointAt(0);
+		if (!fonts[face].hasGlyphForCodePoint(codePoint)) throw new Error(`Bundled share-image font lacks U+${codePoint.toString(16).toUpperCase()}; use a custom image renderer or metadata.image: false`);
+	}
+	for (const size of sizes) {
+		let position = 0;
+		const lines = [];
+		while (position < bounded.length && lines.length < maxLines) {
+			let low = 0, high = bounded.length - position;
+			while (low < high) {
+				const count = Math.ceil((low + high) / 2);
+				if (width(bounded.slice(position, position + count).join(""), face, size) <= limit) low = count;
+				else high = count - 1;
+			}
+			const end = position + Math.max(1, low);
+			let line = bounded.slice(position, end).join("").trim();
+			if (lines.length === maxLines - 1 && (end < text.length || value.length > 16384)) {
+				let graphemes = Array.from(segmenter.segment(line), (part) => part.segment);
+				while (graphemes.length && width(graphemes.join("") + "…", face, size) > limit) graphemes.pop();
+				line = graphemes.join("") + "…";
+			}
+			lines.push(line);
+			position = end;
+		}
+		if (position >= text.length || size === sizes.at(-1)) return {
+			size,
+			lines
+		};
+	}
+	return {
+		size: 56,
+		lines: []
+	};
+}
+function text(value, x, y, gap, fill, family, weight = 400, anchor = "start") {
+	return value.lines.map((line, index) => `<text x="${x}" y="${y + index * gap}" font-family="${family}" font-weight="${weight}" font-size="${value.size}" fill="${fill}" text-anchor="${anchor}">${escapeHtml(line)}</text>`).join("");
+}
+const wave = `<defs><linearGradient id="bg" x2=".2" y2="1"><stop stop-color="#2b4f85"/><stop offset="1" stop-color="#091a3a"/></linearGradient><linearGradient id="ribbon"><stop stop-color="#80afff" stop-opacity=".02"/><stop offset=".5" stop-color="#b7d6ff" stop-opacity=".24"/><stop offset="1" stop-color="#e6f2ff" stop-opacity=".03"/></linearGradient></defs><rect width="1200" height="630" fill="url(#bg)"/><path d="M-80 470C170 270 330 560 630 435S980 290 1280 470" stroke="url(#ribbon)" stroke-width="32" fill="none"/><path d="M-80 495C170 590 370 315 690 465S1020 580 1280 390" stroke="url(#ribbon)" stroke-width="14" fill="none"/>`;
+const cache = /* @__PURE__ */ new Map();
+/** Build-time PNG generation with bundled fonts; no network or system-font search. */
+function renderShareImage(options) {
+	const theme = options.theme ?? "ledger";
+	const t = themes[theme];
+	if (!t) throw new TypeError("Unknown share image theme");
+	const regular = theme === "plain" ? 2 : 0;
+	const headline = fit(options.title, t.face, [
+		96,
+		88,
+		80,
+		72,
+		64,
+		56
+	], 1064);
+	const header = fit(options.repositoryName ?? "", regular, [
+		30,
+		28,
+		26
+	], 800, 1);
+	const description = fit(options.description, regular, [
+		34,
+		30,
+		26
+	], 1064, 1);
+	const directory = fit(options.directoryPath ? `/${options.directoryPath}/` : "", regular, [24], 1064, 1);
+	const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630"><rect width="1200" height="630" fill="${t.bg}"/>${theme === "crosswave" ? wave : ""}${text(header, 68, 86, 0, t.fg, t.family)}${text({
+		size: 30,
+		lines: [t.name]
+	}, 1130, 86, 0, t.fg, t.family, 400, "end")}${theme === "crosswave" ? "" : `<path d="M64 126H1136" stroke="${t.rule}"/>`}${text(headline, 68, 276, 112, t.fg, t.family, t.weight)}${text(description, 68, 480, 0, t.muted, t.family)}${text(directory, 68, 572, 0, t.muted, t.family)}</svg>`;
+	const key = createHash("sha256").update(fontDigest).update(svg).digest("hex");
+	const previous = cache.get(key);
+	if (previous) return previous;
+	const png = new Resvg(svg, { font: {
+		fontFiles: fontNames.map((name) => fileURLToPath(new URL(`./fonts/${name}`, import.meta.url))),
+		loadSystemFonts: false
+	} }).render().asPng();
+	const file = new File([new Uint8Array(png)], `${theme}.png`, { type: "image/png" });
+	if (cache.size >= 32) cache.delete(cache.keys().next().value);
+	cache.set(key, file);
+	return file;
+}
+//#endregion
+export { renderShareImage };
+
+//# sourceMappingURL=share-image-D2N_4dRw.mjs.map

package/dist/share-image-D2N_4dRw.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-image-D2N_4dRw.mjs","names":[],"sources":["../src/share-image.ts"],"sourcesContent":["import { escapeHtml } from \"@dirwell/core\";\nimport { readFile } from \"node:fs/promises\";\nimport { fileURLToPath } from \"node:url\";\nimport { createHash } from \"node:crypto\";\nimport { create, type Font } from \"fontkit\";\nimport { Resvg } from \"@resvg/resvg-js\";\n\nexport interface ShareImageOptions {\n  readonly theme?: \"ledger\" | \"plain\" | \"crosswave\";\n  readonly title: string;\n  readonly description: string;\n  readonly repositoryName?: string;\n  readonly directoryPath?: string;\n}\nconst fontNames = [\n  \"SourceSans3-Regular.otf\",\n  \"SourceSans3-Light.otf\",\n  \"SourceSerif4-Regular.otf\",\n] as const;\nconst buffers = await Promise.all(\n  fontNames.map((name) => readFile(new URL(`./fonts/${name}`, import.meta.url))),\n);\nconst fonts = buffers.map((bytes) => create(bytes) as Font);\nconst fontDigest = createHash(\"sha256\").update(Buffer.concat(buffers)).digest(\"hex\");\nconst themes = {\n  ledger: {\n    name: \"Ledger\",\n    face: 0,\n    family: \"Source Sans 3\",\n    bg: \"#f3f0e8\",\n    fg: \"#171815\",\n    muted: \"#64655f\",\n    rule: \"#c9c5ba\",\n    weight: 400,\n  },\n  plain: {\n    name: \"Plain\",\n    face: 2,\n    family: \"Source Serif 4\",\n    bg: \"#ffffff\",\n    fg: \"#171815\",\n    muted: \"#454545\",\n    rule: \"#171815\",\n    weight: 400,\n  },\n  crosswave: {\n    name: \"Crosswave\",\n    face: 1,\n    family: \"Source Sans 3\",\n    bg: \"#091a3a\",\n    fg: \"#f7fbff\",\n    muted: \"#edf4fc\",\n    rule: \"#edf4fc\",\n    weight: 300,\n  },\n} as const;\nconst segmenter = new Intl.Segmenter(\"en\", { granularity: \"grapheme\" });\n\nfunction width(text: string, face: number, size: number): number {\n  const font = fonts[face]!;\n  return (\n    (font.layout(text).positions.reduce((sum, position) => sum + position.xAdvance, 0) * size) /\n    font.unitsPerEm\n  );\n}\nfunction fit(\n  value: string,\n  face: number,\n  sizes: readonly number[],\n  limit: number,\n  maxLines = 2,\n): { size: number; lines: string[] } {\n  if (typeof value !== \"string\") throw new TypeError(\"Share image text must be a string\");\n  const text = Array.from(\n    segmenter.segment(value.slice(0, 16384).normalize(\"NFC\").replace(/\\s+/g, \" \").trim()),\n    (part) => part.segment,\n  );\n  const bounded = text.slice(0, 2048);\n  for (const character of bounded.join(\"\")) {\n    const codePoint = character.codePointAt(0)!;\n    if (!fonts[face]!.hasGlyphForCodePoint(codePoint))\n      throw new Error(\n        `Bundled share-image font lacks U+${codePoint.toString(16).toUpperCase()}; use a custom image renderer or metadata.image: false`,\n      );\n  }\n  for (const size of sizes) {\n    let position = 0;\n    const lines: string[] = [];\n    while (position < bounded.length && lines.length < maxLines) {\n      let low = 0,\n        high = bounded.length - position;\n      while (low < high) {\n        const count = Math.ceil((low + high) / 2);\n        if (width(bounded.slice(position, position + count).join(\"\"), face, size) <= limit)\n          low = count;\n        else high = count - 1;\n      }\n      const end = position + Math.max(1, low);\n      let line = bounded.slice(position, end).join(\"\").trim();\n      if (lines.length === maxLines - 1 && (end < text.length || value.length > 16384)) {\n        let graphemes = Array.from(segmenter.segment(line), (part) => part.segment);\n        while (graphemes.length && width(graphemes.join(\"\") + \"…\", face, size) > limit)\n          graphemes.pop();\n        line = graphemes.join(\"\") + \"…\";\n      }\n      lines.push(line);\n      position = end;\n    }\n    if (position >= text.length || size === sizes.at(-1)) return { size, lines };\n  }\n  return { size: 56, lines: [] };\n}\nfunction text(\n  value: { size: number; lines: string[] },\n  x: number,\n  y: number,\n  gap: number,\n  fill: string,\n  family: string,\n  weight = 400,\n  anchor = \"start\",\n): string {\n  return value.lines\n    .map(\n      (line, index) =>\n        `<text x=\"${x}\" y=\"${y + index * gap}\" font-family=\"${family}\" font-weight=\"${weight}\" font-size=\"${value.size}\" fill=\"${fill}\" text-anchor=\"${anchor}\">${escapeHtml(line)}</text>`,\n    )\n    .join(\"\");\n}\nconst wave = `<defs><linearGradient id=\"bg\" x2=\".2\" y2=\"1\"><stop stop-color=\"#2b4f85\"/><stop offset=\"1\" stop-color=\"#091a3a\"/></linearGradient><linearGradient id=\"ribbon\"><stop stop-color=\"#80afff\" stop-opacity=\".02\"/><stop offset=\".5\" stop-color=\"#b7d6ff\" stop-opacity=\".24\"/><stop offset=\"1\" stop-color=\"#e6f2ff\" stop-opacity=\".03\"/></linearGradient></defs><rect width=\"1200\" height=\"630\" fill=\"url(#bg)\"/><path d=\"M-80 470C170 270 330 560 630 435S980 290 1280 470\" stroke=\"url(#ribbon)\" stroke-width=\"32\" fill=\"none\"/><path d=\"M-80 495C170 590 370 315 690 465S1020 580 1280 390\" stroke=\"url(#ribbon)\" stroke-width=\"14\" fill=\"none\"/>`;\nconst cache = new Map<string, File>();\n/** Build-time PNG generation with bundled fonts; no network or system-font search. */\nexport function renderShareImage(options: ShareImageOptions): File {\n  const theme = options.theme ?? \"ledger\";\n  const t = themes[theme];\n  if (!t) throw new TypeError(\"Unknown share image theme\");\n  const regular = theme === \"plain\" ? 2 : 0;\n  const headline = fit(options.title, t.face, [96, 88, 80, 72, 64, 56], 1064);\n  const header = fit(options.repositoryName ?? \"\", regular, [30, 28, 26], 800, 1);\n  const description = fit(options.description, regular, [34, 30, 26], 1064, 1);\n  const directory = fit(\n    options.directoryPath ? `/${options.directoryPath}/` : \"\",\n    regular,\n    [24],\n    1064,\n    1,\n  );\n  const svg = `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1200\" height=\"630\" viewBox=\"0 0 1200 630\"><rect width=\"1200\" height=\"630\" fill=\"${t.bg}\"/>${theme === \"crosswave\" ? wave : \"\"}${text(header, 68, 86, 0, t.fg, t.family)}${text({ size: 30, lines: [t.name] }, 1130, 86, 0, t.fg, t.family, 400, \"end\")}${theme === \"crosswave\" ? \"\" : `<path d=\"M64 126H1136\" stroke=\"${t.rule}\"/>`}${text(headline, 68, 276, 112, t.fg, t.family, t.weight)}${text(description, 68, 480, 0, t.muted, t.family)}${text(directory, 68, 572, 0, t.muted, t.family)}</svg>`;\n  const key = createHash(\"sha256\").update(fontDigest).update(svg).digest(\"hex\");\n  const previous = cache.get(key);\n  if (previous) return previous;\n  const png = new Resvg(svg, {\n    font: {\n      fontFiles: fontNames.map((name) =>\n        fileURLToPath(new URL(`./fonts/${name}`, import.meta.url)),\n      ),\n      loadSystemFonts: false,\n    },\n  })\n    .render()\n    .asPng();\n  const file = new File([new Uint8Array(png)], `${theme}.png`, { type: \"image/png\" });\n  if (cache.size >= 32) cache.delete(cache.keys().next().value!);\n  cache.set(key, file);\n  return file;\n}\n"],"mappings":";;;;;;;AAcA,MAAM,YAAY;CAChB;CACA;CACA;AACF;AACA,MAAM,UAAU,MAAM,QAAQ,IAC5B,UAAU,KAAK,SAAS,SAAS,IAAI,IAAI,WAAW,QAAQ,YAAY,GAAG,CAAC,CAAC,CAC/E;AACA,MAAM,QAAQ,QAAQ,KAAK,UAAU,OAAO,KAAK,CAAS;AAC1D,MAAM,aAAa,WAAW,QAAQ,CAAC,CAAC,OAAO,OAAO,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK;AACnF,MAAM,SAAS;CACb,QAAQ;EACN,MAAM;EACN,MAAM;EACN,QAAQ;EACR,IAAI;EACJ,IAAI;EACJ,OAAO;EACP,MAAM;EACN,QAAQ;CACV;CACA,OAAO;EACL,MAAM;EACN,MAAM;EACN,QAAQ;EACR,IAAI;EACJ,IAAI;EACJ,OAAO;EACP,MAAM;EACN,QAAQ;CACV;CACA,WAAW;EACT,MAAM;EACN,MAAM;EACN,QAAQ;EACR,IAAI;EACJ,IAAI;EACJ,OAAO;EACP,MAAM;EACN,QAAQ;CACV;AACF;AACA,MAAM,YAAY,IAAI,KAAK,UAAU,MAAM,EAAE,aAAa,WAAW,CAAC;AAEtE,SAAS,MAAM,MAAc,MAAc,MAAsB;CAC/D,MAAM,OAAO,MAAM;CACnB,OACG,KAAK,OAAO,IAAI,CAAC,CAAC,UAAU,QAAQ,KAAK,aAAa,MAAM,SAAS,UAAU,CAAC,IAAI,OACrF,KAAK;AAET;AACA,SAAS,IACP,OACA,MACA,OACA,OACA,WAAW,GACwB;CACnC,IAAI,OAAO,UAAU,UAAU,MAAM,IAAI,UAAU,mCAAmC;CACtF,MAAM,OAAO,MAAM,KACjB,UAAU,QAAQ,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,QAAQ,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,IACnF,SAAS,KAAK,OACjB;CACA,MAAM,UAAU,KAAK,MAAM,GAAG,IAAI;CAClC,KAAK,MAAM,aAAa,QAAQ,KAAK,EAAE,GAAG;EACxC,MAAM,YAAY,UAAU,YAAY,CAAC;EACzC,IAAI,CAAC,MAAM,KAAK,CAAE,qBAAqB,SAAS,GAC9C,MAAM,IAAI,MACR,oCAAoC,UAAU,SAAS,EAAE,CAAC,CAAC,YAAY,EAAE,uDAC3E;CACJ;CACA,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,WAAW;EACf,MAAM,QAAkB,CAAC;EACzB,OAAO,WAAW,QAAQ,UAAU,MAAM,SAAS,UAAU;GAC3D,IAAI,MAAM,GACR,OAAO,QAAQ,SAAS;GAC1B,OAAO,MAAM,MAAM;IACjB,MAAM,QAAQ,KAAK,MAAM,MAAM,QAAQ,CAAC;IACxC,IAAI,MAAM,QAAQ,MAAM,UAAU,WAAW,KAAK,CAAC,CAAC,KAAK,EAAE,GAAG,MAAM,IAAI,KAAK,OAC3E,MAAM;SACH,OAAO,QAAQ;GACtB;GACA,MAAM,MAAM,WAAW,KAAK,IAAI,GAAG,GAAG;GACtC,IAAI,OAAO,QAAQ,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK;GACtD,IAAI,MAAM,WAAW,WAAW,MAAM,MAAM,KAAK,UAAU,MAAM,SAAS,QAAQ;IAChF,IAAI,YAAY,MAAM,KAAK,UAAU,QAAQ,IAAI,IAAI,SAAS,KAAK,OAAO;IAC1E,OAAO,UAAU,UAAU,MAAM,UAAU,KAAK,EAAE,IAAI,KAAK,MAAM,IAAI,IAAI,OACvE,UAAU,IAAI;IAChB,OAAO,UAAU,KAAK,EAAE,IAAI;GAC9B;GACA,MAAM,KAAK,IAAI;GACf,WAAW;EACb;EACA,IAAI,YAAY,KAAK,UAAU,SAAS,MAAM,GAAG,EAAE,GAAG,OAAO;GAAE;GAAM;EAAM;CAC7E;CACA,OAAO;EAAE,MAAM;EAAI,OAAO,CAAC;CAAE;AAC/B;AACA,SAAS,KACP,OACA,GACA,GACA,KACA,MACA,QACA,SAAS,KACT,SAAS,SACD;CACR,OAAO,MAAM,MACV,KACE,MAAM,UACL,YAAY,EAAE,OAAO,IAAI,QAAQ,IAAI,iBAAiB,OAAO,iBAAiB,OAAO,eAAe,MAAM,KAAK,UAAU,KAAK,iBAAiB,OAAO,IAAI,WAAW,IAAI,EAAE,QAC/K,CAAC,CACA,KAAK,EAAE;AACZ;AACA,MAAM,OAAO;AACb,MAAM,wBAAQ,IAAI,IAAkB;;AAEpC,SAAgB,iBAAiB,SAAkC;CACjE,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,IAAI,OAAO;CACjB,IAAI,CAAC,GAAG,MAAM,IAAI,UAAU,2BAA2B;CACvD,MAAM,UAAU,UAAU,UAAU,IAAI;CACxC,MAAM,WAAW,IAAI,QAAQ,OAAO,EAAE,MAAM;EAAC;EAAI;EAAI;EAAI;EAAI;EAAI;CAAE,GAAG,IAAI;CAC1E,MAAM,SAAS,IAAI,QAAQ,kBAAkB,IAAI,SAAS;EAAC;EAAI;EAAI;CAAE,GAAG,KAAK,CAAC;CAC9E,MAAM,cAAc,IAAI,QAAQ,aAAa,SAAS;EAAC;EAAI;EAAI;CAAE,GAAG,MAAM,CAAC;CAC3E,MAAM,YAAY,IAChB,QAAQ,gBAAgB,IAAI,QAAQ,cAAc,KAAK,IACvD,SACA,CAAC,EAAE,GACH,MACA,CACF;CACA,MAAM,MAAM,kIAAkI,EAAE,GAAG,KAAK,UAAU,cAAc,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,GAAG,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK;EAAE,MAAM;EAAI,OAAO,CAAC,EAAE,IAAI;CAAE,GAAG,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,QAAQ,KAAK,KAAK,IAAI,UAAU,cAAc,KAAK,kCAAkC,EAAE,KAAK,OAAO,KAAK,UAAU,IAAI,KAAK,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,aAAa,IAAI,KAAK,GAAG,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK,WAAW,IAAI,KAAK,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE;CAC7hB,MAAM,MAAM,WAAW,QAAQ,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,KAAK;CAC5E,MAAM,WAAW,MAAM,IAAI,GAAG;CAC9B,IAAI,UAAU,OAAO;CACrB,MAAM,MAAM,IAAI,MAAM,KAAK,EACzB,MAAM;EACJ,WAAW,UAAU,KAAK,SACxB,cAAc,IAAI,IAAI,WAAW,QAAQ,YAAY,GAAG,CAAC,CAC3D;EACA,iBAAiB;CACnB,EACF,CAAC,CAAC,CACC,OAAO,CAAC,CACR,MAAM;CACT,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI,WAAW,GAAG,CAAC,GAAG,GAAG,MAAM,OAAO,EAAE,MAAM,YAAY,CAAC;CAClF,IAAI,MAAM,QAAQ,IAAI,MAAM,OAAO,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAM;CAC7D,MAAM,IAAI,KAAK,IAAI;CACnB,OAAO;AACT"}

package/dist/share-image-api-BZH7001a.mjs

@@ -0,0 +1,2 @@
+import { t as createShareImage } from "./share-image-api-DcmMcWT0.mjs";
+export { createShareImage };

package/dist/share-image-api-DcmMcWT0.mjs

@@ -0,0 +1,10 @@
+//#region src/share-image-api.ts
+/** Render a PNG at build time using the selected built-in theme and bundled fonts. */
+async function createShareImage(options) {
+	const { renderShareImage } = await import("./share-image-D2N_4dRw.mjs");
+	return renderShareImage(options);
+}
+//#endregion
+export { createShareImage as t };
+
+//# sourceMappingURL=share-image-api-DcmMcWT0.mjs.map

package/dist/share-image-api-DcmMcWT0.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-image-api-DcmMcWT0.mjs","names":[],"sources":["../src/share-image-api.ts"],"sourcesContent":["import type { ShareImageOptions } from \"./share-image.ts\";\nexport type { ShareImageOptions } from \"./share-image.ts\";\n/** Render a PNG at build time using the selected built-in theme and bundled fonts. */\nexport async function createShareImage(options: ShareImageOptions): Promise<File> {\n  const { renderShareImage } = await import(\"./share-image.ts\");\n  return renderShareImage(options);\n}\n"],"mappings":";;AAGA,eAAsB,iBAAiB,SAA2C;CAChF,MAAM,EAAE,qBAAqB,MAAM,OAAO;CAC1C,OAAO,iBAAiB,OAAO;AACjC"}

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@dirwell/share-image",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1-alpha",
+  "description": "Optional build-time metadata and PNG share-image rendering.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vp-tw/dirwell.git",
+    "directory": "packages/share-image"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "tag": "alpha"
+  },
+  "dependencies": {
+    "@dirwell/core": "0.0.1-alpha",
+    "@resvg/resvg-js": "2.6.2",
+    "fontkit": "2.0.4"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "vp pack && node ../../scripts/copy-share-image-assets.mjs"
+  }
 }