Skip to main content

Interface: ComponentMeta<E>

Defined in: semantics/componentMeta.ts:21

Layer 1 — Semantic Foundation

Public API: ComponentMeta is the only artifact consumers need. Taxonomy internals (ENTITY_STRUCTURE, ENTITY_EVALUATION, etc.) are available via direct import from './taxonomy' when needed by tests or Layer 2.

Token-projection types (UxContextFor, SurfaceTypeFor) live in ../tokens/projection — not here. The foundation layer is projection-free.

Type Parameters​

Type ParameterDefault type
E extends EntityEntity

Properties​

composition?​

optional composition?: CompositionsFor<E>

Defined in: semantics/componentMeta.ts:41

Slot this component plays inside a parent composition (FSL §4 / §5.4). Present on sub-parts of a composite (e.g. DialogHeading → 'heading', TextFieldLabel → 'label') and on leaf entities participating in a slot (e.g. a confirm Button inside DialogActions → 'primaryAction'). Legality is enforced by ENTITY_COMPOSITION[entity].

consequence?​

optional consequence?: ConsequencesFor<E>

Defined in: semantics/componentMeta.ts:50

Effect on state produced by the interaction (FSL §6). Orthogonal to evaluation — this is what the act does, not how it is voiced. A destructive consequence drives the interaction mechanism (e.g. ConfirmationDialog arming); pairing it with evaluation: 'negative' for color is the author's separate call. Legality is enforced by ENTITY_CONSEQUENCE[entity].

displayName​

displayName: string

Defined in: semantics/componentMeta.ts:23

Display name — used by React DevTools and contract test auto-discovery.

entity​

entity: E

Defined in: semantics/componentMeta.ts:28

FSL Entity Kind — drives which token subtree and legality rules apply.

See​

../tokens/CONTRACT.md §1 — Entity → Token Map

structure​

structure: StructuresFor<E>

Defined in: semantics/componentMeta.ts:33

Structural role of the root element.

See​

../tokens/CONTRACT.md §5 — data-part convention