docx-vue-viewer 1.1.2 → 1.3.0

package/README.md

@@ -76,3 +76,12 @@ read-only).
 ## License
 
 Apache-2.0.
+
+## OneDrive integration
+
+Use the optional shared `ooxml-core/embedding/onedrive` connection with host-supplied Microsoft
+sign-in. See the [Office package and integration reference](https://github.com/ChristopherVR/ooxml/blob/main/docs/onedrive-integration.md#word-docx)
+for this product's load/save API, native storage wiring, sharing permissions and conflict recovery.
+The [testing guide](https://github.com/ChristopherVR/ooxml/blob/main/docs/onedrive-testing.md)
+separates test-local transports from live Microsoft acceptance. No simulation service is shipped;
+OneDrive storage does not provide Microsoft Office coauthoring or automatic document merging.

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.1.2",
+	"version": "1.3.0",
 	"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.0.0",
-		"ooxml-core": "^1.31.0",
-		"ooxml-ui": "^1.33.0"
+		"docx-core": "^1.1.0",
+		"ooxml-core": "^1.39.0",
+		"ooxml-ui": "^1.41.0"
 	},
 	"peerDependencies": {
 		"vue": "^3.5.0"