stillmade-sdk 0.1.41 → 0.1.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/.stillmade/sdk-baseline.json +19 -19
  2. package/AGENTS.md +2 -2
  3. package/INTERFACE_DESIGN.md +5 -0
  4. package/PASTE_TO_LLM.md +12 -12
  5. package/SDK.md +44 -23
  6. package/UI_AESTHETIC.md +8 -1
  7. package/examples/check-clip.stillmade.json +4 -0
  8. package/examples/clean-text.stillmade.json +4 -0
  9. package/examples/custom-interface.stillmade.json +4 -0
  10. package/examples/describe-image.stillmade.json +4 -0
  11. package/examples/foley-cue.stillmade.json +4 -0
  12. package/examples/generate-image.stillmade.json +4 -0
  13. package/examples/generate-video.stillmade.json +4 -0
  14. package/examples/module-word-stats/stillmade.block.json +4 -0
  15. package/examples/narrate-script.stillmade.json +4 -0
  16. package/examples/numbered-takes.stillmade.json +4 -0
  17. package/examples/research-topic.stillmade.json +4 -0
  18. package/examples/score-a-scene.stillmade.json +4 -0
  19. package/examples/script-draft.stillmade.json +4 -0
  20. package/examples/summarize-page.stillmade.json +4 -0
  21. package/examples/text-workflow.stillmade.json +4 -0
  22. package/examples/thicken-lines.stillmade.json +4 -0
  23. package/examples/timeline-polish.stillmade.json +4 -0
  24. package/examples/transcribe-audio.stillmade.json +4 -0
  25. package/examples/word-count.stillmade.json +4 -0
  26. package/package.json +1 -1
  27. package/packages/block-cli/dev-host/assets/host.js +6 -1
  28. package/packages/block-cli/dev-host/assets/index.css +1 -1
  29. package/packages/block-cli/ready-gate.js +4 -0
  30. package/packages/block-cli/templates.js +7 -7
  31. package/packages/block-platform/block-readiness.js +3 -1
  32. package/packages/block-sdk/audio-generation-example.js +2 -2
  33. package/packages/block-sdk/builder-contract.js +3 -3
  34. package/packages/block-sdk/capability-example.js +1 -1
  35. package/packages/block-sdk/examples.js +3 -3
  36. package/packages/block-sdk/image-description-example.js +1 -1
  37. package/packages/block-sdk/image-generation-example.js +1 -1
  38. package/packages/block-sdk/media-analysis-example.js +1 -1
  39. package/packages/block-sdk/module-example.js +1 -1
  40. package/packages/block-sdk/speech-example.js +1 -1
  41. package/packages/block-sdk/state-example.js +1 -1
  42. package/packages/block-sdk/timeline-proposal-example.js +1 -1
  43. package/packages/block-sdk/transcription-example.js +1 -1
  44. package/packages/block-sdk/trigger-examples.js +2 -2
  45. package/packages/block-sdk/video-generation-example.js +1 -1
  46. package/packages/block-sdk/view-design.js +27 -1
  47. package/packages/block-sdk/web-example.js +2 -2
  48. package/packages/design-system/block-kit.css +5 -0
package/UI_AESTHETIC.md CHANGED
@@ -209,6 +209,12 @@ before/after examples from an Image Panels project (Voiceover 1,210 px to about
209
209
 
210
210
  - Label and control on one row. No label stacked above a short control, no card
211
211
  around a single control, no help line under every field.
212
+ - Sections stand apart (November 3, 2026, owner: "make sure it's more
213
+ separated"). What goes in (the files), the settings and the result are separate
214
+ parts: the settings sit together on one card, the same surface as the files
215
+ card, with a hairline between rows. StillMade's Step page does this for every
216
+ Block; a Block's own screen gets it from the kit's `sm-fields` / `sm-settings`
217
+ group. Never a card inside a card.
212
218
  - Status is a dot or a few words ("No narration yet"), never a paragraph; the
213
219
  reason sits behind an info toggle.
214
220
  - Files are tiles: a saved file is a thumbnail or chip, adding one is a + tile.
@@ -320,7 +326,8 @@ asks for something else, that wins. Mockups: `docs/ui-review/job-words-journeys.
320
326
  only a paragraph that has to be split across fields goes to a quick, cheap model,
321
327
  free to the person.
322
328
  - Days and times are picked from a calendar and a list of times, never typed.
323
- - History is one icon in the project bar. A Step has no row of tool icons of its own.
329
+ - History is one icon in the Project map's header, shown on every saved project whether or not anything is recorded
330
+ yet (November 3, 2026). A Step has no row of tool icons of its own.
324
331
  - Chat can do everything these screens do: pick a reference, fill fields, pick a
325
332
  time, post, and bring back an earlier version.
326
333
 
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.check-clip",
6
+ "action": {
7
+ "label": "Check clip",
8
+ "running": "Checking clip…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Check a clip",
8
12
  "description": "Answer a production question about a saved video clip, with timestamps.",
@@ -7,6 +7,10 @@
7
7
  },
8
8
  "sdkVersion": "0.1.0",
9
9
  "id": "example.clean-text",
10
+ "action": {
11
+ "label": "Clean text",
12
+ "running": "Cleaning text…"
13
+ },
10
14
  "version": "1.0.0",
11
15
  "name": "Clean text",
12
16
  "description": "Trims extra space from text and returns a clean copy for the next step.",
@@ -7,6 +7,10 @@
7
7
  },
8
8
  "sdkVersion": "0.1.0",
9
9
  "id": "example.clean-text-interface",
10
+ "action": {
11
+ "label": "Clean text",
12
+ "running": "Cleaning text…"
13
+ },
10
14
  "version": "1.1.0",
11
15
  "name": "Clean text studio",
12
16
  "description": "Edit text, run the cleanup, and compare the result in a responsive self-contained workspace.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.describe-image",
6
+ "action": {
7
+ "label": "Describe image",
8
+ "running": "Describing image…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Describe an image",
8
12
  "description": "Turn one owned image into concise production-ready visual notes.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.foley-cue",
6
+ "action": {
7
+ "label": "Generate sound",
8
+ "running": "Generating sound…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Foley cue",
8
12
  "description": "Generate a short sound effect from a written description.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.generate-image",
6
+ "action": {
7
+ "label": "Generate image",
8
+ "running": "Generating image…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Generate an image",
8
12
  "description": "Generate a square PNG from a short visual prompt using an approved host request.",
@@ -2,6 +2,10 @@
2
2
  "manifest": {
3
3
  "schemaVersion": 1,
4
4
  "id": "example.generate-video",
5
+ "action": {
6
+ "label": "Generate video",
7
+ "running": "Generating video…"
8
+ },
5
9
  "name": "Generate video",
6
10
  "version": "1.0.0",
7
11
  "sdkVersion": "0.1.0",
@@ -2,6 +2,10 @@
2
2
  "schemaVersion": 1,
3
3
  "sdkVersion": "0.1.0",
4
4
  "id": "example.word-stats",
5
+ "action": {
6
+ "label": "Count words",
7
+ "running": "Counting words…"
8
+ },
5
9
  "version": "1.0.0",
6
10
  "name": "Word stats",
7
11
  "description": "Counts words and finds the longest one, as a modern JavaScript module.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.narrate-script",
6
+ "action": {
7
+ "label": "Generate voiceover",
8
+ "running": "Generating voiceover…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Narrate a script",
8
12
  "description": "Turn a short script into a reviewed speech recording using a host-selected voice.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.numbered-takes",
6
+ "action": {
7
+ "label": "Number takes",
8
+ "running": "Numbering takes…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Numbered takes",
8
12
  "description": "Label successive creative takes with an independent counter for each production placement.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.research-topic",
6
+ "action": {
7
+ "label": "Research topic",
8
+ "running": "Researching topic…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Research a topic",
8
12
  "description": "Search the web for a topic and return a cited summary.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.score-a-scene",
6
+ "action": {
7
+ "label": "Generate music",
8
+ "running": "Generating music…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Score a scene",
8
12
  "description": "Generate a short music bed for a scene from a written mood brief.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.script-draft",
6
+ "action": {
7
+ "label": "Write script",
8
+ "running": "Writing script…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Draft a short script",
8
12
  "description": "Turn a production brief into a short narration draft using an approved text-generation call.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.summarize-page",
6
+ "action": {
7
+ "label": "Summarize page",
8
+ "running": "Summarizing page…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Summarize a page",
8
12
  "description": "Read a public web page and summarize it in a few production-ready bullet points.",
@@ -20,6 +20,10 @@
20
20
  },
21
21
  "sdkVersion": "0.1.0",
22
22
  "id": "example.clean-text",
23
+ "action": {
24
+ "label": "Clean text",
25
+ "running": "Cleaning text…"
26
+ },
23
27
  "version": "1.0.0",
24
28
  "name": "Clean text",
25
29
  "description": "Trims extra space from text and returns a clean copy for the next step.",
@@ -7,6 +7,10 @@
7
7
  },
8
8
  "sdkVersion": "0.1.0",
9
9
  "id": "example.thicken-lines",
10
+ "action": {
11
+ "label": "Thicken lines",
12
+ "running": "Thickening lines…"
13
+ },
10
14
  "version": "1.0.1",
11
15
  "name": "Thicken line art",
12
16
  "description": "Expands dark outlines in an image while preserving surrounding colors, creating a new image for the next production step.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.timeline-polish",
6
+ "action": {
7
+ "label": "Suggest edit",
8
+ "running": "Suggesting edit…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Timeline polish",
8
12
  "description": "Turn a timeline and editing direction into a bounded proposal that remains reviewable before Apply.",
@@ -3,6 +3,10 @@
3
3
  "schemaVersion": 1,
4
4
  "sdkVersion": "0.1.0",
5
5
  "id": "example.transcribe-audio",
6
+ "action": {
7
+ "label": "Transcribe audio",
8
+ "running": "Transcribing…"
9
+ },
6
10
  "version": "1.0.0",
7
11
  "name": "Transcribe audio",
8
12
  "description": "Turn one persistent audio file into reviewed text with word timings.",
@@ -7,6 +7,10 @@
7
7
  },
8
8
  "sdkVersion": "0.1.0",
9
9
  "id": "example.word-count",
10
+ "action": {
11
+ "label": "Count words",
12
+ "running": "Counting words…"
13
+ },
10
14
  "version": "1.0.0",
11
15
  "name": "Word count",
12
16
  "description": "Counts words and returns trimmed text using isolated JavaScript.",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "stillmade-sdk",
3
- "version": "0.1.41",
3
+ "version": "0.1.42",
4
4
  "description": "StillMade Block SDK, CLI and examples",
5
5
  "license": "PolyForm-Shield-1.0.0",
6
6
  "type": "module",