tyrell-components 1.0.0-TC9 → 1.0.0-rc.22
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +122 -0
- package/CHANGELOG.md +1541 -0
- package/README.md +71 -53
- package/bin/tyrell.mjs +77 -0
- package/css/tyrell-colors-static.css +1 -0
- package/css/tyrell-theme.css +1 -0
- package/css/tyrell.css +1 -1783
- package/dist/tyrell-colors-static.css +1 -0
- package/dist/tyrell-theme.css +1 -0
- package/dist/tyrell.css +1 -1783
- package/dist/tyrell.js +1 -1
- package/guides/AGENT_INSTRUCTIONS.md +124 -0
- package/guides/AI_GUIDE.md +53 -0
- package/guides/CSS_GUIDE.md +1016 -0
- package/guides/DATASTAR_TY_GUIDE.md +657 -0
- package/guides/ICONS_GUIDE.md +212 -0
- package/guides/TY_GUIDE.md +937 -0
- package/guides/clj/CLOJURESCRIPT_GUIDE.md +300 -0
- package/guides/clj/CODE_SPLITTING.md +279 -0
- package/guides/clj/COMPONENT_GUIDE.md +391 -0
- package/guides/clj/HELIX_TY_GUIDE.md +428 -0
- package/guides/clj/I18N_GUIDE.md +478 -0
- package/guides/clj/LAYOUT_GUIDE.md +273 -0
- package/guides/clj/QUICKSTART.md +266 -0
- package/guides/clj/REAGENT_TY_GUIDE.md +408 -0
- package/guides/clj/REPLICANT_TY_GUIDE.md +623 -0
- package/guides/clj/ROUTING_GUIDE.md +346 -0
- package/guides/clj/UIX_TY_GUIDE.md +319 -0
- package/guides/js/HTMX_TY_GUIDE.md +252 -0
- package/guides/js/JAVASCRIPT_GUIDE.md +388 -0
- package/guides/js/REACT_TY_GUIDE.md +983 -0
- package/guides/js/SVELTE_TY_GUIDE.md +682 -0
- package/guides/js/TYCOMPONENT_GUIDE.md +962 -0
- package/guides/js/VUE_TY_GUIDE.md +738 -0
- package/lib/base/ty-component.d.ts +57 -13
- package/lib/base/ty-component.js +266 -292
- package/lib/components/button.d.ts +33 -18
- package/lib/components/button.js +317 -267
- package/lib/components/calendar-month.d.ts +30 -47
- package/lib/components/calendar-month.js +455 -429
- package/lib/components/calendar-navigation.d.ts +41 -49
- package/lib/components/calendar-navigation.js +287 -346
- package/lib/components/calendar.d.ts +73 -83
- package/lib/components/calendar.js +837 -762
- package/lib/components/checkbox.d.ts +26 -75
- package/lib/components/checkbox.js +298 -391
- package/lib/components/copy.d.ts +20 -60
- package/lib/components/copy.js +276 -380
- package/lib/components/date-picker.d.ts +100 -183
- package/lib/components/date-picker.js +1155 -1570
- package/lib/components/file-upload.d.ts +16 -15
- package/lib/components/file-upload.js +436 -426
- package/lib/components/icon.d.ts +3 -24
- package/lib/components/icon.js +141 -230
- package/lib/components/input.d.ts +93 -108
- package/lib/components/input.js +734 -710
- package/lib/components/modal.d.ts +39 -29
- package/lib/components/modal.js +419 -438
- package/lib/components/option.d.ts +20 -35
- package/lib/components/option.js +184 -309
- package/lib/components/popup.d.ts +2 -17
- package/lib/components/popup.js +353 -347
- package/lib/components/radio.d.ts +33 -25
- package/lib/components/radio.js +433 -422
- package/lib/components/resize-observer.d.ts +3 -30
- package/lib/components/resize-observer.js +71 -103
- package/lib/components/scroll-container.d.ts +21 -14
- package/lib/components/scroll-container.js +292 -234
- package/lib/components/select.d.ts +458 -0
- package/lib/components/select.js +1458 -0
- package/lib/components/selected-tags.d.ts +60 -0
- package/lib/components/selected-tags.js +225 -0
- package/lib/components/sortable.d.ts +175 -0
- package/lib/components/sortable.js +1844 -0
- package/lib/components/step.d.ts +1 -6
- package/lib/components/step.js +62 -68
- package/lib/components/switch.d.ts +15 -15
- package/lib/components/switch.js +237 -231
- package/lib/components/tab.d.ts +50 -7
- package/lib/components/tab.js +203 -69
- package/lib/components/tabs.d.ts +19 -64
- package/lib/components/tabs.js +600 -618
- package/lib/components/tag.d.ts +14 -52
- package/lib/components/tag.js +231 -306
- package/lib/components/textarea.d.ts +58 -89
- package/lib/components/textarea.js +523 -573
- package/lib/components/tooltip.d.ts +8 -13
- package/lib/components/tooltip.js +322 -409
- package/lib/components/wizard.d.ts +7 -54
- package/lib/components/wizard.js +376 -606
- package/lib/icons/fontawesome/brands.d.ts +0 -1
- package/lib/icons/fontawesome/brands.js +0 -8
- package/lib/icons/fontawesome/regular.d.ts +0 -1
- package/lib/icons/fontawesome/regular.js +0 -8
- package/lib/icons/fontawesome/solid.d.ts +0 -1
- package/lib/icons/fontawesome/solid.js +0 -8
- package/lib/icons/heroicons/micro.d.ts +0 -1
- package/lib/icons/heroicons/micro.js +392 -400
- package/lib/icons/heroicons/mini.d.ts +0 -1
- package/lib/icons/heroicons/mini.js +382 -390
- package/lib/icons/heroicons/outline.d.ts +0 -1
- package/lib/icons/heroicons/outline.js +337 -345
- package/lib/icons/heroicons/solid.d.ts +0 -1
- package/lib/icons/heroicons/solid.js +407 -415
- package/lib/icons/lucide.d.ts +0 -1
- package/lib/icons/lucide.js +24479 -26351
- package/lib/icons/material/filled.d.ts +0 -1
- package/lib/icons/material/filled.js +9653 -9663
- package/lib/icons/material/outlined.d.ts +0 -1
- package/lib/icons/material/outlined.js +10271 -10281
- package/lib/icons/material/round.d.ts +0 -1
- package/lib/icons/material/round.js +10495 -10505
- package/lib/icons/material/sharp.d.ts +0 -1
- package/lib/icons/material/sharp.js +9905 -9915
- package/lib/icons/material/two-tone.d.ts +0 -1
- package/lib/icons/material/two-tone.js +12792 -12802
- package/lib/index.d.ts +7 -4
- package/lib/index.js +26 -39
- package/lib/styles/button.d.ts +24 -7
- package/lib/styles/button.js +285 -445
- package/lib/styles/calendar-month.d.ts +7 -6
- package/lib/styles/calendar-month.js +158 -226
- package/lib/styles/calendar-navigation.d.ts +2 -6
- package/lib/styles/calendar-navigation.js +108 -127
- package/lib/styles/calendar.d.ts +3 -3
- package/lib/styles/calendar.js +87 -23
- package/lib/styles/checkbox.d.ts +7 -6
- package/lib/styles/checkbox.js +101 -15
- package/lib/styles/copy.d.ts +3 -2
- package/lib/styles/copy.js +91 -71
- package/lib/styles/custom-scrollbar.d.ts +1 -2
- package/lib/styles/custom-scrollbar.js +80 -115
- package/lib/styles/date-picker.d.ts +4 -6
- package/lib/styles/date-picker.js +321 -388
- package/lib/styles/field-size.d.ts +6 -0
- package/lib/styles/field-size.js +91 -0
- package/lib/styles/file-upload.d.ts +1 -2
- package/lib/styles/file-upload.js +143 -188
- package/lib/styles/icon.d.ts +2 -6
- package/lib/styles/icon.js +92 -170
- package/lib/styles/input.d.ts +4 -7
- package/lib/styles/input.js +148 -643
- package/lib/styles/modal.d.ts +1 -2
- package/lib/styles/modal.js +127 -108
- package/lib/styles/option.d.ts +2 -6
- package/lib/styles/option.js +53 -96
- package/lib/styles/popup.d.ts +1 -2
- package/lib/styles/popup.js +47 -77
- package/lib/styles/radio.d.ts +3 -2
- package/lib/styles/radio.js +90 -116
- package/lib/styles/resize-observer.d.ts +1 -2
- package/lib/styles/resize-observer.js +2 -12
- package/lib/styles/scroll-container.d.ts +1 -2
- package/lib/styles/scroll-container.js +103 -146
- package/lib/styles/select-base.d.ts +8 -0
- package/lib/styles/select-base.js +752 -0
- package/lib/styles/select.d.ts +11 -0
- package/lib/styles/select.js +229 -0
- package/lib/styles/sortable.d.ts +16 -0
- package/lib/styles/sortable.js +85 -0
- package/lib/styles/step.d.ts +1 -2
- package/lib/styles/step.js +15 -34
- package/lib/styles/switch.d.ts +3 -2
- package/lib/styles/switch.js +52 -68
- package/lib/styles/tab.d.ts +1 -2
- package/lib/styles/tab.js +86 -34
- package/lib/styles/tabs.d.ts +3 -11
- package/lib/styles/tabs.js +204 -162
- package/lib/styles/tag.d.ts +2 -6
- package/lib/styles/tag.js +168 -362
- package/lib/styles/textarea.d.ts +1 -2
- package/lib/styles/textarea.js +238 -306
- package/lib/styles/tooltip.d.ts +4 -3
- package/lib/styles/tooltip.js +3 -131
- package/lib/styles/wizard.d.ts +8 -20
- package/lib/styles/wizard.js +306 -295
- package/lib/types/common.d.ts +9 -8
- package/lib/types/common.js +8 -5
- package/lib/utils/calendar-utils.d.ts +49 -65
- package/lib/utils/calendar-utils.js +158 -343
- package/lib/utils/custom-scrollbar.d.ts +6 -20
- package/lib/utils/custom-scrollbar.js +273 -317
- package/lib/utils/flavor-sheet.d.ts +31 -0
- package/lib/utils/flavor-sheet.js +17 -0
- package/lib/utils/icon-registry.d.ts +0 -15
- package/lib/utils/icon-registry.js +138 -279
- package/lib/utils/icons.d.ts +9 -0
- package/lib/utils/icons.js +1 -0
- package/lib/utils/loader-registry.d.ts +2 -3
- package/lib/utils/loader-registry.js +3 -35
- package/lib/utils/locale.d.ts +2 -80
- package/lib/utils/locale.js +30 -205
- package/lib/utils/mobile.d.ts +0 -1
- package/lib/utils/mobile.js +1 -18
- package/lib/utils/number-format.d.ts +6 -24
- package/lib/utils/number-format.js +53 -136
- package/lib/utils/positioning.d.ts +72 -22
- package/lib/utils/positioning.js +224 -298
- package/lib/utils/property-capture.d.ts +5 -27
- package/lib/utils/property-capture.js +36 -144
- package/lib/utils/property-manager.d.ts +6 -6
- package/lib/utils/property-manager.js +127 -196
- package/lib/utils/resize-observer.d.ts +0 -1
- package/lib/utils/resize-observer.js +23 -59
- package/lib/utils/scroll-lock.d.ts +10 -11
- package/lib/utils/scroll-lock.js +165 -173
- package/lib/utils/styles.d.ts +0 -6
- package/lib/utils/styles.js +17 -48
- package/lib/utils/upgrade-properties.d.ts +21 -0
- package/lib/utils/upgrade-properties.js +47 -0
- package/lib/utils/validity.d.ts +122 -0
- package/lib/utils/validity.js +289 -0
- package/lib/version.d.ts +1 -2
- package/lib/version.js +1 -11
- package/package.json +66 -18
- package/lib/base/ty-component.d.ts.map +0 -1
- package/lib/base/ty-component.js.map +0 -1
- package/lib/components/button.d.ts.map +0 -1
- package/lib/components/button.js.map +0 -1
- package/lib/components/calendar-month.d.ts.map +0 -1
- package/lib/components/calendar-month.js.map +0 -1
- package/lib/components/calendar-navigation.d.ts.map +0 -1
- package/lib/components/calendar-navigation.js.map +0 -1
- package/lib/components/calendar.d.ts.map +0 -1
- package/lib/components/calendar.js.map +0 -1
- package/lib/components/checkbox.d.ts.map +0 -1
- package/lib/components/checkbox.js.map +0 -1
- package/lib/components/copy.d.ts.map +0 -1
- package/lib/components/copy.js.map +0 -1
- package/lib/components/date-picker.d.ts.map +0 -1
- package/lib/components/date-picker.js.map +0 -1
- package/lib/components/dropdown.d.ts +0 -404
- package/lib/components/dropdown.d.ts.map +0 -1
- package/lib/components/dropdown.js +0 -1563
- package/lib/components/dropdown.js.map +0 -1
- package/lib/components/file-upload.d.ts.map +0 -1
- package/lib/components/file-upload.js.map +0 -1
- package/lib/components/icon.d.ts.map +0 -1
- package/lib/components/icon.js.map +0 -1
- package/lib/components/input.d.ts.map +0 -1
- package/lib/components/input.js.map +0 -1
- package/lib/components/modal.d.ts.map +0 -1
- package/lib/components/modal.js.map +0 -1
- package/lib/components/multiselect.d.ts +0 -408
- package/lib/components/multiselect.d.ts.map +0 -1
- package/lib/components/multiselect.js +0 -1611
- package/lib/components/multiselect.js.map +0 -1
- package/lib/components/option.d.ts.map +0 -1
- package/lib/components/option.js.map +0 -1
- package/lib/components/popup.d.ts.map +0 -1
- package/lib/components/popup.js.map +0 -1
- package/lib/components/radio.d.ts.map +0 -1
- package/lib/components/radio.js.map +0 -1
- package/lib/components/resize-observer.d.ts.map +0 -1
- package/lib/components/resize-observer.js.map +0 -1
- package/lib/components/scroll-container.d.ts.map +0 -1
- package/lib/components/scroll-container.js.map +0 -1
- package/lib/components/step.d.ts.map +0 -1
- package/lib/components/step.js.map +0 -1
- package/lib/components/switch.d.ts.map +0 -1
- package/lib/components/switch.js.map +0 -1
- package/lib/components/tab.d.ts.map +0 -1
- package/lib/components/tab.js.map +0 -1
- package/lib/components/tabs.d.ts.map +0 -1
- package/lib/components/tabs.js.map +0 -1
- package/lib/components/tag.d.ts.map +0 -1
- package/lib/components/tag.js.map +0 -1
- package/lib/components/textarea.d.ts.map +0 -1
- package/lib/components/textarea.js.map +0 -1
- package/lib/components/tooltip.d.ts.map +0 -1
- package/lib/components/tooltip.js.map +0 -1
- package/lib/components/wizard.d.ts.map +0 -1
- package/lib/components/wizard.js.map +0 -1
- package/lib/icons/fontawesome/brands.d.ts.map +0 -1
- package/lib/icons/fontawesome/brands.js.map +0 -1
- package/lib/icons/fontawesome/regular.d.ts.map +0 -1
- package/lib/icons/fontawesome/regular.js.map +0 -1
- package/lib/icons/fontawesome/solid.d.ts.map +0 -1
- package/lib/icons/fontawesome/solid.js.map +0 -1
- package/lib/icons/heroicons/micro.d.ts.map +0 -1
- package/lib/icons/heroicons/micro.js.map +0 -1
- package/lib/icons/heroicons/mini.d.ts.map +0 -1
- package/lib/icons/heroicons/mini.js.map +0 -1
- package/lib/icons/heroicons/outline.d.ts.map +0 -1
- package/lib/icons/heroicons/outline.js.map +0 -1
- package/lib/icons/heroicons/solid.d.ts.map +0 -1
- package/lib/icons/heroicons/solid.js.map +0 -1
- package/lib/icons/lucide.d.ts.map +0 -1
- package/lib/icons/lucide.js.map +0 -1
- package/lib/icons/material/filled.d.ts.map +0 -1
- package/lib/icons/material/filled.js.map +0 -1
- package/lib/icons/material/outlined.d.ts.map +0 -1
- package/lib/icons/material/outlined.js.map +0 -1
- package/lib/icons/material/round.d.ts.map +0 -1
- package/lib/icons/material/round.js.map +0 -1
- package/lib/icons/material/sharp.d.ts.map +0 -1
- package/lib/icons/material/sharp.js.map +0 -1
- package/lib/icons/material/two-tone.d.ts.map +0 -1
- package/lib/icons/material/two-tone.js.map +0 -1
- package/lib/index.d.ts.map +0 -1
- package/lib/index.js.map +0 -1
- package/lib/styles/button.d.ts.map +0 -1
- package/lib/styles/button.js.map +0 -1
- package/lib/styles/calendar-month.d.ts.map +0 -1
- package/lib/styles/calendar-month.js.map +0 -1
- package/lib/styles/calendar-navigation.d.ts.map +0 -1
- package/lib/styles/calendar-navigation.js.map +0 -1
- package/lib/styles/calendar.d.ts.map +0 -1
- package/lib/styles/calendar.js.map +0 -1
- package/lib/styles/checkbox.d.ts.map +0 -1
- package/lib/styles/checkbox.js.map +0 -1
- package/lib/styles/copy.d.ts.map +0 -1
- package/lib/styles/copy.js.map +0 -1
- package/lib/styles/custom-scrollbar.d.ts.map +0 -1
- package/lib/styles/custom-scrollbar.js.map +0 -1
- package/lib/styles/date-picker.d.ts.map +0 -1
- package/lib/styles/date-picker.js.map +0 -1
- package/lib/styles/dropdown.d.ts +0 -12
- package/lib/styles/dropdown.d.ts.map +0 -1
- package/lib/styles/dropdown.js +0 -1048
- package/lib/styles/dropdown.js.map +0 -1
- package/lib/styles/file-upload.d.ts.map +0 -1
- package/lib/styles/file-upload.js.map +0 -1
- package/lib/styles/icon.d.ts.map +0 -1
- package/lib/styles/icon.js.map +0 -1
- package/lib/styles/input.d.ts.map +0 -1
- package/lib/styles/input.js.map +0 -1
- package/lib/styles/modal.d.ts.map +0 -1
- package/lib/styles/modal.js.map +0 -1
- package/lib/styles/multiselect.d.ts +0 -6
- package/lib/styles/multiselect.d.ts.map +0 -1
- package/lib/styles/multiselect.js +0 -837
- package/lib/styles/multiselect.js.map +0 -1
- package/lib/styles/option.d.ts.map +0 -1
- package/lib/styles/option.js.map +0 -1
- package/lib/styles/popup.d.ts.map +0 -1
- package/lib/styles/popup.js.map +0 -1
- package/lib/styles/radio.d.ts.map +0 -1
- package/lib/styles/radio.js.map +0 -1
- package/lib/styles/resize-observer.d.ts.map +0 -1
- package/lib/styles/resize-observer.js.map +0 -1
- package/lib/styles/scroll-container.d.ts.map +0 -1
- package/lib/styles/scroll-container.js.map +0 -1
- package/lib/styles/step.d.ts.map +0 -1
- package/lib/styles/step.js.map +0 -1
- package/lib/styles/switch.d.ts.map +0 -1
- package/lib/styles/switch.js.map +0 -1
- package/lib/styles/tab.d.ts.map +0 -1
- package/lib/styles/tab.js.map +0 -1
- package/lib/styles/tabs.d.ts.map +0 -1
- package/lib/styles/tabs.js.map +0 -1
- package/lib/styles/tag.d.ts.map +0 -1
- package/lib/styles/tag.js.map +0 -1
- package/lib/styles/textarea.d.ts.map +0 -1
- package/lib/styles/textarea.js.map +0 -1
- package/lib/styles/tooltip.d.ts.map +0 -1
- package/lib/styles/tooltip.js.map +0 -1
- package/lib/styles/wizard.d.ts.map +0 -1
- package/lib/styles/wizard.js.map +0 -1
- package/lib/types/common.d.ts.map +0 -1
- package/lib/types/common.js.map +0 -1
- package/lib/utils/calendar-utils.d.ts.map +0 -1
- package/lib/utils/calendar-utils.js.map +0 -1
- package/lib/utils/custom-scrollbar.d.ts.map +0 -1
- package/lib/utils/custom-scrollbar.js.map +0 -1
- package/lib/utils/icon-registry.d.ts.map +0 -1
- package/lib/utils/icon-registry.js.map +0 -1
- package/lib/utils/loader-registry.d.ts.map +0 -1
- package/lib/utils/loader-registry.js.map +0 -1
- package/lib/utils/locale.d.ts.map +0 -1
- package/lib/utils/locale.js.map +0 -1
- package/lib/utils/mobile.d.ts.map +0 -1
- package/lib/utils/mobile.js.map +0 -1
- package/lib/utils/number-format.d.ts.map +0 -1
- package/lib/utils/number-format.js.map +0 -1
- package/lib/utils/parse-boolean.d.ts +0 -39
- package/lib/utils/parse-boolean.d.ts.map +0 -1
- package/lib/utils/parse-boolean.js +0 -58
- package/lib/utils/parse-boolean.js.map +0 -1
- package/lib/utils/positioning.d.ts.map +0 -1
- package/lib/utils/positioning.js.map +0 -1
- package/lib/utils/property-capture.d.ts.map +0 -1
- package/lib/utils/property-capture.js.map +0 -1
- package/lib/utils/property-manager.d.ts.map +0 -1
- package/lib/utils/property-manager.js.map +0 -1
- package/lib/utils/resize-observer.d.ts.map +0 -1
- package/lib/utils/resize-observer.js.map +0 -1
- package/lib/utils/scroll-lock.d.ts.map +0 -1
- package/lib/utils/scroll-lock.js.map +0 -1
- package/lib/utils/styles.d.ts.map +0 -1
- package/lib/utils/styles.js.map +0 -1
- package/lib/version.d.ts.map +0 -1
- package/lib/version.js.map +0 -1
package/lib/types/common.d.ts
CHANGED
|
@@ -6,7 +6,8 @@
|
|
|
6
6
|
* for a softer shade — e.g. `primary`, `primary+`, `primary-`. Matches the
|
|
7
7
|
* design system's `ty-bg-primary+` / `ty-text-primary-` class convention.
|
|
8
8
|
*/
|
|
9
|
-
export
|
|
9
|
+
export declare const FLAVORS: readonly ["primary", "success", "danger", "warning", "neutral"];
|
|
10
|
+
export type FlavorBase = (typeof FLAVORS)[number];
|
|
10
11
|
/**
|
|
11
12
|
* A flavor with optional shade suffix: `primary | primary+ | primary-`.
|
|
12
13
|
*/
|
|
@@ -23,6 +24,8 @@ export type FlavorShaded<F extends string = FlavorBase> = F | `${F}+` | `${F}-`;
|
|
|
23
24
|
export type Flavor = FlavorShaded | (string & {});
|
|
24
25
|
/** Component size variants */
|
|
25
26
|
export type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
|
|
27
|
+
/** Default `size` for every field component — change here, not per component. */
|
|
28
|
+
export declare const DEFAULT_SIZE: Size;
|
|
26
29
|
/** Input types supported by ty-input */
|
|
27
30
|
export type InputType = 'text' | 'password' | 'email' | 'url' | 'tel' | 'date' | 'time' | 'datetime-local' | 'number' | 'currency' | 'percent' | 'compact' | 'checkbox';
|
|
28
31
|
/** Base properties shared by all Ty components */
|
|
@@ -49,7 +52,6 @@ export interface TyButtonElement extends TyBaseElement {
|
|
|
49
52
|
/** Button type for forms */
|
|
50
53
|
type?: 'button' | 'submit' | 'reset';
|
|
51
54
|
}
|
|
52
|
-
/** CSS style content */
|
|
53
55
|
/** Icon size variants */
|
|
54
56
|
export type IconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '12' | '14' | '16' | '18' | '20' | '24' | '32' | '48' | '64' | '80' | '96';
|
|
55
57
|
/** Icon animation tempo */
|
|
@@ -78,10 +80,8 @@ export interface TyTagElement extends TyBaseElement {
|
|
|
78
80
|
value?: string;
|
|
79
81
|
/** Tag size */
|
|
80
82
|
size?: Size;
|
|
81
|
-
/**
|
|
82
|
-
|
|
83
|
-
/** Pill shape (fully rounded) - default true */
|
|
84
|
-
pill?: boolean;
|
|
83
|
+
/** Square corners instead of the default pill */
|
|
84
|
+
noPill?: boolean;
|
|
85
85
|
/** Clickable state */
|
|
86
86
|
clickable?: boolean;
|
|
87
87
|
/** Dismissible state */
|
|
@@ -93,8 +93,10 @@ export interface TyTagElement extends TyBaseElement {
|
|
|
93
93
|
export interface TyOptionElement extends Omit<HTMLElement, 'hidden'> {
|
|
94
94
|
/** Option value */
|
|
95
95
|
value?: string;
|
|
96
|
-
/**
|
|
96
|
+
/** The app's mark, read by ty-select only in `external-selection` mode */
|
|
97
97
|
selected?: boolean;
|
|
98
|
+
/** Set by the parent ty-select: draws the check and aria-selected */
|
|
99
|
+
checked?: boolean;
|
|
98
100
|
/** Disabled state */
|
|
99
101
|
disabled?: boolean;
|
|
100
102
|
/** Highlighted state (keyboard navigation) */
|
|
@@ -140,4 +142,3 @@ export interface StyleContent {
|
|
|
140
142
|
/** Optional style ID for caching */
|
|
141
143
|
id?: string;
|
|
142
144
|
}
|
|
143
|
-
//# sourceMappingURL=common.d.ts.map
|
package/lib/types/common.js
CHANGED
|
@@ -1,25 +1,9 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Calendar
|
|
2
|
+
* Calendar month generation and localization (native Date API only).
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
* Key Features:
|
|
8
|
-
* - 42-day calendar grid generation (6 weeks × 7 days)
|
|
9
|
-
* - Monday-first week ordering
|
|
10
|
-
* - Rich day context with metadata
|
|
11
|
-
* - Localized weekday names
|
|
12
|
-
* - No external dependencies (native Date API only)
|
|
13
|
-
*
|
|
14
|
-
* Note on Timestamps:
|
|
15
|
-
* - `value`: UTC timestamp at midnight UTC (timezone-independent, use for storage/server)
|
|
16
|
-
* - `localValue`: Local timestamp at midnight local time (use for display/local calculations)
|
|
17
|
-
* - `year/month/dayInMonth`: Calendar date components (user's mental model)
|
|
18
|
-
*
|
|
19
|
-
* Example for October 13, 2025:
|
|
20
|
-
* - value = Date.UTC(2025, 9, 13) = consistent worldwide
|
|
21
|
-
* - localValue = new Date(2025, 9, 13).getTime() = varies by timezone
|
|
22
|
-
* - Both represent the same calendar date, different moments in time
|
|
4
|
+
* Timestamps: `value` is UTC midnight (timezone-independent, for storage/server),
|
|
5
|
+
* `localValue` is local midnight (for display/local math). Both denote the same
|
|
6
|
+
* calendar date but are different moments in time.
|
|
23
7
|
*/
|
|
24
8
|
/**
|
|
25
9
|
* Rich context for a single calendar day
|
|
@@ -57,6 +41,14 @@ export interface DayContext {
|
|
|
57
41
|
/** Calendar's selected day (if any) */
|
|
58
42
|
selectedDay?: number;
|
|
59
43
|
}
|
|
44
|
+
/**
|
|
45
|
+
* Local midnight of a calendar day. Not the Date constructor: it reads years
|
|
46
|
+
* 0-99 as 1900-1999. Noon is never skipped by a clock change, so the day
|
|
47
|
+
* can't shift before setHours.
|
|
48
|
+
*/
|
|
49
|
+
export declare function localMidnight(year: number, month: number, day: number): Date;
|
|
50
|
+
/** UTC midnight of a calendar day, as a timestamp. Not Date.UTC(): it reads years 0-99 as 1900-1999. */
|
|
51
|
+
export declare function utcMidnight(year: number, month: number, day: number): number;
|
|
60
52
|
/**
|
|
61
53
|
* Generate a 42-day calendar grid for a given month
|
|
62
54
|
*
|
|
@@ -110,30 +102,6 @@ export declare function getLocalizedWeekdays(locale: string, style?: 'long' | 's
|
|
|
110
102
|
* @throws {RangeError} If month is invalid
|
|
111
103
|
*/
|
|
112
104
|
export declare function getMonthName(month: number, locale?: string, style?: 'long' | 'short' | 'narrow'): string;
|
|
113
|
-
/**
|
|
114
|
-
* Format a day context as an ISO date string
|
|
115
|
-
*
|
|
116
|
-
* @param dayContext - Day context to format
|
|
117
|
-
* @returns ISO date string (YYYY-MM-DD)
|
|
118
|
-
*
|
|
119
|
-
* @example
|
|
120
|
-
* formatDayContext({ year: 2025, month: 10, dayInMonth: 13, ... })
|
|
121
|
-
* // Returns: "2025-10-13"
|
|
122
|
-
*/
|
|
123
|
-
export declare function formatDayContext(dayContext: DayContext): string;
|
|
124
|
-
/**
|
|
125
|
-
* Check if a day context matches a specific date
|
|
126
|
-
*
|
|
127
|
-
* @param dayContext - Day context to check
|
|
128
|
-
* @param year - Target year
|
|
129
|
-
* @param month - Target month (1-12)
|
|
130
|
-
* @param day - Target day
|
|
131
|
-
* @returns True if the day context matches
|
|
132
|
-
*
|
|
133
|
-
* @example
|
|
134
|
-
* isDayContext(dayCtx, 2025, 10, 13) // true if context is Oct 13, 2025
|
|
135
|
-
*/
|
|
136
|
-
export declare function isDayContext(dayContext: DayContext, year: number, month: number, day: number): boolean;
|
|
137
105
|
/**
|
|
138
106
|
* Parse an ISO date string (YYYY-MM-DD) into year, month, day components
|
|
139
107
|
*
|
|
@@ -150,27 +118,43 @@ export declare function parseISODate(isoString: string): {
|
|
|
150
118
|
day: number;
|
|
151
119
|
} | null;
|
|
152
120
|
/**
|
|
153
|
-
*
|
|
154
|
-
* Interprets the timestamp as UTC midnight and returns the date
|
|
155
|
-
*
|
|
156
|
-
* @param utcTimestamp - UTC timestamp in milliseconds
|
|
157
|
-
* @returns ISO date string (YYYY-MM-DD)
|
|
158
|
-
*
|
|
159
|
-
* @example
|
|
160
|
-
* const ctx = getCalendarMonthDays(2025, 10)[0];
|
|
161
|
-
* utcTimestampToISO(ctx.value) // "2025-10-13"
|
|
121
|
+
* Date/time components in local time, as ty-date-picker holds them.
|
|
162
122
|
*/
|
|
163
|
-
export
|
|
123
|
+
export interface DateTimeParts {
|
|
124
|
+
year?: number;
|
|
125
|
+
month?: number;
|
|
126
|
+
day?: number;
|
|
127
|
+
hour?: number;
|
|
128
|
+
minute?: number;
|
|
129
|
+
second?: number;
|
|
130
|
+
epoch?: number;
|
|
131
|
+
}
|
|
132
|
+
/** A Date whose UTC fields are these components: formats a wall-clock as written (timeZone 'UTC'). */
|
|
133
|
+
export declare function wallClockDate(c: DateTimeParts): Date;
|
|
164
134
|
/**
|
|
165
|
-
*
|
|
166
|
-
*
|
|
167
|
-
*
|
|
168
|
-
*
|
|
169
|
-
*
|
|
170
|
-
*
|
|
171
|
-
*
|
|
172
|
-
*
|
|
173
|
-
*
|
|
135
|
+
* Parse any date value ty-date-picker reads into local components:
|
|
136
|
+
* - Date only: '2024-09-21' (that calendar day)
|
|
137
|
+
* - Datetime-local: '2024-09-21T10:30[:45]' (local wall-clock)
|
|
138
|
+
* - UTC strings: '2024-09-21T08:30:00Z' or '2024-09-21T08:30:00.000Z'
|
|
139
|
+
* - With timezone: '2024-09-21T10:30:00+02:00'
|
|
140
|
+
* - Timestamps: milliseconds since epoch (a number, not a digit string)
|
|
141
|
+
*
|
|
142
|
+
* A zone-less value is taken as written, even a time the clocks skip when
|
|
143
|
+
* summer time starts (like <input type=datetime-local>); 2024-02-30 or 24:00
|
|
144
|
+
* is no value. An instant reads as its LOCAL day and time, and keeps its
|
|
145
|
+
* epoch.
|
|
146
|
+
*/
|
|
147
|
+
export declare function parseDateTime(value: string | number | null | undefined): DateTimeParts | null;
|
|
148
|
+
/**
|
|
149
|
+
* The calendar day of any value parseDateTime reads, or a Date: an instant
|
|
150
|
+
* is its local day. Years outside 1-9999 (no 4-digit YYYY-MM-DD) are no day.
|
|
174
151
|
*/
|
|
175
|
-
export declare function
|
|
176
|
-
|
|
152
|
+
export declare function parseDateDay(value: string | number | Date | null | undefined): {
|
|
153
|
+
year: number;
|
|
154
|
+
month: number;
|
|
155
|
+
day: number;
|
|
156
|
+
} | null;
|
|
157
|
+
/** 'YYYY-MM-DD' of a calendar day (years below 1000 padded to 4 digits). */
|
|
158
|
+
export declare function formatISODay(year: number, month: number, day: number): string;
|
|
159
|
+
/** Any value parseDateDay reads as 'YYYY-MM-DD', or null. */
|
|
160
|
+
export declare function toISODay(value: string | number | Date | null | undefined): string | null;
|