refactor(joint-react): unified ElementRecord / LinkRecord with portMap, labelMap, style

[kumilingus]

Summary

Replaces the multi-type system (PortalElementRecord, NativeElementRecord, AnyElementRecord, etc.) with a single ElementRecord and LinkRecord that support both declarative and native JointJS formats.

New API

Elements — ElementRecord<D> extends dia.Element.Attributes:

• portMap?: Record<string, ElementPort> — declarative ports (converted to native ports by mapper)
• portStyle?: Partial<ElementPort> — default style for all ports in portMap
• ports — native JointJS format, passed through as-is
• data?: D — custom user data

Links — LinkRecord<D> extends dia.Link.Attributes:

• style?: LinkStyle — declarative link presentation (color, width, markers, etc.)
• labelMap?: Record<string, LinkLabel> — declarative labels (converted to native labels array by mapper)
• labelStyle?: Partial<LinkLabel> — default style for all labels in labelMap
• labels — native JointJS Label[] format, passed through as-is
• data?: D — custom user data

What changed

• Single type per cell: ElementRecord and LinkRecord replace 6 types (Portal*, Native*, Any*)
• portMap / labelMap: declarative (Record-keyed) ports and labels use new field names, avoiding collision with native ports/labels
• style: link presentation fields (color, width, sourceMarker, etc.) moved from top-level into style: { ... } object
• Extends JointJS attributes: both types extend dia.*.Attributes — all native properties pass through
• Simplified generics: data?: D is always optional (no conditional types), interfaces are extensible via extends
• data required in hooks: ElementWithLayout and ResolvedLink guarantee data: D (always present at runtime)
• Sub-type renames: ElementRecordPort → ElementPort, LinkRecordStyle → LinkStyle, LinkRecordLabel → LinkLabel
• Mapper detection: forward mapper checks for portMap/labelMap presence (no type field discriminant needed). Throws if both declarative and native formats are provided.
• isShallowEqual: widened to object | undefined (generic utility)
• Test file renames: use-flat-element-data.test.ts → use-element-defaults.test.ts, use-flat-link-data.test.ts → use-link-defaults.test.ts

Removed from public API

• PortalElementRecord, NativeElementRecord, AnyElementRecord
• PortalLinkRecord, NativeLinkRecord, AnyLinkRecord
• MixedElementRecord, MixedLinkRecord
• FlatElementPort, FlatLinkLabel, FlatLinkPresentationData

Test plan

• npx tsc --noEmit — 0 new errors
• yarn jest — 533 pass, pre-existing failures only
• Storybook renders correctly
• Portal elements with portMap render ports
• Native elements with ports pass through
• Links with style render correctly
• Links with labelMap render labels
• Native links with labels array pass through

🤖 Generated with Claude Code