@allyhub/sdk 0.8.0 → 0.10.0

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 (497) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/NOTICE +46 -49
  3. package/dist/dom.d.ts +1 -209
  4. package/dist/dom.js +1 -1
  5. package/dist/image.d.ts +2 -0
  6. package/dist/image.js +2 -0
  7. package/dist/index.d.ts +1 -21
  8. package/dist/index.js +1 -1
  9. package/dist/media.d.ts +1 -5
  10. package/dist/media.js +1 -1
  11. package/dist/node_modules/@allyhub/audio/dist/levels.d.ts +4 -5
  12. package/dist/node_modules/@allyhub/audio/dist/levels.js +1 -1
  13. package/dist/node_modules/@allyhub/audio/dist/node/ffmpeg.d.ts +1 -6
  14. package/dist/node_modules/@allyhub/audio/dist/node/ffmpeg.js +1 -1
  15. package/dist/node_modules/@allyhub/audio/package.json +1 -1
  16. package/dist/node_modules/@allyhub/chart/dist/chart-file.js +1 -1
  17. package/dist/node_modules/@allyhub/chart/dist/chart-xml.d.ts +4 -1
  18. package/dist/node_modules/@allyhub/chart/dist/chart-xml.js +2 -2
  19. package/dist/node_modules/@allyhub/chart/dist/chart.d.ts +22 -0
  20. package/dist/node_modules/@allyhub/chart/dist/chart.js +1 -1
  21. package/dist/node_modules/@allyhub/chart/package.json +1 -1
  22. package/dist/node_modules/@allyhub/diagnostics/LICENSE +241 -0
  23. package/dist/node_modules/@allyhub/diagnostics/dist/fact.d.ts +37 -0
  24. package/dist/node_modules/@allyhub/diagnostics/dist/fact.js +2 -0
  25. package/dist/node_modules/@allyhub/diagnostics/dist/index.d.ts +4 -0
  26. package/dist/node_modules/@allyhub/diagnostics/dist/index.js +2 -0
  27. package/dist/node_modules/@allyhub/diagnostics/dist/problem.d.ts +43 -0
  28. package/dist/node_modules/@allyhub/diagnostics/dist/problem.js +2 -0
  29. package/dist/node_modules/@allyhub/diagnostics/dist/rules.d.ts +30 -0
  30. package/dist/node_modules/@allyhub/diagnostics/dist/rules.js +2 -0
  31. package/dist/node_modules/@allyhub/diagnostics/package.json +14 -0
  32. package/dist/node_modules/@allyhub/formats/dist/contributed.d.ts +126 -0
  33. package/dist/node_modules/@allyhub/formats/dist/contributed.js +2 -0
  34. package/dist/node_modules/@allyhub/formats/dist/data/faces.d.ts +1 -1
  35. package/dist/node_modules/@allyhub/formats/dist/data/reference.d.ts +7 -12
  36. package/dist/node_modules/@allyhub/formats/dist/data/reference.js +1 -1
  37. package/dist/node_modules/@allyhub/formats/dist/data/script.d.ts +9 -4
  38. package/dist/node_modules/@allyhub/formats/dist/data/script.js +1 -1
  39. package/dist/node_modules/@allyhub/formats/dist/data/sheet.d.ts +107 -83
  40. package/dist/node_modules/@allyhub/formats/dist/data/sheet.js +1 -1
  41. package/dist/node_modules/@allyhub/formats/dist/data/slides.d.ts +185 -8
  42. package/dist/node_modules/@allyhub/formats/dist/data/slides.js +1 -1
  43. package/dist/node_modules/@allyhub/formats/dist/data/website.d.ts +2 -1
  44. package/dist/node_modules/@allyhub/formats/dist/data/website.js +1 -1
  45. package/dist/node_modules/@allyhub/formats/dist/data/work.d.ts +42 -0
  46. package/dist/node_modules/@allyhub/formats/dist/data/work.js +2 -0
  47. package/dist/node_modules/@allyhub/formats/dist/extension.d.ts +91 -0
  48. package/dist/node_modules/@allyhub/formats/dist/extension.js +2 -0
  49. package/dist/node_modules/@allyhub/formats/dist/files.d.ts +51 -0
  50. package/dist/node_modules/@allyhub/formats/dist/files.js +2 -0
  51. package/dist/node_modules/@allyhub/formats/dist/index.d.ts +5 -1
  52. package/dist/node_modules/@allyhub/formats/dist/index.js +1 -1
  53. package/dist/node_modules/@allyhub/formats/dist/items.d.ts +226 -90
  54. package/dist/node_modules/@allyhub/formats/dist/items.js +1 -1
  55. package/dist/node_modules/@allyhub/formats/dist/layout.d.ts +7 -1
  56. package/dist/node_modules/@allyhub/formats/dist/layout.js +1 -1
  57. package/dist/node_modules/@allyhub/formats/dist/schemas.d.ts +96 -42
  58. package/dist/node_modules/@allyhub/formats/dist/schemas.js +1 -1
  59. package/dist/node_modules/@allyhub/formats/package.json +1 -1
  60. package/dist/node_modules/@allyhub/image-draw/LICENSE +241 -0
  61. package/dist/node_modules/@allyhub/image-draw/dist/context.d.ts +5 -0
  62. package/dist/node_modules/@allyhub/image-draw/dist/context.js +2 -0
  63. package/dist/node_modules/@allyhub/image-draw/dist/contrast.d.ts +13 -0
  64. package/dist/node_modules/@allyhub/image-draw/dist/contrast.js +2 -0
  65. package/dist/node_modules/@allyhub/image-draw/dist/env.d.ts +112 -0
  66. package/dist/node_modules/@allyhub/image-draw/dist/env.js +2 -0
  67. package/dist/node_modules/@allyhub/image-draw/dist/errors.d.ts +20 -0
  68. package/dist/node_modules/@allyhub/image-draw/dist/errors.js +2 -0
  69. package/dist/node_modules/@allyhub/image-draw/dist/fonts.d.ts +110 -0
  70. package/dist/node_modules/@allyhub/image-draw/dist/fonts.js +2 -0
  71. package/dist/node_modules/@allyhub/image-draw/dist/guards.d.ts +32 -0
  72. package/dist/node_modules/@allyhub/image-draw/dist/guards.js +2 -0
  73. package/dist/node_modules/@allyhub/image-draw/dist/hash.d.ts +3 -0
  74. package/dist/node_modules/@allyhub/image-draw/dist/hash.js +2 -0
  75. package/dist/node_modules/@allyhub/image-draw/dist/inspect.d.ts +113 -0
  76. package/dist/node_modules/@allyhub/image-draw/dist/inspect.js +3 -0
  77. package/dist/node_modules/@allyhub/image-draw/dist/layer-style.d.ts +151 -0
  78. package/dist/node_modules/@allyhub/image-draw/dist/layer-style.js +2 -0
  79. package/dist/node_modules/@allyhub/image-draw/dist/paint.d.ts +29 -0
  80. package/dist/node_modules/@allyhub/image-draw/dist/paint.js +2 -0
  81. package/dist/node_modules/@allyhub/image-draw/dist/pictures.d.ts +39 -0
  82. package/dist/node_modules/@allyhub/image-draw/dist/pictures.js +2 -0
  83. package/dist/node_modules/@allyhub/image-draw/dist/plan.d.ts +52 -0
  84. package/dist/node_modules/@allyhub/image-draw/dist/plan.js +2 -0
  85. package/dist/node_modules/@allyhub/image-draw/dist/reads.d.ts +145 -0
  86. package/dist/node_modules/@allyhub/image-draw/dist/reads.js +2 -0
  87. package/dist/node_modules/@allyhub/image-draw/dist/shape-path.d.ts +26 -0
  88. package/dist/node_modules/@allyhub/image-draw/dist/shape-path.js +2 -0
  89. package/dist/node_modules/@allyhub/image-draw/dist/stage.d.ts +56 -0
  90. package/dist/node_modules/@allyhub/image-draw/dist/stage.js +2 -0
  91. package/dist/node_modules/@allyhub/image-draw/dist/styles.d.ts +35 -0
  92. package/dist/node_modules/@allyhub/image-draw/dist/styles.js +2 -0
  93. package/dist/node_modules/@allyhub/image-draw/dist/tone.d.ts +53 -0
  94. package/dist/node_modules/@allyhub/image-draw/dist/tone.js +2 -0
  95. package/dist/node_modules/@allyhub/image-draw/package.json +14 -0
  96. package/dist/node_modules/@allyhub/image-measure/LICENSE +241 -0
  97. package/dist/node_modules/@allyhub/image-measure/dist/contrast.d.ts +43 -0
  98. package/dist/node_modules/@allyhub/image-measure/dist/contrast.js +2 -0
  99. package/dist/node_modules/@allyhub/image-measure/dist/layout.d.ts +186 -0
  100. package/dist/node_modules/@allyhub/image-measure/dist/layout.js +5 -0
  101. package/dist/node_modules/@allyhub/image-measure/package.json +14 -0
  102. package/dist/node_modules/@allyhub/image-sdk/LICENSE +241 -0
  103. package/dist/node_modules/@allyhub/image-sdk/dist/adjustment.d.ts +13 -0
  104. package/dist/node_modules/@allyhub/image-sdk/dist/adjustment.js +2 -0
  105. package/dist/{define.d.ts → node_modules/@allyhub/image-sdk/dist/define.d.ts} +21 -4
  106. package/dist/node_modules/@allyhub/image-sdk/dist/define.js +2 -0
  107. package/dist/node_modules/@allyhub/image-sdk/dist/dom.d.ts +210 -0
  108. package/dist/node_modules/@allyhub/image-sdk/dist/dom.js +2 -0
  109. package/dist/node_modules/@allyhub/image-sdk/dist/fill.d.ts +21 -0
  110. package/dist/node_modules/@allyhub/image-sdk/dist/fill.js +2 -0
  111. package/dist/node_modules/@allyhub/image-sdk/dist/group.d.ts +17 -0
  112. package/dist/node_modules/@allyhub/image-sdk/dist/group.js +2 -0
  113. package/dist/node_modules/@allyhub/image-sdk/dist/index.d.ts +166 -0
  114. package/dist/node_modules/@allyhub/image-sdk/dist/index.js +2 -0
  115. package/dist/node_modules/@allyhub/image-sdk/dist/media.d.ts +6 -0
  116. package/dist/node_modules/@allyhub/image-sdk/dist/media.js +2 -0
  117. package/dist/{messages.d.ts → node_modules/@allyhub/image-sdk/dist/messages.d.ts} +1 -1
  118. package/dist/node_modules/@allyhub/image-sdk/dist/picture.d.ts +59 -0
  119. package/dist/node_modules/@allyhub/image-sdk/dist/picture.js +2 -0
  120. package/dist/{props.d.ts → node_modules/@allyhub/image-sdk/dist/props.d.ts} +4 -4
  121. package/dist/node_modules/@allyhub/image-sdk/dist/shape.d.ts +34 -0
  122. package/dist/node_modules/@allyhub/image-sdk/dist/shape.js +2 -0
  123. package/dist/node_modules/@allyhub/image-sdk/dist/stack.d.ts +16 -0
  124. package/dist/node_modules/@allyhub/image-sdk/dist/stack.js +2 -0
  125. package/dist/node_modules/@allyhub/image-sdk/dist/text-layer.d.ts +38 -0
  126. package/dist/node_modules/@allyhub/image-sdk/dist/text-layer.js +2 -0
  127. package/dist/{written.js → node_modules/@allyhub/image-sdk/dist/written.js} +1 -1
  128. package/dist/node_modules/@allyhub/image-sdk/package.json +19 -0
  129. package/dist/node_modules/@allyhub/measure/LICENSE +241 -0
  130. package/dist/node_modules/@allyhub/measure/dist/compare.d.ts +195 -0
  131. package/dist/node_modules/@allyhub/measure/dist/compare.js +2 -0
  132. package/dist/node_modules/@allyhub/measure/dist/grain.d.ts +8 -0
  133. package/dist/node_modules/@allyhub/measure/dist/grain.js +2 -0
  134. package/dist/node_modules/@allyhub/measure/dist/image.d.ts +16 -0
  135. package/dist/node_modules/@allyhub/measure/dist/image.js +2 -0
  136. package/dist/node_modules/@allyhub/measure/dist/index.d.ts +4 -0
  137. package/dist/node_modules/@allyhub/measure/dist/index.js +2 -0
  138. package/dist/node_modules/@allyhub/measure/package.json +13 -0
  139. package/dist/node_modules/@allyhub/ooxml/dist/generated/presets.d.ts +4 -1
  140. package/dist/node_modules/@allyhub/ooxml/dist/generated/presets.js +1 -1
  141. package/dist/node_modules/@allyhub/ooxml/dist/geometry/index.d.ts +15 -1
  142. package/dist/node_modules/@allyhub/ooxml/dist/geometry/index.js +1 -1
  143. package/dist/node_modules/@allyhub/ooxml/package.json +1 -1
  144. package/dist/node_modules/@allyhub/piece/LICENSE +241 -0
  145. package/dist/node_modules/@allyhub/{video-core → piece}/dist/anchors.d.ts +1 -9
  146. package/dist/node_modules/@allyhub/{video-core → piece}/dist/component.js +1 -1
  147. package/dist/node_modules/@allyhub/piece/dist/context.d.ts +39 -0
  148. package/dist/node_modules/@allyhub/piece/dist/context.js +2 -0
  149. package/dist/node_modules/@allyhub/{video-core → piece}/dist/contrast.d.ts +2 -2
  150. package/dist/node_modules/@allyhub/{video-core → piece}/dist/export.d.ts +27 -10
  151. package/dist/node_modules/@allyhub/piece/dist/export.js +2 -0
  152. package/dist/node_modules/@allyhub/{video-core → piece}/dist/formats.d.ts +12 -68
  153. package/dist/node_modules/@allyhub/piece/dist/formats.js +2 -0
  154. package/dist/node_modules/@allyhub/piece/dist/gen.d.ts +104 -0
  155. package/dist/node_modules/@allyhub/piece/dist/index.d.ts +26 -0
  156. package/dist/node_modules/@allyhub/piece/dist/index.js +2 -0
  157. package/dist/node_modules/@allyhub/piece/dist/layer-style.d.ts +1558 -0
  158. package/dist/node_modules/@allyhub/piece/dist/layer-style.js +2 -0
  159. package/dist/node_modules/@allyhub/piece/dist/layer.d.ts +389 -0
  160. package/dist/node_modules/@allyhub/piece/dist/layer.js +2 -0
  161. package/dist/node_modules/@allyhub/piece/dist/layout.d.ts +437 -0
  162. package/dist/node_modules/@allyhub/piece/dist/layout.js +2 -0
  163. package/dist/node_modules/@allyhub/{video-core → piece}/dist/look.d.ts +1 -1
  164. package/dist/node_modules/@allyhub/{video-core → piece}/dist/media.d.ts +39 -9
  165. package/dist/node_modules/@allyhub/{video-core → piece}/dist/media.js +1 -1
  166. package/dist/node_modules/@allyhub/{video-core → piece}/dist/messages.d.ts +6 -0
  167. package/dist/node_modules/@allyhub/piece/dist/names.d.ts +26 -0
  168. package/dist/node_modules/@allyhub/piece/dist/names.js +2 -0
  169. package/dist/node_modules/@allyhub/piece/dist/page/console.d.ts +21 -0
  170. package/dist/node_modules/@allyhub/piece/dist/page/console.js +2 -0
  171. package/dist/node_modules/@allyhub/piece/dist/page/index.d.ts +3 -0
  172. package/dist/node_modules/@allyhub/piece/dist/page/index.js +2 -0
  173. package/dist/node_modules/@allyhub/piece/dist/page/locate.d.ts +4 -0
  174. package/dist/node_modules/@allyhub/piece/dist/page/locate.js +2 -0
  175. package/dist/node_modules/@allyhub/piece/dist/picture.d.ts +62 -0
  176. package/dist/node_modules/@allyhub/piece/dist/picture.js +2 -0
  177. package/dist/node_modules/@allyhub/piece/dist/piece.d.ts +15 -0
  178. package/dist/node_modules/@allyhub/piece/dist/piece.js +2 -0
  179. package/dist/node_modules/@allyhub/{video-core → piece}/dist/script.d.ts +9 -4
  180. package/dist/node_modules/@allyhub/piece/dist/script.js +2 -0
  181. package/dist/node_modules/@allyhub/piece/dist/source.d.ts +131 -0
  182. package/dist/node_modules/@allyhub/piece/dist/stage.d.ts +291 -0
  183. package/dist/node_modules/@allyhub/piece/dist/stage.js +2 -0
  184. package/dist/node_modules/@allyhub/piece/dist/version.d.ts +15 -0
  185. package/dist/node_modules/@allyhub/piece/dist/version.js +2 -0
  186. package/dist/node_modules/@allyhub/{video-core → piece}/dist/voice.d.ts +1 -20
  187. package/dist/node_modules/@allyhub/piece/package.json +18 -0
  188. package/dist/node_modules/@allyhub/protocol/dist/account.d.ts +271 -0
  189. package/dist/node_modules/@allyhub/protocol/dist/account.js +1 -1
  190. package/dist/node_modules/@allyhub/protocol/dist/app.d.ts +3 -10
  191. package/dist/node_modules/@allyhub/protocol/dist/app.js +1 -1
  192. package/dist/node_modules/@allyhub/protocol/dist/auth.d.ts +19 -1
  193. package/dist/node_modules/@allyhub/protocol/dist/auth.js +1 -1
  194. package/dist/node_modules/@allyhub/protocol/dist/browser-bridge.d.ts +337 -0
  195. package/dist/node_modules/@allyhub/protocol/dist/browser-bridge.js +2 -0
  196. package/dist/node_modules/@allyhub/protocol/dist/cli.d.ts +12 -1
  197. package/dist/node_modules/@allyhub/protocol/dist/cli.js +1 -1
  198. package/dist/node_modules/@allyhub/protocol/dist/cloud.d.ts +155 -0
  199. package/dist/node_modules/@allyhub/protocol/dist/cloud.js +1 -1
  200. package/dist/node_modules/@allyhub/protocol/dist/editor.d.ts +235 -133
  201. package/dist/node_modules/@allyhub/protocol/dist/editor.js +1 -1
  202. package/dist/node_modules/@allyhub/protocol/dist/files.d.ts +2 -0
  203. package/dist/node_modules/@allyhub/protocol/dist/files.js +1 -1
  204. package/dist/node_modules/@allyhub/protocol/dist/frame.d.ts +65 -197
  205. package/dist/node_modules/@allyhub/protocol/dist/frame.js +1 -1
  206. package/dist/node_modules/@allyhub/protocol/dist/image.d.ts +8 -0
  207. package/dist/node_modules/@allyhub/protocol/dist/image.js +2 -0
  208. package/dist/node_modules/@allyhub/protocol/dist/index.d.ts +6 -0
  209. package/dist/node_modules/@allyhub/protocol/dist/index.js +1 -1
  210. package/dist/node_modules/@allyhub/protocol/dist/jobs.d.ts +6 -6
  211. package/dist/node_modules/@allyhub/protocol/dist/kinds.d.ts +98 -0
  212. package/dist/node_modules/@allyhub/protocol/dist/kinds.js +2 -0
  213. package/dist/node_modules/@allyhub/protocol/dist/mail.d.ts +274 -0
  214. package/dist/node_modules/@allyhub/protocol/dist/mail.js +2 -0
  215. package/dist/node_modules/@allyhub/protocol/dist/notes.d.ts +77 -91
  216. package/dist/node_modules/@allyhub/protocol/dist/notes.js +1 -1
  217. package/dist/node_modules/@allyhub/protocol/dist/peer.d.ts +59 -0
  218. package/dist/node_modules/@allyhub/protocol/dist/peer.js +2 -0
  219. package/dist/node_modules/@allyhub/protocol/dist/place.d.ts +21 -0
  220. package/dist/node_modules/@allyhub/protocol/dist/place.js +2 -0
  221. package/dist/node_modules/@allyhub/protocol/dist/presence.d.ts +125 -0
  222. package/dist/node_modules/@allyhub/protocol/dist/presence.js +2 -0
  223. package/dist/node_modules/@allyhub/protocol/dist/registry.d.ts +1 -1
  224. package/dist/node_modules/@allyhub/protocol/dist/routes.js +1 -1
  225. package/dist/node_modules/@allyhub/protocol/dist/shape.d.ts +35 -0
  226. package/dist/node_modules/@allyhub/protocol/dist/shape.js +2 -0
  227. package/dist/node_modules/@allyhub/protocol/dist/shares.d.ts +2 -8
  228. package/dist/node_modules/@allyhub/protocol/dist/shares.js +1 -1
  229. package/dist/node_modules/@allyhub/protocol/dist/snapshots.d.ts +70 -40
  230. package/dist/node_modules/@allyhub/protocol/dist/snapshots.js +1 -1
  231. package/dist/node_modules/@allyhub/protocol/dist/tools.d.ts +224 -177
  232. package/dist/node_modules/@allyhub/protocol/dist/tools.js +1 -1
  233. package/dist/node_modules/@allyhub/protocol/package.json +5 -1
  234. package/dist/node_modules/@allyhub/runtimes/dist/bundled.js +1 -1
  235. package/dist/node_modules/@allyhub/runtimes/dist/declared.d.ts +14 -0
  236. package/dist/node_modules/@allyhub/runtimes/dist/declared.js +2 -0
  237. package/dist/node_modules/@allyhub/runtimes/dist/ffmpeg.d.ts +15 -0
  238. package/dist/node_modules/@allyhub/runtimes/dist/ffmpeg.js +2 -0
  239. package/dist/node_modules/@allyhub/runtimes/dist/index.d.ts +2 -0
  240. package/dist/node_modules/@allyhub/runtimes/dist/index.js +1 -1
  241. package/dist/node_modules/@allyhub/runtimes/dist/packages.js +3 -3
  242. package/dist/node_modules/@allyhub/runtimes/dist/runtimes.d.ts +1 -0
  243. package/dist/node_modules/@allyhub/runtimes/dist/runtimes.js +1 -1
  244. package/dist/node_modules/@allyhub/runtimes/manifest.json +0 -82
  245. package/dist/node_modules/@allyhub/runtimes/package.json +1 -1
  246. package/dist/node_modules/@allyhub/scenery/dist/define.d.ts +2 -0
  247. package/dist/node_modules/@allyhub/scenery/dist/define.js +1 -1
  248. package/dist/node_modules/@allyhub/scenery/dist/index.d.ts +2 -2
  249. package/dist/node_modules/@allyhub/scenery/dist/index.js +1 -1
  250. package/dist/node_modules/@allyhub/scenery/dist/moire.d.ts +45 -5
  251. package/dist/node_modules/@allyhub/scenery/dist/moire.js +2 -2
  252. package/dist/node_modules/@allyhub/scenery/dist/phone.d.ts +4 -3
  253. package/dist/node_modules/@allyhub/scenery/dist/phone.js +1 -1
  254. package/dist/node_modules/@allyhub/scenery/package.json +1 -1
  255. package/dist/node_modules/@allyhub/sheet/dist/api/capabilities.js +1 -1
  256. package/dist/node_modules/@allyhub/sheet/dist/api/code.d.ts +4 -4
  257. package/dist/node_modules/@allyhub/sheet/dist/api/code.js +1 -1
  258. package/dist/node_modules/@allyhub/sheet/dist/api/workbook.d.ts +15 -11
  259. package/dist/node_modules/@allyhub/sheet/dist/api/workbook.js +1 -1
  260. package/dist/node_modules/@allyhub/sheet/dist/calc/coerce.js +1 -1
  261. package/dist/node_modules/@allyhub/sheet/dist/calc/engine.d.ts +70 -0
  262. package/dist/node_modules/@allyhub/sheet/dist/calc/engine.js +1 -1
  263. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/criteria.d.ts +6 -0
  264. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/criteria.js +1 -1
  265. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/date.js +1 -1
  266. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/define.d.ts +3 -1
  267. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/define.js +1 -1
  268. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/info.js +1 -1
  269. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/kernels.js +1 -1
  270. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/lookup.js +1 -1
  271. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/maths.js +1 -1
  272. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/text.js +1 -1
  273. package/dist/node_modules/@allyhub/sheet/dist/calc/indexes.d.ts +9 -0
  274. package/dist/node_modules/@allyhub/sheet/dist/calc/indexes.js +1 -1
  275. package/dist/node_modules/@allyhub/sheet/dist/calc/server.d.ts +1 -1
  276. package/dist/node_modules/@allyhub/sheet/dist/calc/types.d.ts +6 -0
  277. package/dist/node_modules/@allyhub/sheet/dist/calc/types.js +1 -1
  278. package/dist/node_modules/@allyhub/sheet/dist/chart.d.ts +9 -0
  279. package/dist/node_modules/@allyhub/sheet/dist/chart.js +1 -1
  280. package/dist/node_modules/@allyhub/sheet/dist/export.js +1 -1
  281. package/dist/node_modules/@allyhub/sheet/dist/file.d.ts +5 -0
  282. package/dist/node_modules/@allyhub/sheet/dist/file.js +1 -1
  283. package/dist/node_modules/@allyhub/sheet/dist/formula/ast.d.ts +12 -1
  284. package/dist/node_modules/@allyhub/sheet/dist/formula/move.d.ts +5 -1
  285. package/dist/node_modules/@allyhub/sheet/dist/formula/move.js +1 -1
  286. package/dist/node_modules/@allyhub/sheet/dist/formula/parse.js +1 -1
  287. package/dist/node_modules/@allyhub/sheet/dist/formula/print.js +1 -1
  288. package/dist/node_modules/@allyhub/sheet/dist/generated.d.ts +5 -19
  289. package/dist/node_modules/@allyhub/sheet/dist/generated.js +1 -1
  290. package/dist/node_modules/@allyhub/sheet/dist/import.d.ts +3 -1
  291. package/dist/node_modules/@allyhub/sheet/dist/import.js +1 -1
  292. package/dist/node_modules/@allyhub/sheet/dist/index.d.ts +5 -5
  293. package/dist/node_modules/@allyhub/sheet/dist/index.js +1 -1
  294. package/dist/node_modules/@allyhub/sheet/dist/inspect.d.ts +88 -3
  295. package/dist/node_modules/@allyhub/sheet/dist/inspect.js +1 -1
  296. package/dist/node_modules/@allyhub/sheet/dist/patch.d.ts +1 -1
  297. package/dist/node_modules/@allyhub/sheet/dist/patch.js +1 -1
  298. package/dist/node_modules/@allyhub/sheet/dist/printed.d.ts +19 -0
  299. package/dist/node_modules/@allyhub/sheet/dist/printed.js +2 -0
  300. package/dist/node_modules/@allyhub/sheet/dist/sdk.d.ts +2 -0
  301. package/dist/node_modules/@allyhub/sheet/dist/sdk.js +2 -0
  302. package/dist/node_modules/@allyhub/sheet/dist/values.d.ts +2 -0
  303. package/dist/node_modules/@allyhub/sheet/dist/values.js +1 -1
  304. package/dist/node_modules/@allyhub/sheet/dist/workbook.d.ts +8 -6
  305. package/dist/node_modules/@allyhub/sheet/dist/workbook.js +1 -1
  306. package/dist/node_modules/@allyhub/sheet/dist/write.js +15 -15
  307. package/dist/node_modules/@allyhub/sheet/dist/xlsx/charts.d.ts +6 -2
  308. package/dist/node_modules/@allyhub/sheet/dist/xlsx/charts.js +1 -1
  309. package/dist/node_modules/@allyhub/sheet/dist/xlsx/formula.js +2 -2
  310. package/dist/node_modules/@allyhub/sheet/dist/xlsx/import.d.ts +2 -1
  311. package/dist/node_modules/@allyhub/sheet/dist/xlsx/import.js +1 -1
  312. package/dist/node_modules/@allyhub/sheet/dist/xlsx/read.d.ts +3 -1
  313. package/dist/node_modules/@allyhub/sheet/dist/xlsx/read.js +2 -2
  314. package/dist/node_modules/@allyhub/sheet/dist/xlsx/sax.d.ts +7 -1
  315. package/dist/node_modules/@allyhub/sheet/dist/xlsx/sax.js +3 -1
  316. package/dist/node_modules/@allyhub/sheet/dist/xlsx/styles.d.ts +6 -0
  317. package/dist/node_modules/@allyhub/sheet/dist/xlsx/styles.js +1 -1
  318. package/dist/node_modules/@allyhub/sheet/dist/xlsx/write.d.ts +1 -1
  319. package/dist/node_modules/@allyhub/sheet/dist/xlsx/write.js +1 -1
  320. package/dist/node_modules/@allyhub/sheet/dist/xlsx/xml.d.ts +12 -1
  321. package/dist/node_modules/@allyhub/sheet/dist/xlsx/xml.js +3 -2
  322. package/dist/node_modules/@allyhub/sheet/package.json +5 -1
  323. package/dist/node_modules/@allyhub/slides-core/dist/animation.d.ts +23 -7
  324. package/dist/node_modules/@allyhub/slides-core/dist/animation.js +1 -1
  325. package/dist/node_modules/@allyhub/slides-core/dist/api.d.ts +101 -11
  326. package/dist/node_modules/@allyhub/slides-core/dist/api.js +2 -2
  327. package/dist/node_modules/@allyhub/slides-core/dist/capabilities.js +1 -1
  328. package/dist/node_modules/@allyhub/slides-core/dist/chart-api.d.ts +18 -1
  329. package/dist/node_modules/@allyhub/slides-core/dist/chart-api.js +1 -1
  330. package/dist/node_modules/@allyhub/slides-core/dist/code.d.ts +1 -1
  331. package/dist/node_modules/@allyhub/slides-core/dist/connect.d.ts +62 -0
  332. package/dist/node_modules/@allyhub/slides-core/dist/connect.js +2 -0
  333. package/dist/node_modules/@allyhub/slides-core/dist/enums.d.ts +24 -0
  334. package/dist/node_modules/@allyhub/slides-core/dist/enums.js +1 -1
  335. package/dist/node_modules/@allyhub/slides-core/dist/fact.d.ts +223 -0
  336. package/dist/node_modules/@allyhub/slides-core/dist/fact.js +2 -0
  337. package/dist/node_modules/@allyhub/slides-core/dist/file.d.ts +4 -4
  338. package/dist/node_modules/@allyhub/slides-core/dist/file.js +2 -2
  339. package/dist/node_modules/@allyhub/slides-core/dist/index.d.ts +2 -0
  340. package/dist/node_modules/@allyhub/slides-core/dist/index.js +1 -1
  341. package/dist/node_modules/@allyhub/slides-core/dist/measure.d.ts +4 -2
  342. package/dist/node_modules/@allyhub/slides-core/dist/measure.js +1 -1
  343. package/dist/node_modules/@allyhub/slides-core/dist/merge.d.ts +5 -5
  344. package/dist/node_modules/@allyhub/slides-core/dist/merge.js +1 -1
  345. package/dist/node_modules/@allyhub/slides-core/dist/model.d.ts +25 -4
  346. package/dist/node_modules/@allyhub/slides-core/dist/office.d.ts +1 -1
  347. package/dist/node_modules/@allyhub/slides-core/dist/path.d.ts +1 -1
  348. package/dist/node_modules/@allyhub/slides-core/dist/resolve.d.ts +20 -11
  349. package/dist/node_modules/@allyhub/slides-core/dist/resolve.js +1 -1
  350. package/dist/node_modules/@allyhub/slides-core/dist/sdk.d.ts +18 -0
  351. package/dist/node_modules/@allyhub/slides-core/dist/sdk.js +2 -0
  352. package/dist/node_modules/@allyhub/slides-core/dist/stage.d.ts +28 -11
  353. package/dist/node_modules/@allyhub/slides-core/dist/units.d.ts +3 -6
  354. package/dist/node_modules/@allyhub/slides-core/dist/units.js +1 -1
  355. package/dist/node_modules/@allyhub/slides-core/package.json +5 -1
  356. package/dist/node_modules/@allyhub/video-core/dist/audio-types.d.ts +1 -2
  357. package/dist/node_modules/@allyhub/video-core/dist/captions.d.ts +1 -10
  358. package/dist/node_modules/@allyhub/video-core/dist/captions.js +1 -1
  359. package/dist/node_modules/@allyhub/video-core/dist/check.d.ts +62 -0
  360. package/dist/node_modules/@allyhub/video-core/dist/check.js +2 -0
  361. package/dist/node_modules/@allyhub/video-core/dist/cut-report.d.ts +2 -2
  362. package/dist/node_modules/@allyhub/video-core/dist/cut-report.js +1 -1
  363. package/dist/node_modules/@allyhub/video-core/dist/edits.d.ts +3 -3
  364. package/dist/node_modules/@allyhub/video-core/dist/edits.js +1 -1
  365. package/dist/node_modules/@allyhub/video-core/dist/fact.d.ts +21 -762
  366. package/dist/node_modules/@allyhub/video-core/dist/fact.js +1 -1
  367. package/dist/node_modules/@allyhub/video-core/dist/footage-motion.d.ts +3 -2
  368. package/dist/node_modules/@allyhub/video-core/dist/footage-motion.js +1 -1
  369. package/dist/node_modules/@allyhub/video-core/dist/index.d.ts +3 -17
  370. package/dist/node_modules/@allyhub/video-core/dist/index.js +1 -1
  371. package/dist/node_modules/@allyhub/video-core/dist/measure.d.ts +72 -423
  372. package/dist/node_modules/@allyhub/video-core/dist/measure.js +1 -4
  373. package/dist/node_modules/@allyhub/video-core/dist/mix-plan.d.ts +44 -0
  374. package/dist/node_modules/@allyhub/video-core/dist/mix-plan.js +2 -0
  375. package/dist/node_modules/@allyhub/video-core/dist/motion.d.ts +1 -1
  376. package/dist/node_modules/@allyhub/video-core/dist/piece.d.ts +24 -432
  377. package/dist/node_modules/@allyhub/video-core/dist/piece.js +1 -1
  378. package/dist/node_modules/@allyhub/video-core/dist/placement.d.ts +1 -1
  379. package/dist/node_modules/@allyhub/video-core/dist/schema.d.ts +8 -14
  380. package/dist/node_modules/@allyhub/video-core/dist/schema.js +1 -1
  381. package/dist/node_modules/@allyhub/video-core/dist/script-edit.d.ts +11 -6
  382. package/dist/node_modules/@allyhub/video-core/dist/script-edit.js +1 -1
  383. package/dist/node_modules/@allyhub/video-core/dist/seams.d.ts +2 -3
  384. package/dist/node_modules/@allyhub/video-core/dist/sound-under.d.ts +2 -2
  385. package/dist/node_modules/@allyhub/video-core/dist/sound-under.js +1 -1
  386. package/dist/node_modules/@allyhub/video-core/dist/speech.d.ts +2 -4
  387. package/dist/node_modules/@allyhub/video-core/dist/speech.js +2 -2
  388. package/dist/node_modules/@allyhub/video-core/dist/stage.d.ts +52 -0
  389. package/dist/node_modules/@allyhub/video-core/dist/stage.js +2 -0
  390. package/dist/node_modules/@allyhub/video-core/dist/timeline.d.ts +18 -136
  391. package/dist/node_modules/@allyhub/video-core/dist/timeline.js +1 -1
  392. package/dist/node_modules/@allyhub/video-core/dist/timing.d.ts +3 -3
  393. package/dist/node_modules/@allyhub/video-core/dist/timing.js +1 -1
  394. package/dist/node_modules/@allyhub/video-core/dist/transcript.d.ts +2 -2
  395. package/dist/node_modules/@allyhub/video-core/dist/transcript.js +1 -1
  396. package/dist/node_modules/@allyhub/video-core/package.json +1 -1
  397. package/dist/node_modules/@allyhub/video-sdk/LICENSE +241 -0
  398. package/dist/node_modules/@allyhub/video-sdk/NOTICE +118 -0
  399. package/dist/{free.d.ts → node_modules/@allyhub/video-sdk/dist/free.d.ts} +14 -10
  400. package/dist/node_modules/@allyhub/video-sdk/dist/free.js +2 -0
  401. package/dist/node_modules/@allyhub/video-sdk/dist/index.d.ts +28 -0
  402. package/dist/node_modules/@allyhub/video-sdk/dist/index.js +2 -0
  403. package/dist/{input.d.ts → node_modules/@allyhub/video-sdk/dist/input.d.ts} +76 -22
  404. package/dist/node_modules/@allyhub/video-sdk/dist/input.js +2 -0
  405. package/dist/{module.d.ts → node_modules/@allyhub/video-sdk/dist/module.d.ts} +6 -4
  406. package/dist/node_modules/@allyhub/video-sdk/dist/module.js +2 -0
  407. package/dist/{parts.d.ts → node_modules/@allyhub/video-sdk/dist/parts.d.ts} +15 -6
  408. package/dist/node_modules/@allyhub/video-sdk/dist/parts.js +2 -0
  409. package/dist/{phone.d.ts → node_modules/@allyhub/video-sdk/dist/phone.d.ts} +12 -5
  410. package/dist/node_modules/@allyhub/video-sdk/dist/phone.js +2 -0
  411. package/dist/{piece.d.ts → node_modules/@allyhub/video-sdk/dist/piece.d.ts} +26 -16
  412. package/dist/node_modules/@allyhub/video-sdk/dist/piece.js +2 -0
  413. package/dist/node_modules/@allyhub/video-sdk/dist/route.d.ts +46 -0
  414. package/dist/node_modules/@allyhub/video-sdk/dist/route.js +2 -0
  415. package/dist/node_modules/@allyhub/video-sdk/dist/scenery.d.ts +2 -0
  416. package/dist/node_modules/@allyhub/video-sdk/dist/scenery.js +2 -0
  417. package/dist/node_modules/@allyhub/video-sdk/package.json +19 -0
  418. package/dist/scenery.d.ts +1 -1
  419. package/dist/scenery.js +1 -1
  420. package/dist/sheets.d.ts +1 -1
  421. package/dist/sheets.js +1 -1
  422. package/dist/slides.d.ts +1 -9
  423. package/dist/slides.js +1 -1
  424. package/docs/README.md +10 -6
  425. package/docs/batches.md +5 -5
  426. package/docs/canvas.md +28 -0
  427. package/docs/contract.md +2 -2
  428. package/docs/defaults.md +298 -22
  429. package/docs/docs.md +80 -66
  430. package/docs/footage.md +7 -7
  431. package/docs/image.md +165 -0
  432. package/docs/layers.md +22 -13
  433. package/docs/modeling.md +4 -4
  434. package/docs/pictures.md +65 -0
  435. package/docs/project.md +51 -31
  436. package/docs/scenery.md +14 -15
  437. package/docs/sheets.md +46 -28
  438. package/docs/slides.md +121 -67
  439. package/docs/sound.md +3 -3
  440. package/docs/speech.md +8 -8
  441. package/docs/video.md +16 -13
  442. package/docs/websites.md +4 -4
  443. package/docs/x.md +73 -0
  444. package/package.json +7 -2
  445. package/dist/define.js +0 -2
  446. package/dist/free.js +0 -2
  447. package/dist/input.js +0 -2
  448. package/dist/module.js +0 -2
  449. package/dist/node_modules/@allyhub/formats/dist/data/comments.d.ts +0 -94
  450. package/dist/node_modules/@allyhub/formats/dist/data/comments.js +0 -2
  451. package/dist/node_modules/@allyhub/runtimes/pins/onnxruntime-node/package-lock.json +0 -227
  452. package/dist/node_modules/@allyhub/runtimes/pins/onnxruntime-node/package.json +0 -8
  453. package/dist/node_modules/@allyhub/runtimes/pins/sherpa-onnx-node/package-lock.json +0 -105
  454. package/dist/node_modules/@allyhub/runtimes/pins/sherpa-onnx-node/package.json +0 -8
  455. package/dist/node_modules/@allyhub/runtimes/pins/tesseract.js/package-lock.json +0 -128
  456. package/dist/node_modules/@allyhub/runtimes/pins/tesseract.js/package.json +0 -9
  457. package/dist/node_modules/@allyhub/video-core/dist/export.js +0 -2
  458. package/dist/node_modules/@allyhub/video-core/dist/formats.js +0 -2
  459. package/dist/node_modules/@allyhub/video-core/dist/gen.d.ts +0 -37
  460. package/dist/node_modules/@allyhub/video-core/dist/problem.d.ts +0 -278
  461. package/dist/node_modules/@allyhub/video-core/dist/problem.js +0 -2
  462. package/dist/node_modules/@allyhub/video-core/dist/script.js +0 -2
  463. package/dist/node_modules/@allyhub/video-core/dist/source.d.ts +0 -7
  464. package/dist/parts.js +0 -2
  465. package/dist/phone.js +0 -2
  466. package/dist/piece.js +0 -2
  467. /package/dist/node_modules/@allyhub/{sheet → formats}/dist/csv.d.ts +0 -0
  468. /package/dist/node_modules/@allyhub/{sheet → formats}/dist/csv.js +0 -0
  469. /package/dist/{fit.d.ts → node_modules/@allyhub/image-sdk/dist/fit.d.ts} +0 -0
  470. /package/dist/{fit.js → node_modules/@allyhub/image-sdk/dist/fit.js} +0 -0
  471. /package/dist/{messages.js → node_modules/@allyhub/image-sdk/dist/messages.js} +0 -0
  472. /package/dist/{props.js → node_modules/@allyhub/image-sdk/dist/props.js} +0 -0
  473. /package/dist/{text.d.ts → node_modules/@allyhub/image-sdk/dist/text.d.ts} +0 -0
  474. /package/dist/{text.js → node_modules/@allyhub/image-sdk/dist/text.js} +0 -0
  475. /package/dist/{written.d.ts → node_modules/@allyhub/image-sdk/dist/written.d.ts} +0 -0
  476. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/anchors.js +0 -0
  477. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/component.d.ts +0 -0
  478. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/console.d.ts +0 -0
  479. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/console.js +0 -0
  480. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/contrast.js +0 -0
  481. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/gen.js +0 -0
  482. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/look.js +0 -0
  483. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/marks.d.ts +0 -0
  484. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/marks.js +0 -0
  485. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/matrix.d.ts +0 -0
  486. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/matrix.js +0 -0
  487. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/messages.js +0 -0
  488. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/source.js +0 -0
  489. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/voice.js +0 -0
  490. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/words.d.ts +0 -0
  491. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/words.js +0 -0
  492. /package/dist/{anim.d.ts → node_modules/@allyhub/video-sdk/dist/anim.d.ts} +0 -0
  493. /package/dist/{anim.js → node_modules/@allyhub/video-sdk/dist/anim.js} +0 -0
  494. /package/dist/{noise.d.ts → node_modules/@allyhub/video-sdk/dist/noise.d.ts} +0 -0
  495. /package/dist/{noise.js → node_modules/@allyhub/video-sdk/dist/noise.js} +0 -0
  496. /package/dist/{paths.d.ts → node_modules/@allyhub/video-sdk/dist/paths.d.ts} +0 -0
  497. /package/dist/{paths.js → node_modules/@allyhub/video-sdk/dist/paths.js} +0 -0
package/docs/layers.md CHANGED
@@ -42,7 +42,7 @@ export const year = part({
42
42
  const x = tween(t, {
43
43
  start: ctx.layer.start,
44
44
  dur: 0.4,
45
- ease: ease.outExpo,
45
+ ease: ease.out,
46
46
  });
47
47
  label.style.opacity = String(x);
48
48
  label.style.transform = `scale(${String(1.4 - 0.4 * x)})`;
@@ -194,10 +194,11 @@ A prop declared `time()` (also inside `list()` and `object()`) is typed `Time` i
194
194
  | --- | --- |
195
195
  | `ctx.look` | The look (also the CSS variables `--ak-color-*`, `--ak-font-*`, `--ak-motion-beat`) |
196
196
  | `ctx.format` | The format's name: `"9x16"`, `"1280x720"`; a deck's may be `"a4"` |
197
- | `ctx.dims` | `{ width, height, orient, safe, profile? }` ([video.md](video.md#formats)) |
197
+ | `ctx.dims` | `{ width, height, orient, safe }` ([video.md](video.md#formats)) |
198
198
  | `ctx.combo` | The combo. A layer may read the dimensions and its own part's slot, never another slot's pick (AK-X005): a part is rendered once for every combo that has it |
199
199
  | `ctx.dur` | The part's length, seconds |
200
200
  | `ctx.layer` | `{ start, end }`: this layer's window, seconds from the part's start |
201
+ | `ctx.enter`, `ctx.exit` | `{ start, end }`: where a transition shares the screen with the part before (`enter`, from before 0) or after (`exit`, to past `ctx.dur`), seconds from the part's start; absent at a cut. An entrance that starts at `ctx.enter.end` plays once the part shows alone |
201
202
  | `ctx.asset(path)` | Media at a path relative to the piece's file |
202
203
  | `ctx.optionalAsset?.(path)` | Media that may not be there (a scenery's bake): `undefined` when it is not, with no problem; the part is drawn again once it is made |
203
204
  | `ctx.words()` | The part's words on its own clock, `[{ text, start, end }]`; empty without speech |
@@ -220,7 +221,7 @@ A prop declared `time()` (also inside `list()` and `object()`) is typed `Time` i
220
221
  `layout(ctx, opts?)` gives `{ W, H, k, orient, pad, top, bottom, left, right }`; `ctx.content` is the same box as `[x, y, w, h]`. In pixels:
221
222
 
222
223
  ```
223
- k = min(W, H) / 1080 the type scale: 1 in every preset and profile
224
+ k = min(W, H) / 1080 the type scale: 1 in every preset
224
225
  margin = 120 × k (landscape), 84 × k (portrait, square)
225
226
  pad = max(margin, safe.left, safe.right)
226
227
  top = max(pad, safe.top + 30 × k)
@@ -275,18 +276,23 @@ From `@allyhub/sdk`; pure functions.
275
276
  | `pathLength(d)`, `pointAtLength(d, l)`, `tangentAtLength(d, l)` | An SVG path measured without the browser |
276
277
  | `drawOn(d, progress)` | `{ strokeDasharray, strokeDashoffset }` showing the first `progress` of a stroke |
277
278
  | `trimPath(d, from, to)`, `interpolatePath(a, b, x)`, `normalizePath(d)` | A stretch of a path (fractions of its length); the path between two with the same commands (it throws otherwise); absolute commands |
279
+ | `routeConnections(boxes, connections, { margin?, bend?, spread?, cross?, bounds? })` | Routes at right angles from a side of one box to a side of another, round every other box: an orthogonal grid round the boxes grown by `margin` (default 16), the cheapest way with each bend costed as `bend` of length (48) and each crossing of another line as `cross` (120), each line then routed again round the others while that crosses fewer (rip-up and reroute), lines sharing a channel set `spread` apart (8) in the order that crosses fewest (each pair followed on to where it parts, and set on the side it turns to there); within `bounds` when given; each route's corners and the sides it uses (`ROUTE_DEFAULTS`). Crossings left are the boxes' placement's: `routeCrossings(routes)` counts them |
278
280
  | `noise2D(seed, x, y)`, `noise3D(seed, x, y, z)`, `noise4D(seed, x, y, z, w)` | Seeded simplex noise in [−1, 1], changing over about one unit |
279
281
 
280
282
  ## A person's input
281
283
 
282
- A cursor, a fingertip, a scrolled list or a field typed into, as functions of time: aimed movements that settle, land a little off their target and tremble, each drawn differently by `seed` and `index`. They place nothing: the piece says where and when, and draws what they return. Defaults: `INPUT_DEFAULTS` ([defaults.md](defaults.md)).
284
+ A mouse's cursor, a hand (a finger hovering a screen, or a thing held to it), a finger's tap, a drag, a scrolled list or a field typed into, as functions of time. They place nothing: the piece says where and when, and draws what they return. Defaults: `INPUT_DEFAULTS` ([defaults.md](defaults.md)).
285
+
286
+ - **A cursor** glides: an aimed movement timed by Fitts' law, landing exactly where it is aimed, with none of a hand's errors; it rests before a click and after it. A hand's errors are options (`overshoot`, `scatter`, `bow`, `tremor`), none by default.
287
+ - **A hand** errs as hands do: past its target and back, a little off, its path bowed, trembling, each move drawn differently by `seed` and `index`. For what a hand holds or touches.
283
288
 
284
289
  | Function | Returns |
285
290
  | --- | --- |
286
- | `pointer({ from, steps: [{ at, to, size?, press?, duration?, dwell?, hold? }], dwell?, hold?, …reach })` | `{ at(t) → { x, y, down }, moves, presses }` |
291
+ | `cursor({ from, steps: [{ at, to, size?, press?, duration?, dwell?, hold?, after? }], dwell?, hold?, after?, …reach })` | `{ at(t) → { x, y, down }, moves, presses }` |
292
+ | `handPath({ from, steps: [{ at, to, size?, press?, duration?, dwell?, hold? }], dwell?, hold?, …reach })` | The same, moved by a hand |
287
293
  | `reach(from, to, { end, duration?, size?, index? }, reach?)` | One movement: `{ start, end, from, to, at(t), progress(u), bow }` |
288
- | `tap({ at, to, hold?, slide?, grow?, size?, scatter?, seed?, index? })` | `{ down, up, at(t) → { x, y, down, contact } }` |
289
- | `drag({ from, to, at, duration?, size?, settle?, release?, index?, …reach })` | `{ down, start, end, up, to, at(t) → { x, y, down } }` |
294
+ | `tap({ at, to, hold?, slide?, grow?, size?, scatter?, seed?, index? })` | A finger's: `{ down, up, at(t) → { x, y, down, contact } }` |
295
+ | `drag({ by?, from, to, at, duration?, size?, settle?, release?, index?, …reach })` | `{ down, start, end, up, to, at(t) → { x, y, down } }`: `by: "mouse"` (default) glides and holds still while down, `"finger"` moves as a hand and trembles |
290
296
  | `scroll({ at, by, kind?, limit?, wheel?, flick?, seed?, index? })` | `{ start, end, at(t) → px }`: `"flick"` (default) with momentum, or `"wheel"` notches |
291
297
  | `typing(text, { at, cps?, spread?, word?, mark?, think?, mistakes?, notice?, backspace?, seed? })` | `{ keys, times, end, text(t) }`; `mistakes: [{ at, typed }]` types one and corrects it (none unless asked) |
292
298
  | `fittsTime(distance, size, fitts?)` | `a + b · log2(1 + distance / size)` seconds |
@@ -294,11 +300,13 @@ A cursor, a fingertip, a scrolled list or a field typed into, as functions of ti
294
300
 
295
301
  The reach options are `overshoot`, `peak`, `vary`, `fitts: { a, b }`, `scatter`, `jitter`, `bow`, `tremor: { px, frequency }` and `seed`.
296
302
 
303
+ A cursor on an interface the piece draws is best `uiDemo`'s (below): it finds each element where it is when it is acted on. A cursor of a layer's own goes to the points the piece gives it:
304
+
297
305
  ```ts
298
- import { custom, pointer } from "@allyhub/sdk";
306
+ import { cursor, custom } from "@allyhub/sdk";
299
307
  import { h, one, tag } from "@allyhub/sdk/dom";
300
308
 
301
- const hand = pointer({
309
+ const path = cursor({
302
310
  from: [200, 900],
303
311
  steps: [
304
312
  { at: 1, to: [960, 540], size: 120, press: true },
@@ -306,7 +314,7 @@ const hand = pointer({
306
314
  ],
307
315
  });
308
316
 
309
- export const cursor = custom({
317
+ export const arrow = custom({
310
318
  mount(el) {
311
319
  el.append(
312
320
  tag(
@@ -324,7 +332,7 @@ export const cursor = custom({
324
332
  render(el, t) {
325
333
  const dot = one(el, "cursor");
326
334
  if (!dot) return;
327
- const p = hand.at(t);
335
+ const p = path.at(t);
328
336
  dot.style.transform = `translate(${String(p.x - 12)}px, ${String(p.y - 12)}px) scale(${p.down ? "0.8" : "1"})`;
329
337
  },
330
338
  });
@@ -336,8 +344,9 @@ The SDK has no components of its own. `allyhub add component/<name>` (`component
336
344
 
337
345
  | Component | What it does |
338
346
  | --- | --- |
339
- | `screenDemo` (and `uiDemo`, same file) | A demo on a screenshot with its elements file (`allyhub frames web`), or on an interface drawn in code: a camera in on what is acted on, a cursor that travels and clicks, typing, presses |
347
+ | `uiDemo` (and `screenDemo`, same file) | A product's interface acted on: `uiDemo` draws it from the project's own UI components (`build(page)`), `screenDemo` from a screenshot with its elements file (`allyhub frames web`). Each step names what it acts on (a CSS selector in the page), found where it is at that moment: the camera goes in on it, the cursor lands inside it (`cursor.aim`, a share of its box) and clicks, types into it or presses it |
340
348
  | `codePanel` | Code, data or a terminal in a panel: coloured, typed or revealed, lines and spans highlighted in time |
341
- | `callout` | Marks places (a box, or another layer's element, followed), labels them, draws lines between them |
349
+ | `callout` | Marks places, labels them and draws lines between them. A place is another layer's element (a CSS selector), measured every frame, so a mark stays on it through a change of layout or a camera move. `fit: "text"` pads from the text as it reads (capitals' tops to baseline, ink to ink), so equal pads look equal |
350
+ | `connector` | Lines between named elements (CSS selectors of the frame's other layers) at right angles, round every other box and what `avoid` names, an arrow at the end; lines sharing a channel set apart. `allyhub inspect pages` reports how many times its lines cross. List it last in a component's `layers` |
342
351
  | `chart` | Bars, horizontal bars, a line or a ring, with its scale, labels fitted and the draw-on |
343
352
  | `captionWord`, `captionLine`, `captionSubtitle` | Captions from `ctx.captions()`: a word at a time; a line with the word being said marked; a quiet subtitle |
package/docs/modeling.md CHANGED
@@ -4,7 +4,7 @@ A prop no library has is modelled in code with `@allyhub/model`: a subset of Ble
4
4
 
5
5
  ## A model module
6
6
 
7
- A model module's default export is `defineModel(build)`. A model made to be used again is an item of its own: a folder with a `model.ts` (`models/desk/model.ts`), made once and put in any scenery that imports it, each with its own parameters (a size, a finish). It opens alone in the scenery's viewer (`allyhub dev`, Studio), `allyhub check` builds it (one that does not build is AK-B010), and `allyhub render` writes its GLB (`<out>/<folder>/<folder>.glb`). AllyHub's registry has products as model pieces to start from (`allyhub add 3d-model/monitor` adds `models/monitor/model.ts` and the kit it is built with; `allyhub add search --type 3d-model` lists them). A part only one scenery uses may stay a module beside it (`room/stick.ts`), named anything but `model.ts`: a folder holds one entry file. `@allyhub/model` is lent by the CLI, with no `package.json` entry.
7
+ A model module's default export is `defineModel(build)`, or `defineModel({ title, build })`: `title` is the item's name where `allyhub.yaml` gives it none, read from the module as written (a string, not computed); without either, its file's name. A model made to be used again is an item of its own, listed in `allyhub.yaml` as `kind: model` ([project.md](project.md#items)) (`models/desk/desk.ts`), made once and put in any scenery that imports it, each with its own parameters (a size, a finish). It opens alone in the scenery's viewer (`allyhub dev`, Studio), `allyhub check` builds it (one that does not build is AK-B010), and `allyhub render` writes its GLB, by its id. AllyHub's registry has products as model pieces to start from (`allyhub add 3d-model/monitor` adds `models/monitor/monitor.ts` and the kit it is built with; `allyhub add search --type 3d-model` lists them). A part only one scenery uses may stay a module beside it (`room/stick.ts`) that the list does not name: the scenery's alone. `@allyhub/model` is lent by the CLI, with no `package.json` entry.
8
8
 
9
9
  ```ts file=room/stick.ts
10
10
  import { defineModel } from "@allyhub/model";
@@ -100,16 +100,16 @@ The surface's detail is about one `cell`.
100
100
  ## Build and measure
101
101
 
102
102
  - `allyhub 3d-model <file> --inspect` evaluates it without writing anything: each object's parent, matrix, bounds after its modifiers (Blender's Z-up metres), triangles, materials as glTF reads them, UV layers, a curve's splines, and the objects left with no triangles.
103
- - `allyhub 3d-model <file>` writes a GLB (Y up), by default `.allyhub/out/<module>.glb` (the folder's name for a `model.ts`); `--out` names another (`assets/media/models/<name>.glb` to load it as media). A failed build leaves the last GLB in place.
103
+ - `allyhub 3d-model <file>` writes a GLB (Y up), by default `.allyhub/out/<module>.glb`; `--out` names another (`assets/media/models/<name>.glb` to load it as media). A failed build leaves the last GLB in place.
104
104
  - A build is kept in `.allyhub/cache/model/` while the module, the files it read, its folder's files, its parameters and seed are unchanged; `--fresh` builds anew.
105
105
  - The program is trusted project code, run in a child process; its logs go to stderr. An error names the call and the place in the project's files it failed at.
106
106
  - A subdivision surface lies inside its cage: measure the surface (`--inspect`), not the cage.
107
107
 
108
108
  ## In a scenery
109
109
 
110
- `modelObject(w, model, parameters?, options?)` from `@allyhub/model/three` builds the model in the scenery's page (a model item is imported by its path, `import desk from "../../models/desk/model.ts"`, as any module), drawn as its GLB is, its images read through `w.texture`. It returns a `Group` not yet in the scene, whose own rotation turns Z up to Y up: place and turn it inside a group of the scenery's own. A model built once into a GLB loads as any model instead (`import`, `w.load`), and stays as built until built again.
110
+ `modelObject(w, model, parameters?, options?)` from `@allyhub/model/three` builds the model in the scenery's page (a model item is imported by its path, `import desk from "../../models/desk/desk.ts"`, as any module), drawn as its GLB is, its images read through `w.texture`. It returns a `Group` not yet in the scene, whose own rotation turns Z up to Y up: place and turn it inside a group of the scenery's own. A model built once into a GLB loads as any model instead (`import`, `w.load`), and stays as built until built again.
111
111
 
112
- ```ts file=room/scenery.ts
112
+ ```ts file=room/room.ts
113
113
  import { Group, Mesh, MeshPhysicalMaterial } from "three";
114
114
  import { defineScenery } from "@allyhub/scenery-host/layer";
115
115
  import { modelObject } from "@allyhub/model/three";
@@ -0,0 +1,65 @@
1
+ # Pictures
2
+
3
+ `picture()` is a layer that shows a still (PNG, JPEG, WebP, AVIF, GIF or SVG) in CSS's terms. It is a graphic layer of the layer contract ([layers.md](layers.md)), so a video's part, a deck's component and a doc's component draw it alike. `footage()` of a still is the same layer ([below](#footage-of-a-still)). A deck's own pictures keep PowerPoint's crop ([slides.md](slides.md)), worked out from the same geometry.
4
+
5
+ ```ts file=launch/film/film.ts
6
+ import { part, picture, video } from "@allyhub/sdk";
7
+
8
+ import plate from "../../assets/media/plates/desk.webp";
9
+
10
+ export default video({
11
+ format: "9x16",
12
+ parts: () => [
13
+ part({
14
+ key: "open",
15
+ dur: 3,
16
+ layers: [
17
+ picture({ src: plate, fit: "cover", position: [0.62, 0.4] }),
18
+ picture({
19
+ src: "./product.png",
20
+ box: [0.1, 0.55, 0.8, 0.35],
21
+ fit: "contain",
22
+ radius: 32,
23
+ }),
24
+ ],
25
+ }),
26
+ ],
27
+ });
28
+ ```
29
+
30
+ | Option | Type | Default | What it is |
31
+ | --- | --- | --- | --- |
32
+ | `src` | an import, or a path from the module | (required) | The still |
33
+ | `box` | `[x, y, w, h]`, fractions of the layer's frame | the whole frame | Where it shows; nothing outside it |
34
+ | `fit` | `"cover"`, `"contain"`, `"fill"`, `"none"` | `"cover"` | CSS's `object-fit` |
35
+ | `position` | `[x, y]`, shares of the picture | `[0.5, 0.5]` | CSS's `object-position` in percentages: the point at `x`, `y` of the picture lies at `x`, `y` of the box |
36
+ | `crop` | `[x, y, w, h]`, fractions of the source | none | The part of the source fitted, as the whole picture would be; nothing outside it shows |
37
+ | `mask` | `"ellipse"`, a picture, or a CSS `mask-image` | none | `"ellipse"`: the ellipse inscribed in the box. A picture (an import, or a path with an image's extension): its alpha masks the box. Anything else is CSS: `"linear-gradient(black 60%, transparent)"`. Or a mask's object, every layer's ([image.md](image.md)): its density, feather, inversion, or a path; laid over the box |
38
+ | `radius` | px of the frame, or a CSS `border-radius` | none | The box's corners |
39
+ | `blendMode` | Photoshop's names ([image.md](image.md)) | `normal` | Every layer's: how it mixes with what is drawn under it, drawn on what shows of it |
40
+ | `filter` | a CSS `filter` | none | `"blur(8px) saturate(0.8)"` |
41
+ | `alt` | string | none | What a screen reader says |
42
+
43
+ Besides these, the layer options of any graphic layer: `at`, `until`, `dur`, `z` ([video.md](video.md#layers)).
44
+
45
+ - **The geometry** is `placePicture` of `@allyhub/piece`, the numbers in [defaults.md](defaults.md) (`PICTURE_DEFAULTS`). `none` draws a pixel of the source on a pixel of the frame.
46
+ - **Lengths** (`radius`, a `filter`'s blur) are the frame's pixels, as CSS's, not px at 1080p as footage's.
47
+ - **A blend mode** mixes with what the stage draws under it: graphic layers and other pictures. A video file's footage is not drawn by the stage in a render (it is composited after), so a picture over footage blends there with the graphics alone; the live preview blends it with the footage too.
48
+ - **Chrome draws it**, from the file alone: the same moment draws the same in order and out of order (AK-D002). A file that is not there is AK-A001; one that does not load AK-A005.
49
+
50
+ ## Changing a picture's pixels
51
+
52
+ A picture's pixels are changed by AllyHub's cloud tools, each its own command (`allyhub ai-media <tool>`; `allyhub help ai-media <tool>` gives its input, its limits and its price): `generate-image`, `edit-image` (where a `mask` or a `markup` says, when given), `extend-image` and `cut-out-image` (the cut-out and its matte). A picture's parts as layers are the agent's to make: a part cut out (`cut-out-image`) and the picture without it (`edit-image` with a mask). No tool takes a model: what serves each is the cloud's to choose.
53
+
54
+ - **A picture on this computer** goes in by the address `allyhub upload` gives it.
55
+ - **What a call makes** is a new file, never the picture given changed, with its record beside it (`<file>.gen.json`: the tool, the whole input, what it returned, the credits). The same call to the same `--file` finds that file and calls nothing. Files the output names deeper (a matte, the layers) are downloaded beside it, each listed in the result.
56
+ - **Outside a mask** the model may redraw a little: what is kept exactly, and how, is the code's.
57
+ - **A Mark up note's region** is SVG path data in the pixels of the picture whose file it names.
58
+
59
+ ## `footage()` of a still
60
+
61
+ `footage(still, opts)` is `picture()` with footage's options read as its: `at`, `until`, `dur`, `box` (one rectangle, or `"full"`), `fit`, `crop` (one rectangle), `reframe` (`"center"` or `{ x, y }`: its position; `"face"` throws, since a still has no face track yet), `shape: "circle"` (an ellipse mask) and `radius` (px at 1080p). A still has no time or sound of its own: any other option throws, and so do box keyframes and a box or crop per frame shape.
62
+
63
+ ## A deck's pictures
64
+
65
+ A deck's picture keeps PowerPoint's model: its file stretched over its frame after `crop` (`a:srcRect`, the share cut from each side; a negative share is space left beside it). The editor's Crop menu has PowerPoint's Fill and Fit: Fill crops the picture to fill its frame, Fit fits it inside, each centred, the frame kept. Both are `placePicture`'s cover and contain written as `crop`, so a deck's picture and a `picture()` at the same point of the same plate, in frames of one shape, show the same part of it.
package/docs/project.md CHANGED
@@ -1,10 +1,11 @@
1
1
  # A project
2
2
 
3
- An AllyHub project is a folder, laid out as its people like, and a TypeScript (Node) project. AllyHub finds what it holds by two things only: an item's entry file name, and imports. This file covers the folders, the items, how a piece imports the SDK and other files, the words it reads, `allyhub.config.ts` and fonts.
3
+ An AllyHub project is a folder, laid out as its people like, and a TypeScript (Node) project. AllyHub finds what it holds by two things only: its list of work, `allyhub.yaml`, and imports. This file covers the folders, the items, how a piece imports the SDK and other files, the words it reads, `allyhub.config.ts` and fonts.
4
4
 
5
5
  ```
6
6
  package.json depends on allyhub and @allyhub/sdk
7
7
  tsconfig.json the compiler's settings: the SDK's types
8
+ allyhub.yaml the work a person sees: each piece's kind, file and title
8
9
  allyhub.config.ts the project's settings, the look, fonts (optional)
9
10
  AGENTS.md, CLAUDE.md the project's standing instructions (CLAUDE.md is @AGENTS.md)
10
11
  .gitignore node_modules/ and .allyhub/
@@ -54,31 +55,48 @@ This computer's own: never shared, rebuilt as needed. Nothing a piece imports ma
54
55
  | Folder | What is in it |
55
56
  | --- | --- |
56
57
  | `.allyhub/work/` | The agent's working files, free to throw away: frame sheets, cut sheets, references (`reference/`) |
57
- | `.allyhub/out/` | Renders and exports, by the item's place |
58
+ | `.allyhub/out/` | Renders and exports, by the item's id |
58
59
  | `.allyhub/cache/` | What the tools rebuild: builds, the media index (face tracks, mattes, levels), the part cache, types |
59
60
  | `.allyhub/trash/` | What a person deleted in an editor, kept until they empty it |
60
61
 
61
62
  ## Items
62
63
 
63
- An item is a folder with its entry file. The entry file's name says what the item is:
64
+ An item is a piece of work a person sees: a file of a kind, named by the project's list, `allyhub.yaml` at its root. Files are yours to name and place; the list says what a person sees in Studio and `allyhub dev`, in its order, under its headings:
64
65
 
65
- | Entry file | Item | Its entry file holds |
66
- | --- | --- | --- |
67
- | `video.ts` | A video | `export default video({ … })` ([video.md](video.md)) |
68
- | `slides.ts` | A deck | `export default presentation({ size }, (prs) => { … })` from `@allyhub/sdk/slides`, with `slides.yaml` beside it ([slides.md](slides.md)) |
69
- | `scenery.ts` | A 3D scenery | `export default defineScenery({ … })` ([scenery.md](scenery.md)) |
70
- | `model.ts` | A 3D model | `export default defineModel(build)` ([modeling.md](modeling.md)) |
71
- | `doc.mdx` | A doc | The doc itself, MDX |
72
- | `sheet.yaml` | A sheet | The workbook: its sheets, cells, formulas, formats, names and checks; `data/*.csv` beside it holds its tables' rows |
73
- | `website.json` | A website | How the web project in its folder is served, built and where the built site is ([websites.md](websites.md)) |
74
-
75
- `video`, `slides`, `scenery` and `model` may end in `.ts`, `.tsx`, `.mts`, `.js`, `.jsx` or `.mjs`.
76
-
77
- - Everything in an item's folder is the item's own: its script, its media, its edits files. Folders above it only group items.
78
- - An item may be anywhere but the project's root, a dot folder and `node_modules`. An item cannot hold another, and a folder cannot have two entry files (AK-M003). A `video(…)` exported from anything but an item's entry file is AK-M002.
79
- - An item's **place** is its folder's path from the project's root (`launch/film`). A piece's `id` is its place unless it sets `id` (lowercase letters, digits, `.`, `_` and `-`, with `/` between levels). Two pieces with one id are AK-B001. The id names its message keys (`launch/film` reads keys under `launch.film.`) and seeds its randomness.
66
+ ```yaml
67
+ work:
68
+ - group: Launch
69
+ items:
70
+ - kind: video
71
+ file: launch/film.ts
72
+ title: Launch film, 30 s
73
+ - kind: video
74
+ file: launch/vertical/film.ts
75
+ - kind: slides
76
+ file: decks/seed.ts
77
+ - kind: doc
78
+ file: notes/brief.mdx
79
+ ```
80
80
 
81
- ### The entry file
81
+ | Kind | Item | Its file holds |
82
+ | --- | --- | --- |
83
+ | `video` | A video | `export default video({ … })` ([video.md](video.md)) |
84
+ | `slides` | A deck | `export default presentation({ slides, script, size }, (prs) => { … })` from `@allyhub/sdk/slides`, naming its slides file and its script ([slides.md](slides.md)) |
85
+ | `image` | An image | `export default image({ script, boards })` from `@allyhub/sdk/image`, naming its script ([image.md](image.md)) |
86
+ | `scenery` | A 3D scenery | `export default defineScenery({ … })` ([scenery.md](scenery.md)) |
87
+ | `model` | A 3D model | `export default defineModel(build)` ([modeling.md](modeling.md)) |
88
+ | `doc` | A doc | The doc itself, MDX ([docs.md](docs.md)) |
89
+ | `sheet` | A sheet | The workbook, YAML: its sheets, cells, formulas, formats, names and checks; the CSV files it names hold its tables' rows, and the module its `code` names makes sheets ([sheets.md](sheets.md)) |
90
+ | `website` | A website | JSON: how the web project in its folder is served, built and where the built site is ([websites.md](websites.md)) |
91
+ | (none) | A canvas | A `.canvas` file, JSON Canvas: its editor opens it by its name, so its entry names no `kind` (`- file: boards/launch.canvas`) |
92
+
93
+ - Each piece has its `kind`, its `file` from the project's root and, if you want, a `title`: its name where people see it; without one, the title its file says, else the file's name. A `group` is a heading over its `items`, and groups nest. A new project's list is `work: []`; an item a person makes in Studio or `allyhub dev` is added at its end.
94
+ - A file the list does not name is yours alone: a scenery a video imports, a part, a helper, a draft. Nothing shows it to a person; the build still follows imports to it.
95
+ - An item's **id** is its file without its extension (`launch/film`), one in the project: it names the item in commands (`allyhub check launch/film`, `--piece launch/film`), in `.allyhub/out/` and in a share. A piece's `id` is its item's unless it sets `id` (lowercase letters, digits, `.`, `_` and `-`, with `/` between levels). Two pieces with one id are AK-B001. The id names its message keys (`launch/film` reads keys under `launch.film.`) and seeds its randomness.
96
+ - An item names the other files it uses, each from its own file's folder: a piece's script (`script: "./film.{locale}.yaml"`), a deck's slides file (`slides: "./deck.yaml"`), a sheet's code (`code: ./forecast.ts`) and its tables' CSV files. Nothing is found by a fixed name, so items share a folder freely, and two share a file only when both name it.
97
+ - `allyhub check` reports what is wrong with the list: a list it cannot read, a kind not loaded, a file listed with no kind that no editor opens by its name, or a file not there (AK-M002), one id twice (`a.ts` and `a.mdx`, or one file listed twice, AK-M003). Moving or renaming a listed file in Studio writes the list again, with the imports.
98
+
99
+ ### The item's file
82
100
 
83
101
  - The default export is `video({ … })` or `presentation(…)` written in the file, or a constant holding one (`const film = video({ … }); export default film`). A re-export, a factory function or a conditional is not followed (AK-M001).
84
102
  - The module's top level runs in Node when the build reads the piece: what needs `window` or `document` goes in `parts` (or `pages`) or in a layer's `mount` and `render`. The top level may not use the network (AK-B003) and must finish (AK-B004).
@@ -90,7 +108,7 @@ A project file imports `@allyhub/sdk`; the build gives it the SDK with `video`,
90
108
 
91
109
  An item uses another by an ordinary relative import. A piece in another format is an item of its own:
92
110
 
93
- ```ts file=launch/film/video.ts
111
+ ```ts file=launch/film.ts
94
112
  import { part, say, video } from "@allyhub/sdk";
95
113
 
96
114
  export default video({
@@ -102,13 +120,13 @@ export default video({
102
120
  });
103
121
  ```
104
122
 
105
- ```ts file=launch/film-vertical/video.ts
123
+ ```ts file=launch/vertical/film.ts
106
124
  import { video } from "@allyhub/sdk";
107
125
 
108
- import film from "../film/video.ts";
126
+ import film from "../film.ts";
109
127
 
110
- // Its music is still launch/film/music/bed.mp3.
111
- export default video({ ...film, id: "launch/film-vertical", format: "9x16" });
128
+ // Its music is still launch/music/bed.mp3; its id is launch/vertical/film.
129
+ export default video({ ...film, format: "9x16" });
112
130
  ```
113
131
 
114
132
  - `video()` returns its fields as written, so a piece can spread another. A copy of a piece that sets `id` needs an `id` of its own.
@@ -118,9 +136,9 @@ export default video({ ...film, id: "launch/film-vertical", format: "9x16" });
118
136
 
119
137
  All the text people see or hear is read with `s(key)` (the parts function's `ctx.s`). An item's own words are its **script**; words several items share are in `assets/text/<lang>.json`.
120
138
 
121
- ### `script.<lang>.yaml`
139
+ ### Scripts
122
140
 
123
- One file per language in the item's folder (`script.en.yaml`, `script.zh-cn.yaml`):
141
+ An item's script is one file per language, which the item names from its module's folder, with `{locale}` once in the file's name standing for each: `video({ script: "./film.{locale}.yaml", … })` reads `film.en.yaml`, `film.zh-cn.yaml`; a deck names its own in `presentation({ script })` ([slides.md](slides.md#the-script)). A video without `script` has no words of its own.
124
142
 
125
143
  ```yaml
126
144
  title: Tidyform launch
@@ -148,10 +166,12 @@ The script becomes messages under the piece's prefix (its id with `/` as `.`):
148
166
  | `text.<name>` | `<prefix>.<name>` |
149
167
  | `parts[].say` | `<prefix>.<part>.say` |
150
168
  | `parts[].screen.<name>` | `<prefix>.<part>.<name>`; names nest, a list is numbered (`<prefix>.how.steps.0`) |
169
+ | `slides[].text.<name>` | `<prefix>.<slide>.<name>`, a deck's shape's words ([slides.md](slides.md)) |
170
+ | `boards[].text.<name>` | `<prefix>.<board>.<name>`, an image's layer's words ([image.md](image.md)) |
151
171
 
152
- - A row's `id` is a part's `key`; a row has `id`, `say` and `screen`, nothing else. A row for a part the video does not have yet is allowed.
172
+ - A row's `id` is a part's `key`; a row has `id`, `say` and `screen`, nothing else. A row for a part the video does not have yet is allowed. A video's words are under `parts`, a deck's under `slides`, an image's under `boards` (`id` and `text`), each by its kind's own name for what it is made of.
153
173
  - A `say` is one line, or a plural: it may hold anchors (`@{name}`) and text shown one way and said another (`<12|twelve>`) ([speech.md](speech.md)). A text on screen is a string, `{ display, speak }`, a plural, a list, or texts by name.
154
- - A file that is not YAML or not a script, and a key made twice, are AK-M007. A script whose folder has no entry file yet is read and waits for its item.
174
+ - A file that is not YAML or not a script, and a key made twice, are AK-M007. A script no item names is not read.
155
175
 
156
176
  ### `assets/text/<lang>.json`
157
177
 
@@ -188,7 +208,7 @@ A key is segments of letters, digits, `_` and `-` joined by dots. A value is a s
188
208
 
189
209
  - `hint` is `{ max?, note? }`: a length budget and a note for whoever writes the text. It changes nothing.
190
210
  - A key missing in the combo's language falls back to the default language (AK-S002, a warning); missing there too, it is `""` (AK-S001).
191
- - The languages are the scripts' and `assets/text/`'s, ordered with `allyhub.config.ts`'s `locales` first, else `en`; a piece's `matrix.dims.lang` narrows them ([batches.md](batches.md)). Each language is a combo of the piece.
211
+ - A piece's languages are its script's and `assets/text/`'s, ordered with `allyhub.config.ts`'s `locales` first, else `en`; a piece's `matrix.dims.lang` narrows them ([batches.md](batches.md)). Each language is a combo of the piece.
192
212
  - A line may mark stretches: `**strong**`, `*em*`, `~~struck~~`, `` `code` ``. `s()` returns the line as written; `readMarks`, `markRuns` and `withoutMarks` read it, and `marked()` from `@allyhub/sdk/dom` draws it ([layers.md](layers.md)).
193
213
  - Text written in code is drawn as written, in every language.
194
214
 
@@ -196,9 +216,9 @@ A key is segments of letters, digits, `_` and `-` joined by dots. A value is a s
196
216
 
197
217
  A file is used by importing it, by a string path relative to the module that names it, or by `ctx.asset(path)` and `ctx.data(path)` for a path made at run time (relative to the piece's file).
198
218
 
199
- A share of one item serves only what the item reaches: the files in its folder, what its code imports, what its slides show, and what a path named at run time read when the check last loaded it. A file outside its folder named only at run time is in its share once the check has run since.
219
+ A share of one item serves only what the item reaches: the files its kind's build lists for it (its file, its script, a deck's slides file, a sheet's code and tables, a doc's pictures and sources), what its code imports, what its slides show, and what a path named at run time read when the check last loaded it, never its folder's other files. A file named only at run time is in its share once the check has run since.
200
220
 
201
- ```ts file=launch/plans/video.ts
221
+ ```ts file=launch/plans/plans.ts
202
222
  import { custom, part, video } from "@allyhub/sdk";
203
223
 
204
224
  import logo from "../../assets/media/logo.svg";
package/docs/scenery.md CHANGED
@@ -4,9 +4,9 @@ A scenery is three.js the agent writes, in a module whose default export is `def
4
4
 
5
5
  ## A scenery is an item
6
6
 
7
- An item is a folder with a `scenery.ts` (or tsx, mts, js, jsx, mjs). A person looks round it in Studio and `allyhub dev`'s page at scenery time 0, selecting a placed object (the outermost named one) and its named `cameras`, never editing it; a note on it names the object, its size, the point clicked and the view as an `allyhub scenery view` command. A scenery module by another name is code, not an item.
7
+ A scenery a person sees is listed in `allyhub.yaml` as `kind: scenery` ([project.md](project.md#items)). A person looks round it in Studio and `allyhub dev`'s page at scenery time 0, selecting a placed object (the outermost named one) and its named `cameras`, never editing it; a note on it names the object, its size, the point clicked and the view as an `allyhub scenery view` command. A scenery module the list does not name (one a video imports, a setting several share) is code, yours alone; the stage knows a scenery module by what it is (it calls `defineScenery`), not by its name.
8
8
 
9
- - A video imports a scenery item by its path, as any module: `import room from "../room/scenery.ts"`.
9
+ - A video imports a scenery item by its path, as any module: `import room from "../room/room.ts"`.
10
10
  - A path a scenery reads that starts with `./` or `../` (`w.texture("./wood.jpg")`, `w.load("./desk.glb")`, a model's image) is from the scenery's own module; any other is from the project's root. An import (`import desk from "./desk.glb"`) is the same. Kept in its folder and named from there, a scenery works wherever the folder goes.
11
11
  - `three` (r186, 0.186.1), `three/addons/…`, `three/webgpu` and `three/tsl` are imported by name with no `package.json`: the CLI lends them, unless the project declares its own `three`. So are `@allyhub/scenery-host/layer` (everything in this file) and `@allyhub/model` ([modeling.md](modeling.md)). Their types come with the project's `allyhub` once `allyhub/client` is in tsconfig.json's `types`, beside `@allyhub/sdk/client`; three.js's are `@types/three`, which the project installs at the version lent (`npm install -D @types/three@0.186.0`).
12
12
  - glTF and GLB load (`.glb`, `.gltf`, `.bin`, `.ktx2`), environments are `.hdr` or `.exr`; all are media imports. CC0 models, HDRIs and textures: `allyhub add search --type @polyhaven`, `allyhub add @polyhaven/<id>`. AllyHub's own 3D models and sceneries: `allyhub add search --type 3d-model` (or `scenery`), `allyhub add 3d-model/<name>`.
@@ -15,7 +15,7 @@ An item is a folder with a `scenery.ts` (or tsx, mts, js, jsx, mjs). A person lo
15
15
 
16
16
  ## `defineScenery`
17
17
 
18
- ```ts file=room/scenery.ts
18
+ ```ts file=room/room.ts
19
19
  import * as THREE from "three";
20
20
  import { defineScenery, path } from "@allyhub/scenery-host/layer";
21
21
  import sofaModel from "./sofa.glb";
@@ -47,7 +47,7 @@ export default defineScenery({
47
47
  });
48
48
  ```
49
49
 
50
- `build(w)` runs once, awaited with every load it starts (60 s at most; in a video it counts in the piece's `loadLimit`, AK-P002); what it returns is `made`. `update(made, t, w)` poses it at `t`, seconds of scenery time. `cameras` (checked when defined, AK-W004) and `moves` are by name, for the commands and for layers. `bake` is in [Baked light](#baked-light).
50
+ `build(w)` runs once, awaited with every load it starts (60 s at most; in a video it counts in the piece's `loadLimit`, AK-P002); what it returns is `made`. `update(made, t, w)` poses it at `t`, seconds of scenery time. `cameras` (checked when defined, AK-W004) and `moves` are by name, for the commands and for layers. `bake` is in [Baked light](#baked-light). `title` is the item's name where `allyhub.yaml` gives it none, read from the module as written (a string, not computed); without either, its file's name.
51
51
 
52
52
  **From `t` alone.** The same moment must draw the same pixels in any order (AK-D002). `Date`, `performance.now`, `Math.random`, `crypto.getRandomValues` and `requestAnimationFrame` follow the moment drawn; timers run only while it builds. Pose an `AnimationMixer` with `w.seek(mixer, t)` (every action reset, then `setTime(t)`), not a bare `setTime`. Name what is referred to (`Object3D.name`): cameras, moves, measurements and `projectScenery` take names, and a name no object has, or two have, is AK-W005.
53
53
 
@@ -154,13 +154,13 @@ camera: shots([
154
154
 
155
155
  ### A phone
156
156
 
157
- `PHONE_CAMERA` (`@allyhub/sdk/scenery`) names a phone's main camera as the options of each mechanism; `phoneCamera(over)` changes any value and keeps the rest. `lens` goes into a camera state, `sensor` into `scenery({ sensor })`, `hand` into `handheld()`, and the marks it leaves on its picture (grain, softness, sharpening, motion blur) into `video()`'s `capture` and `motionBlur` ([video.md](video.md)). Each is a starting point, not a look.
157
+ `PHONE_CAMERA` (`@allyhub/sdk/scenery`) names a phone's main camera as the options of each mechanism; `phoneCamera(over)` changes any value and keeps the rest. `lens` goes into a camera state, `sensor` into `scenery({ sensor })`, `hand` into `handheld()`, and the marks it leaves on its picture (grain, softness, sharpening) into `video()`'s `capture` ([video.md](video.md)). Its `motionBlur` is null: each sample draws a frame again (8 made a phone-filmed short take three times as long to render), and a hand's moves barely show it. The sensor's `grade` follows what fills the frame, as a phone's exposure does: on a room or a person its `room` grade (a gentle contrast, a little more colour); as a screen comes to fill the frame, its `screen` grade (the phone exposes for the lit screen: its white a neutral light grey, its middle tones and colours deep), eased in between `share[0]` and `share[1]` of the frame filled (default 50% and 80%), frame by frame. Each grade is a brightness curve (`curve`, hues kept), then `saturation` and `hue`; it grades the scenery layer alone, not captions laid over it; `grade: null` for none. The screen's grade and the capture's marks are measured against phone photos of a laptop's screen (fine grain kept in the whites, crisp sharpened text). Each is a starting point, not a look.
158
158
 
159
- ```ts file=phone/video.ts
159
+ ```ts file=phone/phone.ts
160
160
  import { part, video } from "@allyhub/sdk";
161
161
  import { phoneCamera } from "@allyhub/sdk/scenery";
162
162
  import { handheld, scenery, shots } from "@allyhub/scenery-host/layer";
163
- import room from "../room/scenery.ts";
163
+ import room from "../room/room.ts";
164
164
 
165
165
  const phone = phoneCamera({ hand: { tremor: { angle: 0.15 } } });
166
166
  const camera = handheld(
@@ -182,7 +182,6 @@ const camera = handheld(
182
182
  export default video({
183
183
  format: "9x16",
184
184
  capture: phone.capture,
185
- motionBlur: phone.motionBlur,
186
185
  parts: () => [
187
186
  part({
188
187
  key: "look",
@@ -197,15 +196,15 @@ export default video({
197
196
 
198
197
  `scenery(scenery, opts)` is a graphic layer. The scenery is built once when the output loads and posed at each frame's scenery time.
199
198
 
200
- ```ts file=tour/video.ts
199
+ ```ts file=tour/tour.ts
201
200
  import { custom, part, video } from "@allyhub/sdk";
202
201
  import {
203
202
  projectScenery,
204
203
  scenery,
205
204
  screen,
206
205
  } from "@allyhub/scenery-host/layer";
207
- import room from "../room/scenery.ts";
208
- import demo from "../demo/video.ts";
206
+ import room from "../room/room.ts";
207
+ import demo from "../demo/demo.ts";
209
208
 
210
209
  export default video({
211
210
  format: "16x9",
@@ -238,7 +237,7 @@ export default video({
238
237
  | `box` | the frame | `[x, y, w, h]` as fractions of the frame; the camera's aspect is the box's |
239
238
  | `background` | the scenery's own | A colour, or `"transparent"`; without it what `build` set as the scene's background, else transparent |
240
239
  | `time` | `{ from: 0 }` | The scenery's time from the film's: `{ from }` at the film's start, or `(filmT) => number`. It runs on across parts and cuts |
241
- | `quality` | `{ scale: 0.5, focusLevels: 8 }` | `scale`: the share of the layer's size each way it is drawn at (above 1 supersamples). `focusLevels`: Gaussian levels a screen's depth of field is mixed from. `SCENERY_LAYER_DEFAULTS` |
240
+ | `quality` | `{ scale: 1, focusLevels: 8 }` | `scale`: the share of the layer's size each way it is drawn at (above 1 supersamples; 0.5 for a quicker draft, softer). `focusLevels`: Gaussian levels a screen's depth of field is mixed from. `SCENERY_LAYER_DEFAULTS` |
242
241
  | `sensor` | none | A phone's sensor filming it: the moiré its Bayer grid makes of the screens' pixels. `{ photosites, lens, moire, chroma, distortion }`, `SENSOR_DEFAULTS` |
243
242
  | `screens` | none | `{ <object name>: screen(…) }` (below) |
244
243
  | `props` | none | `SceneryProp`s this layer brings in (below) |
@@ -247,7 +246,7 @@ export default video({
247
246
 
248
247
  `projectScenery(layer, target, t, el)`, called in a layer's `render` with its own element, gives where a point or a named object of the scenery layer called `layer` in the same part is at part time `t`: `{ x, y }` in frame px, `inView`, `depth` (m); undefined when no such layer shows then.
249
248
 
250
- **Props** (`SceneryProp`: `{ name, build(w), update?(object, t, w) }`) are things a layer brings in (a stand-in, a pointer): built after the scenery and its bake (never in it), posed from t after the scenery's update, shown only in the layers that add them. One a hand moves takes its path from the SDK's `pointer`, `tap` or `drag` ([layers.md](layers.md), "A person's input"), as the registry's `pointer-prop` does.
249
+ **Props** (`SceneryProp`: `{ name, build(w), update?(object, t, w) }`) are things a layer brings in (a stand-in, a pointing rod): built after the scenery and its bake (never in it), posed from t after the scenery's update, shown only in the layers that add them. One a hand moves takes its path from the SDK's `handPath`, `tap` or `drag` ([layers.md](layers.md), "A person's input"), as the registry's `pointing-prop` does.
251
250
 
252
251
  **A scenery inside another video.** A video item whose picture is a scenery can be shown in a film: `take(scene).range(from, to)` plays a stretch of it and `footage({ camera })` draws its scenery layers from a camera of the film's (`cameras` by layer name for several, `quality: { scale }` for this film only), on the item's clock. See [footage.md](footage.md) and [speech.md](speech.md).
253
252
 
@@ -264,11 +263,11 @@ export default video({
264
263
  | `size` | `[1920, 1080]` | Layers only: the content's pixels (a video uses its format's) |
265
264
  | `dur` | to the layer's end | Layers only |
266
265
  | `background` | `"#000000"` | Behind the content, or `"transparent"` |
267
- | `pixels` | `{ density: 2, rows: 0.15 }` | Its physical pixels, for a sensor's moiré (`PANEL_DEFAULTS`) |
266
+ | `pixels` | `{ density: 2, rows: 0.15, mesh: 0.09 }` | Its physical pixels, for a sensor's moiré, and `mesh` (0–1, 0 none): the fine grid of faint lines a phone close to a screen shows, every three of its pixels (`PANEL_DEFAULTS`) |
268
267
  | `glass` | none | `{ reflectance?, roughness?, scale? }`: what its glass reflects of the scenery over its picture, by Fresnel; `{}` the defaults (`GLASS_DEFAULTS`) |
269
268
  | `inScenery` | `true` | Drawn in the scenery: `{ brightness?, light? }` (below); `false`: laid over the scenery |
270
269
 
271
- ```ts file=demo/video.ts
270
+ ```ts file=demo/demo.ts
272
271
  import { custom, part, video } from "@allyhub/sdk";
273
272
 
274
273
  // Made only to be shown on a screen.