ggn-layout 0.1.0 → 0.1.1

package/docs/reference/elk-edge-routing-investigation.md

@@ -2,7 +2,7 @@
 
 > **Status**: 🟢 Active
 > **Last Updated**: 2026-09-10
-> **Parent**: [文档索引](../README.md)
+> **Parent**: [文档索引](../../README.md)
 > **Objective**: 回答「图里拐角很多」的三个问题——ggn-layout 是否劣于原生 ELK Java、是否存在最优参数、算法层还有多少优化空间——并给出可执行建议与复现路径。
 
 ## 1. 问题与样本
@@ -27,7 +27,7 @@
 
 ### 3.1 方法
 
-1. 从 Viewer `GET /api/events` 抓取 `run_ggn_project_feedback` 全量事件，用 `@ggn/agent` reducer 重放成场景元素；
+1. 从 Viewer `GET /api/events` 抓取 `run_ggn_project_feedback` 全量事件，用宿主应用的 event reducer 重放成场景元素；
 2. 用 kernel `measureNode()` 计算节点尺寸，导出标准 ELK JSON（19 边 / 12 节点 / `json.shapeCoords=ROOT`）；
 3. **同一份 JSON** 分别跑：
    - 本仓库：`src/api/index.ts` 的 `layoutElkJson()`
@@ -138,7 +138,7 @@
 
 改造后宿主图仍是同一套 layered 语义（`rel_*` 依赖在容器内部参与分层），只是层次不再用长边表达。
 
-**已实施（2026-09-10）**：`@ggn/agent` 归约器不再发 `contains` 边——有子模块的 module 直接渲染成
+**已实施（2026-09-10）**：宿主应用的归约器不再发 `contains` 边——有子模块的 module 直接渲染成
 `group` 容器（children = 子模块），容器自身承载标题 / 状态行 / 进度条（kernel group-renderer）。
 同口径复测（`layoutScene` 前后对照，`run_ggn_project_feedback` 63 事件快照）：
 
@@ -186,22 +186,19 @@
 
 ```text
 1) 抓事件      GET http://127.0.0.1:5198/api/events → 过滤 runId
-2) 重放        @ggn/agent reduceAgentEvents → createScene/updateElements → 元素集
+2) 重放        宿主应用 reducer → createScene/updateElements → 元素集
 3) 量尺寸      kernel measureNode() → 节点 width/height
 4) 导 ELK JSON  id + children(size) + edges(sources/targets) + layoutOptions（ROOT 坐标 + NETWORK_SIMPLEX + edgeNodeBetweenLayers=14）
 5) 双侧跑布局   ggn-layout layoutElkJson()  vs  Java oracle（同一份 JSON）
 6) 比指标      逐边折点/端点（ε=0.01）+ 弯点数 + 总边长 + 交叉对
 ```
 
-本次产物（临时文件，可复跑但会随 `/tmp` 清理）：`/tmp/ggn-edge-input.json`（19 边样本）、
-`/tmp/ggn-edge-output-ggn.json`、`/tmp/ggn-edge-java-raw.txt`、`/tmp/ggn-vs-java-edge-metrics.json`。
+本次产物为一次会话内的临时文件（19 边输入样本、双侧输出、逐边指标），未入库、也未随包发布。
 
-Java oracle 命令（ELK 0.12.0 + 未签名 layered jar）：
+Java oracle 命令（ELK 0.12.0 + 未签名 layered jar；`LayoutJsonMain` 是一次会话内的临时探针程序）：
 
 ```bash
-/opt/homebrew/opt/openjdk@21/bin/java -cp \
-  "scripts/elk-java-debug/out-edge:scripts/elk-java-debug/lib/*" \
-  LayoutJsonMain /tmp/ggn-edge-input.json > /tmp/ggn-edge-java-raw.txt
+java -cp "<probe-out>:<elk-jars>/*" LayoutJsonMain <input.json> > <java-raw.txt>
 ```
 
 > 长期回归建议：把「层次包含 vs contains 长边」两个样本收敛为 `本仓库` 的测试用例
@@ -211,5 +208,5 @@ Java oracle 命令（ELK 0.12.0 + 未签名 layered jar）：
 
 - [ELK 间距选项指南](./elk-spacing-options.md)：间距成对语义与覆盖规则
 - [ELK 布局选项接口参考](./elk-layout-options.md)：`LayeredOptions` 键与默认值
-- [GGN 渲染参数规格](../design/ggn-render-params.md)：edge 渲染参数与圆角语义
-- [Agent 开发过程可视化事件协议](../design/agent-development-event-protocol.md)：`contains` 与层级语义
+- GGN 渲染参数规格（edge 渲染参数与圆角语义）——随 GGN 主仓库维护，本仓不含该文档。
+- Agent 开发过程可视化事件协议（`contains` 与层级语义）——同上，随 GGN 主仓库维护。

package/docs/reference/elk-json-format.md

@@ -2,7 +2,7 @@
 
 > **Status**: 🟢 Active
 > **Last Updated**: 2026-08-14
-> **Parent**: [文档索引](../README.md)
+> **Parent**: [文档索引](../../README.md)
 > **Objective**: 移植 ELK Java「JSON Format」图格式指南——节点 / 端口 / 标签 / 边 / 边段五种基本元素与导入导出 API，并注明本移植的针对性差异（校验、超边、输出形态）。
 
 ## 1. 背景与来源（为什么有这份文档）

package/docs/reference/elk-layout-options-mechanism.md

@@ -2,7 +2,7 @@
 
 > **Status**: 🟢 Active
 > **Last Updated**: 2026-08-14
-> **Parent**: [文档索引](../README.md)
+> **Parent**: [文档索引](../../README.md)
 > **Objective**: 移植 ELK Java「Layout Options」机制指南——`IProperty` / `IPropertyHolder` 的读 / 写 / 查语义、同 id 不同默认值、内部属性约定，与 TS 移植的 `Property` / `MapPropertyHolder` 一一对应。
 
 ## 1. 背景与来源（为什么有这份文档）

package/docs/reference/elk-layout-options.md

@@ -2,7 +2,7 @@
 
 > **Status**: 🟢 Active
 > **Last Updated**: 2026-08-14
-> **Parent**: [文档索引](../README.md)
+> **Parent**: [文档索引](../../README.md)
 > **Objective**: 移植 ELK Java 0.12.0 布局选项接口（CoreOptions / LayeredOptions）到本项目的权威对照表——选项键、TS Property、类型、默认值一一对应；供 `kernel:layout` 接线与消费方查表。
 
 ## 1. 背景与来源（为什么有这份文档）
@@ -15,7 +15,7 @@
 - 其他算法模块：各自目录下的 `options.ts`（`DEFAULTS` 对象），见 [§6 其他算法模块选项](#6-其他算法模块选项)
 - 内部属性（`*.internal.*`，非用户接口）：`src/options/internal-properties.ts`，不在本表列出，见 [§8 边界](#8-边界与内部属性)
 
-> 与早期草稿 `plans/elk-options-canonical.md`（2026-08-07）相比，本表已按当前代码补齐并核对默认值
+> 相对 2026-08-07 的早期草稿，本表已按当前代码补齐并核对默认值
 > （如 `spacing.edgeLabel = 2`、`portSortingStrategy = INPUT_ORDER` 等修正，见 [§7 针对性修改记录](#7-针对性修改记录相对-elk-java-早期移植)）。
 
 ## 2. 阅读约定
@@ -275,7 +275,7 @@ layered 之外，`layoutElkJson` 按 `org.eclipse.elk.algorithm` 分派到各算
 | `layerUnzipping.strategy` 默认 `NONE` | 枚举 `OFF → NONE` 对齐 | canonical 清单 |
 | `priority.shortness` 默认 `0` | 早期误用 1 | canonical 清单 |
 | core 键归属 | `direction` / `edgeRouting` / `portConstraints` / `hierarchyHandling` 等早期误挂 `layered.*`，已修正回 core | canonical 清单 |
-| 命名约束 | 新增公共符号/文件名不含 `ELK`/`Elk`（`layoutElkJson`/`ElkNode` 兼容名保留） | `docs/api-workflow.md` |
+| 命名约束 | 新增公共符号/文件名不含 `ELK`/`Elk`（`layoutElkJson`/`ElkNode` 兼容名保留） | 仓库约定 |
 | spacing 基准 | `LayeredSpacingsBuilder` 以 `spacing.nodeNode`（20）为基准按比例派生其余 spacing factor | `src/options/layered-spacings.ts` |
 
 ## 8. 边界与内部属性
@@ -285,7 +285,7 @@ layered 之外，`layoutElkJson` 按 `org.eclipse.elk.algorithm` 分派到各算
   **不是用户接口**，由算法/处理器写入，消费方不应依赖。
 - 未定义 `Property` 常量的 core 键（解析层按需处理，不在本表）：`padding`、`edge.type`、单值全局
   `priority`、`portLabels.treatAsGroup`（热字符串 key，默认 `undefined`，见 `properties.ts` 的
-  `registerFastStringKey`）。待办清单见 `plans/elk-options-canonical.md` §待办。
+  `registerFastStringKey`）。
 
 ## 9. 重新生成
 

package/docs/reference/elk-node-labels.md

@@ -2,7 +2,7 @@
 
 > **Status**: 🟢 Active
 > **Last Updated**: 2026-09-10
-> **Parent**: [文档索引](../README.md)
+> **Parent**: [文档索引](../../README.md)
 > **Objective**: 对照 ELK 官方博文《Node Labels》（2025-08-22），记录 GGN kernel 的标签预留策略、与官方建议的逐条符合度、以及有意偏离（reservation-only label）的理由与风险控制。
 
 ## 1. 官方建议（博文要点）
@@ -22,7 +22,7 @@
 
 | 建议 | GGN 实现 | 符合度 |
 | :--- | :--- | :--- |
-| R1 | 组容器同时设 `nodeLabels.placement: [INSIDE, H_CENTER, V_TOP]` + `nodeSize.constraints: [NODE_LABELS]`（`packages/kernel/src/layout/elk-service.ts`） | ✅ |
+| R1 | 组容器同时设 `nodeLabels.placement: [INSIDE, H_CENTER, V_TOP]` + `nodeSize.constraints: [NODE_LABELS]`（宿主应用的布局服务层） | ✅ |
 | R2 | **不适用**：node/edge 的标签由 kernel 预测量（`measureNode` / `measureEdgeLabelSize`）后以显式 `width/height` 传入，ELK 不做字体度量（ADR 0001） | ⚪ 有意的另一条路 |
 | R3 | 不适用：容器用 `H_CENTER`，本就不产生对称留白；若未来改 `H_LEFT`，子节点可开 `ASYMMETRICAL`（移植层已实现：`src/common/node-micro-layout.ts`） | ⚪ N/A |
 | R4 | 白盒 layered 依赖 ELK 原生预留；6 种 black-box（box/force/radial/stress/rectpacking/topdownpacking）由 kernel 注入 `padding.top` 手动预留 | ✅ 与 R4 一致 |
@@ -40,7 +40,7 @@ group-renderer（kernel）                      →  实际绘制：标题（左
 
 - 为什么这么做：一行里要放「标题 + 状态 + 事实计数」，第二行还要放徽标——ELK 的单标签模型无法表达，而且我们要求 SVG 输出完全自控（框架无关）。
 - 代价：ELK 只保证「预留 ≥ 我们给的 box」，**真实文字宽度必须 ≤ 该 box**。因此需要两条保障：
-  1. **P1-b 文本实测注入**（2026-09-10）：`LayoutSceneInput.labelMeasurer` —— surface 用 canvas `measureText` 实测（`@ggn/vanilla-next` 的 `CanvasTextMeasurer`），布局按真实字宽预留，消除估算偏差；
+  1. **P1-b 文本实测注入**（2026-09-10）：`LayoutSceneInput.labelMeasurer` —— surface 用 canvas `measureText` 实测（宿主应用注入的 `labelMeasurer`），布局按真实字宽预留，消除估算偏差；
   2. **P3 字符级截断**（2026-09-10）：`MAX_LABEL_CHARS = 24` / `MAX_BADGE_CHARS = 16`——纯函数、与测量器无关，保证布局与渲染拿到同一字符串；被截断时挂 `<title>` 提供全文悬停提示，`SelectionContext` 仍返回全文。
 - 维护约束：**不要**把 `nodeLabels.placement` 当成"实际标签位置"去改渲染；改标题行几何时同步改 `group-metrics.ts`（单一来源）。
 
@@ -54,11 +54,14 @@ group-renderer（kernel）                      →  实际绘制：标题（左
 
 ## 5. 相关实现与测试
 
-- 预留计算：`packages/kernel/src/compile/group-metrics.ts`（`groupTitleRowWidth` / `groupBadgeRowWidth` / `groupHeaderHeight`）
-- 布局接线：`packages/kernel/src/layout/elk-service.ts`（`groupLabelBox` / `groupTitleMetrics` / `reserveBlackBoxTitleWidthInPlace`）
-- 渲染：`packages/kernel/src/compile/group-renderer.ts`、`node-renderer.ts`
-- 实测注入：`packages/vanilla-next/src/text-measure.ts`（`CanvasTextMeasurer`）→ `flush({ labelMeasurer })` → `layoutScene`
-- 测试：`packages/kernel/tests/elk-service.test.ts`、`packages/kernel/tests/measure.test.ts`、`packages/vanilla-next/tests/module-hierarchy.test.ts`
+- 预留计算：`groupTitleRowWidth` / `groupBadgeRowWidth` / `groupHeaderHeight`（宿主应用的组几何模块）
+- 布局接线：`groupLabelBox` / `groupTitleMetrics` / `reserveBlackBoxTitleWidthInPlace`（宿主应用的布局服务层）
+- 渲染：组渲染器与节点渲染器由宿主应用实现
+- 实测注入：`labelMeasurer` → `flush(...)` → `layoutScene`
+- 测试：宿主应用的布局服务、度量与模块层级测试
+
+> 第 2-5 节的实现均在宿主应用（GGN kernel）内，不随本包发布；本包只提供 layered 布局本身
+> 以及标签预留所需的几何输入。
 
 ## 6. 遗留
 

package/docs/reference/elk-spacing-options.md

@@ -2,7 +2,7 @@
 
 > **Status**: 🟢 Active
 > **Last Updated**: 2026-08-14
-> **Parent**: [文档索引](../README.md)
+> **Parent**: [文档索引](../../README.md)
 > **Objective**: 移植 ELK Java「Spacing Options」指南——间距成对语义、base value、个体间距覆盖与 margin/padding 正交关系，对应到 TS 的 `Spacings` 表与 `LayeredSpacingsBuilder`。
 
 ## 1. 背景与来源（为什么有这份文档）

package/docs/reference/elkjs-feature-coverage.md

@@ -2,7 +2,7 @@
 
 > **Status**: 🟢 Active
 > **Last Updated**: 2026-09-06
-> **Parent**: [文档索引](../README.md)
+> **Parent**: [文档索引](../../README.md)
 > **Objective**: 枚举 elkjs 0.12.0 的对外特性（算法 / 能力旗标 / JSON 图格式 / 选项 / API 面），逐项对照 ggn-layout（`本仓库`）的测试覆盖，给出覆盖结论与差距清单。
 
 ## 1. 范围与方法
@@ -10,7 +10,7 @@
 - 参照对象：npm `elkjs@0.12.0`（仓库根 `node_modules/elkjs`，GWT 编译 ELK Java 0.12.0）。
   运行时枚举：`knownLayoutAlgorithms()` 11 个算法、`knownLayoutOptions()` 235 项、`knownLayoutCategories()` 8 类。
 - 被测对象：`ggn-layout`（ELK Java 0.12.0 1:1 TS 移植；声明契约 = 结果层 API `layoutElkJson`，
-  见 [README](../README.md) 与 GOAL-COMPLETE「等价 elkjs：输入/输出标准 ELK JSON」）。
+  见 [README](../../README.md) 与 GOAL-COMPLETE「等价 elkjs：输入/输出标准 ELK JSON」）。
 - 方法：elkjs 运行时枚举特性面 → grep 实现与测试文件 → 抽样实跑套件确认全绿。
 - 抽样实跑（2026-09-06，vitest）：core-providers + layout-elk-json 23/23；self-loops + short-opt-keys +
   worker + coords-modes + api-validation 62/62；mrtree/radial/rectpacking/spore/topdownpacking/vertiflex/disco 63/63。
@@ -96,5 +96,4 @@
 ## 8. 相关文档
 
 - [ELK 布局选项接口参考](./elk-layout-options.md) / [JSON 图格式指南](./elk-json-format.md)
-- `docs/GOAL-COMPLETE.md`（结果层 API 对齐 elkjs 记录）、`docs/agent-remarks.md`（R16/R40/R55/R72 等 elkjs 交叉验证）
 - `docs/MODULES.tsv`（模块 ↔ Java 类 ↔ 观测点）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ggn-layout",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "ELK Layered 1:1 TypeScript 移植 (模型/算法/变量名与 ELK 源码一致)",
   "type": "module",
   "exports": {
@@ -86,7 +86,11 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json --noEmit && node scripts/check-process-env-defines.mjs && tsdown",
     "smoke:pack": "node scripts/smoke-packed.mjs",
-    "prepublishOnly": "npm run typecheck && npm run test:ci && npm run build",
+    "prepublishOnly": "npm run typecheck && npm run check:license && npm run test:ci && npm run build && npm run smoke:pack && npm run check:pkg",
+    "check:license": "node scripts/check-license-headers.mjs",
+    "check:pkg": "node scripts/check-publint.mjs && node scripts/check-attw.mjs && node scripts/check-doc-links.mjs",
+    "check:attw": "node scripts/check-attw.mjs",
+    "check:docs": "node scripts/check-doc-links.mjs",
     "dev": "tsdown --watch",
     "typecheck": "tsc --noEmit",
     "typecheck:src": "tsc -p tsconfig.build.json --noEmit",
@@ -131,7 +135,11 @@
     "sugiyama",
     "typescript"
   ],
-  "license": "MIT",
+  "license": "(MIT AND EPL-2.0)",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/0xlxx/ggn-layout.git"

package/dist/layered-options-COPhjoOB.d.ts

@@ -1,6 +0,0 @@
-import { tt as Property } from "./elk-json-ibWtLFj2.js";
-//#region src/options/layered-options.d.ts
-/** 层级处理. */
-declare const HIERARCHY_HANDLING: Property<string | null>;
-//#endregion
-export { HIERARCHY_HANDLING as t };

package/dist/layered-options-Dm7nJC1R.d.cts

@@ -1,6 +0,0 @@
-import { tt as Property } from "./elk-json-ibWtLFj2.cjs";
-//#region src/options/layered-options.d.ts
-/** 层级处理. */
-declare const HIERARCHY_HANDLING: Property<string | null>;
-//#endregion
-export { HIERARCHY_HANDLING as t };