ice-render 1.4.0 → 1.4.2

package/dist/types/graphic/text/ICEText.d.ts

@@ -91,6 +91,15 @@ declare class ICEText extends ICEComponent {
         width: any;
         height: any;
     };
+    /**
+     * 多行文本的行距系数。
+     *
+     * 为什么不能直接用 `actualBoundingBoxAscent + Descent`（字形墨迹高度）当行距：
+     * 墨迹只覆盖「有笔画的部分」，拉丁字母的 cap-height 比 em 小得多 —— 14px Tahoma 的
+     * 墨迹高 ≈ 12px，拿它当行距时中文（墨迹接近满 em）会**上下叠在一起**，看起来像文字被压扁。
+     * 按字号 × 1.35 取行距更接近系统的自然行高，同时保证 ≥ 墨迹高度（不会挤）。
+     */
+    private static readonly LINE_HEIGHT_RATIO;
     /**
      * @method measureText
      *
@@ -126,6 +135,18 @@ declare class ICEText extends ICEComponent {
     private __applyMeasuredSize;
     /** DOM 降级测量：line-height 归一为 1，减少 leading 干扰（旧环境/小程序）。 */
     private __measureByDOM;
+    /**
+     * 文本的**渲染行布局**：每一行的内容与基线坐标（组件本地坐标）。
+     *
+     * 画布渲染与 SVG 导出共用这一份口径 —— 两处各算一遍必然漂移（改了对齐公式忘了另一处，
+     * 表现为「导出的文字整体偏移」）。返回的 `x` 是**文字左边缘**（左/居中/右对齐都按画布公式算好），
+     * `y` 是 baseline 位置。
+     */
+    getRenderLines(): Array<{
+        text: string;
+        x: number;
+        y: number;
+    }>;
     /**
      * @method doRender
      * @overwrite

package/dist/types/index.d.mts

@@ -49,6 +49,8 @@ export { default as ICELayeredLayout } from './layout/ICELayeredLayout.mjs';
 export { default as ICETheme, baseTokens, DEFAULT_THEME, DARK_THEME, registerTheme, setTheme, getTheme, STYLE_PRESETS, } from './theme/ICETheme.mjs';
 export { default as ICE } from './ICE.mjs';
 export { default as CanvasRenderer } from './renderer/CanvasRenderer.mjs';
+export { exportSvg, exportSvgResult } from './export/SvgExporter.mjs';
+export type { SvgExportOptions, SvgExportResult } from './export/SvgExporter.mjs';
 export { default as PluginHost } from './plugin/PluginHost.mjs';
 export type { ICEPlugin, ICEPluginTool, ICERenderHook, ICERenderFrame } from './plugin/PluginHost.mjs';
 export { default as Serializer, SERIALIZATION_VERSION } from './persistence/Serializer.mjs';

package/dist/types/index.d.ts

@@ -49,6 +49,8 @@ export { default as ICELayeredLayout } from './layout/ICELayeredLayout';
 export { default as ICETheme, baseTokens, DEFAULT_THEME, DARK_THEME, registerTheme, setTheme, getTheme, STYLE_PRESETS, } from './theme/ICETheme';
 export { default as ICE } from './ICE';
 export { default as CanvasRenderer } from './renderer/CanvasRenderer';
+export { exportSvg, exportSvgResult } from './export/SvgExporter';
+export type { SvgExportOptions, SvgExportResult } from './export/SvgExporter';
 export { default as PluginHost } from './plugin/PluginHost';
 export type { ICEPlugin, ICEPluginTool, ICERenderHook, ICERenderFrame } from './plugin/PluginHost';
 export { default as Serializer, SERIALIZATION_VERSION } from './persistence/Serializer';

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-render",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "A canvas engine for interactive graphics.",
   "repository": {
     "type": "git",
@@ -49,7 +49,7 @@
     "pkg:lint": "publint",
     "pkg:types": "attw --pack .",
     "pkg:check": "npm run pkg:lint && npm run pkg:types",
-    "test:visual:ci": "playwright test e2e/visual/examples-smoke.spec.ts e2e/visual/interaction.spec.ts e2e/visual/dirty-rect-pixel.spec.ts e2e/visual/viewport.spec.ts e2e/visual/alignment.spec.ts e2e/visual/hidpi.spec.ts e2e/visual/worker-perf.spec.ts",
+    "test:visual:ci": "playwright test e2e/visual/examples-smoke.spec.ts e2e/visual/interaction.spec.ts e2e/visual/dirty-rect-pixel.spec.ts e2e/visual/viewport.spec.ts e2e/visual/alignment.spec.ts e2e/visual/hidpi.spec.ts e2e/visual/worker-perf.spec.ts e2e/visual/svg-parity.spec.ts",
     "verify": "npm run lint && npm run types:check && npm run build && npm test -- --runInBand && npm run bench 2000 && npm run pkg:check",
     "verify:full": "npm run verify && npm run test:visual"
   },