@sheetpane/images 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arpit Arya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,80 @@
-# Temporary Holding Version
+# @sheetpane/images
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Images for sheetpane — pictures anchored in the sheet drawn in sheet space through the `overlay` hook; view only, kept on export.**
+
+A plugin: it registers against the one in-memory workbook of `@sheetpane/grid`
+(`createWorkbook({ plugins: [...] })`, or `plugins="images"` on the element), so
+`<sheetpane-excel>` and `<sheetpane-errors>` both see its effect. Versioned in
+lockstep with `@sheetpane/grid`.
+
+```ts
+import { createWorkbook } from '@sheetpane/grid';
+import { images } from '@sheetpane/images';
+
+el.workbook = createWorkbook({ plugins: [images()] });
+// or: import '@sheetpane/images'  and  <sheetpane-excel plugins="images">
+```
+
+No runtime dependencies. Importing is safe in Node (no DOM until a picture renders).
+
+## What it draws
+
+Every `picture` in a sheet's drawing part, at its anchor, in the overlay layer: it scrolls,
+zooms and clips with its cells, under the pins and above the cells. `alt` is the picture's
+description (`descr`), else its name.
+
+| format | shown as |
+|---|---|
+| PNG, JPEG, GIF, BMP, WebP | an `<img>` over an object URL |
+| SVG | an `<img>` too — never inline markup, so no script in the file can run |
+| EMF, WMF, TIFF, anything else | a dashed frame the size of the anchor: `logo.emf — preview unavailable` |
+
+The format is told from the bytes' header first and the file name second.
+
+Charts and shapes are not pictures and are skipped (the charts plugin draws charts). The status
+bar adds `2 pictures · 1 preview unavailable` for the sheet in view.
+
+**View only.** In Edit a click on a picture selects the cell under the click, so that cell can
+still be flagged; pictures cannot be moved, resized, added or deleted.
+
+## Anchors (`src/anchors.ts`, exported)
+
+EMU become pixels at 9,525 EMU per pixel (914,400 per inch, 96 px per inch), then are placed in
+the grid's own geometry (`Geometry` — pixels at 100 % zoom from A1's top-left):
+
+| anchor | rectangle |
+|---|---|
+| `twoCell` | `from` to `to`, each corner plus its offset |
+| `oneCell` | `from` plus its offset, sized by `ext` |
+| `absolute` | `pos` from the sheet origin, sized by `ext` |
+
+An offset never reaches past its own cell, as in Excel. `anchorRect(anchor, geometry)`,
+`pointToPx`, `cellAt`, `emuToPx` and `refOf` are plain functions with no DOM, so
+`@sheetpane/charts` reuses them as they are.
+
+**Excel's own row heights and hidden rows or columns are not used.** The grid draws every row at
+its fixed height and shows what is stored, hidden or not; a picture anchored C4:F9 covers C4:F9
+on screen, whatever size those cells are in Excel. A `oneCell` or `absolute` picture keeps its
+`ext` in pixels, so beside tall Excel rows it can look smaller than it did there.
+
+## Memory
+
+Nothing is read from the file's media until a picture comes near the screen (a 20 MB photo costs
+nothing until scrolled to). One object URL is made per media part however many pictures show it,
+and all are revoked when the pane loads another workbook (or a load fails). A decode that
+finishes after the workbook went makes no URL.
+
+## Export
+
+Patch-mode export leaves the drawing and media parts as they were (the fidelity ruling), so a
+workbook's pictures survive a round trip. **A deleted row does not re-anchor pictures in v1**:
+the file keeps the anchors it had.
+
+## Tests
+
+`pnpm exec vitest run --project images` — anchor arithmetic against geometry, rectangles against
+the rendered cells (oneCell, twoCell, absolute, zoom), every format, laziness, object-URL
+revocation. Fixtures are hand-written packages and the ExcelJS 2×2 PNG; files saved by Excel and
+LibreOffice are owed by W-30.
+
+**Using an AI coding agent?** `npx sheetpane-skills install` puts sheetpane's skills for Claude Code, Kiro and Codex into your repository.

package/dist/anchors.d.ts

@@ -0,0 +1,82 @@
+import type { Geometry } from '@sheetpane/grid';
+/** 914,400 EMU per inch, 96 px per inch. */
+export declare const EMU_PER_PX = 9525;
+/** EMU → px (9,525 EMU per pixel), unrounded. */
+export declare const emuToPx: (emu: number) => number;
+/** px → EMU (9,525 EMU per pixel), rounded to a whole EMU. */
+export declare const pxToEmu: (px: number) => number;
+/** A position in a drawing: zero-based column and row, plus an offset in EMU inside that cell. */
+export interface AnchorPoint {
+    col: number;
+    colOff: number;
+    row: number;
+    rowOff: number;
+}
+/** The shape of `DrawingAnchor` (@sheetpane/import) that placing needs; any drawing kind fits. */
+export interface Anchor {
+    anchor: 'twoCell' | 'oneCell' | 'absolute';
+    from?: AnchorPoint;
+    to?: AnchorPoint;
+    /** Size in EMU (oneCell, absolute). */
+    ext?: {
+        cx: number;
+        cy: number;
+    };
+    /** Position in EMU from the sheet origin (absolute). */
+    pos?: {
+        x: number;
+        y: number;
+    };
+}
+/** A rectangle in sheet space: px at 100 % zoom from the top-left of A1. */
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * An anchor point in sheet space, placed through the grid's geometry. An offset never reaches past its own cell
+ * (Excel clamps it the same way).
+ *
+ * @param g - The grid's geometry (its column and row positions and sizes).
+ * @param p - The point: column, row and their EMU offsets.
+ * @returns The point's `{ x, y }` in px.
+ */
+export declare function pointToPx(g: Geometry, p: AnchorPoint): {
+    x: number;
+    y: number;
+};
+/**
+ * The rectangle an anchor covers, or `undefined` when the anchor lacks what its kind needs.
+ * - twoCell: `from` to `to`, each with its offsets;
+ * - oneCell: `from` plus `ext`;
+ * - absolute: `pos` plus `ext`, from the sheet origin.
+ *
+ * @param a - The anchor (any drawing kind fits).
+ * @param g - The grid's geometry.
+ * @returns The rectangle in sheet space, or `undefined`.
+ */
+export declare function anchorRect(a: Anchor, g: Geometry): Rect | undefined;
+/**
+ * The cell under a point in sheet space (px at 100 %); a negative coordinate counts as 0.
+ *
+ * @param g - The grid's geometry.
+ * @param x - Horizontal position, px.
+ * @param y - Vertical position, px.
+ * @returns The zero-based `{ row, col }`.
+ */
+export declare function cellAt(g: Geometry, x: number, y: number): {
+    row: number;
+    col: number;
+};
+/**
+ * A column's letters: `0` → `A`, `25` → `Z`, `26` → `AA`.
+ *
+ * @param col - The column, 0-based.
+ * @returns Its letters.
+ */
+export declare function colLabel(col: number): string;
+/** Zero-based row and column → `A1`. */
+export declare const refOf: (row: number, col: number) => string;
+//# sourceMappingURL=anchors.d.ts.map

package/dist/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,4CAA4C;AAC5C,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B,iDAAiD;AACjD,eAAO,MAAM,OAAO,QAAS,MAAM,KAAG,MAA0B,CAAC;AACjE,8DAA8D;AAC9D,eAAO,MAAM,OAAO,OAAQ,MAAM,KAAG,MAAqC,CAAC;AAE3E,kGAAkG;AAClG,MAAM,WAAW,WAAW;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAEzF,kGAAkG;AAClG,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3C,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,uCAAuC;IACvC,GAAG,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,wDAAwD;IACxD,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,4EAA4E;AAC5E,MAAM,WAAW,IAAI;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAK7E;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAenE;AAeD;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAEtF;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,wCAAwC;AACxC,eAAO,MAAM,KAAK,QAAS,MAAM,OAAO,MAAM,KAAG,MAAsC,CAAC"}

package/dist/anchors.js

@@ -0,0 +1,92 @@
+/** 914,400 EMU per inch, 96 px per inch. */
+export const EMU_PER_PX = 9525;
+/** EMU → px (9,525 EMU per pixel), unrounded. */
+export const emuToPx = (emu) => emu / EMU_PER_PX;
+/** px → EMU (9,525 EMU per pixel), rounded to a whole EMU. */
+export const pxToEmu = (px) => Math.round(px * EMU_PER_PX);
+const clamp = (v, lo, hi) => Math.min(Math.max(v, lo), hi);
+const finite = (n) => (Number.isFinite(n) ? n : 0);
+/**
+ * An anchor point in sheet space, placed through the grid's geometry. An offset never reaches past its own cell
+ * (Excel clamps it the same way).
+ *
+ * @param g - The grid's geometry (its column and row positions and sizes).
+ * @param p - The point: column, row and their EMU offsets.
+ * @returns The point's `{ x, y }` in px.
+ */
+export function pointToPx(g, p) {
+    return {
+        x: g.colX(p.col) + clamp(emuToPx(finite(p.colOff)), 0, g.colWidth(p.col)),
+        y: g.rowY(p.row) + clamp(emuToPx(finite(p.rowOff)), 0, g.rowHeight(p.row)),
+    };
+}
+/**
+ * The rectangle an anchor covers, or `undefined` when the anchor lacks what its kind needs.
+ * - twoCell: `from` to `to`, each with its offsets;
+ * - oneCell: `from` plus `ext`;
+ * - absolute: `pos` plus `ext`, from the sheet origin.
+ *
+ * @param a - The anchor (any drawing kind fits).
+ * @param g - The grid's geometry.
+ * @returns The rectangle in sheet space, or `undefined`.
+ */
+export function anchorRect(a, g) {
+    if (a.anchor === 'twoCell') {
+        if (!a.from || !a.to)
+            return undefined;
+        const p0 = pointToPx(g, a.from), p1 = pointToPx(g, a.to);
+        return { x: Math.min(p0.x, p1.x), y: Math.min(p0.y, p1.y), width: Math.abs(p1.x - p0.x), height: Math.abs(p1.y - p0.y) };
+    }
+    if (!a.ext)
+        return undefined;
+    const width = emuToPx(finite(a.ext.cx)), height = emuToPx(finite(a.ext.cy));
+    if (a.anchor === 'oneCell') {
+        if (!a.from)
+            return undefined;
+        const p = pointToPx(g, a.from);
+        return { x: p.x, y: p.y, width, height };
+    }
+    if (!a.pos)
+        return undefined;
+    return { x: emuToPx(finite(a.pos.x)), y: emuToPx(finite(a.pos.y)), width, height };
+}
+/** The last index in `[0, max)` whose start (`at(i)`) is at or before `v`. `at` must not decrease. */
+function indexAt(at, v, max) {
+    let lo = 0, hi = max - 1;
+    while (lo < hi) {
+        const mid = (lo + hi + 1) >> 1;
+        if (at(mid) <= v)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return lo;
+}
+const MAX_COLS = 16384;
+const MAX_ROWS = 1048576;
+/**
+ * The cell under a point in sheet space (px at 100 %); a negative coordinate counts as 0.
+ *
+ * @param g - The grid's geometry.
+ * @param x - Horizontal position, px.
+ * @param y - Vertical position, px.
+ * @returns The zero-based `{ row, col }`.
+ */
+export function cellAt(g, x, y) {
+    return { col: indexAt((c) => g.colX(c), Math.max(0, x), MAX_COLS), row: indexAt((r) => g.rowY(r), Math.max(0, y), MAX_ROWS) };
+}
+/**
+ * A column's letters: `0` → `A`, `25` → `Z`, `26` → `AA`.
+ *
+ * @param col - The column, 0-based.
+ * @returns Its letters.
+ */
+export function colLabel(col) {
+    let s = '';
+    for (let n = col + 1; n > 0; n = Math.floor((n - 1) / 26))
+        s = String.fromCharCode(65 + ((n - 1) % 26)) + s;
+    return s;
+}
+/** Zero-based row and column → `A1`. */
+export const refOf = (row, col) => `${colLabel(col)}${row + 1}`;
+//# sourceMappingURL=anchors.js.map

package/dist/anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { type OverlayItem, type Plugin, type PluginContext, type Geometry } from '@sheetpane/grid';
+import { MediaCache } from './media.js';
+export { EMU_PER_PX, emuToPx, pxToEmu, pointToPx, anchorRect, cellAt, colLabel, refOf } from './anchors.js';
+export type { Anchor, AnchorPoint, Rect } from './anchors.js';
+export { MediaCache, sniff, extensionOf, fileName, isUnsupportedPath } from './media.js';
+export type { MediaResult } from './media.js';
+/**
+ * The picture items of one sheet, with their rectangles in sheet space: one item per `picture` drawing with media
+ * and an area (charts and shapes are skipped). Exported for tests and for charts to model on.
+ *
+ * @param sheet - The sheet's name.
+ * @param ctx - The plugin context with the grid's geometry, as the `overlay` hook receives it.
+ * @param cache - Returns the media cache the items read their bytes through.
+ * @returns The overlay items; `alt` is the drawing's description, else its name.
+ */
+export declare function pictureItems(sheet: string, ctx: PluginContext & {
+    geometry: Geometry;
+}, cache: () => MediaCache): OverlayItem[];
+/**
+ * The pictures plugin: draws each picture anchored in the sheet through the `overlay` hook, view only. Bytes are
+ * read only when a picture nears the viewport; PNG, JPEG, GIF, BMP, WebP and SVG show through `<img>`, and EMF, WMF,
+ * TIFF or a missing part show a labelled "preview unavailable" frame. In Edit a click on a picture selects the cell
+ * under it. Export copies the drawings unchanged. One instance serves one pane; its object URLs are revoked when
+ * that pane loads another workbook. Importing this module registers it as `images`.
+ *
+ * @returns The plugin (`id: 'images'`), with a status count of the sheet's pictures.
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0107_IMAGES.md
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { images } from '@sheetpane/images';
+ *
+ * const book = createWorkbook({ plugins: [images()] });
+ * await book.load(bytes, 'catalogue.xlsx');
+ * ```
+ * @example
+ * ```ts
+ * import '@sheetpane/images'; // registers `images`
+ * excel.setAttribute('plugins', 'images');
+ * ```
+ */
+export declare function images(): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0C,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3I,OAAO,EAA+B,UAAU,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC5G,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACzF,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsB9C;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,EAAE,KAAK,EAAE,MAAM,UAAU,GAAG,WAAW,EAAE,CAa/H;AAuED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAiC/B"}

package/dist/index.js

@@ -0,0 +1,191 @@
+// @sheetpane/images — pictures anchored in the sheet, drawn in sheet space through the `overlay`
+// hook. View only: patch-mode export leaves the drawing and media parts as they were, so nothing
+// is lost and nothing is edited (W-20). Importing is safe in Node: no DOM until an item renders.
+import { registerPlugin } from '@sheetpane/grid';
+import { anchorRect, cellAt, refOf } from './anchors.js';
+import { fileName, isUnsupportedPath, MediaCache } from './media.js';
+export { EMU_PER_PX, emuToPx, pxToEmu, pointToPx, anchorRect, cellAt, colLabel, refOf } from './anchors.js';
+export { MediaCache, sniff, extensionOf, fileName, isUnsupportedPath } from './media.js';
+/** Each workbook gets a number, so item ids never repeat across two loads (the grid caches rendered items by id). */
+const generations = new WeakMap();
+let nextGeneration = 1;
+const generationOf = (book) => {
+    let g = generations.get(book);
+    if (!g) {
+        g = nextGeneration++;
+        generations.set(book, g);
+    }
+    return g;
+};
+const unavailable = (name) => `${name} — preview unavailable`;
+const FRAME = 'box-sizing:border-box;width:100%;height:100%;display:flex;align-items:center;justify-content:center;padding:4px;overflow:hidden;text-align:center;'
+    + 'border:1px dashed var(--sp-line-strong,#CBCBC5);background:var(--sp-sunken,#EFEFEB);color:var(--sp-ink-3,#63666E);font-size:12px;line-height:1.3;word-break:break-all';
+/**
+ * The picture items of one sheet, with their rectangles in sheet space: one item per `picture` drawing with media
+ * and an area (charts and shapes are skipped). Exported for tests and for charts to model on.
+ *
+ * @param sheet - The sheet's name.
+ * @param ctx - The plugin context with the grid's geometry, as the `overlay` hook receives it.
+ * @param cache - Returns the media cache the items read their bytes through.
+ * @returns The overlay items; `alt` is the drawing's description, else its name.
+ */
+export function pictureItems(sheet, ctx, cache) {
+    const s = ctx.book.sheets.find((x) => x.name === sheet);
+    if (!s)
+        return [];
+    const gen = generationOf(ctx.book);
+    const items = [];
+    s.drawings.forEach((d, i) => {
+        if (d.kind !== 'picture' || !d.media)
+            return;
+        const rect = anchorRect(d, ctx.geometry);
+        if (!rect || rect.width <= 0 || rect.height <= 0)
+            return;
+        const name = d.name || fileName(d.media);
+        items.push({ id: `pic:${gen}:${i}:${d.media}`, sheet, rect, alt: d.descr || name, render: () => renderPicture(d, d.descr || name, rect, sheet, ctx, cache) });
+    });
+    return items;
+}
+function renderPicture(d, alt, rect, sheet, ctx, cache) {
+    const media = d.media, file = fileName(media);
+    const root = document.createElement('div');
+    root.className = 'sp-picture';
+    root.style.cssText = 'position:relative;width:100%;height:100%;overflow:hidden';
+    root.dataset.media = media;
+    const frame = (text, state) => {
+        const f = document.createElement('div');
+        f.className = 'sp-picture-frame';
+        f.dataset.state = state;
+        f.style.cssText = FRAME;
+        f.textContent = text;
+        return f;
+    };
+    const show = (el) => root.replaceChildren(el);
+    // Edit: a click on a picture selects the cell under it, so that cell can still be flagged.
+    root.addEventListener('click', (e) => {
+        if (ctx.store.getSnapshot().mode !== 'edit')
+            return;
+        const r = root.getBoundingClientRect();
+        if (!r.width || !r.height)
+            return;
+        const x = rect.x + ((e.clientX - r.left) / r.width) * rect.width, y = rect.y + ((e.clientY - r.top) / r.height) * rect.height;
+        const c = cellAt(ctx.geometry, x, y);
+        ctx.store.select({ sheet, ref: refOf(c.row, c.col) });
+    });
+    // EMF, WMF and the like are known by name: a labelled frame, nothing read.
+    if (isUnsupportedPath(media)) {
+        show(frame(unavailable(file), 'unavailable'));
+        return root;
+    }
+    // Everything else: a frame now, the bytes when the picture first scrolls near the screen.
+    show(frame(file, 'pending'));
+    let started = false;
+    const start = () => {
+        if (started)
+            return;
+        started = true;
+        void cache().get(media).then((m) => {
+            if (m.kind === 'unsupported')
+                return show(frame(unavailable(file), 'unavailable'));
+            if (m.kind === 'missing')
+                return show(frame(unavailable(file), 'missing'));
+            const img = document.createElement('img');
+            img.alt = alt;
+            img.decoding = 'async';
+            img.draggable = false;
+            img.style.cssText = 'display:block;width:100%;height:100%;object-fit:fill;user-select:none';
+            img.addEventListener('load', () => show(img), { once: true });
+            img.addEventListener('error', () => show(frame(unavailable(file), 'unavailable')), { once: true });
+            img.src = m.url;
+        });
+    };
+    if (typeof IntersectionObserver === 'undefined')
+        queueMicrotask(start);
+    else {
+        const io = new IntersectionObserver((entries) => { if (entries.some((e) => e.isIntersecting)) {
+            io.disconnect();
+            start();
+        } }, { rootMargin: '300px' });
+        io.observe(root);
+    }
+    return root;
+}
+const picturesOn = (book, sheet) => book?.sheets.find((s) => s.name === sheet)?.drawings.filter((d) => d.kind === 'picture' && d.media) ?? [];
+const status = {
+    id: 'images-status', slot: 'status', group: 'images', label: 'Pictures', mode: 'both',
+    text: (snap, sel) => {
+        const pics = picturesOn(snap.book, sel.sheet);
+        if (!pics.length)
+            return '';
+        const bad = pics.filter((d) => isUnsupportedPath(d.media)).length;
+        return `${pics.length} ${pics.length === 1 ? 'picture' : 'pictures'}${bad ? ` · ${bad} preview unavailable` : ''}`;
+    },
+};
+/**
+ * The pictures plugin: draws each picture anchored in the sheet through the `overlay` hook, view only. Bytes are
+ * read only when a picture nears the viewport; PNG, JPEG, GIF, BMP, WebP and SVG show through `<img>`, and EMF, WMF,
+ * TIFF or a missing part show a labelled "preview unavailable" frame. In Edit a click on a picture selects the cell
+ * under it. Export copies the drawings unchanged. One instance serves one pane; its object URLs are revoked when
+ * that pane loads another workbook. Importing this module registers it as `images`.
+ *
+ * @returns The plugin (`id: 'images'`), with a status count of the sheet's pictures.
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0107_IMAGES.md
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { images } from '@sheetpane/images';
+ *
+ * const book = createWorkbook({ plugins: [images()] });
+ * await book.load(bytes, 'catalogue.xlsx');
+ * ```
+ * @example
+ * ```ts
+ * import '@sheetpane/images'; // registers `images`
+ * excel.setAttribute('plugins', 'images');
+ * ```
+ */
+export function images() {
+    const states = new WeakMap();
+    const stateFor = (store) => {
+        let st = states.get(store);
+        if (!st) {
+            const s = { book: store.book, cache: undefined };
+            st = s;
+            states.set(store, s);
+            // A replaced workbook (or a failed load) frees every object URL made for the old one.
+            store.subscribe(() => {
+                if (s.book === store.book)
+                    return;
+                s.cache?.revoke();
+                s.book = store.book;
+                s.cache = undefined;
+            });
+        }
+        return st;
+    };
+    return {
+        id: 'images',
+        provides: ['overlay'],
+        controls: [status],
+        overlay(sheet, ctx) {
+            const st = stateFor(ctx.store);
+            if (st.book !== ctx.book) {
+                st.cache?.revoke();
+                st.book = ctx.book;
+                st.cache = undefined;
+            }
+            const book = ctx.book;
+            return pictureItems(sheet, ctx, () => {
+                // A picture that decodes after its workbook went gets a closed cache and shows the missing frame.
+                if (st.book !== book) {
+                    const dead = new MediaCache(book);
+                    dead.revoke();
+                    return dead;
+                }
+                return (st.cache ??= new MediaCache(book));
+            });
+        },
+    };
+}
+registerPlugin('images', () => images());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,iGAAiG;AACjG,iGAAiG;AACjG,OAAO,EAAE,cAAc,EAA4F,MAAM,iBAAiB,CAAC;AAC3I,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE5G,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOzF,qHAAqH;AACrH,MAAM,WAAW,GAAG,IAAI,OAAO,EAAkB,CAAC;AAClD,IAAI,cAAc,GAAG,CAAC,CAAC;AACvB,MAAM,YAAY,GAAG,CAAC,IAAU,EAAU,EAAE;IAC1C,IAAI,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,EAAE,CAAC;QAAC,CAAC,GAAG,cAAc,EAAE,CAAC;QAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAIF,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,IAAI,wBAAwB,CAAC;AAEtE,MAAM,KAAK,GAAG,oJAAoJ;MAC9J,uKAAuK,CAAC;AAE5K;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,GAA2C,EAAE,KAAuB;IAC9G,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IACxD,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK;YAAE,OAAO;QAC7C,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO;QACzD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAChK,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,CAAU,EAAE,GAAW,EAAE,IAAyB,EAAE,KAAa,EAAE,GAA2C,EAAE,KAAuB;IAC5J,MAAM,KAAK,GAAG,CAAC,CAAC,KAAM,EAAE,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,0DAA0D,CAAC;IAChF,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,KAAa,EAAe,EAAE;QACzD,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,SAAS,GAAG,kBAAkB,CAAC;QACjC,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QACxB,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,EAAe,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAE3D,2FAA2F;IAC3F,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QACnC,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO;QACpD,MAAM,CAAC,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM;YAAE,OAAO;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAC9H,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAE7F,0FAA0F;IAC1F,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,KAAK,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACjC,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;YACnF,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;YAC3E,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC1C,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;YACd,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC;YACvB,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC;YACtB,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,uEAAuE,CAAC;YAC5F,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACnG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,IAAI,OAAO,oBAAoB,KAAK,WAAW;QAAE,cAAc,CAAC,KAAK,CAAC,CAAC;SAClE,CAAC;QACJ,MAAM,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC;YAAC,EAAE,CAAC,UAAU,EAAE,CAAC;YAAC,KAAK,EAAE,CAAC;QAAC,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QACxJ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAsB,EAAE,KAAa,EAAa,EAAE,CACtE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AAE5G,MAAM,MAAM,GAAsB;IAChC,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM;IACrF,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAClB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACnE,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACrH,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,MAAM;IACpB,MAAM,MAAM,GAAG,IAAI,OAAO,EAAqB,CAAC;IAChD,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAc,EAAE;QAC5C,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,CAAC,GAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC7D,EAAE,GAAG,CAAC,CAAC;YACP,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACrB,sFAAsF;YACtF,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnB,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;oBAAE,OAAO;gBAClC,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBAClB,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBACpB,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IACF,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,OAAO,CAAC,KAAK,EAAE,GAAG;YAChB,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;gBAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBAAC,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;gBAAC,EAAE,CAAC,KAAK,GAAG,SAAS,CAAC;YAAC,CAAC;YAC3F,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YACtB,OAAO,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;gBACnC,kGAAkG;gBAClG,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBAAC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;oBAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBAAC,OAAO,IAAI,CAAC;gBAAC,CAAC;gBACxF,OAAO,CAAC,EAAE,CAAC,KAAK,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC"}

package/dist/media.d.ts

@@ -0,0 +1,61 @@
+import type { PluginContext } from '@sheetpane/grid';
+type Book = PluginContext['book'];
+/** What a media part turned out to be: a drawable image with its object URL, a format no browser draws, or missing. */
+export type MediaResult = 
+/** The browser can draw it. */
+{
+    kind: 'image';
+    url: string;
+    mime: string;
+}
+/** A format a browser cannot draw (EMF, WMF, TIFF …): the item shows a labelled frame. */
+ | {
+    kind: 'unsupported';
+    format: string;
+}
+/** The part is missing from the package, or the cache was closed while it was being read. */
+ | {
+    kind: 'missing';
+};
+/** `xl/media/image1.PNG` → `png`. */
+export declare const extensionOf: (path: string) => string;
+/** The part's file name, for labels: `xl/media/logo.emf` → `logo.emf`. */
+export declare const fileName: (path: string) => string;
+/**
+ * Whether the extension alone says a browser cannot draw the part — no bytes need reading to know.
+ *
+ * @param path - The media part's path, e.g. `xl/media/image1.emf`.
+ * @returns `true` for anything but PNG, JPEG, GIF, SVG, BMP or WebP.
+ */
+export declare function isUnsupportedPath(path: string): boolean;
+/**
+ * What the bytes are, by their signature — the file name lies more often than the header. Unrecognised bytes fall
+ * back to the extension.
+ *
+ * @param bytes - The part's bytes.
+ * @param path - The part's path, for the fallback.
+ * @returns `{ mime }` for a format `<img>` draws, else `{ format }` (`emf`, `wmf`, `tiff`, the extension, or `unknown`).
+ */
+export declare function sniff(bytes: Uint8Array, path: string): {
+    mime: string;
+} | {
+    format: string;
+};
+/** The object URLs made for one workbook. Closed (`revoke()`) when the workbook is replaced. */
+export declare class MediaCache {
+    private readonly book;
+    private readonly results;
+    private readonly urls;
+    private closed;
+    constructor(book: Book);
+    get isClosed(): boolean;
+    /** How many object URLs are alive. */
+    get size(): number;
+    /** Reads the part on first ask; every later ask for the same part shares the answer. */
+    get(path: string): Promise<MediaResult>;
+    private load;
+    /** Frees every object URL and refuses new ones. Safe to call twice. */
+    revoke(): void;
+}
+export {};
+//# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,KAAK,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAElC,uHAAuH;AACvH,MAAM,MAAM,WAAW;AACrB,+BAA+B;AAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC9C,0FAA0F;GACxF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACzC,6FAA6F;GAC3F;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAMxB,qCAAqC;AACrC,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,MAAkE,CAAC;AAE9G,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,SAAU,MAAM,KAAG,MAA+C,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAID;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAc5F;AAED,gGAAgG;AAChG,qBAAa,UAAU;IAKT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,MAAM,CAAS;IAEvB,YAA6B,IAAI,EAAE,IAAI,EAAI;IAE3C,IAAI,QAAQ,IAAI,OAAO,CAAwB;IAC/C,sCAAsC;IACtC,IAAI,IAAI,IAAI,MAAM,CAA2B;IAE7C,wFAAwF;IACxF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAKtC;YAEa,IAAI;IAYlB,uEAAuE;IACvE,MAAM,IAAI,IAAI,CAKb;CACF"}

package/dist/media.js

@@ -0,0 +1,100 @@
+const BY_EXTENSION = {
+    png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', jpe: 'image/jpeg', gif: 'image/gif', svg: 'image/svg+xml', bmp: 'image/bmp', webp: 'image/webp',
+};
+/** `xl/media/image1.PNG` → `png`. */
+export const extensionOf = (path) => /\.([A-Za-z0-9]+)$/.exec(path)?.[1]?.toLowerCase() ?? '';
+/** The part's file name, for labels: `xl/media/logo.emf` → `logo.emf`. */
+export const fileName = (path) => path.slice(path.lastIndexOf('/') + 1);
+/**
+ * Whether the extension alone says a browser cannot draw the part — no bytes need reading to know.
+ *
+ * @param path - The media part's path, e.g. `xl/media/image1.emf`.
+ * @returns `true` for anything but PNG, JPEG, GIF, SVG, BMP or WebP.
+ */
+export function isUnsupportedPath(path) {
+    return !(extensionOf(path) in BY_EXTENSION);
+}
+const startsWith = (b, sig, at = 0) => sig.every((v, i) => b[at + i] === v);
+/**
+ * What the bytes are, by their signature — the file name lies more often than the header. Unrecognised bytes fall
+ * back to the extension.
+ *
+ * @param bytes - The part's bytes.
+ * @param path - The part's path, for the fallback.
+ * @returns `{ mime }` for a format `<img>` draws, else `{ format }` (`emf`, `wmf`, `tiff`, the extension, or `unknown`).
+ */
+export function sniff(bytes, path) {
+    if (startsWith(bytes, [0x89, 0x50, 0x4e, 0x47]))
+        return { mime: 'image/png' };
+    if (startsWith(bytes, [0xff, 0xd8, 0xff]))
+        return { mime: 'image/jpeg' };
+    if (startsWith(bytes, [0x47, 0x49, 0x46, 0x38]))
+        return { mime: 'image/gif' };
+    if (startsWith(bytes, [0x42, 0x4d]) && extensionOf(path) !== 'svg')
+        return { mime: 'image/bmp' };
+    if (startsWith(bytes, [0x52, 0x49, 0x46, 0x46]) && startsWith(bytes, [0x57, 0x45, 0x42, 0x50], 8))
+        return { mime: 'image/webp' };
+    if (startsWith(bytes, [0x20, 0x45, 0x4d, 0x46], 40))
+        return { format: 'emf' };
+    if (startsWith(bytes, [0xd7, 0xcd, 0xc6, 0x9a]) || startsWith(bytes, [0x01, 0x00, 0x09, 0x00]) || startsWith(bytes, [0x02, 0x00, 0x09, 0x00]))
+        return { format: 'wmf' };
+    if (startsWith(bytes, [0x49, 0x49, 0x2a, 0x00]) || startsWith(bytes, [0x4d, 0x4d, 0x00, 0x2a]))
+        return { format: 'tiff' };
+    const head = new TextDecoder().decode(bytes.subarray(0, 1024));
+    if (/<svg[\s>]/i.test(head))
+        return { mime: 'image/svg+xml' };
+    // Unrecognised bytes: trust the extension; a lie there fails in <img> and shows the labelled frame.
+    const mime = BY_EXTENSION[extensionOf(path)];
+    return mime ? { mime } : { format: extensionOf(path) || 'unknown' };
+}
+/** The object URLs made for one workbook. Closed (`revoke()`) when the workbook is replaced. */
+export class MediaCache {
+    book;
+    results = new Map();
+    urls = new Set();
+    closed = false;
+    constructor(book) {
+        this.book = book;
+    }
+    get isClosed() { return this.closed; }
+    /** How many object URLs are alive. */
+    get size() { return this.urls.size; }
+    /** Reads the part on first ask; every later ask for the same part shares the answer. */
+    get(path) {
+        if (this.closed)
+            return Promise.resolve({ kind: 'missing' });
+        let p = this.results.get(path);
+        if (!p) {
+            p = this.load(path);
+            this.results.set(path, p);
+        }
+        return p;
+    }
+    async load(path) {
+        let bytes;
+        try {
+            bytes = await this.book.part(path);
+        }
+        catch {
+            return { kind: 'missing' };
+        }
+        if (this.closed || !bytes)
+            return { kind: 'missing' };
+        const s = sniff(bytes, path);
+        if ('format' in s)
+            return { kind: 'unsupported', format: s.format };
+        // A picture is only ever shown through an <img> (SVG included): no script in it can run.
+        const url = URL.createObjectURL(new Blob([bytes], { type: s.mime }));
+        this.urls.add(url);
+        return { kind: 'image', url, mime: s.mime };
+    }
+    /** Frees every object URL and refuses new ones. Safe to call twice. */
+    revoke() {
+        this.closed = true;
+        for (const u of this.urls)
+            URL.revokeObjectURL(u);
+        this.urls.clear();
+        this.results.clear();
+    }
+}
+//# sourceMappingURL=media.js.map

package/dist/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@sheetpane/images",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.3.0",
+  "description": "Images for sheetpane — pictures anchored in the sheet drawn in sheet space through the `overlay` hook; view only, kept on export.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arpitarya/sheetpane.git",
+    "directory": "packages/images"
+  },
+  "type": "module",
+  "sideEffects": [
+    "./dist/index.js",
+    "./src/index.ts"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@sheetpane/grid": "0.3.0"
+  },
+  "dependencies": {
+    "@sheetpane/skills": "0.3.0"
+  },
+  "devDependencies": {
+    "@sheetpane/grid": "0.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }