@twentyfirstmedia/elements 0.5.0 → 0.7.0

package/dist/vscode.html-custom-data.json

@@ -224,6 +224,18 @@
         {
           "name": "label",
           "description": "(string)"
+        },
+        {
+          "name": "layout",
+          "description": "`list`: one compact row per option (small picture or icon beside the label), e.g. on phones. (\"grid\" | \"list\")",
+          "values": [
+            {
+              "name": "grid"
+            },
+            {
+              "name": "list"
+            }
+          ]
         }
       ],
       "references": [
@@ -810,6 +822,11 @@
         {
           "name": "width",
           "description": "(number)"
+        },
+        {
+          "name": "compact",
+          "description": "Only the workspace's mark, its name as the accessible name (a collapsed sidebar). (boolean)",
+          "valueSet": "v"
         }
       ],
       "references": [
@@ -894,6 +911,14 @@
           "name": "qr",
           "description": "(ReactNode)"
         },
+        {
+          "name": "qr-value",
+          "description": "The otpauth:// link: the kit draws its QR code (instead of `qr`). (string)"
+        },
+        {
+          "name": "trust-device",
+          "description": "A \"Trust this device\" checkbox under the code field; a string replaces its label. (boolean | string)"
+        },
         {
           "name": "secret",
           "description": "(string)"
@@ -907,50 +932,760 @@
           "description": "(0 | 1 | 2)"
         },
         {
-          "name": "scan-text",
+          "name": "scan-text",
+          "description": "(string)"
+        },
+        {
+          "name": "codes-text",
+          "description": "(string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/TwoFactorSetup/"
+        }
+      ]
+    },
+    {
+      "name": "tf-color-field",
+      "description": "The ColorField component as a custom element.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "(ReactNode)"
+        },
+        {
+          "name": "value",
+          "description": "(string)"
+        },
+        {
+          "name": "default-value",
+          "description": "(string)"
+        },
+        {
+          "name": "against",
+          "description": "(string | false)"
+        },
+        {
+          "name": "hint",
+          "description": "(ReactNode)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/ColorField/"
+        }
+      ]
+    },
+    {
+      "name": "tf-qr-code",
+      "description": "A QR code drawn as SVG and encoded on the device, so the text (a sign-in secret, an invite link) never goes to a service.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The text to encode: an otpauth:// link, a URL … (string)"
+        },
+        {
+          "name": "level",
+          "description": "Error correction: L, M (default), Q or H. (\"L\" | \"M\" | \"Q\" | \"H\")",
+          "values": [
+            {
+              "name": "L"
+            },
+            {
+              "name": "M"
+            },
+            {
+              "name": "Q"
+            },
+            {
+              "name": "H"
+            }
+          ]
+        },
+        {
+          "name": "size",
+          "description": "Width and height (default: the width of its container). (number | string)"
+        },
+        {
+          "name": "quiet",
+          "description": "Light modules around the code (default 4, the standard quiet zone). (number)"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name (default \"QR code\"). (string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/QrCode/"
+        }
+      ]
+    },
+    {
+      "name": "tf-habit-tracker",
+      "description": "Habits with their last days as a row of marks: done, missed or no entry, today's mark a toggle.",
+      "attributes": [
+        {
+          "name": "habits",
+          "description": "(Habit[])"
+        },
+        {
+          "name": "day-labels",
+          "description": "Labels of the day columns, oldest first (default: weekday initials ending today). (string[])"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name of the list (default \"Habits\"). (string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/HabitTracker/"
+        }
+      ]
+    },
+    {
+      "name": "tf-mood-picker",
+      "description": "A five-step mood scale with faces and words, as a radio group.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "(MoodLevel | null)"
+        },
+        {
+          "name": "default-value",
+          "description": "(MoodLevel | null)"
+        },
+        {
+          "name": "label",
+          "description": "The question (default \"How are you feeling?\"). (ReactNode)"
+        },
+        {
+          "name": "levels",
+          "description": "Words for the five levels, lowest first (default Awful, Low, Okay, Good, Great). ([string, string, string, string, string])"
+        },
+        {
+          "name": "compact",
+          "description": "Only the faces; the words stay as accessible names. (boolean)",
+          "valueSet": "v"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/MoodPicker/"
+        }
+      ]
+    },
+    {
+      "name": "tf-vital-tile",
+      "description": "One health value with its healthy range: the value, a band with the normal zone and a marker, a status in words (in range, below, above) and an optional trend.",
+      "attributes": [
+        {
+          "name": "surface",
+          "description": "`\"glass\"`: translucent glass over a backdrop (`Ambient`, a photo, a map); `\"solid\"` opts out inside a glass `UIProvider`. (Surface)"
+        },
+        {
+          "name": "label",
+          "description": "(string)"
+        },
+        {
+          "name": "value",
+          "description": "(number)"
+        },
+        {
+          "name": "unit",
+          "description": "(string)"
+        },
+        {
+          "name": "icon",
+          "description": "(IconName)"
+        },
+        {
+          "name": "normal",
+          "description": "The healthy range [low, high]; the tile says whether the value is below, in or above it. ([number, number])"
+        },
+        {
+          "name": "scale",
+          "description": "The whole scale of the band [min, max] (default: the normal range with room on both sides). ([number, number])"
+        },
+        {
+          "name": "trend",
+          "description": "Recent values, oldest first, drawn as a sparkline. (number[])"
+        },
+        {
+          "name": "caption",
+          "description": "Under the value: when it was measured, the source … (ReactNode)"
+        },
+        {
+          "name": "digits",
+          "description": "Digits after the decimal point (default 0). (number)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/VitalTile/"
+        }
+      ]
+    },
+    {
+      "name": "tf-activity-rings",
+      "description": "Concentric progress rings for daily goals (move, exercise, stand, steps, water) with a legend.",
+      "attributes": [
+        {
+          "name": "rings",
+          "description": "Outer ring first. (ActivityRing[])"
+        },
+        {
+          "name": "size",
+          "description": "Diameter of the rings (default 132). (number)"
+        },
+        {
+          "name": "legend",
+          "description": "Hide the legend beside the rings. (boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name (default \"Activity\"). (string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/ActivityRings/"
+        }
+      ]
+    },
+    {
+      "name": "tf-sleep-chart",
+      "description": "A night as sleep stages over time, one lane per stage (awake, REM, light, deep), with the time asleep and the time per stage.",
+      "attributes": [
+        {
+          "name": "segments",
+          "description": "The night in order, from falling asleep to getting up. (SleepSegment[])"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name (default \"Sleep stages\"). (string)"
+        },
+        {
+          "name": "summary",
+          "description": "Hide the totals per stage under the chart. (boolean)",
+          "valueSet": "v"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/SleepChart/"
+        }
+      ]
+    },
+    {
+      "name": "tf-medication-list",
+      "description": "Today's doses in order, each with its time, name, dose, a status in words and a \"taken\" button.",
+      "attributes": [
+        {
+          "name": "items",
+          "description": "(MedicationItem[])"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name (default \"Medication\"). (string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/MedicationList/"
+        }
+      ]
+    },
+    {
+      "name": "tf-journal-entry",
+      "description": "A journal or diary entry: the date, the mood of the day, a title, the text and tags, with room for actions such as edit or share.",
+      "attributes": [
+        {
+          "name": "surface",
+          "description": "`\"glass\"`: translucent glass over a backdrop (`Ambient`, a photo, a map); `\"solid\"` opts out inside a glass `UIProvider`. (Surface)"
+        },
+        {
+          "name": "date",
+          "description": "(Date | string | number)"
+        },
+        {
+          "name": "title",
+          "description": "(string)"
+        },
+        {
+          "name": "mood",
+          "description": "(MoodLevel)"
+        },
+        {
+          "name": "tags",
+          "description": "(string[])"
+        },
+        {
+          "name": "actions",
+          "description": "Buttons at the end (edit, share …). (ReactNode)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/JournalEntry/"
+        }
+      ]
+    },
+    {
+      "name": "tf-goal-card",
+      "description": "A goal with its progress toward a target, a due date, milestones and a note.",
+      "attributes": [
+        {
+          "name": "surface",
+          "description": "`\"glass\"`: translucent glass over a backdrop (`Ambient`, a photo, a map); `\"solid\"` opts out inside a glass `UIProvider`. (Surface)"
+        },
+        {
+          "name": "title",
+          "description": "(string)"
+        },
+        {
+          "name": "value",
+          "description": "(number)"
+        },
+        {
+          "name": "target",
+          "description": "(number)"
+        },
+        {
+          "name": "format",
+          "description": "How to show value and target (default number). (\"number\" | \"money\" | \"percent\")",
+          "values": [
+            {
+              "name": "number"
+            },
+            {
+              "name": "money"
+            },
+            {
+              "name": "percent"
+            }
+          ]
+        },
+        {
+          "name": "unit",
+          "description": "Unit after numbers (\"km\", \"books\"). (string)"
+        },
+        {
+          "name": "currency",
+          "description": "(string)"
+        },
+        {
+          "name": "due",
+          "description": "(Date | string | number)"
+        },
+        {
+          "name": "icon",
+          "description": "(IconName)"
+        },
+        {
+          "name": "tint",
+          "description": "(Tint)"
+        },
+        {
+          "name": "milestones",
+          "description": "({ label: string; done?: boolean }[])"
+        },
+        {
+          "name": "note",
+          "description": "A note under the progress (\"€250 a month keeps you on track\"). (ReactNode)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/GoalCard/"
+        }
+      ]
+    },
+    {
+      "name": "tf-insight-card",
+      "description": "Something the assistant noticed: what, where it comes from, why it is shown and what to do.",
+      "attributes": [
+        {
+          "name": "surface",
+          "description": "`\"glass\"`: translucent glass over a backdrop (`Ambient`, a photo, a map); `\"solid\"` opts out inside a glass `UIProvider`. (Surface)"
+        },
+        {
+          "name": "title",
+          "description": "(string)"
+        },
+        {
+          "name": "icon",
+          "description": "(IconName)"
+        },
+        {
+          "name": "tone",
+          "description": "(\"info\" | \"success\" | \"warning\" | \"highlight\")",
+          "values": [
+            {
+              "name": "info"
+            },
+            {
+              "name": "success"
+            },
+            {
+              "name": "warning"
+            },
+            {
+              "name": "highlight"
+            }
+          ]
+        },
+        {
+          "name": "meta",
+          "description": "Above the title: area and time (\"Money · 2 h ago\"). (ReactNode)"
+        },
+        {
+          "name": "sources",
+          "description": "Where the insight comes from, as chips (like chat sources). (Source[])"
+        },
+        {
+          "name": "why",
+          "description": "Why the assistant shows it; folded away behind \"Why am I seeing this?\". (ReactNode)"
+        },
+        {
+          "name": "accept-label",
+          "description": "(string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/InsightCard/"
+        }
+      ]
+    },
+    {
+      "name": "tf-consent-list",
+      "description": "What each connected source lets the assistant read or do: one card per source with its purpose, last use and a switch per scope, plus \"Revoke access\".",
+      "attributes": [
+        {
+          "name": "surface",
+          "description": "`\"glass\"`: translucent glass over a backdrop (`Ambient`, a photo, a map); `\"solid\"` opts out inside a glass `UIProvider`. (Surface)"
+        },
+        {
+          "name": "connectors",
+          "description": "(ConsentConnector[])"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name (default \"Data access\"). (string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/ConsentList/"
+        }
+      ]
+    },
+    {
+      "name": "tf-budget-list",
+      "description": "Spending per category against its limit: spent and limit, a bar, and what is left or over in words.",
+      "attributes": [
+        {
+          "name": "categories",
+          "description": "(BudgetCategory[])"
+        },
+        {
+          "name": "currency",
+          "description": "(string)"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name (default \"Budgets\"). (string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/BudgetList/"
+        }
+      ]
+    },
+    {
+      "name": "tf-subscription-list",
+      "description": "Recurring payments with their next charge, trial and cancelled states, and what they cost together a month and a year.",
+      "attributes": [
+        {
+          "name": "items",
+          "description": "(Subscription[])"
+        },
+        {
+          "name": "currency",
+          "description": "(string)"
+        },
+        {
+          "name": "totals",
+          "description": "Hide the monthly and yearly totals. (boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name (default \"Subscriptions\"). (string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/SubscriptionList/"
+        }
+      ]
+    },
+    {
+      "name": "tf-net-worth-card",
+      "description": "What you own minus what you owe: the total, its change and trend, and the assets and liabilities behind it.",
+      "attributes": [
+        {
+          "name": "surface",
+          "description": "`\"glass\"`: translucent glass over a backdrop (`Ambient`, a photo, a map); `\"solid\"` opts out inside a glass `UIProvider`. (Surface)"
+        },
+        {
+          "name": "assets",
+          "description": "({ label: string; value: number; icon?: IconName }[])"
+        },
+        {
+          "name": "liabilities",
+          "description": "({ label: string; value: number; icon?: IconName }[])"
+        },
+        {
+          "name": "history",
+          "description": "Net worth over time, oldest first. (number[])"
+        },
+        {
+          "name": "change",
+          "description": "Change over `changeLabel` (e.g. +1,240 \"since October\"). (number)"
+        },
+        {
+          "name": "change-label",
+          "description": "(string)"
+        },
+        {
+          "name": "currency",
+          "description": "(string)"
+        },
+        {
+          "name": "title",
+          "description": "(string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/NetWorthCard/"
+        }
+      ]
+    },
+    {
+      "name": "tf-deadline-list",
+      "description": "Bills, renewals, notice periods and expiring documents in date order, each with \"Today\", \"In 12 days\" or \"Overdue by 3 days\" in words.",
+      "attributes": [
+        {
+          "name": "items",
+          "description": "(DeadlineItem[])"
+        },
+        {
+          "name": "today",
+          "description": "The day to count from (default: now). Set it for server rendering and stable output. (Date | string | number)"
+        },
+        {
+          "name": "soon",
+          "description": "Days ahead that count as soon (default 14). (number)"
+        },
+        {
+          "name": "currency",
+          "description": "(string)"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name (default \"Deadlines\"). (string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/DeadlineList/"
+        }
+      ]
+    },
+    {
+      "name": "tf-policy-card",
+      "description": "One insurance policy: type and insurer, sum insured, premium, deductible, policy number, renewal date and status (active, pending, expiring, lapsed), with room for actions.",
+      "attributes": [
+        {
+          "name": "surface",
+          "description": "`\"glass\"`: translucent glass over a backdrop (`Ambient`, a photo, a map); `\"solid\"` opts out inside a glass `UIProvider`. (Surface)"
+        },
+        {
+          "name": "type",
+          "description": "The kind of insurance: \"Household contents\", \"Liability\" … (string)"
+        },
+        {
+          "name": "insurer",
+          "description": "(string)"
+        },
+        {
+          "name": "icon",
+          "description": "(IconName)"
+        },
+        {
+          "name": "tint",
+          "description": "(Tint)"
+        },
+        {
+          "name": "policy-number",
+          "description": "(string)"
+        },
+        {
+          "name": "mask-number",
+          "description": "Show only the last four characters of the policy number. (boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "coverage",
+          "description": "Sum insured: a number (money) or text (\"unlimited\"). (number | ReactNode)"
+        },
+        {
+          "name": "premium",
+          "description": "({ amount: number; period: \"month\" | \"quarter\" | \"year\" })"
+        },
+        {
+          "name": "deductible",
+          "description": "(number)"
+        },
+        {
+          "name": "renews",
+          "description": "(Date | string | number)"
+        },
+        {
+          "name": "status",
+          "description": "(\"active\" | \"pending\" | \"expiring\" | \"lapsed\")",
+          "values": [
+            {
+              "name": "active"
+            },
+            {
+              "name": "pending"
+            },
+            {
+              "name": "expiring"
+            },
+            {
+              "name": "lapsed"
+            }
+          ]
+        },
+        {
+          "name": "currency",
+          "description": "(string)"
+        },
+        {
+          "name": "actions",
+          "description": "Buttons at the foot (documents, report a claim …). (ReactNode)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/PolicyCard/"
+        }
+      ]
+    },
+    {
+      "name": "tf-coverage-matrix",
+      "description": "Life risks and whether a policy covers them: covered, partly or not covered, with the policy and a note, and a count of each above the table.",
+      "attributes": [
+        {
+          "name": "rows",
+          "description": "(CoverageRow[])"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name and caption (default \"Coverage\"). (string)"
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/CoverageMatrix/"
+        }
+      ]
+    },
+    {
+      "name": "tf-claim-timeline",
+      "description": "An insurance claim from report to payout: steps that are done, current, still to come or failed, with dates and notes, and the amount claimed.",
+      "attributes": [
+        {
+          "name": "title",
+          "description": "(string)"
+        },
+        {
+          "name": "meta",
+          "description": "Reference and insurer under the title. (ReactNode)"
+        },
+        {
+          "name": "amount",
+          "description": "(number)"
+        },
+        {
+          "name": "currency",
           "description": "(string)"
         },
         {
-          "name": "codes-text",
-          "description": "(string)"
+          "name": "steps",
+          "description": "(ClaimStep[])"
         }
       ],
       "references": [
         {
           "name": "Docs",
-          "url": "https://ui.twentyfirst.media/halo/components/TwoFactorSetup/"
+          "url": "https://ui.twentyfirst.media/halo/components/ClaimTimeline/"
         }
       ]
     },
     {
-      "name": "tf-color-field",
-      "description": "The ColorField component as a custom element.",
+      "name": "tf-document-list",
+      "description": "Important papers (IDs, contracts, policies, certificates) with category, holder and expiry: \"Expired\", \"Expires in 19 days\" or \"Valid until May 2031\".",
       "attributes": [
         {
-          "name": "label",
-          "description": "(ReactNode)"
-        },
-        {
-          "name": "value",
-          "description": "(string)"
+          "name": "documents",
+          "description": "(LifeDocument[])"
         },
         {
-          "name": "default-value",
-          "description": "(string)"
+          "name": "today",
+          "description": "The day to count expiry from (default: now). (Date | string | number)"
         },
         {
-          "name": "against",
-          "description": "(string | false)"
+          "name": "soon",
+          "description": "Days ahead that count as expiring soon (default 60). (number)"
         },
         {
-          "name": "hint",
-          "description": "(ReactNode)"
+          "name": "label",
+          "description": "Accessible name (default \"Documents\"). (string)"
         }
       ],
       "references": [
         {
           "name": "Docs",
-          "url": "https://ui.twentyfirst.media/halo/components/ColorField/"
+          "url": "https://ui.twentyfirst.media/halo/components/DocumentList/"
         }
       ]
     },
@@ -2322,12 +3057,7 @@
     {
       "name": "tf-typing-dots",
       "description": "The TypingDots component as a custom element.",
-      "attributes": [
-        {
-          "name": "label",
-          "description": "(string)"
-        }
-      ],
+      "attributes": [],
       "references": [
         {
           "name": "Docs",
@@ -3030,6 +3760,11 @@
         {
           "name": "current",
           "description": "(number)"
+        },
+        {
+          "name": "compact",
+          "description": "Numbers only, with the label of the current step (screen readers still hear every label). Narrow containers (up to 560px) get this on their own. (boolean)",
+          "valueSet": "v"
         }
       ],
       "references": [
@@ -3096,7 +3831,15 @@
         },
         {
           "name": "price",
-          "description": "(number | null)"
+          "description": "A number is formatted as money (0 = \"Free\", null = \"Let's talk\"); any other node is shown as it is, e.g. a placeholder (\"—\") or a price the app formatted itself. (number | null | ReactNode)"
+        },
+        {
+          "name": "price-prefix",
+          "description": "Before the price, e.g. \"from\". (ReactNode)"
+        },
+        {
+          "name": "price-note",
+          "description": "Under the price: net or gross, billed yearly, VAT note … (ReactNode)"
         },
         {
           "name": "was",
@@ -3132,6 +3875,14 @@
           "name": "disabled",
           "description": "Disable the button, e.g. while a checkout starts or when the plan cannot be picked. (boolean)",
           "valueSet": "v"
+        },
+        {
+          "name": "href",
+          "description": "The action as a link (checkout or sign-up page), with `linkAs` for a router's link. (string)"
+        },
+        {
+          "name": "link-as",
+          "description": "(ElementType)"
         }
       ],
       "references": [
@@ -3156,6 +3907,11 @@
         {
           "name": "delay",
           "description": "(number)"
+        },
+        {
+          "name": "animate",
+          "description": "`false`: show the value without counting (it is always the value on the server). (boolean)",
+          "valueSet": "v"
         }
       ],
       "references": [
@@ -3342,7 +4098,11 @@
       "attributes": [
         {
           "name": "crumbs",
-          "description": "(string[])"
+          "description": "A breadcrumb above the title (see `Breadcrumb`): labels, or items with `href`/`onClick`. ((string | Crumb)[])"
+        },
+        {
+          "name": "crumb-link-as",
+          "description": "The element crumb links render as, e.g. Next.js `Link`. (ElementType)"
         },
         {
           "name": "title",
@@ -3405,6 +4165,11 @@
           "name": "animate",
           "description": "(boolean)",
           "valueSet": "v"
+        },
+        {
+          "name": "stack",
+          "description": "Cards instead of columns when the table's box is narrow (up to 600px): every row stacks its cells, each with its column label. Without it narrow tables scroll sideways. (boolean)",
+          "valueSet": "v"
         }
       ],
       "references": [
@@ -3459,6 +4224,26 @@
           "name": "active",
           "description": "(boolean)",
           "valueSet": "v"
+        },
+        {
+          "name": "href",
+          "description": "Makes the row a link (with `linkAs` for a router's link). (string)"
+        },
+        {
+          "name": "link-as",
+          "description": "(ElementType)"
+        },
+        {
+          "name": "actions",
+          "description": "Buttons of the row's own (rename, remove …), outside the clickable area so nothing interactive is nested. Without `onClick` and `href` the row is not interactive at all. (ReactNode)"
+        },
+        {
+          "name": "title-lines",
+          "description": "Lines the title may take before it ends in an ellipsis (default: it wraps freely). (number)"
+        },
+        {
+          "name": "subtitle-lines",
+          "description": "Lines the subtitle may take (default 1); badges and facts wrap within them. (number)"
         }
       ],
       "references": [
@@ -4414,6 +5199,15 @@
             }
           ]
         },
+        {
+          "name": "action",
+          "description": "An interactive control at the end of the field (an `IconButton`: clear, copy, locate …). Unlike `suffix` it can be clicked, and it stays when the field shows an error or success mark. (ReactNode)"
+        },
+        {
+          "name": "reveal",
+          "description": "For `type=\"password\"`: a button that shows and hides the password (default true). (boolean)",
+          "valueSet": "v"
+        },
         {
           "name": "name",
           "description": "Field name inside a `Form`: the field shows that name's validation message. (string)"
@@ -4828,6 +5622,15 @@
           "description": "(boolean)",
           "valueSet": "v"
         },
+        {
+          "name": "clear-on-error",
+          "description": "Empties the cells when `error` turns on, ready for the next try (default true). (boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "ref",
+          "description": "`ref.current.reset()` empties the cells on demand. (Ref<OtpInputHandle>)"
+        },
         {
           "name": "label",
           "description": "(string)"
@@ -4869,6 +5672,15 @@
           "name": "multiple",
           "description": "(boolean)",
           "valueSet": "v"
+        },
+        {
+          "name": "disabled",
+          "description": "No picking or dropping; the list stays visible. (boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "name",
+          "description": "Takes part in a surrounding form under this name: the listed files are submitted with it. (string)"
         }
       ],
       "references": [
@@ -5449,11 +6261,33 @@
         },
         {
           "name": "shortcut",
-          "description": "(string)"
+          "description": "The key hint, e.g. \"⌘K\" (hidden on touch screens). (string)"
+        },
+        {
+          "name": "bind-shortcut",
+          "description": "⌘/Ctrl + the hint's last key (K for \"⌘K\") focuses the field, except while typing elsewhere. (boolean)",
+          "valueSet": "v"
         },
         {
           "name": "value",
           "description": "(string)"
+        },
+        {
+          "name": "default-value",
+          "description": "(string)"
+        },
+        {
+          "name": "name",
+          "description": "(string)"
+        },
+        {
+          "name": "auto-focus",
+          "description": "(boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "input-props",
+          "description": "For a search with suggestions (combobox): role, aria-controls, aria-activedescendant … (InputHTMLAttributes<HTMLInputElement>)"
         }
       ],
       "references": [
@@ -5592,6 +6426,18 @@
           "description": "(boolean)",
           "valueSet": "v"
         },
+        {
+          "name": "size",
+          "description": "`sm`: a compact trigger, e.g. a sort menu next to a heading. (\"sm\" | \"md\")",
+          "values": [
+            {
+              "name": "sm"
+            },
+            {
+              "name": "md"
+            }
+          ]
+        },
         {
           "name": "label",
           "description": "(string)"
@@ -5828,7 +6674,15 @@
         },
         {
           "name": "start",
-          "description": "(number)"
+          "description": "First image when uncontrolled. (number)"
+        },
+        {
+          "name": "index",
+          "description": "The shown image (controlled, 0-based), with `onIndexChange`. (number)"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name of the gallery (default \"Images\"), e.g. the listing's title. (string)"
         },
         {
           "name": "ratio",
@@ -5955,7 +6809,15 @@
       "attributes": [
         {
           "name": "items",
-          "description": "(string[])"
+          "description": "The trail; the last one is the current page. Items with `href` are links, with `onClick` buttons. ((string | Crumb)[])"
+        },
+        {
+          "name": "link-as",
+          "description": "The element links render as (default `a`), e.g. Next.js `Link`. (ElementType)"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name of the navigation (default \"Breadcrumb\"). (string)"
         }
       ],
       "references": [
@@ -5980,6 +6842,14 @@
         {
           "name": "default-page",
           "description": "Start page when uncontrolled (default 1). (number)"
+        },
+        {
+          "name": "link-as",
+          "description": "The element links render as (default `a`), e.g. Next.js `Link`. (ElementType)"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name of the navigation (default \"Pagination\"), e.g. \"Search results pages\". (string)"
         }
       ],
       "references": [
@@ -6031,7 +6901,7 @@
     },
     {
       "name": "tf-sidebar",
-      "description": "App navigation down the side: groups with headings, counts, one level of nested pages and a collapsed mode with icons only.",
+      "description": "App navigation down the side: groups with headings, counts and badges, one level of nested pages, links, item menus and a collapsed mode with icons only.",
       "attributes": [
         {
           "name": "groups",
@@ -6041,6 +6911,21 @@
           "name": "current",
           "description": "Id (or label) of the current page. (string)"
         },
+        {
+          "name": "variant",
+          "description": "`floating` (default): a card with rounded corners and a shadow. `attached`: full height, flush with the edge of the screen, divided by a line. `shell`: on the dark frame of `AppShell`. (\"floating\" | \"attached\" | \"shell\")",
+          "values": [
+            {
+              "name": "floating"
+            },
+            {
+              "name": "attached"
+            },
+            {
+              "name": "shell"
+            }
+          ]
+        },
         {
           "name": "collapsed",
           "description": "Icons only. (boolean)",
@@ -6051,17 +6936,52 @@
           "description": "(boolean)",
           "valueSet": "v"
         },
+        {
+          "name": "storage-key",
+          "description": "Remember the collapsed state in the browser under this key. (string)"
+        },
+        {
+          "name": "shortcut",
+          "description": "⌘B (Ctrl+B) collapses and expands the sidebar, except while typing in a field. (boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "link-as",
+          "description": "The element items with an `href` render as (default `a`), e.g. Next.js `Link`. (ElementType)"
+        },
+        {
+          "name": "mobile-open",
+          "description": "On phones (up to 760px wide): whether the drawer is open (controlled). (boolean)",
+          "valueSet": "v"
+        },
         {
           "name": "header",
-          "description": "Top of the sidebar (brand, workspace switcher). (ReactNode)"
+          "description": "Top of the sidebar (brand, `WorkspaceSwitcher`); a function gets the collapsed state. (ReactNode | ((state: { collapsed: boolean }) => ReactNode))"
         },
         {
           "name": "footer",
-          "description": "Bottom of the sidebar (account, settings). (ReactNode)"
+          "description": "Bottom of the sidebar (`UserMenu`, settings); a function gets the collapsed state. (ReactNode | ((state: { collapsed: boolean }) => ReactNode))"
+        },
+        {
+          "name": "as",
+          "description": "`nav` (default) for app navigation. `aside` for filters, settings or other tools beside the content: a complementary region instead of a navigation landmark. (\"nav\" | \"aside\")",
+          "values": [
+            {
+              "name": "nav"
+            },
+            {
+              "name": "aside"
+            }
+          ]
+        },
+        {
+          "name": "collapsible",
+          "description": "Offers the collapse button and the icons-only mode (default true; filters usually set false). (boolean)",
+          "valueSet": "v"
         },
         {
           "name": "label",
-          "description": "Accessible name of the navigation. (string)"
+          "description": "Accessible name of the navigation (or the aside). (string)"
         }
       ],
       "references": [
@@ -6071,6 +6991,51 @@
         }
       ]
     },
+    {
+      "name": "tf-user-menu",
+      "description": "The signed-in account at the foot of a sidebar: avatar, name and email, opening a menu with profile, settings and sign-out.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "(string)"
+        },
+        {
+          "name": "email",
+          "description": "(string)"
+        },
+        {
+          "name": "avatar",
+          "description": "Picture URL; initials otherwise. (string)"
+        },
+        {
+          "name": "items",
+          "description": "The menu: profile, settings, sign out … ((MenuItem | \"-\")[])"
+        },
+        {
+          "name": "compact",
+          "description": "Only the avatar (a collapsed sidebar). (boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "side",
+          "description": "Where the menu opens (default `top`, for the foot of a sidebar). (\"top\" | \"bottom\")",
+          "values": [
+            {
+              "name": "top"
+            },
+            {
+              "name": "bottom"
+            }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://ui.twentyfirst.media/halo/components/UserMenu/"
+        }
+      ]
+    },
     {
       "name": "tf-connection-card",
       "description": "Connected services and the live connection: ConnectionCard and ConnectionBanner.",
@@ -6810,6 +7775,11 @@
               "name": "md"
             }
           ]
+        },
+        {
+          "name": "block",
+          "description": "Fills the width and shares it evenly; labels end in an ellipsis when space runs short. (boolean)",
+          "valueSet": "v"
         }
       ],
       "references": [
@@ -7272,7 +8242,7 @@
       "attributes": [
         {
           "name": "brand",
-          "description": "(string)"
+          "description": "The product name, or a node (a logo mark with the name). (ReactNode)"
         },
         {
           "name": "tag",
@@ -7318,6 +8288,25 @@
         {
           "name": "bottom",
           "description": "(RailItem[])"
+        },
+        {
+          "name": "expanded",
+          "description": "Names next to the icons (controlled); every button has a tooltip while collapsed. (boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "default-expanded",
+          "description": "(boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "toggle",
+          "description": "A button at the foot that expands and collapses the rail. (boolean)",
+          "valueSet": "v"
+        },
+        {
+          "name": "label",
+          "description": "Accessible name of the rail (default \"Tools\"). (string)"
         }
       ],
       "references": [
@@ -7375,9 +8364,30 @@
           "name": "bottom",
           "description": "Bar along the bottom edge (dock, playback, a summary). (ReactNode)"
         },
+        {
+          "name": "controls",
+          "description": "Controls of the background (zoom, compass, locate) in the free corner above the bottom bar. (ReactNode)"
+        },
+        {
+          "name": "attribution",
+          "description": "Source notes of the background (map attribution), under `controls`, clear of every slot. (ReactNode)"
+        },
+        {
+          "name": "start-width",
+          "description": "Width of the start column (default 320px) and of the end column (default 340px). (number | string)"
+        },
+        {
+          "name": "end-width",
+          "description": "(number | string)"
+        },
+        {
+          "name": "end-sheet",
+          "description": "Below 720px of width the end slot becomes a bottom sheet over the background, with a handle that expands and collapses it (default true). `false` stacks it with the others. (boolean)",
+          "valueSet": "v"
+        },
         {
           "name": "height",
-          "description": "Height of the layout (default 640). Below 720px of width the slots stack: top, start, end, bottom. (number | string)"
+          "description": "Height of the layout (default 640). Below 720px of width the slots stack: top, start, end, bottom. The layout sets `--floating-safe-top/-start/-end/-bottom` (px) to the space its slots take, so map libraries can keep their own controls clear of them. (number | string)"
         },
         {
           "name": "surface",
@@ -7440,7 +8450,7 @@
         },
         {
           "name": "brand",
-          "description": "(string)"
+          "description": "The product name, or a node (a logo mark with the name; collapsed sidebars show it whole). (ReactNode)"
         },
         {
           "name": "tag",
@@ -7486,6 +8496,34 @@
         {
           "name": "rail-bottom",
           "description": "(RailItem[])"
+        },
+        {
+          "name": "navigation",
+          "description": "`top` (default): navigation in the top bar, tools in the side rail. `sidebar`: a labelled sidebar on the frame, with groups, nesting and a drawer on phones. (\"top\" | \"sidebar\")",
+          "values": [
+            {
+              "name": "top"
+            },
+            {
+              "name": "sidebar"
+            }
+          ]
+        },
+        {
+          "name": "sidebar-groups",
+          "description": "With `navigation=\"sidebar\"`: groups instead of the flat `nav` list. (SidebarGroup[])"
+        },
+        {
+          "name": "sidebar",
+          "description": "With `navigation=\"sidebar\"`: more sidebar props (collapsed, storageKey, shortcut, linkAs …). (Partial<Omit<SidebarProps, \"variant\" | \"groups\">>)"
+        },
+        {
+          "name": "workspaces",
+          "description": "With `navigation=\"sidebar\"`: the workspace switcher at the top instead of the brand. (WorkspaceSwitcherProps)"
+        },
+        {
+          "name": "user-menu",
+          "description": "The account menu's entries (with `navigation=\"sidebar\"` at the foot of the sidebar). ((MenuItem | \"-\")[])"
         }
       ],
       "references": [
@@ -7559,7 +8597,7 @@
         },
         {
           "name": "categories",
-          "description": "({ id: string; label: string; text?: string; required?: boolean; default?: boolean; }[])"
+          "description": "({ id: string; label: string; /** What the category covers; may hold a link to the details. */ text?: ReactNode; required?: boolean; default?: boolean; }[])"
         },
         {
           "name": "open",
@@ -7570,6 +8608,11 @@
           "name": "inline",
           "description": "(boolean)",
           "valueSet": "v"
+        },
+        {
+          "name": "equal-choice",
+          "description": "\"Only necessary\" and \"Accept all\" with the same weight (both secondary buttons), as German data protection authorities expect on the first layer. (boolean)",
+          "valueSet": "v"
         }
       ],
       "references": [