docx-vue-viewer 1.2.0 → 1.3.1

package/README.md

@@ -73,6 +73,10 @@ read-only).
 [Framework guide](https://christophervr.github.io/ooxml/docx/frameworks/vue) |
 [Bindings](https://christophervr.github.io/ooxml/docx/bindings)
 
+## Privacy and network use
+
+The Word packages make no network request when opening, rendering, editing or saving a document: linked pictures are not fetched, linked data is not refreshed, and fonts come from the device only (nothing is downloaded from Google Fonts or any other font service). Hyperlinks open only when the reader follows them. Nothing collects analytics or telemetry. See [PRIVACY.md](https://github.com/ChristopherVR/ooxml/blob/main/PRIVACY.md).
+
 ## License
 
 Apache-2.0.

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as vue from 'vue';
 import { PropType, MaybeRefOrGetter } from 'vue';
 import { DocumentModel } from 'docx-core';
 export * from 'docx-core';
-import { DocumentStorage } from 'ooxml-core/embedding';
+import { DocumentStorage, CloudFileProvider, CloudOpenedFile } from 'ooxml-core/embedding';
 import { EditorTheme, EditorThemeMode, RibbonActionInput, RibbonAddInTab, DocxCollaborationOptions, WordCustomization, EditorLocaleInput, PageChangeDetail, FileCommandDetail, RibbonAction, RibbonAddInCommandDetail, DocxCollaborationState, DocxEditorElement, SurfaceHostActions, WordListState, WordAlignment, WordListChoice, WordNavigationProps, WordStatusProps, WordToolbarProps } from 'ooxml-ui/docx';
 export * from 'ooxml-ui/docx';
 export { WordNavigationProps, WordStatusProps, WordToolbarProps } from 'ooxml-ui/docx';
@@ -29,6 +29,7 @@ declare const WordEditor: vue.DefineComponent<vue.ExtractPropTypes<{
     ribbonAddIns: PropType<readonly RibbonAddInTab[]>;
     collaboration: PropType<DocxCollaborationOptions | null>;
     storage: PropType<DocumentStorage | null>;
+    fileProviders: PropType<readonly CloudFileProvider[] | null>;
     customization: PropType<WordCustomization | null>;
 }>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
@@ -49,6 +50,7 @@ declare const WordEditor: vue.DefineComponent<vue.ExtractPropTypes<{
     ribbonAddIns: PropType<readonly RibbonAddInTab[]>;
     collaboration: PropType<DocxCollaborationOptions | null>;
     storage: PropType<DocumentStorage | null>;
+    fileProviders: PropType<readonly CloudFileProvider[] | null>;
     customization: PropType<WordCustomization | null>;
 }>> & Readonly<{
     [x: `on${Capitalize<string>}`]: ((...args: any[]) => any) | undefined;
@@ -93,6 +95,13 @@ interface EditorProps {
      * File > Open to `storage.open()` when it has one. `file-command` still fires first.
      */
     storage?: DocumentStorage | null | undefined;
+    /**
+     * Cloud places for File > Open (OneDrive and the like): "This device" plus one place per
+     * provider. A file opened from a place saves through its own storage until another document
+     * loads, and is read-only when the provider says it cannot be edited. Forwarded when the array
+     * changes, so keep it stable; `null` or omitted removes the places.
+     */
+    fileProviders?: readonly CloudFileProvider[] | null | undefined;
     /**
      * Host customisation (`WordCustomization`): `capabilities`, `backstage.extraPages` and
      * `contextMenu.extraCommands`. Forwarded when the object changes, so keep it stable (memoise
@@ -143,6 +152,11 @@ interface EditorHandle {
     /** Saves and downloads in the browser, then marks the document clean. */
     download(fileName?: string): Promise<void>;
     markClean(): void;
+    /**
+     * Opens a file got from a `CloudFileProvider` (the host's own picker or a start page) the way File >
+     * Open > OneDrive does: its name, read-only state and storage for Save.
+     */
+    openCloudFile(file: CloudOpenedFile): Promise<void>;
     readonly dirty: boolean;
 }
 

package/dist/index.js

@@ -85,6 +85,11 @@ var E = [
 			fallback: null,
 			apply: (e, t) => e.storage = t ?? void 0
 		},
+		fileProviders: {
+			forward: "changed",
+			fallback: null,
+			apply: (e, t) => e.fileProviders = t ?? []
+		},
 		collaboration: {
 			forward: "changed",
 			fallback: null,
@@ -114,6 +119,7 @@ var E = [
 		save: "async",
 		download: "async",
 		markClean: "optional-call",
+		openCloudFile: "async",
 		dirty: { fallback: !1 }
 	}
 };
@@ -135,6 +141,7 @@ function O(e, n = {}, r = !1) {
 		save: () => i.save(),
 		download: (e) => i.download(e),
 		markClean: () => i.markClean(),
+		openCloudFile: (e) => i.openCloudFile(e),
 		get dirty() {
 			return i.dirty;
 		},
@@ -187,6 +194,7 @@ var A = e({
 		ribbonAddIns: Array,
 		collaboration: Object,
 		storage: Object,
+		fileProviders: Array,
 		customization: Object
 	},
 	contract: D,
@@ -263,6 +271,7 @@ function M(e = {}) {
 			save: () => m().save(),
 			download: (e) => m().download(e),
 			markClean: () => m().markClean(),
+			openCloudFile: (e) => m().openCloudFile(e),
 			get dirty() {
 				return n?.dirty ?? !1;
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "docx-vue-viewer",
-	"version": "1.2.0",
+	"version": "1.3.1",
 	"description": "Vue 3 component for the DOCX editor. Self-contained: includes the editor, layout engine and legacy .doc reader.",
 	"keywords": [
 		"doc",
@@ -40,9 +40,9 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"docx-core": "^1.1.0",
-		"ooxml-core": "^1.38.0",
-		"ooxml-ui": "^1.40.0"
+		"docx-core": "^1.1.1",
+		"ooxml-core": "^1.42.0",
+		"ooxml-ui": "^1.45.0"
 	},
 	"peerDependencies": {
 		"vue": "^3.5.0"