@stacksjs/image 0.70.257 → 0.70.259

package/dist/app-icons.js

@@ -1,13 +1 @@
-import process from "node:process";
-import { generateAppIcons, generateFavicons } from "ts-images";
-import { projectFile, requireProjectFile } from "./theme";
-export async function generateAppIconSet(images, root = process.cwd()) {
-  const appIcons = images.appIcons;
-  if (appIcons?.enabled !== !0 || !appIcons.source)
-    return { icons: [], favicons: [] };
-  const source = requireProjectFile(appIcons.source, root, "App icon source"), platforms = appIcons.platforms?.length ? appIcons.platforms : ["ios", "macos"], icons = await generateAppIcons(source, {
-    outputDir: projectFile(appIcons.outputDir ?? "resources/app-icons", root),
-    platform: platforms.length === 1 ? platforms[0] : "all"
-  }), favicons = appIcons.favicon ? await generateFavicons(source, projectFile(appIcons.faviconDir ?? "public", root)) : [];
-  return { icons, favicons };
-}
+import process from"node:process";import{generateAppIcons,generateFavicons}from"ts-images";import{projectFile,requireProjectFile}from"./theme";export async function generateAppIconSet(images,root=process.cwd()){const appIcons=images.appIcons;if(appIcons?.enabled!==!0||!appIcons.source)return{icons:[],favicons:[]};const source=requireProjectFile(appIcons.source,root,"App icon source"),platforms=appIcons.platforms?.length?appIcons.platforms:["ios","macos"],icons=await generateAppIcons(source,{outputDir:projectFile(appIcons.outputDir??"resources/app-icons",root),platform:platforms.length===1?platforms[0]:"all"}),favicons=appIcons.favicon?await generateFavicons(source,projectFile(appIcons.faviconDir??"public",root)):[];return{icons,favicons}}

package/dist/app-store.js

@@ -1,45 +1 @@
-import { mkdir } from "node:fs/promises";
-import process from "node:process";
-import { APP_STORE_MAX_SCREENSHOTS, generateAppStoreScreenshots } from "ts-images";
-import { loadFonts } from "./fonts";
-import { background, color, device, markPainter, projectFile, requireProjectFile, themed } from "./theme";
-export async function generateAppStoreScreenshotSet(images, root = process.cwd()) {
-  if (images.appStore?.enabled !== !0 || !images.appStore.slides?.length)
-    return {};
-  const appStore = themed(images, images.appStore), declared = images.appStore.slides, displays = appStore.displays?.length ? appStore.displays : ["APP_IPHONE_67"], fonts = await loadFonts(images.fonts, root), outputDir = projectFile(appStore.outputDir ?? "resources/app-store/screenshots", root);
-  await mkdir(outputDir, { recursive: !0 });
-  const shared = {
-    outputDir,
-    titleFont: fonts.title,
-    bodyFont: fonts.body,
-    brand: appStore.brand,
-    drawMark: await markPainter(appStore.mark, root),
-    markPlate: appStore.markPlate === !1 ? void 0 : color(appStore.markPlate),
-    background: background(appStore.background, root),
-    color: color(appStore.color),
-    mutedColor: color(appStore.mutedColor),
-    device: device(appStore.device),
-    layout: appStore.layout,
-    format: appStore.format ?? "png",
-    quality: appStore.quality
-  }, results = {};
-  for (const display of displays) {
-    const slides = declared.filter((slide) => !slide.displays?.length || slide.displays.includes(display)).map((slide) => ({
-      capture: requireProjectFile(slide.capture, root, `Capture for the "${slide.headline}" slide`),
-      headline: slide.headline,
-      subheadline: slide.subheadline,
-      background: background(slide.background, root)
-    }));
-    if (!slides.length)
-      continue;
-    if (slides.length > APP_STORE_MAX_SCREENSHOTS)
-      throw Error(`[image] ${display} has ${slides.length} slides; App Store Connect accepts at most ${APP_STORE_MAX_SCREENSHOTS}`);
-    const rendered = await generateAppStoreScreenshots({
-      ...shared,
-      slides,
-      displayTypes: [display]
-    });
-    results[display] = rendered[display] ?? [];
-  }
-  return results;
-}
+import{mkdir}from"node:fs/promises";import process from"node:process";import{APP_STORE_MAX_SCREENSHOTS,generateAppStoreScreenshots}from"ts-images";import{loadFonts}from"./fonts";import{background,color,device,markPainter,projectFile,requireProjectFile,themed}from"./theme";export async function generateAppStoreScreenshotSet(images,root=process.cwd()){if(images.appStore?.enabled!==!0||!images.appStore.slides?.length)return{};const appStore=themed(images,images.appStore),declared=images.appStore.slides,displays=appStore.displays?.length?appStore.displays:["APP_IPHONE_67"],fonts=await loadFonts(images.fonts,root),outputDir=projectFile(appStore.outputDir??"resources/app-store/screenshots",root);await mkdir(outputDir,{recursive:!0});const shared={outputDir,titleFont:fonts.title,bodyFont:fonts.body,brand:appStore.brand,drawMark:await markPainter(appStore.mark,root),markPlate:appStore.markPlate===!1?void 0:color(appStore.markPlate),background:background(appStore.background,root),color:color(appStore.color),mutedColor:color(appStore.mutedColor),device:device(appStore.device),layout:appStore.layout,format:appStore.format??"png",quality:appStore.quality},results={};for(const display of displays){const slides=declared.filter((slide)=>!slide.displays?.length||slide.displays.includes(display)).map((slide)=>({capture:requireProjectFile(slide.capture,root,`Capture for the "${slide.headline}" slide`),headline:slide.headline,subheadline:slide.subheadline,background:background(slide.background,root)}));if(!slides.length)continue;if(slides.length>APP_STORE_MAX_SCREENSHOTS)throw Error(`[image] ${display} has ${slides.length} slides; App Store Connect accepts at most ${APP_STORE_MAX_SCREENSHOTS}`);const rendered=await generateAppStoreScreenshots({...shared,slides,displayTypes:[display]});results[display]=rendered[display]??[]}return results}

package/dist/fonts.js

@@ -1,25 +1,3 @@
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { isAbsolute, resolve } from "node:path";
-import process from "node:process";
-import { loadFont } from "ts-images";
-export function resolveFontPath(value, root = process.cwd()) {
-  if (isAbsolute(value))
-    return value;
-  const local = resolve(root, value);
-  if (existsSync(local))
-    return local;
-  try {
-    return Bun.resolveSync(value, root);
-  } catch {
-    throw Error(`[image] Font not found: ${value}
+import{existsSync}from"node:fs";import{readFile}from"node:fs/promises";import{isAbsolute,resolve}from"node:path";import process from"node:process";import{loadFont}from"ts-images";export function resolveFontPath(value,root=process.cwd()){if(isAbsolute(value))return value;const local=resolve(root,value);if(existsSync(local))return local;try{return Bun.resolveSync(value,root)}catch{throw Error(`[image] Font not found: ${value}
 Looked for ${local} and for a module resolvable from ${root}.
-Set \`images.fonts.title\` in config/images.ts to a TrueType (.ttf) file. OpenType/CFF (.otf) and WOFF2 are not TrueType outlines and cannot be read.`);
-  }
-}
-export async function loadFonts(fonts, root = process.cwd()) {
-  if (!fonts?.title)
-    throw Error("[image] No font configured. Set `images.fonts.title` in config/images.ts to a TrueType (.ttf) file \u2014 " + "generated cards and screenshots draw real glyphs and cannot fall back to a system face.");
-  const title = loadFont(new Uint8Array(await readFile(resolveFontPath(fonts.title, root)))), body = fonts.body ? loadFont(new Uint8Array(await readFile(resolveFontPath(fonts.body, root)))) : title;
-  return { title, body };
-}
+Set \`images.fonts.title\` in config/images.ts to a TrueType (.ttf) file. OpenType/CFF (.otf) and WOFF2 are not TrueType outlines and cannot be read.`)}}export async function loadFonts(fonts,root=process.cwd()){if(!fonts?.title)throw Error("[image] No font configured. Set `images.fonts.title` in config/images.ts to a TrueType (.ttf) file \u2014 "+"generated cards and screenshots draw real glyphs and cannot fall back to a system face.");const title=loadFont(new Uint8Array(await readFile(resolveFontPath(fonts.title,root)))),body=fonts.body?loadFont(new Uint8Array(await readFile(resolveFontPath(fonts.body,root)))):title;return{title,body}}

package/dist/generate.js

@@ -1,19 +1 @@
-import process from "node:process";
-import { generateAppIconSet } from "./app-icons";
-import { generateAppStoreScreenshotSet } from "./app-store";
-import { generateSocialCardSet } from "./social";
-export async function generateImages(images, options = {}) {
-  const root = options.root ?? process.cwd(), wanted = (target) => !options.only?.length || options.only.includes(target);
-  return {
-    social: wanted("social") ? await generateSocialCardSet(images, root) : [],
-    appStore: wanted("app-store") ? await generateAppStoreScreenshotSet(images, root) : {},
-    appIcons: wanted("app-icons") ? await generateAppIconSet(images, root) : { icons: [], favicons: [] }
-  };
-}
-export function countGeneratedImages(result) {
-  return {
-    social: result.social.reduce((total, card) => total + Object.keys(card.files).length, 0),
-    appStore: Object.values(result.appStore).reduce((total, paths) => total + (paths?.length ?? 0), 0),
-    appIcons: result.appIcons.icons.reduce((total, set) => total + set.sizes.length, 0) + result.appIcons.favicons.length
-  };
-}
+import process from"node:process";import{generateAppIconSet}from"./app-icons";import{generateAppStoreScreenshotSet}from"./app-store";import{generateSocialCardSet}from"./social";export async function generateImages(images,options={}){const root=options.root??process.cwd(),wanted=(target)=>!options.only?.length||options.only.includes(target);return{social:wanted("social")?await generateSocialCardSet(images,root):[],appStore:wanted("app-store")?await generateAppStoreScreenshotSet(images,root):{},appIcons:wanted("app-icons")?await generateAppIconSet(images,root):{icons:[],favicons:[]}}}export function countGeneratedImages(result){return{social:result.social.reduce((total,card)=>total+Object.keys(card.files).length,0),appStore:Object.values(result.appStore).reduce((total,paths)=>total+(paths?.length??0),0),appIcons:result.appIcons.icons.reduce((total,set)=>total+set.sizes.length,0)+result.appIcons.favicons.length}}

package/dist/index.js

@@ -1,172 +1,2 @@
-import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
-import { mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";
-import { basename, extname, isAbsolute, relative, resolve } from "node:path";
-import { decode, encode, imageToSplatHash, resize } from "ts-images";
-
-export * from "./app-icons";
-export * from "./app-store";
-export * from "./fonts";
-export * from "./generate";
-export * from "./social";
-export * from "./theme";
-const mime = { avif: "image/avif", webp: "image/webp", jpeg: "image/jpeg", png: "image/png" };
-function integer(name, value, min, max) {
-  if (!Number.isInteger(value) || value < min || value > max)
-    throw TypeError(`${name} must be between ${min} and ${max}`);
-}
-export function resolveImageSource(source, root = process.cwd()) {
-  const allowed = resolve(root), candidate = isAbsolute(source) ? resolve(source) : resolve(allowed, source), relation = relative(allowed, candidate);
-  if (source.includes("\x00") || relation === ".." || relation.startsWith("../") || isAbsolute(relation))
-    throw Error("Image source must stay inside the configured root");
-  return candidate;
-}
-
-export class ImageBuilder {
-  source;
-  targetWidths = [480, 768, 1280, 1920];
-  targetFormats = ["avif", "webp", "jpeg"];
-  targetFit = "inside";
-  targetHeight;
-  targetAspectRatio;
-  targetPosition = "center";
-  includeOriginal = !0;
-  targetStorage;
-  targetQuality = 82;
-  options;
-  constructor(source, options = {}) {
-    this.source = source;
-    this.options = { ...options, root: options.root ?? process.cwd(), outputDir: options.outputDir ?? resolve("public/media/images"), publicPath: options.publicPath ?? "/media/images", concurrency: options.concurrency ?? 4, upscale: options.upscale ?? !1 };
-  }
-  widths(widths) {
-    if (!widths.length)
-      throw TypeError("Image widths are required");
-    widths.forEach((value) => integer("Image width", value, 1, 16384));
-    this.targetWidths = [...new Set(widths)].sort((a, b) => a - b);
-    return this;
-  }
-  formats(formats) {
-    if (!formats.length)
-      throw TypeError("Image formats are required");
-    this.targetFormats = [...new Set(formats)];
-    return this;
-  }
-  fit(fit) {
-    this.targetFit = fit;
-    return this;
-  }
-  height(value) {
-    integer("Image height", value, 1, 16384);
-    this.targetHeight = value;
-    this.targetAspectRatio = void 0;
-    return this;
-  }
-  aspectRatio(value) {
-    if (!Number.isFinite(value) || value <= 0 || value > 100)
-      throw TypeError("Image aspect ratio must be between 0 and 100");
-    this.targetAspectRatio = value;
-    this.targetHeight = void 0;
-    return this;
-  }
-  position(value) {
-    this.targetPosition = value;
-    return this;
-  }
-  preset(value) {
-    const preset = { avatar: { widths: [64, 128, 256, 512], ratio: 1, fit: "cover", original: !1 }, content: { widths: [320, 640, 960, 1280, 1920], fit: "inside", original: !0 }, hero: { widths: [640, 1280, 1920, 2560], ratio: 1.7777777777777777, fit: "cover", original: !0 }, thumbnail: { widths: [160, 320, 640], ratio: 1.7777777777777777, fit: "cover", original: !1 } }[value];
-    this.targetWidths = [...preset.widths];
-    this.targetFit = preset.fit;
-    this.targetAspectRatio = "ratio" in preset ? preset.ratio : void 0;
-    this.targetHeight = void 0;
-    this.includeOriginal = preset.original;
-    return this;
-  }
-  quality(value) {
-    integer("Image quality", value, 1, 100);
-    this.targetQuality = value;
-    return this;
-  }
-  output(dir, publicPath = "/media/images") {
-    this.options.outputDir = resolve(dir);
-    this.options.publicPath = `/${publicPath.replace(/^\/+|\/+$/g, "")}`;
-    return this;
-  }
-  storage(adapter, prefix = "media/images") {
-    this.targetStorage = { adapter, prefix: prefix.replace(/^\/+|\/+$/g, "") };
-    return this;
-  }
-  async generate() {
-    integer("Image concurrency", this.options.concurrency, 1, 32);
-    const sourcePath = resolveImageSource(this.source, this.options.root);
-    if (this.options.authorize && !await this.options.authorize(sourcePath, this.options.authorizationContext))
-      throw Error("Image delivery is not authorized");
-    const bytes = new Uint8Array(await readFile(sourcePath)), hash = createHash("sha256").update(bytes).digest("hex"), decoded = await decode(bytes), widths = this.targetWidths.filter((width) => this.options.upscale || width <= decoded.width);
-    if (this.includeOriginal && !widths.includes(decoded.width))
-      widths.push(decoded.width);
-    const tasks = [...new Set(widths)].sort((a, b) => a - b).flatMap((width) => this.targetFormats.map((format) => ({ width, format }))), variants = [];
-    let cursor = 0;
-    await Promise.all(Array.from({ length: Math.min(tasks.length, this.options.concurrency) }, async () => {
-      while (cursor < tasks.length) {
-        const task = tasks[cursor++];
-        variants.push(await this.variant(decoded, hash, sourcePath, task.width, task.format));
-      }
-    }));
-    variants.sort((a, b) => a.width - b.width || this.targetFormats.indexOf(a.format) - this.targetFormats.indexOf(b.format));
-    return { source: { width: decoded.width, height: decoded.height, hash }, variants, placeholder: Buffer.from(imageToSplatHash(decoded)).toString("base64url") };
-  }
-  async variant(source, hash, sourcePath, width, format) {
-    const height = this.targetHeight ?? (this.targetAspectRatio ? Math.max(1, Math.round(width / this.targetAspectRatio)) : void 0), output = width === source.width && height === void 0 ? source : resize(source, { width, height, fit: this.targetFit, position: this.targetPosition });
-    if (!this.options.upscale && (output.width > source.width || output.height > source.height))
-      throw TypeError(`Image variant ${output.width}x${output.height} would upscale the source`);
-    const cacheKey = createHash("sha256").update(`${hash}:${width}:${height ?? "auto"}:${format}:${this.targetFit}:${this.targetPosition}:${this.targetQuality}`).digest("hex"), filename = `${basename(sourcePath, extname(sourcePath)).replace(/[^a-zA-Z0-9_-]/g, "-") || "image"}-${output.width}x${output.height}-${cacheKey.slice(0, 16)}.${format === "jpeg" ? "jpg" : format}`, path = resolve(this.options.outputDir, filename);
-    if (this.targetStorage) {
-      const key = this.targetStorage.prefix ? `${this.targetStorage.prefix}/${filename}` : filename;
-      if (await this.targetStorage.adapter.fileExists(key)) {
-        const existing = await this.targetStorage.adapter.stat(key);
-        return { width: output.width, height: output.height, bytes: existing.size, format, mimeType: mime[format], path: key, url: await this.targetStorage.adapter.publicUrl(key), cacheKey };
-      }
-      const encoded = await encode(output, format, { quality: this.targetQuality, progressive: !0 }), written = await this.targetStorage.adapter.write(key, encoded);
-      return { width: output.width, height: output.height, bytes: written.size, format, mimeType: mime[format], path: key, url: await this.targetStorage.adapter.publicUrl(key), cacheKey };
-    }
-    const existing = await stat(path).catch(() => null);
-    if (existing)
-      return { width: output.width, height: output.height, bytes: existing.size, format, mimeType: mime[format], path, url: `${this.options.publicPath}/${filename}`, cacheKey };
-    const encoded = await encode(output, format, { quality: this.targetQuality, progressive: !0 });
-    await mkdir(this.options.outputDir, { recursive: !0 });
-    const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
-    await writeFile(temporary, encoded);
-    await rename(temporary, path);
-    return { width: output.width, height: output.height, bytes: encoded.byteLength, format, mimeType: mime[format], path, url: `${this.options.publicPath}/${filename}`, cacheKey };
-  }
-}
-export function image(source, options = {}) {
-  return new ImageBuilder(source, options);
-}
-function accepted(accept, mimeType) {
-  const [type, subtype] = mimeType.split("/");
-  let best = 0;
-  for (const item of accept.split(",")) {
-    const [range = "*/*", ...params] = item.trim().toLowerCase().split(";").map((value) => value.trim()), [acceptedType, acceptedSubtype] = range.split("/");
-    if (acceptedType !== "*" && acceptedType !== type || acceptedSubtype !== "*" && acceptedSubtype !== subtype)
-      continue;
-    const raw = params.find((param) => param.startsWith("q="));
-    best = Math.max(best, raw ? Number.parseFloat(raw.slice(2)) || 0 : 1);
-  }
-  return best;
-}
-export function negotiateImageVariant(variants, accept = "*/*", width) {
-  const widths = [...new Set(variants.map((item) => item.width))].sort((a, b) => a - b), target = width === void 0 ? widths.at(-1) : widths.find((value) => value >= width) ?? widths.at(-1);
-  return variants.filter((item) => item.width === target).map((variant, index) => ({ variant, index, q: accepted(accept || "*/*", variant.mimeType) })).filter((item) => item.q > 0).sort((a, b) => b.q - a.q || a.index - b.index)[0]?.variant;
-}
-export function imageResponseHeaders(variant) {
-  return { "Content-Type": variant.mimeType, "Content-Length": String(variant.bytes), "Cache-Control": "public, max-age=31536000, immutable", ETag: `"${variant.cacheKey}"`, Vary: "Accept", "X-Image-Width": String(variant.width), "X-Image-Height": String(variant.height) };
-}
-export function signImageTransform(path, expires, secret) {
-  return createHmac("sha256", secret).update(`${path}
-${expires}`).digest("base64url");
-}
-export function verifyImageTransform(path, expires, signature, secret, now = Date.now()) {
-  if (!Number.isInteger(expires) || expires * 1000 <= now)
-    return !1;
-  const expected = Buffer.from(signImageTransform(path, expires, secret)), actual = Buffer.from(signature);
-  return expected.length === actual.length && timingSafeEqual(expected, actual);
-}
+import{createHash,createHmac,randomUUID,timingSafeEqual}from"node:crypto";import{mkdir,readFile,rename,stat,writeFile}from"node:fs/promises";import{basename,extname,isAbsolute,relative,resolve}from"node:path";import{decode,encode,imageToSplatHash,resize}from"ts-images";export*from"./app-icons";export*from"./app-store";export*from"./fonts";export*from"./generate";export*from"./social";export*from"./theme";const mime={avif:"image/avif",webp:"image/webp",jpeg:"image/jpeg",png:"image/png"};function integer(name,value,min,max){if(!Number.isInteger(value)||value<min||value>max)throw TypeError(`${name} must be between ${min} and ${max}`)}export function resolveImageSource(source,root=process.cwd()){const allowed=resolve(root),candidate=isAbsolute(source)?resolve(source):resolve(allowed,source),relation=relative(allowed,candidate);if(source.includes("\x00")||relation===".."||relation.startsWith("../")||isAbsolute(relation))throw Error("Image source must stay inside the configured root");return candidate}export class ImageBuilder{source;targetWidths=[480,768,1280,1920];targetFormats=["avif","webp","jpeg"];targetFit="inside";targetHeight;targetAspectRatio;targetPosition="center";includeOriginal=!0;targetStorage;targetQuality=82;options;constructor(source,options={}){this.source=source;this.options={...options,root:options.root??process.cwd(),outputDir:options.outputDir??resolve("public/media/images"),publicPath:options.publicPath??"/media/images",concurrency:options.concurrency??4,upscale:options.upscale??!1}}widths(widths){if(!widths.length)throw TypeError("Image widths are required");widths.forEach((value)=>integer("Image width",value,1,16384));this.targetWidths=[...new Set(widths)].sort((a,b)=>a-b);return this}formats(formats){if(!formats.length)throw TypeError("Image formats are required");this.targetFormats=[...new Set(formats)];return this}fit(fit){this.targetFit=fit;return this}height(value){integer("Image height",value,1,16384);this.targetHeight=value;this.targetAspectRatio=void 0;return this}aspectRatio(value){if(!Number.isFinite(value)||value<=0||value>100)throw TypeError("Image aspect ratio must be between 0 and 100");this.targetAspectRatio=value;this.targetHeight=void 0;return this}position(value){this.targetPosition=value;return this}preset(value){const preset={avatar:{widths:[64,128,256,512],ratio:1,fit:"cover",original:!1},content:{widths:[320,640,960,1280,1920],fit:"inside",original:!0},hero:{widths:[640,1280,1920,2560],ratio:1.7777777777777777,fit:"cover",original:!0},thumbnail:{widths:[160,320,640],ratio:1.7777777777777777,fit:"cover",original:!1}}[value];this.targetWidths=[...preset.widths];this.targetFit=preset.fit;this.targetAspectRatio="ratio"in preset?preset.ratio:void 0;this.targetHeight=void 0;this.includeOriginal=preset.original;return this}quality(value){integer("Image quality",value,1,100);this.targetQuality=value;return this}output(dir,publicPath="/media/images"){this.options.outputDir=resolve(dir);this.options.publicPath=`/${publicPath.replace(/^\/+|\/+$/g,"")}`;return this}storage(adapter,prefix="media/images"){this.targetStorage={adapter,prefix:prefix.replace(/^\/+|\/+$/g,"")};return this}async generate(){integer("Image concurrency",this.options.concurrency,1,32);const sourcePath=resolveImageSource(this.source,this.options.root);if(this.options.authorize&&!await this.options.authorize(sourcePath,this.options.authorizationContext))throw Error("Image delivery is not authorized");const bytes=new Uint8Array(await readFile(sourcePath)),hash=createHash("sha256").update(bytes).digest("hex"),decoded=await decode(bytes),widths=this.targetWidths.filter((width)=>this.options.upscale||width<=decoded.width);if(this.includeOriginal&&!widths.includes(decoded.width))widths.push(decoded.width);const tasks=[...new Set(widths)].sort((a,b)=>a-b).flatMap((width)=>this.targetFormats.map((format)=>({width,format}))),variants=[];let cursor=0;await Promise.all(Array.from({length:Math.min(tasks.length,this.options.concurrency)},async()=>{while(cursor<tasks.length){const task=tasks[cursor++];variants.push(await this.variant(decoded,hash,sourcePath,task.width,task.format))}}));variants.sort((a,b)=>a.width-b.width||this.targetFormats.indexOf(a.format)-this.targetFormats.indexOf(b.format));return{source:{width:decoded.width,height:decoded.height,hash},variants,placeholder:Buffer.from(imageToSplatHash(decoded)).toString("base64url")}}async variant(source,hash,sourcePath,width,format){const height=this.targetHeight??(this.targetAspectRatio?Math.max(1,Math.round(width/this.targetAspectRatio)):void 0),output=width===source.width&&height===void 0?source:resize(source,{width,height,fit:this.targetFit,position:this.targetPosition});if(!this.options.upscale&&(output.width>source.width||output.height>source.height))throw TypeError(`Image variant ${output.width}x${output.height} would upscale the source`);const cacheKey=createHash("sha256").update(`${hash}:${width}:${height??"auto"}:${format}:${this.targetFit}:${this.targetPosition}:${this.targetQuality}`).digest("hex"),filename=`${basename(sourcePath,extname(sourcePath)).replace(/[^a-zA-Z0-9_-]/g,"-")||"image"}-${output.width}x${output.height}-${cacheKey.slice(0,16)}.${format==="jpeg"?"jpg":format}`,path=resolve(this.options.outputDir,filename);if(this.targetStorage){const key=this.targetStorage.prefix?`${this.targetStorage.prefix}/${filename}`:filename;if(await this.targetStorage.adapter.fileExists(key)){const existing=await this.targetStorage.adapter.stat(key);return{width:output.width,height:output.height,bytes:existing.size,format,mimeType:mime[format],path:key,url:await this.targetStorage.adapter.publicUrl(key),cacheKey}}const encoded=await encode(output,format,{quality:this.targetQuality,progressive:!0}),written=await this.targetStorage.adapter.write(key,encoded);return{width:output.width,height:output.height,bytes:written.size,format,mimeType:mime[format],path:key,url:await this.targetStorage.adapter.publicUrl(key),cacheKey}}const existing=await stat(path).catch(()=>null);if(existing)return{width:output.width,height:output.height,bytes:existing.size,format,mimeType:mime[format],path,url:`${this.options.publicPath}/${filename}`,cacheKey};const encoded=await encode(output,format,{quality:this.targetQuality,progressive:!0});await mkdir(this.options.outputDir,{recursive:!0});const temporary=`${path}.${process.pid}.${randomUUID()}.tmp`;await writeFile(temporary,encoded);await rename(temporary,path);return{width:output.width,height:output.height,bytes:encoded.byteLength,format,mimeType:mime[format],path,url:`${this.options.publicPath}/${filename}`,cacheKey}}}export function image(source,options={}){return new ImageBuilder(source,options)}function accepted(accept,mimeType){const[type,subtype]=mimeType.split("/");let best=0;for(const item of accept.split(",")){const[range="*/*",...params]=item.trim().toLowerCase().split(";").map((value)=>value.trim()),[acceptedType,acceptedSubtype]=range.split("/");if(acceptedType!=="*"&&acceptedType!==type||acceptedSubtype!=="*"&&acceptedSubtype!==subtype)continue;const raw=params.find((param)=>param.startsWith("q="));best=Math.max(best,raw?Number.parseFloat(raw.slice(2))||0:1)}return best}export function negotiateImageVariant(variants,accept="*/*",width){const widths=[...new Set(variants.map((item)=>item.width))].sort((a,b)=>a-b),target=width===void 0?widths.at(-1):widths.find((value)=>value>=width)??widths.at(-1);return variants.filter((item)=>item.width===target).map((variant,index)=>({variant,index,q:accepted(accept||"*/*",variant.mimeType)})).filter((item)=>item.q>0).sort((a,b)=>b.q-a.q||a.index-b.index)[0]?.variant}export function imageResponseHeaders(variant){return{"Content-Type":variant.mimeType,"Content-Length":String(variant.bytes),"Cache-Control":"public, max-age=31536000, immutable",ETag:`"${variant.cacheKey}"`,Vary:"Accept","X-Image-Width":String(variant.width),"X-Image-Height":String(variant.height)}}export function signImageTransform(path,expires,secret){return createHmac("sha256",secret).update(`${path}
+${expires}`).digest("base64url")}export function verifyImageTransform(path,expires,signature,secret,now=Date.now()){if(!Number.isInteger(expires)||expires*1000<=now)return!1;const expected=Buffer.from(signImageTransform(path,expires,secret)),actual=Buffer.from(signature);return expected.length===actual.length&&timingSafeEqual(expected,actual)}

package/dist/social.js

@@ -1,80 +1 @@
-import { mkdir } from "node:fs/promises";
-import process from "node:process";
-import { generateSocialCards } from "ts-images";
-import { loadFonts } from "./fonts";
-import { background, color, device, markPainter, projectFile, requireProjectFile, themed } from "./theme";
-const PRESET_SIZES = {
-  og: { width: 1200, height: 630 },
-  twitter: { width: 1200, height: 600 },
-  square: { width: 1200, height: 1200 },
-  portrait: { width: 1200, height: 1500 }
-};
-export function socialCardName(path) {
-  const trimmed = path.replace(/^\/+|\/+$/g, "");
-  return trimmed === "" ? "og" : trimmed.replace(/[^a-z0-9]+/gi, "-").toLowerCase();
-}
-export async function generateSocialCardSet(images, root = process.cwd()) {
-  if (images.social?.enabled !== !0)
-    return [];
-  const social = themed(images, images.social), fonts = await loadFonts(images.fonts, root), outputDir = projectFile(social.outputDir ?? "public/social", root), publicPath = `/${(social.publicPath ?? "/social").replace(/^\/+|\/+$/g, "")}`, presets = social.presets?.length ? social.presets : ["og"], format = social.format ?? "jpeg";
-  await mkdir(outputDir, { recursive: !0 });
-  const drawMark = await markPainter(social.mark, root), shared = {
-    titleFont: fonts.title,
-    bodyFont: fonts.body,
-    brand: social.brand,
-    drawMark,
-    markPlate: social.markPlate === !1 ? void 0 : color(social.markPlate),
-    surface: background(social.background, root),
-    color: color(social.color),
-    mutedColor: color(social.mutedColor),
-    accent: color(social.accent),
-    format,
-    quality: social.quality,
-    presets
-  }, pages = social.pages?.length ? social.pages : [{ path: "/", title: social.brand ?? "Home" }], deviceOptions = device(social.device), results = [];
-  for (const page of pages) {
-    const name = socialCardName(page.path), shot = page.foreground ?? social.foreground, files = await generateSocialCards(outputDir, {
-      ...shared,
-      name,
-      title: page.title,
-      eyebrow: page.eyebrow,
-      subtitle: page.subtitle,
-      foreground: shot ? {
-        image: requireProjectFile(shot, root, `Product shot for ${page.path}`),
-        radius: deviceOptions?.radius,
-        borderColor: deviceOptions?.borderColor,
-        shadow: deviceOptions?.shadow,
-        scale: deviceOptions?.scale
-      } : void 0
-    }), urls = Object.fromEntries(Object.entries(files).map(([preset, file]) => [
-      preset,
-      `${publicPath}/${file.slice(file.lastIndexOf("/") + 1)}`
-    ]));
-    results.push({
-      path: page.path,
-      name,
-      files,
-      urls,
-      width: PRESET_SIZES[presets[0]].width,
-      height: PRESET_SIZES[presets[0]].height,
-      title: page.title
-    });
-  }
-  return results;
-}
-export function socialMetaTags(card, siteUrl, format = "jpeg") {
-  const primary = `${siteUrl.replace(/\/+$/, "")}${card.urls.og ?? Object.values(card.urls)[0]}`, mimeType = format === "jpeg" ? "image/jpeg" : `image/${format}`;
-  return [
-    `<meta property="og:image" content="${primary}">`,
-    `<meta property="og:image:type" content="${mimeType}">`,
-    `<meta property="og:image:width" content="${card.width}">`,
-    `<meta property="og:image:height" content="${card.height}">`,
-    `<meta property="og:image:alt" content="${escapeAttribute(card.title)}">`,
-    '<meta name="twitter:card" content="summary_large_image">',
-    `<meta name="twitter:image" content="${primary}">`,
-    `<meta name="twitter:image:alt" content="${escapeAttribute(card.title)}">`
-  ];
-}
-function escapeAttribute(value) {
-  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
+import{mkdir}from"node:fs/promises";import process from"node:process";import{generateSocialCards}from"ts-images";import{loadFonts}from"./fonts";import{background,color,device,markPainter,projectFile,requireProjectFile,themed}from"./theme";const PRESET_SIZES={og:{width:1200,height:630},twitter:{width:1200,height:600},square:{width:1200,height:1200},portrait:{width:1200,height:1500}};export function socialCardName(path){const trimmed=path.replace(/^\/+|\/+$/g,"");return trimmed===""?"og":trimmed.replace(/[^a-z0-9]+/gi,"-").toLowerCase()}export async function generateSocialCardSet(images,root=process.cwd()){if(images.social?.enabled!==!0)return[];const social=themed(images,images.social),fonts=await loadFonts(images.fonts,root),outputDir=projectFile(social.outputDir??"public/social",root),publicPath=`/${(social.publicPath??"/social").replace(/^\/+|\/+$/g,"")}`,presets=social.presets?.length?social.presets:["og"],format=social.format??"jpeg";await mkdir(outputDir,{recursive:!0});const drawMark=await markPainter(social.mark,root),shared={titleFont:fonts.title,bodyFont:fonts.body,brand:social.brand,drawMark,markPlate:social.markPlate===!1?void 0:color(social.markPlate),surface:background(social.background,root),color:color(social.color),mutedColor:color(social.mutedColor),accent:color(social.accent),format,quality:social.quality,presets},pages=social.pages?.length?social.pages:[{path:"/",title:social.brand??"Home"}],deviceOptions=device(social.device),results=[];for(const page of pages){const name=socialCardName(page.path),shot=page.foreground??social.foreground,files=await generateSocialCards(outputDir,{...shared,name,title:page.title,eyebrow:page.eyebrow,subtitle:page.subtitle,foreground:shot?{image:requireProjectFile(shot,root,`Product shot for ${page.path}`),radius:deviceOptions?.radius,borderColor:deviceOptions?.borderColor,shadow:deviceOptions?.shadow,scale:deviceOptions?.scale}:void 0}),urls=Object.fromEntries(Object.entries(files).map(([preset,file])=>[preset,`${publicPath}/${file.slice(file.lastIndexOf("/")+1)}`]));results.push({path:page.path,name,files,urls,width:PRESET_SIZES[presets[0]].width,height:PRESET_SIZES[presets[0]].height,title:page.title})}return results}export function socialMetaTags(card,siteUrl,format="jpeg"){const primary=`${siteUrl.replace(/\/+$/,"")}${card.urls.og??Object.values(card.urls)[0]}`,mimeType=format==="jpeg"?"image/jpeg":`image/${format}`;return[`<meta property="og:image" content="${primary}">`,`<meta property="og:image:type" content="${mimeType}">`,`<meta property="og:image:width" content="${card.width}">`,`<meta property="og:image:height" content="${card.height}">`,`<meta property="og:image:alt" content="${escapeAttribute(card.title)}">`,'<meta name="twitter:card" content="summary_large_image">',`<meta name="twitter:image" content="${primary}">`,`<meta name="twitter:image:alt" content="${escapeAttribute(card.title)}">`]}function escapeAttribute(value){return value.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}

package/dist/theme.js

@@ -1,60 +1,2 @@
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { isAbsolute, resolve } from "node:path";
-import process from "node:process";
-import { decode, drawImage, parseColor } from "ts-images";
-export function projectFile(path, root = process.cwd()) {
-  return isAbsolute(path) ? path : resolve(root, path);
-}
-export function requireProjectFile(path, root, describe) {
-  const resolved = projectFile(path, root);
-  if (!existsSync(resolved))
-    throw Error(`[image] ${describe} not found: ${path}
-Looked in ${resolved}. Capture it before generating \u2014 \`buddy generate:images\` frames existing captures, it does not take them.`);
-  return resolved;
-}
-export function color(value) {
-  return value === void 0 ? void 0 : parseColor(value);
-}
-export function background(value, root = process.cwd()) {
-  if (!value)
-    return;
-  return {
-    color: color(value.color),
-    gradient: value.gradient && {
-      angle: value.gradient.angle,
-      stops: value.gradient.stops.map((stop) => ({ offset: stop.offset, color: parseColor(stop.color) }))
-    },
-    glows: value.glows?.map((glow) => ({ ...glow, color: parseColor(glow.color) })),
-    image: value.image ? projectFile(value.image, root) : void 0
-  };
-}
-export function device(value) {
-  if (!value)
-    return;
-  return {
-    radius: value.radius,
-    scale: value.scale,
-    borderColor: color(value.borderColor),
-    shadow: value.shadow === !1 ? void 0 : { ...value.shadow ?? {}, color: color(value.shadow?.color) }
-  };
-}
-export async function markPainter(path, root = process.cwd()) {
-  if (!path)
-    return;
-  const mark = await decode(new Uint8Array(await readFile(projectFile(path, root))));
-  return (canvas, box) => {
-    drawImage(canvas, mark, { x: box.x, y: box.y, width: box.size, height: box.size, fit: "contain" });
-  };
-}
-export function themed(images, section) {
-  return {
-    ...section ?? {},
-    background: section?.background ?? images.background,
-    color: section?.color ?? images.color,
-    mutedColor: section?.mutedColor ?? images.mutedColor,
-    device: section?.device ?? images.device,
-    brand: section?.brand ?? images.brand,
-    mark: section?.mark ?? images.mark
-  };
-}
+import{existsSync}from"node:fs";import{readFile}from"node:fs/promises";import{isAbsolute,resolve}from"node:path";import process from"node:process";import{decode,drawImage,parseColor}from"ts-images";export function projectFile(path,root=process.cwd()){return isAbsolute(path)?path:resolve(root,path)}export function requireProjectFile(path,root,describe){const resolved=projectFile(path,root);if(!existsSync(resolved))throw Error(`[image] ${describe} not found: ${path}
+Looked in ${resolved}. Capture it before generating \u2014 \`buddy generate:images\` frames existing captures, it does not take them.`);return resolved}export function color(value){return value===void 0?void 0:parseColor(value)}export function background(value,root=process.cwd()){if(!value)return;return{color:color(value.color),gradient:value.gradient&&{angle:value.gradient.angle,stops:value.gradient.stops.map((stop)=>({offset:stop.offset,color:parseColor(stop.color)}))},glows:value.glows?.map((glow)=>({...glow,color:parseColor(glow.color)})),image:value.image?projectFile(value.image,root):void 0}}export function device(value){if(!value)return;return{radius:value.radius,scale:value.scale,borderColor:color(value.borderColor),shadow:value.shadow===!1?void 0:{...value.shadow??{},color:color(value.shadow?.color)}}}export async function markPainter(path,root=process.cwd()){if(!path)return;const mark=await decode(new Uint8Array(await readFile(projectFile(path,root))));return(canvas,box)=>{drawImage(canvas,mark,{x:box.x,y:box.y,width:box.size,height:box.size,fit:"contain"})}}export function themed(images,section){return{...section??{},background:section?.background??images.background,color:section?.color??images.color,mutedColor:section?.mutedColor??images.mutedColor,device:section?.device??images.device,brand:section?.brand??images.brand,mark:section?.mark??images.mark}}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/image",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.257",
+  "version": "0.70.259",
   "description": "Native responsive image delivery for Stacks.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -31,7 +31,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/types": "0.70.257",
+    "@stacksjs/types": "0.70.259",
     "ts-images": "^0.2.7"
   },
   "devDependencies": {