@fusion.dev/helix-map 0.207.0 → 0.207.2

package/dist/snapshot/snapshot.d.ts

@@ -64,8 +64,9 @@ export interface MapSnapshot {
     credit: CreditPart[];
     /**
      * The picture, then the credit in the frame's `attribution` slot, as markup
-     * to write in the frame after the element the renderer draws in. An empty
-     * string where the snapshot could not be drawn.
+     * to write in the frame after the element the renderer draws in. The credit
+     * alone where the picture could not be drawn and the tiles' TileJSON was
+     * read, and an empty string where neither is known.
      */
     markup: string;
     /** The picture alone, as markup. An empty string where it could not be drawn. */
@@ -97,11 +98,19 @@ export interface MapSnapshot {
  * `connectMap` hides it once the renderer's credit is written, or at once
  * where the page slotted its own.
  *
- * **Whole or nothing.** Holds empty strings where any tile the view needs
- * cannot be read in time, or the view is not numbers, which a page renders
- * as nothing and the renderer then draws. A snapshot with a tile missing
- * looks finished and is not, and one that waited on a slow server held the
- * page: each request is given `timeout` milliseconds. A tile the server says
- * it does not have, a 404, is drawn empty, as the sea is.
+ * **The picture is whole or nothing.** `picture` is an empty string where
+ * any tile the view needs cannot be read in time, or the view is not
+ * numbers, which a page renders as nothing and the renderer then draws. A
+ * snapshot with a tile missing looks finished and is not, and one that waited
+ * on a slow server held the page: each request is given `timeout`
+ * milliseconds. A tile the server says it does not have, a 404, is drawn
+ * empty, as the sea is.
+ *
+ * **The credit outlives a missing tile.** It is read from the TileJSON before
+ * any tile is asked for, so a tile that fails costs the picture and keeps
+ * the credit, and `markup` is then the credit alone. A page that wrote
+ * nothing for a failed picture showed the map with no credit until the
+ * renderer read its own, and a page that never loads one, never. Cache only a
+ * snapshot whose `picture` is not empty.
  */
 export declare const mapSnapshot: (asked: MapView, options?: SnapshotOptions) => Promise<MapSnapshot>;

package/dist/snapshot/snapshot.js

@@ -312,7 +312,7 @@ export const mapSnapshot = async (asked, options = {}) => {
         }
     }
     if (!whole) {
-        return nothing();
+        return { credit, markup: creditMarkup(credit), picture: '' };
     }
     const body = shown
         .map((layer) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-map",
   "description": "Connects the Helix Map frame to a map renderer: MapLibre, Leaflet, or a driver of your own.",
-  "version": "0.207.0",
+  "version": "0.207.2",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -44,14 +44,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.207.0",
-    "@fusion.dev/helix-icons": "0.207.0",
+    "@fusion.dev/helix-core": "0.207.2",
+    "@fusion.dev/helix-icons": "0.207.2",
     "@mapbox/vector-tile": "^3.0.0",
     "pbf": "^5.1.2"
   },
   "devDependencies": {
-    "@fusion.dev/helix-headless": "0.207.0",
-    "@fusion.dev/helix-testing": "0.207.0",
+    "@fusion.dev/helix-headless": "0.207.2",
+    "@fusion.dev/helix-testing": "0.207.2",
     "@maplibre/maplibre-gl-style-spec": "^26.4.4",
     "@types/bun": "^1.4.2",
     "@types/leaflet": "^1.9.20",