@fibrae/semi-ui-svelte 0.2.0 → 0.3.1

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 (288) hide show
  1. package/LICENSE +0 -62
  2. package/README.md +40 -38
  3. package/README.zh-CN.md +91 -0
  4. package/dist/_base/create-context.js +0 -1
  5. package/dist/_base/css-animation.js +0 -1
  6. package/dist/_base/group-role.d.ts +0 -1
  7. package/dist/_base/group-role.js +0 -1
  8. package/dist/_base/slot-kind.d.ts +0 -1
  9. package/dist/_base/slot-kind.js +0 -1
  10. package/dist/_base/teleport.d.ts +0 -2
  11. package/dist/_base/teleport.js +0 -2
  12. package/dist/_base/use-click-outside.svelte.d.ts +2 -2
  13. package/dist/_base/use-click-outside.svelte.js +2 -2
  14. package/dist/_base/use-foundation.svelte.js +2 -5
  15. package/dist/_base/virtual-list.svelte +2 -3
  16. package/dist/_base/virtual-list.svelte.d.ts +0 -1
  17. package/dist/_sortable/interface.d.ts +0 -1
  18. package/dist/anchor/interface.d.ts +0 -3
  19. package/dist/anchor/link-item.svelte +0 -1
  20. package/dist/anchor/links.d.ts +0 -1
  21. package/dist/anchor/links.js +0 -1
  22. package/dist/audio-player/audio-player.svelte +0 -2
  23. package/dist/audio-player/audio-slider.svelte +0 -3
  24. package/dist/auto-complete/auto-complete.svelte +0 -5
  25. package/dist/auto-complete/interface.d.ts +0 -9
  26. package/dist/avatar/avatar-group-more.svelte +0 -1
  27. package/dist/avatar/avatar.svelte +0 -4
  28. package/dist/avatar/context.d.ts +0 -1
  29. package/dist/avatar/interface.d.ts +0 -4
  30. package/dist/backtop/backtop.svelte +0 -2
  31. package/dist/backtop/interface.d.ts +0 -1
  32. package/dist/badge/interface.d.ts +0 -1
  33. package/dist/banner/banner.svelte +1 -1
  34. package/dist/banner/interface.d.ts +1 -3
  35. package/dist/breadcrumb/breadcrumb-item.svelte +0 -1
  36. package/dist/breadcrumb/breadcrumb.svelte +0 -1
  37. package/dist/breadcrumb/interface.d.ts +0 -7
  38. package/dist/calendar/calendar.svelte +0 -1
  39. package/dist/calendar/day-calendar.svelte +0 -3
  40. package/dist/calendar/interface.d.ts +0 -8
  41. package/dist/calendar/month-calendar.svelte +0 -4
  42. package/dist/calendar/time-grid.svelte +0 -2
  43. package/dist/calendar/time-grid.svelte.d.ts +0 -1
  44. package/dist/calendar/use-today.svelte.d.ts +0 -1
  45. package/dist/calendar/use-today.svelte.js +0 -1
  46. package/dist/card/index.js +0 -1
  47. package/dist/card/interface.d.ts +0 -3
  48. package/dist/carousel/carousel.svelte +0 -4
  49. package/dist/carousel/interface.d.ts +0 -3
  50. package/dist/cascader/cascader.svelte +0 -6
  51. package/dist/cascader/interface.d.ts +0 -19
  52. package/dist/cascader/item.svelte +0 -4
  53. package/dist/cascader/item.svelte.d.ts +0 -4
  54. package/dist/checkbox/checkbox-group.svelte +0 -3
  55. package/dist/checkbox/checkbox.svelte +0 -4
  56. package/dist/checkbox/index.js +0 -1
  57. package/dist/checkbox/interface.d.ts +0 -1
  58. package/dist/code-highlight/interface.d.ts +0 -1
  59. package/dist/collapse/collapse.svelte +0 -2
  60. package/dist/collapse/index.js +0 -1
  61. package/dist/collapse/interface.d.ts +0 -2
  62. package/dist/collapse/panel.svelte +0 -1
  63. package/dist/collapsible/collapsible.svelte +0 -2
  64. package/dist/color-picker/alpha-slider.svelte +0 -1
  65. package/dist/color-picker/color-choose-area.svelte +0 -1
  66. package/dist/color-picker/color-slider.svelte +0 -1
  67. package/dist/color-picker/data-part.svelte +0 -1
  68. package/dist/cropper/cropper.svelte +0 -1
  69. package/dist/cropper/interface.d.ts +0 -6
  70. package/dist/date-picker/date-input.svelte +0 -4
  71. package/dist/date-picker/date-picker.svelte +0 -7
  72. package/dist/date-picker/inset-input.svelte +0 -1
  73. package/dist/date-picker/interface.d.ts +0 -7
  74. package/dist/date-picker/internal.d.ts +0 -7
  75. package/dist/date-picker/month.svelte +0 -1
  76. package/dist/date-picker/months-grid.svelte +0 -6
  77. package/dist/date-picker/navigation.svelte +0 -1
  78. package/dist/descriptions/interface.d.ts +0 -1
  79. package/dist/divider/divider.svelte +0 -1
  80. package/dist/divider/interface.d.ts +0 -4
  81. package/dist/drag-move/drag-move.js +0 -1
  82. package/dist/drag-move/interface.d.ts +0 -3
  83. package/dist/dropdown/context.d.ts +0 -6
  84. package/dist/dropdown/context.js +0 -1
  85. package/dist/dropdown/dropdown-item.svelte +0 -1
  86. package/dist/dropdown/dropdown.svelte +0 -7
  87. package/dist/dropdown/interface.d.ts +0 -4
  88. package/dist/empty/empty.svelte +0 -1
  89. package/dist/empty/interface.d.ts +0 -3
  90. package/dist/feedback/feedback.svelte +0 -1
  91. package/dist/feedback/interface.d.ts +0 -8
  92. package/dist/float-button/float-button-action.svelte +0 -2
  93. package/dist/float-button/interface.d.ts +0 -2
  94. package/dist/form/array-field.svelte +0 -2
  95. package/dist/form/context.d.ts +0 -2
  96. package/dist/form/error-message.svelte +0 -1
  97. package/dist/form/field-grid.svelte +0 -2
  98. package/dist/form/field-grid.svelte.d.ts +0 -2
  99. package/dist/form/field-inner.svelte +0 -2
  100. package/dist/form/field.svelte +0 -1
  101. package/dist/form/form.svelte +0 -1
  102. package/dist/form/hooks.d.ts +1 -2
  103. package/dist/form/hooks.js +1 -2
  104. package/dist/form/interface.d.ts +0 -7
  105. package/dist/form/utils.d.ts +0 -1
  106. package/dist/form/utils.js +0 -2
  107. package/dist/highlight/interface.d.ts +0 -1
  108. package/dist/hot-keys/interface.d.ts +0 -1
  109. package/dist/image/context.d.ts +0 -1
  110. package/dist/image/footer.d.ts +0 -1
  111. package/dist/image/interface.d.ts +0 -8
  112. package/dist/image/preview-image.svelte +0 -3
  113. package/dist/image/preview-image.svelte.d.ts +0 -1
  114. package/dist/image/preview-inner.svelte +0 -3
  115. package/dist/image/preview-inner.svelte.d.ts +0 -1
  116. package/dist/input/context.d.ts +0 -1
  117. package/dist/input/interface.d.ts +0 -3
  118. package/dist/input/textarea.svelte +0 -3
  119. package/dist/input-number/input-number.svelte +0 -2
  120. package/dist/input-number/interface.d.ts +0 -1
  121. package/dist/json-viewer/interface.d.ts +0 -4
  122. package/dist/json-viewer/json-viewer.svelte +0 -3
  123. package/dist/layout/interface.d.ts +0 -2
  124. package/dist/list/interface.d.ts +0 -2
  125. package/dist/lottie/interface.d.ts +1 -1
  126. package/dist/markdown-render/code-text.js +0 -1
  127. package/dist/markdown-render/components/code.svelte +0 -1
  128. package/dist/markdown-render/components/heading.svelte +0 -1
  129. package/dist/markdown-render/components/p.svelte +0 -1
  130. package/dist/markdown-render/components/table.svelte +0 -1
  131. package/dist/markdown-render/components/tree.d.ts +0 -4
  132. package/dist/markdown-render/components/tree.js +0 -2
  133. package/dist/markdown-render/interface.d.ts +0 -1
  134. package/dist/markdown-render/markdown-children.svelte +0 -2
  135. package/dist/markdown-render/markdown-render.svelte +0 -1
  136. package/dist/markdown-render/runtime.js +0 -1
  137. package/dist/modal/confirm-modal.svelte +0 -1
  138. package/dist/modal/confirm.svelte.d.ts +0 -1
  139. package/dist/modal/confirm.svelte.js +0 -1
  140. package/dist/modal/index.js +0 -1
  141. package/dist/modal/interface.d.ts +0 -6
  142. package/dist/modal/modal-content.svelte +0 -4
  143. package/dist/modal/modal.svelte +0 -1
  144. package/dist/modal/use-show-hide.svelte.d.ts +0 -2
  145. package/dist/modal/use-show-hide.svelte.js +0 -4
  146. package/dist/navigation/context.d.ts +0 -2
  147. package/dist/navigation/index.js +0 -1
  148. package/dist/navigation/interface.d.ts +1 -17
  149. package/dist/navigation/item-shell.svelte +0 -4
  150. package/dist/navigation/item-shell.svelte.d.ts +0 -3
  151. package/dist/navigation/nav-footer.svelte +0 -2
  152. package/dist/navigation/nav-items.svelte +0 -1
  153. package/dist/navigation/nav.svelte +0 -1
  154. package/dist/navigation/sub-nav.svelte +0 -5
  155. package/dist/navigation/wrapper-outlet.svelte +0 -1
  156. package/dist/notification/context.d.ts +0 -3
  157. package/dist/notification/interface.d.ts +0 -5
  158. package/dist/notification/notice-list.svelte +0 -2
  159. package/dist/notification/notice-list.svelte.d.ts +0 -1
  160. package/dist/notification/notice.svelte +0 -2
  161. package/dist/notification/notification-list.svelte +0 -1
  162. package/dist/notification/static-api.js +0 -1
  163. package/dist/overflow-list/interface.d.ts +0 -2
  164. package/dist/overflow-list/overflow-list.svelte +0 -2
  165. package/dist/pagination/interface.d.ts +0 -1
  166. package/dist/pagination/pagination.svelte +0 -2
  167. package/dist/pagination/step-button.svelte +0 -3
  168. package/dist/pagination/step-button.svelte.d.ts +0 -1
  169. package/dist/pincode/interface.d.ts +0 -1
  170. package/dist/pincode/pincode.svelte +0 -3
  171. package/dist/popconfirm/interface.d.ts +0 -1
  172. package/dist/popconfirm/popconfirm.svelte +0 -2
  173. package/dist/popover/interface.d.ts +0 -1
  174. package/dist/popover/popover.svelte +0 -1
  175. package/dist/radio/index.js +0 -1
  176. package/dist/radio/radio-group.svelte +0 -1
  177. package/dist/radio/radio.svelte +0 -1
  178. package/dist/rating/interface.d.ts +0 -2
  179. package/dist/rating/item.svelte +0 -1
  180. package/dist/rating/rating.svelte +0 -7
  181. package/dist/resizable/interface.d.ts +0 -2
  182. package/dist/resizable/resizable.svelte +0 -1
  183. package/dist/resizable/resize-group.svelte +0 -1
  184. package/dist/resizable/resize-handler.svelte +0 -1
  185. package/dist/resize-observer/observe-resize.d.ts +1 -5
  186. package/dist/resize-observer/observe-resize.js +1 -5
  187. package/dist/scroll-list/index.js +0 -1
  188. package/dist/scroll-list/interface.d.ts +0 -2
  189. package/dist/scroll-list/scroll-item.svelte +0 -2
  190. package/dist/select/interface.d.ts +0 -14
  191. package/dist/select/option.svelte +0 -5
  192. package/dist/select/option.svelte.d.ts +0 -5
  193. package/dist/select/select.svelte +0 -14
  194. package/dist/side-sheet/interface.d.ts +0 -1
  195. package/dist/side-sheet/side-sheet.svelte +0 -9
  196. package/dist/skeleton/index.js +0 -1
  197. package/dist/skeleton/interface.d.ts +0 -2
  198. package/dist/skeleton/skeleton-item.svelte +0 -1
  199. package/dist/slider/interface.d.ts +0 -5
  200. package/dist/slider/slider.svelte +0 -7
  201. package/dist/space/interface.d.ts +0 -1
  202. package/dist/space/space.svelte +0 -1
  203. package/dist/steps/context.d.ts +0 -1
  204. package/dist/steps/interface.d.ts +0 -2
  205. package/dist/steps/step.svelte +0 -3
  206. package/dist/switch/switch.svelte +0 -2
  207. package/dist/table/body/base-row.svelte +0 -4
  208. package/dist/table/body/base-row.svelte.d.ts +0 -4
  209. package/dist/table/body/body.svelte +0 -7
  210. package/dist/table/body/body.svelte.d.ts +0 -5
  211. package/dist/table/body/expanded-row.svelte +0 -1
  212. package/dist/table/body/expanded-row.svelte.d.ts +0 -1
  213. package/dist/table/body/section-row.svelte +0 -2
  214. package/dist/table/body/section-row.svelte.d.ts +0 -2
  215. package/dist/table/column-filter-menu.svelte +0 -3
  216. package/dist/table/column-filter-menu.svelte.d.ts +0 -3
  217. package/dist/table/column-filter.svelte +0 -2
  218. package/dist/table/column-filter.svelte.d.ts +0 -2
  219. package/dist/table/column-selection.svelte +1 -2
  220. package/dist/table/column-selection.svelte.d.ts +0 -1
  221. package/dist/table/column-sorter.svelte +1 -6
  222. package/dist/table/column-sorter.svelte.d.ts +1 -6
  223. package/dist/table/context.d.ts +0 -10
  224. package/dist/table/context.js +0 -1
  225. package/dist/table/custom-expand-icon.svelte +0 -2
  226. package/dist/table/custom-expand-icon.svelte.d.ts +0 -2
  227. package/dist/table/head-table.svelte +0 -1
  228. package/dist/table/head-table.svelte.d.ts +0 -1
  229. package/dist/table/interface.d.ts +2 -21
  230. package/dist/table/table-cell.svelte +0 -7
  231. package/dist/table/table-cell.svelte.d.ts +0 -7
  232. package/dist/table/table-header-row.svelte +0 -2
  233. package/dist/table/table-header-row.svelte.d.ts +0 -2
  234. package/dist/table/table-pagination.svelte +0 -2
  235. package/dist/table/table-pagination.svelte.d.ts +0 -2
  236. package/dist/table/table.svelte +0 -5
  237. package/dist/table/utils.d.ts +1 -13
  238. package/dist/table/utils.js +1 -11
  239. package/dist/tabs/index.js +0 -1
  240. package/dist/tabs/interface.d.ts +0 -13
  241. package/dist/tabs/tab-bar.svelte +0 -3
  242. package/dist/tabs/tab-bar.svelte.d.ts +0 -1
  243. package/dist/tabs/tab-pane.svelte +0 -2
  244. package/dist/tabs/tabs.svelte +0 -1
  245. package/dist/tag-input/interface.d.ts +0 -5
  246. package/dist/tag-input/tag-input.svelte +0 -3
  247. package/dist/tag-input/tag-item.svelte +0 -1
  248. package/dist/tag-input/tag-item.svelte.d.ts +0 -1
  249. package/dist/time-picker/combobox.svelte +0 -1
  250. package/dist/time-picker/interface.d.ts +0 -9
  251. package/dist/time-picker/time-picker.svelte +0 -2
  252. package/dist/timeline/interface.d.ts +0 -4
  253. package/dist/timeline/timeline.svelte +0 -1
  254. package/dist/toast/context.d.ts +0 -2
  255. package/dist/toast/interface.d.ts +0 -2
  256. package/dist/toast/static-api.js +0 -1
  257. package/dist/toast/toast.svelte +0 -1
  258. package/dist/toast/use-toast.js +0 -1
  259. package/dist/tooltip/context.d.ts +0 -2
  260. package/dist/tooltip/interface.d.ts +0 -2
  261. package/dist/tooltip/tooltip.svelte +0 -5
  262. package/dist/transfer/interface.d.ts +1 -8
  263. package/dist/transfer/transfer-selected-item.svelte +0 -1
  264. package/dist/transfer/transfer-selected-item.svelte.d.ts +0 -1
  265. package/dist/transfer/transfer.svelte +0 -1
  266. package/dist/tree/auto-sizer.svelte +0 -1
  267. package/dist/tree/context.d.ts +0 -1
  268. package/dist/tree/interface.d.ts +0 -9
  269. package/dist/tree/node-collapsible.svelte +0 -1
  270. package/dist/tree/node-list.svelte +0 -4
  271. package/dist/tree/tree-node.svelte +0 -1
  272. package/dist/tree/tree.svelte +0 -3
  273. package/dist/tree/use-tree-keyboard.svelte.d.ts +1 -8
  274. package/dist/tree/use-tree-keyboard.svelte.js +1 -6
  275. package/dist/tree-select/interface.d.ts +0 -11
  276. package/dist/tree-select/tree-select.svelte +0 -2
  277. package/dist/typography/base.svelte +0 -2
  278. package/dist/typography/index.js +0 -1
  279. package/dist/typography/interface.d.ts +0 -1
  280. package/dist/typography/internal.d.ts +0 -2
  281. package/dist/upload/file-card.svelte +0 -1
  282. package/dist/upload/index.js +0 -1
  283. package/dist/upload/interface.d.ts +0 -4
  284. package/dist/upload/upload.svelte +0 -1
  285. package/dist/user-guide/interface.d.ts +0 -1
  286. package/dist/user-guide/user-guide.svelte +0 -1
  287. package/dist/video-player/video-progress.svelte +0 -2
  288. package/package.json +4 -4
@@ -29,7 +29,6 @@ export interface TransferVirtualize {
29
29
  itemSize: number;
30
30
  }
31
31
  export interface TransferPagination {
32
- /** Controlled page of the left list */
33
32
  currentPage?: number;
34
33
  defaultCurrentPage?: number;
35
34
  pageSize?: number;
@@ -63,7 +62,6 @@ export interface TransferProps extends Omit<HTMLAttributes<HTMLDivElement>, Nati
63
62
  inputProps?: TransferInputProps;
64
63
  /** treeList only; of the Tree's snippets only `label` is forwarded */
65
64
  treeProps?: TransferTreeProps;
66
- /** Pages the left list */
67
65
  pagination?: TransferPagination;
68
66
  /** Renders the selected list virtually; ignored while `draggable` */
69
67
  virtualize?: TransferVirtualize;
@@ -82,11 +80,9 @@ export interface TransferProps extends Omit<HTMLAttributes<HTMLDivElement>, Nati
82
80
  selectedHeader?: Snippet<[TransferSelectedHeaderSnippetProps]>;
83
81
  sourcePanel?: Snippet<[TransferSourcePanelSnippetProps]>;
84
82
  selectedPanel?: Snippet<[TransferSelectedPanelSnippetProps]>;
85
- /** No data; `false` hides the empty state */
83
+ /** `false` hides the empty state */
86
84
  emptyLeft?: Snippet | false;
87
- /** Nothing selected; `false` hides the empty state */
88
85
  emptyRight?: Snippet | false;
89
- /** The search matches nothing; `false` hides the empty state */
90
86
  emptySearch?: Snippet | false;
91
87
  }
92
88
  /** The methods on a Transfer instance from `bind:this` */
@@ -126,12 +122,10 @@ export interface TransferSelectedHeaderSnippetProps {
126
122
  onClear: () => void;
127
123
  }
128
124
  export interface TransferSourcePanelSnippetProps {
129
- /** The values of the selected items */
130
125
  value: TransferValue;
131
126
  loading?: boolean;
132
127
  /** Whether a search is on and matches nothing */
133
128
  noMatch: boolean;
134
- /** The items that match the search */
135
129
  filterData: TransferDataItem[];
136
130
  sourceData: TransferDataItem[];
137
131
  propsDataSource: TransferDataSource;
@@ -143,7 +137,6 @@ export interface TransferSourcePanelSnippetProps {
143
137
  /** Selects every shown item, or clears them when all are selected */
144
138
  onAllClick: () => void;
145
139
  onSelectOrRemove: (item: TransferDataItem) => void;
146
- /** Replaces the selection with the items of these values */
147
140
  onSelect: (values: TransferValue) => void;
148
141
  }
149
142
  export interface TransferSelectedPanelSnippetProps {
@@ -19,7 +19,6 @@
19
19
  }: {
20
20
  item: TransferDataItem;
21
21
  index: number;
22
- /** treeList with showPath: the text shown instead of the label */
23
22
  pathLabel?: string;
24
23
  disabled?: boolean;
25
24
  draggable: boolean;
@@ -3,7 +3,6 @@ import type { TransferDataItem, TransferLabelSnippetProps, TransferSelectedItemS
3
3
  type $$ComponentProps = {
4
4
  item: TransferDataItem;
5
5
  index: number;
6
- /** treeList with showPath: the text shown instead of the label */
7
6
  pathLabel?: string;
8
7
  disabled?: boolean;
9
8
  draggable: boolean;
@@ -122,7 +122,6 @@
122
122
  notifyBlur: (event) => onBlur?.(event),
123
123
  updateSelected: (selectedValues) => base.setState({ selectedValues }),
124
124
  notifyChange: (values, items) => {
125
- // the bindable prop is the source of truth: bound, the write reaches the parent; unbound, it overrides locally
126
125
  value = values;
127
126
  onChange?.(values, items as TransferDataItem[]);
128
127
  },
@@ -9,7 +9,6 @@
9
9
  children: Snippet<[{ height: number; width: number | string }]>;
10
10
  }
11
11
 
12
- /** Passes a pixel height to its snippet: `defaultHeight` when it is a number, else the parent's content height */
13
12
  let { defaultHeight, defaultWidth = '100%', children }: AutoSizerProps = $props();
14
13
 
15
14
  let wrapper = $state<HTMLDivElement>();
@@ -17,7 +17,6 @@ export interface TreeContextValue {
17
17
  onNodeCheck: (event: MouseEvent | KeyboardEvent, row: TreeRowProps) => void;
18
18
  onNodeRightClick?: (event: MouseEvent, row: TreeRowProps) => void;
19
19
  onNodeDoubleClick?: (event: MouseEvent, row: TreeRowProps) => void;
20
- /** The drag handlers get the row element as `nodeInstance` */
21
20
  onNodeDragStart?: (event: DragEvent, row: TreeRowProps) => void;
22
21
  onNodeDragEnter?: (event: DragEvent, row: TreeRowProps) => void;
23
22
  onNodeDragOver?: (event: DragEvent, row: TreeRowProps) => void;
@@ -41,7 +41,6 @@ export interface TreeScrollData {
41
41
  export interface TreeLabelSnippetProps {
42
42
  item: TreeNodeData;
43
43
  label?: string | number;
44
- /** The search keyword, empty while not searching */
45
44
  searchWord: string;
46
45
  }
47
46
  export interface TreeIconSnippetProps {
@@ -77,7 +76,6 @@ export interface TreeFullLabelSnippetProps {
77
76
  };
78
77
  filtered: boolean;
79
78
  searchWord: string;
80
- /** Selects the row, or checks it in a multiple tree */
81
79
  onClick: (event: MouseEvent) => void;
82
80
  onCheck: (event: MouseEvent) => void;
83
81
  onExpand: (event: MouseEvent) => void;
@@ -92,7 +90,6 @@ export interface TreeSearchSnippetProps {
92
90
  onChange: (value: string) => void;
93
91
  }
94
92
  export interface TreeDraggingNodeSnippetProps {
95
- /** The dragged row element */
96
93
  nodeInstance: HTMLElement;
97
94
  node: TreeNodeData;
98
95
  }
@@ -124,7 +121,6 @@ export interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, NativeKe
124
121
  loadedKeys?: string[];
125
122
  motion?: boolean;
126
123
  multiple?: boolean;
127
- /** `onChange` reports the nodes instead of their values */
128
124
  onChangeWithObject?: boolean;
129
125
  showClear?: boolean;
130
126
  showFilteredOnly?: boolean;
@@ -152,7 +148,6 @@ export interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, NativeKe
152
148
  onDragLeave?: (info: TreeDragProps) => void;
153
149
  onDragEnd?: (info: TreeDragProps) => void;
154
150
  onDrop?: (info: TreeOnDragProps) => void;
155
- /** Content of a row's label */
156
151
  label?: Snippet<[TreeLabelSnippetProps]>;
157
152
  /** A row's icon, in place of the directory icon */
158
153
  icon?: Snippet<[TreeIconSnippetProps]>;
@@ -162,14 +157,12 @@ export interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, NativeKe
162
157
  /** Replaces the search box; `false` hides it while `filterTreeNode` still filters */
163
158
  search?: Snippet<[TreeSearchSnippetProps]> | false;
164
159
  emptyContent?: Snippet;
165
- /** The image the browser shows while a node is dragged */
166
160
  renderDraggingNode?: Snippet<[TreeDraggingNodeSnippetProps]>;
167
161
  }
168
162
  /** The methods on a Tree instance from `bind:this` */
169
163
  export interface TreeHandle {
170
164
  /** Searches as if typed into the search box; needs `filterTreeNode` */
171
165
  search: (value: string) => void;
172
- /** Scrolls a virtualized tree to an expanded node */
173
166
  scrollTo: (scrollData: TreeScrollData) => void;
174
167
  }
175
168
  export interface FlattenNode extends BasicFlattenNode {
@@ -198,10 +191,8 @@ export interface TreeNodeProps {
198
191
  row: TreeRowProps;
199
192
  /** The row's id, which the tree's aria-activedescendant points at */
200
193
  id: string;
201
- /** The row the keyboard is on */
202
194
  focused?: boolean;
203
195
  showLine?: boolean;
204
- /** The position of a virtual row */
205
196
  rowStyle?: string;
206
197
  label?: Snippet<[TreeLabelSnippetProps]>;
207
198
  icon?: Snippet<[TreeIconSnippetProps]>;
@@ -18,7 +18,6 @@
18
18
 
19
19
  let isOpen = $state(untrack(() => open));
20
20
 
21
- // the flip has to land after the mounted state for Collapsible to animate between them
22
21
  onMount(() => {
23
22
  const timer = setTimeout(() => {
24
23
  isOpen = !isOpen;
@@ -9,10 +9,6 @@
9
9
  import type { FlattenNode, NodeListProps } from './interface.js';
10
10
  import NodeCollapsible from './node-collapsible.svelte';
11
11
 
12
- /**
13
- * The rows of Tree and TreeSelect. A virtualized list renders the rows in view; otherwise every row renders, with the
14
- * ones that appear or disappear (motionKeys) grouped into one animated NodeCollapsible.
15
- */
16
12
  let { flattenNodes, flattenList, motionKeys, motionType = null, motion, virtualize, itemKey, searchTargetIsDeep = false, children: renderRow }: NodeListProps = $props();
17
13
 
18
14
  const config = useConfig();
@@ -80,7 +80,6 @@
80
80
  }
81
81
  };
82
82
 
83
- // the foundation reads the row element from nodeInstance, to place the drop and to build the drag image
84
83
  const withInstance = (event: DragEvent): TreeRowProps => ({ ...row, nodeInstance: event.currentTarget });
85
84
 
86
85
  const onDragstart = (event: DragEvent) => {
@@ -79,7 +79,6 @@
79
79
  icon,
80
80
  expandIcon,
81
81
  fullLabel,
82
- // renamed: the instance method `search` takes the name
83
82
  search: searchBox,
84
83
  emptyContent,
85
84
  renderDraggingNode,
@@ -191,7 +190,6 @@
191
190
  },
192
191
  };
193
192
 
194
- /** Remembers whether the tree owned the prop when writing it back */
195
193
  const echo = (name: Bindable, next: unknown) => {
196
194
  echoes[name] = foundationProps[name] === undefined ? { value: next } : undefined;
197
195
  };
@@ -399,7 +397,6 @@
399
397
  foundation.handleInputChange(input);
400
398
  }
401
399
 
402
- /** Scrolls a virtualized tree to an expanded node */
403
400
  export function scrollTo(scrollData: TreeScrollData) {
404
401
  foundation.scrollTo(scrollData);
405
402
  }
@@ -1,6 +1,5 @@
1
1
  import type { FlattenNode, TreeRowProps } from './interface.js';
2
2
  export interface TreeKeyboardOptions {
3
- /** The visible rows the keys act on; none while there is no tree to act on */
4
3
  rows: () => FlattenNode[];
5
4
  /** The row the keys act on before any is chosen, -1 for none */
6
5
  defaultIndex: () => number;
@@ -14,23 +13,17 @@ export interface TreeKeyboardOptions {
14
13
  editing?: (event: KeyboardEvent) => boolean;
15
14
  /** Enter, and Space outside a text field: selects, or checks in a multiple tree */
16
15
  select: (event: KeyboardEvent, row: TreeRowProps) => void;
17
- /** Expands or collapses the row */
18
16
  expand: (event: KeyboardEvent, row: TreeRowProps) => void;
19
- /** Scrolls the row the keys moved to into view */
20
17
  reveal: (index: number, key: string) => void;
21
18
  }
22
19
  /**
23
20
  * The keys of an APG tree view: focus stays on the tree (or the combobox) and the keys act on the active row, which
24
- * aria-activedescendant points at. Up and Down move between the visible rows, Home and End go to the ends, Right
25
- * and Left open, enter, close or leave a branch (swapped in RTL), typed characters move to the next row starting
26
- * with them.
21
+ * aria-activedescendant points at. Right and Left swap in RTL.
27
22
  */
28
23
  export default function useTreeKeyboard(options: TreeKeyboardOptions): {
29
24
  readonly activeIndex: number;
30
25
  readonly activeKey: string | undefined;
31
- /** Makes the row the pointer acted on the keyboard's row */
32
26
  activate: (key: string) => void;
33
- /** Drops the keyboard's row, so the default row takes over */
34
27
  reset: () => void;
35
28
  handleKeyDown: (event: KeyboardEvent) => boolean;
36
29
  };
@@ -2,9 +2,7 @@ import { getTreeKeyboardAction, isTreeNodeLeaf } from '@fibrae/semi-foundation/t
2
2
  import { Typeahead } from '@fibrae/semi-foundation/utils/a11y';
3
3
  /**
4
4
  * The keys of an APG tree view: focus stays on the tree (or the combobox) and the keys act on the active row, which
5
- * aria-activedescendant points at. Up and Down move between the visible rows, Home and End go to the ends, Right
6
- * and Left open, enter, close or leave a branch (swapped in RTL), typed characters move to the next row starting
7
- * with them.
5
+ * aria-activedescendant points at. Right and Left swap in RTL.
8
6
  */
9
7
  export default function useTreeKeyboard(options) {
10
8
  const typeahead = new Typeahead();
@@ -20,7 +18,6 @@ export default function useTreeKeyboard(options) {
20
18
  keyboardKey = key;
21
19
  options.reveal(index, key);
22
20
  };
23
- /** Returns whether the key was handled */
24
21
  const handleKeyDown = (event) => {
25
22
  const rows = options.rows();
26
23
  const index = activeIndex;
@@ -53,11 +50,9 @@ export default function useTreeKeyboard(options) {
53
50
  get activeKey() {
54
51
  return activeKey;
55
52
  },
56
- /** Makes the row the pointer acted on the keyboard's row */
57
53
  activate: (key) => {
58
54
  keyboardKey = key;
59
55
  },
60
- /** Drops the keyboard's row, so the default row takes over */
61
56
  reset: () => {
62
57
  keyboardKey = null;
63
58
  },
@@ -28,18 +28,14 @@ export interface TreeSelectSelectedItemSnippetProps {
28
28
  onClose: (event?: TagCloseEvent) => void;
29
29
  }
30
30
  export interface TreeSelectTriggerSnippetProps {
31
- /** The selected nodes */
32
31
  value: TreeNodeData[];
33
32
  inputValue: string;
34
33
  placeholder?: string;
35
34
  disabled: boolean;
36
- /** The TreeSelect's props */
37
35
  componentProps: TreeSelectProps;
38
- /** Updates the search keyword */
39
36
  onSearch: (inputValue: string) => void;
40
37
  /** Pass the click event when bound to a control inside the trigger, so the click does not open the dropdown */
41
38
  onClear: (event?: MouseEvent) => void;
42
- /** Unchecks the node with the key */
43
39
  onRemove: (key: string) => void;
44
40
  }
45
41
  /**
@@ -130,7 +126,6 @@ export interface TreeSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, Na
130
126
  /** Goes on the `role="tree"` element */
131
127
  optionListStyle?: string;
132
128
  preventScroll?: boolean;
133
- /** Lets the tags of a multiple trigger search wrap onto more lines */
134
129
  triggerTagWrap?: boolean;
135
130
  /** With `onChangeWithObject` the value and the node are both the node */
136
131
  onChange?: (value: TreeSelectValue | undefined, node: TreeNodeData | TreeNodeData[] | undefined, event: TreeSelectChangeEvent) => void;
@@ -141,7 +136,6 @@ export interface TreeSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, Na
141
136
  onLoad?: (loadedKeys: Set<string>, node: TreeNodeData) => void;
142
137
  onSelect?: (selectedKey: string, selected: boolean, node: TreeNodeData) => void;
143
138
  onSearch?: (input: string, filteredExpandedKeys: string[], filteredNodes: TreeNodeData[]) => void;
144
- /** Called when the dropdown opens or closes */
145
139
  onVisibleChange?: (visible: boolean) => void;
146
140
  /**
147
141
  * Focus entering the trigger or the dropdown from outside (the focusin); moving within them does not fire it again.
@@ -154,9 +148,7 @@ export interface TreeSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, Na
154
148
  */
155
149
  onBlur?: (event: MouseEvent | KeyboardEvent | FocusEvent) => void;
156
150
  onClear?: (event: TreeSelectChangeEvent) => void;
157
- /** Content of a row's label */
158
151
  label?: Snippet<[TreeLabelSnippetProps]>;
159
- /** A row's icon */
160
152
  icon?: Snippet<[TreeIconSnippetProps]>;
161
153
  /** A single element gets the class and the click that expands */
162
154
  expandIcon?: Snippet<[TreeExpandIconSnippetProps]>;
@@ -166,7 +158,6 @@ export interface TreeSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, Na
166
158
  selectedItem?: Snippet<[TreeSelectSelectedItemSnippetProps]>;
167
159
  /** Replaces each tag in multiple mode, ahead of `selectedItem` */
168
160
  tag?: Snippet<[TreeSelectSelectedItemSnippetProps]>;
169
- /** Replaces the trigger content */
170
161
  trigger?: Snippet<[TreeSelectTriggerSnippetProps]>;
171
162
  /** Replaces the search box; `false` hides it while `filterTreeNode` still filters */
172
163
  search?: Snippet<[TreeSelectSearchSnippetProps]> | false;
@@ -175,7 +166,6 @@ export interface TreeSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, Na
175
166
  insetLabel?: Snippet;
176
167
  /** `null` hides the arrow */
177
168
  arrowIcon?: Snippet | null;
178
- /** Replaces the clear icon */
179
169
  clearIcon?: Snippet;
180
170
  /** `null` hides the empty state */
181
171
  emptyContent?: Snippet | null;
@@ -187,7 +177,6 @@ export interface TreeSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, Na
187
177
  export interface TreeSelectHandle {
188
178
  /** Searches as if `value` were typed, opening the dropdown first; needs `filterTreeNode` */
189
179
  search: (value: string) => void;
190
- /** Closes the dropdown */
191
180
  close: () => void;
192
181
  }
193
182
  export {};
@@ -277,7 +277,6 @@
277
277
  },
278
278
  };
279
279
 
280
- /** Remembers whether the TreeSelect owned the prop when writing it back */
281
280
  const echo = (name: Bindable, next: unknown) => {
282
281
  echoes[name] = foundationProps[name] === undefined ? { value: next } : undefined;
283
282
  };
@@ -553,7 +552,6 @@
553
552
  foundation.handleKeyDown(event);
554
553
  };
555
554
 
556
- // The popup is not a DOM descendant of the trigger, so its keys arrive here
557
555
  const handleContentKeyDown = (event: KeyboardEvent) => {
558
556
  handleTreeKeyDown(event);
559
557
  foundation.handleKeyDown(event);
@@ -131,7 +131,6 @@
131
131
  return tags.filter((tag) => tag !== false);
132
132
  });
133
133
 
134
- // The description goes to the focusable link inside, unless the caller set their own
135
134
  const linkDescribes = $derived.by(() => {
136
135
  const first = decorations[0];
137
136
  return tooltip !== false && !tooltip.popover && first?.tag === 'a' && Boolean(first.attrs.href || first.attrs.role === 'link') && !rest['aria-describedby'];
@@ -328,7 +327,6 @@
328
327
  return () => observer.disconnect();
329
328
  });
330
329
 
331
- // truncating renders the expand button, so the text is measured again with its width
332
330
  $effect(() => {
333
331
  void [fullText, truncated, view.expanded, rows, pos, suffix, expandText, tooltipEnabled, Boolean(copyable), strong, root];
334
332
  if (hasEllipsis) runtime.schedule();
@@ -3,7 +3,6 @@ import TypographyParagraphPart from './paragraph.svelte';
3
3
  import TypographyTextPart from './text.svelte';
4
4
  import TypographyTitlePart from './title.svelte';
5
5
  import TypographyBase from './typography.svelte';
6
- // Svelte components are functions, so the parts attach to the component itself
7
6
  export const Typography = Object.assign(TypographyBase, { Text: TypographyTextPart, Title: TypographyTitlePart, Paragraph: TypographyParagraphPart, Numeral: TypographyNumeralPart });
8
7
  export { default as TypographyText } from './text.svelte';
9
8
  export { default as TypographyTitle } from './title.svelte';
@@ -66,7 +66,6 @@ export interface TypographyCopySnippets {
66
66
  copyAction?: Snippet<[TypographyCopyActionProps]>;
67
67
  }
68
68
  export interface TypographyEllipsisTooltipProps {
69
- /** The full text */
70
69
  content: string;
71
70
  /** The text element, to be placed in the custom popup with `{@render trigger()}` */
72
71
  trigger: Snippet;
@@ -8,9 +8,7 @@ export interface TypographyBaseProps extends HTMLAttributes<HTMLElement>, Typogr
8
8
  spacing?: string;
9
9
  weight?: string | number;
10
10
  icon?: Snippet;
11
- /** Title's tag, which also picks the heading class */
12
11
  headingTag?: `h${1 | 2 | 3 | 4 | 5 | 6}`;
13
- /** Numeral's formatter of the rendered text nodes */
14
12
  format?: (value: string) => string;
15
13
  }
16
14
  export interface EllipsisView {
@@ -55,7 +55,6 @@
55
55
  const replaceShown = $derived(!disabled && file.status === strings.FILE_STATUS_SUCCESS && Boolean(replaceEnabled));
56
56
  const failed = $derived(file.status === strings.FILE_STATUS_VALID_FAIL || file.status === strings.FILE_STATUS_UPLOAD_FAIL);
57
57
 
58
- // an item built by hand may carry the byte count
59
58
  const size = $derived.by(() => {
60
59
  const value: string | number = file.size;
61
60
  return typeof value === 'number' ? getFileSize(value) : value;
@@ -1,5 +1,4 @@
1
1
  import FileCard from './file-card.svelte';
2
2
  import UploadBase from './upload.svelte';
3
- // Svelte components are functions, so the static subcomponent attaches to the component itself
4
3
  export const Upload = Object.assign(UploadBase, { FileCard });
5
4
  export { default as UploadFileCard } from './file-card.svelte';
@@ -35,7 +35,6 @@ export interface UploadOnChangeProps {
35
35
  }
36
36
  export interface UploadCustomRequestArgs {
37
37
  fileName: string;
38
- /** The resolved `data` prop */
39
38
  data: Record<string, any>;
40
39
  file: FileItem;
41
40
  fileInstance: File;
@@ -65,9 +64,7 @@ export interface UploadCropProps {
65
64
  zoomStep?: number;
66
65
  /** Output image quality, range 0 - 1, defaults to 0.92 */
67
66
  quality?: number;
68
- /** Fill color of the area outside the cropped region */
69
67
  fill?: string;
70
- /** Title of the crop modal; the locale's by default */
71
68
  modalTitle?: string;
72
69
  modalOkText?: string;
73
70
  modalCancelText?: string;
@@ -152,7 +149,6 @@ export interface UploadProps extends Omit<HTMLAttributes<HTMLDivElement>, 'oncha
152
149
  headers?: Record<string, any> | ((file: File) => Record<string, string>);
153
150
  /** Where the picture wall's add button sits */
154
151
  hotSpotLocation?: 'start' | 'end';
155
- /** Style of each file card */
156
152
  itemStyle?: string;
157
153
  limit?: number;
158
154
  listType?: UploadListType;
@@ -292,7 +292,6 @@
292
292
  replaceInput?.click();
293
293
  };
294
294
 
295
- // Moving between the controls inside is not leaving the Upload
296
295
  const handleFocusout = (event: FocusEvent & { currentTarget: HTMLDivElement }) => {
297
296
  rest.onfocusout?.(event);
298
297
  if (!(event.relatedTarget instanceof Node && event.currentTarget.contains(event.relatedTarget))) {
@@ -15,7 +15,6 @@ export interface UserGuideStepItem {
15
15
  target?: UserGuideTarget;
16
16
  title?: string | Snippet<[UserGuideStepSnippetProps]>;
17
17
  description?: string | Snippet<[UserGuideStepSnippetProps]>;
18
- /** Without a cover the step has no cover area. */
19
18
  cover?: Snippet<[UserGuideStepSnippetProps]>;
20
19
  mask?: boolean;
21
20
  /** Only applies to the popup mode. */
@@ -176,7 +176,6 @@
176
176
  };
177
177
  });
178
178
 
179
- // The first measure of a step scrolls it into view
180
179
  $effect(() => {
181
180
  void currentIndex;
182
181
  if (measuring) untrack(() => measure(true));
@@ -51,8 +51,6 @@
51
51
  );
52
52
 
53
53
  const texts = $derived(locale().locale);
54
-
55
- // the pointer's position, or the playhead when the bar is used by keyboard
56
54
  const previewValue = $derived(states().movingInfo?.value ?? value);
57
55
 
58
56
  // The popup is anchored to the bar's center, so only a translate moves it to the pointer
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fibrae/semi-ui-svelte",
3
- "version": "0.2.0",
3
+ "version": "0.3.1",
4
4
  "description": "Semi Design Next Svelte components",
5
5
  "license": "MIT",
6
6
  "homepage": "https://semi-design-next.pages.dev",
@@ -52,8 +52,8 @@
52
52
  "dependencies": {
53
53
  "@dnd-kit/dom": "~0.5.1",
54
54
  "@dnd-kit/svelte": "~0.5.1",
55
- "@fibrae/semi-foundation": "0.2.0",
56
- "@fibrae/semi-icons-svelte": "0.2.0",
55
+ "@fibrae/semi-foundation": "0.3.1",
56
+ "@fibrae/semi-icons-svelte": "0.3.1",
57
57
  "@tanstack/svelte-virtual": "^3.13.49",
58
58
  "async-validator": "^4.2.5",
59
59
  "date-fns": "^4.4.0",
@@ -68,7 +68,7 @@
68
68
  "@sveltejs/package": "^3.0.1",
69
69
  "@sveltejs/vite-plugin-svelte": "^7.3.1",
70
70
  "@testing-library/svelte": "^5.4.2",
71
- "eslint-plugin-svelte": "^3.23.1",
71
+ "eslint-plugin-svelte": "^3.24.0",
72
72
  "svelte": "^5.57.3",
73
73
  "svelte-check": "^4.7.7",
74
74
  "typescript": "^6.0.3"