visio-solid-viewer 1.0.1 → 1.1.1

package/README.md

@@ -59,7 +59,7 @@ export function Diagram() {
 The shared properties are `document` (a parsed `VisioDocument`, or `null` to clear),
 `pageIndex` (zero-based), `zoom` (`1` means 100%), `showToolbar`, `ribbonAddIns` (tabs the host adds
 after Help), `canEdit` (editing permission; the viewer is editable unless you pass `false`),
-`collaboration` (shares the open drawing in a room while set; `null` leaves it) and `events`.
+`readOnly` (a restriction of its own), `storage` and `customization` (host-owned save and open), `collaboration` (shares the open drawing in a room while set; `null` leaves it) and `events`.
 The callback map uses `document-load`, `document-change` (`{ document, dirty, kind }` with kind
 `edit`, `undo`, `redo`, `remote` or `save`), `document-error`, `page-change`, `zoom-change`,
 `shape-select`, `selection-change`, `office-ribbon-add-in` and `collaboration-change`. File loading uses the imperative

package/dist/index.js

@@ -2,18 +2,52 @@ import * as ui from "ooxml-ui/visio";
 import { ViewerController, createWorkerParser, mountViewer, propertyKeys } from "ooxml-ui/visio";
 import { className, createComponent, delegateEvents, effect, insert, setAttribute, style, template, use } from "solid-js/web";
 import { For, Index, Match, Switch, createEffect, createMemo, createSignal, onCleanup, onMount } from "solid-js";
+import { deferredHandle, pickProps } from "ooxml-ui/bindings";
 import * as officeTheme from "ooxml-ui/theme";
 export * from "ooxml-ui/visio";
 export * from "visio-core";
 //#region packages/bindings/src/common.ts
+/**
+* The Visio binding contract. `mountViewer` (ooxml-ui/visio) forwards properties and events itself,
+* so every property is `manual` here: `mountFrameworkViewer` sends them as revision-aware patches.
+* Events reach native outputs through the `events` callback map (`withEventEmitter`).
+*/
+var VIEWER_CONTRACT = {
+	props: Object.fromEntries(propertyKeys.map((key) => [key, { forward: "manual" }])),
+	events: {},
+	handle: {
+		element: "get",
+		controller: "get",
+		load: "async",
+		createBlankDrawing: "async",
+		applyEdits: "async",
+		selectShapes: "call",
+		selectAll: "call",
+		clearSelection: "call",
+		duplicateSelection: "async",
+		copySelection: "async",
+		cutSelection: "async",
+		pasteSelection: "async",
+		replacePlainText: "async",
+		undo: "async",
+		redo: "async",
+		cancelEdit: "call",
+		exportVsdx: "call",
+		fit: "call",
+		setLayerVisibility: "call",
+		resetLayerVisibility: "call",
+		exportSvg: "call",
+		createPrintSnapshot: "call"
+	}
+};
+/** The error every lazy handle member throws before mount and after unmount. */
+var VIEWER_HANDLE_OPTIONS = { message: "The viewer is not mounted." };
 /** One mapping for every property and event, shared by every framework adapter. */
 function viewerOptions(props) {
-	const result = { events: props.events ?? {} };
-	for (const key of propertyKeys) {
-		const value = props[key];
-		if (value !== void 0) Object.assign(result, { [key]: value });
-	}
-	return result;
+	return {
+		events: props.events ?? {},
+		...pickProps(VIEWER_CONTRACT, props, true)
+	};
 }
 /**
 * Native props are snapshots, while the browser binding accepts explicit patches. Forward only
@@ -36,6 +70,7 @@ function mountFrameworkViewer(container, initial) {
 				const touchedByOlderCall = [...activePatches].some((active) => key in active);
 				if (snapshot[key] !== void 0 && (snapshot[key] !== previous[key] || touchedByOlderCall)) Object.assign(patch, { [key]: snapshot[key] });
 			}
+			if (snapshot.readOnly === void 0 && previous.readOnly !== void 0) Object.assign(patch, { readOnly: false });
 			activePatches.add(patch);
 			try {
 				binding.update(patch);
@@ -54,79 +89,7 @@ function mountFrameworkViewer(container, initial) {
 }
 /** Lazy imperative methods reject both before mount and after unmount. */
 function viewerHandle(current) {
-	const requireViewer = () => {
-		const binding = current();
-		if (!binding) throw new Error("The viewer is not mounted.");
-		return binding;
-	};
-	return {
-		get element() {
-			return requireViewer().element;
-		},
-		get controller() {
-			return requireViewer().controller;
-		},
-		async load(source) {
-			await requireViewer().load(source);
-		},
-		async createBlankDrawing(options) {
-			await requireViewer().createBlankDrawing(options);
-		},
-		async applyEdits(edits) {
-			await requireViewer().applyEdits(edits);
-		},
-		selectShapes(shapes) {
-			requireViewer().selectShapes(shapes);
-		},
-		selectAll() {
-			requireViewer().selectAll();
-		},
-		clearSelection() {
-			requireViewer().clearSelection();
-		},
-		async replacePlainText(pageId, shapeId, text) {
-			await requireViewer().replacePlainText(pageId, shapeId, text);
-		},
-		async duplicateSelection() {
-			await requireViewer().duplicateSelection();
-		},
-		async copySelection() {
-			await requireViewer().copySelection();
-		},
-		async cutSelection() {
-			await requireViewer().cutSelection();
-		},
-		async pasteSelection() {
-			await requireViewer().pasteSelection();
-		},
-		async undo() {
-			await requireViewer().undo();
-		},
-		async redo() {
-			await requireViewer().redo();
-		},
-		cancelEdit() {
-			requireViewer().cancelEdit();
-		},
-		exportVsdx() {
-			return requireViewer().exportVsdx();
-		},
-		fit() {
-			requireViewer().fit();
-		},
-		setLayerVisibility(pageId, layerId, visible) {
-			requireViewer().setLayerVisibility(pageId, layerId, visible);
-		},
-		resetLayerVisibility(pageId) {
-			requireViewer().resetLayerVisibility(pageId);
-		},
-		exportSvg(options) {
-			return requireViewer().exportSvg(options);
-		},
-		createPrintSnapshot(options) {
-			return requireViewer().createPrintSnapshot(options);
-		}
-	};
+	return deferredHandle(VIEWER_CONTRACT.handle, current, VIEWER_HANDLE_OPTIONS);
 }
 function viewerStateSource(current) {
 	const controller = () => {

package/dist/index.server.js

@@ -2,18 +2,52 @@ import * as ui from "ooxml-ui/visio";
 import { ViewerController, createWorkerParser, mountViewer, propertyKeys } from "ooxml-ui/visio";
 import { createComponent, escape, ssr, ssrAttribute, ssrHydrationKey, ssrStyle } from "solid-js/web";
 import { For, Index, Match, Switch, createEffect, createMemo, createSignal, onCleanup, onMount } from "solid-js";
+import { deferredHandle, pickProps } from "ooxml-ui/bindings";
 import "ooxml-ui/theme";
 export * from "ooxml-ui/visio";
 export * from "visio-core";
 //#region packages/bindings/src/common.ts
+/**
+* The Visio binding contract. `mountViewer` (ooxml-ui/visio) forwards properties and events itself,
+* so every property is `manual` here: `mountFrameworkViewer` sends them as revision-aware patches.
+* Events reach native outputs through the `events` callback map (`withEventEmitter`).
+*/
+var VIEWER_CONTRACT = {
+	props: Object.fromEntries(propertyKeys.map((key) => [key, { forward: "manual" }])),
+	events: {},
+	handle: {
+		element: "get",
+		controller: "get",
+		load: "async",
+		createBlankDrawing: "async",
+		applyEdits: "async",
+		selectShapes: "call",
+		selectAll: "call",
+		clearSelection: "call",
+		duplicateSelection: "async",
+		copySelection: "async",
+		cutSelection: "async",
+		pasteSelection: "async",
+		replacePlainText: "async",
+		undo: "async",
+		redo: "async",
+		cancelEdit: "call",
+		exportVsdx: "call",
+		fit: "call",
+		setLayerVisibility: "call",
+		resetLayerVisibility: "call",
+		exportSvg: "call",
+		createPrintSnapshot: "call"
+	}
+};
+/** The error every lazy handle member throws before mount and after unmount. */
+var VIEWER_HANDLE_OPTIONS = { message: "The viewer is not mounted." };
 /** One mapping for every property and event, shared by every framework adapter. */
 function viewerOptions(props) {
-	const result = { events: props.events ?? {} };
-	for (const key of propertyKeys) {
-		const value = props[key];
-		if (value !== void 0) Object.assign(result, { [key]: value });
-	}
-	return result;
+	return {
+		events: props.events ?? {},
+		...pickProps(VIEWER_CONTRACT, props, true)
+	};
 }
 /**
 * Native props are snapshots, while the browser binding accepts explicit patches. Forward only
@@ -36,6 +70,7 @@ function mountFrameworkViewer(container, initial) {
 				const touchedByOlderCall = [...activePatches].some((active) => key in active);
 				if (snapshot[key] !== void 0 && (snapshot[key] !== previous[key] || touchedByOlderCall)) Object.assign(patch, { [key]: snapshot[key] });
 			}
+			if (snapshot.readOnly === void 0 && previous.readOnly !== void 0) Object.assign(patch, { readOnly: false });
 			activePatches.add(patch);
 			try {
 				binding.update(patch);
@@ -54,79 +89,7 @@ function mountFrameworkViewer(container, initial) {
 }
 /** Lazy imperative methods reject both before mount and after unmount. */
 function viewerHandle(current) {
-	const requireViewer = () => {
-		const binding = current();
-		if (!binding) throw new Error("The viewer is not mounted.");
-		return binding;
-	};
-	return {
-		get element() {
-			return requireViewer().element;
-		},
-		get controller() {
-			return requireViewer().controller;
-		},
-		async load(source) {
-			await requireViewer().load(source);
-		},
-		async createBlankDrawing(options) {
-			await requireViewer().createBlankDrawing(options);
-		},
-		async applyEdits(edits) {
-			await requireViewer().applyEdits(edits);
-		},
-		selectShapes(shapes) {
-			requireViewer().selectShapes(shapes);
-		},
-		selectAll() {
-			requireViewer().selectAll();
-		},
-		clearSelection() {
-			requireViewer().clearSelection();
-		},
-		async replacePlainText(pageId, shapeId, text) {
-			await requireViewer().replacePlainText(pageId, shapeId, text);
-		},
-		async duplicateSelection() {
-			await requireViewer().duplicateSelection();
-		},
-		async copySelection() {
-			await requireViewer().copySelection();
-		},
-		async cutSelection() {
-			await requireViewer().cutSelection();
-		},
-		async pasteSelection() {
-			await requireViewer().pasteSelection();
-		},
-		async undo() {
-			await requireViewer().undo();
-		},
-		async redo() {
-			await requireViewer().redo();
-		},
-		cancelEdit() {
-			requireViewer().cancelEdit();
-		},
-		exportVsdx() {
-			return requireViewer().exportVsdx();
-		},
-		fit() {
-			requireViewer().fit();
-		},
-		setLayerVisibility(pageId, layerId, visible) {
-			requireViewer().setLayerVisibility(pageId, layerId, visible);
-		},
-		resetLayerVisibility(pageId) {
-			requireViewer().resetLayerVisibility(pageId);
-		},
-		exportSvg(options) {
-			return requireViewer().exportSvg(options);
-		},
-		createPrintSnapshot(options) {
-			return requireViewer().createPrintSnapshot(options);
-		}
-	};
+	return deferredHandle(VIEWER_CONTRACT.handle, current, VIEWER_HANDLE_OPTIONS);
 }
 function viewerStateSource(current) {
 	const controller = () => {

package/dist/types/packages/bindings/src/common.d.ts

@@ -1,5 +1,6 @@
 import { mountViewer, type MountedViewer } from 'ooxml-ui/visio';
 import type { ViewerState } from 'ooxml-ui/visio';
+import { type BindingContract } from 'ooxml-ui/bindings';
 import { eventKeys, propertyKeys, type ViewerCallbacks, type ViewerOptions, type ViewerProperties } from 'ooxml-ui/visio';
 /** Framework props permit undefined; omitted values preserve the shared binding's state. */
 export type ViewerProps = {
@@ -8,6 +9,16 @@ export type ViewerProps = {
     events?: ViewerCallbacks | undefined;
 };
 export type ViewerHandle = Pick<MountedViewer, 'element' | 'controller' | 'load' | 'createBlankDrawing' | 'applyEdits' | 'selectShapes' | 'selectAll' | 'clearSelection' | 'duplicateSelection' | 'copySelection' | 'cutSelection' | 'pasteSelection' | 'replacePlainText' | 'undo' | 'redo' | 'cancelEdit' | 'exportVsdx' | 'fit' | 'setLayerVisibility' | 'resetLayerVisibility' | 'exportSvg' | 'createPrintSnapshot'>;
+/**
+ * The Visio binding contract. `mountViewer` (ooxml-ui/visio) forwards properties and events itself,
+ * so every property is `manual` here: `mountFrameworkViewer` sends them as revision-aware patches.
+ * Events reach native outputs through the `events` callback map (`withEventEmitter`).
+ */
+export declare const VIEWER_CONTRACT: BindingContract<never, ViewerProperties, ViewerHandle>;
+/** The error every lazy handle member throws before mount and after unmount. */
+export declare const VIEWER_HANDLE_OPTIONS: {
+    readonly message: "The viewer is not mounted.";
+};
 /** One mapping for every property and event, shared by every framework adapter. */
 export declare function viewerOptions(props: ViewerProps): ViewerOptions;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "visio-solid-viewer",
-	"version": "1.0.1",
+	"version": "1.1.1",
 	"description": "Local-first Visio viewer for solid",
 	"homepage": "https://christophervr.github.io/ooxml/visio/",
 	"bugs": {
@@ -32,8 +32,8 @@
 	},
 	"dependencies": {
 		"emf-converter": "4.21.0",
-		"ooxml-core": "^1.23.0",
-		"ooxml-ui": "^1.22.0",
+		"ooxml-core": "^1.25.0",
+		"ooxml-ui": "^1.26.0",
 		"visio-core": "^1.0.1"
 	},
 	"peerDependencies": {