Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
 zemion
|
08b8f84f7b |
@@ -0,0 +1,39 @@
|
||||
name: Verify
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
pull_request:
|
||||
workflow_dispatch:
|
||||
|
||||
concurrency:
|
||||
group: verify-${{ gitea.repository }}-${{ gitea.ref }}
|
||||
cancel-in-progress: true
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
jobs:
|
||||
verify:
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 45
|
||||
env:
|
||||
CI: "true"
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version: "22"
|
||||
cache: npm
|
||||
- name: Select declared npm version
|
||||
run: npm install --global npm@11.17.0
|
||||
- name: Install dependencies
|
||||
run: npm ci
|
||||
- name: Audit runtime dependencies
|
||||
run: npm audit --omit=dev --audit-level=moderate
|
||||
- name: Check, test, and build
|
||||
run: npm run check
|
||||
- name: Install browser engines
|
||||
run: npx playwright install --with-deps chromium firefox webkit
|
||||
- name: Browser tests
|
||||
run: npm run test:browser
|
||||
@@ -3,6 +3,17 @@
|
||||
All notable changes to Office Tools are documented here. Versions follow
|
||||
Semantic Versioning.
|
||||
|
||||
## 0.2.0 - 2026-09-02
|
||||
|
||||
### Added
|
||||
|
||||
- Exact source-copy downloads plus bounded ODF text, CSV, outline and JSON
|
||||
exports using shared Toolbox helpers.
|
||||
- OOXML template/macro-enabled viewing aliases with inert-VBA notices and
|
||||
explicit legacy OLE, RTF, flat-ODF and invalid-container diagnostics.
|
||||
- Deeper ODF fidelity for page geometry, default styles, comments, row/column
|
||||
defaults, hidden-sheet labels and safe drawing transforms.
|
||||
|
||||
## 0.1.0 - 2026-08-31
|
||||
|
||||
### Added
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
# Third-Party Notices
|
||||
|
||||
`@silurus/ooxml` is MIT-licensed (see [LICENSE](./LICENSE)). It bundles the
|
||||
`@silurus/ooxml` is MIT-licensed (see the bundled
|
||||
[MIT licence](./silurus-ooxml-MIT.txt)). It bundles the
|
||||
third-party components listed below, none of which are copyleft. This file
|
||||
is included in the npm tarball so it travels with every install.
|
||||
|
||||
@@ -22,10 +23,10 @@ claim.
|
||||
### MathJax + STIX Two Math (`mathjax-stix2.js`)
|
||||
|
||||
The optional equation-rendering engine (`@silurus/ooxml/math`, opt-in —
|
||||
see the [README's "Rendering equations" section](./README.md#rendering-equations))
|
||||
see the [upstream README's "Rendering equations" section](https://github.com/yukiyokotani/office-open-xml-viewer/blob/main/README.md#rendering-equations))
|
||||
pre-bundles two Apache-2.0 packages into a single ~3 MB asset
|
||||
(`packages/core/assets/mathjax-stix2.js`, built by
|
||||
[`packages/core/build/build-mathjax.mjs`](./packages/core/build/build-mathjax.mjs)).
|
||||
[`packages/core/build/build-mathjax.mjs`](https://github.com/yukiyokotani/office-open-xml-viewer/blob/main/packages/core/build/build-mathjax.mjs)).
|
||||
It ships in the npm tarball but is only fetched by a consuming app at
|
||||
runtime if that app imports `@silurus/ooxml/math` **and** the loaded
|
||||
document actually contains an equation.
|
||||
@@ -134,7 +135,7 @@ its SPDX expression for the same reason (embedded UCD-derived tables).
|
||||
|
||||
## License texts
|
||||
|
||||
- **MIT** — see [LICENSE](./LICENSE) (this repository's own license; the
|
||||
- **MIT** — see the bundled [MIT licence](./silurus-ooxml-MIT.txt) (the upstream
|
||||
MIT-licensed dependencies above use the same standard text with their own
|
||||
copyright holder).
|
||||
- **Unicode License v3** — canonical text at
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
# Office Tools
|
||||
|
||||
Office Tools is a local-first browser application for opening and inspecting
|
||||
office documents without sending them to a server. The initial release focuses
|
||||
on safe, useful viewing of documents, spreadsheets and presentations in both
|
||||
Office Open XML and OpenDocument packages.
|
||||
office documents without sending them to a server. It provides safe, useful
|
||||
viewing of documents, spreadsheets and presentations in Office Open XML and
|
||||
OpenDocument packages, exact source-copy downloads and bounded semantic exports.
|
||||
|
||||
The application is part of the
|
||||
[add·ideas Toolbox](https://git.add-ideas.de/lotobo/toolbox-portal), but remains
|
||||
@@ -11,13 +11,14 @@ fully usable as a standalone static site at any URL depth.
|
||||
|
||||
## Initial format scope
|
||||
|
||||
| Kind | Office Open XML | OpenDocument | Legacy binary |
|
||||
| ------------- | --------------- | ------------ | ------------------------------------- |
|
||||
| Documents | `.docx` | `.odt` | `.doc` is a later compatibility track |
|
||||
| Spreadsheets | `.xlsx` | `.ods` | `.xls` is a later compatibility track |
|
||||
| Presentations | `.pptx` | `.odp` | `.ppt` is a later compatibility track |
|
||||
| Kind | Office Open XML | OpenDocument | Legacy diagnostics |
|
||||
| ------------- | ------------------------------------- | ------------ | ------------------ |
|
||||
| Documents | `.docx/.docm/.dotx/.dotm` | `.odt` | `.doc/.dot/.rtf` |
|
||||
| Spreadsheets | `.xlsx/.xlsm/.xltx/.xltm` | `.ods` | `.xls/.xlt/.xla` |
|
||||
| Presentations | `.pptx/.pptm/.potx/.potm/.ppsx/.ppsm` | `.odp` | `.ppt/.pps/.pot` |
|
||||
|
||||
The viewer is deliberately read-only. It aims to preserve readable content,
|
||||
The viewer is deliberately read-only. Macro-enabled and template variants are
|
||||
opened through their base OOXML family while VBA remains inert. It aims to preserve readable content,
|
||||
structure and useful styling while clearly reporting features it cannot render.
|
||||
It does not claim pixel-perfect fidelity with Microsoft Office or LibreOffice.
|
||||
Macros, scripts, external resources and embedded active content are never run.
|
||||
@@ -27,6 +28,11 @@ OpenDocument files use the project's bounded ZIP/XML reader and semantic React
|
||||
views. Both paths run locally, keep the interface responsive, support search and
|
||||
navigation, and accept source files up to 100 MiB.
|
||||
|
||||
Every opened format can be downloaded as a bit-for-bit exact source copy. The
|
||||
ODF semantic model additionally exports ODT text, the active ODS sheet as CSV,
|
||||
an ODP text outline, and an application-owned JSON inspection report. Those
|
||||
derived formats are intentionally lossy and never replace the source package.
|
||||
|
||||
See [docs/FORMAT-SUPPORT.md](docs/FORMAT-SUPPORT.md) for the feature matrix and
|
||||
known limits.
|
||||
|
||||
@@ -76,8 +82,8 @@ npm run release:artifact
|
||||
The result is written to:
|
||||
|
||||
```text
|
||||
release/office-tools-0.1.0.zip
|
||||
release/office-tools-0.1.0.zip.sha256
|
||||
release/office-tools-0.2.0.zip
|
||||
release/office-tools-0.2.0.zip.sha256
|
||||
```
|
||||
|
||||
The archive contains `toolbox-app.json`, built assets, the full GPL licence,
|
||||
@@ -92,7 +98,7 @@ output.
|
||||
- Source: <https://git.add-ideas.de/lotobo/office-tools>
|
||||
- Licence: `GPL-3.0-or-later`
|
||||
|
||||
The application uses `@add-ideas/toolbox-shell-react` 0.2.3 and validates its
|
||||
The application uses `@add-ideas/toolbox-shell-react` 0.3.0 and validates its
|
||||
production tree with `@add-ideas/toolbox-testkit`.
|
||||
|
||||
## Licence
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
# Corresponding source
|
||||
|
||||
The corresponding source for Office Tools 0.1.0 is available at:
|
||||
The corresponding source for Office Tools 0.2.0 is available at:
|
||||
|
||||
https://git.add-ideas.de/lotobo/office-tools/src/tag/v0.1.0
|
||||
https://git.add-ideas.de/lotobo/office-tools/src/tag/v0.2.0
|
||||
|
||||
Build that tag with Node.js 22 and the exact `package-lock.json`:
|
||||
|
||||
|
||||
@@ -6,8 +6,9 @@ respective authors.
|
||||
|
||||
## add·ideas Toolbox packages
|
||||
|
||||
`@add-ideas/toolbox-contract` and `@add-ideas/toolbox-shell-react` 0.2.3 are
|
||||
licensed under Apache-2.0.
|
||||
`@add-ideas/toolbox-contract` and `@add-ideas/toolbox-shell-react` 0.3.0 are
|
||||
licensed under Apache-2.0. `@add-ideas/toolbox-helpers` 0.2.0 is
|
||||
GPL-3.0-or-later and supplies bounded CSV/JSON and download primitives.
|
||||
|
||||
## Office Open XML viewer
|
||||
|
||||
|
||||
+10
-3
@@ -5,14 +5,16 @@ layers:
|
||||
|
||||
1. The Toolbox shell owns navigation, application identity, theme preferences,
|
||||
help and source links.
|
||||
2. The ingestion boundary checks extension and source size; each parser then
|
||||
validates package identity from its contents and enforces resource limits.
|
||||
2. The ingestion boundary checks extension, source size and an eight-byte
|
||||
signature; renamed OLE/RTF and non-ZIP inputs fail with clear diagnostics.
|
||||
Each parser then validates package identity and enforces resource limits.
|
||||
3. Format adapters convert office packages into one application-owned,
|
||||
read-only document model.
|
||||
4. Viewer components render that model as document pages, spreadsheet sheets or
|
||||
presentation slides without trusting imported markup.
|
||||
|
||||
The original file is immutable. Opening a new file cancels obsolete work and
|
||||
The original `File` is immutable. “Save exact copy” passes that Blob directly to
|
||||
the shared download helper, so there is no parse/rebuild round trip. Opening a new file cancels obsolete work and
|
||||
releases prior buffers and object URLs. Expensive parsing belongs in a module
|
||||
worker so the shell stays responsive and cancellation has a clear boundary.
|
||||
|
||||
@@ -27,6 +29,11 @@ normalized paths, CRC and expansion limits before namespace-aware XML parsing.
|
||||
It rejects DTDs, entities, external resources and active XML, and returns only a
|
||||
typed, serializable model plus transferable packaged image buffers.
|
||||
|
||||
The semantic ODF adapter retains default/named style inheritance, page geometry,
|
||||
spreadsheet row/column defaults and visibility, drawing transforms, comments,
|
||||
notes and active-content notices. Derived text, CSV, outline and JSON inspection
|
||||
exports are bounded and labelled separately from the byte-exact source path.
|
||||
|
||||
## Deployment contract
|
||||
|
||||
Vite emits relative URLs (`base: './'`). `toolbox-app.json` sits beside
|
||||
|
||||
+22
-8
@@ -3,19 +3,33 @@
|
||||
Office Tools 0.1.0 targets read-only browser viewing, not editing or
|
||||
pixel-identical reproduction.
|
||||
|
||||
| Family | Extensions | 0.1 viewing coverage |
|
||||
| ---------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------- |
|
||||
| Office Open XML document | `.docx` | Paginated sections, text, lists, tables, images, shapes, charts, headers/footers, comments, selection and find |
|
||||
| Office Open XML spreadsheet | `.xlsx` | Sheets, cached values/formulas, styles, merges, frozen panes, images, charts, comments, navigation and find |
|
||||
| Office Open XML presentation | `.pptx` | Slides/masters, text, shapes, images, tables, charts, notes, selection, navigation and find |
|
||||
| OpenDocument text | `.odt` | Semantic headings, paragraphs/runs, lists, tables, packaged images, metadata and foot/endnotes |
|
||||
| OpenDocument spreadsheet | `.ods` | Sheets, typed/cached values, formulas, repeats, merges, annotations, basic safe styling and paged rows |
|
||||
| OpenDocument presentation | `.odp` | Slide order, positioned text/shapes, groups, tables, packaged images, notes and basic safe styling |
|
||||
| Family | Extensions | 0.1 viewing coverage |
|
||||
| ---------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
|
||||
| Office Open XML document | `.docx/.docm/.dotx/.dotm` | Paginated sections, text, lists, tables, images, shapes, charts, headers/footers, comments, selection and find |
|
||||
| Office Open XML spreadsheet | `.xlsx/.xlsm/.xltx/.xltm` | Sheets, cached values/formulas, styles, merges, frozen panes, images, charts, comments, navigation and find |
|
||||
| Office Open XML presentation | `.pptx/.pptm/.potx/.potm/.ppsx/.ppsm` | Slides/masters, text, shapes, images, tables, charts, notes, selection, navigation and find |
|
||||
| OpenDocument text | `.odt` | Semantic headings, runs, inherited styles, tables, images, metadata, comments and foot/endnotes |
|
||||
| OpenDocument spreadsheet | `.ods` | Typed/cached values, formulas, repeats, merges, row/column defaults, visibility, annotations and paged rows |
|
||||
| OpenDocument presentation | `.odp` | Page geometry, positioned/transformed shapes, groups, tables, packaged images, notes and safe styling |
|
||||
|
||||
Legacy compound-binary `.doc`, `.xls` and `.ppt` formats are explicitly outside
|
||||
the first package-reader slice. They require a distinct, bounded parser and must
|
||||
not be misidentified as their XML successors.
|
||||
|
||||
The input boundary also identifies RTF, older OpenOffice `.sxw/.sxc/.sxi`, flat
|
||||
OpenDocument `.fodt/.fods/.fodp`, renamed OLE Compound Files and invalid non-ZIP
|
||||
packages. It explains the required conversion instead of passing them to a ZIP
|
||||
or XML successor parser.
|
||||
|
||||
## Export paths
|
||||
|
||||
- `Save exact copy` downloads the original immutable File for every format.
|
||||
- ODT exports plain semantic text; ODS exports the active sheet's cached display
|
||||
values as bounded UTF-8 CSV; ODP exports a text slide/notes outline.
|
||||
- ODF inspection JSON excludes embedded asset bytes while retaining asset
|
||||
identities, sizes, styles, metadata and the bounded semantic structure.
|
||||
- Derived exports are intentionally not advertised as round-trip replacements.
|
||||
|
||||
## Never executed
|
||||
|
||||
Macros, VBA projects, embedded executables, OLE objects, scripts, remote
|
||||
|
||||
@@ -4,8 +4,9 @@
|
||||
|
||||
Selecting a file grants the current browser tab access to that file's bytes.
|
||||
Office Tools does not upload them, send telemetry or fetch a remote conversion
|
||||
service. Data remains in memory unless a future feature explicitly offers a
|
||||
user-triggered local download or browser-local save.
|
||||
service. Data remains in memory unless the user explicitly chooses an exact-copy
|
||||
or derived local download. Download actions create short-lived object URLs and
|
||||
do not contact a service.
|
||||
|
||||
## Threat model
|
||||
|
||||
|
||||
Generated
+24
-16
@@ -1,15 +1,17 @@
|
||||
{
|
||||
"name": "office-tools",
|
||||
"version": "0.1.0",
|
||||
"version": "0.2.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "office-tools",
|
||||
"version": "0.1.0",
|
||||
"version": "0.2.0",
|
||||
"license": "GPL-3.0-or-later",
|
||||
"dependencies": {
|
||||
"@add-ideas/toolbox-contract": "0.2.3",
|
||||
"@add-ideas/toolbox-shell-react": "0.2.3",
|
||||
"@add-ideas/toolbox-contract": "0.3.0",
|
||||
"@add-ideas/toolbox-helpers": "0.2.0",
|
||||
"@add-ideas/toolbox-shell-react": "0.3.0",
|
||||
"@silurus/ooxml": "0.84.1",
|
||||
"@xmldom/xmldom": "0.9.12",
|
||||
"fflate": "0.8.3",
|
||||
@@ -17,7 +19,7 @@
|
||||
"react-dom": "19.2.8"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@add-ideas/toolbox-testkit": "0.2.3",
|
||||
"@add-ideas/toolbox-testkit": "0.3.0",
|
||||
"@eslint/js": "10.0.1",
|
||||
"@playwright/test": "1.62.1",
|
||||
"@testing-library/jest-dom": "6.9.1",
|
||||
@@ -43,18 +45,24 @@
|
||||
}
|
||||
},
|
||||
"node_modules/@add-ideas/toolbox-contract": {
|
||||
"version": "0.2.3",
|
||||
"resolved": "https://git.add-ideas.de/api/packages/lotobo/npm/%40add-ideas%2Ftoolbox-contract/-/0.2.3/toolbox-contract-0.2.3.tgz",
|
||||
"integrity": "sha512-T0PVSuMT40GjTDfQJhEEY3ZawQq8zz1/ry95JdKI6W39CdLacaRXdGnEpDCMHt+jUbf1Jz7Nat/M5dFCgKVM9A==",
|
||||
"version": "0.3.0",
|
||||
"resolved": "https://git.add-ideas.de/api/packages/lotobo/npm/%40add-ideas%2Ftoolbox-contract/-/0.3.0/toolbox-contract-0.3.0.tgz",
|
||||
"integrity": "sha512-dKrK7BjOFwqJaBfJuhKxZKIld4sH0AKjEn6a0yLnbdMUFY+fFv4VSLGV2tNSBD016gumc2iNqOjUj/ld7x4rtA==",
|
||||
"license": "Apache-2.0"
|
||||
},
|
||||
"node_modules/@add-ideas/toolbox-helpers": {
|
||||
"version": "0.2.0",
|
||||
"resolved": "https://git.add-ideas.de/api/packages/lotobo/npm/%40add-ideas%2Ftoolbox-helpers/-/0.2.0/toolbox-helpers-0.2.0.tgz",
|
||||
"integrity": "sha512-SdOqkw+P+3J3fa5iVkzb5P15rVepB001GNV21Oh8w0CZcVL+YRltgD/s+MVcTyrNijWQf3E5vtQON/3N2LLyKg==",
|
||||
"license": "GPL-3.0-or-later"
|
||||
},
|
||||
"node_modules/@add-ideas/toolbox-shell-react": {
|
||||
"version": "0.2.3",
|
||||
"resolved": "https://git.add-ideas.de/api/packages/lotobo/npm/%40add-ideas%2Ftoolbox-shell-react/-/0.2.3/toolbox-shell-react-0.2.3.tgz",
|
||||
"integrity": "sha512-DT5lQDH48BFkFcmFLZnQh7+Cm73JzBPcmp5WzUXypfkUXpEyDYHzaXgmW4kZ0edSwh4RK4sPmx+JPtK0X4aKCQ==",
|
||||
"version": "0.3.0",
|
||||
"resolved": "https://git.add-ideas.de/api/packages/lotobo/npm/%40add-ideas%2Ftoolbox-shell-react/-/0.3.0/toolbox-shell-react-0.3.0.tgz",
|
||||
"integrity": "sha512-74p6JzAOG0YCAKdlc1hLofV4ZIko7vb448S75cIiM88PKm93EHl5VD7g8YVyfM56Ui97UY9dmy+Whiq4sGzpsg==",
|
||||
"license": "Apache-2.0",
|
||||
"dependencies": {
|
||||
"@add-ideas/toolbox-contract": "0.2.3"
|
||||
"@add-ideas/toolbox-contract": "0.3.0"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"react": ">=18 <20",
|
||||
@@ -62,13 +70,13 @@
|
||||
}
|
||||
},
|
||||
"node_modules/@add-ideas/toolbox-testkit": {
|
||||
"version": "0.2.3",
|
||||
"resolved": "https://git.add-ideas.de/api/packages/lotobo/npm/%40add-ideas%2Ftoolbox-testkit/-/0.2.3/toolbox-testkit-0.2.3.tgz",
|
||||
"integrity": "sha512-sq1MwhKWfFKen+N+124hl74qQimRSvmQ9sOU7jdcI+2qCKZ67+2B8rWyezeV80uTFu4Jv6deHksfYQ/tKNV6XQ==",
|
||||
"version": "0.3.0",
|
||||
"resolved": "https://git.add-ideas.de/api/packages/lotobo/npm/%40add-ideas%2Ftoolbox-testkit/-/0.3.0/toolbox-testkit-0.3.0.tgz",
|
||||
"integrity": "sha512-4Fk+oSvZFspOMIXr8Xy040nhAaBsIQAzsGyXWSpjn3+k3yBKq7nB1r5zCHhsXzfdLzvPDAx2KcmSNOhM330D9w==",
|
||||
"dev": true,
|
||||
"license": "Apache-2.0",
|
||||
"dependencies": {
|
||||
"@add-ideas/toolbox-contract": "0.2.3"
|
||||
"@add-ideas/toolbox-contract": "0.3.0"
|
||||
},
|
||||
"bin": {
|
||||
"toolbox-check": "dist/cli.js"
|
||||
|
||||
+18
-5
@@ -1,6 +1,17 @@
|
||||
{
|
||||
"name": "office-tools",
|
||||
"version": "0.1.0",
|
||||
"version": "0.2.0",
|
||||
"description": "Open and inspect Office and OpenDocument files locally in the browser.",
|
||||
"license": "GPL-3.0-or-later",
|
||||
"author": "Albrecht Degering",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "git+https://git.add-ideas.de/lotobo/office-tools.git"
|
||||
},
|
||||
"homepage": "https://git.add-ideas.de/lotobo/office-tools",
|
||||
"bugs": {
|
||||
"url": "https://git.add-ideas.de/lotobo/office-tools/issues"
|
||||
},
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"engines": {
|
||||
@@ -28,8 +39,9 @@
|
||||
"release:artifact": "npm run check && npm run test:browser && npm run package:release -- --force"
|
||||
},
|
||||
"dependencies": {
|
||||
"@add-ideas/toolbox-contract": "0.2.3",
|
||||
"@add-ideas/toolbox-shell-react": "0.2.3",
|
||||
"@add-ideas/toolbox-contract": "0.3.0",
|
||||
"@add-ideas/toolbox-helpers": "0.2.0",
|
||||
"@add-ideas/toolbox-shell-react": "0.3.0",
|
||||
"@silurus/ooxml": "0.84.1",
|
||||
"@xmldom/xmldom": "0.9.12",
|
||||
"fflate": "0.8.3",
|
||||
@@ -37,7 +49,7 @@
|
||||
"react-dom": "19.2.8"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@add-ideas/toolbox-testkit": "0.2.3",
|
||||
"@add-ideas/toolbox-testkit": "0.3.0",
|
||||
"@eslint/js": "10.0.1",
|
||||
"@playwright/test": "1.62.1",
|
||||
"@testing-library/jest-dom": "6.9.1",
|
||||
@@ -57,5 +69,6 @@
|
||||
"typescript-eslint": "8.64.0",
|
||||
"vite": "8.2.2",
|
||||
"vitest": "4.1.11"
|
||||
}
|
||||
},
|
||||
"packageManager": "npm@11.17.0"
|
||||
}
|
||||
|
||||
+20
-2
@@ -18,7 +18,25 @@ export default defineConfig({
|
||||
timeout: 180_000,
|
||||
},
|
||||
projects: [
|
||||
{ name: "chromium", use: { ...devices["Desktop Chrome"] } },
|
||||
{ name: "firefox", use: { ...devices["Desktop Firefox"] } },
|
||||
{
|
||||
name: "chromium",
|
||||
testIgnore: /responsive\.spec\.ts/,
|
||||
use: { ...devices["Desktop Chrome"] },
|
||||
},
|
||||
{
|
||||
name: "firefox",
|
||||
testIgnore: /responsive\.spec\.ts/,
|
||||
use: { ...devices["Desktop Firefox"] },
|
||||
},
|
||||
{
|
||||
name: "webkit",
|
||||
testIgnore: /responsive\.spec\.ts/,
|
||||
use: { ...devices["Desktop Safari"] },
|
||||
},
|
||||
{
|
||||
name: "mobile-chromium",
|
||||
testMatch: /responsive\.spec\.ts/,
|
||||
use: { ...devices["Pixel 5"] },
|
||||
},
|
||||
],
|
||||
});
|
||||
|
||||
@@ -3,6 +3,17 @@
|
||||
All notable changes to Office Tools are documented here. Versions follow
|
||||
Semantic Versioning.
|
||||
|
||||
## 0.2.0 - 2026-09-02
|
||||
|
||||
### Added
|
||||
|
||||
- Exact source-copy downloads plus bounded ODF text, CSV, outline and JSON
|
||||
exports using shared Toolbox helpers.
|
||||
- OOXML template/macro-enabled viewing aliases with inert-VBA notices and
|
||||
explicit legacy OLE, RTF, flat-ODF and invalid-container diagnostics.
|
||||
- Deeper ODF fidelity for page geometry, default styles, comments, row/column
|
||||
defaults, hidden-sheet labels and safe drawing transforms.
|
||||
|
||||
## 0.1.0 - 2026-08-31
|
||||
|
||||
### Added
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
==============================================================================
|
||||
@add-ideas/toolbox-contract@0.2.3
|
||||
@add-ideas/toolbox-contract@0.3.0
|
||||
Declared licence: Apache-2.0
|
||||
Installed from: node_modules/@add-ideas/toolbox-contract
|
||||
==============================================================================
|
||||
@@ -198,7 +198,688 @@ Installed from: node_modules/@add-ideas/toolbox-contract
|
||||
limitations under the License.
|
||||
|
||||
==============================================================================
|
||||
@add-ideas/toolbox-shell-react@0.2.3
|
||||
@add-ideas/toolbox-helpers@0.2.0
|
||||
Declared licence: GPL-3.0-or-later
|
||||
Installed from: node_modules/@add-ideas/toolbox-helpers
|
||||
==============================================================================
|
||||
--- LICENSE ---
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
them if you wish), that you receive source code or can get it if you
|
||||
want it, that you can change the software or use pieces of it in new
|
||||
free programs, and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. You must make sure that they, too, receive
|
||||
or can get the source code. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey verbatim copies of the Program's source code as you
|
||||
receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the object code work.
|
||||
|
||||
A "User Product" is either (1) a "consumer product", which means any
|
||||
tangible personal property which is normally used for personal, family,
|
||||
or household purposes, or (2) anything designed or sold for incorporation
|
||||
into a dwelling. In determining whether a product is a consumer product,
|
||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||
product received by a particular user, "normally used" refers to a
|
||||
typical or common use of that class of product, regardless of the status
|
||||
of the particular user or of the way in which the particular user
|
||||
actually uses, or expects or is expected to use, the product. A product
|
||||
is a consumer product regardless of whether the product has substantial
|
||||
commercial, industrial or non-consumer uses, unless such uses represent
|
||||
the only significant mode of use of the product.
|
||||
|
||||
"Installation Information" for a User Product means any methods,
|
||||
procedures, authorization keys, or other information required to install
|
||||
and execute modified versions of a covered work in that User Product from
|
||||
a modified version of its Corresponding Source. The information must
|
||||
suffice to ensure that the continued functioning of the modified object
|
||||
code is in no case prevented or interfered with solely because
|
||||
modification has been made.
|
||||
|
||||
If you convey an object code work under this section in, or with, or
|
||||
specifically for use in, a User Product, and the conveying occurs as
|
||||
part of a transaction in which the right of possession and use of the
|
||||
User Product is transferred to the recipient in perpetuity or for a
|
||||
fixed term (regardless of how the transaction is characterized), the
|
||||
Corresponding Source conveyed under this section must be accompanied
|
||||
by the Installation Information. But this requirement does not apply
|
||||
if neither you nor any third party retains the ability to install
|
||||
modified object code on the User Product (for example, the work has
|
||||
been installed in ROM).
|
||||
|
||||
The requirement to provide Installation Information does not include a
|
||||
requirement to continue to provide support service, warranty, or updates
|
||||
for a work that has been modified or installed by the recipient, or for
|
||||
the User Product in which it has been modified or installed. Access to a
|
||||
network may be denied when the modification itself materially and
|
||||
adversely affects the operation of the network or violates the rules and
|
||||
protocols for communication across the network.
|
||||
|
||||
Corresponding Source conveyed, and Installation Information provided,
|
||||
in accord with this section must be in a format that is publicly
|
||||
documented (and with an implementation available to the public in
|
||||
source code form), and must require no special password or key for
|
||||
unpacking, reading or copying.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the
|
||||
Program specifies that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||
SUCH DAMAGES.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
<one line to give the program's name and a brief idea of what it does.>
|
||||
Copyright (C) <year> <name of author>
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
<program> Copyright (C) <year> <name of author>
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<https://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<https://www.gnu.org/licenses/why-not-lgpl.html>.
|
||||
|
||||
==============================================================================
|
||||
@add-ideas/toolbox-shell-react@0.3.0
|
||||
Declared licence: Apache-2.0
|
||||
Installed from: node_modules/@add-ideas/toolbox-shell-react
|
||||
==============================================================================
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
# Third-Party Notices
|
||||
|
||||
`@silurus/ooxml` is MIT-licensed (see [LICENSE](./LICENSE)). It bundles the
|
||||
`@silurus/ooxml` is MIT-licensed (see the bundled
|
||||
[MIT licence](./silurus-ooxml-MIT.txt)). It bundles the
|
||||
third-party components listed below, none of which are copyleft. This file
|
||||
is included in the npm tarball so it travels with every install.
|
||||
|
||||
@@ -22,10 +23,10 @@ claim.
|
||||
### MathJax + STIX Two Math (`mathjax-stix2.js`)
|
||||
|
||||
The optional equation-rendering engine (`@silurus/ooxml/math`, opt-in —
|
||||
see the [README's "Rendering equations" section](./README.md#rendering-equations))
|
||||
see the [upstream README's "Rendering equations" section](https://github.com/yukiyokotani/office-open-xml-viewer/blob/main/README.md#rendering-equations))
|
||||
pre-bundles two Apache-2.0 packages into a single ~3 MB asset
|
||||
(`packages/core/assets/mathjax-stix2.js`, built by
|
||||
[`packages/core/build/build-mathjax.mjs`](./packages/core/build/build-mathjax.mjs)).
|
||||
[`packages/core/build/build-mathjax.mjs`](https://github.com/yukiyokotani/office-open-xml-viewer/blob/main/packages/core/build/build-mathjax.mjs)).
|
||||
It ships in the npm tarball but is only fetched by a consuming app at
|
||||
runtime if that app imports `@silurus/ooxml/math` **and** the loaded
|
||||
document actually contains an equation.
|
||||
@@ -134,7 +135,7 @@ its SPDX expression for the same reason (embedded UCD-derived tables).
|
||||
|
||||
## License texts
|
||||
|
||||
- **MIT** — see [LICENSE](./LICENSE) (this repository's own license; the
|
||||
- **MIT** — see the bundled [MIT licence](./silurus-ooxml-MIT.txt) (the upstream
|
||||
MIT-licensed dependencies above use the same standard text with their own
|
||||
copyright holder).
|
||||
- **Unicode License v3** — canonical text at
|
||||
|
||||
+18
-12
@@ -1,9 +1,9 @@
|
||||
# Office Tools
|
||||
|
||||
Office Tools is a local-first browser application for opening and inspecting
|
||||
office documents without sending them to a server. The initial release focuses
|
||||
on safe, useful viewing of documents, spreadsheets and presentations in both
|
||||
Office Open XML and OpenDocument packages.
|
||||
office documents without sending them to a server. It provides safe, useful
|
||||
viewing of documents, spreadsheets and presentations in Office Open XML and
|
||||
OpenDocument packages, exact source-copy downloads and bounded semantic exports.
|
||||
|
||||
The application is part of the
|
||||
[add·ideas Toolbox](https://git.add-ideas.de/lotobo/toolbox-portal), but remains
|
||||
@@ -11,13 +11,14 @@ fully usable as a standalone static site at any URL depth.
|
||||
|
||||
## Initial format scope
|
||||
|
||||
| Kind | Office Open XML | OpenDocument | Legacy binary |
|
||||
| ------------- | --------------- | ------------ | ------------------------------------- |
|
||||
| Documents | `.docx` | `.odt` | `.doc` is a later compatibility track |
|
||||
| Spreadsheets | `.xlsx` | `.ods` | `.xls` is a later compatibility track |
|
||||
| Presentations | `.pptx` | `.odp` | `.ppt` is a later compatibility track |
|
||||
| Kind | Office Open XML | OpenDocument | Legacy diagnostics |
|
||||
| ------------- | ------------------------------------- | ------------ | ------------------ |
|
||||
| Documents | `.docx/.docm/.dotx/.dotm` | `.odt` | `.doc/.dot/.rtf` |
|
||||
| Spreadsheets | `.xlsx/.xlsm/.xltx/.xltm` | `.ods` | `.xls/.xlt/.xla` |
|
||||
| Presentations | `.pptx/.pptm/.potx/.potm/.ppsx/.ppsm` | `.odp` | `.ppt/.pps/.pot` |
|
||||
|
||||
The viewer is deliberately read-only. It aims to preserve readable content,
|
||||
The viewer is deliberately read-only. Macro-enabled and template variants are
|
||||
opened through their base OOXML family while VBA remains inert. It aims to preserve readable content,
|
||||
structure and useful styling while clearly reporting features it cannot render.
|
||||
It does not claim pixel-perfect fidelity with Microsoft Office or LibreOffice.
|
||||
Macros, scripts, external resources and embedded active content are never run.
|
||||
@@ -27,6 +28,11 @@ OpenDocument files use the project's bounded ZIP/XML reader and semantic React
|
||||
views. Both paths run locally, keep the interface responsive, support search and
|
||||
navigation, and accept source files up to 100 MiB.
|
||||
|
||||
Every opened format can be downloaded as a bit-for-bit exact source copy. The
|
||||
ODF semantic model additionally exports ODT text, the active ODS sheet as CSV,
|
||||
an ODP text outline, and an application-owned JSON inspection report. Those
|
||||
derived formats are intentionally lossy and never replace the source package.
|
||||
|
||||
See [docs/FORMAT-SUPPORT.md](docs/FORMAT-SUPPORT.md) for the feature matrix and
|
||||
known limits.
|
||||
|
||||
@@ -76,8 +82,8 @@ npm run release:artifact
|
||||
The result is written to:
|
||||
|
||||
```text
|
||||
release/office-tools-0.1.0.zip
|
||||
release/office-tools-0.1.0.zip.sha256
|
||||
release/office-tools-0.2.0.zip
|
||||
release/office-tools-0.2.0.zip.sha256
|
||||
```
|
||||
|
||||
The archive contains `toolbox-app.json`, built assets, the full GPL licence,
|
||||
@@ -92,7 +98,7 @@ output.
|
||||
- Source: <https://git.add-ideas.de/lotobo/office-tools>
|
||||
- Licence: `GPL-3.0-or-later`
|
||||
|
||||
The application uses `@add-ideas/toolbox-shell-react` 0.2.3 and validates its
|
||||
The application uses `@add-ideas/toolbox-shell-react` 0.3.0 and validates its
|
||||
production tree with `@add-ideas/toolbox-testkit`.
|
||||
|
||||
## Licence
|
||||
|
||||
+2
-2
@@ -1,8 +1,8 @@
|
||||
# Corresponding source
|
||||
|
||||
The corresponding source for Office Tools 0.1.0 is available at:
|
||||
The corresponding source for Office Tools 0.2.0 is available at:
|
||||
|
||||
https://git.add-ideas.de/lotobo/office-tools/src/tag/v0.1.0
|
||||
https://git.add-ideas.de/lotobo/office-tools/src/tag/v0.2.0
|
||||
|
||||
Build that tag with Node.js 22 and the exact `package-lock.json`:
|
||||
|
||||
|
||||
@@ -6,8 +6,9 @@ respective authors.
|
||||
|
||||
## add·ideas Toolbox packages
|
||||
|
||||
`@add-ideas/toolbox-contract` and `@add-ideas/toolbox-shell-react` 0.2.3 are
|
||||
licensed under Apache-2.0.
|
||||
`@add-ideas/toolbox-contract` and `@add-ideas/toolbox-shell-react` 0.3.0 are
|
||||
licensed under Apache-2.0. `@add-ideas/toolbox-helpers` 0.2.0 is
|
||||
GPL-3.0-or-later and supplies bounded CSV/JSON and download primitives.
|
||||
|
||||
## Office Open XML viewer
|
||||
|
||||
|
||||
@@ -5,14 +5,16 @@ layers:
|
||||
|
||||
1. The Toolbox shell owns navigation, application identity, theme preferences,
|
||||
help and source links.
|
||||
2. The ingestion boundary checks extension and source size; each parser then
|
||||
validates package identity from its contents and enforces resource limits.
|
||||
2. The ingestion boundary checks extension, source size and an eight-byte
|
||||
signature; renamed OLE/RTF and non-ZIP inputs fail with clear diagnostics.
|
||||
Each parser then validates package identity and enforces resource limits.
|
||||
3. Format adapters convert office packages into one application-owned,
|
||||
read-only document model.
|
||||
4. Viewer components render that model as document pages, spreadsheet sheets or
|
||||
presentation slides without trusting imported markup.
|
||||
|
||||
The original file is immutable. Opening a new file cancels obsolete work and
|
||||
The original `File` is immutable. “Save exact copy” passes that Blob directly to
|
||||
the shared download helper, so there is no parse/rebuild round trip. Opening a new file cancels obsolete work and
|
||||
releases prior buffers and object URLs. Expensive parsing belongs in a module
|
||||
worker so the shell stays responsive and cancellation has a clear boundary.
|
||||
|
||||
@@ -27,6 +29,11 @@ normalized paths, CRC and expansion limits before namespace-aware XML parsing.
|
||||
It rejects DTDs, entities, external resources and active XML, and returns only a
|
||||
typed, serializable model plus transferable packaged image buffers.
|
||||
|
||||
The semantic ODF adapter retains default/named style inheritance, page geometry,
|
||||
spreadsheet row/column defaults and visibility, drawing transforms, comments,
|
||||
notes and active-content notices. Derived text, CSV, outline and JSON inspection
|
||||
exports are bounded and labelled separately from the byte-exact source path.
|
||||
|
||||
## Deployment contract
|
||||
|
||||
Vite emits relative URLs (`base: './'`). `toolbox-app.json` sits beside
|
||||
|
||||
@@ -3,19 +3,33 @@
|
||||
Office Tools 0.1.0 targets read-only browser viewing, not editing or
|
||||
pixel-identical reproduction.
|
||||
|
||||
| Family | Extensions | 0.1 viewing coverage |
|
||||
| ---------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------- |
|
||||
| Office Open XML document | `.docx` | Paginated sections, text, lists, tables, images, shapes, charts, headers/footers, comments, selection and find |
|
||||
| Office Open XML spreadsheet | `.xlsx` | Sheets, cached values/formulas, styles, merges, frozen panes, images, charts, comments, navigation and find |
|
||||
| Office Open XML presentation | `.pptx` | Slides/masters, text, shapes, images, tables, charts, notes, selection, navigation and find |
|
||||
| OpenDocument text | `.odt` | Semantic headings, paragraphs/runs, lists, tables, packaged images, metadata and foot/endnotes |
|
||||
| OpenDocument spreadsheet | `.ods` | Sheets, typed/cached values, formulas, repeats, merges, annotations, basic safe styling and paged rows |
|
||||
| OpenDocument presentation | `.odp` | Slide order, positioned text/shapes, groups, tables, packaged images, notes and basic safe styling |
|
||||
| Family | Extensions | 0.1 viewing coverage |
|
||||
| ---------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
|
||||
| Office Open XML document | `.docx/.docm/.dotx/.dotm` | Paginated sections, text, lists, tables, images, shapes, charts, headers/footers, comments, selection and find |
|
||||
| Office Open XML spreadsheet | `.xlsx/.xlsm/.xltx/.xltm` | Sheets, cached values/formulas, styles, merges, frozen panes, images, charts, comments, navigation and find |
|
||||
| Office Open XML presentation | `.pptx/.pptm/.potx/.potm/.ppsx/.ppsm` | Slides/masters, text, shapes, images, tables, charts, notes, selection, navigation and find |
|
||||
| OpenDocument text | `.odt` | Semantic headings, runs, inherited styles, tables, images, metadata, comments and foot/endnotes |
|
||||
| OpenDocument spreadsheet | `.ods` | Typed/cached values, formulas, repeats, merges, row/column defaults, visibility, annotations and paged rows |
|
||||
| OpenDocument presentation | `.odp` | Page geometry, positioned/transformed shapes, groups, tables, packaged images, notes and safe styling |
|
||||
|
||||
Legacy compound-binary `.doc`, `.xls` and `.ppt` formats are explicitly outside
|
||||
the first package-reader slice. They require a distinct, bounded parser and must
|
||||
not be misidentified as their XML successors.
|
||||
|
||||
The input boundary also identifies RTF, older OpenOffice `.sxw/.sxc/.sxi`, flat
|
||||
OpenDocument `.fodt/.fods/.fodp`, renamed OLE Compound Files and invalid non-ZIP
|
||||
packages. It explains the required conversion instead of passing them to a ZIP
|
||||
or XML successor parser.
|
||||
|
||||
## Export paths
|
||||
|
||||
- `Save exact copy` downloads the original immutable File for every format.
|
||||
- ODT exports plain semantic text; ODS exports the active sheet's cached display
|
||||
values as bounded UTF-8 CSV; ODP exports a text slide/notes outline.
|
||||
- ODF inspection JSON excludes embedded asset bytes while retaining asset
|
||||
identities, sizes, styles, metadata and the bounded semantic structure.
|
||||
- Derived exports are intentionally not advertised as round-trip replacements.
|
||||
|
||||
## Never executed
|
||||
|
||||
Macros, VBA projects, embedded executables, OLE objects, scripts, remote
|
||||
|
||||
@@ -4,8 +4,9 @@
|
||||
|
||||
Selecting a file grants the current browser tab access to that file's bytes.
|
||||
Office Tools does not upload them, send telemetry or fetch a remote conversion
|
||||
service. Data remains in memory unless a future feature explicitly offers a
|
||||
user-triggered local download or browser-local save.
|
||||
service. Data remains in memory unless the user explicitly chooses an exact-copy
|
||||
or derived local download. Download actions create short-lived object URLs and
|
||||
do not contact a service.
|
||||
|
||||
## Threat model
|
||||
|
||||
|
||||
+1
-1
@@ -1,5 +1,5 @@
|
||||
const CACHE_PREFIX = "office-tools-shell-";
|
||||
const CACHE_NAME = `${CACHE_PREFIX}0.1.0`;
|
||||
const CACHE_NAME = `${CACHE_PREFIX}0.2.0`;
|
||||
const CORE = ["./", "./manifest.webmanifest", "./favicon.svg"];
|
||||
|
||||
self.addEventListener("install", (event) => {
|
||||
|
||||
+40
-2
@@ -3,7 +3,7 @@
|
||||
"schemaVersion": 1,
|
||||
"id": "de.add-ideas.office-tools",
|
||||
"name": "Office Tools",
|
||||
"version": "0.1.0",
|
||||
"version": "0.2.0",
|
||||
"description": "Open and inspect documents, spreadsheets and presentations locally in the browser.",
|
||||
"entry": "./",
|
||||
"icon": "./favicon.svg",
|
||||
@@ -32,9 +32,47 @@
|
||||
"crossOriginIsolated": false,
|
||||
"topLevelContext": false
|
||||
},
|
||||
"io": {
|
||||
"accepts": [
|
||||
{
|
||||
"mediaType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
|
||||
"extensions": [".docx", ".dotx", ".docm", ".dotm"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
|
||||
"extensions": [".xlsx", ".xltx", ".xlsm", ".xltm"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
|
||||
"extensions": [".pptx", ".potx", ".ppsx", ".pptm", ".potm", ".ppsm"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.oasis.opendocument.text",
|
||||
"extensions": [".odt", ".ott"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.oasis.opendocument.spreadsheet",
|
||||
"extensions": [".ods", ".ots"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.oasis.opendocument.presentation",
|
||||
"extensions": [".odp", ".otp"]
|
||||
}
|
||||
],
|
||||
"produces": [
|
||||
{
|
||||
"mediaType": "application/vnd.oasis.opendocument.text",
|
||||
"extensions": [".odt"]
|
||||
},
|
||||
{ "mediaType": "text/csv", "extensions": [".csv"] },
|
||||
{ "mediaType": "text/plain", "extensions": [".txt"] },
|
||||
{ "mediaType": "application/json", "extensions": [".json"] }
|
||||
]
|
||||
},
|
||||
"capabilities": { "required": ["workers"], "optional": [] },
|
||||
"privacy": {
|
||||
"processing": "local",
|
||||
"fileUploads": false,
|
||||
"fileUploads": true,
|
||||
"telemetry": false,
|
||||
"label": "Office files stay in this browser; nothing is uploaded."
|
||||
},
|
||||
|
||||
@@ -45,7 +45,8 @@ export function HelpDialog({ open, onClose }: HelpDialogProps) {
|
||||
<h3>Open a file</h3>
|
||||
<p>
|
||||
Choose a supported document, spreadsheet or presentation, or drop
|
||||
it onto the opening panel. The original file is not changed.
|
||||
it onto the opening panel. The original file is never changed, and
|
||||
“Save exact copy” downloads the same immutable browser File.
|
||||
</p>
|
||||
</section>
|
||||
<section>
|
||||
@@ -58,9 +59,10 @@ export function HelpDialog({ open, onClose }: HelpDialogProps) {
|
||||
<section>
|
||||
<h3>Rendering scope</h3>
|
||||
<p>
|
||||
DOCX, XLSX and PPTX use a high-fidelity canvas renderer. ODT, ODS
|
||||
and ODP use a semantic compatibility view. Unsupported or
|
||||
approximated features are reported.
|
||||
OOXML documents, templates and macro-enabled variants use a
|
||||
high-fidelity canvas renderer. ODT, ODS and ODP use a semantic
|
||||
compatibility view with text/CSV/outline and inspection exports.
|
||||
Unsupported or approximated features are reported.
|
||||
</p>
|
||||
</section>
|
||||
<section>
|
||||
@@ -68,6 +70,7 @@ export function HelpDialog({ open, onClose }: HelpDialogProps) {
|
||||
<p>
|
||||
Imported links are disabled, and embedded active objects are
|
||||
omitted. Office Tools never runs macros or document scripts.
|
||||
Legacy OLE, RTF and flat-ODF inputs receive explicit diagnostics.
|
||||
</p>
|
||||
</section>
|
||||
</div>
|
||||
|
||||
@@ -8,6 +8,7 @@ import {
|
||||
type FormEvent,
|
||||
} from "react";
|
||||
import type { OdfDocument, OdfFormat } from "../office/odf";
|
||||
import { downloadOdfModel, downloadOdfSemanticExport } from "../office/export";
|
||||
import type {
|
||||
OdfWorkerError,
|
||||
OdfWorkerParseRequest,
|
||||
@@ -96,6 +97,7 @@ export function OdfViewer({ file, format, onOpenStateChange }: OdfViewerProps) {
|
||||
const [ready, setReady] = useState<ReadyDocument | null>(null);
|
||||
const [loading, setLoading] = useState(true);
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
const [exportError, setExportError] = useState<string | null>(null);
|
||||
const [zoom, setZoom] = useState(1);
|
||||
const [activeSheet, setActiveSheet] = useState(0);
|
||||
const [sheetPage, setSheetPage] = useState(0);
|
||||
@@ -128,6 +130,7 @@ export function OdfViewer({ file, format, onOpenStateChange }: OdfViewerProps) {
|
||||
if (!active) return;
|
||||
setLoading(true);
|
||||
setError(null);
|
||||
setExportError(null);
|
||||
setReady(null);
|
||||
onOpenStateChangeRef.current?.({
|
||||
status: "loading",
|
||||
@@ -306,6 +309,18 @@ export function OdfViewer({ file, format, onOpenStateChange }: OdfViewerProps) {
|
||||
}
|
||||
};
|
||||
const zoomPercent = Math.round(zoom * 100);
|
||||
const runExport = (action: () => void) => {
|
||||
try {
|
||||
action();
|
||||
setExportError(null);
|
||||
} catch (exportFailure) {
|
||||
setExportError(
|
||||
exportFailure instanceof Error
|
||||
? exportFailure.message
|
||||
: "The local export could not be created.",
|
||||
);
|
||||
}
|
||||
};
|
||||
const elapsed = ready
|
||||
? ready.elapsedMs < 1_000
|
||||
? `${Math.round(ready.elapsedMs)} ms`
|
||||
@@ -415,6 +430,35 @@ export function OdfViewer({ file, format, onOpenStateChange }: OdfViewerProps) {
|
||||
</span>
|
||||
)}
|
||||
</form>
|
||||
|
||||
<div className="office-viewer-toolbar__group office-export-actions">
|
||||
<button
|
||||
type="button"
|
||||
disabled={loading || !model}
|
||||
onClick={() =>
|
||||
model &&
|
||||
runExport(() =>
|
||||
downloadOdfSemanticExport(model, file.name, activeSheet),
|
||||
)
|
||||
}
|
||||
>
|
||||
{model?.format === "ods"
|
||||
? "Export sheet CSV"
|
||||
: model?.format === "odp"
|
||||
? "Export outline"
|
||||
: "Export text"}
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
className="button-secondary"
|
||||
disabled={loading || !model}
|
||||
onClick={() =>
|
||||
model && runExport(() => downloadOdfModel(model, file.name))
|
||||
}
|
||||
>
|
||||
Inspection JSON
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="office-viewer-status" aria-live="polite">
|
||||
@@ -444,6 +488,15 @@ export function OdfViewer({ file, format, onOpenStateChange }: OdfViewerProps) {
|
||||
</div>
|
||||
)}
|
||||
|
||||
{exportError && (
|
||||
<div className="office-inline-alert" role="alert">
|
||||
<span>{exportError}</span>
|
||||
<button type="button" onClick={() => setExportError(null)}>
|
||||
Dismiss
|
||||
</button>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{model && model.warnings.length > 0 && (
|
||||
<details className="odf-warnings">
|
||||
<summary>
|
||||
|
||||
@@ -8,12 +8,13 @@ import {
|
||||
} from "react";
|
||||
import {
|
||||
OFFICE_ACCEPT,
|
||||
detectOfficeFormat,
|
||||
familyForFormat,
|
||||
formatBytes,
|
||||
formatLabel,
|
||||
inspectOfficeFile,
|
||||
type OfficeFormat,
|
||||
} from "../office/formats";
|
||||
import { downloadExactCopy } from "../office/export";
|
||||
import { OoxmlViewer } from "./OoxmlViewer";
|
||||
import { OdfViewer } from "./OdfViewer";
|
||||
|
||||
@@ -38,6 +39,8 @@ const ACCEPTED_FORMATS = [
|
||||
interface SelectedOfficeFile {
|
||||
file: File;
|
||||
format: OfficeFormat;
|
||||
extension: string;
|
||||
notice?: string;
|
||||
identity: number;
|
||||
}
|
||||
|
||||
@@ -50,20 +53,31 @@ export function UploadWorkbench() {
|
||||
const inputId = useId();
|
||||
const inputRef = useRef<HTMLInputElement>(null);
|
||||
const identityRef = useRef(0);
|
||||
const selectionAttemptRef = useRef(0);
|
||||
const [dragging, setDragging] = useState(false);
|
||||
const [selected, setSelected] = useState<SelectedOfficeFile | null>(null);
|
||||
const [selectionError, setSelectionError] = useState<string | null>(null);
|
||||
const [openState, setOpenState] = useState<OpenState | null>(null);
|
||||
|
||||
const select = useCallback((file: File | undefined) => {
|
||||
const select = useCallback(async (file: File | undefined) => {
|
||||
if (!file) return;
|
||||
const attempt = selectionAttemptRef.current + 1;
|
||||
selectionAttemptRef.current = attempt;
|
||||
try {
|
||||
const format = detectOfficeFormat(file);
|
||||
const inspection = await inspectOfficeFile(file);
|
||||
if (selectionAttemptRef.current !== attempt) return;
|
||||
identityRef.current += 1;
|
||||
setSelected({ file, format, identity: identityRef.current });
|
||||
setSelected({
|
||||
file,
|
||||
format: inspection.format,
|
||||
extension: inspection.extension,
|
||||
notice: inspection.notice,
|
||||
identity: identityRef.current,
|
||||
});
|
||||
setSelectionError(null);
|
||||
setOpenState({ status: "loading", detail: "Reading locally" });
|
||||
} catch (error) {
|
||||
if (selectionAttemptRef.current !== attempt) return;
|
||||
setSelectionError(
|
||||
error instanceof Error ? error.message : "This file cannot be opened.",
|
||||
);
|
||||
@@ -71,14 +85,14 @@ export function UploadWorkbench() {
|
||||
}, []);
|
||||
|
||||
const onInput = (event: ChangeEvent<HTMLInputElement>) => {
|
||||
select(event.currentTarget.files?.[0]);
|
||||
void select(event.currentTarget.files?.[0]);
|
||||
event.currentTarget.value = "";
|
||||
};
|
||||
|
||||
const onDrop = (event: DragEvent<HTMLElement>) => {
|
||||
event.preventDefault();
|
||||
setDragging(false);
|
||||
select(event.dataTransfer.files[0]);
|
||||
void select(event.dataTransfer.files[0]);
|
||||
};
|
||||
|
||||
const dragHandlers = {
|
||||
@@ -95,6 +109,7 @@ export function UploadWorkbench() {
|
||||
};
|
||||
|
||||
const close = () => {
|
||||
selectionAttemptRef.current += 1;
|
||||
setSelected(null);
|
||||
setOpenState(null);
|
||||
setSelectionError(null);
|
||||
@@ -113,7 +128,7 @@ export function UploadWorkbench() {
|
||||
);
|
||||
|
||||
if (selected) {
|
||||
const { file, format, identity } = selected;
|
||||
const { file, format, extension, identity, notice } = selected;
|
||||
const family = familyForFormat(format);
|
||||
const isOoxml = format === "docx" || format === "xlsx" || format === "pptx";
|
||||
|
||||
@@ -126,7 +141,7 @@ export function UploadWorkbench() {
|
||||
{fileInput}
|
||||
<section className="file-heading" aria-labelledby="opened-file-name">
|
||||
<div className={`file-kind file-kind--${family}`} aria-hidden="true">
|
||||
{format.toUpperCase()}
|
||||
{extension.toUpperCase()}
|
||||
</div>
|
||||
<div className="file-heading__identity">
|
||||
<p className="eyebrow">{formatLabel(format)}</p>
|
||||
@@ -143,6 +158,14 @@ export function UploadWorkbench() {
|
||||
{openState?.detail ?? "Preparing viewer"}
|
||||
</div>
|
||||
<div className="file-heading__actions">
|
||||
<button
|
||||
type="button"
|
||||
className="button-secondary"
|
||||
onClick={() => downloadExactCopy(file)}
|
||||
title="Download the original bytes without converting or rewriting them"
|
||||
>
|
||||
Save exact copy
|
||||
</button>
|
||||
<button type="button" onClick={() => inputRef.current?.click()}>
|
||||
Open another file
|
||||
</button>
|
||||
@@ -152,6 +175,12 @@ export function UploadWorkbench() {
|
||||
</div>
|
||||
</section>
|
||||
|
||||
{notice && (
|
||||
<div className="office-inline-notice" role="note">
|
||||
{notice}
|
||||
</div>
|
||||
)}
|
||||
|
||||
{selectionError && (
|
||||
<div className="office-inline-alert" role="alert">
|
||||
<span>{selectionError}</span>
|
||||
@@ -230,7 +259,7 @@ export function UploadWorkbench() {
|
||||
</label>
|
||||
{fileInput}
|
||||
<p className="drop-panel__limit">
|
||||
DOCX · ODT · XLSX · ODS · PPTX · ODP · up to 100 MiB
|
||||
OOXML documents/templates · ODT · ODS · ODP · up to 100 MiB
|
||||
</p>
|
||||
</section>
|
||||
|
||||
@@ -253,8 +282,9 @@ export function UploadWorkbench() {
|
||||
))}
|
||||
</div>
|
||||
<p className="scope-note">
|
||||
Legacy binary DOC, XLS and PPT files are a separate compatibility
|
||||
track. Macros, scripts and embedded active content are never run.
|
||||
Macro-enabled OOXML and templates open read-only with VBA kept inert.
|
||||
Legacy DOC, XLS, PPT and RTF are identified with a specific conversion
|
||||
diagnostic. Scripts and embedded active content are never run.
|
||||
</p>
|
||||
</section>
|
||||
</main>
|
||||
|
||||
@@ -2,6 +2,7 @@ import { Fragment, useMemo } from "react";
|
||||
import type { CSSProperties, ElementType, ReactNode } from "react";
|
||||
import type {
|
||||
OdfImage,
|
||||
OdfAnnotation,
|
||||
OdfPresentationDocument,
|
||||
OdfPresentationShape,
|
||||
OdfSpreadsheetCell,
|
||||
@@ -15,6 +16,8 @@ import {
|
||||
ODS_PAGE_ROWS,
|
||||
columnLabel,
|
||||
lengthToPixels,
|
||||
safeOdfTransform,
|
||||
sheetColumnAt,
|
||||
sheetRowsForPage,
|
||||
textTableView,
|
||||
toCssLength,
|
||||
@@ -79,6 +82,27 @@ function TextRuns({
|
||||
});
|
||||
}
|
||||
|
||||
function AnnotationMarkers({
|
||||
annotations,
|
||||
}: {
|
||||
annotations: readonly OdfAnnotation[];
|
||||
}) {
|
||||
if (annotations.length === 0) return null;
|
||||
return annotations.map((annotation, index) => (
|
||||
<sup
|
||||
className="odf-comment-marker"
|
||||
key={`${annotation.id ?? "comment"}-${index}`}
|
||||
title={
|
||||
annotation.creator
|
||||
? `Comment by ${annotation.creator}`
|
||||
: "Document comment"
|
||||
}
|
||||
>
|
||||
💬
|
||||
</sup>
|
||||
));
|
||||
}
|
||||
|
||||
function ImageContent({
|
||||
image,
|
||||
assetUrls,
|
||||
@@ -215,6 +239,7 @@ function TextBlock({
|
||||
{...context}
|
||||
/>
|
||||
))}
|
||||
<AnnotationMarkers annotations={block.annotations} />
|
||||
</p>
|
||||
);
|
||||
}
|
||||
@@ -234,6 +259,7 @@ function TextBlock({
|
||||
{...context}
|
||||
/>
|
||||
))}
|
||||
<AnnotationMarkers annotations={block.annotations} />
|
||||
</Heading>
|
||||
);
|
||||
}
|
||||
@@ -291,7 +317,15 @@ export function OdtDocumentView({
|
||||
...context
|
||||
}: RenderContext & { document: OdfTextDocument }) {
|
||||
return (
|
||||
<article className="odf-document" aria-label="OpenDocument text contents">
|
||||
<article
|
||||
className="odf-document"
|
||||
aria-label="OpenDocument text contents"
|
||||
style={{
|
||||
width: toCssLength(document.pageWidth),
|
||||
minHeight: toCssLength(document.pageHeight),
|
||||
maxWidth: "100%",
|
||||
}}
|
||||
>
|
||||
{document.metadata.title && (
|
||||
<h1 className="odf-document-title">{document.metadata.title}</h1>
|
||||
)}
|
||||
@@ -322,6 +356,38 @@ export function OdtDocumentView({
|
||||
</ol>
|
||||
</section>
|
||||
)}
|
||||
{document.annotations.length > 0 && (
|
||||
<section
|
||||
className="odf-notes odf-comments"
|
||||
aria-label="Document comments"
|
||||
>
|
||||
<h2>Comments</h2>
|
||||
<ol>
|
||||
{document.annotations.map((annotation, index) => {
|
||||
const id = `odt-comment-${index}`;
|
||||
return (
|
||||
<li
|
||||
key={`${annotation.id ?? "comment"}-${index}`}
|
||||
{...unitAttributes(id, context.activeUnitId, true)}
|
||||
>
|
||||
{(annotation.creator || annotation.createdAt) && (
|
||||
<p className="odf-comment-byline">
|
||||
{annotation.creator ?? "Unknown author"}
|
||||
{annotation.createdAt ? ` · ${annotation.createdAt}` : ""}
|
||||
</p>
|
||||
)}
|
||||
<TextBlocks
|
||||
blocks={annotation.blocks}
|
||||
prefix={id}
|
||||
searchable={false}
|
||||
{...context}
|
||||
/>
|
||||
</li>
|
||||
);
|
||||
})}
|
||||
</ol>
|
||||
</section>
|
||||
)}
|
||||
</article>
|
||||
);
|
||||
}
|
||||
@@ -372,17 +438,12 @@ export function OdsWorkbookView({
|
||||
|
||||
return (
|
||||
<div className="odf-workbook">
|
||||
<div
|
||||
className="odf-sheet-tabs"
|
||||
role="tablist"
|
||||
aria-label="Workbook sheets"
|
||||
>
|
||||
<div className="odf-sheet-tabs" role="group" aria-label="Workbook sheets">
|
||||
{document.sheets.map((item, index) => (
|
||||
<button
|
||||
key={`${item.name}-${index}`}
|
||||
type="button"
|
||||
role="tab"
|
||||
aria-selected={index === activeSheetIndex}
|
||||
aria-pressed={index === activeSheetIndex}
|
||||
className={index === activeSheetIndex ? "is-active" : undefined}
|
||||
onClick={() => onSheetChange(index)}
|
||||
>
|
||||
@@ -390,6 +451,11 @@ export function OdsWorkbookView({
|
||||
{item.protected && (
|
||||
<span aria-label="protected sheet"> · protected</span>
|
||||
)}
|
||||
{item.visibility !== "visible" && (
|
||||
<span aria-label={`${item.visibility} sheet`}>
|
||||
{` · ${item.visibility === "collapse" ? "hidden" : "filtered"}`}
|
||||
</span>
|
||||
)}
|
||||
</button>
|
||||
))}
|
||||
</div>
|
||||
@@ -397,7 +463,7 @@ export function OdsWorkbookView({
|
||||
{sheet ? (
|
||||
<div
|
||||
className="odf-sheet"
|
||||
role="tabpanel"
|
||||
style={context.resolveStyle(sheet.styleName, "table")}
|
||||
aria-label={`${sheet.name}, rows ${safePage * ODS_PAGE_ROWS + 1} to ${Math.min(sheet.expandedRowCount, (safePage + 1) * ODS_PAGE_ROWS)}`}
|
||||
>
|
||||
<div className="odf-sheet-page-controls">
|
||||
@@ -429,6 +495,21 @@ export function OdsWorkbookView({
|
||||
role="grid"
|
||||
aria-rowcount={sheet.expandedRowCount}
|
||||
>
|
||||
<colgroup>
|
||||
<col className="odf-row-number-column" />
|
||||
{Array.from({ length: columnCount }, (_, column) => {
|
||||
const definition = sheetColumnAt(sheet, column);
|
||||
return (
|
||||
<col
|
||||
key={column}
|
||||
style={context.resolveStyle(
|
||||
definition?.styleName,
|
||||
"table-column",
|
||||
)}
|
||||
/>
|
||||
);
|
||||
})}
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr>
|
||||
<th className="odf-sheet-corner" aria-hidden="true" />
|
||||
@@ -441,7 +522,11 @@ export function OdsWorkbookView({
|
||||
</thead>
|
||||
<tbody>
|
||||
{rows.map((row) => (
|
||||
<tr key={row.rowIndex} aria-rowindex={row.rowIndex + 1}>
|
||||
<tr
|
||||
key={row.rowIndex}
|
||||
aria-rowindex={row.rowIndex + 1}
|
||||
style={context.resolveStyle(row.styleName, "table-row")}
|
||||
>
|
||||
<th scope="row">{row.rowIndex + 1}</th>
|
||||
{row.cells.map(({ cell, column }) => {
|
||||
if (cell.kind === "covered") return null;
|
||||
@@ -458,7 +543,10 @@ export function OdsWorkbookView({
|
||||
rowSpan={Math.min(cell.rowSpan, ODS_PAGE_ROWS)}
|
||||
title={cellTitle(cell, address)}
|
||||
style={context.resolveStyle(
|
||||
cell.styleName,
|
||||
cell.styleName ??
|
||||
row.defaultCellStyleName ??
|
||||
sheetColumnAt(sheet, column)
|
||||
?.defaultCellStyleName,
|
||||
"table-cell",
|
||||
)}
|
||||
{...unitAttributes(
|
||||
@@ -520,17 +608,21 @@ export function OdsWorkbookView({
|
||||
const DEFAULT_SLIDE_WIDTH = 960;
|
||||
const DEFAULT_SLIDE_HEIGHT = 540;
|
||||
|
||||
function slideSize(shapes: readonly OdfPresentationShape[]): {
|
||||
function slideSize(
|
||||
shapes: readonly OdfPresentationShape[],
|
||||
baseWidth = DEFAULT_SLIDE_WIDTH,
|
||||
baseHeight = DEFAULT_SLIDE_HEIGHT,
|
||||
): {
|
||||
width: number;
|
||||
height: number;
|
||||
} {
|
||||
let width = DEFAULT_SLIDE_WIDTH;
|
||||
let height = DEFAULT_SLIDE_HEIGHT;
|
||||
let width = baseWidth;
|
||||
let height = baseHeight;
|
||||
const visit = (shape: OdfPresentationShape) => {
|
||||
const x = lengthToPixels(shape.x, DEFAULT_SLIDE_WIDTH) ?? 0;
|
||||
const y = lengthToPixels(shape.y, DEFAULT_SLIDE_HEIGHT) ?? 0;
|
||||
const shapeWidth = lengthToPixels(shape.width, DEFAULT_SLIDE_WIDTH) ?? 0;
|
||||
const shapeHeight = lengthToPixels(shape.height, DEFAULT_SLIDE_HEIGHT) ?? 0;
|
||||
const x = lengthToPixels(shape.x, baseWidth) ?? 0;
|
||||
const y = lengthToPixels(shape.y, baseHeight) ?? 0;
|
||||
const shapeWidth = lengthToPixels(shape.width, baseWidth) ?? 0;
|
||||
const shapeHeight = lengthToPixels(shape.height, baseHeight) ?? 0;
|
||||
width = Math.max(width, Math.min(4_096, x + shapeWidth));
|
||||
height = Math.max(height, Math.min(4_096, y + shapeHeight));
|
||||
shape.children.forEach(visit);
|
||||
@@ -559,6 +651,8 @@ function Shape({
|
||||
width: lengthToPixels(shape.width, slideWidth),
|
||||
height: lengthToPixels(shape.height, slideHeight),
|
||||
overflow: "hidden",
|
||||
transform: safeOdfTransform(shape.transform),
|
||||
transformOrigin: "top left",
|
||||
};
|
||||
if (shape.type === "ellipse") positionedStyle.borderRadius = "50%";
|
||||
if (shape.type === "line") {
|
||||
@@ -614,7 +708,16 @@ export function OdpPresentationView({
|
||||
activeSlideIndex: number;
|
||||
}) {
|
||||
const slide = document.slides[activeSlideIndex];
|
||||
const size = useMemo(() => slideSize(slide?.shapes ?? []), [slide]);
|
||||
const baseWidth =
|
||||
lengthToPixels(document.pageWidth, DEFAULT_SLIDE_WIDTH) ??
|
||||
DEFAULT_SLIDE_WIDTH;
|
||||
const baseHeight =
|
||||
lengthToPixels(document.pageHeight, DEFAULT_SLIDE_HEIGHT) ??
|
||||
DEFAULT_SLIDE_HEIGHT;
|
||||
const size = useMemo(
|
||||
() => slideSize(slide?.shapes ?? [], baseWidth, baseHeight),
|
||||
[baseHeight, baseWidth, slide],
|
||||
);
|
||||
if (!slide)
|
||||
return (
|
||||
<p className="odf-empty-scope">This presentation contains no slides.</p>
|
||||
|
||||
@@ -35,6 +35,8 @@ export interface ExpandedSheetCell {
|
||||
|
||||
export interface ExpandedSheetRow {
|
||||
rowIndex: number;
|
||||
styleName?: string;
|
||||
defaultCellStyleName?: string;
|
||||
cells: ExpandedSheetCell[];
|
||||
}
|
||||
|
||||
@@ -170,6 +172,24 @@ function propertiesToCss(
|
||||
css.paddingBottom = safeLength(valueFor(".fo:padding-bottom"));
|
||||
css.paddingLeft = safeLength(valueFor(".fo:padding-left"));
|
||||
css.letterSpacing = safeLength(valueFor(".fo:letter-spacing"));
|
||||
css.textIndent = safeLength(valueFor(".fo:text-indent"));
|
||||
css.width = safeLength(valueFor(".style:column-width"));
|
||||
css.height = safeLength(valueFor(".style:row-height"));
|
||||
|
||||
const verticalAlign = valueFor(".style:vertical-align");
|
||||
if (
|
||||
verticalAlign &&
|
||||
/^(?:top|middle|bottom|baseline|sub|super)$/u.test(verticalAlign)
|
||||
)
|
||||
css.verticalAlign = verticalAlign;
|
||||
const breakBefore = valueFor(".fo:break-before");
|
||||
if (breakBefore === "page") css.breakBefore = "page";
|
||||
const breakAfter = valueFor(".fo:break-after");
|
||||
if (breakAfter === "page") css.breakAfter = "page";
|
||||
const writingMode = valueFor(".style:writing-mode");
|
||||
if (writingMode === "rl-tb") css.writingMode = "horizontal-tb";
|
||||
else if (writingMode === "tb-rl") css.writingMode = "vertical-rl";
|
||||
else if (writingMode === "tb-lr") css.writingMode = "vertical-lr";
|
||||
|
||||
const lineHeight = valueFor(".fo:line-height");
|
||||
if (lineHeight) {
|
||||
@@ -202,20 +222,21 @@ export function createStyleResolver(
|
||||
): StyleResolver {
|
||||
const exact = new Map<string, OdfStyle>();
|
||||
const byName = new Map<string, OdfStyle>();
|
||||
const defaults = new Map<string, OdfStyle>();
|
||||
for (const style of styles) {
|
||||
exact.set(`${style.family ?? ""}\0${style.name}`, style);
|
||||
if (style.isDefault && style.family) defaults.set(style.family, style);
|
||||
if (!byName.has(style.name)) byName.set(style.name, style);
|
||||
}
|
||||
const cache = new Map<string, CSSProperties>();
|
||||
|
||||
return (name, family) => {
|
||||
if (!name) return {};
|
||||
const cacheKey = `${family ?? ""}\0${name}`;
|
||||
const cached = cache.get(cacheKey);
|
||||
if (cached) return cached;
|
||||
const visited = new Set<string>();
|
||||
const chain: OdfStyle[] = [];
|
||||
let current = exact.get(cacheKey) ?? byName.get(name);
|
||||
let current = name ? (exact.get(cacheKey) ?? byName.get(name)) : undefined;
|
||||
while (current && chain.length < 32 && !visited.has(current.name)) {
|
||||
visited.add(current.name);
|
||||
chain.unshift(current);
|
||||
@@ -225,6 +246,9 @@ export function createStyleResolver(
|
||||
) ?? byName.get(current.parentName))
|
||||
: undefined;
|
||||
}
|
||||
const defaultStyle = family ? defaults.get(family) : undefined;
|
||||
if (defaultStyle && !chain.includes(defaultStyle))
|
||||
chain.unshift(defaultStyle);
|
||||
const result = Object.assign(
|
||||
{},
|
||||
...chain.map((style) => propertiesToCss(style.properties)),
|
||||
@@ -234,6 +258,84 @@ export function createStyleResolver(
|
||||
};
|
||||
}
|
||||
|
||||
/** Convert the inert, bounded subset of ODF drawing transforms to CSS. */
|
||||
export function safeOdfTransform(
|
||||
value: string | undefined,
|
||||
): string | undefined {
|
||||
if (!value || value.length > 256 || /[;{}]|url|var|calc/iu.test(value))
|
||||
return undefined;
|
||||
const result: string[] = [];
|
||||
const matcher = /([a-z]+)\s*\(([^()]*)\)/giu;
|
||||
let consumed = 0;
|
||||
for (const match of value.matchAll(matcher)) {
|
||||
if (match.index !== consumed && value.slice(consumed, match.index).trim())
|
||||
return undefined;
|
||||
consumed = (match.index ?? 0) + match[0].length;
|
||||
const operation = match[1]?.toLowerCase(),
|
||||
parameters = (match[2] ?? "")
|
||||
.trim()
|
||||
.split(/[\s,]+/u)
|
||||
.filter(Boolean);
|
||||
if (
|
||||
operation === "translate" &&
|
||||
parameters.length >= 1 &&
|
||||
parameters.length <= 2
|
||||
) {
|
||||
const translated = parameters.map(safeTransformLength);
|
||||
if (translated.some((item) => item === undefined)) return undefined;
|
||||
result.push(`translate(${translated.join(", ")})`);
|
||||
} else if (
|
||||
operation === "scale" &&
|
||||
parameters.length >= 1 &&
|
||||
parameters.length <= 2
|
||||
) {
|
||||
if (!parameters.every(safeTransformNumber)) return undefined;
|
||||
result.push(`scale(${parameters.join(", ")})`);
|
||||
} else if (operation === "rotate" && parameters.length === 1) {
|
||||
const angle = safeTransformAngle(parameters[0]);
|
||||
if (!angle) return undefined;
|
||||
result.push(`rotate(${angle})`);
|
||||
} else if (
|
||||
(operation === "skewx" || operation === "skewy") &&
|
||||
parameters.length === 1
|
||||
) {
|
||||
const angle = safeTransformAngle(parameters[0]);
|
||||
if (!angle) return undefined;
|
||||
result.push(`${operation === "skewx" ? "skewX" : "skewY"}(${angle})`);
|
||||
} else return undefined;
|
||||
}
|
||||
if (value.slice(consumed).trim() || result.length === 0) return undefined;
|
||||
return result.join(" ");
|
||||
}
|
||||
|
||||
function safeTransformLength(value: string): string | undefined {
|
||||
const match = /^([+-]?(?:\d+(?:\.\d+)?|\.\d+))(cm|mm|in|pt|pc|px)?$/iu.exec(
|
||||
value,
|
||||
);
|
||||
if (!match) return undefined;
|
||||
const number = Number(match[1]);
|
||||
return Number.isFinite(number) && Math.abs(number) <= 10_000
|
||||
? `${number}${match[2] ?? "px"}`
|
||||
: undefined;
|
||||
}
|
||||
|
||||
function safeTransformNumber(value: string): boolean {
|
||||
const number = Number(value);
|
||||
return Number.isFinite(number) && Math.abs(number) <= 1_000;
|
||||
}
|
||||
|
||||
function safeTransformAngle(value: string | undefined): string | undefined {
|
||||
if (!value) return undefined;
|
||||
const match = /^([+-]?(?:\d+(?:\.\d+)?|\.\d+))(deg|rad|grad|turn)?$/iu.exec(
|
||||
value,
|
||||
);
|
||||
if (!match) return undefined;
|
||||
const number = Number(match[1]);
|
||||
if (!Number.isFinite(number) || Math.abs(number) > 100_000) return undefined;
|
||||
// ODF's unitless rotate parameter is radians.
|
||||
return `${number}${match[2] ?? "rad"}`;
|
||||
}
|
||||
|
||||
export function toCssLength(length: OdfLength | undefined): string | undefined {
|
||||
if (!length || !Number.isFinite(length.value)) return undefined;
|
||||
const bound = length.unit === "%" ? 1_000 : 10_000;
|
||||
@@ -332,7 +434,12 @@ export function sheetRowsForPage(
|
||||
});
|
||||
}
|
||||
}
|
||||
result.push({ rowIndex, cells });
|
||||
result.push({
|
||||
rowIndex,
|
||||
styleName: sourceRow.styleName,
|
||||
defaultCellStyleName: sourceRow.defaultCellStyleName,
|
||||
cells,
|
||||
});
|
||||
}
|
||||
}
|
||||
return result;
|
||||
@@ -349,6 +456,12 @@ export function columnLabel(column: number): string {
|
||||
return result;
|
||||
}
|
||||
|
||||
export function sheetColumnAt(sheet: OdfSpreadsheetSheet, column: number) {
|
||||
return sheet.columns.find(
|
||||
(item) => column >= item.index && column < item.index + item.repeat,
|
||||
);
|
||||
}
|
||||
|
||||
export function flattenBlocks(blocks: readonly OdfTextBlock[]): string {
|
||||
const parts: string[] = [];
|
||||
const visit = (block: OdfTextBlock) => {
|
||||
@@ -457,6 +570,12 @@ export function buildSearchResult(
|
||||
unitId: `odt-note-${index}`,
|
||||
}),
|
||||
);
|
||||
document.annotations.forEach((annotation, index) =>
|
||||
add(flattenBlocks(annotation.blocks), {
|
||||
scopeIndex: 0,
|
||||
unitId: `odt-comment-${index}`,
|
||||
}),
|
||||
);
|
||||
} else if (document.format === "ods") {
|
||||
outer: for (
|
||||
let sheetIndex = 0;
|
||||
|
||||
@@ -0,0 +1,203 @@
|
||||
import {
|
||||
stableStringify,
|
||||
stringifyCsv,
|
||||
triggerBlobDownload,
|
||||
} from "@add-ideas/toolbox-helpers";
|
||||
import type {
|
||||
OdfDocument,
|
||||
OdfPresentationShape,
|
||||
OdfSpreadsheetSheet,
|
||||
OdfTextBlock,
|
||||
} from "./odf";
|
||||
|
||||
const MAX_EXPORT_ROWS = 50_000;
|
||||
const MAX_EXPORT_CELLS = 250_000;
|
||||
const MAX_EXPORT_TEXT = 5_000_000;
|
||||
|
||||
export function downloadExactCopy(file: File): void {
|
||||
triggerBlobDownload(file, file.name || "office-source.bin");
|
||||
}
|
||||
|
||||
export function downloadOdfSemanticExport(
|
||||
document: OdfDocument,
|
||||
sourceName: string,
|
||||
activeSheetIndex = 0,
|
||||
): void {
|
||||
const base = withoutExtension(sourceName) || "office-export";
|
||||
if (document.format === "ods") {
|
||||
const sheet = document.sheets[activeSheetIndex];
|
||||
if (!sheet) throw new Error("The selected workbook has no active sheet.");
|
||||
const csv = sheetToCsv(sheet);
|
||||
triggerBlobDownload(
|
||||
new Blob(["\uFEFF", csv], { type: "text/csv;charset=utf-8" }),
|
||||
`${base}-${safePart(sheet.name)}.csv`,
|
||||
);
|
||||
return;
|
||||
}
|
||||
const text =
|
||||
document.format === "odt"
|
||||
? [
|
||||
blocksToText(document.blocks),
|
||||
...document.notes.map((note) => blocksToText(note.blocks)),
|
||||
...document.annotations.map((comment) =>
|
||||
blocksToText(comment.blocks),
|
||||
),
|
||||
]
|
||||
.filter(Boolean)
|
||||
.join("\n\n")
|
||||
: presentationToText(document.slides);
|
||||
if (text.length > MAX_EXPORT_TEXT)
|
||||
throw new Error(
|
||||
"The semantic text export exceeds the 5,000,000-character limit.",
|
||||
);
|
||||
triggerBlobDownload(
|
||||
new Blob([text], { type: "text/plain;charset=utf-8" }),
|
||||
`${base}-${document.format === "odt" ? "text" : "outline"}.txt`,
|
||||
);
|
||||
}
|
||||
|
||||
export function downloadOdfModel(
|
||||
document: OdfDocument,
|
||||
sourceName: string,
|
||||
): void {
|
||||
const { assets, ...model } = document;
|
||||
const source = stableStringify(
|
||||
{
|
||||
schema: "de.add-ideas.office-tools.odf-inspection.v1",
|
||||
sourceName,
|
||||
...model,
|
||||
assets: assets.map((asset) => ({
|
||||
id: asset.id,
|
||||
path: asset.path,
|
||||
mediaType: asset.mediaType,
|
||||
byteLength: asset.byteLength,
|
||||
})),
|
||||
},
|
||||
2,
|
||||
{ maxDepth: 160, maxNodes: 500_000, maxTextChars: MAX_EXPORT_TEXT },
|
||||
);
|
||||
triggerBlobDownload(
|
||||
new Blob([source, "\n"], { type: "application/json;charset=utf-8" }),
|
||||
`${withoutExtension(sourceName) || "office"}-inspection.json`,
|
||||
);
|
||||
}
|
||||
|
||||
export function sheetToCsv(sheet: OdfSpreadsheetSheet): string {
|
||||
if (sheet.expandedRowCount > MAX_EXPORT_ROWS)
|
||||
throw new Error(
|
||||
`This sheet has ${sheet.expandedRowCount.toLocaleString()} rows; CSV export is limited to ${MAX_EXPORT_ROWS.toLocaleString()} rows.`,
|
||||
);
|
||||
const rows: string[][] = [];
|
||||
let cellCount = 0;
|
||||
for (const sourceRow of sheet.rows) {
|
||||
for (let repeat = 0; repeat < sourceRow.rowRepeat; repeat += 1) {
|
||||
const row: string[] = [];
|
||||
for (const cell of sourceRow.cells) {
|
||||
for (let offset = 0; offset < cell.columnRepeat; offset += 1) {
|
||||
const column = cell.column + offset;
|
||||
if (column >= 256) break;
|
||||
row[column] = cell.kind === "covered" ? "" : cellDisplay(cell);
|
||||
}
|
||||
}
|
||||
while (row.at(-1) === "") row.pop();
|
||||
cellCount += row.length;
|
||||
if (cellCount > MAX_EXPORT_CELLS)
|
||||
throw new Error(
|
||||
`CSV export is limited to ${MAX_EXPORT_CELLS.toLocaleString()} populated-range cells.`,
|
||||
);
|
||||
rows.push(row);
|
||||
}
|
||||
}
|
||||
return stringifyCsv(rows, {
|
||||
maxRows: MAX_EXPORT_ROWS,
|
||||
maxColumns: 256,
|
||||
maxFieldChars: 1_000_000,
|
||||
});
|
||||
}
|
||||
|
||||
function cellDisplay(
|
||||
cell: OdfSpreadsheetSheet["rows"][number]["cells"][number],
|
||||
): string {
|
||||
if (cell.display) return cell.display;
|
||||
return cell.value === undefined ? "" : String(cell.value);
|
||||
}
|
||||
|
||||
function presentationToText(
|
||||
slides: Extract<OdfDocument, { format: "odp" }>["slides"],
|
||||
): string {
|
||||
return slides
|
||||
.map((slide, index) => {
|
||||
const content = slide.shapes
|
||||
.flatMap((shape) => shapeText(shape))
|
||||
.filter(Boolean);
|
||||
const notes = blocksToText(slide.notes).trim();
|
||||
return [
|
||||
`Slide ${index + 1}: ${slide.name}`,
|
||||
...content,
|
||||
...(notes ? ["Speaker notes:", notes] : []),
|
||||
].join("\n");
|
||||
})
|
||||
.join("\n\n");
|
||||
}
|
||||
|
||||
function shapeText(shape: OdfPresentationShape): string[] {
|
||||
const content = blocksToText(shape.blocks).trim();
|
||||
const table = shape.table ? blocksToText([shape.table]).trim() : "";
|
||||
return [
|
||||
content,
|
||||
table,
|
||||
...shape.children.flatMap((child) => shapeText(child)),
|
||||
].filter(Boolean);
|
||||
}
|
||||
|
||||
function blocksToText(blocks: readonly OdfTextBlock[], depth = 0): string {
|
||||
if (depth > 128)
|
||||
throw new Error("Document nesting exceeds the export limit.");
|
||||
return blocks
|
||||
.map((block) => {
|
||||
if (block.kind === "paragraph" || block.kind === "heading")
|
||||
return block.text;
|
||||
if (block.kind === "image")
|
||||
return `[Image: ${block.alt ?? block.title ?? block.path}]`;
|
||||
if (block.kind === "list")
|
||||
return block.items
|
||||
.map(
|
||||
(item) =>
|
||||
`${" ".repeat(depth)}- ${blocksToText(item.blocks, depth + 1).trim()}`,
|
||||
)
|
||||
.join("\n");
|
||||
return block.rows
|
||||
.flatMap((row) =>
|
||||
Array.from({ length: row.rowRepeat }, () =>
|
||||
row.cells
|
||||
.flatMap((cell) =>
|
||||
Array.from({ length: cell.columnRepeat }, () =>
|
||||
cell.covered
|
||||
? ""
|
||||
: blocksToText(cell.blocks, depth + 1).replaceAll(
|
||||
"\n",
|
||||
" ",
|
||||
),
|
||||
),
|
||||
)
|
||||
.join("\t"),
|
||||
),
|
||||
)
|
||||
.join("\n");
|
||||
})
|
||||
.filter(Boolean)
|
||||
.join("\n");
|
||||
}
|
||||
|
||||
function withoutExtension(name: string): string {
|
||||
return name.replace(/\.[^.]+$/u, "");
|
||||
}
|
||||
|
||||
function safePart(value: string): string {
|
||||
return (
|
||||
value
|
||||
.trim()
|
||||
.replace(/[^\p{L}\p{N}._-]+/gu, "-")
|
||||
.slice(0, 80) || "sheet"
|
||||
);
|
||||
}
|
||||
+152
-20
@@ -2,36 +2,97 @@ export const MAX_SOURCE_BYTES = 100 * 1024 * 1024;
|
||||
|
||||
export const OFFICE_ACCEPT = [
|
||||
".docx",
|
||||
".docm",
|
||||
".dotx",
|
||||
".dotm",
|
||||
".odt",
|
||||
".xlsx",
|
||||
".xlsm",
|
||||
".xltx",
|
||||
".xltm",
|
||||
".ods",
|
||||
".pptx",
|
||||
".pptm",
|
||||
".potx",
|
||||
".potm",
|
||||
".ppsx",
|
||||
".ppsm",
|
||||
".odp",
|
||||
// Accepted by the picker so users get a precise compatibility diagnostic.
|
||||
".doc",
|
||||
".xls",
|
||||
".ppt",
|
||||
".rtf",
|
||||
].join(",");
|
||||
|
||||
export type OfficeFormat = "docx" | "odt" | "xlsx" | "ods" | "pptx" | "odp";
|
||||
export type OfficeFamily = "document" | "spreadsheet" | "presentation";
|
||||
|
||||
const FORMAT_BY_EXTENSION: Record<string, OfficeFormat> = {
|
||||
docx: "docx",
|
||||
odt: "odt",
|
||||
xlsx: "xlsx",
|
||||
ods: "ods",
|
||||
pptx: "pptx",
|
||||
odp: "odp",
|
||||
};
|
||||
const FORMAT_BY_EXTENSION: Readonly<Record<string, OfficeFormat>> =
|
||||
Object.freeze({
|
||||
docx: "docx",
|
||||
docm: "docx",
|
||||
dotx: "docx",
|
||||
dotm: "docx",
|
||||
odt: "odt",
|
||||
xlsx: "xlsx",
|
||||
xlsm: "xlsx",
|
||||
xltx: "xlsx",
|
||||
xltm: "xlsx",
|
||||
ods: "ods",
|
||||
pptx: "pptx",
|
||||
pptm: "pptx",
|
||||
potx: "pptx",
|
||||
potm: "pptx",
|
||||
ppsx: "pptx",
|
||||
ppsm: "pptx",
|
||||
odp: "odp",
|
||||
});
|
||||
|
||||
const LEGACY_EXTENSIONS = new Set(["doc", "dot", "xls", "xlt", "ppt", "pps"]);
|
||||
const LEGACY_EXTENSIONS = new Set([
|
||||
"doc",
|
||||
"dot",
|
||||
"wps",
|
||||
"xls",
|
||||
"xlt",
|
||||
"xla",
|
||||
"ppt",
|
||||
"pps",
|
||||
"pot",
|
||||
"rtf",
|
||||
"sxw",
|
||||
"sxc",
|
||||
"sxi",
|
||||
]);
|
||||
|
||||
const FLAT_ODF_EXTENSIONS = new Set(["fodt", "fods", "fodp"]);
|
||||
|
||||
const VARIANT_NOTICE: Readonly<Record<string, string>> = Object.freeze({
|
||||
docm: "VBA content is kept inert; the document view uses the OOXML content only.",
|
||||
dotm: "VBA content is kept inert; the template is opened as a read-only document.",
|
||||
dotx: "This OOXML template is opened as a read-only document.",
|
||||
xlsm: "VBA content is kept inert; cached workbook content is shown without recalculation.",
|
||||
xltm: "VBA content is kept inert; the template is opened as a read-only workbook.",
|
||||
xltx: "This OOXML template is opened as a read-only workbook.",
|
||||
pptm: "VBA content is kept inert; media and active content remain disabled.",
|
||||
potm: "VBA content is kept inert; the template is opened as a read-only presentation.",
|
||||
potx: "This OOXML template is opened as a read-only presentation.",
|
||||
ppsm: "VBA content is kept inert; the slide show is opened as a read-only presentation.",
|
||||
ppsx: "This OOXML slide show is opened as a read-only presentation.",
|
||||
});
|
||||
|
||||
export type OfficeFileErrorCode =
|
||||
| "empty-file"
|
||||
| "file-too-large"
|
||||
| "legacy-format"
|
||||
| "flat-odf"
|
||||
| "invalid-container"
|
||||
| "unsupported-format";
|
||||
|
||||
export class OfficeFileError extends Error {
|
||||
readonly code:
|
||||
"empty-file" | "file-too-large" | "legacy-format" | "unsupported-format";
|
||||
readonly code: OfficeFileErrorCode;
|
||||
|
||||
constructor(
|
||||
message: string,
|
||||
code:
|
||||
"empty-file" | "file-too-large" | "legacy-format" | "unsupported-format",
|
||||
) {
|
||||
constructor(message: string, code: OfficeFileErrorCode) {
|
||||
super(message);
|
||||
this.name = "OfficeFileError";
|
||||
this.code = code;
|
||||
@@ -51,29 +112,100 @@ export function detectOfficeFormat(
|
||||
}
|
||||
if (file.size > MAX_SOURCE_BYTES) {
|
||||
throw new OfficeFileError(
|
||||
`This first viewer slice accepts files up to ${formatBytes(MAX_SOURCE_BYTES)}.`,
|
||||
`This viewer accepts files up to ${formatBytes(MAX_SOURCE_BYTES)}.`,
|
||||
"file-too-large",
|
||||
);
|
||||
}
|
||||
|
||||
const extension = extensionOf(file.name);
|
||||
if (LEGACY_EXTENSIONS.has(extension)) {
|
||||
throw new OfficeFileError(legacyMessage(extension), "legacy-format");
|
||||
}
|
||||
if (FLAT_ODF_EXTENSIONS.has(extension)) {
|
||||
throw new OfficeFileError(
|
||||
`.${extension} is a legacy binary Office format. Convert it to a modern OOXML or OpenDocument file before opening it here.`,
|
||||
"legacy-format",
|
||||
`.${extension} is a flat XML OpenDocument file. This package reader currently supports zipped ODT, ODS and ODP; save it in the corresponding packaged format first.`,
|
||||
"flat-odf",
|
||||
);
|
||||
}
|
||||
|
||||
const format = FORMAT_BY_EXTENSION[extension];
|
||||
if (!format) {
|
||||
throw new OfficeFileError(
|
||||
"Choose a DOCX, ODT, XLSX, ODS, PPTX, or ODP file.",
|
||||
"Choose a supported OOXML or OpenDocument package. Legacy DOC/XLS/PPT/RTF and flat OpenDocument XML are diagnosed but not rendered.",
|
||||
"unsupported-format",
|
||||
);
|
||||
}
|
||||
return format;
|
||||
}
|
||||
|
||||
export interface OfficeFileInspection {
|
||||
format: OfficeFormat;
|
||||
extension: string;
|
||||
notice?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Perform a small bounded content sniff before a package parser receives the
|
||||
* file. It catches renamed OLE/RTF files and ordinary non-package data while
|
||||
* reading no more than eight bytes.
|
||||
*/
|
||||
export async function inspectOfficeFile(
|
||||
file: File,
|
||||
): Promise<OfficeFileInspection> {
|
||||
const format = detectOfficeFormat(file),
|
||||
extension = extensionOf(file.name),
|
||||
prefix = new Uint8Array(await file.slice(0, 8).arrayBuffer());
|
||||
validateOfficePackagePrefix(prefix, extension);
|
||||
return { format, extension, notice: VARIANT_NOTICE[extension] };
|
||||
}
|
||||
|
||||
export function validateOfficePackagePrefix(
|
||||
prefix: Uint8Array,
|
||||
extension: string,
|
||||
): void {
|
||||
if (hasPrefix(prefix, [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1])) {
|
||||
throw new OfficeFileError(
|
||||
`The bytes use the legacy OLE Compound File container, even though the name ends in .${extension}. Binary DOC, XLS and PPT parsing is not available; convert the original file to OOXML or OpenDocument first.`,
|
||||
"legacy-format",
|
||||
);
|
||||
}
|
||||
const ascii = new TextDecoder("ascii").decode(prefix).toLowerCase();
|
||||
if (ascii.startsWith("{\\rtf")) {
|
||||
throw new OfficeFileError(
|
||||
"The bytes are Rich Text Format (RTF). RTF is identified explicitly but is not yet rendered; save or convert it as DOCX or ODT first.",
|
||||
"legacy-format",
|
||||
);
|
||||
}
|
||||
if (!isZipPrefix(prefix)) {
|
||||
throw new OfficeFileError(
|
||||
`.${extension} must be a ZIP-based office package, but its file signature is different. The file may be renamed, truncated or use a legacy format.`,
|
||||
"invalid-container",
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
function isZipPrefix(bytes: Uint8Array): boolean {
|
||||
return (
|
||||
bytes[0] === 0x50 &&
|
||||
bytes[1] === 0x4b &&
|
||||
((bytes[2] === 0x03 && bytes[3] === 0x04) ||
|
||||
(bytes[2] === 0x05 && bytes[3] === 0x06) ||
|
||||
(bytes[2] === 0x07 && bytes[3] === 0x08))
|
||||
);
|
||||
}
|
||||
|
||||
function hasPrefix(bytes: Uint8Array, signature: readonly number[]): boolean {
|
||||
return signature.every((value, index) => bytes[index] === value);
|
||||
}
|
||||
|
||||
function legacyMessage(extension: string): string {
|
||||
if (extension === "rtf")
|
||||
return "RTF is a legacy text interchange format, not an OOXML package. Save or convert it as DOCX or ODT first.";
|
||||
if (["sxw", "sxc", "sxi"].includes(extension))
|
||||
return `.${extension} is an older OpenOffice XML package. Save it as ODT, ODS or ODP before opening it here.`;
|
||||
return `.${extension} uses a legacy compound-binary Office format. Its macros and embedded objects require a distinct bounded parser; convert it to a modern OOXML or OpenDocument file first.`;
|
||||
}
|
||||
|
||||
export function familyForFormat(format: OfficeFormat): OfficeFamily {
|
||||
if (format === "docx" || format === "odt") return "document";
|
||||
if (format === "xlsx" || format === "ods") return "spreadsheet";
|
||||
|
||||
@@ -60,6 +60,8 @@ export function parsePreparedOdp(
|
||||
styles: prepared.styles,
|
||||
assets: prepared.context.assets,
|
||||
warnings: prepared.context.warnings,
|
||||
pageWidth: prepared.pageWidth,
|
||||
pageHeight: prepared.pageHeight,
|
||||
slides,
|
||||
};
|
||||
}
|
||||
|
||||
@@ -3,6 +3,7 @@ import { parseParagraph, parseTextBlocks } from "./text";
|
||||
import type {
|
||||
OdfParseOptions,
|
||||
OdfSpreadsheetCell,
|
||||
OdfSpreadsheetColumn,
|
||||
OdfSpreadsheetDocument,
|
||||
OdfSpreadsheetRow,
|
||||
OdfSpreadsheetSheet,
|
||||
@@ -61,6 +62,8 @@ export function parsePreparedOds(
|
||||
styles: prepared.styles,
|
||||
assets: prepared.context.assets,
|
||||
warnings: prepared.context.warnings,
|
||||
pageWidth: prepared.pageWidth,
|
||||
pageHeight: prepared.pageHeight,
|
||||
sheets,
|
||||
};
|
||||
}
|
||||
@@ -70,6 +73,34 @@ function parseSheet(
|
||||
sheetIndex: number,
|
||||
context: ReturnType<typeof prepareOdfPackage>["context"],
|
||||
): OdfSpreadsheetSheet {
|
||||
const columnElements: XmlElement[] = [];
|
||||
collectSheetColumns(table, columnElements);
|
||||
const columns: OdfSpreadsheetColumn[] = [];
|
||||
let columnIndex = 0;
|
||||
for (const column of columnElements) {
|
||||
const repeat = boundedRepeat(
|
||||
attribute(column, NS.table, "number-columns-repeated"),
|
||||
context.limits,
|
||||
"Repeated spreadsheet column count",
|
||||
);
|
||||
columns.push({
|
||||
index: columnIndex,
|
||||
repeat,
|
||||
styleName: attribute(column, NS.table, "style-name"),
|
||||
defaultCellStyleName: attribute(
|
||||
column,
|
||||
NS.table,
|
||||
"default-cell-style-name",
|
||||
),
|
||||
visibility: visibility(attribute(column, NS.table, "visibility")),
|
||||
});
|
||||
columnIndex += repeat;
|
||||
if (!Number.isSafeInteger(columnIndex))
|
||||
throw new OdfParseError(
|
||||
"limit-exceeded",
|
||||
"Expanded spreadsheet column count is too large",
|
||||
);
|
||||
}
|
||||
const rowElements: XmlElement[] = [];
|
||||
collectSheetRows(table, rowElements);
|
||||
let rows: OdfSpreadsheetRow[] = [];
|
||||
@@ -112,6 +143,11 @@ function parseSheet(
|
||||
index: rowIndex,
|
||||
rowRepeat,
|
||||
styleName: attribute(rowElement, NS.table, "style-name"),
|
||||
defaultCellStyleName: attribute(
|
||||
rowElement,
|
||||
NS.table,
|
||||
"default-cell-style-name",
|
||||
),
|
||||
cells,
|
||||
});
|
||||
rowIndex += rowRepeat;
|
||||
@@ -146,12 +182,20 @@ function parseSheet(
|
||||
name: attribute(table, NS.table, "name") ?? `Sheet ${sheetIndex + 1}`,
|
||||
styleName: attribute(table, NS.table, "style-name"),
|
||||
protected: attribute(table, NS.table, "protected") === "true",
|
||||
visibility: visibility(attribute(table, NS.table, "visibility")),
|
||||
columns,
|
||||
rows,
|
||||
expandedRowCount,
|
||||
expandedCellCount,
|
||||
};
|
||||
}
|
||||
|
||||
function visibility(
|
||||
value: string | undefined,
|
||||
): "visible" | "collapse" | "filter" {
|
||||
return value === "collapse" || value === "filter" ? value : "visible";
|
||||
}
|
||||
|
||||
function isMeaningfulCell(cell: OdfSpreadsheetCell): boolean {
|
||||
return (
|
||||
cell.kind === "covered" ||
|
||||
@@ -247,3 +291,16 @@ function collectSheetRows(parent: XmlElement, result: XmlElement[]): void {
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function collectSheetColumns(parent: XmlElement, result: XmlElement[]): void {
|
||||
for (const child of childElements(parent)) {
|
||||
if (child.namespaceURI !== NS.table) continue;
|
||||
if (child.localName === "table-column") result.push(child);
|
||||
else if (
|
||||
child.localName === "table-header-columns" ||
|
||||
child.localName === "table-column-group" ||
|
||||
child.localName === "table-columns"
|
||||
)
|
||||
collectSheetColumns(child, result);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
import { prepareOdfPackage, type PreparedOdfPackage } from "./package";
|
||||
import { collectNotes, parseTextBlocks } from "./text";
|
||||
import { collectAnnotations, collectNotes, parseTextBlocks } from "./text";
|
||||
import type { OdfParseOptions, OdfTextDocument } from "./types";
|
||||
import { OdfParseError } from "./types";
|
||||
import { NS, firstChildNamed } from "./xml";
|
||||
@@ -44,7 +44,10 @@ export function parsePreparedOdt(
|
||||
styles: prepared.styles,
|
||||
assets: prepared.context.assets,
|
||||
warnings: prepared.context.warnings,
|
||||
pageWidth: prepared.pageWidth,
|
||||
pageHeight: prepared.pageHeight,
|
||||
blocks,
|
||||
notes: collectNotes(blocks),
|
||||
annotations: collectAnnotations(blocks),
|
||||
};
|
||||
}
|
||||
|
||||
@@ -2,6 +2,7 @@ import { OdfReadContext } from "./context";
|
||||
import { resolveLimits } from "./limits";
|
||||
import type {
|
||||
OdfFormat,
|
||||
OdfLength,
|
||||
OdfMetadata,
|
||||
OdfParseOptions,
|
||||
OdfStyle,
|
||||
@@ -13,6 +14,7 @@ import {
|
||||
childElements,
|
||||
descendantsNamed,
|
||||
parseXmlPart,
|
||||
parseLength,
|
||||
type XmlDocument,
|
||||
type XmlElement,
|
||||
} from "./xml";
|
||||
@@ -32,6 +34,8 @@ export interface PreparedOdfPackage {
|
||||
context: OdfReadContext;
|
||||
metadata: OdfMetadata;
|
||||
styles: OdfStyle[];
|
||||
pageWidth?: OdfLength;
|
||||
pageHeight?: OdfLength;
|
||||
}
|
||||
|
||||
export function prepareOdfPackage(
|
||||
@@ -88,6 +92,24 @@ export function prepareOdfPackage(
|
||||
`${omittedObjects} embedded ${omittedObjects === 1 ? "object was" : "objects were"} kept inert and omitted`,
|
||||
);
|
||||
}
|
||||
const trackedChanges = descendantsNamed(
|
||||
content.documentElement!,
|
||||
NS.text,
|
||||
"tracked-changes",
|
||||
).length;
|
||||
if (trackedChanges > 0)
|
||||
context.warnings.push(
|
||||
"Tracked-change metadata is kept inert; the semantic view shows the stored document text without an accept/reject workflow",
|
||||
);
|
||||
const forms = descendantsNamed(
|
||||
content.documentElement!,
|
||||
NS.office,
|
||||
"forms",
|
||||
).length;
|
||||
if (forms > 0)
|
||||
context.warnings.push(
|
||||
"Interactive form controls are kept inert and omitted from the semantic view",
|
||||
);
|
||||
const metaBytes = archive.entries.get("meta.xml");
|
||||
const metadata = metaBytes
|
||||
? parseMetadata(parseXmlPart(metaBytes, "meta.xml", limits), context)
|
||||
@@ -97,7 +119,8 @@ export function prepareOdfPackage(
|
||||
if (stylesBytes)
|
||||
styleDocuments.unshift(parseXmlPart(stylesBytes, "styles.xml", limits));
|
||||
const styles = parseStyles(styleDocuments);
|
||||
return { format, mediaType, content, context, metadata, styles };
|
||||
const pageSize = parsePageSize(styleDocuments);
|
||||
return { format, mediaType, content, context, metadata, styles, ...pageSize };
|
||||
}
|
||||
|
||||
function requireEntry(
|
||||
@@ -241,6 +264,21 @@ function parseMetadata(
|
||||
function parseStyles(documents: readonly XmlDocument[]): OdfStyle[] {
|
||||
const styles = new Map<string, OdfStyle>();
|
||||
for (const document of documents) {
|
||||
for (const element of descendantsNamed(
|
||||
document.documentElement!,
|
||||
NS.style,
|
||||
"default-style",
|
||||
)) {
|
||||
const family = attribute(element, NS.style, "family");
|
||||
if (!family) continue;
|
||||
const style: OdfStyle = {
|
||||
name: `__default__:${family}`,
|
||||
isDefault: true,
|
||||
family,
|
||||
properties: readStyleProperties(element),
|
||||
};
|
||||
styles.set(`${family}\0${style.name}`, style);
|
||||
}
|
||||
for (const element of descendantsNamed(
|
||||
document.documentElement!,
|
||||
NS.style,
|
||||
@@ -265,6 +303,24 @@ function parseStyles(documents: readonly XmlDocument[]): OdfStyle[] {
|
||||
return [...styles.values()];
|
||||
}
|
||||
|
||||
function parsePageSize(documents: readonly XmlDocument[]): {
|
||||
pageWidth?: OdfLength;
|
||||
pageHeight?: OdfLength;
|
||||
} {
|
||||
for (const document of documents) {
|
||||
const properties = descendantsNamed(
|
||||
document.documentElement!,
|
||||
NS.style,
|
||||
"page-layout-properties",
|
||||
)[0];
|
||||
if (!properties) continue;
|
||||
const pageWidth = parseLength(attribute(properties, NS.fo, "page-width"));
|
||||
const pageHeight = parseLength(attribute(properties, NS.fo, "page-height"));
|
||||
if (pageWidth || pageHeight) return { pageWidth, pageHeight };
|
||||
}
|
||||
return {};
|
||||
}
|
||||
|
||||
function readStyleProperties(style: XmlElement): Record<string, string> {
|
||||
const properties: Record<string, string> = {};
|
||||
for (const child of childElements(style)) {
|
||||
|
||||
+62
-1
@@ -2,6 +2,7 @@ import { normalizeResourcePath, OdfReadContext } from "./context";
|
||||
import type {
|
||||
OdfHeading,
|
||||
OdfImage,
|
||||
OdfAnnotation,
|
||||
OdfList,
|
||||
OdfNote,
|
||||
OdfParagraph,
|
||||
@@ -29,6 +30,7 @@ interface InlineResult {
|
||||
runs: OdfTextRun[];
|
||||
images: OdfImage[];
|
||||
notes: OdfNote[];
|
||||
annotations: OdfAnnotation[];
|
||||
}
|
||||
|
||||
export function parseTextBlocks(
|
||||
@@ -110,7 +112,12 @@ function parseInline(
|
||||
inheritedStyle?: string,
|
||||
inheritedLink?: string,
|
||||
): InlineResult {
|
||||
const result: InlineResult = { runs: [], images: [], notes: [] };
|
||||
const result: InlineResult = {
|
||||
runs: [],
|
||||
images: [],
|
||||
notes: [],
|
||||
annotations: [],
|
||||
};
|
||||
const append = (
|
||||
text: string,
|
||||
styleName = inheritedStyle,
|
||||
@@ -162,6 +169,13 @@ function parseInline(
|
||||
if (note.citation) append(note.citation);
|
||||
continue;
|
||||
}
|
||||
if (
|
||||
element.namespaceURI === NS.office &&
|
||||
element.localName === "annotation"
|
||||
) {
|
||||
result.annotations.push(parseAnnotation(element, context));
|
||||
continue;
|
||||
}
|
||||
if (element.namespaceURI === NS.draw && element.localName === "frame") {
|
||||
const image = parseFrameImage(element, context);
|
||||
if (image) result.images.push(image);
|
||||
@@ -190,10 +204,35 @@ function parseInline(
|
||||
}
|
||||
result.images.push(...nested.images);
|
||||
result.notes.push(...nested.notes);
|
||||
result.annotations.push(...nested.annotations);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
function parseAnnotation(
|
||||
element: XmlElement,
|
||||
context: OdfReadContext,
|
||||
): OdfAnnotation {
|
||||
const creator = firstChildNamed(
|
||||
element,
|
||||
NS.dc,
|
||||
"creator",
|
||||
)?.textContent?.trim();
|
||||
const createdAt = firstChildNamed(
|
||||
element,
|
||||
NS.dc,
|
||||
"date",
|
||||
)?.textContent?.trim();
|
||||
if (creator) context.consumeText(creator);
|
||||
if (createdAt) context.consumeText(createdAt);
|
||||
return {
|
||||
id: attribute(element, NS.office, "name"),
|
||||
creator: creator || undefined,
|
||||
createdAt: createdAt || undefined,
|
||||
blocks: parseTextBlocks(element, context),
|
||||
};
|
||||
}
|
||||
|
||||
function safeHyperlink(href: string | undefined): string | undefined {
|
||||
if (!href) return undefined;
|
||||
const value = href.trim();
|
||||
@@ -370,3 +409,25 @@ export function collectNotes(blocks: readonly OdfTextBlock[]): OdfNote[] {
|
||||
for (const block of blocks) visit(block);
|
||||
return result;
|
||||
}
|
||||
|
||||
export function collectAnnotations(
|
||||
blocks: readonly OdfTextBlock[],
|
||||
): OdfAnnotation[] {
|
||||
const result: OdfAnnotation[] = [];
|
||||
const visit = (block: OdfTextBlock) => {
|
||||
if (block.kind === "paragraph" || block.kind === "heading") {
|
||||
result.push(...block.annotations);
|
||||
for (const annotation of block.annotations)
|
||||
for (const child of annotation.blocks) visit(child);
|
||||
} else if (block.kind === "list") {
|
||||
for (const item of block.items)
|
||||
for (const child of item.blocks) visit(child);
|
||||
} else if (block.kind === "table") {
|
||||
for (const row of block.rows)
|
||||
for (const cell of row.cells)
|
||||
for (const child of cell.blocks) visit(child);
|
||||
}
|
||||
};
|
||||
for (const block of blocks) visit(block);
|
||||
return result;
|
||||
}
|
||||
|
||||
@@ -59,6 +59,7 @@ export interface OdfMetadata {
|
||||
|
||||
export interface OdfStyle {
|
||||
name: string;
|
||||
isDefault?: boolean;
|
||||
family?: string;
|
||||
displayName?: string;
|
||||
parentName?: string;
|
||||
@@ -102,6 +103,13 @@ export interface OdfTextRun {
|
||||
link?: string;
|
||||
}
|
||||
|
||||
export interface OdfAnnotation {
|
||||
id?: string;
|
||||
creator?: string;
|
||||
createdAt?: string;
|
||||
blocks: OdfTextBlock[];
|
||||
}
|
||||
|
||||
export interface OdfParagraph {
|
||||
kind: "paragraph";
|
||||
styleName?: string;
|
||||
@@ -109,6 +117,7 @@ export interface OdfParagraph {
|
||||
runs: OdfTextRun[];
|
||||
images: OdfImage[];
|
||||
notes: OdfNote[];
|
||||
annotations: OdfAnnotation[];
|
||||
}
|
||||
|
||||
export interface OdfHeading {
|
||||
@@ -119,6 +128,7 @@ export interface OdfHeading {
|
||||
runs: OdfTextRun[];
|
||||
images: OdfImage[];
|
||||
notes: OdfNote[];
|
||||
annotations: OdfAnnotation[];
|
||||
}
|
||||
|
||||
export interface OdfNote {
|
||||
@@ -182,13 +192,24 @@ export interface OdfSpreadsheetRow {
|
||||
index: number;
|
||||
rowRepeat: number;
|
||||
styleName?: string;
|
||||
defaultCellStyleName?: string;
|
||||
cells: OdfSpreadsheetCell[];
|
||||
}
|
||||
|
||||
export interface OdfSpreadsheetColumn {
|
||||
index: number;
|
||||
repeat: number;
|
||||
styleName?: string;
|
||||
defaultCellStyleName?: string;
|
||||
visibility: "visible" | "collapse" | "filter";
|
||||
}
|
||||
|
||||
export interface OdfSpreadsheetSheet {
|
||||
name: string;
|
||||
styleName?: string;
|
||||
protected: boolean;
|
||||
visibility: "visible" | "collapse" | "filter";
|
||||
columns: OdfSpreadsheetColumn[];
|
||||
rows: OdfSpreadsheetRow[];
|
||||
expandedRowCount: number;
|
||||
expandedCellCount: number;
|
||||
@@ -239,12 +260,15 @@ interface OdfBaseModel {
|
||||
styles: OdfStyle[];
|
||||
assets: OdfAsset[];
|
||||
warnings: string[];
|
||||
pageWidth?: OdfLength;
|
||||
pageHeight?: OdfLength;
|
||||
}
|
||||
|
||||
export interface OdfTextDocument extends OdfBaseModel {
|
||||
format: "odt";
|
||||
blocks: OdfTextBlock[];
|
||||
notes: OdfNote[];
|
||||
annotations: OdfAnnotation[];
|
||||
}
|
||||
|
||||
export interface OdfSpreadsheetDocument extends OdfBaseModel {
|
||||
|
||||
@@ -23,6 +23,7 @@ export const NS = Object.freeze({
|
||||
meta: "urn:oasis:names:tc:opendocument:xmlns:meta:1.0",
|
||||
manifest: "urn:oasis:names:tc:opendocument:xmlns:manifest:1.0",
|
||||
svg: "urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0",
|
||||
form: "urn:oasis:names:tc:opendocument:xmlns:form:1.0",
|
||||
} as const);
|
||||
|
||||
const XML_DECLARATION_ATTACK = /<!\s*(?:DOCTYPE|ENTITY)|<\?xml-stylesheet/iu;
|
||||
|
||||
@@ -649,6 +649,24 @@ input:focus-visible {
|
||||
font-size: 0.86rem;
|
||||
}
|
||||
|
||||
.office-inline-notice {
|
||||
padding: 0.65rem 0.8rem;
|
||||
border: 1px solid
|
||||
color-mix(in srgb, var(--toolbox-accent) 52%, var(--toolbox-border));
|
||||
border-radius: var(--toolbox-radius);
|
||||
background: color-mix(
|
||||
in srgb,
|
||||
var(--toolbox-accent-soft) 64%,
|
||||
var(--toolbox-surface)
|
||||
);
|
||||
color: var(--toolbox-text);
|
||||
font-size: 0.84rem;
|
||||
}
|
||||
|
||||
.office-export-actions {
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.office-password {
|
||||
display: grid;
|
||||
gap: 0.45rem;
|
||||
@@ -856,6 +874,20 @@ input:focus-visible {
|
||||
font-weight: 750;
|
||||
}
|
||||
|
||||
.odf-comment-marker {
|
||||
margin-inline-start: 0.25rem;
|
||||
color: var(--toolbox-accent);
|
||||
font-size: 0.72em;
|
||||
cursor: help;
|
||||
}
|
||||
|
||||
.odf-comment-byline {
|
||||
margin: 0 0 0.35rem;
|
||||
color: var(--toolbox-muted);
|
||||
font-size: 0.78rem;
|
||||
font-weight: 700;
|
||||
}
|
||||
|
||||
.odf-workbook {
|
||||
min-width: max-content;
|
||||
min-height: 100%;
|
||||
@@ -923,6 +955,14 @@ input:focus-visible {
|
||||
line-height: 1.35;
|
||||
}
|
||||
|
||||
.odf-sheet-grid col {
|
||||
width: 7.5rem;
|
||||
}
|
||||
|
||||
.odf-sheet-grid .odf-row-number-column {
|
||||
width: 3.5rem;
|
||||
}
|
||||
|
||||
.odf-sheet-grid thead th,
|
||||
.odf-sheet-grid tbody > tr > th {
|
||||
position: sticky;
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
"schemaVersion": 1,
|
||||
"id": "de.add-ideas.office-tools",
|
||||
"name": "Office Tools",
|
||||
"version": "0.1.0",
|
||||
"version": "0.2.0",
|
||||
"description": "Open and inspect documents, spreadsheets and presentations locally in the browser.",
|
||||
"entry": "./",
|
||||
"icon": "./favicon.svg",
|
||||
@@ -32,9 +32,59 @@
|
||||
"crossOriginIsolated": false,
|
||||
"topLevelContext": false
|
||||
},
|
||||
"io": {
|
||||
"accepts": [
|
||||
{
|
||||
"mediaType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
|
||||
"extensions": [".docx", ".dotx", ".docm", ".dotm"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
|
||||
"extensions": [".xlsx", ".xltx", ".xlsm", ".xltm"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
|
||||
"extensions": [".pptx", ".potx", ".ppsx", ".pptm", ".potm", ".ppsm"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.oasis.opendocument.text",
|
||||
"extensions": [".odt", ".ott"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.oasis.opendocument.spreadsheet",
|
||||
"extensions": [".ods", ".ots"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/vnd.oasis.opendocument.presentation",
|
||||
"extensions": [".odp", ".otp"]
|
||||
}
|
||||
],
|
||||
"produces": [
|
||||
{
|
||||
"mediaType": "application/vnd.oasis.opendocument.text",
|
||||
"extensions": [".odt"]
|
||||
},
|
||||
{
|
||||
"mediaType": "text/csv",
|
||||
"extensions": [".csv"]
|
||||
},
|
||||
{
|
||||
"mediaType": "text/plain",
|
||||
"extensions": [".txt"]
|
||||
},
|
||||
{
|
||||
"mediaType": "application/json",
|
||||
"extensions": [".json"]
|
||||
}
|
||||
]
|
||||
},
|
||||
"capabilities": {
|
||||
"required": ["workers"],
|
||||
"optional": []
|
||||
},
|
||||
"privacy": {
|
||||
"processing": "local",
|
||||
"fileUploads": false,
|
||||
"fileUploads": true,
|
||||
"telemetry": false,
|
||||
"label": "Office files stay in this browser; nothing is uploaded."
|
||||
},
|
||||
|
||||
+1
-1
@@ -1 +1 @@
|
||||
export const APP_VERSION = "0.1.0";
|
||||
export const APP_VERSION = "0.2.0";
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
import { expect, test, type Page } from "@playwright/test";
|
||||
import { expect, test, type Download, type Page } from "@playwright/test";
|
||||
import {
|
||||
createMinimalOdp,
|
||||
createMinimalOds,
|
||||
@@ -25,9 +25,31 @@ async function find(page: Page, value: string) {
|
||||
await expect(search.getByText("1 of 1", { exact: true })).toBeVisible();
|
||||
}
|
||||
|
||||
async function downloadedBytes(download: Download): Promise<Uint8Array> {
|
||||
const stream = await download.createReadStream();
|
||||
const chunks: Uint8Array[] = [];
|
||||
let total = 0;
|
||||
for await (const chunk of stream) {
|
||||
const bytes =
|
||||
typeof chunk === "string"
|
||||
? new TextEncoder().encode(chunk)
|
||||
: new Uint8Array(chunk as ArrayBufferLike);
|
||||
chunks.push(bytes);
|
||||
total += bytes.byteLength;
|
||||
}
|
||||
const result = new Uint8Array(total);
|
||||
let offset = 0;
|
||||
for (const chunk of chunks) {
|
||||
result.set(chunk, offset);
|
||||
offset += chunk.byteLength;
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
test("renders and searches a project-authored ODT in an isolated worker", async ({
|
||||
page,
|
||||
}) => {
|
||||
const fixture = createMinimalOdt();
|
||||
const externalHosts = new Set<string>();
|
||||
const errors: string[] = [];
|
||||
const workerScripts: URL[] = [];
|
||||
@@ -45,7 +67,7 @@ test("renders and searches a project-authored ODT in an isolated worker", async
|
||||
});
|
||||
page.on("pageerror", (error) => errors.push(error.message));
|
||||
|
||||
await openFixture(page, createMinimalOdt());
|
||||
await openFixture(page, fixture);
|
||||
await expect(
|
||||
page.getByRole("heading", { name: "OpenDocument Text Fixture" }),
|
||||
).toBeVisible();
|
||||
@@ -59,6 +81,11 @@ test("renders and searches a project-authored ODT in an isolated worker", async
|
||||
await page.getByRole("button", { name: "Zoom in" }).click();
|
||||
await expect(page.getByText("110%", { exact: true })).toBeVisible();
|
||||
|
||||
const exactCopy = page.waitForEvent("download");
|
||||
await page.getByRole("button", { name: "Save exact copy" }).click();
|
||||
const exactBytes = await downloadedBytes(await exactCopy);
|
||||
expect([...exactBytes]).toEqual([...fixture.buffer]);
|
||||
|
||||
expect(externalHosts).toEqual(new Set());
|
||||
expect(errors).toEqual([]);
|
||||
expect(workerScripts.length).toBeGreaterThan(0);
|
||||
@@ -81,6 +108,12 @@ test("renders, searches and switches sheets in a project-authored ODS", async ({
|
||||
await page.getByRole("button", { name: "Next sheet" }).click();
|
||||
await expect(page.getByText("sheet 2 of 2", { exact: true })).toBeVisible();
|
||||
await expect(page.getByRole("grid")).toContainText("Second sheet content");
|
||||
const csvDownload = page.waitForEvent("download");
|
||||
await page.getByRole("button", { name: "Export sheet CSV" }).click();
|
||||
const csv = new TextDecoder().decode(
|
||||
await downloadedBytes(await csvDownload),
|
||||
);
|
||||
expect(csv).toContain("Second sheet content");
|
||||
});
|
||||
|
||||
test("renders, searches and navigates a project-authored ODP", async ({
|
||||
|
||||
@@ -24,10 +24,10 @@ test("publishes valid relocatable metadata", async ({ request }) => {
|
||||
await expect(manifestResponse.json()).resolves.toMatchObject({
|
||||
schemaVersion: 1,
|
||||
id: "de.add-ideas.office-tools",
|
||||
version: "0.1.0",
|
||||
version: "0.2.0",
|
||||
entry: "./",
|
||||
icon: "./favicon.svg",
|
||||
privacy: { processing: "local", fileUploads: false, telemetry: false },
|
||||
privacy: { processing: "local", fileUploads: true, telemetry: false },
|
||||
});
|
||||
|
||||
const webManifest = await request.get(`${entry}manifest.webmanifest`);
|
||||
|
||||
@@ -139,8 +139,9 @@ test("fails closed with an inline error for a malformed OOXML package", async ({
|
||||
const alert = page.getByRole("alert");
|
||||
await expect(alert).toBeVisible({ timeout: 90_000 });
|
||||
await expect(alert).not.toBeEmpty();
|
||||
await expect(page.locator(".file-heading")).toHaveCount(0);
|
||||
await expect(
|
||||
page.locator(".file-heading__state .state-dot--error"),
|
||||
page.getByRole("heading", { name: "Choose or drop a file" }),
|
||||
).toBeVisible();
|
||||
});
|
||||
|
||||
|
||||
@@ -0,0 +1,18 @@
|
||||
import { expect, test } from "@playwright/test";
|
||||
|
||||
test("keeps the primary workspace inside a narrow viewport", async ({
|
||||
page,
|
||||
}) => {
|
||||
await page.goto("/deep/nested/office/");
|
||||
await expect(page.locator("main").first()).toBeVisible();
|
||||
await expect(
|
||||
page.locator("main .loading, main .workbench-loading"),
|
||||
).toHaveCount(0);
|
||||
|
||||
const widths = await page.evaluate(() => ({
|
||||
content: document.documentElement.scrollWidth,
|
||||
viewport: document.documentElement.clientWidth,
|
||||
}));
|
||||
expect(widths.viewport).toBeLessThanOrEqual(430);
|
||||
expect(widths.content).toBeLessThanOrEqual(widths.viewport + 1);
|
||||
});
|
||||
@@ -0,0 +1,36 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import {
|
||||
createStyleResolver,
|
||||
safeOdfTransform,
|
||||
} from "../../src/components/odf-viewer-model";
|
||||
|
||||
describe("OpenDocument fidelity adapters", () => {
|
||||
it("inherits default and named styles without exposing raw CSS", () => {
|
||||
const resolve = createStyleResolver([
|
||||
{
|
||||
name: "__default__:paragraph",
|
||||
isDefault: true,
|
||||
family: "paragraph",
|
||||
properties: { "paragraph-properties.fo:color": "#123456" },
|
||||
},
|
||||
{
|
||||
name: "Body",
|
||||
family: "paragraph",
|
||||
properties: { "paragraph-properties.fo:text-align": "justify" },
|
||||
},
|
||||
]);
|
||||
expect(resolve(undefined, "paragraph")).toMatchObject({ color: "#123456" });
|
||||
expect(resolve("Body", "paragraph")).toMatchObject({
|
||||
color: "#123456",
|
||||
textAlign: "justify",
|
||||
});
|
||||
});
|
||||
|
||||
it("converts only a bounded inert drawing-transform subset", () => {
|
||||
expect(safeOdfTransform("translate(2cm 3cm) rotate(0.5) scale(2)")).toBe(
|
||||
"translate(2cm, 3cm) rotate(0.5rad) scale(2)",
|
||||
);
|
||||
expect(safeOdfTransform("url(https://example.test)")).toBeUndefined();
|
||||
expect(safeOdfTransform("matrix(1 0 0 1 2 3)")).toBeUndefined();
|
||||
});
|
||||
});
|
||||
@@ -23,15 +23,33 @@ describe("UploadWorkbench", () => {
|
||||
const user = userEvent.setup();
|
||||
render(<UploadWorkbench />);
|
||||
const input = screen.getByLabelText("Open office file");
|
||||
const file = new File(["local fixture"], "report.docx", {
|
||||
const bytes = new Uint8Array(13);
|
||||
bytes.set([0x50, 0x4b, 0x03, 0x04]);
|
||||
const file = new File([bytes], "report.docx", {
|
||||
type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
|
||||
});
|
||||
|
||||
await user.upload(input, file);
|
||||
|
||||
const heading = screen.getByRole("region", { name: "report.docx" });
|
||||
const heading = await screen.findByRole("region", { name: "report.docx" });
|
||||
expect(heading).toHaveTextContent("report.docx");
|
||||
expect(heading).toHaveTextContent("13 B");
|
||||
expect(screen.getByLabelText("Test OOXML viewer")).toBeInTheDocument();
|
||||
expect(
|
||||
screen.getByRole("button", { name: "Save exact copy" }),
|
||||
).toBeVisible();
|
||||
});
|
||||
|
||||
it("explains a renamed legacy compound-binary file", async () => {
|
||||
const user = userEvent.setup();
|
||||
render(<UploadWorkbench />);
|
||||
const file = new File(
|
||||
[Uint8Array.from([0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1])],
|
||||
"renamed.docx",
|
||||
);
|
||||
await user.upload(screen.getByLabelText("Open office file"), file);
|
||||
expect(await screen.findByRole("alert")).toHaveTextContent(
|
||||
"legacy OLE Compound File",
|
||||
);
|
||||
});
|
||||
});
|
||||
|
||||
@@ -0,0 +1,37 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { sheetToCsv } from "../../src/office/export";
|
||||
import { parseOds } from "../../src/office/odf";
|
||||
import { makeOdf, odsContent } from "./odf/fixtures";
|
||||
|
||||
describe("bounded OpenDocument exports", () => {
|
||||
it("exports cached sheet displays with repeats and CSV quoting", () => {
|
||||
const document = parseOds(
|
||||
makeOdf(
|
||||
"ods",
|
||||
odsContent(`<table:table table:name="Data">
|
||||
<table:table-row table:number-rows-repeated="2">
|
||||
<table:table-cell office:value-type="string"><text:p>A, B</text:p></table:table-cell>
|
||||
<table:table-cell table:number-columns-repeated="2" office:value-type="float" office:value="42"><text:p>42</text:p></table:table-cell>
|
||||
</table:table-row>
|
||||
</table:table>`),
|
||||
),
|
||||
);
|
||||
expect(sheetToCsv(document.sheets[0]!)).toBe(
|
||||
'"A, B",42,42\r\n"A, B",42,42',
|
||||
);
|
||||
});
|
||||
|
||||
it("refuses unbounded expanded CSV rows", () => {
|
||||
const document = parseOds(
|
||||
makeOdf(
|
||||
"ods",
|
||||
odsContent(`<table:table table:name="Large">
|
||||
<table:table-row table:number-rows-repeated="50001">
|
||||
<table:table-cell office:value-type="string"><text:p>x</text:p></table:table-cell>
|
||||
</table:table-row>
|
||||
</table:table>`),
|
||||
),
|
||||
);
|
||||
expect(() => sheetToCsv(document.sheets[0]!)).toThrow(/50,000 rows/u);
|
||||
});
|
||||
});
|
||||
@@ -7,11 +7,15 @@ import {
|
||||
familyForFormat,
|
||||
formatBytes,
|
||||
formatLabel,
|
||||
validateOfficePackagePrefix,
|
||||
} from "../../src/office/formats";
|
||||
|
||||
describe("office format handling", () => {
|
||||
it.each([
|
||||
["REPORT.DOCX", "docx"],
|
||||
["REPORT.DOCM", "docx"],
|
||||
["template.xltx", "xlsx"],
|
||||
["show.ppsm", "pptx"],
|
||||
["notes.odt", "odt"],
|
||||
["budget.xlsx", "xlsx"],
|
||||
["budget.ODS", "ods"],
|
||||
@@ -21,6 +25,24 @@ describe("office format handling", () => {
|
||||
expect(detectOfficeFormat({ name, size: 42 })).toBe(expected);
|
||||
});
|
||||
|
||||
it("rejects renamed compound-binary, RTF and non-package signatures", () => {
|
||||
expect(() =>
|
||||
validateOfficePackagePrefix(
|
||||
Uint8Array.from([0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1]),
|
||||
"docx",
|
||||
),
|
||||
).toThrow(/OLE Compound File/u);
|
||||
expect(() =>
|
||||
validateOfficePackagePrefix(new TextEncoder().encode("{\\rtf1"), "docx"),
|
||||
).toThrow(/Rich Text Format/u);
|
||||
expect(() =>
|
||||
validateOfficePackagePrefix(new TextEncoder().encode("not zip!"), "xlsx"),
|
||||
).toThrow(/ZIP-based/u);
|
||||
expect(() =>
|
||||
validateOfficePackagePrefix(Uint8Array.from([0x50, 0x4b, 3, 4]), "pptx"),
|
||||
).not.toThrow();
|
||||
});
|
||||
|
||||
it("rejects empty, oversized, unsupported and legacy inputs explicitly", () => {
|
||||
const cases = [
|
||||
[{ name: "empty.docx", size: 0 }, "empty-file"],
|
||||
|
||||
@@ -254,4 +254,54 @@ describe("OpenDocument normalized models", () => {
|
||||
expect(document.format).toBe("odt");
|
||||
expect(document.warnings).toContain("Package has no META-INF/manifest.xml");
|
||||
});
|
||||
|
||||
it("retains page geometry, default styles, comments and spreadsheet column metadata", () => {
|
||||
const styles = `<?xml version="1.0"?><office:document-styles ${XMLNS}>
|
||||
<office:styles><style:default-style style:family="paragraph"><style:text-properties fo:color="#123456"/></style:default-style></office:styles>
|
||||
<office:automatic-styles><style:page-layout style:name="pm1"><style:page-layout-properties fo:page-width="21cm" fo:page-height="29.7cm"/></style:page-layout></office:automatic-styles>
|
||||
</office:document-styles>`;
|
||||
const odt = parseOdt(
|
||||
makeOdf(
|
||||
"odt",
|
||||
odtContent(
|
||||
`<text:p>Reviewed<office:annotation office:name="c1"><dc:creator>Ada</dc:creator><dc:date>2026-09-01</dc:date><text:p>Looks good</text:p></office:annotation></text:p>`,
|
||||
),
|
||||
{ styles },
|
||||
),
|
||||
);
|
||||
expect(odt.pageWidth).toMatchObject({ value: 21, unit: "cm" });
|
||||
expect(odt.styles).toEqual(
|
||||
expect.arrayContaining([
|
||||
expect.objectContaining({ isDefault: true, family: "paragraph" }),
|
||||
]),
|
||||
);
|
||||
expect(odt.annotations[0]).toMatchObject({
|
||||
id: "c1",
|
||||
creator: "Ada",
|
||||
createdAt: "2026-09-01",
|
||||
blocks: [expect.objectContaining({ text: "Looks good" })],
|
||||
});
|
||||
|
||||
const ods = parseOds(
|
||||
makeOdf(
|
||||
"ods",
|
||||
odsContent(`<table:table table:name="Columns" table:visibility="collapse">
|
||||
<table:table-column table:number-columns-repeated="3" table:style-name="Wide" table:default-cell-style-name="Money"/>
|
||||
<table:table-row table:default-cell-style-name="RowDefault"><table:table-cell office:value-type="string"><text:p>x</text:p></table:table-cell></table:table-row>
|
||||
</table:table>`),
|
||||
),
|
||||
);
|
||||
expect(ods.sheets[0]).toMatchObject({
|
||||
visibility: "collapse",
|
||||
columns: [
|
||||
{
|
||||
index: 0,
|
||||
repeat: 3,
|
||||
styleName: "Wide",
|
||||
defaultCellStyleName: "Money",
|
||||
},
|
||||
],
|
||||
rows: [expect.objectContaining({ defaultCellStyleName: "RowDefault" })],
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
@@ -13,7 +13,7 @@ describe("Toolbox manifest", () => {
|
||||
});
|
||||
expect(manifest.privacy).toMatchObject({
|
||||
processing: "local",
|
||||
fileUploads: false,
|
||||
fileUploads: true,
|
||||
telemetry: false,
|
||||
});
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user