@apexhub/apex-ui-react 0.0.0-stage → 1.2.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 (185) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +37 -2
  3. package/dist/en_US.d.ts +191 -0
  4. package/dist/index.cjs +40692 -0
  5. package/dist/index.d.ts +6869 -0
  6. package/dist/index.mjs +40676 -0
  7. package/dist/llm/alert.tokens.txt +44 -0
  8. package/dist/llm/alert.txt +167 -0
  9. package/dist/llm/apex-provider.txt +368 -0
  10. package/dist/llm/auto-complete.tokens.txt +77 -0
  11. package/dist/llm/auto-complete.txt +373 -0
  12. package/dist/llm/avatar.tokens.txt +38 -0
  13. package/dist/llm/avatar.txt +199 -0
  14. package/dist/llm/breadcrumb.tokens.txt +193 -0
  15. package/dist/llm/breadcrumb.txt +251 -0
  16. package/dist/llm/button.tokens.txt +470 -0
  17. package/dist/llm/button.txt +262 -0
  18. package/dist/llm/card.tokens.txt +27 -0
  19. package/dist/llm/card.txt +95 -0
  20. package/dist/llm/cascader.tokens.txt +253 -0
  21. package/dist/llm/cascader.txt +898 -0
  22. package/dist/llm/checkbox.tokens.txt +28 -0
  23. package/dist/llm/checkbox.txt +332 -0
  24. package/dist/llm/collapse.tokens.txt +84 -0
  25. package/dist/llm/collapse.txt +330 -0
  26. package/dist/llm/date-picker.tokens.txt +171 -0
  27. package/dist/llm/date-picker.txt +424 -0
  28. package/dist/llm/divider.tokens.txt +22 -0
  29. package/dist/llm/divider.txt +161 -0
  30. package/dist/llm/drawer.tokens.txt +71 -0
  31. package/dist/llm/drawer.txt +369 -0
  32. package/dist/llm/dropdown.tokens.txt +59 -0
  33. package/dist/llm/dropdown.txt +420 -0
  34. package/dist/llm/form.tokens.txt +26 -0
  35. package/dist/llm/form.txt +341 -0
  36. package/dist/llm/grid.txt +419 -0
  37. package/dist/llm/image.tokens.txt +28 -0
  38. package/dist/llm/image.txt +428 -0
  39. package/dist/llm/input-number.tokens.txt +159 -0
  40. package/dist/llm/input-number.txt +486 -0
  41. package/dist/llm/input.tokens.txt +136 -0
  42. package/dist/llm/input.txt +422 -0
  43. package/dist/llm/layout.tokens.txt +29 -0
  44. package/dist/llm/layout.txt +298 -0
  45. package/dist/llm/menu.tokens.txt +87 -0
  46. package/dist/llm/menu.txt +680 -0
  47. package/dist/llm/message.tokens.txt +25 -0
  48. package/dist/llm/message.txt +301 -0
  49. package/dist/llm/modal.tokens.txt +96 -0
  50. package/dist/llm/modal.txt +584 -0
  51. package/dist/llm/notification.tokens.txt +79 -0
  52. package/dist/llm/notification.txt +383 -0
  53. package/dist/llm/pagination.tokens.txt +33 -0
  54. package/dist/llm/pagination.txt +208 -0
  55. package/dist/llm/popover.tokens.txt +28 -0
  56. package/dist/llm/popover.txt +233 -0
  57. package/dist/llm/progress.tokens.txt +83 -0
  58. package/dist/llm/progress.txt +279 -0
  59. package/dist/llm/radio.tokens.txt +21 -0
  60. package/dist/llm/radio.txt +348 -0
  61. package/dist/llm/rate.tokens.txt +20 -0
  62. package/dist/llm/rate.txt +241 -0
  63. package/dist/llm/select.tokens.txt +160 -0
  64. package/dist/llm/select.txt +830 -0
  65. package/dist/llm/skeleton.tokens.txt +15 -0
  66. package/dist/llm/skeleton.txt +275 -0
  67. package/dist/llm/spin.tokens.txt +21 -0
  68. package/dist/llm/spin.txt +294 -0
  69. package/dist/llm/steps.tokens.txt +30 -0
  70. package/dist/llm/steps.txt +300 -0
  71. package/dist/llm/switch.tokens.txt +38 -0
  72. package/dist/llm/switch.txt +216 -0
  73. package/dist/llm/table.tokens.txt +94 -0
  74. package/dist/llm/table.txt +1046 -0
  75. package/dist/llm/tabs.tokens.txt +78 -0
  76. package/dist/llm/tabs.txt +306 -0
  77. package/dist/llm/tag.tokens.txt +76 -0
  78. package/dist/llm/tag.txt +305 -0
  79. package/dist/llm/tooltip.tokens.txt +22 -0
  80. package/dist/llm/tooltip.txt +304 -0
  81. package/dist/llm/tree-select.tokens.txt +174 -0
  82. package/dist/llm/tree-select.txt +762 -0
  83. package/dist/llm/tree.tokens.txt +36 -0
  84. package/dist/llm/tree.txt +505 -0
  85. package/dist/llm/typography.tokens.txt +60 -0
  86. package/dist/llm/typography.txt +413 -0
  87. package/dist/llm/upload.tokens.txt +201 -0
  88. package/dist/llm/upload.txt +706 -0
  89. package/dist/llms-full.txt +16689 -0
  90. package/dist/llms-theme.txt +32 -0
  91. package/dist/llms.txt +59 -0
  92. package/dist/locale/en_US.cjs +160 -0
  93. package/dist/locale/en_US.d.ts +4 -0
  94. package/dist/locale/en_US.mjs +161 -0
  95. package/dist/locale/zh_CN.cjs +160 -0
  96. package/dist/locale/zh_CN.d.ts +4 -0
  97. package/dist/locale/zh_CN.mjs +161 -0
  98. package/dist/style.css +19619 -0
  99. package/dist/zh_CN.d.ts +191 -0
  100. package/llms-full.txt +16689 -0
  101. package/llms-theme.txt +32 -0
  102. package/llms.txt +59 -0
  103. package/package.json +118 -3
  104. package/src/alert/llm.txt +167 -0
  105. package/src/alert/tokens.txt +44 -0
  106. package/src/apex-provider/llm.txt +368 -0
  107. package/src/auto-complete/llm.txt +373 -0
  108. package/src/auto-complete/tokens.txt +77 -0
  109. package/src/avatar/llm.txt +199 -0
  110. package/src/avatar/tokens.txt +38 -0
  111. package/src/breadcrumb/llm.txt +251 -0
  112. package/src/breadcrumb/tokens.txt +193 -0
  113. package/src/button/llm.txt +262 -0
  114. package/src/button/tokens.txt +470 -0
  115. package/src/card/llm.txt +95 -0
  116. package/src/card/tokens.txt +27 -0
  117. package/src/cascader/llm.txt +898 -0
  118. package/src/cascader/tokens.txt +253 -0
  119. package/src/checkbox/llm.txt +332 -0
  120. package/src/checkbox/tokens.txt +28 -0
  121. package/src/collapse/llm.txt +330 -0
  122. package/src/collapse/tokens.txt +84 -0
  123. package/src/date-picker/llm.txt +424 -0
  124. package/src/date-picker/tokens.txt +171 -0
  125. package/src/divider/llm.txt +161 -0
  126. package/src/divider/tokens.txt +22 -0
  127. package/src/drawer/llm.txt +369 -0
  128. package/src/drawer/tokens.txt +71 -0
  129. package/src/dropdown/llm.txt +420 -0
  130. package/src/dropdown/tokens.txt +59 -0
  131. package/src/form/llm.txt +341 -0
  132. package/src/form/tokens.txt +26 -0
  133. package/src/grid/llm.txt +419 -0
  134. package/src/image/llm.txt +428 -0
  135. package/src/image/tokens.txt +28 -0
  136. package/src/input/llm.txt +422 -0
  137. package/src/input/tokens.txt +136 -0
  138. package/src/input-number/llm.txt +486 -0
  139. package/src/input-number/tokens.txt +159 -0
  140. package/src/layout/llm.txt +298 -0
  141. package/src/layout/tokens.txt +29 -0
  142. package/src/menu/llm.txt +680 -0
  143. package/src/menu/tokens.txt +87 -0
  144. package/src/message/llm.txt +301 -0
  145. package/src/message/tokens.txt +25 -0
  146. package/src/modal/llm.txt +584 -0
  147. package/src/modal/tokens.txt +96 -0
  148. package/src/notification/llm.txt +383 -0
  149. package/src/notification/tokens.txt +79 -0
  150. package/src/pagination/llm.txt +208 -0
  151. package/src/pagination/tokens.txt +33 -0
  152. package/src/popover/llm.txt +233 -0
  153. package/src/popover/tokens.txt +28 -0
  154. package/src/progress/llm.txt +279 -0
  155. package/src/progress/tokens.txt +83 -0
  156. package/src/radio/llm.txt +348 -0
  157. package/src/radio/tokens.txt +21 -0
  158. package/src/rate/llm.txt +241 -0
  159. package/src/rate/tokens.txt +20 -0
  160. package/src/select/llm.txt +830 -0
  161. package/src/select/tokens.txt +160 -0
  162. package/src/skeleton/llm.txt +275 -0
  163. package/src/skeleton/tokens.txt +15 -0
  164. package/src/spin/llm.txt +294 -0
  165. package/src/spin/tokens.txt +21 -0
  166. package/src/steps/llm.txt +300 -0
  167. package/src/steps/tokens.txt +30 -0
  168. package/src/switch/llm.txt +216 -0
  169. package/src/switch/tokens.txt +38 -0
  170. package/src/table/llm.txt +1046 -0
  171. package/src/table/tokens.txt +94 -0
  172. package/src/tabs/llm.txt +306 -0
  173. package/src/tabs/tokens.txt +78 -0
  174. package/src/tag/llm.txt +305 -0
  175. package/src/tag/tokens.txt +76 -0
  176. package/src/tooltip/llm.txt +304 -0
  177. package/src/tooltip/tokens.txt +22 -0
  178. package/src/tree/llm.txt +505 -0
  179. package/src/tree/tokens.txt +36 -0
  180. package/src/tree-select/llm.txt +762 -0
  181. package/src/tree-select/tokens.txt +174 -0
  182. package/src/typography/llm.txt +413 -0
  183. package/src/typography/tokens.txt +60 -0
  184. package/src/upload/llm.txt +706 -0
  185. package/src/upload/tokens.txt +201 -0
@@ -0,0 +1,216 @@
1
+ # Switch
2
+
3
+ > Switch:需要立即生效的开关型设置(如启用通知、暗色模式)时。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`Switch`、`SwitchRoot`、`SwitchThumb`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { Switch } from '@apexhub/apex-ui-react'
15
+
16
+ import '@apexhub/apex-ui-react/style.css'
17
+
18
+ export default () => <Switch defaultChecked aria-label="启用通知" />
19
+ ```
20
+
21
+ ## 何时使用
22
+
23
+ - 需要立即生效的开关型设置(如启用通知、暗色模式)时。
24
+ - 状态只有开/关两种,且切换后无需额外确认时。
25
+ - 若选项超过两个或需要展示全部可选项,请使用 Radio 或 Select,而不是 Switch。
26
+
27
+ ## API
28
+
29
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
30
+
31
+ ### Switch
32
+
33
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
34
+ | --- | --- | --- | --- | --- |
35
+ | checked | 受控选中状态;未传则为非受控 | `boolean` | 否 | — |
36
+ | defaultChecked | 非受控初始选中 | `boolean` | 否 | `false` |
37
+ | disabled | 是否禁用 | `boolean` | 否 | `false` |
38
+ | loading | 加载中,行为等同禁用,并设置 `data-loading` / `aria-busy` | `boolean` | 否 | `false` |
39
+ | size | 开关尺寸 | `"small" \| "medium" \| null` | 否 | `'medium'` |
40
+ | checkedChildren | 选中时轨道内内容(文案或图标) | `React.ReactNode` | 否 | — |
41
+ | unCheckedChildren | 未选中时轨道内内容(文案或图标) | `React.ReactNode` | 否 | — |
42
+ | onChange | 状态变化;`event` 在用户点击或按 Space 时提供 | `(checked: boolean, event?: SwitchChangeEvent) => void` | 否 | — |
43
+ | onClick | 点击回调;`checked` 为切换后的状态 | `(checked: boolean, event: React.MouseEvent<HTMLButtonElement>) => void` | 否 | — |
44
+ | className | 根节点 class | `string` | 否 | — |
45
+ | ref | 根节点 ref(指向 `HTMLButtonElement`) | `React.Ref<HTMLButtonElement>` | 否 | — |
46
+
47
+ ### SwitchChangeEvent
48
+
49
+ `onChange` 的 event 参数(鼠标点击或 Space 键盘)
50
+
51
+ ```typescript
52
+ type SwitchChangeEvent = | React.MouseEvent<HTMLButtonElement>
53
+ | React.KeyboardEvent<HTMLButtonElement>
54
+ ```
55
+
56
+ ### SwitchThumbProps
57
+
58
+ 继承:`React.ComponentProps<typeof SwitchPrimitive.Thumb>`;本节列出新增或重声明字段。
59
+
60
+ `Switch.Thumb` 组合用法 props
61
+
62
+ (暂无属性)
63
+
64
+ ### SwitchRootProps
65
+
66
+ 继承:`SwitchProps`;本节列出新增或重声明字段。
67
+
68
+ `SwitchRoot` 组合用法:可传入子节点(如 `SwitchThumb`)
69
+
70
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
71
+ | --- | --- | --- | --- | --- |
72
+ | children | — | `React.ReactNode` | 否 | — |
73
+
74
+ ### SwitchVariants
75
+
76
+ ```typescript
77
+ type SwitchVariants = VariantProps<typeof switchRootVariants>
78
+ ```
79
+
80
+ ### 导出类型
81
+
82
+ 另可从 `@apexhub/apex-ui-react` 导入:`SwitchProps`、`SwitchThumbProps`(与上文子类型配合使用)。
83
+
84
+ ## 代码演示
85
+
86
+ ### 禁用状态
87
+
88
+ 通过 `disabled` 禁止切换。
89
+
90
+ ```tsx
91
+ import { Switch } from '@apexhub/apex-ui-react'
92
+
93
+ export default () => (
94
+ <div style={{ display: 'flex', gap: 16, alignItems: 'center' }}>
95
+ <Switch disabled aria-label="禁用未开" />
96
+ <Switch disabled defaultChecked aria-label="禁用已开" />
97
+ </div>
98
+ )
99
+ ```
100
+
101
+ ### 轨道内内容
102
+
103
+ 通过 `checkedChildren` 和 `unCheckedChildren` 在轨道内展示不同内容。
104
+
105
+ ```tsx
106
+ import { Switch } from '@apexhub/apex-ui-react'
107
+
108
+ export default () => (
109
+ <div style={{ display: 'flex', gap: 16, alignItems: 'center' }}>
110
+ <Switch checkedChildren="开" unCheckedChildren="关" defaultChecked aria-label="文字开关" />
111
+ <Switch checkedChildren="1" unCheckedChildren="0" aria-label="数字开关" />
112
+ </div>
113
+ )
114
+ ```
115
+
116
+ ### 尺寸
117
+
118
+ 支持 `medium`(默认)和 `small` 两种尺寸。
119
+
120
+ ```tsx
121
+ import { Switch } from '@apexhub/apex-ui-react'
122
+
123
+ export default () => (
124
+ <div style={{ display: 'flex', gap: 16, alignItems: 'center' }}>
125
+ <Switch size="medium" defaultChecked aria-label="中号开关" />
126
+ <Switch size="small" defaultChecked aria-label="小号开关" />
127
+ </div>
128
+ )
129
+ ```
130
+
131
+ ### 加载中
132
+
133
+ `loading` 表示开关操作仍在执行中,行为等同禁用。
134
+
135
+ ```tsx
136
+ import { Switch } from '@apexhub/apex-ui-react'
137
+
138
+ export default () => (
139
+ <div style={{ display: 'flex', gap: 16, alignItems: 'center' }}>
140
+ <Switch loading defaultChecked aria-label="加载中已开" />
141
+ <Switch loading size="small" aria-label="小号加载中" />
142
+ </div>
143
+ )
144
+ ```
145
+
146
+ ### 受控用法
147
+
148
+ 通过 `checked` 和 变更事件 控制开关状态。
149
+
150
+ ```tsx
151
+ import { Switch } from '@apexhub/apex-ui-react'
152
+
153
+ import { useState } from 'react'
154
+
155
+ export default () => {
156
+ const [checked, setChecked] = useState(false)
157
+
158
+ return (
159
+ <div style={{ display: 'flex', gap: 12, alignItems: 'center' }}>
160
+ <Switch checked={checked} onChange={setChecked} aria-label="受控开关" />
161
+ <span>{checked ? '已开启' : '已关闭'}</span>
162
+ </div>
163
+ )
164
+ }
165
+ ```
166
+
167
+ ### 事件回调
168
+
169
+ 变更事件 在状态变化时触发;点击事件 在点击时触发,二者都会收到切换后的 `checked` 值。
170
+
171
+ ```tsx
172
+ import { Switch } from '@apexhub/apex-ui-react'
173
+
174
+ import { useState } from 'react'
175
+
176
+ export default () => {
177
+ const [message, setMessage] = useState('等待操作')
178
+
179
+ return (
180
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 8, alignItems: 'flex-start' }}>
181
+ <Switch
182
+ aria-label="事件开关"
183
+ onChange={(checked) => setMessage(`onChange: ${checked ? '开启' : '关闭'}`)}
184
+ onClick={(checked) => setMessage(`onClick: ${checked ? '开启' : '关闭'}`)}
185
+ />
186
+ <span>{message}</span>
187
+ </div>
188
+ )
189
+ }
190
+ ```
191
+
192
+ ## DOM 结构
193
+
194
+ 源码声明的静态 `data-slot`:`switch`、`switch-thumb`。具体节点随模式和状态出现,不表示固定嵌套顺序。
195
+
196
+ ## 样式定制
197
+
198
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../../llms-theme.txt)。
199
+
200
+ 需要定制具体样式时再读取 [Token 明细](./tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
201
+
202
+ ## FAQ
203
+
204
+ ### 表单里应该用 `value` 还是 `checked`?
205
+
206
+ Switch 不提供 `value` / `defaultValue` 别名;与 Form 集成时请使用 `valuePropName="checked"`。
207
+
208
+
209
+ ### `loading` 和 `disabled` 有什么区别?
210
+
211
+ 二者都会阻止切换且不触发 `onChange` / `onClick`;`loading` 额外展示加载态并设置 `aria-busy`,表示操作仍在进行中。
212
+
213
+
214
+ ### 为什么没有 `classNames` / `styles` 分段定制?
215
+
216
+ 当前版本不支持 antd 式语义分段覆写;样式定制请通过根节点 `className`、`data-slot` 与 CSS Token 实现。
@@ -0,0 +1,38 @@
1
+ # Switch Token 明细
2
+
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.0`(当前源码快照)。
4
+
5
+ 按需读取:[组件用法](./llm.txt) · [主题与覆盖规则](../../llms-theme.txt)。
6
+
7
+ 以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
8
+
9
+ 定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
10
+
11
+ | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
+ | --- | --- | --- | --- |
13
+ | `--switch-fill-off` | `background-color` | `var(--apex-fill-neutral-septenary)` | `.apex-switch.apex-default-switch` |
14
+ | `--switch-fill-off-disabled` | `background-color` | `var(--apex-fill-neutral-septenary)` | `.apex-switch.apex-default-switch` |
15
+ | `--switch-fill-on` | `background-color`、`outline` | `var(--apex-fill-brand-primary)` | `.apex-switch.apex-default-switch` |
16
+ | `--switch-fill-on-disabled` | `background-color` | `var(--apex-fill-brand-disabled)` | `.apex-switch.apex-default-switch` |
17
+ | `--switch-icon-icon` | `font-size` | `var(--apex-icon-12)` | `.apex-switch.apex-md-switch` |
18
+ | `--switch-icon-icon` | `font-size` | `var(--apex-icon-12)` | `.apex-switch.apex-sm-switch` |
19
+ | `--switch-radius-radius` | `border-radius` | `var(--apex-radius-999)` | `.apex-switch.apex-md-switch` |
20
+ | `--switch-radius-radius` | `border-radius` | `var(--apex-radius-999)` | `.apex-switch.apex-sm-switch` |
21
+ | `--switch-spacing-height` | `height` | `var(--apex-size-24)` | `.apex-switch.apex-md-switch` |
22
+ | `--switch-spacing-height` | `height` | `var(--apex-size-16)` | `.apex-switch.apex-sm-switch` |
23
+ | `--switch-spacing-height-toggle` | `height`、`left`、`margin-top`、`padding-inline`、`transform`、`width` | `var(--apex-size-20)` | `.apex-switch.apex-md-switch` |
24
+ | `--switch-spacing-height-toggle` | `height`、`left`、`margin-top`、`padding-inline`、`transform`、`width` | `var(--apex-size-12)` | `.apex-switch.apex-sm-switch` |
25
+ | `--switch-spacing-padding-text` | `padding-inline` | `var(--apex-spacing-4)` | `.apex-switch.apex-md-switch` |
26
+ | `--switch-spacing-padding-text` | `padding-inline` | `var(--apex-spacing-4)` | `.apex-switch.apex-sm-switch` |
27
+ | `--switch-spacing-padding-x` | `left`、`transform` | `var(--apex-spacing-2)` | `.apex-switch.apex-md-switch` |
28
+ | `--switch-spacing-padding-x` | `left`、`transform` | `var(--apex-spacing-2)` | `.apex-switch.apex-sm-switch` |
29
+ | `--switch-spacing-width` | `min-width`、`transform`、`width` | `var(--apex-size-44)` | `.apex-switch.apex-md-switch` |
30
+ | `--switch-spacing-width` | `min-width`、`transform`、`width` | `var(--apex-size-28)` | `.apex-switch.apex-sm-switch` |
31
+ | `--switch-text-off` | `color` | `var(--apex-text-neutral-primary)` | `.apex-switch.apex-default-switch` |
32
+ | `--switch-text-off-desabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-switch.apex-default-switch` |
33
+ | `--switch-text-on` | `color` | `var(--apex-text-neutral-primary)` | `.apex-switch.apex-default-switch` |
34
+ | `--switch-text-on-disabled` | `color` | `var(--apex-text-neutral-disabled)` | `.apex-switch.apex-default-switch` |
35
+ | `--switch-toggle-off` | `background-color` | `var(--apex-fill-neutral-denary-stable)` | `.apex-switch.apex-default-switch` |
36
+ | `--switch-toggle-off-disabled` | `background-color` | `var(--apex-fill-neutral-octonary-stable)` | `.apex-switch.apex-default-switch` |
37
+ | `--switch-toggle-on` | `background-color` | `var(--apex-fill-neutral-denary-stable)` | `.apex-switch.apex-default-switch` |
38
+ | `--switch-toggle-on-disabled` | `background-color` | `var(--apex-fill-neutral-octonary-stable)` | `.apex-switch.apex-default-switch` |