@a3s-lab/office 0.32.0 → 0.34.0

package/README.md

@@ -56,22 +56,26 @@ 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.34.0` release plus the current `main` branch expose these capabilities
 as normal user-facing Playground templates, with matching implementation
 detail in the documentation:
 
 | Editor | Latest capability | Public entry |
 | --- | --- | --- |
+| Presentation | Author, reorder, preview, collaborate on, and play ordered appear, fade, fly-in, and zoom entrance animations with on-click, with-previous, and after-previous triggers; the bounded subset round-trips through native PPTX timing trees | Playground **Latest capabilities → 入场动画** · [Presentation reference](docs/latest/en/components/presentation.mdx#entrance-animations) |
 | Writer | Compare the current document with an imported DOCX, HTML, or TXT version and generate deterministic insertion, deletion, character-formatting, and paragraph-formatting revisions; combine a reviewed copy only after exact baseline verification | Playground **Latest capabilities → 文档比较** · [Document reference](docs/latest/en/components/document.mdx#document-compare-and-combine) |
 | Writer | Insert, customize, navigate, and explicitly refresh a typed Table of Contents with heading and native outline levels 1–9, hyperlinks, page numbers, alignment, four leader styles, and native DOCX `TOC` round trips | Playground **Latest capabilities → 可更新目录** · [Document reference](docs/latest/en/components/document.mdx#native-table-of-contents) |
 | Writer | Mark primary and secondary index terms, cross-references, and bold/italic page numbers; insert, navigate, customize, and refresh a bounded native index with editable DOCX `XE` and `INDEX` round trips | Playground **Latest capabilities → 原生索引** · [Document reference](docs/latest/en/components/document.mdx#native-document-index) |
 | 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 eight entries are reachable from the first Playground viewport. The seven
+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 +112,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>
@@ -160,7 +164,7 @@ baseline rather than one specific release.
 | Text, shapes, tables, charts, and images | **Partial** — typed editable objects with native import/export paths | Broader shapes, connectors, effects, SmartArt, and embedded chart editing |
 | Masters and layouts | **Partial** — import/export inheritance with editable common paths | Full visual master, layout, and placeholder authoring |
 | Transitions and timings | **Partial** — fade, push, wipe, split, cut, and click/automatic advance | Broader transition catalog and timing controls |
-| Animations and media | **Gap** — no production animation timeline, trigger model, audio, video, or recording path | Object animation, motion paths, media editing, and recording |
+| Animations and media | **Partial** — the Work scene model authors, validates, copies, collaborates on, previews, and plays ordered appear/fade/fly-in/zoom entrance cues with click/with-previous/after-previous triggers and bounded timing; this supported entrance subset round-trips through native PPTX timing trees | Exit/emphasis effects, motion paths, audio, video, recording, and broader PPTX preservation |
 | Slideshow and presenter workflows | **Supported** — current/beginning start, keyboard playback, notes, timer, and responsive presenter view | Rehearsal, recording, ink/laser, and richer multi-display controls |
 | Review and collaboration | **Partial** — comments, shared presence, remote object locations, and host transport | Threads, assignments, mentions, and integrated cloud review |
 | PPTX, print, PDF, and video | **Partial** — PPTX round trip plus slide/notes/handout PDF models; no video export | Broader print controls, vector fidelity, media preservation, and video export |
@@ -173,7 +177,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 +437,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 +1596,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 +1623,8 @@ 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.34.0 documentation](https://a3s-lab.github.io/Office/docs/0.34.0/)
+- [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~5809.js

@@ -0,0 +1,123 @@
+import { createOfficeId as createWorkId } from "./4121.js";
+function createWorkSlideAnimation(elementId, effect, previous) {
+    return normalizeWorkSlideAnimation({
+        id: previous?.id ?? createWorkId('slide-animation'),
+        elementId,
+        effect,
+        trigger: previous?.trigger ?? 'on-click',
+        durationMs: previous?.durationMs ?? 500,
+        delayMs: previous?.delayMs ?? 0,
+        direction: 'fly-in' === effect ? previous?.direction ?? 'left' : void 0
+    });
+}
+function normalizeWorkSlideAnimation(animation) {
+    return {
+        ...animation,
+        durationMs: boundedInteger(animation.durationMs, 100, 60000),
+        delayMs: boundedInteger(animation.delayMs, 0, 60000),
+        direction: 'fly-in' === animation.effect ? normalizeWorkSlideAnimationDirection(animation.direction) : void 0
+    };
+}
+function workSlideAnimationForElement(slide, elementId) {
+    if (!elementId) return;
+    return slide.animations?.find((animation)=>animation.elementId === elementId);
+}
+function workSlideAnimationIndex(slide, animationId) {
+    if (!animationId) return -1;
+    return slide.animations?.findIndex((animation)=>animation.id === animationId) ?? -1;
+}
+function workSlideAnimationCues(animations) {
+    const cues = [];
+    let current;
+    for (const raw of animations ?? []){
+        const animation = normalizeWorkSlideAnimation(raw);
+        if (!current || 'on-click' === animation.trigger) {
+            current = {
+                automatic: 'on-click' !== animation.trigger,
+                items: [],
+                totalDurationMs: 0
+            };
+            cues.push(current);
+        }
+        const previous = current.items.at(-1);
+        const baseStart = 'after-previous' === animation.trigger ? previous?.endOffsetMs ?? 0 : 'with-previous' === animation.trigger ? previous?.startOffsetMs ?? 0 : 0;
+        const startOffsetMs = baseStart + animation.delayMs;
+        const endOffsetMs = startOffsetMs + animation.durationMs;
+        current.items.push({
+            animation,
+            startOffsetMs,
+            endOffsetMs
+        });
+        current.totalDurationMs = Math.max(current.totalDurationMs, endOffsetMs);
+    }
+    return cues;
+}
+function initialWorkSlideAnimationCueIndex(cues) {
+    return cues[0]?.automatic ? 0 : -1;
+}
+function removeWorkSlideAnimationsForElements(slide, elementIds) {
+    const animations = slide.animations?.filter((animation)=>!elementIds.has(animation.elementId));
+    if (animations?.length === slide.animations?.length) return slide;
+    return {
+        ...slide,
+        animations: animations?.length ? animations : void 0
+    };
+}
+function remapWorkSlideAnimations(animations, elementIds) {
+    const remapped = (animations ?? []).flatMap((animation)=>{
+        const elementId = elementIds.get(animation.elementId);
+        return elementId ? [
+            {
+                ...animation,
+                id: createWorkId('slide-animation'),
+                elementId
+            }
+        ] : [];
+    });
+    return remapped.length ? remapped : void 0;
+}
+function normalizeWorkSlideAnimationDirection(direction) {
+    return 'right' === direction || 'up' === direction || 'down' === direction ? direction : 'left';
+}
+function boundedInteger(value, minimum, maximum) {
+    const finite = Number.isFinite(value) ? Math.round(value) : minimum;
+    return Math.min(maximum, Math.max(minimum, finite));
+}
+const CARDINAL_DIRECTIONS = new Set([
+    'left',
+    'right',
+    'up',
+    'down'
+]);
+const SPLIT_DIRECTIONS = new Set([
+    'in',
+    'out'
+]);
+function createWorkSlideTransition(type, previous) {
+    const common = {
+        type,
+        speed: previous?.speed ?? 'medium',
+        advanceOnClick: previous?.advanceOnClick ?? true,
+        advanceAfterMs: previous?.advanceAfterMs
+    };
+    if ('push' === type || 'wipe' === type) return {
+        ...common,
+        direction: previous?.direction && CARDINAL_DIRECTIONS.has(previous.direction) ? previous.direction : 'left'
+    };
+    if ('split' === type) return {
+        ...common,
+        direction: previous?.direction && SPLIT_DIRECTIONS.has(previous.direction) ? previous.direction : 'out',
+        orientation: previous?.orientation ?? 'horizontal'
+    };
+    return common;
+}
+function slideTransitionDurationMilliseconds(transition) {
+    if (transition?.speed === 'fast') return 500;
+    if (transition?.speed === 'slow') return 2000;
+    return 1000;
+}
+function workSlideTransitionsEqual(left, right) {
+    if (!left || !right) return left === right;
+    return left.type === right.type && left.speed === right.speed && left.direction === right.direction && left.orientation === right.orientation && left.advanceOnClick === right.advanceOnClick && left.advanceAfterMs === right.advanceAfterMs;
+}
+export { createWorkSlideAnimation, createWorkSlideTransition, initialWorkSlideAnimationCueIndex, normalizeWorkSlideAnimation, remapWorkSlideAnimations, removeWorkSlideAnimationsForElements, slideTransitionDurationMilliseconds, workSlideAnimationCues, workSlideAnimationForElement, workSlideAnimationIndex, workSlideTransitionsEqual };

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", {