@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,204 @@
|
|
|
1
|
+
// @vitest-environment jsdom
|
|
2
|
+
import { describe, it, expect, vi } from 'vitest';
|
|
3
|
+
import { render, screen, fireEvent } from '@testing-library/react';
|
|
4
|
+
import { DashFormProvider } from '@dashforge/forms';
|
|
5
|
+
import { DateTimePicker, isoToInputValue } from './DateTimePicker.js';
|
|
6
|
+
|
|
7
|
+
describe('isoToInputValue (pure helper)', () => {
|
|
8
|
+
it('returns "" for null / undefined / empty', () => {
|
|
9
|
+
expect(isoToInputValue('date', null)).toBe('');
|
|
10
|
+
expect(isoToInputValue('date', undefined)).toBe('');
|
|
11
|
+
expect(isoToInputValue('date', '')).toBe('');
|
|
12
|
+
});
|
|
13
|
+
|
|
14
|
+
it('passes through canonical `YYYY-MM-DD` for date mode', () => {
|
|
15
|
+
expect(isoToInputValue('date', '2026-05-16')).toBe('2026-05-16');
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
it('passes through canonical `HH:mm` for time mode', () => {
|
|
19
|
+
expect(isoToInputValue('time', '09:42')).toBe('09:42');
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
it('passes through canonical `HH:mm:ss` for time mode', () => {
|
|
23
|
+
expect(isoToInputValue('time', '09:42:15')).toBe('09:42:15');
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
it('passes through canonical `YYYY-MM-DDTHH:mm` for datetime mode', () => {
|
|
27
|
+
expect(isoToInputValue('datetime', '2026-05-16T09:42')).toBe(
|
|
28
|
+
'2026-05-16T09:42'
|
|
29
|
+
);
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
it('truncates a rich ISO datetime to the date mode prefix', () => {
|
|
33
|
+
expect(isoToInputValue('date', '2026-05-16T09:42:15.000Z')).toBe(
|
|
34
|
+
'2026-05-16'
|
|
35
|
+
);
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
it('returns "" for an unparseable string', () => {
|
|
39
|
+
expect(isoToInputValue('date', 'not-a-date')).toBe('');
|
|
40
|
+
});
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
describe('<DateTimePicker>', () => {
|
|
44
|
+
describe('standalone (no DashForm)', () => {
|
|
45
|
+
it('renders a native date input by default', () => {
|
|
46
|
+
render(<DateTimePicker name="dob" label="DOB" />);
|
|
47
|
+
const input = screen.getByLabelText('DOB') as HTMLInputElement;
|
|
48
|
+
expect(input.type).toBe('date');
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
it('renders a time input when mode="time"', () => {
|
|
52
|
+
render(<DateTimePicker name="t" label="Time" mode="time" />);
|
|
53
|
+
const input = screen.getByLabelText('Time') as HTMLInputElement;
|
|
54
|
+
expect(input.type).toBe('time');
|
|
55
|
+
});
|
|
56
|
+
|
|
57
|
+
it('renders a datetime-local input when mode="datetime"', () => {
|
|
58
|
+
render(<DateTimePicker name="dt" label="When" mode="datetime" />);
|
|
59
|
+
const input = screen.getByLabelText('When') as HTMLInputElement;
|
|
60
|
+
expect(input.type).toBe('datetime-local');
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
it('seeds `defaultValue` (uncontrolled)', () => {
|
|
64
|
+
render(
|
|
65
|
+
<DateTimePicker name="dob" label="DOB" defaultValue="2026-05-16" />
|
|
66
|
+
);
|
|
67
|
+
const input = screen.getByLabelText('DOB') as HTMLInputElement;
|
|
68
|
+
expect(input.defaultValue).toBe('2026-05-16');
|
|
69
|
+
});
|
|
70
|
+
|
|
71
|
+
it('reflects controlled `value`', () => {
|
|
72
|
+
render(
|
|
73
|
+
<DateTimePicker name="dob" label="DOB" value="2026-05-16" />
|
|
74
|
+
);
|
|
75
|
+
const input = screen.getByLabelText('DOB') as HTMLInputElement;
|
|
76
|
+
expect(input.value).toBe('2026-05-16');
|
|
77
|
+
});
|
|
78
|
+
|
|
79
|
+
it('truncates a controlled rich ISO to the date mode prefix', () => {
|
|
80
|
+
render(
|
|
81
|
+
<DateTimePicker
|
|
82
|
+
name="dob"
|
|
83
|
+
label="DOB"
|
|
84
|
+
value="2026-05-16T09:42:15.000Z"
|
|
85
|
+
/>
|
|
86
|
+
);
|
|
87
|
+
const input = screen.getByLabelText('DOB') as HTMLInputElement;
|
|
88
|
+
expect(input.value).toBe('2026-05-16');
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
it('forwards min/max/step to the native input', () => {
|
|
92
|
+
render(
|
|
93
|
+
<DateTimePicker
|
|
94
|
+
name="t"
|
|
95
|
+
label="Time"
|
|
96
|
+
mode="time"
|
|
97
|
+
min="08:00"
|
|
98
|
+
max="18:00"
|
|
99
|
+
step={300}
|
|
100
|
+
/>
|
|
101
|
+
);
|
|
102
|
+
const input = screen.getByLabelText('Time') as HTMLInputElement;
|
|
103
|
+
expect(input.min).toBe('08:00');
|
|
104
|
+
expect(input.max).toBe('18:00');
|
|
105
|
+
expect(input.step).toBe('300');
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
it('renders a `*` for required fields and sets the native attr', () => {
|
|
109
|
+
render(<DateTimePicker name="dob" label="DOB" required />);
|
|
110
|
+
const input = screen.getByLabelText(/DOB/) as HTMLInputElement;
|
|
111
|
+
expect(input.required).toBe(true);
|
|
112
|
+
expect(screen.getByText('*')).toBeTruthy();
|
|
113
|
+
});
|
|
114
|
+
|
|
115
|
+
it('renders helperText when not in error', () => {
|
|
116
|
+
render(
|
|
117
|
+
<DateTimePicker
|
|
118
|
+
name="dob"
|
|
119
|
+
label="DOB"
|
|
120
|
+
helperText="Pick a date in the past."
|
|
121
|
+
/>
|
|
122
|
+
);
|
|
123
|
+
expect(screen.getByText('Pick a date in the past.')).toBeTruthy();
|
|
124
|
+
});
|
|
125
|
+
|
|
126
|
+
it('shows the helperText in the error slot when `error` is true', () => {
|
|
127
|
+
render(
|
|
128
|
+
<DateTimePicker
|
|
129
|
+
name="dob"
|
|
130
|
+
label="DOB"
|
|
131
|
+
error
|
|
132
|
+
helperText="Required"
|
|
133
|
+
/>
|
|
134
|
+
);
|
|
135
|
+
const p = screen.getByText('Required');
|
|
136
|
+
// The error slot has the `text-danger-600` class per the variants.
|
|
137
|
+
expect(p.className).toMatch(/danger/);
|
|
138
|
+
});
|
|
139
|
+
|
|
140
|
+
it('disables the input', () => {
|
|
141
|
+
render(<DateTimePicker name="dob" label="DOB" disabled />);
|
|
142
|
+
const input = screen.getByLabelText('DOB') as HTMLInputElement;
|
|
143
|
+
expect(input.disabled).toBe(true);
|
|
144
|
+
});
|
|
145
|
+
});
|
|
146
|
+
|
|
147
|
+
describe('event wiring', () => {
|
|
148
|
+
it('fires onValueChange with the typed value (date)', () => {
|
|
149
|
+
const onValueChange = vi.fn();
|
|
150
|
+
render(
|
|
151
|
+
<DateTimePicker
|
|
152
|
+
name="dob"
|
|
153
|
+
label="DOB"
|
|
154
|
+
onValueChange={onValueChange}
|
|
155
|
+
/>
|
|
156
|
+
);
|
|
157
|
+
const input = screen.getByLabelText('DOB') as HTMLInputElement;
|
|
158
|
+
fireEvent.change(input, { target: { value: '2026-12-25' } });
|
|
159
|
+
expect(onValueChange).toHaveBeenCalledWith('2026-12-25');
|
|
160
|
+
});
|
|
161
|
+
|
|
162
|
+
it('fires onValueChange with `null` when the input is cleared', () => {
|
|
163
|
+
const onValueChange = vi.fn();
|
|
164
|
+
render(
|
|
165
|
+
<DateTimePicker
|
|
166
|
+
name="dob"
|
|
167
|
+
label="DOB"
|
|
168
|
+
value="2026-05-16"
|
|
169
|
+
onValueChange={onValueChange}
|
|
170
|
+
/>
|
|
171
|
+
);
|
|
172
|
+
const input = screen.getByLabelText('DOB') as HTMLInputElement;
|
|
173
|
+
fireEvent.change(input, { target: { value: '' } });
|
|
174
|
+
expect(onValueChange).toHaveBeenCalledWith(null);
|
|
175
|
+
});
|
|
176
|
+
});
|
|
177
|
+
|
|
178
|
+
describe('inside DashFormProvider', () => {
|
|
179
|
+
it('mounts cleanly with the bridge attached', () => {
|
|
180
|
+
render(
|
|
181
|
+
<DashFormProvider defaultValues={{ dob: '2026-05-16' }}>
|
|
182
|
+
<DateTimePicker name="dob" label="DOB" />
|
|
183
|
+
</DashFormProvider>
|
|
184
|
+
);
|
|
185
|
+
// Mount assertion — defaultValues commit is timing-sensitive in
|
|
186
|
+
// vitest (mirror of how Autocomplete / RadioGroup / NumberField
|
|
187
|
+
// are tested), so we don't assert input.value here.
|
|
188
|
+
expect(screen.getByLabelText('DOB')).toBeTruthy();
|
|
189
|
+
});
|
|
190
|
+
});
|
|
191
|
+
|
|
192
|
+
describe('visibility', () => {
|
|
193
|
+
it('returns null when visibleWhen returns false', () => {
|
|
194
|
+
const { container } = render(
|
|
195
|
+
<DateTimePicker
|
|
196
|
+
name="dob"
|
|
197
|
+
label="DOB"
|
|
198
|
+
visibleWhen={() => false}
|
|
199
|
+
/>
|
|
200
|
+
);
|
|
201
|
+
expect(container.querySelector('input')).toBeNull();
|
|
202
|
+
});
|
|
203
|
+
});
|
|
204
|
+
});
|
|
@@ -0,0 +1,319 @@
|
|
|
1
|
+
import {
|
|
2
|
+
useCallback,
|
|
3
|
+
useContext,
|
|
4
|
+
useEffect,
|
|
5
|
+
useId,
|
|
6
|
+
useRef,
|
|
7
|
+
} from 'react';
|
|
8
|
+
import { DashFormContext, useEngineVisibility } from '@dashforge/ui-core';
|
|
9
|
+
import type { DashFormBridge, FieldRegistration } from '@dashforge/ui-core';
|
|
10
|
+
import { useDashFieldMeta } from '@dashforge/forms';
|
|
11
|
+
import { cn } from '../../utils/cn.js';
|
|
12
|
+
import { useAccessState } from '../../hooks/useAccessState.js';
|
|
13
|
+
import { resolveValidationState } from '../_shared/resolveValidationState.js';
|
|
14
|
+
import { dateTimePickerVariants } from './dateTimePicker.variants.js';
|
|
15
|
+
import type {
|
|
16
|
+
DateTimePickerMode,
|
|
17
|
+
DateTimePickerProps,
|
|
18
|
+
} from './dateTimePicker.types.js';
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Resolve the native HTML input `type` for a given picker mode.
|
|
22
|
+
*/
|
|
23
|
+
function inputTypeFor(mode: DateTimePickerMode): string {
|
|
24
|
+
switch (mode) {
|
|
25
|
+
case 'time':
|
|
26
|
+
return 'time';
|
|
27
|
+
case 'datetime':
|
|
28
|
+
return 'datetime-local';
|
|
29
|
+
case 'date':
|
|
30
|
+
default:
|
|
31
|
+
return 'date';
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Coerce a stored/exposed value (ISO 8601-ish string or `null`/`undefined`)
|
|
37
|
+
* into the format the native input expects.
|
|
38
|
+
*
|
|
39
|
+
* Contract:
|
|
40
|
+
* - `date` → `YYYY-MM-DD`
|
|
41
|
+
* - `time` → `HH:mm` (or `HH:mm:ss` if seconds present)
|
|
42
|
+
* - `datetime` → `YYYY-MM-DDTHH:mm` (no timezone, datetime-local
|
|
43
|
+
* rejects `Z` / offset suffixes)
|
|
44
|
+
*
|
|
45
|
+
* The function is intentionally lenient:
|
|
46
|
+
* - Pass-through when the input already matches the expected shape.
|
|
47
|
+
* - Truncates a richer ISO string (e.g. `2026-05-16T10:23:45.000Z`)
|
|
48
|
+
* down to the mode-appropriate prefix.
|
|
49
|
+
* - Returns `''` for null / undefined / unparseable inputs (native
|
|
50
|
+
* inputs use `''` to represent "no value").
|
|
51
|
+
*/
|
|
52
|
+
export function isoToInputValue(
|
|
53
|
+
mode: DateTimePickerMode,
|
|
54
|
+
raw: string | null | undefined
|
|
55
|
+
): string {
|
|
56
|
+
if (raw == null || raw === '') return '';
|
|
57
|
+
|
|
58
|
+
// Fast path: already in the expected shape.
|
|
59
|
+
if (mode === 'date' && /^\d{4}-\d{2}-\d{2}$/.test(raw)) return raw;
|
|
60
|
+
if (mode === 'time' && /^\d{2}:\d{2}(:\d{2})?$/.test(raw)) return raw;
|
|
61
|
+
if (
|
|
62
|
+
mode === 'datetime' &&
|
|
63
|
+
/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?$/.test(raw)
|
|
64
|
+
) {
|
|
65
|
+
return raw;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
// Slow path: parse via Date and re-format locally.
|
|
69
|
+
const d = new Date(raw);
|
|
70
|
+
if (isNaN(d.getTime())) return '';
|
|
71
|
+
|
|
72
|
+
const pad = (n: number) => String(n).padStart(2, '0');
|
|
73
|
+
const yyyy = d.getFullYear();
|
|
74
|
+
const mm = pad(d.getMonth() + 1);
|
|
75
|
+
const dd = pad(d.getDate());
|
|
76
|
+
const hh = pad(d.getHours());
|
|
77
|
+
const mi = pad(d.getMinutes());
|
|
78
|
+
|
|
79
|
+
if (mode === 'date') return `${yyyy}-${mm}-${dd}`;
|
|
80
|
+
if (mode === 'time') return `${hh}:${mi}`;
|
|
81
|
+
return `${yyyy}-${mm}-${dd}T${hh}:${mi}`;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Take a native input string and return the canonical "stored" value:
|
|
86
|
+
* the same string for non-empty input, or `null` for empty (so the
|
|
87
|
+
* bridge / consumer never receives the ambiguous empty string).
|
|
88
|
+
*/
|
|
89
|
+
function inputValueToStored(raw: string): string | null {
|
|
90
|
+
return raw === '' ? null : raw;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* Dashforge TW DateTimePicker — bridge-integrated native date/time input.
|
|
95
|
+
*
|
|
96
|
+
* Three modes (`mode` prop):
|
|
97
|
+
* - `date` — `<input type="date">` → `YYYY-MM-DD`
|
|
98
|
+
* - `time` — `<input type="time">` → `HH:mm` (`HH:mm:ss` with `step={1}`)
|
|
99
|
+
* - `datetime` — `<input type="datetime-local">` → `YYYY-MM-DDTHH:mm`
|
|
100
|
+
*
|
|
101
|
+
* **Why native inputs instead of React Aria `<DatePicker>`?**
|
|
102
|
+
*
|
|
103
|
+
* 1. Zero new deps (`@internationalized/date` would add ~30 KB).
|
|
104
|
+
* 2. Mirrors `@dashforge/ui/DateTimePicker` (MUI side) for API parity.
|
|
105
|
+
* 3. Native inputs are AAA-grade a11y out of the box — screen readers,
|
|
106
|
+
* keyboard nav, OS-provided calendar/clock UI.
|
|
107
|
+
* 4. Predictable state (no internal Aria state machine that fights
|
|
108
|
+
* controlled props — the F5-A lesson learned in `<Autocomplete>`).
|
|
109
|
+
*
|
|
110
|
+
* A richer custom-calendar version (range mode, locale awareness,
|
|
111
|
+
* custom popover styling) can land as F5-B-bis built on Aria
|
|
112
|
+
* `<DatePicker>` / `<Calendar>`.
|
|
113
|
+
*
|
|
114
|
+
* **A11y**:
|
|
115
|
+
* - `aria-invalid` driven by the resolved validation state.
|
|
116
|
+
* - `aria-describedby` links input ↔ helper/error.
|
|
117
|
+
* - Required fields get the native `required` attribute + a visual `*`.
|
|
118
|
+
* - `color-scheme: light dark` keeps the OS calendar icon readable
|
|
119
|
+
* in both color schemes.
|
|
120
|
+
*/
|
|
121
|
+
export function DateTimePicker(props: DateTimePickerProps) {
|
|
122
|
+
const {
|
|
123
|
+
name,
|
|
124
|
+
rules,
|
|
125
|
+
mode = 'date',
|
|
126
|
+
visibleWhen,
|
|
127
|
+
layout = 'stacked',
|
|
128
|
+
size,
|
|
129
|
+
label,
|
|
130
|
+
helperText,
|
|
131
|
+
required,
|
|
132
|
+
error,
|
|
133
|
+
disabled,
|
|
134
|
+
fullWidth,
|
|
135
|
+
access,
|
|
136
|
+
sx,
|
|
137
|
+
slotProps,
|
|
138
|
+
placeholder,
|
|
139
|
+
min,
|
|
140
|
+
max,
|
|
141
|
+
step,
|
|
142
|
+
value: explicitValue,
|
|
143
|
+
defaultValue,
|
|
144
|
+
onValueChange,
|
|
145
|
+
} = props;
|
|
146
|
+
|
|
147
|
+
// ───── Hooks (unconditional) ─────
|
|
148
|
+
const bridge = useContext(DashFormContext) as DashFormBridge | null;
|
|
149
|
+
const isVisible = useEngineVisibility(bridge?.engine, visibleWhen);
|
|
150
|
+
// Per-field reactive snapshot. Same pattern as <TextField> — re-renders
|
|
151
|
+
// this component when its OWN bridge value changes, but not when a
|
|
152
|
+
// sibling field changes (perf contract).
|
|
153
|
+
const fieldMeta = useDashFieldMeta(name);
|
|
154
|
+
const accessState = useAccessState(access);
|
|
155
|
+
|
|
156
|
+
const inputId = useId();
|
|
157
|
+
const helperId = `${inputId}-help`;
|
|
158
|
+
|
|
159
|
+
// StrictMode-safe unregister-on-unmount.
|
|
160
|
+
const unregisterRef = useRef({ bridge, name });
|
|
161
|
+
unregisterRef.current = { bridge, name };
|
|
162
|
+
const isMountedRef = useRef(false);
|
|
163
|
+
|
|
164
|
+
useEffect(() => {
|
|
165
|
+
isMountedRef.current = true;
|
|
166
|
+
return () => {
|
|
167
|
+
isMountedRef.current = false;
|
|
168
|
+
const { bridge: cap, name: capName } = unregisterRef.current;
|
|
169
|
+
queueMicrotask(() => {
|
|
170
|
+
if (!isMountedRef.current) cap?.unregister?.(capName);
|
|
171
|
+
});
|
|
172
|
+
};
|
|
173
|
+
}, []);
|
|
174
|
+
|
|
175
|
+
// ───── Derived ─────
|
|
176
|
+
const effectiveDisabled = Boolean(disabled) || accessState.disabled;
|
|
177
|
+
const effectiveReadOnly = accessState.readonly;
|
|
178
|
+
const isFormMode = Boolean(bridge?.register);
|
|
179
|
+
|
|
180
|
+
let resolvedError = error;
|
|
181
|
+
let resolvedHelperText: typeof helperText = helperText;
|
|
182
|
+
let registration: FieldRegistration | null = null;
|
|
183
|
+
let resolvedValue: string | null | undefined;
|
|
184
|
+
|
|
185
|
+
if (isFormMode && bridge) {
|
|
186
|
+
registration = bridge.register(name, rules);
|
|
187
|
+
const validation = resolveValidationState(name, bridge, error, helperText);
|
|
188
|
+
resolvedError = validation.error;
|
|
189
|
+
resolvedHelperText = validation.helperText;
|
|
190
|
+
if (explicitValue !== undefined) {
|
|
191
|
+
resolvedValue = explicitValue;
|
|
192
|
+
} else {
|
|
193
|
+
const bv = fieldMeta.value;
|
|
194
|
+
resolvedValue = bv == null ? null : String(bv);
|
|
195
|
+
}
|
|
196
|
+
} else if (explicitValue !== undefined) {
|
|
197
|
+
resolvedValue = explicitValue;
|
|
198
|
+
} else {
|
|
199
|
+
// Pure uncontrolled mode: defer to native input's defaultValue.
|
|
200
|
+
resolvedValue = undefined;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
// Registration-supplied callback ref (RHF threads its own ref through
|
|
204
|
+
// here in form mode). Stable callback to keep React 19 happy.
|
|
205
|
+
const registrationRefFn = registration?.ref;
|
|
206
|
+
const inputRef = useCallback(
|
|
207
|
+
(instance: HTMLInputElement | null) => {
|
|
208
|
+
if (typeof registrationRefFn === 'function') {
|
|
209
|
+
registrationRefFn(instance);
|
|
210
|
+
}
|
|
211
|
+
},
|
|
212
|
+
[registrationRefFn]
|
|
213
|
+
);
|
|
214
|
+
|
|
215
|
+
// ───── Render-time guards (after all hooks) ─────
|
|
216
|
+
if (!isVisible) return null;
|
|
217
|
+
if (!accessState.visible) return null;
|
|
218
|
+
|
|
219
|
+
const v = dateTimePickerVariants({
|
|
220
|
+
size,
|
|
221
|
+
layout,
|
|
222
|
+
error: resolvedError,
|
|
223
|
+
fullWidth,
|
|
224
|
+
disabled: effectiveDisabled,
|
|
225
|
+
});
|
|
226
|
+
|
|
227
|
+
const inputType = inputTypeFor(mode);
|
|
228
|
+
const nativeValue =
|
|
229
|
+
resolvedValue === undefined ? undefined : isoToInputValue(mode, resolvedValue);
|
|
230
|
+
const nativeDefault =
|
|
231
|
+
!isFormMode && explicitValue === undefined && defaultValue !== undefined
|
|
232
|
+
? isoToInputValue(mode, defaultValue)
|
|
233
|
+
: undefined;
|
|
234
|
+
const nativeMin = min != null ? isoToInputValue(mode, min) : undefined;
|
|
235
|
+
const nativeMax = max != null ? isoToInputValue(mode, max) : undefined;
|
|
236
|
+
|
|
237
|
+
const handleChange = (event: React.ChangeEvent<HTMLInputElement>) => {
|
|
238
|
+
const next = inputValueToStored(event.target.value);
|
|
239
|
+
if (isFormMode && bridge) {
|
|
240
|
+
bridge.setValue?.(name, next);
|
|
241
|
+
void registration?.onChange?.({
|
|
242
|
+
target: { name, value: next ?? '' },
|
|
243
|
+
type: 'change',
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
onValueChange?.(next);
|
|
247
|
+
};
|
|
248
|
+
|
|
249
|
+
const handleBlur = (event: React.FocusEvent<HTMLInputElement>) => {
|
|
250
|
+
if (isFormMode && bridge) {
|
|
251
|
+
registration?.onBlur?.(event);
|
|
252
|
+
}
|
|
253
|
+
};
|
|
254
|
+
|
|
255
|
+
return (
|
|
256
|
+
<div className={cn(v.root(), sx, slotProps?.root?.className)}>
|
|
257
|
+
{label && (
|
|
258
|
+
<label
|
|
259
|
+
htmlFor={inputId}
|
|
260
|
+
className={cn(v.label(), slotProps?.label?.className)}
|
|
261
|
+
>
|
|
262
|
+
{label}
|
|
263
|
+
{required && (
|
|
264
|
+
<span
|
|
265
|
+
aria-hidden="true"
|
|
266
|
+
className={cn(
|
|
267
|
+
v.requiredMark(),
|
|
268
|
+
slotProps?.requiredMark?.className
|
|
269
|
+
)}
|
|
270
|
+
>
|
|
271
|
+
*
|
|
272
|
+
</span>
|
|
273
|
+
)}
|
|
274
|
+
</label>
|
|
275
|
+
)}
|
|
276
|
+
|
|
277
|
+
<div
|
|
278
|
+
className={cn(v.inputWrapper(), slotProps?.inputWrapper?.className)}
|
|
279
|
+
>
|
|
280
|
+
<input
|
|
281
|
+
id={inputId}
|
|
282
|
+
ref={inputRef}
|
|
283
|
+
name={name}
|
|
284
|
+
type={inputType}
|
|
285
|
+
// Controlled in form / explicit-value mode; uncontrolled with
|
|
286
|
+
// `defaultValue` otherwise. Mirrors the TextField pattern.
|
|
287
|
+
value={nativeValue}
|
|
288
|
+
defaultValue={nativeDefault}
|
|
289
|
+
min={nativeMin}
|
|
290
|
+
max={nativeMax}
|
|
291
|
+
step={step}
|
|
292
|
+
placeholder={placeholder}
|
|
293
|
+
disabled={effectiveDisabled}
|
|
294
|
+
readOnly={effectiveReadOnly}
|
|
295
|
+
required={required}
|
|
296
|
+
aria-invalid={resolvedError ? true : undefined}
|
|
297
|
+
aria-describedby={resolvedHelperText ? helperId : undefined}
|
|
298
|
+
onChange={handleChange}
|
|
299
|
+
onBlur={handleBlur}
|
|
300
|
+
className={cn(v.input(), slotProps?.input?.className)}
|
|
301
|
+
/>
|
|
302
|
+
</div>
|
|
303
|
+
|
|
304
|
+
{resolvedHelperText && (
|
|
305
|
+
<p
|
|
306
|
+
id={helperId}
|
|
307
|
+
className={cn(
|
|
308
|
+
resolvedError ? v.errorText() : v.helperText(),
|
|
309
|
+
resolvedError
|
|
310
|
+
? slotProps?.errorText?.className
|
|
311
|
+
: slotProps?.helperText?.className
|
|
312
|
+
)}
|
|
313
|
+
>
|
|
314
|
+
{resolvedHelperText}
|
|
315
|
+
</p>
|
|
316
|
+
)}
|
|
317
|
+
</div>
|
|
318
|
+
);
|
|
319
|
+
}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import type { ReactNode } from 'react';
|
|
2
|
+
import type { Engine } from '@dashforge/ui-core';
|
|
3
|
+
import type { AccessRequirement } from '@dashforge/rbac';
|
|
4
|
+
import type { DateTimePickerVariants } from './dateTimePicker.variants.js';
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Operating mode of the picker.
|
|
8
|
+
*
|
|
9
|
+
* - `'date'` — `YYYY-MM-DD` (native `<input type="date">`)
|
|
10
|
+
* - `'time'` — `HH:mm` or `HH:mm:ss` (native `<input type="time">`)
|
|
11
|
+
* - `'datetime'` — `YYYY-MM-DDTHH:mm` (native `<input type="datetime-local">`)
|
|
12
|
+
*
|
|
13
|
+
* Note: `datetime-local` does NOT include timezone info. Values are
|
|
14
|
+
* naive local-time strings. If you need TZ-aware persistence, convert
|
|
15
|
+
* upstream (e.g., interpret as UTC, or attach the user's TZ from a
|
|
16
|
+
* separate field).
|
|
17
|
+
*/
|
|
18
|
+
export type DateTimePickerMode = 'date' | 'time' | 'datetime';
|
|
19
|
+
|
|
20
|
+
export interface DateTimePickerSlotProps {
|
|
21
|
+
root?: { className?: string };
|
|
22
|
+
label?: { className?: string };
|
|
23
|
+
requiredMark?: { className?: string };
|
|
24
|
+
inputWrapper?: { className?: string };
|
|
25
|
+
input?: { className?: string };
|
|
26
|
+
helperText?: { className?: string };
|
|
27
|
+
errorText?: { className?: string };
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* Props for `<DateTimePicker>`.
|
|
32
|
+
*
|
|
33
|
+
* Bridge-integrated date / time / datetime input built on the native
|
|
34
|
+
* HTML5 input types (`type="date|time|datetime-local"`). Chosen over a
|
|
35
|
+
* custom React Aria `<DatePicker>` for F5-B because:
|
|
36
|
+
*
|
|
37
|
+
* 1. **Zero new deps** — no `@internationalized/date`.
|
|
38
|
+
* 2. **A11y by default** — screen readers know how to announce these
|
|
39
|
+
* inputs, including the OS-provided calendar/clock popup.
|
|
40
|
+
* 3. **Bundle size** — saves ~30KB minified over the Aria stack.
|
|
41
|
+
* 4. **API parity** with the MUI side (`@dashforge/ui/DateTimePicker`).
|
|
42
|
+
* 5. **Predictability** — no internal state machine to fight (see the
|
|
43
|
+
* ComboBox lesson learned in `<Autocomplete>` F5-A).
|
|
44
|
+
*
|
|
45
|
+
* A richer "always-visible calendar grid" upgrade can come as F5-B-bis.
|
|
46
|
+
*
|
|
47
|
+
* Value contract: ISO 8601-ish naive strings, always.
|
|
48
|
+
*/
|
|
49
|
+
export interface DateTimePickerProps extends DateTimePickerVariants {
|
|
50
|
+
name: string;
|
|
51
|
+
rules?: unknown;
|
|
52
|
+
/** Which native input to render. @default 'date' */
|
|
53
|
+
mode?: DateTimePickerMode;
|
|
54
|
+
label?: ReactNode;
|
|
55
|
+
helperText?: ReactNode;
|
|
56
|
+
required?: boolean;
|
|
57
|
+
error?: boolean;
|
|
58
|
+
disabled?: boolean;
|
|
59
|
+
placeholder?: string;
|
|
60
|
+
/** Minimum value (ISO string compatible with the mode). */
|
|
61
|
+
min?: string;
|
|
62
|
+
/** Maximum value (ISO string compatible with the mode). */
|
|
63
|
+
max?: string;
|
|
64
|
+
/**
|
|
65
|
+
* Step in seconds (time / datetime). Default 60 ⇒ minute precision.
|
|
66
|
+
* Set to 1 to allow seconds.
|
|
67
|
+
*/
|
|
68
|
+
step?: number;
|
|
69
|
+
/** Engine predicate — field not rendered when it returns `false`. */
|
|
70
|
+
visibleWhen?: (engine: Engine) => boolean;
|
|
71
|
+
/** RBAC access requirement. */
|
|
72
|
+
access?: AccessRequirement;
|
|
73
|
+
/** Root className shortcut. */
|
|
74
|
+
sx?: string;
|
|
75
|
+
/** Per-slot className overrides. */
|
|
76
|
+
slotProps?: DateTimePickerSlotProps;
|
|
77
|
+
/** Controlled value (form mode reads from the bridge if omitted). */
|
|
78
|
+
value?: string | null;
|
|
79
|
+
/** Default value for uncontrolled mode (no-op in form mode). */
|
|
80
|
+
defaultValue?: string | null;
|
|
81
|
+
/** Fires when the user picks a date/time (after bridge update in form mode). */
|
|
82
|
+
onValueChange?: (value: string | null) => void;
|
|
83
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { tv, type VariantProps } from 'tailwind-variants';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Tailwind-variants recipe for `<DateTimePicker>` with 6 slots.
|
|
5
|
+
*
|
|
6
|
+
* Styling mirrors `<TextField>` for layout / sizes / error states so
|
|
7
|
+
* the two field types compose visually in the same form.
|
|
8
|
+
*
|
|
9
|
+
* Native `<input type="date|time|datetime-local">` quirks handled here:
|
|
10
|
+
*
|
|
11
|
+
* - The browser-rendered placeholder mask (e.g., `mm/dd/yyyy`) is
|
|
12
|
+
* invisible on `bg-neutral-50` by default in some themes; we keep
|
|
13
|
+
* the same neutral palette and rely on the input's own contrast
|
|
14
|
+
* rules (no extra `::placeholder` styling — browsers don't honor it
|
|
15
|
+
* on these input types).
|
|
16
|
+
* - The native picker indicator (calendar / clock icon) is
|
|
17
|
+
* browser-supplied; we ensure it stays visible in dark mode via
|
|
18
|
+
* `color-scheme: light dark` on the input (set inline below).
|
|
19
|
+
*/
|
|
20
|
+
export const dateTimePickerVariants = tv({
|
|
21
|
+
slots: {
|
|
22
|
+
root: 'flex',
|
|
23
|
+
label: 'block text-sm font-medium text-neutral-900 mb-1',
|
|
24
|
+
requiredMark: 'text-danger-500 ml-0.5',
|
|
25
|
+
inputWrapper: [
|
|
26
|
+
'relative flex items-center',
|
|
27
|
+
'rounded-md border bg-neutral-50',
|
|
28
|
+
'border-neutral-300',
|
|
29
|
+
'transition-colors',
|
|
30
|
+
'focus-within:border-primary-500 focus-within:ring-2 focus-within:ring-primary-500/30',
|
|
31
|
+
],
|
|
32
|
+
input: [
|
|
33
|
+
'block w-full bg-transparent outline-none',
|
|
34
|
+
'text-neutral-900 placeholder:text-neutral-400',
|
|
35
|
+
'disabled:cursor-not-allowed disabled:opacity-60',
|
|
36
|
+
'read-only:cursor-default',
|
|
37
|
+
// `color-scheme` lets the native calendar / clock icon respect
|
|
38
|
+
// the dark mode (otherwise it stays light-themed against dark bg)
|
|
39
|
+
'[color-scheme:light_dark]',
|
|
40
|
+
],
|
|
41
|
+
helperText: 'mt-1 text-sm text-neutral-600',
|
|
42
|
+
errorText: 'mt-1 text-sm text-danger-600',
|
|
43
|
+
},
|
|
44
|
+
variants: {
|
|
45
|
+
size: {
|
|
46
|
+
sm: { inputWrapper: 'h-8 px-2', input: 'text-sm' },
|
|
47
|
+
md: { inputWrapper: 'h-10 px-3', input: 'text-base' },
|
|
48
|
+
lg: { inputWrapper: 'h-12 px-4', input: 'text-lg' },
|
|
49
|
+
},
|
|
50
|
+
layout: {
|
|
51
|
+
stacked: { root: 'flex-col' },
|
|
52
|
+
inline: {
|
|
53
|
+
root: 'flex-row items-start gap-3',
|
|
54
|
+
label: 'mb-0 pt-2 whitespace-nowrap shrink-0',
|
|
55
|
+
},
|
|
56
|
+
},
|
|
57
|
+
error: {
|
|
58
|
+
true: {
|
|
59
|
+
inputWrapper:
|
|
60
|
+
'border-danger-500 focus-within:border-danger-500 focus-within:ring-danger-500/30',
|
|
61
|
+
},
|
|
62
|
+
},
|
|
63
|
+
fullWidth: {
|
|
64
|
+
true: {
|
|
65
|
+
root: 'w-full',
|
|
66
|
+
inputWrapper: 'w-full',
|
|
67
|
+
},
|
|
68
|
+
},
|
|
69
|
+
disabled: {
|
|
70
|
+
true: {
|
|
71
|
+
inputWrapper: 'opacity-60 cursor-not-allowed bg-neutral-200',
|
|
72
|
+
},
|
|
73
|
+
},
|
|
74
|
+
},
|
|
75
|
+
defaultVariants: {
|
|
76
|
+
size: 'md',
|
|
77
|
+
layout: 'stacked',
|
|
78
|
+
error: false,
|
|
79
|
+
fullWidth: false,
|
|
80
|
+
disabled: false,
|
|
81
|
+
},
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
export type DateTimePickerVariants = VariantProps<typeof dateTimePickerVariants>;
|