openuispec 0.2.13 → 0.2.14

package/examples/taskflow/openuispec/contracts/x_media_player.yaml

@@ -1,185 +0,0 @@
-# ============================================================
-# Custom Contract: x_media_player
-# ============================================================
-# A media playback contract for audio and video content.
-# Demonstrates the custom contract extension mechanism
-# (see spec Section 12).
-# ============================================================
-
-x_media_player:
-  semantic: "Plays audio and video media with transport controls, state management, and platform-native playback"
-
-  props:
-    source: { type: string, required: true, description: "Media URL or asset path" }
-    media_type:
-      type: enum
-      values: [audio, video]
-      required: true
-      description: "Type of media content"
-    variant:
-      type: enum
-      values: [inline, fullscreen, mini]
-      default: inline
-      description: "Player presentation style"
-    autoplay: { type: bool, default: false, description: "Begin playback automatically when source loads" }
-    loop: { type: bool, default: false, description: "Restart playback when media ends" }
-    show_controls: { type: bool, default: true, description: "Display transport controls" }
-    poster: { type: media_ref, required: false, description: "Preview image shown before playback (video only)" }
-    title: { type: string, required: false, description: "Media title for display and accessibility" }
-    subtitle: { type: string, required: false, description: "Secondary text (artist, channel, etc.)" }
-    playback_rate: { type: enum, values: ["0.5", "0.75", "1", "1.25", "1.5", "2"], default: "1", description: "Playback speed multiplier" }
-    muted: { type: bool, default: false, description: "Start with audio muted" }
-
-  states:
-    idle:
-      semantic: "No media loaded or playback not started"
-      transitions_to: [loading]
-      visual: "Shows poster image or placeholder; controls hidden or minimal"
-    loading:
-      semantic: "Media source is buffering"
-      transitions_to: [playing, error]
-      duration: "motion.standard"
-      feedback: "Loading indicator visible"
-      visual: "Spinner or progress bar overlaid on poster"
-    playing:
-      semantic: "Media is actively playing"
-      transitions_to: [paused, ended, loading, error]
-      behavior: "Progress bar advances, elapsed time updates"
-      visual: "Active playback with visible progress and controls"
-    paused:
-      semantic: "Playback is paused at current position"
-      transitions_to: [playing, loading]
-      visual: "Frozen frame (video) or paused waveform (audio); play button prominent"
-    ended:
-      semantic: "Playback reached the end of the media"
-      transitions_to: [playing, loading]
-      behavior: "If loop is true, transitions to playing automatically"
-      visual: "Replay button visible; poster or last frame shown"
-    error:
-      semantic: "Media failed to load or playback encountered an error"
-      transitions_to: [loading]
-      feedback: "Error message displayed with retry option"
-      visual: "Error icon and message; retry button visible"
-
-  a11y:
-    role: "media"
-    label: "props.title"
-    traits:
-      playing: { announces: "Playing" }
-      paused: { announces: "Paused" }
-      loading: { announces: "Loading media" }
-      error: { announces: "Media playback error" }
-    focus:
-      keyboard:
-        play_pause: "Space"
-        seek_forward: "ArrowRight"
-        seek_backward: "ArrowLeft"
-        volume_up: "ArrowUp"
-        volume_down: "ArrowDown"
-        fullscreen: "f"
-        mute: "m"
-
-  tokens:
-    inline:
-      min_height: [200, 280]
-      radius: "spacing.md"
-      background: "color.surface.secondary"
-      controls_background: "rgba(0, 0, 0, 0.5)"
-      controls_color: "#FFFFFF"
-      progress_active: "color.brand.primary"
-      progress_inactive: "rgba(255, 255, 255, 0.3)"
-      progress_height: [3, 4]
-      title_style: "typography.caption"
-      subtitle_style: "typography.small"
-    fullscreen:
-      background: "#000000"
-      controls_background: "rgba(0, 0, 0, 0.6)"
-      controls_color: "#FFFFFF"
-      progress_active: "color.brand.primary"
-      progress_inactive: "rgba(255, 255, 255, 0.3)"
-      progress_height: [4, 6]
-      title_style: "typography.subtitle"
-      subtitle_style: "typography.body"
-    mini:
-      height: [48, 64]
-      radius: "spacing.sm"
-      background: "color.surface.secondary"
-      progress_active: "color.brand.primary"
-      progress_height: [2, 3]
-      title_style: "typography.caption"
-
-  platform_mapping:
-    ios:
-      inline: { component: "VideoPlayer", framework: "AVKit" }
-      fullscreen: { component: "AVPlayerViewController", framework: "AVKit" }
-      mini: { component: "Custom mini player view", framework: "AVKit" }
-      audio: { component: "Custom audio player", framework: "AVFoundation" }
-    android:
-      inline: { component: "PlayerView", library: "androidx.media3" }
-      fullscreen: { component: "PlayerView (fullscreen activity)", library: "androidx.media3" }
-      mini: { component: "Custom mini player composable", library: "androidx.media3" }
-      audio: { component: "PlayerView (audio mode)", library: "androidx.media3" }
-    web:
-      inline: { element: "video", fallback: "audio" }
-      fullscreen: { element: "video", api: "Fullscreen API" }
-      mini: { element: "Custom mini player component" }
-      audio: { element: "audio" }
-
-  dependencies:
-    ios:
-      frameworks: [AVKit, AVFoundation]
-    android:
-      libraries: ["androidx.media3:media3-ui", "androidx.media3:media3-exoplayer"]
-    web:
-      packages: []
-
-  generation:
-    must_handle:
-      - "All 6 states (idle, loading, playing, paused, ended, error) with correct transitions"
-      - "Keyboard shortcuts for accessibility (Space, arrows, f, m)"
-      - "Poster/placeholder display in idle state"
-      - "Error state with retry action"
-      - "Platform-native player component per platform_mapping"
-    should_handle:
-      - "Playback rate selection UI"
-      - "Progress bar with seek interaction"
-      - "Volume control"
-      - "Elapsed / remaining time display"
-      - "Mini variant with compact controls"
-    may_handle:
-      - "Picture-in-picture support (iOS, web)"
-      - "AirPlay / Cast integration"
-      - "Subtitle / closed caption support"
-      - "Background audio playback"
-      - "Gesture controls (swipe to seek, pinch to zoom)"
-
-  test_cases:
-    - id: play_pause_toggle
-      description: "Tapping play starts playback; tapping pause freezes it"
-      given: "Player is in idle state with a valid source"
-      when: "User taps the play button"
-      then: "State transitions to loading, then playing; tapping pause transitions to paused"
-
-    - id: error_retry
-      description: "Failed media shows error with retry"
-      given: "Player source URL is unreachable"
-      when: "Player attempts to load the media"
-      then: "State transitions to error; retry button is visible; tapping retry transitions to loading"
-
-    - id: ended_loop
-      description: "Loop restarts playback at end"
-      given: "Player is playing with loop=true"
-      when: "Media reaches the end"
-      then: "State transitions to playing from the beginning without user interaction"
-
-    - id: keyboard_controls
-      description: "Keyboard shortcuts control playback"
-      given: "Player is focused and in playing state"
-      when: "User presses Space"
-      then: "State transitions to paused; pressing Space again transitions to playing"
-
-    - id: fullscreen_variant
-      description: "Fullscreen variant fills the viewport"
-      given: "Player variant is fullscreen"
-      when: "Player renders"
-      then: "Player fills the screen with black background; controls overlay the content"

package/examples/todo-orbit/openuispec/contracts/x_task_trend_chart.yaml

@@ -1,139 +0,0 @@
-x_task_trend_chart:
-  semantic: "Visualizes task creation and completion trends over time for productivity analysis"
-
-  props:
-    series: { type: "list<trend_point>", required: true, description: "Ordered trend points for the selected period" }
-    metric:
-      type: enum
-      values: [completed, created, completion_rate]
-      required: true
-      description: "Primary metric emphasized in the chart"
-    period:
-      type: enum
-      values: [week, month, quarter]
-      required: true
-      description: "Time range represented by the chart"
-    variant:
-      type: enum
-      values: [compact, detail]
-      default: compact
-      description: "Chart presentation density"
-    highlighted_index: { type: int, required: false, description: "Optional highlighted datapoint" }
-    show_legend: { type: bool, default: true, description: "Whether to render a legend for created/completed series" }
-    empty_message: { type: string, required: false, description: "Message to show when series is empty" }
-
-  states:
-    idle:
-      semantic: "Chart has not loaded data yet"
-      transitions_to: [loading]
-      visual: "Reserved chart frame with no plotted data"
-    loading:
-      semantic: "Trend data is loading"
-      transitions_to: [ready, empty, error]
-      feedback: "Skeleton chart and loading copy shown"
-      visual: "Placeholder bars or line skeleton"
-    ready:
-      semantic: "Trend data is available and rendered"
-      transitions_to: [highlighted, loading, error]
-      behavior: "Chart axes, series, and legend are visible"
-    highlighted:
-      semantic: "One datapoint is emphasized"
-      transitions_to: [ready]
-      behavior: "Highlighted datapoint shows stronger color and tooltip/callout"
-    empty:
-      semantic: "No trend points available"
-      transitions_to: [loading]
-      feedback: "Empty analytics message displayed"
-      visual: "Empty state in chart container"
-    error:
-      semantic: "Trend data failed to load"
-      transitions_to: [loading]
-      feedback: "Inline error with retry affordance"
-      visual: "Error indicator in chart container"
-
-  a11y:
-    role: "img"
-    label: "Analytics trend chart"
-    traits:
-      loading: { announces: "Loading analytics chart" }
-      empty: { announces: "No analytics data available" }
-      error: { announces: "Analytics chart failed to load" }
-    focus:
-      keyboard:
-        next_point: "ArrowRight"
-        previous_point: "ArrowLeft"
-        details: "Enter"
-
-  tokens:
-    compact:
-      min_height: 220
-      padding: "spacing.md"
-      background: "color.surface.secondary"
-      border: { width: 1, color: "color.border.default" }
-      radius: "spacing.sm"
-      axis_color: "color.text.tertiary"
-      completed_color: "color.brand.primary"
-      created_color: "color.brand.secondary"
-      grid_color: "color.border.default"
-      label_style: "typography.caption"
-    detail:
-      min_height: 320
-      padding: "spacing.lg"
-      background: "color.surface.primary"
-      border: { width: 1, color: "color.border.default" }
-      radius: "spacing.sm"
-      axis_color: "color.text.tertiary"
-      completed_color: "color.brand.primary"
-      created_color: "color.brand.secondary"
-      grid_color: "color.border.default"
-      label_style: "typography.body_sm"
-
-  platform_mapping:
-    ios:
-      compact: { component: "Chart", framework: "Swift Charts" }
-      detail: { component: "Chart", framework: "Swift Charts" }
-    android:
-      compact: { component: "Canvas chart composable", library: "custom compose drawing" }
-      detail: { component: "Canvas chart composable", library: "custom compose drawing" }
-    web:
-      compact: { component: "SVG chart component" }
-      detail: { component: "SVG chart component" }
-
-  dependencies:
-    ios:
-      frameworks: ["Charts"]
-    android:
-      libraries: []
-    web:
-      packages: []
-
-  generation:
-    must_handle:
-      - "Render completed and created series for the supplied period"
-      - "Respect compact and detail variants with different density"
-      - "Provide accessible summary text for the focused datapoint"
-      - "Handle loading, empty, and error states in the chart container"
-    should_handle:
-      - "Animate transitions when highlighted_index changes"
-      - "Render a legend when show_legend is true"
-      - "Support touch and pointer hover highlighting"
-    may_handle:
-      - "Tooltips for datapoints"
-      - "Trend delta badges and annotations"
-
-  test_cases:
-    - id: ready_state_renders_series
-      description: "Chart renders series lines or bars when data is present"
-      given: "Chart receives 7 trend points for period week"
-      when: "The component enters ready state"
-      then: "Both created and completed series are visible with labels and axes"
-    - id: empty_state_message
-      description: "Chart shows an empty message when no data exists"
-      given: "Chart receives an empty series"
-      when: "The component enters empty state"
-      then: "The empty_message or default empty copy is rendered in the chart frame"
-    - id: highlighted_point
-      description: "Highlighted point receives emphasis"
-      given: "Chart is in ready state with highlighted_index set"
-      when: "The highlighted datapoint is rendered"
-      then: "That datapoint is visually emphasized and exposed to accessibility"