@dirwell/share-image 0.0.1 → 0.0.2

package/README.md

@@ -7,7 +7,7 @@ Optional build-time metadata and 1200 × 630 PNG images. Install this package on
 ## Save a share image
 
 ```sh
-npm install @dirwell/share-image@0.0.1
+npm install @dirwell/share-image@0.0.2
 ```
 
 Save this as `image.mjs`, then run `node image.mjs`:
@@ -28,7 +28,7 @@ The result is a local 1200 × 630 PNG. No explorer build or browser runtime is r
 ## Add metadata to an explorer
 
 ```sh
-npm install @dirwell/core@0.0.1 @dirwell/theme-plain@0.0.1 @dirwell/share-image@0.0.1
+npm install @dirwell/core@0.0.2 @dirwell/theme-plain@0.0.2 @dirwell/share-image@0.0.2
 ```
 
 Create `files/note.txt`, save the following as `build.mjs` and run `node build.mjs`. Serve the complete `public/downloads` folder over HTTP; its pages reference the generated metadata/image assets.
@@ -49,8 +49,23 @@ await generateExplorer({
 });
 ```
 
-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.
+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 by default or the supplied local fonts described below, and retains at most 32 rendered PNGs per process. No network/system-font lookup occurs. The selected fonts must cover every displayed character; unsupported text fails instead of silently emitting missing glyphs. Supply a licensed local font for other scripts, or use a separate renderer when the required shaping is outside your qualified workload. 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.
 
 The 0.0.x API may evolve. Pin your qualified version and upgrade the official family together. See [support and verification](https://vp-tw.github.io/dirwell/support/) for host, browser and device boundaries.
+
+## Custom local fonts (0.0.2)
+
+Supply a licensed single-face TTF or OTF file with coverage for every displayed character. Paths resolve from the process cwd; local file URLs also work. A body font supplies both roles unless a headline font is specified. Font files are read for each call, limited to 32 MiB each, and their byte digests invalidate the 32-image cache. No font is downloaded and no system font is consulted.
+
+```js
+const image = await createShareImage({
+  theme: "ledger",
+  title: "資料下載",
+  description: "Release files",
+  fonts: { body: new URL("./fonts/MyLicensedFont.ttf", import.meta.url) },
+});
+```
+
+Custom text is shaped and outlined from the supplied bytes. Missing glyphs fail with the role and Unicode code point; no silent fallback is used. Collections, WOFF/WOFF2 and remote URLs are unsupported. Use a complete font for your text; the repository's renamed OFL test subset is deliberately limited. To use the image in metadata, pass the resulting `File` through `createMetadataProvider({ image, ... })`, or call the renderer from an async image callback. Complex-script/emoji rendering beyond the qualified Latin/CJK workload requires your own qualification.

package/dist/index.d.mts

@@ -1,6 +1,11 @@
 import { ContentCounts, DirectoryData, MetadataOptions, MetadataProviderFactory, PageMetadata, ThemeMetadataDefaults } from "@dirwell/core";
 //#region src/share-image.d.ts
+interface ShareImageFonts {
+  readonly body?: string | URL;
+  readonly headline?: string | URL;
+}
 interface ShareImageOptions {
+  readonly fonts?: ShareImageFonts;
   readonly theme?: "ledger" | "plain" | "crosswave";
   readonly title: string;
   readonly description: string;
@@ -9,7 +14,7 @@ interface ShareImageOptions {
 }
 //#endregion
 //#region src/share-image-api.d.ts
-/** Render a PNG at build time using the selected built-in theme and bundled fonts. */
+/** Render a PNG at build time using the selected preset and bundled or supplied local fonts. */
 export declare function createShareImage(options: ShareImageOptions): Promise<File>;
 //#endregion
 //#region src/metadata.d.ts
@@ -26,5 +31,5 @@ export declare function createMetadataResolver(options: MetadataOptions, default
 /** 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 };
+export type { ShareImageFonts, ShareImageOptions };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as createShareImage } from "./share-image-api-DcmMcWT0.mjs";
+import { t as createShareImage } from "./share-image-api-BIAcrVlH.mjs";
 import { escapeHtml } from "@dirwell/core";
 import { createHash } from "node:crypto";
 import { readFile } from "node:fs/promises";
@@ -106,7 +106,7 @@ function createMetadataResolver(options, defaults, counts, sourceDirectory) {
 		if (configured === void 0) {
 			const preset = defaults.imageTheme;
 			if (preset === void 0) return null;
-			defaultImage ??= import("./share-image-api-BZH7001a.mjs").then(({ createShareImage }) => createShareImage({
+			defaultImage ??= import("./share-image-api-BVDAWsM-.mjs").then(({ createShareImage }) => createShareImage({
 				theme: preset,
 				repositoryName: site.repositoryName,
 				title: presetTitle,

package/dist/index.mjs.map

@@ -1 +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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"}
+{"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, ShareImageFonts } 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 → share-image-DPfRwKbZ.mjs}

@@ -1,6 +1,6 @@
 import { escapeHtml } from "@dirwell/core";
 import { createHash } from "node:crypto";
-import { readFile } from "node:fs/promises";
+import { open, readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 import { create } from "fontkit";
 import { Resvg } from "@resvg/resvg-js";
@@ -46,18 +46,62 @@ const themes = {
 	}
 };
 const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" });
+async function loadFace(source, role) {
+	if (typeof source !== "string" && !(source instanceof URL) || typeof source === "string" && (!source || /^[a-z][a-z0-9+.-]*:\/\//i.test(source)) || source instanceof URL && (source.protocol !== "file:" || source.hostname && source.hostname !== "localhost")) throw new TypeError(`fonts.${role} must be a local path or file URL`);
+	const handle = await open(source, "r").catch((cause) => {
+		throw new TypeError(`Cannot read fonts.${role}`, { cause });
+	});
+	let bytes;
+	try {
+		const stats = await handle.stat();
+		if (!stats.isFile()) throw new TypeError(`fonts.${role} must refer to a regular font file`);
+		const size = stats.size;
+		if (size < 12) throw new TypeError(`fonts.${role} must contain a valid TTF or OTF header`);
+		if (size > 33554432) throw new TypeError(`fonts.${role} must be at most 32 MiB`);
+		const bounded = Buffer.alloc(size + 1);
+		let received = 0;
+		while (received < bounded.length) {
+			const result = await handle.read(bounded, received, bounded.length - received, null);
+			if (!result.bytesRead) break;
+			received += result.bytesRead;
+		}
+		if (received !== size) throw new TypeError(`fonts.${role} changed while being read`);
+		bytes = bounded.subarray(0, received);
+	} finally {
+		await handle.close();
+	}
+	if (bytes.readUInt32BE(0) !== 65536 && bytes.toString("ascii", 0, 4) !== "OTTO") throw new TypeError(`fonts.${role} must be a single TTF or OTF font`);
+	let font;
+	try {
+		font = create(bytes);
+		if (typeof font.layout !== "function" || !Number.isFinite(font.unitsPerEm) || font.unitsPerEm <= 0) throw new TypeError("Invalid font metrics");
+	} catch (cause) {
+		throw new TypeError(`Invalid fonts.${role}`, { cause });
+	}
+	return {
+		face: {
+			font,
+			custom: true,
+			role
+		},
+		bytes
+	};
+}
+function requireGlyphs(value, face) {
+	for (const character of value) {
+		const codePoint = character.codePointAt(0);
+		if (!face.font.hasGlyphForCodePoint(codePoint)) throw new Error(`${face.custom ? `Share-image ${face.role}` : "Bundled share-image"} font lacks U+${codePoint.toString(16).toUpperCase()}; supply a font with glyph coverage or metadata.image: false`);
+	}
+}
 function width(text, face, size) {
-	const font = fonts[face];
+	const font = face.font;
 	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`);
-	}
+	requireGlyphs(bounded.join(""), face);
 	for (const size of sizes) {
 		let position = 0;
 		const lines = [];
@@ -74,6 +118,7 @@ function fit(value, face, sizes, limit, maxLines = 2) {
 				let graphemes = Array.from(segmenter.segment(line), (part) => part.segment);
 				while (graphemes.length && width(graphemes.join("") + "…", face, size) > limit) graphemes.pop();
 				line = graphemes.join("") + "…";
+				requireGlyphs(line, face);
 			}
 			lines.push(line);
 			position = end;
@@ -88,18 +133,51 @@ function fit(value, face, sizes, limit, maxLines = 2) {
 		lines: []
 	};
 }
-function text(value, x, y, gap, fill, family, weight = 400, anchor = "start") {
+function text(value, x, y, gap, fill, family, weight = 400, anchor = "start", face) {
+	if (face?.custom) return value.lines.map((line, index) => {
+		requireGlyphs(line, face);
+		const run = face.font.layout(line), scale = value.size / face.font.unitsPerEm;
+		const total = run.positions.reduce((sum, position) => sum + position.xAdvance, 0);
+		let advance = 0;
+		return run.glyphs.map((glyph, position) => {
+			const offset = run.positions[position];
+			const data = glyph.path.toSVG();
+			const translatedX = x + (advance + offset.xOffset - (anchor === "end" ? total : 0)) * scale;
+			advance += offset.xAdvance;
+			return data ? `<path d="${data}" transform="translate(${translatedX} ${y + index * gap - offset.yOffset * scale}) scale(${scale} ${-scale})" fill="${fill}"/>` : "";
+		}).join("");
+	}).join("");
 	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) {
+/** Build-time PNG generation with bundled or supplied local fonts; no network or system-font search. */
+async 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, [
+	if (options.fonts !== void 0 && (typeof options.fonts !== "object" || options.fonts === null || Array.isArray(options.fonts) || Object.keys(options.fonts).some((key) => !["body", "headline"].includes(key)))) throw new TypeError("fonts must contain only body/headline local font paths");
+	const body = options.fonts?.body === void 0 ? null : await loadFace(options.fonts.body, "body");
+	const customHeadline = options.fonts?.headline === void 0 ? body : await loadFace(options.fonts.headline, "headline");
+	const regular = body?.face ?? {
+		font: fonts[theme === "plain" ? 2 : 0],
+		custom: false,
+		role: "body"
+	};
+	const headlineFace = customHeadline ? {
+		...customHeadline.face,
+		role: "headline"
+	} : {
+		font: fonts[t.face],
+		custom: false,
+		role: "headline"
+	};
+	const digest = createHash("sha256").update(JSON.stringify([
+		fontDigest,
+		body ? createHash("sha256").update(body.bytes).digest("hex") : null,
+		customHeadline ? createHash("sha256").update(customHeadline.bytes).digest("hex") : null
+	])).digest("hex");
+	const headline = fit(options.title, headlineFace, [
 		96,
 		88,
 		80,
@@ -118,11 +196,11 @@ function renderShareImage(options) {
 		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({
+	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, 400, "start", regular)}${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");
+	}, 1130, 86, 0, t.fg, t.family, 400, "end", regular)}${theme === "crosswave" ? "" : `<path d="M64 126H1136" stroke="${t.rule}"/>`}${text(headline, 68, 276, 112, t.fg, t.family, t.weight, "start", headlineFace)}${text(description, 68, 480, 0, t.muted, t.family, 400, "start", regular)}${text(directory, 68, 572, 0, t.muted, t.family, 400, "start", regular)}</svg>`;
+	const key = createHash("sha256").update(digest).update(svg).digest("hex");
 	const previous = cache.get(key);
 	if (previous) return previous;
 	const png = new Resvg(svg, { font: {
@@ -137,4 +215,4 @@ function renderShareImage(options) {
 //#endregion
 export { renderShareImage };
 
-//# sourceMappingURL=share-image-D2N_4dRw.mjs.map
+//# sourceMappingURL=share-image-DPfRwKbZ.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"share-image-DPfRwKbZ.mjs","names":[],"sources":["../src/share-image.ts"],"sourcesContent":["import { escapeHtml } from \"@dirwell/core\";\nimport { readFile, open } 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 ShareImageFonts {\n  readonly body?: string | URL;\n  readonly headline?: string | URL;\n}\nexport interface ShareImageOptions {\n  readonly fonts?: ShareImageFonts;\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\ninterface ImageFace {\n  readonly font: Font;\n  readonly custom: boolean;\n  readonly role: \"body\" | \"headline\";\n}\nasync function loadFace(source: string | URL, role: ImageFace[\"role\"]) {\n  if (\n    (typeof source !== \"string\" && !(source instanceof URL)) ||\n    (typeof source === \"string\" && (!source || /^[a-z][a-z0-9+.-]*:\\/\\//i.test(source))) ||\n    (source instanceof URL &&\n      (source.protocol !== \"file:\" || (source.hostname && source.hostname !== \"localhost\")))\n  )\n    throw new TypeError(`fonts.${role} must be a local path or file URL`);\n  const handle = await open(source, \"r\").catch((cause: unknown) => {\n    throw new TypeError(`Cannot read fonts.${role}`, { cause });\n  });\n  let bytes: Buffer;\n  try {\n    const stats = await handle.stat();\n    if (!stats.isFile()) throw new TypeError(`fonts.${role} must refer to a regular font file`);\n    const size = stats.size;\n    if (size < 12) throw new TypeError(`fonts.${role} must contain a valid TTF or OTF header`);\n    if (size > 32 * 1024 * 1024) throw new TypeError(`fonts.${role} must be at most 32 MiB`);\n    const bounded = Buffer.alloc(size + 1);\n    let received = 0;\n    while (received < bounded.length) {\n      const result = await handle.read(bounded, received, bounded.length - received, null);\n      if (!result.bytesRead) break;\n      received += result.bytesRead;\n    }\n    if (received !== size) throw new TypeError(`fonts.${role} changed while being read`);\n    bytes = bounded.subarray(0, received);\n  } finally {\n    await handle.close();\n  }\n  if (bytes.readUInt32BE(0) !== 0x00010000 && bytes.toString(\"ascii\", 0, 4) !== \"OTTO\")\n    throw new TypeError(`fonts.${role} must be a single TTF or OTF font`);\n  let font: Font;\n  try {\n    font = create(bytes) as Font;\n    if (\n      typeof font.layout !== \"function\" ||\n      !Number.isFinite(font.unitsPerEm) ||\n      font.unitsPerEm <= 0\n    )\n      throw new TypeError(\"Invalid font metrics\");\n  } catch (cause) {\n    throw new TypeError(`Invalid fonts.${role}`, { cause });\n  }\n  return { face: { font, custom: true, role } satisfies ImageFace, bytes };\n}\nfunction requireGlyphs(value: string, face: ImageFace) {\n  for (const character of value) {\n    const codePoint = character.codePointAt(0)!;\n    if (!face.font.hasGlyphForCodePoint(codePoint))\n      throw new Error(\n        `${face.custom ? `Share-image ${face.role}` : \"Bundled share-image\"} font lacks U+${codePoint.toString(16).toUpperCase()}; supply a font with glyph coverage or metadata.image: false`,\n      );\n  }\n}\nfunction width(text: string, face: ImageFace, size: number): number {\n  const font = face.font;\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: ImageFace,\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  requireGlyphs(bounded.join(\"\"), face);\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        requireGlyphs(line, face);\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  face?: ImageFace,\n): string {\n  if (face?.custom)\n    return value.lines\n      .map((line, index) => {\n        requireGlyphs(line, face);\n        const run = face.font.layout(line),\n          scale = value.size / face.font.unitsPerEm;\n        const total = run.positions.reduce((sum, position) => sum + position.xAdvance, 0);\n        let advance = 0;\n        const paths = run.glyphs\n          .map((glyph, position) => {\n            const offset = run.positions[position]!;\n            const data = glyph.path.toSVG();\n            const translatedX =\n              x + (advance + offset.xOffset - (anchor === \"end\" ? total : 0)) * scale;\n            advance += offset.xAdvance;\n            return data\n              ? `<path d=\"${data}\" transform=\"translate(${translatedX} ${y + index * gap - offset.yOffset * scale}) scale(${scale} ${-scale})\" fill=\"${fill}\"/>`\n              : \"\";\n          })\n          .join(\"\");\n        return paths;\n      })\n      .join(\"\");\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 or supplied local fonts; no network or system-font search. */\nexport async function renderShareImage(options: ShareImageOptions): Promise<File> {\n  const theme = options.theme ?? \"ledger\";\n  const t = themes[theme];\n  if (!t) throw new TypeError(\"Unknown share image theme\");\n  if (\n    options.fonts !== undefined &&\n    (typeof options.fonts !== \"object\" ||\n      options.fonts === null ||\n      Array.isArray(options.fonts) ||\n      Object.keys(options.fonts).some((key) => ![\"body\", \"headline\"].includes(key)))\n  )\n    throw new TypeError(\"fonts must contain only body/headline local font paths\");\n  const body =\n    options.fonts?.body === undefined ? null : await loadFace(options.fonts.body, \"body\");\n  const customHeadline =\n    options.fonts?.headline === undefined\n      ? body\n      : await loadFace(options.fonts.headline, \"headline\");\n  const regular: ImageFace = body?.face ?? {\n    font: fonts[theme === \"plain\" ? 2 : 0]!,\n    custom: false,\n    role: \"body\",\n  };\n  const headlineFace: ImageFace = customHeadline\n    ? { ...customHeadline.face, role: \"headline\" }\n    : { font: fonts[t.face]!, custom: false, role: \"headline\" };\n  const digest = createHash(\"sha256\")\n    .update(\n      JSON.stringify([\n        fontDigest,\n        body ? createHash(\"sha256\").update(body.bytes).digest(\"hex\") : null,\n        customHeadline ? createHash(\"sha256\").update(customHeadline.bytes).digest(\"hex\") : null,\n      ]),\n    )\n    .digest(\"hex\");\n  const headline = fit(options.title, headlineFace, [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, 400, \"start\", regular)}${text({ size: 30, lines: [t.name] }, 1130, 86, 0, t.fg, t.family, 400, \"end\", regular)}${theme === \"crosswave\" ? \"\" : `<path d=\"M64 126H1136\" stroke=\"${t.rule}\"/>`}${text(headline, 68, 276, 112, t.fg, t.family, t.weight, \"start\", headlineFace)}${text(description, 68, 480, 0, t.muted, t.family, 400, \"start\", regular)}${text(directory, 68, 572, 0, t.muted, t.family, 400, \"start\", regular)}</svg>`;\n  const key = createHash(\"sha256\").update(digest).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":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"share-image-api-BIAcrVlH.mjs","names":[],"sources":["../src/share-image-api.ts"],"sourcesContent":["import type { ShareImageOptions } from \"./share-image.ts\";\nexport type { ShareImageOptions, ShareImageFonts } from \"./share-image.ts\";\n/** Render a PNG at build time using the selected preset and bundled or supplied local 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/dist/share-image-api-BVDAWsM-.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dirwell/share-image",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Optional build-time metadata and PNG share-image rendering.",
   "homepage": "https://vp-tw.github.io/dirwell/metadata/",
   "bugs": {
@@ -31,7 +31,7 @@
     "tag": "latest"
   },
   "dependencies": {
-    "@dirwell/core": "0.0.1",
+    "@dirwell/core": "0.0.2",
     "@resvg/resvg-js": "2.6.2",
     "fontkit": "2.0.4"
   },

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

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

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

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

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

@@ -1,10 +0,0 @@
-//#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

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