@adecore/intelligent-ui 0.27.5 → 0.28.0

package/dist/catalog.d.ts

@@ -23,7 +23,7 @@ export declare const UI_GROUPS: {
     };
     readonly content: {
         readonly description: 'Include code, attachments and sources.';
-        readonly rules: 'Image accepts a chat attachment or generated="latest", never a URL or a local path. Gallery and Compare take chat attachments too. The host says how to attach a file of your own.';
+        readonly rules: 'Image accepts a chat attachment or generated="latest", never a URL or a local path. Gallery and Compare take chat attachments too. Model takes a chat attachment of a model file, and is shown only when the person asks to see a model, never on your own after writing or changing one. The host says how to attach a file of your own.';
     };
     readonly places: {
         readonly description: 'Show places on a map the host draws.';
@@ -291,6 +291,16 @@ export declare const UI_CATALOG: {
         }, z.core.$strict>;
         readonly text: 'caption';
     };
+    readonly Model: {
+        readonly group: 'content';
+        readonly description: 'A 3D model from a chat attachment that a person can orbit and zoom; children are the caption.';
+        readonly schema: z.ZodObject<{
+            attachment: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly needs: 'attachment';
+        readonly text: 'caption';
+    };
     readonly Map: {
         readonly group: 'places';
         readonly description: 'One to 50 places on a map the host draws, with a numbered list under it; bind value to let a person pick a place.';

package/dist/catalog.js

@@ -15,7 +15,7 @@ export const UI_GROUPS = {
     structure: { description: 'Organize distinct topics.', rules: 'Use Tabs for alternatives and Sections for independent topics.' },
     content: {
         description: 'Include code, attachments and sources.',
-        rules: 'Image accepts a chat attachment or generated="latest", never a URL or a local path. Gallery and Compare take chat attachments too. The host says how to attach a file of your own.'
+        rules: 'Image accepts a chat attachment or generated="latest", never a URL or a local path. Gallery and Compare take chat attachments too. Model takes a chat attachment of a model file, and is shown only when the person asks to see a model, never on your own after writing or changing one. The host says how to attach a file of your own.'
     },
     places: {
         description: 'Show places on a map the host draws.',
@@ -113,6 +113,13 @@ export const UI_CATALOG = {
         schema: z.strictObject({ before: name, after: name, beforeLabel: text.optional(), afterLabel: text.optional() }),
         text: 'caption'
     },
+    Model: {
+        group: 'content',
+        description: 'A 3D model from a chat attachment that a person can orbit and zoom; children are the caption.',
+        schema: z.strictObject({ attachment: name, alt: text.optional() }),
+        needs: 'attachment',
+        text: 'caption'
+    },
     Map: {
         group: 'places',
         description: 'One to 50 places on a map the host draws, with a numbered list under it; bind value to let a person pick a place.',

package/dist/fallback.js

@@ -54,6 +54,8 @@ export function uiNodeFallback(type, props, children) {
             return children;
         case 'Image':
             return `[Image: ${uiPlainText(props.alt ?? props.attachment ?? props.generated ?? 'unavailable')}]${children}\n`;
+        case 'Model':
+            return `[Model: ${uiPlainText(props.alt ?? props.attachment ?? 'unavailable')}]${children.trim() ? ` ${children.trim()}` : ''}\n`;
     }
     const path = given(props.path) && given(props.line) ? `${uiPlainText(props.path)}:${uiPlainText(props.line)}` : props.path;
     const target = path ?? props.sha ?? (type === 'Node' ? props.id : undefined);

package/dist/text.js

@@ -34,7 +34,7 @@ function uiGroupNames(detailHint) {
 }
 export function uiSessionNote({ fenceLanguage = UI_FENCE_LANGUAGE, catalog = 'props', detailHint } = {}) {
     const components = catalog === 'names' ? uiGroupNames(detailHint) : `Catalog (? means optional props): ${uiCompactCatalog()}`;
-    return `${uiSyntax(fenceLanguage)} Prose outside. Only named catalog props, no styling. $name = literal JSON; input value={$name}; Button action={@Set($name, literal)}, {@Reset($name)} or {@Reset()} changes local state only; braced expressions: @Count, @Filter(list,row,predicate), @Sum, @Join, @Round. Show/Each control children. Choices are shortcuts after finished work that the person may ignore. When your turn would end waiting on the person (a missing fact, a decision, a go-ahead for work you would otherwise do), ask with your own question tool if you have one, otherwise in prose, never with Choices. Choice labels and precise context stay visible and send once. Image: attachment or generated="latest", never URL/path. No code execution. State resets on reload. ${components}\nExample:\n${uiExample(fenceLanguage)}\n`;
+    return `${uiSyntax(fenceLanguage)} Prose outside. Only named catalog props, no styling. $name = literal JSON; input value={$name}; Button action={@Set($name, literal)}, {@Reset($name)} or {@Reset()} changes local state only; braced expressions: @Count, @Filter(list,row,predicate), @Sum, @Join, @Round. Show/Each control children. Choices are shortcuts after finished work that the person may ignore. When your turn would end waiting on the person (a missing fact, a decision, a go-ahead for work you would otherwise do), ask with your own question tool if you have one, otherwise in prose, never with Choices. Choice labels and precise context stay visible and send once. Image: attachment or generated="latest", never URL/path. Model only when the person asks to see one. No code execution. State resets on reload. ${components}\nExample:\n${uiExample(fenceLanguage)}\n`;
 }
 /* One group as the reference writes it: its description and rules, then every component with its props. */
 export function uiGroupReference(group) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/intelligent-ui",
-  "version": "0.27.5",
+  "version": "0.28.0",
   "description": "A streaming UI catalog, compiler and bounded expression interpreter without a framework or DOM.",
   "license": "FSL-1.1-MIT",
   "author": "Bas Milius",

package/src/catalog.ts

@@ -19,7 +19,7 @@ export const UI_GROUPS = {
     structure: { description: 'Organize distinct topics.', rules: 'Use Tabs for alternatives and Sections for independent topics.' },
     content: {
         description: 'Include code, attachments and sources.',
-        rules: 'Image accepts a chat attachment or generated="latest", never a URL or a local path. Gallery and Compare take chat attachments too. The host says how to attach a file of your own.'
+        rules: 'Image accepts a chat attachment or generated="latest", never a URL or a local path. Gallery and Compare take chat attachments too. Model takes a chat attachment of a model file, and is shown only when the person asks to see a model, never on your own after writing or changing one. The host says how to attach a file of your own.'
     },
     places: {
         description: 'Show places on a map the host draws.',
@@ -119,6 +119,13 @@ export const UI_CATALOG = {
         schema: z.strictObject({ before: name, after: name, beforeLabel: text.optional(), afterLabel: text.optional() }),
         text: 'caption'
     },
+    Model: {
+        group: 'content',
+        description: 'A 3D model from a chat attachment that a person can orbit and zoom; children are the caption.',
+        schema: z.strictObject({ attachment: name, alt: text.optional() }),
+        needs: 'attachment',
+        text: 'caption'
+    },
     Map: {
         group: 'places',
         description: 'One to 50 places on a map the host draws, with a numbered list under it; bind value to let a person pick a place.',

package/src/fallback.ts

@@ -56,6 +56,8 @@ export function uiNodeFallback(type: string, props: Readonly<Record<string, unkn
             return children;
         case 'Image':
             return `[Image: ${uiPlainText(props.alt ?? props.attachment ?? props.generated ?? 'unavailable')}]${children}\n`;
+        case 'Model':
+            return `[Model: ${uiPlainText(props.alt ?? props.attachment ?? 'unavailable')}]${children.trim() ? ` ${children.trim()}` : ''}\n`;
     }
     const path = given(props.path) && given(props.line) ? `${uiPlainText(props.path)}:${uiPlainText(props.line)}` : props.path;
     const target = path ?? props.sha ?? (type === 'Node' ? props.id : undefined);

package/src/text.ts

@@ -52,7 +52,7 @@ function uiGroupNames(detailHint: string | undefined): string {
 
 export function uiSessionNote({ fenceLanguage = UI_FENCE_LANGUAGE, catalog = 'props', detailHint }: UiTextOptions = {}): string {
     const components = catalog === 'names' ? uiGroupNames(detailHint) : `Catalog (? means optional props): ${uiCompactCatalog()}`;
-    return `${uiSyntax(fenceLanguage)} Prose outside. Only named catalog props, no styling. $name = literal JSON; input value={$name}; Button action={@Set($name, literal)}, {@Reset($name)} or {@Reset()} changes local state only; braced expressions: @Count, @Filter(list,row,predicate), @Sum, @Join, @Round. Show/Each control children. Choices are shortcuts after finished work that the person may ignore. When your turn would end waiting on the person (a missing fact, a decision, a go-ahead for work you would otherwise do), ask with your own question tool if you have one, otherwise in prose, never with Choices. Choice labels and precise context stay visible and send once. Image: attachment or generated="latest", never URL/path. No code execution. State resets on reload. ${components}\nExample:\n${uiExample(fenceLanguage)}\n`;
+    return `${uiSyntax(fenceLanguage)} Prose outside. Only named catalog props, no styling. $name = literal JSON; input value={$name}; Button action={@Set($name, literal)}, {@Reset($name)} or {@Reset()} changes local state only; braced expressions: @Count, @Filter(list,row,predicate), @Sum, @Join, @Round. Show/Each control children. Choices are shortcuts after finished work that the person may ignore. When your turn would end waiting on the person (a missing fact, a decision, a go-ahead for work you would otherwise do), ask with your own question tool if you have one, otherwise in prose, never with Choices. Choice labels and precise context stay visible and send once. Image: attachment or generated="latest", never URL/path. Model only when the person asks to see one. No code execution. State resets on reload. ${components}\nExample:\n${uiExample(fenceLanguage)}\n`;
 }
 
 /* One group as the reference writes it: its description and rules, then every component with its props. */