@fusion.dev/helix 0.95.0 → 0.97.0

package/custom-elements.json

@@ -2897,7 +2897,7 @@
               "kind": "field",
               "name": "curve",
               "type": {
-                "text": "Curve | undefined"
+                "text": "'smooth' | 'step' | 'straight' | undefined"
               },
               "description": "How a band's edge gets from one reading to the next.\n\nThree values, and the class doc argues for each: `straight` is absent and\nis the default, `smooth` is for a stack read as a shape and is the one that\ncan draw a part as less than nothing, `step` is for a quantity that changes\nat a moment and is ordered the way `straight` is.\n\nAbsent rather than defaulted because a reflecting property with a default\nwrites its attribute onto every host, including the ones nobody configured.\nThe resting value therefore lives in the render, as `curve ?? 'straight'`.\n\n**`LineChart` and `Sparkline` rest at `smooth` and are not disagreeing.** A\nline claims a position, so the bounded invention a monotone cubic makes is\na reading aid and costs nothing. A band claims an amount, and two sums\nsmoothed independently can cross, so the same aid here draws a part as less\nthan nothing. Same axis, different mark, different resting value.",
               "attribute": "curve",
@@ -3679,7 +3679,7 @@
             {
               "name": "curve",
               "type": {
-                "text": "Curve | undefined"
+                "text": "'smooth' | 'step' | 'straight' | undefined"
               },
               "description": "How a band's edge gets from one reading to the next.\n\nThree values, and the class doc argues for each: `straight` is absent and\nis the default, `smooth` is for a stack read as a shape and is the one that\ncan draw a part as less than nothing, `step` is for a quantity that changes\nat a moment and is ordered the way `straight` is.\n\nAbsent rather than defaulted because a reflecting property with a default\nwrites its attribute onto every host, including the ones nobody configured.\nThe resting value therefore lives in the render, as `curve ?? 'straight'`.\n\n**`LineChart` and `Sparkline` rest at `smooth` and are not disagreeing.** A\nline claims a position, so the bounded invention a monotone cubic makes is\na reading aid and costs nothing. A band claims an amount, and two sums\nsmoothed independently can cross, so the same aid here draws a part as less\nthan nothing. Same axis, different mark, different resting value.",
               "fieldName": "curve",
@@ -23304,7 +23304,7 @@
               "kind": "field",
               "name": "format",
               "type": {
-                "text": "ColorFormat | undefined"
+                "text": "'hex' | 'hsl' | 'rgb' | undefined"
               },
               "description": "The syntax the value is written in: `hex`, `rgb` or `hsl`.\n\n**Undefaulted, because it reflects.** The two together stamp an attribute\nonto every host anybody renders, including the ones nobody configured: the\nserver writes `format=\"hex\"` on every color input on the page, and React,\nholding no such prop, reports a hydration mismatch for each one.\n`helix component`'s `reflected-defaults` holds it. Hex is still what an unset one\nwrites; the resting arrangement is the attribute's absence rather than a\nvalue spelled out.",
               "attribute": "format",
@@ -24138,7 +24138,7 @@
             {
               "name": "format",
               "type": {
-                "text": "ColorFormat | undefined"
+                "text": "'hex' | 'hsl' | 'rgb' | undefined"
               },
               "description": "The syntax the value is written in: `hex`, `rgb` or `hsl`.\n\n**Undefaulted, because it reflects.** The two together stamp an attribute\nonto every host anybody renders, including the ones nobody configured: the\nserver writes `format=\"hex\"` on every color input on the page, and React,\nholding no such prop, reports a hydration mismatch for each one.\n`helix component`'s `reflected-defaults` holds it. Hex is still what an unset one\nwrites; the resting arrangement is the attribute's absence rather than a\nvalue spelled out.",
               "fieldName": "format",
@@ -24976,7 +24976,7 @@
               "kind": "field",
               "name": "format",
               "type": {
-                "text": "ColorFormat | undefined"
+                "text": "'hex' | 'hsl' | 'rgb' | undefined"
               },
               "description": "The syntax the value is written in: `hex`, `rgb` or `hsl`.\n\nOnly what is written. Everything is read whatever this says, so a picker on\n`hex` still takes an `rgb()` handed to it and stores the hex for it.",
               "attribute": "format",
@@ -26040,7 +26040,7 @@
             {
               "name": "format",
               "type": {
-                "text": "ColorFormat | undefined"
+                "text": "'hex' | 'hsl' | 'rgb' | undefined"
               },
               "description": "The syntax the value is written in: `hex`, `rgb` or `hsl`.\n\nOnly what is written. Everything is read whatever this says, so a picker on\n`hex` still takes an `rgb()` handed to it and stores the hex for it.",
               "fieldName": "format",
@@ -28895,7 +28895,7 @@
             },
             {
               "description": "The category before the label.",
-              "name": "tag-prefix",
+              "name": "tag-start",
               "inheritedFrom": {
                 "name": "HelixHeadlessCombobox",
                 "module": "src/combobox/root/combobox-root.ts"
@@ -36653,7 +36653,7 @@
             },
             {
               "description": "The category before the label.",
-              "name": "date-prefix",
+              "name": "date-start",
               "inheritedFrom": {
                 "name": "HelixHeadlessDateInput",
                 "module": "src/date-input/root/date-input-root.ts"
@@ -47161,7 +47161,7 @@
             },
             {
               "description": "The category before the label.",
-              "name": "kind-prefix",
+              "name": "kind-start",
               "inheritedFrom": {
                 "name": "HelixHeadlessFileInput",
                 "module": "src/file-input/root/file-input-root.ts"
@@ -47233,7 +47233,7 @@
             },
             {
               "description": "The category before the label.",
-              "name": "size-prefix",
+              "name": "size-start",
               "inheritedFrom": {
                 "name": "HelixHeadlessFileInput",
                 "module": "src/file-input/root/file-input-root.ts"
@@ -59697,7 +59697,7 @@
               "kind": "field",
               "name": "effectiveType",
               "type": {
-                "text": "InputType"
+                "text": "'email' | 'number' | 'password' | 'search' | 'tel' | 'text' | 'url'"
               },
               "privacy": "private",
               "description": "The type the real input is given, which is not always the type asked for.\n\nA revealed password is a text field for exactly as long as the reader is\nlooking at it. Reading through a getter rather than mutating `type` keeps\nthe property the consumer's: what they set is what they get back, whatever\nthe button is doing.",
@@ -59958,7 +59958,7 @@
               "kind": "field",
               "name": "type",
               "type": {
-                "text": "InputType"
+                "text": "'email' | 'number' | 'password' | 'search' | 'tel' | 'text' | 'url'"
               },
               "default": "'text'",
               "description": "What the field accepts, which decides the keyboard and the validation.\n\n**Not reflected.** Reflection exists so a selector can reach a value, and\nno stylesheet in this repository selects on `type`. Reflecting it writes\n`type=\"text\"` onto every `<helix-headless-input>` ever rendered, an\nattribute no consumer's markup has, which is the fault the area rules write\nup under `Button`'s `href`, `target` and `rel`.\n\nNothing reads it from the attribute either. The real `<input>` inside takes\nit as a property binding, which is what makes the keyboard and the\nvalidation follow.",
@@ -60722,7 +60722,7 @@
             {
               "name": "type",
               "type": {
-                "text": "InputType"
+                "text": "'email' | 'number' | 'password' | 'search' | 'tel' | 'text' | 'url'"
               },
               "default": "'text'",
               "description": "What the field accepts, which decides the keyboard and the validation.\n\n**Not reflected.** Reflection exists so a selector can reach a value, and\nno stylesheet in this repository selects on `type`. Reflecting it writes\n`type=\"text\"` onto every `<helix-headless-input>` ever rendered, an\nattribute no consumer's markup has, which is the fault the area rules write\nup under `Button`'s `href`, `target` and `rel`.\n\nNothing reads it from the attribute either. The real `<input>` inside takes\nit as a property binding, which is what makes the keyboard and the\nvalidation follow.",
@@ -62528,7 +62528,7 @@
               "kind": "field",
               "name": "curve",
               "type": {
-                "text": "Curve | undefined"
+                "text": "'smooth' | 'step' | 'straight' | undefined"
               },
               "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A curve invents the values between two\nreadings, which is why `straight` still exists, but the invention is\nbounded: the interpolation is monotone cubic, so it never leaves the band\nthe data sets and never introduces a peak or a trough the series does not\nhave. Within that bound the smoothed line is the easier one to follow\nacross a long series, and `straight` becomes the deliberate claim.\n\n**Absent rather than defaulted on the property**, because a reflecting\nproperty with a default writes its attribute onto every host anybody\nrenders, including the ones nobody configured.\n`line-chart-root.ssr.spec.ts` asserts the host carries only what the\nconsumer wrote. The default therefore lives where the path is built, as\n`curve ?? 'smooth'`.\n\n`step` claims the opposite of both, that a reading holds until the next.\n\n**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a\nposition and a stacked band claims an amount: a curve fitted through one\nsum can pass under the curve fitted through the sum beneath it, so a\nsmoothed stack can draw a part as less than nothing. There is no such edge\nhere, which is what lets a line take the reading aid.",
               "attribute": "curve",
@@ -63266,7 +63266,7 @@
             {
               "name": "curve",
               "type": {
-                "text": "Curve | undefined"
+                "text": "'smooth' | 'step' | 'straight' | undefined"
               },
               "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A curve invents the values between two\nreadings, which is why `straight` still exists, but the invention is\nbounded: the interpolation is monotone cubic, so it never leaves the band\nthe data sets and never introduces a peak or a trough the series does not\nhave. Within that bound the smoothed line is the easier one to follow\nacross a long series, and `straight` becomes the deliberate claim.\n\n**Absent rather than defaulted on the property**, because a reflecting\nproperty with a default writes its attribute onto every host anybody\nrenders, including the ones nobody configured.\n`line-chart-root.ssr.spec.ts` asserts the host carries only what the\nconsumer wrote. The default therefore lives where the path is built, as\n`curve ?? 'smooth'`.\n\n`step` claims the opposite of both, that a reading holds until the next.\n\n**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a\nposition and a stacked band claims an amount: a curve fitted through one\nsum can pass under the curve fitted through the sum beneath it, so a\nsmoothed stack can draw a part as less than nothing. There is no such edge\nhere, which is what lets a line take the reading aid.",
               "fieldName": "curve",
@@ -64136,24 +64136,24 @@
               }
             },
             {
-              "description": "Trailing content.",
-              "name": "end",
+              "description": "Secondary text under the label.",
+              "name": "description",
               "inheritedFrom": {
                 "name": "HelixHeadlessListItem",
                 "module": "src/list/item/list-item.ts"
               }
             },
             {
-              "description": "Leading content, usually an icon or an avatar.",
-              "name": "start",
+              "description": "Trailing content.",
+              "name": "end",
               "inheritedFrom": {
                 "name": "HelixHeadlessListItem",
                 "module": "src/list/item/list-item.ts"
               }
             },
             {
-              "description": "Secondary text under the label.",
-              "name": "supporting",
+              "description": "Leading content, usually an icon or an avatar.",
+              "name": "start",
               "inheritedFrom": {
                 "name": "HelixHeadlessListItem",
                 "module": "src/list/item/list-item.ts"
@@ -69887,7 +69887,7 @@
               "kind": "field",
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'bottom-start'",
               "description": "Preferred side.\n\nIt moves if that side does not fit.",
@@ -70605,7 +70605,7 @@
             {
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'bottom-start'",
               "description": "Preferred side.\n\nIt moves if that side does not fit.",
@@ -71005,7 +71005,7 @@
               "kind": "field",
               "name": "band",
               "type": {
-                "text": "MeterBand | undefined"
+                "text": "'fair' | 'good' | 'poor' | undefined"
               },
               "description": "The band, said outright, where the three thresholds cannot say it.\n\n**The specification's model has a shape, and it is worth knowing before\nreaching for this.** Three bands and a point mean it can express a\n*direction* in three grades, or a *target* in two, and never a target in\nthree. Measured across a grid: with `low=\"25\" high=\"50\" optimum=\"0\"` the\nreadings 5, 28 and 60 come out good, fair and poor; with `low=\"15\"\nhigh=\"25\" optimum=\"20\"` the readings 28 and 90 both come out fair, because\nfrom a middle band nothing is ever two bands away.\n\nSo a target you can miss badly in either direction has no expression in\n`low`, `high` and `optimum`, and neither has a rule that is not about\ndistance at all: 28 against a target of 20 is fine for a room's temperature\nand is not fine for a dosage, and no arrangement of thresholds knows which\none it is looking at.\n\nWritten, this wins outright and the thresholds are only for drawing the\nticks. A consumer whose rule is more than three buckets already knows the\nanswer, and asking them to encode it as thresholds so this can decode it\nagain is a worse API than letting them say it.\n\nNot reflected. Nothing selects on it: the band reaches the stylesheet as\n`data-band` on the fill, because that is the element being colored, and a\nstylesheet outside as `indicator-good`, `-fair` or `-poor` among the fill's\npart names, so reflecting here would write an attribute onto the host for\nno reader.",
               "attribute": "band",
@@ -71240,7 +71240,7 @@
               "kind": "field",
               "name": "computedBand",
               "type": {
-                "text": "MeterBand | undefined"
+                "text": "'fair' | 'good' | 'poor' | undefined"
               },
               "privacy": "private",
               "description": "Which band the reading is in, by the specification's rule.\n\n`optimum` names a point, and the band containing it is the good one. A\nreading in that band is good, one in a band beside it is fair, and one two\nbands away is poor. Undefined where nothing was declared, which is what\nkeeps an unbanded meter from being painted as good news.",
@@ -71616,7 +71616,7 @@
             {
               "name": "band",
               "type": {
-                "text": "MeterBand | undefined"
+                "text": "'fair' | 'good' | 'poor' | undefined"
               },
               "description": "The band, said outright, where the three thresholds cannot say it.\n\n**The specification's model has a shape, and it is worth knowing before\nreaching for this.** Three bands and a point mean it can express a\n*direction* in three grades, or a *target* in two, and never a target in\nthree. Measured across a grid: with `low=\"25\" high=\"50\" optimum=\"0\"` the\nreadings 5, 28 and 60 come out good, fair and poor; with `low=\"15\"\nhigh=\"25\" optimum=\"20\"` the readings 28 and 90 both come out fair, because\nfrom a middle band nothing is ever two bands away.\n\nSo a target you can miss badly in either direction has no expression in\n`low`, `high` and `optimum`, and neither has a rule that is not about\ndistance at all: 28 against a target of 20 is fine for a room's temperature\nand is not fine for a dosage, and no arrangement of thresholds knows which\none it is looking at.\n\nWritten, this wins outright and the thresholds are only for drawing the\nticks. A consumer whose rule is more than three buckets already knows the\nanswer, and asking them to encode it as thresholds so this can decode it\nagain is a worse API than letting them say it.\n\nNot reflected. Nothing selects on it: the band reaches the stylesheet as\n`data-band` on the fill, because that is the element being colored, and a\nstylesheet outside as `indicator-good`, `-fair` or `-poor` among the fill's\npart names, so reflecting here would write an attribute onto the host for\nno reader.",
               "fieldName": "band",
@@ -73110,7 +73110,7 @@
             },
             {
               "description": "Beside the count, for a link to the rest of them.",
-              "name": "action",
+              "name": "actions",
               "inheritedFrom": {
                 "name": "HelixHeadlessNotificationGroup",
                 "module": "src/notifications/group/notification-group.ts"
@@ -73128,7 +73128,7 @@
           "cssParts": [
             {
               "description": "The trailing region of the header.",
-              "name": "action",
+              "name": "actions",
               "inheritedFrom": {
                 "name": "HelixHeadlessNotificationGroup",
                 "module": "src/notifications/group/notification-group.ts"
@@ -73446,14 +73446,14 @@
             },
             {
               "description": "A second line qualifying it, quieter than the first. A bare slot rather than a box, so an item without one pays nothing for it; style it through `::slotted()`.",
-              "name": "caption",
+              "name": "description",
               "inheritedFrom": {
                 "name": "HelixHeadlessNotification",
                 "module": "src/notifications/notification/notification.ts"
               }
             },
             {
-              "description": "A block belonging to the row rather than a line about it: a quoted comment, a status moving from one value to another, a preview. Unlike `caption` nothing here sets a size or an ink, because whatever fills it usually brings its own.",
+              "description": "A block belonging to the row rather than a line about it: a quoted comment, a status moving from one value to another, a preview. Unlike `description` nothing here sets a size or an ink, because whatever fills it usually brings its own.",
               "name": "detail",
               "inheritedFrom": {
                 "name": "HelixHeadlessNotification",
@@ -79755,7 +79755,7 @@
               "kind": "field",
               "name": "state",
               "type": {
-                "text": "OrbState"
+                "text": "'waiting' | 'connecting' | 'thinking' | 'fetching' | 'listening' | 'working' | 'done'"
               },
               "default": "'thinking'",
               "description": "What the agent is doing.\n\n**A name we do not draw is drawn as `thinking` rather than as nothing.**\nThe set of things an agent can be doing grows faster than this list, and a\nverb we have not made a shape for should cost a reader a less specific\nindicator, not an empty box where the indicator was.\n\nNot reflected: no rule selects on it, because the state is drawn rather than\nstyled. A consumer writing the attribute can still select on their own\nmarkup.",
@@ -80285,7 +80285,7 @@
             {
               "name": "state",
               "type": {
-                "text": "OrbState"
+                "text": "'waiting' | 'connecting' | 'thinking' | 'fetching' | 'listening' | 'working' | 'done'"
               },
               "default": "'thinking'",
               "description": "What the agent is doing.\n\n**A name we do not draw is drawn as `thinking` rather than as nothing.**\nThe set of things an agent can be doing grows faster than this list, and a\nverb we have not made a shape for should cost a reader a less specific\nindicator, not an empty box where the indicator was.\n\nNot reflected: no rule selects on it, because the state is drawn rather than\nstyled. A consumer writing the attribute can still select on their own\nmarkup.",
@@ -85039,7 +85039,7 @@
               "kind": "field",
               "name": "type",
               "type": {
-                "text": "PinType"
+                "text": "'alphanumeric' | 'numeric' | 'text'"
               },
               "default": "'numeric'",
               "description": "What a box accepts, which decides the keyboard a phone offers.\n\n`numeric` and `alphanumeric` also refuse anything else on the way in,\nbecause a code that is digits is digits: letting a letter into a box a\nreader cannot submit is a mistake they have to find and undo themselves.\n`text` refuses nothing and only trims, so it is the mode for a code with a\nhyphen in it.\n\n**`alphanumeric` is ASCII letters and digits**, which is narrower than the\nword is in general and is the right narrowness here. A code of this kind\ncomes off a keypad, an SMS or an authenticator, and none of them emit `é`;\na filter that accepted it would let through a character the service on the\nother end is going to reject. A consumer whose codes really do carry\nmarked letters wants `text`, which judges nothing.\n\n**Not reflected**: nothing selects on it, so reflecting only writes\n`type=\"numeric\"` onto every `<helix-headless-pin-input>` ever rendered, an\nattribute no consumer's markup had. The area rules carry the sentence\n\"reflect only what CSS selects on\". The real inputs take it as a binding,\nwhich is what makes the keyboard follow.",
@@ -86036,7 +86036,7 @@
             {
               "name": "type",
               "type": {
-                "text": "PinType"
+                "text": "'alphanumeric' | 'numeric' | 'text'"
               },
               "default": "'numeric'",
               "description": "What a box accepts, which decides the keyboard a phone offers.\n\n`numeric` and `alphanumeric` also refuse anything else on the way in,\nbecause a code that is digits is digits: letting a letter into a box a\nreader cannot submit is a mistake they have to find and undo themselves.\n`text` refuses nothing and only trims, so it is the mode for a code with a\nhyphen in it.\n\n**`alphanumeric` is ASCII letters and digits**, which is narrower than the\nword is in general and is the right narrowness here. A code of this kind\ncomes off a keypad, an SMS or an authenticator, and none of them emit `é`;\na filter that accepted it would let through a character the service on the\nother end is going to reject. A consumer whose codes really do carry\nmarked letters wants `text`, which judges nothing.\n\n**Not reflected**: nothing selects on it, so reflecting only writes\n`type=\"numeric\"` onto every `<helix-headless-pin-input>` ever rendered, an\nattribute no consumer's markup had. The area rules carry the sentence\n\"reflect only what CSS selects on\". The real inputs take it as a binding,\nwhich is what makes the keyboard follow.",
@@ -86382,7 +86382,7 @@
               "kind": "field",
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'bottom-start'",
               "description": "Preferred side.\n\nIt moves if that side does not fit.",
@@ -86888,7 +86888,7 @@
             {
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'bottom-start'",
               "description": "Preferred side.\n\nIt moves if that side does not fit.",
@@ -87873,7 +87873,7 @@
               "kind": "field",
               "name": "correction",
               "type": {
-                "text": "QrCorrection | undefined"
+                "text": "'H' | 'L' | 'M' | 'Q' | undefined"
               },
               "description": "How much of the code can be lost and still read.\n\n`M` by default, which is the level almost every code in the world uses and\ncosts about fifteen percent redundancy. `H` where a mark covers the center,\nchosen automatically when the slot is filled: it is the level that makes\ncovering safe, and a consumer who fills the slot has said what they want\nwithout having to know that.",
               "attribute": "correction",
@@ -87900,7 +87900,7 @@
               "kind": "field",
               "name": "shape",
               "type": {
-                "text": "QrStyle | undefined"
+                "text": "'dots' | 'rounded' | 'square' | undefined"
               },
               "description": "How the modules are drawn.\n\n`square` is the resting state and is written by not writing it, per the\nrule that a reflected property takes no default. It is also the only one\nthat joins runs of adjacent modules into a single subpath, which is what\nkeeps a thousand modules to a handful of nodes. `rounded` and `dots` draw\neach module on its own, because the corners are the thing being drawn and a\njoined run has none in the middle. That cost is paid only by a code that\nasks for them.\n\nA scanner reads contrast between cells, not their shape, so all three\nscan. `dots` sits a little under half a module so neighbors do not touch,\nwhich is what makes it read as dots rather than as a softened square code.",
               "attribute": "shape",
@@ -87942,7 +87942,7 @@
               "kind": "field",
               "name": "level",
               "type": {
-                "text": "QrCorrection"
+                "text": "'H' | 'L' | 'M' | 'Q'"
               },
               "privacy": "private",
               "description": "The level actually used, which the slot can raise.",
@@ -88386,7 +88386,7 @@
             {
               "name": "correction",
               "type": {
-                "text": "QrCorrection | undefined"
+                "text": "'H' | 'L' | 'M' | 'Q' | undefined"
               },
               "description": "How much of the code can be lost and still read.\n\n`M` by default, which is the level almost every code in the world uses and\ncosts about fifteen percent redundancy. `H` where a mark covers the center,\nchosen automatically when the slot is filled: it is the level that makes\ncovering safe, and a consumer who fills the slot has said what they want\nwithout having to know that.",
               "fieldName": "correction",
@@ -88411,7 +88411,7 @@
             {
               "name": "shape",
               "type": {
-                "text": "QrStyle | undefined"
+                "text": "'dots' | 'rounded' | 'square' | undefined"
               },
               "description": "How the modules are drawn.\n\n`square` is the resting state and is written by not writing it, per the\nrule that a reflected property takes no default. It is also the only one\nthat joins runs of adjacent modules into a single subpath, which is what\nkeeps a thousand modules to a handful of nodes. `rounded` and `dots` draw\neach module on its own, because the corners are the thing being drawn and a\njoined run has none in the middle. That cost is paid only by a code that\nasks for them.\n\nA scanner reads contrast between cells, not their shape, so all three\nscan. `dots` sits a little under half a module so neighbors do not touch,\nwhich is what makes it read as dots rather than as a softened square code.",
               "fieldName": "shape",
@@ -103411,7 +103411,7 @@
               "kind": "field",
               "name": "curve",
               "type": {
-                "text": "Curve | undefined"
+                "text": "'smooth' | 'step' | 'straight' | undefined"
               },
               "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A straight segment asserts nothing about\nthe values between two readings and a curve invents them, which is why\n`straight` exists. What settles the default the other way is that the\ninvention is bounded: the interpolation is monotone cubic, so it never\nleaves the band the data sets and never introduces a peak or a trough the\nseries does not have. Within that bound the smoothed line is the easier one\nto follow across a long series, which is what the drawing is for. `straight`\nbecomes the claim a consumer makes deliberately rather than the one they get\nby saying nothing.\n\n**The property stays optional and the default lives in the render.** A\nreflecting property with a default writes its attribute onto every host\nanybody renders, including the ones nobody configured, which the SSR specs\nassert against. So the resting state is still the attribute's absence, and\n`curve ?? 'smooth'` is what reads it.\n\n`step` claims the opposite of both, that a reading holds until the next.\nBars ignore it, having no between to interpolate.\n\n**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a\nposition and a stacked band claims an amount: a curve fitted through one\nsum can pass under the curve fitted through the sum beneath it, so a\nsmoothed stack can draw a part as less than nothing. There is no such edge\nhere, which is what lets a line take the reading aid.",
               "attribute": "curve",
@@ -103856,7 +103856,7 @@
             {
               "name": "curve",
               "type": {
-                "text": "Curve | undefined"
+                "text": "'smooth' | 'step' | 'straight' | undefined"
               },
               "description": "How the line gets from one reading to the next.\n\n**`smooth` is the resting curve.** A straight segment asserts nothing about\nthe values between two readings and a curve invents them, which is why\n`straight` exists. What settles the default the other way is that the\ninvention is bounded: the interpolation is monotone cubic, so it never\nleaves the band the data sets and never introduces a peak or a trough the\nseries does not have. Within that bound the smoothed line is the easier one\nto follow across a long series, which is what the drawing is for. `straight`\nbecomes the claim a consumer makes deliberately rather than the one they get\nby saying nothing.\n\n**The property stays optional and the default lives in the render.** A\nreflecting property with a default writes its attribute onto every host\nanybody renders, including the ones nobody configured, which the SSR specs\nassert against. So the resting state is still the attribute's absence, and\n`curve ?? 'smooth'` is what reads it.\n\n`step` claims the opposite of both, that a reading holds until the next.\nBars ignore it, having no between to interpolate.\n\n**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a\nposition and a stacked band claims an amount: a curve fitted through one\nsum can pass under the curve fitted through the sum beneath it, so a\nsmoothed stack can draw a part as less than nothing. There is no such edge\nhere, which is what lets a line take the reading aid.",
               "fieldName": "curve",
@@ -104877,7 +104877,7 @@
               "kind": "field",
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'top-end'",
               "description": "Which way the actions fan out. They move if that side does not fit.\n\nUp by default, because the control this hangs off is usually docked to the\nbottom of the window and there is nothing below it to fan into.",
@@ -105429,7 +105429,7 @@
             {
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'top-end'",
               "description": "Which way the actions fan out. They move if that side does not fit.\n\nUp by default, because the control this hangs off is usually docked to the\nbottom of the window and there is nothing below it to fan into.",
@@ -115560,7 +115560,7 @@
             },
             {
               "description": "The category before the label.",
-              "name": "prefix",
+              "name": "start",
               "inheritedFrom": {
                 "name": "HelixHeadlessTag",
                 "module": "src/tag/root/tag-root.ts"
@@ -115578,7 +115578,7 @@
             },
             {
               "description": "A category the label belongs to, set before it and weightier.",
-              "name": "prefix",
+              "name": "start",
               "inheritedFrom": {
                 "name": "HelixHeadlessTag",
                 "module": "src/tag/root/tag-root.ts"
@@ -116077,6 +116077,10 @@
                 "description": "The tag filled, outlined and subtle.",
                 "slug": "appearances"
               },
+              {
+                "description": "A category before the label, which it qualifies.",
+                "slug": "category"
+              },
               {
                 "description": "Tags a reader can take off, which is what a filter bar holds.",
                 "slug": "dismissible"
@@ -116084,10 +116088,6 @@
               {
                 "description": "A tag asks to go and does not go on its own.",
                 "slug": "events"
-              },
-              {
-                "description": "A glyph or an avatar before the label.",
-                "slug": "prefix"
               }
             ],
             "source": "helix/styled/src/tag"
@@ -120971,7 +120971,7 @@
             },
             {
               "description": "The category before the label.",
-              "name": "time-prefix",
+              "name": "time-start",
               "inheritedFrom": {
                 "name": "HelixHeadlessTimeInput",
                 "module": "src/time-input/root/time-input-root.ts"
@@ -128316,7 +128316,7 @@
               "kind": "field",
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'top'",
               "description": "Preferred side.\n\nIt moves if that side does not fit.",
@@ -129126,7 +129126,7 @@
             {
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'top'",
               "description": "Preferred side.\n\nIt moves if that side does not fit.",
@@ -130649,7 +130649,7 @@
               "kind": "field",
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'bottom'",
               "description": "Which side of the target the panel prefers.",
@@ -131302,7 +131302,7 @@
             {
               "name": "placement",
               "type": {
-                "text": "Placement"
+                "text": "'bottom' | 'bottom-end' | 'bottom-start' | 'left' | 'left-end' | 'left-start' | 'right' | 'right-end' | 'right-start' | 'top' | 'top-end' | 'top-start'"
               },
               "default": "'bottom'",
               "description": "Which side of the target the panel prefers.",

package/dist/list/item/list-item.css.js

@@ -45,7 +45,7 @@ grid-column: 3;
 grid-row: 1;
 }
 
-slot[name="supporting"] {
+slot[name="description"] {
 color: var(--helix-color-foreground-muted);
 display: block;
 font-size: var(--helix-text-xs);
@@ -54,7 +54,7 @@ grid-row: 2;
 }
 
 slot:not([name])::slotted(*),
-slot[name="supporting"]::slotted(*) {
+slot[name="description"]::slotted(*) {
 margin: var(--helix-space-none);
 }
 

package/dist/notifications/group/notification-group.css.js

@@ -51,7 +51,7 @@ outline-offset: var(--helix-size-focus-offset);
 color: var(--helix-color-foreground);
 }
 
-[part="action"] {
+[part="actions"] {
 align-items: center;
 display: inline-flex;
 margin-inline-start: auto;

package/dist/notifications/notification/notification.css.js

@@ -84,7 +84,7 @@ font-size: var(--helix-text-sm);
 line-height: var(--_notifications-line);
 }
 
-slot[name="caption"]::slotted(*) {
+slot[name="description"]::slotted(*) {
 color: var(--helix-color-foreground-subtle);
 font-family: var(--helix-font-sans);
 font-size: var(--helix-text-xs);

package/dist/tag/root/tag-root.css.js

@@ -97,7 +97,7 @@ block-size: 0.85em;
 inline-size: 0.85em;
 }
 
-slot[name="prefix"]::slotted(*) {
+slot[name="start"]::slotted(*) {
 font-weight: var(--helix-weight-semibold);
 margin-inline-end: var(--_tag-inset);
 opacity: 0.75;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix",
   "description": "Styled component tier. Extends the headless tier with token-driven presentation.",
-  "version": "0.95.0",
+  "version": "0.97.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -47,13 +47,13 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.95.0",
-    "@fusion.dev/helix-headless": "0.95.0",
-    "@fusion.dev/helix-styles": "0.95.0"
+    "@fusion.dev/helix-core": "0.97.0",
+    "@fusion.dev/helix-headless": "0.97.0",
+    "@fusion.dev/helix-styles": "0.97.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.95.0",
-    "@fusion.dev/helix-testing": "0.95.0",
+    "@fusion.dev/helix-cem": "0.97.0",
+    "@fusion.dev/helix-testing": "0.97.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.0.0",
     "@lit-labs/ssr": "^4.1.0",

package/types/jsx.d.ts

@@ -25721,7 +25721,7 @@ export type CustomElements = {
    * - `tag`: One chosen option.
    * - `tag-dismiss`: The remove button, when `dismissible`.
    * - `tag-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `tag-prefix`: The category before the label.
+   * - `tag-start`: The category before the label.
    * - `tags`: The row of chosen options, when `multiple` is set.
    *
    * ## CSS States
@@ -26661,7 +26661,7 @@ export type CustomElements = {
    * - `date`: One held date, as a tag, in `multiple`.
    * - `date-dismiss`: The remove button, when `dismissible`.
    * - `date-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `date-prefix`: The category before the label.
+   * - `date-start`: The category before the label.
    * - `feedback`: What is wrong with it.
    * - `field`: The box holding the text and the trigger.
    * - `hint`: Help under the field, while nothing is wrong.
@@ -28229,7 +28229,7 @@ export type CustomElements = {
    * - `kind`: What kind of file it is.
    * - `kind-dismiss`: The remove button, when `dismissible`.
    * - `kind-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `kind-prefix`: The category before the label.
+   * - `kind-start`: The category before the label.
    * - `label`: The question, over the field.
    * - `list`: The chosen files.
    * - `meta`: The row holding its size and kind.
@@ -28238,7 +28238,7 @@ export type CustomElements = {
    * - `size`: How big it is.
    * - `size-dismiss`: The remove button, when `dismissible`.
    * - `size-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `size-prefix`: The category before the label.
+   * - `size-start`: The category before the label.
    * - `trigger`: The label that opens the picker.
    *
    * ## CSS States
@@ -30667,9 +30667,9 @@ export type CustomElements = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The label.
+   * - `description`: Secondary text under the label.
    * - `end`: Trailing content.
    * - `start`: Leading content, usually an icon or an avatar.
-   * - `supporting`: Secondary text under the label.
    *
    * ## CSS Custom Properties
    *
@@ -31899,7 +31899,7 @@ export type CustomElements = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The notifications in this group.
-   * - `action`: Beside the count, for a link to the rest of them.
+   * - `actions`: Beside the count, for a link to the rest of them.
    * - `label`: Replaces the group's name, for a heading that needs a mark in it.
    *
    * ## Methods
@@ -31919,7 +31919,7 @@ export type CustomElements = {
    *
    * Custom selectors for styling elements within the component.
    *
-   * - `action`: The trailing region of the header.
+   * - `actions`: The trailing region of the header.
    * - `count`: How many are in the group.
    * - `header`: The label, the count and the action together.
    * - `items`: The region holding the notifications.
@@ -32046,8 +32046,8 @@ export type CustomElements = {
    * - `(default)`: What happened, in the consumer's own markup.
    * - `actions`: What a reader can do about it.
    * - `media`: An avatar or icon identifying who or what it came from.
-   * - `caption`: A second line qualifying it, quieter than the first. A bare slot rather than a box, so an item without one pays nothing for it; style it through `::slotted()`.
-   * - `detail`: A block belonging to the row rather than a line about it: a quoted comment, a status moving from one value to another, a preview. Unlike `caption` nothing here sets a size or an ink, because whatever fills it usually brings its own.
+   * - `description`: A second line qualifying it, quieter than the first. A bare slot rather than a box, so an item without one pays nothing for it; style it through `::slotted()`.
+   * - `detail`: A block belonging to the row rather than a line about it: a quoted comment, a status moving from one value to another, a preview. Unlike `description` nothing here sets a size or an ink, because whatever fills it usually brings its own.
    * - `dismiss`: Replaces the glyph inside the dismiss control, which is drawn only where the row is `dismissible`.
    *
    * ## Methods
@@ -37920,7 +37920,7 @@ export type CustomElements = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The tag's label.
-   * - `prefix`: A category the label belongs to, set before it and weightier.
+   * - `start`: A category the label belongs to, set before it and weightier.
    *
    * ## Methods
    *
@@ -37943,7 +37943,7 @@ export type CustomElements = {
    *
    * - `dismiss`: The remove button, when `dismissible`.
    * - `dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `prefix`: The category before the label.
+   * - `start`: The category before the label.
    *
    * ## CSS States
    *
@@ -38551,7 +38551,7 @@ export type CustomElements = {
    * - `time`: One held time, as a tag, in `multiple`.
    * - `time-dismiss`: The remove button, when `dismissible`.
    * - `time-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `time-prefix`: The category before the label.
+   * - `time-start`: The category before the label.
    * - `trigger`: The control that opens the list.
    * - `trigger-icon`: The mark on the button that opens the clock.
    *
@@ -45457,7 +45457,7 @@ export type CustomElementsSolidJs = {
    * - `tag`: One chosen option.
    * - `tag-dismiss`: The remove button, when `dismissible`.
    * - `tag-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `tag-prefix`: The category before the label.
+   * - `tag-start`: The category before the label.
    * - `tags`: The row of chosen options, when `multiple` is set.
    *
    * ## CSS States
@@ -46409,7 +46409,7 @@ export type CustomElementsSolidJs = {
    * - `date`: One held date, as a tag, in `multiple`.
    * - `date-dismiss`: The remove button, when `dismissible`.
    * - `date-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `date-prefix`: The category before the label.
+   * - `date-start`: The category before the label.
    * - `feedback`: What is wrong with it.
    * - `field`: The box holding the text and the trigger.
    * - `hint`: Help under the field, while nothing is wrong.
@@ -48010,7 +48010,7 @@ export type CustomElementsSolidJs = {
    * - `kind`: What kind of file it is.
    * - `kind-dismiss`: The remove button, when `dismissible`.
    * - `kind-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `kind-prefix`: The category before the label.
+   * - `kind-start`: The category before the label.
    * - `label`: The question, over the field.
    * - `list`: The chosen files.
    * - `meta`: The row holding its size and kind.
@@ -48019,7 +48019,7 @@ export type CustomElementsSolidJs = {
    * - `size`: How big it is.
    * - `size-dismiss`: The remove button, when `dismissible`.
    * - `size-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `size-prefix`: The category before the label.
+   * - `size-start`: The category before the label.
    * - `trigger`: The label that opens the picker.
    *
    * ## CSS States
@@ -50499,9 +50499,9 @@ export type CustomElementsSolidJs = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The label.
+   * - `description`: Secondary text under the label.
    * - `end`: Trailing content.
    * - `start`: Leading content, usually an icon or an avatar.
-   * - `supporting`: Secondary text under the label.
    *
    * ## CSS Custom Properties
    *
@@ -51758,7 +51758,7 @@ export type CustomElementsSolidJs = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The notifications in this group.
-   * - `action`: Beside the count, for a link to the rest of them.
+   * - `actions`: Beside the count, for a link to the rest of them.
    * - `label`: Replaces the group's name, for a heading that needs a mark in it.
    *
    * ## Methods
@@ -51778,7 +51778,7 @@ export type CustomElementsSolidJs = {
    *
    * Custom selectors for styling elements within the component.
    *
-   * - `action`: The trailing region of the header.
+   * - `actions`: The trailing region of the header.
    * - `count`: How many are in the group.
    * - `header`: The label, the count and the action together.
    * - `items`: The region holding the notifications.
@@ -51908,8 +51908,8 @@ export type CustomElementsSolidJs = {
    * - `(default)`: What happened, in the consumer's own markup.
    * - `actions`: What a reader can do about it.
    * - `media`: An avatar or icon identifying who or what it came from.
-   * - `caption`: A second line qualifying it, quieter than the first. A bare slot rather than a box, so an item without one pays nothing for it; style it through `::slotted()`.
-   * - `detail`: A block belonging to the row rather than a line about it: a quoted comment, a status moving from one value to another, a preview. Unlike `caption` nothing here sets a size or an ink, because whatever fills it usually brings its own.
+   * - `description`: A second line qualifying it, quieter than the first. A bare slot rather than a box, so an item without one pays nothing for it; style it through `::slotted()`.
+   * - `detail`: A block belonging to the row rather than a line about it: a quoted comment, a status moving from one value to another, a preview. Unlike `description` nothing here sets a size or an ink, because whatever fills it usually brings its own.
    * - `dismiss`: Replaces the glyph inside the dismiss control, which is drawn only where the row is `dismissible`.
    *
    * ## Methods
@@ -57926,7 +57926,7 @@ export type CustomElementsSolidJs = {
    * Areas where markup can be added to the component.
    *
    * - `(default)`: The tag's label.
-   * - `prefix`: A category the label belongs to, set before it and weightier.
+   * - `start`: A category the label belongs to, set before it and weightier.
    *
    * ## Methods
    *
@@ -57949,7 +57949,7 @@ export type CustomElementsSolidJs = {
    *
    * - `dismiss`: The remove button, when `dismissible`.
    * - `dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `prefix`: The category before the label.
+   * - `start`: The category before the label.
    *
    * ## CSS States
    *
@@ -58564,7 +58564,7 @@ export type CustomElementsSolidJs = {
    * - `time`: One held time, as a tag, in `multiple`.
    * - `time-dismiss`: The remove button, when `dismissible`.
    * - `time-dismiss-mark`: The glyph on the dismiss control, where none is slotted.
-   * - `time-prefix`: The category before the label.
+   * - `time-start`: The category before the label.
    * - `trigger`: The control that opens the list.
    * - `trigger-icon`: The mark on the button that opens the clock.
    *