stillmade-sdk 0.1.12 → 0.1.14

package/blocks/native/sm.pick-photos/versions/1.0.0/package.js

@@ -0,0 +1,334 @@
+// Generated by scripts/build-owned-blocks.mjs. Edit the owned source files.
+export default {
+  "manifest": {
+    "schemaVersion": 1,
+    "sdkVersion": "0.1.0",
+    "id": "sm.pick-photos",
+    "version": "1.0.0",
+    "name": "Pick best photos",
+    "description": "Check every photo with StillMade's vision capability and keep only the best ones: sharp, well lit, clear faces, varied, and true to your note.",
+    "kind": "task",
+    "runtime": "javascript",
+    "entry": "src/run.js",
+    "license": "MIT",
+    "provenance": {
+      "notice": "Original source (authorship declared by the packager)\nLicense: MIT\nChanges: Original implementation declared by the packager; no reused repository or dependency code.\nFiles: LICENSE, src/run.js\n\nMIT License\n\nCopyright (c) 2026 StillMade contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n",
+      "portableSources": [
+        {
+          "kind": "original",
+          "license": "MIT",
+          "paths": [
+            "LICENSE",
+            "src/run.js"
+          ],
+          "evidence": [
+            "upstream/0/LICENSE",
+            "upstream/0/src/run.js"
+          ],
+          "changes": "Original implementation declared by the packager; no reused repository or dependency code."
+        }
+      ]
+    },
+    "inputs": {
+      "photos": {
+        "type": "image[]",
+        "primary": true,
+        "required": true,
+        "imageMode": "reference",
+        "description": "The photos to choose from, up to 100.",
+        "semantic": "image",
+        "accepts": [
+          "source_image"
+        ]
+      },
+      "keep": {
+        "type": "integer",
+        "default": 12,
+        "min": 1,
+        "max": 50,
+        "required": false,
+        "description": "How many photos to keep.",
+        "semantic": "photo_keep_count"
+      },
+      "instruction": {
+        "type": "text",
+        "default": "",
+        "required": false,
+        "description": "What the photos are for, such as: a memorial tribute for Grandma; prefer clear faces and happy moments.",
+        "semantic": "photo_selection_instruction"
+      },
+      "notes": {
+        "type": "json",
+        "required": false,
+        "description": "One note per photo from the photo check. StillMade fills this in when the Step runs; leave it empty.",
+        "semantic": "photo_notes",
+        "schema": [
+          {
+            "ok": "boolean?",
+            "sharp": "number?",
+            "light": "number?",
+            "people": "integer?",
+            "facesClear": "boolean?",
+            "smiling": "boolean?",
+            "eyesClosed": "boolean?",
+            "tags": "string[]?",
+            "text": "string?"
+          }
+        ]
+      }
+    },
+    "outputs": {
+      "photos": {
+        "type": "image[]",
+        "primary": true,
+        "description": "Only the chosen photos, unchanged, in the order they were taken when dates are known, otherwise best first.",
+        "semantic": "image"
+      },
+      "reasons": {
+        "type": "text",
+        "description": "Why each photo was kept.",
+        "semantic": "plain_text"
+      }
+    },
+    "permissions": {
+      "project": [],
+      "network": [],
+      "filesystem": [],
+      "secrets": []
+    },
+    "ui": [
+      {
+        "port": "photos",
+        "control": "asset"
+      },
+      {
+        "port": "keep",
+        "control": "number",
+        "label": "How many to keep"
+      },
+      {
+        "port": "instruction",
+        "control": "text",
+        "label": "What they are for"
+      },
+      {
+        "port": "photos",
+        "control": "gallery"
+      }
+    ],
+    "platforms": {
+      "phone": {
+        "supported": true
+      },
+      "browser": {
+        "supported": true
+      },
+      "desktop": {
+        "supported": true
+      }
+    }
+  },
+  "code": "// Pick best photos: rank the photos from their notes (one per photo, made by\n// Photo notes when the Step runs) and return only the chosen ones, unchanged.\nconst MAX_PHOTOS=100;\nconst photos=Array.isArray(input.photos)?input.photos:[];\nif(!photos.length)throw new Error('Add photos to choose from.');\nif(photos.length>MAX_PHOTOS)throw new Error('Pick best photos checks up to 100 photos at a time. You added '+String(photos.length)+'. Remove some, or split them into groups of 100 or fewer.');\nconst notes=Array.isArray(input.notes)?input.notes:null;\nif(!notes||notes.length!==photos.length)throw new Error('Pick best photos needs its photo check. Run this Step in your project to check the photos.');\nconst keep=Math.max(1,Math.min(50,Math.round(Number(input.keep)||12)));\nconst instruction=typeof input.instruction==='string'?input.instruction.toLowerCase():'';\n\nconst STOP=new Set(['the','and','for','with','that','this','from','into','our','her','his','their','them','who','are','was','were','has','have','had','want','like','prefer','some','more','most','very','only','photos','photo','pictures','picture','images','image','video','please','make','show','use','good','best','nice','tribute','about']);\nconst words=text=>String(text||'').toLowerCase().split(/[^a-z0-9]+/).filter(word=>word.length>=3&&!STOP.has(word));\nconst stem=word=>word.slice(0,5);\nconst wanted=[...new Set(words(instruction).map(stem))];\nconst wantsFaces=/face|people|person|portrait|family|everyone|group/.test(instruction);\nconst wantsHappy=/happy|smil|joy|laugh|fun|cheer/.test(instruction);\nconst wantsSharp=/clear|sharp|focus|quality/.test(instruction);\nconst level=value=>{const number=Number(value);return Number.isFinite(number)?Math.max(0,Math.min(10,number)):5;};\n\nconst notesFor=(note)=>{\n const ok=!!note&&typeof note==='object'&&note.ok!==false;\n const tags=Array.isArray(note&&note.tags)?note.tags.map(tag=>String(tag).toLowerCase()).slice(0,12):[];\n const text=String(note&&note.text||'');\n return {ok,sharp:level(note&&note.sharp),light:level(note&&note.light),people:Math.max(0,Math.min(50,Math.round(Number(note&&note.people)||0))),facesClear:note&&note.facesClear===true,smiling:note&&note.smiling===true,eyesClosed:note&&note.eyesClosed===true,tags,text,signature:new Set([...tags.flatMap(words),...words(text)].map(stem))};\n};\nconst fitOf=note=>{\n if(!wanted.length)return 0;\n let hits=0;for(const word of wanted)if(note.signature.has(word))hits++;\n return hits/wanted.length;\n};\nconst scoreOf=note=>{\n if(!note.ok)return -100;\n const quality=(note.sharp*.6+note.light*.4)/10;\n let score=3*quality+(note.people>0?1:0)+(note.facesClear?1.5:0)+(note.smiling?1:0)-(note.eyesClosed?1.5:0)+3*fitOf(note);\n if(wantsFaces)score+=(note.facesClear?1.5:0)+(note.people>0?1:0);\n if(wantsHappy)score+=note.smiling?2:0;\n if(wantsSharp)score+=2*quality;\n if(note.sharp<=2)score-=2;\n return Math.round(score*1000)/1000;\n};\nconst similarity=(a,b)=>{\n if(!a.signature.size||!b.signature.size)return 0;\n let shared=0;for(const word of a.signature)if(b.signature.has(word))shared++;\n return shared/(a.signature.size+b.signature.size-shared);\n};\nconst dateOf=photo=>{\n for(const key of ['takenAt','capturedAt','createdAt','date']){\n  const value=photo&&photo[key];\n  const time=typeof value==='number'?value:typeof value==='string'?Date.parse(value):NaN;\n  if(Number.isFinite(time))return time;\n }\n return null;\n};\n\n// Exact repeats of one saved version count once.\nconst seen=new Set();\nconst rows=[];\nphotos.forEach((photo,index)=>{\n const key=photo&&photo.assetId&&photo.versionId?photo.assetId+':'+photo.versionId:String(photo&&photo.url||index);\n if(seen.has(key))return;\n seen.add(key);\n const note=notesFor(notes[index]);\n rows.push({photo,index,note,score:scoreOf(note),fit:fitOf(note)});\n});\nconst ranked=rows.filter(row=>row.note.ok).sort((a,b)=>b.score-a.score||a.index-b.index);\nif(!ranked.length)throw new Error('None of these photos could be checked. Try clearer photos, or run the Step again.');\n\n// Near-duplicates (the same scene and people) give way to the best of them,\n// unless there are not enough different photos to fill the count.\nconst NEAR=.7;\nconst chosen=[],skipped=[];\nfor(const row of ranked){\n if(chosen.length>=keep)break;\n const twin=chosen.find(other=>Math.abs(other.note.people-row.note.people)<=1&&similarity(other.note,row.note)>=NEAR);\n if(twin){row.twin=twin;skipped.push(row);}else chosen.push(row);\n}\nfor(const row of skipped){if(chosen.length>=keep)break;chosen.push(row);}\n\nconst dated=chosen.every(row=>dateOf(row.photo)!==null);\nconst ordered=dated?chosen.slice().sort((a,b)=>dateOf(a.photo)-dateOf(b.photo)||a.index-b.index):chosen;\nconst nameOf=row=>row.photo&&typeof row.photo.name==='string'&&row.photo.name.trim()?row.photo.name.trim():'Photo '+String(row.index+1);\nconst why=row=>{\n const parts=[];\n const quality=(row.note.sharp*.6+row.note.light*.4);\n parts.push(quality>=7.5?'sharp and well lit':quality>=5?'clear enough':'the best of a weak set');\n if(row.note.people)parts.push(String(row.note.people)+(row.note.people===1?' person':' people'));\n if(row.note.facesClear)parts.push('clear faces');\n if(row.note.smiling)parts.push('smiling');\n if(row.fit>0)parts.push('fits your note');\n if(row.twin)parts.push('similar to another pick, kept to fill the count');\n return parts.join(', ');\n};\nconst lines=ordered.map((row,at)=>String(at+1)+'. '+nameOf(row)+': '+why(row)+'.');\nconst left=rows.length-chosen.length;\nconst header='Kept '+String(chosen.length)+' of '+String(photos.length)+' photos'+(dated?', in the order they were taken':', best first')+'.'+(left>0?' '+String(left)+' left out'+(skipped.length>chosen.filter(row=>row.twin).length?', some as near-duplicates':'')+'.':'');\nreturn {photos:ordered.map(row=>row.photo),reasons:[header,...lines].join('\\n')};\n",
+  "tests": [
+    {
+      "name": "keeps the sharpest varied photos and drops a near-duplicate",
+      "input": {
+        "photos": [
+          {
+            "kind": "image",
+            "assetId": "photo-1",
+            "versionId": "v1",
+            "url": "/api/media/photo-1"
+          },
+          {
+            "kind": "image",
+            "assetId": "photo-2",
+            "versionId": "v1",
+            "url": "/api/media/photo-2"
+          },
+          {
+            "kind": "image",
+            "assetId": "photo-3",
+            "versionId": "v1",
+            "url": "/api/media/photo-3"
+          },
+          {
+            "kind": "image",
+            "assetId": "photo-4",
+            "versionId": "v1",
+            "url": "/api/media/photo-4"
+          }
+        ],
+        "keep": 2,
+        "instruction": "Memorial tribute for Grandma; prefer clear faces",
+        "notes": [
+          {
+            "sharp": 9,
+            "light": 8,
+            "people": 2,
+            "facesClear": true,
+            "smiling": true,
+            "eyesClosed": false,
+            "tags": [
+              "grandma",
+              "garden",
+              "family"
+            ],
+            "text": "Two people smiling in a garden."
+          },
+          {
+            "sharp": 2,
+            "light": 3,
+            "people": 0,
+            "facesClear": false,
+            "smiling": false,
+            "eyesClosed": false,
+            "tags": [
+              "blur"
+            ],
+            "text": "A blurred hallway."
+          },
+          {
+            "sharp": 9,
+            "light": 8,
+            "people": 2,
+            "facesClear": true,
+            "smiling": true,
+            "eyesClosed": false,
+            "tags": [
+              "grandma",
+              "garden",
+              "family"
+            ],
+            "text": "Two people smiling in a garden."
+          },
+          {
+            "sharp": 8,
+            "light": 8,
+            "people": 1,
+            "facesClear": true,
+            "smiling": false,
+            "eyesClosed": false,
+            "tags": [
+              "kitchen",
+              "baking",
+              "grandma"
+            ],
+            "text": "A woman baking in a kitchen."
+          }
+        ]
+      },
+      "expected": {
+        "photos": [
+          {
+            "kind": "image",
+            "assetId": "photo-1",
+            "versionId": "v1",
+            "url": "/api/media/photo-1"
+          },
+          {
+            "kind": "image",
+            "assetId": "photo-4",
+            "versionId": "v1",
+            "url": "/api/media/photo-4"
+          }
+        ],
+        "reasons": "Kept 2 of 4 photos, best first. 2 left out, some as near-duplicates.\n1. Photo 1: sharp and well lit, 2 people, clear faces, smiling, fits your note.\n2. Photo 4: sharp and well lit, 1 person, clear faces, fits your note."
+      }
+    },
+    {
+      "name": "orders dated picks by when they were taken",
+      "input": {
+        "photos": [
+          {
+            "kind": "image",
+            "assetId": "photo-1",
+            "versionId": "v1",
+            "url": "/api/media/photo-1",
+            "takenAt": "2020-05-01T10:00:00Z"
+          },
+          {
+            "kind": "image",
+            "assetId": "photo-2",
+            "versionId": "v1",
+            "url": "/api/media/photo-2",
+            "takenAt": "2019-01-01T10:00:00Z"
+          }
+        ],
+        "keep": 2,
+        "notes": [
+          {
+            "sharp": 9,
+            "light": 9,
+            "people": 1,
+            "facesClear": true,
+            "smiling": true,
+            "eyesClosed": false,
+            "tags": [
+              "park"
+            ],
+            "text": "A child in a park."
+          },
+          {
+            "sharp": 6,
+            "light": 6,
+            "people": 0,
+            "facesClear": false,
+            "smiling": false,
+            "eyesClosed": false,
+            "tags": [
+              "lake"
+            ],
+            "text": "A quiet lake."
+          }
+        ]
+      },
+      "expected": {
+        "photos": [
+          {
+            "kind": "image",
+            "assetId": "photo-2",
+            "versionId": "v1",
+            "url": "/api/media/photo-2",
+            "takenAt": "2019-01-01T10:00:00Z"
+          },
+          {
+            "kind": "image",
+            "assetId": "photo-1",
+            "versionId": "v1",
+            "url": "/api/media/photo-1",
+            "takenAt": "2020-05-01T10:00:00Z"
+          }
+        ],
+        "reasons": "Kept 2 of 2 photos, in the order they were taken.\n1. Photo 2: clear enough.\n2. Photo 1: sharp and well lit, 1 person, clear faces, smiling."
+      }
+    }
+  ],
+  "portable": {
+    "format": "stillmade-block/1",
+    "dependencies": [],
+    "sources": [
+      {
+        "kind": "original",
+        "license": "MIT",
+        "paths": [
+          "LICENSE",
+          "src/run.js"
+        ],
+        "evidence": [
+          "upstream/0/LICENSE",
+          "upstream/0/src/run.js"
+        ],
+        "changes": "Original implementation declared by the packager; no reused repository or dependency code."
+      }
+    ],
+    "files": {
+      "upstream/0/LICENSE": "MIT License\n\nCopyright (c) 2026 StillMade contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n",
+      "upstream/0/src/run.js": "// Pick best photos: rank the photos from their notes (one per photo, made by\n// Photo notes when the Step runs) and return only the chosen ones, unchanged.\nconst MAX_PHOTOS=100;\nconst photos=Array.isArray(input.photos)?input.photos:[];\nif(!photos.length)throw new Error('Add photos to choose from.');\nif(photos.length>MAX_PHOTOS)throw new Error('Pick best photos checks up to 100 photos at a time. You added '+String(photos.length)+'. Remove some, or split them into groups of 100 or fewer.');\nconst notes=Array.isArray(input.notes)?input.notes:null;\nif(!notes||notes.length!==photos.length)throw new Error('Pick best photos needs its photo check. Run this Step in your project to check the photos.');\nconst keep=Math.max(1,Math.min(50,Math.round(Number(input.keep)||12)));\nconst instruction=typeof input.instruction==='string'?input.instruction.toLowerCase():'';\n\nconst STOP=new Set(['the','and','for','with','that','this','from','into','our','her','his','their','them','who','are','was','were','has','have','had','want','like','prefer','some','more','most','very','only','photos','photo','pictures','picture','images','image','video','please','make','show','use','good','best','nice','tribute','about']);\nconst words=text=>String(text||'').toLowerCase().split(/[^a-z0-9]+/).filter(word=>word.length>=3&&!STOP.has(word));\nconst stem=word=>word.slice(0,5);\nconst wanted=[...new Set(words(instruction).map(stem))];\nconst wantsFaces=/face|people|person|portrait|family|everyone|group/.test(instruction);\nconst wantsHappy=/happy|smil|joy|laugh|fun|cheer/.test(instruction);\nconst wantsSharp=/clear|sharp|focus|quality/.test(instruction);\nconst level=value=>{const number=Number(value);return Number.isFinite(number)?Math.max(0,Math.min(10,number)):5;};\n\nconst notesFor=(note)=>{\n const ok=!!note&&typeof note==='object'&&note.ok!==false;\n const tags=Array.isArray(note&&note.tags)?note.tags.map(tag=>String(tag).toLowerCase()).slice(0,12):[];\n const text=String(note&&note.text||'');\n return {ok,sharp:level(note&&note.sharp),light:level(note&&note.light),people:Math.max(0,Math.min(50,Math.round(Number(note&&note.people)||0))),facesClear:note&&note.facesClear===true,smiling:note&&note.smiling===true,eyesClosed:note&&note.eyesClosed===true,tags,text,signature:new Set([...tags.flatMap(words),...words(text)].map(stem))};\n};\nconst fitOf=note=>{\n if(!wanted.length)return 0;\n let hits=0;for(const word of wanted)if(note.signature.has(word))hits++;\n return hits/wanted.length;\n};\nconst scoreOf=note=>{\n if(!note.ok)return -100;\n const quality=(note.sharp*.6+note.light*.4)/10;\n let score=3*quality+(note.people>0?1:0)+(note.facesClear?1.5:0)+(note.smiling?1:0)-(note.eyesClosed?1.5:0)+3*fitOf(note);\n if(wantsFaces)score+=(note.facesClear?1.5:0)+(note.people>0?1:0);\n if(wantsHappy)score+=note.smiling?2:0;\n if(wantsSharp)score+=2*quality;\n if(note.sharp<=2)score-=2;\n return Math.round(score*1000)/1000;\n};\nconst similarity=(a,b)=>{\n if(!a.signature.size||!b.signature.size)return 0;\n let shared=0;for(const word of a.signature)if(b.signature.has(word))shared++;\n return shared/(a.signature.size+b.signature.size-shared);\n};\nconst dateOf=photo=>{\n for(const key of ['takenAt','capturedAt','createdAt','date']){\n  const value=photo&&photo[key];\n  const time=typeof value==='number'?value:typeof value==='string'?Date.parse(value):NaN;\n  if(Number.isFinite(time))return time;\n }\n return null;\n};\n\n// Exact repeats of one saved version count once.\nconst seen=new Set();\nconst rows=[];\nphotos.forEach((photo,index)=>{\n const key=photo&&photo.assetId&&photo.versionId?photo.assetId+':'+photo.versionId:String(photo&&photo.url||index);\n if(seen.has(key))return;\n seen.add(key);\n const note=notesFor(notes[index]);\n rows.push({photo,index,note,score:scoreOf(note),fit:fitOf(note)});\n});\nconst ranked=rows.filter(row=>row.note.ok).sort((a,b)=>b.score-a.score||a.index-b.index);\nif(!ranked.length)throw new Error('None of these photos could be checked. Try clearer photos, or run the Step again.');\n\n// Near-duplicates (the same scene and people) give way to the best of them,\n// unless there are not enough different photos to fill the count.\nconst NEAR=.7;\nconst chosen=[],skipped=[];\nfor(const row of ranked){\n if(chosen.length>=keep)break;\n const twin=chosen.find(other=>Math.abs(other.note.people-row.note.people)<=1&&similarity(other.note,row.note)>=NEAR);\n if(twin){row.twin=twin;skipped.push(row);}else chosen.push(row);\n}\nfor(const row of skipped){if(chosen.length>=keep)break;chosen.push(row);}\n\nconst dated=chosen.every(row=>dateOf(row.photo)!==null);\nconst ordered=dated?chosen.slice().sort((a,b)=>dateOf(a.photo)-dateOf(b.photo)||a.index-b.index):chosen;\nconst nameOf=row=>row.photo&&typeof row.photo.name==='string'&&row.photo.name.trim()?row.photo.name.trim():'Photo '+String(row.index+1);\nconst why=row=>{\n const parts=[];\n const quality=(row.note.sharp*.6+row.note.light*.4);\n parts.push(quality>=7.5?'sharp and well lit':quality>=5?'clear enough':'the best of a weak set');\n if(row.note.people)parts.push(String(row.note.people)+(row.note.people===1?' person':' people'));\n if(row.note.facesClear)parts.push('clear faces');\n if(row.note.smiling)parts.push('smiling');\n if(row.fit>0)parts.push('fits your note');\n if(row.twin)parts.push('similar to another pick, kept to fill the count');\n return parts.join(', ');\n};\nconst lines=ordered.map((row,at)=>String(at+1)+'. '+nameOf(row)+': '+why(row)+'.');\nconst left=rows.length-chosen.length;\nconst header='Kept '+String(chosen.length)+' of '+String(photos.length)+' photos'+(dated?', in the order they were taken':', best first')+'.'+(left>0?' '+String(left)+' left out'+(skipped.length>chosen.filter(row=>row.twin).length?', some as near-duplicates':'')+'.':'');\nreturn {photos:ordered.map(row=>row.photo),reasons:[header,...lines].join('\\n')};\n"
+    },
+    "lineage": {
+      "parents": [],
+      "changes": "Packaged original Block source for StillMade."
+    }
+  }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stillmade-sdk",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "StillMade Block SDK, CLI and examples",
   "license": "PolyForm-Shield-1.0.0",
   "type": "module",

package/packages/block-cli/dev-host/assets/host.js

@@ -1401,6 +1401,8 @@ label:has(> textarea) {
    The shape of a Block page, top to bottom:
      .sm-block      one workspace, no cards inside cards
        .sm-stage    the thing being made (preview, media, result); biggest area
+       .sm-settings settings side by side; .sm-choices[data-segmented] for short ones
+       .sm-list     many items, one line each; an item opens in place
        .sm-choices  picks shown as pictures or icons, not word lists
        .sm-shape    a frame shape at its real ratio (style="--r:9/16")
        .sm-field    the few inputs a person actually needs
@@ -1424,7 +1426,21 @@ label:has(> textarea) {
  :where(.sm-block[data-layout="split"]){grid-template-columns:minmax(0,1.6fr) minmax(260px,1fr);align-items:start}
  :where(.sm-block[data-layout="split"]) > :where(.sm-stage){grid-row:span 6}
 }
+/* Wide views (October 19, 2026): the controls keep a reading width on the left and
+   the result fills the rest on the right. Under 860px everything stacks with the
+   result first. data-layout="stack" opts out; "split" keeps its older layout. */
+@container (min-width:860px){
+ :where(.sm-block:not([data-layout]):has(> .sm-stage)){grid-template-columns:minmax(300px,380px) minmax(0,1fr);align-items:start;column-gap:var(--s-5,24px);row-gap:var(--s-4,16px)}
+ :where(.sm-block:not([data-layout]):has(> .sm-stage)) > :where(*){grid-column:1}
+ :where(.sm-block:not([data-layout]):has(> .sm-stage)) > :where(.sm-stage){grid-column:2;grid-row:1 / span 12;align-self:stretch;min-height:min(70vh,640px)}
+ /* A stage with a real shape keeps it: a min-height would widen a 16:9 stage past its column. */
+ :where(.sm-block:not([data-layout]):has(> .sm-stage)) > :where(.sm-stage[data-ratio]){align-self:start;min-height:0}
+}
 :where(.sm-row){display:flex;flex-wrap:wrap;align-items:center;gap:var(--s-2,8px)}
+/* Long text shows five lines on a phone until someone opens it (data-open). */
+@container (max-width:519px){
+ :where(.sm-clamp:not([data-open])){display:-webkit-box;-webkit-line-clamp:var(--sm-lines,5);-webkit-box-orient:vertical;overflow:hidden}
+}
 
 /* ---------- The stage: the object being made gets the main surface ---------- */
 :where(.sm-stage){position:relative;display:grid;place-items:center;min-height:220px;padding:var(--s-3,12px);border-radius:var(--r-3,8px);background:var(--bg-inset);overflow:hidden}
@@ -1465,8 +1481,8 @@ label:has(> textarea) {
 :where(.sm-fields){display:grid;gap:var(--s-4,16px);grid-template-columns:repeat(auto-fit,minmax(min(100%,200px),1fr))}
 /* Compact: on a view wider than a phone a short field is one row, its label beside the control. */
 @container (min-width:520px){
- /* Picture choices keep the full width: their legend is their label, and the tiles need the row. */
- :where(.sm-field:not(:has(textarea,.sm-choices))){grid-template-columns:minmax(5rem,9rem) minmax(0,1fr);align-items:center;gap:var(--s-2,8px)}
+ /* Picture choices, file tiles and lists keep the full width: their label sits above, and they need the row. */
+ :where(.sm-field:not(:has(textarea,.sm-choices,.sm-gallery,.sm-list))){grid-template-columns:minmax(5rem,9rem) minmax(0,1fr);align-items:center;gap:var(--s-2,8px)}
  :where(.sm-field) :where(input:not([type="checkbox"]):not([type="radio"]):not([type="range"]),select){min-height:36px;padding:6px 10px}
  :where(.sm-fields){gap:var(--s-2,8px) var(--s-4,16px)}
 }
@@ -1493,12 +1509,54 @@ label:has(> textarea) {
 :where(.sm-choices) :where(.sm-shape){--sm-shape-size:36px;align-self:center;margin:6px auto 2px}
 :where(.sm-choices[data-compact]) :where(.sm-shape){--sm-shape-size:20px;margin:0}
 
+/* Segmented: three or four short words or numbers in one connected row (Low / Med / High). */
+:where(.sm-choices[data-segmented]){display:flex;gap:0;width:fit-content;max-width:100%}
+:where(.sm-choices[data-segmented]) > :where(label){display:inline-flex;align-items:center;justify-content:center;gap:6px;min-height:36px;padding:4px 12px;border-radius:0;font-size:var(--fs-body-s,.875rem);white-space:nowrap}
+:where(.sm-choices[data-segmented]) > :where(label + label){margin-inline-start:-1px}
+:where(.sm-choices[data-segmented]) > :where(label:first-of-type){border-start-start-radius:var(--r-pill,999px);border-end-start-radius:var(--r-pill,999px)}
+:where(.sm-choices[data-segmented]) > :where(label:last-of-type){border-start-end-radius:var(--r-pill,999px);border-end-end-radius:var(--r-pill,999px)}
+:where(.sm-choices[data-segmented]) > :where(label:has(input:checked)){position:relative;z-index:1;background:var(--bg-elev-2)}
+:where(.sm-choices[data-segmented]) :where(.sm-glyph){--sm-glyph-size:16px;margin:0}
+/* Settings side by side: a grid of short settings, each label above its control. */
+: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-choices) > :where(legend),:where(.sm-settings) :where(.sm-label){font-size: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}
+ :where(.sm-choices[data-compact]) > :where(label){flex:none}
+ :where(.sm-choices[data-segmented]) > :where(label){flex:none}
+}
+
+/* ---------- One-line list: many items, one short row each ----------
+   <ol class="sm-list"><li><img alt=""><span class="sm-line">Text</span><small>Wide</small></li></ol>
+   An item that opens in place is <li><details><summary>…the row…</summary>…its fields…</details></li>.
+   data-peek shows the first three on a phone, with a last <li class="sm-list-more"> button to open the rest. */
+:where(.sm-list){display:grid;margin:0;padding:0;list-style:none;border:1px solid var(--border-tok);border-radius:var(--r-3,8px);background:var(--bg-elev-1);min-width:0;overflow:hidden}
+:where(.sm-list) > :where(li){display:flex;align-items:center;gap:var(--s-2,8px);min-width:0;min-height:40px;padding:4px var(--s-2,8px);border-bottom:1px solid var(--divider)}
+:where(.sm-list) > :where(li:last-child){border-bottom:0}
+:where(.sm-list) > :where(li:has(> details)){display:block;padding:0}
+:where(.sm-list) > :where(li) > :where(details) > :where(summary){display:flex;align-items:center;gap:var(--s-2,8px);min-height:40px;padding:4px var(--s-2,8px);list-style:none;cursor:pointer}
+:where(.sm-list) > :where(li) > :where(details) > :where(summary)::-webkit-details-marker{display:none}
+:where(.sm-list) > :where(li) > :where(details[open]){background:var(--bg-inset)}
+: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(.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}
+ :where(.sm-list[data-peek]:not([data-open])) > :where(.sm-list-more){display:flex;color:var(--fg-muted)}
+}
+
 /* ---------- Media gallery ---------- */
 :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([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}
 
 /* ---------- Status: a glyph and a few words, next to the action ---------- */
 :where(.sm-status){display:inline-flex;align-items:center;gap:var(--s-2,8px);min-height:24px;font-size:var(--fs-body-s,.875rem);color:var(--fg-muted)}