stillmade-sdk 0.1.40 → 0.1.42

package/.stillmade/sdk-baseline.json

@@ -5,12 +5,12 @@
   "examples/camera-recorder.stillmade.json": "8d8224b319e94e4afec3551445404ae99eae8c4d6df176ca7538bb0472f426b6",
   "examples/caption-from-text.stillmade.json": "3731a15b59043fbebee98416f2474800ef0154aa7873fb494934874ddcd2c705",
   "examples/captions.stillmade-block": "b0fde32dddaf866f3e540018309aaa00ae56b0e74a53a498fbaf1553ce200bd6",
-  "examples/check-clip.stillmade.json": "cf83af5a3317cd714282939f6cd40cd0c459fb5af97e97e5148f1ca81b4b1b87",
-  "examples/clean-text.stillmade.json": "1d0ab95c652b201540fec45918651cdcffa7a70ea7909a17f8c1ad80345797e2",
+  "examples/check-clip.stillmade.json": "f5abf67d5d5e46896af1b323abbc9e83e3936c4d35f900f763115ca9e07966b2",
+  "examples/clean-text.stillmade.json": "973a688879d51f7cf6c86c3a0698b68489e20946a7d28d234944f22548d24ed3",
   "examples/comfy-invert.stillmade.json": "126bd3a8a88e14c08ae11c62a441ed099d83e16830e2062f936e14e56cb297eb",
   "examples/comfy-text-to-image.stillmade.json": "957a616887115984c1888cf9c0eee2fe771dcbf041166ad112fb6c3feb7ad4dd",
-  "examples/custom-interface.stillmade.json": "6177c63be4d47739461d9657defef6cc701fc90556905de79d65d187840a01d7",
-  "examples/describe-image.stillmade.json": "1cf5985eaf7c27150815887c2f4550b3c5c716e9f2badda22ace606c082ac7cd",
+  "examples/custom-interface.stillmade.json": "dc8554ecfb2723c41d62c0ff9fecb9997884b2a03ff5bb740325d6bb612aaac0",
+  "examples/describe-image.stillmade.json": "de5634639c7e0364d5ae9e6ac7a2bd4004eb3289c1767b3e7527166f2015f7e9",
   "examples/docs-only-campfire-narrator.stillmade.json": "87c6a3b643b1ee007487e162aeced6f6302648f4c4a58b015e7df2ab9f2959be",
   "examples/docs-only-custom-ui.stillmade.json": "4602fd6b9576d364e16b79d2f08b196a251a8e98cf3149576686a96680a5dfe6",
   "examples/docs-only-gentle-trailer.stillmade.json": "ec081cc8aad654728dcd51257cb69603ec87fcc973ed2b1c5ea3d60a84c4c436",
@@ -20,9 +20,9 @@
   "examples/docs-only-retained-versions.stillmade.json": "78b84f0e843887c2078ac3271d9c69ea779c31f94aee8d49f7465b8bbafef640",
   "examples/docs-only-storybook-cover.stillmade.json": "7c94639d9bec5a673fe33f3c8c9b98e1119bea58a2fc8d0a7a98dabf73cc9a35",
   "examples/export-timeline.stillmade-block": "7d3221dc3ec1491f420773edb0ad8612c650755111e1e8561510b68508976199",
-  "examples/foley-cue.stillmade.json": "5d274b5b646af166e0fc79e3b60004b4cce6ee82b58428dab542537794850df1",
-  "examples/generate-image.stillmade.json": "85c0b68f03535d30c1aacb857197135fc4384c0de50cc777ae02333b34e0d8e2",
-  "examples/generate-video.stillmade.json": "26c3d392ec8ee14ce805078eee4868cdcf53a6c885daa4135bd52fd9bf8caa4b",
+  "examples/foley-cue.stillmade.json": "b579a73066cf65f6da2fba48c1965af83bc4325890643470229fd1c842470fc7",
+  "examples/generate-image.stillmade.json": "81feffcda94f6e9f3c5c503d83e0ca6ffa5cefa118e44f4a3751d2a925ca9680",
+  "examples/generate-video.stillmade.json": "01f1404219d0f500ebe06b9ddd1af280cb726aecb0c6aa11f6d94e9fc21f8267",
   "examples/grayscale.stillmade.json": "8c901790c25d2544f284a6a43341f72aa6b7e9211bef272b2e1d53c92b9e5faf",
   "examples/import-media.stillmade-block": "e9642e203080f1a145bec81871525a670f98dd1c8763862f81ab876fb15a656b",
   "examples/javascript-cloze-quiz": "b36a370c8b53250b9bb04783591661268ec674052bc13bf8cc8910fa27151f83",
@@ -37,29 +37,29 @@
   "examples/module-pdf-shot-list": "b372674aae8ef3392cc679cbfca25a76afcbf2271d5577e4055d2097d8a9ff24",
   "examples/module-silence-trimmer": "baeb12ae028122d1bd05312c6b0680c33f95c7ea8c176675678a1c4ff005fa86",
   "examples/module-tempo": "d2b842114e12b50de57f46ff004d6213022120c8dd7908fb7cb3648cd0e1d29a",
-  "examples/module-word-stats": "d89eacc4395bb7eae69f25509454659798946178fdccc5748e383392c370927f",
-  "examples/narrate-script.stillmade.json": "ce88242a4ac699443a8e002856182da2e70dd71e52ba62a9142f0a8fa0c848da",
-  "examples/numbered-takes.stillmade.json": "e4eef4f065f0458ab43413b1a584f887203f5208e83556a7f99c5927383f5d99",
+  "examples/module-word-stats": "4ccd49dba4861a7c3a0076e8fc443142ba606dba62d9bc98a86dd60addbdb3f6",
+  "examples/narrate-script.stillmade.json": "0c1185ea1d2b4052ba65310d181118786fb8307de94c6d04f7efc594121ae79a",
+  "examples/numbered-takes.stillmade.json": "7252550ffd7dc442559785170037a079090dbaa0a94066c72cf3e844c4581a1b",
   "examples/original-photo-editor": "12e88abd9cdeea6eba983699aa81fe8f29aca06bd8cb6d61dece9fb951dd702f",
   "examples/original-photo-editor.stillmade-block": "7f063e4bd128c1730fa5dd28c4acda08c2dc3196719feb6eafee4e4c89ea0daf",
   "examples/portable-regexp.stillmade-block": "04975bba1c0d719044ee41d6e0c58d73671c347f6b4ac16ba665bf5410116535",
   "examples/portable-regexp.stillmade.json": "fd769d584a6437e2a37c7e4101a031c0fef740afc76ef91f2337e2956fb08a1a",
   "examples/quieter-clips.stillmade.json": "23b026b267e5da522cc6a3a6af51e166a64fcc1d5391e855704fe1e1f243401b",
-  "examples/research-topic.stillmade.json": "8cfed5313c073db959c2d468ce470bd47ec5e8de4b4ec2def13591b9bf2f723e",
+  "examples/research-topic.stillmade.json": "50e8efb4ac81b165b17610e0fb7b2621b85ff9a14ebf2e045f30413246501b69",
   "examples/saas-product-launch-reviewed-source.stillmade.json": "2ec264a160faba338f3924965f935ce92c3fdad1fb69719921d7561353b010ab",
   "examples/saas-product-launch.stillmade.json": "aabec7d8680ef6687980296ab170bbb002c0dc81bc15edebdf9db9750e43eddb",
   "examples/scene-shots.stillmade.json": "d10a0aebb42ff090035410dc92ab708ffaf50b579edac4aa2f2cf6150b3ef537",
-  "examples/score-a-scene.stillmade.json": "ecc05642d82d2507803389350c7ea574c4c3f761dd629289e0c1c8fa28713292",
+  "examples/score-a-scene.stillmade.json": "6059f2f65c48309f0c1711dbb6b5ee62a957ce07502a936f53b29685b425f8ec",
   "examples/screen-recorder.stillmade.json": "f3509a577cdd6615d6687ed0be108ddef51bf1f79ff0e2176470e46c3054640d",
-  "examples/script-draft.stillmade.json": "6c62787353c361ed2e9e255eb03047093ebdc4d678cfeb8be97b8b36e27b4102",
+  "examples/script-draft.stillmade.json": "3e8fc6e164c7b02f5f07ceb9771159e88252d405fa96a19107427e85c0457608",
   "examples/shot-readiness.stillmade.json": "ed73fe9038afaed7c12435368e90001f0bd3cebd8f0e6fe06508c1bb80c8cb7e",
-  "examples/summarize-page.stillmade.json": "fe2956a76d99d5cb10de69b763649064991ac9ac00a8e216db852a725be3e65e",
-  "examples/text-workflow.stillmade.json": "0d53e7498fb47702055e206b75e0111bb1cdcca1b086931e4628e0a3c79e70dc",
-  "examples/thicken-lines.stillmade.json": "7948c6d686de61cd32234a00f12c22229d601360093f50966d50b4e8a4ee759c",
+  "examples/summarize-page.stillmade.json": "21f8be251733d1c236328f23fa0da6b4e5381d34374489926db61bdd54f3b75f",
+  "examples/text-workflow.stillmade.json": "286c2235cfc88d537556b94ee5735a05f2b790a0fb772014773ac7cf096ba455",
+  "examples/thicken-lines.stillmade.json": "287c872d44a18b8c7f79fb2d4047c78a54c1f2b315bd6ce4c1340d4e54d87dac",
   "examples/timeline-mixer.stillmade.json": "93220984a88ca553dcf7102ce82b23d16eadda07809a89222a8589506743b5f8",
-  "examples/timeline-polish.stillmade.json": "ababd22681cbd640a4e28469f428161fe739dfca007b87b7563c39c214597997",
-  "examples/transcribe-audio.stillmade.json": "75754c5389dd49ed5b3c784f5ee5b17926c02afbf0c94fb9c0d1fb8830f64c57",
+  "examples/timeline-polish.stillmade.json": "478398bae41271424b4bd3cfa03d704df515b12370f81052fbde463f48b01471",
+  "examples/transcribe-audio.stillmade.json": "a03b5fcd620b3a386c2c713239f026392ce4f1484a9c38c5bb9943e2eb6c4f1a",
   "examples/view-react-chart": "a0e7ef5148e386b34e405187761d23f1739809c3d72c68c7c6b4e2193747218e",
-  "examples/word-count.stillmade.json": "6731ab355c4d5918e0b106481a0486303653a6bd19696e52bb21aaac38118d53"
+  "examples/word-count.stillmade.json": "b815282e2dcd2827952e4a8bde403c5935141a98b9d54ee055da2b9d55cb43eb"
  }
 }

package/AGENTS.md

@@ -6,7 +6,7 @@ This folder is the StillMade Block SDK. Read this file before writing code; it i
 
 Do not tell the user a Block is ready, done or working until `node packages/block-cli/cli.js gate .` (`gate <block-folder>` for a Block outside this SDK folder) passes after your last edit, and report the exact status it prints. In this folder Claude Code (`.claude/settings.json`) and Cursor (`.cursor/hooks.json`) run the gate when you finish a turn and send any failures back to you, but only in a session started in this folder: if you downloaded the SDK during the current session, run the gate yourself. Other agents must also run it themselves. A module Block runs code, so the gate a hook starts does not run it and says so: run `gate` or `ready` on it yourself. If you cannot fix a failure, say plainly that the Block is not ready and list the failing checks.
 
-Contract `stillmade.block-builder@1.12.0`. Humans, coding agents, imported source, GitHub repositories and generated code all adapt to the Block platform; anything that becomes a StillMade Block obeys this contract.
+Contract `stillmade.block-builder@1.17.0`. Humans, coding agents, imported source, GitHub repositories and generated code all adapt to the Block platform; anything that becomes a StillMade Block obeys this contract.
 
 ## Source of truth
 
@@ -68,9 +68,13 @@ Give the Block a short, plain name of 40 characters or fewer that says what it d
 
 Name each input for what the person brings, in the job's words: `sermonVideo` for a sermon clip Block, `listingPhotos` for a listing, `lessonSlides` for a lesson podcast. StillMade titles the input from that name ("Sermon video") and words its drop area from it ("Drop your sermon video here", the formats, "Choose a video"), in StillMade and the SDK preview, so never draw your own upload box for an input. Keep a bare type name (`video`, `file`) only when any file of that kind does the job. The `description` says what makes a good one.
 
+## Speak the job
+
+These are StillMade's defaults: unless the person or the creator asked for something else, every screen speaks the job in its own words and adds nothing else. `manifest.action` names the Step's button, {label:"Plan the tour", running:"Planning the tour…"}, and StillMade adds the price ("Plan the tour · 1 credit"). Every Block whose Step shows StillMade's button declares it: any Block without its own screen, and any that calls operations. Without it StillMade can only guess from the Block's name or output ("Make clips"), and the readiness gate and StillMade's own builder send the Block back until it names the job. When the Block makes a picture, video or sound with AI the label starts with Generate and says what ("Generate tour", "Generate voiceover"); one that cuts or renders the person's own media says Make ("Make 6 clips"); never "Make it", "Run", "Submit", "Process" or a bare "Generate". The main button stands out: one solid `sm-primary` in the kit's ink, never restyled to the background; everything else is `sm-quiet` or an `sm-icon`, and close is an X icon. Report progress in the job's units with `stillmade.progress(fraction, label)` ("Moving through the kitchen, 4 of 9 rooms"), never "Processing". Head the result in the job's words ("9 rooms", "Your tour · 44 s"), never "Output". Say a problem in one line with its fix beside it ("No bathroom photo. Guests look for one." and Add photo). Stay quiet: no welcome text, tips under fields, tours or banners, and at most one line of guidance on a screen, only where the next move is not obvious; anything more goes in the input's `description`, which StillMade shows behind an (i). Say nothing about how the Block works (where it runs, saving, syncing, recovery, accounts, credits) or where a file is kept: StillMade tells the person what they need as one short notification, or nothing; never a sentence on the page, and never the same line under each item. Every drop area offers "Use a reference", which fills the Step from the person's saved photos, videos and notes: media inputs fill by kind, so take `video` or `asset` where a clip works as well as a photo, and text inputs fill by plain names and labels (`productName`, `website`, `brandColors`, `fonts`, `voice`, and `details` or `notes` for the reference's note); never build your own reference picker. Days and times are picked, never typed: use the `date` type, which StillMade shows as a calendar, with a list of times when the input is about a time (`postAt`, `startsAt`); a custom view uses `<input type="date">` or `type="datetime-local"`. Posting is a connector Step of its own, and StillMade words its button from the app and action ("Post to Instagram"). Before handing the Block back, clear every Wording note that `gate` and readiness list, unless the person asked for those words.
+
 ## Interface
 
-If the capability needs UI, use the Block UI SDK: generated `manifest.ui` controls first; a sandboxed custom view (`view.html`/`view.css`/`view.js`) only when the core interaction needs one. Build custom views from the Block kit the host injects (`block-kit.css`): the result in `sm-stage`, picks as pictures in `sm-choices`, one `sm-primary` naming the action (Write, Generate; never "Run") and no price (StillMade's run button adds it), extras in a closed `sm-more`; a look the person names wins. Fit one laptop screen without scrolling: label beside control, status in a few words, files as tiles, rare tools as icons, (i) on unclear controls. These compact rules are for a job or an ingredient. Size the view to the Block's tier (block-tier.js): an app, a workspace a person works in for a while (video editor, 3D configurator, CAD or drawing tool), looks and works like that kind of app instead of a compact page: its canvas or stage fills the view, with the panels, toolbars, inspector or timeline such an app has, direct manipulation (select, drag, zoom), keyboard shortcuts and undo; it keeps the host appearance and Block kit controls, its panels may scroll, and on a phone its tools fold into sheets while the canvas stays usable. Never shrink an app into a form of fields and one button. Drop words nobody needs; put helpful ones in a closed `sm-hint`. Mark each button `data-stillmade-action="what it does"` and label each field: Chat presses and fills them. Expose the capability, not the implementation: sensible defaults, previews, progress, clear errors, visible outputs. Show no raw JSON, internal IDs, filesystem details, provider terms or developer settings unless the Block is a developer tool. When a person chooses among options they need to hear or see (voices, music, fonts, looks, templates, images), let them preview each option before choosing: a sample or thumbnail from the Block's own files or the host's free samples, never a paid generation. Skip previews only when there is nothing to preview. Choices StillMade owns (voices, models in the run review) already show samples. Follow the host appearance (Light, Dark and White) and one elastic layout: stacked on a 320px phone with no sideways scroll (result first, action pinned), and from 860px the controls left (≤380px), the result filling the right. Short settings sit side by side, each label beside its control (`sm-field`, `sm-settings`; three or four short options as one `data-segmented` row); many items are one line each (`sm-list`) that open in place; input files are small tiles (`sm-gallery data-size="small"`); on a phone chip rows scroll sideways and long lists show three. Compacting moves controls, never deletes them.
+If the capability needs UI, use the Block UI SDK: generated `manifest.ui` controls first; a sandboxed custom view (`view.html`/`view.css`/`view.js`) only when the core interaction needs one. Build custom views from the Block kit the host injects (`block-kit.css`): the result in `sm-stage`, picks as pictures in `sm-choices`, the picked one in the kit's ink fill (never restyled to an outline, a tint or the page's background) so it reads at a glance, one solid `sm-primary` naming the action in the job's words ("Plan the tour", "Generate voiceover"; never "Run" or "Make it") and no price (StillMade's run button adds it), extras in a closed `sm-more`; a look the person names wins. Fit one laptop screen without scrolling: label beside control, status in a few words, files as tiles, rare tools as icons, (i) on unclear controls. These compact rules are for a job or an ingredient. Size the view to the Block's tier (block-tier.js): an app, a workspace a person works in for a while (video editor, 3D configurator, CAD or drawing tool), looks and works like that kind of app instead of a compact page: its canvas or stage fills the view, with the panels, toolbars, inspector or timeline such an app has, direct manipulation (select, drag, zoom), keyboard shortcuts and undo; it keeps the host appearance and Block kit controls, its panels may scroll, and on a phone its tools fold into sheets while the canvas stays usable. Never shrink an app into a form of fields and one button. StillMade centers a standard view narrower than its Step and zooms a view to fill its space; an app that lays itself out (full-size canvas or WebGL, its own scroll, pan or zoom, its own Ctrl/Cmd +/- keys) puts `data-stillmade-layout="own"` on its outermost element, and StillMade then never centers, zooms or takes those keys. StillMade draws one player for every `<video controls>` (play, timeline, time, sound and full screen, shown while the pointer is on the video, with keys and touch) and a full-screen button on result pictures in `sm-stage` or `sm-gallery` and on any element marked `data-stillmade-expand` (the same value makes one set of pictures, `off` removes it); `data-stillmade-player="native"` keeps the browser's controls, and a `<video>` without `controls` is the Block's own and is never touched. A picture or clip that cannot show here (kept on another device, or it did not open) keeps its place as a quiet `sm-media-off` tile in its own shape with the `image-off` glyph and the reason in its label, never words in its place. Drop words nobody needs; put helpful ones in a closed `sm-hint`. Mark each button `data-stillmade-action="what it does"` and label each field: Chat presses and fills them. Expose the capability, not the implementation: sensible defaults, previews, progress, clear errors, visible outputs. Show no raw JSON, internal IDs, filesystem details, provider terms or developer settings unless the Block is a developer tool. When a person chooses among options they need to hear or see (voices, music, fonts, looks, templates, images), let them preview each option before choosing: a sample or thumbnail from the Block's own files or the host's free samples, never a paid generation. Skip previews only when there is nothing to preview. Choices StillMade owns (voices, models in the run review) already show samples. Follow the host appearance (Light, Dark and White) and one elastic layout: stacked on a 320px phone with no sideways scroll (result first, action pinned), and from 860px the controls left (≤380px), the result filling the right. Short settings sit side by side, each label beside its control (`sm-field`, `sm-settings`; three or four short options as one `data-segmented` row); many items are one line each (`sm-list`) that open in place; input files are small tiles (`sm-gallery data-size="small"`); on a phone chip rows scroll sideways and long lists show three. Compacting moves controls, never deletes them.
 
 ## Shared editing
 

package/FRAME_VIEWS.md

@@ -60,6 +60,47 @@ rest. Colors written with them follow Light, Dark and White automatically.
 Frame views are not required to use them; the appearance check reports
 hard-coded colors as advice instead of refusing the view.
 
+## Layout
+
+StillMade zooms a view to fill the space its Step gives it (up to 150%), and
+Ctrl/Cmd +, - and 0 size the view while it has focus. It never centers a frame
+view; a standard view narrower than its Step is centered by its margins.
+
+An app that lays itself out (a full-size canvas or WebGL, its own scroll, pan
+or zoom, its own Ctrl/Cmd +/- keys, as in a CAD or drawing tool) puts
+`data-stillmade-layout="own"` on its outermost element:
+
+```html
+<div id="root" data-stillmade-layout="own"></div>
+```
+
+StillMade then never centers or zooms it and leaves Ctrl/Cmd +, - and 0 to the
+app. Without the attribute StillMade also stays out of the way when the view
+looks like an app: no page padding, a clipped page, a root as tall as the frame,
+fixed over half of it or scrolling over half of it, a canvas, SVG or
+`touch-action: none` surface over 40% of it, or a canvas or SVG of 300x200 or
+more with `touch-action: none` (as Three.js's controls set it). Mark the root
+anyway, in `view.html` rather than from code: StillMade reads it before the view
+starts, so the app never shows StillMade's size control or loses a key to it,
+even while it is still loading.
+
+A `<video controls>` plays in StillMade's player, the same one as everywhere in
+StillMade: play, timeline, time, sound and full screen along the bottom, shown
+while the pointer is on the video, with keys on the focused video (Space or K,
+the arrows, M, F) and touch. Full screen goes through StillMade, right after a
+click or key in the view; the frame itself has no `allow="fullscreen"`. A
+`<video>` without `controls` is the Block's own and StillMade never touches it,
+so a Block that drives playback (its own timeline, an editor or CAD viewer)
+leaves `controls` out, and `data-stillmade-player="native"` keeps the browser's
+controls. Result pictures from `StillMade.previewImage` in `sm-stage` or
+`sm-gallery`, and any element marked `data-stillmade-expand`, get a full-screen
+button in the bottom-right corner while the pointer is on them; pictures with
+the same value (`data-stillmade-expand="shots"`) open as one set, and
+`data-stillmade-expand="off"` removes the button. The keyboard reaches them
+too: such a picture without a `tabindex` of its own joins the tab order,
+keyboard focus on it shows the button, Enter or Space opens the viewer, and
+closing the viewer gives the focus back to the picture.
+
 ## Assets
 
 Images, fonts, JSON, audio and video the view needs ship as files named by

package/INTERFACE_DESIGN.md

@@ -41,7 +41,7 @@ piece in Light, Dark and White.
   </div>
 
   <div class="sm-actions">
-    <button type="button" class="sm-primary" id="run" data-stillmade-action="run">Make it</button>
+    <button type="button" class="sm-primary" id="run" data-stillmade-action="make the clip">Make the clip</button>
     <p class="sm-status" id="status" role="status"></p>
   </div>
 
@@ -57,7 +57,7 @@ piece in Light, Dark and White.
 | `sm-block` | The one workspace. `data-layout="split"` puts the stage beside the controls on wide screens. |
 | `sm-stage` | The thing being made: preview, media or result. `data-ratio="16:9"`, `"9:16"` or `"1:1"`. |
 | `sm-empty` | An empty stage: a glyph, at most five words, one action. |
-| `sm-choices` | Picks shown as pictures (`img`, `.sm-swatch`, `.sm-glyph`) and one or two words. `data-compact` for short text chips, `data-segmented` for one connected row of three or four short options. Chips and segments scroll sideways on a phone. Give the `fieldset` an `id` and `data-stillmade-share` so teammates see the same pick. |
+| `sm-choices` | Picks shown as pictures (`img`, `.sm-swatch`, `.sm-glyph`) and one or two words. `data-compact` for short text chips, `data-segmented` for one connected row of three or four short options. The pick is filled with the kit's ink, so it reads at a glance; a `disabled` fieldset keeps its pick and fades the rest. Chips and segments scroll sideways on a phone. Give the `fieldset` an `id` and `data-stillmade-share` so teammates see the same pick. |
 | `sm-field`, `sm-fields` | One short setting on one row, its label beside the control; a responsive group of them. On a phone the control wraps under its label only when both do not fit. A textarea, picture choices, file tiles or a list keep the label above. |
 | `sm-settings` | Short settings side by side, each label beside its control; a narrow cell wraps the control under its label. |
 | `sm-list` | Many items, one line each: a thumbnail, one line of text, a short fact. An item that opens in place is an `li` holding a `details`. `data-peek` shows three on a phone, with a last `li.sm-list-more` button that sets `data-open`. |
@@ -67,7 +67,8 @@ piece in Light, Dark and White.
 | `sm-more` | A closed `<details>` for secondary settings. |
 | `sm-hint` | A closed `<details>` info toggle for an explanation that might help. |
 | `sm-gallery` | A grid of results or media. `data-size="small"` for input files: more tiles per row as the screen widens. |
-| `sm-glyph` | A small icon in `currentColor`: `play`, `pause`, `plus`, `close`, `check`, `chevron`, `upload`, `image`, `video`, `audio`, `text`, `spark`, `info`, `warning`, `spinner`. Works in standard views, which cannot use SVG. |
+| `sm-media-off` | A picture or clip that cannot show here (on another device, or it did not open): a quiet tile in its own shape (`--sm-photo-ratio`, the tile's shape in a gallery) holding the `image-off` glyph, the reason in `aria-label` and `title`, no words inside. |
+| `sm-glyph` | A small icon in `currentColor`: `play`, `pause`, `plus`, `close`, `check`, `chevron`, `upload`, `image`, `image-off`, `video`, `audio`, `text`, `spark`, `info`, `warning`, `spinner`. Works in standard views, which cannot use SVG. |
 
 **Function first.** When the person building a Block does not ask for a look,
 use the kit as is: they want it to work and be easy to use. When they name a
@@ -83,8 +84,9 @@ designs keep `appearance: "original"`.
 | might help some people (what a setting does, a format limit) | Put them in a closed `sm-hint`, or secondary settings in a closed `sm-more`. |
 | report an error, a spending approval, a stale input or a destructive step | Keep them visible, in few words. Say what to do next. |
 
-Buttons say the action in one to three words ("Make it", "Export"). Status says
-the state in one to four words ("Making", "Ready", "Needs approval").
+Buttons say the action in the job's words, one to four of them ("Plan the tour",
+"Make 6 clips", "Export"), never "Make it". Status says the state in one to four
+words ("Making the clip", "Ready", "Needs approval").
 
 The button that makes something names what it makes ("Write", "Generate image",
 "Make video"), never "Run", "Run step", "Submit" or "Review cost", and says the
@@ -98,7 +100,56 @@ the same single priced button. Pressing a priced button runs at that price; a
 confirmation appears only when the server's price is higher than the one shown.
 Do not write credit numbers in the Block.
 
-## 3. Rules
+## 3. Speak the job
+
+These are StillMade's defaults for every Block, and they apply wherever the
+person or the creator has not asked for something else. What they ask for wins.
+
+- **The job's words everywhere.** Bringing ("Your listing photos"), starting
+  ("Plan the tour"), working ("Moving through the kitchen, 4 of 9 rooms"),
+  done ("Your tour · 44 s") and problems ("No bathroom photo. Guests look for
+  one." with Add photo beside it). Never "Make it", "Run", "Submit",
+  "Process", "Processing", "Output" or "Result".
+- **Name the Step's button in `manifest.action`**:
+  `{"label":"Plan the tour","running":"Planning the tour…"}`. StillMade adds the
+  price ("Plan the tour · 1 credit"). A picture, video or sound made with AI
+  starts with Generate and says what ("Generate tour", "Generate voiceover");
+  cutting or rendering the person's own media says Make ("Make 6 clips").
+  Bare "Generate" or "Make" is not enough.
+- **The main button stands out.** One solid `sm-primary` per screen, in the
+  kit's ink, never restyled to the page's background or a ghost outline; every
+  other button is `sm-quiet` or an `sm-icon`. Close is an X icon, not the word.
+- **Quiet.** At most one line of guidance on a screen, only where the next
+  move is not obvious. No welcome text, tips under fields, tours or banners.
+  Anything more goes in the input's `description`, which StillMade shows
+  behind an (i).
+- **Say nothing about how the Block works.** No notes on where it runs (this
+  device, StillMade Desktop, the cloud), saving, syncing, recovery, accounts,
+  credits or where a file is kept: StillMade says what a person needs, as one
+  short notification, or nothing. Never a sentence on the page, and never the
+  same line under each item.
+- **References fill your inputs.** Every drop area in StillMade offers "Use a
+  reference": the person's saved photos, videos and notes fill the Step's
+  fields with no typing. Media inputs fill by kind, so take `video` or `asset`
+  wherever a clip works as well as a photo. Text inputs fill by their name and
+  label: name them plainly (`productName`, `website`, `brandColors`, `fonts`,
+  `voice`), and give the one that takes a reference's note a name such as
+  `details`, `notes` or `listingDetails`; when a note has to be split across
+  several fields StillMade does it free. Never build your own reference
+  picker or library upload.
+- **Days and times are picked, never typed.** Use the `date` type. StillMade
+  shows a calendar, and a list of times as well when the input is about a time
+  (a name such as `postAt` or `startsAt`, a label with Time, When or Starts, or
+  a value with a time). In a custom view use `<input type="date">` or
+  `type="datetime-local"`, never a text box for a date.
+- **Posting is its own Step.** Sending a result to Instagram, TikTok, email or
+  any app is a connector Step after the Block, and StillMade words its button
+  ("Post to Instagram"). A Block never posts from inside itself.
+- **Chat can do all of it.** Every button carries `data-stillmade-action`
+  naming what it does and every field a label, so the project's Chat can press
+  and fill them.
+
+## 4. Rules
 
 These are requirements for every author, person or model. Not all are checked
 automatically. An explicit request from the person can authorize a named
@@ -150,7 +201,16 @@ exception, never unrelated technical UI.
     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 given so far, not an empty box. `data-layout="stack"`
-    keeps one column.
+    keeps one column. StillMade zooms a view to fill its space and centers a
+    standard view narrower than its Step (by its margins only, so a margin
+    the view sets wins). An app that lays itself out (full-size canvas or
+    WebGL, its own scroll, pan or zoom, its own Ctrl/Cmd +/- keys) puts
+    `data-stillmade-layout="own"` on its outermost element, and StillMade
+    then never centers, zooms or takes those keys. StillMade plays every
+    `<video controls>` in its own player with full screen, and puts a
+    full-screen button on result pictures in `sm-stage` or `sm-gallery` and
+    on anything marked `data-stillmade-expand`; a `<video>` without
+    `controls` is the Block's own and is never touched.
 17. Settings sit side by side, next to what they change. Short settings are
     an `sm-settings` grid, and three or four short options (Low / Med /
     High, 16:9 / 9:16 / 1:1) are one `data-segmented` row, not big tiles.
@@ -165,8 +225,24 @@ exception, never unrelated technical UI.
 20. Nothing is lost when a Block gets smaller. Every control stays on the
     screen, behind an (i), in `sm-more`, or inside the item it belongs to.
     Compacting moves controls; it never deletes them.
+21. A picked option reads at a glance. The kit fills an `sm-choices` pick with
+    its ink (`--fg` behind `--bg` words, the same inversion as every
+    segmented control in StillMade); never restyle it to an outline, a tint or
+    the page's background. A locked row (`disabled`, or a person who can only
+    view) keeps its pick filled, fades the other options and does not react to
+    the pointer.
+22. Media that cannot show here (kept on another device, or it did not open)
+    keeps its place as a quiet `sm-media-off` tile in its own shape with the
+    `image-off` glyph, the reason in its `aria-label` and `title`. Never words
+    in its place:
+
+    ```html
+    <span class="sm-media-off" role="img" aria-label="On another device" title="On another device" style="--sm-photo-ratio:3/2">
+      <span class="sm-glyph" data-glyph="image-off" aria-hidden="true"></span>
+    </span>
+    ```
 
-## 4. What StillMade checks
+## 5. What StillMade checks
 
 - Admission rejects a primary textarea of 12 or more rows when no task
   presentation (stage, media, list or `StillMade.render`) is detected
@@ -175,6 +251,11 @@ exception, never unrelated technical UI.
   ungrouped options, more than one `h1`, a visible paragraph over twenty words,
   a word dropdown for something people see or hear, a bare browser file
   picker, and a size limit printed in view.
+- Readiness notes settings left loose on the page: three or more `sm-field`
+  outside an `sm-fields`, `sm-settings`, `sm-more` or `sm-list` group. The kit
+  gives that group its own surface, so the inputs, the settings and the result
+  read apart; the SDK gate and StillMade's builder send the note back like any
+  Wording note.
 - Admission warns about the compact rules it can see in the source: a short
   input or select whose label sits above it outside `sm-field` / `sm-settings`
   (a `<br>` between them, or a label made `display: block`); a heading,
@@ -190,6 +271,17 @@ exception, never unrelated technical UI.
   (`blockKitProblems`; the failing rules are `BLOCK_KIT_READINESS_RULES`). StillMade's own Block builder also sends back a custom
   view that is not built from `sm-block`, unless the person asked for their
   own look (`appearance: "original"`).
+- Admission warns, and readiness lists a "Wording" limitation, when a button
+  says "Make it", "Generate", "Create", "Process" or "Do it"; when progress
+  says "Processing", "Loading" or "Working"; when a visible line explains where
+  the Block runs or how it saves; when a date is typed into a text box; when
+  the CSS turns `sm-primary` into a background-coloured button; when the CSS
+  takes the ink fill off a pick (`.sm-choices label:has(input:checked)` with a
+  transparent or page-coloured background, or the ink as its text colour); and
+  when the page or a string in its code says where a file is kept ("Only on
+  this device", "Not on this device"). Clear
+  every one before you hand the Block back, unless the person asked for those
+  words. They never refuse a release.
 - The host supplies the Project Type step bar and omits its own title and frame
   around custom views, and does not add a "Technical result" disclosure.
 - HTML, JavaScript, permission and appearance validation are separate checks.

package/MOBILE_UI.md

@@ -37,7 +37,9 @@ still owns specialized workspace layout. A 320 CSS-pixel phone viewport leaves
 less than 320 pixels inside the host's preview gutters. Size from the embedded
 view's actual container, avoid a 320-pixel minimum width, wrap long labels, and
 isolate intentional canvas/timeline panning from
-the surrounding toolbar. Provide visible buttons or menus for actions otherwise
+the surrounding toolbar. A `<video controls>` gets StillMade's player, whose
+44-pixel controls a tap shows for 3 seconds (a first tap never starts playback),
+and a result picture's full-screen button shows for 3 seconds after a tap on it. Provide visible buttons or menus for actions otherwise
 available by hover, drag, right-click, or keyboard shortcut. Label fields and
 announce loading, errors, and completed output with `role="status"`,
 `role="alert"`, or `aria-live` as appropriate. For deterministic custom-view