openuispec 0.1.18 → 0.1.19

package/examples/todo-orbit/openuispec/locales/en.json

@@ -0,0 +1,150 @@
+{
+  "$locale": "en",
+  "$direction": "ltr",
+  "nav.tasks": "Tasks",
+  "nav.analytics": "Analytics",
+  "nav.settings": "Settings",
+  "home.title": "Today, organized",
+  "home.summary": "{open, plural, =0 {Everything is done} one {# task left out of {total}} other {# tasks left out of {total}}}",
+  "home.search_label": "Search tasks",
+  "home.search_placeholder": "Search by title or notes",
+  "home.filter.all": "All",
+  "home.filter.open": "Open",
+  "home.filter.done": "Done",
+  "home.mark_complete": "Mark {title} complete",
+  "home.empty_title": "Nothing to do",
+  "home.empty_body": "Add a task or switch filters to see more items.",
+  "home.new_task": "New task",
+  "analytics.title": "Task analytics",
+  "analytics.subtitle": "Monitor throughput, overdue work, and completion trends.",
+  "analytics.period_week": "Week",
+  "analytics.period_month": "Month",
+  "analytics.period_quarter": "Quarter",
+  "analytics.completed_today": "Completed today",
+  "analytics.open_tasks": "Open tasks",
+  "analytics.overdue_tasks": "Overdue",
+  "analytics.completion_rate": "Completion rate",
+  "analytics.overdue_section": "Overdue review",
+  "analytics.overdue_subtitle": "Tasks that need attention first.",
+  "analytics.trend_subtitle": "Completion trend",
+  "analytics.legend_completed": "Completed",
+  "analytics.legend_created": "Created",
+  "analytics.empty_trend": "No trend data yet.",
+  "analytics.empty_overdue": "No overdue tasks",
+  "analytics.empty_overdue_body": "Everything important is on track.",
+  "task_detail.status": "Status",
+  "task_detail.priority": "Priority",
+  "task_detail.notes": "Notes",
+  "task_detail.due_date": "Due date",
+  "task_detail.no_due_date": "No deadline",
+  "task_detail.created": "Created",
+  "task_detail.updated": "Updated",
+  "task_detail.edit": "Edit task",
+  "task_detail.toggle_status": "Toggle status",
+  "task_detail.more_info": "More info",
+  "task_detail.delete": "Delete task",
+  "task_detail.delete_title": "Delete this task?",
+  "task_detail.delete_message": "This action cannot be undone.",
+  "task_detail.updated_feedback": "Task updated",
+  "task_detail.update_error": "Could not update task",
+  "task_detail.deleted_feedback": "Task deleted",
+  "settings.title": "Preferences",
+  "settings.subtitle": "Adjust language and theme for every platform target.",
+  "settings.language": "Language",
+  "settings.language_en": "English",
+  "settings.language_ru": "Russian",
+  "settings.theme": "Theme",
+  "settings.theme_light": "Light",
+  "settings.theme_dark": "Dark",
+  "settings.reminders": "Due date reminders",
+  "settings.reminders_helper": "Notify me before tasks are due.",
+  "settings.daily_summary": "Daily summary",
+  "settings.daily_summary_helper": "Send a summary of open work each morning.",
+  "settings.automation_title": "Automation",
+  "settings.automation_subtitle": "Create recurring task rules to stress conditional forms and validation.",
+  "settings.automation_create_rule": "Create recurring rule",
+  "settings.save": "Save changes",
+  "settings.saving": "Saving...",
+  "settings.saved": "Preferences updated",
+  "settings.error_title": "Could not update preferences",
+  "recurring_rule.title": "Recurring rule",
+  "recurring_rule.subtitle": "Configure a reusable schedule with conditional inputs and validation.",
+  "recurring_rule.save": "Save rule",
+  "recurring_rule.saving": "Saving...",
+  "recurring_rule.success": "Recurring rule created",
+  "recurring_rule.error_title": "Could not create recurring rule",
+  "recurring_rule.field_name": "Rule name",
+  "recurring_rule.field_name_placeholder": "Daily planning ritual",
+  "recurring_rule.field_confirm_name": "Confirm rule name",
+  "recurring_rule.field_confirm_name_placeholder": "Repeat the rule name",
+  "recurring_rule.field_cadence": "Cadence",
+  "recurring_rule.cadence_daily": "Daily",
+  "recurring_rule.cadence_weekly": "Weekly",
+  "recurring_rule.cadence_monthly": "Monthly",
+  "recurring_rule.field_interval": "Repeat every",
+  "recurring_rule.field_interval_helper": "Use whole numbers between 1 and 30.",
+  "recurring_rule.field_weekday": "Weekday",
+  "recurring_rule.field_month_day": "Day of month",
+  "recurring_rule.field_month_day_helper": "Limited to 28 for portable scheduling.",
+  "recurring_rule.field_start_date": "Start date",
+  "recurring_rule.field_has_end_date": "Set an end date",
+  "recurring_rule.field_has_end_date_helper": "Stop generating tasks after a specific date.",
+  "recurring_rule.field_end_date": "End date",
+  "recurring_rule.field_remind_at": "Reminder time",
+  "recurring_rule.field_remind_at_placeholder": "09:00",
+  "recurring_rule.field_remind_at_helper": "24-hour time in HH:MM format. Shown only when reminders are enabled.",
+  "recurring_rule.field_enable_summary": "Attach daily summary delivery",
+  "recurring_rule.field_enable_summary_helper": "Choose how the summary should be delivered for this rule.",
+  "recurring_rule.field_summary_channel": "Summary channel",
+  "recurring_rule.summary_push": "Push notification",
+  "recurring_rule.summary_email": "Email",
+  "recurring_preview.title": "Upcoming schedule preview",
+  "recurring_preview.empty": "No upcoming dates can be generated from this rule.",
+  "recurring_preview.invalid": "Complete the cadence and date fields to preview the schedule.",
+  "create_task.title": "New task",
+  "create_task.save": "Save",
+  "create_task.saving": "Saving...",
+  "create_task.field_title": "Title",
+  "create_task.field_title_placeholder": "What needs to be done?",
+  "create_task.field_notes": "Notes",
+  "create_task.field_notes_placeholder": "Context, links, or next steps",
+  "create_task.field_priority": "Priority",
+  "create_task.field_due_date": "Due date",
+  "create_task.field_due_date_placeholder": "No deadline",
+  "create_task.success": "Task created",
+  "create_task.error_title": "Could not create task",
+  "edit_task.title": "Edit task",
+  "edit_task.save": "Save",
+  "edit_task.saving": "Saving...",
+  "edit_task.field_title": "Title",
+  "edit_task.field_notes": "Notes",
+  "edit_task.field_priority": "Priority",
+  "edit_task.field_due_date": "Due date",
+  "edit_task.success": "Task saved",
+  "edit_task.error_title": "Could not save task",
+  "priority.low": "Low",
+  "priority.medium": "Medium",
+  "priority.high": "High",
+  "status.open": "Open",
+  "status.done": "Done",
+  "validation.min_length": "Must be at least {min} characters",
+  "validation.min_value": "Must be at least {min}",
+  "validation.max_value": "Must be no more than {max}",
+  "validation.fix_errors": "Fix the highlighted fields before saving.",
+  "validation.rule_name_min_length": "Rule name must be at least {min} characters",
+  "validation.rule_name_reserved": "The default name is reserved. Choose a more specific label.",
+  "validation.rule_name_taken": "A recurring rule with this name already exists.",
+  "validation.match_field": "Fields do not match",
+  "validation.end_date_after_start": "End date must be the same as or later than the start date.",
+  "validation.time_format": "Use a 24-hour time like 09:00",
+  "validation.month_day_max": "Choose a day between 1 and 28",
+  "weekday.mon": "Monday",
+  "weekday.tue": "Tuesday",
+  "weekday.wed": "Wednesday",
+  "weekday.thu": "Thursday",
+  "weekday.fri": "Friday",
+  "weekday.sat": "Saturday",
+  "weekday.sun": "Sunday",
+  "common.cancel": "Cancel",
+  "common.delete": "Delete"
+}

package/examples/todo-orbit/openuispec/locales/ru.json

@@ -0,0 +1,150 @@
+{
+  "$locale": "ru",
+  "$direction": "ltr",
+  "nav.tasks": "Задачи",
+  "nav.analytics": "Аналитика",
+  "nav.settings": "Настройки",
+  "home.title": "Сегодня все под контролем",
+  "home.summary": "{open, plural, =0 {Все задачи закрыты} one {Осталась # задача из {total}} few {Осталось # задачи из {total}} many {Осталось # задач из {total}} other {Осталось # задачи из {total}}}",
+  "home.search_label": "Поиск задач",
+  "home.search_placeholder": "Искать по названию или заметкам",
+  "home.filter.all": "Все",
+  "home.filter.open": "Открытые",
+  "home.filter.done": "Выполненные",
+  "home.mark_complete": "Отметить задачу «{title}» выполненной",
+  "home.empty_title": "Список пуст",
+  "home.empty_body": "Добавьте задачу или смените фильтр, чтобы увидеть элементы.",
+  "home.new_task": "Новая задача",
+  "analytics.title": "Аналитика задач",
+  "analytics.subtitle": "Следите за выполнением, просроченными задачами и динамикой.",
+  "analytics.period_week": "Неделя",
+  "analytics.period_month": "Месяц",
+  "analytics.period_quarter": "Квартал",
+  "analytics.completed_today": "Выполнено сегодня",
+  "analytics.open_tasks": "Открытые задачи",
+  "analytics.overdue_tasks": "Просрочено",
+  "analytics.completion_rate": "Процент выполнения",
+  "analytics.overdue_section": "Просроченные задачи",
+  "analytics.overdue_subtitle": "Задачи, которым нужно уделить внимание в первую очередь.",
+  "analytics.trend_subtitle": "Динамика выполнения",
+  "analytics.legend_completed": "Выполнено",
+  "analytics.legend_created": "Создано",
+  "analytics.empty_trend": "Данные тренда пока отсутствуют.",
+  "analytics.empty_overdue": "Просроченных задач нет",
+  "analytics.empty_overdue_body": "Все важные задачи идут по плану.",
+  "task_detail.status": "Статус",
+  "task_detail.priority": "Приоритет",
+  "task_detail.notes": "Заметки",
+  "task_detail.due_date": "Срок",
+  "task_detail.no_due_date": "Без срока",
+  "task_detail.created": "Создано",
+  "task_detail.updated": "Обновлено",
+  "task_detail.edit": "Редактировать задачу",
+  "task_detail.toggle_status": "Сменить статус",
+  "task_detail.more_info": "Подробнее",
+  "task_detail.delete": "Удалить задачу",
+  "task_detail.delete_title": "Удалить эту задачу?",
+  "task_detail.delete_message": "Это действие нельзя отменить.",
+  "task_detail.updated_feedback": "Задача обновлена",
+  "task_detail.update_error": "Не удалось обновить задачу",
+  "task_detail.deleted_feedback": "Задача удалена",
+  "settings.title": "Параметры",
+  "settings.subtitle": "Измените язык и тему для всех целевых платформ.",
+  "settings.language": "Язык",
+  "settings.language_en": "Английский",
+  "settings.language_ru": "Русский",
+  "settings.theme": "Тема",
+  "settings.theme_light": "Светлая",
+  "settings.theme_dark": "Тёмная",
+  "settings.reminders": "Напоминания о сроках",
+  "settings.reminders_helper": "Уведомлять перед наступлением срока задачи.",
+  "settings.daily_summary": "Ежедневная сводка",
+  "settings.daily_summary_helper": "Присылать утреннюю сводку по открытым задачам.",
+  "settings.automation_title": "Автоматизация",
+  "settings.automation_subtitle": "Создавайте повторяющиеся правила задач, чтобы проверить условные формы и валидацию.",
+  "settings.automation_create_rule": "Создать правило",
+  "settings.save": "Сохранить",
+  "settings.saving": "Сохранение...",
+  "settings.saved": "Параметры обновлены",
+  "settings.error_title": "Не удалось обновить параметры",
+  "recurring_rule.title": "Повторяющееся правило",
+  "recurring_rule.subtitle": "Настройте расписание с условными полями и валидацией.",
+  "recurring_rule.save": "Сохранить правило",
+  "recurring_rule.saving": "Сохранение...",
+  "recurring_rule.success": "Повторяющееся правило создано",
+  "recurring_rule.error_title": "Не удалось создать правило",
+  "recurring_rule.field_name": "Название правила",
+  "recurring_rule.field_name_placeholder": "Ежедневный ритуал планирования",
+  "recurring_rule.field_confirm_name": "Подтвердите название",
+  "recurring_rule.field_confirm_name_placeholder": "Повторите название правила",
+  "recurring_rule.field_cadence": "Периодичность",
+  "recurring_rule.cadence_daily": "Ежедневно",
+  "recurring_rule.cadence_weekly": "Еженедельно",
+  "recurring_rule.cadence_monthly": "Ежемесячно",
+  "recurring_rule.field_interval": "Повторять каждые",
+  "recurring_rule.field_interval_helper": "Используйте целые числа от 1 до 30.",
+  "recurring_rule.field_weekday": "День недели",
+  "recurring_rule.field_month_day": "День месяца",
+  "recurring_rule.field_month_day_helper": "Ограничено 28 днями для переносимого расписания.",
+  "recurring_rule.field_start_date": "Дата начала",
+  "recurring_rule.field_has_end_date": "Указать дату окончания",
+  "recurring_rule.field_has_end_date_helper": "Прекратить создание задач после определённой даты.",
+  "recurring_rule.field_end_date": "Дата окончания",
+  "recurring_rule.field_remind_at": "Время напоминания",
+  "recurring_rule.field_remind_at_placeholder": "09:00",
+  "recurring_rule.field_remind_at_helper": "24-часовой формат HH:MM. Поле показывается, только если напоминания включены.",
+  "recurring_rule.field_enable_summary": "Добавить ежедневную сводку",
+  "recurring_rule.field_enable_summary_helper": "Выберите способ доставки сводки для этого правила.",
+  "recurring_rule.field_summary_channel": "Канал сводки",
+  "recurring_rule.summary_push": "Push-уведомление",
+  "recurring_rule.summary_email": "Электронная почта",
+  "recurring_preview.title": "Предпросмотр расписания",
+  "recurring_preview.empty": "Для этого правила не удаётся сформировать будущие даты.",
+  "recurring_preview.invalid": "Заполните периодичность и даты, чтобы увидеть предпросмотр расписания.",
+  "create_task.title": "Новая задача",
+  "create_task.save": "Сохранить",
+  "create_task.saving": "Сохранение...",
+  "create_task.field_title": "Название",
+  "create_task.field_title_placeholder": "Что нужно сделать?",
+  "create_task.field_notes": "Заметки",
+  "create_task.field_notes_placeholder": "Контекст, ссылки или следующие шаги",
+  "create_task.field_priority": "Приоритет",
+  "create_task.field_due_date": "Срок",
+  "create_task.field_due_date_placeholder": "Без срока",
+  "create_task.success": "Задача создана",
+  "create_task.error_title": "Не удалось создать задачу",
+  "edit_task.title": "Редактировать задачу",
+  "edit_task.save": "Сохранить",
+  "edit_task.saving": "Сохранение...",
+  "edit_task.field_title": "Название",
+  "edit_task.field_notes": "Заметки",
+  "edit_task.field_priority": "Приоритет",
+  "edit_task.field_due_date": "Срок",
+  "edit_task.success": "Задача сохранена",
+  "edit_task.error_title": "Не удалось сохранить задачу",
+  "priority.low": "Низкий",
+  "priority.medium": "Средний",
+  "priority.high": "Высокий",
+  "status.open": "Открыта",
+  "status.done": "Выполнена",
+  "validation.min_length": "Минимум {min} символа(ов)",
+  "validation.min_value": "Значение должно быть не меньше {min}",
+  "validation.max_value": "Значение должно быть не больше {max}",
+  "validation.fix_errors": "Исправьте выделенные поля перед сохранением.",
+  "validation.rule_name_min_length": "Название правила должно содержать минимум {min} символа(ов)",
+  "validation.rule_name_reserved": "Название по умолчанию зарезервировано. Укажите более точную метку.",
+  "validation.rule_name_taken": "Правило с таким названием уже существует.",
+  "validation.match_field": "Поля не совпадают",
+  "validation.end_date_after_start": "Дата окончания должна быть не раньше даты начала.",
+  "validation.time_format": "Используйте 24-часовой формат, например 09:00",
+  "validation.month_day_max": "Выберите день от 1 до 28",
+  "weekday.mon": "Понедельник",
+  "weekday.tue": "Вторник",
+  "weekday.wed": "Среда",
+  "weekday.thu": "Четверг",
+  "weekday.fri": "Пятница",
+  "weekday.sat": "Суббота",
+  "weekday.sun": "Воскресенье",
+  "common.cancel": "Отмена",
+  "common.delete": "Удалить"
+}

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

@@ -0,0 +1,122 @@
+# openuispec-sample — OpenUISpec v0.1
+spec_version: "0.1"
+
+project:
+  name: "Todo Orbit"
+  description: "A bilingual todo app spec for testing OpenUISpec generation and drift"
+  icon: "checkmark_list"
+
+includes:
+  tokens: "./tokens/"
+  contracts: "./contracts/"
+  screens: "./screens/"
+  flows: "./flows/"
+  platform: "./platform/"
+  locales: "./locales/"
+
+custom_contracts:
+  - "./contracts/x_task_trend_chart.yaml"
+  - "./contracts/x_schedule_preview.yaml"
+
+i18n:
+  default_locale: "en"
+  supported_locales: [en, ru]
+  fallback_strategy: "default"
+
+generation:
+  targets: [ios, android, web]
+  # output_dir:                          # Optional: map targets to code directories
+  #   ios: "../ios-app/"                  # relative to this file
+  #   android: "../android-app/"
+  #   web: "../web-ui/"
+  output_format:
+    ios: { language: swift, framework: swiftui, min_version: "17.0" }
+    android: { language: kotlin, framework: compose, min_sdk: 26 }
+    web: { language: typescript, framework: react, bundler: vite }
+
+formatters:
+  priority_label:
+    input: enum
+    output: string
+    mapping:
+      low: "$t:priority.low"
+      medium: "$t:priority.medium"
+      high: "$t:priority.high"
+  status_label:
+    input: enum
+    output: string
+    mapping:
+      open: "$t:status.open"
+      done: "$t:status.done"
+
+mappers:
+  task_status_severity:
+    open: info
+    done: success
+  priority_to_severity:
+    low: neutral
+    medium: info
+    high: warning
+
+data_model:
+  task:
+    id: { type: string, format: uuid }
+    title: { type: string, max_length: 160 }
+    notes: { type: string, required: false }
+    status: { type: enum, values: [open, done] }
+    priority: { type: enum, values: [low, medium, high] }
+    due_date: { type: date, required: false }
+    created_at: { type: datetime }
+    updated_at: { type: datetime }
+
+  preferences:
+    locale: { type: enum, values: [en, ru] }
+    theme: { type: enum, values: [light, dark] }
+    reminders_enabled: { type: bool }
+    daily_summary_enabled: { type: bool }
+
+  analytics_snapshot:
+    completed_today: { type: int }
+    open_tasks: { type: int }
+    overdue_tasks: { type: int }
+    completion_rate: { type: float }
+
+  trend_point:
+    label: { type: string }
+    completed: { type: int }
+    created: { type: int }
+
+  recurring_rule:
+    id: { type: string, format: uuid }
+    name: { type: string, max_length: 80 }
+    cadence: { type: enum, values: [daily, weekly, monthly] }
+    interval: { type: int }
+    weekday: { type: enum, values: [mon, tue, wed, thu, fri, sat, sun], required: false }
+    month_day: { type: int, required: false }
+    start_date: { type: date }
+    end_date: { type: date, required: false }
+    remind_at: { type: string, required: false }
+    summary_channel: { type: enum, values: [push, email], required: false }
+
+api:
+  base_url: "/api/v1"
+  auth: "bearer_token"
+  endpoints:
+    tasks:
+      list: { method: GET, path: "/tasks", params: [filter, search] }
+      getById: { method: GET, path: "/tasks/:id" }
+      create: { method: POST, path: "/tasks", body: "task" }
+      update: { method: PATCH, path: "/tasks/:id", body: "task" }
+      toggleStatus: { method: PATCH, path: "/tasks/:id/status" }
+      delete: { method: DELETE, path: "/tasks/:id" }
+      counts: { method: GET, path: "/tasks/counts" }
+    preferences:
+      get: { method: GET, path: "/preferences" }
+      update: { method: PATCH, path: "/preferences", body: "preferences" }
+    analytics:
+      overview: { method: GET, path: "/analytics/overview", params: [period] }
+      trend: { method: GET, path: "/analytics/trend", params: [period] }
+      overdue: { method: GET, path: "/analytics/overdue", params: [limit] }
+    recurring:
+      create: { method: POST, path: "/recurring-rules", body: "recurring_rule" }
+      checkName: { method: GET, path: "/recurring-rules/check-name", params: [value] }

package/examples/todo-orbit/openuispec/platform/android.yaml

@@ -0,0 +1,19 @@
+android:
+  framework: compose
+  language: kotlin
+  min_sdk: 26
+
+  overrides:
+    x_task_trend_chart:
+      compact: { uses_canvas_rendering: true }
+      detail: { uses_canvas_rendering: true, supports_pointer_highlight: true }
+    x_schedule_preview:
+      compact: { uses_lazy_column: true }
+      detail: { uses_lazy_column: true, supports_animated_content: true }
+
+  behaviors:
+    dynamic_type: true
+
+  generation:
+    architecture: "MVVM"
+    naming: "Kotlin conventions"

package/examples/todo-orbit/openuispec/platform/ios.yaml

@@ -0,0 +1,20 @@
+ios:
+  framework: swiftui
+  min_version: "17.0"
+
+  overrides:
+    x_task_trend_chart:
+      compact: { uses_native_chart_framework: true }
+      detail: { uses_native_chart_framework: true, supports_rule_mark: true }
+    x_schedule_preview:
+      compact: { uses_timeline_view: true }
+      detail: { uses_timeline_view: true, supports_content_transition: true }
+
+  behaviors:
+    dynamic_type: true
+    safe_area_respect: true
+
+  generation:
+    imports: ["SwiftUI", "Foundation"]
+    architecture: "MVVM with @Observable"
+    naming: "Swift conventions"

package/examples/todo-orbit/openuispec/platform/web.yaml

@@ -0,0 +1,22 @@
+web:
+  framework: react
+  language: typescript
+
+  overrides:
+    x_task_trend_chart:
+      compact: { implementation: "svg", responsive: true }
+      detail: { implementation: "svg", responsive: true, supports_tooltip: true }
+    x_schedule_preview:
+      compact: { implementation: "semantic_list", responsive: true }
+      detail: { implementation: "semantic_list", responsive: true, supports_staggered_updates: true }
+
+  behaviors:
+    prefers_color_scheme: true
+    keyboard_navigation: true
+
+  generation:
+    bundler: "vite"
+    css: "custom_css"
+    routing: "react_router"
+    state: "zustand"
+    naming: "React conventions"

package/examples/todo-orbit/openuispec/screens/analytics.yaml

@@ -0,0 +1,139 @@
+analytics:
+  semantic: "Analytics dashboard for productivity trends, weekly completion, and overdue task review"
+  status: ready
+
+  data:
+    overview:
+      source: "api.analytics.overview"
+      params: { period: "state.period" }
+    trend:
+      source: "api.analytics.trend"
+      params: { period: "state.period" }
+    overdue:
+      source: "api.analytics.overdue"
+      params: { limit: 10 }
+
+  state:
+    period:
+      type: enum
+      values: [week, month, quarter]
+      default: week
+
+  navigation:
+    contract: nav_container
+    props:
+      items:
+        - id: "tasks"
+          label: "$t:nav.tasks"
+          icon: "checkmark_list"
+          icon_active: "checkmark_list_fill"
+          destination: "screens/home"
+        - id: "analytics"
+          label: "$t:nav.analytics"
+          icon: "chart_line"
+          icon_active: "chart_line_fill"
+          destination: "screens/analytics"
+        - id: "settings"
+          label: "$t:nav.settings"
+          icon: "gear"
+          icon_active: "gear_fill"
+          destination: "screens/settings"
+      selected: "analytics"
+    adaptive:
+      compact: { variant: tab_bar }
+      regular: { variant: rail }
+      expanded: { variant: sidebar, collapsed: false }
+
+  layout:
+    type: scroll_vertical
+    safe_area: true
+    padding: "spacing.page_margin"
+    sections:
+      - id: header
+        layout: { type: stack, spacing: "spacing.sm" }
+        children:
+          - contract: data_display
+            variant: inline
+            props:
+              title: "$t:analytics.title"
+              subtitle: "$t:analytics.subtitle"
+            tokens_override:
+              title_style: "typography.heading_lg"
+              subtitle_style: "typography.body_sm"
+
+      - id: period_filter
+        margin_top: "spacing.md"
+        contract: collection
+        variant: chips
+        props:
+          data:
+            - { id: "week", label: "$t:analytics.period_week" }
+            - { id: "month", label: "$t:analytics.period_month" }
+            - { id: "quarter", label: "$t:analytics.period_quarter" }
+          item_contract: action_trigger
+          item_variant: ghost
+          item_props_map:
+            label: "item.label"
+          selectable: true
+          selection_mode: single
+          selected: "state.period"
+        action:
+          type: set_state
+          target: "state.period"
+          value: "item.id"
+
+      - id: stats
+        margin_top: "spacing.lg"
+        contract: collection
+        variant: grid
+        props:
+          data:
+            - { id: "completed", title: "$t:analytics.completed_today", value: "overview.completed_today" }
+            - { id: "open", title: "$t:analytics.open_tasks", value: "overview.open_tasks" }
+            - { id: "overdue", title: "$t:analytics.overdue_tasks", value: "overview.overdue_tasks" }
+            - { id: "rate", title: "$t:analytics.completion_rate", value: "overview.completion_rate" }
+          item_contract: data_display
+          item_variant: stat
+          item_props_map:
+            title: "item.title"
+            body: "item.value"
+          columns: 2
+
+      - id: trend_chart
+        margin_top: "spacing.lg"
+        contract: x_task_trend_chart
+        variant: detail
+        props:
+          series: "trend"
+          metric: completed
+          period: "state.period"
+          show_legend: true
+          empty_message: "$t:analytics.empty_trend"
+
+      - id: overdue_header
+        margin_top: "spacing.xl"
+        contract: data_display
+        variant: inline
+        props:
+          title: "$t:analytics.overdue_section"
+          subtitle: "$t:analytics.overdue_subtitle"
+        tokens_override:
+          title_style: "typography.heading"
+          subtitle_style: "typography.body_sm"
+
+      - id: overdue_table
+        margin_top: "spacing.sm"
+        contract: collection
+        variant: table
+        props:
+          data: "overdue"
+          item_contract: data_display
+          item_variant: compact
+          item_props_map:
+            title: "item.title"
+            subtitle: "{item.priority | format:priority_label}"
+            trailing: "item.due_date"
+          empty_state:
+            icon: "checkmark_circle_fill"
+            title: "$t:analytics.empty_overdue"
+            body: "$t:analytics.empty_overdue_body"