StandardReferences class
The provenance recorded by @StandardReferences(standards, connotation):
which public standard(s) a section or field derives from, and what the
section means.
Distinct from the author-facing @ContentHelp guidance — connotation
states intent and ownership ("what this section is"), not "how to fill it
in". The exporter emits it as a curated top-level key rather than leaving it
to be dug out of the annotation list, so this reads that key.
Constructors
-
StandardReferences({List<
String> standards = const [], String? connotation}) -
Both halves are optional and independent:
@StandardReferencesis used both to cite standards without glossing them and to state aconnotationfor a node that traces to no published standard, so neither can be required without rejecting a legitimate annotation.const
Properties
- connotation → String?
-
What the section means — its intent / what it owns.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
standards
→ List<
String> -
The standards this node traces back to; each entry is the standard's ID
plus the clause in the standard's own wording.
final
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
fromJson(
Object? raw) → StandardReferences? -
Returns
nullfor a missing block, so absent provenance stays distinguishable from provenance recorded as empty.