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

package/dist/negotiate.d.ts

@@ -71,8 +71,12 @@ import type { ChatPress, ScreenRootNode, ScreenTree } from './schema.js';
  *     published release; core's own renderer draws it). An older parse strips it without a sign,
  *     so without it the bar's legend ("Red 8 · Amber 13 · Green 29") is written into the tile's
  *     `hint`, after any hint it had, and the bar is dropped.
+ *   - `section.action`: a section's `action`, a press drawn at the right end of its title line
+ *     (newer than any published release; core's own renderer draws it). An older parse strips it,
+ *     so without it the action becomes a `button` with the same label and press, last in the
+ *     section, and the reader can still go where it led. A full section drops it.
  */
-export type UiFeature = 'breadcrumbs' | 'button.disabled' | 'section.row' | 'form.field_kinds' | 'form.confirm' | 'press.chat' | 'form.radio' | 'table.cells' | 'header.meta' | 'tabs.many' | 'choice.action' | 'markdown.links' | 'form.disabled' | 'press.seek' | 'edit.inline' | 'timeline.time_tag' | 'stat.bar';
+export type UiFeature = 'breadcrumbs' | 'button.disabled' | 'section.row' | 'form.field_kinds' | 'form.confirm' | 'press.chat' | 'form.radio' | 'table.cells' | 'header.meta' | 'tabs.many' | 'choice.action' | 'markdown.links' | 'form.disabled' | 'press.seek' | 'edit.inline' | 'timeline.time_tag' | 'stat.bar' | 'section.action';
 /** The node types and features one ui-sdk release, or one client, draws. */
 export interface NodeSet {
     /** For messages: "ui-sdk 1.4.0", "mobile 0.2.5". */
@@ -109,7 +113,7 @@ export declare const UI_SDK_SNAPSHOTS: {
     readonly current: {
         readonly name: "ui-sdk (this package)";
         readonly nodes: readonly ["heading", "text", "markdown", "stat", "button", "form", "table", "timeline", "pending_request", "pending_requests", "choice_cards", "progress", "chart", "section", "tabs", "pagination", "select", "alert", "details", "timestamp", "divider", "board", "link", "tags", "toggle", "segmented", "progress_bar", "conversation", "composer", "calendar", "image", "video", "stacked_bar", "heatmap", "audio"];
-        readonly features: readonly ["breadcrumbs", "button.disabled", "section.row", "form.field_kinds", "form.confirm", "press.chat", "form.radio", "table.cells", "header.meta", "tabs.many", "choice.action", "markdown.links", "form.disabled", "press.seek", "edit.inline", "timeline.time_tag", "stat.bar"];
+        readonly features: readonly ["breadcrumbs", "button.disabled", "section.row", "form.field_kinds", "form.confirm", "press.chat", "form.radio", "table.cells", "header.meta", "tabs.many", "choice.action", "markdown.links", "form.disabled", "press.seek", "edit.inline", "timeline.time_tag", "stat.bar", "section.action"];
     };
 };
 export type UiSdkSnapshot = keyof typeof UI_SDK_SNAPSHOTS;

package/dist/negotiate.js

@@ -51,6 +51,7 @@ const ALL_FEATURES = [
     'edit.inline',
     'timeline.time_tag',
     'stat.bar',
+    'section.action',
 ];
 /** The nodes of ui-sdk 1.1.0 and 1.2.0 (one schema). */
 const NODES_1_1_0 = [
@@ -339,6 +340,9 @@ export function negotiateTree(tree, set) {
                     fallbacks.push({ path, type: 'section', reason: 'section.row', as: 'folded' });
                     next = { ...next, layout: 'stack' };
                 }
+                if (next.action && !features.has('section.action')) {
+                    next = foldSectionAction(next, path, fallbacks);
+                }
                 return next;
             }
             case 'form': {
@@ -617,6 +621,38 @@ export function foldChoiceActions(node, path, fallbacks) {
     });
     return { ...node, choices };
 }
+/**
+ * A section with its `action` moved into its body as a last `button`, for a client that does not
+ * draw the action on the title line (`section.action`). Dropped when the section is full.
+ */
+function foldSectionAction(node, path, fallbacks) {
+    const { action, ...rest } = node;
+    if (!action)
+        return node;
+    if (rest.children.length >= CHILDREN_MAX) {
+        fallbacks.push({
+            path: `${path}.action`,
+            type: 'section',
+            reason: 'section.action',
+            as: 'dropped',
+        });
+        return rest;
+    }
+    fallbacks.push({
+        path: `${path}.action`,
+        type: 'section',
+        reason: 'section.action',
+        as: 'folded',
+    });
+    const button = {
+        type: 'button',
+        label: action.label,
+        onPress: action.onPress,
+        variant: 'secondary',
+        disabled: false,
+    };
+    return { ...rest, children: [...rest.children, button] };
+}
 /**
  * The node as a client that draws no edit control should get it (`edit.inline`): the same block,
  * read-only. Drops `edit` from a `text`, `markdown` or `details` block and its items, and from each
@@ -687,6 +723,11 @@ function withoutPresses(node, path, fallbacks, matches, reason) {
                 return node;
             dropped(`${path}.action`, 'button');
             return omit(node, 'action');
+        case 'section':
+            if (!node.action || !matches(node.action.onPress))
+                return node;
+            dropped(`${path}.action`, 'section');
+            return omit(node, 'action');
         case 'image':
             if (!matches(node.onPress))
                 return node;

package/dist/schema.d.ts

@@ -1919,6 +1919,11 @@ export type ScreenNode = LeafScreenNode | {
     badge?: string;
     badgeTone?: 'default' | 'success' | 'warning' | 'destructive' | 'info' | 'accent';
     icon?: UiIcon;
+    action?: {
+        label: string;
+        onPress: Press;
+    };
+    tone?: 'default' | 'success' | 'warning' | 'destructive' | 'info' | 'accent';
     children: ScreenNode[];
 };
 type ScreenNodeInput = LeafScreenNodeInput | {
@@ -1939,6 +1944,11 @@ type ScreenNodeInput = LeafScreenNodeInput | {
     badge?: string;
     badgeTone?: 'default' | 'success' | 'warning' | 'destructive' | 'info' | 'accent';
     icon?: UiIcon;
+    action?: {
+        label: string;
+        onPress: z.input<typeof pressSchema>;
+    };
+    tone?: 'default' | 'success' | 'warning' | 'destructive' | 'info' | 'accent';
     children: ScreenNodeInput[];
 };
 /**
@@ -2044,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<{
@@ -2268,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<{
@@ -2485,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<{
@@ -2692,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

@@ -2275,6 +2275,22 @@ const sectionShape = (children) => z.object({
      * apart at a glance. Decorative: the title says what the section is. Needs a `title`.
      */
     icon: z.enum(UI_ICONS).optional(),
+    /**
+     * A press at the right end of the title line: "All", "Open", "See all 13 amber". Drawn as a
+     * quiet text button, so the label says where it goes. Needs a `title`.
+     */
+    action: z
+        .object({
+        label: z.string().min(1).max(40),
+        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. */
@@ -2344,6 +2360,20 @@ function checkSection(node, ctx) {
             message: 'a section icon sits before its title, so it needs a title',
         });
     }
+    if (node.action !== undefined && !node.title) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['action'],
+            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);
 /**
@@ -2453,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-20261027083656",
+  "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",