@munusshih/p5.export 0.1.0-beta.5 → 0.1.0-beta.7

package/README.md

@@ -9,7 +9,7 @@ Works with **p5.js 1.x and 2.x**. p5 is brought by you (CDN or bundler); this pa
 ### Drop-in `<script>`
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/p5@2/lib/p5.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/p5@latest/lib/p5.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/@munusshih/p5.export"></script>
 <script src="sketch.js"></script>
 ```
@@ -63,6 +63,7 @@ saveSVG('artwork')
 saveSVG('artwork', { forceVector: true })    // skip raster-fallback threshold
 saveSVG('artwork', { raster: true })         // embed canvas PNG inside an SVG
 saveSVG('artwork', { silent: true })         // skip the fallback confirm dialog
+saveSVG('artwork', { outlineText: false })   // keep text() as editable <text> (default is outlined)
 
 savePDF('artwork')
 savePDF('artwork', { scale: 2 })
@@ -70,6 +71,20 @@ savePDF('artwork', { scale: 2 })
 
 `saveSVG()` records every Canvas2D draw call as the sketch runs and replays them onto an SVG context. Trails, fade rects, blend modes, gradients (linear / radial — emitted as native SVG gradients), and `drawingContext.setLineDash` all survive. WebGL renderers can only be embedded as a single raster `<image>`; the function prompts before doing so unless `{ silent: true }` or `{ raster: true }` is passed.
 
+#### Text and fonts
+
+By default `text()` is exported as **vector glyph outlines**, which render identically everywhere with no fonts installed. This is the default because fonts loaded via `loadFont()` are drawn by p5 in a way `canvas2svg` can't capture as `<text>` — they'd otherwise drop out of the SVG entirely. Outlining works for fonts loaded from an uncompressed `.ttf`/`.otf` (p5 can't read glyph data from `.woff2`); system/string fonts have no outline data and fall back to `<text>`.
+
+Pass `{ outlineText: false }` to keep text as **editable `<text>`** instead (font-family reference; the font must be available wherever the SVG is opened, or it falls back).
+
+```js
+saveSVG('poster', { outlineText: false });  // per-call, keep editable <text>
+setSVGTextMode('text');                      // make editable <text> the default for this sketch
+// also: window.p5ExportConfig = { svgTextOutlines: false } before the sketch loads
+```
+
+In the export GUI, pick **SVG (vector)**; **Outline (vector)** is ticked by default — untick it for editable `<text>`. See `examples/fonts/` for a multi-typeface demo.
+
 For dense sketches whose vector replay would balloon past 2 million ops, the export falls back to raster-in-SVG and asks the user to confirm. To force vector regardless of size, pass `{ forceVector: true }`.
 
 #### Hybrid SVG
@@ -160,9 +175,27 @@ npm install
 npm run build           # writes dist/p5.export.js + dist/p5.export.min.js
 npm run dev             # vite dev server at /examples/index.html
 npm run test:sketches   # headless harness over examples/ — exports each format
+npm run test:svg-path2d # p5 2.3+ vector primitive regression
 npm run test:webp       # sanity test for the animated WebP encoder
 ```
 
+Every push to `main` finds the highest published `0.1.0-beta.N`, publishes the
+next beta number, and assigns it to npm's `latest` tag. The workflow then reads
+`@munusshih/p5.export@latest` back from npm and fails unless it matches the
+version just published. Publishing uses npm Trusted Publishing (OIDC), with no
+long-lived npm token. Configure the package's trusted publisher on npmjs.com
+with these exact values:
+
+- Provider: **GitHub Actions**
+- Organization or user: **munusshih**
+- Repository: **p5.export**
+- Workflow filename: **publish-npm.yml**
+- Environment: leave blank
+- Allowed action: **npm publish**
+
+The workflow filename is matched exactly by npm and lives at
+`.github/workflows/publish-npm.yml`.
+
 ## License
 
 [MIT](./LICENSE)