@xsynaptic/astro-image-pipeline 0.0.0-stage → 0.1.0

package/LICENSE

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

package/README.md

@@ -1,3 +1,43 @@
-# Temporary Holding Version
+# @xsynaptic/astro-image-pipeline
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Image renditions for Astro sites with more images than the bundler can handle. The build records each image a page asks for, then a separate process renders them with sharp into a file cache. File names stay stable between builds. This is an early release, so expect the API to change.
+
+```sh
+pnpm add @xsynaptic/astro-image-pipeline sharp
+```
+
+## Entry points
+
+- `@xsynaptic/astro-image-pipeline`: the Astro integration. It records names during builds, writes the manifest, and renders images on request in dev.
+- `@xsynaptic/astro-image-pipeline/presets`: `defineImagePipeline`, `defineOpenGraphCards` and the name helpers. It doesn't import sharp or `node:fs`, so page code can use it.
+- `@xsynaptic/astro-image-pipeline/node`: `renderImages`, `renderOpenGraphCards`, `openImageSource` and the cache helpers. Run the render in its own process after the build.
+
+## Setup
+
+```ts
+import { defineConfig } from 'astro/config';
+import imagePipeline from '@xsynaptic/astro-image-pipeline';
+
+import { pipeline } from './src/images';
+
+export default defineConfig({
+	integrations: [
+		imagePipeline({
+			baseUrl: 'https://img.example.com',
+			cachePath: '.cache/images',
+			mediaPath: 'media',
+			pipeline,
+		}),
+	],
+});
+```
+
+The pipeline owns everything in `cachePath`, so keep other files out of it.
+
+## Rules
+
+Only names made with `getName` (or `getCardName` for OpenGraph cards) during a build get rendered.
+
+- Make image URLs while pages render, or in prerendered endpoints.
+- Don't make them in content loaders (a cached run records nothing) or in on-demand routes.
+- `renderImages` renders what the last build recorded. It refuses a manifest from another version, so rebuild first.

package/dist/image-encoding-CPYBEK0T.d.mts

@@ -0,0 +1,13 @@
+import { JpegOptions, WebpOptions } from "sharp";
+//#region src/image-encoding.d.ts
+interface ImageEncoding {
+  jpg?: JpegOptions;
+  webp?: WebpOptions;
+}
+interface ResolvedImageEncoding {
+  jpg: JpegOptions;
+  webp: WebpOptions;
+}
+//#endregion
+export { ResolvedImageEncoding as n, ImageEncoding as t };
+//# sourceMappingURL=image-encoding-CPYBEK0T.d.mts.map

package/dist/image-presets-CS7TnTsE.d.mts

@@ -0,0 +1,83 @@
+import { n as ResolvedImageEncoding, t as ImageEncoding } from "./image-encoding-CPYBEK0T.mjs";
+//#region src/image-name.d.ts
+declare const imageFormats: readonly ["jpg", "webp"];
+type ImageFormat = (typeof imageFormats)[number];
+interface ImageSize {
+  height?: number;
+  width: number;
+}
+interface ImageName extends ImageSize {
+  format: ImageFormat;
+  stem: string;
+}
+declare function isImageSource(id: string): boolean;
+declare function getImageStem(id: string): string;
+declare function findStemCollisions(ids: Iterable<string>): string[][];
+declare function parseImageName(name: string): ImageName | undefined;
+//#endregion
+//#region src/open-graph-cards.d.ts
+type OpenGraphCardValue = Array<OpenGraphCardValue> | boolean | number | OpenGraphCardObject | string;
+interface OpenGraphCardObject {
+  [key: string]: OpenGraphCardValue | undefined;
+}
+type OpenGraphCardInput = OpenGraphCardObject;
+interface OpenGraphCardImage {
+  id: string;
+  treatment?: string;
+}
+interface OpenGraphCard {
+  image?: OpenGraphCardImage;
+  input: OpenGraphCardInput;
+}
+declare function defineOpenGraphCards({ format }: {
+  format: ImageFormat;
+}): {
+  getCardName: ({ id, ...card }: OpenGraphCard & {
+    id: string;
+  }) => string;
+};
+//#endregion
+//#region src/image-presets.d.ts
+interface ImagePresetCover {
+  aspectRatio: number;
+  fit: 'cover';
+  format: ImageFormat;
+  widths: ReadonlyArray<number>;
+}
+interface ImagePresetNative {
+  fit: 'native';
+  format: ImageFormat;
+  widths: ReadonlyArray<number>;
+}
+interface ImagePresetWidth {
+  fit: 'width';
+  format: ImageFormat;
+  widths: ReadonlyArray<number>;
+}
+type ImagePreset = ImagePresetCover | ImagePresetNative | ImagePresetWidth;
+type ImagePresetTable = Record<string, ImagePreset>;
+type CoverPresetName<Table extends ImagePresetTable> = { [Name in keyof Table & string]: Table[Name] extends ImagePresetCover ? Name : never; }[keyof Table & string];
+type HeightPresetName<Table extends ImagePresetTable> = { [Name in keyof Table & string]: Table[Name] extends ImagePresetWidth ? never : Name; }[keyof Table & string];
+interface ImageDimensions {
+  height: number;
+  width: number;
+}
+interface ImageSource extends ImageDimensions {
+  id: string;
+  path?: string;
+}
+declare function defineImagePipeline<const Table extends Record<keyof Table, ImagePreset>>({ encoding, presets }: {
+  encoding?: ImageEncoding;
+  presets: Table;
+}): {
+  encoding: ResolvedImageEncoding;
+  getName: (source: ImageSource, presetName: keyof Table & string, width: number | undefined) => string;
+  getSize: {
+    (presetName: HeightPresetName<Table>, width: number, source: ImageDimensions): Required<ImageSize>;
+    (presetName: keyof Table & string, width: number, source: ImageDimensions): ImageSize;
+  };
+  getWidths: (presetName: keyof Table & string, source: ImageDimensions) => number[];
+};
+//#endregion
+export { defineImagePipeline as a, OpenGraphCardInput as c, ImageFormat as d, findStemCollisions as f, parseImageName as g, isImageSource as h, ImageSource as i, OpenGraphCardValue as l, imageFormats as m, ImageDimensions as n, OpenGraphCard as o, getImageStem as p, ImagePreset as r, OpenGraphCardImage as s, CoverPresetName as t, defineOpenGraphCards as u };
+//# sourceMappingURL=image-presets-CS7TnTsE.d.mts.map

package/dist/image-presets-ZN7_n2p8.mjs

@@ -0,0 +1,184 @@
+//#region src/image-name.ts
+const imageFormats = ["jpg", "webp"];
+const imageNameTerminators = String.raw`\s"'&<>),`;
+const imageNamePatternSource = String.raw`(?<stem>[^${imageNameTerminators}]+?)-(?<width>[1-9]\d*)(?:x(?<height>[1-9]\d*))?\.(?<format>${imageFormats.join("|")})`;
+const imageNamePattern = new RegExp(`^${imageNamePatternSource}$`);
+const imageStemPattern = new RegExp(`^[^${imageNameTerminators}]+$`);
+const unsafeSegments = /* @__PURE__ */ new Set([
+	"",
+	".",
+	".."
+]);
+const sourcePattern = /\.(?:avif|gif|jpe?g|png|webp)$/i;
+function isFormat(value) {
+	return imageFormats.includes(value);
+}
+function isSafeStem(stem) {
+	return stem.split("/").every((segment) => !unsafeSegments.has(segment));
+}
+function isImageSource(id) {
+	return sourcePattern.test(id);
+}
+function getImageStem(id) {
+	return id.replace(/\.[^./]+$/, "");
+}
+function isImageStem(stem) {
+	return imageStemPattern.test(stem) && isSafeStem(stem);
+}
+function findStemCollisions(ids) {
+	return [...Map.groupBy(ids, (id) => getImageStem(id).toLowerCase()).values()].filter((stemIds) => stemIds.length > 1).map((stemIds) => stemIds.toSorted((first, second) => first.localeCompare(second)));
+}
+function formatImageName({ format, height, stem, width }) {
+	return `${stem}-${height === void 0 ? String(width) : `${String(width)}x${String(height)}`}.${format}`;
+}
+function parseImageName(name) {
+	const { format, height, stem, width } = imageNamePattern.exec(name)?.groups ?? {};
+	if (stem === void 0 || width === void 0 || !isFormat(format) || !isSafeStem(stem)) return;
+	const parsed = {
+		format,
+		stem,
+		width: Number(width)
+	};
+	if (height !== void 0) parsed.height = Number(height);
+	return parsed;
+}
+//#endregion
+//#region src/image-encoding.ts
+const encodingDefaults = {
+	jpg: {
+		mozjpeg: true,
+		quality: 80
+	},
+	webp: {
+		effort: 6,
+		quality: 80
+	}
+};
+function resolveImageEncoding(encoding = {}) {
+	return {
+		jpg: {
+			...encodingDefaults.jpg,
+			...encoding.jpg
+		},
+		webp: {
+			...encodingDefaults.webp,
+			...encoding.webp
+		}
+	};
+}
+function serializeEncoding(options) {
+	const entries = Object.entries(options).toSorted(([first], [second]) => first.localeCompare(second));
+	return JSON.stringify(Object.fromEntries(entries));
+}
+//#endregion
+//#region src/image-recorder.ts
+const imageRecordsVariable = "XSYNAPTIC_IMAGE_RECORDS";
+let recorder;
+function openRecorder(directory) {
+	const fs = process.getBuiltinModule("node:fs");
+	const { threadId } = process.getBuiltinModule("node:worker_threads");
+	return {
+		descriptor: fs.openSync(`${directory}/${String(process.pid)}-${String(threadId)}.ndjson`, "a"),
+		directory,
+		fs,
+		lines: /* @__PURE__ */ new Set()
+	};
+}
+function writeRecord(record) {
+	if (typeof process === "undefined") return;
+	const directory = process.env[imageRecordsVariable];
+	if (!directory) return;
+	if (recorder?.directory !== directory) {
+		if (recorder) recorder.fs.closeSync(recorder.descriptor);
+		recorder = openRecorder(directory);
+	}
+	const line = JSON.stringify(record);
+	if (recorder.lines.has(line)) return;
+	recorder.lines.add(line);
+	recorder.fs.writeSync(recorder.descriptor, `${line}\n`);
+}
+function recordImageName(name, sourcePath) {
+	writeRecord({
+		name,
+		sourcePath
+	});
+}
+function recordOpenGraphCard(name, card) {
+	writeRecord({
+		card,
+		kind: "open-graph-card",
+		name
+	});
+}
+//#endregion
+//#region src/image-presets.ts
+function getPresetSize(preset, width, source) {
+	switch (preset.fit) {
+		case "cover": return {
+			height: Math.round(width / preset.aspectRatio),
+			width
+		};
+		case "native": return {
+			height: Math.round(width * source.height / source.width),
+			width
+		};
+		case "width": return { width };
+	}
+}
+function isWithinSource(size, source) {
+	return size.width <= source.width && (size.height ?? 0) <= source.height;
+}
+function capImageSize(size, source) {
+	if (isWithinSource(size, source)) return size;
+	if (size.height === void 0) return { width: source.width };
+	const width = source.width * size.height <= source.height * size.width ? source.width : Math.floor(size.width * source.height / size.height);
+	return {
+		height: Math.min(Math.round(width * size.height / size.width), source.height),
+		width
+	};
+}
+function resolvePresetSize(preset, width, source) {
+	for (const presetWidth of preset.widths) {
+		const size = capImageSize(getPresetSize(preset, presetWidth, source), source);
+		if (size.width === width) return size;
+	}
+}
+function createImagePresets(table) {
+	function getWidths(presetName, source) {
+		const preset = table[presetName];
+		return preset.widths.filter((width) => isWithinSource(getPresetSize(preset, width, source), source));
+	}
+	function getSize(presetName, width, source) {
+		return capImageSize(getPresetSize(table[presetName], width, source), source);
+	}
+	function getName(source, presetName, width) {
+		if (width === void 0) throw new Error(`Image ${source.id} needs a width for "${presetName}"`);
+		const preset = table[presetName];
+		const size = resolvePresetSize(preset, width, source);
+		if (!size) throw new Error(`Image ${source.id} (${String(source.width)}x${String(source.height)}) has no "${presetName}" rendition ${String(width)} wide`);
+		const stem = getImageStem(source.id);
+		if (!isImageStem(stem)) throw new Error(`Image ${source.id} can't be named: whitespace, quotes, &, <, >, ), commas and "." or ".." segments don't fit in an image URL; rename the file`);
+		const name = formatImageName({
+			format: preset.format,
+			stem,
+			...size
+		});
+		recordImageName(name, source.path ?? source.id);
+		return name;
+	}
+	return {
+		getName,
+		getSize,
+		getWidths
+	};
+}
+function defineImagePipeline({ encoding, presets }) {
+	return {
+		...createImagePresets(presets),
+		encoding: resolveImageEncoding(encoding)
+	};
+}
+//#endregion
+export { serializeEncoding as a, imageFormats as c, parseImageName as d, recordOpenGraphCard as i, isImageSource as l, isWithinSource as n, findStemCollisions as o, imageRecordsVariable as r, getImageStem as s, defineImagePipeline as t, isImageStem as u };
+
+//# sourceMappingURL=image-presets-ZN7_n2p8.mjs.map

package/dist/image-presets-ZN7_n2p8.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-presets-ZN7_n2p8.mjs","names":[],"sources":["../src/image-name.ts","../src/image-encoding.ts","../src/image-recorder.ts","../src/image-presets.ts"],"sourcesContent":["export const imageFormats = ['jpg', 'webp'] as const;\n\nexport type ImageFormat = (typeof imageFormats)[number];\n\nexport interface ImageSize {\n\theight?: number;\n\twidth: number;\n}\n\nexport interface ImageName extends ImageSize {\n\tformat: ImageFormat;\n\tstem: string;\n}\n\nconst imageNameTerminators = String.raw`\\s\"'&<>),`;\n\nconst imageNamePatternSource = String.raw`(?<stem>[^${imageNameTerminators}]+?)-(?<width>[1-9]\\d*)(?:x(?<height>[1-9]\\d*))?\\.(?<format>${imageFormats.join('|')})`;\n\nconst imageNamePattern = new RegExp(`^${imageNamePatternSource}$`);\n\nconst imageStemPattern = new RegExp(`^[^${imageNameTerminators}]+$`);\n\nconst unsafeSegments = new Set(['', '.', '..']);\n\nconst sourcePattern = /\\.(?:avif|gif|jpe?g|png|webp)$/i;\n\nfunction isFormat(value: string | undefined): value is ImageFormat {\n\treturn (imageFormats as ReadonlyArray<string | undefined>).includes(value);\n}\n\nfunction isSafeStem(stem: string) {\n\treturn stem.split('/').every((segment) => !unsafeSegments.has(segment));\n}\n\nexport function isImageSource(id: string) {\n\treturn sourcePattern.test(id);\n}\n\nexport function getImageStem(id: string) {\n\treturn id.replace(/\\.[^./]+$/, '');\n}\n\nexport function isImageStem(stem: string) {\n\treturn imageStemPattern.test(stem) && isSafeStem(stem);\n}\n\n// Names drop the extension, so a.jpg and a.png (or A.png on a case-insensitive disk) would collide\nexport function findStemCollisions(ids: Iterable<string>) {\n\tconst idsByStem = Map.groupBy(ids, (id) => getImageStem(id).toLowerCase());\n\n\treturn [...idsByStem.values()]\n\t\t.filter((stemIds) => stemIds.length > 1)\n\t\t.map((stemIds) => stemIds.toSorted((first, second) => first.localeCompare(second)));\n}\n\nexport function formatImageName({ format, height, stem, width }: ImageName) {\n\tconst size = height === undefined ? String(width) : `${String(width)}x${String(height)}`;\n\n\treturn `${stem}-${size}.${format}`;\n}\n\nexport function parseImageName(name: string): ImageName | undefined {\n\tconst { format, height, stem, width } = imageNamePattern.exec(name)?.groups ?? {};\n\n\tif (stem === undefined || width === undefined || !isFormat(format) || !isSafeStem(stem)) return;\n\n\tconst parsed: ImageName = { format, stem, width: Number(width) };\n\n\tif (height !== undefined) parsed.height = Number(height);\n\n\treturn parsed;\n}\n","import type { JpegOptions, WebpOptions } from 'sharp';\n\n// Part of every cache key; bump it when a render change alters the output bytes\nexport const imageRenderRevision = 3;\n\nexport interface ImageEncoding {\n\tjpg?: JpegOptions;\n\twebp?: WebpOptions;\n}\n\nexport interface ResolvedImageEncoding {\n\tjpg: JpegOptions;\n\twebp: WebpOptions;\n}\n\nconst encodingDefaults = {\n\tjpg: { mozjpeg: true, quality: 80 },\n\twebp: { effort: 6, quality: 80 },\n} as const satisfies ResolvedImageEncoding;\n\nexport function resolveImageEncoding(encoding: ImageEncoding = {}): ResolvedImageEncoding {\n\treturn {\n\t\tjpg: { ...encodingDefaults.jpg, ...encoding.jpg },\n\t\twebp: { ...encodingDefaults.webp, ...encoding.webp },\n\t};\n}\n\nexport function serializeEncoding(options: JpegOptions | WebpOptions) {\n\tconst entries = Object.entries(options).toSorted(([first], [second]) =>\n\t\tfirst.localeCompare(second),\n\t);\n\n\treturn JSON.stringify(Object.fromEntries(entries));\n}\n","import type * as NodeFs from 'node:fs';\n\nimport type { OpenGraphCard } from './open-graph-cards.js';\n\nexport const imageRecordsVariable = 'XSYNAPTIC_IMAGE_RECORDS';\n\ninterface ImageRecorder {\n\tdescriptor: number;\n\tdirectory: string;\n\tfs: typeof NodeFs;\n\tlines: Set<string>;\n}\n\nlet recorder: ImageRecorder | undefined;\n\n// node:fs is looked up lazily so the presets entry still loads where it doesn't exist\nfunction openRecorder(directory: string): ImageRecorder {\n\tconst fs = process.getBuiltinModule('node:fs');\n\tconst { threadId } = process.getBuiltinModule('node:worker_threads');\n\tconst descriptor = fs.openSync(\n\t\t`${directory}/${String(process.pid)}-${String(threadId)}.ndjson`,\n\t\t'a',\n\t);\n\n\treturn { descriptor, directory, fs, lines: new Set() };\n}\n\nfunction writeRecord(record: object) {\n\tif (typeof process === 'undefined') return;\n\n\tconst directory = process.env[imageRecordsVariable];\n\n\tif (!directory) return;\n\n\tif (recorder?.directory !== directory) {\n\t\tif (recorder) recorder.fs.closeSync(recorder.descriptor);\n\n\t\trecorder = openRecorder(directory);\n\t}\n\n\tconst line = JSON.stringify(record);\n\n\tif (recorder.lines.has(line)) return;\n\n\trecorder.lines.add(line);\n\trecorder.fs.writeSync(recorder.descriptor, `${line}\\n`);\n}\n\nexport function recordImageName(name: string, sourcePath: string) {\n\twriteRecord({ name, sourcePath });\n}\n\nexport function recordOpenGraphCard(name: string, card: OpenGraphCard) {\n\twriteRecord({ card, kind: 'open-graph-card', name });\n}\n","import type { ImageEncoding } from './image-encoding.js';\nimport type { ImageFormat, ImageSize } from './image-name.js';\n\nimport { resolveImageEncoding } from './image-encoding.js';\nimport { formatImageName, getImageStem, isImageStem } from './image-name.js';\nimport { recordImageName } from './image-recorder.js';\n\ninterface ImagePresetCover {\n\taspectRatio: number;\n\tfit: 'cover';\n\tformat: ImageFormat;\n\twidths: ReadonlyArray<number>;\n}\n\ninterface ImagePresetNative {\n\tfit: 'native';\n\tformat: ImageFormat;\n\twidths: ReadonlyArray<number>;\n}\n\ninterface ImagePresetWidth {\n\tfit: 'width';\n\tformat: ImageFormat;\n\twidths: ReadonlyArray<number>;\n}\n\nexport type ImagePreset = ImagePresetCover | ImagePresetNative | ImagePresetWidth;\n\ntype ImagePresetTable = Record<string, ImagePreset>;\n\nexport type CoverPresetName<Table extends ImagePresetTable> = {\n\t[Name in keyof Table & string]: Table[Name] extends ImagePresetCover ? Name : never;\n}[keyof Table & string];\n\ntype HeightPresetName<Table extends ImagePresetTable> = {\n\t[Name in keyof Table & string]: Table[Name] extends ImagePresetWidth ? never : Name;\n}[keyof Table & string];\n\nexport interface ImageDimensions {\n\theight: number;\n\twidth: number;\n}\n\nexport interface ImageSource extends ImageDimensions {\n\tid: string;\n\tpath?: string;\n}\n\nfunction getPresetSize(preset: ImagePreset, width: number, source: ImageDimensions): ImageSize {\n\tswitch (preset.fit) {\n\t\tcase 'cover': {\n\t\t\treturn { height: Math.round(width / preset.aspectRatio), width };\n\t\t}\n\t\tcase 'native': {\n\t\t\treturn { height: Math.round((width * source.height) / source.width), width };\n\t\t}\n\t\tcase 'width': {\n\t\t\treturn { width };\n\t\t}\n\t}\n}\n\nexport function isWithinSource(size: ImageSize, source: ImageDimensions) {\n\treturn size.width <= source.width && (size.height ?? 0) <= source.height;\n}\n\nfunction capImageSize(size: ImageSize, source: ImageDimensions): ImageSize {\n\tif (isWithinSource(size, source)) return size;\n\n\tif (size.height === undefined) return { width: source.width };\n\n\tconst width =\n\t\tsource.width * size.height <= source.height * size.width\n\t\t\t? source.width\n\t\t\t: Math.floor((size.width * source.height) / size.height);\n\n\treturn {\n\t\theight: Math.min(Math.round((width * size.height) / size.width), source.height),\n\t\twidth,\n\t};\n}\n\n// A width outside the preset is fine when one of the preset's widths shrinks to it on this source\nfunction resolvePresetSize(preset: ImagePreset, width: number, source: ImageDimensions) {\n\tfor (const presetWidth of preset.widths) {\n\t\tconst size = capImageSize(getPresetSize(preset, presetWidth, source), source);\n\n\t\tif (size.width === width) return size;\n\t}\n\n\treturn;\n}\n\nexport function createImagePresets<const Table extends Record<keyof Table, ImagePreset>>(\n\ttable: Table,\n) {\n\ttype PresetName = keyof Table & string;\n\n\tfunction getWidths(presetName: PresetName, source: ImageDimensions) {\n\t\tconst preset: ImagePreset = table[presetName];\n\n\t\treturn preset.widths.filter((width) =>\n\t\t\tisWithinSource(getPresetSize(preset, width, source), source),\n\t\t);\n\t}\n\n\tfunction getSize(\n\t\tpresetName: HeightPresetName<Table>,\n\t\twidth: number,\n\t\tsource: ImageDimensions,\n\t): Required<ImageSize>;\n\tfunction getSize(presetName: PresetName, width: number, source: ImageDimensions): ImageSize;\n\tfunction getSize(presetName: PresetName, width: number, source: ImageDimensions) {\n\t\treturn capImageSize(getPresetSize(table[presetName], width, source), source);\n\t}\n\n\tfunction getName(source: ImageSource, presetName: PresetName, width: number | undefined) {\n\t\tif (width === undefined)\n\t\t\tthrow new Error(`Image ${source.id} needs a width for \"${presetName}\"`);\n\n\t\tconst preset: ImagePreset = table[presetName];\n\t\tconst size = resolvePresetSize(preset, width, source);\n\n\t\tif (!size) {\n\t\t\tthrow new Error(\n\t\t\t\t`Image ${source.id} (${String(source.width)}x${String(source.height)}) has no \"${presetName}\" rendition ${String(width)} wide`,\n\t\t\t);\n\t\t}\n\n\t\tconst stem = getImageStem(source.id);\n\n\t\tif (!isImageStem(stem)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Image ${source.id} can't be named: whitespace, quotes, &, <, >, ), commas and \".\" or \"..\" segments don't fit in an image URL; rename the file`,\n\t\t\t);\n\t\t}\n\n\t\tconst name = formatImageName({ format: preset.format, stem, ...size });\n\n\t\trecordImageName(name, source.path ?? source.id);\n\n\t\treturn name;\n\t}\n\n\treturn { getName, getSize, getWidths };\n}\n\nexport function defineImagePipeline<const Table extends Record<keyof Table, ImagePreset>>({\n\tencoding,\n\tpresets,\n}: {\n\tencoding?: ImageEncoding;\n\tpresets: Table;\n}) {\n\treturn { ...createImagePresets(presets), encoding: resolveImageEncoding(encoding) };\n}\n"],"mappings":"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"}

package/dist/image-state-Bdi_-yWQ.mjs

@@ -0,0 +1,110 @@
+import { createHash } from "node:crypto";
+import { promises } from "node:fs";
+import path from "node:path";
+import sharp from "sharp";
+//#region src/image-render.ts
+const engineVersions = sharp.versions;
+const engineId = createHash("sha256").update(JSON.stringify({
+	...engineVersions,
+	arch: process.arch,
+	platform: process.platform
+})).digest("hex").slice(0, 8);
+function openImageSource(input, options) {
+	return sharp(input, {
+		...options,
+		autoOrient: true
+	});
+}
+async function renderImage(source, { encoding, format, height, limitInputPixels, width }) {
+	const stage = openImageSource(source, { limitInputPixels }).resize(height === void 0 ? {
+		fastShrinkOnLoad: false,
+		width,
+		withoutEnlargement: true
+	} : {
+		fastShrinkOnLoad: false,
+		fit: "cover",
+		height,
+		width
+	});
+	if (format === "jpg") return stage.flatten({ background: "#ffffff" }).jpeg(encoding.jpg).toBuffer({ resolveWithObject: true });
+	return stage.webp(encoding.webp).toBuffer({ resolveWithObject: true });
+}
+async function readSourceSize(sourcePath) {
+	const { autoOrient } = await openImageSource(sourcePath).metadata();
+	return {
+		height: autoOrient.height,
+		width: autoOrient.width
+	};
+}
+//#endregion
+//#region src/format.ts
+function formatList(items) {
+	return items.slice(0, 10).map((item) => `  ${item}`).join("\n");
+}
+//#endregion
+//#region src/files.ts
+async function readFileIfExists(filePath) {
+	try {
+		return await promises.readFile(filePath);
+	} catch (error) {
+		if (error.code === "ENOENT") return;
+		throw error;
+	}
+}
+async function readJsonFile(filePath) {
+	const data = await readFileIfExists(filePath);
+	return data ? JSON.parse(data.toString("utf8")) : void 0;
+}
+async function writeJsonFile(filePath, value) {
+	const temporary = `${filePath}.tmp`;
+	await promises.mkdir(path.dirname(filePath), { recursive: true });
+	await promises.writeFile(temporary, `${JSON.stringify(value)}\n`);
+	await promises.rename(temporary, filePath);
+}
+//#endregion
+//#region src/user-error.ts
+var UserError = class extends Error {
+	name = "UserError";
+};
+//#endregion
+//#region src/image-state.ts
+const imageManifestFile = "manifest.json";
+const imageBuildIdFile = "image-build-id.txt";
+function getImageCachePaths(cachePath) {
+	return {
+		devPath: path.join(cachePath, "dev"),
+		openGraphCardsPath: path.join(cachePath, "cards"),
+		recordsPath: path.join(cachePath, "records"),
+		renditionsPath: path.join(cachePath, "renditions")
+	};
+}
+function isCurrentManifest(manifest) {
+	return manifest.version === 4;
+}
+async function readManifest(cachePath) {
+	const manifestPath = path.join(cachePath, imageManifestFile);
+	const manifest = await readJsonFile(manifestPath);
+	if (!manifest) return;
+	if (!isCurrentManifest(manifest)) throw new UserError(`The image manifest ${manifestPath} is version ${String(manifest.version ?? 1)}, not ${String(4)}; rebuild first`);
+	return manifest;
+}
+async function readCurrentManifest(cachePath) {
+	const manifest = await readManifest(cachePath);
+	if (!manifest) throw new UserError(`No image manifest in ${cachePath}; build first`);
+	const distBuildId = await readBuildId(manifest.distPath);
+	if (distBuildId !== manifest.buildId) throw new UserError(`Manifest build ${manifest.buildId} does not match ${manifest.distPath} (${distBuildId ?? "no build id"}); rebuild first`);
+	return manifest;
+}
+async function writeManifest(cachePath, manifest) {
+	await writeJsonFile(path.join(cachePath, imageManifestFile), manifest);
+}
+async function readBuildId(outputPath) {
+	return (await readFileIfExists(path.join(outputPath, imageBuildIdFile)))?.toString("utf8").trim();
+}
+async function writeBuildId(outputPath, buildId) {
+	await promises.writeFile(path.join(outputPath, imageBuildIdFile), buildId);
+}
+//#endregion
+export { writeManifest as a, readJsonFile as c, engineId as d, engineVersions as f, renderImage as h, writeBuildId as i, writeJsonFile as l, readSourceSize as m, readCurrentManifest as n, UserError as o, openImageSource as p, readManifest as r, readFileIfExists as s, getImageCachePaths as t, formatList as u };
+
+//# sourceMappingURL=image-state-Bdi_-yWQ.mjs.map

package/dist/image-state-Bdi_-yWQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-state-Bdi_-yWQ.mjs","names":["fs","fs"],"sources":["../src/image-render.ts","../src/format.ts","../src/files.ts","../src/user-error.ts","../src/image-state.ts"],"sourcesContent":["import type { SharpInput, SharpOptions } from 'sharp';\n\nimport { createHash } from 'node:crypto';\nimport sharp from 'sharp';\n\nimport type { ResolvedImageEncoding } from './image-encoding.js';\nimport type { ImageFormat } from './image-name.js';\nimport type { ImageDimensions } from './image-presets.js';\n\nexport const engineVersions = sharp.versions;\n\n// mozjpeg output differs slightly between CPU architectures\nexport const engineId = createHash('sha256')\n\t.update(JSON.stringify({ ...engineVersions, arch: process.arch, platform: process.platform }))\n\t.digest('hex')\n\t.slice(0, 8);\n\nexport function openImageSource(input: SharpInput, options?: Omit<SharpOptions, 'autoOrient'>) {\n\treturn sharp(input, { ...options, autoOrient: true });\n}\n\ninterface ImageRender {\n\tencoding: ResolvedImageEncoding;\n\tformat: ImageFormat;\n\theight?: number | undefined;\n\tlimitInputPixels: number;\n\twidth: number;\n}\n\nexport async function renderImage(\n\tsource: string,\n\t{ encoding, format, height, limitInputPixels, width }: ImageRender,\n) {\n\tconst stage = openImageSource(source, { limitInputPixels }).resize(\n\t\theight === undefined\n\t\t\t? { fastShrinkOnLoad: false, width, withoutEnlargement: true }\n\t\t\t: { fastShrinkOnLoad: false, fit: 'cover', height, width },\n\t);\n\n\t// A no-op on opaque sources, so the background stays out of the cache key\n\tif (format === 'jpg') {\n\t\treturn stage\n\t\t\t.flatten({ background: '#ffffff' })\n\t\t\t.jpeg(encoding.jpg)\n\t\t\t.toBuffer({ resolveWithObject: true });\n\t}\n\n\treturn stage.webp(encoding.webp).toBuffer({ resolveWithObject: true });\n}\n\nexport async function readSourceSize(sourcePath: string) {\n\tconst { autoOrient } = await openImageSource(sourcePath).metadata();\n\n\treturn { height: autoOrient.height, width: autoOrient.width } satisfies ImageDimensions;\n}\n","export function formatList(items: ReadonlyArray<string>) {\n\treturn items\n\t\t.slice(0, 10)\n\t\t.map((item) => `  ${item}`)\n\t\t.join('\\n');\n}\n","import { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nexport async function readFileIfExists(filePath: string) {\n\ttry {\n\t\treturn await fs.readFile(filePath);\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === 'ENOENT') return;\n\n\t\tthrow error;\n\t}\n}\n\nexport async function readJsonFile<Value>(filePath: string) {\n\tconst data = await readFileIfExists(filePath);\n\n\treturn data ? (JSON.parse(data.toString('utf8')) as Value) : undefined;\n}\n\nexport async function writeJsonFile(filePath: string, value: unknown) {\n\tconst temporary = `${filePath}.tmp`;\n\n\tawait fs.mkdir(path.dirname(filePath), { recursive: true });\n\tawait fs.writeFile(temporary, `${JSON.stringify(value)}\\n`);\n\tawait fs.rename(temporary, filePath);\n}\n","export class UserError extends Error {\n\toverride name = 'UserError';\n}\n","import { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport type { ResolvedImageEncoding } from './image-encoding.js';\nimport type { OpenGraphCard } from './open-graph-cards.js';\n\nimport { readFileIfExists, readJsonFile, writeJsonFile } from './files.js';\nimport { UserError } from './user-error.js';\n\nconst imageManifestFile = 'manifest.json';\nconst imageBuildIdFile = 'image-build-id.txt';\n\nexport const imageManifestVersion = 4;\n\nexport interface ImageManifest {\n\tbuildId: string;\n\tdistPath: string;\n\tencoding: ResolvedImageEncoding;\n\tlimitInputPixels: number;\n\tmediaPath: string;\n\topenGraphCards: Record<string, OpenGraphCard>;\n\trenditions: Record<string, string>;\n\tversion: typeof imageManifestVersion;\n}\n\nexport function getImageCachePaths(cachePath: string) {\n\treturn {\n\t\tdevPath: path.join(cachePath, 'dev'),\n\t\topenGraphCardsPath: path.join(cachePath, 'cards'),\n\t\trecordsPath: path.join(cachePath, 'records'),\n\t\trenditionsPath: path.join(cachePath, 'renditions'),\n\t};\n}\n\nfunction isCurrentManifest(manifest: { version?: number }): manifest is ImageManifest {\n\treturn manifest.version === imageManifestVersion;\n}\n\nexport async function readManifest(cachePath: string) {\n\tconst manifestPath = path.join(cachePath, imageManifestFile);\n\tconst manifest = await readJsonFile<{ version?: number }>(manifestPath);\n\n\tif (!manifest) return;\n\n\tif (!isCurrentManifest(manifest)) {\n\t\tthrow new UserError(\n\t\t\t`The image manifest ${manifestPath} is version ${String(manifest.version ?? 1)}, not ${String(imageManifestVersion)}; rebuild first`,\n\t\t);\n\t}\n\n\treturn manifest;\n}\n\nexport async function readCurrentManifest(cachePath: string) {\n\tconst manifest = await readManifest(cachePath);\n\n\tif (!manifest) throw new UserError(`No image manifest in ${cachePath}; build first`);\n\n\tconst distBuildId = await readBuildId(manifest.distPath);\n\n\tif (distBuildId !== manifest.buildId) {\n\t\tthrow new UserError(\n\t\t\t`Manifest build ${manifest.buildId} does not match ${manifest.distPath} (${distBuildId ?? 'no build id'}); rebuild first`,\n\t\t);\n\t}\n\n\treturn manifest;\n}\n\nexport async function writeManifest(cachePath: string, manifest: ImageManifest) {\n\tawait writeJsonFile(path.join(cachePath, imageManifestFile), manifest);\n}\n\nasync function readBuildId(outputPath: string) {\n\tconst data = await readFileIfExists(path.join(outputPath, imageBuildIdFile));\n\n\treturn data?.toString('utf8').trim();\n}\n\nexport async function writeBuildId(outputPath: string, buildId: string) {\n\tawait fs.writeFile(path.join(outputPath, imageBuildIdFile), buildId);\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,22 @@
+import { n as ResolvedImageEncoding } from "./image-encoding-CPYBEK0T.mjs";
+import { AstroIntegration } from "astro";
+//#region src/image-sources.d.ts
+interface ImageSourceResolver {
+  resolve(stem: string): Promise<string | undefined>;
+}
+//#endregion
+//#region src/astro-integration.d.ts
+export interface ImagePipelineOptions {
+  baseUrl: string;
+  cachePath: string;
+  limitInputPixels?: number;
+  mediaPath: string;
+  pipeline: {
+    encoding: ResolvedImageEncoding;
+  };
+  sources?: ImageSourceResolver;
+}
+export default function imagePipeline({ baseUrl, cachePath, limitInputPixels, mediaPath, pipeline, sources }: ImagePipelineOptions): AstroIntegration;
+//#endregion
+export type { ImageSourceResolver };
+//# sourceMappingURL=index.d.mts.map