@zixcel/dom-renderer 0.10.3 → 0.10.5

package/src/graphics-disposal.mjs

@@ -0,0 +1,14 @@
+/** Drain each independently owned resource; preserve falsy failures too. */
+export function disposeGraphics(operations) {
+    const failures = [];
+    for (const operation of operations) {
+        try {
+            operation();
+        }
+        catch (error) {
+            failures.push(error);
+        }
+    }
+    if (failures.length)
+        throw new AggregateError(failures, 'Graphics cleanup failed');
+}

package/src/index.d.mts

@@ -1,57 +1,11 @@
-/** @template {keyof HTMLElementTagNameMap} K
- * @param {Document} document
- * @param {K} tag
- * @param {unknown} [text]
- * @param {Record<string,unknown>} [attrs]
- * @returns {HTMLElementTagNameMap[K]} */
-export function element<K extends keyof HTMLElementTagNameMap>(document: Document, tag: K, text?: unknown, attrs?: Record<string, unknown>): HTMLElementTagNameMap[K];
-/** @param {Document} document
- * @param {unknown} value
- * @param {{nodes:number,bytes:number}} [budget]
- * @returns {HTMLElement} */
-export function valueView(document: Document, value: unknown, budget?: {
-    nodes: number;
-    bytes: number;
-}): HTMLElement;
-/** @param {Document} document
- * @param {import('@zixcel/interaction/input').InputDeclaration} declaration
- * @param {(values:Record<string,string|boolean|number>)=>unknown|Promise<unknown>} onSubmit */
-export function inputForm(document: Document, declaration: import("@zixcel/interaction/input").InputDeclaration, onSubmit: (values: Record<string, string | boolean | number>) => unknown | Promise<unknown>): {
-    form: HTMLFormElement;
-    close(): void;
-};
-export { createWorldSurface } from "./world-surface.mjs";
-export { symbol } from "./symbol.mjs";
-export { windowFrame } from "./frame.mjs";
-export { worldControlGuide } from "./world-input.mjs";
-export { spatialView } from "./spatial.mjs";
-export { structureGraph } from "./structure-graph.mjs";
-export const renderBounds: Readonly<{
-    nodes: 8192;
-    depth: 20;
-    textBytes: 524288;
-}>;
-export class SceneRenderer {
-    /** @param {HTMLElement} root
-     * @param {(kind:string,value:string|import('@zixcel/projection-client').ActionHandle|undefined)=>void} onEvent
-     * @param {{tools?:HTMLElement,details?:HTMLElement,actions?:HTMLElement}} [slots]
-     * @param {ReturnType<typeof createWorldSurface>|null} [surface] */
-    constructor(root: HTMLElement, onEvent: (kind: string, value: string | import("@zixcel/projection-client").ActionHandle | undefined) => void, slots?: {
-        tools?: HTMLElement;
-        details?: HTMLElement;
-        actions?: HTMLElement;
-    }, surface?: ReturnType<typeof createWorldSurface> | null);
-    /** @param {import('@zixcel/projection-client').RenderPlan} plan */
-    render(plan: import("@zixcel/projection-client").RenderPlan): void;
-    /** @param {import('@zixcel/projection-client').Camera} value */
-    camera(value: import("@zixcel/projection-client").Camera): void;
-    speaker(value: any): void;
-    garden(value: any): void;
-    activity(value: any): void;
-    /** @param {'in'|'out'|'up'|'down'|'left'|'right'|'reset'} action */
-    changeCamera(action: "in" | "out" | "up" | "down" | "left" | "right" | "reset"): void;
-    close(): void;
-    dispose(): void;
-    #private;
-}
-import { createWorldSurface } from './world-surface.mjs';
+export { element, valueView, renderBounds } from './dom-elements.mjs';
+export { inputForm } from './input-form.mjs';
+export { SceneRenderer } from './scene-renderer.mjs';
+export type { SceneActor, SceneGarden, SceneSlots, SceneEvents } from './scene-renderer.mjs';
+export { createWorldSurface } from './world-surface.mjs';
+export type { World, WorldSurface, WorldOptions, WorldSnapshot, ActivityPresentation } from './world-api.mjs';
+export { symbol } from './symbol.mjs';
+export { windowFrame } from './frame.mjs';
+export { worldControlGuide } from './world-input.mjs';
+export { spatialView } from './spatial.mjs';
+export { structureGraph } from './structure-graph.mjs';

package/src/index.mjs

@@ -1,205 +1,9 @@
-// Trusted installed DOM primitives. All external values are text, never HTML.
-// Hatter downstream 2026: one bounded DOM tree for spatial and structured Scenes.
-import {validateInputDeclaration,validateInputValues} from '@zixcel/interaction/input'
-import {spatialView} from './spatial.mjs'
-import {symbol} from './symbol.mjs'
-import {reconcileChildren} from './reconcile.mjs'
-import {createWorldSurface} from './world-surface.mjs'
-import {bookReader} from './book-reader.mjs'
-export {createWorldSurface} from './world-surface.mjs'
-export {symbol} from './symbol.mjs'
-export {windowFrame} from './frame.mjs'
-export {worldControlGuide} from './world-input.mjs'
-export {spatialView} from './spatial.mjs'
-export {structureGraph} from './structure-graph.mjs'
-export const renderBounds=Object.freeze({nodes:8192,depth:20,textBytes:524288})
-const fail=code=>{throw Object.assign(Error(code),{code})}
-/** @template {keyof HTMLElementTagNameMap} K
- * @param {Document} document
- * @param {K} tag
- * @param {unknown} [text]
- * @param {Record<string,unknown>} [attrs]
- * @returns {HTMLElementTagNameMap[K]} */
-export function element(document,tag,text=null,attrs={}){
- const node=document.createElement(tag);if(text!==null)node.textContent=String(text)
- for(const [key,value]of Object.entries(attrs))if(value!==null)node.setAttribute(key,String(value))
- return node
-}
-/** @param {Document} document
- * @param {unknown} value
- * @param {{nodes:number,bytes:number}} [budget]
- * @returns {HTMLElement} */
-export function valueView(document,value,budget={nodes:0,bytes:0}){
- const walk=(value,depth)=>{
-  if(++budget.nodes>renderBounds.nodes||depth>renderBounds.depth)fail('RenderLimitExceeded')
-  if(value===null||typeof value!=='object'){
-   const text=JSON.stringify(value);if(typeof text!=='string')fail('InvalidRenderValue')
-   budget.bytes+=new TextEncoder().encode(text).length;if(budget.bytes>renderBounds.textBytes)fail('RenderLimitExceeded')
-   return element(document,'span',text,{'data-projection-scalar':text})
-  }
-  if(Object.keys(value).length>4096)fail('RenderLimitExceeded')
-  if(!Object.keys(value).length)return element(document,'span',Array.isArray(value)?'[]':'{}',{'data-empty-value':Array.isArray(value)?'array':'object'})
-  const list=element(document,Array.isArray(value)?'ol':'dl')
-  for(const [key,child]of Object.entries(value)){
-   if(Array.isArray(value)){const item=element(document,'li');item.append(walk(child,depth+1));list.append(item)}
-   else{const name=element(document,'dt',key),item=element(document,'dd');item.append(walk(child,depth+1));list.append(name,item)}
-  }
-  return list
- }
- return walk(value,0)
-}
-export class SceneRenderer{
- #root;#events;#abort=null;#actionHandles=new Map();#spatial=null;#slots;#pose=null;#poseKey=null;#speaker=null;#surface;#ownsSurface;#garden=null
- /** @param {HTMLElement} root
-  * @param {(kind:string,value:string|import('@zixcel/projection-client').ActionHandle|undefined)=>void} onEvent
-  * @param {{tools?:HTMLElement,details?:HTMLElement,actions?:HTMLElement}} [slots]
-  * @param {ReturnType<typeof createWorldSurface>|null} [surface] */
- constructor(root,onEvent,slots={},surface=null){this.#root=root;this.#events=onEvent;this.#slots=slots;this.#surface=surface??createWorldSurface();this.#ownsSurface=!surface}
- /** @param {import('@zixcel/projection-client').RenderPlan} plan */
- render(plan){
-  const root=this.#root,document=root.ownerDocument,focused=document.activeElement?.dataset.control
-  const previous=root.querySelector('[data-render-key]'),oldViewport=root.querySelector('.scene-viewport')
-  const scroll=previous?.dataset.renderKey===plan.projectionKey&&previous.dataset.viewMode===plan.viewMode&&oldViewport
-    ?{left:oldViewport.scrollLeft,top:oldViewport.scrollTop}:null
-  if(this.#poseKey===plan.projectionKey)this.#pose=this.#spatial?.snapshot()??this.#pose
-  else this.#pose=null
-  this.#poseKey=plan.projectionKey
-  this.#spatial?.close();this.#spatial=null;this.#abort?.abort();this.#abort=new AbortController();this.#actionHandles.clear()
-  if(!['spatial','structured'].includes(plan.viewMode)||!Array.isArray(plan.relations)||plan.relations.length>512)fail('InvalidRenderPlan')
-  const section=element(document,'section',null,{'data-render-revision':plan.projectionRevision,'data-render-key':plan.projectionKey,'data-view-mode':plan.viewMode,'aria-label':'Scene content',tabindex:'-1',class:'semantic-scene'})
-  const button=(label,kind,id,attrs={})=>element(document,'button',label,{type:'button','data-kind':kind,'data-control':JSON.stringify([kind,id]),'data-target':id,...attrs})
-  const views=element(document,'div',null,{role:'group','aria-label':'Scene view',class:'scene-view-controls'})
-  for(const [mode,label]of [['spatial','Spatial view'],['structured','List view']])views.append(button(label,'view',mode,{'aria-pressed':plan.viewMode===mode}))
-  const tools=this.#slots.tools??section;tools.replaceChildren();tools.append(views)
-  const viewport=element(document,'div',null,{class:'scene-viewport',tabindex:'0','aria-label':'Explore information in this space'}),board=element(document,'div',null,{class:'spatial-board'})
-  for(const person of this.#garden?.actors??(this.#speaker?[this.#speaker]:[])){const actor=button('',this.#garden?'actor':'conversation',person.id,{'data-world-object':person.id,'data-selected':person.id===this.#speaker?.id,'data-observation-label':person.preparation?.label??''});actor.append(element(document,'strong',person.title));actor.disabled=person.status!==undefined&&person.status!=='Available';board.append(actor)}
-  const camera=element(document,'div',null,{role:'group','aria-label':'View position',class:'scene-camera'})
-  for(const [id,label,icon]of [['left','Move left','←'],['right','Move right','→'],['in','Zoom in','+'],['out','Zoom out','−'],['reset','View all','⛶']])camera.append(button(icon,'camera',id,{'aria-label':label,title:label}))
-  if(plan.viewMode==='spatial')tools.append(camera)
-  viewport.append(board);(plan.viewMode==='structured'?tools:section).append(viewport)
-  if(plan.empty)section.append(element(document,'p','No projected information is available.',{role:'status'}))
-  if(plan.truncated)section.append(element(document,'p','The source reports incomplete information.',{role:'status'}))
-  const groups=[...plan.regions,...(plan.unplaced.length?[{id:'unplaced',role:'Context',items:plan.unplaced}]:[])]
-  if(groups.length>17||plan.actions.length>64)fail('RenderLimitExceeded')
-  for(const group of groups){
-   const region=element(document,'section',null,{'data-region':group.id}),list=element(document,'ul',null,{class:'scene-items'})
-   region.append(element(document,'h2',group.role),list)
-   for(const item of group.items){
-    const row=element(document,'li',null,{'data-item-id':item.id,'data-selected':item.selected,'data-related':item.related,'data-focused':item.focused}),toolbar=element(document,'div',null,{class:'item-tools'})
-    const itemButton=(label,kind,attrs={})=>button(label,kind,item.id,{'data-control':JSON.stringify([group.id,kind,item.id]),...attrs})
-    toolbar.append(itemButton(item.display?.title??item.content.reason??'Display not configured','select',{'aria-pressed':item.selected}),itemButton('View details','inspect',{'aria-expanded':plan.inspector?.id===item.id,'aria-haspopup':'dialog'}))
-    if(item.content.reason)toolbar.append(itemButton('Review','resolve'))
-    const solid=element(document,'span',null,{class:'object-solid','aria-hidden':'true'})
-    solid.append(symbol(document,item.display?.symbol??'nodes'));row.append(solid,toolbar)
-    if(item.display?.summary)row.append(element(document,'p',item.display.summary,{'data-item-summary':item.id}))
-    const fields=element(document,'dl',null,{class:'object-fields'})
-    for(const field of item.display?.fields??[])fields.append(element(document,'dt',field.label),element(document,'dd',field.value===null?'Not set':String(field.value),{'data-projection-scalar':JSON.stringify(field.value)}))
-    row.append(fields)
-    if(!item.display)row.append(element(document,'p',item.content.reason?'This information is not yet resolved. Review the available choices or the missing requirements.':'Display information is not configured. Inspect this object in System.'))
-    list.append(row)
-   }
-   board.append(region)
-  }
-  const time=element(document,'section',null,{'aria-label':'Scene time',class:'scene-time'})
-  time.append(element(document,'h2',plan.temporal?.label??'Time'))
-  if(plan.temporal?.items.length){
-   time.append(button('All times','time','',{'aria-pressed':plan.temporal.cursor===null}))
-   for(const item of plan.temporal.items){const control=button(item.at+' · '+item.itemId,'time',item.itemId,{'aria-pressed':plan.temporal.cursor===item.itemId});time.append(control)}
-  }else time.append(element(document,'p','No event time has been declared by this source.',{role:'status'}))
-  tools.append(time)
-  if(plan.relations.length){
-   const relations=element(document,'details',null,{'aria-label':'Relationships'}),list=element(document,'ul',null,{class:'scene-relations'})
-   relations.append(element(document,'summary','Relationships ('+plan.relations.length+')'),list)
-   for(const relation of plan.relations){
-    const row=element(document,'li',null,{'data-relation-id':relation.id,'data-active':relation.active})
-    row.append(button(relation.from,'select',relation.from,{'data-control':JSON.stringify(['relation',relation.id,'from']),'aria-label':'Select related '+relation.from}),element(document,'span','→ '+relation.relationRef+' →'),button(relation.to,'select',relation.to,{'data-control':JSON.stringify(['relation',relation.id,'to']),'aria-label':'Select related '+relation.to}))
-    list.append(row)
-   }
-   tools.append(relations)
-  }
-  const actions=this.#slots.actions??tools;if(this.#slots.actions)actions.replaceChildren()
-  // Unresolved owner observations are conversation material too, including
-  // when no executable choice exists. This does not manufacture an action.
-  const pending=groups.flatMap(group=>group.items).filter(item=>item.content.reason)
-  if(pending.length){
-   const questions=element(document,'section',null,{'aria-label':'Information needing clarification'})
-   questions.append(element(document,'h3','Why this information needs review'))
-   for(const item of pending){
-    const row=element(document,'div',null,{'data-unresolved-ref':item.id})
-    const explanation=this.#slots.describeUnresolved?.(item.content.reason)??{label:String(item.content.reason),detail:'The source owner reported this unresolved reason.'}
-    row.append(button(item.display?.title??explanation.label,'resolve',item.id),element(document,'small',explanation.detail))
-    questions.append(row)
-   }
-   actions.append(questions)
-  }
-  for(const action of plan.actions){this.#actionHandles.set(action.handle.actionId,action.handle);actions.append(button(action.descriptor.label,'action',action.handle.actionId))}
-  const lastBook=(this.#slots.details??root).querySelector('[data-book-id]'),bookPosition=lastBook?{id:lastBook.dataset.bookId,revision:lastBook.dataset.bookRevision,page:Number(lastBook.dataset.bookPage)}:null
-  this.#slots.details?.replaceChildren()
-  if(plan.inspector){
-   const chosen=groups.flatMap(r=>r.items).find(i=>i.id===plan.inspector.id)
-   if(chosen)(this.#slots.details??section).append(bookReader(document,chosen,plan.projectionRevision,button('Close book','dismiss',plan.inspector.id),this.#abort.signal,bookPosition))
-  }
-  reconcileChildren(root,[section])
-  const activeViewport=plan.viewMode==='spatial'?root.querySelector('.scene-viewport'):viewport,activeBoard=activeViewport.querySelector('.spatial-board')
-  if(plan.viewMode==='spatial'||this.#garden)this.#spatial=spatialView(this.#garden?.host??activeViewport,activeBoard,plan.camera,plan.relations,this.#abort.signal,this.#pose,null,{
-   surface:this.#surface,activity:this.#garden?.activity,target:this.#garden?'garden':plan.projectionKey,context:this.#garden?plan.projectionKey:null,pattern:this.#garden?'garden':'constellation',items:new Map(groups.flatMap(region=>region.items.map(item=>[item.id,{
-    anchor:this.#speaker?.id,group:item.content.group,semanticRef:item.content.semanticRef,sourceRefs:item.content.sourceRefs,scalars:(item.display?.fields??[]).map(f=>f.value),unresolved:Boolean(item.content.reason),changeKey:JSON.stringify(item.display?.fields??[])
-   }])))
-  })
-  if(this.#garden&&plan.viewMode==='structured')activeBoard.hidden=false
-  for(const host of new Set([root,this.#slots.tools,this.#slots.details,this.#slots.actions].filter(Boolean)))host.addEventListener('click',event=>{
-   const target=event.target.closest('button[data-kind]');if(!target||!host.contains(target))return
-   if(target.dataset.kind==='camera'){this.#spatial?.change(target.dataset.target);return}
-   this.#events(target.dataset.kind,target.dataset.kind==='action'?this.#actionHandles.get(target.dataset.target):target.dataset.target)
-  },{signal:this.#abort.signal})
-  if(focused)[...root.querySelectorAll('[data-control]')].find(n=>n.dataset.control===focused)?.focus({preventScroll:true})
-  if(scroll){viewport.scrollLeft=scroll.left;viewport.scrollTop=scroll.top}
- }
- /** @param {import('@zixcel/projection-client').Camera} value */
- camera(value){this.#spatial?.apply(value)}
- speaker(value){this.#speaker=value}
- garden(value){this.#garden=value}
- activity(value){this.#spatial?.activity(value)}
- /** @param {'in'|'out'|'up'|'down'|'left'|'right'|'reset'} action */
- changeCamera(action){this.#spatial?.change(action)}
- close(){this.#spatial?.close();this.#spatial=null;this.#abort?.abort();this.#actionHandles.clear();this.#root.replaceChildren();for(const slot of new Set([this.#slots.tools,this.#slots.details,this.#slots.actions].filter(Boolean)))slot.replaceChildren();if(this.#ownsSurface){this.#surface.close();this.#surface=createWorldSurface()}}
- dispose(){this.close();if(this.#ownsSurface)this.#surface.close()}
-}
-/** @param {Document} document
- * @param {import('@zixcel/interaction/input').InputDeclaration} declaration
- * @param {(values:Record<string,string|boolean|number>)=>unknown|Promise<unknown>} onSubmit */
-export function inputForm(document,declaration,onSubmit){
- if(validateInputDeclaration(declaration).length)fail('InvalidInputDeclaration')
- const form=element(document,'form'),fields=new Map(),abort=new AbortController(),prefix='input-'+crypto.randomUUID()
- const fieldIds=[...new Set([...declaration.action.input_schema.required,...Object.keys(declaration.fields)])]
- for(const id of fieldIds){
-  const field=declaration.fields[id]
-  const schema=declaration.action.input_schema.fields[id],label=element(document,'label'),name=element(document,'span',field.label)
-  let input
-  if(field.choices){input=element(document,'select');input.append(element(document,'option','Choose…',{value:''}));for(const choice of field.choices)input.append(element(document,'option',choice.label,{value:choice.value}))}
-  else if(schema.type==='string'&&!field.sensitive&&schema.max_length>255){input=element(document,'textarea');input.rows=4;input.maxLength=schema.max_length}
-  else{input=element(document,'input');input.type=schema.type==='boolean'?'checkbox':['integer','number'].includes(schema.type)?'number':field.sensitive?'password':'text'
-   if(schema.type==='string')input.maxLength=schema.max_length??4096
-   if(schema.type==='integer')input.step='1'
-   if(schema.type==='number')input.step='any'
-   if(schema.minimum!==undefined)input.min=String(schema.minimum)
-   if(schema.maximum!==undefined)input.max=String(schema.maximum)
-  }
-  input.id=prefix+'-'+fields.size;input.name=id;input.autocomplete='off';label.htmlFor=input.id;label.append(name);form.append(label,input);fields.set(id,{input,schema})
- }
- const submit=element(document,'button','Submit',{type:'submit'}),status=element(document,'div','',{role:'status'});form.append(submit,status)
- form.addEventListener('submit',async event=>{
-  event.preventDefault();if(submit.disabled)return
-  const values={};for(const [id,{input,schema}]of fields){
-   // An absent optional value is not zero, null, false or an empty string.
-   if(input.value===''&&schema.type!=='boolean'&&!declaration.action.input_schema.required.includes(id))continue
-   values[id]=schema.type==='boolean'?input.checked:['number','integer'].includes(schema.type)?(input.value===''?null:Number(input.value)):input.value
-  }
-  if(validateInputValues(declaration,values).length){status.textContent='Check the declared input constraints.';return}
-  submit.disabled=true;form.setAttribute('aria-busy','true')
-  try{await onSubmit(values);if(!abort.signal.aborted)status.textContent='Submitted.'}
-  catch(error){if(!abort.signal.aborted){status.setAttribute('role','alert');status.replaceChildren(valueView(document,{code:error.code??'OperationUnavailable',...(error.ownerFailure?{ownerFailure:error.ownerFailure}:{})}))}}
-  finally{for(const {input}of fields.values())if(input.type==='password')input.value='';submit.disabled=false;form.setAttribute('aria-busy','false')}
- },{signal:abort.signal})
- return {form,close(){abort.abort();for(const {input}of fields.values())input.value='';form.remove()}}
-}
+export { element, valueView, renderBounds } from './dom-elements.mjs';
+export { inputForm } from './input-form.mjs';
+export { SceneRenderer } from './scene-renderer.mjs';
+export { createWorldSurface } from './world-surface.mjs';
+export { symbol } from './symbol.mjs';
+export { windowFrame } from './frame.mjs';
+export { worldControlGuide } from './world-input.mjs';
+export { spatialView } from './spatial.mjs';
+export { structureGraph } from './structure-graph.mjs';

package/src/input-form.d.mts

@@ -0,0 +1,5 @@
+import type { InputDeclaration } from '@zixcel/interaction/input';
+export declare function inputForm(document: Document, declaration: InputDeclaration, onSubmit: (values: Record<string, string | boolean | number>) => unknown | Promise<unknown>): {
+    form: HTMLFormElement;
+    close(): void;
+};

package/src/input-form.mjs

@@ -0,0 +1,103 @@
+import { validateInputDeclaration, validateInputValues } from '@zixcel/interaction/input';
+import { element, valueView, fail } from './dom-elements.mjs';
+import { record } from './world-api.mjs';
+function scalar(value) {
+    if (value.type === 'boolean')
+        return { type: 'boolean' };
+    if (value.type === 'string' || value.type === 'number' || value.type === 'integer')
+        return value;
+    return fail('InvalidInputDeclaration');
+}
+export function inputForm(document, declaration, onSubmit) {
+    if (validateInputDeclaration(declaration).length || declaration.action.input_schema.type !== 'object')
+        fail('InvalidInputDeclaration');
+    const contract = declaration.action.input_schema, required = contract.required ?? [];
+    const form = element(document, 'form'), fields = new Map(), abort = new AbortController(), prefix = 'input-' + crypto.randomUUID();
+    const fieldIds = [...new Set([...required, ...Object.keys(declaration.fields)])];
+    for (const id of fieldIds) {
+        const field = declaration.fields[id], schema = scalar(contract.fields[id]), label = element(document, 'label'), name = element(document, 'span', field.label);
+        let input;
+        if (field.choices) {
+            input = element(document, 'select');
+            input.append(element(document, 'option', 'Choose…', { value: '' }));
+            for (const choice of field.choices)
+                input.append(element(document, 'option', choice.label, { value: choice.value }));
+        }
+        else if (schema.type === 'string' && (schema.max_length ?? 0) > 255 && !field.sensitive) {
+            input = element(document, 'textarea');
+            input.rows = 4;
+            input.maxLength = schema.max_length ?? 4096;
+        }
+        else {
+            input = element(document, 'input');
+            input.type = schema.type === 'boolean' ? 'checkbox' : schema.type === 'integer' || schema.type === 'number' ? 'number' : field.sensitive ? 'password' : 'text';
+            if (schema.type === 'string')
+                input.maxLength = schema.max_length ?? 4096;
+            if (schema.type === 'integer')
+                input.step = '1';
+            if (schema.type === 'number')
+                input.step = 'any';
+            if (schema.type === 'integer' || schema.type === 'number') {
+                input.min = String(schema.minimum);
+                input.max = String(schema.maximum);
+            }
+        }
+        input.id = prefix + '-' + fields.size;
+        input.name = id;
+        input.autocomplete = 'off';
+        label.htmlFor = input.id;
+        label.append(name);
+        form.append(label, input);
+        fields.set(id, { input, schema });
+    }
+    const submit = element(document, 'button', 'Submit', { type: 'submit' }), status = element(document, 'div', '', { role: 'status' });
+    form.append(submit, status);
+    form.addEventListener('submit', async (event) => {
+        event.preventDefault();
+        if (submit.disabled)
+            return;
+        const values = {};
+        for (const [id, { input, schema }] of fields) {
+            if (input.value === '' && schema.type !== 'boolean' && !required.includes(id))
+                continue;
+            if (schema.type === 'boolean')
+                values[id] = 'checked' in input ? input.checked : false;
+            else if (schema.type === 'integer' || schema.type === 'number') {
+                if (input.value === '') {
+                    status.textContent = 'Check the declared input constraints.';
+                    return;
+                }
+                values[id] = Number(input.value);
+            }
+            else
+                values[id] = input.value;
+        }
+        if (validateInputValues(declaration, values).length) {
+            status.textContent = 'Check the declared input constraints.';
+            return;
+        }
+        submit.disabled = true;
+        form.setAttribute('aria-busy', 'true');
+        try {
+            await onSubmit(values);
+            if (!abort.signal.aborted)
+                status.textContent = 'Submitted.';
+        }
+        catch (error) {
+            const value = record(error);
+            if (!abort.signal.aborted) {
+                status.setAttribute('role', 'alert');
+                status.replaceChildren(valueView(document, { code: value.code ?? 'OperationUnavailable', ...(value.ownerFailure ? { ownerFailure: value.ownerFailure } : {}) }));
+            }
+        }
+        finally {
+            for (const { input } of fields.values())
+                if (input.type === 'password')
+                    input.value = '';
+            submit.disabled = false;
+            form.setAttribute('aria-busy', 'false');
+        }
+    }, { signal: abort.signal });
+    return { form, close() { abort.abort(); for (const { input } of fields.values())
+            input.value = ''; form.remove(); } };
+}

package/src/inspection-overview.d.mts

@@ -1 +1,27 @@
-export function inspectionOverview(document: any, host: any, view: any, onSource: any, signal: any): void;
+export interface InspectionOverview {
+    readonly title: string;
+    readonly note: string;
+    readonly modulesAvailable: boolean;
+    readonly modulesPartial?: boolean;
+    readonly groups: readonly {
+        readonly id: string;
+        readonly title: string;
+        readonly note: string;
+        readonly state: string;
+        readonly measures: readonly {
+            readonly unit: string;
+            readonly value: number | null;
+            readonly partial?: boolean;
+            readonly documentId?: string;
+        }[];
+        readonly values?: readonly string[];
+    }[];
+    readonly modules: readonly {
+        readonly id: string;
+        readonly version: string;
+        readonly terms: number;
+        readonly expressions: number;
+        readonly dependencies: readonly string[];
+    }[];
+}
+export declare function inspectionOverview(document: Document, host: HTMLElement, view: InspectionOverview | null, onSource: (id: string) => void, signal: AbortSignal): void;

package/src/inspection-overview.mjs

@@ -1,35 +1,52 @@
 // Owner-projected facts only. This renderer does not classify semantic modules.
-import {element} from './index.mjs'
-export function inspectionOverview(document,host,view,onSource,signal){
- host.replaceChildren()
- if(!view){host.append(element(document,'p','Responsibility overview is unavailable.'));return}
- host.append(element(document,'h2',view.title),element(document,'p',view.note,{class:'inspection-note'}))
- const groups=element(document,'ul',null,{class:'scene-items'})
- groups.style.gridTemplateColumns='repeat(auto-fit,minmax(min(250px,100%),1fr))'
- for(const group of view.groups){
-  const section=element(document,'li',null,{'aria-label':group.title,'data-responsibility':group.id})
-  const info=element(document,'details'),description=element(document,'summary','About these observations')
-  info.append(description,element(document,'p',group.note))
-  section.append(element(document,'h3',group.title),element(document,'p',group.state,{class:'inspection-state'}))
-  for(const measure of group.measures){
-   const row=element(document,'div',null,{class:'item-tools','data-measure':measure.unit})
-   row.append(element(document,'strong',measure.value===null?'Unavailable':String(measure.value)+(measure.partial?' +':'')),element(document,'span',measure.unit))
-   if(measure.documentId){const button=element(document,'button','Inspect',{type:'button','aria-label':'Inspect '+measure.unit});button.addEventListener('click',()=>onSource(measure.documentId),{signal});row.append(button)}
-   section.append(row)
-  }
-  if(group.values?.length)section.append(element(document,'p',group.values.join(' · ')))
-  section.append(info);groups.append(section)
- }
- host.append(groups,element(document,'h3','Adopted definition modules'))
- if(!view.modulesAvailable){host.append(element(document,'p','Module data unavailable.'));return}
- if(!view.modules.length){host.append(element(document,'p','No definition modules in the observed role.'));return}
- const list=element(document,'ul',null,{class:'inspection-modules'})
- for(const module of view.modules){
-  const item=element(document,'li'),button=element(document,'button',module.id,{type:'button'})
-  button.addEventListener('click',()=>onSource('definitions'),{signal})
-  item.append(button,element(document,'p',`${module.version} · ${module.terms} terms · ${module.expressions} expressions`),element(document,'p',module.dependencies.length?'Imports: '+module.dependencies.join(', '):'No declared imports'))
-  list.append(item)
- }
- host.append(list)
- if(view.modulesPartial)host.append(element(document,'p','Module inventory is incomplete.'))
+import { element } from './dom-elements.mjs';
+export function inspectionOverview(document, host, view, onSource, signal) {
+    host.replaceChildren();
+    if (!view) {
+        host.append(element(document, 'p', 'Responsibility overview is unavailable.'));
+        return;
+    }
+    host.append(element(document, 'h2', view.title), element(document, 'p', view.note, { class: 'inspection-note' }));
+    const groups = element(document, 'ul', null, { class: 'scene-items' });
+    groups.style.gridTemplateColumns = 'repeat(auto-fit,minmax(min(250px,100%),1fr))';
+    for (const group of view.groups) {
+        const section = element(document, 'li', null, { 'aria-label': group.title, 'data-responsibility': group.id });
+        const info = element(document, 'details'), description = element(document, 'summary', 'About these observations');
+        info.append(description, element(document, 'p', group.note));
+        section.append(element(document, 'h3', group.title), element(document, 'p', group.state, { class: 'inspection-state' }));
+        for (const measure of group.measures) {
+            const row = element(document, 'div', null, { class: 'item-tools', 'data-measure': measure.unit });
+            row.append(element(document, 'strong', measure.value === null ? 'Unavailable' : String(measure.value) + (measure.partial ? ' +' : '')), element(document, 'span', measure.unit));
+            if (measure.documentId) {
+                const documentId = measure.documentId;
+                const button = element(document, 'button', 'Inspect', { type: 'button', 'aria-label': 'Inspect ' + measure.unit });
+                button.addEventListener('click', () => onSource(documentId), { signal });
+                row.append(button);
+            }
+            section.append(row);
+        }
+        if (group.values?.length)
+            section.append(element(document, 'p', group.values.join(' · ')));
+        section.append(info);
+        groups.append(section);
+    }
+    host.append(groups, element(document, 'h3', 'Adopted definition modules'));
+    if (!view.modulesAvailable) {
+        host.append(element(document, 'p', 'Module data unavailable.'));
+        return;
+    }
+    if (!view.modules.length) {
+        host.append(element(document, 'p', 'No definition modules in the observed role.'));
+        return;
+    }
+    const list = element(document, 'ul', null, { class: 'inspection-modules' });
+    for (const module of view.modules) {
+        const item = element(document, 'li'), button = element(document, 'button', module.id, { type: 'button' });
+        button.addEventListener('click', () => onSource('definitions'), { signal });
+        item.append(button, element(document, 'p', `${module.version} · ${module.terms} terms · ${module.expressions} expressions`), element(document, 'p', module.dependencies.length ? 'Imports: ' + module.dependencies.join(', ') : 'No declared imports'));
+        list.append(item);
+    }
+    host.append(list);
+    if (view.modulesPartial)
+        host.append(element(document, 'p', 'Module inventory is incomplete.'));
 }

package/src/npc-motion.d.mts

@@ -1,4 +1,4 @@
-export function npcMotion(id: any, milliseconds: any, state?: string): {
+export declare function npcMotion(id: string, milliseconds: number, state?: string): {
     x: number;
     y: number;
     swing: number;

package/src/npc-motion.mjs

@@ -1,7 +1,7 @@
 // Ambient presentation only. This never changes semantic position or Work.
-export function npcMotion(id,milliseconds,state='Idle'){
- const seed=[...id].reduce((n,c)=>(Math.imul(n,31)+c.charCodeAt(0))|0,0)>>>0
- const active=['Runnable','Running','AwaitingResult'].includes(state)
- const phase=milliseconds/1000*(active?2.2:1.1)*(0.85+(seed%7)/20)+(seed%97)*.31
- return {x:Math.sin(phase)*(active?.2:.08),y:Math.max(0,Math.sin(phase*1.7))*(active?.12:.04),swing:Math.sin(phase*1.4)*(active?.16:.08)}
+export function npcMotion(id, milliseconds, state = 'Idle') {
+    const seed = [...id].reduce((n, c) => (Math.imul(n, 31) + c.charCodeAt(0)) | 0, 0) >>> 0;
+    const active = ['Runnable', 'Running', 'AwaitingResult'].includes(state);
+    const phase = milliseconds / 1000 * (active ? 2.2 : 1.1) * (0.85 + (seed % 7) / 20) + (seed % 97) * .31;
+    return { x: Math.sin(phase) * (active ? .2 : .08), y: Math.max(0, Math.sin(phase * 1.7)) * (active ? .12 : .04), swing: Math.sin(phase * 1.4) * (active ? .16 : .08) };
 }

package/src/object-presentation.d.mts

@@ -1,13 +1,20 @@
-export function objectPresentation(item: any): {
-    form: any;
-    dataType?: undefined;
-    needsReview?: undefined;
-} | {
-    form: string;
-    dataType: any;
-    needsReview: boolean;
-};
-export const spacingPresets: Readonly<{
+export type ObjectForm = 'person' | 'organization' | 'system' | 'shelf' | 'book';
+export type ObjectTint = 'dark' | 'accent' | 'light' | 'face' | 'warning';
+export type ObjectPart = readonly [number, number, number, number, number, number, ObjectTint];
+export interface PresentationInput {
+    id?: string;
+    title?: string;
+    form?: string;
+    kind?: string;
+    scalars?: readonly unknown[];
+    unresolved?: unknown;
+}
+export interface ObjectPresentation {
+    form: ObjectForm;
+    dataType?: 'text' | 'number' | 'boolean' | 'record';
+    needsReview?: boolean;
+}
+export declare const spacingPresets: Readonly<{
     compact: {
         person: number;
         group: number;
@@ -24,14 +31,14 @@ export const spacingPresets: Readonly<{
         member: number;
     };
 }>;
-export const objectForms: Readonly<{
+export declare const objectForms: Readonly<{
     person: "Person";
     organization: "Organization";
     system: "System";
     shelf: "Bookshelf";
     book: "Book";
 }>;
-export const libraryLayout: Readonly<{
+export declare const libraryLayout: Readonly<{
     columns: 6;
     rows: 4;
     slotWidth: 0.46;
@@ -39,17 +46,6 @@ export const libraryLayout: Readonly<{
     baseY: 0.32;
     frontZ: 0.32;
 }>;
-export const objectBounds: Readonly<{
-    person: number[];
-    organization: number[];
-    system: number[];
-    shelf: number[];
-    book: number[];
-}>;
-export const objectTemplates: Readonly<{
-    person: (string | number)[][];
-    organization: (string | number)[][];
-    system: (string | number)[][];
-    shelf: (string | number)[][];
-    book: (string | number)[][];
-}>;
+export declare const objectBounds: Readonly<Record<ObjectForm, readonly [number, number, number]>>;
+export declare const objectTemplates: Readonly<Record<ObjectForm, readonly ObjectPart[]>>;
+export declare function objectPresentation(item: PresentationInput): ObjectPresentation;