@rowsncolumns/grid 13.3.0 → 13.4.0

package/dist/cjs/hooks/useImage.d.ts

@@ -8,6 +8,19 @@ export interface UseImageResults {
     height: number;
     status: string;
 }
+/**
+ * Asks once more for every image whose load failed. A host calls it each time the page can reach
+ * the network again, so a picture that failed to load while offline draws without the sheet being
+ * reopened.
+ *
+ * - An image something still draws is requested again at once, and redraws when it loads.
+ * - A failed image nothing draws any more is forgotten, so it is requested when it is next drawn.
+ * - An image that loaded, or whose request is still running, is left alone.
+ *
+ * So each failed image costs at most one request per call, and nothing is retried on a timer.
+ * Each attempt uses a new element, so a browser that ignores a repeated `src` still asks again.
+ */
+export declare const retryFailedImages: () => void;
 declare const useImage: ({ url, crossOrigin }: UseImageProps) => UseImageResults;
 export default useImage;
 //# sourceMappingURL=useImage.d.ts.map

package/dist/cjs/hooks/useImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useImage.d.ts","sourceRoot":"","sources":["../../../hooks/useImage.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAmDD,QAAA,MAAM,QAAQ,GAAI,sBAAsB,aAAa,oBAgDpD,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"useImage.d.ts","sourceRoot":"","sources":["../../../hooks/useImage.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AA0DD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,QAAO,IAUpC,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,sBAAsB,aAAa,oBAgDpD,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/cjs/hooks/useImage.js

@@ -1,24 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.retryFailedImages = void 0;
 var tslib_1 = require("tslib");
 var react_1 = require("react");
 // Global cache to share images across all component instances
 var imageCache = new Map();
-var loadImage = function (url, crossOrigin) {
-    var existing = imageCache.get(url);
-    if (existing) {
-        return existing;
-    }
-    var img = new Image();
-    img.crossOrigin = crossOrigin || "anonymous";
-    var entry = {
-        image: img,
-        status: "loading",
-        width: 0,
-        height: 0,
-        subscribers: new Set(),
-    };
-    imageCache.set(url, entry);
+/** Starts the entry's image element loading `url`. */
+var requestImage = function (url, entry) {
+    var img = entry.image;
+    img.crossOrigin = entry.crossOrigin;
+    entry.status = "loading";
     var onload = function () {
         entry.status = "loaded";
         entry.width = img.width;
@@ -32,8 +23,49 @@ var loadImage = function (url, crossOrigin) {
     img.addEventListener("load", onload);
     img.addEventListener("error", onerror);
     img.src = url;
+};
+var loadImage = function (url, crossOrigin) {
+    var existing = imageCache.get(url);
+    if (existing) {
+        return existing;
+    }
+    var entry = {
+        image: new Image(),
+        status: "loading",
+        width: 0,
+        height: 0,
+        crossOrigin: crossOrigin || "anonymous",
+        subscribers: new Set(),
+    };
+    imageCache.set(url, entry);
+    requestImage(url, entry);
     return entry;
 };
+/**
+ * Asks once more for every image whose load failed. A host calls it each time the page can reach
+ * the network again, so a picture that failed to load while offline draws without the sheet being
+ * reopened.
+ *
+ * - An image something still draws is requested again at once, and redraws when it loads.
+ * - A failed image nothing draws any more is forgotten, so it is requested when it is next drawn.
+ * - An image that loaded, or whose request is still running, is left alone.
+ *
+ * So each failed image costs at most one request per call, and nothing is retried on a timer.
+ * Each attempt uses a new element, so a browser that ignores a repeated `src` still asks again.
+ */
+var retryFailedImages = function () {
+    imageCache.forEach(function (entry, url) {
+        if (entry.status !== "failed")
+            return;
+        if (entry.subscribers.size === 0) {
+            imageCache.delete(url);
+            return;
+        }
+        entry.image = new Image();
+        requestImage(url, entry);
+    });
+};
+exports.retryFailedImages = retryFailedImages;
 var useImage = function (_a) {
     var url = _a.url, crossOrigin = _a.crossOrigin;
     var _b = tslib_1.__read((0, react_1.useState)(function () {

package/dist/cjs/index.d.ts

@@ -14,6 +14,9 @@ export * from "./hooks/useTooltip";
 export * from "./hooks/useEditable";
 export * from "./types";
 export type { ImageProps } from "./Image";
+export { retryFailedImages } from "./hooks/useImage";
+export { default as useImage } from "./hooks/useImage";
+export type { UseImageProps, UseImageResults } from "./hooks/useImage";
 export * from "./utils";
 export * from "./Context";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,YAAY,IAAI,mBAAmB,EACpC,MAAM,eAAe,CAAC;AACvB,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,OAAO,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,OAAO,EACP,SAAS,EACT,mBAAmB,EACnB,KAAK,EACL,SAAS,GACV,CAAC;AACF,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,YAAY,IAAI,mBAAmB,EACpC,MAAM,eAAe,CAAC;AACvB,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,OAAO,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,OAAO,EACP,SAAS,EACT,mBAAmB,EACnB,KAAK,EACL,SAAS,GACV,CAAC;AACF,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvE,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Selection = exports.Image = exports.CellOverlayRenderer = exports.useFilter = exports.useUndo = exports.CellOverlay = exports.Cell = exports.CellRenderer = exports.Grid = void 0;
+exports.useImage = exports.retryFailedImages = exports.Selection = exports.Image = exports.CellOverlayRenderer = exports.useFilter = exports.useUndo = exports.CellOverlay = exports.Cell = exports.CellRenderer = exports.Grid = void 0;
 var tslib_1 = require("tslib");
 var Cell_1 = require("./Cell");
 Object.defineProperty(exports, "Cell", { enumerable: true, get: function () { return Cell_1.Cell; } });
@@ -25,5 +25,9 @@ tslib_1.__exportStar(require("./hooks/useUndo"), exports);
 tslib_1.__exportStar(require("./hooks/useTooltip"), exports);
 tslib_1.__exportStar(require("./hooks/useEditable"), exports);
 tslib_1.__exportStar(require("./types"), exports);
+var useImage_1 = require("./hooks/useImage");
+Object.defineProperty(exports, "retryFailedImages", { enumerable: true, get: function () { return useImage_1.retryFailedImages; } });
+var useImage_2 = require("./hooks/useImage");
+Object.defineProperty(exports, "useImage", { enumerable: true, get: function () { return tslib_1.__importDefault(useImage_2).default; } });
 tslib_1.__exportStar(require("./utils"), exports);
 tslib_1.__exportStar(require("./Context"), exports);

package/dist/esm/hooks/useImage.d.ts

@@ -8,6 +8,19 @@ export interface UseImageResults {
     height: number;
     status: string;
 }
+/**
+ * Asks once more for every image whose load failed. A host calls it each time the page can reach
+ * the network again, so a picture that failed to load while offline draws without the sheet being
+ * reopened.
+ *
+ * - An image something still draws is requested again at once, and redraws when it loads.
+ * - A failed image nothing draws any more is forgotten, so it is requested when it is next drawn.
+ * - An image that loaded, or whose request is still running, is left alone.
+ *
+ * So each failed image costs at most one request per call, and nothing is retried on a timer.
+ * Each attempt uses a new element, so a browser that ignores a repeated `src` still asks again.
+ */
+export declare const retryFailedImages: () => void;
 declare const useImage: ({ url, crossOrigin }: UseImageProps) => UseImageResults;
 export default useImage;
 //# sourceMappingURL=useImage.d.ts.map

package/dist/esm/hooks/useImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useImage.d.ts","sourceRoot":"","sources":["../../../hooks/useImage.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAmDD,QAAA,MAAM,QAAQ,GAAI,sBAAsB,aAAa,oBAgDpD,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"useImage.d.ts","sourceRoot":"","sources":["../../../hooks/useImage.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AA0DD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,QAAO,IAUpC,CAAC;AAEF,QAAA,MAAM,QAAQ,GAAI,sBAAsB,aAAa,oBAgDpD,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/esm/hooks/useImage.js

@@ -1,21 +1,11 @@
 import { useEffect, useState } from "react";
 // Global cache to share images across all component instances
 const imageCache = new Map();
-const loadImage = (url, crossOrigin) => {
-    const existing = imageCache.get(url);
-    if (existing) {
-        return existing;
-    }
-    const img = new Image();
-    img.crossOrigin = crossOrigin || "anonymous";
-    const entry = {
-        image: img,
-        status: "loading",
-        width: 0,
-        height: 0,
-        subscribers: new Set(),
-    };
-    imageCache.set(url, entry);
+/** Starts the entry's image element loading `url`. */
+const requestImage = (url, entry) => {
+    const img = entry.image;
+    img.crossOrigin = entry.crossOrigin;
+    entry.status = "loading";
     const onload = () => {
         entry.status = "loaded";
         entry.width = img.width;
@@ -29,8 +19,48 @@ const loadImage = (url, crossOrigin) => {
     img.addEventListener("load", onload);
     img.addEventListener("error", onerror);
     img.src = url;
+};
+const loadImage = (url, crossOrigin) => {
+    const existing = imageCache.get(url);
+    if (existing) {
+        return existing;
+    }
+    const entry = {
+        image: new Image(),
+        status: "loading",
+        width: 0,
+        height: 0,
+        crossOrigin: crossOrigin || "anonymous",
+        subscribers: new Set(),
+    };
+    imageCache.set(url, entry);
+    requestImage(url, entry);
     return entry;
 };
+/**
+ * Asks once more for every image whose load failed. A host calls it each time the page can reach
+ * the network again, so a picture that failed to load while offline draws without the sheet being
+ * reopened.
+ *
+ * - An image something still draws is requested again at once, and redraws when it loads.
+ * - A failed image nothing draws any more is forgotten, so it is requested when it is next drawn.
+ * - An image that loaded, or whose request is still running, is left alone.
+ *
+ * So each failed image costs at most one request per call, and nothing is retried on a timer.
+ * Each attempt uses a new element, so a browser that ignores a repeated `src` still asks again.
+ */
+export const retryFailedImages = () => {
+    imageCache.forEach((entry, url) => {
+        if (entry.status !== "failed")
+            return;
+        if (entry.subscribers.size === 0) {
+            imageCache.delete(url);
+            return;
+        }
+        entry.image = new Image();
+        requestImage(url, entry);
+    });
+};
 const useImage = ({ url, crossOrigin }) => {
     const [state, setState] = useState(() => {
         if (!url) {

package/dist/esm/index.d.ts

@@ -14,6 +14,9 @@ export * from "./hooks/useTooltip";
 export * from "./hooks/useEditable";
 export * from "./types";
 export type { ImageProps } from "./Image";
+export { retryFailedImages } from "./hooks/useImage";
+export { default as useImage } from "./hooks/useImage";
+export type { UseImageProps, UseImageResults } from "./hooks/useImage";
 export * from "./utils";
 export * from "./Context";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,YAAY,IAAI,mBAAmB,EACpC,MAAM,eAAe,CAAC;AACvB,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,OAAO,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,OAAO,EACP,SAAS,EACT,mBAAmB,EACnB,KAAK,EACL,SAAS,GACV,CAAC;AACF,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,YAAY,IAAI,mBAAmB,EACpC,MAAM,eAAe,CAAC;AACvB,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,OAAO,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,OAAO,EACP,SAAS,EACT,mBAAmB,EACnB,KAAK,EACL,SAAS,GACV,CAAC;AACF,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvE,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/esm/index.js

@@ -13,5 +13,7 @@ export * from "./hooks/useUndo";
 export * from "./hooks/useTooltip";
 export * from "./hooks/useEditable";
 export * from "./types";
+export { retryFailedImages } from "./hooks/useImage";
+export { default as useImage } from "./hooks/useImage";
 export * from "./utils";
 export * from "./Context";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rowsncolumns/grid",
   "description": "Declarative React Canvas Grid primitive for Data table, Pivot table, Excel Worksheets",
-  "version": "13.3.0",
+  "version": "13.4.0",
   "license": "SEE LICENSE IN LICENSE.md",
   "files": [
     "dist"