Conformance: the SysML block definition diagram
Release 0.25.0 (milestone 3, docs/diagrams/notes/milestone-3.md §7). Support is claimed by level (decision D3): render and edit on the subset below. No interchange: Mermaid has no block definition notation, and there is no XMI.
A view of a version-2 model whose diagram is "sysml.block-definition" is a block definition diagram, drawn by lib/umlimator-all.js (umlimator/all); lib/umlimator.js draws it as plain cards with a warning. The vocabulary is docs/diagrams/model.md §2, row 17; the example is examples/ebike-blocks.json, the e-bike's blocks, interface block, constraint blocks and value types.
The subset, and SysML v1.7's clauses
SysML v1.7 (formal/24-01-07): clause 8 (blocks, value types), clause 9 (ports, flow properties, interface blocks), clause 10 (constraint blocks), Annex A (the frame).
| SysML v1.7 | In the model | Drawn as |
|---|---|---|
| 8, «block» | sysml.Block | a classifier with «block» and SysML's named compartments, each titled: parts, references, values, constraints, operations, ports, flow properties; an empty one is not drawn |
| 8, «valueType» | sysml.ValueType; props.unit, props.quantityKind (text) | «valueType» and a quantity compartment, unit = Wh, quantityKind = energy |
| 9, «interfaceBlock» | sysml.InterfaceBlock | «interfaceBlock», flow properties, ports, operations |
| 10, «constraintBlock» | sysml.ConstraintBlock; props.constraint (text) | «constraintBlock», constraints (its expression in braces, then its constraint properties), parameters |
| 8, part, reference, value and constraint properties | sysml.PartProperty, sysml.ReferenceProperty, sysml.ValueProperty, sysml.ConstraintProperty; valueType, multiplicity, default | rows name: Type [mult] = default |
| 9, ports | sysml.Port; props.kind proxy, full or none; a type starting ~ conjugated | rows, «proxy» or «full» before the name |
| 9, flow properties | sysml.FlowProperty; props.direction in, out, inout | rows in dc: DCPower |
| 10, parameters | sysml.ConstraintParameter | rows in a constraint block's parameters |
| UML associations, generalizations, dependencies | uml.Association (a composite one is a part, below), uml.Generalization, uml.Dependency | the class type's lines and ends |
| Annex A, the frame | the view; its subject, a package or none | bdd [Package] Name [view title], or bdd [Model] <model title> [view title] |
A part is a member; a composite association end of its role is the same part drawn as a line, and the two agree (one type, one multiplicity): part-agrees and part-unlisted (§7.2).
Rules (src/sysml/blocks.js, beside the class type's, which run on the view too), each with a passing and a failing fixture in tests/blocks.test.mjs:
| Rule | Level | SysML v1.7 |
|---|---|---|
part-type | warning | clause 8: a part or reference property is typed by a block (a name of no element is fine, model.md rule 11) |
value-type | warning | clause 8: a value property is typed by a value type (Real, Integer, Boolean, String fine) |
constraint-type | error; a warning when the type names nothing, as after its constraint block is deleted | clause 10: a constraint property is typed by a constraint block |
flow-direction | error | clause 9, FlowProperty: its direction is in, out or inout |
port-kind | error | clause 9's constraints on ProxyPort and FullPort: a proxy port is typed by an interface block, a full port is not. Settled as an error, as the note recommends ("(confirm)": both constraints are SysML's, on the stereotypes) |
member-kinds | error | clause 10: a constraint block owns only parameters and constraint properties; clause 9: an interface block owns no part, and only flow properties, proxy ports and operations here; a value type only values and operations (clause 8: a data type) |
general-kinds | error | a generalization joins two elements of one SysML kind |
part-agrees, part-unlisted | warning | the subset's: a part stored twice agrees with itself |
The class type's generalization-kinds leaves a generalization with an end of another notation (a SysML block) to that notation's rule (S20, a change stated in 0.25.0's notes).
Departures from SysML v1.7:
- A part stored two ways (a member and a composite association end) must agree; SysML has one element for both.
- A frame with no subject names
[Model]and the model's title (as the requirement diagram's). - An interface block is held to flow properties, proxy ports and operations; SysML may allow it value and reference properties too. The narrower list is the subset's (a gap below).
- A row whose kind or direction is none of SysML's is printed as stored, so it does not parse back unchanged.
Left out
notes/milestone-3.md §17: ports drawn on a block's border on a bdd (they are a compartment); the compartments properties, namespace, structure and receptions; directed features (prov, req); nested ports; stereotype icons; «unit» and «quantityKind» elements (units are text); bound references; operation bodies; signal receptions; association blocks. And copy and paste, XMI, a reader.
Layout limits, measured on examples/ebike-blocks.json and tests/block-definition-stress.json:
repair: false,reroute: false; a generalization ranks the general first. A bdd draws only the class type's lines: a model whose internal block or parametric views add connectors or bindings between the same blocks would draw them at their owners, so the example's view lists its ownedges(the five lines it draws), and an atlas that joins it draws it as the file does. A gap: the type does not filter model lines by kind; a view with noedgeslist in such a model draws them.- The example lays out clean right and down. The stress file's
edge-casesview (every compartment, a block of 40 rows, a value type with unit and quantity kind, an interface block with each direction, a constraint block owning a constraint property, proxy, full and conjugated ports, a part typed by a value type, a constraint property typed by a block, a flow property in a constraint block, a part drawn also as a disagreeing association, a generalization between a value type and a block, a package holding blocks) is clean right and down; the generatedallview (50 blocks, 57 lines) crosses 54 times right and 50 down, with no other finding.
Writers: what each shows of a block definition diagram
Measured on examples/ebike-blocks.json (0.25.0); the PDF's text read back by tests/cli.py.
| What is drawn | SVG | PNG | Mermaid | |
|---|---|---|---|---|
| Blocks and their titled compartments | Yes; a row longer than the box cut | Yes | Yes, in vectors | No writer |
| The frame and its header | Yes, the header cut to the frame | Yes | Yes | |
| Lines, ends, role and multiplicity | Yes | Yes | Yes | |
| The legend | No | No | Yes, under the picture | |
| Accessible names | Kept on nodes, lines' <title> removed | None | None | |
| Tables | None | None | "Elements": each classifier's compartments as rows (parts: battery: Battery [1]), a constraint block's expression, a value type's unit and quantity kind. "Lines": each line's ends, labels and kind |
Accessibility
Names: "Block EBike, 5 parts, 1 reference, 6 values, 3 constraints"; "Value type Energy, unit = Wh, quantityKind = energy". Text at 4.5:1, lines and outlines at 3:1 in both themes (tests/blocks.html, tests/sysml.html); every gesture has a key (docs/editing.md).
Performance (P1)
tests/sysml-fixtures.test.mjs on tests/block-definition-stress.json's all (50 blocks, 57 lines), CPU, best of seven after a warm-up, on a loaded Apple laptop (14 Nov 2026): a full layout and its SVG 66 ms; a value row added 60 ms; a block renamed 68 ms: under the 100 ms target.
Tests
tests/blocks.test.mjs, tests/blocks.html; tests/block-definition-minimal.json, tests/block-definition-stress.json with tests/sysml-fixtures.test.mjs and tests/sysml.html; tests/sysml.test.mjs (the class rule on SysML generalizations); tests/cli.py; tests/mcp.py.
Gaps: clause numbers inside clauses 8 to 10 were not quoted from SysML v1.7's PDF in this build (the file could not be read here); whether SysML lets an interface block hold value and reference properties is not settled; the type draws every model line between its blocks unless the view lists its edges; deleting a constraint block leaves the constraint properties it typed failing constraint-type (an error on a type naming nothing), risks.md M15.