@stacksjs/image 0.70.234 → 0.70.236

package/dist/app-icons.js

@@ -1,11 +1,11 @@
 import process from "node:process";
 import { generateAppIcons, generateFavicons } from "ts-images";
-import { projectFile } from "./theme";
+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 = projectFile(appIcons.source, root), platforms = appIcons.platforms?.length ? appIcons.platforms : ["ios", "macos"], icons = await generateAppIcons(source, {
+  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)) : [];

package/dist/app-store.js

@@ -2,7 +2,7 @@ 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, themed } from "./theme";
+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 {};
@@ -25,7 +25,7 @@ export async function generateAppStoreScreenshotSet(images, root = process.cwd()
   }, results = {};
   for (const display of displays) {
     const slides = declared.filter((slide) => !slide.displays?.length || slide.displays.includes(display)).map((slide) => ({
-      capture: projectFile(slide.capture, root),
+      capture: requireProjectFile(slide.capture, root, `Capture for the "${slide.headline}" slide`),
       headline: slide.headline,
       subheadline: slide.subheadline,
       background: background(slide.background, root)

package/dist/social.js

@@ -2,7 +2,7 @@ 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, themed } from "./theme";
+import { background, color, device, markPainter, projectFile, requireProjectFile, themed } from "./theme";
 const PRESET_SIZES = {
   og: { width: 1200, height: 630 },
   twitter: { width: 1200, height: 600 },
@@ -40,7 +40,7 @@ export async function generateSocialCardSet(images, root = process.cwd()) {
       eyebrow: page.eyebrow,
       subtitle: page.subtitle,
       foreground: shot ? {
-        image: projectFile(shot, root),
+        image: requireProjectFile(shot, root, `Product shot for ${page.path}`),
         radius: deviceOptions?.radius,
         borderColor: deviceOptions?.borderColor,
         shadow: deviceOptions?.shadow,

package/dist/theme.d.ts

@@ -10,6 +10,16 @@ import type { ImageData, RGBA, SurfaceBackground } from 'ts-images';
  * which is the point of having a shared palette at all.
  */
 export declare function projectFile(path: string, root?: string): string;
+/**
+ * Resolve a configured asset, failing with something a person can act on.
+ *
+ * These paths point at things a build step produced — a capture of a running
+ * app, an exported logo — so the common failure is not a typo but an ordering
+ * mistake: generate before capture, or after a clean that wiped the captures.
+ * Left to the codec, that surfaces as a bare ENOENT under ten frames of stack
+ * with no mention of which slide or which config key is at fault.
+ */
+export declare function requireProjectFile(path: string, root: string, describe: string): string;
 export declare function color(value: ImageColor | undefined): RGBA | undefined;
 export declare function background(value: ImageBackgroundConfig | undefined, root?: string): SurfaceBackground | undefined;
 /**

package/dist/theme.js

@@ -1,3 +1,4 @@
+import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { isAbsolute, resolve } from "node:path";
 import process from "node:process";
@@ -5,6 +6,13 @@ 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);
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/image",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.234",
+  "version": "0.70.236",
   "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.234",
+    "@stacksjs/types": "0.70.236",
     "ts-images": "^0.2.6"
   },
   "devDependencies": {