schema_version: 1
id: scroll_view
kind: primitive
marker_or_action: action
version: 1

intent:
  fr: faire defiler la zone active ou un container cible

executor_kind: scroll

parameters_schema:
  direction:
    type: str
    required: true
    description: sens du defilement
    constraints:
      enum: [up, down, left, right]
  amount:
    type: int
    required: false
    default: 3
    description: quantite de defilement en unite
    constraints:
      min: 1
  unit:
    type: str
    required: false
    default: lines
    description: unite de mesure du defilement
    constraints:
      enum: [lines, pixels, pages, percent]
  container_hint:
    type: str
    required: false
    description: ancre ou description du container a scroller; sinon fenetre active

failure_message_template:
  intention: faire defiler la zone active dans la direction attendue
  attendu: le contenu visible doit changer apres le defilement
  vu: "{observed_human_state}"
  demande: confirmer que la fenetre attendue est defilable, ou m'indiquer le container correct

notes:
  - "Aucun success_marker offline fiable n'est porte par la primitive."
  - "La competence appelante doit fournir le contexte et les marqueurs de succes."
  - "direction est volontairement limite a up/down/left/right pour eviter les scrolls composites."
  - "amount=3 lines correspond au defilement molette Windows typique."
  - "container_hint reference une ancre ou description, jamais une coordonnee durable."

created_at: "2026-05-28T11:30:00+02:00"