stillmade-sdk 0.1.40 → 0.1.42

package/UI_AESTHETIC.md

@@ -209,6 +209,12 @@ before/after examples from an Image Panels project (Voiceover 1,210 px to about
 
 - Label and control on one row. No label stacked above a short control, no card
   around a single control, no help line under every field.
+- Sections stand apart (November 3, 2026, owner: "make sure it's more
+  separated"). What goes in (the files), the settings and the result are separate
+  parts: the settings sit together on one card, the same surface as the files
+  card, with a hairline between rows. StillMade's Step page does this for every
+  Block; a Block's own screen gets it from the kit's `sm-fields` / `sm-settings`
+  group. Never a card inside a card.
 - Status is a dot or a few words ("No narration yet"), never a paragraph; the
   reason sits behind an info toggle.
 - Files are tiles: a saved file is a thumbnail or chip, adding one is a + tile.
@@ -239,6 +245,18 @@ before/after examples from an Image Panels project (Voiceover 1,210 px to about
   "6 more", long text shows five lines. Kit: `sm-settings`,
   `sm-choices[data-segmented]`, `sm-gallery[data-size="small"]`, `sm-list`,
   `sm-clamp`.
+- A picked option reads at a glance (November 2, 2026; owner, of a Step's Kind
+  and Voice rows: "there is like no separation and I can't tell what's going
+  on"). In every choice row, chip row, picture tile and segmented control the
+  pick is the foreground/background inversion (`--fg` fill, `--bg` words), as
+  Credits & plans, the Block Builder's toolbar and the Home filters already do;
+  never an outline alone, a tint, or `--bg-elev-2` over `--bg-elev-1`. Hover
+  never paints the picked option. A locked row (view only, or while a run works)
+  keeps its pick filled, fades the other options and drops the hover and the
+  pointer cursor. When a label sits beside the options, wrapped options stay in
+  their own column, never under the label. Kit: `sm-choices` (Block views and
+  the app), the Step page (`stepWorkspaceKit.css`) and the run popover
+  (`sm-run-tiles`).
 - Nothing is lost when a screen gets smaller: every control stays, behind an
   (i), in a one-tap menu, or inside the item it belongs to. The dealership
   Steps with every control accounted for: `docs/ui-review/wide-steps.html`.
@@ -255,11 +273,16 @@ accessible name and a tooltip; retain visible text when the meaning would be unc
 ## Run buttons say what they do and what they cost
 
 - The button that starts a Step, Block or job never says "Run step", "Run",
-  "Run in project" or "Review cost". It names what happens: Write, Generate,
-  Make video, Make voiceover, Transcribe, Research, Send. While it works it says
-  so ("Writing…") with Stop beside it; afterwards it offers the same action again.
+  "Run in project" or "Review cost". It names what happens: Write, Transcribe,
+  Research, Post to Instagram. Whatever AI makes as a picture, video or sound says
+  Generate, then what: "Generate image", "Generate video", "Generate voiceover"
+  (November 2, 2026). Media made on the device from the person's own files says
+  Make ("Make video", "Make 6 clips"). A Block's own `manifest.action`
+  ({label:"Plan the tour", running:"Planning the tour…"}) wins over these.
+  While it works it says so ("Writing…") with Stop beside it; afterwards it offers
+  the same action again.
 - When the run costs credits, the price is part of the button:
-  "Write · 1 credit", "Generate · 28 credits". Paid with the person's own key it
+  "Write · 1 credit", "Generate image · 28 credits". Paid with the person's own key it
   reads "Write · your key". When the price is not known before a quote, the button
   shows only the action and the quote opens the review.
 - When the model, quality or count can change, one chip with a caret sits right
@@ -273,6 +296,72 @@ accessible name and a tooltip; retain visible text when the meaning would be unc
 - Steps use `StepRunControls` and `client/src/blocks/runAction.js` for the verb
   and price; reuse them instead of writing new run buttons.
 
+## Speak the job (November 2, 2026)
+
+These are defaults for anything nobody specified; when the creator or the person
+asks for something else, that wins. Mockups: `docs/ui-review/job-words-journeys.html`
+(three Project Types end to end) and `docs/ui-review/history-modal.html`.
+
+- Every screen says, in the job's own words, what to bring, what the button makes,
+  what is happening, what came back and what is off, and adds nothing else.
+  "Drop your listing photos here", "Plan the tour · 1 credit", "Moving through the
+  kitchen, 4 of 9 rooms", "Your tour · 44 s", "No bathroom photo. Guests look for
+  one." beside Add photo. Never "Choose file", "Run", "Processing", "Output" or an
+  error code. Step names are the job's too ("Plan the tour", not "Block 2").
+- Quiet by default: no welcome text, tips under fields, tours or banners. At most
+  one line of guidance on a screen, only where the next move is not obvious; more
+  goes behind an (i). A problem is one line with its fix beside it.
+- Inputs are named for what the person brings (`sermonVideo`); StillMade words the
+  drop area from the name. The readiness report notes a button that would read
+  "Make it" or "Run" and inputs named only by type; it never refuses a Block for it.
+- Buttons you act on stand out from the page. The main one is solid ink, whether
+  it costs credits or not; every other action button is white (`--bg-elev-1`) with a
+  strong edge (`--border-strong`). None is the page's own colour. Gold stays for
+  small accents.
+- Posting is a connector Step of its own, and its button says what it sends and
+  where ("Post to Instagram", "Schedule post"), never "Send".
+- Saved references fill Steps: "Use a reference" sits in the drop area beside
+  "Choose". It opens every saved reference, photos, videos and notes, named or not,
+  and picking one fills every field it fits. Types and names match with no model;
+  only a paragraph that has to be split across fields goes to a quick, cheap model,
+  free to the person.
+- Days and times are picked from a calendar and a list of times, never typed.
+- History is one icon in the Project map's header, shown on every saved project whether or not anything is recorded
+  yet (November 3, 2026). A Step has no row of tool icons of its own.
+- Chat can do everything these screens do: pick a reference, fill fields, pick a
+  time, post, and bring back an earlier version.
+
+## Media playback and full screen (November 2, 2026)
+
+Owner, November 2, 2026: "implement A absolutely universally, like in app, platform, sdk, just everywhere", with the
+full-screen button in the bottom-right corner. Every user-facing video and result picture in the app, on public pages
+and in Block views (old releases included) uses one player and one viewer, option A "Cream blocks"
+(`packages/design-system/media-player.js` and `media-player.css`; `MediaPlayer`, `MediaViewer` and `MediaExpandButton`
+in React; `client/public/stillmade-media.js` on server pages; `client/src/blocks/sandboxMedia.js` in Block views).
+
+- Controls, left to right along the bottom: play, timeline, time, sound, full screen. Full screen is last, in the
+  bottom-right corner. Each button is a 44 px solid cream rounded square (`--r-3`) with an ink icon from the app set;
+  never a circle. The time is the display face, italic 200. The chrome sits on the picture, so it is the same in Light,
+  Dark and White; the letterbox is ink.
+- Hover only. Owner: "make sure I have to hover over the video for it to appear". The controls and their shade show
+  only while the pointer is over the video, paused or playing, before the first play too; they fade 2 s after the last
+  move while a video plays. Keyboard focus shows them. On touch a tap shows them for 3 s and never starts playback.
+- Photos get one full-screen button, the video's square in the same corner: 44 px on pictures at least 240 px wide and
+  160 px tall, 32 px on smaller ones. Owner: "if I hover over it, it appears; hover out of it, it disappears". Only on
+  results, listing and gallery pictures; never on icons, avatars, picker thumbnails, editor canvases or drag sources. A
+  picture that already opens its own viewer (versions, Edit image) hands the button's click to it.
+- The viewer is a modal dialog on ink: the picture contained, Close top right, Previous and Next at the middle of the
+  sides, the count in the display face ("2 of 4") and the name below. Esc closes only the viewer.
+- A file that cannot open here (kept on another device, or it did not open) is a quiet tile in its own shape with an
+  image-off icon and no words, the reason in its label and tooltip (owner, November 2, 2026, of four tiles each saying
+  "Only on the device it was added from": "if it's a notification make it a notification"). What the person needs to
+  know is one toast for the group, or nothing ("notices, not prose"); never a sentence on the page and never the same
+  line under each item. App: `MediaOffTile`; Block views: the kit's `sm-media-off` tile with the `image-off` glyph.
+- Bare previews stay bare: thumbnails, covers, hover-play tiles, editor transports and canvas previews.
+- A Block view's `<video>` without `controls` is the Block's own and is never touched;
+  `data-stillmade-player="native"` keeps the browser's controls. Full screen in a Block view is the host's: the frame
+  fills the screen only right after a click or key in the view.
+
 ## Dialog placement and dismissal
 
 - Center search and other transient dialogs in the viewport, independent of the

package/examples/check-clip.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.check-clip",
+    "action": {
+      "label": "Check clip",
+      "running": "Checking clip…"
+    },
     "version": "1.0.0",
     "name": "Check a clip",
     "description": "Answer a production question about a saved video clip, with timestamps.",

package/examples/clean-text.stillmade.json

@@ -7,6 +7,10 @@
     },
     "sdkVersion": "0.1.0",
     "id": "example.clean-text",
+    "action": {
+      "label": "Clean text",
+      "running": "Cleaning text…"
+    },
     "version": "1.0.0",
     "name": "Clean text",
     "description": "Trims extra space from text and returns a clean copy for the next step.",

package/examples/custom-interface.stillmade.json

@@ -7,6 +7,10 @@
     },
     "sdkVersion": "0.1.0",
     "id": "example.clean-text-interface",
+    "action": {
+      "label": "Clean text",
+      "running": "Cleaning text…"
+    },
     "version": "1.1.0",
     "name": "Clean text studio",
     "description": "Edit text, run the cleanup, and compare the result in a responsive self-contained workspace.",

package/examples/describe-image.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.describe-image",
+    "action": {
+      "label": "Describe image",
+      "running": "Describing image…"
+    },
     "version": "1.0.0",
     "name": "Describe an image",
     "description": "Turn one owned image into concise production-ready visual notes.",

package/examples/foley-cue.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.foley-cue",
+    "action": {
+      "label": "Generate sound",
+      "running": "Generating sound…"
+    },
     "version": "1.0.0",
     "name": "Foley cue",
     "description": "Generate a short sound effect from a written description.",

package/examples/generate-image.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.generate-image",
+    "action": {
+      "label": "Generate image",
+      "running": "Generating image…"
+    },
     "version": "1.0.0",
     "name": "Generate an image",
     "description": "Generate a square PNG from a short visual prompt using an approved host request.",

package/examples/generate-video.stillmade.json

@@ -2,6 +2,10 @@
   "manifest": {
     "schemaVersion": 1,
     "id": "example.generate-video",
+    "action": {
+      "label": "Generate video",
+      "running": "Generating video…"
+    },
     "name": "Generate video",
     "version": "1.0.0",
     "sdkVersion": "0.1.0",

package/examples/module-word-stats/stillmade.block.json

@@ -2,6 +2,10 @@
   "schemaVersion": 1,
   "sdkVersion": "0.1.0",
   "id": "example.word-stats",
+  "action": {
+    "label": "Count words",
+    "running": "Counting words…"
+  },
   "version": "1.0.0",
   "name": "Word stats",
   "description": "Counts words and finds the longest one, as a modern JavaScript module.",

package/examples/narrate-script.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.narrate-script",
+    "action": {
+      "label": "Generate voiceover",
+      "running": "Generating voiceover…"
+    },
     "version": "1.0.0",
     "name": "Narrate a script",
     "description": "Turn a short script into a reviewed speech recording using a host-selected voice.",

package/examples/numbered-takes.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.numbered-takes",
+    "action": {
+      "label": "Number takes",
+      "running": "Numbering takes…"
+    },
     "version": "1.0.0",
     "name": "Numbered takes",
     "description": "Label successive creative takes with an independent counter for each production placement.",

package/examples/research-topic.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.research-topic",
+    "action": {
+      "label": "Research topic",
+      "running": "Researching topic…"
+    },
     "version": "1.0.0",
     "name": "Research a topic",
     "description": "Search the web for a topic and return a cited summary.",

package/examples/score-a-scene.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.score-a-scene",
+    "action": {
+      "label": "Generate music",
+      "running": "Generating music…"
+    },
     "version": "1.0.0",
     "name": "Score a scene",
     "description": "Generate a short music bed for a scene from a written mood brief.",

package/examples/script-draft.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.script-draft",
+    "action": {
+      "label": "Write script",
+      "running": "Writing script…"
+    },
     "version": "1.0.0",
     "name": "Draft a short script",
     "description": "Turn a production brief into a short narration draft using an approved text-generation call.",

package/examples/summarize-page.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.summarize-page",
+    "action": {
+      "label": "Summarize page",
+      "running": "Summarizing page…"
+    },
     "version": "1.0.0",
     "name": "Summarize a page",
     "description": "Read a public web page and summarize it in a few production-ready bullet points.",

package/examples/text-workflow.stillmade.json

@@ -20,6 +20,10 @@
         },
         "sdkVersion": "0.1.0",
         "id": "example.clean-text",
+        "action": {
+          "label": "Clean text",
+          "running": "Cleaning text…"
+        },
         "version": "1.0.0",
         "name": "Clean text",
         "description": "Trims extra space from text and returns a clean copy for the next step.",

package/examples/thicken-lines.stillmade.json

@@ -7,6 +7,10 @@
     },
     "sdkVersion": "0.1.0",
     "id": "example.thicken-lines",
+    "action": {
+      "label": "Thicken lines",
+      "running": "Thickening lines…"
+    },
     "version": "1.0.1",
     "name": "Thicken line art",
     "description": "Expands dark outlines in an image while preserving surrounding colors, creating a new image for the next production step.",

package/examples/timeline-polish.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.timeline-polish",
+    "action": {
+      "label": "Suggest edit",
+      "running": "Suggesting edit…"
+    },
     "version": "1.0.0",
     "name": "Timeline polish",
     "description": "Turn a timeline and editing direction into a bounded proposal that remains reviewable before Apply.",

package/examples/transcribe-audio.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.transcribe-audio",
+    "action": {
+      "label": "Transcribe audio",
+      "running": "Transcribing…"
+    },
     "version": "1.0.0",
     "name": "Transcribe audio",
     "description": "Turn one persistent audio file into reviewed text with word timings.",

package/examples/word-count.stillmade.json

@@ -7,6 +7,10 @@
     },
     "sdkVersion": "0.1.0",
     "id": "example.word-count",
+    "action": {
+      "label": "Count words",
+      "running": "Counting words…"
+    },
     "version": "1.0.0",
     "name": "Word count",
     "description": "Counts words and returns trimmed text using isolated JavaScript.",

package/package.json

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