stillmade-sdk 0.1.36 → 0.1.38

package/packages/block-sdk/shared-controls.js

@@ -4,13 +4,21 @@ export function installSharedControls(document,api,onError,textControls=null,loc
  const bindings=new Map(),TEXT_TYPES=['text','search','email','tel','url'];
  const lockedInputs=new Set(lockedInputKeys);
  const deferred=new Map(),running=new Set(),deferredErrors=new Map();let closed=false;
+ // November 1, 2026 (live controller check): Chat set Narration's voice input to nova, and the screen showed Onyx, the
+ // fieldset's HTML default, because shared state had no voice yet. A shared field with the name of a Step input starts from
+ // that input's value until someone picks one; a value the field cannot show is ignored.
+ let inputDefaults={};
+ const shows=(radios,node,value)=>radios?radios.some(radio=>radio.value===String(value)):node.tagName!=='SELECT'||[...node.options].some(option=>option.value===String(value));
  const runDeferred=(key,entry)=>{
   clearTimeout(entry.timer);deferred.delete(key);if(closed)return;
   let task;task=Promise.resolve().then(()=>{if(!closed)return entry.callback();}).catch(error=>{deferredErrors.set(key,error);onError(error.message);}).finally(()=>running.delete(task));
   running.add(task);return task;
  };
  const scheduleSharedEdit=(key,callback)=>{
-  if(closed||typeof key!=='string'||!/^[a-zA-Z][a-zA-Z0-9_-]{0,99}$/.test(key)||typeof callback!=='function')throw Error('Use a named shared edit callback');
+  // Which part is wrong (November 2026: a Block author read this as being about the callback when its key had a +).
+  if(closed)throw Error('This interface has closed; shared edits stopped.');
+  if(typeof key!=='string'||!/^[a-zA-Z][a-zA-Z0-9_-]{0,99}$/.test(key))throw Error('A shared edit key starts with a letter and holds only letters, digits, - and _ (up to 100 characters).');
+  if(typeof callback!=='function')throw Error('Give scheduleSharedEdit a function to run.');
   if(!deferred.has(key)&&deferred.size+running.size>=32||!deferredErrors.has(key)&&deferredErrors.size>=32)throw Error('Too many scheduled shared edits');
   deferredErrors.delete(key);
   const previous=deferred.get(key),entry={callback,started:previous?.started??Date.now(),timer:null};
@@ -53,7 +61,7 @@ export function installSharedControls(document,api,onError,textControls=null,loc
   const picked=()=>radios.find(radio=>radio.checked)?.value??'';
   const write=value=>{const before=radios?picked():node.type==='checkbox'?node.checked:node.value;if(radios)for(const radio of radios)radio.checked=radio.value===String(value??'');else if(node.type==='checkbox')node.checked=!!value;else if(node.value!==String(value??''))node.value=String(value??'');if((radios?picked():node.type==='checkbox'?node.checked:node.value)!==before)queueMicrotask(()=>{if(!disposed)api.announce?.();});};
   const read=()=>radios?picked():node.type==='checkbox'?node.checked:['number','range'].includes(node.type)?node.valueAsNumber:node.value;
-  let fallback=read();
+  let fallback=Object.hasOwn(inputDefaults,key)&&shows(radios,node,inputDefaults[key])?inputDefaults[key]:read();
   const flush=()=>{
    clearTimeout(timer);timer=null;if(saving)return inFlight;if(disposed||composing||!dirty||!canEdit||problem)return;
    const value=draft;dirty=false;dirtySince=null;saving=true;let failed=false;
@@ -115,7 +123,7 @@ export function installSharedControls(document,api,onError,textControls=null,loc
   node.addEventListener('input',change);node.addEventListener('change',change);node.addEventListener(leave,flush);
   node.addEventListener('compositionstart',compositionStart);node.addEventListener('compositionend',compositionEnd);
   const dispose=()=>{disposed=true;composing=false;clearTimeout(timer);unsubscribe();node.removeEventListener('input',change);node.removeEventListener('change',change);node.removeEventListener(leave,flush);node.removeEventListener('compositionstart',compositionStart);node.removeEventListener('compositionend',compositionEnd);node.disabled=originallyDisabled;bindings.delete(key);};
-  bindings.set(key,{dispose,flush,status(){return {dirty,saving,problem,canEdit,composing,interrupted:retainedComposition!==undefined};},setDefault(value){fallback=value;receive(api.getShared());}});return dispose;
+  bindings.set(key,{dispose,flush,status(){return {dirty,saving,problem,canEdit,composing,interrupted:retainedComposition!==undefined};},setDefault(value){fallback=value;receive(api.getShared());},setInputDefault(value){if(shows(radios,node,value))this.setDefault(value);}});return dispose;
  };
  const bindAnnotated=()=>{
   const nodes=[...document.querySelectorAll('[data-stillmade-share]')];
@@ -155,5 +163,11 @@ export function installSharedControls(document,api,onError,textControls=null,loc
  return {bindShared,bindAnnotated,scheduleSharedEdit,flushAll,assertNoComposition,getBindingStatus:key=>bindings.get(key)?.status(),setSharedDefaults(values){
   if(!values||typeof values!=='object'||Array.isArray(values)||Object.keys(values).length>100||JSON.stringify(values).length>65536)throw Error('Use bounded shared control defaults');
   for(const [key,value] of Object.entries(values))bindings.get(key)?.setDefault(value);
+ },useInputDefaults(input){
+  // Only a default that changed is applied again: the host sends the input often, and re-writing every field from shared
+  // state each time hid a view that overwrote other people's edits from the two-participant check.
+  const previous=inputDefaults;inputDefaults={};
+  if(input&&typeof input==='object'&&!Array.isArray(input))for(const [key,value] of Object.entries(input))if(['string','number','boolean'].includes(typeof value))inputDefaults[key]=value;
+  for(const [key,binding] of bindings)if(Object.hasOwn(inputDefaults,key)&&!(Object.hasOwn(previous,key)&&previous[key]===inputDefaults[key]))binding.setInputDefault(inputDefaults[key]);
  },dispose(){closed=true;for(const entry of deferred.values())clearTimeout(entry.timer);deferred.clear();for(const binding of [...bindings.values()])binding.dispose();}};
 }

package/packages/block-sdk/testing.js

@@ -3,6 +3,7 @@ import {requiresDesktopExecution,validateDesktopExecution} from './desktop-execu
 import {validatePortableMetadata} from './portable.js';
 import {initialBlockState,validateBlockState} from './state.js';
 import { assert, digest, plain, safeDocument, stableStringify, validateManifest, validateValues } from './contracts.js';
+import {FILE_MEDIA_TYPES,DOCUMENT_FORMATS} from './data-values.js';
 import { validateRecipe } from './recipe.js';
 import { validateJavaScript } from './javascript.js';
 import { runPackageAsync } from './runtime.js';
@@ -12,6 +13,46 @@ import {CAPABILITY_LIMITS,validateCapability,prepareCapabilityInvocation,validat
 import {validateNativeApplicationPackage,NATIVE_APPLICATION_RUNTIME_REQUIREMENT} from './native-application-package.js';
 import {validateModuleDescriptor,MODULE_LIMITS} from './module-runtime.js';
 import {validateMocks} from './mocks.js';
+// October 27, 2026: in-app builds of module Blocks failed three repairs on "output document must be text": the
+// message named neither the fixture nor where the bad value was, so each repair changed the code and kept it. A
+// module fixture whose expected value is the wrong shape now says which fixture and port, and what that type holds.
+const reference=kind=>`{kind:'${kind}', assetId:'…', versionId:'…', url:'…'}, the saved reference exactly as the host returned it`;
+const VALUE_SHAPES=Object.freeze({
+ text:'a string',
+ file:`{kind:'file', assetId:'…', versionId:'…', mimeType:${FILE_MEDIA_TYPES.map(type=>`'${type}'`).join('|')}, url?, name?, bytes?}`,
+ document:`{schemaVersion:1, format:${DOCUMENT_FORMATS.map(format=>`'${format}'`).join('|')}, text:'…', title?:'…'} with no other keys`,
+ table:`{columns:['name', …], rows:[{name: text, number, true/false or null}], schemaVersion?:1} with no other keys`,
+ image:reference('image'),video:reference('video'),audio:reference('audio'),
+ asset:`{assetId:'…', versionId:'…', kind?, url?}, a saved reference exactly as the host returned it`,
+});
+const valueShape=type=>type.endsWith('[]')?VALUE_SHAPES[type.slice(0,-2)]&&`a plain array of ${type.slice(0,-2)} values, each ${VALUE_SHAPES[type.slice(0,-2)]}, with no wrapper objects`:VALUE_SHAPES[type];
+function fixtureExpectedMessage(outputs,fixture,error){
+ const name=/^output (.+?) must be /.exec(error.message)?.[1],type=Object.hasOwn(outputs,name??'')?String(outputs[name].type):null;
+ if(!type)return `Fixture "${fixture.name}": its expected outputs are wrong, not the code (${error.message}). expected holds exactly the declared output ports.`;
+ const shape=valueShape(type);
+ return `Fixture "${fixture.name}": expected.${name} is not a valid ${type} value, so the bad value is in this fixture's expected outputs, not the code (${error.message}).${shape?` ${/^[aeiou]/.test(type)?'An':'A'} ${type} value is ${shape}.`:''}`;
+}
+// October 27, 2026: a reference the stand-in host wrote (files.write in a module test) carries fields the host makes
+// (assetId local-written-file-N, versionId, url, bytes) that no model can predict. A module fixture compares it by
+// shape: an expected {kind, mimeType, name}, with those fields left out or given, matches when kind, mimeType and name
+// match. Every other value is compared exactly.
+const WRITTEN_KINDS=['file','image','video','audio'],HOST_MADE=['assetId','versionId','url','bytes'];
+const standInWritten=value=>plain(value)&&/^local-written-(?:file|image|video|audio)-\d+$/.test(String(value.assetId));
+const writtenShape=value=>plain(value)&&WRITTEN_KINDS.includes(value.kind)&&typeof value.mimeType==='string'&&Object.keys(value).every(key=>['kind','mimeType','name',...HOST_MADE].includes(key));
+// expected, with each reference that matches a stand-in-written output by shape replaced by that output.
+function matchWritten(actual,expected){
+ if(standInWritten(actual))return writtenShape(expected)&&['kind','mimeType','name'].every(key=>expected[key]===actual[key])?actual:expected;
+ if(Array.isArray(actual)&&Array.isArray(expected))return expected.map((value,index)=>matchWritten(actual[index],value));
+ if(plain(actual)&&plain(expected))return Object.fromEntries(Object.entries(expected).map(([key,value])=>[key,matchWritten(actual[key],value)]));
+ return expected;
+}
+// A module fixture's expected outputs for the type check: a file or media reference given by shape gets stand-in values
+// for the host-made fields it leaves out.
+function withStandInHostFields(outputs,expected){
+ if(!plain(outputs)||!plain(expected))return expected;
+ const fill=(value,type)=>type.endsWith('[]')?(Array.isArray(value)?value.map(item=>fill(item,type.slice(0,-2))):value):WRITTEN_KINDS.includes(type)&&value?.kind===type&&writtenShape(value)?{assetId:`local-written-${type}-1`,versionId:'v1',...value}:value;
+ return Object.fromEntries(Object.entries(expected).map(([name,value])=>[name,Object.hasOwn(outputs,name)?fill(value,String(outputs[name]?.type)):value]));
+}
 export function validatePackage(pkg) {
   safeDocument(pkg);
   if(pkg?.manifest?.runtime==='native-application')return validateNativeApplicationPackage(pkg);
@@ -54,7 +95,8 @@ export function validatePackage(pkg) {
   // hosted calls, actions and transforms it makes then cost nothing and give the same result each run.
   if(pkg.manifest.runtime === 'module')for(const fixture of pkg.tests){
     assert(fixture&&typeof fixture.name==='string'&&fixture.name.trim().length>0&&fixture.name.length<=200&&Object.keys(fixture).every(key=>['name','input','expected','mocks'].includes(key)),'TEST','Module fixtures need a name, input and the exact expected outputs, and may record mocks');
-    validateValues(pkg.manifest.inputs,fixture.input);validateValues(pkg.manifest.outputs,fixture.expected,'output');
+    validateValues(pkg.manifest.inputs,fixture.input);
+    try{validateValues(pkg.manifest.outputs,withStandInHostFields(pkg.manifest.outputs,fixture.expected),'output');}catch(error){assert(false,error.code||'TYPE',fixtureExpectedMessage(pkg.manifest.outputs,fixture,error));}
     if(fixture.mocks!==undefined)validateMocks(fixture.mocks);
   }
   if(pkg.manifest.runtime === 'capability'){
@@ -97,10 +139,11 @@ export async function testPackage(pkg, { timeoutMs = 10000, wasmLocation, comfyu
       if(pkg.manifest.runtime === 'comfyui')testComfyOutputs(pkg.manifest,outputs,test.expectations,{metadata});
       else if(pkg.manifest.runtime === 'capability')testCapabilityOutputs(pkg.manifest,outputs,test.expectations);
       else {
-        const actual=stableStringify(outputs),expected=stableStringify(test.expected);
+        const wanted=pkg.manifest.runtime==='module'?matchWritten(outputs,test.expected):test.expected;
+        const actual=stableStringify(outputs),expected=stableStringify(wanted);
         // Each output that differs, with both values, so a long output (a transcript) never hides the
         // one that differs; a module's failed host calls (in its log) say why (October 22, 2026).
-        const differing=[...new Set([...Object.keys(test.expected||{}),...Object.keys(outputs||{})])].filter(key=>stableStringify(outputs?.[key])!==stableStringify(test.expected?.[key]));
+        const differing=[...new Set([...Object.keys(test.expected||{}),...Object.keys(outputs||{})])].filter(key=>stableStringify(outputs?.[key])!==stableStringify(wanted?.[key]));
         const failedCalls=(logs||[]).filter(line=>/ failed: /.test(line)).slice(0,3);
         assert(actual===expected,'BEHAVIOR',`Output differs from expected fixture${differing.length?` in ${differing.join(', ')}`:''}. ${differing.length?differing.slice(0,4).map(key=>`${key}: expected ${String(stableStringify(test.expected?.[key])).slice(0,600)}; received ${String(stableStringify(outputs?.[key])).slice(0,600)}`).join('. '):`Expected ${expected.slice(0,1200)}; received ${actual.slice(0,1200)}`}${failedCalls.length?`. Host calls that failed: ${failedCalls.join('; ')}`:''}`);
       }

package/packages/block-sdk/view-design.js

@@ -42,6 +42,7 @@ export const BLOCK_INTERFACE_PRINCIPLES=Object.freeze([
  'Status sits beside the action it describes (`sm-status`), in a few words.',
  'Keep the page in normal scroll flow; no sticky media or control strips unless the editing task needs them.',
  'Use the width: from 860px wide the kit puts the controls on the left at a reading width (300–380px) and the result (`sm-stage`) fills the right, in its real shape; under that everything stacks with the result first and the action within reach. Extra width goes to the result, never to wider text fields. Before there is a result, the stage previews what will be made from the inputs. `data-layout="stack"` opts out.',
+ 'Size with the kit, never fixed sizes: no fixed pixel widths or heights for the workspace or stage, no 100vh, no position:fixed panels. StillMade zooms a Block\'s screen to fill the space it has (up to 150%, never down to a phone layout on a computer), so a Block laid out with the kit\'s spacing fills its Step without empty space.',
  'Settings sit side by side (`sm-settings`), next to what they change. Three or four short options are one segmented row (`data-segmented`), not a row of big tiles.',
  'Lists fill the width at a small size: input files are small tiles (`sm-gallery data-size="small"`), many items are one line each (`sm-list`): a thumbnail, one line of text, a short fact. Tapping an item opens all of its fields in place. Extra width means more items per row, never bigger cards.',
  'On a phone chip and segment rows scroll sideways instead of wrapping; long lists show their first three with "N more" (`data-peek`) and long text five lines until tapped (`sm-clamp`).',
@@ -135,6 +136,58 @@ function topLevelRows(html){
  return rows;
 }
 
+// November 1, 2026 (owner, zoom plan): a screen held to a narrow width leaves most of a wide Step empty, and StillMade's
+// zoom cannot fill it (it stops before the kit's two-column layout from 860px would change). The narrowest fixed or
+// maximum width on what holds the whole screen (html, body, the outermost element, a lone wrapper inside it), from its
+// inline style or a stylesheet rule outside a small-screen @media block; null when nothing holds it.
+const KIT_TWO_COLUMNS=860;
+function narrowScreen(view){
+ const html=String(view?.html||''),lower=html.toLowerCase(),holders=[{tag:'html',classes:[],id:''},{tag:'body',classes:[],id:''}];
+ const width=declarations=>{let narrowest=null;for(const match of String(declarations).matchAll(/(?:^|[;{\s])(?:max-width|width)\s*:\s*(\d{1,5}(?:\.\d+)?)(px|rem|em)\b/gi)){const px=Number(match[1])*(match[2].toLowerCase()==='px'?1:16);if(px>=200&&px<KIT_TWO_COLUMNS)narrowest=Math.min(narrowest??Infinity,px);}return narrowest;};
+ // The outermost elements, and the children of a lone outermost one; a lone child is a wrapper too.
+ // The last '>' found is reused while it is still ahead, and attributes are read from a bounded slice, so broken tags
+ // ("<a<a<a…>") stay linear.
+ const top=[],inner=[];let depth=0,end=-1;
+ for(let at=lower.indexOf('<');at!==-1;at=lower.indexOf('<',at+1)){
+  if(end<at)end=lower.indexOf('>',at);if(end===-1)break;
+  const tag=/^<(\/?)([a-z][a-z0-9-]*)/.exec(lower.slice(at,Math.min(end+1,at+40)));
+  if(!tag)continue;
+  const [,closing,name]=tag;
+  if(closing){depth=Math.max(0,depth-1);if(depth===0&&top.length>1)break;continue;}
+  if(['script','style','template'].includes(name)){const close=lower.indexOf(`</${name}`,end);if(close===-1)break;at=close;continue;}
+  const attributes=html.slice(at,Math.min(end,at+2000)),element={tag:name,classes:(/\sclass\s*=\s*["']([^"']*)["']/i.exec(attributes)?.[1]||'').split(/\s+/).filter(Boolean),id:/\sid\s*=\s*["']([^"']*)["']/i.exec(attributes)?.[1]||'',style:/\sstyle\s*=\s*["']([^"']*)["']/i.exec(attributes)?.[1]||''};
+  if(depth===0)top.push(element);else if(depth===1&&top.length===1)inner.push(element);
+  if(!VOID_TAGS.has(name)&&lower[end-1]!=='/')depth++;
+ }
+ holders.push(...top.filter(()=>top.length===1),...(inner.length===1?inner:[]));
+ for(const element of holders.slice(2)){const px=width(element.style);if(px)return {px,where:`the style on <${element.tag}>`};}
+ const holds=selector=>{
+  const last=selector.trim().split(/[\s>+~]+/).pop().replace(/^:root$/i,'html'),parts=/^([a-z][a-z0-9-]*|\*)?((?:[.#][\w-]+)*)$/i.exec(last);
+  if(!parts||!parts[1]&&!parts[2])return false;
+  const classes=[...parts[2].matchAll(/\.([\w-]+)/g)].map(match=>match[1]),id=/#([\w-]+)/.exec(parts[2])?.[1]||'';
+  return holders.some(element=>(!parts[1]||parts[1]==='*'||parts[1].toLowerCase()===element.tag)&&classes.every(name=>element.classes.includes(name))&&(!id||id===element.id));
+ };
+ // One pass over the stylesheet, comments skipped: each rule with the @media blocks around it.
+ const css=String(view?.css||''),around=[];let prelude='',narrowest=null;
+ for(let index=0;index<css.length;index++){
+  const char=css[index];
+  if(char==='/'&&css[index+1]==='*'){const close=css.indexOf('*/',index+2);if(close===-1)break;index=close+1;continue;}
+  if(char==='{'){
+   const head=prelude.trim();prelude='';
+   if(head.startsWith('@')){around.push(head);continue;}
+   const close=css.indexOf('}',index);if(close===-1)break;
+   const smallOnly=around.some(rule=>/^@media\b/i.test(rule)&&/max-width/i.test(rule));
+   const px=!smallOnly&&head.split(',').some(holds)?width(css.slice(index+1,close)):null;
+   if(px&&(!narrowest||px<narrowest.px))narrowest={px,where:head.slice(0,60)};
+   index=close;continue;
+  }
+  if(char==='}'){around.pop();prelude='';continue;}
+  if(char===';'&&!around.length){prelude='';continue;}
+  prelude+=char;
+ }
+ return narrowest;
+}
+
 export function reviewViewDesign(view){
   if(!view)return {passed:true,issues:[],warnings:[],principles:BLOCK_INTERFACE_PRINCIPLES};
   const html=view.html||'',javascript=view.javascript||'',primary=html.replace(/<details\b[\s\S]*?<\/details>/gi,'');
@@ -157,10 +210,24 @@ export function reviewViewDesign(view){
   if(rareTool)warnings.push(`"${rareTool.slice(0,40)}" is its own section. Rare tools (update, schedule, history, reload) are named icon buttons beside the action (.sm-icon in .sm-actions), never sections under the work.`);
   const rows=topLevelRows(primary);
   if(rows>COMPACT_ROW_LIMIT)warnings.push(`The workspace has ${rows} visible rows besides the stage and may not fit one laptop screen (an estimate: this check counts rows and cannot measure height). Put short settings side by side in .sm-settings and secondary ones in a closed .sm-more.`);
+  const narrow=narrowScreen(view);
+  if(narrow)warnings.push(`The screen is held to ${Math.round(narrow.px)}px wide (${narrow.where}), so a wide Step shows mostly empty space, and StillMade's zoom cannot fill it. Drop the fixed or maximum width: the Block kit lays out the controls and the result across the width.`);
   warnings.push(...blockKitProblems(view).map(problem=>problem.message));
   return {passed:issues.length===0,issues,warnings,principles:BLOCK_INTERFACE_PRINCIPLES};
 }
 
+// October 30, 2026: Chat presses a button on a Block's own screen only when it carries data-stillmade-action
+// (naming what it does); an unmarked button is out of Chat's reach. The number of buttons in view.html without one.
+export function unmarkedButtons(view){
+ const html=String(view?.html||''),lower=html.toLowerCase();let count=0;
+ for(let start=lower.indexOf('<button');start!==-1;start=lower.indexOf('<button',start+7)){
+  if(!/[\s>/]/.test(lower[start+7]||''))continue;
+  const end=lower.indexOf('>',start);if(end===-1)break;
+  if(!/\sdata-stillmade-action\s*=/.test(lower.slice(start,end)))count++;
+ }
+ return count;
+}
+
 // What a NEW Block's interface must get right. Each problem is {rule, message}.
 // The builder contract's DOD-15 (the SDK's `ready`, StillMade's builder) fails
 // on 'action', 'price' and 'heading'; StillMade's own builder also repairs

package/packages/block-sdk/view-renderer.js

@@ -6,6 +6,38 @@ export function installViewRenderer(document,onError=()=>{},onControlsChanged=()
  const listeners=new Set();
  const actions=new WeakMap(),compositionState=new WeakMap(),compositions=new Map(),conflicts=new Map();let disposed=false,revision=0,sequence=0,dispatching=false;const roots=new Set();
  const notify=()=>{try{onControlsChanged();}catch{}};
+ // October 30, 2026: Chat also reads and presses a view's plain HTML controls: a button marked
+ // data-stillmade-action, and a labelled input, select or textarea. Shared fields (data-stillmade-share, reached
+ // as shared fields), device-only controls (data-stillmade-local) and file, password and hidden inputs are never
+ // offered. Pressing one clicks it, and setting one sends its input and change events, as a person's use does;
+ // whatever that starts keeps its own approval (an assisted run still opens its cost review).
+ const later=globalThis.setTimeout?.bind(globalThis),cancel=globalThis.clearTimeout?.bind(globalThis),Observer=later&&cancel?document.defaultView?.MutationObserver:null;
+ const SKIPPED_TYPES=new Set(['file','password','hidden','submit','reset','image','button']);
+ const ownText=node=>{let value='';for(const child of node.childNodes)if(child.nodeType===3)value+=child.nodeValue;else if(child.nodeType===1&&!child.matches('input,select,textarea,button'))value+=' '+child.textContent;return value;};
+ const plainLabel=node=>{
+  let value=node.getAttribute('aria-label')||'';const by=node.getAttribute('aria-labelledby');
+  if(!value&&by)value=by.split(/\s+/).map(id=>document.getElementById(id)?.textContent||'').join(' ');
+  if(!value&&node.labels?.length)value=ownText(node.labels[0]);
+  if(!value.trim()&&node.tagName==='BUTTON')value=node.textContent||'';
+  return String(value.trim()?value:node.getAttribute('title')||'').replace(/\s+/g,' ').trim().slice(0,240);
+ };
+ const plainNode=node=>{
+  const meta=actions.get(node);if(meta&&!meta.plain)return false;
+  if(node.closest('[data-stillmade-share],[data-stillmade-local]'))return false;
+  if(node.tagName==='BUTTON')return node.hasAttribute('data-stillmade-action');
+  if(node.tagName==='INPUT'&&SKIPPED_TYPES.has(node.type))return false;
+  return node.hasAttribute('data-stillmade-action')||!!plainLabel(node);
+ };
+ const plainControls=()=>{
+  const out=[];
+  for(const node of document.querySelectorAll('button,input,select,textarea')){
+   if(out.length>=200)break;if(!plainNode(node))continue;
+   if(!actions.has(node))actions.set(node,{plain:true,event:node.tagName==='BUTTON'?'click':node.tagName==='SELECT'||['checkbox','radio'].includes(node.type)?'change':'input',root:document.documentElement,handle:'view-control-'+String(++sequence)});
+   out.push(node);
+  }
+  return out;
+ };
+ const actionOf=node=>{const meta=actions.get(node);return meta.plain?String(node.getAttribute('data-stillmade-action')||node.id||node.getAttribute('name')||plainLabel(node)).slice(0,120):meta.action;};
  const check=(ok,message)=>{if(!ok)throw Error(message);};
  const text=(value,max=10000)=>{check(typeof value==='string'&&value.length<=max,'Dynamic control text exceeds its limit');return value;};
  const textControl=node=>node.tagName==='TEXTAREA'||node.tagName==='INPUT'&&node.type==='text';
@@ -129,28 +161,38 @@ export function installViewRenderer(document,onError=()=>{},onControlsChanged=()
   if(conflict)throw Error(compositionState.get(conflict[0]).problem);
   check(![...compositions].some(([node,root])=>root.contains(node)&&node.isConnected&&!node.disabled),'Finish composing text before continuing.');
  };
- const currentControls=()=>{const seen=new Set(),out=[];for(const root of roots)if(root.isConnected)for(const node of root.querySelectorAll('button,input,textarea,select')){const meta=actions.get(node);if(meta?.action&&meta.root===root&&!seen.has(node)){seen.add(node);out.push(node);}}return out;};
+ const currentControls=()=>{const seen=new Set(),out=[];for(const root of roots)if(root.isConnected)for(const node of root.querySelectorAll('button,input,textarea,select')){const meta=actions.get(node);if(meta?.action&&meta.root===root&&!seen.has(node)){seen.add(node);out.push(node);}}for(const node of plainControls())if(!seen.has(node)){seen.add(node);out.push(node);}return out;};
  const hidden=node=>{for(let current=node;current;current=current.parentElement){if(current.hidden)return true;const style=document.defaultView?.getComputedStyle(current);if(style?.display==='none'||['hidden','collapse'].includes(style?.visibility)||style?.opacity==='0')return true;}return false;};
- const label=node=>String(node.getAttribute('aria-label')||node.textContent||node.placeholder||'Control').slice(0,240);
+ const label=node=>actions.get(node)?.plain?plainLabel(node)||actionOf(node)||'Control':String(node.getAttribute('aria-label')||node.textContent||node.placeholder||'Control').slice(0,240);
  const choices=node=>node.tagName==='SELECT'?Array.from(node.options).map(option=>({value:option.value,label:option.textContent})):null;
- const identity=node=>{const meta=actions.get(node);return JSON.stringify({action:meta.action,event:meta.event,root:meta.root.id,tag:node.tagName,type:node.type,value:node.value,checked:node.checked,disabled:node.disabled,hidden:hidden(node),label:label(node),choices:choices(node)});};
- const lockControls=locked=>{for(const node of currentControls())node.disabled=locked||actions.get(node).declaredDisabled;};
- const inspectControls=({offset=0,limit=20}={})=>{check(!disposed,'Dynamic controls are closed');check(Number.isSafeInteger(offset)&&offset>=0&&Number.isSafeInteger(limit)&&limit>=1&&limit<=20,'Choose a bounded control page');const nodes=currentControls();check(offset<=nodes.length,'Choose a current control page');return {revision,total:nodes.length,offset,nextOffset:offset+limit<nodes.length?offset+limit:null,controls:nodes.slice(offset,offset+limit).map(node=>{const meta=actions.get(node),value=String(node.value??'');return {id:meta.handle,action:meta.action,label:label(node),tag:node.tagName.toLowerCase(),type:node.type,event:meta.event,disabled:node.disabled,hidden:hidden(node),value:value.slice(0,240),valuePartial:value.length>240,...(typeof node.checked==='boolean'?{checked:node.checked}:{}),...(node.tagName==='select'?{choices:choices(node).slice(0,40),choicesPartial:node.options.length>40}:{}),identity:identity(node)};})};};
+ const identity=node=>{const meta=actions.get(node);return JSON.stringify({action:actionOf(node),event:meta.event,root:meta.root.id,tag:node.tagName,type:node.type,value:node.value,checked:node.checked,disabled:node.disabled,hidden:hidden(node),label:label(node),choices:choices(node)});};
+ const lockControls=locked=>{for(const node of currentControls())if(!actions.get(node).plain)node.disabled=locked||actions.get(node).declaredDisabled;};
+ // A plain control appearing, going or changing its state is a new control list; checked at most every 250 ms.
+ let plainSignature=null,plainTimer=null;
+ const plainState=()=>plainControls().map(node=>actions.get(node).handle+(node.disabled?':off':'')+(hidden(node)?':hidden':'')).join(',');
+ const plainChanged=()=>{plainTimer=null;if(disposed||plainSignature===null)return;let next;try{next=plainState();}catch{return;}if(next!==plainSignature){plainSignature=next;revision++;notify();}};
+ const observer=Observer?new Observer(()=>{if(plainTimer===null&&!disposed)plainTimer=later(plainChanged,250);}):null;
+ observer?.observe(document.documentElement,{subtree:true,childList:true,attributes:true,attributeFilter:['disabled','hidden','class','data-stillmade-action','aria-label']});
+ const inspectControls=({offset=0,limit=20}={})=>{check(!disposed,'Dynamic controls are closed');check(Number.isSafeInteger(offset)&&offset>=0&&Number.isSafeInteger(limit)&&limit>=1&&limit<=20,'Choose a bounded control page');const nodes=currentControls();plainSignature=plainState();check(offset<=nodes.length,'Choose a current control page');return {revision,total:nodes.length,offset,nextOffset:offset+limit<nodes.length?offset+limit:null,controls:nodes.slice(offset,offset+limit).map(node=>{const meta=actions.get(node),value=String(node.value??'');return {id:meta.handle,action:actionOf(node),label:label(node),tag:node.tagName.toLowerCase(),type:node.type,event:meta.event,disabled:node.disabled,hidden:hidden(node),value:value.slice(0,240),valuePartial:value.length>240,...(typeof node.checked==='boolean'?{checked:node.checked}:{}),...(node.tagName==='SELECT'?{choices:choices(node).slice(0,40),choicesPartial:node.options.length>40}:{}),identity:identity(node)};})};};
  const dispatchControl=async(args,settle=async()=>{})=>{
   check(!dispatching,'A declared control is already running');assertCommitted();
   check(args&&typeof args==='object'&&!Array.isArray(args)&&Object.keys(args).every(key=>['id','revision','identity','value','checked'].includes(key))&&typeof args.id==='string'&&args.revision===revision&&typeof args.identity==='string','The declared control changed');
   const node=currentControls().find(node=>actions.get(node).handle===args.id),meta=node&&actions.get(node);
-  check(node&&identity(node)===args.identity,'The declared control changed');check(!node.disabled&&!hidden(node),'This declared control is unavailable');check(listeners.size>0,'This declared control has no native handler');
+  check(node&&identity(node)===args.identity,'The declared control changed');check(!node.disabled&&!hidden(node),'This declared control is unavailable');check(meta.plain||listeners.size>0,'This declared control has no native handler');
   if(node.tagName==='BUTTON')check(!Object.hasOwn(args,'value')&&!Object.hasOwn(args,'checked'),'Buttons take no input value');
   else if(['checkbox','radio'].includes(node.type)){check(typeof args.checked==='boolean'&&!Object.hasOwn(args,'value'),'Choose a checkbox value');node.checked=args.checked;}
   else{check((typeof args.value==='string'&&args.value.length<=10000||typeof args.value==='number'&&Number.isFinite(args.value))&&!Object.hasOwn(args,'checked'),'Choose a bounded control value');if(node.tagName==='SELECT')check(Array.from(node.options).some(option=>option.value===String(args.value)),'Choose a declared option');node.value=String(args.value);}
   const payload={action:meta.action,value:node.value,checked:node.checked,event:meta.event};
   dispatching=true;lockControls(true);
+  if(meta.plain)try{if(node.tagName==='BUTTON')node.click();else for(const type of ['input','change'])node.dispatchEvent(new document.defaultView.Event(type,{bubbles:true}));check(!disposed,'Dynamic controls are closed');await settle();check(!disposed,'Dynamic controls are closed');return {settled:true};}
+  finally{dispatching=false;lockControls(false);notify();}
   try{const pending=[];for(const listener of listeners){try{pending.push(Promise.resolve(listener({...payload})));}catch(error){pending.push(Promise.reject(error));}}const results=await Promise.allSettled(pending);check(!disposed,'Dynamic controls are closed');await settle();check(!disposed,'Dynamic controls are closed');const failure=results.find(result=>result.status==='rejected');if(failure)throw failure.reason;return {settled:true};}
   finally{dispatching=false;lockControls(false);notify();}
  };
- return Object.freeze({render,inspectControls,dispatchControl,onAction(listener){check(typeof listener==='function'&&listeners.size<16,'Register at most 16 action listeners');listeners.add(listener);return()=>listeners.delete(listener);},assertCommitted,async flushAll(){
+ // Where a declared control sits in this document, for a host that points at it.
+ const locateControl=id=>{check(!disposed,'Dynamic controls are closed');const node=currentControls().find(node=>actions.get(node).handle===id);if(!node||hidden(node))return null;const rect=node.getBoundingClientRect();return {x:rect.left,y:rect.top,width:rect.width,height:rect.height};};
+ return Object.freeze({render,inspectControls,dispatchControl,locateControl,onAction(listener){check(typeof listener==='function'&&listeners.size<16,'Register at most 16 action listeners');listeners.add(listener);return()=>listeners.delete(listener);},assertCommitted,async flushAll(){
   assertCommitted();
   return {queued:true};
- },dispose(){disposed=true;roots.clear();for(const node of compositions.keys())compositionState.get(node).cancelled=true;compositions.clear();conflicts.clear();listeners.clear();}});
+ },dispose(){disposed=true;observer?.disconnect();if(plainTimer!==null)cancel?.(plainTimer);roots.clear();for(const node of compositions.keys())compositionState.get(node).cancelled=true;compositions.clear();conflicts.clear();listeners.clear();}});
 }

package/packages/design-system/block-kit.css

@@ -101,10 +101,12 @@
 }
 
 /* ---------- Choices as pictures: replaces word dropdowns and radio lists ---------- */
+/* Captions never go under 12 px, the readable size the platform's phone check asks of every Block (October 27, 2026: a
+   generated choice read 11.4 px under a 14 px root and failed every Block that has one). */
 :where(.sm-choices){display:grid;gap:var(--s-2,8px);grid-template-columns:repeat(auto-fill,minmax(var(--sm-tile,96px),1fr));margin:0;padding:0;border:0;min-width:0}
 :where(.sm-choices[data-size="wide"]){--sm-tile:160px}
 :where(.sm-choices) > :where(legend){padding:0;margin-bottom:6px;font-size:var(--fs-body-s,.875rem);color:var(--fg-muted)}
-:where(.sm-choices) > :where(label){position:relative;display:grid;justify-items:center;align-content:start;gap:6px;padding:var(--s-2,8px);border:1px solid var(--border-tok);border-radius:var(--r-3,8px);background:var(--bg-elev-1);color:var(--fg-muted);font-size:var(--fs-caption,.8125rem);text-align:center;cursor:pointer}
+:where(.sm-choices) > :where(label){position:relative;display:grid;justify-items:center;align-content:start;gap:6px;padding:var(--s-2,8px);border:1px solid var(--border-tok);border-radius:var(--r-3,8px);background:var(--bg-elev-1);color:var(--fg-muted);font-size:max(12px,var(--fs-caption,.8125rem));text-align:center;cursor:pointer}
 :where(.sm-choices) > :where(label):hover{border-color:var(--border-strong);color:var(--fg)}
 :where(.sm-choices) :where(input[type="radio"],input[type="checkbox"]){position:absolute;inset:0;width:100%;height:100%;margin:0;opacity:0;cursor:pointer}
 :where(.sm-choices) > :where(label:has(input:checked)){border-color:var(--fg);color:var(--fg);box-shadow:inset 0 0 0 1px var(--fg)}
@@ -135,7 +137,7 @@
 :where(.sm-settings){display:grid;gap:var(--s-3,12px) var(--s-4,16px);grid-template-columns:repeat(auto-fill,minmax(min(100%,11rem),1fr));align-items:start;min-width:0}
 :where(.sm-settings) > :where(.sm-field){grid-template-columns:minmax(0,1fr);gap:4px}
 :where(.sm-settings) > :where(.sm-field:not(:has(textarea,.sm-choices,.sm-gallery,.sm-list))){--sm-control:6rem;display:flex;flex-wrap:wrap;align-items:center;gap:4px var(--s-2,8px)}
-:where(.sm-settings) > :where(.sm-choices) > :where(legend),:where(.sm-settings) :where(.sm-label){font-size:var(--fs-caption,.8125rem)}
+:where(.sm-settings) > :where(.sm-choices) > :where(legend),:where(.sm-settings) :where(.sm-label){font-size:max(12px,var(--fs-caption,.8125rem))}
 /* On a phone, a row of chips or segments scrolls sideways instead of wrapping. */
 @container (max-width:519px){
  :where(.sm-choices[data-compact],.sm-choices[data-segmented]){display:flex;flex-wrap:nowrap;width:auto;overflow-x:auto;scrollbar-width:none}
@@ -157,7 +159,7 @@
 :where(.sm-list) > :where(li) > :where(details) > :where(:not(summary)){padding:var(--s-2,8px) var(--s-3,12px) var(--s-3,12px)}
 :where(.sm-list) :where(img,video,canvas,.sm-swatch){flex:none;width:40px;height:26px;object-fit:cover;border-radius:var(--r-2,4px);background:var(--bg-inset)}
 :where(.sm-list) :where(.sm-line){flex:1;min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-:where(.sm-list) :where(small){flex:none;color:var(--fg-subtle);font-size:var(--fs-caption,.8125rem);white-space:nowrap;font-variant-numeric:tabular-nums}
+:where(.sm-list) :where(small){flex:none;color:var(--fg-subtle);font-size:max(12px,var(--fs-caption,.8125rem));white-space:nowrap;font-variant-numeric:tabular-nums}
 :where(.sm-list) > :where(.sm-list-more){display:none}
 @container (max-width:519px){
  :where(.sm-list[data-peek]:not([data-open])) > :where(li:nth-child(n+4):not(.sm-list-more)){display:none}
@@ -168,7 +170,7 @@
 :where(.sm-gallery){display:grid;gap:var(--s-2,8px);grid-template-columns:repeat(auto-fill,minmax(min(100%,var(--sm-tile,140px)),1fr));margin:0;padding:0;list-style:none}
 :where(.sm-gallery) > :where(*){position:relative;margin:0;border-radius:var(--r-3,8px);overflow:hidden;background:var(--bg-inset)}
 :where(.sm-gallery) :where(img,video,canvas){display:block;width:100%;aspect-ratio:var(--sm-tile-ratio,1);object-fit:cover}
-:where(.sm-gallery) :where(figcaption){padding:6px 8px;font-size:var(--fs-caption,.8125rem);color:var(--fg-muted)}
+:where(.sm-gallery) :where(figcaption){padding:6px 8px;font-size:max(12px,var(--fs-caption,.8125rem));color:var(--fg-muted)}
 :where(.sm-gallery) :where([aria-selected="true"],.is-selected){box-shadow:inset 0 0 0 2px var(--fg)}
 /* Small tiles: more per row as the screen widens, never bigger tiles. */
 :where(.sm-gallery[data-size="small"]){--sm-tile:92px;--sm-tile-ratio:3/2}