@keemakr/ui-sdk 1.6.0-dev-20261027081136 → 1.6.0-dev-20261027083052

package/dist/negotiate.d.ts

@@ -63,8 +63,12 @@ import type { ChatPress, ScreenRootNode, ScreenTree } from './schema.js';
  *     would draw read-only anyway; core drops it on purpose all the same (`withoutInlineEdit`), so
  *     a client never gets half an edit (a column's options without its action, say) and the
  *     fallback list says the block was made read-only. The data is all still there.
+ *   - `timeline.time_tag`: a timeline item's `time` ("07:30", never zone-converted) drawn in a
+ *     column of its own, and its `tag` drawn as a grey pill after the label (newer than any
+ *     published release; core's own renderer draws them). An older parse strips both without a
+ *     sign, so without it they are written into the label ("07:30 · Brief sent · brief").
  */
-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';
+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';
 /** 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". */
@@ -101,7 +105,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"];
+        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"];
     };
 };
 export type UiSdkSnapshot = keyof typeof UI_SDK_SNAPSHOTS;

package/dist/negotiate.js

@@ -49,6 +49,7 @@ const ALL_FEATURES = [
     'form.disabled',
     'press.seek',
     'edit.inline',
+    'timeline.time_tag',
 ];
 /** The nodes of ui-sdk 1.1.0 and 1.2.0 (one schema). */
 const NODES_1_1_0 = [
@@ -380,6 +381,8 @@ export function negotiateTree(tree, set) {
             }
             case 'choice_cards':
                 return features.has('choice.action') ? node : foldChoiceActions(node, path, fallbacks);
+            case 'timeline':
+                return features.has('timeline.time_tag') ? node : foldTimeAndTag(node, path, fallbacks);
             case 'markdown': {
                 if (features.has('markdown.links'))
                     return node;
@@ -791,6 +794,29 @@ function withoutSeeks(node, path, fallbacks) {
     }
     return next;
 }
+/**
+ * The timeline as a client that cannot draw an item's `time` or `tag` should get it
+ * (`timeline.time_tag` above): both written into the label. Returns the same object when there is
+ * nothing to change.
+ */
+function foldTimeAndTag(node, path, fallbacks) {
+    if (!node.items.some((item) => item.time || item.tag))
+        return node;
+    const items = node.items.map((item, i) => {
+        if (!item.time && !item.tag)
+            return item;
+        fallbacks.push({
+            path: `${path}.items[${i}]`,
+            type: 'timeline',
+            reason: 'timeline.time_tag',
+            as: 'folded',
+        });
+        const { time, tag, ...rest } = item;
+        const label = [time, item.label, tag].filter(Boolean).join(' · ');
+        return { ...rest, label: clip(label, 200) };
+    });
+    return { ...node, items };
+}
 /** A copy of `value` without `key`. */
 function omit(value, key) {
     const copy = { ...value };

package/dist/schema.d.ts

@@ -991,6 +991,8 @@ declare const leafNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             player: z.ZodString;
             at: z.ZodNumber;
         }, z.core.$strip>>;
+        time: z.ZodOptional<z.ZodString>;
+        tag: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"pending_request">;

package/dist/schema.js

@@ -2117,6 +2117,13 @@ const leafNodeSchema = z.discriminatedUnion('type', [
              * as its time ("4:10"), a button that plays the recording from there.
              */
             seek: seekPointSchema.optional(),
+            /**
+             * A clock time as the module wrote it ("07:30"), drawn in a column of its own at the
+             * item's left. Never converted: use `at` for a moment the viewer reads in their zone.
+             */
+            time: z.string().min(1).max(16).optional(),
+            /** A short kind ("brief", "health", "escalation"), drawn as a grey pill after the label. */
+            tag: z.string().min(1).max(40).optional(),
         }))
             .max(200),
     }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keemakr/ui-sdk",
-  "version": "1.6.0-dev-20261027081136",
+  "version": "1.6.0-dev-20261027083052",
   "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",