idea-react 3.0.0-beta.5 → 3.0.0-rc.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +5 -3
- package/ReadMe.md +71 -65
- package/dist/index.d.mts +894 -929
- package/dist/index.d.ts +894 -929
- package/dist/index.js +16 -16
- package/dist/index.mjs +15 -15
- package/dist/style.css +2 -2
- package/package.json +3 -7
- package/source/{Accordion.tsx → Base/Accordion.tsx} +2 -2
- package/source/{Alert.tsx → Base/Alert.tsx} +1 -1
- package/source/{Avatar.tsx → Base/Avatar.tsx} +1 -1
- package/source/{Badge.tsx → Base/Badge.tsx} +1 -1
- package/source/{Breadcrumb.tsx → Base/Breadcrumb.tsx} +1 -1
- package/source/{Button.tsx → Base/Button.tsx} +1 -1
- package/source/{ButtonGroup.tsx → Base/ButtonGroup.tsx} +1 -1
- package/source/{Card.tsx → Base/Card.tsx} +1 -1
- package/source/{Carousel → Base/Carousel}/index.tsx +2 -2
- package/source/{CloseButton.tsx → Base/CloseButton.tsx} +1 -1
- package/source/{Collapse.tsx → Base/Collapse.tsx} +1 -1
- package/source/{Drawer.tsx → Base/Drawer.tsx} +2 -2
- package/source/{ListGroup.tsx → Base/ListGroup.tsx} +2 -2
- package/source/{Menu.tsx → Base/Menu.tsx} +4 -4
- package/source/{NativeDialog → Base/NativeDialog}/index.tsx +2 -2
- package/source/{Nav.tsx → Base/Nav.tsx} +2 -1
- package/source/{NavOverflow → Base/NavOverflow}/index.tsx +2 -2
- package/source/{Navbar.tsx → Base/Navbar.tsx} +1 -1
- package/source/{Pagination.tsx → Base/Pagination.tsx} +1 -1
- package/source/{Placeholder.tsx → Base/Placeholder.tsx} +1 -1
- package/source/{Popover.tsx → Base/Popover.tsx} +6 -2
- package/source/{Progress → Base/Progress}/index.tsx +1 -1
- package/source/{ScrollSpy → Base/ScrollSpy}/index.tsx +1 -1
- package/source/{Spinner.tsx → Base/Spinner.tsx} +2 -2
- package/source/{Stack.tsx → Base/Stack.tsx} +1 -1
- package/source/{Stepper.tsx → Base/Stepper.tsx} +2 -2
- package/source/{Tab.tsx → Base/Tab.tsx} +60 -47
- package/source/{Toast.tsx → Base/Toast.tsx} +1 -1
- package/source/{ToggleButton.tsx → Base/ToggleButton.tsx} +2 -2
- package/source/{Toggler.tsx → Base/Toggler.tsx} +1 -1
- package/source/{Tooltip.tsx → Base/Tooltip.tsx} +6 -2
- package/source/Base/index.ts +31 -0
- package/source/Content/Images.tsx +29 -0
- package/source/{Table.tsx → Content/Tables.tsx} +2 -2
- package/source/Content/index.ts +2 -0
- package/source/Extension/ClickBoundary.tsx +1 -1
- package/source/Extension/CodeBlock.tsx +1 -1
- package/source/Extension/Countdown.tsx +1 -1
- package/source/Extension/HorizontalMarquee/index.tsx +1 -1
- package/source/Extension/Icon.tsx +1 -1
- package/source/Extension/Loading.tsx +2 -2
- package/source/Extension/MarkdownView.tsx +23 -0
- package/source/Extension/MonthCalendar.tsx +4 -4
- package/source/Extension/Nameplate.tsx +1 -1
- package/source/Extension/OverlayBox.tsx +9 -4
- package/source/Extension/PageNav.tsx +2 -2
- package/source/Extension/ScrollNav/Scroller.tsx +1 -1
- package/source/Extension/ScrollNav/index.tsx +2 -2
- package/source/Extension/ShareBox.tsx +1 -1
- package/source/Extension/SpinnerButton.tsx +3 -3
- package/source/Extension/TableSpinner.tsx +2 -2
- package/source/Extension/TextTruncate/index.tsx +1 -1
- package/source/Extension/Time.tsx +1 -1
- package/source/Extension/TimeDistance.tsx +1 -1
- package/source/Extension/Timeline/index.tsx +2 -2
- package/source/Extension/TypeEcho/Content.tsx +1 -1
- package/source/Extension/TypeEcho/index.tsx +1 -1
- package/source/Extension/UserRank/Address.tsx +1 -1
- package/source/Extension/UserRank/index.tsx +5 -5
- package/source/Extension/VerticalMarquee/index.tsx +1 -1
- package/source/Extension/ZodiacBar.tsx +1 -1
- package/source/Extension/index.ts +1 -3
- package/source/Form/Adorn.tsx +1 -1
- package/source/Form/Checkbox.tsx +2 -2
- package/source/Form/{Chips.tsx → Chip.tsx} +4 -11
- package/source/Form/ChipInput.tsx +2 -2
- package/source/Form/Combobox.tsx +2 -2
- package/source/Form/Control.tsx +1 -1
- package/source/Form/DatePicker.tsx +2 -2
- package/source/Form/Feedback.tsx +1 -1
- package/source/Form/FloatingLabel.tsx +1 -1
- package/source/Form/InputGroup.tsx +3 -3
- package/source/Form/OTP.tsx +1 -1
- package/source/Form/Primitives.tsx +8 -1
- package/source/Form/Radio.tsx +2 -2
- package/source/Form/Range.tsx +2 -2
- package/source/Form/Switch.tsx +2 -2
- package/source/Form/index.ts +1 -1
- package/source/{Overlay.ts → Helper/Overlay.ts} +1 -1
- package/source/{color.ts → Helper/color.ts} +1 -1
- package/source/Helper/index.ts +4 -0
- package/source/{Grid.tsx → Layout/Grid.tsx} +1 -1
- package/source/Layout/index.ts +1 -0
- package/source/index.ts +4 -38
- package/source/Extension/Editor.tsx +0 -78
- package/source/Extension/EditorHTML.tsx +0 -20
- package/source/Extension/Select.tsx +0 -128
- package/source/Image.tsx +0 -19
- /package/source/{Carousel → Base/Carousel}/model.ts +0 -0
- /package/source/{Carousel → Base/Carousel}/scroll.ts +0 -0
- /package/source/{Carousel → Base/Carousel}/style.module.css +0 -0
- /package/source/{NativeDialog → Base/NativeDialog}/style.module.css +0 -0
- /package/source/{NavOverflow → Base/NavOverflow}/model.ts +0 -0
- /package/source/{ScrollSpy → Base/ScrollSpy}/model.ts +0 -0
- /package/source/{Polymorphic.ts → Helper/Polymorphic.ts} +0 -0
- /package/source/{animate.ts → Helper/animate.ts} +0 -0
package/AGENTS.md
CHANGED
|
@@ -183,7 +183,7 @@ export class MyComponent extends ObservedComponent<MyComponentProps> {
|
|
|
183
183
|
- 向子组件透传时只解构需要特殊处理的 props,其余用 `...this.props` 展开,不逐项转发。
|
|
184
184
|
- 多个组件共享的属性定义在基础模块,组件通过 `extends`、`Omit` 或类型别名复用,不从组件文件再导出基础模块的类型。
|
|
185
185
|
- 没有成员声明体的 `interface` 改用 `type` 与交叉类型表达。
|
|
186
|
-
- 单根节点组件复用 `source/Polymorphic.ts` 的泛型与组合机制支持 `as`,透传目标组件属性;
|
|
186
|
+
- 单根节点组件复用 `source/Helper/Polymorphic.ts` 的泛型与组合机制支持 `as`,透传目标组件属性;
|
|
187
187
|
片段或多根节点组件不强行添加包装节点,类组件的 `ref` 保持实例语义。
|
|
188
188
|
类组件显式声明 `declare readonly props: PolymorphicClassProps<T, Props>`,避免 React 的
|
|
189
189
|
`Readonly` 映射丢失目标属性的联合类型;内部按需使用类型收窄 getter。
|
|
@@ -216,6 +216,8 @@ export class MyComponent extends ObservedComponent<MyComponentProps> {
|
|
|
216
216
|
- 上游来源与版权许可说明集中在网站公共页脚,不在各篇组件文档重复,也不添加指向上游单页源码的链接。
|
|
217
217
|
- MDX 中的大段静态文本优先使用 Markdown,而非嵌套的 JSX 文本块。
|
|
218
218
|
- 从 `unpkg.com` 引入 Bootstrap CSS,严禁使用 Tailwind CSS 及其插件、配置和工具类。
|
|
219
|
+
- 所有组件依赖的第三方 CSS 统一由使用方通过 `<link />` 从 `unpkg.com` 引入;
|
|
220
|
+
组件源码不导入或打包这些样式,文档站在公共布局中统一加载。
|
|
219
221
|
- 能用 [Bootstrap 6 CSS 工具类][4] 的样式不写自定义 CSS;
|
|
220
222
|
剩余样式全部使用 CSS modules,不另建全局自定义样式;需要嵌套的样式使用 LESS modules。
|
|
221
223
|
- 可由 CSS 或 Bootstrap 工具类静态表达的布局、状态与堆叠关系优先用 CSS,避免为此引入客户端状态或 Context、Model。
|
|
@@ -226,7 +228,7 @@ export class MyComponent extends ObservedComponent<MyComponentProps> {
|
|
|
226
228
|
- Markdown 正文中的链接采用文末数字引用:正文写 `[text][number]`,文末写 `[number]: URL`;图片链接同样使用引用形式。行末链接(如组件列表项)无需改为文末引用,可保留 `[text](URL)`。
|
|
227
229
|
- 每篇文档的数字引用按首次出现顺序从 1 连续编号;重复链接复用同一编号,修改后同步整理正文与定义,移除未使用定义,不留跳号、重复或悬空引用。
|
|
228
230
|
- 组件目录优先列出上游标准组件,再列扩展组件。
|
|
229
|
-
- 静态站搜索优先采用最简单可用的方案,开发与生产共用 MDX 源码索引器并通过同一
|
|
231
|
+
- 静态站搜索优先采用最简单可用的方案,开发与生产共用 MDX 源码索引器并通过同一 RSS 地址加载,RSS 包含完整纯文本正文供搜索与订阅复用;不依赖编译后的 HTML,不维护手写页面清单,不为索引格式或具体技术额外引入不必要的服务和框架。
|
|
230
232
|
|
|
231
233
|
## 测试与验证
|
|
232
234
|
|
|
@@ -251,7 +253,7 @@ pnpm build -r
|
|
|
251
253
|
- `test` 使用 Node.js 原生 runner,需要 Node.js 22.18+,并做 TypeScript 检查。Lint 与格式检查针对本次修改文件运行。
|
|
252
254
|
- 根目录 `pnpm build` 构建 TypeDoc、旧预览站与组件发布包;现有根构建、发布部署仍使用 `docs/`,不能将其误当作 ViNext 文档工作区的构建或部署。
|
|
253
255
|
- 文档工作区单独构建,只部署 `document/dist/client/`;部署到子目录前配置 `document/next.config.ts` 的 `basePath`,并验证静态资源、搜索索引和结果链接。
|
|
254
|
-
- 开发模式按请求从当前 MDX
|
|
256
|
+
- 开发模式按请求从当前 MDX 文档生成 RSS 搜索索引;生产模式用同一索引器生成静态 RSS 与 Sitemap,生产搜索需构建后预览静态产物。
|
|
255
257
|
- 浏览器验证包括键盘交互、主题恢复、错误弹窗、失败后重试与不同视口;文档站不依赖 Node.js 或 Worker 运行时。
|
|
256
258
|
|
|
257
259
|
## 发布维护
|
package/ReadMe.md
CHANGED
|
@@ -22,39 +22,45 @@ A **[React][1] advanced components library** based on [TypeScript][2] & [Bootstr
|
|
|
22
22
|
|
|
23
23
|
### Basic components
|
|
24
24
|
|
|
25
|
-
1. [Accordion](source/Accordion.tsx)
|
|
26
|
-
2. [Alert](source/Alert.tsx)
|
|
27
|
-
3. [Avatar](source/Avatar.tsx)
|
|
28
|
-
4. [Badge](source/Badge.tsx)
|
|
29
|
-
5. [Breadcrumb](source/Breadcrumb.tsx)
|
|
30
|
-
6. [Button](source/Button.tsx)
|
|
31
|
-
7. [Button Group](source/ButtonGroup.tsx)
|
|
32
|
-
8. [Card](source/Card.tsx)
|
|
33
|
-
9. [Carousel](source/Carousel)
|
|
34
|
-
10. [Close Button](source/CloseButton.tsx)
|
|
35
|
-
11. [Collapse](source/Collapse.tsx)
|
|
36
|
-
12. [Native Dialog](source/NativeDialog)
|
|
37
|
-
13. [Drawer](source/Drawer.tsx)
|
|
38
|
-
14. [List Group](source/ListGroup.tsx)
|
|
39
|
-
15. [Menu](source/Menu.tsx)
|
|
40
|
-
16. [Nav](source/Nav.tsx)
|
|
41
|
-
17. [Nav Overflow](source/NavOverflow)
|
|
42
|
-
18. [Navbar](source/Navbar.tsx)
|
|
43
|
-
19. [Pagination](source/Pagination.tsx)
|
|
44
|
-
20. [Placeholder](source/Placeholder.tsx)
|
|
45
|
-
21. [Popover](source/Popover.tsx)
|
|
46
|
-
22. [Progress](source/Progress/)
|
|
47
|
-
23. [Scrollspy](source/ScrollSpy)
|
|
48
|
-
24. [Spinner](source/Spinner.tsx)
|
|
49
|
-
25. [Stepper](source/Stepper.tsx)
|
|
50
|
-
26. [Tab](source/Tab.tsx)
|
|
51
|
-
27. [Toast](source/Toast.tsx)
|
|
52
|
-
28. [Toggler](source/Toggler.tsx)
|
|
53
|
-
29. [Tooltip](source/Tooltip.tsx)
|
|
54
|
-
30. [
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
25
|
+
1. [Accordion](source/Base/Accordion.tsx)
|
|
26
|
+
2. [Alert](source/Base/Alert.tsx)
|
|
27
|
+
3. [Avatar](source/Base/Avatar.tsx)
|
|
28
|
+
4. [Badge](source/Base/Badge.tsx)
|
|
29
|
+
5. [Breadcrumb](source/Base/Breadcrumb.tsx)
|
|
30
|
+
6. [Button](source/Base/Button.tsx)
|
|
31
|
+
7. [Button Group](source/Base/ButtonGroup.tsx)
|
|
32
|
+
8. [Card](source/Base/Card.tsx)
|
|
33
|
+
9. [Carousel](source/Base/Carousel)
|
|
34
|
+
10. [Close Button](source/Base/CloseButton.tsx)
|
|
35
|
+
11. [Collapse](source/Base/Collapse.tsx)
|
|
36
|
+
12. [Native Dialog](source/Base/NativeDialog)
|
|
37
|
+
13. [Drawer](source/Base/Drawer.tsx)
|
|
38
|
+
14. [List Group](source/Base/ListGroup.tsx)
|
|
39
|
+
15. [Menu](source/Base/Menu.tsx)
|
|
40
|
+
16. [Nav](source/Base/Nav.tsx)
|
|
41
|
+
17. [Nav Overflow](source/Base/NavOverflow)
|
|
42
|
+
18. [Navbar](source/Base/Navbar.tsx)
|
|
43
|
+
19. [Pagination](source/Base/Pagination.tsx)
|
|
44
|
+
20. [Placeholder](source/Base/Placeholder.tsx)
|
|
45
|
+
21. [Popover](source/Base/Popover.tsx)
|
|
46
|
+
22. [Progress](source/Base/Progress/)
|
|
47
|
+
23. [Scrollspy](source/Base/ScrollSpy)
|
|
48
|
+
24. [Spinner](source/Base/Spinner.tsx)
|
|
49
|
+
25. [Stepper](source/Base/Stepper.tsx)
|
|
50
|
+
26. [Tab](source/Base/Tab.tsx)
|
|
51
|
+
27. [Toast](source/Base/Toast.tsx)
|
|
52
|
+
28. [Toggler](source/Base/Toggler.tsx)
|
|
53
|
+
29. [Tooltip](source/Base/Tooltip.tsx)
|
|
54
|
+
30. [Toggle Button](source/Base/ToggleButton.tsx)
|
|
55
|
+
|
|
56
|
+
### Layout components
|
|
57
|
+
|
|
58
|
+
1. [Grid](source/Layout/Grid.tsx)
|
|
59
|
+
|
|
60
|
+
### Content components
|
|
61
|
+
|
|
62
|
+
1. [Images](source/Content/Images.tsx)
|
|
63
|
+
2. [Tables](source/Content/Tables.tsx)
|
|
58
64
|
|
|
59
65
|
### Form components
|
|
60
66
|
|
|
@@ -67,12 +73,13 @@ A **[React][1] advanced components library** based on [TypeScript][2] & [Bootstr
|
|
|
67
73
|
7. [Input Group](source/Form/InputGroup.tsx)
|
|
68
74
|
8. [Floating Label](source/Form/FloatingLabel.tsx)
|
|
69
75
|
9. [Form Adornment & Ghost](source/Form/Adorn.tsx)
|
|
70
|
-
10. [Chip
|
|
71
|
-
11. [
|
|
72
|
-
12. [
|
|
73
|
-
13. [
|
|
74
|
-
14. [
|
|
75
|
-
15. [
|
|
76
|
+
10. [Chip](source/Form/Chip.tsx)
|
|
77
|
+
11. [Chip Input](source/Form/ChipInput.tsx)
|
|
78
|
+
12. [Combobox](source/Form/Combobox.tsx)
|
|
79
|
+
13. [Date Picker](source/Form/DatePicker.tsx)
|
|
80
|
+
14. [OTP Input](source/Form/OTP.tsx)
|
|
81
|
+
15. [Password Strength](source/Form/PasswordStrength.tsx)
|
|
82
|
+
16. [Form Feedback & Text](source/Form/Feedback.tsx)
|
|
76
83
|
|
|
77
84
|
### Extension components
|
|
78
85
|
|
|
@@ -80,29 +87,27 @@ A **[React][1] advanced components library** based on [TypeScript][2] & [Bootstr
|
|
|
80
87
|
2. [Code Block](source/Extension/CodeBlock.tsx)
|
|
81
88
|
3. [Countdown](source/Extension/Countdown.tsx)
|
|
82
89
|
4. [Dialog](source/Extension/Dialog.tsx)
|
|
83
|
-
5. [
|
|
84
|
-
6. [
|
|
85
|
-
7. [
|
|
86
|
-
8. [
|
|
87
|
-
9. [
|
|
88
|
-
10. [
|
|
89
|
-
11. [
|
|
90
|
-
12. [
|
|
91
|
-
13. [
|
|
92
|
-
14. [
|
|
93
|
-
15. [
|
|
94
|
-
16. [
|
|
95
|
-
17. [
|
|
96
|
-
18. [
|
|
97
|
-
19. [
|
|
98
|
-
20. [
|
|
99
|
-
21. [
|
|
100
|
-
22. [
|
|
101
|
-
23. [
|
|
102
|
-
24. [
|
|
103
|
-
25. [
|
|
104
|
-
26. [Vertical Marquee](source/Extension/VerticalMarquee/)
|
|
105
|
-
27. [Zodiac Bar](source/Extension/ZodiacBar.tsx)
|
|
90
|
+
5. [Markdown View](source/Extension/MarkdownView.tsx)
|
|
91
|
+
6. [Horizontal Marquee](source/Extension/HorizontalMarquee/)
|
|
92
|
+
7. [Icon](source/Extension/Icon.tsx)
|
|
93
|
+
8. [Live TSX](source/Extension/LiveTSX.tsx)
|
|
94
|
+
9. [Loading](source/Extension/Loading.tsx)
|
|
95
|
+
10. [Month Calendar](source/Extension/MonthCalendar.tsx)
|
|
96
|
+
11. [Nameplate](source/Extension/Nameplate.tsx)
|
|
97
|
+
12. [Overlay Box](source/Extension/OverlayBox.tsx)
|
|
98
|
+
13. [Page Nav](source/Extension/PageNav.tsx)
|
|
99
|
+
14. [Scroll Nav](source/Extension/ScrollNav/)
|
|
100
|
+
15. [Share Box](source/Extension/ShareBox.tsx)
|
|
101
|
+
16. [Spinner Button](source/Extension/SpinnerButton.tsx)
|
|
102
|
+
17. [Table Spinner](source/Extension/TableSpinner.tsx)
|
|
103
|
+
18. [Text Truncate](source/Extension/TextTruncate/)
|
|
104
|
+
19. [Time](source/Extension/Time.tsx)
|
|
105
|
+
20. [Time Distance](source/Extension/TimeDistance.tsx)
|
|
106
|
+
21. [Timeline](source/Extension/Timeline/)
|
|
107
|
+
22. [Type Echo](source/Extension/TypeEcho/)
|
|
108
|
+
23. [User Rank](source/Extension/UserRank/)
|
|
109
|
+
24. [Vertical Marquee](source/Extension/VerticalMarquee/)
|
|
110
|
+
25. [Zodiac Bar](source/Extension/ZodiacBar.tsx)
|
|
106
111
|
|
|
107
112
|
### Data components
|
|
108
113
|
|
|
@@ -114,8 +119,8 @@ Open Map component & model, have been migrated to https://github.com/idea2app/Op
|
|
|
114
119
|
|
|
115
120
|
### Utilities
|
|
116
121
|
|
|
117
|
-
1. [`text2color`](source/color.ts)
|
|
118
|
-
2. [`animate()`](source/animate.ts)
|
|
122
|
+
1. [`text2color`](source/Helper/color.ts)
|
|
123
|
+
2. [`animate()`](source/Helper/animate.ts)
|
|
119
124
|
|
|
120
125
|
## Usage
|
|
121
126
|
|
|
@@ -139,7 +144,8 @@ For the current alpha release, use `idea-react@next` instead of `idea-react`.
|
|
|
139
144
|
/>
|
|
140
145
|
<link rel="stylesheet" href="https://unpkg.com/bootstrap-icons@1.13.2/font/bootstrap-icons.css" />
|
|
141
146
|
<link rel="stylesheet" href="https://unpkg.com/animate.css@4.1.1/animate.min.css" />
|
|
142
|
-
<link rel="stylesheet" href="https://unpkg.com/
|
|
147
|
+
<link rel="stylesheet" href="https://unpkg.com/github-markdown-css@5.9.0/github-markdown.css" />
|
|
148
|
+
<link rel="stylesheet" href="https://unpkg.com/idea-react/dist/style.css" />
|
|
143
149
|
```
|
|
144
150
|
|
|
145
151
|
### `tsconfig.json`
|