@proulr/sdui-contract 0.1.19 → 0.1.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proulr/sdui-contract",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/sdui-contract-types.ts

@@ -387,9 +387,23 @@ export type SduiScreenChromeMetaWire = {
   self_managed?: boolean;
   hub_kind?: 'inbox' | null;
   wide_layout?: 'chat_master_detail' | 'vibes_rail' | null;
+  /**
+   * Screen id da listagem que ocupa o painel mestre no wide. Obrigatório quando a
+   * rota é a própria tela de detalhe (`/s/chat.thread?conversation_id=…`): sem ele
+   * o shell renderizaria o wire do detalhe também na master — thread duplicada.
+   */
+  wide_master_screen_id?: string;
+  /**
+   * Destino fixo do botão voltar, ignorando o histórico. Usado quando a tela que
+   * antecedeu esta deixou de fazer sentido (ex.: conversa do Randoms que virou DM —
+   * voltar cai na lista de mensagens, não na fila).
+   */
+  back_screen_id?: string;
   surface?: 'discover' | 'vibes' | null;
   header_slot?: boolean;
   pull_refresh?: boolean;
+  /** Action id que o shell executa uma vez quando o wire chega pronto (ex. navegar ao casar). */
+  auto_action_id?: string;
 };
 
 export type SduiScreenMetaWire = {
@@ -451,9 +465,15 @@ export type SduiScreenChromeMeta = {
   selfManaged?: boolean;
   hubKind?: 'inbox' | null;
   wideLayout?: 'chat_master_detail' | 'vibes_rail' | null;
+  /** Listing screen rendered in the wide master pane when this screen is the detail. */
+  wideMasterScreenId?: string;
+  /** Screen the back button goes to, bypassing history (the previous screen no longer makes sense). */
+  backScreenId?: string;
   surface?: 'discover' | 'vibes' | null;
   headerSlot?: boolean;
   pullRefresh?: boolean;
+  /** Action id que o shell executa uma vez quando o wire chega pronto (ex. navegar ao casar). */
+  autoActionId?: string;
 };
 
 export type SduiScreenMeta = {

package/src/sdui-screen-codec.test.ts

@@ -73,8 +73,11 @@ describe('decodeSduiScreenWire', () => {
           surface: 'discover',
           hub_kind: 'inbox',
           wide_layout: 'chat_master_detail',
+          wide_master_screen_id: 'chat.inbox',
+          back_screen_id: 'chat.inbox',
           owns_header: false,
           self_managed: false,
+          auto_action_id: 'open_random_thread',
         },
       },
     });
@@ -85,9 +88,12 @@ describe('decodeSduiScreenWire', () => {
       selfManaged: false,
       hubKind: 'inbox',
       wideLayout: 'chat_master_detail',
+      wideMasterScreenId: 'chat.inbox',
+      backScreenId: 'chat.inbox',
       surface: 'discover',
       headerSlot: true,
       pullRefresh: true,
+      autoActionId: 'open_random_thread',
     });
   });
 

package/src/sdui-screen-codec.ts

@@ -76,9 +76,12 @@ function mapChromeMetaWire(
     selfManaged: wire.self_managed,
     hubKind: wire.hub_kind,
     wideLayout: wire.wide_layout,
+    wideMasterScreenId: wire.wide_master_screen_id,
+    backScreenId: wire.back_screen_id,
     surface: wire.surface,
     headerSlot: wire.header_slot,
     pullRefresh: wire.pull_refresh,
+    autoActionId: wire.auto_action_id,
   };
 }