@aelionsdk/render-ir 1.2.0-rc.2 → 1.2.0-rc.4

package/README.md

@@ -9,7 +9,7 @@ evaluation for AelionSDK.
 npm install @aelionsdk/render-ir@next
 ```
 
-`next` currently resolves to `1.2.0-rc.2`. Product applications should use
+`next` currently resolves to `1.2.0-rc.4`. Product applications should use
 `@aelionsdk/sdk`; direct use is for custom renderers, exporters and engine
 instrumentation.
 

package/dist/text-layout.d.ts

@@ -38,8 +38,41 @@ export interface PortableTextStyle {
     readonly strokeWidthPx: number;
     readonly align: 'start' | 'center' | 'end';
     readonly direction: 'ltr' | 'rtl';
+    readonly backgroundFill: string;
+    readonly backgroundOpacity: number;
+    readonly backgroundPaddingPx: number;
+    readonly backgroundRadiusPx: number;
 }
 export declare function portableTextStyle(runStyle: JsonObject, paragraphStyle?: JsonObject, scale?: number): PortableTextStyle;
+/** Whether a run's background plate contributes any pixels at its opacity. */
+export declare function textBackgroundVisible(style: PortableTextStyle): boolean;
+/**
+ * Rewrites a `#rgb`, `#rrggbb` or `rgb()` colour as `rgba()` with the given
+ * alpha. Colours the parser does not recognize are returned unchanged.
+ */
+export declare function cssColorWithAlpha(color: string, alpha: number): string;
+/**
+ * Pixels a run paints outside its glyph box, whichever of the stroke or the
+ * background plate's padding reaches further.
+ */
+export declare function textPaintExtent(style: PortableTextStyle): number;
+/** Largest {@link textPaintExtent} across every run in a text clip. */
+export declare function textClipPaintExtent(clip: IrTextClip): number;
+/**
+ * Grows a layout box by `pad` on every side so stroke and background pixels
+ * stay inside the rasterized target. Non-positive padding returns `box` as-is.
+ */
+export declare function inflateTextBox(box: {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}, pad: number): {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+};
 export declare function portableGlyphAdvance(character: string, style: PortableTextStyle): number;
 /** Deterministic, host-independent line breaking used by Preview and Export. */
 export declare function layoutIrText(clip: IrTextClip): IrTextLayout;

package/dist/text-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-layout.d.ts","sourceRoot":"","sources":["../src/text-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AAQxD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,gCAAgC,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;CACnC;AAUD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,UAAU,EACpB,cAAc,GAAE,UAAe,EAC/B,KAAK,SAAI,GACR,iBAAiB,CAsBnB;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAaxF;AA8HD,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CA2B3D"}
+{"version":3,"file":"text-layout.d.ts","sourceRoot":"","sources":["../src/text-layout.ts"],"names":[],"mappings":"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"}

package/dist/text-layout.js

@@ -29,8 +29,93 @@ export function portableTextStyle(runStyle, paragraphStyle = {}, scale = 1) {
         strokeWidthPx: Math.max(0, finite(combined.strokeWidthPx, 0) * scale),
         align: align === 'center' || align === 'end' ? align : 'start',
         direction: direction === 'rtl' ? 'rtl' : 'ltr',
+        backgroundFill: text(combined.backgroundFill, '#000000'),
+        backgroundOpacity: Math.max(0, Math.min(1, finite(combined.backgroundOpacity, 0))),
+        backgroundPaddingPx: Math.max(0, combined.backgroundPaddingPx === undefined
+            ? fontSizePx * 0.25
+            : finite(combined.backgroundPaddingPx, fontSizePx * 0.25) * scale),
+        backgroundRadiusPx: Math.max(0, combined.backgroundRadiusPx === undefined
+            ? fontSizePx * 0.15
+            : finite(combined.backgroundRadiusPx, fontSizePx * 0.15) * scale),
     };
 }
+/** Whether a run's background plate contributes any pixels at its opacity. */
+export function textBackgroundVisible(style) {
+    return style.backgroundOpacity > 0.001;
+}
+/**
+ * Rewrites a `#rgb`, `#rrggbb` or `rgb()` colour as `rgba()` with the given
+ * alpha. Colours the parser does not recognize are returned unchanged.
+ */
+export function cssColorWithAlpha(color, alpha) {
+    const rgb = parseCssRgb(color);
+    const clamped = Math.max(0, Math.min(1, alpha));
+    if (rgb === undefined)
+        return color;
+    return `rgba(${rgb[0].toString()}, ${rgb[1].toString()}, ${rgb[2].toString()}, ${clamped.toString()})`;
+}
+/**
+ * Pixels a run paints outside its glyph box, whichever of the stroke or the
+ * background plate's padding reaches further.
+ */
+export function textPaintExtent(style) {
+    const pad = textBackgroundVisible(style) ? style.backgroundPaddingPx : 0;
+    return Math.max(style.strokeWidthPx, pad);
+}
+/** Largest {@link textPaintExtent} across every run in a text clip. */
+export function textClipPaintExtent(clip) {
+    let pad = 0;
+    for (const paragraph of clip.paragraphs) {
+        for (const run of paragraph.runs) {
+            pad = Math.max(pad, textPaintExtent(portableTextStyle(run.style, paragraph.style)));
+        }
+    }
+    return pad;
+}
+/**
+ * Grows a layout box by `pad` on every side so stroke and background pixels
+ * stay inside the rasterized target. Non-positive padding returns `box` as-is.
+ */
+export function inflateTextBox(box, pad) {
+    if (pad <= 0)
+        return box;
+    return {
+        x: box.x - pad,
+        y: box.y - pad,
+        width: box.width + pad * 2,
+        height: box.height + pad * 2,
+    };
+}
+function parseCssRgb(color) {
+    const value = color.trim();
+    const hex6 = /^#([0-9a-f]{6})$/iu.exec(value);
+    if (hex6?.[1] !== undefined) {
+        const n = Number.parseInt(hex6[1], 16);
+        return [(n >> 16) & 255, (n >> 8) & 255, n & 255];
+    }
+    const hex3 = /^#([0-9a-f]{3})$/iu.exec(value);
+    if (hex3?.[1] !== undefined) {
+        const raw = hex3[1];
+        const r = raw[0];
+        const g = raw[1];
+        const b = raw[2];
+        if (r === undefined || g === undefined || b === undefined)
+            return undefined;
+        return [
+            Number.parseInt(`${r}${r}`, 16),
+            Number.parseInt(`${g}${g}`, 16),
+            Number.parseInt(`${b}${b}`, 16),
+        ];
+    }
+    const rgb = /^rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/u.exec(value);
+    if (rgb === null)
+        return undefined;
+    return [
+        Number.parseInt(rgb[1] ?? '0', 10),
+        Number.parseInt(rgb[2] ?? '0', 10),
+        Number.parseInt(rgb[3] ?? '0', 10),
+    ];
+}
 export function portableGlyphAdvance(character, style) {
     const codePoint = character.codePointAt(0) ?? 0;
     const em = character === ' '

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/render-ir",
-  "version": "1.2.0-rc.2",
+  "version": "1.2.0-rc.4",
   "description": "Incremental render intermediate representation compiler for AelionSDK",
   "license": "MIT",
   "repository": {
@@ -34,9 +34,9 @@
     "provenance": true
   },
   "dependencies": {
-    "@aelionsdk/core": "1.2.0-rc.2",
-    "@aelionsdk/material-compiler": "1.2.0-rc.2",
-    "@aelionsdk/project-schema": "1.2.0-rc.2"
+    "@aelionsdk/core": "1.2.0-rc.4",
+    "@aelionsdk/material-compiler": "1.2.0-rc.4",
+    "@aelionsdk/project-schema": "1.2.0-rc.4"
   },
   "scripts": {
     "build": "tsc -b",