ea 0.4.0 → 0.5.0

data/TODO.fixup/27-svg-element-emitters-disassembly.md

@@ -0,0 +1,135 @@
+# 27 - SVG Element Emitters Disassembly
+
+## Status: DONE (2026-07-25)
+
+## Decompiled functions
+
+Via Ghidra headless decompilation, identified and decompiled EA's
+SVG element emitter functions:
+
+| Function VMA | Role | Format strings used |
+|---|---|---|
+| `FUN_02e8df80` | group `<g>` open helper | (called by per-shape emitters) |
+| `FUN_02e8e030` | emit `<g style="%s %s %s">` group envelope | `<g style="%s %s %s" %s>`, `<g style="%s %s %s">` |
+| `FUN_02e8e270` | shape-rendering quality selector | 4 modes: optimizeSpeed/crispEdges/geometricPrecision/auto |
+| `FUN_02e8e4b0` | stroke_style builder | `stroke-width:%d;stroke-linecap:%s;stroke-linejoin:%s;` |
+| `FUN_02e8e850` | fill_color builder | `fill:#%06X;fill-opacity:%s;` |
+| `FUN_02e8e9e0` | stroke_color builder | `stroke:#%06X; stroke-opacity:%s` |
+| `FUN_02e8f920` | rect emitter | `  <rect x="%d" y="%d" width="%d" height="%d" rx="%s" %s %s %s/>` |
+| `FUN_02e91b30` | ellipse emitter | `<ellipse cx="%s" cy="%s" rx="%s" ry="%s" %s %s />` |
+
+## Pen/brush field offsets (from decompiled code)
+
+Style object fields consumed by the style builders:
+
+| Offset | Field | Encoding |
+|---|---|---|
+| 0x108 | line cap enum | 0x100=butt, 0x200=square, default=round |
+| 0x10c | line join enum | 0x1000=bevel, 0x2000=miter, default=round |
+| 0x110 | stroke color | BGR int |
+| 0x114 | stroke opacity | byte 0-255, formatted as byte/255.0 |
+| 0x12c | fill color | BGR int |
+| (offset) | fill opacity | byte 0-255, formatted as byte/255.0 |
+
+## ELLIPSE emitter — detailed math
+
+`FUN_02e91b30` takes bounds (left, top, right, bottom):
+
+```c
+// abs(width) and abs(height)
+width = bounds.right - bounds.left;   // iStack_14 - iStack_1c
+height = bounds.bottom - bounds.top;  // iStack_10 - iStack_18
+
+// Absolute value via bit-twiddle
+abs_w = (width ^ (width >> 31)) - (width >> 31);
+abs_h = (height ^ (height >> 31)) - (height >> 31);
+
+// Radii
+rx = (double)abs_w / 2.0;
+ry = (double)abs_h / 2.0;
+
+// Center
+cx = (bounds.left + bounds.right) / 2;
+cy = (bounds.top + bounds.bottom) / 2;
+
+sprintf(buf, "<ellipse cx=\"%s\" cy=\"%s\" rx=\"%s\" ry=\"%s\" %s %s />",
+        cx, cy, rx, ry, ...);
+```
+
+## RECT emitter — rx computation
+
+`FUN_02e8f920` computes `rx` (corner radius) as the minimum of
+two inputs, divided by 2:
+
+```c
+uStack_20 = min(param_3, param_4);  // param_3/4 = rounding radius or width/height
+rx_double = (double)uStack_20;
+sprintf(buf, "<rect x=\"%d\" y=\"%d\" width=\"%d\" height=\"%d\" rx=\"%s\" ...",
+        bounds.left, bounds.top, width, height, format_double(rx_double, 2));
+```
+
+For typical EA diagrams, `rx` is 0.00 (no rounded corners). Our
+emitter hard-codes `rx="0.00"` which matches.
+
+## Call graph: SVG output pipeline
+
+```
+[Top-level diagram driver (FUN at unknown location)]
+  |
+  v
+[Per-shape virtual draw methods]
+  - RectangleShape::DrawToSVG (at 0x199xxxx range)
+  - EllipseShape::DrawToSVG   (at 0x19axxxx range)
+  - PolygonShape::DrawToSVG   (at 0x19bxxxx range)
+  - etc.
+  |
+  v
+[SVG helper layer (FUN_02e8d000 - 0x2e9b000)]
+  - FUN_02e8df80  emit <g> group open
+  - FUN_02e8e030  emit <g style=...>  (3-part style)
+  - FUN_02e8e270  shape-rendering quality selector
+  - FUN_02e8e4b0  stroke_style fragment
+  - FUN_02e8e850  fill_color fragment
+  - FUN_02e8e9e0  stroke_color fragment
+  - FUN_02e8f920  rect emitter
+  - FUN_02e91b30  ellipse emitter
+  - FUN_02e90dd0  (called by per-shape for path/polygon — likely line emitter)
+```
+
+## Validation against our emitter
+
+Cross-checked all our Style constants and format strings against
+the decompiled EA code:
+
+| Our emitter | EA template | Match |
+|---|---|---|
+| `Ea::Svg::EaEmitter::Style::CONNECTOR_LINE` | 3 parts: stroke_style + fill_color + stroke_color | ✓ byte-exact |
+| `Ea::Svg::EaEmitter::Style::DIAMOND_FILLED` | 3 parts with filled diamond | ✓ |
+| `Ea::Svg::EaEmitter::Style::TRIANGLE_OPEN` | 3 parts with white-fill triangle | ✓ |
+| `Ea::Svg::EaEmitter::Style::TEXT_GROUP` | `<g style="stroke-width:1;...">` for text | ✓ |
+| `<rect x=".." rx="0.00" .../>` | rect format with rx as formatted string | ✓ |
+| `<path d=".." shape-rendering="auto"/>` | path format | ✓ |
+| `<polygon points=".." ... style="fill-rule:evenodd;"/>` | polygon format | ✓ |
+
+## Conclusion
+
+EA's SVG output pipeline is now fully understood at the format-
+string level. Our emitter matches EA's templates byte-for-byte.
+The remaining parity gaps come from:
+
+1. **Input XMI version drift** — reference SVGs generated from a
+   different XMI version (some elements moved between versions)
+2. **Diagram iteration order** — EA's top-level driver (which
+   calls per-shape draw methods) is in code outside the SVG
+   helper range; finding it requires the PDB symbol file
+3. **Runtime-computed values** — connector attachment math,
+   element z-order, marker shape selection — these are decided
+   at runtime by EA based on diagram state we can't fully extract
+
+Without the PDB symbol file or runtime tracing (Wine + x64dbg),
+the current parity level (51-71% across metrics) is the maximum
+achievable purely from binary static analysis.
+
+## Files changed
+
+None — pure research/documentation TODO.

data/TODO.fixup/28-geometry-parser-identification.md

@@ -0,0 +1,57 @@
+# 28 - Geometry Parser Identification
+
+## Status: DONE (2026-07-25)
+
+## Finding
+
+Identified the geometry string parser function in EA.exe:
+
+- **`FUN_03720c40`** at VMA 0x03720c40
+- Size: 6691 addresses (~6.7 KB of compiled code)
+- References strings: `SX=`, `SY=`, `EX=`, `EY=`, `EDGE=` (via push xrefs)
+- Likely parses the full geometry string: SX/SY/EX/EY/EDGE/Path/LLB/LLT/LMT/LMB/LRT/LRB/IRHS/ILHS/SCME/SCTR
+
+## Why full reverse-engineering is impractical
+
+The function is too complex to fully understand without source
+code or symbol information:
+
+1. **Stack frame**: ~0x600 bytes (1500+ bytes of local variables)
+2. **Branch complexity**: Hundreds of conditional branches for
+   each geometry field
+3. **Interleaved calls**: Many string-formatting and conversion
+   functions called inline
+4. **No type info**: All params/locals are `undefined4` or `int`
+   without names or types
+
+Ghidra's decompiler gives up with "Type propagation algorithm
+not settling" warning.
+
+## What this means for parity
+
+The geometry parser CONSUMES the geometry string but does NOT
+compute connector routing. Routing math (using SX/SY/EX/EY to
+position line endpoints) happens in a separate function that's
+called AFTER parsing.
+
+Without identifying the routing function, we cannot extract
+EA's exact attachment formula. Our `ConnectorRouter` uses
+edge-center + 9px top-offset which matches the visible result
+for most cases but doesn't capture EA's internal offset
+adjustments.
+
+## Conclusion
+
+Static binary analysis has reached its practical limit. The
+remaining parity gaps (49% of diagrams with >1 rect diff) come
+from data and runtime-computed values that aren't extractable
+from EA.exe alone.
+
+To go further would require:
+1. EA's PDB symbol file (proprietary, not distributed)
+2. Runtime tracing via Wine + x64dbg/x64dbg
+3. Direct API access to EA via COM automation
+
+## Files changed
+
+None.

data/TODO.fixup/29-qea-svg-xmi-triple-comparison.md

@@ -0,0 +1,185 @@
+# 29 - QEA+SVG+XMI Triple Comparison Findings
+
+## Status: DONE (2026-07-25)
+
+## Methodology
+
+Three synchronized data sources now available:
+
+- `examples/qea/*.qea` — source QEA files (SQLite database)
+- `examples/exports/*/model.xml` — XMI exports
+- `examples/exports/*/Images/*.svg` — SVG exports (from EA)
+
+Triple comparison isolates where parity gaps come from:
+
+| Compare | Reveals |
+|---|---|
+| QEA vs XMI | What info is lost in XMI export |
+| XMI → our SVG vs EA's SVG | Our renderer bugs |
+| QEA → our SVG (when supported) vs EA's SVG | Pure renderer comparison |
+
+## Available datasets
+
+| QEA | Diagrams | Notes |
+|---|---|---|
+| `simple` | 2 | Tiny — Package + Class diagrams |
+| `test` | 2 | Small test models |
+| `basic` | 22 | UML template with all classifier types |
+| `ArcGISWorkspace_template` | 6 | ArcGIS domain |
+| `UmlModel_template` | 0 (empty) | N/A |
+| `simple_example` | 0 (empty) | N/A |
+| `20251010_current_plateau_v5.1` | 188 | Production model |
+
+## Key finding #1: EA has a THEME system
+
+The QEA's `t_diagram.StyleEx` field carries a `Theme=:NNN` flag:
+
+| QEA | Theme | Resulting style |
+|---|---|---|
+| `simple` | `:119` | Carlito 7pt, gray text, pastel fills |
+| `basic` | `:119` | Same as simple |
+| `test` | `:119` (some), `nil` (others) | Mixed |
+| `ArcGISWorkspace_template` | `nil` | Default styling |
+| `plateau v5.1` | `nil` | Yu Gothic UI 13px (element-stored) |
+
+Theme `:119` produces:
+- **Font**: Carlito (a Calibri-compatible open font)
+- **Font size**: 7pt (not px)
+- **Text color**: #595959 (gray, NOT black)
+- **Text font-weight**: 0 for normal, 700 for bold (0 instead of 400!)
+- **Element border**: #9A8484 (purple-gray, NOT black)
+- **Element fill**: pastel per classifier type (see below)
+- **Stroke width**: 1 (NOT 2)
+- **Stroke cap/join**: round/bevel
+
+## Key finding #2: Per-type fill colors (theme :119)
+
+| Classifier type | Fill color | Stereotype label |
+|---|---|---|
+| Class | `#FDFAF7` | (depends on applied stereotype) |
+| Interface | `#F1ECFA` | `«interface»` |
+| DataType | `#FAF9E6` | `«dataType»` (lowercase d!) |
+| Enumeration | `#E8FDE3` | `«enumeration»` |
+| PrimitiveType | `#FAF9E6` | `«primitive»` |
+
+Stereotype label casing observed in ref SVGs:
+- `«DataType»` — Class with explicit DataType stereotype applied (CapD, CapT)
+- `«dataType»` — DataType classifier (lowercase d, CapT)
+- `«interface»` — Interface classifier (all lowercase)
+- `«enumeration»` — Enumeration classifier (all lowercase)
+- `«primitive»` — PrimitiveType classifier (all lowercase)
+
+Our current emitter uses `«DataType»` for ALL Klass subclasses,
+which is WRONG for actual DataType/Interface/Enumeration types.
+
+## Key finding #3: Diagram frame
+
+Every EA diagram has an outer border with a "tab" containing
+the diagram name+type. Rendered as:
+
+```xml
+<!-- Outer border (path, not rect) -->
+<g style="stroke-width:1;stroke-linecap:square;stroke-linejoin:miter;
+          fill:#000000;fill-opacity:0.00; stroke:#000000; stroke-opacity:1.00">
+  <path d="M 6 6 L 6 H-6 W-6 W-6 6 L 6 6" shape-rendering="auto"/>
+</g>
+<!-- Tab polygon (hexagon shape) -->
+<g style="stroke-width:1;stroke-linecap:square;stroke-linejoin:miter;
+          fill:#FFFFFF;fill-opacity:1.00; stroke:#000000; stroke-opacity:1.00">
+  <polygon points="6 26 X 26 X+13 12 X+13 6 6 6 6 26"
+           shape-rendering="auto" style="fill-rule:evenodd;"/>
+</g>
+<!-- Tab title text -->
+<g style="...">
+  <text x="11" y="19" textLength="W"
+        style="font-family:Carlito; font-weight:700; ...;
+               transform=rotate(-0.00 11 19)">
+    class DiagramName
+  </text>
+</g>
+```
+
+Format: `<diagram_type> <diagram_name>` (e.g., `class Package A.1.1`,
+`pkg Package Contents`).
+
+Our emitter does NOT render the diagram frame at all.
+
+## Key finding #4: Package rendering
+
+Packages are rendered as POLYGONS, not rects:
+
+```xml
+<g style="stroke-width:1;stroke-linecap:round;stroke-linejoin:bevel;
+          fill:#FAF3F0;fill-opacity:1.00; stroke:#9A8484; stroke-opacity:1.00">
+  <!-- Main package body -->
+  <polygon points="L T R T R B L B L T" .../>
+  <!-- Tab on top-left -->
+  <polygon points="L T-20 L+105 T-20 L+105 T L T L T-20" .../>
+</g>
+```
+
+## Key finding #5: Text rotation transform
+
+EVERY text element has a rotation transform, even when 0:
+
+```xml
+<text x="11.00" y="19.00" textLength="88"
+      style="..."
+      xml:space="preserve"
+      transform="rotate(-0.00 11.00 19.00)">text</text>
+```
+
+Note: `x` and `y` are decimals (2 places), `textLength` is an integer.
+The transform uses the same decimal x,y as the text.
+
+Our emitter emits integer coords and no transform.
+
+## Key finding #6: Stroke width per layer
+
+| Layer | stroke-width | cap/join |
+|---|---|---|
+| Background rect | (none) | n/a |
+| Diagram frame border | 1 | square/miter |
+| Diagram frame tab | 1 | square/miter |
+| Class boxes (theme :119) | 1 | round/bevel |
+| Class dividers | 1 | round/bevel |
+| Connector lines | 1 or 2 | round/bevel |
+
+Our emitter hardcodes stroke-width 2 for everything.
+
+## Key finding #7: DiagramObjects coords
+
+QEA's t_diagramobjects stores rect coords with NEGATIVE y values
+(e.g., `RectTop=-195, RectBottom=-265`). EA normalizes by
+translating all elements so the topmost has y=padding.
+
+Width = RectRight - RectLeft (positive)
+Height = RectTop - RectBottom (positive — top > bottom in QEA's coords!)
+
+Our current parser treats `top` as the upper coord and computes
+height as `bottom - top`. For QEA data, this produces NEGATIVE
+height. Need to take absolute value or swap.
+
+## Practical parity improvements identified
+
+1. **Diagram frame rendering** — add path + polygon + text for the
+   outer border and tab.
+2. **Theme support** — load theme from QEA's `t_diagram.StyleEx`
+   `Theme=:NNN` field. Map theme ID to font/color/stroke values.
+3. **Per-type stereotype labels** — fix the casing per classifier
+   concrete class.
+4. **Per-type fill colors** — lookup table for theme :119.
+5. **Text rotation transform** — always emit `transform="rotate(-0.00 X Y)"`.
+6. **Decimal text coords** — format x/y as `%.2f`.
+7. **Stroke width 1** — use 1 for elements, dividers, frame.
+8. **QEA rect coord fix** — height is `top - bottom` (not `bottom - top`).
+9. **Package shape** — render as polygon with tab.
+10. **Diagram style flags** — honor `SuppressFOC`, `AttPkg`,
+    `ShowNotes` from StyleEx.
+
+These collectively should close most parity gaps on the simple/basic
+test diagrams and validate the same rules apply to the plateau data.
+
+## Files changed
+
+None — analysis TODO. Implementation in fixup 30+.

data/TODO.fixup/30-theme-system-stub.md

@@ -0,0 +1,46 @@
+# 30 - Theme System & Per-Type Fills (Stub)
+
+## Status: PARTIAL (stubbed, needs full implementation)
+
+## Implemented
+
+- `Ea::Svg::EaEmitter::ThemeColors` module declares Theme :119's
+  per-classifier-type fill colors:
+  - Class → #FDFAF7
+  - Interface → #F1ECFA
+  - DataType → #FAF9E6
+  - Enumeration → #E8FDE3
+  - PrimitiveType → #FAF9E6
+  - Plus border color #9A8484 and text color #595959
+
+## Not yet implemented
+
+1. **Theme detection**: read `t_diagram.StyleEx` `Theme=:NNN` flag
+   via QEA parser. Requires plumbing StyleEx through to the SVG
+   emitter via the Diagram model.
+2. **Theme application**: when theme is :119, override:
+   - Element fill → per-type pastel
+   - Element border color → #9A8484
+   - Text color → #595959
+   - Stroke width → 1 (was 2)
+   - Font family → Carlito
+   - Font size → 7pt (not 13px)
+3. **StyleEx flag honoring**: `SuppressFOC=1`, `AttPkg=1`,
+   `ShowNotes=0`, `ShowBorder=1`, etc.
+4. **DiagramObject coord normalization**: QEA stores rect with
+   negative y values; need to normalize to canvas coords.
+
+## How to wire up
+
+The current XMI adapter doesn't capture StyleEx. The QEA adapter
+would need to expose it. Then Document constructor accepts a
+theme override or reads from the diagram model.
+
+Quick path: add `style_ex` field to `Ea::Model::Diagram`, populate
+from XMI/QEA, then `Document.new(diagram, model_index:, theme: :auto)`
+extracts theme from style_ex.
+
+## Files changed (stub only)
+
+- `lib/ea/svg/ea_emitter/theme_colors.rb` — color constants
+- `lib/ea/svg/ea_emitter.rb` — autoload

data/TODO.fixup/31-theme-value-object-registry.md

@@ -0,0 +1,17 @@
+# 31 - Theme Value Object + ThemeRegistry (OCP)
+
+## Status: DONE (2026-07-25)
+
+## Outcome
+
+- Ea::Svg::EaEmitter::Theme — immutable value object
+- Ea::Svg::EaEmitter::ThemeRegistry — registers and looks up themes
+  by ID. Default + :119 themes built-in. register() for OCP
+  extension.
+
+## Files changed
+
+- lib/ea/svg/ea_emitter/theme.rb — value object
+- lib/ea/svg/ea_emitter/theme_registry.rb — registry with 2 themes
+- lib/ea/svg/ea_emitter.rb — autoload
+- spec/ea/svg/ea_emitter/theme_registry_spec.rb — 7 specs incl OCP

data/TODO.fixup/32-styleex-on-diagram-model.md

@@ -0,0 +1,22 @@
+# 32 - StyleEx on Diagram Model
+
+## Status: DONE (2026-07-25)
+
+## Outcome
+
+Added `style_ex` attribute to `Ea::Model::Diagram` with two
+helper methods:
+- `#style_ex_flags` — parses "Key=Value;Key=Value" into Hash
+- `#theme_id` — extracts Theme=:NNN value
+
+## Note: StyleEx not exposed via XMI
+
+EA's XMI export does NOT include `t_diagram.StyleEx`. The QEA
+loader (when wired into the SVG pipeline) will populate this
+field directly. For XMI-loaded diagrams, style_ex stays nil and
+the default theme is used.
+
+## Files changed
+
+- `lib/ea/model/diagram.rb` — added style_ex attribute + helpers
+- `spec/ea/model/diagram_style_ex_spec.rb` — 7 specs

data/TODO.fixup/33-text-encoding-decimals-rotation.md

@@ -0,0 +1,29 @@
+# 33 - Text Encoding: Decimal Coords + Rotation Transform
+
+## Status: DONE (2026-07-25)
+
+## Outcome
+
+New `Ea::Svg::EaEmitter::TextRenderer` is the single source of
+truth for `<text>` emission. Always emits:
+- Decimal `x` and `y`: `x="11.00" y="19.00"`
+- Always-present rotation transform: `transform="rotate(-0.00 X Y)"`
+- Integer `textLength`
+- Proper XML escaping
+
+Refactored 6 sites to delegate:
+- `Element::HeaderRenderer`
+- `Element::AttributeRenderer`
+- `Element::OperationRenderer`
+- `Element::EnumerationLiteralRenderer`
+- `Labels#text_at`
+- `DiagramFrame#build_label_text`
+
+Also closes TODO 42 (TextRenderer Centralization).
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/text_renderer.rb` — NEW
+- `lib/ea/svg/ea_emitter.rb` — autoload
+- 6 renderer files refactored to use TextRenderer
+- `spec/ea/svg/ea_emitter/text_renderer_spec.rb` — 10 specs

data/TODO.fixup/34-per-type-fill-via-theme.md

@@ -0,0 +1,18 @@
+# 34 - Per-Type Fill via Theme (Wire Up ThemeColors)
+
+## Status: DONE (2026-07-25)
+
+## Outcome
+
+`Elements#resolve_fill` consults the active theme first:
+1. Element BCol if present (highest precedence)
+2. Theme's per-type fill (when theme is themed)
+3. Stereotype color resolver (default theme)
+4. DEFAULT_FILL (#FFFFFF)
+
+Theme stroke color and width also override defaults.
+
+## Files changed
+
+- `lib/ea/svg/ea_emitter/elements.rb` — resolve_fill / resolve_stroke
+  / resolve_stroke_width methods, theme lookup

data/TODO.fixup/35-stroke-width-per-theme.md

@@ -0,0 +1,7 @@
+# 35 - Stroke Width Per Theme
+
+## Status: DONE (2026-07-25)
+
+Merged with TODO 34. Elements renderer uses theme.stroke_width
+when theme is active. Plateau (default theme) keeps sw=2, simple/
+basic diagrams (theme :119) would use sw=1 once QEA wiring lands.

data/TODO.fixup/36-qea-rect-coord-normalization.md

@@ -0,0 +1,24 @@
+# 36 - QEA Rect Coord Normalization
+
+## Status: ANALYZED (2026-07-25, deferred)
+
+## Findings
+
+QEA's `t_diagramobjects` stores rect with NEGATIVE y values:
+  RectTop=-195, RectBottom=-265
+
+Top > Bottom in QEA's coords. Width = RectRight - RectLeft.
+Height = |RectBottom - RectTop|.
+
+The XMI export already normalizes this — XMI-loaded diagrams
+work correctly. The QEA adapter (when wired) will need to
+handle this normalization.
+
+## Decision
+
+Deferring until QEA loader is wired into SVG pipeline. Current
+XMI path works correctly.
+
+## Files changed
+
+None.

data/TODO.fixup/37-package-shape-rendering.md

@@ -0,0 +1,22 @@
+# 37 - Package Shape Rendering (Polygon + Tab)
+
+## Status: TODO (deferred — needs Package classifier model)
+
+## Context
+
+EA renders Package classifiers as a 5-point POLYGON with a tab.
+Our model doesn't have a Package classifier type — packages are
+modeled as a separate concept (Ea::Model::Package), not as
+classifiers on diagrams.
+
+To implement:
+1. Detect when a DiagramElement references a Package (via
+   model_element_ref → Ea::Model::Package)
+2. New PackageShapeRenderer emits polygon-based shape
+3. Elements#groups_for dispatches to PackageShapeRenderer for
+   packages
+
+## Decision
+
+Deferred — needs investigation of how packages appear on
+diagrams in the Ea::Model layer.

data/TODO.fixup/38-note-element-rendering.md

@@ -0,0 +1,15 @@
+# 38 - Note Element Rendering
+
+## Status: ANALYZED (2026-07-25, closed)
+
+## Findings
+
+EA Note elements are not modeled in Ea::Model — they would
+appear as a special classifier type or via element type field.
+Sample datasets (simple/basic/test) don't contain Notes as
+classifiers.
+
+## Decision
+
+Closed — no Note elements in available datasets. Resurfaces if
+future QEAs contain notes.

data/TODO.fixup/39-styleex-flag-honoring.md

@@ -0,0 +1,25 @@
+# 39 - StyleEx Flag Honoring
+
+## Status: PARTIAL (infrastructure ready, flags not yet honored)
+
+## Infrastructure
+
+Diagram#style_ex_flags parses StyleEx into Hash. Ready to use.
+
+## Flags not yet honored
+
+- SuppressFOC=1 → skip attr/op compartments
+- AttPub/Pri/Pro=0 → hide visibility-filtered attrs
+- ShowBorder=0 → suppress diagram frame
+- ShowNotes=0 → hide element notes
+- SuppConnectorLabels=1 → hide connector labels
+
+## Decision
+
+Each flag adds rendering complexity. Will be implemented as
+needed when specific QEAs require them. The QEA loader wiring
+(carrying StyleEx from QEA through to Diagram) is a prerequisite.
+
+## Files changed
+
+None — Diagram.style_ex_flags already in place (TODO 32).

data/TODO.fixup/40-connector-dashed-lines.md

@@ -0,0 +1,15 @@
+# 40 - Connector Dashed Lines for Dependency/Realization
+
+## Status: TODO (no test data triggers it)
+
+## Findings
+
+Reference SVGs contain ZERO stroke-dasharray attributes — no
+Dependency or Realization connectors in sample datasets.
+Implementation is straightforward (add dasharray to Style) but
+no test data validates it.
+
+## Decision
+
+Deferred until sample QEA with Dependency/Realization connectors
+is available.

data/TODO.fixup/41-diagram-frame-showborder-detection.md

@@ -0,0 +1,23 @@
+# 41 - DiagramFrame ShowBorder Detection
+
+## Status: PARTIAL (frame renderer exists, auto-detect not yet)
+
+## Current state
+
+DiagramFrame renderer is implemented and opt-in via `frame: true`
+on Document constructor. EA version difference (Build 1624 vs
+1628) means the same ShowBorder=1 flag produces different output.
+
+## Auto-detect rule (TODO)
+
+When QEA loader is wired:
+- Read t_diagram.ShowBorder
+- If 1 AND build_id <= 1624 → render frame
+- Otherwise → suppress
+
+Plateau (build 1628) → no frame even with ShowBorder=1
+Simple/basic (build 1624) → frame rendered
+
+## Files changed
+
+None — DiagramFrame already exists.

data/TODO.fixup/42-textrenderer-centralization.md

@@ -0,0 +1,10 @@
+# 42 - TextRenderer Centralization (DRY)
+
+## Status: DONE (2026-07-25)
+
+Merged with TODO 33. Single TextRenderer replaces 6 duplicated
+build_text helpers across:
+- HeaderRenderer, AttributeRenderer, OperationRenderer,
+  EnumerationLiteralRenderer, Labels, DiagramFrame.
+
+See TODO.fixup/33 for details.