banner.pyi 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585
  1. """Stub file for reflex/components/core/banner.py"""
  2. # ------------------- DO NOT EDIT ----------------------
  3. # This file was generated by `reflex/utils/pyi_generator.py`!
  4. # ------------------------------------------------------
  5. from typing import Any, Dict, Literal, Optional, Union, overload
  6. from reflex.vars import Var, BaseVar, ComputedVar
  7. from reflex.event import EventChain, EventHandler, EventSpec
  8. from reflex.style import Style
  9. from typing import Optional
  10. from reflex.components.base.bare import Bare
  11. from reflex.components.component import Component
  12. from reflex.components.core.cond import cond
  13. from reflex.components.el.elements.typography import Div
  14. from reflex.components.lucide.icon import Icon
  15. from reflex.components.radix.themes.components.dialog import (
  16. DialogContent,
  17. DialogRoot,
  18. DialogTitle,
  19. )
  20. from reflex.components.radix.themes.layout.flex import Flex
  21. from reflex.components.radix.themes.typography.text import Text
  22. from reflex.components.sonner.toast import Toaster, ToastProps
  23. from reflex.constants import Dirs, Hooks, Imports
  24. from reflex.constants.compiler import CompileVars
  25. from reflex.utils.imports import ImportDict, ImportVar
  26. from reflex.utils.serializers import serialize
  27. from reflex.vars import Var, VarData
  28. connect_error_var_data: VarData
  29. connect_errors: Var
  30. connection_error: Var
  31. connection_errors_count: Var
  32. has_connection_errors: Var
  33. has_too_many_connection_errors: Var
  34. class WebsocketTargetURL(Bare):
  35. def add_imports(self) -> ImportDict: ...
  36. @overload
  37. @classmethod
  38. def create( # type: ignore
  39. cls,
  40. *children,
  41. contents: Optional[Union[Var[str], str]] = None,
  42. style: Optional[Style] = None,
  43. key: Optional[Any] = None,
  44. id: Optional[Any] = None,
  45. class_name: Optional[Any] = None,
  46. autofocus: Optional[bool] = None,
  47. custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
  48. on_blur: Optional[
  49. Union[EventHandler, EventSpec, list, function, BaseVar]
  50. ] = None,
  51. on_click: Optional[
  52. Union[EventHandler, EventSpec, list, function, BaseVar]
  53. ] = None,
  54. on_context_menu: Optional[
  55. Union[EventHandler, EventSpec, list, function, BaseVar]
  56. ] = None,
  57. on_double_click: Optional[
  58. Union[EventHandler, EventSpec, list, function, BaseVar]
  59. ] = None,
  60. on_focus: Optional[
  61. Union[EventHandler, EventSpec, list, function, BaseVar]
  62. ] = None,
  63. on_mount: Optional[
  64. Union[EventHandler, EventSpec, list, function, BaseVar]
  65. ] = None,
  66. on_mouse_down: Optional[
  67. Union[EventHandler, EventSpec, list, function, BaseVar]
  68. ] = None,
  69. on_mouse_enter: Optional[
  70. Union[EventHandler, EventSpec, list, function, BaseVar]
  71. ] = None,
  72. on_mouse_leave: Optional[
  73. Union[EventHandler, EventSpec, list, function, BaseVar]
  74. ] = None,
  75. on_mouse_move: Optional[
  76. Union[EventHandler, EventSpec, list, function, BaseVar]
  77. ] = None,
  78. on_mouse_out: Optional[
  79. Union[EventHandler, EventSpec, list, function, BaseVar]
  80. ] = None,
  81. on_mouse_over: Optional[
  82. Union[EventHandler, EventSpec, list, function, BaseVar]
  83. ] = None,
  84. on_mouse_up: Optional[
  85. Union[EventHandler, EventSpec, list, function, BaseVar]
  86. ] = None,
  87. on_scroll: Optional[
  88. Union[EventHandler, EventSpec, list, function, BaseVar]
  89. ] = None,
  90. on_unmount: Optional[
  91. Union[EventHandler, EventSpec, list, function, BaseVar]
  92. ] = None,
  93. **props
  94. ) -> "WebsocketTargetURL":
  95. """Create a websocket target URL component.
  96. Returns:
  97. The websocket target URL component.
  98. """
  99. ...
  100. def default_connection_error() -> list[str | Var | Component]: ...
  101. class ConnectionToaster(Toaster):
  102. def add_hooks(self) -> list[str | Var]: ...
  103. @overload
  104. @classmethod
  105. def create( # type: ignore
  106. cls,
  107. *children,
  108. theme: Optional[Union[Var[str], str]] = None,
  109. rich_colors: Optional[Union[Var[bool], bool]] = None,
  110. expand: Optional[Union[Var[bool], bool]] = None,
  111. visible_toasts: Optional[Union[Var[int], int]] = None,
  112. position: Optional[
  113. Union[
  114. Var[
  115. Literal[
  116. "top-left",
  117. "top-center",
  118. "top-right",
  119. "bottom-left",
  120. "bottom-center",
  121. "bottom-right",
  122. ]
  123. ],
  124. Literal[
  125. "top-left",
  126. "top-center",
  127. "top-right",
  128. "bottom-left",
  129. "bottom-center",
  130. "bottom-right",
  131. ],
  132. ]
  133. ] = None,
  134. close_button: Optional[Union[Var[bool], bool]] = None,
  135. offset: Optional[Union[Var[str], str]] = None,
  136. dir: Optional[Union[Var[str], str]] = None,
  137. hotkey: Optional[Union[Var[str], str]] = None,
  138. invert: Optional[Union[Var[bool], bool]] = None,
  139. toast_options: Optional[Union[Var[ToastProps], ToastProps]] = None,
  140. gap: Optional[Union[Var[int], int]] = None,
  141. loading_icon: Optional[Union[Var[Icon], Icon]] = None,
  142. pause_when_page_is_hidden: Optional[Union[Var[bool], bool]] = None,
  143. style: Optional[Style] = None,
  144. key: Optional[Any] = None,
  145. id: Optional[Any] = None,
  146. class_name: Optional[Any] = None,
  147. autofocus: Optional[bool] = None,
  148. custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
  149. on_blur: Optional[
  150. Union[EventHandler, EventSpec, list, function, BaseVar]
  151. ] = None,
  152. on_click: Optional[
  153. Union[EventHandler, EventSpec, list, function, BaseVar]
  154. ] = None,
  155. on_context_menu: Optional[
  156. Union[EventHandler, EventSpec, list, function, BaseVar]
  157. ] = None,
  158. on_double_click: Optional[
  159. Union[EventHandler, EventSpec, list, function, BaseVar]
  160. ] = None,
  161. on_focus: Optional[
  162. Union[EventHandler, EventSpec, list, function, BaseVar]
  163. ] = None,
  164. on_mount: Optional[
  165. Union[EventHandler, EventSpec, list, function, BaseVar]
  166. ] = None,
  167. on_mouse_down: Optional[
  168. Union[EventHandler, EventSpec, list, function, BaseVar]
  169. ] = None,
  170. on_mouse_enter: Optional[
  171. Union[EventHandler, EventSpec, list, function, BaseVar]
  172. ] = None,
  173. on_mouse_leave: Optional[
  174. Union[EventHandler, EventSpec, list, function, BaseVar]
  175. ] = None,
  176. on_mouse_move: Optional[
  177. Union[EventHandler, EventSpec, list, function, BaseVar]
  178. ] = None,
  179. on_mouse_out: Optional[
  180. Union[EventHandler, EventSpec, list, function, BaseVar]
  181. ] = None,
  182. on_mouse_over: Optional[
  183. Union[EventHandler, EventSpec, list, function, BaseVar]
  184. ] = None,
  185. on_mouse_up: Optional[
  186. Union[EventHandler, EventSpec, list, function, BaseVar]
  187. ] = None,
  188. on_scroll: Optional[
  189. Union[EventHandler, EventSpec, list, function, BaseVar]
  190. ] = None,
  191. on_unmount: Optional[
  192. Union[EventHandler, EventSpec, list, function, BaseVar]
  193. ] = None,
  194. **props
  195. ) -> "ConnectionToaster":
  196. """Create the component.
  197. Args:
  198. *children: The children of the component.
  199. theme: the theme of the toast
  200. rich_colors: whether to show rich colors
  201. expand: whether to expand the toast
  202. visible_toasts: the number of toasts that are currently visible
  203. position: the position of the toast
  204. close_button: whether to show the close button
  205. offset: offset of the toast
  206. dir: directionality of the toast (default: ltr)
  207. hotkey: Keyboard shortcut that will move focus to the toaster area.
  208. invert: Dark toasts in light mode and vice versa.
  209. toast_options: These will act as default options for all toasts. See toast() for all available options.
  210. gap: Gap between toasts when expanded
  211. loading_icon: Changes the default loading icon
  212. pause_when_page_is_hidden: Pauses toast timers when the page is hidden, e.g., when the tab is backgrounded, the browser is minimized, or the OS is locked.
  213. style: The style of the component.
  214. key: A unique key for the component.
  215. id: The id for the component.
  216. class_name: The class name for the component.
  217. autofocus: Whether the component should take the focus once the page is loaded
  218. custom_attrs: custom attribute
  219. **props: The props of the component.
  220. Returns:
  221. The component.
  222. """
  223. ...
  224. class ConnectionBanner(Component):
  225. @overload
  226. @classmethod
  227. def create( # type: ignore
  228. cls,
  229. *children,
  230. style: Optional[Style] = None,
  231. key: Optional[Any] = None,
  232. id: Optional[Any] = None,
  233. class_name: Optional[Any] = None,
  234. autofocus: Optional[bool] = None,
  235. custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
  236. on_blur: Optional[
  237. Union[EventHandler, EventSpec, list, function, BaseVar]
  238. ] = None,
  239. on_click: Optional[
  240. Union[EventHandler, EventSpec, list, function, BaseVar]
  241. ] = None,
  242. on_context_menu: Optional[
  243. Union[EventHandler, EventSpec, list, function, BaseVar]
  244. ] = None,
  245. on_double_click: Optional[
  246. Union[EventHandler, EventSpec, list, function, BaseVar]
  247. ] = None,
  248. on_focus: Optional[
  249. Union[EventHandler, EventSpec, list, function, BaseVar]
  250. ] = None,
  251. on_mount: Optional[
  252. Union[EventHandler, EventSpec, list, function, BaseVar]
  253. ] = None,
  254. on_mouse_down: Optional[
  255. Union[EventHandler, EventSpec, list, function, BaseVar]
  256. ] = None,
  257. on_mouse_enter: Optional[
  258. Union[EventHandler, EventSpec, list, function, BaseVar]
  259. ] = None,
  260. on_mouse_leave: Optional[
  261. Union[EventHandler, EventSpec, list, function, BaseVar]
  262. ] = None,
  263. on_mouse_move: Optional[
  264. Union[EventHandler, EventSpec, list, function, BaseVar]
  265. ] = None,
  266. on_mouse_out: Optional[
  267. Union[EventHandler, EventSpec, list, function, BaseVar]
  268. ] = None,
  269. on_mouse_over: Optional[
  270. Union[EventHandler, EventSpec, list, function, BaseVar]
  271. ] = None,
  272. on_mouse_up: Optional[
  273. Union[EventHandler, EventSpec, list, function, BaseVar]
  274. ] = None,
  275. on_scroll: Optional[
  276. Union[EventHandler, EventSpec, list, function, BaseVar]
  277. ] = None,
  278. on_unmount: Optional[
  279. Union[EventHandler, EventSpec, list, function, BaseVar]
  280. ] = None,
  281. **props
  282. ) -> "ConnectionBanner":
  283. """Create a connection banner component.
  284. Args:
  285. comp: The component to render when there's a server connection error.
  286. Returns:
  287. The connection banner component.
  288. """
  289. ...
  290. class ConnectionModal(Component):
  291. @overload
  292. @classmethod
  293. def create( # type: ignore
  294. cls,
  295. *children,
  296. style: Optional[Style] = None,
  297. key: Optional[Any] = None,
  298. id: Optional[Any] = None,
  299. class_name: Optional[Any] = None,
  300. autofocus: Optional[bool] = None,
  301. custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
  302. on_blur: Optional[
  303. Union[EventHandler, EventSpec, list, function, BaseVar]
  304. ] = None,
  305. on_click: Optional[
  306. Union[EventHandler, EventSpec, list, function, BaseVar]
  307. ] = None,
  308. on_context_menu: Optional[
  309. Union[EventHandler, EventSpec, list, function, BaseVar]
  310. ] = None,
  311. on_double_click: Optional[
  312. Union[EventHandler, EventSpec, list, function, BaseVar]
  313. ] = None,
  314. on_focus: Optional[
  315. Union[EventHandler, EventSpec, list, function, BaseVar]
  316. ] = None,
  317. on_mount: Optional[
  318. Union[EventHandler, EventSpec, list, function, BaseVar]
  319. ] = None,
  320. on_mouse_down: Optional[
  321. Union[EventHandler, EventSpec, list, function, BaseVar]
  322. ] = None,
  323. on_mouse_enter: Optional[
  324. Union[EventHandler, EventSpec, list, function, BaseVar]
  325. ] = None,
  326. on_mouse_leave: Optional[
  327. Union[EventHandler, EventSpec, list, function, BaseVar]
  328. ] = None,
  329. on_mouse_move: Optional[
  330. Union[EventHandler, EventSpec, list, function, BaseVar]
  331. ] = None,
  332. on_mouse_out: Optional[
  333. Union[EventHandler, EventSpec, list, function, BaseVar]
  334. ] = None,
  335. on_mouse_over: Optional[
  336. Union[EventHandler, EventSpec, list, function, BaseVar]
  337. ] = None,
  338. on_mouse_up: Optional[
  339. Union[EventHandler, EventSpec, list, function, BaseVar]
  340. ] = None,
  341. on_scroll: Optional[
  342. Union[EventHandler, EventSpec, list, function, BaseVar]
  343. ] = None,
  344. on_unmount: Optional[
  345. Union[EventHandler, EventSpec, list, function, BaseVar]
  346. ] = None,
  347. **props
  348. ) -> "ConnectionModal":
  349. """Create a connection banner component.
  350. Args:
  351. comp: The component to render when there's a server connection error.
  352. Returns:
  353. The connection banner component.
  354. """
  355. ...
  356. class WifiOffPulse(Icon):
  357. @overload
  358. @classmethod
  359. def create( # type: ignore
  360. cls,
  361. *children,
  362. size: Optional[Union[Var[int], int]] = None,
  363. style: Optional[Style] = None,
  364. key: Optional[Any] = None,
  365. id: Optional[Any] = None,
  366. class_name: Optional[Any] = None,
  367. autofocus: Optional[bool] = None,
  368. custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
  369. on_blur: Optional[
  370. Union[EventHandler, EventSpec, list, function, BaseVar]
  371. ] = None,
  372. on_click: Optional[
  373. Union[EventHandler, EventSpec, list, function, BaseVar]
  374. ] = None,
  375. on_context_menu: Optional[
  376. Union[EventHandler, EventSpec, list, function, BaseVar]
  377. ] = None,
  378. on_double_click: Optional[
  379. Union[EventHandler, EventSpec, list, function, BaseVar]
  380. ] = None,
  381. on_focus: Optional[
  382. Union[EventHandler, EventSpec, list, function, BaseVar]
  383. ] = None,
  384. on_mount: Optional[
  385. Union[EventHandler, EventSpec, list, function, BaseVar]
  386. ] = None,
  387. on_mouse_down: Optional[
  388. Union[EventHandler, EventSpec, list, function, BaseVar]
  389. ] = None,
  390. on_mouse_enter: Optional[
  391. Union[EventHandler, EventSpec, list, function, BaseVar]
  392. ] = None,
  393. on_mouse_leave: Optional[
  394. Union[EventHandler, EventSpec, list, function, BaseVar]
  395. ] = None,
  396. on_mouse_move: Optional[
  397. Union[EventHandler, EventSpec, list, function, BaseVar]
  398. ] = None,
  399. on_mouse_out: Optional[
  400. Union[EventHandler, EventSpec, list, function, BaseVar]
  401. ] = None,
  402. on_mouse_over: Optional[
  403. Union[EventHandler, EventSpec, list, function, BaseVar]
  404. ] = None,
  405. on_mouse_up: Optional[
  406. Union[EventHandler, EventSpec, list, function, BaseVar]
  407. ] = None,
  408. on_scroll: Optional[
  409. Union[EventHandler, EventSpec, list, function, BaseVar]
  410. ] = None,
  411. on_unmount: Optional[
  412. Union[EventHandler, EventSpec, list, function, BaseVar]
  413. ] = None,
  414. **props
  415. ) -> "WifiOffPulse":
  416. """Create a wifi_off icon with an animated opacity pulse.
  417. Args:
  418. *children: The children of the component.
  419. size: The size of the icon in pixels.
  420. style: The style of the component.
  421. key: A unique key for the component.
  422. id: The id for the component.
  423. class_name: The class name for the component.
  424. autofocus: Whether the component should take the focus once the page is loaded
  425. custom_attrs: custom attribute
  426. **props: The properties of the component.
  427. Returns:
  428. The icon component with default props applied.
  429. """
  430. ...
  431. def add_imports(self) -> dict[str, str | ImportVar | list[str | ImportVar]]: ...
  432. class ConnectionPulser(Div):
  433. @overload
  434. @classmethod
  435. def create( # type: ignore
  436. cls,
  437. *children,
  438. access_key: Optional[
  439. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  440. ] = None,
  441. auto_capitalize: Optional[
  442. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  443. ] = None,
  444. content_editable: Optional[
  445. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  446. ] = None,
  447. context_menu: Optional[
  448. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  449. ] = None,
  450. dir: Optional[Union[Var[Union[str, int, bool]], Union[str, int, bool]]] = None,
  451. draggable: Optional[
  452. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  453. ] = None,
  454. enter_key_hint: Optional[
  455. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  456. ] = None,
  457. hidden: Optional[
  458. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  459. ] = None,
  460. input_mode: Optional[
  461. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  462. ] = None,
  463. item_prop: Optional[
  464. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  465. ] = None,
  466. lang: Optional[Union[Var[Union[str, int, bool]], Union[str, int, bool]]] = None,
  467. role: Optional[Union[Var[Union[str, int, bool]], Union[str, int, bool]]] = None,
  468. slot: Optional[Union[Var[Union[str, int, bool]], Union[str, int, bool]]] = None,
  469. spell_check: Optional[
  470. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  471. ] = None,
  472. tab_index: Optional[
  473. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  474. ] = None,
  475. title: Optional[
  476. Union[Var[Union[str, int, bool]], Union[str, int, bool]]
  477. ] = None,
  478. style: Optional[Style] = None,
  479. key: Optional[Any] = None,
  480. id: Optional[Any] = None,
  481. class_name: Optional[Any] = None,
  482. autofocus: Optional[bool] = None,
  483. custom_attrs: Optional[Dict[str, Union[Var, str]]] = None,
  484. on_blur: Optional[
  485. Union[EventHandler, EventSpec, list, function, BaseVar]
  486. ] = None,
  487. on_click: Optional[
  488. Union[EventHandler, EventSpec, list, function, BaseVar]
  489. ] = None,
  490. on_context_menu: Optional[
  491. Union[EventHandler, EventSpec, list, function, BaseVar]
  492. ] = None,
  493. on_double_click: Optional[
  494. Union[EventHandler, EventSpec, list, function, BaseVar]
  495. ] = None,
  496. on_focus: Optional[
  497. Union[EventHandler, EventSpec, list, function, BaseVar]
  498. ] = None,
  499. on_mount: Optional[
  500. Union[EventHandler, EventSpec, list, function, BaseVar]
  501. ] = None,
  502. on_mouse_down: Optional[
  503. Union[EventHandler, EventSpec, list, function, BaseVar]
  504. ] = None,
  505. on_mouse_enter: Optional[
  506. Union[EventHandler, EventSpec, list, function, BaseVar]
  507. ] = None,
  508. on_mouse_leave: Optional[
  509. Union[EventHandler, EventSpec, list, function, BaseVar]
  510. ] = None,
  511. on_mouse_move: Optional[
  512. Union[EventHandler, EventSpec, list, function, BaseVar]
  513. ] = None,
  514. on_mouse_out: Optional[
  515. Union[EventHandler, EventSpec, list, function, BaseVar]
  516. ] = None,
  517. on_mouse_over: Optional[
  518. Union[EventHandler, EventSpec, list, function, BaseVar]
  519. ] = None,
  520. on_mouse_up: Optional[
  521. Union[EventHandler, EventSpec, list, function, BaseVar]
  522. ] = None,
  523. on_scroll: Optional[
  524. Union[EventHandler, EventSpec, list, function, BaseVar]
  525. ] = None,
  526. on_unmount: Optional[
  527. Union[EventHandler, EventSpec, list, function, BaseVar]
  528. ] = None,
  529. **props
  530. ) -> "ConnectionPulser":
  531. """Create a connection pulser component.
  532. Args:
  533. access_key: Provides a hint for generating a keyboard shortcut for the current element.
  534. auto_capitalize: Controls whether and how text input is automatically capitalized as it is entered/edited by the user.
  535. content_editable: Indicates whether the element's content is editable.
  536. context_menu: Defines the ID of a <menu> element which will serve as the element's context menu.
  537. dir: Defines the text direction. Allowed values are ltr (Left-To-Right) or rtl (Right-To-Left)
  538. draggable: Defines whether the element can be dragged.
  539. enter_key_hint: Hints what media types the media element is able to play.
  540. hidden: Defines whether the element is hidden.
  541. input_mode: Defines the type of the element.
  542. item_prop: Defines the name of the element for metadata purposes.
  543. lang: Defines the language used in the element.
  544. role: Defines the role of the element.
  545. slot: Assigns a slot in a shadow DOM shadow tree to an element.
  546. spell_check: Defines whether the element may be checked for spelling errors.
  547. tab_index: Defines the position of the current element in the tabbing order.
  548. title: Defines a tooltip for the element.
  549. style: The style of the component.
  550. key: A unique key for the component.
  551. id: The id for the component.
  552. class_name: The class name for the component.
  553. autofocus: Whether the component should take the focus once the page is loaded
  554. custom_attrs: custom attribute
  555. **props: The properties of the component.
  556. Returns:
  557. The connection pulser component.
  558. """
  559. ...
  560. connection_banner = ConnectionBanner.create
  561. connection_modal = ConnectionModal.create
  562. connection_toaster = ConnectionToaster.create
  563. connection_pulser = ConnectionPulser.create