dsh-motion-ui 0.5.3 → 0.5.4

package/lib/stream.js

@@ -1,4 +1,5 @@
 import { LIMITS, validateDocument } from './protocol.js';
+import { toolJson } from './tool-json.js';
 
 // Parse complete JSON tokens only. Never finish a string, number or model expression.
 // Partial containers retain completed members, but only the document wrapper and
@@ -62,7 +63,7 @@ export function previewDocument(raw) {
   try {
     const root=parseToolArguments(raw);if(!root)return null;
     const document = root.members?.get('document');
-    if(document?.complete&&typeof document.value==='string'&&root.members.size===1)return validateDocument(JSON.parse(document.value));
+    if(document?.complete&&typeof document.value==='string'&&root.members.size===1)return validateDocument(toolJson(document.value,'document'));
     if (!document?.members) return null;
     if ([...root.members.keys()].some(k => k !== 'document')) return null;
     const doc = { ...document.value }, nodes = document.members.get('nodes');

package/lib/tool-json.js

@@ -1,7 +1,26 @@
 // DSH adapters may represent `type: json` fields as JSON strings.
 // Decode only the tool field, once; strict protocol validation still applies.
+function clean(source) {
+  let input=source.trim().replace(/^\uFEFF/, '');
+  const fence=input.match(/^```(?:json)?\s*\n([\s\S]*?)\n```$/i);
+  if(fence)input=fence[1];
+  let output='',quoted=false,escaped=false;
+  for(let i=0;i<input.length;i++){
+    const c=input[i];
+    if(quoted){output+=c;if(escaped)escaped=false;else if(c==='\\')escaped=true;else if(c==='"')quoted=false;continue;}
+    if(c==='"')quoted=true;
+    if(c===',' && /^\s*[}\]]/.test(input.slice(i+1)))continue;
+    output+=c;
+  }
+  return output;
+}
 export function toolJson(value, field, maxBytes=131072){
   if(typeof value!=='string')return value;
-  if(Buffer.byteLength(value,'utf8')>maxBytes)throw new Error(`DSH UI: ${field} JSON exceeds size limit`);
-  try{return JSON.parse(value)}catch{throw new Error(`DSH UI: ${field} must contain valid JSON. Fix quoting/escaping. For a standalone HTML/SVG canvas, render_canvas accepts separate html/css/script fields.`)}
+  if(new TextEncoder().encode(value).length>maxBytes)throw new Error(`DSH UI: ${field} JSON exceeds size limit`);
+  const source=clean(value);
+  try{return JSON.parse(source)}catch(error){
+    const position=error.message.match(/position (\d+)/)?.[1];
+    const location=position===undefined?'':` at line ${source.slice(0,Number(position)).split('\n').length}, column ${Number(position)-source.lastIndexOf('\n',Number(position)-1)}`;
+    throw new Error(`DSH UI: ${field} must contain valid JSON${location}. Pass an object directly, not a manually escaped JSON string. Do not use single-quoted keys or raw newlines inside strings. For HTML/SVG use render_canvas with separate html/css/script fields. No partial document was saved.`);
+  }
 }

package/lib/tool-schema.js

@@ -0,0 +1,29 @@
+import {COMPONENTS} from './components.js';
+// Expose the document skeleton to native function calling, not just prose.
+// Per-component and expression checks remain in the shared runtime validator.
+const dictionary=description=>({type:'object',additionalProperties:true,description});
+export const DOCUMENT_PARAMETER={
+  required:true,
+  description:'Pass the document as an OBJECT. Do not manually escape/serialize it. For HTML/SVG source prefer render_canvas.',
+  type:'object',additionalProperties:false,
+    properties:{
+      version:{type:'number',const:1,required:true},
+      title:{type:'string',required:true},
+      fallback:{type:'string',required:true,description:'Useful plain-text explanation if the UI is unavailable.'},
+      nodes:{type:'array',required:true,items:{type:'object',additionalProperties:true,properties:{
+        id:{type:'string',required:true,description:'Unique letter/underscore identifier; Chinese supported, max64.'},
+        type:{type:'string',required:true,enum:Object.keys(COMPONENTS)},
+        label:{type:'string'},title:{type:'string'},
+        text:{type:'json',description:'Literal scalar or {ref}/{expr}.'},
+        value:{type:'json',description:'metric: number or display string/boolean, or {ref}/{expr}. progress: numeric.'},
+        rows:{type:'json',description:'table/chart: inline array of objects, {ref:"data.rows"}/{ref:"derived.rows"}, or scoped reference string.'},
+        columns:{type:'array',items:{type:'object',additionalProperties:false,properties:{key:{type:'string',required:true},label:{type:'string',required:true},unit:{type:'string'}}}},
+        bind:{type:'string',description:'Controls bind state.key.'},children:{type:'array',items:{type:'json'}}
+      }}},
+      state:dictionary('key -> {type:number/string/boolean/json,default,...}. Numeric state needs min,max,step. json is bounded array/object state for canvas controls.'),
+      data:dictionary('Static data; Chinese identifier keys supported. Omit if rows are inline.'),
+      derived:dictionary('Local expressions or maps. Omit when unused.'),
+      actions:dictionary('Declared agent.followup actions. Omit when unused.'),
+      presentation:dictionary('Optional layout/accent/density from registered tokens.')
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-motion-ui",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Interactive UI, HTML/SVG animation and local calculations for DeepSeek Harness Web, with injected design guidance.",
   "type": "module",
   "main": "index.js",