native-document 1.0.165 → 1.0.168

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 (488) hide show
  1. package/.vitepress/config.js +166 -0
  2. package/CHANGELOG.md +153 -0
  3. package/components.d.ts +2 -0
  4. package/components.js +2 -1
  5. package/devtools/widget.js +1 -1
  6. package/dist/native-document.components.min.js +11589 -2983
  7. package/dist/native-document.dev.js +2280 -396
  8. package/dist/native-document.dev.js.map +1 -1
  9. package/dist/native-document.min.js +1 -1
  10. package/docs/advanced-components.md +213 -608
  11. package/docs/anchor.md +173 -312
  12. package/docs/cache.md +95 -803
  13. package/docs/cli.md +179 -0
  14. package/docs/components/accordion.md +172 -0
  15. package/docs/components/alert.md +99 -0
  16. package/docs/components/avatar.md +160 -0
  17. package/docs/components/badge.md +102 -0
  18. package/docs/components/breadcrumb.md +89 -0
  19. package/docs/components/button.md +183 -0
  20. package/docs/components/card.md +69 -0
  21. package/docs/components/context-menu.md +118 -0
  22. package/docs/components/data-table.md +345 -0
  23. package/docs/components/dropdown.md +214 -0
  24. package/docs/components/form/autocomplete-field.md +81 -0
  25. package/docs/components/form/checkbox-field.md +41 -0
  26. package/docs/components/form/checkbox-group-field.md +54 -0
  27. package/docs/components/form/color-field.md +64 -0
  28. package/docs/components/form/date-field.md +92 -0
  29. package/docs/components/form/field-collection.md +63 -0
  30. package/docs/components/form/file-field.md +203 -0
  31. package/docs/components/form/form-control.md +87 -0
  32. package/docs/components/form/image-field.md +90 -0
  33. package/docs/components/form/index.md +115 -0
  34. package/docs/components/form/number-field.md +65 -0
  35. package/docs/components/form/radio-field.md +51 -0
  36. package/docs/components/form/select-field.md +123 -0
  37. package/docs/components/form/slider.md +136 -0
  38. package/docs/components/form/string-field.md +134 -0
  39. package/docs/components/form/textarea-field.md +65 -0
  40. package/docs/components/form-fields.md +372 -0
  41. package/docs/components/getting-started.md +264 -0
  42. package/docs/components/index.md +337 -0
  43. package/docs/components/layout.md +279 -0
  44. package/docs/components/list.md +73 -0
  45. package/docs/components/menu.md +215 -0
  46. package/docs/components/modal.md +156 -0
  47. package/docs/components/pagination.md +95 -0
  48. package/docs/components/popover.md +131 -0
  49. package/docs/components/progress.md +111 -0
  50. package/docs/components/shortcut-manager.md +221 -0
  51. package/docs/components/simple-table.md +107 -0
  52. package/docs/components/skeleton.md +155 -0
  53. package/docs/components/spinner.md +100 -0
  54. package/docs/components/splitter.md +133 -0
  55. package/docs/components/stepper.md +163 -0
  56. package/docs/components/switch.md +113 -0
  57. package/docs/components/tabs.md +153 -0
  58. package/docs/components/toast.md +119 -0
  59. package/docs/components/tooltip.md +151 -0
  60. package/docs/components/traits.md +261 -0
  61. package/docs/conditional-rendering.md +170 -588
  62. package/docs/contributing.md +300 -25
  63. package/docs/core-concepts.md +205 -374
  64. package/docs/elements.md +251 -367
  65. package/docs/extending-native-document-element.md +192 -207
  66. package/docs/filters.md +153 -1122
  67. package/docs/getting-started.md +193 -267
  68. package/docs/i18n.md +241 -0
  69. package/docs/index.md +76 -0
  70. package/docs/lifecycle-events.md +143 -75
  71. package/docs/list-rendering.md +227 -852
  72. package/docs/memory-management.md +134 -47
  73. package/docs/native-document-element.md +337 -186
  74. package/docs/native-fetch.md +99 -630
  75. package/docs/observable-resource.md +364 -0
  76. package/docs/observables.md +592 -526
  77. package/docs/routing.md +244 -653
  78. package/docs/state-management.md +134 -241
  79. package/docs/svg-elements.md +231 -0
  80. package/docs/theming.md +409 -0
  81. package/docs/validation.md +95 -97
  82. package/docs/vitepress-conventions.md +219 -0
  83. package/eslint.config.js +28 -33
  84. package/i18n.js +1 -1
  85. package/i18n.ts +2 -0
  86. package/index.js +3 -0
  87. package/package.json +36 -14
  88. package/readme.md +269 -89
  89. package/src/components/$traits/has-draggable/HasDraggable.d.ts +4 -0
  90. package/src/components/$traits/has-draggable/HasDraggable.js +13 -0
  91. package/src/components/$traits/has-items/HasItems.d.ts +9 -0
  92. package/src/components/$traits/has-items/HasItems.js +6 -6
  93. package/src/components/$traits/has-position/HasFullPosition.d.ts +14 -0
  94. package/src/components/$traits/has-position/HasFullPosition.js +44 -0
  95. package/src/components/$traits/has-position/HasPosition.d.ts +7 -0
  96. package/src/components/$traits/has-position/HasPosition.js +23 -1
  97. package/src/components/$traits/has-resizable/HasResizable.d.ts +13 -0
  98. package/src/components/$traits/has-resizable/HasResizable.js +9 -0
  99. package/src/components/$traits/has-validation/HasValidation.d.ts +17 -0
  100. package/src/components/$traits/has-validation/HasValidation.js +54 -7
  101. package/src/components/BaseComponent.d.ts +32 -0
  102. package/src/components/BaseComponent.js +65 -9
  103. package/src/components/accordion/Accordion.js +39 -14
  104. package/src/components/accordion/AccordionItem.js +45 -14
  105. package/src/components/accordion/index.js +2 -2
  106. package/src/components/accordion/types/Accordion.d.ts +47 -0
  107. package/src/components/accordion/types/AccordionItem.d.ts +48 -0
  108. package/src/components/alert/Alert.js +70 -38
  109. package/src/components/alert/index.js +2 -2
  110. package/src/components/alert/types/Alert.d.ts +62 -0
  111. package/src/components/avatar/Avatar.js +49 -12
  112. package/src/components/avatar/AvatarGroup.js +50 -2
  113. package/src/components/avatar/index.js +2 -2
  114. package/src/components/avatar/types/Avatar.d.ts +74 -0
  115. package/src/components/avatar/types/AvatarGroup.d.ts +32 -0
  116. package/src/components/badge/Badge.js +125 -5
  117. package/src/components/badge/index.js +2 -2
  118. package/src/components/badge/types/Badge.d.ts +51 -0
  119. package/src/components/breadcrumb/BreadCrumb.js +61 -5
  120. package/src/components/breadcrumb/index.js +2 -2
  121. package/src/components/breadcrumb/types/BreadCrumb.d.ts +42 -0
  122. package/src/components/button/Button.js +164 -9
  123. package/src/components/button/index.js +1 -1
  124. package/src/components/button/types/Button.d.ts +62 -0
  125. package/src/components/card/Card.js +204 -32
  126. package/src/components/card/index.js +4 -4
  127. package/src/components/card/types/Card.d.ts +42 -0
  128. package/src/components/context-menu/ContextMenu.js +49 -5
  129. package/src/components/context-menu/ContextMenuGroup.js +15 -2
  130. package/src/components/context-menu/ContextMenuItem.js +14 -2
  131. package/src/components/context-menu/index.js +5 -5
  132. package/src/components/context-menu/types/ContextMenu.d.ts +30 -0
  133. package/src/components/context-menu/types/ContextMenuGroup.d.ts +18 -0
  134. package/src/components/context-menu/types/ContextMenuItem.d.ts +18 -0
  135. package/src/components/divider/Divider.js +120 -4
  136. package/src/components/divider/index.js +3 -3
  137. package/src/components/divider/types/Divider.d.ts +55 -0
  138. package/src/components/dropdown/Dropdown.js +239 -16
  139. package/src/components/dropdown/DropdownDivider.js +22 -2
  140. package/src/components/dropdown/DropdownGroup.js +44 -5
  141. package/src/components/dropdown/DropdownItem.js +76 -3
  142. package/src/components/dropdown/DropdownTrigger.js +49 -20
  143. package/src/components/dropdown/helpers.js +1 -1
  144. package/src/components/dropdown/index.js +6 -6
  145. package/src/components/dropdown/types/Dropdown.d.ts +88 -0
  146. package/src/components/dropdown/types/DropdownDivider.d.ts +20 -0
  147. package/src/components/dropdown/types/DropdownGroup.d.ts +25 -0
  148. package/src/components/dropdown/types/DropdownItem.d.ts +41 -0
  149. package/src/components/dropdown/types/DropdownTrigger.d.ts +32 -0
  150. package/src/components/form/FormControl.js +156 -13
  151. package/src/components/form/field/Field.js +172 -9
  152. package/src/components/form/field/FieldCollection.js +116 -12
  153. package/src/components/form/field/types/AutocompleteField.js +92 -2
  154. package/src/components/form/field/types/CheckboxField.js +43 -2
  155. package/src/components/form/field/types/CheckboxGroupField.js +83 -6
  156. package/src/components/form/field/types/ColorField.js +56 -3
  157. package/src/components/form/field/types/DateField.js +155 -4
  158. package/src/components/form/field/types/EmailField.js +54 -4
  159. package/src/components/form/field/types/FileField.js +140 -6
  160. package/src/components/form/field/types/HiddenField.js +27 -1
  161. package/src/components/form/field/types/ImageField.js +82 -3
  162. package/src/components/form/field/types/NumberField.js +97 -4
  163. package/src/components/form/field/types/PasswordField.js +103 -7
  164. package/src/components/form/field/types/RadioField.js +75 -4
  165. package/src/components/form/field/types/RangeField.js +67 -1
  166. package/src/components/form/field/types/SearchField.js +41 -2
  167. package/src/components/form/field/types/SelectField.js +133 -4
  168. package/src/components/form/field/types/StringField.js +91 -2
  169. package/src/components/form/field/types/TelField.js +55 -4
  170. package/src/components/form/field/types/TextAreaField.js +76 -2
  171. package/src/components/form/field/types/TimeField.js +120 -5
  172. package/src/components/form/field/types/UrlField.js +59 -4
  173. package/src/components/form/field/types/file-field-mode/FileAvatarMode.js +83 -4
  174. package/src/components/form/field/types/file-field-mode/FileDropzoneMode.js +61 -3
  175. package/src/components/form/field/types/file-field-mode/FileItemPreview.js +79 -3
  176. package/src/components/form/field/types/file-field-mode/FileNativeMode.js +24 -2
  177. package/src/components/form/field/types/file-field-mode/FileUploadButtonMode.js +64 -3
  178. package/src/components/form/field/types/file-field-mode/FileWallMode.js +56 -3
  179. package/src/components/form/index.js +28 -28
  180. package/src/components/form/types/Field.d.ts +73 -0
  181. package/src/components/form/types/FieldCollection.d.ts +53 -0
  182. package/src/components/form/types/FormControl.d.ts +64 -0
  183. package/src/components/form/types/fields/AutocompleteField.d.ts +48 -0
  184. package/src/components/form/types/fields/CheckboxField.d.ts +33 -0
  185. package/src/components/form/types/fields/CheckboxGroupField.d.ts +49 -0
  186. package/src/components/form/types/fields/ColorField.d.ts +37 -0
  187. package/src/components/form/types/fields/DateField.d.ts +70 -0
  188. package/src/components/form/types/fields/EmailField.d.ts +35 -0
  189. package/src/components/form/types/fields/FileAvatarMode.d.ts +46 -0
  190. package/src/components/form/types/fields/FileDropzoneMode.d.ts +28 -0
  191. package/src/components/form/types/fields/FileField.d.ts +56 -0
  192. package/src/components/form/types/fields/FileItemPreview.d.ts +35 -0
  193. package/src/components/form/types/fields/FileNativeMode.d.ts +21 -0
  194. package/src/components/form/types/fields/FileUploadButtonMode.d.ts +34 -0
  195. package/src/components/form/types/fields/FileWallMode.d.ts +32 -0
  196. package/src/components/form/types/fields/HiddenField.d.ts +26 -0
  197. package/src/components/form/types/fields/ImageField.d.ts +45 -0
  198. package/src/components/form/types/fields/NumberField.d.ts +48 -0
  199. package/src/components/form/types/fields/PasswordField.d.ts +46 -0
  200. package/src/components/form/types/fields/RadioField.d.ts +48 -0
  201. package/src/components/form/types/fields/RangeField.d.ts +44 -0
  202. package/src/components/form/types/fields/SearchField.d.ts +34 -0
  203. package/src/components/form/types/fields/SelectField.d.ts +71 -0
  204. package/src/components/form/types/fields/StringField.d.ts +48 -0
  205. package/src/components/form/types/fields/TelField.d.ts +37 -0
  206. package/src/components/form/types/fields/TextAreaField.d.ts +44 -0
  207. package/src/components/form/types/fields/TimeField.d.ts +51 -0
  208. package/src/components/form/types/fields/UrlField.d.ts +35 -0
  209. package/src/components/form/validation/Validation.js +54 -54
  210. package/src/components/index.d.ts +160 -0
  211. package/src/components/list/HasListItem.js +171 -0
  212. package/src/components/list/List.js +85 -67
  213. package/src/components/list/ListDivider.js +39 -0
  214. package/src/components/list/ListGroup.js +105 -38
  215. package/src/components/list/ListItem.js +158 -49
  216. package/src/components/list/index.js +8 -6
  217. package/src/components/list/types/List.d.ts +43 -0
  218. package/src/components/list/types/ListGroup.d.ts +37 -0
  219. package/src/components/list/types/ListItem.d.ts +53 -0
  220. package/src/components/menu/HasMenuItem.js +55 -6
  221. package/src/components/menu/Menu.js +113 -22
  222. package/src/components/menu/MenuDivider.js +18 -2
  223. package/src/components/menu/MenuGroup.js +61 -6
  224. package/src/components/menu/MenuItem.js +95 -11
  225. package/src/components/menu/MenuLink.js +27 -2
  226. package/src/components/menu/index.js +6 -6
  227. package/src/components/menu/types/Menu.d.ts +60 -0
  228. package/src/components/menu/types/MenuDivider.d.ts +19 -0
  229. package/src/components/menu/types/MenuGroup.d.ts +44 -0
  230. package/src/components/menu/types/MenuItem.d.ts +46 -0
  231. package/src/components/menu/types/MenuLink.d.ts +16 -0
  232. package/src/components/modal/Modal.js +258 -17
  233. package/src/components/modal/index.js +3 -3
  234. package/src/components/modal/types/Modal.d.ts +94 -0
  235. package/src/components/pagination/Pagination.js +155 -7
  236. package/src/components/pagination/index.js +3 -3
  237. package/src/components/pagination/types/Pagination.d.ts +68 -0
  238. package/src/components/popover/Popover.js +198 -11
  239. package/src/components/popover/PopoverFooter.js +33 -9
  240. package/src/components/popover/PopoverHeader.js +33 -8
  241. package/src/components/popover/index.js +4 -4
  242. package/src/components/popover/types/Popover.d.ts +83 -0
  243. package/src/components/popover/types/PopoverFooter.d.ts +24 -0
  244. package/src/components/popover/types/PopoverHeader.d.ts +26 -0
  245. package/src/components/progress/Progress.js +182 -13
  246. package/src/components/progress/index.js +3 -3
  247. package/src/components/progress/types/Progress.d.ts +77 -0
  248. package/src/components/skeleton/Skeleton.js +117 -49
  249. package/src/components/skeleton/index.js +3 -3
  250. package/src/components/skeleton/types/Skeleton.d.ts +55 -0
  251. package/src/components/slider/Slider.js +207 -10
  252. package/src/components/slider/index.js +2 -2
  253. package/src/components/slider/types/Slider.d.ts +82 -0
  254. package/src/components/spacer/Spacer.js +12 -3
  255. package/src/components/spacer/index.js +2 -2
  256. package/src/components/spacer/types/Spacer.d.ts +19 -0
  257. package/src/components/spinner/Spinner.js +180 -9
  258. package/src/components/spinner/index.js +3 -3
  259. package/src/components/spinner/types/Spinner.d.ts +71 -0
  260. package/src/components/splitter/Splitter.js +76 -13
  261. package/src/components/splitter/SplitterGutter.js +67 -5
  262. package/src/components/splitter/SplitterPanel.js +69 -2
  263. package/src/components/splitter/index.js +5 -5
  264. package/src/components/splitter/types/Splitter.d.ts +38 -0
  265. package/src/components/splitter/types/SplitterGutter.d.ts +38 -0
  266. package/src/components/splitter/types/SplitterPanel.d.ts +41 -0
  267. package/src/components/stacks/AbsoluteStack.js +23 -3
  268. package/src/components/stacks/FixedStack.js +23 -3
  269. package/src/components/stacks/HStack.js +24 -3
  270. package/src/components/stacks/PositionStack.js +111 -3
  271. package/src/components/stacks/RelativeStack.js +23 -3
  272. package/src/components/stacks/Stack.js +73 -2
  273. package/src/components/stacks/VStack.js +24 -4
  274. package/src/components/stacks/index.js +7 -7
  275. package/src/components/stacks/types/AbsoluteStack.d.ts +16 -0
  276. package/src/components/stacks/types/FixedStack.d.ts +16 -0
  277. package/src/components/stacks/types/HStack.d.ts +16 -0
  278. package/src/components/stacks/types/PositionStack.d.ts +54 -0
  279. package/src/components/stacks/types/RelativeStack.d.ts +17 -0
  280. package/src/components/stacks/types/Stack.d.ts +39 -0
  281. package/src/components/stacks/types/VStack.d.ts +16 -0
  282. package/src/components/stepper/Stepper.js +152 -12
  283. package/src/components/stepper/StepperStep.js +104 -3
  284. package/src/components/stepper/index.js +4 -4
  285. package/src/components/stepper/types/Stepper.d.ts +68 -0
  286. package/src/components/stepper/types/StepperStep.d.ts +54 -0
  287. package/src/components/switch/Switch.js +143 -6
  288. package/src/components/switch/index.js +1 -1
  289. package/src/components/switch/types/Switch.d.ts +55 -0
  290. package/src/components/table/Column.js +105 -6
  291. package/src/components/table/ColumnGroup.js +48 -3
  292. package/src/components/table/DataTable.js +256 -19
  293. package/src/components/table/SimpleTable.js +58 -4
  294. package/src/components/table/index.js +2 -2
  295. package/src/components/table/types/Column.d.ts +49 -0
  296. package/src/components/table/types/ColumnGroup.d.ts +28 -0
  297. package/src/components/table/types/DataTable.d.ts +97 -0
  298. package/src/components/table/types/SimpleTable.d.ts +40 -0
  299. package/src/components/tabs/Tabs.js +192 -5
  300. package/src/components/tabs/index.js +3 -3
  301. package/src/components/tabs/types/Tabs.d.ts +78 -0
  302. package/src/components/toast/Toast.js +133 -5
  303. package/src/components/toast/index.js +3 -3
  304. package/src/components/toast/types/Toast.d.ts +57 -0
  305. package/src/components/toast/types/ToastError.d.ts +7 -0
  306. package/src/components/toast/types/ToastInfo.d.ts +7 -0
  307. package/src/components/toast/types/ToastSuccess.d.ts +7 -0
  308. package/src/components/toast/types/ToastWarning.d.ts +7 -0
  309. package/src/components/tooltip/Tooltip.js +157 -13
  310. package/src/components/tooltip/index.js +2 -2
  311. package/src/components/tooltip/prototypes.js +1 -1
  312. package/src/components/tooltip/types/Tooltip.d.ts +65 -0
  313. package/src/core/data/MemoryManager.js +2 -2
  314. package/src/core/data/Observable.js +15 -18
  315. package/src/core/data/ObservableArray.js +118 -46
  316. package/src/core/data/ObservableChecker.js +2 -2
  317. package/src/core/data/ObservableItem.js +135 -21
  318. package/src/core/data/ObservableObject.js +126 -35
  319. package/src/core/data/ObservableResource.js +118 -3
  320. package/src/core/data/Store.js +142 -26
  321. package/src/core/data/observable-helpers/observable.is-to.js +196 -1
  322. package/src/core/data/observable-helpers/observable.prototypes.js +35 -8
  323. package/src/core/elements/anchor/anchor-with-sentinel.js +23 -2
  324. package/src/core/elements/anchor/anchor.js +16 -7
  325. package/src/core/elements/anchor/one-child-anchor-overwriting.js +2 -2
  326. package/src/core/elements/content-formatter.js +1 -1
  327. package/src/core/elements/control/for-each-array.js +9 -9
  328. package/src/core/elements/control/for-each.js +14 -14
  329. package/src/core/elements/control/show-if.js +11 -11
  330. package/src/core/elements/control/show-when.js +5 -5
  331. package/src/core/elements/control/switch.js +14 -14
  332. package/src/core/elements/description-list.js +1 -1
  333. package/src/core/elements/form.js +2 -2
  334. package/src/core/elements/fragment.js +1 -1
  335. package/src/core/elements/html5-semantics.js +1 -1
  336. package/src/core/elements/img.js +3 -3
  337. package/src/core/elements/interactive.js +1 -1
  338. package/src/core/elements/list.js +1 -1
  339. package/src/core/elements/medias.js +1 -1
  340. package/src/core/elements/meta-data.js +1 -1
  341. package/src/core/elements/svg.js +1 -1
  342. package/src/core/elements/table.js +1 -1
  343. package/src/core/errors/ArgTypesError.js +1 -1
  344. package/src/core/utils/HasEventEmitter.js +36 -2
  345. package/src/core/utils/args-types.js +9 -9
  346. package/src/core/utils/cache.js +1 -1
  347. package/src/core/utils/callback-handler.js +29 -0
  348. package/src/core/utils/debug-manager.js +6 -6
  349. package/src/core/utils/events.js +139 -139
  350. package/src/core/utils/filters/date.js +84 -3
  351. package/src/core/utils/filters/standard.js +136 -11
  352. package/src/core/utils/filters/strings.js +34 -2
  353. package/src/core/utils/filters/utils.js +40 -4
  354. package/src/core/utils/formatters.js +4 -4
  355. package/src/core/utils/helpers.js +39 -7
  356. package/src/core/utils/localstorage.js +11 -11
  357. package/src/core/utils/memoize.js +56 -3
  358. package/src/core/utils/plugins-manager.js +3 -3
  359. package/src/core/utils/property-accumulator.js +6 -6
  360. package/src/core/utils/prototypes.js +26 -1
  361. package/src/core/utils/shortcut-manager.js +2 -2
  362. package/src/core/utils/validator.js +8 -8
  363. package/src/core/wrappers/AttributesWrapper.js +32 -22
  364. package/src/core/wrappers/DocumentObserver.js +3 -3
  365. package/src/core/wrappers/ElementCreator.js +5 -5
  366. package/src/core/wrappers/HtmlElementWrapper.js +38 -12
  367. package/src/core/wrappers/NDElement.js +328 -22
  368. package/src/core/wrappers/NdPrototype.js +60 -16
  369. package/src/core/wrappers/SingletonView.js +50 -2
  370. package/src/core/wrappers/SvgElementWrapper.js +1 -1
  371. package/src/core/wrappers/constants.js +35 -2
  372. package/src/core/wrappers/prototypes/attributes-extensions.js +7 -7
  373. package/src/core/wrappers/prototypes/nd-element-extensions.js +72 -6
  374. package/src/core/wrappers/prototypes/nd-element.transition.extensions.js +42 -2
  375. package/src/core/wrappers/template-cloner/NodeCloner.js +53 -8
  376. package/src/core/wrappers/template-cloner/TemplateCloner.js +75 -6
  377. package/src/core/wrappers/template-cloner/attributes-hydrator.js +58 -2
  378. package/src/core/wrappers/template-cloner/utils.js +42 -6
  379. package/src/fetch/NativeFetch.js +3 -3
  380. package/src/i18n/bin/scan.js +6 -6
  381. package/src/i18n/index.d.ts +2 -0
  382. package/src/i18n/service/I18nService.d.ts +27 -0
  383. package/src/i18n/service/I18nService.js +5 -5
  384. package/src/i18n/service/functions.d.ts +22 -0
  385. package/src/i18n/service/functions.js +2 -2
  386. package/src/router/Route.js +3 -3
  387. package/src/router/RouteGroupHelper.js +2 -2
  388. package/src/router/Router.js +15 -15
  389. package/src/router/RouterComponent.js +33 -7
  390. package/src/router/link.js +4 -4
  391. package/src/router/modes/HashRouter.js +2 -2
  392. package/src/router/modes/HistoryRouter.js +2 -2
  393. package/src/router/modes/MemoryRouter.js +1 -1
  394. package/src/ui/components/accordion/AccordionItemRender.js +3 -3
  395. package/src/ui/components/accordion/AccordionRender.js +1 -1
  396. package/src/ui/components/alert/AlertRender.js +10 -10
  397. package/src/ui/components/avatar/avata-group/AvatarGroupRender.js +1 -1
  398. package/src/ui/components/avatar/avatar/AvatarRender.js +1 -1
  399. package/src/ui/components/breadcrumb/BreadcrumbRender.js +2 -2
  400. package/src/ui/components/button/ButtonRender.js +1 -1
  401. package/src/ui/components/card/CardRender.js +133 -0
  402. package/src/ui/components/card/card.css +169 -0
  403. package/src/ui/components/contextmenu/ContextmenuRender.js +6 -6
  404. package/src/ui/components/dropdown/DropdownRender.js +8 -8
  405. package/src/ui/components/dropdown/group/DropdownGroupRender.js +2 -2
  406. package/src/ui/components/dropdown/item/DropdownItemRender.js +1 -1
  407. package/src/ui/components/form/FieldCollectionRender.js +2 -2
  408. package/src/ui/components/form/FormControlRender.js +5 -5
  409. package/src/ui/components/form/fields/AutocompleteFieldRender.js +3 -3
  410. package/src/ui/components/form/fields/CheckboxFieldRender.js +1 -1
  411. package/src/ui/components/form/fields/CheckboxGroupFieldRender.js +1 -1
  412. package/src/ui/components/form/fields/DateFieldRender.js +7 -7
  413. package/src/ui/components/form/fields/EmailFieldRender.js +1 -1
  414. package/src/ui/components/form/fields/FieldRender.js +4 -4
  415. package/src/ui/components/form/fields/FileFieldRender.js +1 -1
  416. package/src/ui/components/form/fields/PasswordFieldRender.js +2 -2
  417. package/src/ui/components/form/fields/RadioFieldRender.js +1 -1
  418. package/src/ui/components/form/fields/RangeFieldRender.js +1 -1
  419. package/src/ui/components/form/fields/SelectFieldRender.js +2 -2
  420. package/src/ui/components/form/fields/SliderFieldRender.js +6 -6
  421. package/src/ui/components/form/fields/StringFieldRender.js +1 -1
  422. package/src/ui/components/form/fields/TelFieldRender.js +1 -1
  423. package/src/ui/components/form/fields/TextAreaFieldRender.js +1 -1
  424. package/src/ui/components/form/fields/TimeFieldRender.js +3 -3
  425. package/src/ui/components/form/fields/UrlFieldRender.js +1 -1
  426. package/src/ui/components/form/file-upload-mode/FileAvatarModeRender.js +1 -1
  427. package/src/ui/components/form/file-upload-mode/FileDropzoneModeRender.js +2 -2
  428. package/src/ui/components/form/file-upload-mode/FileUploadButtonModeRender.js +2 -2
  429. package/src/ui/components/form/file-upload-mode/FileWallModeRender.js +1 -1
  430. package/src/ui/components/form/helpers.js +8 -8
  431. package/src/ui/components/form/index.js +27 -27
  432. package/src/ui/components/list/ListRender.js +18 -0
  433. package/src/ui/components/list/divider/ListDividerRender.js +10 -0
  434. package/src/ui/components/list/divider/list-divider.css +12 -0
  435. package/src/ui/components/list/group/ListGroupRender.js +61 -0
  436. package/src/ui/components/list/group/list-group.css +62 -0
  437. package/src/ui/components/list/item/ListItemRender.js +238 -0
  438. package/src/ui/components/list/item/list-item.css +191 -0
  439. package/src/ui/components/list/list.css +24 -0
  440. package/src/ui/components/menu/MenuDividerRender.js +1 -1
  441. package/src/ui/components/menu/MenuGroupRender.js +3 -3
  442. package/src/ui/components/menu/MenuItemRender.js +2 -2
  443. package/src/ui/components/menu/MenuLinkRender.js +3 -3
  444. package/src/ui/components/menu/helpers.js +4 -4
  445. package/src/ui/components/modal/ModalRender.js +4 -4
  446. package/src/ui/components/pagination/PaginationRender.js +9 -9
  447. package/src/ui/components/popover/PopoverRender.js +7 -7
  448. package/src/ui/components/progress/ProgressRender.js +12 -12
  449. package/src/ui/components/skeleton/SkeletonRender.js +56 -0
  450. package/src/ui/components/spacer/SpacerRender.js +10 -0
  451. package/src/ui/components/splitter/SplitterGutterRender.js +1 -1
  452. package/src/ui/components/splitter/SplitterPanelRender.js +2 -2
  453. package/src/ui/components/stacks/PositionStackRender.js +1 -1
  454. package/src/ui/components/stacks/StackRender.js +1 -1
  455. package/src/ui/components/stacks/absolute-stack/AbsoluteStackRender.js +1 -1
  456. package/src/ui/components/stacks/fixed-stack/FixedStackRender.js +1 -1
  457. package/src/ui/components/stacks/h-stack/HStackRender.js +1 -1
  458. package/src/ui/components/stacks/index.js +5 -5
  459. package/src/ui/components/stacks/relative-stack/RelativeStackRender.js +1 -1
  460. package/src/ui/components/stacks/v-stack/VStackRender.js +1 -1
  461. package/src/ui/components/stepper/StepperRender.js +2 -2
  462. package/src/ui/components/stepper/StepperStepRender.js +4 -4
  463. package/src/ui/components/switch/SwitchRender.js +4 -4
  464. package/src/ui/components/table/data-table/DataTableRender.js +5 -5
  465. package/src/ui/components/table/data-table/bulk-actions.js +7 -7
  466. package/src/ui/components/table/data-table/pagination.js +6 -6
  467. package/src/ui/components/table/data-table/tables.js +25 -25
  468. package/src/ui/components/table/data-table/toolbar.js +3 -3
  469. package/src/ui/components/table/simple-table/SimpleTableRender.js +8 -8
  470. package/src/ui/components/tabs/TabsRender.js +11 -11
  471. package/src/ui/components/toast/ToastRender.js +3 -3
  472. package/src/ui/components/tooltip/TooltipRender.js +1 -1
  473. package/src/ui/index.js +44 -36
  474. package/types/elements.d.ts +163 -1037
  475. package/types/forms.d.ts +16 -20
  476. package/types/globals.d.ts +543 -0
  477. package/types/images.d.ts +2 -2
  478. package/types/observable-resource.d.ts +3 -0
  479. package/types/property-accumulator.d.ts +4 -4
  480. package/types/store.d.ts +26 -2
  481. package/types/validator.ts +3 -3
  482. package/ui.js +1 -0
  483. package/src/components/form/field/DefaultRender.js +0 -77
  484. package/src/components/form/field/FieldFactory.js +0 -107
  485. package/src/components/skeleton/SkeletonList.js +0 -0
  486. package/src/components/skeleton/SkeletonParagraph.js +0 -0
  487. package/src/components/skeleton/SkeletonTable.js +0 -0
  488. /package/{src/components/skeleton/SkeletonCard.js → docs/tutorials/.gitkeep} +0 -0
package/types/forms.d.ts CHANGED
@@ -1,13 +1,9 @@
1
1
  // Form elements type definitions
2
- import {
3
- ValidChild,
4
- ElementFunction,
5
- ElementFunctionNoChildren,
6
- NdHTMLElement,
2
+ import type { ValidChild, ElementFunction, ElementFunctionNoChildren, NdHTMLElement } from './elements';
3
+ import type { ObservableItem } from './observable';
4
+ import type {
5
+ Observable,
7
6
  GlobalAttributes,
8
- Observable
9
- } from './elements';
10
- import {
11
7
  FormAttributes,
12
8
  InputAttributes,
13
9
  TextAreaAttributes,
@@ -18,11 +14,11 @@ import {
18
14
  ProgressAttributes,
19
15
  MeterAttributes,
20
16
  LabelAttributes,
21
- } from './elements';
17
+ } from './globals';
22
18
 
23
- // ─────────────────────────────────────────────
19
+ // ---------------------------------------------
24
20
  // Form
25
- // ─────────────────────────────────────────────
21
+ // ---------------------------------------------
26
22
 
27
23
  export declare const Form: (
28
24
  attributes?: FormAttributes,
@@ -34,9 +30,9 @@ export declare const Form: (
34
30
  multipartFormData: () => NdHTMLElement<HTMLFormElement>;
35
31
  };
36
32
 
37
- // ─────────────────────────────────────────────
33
+ // ---------------------------------------------
38
34
  // Input
39
- // ─────────────────────────────────────────────
35
+ // ---------------------------------------------
40
36
 
41
37
  export declare const Input: ElementFunctionNoChildren<InputAttributes, HTMLInputElement>;
42
38
  export declare const ReadonlyInput: (attributes?: Omit<InputAttributes, 'type' | 'readonly' | 'readOnly'>) => NdHTMLElement<HTMLInputElement>;
@@ -58,26 +54,26 @@ export declare const UrlInput: (attributes?: Omit<InputAttributes, 'type'>)
58
54
  export declare const EmailInput: (attributes?: Omit<InputAttributes, 'type'>) => NdHTMLElement<HTMLInputElement>;
59
55
  export declare const NumberInput: (attributes?: Omit<InputAttributes, 'type'>) => NdHTMLElement<HTMLInputElement>;
60
56
 
61
- // ─────────────────────────────────────────────
57
+ // ---------------------------------------------
62
58
  // Textarea & Select
63
- // ─────────────────────────────────────────────
59
+ // ---------------------------------------------
64
60
 
65
61
  export declare const TextArea: ElementFunction<TextAreaAttributes, HTMLTextAreaElement>;
66
62
  export declare const TextInput: typeof TextArea;
67
63
  export declare const Select: ElementFunction<SelectAttributes, HTMLSelectElement>;
68
64
  export declare const Option: ElementFunction<OptionAttributes, HTMLOptionElement>;
69
65
 
70
- // ─────────────────────────────────────────────
66
+ // ---------------------------------------------
71
67
  // Button
72
- // ─────────────────────────────────────────────
68
+ // ---------------------------------------------
73
69
 
74
70
  export declare const Button: ElementFunction<ButtonAttributes, HTMLButtonElement>;
75
71
  export declare const SimpleButton: (children?: ValidChild, attributes?: Omit<ButtonAttributes, 'type'>) => NdHTMLElement<HTMLButtonElement>;
76
72
  export declare const SubmitButton: (children?: ValidChild, attributes?: Omit<ButtonAttributes, 'type'>) => NdHTMLElement<HTMLButtonElement>;
77
73
 
78
- // ─────────────────────────────────────────────
74
+ // ---------------------------------------------
79
75
  // Other form elements
80
- // ─────────────────────────────────────────────
76
+ // ---------------------------------------------
81
77
 
82
78
  export declare const FieldSet: ElementFunction<GlobalAttributes & { disabled?: Observable<boolean> }, HTMLFieldSetElement>;
83
79
  export declare const Legend: ElementFunction<GlobalAttributes, HTMLLegendElement>;
@@ -85,4 +81,4 @@ export declare const Label: ElementFunction<LabelAttributes, HTMLLabelElement
85
81
  export declare const Datalist: ElementFunction<GlobalAttributes, HTMLDataListElement>;
86
82
  export declare const Output: ElementFunction<OutputAttributes, HTMLOutputElement>;
87
83
  export declare const Progress: ElementFunction<ProgressAttributes, HTMLProgressElement>;
88
- export declare const Meter: ElementFunction<MeterAttributes, HTMLMeterElement>;
84
+ export declare const Meter: ElementFunction<MeterAttributes, HTMLMeterElement>;
@@ -0,0 +1,543 @@
1
+ /**
2
+ * @file globals.d.ts
3
+ * Exports all global attribute interfaces and utility types declared in
4
+ * index.def.js / elements.d.ts. Import from here when you need these types
5
+ * in component definitions.
6
+ */
7
+
8
+ import type { ObservableItem } from './observable';
9
+
10
+ // ---------------------------------------------------------
11
+ // Observable shorthand
12
+ // ---------------------------------------------------------
13
+
14
+ /** T or an ObservableItem wrapping T */
15
+ export type Observable<T> = ObservableItem<T> | T;
16
+
17
+ // ---------------------------------------------------------
18
+ // Style / class maps
19
+ // ---------------------------------------------------------
20
+
21
+ /**
22
+ * A map of CSS class names to reactive or static boolean conditions.
23
+ * @example { active: isActive, disabled: isDisabled }
24
+ */
25
+ export type NdClassMap = Record<string, Observable<boolean>>;
26
+
27
+ /**
28
+ * A strongly-typed map of CSS property names to reactive or static values.
29
+ * Supports both camelCase and kebab-case property names.
30
+ */
31
+ export interface NdStyleMap {
32
+ accentColor?: Observable<string> | string;
33
+ 'accent-color'?: Observable<string> | string;
34
+ alignContent?: Observable<string> | string;
35
+ 'align-content'?: Observable<string> | string;
36
+ alignItems?: Observable<string> | string;
37
+ 'align-items'?: Observable<string> | string;
38
+ alignSelf?: Observable<string> | string;
39
+ 'align-self'?: Observable<string> | string;
40
+ animation?: Observable<string> | string;
41
+ animationDelay?: Observable<string> | string;
42
+ 'animation-delay'?: Observable<string> | string;
43
+ animationDuration?: Observable<string> | string;
44
+ 'animation-duration'?: Observable<string> | string;
45
+ animationFillMode?: Observable<string> | string;
46
+ 'animation-fill-mode'?: Observable<string> | string;
47
+ animationName?: Observable<string> | string;
48
+ 'animation-name'?: Observable<string> | string;
49
+ animationTimingFunction?: Observable<string> | string;
50
+ 'animation-timing-function'?: Observable<string> | string;
51
+ backdropFilter?: Observable<string> | string;
52
+ 'backdrop-filter'?: Observable<string> | string;
53
+ background?: Observable<string> | string;
54
+ backgroundColor?: Observable<string> | string;
55
+ 'background-color'?: Observable<string> | string;
56
+ backgroundImage?: Observable<string> | string;
57
+ 'background-image'?: Observable<string> | string;
58
+ backgroundPosition?: Observable<string> | string;
59
+ 'background-position'?: Observable<string> | string;
60
+ backgroundSize?: Observable<string> | string;
61
+ 'background-size'?: Observable<string> | string;
62
+ border?: Observable<string> | string;
63
+ borderColor?: Observable<string> | string;
64
+ 'border-color'?: Observable<string> | string;
65
+ borderRadius?: Observable<string> | string;
66
+ 'border-radius'?: Observable<string> | string;
67
+ borderStyle?: Observable<string> | string;
68
+ 'border-style'?: Observable<string> | string;
69
+ borderWidth?: Observable<string> | string;
70
+ 'border-width'?: Observable<string> | string;
71
+ bottom?: Observable<string> | string;
72
+ boxShadow?: Observable<string> | string;
73
+ 'box-shadow'?: Observable<string> | string;
74
+ boxSizing?: Observable<'border-box' | 'content-box' | string> | 'border-box' | 'content-box' | string;
75
+ 'box-sizing'?: Observable<'border-box' | 'content-box' | string> | 'border-box' | 'content-box' | string;
76
+ color?: Observable<string> | string;
77
+ cursor?: Observable<string> | string;
78
+ display?: Observable<'block' | 'inline' | 'inline-block' | 'flex' | 'inline-flex' | 'grid' | 'inline-grid' | 'none' | 'contents' | string> | string;
79
+ filter?: Observable<string> | string;
80
+ flex?: Observable<string> | string;
81
+ flexDirection?: Observable<'row' | 'row-reverse' | 'column' | 'column-reverse'> | 'row' | 'row-reverse' | 'column' | 'column-reverse';
82
+ 'flex-direction'?: Observable<'row' | 'row-reverse' | 'column' | 'column-reverse'> | 'row' | 'row-reverse' | 'column' | 'column-reverse';
83
+ flexGrow?: Observable<string | number> | string | number;
84
+ 'flex-grow'?: Observable<string | number> | string | number;
85
+ flexShrink?: Observable<string | number> | string | number;
86
+ 'flex-shrink'?: Observable<string | number> | string | number;
87
+ flexWrap?: Observable<'nowrap' | 'wrap' | 'wrap-reverse'> | 'nowrap' | 'wrap' | 'wrap-reverse';
88
+ 'flex-wrap'?: Observable<'nowrap' | 'wrap' | 'wrap-reverse'> | 'nowrap' | 'wrap' | 'wrap-reverse';
89
+ font?: Observable<string> | string;
90
+ fontFamily?: Observable<string> | string;
91
+ 'font-family'?: Observable<string> | string;
92
+ fontSize?: Observable<string> | string;
93
+ 'font-size'?: Observable<string> | string;
94
+ fontWeight?: Observable<string | number> | string | number;
95
+ 'font-weight'?: Observable<string | number> | string | number;
96
+ gap?: Observable<string> | string;
97
+ grid?: Observable<string> | string;
98
+ gridColumn?: Observable<string> | string;
99
+ 'grid-column'?: Observable<string> | string;
100
+ gridRow?: Observable<string> | string;
101
+ 'grid-row'?: Observable<string> | string;
102
+ gridTemplateColumns?: Observable<string> | string;
103
+ 'grid-template-columns'?: Observable<string> | string;
104
+ gridTemplateRows?: Observable<string> | string;
105
+ 'grid-template-rows'?: Observable<string> | string;
106
+ height?: Observable<string> | string;
107
+ justifyContent?: Observable<string> | string;
108
+ 'justify-content'?: Observable<string> | string;
109
+ justifyItems?: Observable<string> | string;
110
+ 'justify-items'?: Observable<string> | string;
111
+ justifySelf?: Observable<string> | string;
112
+ 'justify-self'?: Observable<string> | string;
113
+ left?: Observable<string> | string;
114
+ letterSpacing?: Observable<string> | string;
115
+ 'letter-spacing'?: Observable<string> | string;
116
+ lineHeight?: Observable<string> | string;
117
+ 'line-height'?: Observable<string> | string;
118
+ margin?: Observable<string> | string;
119
+ marginBottom?: Observable<string> | string;
120
+ 'margin-bottom'?: Observable<string> | string;
121
+ marginLeft?: Observable<string> | string;
122
+ 'margin-left'?: Observable<string> | string;
123
+ marginRight?: Observable<string> | string;
124
+ 'margin-right'?: Observable<string> | string;
125
+ marginTop?: Observable<string> | string;
126
+ 'margin-top'?: Observable<string> | string;
127
+ maxHeight?: Observable<string> | string;
128
+ 'max-height'?: Observable<string> | string;
129
+ maxWidth?: Observable<string> | string;
130
+ 'max-width'?: Observable<string> | string;
131
+ minHeight?: Observable<string> | string;
132
+ 'min-height'?: Observable<string> | string;
133
+ minWidth?: Observable<string> | string;
134
+ 'min-width'?: Observable<string> | string;
135
+ objectFit?: Observable<'fill' | 'contain' | 'cover' | 'none' | 'scale-down'> | string;
136
+ 'object-fit'?: Observable<'fill' | 'contain' | 'cover' | 'none' | 'scale-down'> | string;
137
+ opacity?: Observable<string | number> | string | number;
138
+ overflow?: Observable<'visible' | 'hidden' | 'scroll' | 'auto' | string> | string;
139
+ overflowX?: Observable<string> | string;
140
+ 'overflow-x'?: Observable<string> | string;
141
+ overflowY?: Observable<string> | string;
142
+ 'overflow-y'?: Observable<string> | string;
143
+ padding?: Observable<string> | string;
144
+ paddingBottom?: Observable<string> | string;
145
+ 'padding-bottom'?: Observable<string> | string;
146
+ paddingLeft?: Observable<string> | string;
147
+ 'padding-left'?: Observable<string> | string;
148
+ paddingRight?: Observable<string> | string;
149
+ 'padding-right'?: Observable<string> | string;
150
+ paddingTop?: Observable<string> | string;
151
+ 'padding-top'?: Observable<string> | string;
152
+ pointerEvents?: Observable<'none' | 'auto' | string> | string;
153
+ 'pointer-events'?: Observable<'none' | 'auto' | string> | string;
154
+ position?: Observable<'static' | 'relative' | 'absolute' | 'fixed' | 'sticky'> | string;
155
+ right?: Observable<string> | string;
156
+ textAlign?: Observable<'left' | 'right' | 'center' | 'justify' | string> | string;
157
+ 'text-align'?: Observable<string> | string;
158
+ textDecoration?: Observable<string> | string;
159
+ 'text-decoration'?: Observable<string> | string;
160
+ textOverflow?: Observable<'clip' | 'ellipsis' | string> | string;
161
+ 'text-overflow'?: Observable<string> | string;
162
+ textTransform?: Observable<'none' | 'capitalize' | 'uppercase' | 'lowercase' | string> | string;
163
+ 'text-transform'?: Observable<string> | string;
164
+ top?: Observable<string> | string;
165
+ transform?: Observable<string> | string;
166
+ transformOrigin?: Observable<string> | string;
167
+ 'transform-origin'?: Observable<string> | string;
168
+ transition?: Observable<string> | string;
169
+ userSelect?: Observable<'none' | 'auto' | 'text' | 'all' | string> | string;
170
+ 'user-select'?: Observable<string> | string;
171
+ verticalAlign?: Observable<string> | string;
172
+ 'vertical-align'?: Observable<string> | string;
173
+ visibility?: Observable<'visible' | 'hidden' | 'collapse'> | string;
174
+ whiteSpace?: Observable<string> | string;
175
+ 'white-space'?: Observable<string> | string;
176
+ width?: Observable<string> | string;
177
+ wordBreak?: Observable<string> | string;
178
+ 'word-break'?: Observable<string> | string;
179
+ wordSpacing?: Observable<string> | string;
180
+ 'word-spacing'?: Observable<string> | string;
181
+ zIndex?: Observable<string | number> | string | number;
182
+ 'z-index'?: Observable<string | number> | string | number;
183
+ [key: string]: Observable<string | number> | string | number | undefined;
184
+ }
185
+
186
+ // ---------------------------------------------------------
187
+ // ARIA attributes
188
+ // ---------------------------------------------------------
189
+
190
+ /** All aria-* attributes as a typed map */
191
+ export interface NdAriaAttributes {
192
+ 'aria-label'?: Observable<string> | string;
193
+ 'aria-labelledby'?: string;
194
+ 'aria-describedby'?: string;
195
+ 'aria-hidden'?: Observable<boolean | 'true' | 'false'> | boolean | 'true' | 'false';
196
+ 'aria-expanded'?: Observable<boolean | 'true' | 'false'> | boolean | 'true' | 'false';
197
+ 'aria-selected'?: Observable<boolean | 'true' | 'false'> | boolean | 'true' | 'false';
198
+ 'aria-checked'?: Observable<boolean | 'true' | 'false' | 'mixed'> | boolean | string;
199
+ 'aria-disabled'?: Observable<boolean | 'true' | 'false'> | boolean | 'true' | 'false';
200
+ 'aria-required'?: Observable<boolean | 'true' | 'false'> | boolean | 'true' | 'false';
201
+ 'aria-invalid'?: Observable<boolean | 'true' | 'false' | 'grammar' | 'spelling'> | boolean | string;
202
+ 'aria-live'?: 'off' | 'polite' | 'assertive';
203
+ 'aria-atomic'?: Observable<boolean | 'true' | 'false'> | boolean | 'true' | 'false';
204
+ 'aria-relevant'?: string;
205
+ 'aria-current'?: Observable<boolean | 'true' | 'false' | 'page' | 'step' | 'location' | 'date' | 'time'> | boolean | string;
206
+ 'aria-controls'?: string;
207
+ 'aria-owns'?: string;
208
+ 'aria-haspopup'?: boolean | 'false' | 'true' | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
209
+ 'aria-autocomplete'?: 'none' | 'inline' | 'list' | 'both';
210
+ 'aria-multiline'?: Observable<boolean | 'true' | 'false'> | boolean;
211
+ 'aria-multiselectable'?: Observable<boolean | 'true' | 'false'> | boolean;
212
+ 'aria-orientation'?: 'horizontal' | 'vertical';
213
+ 'aria-placeholder'?: string;
214
+ 'aria-readonly'?: Observable<boolean | 'true' | 'false'> | boolean;
215
+ 'aria-sort'?: 'none' | 'ascending' | 'descending' | 'other';
216
+ 'aria-valuemax'?: number;
217
+ 'aria-valuemin'?: number;
218
+ 'aria-valuenow'?: number;
219
+ 'aria-valuetext'?: string;
220
+ 'aria-rowcount'?: number;
221
+ 'aria-rowindex'?: number;
222
+ 'aria-rowspan'?: number;
223
+ 'aria-colcount'?: number;
224
+ 'aria-colindex'?: number;
225
+ 'aria-colspan'?: number;
226
+ 'aria-setsize'?: number;
227
+ 'aria-posinset'?: number;
228
+ 'aria-level'?: number;
229
+ 'aria-modal'?: Observable<boolean | 'true' | 'false'> | boolean;
230
+ [key: `aria-${string}`]: Observable<string | boolean | number> | string | boolean | number | undefined;
231
+ }
232
+
233
+ /** data-* attributes as a typed map */
234
+ export interface NdDataAttributes {
235
+ [key: `data-${string}`]: string | number | boolean | undefined;
236
+ }
237
+
238
+ // ---------------------------------------------------------
239
+ // Global HTML attributes
240
+ // ---------------------------------------------------------
241
+
242
+ /**
243
+ * All standard HTML global attributes accepted by NativeDocument elements.
244
+ * Supports both reactive (ObservableItem) and static values.
245
+ */
246
+ export interface GlobalAttributes extends NdAriaAttributes, NdDataAttributes {
247
+ id?: Observable<string> | string;
248
+ class?: Observable<string | NdClassMap> | string | NdClassMap;
249
+ style?: Observable<NdStyleMap | string> | NdStyleMap | string;
250
+ title?: Observable<string> | string;
251
+ lang?: string;
252
+ dir?: 'ltr' | 'rtl' | 'auto';
253
+ hidden?: Observable<boolean> | boolean;
254
+ draggable?: Observable<boolean> | boolean;
255
+ contenteditable?: Observable<boolean> | boolean;
256
+ contentEditable?: Observable<boolean> | boolean;
257
+ tabindex?: Observable<string | number> | string | number;
258
+ tabIndex?: Observable<string | number> | string | number;
259
+ accesskey?: string;
260
+ accessKey?: string;
261
+ spellcheck?: Observable<boolean> | boolean;
262
+ spellCheck?: Observable<boolean> | boolean;
263
+ role?: | 'alert' | 'alertdialog' | 'application' | 'article' | 'banner'
264
+ | 'button' | 'cell' | 'checkbox' | 'columnheader' | 'combobox'
265
+ | 'complementary' | 'contentinfo' | 'definition' | 'dialog'
266
+ | 'document' | 'feed' | 'figure' | 'form' | 'grid' | 'gridcell'
267
+ | 'group' | 'heading' | 'img' | 'link' | 'list' | 'listbox'
268
+ | 'listitem' | 'log' | 'main' | 'math' | 'menu' | 'menubar'
269
+ | 'menuitem' | 'menuitemcheckbox' | 'menuitemradio' | 'navigation'
270
+ | 'none' | 'note' | 'option' | 'presentation' | 'progressbar'
271
+ | 'radio' | 'radiogroup' | 'region' | 'row' | 'rowgroup'
272
+ | 'rowheader' | 'scrollbar' | 'search' | 'searchbox' | 'separator'
273
+ | 'slider' | 'spinbutton' | 'status' | 'switch' | 'tab' | 'table'
274
+ | 'tablist' | 'tabpanel' | 'term' | 'textbox' | 'timer' | 'toolbar'
275
+ | 'tooltip' | 'tree' | 'treegrid' | 'treeitem' | string;
276
+ [key: string]: unknown;
277
+ }
278
+
279
+ // ---------------------------------------------------------
280
+ // Form shared attributes
281
+ // ---------------------------------------------------------
282
+
283
+ export interface SharedFormAttributes {
284
+ name?: string;
285
+ disabled?: Observable<boolean> | boolean;
286
+ required?: Observable<boolean> | boolean;
287
+ autofocus?: Observable<boolean> | boolean;
288
+ autoFocus?: Observable<boolean> | boolean;
289
+ form?: string;
290
+ }
291
+
292
+ // ---------------------------------------------------------
293
+ // Element-specific attribute interfaces
294
+ // ---------------------------------------------------------
295
+
296
+ export interface AnchorAttributes extends GlobalAttributes {
297
+ href?: Observable<string> | string;
298
+ target?: '_blank' | '_self' | '_parent' | '_top' | string;
299
+ rel?: string;
300
+ download?: Observable<boolean | string> | boolean | string;
301
+ hreflang?: string;
302
+ hrefLang?: string;
303
+ type?: string;
304
+ referrerpolicy?: string;
305
+ referrerPolicy?: string;
306
+ }
307
+
308
+ export interface ImgAttributes extends GlobalAttributes {
309
+ src?: Observable<string> | string;
310
+ alt?: Observable<string> | string;
311
+ width?: Observable<string | number> | string | number;
312
+ height?: Observable<string | number> | string | number;
313
+ loading?: 'lazy' | 'eager' | 'auto';
314
+ decoding?: 'async' | 'sync' | 'auto';
315
+ srcset?: string;
316
+ srcSet?: string;
317
+ sizes?: string;
318
+ crossorigin?: 'anonymous' | 'use-credentials';
319
+ crossOrigin?: 'anonymous' | 'use-credentials';
320
+ referrerpolicy?: string;
321
+ referrerPolicy?: string;
322
+ }
323
+
324
+ export interface ButtonAttributes extends GlobalAttributes, SharedFormAttributes {
325
+ type?: 'button' | 'submit' | 'reset';
326
+ value?: string;
327
+ }
328
+
329
+ export interface InputAttributes extends GlobalAttributes, SharedFormAttributes {
330
+ type?: 'text' | 'password' | 'email' | 'number' | 'tel' | 'url' | 'search'
331
+ | 'date' | 'time' | 'datetime-local' | 'month' | 'week' | 'color'
332
+ | 'checkbox' | 'radio' | 'file' | 'range' | 'hidden' | 'submit'
333
+ | 'reset' | 'button' | 'image' | string;
334
+ value?: Observable<string | number | boolean> | string | number | boolean;
335
+ checked?: Observable<boolean> | boolean;
336
+ placeholder?: Observable<string> | string;
337
+ readonly?: Observable<boolean> | boolean;
338
+ readOnly?: Observable<boolean> | boolean;
339
+ min?: string | number;
340
+ max?: string | number;
341
+ step?: string | number;
342
+ minlength?: number;
343
+ minLength?: number;
344
+ maxlength?: number;
345
+ maxLength?: number;
346
+ multiple?: Observable<boolean> | boolean;
347
+ accept?: string;
348
+ autocomplete?: string;
349
+ autoComplete?: string;
350
+ list?: string;
351
+ pattern?: string;
352
+ size?: number;
353
+ }
354
+
355
+ export interface TextAreaAttributes extends GlobalAttributes, SharedFormAttributes {
356
+ placeholder?: Observable<string> | string;
357
+ readonly?: Observable<boolean> | boolean;
358
+ readOnly?: Observable<boolean> | boolean;
359
+ rows?: number;
360
+ cols?: number;
361
+ wrap?: 'hard' | 'soft' | 'off';
362
+ minlength?: number;
363
+ minLength?: number;
364
+ maxlength?: number;
365
+ maxLength?: number;
366
+ autocomplete?: string;
367
+ autoComplete?: string;
368
+ resize?: 'none' | 'horizontal' | 'vertical' | 'both';
369
+ }
370
+
371
+ export interface SelectAttributes extends GlobalAttributes, SharedFormAttributes {
372
+ multiple?: Observable<boolean> | boolean;
373
+ size?: number;
374
+ autocomplete?: string;
375
+ autoComplete?: string;
376
+ }
377
+
378
+ export interface OptionAttributes extends GlobalAttributes {
379
+ value?: string;
380
+ selected?: Observable<boolean> | boolean;
381
+ disabled?: Observable<boolean> | boolean;
382
+ label?: string;
383
+ }
384
+
385
+ export interface FormAttributes extends GlobalAttributes, SharedFormAttributes {
386
+ action?: string;
387
+ method?: 'get' | 'post' | 'dialog';
388
+ enctype?: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
389
+ target?: '_blank' | '_self' | '_parent' | '_top' | string;
390
+ novalidate?: Observable<boolean> | boolean;
391
+ noValidate?: Observable<boolean> | boolean;
392
+ autocomplete?: 'on' | 'off';
393
+ autoComplete?: 'on' | 'off';
394
+ }
395
+
396
+ export interface VideoAttributes extends GlobalAttributes {
397
+ src?: Observable<string> | string;
398
+ controls?: Observable<boolean> | boolean;
399
+ autoplay?: Observable<boolean> | boolean;
400
+ autoPlay?: Observable<boolean> | boolean;
401
+ loop?: Observable<boolean> | boolean;
402
+ muted?: Observable<boolean> | boolean;
403
+ poster?: string;
404
+ preload?: 'none' | 'metadata' | 'auto';
405
+ playsinline?: Observable<boolean> | boolean;
406
+ playsInline?: Observable<boolean> | boolean;
407
+ width?: Observable<string | number> | string | number;
408
+ height?: Observable<string | number> | string | number;
409
+ crossorigin?: 'anonymous' | 'use-credentials';
410
+ crossOrigin?: 'anonymous' | 'use-credentials';
411
+ }
412
+
413
+ export interface AudioAttributes extends GlobalAttributes {
414
+ src?: Observable<string> | string;
415
+ controls?: Observable<boolean> | boolean;
416
+ autoplay?: Observable<boolean> | boolean;
417
+ autoPlay?: Observable<boolean> | boolean;
418
+ loop?: Observable<boolean> | boolean;
419
+ muted?: Observable<boolean> | boolean;
420
+ preload?: 'none' | 'metadata' | 'auto';
421
+ crossorigin?: 'anonymous' | 'use-credentials';
422
+ crossOrigin?: 'anonymous' | 'use-credentials';
423
+ }
424
+
425
+ export interface CanvasAttributes extends GlobalAttributes {
426
+ width?: Observable<string | number> | string | number;
427
+ height?: Observable<string | number> | string | number;
428
+ }
429
+
430
+ export interface DetailsAttributes extends GlobalAttributes {
431
+ open?: Observable<boolean> | boolean;
432
+ }
433
+
434
+ export interface DialogAttributes extends GlobalAttributes {
435
+ open?: Observable<boolean> | boolean;
436
+ }
437
+
438
+ export interface ProgressAttributes extends GlobalAttributes {
439
+ value?: Observable<string | number> | string | number;
440
+ max?: Observable<string | number> | string | number;
441
+ }
442
+
443
+ export interface MeterAttributes extends GlobalAttributes {
444
+ value?: number;
445
+ min?: number;
446
+ max?: number;
447
+ low?: number;
448
+ high?: number;
449
+ optimum?: number;
450
+ }
451
+
452
+ export interface SourceAttributes extends GlobalAttributes {
453
+ src?: Observable<string> | string;
454
+ srcset?: string;
455
+ srcSet?: string;
456
+ type?: string;
457
+ media?: string;
458
+ sizes?: string;
459
+ }
460
+
461
+ export interface TrackAttributes extends GlobalAttributes {
462
+ src?: string;
463
+ kind?: 'subtitles' | 'captions' | 'descriptions' | 'chapters' | 'metadata';
464
+ srclang?: string;
465
+ srcLang?: string;
466
+ label?: string;
467
+ default?: boolean;
468
+ }
469
+
470
+ export interface ThAttributes extends GlobalAttributes {
471
+ colspan?: number;
472
+ colSpan?: number;
473
+ rowspan?: number;
474
+ rowSpan?: number;
475
+ headers?: string;
476
+ scope?: 'col' | 'row' | 'colgroup' | 'rowgroup';
477
+ }
478
+
479
+ export interface TdAttributes extends GlobalAttributes {
480
+ colspan?: number;
481
+ colSpan?: number;
482
+ rowspan?: number;
483
+ rowSpan?: number;
484
+ headers?: string;
485
+ }
486
+
487
+ export interface LabelAttributes extends GlobalAttributes {
488
+ for?: string;
489
+ htmlFor?: string;
490
+ }
491
+
492
+ export interface OutputAttributes extends GlobalAttributes, SharedFormAttributes {
493
+ for?: string;
494
+ htmlFor?: string;
495
+ }
496
+
497
+ export interface TimeAttributes extends GlobalAttributes {
498
+ datetime?: string;
499
+ dateTime?: string;
500
+ }
501
+
502
+ export interface ModAttributes extends GlobalAttributes {
503
+ cite?: string;
504
+ datetime?: string;
505
+ dateTime?: string;
506
+ }
507
+
508
+ export interface OlAttributes extends GlobalAttributes {
509
+ reversed?: Observable<boolean> | boolean;
510
+ start?: number;
511
+ type?: '1' | 'a' | 'A' | 'i' | 'I';
512
+ }
513
+
514
+ export interface SvgAttributes extends GlobalAttributes {
515
+ viewBox?: string;
516
+ viewbox?: string;
517
+ xmlns?: string;
518
+ width?: Observable<string | number> | string | number;
519
+ height?: Observable<string | number> | string | number;
520
+ fill?: Observable<string> | string;
521
+ stroke?: Observable<string> | string;
522
+ strokeWidth?: Observable<string | number> | string | number;
523
+ 'stroke-width'?: Observable<string | number> | string | number;
524
+ strokeLinecap?: 'butt' | 'round' | 'square';
525
+ 'stroke-linecap'?: 'butt' | 'round' | 'square';
526
+ strokeLinejoin?: 'miter' | 'round' | 'bevel';
527
+ 'stroke-linejoin'?: 'miter' | 'round' | 'bevel';
528
+ preserveAspectRatio?: string;
529
+ d?: string;
530
+ cx?: Observable<string | number> | string | number;
531
+ cy?: Observable<string | number> | string | number;
532
+ r?: Observable<string | number> | string | number;
533
+ rx?: Observable<string | number> | string | number;
534
+ ry?: Observable<string | number> | string | number;
535
+ x?: Observable<string | number> | string | number;
536
+ y?: Observable<string | number> | string | number;
537
+ x1?: Observable<string | number> | string | number;
538
+ y1?: Observable<string | number> | string | number;
539
+ x2?: Observable<string | number> | string | number;
540
+ y2?: Observable<string | number> | string | number;
541
+ points?: string;
542
+ transform?: Observable<string> | string;
543
+ }
package/types/images.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  // Image components type definitions
2
- import { ElementFunctionNoChildren, NdHTMLElement } from './elements';
3
- import { ImgAttributes } from './elements';
2
+ import type { ElementFunctionNoChildren, NdHTMLElement } from './elements';
3
+ import type { ImgAttributes } from './globals';
4
4
  import { ObservableItem } from "./observable";
5
5
 
6
6
  export declare const BaseImage: ElementFunctionNoChildren<ImgAttributes, HTMLImageElement>;
@@ -0,0 +1,3 @@
1
+ import { ObservableItem, ObservableChecker, ObservableResourceConfig, ObservableResource } from './observable';
2
+
3
+ export type { ObservableResource, ObservableResourceConfig };