@imgly/codesign-mcp 0.1.5 → 0.1.6

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 (973) hide show
  1. package/README.md +51 -1
  2. package/assets/docs/guide/SKILL.md +45 -53
  3. package/assets/docs/guide/animation/create/base.md +234 -243
  4. package/assets/docs/guide/animation/create/text.md +250 -231
  5. package/assets/docs/guide/animation/create.md +197 -231
  6. package/assets/docs/guide/animation/edit.md +196 -271
  7. package/assets/docs/guide/animation/types.md +182 -185
  8. package/assets/docs/guide/animation.md +9 -6
  9. package/assets/docs/guide/api/AssetAPI.md +7 -53
  10. package/assets/docs/guide/api/BlockAPI.md +725 -648
  11. package/assets/docs/guide/api/CreativeEngine.md +7 -16
  12. package/assets/docs/guide/api/EditorAPI.md +32 -93
  13. package/assets/docs/guide/api/EventAPI.md +1 -2
  14. package/assets/docs/guide/api/SceneAPI.md +47 -98
  15. package/assets/docs/guide/api/VariableAPI.md +1 -4
  16. package/assets/docs/guide/api/node/classes/assetapi.md +1090 -0
  17. package/assets/docs/guide/api/node/classes/blockapi.md +12965 -0
  18. package/assets/docs/guide/api/node/classes/creativeengine.md +319 -0
  19. package/assets/docs/guide/api/node/classes/editorapi.md +3417 -0
  20. package/assets/docs/guide/api/node/classes/engineactions.md +319 -0
  21. package/assets/docs/guide/api/node/classes/eventapi.md +56 -0
  22. package/assets/docs/guide/api/node/classes/sceneapi.md +1370 -0
  23. package/assets/docs/guide/api/node/classes/variableapi.md +143 -0
  24. package/assets/docs/guide/api/node/enumerations/compressionformat.md +23 -0
  25. package/assets/docs/guide/api/node/enumerations/compressionlevel.md +24 -0
  26. package/assets/docs/guide/api/node/functions/iscmykcolor.md +30 -0
  27. package/assets/docs/guide/api/node/functions/isrgbacolor.md +30 -0
  28. package/assets/docs/guide/api/node/functions/isspotcolor.md +30 -0
  29. package/assets/docs/guide/api/node/interfaces/addvideooptions.md +31 -0
  30. package/assets/docs/guide/api/node/interfaces/applyassetoptions.md +31 -0
  31. package/assets/docs/guide/api/node/interfaces/asset.md +30 -0
  32. package/assets/docs/guide/api/node/interfaces/assetbooleanproperty.md +25 -0
  33. package/assets/docs/guide/api/node/interfaces/assetcmykcolor.md +26 -0
  34. package/assets/docs/guide/api/node/interfaces/assetcolorproperty.md +25 -0
  35. package/assets/docs/guide/api/node/interfaces/assetcontentaspectratio.md +23 -0
  36. package/assets/docs/guide/api/node/interfaces/assetdefinition.md +31 -0
  37. package/assets/docs/guide/api/node/interfaces/assetenumproperty.md +26 -0
  38. package/assets/docs/guide/api/node/interfaces/assetfixedaspectratio.md +24 -0
  39. package/assets/docs/guide/api/node/interfaces/assetfixedsize.md +25 -0
  40. package/assets/docs/guide/api/node/interfaces/assetfreeaspectratio.md +22 -0
  41. package/assets/docs/guide/api/node/interfaces/assetnumberproperty.md +28 -0
  42. package/assets/docs/guide/api/node/interfaces/assetpayload.md +27 -0
  43. package/assets/docs/guide/api/node/interfaces/assetquerydata.md +32 -0
  44. package/assets/docs/guide/api/node/interfaces/assetresult.md +46 -0
  45. package/assets/docs/guide/api/node/interfaces/assetrgbcolor.md +25 -0
  46. package/assets/docs/guide/api/node/interfaces/assetsource.md +111 -0
  47. package/assets/docs/guide/api/node/interfaces/assetspotcolor.md +25 -0
  48. package/assets/docs/guide/api/node/interfaces/assetsqueryresult.md +31 -0
  49. package/assets/docs/guide/api/node/interfaces/assetstringproperty.md +25 -0
  50. package/assets/docs/guide/api/node/interfaces/assetstylepreset.md +39 -0
  51. package/assets/docs/guide/api/node/interfaces/assetstylepresetanimation.md +23 -0
  52. package/assets/docs/guide/api/node/interfaces/audiotrackinfo.md +32 -0
  53. package/assets/docs/guide/api/node/interfaces/blockevent.md +26 -0
  54. package/assets/docs/guide/api/node/interfaces/blockstateerror.md +26 -0
  55. package/assets/docs/guide/api/node/interfaces/blockstatepending.md +26 -0
  56. package/assets/docs/guide/api/node/interfaces/blockstateready.md +25 -0
  57. package/assets/docs/guide/api/node/interfaces/buffer.md +26 -0
  58. package/assets/docs/guide/api/node/interfaces/characterinkbox.md +29 -0
  59. package/assets/docs/guide/api/node/interfaces/cmykcolor.md +34 -0
  60. package/assets/docs/guide/api/node/interfaces/completeassetresult.md +46 -0
  61. package/assets/docs/guide/api/node/interfaces/configuration.md +38 -0
  62. package/assets/docs/guide/api/node/interfaces/dominantcolor.md +25 -0
  63. package/assets/docs/guide/api/node/interfaces/dominantcolorsoptions.md +23 -0
  64. package/assets/docs/guide/api/node/interfaces/engineactioninfo.md +24 -0
  65. package/assets/docs/guide/api/node/interfaces/engineactionsregistry.md +18 -0
  66. package/assets/docs/guide/api/node/interfaces/engineplugin.md +30 -0
  67. package/assets/docs/guide/api/node/interfaces/font.md +27 -0
  68. package/assets/docs/guide/api/node/interfaces/fontmetrics.md +32 -0
  69. package/assets/docs/guide/api/node/interfaces/gradientcolorstop.md +28 -0
  70. package/assets/docs/guide/api/node/interfaces/logger.md +39 -0
  71. package/assets/docs/guide/api/node/interfaces/pageduration.md +23 -0
  72. package/assets/docs/guide/api/node/interfaces/range.md +23 -0
  73. package/assets/docs/guide/api/node/interfaces/rgbacolor.md +32 -0
  74. package/assets/docs/guide/api/node/interfaces/rgbcolor.md +30 -0
  75. package/assets/docs/guide/api/node/interfaces/settings.md +126 -0
  76. package/assets/docs/guide/api/node/interfaces/size2.md +21 -0
  77. package/assets/docs/guide/api/node/interfaces/source.md +24 -0
  78. package/assets/docs/guide/api/node/interfaces/spotcolor.md +30 -0
  79. package/assets/docs/guide/api/node/interfaces/textdecorationconfig.md +31 -0
  80. package/assets/docs/guide/api/node/interfaces/textfontsizeoptions.md +24 -0
  81. package/assets/docs/guide/api/node/interfaces/textruninfo.md +33 -0
  82. package/assets/docs/guide/api/node/interfaces/transientresource.md +26 -0
  83. package/assets/docs/guide/api/node/interfaces/typeface.md +23 -0
  84. package/assets/docs/guide/api/node/interfaces/vec2.md +21 -0
  85. package/assets/docs/guide/api/node/interfaces/vec3.md +22 -0
  86. package/assets/docs/guide/api/node/type-aliases/addimageoptions.md +36 -0
  87. package/assets/docs/guide/api/node/type-aliases/animationbaselinedirection.md +18 -0
  88. package/assets/docs/guide/api/node/type-aliases/animationblockswipetextdirection.md +18 -0
  89. package/assets/docs/guide/api/node/type-aliases/animationeasing.md +18 -0
  90. package/assets/docs/guide/api/node/type-aliases/animationentry.md +28 -0
  91. package/assets/docs/guide/api/node/type-aliases/animationgrowdirection.md +18 -0
  92. package/assets/docs/guide/api/node/type-aliases/animationjumploopdirection.md +18 -0
  93. package/assets/docs/guide/api/node/type-aliases/animationkenburnsdirection.md +18 -0
  94. package/assets/docs/guide/api/node/type-aliases/animationmergetextdirection.md +18 -0
  95. package/assets/docs/guide/api/node/type-aliases/animationoptions.md +28 -0
  96. package/assets/docs/guide/api/node/type-aliases/animationspindirection.md +18 -0
  97. package/assets/docs/guide/api/node/type-aliases/animationspinloopdirection.md +18 -0
  98. package/assets/docs/guide/api/node/type-aliases/animationtype.md +24 -0
  99. package/assets/docs/guide/api/node/type-aliases/animationtypelonghand.md +21 -0
  100. package/assets/docs/guide/api/node/type-aliases/animationtypeshorthand.md +18 -0
  101. package/assets/docs/guide/api/node/type-aliases/animationtypewritertextwritingstyle.md +18 -0
  102. package/assets/docs/guide/api/node/type-aliases/animationwipedirection.md +18 -0
  103. package/assets/docs/guide/api/node/type-aliases/applicationmimetype.md +20 -0
  104. package/assets/docs/guide/api/node/type-aliases/assetcolor.md +23 -0
  105. package/assets/docs/guide/api/node/type-aliases/assetfilter.md +47 -0
  106. package/assets/docs/guide/api/node/type-aliases/assetgroups.md +25 -0
  107. package/assets/docs/guide/api/node/type-aliases/assetmetadata.md +42 -0
  108. package/assets/docs/guide/api/node/type-aliases/assetproperty.md +25 -0
  109. package/assets/docs/guide/api/node/type-aliases/assetpropertyfilter.md +41 -0
  110. package/assets/docs/guide/api/node/type-aliases/assetpropertypath.md +26 -0
  111. package/assets/docs/guide/api/node/type-aliases/assetstylepresetanimationproperties.md +34 -0
  112. package/assets/docs/guide/api/node/type-aliases/assetstylepresetproperties.md +29 -0
  113. package/assets/docs/guide/api/node/type-aliases/assetstylepresetpropertyvalue.md +29 -0
  114. package/assets/docs/guide/api/node/type-aliases/assetstylepresetscalableproperty.md +28 -0
  115. package/assets/docs/guide/api/node/type-aliases/assettransformpreset.md +24 -0
  116. package/assets/docs/guide/api/node/type-aliases/asyncuriresolver.md +36 -0
  117. package/assets/docs/guide/api/node/type-aliases/audioexportoptions.md +43 -0
  118. package/assets/docs/guide/api/node/type-aliases/audiofromvideooptions.md +27 -0
  119. package/assets/docs/guide/api/node/type-aliases/audiomimetype.md +20 -0
  120. package/assets/docs/guide/api/node/type-aliases/blendmode.md +18 -0
  121. package/assets/docs/guide/api/node/type-aliases/blockenumtype.md +63 -0
  122. package/assets/docs/guide/api/node/type-aliases/blockstate.md +26 -0
  123. package/assets/docs/guide/api/node/type-aliases/blurtype.md +24 -0
  124. package/assets/docs/guide/api/node/type-aliases/blurtypelonghand.md +21 -0
  125. package/assets/docs/guide/api/node/type-aliases/blurtypeshorthand.md +18 -0
  126. package/assets/docs/guide/api/node/type-aliases/booleanoperation.md +27 -0
  127. package/assets/docs/guide/api/node/type-aliases/boolpropertyname.md +79 -0
  128. package/assets/docs/guide/api/node/type-aliases/cameraclampingovershootmode.md +18 -0
  129. package/assets/docs/guide/api/node/type-aliases/captionhorizontalalignment.md +18 -0
  130. package/assets/docs/guide/api/node/type-aliases/captionverticalalignment.md +18 -0
  131. package/assets/docs/guide/api/node/type-aliases/cmyk.md +23 -0
  132. package/assets/docs/guide/api/node/type-aliases/color.md +23 -0
  133. package/assets/docs/guide/api/node/type-aliases/colorpickercolormode.md +18 -0
  134. package/assets/docs/guide/api/node/type-aliases/colorpropertyname.md +31 -0
  135. package/assets/docs/guide/api/node/type-aliases/colorspace.md +20 -0
  136. package/assets/docs/guide/api/node/type-aliases/contentfillmode.md +18 -0
  137. package/assets/docs/guide/api/node/type-aliases/controlgizmomovehandlevisibility.md +18 -0
  138. package/assets/docs/guide/api/node/type-aliases/controlgizmoresizehandlesvisibility.md +18 -0
  139. package/assets/docs/guide/api/node/type-aliases/controlgizmorotatehandlesvisibility.md +18 -0
  140. package/assets/docs/guide/api/node/type-aliases/controlgizmoscalehandlesvisibility.md +18 -0
  141. package/assets/docs/guide/api/node/type-aliases/createsceneoptions.md +30 -0
  142. package/assets/docs/guide/api/node/type-aliases/cutoutoperation.md +20 -0
  143. package/assets/docs/guide/api/node/type-aliases/cutouttype.md +18 -0
  144. package/assets/docs/guide/api/node/type-aliases/defaultassetsourceid.md +37 -0
  145. package/assets/docs/guide/api/node/type-aliases/demoassetsourceid.md +33 -0
  146. package/assets/docs/guide/api/node/type-aliases/designblockid.md +20 -0
  147. package/assets/docs/guide/api/node/type-aliases/designblocktype.md +24 -0
  148. package/assets/docs/guide/api/node/type-aliases/designblocktypelonghand.md +21 -0
  149. package/assets/docs/guide/api/node/type-aliases/designblocktypeshorthand.md +18 -0
  150. package/assets/docs/guide/api/node/type-aliases/designunit.md +18 -0
  151. package/assets/docs/guide/api/node/type-aliases/doubleclickselectionmode.md +18 -0
  152. package/assets/docs/guide/api/node/type-aliases/doublepropertyname.md +26 -0
  153. package/assets/docs/guide/api/node/type-aliases/dropshadowoptions.md +32 -0
  154. package/assets/docs/guide/api/node/type-aliases/editmode.md +27 -0
  155. package/assets/docs/guide/api/node/type-aliases/effecttype.md +24 -0
  156. package/assets/docs/guide/api/node/type-aliases/effecttypelonghand.md +21 -0
  157. package/assets/docs/guide/api/node/type-aliases/effecttypeshorthand.md +18 -0
  158. package/assets/docs/guide/api/node/type-aliases/engineactionid.md +20 -0
  159. package/assets/docs/guide/api/node/type-aliases/enginecustomactionfunction.md +30 -0
  160. package/assets/docs/guide/api/node/type-aliases/engineplugincontext.md +30 -0
  161. package/assets/docs/guide/api/node/type-aliases/enumpropertyname.md +59 -0
  162. package/assets/docs/guide/api/node/type-aliases/enumvalues.md +59 -0
  163. package/assets/docs/guide/api/node/type-aliases/exportoptions.md +57 -0
  164. package/assets/docs/guide/api/node/type-aliases/fillpixelstreamorientation.md +18 -0
  165. package/assets/docs/guide/api/node/type-aliases/filltype.md +24 -0
  166. package/assets/docs/guide/api/node/type-aliases/filltypelonghand.md +21 -0
  167. package/assets/docs/guide/api/node/type-aliases/filltypeshorthand.md +18 -0
  168. package/assets/docs/guide/api/node/type-aliases/floatpropertyname.md +184 -0
  169. package/assets/docs/guide/api/node/type-aliases/fontsizeunit.md +23 -0
  170. package/assets/docs/guide/api/node/type-aliases/fontstyle.md +20 -0
  171. package/assets/docs/guide/api/node/type-aliases/fontweight.md +30 -0
  172. package/assets/docs/guide/api/node/type-aliases/gradientstoprgba.md +23 -0
  173. package/assets/docs/guide/api/node/type-aliases/heightmode.md +18 -0
  174. package/assets/docs/guide/api/node/type-aliases/hexcolorstring.md +20 -0
  175. package/assets/docs/guide/api/node/type-aliases/historyid.md +20 -0
  176. package/assets/docs/guide/api/node/type-aliases/historyupdate.md +25 -0
  177. package/assets/docs/guide/api/node/type-aliases/horizontalblockalignment.md +18 -0
  178. package/assets/docs/guide/api/node/type-aliases/horizontalcontentfillalignment.md +18 -0
  179. package/assets/docs/guide/api/node/type-aliases/horizontaltextalignment.md +18 -0
  180. package/assets/docs/guide/api/node/type-aliases/imagemimetype.md +25 -0
  181. package/assets/docs/guide/api/node/type-aliases/intpropertyname.md +26 -0
  182. package/assets/docs/guide/api/node/type-aliases/liststyle.md +20 -0
  183. package/assets/docs/guide/api/node/type-aliases/locale.md +20 -0
  184. package/assets/docs/guide/api/node/type-aliases/loglevel.md +24 -0
  185. package/assets/docs/guide/api/node/type-aliases/mimetype.md +20 -0
  186. package/assets/docs/guide/api/node/type-aliases/objecttype.md +24 -0
  187. package/assets/docs/guide/api/node/type-aliases/objecttypelonghand.md +27 -0
  188. package/assets/docs/guide/api/node/type-aliases/objecttypeshorthand.md +27 -0
  189. package/assets/docs/guide/api/node/type-aliases/optionalprefix.md +24 -0
  190. package/assets/docs/guide/api/node/type-aliases/pageguidessource.md +18 -0
  191. package/assets/docs/guide/api/node/type-aliases/palettecolor.md +24 -0
  192. package/assets/docs/guide/api/node/type-aliases/positionmode.md +20 -0
  193. package/assets/docs/guide/api/node/type-aliases/positionxmode.md +18 -0
  194. package/assets/docs/guide/api/node/type-aliases/positionymode.md +18 -0
  195. package/assets/docs/guide/api/node/type-aliases/propertytype.md +31 -0
  196. package/assets/docs/guide/api/node/type-aliases/rgba.md +23 -0
  197. package/assets/docs/guide/api/node/type-aliases/rolestring.md +23 -0
  198. package/assets/docs/guide/api/node/type-aliases/scenefontsizeunit.md +18 -0
  199. package/assets/docs/guide/api/node/type-aliases/scenelayout.md +18 -0
  200. package/assets/docs/guide/api/node/type-aliases/scenemode.md +18 -0
  201. package/assets/docs/guide/api/node/type-aliases/scope.md +50 -0
  202. package/assets/docs/guide/api/node/type-aliases/settingboolpropertyname.md +62 -0
  203. package/assets/docs/guide/api/node/type-aliases/settingcolorpropertyname.md +38 -0
  204. package/assets/docs/guide/api/node/type-aliases/settingenumpropertyname.md +29 -0
  205. package/assets/docs/guide/api/node/type-aliases/settingenumtype.md +33 -0
  206. package/assets/docs/guide/api/node/type-aliases/settingenumvalues.md +29 -0
  207. package/assets/docs/guide/api/node/type-aliases/settingfloatpropertyname.md +25 -0
  208. package/assets/docs/guide/api/node/type-aliases/settingintpropertyname.md +18 -0
  209. package/assets/docs/guide/api/node/type-aliases/settingkey.md +20 -0
  210. package/assets/docs/guide/api/node/type-aliases/settingsbool.md +18 -0
  211. package/assets/docs/guide/api/node/type-aliases/settingscolor.md +20 -0
  212. package/assets/docs/guide/api/node/type-aliases/settingscolorrgba.md +24 -0
  213. package/assets/docs/guide/api/node/type-aliases/settingsenum.md +18 -0
  214. package/assets/docs/guide/api/node/type-aliases/settingsfloat.md +18 -0
  215. package/assets/docs/guide/api/node/type-aliases/settingsint.md +18 -0
  216. package/assets/docs/guide/api/node/type-aliases/settingsstring.md +18 -0
  217. package/assets/docs/guide/api/node/type-aliases/settingstringpropertyname.md +28 -0
  218. package/assets/docs/guide/api/node/type-aliases/settingtype.md +20 -0
  219. package/assets/docs/guide/api/node/type-aliases/settingvaluetype.md +26 -0
  220. package/assets/docs/guide/api/node/type-aliases/shapetype.md +24 -0
  221. package/assets/docs/guide/api/node/type-aliases/shapetypelonghand.md +21 -0
  222. package/assets/docs/guide/api/node/type-aliases/shapetypeshorthand.md +18 -0
  223. package/assets/docs/guide/api/node/type-aliases/shapevectorpathfillrule.md +18 -0
  224. package/assets/docs/guide/api/node/type-aliases/sizemode.md +20 -0
  225. package/assets/docs/guide/api/node/type-aliases/sortingorder.md +21 -0
  226. package/assets/docs/guide/api/node/type-aliases/sourcesetpropertyname.md +18 -0
  227. package/assets/docs/guide/api/node/type-aliases/splitoptions.md +28 -0
  228. package/assets/docs/guide/api/node/type-aliases/stringpropertyname.md +43 -0
  229. package/assets/docs/guide/api/node/type-aliases/strokecap.md +18 -0
  230. package/assets/docs/guide/api/node/type-aliases/strokecornergeometry.md +18 -0
  231. package/assets/docs/guide/api/node/type-aliases/strokedashendcap.md +18 -0
  232. package/assets/docs/guide/api/node/type-aliases/strokedashstartcap.md +18 -0
  233. package/assets/docs/guide/api/node/type-aliases/strokeendcap.md +18 -0
  234. package/assets/docs/guide/api/node/type-aliases/strokeposition.md +18 -0
  235. package/assets/docs/guide/api/node/type-aliases/strokestartcap.md +18 -0
  236. package/assets/docs/guide/api/node/type-aliases/strokestyle.md +18 -0
  237. package/assets/docs/guide/api/node/type-aliases/syncuriresolver.md +31 -0
  238. package/assets/docs/guide/api/node/type-aliases/textanimationwritingstyle.md +18 -0
  239. package/assets/docs/guide/api/node/type-aliases/textcase.md +20 -0
  240. package/assets/docs/guide/api/node/type-aliases/textdecorationline.md +27 -0
  241. package/assets/docs/guide/api/node/type-aliases/textdecorationstyle.md +26 -0
  242. package/assets/docs/guide/api/node/type-aliases/textverticalalignment.md +18 -0
  243. package/assets/docs/guide/api/node/type-aliases/timelinetrackvisibility.md +18 -0
  244. package/assets/docs/guide/api/node/type-aliases/touchpinchaction.md +18 -0
  245. package/assets/docs/guide/api/node/type-aliases/touchrotateaction.md +18 -0
  246. package/assets/docs/guide/api/node/type-aliases/typefacedefinition.md +41 -0
  247. package/assets/docs/guide/api/node/type-aliases/verticalblockalignment.md +18 -0
  248. package/assets/docs/guide/api/node/type-aliases/verticalcontentfillalignment.md +18 -0
  249. package/assets/docs/guide/api/node/type-aliases/videoexportoptions.md +54 -0
  250. package/assets/docs/guide/api/node/type-aliases/videomimetype.md +20 -0
  251. package/assets/docs/guide/api/node/type-aliases/widthmode.md +18 -0
  252. package/assets/docs/guide/api/node/type-aliases/xywh.md +23 -0
  253. package/assets/docs/guide/api/node/type-aliases/zoomautofitaxis.md +20 -0
  254. package/assets/docs/guide/api/node/type-aliases/zoomoptions.md +27 -0
  255. package/assets/docs/guide/api/node/variables/animation_types.md +21 -0
  256. package/assets/docs/guide/api/node/variables/animationbaselinedirectionvalues.md +18 -0
  257. package/assets/docs/guide/api/node/variables/animationblockswipetextdirectionvalues.md +18 -0
  258. package/assets/docs/guide/api/node/variables/animationeasingvalues.md +18 -0
  259. package/assets/docs/guide/api/node/variables/animationgrowdirectionvalues.md +18 -0
  260. package/assets/docs/guide/api/node/variables/animationjumploopdirectionvalues.md +18 -0
  261. package/assets/docs/guide/api/node/variables/animationkenburnsdirectionvalues.md +18 -0
  262. package/assets/docs/guide/api/node/variables/animationmergetextdirectionvalues.md +18 -0
  263. package/assets/docs/guide/api/node/variables/animationspindirectionvalues.md +18 -0
  264. package/assets/docs/guide/api/node/variables/animationspinloopdirectionvalues.md +18 -0
  265. package/assets/docs/guide/api/node/variables/animationtypewritertextwritingstylevalues.md +18 -0
  266. package/assets/docs/guide/api/node/variables/animationwipedirectionvalues.md +18 -0
  267. package/assets/docs/guide/api/node/variables/blendmodevalues.md +18 -0
  268. package/assets/docs/guide/api/node/variables/blur_types.md +21 -0
  269. package/assets/docs/guide/api/node/variables/cameraclampingovershootmodevalues.md +18 -0
  270. package/assets/docs/guide/api/node/variables/captionhorizontalalignmentvalues.md +18 -0
  271. package/assets/docs/guide/api/node/variables/captionverticalalignmentvalues.md +18 -0
  272. package/assets/docs/guide/api/node/variables/colorpickercolormodevalues.md +18 -0
  273. package/assets/docs/guide/api/node/variables/contentfillmodevalues.md +18 -0
  274. package/assets/docs/guide/api/node/variables/controlgizmomovehandlevisibilityvalues.md +18 -0
  275. package/assets/docs/guide/api/node/variables/controlgizmoresizehandlesvisibilityvalues.md +18 -0
  276. package/assets/docs/guide/api/node/variables/controlgizmorotatehandlesvisibilityvalues.md +18 -0
  277. package/assets/docs/guide/api/node/variables/controlgizmoscalehandlesvisibilityvalues.md +18 -0
  278. package/assets/docs/guide/api/node/variables/cutouttypevalues.md +18 -0
  279. package/assets/docs/guide/api/node/variables/design_block_types.md +21 -0
  280. package/assets/docs/guide/api/node/variables/doubleclickselectionmodevalues.md +18 -0
  281. package/assets/docs/guide/api/node/variables/effect_types.md +21 -0
  282. package/assets/docs/guide/api/node/variables/fill_types.md +21 -0
  283. package/assets/docs/guide/api/node/variables/fillpixelstreamorientationvalues.md +18 -0
  284. package/assets/docs/guide/api/node/variables/heightmodevalues.md +18 -0
  285. package/assets/docs/guide/api/node/variables/horizontalcontentfillalignmentvalues.md +18 -0
  286. package/assets/docs/guide/api/node/variables/loglevel.md +37 -0
  287. package/assets/docs/guide/api/node/variables/mimetype.md +41 -0
  288. package/assets/docs/guide/api/node/variables/pageguidessourcevalues.md +18 -0
  289. package/assets/docs/guide/api/node/variables/positionxmodevalues.md +18 -0
  290. package/assets/docs/guide/api/node/variables/positionymodevalues.md +18 -0
  291. package/assets/docs/guide/api/node/variables/scenedesignunitvalues.md +18 -0
  292. package/assets/docs/guide/api/node/variables/scenefontsizeunitvalues.md +18 -0
  293. package/assets/docs/guide/api/node/variables/scenelayoutvalues.md +18 -0
  294. package/assets/docs/guide/api/node/variables/scenemodevalues.md +18 -0
  295. package/assets/docs/guide/api/node/variables/shape_types.md +21 -0
  296. package/assets/docs/guide/api/node/variables/shapevectorpathfillrulevalues.md +18 -0
  297. package/assets/docs/guide/api/node/variables/strokecapvalues.md +18 -0
  298. package/assets/docs/guide/api/node/variables/strokecornergeometryvalues.md +18 -0
  299. package/assets/docs/guide/api/node/variables/strokedashendcapvalues.md +18 -0
  300. package/assets/docs/guide/api/node/variables/strokedashstartcapvalues.md +18 -0
  301. package/assets/docs/guide/api/node/variables/strokeendcapvalues.md +18 -0
  302. package/assets/docs/guide/api/node/variables/strokepositionvalues.md +18 -0
  303. package/assets/docs/guide/api/node/variables/strokestartcapvalues.md +18 -0
  304. package/assets/docs/guide/api/node/variables/strokestylevalues.md +18 -0
  305. package/assets/docs/guide/api/node/variables/textanimationwritingstylevalues.md +18 -0
  306. package/assets/docs/guide/api/node/variables/texthorizontalalignmentvalues.md +18 -0
  307. package/assets/docs/guide/api/node/variables/textverticalalignmentvalues.md +18 -0
  308. package/assets/docs/guide/api/node/variables/timelinetrackvisibilityvalues.md +18 -0
  309. package/assets/docs/guide/api/node/variables/touchpinchactionvalues.md +18 -0
  310. package/assets/docs/guide/api/node/variables/touchrotateactionvalues.md +18 -0
  311. package/assets/docs/guide/api/node/variables/verticalcontentfillalignmentvalues.md +18 -0
  312. package/assets/docs/guide/api/node/variables/widthmodevalues.md +18 -0
  313. package/assets/docs/guide/api/types.md +5 -9
  314. package/assets/docs/guide/api-reference/overview.md +7 -7
  315. package/assets/docs/guide/automation/auto-resize.md +263 -300
  316. package/assets/docs/guide/automation/data-merge.md +246 -275
  317. package/assets/docs/guide/automation/design-generation.md +102 -31
  318. package/assets/docs/guide/automation/multi-image-generation.md +758 -0
  319. package/assets/docs/guide/automation/overview.md +21 -4
  320. package/assets/docs/guide/automation.md +10 -5
  321. package/assets/docs/guide/capabilities.md +6 -4
  322. package/assets/docs/guide/colors/adjust.md +247 -249
  323. package/assets/docs/guide/colors/apply.md +127 -138
  324. package/assets/docs/guide/colors/basics.md +126 -150
  325. package/assets/docs/guide/colors/conversion.md +171 -177
  326. package/assets/docs/guide/colors/create-color-palette.md +244 -245
  327. package/assets/docs/guide/colors/extract-colors.md +144 -0
  328. package/assets/docs/guide/colors/for-print/cmyk.md +292 -352
  329. package/assets/docs/guide/colors/for-print/spot.md +521 -578
  330. package/assets/docs/guide/colors/for-print.md +9 -4
  331. package/assets/docs/guide/colors/for-screen/p3.md +12 -10
  332. package/assets/docs/guide/colors/for-screen/srgb.md +107 -133
  333. package/assets/docs/guide/colors/for-screen.md +9 -4
  334. package/assets/docs/guide/colors/overview.md +6 -4
  335. package/assets/docs/guide/colors/replace.md +381 -419
  336. package/assets/docs/guide/colors.md +9 -4
  337. package/assets/docs/guide/compatibility.md +7 -5
  338. package/assets/docs/guide/concepts/architecture.md +17 -15
  339. package/assets/docs/guide/concepts/assets.md +152 -140
  340. package/assets/docs/guide/concepts/blocks.md +227 -323
  341. package/assets/docs/guide/concepts/buffers.md +147 -276
  342. package/assets/docs/guide/concepts/design-units.md +95 -145
  343. package/assets/docs/guide/concepts/editing-workflow.md +69 -183
  344. package/assets/docs/guide/concepts/events.md +80 -122
  345. package/assets/docs/guide/concepts/headless-mode.md +237 -0
  346. package/assets/docs/guide/concepts/pages.md +137 -127
  347. package/assets/docs/guide/concepts/resources.md +156 -217
  348. package/assets/docs/guide/concepts/scenes.md +191 -210
  349. package/assets/docs/guide/concepts/templating.md +118 -74
  350. package/assets/docs/guide/concepts/terminology.md +49 -47
  351. package/assets/docs/guide/concepts/undo-and-history.md +229 -303
  352. package/assets/docs/guide/concepts.md +9 -7
  353. package/assets/docs/guide/configuration.md +252 -380
  354. package/assets/docs/guide/conversion/overview.md +33 -4
  355. package/assets/docs/guide/conversion/to-base64.md +127 -167
  356. package/assets/docs/guide/conversion/to-pdf.md +24 -474
  357. package/assets/docs/guide/conversion/to-png.md +168 -211
  358. package/assets/docs/guide/conversion.md +9 -4
  359. package/assets/docs/guide/create-audio/audio/add-music.md +301 -327
  360. package/assets/docs/guide/create-audio/audio/add-sound-effects.md +475 -359
  361. package/assets/docs/guide/create-audio/audio/loop.md +232 -272
  362. package/assets/docs/guide/create-composition/add-background.md +237 -239
  363. package/assets/docs/guide/create-composition/blend-modes.md +118 -209
  364. package/assets/docs/guide/create-composition/collage.md +538 -320
  365. package/assets/docs/guide/create-composition/group-and-ungroup.md +216 -261
  366. package/assets/docs/guide/create-composition/layer-management.md +219 -257
  367. package/assets/docs/guide/create-composition/layout.md +513 -315
  368. package/assets/docs/guide/create-composition/lock-design.md +90 -109
  369. package/assets/docs/guide/create-composition/multi-page.md +133 -113
  370. package/assets/docs/guide/create-composition/overview.md +16 -4
  371. package/assets/docs/guide/create-composition/programmatic.md +288 -344
  372. package/assets/docs/guide/create-composition.md +10 -5
  373. package/assets/docs/guide/create-templates/add-dynamic-content/placeholders.md +443 -569
  374. package/assets/docs/guide/create-templates/add-dynamic-content/set-editing-constraints.md +567 -470
  375. package/assets/docs/guide/create-templates/add-dynamic-content/text-variables.md +179 -516
  376. package/assets/docs/guide/create-templates/add-dynamic-content.md +226 -224
  377. package/assets/docs/guide/create-templates/add-to-template-library.md +183 -193
  378. package/assets/docs/guide/create-templates/edit-or-remove.md +297 -303
  379. package/assets/docs/guide/create-templates/from-scratch.md +207 -268
  380. package/assets/docs/guide/create-templates/import/from-scene-file.md +158 -236
  381. package/assets/docs/guide/create-templates/import.md +145 -161
  382. package/assets/docs/guide/create-templates/lock.md +42 -295
  383. package/assets/docs/guide/create-templates/overview.md +33 -4
  384. package/assets/docs/guide/create-templates.md +9 -5
  385. package/assets/docs/guide/create-video/audio/adjust-speed.md +157 -207
  386. package/assets/docs/guide/create-video/audio/adjust-volume.md +116 -227
  387. package/assets/docs/guide/create-video/control.md +352 -193
  388. package/assets/docs/guide/create-video/limitations.md +175 -280
  389. package/assets/docs/guide/create-video.md +11 -10
  390. package/assets/docs/guide/edit-image/add-watermark.md +283 -330
  391. package/assets/docs/guide/edit-image/overview.md +29 -4
  392. package/assets/docs/guide/edit-image/remove-bg.md +283 -337
  393. package/assets/docs/guide/edit-image/replace-colors.md +424 -502
  394. package/assets/docs/guide/edit-image/transform/crop.md +463 -402
  395. package/assets/docs/guide/edit-image/transform/flip.md +353 -0
  396. package/assets/docs/guide/edit-image/transform/move.md +143 -100
  397. package/assets/docs/guide/edit-image/transform/resize.md +118 -88
  398. package/assets/docs/guide/edit-image/transform/rotate.md +132 -165
  399. package/assets/docs/guide/edit-image/transform/scale.md +230 -228
  400. package/assets/docs/guide/edit-image/transform.md +10 -5
  401. package/assets/docs/guide/edit-image.md +11 -7
  402. package/assets/docs/guide/edit-video/add-captions.md +344 -421
  403. package/assets/docs/guide/edit-video/add-watermark.md +312 -258
  404. package/assets/docs/guide/edit-video/join-and-arrange.md +237 -371
  405. package/assets/docs/guide/edit-video/redaction.md +419 -385
  406. package/assets/docs/guide/edit-video/split.md +243 -493
  407. package/assets/docs/guide/edit-video/transform/crop.md +21 -352
  408. package/assets/docs/guide/edit-video/transform/flip.md +102 -76
  409. package/assets/docs/guide/edit-video/transform/move.md +258 -310
  410. package/assets/docs/guide/edit-video/transform/resize.md +264 -428
  411. package/assets/docs/guide/edit-video/transform/rotate.md +265 -228
  412. package/assets/docs/guide/edit-video/transform/scale.md +320 -417
  413. package/assets/docs/guide/edit-video/transform.md +10 -6
  414. package/assets/docs/guide/edit-video/trim.md +448 -494
  415. package/assets/docs/guide/engine-interface.md +51 -62
  416. package/assets/docs/guide/export-save-publish/create-thumbnail.md +148 -184
  417. package/assets/docs/guide/export-save-publish/export/compress.md +161 -559
  418. package/assets/docs/guide/export-save-publish/export/overview.md +224 -373
  419. package/assets/docs/guide/export-save-publish/export/partial-export.md +386 -577
  420. package/assets/docs/guide/export-save-publish/export/size-limits.md +215 -310
  421. package/assets/docs/guide/export-save-publish/export/to-jpeg.md +132 -213
  422. package/assets/docs/guide/export-save-publish/export/to-pdf.md +139 -267
  423. package/assets/docs/guide/export-save-publish/export/to-png.md +121 -165
  424. package/assets/docs/guide/export-save-publish/export/to-raw-data.md +187 -234
  425. package/assets/docs/guide/export-save-publish/export/to-webp.md +160 -190
  426. package/assets/docs/guide/export-save-publish/export/with-color-mask.md +359 -203
  427. package/assets/docs/guide/export-save-publish/export.md +14 -11
  428. package/assets/docs/guide/export-save-publish/for-printing.md +141 -237
  429. package/assets/docs/guide/export-save-publish/for-social-media.md +124 -261
  430. package/assets/docs/guide/export-save-publish/pre-export-validation.md +436 -522
  431. package/assets/docs/guide/export-save-publish/save.md +167 -226
  432. package/assets/docs/guide/export-save-publish/store-custom-metadata.md +97 -162
  433. package/assets/docs/guide/file-format-support.md +9 -9
  434. package/assets/docs/guide/fills/color.md +370 -347
  435. package/assets/docs/guide/fills/image.md +167 -196
  436. package/assets/docs/guide/fills/overview.md +6 -4
  437. package/assets/docs/guide/fills/video.md +286 -438
  438. package/assets/docs/guide/fills.md +12 -8
  439. package/assets/docs/guide/filters-and-effects/apply.md +598 -664
  440. package/assets/docs/guide/filters-and-effects/blur.md +261 -159
  441. package/assets/docs/guide/filters-and-effects/chroma-key-green-screen.md +194 -293
  442. package/assets/docs/guide/filters-and-effects/create-custom-filters.md +548 -466
  443. package/assets/docs/guide/filters-and-effects/create-custom-lut-filter.md +176 -244
  444. package/assets/docs/guide/filters-and-effects/distortion.md +317 -384
  445. package/assets/docs/guide/filters-and-effects/duotone.md +221 -217
  446. package/assets/docs/guide/filters-and-effects/gradients.md +670 -813
  447. package/assets/docs/guide/filters-and-effects/overview.md +7 -7
  448. package/assets/docs/guide/filters-and-effects/support.md +97 -132
  449. package/assets/docs/guide/filters-and-effects.md +11 -6
  450. package/assets/docs/guide/get-started/agent-skills.md +20 -18
  451. package/assets/docs/guide/get-started/build-with-ai.md +7 -4
  452. package/assets/docs/guide/get-started/bun.md +219 -0
  453. package/assets/docs/guide/get-started/deno.md +161 -0
  454. package/assets/docs/guide/get-started/mcp-server.md +6 -4
  455. package/assets/docs/guide/get-started/overview.md +11 -6
  456. package/assets/docs/guide/get-started/vanilla-aws-lambda.md +506 -0
  457. package/assets/docs/guide/get-started/vanilla-clone-github-project.md +124 -0
  458. package/assets/docs/guide/get-started/vanilla.md +235 -0
  459. package/assets/docs/guide/guides/export-save-publish/export/audio.md +80 -66
  460. package/assets/docs/guide/guides.md +10 -9
  461. package/assets/docs/guide/import-media/asset-panel/refresh-assets.md +259 -288
  462. package/assets/docs/guide/import-media/concepts.md +20 -38
  463. package/assets/docs/guide/import-media/content-json-schema.md +145 -125
  464. package/assets/docs/guide/import-media/default-assets.md +113 -161
  465. package/assets/docs/guide/import-media/edit-or-remove-assets.md +391 -395
  466. package/assets/docs/guide/import-media/file-format-support.md +78 -61
  467. package/assets/docs/guide/import-media/from-remote-source/asset-versioning.md +273 -244
  468. package/assets/docs/guide/import-media/from-remote-source/remote-asset.md +152 -222
  469. package/assets/docs/guide/import-media/from-remote-source.md +9 -11
  470. package/assets/docs/guide/import-media/overview.md +5 -5
  471. package/assets/docs/guide/import-media/retrieve-mimetype.md +216 -108
  472. package/assets/docs/guide/import-media/size-limits.md +6 -4
  473. package/assets/docs/guide/import-media/source-sets.md +190 -251
  474. package/assets/docs/guide/import-media.md +10 -8
  475. package/assets/docs/guide/insert-media/audio.md +202 -195
  476. package/assets/docs/guide/insert-media/images.md +190 -188
  477. package/assets/docs/guide/insert-media/position-and-align.md +284 -551
  478. package/assets/docs/guide/insert-media/shapes-or-stickers.md +402 -418
  479. package/assets/docs/guide/insert-media/videos.md +236 -203
  480. package/assets/docs/guide/insert-media.md +10 -5
  481. package/assets/docs/guide/key-capabilities.md +36 -4
  482. package/assets/docs/guide/key-concepts.md +6 -4
  483. package/assets/docs/guide/licensing.md +6 -4
  484. package/assets/docs/guide/llms-txt.md +11 -7
  485. package/assets/docs/guide/open-the-editor/blank-canvas.md +102 -63
  486. package/assets/docs/guide/open-the-editor/from-image.md +157 -127
  487. package/assets/docs/guide/open-the-editor/from-template.md +131 -92
  488. package/assets/docs/guide/open-the-editor/from-video.md +204 -212
  489. package/assets/docs/guide/open-the-editor/import-design/from-archive.md +310 -360
  490. package/assets/docs/guide/open-the-editor/import-design/from-indesign.md +716 -513
  491. package/assets/docs/guide/open-the-editor/import-design/from-photoshop.md +667 -695
  492. package/assets/docs/guide/open-the-editor/import-design.md +228 -266
  493. package/assets/docs/guide/open-the-editor/load-scene.md +72 -68
  494. package/assets/docs/guide/open-the-editor/overview.md +6 -4
  495. package/assets/docs/guide/open-the-editor/uri-resolver.md +160 -251
  496. package/assets/docs/guide/open-the-editor.md +11 -9
  497. package/assets/docs/guide/outlines/overview.md +12 -4
  498. package/assets/docs/guide/outlines/shadows-and-glows.md +105 -410
  499. package/assets/docs/guide/outlines/strokes.md +218 -166
  500. package/assets/docs/guide/outlines.md +9 -4
  501. package/assets/docs/guide/overview.md +14 -6
  502. package/assets/docs/guide/performance.md +220 -113
  503. package/assets/docs/guide/plugins/print-ready-pdf.md +273 -368
  504. package/assets/docs/guide/plugins.md +10 -16
  505. package/assets/docs/guide/rules/asset-handling.md +7 -18
  506. package/assets/docs/guide/rules/common-pitfalls.md +25 -42
  507. package/assets/docs/guide/rules/content-fill-mode.md +4 -4
  508. package/assets/docs/guide/rules/enforce-brand-guidelines.md +398 -567
  509. package/assets/docs/guide/rules/lock-content.md +188 -231
  510. package/assets/docs/guide/rules/moderate-content.md +580 -571
  511. package/assets/docs/guide/rules/overview.md +345 -380
  512. package/assets/docs/guide/rules/silent-init-errors.md +4 -1
  513. package/assets/docs/guide/rules/verify-properties-before-use.md +2 -11
  514. package/assets/docs/guide/rules.md +10 -5
  515. package/assets/docs/guide/security.md +7 -5
  516. package/assets/docs/guide/serve-assets.md +57 -284
  517. package/assets/docs/guide/settings.md +96 -74
  518. package/assets/docs/guide/shapes.md +10 -5
  519. package/assets/docs/guide/stickers-and-shapes/combine.md +397 -583
  520. package/assets/docs/guide/stickers-and-shapes/create-cutout.md +181 -268
  521. package/assets/docs/guide/stickers-and-shapes/create-edit/create-shapes.md +418 -431
  522. package/assets/docs/guide/stickers-and-shapes/create-edit/create-stickers.md +147 -226
  523. package/assets/docs/guide/stickers-and-shapes/create-edit/edit-shapes.md +138 -123
  524. package/assets/docs/guide/stickers-and-shapes/insert-qr-code.md +151 -149
  525. package/assets/docs/guide/stickers.md +9 -4
  526. package/assets/docs/guide/text/add.md +470 -482
  527. package/assets/docs/guide/text/adjust-spacing.md +179 -214
  528. package/assets/docs/guide/text/auto-size.md +210 -271
  529. package/assets/docs/guide/text/edit.md +294 -309
  530. package/assets/docs/guide/text/effects.md +154 -190
  531. package/assets/docs/guide/text/emojis.md +199 -232
  532. package/assets/docs/guide/text/language-support.md +369 -382
  533. package/assets/docs/guide/text/overview.md +41 -4
  534. package/assets/docs/guide/text/styling.md +239 -273
  535. package/assets/docs/guide/text/text-designs.md +405 -544
  536. package/assets/docs/guide/text.md +10 -9
  537. package/assets/docs/guide/to-v1-19.md +12 -10
  538. package/assets/docs/guide/upgrade.md +8 -9
  539. package/assets/docs/guide/use-templates/apply-template.md +174 -163
  540. package/assets/docs/guide/use-templates/generate.md +171 -152
  541. package/assets/docs/guide/use-templates/overview.md +32 -4
  542. package/assets/docs/guide/use-templates/programmatic.md +266 -301
  543. package/assets/docs/guide/use-templates/replace-content.md +181 -171
  544. package/assets/docs/guide/what-is-cesdk.md +71 -282
  545. package/assets/docs/handbook/SKILL.md +24 -0
  546. package/dist/assets/inline.generated.d.ts.map +1 -1
  547. package/dist/assets/inline.generated.js +544 -406
  548. package/dist/assets/inline.generated.js.map +1 -1
  549. package/dist/assets/load-browser.d.ts +1 -1
  550. package/dist/assets/load-browser.js +1 -1
  551. package/dist/assets/load-browser.js.map +1 -1
  552. package/dist/assets/load-node.d.ts +1 -1
  553. package/dist/assets/load-node.js +1 -1
  554. package/dist/assets/load-node.js.map +1 -1
  555. package/dist/cli/http.d.ts.map +1 -1
  556. package/dist/cli/http.js +4 -28
  557. package/dist/cli/http.js.map +1 -1
  558. package/dist/cli/redirect-console.d.ts +1 -1
  559. package/dist/cli/redirect-console.d.ts.map +1 -1
  560. package/dist/cli/redirect-console.js +12 -3
  561. package/dist/cli/redirect-console.js.map +1 -1
  562. package/dist/cli/resolve-license.d.ts.map +1 -1
  563. package/dist/cli/resolve-license.js +8 -6
  564. package/dist/cli/resolve-license.js.map +1 -1
  565. package/dist/cli/stdio.d.ts +9 -0
  566. package/dist/cli/stdio.d.ts.map +1 -1
  567. package/dist/cli/stdio.js +48 -4
  568. package/dist/cli/stdio.js.map +1 -1
  569. package/dist/cli.js +10 -1
  570. package/dist/cli.js.map +1 -1
  571. package/dist/config.d.ts +11 -2
  572. package/dist/config.d.ts.map +1 -1
  573. package/dist/config.js +20 -1
  574. package/dist/config.js.map +1 -1
  575. package/dist/diagnostics/bundle.d.ts +10 -0
  576. package/dist/diagnostics/bundle.d.ts.map +1 -0
  577. package/dist/diagnostics/bundle.js +148 -0
  578. package/dist/diagnostics/bundle.js.map +1 -0
  579. package/dist/diagnostics/compose.d.ts +3 -0
  580. package/dist/diagnostics/compose.d.ts.map +1 -0
  581. package/dist/diagnostics/compose.js +15 -0
  582. package/dist/diagnostics/compose.js.map +1 -0
  583. package/dist/diagnostics/events.d.ts +34 -0
  584. package/dist/diagnostics/events.d.ts.map +1 -0
  585. package/dist/diagnostics/events.js +3 -0
  586. package/dist/diagnostics/events.js.map +1 -0
  587. package/dist/diagnostics/file-sink.d.ts +38 -0
  588. package/dist/diagnostics/file-sink.d.ts.map +1 -0
  589. package/dist/diagnostics/file-sink.js +157 -0
  590. package/dist/diagnostics/file-sink.js.map +1 -0
  591. package/dist/diagnostics/redact.d.ts +7 -0
  592. package/dist/diagnostics/redact.d.ts.map +1 -0
  593. package/dist/diagnostics/redact.js +43 -0
  594. package/dist/diagnostics/redact.js.map +1 -0
  595. package/dist/diagnostics/tool-call-adapter.d.ts +4 -0
  596. package/dist/diagnostics/tool-call-adapter.d.ts.map +1 -0
  597. package/dist/diagnostics/tool-call-adapter.js +21 -0
  598. package/dist/diagnostics/tool-call-adapter.js.map +1 -0
  599. package/dist/engine/cesdk-adapter.d.ts +5 -1
  600. package/dist/engine/cesdk-adapter.d.ts.map +1 -1
  601. package/dist/engine/cesdk-adapter.js +9 -2
  602. package/dist/engine/cesdk-adapter.js.map +1 -1
  603. package/dist/engine/index.d.ts +1 -0
  604. package/dist/engine/index.d.ts.map +1 -1
  605. package/dist/engine/index.js +4 -0
  606. package/dist/engine/index.js.map +1 -1
  607. package/dist/engine/scene-resource-schemes.d.ts +2 -0
  608. package/dist/engine/scene-resource-schemes.d.ts.map +1 -0
  609. package/dist/engine/scene-resource-schemes.js +20 -0
  610. package/dist/engine/scene-resource-schemes.js.map +1 -0
  611. package/dist/http/server.d.ts +0 -6
  612. package/dist/http/server.d.ts.map +1 -1
  613. package/dist/http/server.js +1 -2
  614. package/dist/http/server.js.map +1 -1
  615. package/dist/server.d.ts +0 -4
  616. package/dist/server.d.ts.map +1 -1
  617. package/dist/server.js +4 -60
  618. package/dist/server.js.map +1 -1
  619. package/dist/test/scripts/changelog-add.d.ts +8 -0
  620. package/dist/test/scripts/changelog-add.d.ts.map +1 -0
  621. package/dist/test/scripts/changelog-add.js +50 -0
  622. package/dist/test/scripts/changelog-add.js.map +1 -0
  623. package/dist/test/scripts/changelog-collate.d.ts +38 -0
  624. package/dist/test/scripts/changelog-collate.d.ts.map +1 -0
  625. package/dist/test/scripts/changelog-collate.js +171 -0
  626. package/dist/test/scripts/changelog-collate.js.map +1 -0
  627. package/dist/test/test/changelog.test.d.ts +2 -0
  628. package/dist/test/test/changelog.test.d.ts.map +1 -0
  629. package/dist/test/test/changelog.test.js +293 -0
  630. package/dist/test/test/changelog.test.js.map +1 -0
  631. package/dist/test/test/cli/dispatcher.test.js +10 -3
  632. package/dist/test/test/cli/dispatcher.test.js.map +1 -1
  633. package/dist/test/test/cli/redirect-console.test.js +31 -0
  634. package/dist/test/test/cli/redirect-console.test.js.map +1 -1
  635. package/dist/test/test/cli/resolve-license.test.js +10 -1
  636. package/dist/test/test/cli/resolve-license.test.js.map +1 -1
  637. package/dist/test/test/cli/stdio-diagnostics.test.d.ts +2 -0
  638. package/dist/test/test/cli/stdio-diagnostics.test.d.ts.map +1 -0
  639. package/dist/test/test/cli/stdio-diagnostics.test.js +31 -0
  640. package/dist/test/test/cli/stdio-diagnostics.test.js.map +1 -0
  641. package/dist/test/test/config.test.js +17 -13
  642. package/dist/test/test/config.test.js.map +1 -1
  643. package/dist/test/test/diagnostics/bundle.test.d.ts +2 -0
  644. package/dist/test/test/diagnostics/bundle.test.d.ts.map +1 -0
  645. package/dist/test/test/diagnostics/bundle.test.js +53 -0
  646. package/dist/test/test/diagnostics/bundle.test.js.map +1 -0
  647. package/dist/test/test/diagnostics/compose.test.d.ts +2 -0
  648. package/dist/test/test/diagnostics/compose.test.d.ts.map +1 -0
  649. package/dist/test/test/diagnostics/compose.test.js +31 -0
  650. package/dist/test/test/diagnostics/compose.test.js.map +1 -0
  651. package/dist/test/test/diagnostics/file-sink.test.d.ts +2 -0
  652. package/dist/test/test/diagnostics/file-sink.test.d.ts.map +1 -0
  653. package/dist/test/test/diagnostics/file-sink.test.js +113 -0
  654. package/dist/test/test/diagnostics/file-sink.test.js.map +1 -0
  655. package/dist/test/test/diagnostics/redact.test.d.ts +2 -0
  656. package/dist/test/test/diagnostics/redact.test.d.ts.map +1 -0
  657. package/dist/test/test/diagnostics/redact.test.js +59 -0
  658. package/dist/test/test/diagnostics/redact.test.js.map +1 -0
  659. package/dist/test/test/diagnostics/tool-call-adapter.test.d.ts +2 -0
  660. package/dist/test/test/diagnostics/tool-call-adapter.test.d.ts.map +1 -0
  661. package/dist/test/test/diagnostics/tool-call-adapter.test.js +34 -0
  662. package/dist/test/test/diagnostics/tool-call-adapter.test.js.map +1 -0
  663. package/dist/test/test/engine/cesdk-adapter.test.d.ts +2 -0
  664. package/dist/test/test/engine/cesdk-adapter.test.d.ts.map +1 -0
  665. package/dist/test/test/engine/cesdk-adapter.test.js +32 -0
  666. package/dist/test/test/engine/cesdk-adapter.test.js.map +1 -0
  667. package/dist/test/test/handbook-contract.test.js +6 -2
  668. package/dist/test/test/handbook-contract.test.js.map +1 -1
  669. package/dist/test/test/http/server.test.js +0 -36
  670. package/dist/test/test/http/server.test.js.map +1 -1
  671. package/dist/test/test/http/workspace-auth.test.js +0 -1
  672. package/dist/test/test/http/workspace-auth.test.js.map +1 -1
  673. package/dist/test/test/server.test.js +0 -40
  674. package/dist/test/test/server.test.js.map +1 -1
  675. package/dist/test/test/tools/edit-harness.d.ts +14 -0
  676. package/dist/test/test/tools/edit-harness.d.ts.map +1 -0
  677. package/dist/test/test/tools/edit-harness.js +30 -0
  678. package/dist/test/test/tools/edit-harness.js.map +1 -0
  679. package/dist/test/test/tools/edit.telemetry.test.d.ts +2 -0
  680. package/dist/test/test/tools/edit.telemetry.test.d.ts.map +1 -0
  681. package/dist/test/test/tools/edit.telemetry.test.js +46 -0
  682. package/dist/test/test/tools/edit.telemetry.test.js.map +1 -0
  683. package/dist/test/test/tools/export-harness.d.ts +13 -0
  684. package/dist/test/test/tools/export-harness.d.ts.map +1 -0
  685. package/dist/test/test/tools/export-harness.js +27 -0
  686. package/dist/test/test/tools/export-harness.js.map +1 -0
  687. package/dist/test/test/tools/export.telemetry.test.d.ts +2 -0
  688. package/dist/test/test/tools/export.telemetry.test.d.ts.map +1 -0
  689. package/dist/test/test/tools/export.telemetry.test.js +65 -0
  690. package/dist/test/test/tools/export.telemetry.test.js.map +1 -0
  691. package/dist/test/test/tools/import.test.d.ts +2 -0
  692. package/dist/test/test/tools/import.test.d.ts.map +1 -0
  693. package/dist/test/test/tools/import.test.js +122 -0
  694. package/dist/test/test/tools/import.test.js.map +1 -0
  695. package/dist/test/test/tools/index.test.js +78 -16
  696. package/dist/test/test/tools/index.test.js.map +1 -1
  697. package/dist/test/test/tools/load.integration.test.d.ts +2 -0
  698. package/dist/test/test/tools/load.integration.test.d.ts.map +1 -0
  699. package/dist/test/test/tools/load.integration.test.js +165 -0
  700. package/dist/test/test/tools/load.integration.test.js.map +1 -0
  701. package/dist/test/test/tools/load.test.d.ts +2 -0
  702. package/dist/test/test/tools/load.test.d.ts.map +1 -0
  703. package/dist/test/test/tools/load.test.js +387 -0
  704. package/dist/test/test/tools/load.test.js.map +1 -0
  705. package/dist/test/test/tools/preview-harness.d.ts +9 -0
  706. package/dist/test/test/tools/preview-harness.d.ts.map +1 -0
  707. package/dist/test/test/tools/preview-harness.js +23 -0
  708. package/dist/test/test/tools/preview-harness.js.map +1 -0
  709. package/dist/test/test/tools/preview.telemetry.test.d.ts +2 -0
  710. package/dist/test/test/tools/preview.telemetry.test.d.ts.map +1 -0
  711. package/dist/test/test/tools/preview.telemetry.test.js +36 -0
  712. package/dist/test/test/tools/preview.telemetry.test.js.map +1 -0
  713. package/dist/test/test/tools/schema-best-practices.d.ts +13 -0
  714. package/dist/test/test/tools/schema-best-practices.d.ts.map +1 -0
  715. package/dist/test/test/tools/schema-best-practices.js +169 -0
  716. package/dist/test/test/tools/schema-best-practices.js.map +1 -0
  717. package/dist/test/test/tools/schema-best-practices.test.d.ts +3 -0
  718. package/dist/test/test/tools/schema-best-practices.test.d.ts.map +1 -0
  719. package/dist/test/test/tools/schema-best-practices.test.js +194 -0
  720. package/dist/test/test/tools/schema-best-practices.test.js.map +1 -0
  721. package/dist/test/test/tools/spans.test.d.ts +2 -0
  722. package/dist/test/test/tools/spans.test.d.ts.map +1 -0
  723. package/dist/test/test/tools/spans.test.js +84 -0
  724. package/dist/test/test/tools/spans.test.js.map +1 -0
  725. package/dist/test/test/viewer/cesdk-cdn.test.d.ts +2 -0
  726. package/dist/test/test/viewer/cesdk-cdn.test.d.ts.map +1 -0
  727. package/dist/test/test/viewer/cesdk-cdn.test.js +19 -0
  728. package/dist/test/test/viewer/cesdk-cdn.test.js.map +1 -0
  729. package/dist/test/test/viewer/config-route.test.d.ts +2 -0
  730. package/dist/test/test/viewer/config-route.test.d.ts.map +1 -0
  731. package/dist/test/test/viewer/config-route.test.js +28 -0
  732. package/dist/test/test/viewer/config-route.test.js.map +1 -0
  733. package/dist/test/test/viewer/spa-version.test.d.ts +2 -0
  734. package/dist/test/test/viewer/spa-version.test.d.ts.map +1 -0
  735. package/dist/test/test/viewer/spa-version.test.js +14 -0
  736. package/dist/test/test/viewer/spa-version.test.js.map +1 -0
  737. package/dist/test/test/workspace/content-hash.test.d.ts +2 -0
  738. package/dist/test/test/workspace/content-hash.test.d.ts.map +1 -0
  739. package/dist/test/test/workspace/content-hash.test.js +17 -0
  740. package/dist/test/test/workspace/content-hash.test.js.map +1 -0
  741. package/dist/test/tsconfig.test.tsbuildinfo +1 -1
  742. package/dist/test/vitest.config.js +1 -1
  743. package/dist/test/vitest.config.js.map +1 -1
  744. package/dist/tools/asset-generate.d.ts.map +1 -1
  745. package/dist/tools/asset-generate.js +1 -8
  746. package/dist/tools/asset-generate.js.map +1 -1
  747. package/dist/tools/edit.d.ts +3 -0
  748. package/dist/tools/edit.d.ts.map +1 -1
  749. package/dist/tools/edit.js +145 -96
  750. package/dist/tools/edit.js.map +1 -1
  751. package/dist/tools/export.d.ts +3 -0
  752. package/dist/tools/export.d.ts.map +1 -1
  753. package/dist/tools/export.js +146 -108
  754. package/dist/tools/export.js.map +1 -1
  755. package/dist/tools/import.d.ts +12 -0
  756. package/dist/tools/import.d.ts.map +1 -0
  757. package/dist/tools/import.js +144 -0
  758. package/dist/tools/import.js.map +1 -0
  759. package/dist/tools/index.d.ts +3 -0
  760. package/dist/tools/index.d.ts.map +1 -1
  761. package/dist/tools/index.js +44 -4
  762. package/dist/tools/index.js.map +1 -1
  763. package/dist/tools/load.d.ts +26 -0
  764. package/dist/tools/load.d.ts.map +1 -0
  765. package/dist/tools/load.js +400 -0
  766. package/dist/tools/load.js.map +1 -0
  767. package/dist/tools/preview.d.ts +3 -0
  768. package/dist/tools/preview.d.ts.map +1 -1
  769. package/dist/tools/preview.js +79 -44
  770. package/dist/tools/preview.js.map +1 -1
  771. package/dist/tools/result.d.ts +1 -1
  772. package/dist/tools/result.js +2 -2
  773. package/dist/tools/result.js.map +1 -1
  774. package/dist/tools/spans.d.ts +45 -0
  775. package/dist/tools/spans.d.ts.map +1 -0
  776. package/dist/tools/spans.js +77 -0
  777. package/dist/tools/spans.js.map +1 -0
  778. package/dist/tools/telemetry-wrapper.d.ts +4 -0
  779. package/dist/tools/telemetry-wrapper.d.ts.map +1 -0
  780. package/dist/tools/telemetry-wrapper.js +43 -0
  781. package/dist/tools/telemetry-wrapper.js.map +1 -0
  782. package/dist/viewer/cesdk-cdn.d.ts +16 -0
  783. package/dist/viewer/cesdk-cdn.d.ts.map +1 -0
  784. package/dist/viewer/cesdk-cdn.js +30 -0
  785. package/dist/viewer/cesdk-cdn.js.map +1 -0
  786. package/dist/viewer/router.d.ts +6 -0
  787. package/dist/viewer/router.d.ts.map +1 -1
  788. package/dist/viewer/router.js +4 -1
  789. package/dist/viewer/router.js.map +1 -1
  790. package/dist/viewer/spa-assets.generated.d.ts.map +1 -1
  791. package/dist/viewer/spa-assets.generated.js +2 -3
  792. package/dist/viewer/spa-assets.generated.js.map +1 -1
  793. package/dist/workspace/content-hash.d.ts +2 -0
  794. package/dist/workspace/content-hash.d.ts.map +1 -0
  795. package/dist/workspace/content-hash.js +15 -0
  796. package/dist/workspace/content-hash.js.map +1 -0
  797. package/package.json +18 -9
  798. package/assets/docs/guide/actions.md +0 -1038
  799. package/assets/docs/guide/animation/overview.md +0 -22
  800. package/assets/docs/guide/automation/batch-processing.md +0 -474
  801. package/assets/docs/guide/browser-support.md +0 -38
  802. package/assets/docs/guide/concepts/edit-modes.md +0 -431
  803. package/assets/docs/guide/concepts/headless-mode/browser.md +0 -291
  804. package/assets/docs/guide/create-audio/audio.md +0 -336
  805. package/assets/docs/guide/create-video/overview.md +0 -224
  806. package/assets/docs/guide/create-video/timeline-editor.md +0 -622
  807. package/assets/docs/guide/create-video/update-caption-presets.md +0 -676
  808. package/assets/docs/guide/edit-image/vectorize.md +0 -204
  809. package/assets/docs/guide/export-save-publish/export/to-html5.md +0 -474
  810. package/assets/docs/guide/export-save-publish/export/to-mp4.md +0 -364
  811. package/assets/docs/guide/get-started/vanilla-js/quickstart.md +0 -175
  812. package/assets/docs/guide/grid-and-rulers.md +0 -222
  813. package/assets/docs/guide/guides/text/rendering-internals.md +0 -796
  814. package/assets/docs/guide/import-media/asset-library.md +0 -23
  815. package/assets/docs/guide/import-media/asset-panel/basics.md +0 -324
  816. package/assets/docs/guide/import-media/asset-panel/customize.md +0 -478
  817. package/assets/docs/guide/import-media/asset-panel/thumbnails.md +0 -633
  818. package/assets/docs/guide/import-media/capture-from-camera/record-video.md +0 -137
  819. package/assets/docs/guide/import-media/capture-from-camera.md +0 -20
  820. package/assets/docs/guide/import-media/from-local-source/user-upload.md +0 -438
  821. package/assets/docs/guide/import-media/from-local-source.md +0 -20
  822. package/assets/docs/guide/import-media/from-remote-source/getty-images.md +0 -627
  823. package/assets/docs/guide/import-media/from-remote-source/imgly-premium-assets.md +0 -625
  824. package/assets/docs/guide/import-media/from-remote-source/pexels.md +0 -692
  825. package/assets/docs/guide/import-media/from-remote-source/soundstripe.md +0 -497
  826. package/assets/docs/guide/import-media/from-remote-source/third-party.md +0 -51
  827. package/assets/docs/guide/import-media/from-remote-source/unsplash.md +0 -914
  828. package/assets/docs/guide/import-media/from-remote-source/your-server.md +0 -764
  829. package/assets/docs/guide/open-the-editor/from-htmlcanvas.md +0 -228
  830. package/assets/docs/guide/open-the-editor/set-zoom-level.md +0 -303
  831. package/assets/docs/guide/plugins/asset-sources.md +0 -553
  832. package/assets/docs/guide/starterkits/3d-mockup-editor.md +0 -748
  833. package/assets/docs/guide/starterkits/advanced-editor.md +0 -698
  834. package/assets/docs/guide/starterkits/advanced-video-editor.md +0 -696
  835. package/assets/docs/guide/starterkits/ai-editor.md +0 -749
  836. package/assets/docs/guide/starterkits/airtable-image-editor.md +0 -672
  837. package/assets/docs/guide/starterkits/apparel-ui.md +0 -188
  838. package/assets/docs/guide/starterkits/assets.md +0 -27
  839. package/assets/docs/guide/starterkits/auto-resize.md +0 -586
  840. package/assets/docs/guide/starterkits/automated-video-generation.md +0 -692
  841. package/assets/docs/guide/starterkits/background-removal-editor.md +0 -480
  842. package/assets/docs/guide/starterkits/content-moderation.md +0 -863
  843. package/assets/docs/guide/starterkits/creative-automation.md +0 -28
  844. package/assets/docs/guide/starterkits/custom-built-uis.md +0 -26
  845. package/assets/docs/guide/starterkits/customization.md +0 -29
  846. package/assets/docs/guide/starterkits/cutout-lines-editor.md +0 -470
  847. package/assets/docs/guide/starterkits/data-merge.md +0 -850
  848. package/assets/docs/guide/starterkits/design-editor.md +0 -698
  849. package/assets/docs/guide/starterkits/design-generation.md +0 -719
  850. package/assets/docs/guide/starterkits/design-validation.md +0 -808
  851. package/assets/docs/guide/starterkits/editor-ui-configurations.md +0 -14
  852. package/assets/docs/guide/starterkits/export-options.md +0 -724
  853. package/assets/docs/guide/starterkits/export-using-renderer.md +0 -708
  854. package/assets/docs/guide/starterkits/extensibility.md +0 -28
  855. package/assets/docs/guide/starterkits/force-crop-editor.md +0 -675
  856. package/assets/docs/guide/starterkits/form-based-template-adoption.md +0 -522
  857. package/assets/docs/guide/starterkits/getty-images-editor.md +0 -700
  858. package/assets/docs/guide/starterkits/html5-ads-exporter.md +0 -719
  859. package/assets/docs/guide/starterkits/indesign-template-import.md +0 -580
  860. package/assets/docs/guide/starterkits/layouts-editor.md +0 -724
  861. package/assets/docs/guide/starterkits/mobile-ui.md +0 -185
  862. package/assets/docs/guide/starterkits/mockup-editor.md +0 -745
  863. package/assets/docs/guide/starterkits/multi-image-generation.md +0 -542
  864. package/assets/docs/guide/starterkits/page-sizes-editor.md +0 -657
  865. package/assets/docs/guide/starterkits/pexels-image-editor.md +0 -665
  866. package/assets/docs/guide/starterkits/photo-editor.md +0 -755
  867. package/assets/docs/guide/starterkits/photo-ui.md +0 -186
  868. package/assets/docs/guide/starterkits/photobook-ui.md +0 -188
  869. package/assets/docs/guide/starterkits/placeholders.md +0 -678
  870. package/assets/docs/guide/starterkits/player.md +0 -405
  871. package/assets/docs/guide/starterkits/plugins.md +0 -25
  872. package/assets/docs/guide/starterkits/postcard-editor.md +0 -202
  873. package/assets/docs/guide/starterkits/pptx-template-import.md +0 -581
  874. package/assets/docs/guide/starterkits/print-ready-pdf-editor.md +0 -746
  875. package/assets/docs/guide/starterkits/product-editor.md +0 -773
  876. package/assets/docs/guide/starterkits/psd-template-import.md +0 -580
  877. package/assets/docs/guide/starterkits/qr-code-editor.md +0 -470
  878. package/assets/docs/guide/starterkits/single-page-editor.md +0 -661
  879. package/assets/docs/guide/starterkits/start-with-image.md +0 -684
  880. package/assets/docs/guide/starterkits/start-with-video.md +0 -651
  881. package/assets/docs/guide/starterkits/t-shirt-designer.md +0 -742
  882. package/assets/docs/guide/starterkits/templating.md +0 -23
  883. package/assets/docs/guide/starterkits/theming.md +0 -662
  884. package/assets/docs/guide/starterkits/translation-internationalization.md +0 -662
  885. package/assets/docs/guide/starterkits/unsplash-editor.md +0 -839
  886. package/assets/docs/guide/starterkits/vectorizer-editor.md +0 -466
  887. package/assets/docs/guide/starterkits/version-history.md +0 -745
  888. package/assets/docs/guide/starterkits/video-animations.md +0 -853
  889. package/assets/docs/guide/starterkits/video-captions.md +0 -884
  890. package/assets/docs/guide/starterkits/video-editing.md +0 -25
  891. package/assets/docs/guide/starterkits/video-editor.md +0 -696
  892. package/assets/docs/guide/starterkits/video-export-options.md +0 -676
  893. package/assets/docs/guide/starterkits/viewer.md +0 -400
  894. package/assets/docs/guide/starterkits.md +0 -41
  895. package/assets/docs/guide/stickers-and-shapes/create-edit/vector-edit.md +0 -362
  896. package/assets/docs/guide/text/custom-fonts.md +0 -401
  897. package/assets/docs/guide/text/decorations.md +0 -330
  898. package/assets/docs/guide/text/enumerations.md +0 -258
  899. package/assets/docs/guide/to-v1-10.md +0 -131
  900. package/assets/docs/guide/to-v1-13.md +0 -165
  901. package/assets/docs/guide/to-v1-32.md +0 -110
  902. package/assets/docs/guide/to-v1-69.md +0 -468
  903. package/assets/docs/guide/to-v1-72.md +0 -193
  904. package/assets/docs/guide/use-templates/library.md +0 -450
  905. package/assets/docs/guide/user-interface/ai-integration/audio-generation.md +0 -428
  906. package/assets/docs/guide/user-interface/ai-integration/auto-captions.md +0 -337
  907. package/assets/docs/guide/user-interface/ai-integration/custom-provider.md +0 -853
  908. package/assets/docs/guide/user-interface/ai-integration/gateway-provider.md +0 -1045
  909. package/assets/docs/guide/user-interface/ai-integration/image-generation.md +0 -641
  910. package/assets/docs/guide/user-interface/ai-integration/integrate.md +0 -966
  911. package/assets/docs/guide/user-interface/ai-integration/proxy-server.md +0 -99
  912. package/assets/docs/guide/user-interface/ai-integration/text-generation.md +0 -498
  913. package/assets/docs/guide/user-interface/ai-integration/video-generation.md +0 -493
  914. package/assets/docs/guide/user-interface/ai-integration.md +0 -30
  915. package/assets/docs/guide/user-interface/appearance/change-ui-font.md +0 -316
  916. package/assets/docs/guide/user-interface/appearance/custom-labels.md +0 -509
  917. package/assets/docs/guide/user-interface/appearance/icons.md +0 -373
  918. package/assets/docs/guide/user-interface/appearance/theming.md +0 -665
  919. package/assets/docs/guide/user-interface/appearance.md +0 -23
  920. package/assets/docs/guide/user-interface/build-your-own-ui.md +0 -620
  921. package/assets/docs/guide/user-interface/customization/canvas-menu.md +0 -412
  922. package/assets/docs/guide/user-interface/customization/canvas.md +0 -281
  923. package/assets/docs/guide/user-interface/customization/color-palette.md +0 -413
  924. package/assets/docs/guide/user-interface/customization/crop-presets.md +0 -384
  925. package/assets/docs/guide/user-interface/customization/disable-or-enable.md +0 -676
  926. package/assets/docs/guide/user-interface/customization/dock.md +0 -399
  927. package/assets/docs/guide/user-interface/customization/force-crop.md +0 -289
  928. package/assets/docs/guide/user-interface/customization/inspector-bar.md +0 -371
  929. package/assets/docs/guide/user-interface/customization/navigation-bar.md +0 -516
  930. package/assets/docs/guide/user-interface/customization/page-format.md +0 -436
  931. package/assets/docs/guide/user-interface/customization/panel.md +0 -605
  932. package/assets/docs/guide/user-interface/customization/quick-start/add-action-buttons.md +0 -531
  933. package/assets/docs/guide/user-interface/customization/quick-start/add-dock-buttons.md +0 -358
  934. package/assets/docs/guide/user-interface/customization/quick-start/create-custom-components.md +0 -374
  935. package/assets/docs/guide/user-interface/customization/quick-start/reorder-components.md +0 -323
  936. package/assets/docs/guide/user-interface/customization/quick-start/show-hide-components.md +0 -294
  937. package/assets/docs/guide/user-interface/customization/quick-start.md +0 -12
  938. package/assets/docs/guide/user-interface/customization/reference/component-order-api.md +0 -519
  939. package/assets/docs/guide/user-interface/customization/reference/component-reference.md +0 -333
  940. package/assets/docs/guide/user-interface/customization/reference.md +0 -12
  941. package/assets/docs/guide/user-interface/customization.md +0 -39
  942. package/assets/docs/guide/user-interface/localization.md +0 -633
  943. package/assets/docs/guide/user-interface/overview.md +0 -167
  944. package/assets/docs/guide/user-interface/ui-extensions/add-custom-feature.md +0 -411
  945. package/assets/docs/guide/user-interface/ui-extensions/asset-library.md +0 -721
  946. package/assets/docs/guide/user-interface/ui-extensions/create-custom-panel.md +0 -331
  947. package/assets/docs/guide/user-interface/ui-extensions/customize-behaviour.md +0 -553
  948. package/assets/docs/guide/user-interface/ui-extensions/notifications-and-dialogs.md +0 -672
  949. package/assets/docs/guide/user-interface/ui-extensions/quick-actions.md +0 -415
  950. package/assets/docs/guide/user-interface/ui-extensions/register-new-component.md +0 -521
  951. package/assets/docs/guide/user-interface/ui-extensions.md +0 -26
  952. package/assets/docs/guide/user-interface.md +0 -25
  953. package/assets/prompts/evals-assetGenerate.md +0 -12
  954. package/assets/prompts/evals-brutalistCore.md +0 -34
  955. package/assets/prompts/evals-danskCatalogue.md +0 -31
  956. package/assets/prompts/evals-exportRoundTrip.md +0 -12
  957. package/assets/prompts/evals-inspectPriorCode.md +0 -16
  958. package/assets/prompts/evals-listProjectFiles.md +0 -6
  959. package/assets/prompts/evals-readAndExplainScript.md +0 -6
  960. package/assets/prompts/evals-resumeAcrossRestart.md +0 -15
  961. package/assets/prompts/evals-rewindRecovery.md +0 -10
  962. package/assets/prompts/evals-searchAcrossFiles.md +0 -6
  963. package/assets/prompts/evals-weddingCard.md +0 -20
  964. package/assets/prompts/explain.md +0 -6
  965. package/assets/prompts/review.md +0 -6
  966. package/dist/frontmatter.d.ts +0 -15
  967. package/dist/frontmatter.d.ts.map +0 -1
  968. package/dist/frontmatter.js +0 -46
  969. package/dist/frontmatter.js.map +0 -1
  970. package/dist/test/test/frontmatter.test.d.ts +0 -2
  971. package/dist/test/test/frontmatter.test.d.ts.map +0 -1
  972. package/dist/test/test/frontmatter.test.js +0 -55
  973. package/dist/test/test/frontmatter.test.js.map +0 -1
@@ -0,0 +1,3417 @@
1
+ > This is one page of the CE.SDK Node.js `@cesdk/node` API reference. For a complete overview, see the [Node.js Documentation Index](https://img.ly/docs/cesdk/node.md) or the [node API Index](./api/node.md). For all docs in one file, see [llms-full.txt](./llms-full.txt.md).
2
+
3
+ ---
4
+
5
+ Control the design editor's behavior and settings.
6
+
7
+ The EditorAPI provides access to edit modes, history management, editor settings, color management,
8
+ resource handling, and global scope controls. It serves as the central configuration and control interface
9
+ for the design editor engine.
10
+
11
+ ## Constructors
12
+
13
+ <details>
14
+ <summary>
15
+ ### Constructor
16
+
17
+ <br /><p><code>EditorAPI</code></p>
18
+ </summary>
19
+ </details>
20
+
21
+ ## Role & Scope Management
22
+
23
+ Manage user roles and global scope permissions.
24
+
25
+ <details>
26
+ <summary>
27
+ ### setRole()
28
+
29
+ <br /><p>Set the user role and apply role-dependent defaults.</p>
30
+ </summary>
31
+
32
+ Automatically configures scopes and settings based on the specified role.
33
+
34
+ #### Parameters
35
+
36
+ | Parameter | Type | Description |
37
+ | ------ | ------ | ------ |
38
+ | `role` | [`RoleString`](./api/node/type-aliases/rolestring.md) | The role to assign to the user. |
39
+
40
+ #### Returns
41
+
42
+ `void`
43
+
44
+ #### Signature
45
+
46
+ ```typescript
47
+ setRole(role: RoleString): void
48
+ ```
49
+
50
+ ***
51
+ </details>
52
+
53
+ <details>
54
+ <summary>
55
+ ### getRole()
56
+
57
+ <br /><p>Get the current user role.</p>
58
+ </summary>
59
+
60
+ #### Returns
61
+
62
+ [`RoleString`](./api/node/type-aliases/rolestring.md)
63
+
64
+ The current role of the user.
65
+
66
+ #### Signature
67
+
68
+ ```typescript
69
+ getRole(): RoleString
70
+ ```
71
+
72
+ ***
73
+ </details>
74
+
75
+ <details>
76
+ <summary>
77
+ ### findAllScopes()
78
+
79
+ <br /><p>Get all available global scope names.</p>
80
+ </summary>
81
+
82
+ #### Returns
83
+
84
+ [`Scope`](./api/node/type-aliases/scope.md)\[]
85
+
86
+ The names of all available global scopes.
87
+
88
+ #### Signature
89
+
90
+ ```typescript
91
+ findAllScopes(): Scope[]
92
+ ```
93
+
94
+ ***
95
+ </details>
96
+
97
+ <details>
98
+ <summary>
99
+ ### setGlobalScope()
100
+
101
+ <br /><p>Set a global scope permission level.</p>
102
+ </summary>
103
+
104
+ #### Parameters
105
+
106
+ | Parameter | Type | Description |
107
+ | ------ | ------ | ------ |
108
+ | `key` | [`Scope`](./api/node/type-aliases/scope.md) | The scope to configure. |
109
+ | `value` | `"Allow"` | `"Deny"` | `"Defer"` | `Allow` always allows, `Deny` always denies, `Defer` defers to block-level. |
110
+
111
+ #### Returns
112
+
113
+ `void`
114
+
115
+ #### Signature
116
+
117
+ ```typescript
118
+ setGlobalScope(key: Scope, value: "Allow" | "Deny" | "Defer"): void
119
+ ```
120
+
121
+ ***
122
+ </details>
123
+
124
+ <details>
125
+ <summary>
126
+ ### getGlobalScope()
127
+
128
+ <br /><p>Get a global scope's permission level.</p>
129
+ </summary>
130
+
131
+ #### Parameters
132
+
133
+ | Parameter | Type | Description |
134
+ | ------ | ------ | ------ |
135
+ | `key` | [`Scope`](./api/node/type-aliases/scope.md) | The scope to query. |
136
+
137
+ #### Returns
138
+
139
+ `"Allow"` | `"Deny"` | `"Defer"`
140
+
141
+ `Allow`, `Deny`, or `Defer` indicating the scope's permission level.
142
+
143
+ #### Signature
144
+
145
+ ```typescript
146
+ getGlobalScope(key: Scope): "Allow" | "Deny" | "Defer"
147
+ ```
148
+ </details>
149
+
150
+ ## Event Subscriptions
151
+
152
+ Subscribe to editor state changes, history updates, and role changes.
153
+
154
+ <details>
155
+ <summary>
156
+ ### onStateChanged
157
+
158
+ <br /><p>Subscribe to editor state changes.</p>
159
+ </summary>
160
+
161
+ #### Parameters
162
+
163
+ | Parameter | Type | Description |
164
+ | ------ | ------ | ------ |
165
+ | `callback` | () => `void` | Function called when the editor state changes. |
166
+
167
+ #### Returns
168
+
169
+ A method to unsubscribe from the event.
170
+
171
+ () => `void`
172
+
173
+ ***
174
+ </details>
175
+
176
+ <details>
177
+ <summary>
178
+ ### ~~onHistoryUpdated~~
179
+
180
+ <br /><p>Subscribe to undo/redo history changes.</p>
181
+ </summary>
182
+
183
+ #### Parameters
184
+
185
+ | Parameter | Type | Description |
186
+ | ------ | ------ | ------ |
187
+ | `callback` | () => `void` | Function called when the undo/redo history changes. |
188
+
189
+ #### Returns
190
+
191
+ A method to unsubscribe from the event.
192
+
193
+ () => `void`
194
+
195
+ #### Deprecated
196
+
197
+ Use [onHistoryUpdatedWithKind](./api/node/classes/editorapi.md) instead, which additionally reports a [HistoryUpdate](./api/node/type-aliases/historyupdate.md)
198
+ describing the kind of update.
199
+
200
+ ***
201
+ </details>
202
+
203
+ <details>
204
+ <summary>
205
+ ### onHistoryUpdatedWithKind
206
+
207
+ <br /><p>Subscribe to undo/redo history changes.</p>
208
+ </summary>
209
+
210
+ The callback receives a [HistoryUpdate](./api/node/type-aliases/historyupdate.md) describing what kind of update happened so consumers can
211
+ distinguish a real change to the active history's snapshots (e.g. an edit, undo, or redo) from a pure activation
212
+ via `setActiveHistory`.
213
+
214
+ ```javascript
215
+ const unsubscribe = engine.editor.onHistoryUpdatedWithKind((kind) => {
216
+ if (kind === 'Activated') {
217
+ // The active history was switched; no scene change happened on this event.
218
+ return;
219
+ }
220
+ const canUndo = engine.editor.canUndo();
221
+ const canRedo = engine.editor.canRedo();
222
+ console.log('History updated', { canUndo, canRedo });
223
+ });
224
+ ```
225
+
226
+ #### Parameters
227
+
228
+ | Parameter | Type | Description |
229
+ | ------ | ------ | ------ |
230
+ | `callback` | (`kind`) => `void` | Function called when the undo/redo history changes. The argument describes the kind of update. |
231
+
232
+ #### Returns
233
+
234
+ A method to unsubscribe from the event.
235
+
236
+ () => `void`
237
+
238
+ ***
239
+ </details>
240
+
241
+ <details>
242
+ <summary>
243
+ ### onSettingsChanged
244
+
245
+ <br /><p>Subscribe to editor settings changes.</p>
246
+ </summary>
247
+
248
+ #### Parameters
249
+
250
+ | Parameter | Type | Description |
251
+ | ------ | ------ | ------ |
252
+ | `callback` | () => `void` | Function called when editor settings change. |
253
+
254
+ #### Returns
255
+
256
+ A method to unsubscribe from the event.
257
+
258
+ () => `void`
259
+
260
+ ***
261
+ </details>
262
+
263
+ <details>
264
+ <summary>
265
+ ### onRoleChanged
266
+
267
+ <br /><p>Subscribe to editor role changes.</p>
268
+ </summary>
269
+
270
+ Allows reacting to role changes and updating engine settings accordingly.
271
+ The callback is triggered immediately after role changes and default settings are applied.
272
+
273
+ #### Parameters
274
+
275
+ | Parameter | Type | Description |
276
+ | ------ | ------ | ------ |
277
+ | `callback` | (`role`) => `void` | Function called when the user role changes. |
278
+
279
+ #### Returns
280
+
281
+ A method to unsubscribe from the event.
282
+
283
+ () => `void`
284
+ </details>
285
+
286
+ ## Edit Mode Management
287
+
288
+ Control the editor's current editing mode and interaction state.
289
+
290
+ <details>
291
+ <summary>
292
+ ### setEditMode()
293
+
294
+ <br /><p>Set the editor's current edit mode.</p>
295
+ </summary>
296
+
297
+ Edit modes represent different tools or interaction states within the editor. Common ones, are "Crop" while the crop tool is shown or "Text" when inline-editing text.
298
+
299
+ ```javascript
300
+ engine.editor.setEditMode('Crop');
301
+ // With a base mode
302
+ engine.editor.setEditMode('CustomMode', 'Crop');
303
+ ```
304
+
305
+ #### Parameters
306
+
307
+ | Parameter | Type | Description |
308
+ | ------ | ------ | ------ |
309
+ | `mode` | [`EditMode`](./api/node/type-aliases/editmode.md) | "Transform", "Crop", "Text", "Playback", "Trim", "Vector" or a custom value. |
310
+ | `baseMode?` | `string` | Optional base mode from which the custom mode will inherit the settings. |
311
+
312
+ #### Returns
313
+
314
+ `void`
315
+
316
+ #### Signature
317
+
318
+ ```typescript
319
+ setEditMode(mode: EditMode, baseMode?: string): void
320
+ ```
321
+
322
+ ***
323
+ </details>
324
+
325
+ <details>
326
+ <summary>
327
+ ### getEditMode()
328
+
329
+ <br /><p>Get the editor's current edit mode.</p>
330
+ </summary>
331
+
332
+ Edit modes represent different tools or interaction states within the editor. Common ones, are "Crop" while the crop tool is shown or "Text" when inline-editing text.
333
+
334
+ #### Returns
335
+
336
+ [`EditMode`](./api/node/type-aliases/editmode.md)
337
+
338
+ "Transform", "Crop", "Text", "Playback", "Trim", "Vector" or a custom value.
339
+
340
+ #### Signature
341
+
342
+ ```typescript
343
+ getEditMode(): EditMode
344
+ ```
345
+
346
+ ***
347
+ </details>
348
+
349
+ <details>
350
+ <summary>
351
+ ### getCursorType()
352
+
353
+ <br /><p>Get the cursor type that should be displayed.</p>
354
+ </summary>
355
+
356
+ #### Returns
357
+
358
+ | `"Text"`
359
+ | `"Arrow"`
360
+ | `"Move"`
361
+ | `"MoveNotPermitted"`
362
+ | `"Resize"`
363
+ | `"Rotate"`
364
+ | `"Cell"`
365
+
366
+ The cursor type.
367
+
368
+ #### Signature
369
+
370
+ ```typescript
371
+ getCursorType(): "Text" | "Arrow" | "Move" | "MoveNotPermitted" | "Resize" | "Rotate" | "Cell"
372
+ ```
373
+
374
+ ***
375
+ </details>
376
+
377
+ <details>
378
+ <summary>
379
+ ### getCursorRotation()
380
+
381
+ <br /><p>Get the cursor rotation angle.</p>
382
+ </summary>
383
+
384
+ #### Returns
385
+
386
+ `number`
387
+
388
+ The angle in radians.
389
+
390
+ #### Signature
391
+
392
+ ```typescript
393
+ getCursorRotation(): number
394
+ ```
395
+
396
+ ***
397
+ </details>
398
+
399
+ <details>
400
+ <summary>
401
+ ### getTextCursorPositionInScreenSpaceX()
402
+
403
+ <br /><p>Get the text cursor's x position in screen space.</p>
404
+ </summary>
405
+
406
+ #### Returns
407
+
408
+ `number`
409
+
410
+ The text cursor's x position in screen space.
411
+
412
+ #### Signature
413
+
414
+ ```typescript
415
+ getTextCursorPositionInScreenSpaceX(): number
416
+ ```
417
+
418
+ ***
419
+ </details>
420
+
421
+ <details>
422
+ <summary>
423
+ ### getTextCursorPositionInScreenSpaceY()
424
+
425
+ <br /><p>Get the text cursor's y position in screen space.</p>
426
+ </summary>
427
+
428
+ #### Returns
429
+
430
+ `number`
431
+
432
+ The text cursor's y position in screen space.
433
+
434
+ #### Signature
435
+
436
+ ```typescript
437
+ getTextCursorPositionInScreenSpaceY(): number
438
+ ```
439
+ </details>
440
+
441
+ ## History Management
442
+
443
+ Create, manage, and operate on undo/redo history stacks.
444
+
445
+ <details>
446
+ <summary>
447
+ ### createHistory()
448
+
449
+ <br /><p>Create a new undo/redo history stack.</p>
450
+ </summary>
451
+
452
+ Multiple histories can exist, but only one can be active at a time.
453
+
454
+ ```javascript
455
+ const newHistory = engine.editor.createHistory();
456
+ ```
457
+
458
+ #### Returns
459
+
460
+ `number`
461
+
462
+ The handle of the created history.
463
+
464
+ #### Signature
465
+
466
+ ```typescript
467
+ createHistory(): number
468
+ ```
469
+
470
+ ***
471
+ </details>
472
+
473
+ <details>
474
+ <summary>
475
+ ### destroyHistory()
476
+
477
+ <br /><p>Destroy a history stack and free its resources.</p>
478
+ </summary>
479
+
480
+ ```javascript
481
+ engine.editor.destroyHistory(oldHistory);
482
+ ```
483
+
484
+ #### Parameters
485
+
486
+ | Parameter | Type | Description |
487
+ | ------ | ------ | ------ |
488
+ | `history` | `number` | The history handle to destroy. |
489
+
490
+ #### Returns
491
+
492
+ `void`
493
+
494
+ #### Throws
495
+
496
+ Error if the handle doesn't refer to a valid history.
497
+
498
+ #### Signature
499
+
500
+ ```typescript
501
+ destroyHistory(history: number): void
502
+ ```
503
+
504
+ ***
505
+ </details>
506
+
507
+ <details>
508
+ <summary>
509
+ ### setActiveHistory()
510
+
511
+ <br /><p>Set a history as the active undo/redo stack.</p>
512
+ </summary>
513
+
514
+ All other histories lose their active state. Undo/redo operations only apply to the active history.
515
+
516
+ ```javascript
517
+ engine.editor.setActiveHistory(newHistory);
518
+ ```
519
+
520
+ #### Parameters
521
+
522
+ | Parameter | Type | Description |
523
+ | ------ | ------ | ------ |
524
+ | `history` | `number` | The history handle to make active. |
525
+
526
+ #### Returns
527
+
528
+ `void`
529
+
530
+ #### Throws
531
+
532
+ Error if the handle doesn't refer to a valid history.
533
+
534
+ #### Signature
535
+
536
+ ```typescript
537
+ setActiveHistory(history: number): void
538
+ ```
539
+
540
+ ***
541
+ </details>
542
+
543
+ <details>
544
+ <summary>
545
+ ### getActiveHistory()
546
+
547
+ <br /><p>Get the currently active history handle.</p>
548
+ </summary>
549
+
550
+ Creates a new history if none exists.
551
+
552
+ ```javascript
553
+ const oldHistory = engine.editor.getActiveHistory();
554
+ ```
555
+
556
+ #### Returns
557
+
558
+ `number`
559
+
560
+ The handle of the active history.
561
+
562
+ #### Signature
563
+
564
+ ```typescript
565
+ getActiveHistory(): number
566
+ ```
567
+
568
+ ***
569
+ </details>
570
+
571
+ <details>
572
+ <summary>
573
+ ### addUndoStep()
574
+
575
+ <br /><p>Add a new history state to the undo stack.</p>
576
+ </summary>
577
+
578
+ Only adds a state if undoable changes were made since the last undo step.
579
+
580
+ ```javascript
581
+ engine.editor.addUndoStep();
582
+ ```
583
+
584
+ #### Returns
585
+
586
+ `void`
587
+
588
+ #### Signature
589
+
590
+ ```typescript
591
+ addUndoStep(): void
592
+ ```
593
+
594
+ ***
595
+ </details>
596
+
597
+ <details>
598
+ <summary>
599
+ ### removeUndoStep()
600
+
601
+ <br /><p>Remove the last history state from the undo stack.</p>
602
+ </summary>
603
+
604
+ Removes the most recent undo step if available.
605
+
606
+ ```javascript
607
+ engine.editor.removeUndoStep();
608
+ ```
609
+
610
+ #### Returns
611
+
612
+ `void`
613
+
614
+ #### Signature
615
+
616
+ ```typescript
617
+ removeUndoStep(): void
618
+ ```
619
+
620
+ ***
621
+ </details>
622
+
623
+ <details>
624
+ <summary>
625
+ ### undo()
626
+
627
+ <br /><p>Undo one step in the active history if an undo step is available.</p>
628
+ </summary>
629
+
630
+ ```javascript
631
+ engine.editor.undo();
632
+ ```
633
+
634
+ #### Returns
635
+
636
+ `void`
637
+
638
+ #### Signature
639
+
640
+ ```typescript
641
+ undo(): void
642
+ ```
643
+
644
+ ***
645
+ </details>
646
+
647
+ <details>
648
+ <summary>
649
+ ### redo()
650
+
651
+ <br /><p>Redo one step in the active history if a redo step is available.</p>
652
+ </summary>
653
+
654
+ ```javascript
655
+ engine.editor.redo();
656
+ ```
657
+
658
+ #### Returns
659
+
660
+ `void`
661
+
662
+ #### Signature
663
+
664
+ ```typescript
665
+ redo(): void
666
+ ```
667
+
668
+ ***
669
+ </details>
670
+
671
+ <details>
672
+ <summary>
673
+ ### canUndo()
674
+
675
+ <br /><p>Check if an undo step is available.</p>
676
+ </summary>
677
+
678
+ ```javascript
679
+ if (engine.editor.canUndo()) {
680
+ engine.editor.undo();
681
+ }
682
+ ```
683
+
684
+ #### Returns
685
+
686
+ `boolean`
687
+
688
+ True if an undo step is available.
689
+
690
+ #### Signature
691
+
692
+ ```typescript
693
+ canUndo(): boolean
694
+ ```
695
+
696
+ ***
697
+ </details>
698
+
699
+ <details>
700
+ <summary>
701
+ ### canRedo()
702
+
703
+ <br /><p>Check if a redo step is available.</p>
704
+ </summary>
705
+
706
+ ```javascript
707
+ if (engine.editor.canRedo()) {
708
+ engine.editor.redo();
709
+ }
710
+ ```
711
+
712
+ #### Returns
713
+
714
+ `boolean`
715
+
716
+ True if a redo step is available.
717
+
718
+ #### Signature
719
+
720
+ ```typescript
721
+ canRedo(): boolean
722
+ ```
723
+ </details>
724
+
725
+ ## Color Management
726
+
727
+ Handle spot colors, color conversion, and color space operations.
728
+
729
+ <details>
730
+ <summary>
731
+ ### findAllSpotColors()
732
+
733
+ <br /><p>Get all spot color names currently defined.</p>
734
+ </summary>
735
+
736
+ #### Returns
737
+
738
+ `string`\[]
739
+
740
+ The names of all defined spot colors.
741
+
742
+ #### Signature
743
+
744
+ ```typescript
745
+ findAllSpotColors(): string[]
746
+ ```
747
+
748
+ ***
749
+ </details>
750
+
751
+ <details>
752
+ <summary>
753
+ ### getSpotColorRGBA()
754
+
755
+ <br /><p>Queries the RGB representation set for a spot color.</p>
756
+ </summary>
757
+
758
+ If the value of the queried spot color has not been set yet, returns the default RGB representation (of magenta).
759
+ The alpha value is always 1.0.
760
+
761
+ #### Parameters
762
+
763
+ | Parameter | Type | Description |
764
+ | ------ | ------ | ------ |
765
+ | `name` | `string` | The name of a spot color. |
766
+
767
+ #### Returns
768
+
769
+ [`RGBA`](./api/node/type-aliases/rgba.md)
770
+
771
+ A result holding a float array of the four color components.
772
+
773
+ #### Signature
774
+
775
+ ```typescript
776
+ getSpotColorRGBA(name: string): RGBA
777
+ ```
778
+
779
+ ***
780
+ </details>
781
+
782
+ <details>
783
+ <summary>
784
+ ### getSpotColorCMYK()
785
+
786
+ <br /><p>Queries the CMYK representation set for a spot color.</p>
787
+ </summary>
788
+
789
+ If the value of the queried spot color has not been set yet, returns the default CMYK representation (of magenta).
790
+
791
+ #### Parameters
792
+
793
+ | Parameter | Type | Description |
794
+ | ------ | ------ | ------ |
795
+ | `name` | `string` | The name of a spot color. |
796
+
797
+ #### Returns
798
+
799
+ [`CMYK`](./api/node/type-aliases/cmyk.md)
800
+
801
+ A result holding a float array of the four color components.
802
+
803
+ #### Signature
804
+
805
+ ```typescript
806
+ getSpotColorCMYK(name: string): CMYK
807
+ ```
808
+
809
+ ***
810
+ </details>
811
+
812
+ <details>
813
+ <summary>
814
+ ### setSpotColorRGB()
815
+
816
+ <br /><p>Sets the RGB representation of a spot color.</p>
817
+ </summary>
818
+
819
+ Use this function to both create a new spot color or update an existing spot color.
820
+
821
+ #### Parameters
822
+
823
+ | Parameter | Type | Description |
824
+ | ------ | ------ | ------ |
825
+ | `name` | `string` | The name of a spot color. |
826
+ | `r` | `number` | The red color component in the range of 0 to 1. |
827
+ | `g` | `number` | The green color component in the range of 0 to 1. |
828
+ | `b` | `number` | The blue color component in the range of 0 to 1. |
829
+
830
+ #### Returns
831
+
832
+ `void`
833
+
834
+ #### Signature
835
+
836
+ ```typescript
837
+ setSpotColorRGB(name: string, r: number, g: number, b: number): void
838
+ ```
839
+
840
+ ***
841
+ </details>
842
+
843
+ <details>
844
+ <summary>
845
+ ### setSpotColorCMYK()
846
+
847
+ <br /><p>Sets the CMYK representation of a spot color.</p>
848
+ </summary>
849
+
850
+ Use this function to both create a new spot color or update an existing spot color.
851
+
852
+ #### Parameters
853
+
854
+ | Parameter | Type | Description |
855
+ | ------ | ------ | ------ |
856
+ | `name` | `string` | The name of a spot color. |
857
+ | `c` | `number` | The cyan color component in the range of 0 to 1. |
858
+ | `m` | `number` | The magenta color component in the range of 0 to 1. |
859
+ | `y` | `number` | The yellow color component in the range of 0 to 1. |
860
+ | `k` | `number` | The key color component in the range of 0 to 1. |
861
+
862
+ #### Returns
863
+
864
+ `void`
865
+
866
+ #### Signature
867
+
868
+ ```typescript
869
+ setSpotColorCMYK(name: string, c: number, m: number, y: number, k: number): void
870
+ ```
871
+
872
+ ***
873
+ </details>
874
+
875
+ <details>
876
+ <summary>
877
+ ### removeSpotColor()
878
+
879
+ <br /><p>Removes a spot color from the list of set spot colors.</p>
880
+ </summary>
881
+
882
+ #### Parameters
883
+
884
+ | Parameter | Type | Description |
885
+ | ------ | ------ | ------ |
886
+ | `name` | `string` | The name of a spot color. |
887
+
888
+ #### Returns
889
+
890
+ `void`
891
+
892
+ An empty result on success, an error otherwise.
893
+
894
+ #### Signature
895
+
896
+ ```typescript
897
+ removeSpotColor(name: string): void
898
+ ```
899
+
900
+ ***
901
+ </details>
902
+
903
+ <details>
904
+ <summary>
905
+ ### setSpotColorForCutoutType()
906
+
907
+ <br /><p>Set the spot color assign to a cutout type.</p>
908
+ </summary>
909
+
910
+ All cutout blocks of the given type will be immediately assigned that spot color.
911
+
912
+ #### Parameters
913
+
914
+ | Parameter | Type | Description |
915
+ | ------ | ------ | ------ |
916
+ | `type` | `"Dashed"` | `"Solid"` | The cutout type. |
917
+ | `color` | `string` | The spot color name to assign. |
918
+
919
+ #### Returns
920
+
921
+ `void`
922
+
923
+ #### Signature
924
+
925
+ ```typescript
926
+ setSpotColorForCutoutType(type: "Dashed" | "Solid", color: string): void
927
+ ```
928
+
929
+ ***
930
+ </details>
931
+
932
+ <details>
933
+ <summary>
934
+ ### getSpotColorForCutoutType()
935
+
936
+ <br /><p>Get the name of the spot color assigned to a cutout type.</p>
937
+ </summary>
938
+
939
+ #### Parameters
940
+
941
+ | Parameter | Type | Description |
942
+ | ------ | ------ | ------ |
943
+ | `type` | `"Dashed"` | `"Solid"` | The cutout type. |
944
+
945
+ #### Returns
946
+
947
+ `string`
948
+
949
+ The color spot name.
950
+
951
+ #### Signature
952
+
953
+ ```typescript
954
+ getSpotColorForCutoutType(type: "Dashed" | "Solid"): string
955
+ ```
956
+
957
+ ***
958
+ </details>
959
+
960
+ <details>
961
+ <summary>
962
+ ### convertColorToColorSpace()
963
+
964
+ <br /><p>Converts a color to the given color space.</p>
965
+ </summary>
966
+
967
+ ##### Parameters
968
+
969
+ | Parameter | Type | Description |
970
+ | ------ | ------ | ------ |
971
+ | `color` | [`Color`](./api/node/type-aliases/color.md) | The color to convert. |
972
+ | `colorSpace` | `"sRGB"` | The color space to convert to. |
973
+
974
+ ##### Returns
975
+
976
+ [`RGBAColor`](./api/node/interfaces/rgbacolor.md)
977
+
978
+ The converted color.
979
+
980
+ #### Call Signature
981
+
982
+ ```ts
983
+ convertColorToColorSpace(color, colorSpace): CMYKColor;
984
+ ```
985
+
986
+ ##### Parameters
987
+
988
+ | Parameter | Type |
989
+ | ------ | ------ |
990
+ | `color` | [`Color`](./api/node/type-aliases/color.md) |
991
+ | `colorSpace` | `"CMYK"` |
992
+
993
+ ##### Returns
994
+
995
+ [`CMYKColor`](./api/node/interfaces/cmykcolor.md)
996
+
997
+ #### Call Signature
998
+
999
+ ```ts
1000
+ convertColorToColorSpace(color, colorSpace): never;
1001
+ ```
1002
+
1003
+ ##### Parameters
1004
+
1005
+ | Parameter | Type |
1006
+ | ------ | ------ |
1007
+ | `color` | [`Color`](./api/node/type-aliases/color.md) |
1008
+ | `colorSpace` | [`ColorSpace`](./api/node/type-aliases/colorspace.md) |
1009
+
1010
+ ##### Returns
1011
+
1012
+ `never`
1013
+
1014
+ #### Signatures
1015
+
1016
+ ```typescript
1017
+ convertColorToColorSpace(color: Color, colorSpace: "sRGB"): RGBAColor
1018
+ ```
1019
+
1020
+ ```typescript
1021
+ convertColorToColorSpace(color: Color, colorSpace: "CMYK"): CMYKColor
1022
+ ```
1023
+
1024
+ ```typescript
1025
+ convertColorToColorSpace(color: Color, colorSpace: ColorSpace): never
1026
+ ```
1027
+ </details>
1028
+
1029
+ ## Resource Management
1030
+
1031
+ Manage buffers, URIs, and resource data handling.
1032
+
1033
+ <details>
1034
+ <summary>
1035
+ ### createBuffer()
1036
+
1037
+ <br /><p>Create a resizable buffer for arbitrary data.</p>
1038
+ </summary>
1039
+
1040
+ ```javascript
1041
+ const buffer = engine.editor.createBuffer();
1042
+
1043
+ // Reference the buffer resource from the audio block
1044
+ engine.block.setString(audioBlock, 'audio/fileURI', buffer);
1045
+ ```
1046
+
1047
+ #### Returns
1048
+
1049
+ `string`
1050
+
1051
+ A URI to identify the created buffer.
1052
+
1053
+ #### Signature
1054
+
1055
+ ```typescript
1056
+ createBuffer(): string
1057
+ ```
1058
+
1059
+ ***
1060
+ </details>
1061
+
1062
+ <details>
1063
+ <summary>
1064
+ ### destroyBuffer()
1065
+
1066
+ <br /><p>Destroy a buffer and free its resources.</p>
1067
+ </summary>
1068
+
1069
+ ```javascript
1070
+ engine.editor.destroyBuffer(buffer);
1071
+ ```
1072
+
1073
+ #### Parameters
1074
+
1075
+ | Parameter | Type | Description |
1076
+ | ------ | ------ | ------ |
1077
+ | `uri` | `string` | The URI of the buffer to destroy. |
1078
+
1079
+ #### Returns
1080
+
1081
+ `void`
1082
+
1083
+ #### Signature
1084
+
1085
+ ```typescript
1086
+ destroyBuffer(uri: string): void
1087
+ ```
1088
+
1089
+ ***
1090
+ </details>
1091
+
1092
+ <details>
1093
+ <summary>
1094
+ ### setBufferData()
1095
+
1096
+ <br /><p>Set the data of a buffer at a given offset.</p>
1097
+ </summary>
1098
+
1099
+ ```javascript
1100
+ // Generate 10 seconds of stereo 48 kHz audio data
1101
+ const samples = new Float32Array(10 * 2 * 48000);
1102
+ for (let i = 0; i < samples.length; i += 2) {
1103
+ samples[i] = samples[i + 1] = Math.sin((440 * i * Math.PI) / 48000);
1104
+ }
1105
+ // Assign the audio data to the buffer
1106
+ engine.editor.setBufferData(buffer, 0, new Uint8Array(samples.buffer));
1107
+ ```
1108
+
1109
+ #### Parameters
1110
+
1111
+ | Parameter | Type | Description |
1112
+ | ------ | ------ | ------ |
1113
+ | `uri` | `string` | The URI of the buffer to update. |
1114
+ | `offset` | `number` | The offset in bytes at which to start writing. |
1115
+ | `data` | `Uint8Array` | The data to write. |
1116
+
1117
+ #### Returns
1118
+
1119
+ `void`
1120
+
1121
+ #### Signature
1122
+
1123
+ ```typescript
1124
+ setBufferData(uri: string, offset: number, data: Uint8Array): void
1125
+ ```
1126
+
1127
+ ***
1128
+ </details>
1129
+
1130
+ <details>
1131
+ <summary>
1132
+ ### getBufferData()
1133
+
1134
+ <br /><p>Get the data of a buffer at a given offset.</p>
1135
+ </summary>
1136
+
1137
+ ```javascript
1138
+ engine.editor.findAllTransientResources().forEach((resource) => {
1139
+ const bufferURI = resource.URL;
1140
+ const length = engine.editor.getBufferLength(buffer);
1141
+ const data = engine.editor.getBufferData(buffer, 0, length);
1142
+ const blob = new Blob([data]);
1143
+ })
1144
+ ```
1145
+
1146
+ #### Parameters
1147
+
1148
+ | Parameter | Type | Description |
1149
+ | ------ | ------ | ------ |
1150
+ | `uri` | `string` | The URI of the buffer to query. |
1151
+ | `offset` | `number` | The offset in bytes at which to start reading. |
1152
+ | `length` | `number` | The number of bytes to read. |
1153
+
1154
+ #### Returns
1155
+
1156
+ `Uint8Array`
1157
+
1158
+ The data at the given offset.
1159
+
1160
+ #### Signature
1161
+
1162
+ ```typescript
1163
+ getBufferData(uri: string, offset: number, length: number): Uint8Array
1164
+ ```
1165
+
1166
+ ***
1167
+ </details>
1168
+
1169
+ <details>
1170
+ <summary>
1171
+ ### setBufferLength()
1172
+
1173
+ <br /><p>Set the length of a buffer.</p>
1174
+ </summary>
1175
+
1176
+ ```javascript
1177
+ // Reduce the buffer to half its length
1178
+ const currentLength = engine.editor.getBufferLength(buffer);
1179
+ engine.editor.setBufferLength(buffer, currentLength / 2);
1180
+ ```
1181
+
1182
+ #### Parameters
1183
+
1184
+ | Parameter | Type | Description |
1185
+ | ------ | ------ | ------ |
1186
+ | `uri` | `string` | The URI of the buffer to update. |
1187
+ | `length` | `number` | The new length of the buffer in bytes. |
1188
+
1189
+ #### Returns
1190
+
1191
+ `void`
1192
+
1193
+ #### Signature
1194
+
1195
+ ```typescript
1196
+ setBufferLength(uri: string, length: number): void
1197
+ ```
1198
+
1199
+ ***
1200
+ </details>
1201
+
1202
+ <details>
1203
+ <summary>
1204
+ ### getBufferLength()
1205
+
1206
+ <br /><p>Get the length of a buffer.</p>
1207
+ </summary>
1208
+
1209
+ ```javascript
1210
+ const length = engine.editor.getBufferLength(buffer);
1211
+ ```
1212
+
1213
+ #### Parameters
1214
+
1215
+ | Parameter | Type | Description |
1216
+ | ------ | ------ | ------ |
1217
+ | `uri` | `string` | The URI of the buffer to query. |
1218
+
1219
+ #### Returns
1220
+
1221
+ `number`
1222
+
1223
+ The length of the buffer in bytes.
1224
+
1225
+ #### Signature
1226
+
1227
+ ```typescript
1228
+ getBufferLength(uri: string): number
1229
+ ```
1230
+
1231
+ ***
1232
+ </details>
1233
+
1234
+ <details>
1235
+ <summary>
1236
+ ### getMimeType()
1237
+
1238
+ <br /><p>Get the MIME type of a resource.</p>
1239
+ </summary>
1240
+
1241
+ Downloads the resource if not already cached.
1242
+
1243
+ #### Parameters
1244
+
1245
+ | Parameter | Type | Description |
1246
+ | ------ | ------ | ------ |
1247
+ | `uri` | `string` | The URI of the resource. |
1248
+
1249
+ #### Returns
1250
+
1251
+ `Promise`\<`string`>
1252
+
1253
+ Promise resolving to the resource's MIME type.
1254
+
1255
+ #### Throws
1256
+
1257
+ Error if the resource cannot be downloaded or MIME type determined.
1258
+
1259
+ #### Signature
1260
+
1261
+ ```typescript
1262
+ getMimeType(uri: string): Promise<string>
1263
+ ```
1264
+
1265
+ ***
1266
+ </details>
1267
+
1268
+ <details>
1269
+ <summary>
1270
+ ### getFontMetrics()
1271
+
1272
+ <br /><p>Gets the font metrics for a given font file URI.</p>
1273
+ </summary>
1274
+
1275
+ If the font is not yet loaded, it will be fetched asynchronously.
1276
+ The returned metrics are in the font's design units coordinate space.
1277
+
1278
+ ```javascript
1279
+ const metrics = await engine.editor.getFontMetrics('/extensions/ly.img.cesdk.fonts/fonts/Roboto/Roboto-Regular.ttf');
1280
+ console.log(metrics.ascender, metrics.descender, metrics.unitsPerEm);
1281
+ console.log(metrics.lineGap);
1282
+ console.log(metrics.capHeight, metrics.xHeight);
1283
+ console.log(metrics.underlineOffset, metrics.underlineSize, metrics.strikeoutOffset, metrics.strikeoutSize);
1284
+ ```
1285
+
1286
+ #### Parameters
1287
+
1288
+ | Parameter | Type | Description |
1289
+ | ------ | ------ | ------ |
1290
+ | `fontFileUri` | `string` | The URI of the font file to get metrics from. |
1291
+
1292
+ #### Returns
1293
+
1294
+ `Promise`\<[`FontMetrics`](./api/node/interfaces/fontmetrics.md)>
1295
+
1296
+ A promise resolving to the font metrics.
1297
+
1298
+ #### Signature
1299
+
1300
+ ```typescript
1301
+ getFontMetrics(fontFileUri: string): Promise<FontMetrics>
1302
+ ```
1303
+
1304
+ ***
1305
+ </details>
1306
+
1307
+ <details>
1308
+ <summary>
1309
+ ### findAllTransientResources()
1310
+
1311
+ <br /><p>Get all transient resources that would be lost during export.</p>
1312
+ </summary>
1313
+
1314
+ Useful for identifying resources that need relocation (e.g., to a CDN) before export,
1315
+ as these resources are not included in the exported scene.
1316
+
1317
+ #### Returns
1318
+
1319
+ [`TransientResource`](./api/node/interfaces/transientresource.md)\[]
1320
+
1321
+ The URLs and sizes of transient resources.
1322
+
1323
+ #### Signature
1324
+
1325
+ ```typescript
1326
+ findAllTransientResources(): TransientResource[]
1327
+ ```
1328
+
1329
+ ***
1330
+ </details>
1331
+
1332
+ <details>
1333
+ <summary>
1334
+ ### findAllMediaURIs()
1335
+
1336
+ <br /><p>Get all media URIs referenced by blocks in the scene.</p>
1337
+ </summary>
1338
+
1339
+ Returns URIs from image fills, video fills, and audio blocks, including their source sets.
1340
+ Only returns valid media URIs (http://, https://, file://), excluding transient resources
1341
+ like buffer URIs. Useful for determining which media files are referenced by a scene
1342
+ (e.g., for cleanup operations, CDN management, or file system tracking).
1343
+
1344
+ #### Returns
1345
+
1346
+ `string`\[]
1347
+
1348
+ The URLs of all media resources referenced in the scene, deduplicated.
1349
+
1350
+ #### Signature
1351
+
1352
+ ```typescript
1353
+ findAllMediaURIs(): string[]
1354
+ ```
1355
+
1356
+ ***
1357
+ </details>
1358
+
1359
+ <details>
1360
+ <summary>
1361
+ ### getResourceData()
1362
+
1363
+ <br /><p>Provides the data of a resource at the given URL.</p>
1364
+ </summary>
1365
+
1366
+ #### Parameters
1367
+
1368
+ | Parameter | Type | Description |
1369
+ | ------ | ------ | ------ |
1370
+ | `uri` | `string` | The URL of the resource. |
1371
+ | `chunkSize` | `number` | The size of the chunks in which the resource data is provided. |
1372
+ | `onData` | (`result`) => `boolean` | The callback function that is called with the resource data or an error if an error occurred. The callback will be called as long as there is data left to provide and the callback returns `true`. |
1373
+
1374
+ #### Returns
1375
+
1376
+ `void`
1377
+
1378
+ #### Signature
1379
+
1380
+ ```typescript
1381
+ getResourceData(uri: string, chunkSize: number, onData: (result: Uint8Array) => boolean): void
1382
+ ```
1383
+
1384
+ ***
1385
+ </details>
1386
+
1387
+ <details>
1388
+ <summary>
1389
+ ### relocateResource()
1390
+
1391
+ <br /><p>Changes the URL associated with a resource.</p>
1392
+ </summary>
1393
+
1394
+ This function can be used change the URL of a resource that has been relocated (e.g., to a CDN).
1395
+
1396
+ #### Parameters
1397
+
1398
+ | Parameter | Type | Description |
1399
+ | ------ | ------ | ------ |
1400
+ | `currentUrl` | `string` | The current URL of the resource. |
1401
+ | `relocatedUrl` | `string` | The new URL of the resource. |
1402
+
1403
+ #### Returns
1404
+
1405
+ `void`
1406
+
1407
+ #### Signature
1408
+
1409
+ ```typescript
1410
+ relocateResource(currentUrl: string, relocatedUrl: string): void
1411
+ ```
1412
+ </details>
1413
+
1414
+ ## Editor Settings
1415
+
1416
+ Configure editor behavior through typed settings for different data types.
1417
+
1418
+ <details>
1419
+ <summary>
1420
+ ### setSetting()
1421
+
1422
+ <br /><p>Set a setting value using the unified API.
1423
+ The value type is automatically validated based on the key.</p>
1424
+ </summary>
1425
+
1426
+ #### Type Parameters
1427
+
1428
+ | Type Parameter |
1429
+ | ------ |
1430
+ | `K` *extends* keyof [`Settings`](./api/node/interfaces/settings.md) |
1431
+
1432
+ #### Parameters
1433
+
1434
+ | Parameter | Type | Description |
1435
+ | ------ | ------ | ------ |
1436
+ | `keypath` | [`OptionalPrefix`](./api/node/type-aliases/optionalprefix.md)\<`K`> | The setting key from Settings |
1437
+ | `value` | [`SettingValueType`](./api/node/type-aliases/settingvaluetype.md)\<`K`> | The value to set (type-safe based on key) |
1438
+
1439
+ #### Returns
1440
+
1441
+ `void`
1442
+
1443
+ #### Throws
1444
+
1445
+ Error if the keypath is invalid or value type doesn't match
1446
+
1447
+ #### Example
1448
+
1449
+ ```typescript
1450
+ // Boolean setting
1451
+ engine.editor.setSetting('doubleClickToCropEnabled', false);
1452
+
1453
+ // Color setting
1454
+ engine.editor.setSetting('highlightColor', { r: 1, g: 0, b: 1, a: 1 });
1455
+
1456
+ // Enum setting
1457
+ engine.editor.setSetting('doubleClickSelectionMode', 'Direct');
1458
+ ```
1459
+
1460
+ #### Signature
1461
+
1462
+ ```typescript
1463
+ setSetting(keypath: OptionalPrefix<K>, value: SettingValueType<K>): void
1464
+ ```
1465
+
1466
+ ***
1467
+ </details>
1468
+
1469
+ <details>
1470
+ <summary>
1471
+ ### getSetting()
1472
+
1473
+ <br /><p>Get a setting value using the unified API.
1474
+ The return type is automatically inferred from the key.</p>
1475
+ </summary>
1476
+
1477
+ #### Type Parameters
1478
+
1479
+ | Type Parameter |
1480
+ | ------ |
1481
+ | `K` *extends* keyof [`Settings`](./api/node/interfaces/settings.md) |
1482
+
1483
+ #### Parameters
1484
+
1485
+ | Parameter | Type | Description |
1486
+ | ------ | ------ | ------ |
1487
+ | `keypath` | [`OptionalPrefix`](./api/node/type-aliases/optionalprefix.md)\<`K`> | The setting key from Settings |
1488
+
1489
+ #### Returns
1490
+
1491
+ [`SettingValueType`](./api/node/type-aliases/settingvaluetype.md)\<`K`>
1492
+
1493
+ The value of the setting (type-safe based on key)
1494
+
1495
+ #### Throws
1496
+
1497
+ Error if the keypath is invalid
1498
+
1499
+ #### Example
1500
+
1501
+ ```typescript
1502
+ // Boolean setting
1503
+ const cropEnabled = engine.editor.getSetting('doubleClickToCropEnabled');
1504
+
1505
+ // Color setting
1506
+ const highlight = engine.editor.getSetting('highlightColor');
1507
+
1508
+ // Enum setting
1509
+ const selectionMode = engine.editor.getSetting('doubleClickSelectionMode');
1510
+ ```
1511
+
1512
+ #### Signature
1513
+
1514
+ ```typescript
1515
+ getSetting(keypath: OptionalPrefix<K>): SettingValueType<K>
1516
+ ```
1517
+
1518
+ ***
1519
+ </details>
1520
+
1521
+ <details>
1522
+ <summary>
1523
+ ### setSettingBool()
1524
+
1525
+ <br /><p>Set a boolean setting value.</p>
1526
+ </summary>
1527
+
1528
+ ##### Parameters
1529
+
1530
+ | Parameter | Type | Description |
1531
+ | ------ | ------ | ------ |
1532
+ | `keypath` | [`SettingBoolPropertyName`](./api/node/type-aliases/settingboolpropertyname.md) | The settings keypath, e.g. `doubleClickToCropEnabled`. |
1533
+ | `value` | `boolean` | The boolean value to set. |
1534
+
1535
+ ##### Returns
1536
+
1537
+ `void`
1538
+
1539
+ ##### Throws
1540
+
1541
+ Error if the keypath is invalid.
1542
+
1543
+ #### Call Signature
1544
+
1545
+ ```ts
1546
+ setSettingBool(keypath, value): void;
1547
+ ```
1548
+
1549
+ ##### Parameters
1550
+
1551
+ | Parameter | Type |
1552
+ | ------ | ------ |
1553
+ | `keypath` | `` `ubq://${string & {}}` `` |
1554
+ | `value` | `boolean` |
1555
+
1556
+ ##### Returns
1557
+
1558
+ `void`
1559
+
1560
+ ##### Deprecated
1561
+
1562
+ Support for `ubq://` prefixed keypaths will be removed in a future release.
1563
+
1564
+ #### Signatures
1565
+
1566
+ ```typescript
1567
+ setSettingBool(keypath: SettingBoolPropertyName, value: boolean): void
1568
+ ```
1569
+
1570
+ ```typescript
1571
+ setSettingBool(keypath: `ubq://${string & {}}`, value: boolean): void
1572
+ ```
1573
+
1574
+ ***
1575
+ </details>
1576
+
1577
+ <details>
1578
+ <summary>
1579
+ ### getSettingBool()
1580
+
1581
+ <br /><p>Get a boolean setting value.</p>
1582
+ </summary>
1583
+
1584
+ ##### Parameters
1585
+
1586
+ | Parameter | Type | Description |
1587
+ | ------ | ------ | ------ |
1588
+ | `keypath` | [`SettingBoolPropertyName`](./api/node/type-aliases/settingboolpropertyname.md) | The settings keypath, e.g. `doubleClickToCropEnabled`. |
1589
+
1590
+ ##### Returns
1591
+
1592
+ `boolean`
1593
+
1594
+ The boolean value of the setting.
1595
+
1596
+ ##### Throws
1597
+
1598
+ Error if the keypath is invalid.
1599
+
1600
+ #### Call Signature
1601
+
1602
+ ```ts
1603
+ getSettingBool(keypath): boolean;
1604
+ ```
1605
+
1606
+ ##### Parameters
1607
+
1608
+ | Parameter | Type |
1609
+ | ------ | ------ |
1610
+ | `keypath` | `` `ubq://${string & {}}` `` |
1611
+
1612
+ ##### Returns
1613
+
1614
+ `boolean`
1615
+
1616
+ ##### Deprecated
1617
+
1618
+ Support for `ubq://` prefixed keypaths will be removed in a future release.
1619
+
1620
+ #### Call Signature
1621
+
1622
+ ```ts
1623
+ getSettingBool(keypath): boolean;
1624
+ ```
1625
+
1626
+ Get a boolean setting value.
1627
+
1628
+ ##### Parameters
1629
+
1630
+ | Parameter | Type | Description |
1631
+ | ------ | ------ | ------ |
1632
+ | `keypath` | [`SettingBoolPropertyName`](./api/node/type-aliases/settingboolpropertyname.md) | The settings keypath, e.g. `doubleClickToCropEnabled`. |
1633
+
1634
+ ##### Returns
1635
+
1636
+ `boolean`
1637
+
1638
+ The boolean value of the setting.
1639
+
1640
+ ##### Throws
1641
+
1642
+ Error if the keypath is invalid.
1643
+
1644
+ #### Signatures
1645
+
1646
+ ```typescript
1647
+ getSettingBool(keypath: SettingBoolPropertyName): boolean
1648
+ ```
1649
+
1650
+ ```typescript
1651
+ getSettingBool(keypath: `ubq://${string & {}}`): boolean
1652
+ ```
1653
+
1654
+ ```typescript
1655
+ getSettingBool(keypath: SettingBoolPropertyName): boolean
1656
+ ```
1657
+
1658
+ ***
1659
+ </details>
1660
+
1661
+ <details>
1662
+ <summary>
1663
+ ### setSettingInt()
1664
+
1665
+ <br /><p>Set an integer setting value.</p>
1666
+ </summary>
1667
+
1668
+ ##### Parameters
1669
+
1670
+ | Parameter | Type | Description |
1671
+ | ------ | ------ | ------ |
1672
+ | `keypath` | [`SettingIntPropertyName`](./api/node/type-aliases/settingintpropertyname.md) | The settings keypath. |
1673
+ | `value` | `number` | The integer value to set. |
1674
+
1675
+ ##### Returns
1676
+
1677
+ `void`
1678
+
1679
+ ##### Throws
1680
+
1681
+ Error if the keypath is invalid.
1682
+
1683
+ #### Call Signature
1684
+
1685
+ ```ts
1686
+ setSettingInt(keypath, value): void;
1687
+ ```
1688
+
1689
+ Set an integer setting value.
1690
+
1691
+ ##### Parameters
1692
+
1693
+ | Parameter | Type | Description |
1694
+ | ------ | ------ | ------ |
1695
+ | `keypath` | [`SettingIntPropertyName`](./api/node/type-aliases/settingintpropertyname.md) | The settings keypath. |
1696
+ | `value` | `number` | The integer value to set. |
1697
+
1698
+ ##### Returns
1699
+
1700
+ `void`
1701
+
1702
+ ##### Throws
1703
+
1704
+ Error if the keypath is invalid.
1705
+
1706
+ #### Signatures
1707
+
1708
+ ```typescript
1709
+ setSettingInt(keypath: SettingIntPropertyName, value: number): void
1710
+ ```
1711
+
1712
+ ```typescript
1713
+ setSettingInt(keypath: SettingIntPropertyName, value: number): void
1714
+ ```
1715
+
1716
+ ***
1717
+ </details>
1718
+
1719
+ <details>
1720
+ <summary>
1721
+ ### getSettingInt()
1722
+
1723
+ <br /><p>Get an integer setting value.</p>
1724
+ </summary>
1725
+
1726
+ ##### Parameters
1727
+
1728
+ | Parameter | Type | Description |
1729
+ | ------ | ------ | ------ |
1730
+ | `keypath` | [`SettingIntPropertyName`](./api/node/type-aliases/settingintpropertyname.md) | The settings keypath. |
1731
+
1732
+ ##### Returns
1733
+
1734
+ `number`
1735
+
1736
+ The integer value of the setting.
1737
+
1738
+ ##### Throws
1739
+
1740
+ Error if the keypath is invalid.
1741
+
1742
+ #### Call Signature
1743
+
1744
+ ```ts
1745
+ getSettingInt(keypath): number;
1746
+ ```
1747
+
1748
+ Get an integer setting value.
1749
+
1750
+ ##### Parameters
1751
+
1752
+ | Parameter | Type | Description |
1753
+ | ------ | ------ | ------ |
1754
+ | `keypath` | [`SettingIntPropertyName`](./api/node/type-aliases/settingintpropertyname.md) | The settings keypath. |
1755
+
1756
+ ##### Returns
1757
+
1758
+ `number`
1759
+
1760
+ The integer value of the setting.
1761
+
1762
+ ##### Throws
1763
+
1764
+ Error if the keypath is invalid.
1765
+
1766
+ #### Signatures
1767
+
1768
+ ```typescript
1769
+ getSettingInt(keypath: SettingIntPropertyName): number
1770
+ ```
1771
+
1772
+ ```typescript
1773
+ getSettingInt(keypath: SettingIntPropertyName): number
1774
+ ```
1775
+
1776
+ ***
1777
+ </details>
1778
+
1779
+ <details>
1780
+ <summary>
1781
+ ### setSettingFloat()
1782
+
1783
+ <br /><p>Set a float setting value.</p>
1784
+ </summary>
1785
+
1786
+ ##### Parameters
1787
+
1788
+ | Parameter | Type | Description |
1789
+ | ------ | ------ | ------ |
1790
+ | `keypath` | [`SettingFloatPropertyName`](./api/node/type-aliases/settingfloatpropertyname.md) | The settings keypath, e.g. `positionSnappingThreshold`. |
1791
+ | `value` | `number` | The float value to set. |
1792
+
1793
+ ##### Returns
1794
+
1795
+ `void`
1796
+
1797
+ ##### Throws
1798
+
1799
+ Error if the keypath is invalid.
1800
+
1801
+ #### Call Signature
1802
+
1803
+ ```ts
1804
+ setSettingFloat(keypath, value): void;
1805
+ ```
1806
+
1807
+ ##### Parameters
1808
+
1809
+ | Parameter | Type |
1810
+ | ------ | ------ |
1811
+ | `keypath` | `` `ubq://${string & {}}` `` |
1812
+ | `value` | `number` |
1813
+
1814
+ ##### Returns
1815
+
1816
+ `void`
1817
+
1818
+ ##### Deprecated
1819
+
1820
+ Support for `ubq://` prefixed keypaths will be removed in a future release.
1821
+
1822
+ #### Call Signature
1823
+
1824
+ ```ts
1825
+ setSettingFloat(keypath, value): void;
1826
+ ```
1827
+
1828
+ Set a float setting value.
1829
+
1830
+ ##### Parameters
1831
+
1832
+ | Parameter | Type | Description |
1833
+ | ------ | ------ | ------ |
1834
+ | `keypath` | [`SettingFloatPropertyName`](./api/node/type-aliases/settingfloatpropertyname.md) | The settings keypath, e.g. `positionSnappingThreshold`. |
1835
+ | `value` | `number` | The float value to set. |
1836
+
1837
+ ##### Returns
1838
+
1839
+ `void`
1840
+
1841
+ ##### Throws
1842
+
1843
+ Error if the keypath is invalid.
1844
+
1845
+ #### Signatures
1846
+
1847
+ ```typescript
1848
+ setSettingFloat(keypath: SettingFloatPropertyName, value: number): void
1849
+ ```
1850
+
1851
+ ```typescript
1852
+ setSettingFloat(keypath: `ubq://${string & {}}`, value: number): void
1853
+ ```
1854
+
1855
+ ```typescript
1856
+ setSettingFloat(keypath: SettingFloatPropertyName, value: number): void
1857
+ ```
1858
+
1859
+ ***
1860
+ </details>
1861
+
1862
+ <details>
1863
+ <summary>
1864
+ ### getSettingFloat()
1865
+
1866
+ <br /><p>Get a float setting value.</p>
1867
+ </summary>
1868
+
1869
+ ##### Parameters
1870
+
1871
+ | Parameter | Type | Description |
1872
+ | ------ | ------ | ------ |
1873
+ | `keypath` | [`SettingFloatPropertyName`](./api/node/type-aliases/settingfloatpropertyname.md) | The settings keypath, e.g. `positionSnappingThreshold`. |
1874
+
1875
+ ##### Returns
1876
+
1877
+ `number`
1878
+
1879
+ The float value of the setting.
1880
+
1881
+ ##### Throws
1882
+
1883
+ Error if the keypath is invalid.
1884
+
1885
+ #### Call Signature
1886
+
1887
+ ```ts
1888
+ getSettingFloat(keypath): number;
1889
+ ```
1890
+
1891
+ ##### Parameters
1892
+
1893
+ | Parameter | Type |
1894
+ | ------ | ------ |
1895
+ | `keypath` | `` `ubq://${string & {}}` `` |
1896
+
1897
+ ##### Returns
1898
+
1899
+ `number`
1900
+
1901
+ ##### Deprecated
1902
+
1903
+ Support for `ubq://` prefixed keypaths will be removed in a future release.
1904
+
1905
+ #### Call Signature
1906
+
1907
+ ```ts
1908
+ getSettingFloat(keypath): number;
1909
+ ```
1910
+
1911
+ Get a float setting value.
1912
+
1913
+ ##### Parameters
1914
+
1915
+ | Parameter | Type | Description |
1916
+ | ------ | ------ | ------ |
1917
+ | `keypath` | [`SettingFloatPropertyName`](./api/node/type-aliases/settingfloatpropertyname.md) | The settings keypath, e.g. `positionSnappingThreshold`. |
1918
+
1919
+ ##### Returns
1920
+
1921
+ `number`
1922
+
1923
+ The float value of the setting.
1924
+
1925
+ ##### Throws
1926
+
1927
+ Error if the keypath is invalid.
1928
+
1929
+ #### Signatures
1930
+
1931
+ ```typescript
1932
+ getSettingFloat(keypath: SettingFloatPropertyName): number
1933
+ ```
1934
+
1935
+ ```typescript
1936
+ getSettingFloat(keypath: `ubq://${string & {}}`): number
1937
+ ```
1938
+
1939
+ ```typescript
1940
+ getSettingFloat(keypath: SettingFloatPropertyName): number
1941
+ ```
1942
+
1943
+ ***
1944
+ </details>
1945
+
1946
+ <details>
1947
+ <summary>
1948
+ ### setSettingString()
1949
+
1950
+ <br /><p>Set a string setting value.</p>
1951
+ </summary>
1952
+
1953
+ ##### Parameters
1954
+
1955
+ | Parameter | Type | Description |
1956
+ | ------ | ------ | ------ |
1957
+ | `keypath` | [`SettingStringPropertyName`](./api/node/type-aliases/settingstringpropertyname.md) | The settings keypath, e.g. `license`. |
1958
+ | `value` | `string` | The string value to set. |
1959
+
1960
+ ##### Returns
1961
+
1962
+ `void`
1963
+
1964
+ ##### Throws
1965
+
1966
+ Error if the keypath is invalid.
1967
+
1968
+ #### Call Signature
1969
+
1970
+ ```ts
1971
+ setSettingString(keypath, value): void;
1972
+ ```
1973
+
1974
+ ##### Parameters
1975
+
1976
+ | Parameter | Type |
1977
+ | ------ | ------ |
1978
+ | `keypath` | `` `ubq://${string & {}}` `` |
1979
+ | `value` | `string` |
1980
+
1981
+ ##### Returns
1982
+
1983
+ `void`
1984
+
1985
+ ##### Deprecated
1986
+
1987
+ Support for `ubq://` prefixed keypaths will be removed in a future release.
1988
+
1989
+ #### Call Signature
1990
+
1991
+ ```ts
1992
+ setSettingString(keypath, value): void;
1993
+ ```
1994
+
1995
+ Set a string setting value.
1996
+
1997
+ ##### Parameters
1998
+
1999
+ | Parameter | Type | Description |
2000
+ | ------ | ------ | ------ |
2001
+ | `keypath` | [`SettingStringPropertyName`](./api/node/type-aliases/settingstringpropertyname.md) | The settings keypath, e.g. `license`. |
2002
+ | `value` | `string` | The string value to set. |
2003
+
2004
+ ##### Returns
2005
+
2006
+ `void`
2007
+
2008
+ ##### Throws
2009
+
2010
+ Error if the keypath is invalid.
2011
+
2012
+ #### Signatures
2013
+
2014
+ ```typescript
2015
+ setSettingString(keypath: SettingStringPropertyName, value: string): void
2016
+ ```
2017
+
2018
+ ```typescript
2019
+ setSettingString(keypath: `ubq://${string & {}}`, value: string): void
2020
+ ```
2021
+
2022
+ ```typescript
2023
+ setSettingString(keypath: SettingStringPropertyName, value: string): void
2024
+ ```
2025
+
2026
+ ***
2027
+ </details>
2028
+
2029
+ <details>
2030
+ <summary>
2031
+ ### getSettingString()
2032
+
2033
+ <br /><p>Get a string setting value.</p>
2034
+ </summary>
2035
+
2036
+ ##### Parameters
2037
+
2038
+ | Parameter | Type | Description |
2039
+ | ------ | ------ | ------ |
2040
+ | `keypath` | [`SettingStringPropertyName`](./api/node/type-aliases/settingstringpropertyname.md) | The settings keypath, e.g. `license`. |
2041
+
2042
+ ##### Returns
2043
+
2044
+ `string`
2045
+
2046
+ The string value of the setting.
2047
+
2048
+ ##### Throws
2049
+
2050
+ Error if the keypath is invalid.
2051
+
2052
+ #### Call Signature
2053
+
2054
+ ```ts
2055
+ getSettingString(keypath): string;
2056
+ ```
2057
+
2058
+ ##### Parameters
2059
+
2060
+ | Parameter | Type |
2061
+ | ------ | ------ |
2062
+ | `keypath` | `` `ubq://${string & {}}` `` |
2063
+
2064
+ ##### Returns
2065
+
2066
+ `string`
2067
+
2068
+ ##### Deprecated
2069
+
2070
+ Support for `ubq://` prefixed keypaths will be removed in a future release.
2071
+
2072
+ #### Call Signature
2073
+
2074
+ ```ts
2075
+ getSettingString(keypath): string;
2076
+ ```
2077
+
2078
+ Get a string setting value.
2079
+
2080
+ ##### Parameters
2081
+
2082
+ | Parameter | Type | Description |
2083
+ | ------ | ------ | ------ |
2084
+ | `keypath` | [`SettingStringPropertyName`](./api/node/type-aliases/settingstringpropertyname.md) | The settings keypath, e.g. `license`. |
2085
+
2086
+ ##### Returns
2087
+
2088
+ `string`
2089
+
2090
+ The string value of the setting.
2091
+
2092
+ ##### Throws
2093
+
2094
+ Error if the keypath is invalid.
2095
+
2096
+ #### Signatures
2097
+
2098
+ ```typescript
2099
+ getSettingString(keypath: SettingStringPropertyName): string
2100
+ ```
2101
+
2102
+ ```typescript
2103
+ getSettingString(keypath: `ubq://${string & {}}`): string
2104
+ ```
2105
+
2106
+ ```typescript
2107
+ getSettingString(keypath: SettingStringPropertyName): string
2108
+ ```
2109
+
2110
+ ***
2111
+ </details>
2112
+
2113
+ <details>
2114
+ <summary>
2115
+ ### setSettingColor()
2116
+
2117
+ <br /><p>Set a color setting.</p>
2118
+ </summary>
2119
+
2120
+ ##### Parameters
2121
+
2122
+ | Parameter | Type | Description |
2123
+ | ------ | ------ | ------ |
2124
+ | `keypath` | [`SettingColorPropertyName`](./api/node/type-aliases/settingcolorpropertyname.md) | The settings keypath, e.g. `highlightColor`. |
2125
+ | `value` | [`Color`](./api/node/type-aliases/color.md) | The The value to set. |
2126
+
2127
+ ##### Returns
2128
+
2129
+ `void`
2130
+
2131
+ #### Call Signature
2132
+
2133
+ ```ts
2134
+ setSettingColor(keypath, value): void;
2135
+ ```
2136
+
2137
+ ##### Parameters
2138
+
2139
+ | Parameter | Type |
2140
+ | ------ | ------ |
2141
+ | `keypath` | `` `ubq://${string & {}}` `` |
2142
+ | `value` | [`Color`](./api/node/type-aliases/color.md) |
2143
+
2144
+ ##### Returns
2145
+
2146
+ `void`
2147
+
2148
+ ##### Deprecated
2149
+
2150
+ Support for `ubq://` prefixed keypaths will be removed in a future release.
2151
+
2152
+ #### Call Signature
2153
+
2154
+ ```ts
2155
+ setSettingColor(keypath, value): void;
2156
+ ```
2157
+
2158
+ Set a color setting.
2159
+
2160
+ ##### Parameters
2161
+
2162
+ | Parameter | Type | Description |
2163
+ | ------ | ------ | ------ |
2164
+ | `keypath` | [`SettingColorPropertyName`](./api/node/type-aliases/settingcolorpropertyname.md) | The settings keypath, e.g. `highlightColor`. |
2165
+ | `value` | [`Color`](./api/node/type-aliases/color.md) | The The value to set. |
2166
+
2167
+ ##### Returns
2168
+
2169
+ `void`
2170
+
2171
+ #### Signatures
2172
+
2173
+ ```typescript
2174
+ setSettingColor(keypath: SettingColorPropertyName, value: Color): void
2175
+ ```
2176
+
2177
+ ```typescript
2178
+ setSettingColor(keypath: `ubq://${string & {}}`, value: Color): void
2179
+ ```
2180
+
2181
+ ```typescript
2182
+ setSettingColor(keypath: SettingColorPropertyName, value: Color): void
2183
+ ```
2184
+
2185
+ ***
2186
+ </details>
2187
+
2188
+ <details>
2189
+ <summary>
2190
+ ### getSettingColor()
2191
+
2192
+ <br /><p>Get a color setting.</p>
2193
+ </summary>
2194
+
2195
+ ##### Parameters
2196
+
2197
+ | Parameter | Type | Description |
2198
+ | ------ | ------ | ------ |
2199
+ | `keypath` | [`SettingColorPropertyName`](./api/node/type-aliases/settingcolorpropertyname.md) | The settings keypath, e.g. `highlightColor`. |
2200
+
2201
+ ##### Returns
2202
+
2203
+ [`Color`](./api/node/type-aliases/color.md)
2204
+
2205
+ ##### Throws
2206
+
2207
+ An error, if the keypath is invalid.
2208
+
2209
+ #### Call Signature
2210
+
2211
+ ```ts
2212
+ getSettingColor(keypath): Color;
2213
+ ```
2214
+
2215
+ ##### Parameters
2216
+
2217
+ | Parameter | Type |
2218
+ | ------ | ------ |
2219
+ | `keypath` | `` `ubq://${string & {}}` `` |
2220
+
2221
+ ##### Returns
2222
+
2223
+ [`Color`](./api/node/type-aliases/color.md)
2224
+
2225
+ ##### Deprecated
2226
+
2227
+ Support for `ubq://` prefixed keypaths will be removed in a future release.
2228
+
2229
+ #### Call Signature
2230
+
2231
+ ```ts
2232
+ getSettingColor(keypath): Color;
2233
+ ```
2234
+
2235
+ Get a color setting.
2236
+
2237
+ ##### Parameters
2238
+
2239
+ | Parameter | Type | Description |
2240
+ | ------ | ------ | ------ |
2241
+ | `keypath` | [`SettingColorPropertyName`](./api/node/type-aliases/settingcolorpropertyname.md) | The settings keypath, e.g. `highlightColor`. |
2242
+
2243
+ ##### Returns
2244
+
2245
+ [`Color`](./api/node/type-aliases/color.md)
2246
+
2247
+ ##### Throws
2248
+
2249
+ An error, if the keypath is invalid.
2250
+
2251
+ #### Signatures
2252
+
2253
+ ```typescript
2254
+ getSettingColor(keypath: SettingColorPropertyName): Color
2255
+ ```
2256
+
2257
+ ```typescript
2258
+ getSettingColor(keypath: `ubq://${string & {}}`): Color
2259
+ ```
2260
+
2261
+ ```typescript
2262
+ getSettingColor(keypath: SettingColorPropertyName): Color
2263
+ ```
2264
+
2265
+ ***
2266
+ </details>
2267
+
2268
+ <details>
2269
+ <summary>
2270
+ ### setSettingEnum()
2271
+
2272
+ <br /><p>Set an enum setting.</p>
2273
+ </summary>
2274
+
2275
+ ##### Type Parameters
2276
+
2277
+ | Type Parameter |
2278
+ | ------ |
2279
+ | `T` *extends* keyof [`SettingEnumType`](./api/node/type-aliases/settingenumtype.md) |
2280
+
2281
+ ##### Parameters
2282
+
2283
+ | Parameter | Type | Description |
2284
+ | ------ | ------ | ------ |
2285
+ | `keypath` | `T` | The settings keypath, e.g. `doubleClickSelectionMode`. |
2286
+ | `value` | [`SettingEnumType`](./api/node/type-aliases/settingenumtype.md)\[`T`] | The enum value as string. |
2287
+
2288
+ ##### Returns
2289
+
2290
+ `void`
2291
+
2292
+ #### Call Signature
2293
+
2294
+ ```ts
2295
+ setSettingEnum(keypath, value): void;
2296
+ ```
2297
+
2298
+ Set an enum setting.
2299
+
2300
+ ##### Parameters
2301
+
2302
+ | Parameter | Type | Description |
2303
+ | ------ | ------ | ------ |
2304
+ | `keypath` | `string` | The settings keypath, e.g. `doubleClickSelectionMode`. |
2305
+ | `value` | `string` | The enum value as string. |
2306
+
2307
+ ##### Returns
2308
+
2309
+ `void`
2310
+
2311
+ #### Signatures
2312
+
2313
+ ```typescript
2314
+ setSettingEnum(keypath: T, value: SettingEnumType[T]): void
2315
+ ```
2316
+
2317
+ ```typescript
2318
+ setSettingEnum(keypath: string, value: string): void
2319
+ ```
2320
+
2321
+ ***
2322
+ </details>
2323
+
2324
+ <details>
2325
+ <summary>
2326
+ ### getSettingEnum()
2327
+
2328
+ <br /><p>Get an enum setting.</p>
2329
+ </summary>
2330
+
2331
+ ##### Type Parameters
2332
+
2333
+ | Type Parameter |
2334
+ | ------ |
2335
+ | `T` *extends* keyof [`SettingEnumType`](./api/node/type-aliases/settingenumtype.md) |
2336
+
2337
+ ##### Parameters
2338
+
2339
+ | Parameter | Type | Description |
2340
+ | ------ | ------ | ------ |
2341
+ | `keypath` | `T` | The settings keypath, e.g. `doubleClickSelectionMode`. |
2342
+
2343
+ ##### Returns
2344
+
2345
+ [`SettingEnumType`](./api/node/type-aliases/settingenumtype.md)\[`T`]
2346
+
2347
+ The value as string.
2348
+
2349
+ #### Call Signature
2350
+
2351
+ ```ts
2352
+ getSettingEnum(keypath): string;
2353
+ ```
2354
+
2355
+ Get an enum setting.
2356
+
2357
+ ##### Parameters
2358
+
2359
+ | Parameter | Type | Description |
2360
+ | ------ | ------ | ------ |
2361
+ | `keypath` | `string` | The settings keypath, e.g. `doubleClickSelectionMode`. |
2362
+
2363
+ ##### Returns
2364
+
2365
+ `string`
2366
+
2367
+ The value as string.
2368
+
2369
+ #### Signatures
2370
+
2371
+ ```typescript
2372
+ getSettingEnum(keypath: T): SettingEnumType[T]
2373
+ ```
2374
+
2375
+ ```typescript
2376
+ getSettingEnum(keypath: string): string
2377
+ ```
2378
+
2379
+ ***
2380
+ </details>
2381
+
2382
+ <details>
2383
+ <summary>
2384
+ ### getSettingEnumOptions()
2385
+
2386
+ <br /><p>Get the possible enum options for a given enum setting.</p>
2387
+ </summary>
2388
+
2389
+ ##### Type Parameters
2390
+
2391
+ | Type Parameter |
2392
+ | ------ |
2393
+ | `T` *extends* keyof [`SettingEnumType`](./api/node/type-aliases/settingenumtype.md) |
2394
+
2395
+ ##### Parameters
2396
+
2397
+ | Parameter | Type | Description |
2398
+ | ------ | ------ | ------ |
2399
+ | `keypath` | `T` | The settings keypath, e.g. `doubleClickSelectionMode`. |
2400
+
2401
+ ##### Returns
2402
+
2403
+ [`SettingEnumType`](./api/node/type-aliases/settingenumtype.md)\[`T`]\[]
2404
+
2405
+ The possible enum options as strings.
2406
+
2407
+ #### Call Signature
2408
+
2409
+ ```ts
2410
+ getSettingEnumOptions(keypath): string[];
2411
+ ```
2412
+
2413
+ Get the possible enum options for a given enum setting.
2414
+
2415
+ ##### Parameters
2416
+
2417
+ | Parameter | Type | Description |
2418
+ | ------ | ------ | ------ |
2419
+ | `keypath` | `string` | The settings keypath, e.g. `doubleClickSelectionMode`. |
2420
+
2421
+ ##### Returns
2422
+
2423
+ `string`\[]
2424
+
2425
+ The possible enum options as strings.
2426
+
2427
+ #### Signatures
2428
+
2429
+ ```typescript
2430
+ getSettingEnumOptions(keypath: T): SettingEnumType[T][]
2431
+ ```
2432
+
2433
+ ```typescript
2434
+ getSettingEnumOptions(keypath: string): string[]
2435
+ ```
2436
+
2437
+ ***
2438
+ </details>
2439
+
2440
+ <details>
2441
+ <summary>
2442
+ ### findAllSettings()
2443
+
2444
+ <br /><p>Returns a list of all the settings available.</p>
2445
+ </summary>
2446
+
2447
+ #### Returns
2448
+
2449
+ `string`\[]
2450
+
2451
+ A list of settings keypaths.
2452
+
2453
+ #### Signature
2454
+
2455
+ ```typescript
2456
+ findAllSettings(): string[]
2457
+ ```
2458
+
2459
+ ***
2460
+ </details>
2461
+
2462
+ <details>
2463
+ <summary>
2464
+ ### getSettingType()
2465
+
2466
+ <br /><p>Returns the type of a setting.</p>
2467
+ </summary>
2468
+
2469
+ #### Parameters
2470
+
2471
+ | Parameter | Type | Description |
2472
+ | ------ | ------ | ------ |
2473
+ | `keypath` | `string` | The settings keypath, e.g. `doubleClickSelectionMode`. |
2474
+
2475
+ #### Returns
2476
+
2477
+ [`SettingType`](./api/node/type-aliases/settingtype.md)
2478
+
2479
+ The setting type.
2480
+
2481
+ #### Signature
2482
+
2483
+ ```typescript
2484
+ getSettingType(keypath: string): SettingType
2485
+ ```
2486
+
2487
+ ***
2488
+ </details>
2489
+
2490
+ <details>
2491
+ <summary>
2492
+ ### setURIResolver()
2493
+
2494
+ <br /><p>Sets a custom URI resolver.</p>
2495
+ </summary>
2496
+
2497
+ This function can be called more than once. Subsequent calls will overwrite previous calls.
2498
+ To remove a previously set resolver, pass the value `null`.
2499
+ The given function must return an absolute path with a scheme and cannot be asynchronous. The input is allowed to be an invalid URI, e.g., due to placeholders.
2500
+
2501
+ ```javascript
2502
+ // Replace all .jpg files with the IMG.LY logo
2503
+ engine.editor.setURIResolver((uri) => {
2504
+ if (uri.endsWith('.jpg')) {
2505
+ return 'https://img.ly/static/ubq_samples/imgly_logo.jpg';
2506
+ }
2507
+ // Make use of the default URI resolution behavior.
2508
+ return engine.editor.defaultURIResolver(uri);
2509
+ });
2510
+ ```
2511
+
2512
+ #### Parameters
2513
+
2514
+ | Parameter | Type | Description |
2515
+ | ------ | ------ | ------ |
2516
+ | `resolver` | [`SyncURIResolver`](./api/node/type-aliases/syncuriresolver.md) | Custom resolution function. The resolution function should not reference variables outside of its scope. It receives the default URI resolver as its second argument |
2517
+
2518
+ #### Returns
2519
+
2520
+ `void`
2521
+
2522
+ #### Signature
2523
+
2524
+ ```typescript
2525
+ setURIResolver(resolver: SyncURIResolver): void
2526
+ ```
2527
+
2528
+ ***
2529
+ </details>
2530
+
2531
+ <details>
2532
+ <summary>
2533
+ ### setURIResolverAsync()
2534
+
2535
+ <br /><p>Sets a custom async URI resolver.</p>
2536
+ </summary>
2537
+
2538
+ This function can be called more than once. Subsequent calls will overwrite previous calls.
2539
+ To remove a previously set resolver, pass the value `null`.
2540
+ The given function must return an absolute path with a scheme. The input is allowed to be invalid URI, e.g., due
2541
+ to placeholders.
2542
+
2543
+ #### Parameters
2544
+
2545
+ | Parameter | Type | Description |
2546
+ | ------ | ------ | ------ |
2547
+ | `resolver` | [`AsyncURIResolver`](./api/node/type-aliases/asyncuriresolver.md) | Custom async resolution function. |
2548
+
2549
+ #### Returns
2550
+
2551
+ `void`
2552
+
2553
+ #### Signature
2554
+
2555
+ ```typescript
2556
+ setURIResolverAsync(resolver: AsyncURIResolver): void
2557
+ ```
2558
+
2559
+ ***
2560
+ </details>
2561
+
2562
+ <details>
2563
+ <summary>
2564
+ ### defaultURIResolver()
2565
+
2566
+ <br /><p>This is the default implementation for the URI resolver.</p>
2567
+ </summary>
2568
+
2569
+ It resolves the given path relative to the `basePath` setting.
2570
+
2571
+ ```javascript
2572
+ engine.editor.defaultURIResolver(uri);
2573
+ ```
2574
+
2575
+ #### Parameters
2576
+
2577
+ | Parameter | Type | Description |
2578
+ | ------ | ------ | ------ |
2579
+ | `relativePath` | `string` | The relative path that should be resolved. |
2580
+
2581
+ #### Returns
2582
+
2583
+ `string`
2584
+
2585
+ The resolved absolute URI.
2586
+
2587
+ #### Signature
2588
+
2589
+ ```typescript
2590
+ defaultURIResolver(relativePath: string): string
2591
+ ```
2592
+
2593
+ ***
2594
+ </details>
2595
+
2596
+ <details>
2597
+ <summary>
2598
+ ### getAbsoluteURI()
2599
+
2600
+ <br /><p>Resolves the given path asynchronously.</p>
2601
+ </summary>
2602
+
2603
+ If a custom resolver has been set with `setURIResolverAsync` (or `setURIResolver`), it invokes it with the given
2604
+ path. Else, it resolves it as relative to the `basePath` setting.
2605
+ This performs NO validation of whether a file exists at the specified location.
2606
+
2607
+ **Breaking change:** This method now returns a `Promise<string>` instead
2608
+ of a plain `string`. Callers must `await` the result.
2609
+
2610
+ #### Parameters
2611
+
2612
+ | Parameter | Type | Description |
2613
+ | ------ | ------ | ------ |
2614
+ | `relativePath` | `string` | A relative path string |
2615
+
2616
+ #### Returns
2617
+
2618
+ `Promise`\<`string`>
2619
+
2620
+ Promise resolving to the resolved absolute uri or rejecting if an invalid path was given.
2621
+
2622
+ #### Signature
2623
+
2624
+ ```typescript
2625
+ getAbsoluteURI(relativePath: string): Promise<string>
2626
+ ```
2627
+ </details>
2628
+
2629
+ ## System Information
2630
+
2631
+ Access memory usage, export limits, and system capabilities.
2632
+
2633
+ <details>
2634
+ <summary>
2635
+ ### getAvailableMemory()
2636
+
2637
+ <br /><p>Get the currently available memory.</p>
2638
+ </summary>
2639
+
2640
+ #### Returns
2641
+
2642
+ `number`
2643
+
2644
+ The available memory in bytes.
2645
+
2646
+ #### Signature
2647
+
2648
+ ```typescript
2649
+ getAvailableMemory(): number
2650
+ ```
2651
+
2652
+ ***
2653
+ </details>
2654
+
2655
+ <details>
2656
+ <summary>
2657
+ ### getUsedMemory()
2658
+
2659
+ <br /><p>Get the engine's current memory usage.</p>
2660
+ </summary>
2661
+
2662
+ #### Returns
2663
+
2664
+ `number`
2665
+
2666
+ The current memory usage in bytes.
2667
+
2668
+ #### Signature
2669
+
2670
+ ```typescript
2671
+ getUsedMemory(): number
2672
+ ```
2673
+
2674
+ ***
2675
+ </details>
2676
+
2677
+ <details>
2678
+ <summary>
2679
+ ### getMaxExportSize()
2680
+
2681
+ <br /><p>Get the maximum export size limit for the current device.</p>
2682
+ </summary>
2683
+
2684
+ Exports are only possible when both width and height are below this limit.
2685
+ Note that exports may still fail due to other constraints like memory.
2686
+
2687
+ #### Returns
2688
+
2689
+ `number`
2690
+
2691
+ The upper export size limit in pixels, or maximum 32-bit integer if unlimited.
2692
+
2693
+ #### Signature
2694
+
2695
+ ```typescript
2696
+ getMaxExportSize(): number
2697
+ ```
2698
+ </details>
2699
+
2700
+ ## Experimental
2701
+
2702
+ <details>
2703
+ <summary>
2704
+ ### unstable\_isInteractionHappening()
2705
+ </summary>
2706
+
2707
+ Check if a user interaction is currently happening.
2708
+
2709
+ Detects active interactions like resize edits with drag handles or touch gestures.
2710
+
2711
+ #### Returns
2712
+
2713
+ `boolean`
2714
+
2715
+ True if an interaction is happening.
2716
+ This API is experimental and may change or be removed in future versions.
2717
+ </details>
2718
+
2719
+ ## Other
2720
+
2721
+ <details>
2722
+ <summary>
2723
+ ### ~~setSettingColorRGBA()~~
2724
+
2725
+ <br /><p>Set a color setting.</p>
2726
+ </summary>
2727
+
2728
+ #### Parameters
2729
+
2730
+ | Parameter | Type | Description |
2731
+ | ------ | ------ | ------ |
2732
+ | `keypath` | | `` `ubq://${string & {}}` `` | [`SettingColorPropertyName`](./api/node/type-aliases/settingcolorpropertyname.md) | The settings keypath, e.g. `highlightColor`. |
2733
+ | `r` | `number` | The red color component in the range of 0 to 1. |
2734
+ | `g` | `number` | The green color component in the range of 0 to 1. |
2735
+ | `b` | `number` | The blue color component in the range of 0 to 1. |
2736
+ | `a?` | `number` | The alpha color component in the range of 0 to 1. |
2737
+
2738
+ #### Returns
2739
+
2740
+ `void`
2741
+
2742
+ #### Deprecated
2743
+
2744
+ Use setSettingColor() instead.
2745
+
2746
+ ***
2747
+ </details>
2748
+
2749
+ <details>
2750
+ <summary>
2751
+ ### ~~getSettingColorRGBA()~~
2752
+
2753
+ <br /><p>Get a color setting.</p>
2754
+ </summary>
2755
+
2756
+ #### Parameters
2757
+
2758
+ | Parameter | Type | Description |
2759
+ | ------ | ------ | ------ |
2760
+ | `keypath` | | `` `ubq://${string & {}}` `` | [`SettingColorPropertyName`](./api/node/type-aliases/settingcolorpropertyname.md) | The settings keypath, e.g. `highlightColor`. |
2761
+
2762
+ #### Returns
2763
+
2764
+ [`RGBA`](./api/node/type-aliases/rgba.md)
2765
+
2766
+ A tuple of channels red, green, blue and alpha in the range of 0 to 1.
2767
+
2768
+ #### Deprecated
2769
+
2770
+ Use getSettingColor() instead.
2771
+
2772
+ ***
2773
+ </details>
2774
+
2775
+ <details>
2776
+ <summary>
2777
+ ### isHighlightingEnabled()
2778
+
2779
+ <br /><p>Checks wether the block has selection and hover highlighting enabled or disabled.</p>
2780
+ </summary>
2781
+
2782
+ ```javascript
2783
+ const highlightingIsEnabled = engine.editor.isHighlightingEnabled(block);
2784
+ ```
2785
+
2786
+ #### Parameters
2787
+
2788
+ | Parameter | Type | Description |
2789
+ | ------ | ------ | ------ |
2790
+ | `id` | `number` | The block to query. |
2791
+
2792
+ #### Returns
2793
+
2794
+ `boolean`
2795
+
2796
+ True if highlighting is enabled, false otherwise.
2797
+
2798
+ #### Signature
2799
+
2800
+ ```typescript
2801
+ isHighlightingEnabled(id: number): boolean
2802
+ ```
2803
+
2804
+ ***
2805
+ </details>
2806
+
2807
+ <details>
2808
+ <summary>
2809
+ ### setHighlightingEnabled()
2810
+
2811
+ <br /><p>Enable or disable selection and hover highlighting for a block.</p>
2812
+ </summary>
2813
+
2814
+ ```javascript
2815
+ engine.editor.setHighlightingEnabled(block, true);
2816
+ ```
2817
+
2818
+ #### Parameters
2819
+
2820
+ | Parameter | Type | Description |
2821
+ | ------ | ------ | ------ |
2822
+ | `id` | `number` | The block to update. |
2823
+ | `enabled` | `boolean` | Whether or not the block should show highlighting when selected or hovered. |
2824
+
2825
+ #### Returns
2826
+
2827
+ `void`
2828
+
2829
+ #### Signature
2830
+
2831
+ ```typescript
2832
+ setHighlightingEnabled(id: number, enabled: boolean): void
2833
+ ```
2834
+
2835
+ ***
2836
+ </details>
2837
+
2838
+ <details>
2839
+ <summary>
2840
+ ### isSelectionEnabled()
2841
+
2842
+ <br /><p>Checks whether the block can currently be selected.</p>
2843
+ </summary>
2844
+
2845
+ ```javascript
2846
+ const selectionIsEnabled = engine.editor.isSelectionEnabled(block);
2847
+ ```
2848
+
2849
+ #### Parameters
2850
+
2851
+ | Parameter | Type | Description |
2852
+ | ------ | ------ | ------ |
2853
+ | `id` | `number` | The block to query. |
2854
+
2855
+ #### Returns
2856
+
2857
+ `boolean`
2858
+
2859
+ True if selection is enabled, false otherwise.
2860
+
2861
+ #### Signature
2862
+
2863
+ ```typescript
2864
+ isSelectionEnabled(id: number): boolean
2865
+ ```
2866
+
2867
+ ***
2868
+ </details>
2869
+
2870
+ <details>
2871
+ <summary>
2872
+ ### setSelectionEnabled()
2873
+
2874
+ <br /><p>Enable or disable selection for a block.</p>
2875
+ </summary>
2876
+
2877
+ ```javascript
2878
+ engine.editor.setSelectionEnabled(block, true);
2879
+ ```
2880
+
2881
+ #### Parameters
2882
+
2883
+ | Parameter | Type | Description |
2884
+ | ------ | ------ | ------ |
2885
+ | `id` | `number` | The block to update. |
2886
+ | `enabled` | `boolean` | Whether the block should be selectable. |
2887
+
2888
+ #### Returns
2889
+
2890
+ `void`
2891
+
2892
+ #### Signature
2893
+
2894
+ ```typescript
2895
+ setSelectionEnabled(id: number, enabled: boolean): void
2896
+ ```
2897
+
2898
+ ***
2899
+ </details>
2900
+
2901
+ <details>
2902
+ <summary>
2903
+ ### setMovementConstraint()
2904
+
2905
+ <br /><p>Set one or more rules that limit how far blocks can be positioned outside their
2906
+ parent page during user interactions (drag, resize, touch gestures, crop).
2907
+ Programmatic API calls are not affected.</p>
2908
+ </summary>
2909
+
2910
+ `overshoot` is a non-negative fraction of the moved block's own size: `0`
2911
+ pins blocks fully inside the page, `0.3` allows 30% to extend past the page
2912
+ bounds. Each rule's scope is determined by its keys:
2913
+
2914
+ - `{ overshoot }` — scene-wide default for every page in the scene.
2915
+ - `{ overshoot, block }` — applies to a specific block. Pages are blocks, so
2916
+ setting this on a page acts as the default for blocks inside that page.
2917
+ - `{ overshoot, blockType }` — applies to every block of the given type
2918
+ (e.g. `"text"` or `"//ly.img.ubq/text"`).
2919
+
2920
+ Use `removeMovementConstraint` to clear a rule.
2921
+
2922
+ When multiple rules match a block, the most specific one wins:
2923
+ block \\> parent page \\> blockType \\> scene-wide.
2924
+
2925
+ #### Parameters
2926
+
2927
+ | Parameter | Type | Description |
2928
+ | ------ | ------ | ------ |
2929
+ | `rules` | `MovementConstraintRule` | `MovementConstraintRule`\[] | A single rule or an array of rules to apply. |
2930
+
2931
+ #### Returns
2932
+
2933
+ `void`
2934
+
2935
+ #### Signature
2936
+
2937
+ ```typescript
2938
+ setMovementConstraint(rules: MovementConstraintRule | MovementConstraintRule[]): void
2939
+ ```
2940
+
2941
+ ***
2942
+ </details>
2943
+
2944
+ <details>
2945
+ <summary>
2946
+ ### getMovementConstraint()
2947
+
2948
+ <br /><p>Get the effective movement constraint for a block, picking the most specific
2949
+ matching rule: block > parent page > blockType > scene-wide.</p>
2950
+ </summary>
2951
+
2952
+ The returned `overshoot` is a fraction of the block's own size.
2953
+
2954
+ #### Parameters
2955
+
2956
+ | Parameter | Type | Description |
2957
+ | ------ | ------ | ------ |
2958
+ | `id` | `number` | The block to query. |
2959
+
2960
+ #### Returns
2961
+
2962
+ `object`
2963
+
2964
+ `{ overshoot }` with the effective value, or `null` if unconstrained.
2965
+
2966
+ | Name | Type |
2967
+ | ------ | ------ |
2968
+ | `overshoot` | `number` |
2969
+
2970
+ #### Signature
2971
+
2972
+ ```typescript
2973
+ getMovementConstraint(id: number): object
2974
+ ```
2975
+
2976
+ ***
2977
+ </details>
2978
+
2979
+ <details>
2980
+ <summary>
2981
+ ### removeMovementConstraint()
2982
+
2983
+ <br /><p>Remove previously set movement constraints.</p>
2984
+ </summary>
2985
+
2986
+ - No argument: removes the scene-wide default.
2987
+ - `{ block }` / `{ blockType }` (or an array): removes the matching scope(s).
2988
+
2989
+ Removing a scope falls through to the next tier on subsequent resolution.
2990
+
2991
+ #### Parameters
2992
+
2993
+ | Parameter | Type | Description |
2994
+ | ------ | ------ | ------ |
2995
+ | `scopes?` | `MovementConstraintScope` | `MovementConstraintScope`\[] | Scope or array of scopes to remove. Omit to remove the scene-wide default. |
2996
+
2997
+ #### Returns
2998
+
2999
+ `void`
3000
+
3001
+ #### Signature
3002
+
3003
+ ```typescript
3004
+ removeMovementConstraint(scopes?: MovementConstraintScope | MovementConstraintScope[]): void
3005
+ ```
3006
+ </details>
3007
+
3008
+ ## Vector Edit
3009
+
3010
+ <details>
3011
+ <summary>
3012
+ ### hasSelectedVectorNode()
3013
+
3014
+ <br /><p>Check whether a vector anchor node is currently selected in vector edit mode.</p>
3015
+ </summary>
3016
+
3017
+ #### Returns
3018
+
3019
+ `boolean`
3020
+
3021
+ True if a vector anchor node is selected.
3022
+
3023
+ #### Signature
3024
+
3025
+ ```typescript
3026
+ hasSelectedVectorNode(): boolean
3027
+ ```
3028
+
3029
+ ***
3030
+ </details>
3031
+
3032
+ <details>
3033
+ <summary>
3034
+ ### addVectorNode()
3035
+
3036
+ <br /><p>Add a new vertex by splitting the segment after the currently selected vector node.</p>
3037
+ </summary>
3038
+
3039
+ #### Returns
3040
+
3041
+ `void`
3042
+
3043
+ #### Signature
3044
+
3045
+ ```typescript
3046
+ addVectorNode(): void
3047
+ ```
3048
+
3049
+ ***
3050
+ </details>
3051
+
3052
+ <details>
3053
+ <summary>
3054
+ ### deleteVectorNode()
3055
+
3056
+ <br /><p>Delete the currently selected vector node from the path.</p>
3057
+ </summary>
3058
+
3059
+ #### Returns
3060
+
3061
+ `void`
3062
+
3063
+ #### Signature
3064
+
3065
+ ```typescript
3066
+ deleteVectorNode(): void
3067
+ ```
3068
+
3069
+ ***
3070
+ </details>
3071
+
3072
+ <details>
3073
+ <summary>
3074
+ ### hasSelectedVectorControlPoint()
3075
+
3076
+ <br /><p>Check whether a vector control point handle is currently selected.</p>
3077
+ </summary>
3078
+
3079
+ #### Returns
3080
+
3081
+ `boolean`
3082
+
3083
+ #### Signature
3084
+
3085
+ ```typescript
3086
+ hasSelectedVectorControlPoint(): boolean
3087
+ ```
3088
+
3089
+ ***
3090
+ </details>
3091
+
3092
+ <details>
3093
+ <summary>
3094
+ ### deleteSelectedVectorControlPoints()
3095
+
3096
+ <br /><p>Delete (reset) the currently selected vector control point handles.
3097
+ Removes the bezier handle from the node, converting that side to a straight line.
3098
+ If the node has two handles, only the selected one is removed.</p>
3099
+ </summary>
3100
+
3101
+ #### Returns
3102
+
3103
+ `void`
3104
+
3105
+ #### Signature
3106
+
3107
+ ```typescript
3108
+ deleteSelectedVectorControlPoints(): void
3109
+ ```
3110
+
3111
+ ***
3112
+ </details>
3113
+
3114
+ <details>
3115
+ <summary>
3116
+ ### toggleSelectedVectorNodeSmooth()
3117
+
3118
+ <br /><p>Toggle the currently selected vector node between smooth (bezier handles)
3119
+ and corner (no handles).</p>
3120
+ </summary>
3121
+
3122
+ #### Returns
3123
+
3124
+ `void`
3125
+
3126
+ #### Signature
3127
+
3128
+ ```typescript
3129
+ toggleSelectedVectorNodeSmooth(): void
3130
+ ```
3131
+
3132
+ ***
3133
+ </details>
3134
+
3135
+ <details>
3136
+ <summary>
3137
+ ### setVectorEditBendMode()
3138
+
3139
+ <br /><p>Enable or disable bend mode for vector editing.</p>
3140
+ </summary>
3141
+
3142
+ When bend mode is active, clicking an anchor node automatically toggles
3143
+ it between smooth (bezier handles) and corner (no handles).
3144
+
3145
+ #### Parameters
3146
+
3147
+ | Parameter | Type | Description |
3148
+ | ------ | ------ | ------ |
3149
+ | `active` | `boolean` | true to enable bend mode, false to return to normal move mode. |
3150
+
3151
+ #### Returns
3152
+
3153
+ `void`
3154
+
3155
+ #### Signature
3156
+
3157
+ ```typescript
3158
+ setVectorEditBendMode(active: boolean): void
3159
+ ```
3160
+
3161
+ ***
3162
+ </details>
3163
+
3164
+ <details>
3165
+ <summary>
3166
+ ### getVectorEditBendMode()
3167
+
3168
+ <br /><p>Check whether vector edit bend mode is currently active.</p>
3169
+ </summary>
3170
+
3171
+ #### Returns
3172
+
3173
+ `boolean`
3174
+
3175
+ true if bend mode is active.
3176
+
3177
+ #### Signature
3178
+
3179
+ ```typescript
3180
+ getVectorEditBendMode(): boolean
3181
+ ```
3182
+
3183
+ ***
3184
+ </details>
3185
+
3186
+ <details>
3187
+ <summary>
3188
+ ### setVectorEditAddMode()
3189
+
3190
+ <br /><p>Enable or disable add mode for vector editing.</p>
3191
+ </summary>
3192
+
3193
+ When add mode is active, clicking on a path segment inserts a new anchor
3194
+ point at the click position. Mutually exclusive with bend and delete modes.
3195
+
3196
+ #### Parameters
3197
+
3198
+ | Parameter | Type | Description |
3199
+ | ------ | ------ | ------ |
3200
+ | `active` | `boolean` | true to enable add mode, false to return to normal move mode. |
3201
+
3202
+ #### Returns
3203
+
3204
+ `void`
3205
+
3206
+ #### Signature
3207
+
3208
+ ```typescript
3209
+ setVectorEditAddMode(active: boolean): void
3210
+ ```
3211
+
3212
+ ***
3213
+ </details>
3214
+
3215
+ <details>
3216
+ <summary>
3217
+ ### getVectorEditAddMode()
3218
+
3219
+ <br /><p>Check whether vector edit add mode is currently active.</p>
3220
+ </summary>
3221
+
3222
+ #### Returns
3223
+
3224
+ `boolean`
3225
+
3226
+ true if add mode is active.
3227
+
3228
+ #### Signature
3229
+
3230
+ ```typescript
3231
+ getVectorEditAddMode(): boolean
3232
+ ```
3233
+
3234
+ ***
3235
+ </details>
3236
+
3237
+ <details>
3238
+ <summary>
3239
+ ### setVectorEditDeleteMode()
3240
+
3241
+ <br /><p>Enable or disable delete mode for vector editing.</p>
3242
+ </summary>
3243
+
3244
+ When delete mode is active, clicking an anchor node instantly deletes it
3245
+ from the path. Mutually exclusive with bend and add modes.
3246
+
3247
+ #### Parameters
3248
+
3249
+ | Parameter | Type | Description |
3250
+ | ------ | ------ | ------ |
3251
+ | `active` | `boolean` | true to enable delete mode, false to return to normal move mode. |
3252
+
3253
+ #### Returns
3254
+
3255
+ `void`
3256
+
3257
+ #### Signature
3258
+
3259
+ ```typescript
3260
+ setVectorEditDeleteMode(active: boolean): void
3261
+ ```
3262
+
3263
+ ***
3264
+ </details>
3265
+
3266
+ <details>
3267
+ <summary>
3268
+ ### getVectorEditDeleteMode()
3269
+
3270
+ <br /><p>Check whether vector edit delete mode is currently active.</p>
3271
+ </summary>
3272
+
3273
+ #### Returns
3274
+
3275
+ `boolean`
3276
+
3277
+ true if delete mode is active.
3278
+
3279
+ #### Signature
3280
+
3281
+ ```typescript
3282
+ getVectorEditDeleteMode(): boolean
3283
+ ```
3284
+
3285
+ ***
3286
+ </details>
3287
+
3288
+ <details>
3289
+ <summary>
3290
+ ### setSelectedVectorNodeMirrorMode()
3291
+
3292
+ <br /><p>Set the bezier handle mirror mode for the currently selected vector node.</p>
3293
+ </summary>
3294
+
3295
+ Mirror modes control how the opposite handle behaves when one handle is dragged:
3296
+
3297
+ - 0 (None): handles move independently
3298
+ - 1 (AngleAndLength): the opposite handle mirrors both angle and length
3299
+ - 2 (AngleOnly): the opposite handle mirrors the angle but keeps its own length
3300
+
3301
+ #### Parameters
3302
+
3303
+ | Parameter | Type | Description |
3304
+ | ------ | ------ | ------ |
3305
+ | `mode` | `number` | The mirror mode (0, 1, or 2). |
3306
+
3307
+ #### Returns
3308
+
3309
+ `void`
3310
+
3311
+ #### Signature
3312
+
3313
+ ```typescript
3314
+ setSelectedVectorNodeMirrorMode(mode: number): void
3315
+ ```
3316
+
3317
+ ***
3318
+ </details>
3319
+
3320
+ <details>
3321
+ <summary>
3322
+ ### getSelectedVectorNodeMirrorMode()
3323
+
3324
+ <br /><p>Get the bezier handle mirror mode of the currently selected vector node.</p>
3325
+ </summary>
3326
+
3327
+ #### Returns
3328
+
3329
+ `number`
3330
+
3331
+ The mirror mode as a number (0 = None, 1 = AngleAndLength, 2 = AngleOnly).
3332
+
3333
+ #### Throws
3334
+
3335
+ Error if no node is selected or no vector path is being edited.
3336
+
3337
+ #### Signature
3338
+
3339
+ ```typescript
3340
+ getSelectedVectorNodeMirrorMode(): number
3341
+ ```
3342
+ </details>
3343
+
3344
+ ## Viewport
3345
+
3346
+ <details>
3347
+ <summary>
3348
+ ### setSafeAreaInsets()
3349
+
3350
+ <br /><p>Set global safe area insets for UI overlays.</p>
3351
+ </summary>
3352
+
3353
+ Safe area insets define UI-safe regions by specifying padding from screen edges.
3354
+ These insets are automatically applied to all camera operations (zoom, pan, clamping)
3355
+ to ensure important content remains visible when UI elements overlap the viewport edges.
3356
+ Set to zero to disable (default state).
3357
+
3358
+ #### Parameters
3359
+
3360
+ | Parameter | Type | Description |
3361
+ | ------ | ------ | ------ |
3362
+ | `insets` | \{ `left?`: `number`; `top?`: `number`; `right?`: `number`; `bottom?`: `number`; } | The inset values in CSS pixels (device-independent) |
3363
+ | `insets.left?` | `number` | - |
3364
+ | `insets.top?` | `number` | - |
3365
+ | `insets.right?` | `number` | - |
3366
+ | `insets.bottom?` | `number` | - |
3367
+
3368
+ #### Returns
3369
+
3370
+ `void`
3371
+
3372
+ #### Signature
3373
+
3374
+ ```typescript
3375
+ setSafeAreaInsets(insets: object): void
3376
+ ```
3377
+
3378
+ ***
3379
+ </details>
3380
+
3381
+ <details>
3382
+ <summary>
3383
+ ### getSafeAreaInsets()
3384
+
3385
+ <br /><p>Get the current global safe area insets configuration.</p>
3386
+ </summary>
3387
+
3388
+ #### Returns
3389
+
3390
+ `object`
3391
+
3392
+ The current inset values in CSS pixels (device-independent)
3393
+
3394
+ | Name | Type |
3395
+ | ------ | ------ |
3396
+ | `left` | `number` |
3397
+ | `top` | `number` |
3398
+ | `right` | `number` |
3399
+ | `bottom` | `number` |
3400
+
3401
+ #### Signature
3402
+
3403
+ ```typescript
3404
+ getSafeAreaInsets(): object
3405
+ ```
3406
+ </details>
3407
+
3408
+
3409
+ ---
3410
+
3411
+ ## More Resources
3412
+
3413
+ - **[Node.js Documentation Index](https://img.ly/docs/cesdk/node.md)** - Browse all Node.js documentation
3414
+ - **[node API Reference](./api/node.md)** - Full node API reference
3415
+ - **[Complete Documentation](./llms-full.txt.md)** - Full documentation in one file (for LLMs)
3416
+ - **[Web Documentation](./node.md)** - Interactive documentation with examples
3417
+ - **[Support](mailto:support@img.ly)** - Contact IMG.LY support