openuispec 0.1.45 → 0.1.47

package/examples/social-app/openuispec/flows/create_post.yaml

@@ -0,0 +1,66 @@
+create_post:
+  semantic: "Single-step flow to compose and publish a new post"
+  entry: "compose"
+
+  screens:
+    compose:
+      screen_inline:
+        semantic: "Post composition form with text, media, and audience selection"
+
+        state:
+          body: { type: string, default: "" }
+          media: { type: string, default: "" }
+          audience: { type: string, default: "public" }
+
+        layout:
+          type: scroll_vertical
+          sections:
+            - id: form
+              form_id: "post_form"
+              children:
+                - contract: input_field
+                  input_type: text
+                  props:
+                    label: "$t:create_post.body_placeholder"
+                    value: "state.body"
+                    multiline: true
+                    max_length: 4000
+                  data_binding: "form.body"
+
+                - contract: input_field
+                  input_type: select
+                  props:
+                    label: "$t:create_post.audience"
+                    value: "state.audience"
+                    options:
+                      - { value: "public", label: "$t:create_post.audience_public" }
+                      - { value: "followers", label: "$t:create_post.audience_followers" }
+                  data_binding: "form.audience"
+
+            - id: media_bar
+              contract: action_trigger
+              variant: secondary
+              props:
+                label: "$t:create_post.add_image"
+                icon: "image"
+              action:
+                type: share
+                content: "media_picker"
+
+            - id: publish_button
+              contract: action_trigger
+              variant: primary
+              props:
+                label: "$t:create_post.publish"
+                full_width: true
+              action:
+                type: sequence
+                actions:
+                  - type: api_call
+                    endpoint: "api.posts.create"
+                    body:
+                      body: "form.body"
+                      media: "form.media"
+                      audience: "form.audience"
+                  - { type: feedback, variant: toast, message: "$t:create_post.success" }
+                  - { type: dismiss }

package/examples/social-app/openuispec/locales/en.json

@@ -0,0 +1,67 @@
+{
+  "$locale": "en",
+  "$direction": "ltr",
+  "nav.home": "Home",
+  "nav.discover": "Discover",
+  "nav.create": "Create",
+  "nav.notifications": "Notifications",
+  "nav.profile": "Profile",
+  "home.filter_all": "All",
+  "home.filter_following": "Following",
+  "home.filter_popular": "Popular",
+  "home.empty_feed": "No posts yet. Follow people to see their posts here.",
+  "discover.search_placeholder": "Search posts, people, tags…",
+  "discover.trending": "Trending",
+  "discover.popular_tags": "Popular Tags",
+  "discover.suggested_creators": "Suggested Creators",
+  "search.placeholder": "Search…",
+  "search.tab_posts": "Posts",
+  "search.tab_people": "People",
+  "search.tab_tags": "Tags",
+  "search.no_results": "No results found.",
+  "post.comments_header": "Comments",
+  "post.no_comments": "No comments yet. Be the first to comment.",
+  "post.comment_placeholder": "Write a comment…",
+  "post.comment_sent": "Comment posted.",
+  "post.like_action": "Like",
+  "profile.edit_button": "Edit Profile",
+  "profile.follow_button": "Follow",
+  "profile.posts_header": "Posts",
+  "profile.no_posts_self": "You haven't posted anything yet.",
+  "profile.no_posts_user": "This user hasn't posted anything yet.",
+  "edit_profile.avatar": "Profile Photo",
+  "edit_profile.display_name": "Display Name",
+  "edit_profile.handle": "Username",
+  "edit_profile.bio": "Bio",
+  "edit_profile.website": "Website",
+  "edit_profile.save": "Save Changes",
+  "edit_profile.saved": "Profile updated.",
+  "notifications.empty": "No notifications yet.",
+  "messages.search_placeholder": "Search conversations…",
+  "messages.empty_inbox": "No conversations yet.",
+  "chat.message_placeholder": "Type a message…",
+  "chat.empty_thread": "Start the conversation.",
+  "create_post.body_placeholder": "What's on your mind?",
+  "create_post.audience": "Audience",
+  "create_post.audience_public": "Public",
+  "create_post.audience_followers": "Followers Only",
+  "create_post.add_image": "Add Image",
+  "create_post.take_photo": "Take Photo",
+  "create_post.publish": "Publish",
+  "create_post.success": "Post published!",
+  "settings.appearance": "Appearance",
+  "settings.theme": "Theme",
+  "settings.theme_system": "System",
+  "settings.theme_light": "Light",
+  "settings.theme_dark": "Dark",
+  "settings.notifications": "Notifications",
+  "settings.push_notifications": "Push Notifications",
+  "settings.message_previews": "Message Previews",
+  "settings.language": "Language",
+  "settings.auto_translate": "Auto-translate Posts",
+  "settings.account": "Account",
+  "settings.edit_profile": "Edit Profile",
+  "settings.logout": "Log Out",
+  "settings.logout_confirm": "Are you sure you want to log out?",
+  "common.cancel": "Cancel"
+}

package/examples/social-app/openuispec/locales/ru.json

@@ -0,0 +1,67 @@
+{
+  "$locale": "ru",
+  "$direction": "ltr",
+  "nav.home": "Главная",
+  "nav.discover": "Обзор",
+  "nav.create": "Создать",
+  "nav.notifications": "Уведомления",
+  "nav.profile": "Профиль",
+  "home.filter_all": "Все",
+  "home.filter_following": "Подписки",
+  "home.filter_popular": "Популярное",
+  "home.empty_feed": "Пока нет записей. Подпишитесь на людей, чтобы видеть их публикации.",
+  "discover.search_placeholder": "Поиск записей, людей, тегов…",
+  "discover.trending": "В тренде",
+  "discover.popular_tags": "Популярные теги",
+  "discover.suggested_creators": "Рекомендуемые авторы",
+  "search.placeholder": "Поиск…",
+  "search.tab_posts": "Записи",
+  "search.tab_people": "Люди",
+  "search.tab_tags": "Теги",
+  "search.no_results": "Ничего не найдено.",
+  "post.comments_header": "Комментарии",
+  "post.no_comments": "Пока нет комментариев. Будьте первым.",
+  "post.comment_placeholder": "Написать комментарий…",
+  "post.comment_sent": "Комментарий опубликован.",
+  "post.like_action": "Нравится",
+  "profile.edit_button": "Редактировать",
+  "profile.follow_button": "Подписаться",
+  "profile.posts_header": "Записи",
+  "profile.no_posts_self": "У вас пока нет записей.",
+  "profile.no_posts_user": "У этого пользователя пока нет записей.",
+  "edit_profile.avatar": "Фото профиля",
+  "edit_profile.display_name": "Имя",
+  "edit_profile.handle": "Имя пользователя",
+  "edit_profile.bio": "О себе",
+  "edit_profile.website": "Сайт",
+  "edit_profile.save": "Сохранить",
+  "edit_profile.saved": "Профиль обновлён.",
+  "notifications.empty": "Пока нет уведомлений.",
+  "messages.search_placeholder": "Поиск переписок…",
+  "messages.empty_inbox": "Пока нет переписок.",
+  "chat.message_placeholder": "Написать сообщение…",
+  "chat.empty_thread": "Начните разговор.",
+  "create_post.body_placeholder": "Что у вас нового?",
+  "create_post.audience": "Аудитория",
+  "create_post.audience_public": "Все",
+  "create_post.audience_followers": "Только подписчики",
+  "create_post.add_image": "Добавить фото",
+  "create_post.take_photo": "Сделать фото",
+  "create_post.publish": "Опубликовать",
+  "create_post.success": "Запись опубликована!",
+  "settings.appearance": "Оформление",
+  "settings.theme": "Тема",
+  "settings.theme_system": "Системная",
+  "settings.theme_light": "Светлая",
+  "settings.theme_dark": "Тёмная",
+  "settings.notifications": "Уведомления",
+  "settings.push_notifications": "Push-уведомления",
+  "settings.message_previews": "Превью сообщений",
+  "settings.language": "Язык",
+  "settings.auto_translate": "Автоперевод записей",
+  "settings.account": "Аккаунт",
+  "settings.edit_profile": "Редактировать профиль",
+  "settings.logout": "Выйти",
+  "settings.logout_confirm": "Вы уверены, что хотите выйти?",
+  "common.cancel": "Отмена"
+}

package/examples/social-app/openuispec/locales/uz.json

@@ -0,0 +1,67 @@
+{
+  "$locale": "uz",
+  "$direction": "ltr",
+  "nav.home": "Bosh sahifa",
+  "nav.discover": "Kashfiyot",
+  "nav.create": "Yaratish",
+  "nav.notifications": "Bildirishnomalar",
+  "nav.profile": "Profil",
+  "home.filter_all": "Hammasi",
+  "home.filter_following": "Obunalar",
+  "home.filter_popular": "Ommabop",
+  "home.empty_feed": "Hozircha postlar yoʻq. Postlarini koʻrish uchun odamlarga obuna boʻling.",
+  "discover.search_placeholder": "Postlar, odamlar, teglar qidirish…",
+  "discover.trending": "Trendda",
+  "discover.popular_tags": "Ommabop teglar",
+  "discover.suggested_creators": "Tavsiya etilgan mualliflar",
+  "search.placeholder": "Qidirish…",
+  "search.tab_posts": "Postlar",
+  "search.tab_people": "Odamlar",
+  "search.tab_tags": "Teglar",
+  "search.no_results": "Hech narsa topilmadi.",
+  "post.comments_header": "Izohlar",
+  "post.no_comments": "Hozircha izohlar yoʻq. Birinchi boʻling.",
+  "post.comment_placeholder": "Izoh yozish…",
+  "post.comment_sent": "Izoh joʻnatildi.",
+  "post.like_action": "Yoqtirish",
+  "profile.edit_button": "Tahrirlash",
+  "profile.follow_button": "Obuna boʻlish",
+  "profile.posts_header": "Postlar",
+  "profile.no_posts_self": "Sizda hozircha postlar yoʻq.",
+  "profile.no_posts_user": "Bu foydalanuvchida hozircha postlar yoʻq.",
+  "edit_profile.avatar": "Profil rasmi",
+  "edit_profile.display_name": "Ism",
+  "edit_profile.handle": "Foydalanuvchi nomi",
+  "edit_profile.bio": "Bio",
+  "edit_profile.website": "Veb-sayt",
+  "edit_profile.save": "Saqlash",
+  "edit_profile.saved": "Profil yangilandi.",
+  "notifications.empty": "Hozircha bildirishnomalar yoʻq.",
+  "messages.search_placeholder": "Suhbatlarni qidirish…",
+  "messages.empty_inbox": "Hozircha suhbatlar yoʻq.",
+  "chat.message_placeholder": "Xabar yozish…",
+  "chat.empty_thread": "Suhbatni boshlang.",
+  "create_post.body_placeholder": "Nima yangiliklar?",
+  "create_post.audience": "Auditoriya",
+  "create_post.audience_public": "Hamma",
+  "create_post.audience_followers": "Faqat obunachilar",
+  "create_post.add_image": "Rasm qoʻshish",
+  "create_post.take_photo": "Suratga olish",
+  "create_post.publish": "Eʼlon qilish",
+  "create_post.success": "Post eʼlon qilindi!",
+  "settings.appearance": "Koʻrinish",
+  "settings.theme": "Mavzu",
+  "settings.theme_system": "Tizim",
+  "settings.theme_light": "Yorugʻ",
+  "settings.theme_dark": "Qorongʻu",
+  "settings.notifications": "Bildirishnomalar",
+  "settings.push_notifications": "Push-bildirishnomalar",
+  "settings.message_previews": "Xabar koʻrinishi",
+  "settings.language": "Til",
+  "settings.auto_translate": "Postlarni avtotarjima qilish",
+  "settings.account": "Hisob",
+  "settings.edit_profile": "Profilni tahrirlash",
+  "settings.logout": "Chiqish",
+  "settings.logout_confirm": "Chiqishga ishonchingiz komilmi?",
+  "common.cancel": "Bekor qilish"
+}

package/examples/social-app/openuispec/openuispec.yaml

@@ -0,0 +1,214 @@
+# social-app — OpenUISpec v0.1
+spec_version: "0.1"
+
+project:
+  name: "social-app"
+  description: ""
+
+includes:
+  tokens: "./tokens/"
+  contracts: "./contracts/"
+  screens: "./screens/"
+  flows: "./flows/"
+  platform: "./platform/"
+  locales: "./locales/"
+
+i18n:
+  default_locale: "en"
+  supported_locales: [en, ru, uz]
+  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/"
+  code_roots:
+    backend: "../backend/"                # Required when api.endpoints are declared
+  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 }
+
+data_model:
+  user:
+    id: { type: string, required: true }
+    handle: { type: string, required: true }
+    display_name: { type: string, required: true }
+    avatar_url: { type: string }
+    bio: { type: string }
+
+  post:
+    id: { type: string, required: true }
+    author_id: { type: string, required: true }
+    body: { type: string, required: true, max_length: 4000 }
+    media_url: { type: string }
+    media_type: { type: string, values: [image, video] }
+    like_count: { type: integer, default: 0 }
+    comment_count: { type: integer, default: 0 }
+    published_at: { type: string, format: date-time, required: true }
+
+  comment:
+    id: { type: string, required: true }
+    post_id: { type: string, required: true }
+    author_id: { type: string, required: true }
+    body: { type: string, required: true, max_length: 1200 }
+    created_at: { type: string, format: date-time, required: true }
+
+  story:
+    id: { type: string, required: true }
+    author_id: { type: string, required: true }
+    preview_url: { type: string }
+    active: { type: boolean, default: true }
+
+  conversation:
+    id: { type: string, required: true }
+    title: { type: string }
+    unread_count: { type: integer, default: 0 }
+
+  notification:
+    id: { type: string, required: true }
+    type: { type: string, required: true }
+    actor_id: { type: string }
+    post_id: { type: string }
+    created_at: { type: string, format: date-time, required: true }
+
+  preference:
+    theme: { type: string, values: [system, light, dark], default: system }
+    push_notifications: { type: boolean, default: true }
+    message_previews: { type: boolean, default: true }
+    auto_translate: { type: boolean, default: false }
+
+api:
+  base_url: "/api/v1"
+  auth: "bearer_token"
+  endpoints:
+    feed:
+      list:
+        method: GET
+        path: "/feed"
+        params: [filter, search, cursor]
+      stories:
+        method: GET
+        path: "/feed/stories"
+      summary:
+        method: GET
+        path: "/feed/summary"
+
+    discover:
+      creators:
+        method: GET
+        path: "/discover/creators"
+      trends:
+        method: GET
+        path: "/discover/trends"
+      tags:
+        method: GET
+        path: "/discover/tags"
+      search:
+        method: GET
+        path: "/search"
+        params: [query, tab]
+
+    posts:
+      getById:
+        method: GET
+        path: "/posts/:id"
+        params: [id]
+      comments:
+        method: GET
+        path: "/posts/:id/comments"
+        params: [id]
+      create:
+        method: POST
+        path: "/posts"
+        body:
+          body: string
+          media: string
+          audience: string
+          tags: array
+      toggleLike:
+        method: POST
+        path: "/posts/:id/likes/toggle"
+        params: [id]
+      save:
+        method: POST
+        path: "/posts/:id/save"
+        params: [id]
+
+    notifications:
+      unreadCount:
+        method: GET
+        path: "/notifications/unread-count"
+      list:
+        method: GET
+        path: "/notifications"
+      markRead:
+        method: POST
+        path: "/notifications/:id/read"
+        params: [id]
+
+    profiles:
+      me:
+        method: GET
+        path: "/profiles/me"
+      getById:
+        method: GET
+        path: "/profiles/:id"
+        params: [id]
+      posts:
+        method: GET
+        path: "/profiles/:id/posts"
+        params: [id]
+      myPosts:
+        method: GET
+        path: "/profiles/me/posts"
+      follow:
+        method: POST
+        path: "/profiles/:id/follow"
+        params: [id]
+      updateMe:
+        method: PATCH
+        path: "/profiles/me"
+        body:
+          display_name: string
+          handle: string
+          bio: string
+          website: string
+
+    messages:
+      list:
+        method: GET
+        path: "/messages/conversations"
+        params: [search]
+      getById:
+        method: GET
+        path: "/messages/conversations/:id"
+        params: [id]
+      thread:
+        method: GET
+        path: "/messages/conversations/:id/messages"
+        params: [id]
+      send:
+        method: POST
+        path: "/messages/conversations/:id/messages"
+        params: [id]
+        body:
+          body: string
+      start:
+        method: POST
+        path: "/messages/conversations"
+        body:
+          user_id: string
+
+    preferences:
+      get:
+        method: GET
+        path: "/preferences"
+      update:
+        method: PATCH
+        path: "/preferences"
+        body:
+          key: string
+          value: string

package/examples/social-app/openuispec/platform/android.yaml

@@ -0,0 +1,30 @@
+android:
+  framework: compose
+  generation:
+    naming: Kotlin conventions
+    architecture: decompose
+    state: mvikotlin
+    preferences: datastore
+    database: none
+    di: metro
+    dependencies:
+      - material3
+      - activity-compose
+      - decompose
+      - decompose-compose
+      - essenty-lifecycle
+      - essenty-instance-keeper
+      - mvikotlin
+      - mvikotlin-main
+      - mvikotlin-logging
+      - datastore-preferences
+      - datastore-core
+      - metro
+      - metro-compose
+    stack_confirmation:
+      status: confirmed
+      source: user
+      confirmed_at: 2026-03-15T15:22:41.488Z
+  language: kotlin
+  min_sdk: 26
+  target_sdk: 35

package/examples/social-app/openuispec/platform/ios.yaml

@@ -0,0 +1,19 @@
+ios:
+  framework: swiftui
+  generation:
+    imports:
+      - SwiftUI
+      - Foundation
+    naming: Swift conventions
+    architecture: native swiftui
+    state: "@Observable / @State"
+    persistence: swiftdata
+    di: none
+    dependencies:
+      - swiftdata
+    stack_confirmation:
+      status: confirmed
+      source: user
+      confirmed_at: 2026-03-15T15:22:39.936Z
+  language: swift
+  min_version: "17.0"

package/examples/social-app/openuispec/platform/web.yaml

@@ -0,0 +1,23 @@
+web:
+  framework: react
+  generation:
+    bundler: vite
+    naming: framework conventions
+    runtime: frontend_only
+    css: tailwind
+    routing: react_router
+    state: zustand
+    storage_backend: none
+    dependencies:
+      - vite
+      - typescript
+      - react
+      - react-dom
+      - tailwindcss
+      - react-router
+      - zustand
+    stack_confirmation:
+      status: confirmed
+      source: user
+      confirmed_at: 2026-03-15T15:22:42.766Z
+  language: typescript

package/examples/social-app/openuispec/screens/chat_detail.yaml

@@ -0,0 +1,53 @@
+chat_detail:
+  semantic: "Single conversation thread with message input"
+  status: draft
+
+  params:
+    conversation_id: { type: string, required: true }
+
+  data:
+    conversation:
+      source: "api.messages.getById"
+      params: { id: "params.conversation_id" }
+    messages:
+      source: "api.messages.thread"
+      params: { id: "params.conversation_id" }
+      loading: { skeleton: true, count: 10 }
+      empty: { message: "$t:chat.empty_thread" }
+
+  state:
+    message_text: { type: string, default: "" }
+
+  layout:
+    type: scroll_vertical
+    sections:
+      - id: message_list
+        contract: collection
+        variant: chat_thread
+        props:
+          data: "messages"
+          item_contract: data_display
+          item_props_map:
+            title: "item.sender.display_name"
+            body: "item.body"
+            metadata:
+              timestamp: "{item.created_at | format:time}"
+              is_mine: "{item.is_mine}"
+
+      - id: message_input
+        contract: input_field
+        input_type: text
+        props:
+          label: "$t:chat.message_placeholder"
+          value: "state.message_text"
+          multiline: true
+          trailing_action:
+            icon: "send"
+            action:
+              type: sequence
+              actions:
+                - type: api_call
+                  endpoint: "api.messages.send"
+                  params: { id: "params.conversation_id" }
+                  body: { body: "state.message_text" }
+                - { type: set_state, key: "message_text", value: "" }