@a3s-lab/office 0.32.0 → 0.33.0

package/dist/pdf-page-organization.worker.js.LICENSE.txt

@@ -0,0 +1,14 @@
+/*! *****************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */

package/dist/react.d.ts

@@ -3,6 +3,7 @@ import type { DocumentEditorProps as InternalDocumentEditorProps } from './inter
 import type { MarkdownEditorProps as InternalMarkdownEditorProps } from './internal/features/work/editors/markdown-editor';
 import type { PdfViewerProps as InternalPdfViewerProps } from './internal/features/work/editors/pdf-viewer';
 export { PDF_EVIDENCE_COORDINATE_BASIS, type PdfEvidenceBounds, type PdfEvidenceOverlay, type PdfEvidencePage, type PdfEvidenceRegion, type PdfEvidenceRegionLocation, } from './internal/features/work/editors/pdf-evidence-contract';
+export type { PdfPageOrganizationExport } from './internal/features/work/editors/use-pdf-page-organization';
 import type { PresentationEditorProps as InternalPresentationEditorProps } from './internal/features/work/editors/presentation-editor';
 import type { SpreadsheetEditorProps as InternalSpreadsheetEditorProps } from './internal/features/work/editors/spreadsheet-editor';
 import type { WorkOfficeFileAction } from './internal/features/work/editors/work-office-chrome';

package/dist/styles.css

@@ -22700,6 +22700,321 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   }
 }
 
+.work-pdf-page-organization {
+  border-right: 1px solid var(--a3s-line);
+  padding-right: 5px;
+}
+
+.work-pdf-page-organizer-trigger.ds-button {
+  border-color: #0000;
+  gap: 5px;
+  height: 28px;
+  min-height: 28px;
+  padding-inline: 8px;
+  font-size: 10px;
+}
+
+.work-pdf-page-organizer-dialog {
+  width: min(980px, 100%);
+}
+
+.work-pdf-page-organizer-dialog .ds-dialog-body {
+  gap: 12px;
+  min-height: 0;
+  display: grid;
+}
+
+.work-pdf-page-organizer-actions {
+  grid-template-columns: repeat(9, minmax(72px, 1fr));
+  gap: 5px;
+  display: grid;
+}
+
+.work-pdf-page-organizer-actions .ds-button {
+  white-space: nowrap;
+  gap: 5px;
+  min-width: 0;
+  min-height: 36px;
+  padding-inline: 7px;
+  font-size: 10px;
+}
+
+.work-pdf-page-organizer-selection {
+  min-height: 28px;
+  color: var(--a3s-muted);
+  align-items: center;
+  gap: 8px;
+  font-size: 11px;
+  display: flex;
+}
+
+.work-pdf-page-organizer-selection output {
+  font-variant-numeric: tabular-nums;
+  margin-right: auto;
+  font-weight: 650;
+}
+
+.work-pdf-page-organizer-selection button {
+  border: 1px solid var(--a3s-line);
+  background: var(--a3s-panel);
+  min-height: 28px;
+  color: var(--a3s-muted);
+  font: inherit;
+  cursor: pointer;
+  border-radius: 6px;
+  padding: 0 9px;
+}
+
+.work-pdf-page-organizer-selection button:hover:not(:disabled), .work-pdf-page-organizer-selection button:focus-visible {
+  border-color: var(--a3s-line-strong);
+  background: var(--a3s-panel-soft);
+  color: var(--a3s-ink);
+  outline: 0;
+}
+
+.work-pdf-page-organizer-viewport {
+  border: 1px solid var(--a3s-line);
+  background: linear-gradient(var(--a3s-panel-soft), var(--a3s-panel-soft)) padding-box,
+    var(--a3s-panel-soft);
+  overscroll-behavior: contain;
+  scrollbar-gutter: stable;
+  border-radius: 10px;
+  height: min(51vh, 552px);
+  min-height: 260px;
+  overflow: auto;
+}
+
+.work-pdf-page-organizer-list {
+  gap: 12px;
+  padding: 12px;
+  display: grid;
+}
+
+.work-pdf-page-organizer-list > span[aria-hidden="true"] {
+  display: block;
+}
+
+.work-pdf-page-organizer-list > button {
+  border: 1px solid var(--a3s-line);
+  background: var(--a3s-panel);
+  width: 100%;
+  height: 172px;
+  color: var(--a3s-ink);
+  text-align: left;
+  cursor: grab;
+  border-radius: 9px;
+  outline: 0;
+  grid-template-columns: 72px minmax(0, 1fr);
+  align-items: center;
+  gap: 14px;
+  padding: 12px 16px;
+  transition: border-color .12s, background-color .12s, box-shadow .12s;
+  display: grid;
+}
+
+.work-pdf-page-organizer-list > button:hover:not(:disabled) {
+  border-color: var(--a3s-line-strong);
+  background: color-mix(in srgb, var(--work-pdf-accent) 3%, var(--a3s-panel));
+}
+
+.work-pdf-page-organizer-list > button:focus-visible {
+  border-color: var(--work-pdf-accent);
+  box-shadow: 0 0 0 2px
+    color-mix(in srgb, var(--work-pdf-accent) 18%, transparent);
+}
+
+.work-pdf-page-organizer-list > button.selected {
+  border-color: color-mix(in srgb, var(--work-pdf-accent) 70%, var(--a3s-line));
+  background: color-mix(in srgb, var(--work-pdf-accent) 8%, var(--a3s-panel));
+}
+
+.work-pdf-page-organizer-list > button:active:not(:disabled) {
+  cursor: grabbing;
+}
+
+.work-pdf-page-organizer-number {
+  color: var(--a3s-ink);
+  font-variant-numeric: tabular-nums;
+  justify-items: center;
+  gap: 5px;
+  font-size: 18px;
+  font-weight: 700;
+  display: grid;
+}
+
+.work-pdf-page-organizer-number small {
+  background: color-mix(in srgb, var(--work-pdf-accent) 10%, var(--a3s-panel));
+  color: var(--work-pdf-accent);
+  border-radius: 999px;
+  padding: 2px 6px;
+  font-size: 9px;
+  font-weight: 650;
+}
+
+.work-pdf-page-organizer-preview {
+  border: 1px solid var(--a3s-line);
+  background: #e7e9ee;
+  border-radius: 4px;
+  justify-self: center;
+  place-items: center;
+  width: min(100%, 560px);
+  height: 146px;
+  display: grid;
+  overflow: hidden;
+}
+
+.work-pdf-page-organizer-preview img {
+  object-fit: contain;
+  max-width: 100%;
+  max-height: 100%;
+  display: block;
+}
+
+.work-pdf-page-organizer-preview[data-state="loading"]:after {
+  content: "";
+  background: linear-gradient(90deg, #ffffff47, #ffffffc2, #ffffff47);
+  border-radius: 999px;
+  width: 48%;
+  height: 8px;
+  animation: 1.1s ease-in-out infinite work-pdf-organizer-loading;
+}
+
+.work-pdf-page-organizer-preview[data-state="error"]:after {
+  color: #676d78;
+  content: "无法生成缩略图";
+  font-size: 10px;
+}
+
+.work-pdf-page-organizer-error, .work-pdf-page-organizer-diagnostics, .work-pdf-page-organizer-boundary {
+  border: 1px solid var(--a3s-line);
+  border-radius: 8px;
+  margin: 0;
+  padding: 10px 12px;
+  font-size: 11px;
+  line-height: 1.5;
+}
+
+.work-pdf-page-organizer-error {
+  border-color: color-mix(in srgb, var(--a3s-red) 38%, var(--a3s-line));
+  background: color-mix(in srgb, var(--a3s-red) 5%, var(--a3s-panel));
+  color: var(--a3s-red);
+  align-items: flex-start;
+  gap: 12px;
+  display: flex;
+}
+
+.work-pdf-page-organizer-error > div {
+  flex: 1;
+  min-width: 0;
+}
+
+.work-pdf-page-organizer-error p {
+  overflow-wrap: anywhere;
+  margin: 2px 0 4px;
+}
+
+.work-pdf-page-organizer-error code {
+  font-size: 9px;
+}
+
+.work-pdf-page-organizer-error > button {
+  color: currentColor;
+  cursor: pointer;
+  background: none;
+  border: 0;
+  border-radius: 6px;
+  width: 30px;
+  height: 30px;
+  padding: 0;
+  font-size: 18px;
+}
+
+.work-pdf-page-organizer-diagnostics {
+  border-color: color-mix(in srgb, #b7791f 35%, var(--a3s-line));
+  color: #8b5e16;
+  padding-left: 28px;
+}
+
+.work-pdf-page-organizer-boundary {
+  background: var(--a3s-panel-soft);
+  color: var(--a3s-muted);
+}
+
+@keyframes work-pdf-organizer-loading {
+  0%, 100% {
+    opacity: .45;
+    transform: translateX(-12%);
+  }
+
+  50% {
+    opacity: 1;
+    transform: translateX(12%);
+  }
+}
+
+@media (width <= 980px) {
+  .work-pdf-page-organization {
+    display: none;
+  }
+
+  .work-pdf-page-organizer-actions {
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+  }
+}
+
+@media (width <= 560px) {
+  .work-pdf-page-organizer-dialog .ds-dialog-body {
+    gap: 9px;
+  }
+
+  .work-pdf-page-organizer-actions {
+    overscroll-behavior: contain;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    max-height: 188px;
+    overflow-y: auto;
+  }
+
+  .work-pdf-page-organizer-actions .ds-button {
+    min-height: 44px;
+  }
+
+  .work-pdf-page-organizer-selection button {
+    min-width: 44px;
+    min-height: 36px;
+  }
+
+  .work-pdf-page-organizer-viewport {
+    height: min(38vh, 420px);
+    min-height: 220px;
+  }
+
+  .work-pdf-page-organizer-list {
+    padding-inline: 8px;
+  }
+
+  .work-pdf-page-organizer-list > button {
+    grid-template-columns: 48px minmax(0, 1fr);
+    padding-inline: 10px;
+  }
+
+  .work-pdf-page-organizer-number {
+    font-size: 15px;
+  }
+}
+
+@media (forced-colors: active) {
+  .work-pdf-page-organizer-list > button.selected {
+    outline: 2px solid highlight;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .work-pdf-page-organizer-list > button, .work-pdf-page-organizer-preview[data-state="loading"]:after {
+    transition: none;
+    animation: none;
+  }
+}
+
 .work-pdf-export-surface {
   z-index: -1000;
   color: #20232b;

package/dist/vue.d.ts

@@ -1,6 +1,6 @@
 import type { Extensions } from '@tiptap/core';
 import { type PropType } from 'vue';
-import type { DocumentContent, DocumentReviewConflictEvent, EditorAgentRequest, GetDocumentSelectionMenuItems, GetMarkdownSelectionMenuItems, MarkdownContent, OfficeCollaborationPresence, OfficeCollaborationSession, PdfCollaborationContent, PresentationContent, SpreadsheetContent } from './core';
+import type { DocumentContent, DocumentReviewConflictEvent, EditorAgentRequest, GetDocumentSelectionMenuItems, GetMarkdownSelectionMenuItems, MarkdownContent, OfficeCollaborationPresence, OfficeCollaborationSession, PdfCollaborationContent, PdfPageOrganizationExport, PresentationContent, SpreadsheetContent } from './core';
 import type { OfficeTheme } from './office-surface';
 import { type DocumentLayoutFont, type OfficeFileAction, type PdfEvidenceOverlay, type PdfEvidenceRegion } from './react';
 export declare const DocumentEditor: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -274,6 +274,7 @@ export declare const PdfViewer: import("vue").DefineComponent<import("vue").Extr
         type: PropType<() => Promise<Blob>>;
     };
     onSave: PropType<(pdf: Blob) => Promise<boolean>>;
+    onPageExport: PropType<(files: readonly PdfPageOrganizationExport[]) => boolean | Promise<boolean>>;
     saveLabel: StringConstructor;
     selectedEvidenceRegionId: StringConstructor;
     sourceKey: StringConstructor;
@@ -302,6 +303,7 @@ export declare const PdfViewer: import("vue").DefineComponent<import("vue").Extr
         type: PropType<() => Promise<Blob>>;
     };
     onSave: PropType<(pdf: Blob) => Promise<boolean>>;
+    onPageExport: PropType<(files: readonly PdfPageOrganizationExport[]) => boolean | Promise<boolean>>;
     saveLabel: StringConstructor;
     selectedEvidenceRegionId: StringConstructor;
     sourceKey: StringConstructor;

package/dist/vue.js

@@ -232,6 +232,7 @@ const PdfViewer = defineComponent({
             type: Function
         },
         onSave: Function,
+        onPageExport: Function,
         saveLabel: String,
         selectedEvidenceRegionId: String,
         sourceKey: String,
@@ -257,6 +258,7 @@ const PdfViewer = defineComponent({
                 onCollaborationChange: (content)=>emit('collaborationChange', content),
                 onEvidenceRegionSelect: (region)=>emit('evidenceRegionSelect', region),
                 onPageChange: (pageNumber)=>emit('pageChange', pageNumber),
+                onPageExport: props.onPageExport,
                 onSave: props.onSave,
                 saveLabel: props.saveLabel,
                 selectedEvidenceRegionId: props.selectedEvidenceRegionId,

package/dist/web-component.d.ts

@@ -1,6 +1,6 @@
 import type { Extensions } from '@tiptap/core';
 import { type ReactNode } from 'react';
-import type { DocumentContent, EditorAgentRequest, GetDocumentSelectionMenuItems, GetMarkdownSelectionMenuItems, MarkdownContent, OfficeCollaborationPresence, OfficeCollaborationSession, PdfCollaborationContent, PresentationContent, SpreadsheetContent } from './core';
+import type { DocumentContent, EditorAgentRequest, GetDocumentSelectionMenuItems, GetMarkdownSelectionMenuItems, MarkdownContent, OfficeCollaborationPresence, OfficeCollaborationSession, PdfCollaborationContent, PdfPageOrganizationExport, PresentationContent, SpreadsheetContent } from './core';
 import type { OfficeTheme } from './office-surface';
 import { type DocumentLayoutFont, type OfficeFileAction, type PdfEvidenceOverlay } from './react';
 declare const HTMLElementBase: {
@@ -92,6 +92,8 @@ export declare class A3SPdfViewerElement extends A3SOfficeElement {
     set onCollaborationChange(value: ((content: PdfCollaborationContent) => void) | undefined);
     get onSave(): ((pdf: Blob) => Promise<boolean>) | undefined;
     set onSave(value: ((pdf: Blob) => Promise<boolean>) | undefined);
+    get onPageExport(): ((files: readonly PdfPageOrganizationExport[]) => boolean | Promise<boolean>) | undefined;
+    set onPageExport(value: ((files: readonly PdfPageOrganizationExport[]) => boolean | Promise<boolean>) | undefined);
     get selectedEvidenceRegionId(): string | undefined;
     set selectedEvidenceRegionId(value: string | undefined);
     get theme(): OfficeTheme;

package/dist/web-component.js

@@ -308,6 +308,7 @@ class A3SPdfViewerElement extends A3SOfficeElement {
     #loadSource;
     #onCollaborationChange;
     #onSave;
+    #onPageExport;
     static get observedAttributes() {
         return [
             'file-name',
@@ -354,6 +355,13 @@ class A3SPdfViewerElement extends A3SOfficeElement {
         this.#onSave = value;
         this.requestRender();
     }
+    get onPageExport() {
+        return this.#onPageExport;
+    }
+    set onPageExport(value) {
+        this.#onPageExport = value;
+        this.requestRender();
+    }
     get selectedEvidenceRegionId() {
         return this.getAttribute('selected-evidence-region-id') ?? void 0;
     }
@@ -387,6 +395,7 @@ class A3SPdfViewerElement extends A3SOfficeElement {
             },
             onEvidenceRegionSelect: (region)=>dispatchDetail(this, 'evidence-select', region),
             onPageChange: (pageNumber)=>dispatchDetail(this, 'page-change', pageNumber),
+            onPageExport: this.onPageExport,
             onSave: this.onSave,
             saveLabel: this.getAttribute('save-label') ?? void 0,
             selectedEvidenceRegionId: this.selectedEvidenceRegionId,

package/docs/latest/en/browser-editor-architecture.md

@@ -1556,13 +1556,36 @@ pages: EmbedPDF already mounts only six to seven pages behind its Shadow DOM
 boundary, while CSS containment cannot cancel PDFium tasks or release bitmap
 memory.
 
-Existing PDF password handling remains in the PDF document lifecycle rather
-than the removed toolbar. Form-authoring controls, redaction review, page
-organization, and compatibility fixtures remain part of this stage.
+The first PDF-workbench slice adds a second lazy Worker boundary for page
+organization. The UI sends bounded source bytes plus a typed insert, delete,
+rotate, reorder, merge, extract, or split plan to `pdf-lib`; it never moves a
+`PDFDocument` or page object across threads. A source mutation transfers one
+result byte array back, replaces the viewer's complete Blob, reopens it in
+PDFium, and records the before/after Blob pair as one Undo entry. Exports return
+typed files without changing the source or history. The toolbar consumes
+PDFium annotation/form history before this page history, so one user intent
+never spans both stacks. Primary sources are capped at 256 MiB, merge inputs at
+128 MiB, and each result at 4,096 pages.
+
+The rewrite boundary is fail closed. Malformed, encrypted, or signed sources
+cannot be mutated. Delete, reorder, and merge additionally reject forms,
+outlines, and tagged structure because their catalog references cannot yet be
+rewritten safely. Extract and split can copy page ranges while returning an
+explicit diagnostic for omitted document-level objects. Collaboration and
+evidence-overlay sessions hide page organization because both attach stable
+records to immutable source-page identities. `onPageExport` is the typed host
+port for derived files; `onSave` remains the only persistence port for the
+mutated source.
 
-Exit criteria: annotations and form changes survive reopen; destructive
-redaction requires an explicit review step; large documents render a bounded
-page window rather than the complete file.
+Existing PDF password handling remains in the PDF document lifecycle rather
+than the removed toolbar. Form-authoring controls, redaction review,
+document-level catalog rewriting, and broader compatibility fixtures remain
+part of this stage.
+
+Exit criteria: annotations, form changes, and page mutations survive PDFium and
+independent-parser reopen; destructive redaction requires an explicit review
+step; large documents render a bounded page window rather than the complete
+file.
 
 ### Stage 6: loss-preserving Office persistence
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -114,6 +114,7 @@
     "playground:visual:spreadsheet-rich-text": "playwright test visual-tests/spreadsheet-rich-text.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-underline": "playwright test visual-tests/spreadsheet-underline.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-table": "playwright test visual-tests/spreadsheet-table.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:pdf-page-organization": "playwright test visual-tests/pdf-page-organization.functional.spec.ts --config playwright.config.ts",
     "playground:visual:update": "playwright test --config playwright.config.ts --update-snapshots",
     "performance:fixtures": "bun .a3s-test/performance/generate-fixtures.ts",
     "performance:large-document-edits": "bun .a3s-test/performance/generate-fixtures.ts --documents-only && bun .a3s-test/performance/benchmark-document-edit.ts http://127.0.0.1:4175/ 3",
@@ -130,6 +131,8 @@
     "test:e2e:large-documents:check": "a3s-test check tests/e2e/word-large-document-windowing.acl --json",
     "test:e2e:large-pdf": "bun .a3s-test/performance/generate-fixtures.ts --pdf-only && a3s-test run tests/e2e/pdf-large-windowing.acl --json",
     "test:e2e:large-pdf:check": "a3s-test check tests/e2e/pdf-large-windowing.acl --json",
+    "test:e2e:pdf-page-organization": "bun run test:e2e:fixtures && A3S_TEST_SUITE=tests/e2e/pdf-page-organization.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:pdf-page-organization:check": "a3s-test check tests/e2e/pdf-page-organization.acl --json",
     "test:e2e:large-presentation": "bun .a3s-test/performance/generate-fixtures.ts --presentations-only && a3s-test run tests/e2e/presentation-large-windowing.acl --json",
     "test:e2e:large-presentation:check": "a3s-test check tests/e2e/presentation-large-windowing.acl --json",
     "test:e2e:initial-focus": "a3s-test run tests/e2e/office-editor-initial-focus.acl --json",
@@ -284,6 +287,7 @@
     "jszip": "^3.10.1",
     "lucide-react": "^0.544.0",
     "mammoth": "^1.12.0",
+    "pdf-lib": "1.17.1",
     "pptxgenjs": "^4.0.1",
     "xlsx": "^0.18.5",
     "y-protocols": "1.0.7",