@design.estate/dees-document 5.4.0 → 5.6.0

package/dist_ts_shared/appearance.js

@@ -1,8 +1,21 @@
 import * as plugins from "./plugins.js";
 /** A colour written as `#` and three or six hex digits. */
 const HEX_COLOR_PATTERN = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
-/** The relative luminance of a hex colour (WCAG 2.x), from 0 (black) to 1 (white). */
-const relativeLuminanceOf = (hexArg) => {
+/** Whether a value is a hex colour: `#` and three or six hex digits, in either case (`#abc`, `#0A5C8F`). */
+export const isHexColor = (valueArg) => HEX_COLOR_PATTERN.test(valueArg);
+/** Refuses a value that is no hex colour, naming the function that was asked. */
+const requireHexColor = (functionArg, valueArg) => {
+    if (!isHexColor(valueArg)) {
+        throw new Error(`${functionArg}: "${valueArg}" is no hex colour`);
+    }
+};
+/**
+ * The relative luminance of a hex colour (WCAG 2.x), from 0 (black) to 1
+ * (white); `#RGB` is read as `#RRGGBB`. A value that is no hex colour is
+ * refused.
+ */
+export const relativeLuminanceOf = (hexArg) => {
+    requireHexColor("relativeLuminanceOf", hexArg);
     const digits = hexArg.length === 4 ? hexArg.slice(1).replace(/./g, "$&$&") : hexArg.slice(1);
     const channel = (offsetArg) => {
         const value = Number.parseInt(digits.slice(offsetArg, offsetArg + 2), 16) / 255;
@@ -10,17 +23,20 @@ const relativeLuminanceOf = (hexArg) => {
     };
     return 0.2126 * channel(0) + 0.7152 * channel(2) + 0.0722 * channel(4);
 };
-/** The WCAG contrast of two luminances, from 1 to 21. */
-const contrastOf = (leftArg, rightArg) => (Math.max(leftArg, rightArg) + 0.05) / (Math.min(leftArg, rightArg) + 0.05);
+/** The WCAG contrast of two relative luminances, from 1 (the same) to 21 (black on white), in either order. */
+export const contrastOf = (leftArg, rightArg) => (Math.max(leftArg, rightArg) + 0.05) / (Math.min(leftArg, rightArg) + 0.05);
+/** The WCAG contrast of a hex colour against white, from 1 (white) to 21 (black). A value that is no hex colour is refused. */
+export const contrastOnWhiteOf = (hexArg) => {
+    requireHexColor("contrastOnWhiteOf", hexArg);
+    return contrastOf(relativeLuminanceOf(hexArg), 1);
+};
 /**
  * The text colour that reads better on an accent: the document's dark grey
  * (`#333333`) or white, whichever has the higher WCAG contrast against it. A
  * light accent (a yellow, a pastel) gets dark text, a strong or dark one white.
  */
 export const accentForegroundOf = (hexArg) => {
-    if (!HEX_COLOR_PATTERN.test(hexArg)) {
-        throw new Error(`accentForegroundOf: "${hexArg}" is no hex colour`);
-    }
+    requireHexColor("accentForegroundOf", hexArg);
     const accent = relativeLuminanceOf(hexArg);
     return contrastOf(accent, relativeLuminanceOf("#333333")) > contrastOf(accent, 1) ? "#333333" : "#ffffff";
 };
@@ -39,15 +55,15 @@ export const accentForegroundOf = (hexArg) => {
  */
 export const resolvedAccentOf = (themeArg, letterArg) => {
     const stated = letterArg?.appearance?.accentColor;
-    if (stated !== undefined && !HEX_COLOR_PATTERN.test(stated)) {
+    if (stated !== undefined && !isHexColor(stated)) {
         throw new Error(`appearance.accentColor: "${stated}" is no hex colour (#RGB or #RRGGBB); the document is not printed.`);
     }
     const background = themeArg?.colorAccentBackground ?? stated;
     const foreground = themeArg?.colorAccentForeground
-        ?? (background !== undefined && HEX_COLOR_PATTERN.test(background) ? accentForegroundOf(background) : undefined);
+        ?? (background !== undefined && isHexColor(background) ? accentForegroundOf(background) : undefined);
     return {
         ...(background !== undefined ? { background } : {}),
         ...(foreground !== undefined ? { foreground } : {}),
     };
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwZWFyYW5jZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX3NoYXJlZC9hcHBlYXJhbmNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBR3hDLDJEQUEyRDtBQUMzRCxNQUFNLGlCQUFpQixHQUFHLHNDQUFzQyxDQUFDO0FBS2pFLHNGQUFzRjtBQUN0RixNQUFNLG1CQUFtQixHQUFHLENBQUMsTUFBYyxFQUFVLEVBQUU7SUFDckQsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLE1BQU0sS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUM3RixNQUFNLE9BQU8sR0FBRyxDQUFDLFNBQWlCLEVBQVUsRUFBRTtRQUM1QyxNQUFNLEtBQUssR0FBRyxNQUFNLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsU0FBUyxFQUFFLFNBQVMsR0FBRyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsR0FBRyxHQUFHLENBQUM7UUFDaEYsT0FBTyxLQUFLLElBQUksT0FBTyxDQUFDLENBQUMsQ0FBQyxLQUFLLEdBQUcsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsS0FBSyxHQUFHLEtBQUssQ0FBQyxHQUFHLEtBQUssQ0FBQyxJQUFJLEdBQUcsQ0FBQztJQUM3RSxDQUFDLENBQUM7SUFDRixPQUFPLE1BQU0sR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLEdBQUcsTUFBTSxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsR0FBRyxNQUFNLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDO0FBQ3pFLENBQUMsQ0FBQztBQUVGLHlEQUF5RDtBQUN6RCxNQUFNLFVBQVUsR0FBRyxDQUFDLE9BQWUsRUFBRSxRQUFnQixFQUFVLEVBQUUsQ0FDL0QsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxRQUFRLENBQUMsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLFFBQVEsQ0FBQyxHQUFHLElBQUksQ0FBQyxDQUFDO0FBRTlFOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxDQUFDLE1BQWMsRUFBcUIsRUFBRTtJQUN0RSxJQUFJLENBQUMsaUJBQWlCLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7UUFDcEMsTUFBTSxJQUFJLEtBQUssQ0FBQyx3QkFBd0IsTUFBTSxvQkFBb0IsQ0FBQyxDQUFDO0lBQ3RFLENBQUM7SUFDRCxNQUFNLE1BQU0sR0FBRyxtQkFBbUIsQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUMzQyxPQUFPLFVBQVUsQ0FBQyxNQUFNLEVBQUUsbUJBQW1CLENBQUMsU0FBUyxDQUFDLENBQUMsR0FBRyxVQUFVLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztBQUM1RyxDQUFDLENBQUM7QUFRRjs7Ozs7Ozs7Ozs7O0dBWUc7QUFDSCxNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxDQUM5QixRQUFvQyxFQUNwQyxTQUE4RCxFQUM3QyxFQUFFO0lBQ25CLE1BQU0sTUFBTSxHQUFHLFNBQVMsRUFBRSxVQUFVLEVBQUUsV0FBVyxDQUFDO0lBQ2xELElBQUksTUFBTSxLQUFLLFNBQVMsSUFBSSxDQUFDLGlCQUFpQixDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1FBQzVELE1BQU0sSUFBSSxLQUFLLENBQUMsNEJBQTRCLE1BQU0sb0VBQW9FLENBQUMsQ0FBQztJQUMxSCxDQUFDO0lBQ0QsTUFBTSxVQUFVLEdBQUcsUUFBUSxFQUFFLHFCQUFxQixJQUFJLE1BQU0sQ0FBQztJQUM3RCxNQUFNLFVBQVUsR0FBRyxRQUFRLEVBQUUscUJBQXFCO1dBQzdDLENBQUMsVUFBVSxLQUFLLFNBQVMsSUFBSSxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxDQUFDLGtCQUFrQixDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQztJQUNuSCxPQUFPO1FBQ0wsR0FBRyxDQUFDLFVBQVUsS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLEVBQUUsVUFBVSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUNuRCxHQUFHLENBQUMsVUFBVSxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsRUFBRSxVQUFVLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO0tBQ3BELENBQUM7QUFDSixDQUFDLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwZWFyYW5jZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX3NoYXJlZC9hcHBlYXJhbmNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBR3hDLDJEQUEyRDtBQUMzRCxNQUFNLGlCQUFpQixHQUFHLHNDQUFzQyxDQUFDO0FBRWpFLDRHQUE0RztBQUM1RyxNQUFNLENBQUMsTUFBTSxVQUFVLEdBQUcsQ0FBQyxRQUFnQixFQUFXLEVBQUUsQ0FBQyxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLENBQUM7QUFFMUYsaUZBQWlGO0FBQ2pGLE1BQU0sZUFBZSxHQUFHLENBQUMsV0FBbUIsRUFBRSxRQUFnQixFQUFRLEVBQUU7SUFDdEUsSUFBSSxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO1FBQzFCLE1BQU0sSUFBSSxLQUFLLENBQUMsR0FBRyxXQUFXLE1BQU0sUUFBUSxvQkFBb0IsQ0FBQyxDQUFDO0lBQ3BFLENBQUM7QUFDSCxDQUFDLENBQUM7QUFLRjs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQUcsQ0FBQyxNQUFjLEVBQVUsRUFBRTtJQUM1RCxlQUFlLENBQUMscUJBQXFCLEVBQUUsTUFBTSxDQUFDLENBQUM7SUFDL0MsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLE1BQU0sS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUM3RixNQUFNLE9BQU8sR0FBRyxDQUFDLFNBQWlCLEVBQVUsRUFBRTtRQUM1QyxNQUFNLEtBQUssR0FBRyxNQUFNLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsU0FBUyxF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

package/dist_ts_web/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@design.estate/dees-document',
-    version: '5.4.0',
+    version: '5.6.0',
     description: 'A sophisticated framework for dynamically generating and rendering business documents like invoices with modern web technologies, featuring PDF creation, templating, and automation.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfd2ViLzAwX2NvbW1pdGluZm9fZGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4QixJQUFJLEVBQUUsOEJBQThCO0lBQ3BDLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSx1TEFBdUw7Q0FDck0sQ0FBQSJ9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design.estate/dees-document",
-  "version": "5.4.0",
+  "version": "5.6.0",
   "private": false,
   "description": "A sophisticated framework for dynamically generating and rendering business documents like invoices with modern web technologies, featuring PDF creation, templating, and automation.",
   "main": "dist_ts_web/index.js",
@@ -15,7 +15,6 @@
   "author": "Lossless GmbH",
   "license": "MIT",
   "dependencies": {
-    "@design.estate/dees-catalog": "^9.7.0 || ^10.0.0 || ^11.0.0 || ^12.0.0 || ^13.0.0 || ^14.0.0 || ^15.0.0 || ^16.0.0",
     "@design.estate/dees-domtools": "^3.0.0",
     "@design.estate/dees-element": "^3.2.0",
     "@fin.cx/calculation": "^1.4.0",
@@ -29,14 +28,18 @@
     "@types/qrcode": "^1.5.6",
     "qrcode": "^1.5.4"
   },
+  "peerDependencies": {
+    "@design.estate/dees-catalog": "^9.7.0 || ^10.0.0 || ^11.0.0 || ^12.0.0 || ^13.0.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+  },
   "devDependencies": {
+    "@design.estate/dees-catalog": "^19.4.0",
     "@design.estate/dees-wcctools": "^3.9.4",
-    "@git.zone/tsbuild": "^5.0.0",
-    "@git.zone/tsbundle": "^3.1.0",
+    "@git.zone/tsbuild": "^5.1.2",
+    "@git.zone/tsbundle": "^3.1.3",
     "@git.zone/tsrun": "^3.0.2",
-    "@git.zone/tstest": "^6.3.2",
-    "@git.zone/tswatch": "^4.0.2",
-    "@types/node": "^26.6.2"
+    "@git.zone/tstest": "^7.0.0",
+    "@git.zone/tswatch": "^6.0.0",
+    "@types/node": "^26.6.3"
   },
   "files": [
     "ts/**/*",

package/readme.md

@@ -9,9 +9,11 @@ For reporting bugs, issues, or security vulnerabilities, please visit [community
 ## Installation
 
 ```shell
-pnpm install @design.estate/dees-document
+pnpm install @design.estate/dees-document @design.estate/dees-catalog
 ```
 
+`@design.estate/dees-catalog` is a peer dependency (9.7 to 19.x): the web components (`@design.estate/dees-document/web`) render the catalog's `dees-icon` and use the catalog copy your application installs. Custom elements are registered globally, so an application must hold one catalog copy, and a component library that brought its own would register each catalog element a second time. pnpm and npm 7+ install a missing peer automatically; Yarn reports it as missing, so list it yourself. The server side (`@design.estate/dees-document`, `/node`) and `/shared` do not load the catalog at runtime: `PdfService` renders with the bundle built into the package.
+
 ## Features
 
 - 📄 **PDF Generation** - Server-side PDF creation from structured data through smartpdf (system Chrome or Chromium)
@@ -179,6 +181,15 @@ const documentSettings = {
 
 The accent colour draws the rule above the footer and the page number's tab. It is the theme's `colorAccentBackground`, else the letter's own `appearance.accentColor` (the issuer's branding, `#RGB` or `#RRGGBB`; anything else is refused and nothing is printed), else the default red. The page number is written in the theme's `colorAccentForeground`, else in dark grey (`#333333`) or white, whichever has the higher WCAG contrast on the accent (`accentForegroundOf`, `resolvedAccentOf` in the shared module). The letter's `appearance.logoUrl` is printed in the head.
 
+The checks the accent is drawn with are on `@design.estate/dees-document/shared` too, for an application that states or checks an accent colour itself: `isHexColor(value)` (`#RGB` or `#RRGGBB`, either case), `relativeLuminanceOf(hex)` (WCAG 2.x, 0 to 1), `contrastOf(left, right)` (the WCAG contrast of two luminances, 1 to 21) and `contrastOnWhiteOf(hex)`. The ones that take a colour refuse a value that is no hex colour.
+
+```typescript
+import { contrastOnWhiteOf, isHexColor } from '@design.estate/dees-document/shared';
+
+isHexColor('#FFD700'); // true
+contrastOnWhiteOf('#FFD700'); // 1.40…: too light for a line on white by WCAG 1.4.11 (3:1)
+```
+
 ### Web Component Usage
 
 For browser-based document viewing:

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@design.estate/dees-document',
-  version: '5.4.0',
+  version: '5.6.0',
   description: 'A sophisticated framework for dynamically generating and rendering business documents like invoices with modern web technologies, featuring PDF creation, templating, and automation.'
 }

package/ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@design.estate/dees-document',
-  version: '5.4.0',
+  version: '5.6.0',
   description: 'A sophisticated framework for dynamically generating and rendering business documents like invoices with modern web technologies, featuring PDF creation, templating, and automation.'
 }