@napi-rs/canvas 1.1.0 → 1.1.1

package/README.md

@@ -35,6 +35,10 @@ All Apple M chips on **macOS**.
 
 Since Skia relies on the [glibc](https://www.gnu.org/software/libc/) 2.18 API, you need to have at least glibc version >= 2.18 on your system.
 
+Note: the armv7 (`linux-arm-gnueabihf`) packages from 0.1.66 to 1.1.0 need
+a newer glibc (0.1.66 needs 2.28, 1.1.0 needs 2.30). Later versions need
+glibc 2.18, like the other targets.
+
 ## AWS Lambda usage
 
 To use this library on Lambda you will need to use a Lambda layer.
@@ -121,26 +125,43 @@ WebP, AVIF and GIF output ignore these options. `toDataURL`, `toDataURLAsync`, `
 
 ## Text rendering
 
-By default text looks the same on every OS. Every font is drawn with FreeType, with Skia's default text gamma, no LCD (subpixel) text and one font family table (the one Linux uses). The same font files give the same pixels and the same `measureText` results on macOS, Linux and Windows.
+By default text is drawn the same way on every OS. Every font is drawn with FreeType, with Skia's default text gamma, no LCD (subpixel) text and one font family table (the one Linux uses).
+
+Text gives the same pixels and the same `measureText` results on macOS, Linux and Windows when all of these are true:
+
+1. `ctx.font` names only fonts you registered. The canvas default `10px sans-serif`, the other generic families and names like `Arial` use installed fonts, unless you registered a font under that name.
+2. Your registered fonts have every character you draw. A character they lack is taken from an installed font.
+3. You set `ctx.lang`, for example to `'en'`. The default `'inherit'` follows the host language.
+4. You use the default `'portable'` renderer, not `setTextRenderer('system')`.
+5. The `FREETYPE_PROPERTIES` env var is not set.
 
-To get the same output everywhere, register your own font files under names no OS installs, and draw only with those names:
+x64 and arm64 builds can still differ by 1 color level on some edge pixels.
 
 ```js
 const { GlobalFonts } = require('@napi-rs/canvas')
 
+// A name no OS installs
 GlobalFonts.registerFromPath('./fonts/Lato-Regular.ttf', 'MyLato')
 ctx.font = '20px MyLato'
+ctx.lang = 'en'
+```
+
+A name registered over an installed family (for example `Helvetica`) works like a CSS `@font-face` in Chrome: only font lists that name it use it, for every style (bold and italic are made from the faces you registered when you registered no bold or italic face). The generic families, such as `sans-serif`, keep the installed family. To change a generic family, register the font under the keyword itself:
+
+```js
+GlobalFonts.registerFromPath('./fonts/Lato-Regular.ttf', 'sans-serif')
 ```
 
 These still depend on the OS and the machine:
 
 - Installed fonts. Names like `Arial` or `Helvetica`, and the generic families (`sans-serif`, `serif`, `monospace`, `system-ui`, the canvas default `10px sans-serif`) resolve to whatever is installed.
-- Characters your registered fonts lack. They are taken from the installed default fonts when those have them, else they draw as boxes. There is no search through all installed fonts.
+- Characters your registered fonts lack. They are taken from an installed font (the ones `loadSystemFonts` and `loadFontsFromDir` load, or the OS font folder) that has them, else they draw as boxes. A font you `register` or `registerFromPath` is never used for a character another font lacks, as in Chrome: to give a host without fonts a fallback font, load it with `loadFontsFromDir`.
 - The `ex`, `ch`, `cap` and line-height units inside SVG images use an installed default font.
 - Lottie (Skottie) text uses installed fonts.
 - PDF font embedding depends on the build target.
 - x64 and arm64 builds can differ by 1 color level on some edge pixels.
 - A `FREETYPE_PROPERTIES` env var changes FreeType's hinting.
+- The host language. The default `ctx.lang` (`'inherit'`) follows the OS UI language (the macOS language list, the Windows user locale, or `LANGUAGE` / `LC_ALL` / `LC_MESSAGES` / `LANG` elsewhere), as Chrome does. It changes `locl` glyphs, case mapping (`small-caps` under `tr`) and CJK punctuation spacing. Set `ctx.lang` (for example `'en'`) to pin it. The installed font picked for a Han character still follows the host language unless `ctx.lang` names a CJK language (for example `'ja'` or `'zh-Hans'`). On macOS with `setTextRenderer('system')`, the generic families also follow a `ja`, `ko`, `zh-CN`, `zh-TW`, `ar`, `he` or `fa` UI language whatever `ctx.lang` is, as in Chrome (`serif` is Hiragino Mincho ProN under a Japanese UI).
 
 Set `DISABLE_SYSTEM_FONTS_LOAD=1` to keep installed fonts out of `GlobalFonts.families`. By default they can still be found by name, on every OS.
 
@@ -157,7 +178,15 @@ getTextRenderer() // 'system'
 
 It applies to the whole process. Call it once at startup, before you create canvases. `setTextRenderer('portable')` switches back. Any other value throws a `TypeError`. A canvas created before the switch keeps its old text gamma until you set its width or height. A `ctx.font` value set before the switch keeps its parsed form (sizes in `ex`, `ch` and other font-relative units, and on macOS the `BlinkMacSystemFont` to `system-ui` rewrite), so set `ctx.font` again after the switch.
 
-> **Behavior change** ([#1402](https://github.com/Brooooooklyn/canvas/issues/1402)): text on macOS and Linux is drawn the way Windows draws it, so pixels and `measureText` results differ from 1.0.12 and 1.0.13. On macOS, the installed fonts are FreeType faces again (as in 1.0.11), read from `/System/Library/Fonts`, `/Library/Fonts` and `~/Library/Fonts`; CoreText's per-character fallback is off, and `sans-serif`, `serif` and `monospace` map to Arial, Times New Roman and the Linux monospace list. On macOS, `DISABLE_SYSTEM_FONTS_LOAD` no longer hides installed fonts from name lookup, as on Linux and Windows and before 1.0.12; it only keeps them out of `GlobalFonts.families`. Call `setTextRenderer('system')` to get the 1.0.12 / 1.0.13 behavior back.
+> **Behavior change** ([#1402](https://github.com/Brooooooklyn/canvas/issues/1402)): text on macOS and Linux is drawn the way Windows draws it, so pixels and `measureText` results differ from 1.0.12 and 1.0.13. On macOS, the installed fonts are FreeType faces again (as in 1.0.11), read from `/System/Library/Fonts`, `/Library/Fonts` and `~/Library/Fonts`; CoreText's per-character fallback is off, and `sans-serif`, `serif` and `monospace` map to Arial, Times New Roman and the Linux monospace list. On macOS, `DISABLE_SYSTEM_FONTS_LOAD` no longer hides installed fonts from name lookup, as on Linux and Windows and before 1.0.12; it only keeps them out of `GlobalFonts.families`. Call `setTextRenderer('system')` to draw with each OS's own font renderer and installed fonts again, as 1.0.12 and 1.0.13 did. Both renderers now shape text the way Chrome does, so the output is not the same as in 1.0.12 and 1.0.13.
+
+> **Behavior change**: a character no font of the font list has is taken from an installed font, as Chrome's font cache takes it from the platform's fonts. This applies to the portable renderer on every OS and to the system renderer off macOS (on macOS, CoreText still picks first). The font is chosen the way Chrome on Windows chooses it: a bold or italic list first tries its first family at the normal style, then the font Windows names for the character's script (on macOS, the font Chrome's CoreText fallback names for it), then the first installed family, by name, that has the character. Before, such a character drew as a box (the first font's `.notdef`). Private use characters still draw as boxes.
+
+> **Behavior change**: SVG text (SVG images, the SVG images nested in them, and `convertSVGTextToPath`) takes a character its first font lacks from the next family of its `font-family` list, then from the system's fonts, as canvas text does. Chrome does the same. Before, the whole text used the first font, and a character it lacks drew as a box. Text with no such character draws the same as before. `convertSVGTextToPath` now reads the document the way an SVG image does (`<style>` sheets, `var()`, `<use>` and the other CSS rules), so its output matches what the SVG image draws. A document that is not well-formed UTF-8 XML is read as before, with only the first family of each `font-family` list.
+
+> **Behavior change**: the default `ctx.lang`, `'inherit'`, follows the host language, as Chrome does. Before, it meant no language. Text whose font has language-specific glyphs or spacing can draw and measure differently on hosts with different UI languages; set `ctx.lang` to pin it.
+
+> **Behavior change**: SVG text whose family lacks the bold or italic face it asks for draws a synthetic bold or italic, with the rules canvas text uses: a registered font is bolded at `font-weight` 600 and up and slanted for `italic` and `oblique` unless it has that face (or a `wght` axis above 400, or a `slnt` axis); an installed font follows its own faces. Chrome does the same. The advances do not change, so the text does not move; the glyphs are heavier or slanted, and `convertSVGTextToPath` outlines grow to match. Before, SVG text drew the regular face for every style.
 
 ## Emoji text
 

package/index.d.ts

@@ -9,9 +9,17 @@ export type TextRenderer = 'portable' | 'system'
  * Selects how text is drawn.
  *
  * `'portable'` (the default) draws text the same way on every OS: FreeType,
- * Skia's default text gamma, no LCD text and one font family table. The same
- * registered fonts give the same pixels and TextMetrics on macOS, Linux and
- * Windows.
+ * Skia's default text gamma, no LCD text and one font family table. Text gives
+ * the same pixels and TextMetrics on macOS, Linux and Windows when:
+ * - `ctx.font` names only fonts you registered (the default `10px sans-serif`
+ *   and names like `Arial` use installed fonts, unless you registered a font
+ *   under that name);
+ * - your registered fonts have every character you draw (a missing character
+ *   comes from an installed font);
+ * - you set `ctx.lang` (for example `'en'`), because the default `'inherit'`
+ *   follows the host language;
+ * - `FREETYPE_PROPERTIES` is not set.
+ * x64 and arm64 builds can still differ by 1 color level on some edge pixels.
  *
  * `'system'` draws text with each OS's own font renderer, as Chrome does:
  * CoreText on macOS (Fontations for some color and variable fonts) with
@@ -738,6 +746,48 @@ export interface SKRSContext2D extends CanvasRenderingContext2D {
 
   letterSpacing: string
   wordSpacing: string
+  /**
+   * Non-standard: Chrome's CanvasRenderingContext2D has no such attribute.
+   * Behaves like the CSS `font-feature-settings` property in Chrome.
+   * Invalid values are ignored. Default `"normal"`.
+   * @experimental
+   */
+  fontFeatureSettings: string
+  /**
+   * Non-standard: Chrome's CanvasRenderingContext2D has no such attribute.
+   * Behaves like the CSS `font-variant-ligatures` property in Chrome.
+   * Invalid values are ignored. Default `"normal"`.
+   * @experimental
+   */
+  fontVariantLigatures: string
+  /**
+   * Non-standard: Chrome's CanvasRenderingContext2D has no such attribute.
+   * Behaves like the CSS `font-variant-numeric` property in Chrome.
+   * Invalid values are ignored. Default `"normal"`.
+   * @experimental
+   */
+  fontVariantNumeric: string
+  /**
+   * Non-standard: Chrome's CanvasRenderingContext2D has no such attribute.
+   * Behaves like the CSS `font-variant-position` property in Chrome.
+   * Invalid values are ignored. Default `"normal"`.
+   * @experimental
+   */
+  fontVariantPosition: 'normal' | 'sub' | 'super'
+  /**
+   * Non-standard: Chrome's CanvasRenderingContext2D has no such attribute.
+   * Behaves like the CSS `font-size-adjust` property in Chrome.
+   * Invalid values are ignored. Default `"none"`.
+   * @experimental
+   */
+  fontSizeAdjust: string
+  /**
+   * Non-standard: Chrome's CanvasRenderingContext2D has no such attribute.
+   * Behaves like the CSS `font-optical-sizing` property in Chrome.
+   * Invalid values are ignored. Default `"auto"`.
+   * @experimental
+   */
+  fontOpticalSizing: 'auto' | 'none'
 }
 
 export type ColorSpace = 'srgb' | 'display-p3'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@napi-rs/canvas",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Canvas for Node.js with skia backend",
   "main": "index.js",
   "repository": {
@@ -103,7 +103,7 @@
     "npm-run-all2": "^9.0.0",
     "oxlint": "^1.34.0",
     "oxlint-tsgolint": "^7.0.0",
-    "pdfjs-dist": "6.4.299",
+    "pdfjs-dist": "6.5.438",
     "pinst": "^3.0.0",
     "png.js": "^0.2.1",
     "prettier": "^3.7.4",
@@ -162,16 +162,16 @@
     "@napi-rs/canvas": "workspace:"
   },
   "optionalDependencies": {
-    "@napi-rs/canvas-linux-x64-gnu": "1.1.0",
-    "@napi-rs/canvas-darwin-x64": "1.1.0",
-    "@napi-rs/canvas-win32-x64-msvc": "1.1.0",
-    "@napi-rs/canvas-win32-arm64-msvc": "1.1.0",
-    "@napi-rs/canvas-linux-arm-gnueabihf": "1.1.0",
-    "@napi-rs/canvas-linux-x64-musl": "1.1.0",
-    "@napi-rs/canvas-linux-arm64-gnu": "1.1.0",
-    "@napi-rs/canvas-linux-arm64-musl": "1.1.0",
-    "@napi-rs/canvas-darwin-arm64": "1.1.0",
-    "@napi-rs/canvas-android-arm64": "1.1.0",
-    "@napi-rs/canvas-linux-riscv64-gnu": "1.1.0"
+    "@napi-rs/canvas-linux-x64-gnu": "1.1.1",
+    "@napi-rs/canvas-darwin-x64": "1.1.1",
+    "@napi-rs/canvas-win32-x64-msvc": "1.1.1",
+    "@napi-rs/canvas-win32-arm64-msvc": "1.1.1",
+    "@napi-rs/canvas-linux-arm-gnueabihf": "1.1.1",
+    "@napi-rs/canvas-linux-x64-musl": "1.1.1",
+    "@napi-rs/canvas-linux-arm64-gnu": "1.1.1",
+    "@napi-rs/canvas-linux-arm64-musl": "1.1.1",
+    "@napi-rs/canvas-darwin-arm64": "1.1.1",
+    "@napi-rs/canvas-android-arm64": "1.1.1",
+    "@napi-rs/canvas-linux-riscv64-gnu": "1.1.1"
   }
-}
+}