@embedpdf/react 3.0.0-next.14 → 3.0.0-next.16

package/dist/stage.js

@@ -1,229 +1,4 @@
-import "./rolldown-runtime-BBjsoOtd.js";
-import { PageProvider, makePageContext, useCapability, useDocumentId, useKernelValue, useOptionalCapability, useSelector } from "./runtime.js";
-import { ProjectorProvider } from "./anchored.js";
-import { jsx, jsxs } from "react/jsx-runtime";
-import { useLayoutEffect, useMemo, useRef } from "react";
-import { createStageSurface } from "@embedpdf/web";
-import { StageToken, createScrollHandler, settingsEqual } from "@embedpdf/plugin-stage";
-import { InteractionToken } from "@embedpdf/plugin-interaction/contract";
+import { n as useStageToken, t as StageScope } from "./stage-scope-D7ZeNduT.js";
+import { a as useStageState, i as useStageSettings, n as useStage, o as Scrollbar, r as useStageEvent, s as useScrollMetrics, t as Stage } from "./stage-BqfBjDu6.js";
 export * from "@embedpdf/plugin-stage";
-//#region src/stage.tsx
-function PageSurface({ documentId, page, frame, stage, render, chrome }) {
-	const ref = useRef(null);
-	const t = page.transform;
-	const rotation = page.rotation;
-	const outerW = t.viewWidth + frame.left + frame.right;
-	const outerH = t.viewHeight + frame.top + frame.bottom;
-	const left = page.screenX - frame.left;
-	const top = page.screenY - frame.top;
-	const contentLeft = frame.left + (t.viewWidth - t.contentWidth) / 2;
-	const contentTop = frame.top + (t.viewHeight - t.contentHeight) / 2;
-	const ctx = useMemo(() => makePageContext(documentId, stage.lensId(), page.pon, page.pageIndex, frame, t, () => ref.current.getBoundingClientRect(), () => {
-		const live = stage.visiblePages().find((p) => p.pon === page.pon);
-		return live ? {
-			desiredDeviceWidth: live.transform.deviceWidth,
-			visibleRect: live.visibleRect
-		} : {
-			desiredDeviceWidth: t.deviceWidth,
-			visibleRect: {
-				x: 0,
-				y: 0,
-				width: 0,
-				height: 0
-			}
-		};
-	}), [
-		documentId,
-		page.pon,
-		page.pageIndex,
-		frame,
-		t,
-		stage
-	]);
-	return /* @__PURE__ */ jsx("div", {
-		style: {
-			position: "absolute",
-			left,
-			top,
-			width: outerW,
-			height: outerH
-		},
-		children: /* @__PURE__ */ jsxs(PageProvider, {
-			value: ctx,
-			children: [
-				/* @__PURE__ */ jsx("div", { style: {
-					position: "absolute",
-					left: frame.left,
-					top: frame.top,
-					width: t.viewWidth,
-					height: t.viewHeight,
-					boxShadow: "var(--epdf-page-shadow, 0 6px 18px rgba(0,0,0,.18))"
-				} }),
-				/* @__PURE__ */ jsx("div", {
-					ref,
-					style: {
-						position: "absolute",
-						left: contentLeft,
-						top: contentTop,
-						width: t.contentWidth,
-						height: t.contentHeight,
-						background: "#fff",
-						transform: rotation ? `rotate(${rotation}deg)` : void 0,
-						userSelect: "none",
-						WebkitUserSelect: "none"
-					},
-					children: render(ctx)
-				}),
-				chrome?.(ctx)
-			]
-		})
-	});
-}
-function Stage({ children, pageChrome, overlay, interaction = true, panFallback = true, zoomGestures = true, token = StageToken, className, style }) {
-	const stage = useCapability(token);
-	const ix = useOptionalCapability(InteractionToken);
-	const useHub = interaction && !!ix;
-	const hubCursor = useKernelValue(() => ix?.cursor() ?? "default");
-	const ref = useRef(null);
-	const docId = useDocumentId();
-	const pages = useSelector(token, (c) => c.visiblePages());
-	const frame = useSelector(token, (c) => c.pageFrame(), (a, b) => a.top === b.top && a.right === b.right && a.bottom === b.bottom && a.left === b.left);
-	const projector = useMemo(() => ({
-		space: "overlay",
-		toScreen: (pon, rect) => stage.pageRectToScreen(pon, rect),
-		toScreenPoint: (pon, at) => {
-			const r = stage.pageRectToScreen(pon, {
-				x: at.x,
-				y: at.y,
-				width: 0,
-				height: 0
-			});
-			return r ? {
-				x: r.x,
-				y: r.y
-			} : null;
-		},
-		viewEnv: (pon) => {
-			const t = stage.pageRect(pon)?.transform;
-			return t ? {
-				scale: t.viewScale,
-				rotation: t.rotation,
-				zoom: t.zoom
-			} : null;
-		}
-	}), [stage]);
-	const projectorBinding = useMemo(() => ({
-		projector,
-		revision: pages
-	}), [projector, pages]);
-	useLayoutEffect(() => {
-		const el = ref.current;
-		const detachSurface = createStageSurface(el, stage, {
-			hub: useHub ? ix : null,
-			source: stage.lensId(),
-			zoomGestures
-		});
-		const offScroll = useHub && ix ? ix.registerHandler(createScrollHandler(stage, ix, { panFallback }), { source: stage.lensId() }) : null;
-		return () => {
-			offScroll?.();
-			detachSurface();
-		};
-	}, [
-		stage,
-		ix,
-		useHub,
-		zoomGestures,
-		panFallback
-	]);
-	return /* @__PURE__ */ jsxs("div", {
-		ref,
-		className,
-		style: {
-			position: "relative",
-			overflow: "hidden",
-			touchAction: "none",
-			...useHub ? { cursor: hubCursor } : null,
-			...style
-		},
-		children: [pages.map((p) => /* @__PURE__ */ jsx(PageSurface, {
-			documentId: docId ?? "",
-			page: p,
-			frame,
-			stage,
-			render: children,
-			chrome: pageChrome
-		}, p.pon)), /* @__PURE__ */ jsx(ProjectorProvider, {
-			value: projectorBinding,
-			children: overlay
-		})]
-	});
-}
-function useStage(token = StageToken) {
-	return useCapability(token);
-}
-function useZoom(token = StageToken) {
-	const s = useCapability(token);
-	return {
-		zoom: useSelector(token, (c) => c.zoomLevel()),
-		/** Active zoom intent: 'automatic' | 'fit-page' | 'fit-width' | 'fit-all' | 'custom'. */
-		mode: useSelector(token, (c) => c.zoomMode()),
-		zoomIn: s.zoomIn,
-		zoomOut: s.zoomOut,
-		fitWidth: s.fitWidth,
-		fitPage: s.fitPage,
-		fitAll: s.fitAll,
-		automatic: s.automatic,
-		zoomTo: s.zoomTo
-	};
-}
-function usePages(token = StageToken) {
-	const s = useCapability(token);
-	return {
-		currentPage: useSelector(token, (c) => c.currentPage()),
-		pageCount: useSelector(token, (c) => c.pageCount()),
-		goToPage: s.goToPage,
-		next: s.next,
-		prev: s.prev,
-		reveal: s.reveal
-	};
-}
-function useLayout(token = StageToken) {
-	const s = useCapability(token);
-	return {
-		flow: useSelector(token, (c) => c.flow()),
-		layout: useSelector(token, (c) => c.layout()),
-		spread: useSelector(token, (c) => c.spread()),
-		sizing: useSelector(token, (c) => c.sizing()),
-		bounded: useSelector(token, (c) => c.bounded()),
-		setFlow: s.setFlow,
-		setLayout: s.setLayout,
-		setSpread: s.setSpread,
-		setSizing: s.setSizing,
-		setBounded: s.setBounded
-	};
-}
-/** The document's page list (with PDF labels) + the current item's pages — the
-*  data for page thumbnails / worksheet-style page tabs. */
-function usePageList(token = StageToken) {
-	return {
-		pages: useSelector(token, (c) => c.pages(), (a, b) => a.length === b.length && a.every((p, i) => p.pon === b[i].pon && p.label === b[i].label)),
-		currentItemPages: useSelector(token, (c) => c.currentItemPages(), (a, b) => a.length === b.length && a.every((x, i) => x === b[i]))
-	};
-}
-/**
-* All Stage settings + the batch `update`. This is the seam for "presets are a
-* customer concern": keep your own `Partial<StageSettings>` objects and apply them
-* with `update(preset)` (one anchor-preserving change).
-*/
-function useStageSettings(token = StageToken) {
-	const s = useCapability(token);
-	return {
-		settings: useSelector(token, (c) => c.settings(), settingsEqual),
-		update: s.update,
-		reset: s.resetView
-	};
-}
-//#endregion
-export { Stage, useLayout, usePageList, usePages, useStage, useStageSettings, useZoom };
-
-//# sourceMappingURL=stage.js.map
+export { Scrollbar, Stage, StageScope, useScrollMetrics, useStage, useStageEvent, useStageSettings, useStageState, useStageToken };

package/dist/stamp.cjs

@@ -1,66 +1,70 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("./rolldown-runtime-DDXJien1.cjs");
-const require_runtime = require("./runtime.cjs");
-let react = require("react");
+const require_runtime = require("./runtime-BfnpyfY0.cjs");
+const require_state = require("./state-Dtf8HAue.cjs");
 let _embedpdf_web = require("@embedpdf/web");
+let react = require("react");
 let _embedpdf_plugin_stamp = require("@embedpdf/plugin-stamp");
 //#region src/stamp.tsx
-/** The stamp capability (workspace-scoped: one library set for every document). */
+/**
+* The stamp capability. Libraries are shared by every document; the placing
+* verbs act on the document this component is in.
+*/
 function useStamp() {
 	return require_runtime.useCapability(_embedpdf_plugin_stamp.StampToken);
 }
+/** Subscribe to one stamp event for the mounted lifetime: `useStampEvent((stamp) => stamp.onAssetCreated, handler)`. */
+function useStampEvent(select, handler) {
+	require_runtime.useCapabilityEvent(_embedpdf_plugin_stamp.StampToken, select, handler);
+}
+/**
+* The stamps' state for this component's document: the armed stamp (the
+* page's State table, declared once in `stampState`). Takes a selector, and
+* re-renders only when what it returns changes.
+*/
+const useStampState = require_state.stateHook(_embedpdf_plugin_stamp.stampState);
+/** The stamp settings (`assetEngine`, `previewWidth`, `dynamic`), with or without a document. Takes a selector. */
+const useStampSettings = require_state.settingsHook(_embedpdf_plugin_stamp.StampToken);
 /** Libraries, optionally of one kind or several (`{ kind: 'stamps' }`, `{ kind: ['stamps', 'toolbar'] }`). */
-function useStampLibraries(query) {
-	const kinds = query?.kind === void 0 ? void 0 : [].concat(query.kind).join("\0");
-	return require_runtime.useSelector(_embedpdf_plugin_stamp.StampToken, (c) => c.libraries(kinds === void 0 ? void 0 : { kind: kinds.split("\0") }), require_runtime.shallowArray);
+function useStampLibraries(filter) {
+	const kinds = filter?.kind === void 0 ? void 0 : [].concat(filter.kind).join("\0");
+	return require_runtime.useSelector(_embedpdf_plugin_stamp.StampToken, (stamp) => stamp.listLibraries(kinds === void 0 ? void 0 : { kind: kinds.split("\0") }), require_runtime.shallowArray);
 }
-/** Assets of one library, or every asset when `libraryId` is omitted. */
-function useStampAssets(libraryId) {
-	return require_runtime.useSelector(_embedpdf_plugin_stamp.StampToken, (c) => c.assets(libraryId), require_runtime.shallowArray);
+/** The stamps of one library (`{ libraryId }`), of one kind or category, or every stamp. */
+function useStampAssets(filter) {
+	const libraryId = filter?.libraryId;
+	const kind = filter?.kind;
+	const category = filter?.category;
+	return require_runtime.useSelector(_embedpdf_plugin_stamp.StampToken, (stamp) => stamp.listAssets({
+		libraryId,
+		kind,
+		category
+	}), require_runtime.shallowArray);
 }
 /**
 * Object URL for an asset's cached preview (gallery thumbnails). The plugin
-* holds the preview BYTES; the URL — a DOM resource — is created here and
+* holds the preview bytes; the URL — a DOM resource — is created here and
 * revoked on unmount/asset change, mirroring `<AnnotationLayer>`'s rule that
 * object-URL lifetime belongs to the framework layer.
 */
 function useStampAssetPreviewUrl(assetId) {
-	const stamp = require_runtime.useCapability(_embedpdf_plugin_stamp.StampToken);
+	const stamp = useStamp();
 	const [url, setUrl] = (0, react.useState)(null);
 	(0, react.useEffect)(() => {
-		const preview = assetId ? stamp.assetPreview(assetId) : null;
+		const preview = assetId ? stamp.getAssetPreview(assetId) : null;
 		if (!preview) {
 			setUrl(null);
 			return;
 		}
-		const body = new ArrayBuffer(preview.bytes.byteLength);
-		new Uint8Array(body).set(preview.bytes);
-		const obj = URL.createObjectURL(new Blob([body], { type: preview.mimeType }));
-		setUrl(obj);
+		const objectUrl = (0, _embedpdf_web.objectUrlOf)(preview);
+		setUrl(objectUrl.url);
 		return () => {
-			URL.revokeObjectURL(obj);
+			objectUrl.revoke();
 			setUrl(null);
 		};
 	}, [stamp, assetId]);
 	return url;
 }
-/**
-* Arm/disarm assets against the nearest `<DocumentScope>` (or the active
-* document) — the one-liner a gallery item's onClick needs.
-*/
-function useArmStampAsset() {
-	const stamp = require_runtime.useCapability(_embedpdf_plugin_stamp.StampToken);
-	const documentId = require_runtime.useDocumentId();
-	return {
-		armAsset: (assetId, opts) => {
-			if (!documentId) return Promise.reject(/* @__PURE__ */ new Error("[stamp] no document in scope"));
-			return stamp.armAsset(documentId, assetId, opts);
-		},
-		disarm: () => {
-			if (documentId) stamp.disarm(documentId);
-		}
-	};
-}
 //#endregion
 Object.defineProperty(exports, "indexedDbByteStore", {
 	enumerable: true,
@@ -68,11 +72,13 @@ Object.defineProperty(exports, "indexedDbByteStore", {
 		return _embedpdf_web.indexedDbByteStore;
 	}
 });
-exports.useArmStampAsset = useArmStampAsset;
 exports.useStamp = useStamp;
 exports.useStampAssetPreviewUrl = useStampAssetPreviewUrl;
 exports.useStampAssets = useStampAssets;
+exports.useStampEvent = useStampEvent;
 exports.useStampLibraries = useStampLibraries;
+exports.useStampSettings = useStampSettings;
+exports.useStampState = useStampState;
 Object.keys(_embedpdf_plugin_stamp).forEach(function(k) {
 	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,

package/dist/stamp.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"stamp.cjs","names":["useCapability","StampToken","useSelector","shallowArray","useDocumentId"],"sources":["../src/stamp.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-stamp.\n *\n * Thin by design: the plugin owns the store (libraries/assets) and the binary\n * sidecar (bytes + cached previews); this file only exposes hooks and owns the\n * DOM-side object-URL lifetime for gallery thumbnails. Placement UI needs no\n * component here — arming rides the annotation plugin, whose `<AnnotationLayer>`\n * already renders the hover ghost.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-stamp';\n// The browser store for `persistStampLibraries` / `restoreStampLibraries`\n// (structurally the plugin's `StampLibraryStore`), written once in `@embedpdf/web`.\nexport { indexedDbByteStore } from '@embedpdf/web';\nexport type { ByteStore } from '@embedpdf/web';\nimport { useEffect, useState } from 'react';\nimport {\n  StampToken,\n  type StampAsset,\n  type StampLibrary,\n  type StampLibraryQuery,\n} from '@embedpdf/plugin-stamp';\nimport { shallowArray, useCapability, useDocumentId, useSelector } from './runtime';\n\n/** The stamp capability (workspace-scoped: one library set for every document). */\nexport function useStamp() {\n  return useCapability(StampToken);\n}\n\n/** Libraries, optionally of one kind or several (`{ kind: 'stamps' }`, `{ kind: ['stamps', 'toolbar'] }`). */\nexport function useStampLibraries(query?: StampLibraryQuery): StampLibrary[] {\n  const kinds = query?.kind === undefined ? undefined : ([] as string[]).concat(query.kind).join('\\u0000');\n  return useSelector(\n    StampToken,\n    (c) => c.libraries(kinds === undefined ? undefined : { kind: kinds.split('\\u0000') }),\n    shallowArray,\n  );\n}\n\n/** Assets of one library, or every asset when `libraryId` is omitted. */\nexport function useStampAssets(libraryId?: string): StampAsset[] {\n  return useSelector(StampToken, (c) => c.assets(libraryId), shallowArray);\n}\n\n/**\n * Object URL for an asset's cached preview (gallery thumbnails). The plugin\n * holds the preview BYTES; the URL — a DOM resource — is created here and\n * revoked on unmount/asset change, mirroring `<AnnotationLayer>`'s rule that\n * object-URL lifetime belongs to the framework layer.\n */\nexport function useStampAssetPreviewUrl(assetId: string | null): string | null {\n  const stamp = useCapability(StampToken);\n  const [url, setUrl] = useState<string | null>(null);\n  useEffect(() => {\n    const preview = assetId ? stamp.assetPreview(assetId) : null;\n    if (!preview) {\n      setUrl(null);\n      return;\n    }\n    // Copy into an EXACT ArrayBuffer (the engine idiom) before Blob-wrapping.\n    const body = new ArrayBuffer(preview.bytes.byteLength);\n    new Uint8Array(body).set(preview.bytes);\n    const obj = URL.createObjectURL(new Blob([body], { type: preview.mimeType }));\n    setUrl(obj);\n    return () => {\n      URL.revokeObjectURL(obj);\n      setUrl(null);\n    };\n  }, [stamp, assetId]);\n  return url;\n}\n\n/**\n * Arm/disarm assets against the nearest `<DocumentScope>` (or the active\n * document) — the one-liner a gallery item's onClick needs.\n */\nexport function useArmStampAsset(): {\n  armAsset: (assetId: string, opts?: { targetWidth?: number }) => Promise<void>;\n  disarm: () => void;\n} {\n  const stamp = useCapability(StampToken);\n  const documentId = useDocumentId();\n  return {\n    armAsset: (assetId, opts) => {\n      if (!documentId) return Promise.reject(new Error('[stamp] no document in scope'));\n      return stamp.armAsset(documentId, assetId, opts);\n    },\n    disarm: () => {\n      if (documentId) stamp.disarm(documentId);\n    },\n  };\n}\n"],"mappings":";;;;;;;;AA0BA,SAAgB,WAAW;CACzB,OAAOA,gBAAAA,cAAcC,uBAAAA,UAAU;AACjC;;AAGA,SAAgB,kBAAkB,OAA2C;CAC3E,MAAM,QAAQ,OAAO,SAAS,KAAA,IAAY,KAAA,IAAa,CAAC,CAAC,CAAc,OAAO,MAAM,IAAI,CAAC,CAAC,KAAK,IAAQ;CACvG,OAAOC,gBAAAA,YACLD,uBAAAA,aACC,MAAM,EAAE,UAAU,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,MAAM,MAAM,MAAM,IAAQ,EAAE,CAAC,GACpFE,gBAAAA,YACF;AACF;;AAGA,SAAgB,eAAe,WAAkC;CAC/D,OAAOD,gBAAAA,YAAYD,uBAAAA,aAAa,MAAM,EAAE,OAAO,SAAS,GAAGE,gBAAAA,YAAY;AACzE;;;;;;;AAQA,SAAgB,wBAAwB,SAAuC;CAC7E,MAAM,QAAQH,gBAAAA,cAAcC,uBAAAA,UAAU;CACtC,MAAM,CAAC,KAAK,WAAA,GAAA,MAAA,SAAA,CAAkC,IAAI;CAClD,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,MAAM,UAAU,UAAU,MAAM,aAAa,OAAO,IAAI;EACxD,IAAI,CAAC,SAAS;GACZ,OAAO,IAAI;GACX;EACF;EAEA,MAAM,OAAO,IAAI,YAAY,QAAQ,MAAM,UAAU;EACrD,IAAI,WAAW,IAAI,CAAC,CAAC,IAAI,QAAQ,KAAK;EACtC,MAAM,MAAM,IAAI,gBAAgB,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,MAAM,QAAQ,SAAS,CAAC,CAAC;EAC5E,OAAO,GAAG;EACV,aAAa;GACX,IAAI,gBAAgB,GAAG;GACvB,OAAO,IAAI;EACb;CACF,GAAG,CAAC,OAAO,OAAO,CAAC;CACnB,OAAO;AACT;;;;;AAMA,SAAgB,mBAGd;CACA,MAAM,QAAQD,gBAAAA,cAAcC,uBAAAA,UAAU;CACtC,MAAM,aAAaG,gBAAAA,cAAc;CACjC,OAAO;EACL,WAAW,SAAS,SAAS;GAC3B,IAAI,CAAC,YAAY,OAAO,QAAQ,uBAAO,IAAI,MAAM,8BAA8B,CAAC;GAChF,OAAO,MAAM,SAAS,YAAY,SAAS,IAAI;EACjD;EACA,cAAc;GACZ,IAAI,YAAY,MAAM,OAAO,UAAU;EACzC;CACF;AACF"}
+{"version":3,"file":"stamp.cjs","names":["useCapability","StampToken","stateHook","stampState","settingsHook","useSelector","shallowArray"],"sources":["../src/stamp.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-stamp.\n *\n * Thin by design: the plugin owns the store (libraries/assets) and the binary\n * sidecar (bytes + cached previews); this file only exposes hooks and owns the\n * DOM-side object-URL lifetime for gallery thumbnails. Placement UI needs no\n * component here — arming rides the annotation plugin, whose `<AnnotationLayer>`\n * already renders the hover ghost. `useStamp()` inside a `<DocumentScope>`\n * places on that document; elsewhere on the active one.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-stamp';\n// The browser store for `persistStampLibraries` / `restoreStampLibraries`\n// (structurally the plugin's `StampLibraryStore`), written once in `@embedpdf/web`.\nexport { indexedDbByteStore } from '@embedpdf/web';\nexport type { ByteStore } from '@embedpdf/web';\nimport { objectUrlOf } from '@embedpdf/web';\nimport { useEffect, useState } from 'react';\nimport {\n  StampToken,\n  stampState,\n  type StampAsset,\n  type StampAssetFilter,\n  type StampCapability,\n  type StampLibrary,\n  type StampLibraryFilter,\n} from '@embedpdf/plugin-stamp';\nimport type { EventHook } from '@embedpdf/core';\nimport { shallowArray, useCapability, useCapabilityEvent, useSelector } from './runtime';\nimport { settingsHook, stateHook } from './state';\n\n/**\n * The stamp capability. Libraries are shared by every document; the placing\n * verbs act on the document this component is in.\n */\nexport function useStamp(): StampCapability {\n  return useCapability(StampToken);\n}\n\n/** Subscribe to one stamp event for the mounted lifetime: `useStampEvent((stamp) => stamp.onAssetCreated, handler)`. */\nexport function useStampEvent<T>(\n  select: (stamp: StampCapability) => EventHook<T>,\n  handler: (event: T) => void,\n): void {\n  useCapabilityEvent(StampToken, select, handler);\n}\n\n/**\n * The stamps' state for this component's document: the armed stamp (the\n * page's State table, declared once in `stampState`). Takes a selector, and\n * re-renders only when what it returns changes.\n */\nexport const useStampState = stateHook(stampState);\n\n/** The stamp settings (`assetEngine`, `previewWidth`, `dynamic`), with or without a document. Takes a selector. */\nexport const useStampSettings = settingsHook(StampToken);\n\n/** Libraries, optionally of one kind or several (`{ kind: 'stamps' }`, `{ kind: ['stamps', 'toolbar'] }`). */\nexport function useStampLibraries(filter?: StampLibraryFilter): readonly StampLibrary[] {\n  // Keyed by value, so an inline filter doesn't read a new list every render.\n  const kinds =\n    filter?.kind === undefined ? undefined : ([] as string[]).concat(filter.kind).join('\\u0000');\n  return useSelector(\n    StampToken,\n    (stamp) =>\n      stamp.listLibraries(kinds === undefined ? undefined : { kind: kinds.split('\\u0000') }),\n    shallowArray,\n  );\n}\n\n/** The stamps of one library (`{ libraryId }`), of one kind or category, or every stamp. */\nexport function useStampAssets(filter?: StampAssetFilter): readonly StampAsset[] {\n  const libraryId = filter?.libraryId;\n  const kind = filter?.kind;\n  const category = filter?.category;\n  return useSelector(\n    StampToken,\n    (stamp) => stamp.listAssets({ libraryId, kind, category }),\n    shallowArray,\n  );\n}\n\n/**\n * Object URL for an asset's cached preview (gallery thumbnails). The plugin\n * holds the preview bytes; the URL — a DOM resource — is created here and\n * revoked on unmount/asset change, mirroring `<AnnotationLayer>`'s rule that\n * object-URL lifetime belongs to the framework layer.\n */\nexport function useStampAssetPreviewUrl(assetId: string | null): string | null {\n  const stamp = useStamp();\n  const [url, setUrl] = useState<string | null>(null);\n  useEffect(() => {\n    const preview = assetId ? stamp.getAssetPreview(assetId) : null;\n    if (!preview) {\n      setUrl(null);\n      return;\n    }\n    const objectUrl = objectUrlOf(preview);\n    setUrl(objectUrl.url);\n    return () => {\n      objectUrl.revoke();\n      setUrl(null);\n    };\n  }, [stamp, assetId]);\n  return url;\n}\n"],"mappings":";;;;;;;;;;;;AAoCA,SAAgB,WAA4B;CAC1C,OAAOA,gBAAAA,cAAcC,uBAAAA,UAAU;AACjC;;AAGA,SAAgB,cACd,QACA,SACM;CACN,gBAAA,mBAAmBA,uBAAAA,YAAY,QAAQ,OAAO;AAChD;;;;;;AAOA,MAAa,gBAAgBC,cAAAA,UAAUC,uBAAAA,UAAU;;AAGjD,MAAa,mBAAmBC,cAAAA,aAAaH,uBAAAA,UAAU;;AAGvD,SAAgB,kBAAkB,QAAsD;CAEtF,MAAM,QACJ,QAAQ,SAAS,KAAA,IAAY,KAAA,IAAa,CAAC,CAAC,CAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,IAAQ;CAC7F,OAAOI,gBAAAA,YACLJ,uBAAAA,aACC,UACC,MAAM,cAAc,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,MAAM,MAAM,MAAM,IAAQ,EAAE,CAAC,GACvFK,gBAAAA,YACF;AACF;;AAGA,SAAgB,eAAe,QAAkD;CAC/E,MAAM,YAAY,QAAQ;CAC1B,MAAM,OAAO,QAAQ;CACrB,MAAM,WAAW,QAAQ;CACzB,OAAOD,gBAAAA,YACLJ,uBAAAA,aACC,UAAU,MAAM,WAAW;EAAE;EAAW;EAAM;CAAS,CAAC,GACzDK,gBAAAA,YACF;AACF;;;;;;;AAQA,SAAgB,wBAAwB,SAAuC;CAC7E,MAAM,QAAQ,SAAS;CACvB,MAAM,CAAC,KAAK,WAAA,GAAA,MAAA,SAAA,CAAkC,IAAI;CAClD,CAAA,GAAA,MAAA,UAAA,OAAgB;EACd,MAAM,UAAU,UAAU,MAAM,gBAAgB,OAAO,IAAI;EAC3D,IAAI,CAAC,SAAS;GACZ,OAAO,IAAI;GACX;EACF;EACA,MAAM,aAAA,GAAA,cAAA,YAAA,CAAwB,OAAO;EACrC,OAAO,UAAU,GAAG;EACpB,aAAa;GACX,UAAU,OAAO;GACjB,OAAO,IAAI;EACb;CACF,GAAG,CAAC,OAAO,OAAO,CAAC;CACnB,OAAO;AACT"}

package/dist/stamp.d.cts

@@ -1,30 +1,37 @@
+import { n as StateHook, t as SettingsHook } from "./state-0K1I5cM4.cjs";
+import { EventHook } from "@embedpdf/core";
 import { ByteStore, indexedDbByteStore } from "@embedpdf/web";
-import { StampAsset, StampLibrary, StampLibraryQuery } from "@embedpdf/plugin-stamp";
+import { StampAsset, StampAssetFilter, StampCapability, StampLibrary, StampLibraryFilter } from "@embedpdf/plugin-stamp";
 export * from "@embedpdf/plugin-stamp";
 //#region src/stamp.d.ts
-/** The stamp capability (workspace-scoped: one library set for every document). */
-declare function useStamp(): import("@embedpdf/plugin-stamp").StampCapability;
+/**
+ * The stamp capability. Libraries are shared by every document; the placing
+ * verbs act on the document this component is in.
+ */
+declare function useStamp(): StampCapability;
+/** Subscribe to one stamp event for the mounted lifetime: `useStampEvent((stamp) => stamp.onAssetCreated, handler)`. */
+declare function useStampEvent<T>(select: (stamp: StampCapability) => EventHook<T>, handler: (event: T) => void): void;
+/**
+ * The stamps' state for this component's document: the armed stamp (the
+ * page's State table, declared once in `stampState`). Takes a selector, and
+ * re-renders only when what it returns changes.
+ */
+declare const useStampState: StateHook<{
+  armedAsset: StampAsset | null;
+}>;
+/** The stamp settings (`assetEngine`, `previewWidth`, `dynamic`), with or without a document. Takes a selector. */
+declare const useStampSettings: SettingsHook<import("@embedpdf/plugin-stamp").StampSettings>;
 /** Libraries, optionally of one kind or several (`{ kind: 'stamps' }`, `{ kind: ['stamps', 'toolbar'] }`). */
-declare function useStampLibraries(query?: StampLibraryQuery): StampLibrary[];
-/** Assets of one library, or every asset when `libraryId` is omitted. */
-declare function useStampAssets(libraryId?: string): StampAsset[];
+declare function useStampLibraries(filter?: StampLibraryFilter): readonly StampLibrary[];
+/** The stamps of one library (`{ libraryId }`), of one kind or category, or every stamp. */
+declare function useStampAssets(filter?: StampAssetFilter): readonly StampAsset[];
 /**
  * Object URL for an asset's cached preview (gallery thumbnails). The plugin
- * holds the preview BYTES; the URL — a DOM resource — is created here and
+ * holds the preview bytes; the URL — a DOM resource — is created here and
  * revoked on unmount/asset change, mirroring `<AnnotationLayer>`'s rule that
  * object-URL lifetime belongs to the framework layer.
  */
 declare function useStampAssetPreviewUrl(assetId: string | null): string | null;
-/**
- * Arm/disarm assets against the nearest `<DocumentScope>` (or the active
- * document) — the one-liner a gallery item's onClick needs.
- */
-declare function useArmStampAsset(): {
-  armAsset: (assetId: string, opts?: {
-    targetWidth?: number;
-  }) => Promise<void>;
-  disarm: () => void;
-};
 //#endregion
-export { type ByteStore, indexedDbByteStore, useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries };
+export { type ByteStore, indexedDbByteStore, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampEvent, useStampLibraries, useStampSettings, useStampState };
 //# sourceMappingURL=stamp.d.cts.map

package/dist/stamp.d.ts

@@ -1,30 +1,37 @@
+import { n as StateHook, t as SettingsHook } from "./state-0K1I5cM4.js";
+import { EventHook } from "@embedpdf/core";
 import { ByteStore, indexedDbByteStore } from "@embedpdf/web";
-import { StampAsset, StampLibrary, StampLibraryQuery } from "@embedpdf/plugin-stamp";
+import { StampAsset, StampAssetFilter, StampCapability, StampLibrary, StampLibraryFilter } from "@embedpdf/plugin-stamp";
 export * from "@embedpdf/plugin-stamp";
 //#region src/stamp.d.ts
-/** The stamp capability (workspace-scoped: one library set for every document). */
-declare function useStamp(): import("@embedpdf/plugin-stamp").StampCapability;
+/**
+ * The stamp capability. Libraries are shared by every document; the placing
+ * verbs act on the document this component is in.
+ */
+declare function useStamp(): StampCapability;
+/** Subscribe to one stamp event for the mounted lifetime: `useStampEvent((stamp) => stamp.onAssetCreated, handler)`. */
+declare function useStampEvent<T>(select: (stamp: StampCapability) => EventHook<T>, handler: (event: T) => void): void;
+/**
+ * The stamps' state for this component's document: the armed stamp (the
+ * page's State table, declared once in `stampState`). Takes a selector, and
+ * re-renders only when what it returns changes.
+ */
+declare const useStampState: StateHook<{
+  armedAsset: StampAsset | null;
+}>;
+/** The stamp settings (`assetEngine`, `previewWidth`, `dynamic`), with or without a document. Takes a selector. */
+declare const useStampSettings: SettingsHook<import("@embedpdf/plugin-stamp").StampSettings>;
 /** Libraries, optionally of one kind or several (`{ kind: 'stamps' }`, `{ kind: ['stamps', 'toolbar'] }`). */
-declare function useStampLibraries(query?: StampLibraryQuery): StampLibrary[];
-/** Assets of one library, or every asset when `libraryId` is omitted. */
-declare function useStampAssets(libraryId?: string): StampAsset[];
+declare function useStampLibraries(filter?: StampLibraryFilter): readonly StampLibrary[];
+/** The stamps of one library (`{ libraryId }`), of one kind or category, or every stamp. */
+declare function useStampAssets(filter?: StampAssetFilter): readonly StampAsset[];
 /**
  * Object URL for an asset's cached preview (gallery thumbnails). The plugin
- * holds the preview BYTES; the URL — a DOM resource — is created here and
+ * holds the preview bytes; the URL — a DOM resource — is created here and
  * revoked on unmount/asset change, mirroring `<AnnotationLayer>`'s rule that
  * object-URL lifetime belongs to the framework layer.
  */
 declare function useStampAssetPreviewUrl(assetId: string | null): string | null;
-/**
- * Arm/disarm assets against the nearest `<DocumentScope>` (or the active
- * document) — the one-liner a gallery item's onClick needs.
- */
-declare function useArmStampAsset(): {
-  armAsset: (assetId: string, opts?: {
-    targetWidth?: number;
-  }) => Promise<void>;
-  disarm: () => void;
-};
 //#endregion
-export { type ByteStore, indexedDbByteStore, useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries };
+export { type ByteStore, indexedDbByteStore, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampEvent, useStampLibraries, useStampSettings, useStampState };
 //# sourceMappingURL=stamp.d.ts.map

package/dist/stamp.js

@@ -1,67 +1,70 @@
-import "./rolldown-runtime-BBjsoOtd.js";
-import { shallowArray, useCapability, useDocumentId, useSelector } from "./runtime.js";
+import { E as useSelector, f as useCapability, p as useCapabilityEvent, u as shallowArray } from "./runtime-tD5iJU83.js";
+import { n as stateHook, t as settingsHook } from "./state-CzI2KlZb.js";
+import { indexedDbByteStore, objectUrlOf } from "@embedpdf/web";
 import { useEffect, useState } from "react";
-import { indexedDbByteStore } from "@embedpdf/web";
-import { StampToken } from "@embedpdf/plugin-stamp";
+import { StampToken, stampState } from "@embedpdf/plugin-stamp";
 export * from "@embedpdf/plugin-stamp";
 //#region src/stamp.tsx
-/** The stamp capability (workspace-scoped: one library set for every document). */
+/**
+* The stamp capability. Libraries are shared by every document; the placing
+* verbs act on the document this component is in.
+*/
 function useStamp() {
 	return useCapability(StampToken);
 }
+/** Subscribe to one stamp event for the mounted lifetime: `useStampEvent((stamp) => stamp.onAssetCreated, handler)`. */
+function useStampEvent(select, handler) {
+	useCapabilityEvent(StampToken, select, handler);
+}
+/**
+* The stamps' state for this component's document: the armed stamp (the
+* page's State table, declared once in `stampState`). Takes a selector, and
+* re-renders only when what it returns changes.
+*/
+const useStampState = stateHook(stampState);
+/** The stamp settings (`assetEngine`, `previewWidth`, `dynamic`), with or without a document. Takes a selector. */
+const useStampSettings = settingsHook(StampToken);
 /** Libraries, optionally of one kind or several (`{ kind: 'stamps' }`, `{ kind: ['stamps', 'toolbar'] }`). */
-function useStampLibraries(query) {
-	const kinds = query?.kind === void 0 ? void 0 : [].concat(query.kind).join("\0");
-	return useSelector(StampToken, (c) => c.libraries(kinds === void 0 ? void 0 : { kind: kinds.split("\0") }), shallowArray);
+function useStampLibraries(filter) {
+	const kinds = filter?.kind === void 0 ? void 0 : [].concat(filter.kind).join("\0");
+	return useSelector(StampToken, (stamp) => stamp.listLibraries(kinds === void 0 ? void 0 : { kind: kinds.split("\0") }), shallowArray);
 }
-/** Assets of one library, or every asset when `libraryId` is omitted. */
-function useStampAssets(libraryId) {
-	return useSelector(StampToken, (c) => c.assets(libraryId), shallowArray);
+/** The stamps of one library (`{ libraryId }`), of one kind or category, or every stamp. */
+function useStampAssets(filter) {
+	const libraryId = filter?.libraryId;
+	const kind = filter?.kind;
+	const category = filter?.category;
+	return useSelector(StampToken, (stamp) => stamp.listAssets({
+		libraryId,
+		kind,
+		category
+	}), shallowArray);
 }
 /**
 * Object URL for an asset's cached preview (gallery thumbnails). The plugin
-* holds the preview BYTES; the URL — a DOM resource — is created here and
+* holds the preview bytes; the URL — a DOM resource — is created here and
 * revoked on unmount/asset change, mirroring `<AnnotationLayer>`'s rule that
 * object-URL lifetime belongs to the framework layer.
 */
 function useStampAssetPreviewUrl(assetId) {
-	const stamp = useCapability(StampToken);
+	const stamp = useStamp();
 	const [url, setUrl] = useState(null);
 	useEffect(() => {
-		const preview = assetId ? stamp.assetPreview(assetId) : null;
+		const preview = assetId ? stamp.getAssetPreview(assetId) : null;
 		if (!preview) {
 			setUrl(null);
 			return;
 		}
-		const body = new ArrayBuffer(preview.bytes.byteLength);
-		new Uint8Array(body).set(preview.bytes);
-		const obj = URL.createObjectURL(new Blob([body], { type: preview.mimeType }));
-		setUrl(obj);
+		const objectUrl = objectUrlOf(preview);
+		setUrl(objectUrl.url);
 		return () => {
-			URL.revokeObjectURL(obj);
+			objectUrl.revoke();
 			setUrl(null);
 		};
 	}, [stamp, assetId]);
 	return url;
 }
-/**
-* Arm/disarm assets against the nearest `<DocumentScope>` (or the active
-* document) — the one-liner a gallery item's onClick needs.
-*/
-function useArmStampAsset() {
-	const stamp = useCapability(StampToken);
-	const documentId = useDocumentId();
-	return {
-		armAsset: (assetId, opts) => {
-			if (!documentId) return Promise.reject(/* @__PURE__ */ new Error("[stamp] no document in scope"));
-			return stamp.armAsset(documentId, assetId, opts);
-		},
-		disarm: () => {
-			if (documentId) stamp.disarm(documentId);
-		}
-	};
-}
 //#endregion
-export { indexedDbByteStore, useArmStampAsset, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampLibraries };
+export { indexedDbByteStore, useStamp, useStampAssetPreviewUrl, useStampAssets, useStampEvent, useStampLibraries, useStampSettings, useStampState };
 
 //# sourceMappingURL=stamp.js.map

package/dist/stamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"stamp.js","names":[],"sources":["../src/stamp.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-stamp.\n *\n * Thin by design: the plugin owns the store (libraries/assets) and the binary\n * sidecar (bytes + cached previews); this file only exposes hooks and owns the\n * DOM-side object-URL lifetime for gallery thumbnails. Placement UI needs no\n * component here — arming rides the annotation plugin, whose `<AnnotationLayer>`\n * already renders the hover ghost.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-stamp';\n// The browser store for `persistStampLibraries` / `restoreStampLibraries`\n// (structurally the plugin's `StampLibraryStore`), written once in `@embedpdf/web`.\nexport { indexedDbByteStore } from '@embedpdf/web';\nexport type { ByteStore } from '@embedpdf/web';\nimport { useEffect, useState } from 'react';\nimport {\n  StampToken,\n  type StampAsset,\n  type StampLibrary,\n  type StampLibraryQuery,\n} from '@embedpdf/plugin-stamp';\nimport { shallowArray, useCapability, useDocumentId, useSelector } from './runtime';\n\n/** The stamp capability (workspace-scoped: one library set for every document). */\nexport function useStamp() {\n  return useCapability(StampToken);\n}\n\n/** Libraries, optionally of one kind or several (`{ kind: 'stamps' }`, `{ kind: ['stamps', 'toolbar'] }`). */\nexport function useStampLibraries(query?: StampLibraryQuery): StampLibrary[] {\n  const kinds = query?.kind === undefined ? undefined : ([] as string[]).concat(query.kind).join('\\u0000');\n  return useSelector(\n    StampToken,\n    (c) => c.libraries(kinds === undefined ? undefined : { kind: kinds.split('\\u0000') }),\n    shallowArray,\n  );\n}\n\n/** Assets of one library, or every asset when `libraryId` is omitted. */\nexport function useStampAssets(libraryId?: string): StampAsset[] {\n  return useSelector(StampToken, (c) => c.assets(libraryId), shallowArray);\n}\n\n/**\n * Object URL for an asset's cached preview (gallery thumbnails). The plugin\n * holds the preview BYTES; the URL — a DOM resource — is created here and\n * revoked on unmount/asset change, mirroring `<AnnotationLayer>`'s rule that\n * object-URL lifetime belongs to the framework layer.\n */\nexport function useStampAssetPreviewUrl(assetId: string | null): string | null {\n  const stamp = useCapability(StampToken);\n  const [url, setUrl] = useState<string | null>(null);\n  useEffect(() => {\n    const preview = assetId ? stamp.assetPreview(assetId) : null;\n    if (!preview) {\n      setUrl(null);\n      return;\n    }\n    // Copy into an EXACT ArrayBuffer (the engine idiom) before Blob-wrapping.\n    const body = new ArrayBuffer(preview.bytes.byteLength);\n    new Uint8Array(body).set(preview.bytes);\n    const obj = URL.createObjectURL(new Blob([body], { type: preview.mimeType }));\n    setUrl(obj);\n    return () => {\n      URL.revokeObjectURL(obj);\n      setUrl(null);\n    };\n  }, [stamp, assetId]);\n  return url;\n}\n\n/**\n * Arm/disarm assets against the nearest `<DocumentScope>` (or the active\n * document) — the one-liner a gallery item's onClick needs.\n */\nexport function useArmStampAsset(): {\n  armAsset: (assetId: string, opts?: { targetWidth?: number }) => Promise<void>;\n  disarm: () => void;\n} {\n  const stamp = useCapability(StampToken);\n  const documentId = useDocumentId();\n  return {\n    armAsset: (assetId, opts) => {\n      if (!documentId) return Promise.reject(new Error('[stamp] no document in scope'));\n      return stamp.armAsset(documentId, assetId, opts);\n    },\n    disarm: () => {\n      if (documentId) stamp.disarm(documentId);\n    },\n  };\n}\n"],"mappings":";;;;;;;;AA0BA,SAAgB,WAAW;CACzB,OAAO,cAAc,UAAU;AACjC;;AAGA,SAAgB,kBAAkB,OAA2C;CAC3E,MAAM,QAAQ,OAAO,SAAS,KAAA,IAAY,KAAA,IAAa,CAAC,CAAC,CAAc,OAAO,MAAM,IAAI,CAAC,CAAC,KAAK,IAAQ;CACvG,OAAO,YACL,aACC,MAAM,EAAE,UAAU,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,MAAM,MAAM,MAAM,IAAQ,EAAE,CAAC,GACpF,YACF;AACF;;AAGA,SAAgB,eAAe,WAAkC;CAC/D,OAAO,YAAY,aAAa,MAAM,EAAE,OAAO,SAAS,GAAG,YAAY;AACzE;;;;;;;AAQA,SAAgB,wBAAwB,SAAuC;CAC7E,MAAM,QAAQ,cAAc,UAAU;CACtC,MAAM,CAAC,KAAK,UAAU,SAAwB,IAAI;CAClD,gBAAgB;EACd,MAAM,UAAU,UAAU,MAAM,aAAa,OAAO,IAAI;EACxD,IAAI,CAAC,SAAS;GACZ,OAAO,IAAI;GACX;EACF;EAEA,MAAM,OAAO,IAAI,YAAY,QAAQ,MAAM,UAAU;EACrD,IAAI,WAAW,IAAI,CAAC,CAAC,IAAI,QAAQ,KAAK;EACtC,MAAM,MAAM,IAAI,gBAAgB,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,MAAM,QAAQ,SAAS,CAAC,CAAC;EAC5E,OAAO,GAAG;EACV,aAAa;GACX,IAAI,gBAAgB,GAAG;GACvB,OAAO,IAAI;EACb;CACF,GAAG,CAAC,OAAO,OAAO,CAAC;CACnB,OAAO;AACT;;;;;AAMA,SAAgB,mBAGd;CACA,MAAM,QAAQ,cAAc,UAAU;CACtC,MAAM,aAAa,cAAc;CACjC,OAAO;EACL,WAAW,SAAS,SAAS;GAC3B,IAAI,CAAC,YAAY,OAAO,QAAQ,uBAAO,IAAI,MAAM,8BAA8B,CAAC;GAChF,OAAO,MAAM,SAAS,YAAY,SAAS,IAAI;EACjD;EACA,cAAc;GACZ,IAAI,YAAY,MAAM,OAAO,UAAU;EACzC;CACF;AACF"}
+{"version":3,"file":"stamp.js","names":[],"sources":["../src/stamp.tsx"],"sourcesContent":["/**\n * The React view of @embedpdf/plugin-stamp.\n *\n * Thin by design: the plugin owns the store (libraries/assets) and the binary\n * sidecar (bytes + cached previews); this file only exposes hooks and owns the\n * DOM-side object-URL lifetime for gallery thumbnails. Placement UI needs no\n * component here — arming rides the annotation plugin, whose `<AnnotationLayer>`\n * already renders the hover ghost. `useStamp()` inside a `<DocumentScope>`\n * places on that document; elsewhere on the active one.\n */\n\n// One-line-per-feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-stamp';\n// The browser store for `persistStampLibraries` / `restoreStampLibraries`\n// (structurally the plugin's `StampLibraryStore`), written once in `@embedpdf/web`.\nexport { indexedDbByteStore } from '@embedpdf/web';\nexport type { ByteStore } from '@embedpdf/web';\nimport { objectUrlOf } from '@embedpdf/web';\nimport { useEffect, useState } from 'react';\nimport {\n  StampToken,\n  stampState,\n  type StampAsset,\n  type StampAssetFilter,\n  type StampCapability,\n  type StampLibrary,\n  type StampLibraryFilter,\n} from '@embedpdf/plugin-stamp';\nimport type { EventHook } from '@embedpdf/core';\nimport { shallowArray, useCapability, useCapabilityEvent, useSelector } from './runtime';\nimport { settingsHook, stateHook } from './state';\n\n/**\n * The stamp capability. Libraries are shared by every document; the placing\n * verbs act on the document this component is in.\n */\nexport function useStamp(): StampCapability {\n  return useCapability(StampToken);\n}\n\n/** Subscribe to one stamp event for the mounted lifetime: `useStampEvent((stamp) => stamp.onAssetCreated, handler)`. */\nexport function useStampEvent<T>(\n  select: (stamp: StampCapability) => EventHook<T>,\n  handler: (event: T) => void,\n): void {\n  useCapabilityEvent(StampToken, select, handler);\n}\n\n/**\n * The stamps' state for this component's document: the armed stamp (the\n * page's State table, declared once in `stampState`). Takes a selector, and\n * re-renders only when what it returns changes.\n */\nexport const useStampState = stateHook(stampState);\n\n/** The stamp settings (`assetEngine`, `previewWidth`, `dynamic`), with or without a document. Takes a selector. */\nexport const useStampSettings = settingsHook(StampToken);\n\n/** Libraries, optionally of one kind or several (`{ kind: 'stamps' }`, `{ kind: ['stamps', 'toolbar'] }`). */\nexport function useStampLibraries(filter?: StampLibraryFilter): readonly StampLibrary[] {\n  // Keyed by value, so an inline filter doesn't read a new list every render.\n  const kinds =\n    filter?.kind === undefined ? undefined : ([] as string[]).concat(filter.kind).join('\\u0000');\n  return useSelector(\n    StampToken,\n    (stamp) =>\n      stamp.listLibraries(kinds === undefined ? undefined : { kind: kinds.split('\\u0000') }),\n    shallowArray,\n  );\n}\n\n/** The stamps of one library (`{ libraryId }`), of one kind or category, or every stamp. */\nexport function useStampAssets(filter?: StampAssetFilter): readonly StampAsset[] {\n  const libraryId = filter?.libraryId;\n  const kind = filter?.kind;\n  const category = filter?.category;\n  return useSelector(\n    StampToken,\n    (stamp) => stamp.listAssets({ libraryId, kind, category }),\n    shallowArray,\n  );\n}\n\n/**\n * Object URL for an asset's cached preview (gallery thumbnails). The plugin\n * holds the preview bytes; the URL — a DOM resource — is created here and\n * revoked on unmount/asset change, mirroring `<AnnotationLayer>`'s rule that\n * object-URL lifetime belongs to the framework layer.\n */\nexport function useStampAssetPreviewUrl(assetId: string | null): string | null {\n  const stamp = useStamp();\n  const [url, setUrl] = useState<string | null>(null);\n  useEffect(() => {\n    const preview = assetId ? stamp.getAssetPreview(assetId) : null;\n    if (!preview) {\n      setUrl(null);\n      return;\n    }\n    const objectUrl = objectUrlOf(preview);\n    setUrl(objectUrl.url);\n    return () => {\n      objectUrl.revoke();\n      setUrl(null);\n    };\n  }, [stamp, assetId]);\n  return url;\n}\n"],"mappings":";;;;;;;;;;;AAoCA,SAAgB,WAA4B;CAC1C,OAAO,cAAc,UAAU;AACjC;;AAGA,SAAgB,cACd,QACA,SACM;CACN,mBAAmB,YAAY,QAAQ,OAAO;AAChD;;;;;;AAOA,MAAa,gBAAgB,UAAU,UAAU;;AAGjD,MAAa,mBAAmB,aAAa,UAAU;;AAGvD,SAAgB,kBAAkB,QAAsD;CAEtF,MAAM,QACJ,QAAQ,SAAS,KAAA,IAAY,KAAA,IAAa,CAAC,CAAC,CAAc,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,IAAQ;CAC7F,OAAO,YACL,aACC,UACC,MAAM,cAAc,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,MAAM,MAAM,MAAM,IAAQ,EAAE,CAAC,GACvF,YACF;AACF;;AAGA,SAAgB,eAAe,QAAkD;CAC/E,MAAM,YAAY,QAAQ;CAC1B,MAAM,OAAO,QAAQ;CACrB,MAAM,WAAW,QAAQ;CACzB,OAAO,YACL,aACC,UAAU,MAAM,WAAW;EAAE;EAAW;EAAM;CAAS,CAAC,GACzD,YACF;AACF;;;;;;;AAQA,SAAgB,wBAAwB,SAAuC;CAC7E,MAAM,QAAQ,SAAS;CACvB,MAAM,CAAC,KAAK,UAAU,SAAwB,IAAI;CAClD,gBAAgB;EACd,MAAM,UAAU,UAAU,MAAM,gBAAgB,OAAO,IAAI;EAC3D,IAAI,CAAC,SAAS;GACZ,OAAO,IAAI;GACX;EACF;EACA,MAAM,YAAY,YAAY,OAAO;EACrC,OAAO,UAAU,GAAG;EACpB,aAAa;GACX,UAAU,OAAO;GACjB,OAAO,IAAI;EACb;CACF,GAAG,CAAC,OAAO,OAAO,CAAC;CACnB,OAAO;AACT"}