@a3s-lab/office 0.32.0 → 0.33.0

package/README.md

@@ -56,7 +56,7 @@ workflows, and a separate Rust automation plane.
 
 ## Latest on `main`
 
-The `0.32.0` release plus the current `main` branch expose these capabilities
+The `0.33.0` release plus the current `main` branch expose these capabilities
 as normal user-facing Playground templates, with matching implementation
 detail in the documentation:
 
@@ -68,10 +68,13 @@ detail in the documentation:
 | Writer | Native character shading with exact `w:shd` patterns, foreground/background color identity, explicit resets, authoring, and DOCX reopen | Playground **Latest capabilities → 字符底纹** · [Document reference](docs/latest/en/components/document.mdx#native-character-shading) |
 | Writer | Independent Latin, East Asian, and bidi proofing languages plus explicit `w:noProof` inclusion/exclusion | Playground **Latest capabilities → 校对语言** · [Document reference](docs/latest/en/components/document.mdx#native-proofing-languages) |
 | Spreadsheet | Complete common Data Validation input, blank/dropdown, and Stop/Warning/Information error settings with native XLSX round trips | Playground **Latest capabilities → 数据验证** · [Spreadsheet reference](docs/latest/en/components/spreadsheet.mdx#data-validation) |
+| PDF | Insert, delete, rotate, reorder, extract, merge, and split pages through a dedicated Web Worker, with Blob-level Undo/Redo and independent binary reopen verification | Playground **Latest capabilities → 组织 PDF 页面** · [PDF reference](docs/latest/en/components/pdf.mdx#page-organization) |
 
-The same six entries remain available under **新建**. The highlighted strip
-exists so a capability is discoverable from the first Playground viewport
-instead of only through a deep documentation section or an `?e2e=` fixture.
+All seven entries are reachable from the first Playground viewport. The six
+content templates also remain under **新建**; **组织 PDF 页面** opens the normal
+PDF file workflow because page organization must operate on host-provided source
+bytes. The highlighted strip keeps each capability discoverable without a deep
+documentation section or an `?e2e=` fixture.
 
 ## See it working
 
@@ -108,9 +111,9 @@ The images below are committed visual-regression baselines from the real
     </td>
     <td width="50%" valign="top">
       <a href="visual-tests/__snapshots__/linux/desktop-1280/pdf.png">
-        <img src="visual-tests/__snapshots__/linux/desktop-1280/pdf.png" alt="A3S Office PDF editor with search, annotation, save, and download controls">
+        <img src="visual-tests/__snapshots__/linux/desktop-1280/pdf.png" alt="A3S Office PDF editor with search, annotation, page organization, save, and download controls">
       </a>
-      <br><sub><strong>PDF</strong> — PDFium rendering, forms, annotations, Yjs overlays, and save</sub>
+      <br><sub><strong>PDF</strong> — PDFium rendering, forms, annotations, page organization, Yjs overlays, and save</sub>
     </td>
   </tr>
 </table>
@@ -173,7 +176,7 @@ baseline rather than one specific release.
 | Search and text evidence | **Supported with boundaries** — browser search and bounded native text-layer evidence | Broader tagged-PDF reading order and accessibility extraction |
 | Annotations, forms, and save | **Supported** — common annotations, appearance controls, form filling, history, and save | Broader stamps, measurements, form authoring, scripts, and signatures |
 | Existing text, image, and object editing | **Gap** — no safe production content-stream editing path | Direct text/object editing with font and layout recovery |
-| Page organization | **Gap** — insert, delete, rotate, reorder, extract, merge, and split are not yet editable | Complete page organization workflows |
+| Page organization | **Supported with boundaries** — insert, delete, rotate, reorder, extract, merge, and split run in a dedicated Worker, replace one complete Blob per mutation, and participate in Undo/Redo | Broader document-level catalog preservation and signed/encrypted-file workflows |
 | Compression, conversion, and OCR | **Gap / host boundary** — provider contracts are required for authoritative conversion and OCR | Integrated optimization, conversion, and scanned-document recognition |
 | Signatures, protection, and redaction | **Gap / host boundary** — trusted identity and destructive-content guarantees are required | E-signing, certificate validation, encryption, sanitization, and true redaction |
 | AI and real-time collaboration | **Host-owned** — typed page/text evidence, Yjs review records, presence, and provider-neutral ports | Typically bundled with account, storage, and model services |
@@ -433,6 +436,51 @@ viewer or pre-initialize the PDFium Worker. On the local reference machine it
 improved median shell mount by 41.6 ms but did not improve the viewer-ready
 median, so Worker initialization remains the measured boundary.
 
+### Organize and persist PDF pages
+
+Providing `onSave` enables the page organizer. Every insert, delete, rotate,
+reorder, or merge produces one replacement PDF `Blob` and one page-history
+record; extract and split return separate files without changing the source.
+Use `onPageExport` when the host should persist those derived files instead of
+letting the viewer download them:
+
+```tsx
+import type { PdfPageOrganizationExport } from '@a3s-lab/office/react';
+import { PdfViewer } from '@a3s-lab/office/react';
+
+async function persistPageExports(
+  files: readonly PdfPageOrganizationExport[],
+): Promise<boolean> {
+  await Promise.all(
+    files.map(({ fileName, pageCount, pdf }) =>
+      storage.put(fileName, pdf, { pageCount }),
+    ),
+  );
+  return true;
+}
+
+<PdfViewer
+  fileName="contract.pdf"
+  loadSource={() => storage.get('contract.pdf')}
+  onSave={async (pdf) => {
+    await storage.put('contract.pdf', pdf);
+    return true;
+  }}
+  onPageExport={persistPageExports}
+/>;
+```
+
+Page jobs load lazily in a dedicated Web Worker. The primary PDF is limited to
+256 MiB, a merged PDF to 128 MiB, and every result to 4,096 pages. Toolbar
+Undo/Redo consumes native annotation or form history first, then page history.
+Signed or encrypted PDFs fail closed; delete, reorder, and merge also reject
+forms, outlines, or tagged structures whose page references cannot be safely
+rewritten. Extract and split surface a diagnostic when document-level catalog
+objects are intentionally not copied. Page organization is unavailable while
+`collaboration` or `evidenceOverlay` is active because those modes identify an
+immutable source PDF. See the complete
+[PDF page-organization contract](docs/latest/en/components/pdf.mdx#page-organization).
+
 ### Persist a structured document snapshot
 
 Hosts that round-trip controlled document values across a process or language
@@ -1547,6 +1595,9 @@ bun run lint
 bun run typecheck
 bun run test
 bun run build
+bun run test:e2e:pdf-page-organization:check
+bun run test:e2e:pdf-page-organization
+bun run playground:visual:pdf-page-organization
 bun run test:e2e:large-pdf:check
 bun run test:e2e:large-pdf
 bun run performance:pdf
@@ -1571,6 +1622,7 @@ without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.33.0 documentation](https://a3s-lab.github.io/Office/docs/0.33.0/)
 - [A3S Office 0.32.0 documentation](https://a3s-lab.github.io/Office/docs/0.32.0/)
 - [A3S Office 0.31.0 documentation](https://a3s-lab.github.io/Office/docs/0.31.0/)
 - [A3S Office 0.30.0 documentation](https://a3s-lab.github.io/Office/docs/0.30.0/)

package/dist/0~3539.js

@@ -6,8 +6,8 @@ import { effectiveSpreadsheetCalculationSettings, workSpreadsheetCombinationSeri
 import { presentationChartLegendPositionLabel, presentationChartShowsLegend, normalizePresentationChartLegendPosition, presentationChartUsesNumericXAxis, normalizePresentationBubbleSizeRepresents, normalizePresentationBubbleScale, presentationChartAxes, normalizePresentationChartDataLabels, presentationChartTypeLabel, presentationChartDataLabelPositionLabel, normalizePresentationScatterStyle } from "./0~work-presentation-charts.js";
 import { OfficeCheckbox, CommittedOfficeNumberField, CollectionState } from "./0~7048.js";
 import { OfficeColorPicker } from "./0~3635.js";
-import { OfficeSelect } from "./0~4595.js";
-import { office_text_field_OfficeTextField, CommittedOfficeTextField } from "./0~6090.js";
+import { OfficeSelect } from "./0~9073.js";
+import { office_text_field_OfficeTextField, CommittedOfficeTextField } from "./0~8136.js";
 function spreadsheetAgentMenuItems(selection, onAgentRequest, applyProposal) {
     return [
         {

package/dist/0~3557.js

@@ -1,5 +1,5 @@
 import { useEffect, useLayoutEffect, useMemo, useRef } from "react";
-import { matchesOfficeEditorKeyboardShortcut } from "./0~6090.js";
+import { matchesOfficeEditorKeyboardShortcut } from "./0~8136.js";
 const DEFAULT_EXTENSION_PRIORITY = 100;
 function createOfficeEditorExtension(config) {
     const name = config.name.trim();

package/dist/0~3635.js

@@ -1,7 +1,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Ban, Check, ChevronDown } from "lucide-react";
 import { useEffect, useRef, useState } from "react";
-import { button_Button, Popover } from "./0~6090.js";
+import { button_Button, Popover } from "./0~8136.js";
 const THEME_COLORS = [
     '#111827',
     '#1f2937',

package/dist/0~7048.js

@@ -1,8 +1,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useId, useRef, useState } from "react";
 import { Check, ChevronDown, ChevronUp, Minus } from "lucide-react";
-import { Dialog } from "./0~4595.js";
-import { button_Button, office_text_field_OfficeTextField, office_text_field_OfficeTextArea } from "./0~6090.js";
+import { button_Button, office_text_field_OfficeTextArea, office_text_field_OfficeTextField, Dialog } from "./0~8136.js";
 import { OFFICE_KERNEL_SPREADSHEET_MAX_ROWS as office_kernel_spreadsheet_protocol_OFFICE_KERNEL_SPREADSHEET_MAX_ROWS, isOfficeKernelSpreadsheetError } from "./4121.js";
 function CollectionState({ children, icon, actions, tone = 'neutral', role, className = '' }) {
     return /*#__PURE__*/ jsxs("div", {

package/dist/{0~6090.js → 0~8136.js}

@@ -1,7 +1,7 @@
 import { forwardRef, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Bot, LocateFixed, UsersRound, X } from "lucide-react";
 import { createPortal } from "react-dom";
-import { Bot, LocateFixed, UsersRound } from "lucide-react";
 import { useOfficeCollaborationPresence, useOfficeCollaborationParticipantNavigation } from "./432.js";
 const focusableSelector = 'button:not(:disabled), input:not(:disabled):not([type="hidden"]), textarea:not(:disabled), select:not(:disabled), a[href], [contenteditable="true"], [tabindex]:not([tabindex="-1"])';
 const activeFocusScopes = [];
@@ -292,6 +292,75 @@ const icon_button_IconButton = /*#__PURE__*/ forwardRef(function({ label, toolti
         children: children
     });
 });
+function Dialog({ title, description, children, footer, onClose, closeDisabled = false, className, focusKey, restoreFocusTarget }) {
+    const titleId = useId();
+    const descriptionId = useId();
+    const portalRootRef = useRef(null);
+    if (!portalRootRef.current && "u" > typeof document) portalRootRef.current = officeOverlayPortalRoot(document, restoreFocusTarget?.());
+    const focusScope = useDialogFocusScope({
+        onEscape: onClose,
+        escapeDisabled: closeDisabled,
+        restoreFocusTarget
+    });
+    useEffect(()=>{
+        if (void 0 !== focusKey) focusScope.focusInitial();
+    }, [
+        focusKey,
+        focusScope.focusInitial
+    ]);
+    const dialog = /*#__PURE__*/ jsx("dialog", {
+        open: true,
+        className: "ds-dialog-backdrop",
+        role: "presentation",
+        onCancel: (event)=>{
+            event.preventDefault();
+            if (!closeDisabled) onClose();
+        },
+        children: /*#__PURE__*/ jsxs("section", {
+            ref: focusScope.scopeRef,
+            className: `ds-dialog${className ? ` ${className}` : ''}`,
+            role: "dialog",
+            "aria-modal": "true",
+            "aria-labelledby": titleId,
+            "aria-describedby": description ? descriptionId : void 0,
+            onKeyDown: focusScope.handleKeyDown,
+            children: [
+                /*#__PURE__*/ jsxs("header", {
+                    children: [
+                        /*#__PURE__*/ jsxs("div", {
+                            children: [
+                                /*#__PURE__*/ jsx("h2", {
+                                    id: titleId,
+                                    children: title
+                                }),
+                                description && /*#__PURE__*/ jsx("p", {
+                                    id: descriptionId,
+                                    children: description
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ jsx(icon_button_IconButton, {
+                            label: "关闭",
+                            disabled: closeDisabled,
+                            onClick: onClose,
+                            children: /*#__PURE__*/ jsx(X, {
+                                size: 16
+                            })
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ jsx("div", {
+                    className: "ds-dialog-body",
+                    children: children
+                }),
+                footer && /*#__PURE__*/ jsx("footer", {
+                    children: footer
+                })
+            ]
+        })
+    });
+    return "u" > typeof document && portalRootRef.current ? /*#__PURE__*/ createPortal(dialog, portalRootRef.current) : dialog;
+}
 const office_text_field_OfficeTextField = /*#__PURE__*/ forwardRef(function({ className = '', type = 'text', ...props }, ref) {
     return /*#__PURE__*/ jsx("input", {
         ref: ref,
@@ -1340,4 +1409,4 @@ function useOfficeEditorWheelZoom({ enabled = true, scopeRef, onZoomIn, onZoomOu
         scopeRef
     ]);
 }
-export { CommittedOfficeTextArea, CommittedOfficeTextField, MarkdownSourcePresenceLayer, OfficePresenceAvatar, OfficeTiptapPresenceLayer, Popover, WorkOfficeCollaborationParticipants, button_Button, icon_button_IconButton, matchesAriaKeyShortcuts, matchesOfficeEditorKeyboardShortcut, moveOfficeGridMenuFocus, moveOfficeMenuFocus, officeOverlayPortalRoot, officePresenceColor, officePresenceColorStyle, office_text_field_OfficeFileInput, office_text_field_OfficeTextArea, office_text_field_OfficeTextField, stepOfficeZoom, useDialogFocusScope, useOfficeEditorWheelZoom, useOfficePublishPresenceLocation, useOfficeRemoteParticipants };
+export { CommittedOfficeTextArea, CommittedOfficeTextField, Dialog, MarkdownSourcePresenceLayer, OfficePresenceAvatar, OfficeTiptapPresenceLayer, Popover, WorkOfficeCollaborationParticipants, button_Button, icon_button_IconButton, matchesAriaKeyShortcuts, matchesOfficeEditorKeyboardShortcut, moveOfficeGridMenuFocus, moveOfficeMenuFocus, officeOverlayPortalRoot, officePresenceColor, officePresenceColorStyle, office_text_field_OfficeFileInput, office_text_field_OfficeTextArea, office_text_field_OfficeTextField, stepOfficeZoom, useDialogFocusScope, useOfficeEditorWheelZoom, useOfficePublishPresenceLocation, useOfficeRemoteParticipants };

package/dist/{0~4595.js → 0~9073.js}

@@ -1,8 +1,8 @@
 import { Fragment as jsx_runtime_Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Fragment, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
-import { ArrowUpRight, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, Eye, Minus, Plus, X } from "lucide-react";
-import { WorkOfficeCollaborationParticipants, moveOfficeMenuFocus, useDialogFocusScope, icon_button_IconButton, Popover, matchesAriaKeyShortcuts, officeOverlayPortalRoot } from "./0~6090.js";
+import { ArrowUpRight, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, Eye, Minus, Plus } from "lucide-react";
+import { WorkOfficeCollaborationParticipants, moveOfficeMenuFocus, Popover, matchesAriaKeyShortcuts, officeOverlayPortalRoot } from "./0~8136.js";
 const CONTEXT_MENU_MARGIN = 8;
 const CONTEXT_MENU_TAB_STOP_SELECTOR = 'a[href]:not([tabindex="-1"]), button:not(:disabled):not([tabindex="-1"]), input:not(:disabled):not([type="hidden"]):not([tabindex="-1"]), select:not(:disabled):not([tabindex="-1"]), textarea:not(:disabled):not([tabindex="-1"]), [contenteditable="true"]:not([tabindex="-1"]), [tabindex]:not([tabindex="-1"])';
 function isWorkspaceContextMenuKeyboardEvent({ key, shiftKey }) {
@@ -274,75 +274,6 @@ function contextMenuAvailableBounds(ownerDocument, view, portalRoot) {
 function clampCoordinate(value, minimum, maximum) {
     return Math.max(minimum, Math.min(value, Math.max(minimum, maximum)));
 }
-function Dialog({ title, description, children, footer, onClose, closeDisabled = false, className, focusKey, restoreFocusTarget }) {
-    const titleId = useId();
-    const descriptionId = useId();
-    const portalRootRef = useRef(null);
-    if (!portalRootRef.current && "u" > typeof document) portalRootRef.current = officeOverlayPortalRoot(document, restoreFocusTarget?.());
-    const focusScope = useDialogFocusScope({
-        onEscape: onClose,
-        escapeDisabled: closeDisabled,
-        restoreFocusTarget
-    });
-    useEffect(()=>{
-        if (void 0 !== focusKey) focusScope.focusInitial();
-    }, [
-        focusKey,
-        focusScope.focusInitial
-    ]);
-    const dialog = /*#__PURE__*/ jsx("dialog", {
-        open: true,
-        className: "ds-dialog-backdrop",
-        role: "presentation",
-        onCancel: (event)=>{
-            event.preventDefault();
-            if (!closeDisabled) onClose();
-        },
-        children: /*#__PURE__*/ jsxs("section", {
-            ref: focusScope.scopeRef,
-            className: `ds-dialog${className ? ` ${className}` : ''}`,
-            role: "dialog",
-            "aria-modal": "true",
-            "aria-labelledby": titleId,
-            "aria-describedby": description ? descriptionId : void 0,
-            onKeyDown: focusScope.handleKeyDown,
-            children: [
-                /*#__PURE__*/ jsxs("header", {
-                    children: [
-                        /*#__PURE__*/ jsxs("div", {
-                            children: [
-                                /*#__PURE__*/ jsx("h2", {
-                                    id: titleId,
-                                    children: title
-                                }),
-                                description && /*#__PURE__*/ jsx("p", {
-                                    id: descriptionId,
-                                    children: description
-                                })
-                            ]
-                        }),
-                        /*#__PURE__*/ jsx(icon_button_IconButton, {
-                            label: "关闭",
-                            disabled: closeDisabled,
-                            onClick: onClose,
-                            children: /*#__PURE__*/ jsx(X, {
-                                size: 16
-                            })
-                        })
-                    ]
-                }),
-                /*#__PURE__*/ jsx("div", {
-                    className: "ds-dialog-body",
-                    children: children
-                }),
-                footer && /*#__PURE__*/ jsx("footer", {
-                    children: footer
-                })
-            ]
-        })
-    });
-    return "u" > typeof document && portalRootRef.current ? /*#__PURE__*/ createPortal(dialog, portalRootRef.current) : dialog;
-}
 function OfficeSelect({ ariaLabel, value, options, onValueChange, disabled = false, placeholder = '请选择', className = '', ariaKeyShortcuts, initialFocus = false }) {
     const reactId = useId().replaceAll(':', '');
     const [open, setOpen] = useState(false);
@@ -1293,4 +1224,4 @@ function WorkOfficeZoomControls({ zoom, minimum = 50, maximum = 200, step = 10,
         ]
     });
 }
-export { Dialog, OfficeSelect, Tabs, WorkOfficePreviewBar, WorkOfficeRibbon, WorkOfficeRibbonButton, WorkOfficeRibbonGroup, WorkOfficeStatusBar, WorkOfficeZoomControls, WorkspaceContextMenu, isWorkspaceContextMenuKeyboardEvent, workspaceContextMenuPosition };
+export { OfficeSelect, Tabs, WorkOfficePreviewBar, WorkOfficeRibbon, WorkOfficeRibbonButton, WorkOfficeRibbonGroup, WorkOfficeStatusBar, WorkOfficeZoomControls, WorkspaceContextMenu, isWorkspaceContextMenuKeyboardEvent, workspaceContextMenuPosition };

package/dist/0~9445.js

@@ -2,7 +2,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Minus, Plus, Table2 } from "lucide-react";
 import { useEffect, useRef, useState } from "react";
 import { materializeWorkFile } from "./9356.js";
-import { Popover } from "./0~6090.js";
+import { Popover } from "./0~8136.js";
 async function readOfficeFileAsDataUrl(file) {
     const ownedFile = await materializeWorkFile(file);
     return new Promise((resolve, reject)=>{

package/dist/0~document-editor.js

@@ -18,8 +18,8 @@ import { TableMap, isInTable, selectedRect } from "@tiptap/pm/tables";
 import { closeHistory } from "@tiptap/pm/history";
 import { documentTableSizing, transferChangedDocumentTextStatistics, documentPageBordersVisible, documentUnderlineStyle, DOCUMENT_PAGE_BORDER_EDGES, documentTableRowOptions, normalizeDocumentColumns, clampDocumentMargin, materializeLazyDocumentEditorRoot, documentKerningThresholdPoints, selectedDocumentIndexOptions, nextDocumentTabAlignment, DOCUMENT_BOOKMARK_DUPLICATE_MESSAGE, normalizedTabPosition, documentCitationCount, resolveDocumentPageBorders, documentLazyHtmlChunkFragment, DocumentFontFamily, normalizeDocumentHiddenText, documentLegacyTextEffectsConflict, DOCUMENT_CHUNK_VISIBLE_IDS_META, selectedDocumentIndexDraft, MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT, retainAnchoredDocumentComments, DocumentTableRowIdentity, work_document_page_margins_twipsToMillimeters, DEFAULT_DOCUMENT_TABLE_CELL_FORMAT, resolveWorkDocumentEditorInput, documentCharacterPositionPoints, documentBulletListStyle, collectDocumentTextLayoutParagraphs, readOfficeDocumentCollaboration as readWorkOfficeDocumentCollaboration, normalizeDocumentCharacterScalePercent, DOCUMENT_PARAGRAPH_FORMAT_ATTRIBUTES, documentOrderedListState, normalizeDocumentPageChrome, documentTextStatistics, documentPageMarginsForLayout, invalidateDocumentLazyHtmlProjection, documentTableCellFormat, normalizeDocumentPageGeometry, normalizeDocumentImageLayer, documentImageProperties, isValidDocumentCitationTag, sanitizeDocumentPageChromeHtml, pageTwipsToMillimeters, normalizeDocumentPageBorders, importWorkDocumentFile, DocumentParagraphFormatting, documentModelHasTrustedInitialIntegrityFeatures, normalizeDocumentHtml, documentInitialSectionLayout, activeDocumentSection, documentParagraphDirection, documentParagraphPagination, isDocumentCharacterFormatMark, documentModelUsesWindowing, documentPageChromeLegacyFields, documentChunkMountedIds, collectDocumentCommentAnchors, documentTextCaseKeyboardShortcuts, DocumentTextStyle, canChangeDocumentIndent, documentCharacterSpacingPoints, documentKerningIsEffective, DocumentSuperscript, documentSectionById, activeDocumentBookmark, DocumentEquation, documentLazyHtmlProjectionFingerprint, documentLazyHtmlProjection, normalizeDocumentParagraphIndent, updateDocumentGutterPosition, DocumentStrike, mountWorkLiveDocumentCapture, registerDocumentPageSurfaceGeometry, documentHiddenTextKeyboardShortcut, documentHasIndex, syncDocumentContentFromHtml, documentLegacyTextEffectsCss, editorDocumentCaptionTargets, resolveDocumentPageChrome, documentImageLayoutOptions, MAX_DOCUMENT_NUMBERING_START, resolveDocumentPageSize, editorDocumentBookmarkReferenceTargets, serializeWorkDocumentNode, DOCUMENT_CHUNK_PAGINATION_META, documentModelForContent, createOfficeDocumentCollaborationBinding as createWorkOfficeDocumentCollaborationBinding, documentLegacyTextEffectsFromTextStyleAttributes, normalizeDocumentEmphasisMark, selectedDocumentChunkId, documentCommentViews, documentParagraphSpacing, normalizeDocumentTabStops, patchDocumentLazyHtmlProjection, normalizeDocumentTextCase, documentUnderlineColor, documentBookmarkNameExists, collectDocumentChanges, DocumentImage, selectedDocumentTableOfContentsOptions, resolveDocumentPageMargins, updateDocumentPageMarginMode, serializeDocumentParagraphFormatting, canSetDocumentTableRowRepeatHeader, normalizeDocumentCharacterSpacingTwips, DocumentCharacterFormatting, millimetersToPixels as work_document_layout_millimetersToPixels, DOCUMENT_PARAGRAPH_CHANGE_ATTRIBUTES, serializeDocumentCharacterFormatting, DOCUMENT_CHUNK_HYDRATION_META, documentTabLeaderLabel, createSchemaDerivedWorkDocumentModel, updateDocumentCustomPageMillimeters, DocumentUnderline, documentCommentDraftRange, documentParagraphTabStops, documentTableHorizontalAlignment, documentUnderlineKeyboardShortcuts, documentParagraphIndent, DocumentScriptFontFormatting, canInsertDocumentComment, resolveAllDocumentChanges, documentHasTableOfContents, documentTextLayoutBatches, normalizeDocumentImageWrapSide, updateDocumentPageOrientation, documentCitationStyleDetails, validateDocumentBookmarkName, setCustomDocumentColumns, updateDocumentPageMarginMillimeters, documentCitationStyle, normalizeDocumentCharacterPositionHalfPoints, documentTransactionsOnlyHydrateChunks, normalizeDocumentKerningThresholdHalfPoints, forgetSourceBlob as forgetWorkSourceBlob, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, DOCUMENT_TABLE_STYLE_OPTIONS, updateDocumentColumnWidth, updateDocumentPaperSizePreset, documentPageMetrics, documentStrikeStyle, DocumentHighlight, createDocumentBibliography, DocumentSubscript, selectedDocumentIndexEntry, updateDocumentPageChromeVariant, updateDocumentMirrorMargins, activeDocumentTableStyle, measureDocumentLayoutBlocksIncrementally, documentWordLineHeightFactor, normalizeDocumentLegacyTextEffect, createWorkDocumentExtensions } from "./4174.js";
 import { useOfficeTaskPaneEscape, normalizeOfficeFontFamily, OfficeCheckbox, useOfficeDialog, useOfficeTaskPaneModal, CommittedOfficeNumberField, officeFontFamilyLabel, officeFontFamilies, CollectionState, createOfficeKernelClient, OfficeNumberField } from "./0~7048.js";
-import { moveOfficeMenuFocus, office_text_field_OfficeTextArea, Popover, officeOverlayPortalRoot, button_Button, useOfficePublishPresenceLocation, OfficeTiptapPresenceLayer, icon_button_IconButton, office_text_field_OfficeTextField, useDialogFocusScope, useOfficeEditorWheelZoom, office_text_field_OfficeFileInput } from "./0~6090.js";
-import { WorkOfficePreviewBar, isWorkspaceContextMenuKeyboardEvent, Tabs, WorkOfficeZoomControls, WorkOfficeStatusBar, Dialog, WorkOfficeRibbon, workspaceContextMenuPosition, OfficeSelect, WorkspaceContextMenu, WorkOfficeRibbonGroup, WorkOfficeRibbonButton } from "./0~4595.js";
+import { moveOfficeMenuFocus, office_text_field_OfficeTextArea, Popover, officeOverlayPortalRoot, Dialog, button_Button, useOfficePublishPresenceLocation, OfficeTiptapPresenceLayer, icon_button_IconButton, office_text_field_OfficeTextField, useDialogFocusScope, useOfficeEditorWheelZoom, office_text_field_OfficeFileInput } from "./0~8136.js";
+import { WorkOfficePreviewBar, isWorkspaceContextMenuKeyboardEvent, Tabs, WorkOfficeZoomControls, WorkOfficeStatusBar, WorkOfficeRibbon, workspaceContextMenuPosition, OfficeSelect, WorkspaceContextMenu, WorkOfficeRibbonGroup, WorkOfficeRibbonButton } from "./0~9073.js";
 import { documentFontNameFromCssFamily, normalizeDocumentRunBorder, parseDocumentScriptFonts, parseDocumentRunShading, DOCUMENT_RUN_BORDER_STYLES, serializeDocumentRunBorder, documentScriptFontDirectFamily, serializeDocumentRunShading, patchDocumentScriptFonts, serializeDocumentScriptFonts, documentRunBorderIsVisible, cssDocumentFontFamily, isDocumentParagraphArtBorderStyle, visibleWorkDocumentOutlineItems, DEFAULT_DOCUMENT_TABLE_OF_CONTENTS_OPTIONS, createOfficeId as createWorkId, DEFAULT_DOCUMENT_INDEX_OPTIONS, normalizeDocumentLanguageTag, currentWorkDocumentOutlineItem, normalizeDocumentNoProof, parseDocumentRunBorder, DocumentParagraphIdentity, parseDocumentProofingLanguages, collectWorkDocumentOutline, documentScriptFontSlotFromHint, documentBorderPresentation, documentScriptFontFamilyForRendering, normalizeDocumentRunShading, normalizeDocumentScriptFontSlot, documentScriptFontSegments, patchDocumentProofingLanguages, serializeDocumentProofingLanguages, documentRunShadingDomAttributes } from "./4121.js";
 import { normalizeDocumentHref, DOCUMENT_LINK_VALIDATION_MESSAGE } from "./0~work-document-links.js";
 import { OfficeColorPicker, isOfficeShortcutBlocked } from "./0~3635.js";

package/dist/0~markdown-editor.js

@@ -11,8 +11,8 @@ import { Markdown } from "@tiptap/markdown";
 import starter_kit from "@tiptap/starter-kit";
 import { Bold, Code2, Columns2, Image, Italic, Link2, List, ListChecks, ListOrdered, Minus, PencilLine, Quote, Redo2, Strikethrough, Table2, Undo2, Unlink } from "lucide-react";
 import { mergeOfficeTiptapExtensions, documentPlainTextAsHtml, customSelectionMenuItems } from "./0~5050.js";
-import { OfficeSelect, isWorkspaceContextMenuKeyboardEvent, WorkOfficeZoomControls, WorkOfficeStatusBar, Dialog, WorkOfficeRibbon, workspaceContextMenuPosition, WorkspaceContextMenu, WorkOfficeRibbonGroup, WorkOfficeRibbonButton, WorkOfficePreviewBar } from "./0~4595.js";
-import { button_Button, OfficeTiptapPresenceLayer, useOfficePublishPresenceLocation, stepOfficeZoom, office_text_field_OfficeTextField, useOfficeEditorWheelZoom, MarkdownSourcePresenceLayer } from "./0~6090.js";
+import { OfficeSelect, isWorkspaceContextMenuKeyboardEvent, WorkOfficeZoomControls, WorkOfficeStatusBar, WorkOfficeRibbon, workspaceContextMenuPosition, WorkspaceContextMenu, WorkOfficeRibbonGroup, WorkOfficeRibbonButton, WorkOfficePreviewBar } from "./0~9073.js";
+import { stepOfficeZoom, MarkdownSourcePresenceLayer, button_Button, OfficeTiptapPresenceLayer, useOfficePublishPresenceLocation, Dialog, office_text_field_OfficeTextField, useOfficeEditorWheelZoom } from "./0~8136.js";
 import { normalizeDocumentHref, DOCUMENT_LINK_VALIDATION_MESSAGE } from "./0~work-document-links.js";
 import { readOfficeMarkdownCollaboration as readWorkOfficeMarkdownCollaboration, createOfficeMarkdownCollaborationBinding as createWorkOfficeMarkdownCollaborationBinding } from "./2591.js";
 import { useOfficeEditorInitialFocus, useOfficeCollaborationLocationNavigator, WorkEditorLoadingState } from "./432.js";

package/dist/0~pdf-page-organization-engine.js

@@ -0,0 +1,187 @@
+import { PDFDocument, PDFName, degrees } from "pdf-lib";
+import { validatedPdfPageSize, PdfPageOrganizationError, PDF_PAGE_ORGANIZATION_MAX_SOURCE_BYTES, validatedPdfInsertionIndex, validatedPdfSplitBoundaries, PDF_PAGE_ORGANIZATION_MAX_IMPORT_BYTES, validatedPdfPageOrder, validatedPdfPageIndexes } from "./0~pdf-viewer.js";
+const RISKY_STRUCTURE_KEYS = [
+    'AcroForm',
+    'Outlines',
+    'StructTreeRoot'
+];
+const COPY_DIAGNOSTIC = {
+    code: 'pdf.pages.catalog-not-copied',
+    message: "Page-only exports do not copy document-level outlines, forms, tags, attachments, scripts, or signatures."
+};
+async function applyPdfPageOrganizationJob(job) {
+    const source = await loadBoundedPdf(job.source, PDF_PAGE_ORGANIZATION_MAX_SOURCE_BYTES, 'source');
+    assertPageCount(source.getPageCount());
+    if ('export' === job.kind) return exportPages(source, job.operation);
+    assertUnsigned(source);
+    return mutatePages(source, job.mutation, job.importSource);
+}
+async function mutatePages(source, mutation, importSource) {
+    const pageCount = source.getPageCount();
+    if ('rotate' === mutation.kind) {
+        const indexes = validatedPdfPageIndexes(mutation.pageIndexes, pageCount);
+        for (const pageIndex of indexes){
+            const page = source.getPage(pageIndex);
+            const current = page.getRotation().angle;
+            if (!Number.isSafeInteger(current) || current % 90 !== 0) throw new PdfPageOrganizationError('pdf.pages.unsupported-rotation', `Page ${pageIndex + 1} has unsupported rotation ${String(current)}.`);
+            page.setRotation(degrees(normalizeDegrees(current + mutation.degrees)));
+        }
+        return mutationResult(source);
+    }
+    if ('insert-blank' === mutation.kind) {
+        const index = validatedPdfInsertionIndex(mutation.index, pageCount);
+        const size = validatedPdfPageSize(mutation.size);
+        assertPageCount(pageCount + 1);
+        source.insertPage(index, [
+            size.width,
+            size.height
+        ]);
+        return mutationResult(source);
+    }
+    if ('delete' === mutation.kind) {
+        assertNoRiskyStructure(source);
+        const indexes = validatedPdfPageIndexes(mutation.pageIndexes, pageCount);
+        if (indexes.length >= pageCount) throw new PdfPageOrganizationError('pdf.pages.empty-document', 'A PDF must retain at least one page.');
+        for (const pageIndex of [
+            ...indexes
+        ].sort((left, right)=>right - left))source.removePage(pageIndex);
+        return mutationResult(source);
+    }
+    if ('reorder' === mutation.kind) {
+        assertNoRiskyStructure(source);
+        const pageOrder = validatedPdfPageOrder(mutation.pageOrder, pageCount);
+        const reordered = await PDFDocument.create({
+            updateMetadata: false
+        });
+        copyMetadata(source, reordered);
+        const pages = await reordered.copyPages(source, pageOrder);
+        for (const page of pages)reordered.addPage(page);
+        return mutationResult(reordered);
+    }
+    const index = validatedPdfInsertionIndex(mutation.index, pageCount);
+    if (!importSource) throw new PdfPageOrganizationError('pdf.pages.missing-import', 'Choose a PDF to merge before applying this operation.');
+    assertNoRiskyStructure(source);
+    const imported = await loadBoundedPdf(importSource, PDF_PAGE_ORGANIZATION_MAX_IMPORT_BYTES, 'import');
+    assertSafeImport(imported);
+    assertPageCount(pageCount + imported.getPageCount());
+    const copied = await source.copyPages(imported, imported.getPageIndices());
+    for(let offset = 0; offset < copied.length; offset += 1){
+        const page = copied[offset];
+        if (page) source.insertPage(index + offset, page);
+    }
+    return mutationResult(source);
+}
+async function exportPages(source, operation) {
+    const pageCount = source.getPageCount();
+    if ('extract' === operation.kind) {
+        const indexes = validatedPdfPageIndexes(operation.pageIndexes, pageCount, {
+            preserveOrder: true
+        });
+        return {
+            diagnostics: sourceHasRiskyStructure(source) ? [
+                COPY_DIAGNOSTIC
+            ] : [],
+            files: [
+                await copyPageRange(source, indexes)
+            ],
+            kind: 'exported'
+        };
+    }
+    const boundaries = validatedPdfSplitBoundaries(operation.splitAfterPageIndexes, pageCount);
+    const ranges = [];
+    let start = 0;
+    for (const boundary of boundaries){
+        ranges.push(range(start, boundary + 1));
+        start = boundary + 1;
+    }
+    ranges.push(range(start, pageCount));
+    return {
+        diagnostics: sourceHasRiskyStructure(source) ? [
+            COPY_DIAGNOSTIC
+        ] : [],
+        files: await Promise.all(ranges.map((indexes)=>copyPageRange(source, indexes))),
+        kind: 'exported'
+    };
+}
+async function copyPageRange(source, indexes) {
+    const output = await PDFDocument.create({
+        updateMetadata: false
+    });
+    copyMetadata(source, output);
+    const pages = await output.copyPages(source, indexes);
+    for (const page of pages)output.addPage(page);
+    return {
+        pageCount: indexes.length,
+        source: await output.save()
+    };
+}
+async function mutationResult(source) {
+    return {
+        diagnostics: [],
+        kind: 'mutated',
+        pageCount: source.getPageCount(),
+        source: await source.save()
+    };
+}
+async function loadBoundedPdf(source, byteLimit, label) {
+    const byteLength = source.byteLength;
+    if (byteLength < 5 || byteLength > byteLimit) throw new PdfPageOrganizationError('pdf.pages.source-limit', `The PDF ${label} must be between 5 bytes and ${byteLimit} bytes.`);
+    try {
+        const pdf = await PDFDocument.load(source, {
+            ignoreEncryption: false,
+            throwOnInvalidObject: true,
+            updateMetadata: false
+        });
+        if (pdf.isEncrypted) throw new PdfPageOrganizationError('pdf.pages.encrypted-source', `The encrypted PDF ${label} cannot be reorganized without an authenticated decryption provider.`);
+        return pdf;
+    } catch (error) {
+        if (error instanceof PdfPageOrganizationError) throw error;
+        const message = error instanceof Error ? error.message : String(error);
+        if (/encrypt/i.test(message)) throw new PdfPageOrganizationError('pdf.pages.encrypted-source', `The encrypted PDF ${label} cannot be reorganized without an authenticated decryption provider.`);
+        throw new PdfPageOrganizationError('pdf.pages.invalid-source', `The PDF ${label} is malformed or unsupported: ${message.slice(0, 240)}`);
+    }
+}
+function assertPageCount(pageCount) {
+    if (!Number.isSafeInteger(pageCount) || pageCount < 1 || pageCount > 4096) throw new PdfPageOrganizationError('pdf.pages.page-limit', "PDF page organization supports 1 to 4096 pages per result.");
+}
+function assertUnsigned(source) {
+    if (source.catalog.has(PDFName.of('Perms'))) throw new PdfPageOrganizationError('pdf.pages.signed-source', 'This PDF declares a signature permission dictionary. Rewriting it would invalidate its trust evidence.');
+}
+function assertNoRiskyStructure(source) {
+    if (!sourceHasRiskyStructure(source)) return;
+    throw new PdfPageOrganizationError('pdf.pages.risky-structure', 'Delete, reorder, and merge are disabled for PDFs with forms, outlines, or tagged structure because page references cannot be rewritten safely.');
+}
+function assertSafeImport(source) {
+    if (!sourceHasRiskyStructure(source) && !source.catalog.has(PDFName.of('Perms'))) return;
+    throw new PdfPageOrganizationError('pdf.pages.risky-import', 'The PDF selected for merge contains forms, outlines, tags, or signature permissions that cannot be copied safely.');
+}
+function sourceHasRiskyStructure(source) {
+    return RISKY_STRUCTURE_KEYS.some((key)=>source.catalog.has(PDFName.of(key)));
+}
+function copyMetadata(source, target) {
+    setIfDefined(source.getTitle(), (value)=>target.setTitle(value));
+    setIfDefined(source.getAuthor(), (value)=>target.setAuthor(value));
+    setIfDefined(source.getSubject(), (value)=>target.setSubject(value));
+    setIfDefined(source.getCreator(), (value)=>target.setCreator(value));
+    setIfDefined(source.getProducer(), (value)=>target.setProducer(value));
+    setIfDefined(source.getCreationDate(), (value)=>target.setCreationDate(value));
+    setIfDefined(source.getModificationDate(), (value)=>target.setModificationDate(value));
+    const keywords = source.getKeywords();
+    if (keywords) target.setKeywords([
+        keywords
+    ]);
+}
+function setIfDefined(value, setter) {
+    if (void 0 !== value) setter(value);
+}
+function normalizeDegrees(value) {
+    const normalized = (value % 360 + 360) % 360;
+    if (0 === normalized || 90 === normalized || 180 === normalized || 270 === normalized) return normalized;
+    throw new PdfPageOrganizationError('pdf.pages.unsupported-rotation', `PDF page rotation ${value} is not a multiple of 90 degrees.`);
+}
+function range(start, end) {
+    return Array.from({
+        length: Math.max(0, end - start)
+    }, (_, index)=>start + index);
+}
+export { applyPdfPageOrganizationJob };