Tooltip

$schema: https://thewyrdingway.dev/schemas/component-contract.schema.ymlcontractVersion: 0.1.0identity:  name: Tooltip  tag: wyrd-tooltip  package: wyrd.component.tooltip  title: Tooltip  summary: Text-only tooltip shown from a trigger on hover or focus.relationships:  related-to:    - quality-parity-and-gatesclassification:  category: overlay  composition: single-slot  interactive: truetarget-strategy:  react: required  flutter: requiredsurface:  properties:    - name: text      type:        kind: string      required: true      serializable: true      summary: Tooltip message text.    - name: placement      type:        kind: enum        values:          - top          - bottom          - start          - end      required: false      default: top      reflects: true      serializable: true      summary: Preferred tooltip placement relative to the trigger.  slots:    - name: content      required: true      cardinality: exactly-one      accepts:        - component      summary: Trigger component that receives the tooltip description relationship.  events: []  states:    - name: hidden      source: behavior-runtime      summary: Tooltip is not visible.    - name: visible      source: behavior-runtime      summary: Tooltip is visible when the trigger is hovered or focus remains within the wrapper, unless Escape dismissed it.  parts:    - name: root      summary: Positioning wrapper.      slots:        - content    - name: trigger      summary: Trigger wrapper.      slots:        - content    - name: tooltip      summary: Tooltip message surface.  tokens:    background: color.on-surface    foreground: color.surface    radius: rounded.sm    offset: spacing.xsmessages: []obligations:  accessibility:    role: tooltip    name: Text property provides the tooltip message.    keyboard:      - Tab moves focus to the trigger according to the trigger component.      - Escape dismisses a visible tooltip without moving focus.    semantics:      - Web projections expose role=tooltip on the tooltip element.      - The tooltip text is exposed as the trigger's accessible description; light-DOM tooltip targets may use IDREF association, while shadow-root tooltip surfaces use a string description on the light-DOM trigger.      - Tooltip content is not focusable.      - Flutter uses Material Tooltip; bottom maps to preferBelow=true and top/start/end are approximate.  behavior:    model: overlay    interactions:      - The tooltip is visible when hovered or focus remains within the trigger wrapper, unless it has been dismissed.      - Escape dismisses a visible tooltip without moving focus.      - Dismissed state clears on the next mouseenter or focusin.      - The tooltip hides when neither hovered nor focus-within, or while dismissed.      - Positioning uses the package anchoring utility with fixed coordinates, flip, shift, and RTL-aware start/end placement.    hostEffects:      - Recompute fixed coordinates when the tooltip opens and while visible on capture-phase scroll and viewport resize.      - Anchor tracking during layout animations is not guaranteed in v1.  conditions:    - rtl    - reduced-motion    - cvd-deuteranopia    - density-compact    - text-expansion  sdui:    status: serializable    serializableProperties:      - text      - placement    serializableSlots:      - content    eventBindings: []    notes: Tooltip serializes text, preferred placement, and one trigger component. Web projections use collision-aware fixed positioning through the hand-written package positioning utility, so overflow and clipping ancestors do not clip the tooltip surface. V1 does not continuously track anchors during layout animations.examples:  - name: top    state: hidden    properties:      text: More options      placement: top    slots:      content: Options  - name: bottom    state: hidden    properties:      text: Save the current draft      placement: bottom    slots:      content: Save  - name: end    state: hidden    properties:      text: Opens in a new panel      placement: end    slots:      content: Detailsoverrides:  react:    slots:      content: children  flutter:    slots:      content: child