Venn

A Venn diagram. Two or three overlapping circles represent sets. Intersection regions may be labeled. Used for showing set relationships, similarities, and differences.

Fields

FieldRequiredTypeDescription
kindyes"venn"Must be exactly "venn"
titlenostringTitle rendered above the diagram
setsyesarray of Set2 or 3 sets required
intersectionsnoarray of IntersectionLabeled regions in the overlap areas

Set fields

FieldRequiredTypeDescription
labelyesstringName of the set

Intersection fields

FieldRequiredTypeDescription
setsyesarray of stringSet labels identifying which overlap region this labels
labelyesstringText displayed in the overlap region

Rendering rules

  • Circles are arranged to overlap: two sets side-by-side; three sets in a triangle.
  • Each circle is rendered with partial opacity so overlaps are visible.
  • Set labels appear near the outer edge of each circle (non-overlapping region).
  • Intersection labels appear in the center of the overlap region.
  • Exactly 2 or 3 sets are required; other counts are a parse error.

Example

Skills Overlap Venn of Design, Engineering; Design and Engineering overlap: UX Engineering. Skills Overlap Design Engineering UX Engineering

Label capacity

How long a label can be before the engine sets it smaller, wraps it, or cuts it short with "…". Each number is measured by rendering a small reference declaration with a growing label and reading the diagnostics render_detailed returns, so the table always agrees with them. Lengths are in characters written without spaces: Hangul syllables are one em wide, Latin lowercase letters about half that. unchanged is the longest label shown at the usual size on one line; whole is the longest shown without "…". A slot's width depends on its siblings, so read a number as a guide for the reference declaration named in the second column and use declart validate --strict for the declaration itself.

A dash means the engine reports nothing for the slot up to 120 characters. That is not a promise that any length fits: a slot the engine does not fit at all draws a long label past the picture without a warning.

SlotMeasured inHangul (unchanged / whole)Latin (unchanged / whole)
sets[].label2 sets— / —— / —
intersections[].label2 sets— / —— / —

Schema

What a declaration of this kind may contain, as declart schema and schema() report it. The value lists and counts are the ones the parser checks, and a test holds every field, count and rule to the parser in both directions, so a declaration written to this page parses. The prose above is the explanation; this is the reference.

Fields

FieldTypeRequiredValues / meaning
kindenumyesvenn
titlestringno

sets — 2 to 3 elements

FieldTypeRequiredValues / meaning
labelstringyes

intersections — any number of elements

FieldTypeRequiredValues / meaning
setsstring[]yesthe labels of the sets that overlap
labelstringyes