@dashforge/tw 0.1.0-beta
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/.swcrc +29 -0
- package/CHANGELOG.md +131 -0
- package/LICENSE +21 -0
- package/README.md +244 -0
- package/dist/components/AppShell/AppShell.d.ts +32 -0
- package/dist/components/AppShell/AppShell.d.ts.map +1 -0
- package/dist/components/AppShell/appShell.types.d.ts +62 -0
- package/dist/components/AppShell/appShell.types.d.ts.map +1 -0
- package/dist/components/AppShell/appShell.variants.d.ts +65 -0
- package/dist/components/AppShell/appShell.variants.d.ts.map +1 -0
- package/dist/components/Autocomplete/Autocomplete.d.ts +32 -0
- package/dist/components/Autocomplete/Autocomplete.d.ts.map +1 -0
- package/dist/components/Autocomplete/autocomplete.types.d.ts +214 -0
- package/dist/components/Autocomplete/autocomplete.types.d.ts.map +1 -0
- package/dist/components/Autocomplete/autocomplete.variants.d.ts +214 -0
- package/dist/components/Autocomplete/autocomplete.variants.d.ts.map +1 -0
- package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +23 -0
- package/dist/components/Breadcrumbs/Breadcrumbs.d.ts.map +1 -0
- package/dist/components/Breadcrumbs/breadcrumbs.types.d.ts +98 -0
- package/dist/components/Breadcrumbs/breadcrumbs.types.d.ts.map +1 -0
- package/dist/components/Breadcrumbs/breadcrumbs.variants.d.ts +85 -0
- package/dist/components/Breadcrumbs/breadcrumbs.variants.d.ts.map +1 -0
- package/dist/components/Button/Button.d.ts +44 -0
- package/dist/components/Button/Button.d.ts.map +1 -0
- package/dist/components/Button/button.types.d.ts +66 -0
- package/dist/components/Button/button.types.d.ts.map +1 -0
- package/dist/components/Button/button.variants.d.ts +104 -0
- package/dist/components/Button/button.variants.d.ts.map +1 -0
- package/dist/components/Checkbox/Checkbox.d.ts +31 -0
- package/dist/components/Checkbox/Checkbox.d.ts.map +1 -0
- package/dist/components/Checkbox/checkbox.types.d.ts +86 -0
- package/dist/components/Checkbox/checkbox.types.d.ts.map +1 -0
- package/dist/components/Checkbox/checkbox.variants.d.ts +109 -0
- package/dist/components/Checkbox/checkbox.variants.d.ts.map +1 -0
- package/dist/components/ConfirmDialog/ConfirmDialog.d.ts +38 -0
- package/dist/components/ConfirmDialog/ConfirmDialog.d.ts.map +1 -0
- package/dist/components/ConfirmDialog/confirmDialog.types.d.ts +80 -0
- package/dist/components/ConfirmDialog/confirmDialog.types.d.ts.map +1 -0
- package/dist/components/ConfirmDialog/confirmDialog.variants.d.ts +90 -0
- package/dist/components/ConfirmDialog/confirmDialog.variants.d.ts.map +1 -0
- package/dist/components/DateTimePicker/DateTimePicker.d.ts +49 -0
- package/dist/components/DateTimePicker/DateTimePicker.d.ts.map +1 -0
- package/dist/components/DateTimePicker/dateTimePicker.types.d.ts +95 -0
- package/dist/components/DateTimePicker/dateTimePicker.types.d.ts.map +1 -0
- package/dist/components/DateTimePicker/dateTimePicker.variants.d.ts +165 -0
- package/dist/components/DateTimePicker/dateTimePicker.variants.d.ts.map +1 -0
- package/dist/components/LeftNav/LeftNav.d.ts +34 -0
- package/dist/components/LeftNav/LeftNav.d.ts.map +1 -0
- package/dist/components/LeftNav/leftNav.types.d.ts +136 -0
- package/dist/components/LeftNav/leftNav.types.d.ts.map +1 -0
- package/dist/components/LeftNav/leftNav.variants.d.ts +143 -0
- package/dist/components/LeftNav/leftNav.variants.d.ts.map +1 -0
- package/dist/components/NumberField/NumberField.d.ts +18 -0
- package/dist/components/NumberField/NumberField.d.ts.map +1 -0
- package/dist/components/NumberField/numberField.types.d.ts +79 -0
- package/dist/components/NumberField/numberField.types.d.ts.map +1 -0
- package/dist/components/NumberField/numberField.variants.d.ts +169 -0
- package/dist/components/NumberField/numberField.variants.d.ts.map +1 -0
- package/dist/components/OTPField/OTPField.d.ts +25 -0
- package/dist/components/OTPField/OTPField.d.ts.map +1 -0
- package/dist/components/OTPField/otpField.types.d.ts +74 -0
- package/dist/components/OTPField/otpField.types.d.ts.map +1 -0
- package/dist/components/OTPField/otpField.variants.d.ts +105 -0
- package/dist/components/OTPField/otpField.variants.d.ts.map +1 -0
- package/dist/components/RadioGroup/RadioGroup.d.ts +35 -0
- package/dist/components/RadioGroup/RadioGroup.d.ts.map +1 -0
- package/dist/components/RadioGroup/radioGroup.types.d.ts +103 -0
- package/dist/components/RadioGroup/radioGroup.types.d.ts.map +1 -0
- package/dist/components/RadioGroup/radioGroup.variants.d.ts +166 -0
- package/dist/components/RadioGroup/radioGroup.variants.d.ts.map +1 -0
- package/dist/components/Snackbar/Snackbar.d.ts +37 -0
- package/dist/components/Snackbar/Snackbar.d.ts.map +1 -0
- package/dist/components/Snackbar/snackbar.types.d.ts +86 -0
- package/dist/components/Snackbar/snackbar.types.d.ts.map +1 -0
- package/dist/components/Snackbar/snackbar.variants.d.ts +153 -0
- package/dist/components/Snackbar/snackbar.variants.d.ts.map +1 -0
- package/dist/components/Switch/Switch.d.ts +15 -0
- package/dist/components/Switch/Switch.d.ts.map +1 -0
- package/dist/components/Switch/switch.types.d.ts +47 -0
- package/dist/components/Switch/switch.types.d.ts.map +1 -0
- package/dist/components/Switch/switch.variants.d.ts +105 -0
- package/dist/components/Switch/switch.variants.d.ts.map +1 -0
- package/dist/components/TextField/TextField.d.ts +25 -0
- package/dist/components/TextField/TextField.d.ts.map +1 -0
- package/dist/components/TextField/textField.types.d.ts +72 -0
- package/dist/components/TextField/textField.types.d.ts.map +1 -0
- package/dist/components/TextField/textField.variants.d.ts +160 -0
- package/dist/components/TextField/textField.variants.d.ts.map +1 -0
- package/dist/components/Textarea/Textarea.d.ts +16 -0
- package/dist/components/Textarea/Textarea.d.ts.map +1 -0
- package/dist/components/Textarea/textarea.types.d.ts +63 -0
- package/dist/components/Textarea/textarea.types.d.ts.map +1 -0
- package/dist/components/Textarea/textarea.variants.d.ts +197 -0
- package/dist/components/Textarea/textarea.variants.d.ts.map +1 -0
- package/dist/components/TopBar/TopBar.d.ts +33 -0
- package/dist/components/TopBar/TopBar.d.ts.map +1 -0
- package/dist/components/TopBar/topBar.types.d.ts +49 -0
- package/dist/components/TopBar/topBar.types.d.ts.map +1 -0
- package/dist/components/TopBar/topBar.variants.d.ts +79 -0
- package/dist/components/TopBar/topBar.variants.d.ts.map +1 -0
- package/dist/components/_shared/resolveValidationState.d.ts +42 -0
- package/dist/components/_shared/resolveValidationState.d.ts.map +1 -0
- package/dist/hooks/useAccessState.d.ts +37 -0
- package/dist/hooks/useAccessState.d.ts.map +1 -0
- package/dist/index.d.ts +82 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.esm.js +4958 -0
- package/dist/src/components/AppShell/AppShell.d.ts +32 -0
- package/dist/src/components/AppShell/AppShell.d.ts.map +1 -0
- package/dist/src/components/AppShell/appShell.types.d.ts +62 -0
- package/dist/src/components/AppShell/appShell.types.d.ts.map +1 -0
- package/dist/src/components/AppShell/appShell.variants.d.ts +65 -0
- package/dist/src/components/AppShell/appShell.variants.d.ts.map +1 -0
- package/dist/src/components/Autocomplete/Autocomplete.d.ts +32 -0
- package/dist/src/components/Autocomplete/Autocomplete.d.ts.map +1 -0
- package/dist/src/components/Autocomplete/autocomplete.types.d.ts +214 -0
- package/dist/src/components/Autocomplete/autocomplete.types.d.ts.map +1 -0
- package/dist/src/components/Autocomplete/autocomplete.variants.d.ts +214 -0
- package/dist/src/components/Autocomplete/autocomplete.variants.d.ts.map +1 -0
- package/dist/src/components/Breadcrumbs/Breadcrumbs.d.ts +23 -0
- package/dist/src/components/Breadcrumbs/Breadcrumbs.d.ts.map +1 -0
- package/dist/src/components/Breadcrumbs/breadcrumbs.types.d.ts +98 -0
- package/dist/src/components/Breadcrumbs/breadcrumbs.types.d.ts.map +1 -0
- package/dist/src/components/Breadcrumbs/breadcrumbs.variants.d.ts +85 -0
- package/dist/src/components/Breadcrumbs/breadcrumbs.variants.d.ts.map +1 -0
- package/dist/src/components/Button/Button.d.ts +44 -0
- package/dist/src/components/Button/Button.d.ts.map +1 -0
- package/dist/src/components/Button/button.types.d.ts +66 -0
- package/dist/src/components/Button/button.types.d.ts.map +1 -0
- package/dist/src/components/Button/button.variants.d.ts +104 -0
- package/dist/src/components/Button/button.variants.d.ts.map +1 -0
- package/dist/src/components/Checkbox/Checkbox.d.ts +31 -0
- package/dist/src/components/Checkbox/Checkbox.d.ts.map +1 -0
- package/dist/src/components/Checkbox/checkbox.types.d.ts +86 -0
- package/dist/src/components/Checkbox/checkbox.types.d.ts.map +1 -0
- package/dist/src/components/Checkbox/checkbox.variants.d.ts +109 -0
- package/dist/src/components/Checkbox/checkbox.variants.d.ts.map +1 -0
- package/dist/src/components/ConfirmDialog/ConfirmDialog.d.ts +38 -0
- package/dist/src/components/ConfirmDialog/ConfirmDialog.d.ts.map +1 -0
- package/dist/src/components/ConfirmDialog/confirmDialog.types.d.ts +80 -0
- package/dist/src/components/ConfirmDialog/confirmDialog.types.d.ts.map +1 -0
- package/dist/src/components/ConfirmDialog/confirmDialog.variants.d.ts +90 -0
- package/dist/src/components/ConfirmDialog/confirmDialog.variants.d.ts.map +1 -0
- package/dist/src/components/DateTimePicker/DateTimePicker.d.ts +49 -0
- package/dist/src/components/DateTimePicker/DateTimePicker.d.ts.map +1 -0
- package/dist/src/components/DateTimePicker/dateTimePicker.types.d.ts +95 -0
- package/dist/src/components/DateTimePicker/dateTimePicker.types.d.ts.map +1 -0
- package/dist/src/components/DateTimePicker/dateTimePicker.variants.d.ts +165 -0
- package/dist/src/components/DateTimePicker/dateTimePicker.variants.d.ts.map +1 -0
- package/dist/src/components/LeftNav/LeftNav.d.ts +34 -0
- package/dist/src/components/LeftNav/LeftNav.d.ts.map +1 -0
- package/dist/src/components/LeftNav/leftNav.types.d.ts +136 -0
- package/dist/src/components/LeftNav/leftNav.types.d.ts.map +1 -0
- package/dist/src/components/LeftNav/leftNav.variants.d.ts +143 -0
- package/dist/src/components/LeftNav/leftNav.variants.d.ts.map +1 -0
- package/dist/src/components/NumberField/NumberField.d.ts +18 -0
- package/dist/src/components/NumberField/NumberField.d.ts.map +1 -0
- package/dist/src/components/NumberField/numberField.types.d.ts +79 -0
- package/dist/src/components/NumberField/numberField.types.d.ts.map +1 -0
- package/dist/src/components/NumberField/numberField.variants.d.ts +169 -0
- package/dist/src/components/NumberField/numberField.variants.d.ts.map +1 -0
- package/dist/src/components/OTPField/OTPField.d.ts +25 -0
- package/dist/src/components/OTPField/OTPField.d.ts.map +1 -0
- package/dist/src/components/OTPField/otpField.types.d.ts +74 -0
- package/dist/src/components/OTPField/otpField.types.d.ts.map +1 -0
- package/dist/src/components/OTPField/otpField.variants.d.ts +105 -0
- package/dist/src/components/OTPField/otpField.variants.d.ts.map +1 -0
- package/dist/src/components/RadioGroup/RadioGroup.d.ts +35 -0
- package/dist/src/components/RadioGroup/RadioGroup.d.ts.map +1 -0
- package/dist/src/components/RadioGroup/radioGroup.types.d.ts +103 -0
- package/dist/src/components/RadioGroup/radioGroup.types.d.ts.map +1 -0
- package/dist/src/components/RadioGroup/radioGroup.variants.d.ts +166 -0
- package/dist/src/components/RadioGroup/radioGroup.variants.d.ts.map +1 -0
- package/dist/src/components/Snackbar/Snackbar.d.ts +37 -0
- package/dist/src/components/Snackbar/Snackbar.d.ts.map +1 -0
- package/dist/src/components/Snackbar/snackbar.types.d.ts +86 -0
- package/dist/src/components/Snackbar/snackbar.types.d.ts.map +1 -0
- package/dist/src/components/Snackbar/snackbar.variants.d.ts +153 -0
- package/dist/src/components/Snackbar/snackbar.variants.d.ts.map +1 -0
- package/dist/src/components/Switch/Switch.d.ts +15 -0
- package/dist/src/components/Switch/Switch.d.ts.map +1 -0
- package/dist/src/components/Switch/switch.types.d.ts +47 -0
- package/dist/src/components/Switch/switch.types.d.ts.map +1 -0
- package/dist/src/components/Switch/switch.variants.d.ts +105 -0
- package/dist/src/components/Switch/switch.variants.d.ts.map +1 -0
- package/dist/src/components/TextField/TextField.d.ts +25 -0
- package/dist/src/components/TextField/TextField.d.ts.map +1 -0
- package/dist/src/components/TextField/textField.types.d.ts +72 -0
- package/dist/src/components/TextField/textField.types.d.ts.map +1 -0
- package/dist/src/components/TextField/textField.variants.d.ts +160 -0
- package/dist/src/components/TextField/textField.variants.d.ts.map +1 -0
- package/dist/src/components/Textarea/Textarea.d.ts +16 -0
- package/dist/src/components/Textarea/Textarea.d.ts.map +1 -0
- package/dist/src/components/Textarea/textarea.types.d.ts +63 -0
- package/dist/src/components/Textarea/textarea.types.d.ts.map +1 -0
- package/dist/src/components/Textarea/textarea.variants.d.ts +197 -0
- package/dist/src/components/Textarea/textarea.variants.d.ts.map +1 -0
- package/dist/src/components/TopBar/TopBar.d.ts +33 -0
- package/dist/src/components/TopBar/TopBar.d.ts.map +1 -0
- package/dist/src/components/TopBar/topBar.types.d.ts +49 -0
- package/dist/src/components/TopBar/topBar.types.d.ts.map +1 -0
- package/dist/src/components/TopBar/topBar.variants.d.ts +79 -0
- package/dist/src/components/TopBar/topBar.variants.d.ts.map +1 -0
- package/dist/src/components/_shared/resolveValidationState.d.ts +42 -0
- package/dist/src/components/_shared/resolveValidationState.d.ts.map +1 -0
- package/dist/src/hooks/useAccessState.d.ts +37 -0
- package/dist/src/hooks/useAccessState.d.ts.map +1 -0
- package/dist/src/index.d.ts +82 -0
- package/dist/src/index.d.ts.map +1 -0
- package/dist/src/utils/cn.d.ts +26 -0
- package/dist/src/utils/cn.d.ts.map +1 -0
- package/dist/tsconfig.lib.tsbuildinfo +1 -0
- package/dist/utils/cn.d.ts +26 -0
- package/dist/utils/cn.d.ts.map +1 -0
- package/eslint.config.mjs +47 -0
- package/package.json +37 -0
- package/project.json +15 -0
- package/rollup.config.cjs +16 -0
- package/src/components/AppShell/AppShell.test.tsx +223 -0
- package/src/components/AppShell/AppShell.tsx +114 -0
- package/src/components/AppShell/appShell.types.ts +49 -0
- package/src/components/AppShell/appShell.variants.ts +48 -0
- package/src/components/Autocomplete/Autocomplete.perf.test.tsx +225 -0
- package/src/components/Autocomplete/Autocomplete.test.tsx +556 -0
- package/src/components/Autocomplete/Autocomplete.tsx +996 -0
- package/src/components/Autocomplete/autocomplete.types.ts +198 -0
- package/src/components/Autocomplete/autocomplete.variants.ts +135 -0
- package/src/components/Breadcrumbs/Breadcrumbs.perf.test.tsx +125 -0
- package/src/components/Breadcrumbs/Breadcrumbs.test.tsx +231 -0
- package/src/components/Breadcrumbs/Breadcrumbs.tsx +203 -0
- package/src/components/Breadcrumbs/breadcrumbs.types.ts +87 -0
- package/src/components/Breadcrumbs/breadcrumbs.variants.ts +49 -0
- package/src/components/Button/Button.test.tsx +183 -0
- package/src/components/Button/Button.tsx +139 -0
- package/src/components/Button/button.types.ts +74 -0
- package/src/components/Button/button.variants.ts +159 -0
- package/src/components/Checkbox/Checkbox.test.tsx +146 -0
- package/src/components/Checkbox/Checkbox.tsx +228 -0
- package/src/components/Checkbox/checkbox.types.ts +88 -0
- package/src/components/Checkbox/checkbox.variants.ts +68 -0
- package/src/components/ConfirmDialog/ConfirmDialog.perf.test.tsx +172 -0
- package/src/components/ConfirmDialog/ConfirmDialog.test.tsx +311 -0
- package/src/components/ConfirmDialog/ConfirmDialog.tsx +252 -0
- package/src/components/ConfirmDialog/confirmDialog.types.ts +70 -0
- package/src/components/ConfirmDialog/confirmDialog.variants.ts +76 -0
- package/src/components/DateTimePicker/DateTimePicker.perf.test.tsx +153 -0
- package/src/components/DateTimePicker/DateTimePicker.test.tsx +204 -0
- package/src/components/DateTimePicker/DateTimePicker.tsx +319 -0
- package/src/components/DateTimePicker/dateTimePicker.types.ts +83 -0
- package/src/components/DateTimePicker/dateTimePicker.variants.ts +84 -0
- package/src/components/LeftNav/LeftNav.perf.test.tsx +172 -0
- package/src/components/LeftNav/LeftNav.test.tsx +302 -0
- package/src/components/LeftNav/LeftNav.tsx +330 -0
- package/src/components/LeftNav/leftNav.types.ts +120 -0
- package/src/components/LeftNav/leftNav.variants.ts +96 -0
- package/src/components/NumberField/NumberField.test.tsx +83 -0
- package/src/components/NumberField/NumberField.tsx +293 -0
- package/src/components/NumberField/numberField.types.ts +72 -0
- package/src/components/NumberField/numberField.variants.ts +94 -0
- package/src/components/OTPField/OTPField.test.tsx +121 -0
- package/src/components/OTPField/OTPField.tsx +250 -0
- package/src/components/OTPField/otpField.types.ts +58 -0
- package/src/components/OTPField/otpField.variants.ts +72 -0
- package/src/components/RadioGroup/RadioGroup.test.tsx +140 -0
- package/src/components/RadioGroup/RadioGroup.tsx +261 -0
- package/src/components/RadioGroup/radioGroup.types.ts +85 -0
- package/src/components/RadioGroup/radioGroup.variants.ts +87 -0
- package/src/components/Snackbar/Snackbar.perf.test.tsx +144 -0
- package/src/components/Snackbar/Snackbar.test.tsx +327 -0
- package/src/components/Snackbar/Snackbar.tsx +298 -0
- package/src/components/Snackbar/snackbar.types.ts +83 -0
- package/src/components/Snackbar/snackbar.variants.ts +72 -0
- package/src/components/Switch/Switch.test.tsx +131 -0
- package/src/components/Switch/Switch.tsx +158 -0
- package/src/components/Switch/switch.types.ts +36 -0
- package/src/components/Switch/switch.variants.ts +65 -0
- package/src/components/TextField/TextField.test.tsx +194 -0
- package/src/components/TextField/TextField.tsx +216 -0
- package/src/components/TextField/textField.types.ts +70 -0
- package/src/components/TextField/textField.variants.ts +87 -0
- package/src/components/Textarea/Textarea.test.tsx +75 -0
- package/src/components/Textarea/Textarea.tsx +190 -0
- package/src/components/Textarea/textarea.types.ts +60 -0
- package/src/components/Textarea/textarea.variants.ts +85 -0
- package/src/components/TopBar/TopBar.test.tsx +129 -0
- package/src/components/TopBar/TopBar.tsx +66 -0
- package/src/components/TopBar/topBar.types.ts +42 -0
- package/src/components/TopBar/topBar.variants.ts +38 -0
- package/src/components/_shared/resolveValidationState.ts +60 -0
- package/src/hooks/useAccessState.spec.tsx +161 -0
- package/src/hooks/useAccessState.ts +81 -0
- package/src/index.ts +191 -0
- package/src/utils/cn.spec.ts +16 -0
- package/src/utils/cn.ts +29 -0
- package/tsconfig.json +13 -0
- package/tsconfig.lib.json +55 -0
- package/tsconfig.spec.json +34 -0
- package/vite.config.ts +25 -0
- package/vitest.config.mts +22 -0
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { type VariantProps } from 'tailwind-variants';
|
|
2
|
+
/**
|
|
3
|
+
* Tailwind-variants recipe for `<OTPField>`.
|
|
4
|
+
*
|
|
5
|
+
* Slots:
|
|
6
|
+
* - `root` — outer wrapper (label + slots row + helper/error)
|
|
7
|
+
* - `label` — group-level label
|
|
8
|
+
* - `requiredMark` — red `*` for required fields
|
|
9
|
+
* - `slotsRow` — flex row holding the visible slot boxes
|
|
10
|
+
* - `slot` — single slot cell (visual representation of a char)
|
|
11
|
+
* - `slotChar` — the character displayed inside a slot
|
|
12
|
+
* - `hiddenInput` — the actual <input> absorbing keystrokes (visually
|
|
13
|
+
* hidden but focusable + reads as a single
|
|
14
|
+
* one-line text input to AT)
|
|
15
|
+
* - `helperText` — descriptive line below
|
|
16
|
+
* - `errorText` — semantic counterpart of helperText for error mode
|
|
17
|
+
*
|
|
18
|
+
* Variants:
|
|
19
|
+
* - `size` : sm / md / lg — drives slot box dimensions + text size
|
|
20
|
+
* - `error` : bool — swaps slot border + helperText color to danger tones
|
|
21
|
+
*/
|
|
22
|
+
export declare const otpFieldVariants: import("tailwind-variants").TVReturnType<{
|
|
23
|
+
size: {
|
|
24
|
+
sm: {
|
|
25
|
+
slot: string;
|
|
26
|
+
};
|
|
27
|
+
md: {
|
|
28
|
+
slot: string;
|
|
29
|
+
};
|
|
30
|
+
lg: {
|
|
31
|
+
slot: string;
|
|
32
|
+
};
|
|
33
|
+
};
|
|
34
|
+
error: {
|
|
35
|
+
true: {
|
|
36
|
+
slot: string;
|
|
37
|
+
};
|
|
38
|
+
};
|
|
39
|
+
}, {
|
|
40
|
+
root: string;
|
|
41
|
+
label: string;
|
|
42
|
+
requiredMark: string;
|
|
43
|
+
slotsRow: string;
|
|
44
|
+
slot: string[];
|
|
45
|
+
slotChar: string;
|
|
46
|
+
hiddenInput: string[];
|
|
47
|
+
helperText: string;
|
|
48
|
+
errorText: string;
|
|
49
|
+
}, undefined, {
|
|
50
|
+
size: {
|
|
51
|
+
sm: {
|
|
52
|
+
slot: string;
|
|
53
|
+
};
|
|
54
|
+
md: {
|
|
55
|
+
slot: string;
|
|
56
|
+
};
|
|
57
|
+
lg: {
|
|
58
|
+
slot: string;
|
|
59
|
+
};
|
|
60
|
+
};
|
|
61
|
+
error: {
|
|
62
|
+
true: {
|
|
63
|
+
slot: string;
|
|
64
|
+
};
|
|
65
|
+
};
|
|
66
|
+
}, {
|
|
67
|
+
root: string;
|
|
68
|
+
label: string;
|
|
69
|
+
requiredMark: string;
|
|
70
|
+
slotsRow: string;
|
|
71
|
+
slot: string[];
|
|
72
|
+
slotChar: string;
|
|
73
|
+
hiddenInput: string[];
|
|
74
|
+
helperText: string;
|
|
75
|
+
errorText: string;
|
|
76
|
+
}, import("tailwind-variants").TVReturnType<{
|
|
77
|
+
size: {
|
|
78
|
+
sm: {
|
|
79
|
+
slot: string;
|
|
80
|
+
};
|
|
81
|
+
md: {
|
|
82
|
+
slot: string;
|
|
83
|
+
};
|
|
84
|
+
lg: {
|
|
85
|
+
slot: string;
|
|
86
|
+
};
|
|
87
|
+
};
|
|
88
|
+
error: {
|
|
89
|
+
true: {
|
|
90
|
+
slot: string;
|
|
91
|
+
};
|
|
92
|
+
};
|
|
93
|
+
}, {
|
|
94
|
+
root: string;
|
|
95
|
+
label: string;
|
|
96
|
+
requiredMark: string;
|
|
97
|
+
slotsRow: string;
|
|
98
|
+
slot: string[];
|
|
99
|
+
slotChar: string;
|
|
100
|
+
hiddenInput: string[];
|
|
101
|
+
helperText: string;
|
|
102
|
+
errorText: string;
|
|
103
|
+
}, undefined, unknown, unknown, undefined>>;
|
|
104
|
+
export type OTPFieldVariants = VariantProps<typeof otpFieldVariants>;
|
|
105
|
+
//# sourceMappingURL=otpField.variants.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"otpField.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/OTPField/otpField.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CA+C3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { RadioGroupProps } from './radioGroup.types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Dashforge TW RadioGroup — bridge-integrated single-choice group.
|
|
4
|
+
*
|
|
5
|
+
* Renders through Radix `RadioGroup.Root` + `Item` + `Indicator`, styled
|
|
6
|
+
* with the `radioGroupVariants` TV recipe. Behaviour at the bridge level
|
|
7
|
+
* is a 1:1 port of `@dashforge/ui/RadioGroup` (MUI):
|
|
8
|
+
*
|
|
9
|
+
* - Inside `DashFormProvider`: registers with the bridge, reads
|
|
10
|
+
* `useDashFieldMeta` for the selected value (reactive snapshot),
|
|
11
|
+
* writes through `bridge.setValue` on change, fires
|
|
12
|
+
* `registration.onChange` / `onBlur` for RHF.
|
|
13
|
+
* - Outside: behaves as a plain Radix RadioGroup (controlled by `value`
|
|
14
|
+
* + `onValueChange`, or uncontrolled via `defaultValue`).
|
|
15
|
+
* - `visibleWhen` predicates the engine state.
|
|
16
|
+
* - `useAccessState(access)` resolves group-level RBAC; per-option RBAC
|
|
17
|
+
* is resolved by calling `useAccessState` for every entry of the
|
|
18
|
+
* `options` array (Rules of Hooks: stable as long as `options.length`
|
|
19
|
+
* is stable, which is the documented contract — mutating the array
|
|
20
|
+
* between renders breaks).
|
|
21
|
+
* - Group-level RBAC has precedence over option-level (hide-the-group
|
|
22
|
+
* wins even if some options would be visible).
|
|
23
|
+
* - Error gating: bridge error shows only after `touched` or after the
|
|
24
|
+
* form has been submitted at least once (Form Closure v1).
|
|
25
|
+
* - StrictMode-safe unregister-on-unmount, mirrors Checkbox/Switch.
|
|
26
|
+
*
|
|
27
|
+
* **A11y**:
|
|
28
|
+
* - The group root is a `<div role="radiogroup">` (Radix default).
|
|
29
|
+
* - A `<label id="...">` is associated with the group via `aria-labelledby`.
|
|
30
|
+
* - The helper/error text is linked via `aria-describedby`.
|
|
31
|
+
* - Each option is a Radix `<RadioGroup.Item>` (`<button role="radio">`)
|
|
32
|
+
* keyboard-accessible by default (arrow keys move selection).
|
|
33
|
+
*/
|
|
34
|
+
export declare function RadioGroup(props: RadioGroupProps): import("react/jsx-runtime").JSX.Element | null;
|
|
35
|
+
//# sourceMappingURL=RadioGroup.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../../src/components/RadioGroup/RadioGroup.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,kDAyNhD"}
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import type { ReactNode } from 'react';
|
|
2
|
+
import type { Engine } from '@dashforge/ui-core';
|
|
3
|
+
import type { AccessRequirement } from '@dashforge/rbac';
|
|
4
|
+
import type { RadioGroupVariants } from './radioGroup.variants.js';
|
|
5
|
+
/**
|
|
6
|
+
* A single selectable option in a `<RadioGroup>`.
|
|
7
|
+
*/
|
|
8
|
+
export interface RadioGroupOption {
|
|
9
|
+
/** The string value persisted on the form for this option. */
|
|
10
|
+
value: string;
|
|
11
|
+
/** Display label (string or any React node — e.g. with an icon). */
|
|
12
|
+
label: ReactNode;
|
|
13
|
+
/** Per-option explicit disable. ORed with group-level disable + RBAC. */
|
|
14
|
+
disabled?: boolean;
|
|
15
|
+
/**
|
|
16
|
+
* RBAC access requirement for this specific option:
|
|
17
|
+
* - `onUnauthorized: 'hide'` → option not rendered (unless it's the currently selected value, kept disabled to expose the choice)
|
|
18
|
+
* - `onUnauthorized: 'disable'` → option visible but not selectable
|
|
19
|
+
* - `onUnauthorized: 'readonly'` → falls back to disabled (radios have no true readonly semantics)
|
|
20
|
+
*
|
|
21
|
+
* Group-level access has **precedence** over option-level access — if the
|
|
22
|
+
* whole group is hidden/disabled, that wins for all options regardless of
|
|
23
|
+
* their own access.
|
|
24
|
+
*/
|
|
25
|
+
access?: AccessRequirement;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Optional className override for each slot. Use to extend specific parts
|
|
29
|
+
* of the recipe without losing the default classes. Override semantics
|
|
30
|
+
* follow the `tailwind-merge` last-wins rule.
|
|
31
|
+
*/
|
|
32
|
+
export interface RadioGroupSlotProps {
|
|
33
|
+
root?: {
|
|
34
|
+
className?: string;
|
|
35
|
+
};
|
|
36
|
+
label?: {
|
|
37
|
+
className?: string;
|
|
38
|
+
};
|
|
39
|
+
requiredMark?: {
|
|
40
|
+
className?: string;
|
|
41
|
+
};
|
|
42
|
+
optionList?: {
|
|
43
|
+
className?: string;
|
|
44
|
+
};
|
|
45
|
+
option?: {
|
|
46
|
+
className?: string;
|
|
47
|
+
};
|
|
48
|
+
control?: {
|
|
49
|
+
className?: string;
|
|
50
|
+
};
|
|
51
|
+
indicator?: {
|
|
52
|
+
className?: string;
|
|
53
|
+
};
|
|
54
|
+
optionLabel?: {
|
|
55
|
+
className?: string;
|
|
56
|
+
};
|
|
57
|
+
helperText?: {
|
|
58
|
+
className?: string;
|
|
59
|
+
};
|
|
60
|
+
errorText?: {
|
|
61
|
+
className?: string;
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Props for `<RadioGroup>`.
|
|
66
|
+
*
|
|
67
|
+
* Mirrors the MUI-side `@dashforge/ui/RadioGroup` at the bridge level —
|
|
68
|
+
* same `name` / `rules` / `visibleWhen` / `access` semantics, same
|
|
69
|
+
* Form Closure v1 error gating, same option-level RBAC.
|
|
70
|
+
*/
|
|
71
|
+
export interface RadioGroupProps extends RadioGroupVariants {
|
|
72
|
+
/** Field name registered with the bridge. */
|
|
73
|
+
name: string;
|
|
74
|
+
/** Array of selectable options. Order is render order. */
|
|
75
|
+
options: RadioGroupOption[];
|
|
76
|
+
/** Group-level label (rendered above the option list). */
|
|
77
|
+
label?: ReactNode;
|
|
78
|
+
/** React Hook Form validation rules — forwarded to `bridge.register`. */
|
|
79
|
+
rules?: unknown;
|
|
80
|
+
/** Helper text shown below the option list when not in error state. */
|
|
81
|
+
helperText?: ReactNode;
|
|
82
|
+
/** Marks the group as required (renders red `*` after the label). */
|
|
83
|
+
required?: boolean;
|
|
84
|
+
/** Explicit error override (otherwise resolved from bridge). */
|
|
85
|
+
error?: boolean;
|
|
86
|
+
/** Explicit disable override (ORed with RBAC). */
|
|
87
|
+
disabled?: boolean;
|
|
88
|
+
/** Engine predicate — group not rendered when it returns `false`. */
|
|
89
|
+
visibleWhen?: (engine: Engine) => boolean;
|
|
90
|
+
/** Group-level RBAC requirement (precedes option-level access). */
|
|
91
|
+
access?: AccessRequirement;
|
|
92
|
+
/** Root className shortcut (`cn`'d with the variant root class). */
|
|
93
|
+
sx?: string;
|
|
94
|
+
/** Per-slot className overrides. */
|
|
95
|
+
slotProps?: RadioGroupSlotProps;
|
|
96
|
+
/** Controlled value (for standalone mode without a form bridge). */
|
|
97
|
+
value?: string;
|
|
98
|
+
/** Default value for uncontrolled mode (no-op in form mode — bridge wins). */
|
|
99
|
+
defaultValue?: string;
|
|
100
|
+
/** Change handler (called *after* bridge update in form mode). */
|
|
101
|
+
onValueChange?: (value: string) => void;
|
|
102
|
+
}
|
|
103
|
+
//# sourceMappingURL=radioGroup.types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"radioGroup.types.d.ts","sourceRoot":"","sources":["../../../../src/components/RadioGroup/radioGroup.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,SAAS,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,mEAAmE;IACnE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,oEAAoE;IACpE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC"}
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
import { type VariantProps } from 'tailwind-variants';
|
|
2
|
+
/**
|
|
3
|
+
* Tailwind-variants recipe for `<RadioGroup>` with slots.
|
|
4
|
+
*
|
|
5
|
+
* Slots:
|
|
6
|
+
* - `root` — outer wrapper (label + option list + helper/error)
|
|
7
|
+
* - `label` — group-level label (rendered above the option list)
|
|
8
|
+
* - `requiredMark` — red asterisk for required groups
|
|
9
|
+
* - `optionList` — container for the radio options (flex direction
|
|
10
|
+
* decided by the `layout` variant)
|
|
11
|
+
* - `option` — wrapper for a single option (control + label)
|
|
12
|
+
* - `control` — visible circle (Radix `RadioGroup.Item`)
|
|
13
|
+
* - `indicator` — inner dot (Radix `RadioGroup.Indicator`)
|
|
14
|
+
* - `optionLabel` — text label associated with the control
|
|
15
|
+
* - `helperText` — descriptive line below the option list
|
|
16
|
+
* - `errorText` — semantic counterpart of helperText for error mode
|
|
17
|
+
*
|
|
18
|
+
* Variants:
|
|
19
|
+
* - `size` : sm / md / lg — drives control circle + label text size
|
|
20
|
+
* - `layout` : stacked (vertical, default) / row (horizontal)
|
|
21
|
+
* - `error` : bool — swaps borders + helperText color to danger tones
|
|
22
|
+
*/
|
|
23
|
+
export declare const radioGroupVariants: import("tailwind-variants").TVReturnType<{
|
|
24
|
+
size: {
|
|
25
|
+
sm: {
|
|
26
|
+
control: string;
|
|
27
|
+
indicator: string;
|
|
28
|
+
optionLabel: string;
|
|
29
|
+
};
|
|
30
|
+
md: {
|
|
31
|
+
control: string;
|
|
32
|
+
indicator: string;
|
|
33
|
+
optionLabel: string;
|
|
34
|
+
};
|
|
35
|
+
lg: {
|
|
36
|
+
control: string;
|
|
37
|
+
indicator: string;
|
|
38
|
+
optionLabel: string;
|
|
39
|
+
};
|
|
40
|
+
};
|
|
41
|
+
layout: {
|
|
42
|
+
stacked: {
|
|
43
|
+
optionList: string;
|
|
44
|
+
};
|
|
45
|
+
row: {
|
|
46
|
+
optionList: string;
|
|
47
|
+
};
|
|
48
|
+
};
|
|
49
|
+
error: {
|
|
50
|
+
true: {
|
|
51
|
+
control: string;
|
|
52
|
+
};
|
|
53
|
+
};
|
|
54
|
+
disabled: {
|
|
55
|
+
true: {
|
|
56
|
+
control: string;
|
|
57
|
+
};
|
|
58
|
+
};
|
|
59
|
+
}, {
|
|
60
|
+
root: string;
|
|
61
|
+
label: string;
|
|
62
|
+
requiredMark: string;
|
|
63
|
+
optionList: string;
|
|
64
|
+
option: string;
|
|
65
|
+
control: string[];
|
|
66
|
+
indicator: string;
|
|
67
|
+
optionLabel: string;
|
|
68
|
+
helperText: string;
|
|
69
|
+
errorText: string;
|
|
70
|
+
}, undefined, {
|
|
71
|
+
size: {
|
|
72
|
+
sm: {
|
|
73
|
+
control: string;
|
|
74
|
+
indicator: string;
|
|
75
|
+
optionLabel: string;
|
|
76
|
+
};
|
|
77
|
+
md: {
|
|
78
|
+
control: string;
|
|
79
|
+
indicator: string;
|
|
80
|
+
optionLabel: string;
|
|
81
|
+
};
|
|
82
|
+
lg: {
|
|
83
|
+
control: string;
|
|
84
|
+
indicator: string;
|
|
85
|
+
optionLabel: string;
|
|
86
|
+
};
|
|
87
|
+
};
|
|
88
|
+
layout: {
|
|
89
|
+
stacked: {
|
|
90
|
+
optionList: string;
|
|
91
|
+
};
|
|
92
|
+
row: {
|
|
93
|
+
optionList: string;
|
|
94
|
+
};
|
|
95
|
+
};
|
|
96
|
+
error: {
|
|
97
|
+
true: {
|
|
98
|
+
control: string;
|
|
99
|
+
};
|
|
100
|
+
};
|
|
101
|
+
disabled: {
|
|
102
|
+
true: {
|
|
103
|
+
control: string;
|
|
104
|
+
};
|
|
105
|
+
};
|
|
106
|
+
}, {
|
|
107
|
+
root: string;
|
|
108
|
+
label: string;
|
|
109
|
+
requiredMark: string;
|
|
110
|
+
optionList: string;
|
|
111
|
+
option: string;
|
|
112
|
+
control: string[];
|
|
113
|
+
indicator: string;
|
|
114
|
+
optionLabel: string;
|
|
115
|
+
helperText: string;
|
|
116
|
+
errorText: string;
|
|
117
|
+
}, import("tailwind-variants").TVReturnType<{
|
|
118
|
+
size: {
|
|
119
|
+
sm: {
|
|
120
|
+
control: string;
|
|
121
|
+
indicator: string;
|
|
122
|
+
optionLabel: string;
|
|
123
|
+
};
|
|
124
|
+
md: {
|
|
125
|
+
control: string;
|
|
126
|
+
indicator: string;
|
|
127
|
+
optionLabel: string;
|
|
128
|
+
};
|
|
129
|
+
lg: {
|
|
130
|
+
control: string;
|
|
131
|
+
indicator: string;
|
|
132
|
+
optionLabel: string;
|
|
133
|
+
};
|
|
134
|
+
};
|
|
135
|
+
layout: {
|
|
136
|
+
stacked: {
|
|
137
|
+
optionList: string;
|
|
138
|
+
};
|
|
139
|
+
row: {
|
|
140
|
+
optionList: string;
|
|
141
|
+
};
|
|
142
|
+
};
|
|
143
|
+
error: {
|
|
144
|
+
true: {
|
|
145
|
+
control: string;
|
|
146
|
+
};
|
|
147
|
+
};
|
|
148
|
+
disabled: {
|
|
149
|
+
true: {
|
|
150
|
+
control: string;
|
|
151
|
+
};
|
|
152
|
+
};
|
|
153
|
+
}, {
|
|
154
|
+
root: string;
|
|
155
|
+
label: string;
|
|
156
|
+
requiredMark: string;
|
|
157
|
+
optionList: string;
|
|
158
|
+
option: string;
|
|
159
|
+
control: string[];
|
|
160
|
+
indicator: string;
|
|
161
|
+
optionLabel: string;
|
|
162
|
+
helperText: string;
|
|
163
|
+
errorText: string;
|
|
164
|
+
}, undefined, unknown, unknown, undefined>>;
|
|
165
|
+
export type RadioGroupVariants = VariantProps<typeof radioGroupVariants>;
|
|
166
|
+
//# sourceMappingURL=radioGroup.variants.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"radioGroup.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/RadioGroup/radioGroup.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CA6D7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import type { SnackbarApi, SnackbarProviderProps } from './snackbar.types.js';
|
|
2
|
+
/**
|
|
3
|
+
* `useSnackbar()` — returns `{ enqueue, dismiss, dismissAll }`.
|
|
4
|
+
*
|
|
5
|
+
* Throws if called outside `<SnackbarProvider>` — silent no-op would
|
|
6
|
+
* be a footgun for "Saved!" toasts that silently vanish.
|
|
7
|
+
*/
|
|
8
|
+
export declare function useSnackbar(): SnackbarApi;
|
|
9
|
+
/**
|
|
10
|
+
* Dashforge TW Snackbar provider — transient, stacked toast notifications.
|
|
11
|
+
*
|
|
12
|
+
* **Behaviour**:
|
|
13
|
+
* - `enqueue(opts)` returns the assigned `id`.
|
|
14
|
+
* - Items appear in a fixed-corner stack (`position` prop).
|
|
15
|
+
* - At most `maxVisible` (default 5) are shown — extras queue FIFO.
|
|
16
|
+
* - Each item auto-dismisses after `autoHideMs` (default 4000); set
|
|
17
|
+
* `0` for a persistent snackbar.
|
|
18
|
+
* - Re-enqueueing with the SAME `id` reuses the slot and resets the
|
|
19
|
+
* timer (de-dup pattern for repeated "Saved" toasts).
|
|
20
|
+
*
|
|
21
|
+
* **A11y**:
|
|
22
|
+
* - Container is an `aria-live="polite"` region (assistive techs
|
|
23
|
+
* announce new messages without stealing focus).
|
|
24
|
+
* - Severity icon is `aria-hidden` — the message text carries the
|
|
25
|
+
* semantic.
|
|
26
|
+
* - Close + action buttons are focusable via Tab; the visual stack
|
|
27
|
+
* order is the same as the announcement order.
|
|
28
|
+
*
|
|
29
|
+
* **Re-render contract**:
|
|
30
|
+
* - Provider re-renders ONLY when the visible set changes.
|
|
31
|
+
* - The `api` (returned by `useSnackbar()`) is stable across re-renders
|
|
32
|
+
* — `useCallback`'d with no deps, mutates a ref internally.
|
|
33
|
+
* - Consumers calling `useSnackbar()` get the same identity each time
|
|
34
|
+
* so they can safely pass `enqueue` to `useEffect` deps.
|
|
35
|
+
*/
|
|
36
|
+
export declare function SnackbarProvider(props: SnackbarProviderProps): import("react/jsx-runtime").JSX.Element;
|
|
37
|
+
//# sourceMappingURL=Snackbar.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Snackbar.d.ts","sourceRoot":"","sources":["../../../../src/components/Snackbar/Snackbar.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,WAAW,EAEX,qBAAqB,EAGtB,MAAM,qBAAqB,CAAC;AAI7B;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAQzC;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CA4N5D"}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import type { ReactNode } from 'react';
|
|
2
|
+
import type { SnackbarVariants } from './snackbar.variants.js';
|
|
3
|
+
/** Visual severity — drives icon color + accent on the snackbar surface. */
|
|
4
|
+
export type SnackbarSeverity = 'info' | 'success' | 'warning' | 'danger';
|
|
5
|
+
/** Corner anchor for the snackbar stack. */
|
|
6
|
+
export type SnackbarPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
|
|
7
|
+
/** One snackbar instance — what `useSnackbar().enqueue()` accepts. */
|
|
8
|
+
export interface SnackbarOptions {
|
|
9
|
+
/** Required text/content. */
|
|
10
|
+
message: ReactNode;
|
|
11
|
+
/** Visual severity. @default 'info' */
|
|
12
|
+
severity?: SnackbarSeverity;
|
|
13
|
+
/**
|
|
14
|
+
* Auto-dismiss after this many ms. `0` / negative ⇒ persistent
|
|
15
|
+
* (only dismissed by the close button or `dismiss(id)`).
|
|
16
|
+
* @default 4000
|
|
17
|
+
*/
|
|
18
|
+
autoHideMs?: number;
|
|
19
|
+
/** Optional action button label + handler. */
|
|
20
|
+
action?: {
|
|
21
|
+
label: ReactNode;
|
|
22
|
+
onClick: () => void;
|
|
23
|
+
};
|
|
24
|
+
/** Per-instance close-button visibility. @default true */
|
|
25
|
+
showClose?: boolean;
|
|
26
|
+
/**
|
|
27
|
+
* Stable identifier for de-duplication. If a snackbar with the same
|
|
28
|
+
* `id` is enqueued while already visible, the existing one is REUSED
|
|
29
|
+
* (auto-dismiss timer reset) instead of stacking a duplicate. Useful
|
|
30
|
+
* for "Saved" toasts triggered repeatedly from the same action.
|
|
31
|
+
*/
|
|
32
|
+
id?: string;
|
|
33
|
+
}
|
|
34
|
+
/** Internal model — every enqueued snackbar gets a unique id + a tick. */
|
|
35
|
+
export interface SnackbarRecord extends SnackbarOptions {
|
|
36
|
+
id: string;
|
|
37
|
+
/**
|
|
38
|
+
* Monotonic creation tick, used to drive the entry CSS transition
|
|
39
|
+
* (the consumer's CSS can target `data-state="entered"` keyed by tick).
|
|
40
|
+
*/
|
|
41
|
+
tick: number;
|
|
42
|
+
}
|
|
43
|
+
export interface SnackbarSlotProps {
|
|
44
|
+
container?: {
|
|
45
|
+
className?: string;
|
|
46
|
+
};
|
|
47
|
+
item?: {
|
|
48
|
+
className?: string;
|
|
49
|
+
};
|
|
50
|
+
icon?: {
|
|
51
|
+
className?: string;
|
|
52
|
+
};
|
|
53
|
+
message?: {
|
|
54
|
+
className?: string;
|
|
55
|
+
};
|
|
56
|
+
action?: {
|
|
57
|
+
className?: string;
|
|
58
|
+
};
|
|
59
|
+
closeButton?: {
|
|
60
|
+
className?: string;
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
/** API exposed by `useSnackbar()`. */
|
|
64
|
+
export interface SnackbarApi {
|
|
65
|
+
/** Show a snackbar — returns its assigned id (auto-generated if not provided). */
|
|
66
|
+
enqueue: (options: SnackbarOptions) => string;
|
|
67
|
+
/** Dismiss a specific snackbar. */
|
|
68
|
+
dismiss: (id: string) => void;
|
|
69
|
+
/** Dismiss every visible snackbar. */
|
|
70
|
+
dismissAll: () => void;
|
|
71
|
+
}
|
|
72
|
+
export interface SnackbarProviderProps extends SnackbarVariants {
|
|
73
|
+
children: ReactNode;
|
|
74
|
+
/** Corner the stack anchors to. @default 'bottom-right' */
|
|
75
|
+
position?: SnackbarPosition;
|
|
76
|
+
/**
|
|
77
|
+
* Hard cap on simultaneously visible snackbars. Excess enqueued
|
|
78
|
+
* items wait FIFO until a slot frees up. @default 5
|
|
79
|
+
*/
|
|
80
|
+
maxVisible?: number;
|
|
81
|
+
/** Defaults merged into every enqueue. */
|
|
82
|
+
defaults?: Pick<SnackbarOptions, 'severity' | 'autoHideMs' | 'showClose'>;
|
|
83
|
+
/** Per-slot className overrides. */
|
|
84
|
+
slotProps?: SnackbarSlotProps;
|
|
85
|
+
}
|
|
86
|
+
//# sourceMappingURL=snackbar.types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"snackbar.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Snackbar/snackbar.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzE,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,aAAa,GACb,eAAe,GACf,cAAc,CAAC;AAEnB,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,OAAO,EAAE,SAAS,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IACnD,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,CAAC;IAC9C,mCAAmC;IACnC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,sCAAsC;IACtC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,QAAQ,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC,CAAC;IAC1E,oCAAoC;IACpC,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B"}
|