npm - @lostgradient/cinder - Versions diffs - 0.2.0 → 0.3.0 - Mend

@lostgradient/cinder 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2480) hide show

package/src/components/phone-input/README.md CHANGED Viewed

@@ -17,24 +17,24 @@ International phone-number input pairing a country-code dropdown with an as-you-
 <!-- generated:props:start -->
-| Prop              | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Required | Default | Description                                                                                                                |
-| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `aria-label`      | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Group accessible name when no visible `label` is supplied.                                                                 |
-| `aria-labelledby` | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Space-separated list of ids that label the group when no `label` is supplied.                                              |
-| `class`           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Extra class names appended to the root element.                                                                            |
-| `countries`       | (`"AC"` \| `"AD"` \| `"AE"` \| `"AF"` \| `"AG"` \| `"AI"` \| `"AL"` \| `"AM"` \| `"AO"` \| `"AR"` \| `"AS"` \| `"AT"` \| `"AU"` \| `"AW"` \| `"AX"` \| `"AZ"` \| `"BA"` \| `"BB"` \| `"BD"` \| `"BE"` \| `"BF"` \| `"BG"` \| `"BH"` \| `"BI"` \| `"BJ"` \| `"BL"` \| `"BM"` \| `"BN"` \| `"BO"` \| `"BQ"` \| `"BR"` \| `"BS"` \| `"BT"` \| `"BW"` \| `"BY"` \| `"BZ"` \| `"CA"` \| `"CC"` \| `"CD"` \| `"CF"` \| `"CG"` \| `"CH"` \| `"CI"` \| `"CK"` \| `"CL"` \| `"CM"` \| `"CN"` \| `"CO"` \| `"CR"` \| `"CU"` \| `"CV"` \| `"CW"` \| `"CX"` \| `"CY"` \| `"CZ"` \| `"DE"` \| `"DJ"` \| `"DK"` \| `"DM"` \| `"DO"` \| `"DZ"` \| `"EC"` \| `"EE"` \| `"EG"` \| `"EH"` \| `"ER"` \| `"ES"` \| `"ET"` \| `"FI"` \| `"FJ"` \| `"FK"` \| `"FM"` \| `"FO"` \| `"FR"` \| `"GA"` \| `"GB"` \| `"GD"` \| `"GE"` \| `"GF"` \| `"GG"` \| `"GH"` \| `"GI"` \| `"GL"` \| `"GM"` \| `"GN"` \| `"GP"` \| `"GQ"` \| `"GR"` \| `"GT"` \| `"GU"` \| `"GW"` \| `"GY"` \| `"HK"` \| `"HN"` \| `"HR"` \| `"HT"` \| `"HU"` \| `"ID"` \| `"IE"` \| `"IL"` \| `"IM"` \| `"IN"` \| `"IO"` \| `"IQ"` \| `"IR"` \| `"IS"` \| `"IT"` \| `"JE"` \| `"JM"` \| `"JO"` \| `"JP"` \| `"KE"` \| `"KG"` \| `"KH"` \| `"KI"` \| `"KM"` \| `"KN"` \| `"KP"` \| `"KR"` \| `"KW"` \| `"KY"` \| `"KZ"` \| `"LA"` \| `"LB"` \| `"LC"` \| `"LI"` \| `"LK"` \| `"LR"` \| `"LS"` \| `"LT"` \| `"LU"` \| `"LV"` \| `"LY"` \| `"MA"` \| `"MC"` \| `"MD"` \| `"ME"` \| `"MF"` \| `"MG"` \| `"MH"` \| `"MK"` \| `"ML"` \| `"MM"` \| `"MN"` \| `"MO"` \| `"MP"` \| `"MQ"` \| `"MR"` \| `"MS"` \| `"MT"` \| `"MU"` \| `"MV"` \| `"MW"` \| `"MX"` \| `"MY"` \| `"MZ"` \| `"NA"` \| `"NC"` \| `"NE"` \| `"NF"` \| `"NG"` \| `"NI"` \| `"NL"` \| `"NO"` \| `"NP"` \| `"NR"` \| `"NU"` \| `"NZ"` \| `"OM"` \| `"PA"` \| `"PE"` \| `"PF"` \| `"PG"` \| `"PH"` \| `"PK"` \| `"PL"` \| `"PM"` \| `"PR"` \| `"PS"` \| `"PT"` \| `"PW"` \| `"PY"` \| `"QA"` \| `"RE"` \| `"RO"` \| `"RS"` \| `"RU"` \| `"RW"` \| `"SA"` \| `"SB"` \| `"SC"` \| `"SD"` \| `"SE"` \| `"SG"` \| `"SH"` \| `"SI"` \| `"SJ"` \| `"SK"` \| `"SL"` \| `"SM"` \| `"SN"` \| `"SO"` \| `"SR"` \| `"SS"` \| `"ST"` \| `"SV"` \| `"SX"` \| `"SY"` \| `"SZ"` \| `"TA"` \| `"TC"` \| `"TD"` \| `"TG"` \| `"TH"` \| `"TJ"` \| `"TK"` \| `"TL"` \| `"TM"` \| `"TN"` \| `"TO"` \| `"TR"` \| `"TT"` \| `"TV"` \| `"TW"` \| `"TZ"` \| `"UA"` \| `"UG"` \| `"US"` \| `"UY"` \| `"UZ"` \| `"VA"` \| `"VC"` \| `"VE"` \| `"VG"` \| `"VI"` \| `"VN"` \| `"VU"` \| `"WF"` \| `"WS"` \| `"XK"` \| `"YE"` \| `"YT"` \| `"ZA"` \| `"ZM"` \| `"ZW"`)[] | no       | —       | Optional allow-list constraining which countries appear in the dropdown.                                                   |
-| `country`         | `"AC"` \| `"AD"` \| `"AE"` \| `"AF"` \| `"AG"` \| `"AI"` \| `"AL"` \| `"AM"` \| `"AO"` \| `"AR"` \| `"AS"` \| `"AT"` \| `"AU"` \| `"AW"` \| `"AX"` \| `"AZ"` \| `"BA"` \| `"BB"` \| `"BD"` \| `"BE"` \| `"BF"` \| `"BG"` \| `"BH"` \| `"BI"` \| `"BJ"` \| `"BL"` \| `"BM"` \| `"BN"` \| `"BO"` \| `"BQ"` \| `"BR"` \| `"BS"` \| `"BT"` \| `"BW"` \| `"BY"` \| `"BZ"` \| `"CA"` \| `"CC"` \| `"CD"` \| `"CF"` \| `"CG"` \| `"CH"` \| `"CI"` \| `"CK"` \| `"CL"` \| `"CM"` \| `"CN"` \| `"CO"` \| `"CR"` \| `"CU"` \| `"CV"` \| `"CW"` \| `"CX"` \| `"CY"` \| `"CZ"` \| `"DE"` \| `"DJ"` \| `"DK"` \| `"DM"` \| `"DO"` \| `"DZ"` \| `"EC"` \| `"EE"` \| `"EG"` \| `"EH"` \| `"ER"` \| `"ES"` \| `"ET"` \| `"FI"` \| `"FJ"` \| `"FK"` \| `"FM"` \| `"FO"` \| `"FR"` \| `"GA"` \| `"GB"` \| `"GD"` \| `"GE"` \| `"GF"` \| `"GG"` \| `"GH"` \| `"GI"` \| `"GL"` \| `"GM"` \| `"GN"` \| `"GP"` \| `"GQ"` \| `"GR"` \| `"GT"` \| `"GU"` \| `"GW"` \| `"GY"` \| `"HK"` \| `"HN"` \| `"HR"` \| `"HT"` \| `"HU"` \| `"ID"` \| `"IE"` \| `"IL"` \| `"IM"` \| `"IN"` \| `"IO"` \| `"IQ"` \| `"IR"` \| `"IS"` \| `"IT"` \| `"JE"` \| `"JM"` \| `"JO"` \| `"JP"` \| `"KE"` \| `"KG"` \| `"KH"` \| `"KI"` \| `"KM"` \| `"KN"` \| `"KP"` \| `"KR"` \| `"KW"` \| `"KY"` \| `"KZ"` \| `"LA"` \| `"LB"` \| `"LC"` \| `"LI"` \| `"LK"` \| `"LR"` \| `"LS"` \| `"LT"` \| `"LU"` \| `"LV"` \| `"LY"` \| `"MA"` \| `"MC"` \| `"MD"` \| `"ME"` \| `"MF"` \| `"MG"` \| `"MH"` \| `"MK"` \| `"ML"` \| `"MM"` \| `"MN"` \| `"MO"` \| `"MP"` \| `"MQ"` \| `"MR"` \| `"MS"` \| `"MT"` \| `"MU"` \| `"MV"` \| `"MW"` \| `"MX"` \| `"MY"` \| `"MZ"` \| `"NA"` \| `"NC"` \| `"NE"` \| `"NF"` \| `"NG"` \| `"NI"` \| `"NL"` \| `"NO"` \| `"NP"` \| `"NR"` \| `"NU"` \| `"NZ"` \| `"OM"` \| `"PA"` \| `"PE"` \| `"PF"` \| `"PG"` \| `"PH"` \| `"PK"` \| `"PL"` \| `"PM"` \| `"PR"` \| `"PS"` \| `"PT"` \| `"PW"` \| `"PY"` \| `"QA"` \| `"RE"` \| `"RO"` \| `"RS"` \| `"RU"` \| `"RW"` \| `"SA"` \| `"SB"` \| `"SC"` \| `"SD"` \| `"SE"` \| `"SG"` \| `"SH"` \| `"SI"` \| `"SJ"` \| `"SK"` \| `"SL"` \| `"SM"` \| `"SN"` \| `"SO"` \| `"SR"` \| `"SS"` \| `"ST"` \| `"SV"` \| `"SX"` \| `"SY"` \| `"SZ"` \| `"TA"` \| `"TC"` \| `"TD"` \| `"TG"` \| `"TH"` \| `"TJ"` \| `"TK"` \| `"TL"` \| `"TM"` \| `"TN"` \| `"TO"` \| `"TR"` \| `"TT"` \| `"TV"` \| `"TW"` \| `"TZ"` \| `"UA"` \| `"UG"` \| `"US"` \| `"UY"` \| `"UZ"` \| `"VA"` \| `"VC"` \| `"VE"` \| `"VG"` \| `"VI"` \| `"VN"` \| `"VU"` \| `"WF"` \| `"WS"` \| `"XK"` \| `"YE"` \| `"YT"` \| `"ZA"` \| `"ZM"` \| `"ZW"`     | no       | —       | Bindable selected country. Defaults to `'US'`.                                                                             |
-| `description`     | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Optional description text rendered below the controls.                                                                     |
-| `disabled`        | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | no       | —       | Disable every control and the hidden input.                                                                                |
-| `error`           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Optional error message; sets `aria-invalid="true"` on the inputs.                                                          |
-| `hideLabel`       | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | no       | —       | Visually hide the rendered `label` while keeping it programmatically associated.                                           |
-| `id`              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | yes      | —       | Stable id used as the national input id and as the id-prefix for the dropdown.                                             |
-| `label`           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Visible group label rendered above the controls.                                                                           |
-| `locale`          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | BCP-47 locale used to resolve `Intl.DisplayNames`. Defaults to `navigator.language` after mount and `'en-US'` during SSR.  |
-| `name`            | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Form-control name applied to the hidden `<input>` that submits with the form.                                              |
-| `required`        | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | no       | —       | Mark the group as required for assistive technology.                                                                       |
-| `value`           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Bindable E.164 value. Defaults to an empty string.                                                                         |
-| `onchange`        | `(opaque)`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
+| Prop              | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Required | Default | Description                                                                                                                                                                                                                                                                                                     |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `aria-label`      | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Group accessible name when no visible `label` is supplied.                                                                                                                                                                                                                                                      |
+| `aria-labelledby` | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Space-separated list of ids that label the group when no `label` is supplied.                                                                                                                                                                                                                                   |
+| `class`           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Extra class names appended to the root element.                                                                                                                                                                                                                                                                 |
+| `countries`       | (`"AC"` \| `"AD"` \| `"AE"` \| `"AF"` \| `"AG"` \| `"AI"` \| `"AL"` \| `"AM"` \| `"AO"` \| `"AR"` \| `"AS"` \| `"AT"` \| `"AU"` \| `"AW"` \| `"AX"` \| `"AZ"` \| `"BA"` \| `"BB"` \| `"BD"` \| `"BE"` \| `"BF"` \| `"BG"` \| `"BH"` \| `"BI"` \| `"BJ"` \| `"BL"` \| `"BM"` \| `"BN"` \| `"BO"` \| `"BQ"` \| `"BR"` \| `"BS"` \| `"BT"` \| `"BW"` \| `"BY"` \| `"BZ"` \| `"CA"` \| `"CC"` \| `"CD"` \| `"CF"` \| `"CG"` \| `"CH"` \| `"CI"` \| `"CK"` \| `"CL"` \| `"CM"` \| `"CN"` \| `"CO"` \| `"CR"` \| `"CU"` \| `"CV"` \| `"CW"` \| `"CX"` \| `"CY"` \| `"CZ"` \| `"DE"` \| `"DJ"` \| `"DK"` \| `"DM"` \| `"DO"` \| `"DZ"` \| `"EC"` \| `"EE"` \| `"EG"` \| `"EH"` \| `"ER"` \| `"ES"` \| `"ET"` \| `"FI"` \| `"FJ"` \| `"FK"` \| `"FM"` \| `"FO"` \| `"FR"` \| `"GA"` \| `"GB"` \| `"GD"` \| `"GE"` \| `"GF"` \| `"GG"` \| `"GH"` \| `"GI"` \| `"GL"` \| `"GM"` \| `"GN"` \| `"GP"` \| `"GQ"` \| `"GR"` \| `"GT"` \| `"GU"` \| `"GW"` \| `"GY"` \| `"HK"` \| `"HN"` \| `"HR"` \| `"HT"` \| `"HU"` \| `"ID"` \| `"IE"` \| `"IL"` \| `"IM"` \| `"IN"` \| `"IO"` \| `"IQ"` \| `"IR"` \| `"IS"` \| `"IT"` \| `"JE"` \| `"JM"` \| `"JO"` \| `"JP"` \| `"KE"` \| `"KG"` \| `"KH"` \| `"KI"` \| `"KM"` \| `"KN"` \| `"KP"` \| `"KR"` \| `"KW"` \| `"KY"` \| `"KZ"` \| `"LA"` \| `"LB"` \| `"LC"` \| `"LI"` \| `"LK"` \| `"LR"` \| `"LS"` \| `"LT"` \| `"LU"` \| `"LV"` \| `"LY"` \| `"MA"` \| `"MC"` \| `"MD"` \| `"ME"` \| `"MF"` \| `"MG"` \| `"MH"` \| `"MK"` \| `"ML"` \| `"MM"` \| `"MN"` \| `"MO"` \| `"MP"` \| `"MQ"` \| `"MR"` \| `"MS"` \| `"MT"` \| `"MU"` \| `"MV"` \| `"MW"` \| `"MX"` \| `"MY"` \| `"MZ"` \| `"NA"` \| `"NC"` \| `"NE"` \| `"NF"` \| `"NG"` \| `"NI"` \| `"NL"` \| `"NO"` \| `"NP"` \| `"NR"` \| `"NU"` \| `"NZ"` \| `"OM"` \| `"PA"` \| `"PE"` \| `"PF"` \| `"PG"` \| `"PH"` \| `"PK"` \| `"PL"` \| `"PM"` \| `"PR"` \| `"PS"` \| `"PT"` \| `"PW"` \| `"PY"` \| `"QA"` \| `"RE"` \| `"RO"` \| `"RS"` \| `"RU"` \| `"RW"` \| `"SA"` \| `"SB"` \| `"SC"` \| `"SD"` \| `"SE"` \| `"SG"` \| `"SH"` \| `"SI"` \| `"SJ"` \| `"SK"` \| `"SL"` \| `"SM"` \| `"SN"` \| `"SO"` \| `"SR"` \| `"SS"` \| `"ST"` \| `"SV"` \| `"SX"` \| `"SY"` \| `"SZ"` \| `"TA"` \| `"TC"` \| `"TD"` \| `"TG"` \| `"TH"` \| `"TJ"` \| `"TK"` \| `"TL"` \| `"TM"` \| `"TN"` \| `"TO"` \| `"TR"` \| `"TT"` \| `"TV"` \| `"TW"` \| `"TZ"` \| `"UA"` \| `"UG"` \| `"US"` \| `"UY"` \| `"UZ"` \| `"VA"` \| `"VC"` \| `"VE"` \| `"VG"` \| `"VI"` \| `"VN"` \| `"VU"` \| `"WF"` \| `"WS"` \| `"XK"` \| `"YE"` \| `"YT"` \| `"ZA"` \| `"ZM"` \| `"ZW"`)[] | no       | —       | Optional allow-list constraining which countries appear in the dropdown.                                                                                                                                                                                                                                        |
+| `country`         | `"AC"` \| `"AD"` \| `"AE"` \| `"AF"` \| `"AG"` \| `"AI"` \| `"AL"` \| `"AM"` \| `"AO"` \| `"AR"` \| `"AS"` \| `"AT"` \| `"AU"` \| `"AW"` \| `"AX"` \| `"AZ"` \| `"BA"` \| `"BB"` \| `"BD"` \| `"BE"` \| `"BF"` \| `"BG"` \| `"BH"` \| `"BI"` \| `"BJ"` \| `"BL"` \| `"BM"` \| `"BN"` \| `"BO"` \| `"BQ"` \| `"BR"` \| `"BS"` \| `"BT"` \| `"BW"` \| `"BY"` \| `"BZ"` \| `"CA"` \| `"CC"` \| `"CD"` \| `"CF"` \| `"CG"` \| `"CH"` \| `"CI"` \| `"CK"` \| `"CL"` \| `"CM"` \| `"CN"` \| `"CO"` \| `"CR"` \| `"CU"` \| `"CV"` \| `"CW"` \| `"CX"` \| `"CY"` \| `"CZ"` \| `"DE"` \| `"DJ"` \| `"DK"` \| `"DM"` \| `"DO"` \| `"DZ"` \| `"EC"` \| `"EE"` \| `"EG"` \| `"EH"` \| `"ER"` \| `"ES"` \| `"ET"` \| `"FI"` \| `"FJ"` \| `"FK"` \| `"FM"` \| `"FO"` \| `"FR"` \| `"GA"` \| `"GB"` \| `"GD"` \| `"GE"` \| `"GF"` \| `"GG"` \| `"GH"` \| `"GI"` \| `"GL"` \| `"GM"` \| `"GN"` \| `"GP"` \| `"GQ"` \| `"GR"` \| `"GT"` \| `"GU"` \| `"GW"` \| `"GY"` \| `"HK"` \| `"HN"` \| `"HR"` \| `"HT"` \| `"HU"` \| `"ID"` \| `"IE"` \| `"IL"` \| `"IM"` \| `"IN"` \| `"IO"` \| `"IQ"` \| `"IR"` \| `"IS"` \| `"IT"` \| `"JE"` \| `"JM"` \| `"JO"` \| `"JP"` \| `"KE"` \| `"KG"` \| `"KH"` \| `"KI"` \| `"KM"` \| `"KN"` \| `"KP"` \| `"KR"` \| `"KW"` \| `"KY"` \| `"KZ"` \| `"LA"` \| `"LB"` \| `"LC"` \| `"LI"` \| `"LK"` \| `"LR"` \| `"LS"` \| `"LT"` \| `"LU"` \| `"LV"` \| `"LY"` \| `"MA"` \| `"MC"` \| `"MD"` \| `"ME"` \| `"MF"` \| `"MG"` \| `"MH"` \| `"MK"` \| `"ML"` \| `"MM"` \| `"MN"` \| `"MO"` \| `"MP"` \| `"MQ"` \| `"MR"` \| `"MS"` \| `"MT"` \| `"MU"` \| `"MV"` \| `"MW"` \| `"MX"` \| `"MY"` \| `"MZ"` \| `"NA"` \| `"NC"` \| `"NE"` \| `"NF"` \| `"NG"` \| `"NI"` \| `"NL"` \| `"NO"` \| `"NP"` \| `"NR"` \| `"NU"` \| `"NZ"` \| `"OM"` \| `"PA"` \| `"PE"` \| `"PF"` \| `"PG"` \| `"PH"` \| `"PK"` \| `"PL"` \| `"PM"` \| `"PR"` \| `"PS"` \| `"PT"` \| `"PW"` \| `"PY"` \| `"QA"` \| `"RE"` \| `"RO"` \| `"RS"` \| `"RU"` \| `"RW"` \| `"SA"` \| `"SB"` \| `"SC"` \| `"SD"` \| `"SE"` \| `"SG"` \| `"SH"` \| `"SI"` \| `"SJ"` \| `"SK"` \| `"SL"` \| `"SM"` \| `"SN"` \| `"SO"` \| `"SR"` \| `"SS"` \| `"ST"` \| `"SV"` \| `"SX"` \| `"SY"` \| `"SZ"` \| `"TA"` \| `"TC"` \| `"TD"` \| `"TG"` \| `"TH"` \| `"TJ"` \| `"TK"` \| `"TL"` \| `"TM"` \| `"TN"` \| `"TO"` \| `"TR"` \| `"TT"` \| `"TV"` \| `"TW"` \| `"TZ"` \| `"UA"` \| `"UG"` \| `"US"` \| `"UY"` \| `"UZ"` \| `"VA"` \| `"VC"` \| `"VE"` \| `"VG"` \| `"VI"` \| `"VN"` \| `"VU"` \| `"WF"` \| `"WS"` \| `"XK"` \| `"YE"` \| `"YT"` \| `"ZA"` \| `"ZM"` \| `"ZW"`     | no       | —       | Bindable selected country. Defaults to `'US'`.                                                                                                                                                                                                                                                                  |
+| `description`     | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Optional description text rendered below the controls.                                                                                                                                                                                                                                                          |
+| `disabled`        | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | no       | —       | Disable every control and the hidden input.                                                                                                                                                                                                                                                                     |
+| `error`           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Optional error message; sets `aria-invalid="true"` on the inputs.                                                                                                                                                                                                                                               |
+| `hideLabel`       | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | no       | —       | Visually hide the rendered `label` while keeping it programmatically associated.                                                                                                                                                                                                                                |
+| `id`              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | yes      | —       | Stable id used as the national input id and as the id-prefix for the dropdown.                                                                                                                                                                                                                                  |
+| `label`           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Visible group label rendered above the controls.                                                                                                                                                                                                                                                                |
+| `locale`          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | BCP-47 locale used to resolve `Intl.DisplayNames`. Defaults to `navigator.language` after mount and `'en-US'` during SSR.                                                                                                                                                                                       |
+| `name`            | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Form-control name applied to the hidden `<input>` that submits with the form.                                                                                                                                                                                                                                   |
+| `required`        | `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | no       | —       | Mark the group as required for assistive technology.                                                                                                                                                                                                                                                            |
+| `value`           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | no       | —       | Bindable E.164 value. Defaults to an empty string.                                                                                                                                                                                                                                                              |
+| `onchange`        | `(opaque)`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | no       | —       | Fires only for user-initiated committed value changes (editing the national number, switching the country). Never fires for external value or country synchronization. The detail object carries the E.164 string on `detail.value`. Not expressible in JSON Schema; see the component types for the signature. |
 <!-- generated:props:end -->

package/src/components/phone-input/phone-input.examples.json CHANGED Viewed

@@ -7,7 +7,7 @@
       "id": "basic",
       "title": "Basic phone input",
       "description": "Country selector plus national number with E.164 emission.",
-      "code": "<script lang=\"ts\">\n  import { PhoneInput } from '@lostgradient/cinder/phone-input';\n  let phone = $state('');\n</script>\n\n<PhoneInput id=\"basic-phone\" bind:value={phone} label=\"Phone number\" />\n\n{#if phone}\n  <p style=\"margin-top: 0.75rem; color: var(--cinder-text-muted);\">E.164: {phone}</p>\n{/if}\n"
+      "code": "<script lang=\"ts\">\n  import { PhoneInput } from '@lostgradient/cinder/phone-input';\n\n  let phone = $state('');\n</script>\n\n<PhoneInput id=\"field\" bind:value={phone} label=\"Phone number\" />\n\n{#if phone}\n  <p style=\"margin-top: 0.75rem; color: var(--cinder-text-muted);\">E.164: {phone}</p>\n{/if}\n"
     },
     {
       "id": "country-switching",

package/src/components/pin-input/README.md CHANGED Viewed

@@ -17,25 +17,25 @@ Segmented one-time-code input with auto-advance, paste distribution, and optiona
 <!-- generated:props:start -->
-| Prop              | Type                            | Required | Default | Description                                                                                                                |
-| ----------------- | ------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `aria-label`      | `string`                        | no       | —       | Group accessible name when no visible `label` is supplied.                                                                 |
-| `aria-labelledby` | `string`                        | no       | —       | Space-separated list of ids that label the group when no `label` is supplied.                                              |
-| `class`           | `string`                        | no       | —       | Extra class names appended to the root group element.                                                                      |
-| `description`     | `string`                        | no       | —       | Optional description text rendered below the segments.                                                                     |
-| `disabled`        | `boolean`                       | no       | —       | Disable every segment and the hidden input.                                                                                |
-| `error`           | `string`                        | no       | —       | Optional error message; sets `aria-invalid="true"` on every segment.                                                       |
-| `hideLabel`       | `boolean`                       | no       | —       | Visually hide the rendered `label` while keeping it programmatically associated.                                           |
-| `id`              | `string`                        | yes      | —       | Stable id used as the segment id prefix and as the hidden input id.                                                        |
-| `label`           | `string`                        | no       | —       | Visible group label rendered above the segments.                                                                           |
-| `length`          | `number`                        | no       | —       | Number of segments to render. Normalized to an integer in `[1, 12]`; non-finite or out-of-range values fall back to `6`.   |
-| `masked`          | `boolean`                       | no       | —       | Render segments as password-style fields without changing the emitted value.                                               |
-| `mode`            | `"numeric"` \| `"alphanumeric"` | no       | —       | Character set accepted in each segment. Defaults to `'numeric'`.                                                           |
-| `name`            | `string`                        | no       | —       | Form-control name applied to the hidden `<input>` that submits with the form.                                              |
-| `required`        | `boolean`                       | no       | —       | Mark the group as required for assistive technology.                                                                       |
-| `value`           | `string`                        | no       | —       | Bindable code value. Defaults to an empty string.                                                                          |
-| `autocomplete`    | `(opaque)`                      | no       | —       | A prop whose shape is not captured by the JSON schema; see the component types for the exact signature.                    |
-| `onchange`        | `(opaque)`                      | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
+| Prop              | Type                            | Required | Default | Description                                                                                                                                                                                                           |
+| ----------------- | ------------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `aria-label`      | `string`                        | no       | —       | Group accessible name when no visible `label` is supplied.                                                                                                                                                            |
+| `aria-labelledby` | `string`                        | no       | —       | Space-separated list of ids that label the group when no `label` is supplied.                                                                                                                                         |
+| `class`           | `string`                        | no       | —       | Extra class names appended to the root group element.                                                                                                                                                                 |
+| `description`     | `string`                        | no       | —       | Optional description text rendered below the segments.                                                                                                                                                                |
+| `disabled`        | `boolean`                       | no       | —       | Disable every segment and the hidden input.                                                                                                                                                                           |
+| `error`           | `string`                        | no       | —       | Optional error message; sets `aria-invalid="true"` on every segment.                                                                                                                                                  |
+| `hideLabel`       | `boolean`                       | no       | —       | Visually hide the rendered `label` while keeping it programmatically associated.                                                                                                                                      |
+| `id`              | `string`                        | yes      | —       | Stable id used as the segment id prefix and as the hidden input id.                                                                                                                                                   |
+| `label`           | `string`                        | no       | —       | Visible group label rendered above the segments.                                                                                                                                                                      |
+| `length`          | `number`                        | no       | —       | Number of segments to render. Normalized to an integer in `[1, 12]`; non-finite or out-of-range values fall back to `6`.                                                                                              |
+| `masked`          | `boolean`                       | no       | —       | Render segments as password-style fields without changing the emitted value.                                                                                                                                          |
+| `mode`            | `"numeric"` \| `"alphanumeric"` | no       | —       | Character set accepted in each segment. Defaults to `'numeric'`.                                                                                                                                                      |
+| `name`            | `string`                        | no       | —       | Form-control name applied to the hidden `<input>` that submits with the form.                                                                                                                                         |
+| `required`        | `boolean`                       | no       | —       | Mark the group as required for assistive technology.                                                                                                                                                                  |
+| `value`           | `string`                        | no       | —       | Bindable code value. Defaults to an empty string.                                                                                                                                                                     |
+| `autocomplete`    | `(opaque)`                      | no       | —       | `autocomplete` value applied to the first segment. Defaults to `'one-time-code'` so iOS and Android can autofill SMS codes. Not expressible in JSON Schema; see the component types for the signature.                |
+| `onchange`        | `(opaque)`                      | no       | —       | Fires only for user-initiated committed value changes (typing, paste, autofill, backspace). Never fires for external prop synchronization. Not expressible in JSON Schema; see the component types for the signature. |
 <!-- generated:props:end -->

package/src/components/pin-input/pin-input.examples.json CHANGED Viewed

@@ -7,7 +7,7 @@
       "id": "alphanumeric",
       "title": "Alphanumeric code",
       "description": "Eight-character alphanumeric invite code with description text.",
-      "code": "<script lang=\"ts\">\n  import { PinInput } from '@lostgradient/cinder/pin-input';\n  let invite = $state('');\n</script>\n\n<PinInput\n  id=\"invite-code\"\n  bind:value={invite}\n  length={8}\n  mode=\"alphanumeric\"\n  label=\"Invite code\"\n  description=\"Type or paste the code from your invitation email.\"\n/>\n"
+      "code": "<script lang=\"ts\">\n  import { PinInput } from '@lostgradient/cinder/pin-input';\n\n  let invite = $state('');\n</script>\n\n<PinInput\n  id=\"invite-code\"\n  bind:value={invite}\n  length={8}\n  mode=\"alphanumeric\"\n  label=\"Invite code\"\n  description=\"Type or paste the code from your invitation email.\"\n/>\n"
     },
     {
       "id": "basic",

package/src/components/popover/README.md CHANGED Viewed

@@ -23,7 +23,7 @@ Non-blocking floating panel anchored to a trigger element for contextual content
 </Popover>
 ```
-## When to use
+## Choosing this component
 Use Popover for rich, interactive contextual content anchored to a trigger — help panels, color pickers, settings cards, and similar surfaces that do not need to interrupt the user.
@@ -44,23 +44,24 @@ Use Popover for rich, interactive contextual content anchored to a trigger — h
 <!-- generated:props:start -->
-| Prop              | Type                                                                                                                 | Required | Default | Description                                                                                                                |
-| ----------------- | -------------------------------------------------------------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
-| `ariaLabelledby`  | `string`                                                                                                             | no       | —       | Id of an element labelling the panel. Wins over `label`.                                                                   |
-| `class`           | `string`                                                                                                             | no       | —       | Extra class merged onto `.cinder-popover`.                                                                                 |
-| `focusManagement` | `"panel"` \| `"preserve"`                                                                                            | no       | —       | Focus behavior for each open session. Default `'panel'`.                                                                   |
-| `id`              | `string`                                                                                                             | no       | —       | Optional panel id. Defaults to a generated `cinder-popover-*` id.                                                          |
-| `label`           | `string`                                                                                                             | no       | —       | Accessible name. Sets `aria-label` when `ariaLabelledby` is not supplied.                                                  |
-| `offset`          | `number`                                                                                                             | no       | —       | Distance in px between trigger and panel. Default `8`.                                                                     |
-| `open`            | `boolean`                                                                                                            | no       | —       | Open state. Bindable. Default `false`.                                                                                     |
-| `placement`       | `"top"` \| `"bottom"` \| `"left"` \| `"right"` \| `"top-start"` \| `"top-end"` \| `"bottom-start"` \| `"bottom-end"` | no       | —       | Anchor placement. Default `'bottom-start'`.                                                                                |
-| `role`            | `"dialog"` \| `"group"` \| `"listbox"`                                                                               | no       | —       | ARIA role for the panel. Default `'dialog'`.                                                                               |
-| `showArrow`       | `boolean`                                                                                                            | no       | —       | Render a directional arrow on the panel. Default `false`.                                                                  |
-| `widthMode`       | `"content"` \| `"match-anchor"` \| `"menu"` \| `"none"`                                                              | no       | —       | Floating panel width strategy. Default `'content'`.                                                                        |
-| `wireTriggerAria` | `boolean`                                                                                                            | no       | —       | Whether Popover owns trigger ARIA wiring. Default `true`.                                                                  |
-| `children`        | `(opaque)`                                                                                                           | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `trigger`         | `(opaque)`                                                                                                           | no       | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature. |
-| `triggerRef`      | `(opaque)`                                                                                                           | no       | —       | A prop whose shape is not captured by the JSON schema; see the component types for the exact signature.                    |
+| Prop              | Type                                                                                                                 | Required | Default | Description                                                                                                                                                                                                                       |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ariaLabelledby`  | `string`                                                                                                             | no       | —       | Id of an element labelling the panel. Wins over `label`.                                                                                                                                                                          |
+| `class`           | `string`                                                                                                             | no       | —       | Extra class merged onto `.cinder-popover`.                                                                                                                                                                                        |
+| `closeOnEscape`   | `boolean`                                                                                                            | no       | —       | Whether Escape closes the Popover. Default `true`. Set `false` when a parent composite widget (e.g. Combobox) owns Escape for the whole interaction, so the Popover does not shadow the parent's handler while its panel is open. |
+| `focusManagement` | `"panel"` \| `"preserve"`                                                                                            | no       | —       | Focus behavior for each open session. Default `'panel'`.                                                                                                                                                                          |
+| `id`              | `string`                                                                                                             | no       | —       | Optional panel id. Defaults to a generated `cinder-popover-*` id.                                                                                                                                                                 |
+| `label`           | `string`                                                                                                             | no       | —       | Accessible name. Sets `aria-label` when `ariaLabelledby` is not supplied.                                                                                                                                                         |
+| `offset`          | `number`                                                                                                             | no       | —       | Distance in px between trigger and panel. Default `8`.                                                                                                                                                                            |
+| `open`            | `boolean`                                                                                                            | no       | —       | Open state. Bindable. Default `false`.                                                                                                                                                                                            |
+| `placement`       | `"top"` \| `"bottom"` \| `"left"` \| `"right"` \| `"top-start"` \| `"top-end"` \| `"bottom-start"` \| `"bottom-end"` | no       | —       | Anchor placement. Default `'bottom-start'`.                                                                                                                                                                                       |
+| `role`            | `"dialog"` \| `"group"` \| `"listbox"`                                                                               | no       | —       | ARIA role for the panel. Default `'dialog'`.                                                                                                                                                                                      |
+| `showArrow`       | `boolean`                                                                                                            | no       | —       | Render a directional arrow on the panel. Default `false`.                                                                                                                                                                         |
+| `widthMode`       | `"content"` \| `"match-anchor"` \| `"menu"` \| `"none"`                                                              | no       | —       | Floating panel width strategy. Default `'content'`.                                                                                                                                                                               |
+| `wireTriggerAria` | `boolean`                                                                                                            | no       | —       | Whether Popover owns trigger ARIA wiring. Default `true`.                                                                                                                                                                         |
+| `children`        | `(opaque)`                                                                                                           | yes      | —       | Panel content. Required. Not expressible in JSON Schema; see the component types for the signature.                                                                                                                               |
+| `trigger`         | `(opaque)`                                                                                                           | no       | —       | Optional trigger snippet rendered inside a wrapper. Not expressible in JSON Schema; see the component types for the signature.                                                                                                    |
+| `triggerRef`      | `(opaque)`                                                                                                           | no       | —       | Explicit anchor element. Wins over the snippet-resolved focusable. Not expressible in JSON Schema; see the component types for the signature.                                                                                     |
 <!-- generated:props:end -->

package/src/components/popover/popover.svelte CHANGED Viewed

@@ -47,6 +47,7 @@
     role = 'dialog',
     focusManagement = 'panel',
     wireTriggerAria = true,
+    closeOnEscape = true,
     widthMode = 'content',
     class: className,
   }: PopoverProps = $props();
@@ -160,9 +161,15 @@
     // open don't retrigger this effect; positioning rebind is the positioning
     // effect's responsibility.
     resolvedAnchorAtOpen = untrack(() => anchorElement);
-    const releaseEscape = pushEscapeHandler(() => {
-      open = false;
-    });
+    // Skip the Escape registration entirely when a parent owns Escape (e.g.
+    // Combobox passes closeOnEscape={false}); registering here would put the
+    // Popover on top of the shared stack and shadow the parent's handler while
+    // options are visible.
+    const releaseEscape = closeOnEscape
+      ? pushEscapeHandler(() => {
+          open = false;
+        })
+      : () => {};
     return () => {
       releaseEscape();

package/src/components/popover/popover.types.ts CHANGED Viewed

@@ -47,6 +47,12 @@ export type PopoverProps = {
   focusManagement?: PopoverFocusManagement;
   /** Whether Popover owns trigger ARIA wiring. Default `true`. */
   wireTriggerAria?: boolean;
+  /**
+   * Whether Escape closes the Popover. Default `true`. Set `false` when a parent
+   * composite widget (e.g. Combobox) owns Escape for the whole interaction, so the
+   * Popover does not shadow the parent's handler while its panel is open.
+   */
+  closeOnEscape?: boolean;
   /** Floating panel width strategy. Default `'content'`. */
   widthMode?: PopoverWidthMode;
   /** Extra class merged onto `.cinder-popover`. */

package/src/components/portal/README.md CHANGED Viewed

@@ -18,12 +18,13 @@ Moves content into `document.body` or another host element while keeping inline
 <!-- generated:props:start -->
-| Prop                | Type               | Required | Default | Description |
-| ------------------- | ------------------ | -------- | ------- | ----------- |
-| `class`             | `string`           | no       | —       |             |
-| `disabled`          | `boolean`          | no       | —       |             |
-| `inheritAttributes` | `boolean`          | no       | —       |             |
-| `target`            | `string` \| `null` | no       | —       |             |
+| Prop                | Type               | Required | Default | Description                                                                                                                        |
+| ------------------- | ------------------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `class`             | `string`           | no       | —       | Additional class applied to the portal wrapper element.                                                                            |
+| `disabled`          | `boolean`          | no       | —       | When true, renders the content inline in normal document flow instead of teleporting it to the target.                             |
+| `inheritAttributes` | `boolean`          | no       | —       | When true (default), HTML attributes passed to the portal are forwarded onto the wrapper element inside the target.                |
+| `target`            | `string` \| `null` | no       | —       | CSS selector string or `null` specifying where the portal content is appended. Defaults to `document.body` when `null` or omitted. |
+| `children`          | `(opaque)`         | yes      | —       | A function or snippet prop. Its shape is not captured by the JSON schema; see the component types for the exact signature.         |
 <!-- generated:props:end -->

package/src/components/portal/portal.types.ts CHANGED Viewed

@@ -12,9 +12,13 @@ export type PortalProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'cla
 };
 export interface PortalSchemaProps {
+  /** CSS selector string or `null` specifying where the portal content is appended. Defaults to `document.body` when `null` or omitted. */
   target?: string | null;
+  /** When true, renders the content inline in normal document flow instead of teleporting it to the target. */
   disabled?: boolean;
+  /** Additional class applied to the portal wrapper element. */
   class?: string;
+  /** When true (default), HTML attributes passed to the portal are forwarded onto the wrapper element inside the target. */
   inheritAttributes?: boolean;
 }

package/src/components/pricing-card/README.md CHANGED Viewed

@@ -26,15 +26,16 @@ Presents a single pricing plan with its name, price, feature list, an optional c
 <!-- generated:props:start -->
-| Prop       | Type       | Required | Default | Description                                            |
-| ---------- | ---------- | -------- | ------- | ------------------------------------------------------ |
-| `caveat`   | `string`   | no       | —       | Optional footnote or caveat beneath the features list. |
-| `class`    | `string`   | no       | —       | Custom class merged with `.cinder-pricing-card`.       |
-| `cta`      | `string`   | yes      | —       | Label for the call-to-action button.                   |
-| `features` | `string`[] | yes      | —       | Feature strings to display in the bulleted list.       |
-| `name`     | `string`   | yes      | —       | Plan name displayed as the card heading.               |
-| `price`    | `string`   | yes      | —       | Price string, e.g. "$9/mo" or "Free".                  |
-| `selected` | `boolean`  | no       | `false` | Whether this card is the currently selected plan.      |
+| Prop       | Type       | Required | Default | Description                                                                                                       |
+| ---------- | ---------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------- |
+| `caveat`   | `string`   | no       | —       | Optional footnote or caveat beneath the features list.                                                            |
+| `class`    | `string`   | no       | —       | Custom class merged with `.cinder-pricing-card`.                                                                  |
+| `cta`      | `string`   | yes      | —       | Label for the call-to-action button.                                                                              |
+| `features` | `string`[] | yes      | —       | Feature strings to display in the bulleted list.                                                                  |
+| `name`     | `string`   | yes      | —       | Plan name displayed as the card heading.                                                                          |
+| `price`    | `string`   | yes      | —       | Price string, e.g. "$9/mo" or "Free".                                                                             |
+| `selected` | `boolean`  | no       | `false` | Whether this card is the currently selected plan.                                                                 |
+| `onselect` | `(opaque)` | yes      | —       | Called when the CTA button is clicked. Not expressible in JSON Schema; see the component types for the signature. |
 <!-- generated:props:end -->

package/src/components/pricing-card/pricing-card.css CHANGED Viewed

@@ -52,15 +52,23 @@
   }
   /* Non-color cue for the selected plan (WCAG 1.4.1): a text pill in the header
-   * so selection is conveyed independently of the accent treatment. */
+   * so selection is conveyed independently of the accent treatment.
+   *
+   * This is an affirmative status badge, so it uses the solid accent fill +
+   * accent-contrast label token pair (the same contract a primary Button uses),
+   * which is guaranteed to clear WCAG AA in both color-scheme arms. The earlier
+   * accent-text-on-a-tinted-chip treatment fell to ~4.1:1 in dark mode because
+   * the chip background was a near-transparent accent wash over the dark surface.
+   * The filled badge deliberately reads stronger than the faint selected-header
+   * tint above it: ambient state in the container, explicit state in the chip. */
   .cinder-pricing-card__selected-flag {
     flex-shrink: 0;
     font-size: var(--cinder-text-xs);
     font-weight: var(--cinder-font-semibold);
     letter-spacing: 0.025em;
     text-transform: uppercase;
-    color: var(--cinder-accent-text);
-    background: color-mix(in oklch, var(--cinder-accent), transparent 85%);
+    color: var(--cinder-accent-contrast);
+    background: var(--cinder-accent);
     border-radius: var(--cinder-radius-full);
     padding: var(--cinder-space-1) var(--cinder-space-2);
     line-height: 1;