@proulr/sdui-contract 0.1.8 → 0.1.12

package/package.json

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

package/src/sdui-contract-types.ts

@@ -52,10 +52,23 @@ export type SduiActionWire = {
   event_props?: Record<string, unknown>;
 };
 
+/** Layout/chrome hints for the generic app shell (wire snake_case). */
+export type SduiScreenChromeMetaWire = {
+  full_bleed_scroll?: boolean;
+  owns_header?: boolean;
+  self_managed?: boolean;
+  hub_kind?: 'inbox' | null;
+  wide_layout?: 'chat_master_detail' | 'vibes_rail' | null;
+  surface?: 'discover' | 'vibes' | null;
+  header_slot?: boolean;
+  pull_refresh?: boolean;
+};
+
 export type SduiScreenMetaWire = {
   cache_ttl_ms?: number;
   offline_policy?: SduiOfflinePolicy;
   bff?: string;
+  chrome?: SduiScreenChromeMetaWire;
 };
 
 export type SduiScreenWire = {
@@ -101,10 +114,23 @@ export type SduiAction = {
   eventProps?: Record<string, unknown>;
 };
 
+/** Layout/chrome hints for the generic app shell (camelCase domain). */
+export type SduiScreenChromeMeta = {
+  fullBleedScroll?: boolean;
+  ownsHeader?: boolean;
+  selfManaged?: boolean;
+  hubKind?: 'inbox' | null;
+  wideLayout?: 'chat_master_detail' | 'vibes_rail' | null;
+  surface?: 'discover' | 'vibes' | null;
+  headerSlot?: boolean;
+  pullRefresh?: boolean;
+};
+
 export type SduiScreenMeta = {
   cacheTtlMs: number;
   offlinePolicy: SduiOfflinePolicy;
   bff?: string;
+  chrome?: SduiScreenChromeMeta;
 };
 
 export type SduiScreen = {
@@ -189,6 +215,7 @@ export type StyleWire = {
   opacity?: number;
   flex?: number;
   align_items?: 'flex-start' | 'center' | 'flex-end';
+  text_align?: 'left' | 'center' | 'right';
   typography?: TypeToken;
 };
 

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

@@ -42,6 +42,46 @@ describe('decodeSduiScreenWire', () => {
     });
   });
 
+  it('decodes meta.chrome into camelCase layout hints', () => {
+    const screen = decodeSduiScreenWire({
+      schema_version: 1,
+      screen_id: 'discover.home',
+      blocks: [],
+      meta: {
+        chrome: {
+          full_bleed_scroll: true,
+          header_slot: true,
+          pull_refresh: true,
+          surface: 'discover',
+          hub_kind: 'inbox',
+          wide_layout: 'chat_master_detail',
+          owns_header: false,
+          self_managed: false,
+        },
+      },
+    });
+
+    expect(screen.meta.chrome).toEqual({
+      fullBleedScroll: true,
+      ownsHeader: false,
+      selfManaged: false,
+      hubKind: 'inbox',
+      wideLayout: 'chat_master_detail',
+      surface: 'discover',
+      headerSlot: true,
+      pullRefresh: true,
+    });
+  });
+
+  it('omits chrome when meta.chrome is absent', () => {
+    const screen = decodeSduiScreenWire({
+      schema_version: 1,
+      screen_id: 'demo.home',
+      blocks: [],
+    });
+    expect(screen.meta.chrome).toBeUndefined();
+  });
+
   it('throws SduiCodecError for non-object payload', () => {
     expect(() => decodeSduiScreenWire(null)).toThrow(SduiCodecError);
   });

package/src/sdui-screen-codec.ts

@@ -9,6 +9,8 @@ import {
   type SduiHeaderWire,
   type SduiOfflinePolicy,
   type SduiScreen,
+  type SduiScreenChromeMeta,
+  type SduiScreenChromeMetaWire,
   type SduiScreenMeta,
   type SduiScreenMetaWire,
   type SduiScreenWire,
@@ -63,11 +65,28 @@ function mapHeaderWire(wire: SduiHeaderWire): SduiHeader {
   };
 }
 
+function mapChromeMetaWire(
+  wire: SduiScreenChromeMetaWire | undefined,
+): SduiScreenChromeMeta | undefined {
+  if (!wire) return undefined;
+  return {
+    fullBleedScroll: wire.full_bleed_scroll,
+    ownsHeader: wire.owns_header,
+    selfManaged: wire.self_managed,
+    hubKind: wire.hub_kind,
+    wideLayout: wire.wide_layout,
+    surface: wire.surface,
+    headerSlot: wire.header_slot,
+    pullRefresh: wire.pull_refresh,
+  };
+}
+
 function mapMetaWire(wire: SduiScreenMetaWire | undefined): SduiScreenMeta {
   return {
     cacheTtlMs: wire?.cache_ttl_ms ?? DEFAULT_CACHE_TTL_MS,
     offlinePolicy: wire?.offline_policy ?? DEFAULT_OFFLINE_POLICY,
     bff: wire?.bff,
+    chrome: mapChromeMetaWire(wire?.chrome),
   };
 }