Directed graph XML: expose document, shape and connector options (part of #225)

[saveenr]

Summary

Implements the agreed first tier of #225: more of the directed graph model can be set from the directed graph XML format. Every addition is optional, so existing XML loads unchanged. This is part of #225, not all of it (see "Not included").

New XML

• <documentoptions template borderwidth borderheight> as a child of <directedgraph> (a new element, so the root still takes no attributes). If only one border attribute is given the other keeps its default.
• On <shape>: width and height (both or neither); <hyperlink name address subaddress description> children (the url attribute's link stays first); a <cells><cell name value/></cells> child that sets any ShapeCells property by name (case-insensitive, unknown names throw); and <customprop> gains type (string, number, boolean, date), label, prompt and format.
• On <connector>: a per-edge connectortype that overrides the page setting, a <cells> child (explicit cells win over the color, weight and arrow defaults), and <customprop> children.

Renderer fix

MsaglRenderer now applies Edge.CustomProperties to the drawn connector (dynamic and Bezier). It previously ignored them, so connector custom properties could not have worked from any path.

Not included, and why

• pageborderwidth / pageborderheight (PageBorderWidth): built, then removed. They have no effect on the XML path: DrawDirectedGraphDocument resizes each page again with the document's BorderSize, which wins (live-verified: a page border of 3 gave the same page width as the default; a document border of 3 doubled it).
• DefaultShapeSize: never used for nodes, because masters resolve their sizes first.
• Per-edge master and stencil, choosing the Visio-based renderer, and DirectedGraphStyling from XML: out of the agreed scope; they need model and pipeline changes. Directed graph XML format: expose all DirectedGraphLayout model options #225 should stay open for them.
• template is exposed, but note it inherits NewDocumentFromTemplate creates a blank document and opens the template as a stencil, instead of basing the document on it #229: NewDocumentFromTemplate opens the template as a docked stencil and returns a blank drawing. Filed separately.

Testing

• 23 new tests in DirectedGraphXmlOptionsTests (loader tests plus live drawing tests).
• Debug build, local Visio: VTest.Models 103/103, VTest.Scripting 43/43, VTest.PowerShell 27/27.
• End to end through PowerShell (Import-VisioModel x.xml | Out-VisioApplication) with an XML file using the new options: sizes, fill color, both hyperlinks, number and boolean custom properties, the connector's arrow and custom property all reached the drawn shapes.

Notes

• NuGet/CHANGELOG.md [Unreleased] gets an Added section and a Fixed entry.
• I did not update the test counts in docs/TESTING.md or CLAUDE.md: PR Fix DrawOrgChart resizing the target page #228 edits the same lines. They need a refresh after both merge.
• The matching GitBook page is a companion PR in saveenr/VisioAutomation_GitBook_Docs.

Refs #225, #229

🤖 Generated with Claude Code