@openpresentation/opf-render 0.12.0 → 0.12.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -4
- package/package.json +10 -5
package/README.md
CHANGED
|
@@ -10,7 +10,7 @@ Version 0.8.1 required core 0.10.1, including metric, quote and timeline layout
|
|
|
10
10
|
|
|
11
11
|
Unfinished prepared shaping work is preserved in the [September 15 roadmap](docs/roadmap-shaping-20260915.md); it is not part of the published runtime.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
This checkout supports Node 22 or later (`engines.node` `>=22`; CI tests Node 22, 24 and 26). Versions 0.8.0 to 0.12.0 declared `24.x`, so npm on Node 22 or 26 silently installed an older release instead (RR-20); upgrade past 0.12.0. Use `.nvmrc` (Node 24) for local development. Earlier published versions retain their original engine declarations. Browser entrypoints remain browser-safe; native application compatibility is verified separately.
|
|
14
14
|
|
|
15
15
|
Version 0.8.0 adds optional font-registry vector outlines and shared heading/scalar/rich line placement. Pass identical `textMeasurement` and `textRasterPadding` options to preview, pagination and export; padding defaults to one scaled reference pixel. SVG consumes accepted origins without remeasuring. See the [source contract and limits](https://github.com/OpenPresentation/opf/blob/f94125a1ff95bf0974a055fe1c081d348dad54f2/docs/plans/text-placement.md). Native raster certification remains separate.
|
|
16
16
|
|
|
@@ -404,7 +404,7 @@ npm run golden:update
|
|
|
404
404
|
|
|
405
405
|
Public npm package publication is handled by `.github/workflows/npm-publish.yml` through npm Trusted Publishing (GitHub Actions OIDC) with npm provenance; no npm token is stored. The owner authorized agents to prepare and publish npm releases whenever a release is required (2026-09-29). This authorization does not waive any gate.
|
|
406
406
|
|
|
407
|
-
1. Open a release-prep PR containing only the version bump, `CHANGELOG.md
|
|
407
|
+
1. Open a release-prep PR containing only the version bump, `CHANGELOG.md` (assembled from `changes/` with `node scripts/changelog-fragments.mjs assemble --version X.Y.Z`), dependency ranges, lockfile and current-instruction docs. Publish in dependency order (core, then renderer and PPTX, then editor): refresh this repo's lockfile only after the required `@openpresentation/opf` version is on the registry (`npm install --package-lock-only`), then run `npm run test:packed` against it.
|
|
408
408
|
2. Merge after CI is green, then publish by pushing the git tag `opf-render-v<version>` (or `@openpresentation/opf-render@v<version>`) at the merge commit. The workflow verifies that the tag matches `package.json` and reruns audit, typecheck, validate, tests, packed and browser checks before `npm publish --access public --provenance`. A manual `workflow_dispatch` runs the same job without the tag check and is a fallback only.
|
|
409
409
|
3. Verify with `npm view @openpresentation/opf-render@<version> version gitHead dist.attestations` and, from the core repo, `node scripts/test-renderer-publication.mjs <version> <release-commit> <this-checkout>`. Never republish an existing version.
|
|
410
410
|
|
|
@@ -418,7 +418,7 @@ Version 0.2.x requires the published `@openpresentation/opf@^0.4.1` for composit
|
|
|
418
418
|
|
|
419
419
|
For actual font measurement, load `loadBundledFontRegistry()` from `@openpresentation/opf-render/fonts-node`, then pass its `textMeasurement` to rendering and its `embeddedFonts` to SVG export. Pass its `fontFiles` to PNG/PDF conversion. The browser-safe `@openpresentation/opf-render/fonts` entry accepts local font bytes. Missing fonts/glyphs fail explicitly; aliases and fallback are opt-in and recorded in `registry.substitutions`. Bundled font license notices travel with embedded SVG fonts.
|
|
420
420
|
|
|
421
|
-
Raster updates produce an HTML gallery and `artifacts/golden/candidate.json`; they never overwrite the approved baseline automatically. See [baseline review and known limitations](test/golden/README.md).
|
|
421
|
+
Raster updates produce an HTML gallery and `artifacts/golden/candidate.json`; they never overwrite the approved baseline automatically (baselines are directories with one file per deck; `npm run golden:promote` writes only the decks that moved). See [baseline review and known limitations](test/golden/README.md).
|
|
422
422
|
|
|
423
423
|
Version 0.1.1 adds rich-text line offsets and measured boxes to opt-in SVG tracing, including blank lines, for editor caret placement. Normal SVG/PNG output is unchanged.
|
|
424
424
|
|
|
@@ -426,7 +426,7 @@ Version 0.1.1 adds rich-text line offsets and measured boxes to opt-in SVG traci
|
|
|
426
426
|
|
|
427
427
|
PNG and PDF conversion now decode embedded WebP image data URIs to static PNG before rasterization. This preserves fit/crop, transparency, EXIF orientation and the first animation frame. The source SVG and OPF document remain unchanged; browser SVG output keeps the original embedded image. Both href and legacy xlink:href are supported, including base64 and percent-encoded data. This step does not resolve local filenames, download remote images or change the existing host imageResolver contract.
|
|
428
428
|
|
|
429
|
-
The Node-only raster path lazily loads pinned Sharp 0.35.4, requiring Node
|
|
429
|
+
The Node-only raster path lazily loads pinned Sharp 0.35.4, requiring Node 22 or later for this package and normal installation of its optional platform binaries. Browser exports do not include the decoder. Malformed embedded WebP produces image-conversion-failed with its data-opf-path when present, otherwise svg.images.N. Decoding has a 40-megapixel limit. PNG/PDF are static outputs; animation beyond the first frame and original image metadata are not retained.
|
|
430
430
|
|
|
431
431
|
Regression checks compare six fixtures against independent Pillow pixels, verify fit/crop, inspect actual PDF image streams and transparency masks, and exercise input encodings and diagnostics. All 805 existing raster baselines remain unchanged. Test fixtures are project-authored and MIT licensed; the decoder and its bundled codecs retain their upstream licenses.
|
|
432
432
|
|
package/package.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@openpresentation/opf-render",
|
|
3
|
-
"version": "0.12.
|
|
3
|
+
"version": "0.12.2",
|
|
4
4
|
"description": "Deterministic local OPF renderer for SVG, PNG, and PDF output.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"private": false,
|
|
8
8
|
"engines": {
|
|
9
|
-
"node": "
|
|
9
|
+
"node": ">=22"
|
|
10
10
|
},
|
|
11
11
|
"repository": {
|
|
12
12
|
"type": "git",
|
|
@@ -82,15 +82,19 @@
|
|
|
82
82
|
],
|
|
83
83
|
"scripts": {
|
|
84
84
|
"build": "node scripts/build.mjs",
|
|
85
|
-
"typecheck": "node
|
|
85
|
+
"typecheck": "node scripts/check-syntax.mjs src test scripts",
|
|
86
86
|
"validate": "node scripts/validate-package.mjs",
|
|
87
|
-
"test": "npm run build && npm run check:fonts && node
|
|
87
|
+
"test": "npm run build && npm run check:fonts && node scripts/run-tests.mjs && npm run build:browser-check && npm run check:runners && npm run check:changes",
|
|
88
|
+
"test:contract": "npm run build && npm run check:fonts && node scripts/run-tests.mjs --suite contract && npm run build:browser-check",
|
|
89
|
+
"check:runners": "node --test scripts/run-tests.test.mjs",
|
|
90
|
+
"check:changes": "node --test scripts/changelog-fragments.test.mjs && node scripts/changelog-fragments.mjs check",
|
|
88
91
|
"check:fonts": "node test/font-licenses.mjs && npm run check:font-hotlinks",
|
|
89
92
|
"check:font-hotlinks": "node --test scripts/check-font-hotlinks.test.mjs && node scripts/check-font-hotlinks.mjs",
|
|
90
93
|
"test:golden": "npm run build && node test/golden.mjs",
|
|
91
94
|
"test:packed": "node test/packed-install.mjs",
|
|
92
95
|
"test:browser": "npm run build:browser-check && node test/browser-check.mjs && node test/rich-tab-browser.mjs && node test/rich-tab-estimated-browser.mjs",
|
|
93
96
|
"golden:update": "npm run build && node test/golden.mjs --update",
|
|
97
|
+
"golden:promote": "node scripts/golden-promote.mjs",
|
|
94
98
|
"prepack": "npm run build",
|
|
95
99
|
"build:browser-check": "node scripts/build-browser-check.mjs",
|
|
96
100
|
"test:styled-table": "node test/styled-table.mjs",
|
|
@@ -110,6 +114,7 @@
|
|
|
110
114
|
"test:lazy-face-fallback-browser": "node test/lazy-face-fallback-browser.mjs artifacts/lazy-face-fallback",
|
|
111
115
|
"test:lazy-fonts-browser": "node test/lazy-fonts-browser.mjs artifacts/lazy-fonts",
|
|
112
116
|
"test:latin-family-hosts-browser": "node test/latin-family-hosts-browser.mjs artifacts/latin-family-hosts",
|
|
117
|
+
"test:script-family-hosts-browser": "node test/script-family-hosts-browser.mjs artifacts/script-family-hosts",
|
|
113
118
|
"test:extra-lazy-fonts-browser": "node test/extra-lazy-fonts-browser.mjs artifacts/extra-lazy-fonts",
|
|
114
119
|
"test:script-fonts-browser": "node test/script-fonts-browser.mjs artifacts/script-fonts-browser.json",
|
|
115
120
|
"test:script-corpora-browser": "node test/script-corpora-browser.mjs artifacts/script-corpora-browser.json && node test/script-corpora-slides-browser.mjs artifacts/script-corpora-slides-browser.json",
|
|
@@ -133,7 +138,7 @@
|
|
|
133
138
|
"@expo-google-fonts/roboto": "0.4.3",
|
|
134
139
|
"@expo-google-fonts/roboto-mono": "0.4.2",
|
|
135
140
|
"@expo-google-fonts/tinos": "0.4.2",
|
|
136
|
-
"@openpresentation/opf": "^0.12.
|
|
141
|
+
"@openpresentation/opf": "^0.12.2",
|
|
137
142
|
"@resvg/resvg-js": "^2.6.2",
|
|
138
143
|
"bidi-js": "1.1.0",
|
|
139
144
|
"fontkit": "^2.0.4",
|