npm - @dirwell/share-image - Versions diffs - 0.0.1-alpha.1 → 0.0.2 - Mend

@dirwell/share-image 0.0.1-alpha.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md +49 -1
package/dist/index.d.mts +7 -2
package/dist/index.mjs +2 -2
package/dist/index.mjs.map +1 -1
package/dist/{share-image-D2N_4dRw.mjs → share-image-DPfRwKbZ.mjs} +93 -15
package/dist/share-image-DPfRwKbZ.mjs.map +1 -0
package/dist/share-image-api-BIAcrVlH.mjs +10 -0
package/dist/share-image-api-BIAcrVlH.mjs.map +1 -0
package/dist/share-image-api-BVDAWsM-.mjs +2 -0
package/package.json +7 -3
package/dist/share-image-D2N_4dRw.mjs.map +0 -1
package/dist/share-image-api-BZH7001a.mjs +0 -2
package/dist/share-image-api-DcmMcWT0.mjs +0 -10
package/dist/share-image-api-DcmMcWT0.mjs.map +0 -1

package/README.md CHANGED Viewed

@@ -1,7 +1,38 @@
 # @dirwell/share-image
+Requires Node.js 22.12 or later. [Read the guide](https://vp-tw.github.io/dirwell/metadata/).
 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.
+## Save a share image
+```sh
+npm install @dirwell/share-image@0.0.2
+```
+Save this as `image.mjs`, then run `node image.mjs`:
+```js
+import { writeFile } from "node:fs/promises";
+import { createShareImage } from "@dirwell/share-image";
+const image = await createShareImage({
+  theme: "plain",
+  title: "Sample downloads",
+  description: "Release files and reports",
+});
+await writeFile("share.png", new Uint8Array(await image.arrayBuffer()));
+```
+The result is a local 1200 × 630 PNG. No explorer build or browser runtime is required.
+## Add metadata to an explorer
+```sh
+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.
 ```js
 import { generateExplorer } from "@dirwell/core";
 import { createPlainTheme } from "@dirwell/theme-plain";
@@ -18,6 +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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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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"}
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, 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} RENAMED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

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

package/package.json CHANGED Viewed

@@ -1,7 +1,11 @@
 {
   "name": "@dirwell/share-image",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.2",
   "description": "Optional build-time metadata and PNG share-image rendering.",
+  "homepage": "https://vp-tw.github.io/dirwell/metadata/",
+  "bugs": {
+    "url": "https://github.com/vp-tw/dirwell/issues"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -24,10 +28,10 @@
   "publishConfig": {
     "access": "public",
     "provenance": true,
-    "tag": "alpha"
+    "tag": "latest"
   },
   "dependencies": {
-    "@dirwell/core": "0.0.1-alpha.1",
+    "@dirwell/core": "0.0.2",
     "@resvg/resvg-js": "2.6.2",
     "fontkit": "2.0.4"
   },

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

@@ -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 DELETED Viewed

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

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

@@ -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 DELETED Viewed

@@ -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"}