@allyhub/sdk 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (497) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/NOTICE +46 -49
  3. package/dist/dom.d.ts +1 -209
  4. package/dist/dom.js +1 -1
  5. package/dist/image.d.ts +2 -0
  6. package/dist/image.js +2 -0
  7. package/dist/index.d.ts +1 -21
  8. package/dist/index.js +1 -1
  9. package/dist/media.d.ts +1 -5
  10. package/dist/media.js +1 -1
  11. package/dist/node_modules/@allyhub/audio/dist/levels.d.ts +4 -5
  12. package/dist/node_modules/@allyhub/audio/dist/levels.js +1 -1
  13. package/dist/node_modules/@allyhub/audio/dist/node/ffmpeg.d.ts +1 -6
  14. package/dist/node_modules/@allyhub/audio/dist/node/ffmpeg.js +1 -1
  15. package/dist/node_modules/@allyhub/audio/package.json +1 -1
  16. package/dist/node_modules/@allyhub/chart/dist/chart-file.js +1 -1
  17. package/dist/node_modules/@allyhub/chart/dist/chart-xml.d.ts +4 -1
  18. package/dist/node_modules/@allyhub/chart/dist/chart-xml.js +2 -2
  19. package/dist/node_modules/@allyhub/chart/dist/chart.d.ts +22 -0
  20. package/dist/node_modules/@allyhub/chart/dist/chart.js +1 -1
  21. package/dist/node_modules/@allyhub/chart/package.json +1 -1
  22. package/dist/node_modules/@allyhub/diagnostics/LICENSE +241 -0
  23. package/dist/node_modules/@allyhub/diagnostics/dist/fact.d.ts +37 -0
  24. package/dist/node_modules/@allyhub/diagnostics/dist/fact.js +2 -0
  25. package/dist/node_modules/@allyhub/diagnostics/dist/index.d.ts +4 -0
  26. package/dist/node_modules/@allyhub/diagnostics/dist/index.js +2 -0
  27. package/dist/node_modules/@allyhub/diagnostics/dist/problem.d.ts +43 -0
  28. package/dist/node_modules/@allyhub/diagnostics/dist/problem.js +2 -0
  29. package/dist/node_modules/@allyhub/diagnostics/dist/rules.d.ts +30 -0
  30. package/dist/node_modules/@allyhub/diagnostics/dist/rules.js +2 -0
  31. package/dist/node_modules/@allyhub/diagnostics/package.json +14 -0
  32. package/dist/node_modules/@allyhub/formats/dist/contributed.d.ts +126 -0
  33. package/dist/node_modules/@allyhub/formats/dist/contributed.js +2 -0
  34. package/dist/node_modules/@allyhub/formats/dist/data/faces.d.ts +1 -1
  35. package/dist/node_modules/@allyhub/formats/dist/data/reference.d.ts +7 -12
  36. package/dist/node_modules/@allyhub/formats/dist/data/reference.js +1 -1
  37. package/dist/node_modules/@allyhub/formats/dist/data/script.d.ts +9 -4
  38. package/dist/node_modules/@allyhub/formats/dist/data/script.js +1 -1
  39. package/dist/node_modules/@allyhub/formats/dist/data/sheet.d.ts +107 -83
  40. package/dist/node_modules/@allyhub/formats/dist/data/sheet.js +1 -1
  41. package/dist/node_modules/@allyhub/formats/dist/data/slides.d.ts +185 -8
  42. package/dist/node_modules/@allyhub/formats/dist/data/slides.js +1 -1
  43. package/dist/node_modules/@allyhub/formats/dist/data/website.d.ts +2 -1
  44. package/dist/node_modules/@allyhub/formats/dist/data/website.js +1 -1
  45. package/dist/node_modules/@allyhub/formats/dist/data/work.d.ts +42 -0
  46. package/dist/node_modules/@allyhub/formats/dist/data/work.js +2 -0
  47. package/dist/node_modules/@allyhub/formats/dist/extension.d.ts +91 -0
  48. package/dist/node_modules/@allyhub/formats/dist/extension.js +2 -0
  49. package/dist/node_modules/@allyhub/formats/dist/files.d.ts +51 -0
  50. package/dist/node_modules/@allyhub/formats/dist/files.js +2 -0
  51. package/dist/node_modules/@allyhub/formats/dist/index.d.ts +5 -1
  52. package/dist/node_modules/@allyhub/formats/dist/index.js +1 -1
  53. package/dist/node_modules/@allyhub/formats/dist/items.d.ts +226 -90
  54. package/dist/node_modules/@allyhub/formats/dist/items.js +1 -1
  55. package/dist/node_modules/@allyhub/formats/dist/layout.d.ts +7 -1
  56. package/dist/node_modules/@allyhub/formats/dist/layout.js +1 -1
  57. package/dist/node_modules/@allyhub/formats/dist/schemas.d.ts +96 -42
  58. package/dist/node_modules/@allyhub/formats/dist/schemas.js +1 -1
  59. package/dist/node_modules/@allyhub/formats/package.json +1 -1
  60. package/dist/node_modules/@allyhub/image-draw/LICENSE +241 -0
  61. package/dist/node_modules/@allyhub/image-draw/dist/context.d.ts +5 -0
  62. package/dist/node_modules/@allyhub/image-draw/dist/context.js +2 -0
  63. package/dist/node_modules/@allyhub/image-draw/dist/contrast.d.ts +13 -0
  64. package/dist/node_modules/@allyhub/image-draw/dist/contrast.js +2 -0
  65. package/dist/node_modules/@allyhub/image-draw/dist/env.d.ts +112 -0
  66. package/dist/node_modules/@allyhub/image-draw/dist/env.js +2 -0
  67. package/dist/node_modules/@allyhub/image-draw/dist/errors.d.ts +20 -0
  68. package/dist/node_modules/@allyhub/image-draw/dist/errors.js +2 -0
  69. package/dist/node_modules/@allyhub/image-draw/dist/fonts.d.ts +110 -0
  70. package/dist/node_modules/@allyhub/image-draw/dist/fonts.js +2 -0
  71. package/dist/node_modules/@allyhub/image-draw/dist/guards.d.ts +32 -0
  72. package/dist/node_modules/@allyhub/image-draw/dist/guards.js +2 -0
  73. package/dist/node_modules/@allyhub/image-draw/dist/hash.d.ts +3 -0
  74. package/dist/node_modules/@allyhub/image-draw/dist/hash.js +2 -0
  75. package/dist/node_modules/@allyhub/image-draw/dist/inspect.d.ts +113 -0
  76. package/dist/node_modules/@allyhub/image-draw/dist/inspect.js +3 -0
  77. package/dist/node_modules/@allyhub/image-draw/dist/layer-style.d.ts +151 -0
  78. package/dist/node_modules/@allyhub/image-draw/dist/layer-style.js +2 -0
  79. package/dist/node_modules/@allyhub/image-draw/dist/paint.d.ts +29 -0
  80. package/dist/node_modules/@allyhub/image-draw/dist/paint.js +2 -0
  81. package/dist/node_modules/@allyhub/image-draw/dist/pictures.d.ts +39 -0
  82. package/dist/node_modules/@allyhub/image-draw/dist/pictures.js +2 -0
  83. package/dist/node_modules/@allyhub/image-draw/dist/plan.d.ts +52 -0
  84. package/dist/node_modules/@allyhub/image-draw/dist/plan.js +2 -0
  85. package/dist/node_modules/@allyhub/image-draw/dist/reads.d.ts +145 -0
  86. package/dist/node_modules/@allyhub/image-draw/dist/reads.js +2 -0
  87. package/dist/node_modules/@allyhub/image-draw/dist/shape-path.d.ts +26 -0
  88. package/dist/node_modules/@allyhub/image-draw/dist/shape-path.js +2 -0
  89. package/dist/node_modules/@allyhub/image-draw/dist/stage.d.ts +56 -0
  90. package/dist/node_modules/@allyhub/image-draw/dist/stage.js +2 -0
  91. package/dist/node_modules/@allyhub/image-draw/dist/styles.d.ts +35 -0
  92. package/dist/node_modules/@allyhub/image-draw/dist/styles.js +2 -0
  93. package/dist/node_modules/@allyhub/image-draw/dist/tone.d.ts +53 -0
  94. package/dist/node_modules/@allyhub/image-draw/dist/tone.js +2 -0
  95. package/dist/node_modules/@allyhub/image-draw/package.json +14 -0
  96. package/dist/node_modules/@allyhub/image-measure/LICENSE +241 -0
  97. package/dist/node_modules/@allyhub/image-measure/dist/contrast.d.ts +43 -0
  98. package/dist/node_modules/@allyhub/image-measure/dist/contrast.js +2 -0
  99. package/dist/node_modules/@allyhub/image-measure/dist/layout.d.ts +186 -0
  100. package/dist/node_modules/@allyhub/image-measure/dist/layout.js +5 -0
  101. package/dist/node_modules/@allyhub/image-measure/package.json +14 -0
  102. package/dist/node_modules/@allyhub/image-sdk/LICENSE +241 -0
  103. package/dist/node_modules/@allyhub/image-sdk/dist/adjustment.d.ts +13 -0
  104. package/dist/node_modules/@allyhub/image-sdk/dist/adjustment.js +2 -0
  105. package/dist/{define.d.ts → node_modules/@allyhub/image-sdk/dist/define.d.ts} +21 -4
  106. package/dist/node_modules/@allyhub/image-sdk/dist/define.js +2 -0
  107. package/dist/node_modules/@allyhub/image-sdk/dist/dom.d.ts +210 -0
  108. package/dist/node_modules/@allyhub/image-sdk/dist/dom.js +2 -0
  109. package/dist/node_modules/@allyhub/image-sdk/dist/fill.d.ts +21 -0
  110. package/dist/node_modules/@allyhub/image-sdk/dist/fill.js +2 -0
  111. package/dist/node_modules/@allyhub/image-sdk/dist/group.d.ts +17 -0
  112. package/dist/node_modules/@allyhub/image-sdk/dist/group.js +2 -0
  113. package/dist/node_modules/@allyhub/image-sdk/dist/index.d.ts +166 -0
  114. package/dist/node_modules/@allyhub/image-sdk/dist/index.js +2 -0
  115. package/dist/node_modules/@allyhub/image-sdk/dist/media.d.ts +6 -0
  116. package/dist/node_modules/@allyhub/image-sdk/dist/media.js +2 -0
  117. package/dist/{messages.d.ts → node_modules/@allyhub/image-sdk/dist/messages.d.ts} +1 -1
  118. package/dist/node_modules/@allyhub/image-sdk/dist/picture.d.ts +59 -0
  119. package/dist/node_modules/@allyhub/image-sdk/dist/picture.js +2 -0
  120. package/dist/{props.d.ts → node_modules/@allyhub/image-sdk/dist/props.d.ts} +4 -4
  121. package/dist/node_modules/@allyhub/image-sdk/dist/shape.d.ts +34 -0
  122. package/dist/node_modules/@allyhub/image-sdk/dist/shape.js +2 -0
  123. package/dist/node_modules/@allyhub/image-sdk/dist/stack.d.ts +16 -0
  124. package/dist/node_modules/@allyhub/image-sdk/dist/stack.js +2 -0
  125. package/dist/node_modules/@allyhub/image-sdk/dist/text-layer.d.ts +38 -0
  126. package/dist/node_modules/@allyhub/image-sdk/dist/text-layer.js +2 -0
  127. package/dist/{written.js → node_modules/@allyhub/image-sdk/dist/written.js} +1 -1
  128. package/dist/node_modules/@allyhub/image-sdk/package.json +19 -0
  129. package/dist/node_modules/@allyhub/measure/LICENSE +241 -0
  130. package/dist/node_modules/@allyhub/measure/dist/compare.d.ts +195 -0
  131. package/dist/node_modules/@allyhub/measure/dist/compare.js +2 -0
  132. package/dist/node_modules/@allyhub/measure/dist/grain.d.ts +8 -0
  133. package/dist/node_modules/@allyhub/measure/dist/grain.js +2 -0
  134. package/dist/node_modules/@allyhub/measure/dist/image.d.ts +16 -0
  135. package/dist/node_modules/@allyhub/measure/dist/image.js +2 -0
  136. package/dist/node_modules/@allyhub/measure/dist/index.d.ts +4 -0
  137. package/dist/node_modules/@allyhub/measure/dist/index.js +2 -0
  138. package/dist/node_modules/@allyhub/measure/package.json +13 -0
  139. package/dist/node_modules/@allyhub/ooxml/dist/generated/presets.d.ts +4 -1
  140. package/dist/node_modules/@allyhub/ooxml/dist/generated/presets.js +1 -1
  141. package/dist/node_modules/@allyhub/ooxml/dist/geometry/index.d.ts +15 -1
  142. package/dist/node_modules/@allyhub/ooxml/dist/geometry/index.js +1 -1
  143. package/dist/node_modules/@allyhub/ooxml/package.json +1 -1
  144. package/dist/node_modules/@allyhub/piece/LICENSE +241 -0
  145. package/dist/node_modules/@allyhub/{video-core → piece}/dist/anchors.d.ts +1 -9
  146. package/dist/node_modules/@allyhub/{video-core → piece}/dist/component.js +1 -1
  147. package/dist/node_modules/@allyhub/piece/dist/context.d.ts +39 -0
  148. package/dist/node_modules/@allyhub/piece/dist/context.js +2 -0
  149. package/dist/node_modules/@allyhub/{video-core → piece}/dist/contrast.d.ts +2 -2
  150. package/dist/node_modules/@allyhub/{video-core → piece}/dist/export.d.ts +27 -10
  151. package/dist/node_modules/@allyhub/piece/dist/export.js +2 -0
  152. package/dist/node_modules/@allyhub/{video-core → piece}/dist/formats.d.ts +12 -68
  153. package/dist/node_modules/@allyhub/piece/dist/formats.js +2 -0
  154. package/dist/node_modules/@allyhub/piece/dist/gen.d.ts +104 -0
  155. package/dist/node_modules/@allyhub/piece/dist/index.d.ts +26 -0
  156. package/dist/node_modules/@allyhub/piece/dist/index.js +2 -0
  157. package/dist/node_modules/@allyhub/piece/dist/layer-style.d.ts +1558 -0
  158. package/dist/node_modules/@allyhub/piece/dist/layer-style.js +2 -0
  159. package/dist/node_modules/@allyhub/piece/dist/layer.d.ts +389 -0
  160. package/dist/node_modules/@allyhub/piece/dist/layer.js +2 -0
  161. package/dist/node_modules/@allyhub/piece/dist/layout.d.ts +437 -0
  162. package/dist/node_modules/@allyhub/piece/dist/layout.js +2 -0
  163. package/dist/node_modules/@allyhub/{video-core → piece}/dist/look.d.ts +1 -1
  164. package/dist/node_modules/@allyhub/{video-core → piece}/dist/media.d.ts +39 -9
  165. package/dist/node_modules/@allyhub/{video-core → piece}/dist/media.js +1 -1
  166. package/dist/node_modules/@allyhub/{video-core → piece}/dist/messages.d.ts +6 -0
  167. package/dist/node_modules/@allyhub/piece/dist/names.d.ts +26 -0
  168. package/dist/node_modules/@allyhub/piece/dist/names.js +2 -0
  169. package/dist/node_modules/@allyhub/piece/dist/page/console.d.ts +21 -0
  170. package/dist/node_modules/@allyhub/piece/dist/page/console.js +2 -0
  171. package/dist/node_modules/@allyhub/piece/dist/page/index.d.ts +3 -0
  172. package/dist/node_modules/@allyhub/piece/dist/page/index.js +2 -0
  173. package/dist/node_modules/@allyhub/piece/dist/page/locate.d.ts +4 -0
  174. package/dist/node_modules/@allyhub/piece/dist/page/locate.js +2 -0
  175. package/dist/node_modules/@allyhub/piece/dist/picture.d.ts +62 -0
  176. package/dist/node_modules/@allyhub/piece/dist/picture.js +2 -0
  177. package/dist/node_modules/@allyhub/piece/dist/piece.d.ts +15 -0
  178. package/dist/node_modules/@allyhub/piece/dist/piece.js +2 -0
  179. package/dist/node_modules/@allyhub/{video-core → piece}/dist/script.d.ts +9 -4
  180. package/dist/node_modules/@allyhub/piece/dist/script.js +2 -0
  181. package/dist/node_modules/@allyhub/piece/dist/source.d.ts +131 -0
  182. package/dist/node_modules/@allyhub/piece/dist/stage.d.ts +291 -0
  183. package/dist/node_modules/@allyhub/piece/dist/stage.js +2 -0
  184. package/dist/node_modules/@allyhub/piece/dist/version.d.ts +15 -0
  185. package/dist/node_modules/@allyhub/piece/dist/version.js +2 -0
  186. package/dist/node_modules/@allyhub/{video-core → piece}/dist/voice.d.ts +1 -20
  187. package/dist/node_modules/@allyhub/piece/package.json +18 -0
  188. package/dist/node_modules/@allyhub/protocol/dist/account.d.ts +271 -0
  189. package/dist/node_modules/@allyhub/protocol/dist/account.js +1 -1
  190. package/dist/node_modules/@allyhub/protocol/dist/app.d.ts +3 -10
  191. package/dist/node_modules/@allyhub/protocol/dist/app.js +1 -1
  192. package/dist/node_modules/@allyhub/protocol/dist/auth.d.ts +19 -1
  193. package/dist/node_modules/@allyhub/protocol/dist/auth.js +1 -1
  194. package/dist/node_modules/@allyhub/protocol/dist/browser-bridge.d.ts +337 -0
  195. package/dist/node_modules/@allyhub/protocol/dist/browser-bridge.js +2 -0
  196. package/dist/node_modules/@allyhub/protocol/dist/cli.d.ts +12 -1
  197. package/dist/node_modules/@allyhub/protocol/dist/cli.js +1 -1
  198. package/dist/node_modules/@allyhub/protocol/dist/cloud.d.ts +155 -0
  199. package/dist/node_modules/@allyhub/protocol/dist/cloud.js +1 -1
  200. package/dist/node_modules/@allyhub/protocol/dist/editor.d.ts +235 -133
  201. package/dist/node_modules/@allyhub/protocol/dist/editor.js +1 -1
  202. package/dist/node_modules/@allyhub/protocol/dist/files.d.ts +2 -0
  203. package/dist/node_modules/@allyhub/protocol/dist/files.js +1 -1
  204. package/dist/node_modules/@allyhub/protocol/dist/frame.d.ts +65 -197
  205. package/dist/node_modules/@allyhub/protocol/dist/frame.js +1 -1
  206. package/dist/node_modules/@allyhub/protocol/dist/image.d.ts +8 -0
  207. package/dist/node_modules/@allyhub/protocol/dist/image.js +2 -0
  208. package/dist/node_modules/@allyhub/protocol/dist/index.d.ts +6 -0
  209. package/dist/node_modules/@allyhub/protocol/dist/index.js +1 -1
  210. package/dist/node_modules/@allyhub/protocol/dist/jobs.d.ts +6 -6
  211. package/dist/node_modules/@allyhub/protocol/dist/kinds.d.ts +98 -0
  212. package/dist/node_modules/@allyhub/protocol/dist/kinds.js +2 -0
  213. package/dist/node_modules/@allyhub/protocol/dist/mail.d.ts +274 -0
  214. package/dist/node_modules/@allyhub/protocol/dist/mail.js +2 -0
  215. package/dist/node_modules/@allyhub/protocol/dist/notes.d.ts +77 -91
  216. package/dist/node_modules/@allyhub/protocol/dist/notes.js +1 -1
  217. package/dist/node_modules/@allyhub/protocol/dist/peer.d.ts +59 -0
  218. package/dist/node_modules/@allyhub/protocol/dist/peer.js +2 -0
  219. package/dist/node_modules/@allyhub/protocol/dist/place.d.ts +21 -0
  220. package/dist/node_modules/@allyhub/protocol/dist/place.js +2 -0
  221. package/dist/node_modules/@allyhub/protocol/dist/presence.d.ts +125 -0
  222. package/dist/node_modules/@allyhub/protocol/dist/presence.js +2 -0
  223. package/dist/node_modules/@allyhub/protocol/dist/registry.d.ts +1 -1
  224. package/dist/node_modules/@allyhub/protocol/dist/routes.js +1 -1
  225. package/dist/node_modules/@allyhub/protocol/dist/shape.d.ts +35 -0
  226. package/dist/node_modules/@allyhub/protocol/dist/shape.js +2 -0
  227. package/dist/node_modules/@allyhub/protocol/dist/shares.d.ts +2 -8
  228. package/dist/node_modules/@allyhub/protocol/dist/shares.js +1 -1
  229. package/dist/node_modules/@allyhub/protocol/dist/snapshots.d.ts +70 -40
  230. package/dist/node_modules/@allyhub/protocol/dist/snapshots.js +1 -1
  231. package/dist/node_modules/@allyhub/protocol/dist/tools.d.ts +224 -177
  232. package/dist/node_modules/@allyhub/protocol/dist/tools.js +1 -1
  233. package/dist/node_modules/@allyhub/protocol/package.json +5 -1
  234. package/dist/node_modules/@allyhub/runtimes/dist/bundled.js +1 -1
  235. package/dist/node_modules/@allyhub/runtimes/dist/declared.d.ts +14 -0
  236. package/dist/node_modules/@allyhub/runtimes/dist/declared.js +2 -0
  237. package/dist/node_modules/@allyhub/runtimes/dist/ffmpeg.d.ts +15 -0
  238. package/dist/node_modules/@allyhub/runtimes/dist/ffmpeg.js +2 -0
  239. package/dist/node_modules/@allyhub/runtimes/dist/index.d.ts +2 -0
  240. package/dist/node_modules/@allyhub/runtimes/dist/index.js +1 -1
  241. package/dist/node_modules/@allyhub/runtimes/dist/packages.js +3 -3
  242. package/dist/node_modules/@allyhub/runtimes/dist/runtimes.d.ts +1 -0
  243. package/dist/node_modules/@allyhub/runtimes/dist/runtimes.js +1 -1
  244. package/dist/node_modules/@allyhub/runtimes/manifest.json +0 -82
  245. package/dist/node_modules/@allyhub/runtimes/package.json +1 -1
  246. package/dist/node_modules/@allyhub/scenery/dist/define.d.ts +2 -0
  247. package/dist/node_modules/@allyhub/scenery/dist/define.js +1 -1
  248. package/dist/node_modules/@allyhub/scenery/dist/index.d.ts +2 -2
  249. package/dist/node_modules/@allyhub/scenery/dist/index.js +1 -1
  250. package/dist/node_modules/@allyhub/scenery/dist/moire.d.ts +45 -5
  251. package/dist/node_modules/@allyhub/scenery/dist/moire.js +2 -2
  252. package/dist/node_modules/@allyhub/scenery/dist/phone.d.ts +4 -3
  253. package/dist/node_modules/@allyhub/scenery/dist/phone.js +1 -1
  254. package/dist/node_modules/@allyhub/scenery/package.json +1 -1
  255. package/dist/node_modules/@allyhub/sheet/dist/api/capabilities.js +1 -1
  256. package/dist/node_modules/@allyhub/sheet/dist/api/code.d.ts +4 -4
  257. package/dist/node_modules/@allyhub/sheet/dist/api/code.js +1 -1
  258. package/dist/node_modules/@allyhub/sheet/dist/api/workbook.d.ts +15 -11
  259. package/dist/node_modules/@allyhub/sheet/dist/api/workbook.js +1 -1
  260. package/dist/node_modules/@allyhub/sheet/dist/calc/coerce.js +1 -1
  261. package/dist/node_modules/@allyhub/sheet/dist/calc/engine.d.ts +70 -0
  262. package/dist/node_modules/@allyhub/sheet/dist/calc/engine.js +1 -1
  263. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/criteria.d.ts +6 -0
  264. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/criteria.js +1 -1
  265. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/date.js +1 -1
  266. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/define.d.ts +3 -1
  267. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/define.js +1 -1
  268. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/info.js +1 -1
  269. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/kernels.js +1 -1
  270. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/lookup.js +1 -1
  271. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/maths.js +1 -1
  272. package/dist/node_modules/@allyhub/sheet/dist/calc/functions/text.js +1 -1
  273. package/dist/node_modules/@allyhub/sheet/dist/calc/indexes.d.ts +9 -0
  274. package/dist/node_modules/@allyhub/sheet/dist/calc/indexes.js +1 -1
  275. package/dist/node_modules/@allyhub/sheet/dist/calc/server.d.ts +1 -1
  276. package/dist/node_modules/@allyhub/sheet/dist/calc/types.d.ts +6 -0
  277. package/dist/node_modules/@allyhub/sheet/dist/calc/types.js +1 -1
  278. package/dist/node_modules/@allyhub/sheet/dist/chart.d.ts +9 -0
  279. package/dist/node_modules/@allyhub/sheet/dist/chart.js +1 -1
  280. package/dist/node_modules/@allyhub/sheet/dist/export.js +1 -1
  281. package/dist/node_modules/@allyhub/sheet/dist/file.d.ts +5 -0
  282. package/dist/node_modules/@allyhub/sheet/dist/file.js +1 -1
  283. package/dist/node_modules/@allyhub/sheet/dist/formula/ast.d.ts +12 -1
  284. package/dist/node_modules/@allyhub/sheet/dist/formula/move.d.ts +5 -1
  285. package/dist/node_modules/@allyhub/sheet/dist/formula/move.js +1 -1
  286. package/dist/node_modules/@allyhub/sheet/dist/formula/parse.js +1 -1
  287. package/dist/node_modules/@allyhub/sheet/dist/formula/print.js +1 -1
  288. package/dist/node_modules/@allyhub/sheet/dist/generated.d.ts +5 -19
  289. package/dist/node_modules/@allyhub/sheet/dist/generated.js +1 -1
  290. package/dist/node_modules/@allyhub/sheet/dist/import.d.ts +3 -1
  291. package/dist/node_modules/@allyhub/sheet/dist/import.js +1 -1
  292. package/dist/node_modules/@allyhub/sheet/dist/index.d.ts +5 -5
  293. package/dist/node_modules/@allyhub/sheet/dist/index.js +1 -1
  294. package/dist/node_modules/@allyhub/sheet/dist/inspect.d.ts +88 -3
  295. package/dist/node_modules/@allyhub/sheet/dist/inspect.js +1 -1
  296. package/dist/node_modules/@allyhub/sheet/dist/patch.d.ts +1 -1
  297. package/dist/node_modules/@allyhub/sheet/dist/patch.js +1 -1
  298. package/dist/node_modules/@allyhub/sheet/dist/printed.d.ts +19 -0
  299. package/dist/node_modules/@allyhub/sheet/dist/printed.js +2 -0
  300. package/dist/node_modules/@allyhub/sheet/dist/sdk.d.ts +2 -0
  301. package/dist/node_modules/@allyhub/sheet/dist/sdk.js +2 -0
  302. package/dist/node_modules/@allyhub/sheet/dist/values.d.ts +2 -0
  303. package/dist/node_modules/@allyhub/sheet/dist/values.js +1 -1
  304. package/dist/node_modules/@allyhub/sheet/dist/workbook.d.ts +8 -6
  305. package/dist/node_modules/@allyhub/sheet/dist/workbook.js +1 -1
  306. package/dist/node_modules/@allyhub/sheet/dist/write.js +15 -15
  307. package/dist/node_modules/@allyhub/sheet/dist/xlsx/charts.d.ts +6 -2
  308. package/dist/node_modules/@allyhub/sheet/dist/xlsx/charts.js +1 -1
  309. package/dist/node_modules/@allyhub/sheet/dist/xlsx/formula.js +2 -2
  310. package/dist/node_modules/@allyhub/sheet/dist/xlsx/import.d.ts +2 -1
  311. package/dist/node_modules/@allyhub/sheet/dist/xlsx/import.js +1 -1
  312. package/dist/node_modules/@allyhub/sheet/dist/xlsx/read.d.ts +3 -1
  313. package/dist/node_modules/@allyhub/sheet/dist/xlsx/read.js +2 -2
  314. package/dist/node_modules/@allyhub/sheet/dist/xlsx/sax.d.ts +7 -1
  315. package/dist/node_modules/@allyhub/sheet/dist/xlsx/sax.js +3 -1
  316. package/dist/node_modules/@allyhub/sheet/dist/xlsx/styles.d.ts +6 -0
  317. package/dist/node_modules/@allyhub/sheet/dist/xlsx/styles.js +1 -1
  318. package/dist/node_modules/@allyhub/sheet/dist/xlsx/write.d.ts +1 -1
  319. package/dist/node_modules/@allyhub/sheet/dist/xlsx/write.js +1 -1
  320. package/dist/node_modules/@allyhub/sheet/dist/xlsx/xml.d.ts +12 -1
  321. package/dist/node_modules/@allyhub/sheet/dist/xlsx/xml.js +3 -2
  322. package/dist/node_modules/@allyhub/sheet/package.json +5 -1
  323. package/dist/node_modules/@allyhub/slides-core/dist/animation.d.ts +23 -7
  324. package/dist/node_modules/@allyhub/slides-core/dist/animation.js +1 -1
  325. package/dist/node_modules/@allyhub/slides-core/dist/api.d.ts +101 -11
  326. package/dist/node_modules/@allyhub/slides-core/dist/api.js +2 -2
  327. package/dist/node_modules/@allyhub/slides-core/dist/capabilities.js +1 -1
  328. package/dist/node_modules/@allyhub/slides-core/dist/chart-api.d.ts +18 -1
  329. package/dist/node_modules/@allyhub/slides-core/dist/chart-api.js +1 -1
  330. package/dist/node_modules/@allyhub/slides-core/dist/code.d.ts +1 -1
  331. package/dist/node_modules/@allyhub/slides-core/dist/connect.d.ts +62 -0
  332. package/dist/node_modules/@allyhub/slides-core/dist/connect.js +2 -0
  333. package/dist/node_modules/@allyhub/slides-core/dist/enums.d.ts +24 -0
  334. package/dist/node_modules/@allyhub/slides-core/dist/enums.js +1 -1
  335. package/dist/node_modules/@allyhub/slides-core/dist/fact.d.ts +223 -0
  336. package/dist/node_modules/@allyhub/slides-core/dist/fact.js +2 -0
  337. package/dist/node_modules/@allyhub/slides-core/dist/file.d.ts +4 -4
  338. package/dist/node_modules/@allyhub/slides-core/dist/file.js +2 -2
  339. package/dist/node_modules/@allyhub/slides-core/dist/index.d.ts +2 -0
  340. package/dist/node_modules/@allyhub/slides-core/dist/index.js +1 -1
  341. package/dist/node_modules/@allyhub/slides-core/dist/measure.d.ts +4 -2
  342. package/dist/node_modules/@allyhub/slides-core/dist/measure.js +1 -1
  343. package/dist/node_modules/@allyhub/slides-core/dist/merge.d.ts +5 -5
  344. package/dist/node_modules/@allyhub/slides-core/dist/merge.js +1 -1
  345. package/dist/node_modules/@allyhub/slides-core/dist/model.d.ts +25 -4
  346. package/dist/node_modules/@allyhub/slides-core/dist/office.d.ts +1 -1
  347. package/dist/node_modules/@allyhub/slides-core/dist/path.d.ts +1 -1
  348. package/dist/node_modules/@allyhub/slides-core/dist/resolve.d.ts +20 -11
  349. package/dist/node_modules/@allyhub/slides-core/dist/resolve.js +1 -1
  350. package/dist/node_modules/@allyhub/slides-core/dist/sdk.d.ts +18 -0
  351. package/dist/node_modules/@allyhub/slides-core/dist/sdk.js +2 -0
  352. package/dist/node_modules/@allyhub/slides-core/dist/stage.d.ts +28 -11
  353. package/dist/node_modules/@allyhub/slides-core/dist/units.d.ts +3 -6
  354. package/dist/node_modules/@allyhub/slides-core/dist/units.js +1 -1
  355. package/dist/node_modules/@allyhub/slides-core/package.json +5 -1
  356. package/dist/node_modules/@allyhub/video-core/dist/audio-types.d.ts +1 -2
  357. package/dist/node_modules/@allyhub/video-core/dist/captions.d.ts +1 -10
  358. package/dist/node_modules/@allyhub/video-core/dist/captions.js +1 -1
  359. package/dist/node_modules/@allyhub/video-core/dist/check.d.ts +62 -0
  360. package/dist/node_modules/@allyhub/video-core/dist/check.js +2 -0
  361. package/dist/node_modules/@allyhub/video-core/dist/cut-report.d.ts +2 -2
  362. package/dist/node_modules/@allyhub/video-core/dist/cut-report.js +1 -1
  363. package/dist/node_modules/@allyhub/video-core/dist/edits.d.ts +3 -3
  364. package/dist/node_modules/@allyhub/video-core/dist/edits.js +1 -1
  365. package/dist/node_modules/@allyhub/video-core/dist/fact.d.ts +21 -762
  366. package/dist/node_modules/@allyhub/video-core/dist/fact.js +1 -1
  367. package/dist/node_modules/@allyhub/video-core/dist/footage-motion.d.ts +3 -2
  368. package/dist/node_modules/@allyhub/video-core/dist/footage-motion.js +1 -1
  369. package/dist/node_modules/@allyhub/video-core/dist/index.d.ts +3 -17
  370. package/dist/node_modules/@allyhub/video-core/dist/index.js +1 -1
  371. package/dist/node_modules/@allyhub/video-core/dist/measure.d.ts +72 -423
  372. package/dist/node_modules/@allyhub/video-core/dist/measure.js +1 -4
  373. package/dist/node_modules/@allyhub/video-core/dist/mix-plan.d.ts +44 -0
  374. package/dist/node_modules/@allyhub/video-core/dist/mix-plan.js +2 -0
  375. package/dist/node_modules/@allyhub/video-core/dist/motion.d.ts +1 -1
  376. package/dist/node_modules/@allyhub/video-core/dist/piece.d.ts +24 -432
  377. package/dist/node_modules/@allyhub/video-core/dist/piece.js +1 -1
  378. package/dist/node_modules/@allyhub/video-core/dist/placement.d.ts +1 -1
  379. package/dist/node_modules/@allyhub/video-core/dist/schema.d.ts +8 -14
  380. package/dist/node_modules/@allyhub/video-core/dist/schema.js +1 -1
  381. package/dist/node_modules/@allyhub/video-core/dist/script-edit.d.ts +11 -6
  382. package/dist/node_modules/@allyhub/video-core/dist/script-edit.js +1 -1
  383. package/dist/node_modules/@allyhub/video-core/dist/seams.d.ts +2 -3
  384. package/dist/node_modules/@allyhub/video-core/dist/sound-under.d.ts +2 -2
  385. package/dist/node_modules/@allyhub/video-core/dist/sound-under.js +1 -1
  386. package/dist/node_modules/@allyhub/video-core/dist/speech.d.ts +2 -4
  387. package/dist/node_modules/@allyhub/video-core/dist/speech.js +2 -2
  388. package/dist/node_modules/@allyhub/video-core/dist/stage.d.ts +52 -0
  389. package/dist/node_modules/@allyhub/video-core/dist/stage.js +2 -0
  390. package/dist/node_modules/@allyhub/video-core/dist/timeline.d.ts +18 -136
  391. package/dist/node_modules/@allyhub/video-core/dist/timeline.js +1 -1
  392. package/dist/node_modules/@allyhub/video-core/dist/timing.d.ts +3 -3
  393. package/dist/node_modules/@allyhub/video-core/dist/timing.js +1 -1
  394. package/dist/node_modules/@allyhub/video-core/dist/transcript.d.ts +2 -2
  395. package/dist/node_modules/@allyhub/video-core/dist/transcript.js +1 -1
  396. package/dist/node_modules/@allyhub/video-core/package.json +1 -1
  397. package/dist/node_modules/@allyhub/video-sdk/LICENSE +241 -0
  398. package/dist/node_modules/@allyhub/video-sdk/NOTICE +118 -0
  399. package/dist/{free.d.ts → node_modules/@allyhub/video-sdk/dist/free.d.ts} +14 -10
  400. package/dist/node_modules/@allyhub/video-sdk/dist/free.js +2 -0
  401. package/dist/node_modules/@allyhub/video-sdk/dist/index.d.ts +28 -0
  402. package/dist/node_modules/@allyhub/video-sdk/dist/index.js +2 -0
  403. package/dist/{input.d.ts → node_modules/@allyhub/video-sdk/dist/input.d.ts} +76 -22
  404. package/dist/node_modules/@allyhub/video-sdk/dist/input.js +2 -0
  405. package/dist/{module.d.ts → node_modules/@allyhub/video-sdk/dist/module.d.ts} +6 -4
  406. package/dist/node_modules/@allyhub/video-sdk/dist/module.js +2 -0
  407. package/dist/{parts.d.ts → node_modules/@allyhub/video-sdk/dist/parts.d.ts} +15 -6
  408. package/dist/node_modules/@allyhub/video-sdk/dist/parts.js +2 -0
  409. package/dist/{phone.d.ts → node_modules/@allyhub/video-sdk/dist/phone.d.ts} +12 -5
  410. package/dist/node_modules/@allyhub/video-sdk/dist/phone.js +2 -0
  411. package/dist/{piece.d.ts → node_modules/@allyhub/video-sdk/dist/piece.d.ts} +26 -16
  412. package/dist/node_modules/@allyhub/video-sdk/dist/piece.js +2 -0
  413. package/dist/node_modules/@allyhub/video-sdk/dist/route.d.ts +46 -0
  414. package/dist/node_modules/@allyhub/video-sdk/dist/route.js +2 -0
  415. package/dist/node_modules/@allyhub/video-sdk/dist/scenery.d.ts +2 -0
  416. package/dist/node_modules/@allyhub/video-sdk/dist/scenery.js +2 -0
  417. package/dist/node_modules/@allyhub/video-sdk/package.json +19 -0
  418. package/dist/scenery.d.ts +1 -1
  419. package/dist/scenery.js +1 -1
  420. package/dist/sheets.d.ts +1 -1
  421. package/dist/sheets.js +1 -1
  422. package/dist/slides.d.ts +1 -9
  423. package/dist/slides.js +1 -1
  424. package/docs/README.md +10 -6
  425. package/docs/batches.md +5 -5
  426. package/docs/canvas.md +28 -0
  427. package/docs/contract.md +2 -2
  428. package/docs/defaults.md +298 -22
  429. package/docs/docs.md +80 -66
  430. package/docs/footage.md +7 -7
  431. package/docs/image.md +165 -0
  432. package/docs/layers.md +22 -13
  433. package/docs/modeling.md +4 -4
  434. package/docs/pictures.md +65 -0
  435. package/docs/project.md +51 -31
  436. package/docs/scenery.md +14 -15
  437. package/docs/sheets.md +46 -28
  438. package/docs/slides.md +121 -67
  439. package/docs/sound.md +3 -3
  440. package/docs/speech.md +8 -8
  441. package/docs/video.md +16 -13
  442. package/docs/websites.md +4 -4
  443. package/docs/x.md +73 -0
  444. package/package.json +7 -2
  445. package/dist/define.js +0 -2
  446. package/dist/free.js +0 -2
  447. package/dist/input.js +0 -2
  448. package/dist/module.js +0 -2
  449. package/dist/node_modules/@allyhub/formats/dist/data/comments.d.ts +0 -94
  450. package/dist/node_modules/@allyhub/formats/dist/data/comments.js +0 -2
  451. package/dist/node_modules/@allyhub/runtimes/pins/onnxruntime-node/package-lock.json +0 -227
  452. package/dist/node_modules/@allyhub/runtimes/pins/onnxruntime-node/package.json +0 -8
  453. package/dist/node_modules/@allyhub/runtimes/pins/sherpa-onnx-node/package-lock.json +0 -105
  454. package/dist/node_modules/@allyhub/runtimes/pins/sherpa-onnx-node/package.json +0 -8
  455. package/dist/node_modules/@allyhub/runtimes/pins/tesseract.js/package-lock.json +0 -128
  456. package/dist/node_modules/@allyhub/runtimes/pins/tesseract.js/package.json +0 -9
  457. package/dist/node_modules/@allyhub/video-core/dist/export.js +0 -2
  458. package/dist/node_modules/@allyhub/video-core/dist/formats.js +0 -2
  459. package/dist/node_modules/@allyhub/video-core/dist/gen.d.ts +0 -37
  460. package/dist/node_modules/@allyhub/video-core/dist/problem.d.ts +0 -278
  461. package/dist/node_modules/@allyhub/video-core/dist/problem.js +0 -2
  462. package/dist/node_modules/@allyhub/video-core/dist/script.js +0 -2
  463. package/dist/node_modules/@allyhub/video-core/dist/source.d.ts +0 -7
  464. package/dist/parts.js +0 -2
  465. package/dist/phone.js +0 -2
  466. package/dist/piece.js +0 -2
  467. /package/dist/node_modules/@allyhub/{sheet → formats}/dist/csv.d.ts +0 -0
  468. /package/dist/node_modules/@allyhub/{sheet → formats}/dist/csv.js +0 -0
  469. /package/dist/{fit.d.ts → node_modules/@allyhub/image-sdk/dist/fit.d.ts} +0 -0
  470. /package/dist/{fit.js → node_modules/@allyhub/image-sdk/dist/fit.js} +0 -0
  471. /package/dist/{messages.js → node_modules/@allyhub/image-sdk/dist/messages.js} +0 -0
  472. /package/dist/{props.js → node_modules/@allyhub/image-sdk/dist/props.js} +0 -0
  473. /package/dist/{text.d.ts → node_modules/@allyhub/image-sdk/dist/text.d.ts} +0 -0
  474. /package/dist/{text.js → node_modules/@allyhub/image-sdk/dist/text.js} +0 -0
  475. /package/dist/{written.d.ts → node_modules/@allyhub/image-sdk/dist/written.d.ts} +0 -0
  476. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/anchors.js +0 -0
  477. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/component.d.ts +0 -0
  478. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/console.d.ts +0 -0
  479. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/console.js +0 -0
  480. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/contrast.js +0 -0
  481. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/gen.js +0 -0
  482. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/look.js +0 -0
  483. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/marks.d.ts +0 -0
  484. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/marks.js +0 -0
  485. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/matrix.d.ts +0 -0
  486. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/matrix.js +0 -0
  487. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/messages.js +0 -0
  488. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/source.js +0 -0
  489. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/voice.js +0 -0
  490. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/words.d.ts +0 -0
  491. /package/dist/node_modules/@allyhub/{video-core → piece}/dist/words.js +0 -0
  492. /package/dist/{anim.d.ts → node_modules/@allyhub/video-sdk/dist/anim.d.ts} +0 -0
  493. /package/dist/{anim.js → node_modules/@allyhub/video-sdk/dist/anim.js} +0 -0
  494. /package/dist/{noise.d.ts → node_modules/@allyhub/video-sdk/dist/noise.d.ts} +0 -0
  495. /package/dist/{noise.js → node_modules/@allyhub/video-sdk/dist/noise.js} +0 -0
  496. /package/dist/{paths.d.ts → node_modules/@allyhub/video-sdk/dist/paths.d.ts} +0 -0
  497. /package/dist/{paths.js → node_modules/@allyhub/video-sdk/dist/paths.js} +0 -0
package/docs/README.md CHANGED
@@ -2,18 +2,22 @@
2
2
 
3
3
  What a piece is written with, for the version of the SDK installed beside them. Read the file a piece needs before writing it. Commands are not here: `allyhub help` lists them, `allyhub help <command>` says what one does and its options' defaults. Every export also has its documentation in JSDoc.
4
4
 
5
- - [project.md](project.md): a project's folders, items and their entry files, the SDK bound to the file that imports it, imports of media, data and other items, scripts and shared text, `allyhub.config.ts`, fonts.
5
+ - [project.md](project.md): a project's folders, its list of work (`allyhub.yaml`) and items, the SDK bound to the file that imports it, imports of media, data and other items, scripts and shared text, `allyhub.config.ts`, fonts.
6
6
  - [contract.md](contract.md): what the build, the check and the render rely on: a piece drawn from time alone, what piece code may not do, the rules a problem is reported under.
7
7
  - [video.md](video.md): `video()`, formats, `part()`, a part's length, layers and their stacking, transitions, the look, covers, the camera filming the picture, post.
8
- - [layers.md](layers.md): `defineComponent()` and its prop types, `custom()`, the layer's `ctx`, the DOM and layout helpers, animation, text, path and noise helpers, and a person's input as functions of time (`pointer`, `reach`, `tap`, `drag`, scrolling, typing: how a hand moves a cursor, a finger or a pointer), starter components.
8
+ - [layers.md](layers.md): `defineComponent()` and its prop types, `custom()`, the layer's `ctx`, the DOM and layout helpers, animation, text, path and noise helpers, and a person's input as functions of time (`cursor`, a mouse's that glides; `handPath`, a hand's; `reach`, `tap`, `drag`, scrolling, typing), starter components.
9
9
  - [speech.md](speech.md): `take()`, `say()`, word references, anchors, shown and said text, captions, edits files.
10
10
  - [sound.md](sound.md): music, sound effects, the mix, the master, how the voice was recorded.
11
11
  - [footage.md](footage.md): `footage()` layers: placing, cropping, reframing, punch-ins, faces and mattes, the background behind the person, a video item inside another.
12
- - [slides.md](slides.md): `presentation()`, masters, layouts and shapes, `slides.yaml`, a deck's script, what a deck renders to.
12
+ - [pictures.md](pictures.md): `picture()`, a still in CSS's terms: fit, focal point, crop, mask, corners, blend mode, filter; `footage()` of a still; a deck's crop to fill and fit.
13
+ - [slides.md](slides.md): `presentation()`, masters, layouts and shapes, a deck's slides file and script, what a deck renders to.
14
+ - [image.md](image.md): `image()` and its boards, each its own size or as tall as it holds; layers named by `key`; words; what an image checks, measures and renders to.
13
15
  - [batches.md](batches.md): the matrix: dimensions, slots, pools, structures, rules, combos.
14
16
  - [scenery.md](scenery.md): 3D sceneries: `defineScenery()`, cameras and their moves, the hand that holds one, the `scenery()` layer and its screens.
15
17
  - [modeling.md](modeling.md): a prop modelled in code with `@allyhub/model` and put in a scenery.
16
- - [docs.md](docs.md): a doc, `doc.mdx`: its title, the Markdown and tags it reads, pictures and links, `comments.json`, check and render.
17
- - [sheets.md](sheets.md): a sheet, a workbook as `sheet.yaml` and CSV: tables, formulas, names, checks, the openpyxl API (`@allyhub/sdk/sheets`), calc, trace and render.
18
- - [websites.md](websites.md): a website, any web project with `website.json`: how Studio serves it while it is made (`PORT`, `HOST`, the preview hosts), a project's videos in its pages, its build.
18
+ - [docs.md](docs.md): a doc, one MDX file: its title, the Markdown and tags it reads, pictures and links, check and render.
19
+ - [sheets.md](sheets.md): a sheet, a workbook as YAML and CSV: tables, formulas, names, checks, the openpyxl API (`@allyhub/sdk/sheets`), calc, trace and render.
20
+ - [canvas.md](canvas.md): a canvas, a JSON Canvas file laying a project's work out with notes, groups and edges.
21
+ - [x.md](x.md): an X post, thread or long post in POST /2/tweets's fields, and an X article in X's blocks: what X counts and refuses, and what they render to.
22
+ - [websites.md](websites.md): a website, any web project with its JSON file: how Studio serves it while it is made (`PORT`, `HOST`, the preview hosts), a project's videos in its pages, its build.
19
23
  - [defaults.md](defaults.md): every default of the piece API, generated from the code's constants, with the option that changes it.
package/docs/batches.md CHANGED
@@ -6,7 +6,7 @@ A piece's `matrix` says which versions of it are made. Each version is a **combo
6
6
 
7
7
  `matrix.dims` are dimensions and their values, crossed in full: `{ lang: ["en", "zh-cn"], audience: ["dev", "ops"] }` makes four combos.
8
8
 
9
- - `lang` is the one dimension AllyHub reads: it picks each item's `script.<lang>.yaml` and `assets/text/<lang>.json`, the first value being the default language. Its values are lowercase language tags (`en`, `zh-cn`). Without `lang`, a piece's languages are the project's: the languages its scripts and shared text have, `allyhub.config.ts`'s `locales` first.
9
+ - `lang` is the one dimension AllyHub reads: it picks the file of each item's script in that language and `assets/text/<lang>.json`, the first value being the default language. Its values are lowercase language tags (`en`, `zh-cn`). Without `lang`, a piece's languages are its script's and the shared text's, `allyhub.config.ts`'s `locales` first.
10
10
  - Other dimensions are the piece's: its parts function reads them from `ctx.combo`.
11
11
  - A name starts with a lowercase letter (then letters, digits, `_`, `-`); a value is letters, digits, `.`, `_`, `-`, each listed once. `size`, `format`, `piece`, `output`, `token`, `structure` and `id` name no dimension or slot. A wrong name or value is AK-M001.
12
12
  - A combo's **key** is its names sorted, each `name=value`, joined with commas: `audience=dev,lang=en` (`default` when there are none). It filters commands' `--combo` (`--combo lang=zh-cn`); the rendered files carry its values, after the name of the piece's folder (`.allyhub/out/launch/launch.dev.en.mp4`).
@@ -15,7 +15,7 @@ A piece's `matrix` says which versions of it are made. Each version is a **combo
15
15
 
16
16
  An ad is a structure of **slots** (a hook, a demo, a call to action), each with **candidates**. The matrix chooses which slot combinations to make; each chosen one is crossed with every combo of the dimensions.
17
17
 
18
- ```ts file=ads/tidyform/video.ts
18
+ ```ts file=ads/tidyform/tidyform.ts
19
19
  import { footage, part, say, video } from "@allyhub/sdk";
20
20
 
21
21
  export default video({
@@ -68,7 +68,7 @@ export default video({
68
68
 
69
69
  ### Pools
70
70
 
71
- `{ pool: "./pool/demos", tags? }` makes one candidate per media file (video, audio or picture) directly in the folder, named by the file's stem. The folder is relative to the item's entry file (`/` first: from the project's root). `tags` go to every file; a file's `<stem>.meta.json` adds its own:
71
+ `{ pool: "./pool/demos", tags? }` makes one candidate per media file (video, audio or picture) directly in the folder, named by the file's stem. The folder is relative to the piece's file (`/` first: from the project's root). `tags` go to every file; a file's `<stem>.meta.json` adds its own:
72
72
 
73
73
  ```json
74
74
  { "tags": ["inbox", "short"] }
@@ -93,7 +93,7 @@ Each pick keeps a reason in a few words. Sampling looks at no more than 100,000
93
93
 
94
94
  `combos` names the slot combinations to make, in order: each names `structure` when the piece declares structures, and one candidate per slot of it, never a dimension. Nothing is sampled.
95
95
 
96
- ```ts file=ads/chosen/video.ts
96
+ ```ts file=ads/chosen/chosen.ts
97
97
  import { part, video } from "@allyhub/sdk";
98
98
 
99
99
  export default video({
@@ -144,5 +144,5 @@ The check loads only a few combos that between them hold every candidate, and pu
144
144
  ## Commands
145
145
 
146
146
  - `allyhub inspect combos` prints each piece's slots, rules, the chosen combos with why, and what rendering them costs in part renders, without a browser.
147
- - `allyhub render <piece> --type csv` writes the batch's table of ads, `<piece>/ads.csv`: a row per ad with its combo, picks, length, file, name and the generated media it uses.
147
+ - `allyhub render <piece> --type csv` writes the batch's table of ads, `<piece>.ads.csv`: a row per ad with its combo, picks, length, file, name and the generated media it uses.
148
148
  - `allyhub render` renders every combo; `--combo` narrows it.
package/docs/canvas.md ADDED
@@ -0,0 +1,28 @@
1
+ # Canvases
2
+
3
+ A canvas lays a project's work out to be seen together: items side by side, with notes, groups and edges. It draws nothing of its own and exports nothing. It is a `.canvas` file anywhere in the project, in [JSON Canvas 1.0](https://jsoncanvas.org) as Obsidian writes it, listed in `allyhub.yaml` with no `kind` (`- file: boards/launch.canvas`, [project.md](project.md#items)): its editor opens it by its name.
4
+
5
+ <!-- prettier-ignore -->
6
+ ```json
7
+ {
8
+ "nodes":[
9
+ {"id":"7d1f0c3a9b2e4f60","type":"group","label":"Share pictures","x":-40,"y":-80,"width":1360,"height":520},
10
+ {"id":"2b9e81c04d7f3a15","type":"file","file":"launch/og/og.ts","x":0,"y":0,"width":600,"height":340},
11
+ {"id":"c04d7f3a152b9e81","type":"text","text":"**Why this plate**: the river reads at 400 px.","x":640,"y":0,"width":320,"height":160,"color":"4"},
12
+ {"id":"9a6e2f10b3c84d57","type":"link","url":"https://example.com/launch","x":640,"y":200,"width":320,"height":120}
13
+ ],
14
+ "edges":[
15
+ {"id":"5e3a9c1d7b0f2846","fromNode":"c04d7f3a152b9e81","fromSide":"left","toNode":"2b9e81c04d7f3a15","toSide":"right","label":"chosen"}
16
+ ]
17
+ }
18
+ ```
19
+
20
+ - **Paths are from the project's folder**, wherever the canvas is.
21
+ - **A file node points at an item by its file**, as `allyhub.yaml` lists it (`launch/og/og.ts`); it shows the item's own preview, live: an image's boards, a deck's slide, a video's still, a doc's first words. Any other file (a picture, a clip, a sound) shows itself.
22
+ - **Nodes**: `text` (Markdown), `file`, `link` (`url`) and `group` (`label`), each with whole-pixel `x`, `y`, `width` and `height`; y grows down. The first node is drawn at the back, so a group comes before what it holds. A group holds the nodes whose boxes are inside its box.
23
+ - **Edges** join two nodes by id, from a side (`top`, `right`, `bottom`, `left`) to a side, with a `label`; `toEnd` is an arrow unless `"none"`.
24
+ - **Colours** are `"1"` red, `"2"` orange, `"3"` yellow, `"4"` green, `"5"` cyan, `"6"` purple, or a hex colour.
25
+ - **Ids** are unique across nodes and edges: 16 hex digits, as Obsidian makes them.
26
+ - **A person's changes** (moves, notes, edges) are written to the same file, which keeps the ids and the fields it does not know.
27
+
28
+ `allyhub check` reports a duplicate id, a file node at a missing file and an edge at a missing node (AK-C001 to AK-C004). `allyhub inspect canvas <file>` lists the nodes with their boxes and what they point at, what each group holds and each edge's ends.
package/docs/contract.md CHANGED
@@ -30,14 +30,14 @@ What the build, the check and the render rely on. Everything else is the piece's
30
30
 
31
31
  | Codes | Area |
32
32
  | --- | --- |
33
- | `AK-M…` | An item, a file's format: a piece's fields, entry files, scripts, messages, docs, sheets |
33
+ | `AK-M…` | An item, a file's format: a piece's fields, the list of work, scripts, messages, docs, sheets |
34
34
  | `AK-B…` | The build: ids, network, time, imports, the installed SDK |
35
35
  | `AK-K…` | Parts: keys, a piece without parts |
36
36
  | `AK-D…` | Determinism |
37
37
  | `AK-T…` | Speech: word times, generated voices, ranges, word references, anchors, edits files |
38
38
  | `AK-S…` | Text: a missing key (S001), a missing translation (S002, a warning) |
39
39
  | `AK-A…` | Media and data files |
40
- | `AK-F…`, `AK-G…` | A platform profile's limits; an unknown format |
40
+ | `AK-G…` | An unknown format |
41
41
  | `AK-P…` | Loading and drawing time |
42
42
  | `AK-R…`, `AK-N…` | Run time: an exception, the page changed, a style refused; a request blocked |
43
43
  | `AK-L…` | Layout and fonts: text cut at the frame's edge, missing glyphs, fallback fonts (warnings) |
package/docs/defaults.md CHANGED
@@ -6,7 +6,7 @@ Every default of the piece API that is a constant in the code, with what it hold
6
6
 
7
7
  ### Formats
8
8
 
9
- The presets (`PRESETS`): pixels, and the edges a platform's interface covers (`ctx.dims.safe`), changed by `format: { format, safe }`. A `WIDTHxHEIGHT` format covers none.
9
+ The presets (`PRESETS`): pixels, and the edges an interface over the video may cover (`ctx.dims.safe`), changed by `format: { format, safe }`. A `WIDTHxHEIGHT` format covers none.
10
10
 
11
11
  | Format | Pixels | Covered: top, bottom, left, right |
12
12
  | --- | --- | --- |
@@ -15,17 +15,6 @@ The presets (`PRESETS`): pixels, and the edges a platform's interface covers (`c
15
15
  | `1x1` | 1080 × 1080 | 50, 90, 40, 40 |
16
16
  | `4x5` | 1080 × 1350 | 60, 120, 40, 40 |
17
17
 
18
- The platform profiles (`PROFILES`): the frame, the edges the platform's interface covers, the longest video in seconds (AK-F001; `format: { format, maxDuration }`), the loudness its sound is mastered to in LUFS (`format: { format, loudness }`, `video({ master })`), and the crf and most video bitrate in kbit/s `allyhub render` encodes its mp4 at.
19
-
20
- | Profile | Platform | Pixels | Covered: top, bottom, left, right | Longest | Loudness | crf | Most kbit/s |
21
- | --- | --- | --- | --- | --- | --- | --- | --- |
22
- | `tiktok` | TikTok | 1080 × 1920 | 240, 660, 120, 180 | 600 | -14 | 20 | 6000 |
23
- | `reels` | Instagram Reels | 1080 × 1920 | 269, 672, 65, 65 | 180 | -14 | 20 | 6000 |
24
- | `shorts` | YouTube Shorts | 1080 × 1920 | 288, 672, 48, 192 | 180 | -14 | 20 | 8000 |
25
- | `meta-feed` | Facebook and Instagram feed | 1080 × 1350 | 60, 120, 40, 40 | 14460 | -14 | 20 | 6000 |
26
- | `amazon` | Amazon Sponsored Brands video | 1920 × 1080 | 60, 90, 80, 80 | 45 | -14 | 20 | 8000 |
27
- | `linkedin` | LinkedIn | 1080 × 1080 | 50, 90, 40, 40 | 1800 | -14 | 20 | 6000 |
28
-
29
18
  ### `FPS`
30
19
 
31
20
  Frames per second of a video. `video({ fps })`.
@@ -161,7 +150,7 @@ A shape `add_shape` makes, as python-pptx makes it (the theme's styles it is dra
161
150
 
162
151
  ### `CONNECTOR_STYLE`
163
152
 
164
- A connector `add_connector` makes (a straight line, an elbow, a curve), as python-pptx makes it: the theme's second line, 1 pt, in accent 1, with no fill and no text. A connector in `slides.yaml` (`geometry: line`, `straightConnector1`, `bentConnector2` to `5`, `curvedConnector2` to `5`) has it too. Its `line` changes it.
153
+ A connector `add_connector` makes (a straight line, an elbow, a curve), as python-pptx makes it: the theme's second line, 1 pt, in accent 1, with no fill and no text. A connector in a deck's slides file (`geometry: line`, `straightConnector1`, `bentConnector2` to `5`, `curvedConnector2` to `5`) has it too. Its `line` changes it.
165
154
 
166
155
  | Key | Value |
167
156
  | --- | --- |
@@ -170,7 +159,7 @@ A connector `add_connector` makes (a straight line, an elbow, a curve), as pytho
170
159
 
171
160
  ### `SHADOW_DEFAULTS`
172
161
 
173
- A shape's shadow where a `shadow` in `slides.yaml` or `shape.shadow` says nothing: `color`, `blur` and `distance` (EMU), `angle` (degrees clockwise from the right), `transparency` (a share).
162
+ A shape's shadow where a `shadow` in a deck's slides file or `shape.shadow` says nothing: `color`, `blur` and `distance` (EMU), `angle` (degrees clockwise from the right), `transparency` (a share).
174
163
 
175
164
  | Key | Value |
176
165
  | --- | --- |
@@ -182,7 +171,7 @@ A shape's shadow where a `shadow` in `slides.yaml` or `shape.shadow` says nothin
182
171
 
183
172
  ### `SLIDE_SECONDS`
184
173
 
185
- A slide's window on the stage's clock, seconds: a still of it is drawn at its end, when what moves in its components has settled.
174
+ A slide's window on the stage's clock, seconds: a still of it is drawn at its end, when what moves in its components has settled. It is also how long a component moves, which its `dur` changes (in the slides file, or `add_component`'s `{ dur }`): its slide rests no sooner, and a PowerPoint file's video of it is that long.
186
175
 
187
176
  Value: `4`
188
177
 
@@ -202,7 +191,7 @@ Value: `0.5625`
202
191
 
203
192
  ### `CHART_PALETTE`
204
193
 
205
- A `<Chart>`'s colours, a series (a pie's slice) each, in turn: the page's `accent` takes the first, its `colors` take them in order. A `<Chart>`'s frame is a `<Component>`'s: `COMPONENT_WIDTH` wide and `COMPONENT_ASPECT` high when it gives no `width` or `height`; its legend is beside a pie, under more than one series and absent for one, unless `legend` says.
194
+ A `<Chart>`'s colours, a series (a pie's slice) each, in turn: the page's `accent` (else this list's first) takes the first, the same colour lighter (`CHART_SECOND_TONE`) the second, then this list; its `colors` take them in order. A `<Chart>`'s frame is a `<Component>`'s: `COMPONENT_WIDTH` wide and `COMPONENT_ASPECT` high when it gives no `width` or `height`; its legend is beside a pie, over more than one series and absent for one, unless `legend` says.
206
195
 
207
196
  Value: `["#2A78D6","#EB6834","#1BAF7A","#EDA100","#E87BA4","#008300"]`
208
197
 
@@ -217,10 +206,50 @@ A `<Chart>`'s text and title sizes, points.
217
206
 
218
207
  ### `COVER_HEIGHT_MM`
219
208
 
220
- A doc's cover on paper: a band across the top of the first page, edge to edge, this many millimetres high (A4 is 210 wide); its picture fills it at its `cover-y`.
209
+ A doc's cover on paper: a band across the top of the first page, edge to edge, this many millimetres high (Letter is 215.9 wide); its picture fills it at its `cover-y`.
221
210
 
222
211
  Value: `64`
223
212
 
213
+ ### `PAGE_DEFAULTS`
214
+
215
+ A doc's page when its front matter does not set it: the paper (`paper`), its margins in mm (`margins`), the text's size in pt (`size`), its line height (`line-height`), first-line indent in characters (`text-indent`), the space between paragraphs in em (`paragraph-spacing`), each heading's size as a multiple of the text's (a heading's `size`), and the footer (`footer`; `page-numbers: false` drops it). A `preset` sets these as its convention does, under the doc's own keys.
216
+
217
+ | Key | Value |
218
+ | --- | --- |
219
+ | `paper` | `"letter"` |
220
+ | `margins.top` | `18` |
221
+ | `margins.right` | `20` |
222
+ | `margins.bottom` | `18` |
223
+ | `margins.left` | `20` |
224
+ | `size` | `11` |
225
+ | `lineHeight` | `1.15` |
226
+ | `textIndent` | `0` |
227
+ | `paragraphSpacing` | `0.5` |
228
+ | `headingScale.1` | `1.75` |
229
+ | `headingScale.2` | `1.45` |
230
+ | `headingScale.3` | `1.15` |
231
+ | `headingScale.4` | `1` |
232
+ | `headingScale.5` | `1` |
233
+ | `headingScale.6` | `1` |
234
+ | `headingScale.title` | `2.3` |
235
+ | `footer.left` | `"{title}"` |
236
+ | `footer.right` | `"{page} / {pages}"` |
237
+
238
+ ### `PICTURE_DPI`
239
+
240
+ How sharp a doc's pictures are on paper: each is drawn again at no more than this many dots an inch of the page it is set on (Word's Default resolution), a JPEG where it has no transparent pixel; front matter's `picture-dpi` sets it, `picture-dpi: false` prints them as they are.
241
+
242
+ Value: `220`
243
+
244
+ ### `PAGE_FACT_DEFAULTS`
245
+
246
+ What `allyhub inspect pages` lists without `--all`: a heading with fewer lines than `headingLines` after it on its page (`--heading-lines`), a paragraph whose last line holds `shortChars` letters or fewer (`--short-line`).
247
+
248
+ | Key | Value |
249
+ | --- | --- |
250
+ | `headingLines` | `3` |
251
+ | `shortChars` | `2` |
252
+
224
253
  ### `ROUND_FRAME`
225
254
 
226
255
  A pie's or a doughnut's frame when it gives no `width` or `height`: at most this many pixels wide, and this high over its width, so its legend stays beside it.
@@ -239,6 +268,17 @@ A bar or column chart's bars: the gap between groups, % of a bar (Office's `gap_
239
268
  | `gap` | `80` |
240
269
  | `overlap` | `-8` |
241
270
 
271
+ ## Sheets
272
+
273
+ ### `ITERATION_DEFAULTS`
274
+
275
+ A sheet's iterative calculation, Excel's own limits: how many rounds at most, and the change under which it stops. The workbook file's `iteration: { max_iterations, max_change }`.
276
+
277
+ | Key | Value |
278
+ | --- | --- |
279
+ | `max_iterations` | `100` |
280
+ | `max_change` | `0.001` |
281
+
242
282
  ## Importing
243
283
 
244
284
  ### `ZIP_LIMITS`
@@ -330,7 +370,7 @@ Each stem's loudness target in LUFS, the music's dip under words and its fades i
330
370
 
331
371
  ### `MASTER_DEFAULTS`
332
372
 
333
- The master's loudness in LUFS (a platform profile's loudness comes first) and its true-peak ceiling in dBTP. `video({ master })`.
373
+ The master's loudness in LUFS and its true-peak ceiling in dBTP. `video({ master })`.
334
374
 
335
375
  | Key | Value |
336
376
  | --- | --- |
@@ -541,7 +581,7 @@ A camera filming the picture: a mark's values when it is asked for without them.
541
581
 
542
582
  ### `SHARE_ENCODE`
543
583
 
544
- How `allyhub render` and an editor's Export encode an mp4 whose format is no platform profile, ready to share on social media: H.264's crf, and the most video bitrate in kbit/s for a frame of `width` × `height` at `fps`, scaled by the pixels a second of the video's own (16000 at 1080p 60, 32000 at 4K 30). `--param crf`, `--param max-bitrate` (0 for none).
584
+ How `allyhub render` and an editor's Export encode an mp4 when nothing chooses otherwise, ready to share on social media: H.264's crf, and the most video bitrate in kbit/s for a frame of `width` × `height` at `fps`, scaled by the pixels a second of the video's own (16000 at 1080p 60, 32000 at 4K 30). `--param crf`, `--param max-bitrate` (0 for none).
545
585
 
546
586
  | Key | Value |
547
587
  | --- | --- |
@@ -563,6 +603,212 @@ How far the person's edge is pulled in, px at 1080p. `footage({ background: { sh
563
603
 
564
604
  Value: `4`
565
605
 
606
+ ### `PICTURE_DEFAULTS`
607
+
608
+ How a still fills its box (CSS's `object-fit`), and the point of it at the same point of the box, as shares (CSS's `object-position`). `picture({ fit, position })`; a deck's Crop to Fill and Fit centre it the same way.
609
+
610
+ | Key | Value |
611
+ | --- | --- |
612
+ | `fit` | `"cover"` |
613
+ | `position` | `[0.5,0.5]` |
614
+
615
+ ## Images
616
+
617
+ ### `BOARD_DEFAULTS`
618
+
619
+ A board whose height grows with what it holds: the height its layers are laid out at before it is measured (the least it is), and the most it grows to, px; its resolution (ppi) and colour profile, metadata for print and PSD. `board({ height: "auto", minHeight, maxHeight, resolution, colorProfile })`.
620
+
621
+ | Key | Value |
622
+ | --- | --- |
623
+ | `minHeight` | `64` |
624
+ | `maxHeight` | `16384` |
625
+ | `resolution` | `72` |
626
+ | `colorProfile` | `"sRGB IEC61966-2.1"` |
627
+
628
+ ### `LAYER_STYLE_DEFAULTS`
629
+
630
+ What every layer is when it says nothing: its blend mode (a group's passThrough), opacity and fill opacity (percent), clipping, visibility, and a mask's alpha mode, density (percent), feather (px) and inversion. Each layer's `blendMode`, `opacity`, `fillOpacity`, `clipping`, `visible`, `mask`.
631
+
632
+ | Key | Value |
633
+ | --- | --- |
634
+ | `blendMode` | `"normal"` |
635
+ | `groupBlendMode` | `"passThrough"` |
636
+ | `opacity` | `100` |
637
+ | `fillOpacity` | `100` |
638
+ | `clipping` | `false` |
639
+ | `visible` | `true` |
640
+ | `mask.mode` | `"alpha"` |
641
+ | `mask.density` | `100` |
642
+ | `mask.feather` | `0` |
643
+ | `mask.invert` | `false` |
644
+
645
+ ### `EFFECT_DEFAULTS`
646
+
647
+ Each layer style's settings when it gives none, Photoshop's own: blend mode, colour, opacity (percent), the light's angle (degrees counter-clockwise from the right), distance, size, spread and choke (px and percent), a bevel's depth, altitude and highlight and shadow. A layer's `effects: { dropShadow: { … } }`.
648
+
649
+ | Key | Value |
650
+ | --- | --- |
651
+ | `dropShadow.blendMode` | `"multiply"` |
652
+ | `dropShadow.color` | `"#000000"` |
653
+ | `dropShadow.opacity` | `75` |
654
+ | `dropShadow.angle` | `120` |
655
+ | `dropShadow.distance` | `5` |
656
+ | `dropShadow.spread` | `0` |
657
+ | `dropShadow.size` | `5` |
658
+ | `innerShadow.blendMode` | `"multiply"` |
659
+ | `innerShadow.color` | `"#000000"` |
660
+ | `innerShadow.opacity` | `75` |
661
+ | `innerShadow.angle` | `120` |
662
+ | `innerShadow.distance` | `5` |
663
+ | `innerShadow.choke` | `0` |
664
+ | `innerShadow.size` | `5` |
665
+ | `outerGlow.blendMode` | `"screen"` |
666
+ | `outerGlow.color` | `"#ffffbe"` |
667
+ | `outerGlow.opacity` | `75` |
668
+ | `outerGlow.spread` | `0` |
669
+ | `outerGlow.size` | `5` |
670
+ | `innerGlow.blendMode` | `"screen"` |
671
+ | `innerGlow.color` | `"#ffffbe"` |
672
+ | `innerGlow.opacity` | `75` |
673
+ | `innerGlow.choke` | `0` |
674
+ | `innerGlow.size` | `5` |
675
+ | `innerGlow.source` | `"edge"` |
676
+ | `stroke.blendMode` | `"normal"` |
677
+ | `stroke.color` | `"#000000"` |
678
+ | `stroke.opacity` | `100` |
679
+ | `stroke.size` | `3` |
680
+ | `stroke.position` | `"outside"` |
681
+ | `colorOverlay.blendMode` | `"normal"` |
682
+ | `colorOverlay.color` | `"#ff0000"` |
683
+ | `colorOverlay.opacity` | `100` |
684
+ | `gradientOverlay.blendMode` | `"normal"` |
685
+ | `gradientOverlay.opacity` | `100` |
686
+ | `gradientOverlay.gradient.stops` | `[{"color":"#000000","location":0},{"color":"#ffffff","location":100}]` |
687
+ | `gradientOverlay.gradient.style` | `"linear"` |
688
+ | `gradientOverlay.gradient.angle` | `90` |
689
+ | `gradientOverlay.gradient.scale` | `100` |
690
+ | `gradientOverlay.gradient.reverse` | `false` |
691
+ | `patternOverlay.blendMode` | `"normal"` |
692
+ | `patternOverlay.opacity` | `100` |
693
+ | `patternOverlay.scale` | `100` |
694
+ | `satin.blendMode` | `"multiply"` |
695
+ | `satin.color` | `"#000000"` |
696
+ | `satin.opacity` | `50` |
697
+ | `satin.angle` | `19` |
698
+ | `satin.distance` | `11` |
699
+ | `satin.size` | `14` |
700
+ | `satin.invert` | `true` |
701
+ | `bevelEmboss.style` | `"innerBevel"` |
702
+ | `bevelEmboss.technique` | `"smooth"` |
703
+ | `bevelEmboss.depth` | `100` |
704
+ | `bevelEmboss.direction` | `"up"` |
705
+ | `bevelEmboss.size` | `5` |
706
+ | `bevelEmboss.soften` | `0` |
707
+ | `bevelEmboss.angle` | `120` |
708
+ | `bevelEmboss.altitude` | `30` |
709
+ | `bevelEmboss.highlightMode` | `"screen"` |
710
+ | `bevelEmboss.highlightColor` | `"#ffffff"` |
711
+ | `bevelEmboss.highlightOpacity` | `75` |
712
+ | `bevelEmboss.shadowMode` | `"multiply"` |
713
+ | `bevelEmboss.shadowColor` | `"#000000"` |
714
+ | `bevelEmboss.shadowOpacity` | `75` |
715
+
716
+ ### `ADJUSTMENT_DEFAULTS`
717
+
718
+ Each adjustment's numbers when it gives none, Photoshop's: they change nothing, but Invert's, Threshold's (128), Black & White's sliders and Photo Filter's colour and density. `adjustment({ kind, … })`.
719
+
720
+ | Key | Value |
721
+ | --- | --- |
722
+ | `levels.inputBlack` | `0` |
723
+ | `levels.inputWhite` | `255` |
724
+ | `levels.gamma` | `1` |
725
+ | `levels.outputBlack` | `0` |
726
+ | `levels.outputWhite` | `255` |
727
+ | `curves.rgb` | `[[0,0],[255,255]]` |
728
+ | `brightnessContrast.brightness` | `0` |
729
+ | `brightnessContrast.contrast` | `0` |
730
+ | `brightnessContrast.useLegacy` | `true` |
731
+ | `hueSaturation.hue` | `0` |
732
+ | `hueSaturation.saturation` | `0` |
733
+ | `hueSaturation.lightness` | `0` |
734
+ | `hueSaturation.colorize` | `false` |
735
+ | `vibrance.vibrance` | `0` |
736
+ | `vibrance.saturation` | `0` |
737
+ | `colorBalance.shadows` | `[0,0,0]` |
738
+ | `colorBalance.midtones` | `[0,0,0]` |
739
+ | `colorBalance.highlights` | `[0,0,0]` |
740
+ | `colorBalance.preserveLuminosity` | `true` |
741
+ | `blackAndWhite.reds` | `40` |
742
+ | `blackAndWhite.yellows` | `60` |
743
+ | `blackAndWhite.greens` | `40` |
744
+ | `blackAndWhite.cyans` | `60` |
745
+ | `blackAndWhite.blues` | `20` |
746
+ | `blackAndWhite.magentas` | `80` |
747
+ | `photoFilter.color` | `"#ec8a00"` |
748
+ | `photoFilter.density` | `25` |
749
+ | `photoFilter.preserveLuminosity` | `true` |
750
+ | `invert` | `{}` |
751
+ | `threshold.level` | `128` |
752
+ | `gradientMap.gradient.stops` | `[{"color":"#000000","location":0},{"color":"#ffffff","location":100}]` |
753
+ | `gradientMap.reverse` | `false` |
754
+ | `exposure.exposure` | `0` |
755
+ | `exposure.offset` | `0` |
756
+ | `exposure.gammaCorrection` | `1` |
757
+
758
+ ### `TEXT_DEFAULTS`
759
+
760
+ A type layer's style when it gives none: size (px), weight, colour, tracking (thousandths of an em), leading (auto: `autoLeading` of the size, Photoshop's 120%) and justification. `textLayer({ textItem: { characterStyle, paragraphStyle } })`.
761
+
762
+ | Key | Value |
763
+ | --- | --- |
764
+ | `size` | `48` |
765
+ | `weight` | `400` |
766
+ | `color` | `"#000000"` |
767
+ | `tracking` | `0` |
768
+ | `leading` | `"auto"` |
769
+ | `autoLeading` | `1.2` |
770
+ | `justification` | `"left"` |
771
+
772
+ ### `SHAPE_DEFAULTS`
773
+
774
+ A shape's fill, its stroke's colour, width (px), alignment, cap, join and opacity, a rectangle's radius and a polygon's sides. `shape({ fill, stroke, radius, sides })`.
775
+
776
+ | Key | Value |
777
+ | --- | --- |
778
+ | `fill.color` | `"#000000"` |
779
+ | `stroke.color` | `"#000000"` |
780
+ | `stroke.width` | `1` |
781
+ | `stroke.alignment` | `"center"` |
782
+ | `stroke.cap` | `"butt"` |
783
+ | `stroke.join` | `"miter"` |
784
+ | `stroke.opacity` | `100` |
785
+ | `radius` | `0` |
786
+ | `sides` | `5` |
787
+
788
+ ### `MAX_SIDE`
789
+
790
+ The longest side a board takes, px: what one picture the stage draws holds. A hard limit, not an option.
791
+
792
+ Value: `16384`
793
+
794
+ ### `IMAGE_EXPORT_DEFAULTS`
795
+
796
+ An image's files: JPEG's quality, and AVIF's (as libaom's constant quality, 63 − 0.63 × it), 0–100; a WebP without one keeps every pixel. `allyhub render --param quality=…`. A board's picture's pixels per board pixel, from 0.25 to 4: `--param scale=…`, or `width=…` / `height=…` in pixels.
797
+
798
+ | Key | Value |
799
+ | --- | --- |
800
+ | `jpegQuality` | `90` |
801
+ | `avifQuality` | `60` |
802
+ | `scale` | `1` |
803
+
804
+ ### `PSD_DEFAULTS`
805
+
806
+ An image's PSD: `psd`, or `psb` (Photoshop's large document format); a board is at most 16384 px a side, which a PSD holds. `allyhub render --type psd --param psd=psb`.
807
+
808
+ | Key | Value |
809
+ | --- | --- |
810
+ | `format` | `"psd"` |
811
+
566
812
  ## Layout, text and input
567
813
 
568
814
  ### `MARK_STYLES`
@@ -585,7 +831,7 @@ Value: `0.5`
585
831
 
586
832
  ### `INPUT_DEFAULTS`
587
833
 
588
- A person's input: an aimed movement's shape and time (`reach`), a press, a drag, a scroll, typing. Each input function's options.
834
+ A person's input: a hand's aimed movement (`reach`) and a mouse cursor's (`cursor`, the same without a hand's errors), a press, a drag, a scroll, typing. Each input function's options.
589
835
 
590
836
  | Key | Value |
591
837
  | --- | --- |
@@ -600,6 +846,18 @@ A person's input: an aimed movement's shape and time (`reach`), a press, a drag,
600
846
  | `reach.tremor.px` | `0.3` |
601
847
  | `reach.tremor.frequency` | `9` |
602
848
  | `reach.seed` | `1` |
849
+ | `cursor.reach.overshoot` | `0` |
850
+ | `cursor.reach.peak` | `0.38` |
851
+ | `cursor.reach.vary` | `0` |
852
+ | `cursor.reach.fitts.a` | `0.2` |
853
+ | `cursor.reach.fitts.b` | `0.15` |
854
+ | `cursor.reach.scatter` | `0` |
855
+ | `cursor.reach.jitter` | `0` |
856
+ | `cursor.reach.bow` | `0` |
857
+ | `cursor.reach.tremor.px` | `0` |
858
+ | `cursor.reach.tremor.frequency` | `9` |
859
+ | `cursor.reach.seed` | `1` |
860
+ | `cursor.after` | `0.3` |
603
861
  | `size` | `40` |
604
862
  | `dwell` | `0.12` |
605
863
  | `hold` | `0.1` |
@@ -630,6 +888,17 @@ A person's input: an aimed movement's shape and time (`reach`), a press, a drag,
630
888
  | `typing.backspace` | `0.07` |
631
889
  | `typing.seed` | `1` |
632
890
 
891
+ ### `ROUTE_DEFAULTS`
892
+
893
+ How `routeConnections()` routes, and the `connector` component with it: how far a line keeps from every box and runs straight out of a side (`margin`), what a bend costs as so much length (`bend`), how far apart lines sharing a channel are set (`spread`), what crossing another line costs as so much length (`cross`: a line goes round rather than across only where that is shorter). `routeConnections(boxes, connections, { margin, bend, spread, cross, bounds })`; a connector's `line`.
894
+
895
+ | Key | Value |
896
+ | --- | --- |
897
+ | `margin` | `16` |
898
+ | `bend` | `48` |
899
+ | `spread` | `8` |
900
+ | `cross` | `120` |
901
+
633
902
  ## 3D sceneries
634
903
 
635
904
  ### `SCENERY_LAYER_DEFAULTS`
@@ -638,7 +907,7 @@ A `scenery()` layer's drawing scale, its name and its depth of field's levels. `
638
907
 
639
908
  | Key | Value |
640
909
  | --- | --- |
641
- | `scale` | `0.5` |
910
+ | `scale` | `1` |
642
911
  | `name` | `"scenery"` |
643
912
  | `focusLevels` | `8` |
644
913
 
@@ -689,7 +958,13 @@ A phone's main camera held in a hand: its lens, sensor and hand. `phoneCamera(ch
689
958
  | `sensor.moire` | `1` |
690
959
  | `sensor.chroma` | `0.3` |
691
960
  | `sensor.distortion` | `-0.03` |
692
- | `sensor.grade.filter` | `"curves=all='0/0 0.2/0.07 0.5/0.38 0.78/0.82 1/1',eq=saturation=1.5,colortemperature=temperature=6000"` |
961
+ | `sensor.grade.room.curve` | `[[0,0],[0.25,0.21],[0.5,0.47],[0.75,0.78],[1,1]]` |
962
+ | `sensor.grade.room.saturation` | `1.08` |
963
+ | `sensor.grade.screen.curve` | `[[0,0],[0.36,0.1],[0.51,0.16],[0.67,0.46],[0.8,0.84],[1,1]]` |
964
+ | `sensor.grade.screen.saturation` | `1.25` |
965
+ | `sensor.grade.screen.hue` | `5` |
966
+ | `sensor.grade.screen.balance` | `[1,0.97,1]` |
967
+ | `sensor.grade.share` | `[0.5,0.8]` |
693
968
  | `hand.angle` | `0.25` |
694
969
  | `hand.roll` | `0.6` |
695
970
  | `hand.shift` | `0.001` |
@@ -822,6 +1097,7 @@ A screen's physical pixels, which the sensor films. `screen(…, { pixels })`.
822
1097
  | --- | --- |
823
1098
  | `density` | `2` |
824
1099
  | `rows` | `0.15` |
1100
+ | `mesh` | `0.09` |
825
1101
 
826
1102
  ### `SCREEN_LIGHT_DEFAULTS`
827
1103