idea-react 3.0.0-beta.4 → 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.
Files changed (104) hide show
  1. package/AGENTS.md +6 -3
  2. package/ReadMe.md +71 -65
  3. package/dist/index.d.mts +902 -930
  4. package/dist/index.d.ts +902 -930
  5. package/dist/index.js +16 -16
  6. package/dist/index.mjs +15 -15
  7. package/dist/style.css +4 -1
  8. package/package.json +3 -7
  9. package/source/{Accordion.tsx → Base/Accordion.tsx} +2 -2
  10. package/source/{Alert.tsx → Base/Alert.tsx} +1 -1
  11. package/source/{Avatar.tsx → Base/Avatar.tsx} +1 -1
  12. package/source/{Badge.tsx → Base/Badge.tsx} +1 -1
  13. package/source/{Breadcrumb.tsx → Base/Breadcrumb.tsx} +1 -1
  14. package/source/{Button.tsx → Base/Button.tsx} +1 -1
  15. package/source/{ButtonGroup.tsx → Base/ButtonGroup.tsx} +1 -1
  16. package/source/{Card.tsx → Base/Card.tsx} +1 -1
  17. package/source/{Carousel → Base/Carousel}/index.tsx +120 -59
  18. package/source/{Carousel → Base/Carousel}/model.ts +12 -8
  19. package/source/Base/Carousel/style.module.css +3 -0
  20. package/source/{CloseButton.tsx → Base/CloseButton.tsx} +1 -1
  21. package/source/{Collapse.tsx → Base/Collapse.tsx} +1 -1
  22. package/source/{Drawer.tsx → Base/Drawer.tsx} +2 -2
  23. package/source/{ListGroup.tsx → Base/ListGroup.tsx} +2 -2
  24. package/source/{Menu.tsx → Base/Menu.tsx} +4 -4
  25. package/source/{NativeDialog → Base/NativeDialog}/index.tsx +2 -2
  26. package/source/{Nav.tsx → Base/Nav.tsx} +2 -1
  27. package/source/{NavOverflow → Base/NavOverflow}/index.tsx +2 -2
  28. package/source/{Navbar.tsx → Base/Navbar.tsx} +1 -1
  29. package/source/{Pagination.tsx → Base/Pagination.tsx} +1 -1
  30. package/source/{Placeholder.tsx → Base/Placeholder.tsx} +1 -1
  31. package/source/{Popover.tsx → Base/Popover.tsx} +6 -2
  32. package/source/{Progress → Base/Progress}/index.tsx +1 -1
  33. package/source/{ScrollSpy → Base/ScrollSpy}/index.tsx +1 -1
  34. package/source/{Spinner.tsx → Base/Spinner.tsx} +2 -2
  35. package/source/{Stack.tsx → Base/Stack.tsx} +1 -1
  36. package/source/{Stepper.tsx → Base/Stepper.tsx} +2 -2
  37. package/source/{Tab.tsx → Base/Tab.tsx} +60 -47
  38. package/source/{Toast.tsx → Base/Toast.tsx} +1 -1
  39. package/source/{ToggleButton.tsx → Base/ToggleButton.tsx} +2 -2
  40. package/source/{Toggler.tsx → Base/Toggler.tsx} +1 -1
  41. package/source/{Tooltip.tsx → Base/Tooltip.tsx} +6 -2
  42. package/source/Base/index.ts +31 -0
  43. package/source/Content/Images.tsx +29 -0
  44. package/source/{Table.tsx → Content/Tables.tsx} +2 -2
  45. package/source/Content/index.ts +2 -0
  46. package/source/Extension/ClickBoundary.tsx +1 -1
  47. package/source/Extension/CodeBlock.tsx +1 -1
  48. package/source/Extension/Countdown.tsx +1 -1
  49. package/source/Extension/HorizontalMarquee/index.tsx +1 -1
  50. package/source/Extension/Icon.tsx +1 -1
  51. package/source/Extension/Loading.tsx +2 -2
  52. package/source/Extension/MarkdownView.tsx +23 -0
  53. package/source/Extension/MonthCalendar.tsx +4 -4
  54. package/source/Extension/Nameplate.tsx +1 -1
  55. package/source/Extension/OverlayBox.tsx +9 -4
  56. package/source/Extension/PageNav.tsx +2 -2
  57. package/source/Extension/ScrollNav/Scroller.tsx +1 -1
  58. package/source/Extension/ScrollNav/index.tsx +2 -2
  59. package/source/Extension/ShareBox.tsx +1 -1
  60. package/source/Extension/SpinnerButton.tsx +3 -3
  61. package/source/Extension/TableSpinner.tsx +2 -2
  62. package/source/Extension/TextTruncate/index.tsx +1 -1
  63. package/source/Extension/Time.tsx +1 -1
  64. package/source/Extension/TimeDistance.tsx +1 -1
  65. package/source/Extension/Timeline/index.tsx +2 -2
  66. package/source/Extension/TypeEcho/Content.tsx +1 -1
  67. package/source/Extension/TypeEcho/index.tsx +1 -1
  68. package/source/Extension/UserRank/Address.tsx +1 -1
  69. package/source/Extension/UserRank/index.tsx +5 -5
  70. package/source/Extension/VerticalMarquee/index.tsx +1 -1
  71. package/source/Extension/ZodiacBar.tsx +1 -1
  72. package/source/Extension/index.ts +1 -3
  73. package/source/Form/Adorn.tsx +1 -1
  74. package/source/Form/Checkbox.tsx +2 -2
  75. package/source/Form/{Chips.tsx → Chip.tsx} +4 -11
  76. package/source/Form/ChipInput.tsx +2 -2
  77. package/source/Form/Combobox.tsx +2 -2
  78. package/source/Form/Control.tsx +1 -1
  79. package/source/Form/DatePicker.tsx +2 -2
  80. package/source/Form/Feedback.tsx +1 -1
  81. package/source/Form/FloatingLabel.tsx +1 -1
  82. package/source/Form/InputGroup.tsx +3 -3
  83. package/source/Form/OTP.tsx +1 -1
  84. package/source/Form/Primitives.tsx +8 -1
  85. package/source/Form/Radio.tsx +2 -2
  86. package/source/Form/Range.tsx +2 -2
  87. package/source/Form/Switch.tsx +2 -2
  88. package/source/Form/index.ts +1 -1
  89. package/source/{Overlay.ts → Helper/Overlay.ts} +1 -1
  90. package/source/{color.ts → Helper/color.ts} +1 -1
  91. package/source/Helper/index.ts +4 -0
  92. package/source/{Grid.tsx → Layout/Grid.tsx} +1 -1
  93. package/source/Layout/index.ts +1 -0
  94. package/source/index.ts +4 -38
  95. package/source/Extension/Editor.tsx +0 -78
  96. package/source/Extension/EditorHTML.tsx +0 -20
  97. package/source/Extension/Select.tsx +0 -128
  98. package/source/Image.tsx +0 -19
  99. /package/source/{Carousel → Base/Carousel}/scroll.ts +0 -0
  100. /package/source/{NativeDialog → Base/NativeDialog}/style.module.css +0 -0
  101. /package/source/{NavOverflow → Base/NavOverflow}/model.ts +0 -0
  102. /package/source/{ScrollSpy → Base/ScrollSpy}/model.ts +0 -0
  103. /package/source/{Polymorphic.ts → Helper/Polymorphic.ts} +0 -0
  104. /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。
@@ -193,6 +193,7 @@ export class MyComponent extends ObservedComponent<MyComponentProps> {
193
193
  - JSX 属性按 `as`、HTML 通用静态属性、组件专属属性、状态属性、回调属性排序;相同键值的 props 可用对象字面量简写后展开。
194
194
  - 同一模块的类型与值合并为一条 import,不拆成 `import type` 与 `import` 两条。
195
195
  - JSX 中不同逻辑块(如触发器与浮层)之间用空行分隔。
196
+ - JSX 中超过 3 个类似子元素使用集合迭代渲染,不重复展开。
196
197
 
197
198
  ## 错误处理
198
199
 
@@ -215,6 +216,8 @@ export class MyComponent extends ObservedComponent<MyComponentProps> {
215
216
  - 上游来源与版权许可说明集中在网站公共页脚,不在各篇组件文档重复,也不添加指向上游单页源码的链接。
216
217
  - MDX 中的大段静态文本优先使用 Markdown,而非嵌套的 JSX 文本块。
217
218
  - 从 `unpkg.com` 引入 Bootstrap CSS,严禁使用 Tailwind CSS 及其插件、配置和工具类。
219
+ - 所有组件依赖的第三方 CSS 统一由使用方通过 `<link />` 从 `unpkg.com` 引入;
220
+ 组件源码不导入或打包这些样式,文档站在公共布局中统一加载。
218
221
  - 能用 [Bootstrap 6 CSS 工具类][4] 的样式不写自定义 CSS;
219
222
  剩余样式全部使用 CSS modules,不另建全局自定义样式;需要嵌套的样式使用 LESS modules。
220
223
  - 可由 CSS 或 Bootstrap 工具类静态表达的布局、状态与堆叠关系优先用 CSS,避免为此引入客户端状态或 Context、Model。
@@ -225,7 +228,7 @@ export class MyComponent extends ObservedComponent<MyComponentProps> {
225
228
  - Markdown 正文中的链接采用文末数字引用:正文写 `[text][number]`,文末写 `[number]: URL`;图片链接同样使用引用形式。行末链接(如组件列表项)无需改为文末引用,可保留 `[text](URL)`。
226
229
  - 每篇文档的数字引用按首次出现顺序从 1 连续编号;重复链接复用同一编号,修改后同步整理正文与定义,移除未使用定义,不留跳号、重复或悬空引用。
227
230
  - 组件目录优先列出上游标准组件,再列扩展组件。
228
- - 静态站搜索优先采用最简单可用的方案,开发与生产共用 MDX 源码索引器并通过同一 JSON 地址加载,不依赖编译后的 HTML,不维护手写页面清单,不为索引格式或具体技术额外引入不必要的服务和框架。
231
+ - 静态站搜索优先采用最简单可用的方案,开发与生产共用 MDX 源码索引器并通过同一 RSS 地址加载,RSS 包含完整纯文本正文供搜索与订阅复用;不依赖编译后的 HTML,不维护手写页面清单,不为索引格式或具体技术额外引入不必要的服务和框架。
229
232
 
230
233
  ## 测试与验证
231
234
 
@@ -250,7 +253,7 @@ pnpm build -r
250
253
  - `test` 使用 Node.js 原生 runner,需要 Node.js 22.18+,并做 TypeScript 检查。Lint 与格式检查针对本次修改文件运行。
251
254
  - 根目录 `pnpm build` 构建 TypeDoc、旧预览站与组件发布包;现有根构建、发布部署仍使用 `docs/`,不能将其误当作 ViNext 文档工作区的构建或部署。
252
255
  - 文档工作区单独构建,只部署 `document/dist/client/`;部署到子目录前配置 `document/next.config.ts` 的 `basePath`,并验证静态资源、搜索索引和结果链接。
253
- - 开发模式按请求从当前 MDX 文档生成搜索索引;生产模式用同一索引器生成静态 JSON,生产搜索需构建后预览静态产物。
256
+ - 开发模式按请求从当前 MDX 文档生成 RSS 搜索索引;生产模式用同一索引器生成静态 RSS 与 Sitemap,生产搜索需构建后预览静态产物。
254
257
  - 浏览器验证包括键盘交互、主题恢复、错误弹窗、失败后重试与不同视口;文档站不依赖 Node.js 或 Worker 运行时。
255
258
 
256
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. [Grid](source/Grid.tsx)
55
- 31. [Image](source/Image.tsx)
56
- 32. [Table](source/Table.tsx)
57
- 33. [Toggle Button](source/ToggleButton.tsx)
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 & Chip Input](source/Form/Chips.tsx)
71
- 11. [Combobox](source/Form/Combobox.tsx)
72
- 12. [Date Picker](source/Form/DatePicker.tsx)
73
- 13. [OTP Input](source/Form/OTP.tsx)
74
- 14. [Password Strength](source/Form/PasswordStrength.tsx)
75
- 15. [Form Feedback & Text](source/Form/Feedback.tsx)
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. [Editor](source/Extension/Editor.tsx)
84
- 6. [Editor HTML](source/Extension/EditorHTML.tsx)
85
- 7. [Horizontal Marquee](source/Extension/HorizontalMarquee/)
86
- 8. [Icon](source/Extension/Icon.tsx)
87
- 9. [Live TSX](source/Extension/LiveTSX.tsx)
88
- 10. [Loading](source/Extension/Loading.tsx)
89
- 11. [Month Calendar](source/Extension/MonthCalendar.tsx)
90
- 12. [Nameplate](source/Extension/Nameplate.tsx)
91
- 13. [Overlay Box](source/Extension/OverlayBox.tsx)
92
- 14. [Page Nav](source/Extension/PageNav.tsx)
93
- 15. [Scroll Nav](source/Extension/ScrollNav/)
94
- 16. [Select](source/Extension/Select.tsx)
95
- 17. [Share Box](source/Extension/ShareBox.tsx)
96
- 18. [Spinner Button](source/Extension/SpinnerButton.tsx)
97
- 19. [Table Spinner](source/Extension/TableSpinner.tsx)
98
- 20. [Text Truncate](source/Extension/TextTruncate/)
99
- 21. [Time](source/Extension/Time.tsx)
100
- 22. [Time Distance](source/Extension/TimeDistance.tsx)
101
- 23. [Timeline](source/Extension/Timeline/)
102
- 24. [Type Echo](source/Extension/TypeEcho/)
103
- 25. [User Rank](source/Extension/UserRank/)
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/idea-react/dist/index.css" />
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`