ml_switcheroo.core.html.nodes

HTML DSL Semantic Nodes.

Defines the structure for the visual elements used in the HTML/SVG DSL: - GridBox: Represents a layer (Red), operation (Blue), or data shape (Green). - SvgArrow: Represents data flow connections. - HtmlDocument: The root container holding CSS and body content.

Classes

HtmlNode	Abstract base class for all HTML DSL elements.
SvgArrow	Represents an SVG connection line between grid cells.
GridBox	Represents a content box positioned within the CSS Grid.
HtmlDocument	Root container for the generated HTML.

Module Contents

class ml_switcheroo.core.html.nodes.HtmlNode

Abstract base class for all HTML DSL elements.

abstractmethod to_html() → str

Render the node and its children to an HTML string.

Returns:

The raw HTML content.

Return type:

str

Raises:

NotImplementedError – If not implemented by subclass.

class ml_switcheroo.core.html.nodes.SvgArrow

Bases: HtmlNode

Represents an SVG connection line between grid cells.

x1: int

y1: int

x2: int

y2: int

style_class: str

marker_end: str

parent_style: str

to_html() → str

Renders the arrow as an absolute SVG element. Adds ‘sw-arrow’ class for scoped styling.

class ml_switcheroo.core.html.nodes.GridBox

Bases: HtmlNode

Represents a content box positioned within the CSS Grid.

row: int

col: int

css_class: str

header_text: str

code_text: str | None = None

body_text: str | None = None

arrows: List[SvgArrow] = []

z_index: int | None = None

to_html() → str

Renders the grid cell div, its content, and attached arrows.

class ml_switcheroo.core.html.nodes.HtmlDocument

Bases: HtmlNode

Root container for the generated HTML.

model_name: str

children: List[GridBox]

to_html() → str

Renders the complete HTML document.

Notes:

• Removed ‘visibility:hidden’ from markers block to enable correct rendering in some browsers when injected via innerHTML. Use 0 sizes and pointer-events logic instead.

Returns:

The complete HTML string document.