@keemakr/ui-sdk 1.6.0-dev-20261027084552 → 1.6.0-dev-20261027085115

package/dist/schema.d.ts

@@ -1923,6 +1923,7 @@ export type ScreenNode = LeafScreenNode | {
         label: string;
         onPress: Press;
     };
+    tone?: 'default' | 'success' | 'warning' | 'destructive' | 'info' | 'accent';
     children: ScreenNode[];
 };
 type ScreenNodeInput = LeafScreenNodeInput | {
@@ -1947,6 +1948,7 @@ type ScreenNodeInput = LeafScreenNodeInput | {
         label: string;
         onPress: z.input<typeof pressSchema>;
     };
+    tone?: 'default' | 'success' | 'warning' | 'destructive' | 'info' | 'accent';
     children: ScreenNodeInput[];
 };
 /**
@@ -2052,6 +2054,10 @@ export declare const screenTreeSchema: z.ZodObject<{
         dot: z.ZodOptional<z.ZodBoolean>;
         hint: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    avatar: z.ZodOptional<z.ZodObject<{
+        initials: z.ZodString;
+        src: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     meta: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         value: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2276,6 +2282,10 @@ export declare const actionResultSchema: z.ZodObject<{
             dot: z.ZodOptional<z.ZodBoolean>;
             hint: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
+        avatar: z.ZodOptional<z.ZodObject<{
+            initials: z.ZodString;
+            src: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         meta: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodString;
             value: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2493,6 +2503,10 @@ export declare const jobStatusSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 dot: z.ZodOptional<z.ZodBoolean>;
                 hint: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
+            avatar: z.ZodOptional<z.ZodObject<{
+                initials: z.ZodString;
+                src: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
             meta: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 label: z.ZodString;
                 value: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2700,6 +2714,10 @@ export declare const screenLoadResponseSchema: z.ZodObject<{
             dot: z.ZodOptional<z.ZodBoolean>;
             hint: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
+        avatar: z.ZodOptional<z.ZodObject<{
+            initials: z.ZodString;
+            src: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         meta: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodString;
             value: z.ZodDiscriminatedUnion<[z.ZodObject<{

package/dist/schema.js

@@ -2285,6 +2285,12 @@ const sectionShape = (children) => z.object({
         onPress: pressSchema,
     })
         .optional(),
+    /**
+     * Tints a `card` section in a tone: its border and a faint wash behind it, so one card reads
+     * as marked (a red diagnosis on an account). Colour is never the only signal: the title says
+     * why ("Red · onboarding stalled"). Needs `surface: 'card'`. Default `default`, no tint.
+     */
+    tone: tone.optional(),
     children: z.array(children).max(100),
 });
 /** The rules between a section's fields, which a field's own schema cannot state. */
@@ -2361,6 +2367,13 @@ function checkSection(node, ctx) {
             message: 'a section action sits on its title line, so it needs a title',
         });
     }
+    if (node.tone !== undefined && node.surface !== 'card') {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['tone'],
+            message: "a section tone tints a card, so it needs surface: 'card'",
+        });
+    }
 }
 const sectionBranch = (children) => sectionShape(children).superRefine(checkSection);
 /**
@@ -2470,6 +2483,16 @@ export const screenTreeSchema = z
      * only signal, so each label says the status in words ("At risk").
      */
     badges: z.array(tagSchema).min(1).max(4).optional(),
+    /**
+     * A square before the title that says whose screen this is at a glance: an account's
+     * initials, or its logo from the module's media. Decorative: the title names it. With an
+     * avatar the header is drawn as one card (avatar, title and badges, facts, actions), the
+     * top of a record's page. `initials` are drawn when there is no `src`, and while it loads
+     * or when it fails.
+     */
+    avatar: z
+        .object({ initials: z.string().min(1).max(3), src: mediaPathSchema.optional() })
+        .optional(),
     /**
      * Up to eight facts drawn as a compact row under the title (and its
      * description): ARR, renewal date, reps, NPS. Each value is a cell, so a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keemakr/ui-sdk",
-  "version": "1.6.0-dev-20261027084552",
+  "version": "1.6.0-dev-20261027085115",
   "description": "Product screens for keemakr marketplace modules: a versioned, server-driven UI tree schema plus defineScreen() handlers. Module code never ships to the browser — keemakr-core validates the tree and renders it with platform components.",
   "license": "MIT",
   "type": "module",