@openpresentation/opf-render 0.23.0 → 0.24.3

package/README.md

@@ -216,7 +216,7 @@ Layout templates (OPF 0.19, core `opf-layout/v2`: `areas`, `rows`, `columns` and
 
 The installed open font pack works offline. The Aptos family previews with the metric-compatible Intos even under the default metric policy; this example additionally permits visual-only look-alikes for families with no metric replacement yet (a documented fallback), and the substitution report identifies requested and resolved faces. A visual substitute is not a claim of metric or pixel equivalence, and it is a known layout-fidelity gap rather than the end state. Replacements apply to rendering only; the document keeps the selected font name. Omit `substitutionPolicy` to restrict the Office pack to its metric mappings, or supply your own licensed faces (`faces`). Missing fonts/glyphs fail explicitly. Without `fonts`, synchronous SVG APIs use estimated widths; named fonts alone do not make rich-run spacing reliable. Browser hosts should load the same bytes using the loader below.
 
-Unresolved images produce an `unresolved-asset` diagnostic through `onDiagnostic`, including the OPF path, reason and complete description. The fallback shows a bounded status label when it fits above the selected readability floor, otherwise an icon with the full accessible description. The label is `Image unavailable` over the description (alt, else title, else `Image`) in semibold at 20 px on a 1280 x 720 canvas, and opf-pptx exports the same placeholder as native shapes. It preserves authored opacity, including faint decorative watermarks; a missing image is still missing even when its fallback fits. Use `strictAssets: true` to reject unresolved images. Supply embedded raster data URIs or a synchronous host `imageResolver` to resolve them; the renderer does not fetch URLs or read local paths. Caller descriptions and other metadata override referenced asset metadata through alias chains. These diagnostics identify unresolved sources, not malformed image bytes or native PowerPoint compatibility.
+Unresolved images produce an `unresolved-asset` diagnostic through `onDiagnostic` (a warning in the CLI report, `render/unresolved-asset`, which `--fail-on warning` turns into a failure), including the OPF path, the `source` the author wrote, the reason and the complete description; the `message` names that source, and the image is skipped, not the render. It covers every place a deck spells an image: slide backgrounds (also tiled), image blocks, header/footer and organization logos, picture watermarks, picture bullets, and `asset:` references. The fallback shows a bounded status label when it fits above the selected readability floor, otherwise an icon with the full accessible description. The label is `Image unavailable` over the description (alt, else title, else `Image`) in semibold at 20 px on a 1280 x 720 canvas, and opf-pptx exports the same placeholder as native shapes. It preserves authored opacity, including faint decorative watermarks; a missing image is still missing even when its fallback fits. Use `strictAssets: true` to reject unresolved images. Supply embedded raster data URIs or a synchronous host `imageResolver` to resolve them; the renderer does not fetch URLs or read local paths. Caller descriptions and other metadata override referenced asset metadata through alias chains. These diagnostics identify unresolved sources, not malformed image bytes or native PowerPoint compatibility.
 
 Header/footer images and watermarks fit their complete artwork within their allocated regions. Image blocks use their own `fit`, else `design.imageFit` (default `cover`), as core resolves it into `item.image.fit`.
 

package/dist/svg.js

@@ -1186,12 +1186,22 @@ function svgHasIntrinsicSize(attributes) {
   return Boolean((length(attributes.width) && length(attributes.height)) || view);
 }
 
+// RR-97: the message of an `unresolved-asset` diagnostic names the source the author wrote, so a report says which image to fix
+// (the diagnostic's `path` says where). The renderer fetches no URL and reads no path: a host resolves a local file to a data URI
+// (`imageResolver`, or the CLI's `--asset-dir`), and one that cannot says why in its own finding.
+function unresolvedImageMessage(kind, src, missingReference, outcome) {
+  if (missingReference) return `${kind} asset "${missingReference}" is not declared in the deck's assets, so ${outcome}. Declare the asset or resolve it in the host.`;
+  if (typeof src !== "string" || src === "") return `${kind} has no src, so ${outcome}.`;
+  const shown = src.startsWith("data:") ? `${src.slice(0, Math.min(src.indexOf(",") + 1 || 40, 60))}...` : src.length > 120 ? `${src.slice(0, 117)}...` : src;
+  return `${kind} "${shown}" was not resolved to an embedded PNG, JPEG, GIF, WebP or SVG data URI, so ${outcome}. Fix the path, embed the image as a data URI, or resolve it in the host (imageResolver, or --asset-dir in the CLI).`;
+}
+
 // The drawable data URI of a picture bullet, or undefined (after reporting unresolved-asset once) so the glyph marker stays.
 function resolveBulletImage(bulletImage, bound, options) {
   const { drawable, source, asset, missingReference } = resolveImageSource({ value: bulletImage.source, path: bulletImage.path }, bound, options);
   if (drawable) return source;
   const reason=missingReference?'missing-reference':!asset.src?'missing-source':'unsupported-source';
-  const message=missingReference?`Bullet image asset ${missingReference} is missing; the preview draws the character bullet.`:'A picture bullet requires an embedded raster data URI or a host imageResolver; the preview draws the character bullet.';
+  const message=unresolvedImageMessage('Bullet image',asset.src,missingReference,'the preview draws the character bullet');
   if (options.strictAssets) throw new OPFRenderError("unresolved-asset", message, { path: bulletImage.path,reason });
   reportDiagnostic({code:'unresolved-asset',path:bulletImage.path,message,reason,source:asset.src,assetId:missingReference,description:asset.alt??asset.title??'Bullet image',placeholder:'glyph'},options);
   return undefined;
@@ -1222,7 +1232,7 @@ function renderImage(item, box, bound, options) {
       ...attrs });
   }
   const reason=missingReference?'missing-reference':!asset.src?'missing-source':'unsupported-source';
-  const message=missingReference?`Image asset ${missingReference} is missing; supply the referenced asset or resolve it in the host.`:'Image requires an embedded raster or SVG data URI, or a host imageResolver.';
+  const message=unresolvedImageMessage('Image',asset.src,missingReference,'the preview draws the unavailable-image placeholder');
   if (options.strictAssets) throw new OPFRenderError("unresolved-asset", message, { path: item.path,reason });
   const fill = bound.design.colors.surface;
   const scale=Math.min(bound.design.dimensions.width,bound.design.dimensions.height)/720;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpresentation/opf-render",
-  "version": "0.23.0",
+  "version": "0.24.3",
   "description": "Deterministic local OPF renderer for SVG, PNG, and PDF output.",
   "license": "MIT",
   "type": "module",
@@ -142,7 +142,7 @@
     "test:forced-colors-browser": "node test/forced-colors-browser.mjs artifacts/forced-colors"
   },
   "dependencies": {
-    "@openpresentation/opf": "^0.23.0",
+    "@openpresentation/opf": "^0.24.2",
     "bidi-js": "1.1.0",
     "fontkit": "^2.0.4",
     "harfbuzzjs": "1.6.3",
@@ -341,7 +341,7 @@
     }
   },
   "devDependencies": {
-    "@openpresentation/gallery": "^3.0.0",
+    "@openpresentation/gallery": "^4.0.0",
     "@expo-google-fonts/arimo": "0.4.3",
     "@expo-google-fonts/caladea": "0.4.2",
     "@expo-google-fonts/cousine": "0.4.3",