@hy-bricks/canvas 0.4.3 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +24 -0
- package/dist/index.cjs +2 -2
- package/dist/index.d.ts +266 -8
- package/dist/index.mjs +2 -2
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,29 @@
|
|
|
1
1
|
# @hy-bricks/canvas
|
|
2
2
|
|
|
3
|
+
## [0.5.0] - 2026-06-03 · free-split 自由分割布局
|
|
4
|
+
|
|
5
|
+
新增第 6 种容器布局 `free-split`(递归分割树)+ 渲染/编辑 gate 解耦。@hy-bricks 4 包同步升 0.5.0。
|
|
6
|
+
|
|
7
|
+
### ✨ 新特性 — free-split
|
|
8
|
+
|
|
9
|
+
- `containerLayout.mode = 'free-split'`:容器内一棵递归分割树(`SplitBranch` row/col + `SplitLeaf`),每格一个组件。
|
|
10
|
+
- 设计器可视化编辑(`:free-split-enabled="true"` 开):切分(`⬌` 左右 / `⬍` 上下)、拖分隔条 resize、合并(双击 / hover 合并按钮)、删除分区(`✕`)、移动/交换(`⠿` 拖)、拖组件填格。
|
|
11
|
+
- handle 出口:`handle.freeSplit.{fill,clear,swap,resize,split,merge}` + `handle.getFreeSplitDropTarget(point)` + leaf/divider 并行选区。
|
|
12
|
+
- 不可伪造 undo、每操作一次 undo、结构锁(`structureLocked` / `leaf.locked`)。
|
|
13
|
+
|
|
14
|
+
### ⚠️ BREAKING
|
|
15
|
+
|
|
16
|
+
- **`HyperCardPageRenderer` 移除 `freeSplitEnabled` prop** —— 渲染改为 **data-driven**:页面文档里有合法 free-split 就自动按树渲染(任意宿主**零 opt-in**;非法树 fallback 平铺)。若之前给 **Renderer** 传过该 prop,删掉即可,渲染照常。`HyperCardCanvasDesigner` 的 `freeSplitEnabled` prop **保留**(它控编辑)。
|
|
17
|
+
|
|
18
|
+
### 升级
|
|
19
|
+
|
|
20
|
+
- **不用 free-split 的页面/宿主**:零行为变化(非 free-split 页渲染完全不变)。
|
|
21
|
+
- **要用 free-split**:① 设计器传 `:free-split-enabled="true"` ② 宿主**后端放行** `mode='free-split'` 校验(id 唯一 / NodeSize ratio>0·min≤max / 深度≤8;参考 `reference-backend`)③ drop 走 `handle.freeSplit.fill`。详见文档「指南 → 自由分割布局(free-split)」。
|
|
22
|
+
|
|
23
|
+
### 依赖
|
|
24
|
+
|
|
25
|
+
- `@hy-bricks/core@0.5.0`(fixed 组同步)。
|
|
26
|
+
|
|
3
27
|
## 0.4.3
|
|
4
28
|
|
|
5
29
|
### Patch Changes
|