use-wc 1.0.0-pre.84 → 1.0.0-pre.86

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.
@@ -351,6 +351,10 @@
351
351
  "description": "Next month button",
352
352
  "name": "control-next"
353
353
  },
354
+ {
355
+ "description": "Arrow glyph inside the previous and next buttons, mirrored in right-to-left layouts",
356
+ "name": "control-icon"
357
+ },
354
358
  {
355
359
  "description": "The main calendar grid",
356
360
  "name": "grid"
@@ -443,6 +447,20 @@
443
447
  }
444
448
  ],
445
449
  "members": [
450
+ {
451
+ "kind": "field",
452
+ "name": "localeRoot",
453
+ "type": {
454
+ "text": "string | undefined"
455
+ },
456
+ "static": true,
457
+ "description": "The tag whose translations this element uses and whose `lang` it follows when it has none of\nits own, such as `use-grid` for its rows. Defaults to the element's own tag.",
458
+ "default": "\"use-calendar\"",
459
+ "inheritedFrom": {
460
+ "name": "LocalizedElement",
461
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
462
+ }
463
+ },
446
464
  {
447
465
  "kind": "field",
448
466
  "name": "year",
@@ -589,6 +607,31 @@
589
607
  {
590
608
  "kind": "method",
591
609
  "name": "focus"
610
+ },
611
+ {
612
+ "kind": "field",
613
+ "name": "strings",
614
+ "type": {
615
+ "text": "StringOverrides | undefined"
616
+ },
617
+ "description": "Per-element overrides for this element's user-facing strings, keyed by string name. Values\nsupport `{placeholder}` substitution and plural objects keyed by `Intl.PluralRules` category.",
618
+ "inheritedFrom": {
619
+ "name": "LocalizedElement",
620
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
621
+ }
622
+ },
623
+ {
624
+ "kind": "field",
625
+ "name": "locale",
626
+ "type": {
627
+ "text": "string"
628
+ },
629
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
630
+ "readonly": true,
631
+ "inheritedFrom": {
632
+ "name": "UseLocaleElement",
633
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
634
+ }
592
635
  }
593
636
  ],
594
637
  "attributes": [
@@ -680,16 +723,22 @@
680
723
  },
681
724
  {
682
725
  "name": "lang",
683
- "type": {
684
- "text": "string"
685
- },
686
- "fieldName": "lang",
687
726
  "inheritedFrom": {
688
727
  "name": "UseLocaleElement",
689
728
  "module": "src/elements/use-locale-element/use-locale-element.ts"
690
729
  }
691
730
  }
692
731
  ],
732
+ "mixins": [
733
+ {
734
+ "name": "InlineDirectionElement",
735
+ "module": "/src/utils/inline-direction-element"
736
+ },
737
+ {
738
+ "name": "LocalizedElement",
739
+ "module": "/src/elements/use-locale-element/use-locale-element"
740
+ }
741
+ ],
693
742
  "superclass": {
694
743
  "name": "UseLocaleElement",
695
744
  "module": "/src/elements/use-locale-element/use-locale-element"
@@ -885,7 +934,7 @@
885
934
  "declarations": [
886
935
  {
887
936
  "kind": "class",
888
- "description": "Displays a date picker using segmented inputs for year, month, and day.\n\nUses browser locale for formatting and ARIA labels.",
937
+ "description": "Displays a date picker using segmented inputs for year, month, and day.\n\nUses browser locale for formatting and ARIA labels.\n\nIts user-facing strings are listed under \"strings\" in the API table; override them with the\n`strings` property or the localization add-on.",
889
938
  "name": "UseDateInput",
890
939
  "members": [
891
940
  {
@@ -939,6 +988,44 @@
939
988
  },
940
989
  "default": "YYYY-MM-DD",
941
990
  "attribute": "value"
991
+ },
992
+ {
993
+ "kind": "field",
994
+ "name": "strings",
995
+ "type": {
996
+ "text": "StringOverrides | undefined"
997
+ },
998
+ "description": "Per-element overrides for this element's user-facing strings, keyed by string name. Values\nsupport `{placeholder}` substitution and plural objects keyed by `Intl.PluralRules` category.",
999
+ "inheritedFrom": {
1000
+ "name": "LocalizedElement",
1001
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
1002
+ }
1003
+ },
1004
+ {
1005
+ "kind": "field",
1006
+ "name": "localeRoot",
1007
+ "type": {
1008
+ "text": "string | undefined"
1009
+ },
1010
+ "static": true,
1011
+ "description": "The tag whose translations this element uses and whose `lang` it follows when it has none of\nits own, such as `use-grid` for its rows. Defaults to the element's own tag.",
1012
+ "inheritedFrom": {
1013
+ "name": "LocalizedElement",
1014
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
1015
+ }
1016
+ },
1017
+ {
1018
+ "kind": "field",
1019
+ "name": "locale",
1020
+ "type": {
1021
+ "text": "string"
1022
+ },
1023
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
1024
+ "readonly": true,
1025
+ "inheritedFrom": {
1026
+ "name": "UseLocaleElement",
1027
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
1028
+ }
942
1029
  }
943
1030
  ],
944
1031
  "attributes": [
@@ -968,16 +1055,18 @@
968
1055
  },
969
1056
  {
970
1057
  "name": "lang",
971
- "type": {
972
- "text": "string"
973
- },
974
- "fieldName": "lang",
975
1058
  "inheritedFrom": {
976
1059
  "name": "UseLocaleElement",
977
1060
  "module": "src/elements/use-locale-element/use-locale-element.ts"
978
1061
  }
979
1062
  }
980
1063
  ],
1064
+ "mixins": [
1065
+ {
1066
+ "name": "LocalizedElement",
1067
+ "module": "/src/elements/use-locale-element/use-locale-element"
1068
+ }
1069
+ ],
981
1070
  "superclass": {
982
1071
  "name": "UseLocaleElement",
983
1072
  "module": "/src/elements/use-locale-element/use-locale-element"
@@ -1021,6 +1110,32 @@
1021
1110
  "text": "string"
1022
1111
  }
1023
1112
  },
1113
+ {
1114
+ "kind": "field",
1115
+ "name": "strings",
1116
+ "type": {
1117
+ "text": "StringOverrides | undefined"
1118
+ },
1119
+ "description": "Per-element overrides for this element's user-facing strings, keyed by string name. Values\nsupport `{placeholder}` substitution and plural objects keyed by `Intl.PluralRules` category.",
1120
+ "inheritedFrom": {
1121
+ "name": "LocalizedElement",
1122
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
1123
+ }
1124
+ },
1125
+ {
1126
+ "kind": "field",
1127
+ "name": "localeRoot",
1128
+ "type": {
1129
+ "text": "string | undefined"
1130
+ },
1131
+ "static": true,
1132
+ "description": "The tag whose translations this element uses and whose `lang` it follows when it has none of\nits own, such as `use-grid` for its rows. Defaults to the element's own tag.",
1133
+ "default": "\"use-calendar\"",
1134
+ "inheritedFrom": {
1135
+ "name": "LocalizedElement",
1136
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
1137
+ }
1138
+ },
1024
1139
  {
1025
1140
  "kind": "field",
1026
1141
  "name": "year",
@@ -1227,6 +1342,19 @@
1227
1342
  "name": "UseCalendarBase",
1228
1343
  "module": "src/elements/use-calendar-base/use-calendar-base.ts"
1229
1344
  }
1345
+ },
1346
+ {
1347
+ "kind": "field",
1348
+ "name": "locale",
1349
+ "type": {
1350
+ "text": "string"
1351
+ },
1352
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
1353
+ "readonly": true,
1354
+ "inheritedFrom": {
1355
+ "name": "UseLocaleElement",
1356
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
1357
+ }
1230
1358
  }
1231
1359
  ],
1232
1360
  "events": [
@@ -1367,6 +1495,14 @@
1367
1495
  "module": "src/elements/use-calendar-base/use-calendar-base.ts"
1368
1496
  }
1369
1497
  },
1498
+ {
1499
+ "description": "Arrow glyph inside the previous and next buttons, mirrored in right-to-left layouts",
1500
+ "name": "control-icon",
1501
+ "inheritedFrom": {
1502
+ "name": "UseCalendarBase",
1503
+ "module": "src/elements/use-calendar-base/use-calendar-base.ts"
1504
+ }
1505
+ },
1370
1506
  {
1371
1507
  "description": "The main calendar grid",
1372
1508
  "name": "grid",
@@ -1637,10 +1773,6 @@
1637
1773
  },
1638
1774
  {
1639
1775
  "name": "lang",
1640
- "type": {
1641
- "text": "string"
1642
- },
1643
- "fieldName": "lang",
1644
1776
  "inheritedFrom": {
1645
1777
  "name": "UseLocaleElement",
1646
1778
  "module": "src/elements/use-locale-element/use-locale-element.ts"
@@ -1772,6 +1904,19 @@
1772
1904
  },
1773
1905
  "default": "''",
1774
1906
  "attribute": "value"
1907
+ },
1908
+ {
1909
+ "kind": "field",
1910
+ "name": "locale",
1911
+ "type": {
1912
+ "text": "string"
1913
+ },
1914
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
1915
+ "readonly": true,
1916
+ "inheritedFrom": {
1917
+ "name": "UseLocaleElement",
1918
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
1919
+ }
1775
1920
  }
1776
1921
  ],
1777
1922
  "attributes": [
@@ -1846,10 +1991,6 @@
1846
1991
  },
1847
1992
  {
1848
1993
  "name": "lang",
1849
- "type": {
1850
- "text": "string"
1851
- },
1852
- "fieldName": "lang",
1853
1994
  "inheritedFrom": {
1854
1995
  "name": "UseLocaleElement",
1855
1996
  "module": "src/elements/use-locale-element/use-locale-element.ts"
@@ -1889,7 +2030,7 @@
1889
2030
  "declarations": [
1890
2031
  {
1891
2032
  "kind": "class",
1892
- "description": "Displays the parts of an ISO 8601 duration string using [`Intl.DurationFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat).\n\nUses the [`duration-fns`](https://www.npmjs.com/package/duration-fns) library for parsing ISO 8601 values.\n\n<baseline-status featureId=\"intl-duration-format\"></baseline-status>",
2033
+ "description": "Displays the parts of an ISO 8601 duration string using [`Intl.DurationFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DurationFormat).\n\nUses the [`duration-fns`](https://www.npmjs.com/package/duration-fns) library for parsing ISO 8601 values.\n\nIts user-facing strings are listed under \"strings\" in the API table; override them with the\n`strings` property or the localization add-on.\n\n<baseline-status featureId=\"intl-duration-format\"></baseline-status>",
1893
2034
  "name": "UseDurationInput",
1894
2035
  "members": [
1895
2036
  {
@@ -2059,6 +2200,44 @@
2059
2200
  },
2060
2201
  "default": "\"short\"",
2061
2202
  "attribute": "format"
2203
+ },
2204
+ {
2205
+ "kind": "field",
2206
+ "name": "strings",
2207
+ "type": {
2208
+ "text": "StringOverrides | undefined"
2209
+ },
2210
+ "description": "Per-element overrides for this element's user-facing strings, keyed by string name. Values\nsupport `{placeholder}` substitution and plural objects keyed by `Intl.PluralRules` category.",
2211
+ "inheritedFrom": {
2212
+ "name": "LocalizedElement",
2213
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
2214
+ }
2215
+ },
2216
+ {
2217
+ "kind": "field",
2218
+ "name": "localeRoot",
2219
+ "type": {
2220
+ "text": "string | undefined"
2221
+ },
2222
+ "static": true,
2223
+ "description": "The tag whose translations this element uses and whose `lang` it follows when it has none of\nits own, such as `use-grid` for its rows. Defaults to the element's own tag.",
2224
+ "inheritedFrom": {
2225
+ "name": "LocalizedElement",
2226
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
2227
+ }
2228
+ },
2229
+ {
2230
+ "kind": "field",
2231
+ "name": "locale",
2232
+ "type": {
2233
+ "text": "string"
2234
+ },
2235
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
2236
+ "readonly": true,
2237
+ "inheritedFrom": {
2238
+ "name": "UseLocaleElement",
2239
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
2240
+ }
2062
2241
  }
2063
2242
  ],
2064
2243
  "attributes": [
@@ -2160,16 +2339,18 @@
2160
2339
  },
2161
2340
  {
2162
2341
  "name": "lang",
2163
- "type": {
2164
- "text": "string"
2165
- },
2166
- "fieldName": "lang",
2167
2342
  "inheritedFrom": {
2168
2343
  "name": "UseLocaleElement",
2169
2344
  "module": "src/elements/use-locale-element/use-locale-element.ts"
2170
2345
  }
2171
2346
  }
2172
2347
  ],
2348
+ "mixins": [
2349
+ {
2350
+ "name": "LocalizedElement",
2351
+ "module": "/src/elements/use-locale-element/use-locale-element"
2352
+ }
2353
+ ],
2173
2354
  "superclass": {
2174
2355
  "name": "UseLocaleElement",
2175
2356
  "module": "/src/elements/use-locale-element/use-locale-element"
@@ -2497,6 +2678,9 @@
2497
2678
  }
2498
2679
  ],
2499
2680
  "attributes": [
2681
+ {
2682
+ "name": "lang"
2683
+ },
2500
2684
  {
2501
2685
  "name": "selectmode",
2502
2686
  "type": {
@@ -2764,9 +2948,23 @@
2764
2948
  "declarations": [
2765
2949
  {
2766
2950
  "kind": "class",
2767
- "description": "",
2951
+ "description": "A row in a `use-grid`. When the grid shows a selection column, the row builds and labels the\nleading selection control.\n\nIts user-facing strings are listed under \"strings\" in the `use-grid` API table; override them\nwith the `strings` property or the localization add-on.",
2768
2952
  "name": "UseGridRow",
2769
2953
  "members": [
2954
+ {
2955
+ "kind": "field",
2956
+ "name": "localeRoot",
2957
+ "type": {
2958
+ "text": "string | undefined"
2959
+ },
2960
+ "static": true,
2961
+ "description": "The tag whose translations this element uses and whose `lang` it follows when it has none of\nits own, such as `use-grid` for its rows. Defaults to the element's own tag.",
2962
+ "default": "\"use-grid\"",
2963
+ "inheritedFrom": {
2964
+ "name": "LocalizedElement",
2965
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
2966
+ }
2967
+ },
2770
2968
  {
2771
2969
  "kind": "field",
2772
2970
  "name": "selected",
@@ -2810,6 +3008,31 @@
2810
3008
  {
2811
3009
  "kind": "method",
2812
3010
  "name": "reconcileSelectorCell"
3011
+ },
3012
+ {
3013
+ "kind": "field",
3014
+ "name": "strings",
3015
+ "type": {
3016
+ "text": "StringOverrides | undefined"
3017
+ },
3018
+ "description": "Per-element overrides for this element's user-facing strings, keyed by string name. Values\nsupport `{placeholder}` substitution and plural objects keyed by `Intl.PluralRules` category.",
3019
+ "inheritedFrom": {
3020
+ "name": "LocalizedElement",
3021
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
3022
+ }
3023
+ },
3024
+ {
3025
+ "kind": "field",
3026
+ "name": "locale",
3027
+ "type": {
3028
+ "text": "string"
3029
+ },
3030
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
3031
+ "readonly": true,
3032
+ "inheritedFrom": {
3033
+ "name": "UseLocaleElement",
3034
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
3035
+ }
2813
3036
  }
2814
3037
  ],
2815
3038
  "attributes": [
@@ -2844,11 +3067,24 @@
2844
3067
  },
2845
3068
  "default": "\"\"",
2846
3069
  "fieldName": "value"
3070
+ },
3071
+ {
3072
+ "name": "lang",
3073
+ "inheritedFrom": {
3074
+ "name": "UseLocaleElement",
3075
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
3076
+ }
3077
+ }
3078
+ ],
3079
+ "mixins": [
3080
+ {
3081
+ "name": "LocalizedElement",
3082
+ "module": "/src/elements/use-locale-element/use-locale-element"
2847
3083
  }
2848
3084
  ],
2849
3085
  "superclass": {
2850
- "name": "LitElement",
2851
- "package": "lit"
3086
+ "name": "UseLocaleElement",
3087
+ "module": "/src/elements/use-locale-element/use-locale-element"
2852
3088
  },
2853
3089
  "tagName": "use-gridrow",
2854
3090
  "customElement": true
@@ -2879,7 +3115,7 @@
2879
3115
  "declarations": [
2880
3116
  {
2881
3117
  "kind": "class",
2882
- "description": "Displays a localized, human-readable representation of a date, time, or datetime.\nRenders a semantic `<time>` element in its shadow root with a machine-readable\n`datetime` attribute and formatted inner text.\n\nSet `datestyle`, `timestyle`, or both to control what is formatted and how.\nThe presence of each attribute determines the format mode:\n- `datestyle` only → date formatting\n- `timestyle` only → time formatting\n- both → date and time formatting\n\nLocale is resolved from the nearest ancestor `[lang]` attribute, or\n`navigator.language` if none is found. Set `lang` directly on the element to override.",
3118
+ "description": "Displays a localized, human-readable representation of a date, time, or datetime.\nRenders a semantic `<time>` element in its shadow root with a machine-readable\n`datetime` attribute and formatted inner text.\n\nSet `datestyle`, `timestyle`, or both to control what is formatted and how.\nThe presence of each attribute determines the format mode:\n- `datestyle` only → date formatting\n- `timestyle` only → time formatting\n- both → date and time formatting\n\nFormats in the element's own `lang`, then `<html lang>`, then the browser's language. The\nresolved locale is available as the read-only `locale` property.",
2883
3119
  "name": "UseIntlDatetime",
2884
3120
  "members": [
2885
3121
  {
@@ -2905,6 +3141,19 @@
2905
3141
  "text": "string | undefined"
2906
3142
  },
2907
3143
  "attribute": "timestyle"
3144
+ },
3145
+ {
3146
+ "kind": "field",
3147
+ "name": "locale",
3148
+ "type": {
3149
+ "text": "string"
3150
+ },
3151
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
3152
+ "readonly": true,
3153
+ "inheritedFrom": {
3154
+ "name": "UseLocaleElement",
3155
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
3156
+ }
2908
3157
  }
2909
3158
  ],
2910
3159
  "attributes": [
@@ -2937,8 +3186,7 @@
2937
3186
  "type": {
2938
3187
  "text": "string"
2939
3188
  },
2940
- "fieldName": "lang",
2941
- "description": "BCP 47 locale tag. Inherits from nearest ancestor `[lang]` if not set.",
3189
+ "description": "BCP 47 locale tag. Falls back to `<html lang>` if not set.",
2942
3190
  "inheritedFrom": {
2943
3191
  "name": "UseLocaleElement",
2944
3192
  "module": "src/elements/use-locale-element/use-locale-element.ts"
@@ -2978,7 +3226,7 @@
2978
3226
  "declarations": [
2979
3227
  {
2980
3228
  "kind": "class",
2981
- "description": "Displays a localized, human-readable representation of a number using\n[`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat).\nRenders a semantic `<data>` element in its shadow root with a machine-readable\n`value` attribute and formatted inner text.\n\nSet `numberstyle` to control what kind of number is formatted (see\n[`style`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#style)):\n- `decimal` (default) → plain number, e.g. `1,234.5`\n- `percent` → percentage, e.g. `42%` (value is the fraction, so `0.42` renders `42%`)\n- `currency` → currency amount, requires `currency`\n- `unit` → measurement, requires `unit`\n\nLocale is resolved from the nearest ancestor `[lang]` attribute, or\n`navigator.language` if none is found. Set `lang` directly on the element to override.",
3229
+ "description": "Displays a localized, human-readable representation of a number using\n[`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat).\nRenders a semantic `<data>` element in its shadow root with a machine-readable\n`value` attribute and formatted inner text.\n\nSet `numberstyle` to control what kind of number is formatted (see\n[`style`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#style)):\n- `decimal` (default) → plain number, e.g. `1,234.5`\n- `percent` → percentage, e.g. `42%` (value is the fraction, so `0.42` renders `42%`)\n- `currency` → currency amount, requires `currency`\n- `unit` → measurement, requires `unit`\n\nFormats in the element's own `lang`, then `<html lang>`, then the browser's language. The\nresolved locale is available as the read-only `locale` property.",
2982
3230
  "name": "UseIntlNumber",
2983
3231
  "members": [
2984
3232
  {
@@ -3044,6 +3292,19 @@
3044
3292
  "text": "string | undefined"
3045
3293
  },
3046
3294
  "attribute": "signdisplay"
3295
+ },
3296
+ {
3297
+ "kind": "field",
3298
+ "name": "locale",
3299
+ "type": {
3300
+ "text": "string"
3301
+ },
3302
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
3303
+ "readonly": true,
3304
+ "inheritedFrom": {
3305
+ "name": "UseLocaleElement",
3306
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
3307
+ }
3047
3308
  }
3048
3309
  ],
3049
3310
  "attributes": [
@@ -3116,8 +3377,7 @@
3116
3377
  "type": {
3117
3378
  "text": "string"
3118
3379
  },
3119
- "fieldName": "lang",
3120
- "description": "BCP 47 locale tag. Inherits from nearest ancestor `[lang]` if not set.",
3380
+ "description": "BCP 47 locale tag. Falls back to `<html lang>` if not set.",
3121
3381
  "inheritedFrom": {
3122
3382
  "name": "UseLocaleElement",
3123
3383
  "module": "src/elements/use-locale-element/use-locale-element.ts"
@@ -3610,14 +3870,20 @@
3610
3870
  "kind": "class",
3611
3871
  "description": "",
3612
3872
  "name": "UseLocaleElement",
3613
- "members": [],
3614
- "attributes": [
3873
+ "members": [
3615
3874
  {
3616
- "name": "lang",
3875
+ "kind": "field",
3876
+ "name": "locale",
3617
3877
  "type": {
3618
3878
  "text": "string"
3619
3879
  },
3620
- "fieldName": "lang"
3880
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
3881
+ "readonly": true
3882
+ }
3883
+ ],
3884
+ "attributes": [
3885
+ {
3886
+ "name": "lang"
3621
3887
  }
3622
3888
  ],
3623
3889
  "superclass": {
@@ -3625,6 +3891,58 @@
3625
3891
  "package": "lit"
3626
3892
  },
3627
3893
  "customElement": true
3894
+ },
3895
+ {
3896
+ "kind": "class",
3897
+ "description": "",
3898
+ "name": "LocalizedElementInterface",
3899
+ "members": [
3900
+ {
3901
+ "kind": "field",
3902
+ "name": "strings",
3903
+ "type": {
3904
+ "text": "Partial<Record<keyof Defaults, StringTemplate>> | undefined"
3905
+ }
3906
+ }
3907
+ ]
3908
+ },
3909
+ {
3910
+ "kind": "mixin",
3911
+ "description": "Adds string resolution to a `UseLocaleElement` subclass. `defaults` holds the English strings.\nTranslations registered by the localization add-on are keyed by the element's tag, or by\nthe static `localeRoot` when the element is part of another component, such as `use-grid` for its rows; an\nelement without its own `lang` then follows the closest root's. Instances resolve a string with\n`this.string(key, parameters)`; override `intlStrings()` to supply labels derived from `Intl`\nfor the element's `locale`.",
3912
+ "name": "LocalizedElement",
3913
+ "members": [
3914
+ {
3915
+ "kind": "field",
3916
+ "name": "strings",
3917
+ "type": {
3918
+ "text": "StringOverrides | undefined"
3919
+ },
3920
+ "description": "Per-element overrides for this element's user-facing strings, keyed by string name. Values\nsupport `{placeholder}` substitution and plural objects keyed by `Intl.PluralRules` category."
3921
+ },
3922
+ {
3923
+ "kind": "field",
3924
+ "name": "localeRoot",
3925
+ "type": {
3926
+ "text": "string | undefined"
3927
+ },
3928
+ "static": true,
3929
+ "description": "The tag whose translations this element uses and whose `lang` it follows when it has none of\nits own, such as `use-grid` for its rows. Defaults to the element's own tag."
3930
+ }
3931
+ ],
3932
+ "parameters": [
3933
+ {
3934
+ "name": "superClass",
3935
+ "type": {
3936
+ "text": "Base"
3937
+ }
3938
+ },
3939
+ {
3940
+ "name": "defaults",
3941
+ "type": {
3942
+ "text": "Defaults"
3943
+ }
3944
+ }
3945
+ ]
3628
3946
  }
3629
3947
  ],
3630
3948
  "exports": [
@@ -3635,6 +3953,22 @@
3635
3953
  "name": "UseLocaleElement",
3636
3954
  "module": "src/elements/use-locale-element/use-locale-element.ts"
3637
3955
  }
3956
+ },
3957
+ {
3958
+ "kind": "js",
3959
+ "name": "LocalizedElementInterface",
3960
+ "declaration": {
3961
+ "name": "LocalizedElementInterface",
3962
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
3963
+ }
3964
+ },
3965
+ {
3966
+ "kind": "js",
3967
+ "name": "LocalizedElement",
3968
+ "declaration": {
3969
+ "name": "LocalizedElement",
3970
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
3971
+ }
3638
3972
  }
3639
3973
  ]
3640
3974
  },
@@ -3788,6 +4122,10 @@
3788
4122
  "description": "Next-year nav button",
3789
4123
  "name": "control-next"
3790
4124
  },
4125
+ {
4126
+ "description": "Arrow glyph inside the previous and next buttons, mirrored in right-to-left layouts",
4127
+ "name": "control-icon"
4128
+ },
3791
4129
  {
3792
4130
  "description": "4-column 12-month grid container",
3793
4131
  "name": "grid"
@@ -3917,6 +4255,44 @@
3917
4255
  }
3918
4256
  ],
3919
4257
  "description": "See UseMonthPickerRenderMonth. Assigning a new function on an\ninstance (e.g. via `.renderMonth=${fn}` in a Lit template) after first\nrender does not schedule a re-render on its own — call `requestUpdate()`\nif needed.\n\nDeclared as a regular method rather than a class field so subclass\noverrides can call `super.renderMonth(data, html)` to fall back to the\ndefault (or a parent override's) rendering."
4258
+ },
4259
+ {
4260
+ "kind": "field",
4261
+ "name": "strings",
4262
+ "type": {
4263
+ "text": "StringOverrides | undefined"
4264
+ },
4265
+ "description": "Per-element overrides for this element's user-facing strings, keyed by string name. Values\nsupport `{placeholder}` substitution and plural objects keyed by `Intl.PluralRules` category.",
4266
+ "inheritedFrom": {
4267
+ "name": "LocalizedElement",
4268
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
4269
+ }
4270
+ },
4271
+ {
4272
+ "kind": "field",
4273
+ "name": "localeRoot",
4274
+ "type": {
4275
+ "text": "string | undefined"
4276
+ },
4277
+ "static": true,
4278
+ "description": "The tag whose translations this element uses and whose `lang` it follows when it has none of\nits own, such as `use-grid` for its rows. Defaults to the element's own tag.",
4279
+ "inheritedFrom": {
4280
+ "name": "LocalizedElement",
4281
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
4282
+ }
4283
+ },
4284
+ {
4285
+ "kind": "field",
4286
+ "name": "locale",
4287
+ "type": {
4288
+ "text": "string"
4289
+ },
4290
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
4291
+ "readonly": true,
4292
+ "inheritedFrom": {
4293
+ "name": "UseLocaleElement",
4294
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
4295
+ }
3920
4296
  }
3921
4297
  ],
3922
4298
  "events": [
@@ -3982,16 +4358,22 @@
3982
4358
  },
3983
4359
  {
3984
4360
  "name": "lang",
3985
- "type": {
3986
- "text": "string"
3987
- },
3988
- "fieldName": "lang",
3989
4361
  "inheritedFrom": {
3990
4362
  "name": "UseLocaleElement",
3991
4363
  "module": "src/elements/use-locale-element/use-locale-element.ts"
3992
4364
  }
3993
4365
  }
3994
4366
  ],
4367
+ "mixins": [
4368
+ {
4369
+ "name": "InlineDirectionElement",
4370
+ "module": "/src/utils/inline-direction-element"
4371
+ },
4372
+ {
4373
+ "name": "LocalizedElement",
4374
+ "module": "/src/elements/use-locale-element/use-locale-element"
4375
+ }
4376
+ ],
3995
4377
  "superclass": {
3996
4378
  "name": "UseLocaleElement",
3997
4379
  "module": "/src/elements/use-locale-element/use-locale-element"
@@ -4238,7 +4620,7 @@
4238
4620
  "declarations": [
4239
4621
  {
4240
4622
  "kind": "class",
4241
- "description": "Displays time picker using [`Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat).\n\nAllows users to pick time values with proper localization and formatting.",
4623
+ "description": "Displays time picker using [`Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat).\n\nAllows users to pick time values with proper localization and formatting.\n\nIts user-facing strings are listed under \"strings\" in the API table; override them with the\n`strings` property or the localization add-on.",
4242
4624
  "name": "UseTimeInput",
4243
4625
  "members": [
4244
4626
  {
@@ -4368,6 +4750,44 @@
4368
4750
  },
4369
4751
  "default": "\"long\"",
4370
4752
  "attribute": "format"
4753
+ },
4754
+ {
4755
+ "kind": "field",
4756
+ "name": "strings",
4757
+ "type": {
4758
+ "text": "StringOverrides | undefined"
4759
+ },
4760
+ "description": "Per-element overrides for this element's user-facing strings, keyed by string name. Values\nsupport `{placeholder}` substitution and plural objects keyed by `Intl.PluralRules` category.",
4761
+ "inheritedFrom": {
4762
+ "name": "LocalizedElement",
4763
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
4764
+ }
4765
+ },
4766
+ {
4767
+ "kind": "field",
4768
+ "name": "localeRoot",
4769
+ "type": {
4770
+ "text": "string | undefined"
4771
+ },
4772
+ "static": true,
4773
+ "description": "The tag whose translations this element uses and whose `lang` it follows when it has none of\nits own, such as `use-grid` for its rows. Defaults to the element's own tag.",
4774
+ "inheritedFrom": {
4775
+ "name": "LocalizedElement",
4776
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
4777
+ }
4778
+ },
4779
+ {
4780
+ "kind": "field",
4781
+ "name": "locale",
4782
+ "type": {
4783
+ "text": "string"
4784
+ },
4785
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
4786
+ "readonly": true,
4787
+ "inheritedFrom": {
4788
+ "name": "UseLocaleElement",
4789
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
4790
+ }
4371
4791
  }
4372
4792
  ],
4373
4793
  "events": [
@@ -4460,16 +4880,18 @@
4460
4880
  },
4461
4881
  {
4462
4882
  "name": "lang",
4463
- "type": {
4464
- "text": "string"
4465
- },
4466
- "fieldName": "lang",
4467
4883
  "inheritedFrom": {
4468
4884
  "name": "UseLocaleElement",
4469
4885
  "module": "src/elements/use-locale-element/use-locale-element.ts"
4470
4886
  }
4471
4887
  }
4472
4888
  ],
4889
+ "mixins": [
4890
+ {
4891
+ "name": "LocalizedElement",
4892
+ "module": "/src/elements/use-locale-element/use-locale-element"
4893
+ }
4894
+ ],
4473
4895
  "superclass": {
4474
4896
  "name": "UseLocaleElement",
4475
4897
  "module": "/src/elements/use-locale-element/use-locale-element"
@@ -4813,6 +5235,32 @@
4813
5235
  "text": "string"
4814
5236
  }
4815
5237
  },
5238
+ {
5239
+ "kind": "field",
5240
+ "name": "strings",
5241
+ "type": {
5242
+ "text": "StringOverrides | undefined"
5243
+ },
5244
+ "description": "Per-element overrides for this element's user-facing strings, keyed by string name. Values\nsupport `{placeholder}` substitution and plural objects keyed by `Intl.PluralRules` category.",
5245
+ "inheritedFrom": {
5246
+ "name": "LocalizedElement",
5247
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
5248
+ }
5249
+ },
5250
+ {
5251
+ "kind": "field",
5252
+ "name": "localeRoot",
5253
+ "type": {
5254
+ "text": "string | undefined"
5255
+ },
5256
+ "static": true,
5257
+ "description": "The tag whose translations this element uses and whose `lang` it follows when it has none of\nits own, such as `use-grid` for its rows. Defaults to the element's own tag.",
5258
+ "default": "\"use-calendar\"",
5259
+ "inheritedFrom": {
5260
+ "name": "LocalizedElement",
5261
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
5262
+ }
5263
+ },
4816
5264
  {
4817
5265
  "kind": "field",
4818
5266
  "name": "year",
@@ -5019,6 +5467,19 @@
5019
5467
  "name": "UseCalendarBase",
5020
5468
  "module": "src/elements/use-calendar-base/use-calendar-base.ts"
5021
5469
  }
5470
+ },
5471
+ {
5472
+ "kind": "field",
5473
+ "name": "locale",
5474
+ "type": {
5475
+ "text": "string"
5476
+ },
5477
+ "description": "The locale this element renders in: its own `lang`, then its locale root's, then `<html lang>`, then\nthe browser's language.",
5478
+ "readonly": true,
5479
+ "inheritedFrom": {
5480
+ "name": "UseLocaleElement",
5481
+ "module": "src/elements/use-locale-element/use-locale-element.ts"
5482
+ }
5022
5483
  }
5023
5484
  ],
5024
5485
  "events": [
@@ -5159,6 +5620,14 @@
5159
5620
  "module": "src/elements/use-calendar-base/use-calendar-base.ts"
5160
5621
  }
5161
5622
  },
5623
+ {
5624
+ "description": "Arrow glyph inside the previous and next buttons, mirrored in right-to-left layouts",
5625
+ "name": "control-icon",
5626
+ "inheritedFrom": {
5627
+ "name": "UseCalendarBase",
5628
+ "module": "src/elements/use-calendar-base/use-calendar-base.ts"
5629
+ }
5630
+ },
5162
5631
  {
5163
5632
  "description": "The main calendar grid",
5164
5633
  "name": "grid",
@@ -5429,10 +5898,6 @@
5429
5898
  },
5430
5899
  {
5431
5900
  "name": "lang",
5432
- "type": {
5433
- "text": "string"
5434
- },
5435
- "fieldName": "lang",
5436
5901
  "inheritedFrom": {
5437
5902
  "name": "UseLocaleElement",
5438
5903
  "module": "src/elements/use-locale-element/use-locale-element.ts"