ice-render 1.0.4 → 1.0.6

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

@@ -1,65 +1,137 @@
-import ICEComponent from '../ICEComponent';
-/**
- * TODO:draw text along Path2D
- * @class ICEText 文本
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class ICEText extends ICEComponent {
-    /**
-     * @cfg
-     * {
-     *   text:'文本内容',
-     *   left:0,
-     *   top:0,
-     *   style:{
-     *       fontWeight:24,
-     *       fontSize:48,
-     *       fontFamily:'Arial',
-     *       lineWidth:1,
-     *       textBaseline:'bottom',
-     *       paddingTop:0,    //number 型，不可加单位
-     *       paddingBottom:0, //number 型，不可加单位
-     *       paddingLeft:0,   //number 型，不可加单位
-     *       paddingRight:0,  //number 型，不可加单位
-     *   }
-     * }
-     * @param props
-     */
-    constructor(props?: any);
-    protected static arrangeParam(props: any): any;
-    /**
-     * @overwrite
-     * @method calcComponentParams
-     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
-     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
-     * - 此方法不能依赖原点位置和 transform 矩阵。
-     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
-     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
-     * - 子类可以覆盖此方法，实现自己的计算逻辑。
-     * @returns
-     */
-    protected calcComponentParams(): {
-        width: any;
-        height: any;
-    };
-    /**
-     * @method measureText
-     *
-     * - Canvas 中没有提供原生的计算文本高度的有效方法，文本宽高的计算需要使用特殊的方法，这里使用的方法来自 https://longviewcoder.com/2021/02/11/html5-canvas-text-line-height-measurement/
-     * - 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
-     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
-     *
-     * FIXME:这里有性能瓶颈，需要进一步优化
-     * FIXME:某些运行时环境可能不支持动态插入 HTML 标签，以上测量文本宽高的方法可能存在兼容性问题。
-     * FIXME:对文本位置的控制需要更精细的计算方法。
-     */
-    private measureText;
-    /**
-     * @method doRender
-     * @overwrite
-     * 文本是基于 baseline 绘制的，文本是从 y 坐标向屏幕上方绘制的，48 是文本高度，这里需要补偿文本高度。
-     * 同时把移动坐标轴原点的偏移量计算进去。
-     */
-    protected doRender(): void;
-}
-export default ICEText;
+import ICEComponent from '../ICEComponent';
+/**
+ * TODO:draw text along Path2D
+ * @class ICEText 文本
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEText extends ICEComponent {
+    /**
+     * @cfg
+     * {
+     *   text:'文本内容',
+     *   left:0,
+     *   top:0,
+     *   style:{
+     *       fontWeight:24,
+     *       fontSize:48,
+     *       fontFamily:'Arial',
+     *       lineWidth:1,
+     *       textBaseline:'bottom',
+     *       paddingTop:0,    //number 型，不可加单位
+     *       paddingBottom:0, //number 型，不可加单位
+     *       paddingLeft:0,   //number 型，不可加单位
+     *       paddingRight:0,  //number 型，不可加单位
+     *   }
+     * }
+     * @param props
+     */
+    constructor(props?: any);
+    protected static arrangeParam(props: any): any;
+    /**
+     * @overwrite
+     * 双击进入内联编辑态。
+     */
+    protected initEvents(): void;
+    /**
+     * 进入编辑前的 draggable 原值，退出编辑时恢复。
+     */
+    private __originalDraggable;
+    /**
+     * 编辑态叠加的 HTML input（用于支持中文 IME 输入）。浏览器环境下存在；
+     * 无 document 的运行时（Node/小程序）为 null，降级为 canvas keydown 输入。
+     */
+    private __editInput;
+    /**
+     * 进入内联编辑态：光标定位到文本末尾，隐藏变换面板、禁用拖拽（避免编辑时误拖动）。
+     */
+    startEditing(): void;
+    /**
+     * 退出内联编辑态（提交文本）。退出后不自动恢复变换面板——用户若需再变换组件，重新点击组件即可。
+     */
+    stopEditing(): void;
+    /**
+     * 创建透明的 HTML input 覆盖在文本上，捕获输入（含中文 IME）。
+     * input 文字设为透明（canvas 负责显示），只保留可见光标。
+     */
+    private __mountEditInput;
+    /**
+     * 移除编辑态的 HTML input。
+     */
+    private __unmountEditInput;
+    /**
+     * 全局 mousedown 处理器：点击的组件不是自身时，退出编辑（失焦退出）。
+     */
+    private __globalMouseDownHandler;
+    /**
+     * 设置文本内容（会重新测量宽高）。
+     */
+    setText(text: string): this;
+    getText(): string;
+    /**
+     * @overwrite
+     * 编辑态下接管键盘输入：字符插入 / Backspace / Delete / 方向键移动光标 / Enter 提交。
+     */
+    protected keyboardEvtHandler(evt: any): void;
+    /**
+     * 在编辑态下渲染光标（垂直竖线），位置由 caretIndex + ctx.measureText 计算。
+     */
+    private renderCaret;
+    /**
+     * @overwrite
+     * @method calcComponentParams
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
+     * @returns
+     */
+    protected calcComponentParams(): {
+        width: any;
+        height: any;
+    };
+    /**
+     * @method measureText
+     *
+     * - Canvas 中没有提供原生的计算文本高度的有效方法，文本宽高的计算需要使用特殊的方法，这里使用的方法来自 https://longviewcoder.com/2021/02/11/html5-canvas-text-line-height-measurement/
+     * - 计算原始的宽高、位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     *
+     * FIXME:这里有性能瓶颈，需要进一步优化
+     * FIXME:某些运行时环境可能不支持动态插入 HTML 标签，以上测量文本宽高的方法可能存在兼容性问题。
+     * FIXME:对文本位置的控制需要更精细的计算方法。
+     */
+    private measureText;
+    /**
+     * 计算换行后的行数组；返回 null 表示「不换行，按 \n 拆」。
+     */
+    private __computeWrappedLines;
+    /** 统一的测宽函数：优先 ctx.measureText；无 ctx 时按 fontSize 粗估。 */
+    private __measureFn;
+    /**
+     * 按 grapheme cluster 切分。
+     * 优先 Intl.Segmenter（Baseline 2024），能把 emoji / ZWJ 序列 / 组合字符合成一个单元；
+     * 不可用时退化为码点切分（至少不会把代理对拆开）。
+     */
+    private __graphemes;
+    /** 贪心换行：逐 grapheme 累加，超过可用宽度即断行。保留段落自身的 \n。 */
+    private __wrapText;
+    /**
+     * 超过 maxLines 时截断末行并追加省略号；逐 grapheme 回退直到「内容+省略号」放得下。
+     */
+    private __truncateLines;
+    /** 用 Canvas TextMetrics.actualBoundingBox* 测量文本真实宽高；不支持则返回 null 降级。 */
+    private __measureByCanvas;
+    private __applyMeasuredSize;
+    /** DOM 降级测量：line-height 归一为 1，减少 leading 干扰（旧环境/小程序）。 */
+    private __measureByDOM;
+    /**
+     * @method doRender
+     * @overwrite
+     * 文本是基于 baseline 绘制的，文本是从 y 坐标向屏幕上方绘制的，48 是文本高度，这里需要补偿文本高度。
+     * 同时把移动坐标轴原点的偏移量计算进去。
+     */
+    protected doRender(): void;
+}
+export default ICEText;

package/dist/types/index.d.mts

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export { default as AnimationManager } from './animation/AnimationManager.mjs';
+export { default as ICEControlPanel } from './control-panel/ICEControlPanel.mjs';
+export { default as ICEControlPanelManager } from './control-panel/ICEControlPanelManager.mjs';
+export { default as AlignmentGuideManager } from './control-panel/AlignmentGuideManager.mjs';
+export { default as LineControlPanel } from './control-panel/link-controls/LineControlPanel.mjs';
+export { default as ResizeControl } from './control-panel/transform-controls/ResizeControl.mjs';
+export { default as RotateControl } from './control-panel/transform-controls/RotateControl.mjs';
+export { default as TransformControlPanel } from './control-panel/transform-controls/TransformControlPanel.mjs';
+export { default as DOMEventDispatcher } from './event/DOMEventDispatcher.mjs';
+export { default as DOMEventInterceptor } from './event/DOMEventInterceptor.mjs';
+export { default as EventBus } from './event/EventBus.mjs';
+export { default as ICEEventTarget } from './event/ICEEventTarget.mjs';
+export { default as GeoLine } from './geometry/GeoLine.mjs';
+export { default as GeoPoint } from './geometry/GeoPoint.mjs';
+export { default as GeoUtil } from './geometry/GeoUtil.mjs';
+export { default as ICEBoundingBox } from './geometry/ICEBoundingBox.mjs';
+export { default as ICEGroup } from './graphic/container/ICEGroup.mjs';
+export { default as ICEComponent } from './graphic/ICEComponent.mjs';
+export { default as ICEDotPath } from './graphic/ICEDotPath.mjs';
+export { default as ICEImage } from './graphic/ICEImage.mjs';
+export { default as ICEPath } from './graphic/ICEPath.mjs';
+export { default as ICEBezier } from './graphic/link/ICEBezier.mjs';
+export { default as ICELinkHook } from './graphic/link/ICELinkHook.mjs';
+export { default as ICELinkSlot } from './graphic/link/ICELinkSlot.mjs';
+export { default as ICEPolyLine } from './graphic/link/ICEPolyLine.mjs';
+export { default as ICEVisioLink } from './graphic/link/ICEVisioLink.mjs';
+export { default as ICECircle } from './graphic/shape/ICECircle.mjs';
+export { default as ICEEllipse } from './graphic/shape/ICEEllipse.mjs';
+export { default as ICEIsogon } from './graphic/shape/ICEIsogon.mjs';
+export { default as ICERect } from './graphic/shape/ICERect.mjs';
+export { default as ICERose } from './graphic/shape/ICERose.mjs';
+export { default as ICEStar } from './graphic/shape/ICEStar.mjs';
+export { default as ICEText } from './graphic/text/ICEText.mjs';
+export { default as ICELayoutManager } from './layout/ICELayoutManager.mjs';
+export { default as ICEFlowLayout } from './layout/ICEFlowLayout.mjs';
+export { default as ICEGridLayout } from './layout/ICEGridLayout.mjs';
+export { default as ICEBorderLayout } from './layout/ICEBorderLayout.mjs';
+export { default as ICEBoxLayout } from './layout/ICEBoxLayout.mjs';
+export { default as ICECardLayout } from './layout/ICECardLayout.mjs';
+export { default as ICEOverlayLayout } from './layout/ICEOverlayLayout.mjs';
+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 { default as PluginHost } from './plugin/PluginHost.mjs';
+export type { ICEPlugin, ICEPluginTool, ICERenderHook, ICERenderFrame } from './plugin/PluginHost.mjs';
+export { buildAccessibilityTree } from './a11y/accessibility.mjs';
+export type { ICEAccessibleNode, ICEAccessibleRole, ICEAccessibilityOptions } from './a11y/accessibility.mjs';

package/dist/types/index.d.ts

@@ -1,41 +1,55 @@
-/**
- * Copyright (c) 2022 大漠穷秋.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-export { default as AnimationManager } from './animation/AnimationManager';
-export { default as ICEControlPanel } from './control-panel/ICEControlPanel';
-export { default as ICEControlPanelManager } from './control-panel/ICEControlPanelManager';
-export { default as LineControlPanel } from './control-panel/link-controls/LineControlPanel';
-export { default as ResizeControl } from './control-panel/transform-controls/ResizeControl';
-export { default as RotateControl } from './control-panel/transform-controls/RotateControl';
-export { default as TransformControlPanel } from './control-panel/transform-controls/TransformControlPanel';
-export { default as DOMEventDispatcher } from './event/DOMEventDispatcher';
-export { default as DOMEventInterceptor } from './event/DOMEventInterceptor';
-export { default as EventBus } from './event/EventBus';
-export { default as ICEEventTarget } from './event/ICEEventTarget';
-export { default as GeoLine } from './geometry/GeoLine';
-export { default as GeoPoint } from './geometry/GeoPoint';
-export { default as GeoUtil } from './geometry/GeoUtil';
-export { default as ICEBoundingBox } from './geometry/ICEBoundingBox';
-export { default as ICEGroup } from './graphic/container/ICEGroup';
-export { default as ICEComponent } from './graphic/ICEComponent';
-export { default as ICEDotPath } from './graphic/ICEDotPath';
-export { default as ICEImage } from './graphic/ICEImage';
-export { default as ICEPath } from './graphic/ICEPath';
-export { default as ICEBezier } from './graphic/link/ICEBezier';
-export { default as ICELinkHook } from './graphic/link/ICELinkHook';
-export { default as ICELinkSlot } from './graphic/link/ICELinkSlot';
-export { default as ICEPolyLine } from './graphic/link/ICEPolyLine';
-export { default as ICEVisioLink } from './graphic/link/ICEVisioLink';
-export { default as ICECircle } from './graphic/shape/ICECircle';
-export { default as ICEEllipse } from './graphic/shape/ICEEllipse';
-export { default as ICEIsogon } from './graphic/shape/ICEIsogon';
-export { default as ICERect } from './graphic/shape/ICERect';
-export { default as ICERose } from './graphic/shape/ICERose';
-export { default as ICEStar } from './graphic/shape/ICEStar';
-export { default as ICEText } from './graphic/text/ICEText';
-export { default as ICE } from './ICE';
-export { default as CanvasRenderer } from './renderer/CanvasRenderer';
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export { default as AnimationManager } from './animation/AnimationManager';
+export { default as ICEControlPanel } from './control-panel/ICEControlPanel';
+export { default as ICEControlPanelManager } from './control-panel/ICEControlPanelManager';
+export { default as AlignmentGuideManager } from './control-panel/AlignmentGuideManager';
+export { default as LineControlPanel } from './control-panel/link-controls/LineControlPanel';
+export { default as ResizeControl } from './control-panel/transform-controls/ResizeControl';
+export { default as RotateControl } from './control-panel/transform-controls/RotateControl';
+export { default as TransformControlPanel } from './control-panel/transform-controls/TransformControlPanel';
+export { default as DOMEventDispatcher } from './event/DOMEventDispatcher';
+export { default as DOMEventInterceptor } from './event/DOMEventInterceptor';
+export { default as EventBus } from './event/EventBus';
+export { default as ICEEventTarget } from './event/ICEEventTarget';
+export { default as GeoLine } from './geometry/GeoLine';
+export { default as GeoPoint } from './geometry/GeoPoint';
+export { default as GeoUtil } from './geometry/GeoUtil';
+export { default as ICEBoundingBox } from './geometry/ICEBoundingBox';
+export { default as ICEGroup } from './graphic/container/ICEGroup';
+export { default as ICEComponent } from './graphic/ICEComponent';
+export { default as ICEDotPath } from './graphic/ICEDotPath';
+export { default as ICEImage } from './graphic/ICEImage';
+export { default as ICEPath } from './graphic/ICEPath';
+export { default as ICEBezier } from './graphic/link/ICEBezier';
+export { default as ICELinkHook } from './graphic/link/ICELinkHook';
+export { default as ICELinkSlot } from './graphic/link/ICELinkSlot';
+export { default as ICEPolyLine } from './graphic/link/ICEPolyLine';
+export { default as ICEVisioLink } from './graphic/link/ICEVisioLink';
+export { default as ICECircle } from './graphic/shape/ICECircle';
+export { default as ICEEllipse } from './graphic/shape/ICEEllipse';
+export { default as ICEIsogon } from './graphic/shape/ICEIsogon';
+export { default as ICERect } from './graphic/shape/ICERect';
+export { default as ICERose } from './graphic/shape/ICERose';
+export { default as ICEStar } from './graphic/shape/ICEStar';
+export { default as ICEText } from './graphic/text/ICEText';
+export { default as ICELayoutManager } from './layout/ICELayoutManager';
+export { default as ICEFlowLayout } from './layout/ICEFlowLayout';
+export { default as ICEGridLayout } from './layout/ICEGridLayout';
+export { default as ICEBorderLayout } from './layout/ICEBorderLayout';
+export { default as ICEBoxLayout } from './layout/ICEBoxLayout';
+export { default as ICECardLayout } from './layout/ICECardLayout';
+export { default as ICEOverlayLayout } from './layout/ICEOverlayLayout';
+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 { default as PluginHost } from './plugin/PluginHost';
+export type { ICEPlugin, ICEPluginTool, ICERenderHook, ICERenderFrame } from './plugin/PluginHost';
+export { buildAccessibilityTree } from './a11y/accessibility';
+export type { ICEAccessibleNode, ICEAccessibleRole, ICEAccessibilityOptions } from './a11y/accessibility';

package/dist/types/layout/ICEBorderLayout.d.mts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type ICEGroup from '../graphic/container/ICEGroup.mjs';
+import ICELayoutManager from './ICELayoutManager.mjs';
+/**
+ * @class ICEBorderLayout 五区域布局
+ *
+ * 对齐 Java Swing 的 BorderLayout：把容器分成五个区域——north(上)/south(下)/east(右)/west(左)/center(中)。
+ * 子组件通过 state.layoutConstraint 指定所属区域（默认 'center'）：
+ *
+ * ```
+ * new ICERect({ layoutConstraint: 'north', ... })  // 顶部
+ * ```
+ *
+ * 规则：north/south 占满整宽、高度取自身；east/west 占左右剩余高度；center 填充中间剩余区域。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEBorderLayout extends ICELayoutManager {
+    private gap;
+    constructor(props?: {
+        gap?: number;
+    });
+    /**
+     * @overwrite
+     */
+    layoutContainer(container: ICEGroup): void;
+}
+export default ICEBorderLayout;

package/dist/types/layout/ICEBorderLayout.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type ICEGroup from '../graphic/container/ICEGroup';
+import ICELayoutManager from './ICELayoutManager';
+/**
+ * @class ICEBorderLayout 五区域布局
+ *
+ * 对齐 Java Swing 的 BorderLayout：把容器分成五个区域——north(上)/south(下)/east(右)/west(左)/center(中)。
+ * 子组件通过 state.layoutConstraint 指定所属区域（默认 'center'）：
+ *
+ * ```
+ * new ICERect({ layoutConstraint: 'north', ... })  // 顶部
+ * ```
+ *
+ * 规则：north/south 占满整宽、高度取自身；east/west 占左右剩余高度；center 填充中间剩余区域。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEBorderLayout extends ICELayoutManager {
+    private gap;
+    constructor(props?: {
+        gap?: number;
+    });
+    /**
+     * @overwrite
+     */
+    layoutContainer(container: ICEGroup): void;
+}
+export default ICEBorderLayout;

package/dist/types/layout/ICEBoxLayout.d.mts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type ICEGroup from '../graphic/container/ICEGroup.mjs';
+import ICELayoutManager from './ICELayoutManager.mjs';
+/**
+ * @class ICEBoxLayout 箱式布局
+ *
+ * 对齐 Java Swing 的 BoxLayout：子组件沿单轴（横向 x / 纵向 y）依次排列，不换行。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEBoxLayout extends ICELayoutManager {
+    private axis;
+    private gap;
+    constructor(props?: {
+        axis?: 'x' | 'y';
+        gap?: number;
+    });
+    /**
+     * @overwrite
+     * 沿单轴依次排列，横向时 left 递增，纵向时 top 递增。
+     */
+    layoutContainer(container: ICEGroup): void;
+}
+export default ICEBoxLayout;

package/dist/types/layout/ICEBoxLayout.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type ICEGroup from '../graphic/container/ICEGroup';
+import ICELayoutManager from './ICELayoutManager';
+/**
+ * @class ICEBoxLayout 箱式布局
+ *
+ * 对齐 Java Swing 的 BoxLayout：子组件沿单轴（横向 x / 纵向 y）依次排列，不换行。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEBoxLayout extends ICELayoutManager {
+    private axis;
+    private gap;
+    constructor(props?: {
+        axis?: 'x' | 'y';
+        gap?: number;
+    });
+    /**
+     * @overwrite
+     * 沿单轴依次排列，横向时 left 递增，纵向时 top 递增。
+     */
+    layoutContainer(container: ICEGroup): void;
+}
+export default ICEBoxLayout;

package/dist/types/layout/ICECardLayout.d.mts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type ICEGroup from '../graphic/container/ICEGroup.mjs';
+import ICELayoutManager from './ICELayoutManager.mjs';
+/**
+ * @class ICECardLayout 卡片布局
+ *
+ * 对齐 Java Swing 的 CardLayout：一次只显示一个子组件（卡片），其余隐藏。
+ * 通过 show(index) / next() / previous() 切换当前显示的卡片。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICECardLayout extends ICELayoutManager {
+    private currentIndex;
+    private container;
+    constructor(props?: {
+        currentIndex?: number;
+    });
+    /**
+     * @overwrite
+     * 只显示当前卡片（display=true），其余隐藏（display=false），当前卡片对齐到左上角。
+     */
+    layoutContainer(container: ICEGroup): void;
+    /**
+     * 切换到指定卡片。
+     */
+    show(index: number): void;
+    next(): void;
+    previous(): void;
+}
+export default ICECardLayout;

package/dist/types/layout/ICECardLayout.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type ICEGroup from '../graphic/container/ICEGroup';
+import ICELayoutManager from './ICELayoutManager';
+/**
+ * @class ICECardLayout 卡片布局
+ *
+ * 对齐 Java Swing 的 CardLayout：一次只显示一个子组件（卡片），其余隐藏。
+ * 通过 show(index) / next() / previous() 切换当前显示的卡片。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICECardLayout extends ICELayoutManager {
+    private currentIndex;
+    private container;
+    constructor(props?: {
+        currentIndex?: number;
+    });
+    /**
+     * @overwrite
+     * 只显示当前卡片（display=true），其余隐藏（display=false），当前卡片对齐到左上角。
+     */
+    layoutContainer(container: ICEGroup): void;
+    /**
+     * 切换到指定卡片。
+     */
+    show(index: number): void;
+    next(): void;
+    previous(): void;
+}
+export default ICECardLayout;

package/dist/types/layout/ICEFlowLayout.d.mts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type ICEGroup from '../graphic/container/ICEGroup.mjs';
+import ICELayoutManager from './ICELayoutManager.mjs';
+/**
+ * @class ICEFlowLayout 流式布局
+ *
+ * 对齐 Java Swing 的 FlowLayout：子组件从左到右依次排列，一行放不下（超出容器宽度）则换行。
+ * 支持 left / center / right 三种对齐，以及 gap 间距。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEFlowLayout extends ICELayoutManager {
+    private gap;
+    private align;
+    constructor(props?: {
+        gap?: number;
+        align?: 'left' | 'center' | 'right';
+    });
+    /**
+     * @overwrite
+     * 从左到右排列子组件，超出容器宽度则换行。
+     */
+    layoutContainer(container: ICEGroup): void;
+}
+export default ICEFlowLayout;

package/dist/types/layout/ICEFlowLayout.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type ICEGroup from '../graphic/container/ICEGroup';
+import ICELayoutManager from './ICELayoutManager';
+/**
+ * @class ICEFlowLayout 流式布局
+ *
+ * 对齐 Java Swing 的 FlowLayout：子组件从左到右依次排列，一行放不下（超出容器宽度）则换行。
+ * 支持 left / center / right 三种对齐，以及 gap 间距。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEFlowLayout extends ICELayoutManager {
+    private gap;
+    private align;
+    constructor(props?: {
+        gap?: number;
+        align?: 'left' | 'center' | 'right';
+    });
+    /**
+     * @overwrite
+     * 从左到右排列子组件，超出容器宽度则换行。
+     */
+    layoutContainer(container: ICEGroup): void;
+}
+export default ICEFlowLayout;