@a3s-lab/office 0.11.0 → 0.13.0

package/README.md

@@ -139,8 +139,34 @@ The images below are committed visual-regression baselines from the real
 - **Framework choice** — React components, Vue 3 adapters, Custom Elements,
   and a framework-neutral Core API over the same engine.
 - **Responsive computation** — Lazy editor chunks, cancellable Workers,
+  streamed dense XLSX and eligible large-DOCX parsing in dedicated
+  transferable-input Workers, including a fail-closed plain-OOXML path that
+  reuses the package Worker's decompressed worksheet XML and aborts speculative
+  SheetJS parsing only after package authentication,
   CSS-compatible font-weight matching, Rust WebAssembly layout and
-  calculation, and PDFium rendering.
+  calculation, and PDFium rendering. Spreadsheet Canvas painting is bounded
+  to the visible row and column range. Eligible structurally plain large DOCX
+  files retain one complete canonical structured model while TipTap initially
+  materializes only two equal-position chunks and hydrates a selected chunk on
+  demand. The large-DOCX Worker streams 2,048-item batches and columnar table
+  metadata instead of cloning one complete object graph. Pooled semantic
+  previews, physical page sheets, and pagination widgets are windowed
+  independently. The PDF rail mounts at most 32 thumbnail buttons, aborts the
+  exact PDFium task when a thumbnail leaves the window, and uses instant
+  long-distance keyboard jumps so the destination retains focus. The checked
+  1,000-page fixture mounts 15 thumbnails and seven main-view pages at
+  readiness. Presentation decks above 60 slides use independent thumbnail-node
+  and scene windows. The checked 1,000-slide, 9,000-element fixture mounts 18
+  thumbnail buttons and 13 full thumbnail scenes, retains about 10.9 MiB of
+  JavaScript heap, reaches slide 1,000 in 6.1–13.4 ms, and produces no Long
+  Tasks. Design metadata is normalized once per controlled value and each
+  visible thumbnail resolves only its own slide. The checked 100,000-block
+  fixtures keep
+  selection, editing, and export positions in the canonical model instead of
+  replacing them with a React-only virtual list; rich and collaborative models
+  deliberately retain the complete compatibility path. Consecutive controlled
+  edits hash only changed lazy chunks and combine cached fingerprint segments,
+  while cloned or persisted models still receive complete HTML verification.
 - **AI without UI scraping** — Typed agent ports and host-defined selection
   actions receive structured context and editing commands.
 - **Automation outside the browser** — The native Rust CLI, standard MCP
@@ -250,6 +276,32 @@ export function ProjectBrief() {
 The editor owns editing, layout, import/export, and browser rendering. The host
 owns persistence and decides when, where, and how the emitted content is saved.
 
+### Preload an anticipated PDF
+
+Editor modules remain lazy. PDFium runtime loading is a separate, explicit
+choice because its unpacked WebAssembly binary is about 4.4 MiB. Warm both only
+from a high-confidence intent, and use the same URL when mounting `PdfViewer`:
+
+```tsx
+import { PdfViewer, preloadOfficeEditor } from '@a3s-lab/office/react';
+
+const pdfiumUrl = '/assets/pdfium.wasm';
+
+void preloadOfficeEditor('pdf', {
+  pdfWasmUrl: pdfiumUrl,
+  preloadRuntimeAssets: true,
+});
+
+<PdfViewer loadSource={loadPdf} wasmUrl={pdfiumUrl} />;
+```
+
+The preload caches the module and, when the request succeeds, the response
+body. Runtime warming is best effort: a network failure does not block editor
+opening, and a later call retries it. The helper does not create a hidden
+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.
+
 ### Persist a structured document snapshot
 
 Hosts that round-trip controlled document values across a process or language
@@ -476,7 +528,11 @@ interaction model.
   commands share the permission-resilient local fallback with their WPS
   shortcuts, a WPS-style Format Painter with single-use and double-click locked
   sessions, cross-sheet range-pattern tiling, Escape cancellation, and native
-  style-only writes, Conditional Formatting under Home and Styles, executable
+  style-only writes, a Home and Font cell-border split control with side, all,
+  outside, inside, horizontal, vertical, clear, and diagonal targets, ten
+  native line styles, exact color selection, compact overlapping range writes,
+  single-update undo, and grid-focus restoration, Conditional Formatting under
+  Home and Styles, executable
   sorting plus WPS-style AutoFilter under Data, finite current-region discovery,
   `Cmd/Ctrl+Shift+L` toggling, an `Alt+ArrowDown` keyboard filter menu,
   a Home and Cells Rows and Columns menu for inserting above, below, left, or
@@ -487,6 +543,10 @@ interaction model.
   a Home and Editing Clear menu for independently removing content, formats,
   comments, hyperlinks, or all cell state while preserving merge geometry,
   with Delete and Backspace mapped to Clear Contents,
+  a Home and Editing Fill menu for Down, Right, Up, and Left with native
+  relative-formula and style propagation, WPS `Cmd/Ctrl+D` and `Cmd/Ctrl+R`
+  shortcuts, one-step history, protected-range preflight, a 50,000-target-cell
+  guard, and sparse-row-safe execution,
   a View and Window Freeze Panes menu for current-cell, top-row, first-column,
   and unfreeze patterns with XLSX round trips, and visible F9 workbook
   recalculation,
@@ -516,9 +576,10 @@ interaction model.
 - **PDF** — PDFium rendering, navigation, search, form filling, annotations,
   annotation color, opacity, compatible stroke-width controls, history,
   a scrollable page-thumbnail rail with current-page synchronization and
-  focus-synchronized Arrow/Home/End navigation, bounded rendering for long
-  files, and a dismissible page drawer whose phone trigger stays in the page
-  controls instead of covering PDF content,
+  focus-synchronized Arrow/Home/End navigation, a 32-thumbnail hard window,
+  cancellation of stale PDFium bitmap tasks, bounded main-page rendering for
+  long files, and a dismissible page drawer whose phone trigger stays in the
+  page controls instead of covering PDF content,
   focus-safe page and search drafts, responsive search-result, navigation, and
   zoom controls, editor-scoped shortcuts, and a keyboard-operated overflow menu
   that retains secondary annotation tools and appearance settings on phones.
@@ -578,11 +639,57 @@ import {
   importOfficeFile,
 } from '@a3s-lab/office/core';
 
-const imported = await importOfficeFile(file);
+const controller = new AbortController();
+const shell = createArtifact('blank-document');
+const imported = await importOfficeFile(file, {
+  artifactId: shell.id,
+  signal: controller.signal,
+  onProgress: ({ stage, progress }) => {
+    console.info(stage, `${Math.round(progress * 100)}%`);
+  },
+});
 const output = await createArtifactBlob(imported);
 const blankDeck = createArtifact('blank-presentation');
+
+const workbookShell = createArtifact('blank-spreadsheet');
+if (workbookShell.content.type !== 'spreadsheet') {
+  throw new Error('Expected a Spreadsheet shell.');
+}
+const workbook = await importOfficeFile(spreadsheetFile, {
+  artifactId: workbookShell.id,
+  spreadsheetSheetIds: workbookShell.content.sheets.flatMap((sheet) =>
+    sheet.id ? [sheet.id] : [],
+  ),
+});
 ```
 
+Import progress advances monotonically through `reading`, `parsing`,
+`analyzing`, and `finalizing`. Calling `controller.abort()` rejects with an
+`AbortError`; large reads and parser checkpoints yield so a host can keep the
+progress and Cancel controls responsive. An optional host-reserved
+`artifactId` lets the UI mount an editor shell before parsing finishes and then
+apply the imported controlled value without remounting that surface. The
+Playground uses this boundary to overlap DOCX Worker parsing with editor
+initialization; source-backed export remains attached to the reserved ID. A
+Spreadsheet host can also reserve worksheet identities with
+`spreadsheetSheetIds`. Eligible structurally plain workbooks then replace the
+authenticated frozen matrix inside the mounted Fortune instance instead of
+cloning one million cells through a second mount. Sheet-count or identity
+changes, preview mode, charts, protection, merged or styled geometry, and other
+stateful workbook structures retain the complete remount path. The plain-OOXML
+Worker authenticates row and cell coordinates directly in its XML buffer, so a
+million-cell import does not allocate or regex-match a million address strings.
+
+Spreadsheet import and export preserve sparse worksheets up to the XLSX limit
+of 1,048,576 rows by 16,384 columns. The logical `data.length`, `row`, and
+`column` dimensions can be large while only populated indexes are materialized.
+Virtual scrolling never emits `onChange`, and editing a far blank row creates
+only that row. Data-validation regions remain compact in
+`dataValidationRanges`; direct `dataVerification` entries take precedence.
+Protection ranges, passwordless editable ranges, and conditional formatting
+also remain compact and round-trip through native XLSX records without
+allocating every covered cell.
+
 Use `downloadArtifact` to start a browser download or
 `createArtifactBlob` when your application owns upload and persistence.
 Imported DOCX artifacts are source-backed: safe source-only OPC parts,
@@ -1320,6 +1427,12 @@ bun run lint
 bun run typecheck
 bun run test
 bun run build
+bun run test:e2e:large-pdf:check
+bun run test:e2e:large-pdf
+bun run performance:pdf
+bun run test:e2e:large-presentation:check
+bun run test:e2e:large-presentation
+bun run performance:presentation
 ```
 
 Start the integration Playground with `bun run playground`. The full pull
@@ -1338,6 +1451,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.13.0 documentation](https://a3s-lab.github.io/Office/docs/0.13.0/)
+- [A3S Office 0.12.0 documentation](https://a3s-lab.github.io/Office/docs/0.12.0/)
 - [A3S Office 0.11.0 documentation](https://a3s-lab.github.io/Office/docs/0.11.0/)
 - [A3S Office 0.10.0 documentation](https://a3s-lab.github.io/Office/docs/0.10.0/)
 - [A3S Office 0.9.2 documentation](https://a3s-lab.github.io/Office/docs/0.9.2/)

package/dist/0~1403.js

@@ -125,6 +125,19 @@ function presentationGroupPath(element) {
 const DEFAULT_PRESENTATION_MASTER_ID = 'presentation-master-default';
 const DEFAULT_PRESENTATION_LAYOUT_ID = 'presentation-layout-default';
 function withPresentationDesign(content) {
+    const designContent = withPresentationDesignMetadata(content);
+    const layoutIds = new Set(designContent.layouts.map((layout)=>layout.id));
+    const firstLayoutId = designContent.layouts[0].id;
+    return {
+        ...designContent,
+        slides: designContent.slides.map((slide)=>({
+                ...slide,
+                layoutId: slide.layoutId && layoutIds.has(slide.layoutId) ? slide.layoutId : firstLayoutId,
+                useLayoutBackground: slide.useLayoutBackground ?? false
+            }))
+    };
+}
+function withPresentationDesignMetadata(content) {
     const masters = content.masters?.length ? content.masters : [
         {
             id: DEFAULT_PRESENTATION_MASTER_ID,
@@ -146,23 +159,18 @@ function withPresentationDesign(content) {
             elements: []
         }
     ];
-    const layoutIds = new Set(layouts.map((layout)=>layout.id));
-    const firstLayoutId = layouts[0].id;
     return {
         ...content,
         masters,
-        layouts,
-        slides: content.slides.map((slide)=>({
-                ...slide,
-                layoutId: slide.layoutId && layoutIds.has(slide.layoutId) ? slide.layoutId : firstLayoutId,
-                useLayoutBackground: slide.useLayoutBackground ?? false
-            }))
+        layouts
     };
 }
 function presentationSlideView(content, slide) {
-    const normalized = withPresentationDesign(content);
-    const layout = normalized.layouts?.find((candidate)=>candidate.id === slide.layoutId) ?? normalized.layouts?.[0];
-    const master = normalized.masters?.find((candidate)=>candidate.id === layout?.masterId) ?? normalized.masters?.[0];
+    return presentationSlideViewFromDesign(withPresentationDesign(content), slide);
+}
+function presentationSlideViewFromDesign(designContent, slide) {
+    const layout = designContent.layouts.find((candidate)=>candidate.id === slide.layoutId) ?? designContent.layouts[0];
+    const master = designContent.masters.find((candidate)=>candidate.id === layout?.masterId) ?? designContent.masters[0];
     const showMasterElements = false !== slide.showMasterElements && layout?.showMasterElements !== false;
     const masterElements = showMasterElements ? master?.elements ?? [] : [];
     const layoutElements = layout?.elements ?? [];
@@ -242,4 +250,4 @@ function structuredCopy(value) {
     if ('function' == typeof structuredClone) return structuredClone(value);
     return JSON.parse(JSON.stringify(value));
 }
-export { applyPresentationLayout, canGroupPresentationElements, canUngroupPresentationElements, expandPresentationGroupSelection, groupPresentationElements, presentationGroupPath, presentationSelectionUnits, presentationSlideView, remapPresentationGroupPaths, ungroupPresentationElements, withPresentationDesign };
+export { applyPresentationLayout, canGroupPresentationElements, canUngroupPresentationElements, expandPresentationGroupSelection, groupPresentationElements, presentationGroupPath, presentationSelectionUnits, presentationSlideView, presentationSlideViewFromDesign, remapPresentationGroupPaths, ungroupPresentationElements, withPresentationDesign, withPresentationDesignMetadata };