@theoremjs/web 0.3.4-next.596.g481e1de → 0.3.4-next.600.gb15be9a

package/client/index.d.ts

@@ -25,7 +25,7 @@ export { type PageDispatchResult, withPageToolDispatch } from './page-dispatch.t
 export { sessionAfter, stampWorked } from './run-commit.ts';
 export { keepsConversation, type RunOutcome, resumeInterfaceTool, type StreamView, streamInterfaceDraftTurn, streamInterfaceTurn, } from './run-session.ts';
 export { blankRow, type JsonSchema, missingFields, type SchemaControl, type SchemaField, sampleFromSchema, schemaControl, schemaFields, withField, } from './schema-fields.ts';
-export { fieldLabel, fieldReading, humanize, isPlain, isProse, isRow, json, type ListRow, MAX_ROWS, type PlainReading, plainReading, type Row, rowHeading, type Section, type Shape, shapeOf, splitFields, unpacked, withUnit, } from './shaped-data.ts';
+export { fieldLabel, fieldReading, humanize, isPart, isPlain, isProse, isRow, json, type ListRow, layoutChars, MAX_ROWS, type PlainReading, plainReading, type Row, rowHeading, type Section, type Shape, shapeOf, splitFields, unpacked, withUnit, } from './shaped-data.ts';
 export { citationsFromBlock, type SourceCitation, type SourceCitationBlock, } from './source-citations.ts';
 export type { QueryMatch } from './space-geometry.ts';
 export { DOT_FLOATS, FRAME_SLOT, queryGeometry, SEGMENT_FLOATS, type SpaceGeometry, spaceGeometry, } from './space-geometry.ts';

package/client/index.js

@@ -21,7 +21,7 @@ export { withPageToolDispatch } from "./page-dispatch.js";
 export { sessionAfter, stampWorked } from "./run-commit.js";
 export { keepsConversation, resumeInterfaceTool, streamInterfaceDraftTurn, streamInterfaceTurn, } from "./run-session.js";
 export { blankRow, missingFields, sampleFromSchema, schemaControl, schemaFields, withField, } from "./schema-fields.js";
-export { fieldLabel, fieldReading, humanize, isPlain, isProse, isRow, json, MAX_ROWS, plainReading, rowHeading, shapeOf, splitFields, unpacked, withUnit, } from "./shaped-data.js";
+export { fieldLabel, fieldReading, humanize, isPart, isPlain, isProse, isRow, json, layoutChars, MAX_ROWS, plainReading, rowHeading, shapeOf, splitFields, unpacked, withUnit, } from "./shaped-data.js";
 export { citationsFromBlock, } from "./source-citations.js";
 export { DOT_FLOATS, FRAME_SLOT, queryGeometry, SEGMENT_FLOATS, spaceGeometry, } from "./space-geometry.js";
 export { hasLead, layoutResult, returnedMedia, timeFormats, } from "./tool-result.js";

package/client/shaped-data.d.ts

@@ -3,6 +3,7 @@
  * value takes, what a row is called, what a field's label and unit are. The
  * component only maps each decision to its Astryx part.
  */
+import { type InteractionPart } from '@theoremjs/agents';
 export type Row = Record<string, unknown>;
 /** Rows shown before the rest are left to the JSON view. */
 export declare const MAX_ROWS = 50;
@@ -11,6 +12,13 @@ export declare function isRow(value: unknown): value is Row;
 export declare function isPlain(value: unknown): boolean;
 /** The value as indented JSON, whatever it holds. */
 export declare function json(value: unknown): string;
+/** A part as the kernel declares one (`InteractionPart`): text, or media carried as base64 `data` or at a `uri`. */
+export declare function isPart(value: unknown): value is InteractionPart;
+/**
+ * How much text laying the value out draws: its JSON, without each part's
+ * base64 `data`, which is drawn as a picture or a player.
+ */
+export declare function layoutChars(value: unknown): number;
 /** A string that holds a JSON object or list, parsed; anything else as it came. */
 export declare function unpacked(value: unknown): unknown;
 /** `country_code`, `countryCode` → "Country code". */
@@ -100,6 +108,9 @@ export type Shape = {
 } | {
     kind: 'fields';
     row: Row;
+} | {
+    kind: 'parts';
+    parts: InteractionPart[];
 };
 /** How a value (already unpacked) at `depth` is drawn. */
 export declare function shapeOf(value: unknown, depth: number): Shape;

package/client/shaped-data.js

@@ -3,6 +3,7 @@
  * value takes, what a row is called, what a field's label and unit are. The
  * component only maps each decision to its Astryx part.
  */
+import { MEDIA_INPUT_KIND_VALUES } from '@theoremjs/agents';
 /** Fields that name a row, in the order they're tried. */
 const TITLE_KEYS = ['name', 'title', 'label', 'headline', 'subject', 'id'];
 /** Fields that place or sort a row, shown as tokens beside its title. */
@@ -93,6 +94,30 @@ export function json(value) {
         return JSON.stringify(jsonSafe(value), null, 2) ?? String(value);
     }
 }
+const MEDIA_KINDS = new Set(MEDIA_INPUT_KIND_VALUES);
+/** A part as the kernel declares one (`InteractionPart`): text, or media carried as base64 `data` or at a `uri`. */
+export function isPart(value) {
+    if (!isRow(value) || typeof value.type !== 'string')
+        return false;
+    if (value.type === 'text')
+        return typeof value.text === 'string';
+    return (MEDIA_KINDS.has(value.type) &&
+        typeof value.mimeType === 'string' &&
+        (typeof value.data === 'string' || typeof value.uri === 'string'));
+}
+/**
+ * How much text laying the value out draws: its JSON, without each part's
+ * base64 `data`, which is drawn as a picture or a player.
+ */
+export function layoutChars(value) {
+    try {
+        const lean = JSON.stringify(value, (_key, item) => (isPart(item) && 'data' in item ? { ...item, data: '' } : item), 2);
+        return lean?.length ?? 0;
+    }
+    catch {
+        return json(value).length;
+    }
+}
 /** A string that holds a JSON object or list, parsed; anything else as it came. */
 export function unpacked(value) {
     if (typeof value !== 'string')
@@ -278,6 +303,8 @@ function listShape(items) {
         return { kind: 'none' };
     if (items.every(isPlain))
         return { kind: 'tokens', items };
+    if (items.every(isPart))
+        return { kind: 'parts', parts: items };
     const listed = items.map(listRow);
     if (listed.every((row) => row !== undefined))
         return { kind: 'list', rows: listed };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theoremjs/web",
-  "version": "0.3.4-next.596.g481e1de",
+  "version": "0.3.4-next.600.gb15be9a",
   "description": "Theorem on the web platform, with no UI framework: Web-standard server handlers that serve a profile, and the browser client that talks to them.",
   "license": "MIT",
   "type": "module",
@@ -25,6 +25,6 @@
   },
   "peerDependencies": {
     "zod": "^4.6.5",
-    "@theoremjs/agents": "^0.3.4-next.596.g481e1de"
+    "@theoremjs/agents": "^0.3.4-next.600.gb15be9a"
   }
 }