stillmade-sdk 0.1.46 → 0.1.48

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 (78) hide show
  1. package/.stillmade/sdk-baseline.json +1 -1
  2. package/AGENTS.md +6 -2
  3. package/FRAME_VIEWS.md +71 -5
  4. package/INTERFACE_DESIGN.md +105 -15
  5. package/MODULES.md +26 -3
  6. package/PASTE_TO_LLM.md +27 -10
  7. package/README.md +15 -0
  8. package/SDK.md +393 -64
  9. package/UI_AESTHETIC.md +13 -0
  10. package/blocks/native/sm.board-editor/versions/3.0.0/package.js +921 -0
  11. package/blocks/native/sm.editor/versions/3.0.0/package.js +751 -0
  12. package/blocks/native/sm.panel-strip/versions/3.0.0/package.js +350 -0
  13. package/blocks/native/sm.photo-editor/versions/1.0.0/package.js +6693 -0
  14. package/blocks/native/sm.voiceover/versions/3.0.0/package.js +513 -0
  15. package/docs/build/block-builder-contract.md +2 -2
  16. package/docs/build/custom-interface.md +23 -3
  17. package/docs/build/frame-views.md +71 -5
  18. package/docs/build/hosted-text.md +8 -3
  19. package/docs/build/interface-design.md +105 -15
  20. package/docs/build/media-analysis.md +18 -1
  21. package/docs/build/modules.md +26 -3
  22. package/docs/build/with-your-ai.md +14 -0
  23. package/docs/build/workspaces.md +42 -0
  24. package/docs/reference/authoring-guide.md +5 -4
  25. package/docs/reference/cli.md +8 -3
  26. package/docs/reference/execution.md +13 -5
  27. package/docs/reference/first-party-blocks.md +5 -4
  28. package/docs/reference/generation-models.md +4 -0
  29. package/docs/reference/limits.md +9 -2
  30. package/docs/reference/permissions.md +4 -0
  31. package/docs/reference/view-bridge.md +6 -3
  32. package/docs/reference/view-rules.md +2 -1
  33. package/docs/tools/llm.md +27 -10
  34. package/examples/custom-interface.stillmade.json +2 -2
  35. package/package.json +1 -1
  36. package/packages/block-cli/cli.js +124 -12
  37. package/packages/block-cli/dev-host/assets/host.js +63 -37
  38. package/packages/block-cli/dev-host/assets/index.css +1 -1
  39. package/packages/block-cli/dev-server.js +74 -23
  40. package/packages/block-cli/format.js +20 -1
  41. package/packages/block-cli/ready-gate.js +34 -2
  42. package/packages/block-cli/templates.js +61 -0
  43. package/packages/block-cli/type-packages.js +7 -4
  44. package/packages/block-cli/workspace-dev.js +124 -0
  45. package/packages/block-cli/workspace-pack.js +62 -0
  46. package/packages/block-cli/workspace.js +304 -0
  47. package/packages/block-platform/block-readiness.js +5 -4
  48. package/packages/block-platform/catalog.js +5 -3
  49. package/packages/block-platform/node-defaults.js +2 -2
  50. package/packages/block-platform/plain-descriptions.js +1 -0
  51. package/packages/block-platform/type-workspace.js +8 -0
  52. package/packages/block-sdk/admission.js +2 -2
  53. package/packages/block-sdk/builder-contract.js +3 -3
  54. package/packages/block-sdk/capabilities.js +32 -12
  55. package/packages/block-sdk/contracts.js +11 -2
  56. package/packages/block-sdk/examples.js +2 -2
  57. package/packages/block-sdk/first-party-identities.js +9 -0
  58. package/packages/block-sdk/first-party-packages.js +9 -1
  59. package/packages/block-sdk/folder-package.js +34 -2
  60. package/packages/block-sdk/generation-catalog.js +7 -0
  61. package/packages/block-sdk/index.d.ts +13 -5
  62. package/packages/block-sdk/index.js +1 -1
  63. package/packages/block-sdk/mock-host.js +7 -0
  64. package/packages/block-sdk/module-hosted.js +11 -1
  65. package/packages/block-sdk/module-media-access.js +5 -3
  66. package/packages/block-sdk/permission-summary.js +1 -1
  67. package/packages/block-sdk/portable-media-actions.d.ts +4 -1
  68. package/packages/block-sdk/portable-media-actions.js +16 -1
  69. package/packages/block-sdk/remix-policy.js +2 -2
  70. package/packages/block-sdk/staged-releases.js +5 -0
  71. package/packages/block-sdk/stillmade-pack.js +64 -0
  72. package/packages/block-sdk/testing.js +2 -2
  73. package/packages/block-sdk/view-bridge.js +6 -3
  74. package/packages/block-sdk/view-design.js +65 -17
  75. package/packages/block-sdk/view-renderer.js +17 -1
  76. package/packages/block-sdk/view.js +47 -9
  77. package/packages/design-system/block-kit.css +23 -0
  78. package/packages/design-system/theme.css +10 -7
package/UI_AESTHETIC.md CHANGED
@@ -265,6 +265,16 @@ before/after examples from an Image Panels project (Voiceover 1,210 px to about
265
265
  and leaving empty columns. This holds on a Block's screen (the kit's
266
266
  `sm-stage`) and on the pages StillMade draws. A Block that lays itself out
267
267
  (`data-stillmade-layout="own"`) keeps its own placement.
268
+ - Actions on the stage (November 5, 2026, owner: option 7 of
269
+ `docs/ui-review/one-page-layout-options.html`). A job's status sits top-left on
270
+ its stage and its actions top-right, as an overlay in the player's cream
271
+ blocks, over a band kept above the media; the media fills the rest. A button
272
+ that spends credits never moves (owner: "the action button can't move
273
+ spots"): making again is pressed where it made the first time, and what the
274
+ result adds (Download) sits to its left. Block screens get this from the kit
275
+ (`sm-actions` and `sm-status` inside `sm-stage`), and every Step page
276
+ StillMade draws does the same (the one-page job, a single Block's page and the
277
+ focused page; owner: "this is for everything, it should all be shared").
268
278
  - Settings sit side by side next to what they change (a grid of short
269
279
  segmented controls, not rows of big tiles). Lists fill the width at a small
270
280
  size: photos are small tiles, shots are one line each and open in place.
@@ -373,6 +383,9 @@ in React; `client/public/stillmade-media.js` on server pages; `client/src/blocks
373
383
  - Hover only. Owner: "make sure I have to hover over the video for it to appear". The controls and their shade show
374
384
  only while the pointer is over the video, paused or playing, before the first play too; they fade 2 s after the last
375
385
  move while a video plays. Keyboard focus shows them. On touch a tap shows them for 3 s and never starts playback.
386
+ The first time a video or a full-size photo comes into view its controls show for 3 s and then go (owner, November 5,
387
+ 2026: "if I'm not hovering at all, it would be on for a few seconds then go away"); a mouse entering hands them to
388
+ hover, so moving away hides them.
376
389
  - Photos get one full-screen button, the video's square in the same corner: 44 px on pictures at least 240 px wide and
377
390
  160 px tall, 32 px on smaller ones. Owner: "if I hover over it, it appears; hover out of it, it disappears". Only on
378
391
  results, listing and gallery pictures; never on icons, avatars, picker thumbnails, editor canvases or drag sources. A