@fusion.dev/helix-docs 0.59.1 → 0.59.2

package/content/metrics.mdx

@@ -395,11 +395,11 @@ column is what was removed rather than part of what remains.
 | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
 |---|---|---|---|---|
 | `@fusion.dev/helix-core` | 983,274 | 153 | 222,331 | `@floating-ui/dom`, `@fusion.dev/helix-icons` |
-| `@fusion.dev/helix-headless` | 11,342,927 | 464 | 836,712 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
+| `@fusion.dev/helix-headless` | 11,353,229 | 464 | 836,734 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
 | `@fusion.dev/helix-icons` | 65,943 | 11 | 20,928 | none |
 | `@fusion.dev/helix-styles` | 101,139 | 6 | 0 | none |
 | `@fusion.dev/helix-theme` | 465,413 | 8 | 4,703 | none |
-| `@fusion.dev/helix` | 12,458,091 | 796 | 333,797 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
+| `@fusion.dev/helix` | 12,470,065 | 796 | 333,806 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
 
 ## Not measured yet
 

package/content/visual-axes.mdx

@@ -87,6 +87,29 @@ write it with nothing painted.
 and never of controls, which take their height from the region they sit in
 through `data-density`, so it lives only where something is painted.
 
+## When a family takes `neutral`
+
+`tone` is the one axis whose vocabulary the table above leaves open, and
+`neutral` is the value families have kept deciding about one at a time. Three
+have argued it at their own declarations and arrived at the same rule, so it
+belongs here once instead.
+
+**A family that reports a status takes the status words and stops.** `Callout`
+and `Toast` say it in nearly the same sentence: a callout reports a status and
+never a brand role, so it takes four of the seven. There is no neutral status,
+and a value that could not be drawn is worse than a value that cannot be named.
+
+**A family whose resting state is already untoned does not need it.** `Text`
+gives that reason against its own missing `default`: a value matching no rule
+would fall through to the inherited ink and read as working while saying
+nothing. The absent attribute is the resting case and says it better.
+
+**`neutral` is for a thing that carries a tone without reporting one**: a gray
+tag beside six colored ones, a button that is a button rather than the primary
+action. `Announcement` spells its own out rather than leaving the attribute off,
+which is what makes the tone sayable rather than only reachable, and that is the
+whole of when this value is worth taking.
+
 ## What each shape is
 
 `shape` is the axis whose values are geometries that look alike in a table and
@@ -107,6 +130,27 @@ not on a page, so it is worth saying what each one draws.
 `square` too, in the same registered axis. Membership is what a check can see,
 so nothing could have caught that, and a table is what stops it happening again.
 
+## What each separation draws
+
+`separation` says where a box ends, and `elevated` is the value nearly every
+family leaves out, so it is worth saying what each one draws and what that
+omission is about.
+
+| Value | What it draws |
+|---|---|
+| `elevated` | A surface lifted off the page, with a shadow under it |
+| `filled` | A ground of its own, and no edge |
+| `outlined` | An edge over the ground it already has |
+| `plain` | Neither, so the box ends where its content does |
+
+**Leaving `elevated` out is a fact about the value rather than about the family
+that skips it.** A shadow says the box floats above the page, which is true of a
+card picked up off a grid and of an announcement laid over the content, and
+false of a row in a feed, a groove a thumb sits in, a checkbox, or a bar across
+a video. A family taking the other three and stopping is following the value,
+not departing from the axis, and owes no argument for it. A family that *does*
+take it is the one saying something, and `Card` and `Announcement` both do.
+
 ## What a step inward means
 
 `nesting` is the one axis whose values are three readings of the same fact, so

package/dist/sources.generated.js

@@ -2359,11 +2359,11 @@ column is what was removed rather than part of what remains.
 | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
 |---|---|---|---|---|
 | \`@fusion.dev/helix-core\` | 983,274 | 153 | 222,331 | \`@floating-ui/dom\`, \`@fusion.dev/helix-icons\` |
-| \`@fusion.dev/helix-headless\` | 11,342,927 | 464 | 836,712 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
+| \`@fusion.dev/helix-headless\` | 11,353,229 | 464 | 836,734 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
 | \`@fusion.dev/helix-icons\` | 65,943 | 11 | 20,928 | none |
 | \`@fusion.dev/helix-styles\` | 101,139 | 6 | 0 | none |
 | \`@fusion.dev/helix-theme\` | 465,413 | 8 | 4,703 | none |
-| \`@fusion.dev/helix\` | 12,458,091 | 796 | 333,797 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
+| \`@fusion.dev/helix\` | 12,470,065 | 796 | 333,806 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
 
 ## Not measured yet
 
@@ -5156,6 +5156,29 @@ write it with nothing painted.
 and never of controls, which take their height from the region they sit in
 through \`data-density\`, so it lives only where something is painted.
 
+## When a family takes \`neutral\`
+
+\`tone\` is the one axis whose vocabulary the table above leaves open, and
+\`neutral\` is the value families have kept deciding about one at a time. Three
+have argued it at their own declarations and arrived at the same rule, so it
+belongs here once instead.
+
+**A family that reports a status takes the status words and stops.** \`Callout\`
+and \`Toast\` say it in nearly the same sentence: a callout reports a status and
+never a brand role, so it takes four of the seven. There is no neutral status,
+and a value that could not be drawn is worse than a value that cannot be named.
+
+**A family whose resting state is already untoned does not need it.** \`Text\`
+gives that reason against its own missing \`default\`: a value matching no rule
+would fall through to the inherited ink and read as working while saying
+nothing. The absent attribute is the resting case and says it better.
+
+**\`neutral\` is for a thing that carries a tone without reporting one**: a gray
+tag beside six colored ones, a button that is a button rather than the primary
+action. \`Announcement\` spells its own out rather than leaving the attribute off,
+which is what makes the tone sayable rather than only reachable, and that is the
+whole of when this value is worth taking.
+
 ## What each shape is
 
 \`shape\` is the axis whose values are geometries that look alike in a table and
@@ -5176,6 +5199,27 @@ not on a page, so it is worth saying what each one draws.
 \`square\` too, in the same registered axis. Membership is what a check can see,
 so nothing could have caught that, and a table is what stops it happening again.
 
+## What each separation draws
+
+\`separation\` says where a box ends, and \`elevated\` is the value nearly every
+family leaves out, so it is worth saying what each one draws and what that
+omission is about.
+
+| Value | What it draws |
+|---|---|
+| \`elevated\` | A surface lifted off the page, with a shadow under it |
+| \`filled\` | A ground of its own, and no edge |
+| \`outlined\` | An edge over the ground it already has |
+| \`plain\` | Neither, so the box ends where its content does |
+
+**Leaving \`elevated\` out is a fact about the value rather than about the family
+that skips it.** A shadow says the box floats above the page, which is true of a
+card picked up off a grid and of an announcement laid over the content, and
+false of a row in a feed, a groove a thumb sits in, a checkbox, or a bar across
+a video. A family taking the other three and stopping is following the value,
+not departing from the axis, and owes no argument for it. A family that *does*
+take it is the one saying something, and \`Card\` and \`Announcement\` both do.
+
 ## What a step inward means
 
 \`nesting\` is the one axis whose values are three readings of the same fact, so

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-docs",
   "description": "Versioned documentation content and registry for Helix.",
-  "version": "0.59.1",
+  "version": "0.59.2",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -36,8 +36,8 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.59.1",
-    "@fusion.dev/helix-testing": "0.59.1",
+    "@fusion.dev/helix-cem": "0.59.2",
+    "@fusion.dev/helix-testing": "0.59.2",
     "@fusion.dev/scripts": "0.0.0-dev",
     "lit": "^3.2.1",
     "playwright": "^1.62.1"