@embedpdf/core 3.0.0-next.13 → 3.0.0-next.15

package/dist/testing.cjs

@@ -0,0 +1,401 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_settings = require("./settings-maKtf237.cjs");
+let _embedpdf_engine_core_runtime = require("@embedpdf/engine-core/runtime");
+//#region src/testing.ts
+const layoutOf = (page, index) => {
+	const size = page.size ?? (page.crop ? {
+		width: page.crop.right - page.crop.left,
+		height: page.crop.top - page.crop.bottom
+	} : {
+		width: 612,
+		height: 792
+	});
+	const crop = page.crop ?? {
+		left: 0,
+		bottom: 0,
+		right: size.width,
+		top: size.height
+	};
+	const visible = {
+		x: 0,
+		y: 0,
+		width: crop.right - crop.left,
+		height: crop.top - crop.bottom
+	};
+	return {
+		index,
+		ref: page.ref,
+		label: page.label ?? null,
+		size,
+		rotation: page.rotation ?? 0,
+		userUnit: page.userUnit ?? 1,
+		tabOrder: null,
+		boxes: {
+			media: { ...visible },
+			crop: { ...visible },
+			bleed: { ...visible },
+			trim: { ...visible },
+			art: { ...visible }
+		},
+		pdfCropBox: crop
+	};
+};
+/** A read-only document registry holding the test's one document. */
+function testDocuments(meta) {
+	const info = {
+		id: meta.id,
+		status: "ready",
+		pageCount: meta.pageCount,
+		hasUnsavedChanges: false
+	};
+	const known = (id) => id === void 0 || id === meta.id;
+	const pagesOf = (id) => known(id) ? meta.pages : [];
+	const unsupported = (verb) => () => {
+		throw new require_settings.PluginError("unsupported", "documents", `${verb} is not available in a test context`);
+	};
+	const never = () => () => {};
+	return {
+		getActiveId: () => meta.id,
+		getActive: () => info,
+		list: () => [info],
+		get: (id) => known(id) ? info : null,
+		has: (id) => known(id),
+		getCount: () => 1,
+		getOrder: () => [meta.id],
+		listPages: pagesOf,
+		getPage: (page, id) => require_settings.findPage(pagesOf(id), page),
+		getPageIndex: (ref, id) => pagesOf(id).findIndex((page) => (0, _embedpdf_engine_core_runtime.pageRefsEqual)(page.ref, ref)),
+		getRevision: (id) => known(id) ? meta.revision : -1,
+		canDownload: () => true,
+		canPrint: () => true,
+		canOpenFiles: () => false,
+		open: unsupported("open"),
+		retry: unsupported("retry"),
+		rename: unsupported("rename"),
+		openAll: unsupported("openAll"),
+		unlock: unsupported("unlock"),
+		close: unsupported("close"),
+		closeAll: unsupported("closeAll"),
+		setActive: unsupported("setActive"),
+		setOrder: unsupported("setOrder"),
+		move: unsupported("move"),
+		swap: unsupported("swap"),
+		download: unsupported("download"),
+		downloadLayer: unsupported("downloadLayer"),
+		onOpened: never,
+		onOpenFailed: never,
+		onLocked: never,
+		onClosed: never,
+		onActiveChanged: never,
+		onPagesChanged: never,
+		onUnsavedChangesChanged: never
+	};
+}
+function createTestContext(options = {}) {
+	const id = options.id ?? "test";
+	const documentId = options.documentId ?? "doc";
+	const report = (error) => console.error(`[${id}]`, error);
+	const store = require_settings.createStore(report);
+	const instanceId = `${documentId}:${id}`;
+	const lease = store.lease(id, options.state, instanceId);
+	const cleanups = [];
+	const lifetime = new AbortController();
+	const settleFlushes = /* @__PURE__ */ new Set();
+	const downloadWraps = [];
+	const pages = (options.pages ?? []).map(layoutOf);
+	const capabilities = new Map(options.capabilities ?? []);
+	const documentEvents = require_settings.createEventHook(report);
+	const isRealHandle = options.doc != null && Object.getPrototypeOf(options.doc) !== Object.prototype;
+	const doc = options.doc === null ? null : isRealHandle ? options.doc : fakeDocument({
+		id: documentId,
+		events: {
+			subscribe: documentEvents.on,
+			on: (type, listener) => (0, _embedpdf_engine_core_runtime.subscribeToType)(documentEvents.on, type, listener),
+			lastServerId: () => null
+		},
+		security: {
+			allows: () => true,
+			allowsAnnotation: () => true,
+			allowsField: () => true
+		},
+		...options.doc
+	});
+	const requireDoc = () => {
+		if (!doc) throw new require_settings.PluginError("not-ready", id, "the test context has no document");
+		return doc;
+	};
+	const changes = require_settings.createDocumentChanges({
+		handle: () => doc,
+		notify: store.notify,
+		report
+	});
+	settleFlushes.add(() => changes.settle());
+	cleanups.push(() => changes.close());
+	const bursts = require_settings.createBurstGate(store);
+	const mirrors = [];
+	const mirrorEnvironment = () => ({
+		doc: requireDoc(),
+		changes,
+		notify: store.notify,
+		lifetime: lifetime.signal,
+		cell(name, initial) {
+			const cell = store.lease(`${id}/${name}`, initial, instanceId);
+			lifetime.signal.addEventListener("abort", () => cell.revoke(), { once: true });
+			return cell;
+		},
+		onDocumentEvent(listener) {
+			cleanups.push(requireDoc().events.subscribe(listener));
+		},
+		report
+	});
+	const meta = {
+		id: documentId,
+		instanceId,
+		pageCount: pages.length,
+		pages,
+		revision: 1,
+		renderPolicy: { kind: "continuous" },
+		hasUnsavedChanges: false
+	};
+	if (!capabilities.has(require_settings.DocumentsToken)) capabilities.set(require_settings.DocumentsToken, testDocuments(meta));
+	const notFound = (ref) => new require_settings.PluginError("not-found", id, `page ${ref.objectNumber} is not in this document`);
+	const resolve = (token) => capabilities.has(token) ? capabilities.get(token) : null;
+	const require = (token) => {
+		const capability = resolve(token);
+		if (capability === null) throw new require_settings.PluginError("not-found", id, `no capability for ${token.name} in the test context`);
+		return capability;
+	};
+	const queues = /* @__PURE__ */ new Map();
+	const lanes = /* @__PURE__ */ new Map();
+	const settingsStore = options.settings ? require_settings.createSettingsStore(options.settings, store.notify, report) : null;
+	if (settingsStore) cleanups.push(() => settingsStore.dispose());
+	const settings = settingsStore?.forInstance((teardown) => cleanups.push(teardown)) ?? null;
+	const context = {
+		id,
+		instanceId: meta.instanceId,
+		engine: options.engine ?? {},
+		documentId,
+		get doc() {
+			return doc;
+		},
+		documentHandle: () => doc,
+		subscribe: store.subscribe,
+		state: {
+			get: () => lease.read(),
+			update: (transition, ...args) => {
+				lease.write(transition(lease.read(), ...args));
+			},
+			onChange: lease.onChange
+		},
+		settings: () => {
+			if (!settings) throw new Error(`[${id}] the test context declares no settings`);
+			return settings;
+		},
+		notify: store.notify,
+		watch: (select, handler, isEqual = Object.is) => {
+			let previous = select();
+			const off = store.subscribe(() => {
+				const next = select();
+				if (isEqual(previous, next)) return;
+				const prior = previous;
+				previous = next;
+				handler(next, prior);
+			});
+			cleanups.push(off);
+			return off;
+		},
+		mirror: (spec) => {
+			const controller = require_settings.createMirror(spec, mirrorEnvironment());
+			mirrors.push(controller);
+			return controller.mirror;
+		},
+		pageMirror: (spec) => require_settings.createPageMirror(spec, mirrorEnvironment()),
+		changes: changes.forPlugin(id),
+		document: () => meta,
+		get: require,
+		tryGet: resolve,
+		forDocument: (token) => require(token),
+		tryForDocument: (token) => resolve(token),
+		cleanup: (fn) => {
+			cleanups.push(fn);
+		},
+		clock: require_settings.instanceClock(options.clock ?? require_settings.timerClock, lifetime.signal),
+		onSettle: (flush) => {
+			settleFlushes.add(flush);
+			cleanups.push(() => {
+				settleFlushes.delete(flush);
+			});
+		},
+		aroundDownload: (wrap) => {
+			downloadWraps.push(wrap);
+			cleanups.push(() => {
+				const index = downloadWraps.indexOf(wrap);
+				if (index >= 0) downloadWraps.splice(index, 1);
+			});
+		},
+		events: { source: () => {
+			const hook = require_settings.createEventHook((error) => console.error(`[${id}] listener failed:`, error));
+			cleanups.push(() => hook.dispose());
+			return hook;
+		} },
+		listen: (source, listener) => {
+			const off = typeof source === "function" ? source(listener) : source.subscribe(listener);
+			cleanups.push(off);
+		},
+		waitFor: (predicate, waitOptions) => new Promise((resolveWait, reject) => {
+			if (predicate()) return resolveWait();
+			const off = context.subscribe(() => {
+				if (!predicate()) return;
+				off();
+				resolveWait();
+			});
+			waitOptions?.signal?.addEventListener("abort", () => {
+				off();
+				reject(new require_settings.PluginError("operation-cancelled", id, "waitFor cancelled"));
+			});
+		}),
+		serialQueue: (key = "default") => {
+			let queue = queues.get(key);
+			if (!queue) {
+				queue = require_settings.createSerialQueue(id);
+				queues.set(key, queue);
+			}
+			return queue;
+		},
+		latest: (key) => {
+			let lane = lanes.get(key);
+			if (!lane) {
+				lane = require_settings.createLatestLane(lifetime.signal, id, key);
+				lanes.set(key, lane);
+			}
+			return lane;
+		},
+		acquire: async (get, dispose) => {
+			const resource = await get(lifetime.signal);
+			if (lifetime.signal.aborted) {
+				await dispose(resource);
+				throw new require_settings.PluginError("instance-closed", id, "acquired after close");
+			}
+			cleanups.push(() => dispose(resource));
+			return resource;
+		},
+		assertPageRef: (ref) => {
+			if (!pages.some((pageInfo) => (0, _embedpdf_engine_core_runtime.pageRefsEqual)(pageInfo.ref, ref))) throw notFound(ref);
+		},
+		getPage: (page) => require_settings.findPage(pages, page),
+		pageOf: (page) => require_settings.pageOf(pages, page, id),
+		allows: (permission) => require_settings.sessionAllows(requireDoc().security, permission),
+		assertAllowed: (permission, operation) => {
+			if (!require_settings.sessionAllows(requireDoc().security, permission)) throw require_settings.permissionDenied(id, permission, operation);
+		},
+		allowsField: (action, field) => requireDoc().security.allowsField(action, { groupId: field.groupId }),
+		assertAllowedField: (action, field, operation) => {
+			if (!requireDoc().security.allowsField(action, { groupId: field.groupId })) throw require_settings.fieldPermissionDenied(id, action, field, operation);
+		},
+		cancellable: (signal, task) => require_settings.cancellable(id, signal, task),
+		capabilities,
+		connect: (instance) => {
+			instance.connect?.();
+			for (const mirror of mirrors.splice(0)) mirror.start();
+			return instance.api;
+		},
+		emitDocumentEvent: (event) => {
+			bursts.first(event);
+			documentEvents.emit(event);
+			bursts.last(event);
+		},
+		settle: (signal) => require_settings.settle(settleFlushes, [signal, lifetime.signal], report),
+		download: (read) => require_settings.readWrapped(downloadWraps, read),
+		dispose: async () => {
+			lifetime.abort();
+			for (const fn of cleanups.splice(0).reverse()) await fn();
+		}
+	};
+	return context;
+}
+/**
+* Time that moves only when the test moves it. `frames: false` gives a host
+* that never paints, as Node is.
+*/
+function manualClock(options = {}) {
+	let now = 0;
+	let order = 0;
+	const timers = /* @__PURE__ */ new Map();
+	const frames = /* @__PURE__ */ new Map();
+	const nextDue = (until) => {
+		let found;
+		for (const [id, timer] of timers) {
+			if (timer.due > until) continue;
+			if (found === void 0 || timer.due < timers.get(found).due) found = id;
+		}
+		return found;
+	};
+	const advanceTo = (target) => {
+		if (target < now) throw new Error(`manualClock: time does not go back (${target} < ${now})`);
+		for (let id = nextDue(target); id !== void 0; id = nextDue(target)) {
+			const timer = timers.get(id);
+			timers.delete(id);
+			now = timer.due;
+			timer.run();
+		}
+		now = target;
+	};
+	return {
+		clock: {
+			now: () => now,
+			after(ms, run) {
+				const id = ++order;
+				timers.set(id, {
+					due: now + Math.max(0, ms),
+					run
+				});
+				return () => void timers.delete(id);
+			},
+			...options.frames === false ? {} : { nextFrame(run) {
+				const id = ++order;
+				frames.set(id, run);
+				return () => void frames.delete(id);
+			} }
+		},
+		get now() {
+			return now;
+		},
+		get pending() {
+			return {
+				timers: timers.size,
+				frames: frames.size
+			};
+		},
+		advance: (ms) => advanceTo(now + ms),
+		frame(timeMs = now) {
+			advanceTo(timeMs);
+			const due = [...frames.values()];
+			frames.clear();
+			for (const run of due) run(now);
+		}
+	};
+}
+/**
+* A faked document's members over the defaults every document has: calls'
+* facts and working sets change no result, so `with` gives the same fake and
+* a working set goes nowhere, unless the test fakes them.
+*/
+function fakeDocument(members) {
+	const fake = {
+		setWorkingSet: () => {},
+		...members
+	};
+	fake.with ?? (fake.with = () => fake);
+	return fake;
+}
+//#endregion
+Object.defineProperty(exports, "LOCAL_ENGINE_BRAND", {
+	enumerable: true,
+	get: function() {
+		return _embedpdf_engine_core_runtime.LOCAL_ENGINE_BRAND;
+	}
+});
+exports.createTestContext = createTestContext;
+exports.manualClock = manualClock;
+
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.cjs","names":["PluginError","findPage","createStore","createEventHook","createDocumentChanges","createBurstGate","DocumentsToken","createSettingsStore","createMirror","createPageMirror","instanceClock","timerClock","createSerialQueue","createLatestLane","pageOf","sessionAllows","permissionDenied","fieldPermissionDenied","cancellable","settle","readWrapped"],"sources":["../src/testing.ts"],"sourcesContent":["/**\n * @embedpdf/core/testing — a real plugin context for plugin unit tests, so a\n * suite never re-invents the kernel: the kernel's own store, state cell,\n * mirrors and event hooks, page geometry from a page list, capabilities from\n * a token map, cleanups you can run, and a document handle you shape per\n * test. Everything a controller reaches for behaves as in the kernel, minus\n * the engine.\n *\n *   const ctx = createTestContext({\n *     id: 'measurement',\n *     state: initialMeasurementState(),\n *     pages: [{ ref: toPageRef(1), size: { width: 600, height: 800 } }],\n *     capabilities: [[AnnotationToken, fakeAnnotation]],\n *     doc: { security: { allows: () => true } },\n *   });\n *   const api = ctx.connect(createMeasurementController(ctx));\n *   ctx.emitDocumentEvent(event); // folds into the plugin's mirrors\n *\n * Time is the host's timers unless a test passes a clock: `manualClock()`\n * steps timers and frames by hand.\n *\n *   const time = manualClock();\n *   const ctx = createTestContext({ clock: time.clock });\n *   time.advance(300); // timers due by then run\n *   time.frame(16); // and the callbacks waiting for a frame\n */\nimport type {\n  DocumentEvent,\n  DocumentHandle,\n  Engine,\n  PageLayout,\n  PageRef,\n  PdfRect,\n} from '@embedpdf/engine-core/runtime';\nimport { pageRefsEqual, subscribeToType } from '@embedpdf/engine-core/runtime';\n\n/** Brand a fake engine or handle as local (`[LOCAL_ENGINE_BRAND]: true`) so\n *  `isLocalEngine` and `isLocalDocument` accept it. */\nexport { LOCAL_ENGINE_BRAND } from '@embedpdf/engine-core/runtime';\n\nimport { createBurstGate } from './bursts';\nimport { createDocumentChanges } from './changes';\nimport { instanceClock, timerClock, type Cancel, type HostClock } from './clock';\nimport { PluginError } from './errors';\nimport { createEventHook } from './event-hook';\nimport { createLatestLane, type LatestLane } from './lanes';\nimport { createMirror, type MirrorController, type MirrorEnvironment } from './mirror';\nimport { createPageMirror } from './page-mirror';\nimport { createSerialQueue, type SerialQueue } from './serial-queue';\nimport { cancellable } from './cancellable';\nimport { findPage, pageOf } from './page-of';\nimport { readWrapped, type DownloadWrap } from './context';\nimport { fieldPermissionDenied, permissionDenied, sessionAllows } from './permissions';\nimport { createSettingsStore, type NoSettings, type SettingsDeclaration } from './settings';\nimport { settle, type SettleFlush } from './settle';\nimport { createStore } from './store';\nimport {\n  DocumentsToken,\n  type CapabilityToken,\n  type DocumentInfo,\n  type DocumentMeta,\n  type DocumentsCapability,\n  type OperationOptions,\n  type PluginContext,\n  type Unsubscribe,\n} from './types';\n\nexport interface TestPage {\n  readonly ref: PageRef;\n  /** Page size in points (default 612 × 792, or the crop's extent); the crop box is `[0, 0, w, h]` unless given. */\n  readonly size?: { readonly width: number; readonly height: number };\n  readonly crop?: PdfRect;\n  readonly rotation?: PageLayout['rotation'];\n  readonly userUnit?: number;\n  readonly label?: string | null;\n}\n\nexport interface TestContextOptions<S, T extends object = NoSettings> {\n  /** The plugin id (`ctx.id`, error prefixes). Default `'test'`. */\n  readonly id?: string;\n  /** The instance's initial state; omit for a stateless plugin. */\n  readonly state?: S;\n  /**\n   * The plugin's settings, as its definition declares them; `ctx.settings()` reads them.\n   * Without them the context has none, and `ctx.settings()` throws.\n   */\n  readonly settings?: SettingsDeclaration<T>;\n  /** The document's pages; `document()` and `geometry` derive from them. */\n  readonly pages?: readonly TestPage[];\n  readonly documentId?: string;\n  /** Capabilities `get`/`tryGet` resolve, by token. `DocumentsToken` defaults to a\n   *  registry holding this one document. */\n  readonly capabilities?: ReadonlyArray<readonly [CapabilityToken<unknown>, unknown]>;\n  /** The document handle members the test exercises (`security`, `page`, `events`, …),\n   *  or a real engine document; `null` for a workspace plugin with no document. */\n  readonly doc?: Partial<DocumentHandle> | null;\n  readonly engine?: Partial<Engine>;\n  /** The host's time (`ctx.clock`). Default: `timerClock`, the environment's timers and no frames. */\n  readonly clock?: HostClock;\n}\n\nexport interface TestContext<S, T extends object = NoSettings> extends PluginContext<S, T> {\n  /** Every capability `get` can resolve — add or replace during a test. */\n  readonly capabilities: Map<CapabilityToken<unknown>, unknown>;\n  /** Observe the change stream: state updates and `notify` wake the listener. */\n  subscribe(listener: () => void): Unsubscribe;\n  /**\n   * What the kernel does after `create`: run the instance's `connect`, then\n   * start its mirrors' first loads. Returns the instance's api.\n   */\n  connect<C>(instance: { api: C; connect?: () => void }): C;\n  /** Deliver a confirmed document event, as the engine would (the default `doc.events`). */\n  emitDocumentEvent(event: DocumentEvent): void;\n  /** What `documents.download()` does first: run every `onSettle` flush and wait for it (settle.ts). */\n  settle(signal?: AbortSignal): Promise<void>;\n  /**\n   * What `documents.download()` does after settling: `read` the file inside every\n   * `aroundDownload` wrap, the first registered outermost.\n   */\n  download(read: () => Promise<Uint8Array>): Promise<Uint8Array>;\n  /** Run the registered cleanups and abort the lifetime (the plugin's unmount). */\n  dispose(): Promise<void>;\n}\n\nconst layoutOf = (page: TestPage, index: number): PageLayout => {\n  // Size follows the crop when only the crop is given, and vice versa.\n  const size =\n    page.size ??\n    (page.crop\n      ? { width: page.crop.right - page.crop.left, height: page.crop.top - page.crop.bottom }\n      : { width: 612, height: 792 });\n  const crop = page.crop ?? { left: 0, bottom: 0, right: size.width, top: size.height };\n  // Every box is the crop box, measured from its own top-left corner.\n  const visible = { x: 0, y: 0, width: crop.right - crop.left, height: crop.top - crop.bottom };\n  return {\n    index,\n    ref: page.ref,\n    label: page.label ?? null,\n    size,\n    rotation: page.rotation ?? 0,\n    userUnit: page.userUnit ?? 1,\n    tabOrder: null,\n    boxes: {\n      media: { ...visible },\n      crop: { ...visible },\n      bleed: { ...visible },\n      trim: { ...visible },\n      art: { ...visible },\n    },\n    pdfCropBox: crop,\n  };\n};\n\n/** A read-only document registry holding the test's one document. */\nfunction testDocuments(meta: DocumentMeta): DocumentsCapability {\n  const info: DocumentInfo = {\n    id: meta.id,\n    status: 'ready',\n    pageCount: meta.pageCount,\n    hasUnsavedChanges: false,\n  };\n  const known = (id?: string) => id === undefined || id === meta.id;\n  const pagesOf = (id?: string) => (known(id) ? meta.pages : []);\n  const unsupported = (verb: string) => () => {\n    throw new PluginError('unsupported', 'documents', `${verb} is not available in a test context`);\n  };\n  const never = () => () => {};\n  return {\n    getActiveId: () => meta.id,\n    getActive: () => info,\n    list: () => [info],\n    get: (id) => (known(id) ? info : null),\n    has: (id) => known(id),\n    getCount: () => 1,\n    getOrder: () => [meta.id],\n    listPages: pagesOf,\n    getPage: (page, id) => findPage(pagesOf(id), page),\n    getPageIndex: (ref, id) => pagesOf(id).findIndex((page) => pageRefsEqual(page.ref, ref)),\n    getRevision: (id) => (known(id) ? meta.revision : -1),\n    canDownload: () => true,\n    canPrint: () => true,\n    // A test context opens nothing.\n    canOpenFiles: () => false,\n    open: unsupported('open'),\n    retry: unsupported('retry'),\n    rename: unsupported('rename'),\n    openAll: unsupported('openAll'),\n    unlock: unsupported('unlock'),\n    close: unsupported('close'),\n    closeAll: unsupported('closeAll'),\n    setActive: unsupported('setActive'),\n    setOrder: unsupported('setOrder'),\n    move: unsupported('move'),\n    swap: unsupported('swap'),\n    download: unsupported('download'),\n    downloadLayer: unsupported('downloadLayer'),\n    onOpened: never,\n    onOpenFailed: never,\n    onLocked: never,\n    onClosed: never,\n    onActiveChanged: never,\n    onPagesChanged: never,\n    onUnsavedChangesChanged: never,\n  } satisfies DocumentsCapability;\n}\n\nexport function createTestContext<S = void, T extends object = NoSettings>(\n  options: TestContextOptions<S, T> = {},\n): TestContext<S, T> {\n  const id = options.id ?? 'test';\n  const documentId = options.documentId ?? 'doc';\n  const report = (error: unknown) => console.error(`[${id}]`, error);\n  const store = createStore(report);\n  const instanceId = `${documentId}:${id}`;\n  const lease = store.lease<S>(id, options.state as S, instanceId);\n  const cleanups: Array<() => void | Promise<void>> = [];\n  const lifetime = new AbortController();\n  const settleFlushes = new Set<SettleFlush>();\n  const downloadWraps: DownloadWrap[] = [];\n  const pages = (options.pages ?? []).map(layoutOf);\n  const capabilities = new Map<CapabilityToken<unknown>, unknown>(options.capabilities ?? []);\n  const documentEvents = createEventHook<DocumentEvent>(report);\n  // A plain object lists the members a test fakes, over working defaults; a\n  // real engine document (a class instance) is used as it is.\n  const isRealHandle =\n    options.doc != null && Object.getPrototypeOf(options.doc) !== Object.prototype;\n  const doc =\n    options.doc === null\n      ? null\n      : isRealHandle\n        ? (options.doc as DocumentHandle)\n        : fakeDocument({\n            id: documentId,\n            events: {\n              subscribe: documentEvents.on,\n              on: (type: DocumentEvent['type'], listener: (event: DocumentEvent) => void) =>\n                subscribeToType(documentEvents.on, type, listener),\n              lastServerId: () => null,\n            },\n            security: { allows: () => true, allowsAnnotation: () => true, allowsField: () => true },\n            ...options.doc,\n          });\n  const requireDoc = (): DocumentHandle => {\n    if (!doc) throw new PluginError('not-ready', id, 'the test context has no document');\n    return doc;\n  };\n  // The document's change queue, as the kernel keeps one: `doc.apply` sends its changes.\n  const changes = createDocumentChanges({ handle: () => doc, notify: store.notify, report });\n  settleFlushes.add(() => changes.settle());\n  cleanups.push(() => changes.close());\n  const bursts = createBurstGate(store);\n  const mirrors: MirrorController<unknown>[] = [];\n  const mirrorEnvironment = (): MirrorEnvironment => ({\n    doc: requireDoc(),\n    changes,\n    notify: store.notify,\n    lifetime: lifetime.signal,\n    cell(name, initial) {\n      const cell = store.lease(`${id}/${name}`, initial, instanceId);\n      lifetime.signal.addEventListener('abort', () => cell.revoke(), { once: true });\n      return cell;\n    },\n    onDocumentEvent(listener) {\n      cleanups.push(requireDoc().events.subscribe(listener));\n    },\n    report,\n  });\n  const meta: DocumentMeta = {\n    id: documentId,\n    instanceId,\n    pageCount: pages.length,\n    pages,\n    revision: 1,\n    renderPolicy: { kind: 'continuous' },\n    hasUnsavedChanges: false,\n  };\n  if (!capabilities.has(DocumentsToken as CapabilityToken<unknown>)) {\n    capabilities.set(DocumentsToken as CapabilityToken<unknown>, testDocuments(meta));\n  }\n  const notFound = (ref: PageRef) =>\n    new PluginError('not-found', id, `page ${ref.objectNumber} is not in this document`);\n  const resolve = <T>(token: CapabilityToken<T>): T | null =>\n    capabilities.has(token as CapabilityToken<unknown>)\n      ? (capabilities.get(token as CapabilityToken<unknown>) as T)\n      : null;\n  const require = <T>(token: CapabilityToken<T>): T => {\n    const capability = resolve(token);\n    if (capability === null) {\n      throw new PluginError('not-found', id, `no capability for ${token.name} in the test context`);\n    }\n    return capability;\n  };\n  const queues = new Map<string, SerialQueue>();\n  const lanes = new Map<string, LatestLane>();\n  // The context is the plugin's only instance, so it holds the registration's settings itself.\n  const settingsStore = options.settings\n    ? createSettingsStore(options.settings, store.notify, report)\n    : null;\n  if (settingsStore) cleanups.push(() => settingsStore.dispose());\n  const settings = settingsStore?.forInstance((teardown) => cleanups.push(teardown)) ?? null;\n\n  const context: TestContext<S, T> = {\n    id,\n    instanceId: meta.instanceId,\n    engine: (options.engine ?? {}) as Engine,\n    documentId,\n    get doc() {\n      return doc as DocumentHandle;\n    },\n    documentHandle: () => doc,\n    subscribe: store.subscribe,\n    state: {\n      get: () => lease.read(),\n      update: (transition, ...args) => {\n        lease.write(transition(lease.read(), ...args));\n      },\n      onChange: lease.onChange,\n    },\n    settings: () => {\n      if (!settings) throw new Error(`[${id}] the test context declares no settings`);\n      return settings;\n    },\n    notify: store.notify,\n    watch: (select, handler, isEqual = Object.is) => {\n      let previous = select();\n      const off = store.subscribe(() => {\n        const next = select();\n        if (isEqual(previous, next)) return;\n        const prior = previous;\n        previous = next;\n        handler(next, prior);\n      });\n      cleanups.push(off);\n      return off;\n    },\n    mirror: (spec) => {\n      const controller = createMirror(spec, mirrorEnvironment());\n      mirrors.push(controller as MirrorController<unknown>);\n      return controller.mirror;\n    },\n    pageMirror: (spec) => createPageMirror(spec, mirrorEnvironment()),\n    changes: changes.forPlugin(id),\n    document: () => meta,\n    get: require,\n    tryGet: resolve,\n    forDocument: (token) => require(token),\n    tryForDocument: (token) => resolve(token),\n    cleanup: (fn) => {\n      cleanups.push(fn);\n    },\n    clock: instanceClock(options.clock ?? timerClock, lifetime.signal),\n    onSettle: (flush) => {\n      settleFlushes.add(flush);\n      cleanups.push(() => {\n        settleFlushes.delete(flush);\n      });\n    },\n    aroundDownload: (wrap) => {\n      downloadWraps.push(wrap);\n      cleanups.push(() => {\n        const index = downloadWraps.indexOf(wrap);\n        if (index >= 0) downloadWraps.splice(index, 1);\n      });\n    },\n    events: {\n      source: <T>() => {\n        const hook = createEventHook<T>((error) =>\n          console.error(`[${id}] listener failed:`, error),\n        );\n        cleanups.push(() => hook.dispose());\n        return hook;\n      },\n    },\n    listen: (source, listener) => {\n      const off = typeof source === 'function' ? source(listener) : source.subscribe(listener);\n      cleanups.push(off);\n    },\n    waitFor: (predicate, waitOptions?: OperationOptions) =>\n      new Promise<void>((resolveWait, reject) => {\n        if (predicate()) return resolveWait();\n        const off = context.subscribe(() => {\n          if (!predicate()) return;\n          off();\n          resolveWait();\n        });\n        waitOptions?.signal?.addEventListener('abort', () => {\n          off();\n          reject(new PluginError('operation-cancelled', id, 'waitFor cancelled'));\n        });\n      }),\n    serialQueue: (key = 'default') => {\n      let queue = queues.get(key);\n      if (!queue) {\n        queue = createSerialQueue(id);\n        queues.set(key, queue);\n      }\n      return queue;\n    },\n    latest: (key) => {\n      let lane = lanes.get(key);\n      if (!lane) {\n        lane = createLatestLane(lifetime.signal, id, key);\n        lanes.set(key, lane);\n      }\n      return lane;\n    },\n    acquire: async (get, dispose) => {\n      const resource = await get(lifetime.signal);\n      if (lifetime.signal.aborted) {\n        await dispose(resource);\n        throw new PluginError('instance-closed', id, 'acquired after close');\n      }\n      cleanups.push(() => dispose(resource));\n      return resource;\n    },\n    assertPageRef: (ref) => {\n      if (!pages.some((pageInfo) => pageRefsEqual(pageInfo.ref, ref))) throw notFound(ref);\n    },\n    getPage: (page) => findPage(pages, page),\n    pageOf: (page) => pageOf(pages, page, id),\n    allows: (permission) => sessionAllows(requireDoc().security, permission),\n    assertAllowed: (permission, operation) => {\n      if (!sessionAllows(requireDoc().security, permission)) {\n        throw permissionDenied(id, permission, operation);\n      }\n    },\n    allowsField: (action, field) =>\n      requireDoc().security.allowsField(action, { groupId: field.groupId }),\n    assertAllowedField: (action, field, operation) => {\n      if (!requireDoc().security.allowsField(action, { groupId: field.groupId })) {\n        throw fieldPermissionDenied(id, action, field, operation);\n      }\n    },\n    cancellable: (signal, task) => cancellable(id, signal, task),\n    capabilities,\n    connect: (instance) => {\n      instance.connect?.();\n      for (const mirror of mirrors.splice(0)) mirror.start();\n      return instance.api;\n    },\n    emitDocumentEvent: (event) => {\n      bursts.first(event);\n      documentEvents.emit(event);\n      bursts.last(event);\n    },\n    settle: (signal) => settle(settleFlushes, [signal, lifetime.signal], report),\n    download: (read) => readWrapped(downloadWraps, read),\n    dispose: async () => {\n      lifetime.abort();\n      for (const fn of cleanups.splice(0).reverse()) await fn();\n    },\n  };\n  return context;\n}\n\n/** A clock a test steps by hand (see {@link manualClock}). */\nexport interface ManualClock {\n  /** The clock to hand a test context or a kernel. */\n  readonly clock: HostClock;\n  /** The current time in milliseconds. It starts at 0. */\n  readonly now: number;\n  /** How many timers and frame callbacks are waiting. */\n  readonly pending: { readonly timers: number; readonly frames: number };\n  /** Move time forward by `ms`, running the timers that fall due, earliest first. */\n  advance(ms: number): void;\n  /**\n   * Show a frame at `timeMs` (default: now): move time there, running the\n   * timers due by then, and run the callbacks waiting for a frame. What they\n   * schedule waits for the next frame.\n   */\n  frame(timeMs?: number): void;\n}\n\n/**\n * Time that moves only when the test moves it. `frames: false` gives a host\n * that never paints, as Node is.\n */\nexport function manualClock(options: { frames?: boolean } = {}): ManualClock {\n  let now = 0;\n  let order = 0;\n  const timers = new Map<number, { due: number; run: () => void }>();\n  const frames = new Map<number, (timeMs: number) => void>();\n\n  const nextDue = (until: number): number | undefined => {\n    let found: number | undefined;\n    for (const [id, timer] of timers) {\n      if (timer.due > until) continue;\n      if (found === undefined || timer.due < timers.get(found)!.due) found = id;\n    }\n    return found;\n  };\n  const advanceTo = (target: number): void => {\n    if (target < now) throw new Error(`manualClock: time does not go back (${target} < ${now})`);\n    for (let id = nextDue(target); id !== undefined; id = nextDue(target)) {\n      const timer = timers.get(id)!;\n      timers.delete(id);\n      now = timer.due;\n      timer.run();\n    }\n    now = target;\n  };\n\n  const clock: HostClock = {\n    now: () => now,\n    after(ms, run): Cancel {\n      const id = ++order;\n      timers.set(id, { due: now + Math.max(0, ms), run });\n      return () => void timers.delete(id);\n    },\n    ...(options.frames === false\n      ? {}\n      : {\n          nextFrame(run: (timeMs: number) => void): Cancel {\n            const id = ++order;\n            frames.set(id, run);\n            return () => void frames.delete(id);\n          },\n        }),\n  };\n  return {\n    clock,\n    get now() {\n      return now;\n    },\n    get pending() {\n      return { timers: timers.size, frames: frames.size };\n    },\n    advance: (ms) => advanceTo(now + ms),\n    frame(timeMs = now) {\n      advanceTo(timeMs);\n      const due = [...frames.values()];\n      frames.clear();\n      for (const run of due) run(now);\n    },\n  };\n}\n\n/**\n * A faked document's members over the defaults every document has: calls'\n * facts and working sets change no result, so `with` gives the same fake and\n * a working set goes nowhere, unless the test fakes them.\n */\nfunction fakeDocument(members: Record<string, unknown>): DocumentHandle {\n  const fake: Record<string, unknown> = { setWorkingSet: () => {}, ...members };\n  fake.with ??= () => fake;\n  return fake as unknown as DocumentHandle;\n}\n"],"mappings":"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"}

package/dist/testing.d.cts

@@ -0,0 +1,94 @@
+import { It as HostClock, bt as SettingsDeclaration, gt as NoSettings, pt as Unsubscribe, r as CapabilityToken, rt as PluginContext } from "./types-t-DaU8VK.cjs";
+import { DocumentEvent, DocumentHandle, Engine, LOCAL_ENGINE_BRAND, PageLayout, PageRef, PdfRect } from "@embedpdf/engine-core/runtime";
+//#region src/testing.d.ts
+interface TestPage {
+  readonly ref: PageRef;
+  /** Page size in points (default 612 × 792, or the crop's extent); the crop box is `[0, 0, w, h]` unless given. */
+  readonly size?: {
+    readonly width: number;
+    readonly height: number;
+  };
+  readonly crop?: PdfRect;
+  readonly rotation?: PageLayout['rotation'];
+  readonly userUnit?: number;
+  readonly label?: string | null;
+}
+interface TestContextOptions<S, T extends object = NoSettings> {
+  /** The plugin id (`ctx.id`, error prefixes). Default `'test'`. */
+  readonly id?: string;
+  /** The instance's initial state; omit for a stateless plugin. */
+  readonly state?: S;
+  /**
+   * The plugin's settings, as its definition declares them; `ctx.settings()` reads them.
+   * Without them the context has none, and `ctx.settings()` throws.
+   */
+  readonly settings?: SettingsDeclaration<T>;
+  /** The document's pages; `document()` and `geometry` derive from them. */
+  readonly pages?: readonly TestPage[];
+  readonly documentId?: string;
+  /** Capabilities `get`/`tryGet` resolve, by token. `DocumentsToken` defaults to a
+   *  registry holding this one document. */
+  readonly capabilities?: ReadonlyArray<readonly [CapabilityToken<unknown>, unknown]>;
+  /** The document handle members the test exercises (`security`, `page`, `events`, …),
+   *  or a real engine document; `null` for a workspace plugin with no document. */
+  readonly doc?: Partial<DocumentHandle> | null;
+  readonly engine?: Partial<Engine>;
+  /** The host's time (`ctx.clock`). Default: `timerClock`, the environment's timers and no frames. */
+  readonly clock?: HostClock;
+}
+interface TestContext<S, T extends object = NoSettings> extends PluginContext<S, T> {
+  /** Every capability `get` can resolve — add or replace during a test. */
+  readonly capabilities: Map<CapabilityToken<unknown>, unknown>;
+  /** Observe the change stream: state updates and `notify` wake the listener. */
+  subscribe(listener: () => void): Unsubscribe;
+  /**
+   * What the kernel does after `create`: run the instance's `connect`, then
+   * start its mirrors' first loads. Returns the instance's api.
+   */
+  connect<C>(instance: {
+    api: C;
+    connect?: () => void;
+  }): C;
+  /** Deliver a confirmed document event, as the engine would (the default `doc.events`). */
+  emitDocumentEvent(event: DocumentEvent): void;
+  /** What `documents.download()` does first: run every `onSettle` flush and wait for it (settle.ts). */
+  settle(signal?: AbortSignal): Promise<void>;
+  /**
+   * What `documents.download()` does after settling: `read` the file inside every
+   * `aroundDownload` wrap, the first registered outermost.
+   */
+  download(read: () => Promise<Uint8Array>): Promise<Uint8Array>;
+  /** Run the registered cleanups and abort the lifetime (the plugin's unmount). */
+  dispose(): Promise<void>;
+}
+declare function createTestContext<S = void, T extends object = NoSettings>(options?: TestContextOptions<S, T>): TestContext<S, T>;
+/** A clock a test steps by hand (see {@link manualClock}). */
+interface ManualClock {
+  /** The clock to hand a test context or a kernel. */
+  readonly clock: HostClock;
+  /** The current time in milliseconds. It starts at 0. */
+  readonly now: number;
+  /** How many timers and frame callbacks are waiting. */
+  readonly pending: {
+    readonly timers: number;
+    readonly frames: number;
+  };
+  /** Move time forward by `ms`, running the timers that fall due, earliest first. */
+  advance(ms: number): void;
+  /**
+   * Show a frame at `timeMs` (default: now): move time there, running the
+   * timers due by then, and run the callbacks waiting for a frame. What they
+   * schedule waits for the next frame.
+   */
+  frame(timeMs?: number): void;
+}
+/**
+ * Time that moves only when the test moves it. `frames: false` gives a host
+ * that never paints, as Node is.
+ */
+declare function manualClock(options?: {
+  frames?: boolean;
+}): ManualClock;
+//#endregion
+export { LOCAL_ENGINE_BRAND, ManualClock, TestContext, TestContextOptions, TestPage, createTestContext, manualClock };
+//# sourceMappingURL=testing.d.cts.map

package/dist/testing.d.ts

@@ -0,0 +1,94 @@
+import { It as HostClock, bt as SettingsDeclaration, gt as NoSettings, pt as Unsubscribe, r as CapabilityToken, rt as PluginContext } from "./types-t-DaU8VK.js";
+import { DocumentEvent, DocumentHandle, Engine, LOCAL_ENGINE_BRAND, PageLayout, PageRef, PdfRect } from "@embedpdf/engine-core/runtime";
+//#region src/testing.d.ts
+interface TestPage {
+  readonly ref: PageRef;
+  /** Page size in points (default 612 × 792, or the crop's extent); the crop box is `[0, 0, w, h]` unless given. */
+  readonly size?: {
+    readonly width: number;
+    readonly height: number;
+  };
+  readonly crop?: PdfRect;
+  readonly rotation?: PageLayout['rotation'];
+  readonly userUnit?: number;
+  readonly label?: string | null;
+}
+interface TestContextOptions<S, T extends object = NoSettings> {
+  /** The plugin id (`ctx.id`, error prefixes). Default `'test'`. */
+  readonly id?: string;
+  /** The instance's initial state; omit for a stateless plugin. */
+  readonly state?: S;
+  /**
+   * The plugin's settings, as its definition declares them; `ctx.settings()` reads them.
+   * Without them the context has none, and `ctx.settings()` throws.
+   */
+  readonly settings?: SettingsDeclaration<T>;
+  /** The document's pages; `document()` and `geometry` derive from them. */
+  readonly pages?: readonly TestPage[];
+  readonly documentId?: string;
+  /** Capabilities `get`/`tryGet` resolve, by token. `DocumentsToken` defaults to a
+   *  registry holding this one document. */
+  readonly capabilities?: ReadonlyArray<readonly [CapabilityToken<unknown>, unknown]>;
+  /** The document handle members the test exercises (`security`, `page`, `events`, …),
+   *  or a real engine document; `null` for a workspace plugin with no document. */
+  readonly doc?: Partial<DocumentHandle> | null;
+  readonly engine?: Partial<Engine>;
+  /** The host's time (`ctx.clock`). Default: `timerClock`, the environment's timers and no frames. */
+  readonly clock?: HostClock;
+}
+interface TestContext<S, T extends object = NoSettings> extends PluginContext<S, T> {
+  /** Every capability `get` can resolve — add or replace during a test. */
+  readonly capabilities: Map<CapabilityToken<unknown>, unknown>;
+  /** Observe the change stream: state updates and `notify` wake the listener. */
+  subscribe(listener: () => void): Unsubscribe;
+  /**
+   * What the kernel does after `create`: run the instance's `connect`, then
+   * start its mirrors' first loads. Returns the instance's api.
+   */
+  connect<C>(instance: {
+    api: C;
+    connect?: () => void;
+  }): C;
+  /** Deliver a confirmed document event, as the engine would (the default `doc.events`). */
+  emitDocumentEvent(event: DocumentEvent): void;
+  /** What `documents.download()` does first: run every `onSettle` flush and wait for it (settle.ts). */
+  settle(signal?: AbortSignal): Promise<void>;
+  /**
+   * What `documents.download()` does after settling: `read` the file inside every
+   * `aroundDownload` wrap, the first registered outermost.
+   */
+  download(read: () => Promise<Uint8Array>): Promise<Uint8Array>;
+  /** Run the registered cleanups and abort the lifetime (the plugin's unmount). */
+  dispose(): Promise<void>;
+}
+declare function createTestContext<S = void, T extends object = NoSettings>(options?: TestContextOptions<S, T>): TestContext<S, T>;
+/** A clock a test steps by hand (see {@link manualClock}). */
+interface ManualClock {
+  /** The clock to hand a test context or a kernel. */
+  readonly clock: HostClock;
+  /** The current time in milliseconds. It starts at 0. */
+  readonly now: number;
+  /** How many timers and frame callbacks are waiting. */
+  readonly pending: {
+    readonly timers: number;
+    readonly frames: number;
+  };
+  /** Move time forward by `ms`, running the timers that fall due, earliest first. */
+  advance(ms: number): void;
+  /**
+   * Show a frame at `timeMs` (default: now): move time there, running the
+   * timers due by then, and run the callbacks waiting for a frame. What they
+   * schedule waits for the next frame.
+   */
+  frame(timeMs?: number): void;
+}
+/**
+ * Time that moves only when the test moves it. `frames: false` gives a host
+ * that never paints, as Node is.
+ */
+declare function manualClock(options?: {
+  frames?: boolean;
+}): ManualClock;
+//#endregion
+export { LOCAL_ENGINE_BRAND, ManualClock, TestContext, TestContextOptions, TestPage, createTestContext, manualClock };
+//# sourceMappingURL=testing.d.ts.map