@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
@@ -45,12 +45,38 @@ export declare const INPUT_DEFAULTS: {
45
45
  };
46
46
  seed: number;
47
47
  };
48
+ /**
49
+ * A mouse's cursor: a hand's movement without its errors (no overshoot,
50
+ * scatter, lateness, bow, tremor or variation from move to move), timed
51
+ * by the same Fitts' law; and the seconds it rests after a click before
52
+ * it moves on.
53
+ */
54
+ cursor: {
55
+ reach: {
56
+ overshoot: number;
57
+ peak: number;
58
+ vary: number;
59
+ fitts: {
60
+ a: number;
61
+ b: number;
62
+ };
63
+ scatter: number;
64
+ jitter: number;
65
+ bow: number;
66
+ tremor: {
67
+ px: number;
68
+ frequency: number;
69
+ };
70
+ seed: number;
71
+ };
72
+ after: number;
73
+ };
48
74
  /** A target's size when a step gives none, px. */
49
75
  size: number;
50
- /** Seconds the pointer rests on a target before it presses, and a press's hold. */
76
+ /** Seconds a cursor or a hand rests on a target before it presses, and a press's hold. */
51
77
  dwell: number;
52
78
  hold: number;
53
- /** A drag: the finger's rest before it moves and after, s; its Fitts' b (a drag is slower than a move); its tremor while down. */
79
+ /** A drag: the rest after it is pressed and before it is let go, s; its Fitts' law (a drag is slower than a move); a finger's tremor while it is down. */
54
80
  drag: {
55
81
  settle: number;
56
82
  release: number;
@@ -131,12 +157,12 @@ export declare function reach(from: Point, to: Point, at: {
131
157
  size?: number;
132
158
  index?: number;
133
159
  }, opts?: ReachOptions): Movement;
134
- /** One step of a pointer: it lands on `to` by `at`, or presses there at `at`. */
135
- export interface PointerStep {
160
+ /** One step of a path: it lands on `to` by `at`, or presses there at `at`. */
161
+ export interface PathStep {
136
162
  /** Seconds: when it lands, or with `press`, when it presses. */
137
163
  at: number;
138
164
  to: Point;
139
- /** The target's size, px: how far it may land from its centre and how long the move takes. */
165
+ /** The target's size, px: how long the move takes (and, for a hand, how far it may land from its centre). */
140
166
  size?: number;
141
167
  /** It presses there (a click, or a finger's tap). */
142
168
  press?: boolean;
@@ -146,21 +172,36 @@ export interface PointerStep {
146
172
  dwell?: number;
147
173
  hold?: number;
148
174
  }
149
- export interface PointerOptions extends ReachOptions {
175
+ /** One step of a cursor: a path's step, and how long it rests after its click. */
176
+ export interface CursorStep extends PathStep {
177
+ /** Seconds it rests after this click before it moves on; default the cursor's `after`. */
178
+ after?: number;
179
+ }
180
+ export interface HandPathOptions extends ReachOptions {
181
+ /** Where it is before its first step. */
182
+ from: Point;
183
+ steps: readonly PathStep[];
184
+ dwell?: number;
185
+ hold?: number;
186
+ }
187
+ export interface CursorOptions extends ReachOptions {
150
188
  /** Where it is before its first step. */
151
189
  from: Point;
152
- steps: readonly PointerStep[];
190
+ steps: readonly CursorStep[];
153
191
  dwell?: number;
154
192
  hold?: number;
193
+ /** Seconds it rests after a click before it moves on (`INPUT_DEFAULTS.cursor.after`). */
194
+ after?: number;
155
195
  }
156
- export interface PointerState {
196
+ export interface InputState {
157
197
  x: number;
158
198
  y: number;
159
199
  /** Pressed at that moment. */
160
200
  down: boolean;
161
201
  }
162
- export interface Pointer {
163
- at: (t: number) => PointerState;
202
+ /** Where a cursor or a hand is over time. */
203
+ export interface InputPath {
204
+ at: (t: number) => InputState;
164
205
  /** Each move, in order. */
165
206
  moves: readonly Movement[];
166
207
  /** Each press: when it goes down and comes up, and where. */
@@ -171,13 +212,23 @@ export interface Pointer {
171
212
  }[];
172
213
  }
173
214
  /**
174
- * A pointer (a mouse's, or a finger hovering a screen) going from place to
175
- * place: each step an aimed movement that lands on its target by its
176
- * moment, resting `dwell` before a press, which goes down at the step's
177
- * moment and up `hold` later (each drawn a little differently); a hand's
178
- * tremor on it throughout.
215
+ * A mouse's cursor going from place to place: each step a glide that lands
216
+ * where it is aimed by its moment (timed by Fitts' law, with none of a
217
+ * hand's overshoot, scatter, bow or tremor), resting `dwell` before a
218
+ * click, which goes down at the step's moment and up `hold` later, and
219
+ * resting `after` before it moves on. A hand's errors are options
220
+ * (`overshoot`, `scatter`, `bow`, `tremor`…), none by default.
221
+ */
222
+ export declare function cursor(opts: CursorOptions): InputPath;
223
+ /**
224
+ * A hand's path from place to place (a finger hovering a screen, or a
225
+ * thing a hand holds to it): each step an aimed movement that lands on its
226
+ * target by its moment, a little past it and back and a little off,
227
+ * resting `dwell` before a press, which goes down at the step's moment and
228
+ * up `hold` later (each drawn a little differently); a hand's tremor on it
229
+ * throughout.
179
230
  */
180
- export declare function pointer(opts: PointerOptions): Pointer;
231
+ export declare function handPath(opts: HandPathOptions): InputPath;
181
232
  export interface TapOptions {
182
233
  /** When the finger touches, s. */
183
234
  at: number;
@@ -197,7 +248,7 @@ export interface Tap {
197
248
  /** When it touches and when it lifts: a phone highlights on the first and acts on the second. */
198
249
  down: number;
199
250
  up: number;
200
- at: (t: number) => PointerState & {
251
+ at: (t: number) => InputState & {
201
252
  /** How much of the fingertip touches, 0 to 1. */
202
253
  contact: number;
203
254
  };
@@ -205,6 +256,8 @@ export interface Tap {
205
256
  /** A finger's tap: down at its moment, a little off the target's centre, sliding a little, up after its hold. */
206
257
  export declare function tap(opts: TapOptions): Tap;
207
258
  export interface DragOptions extends ReachOptions {
259
+ /** A mouse's (the default: a cursor's glide, still while the button is down) or a finger's on a screen (a hand's movement, trembling while it is down). */
260
+ by?: "mouse" | "finger";
208
261
  /** Where it is pressed and where it is let go. */
209
262
  from: Point;
210
263
  to: Point;
@@ -214,7 +267,7 @@ export interface DragOptions extends ReachOptions {
214
267
  duration?: number;
215
268
  /** The target's size, px (how far from it it lands, and how long it takes). */
216
269
  size?: number;
217
- /** Seconds the finger rests after it is pressed and before it is let go. */
270
+ /** Seconds it rests after it is pressed and before it is let go. */
218
271
  settle?: number;
219
272
  release?: number;
220
273
  index?: number;
@@ -227,12 +280,13 @@ export interface Drag {
227
280
  up: number;
228
281
  /** Where it is let go. */
229
282
  to: Point;
230
- at: (t: number) => PointerState;
283
+ at: (t: number) => InputState;
231
284
  }
232
285
  /**
233
- * A drag: pressed at its moment, a rest, then an aimed movement to the
234
- * target (a quick start, a longer settle, past it and back), a rest, and
235
- * let go; a hand's tremor on it while it is down.
286
+ * A drag: pressed at its moment, a rest, then a movement to the target, a
287
+ * rest, and let go. A mouse's glides there and lands where it is aimed; a
288
+ * finger's is a hand's (a quick start, a longer settle, past it and back),
289
+ * with a tremor while it is down.
236
290
  */
237
291
  export declare function drag(opts: DragOptions): Drag;
238
292
  export interface ScrollOptions {
@@ -0,0 +1,2 @@
1
+ /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
+ import{aimAt as S,aimShape as N,bandNoise as q,unit3 as v}from"@allyhub/scenery";export const INPUT_DEFAULTS={reach:{overshoot:.06,peak:.38,vary:.5,fitts:{a:.2,b:.15},scatter:.1,jitter:.02,bow:.06,tremor:{px:.3,frequency:9},seed:1},cursor:{reach:{overshoot:0,peak:.38,vary:0,fitts:{a:.2,b:.15},scatter:0,jitter:0,bow:0,tremor:{px:0,frequency:9},seed:1},after:.3},size:40,dwell:.12,hold:.1,drag:{settle:.08,release:.06,fitts:{a:.25,b:.2},tremor:{px:.8,frequency:8}},tap:{slide:1.2,grow:.03},wheel:{notch:100,animate:.15,interval:.05,pause:.25,burst:4},flick:{contact:.12,decay:.4995,band:800,spring:.12},typing:{cps:9,spread:.35,word:1.5,mark:2,think:{chance:.08,seconds:.35},notice:.3,backspace:.07,seed:1}};function z(t,r=INPUT_DEFAULTS.reach){return{...r,...t,fitts:{...r.fitts,...t?.fitts},tremor:{...r.tremor,...t?.tremor}}}const k=(t,r,o)=>2*v(t,r,o)-1,p=(t,r,o)=>Math.sqrt(-2*Math.log(v(t,r,o)))*Math.cos(2*Math.PI*v(t^625341585,r,o));export function reachProblem(t,r){const o=[["scatter",t.scatter],["jitter",t.jitter],["bow",t.bow],["vary",t.vary],["fitts.a",t.fitts?.a],["fitts.b",t.fitts?.b],["tremor.px",t.tremor?.px],["tremor.frequency",t.tremor?.frequency]];for(const[e,a]of o)if(a!==void 0&&!(Number.isFinite(a)&&a>=0))return`${r}'s ${e} is a number from 0, not ${String(a)}`;if(t.overshoot!==void 0&&!(t.overshoot>=-.5&&t.overshoot<=1))return`${r}'s overshoot is a share from -0.5 to 1, not ${String(t.overshoot)}`;if(t.peak!==void 0&&!(t.peak>=.15&&t.peak<=.6))return`${r}'s peak is a share from 0.15 to 0.6, not ${String(t.peak)}`;if(t.seed!==void 0&&!Number.isInteger(t.seed))return`${r}'s seed is a whole number, not ${String(t.seed)}`}export function fittsTime(t,r,o={}){const e={...INPUT_DEFAULTS.reach.fitts,...o};return e.a+e.b*Math.log2(1+t/Math.max(1,r))}export function reach(t,r,o,e={}){const a=reachProblem(e,"reach");if(a)throw new Error(a);const i=z(e),h=o.index??0,l=o.size??INPUT_DEFAULTS.size,m=[r[0]+i.scatter*l*p(i.seed,h,11),r[1]+i.scatter*l*p(i.seed,h,12)],w=m[0]-t[0],y=m[1]-t[1],d=Math.hypot(w,y),s=Math.max(.05,(o.duration??fittsTime(d,l,i.fitts))*(1+.15*i.vary*k(i.seed,h,13))),n=o.end+i.jitter*p(i.seed,h,14),c=n-s,f=N({overshoot:i.overshoot,peak:i.peak,vary:i.vary,seed:i.seed,index:h}),u=i.bow*k(i.seed,h,15);return{start:c,end:n,from:t,to:m,bow:u,progress:b=>S(f,b),at(b){if(b<=c)return t;if(b>=n)return m;const g=(b-c)/s,x=S(f,g),M=u*Math.sin(Math.PI*Math.min(1,g));return[t[0]+w*x-y*M,t[1]+y*x+w*M]}}}function E(t,r,o){if(o.px<=0)return()=>[0,0];const e={center:o.frequency,spread:o.frequency/5},a=q(t+r*31,101,e),i=q(t+r*31,102,e);return h=>[o.px*a(h),o.px*i(h)]}function I(t,r,o){const e=z(t,r),a=t.dwell??INPUT_DEFAULTS.dwell,i=t.hold??INPUT_DEFAULTS.hold,h=[],l=[];let m=t.from,w=-1/0;for(const[d,s]of t.steps.entries()){const n=s.press?(s.dwell??a)*(1+.4*e.vary*k(e.seed,d,21)):0,c=s.size??INPUT_DEFAULTS.size,f=s.at-n,u=s.duration??fittsTime(Math.hypot(s.to[0]-m[0],s.to[1]-m[1]),c,e.fitts),b=f-u<w?Math.max(.1,f-w):s.duration,g=reach(m,s.to,{end:f,...b===void 0?{}:{duration:b},size:c,index:d},e);if(h.push(g),s.press){const x=(s.hold??i)*(1+.4*e.vary*k(e.seed,d,22));l.push({down:s.at,up:s.at+x,at:g.to}),o&&(w=s.at+x+o(s))}m=g.to}const y=E(e.seed,0,e.tremor);return{moves:h,presses:l,at(d){let s=t.from;for(const f of h)d>=f.start&&(s=f.at(d));const[n,c]=y(d);return{x:s[0]+n,y:s[1]+c,down:l.some(f=>d>=f.down&&d<f.up)}}}}export function cursor(t){const r=reachProblem(t,"cursor");if(r)throw new Error(r);const o=INPUT_DEFAULTS.cursor,e=t.after??o.after;if(!(Number.isFinite(e)&&e>=0))throw new Error(`cursor's after is a number of seconds from 0, not ${String(e)}`);return I(t,o.reach,a=>a.after??e)}export function handPath(t){const r=reachProblem(t,"handPath");if(r)throw new Error(r);return I(t,INPUT_DEFAULTS.reach,void 0)}export function tap(t){const r=t.seed??INPUT_DEFAULTS.reach.seed,o=t.index??0,e=t.size??INPUT_DEFAULTS.size,a=t.scatter??INPUT_DEFAULTS.reach.scatter,i=t.slide??INPUT_DEFAULTS.tap.slide,h=t.grow??INPUT_DEFAULTS.tap.grow,l=(t.hold??INPUT_DEFAULTS.hold)*(1+.3*k(r,o,31)),m=t.to[0]+a*e*p(r,o,32),w=t.to[1]+a*e*p(r,o,33),y=2*Math.PI*v(r,o,34),d=t.at,s=d+l;return{down:d,up:s,at(n){const c=Math.min(1,Math.max(0,(n-d)/l)),f=i*(c*c*(3-2*c)),u=n>=d&&n<s,b=u?Math.min(1,(n-d)/h,(s-n)/h):0;return{x:m+f*Math.cos(y),y:w+f*Math.sin(y),down:u,contact:b}}}}const P=["mouse","finger"];export function drag(t){const r=reachProblem(t,"drag");if(r)throw new Error(r);if(t.by!==void 0&&!P.includes(t.by))throw new Error(`drag's by is "mouse" or "finger", not ${JSON.stringify(t.by)}`);const o=INPUT_DEFAULTS.drag,e=t.by==="finger",a=z(t,{...e?INPUT_DEFAULTS.reach:INPUT_DEFAULTS.cursor.reach,fitts:o.fitts,tremor:e?o.tremor:INPUT_DEFAULTS.cursor.reach.tremor}),i=t.index??0,h=(t.settle??o.settle)*(1+.4*a.vary*k(a.seed,i,41)),l=(t.release??o.release)*(1+.4*a.vary*k(a.seed,i,42)),m=t.size??INPUT_DEFAULTS.size,w=Math.hypot(t.to[0]-t.from[0],t.to[1]-t.from[1]),y=t.duration??fittsTime(w,m,a.fitts),d=reach(t.from,t.to,{end:t.at+h+y,duration:y,size:m,index:i},{...a,jitter:0}),s=E(a.seed,i+1e3,a.tremor),n=d.end+l;return{down:t.at,start:d.start,end:d.end,up:n,to:d.to,at(c){const f=d.at(c),u=c>=t.at&&c<n,b=u?Math.min(1,(c-t.at)/.05,(n-c)/.05):0,[g,x]=s(c);return{x:f[0]+b*g,y:f[1]+b*x,down:u}}}}export function scroll(t){const r=t.seed??INPUT_DEFAULTS.reach.seed,o=t.index??0,e=t.by<0?-1:1;if((t.kind??"flick")==="wheel"){const n={...INPUT_DEFAULTS.wheel,...t.wheel},c=Math.max(1,Math.round(Math.abs(t.by)/n.notch)),f=t.by/c,u=[];let b=t.at;for(let x=0;x<c;x++){u.push(b);const M=(x+1)%Math.max(1,n.burst)===0?n.pause:n.interval;b+=M*(1+.4*k(r,o*997+x,51))}const g=x=>1-(1-x)**3;return{start:t.at,end:(u.at(-1)??t.at)+n.animate,at(x){let M=0;for(const $ of u)x>$&&(M+=f*g(Math.min(1,(x-$)/n.animate)));return M}}}const a={...INPUT_DEFAULTS.flick,...t.flick},i=a.contact*(1+.3*k(r,o,52)),h=Math.abs(t.by)/(i/2+a.decay),l=h*i/2,m=t.at+i,w=n=>{if(n<=t.at)return 0;if(n<=m){const c=(n-t.at)/i;return l*c*c}return l+h*a.decay*(1-Math.exp(-(n-m)/a.decay))},y=t.limit===void 0?1/0:Math.abs(t.limit);let d=1/0;Math.abs(t.by)>y&&(y<=l?d=t.at+i*Math.sqrt(y/l):d=m-a.decay*Math.log(1-(y-l)/(h*a.decay)));const s=n=>(1-1/(n*.55/a.band+1))*a.band;return{start:t.at,end:m+a.decay*5,at(n){const c=w(n);if(c<=y)return e*c;const f=Math.max(0,n-d),u=(1+f/a.spring)*Math.exp(-f/a.spring);return e*(y+s(c-y)*u)}}}const j=t=>t!==void 0&&/[\p{L}\p{N}]/u.test(t);export function typing(t,r){const o=INPUT_DEFAULTS.typing,e={...o,...r,think:{...o.think,...r.think}};if(!(e.cps>0))throw new Error(`typing's cps is above 0, not ${String(e.cps)}`);const a=Array.from(t),i=[],h=[];let l=e.at,m=0;const w=(s,n)=>{const c=1/e.cps,f=e.spread,u=p(e.seed,m,61);let b=c*Math.exp(f*u-f*f/2);return!j(s)&&j(n)&&(b*=e.word,v(e.seed,m,62)<e.think.chance&&(b+=e.think.seconds)),s!==void 0&&/[.,;:!?。,、!?]/u.test(s)&&(b*=e.mark),b},y=(s,n,c)=>{i.length>0&&(l+=c??w(s,n)),i.push({t:l,key:n}),m++};let d;for(const[s,n]of a.entries()){for(const c of e.mistakes??[]){if(c.at!==s)continue;const f=Array.from(c.typed);for(const u of f)y(d,u),d=u;l+=e.notice*(1+.3*k(e.seed,m,63));for(let u=0;u<f.length;u++)y(d,"Backspace",u===0?0:e.backspace);d=a[s-1]}y(d,n),h[s]=l,d=n}return{keys:i,times:h,end:l,text(s){let n=[];for(const c of i){if(c.t>s)break;c.key==="Backspace"?n=n.slice(0,-1):n.push(c.key)}return n.join("")}}}
@@ -1,22 +1,24 @@
1
1
  import * as free from "./free.js";
2
2
  import { type FootageFn, type PartFn, type TakeFn } from "./parts.js";
3
+ import { type PictureFn } from "@allyhub/image-sdk/picture";
3
4
  import { type VideoFn } from "./piece.js";
4
- import { type SdkModule } from "./written.js";
5
- export type { SdkModule } from "./written.js";
5
+ import { type SdkModule } from "@allyhub/image-sdk/written";
6
+ export type { SdkModule } from "@allyhub/image-sdk/written";
6
7
  /** The functions that name files, and so are made for a module. */
7
- export declare const BOUND: readonly ["video", "part", "take", "footage"];
8
+ export declare const BOUND: readonly ["video", "part", "take", "footage", "picture"];
8
9
  /** The functions sdkFor makes for a module. */
9
10
  export interface BoundSdk {
10
11
  video: VideoFn;
11
12
  part: PartFn;
12
13
  take: TakeFn;
13
14
  footage: FootageFn;
15
+ picture: PictureFn;
14
16
  }
15
17
  /** The whole authoring API, bound to one module. */
16
18
  export type Sdk = typeof free & BoundSdk;
17
19
  /**
18
20
  * The authoring API for the module `module.file` (a project path; "" the
19
- * project's root): the paths its parts, takes, footage and pieces name
21
+ * project's root): the paths its parts, takes, footage, pictures and pieces name
20
22
  * are from that module's folder.
21
23
  */
22
24
  export declare function sdkFor(module: SdkModule): Sdk;
@@ -0,0 +1,2 @@
1
+ /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
+ import*as e from"./free.js";import{footageFor as i,partFor as p,takeFor as a}from"./parts.js";import{pictureFor as f}from"@allyhub/image-sdk/picture";import{videoFor as m}from"./piece.js";import{writtenIn as n}from"@allyhub/image-sdk/written";export const BOUND=["video","part","take","footage","picture"];export function sdkFor(r){const o=n(r),t={video:m(o),part:p(o),take:a(o),footage:i(o),picture:f(o)};return{...e,...t}}
@@ -1,7 +1,11 @@
1
- import { type VoiceSetting, type FootageLayer, type FootageOptions, type LayerSpec, type MediaRef, type PartAnchors, type PartSpec, type RoomTone, type SaySpeech, type SoundSpec, type SpeechSpec, type TakeSpeech, type TransitionInput, type VideoSpeech, type WordRef } from "@allyhub/video-core";
2
- import type { Written } from "./written.js";
1
+ import { type WordRef } from "@allyhub/piece";
2
+ import { type VoiceSetting, type FootageLayer, type FootageOptions, type LayerSpec, type MediaRef, type PartAnchors, type PartSpec, type RoomTone, type SaySpeech, type SoundSpec, type SpeechSpec, type TakeSpeech, type TransitionInput, type VideoSpeech } from "@allyhub/video-core";
3
+ import { type GraphicLayer } from "@allyhub/piece";
4
+ import type { Written } from "@allyhub/image-sdk/written";
5
+ import { type PictureProps } from "@allyhub/image-sdk/picture";
3
6
  import { type VideoItem } from "./piece.js";
4
- export type { BoxKey, FootageBackground, FootageBox, PerOrient, PunchIn, Pullback, Reframe, FootageLayer, FootageOptions, GraphicLayer, LayerSpec, LayerSpec as Layer, LayerTiming, PartAnchors, PartSpec, Rect, RoomTone, SaySpeech, SoundSpec, SpeechSpec, TakeSpeech, VideoSpeech, Direction, TransitionChannel, TransitionInput, TransitionPicture, TransitionSpec, TransitionType, WordRef, } from "@allyhub/video-core";
7
+ export type { GraphicLayer, LayerTiming, WordRef } from "@allyhub/piece";
8
+ export type { BoxKey, FootageBackground, FootageBox, PerOrient, PunchIn, Pullback, Reframe, FootageLayer, FootageOptions, LayerSpec, LayerSpec as Layer, PartAnchors, PartSpec, Rect, RoomTone, SaySpeech, SoundSpec, SpeechSpec, TakeSpeech, VideoSpeech, Direction, TransitionChannel, TransitionInput, TransitionPicture, TransitionSpec, TransitionType, } from "@allyhub/video-core";
5
9
  export interface PartOptions {
6
10
  /** Unique in the output; stable across combos. */
7
11
  key: string;
@@ -182,7 +186,7 @@ export interface VideoTake extends VideoSpeech {
182
186
  export interface SayOptions {
183
187
  /** The voice tool's voice id. */
184
188
  voice?: string;
185
- /** The voice tool; default speech-elevenlabs-multilingual-v2. */
189
+ /** The voice tool; default speak. */
186
190
  tool?: string;
187
191
  /**
188
192
  * More input for the voice tool, as plain JSON: the fields its schema
@@ -208,9 +212,14 @@ export interface SayOptions {
208
212
  export declare function say(text: string, opts?: SayOptions): SaySpeech;
209
213
  /**
210
214
  * A video on the part: footage("./broll.mp4", { at: "inbox", dur: 1.5 }).
211
- * Without a file it is the part's own take, in sync with its speech.
215
+ * Without a file it is the part's own take, in sync with its speech. A
216
+ * still (an image) is drawn as picture() draws it.
212
217
  */
213
- export type FootageFn = (file?: MediaRef | VideoItem | FootageOptions, opts?: FootageOptions) => FootageLayer;
218
+ export interface FootageFn {
219
+ (opts?: FootageOptions): FootageLayer;
220
+ (video: VideoItem, opts?: FootageOptions): FootageLayer;
221
+ (file: MediaRef, opts?: FootageOptions): FootageLayer | GraphicLayer<PictureProps>;
222
+ }
214
223
  /** footage() for the module `at` names: its paths are from its folder. */
215
224
  export declare const footageFor: (at: Written) => FootageFn;
216
225
  //# sourceMappingURL=parts.d.ts.map
@@ -0,0 +1,2 @@
1
+ /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
+ import{shapeProblem as T,voiceProblem as _}from"@allyhub/audio";import{LAYER_BRAND as h}from"@allyhub/piece";import{BACKDROP_BLUR_MAX as $,EASES as E,MATTE_FEATHER_MAX as S,MATTE_SHRINK_MAX as m,ORIENT_KEYS as N,PART_BRAND as M,SPEECH_BRAND as g,isPerOrient as Y,notJson as G,partAnchorsProblem as C,speechSpeedProblem as x,transitionProblem as L}from"@allyhub/video-core";import{MEDIA_BRAND as K,mediaKindOf as q}from"@allyhub/piece";import{pictureLayer as H}from"@allyhub/image-sdk/picture";import{enginePiece as O,isItemPiece as j}from"./piece.js";export const partFor=r=>e=>{const{key:t,layers:n,...i}=e;if(typeof t!="string"||t==="")throw new Error("part: every part needs a key");if(i.title!==void 0&&(typeof i.title!="string"||i.title.trim()===""))throw new Error(`part ${t}: title is a name, not ${JSON.stringify(i.title)}`);for(const a of["before","after"]){const s=e.overlap?.[a];if(s!==void 0&&(!Number.isFinite(s)||s<0||s>10))throw new Error(`part ${t}: overlap.${a} is seconds from 0 to 10, not ${String(s)}`)}for(const[a,s]of(e.sounds??[]).entries()){if(!(typeof s=="object"&&(typeof s.at=="string"||typeof s.at=="number")&&(typeof s.sound=="string"||typeof s.sound=="object"&&"path"in s.sound)))throw new Error(`part ${t}: sounds[${String(a)}] is { at, sound, gainDb? }: at a word reference or seconds, sound a name or an audio file`);if(s.gainDb!==void 0&&(!Number.isFinite(s.gainDb)||s.gainDb<-60||s.gainDb>24))throw new Error(`part ${t}: sounds[${String(a)}].gainDb is dB from -60 to 24, not ${String(s.gainDb)}`);if(s.shape!==void 0){const f=T(s.shape);if(f!==void 0)throw new Error(`part ${t}: sounds[${String(a)}].shape: ${f}`)}}if(e.speechGainDb!==void 0&&(typeof e.speechGainDb!="number"||!Number.isFinite(e.speechGainDb)||e.speechGainDb<-40||e.speechGainDb>24))throw new Error(`part ${t}: speechGainDb is dB from -40 to 24, not ${String(e.speechGainDb)}`);if(e.anchors!==void 0){const a=C(e.anchors);if(a!==void 0)throw new Error(`part ${t}: anchors ${a}`)}if(e.transition!==void 0){const a=L(e.transition);if(a!==void 0)throw new Error(`part ${t}: transition ${a}`)}if(e.mic!==void 0){const a=_(e.mic);if(a!==void 0)throw new Error(`part ${t}: ${a}`)}if(e.post!==void 0){const a=e.post.filter;if(typeof a!="string"||a.trim()==="")throw new Error(`part ${t}: post: post is { filter: an ffmpeg filter chain }`)}const o=e.speech?.kind==="take"||e.speech?.kind==="say"?e.speech.tempo??1:1;if(o!==1&&(n??[]).some(a=>a[h]==="footage"&&a.file===void 0&&a.video===void 0))throw new Error(`part ${t}: footage() shows the part's take, which plays at speed ${String(o)}; a take's picture is drawn only at its own speed. Play the take at speed 1, or show other footage.`);return{[M]:!0,key:t,layers:n??[],...i,base:r.base}};function b(r,...e){const t={...r};for(const n of e)Reflect.deleteProperty(t,n);return t}function A(r,e){const t=i=>A(r,i);return{...{[g]:!0,...e},range(i,o){const a=b(e,"line","from","to");return t({...a,from:i,...o===void 0?{}:{to:o}})},saying(i){return t({...b(e,"from","to"),line:i})},edits(i){if(typeof i!="string"||!/\.json$/i.test(i))throw new Error(`take(…).edits(path): a JSON file relative to the file that names it, such as "./edits/host.json" (not ${JSON.stringify(i)})`);return t({...e,editsFile:i,editsBase:r.base})},speed(i){const o=x(i);if(o!==void 0)throw new Error(`take(…).speed(times): ${o}`);const a=b(e,"tempo");return t(i===1?a:{...a,tempo:i})},denoise(i=12){if(!Number.isFinite(i)||i<=0||i>97)throw new Error(`take(…).denoise(db): the noise reduction in dB, over 0 and up to 97 (not ${String(i)})`);return t({...e,denoiseDb:i})},roomTone(i){if(i===!1)return t({...e,room:!1});const o="take(…).roomTone(tone): false, or { from, to, match, gainDb, limitDb, fade }";if(typeof i!="object"||Array.isArray(i))throw new Error(`${o} (not ${JSON.stringify(i)})`);const{from:a,to:s,match:d,gainDb:f,limitDb:u,fade:c}=i,k=Object.keys(i).filter(R=>!["from","to","match","gainDb","limitDb","fade"].includes(R));if(k.length>0)throw new Error(`${o}: it has no ${k.join(", ")}`);if((a!==void 0||s!==void 0)&&(a===void 0||s===void 0||!Number.isFinite(a)||!Number.isFinite(s)||a<0||s-a<.05))throw new Error(`${o}: from and to are seconds of the file, both given, at least 0.05 s apart`);if(d!==void 0&&typeof d!="boolean")throw new Error(`${o}: match is true or false`);if(f!==void 0&&(!Number.isFinite(f)||f<-60||f>24))throw new Error(`${o}: gainDb is dB from -60 to 24, not ${String(f)}`);if(u!==void 0&&(!Number.isFinite(u)||u<0||u>60))throw new Error(`${o}: limitDb is dB from 0 to 60, not ${String(u)}`);if(c!==void 0&&(!Number.isFinite(c)||c<0||c>1))throw new Error(`${o}: fade is seconds from 0 to 1, not ${String(c)}`);return t({...e,room:{...a===void 0||s===void 0?{}:{from:a,to:s},...d===void 0?{}:{match:d},...f===void 0?{}:{gainDb:f},...u===void 0?{}:{limitDb:u},...c===void 0?{}:{fade:c}}})}}}export function takeFor(r){function e(t){return j(t)?J({kind:"video",piece:O(t)}):A(r,{kind:"take",file:t,...typeof t=="string"?{fileBase:r.base}:{}})}return e}const D=r=>typeof r=="number"&&Number.isFinite(r)&&r>=0||typeof r=="string"&&r.trim()!=="";function J(r){return{[g]:!0,...r,range(e,t){for(const[n,i]of[["from",e],["to",t]])if(i!==void 0&&!D(i))throw new Error(`take(video).range(from, to): ${n} is seconds from 0, an anchor ("@turn") or a part's key (not ${JSON.stringify(i)}).`);if(typeof e=="number"&&typeof t=="number"&&!(t>e))throw new Error(`take(video).range(${String(e)}, ${String(t)}): to comes after from.`);return J({...r,from:e,...t===void 0?{}:{to:t}})}}}export function say(r,e={}){if(e.speed!==void 0){const n=x(e.speed);if(n!==void 0)throw new Error(`say(): ${n}`)}const t=e.params;if(t!==void 0){if(typeof t!="object"||t===null||Array.isArray(t))throw new Error("say() params is not an object: give the voice tool's extra input as { name: value }.");const n=G(t,"params");if(n!==void 0)throw new Error(`say() ${n} is not plain JSON: use strings, finite numbers, booleans, null, arrays and plain objects.`);for(const[i,o]of[["text","say()'s text"],["voiceId","the voice option"]])if(i in t)throw new Error(`say() params.${i} is not allowed: give it as ${o}.`)}return{[g]:!0,kind:"say",text:r,...e.voice===void 0?{}:{voice:e.voice},...e.tool===void 0?{}:{tool:e.tool},...t&&Object.keys(t).length>0?{params:structuredClone(t)}:{},...e.speed===void 0||e.speed===1?{}:{tempo:e.speed}}}const l=r=>typeof r=="string"||typeof r=="object"&&r!==null&&(K in r||"sha256"in r),p=r=>typeof r=="number"&&Number.isFinite(r)&&r>=0&&r<=1;function w(r,e){if(e===void 0)return;if(!(typeof e=="object"&&e!==null&&p(e.x)&&p(e.y)))throw new Error(`footage() ${r} ${JSON.stringify(e)} is not a point { x, y } with each from 0 to 1.`)}function F(r,e){if(e!==void 0&&(typeof e!="number"||!(e>0)||e>30))throw new Error(`footage() ${r} ${JSON.stringify(e)} is not seconds over 0 and up to 30.`)}function v(r,e){if(!(e===void 0||E.includes(e)))throw new Error(`footage() ${r} ${JSON.stringify(e)} is not one of ${E.map(t=>`"${t}"`).join(", ")}.`)}function X(r){if(!(r===void 0||r==="face"||r==="center")){if(typeof r=="object"&&r!==null&&"face"in r){const e=r;if(e.face!==!0)throw new Error(`footage() reframe ${JSON.stringify(r)}: face is true, as in { face: true, faceY: 0.4 }.`);if(e.faceY!==void 0&&!p(e.faceY))throw new Error(`footage() reframe faceY ${JSON.stringify(e.faceY)} is not from 0 (the crop's top) to 1 (its bottom); 0.4 is a little above the middle.`);return}if(typeof r=="object"&&r!==null&&"x"in r){w("reframe",r);return}throw new Error(`footage() reframe ${JSON.stringify(r)} is not "face", { face: true, faceY }, "center" or a point { x, y }.`)}}function U(r){if(r===void 0)return;if(typeof r!="object"||r===null||Array.isArray(r))throw new Error(`footage() background ${JSON.stringify(r)} is not an object such as { blur: 24 }, { dim: 0.4, desaturate: 1 }, { color: "#101418" } or { image: "./backdrop.jpg" }.`);const e=r,t=["blur","dim","desaturate","color","image","feather","shrink"],n=Object.keys(e).find(o=>!t.includes(o));if(n!==void 0)throw new Error(`footage() background has no option "${n}": it takes ${t.join(", ")}.`);const i=o=>typeof o=="number"&&Number.isFinite(o);if(e.blur!==void 0&&!(i(e.blur)&&e.blur>=0&&e.blur<=$))throw new Error(`footage() background blur ${JSON.stringify(e.blur)} is not a number from 0 to ${String($)}: the blur's standard deviation in px at 1080p (24 is a soft room).`);for(const o of["dim","desaturate"])if(e[o]!==void 0&&!p(e[o]))throw new Error(`footage() background ${o} ${JSON.stringify(e[o])} is not a number from 0 (as it is) to 1.`);if(e.color!==void 0&&(typeof e.color!="string"||e.color.trim()===""))throw new Error(`footage() background color ${JSON.stringify(e.color)} is not a CSS colour such as "#101418", "var(--ak-color-bg)" or "transparent".`);if(e.image!==void 0&&!l(e.image))throw new Error(`footage() background image ${JSON.stringify(e.image)} is not an image: a path relative to the piece, or an imported file.`);if(e.color!==void 0&&e.image!==void 0)throw new Error("footage() background takes a color or an image, not both.");if(e.color!==void 0){const o=["blur","dim","desaturate"].find(a=>e[a]!==void 0);if(o!==void 0)throw new Error(`footage() background ${o} does nothing with a color, which replaces the background: leave one out.`)}if(e.feather!==void 0&&!(i(e.feather)&&e.feather>=0&&e.feather<=S))throw new Error(`footage() background feather ${JSON.stringify(e.feather)} is not a number from 0 to ${String(S)}: the softness of the person's edge in px at 1080p (2 by default).`);if(e.shrink!==void 0&&!(i(e.shrink)&&Math.abs(e.shrink)<=m))throw new Error(`footage() background shrink ${JSON.stringify(e.shrink)} is not a number from −${String(m)} to ${String(m)}: how far the person's edge is pulled in, px at 1080p (4 by default).`)}function I(r){if(r===void 0||r==="full"||!Array.isArray(r))return;const e=r.length>0&&typeof r[0]=="object"?r.map(n=>n.box):[r],t=1e-6;for(const n of e){if(n==="full"||!Array.isArray(n)||n.length!==4)continue;const[i,o,a,s]=n;if(!([i,o,a,s].every(d=>typeof d=="number"&&Number.isFinite(d))&&(i??0)>=-t&&(o??0)>=-t&&(a??0)>0&&(s??0)>0&&(i??0)+(a??0)<=1+t&&(o??0)+(s??0)<=1+t))throw new Error(`footage() box ${JSON.stringify(n)} is not inside the frame: [x, y, width, height] are fractions of it, with x + width and y + height at most 1. A box is where the picture shows, so it cannot grow past the frame; for a slow push in use punchIn, eased in over its \`in\` seconds centred on \`at\` ({ at: 4, in: 8, until: 8, scale: 1.07, ease: "linear" } pushes in over the first 8 s), and for a slow pull out pullback ({ scale: 1.07, dur: 8 }).`)}}function y(r,e){if(e===void 0)return[];if(!Y(e))return[e];const t=N,n=Object.keys(e).filter(i=>!t.includes(i));if(n.length>0)throw new Error(`footage() ${r} has ${n.map(i=>JSON.stringify(i)).join(", ")}, which is not a frame shape: a per-shape ${r} is { ${N.join(", ")} } (each optional; an output takes the one for its orientation, else default).`);return Object.values(e).filter(i=>i!==void 0)}function Q(r){const t=Array.isArray(r)?r:[],[n,i,o,a]=t;if(!(t.length===4&&typeof n=="number"&&typeof i=="number"&&typeof o=="number"&&typeof a=="number"&&[n,i,o,a].every(s=>Number.isFinite(s))&&n>=-1e-6&&i>=-1e-6&&o>0&&a>0&&n+o<=1+1e-6&&i+a<=1+1e-6))throw new Error(`footage() crop ${JSON.stringify(r)} is not a part of the source: [x, y, width, height] are fractions of it, with x + width and y + height at most 1.`)}function B(r){if(r===void 0)return;const e=r.scale;if(e!==void 0&&!(Number.isFinite(e)&&e>0&&e<=4))throw new Error(`footage() quality.scale ${String(e)} is outside (0, 4]: 0.5 is the fastest, 1 every pixel.`)}function V(r,e){const t=["crop","reframe","speaker","punchIn","sharpen","pullback","background","shape","radius"].filter(n=>e[n]!==void 0);if(t.length>0)throw new Error(`footage() of a video item takes at, until, dur, from, speed, box, fit, audio, gainDb, camera, cameras and quality; not ${t.join(", ")}.`);if(e.from!==void 0&&!D(e.from))throw new Error(`footage() from ${JSON.stringify(e.from)} is seconds from 0, an anchor ("@click") or a part's key of the video.`);if(e.speed!==void 0&&(!Number.isFinite(e.speed)||e.speed<=0||e.speed>16))throw new Error(`footage() speed ${String(e.speed)} is not a number over 0 and up to 16 (1 is normal speed).`);if(e.audio===!0&&e.speed!==void 0&&e.speed!==1)throw new Error("footage() of a video item plays its sound only at its own speed: speed 1, or audio off.");for(const n of y("box",e.box))I(n);return B(e.quality),{[h]:"footage",video:r,...e}}const z=r=>typeof r=="string"?q(r)==="image":r.kind==="image",P=["at","until","dur","box","fit","crop","reframe","shape","radius"];function W(r,e,t){const n=typeof r=="string"?r:r.path,i=Object.keys(e).filter(f=>!P.includes(f)&&e[f]!==void 0);if(i.length>0)throw new Error(`footage() of the still ${n} takes ${P.join(", ")}; not ${i.join(", ")}: a still has no time or sound of its own (picture() takes a mask, a blend and a filter).`);const o=e.box;if(o!==void 0&&o!=="full"&&!(Array.isArray(o)&&o.length===4&&typeof o[0]=="number"))throw new Error(`footage() of the still ${n}: box ${JSON.stringify(o)} is one rectangle [x, y, w, h] or "full", not keyframes or one per frame shape.`);const a=e.crop;if(a!==void 0&&!Array.isArray(a))throw new Error(`footage() of the still ${n}: crop ${JSON.stringify(a)} is one rectangle [x, y, w, h] of the source, not one per frame shape.`);const s=e.reframe;if(s==="face"||typeof s=="object"&&"face"in s)throw new Error(`footage() of the still ${n}: reframe "face" reads a face track, which a still does not have yet; give its focal point, reframe: { x, y }.`);const d=s===void 0?void 0:s==="center"?[.5,.5]:[s.x,s.y];return H({src:r,...e.at===void 0?{}:{at:e.at},...e.until===void 0?{}:{until:e.until},...e.dur===void 0?{}:{dur:e.dur},...o===void 0||o==="full"?{}:{box:o},...e.fit===void 0?{}:{fit:e.fit},...a===void 0?{}:{crop:a},...d===void 0?{}:{position:d},...e.shape==="circle"?{mask:"ellipse"}:{},...e.radius===void 0?{}:{radius:e.radius}},t,{at1080:!0,caller:"footage()"})}export const footageFor=r=>((e,t={})=>{if(j(e))return V(O(e),t);if(e!==void 0&&l(e)&&z(e))return W(e,t,r.base);const n=e!==void 0&&!l(e)?e:t;if(typeof n.from=="string")throw new Error(`footage() from ${JSON.stringify(n.from)}: a file's from is seconds; a reference is a video item's.`);if(B(n.quality),n.speed!==void 0&&(!Number.isFinite(n.speed)||n.speed<=0||n.speed>16))throw new Error(`footage() speed ${String(n.speed)} is not a number over 0 and up to 16 (1 is normal speed).`);if(n.sharpen!==void 0&&(!Number.isFinite(n.sharpen)||n.sharpen<0||n.sharpen>1))throw new Error(`footage() sharpen ${String(n.sharpen)} is not a number from 0 to 1 (0.3 is gentle).`);if(X(n.reframe),n.speaker!==void 0&&(!Number.isInteger(n.speaker)||n.speaker<0))throw new Error(`footage() speaker ${String(n.speaker)} is not a face id (a whole number from 0, as allyhub frames --overlay labels them).`);for(const o of n.punchIn??[]){const a=typeof o=="object"?o.scale:/@(\d*\.\d+)$/.exec(String(o))?.[1]!==void 0?Number(/@(\d*\.\d+)$/.exec(String(o))?.[1]):void 0;if(a!==void 0&&(!(a>1)||a>3))throw new Error(`footage() punchIn scale ${String(a)} is not over 1 and up to 3 (1.12 is a gentle punch-in).`);typeof o=="object"&&(F("punchIn in",o.in),F("punchIn out",o.out),v("punchIn ease",o.ease),w("punchIn center",o.center))}if(typeof n.pullback=="object"){const{scale:o,dur:a}=n.pullback;if(o!==void 0&&(!(o>1)||o>3))throw new Error(`footage() pullback scale ${String(o)} is not over 1 and up to 3 (1.12 is a gentle pullback).`);if(a!==void 0&&(!(a>0)||a>10))throw new Error(`footage() pullback dur ${String(a)} is not seconds over 0 and up to 10.`);v("pullback ease",n.pullback.ease),w("pullback center",n.pullback.center)}if(n.shape!==void 0&&n.shape!=="rect"&&n.shape!=="circle")throw new Error(`footage() shape ${JSON.stringify(n.shape)} is not "rect" or "circle".`);if(n.radius!==void 0&&(typeof n.radius!="number"||!Number.isFinite(n.radius)||n.radius<0))throw new Error(`footage() radius ${JSON.stringify(n.radius)} is not a number from 0: the corners' radius, px at 1080p (24 is a soft card corner).`);if(n.radius!==void 0&&n.radius>0&&n.shape==="circle")throw new Error('footage(): radius rounds the corners of a rect; shape "circle" has none. Use one of them.');const i=y("box",n.box);for(const o of i)I(o);for(const o of y("crop",n.crop))Q(o);if(U(n.background),i.some(o=>Array.isArray(o)&&o.length>0&&typeof o[0]=="object")&&(n.reframe!==void 0||n.punchIn?.length||n.pullback!==void 0&&n.pullback!==!1))throw new Error("footage(): a keyframed box cannot be reframed, punched in or pulled back; use a still box, or keyframes without reframe, punchIn and pullback.");return e!==void 0&&!l(e)?{[h]:"footage",...e,base:r.base}:{[h]:"footage",...e===void 0?{}:{file:e},...t,base:r.base}});
@@ -5,17 +5,24 @@ export type { Deeper } from "@allyhub/scenery";
5
5
  export interface PhoneCamera extends SceneryPhone {
6
6
  /** video({ capture }): the marks on the picture it records. */
7
7
  capture: CaptureOptions;
8
- /** video({ motionBlur }): the shutter's blur of what moves (a scenery's camera too). */
9
- motionBlur: MotionBlur;
8
+ /**
9
+ * video({ motionBlur }): the shutter's blur of what moves (a scenery's
10
+ * camera too). null by default: each sample draws the frame again (8 cost
11
+ * a phone-filmed short about three times its render), and a hand-held
12
+ * phone's moves barely show it.
13
+ */
14
+ motionBlur: MotionBlur | null;
10
15
  }
11
16
  /**
12
17
  * A phone's main camera filming a screen or a room indoors, held in a
13
18
  * hand: a 26 mm lens on its 4:3 frame at f/8 equivalent (f/1.8 on its
14
19
  * small sensor), a 12 MP sensor, a hand whose tremor its stabiliser mostly
15
20
  * takes out, focus that hunts after a cut, a reframe or a jolt, exposure
16
- * that follows a new framing late; grain stronger in the shadows and a
17
- * little coloured, a soft lens and the phone's sharpening; a half-frame
18
- * shutter.
21
+ * that follows a new framing late; fine grain, a little coloured, as strong
22
+ * on a screen's white as in its middle tones (faded in the whites, a
23
+ * screen reads as paper), a lens a little soft and the phone's sharpening
24
+ * on it, so text is crisp as a phone's photo of a screen shows it; no motion
25
+ * blur. Measured against phone photos of a laptop's screen (2026-11).
19
26
  */
20
27
  export declare const PHONE_CAMERA: PhoneCamera;
21
28
  /**
@@ -0,0 +1,2 @@
1
+ /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
+ import{PHONE_CAMERA as s}from"@allyhub/scenery";export const PHONE_CAMERA={...s,capture:{soften:.3,grain:{amount:.013,size:.75,shadows:2,highlights:1,chroma:.4,chromaSize:3},sharpen:.9,vignette:.2,bloom:{threshold:.92,radius:14,strength:.15}},motionBlur:null};const i=t=>typeof t=="object"&&t!==null&&!Array.isArray(t);function u(t,n){if(!i(t)||!i(n))return n===void 0?t:n;const o={...t};for(const[r,e]of Object.entries(n))o[r]=e===void 0?t[r]:u(t[r],e);return o}export function phoneCamera(t={}){return u(PHONE_CAMERA,t)}
@@ -1,11 +1,14 @@
1
- import { PIECE_BRAND, type PieceDefinition, type PartSpec, type PieceContext as StagePieceContext, type PieceWritten, type VideoOptions as StageVideoOptions } from "@allyhub/video-core";
2
- import type { FormatEntry, Matrix } from "@allyhub/video-core";
1
+ import { PIECE_BRAND } from "@allyhub/piece";
2
+ import { type PieceDefinition, type PartSpec, type PieceContext as StagePieceContext, type PieceWritten, type VideoOptions as StageVideoOptions } from "@allyhub/video-core";
3
+ import type { FormatEntry, Matrix } from "@allyhub/piece";
3
4
  import type { ConfigSchema } from "@allyhub/formats";
4
5
  import type { VideoConfigSchema } from "@allyhub/video-core";
5
6
  import type { z } from "zod";
6
- import type { MessageReader } from "./messages.js";
7
- import type { Written } from "./written.js";
8
- export type { Combo, Dims, Format, FormatEntry, FormatSpec, Matrix, MediaRef, MessageHint, MotionBlur, MusicOptions, PostProcess, CaptureOptions, PieceDefinition, PieceWritten, VideoPiece, } from "@allyhub/video-core";
7
+ import type { MessageReader } from "@allyhub/image-sdk/messages";
8
+ import type { Written } from "@allyhub/image-sdk/written";
9
+ export type { Combo, Dims, Format, FormatEntry, FormatSpec, Matrix, } from "@allyhub/piece";
10
+ export type { MediaRef, MotionBlur, MusicOptions, PostProcess, CaptureOptions, PieceDefinition, PieceWritten, VideoPiece, } from "@allyhub/video-core";
11
+ export type { MessageHint } from "@allyhub/piece";
9
12
  /**
10
13
  * allyhub.config.ts as a project writes it: the project's settings
11
14
  * (@allyhub/formats) with the look and the defaults every video
@@ -27,17 +30,23 @@ export interface VideoOptions extends Omit<StageVideoOptions, "covers"> {
27
30
  }
28
31
  /** What every piece has, whatever it makes. */
29
32
  export interface PieceOptions {
30
- /** A stable identity. Default: the item's folder, from the project's root. */
33
+ /** A stable identity. Default: its item's id, its file without its extension. */
31
34
  id?: string;
32
35
  /** A name for people. Default: messages `<id>.title`, else the file name. */
33
36
  title?: string | Record<string, string>;
34
37
  /**
35
- * What it is rendered as, one format: a preset (16x9, 9x16, 1x1, 4x5),
36
- * a platform profile (tiktok, reels…) or WIDTHxHEIGHT pixels; a4 and
37
- * letter are not a video's. It may be { format, safe, maxDuration,
38
- * loudness }: that format with its covered edges (any format), longest
39
- * length and loudness (a platform profile) changed; its name is still
40
- * the format's. Another format is a piece of its own, which imports what
38
+ * Its words, a file per language, from this module's folder: `{locale}`
39
+ * in its name stands for each (`./teaser.{locale}.yaml` is
40
+ * `teaser.en.yaml`, `teaser.zh-cn.yaml`), each a script (its title, what
41
+ * its parts say, its screen texts). Without it, it has no words of its
42
+ * own.
43
+ */
44
+ script?: string;
45
+ /**
46
+ * What it is rendered as, one format: a preset (16x9, 9x16, 1x1, 4x5)
47
+ * or WIDTHxHEIGHT pixels; a4 and letter are not a video's. It may be
48
+ * { format, safe }: that format with its covered edges changed; its
49
+ * name is still the format's. Another format is a piece of its own, which imports what
41
50
  * it shares (`video({ ...film, id, format })` reuses another piece's
42
51
  * parts, their paths still relative to where they were written).
43
52
  * Default: allyhub.config.ts `defaults.format`, else "16x9".
@@ -46,8 +55,9 @@ export interface PieceOptions {
46
55
  /**
47
56
  * The matrix: `dims` are dimensions and their values, crossed in full;
48
57
  * each combo is one value per dimension (`ctx.combo`). `lang` picks the
49
- * language of the item's scripts and assets/text/<lang>.json (the first
50
- * is the default); without it, the languages are the project's. `size`
58
+ * language of its script and assets/text/<lang>.json (the first is the
59
+ * default); without it, the languages are its script's and the
60
+ * project's shared words'. `size`
51
61
  * and `format` are not dimensions: the frame is `format`.
52
62
  */
53
63
  matrix?: Matrix;
@@ -87,7 +97,7 @@ export declare function isItemPiece(v: unknown): v is ItemPiece;
87
97
  * engine's, which the SDK's typed messages only narrow.
88
98
  */
89
99
  export declare function enginePiece(p: ItemPiece): PieceDefinition;
90
- /** A video: the default export of an item's video.ts. Its function returns its parts, in order. */
100
+ /** A video: the default export of a video's module. Its function returns its parts, in order. */
91
101
  export type VideoFn = (opts: VideoPieceOptions) => Video;
92
102
  /**
93
103
  * video() for the module `at` names. Its music's and its LUT's paths are
@@ -101,7 +111,7 @@ export declare const videoFor: (at: Written) => VideoFn;
101
111
  */
102
112
  export declare const definePiece: (opts: unknown) => never;
103
113
  /**
104
- * Gone: a deck is `presentation()` from `@allyhub/sdk/slides`, an item's slides.ts.
114
+ * Gone: a deck is `presentation()` from `@allyhub/sdk/slides`, a deck's module.
105
115
  * Calling it says so.
106
116
  */
107
117
  export declare const paged: (build: unknown, opts?: unknown) => never;
@@ -0,0 +1,2 @@
1
+ /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
+ import{PIECE_BRAND as f}from"@allyhub/piece";import{isPieceDefinition as a}from"@allyhub/video-core";import{shapeProblem as u,voiceProblem as m}from"@allyhub/audio";const d=e=>{throw new Error(e)},p="A video's module exports one video: export default video({ format, parts: (ctx) => [ part(…), … ] }). A second video (a cut-down, another format) is an item of its own, which imports what it shares.";export function isItemPiece(e){return a(e)}export function enginePiece(e){return e}const l=["music","post","script"];export const videoFor=e=>t=>{if((typeof t=="function"||typeof t.parts!="function")&&d(p),t.mic!==void 0){const i=m(t.mic);if(i!==void 0)throw new Error(`video: ${i}`)}const r=t.music;if(r!==void 0&&typeof r!="string"&&!("path"in r)){const i=Object.fromEntries(["filter","eq","compress"].filter(o=>r[o]!==void 0).map(o=>[o,r[o]])),n=u(i,!0);if(n!==void 0)throw new Error(`video: music: ${n}`)}const c=t.written?.paths,s={};for(const i of l){const n=t[i];if(n===void 0)continue;const o=c?.[i];s[i]=[n,o?.[0]===n?o[1]:e.base]}return{...t,[f]:!0,kind:"video",written:{file:e.file,...Object.keys(s).length>0?{paths:s}:{}}}},definePiece=()=>d("definePiece is gone: a video's module exports one video, export default video({ format, parts: (ctx) => [ … ] }), with what definePiece and its output had (id, format, matrix, music, mix…); a deck's module exports default presentation((prs) => { … }) from @allyhub/sdk/slides. Each other output is an item of its own, which imports what it shares."),paged=()=>d('paged() is gone: a deck is a module of its own, export default presentation({ slides: "./deck.yaml", script: "./deck.{locale}.yaml" }, (prs) => { … }) from @allyhub/sdk/slides, its slides in the file it names.');export function defineConfig(e){return e}
@@ -0,0 +1,46 @@
1
+ /** A box, in any units: its left, top, width and height. */
2
+ export interface RouteBox {
3
+ x: number;
4
+ y: number;
5
+ w: number;
6
+ h: number;
7
+ }
8
+ /** A side of a box a route leaves or arrives by. */
9
+ export type RouteSide = "top" | "right" | "bottom" | "left";
10
+ /** A route from one box to another, by their places in the list. */
11
+ export interface RouteConnection {
12
+ from: number;
13
+ to: number;
14
+ /** The side it leaves by; absent: the cheapest. */
15
+ fromSide?: RouteSide;
16
+ /** The side it arrives by; absent: the cheapest. */
17
+ toSide?: RouteSide;
18
+ }
19
+ export interface RouteOptions {
20
+ /** How far a route keeps from every box, and how far it runs straight out of a side. */
21
+ margin: number;
22
+ /** What a bend costs, as so much length: higher, fewer bends and longer ways round. */
23
+ bend: number;
24
+ /** How far apart lines that share a channel are set. */
25
+ spread: number;
26
+ /** What crossing another line costs, as so much length: higher, fewer crossings and longer ways round. */
27
+ cross: number;
28
+ /** The area routes stay in (a frame), its left, top, width and height; absent: anywhere. */
29
+ bounds?: RouteBox | undefined;
30
+ }
31
+ export declare const ROUTE_DEFAULTS: RouteOptions;
32
+ /** How many times lines cross one another, each pair counted once. */
33
+ export declare function routeCrossings(routes: readonly (Route | undefined)[]): number;
34
+ /** A route: its corners from the port it leaves to the port it reaches, and the sides it uses. */
35
+ export interface Route {
36
+ points: [number, number][];
37
+ fromSide: RouteSide;
38
+ toSide: RouteSide;
39
+ }
40
+ /**
41
+ * Routes at right angles between boxes, each round every other box (and
42
+ * round its own two, from a side's middle). A connection that no way
43
+ * along the grid joins is undefined.
44
+ */
45
+ export declare function routeConnections(boxes: readonly RouteBox[], connections: readonly RouteConnection[], options?: Partial<RouteOptions>): (Route | undefined)[];
46
+ //# sourceMappingURL=route.d.ts.map
@@ -0,0 +1,2 @@
1
+ /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
+ export const ROUTE_DEFAULTS={margin:16,bend:48,spread:8,cross:120};const rt=e=>e.slice(1).map((t,f)=>{const n=e[f]??t;return[n[0],n[1],t[0],t[1]]});function Mt(e,t){const f=Math.abs(e[1]-e[3])<1e-6,n=Math.abs(t[1]-t[3])<1e-6;if(f===n)return!1;const[o,i]=f?[e,t]:[t,e],l=o[1],a=i[0],g=(M,u,r)=>M>Math.min(u,r)+1e-6&&M<Math.max(u,r)-1e-6;return g(a,o[0],o[2])&&g(l,i[1],i[3])}function gt(e,t){const f=Math.abs(e[1]-e[3])<1e-6,n=Math.abs(t[1]-t[3])<1e-6;if(f===n)return!1;const[o,i]=f?[e,t]:[t,e],l=o[1],a=i[0],g=(u,r,c)=>u>=Math.min(r,c)-1e-6&&u<=Math.max(r,c)+1e-6,M=(u,r,c)=>u>Math.min(r,c)+1e-6&&u<Math.max(r,c)-1e-6;return M(a,o[0],o[2])&&g(l,i[1],i[3])||g(a,o[0],o[2])&&M(l,i[1],i[3])}export function routeCrossings(e){const t=e.map(n=>n?rt(n.points):[]);let f=0;return t.forEach((n,o)=>{for(const i of t.slice(o+1))for(const l of n)for(const a of i)Mt(l,a)&&f++}),f}const Y=["top","right","bottom","left"],q={top:[0,-1],right:[1,0],bottom:[0,1],left:[-1,0]},at=[[1,0],[-1,0],[0,1],[0,-1]],ft=(e,t)=>e>0?0:e<0?1:t>0?2:3;function B(e){const t=[];for(const f of[...e].sort((n,o)=>n-o))(t.length===0||f-(t[t.length-1]??0)>1e-6)&&t.push(f);return t}class yt{items=[];get size(){return this.items.length}push(t,f){const n=this.items;n.push([t,f]);let o=n.length-1;for(;o>0;){const i=o-1>>1,l=n[o],a=n[i];if(!l||!a||a[0]<=l[0])break;n[o]=a,n[i]=l,o=i}}pop(){const t=this.items,f=t[0],n=t.pop();if(t.length>0&&n){t[0]=n;let o=0;for(;;){const i=2*o+1,l=i+1;let a=o;if((t[i]?.[0]??1/0)<(t[a]?.[0]??1/0)&&(a=i),(t[l]?.[0]??1/0)<(t[a]?.[0]??1/0)&&(a=l),a===o)break;const g=t[a],M=t[o];if(!g||!M)break;t[a]=M,t[o]=g,o=a}}return f}}function tt(e,t,f){const n=e.x+e.w/2,o=e.y+e.h/2,i=t==="top"?[n,e.y]:t==="bottom"?[n,e.y+e.h]:t==="left"?[e.x,o]:[e.x+e.w,o],[l,a]=q[t];return{at:i,out:[i[0]+l*f,i[1]+a*f]}}export function routeConnections(e,t,f={}){const{margin:n,bend:o,spread:i,cross:l,bounds:a}={...ROUTE_DEFAULTS,...f},g=e.map(s=>({x0:s.x-n,y0:s.y-n,x1:s.x+s.w+n,y1:s.y+s.h+n})),M=B(g.flatMap(s=>[s.x0,s.x1])),u=B(g.flatMap(s=>[s.y0,s.y1])),r=s=>s.slice(1).map((h,m)=>(h+(s[m]??h))/2),c=B([...M,...r(M),...e.map(s=>s.x+s.w/2)]),d=B([...u,...r(u),...e.map(s=>s.y+s.h/2)]);if(a!==void 0){const s=(h,m,w)=>h.filter(E=>E>=m-1e-6&&E<=w+1e-6);c.splice(0,c.length,...s(c,a.x,a.x+a.w)),d.splice(0,d.length,...s(d,a.y,a.y+a.h))}const p=c.length,x=(s,h)=>h*p+s,I=(s,h)=>g.some(m=>s>m.x0+1e-6&&s<m.x1-1e-6&&h>m.y0+1e-6&&h<m.y1-1e-6),F=(s,h,m)=>{const[w,E]=at[m]??[0,0],R=s+w,_=h+E,z=((c[s]??0)+(c[R]??0))/2,D=((d[h]??0)+(d[_]??0))/2;return!I(z,D)},j=(s,h)=>{let m=0;return h.forEach((w,E)=>{Math.abs(w-s)<Math.abs((h[m]??0)-s)&&(m=E)}),m},U=(s,h)=>{const m=e[s.from],w=e[s.to];if(!m||!w||s.from===s.to)return;const E=(s.fromSide?[s.fromSide]:Y).map(b=>{const y=tt(m,b,n);return{side:b,...y,i:j(y.out[0],c),j:j(y.out[1],d)}}),R=(s.toSide?[s.toSide]:Y).map(b=>{const y=tt(w,b,n);return{side:b,...y,i:j(y.out[0],c),j:j(y.out[1],d)}}),_=c.length*d.length*4,z=new Float64Array(_).fill(1/0),D=new Int32Array(_).fill(-1),H=new yt,et=(b,y)=>Math.min(...R.map(k=>Math.abs((c[b]??0)-(c[k.i]??0))+Math.abs((d[y]??0)-(d[k.j]??0))));for(const b of E){const y=ft(...q[b.side]),k=x(b.i,b.j)*4+y;n<(z[k]??1/0)&&(z[k]=n,D[k]=-2-Y.indexOf(b.side),H.push(n+et(b.i,b.j),k))}let J=1/0,K=-1,L;for(;H.size>0;){const[b,y]=H.pop()??[1/0,-1];if(b>=J)break;const k=z[y]??1/0,ct=y>>2,V=y&3,C=ct%p,T=(ct-C)/p;for(const S of R){if(S.i!==C||S.j!==T)continue;const[W,Z]=q[S.side],v=ft(-W,-Z)===V?0:o,O=k+n+v;O<J&&(J=O,K=y,L=S)}for(let S=0;S<4;S++){const[W,Z]=at[S]??[0,0];if(S===(V^1))continue;const v=C+W,O=T+Z;if(v<0||O<0||v>=p||O>=d.length||!F(C,T,S))continue;const dt=Math.abs((c[v]??0)-(c[C]??0))+Math.abs((d[O]??0)-(d[T]??0));let it=0;if(l>0&&h.length>0){const pt=[c[C]??0,d[T]??0,c[v]??0,d[O]??0];for(const mt of h)gt(pt,mt)&&it++}const $=k+dt+(S===V?0:o)+it*l,X=x(v,O)*4+S;$<(z[X]??1/0)&&(z[X]=$,D[X]=y,H.push($+et(v,O),X))}}if(K<0||!L)return;const N=[];let P=K,Q="right";for(;;){const b=P>>2,y=b%p;N.push([c[y]??0,d[(b-y)/p]??0]);const k=D[P]??-1;if(k<=-2){Q=Y[-2-k]??"right";break}if(k<0)break;P=k}N.reverse();const lt=tt(m,Q,n);return{points:bt([lt.at,...N,L.at]),fromSide:Q,toSide:L.side}},ut=s=>{const h=e[s.from],m=e[s.to];return h&&m?Math.abs(h.x+h.w/2-(m.x+m.w/2))+Math.abs(h.y+h.h/2-(m.y+m.h/2)):0},nt=t.map((s,h)=>({k:h,d:ut(s)})).sort((s,h)=>s.d-h.d||s.k-h.k).map(s=>s.k),st=(s,h)=>s.flatMap((m,w)=>w===h||!m?[]:rt(m.points));let A=t.map(()=>{});for(const s of nt){const h=t[s];h&&(A[s]=U(h,st(A,s)))}const ot=s=>routeCrossings(ht(s,i));let G=ot(A);for(let s=0;s<3&&G>0;s++){const h=[...A];for(const w of nt){const E=t[w];E&&(h[w]=U(E,st(h,w)))}const m=ot(h);if(m>=G)break;A=h,G=m}return ht(A,i)}function bt(e){const t=[];for(const f of e){const n=t[t.length-1];if(n&&Math.abs(n[0]-f[0])<1e-6&&Math.abs(n[1]-f[1])<1e-6)continue;const o=t[t.length-2];o&&n&&(Math.abs(o[0]-n[0])<1e-6&&Math.abs(n[0]-f[0])<1e-6||Math.abs(o[1]-n[1])<1e-6&&Math.abs(n[1]-f[1])<1e-6)?t[t.length-1]=f:t.push(f)}return t}function ht(e,t){if(t<=0)return e;const f=e.map(n=>n&&{...n,points:n.points.map(o=>[o[0],o[1]])});for(const n of[0,1]){const o=n===0?1:0,i=[];f.forEach((a,g)=>{if(!a)return;const M=a.points;for(let u=0;u+1<M.length;u++){const r=M[u],c=M[u+1];!r||!c||Math.abs(r[n]-c[n])>1e-6||Math.abs(r[o]-c[o])<1e-6||i.push({r:g,k:u,at:r[n],lo:Math.min(r[o],c[o]),hi:Math.max(r[o],c[o])})}});const l=new Set;i.forEach((a,g)=>{if(l.has(g))return;const M=[g];l.add(g);for(const r of M){const c=i[r];c&&i.forEach((d,p)=>{l.has(p)||Math.abs(d.at-c.at)>1e-6||d.hi<=c.lo+1e-6||d.lo>=c.hi-1e-6||(l.add(p),M.push(p))})}const u=M.map(r=>i[r]).filter(r=>r!==void 0);new Set(u.map(r=>r.r)).size<2||(u.sort((r,c)=>xt(e,n,r,c)||r.r-c.r),u.forEach((r,c)=>{const d=(c-(u.length-1)/2)*t,p=f[r.r]?.points,x=p?.[r.k],I=p?.[r.k+1];x&&(x[n]+=d),I&&(I[n]+=d)}))})}return f}function xt(e,t,f,n){const o=t===0?1:0,i=e[f.r]?.points,l=e[n.r]?.points,a=i?.[f.k],g=i?.[f.k+1],M=l?.[n.k],u=l?.[n.k+1];if(!i||!l||!a||!g||!M||!u)return 0;const r=Math.max(Math.min(a[o],g[o]),Math.min(M[o],u[o])),c=Math.min(Math.max(a[o],g[o]),Math.max(M[o],u[o])),d=(p,x,I)=>{const F=p[x],j=p[x+1];return!F||!j?[]:F[o]<j[o]===I?p.slice(x+1):p.slice(0,x+1).reverse()};for(const p of[!0,!1]){const x=a[t],I=t===0?[x,p?r:c]:[p?r:c,x],F=t===0?[0,p?1:-1]:[p?1:-1,0],j=kt(d(i,f.k,p),d(l,n.k,p),I,F);if(j!==0){const U=t===0?F[1]:-F[0];return j*U}}return 0}function kt(e,t,f,n){let o=f,i=n,l=0,a=0;const g=(M,u)=>{const r=M[u],c=M[u+1];if(!r||!c)return;const d=[Math.sign(c[0]-r[0]),Math.sign(c[1]-r[1])];return Math.sign((d[0]??0)*i[1]-(d[1]??0)*i[0])};for(let M=0;M<256;M++){const u=e[l],r=t[a];if(!u||!r)return 0;const c=(u[0]-o[0])*i[0]+(u[1]-o[1])*i[1],d=(r[0]-o[0])*i[0]+(r[1]-o[1])*i[1];if(Math.abs(c-d)>1e-6)return c<d?g(e,l)??0:-(g(t,a)??0);const p=g(e,l),x=g(t,a);if(p===void 0||x===void 0)return Math.sign((p??0)-(x??0));if(p!==x)return Math.sign(p-x);const I=e[l+1];if(!I)return 0;o=u,i=[Math.sign(I[0]-u[0]),Math.sign(I[1]-u[1])],l++,a++}return 0}
@@ -0,0 +1,2 @@
1
+ export { PHONE_CAMERA, phoneCamera, type Deeper, type PhoneCamera, } from "./phone.js";
2
+ //# sourceMappingURL=scenery.d.ts.map
@@ -0,0 +1,2 @@
1
+ /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
+ export{PHONE_CAMERA,phoneCamera}from"./phone.js";
@@ -0,0 +1,19 @@
1
+ {
2
+ "name": "@allyhub/video-sdk",
3
+ "version": "0.10.0",
4
+ "type": "module",
5
+ "exports": {
6
+ ".": {
7
+ "types": "./dist/index.d.ts",
8
+ "default": "./dist/index.js"
9
+ },
10
+ "./scenery": {
11
+ "types": "./dist/scenery.d.ts",
12
+ "default": "./dist/scenery.js"
13
+ },
14
+ "./package.json": "./package.json"
15
+ },
16
+ "sideEffects": false,
17
+ "private": true,
18
+ "license": "SEE LICENSE IN LICENSE.md"
19
+ }
package/dist/scenery.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export { PHONE_CAMERA, phoneCamera, type Deeper, type PhoneCamera, } from "./phone.js";
1
+ export * from "@allyhub/video-sdk/scenery";
2
2
  //# sourceMappingURL=scenery.d.ts.map
package/dist/scenery.js CHANGED
@@ -1,2 +1,2 @@
1
1
  /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
- export{PHONE_CAMERA,phoneCamera}from"./phone.js";
2
+ export*from"@allyhub/video-sdk/scenery";
package/dist/sheets.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export { Alignment, AreaChart, AutoFilter, BLOCK_CELLS, BarChart, Comment, Image, PageMargins, PageSetup, Border, CAPABILITIES, Cell, CellIsRule, ChartBase, Color, ColorScaleRule, ColumnDimension, ConditionalFormattingList, DataBarRule, DataLabelList, DataValidation, DataValidationList, DefinedName, DefinedNameDict, DifferentialStyle, DoughnutChart, Font, FormulaRule, GraphicalProperties, IconSetRule, Legend, LineChart, LineProperties, Marker, NumericAxis, PatternFill, PieChart, Reference, RowDimension, Rule, Scaling, ScatterChart, Series, Side, Table, TableList, TextAxis, Workbook, Worksheet, column_index_from_string, coordinate_to_tuple, get_column_letter, load_workbook, range_boundaries, workbook, type AlignmentOptions, type BarChartOptions, type BorderOptions, type CellIsRuleOptions, type CellValue, type SheetCodeBuild, type SheetCodeContext, type ChartData, type ColorScaleRuleOptions, type DataBarRuleOptions, type DataValidationOptions, type DifferentialStyleOptions, type FontOptions, type FormulaRuleOptions, type LoadOptions, type PatternFillOptions, type ReferenceOptions, type RuleOptions, type SeriesOptions, type SideOptions, type TableInput, type TableOptions, } from "@allyhub/sheet/api";
1
+ export * from "@allyhub/sheet/sdk";
2
2
  //# sourceMappingURL=sheets.d.ts.map
package/dist/sheets.js CHANGED
@@ -1,2 +1,2 @@
1
1
  /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
- export{Alignment,AreaChart,AutoFilter,BLOCK_CELLS,BarChart,Comment,Image,PageMargins,PageSetup,Border,CAPABILITIES,Cell,CellIsRule,ChartBase,Color,ColorScaleRule,ColumnDimension,ConditionalFormattingList,DataBarRule,DataLabelList,DataValidation,DataValidationList,DefinedName,DefinedNameDict,DifferentialStyle,DoughnutChart,Font,FormulaRule,GraphicalProperties,IconSetRule,Legend,LineChart,LineProperties,Marker,NumericAxis,PatternFill,PieChart,Reference,RowDimension,Rule,Scaling,ScatterChart,Series,Side,Table,TableList,TextAxis,Workbook,Worksheet,column_index_from_string,coordinate_to_tuple,get_column_letter,load_workbook,range_boundaries,workbook}from"@allyhub/sheet/api";
2
+ export*from"@allyhub/sheet/sdk";
package/dist/slides.d.ts CHANGED
@@ -1,10 +1,2 @@
1
- /** python-pptx's length functions: each gives a Length, a number of EMU that says itself in other units (`Pt(12).pt`, `.inches`, `.cm`, `.mm`, `.emu`). */
2
- export declare const Emu: (n: number) => import("@allyhub/slides-core").LengthValue, Inches: (n: number) => import("@allyhub/slides-core").LengthValue, Pt: (n: number) => import("@allyhub/slides-core").LengthValue, Cm: (n: number) => import("@allyhub/slides-core").LengthValue, Mm: (n: number) => import("@allyhub/slides-core").LengthValue, Centipoints: (n: number) => import("@allyhub/slides-core").LengthValue;
3
- export { RGBColor, MSO_ANCHOR, CategoryChartData, MSO_ARROWHEAD, XL_CHART_TYPE, XL_LABEL_POSITION, XL_LEGEND_POSITION, MSO_AUTO_SIZE, MSO_CONNECTOR, MSO_FILL, MSO_LINE, MSO_SHAPE, MSO_SHAPE_TYPE, MSO_THEME_COLOR, PP_ALIGN, PP_PLACEHOLDER, THEME_FONT, SLIDE_SIZES, presentationFor, isDeck, type Anchor, type AutoSize, type Background, type ColorFormat, type ComponentContext, type ComponentInput, type Deck, type FillFormat, type Font, type GeneratedSlide, type Generator, type Length, type LengthValue, type LineFormat, type ListLevel, type ListStyle, type Paragraph, type Placeholders, type PlaceholderType, type Presentation, type PresentationOptions, type PropSpec, type Run, type Shape, type ShapeCollection, type ShapeType, type SlideLayout, type SlideLayouts, type SlideMaster, type SlideMasters, type SlideSizeName, type TextFrame, type TextStyles, type ThemeInput, } from "@allyhub/slides-core";
4
- /**
5
- * A deck: the default export of an item's slides.ts. Its function makes
6
- * the presentation's slide masters, layouts, components and generators;
7
- * its slides are slides.yaml beside it.
8
- */
9
- export declare const presentation: (options: import("@allyhub/slides-core").PresentationOptions | ((prs: import("@allyhub/slides-core").Presentation) => void), build?: (prs: import("@allyhub/slides-core").Presentation) => void) => import("@allyhub/slides-core").Deck;
1
+ export * from "@allyhub/slides-core/sdk";
10
2
  //# sourceMappingURL=slides.d.ts.map
package/dist/slides.js CHANGED
@@ -1,2 +1,2 @@
1
1
  /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
2
- import{LENGTH_UNITS as _,presentationFor as O}from"@allyhub/slides-core";export const{Emu,Inches,Pt,Cm,Mm,Centipoints}=_;export{RGBColor,MSO_ANCHOR,CategoryChartData,MSO_ARROWHEAD,XL_CHART_TYPE,XL_LABEL_POSITION,XL_LEGEND_POSITION,MSO_AUTO_SIZE,MSO_CONNECTOR,MSO_FILL,MSO_LINE,MSO_SHAPE,MSO_SHAPE_TYPE,MSO_THEME_COLOR,PP_ALIGN,PP_PLACEHOLDER,THEME_FONT,SLIDE_SIZES,presentationFor,isDeck}from"@allyhub/slides-core";export const presentation=O("");
2
+ export*from"@allyhub/slides-core/sdk";