语义表格变宽区域 API
SemanticTable 实现 WidthAwareRegionFlow，支持在连续不同宽度的栏内重新解析列宽和换行。默认完整行和跨行合并的传递连通组保持原子；每个实际呈现的片段保留同一 Table 来源、原始行／物理列、UTF-16、字段、图片和外链。
java
var table = Table.builder("details")
.cellFormat(CellFormat.builder().fontSize(10).lineHeight(18).build())
.header("ITEM", "DETAIL")
.row("A", "Content wraps at the actual column width.")
.row("B", "The original row and cell sources remain intact.")
.build();
var content = FlowColumn.builder().padding(2).semanticTable(table).build();
var columns = ContinuousColumns.builder(content)
.columnWeights(List.of(1.0, 2.0)).gap(12).build();
var document = Documents.builder().component("details-host", columns).build();
engine.export(document).backend(new PdfBackend()).to(Path.of("details.pdf"));此处所有几何尺寸为 pt。FlowColumn 在每个区域扣除自己的左右内边距，并按当前区域旋转子宽度序列；字体与样式作用域透传宽度。balanced(true) 仍执行最多 24 次有界公共栏高试排，最终保留实际验证过的布局。
核心入口
DocumentLayouter.layoutTableRegions(table, context, regions, widths) 返回不可变 TableRegion 序列。宽度列表在入口快照，数量为 1～16，每项正有限且不超出上下文宽度，按逻辑区域索引循环；跳过的短区仍占宽度序号。续区高度不得大于上下文高度。
等宽序列复用原有一次测量游标。不同宽度默认逐区安排完整行／合并行组；显式 allowRowSplit=true 时，行内内容格可按完整行跨宽度续排，详见拆行指南。初始短区无法容纳表头和最小正文时可跳过，完整续区仍无法推进则报 CONTENT_TOO_TALL。固定列超宽、图片或字段实际行宽不足继续明确失败，不缩放、不裁切，也不悄悄移去另一宽度。
支持既有固定／比例列；普通文字格支持已验收的有界 Auto 和双跨度。原子 Paragraph／Table 块格在每种实际宽度下重新布局，嵌套宽度逐层扣内边距；块格表 Auto 限制保持，行内内表 Auto 见内表指南。不同宽度下的行内格完整行续排及纵向 owner 拆分均已接入；递归块子树续排和组件 GridTable 尚不在该契约内。
来源、预算和资源
- 源结构、原文及图片预算检查一次；完整源身份和连续片段序号由最终文档再次验证。
- 原子路径每个不同宽度最多准备一次完整表格，最多 16 个候选；拆行路径缓存列／表头，再按完整格源准备实际行。累计准备工作不得超过 4,000,000 个源 UTF-16 单位，每个候选另受配置的行预算限制；未选候选不会合并诊断。
- 最终行预算只计已选择正文和实际重复表头。占用区域受
maxPages及 100,000 上限控制；逻辑区域上限 100,016。 - 页码、总页数和引用留到最终物理分页解析，重复表头按每次实际呈现取值。图文外链取最终实际矩形。
- 测量不执行 I/O，不拥有字体／图片资源，不启动线程；观察现有执行范围的取消／超时，调用间没有共享可变表格状态。