@fusion.dev/helix-docs 0.103.2 → 0.104.0

package/content/building-on-the-headless-tier.mdx

@@ -46,7 +46,7 @@ a combobox that appears not to open.
 
 [//]: # (renders)
 
-**27 of the 96 headless families interpolate another family's tag**, across 20 distinct children.
+**27 of the 97 headless families interpolate another family's tag**, across 20 distinct children.
 
 | Family | Renders |
 |---|---|

package/content/localization.mdx

@@ -85,9 +85,9 @@ to keep up to date.
 
 ## Translatable strings
 
-Seventy properties across the headless tier are strings a reader sees, and every
-one is a property rather than a hardcoded word. The ones that combine
-values are format templates:
+Over a hundred properties across the headless tier are strings a reader sees,
+from `pan-up-label` on a map to `remove-label` on a combobox's chosen tags. The
+ones that combine values are format templates:
 
 ```html
 <helix-pagination-summary
@@ -102,6 +102,22 @@ values are format templates:
 The placeholders are named rather than positional, so a translation can reorder
 them, which some languages require and a positional format cannot express.
 
+**Validation messages are properties too**, named for the validity flag each
+one reports: `value-missing-message`, `bad-input-message`,
+`range-underflow-message`, `range-overflow-message`, `too-short-message`. They
+reach the browser's own bubble as well as the line under the field, which
+`feedback` alone does not. Left unset, a text field keeps the browser's own
+message, which is already in the reader's language, and every other control
+keeps its English sentence.
+
+```html
+<helix-number-input
+  label="Invités"
+  min="2"
+  range-underflow-message="Au moins {min}."
+></helix-number-input>
+```
+
 **Pass these from your own translation system.** Helix ships English defaults
 and no translation machinery: a design system that owned the string catalog
 would be a second one to keep in step with yours.