altitude-design 0.4.0 → 0.4.2

package/dist/guidance/components/Tree/README.md

@@ -84,3 +84,88 @@ The data, the writes and their concurrency guards, and the removal policy (recov
 The `Tree` section of `build/previews.txt` is a page tree with a toolbar; the demo service rejects names over 40 characters and moves out of Archive. `node checks/tree.mjs` (from `build/`; `ALT_FIXTURE_ROOT` selects React 19 fixtures) covers the APG keys and RTL, rename (cancel, rejection, save), create (sibling and child), keyboard carry (up, down, indent, outdent, cancel, drop, a rejected move, `canDrop`), Alt+↓, Delete with focus repair, pointer carry into a closed node (spring-loaded) and onto a slot, and 320/960px layouts in both schemes under reduced motion, forced colours and `contrast="more"`.
 **On touch.** With `onMove`, a swipe on a row scrolls; a press-and-hold picks it up, then a drag moves it.
 
+<!-- example: generated from build/previews.txt by build/previews.mjs. Edit the preview, not this section. -->
+## Example
+
+`Tree` as first used in its preview:
+
+```tsx
+import { Tree } from 'altitude-design';
+
+<Tree ref={tree} aria-label="Pages" items={pages} getKey={p => p.id} getLabel={p => p.title} getChildren={p => p.children} hasChildren={p => !!p.children}
+  expanded={expanded} onExpandedChange={setExpanded} selected={selected} onSelectedChange={setSelected}
+  renderItem={p => <><span className="tree-demo-icon" aria-hidden="true">{p.children ? <FolderIcon /> : <PageIcon />}</span>{p.title}</>}
+  onRename={async (page, title) => { await treeWait(250); if (title.length > 40) return { ok: false, error: 'Use 40 characters or fewer.' }; setPages(list => treeRename(list, page.id, title.trim())); return { ok: true }; }}
+  canDrop={({ to }) => to.parentId === null || !!treeFind(pages, to.parentId).page.children}
+  onMove={async ({ id, to }) => {
+    await treeWait(250);
+    // The demo service refuses to move anything out of Archive.
+    if (treeFind(pages, id).parent === 'archive' && to.parentId !== 'archive') return { ok: false, error: 'Archived pages can’t be moved out of Archive.' };
+    setPages(list => { const page = treeFind(list, id).page; return treeInsert(treeRemove(list, id), to.parentId, to.index, page); });
+    return { ok: true };
+  }}
+  onCreate={async ({ parentId, index, name }) => { await treeWait(250); const page = { id: 'new-' + ++seq.current, title: name }; setPages(list => treeInsert(list, parentId, index, page)); return { ok: true, value: page }; }}
+  onRemove={page => setPages(list => treeRemove(list, page.id))} />
+```
+
+The full preview, as rendered in Storybook and checked in CI (`tree-demo`, `tree-demo-tools`, `tree-demo-icon`, `tree-demo-panel` are the preview page's own layout classes, not Altitude's):
+
+```tsx
+import * as React from 'react';
+import { Button, Tree } from 'altitude-design';
+
+const TREE_SEED = [
+  { id: 'brand', title: 'Brand', children: [
+    { id: 'logo', title: 'Logo usage' }, { id: 'colour', title: 'Colour' }, { id: 'type', title: 'Typography' } ] },
+  { id: 'product', title: 'Product', children: [
+    { id: 'roadmap', title: 'Roadmap' },
+    { id: 'specs', title: 'Specs', children: [{ id: 'search', title: 'Search' }, { id: 'billing', title: 'Billing' }] } ] },
+  { id: 'archive', title: 'Archive', children: [] },
+  { id: 'handbook', title: 'Team handbook' },
+];
+const treeWait = ms => new Promise(resolve => setTimeout(resolve, ms));
+// Pure helpers over the nested pages: find, remove, insert.
+const treeFind = (list, id, parent = null) => { for (const [i, p] of list.entries()) { if (p.id === id) return { page: p, parent, index: i }; const hit = p.children && treeFind(p.children, id, p.id); if (hit) return hit; } return null; };
+const treeRemove = (list, id) => list.filter(p => p.id !== id).map(p => p.children ? { ...p, children: treeRemove(p.children, id) } : p);
+const treeInsert = (list, parentId, index, page) => parentId === null ? [...list.slice(0, index), page, ...list.slice(index)]
+  : list.map(p => p.id === parentId ? { ...p, children: [...(p.children || []).slice(0, index), page, ...(p.children || []).slice(index)] } : p.children ? { ...p, children: treeInsert(p.children, parentId, index, page) } : p);
+const treeRename = (list, id, title) => list.map(p => p.id === id ? { ...p, title } : p.children ? { ...p, children: treeRename(p.children, id, title) } : p);
+const FolderIcon = () => <svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.4"><path d="M2 4.5h4l1.5 1.5H14v6.5H2z" /></svg>;
+const PageIcon = () => <svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.4"><path d="M4 2h5l3 3v9H4z" /><path d="M9 2v3h3" /></svg>;
+
+export default function App() {
+  const [pages, setPages] = React.useState(TREE_SEED);
+  const [expanded, setExpanded] = React.useState(['brand', 'product']);
+  const [selected, setSelected] = React.useState('roadmap');
+  const tree = React.useRef(null);
+  const seq = React.useRef(0);
+  const current = selected && treeFind(pages, selected);
+  return <div className="tree-demo">
+    <div>
+      <div className="tree-demo-tools">
+        <Button size="sm" variant="ghost" onClick={() => tree.current.startCreate(current && current.page.children ? current.page.id : current ? current.parent : null)}>New page</Button>
+        <Button size="sm" variant="ghost" disabled={!current} onClick={() => tree.current.startRename(selected)}>Rename</Button>
+      </div>
+      <Tree ref={tree} aria-label="Pages" items={pages} getKey={p => p.id} getLabel={p => p.title} getChildren={p => p.children} hasChildren={p => !!p.children}
+        expanded={expanded} onExpandedChange={setExpanded} selected={selected} onSelectedChange={setSelected}
+        renderItem={p => <><span className="tree-demo-icon" aria-hidden="true">{p.children ? <FolderIcon /> : <PageIcon />}</span>{p.title}</>}
+        onRename={async (page, title) => { await treeWait(250); if (title.length > 40) return { ok: false, error: 'Use 40 characters or fewer.' }; setPages(list => treeRename(list, page.id, title.trim())); return { ok: true }; }}
+        canDrop={({ to }) => to.parentId === null || !!treeFind(pages, to.parentId).page.children}
+        onMove={async ({ id, to }) => {
+          await treeWait(250);
+          // The demo service refuses to move anything out of Archive.
+          if (treeFind(pages, id).parent === 'archive' && to.parentId !== 'archive') return { ok: false, error: 'Archived pages can’t be moved out of Archive.' };
+          setPages(list => { const page = treeFind(list, id).page; return treeInsert(treeRemove(list, id), to.parentId, to.index, page); });
+          return { ok: true };
+        }}
+        onCreate={async ({ parentId, index, name }) => { await treeWait(250); const page = { id: 'new-' + ++seq.current, title: name }; setPages(list => treeInsert(list, parentId, index, page)); return { ok: true, value: page }; }}
+        onRemove={page => setPages(list => treeRemove(list, page.id))} />
+    </div>
+    <div className="tree-demo-panel" aria-live="polite">
+      <h3>{current ? current.page.title : 'No page selected'}</h3>
+      <p>F2 renames. Ctrl+Enter adds a page after, Ctrl+Shift+Enter one inside. Space picks a page up: arrows move it, → puts it inside the page above, Space drops. Or drag it onto a folder.</p>
+    </div>
+  </div>;
+}
+```
+<!-- /example -->

package/dist/guidance/index.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "altitude-design",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "entry": "README.md",
   "design": "visual/README.md",
   "patterns": [
@@ -1124,131 +1124,131 @@
     "build/fixtures/patterns/screen-layout-report.jsx": "5de2691104456175ef51d2e1d11c85b4075341457e8acd3d5495615c2fbeb0a9",
     "build/fixtures/patterns/settings.jsx": "92b9b472351f9a8a3479ab04f7890b1b3cbc356cf81926ff0c280f1bdbf0c435",
     "build/fixtures/patterns/sync.jsx": "8474f762f7c63c4bd99fd337b080df1a788b4b92b2ced7fac5aaa1379b1a1eaf",
-    "build/previews.txt": "e1b5eac09bf3f1c7d450f24d4574bb705dbf68c1977d43568168847194cd915c",
+    "build/previews.txt": "7f225e10b65eb4bc0b970d8a5030bad6632a335aa01c28ae7f9bb2a780b98869",
     "docs/framework/AGENT-SETUP.md": "57b4ba98719fce472e08226a5c784ed4b9eb20241904445825cb2287a84a0162",
     "project/ActionsInPlace.md": "448046810f619210c2d378d97f072722828736c99247c3436ef01edebc3d8885",
     "project/Charts.md": "9439a024d8123088f90bb49844f922ce50ba4f255d85e7e6324bb55eee07f287",
-    "project/Distinctiveness.md": "a6244e88ac53b5bc016dc9de8738c27585b2f461f50ad7557829f67d35620455",
+    "project/Distinctiveness.md": "d2933b1d4c53622c31906154beca9edd89d457baa94fb4be3ae0fb8d414e76ce",
     "project/Elevation.md": "100532c631803e9a97018b9da5ffff60acf7d80559f9f162ba9e371f5510371f",
     "project/Fundamentals.md": "65120fd170ff8ea9f50b1498bfedc8c45dbe1a616bfccc32664213e5404d3a32",
     "project/Mobile.md": "511db58119a1653c2c00e2ccb34c6cf943de93f2184dec0faf3228f563e0b1b7",
     "project/Motion.md": "7fa4e7501b710a5599c7a8c99e531f2b9b1b4dfeba6a6a4d9716685d45f33d31",
     "project/README.md": "e6fe7ec7cb0a4290a8005daa0ff4db3654d1f1b4a69598f5c46b6722c86d737e",
-    "project/Research.md": "ca9931eb15547b86cff525126cba2a09e6e0751ad2739a60f453c83ed8d84216",
+    "project/Research.md": "d77743a7292796b51cd7445c527936cd3889eb4b7446ee6208a3d0c954bb4c43",
     "project/Theming.md": "74aef9d0e908fcd908fe7351f0c9248666772385582ef02b4c53f09ccd7634c5",
-    "project/components/AILabel/README.md": "6eb2832d83e566c9b3ca8171209ae44e5c61a9b1ba9019807c86984ed83c38d2",
-    "project/components/Accordion/README.md": "fadd416b532396343e5ea3de073e2f7ea4fe3bf1985fe335fbff41db70efec18",
-    "project/components/AgentFleet/README.md": "1904b52428b2ba7a07f45083cbdaf3efdcc3e8615fbbed8d62582834540c7d53",
-    "project/components/AgentLanes/README.md": "d76e1ecc559188657b3135511184bc6f25d0a4eb69b53e9d244516264a02e536",
-    "project/components/AgentRequests/README.md": "7fd1f7c471652804e672c29c4d8598b13451ad36c77af6ef8e7d1bc7680df8b7",
-    "project/components/Alert/README.md": "9eb739971b0ec48eb1b30614e3dd4f4b78452cee38ef092dd21d378d6632c3b3",
-    "project/components/AltitudeProvider/README.md": "adfa3ee3f28f7721c831f486c14f1a5d3b8091b9a82d067958d712cbc9aeb5f5",
-    "project/components/AppShell/README.md": "cb3f4eb307beb50337eed2e76465b0a62a61e4b91e8aa6df80645dfa8ea11424",
-    "project/components/AreaChart/README.md": "96725b84692a23ece5a1cc49ad1d85bf57e10c9e3d5c21d2f222f97b4f0f51dd",
-    "project/components/Artifact/README.md": "d5f1b9525200d61889d9438aebab00240220b969e7a7707c402f114d21e6fb64",
-    "project/components/Avatar/README.md": "92065b3e98a762758e7b80c8ec7832f206b78323f9ad3448ca719ec78905ab76",
-    "project/components/Await/README.md": "301a48444e30d820d17dd5d369e42791e66ea022f730823c1301fb68e17b837c",
-    "project/components/Badge/README.md": "01f422733af464ddbf8822bc743aad89c92ff69abae22fcfb0fbbf126e342c63",
-    "project/components/BarChart/README.md": "5aded17c65bebd7ed808689da9e90234825020ed3d7ee764e8240fb53c422ac9",
-    "project/components/BarList/README.md": "5e06f155ae8f761b686c8c5921b26fd7d618bf6f7094c572038a1a7eaf219aba",
-    "project/components/Board/README.md": "e09e6fc636a4f23baa50e9af1981b0289d15980c9397094b09d2f966527c96e1",
-    "project/components/Breadcrumb/README.md": "087330ef2001d57b852eb59677f6881806724c00526638538a3aa2b5fb98fe33",
-    "project/components/Button/README.md": "121911e619a0f4f443685a6a5fe88a5298b9f3545c970f6dbe18fe3b621edd4f",
-    "project/components/Card/README.md": "b250515658f0860afc873da4166714a46c5a7f234105a7f573fd46e384467774",
-    "project/components/ChartBrush/README.md": "70933e501f03121cfb1586a2e5df954377588284716c4bd5bbcaf40534b009f8",
-    "project/components/ChartContainer/README.md": "be403942ab4c29592c1cd00784e1ee76f91ea38ed2d15460330d5826fc9f508d",
-    "project/components/ChartLegend/README.md": "3954d3c2f9f27d23129c6e6faaaa48915d0629fe2acfb87bf808c53fb0dd61a4",
-    "project/components/ChartReference/README.md": "b2fa0a093e92a12debe8e2e1a431464bdecc0ef053dde1d9b428977f5cddf6d1",
-    "project/components/ChartTooltip/README.md": "749ba5efca7dfa539800148f8eeac3db86981f1a64cc74a83041c040f27d0130",
-    "project/components/Checkbox/README.md": "7d6b46ff1853fd63b0a99971debadf38ac29c97d632f6917e2b8b08879b83d49",
-    "project/components/Checklist/README.md": "7710216c6463bd46eb10045372403d2b4cdb7ed9ab539f83ee9788303fe723d0",
-    "project/components/CodeBlock/README.md": "46a52496b46637c3b96a667d4788cfee7b938eb99101d085357a2094934d3606",
-    "project/components/ColorPicker/README.md": "5c43d2a038db4435aafecee0e4d8a974b6bb1053d0032a73f3ab09d83b09c824",
-    "project/components/Combobox/README.md": "e021593053dfb8c99dd958343cfdc930bac4420916d4f319d70aece6aa7767a9",
-    "project/components/CommandPalette/README.md": "eb2fe4c0c2f13301e98b05f60882dc6e8118ba3ecdbca89b1057339b4205f319",
-    "project/components/CommentThread/README.md": "057e4c346df7884b47f7067e92f1119ae835d440bba5fdb7c094d8aacaed8c93",
-    "project/components/Confirmation/README.md": "31262bd79619254f66385c3876987a2cdf32be99d9ed6691d228eeb2b812eef0",
-    "project/components/ContextMenu/README.md": "a683432817d23ac2861358e4855305cae7f343a265dfda5712a1d3a45b8aa356",
-    "project/components/Conversation/README.md": "9c6eb11b1db887400858e752a5d5260c3aa969151315af83e6939c1512bd9610",
-    "project/components/CopyButton/README.md": "f9e40379cf7c83e6db85d09e015d828da3eaf06ec326de17709654bd14a29352",
-    "project/components/DataGrid/README.md": "716ce973b96d4c547f7204d6f830c198f758fe3abaf3c07e7112496da119d7d3",
-    "project/components/DatePicker/README.md": "40a024df35884fe6e9c2714ce5a312ce3be36a9c7fa313469a85214f7be05d63",
-    "project/components/Dialog/README.md": "f5ac2e51202042ff5b7328c61c79d63fb795f5182d20189033027a8f9e0c6f3c",
-    "project/components/DiffView/README.md": "e4153b84adb889c8d966c7c7562eb54ddf92a40ca50d0016f1ce0e20d3866acc",
-    "project/components/DotPlot/README.md": "0000f0ae51f6f45bd0669ff0fb8f8afdcd1649669fc00e062d68b5d8535f590a",
-    "project/components/Drilldown/README.md": "9049c54b5ffa6b12d4ff21ca5eb531e8ad115ebdabab285b90c0e3997e67ec35",
-    "project/components/DropZone/README.md": "5152a59df97da2615d075122330b32720fd1929cfa3907d6f56b94147643d59f",
-    "project/components/DropdownMenu/README.md": "45d43c0e1c3d59744fef3d60a01c9c911dc6c0c00eb2f43d27c77db06bcaf9f8",
-    "project/components/EditRegion/README.md": "7e158150c4c943ba3e074ac2f9866a82ace664ebea90dea620dc112092e83fb0",
-    "project/components/EmptyState/README.md": "17822c06a75164d7d6fcaabc1f9812a55943718eedd2adb50bc704402b1c2548",
-    "project/components/FeatureGate/README.md": "0ba1421e2d0028260fa6905aa4c995a5480fa335158955403e174d2f36f29a97",
-    "project/components/Field/README.md": "d0f0354c4095084e5a58bd3a463848b6cb58892dab37691ded9808be0bb5cd32",
-    "project/components/FilterBar/README.md": "80a1b902620dfac130bfa265f1239fb8b0e61c94a04b7af5476331b6e43beb10",
-    "project/components/FormattedNumber/README.md": "667ad4454d009b3be6f085b4f00e03fbe7adf2b5dd3277e4067ba8bfeeca704e",
-    "project/components/Heatmap/README.md": "3c8c42dd6fe27b0516263a3aced3efe0cbff5f7cd01ac2bd7530e9a9201eccfb",
-    "project/components/HoldButton/README.md": "6b5a06eb85d6b260e2f83443ab9c6a3ae5488650dbe5bd576cf556ffb968c302",
-    "project/components/HoverCard/README.md": "9232b93aee7df2e6ed01b63fda01868ce9a96b4a3c366a5f899f3fedc5c11110",
-    "project/components/InlineCitation/README.md": "7b8a2cb16c062cdadd5dc72309281ad780597879faf0790f80f7d408a9c3225d",
-    "project/components/InlineEdit/README.md": "fcb4a5f659857ce36ce1b89e1b069205a1c378fe5d63f1d164f046acc841327e",
-    "project/components/Input/README.md": "46724589bdcb75cb7252b62e5b15f16ad0a96a085db57505cb89014813688a1b",
-    "project/components/InputOTP/README.md": "13a7a8d230b02688fa2f51783756a842a550c51f029c9f8f5c9a17328634962a",
-    "project/components/ItemGroup/README.md": "41bfcf920ecead3c176cd264ff85d72100a41b953f64a718166b960991dbeb9d",
-    "project/components/Kbd/README.md": "1df0d0f71fd4c643fd060ad11e58c6037235d95c2786a2d2ff693404a9ccfe0d",
-    "project/components/LineChart/README.md": "a6527835e762989a3c8946c1341550a32c4d9fc66bd8cd7131e28801b1a4384b",
-    "project/components/Link/README.md": "3224830e0477ef585bb8e7c7d95e037eb85e20c41e0903b44016f71b3a80bc66",
-    "project/components/Markdown/README.md": "138bfdd419a48e52cd10541a7565a08197a1ffaf7403e7ad64ef238f49a8c259",
-    "project/components/Meter/README.md": "5f31d7281dd674e016bd1971ad43f4557a244bc94a516317923ff8ed708a3ef1",
-    "project/components/NotificationCenter/README.md": "c0f24c04167c6145d863dbc56ae929dfbce31c3fc3ffa73aa3886771a564bda4",
-    "project/components/NumberInput/README.md": "c1697e1bfae790da21ecb9f8319ace66e74c490a76ff285982f9a43eb6f4f111",
-    "project/components/PageHeader/README.md": "49d054eac089111cdbcd6be8a5678bd38679410b8ab7d8b0bc0743aad1b377b2",
-    "project/components/Pagination/README.md": "e0158fa78cb42f25ebb10ec5b3e62b0d0d8acb135041684a71c843275ca6bf09",
-    "project/components/PasswordInput/README.md": "b2f2dce48a2d778d753d9019a26f6c2e78228690e763883bfd3d87426c4219c8",
-    "project/components/PermissionMatrix/README.md": "7c861d7d47091e9c0f24129b535e7d65bf7bee2520194cf7371bc0fa12d16954",
-    "project/components/Pile/README.md": "989a74afd75cf4af3b7f8a4843edb7ddba325f7285b285e962ded77f78ab2e6d",
-    "project/components/PlanPicker/README.md": "8821d2a882554fba3133f57a259251fc80fa0952bf5984c848a4b3b1bfd47a7b",
-    "project/components/Popover/README.md": "69d96d27ff9bf74860730c62cc460521d104148f158a2a00456dce2e6bc94cc1",
-    "project/components/Progress/README.md": "f9c7c76bd4889fc80e46479564899db41bbc69e4afe7b3b0b2d199af8088b928",
-    "project/components/PromptInput/README.md": "15d50afc3532eca920d1247c52245aefb0df684174f652685d009bd4ce9b57c2",
-    "project/components/PropertyList/README.md": "a5a7c3363a37451abdf9a9e3c6b65b4287629e86576f18a6aaee5303820a0982",
-    "project/components/Question/README.md": "e3398d54fefa1bea955837abede36122d86a3058b3be8de51e59de88a52c21dc",
-    "project/components/RadioGroup/README.md": "1d0f5041c74c578c139a349cf58b443c97fca60f015c8a0e5f7562563f377262",
-    "project/components/RelativeTime/README.md": "80e330b381c9279763bc09c2431cafdfbfa1b482b76c8407bb621991ed57f808",
-    "project/components/RemovalReceipt/README.md": "c7025261b427d062662bd4967c107be98e888c6cdf4c455af18577658a6a680d",
-    "project/components/Resizable/README.md": "14b4d2b99b22043d8054f9d25ed81a6721b16d7c2b4c5913930aeb8c2356ce69",
-    "project/components/SaveBar/README.md": "ba893bd4a2d43e48f7ad5d84dbcb82b0493cd269f52b5fc2aed4462eb34c3fb0",
-    "project/components/SavedViews/README.md": "2b14933ccac394d861f372a85fd8c246d125c4d6fbe3349ce5e2b4a8f0831b91",
-    "project/components/ScatterChart/README.md": "d4135b0efe4e2384b44d3137fe297b87a2dcf93b20f1009cba9dab0db220279e",
-    "project/components/Schedule/README.md": "e74ccb8cff6a043f71d98bd4bf582efa857cfe381296e20c5f7eb70d4b832456",
-    "project/components/ScrollArea/README.md": "56279e17910a729cc98394e7b603598ef471bd136f011c81558d2824aa76a70d",
-    "project/components/SecretField/README.md": "9daab51e83168ffd2cf7d94d211b4396c1ad18d8c65072d0463e53401488fbfa",
-    "project/components/Select/README.md": "b5a172f48fb16d2c159f5629df003f233a5612f95a573dfa5062258cf1bfaab3",
-    "project/components/Separator/README.md": "91a6134fc286b07b68d5b40135e99b1d96671f768a5a203c5f32236c126f8434",
-    "project/components/Sheet/README.md": "effb4ee4345a947af723966d9590a8b6db0b55399f3fa06ae80dcb6e687233fe",
-    "project/components/Skeleton/README.md": "d1a5125fd0040b8ed43f9282114dc7d76ed7d272961c1521caa74ffeaa615f94",
-    "project/components/Slider/README.md": "2ea1350cd1d017529bb78a2976399d8a535d2d2846500b42fc956829868388cb",
-    "project/components/SortableList/README.md": "256d67224be0cce7c0c902c5b9b35ae15bf2358274db31f0e6aebbc9fe97283f",
-    "project/components/Sparkline/README.md": "b5c08553f2999f2ed553a6ab21c58bce29badfed5c1d66441bc6e0b93e319377",
-    "project/components/SplitButton/README.md": "6c019f5301f28fcdd06f087b2d6f9994f2e88a1b69e96552595e5ca53ecb32e7",
-    "project/components/Stat/README.md": "791546f532bdd0c3c09ae19985c0df7fe626556ff51abc234c78227b21341bfe",
-    "project/components/Stepper/README.md": "4b2357b035d4a816e615f810dd025bb3de185a6c6ddc246c357c0a31fc7b4c90",
-    "project/components/Suggestions/README.md": "45f9c00b1574fb8037c47a0ca919ed18bb5714db95d0e7144f309468c776a2cf",
-    "project/components/Surface/README.md": "69e53e3086f732b5274ae881b3b69269d77975ae696dd9a52121f26fd8312250",
-    "project/components/Switch/README.md": "c3428ca9f251d66cc80cefbd02aac59c69d54e818164cf52a52eec8f7d596489",
-    "project/components/SyncIndicator/README.md": "93bb03e01f9b1e6078b48dbff54368dc4e16e0fca835e6f04c42c3d0fbd36dd1",
-    "project/components/Table/README.md": "1cd16b6a17cbee8980636ebad08bcc2fd4f8f100d0cb2b0fad771c3342376521",
-    "project/components/Tabs/README.md": "6d83b79e0de188b6e36736d5fab05caf481935551cfbb64253a4c7ba27fcaf39",
-    "project/components/TagInput/README.md": "e8b290b1cb137bb8ec0f759a65c6d6935987152fa5781b5c755edf1f193266d3",
-    "project/components/Terminal/README.md": "87f8593569f6164d5c4bf376aed660942d35fcd190f54c9f9c2ffccc766365f6",
-    "project/components/ThreadList/README.md": "306b524672737ffe7c8605a8f2419ead9c39577835e6cac39b0574c633e6d8c5",
-    "project/components/TimeInput/README.md": "f409637dec70c90c71eb33d1faecba3930bdb33ba324530cbee8619b8cc2e021",
-    "project/components/Timeline/README.md": "af1be980a583502970916d79486bdf6c0af49cfe5fb4e3c6e2ed02392622da3f",
-    "project/components/Toaster/README.md": "d55093ef78bcf2f7dace40032bd593fd05c4d97baa3456c60670632cb8f70497",
-    "project/components/Toggle/README.md": "7135fb995f78779d4df28f9b565c7e36a9727e20017076eed025a82c9f18fa2d",
-    "project/components/Toolbar/README.md": "2a8b191e1d1b787dc010e661b9a81b1a54643131c12897b370963d6696e3da6c",
-    "project/components/Tooltip/README.md": "7945784f4df49c3a91409298b3e4c21d9d12cac25147edd8e8fd7c4669ff1b71",
-    "project/components/Tour/README.md": "17998e159e3be85baccd2531de56b976426effb4c3447ebbfcfc5a141c8debf0",
-    "project/components/Trace/README.md": "3858ccb296c8ea5fcabff874110a3216050a3a25f9578de39bc3f58ff93a6fe9",
-    "project/components/Tree/README.md": "98526698773dd61fcdee826eaf9d7113930aae64f0a7b00ffc9689dbd9a989ac",
+    "project/components/AILabel/README.md": "0002447d340029fe28652ed26c474c91edf89a0e23be300d24c198afb7086646",
+    "project/components/Accordion/README.md": "b166e499eb3604ef84a375818db3aec91c5459870b5d6cd3133ecbdf36e145d6",
+    "project/components/AgentFleet/README.md": "f76c32acd7f9442efe001513e7e29ae767587b4c97661e14e4067b28691e6260",
+    "project/components/AgentLanes/README.md": "6835f79a4353ff47196a0c73f4e73e4b396d403510dde4795f8495d7f80ccbf9",
+    "project/components/AgentRequests/README.md": "e7ac986cef68b09b5a7df7d1c11cf44ef8d417a3d22f9436f7cea1d8b4190c18",
+    "project/components/Alert/README.md": "552755412b216a34aee2bf0ad8338e4d4a38692f1dd998394ef5a6b1c895ec6b",
+    "project/components/AltitudeProvider/README.md": "6c0e37e29e3022e172f387493378a3f7e7ed8b13b9a197f5b53e0caab1c73286",
+    "project/components/AppShell/README.md": "9363def66ebd650300b940c71f716653b4960932836fd123aee25a6562fdf88f",
+    "project/components/AreaChart/README.md": "9b527345b1ad564d3364b6b5e2287ab998d0f8e1e9895723288b6c3a0753215b",
+    "project/components/Artifact/README.md": "37e3fe7e2d7dc20979f17c77b939e73b329a3a981dbe46a7ec480f2a072a5662",
+    "project/components/Avatar/README.md": "dc833eff628d6b850a82c910299dc29b6341ad51ee37566c1f9ed116447c45d6",
+    "project/components/Await/README.md": "bde547bfebfe8407e6bdeea68f4c8e5b228fd38189355cdaff485c0ec8a4c94f",
+    "project/components/Badge/README.md": "118520cbd5dca26aa4d048a429c1574467c25321e376f60e073daed0be875ea3",
+    "project/components/BarChart/README.md": "e7a68dca5e1ba3036aab25bc3ba434d60f6542032262bec41d2fc6c50d163b80",
+    "project/components/BarList/README.md": "96ec0d5cae26ce7bdeb995652cc4147d64caea14771f82e92dd0f56f002eed61",
+    "project/components/Board/README.md": "95402d7e6f4c76111a88e19f6dd7b762c900b7c5e7aa1ab14faf27ef870162e0",
+    "project/components/Breadcrumb/README.md": "fe28cfe23113fcfaf8842181bfa9f9274e192dd9421ec9ce992a53e7ebdf80c9",
+    "project/components/Button/README.md": "46ee13103d00c0435c00496fbcc25b909b63388e05f2a76b483d43e7619c74f3",
+    "project/components/Card/README.md": "74fe7bcd95c8600a506751f9ab7f6ebfa8691d7c207fd2e3c87c84a8b5292cb0",
+    "project/components/ChartBrush/README.md": "be1c113f9d7ffc5df62702a55f15ef5e096f9a2e832dd277a10b636001731c14",
+    "project/components/ChartContainer/README.md": "0484a48f808b4887ffde0c79f28e0714b9ee025d0795c224b2f2c302ddcfe62c",
+    "project/components/ChartLegend/README.md": "d43b549b613d5ad43b7acd97dbc1424a71d20393cfbbbf3efa8c053c2432285a",
+    "project/components/ChartReference/README.md": "d8e4c74c0a96c36c66acb05fe3c69245b56733b42e3c3e08786c78e4feabb94e",
+    "project/components/ChartTooltip/README.md": "f886a0a48b02504650c538926fbe55f763ff84122f0d3deee62cd8f1317f53e5",
+    "project/components/Checkbox/README.md": "14e1a4f795393a728ce0cb37949413ba30a480bbff583bcf3c0899544928c26d",
+    "project/components/Checklist/README.md": "3c61aacf437512760cc16b21aa9b54e7c1e1296b447743c1860a3bedb977c8bb",
+    "project/components/CodeBlock/README.md": "61789d26b28d6da47e566683d01bae3012d05ffe67e4bbf35ea784d5d359d12c",
+    "project/components/ColorPicker/README.md": "24a0f90b86d7b246976d8a41dc047c25bb4b6ccb80717f388783723f15497018",
+    "project/components/Combobox/README.md": "f19169c7453cba104859b28eb54e8ec0224bd6ab9263a28bca8bbb4be0c67151",
+    "project/components/CommandPalette/README.md": "a6bf308a4d791873cfedeaf190b422cd67ed4e6dbb7273f3b340f93432d7e741",
+    "project/components/CommentThread/README.md": "54134a30be5ac1d82f2036345869205d5d6003ca198e1d982c72bb2ef856806e",
+    "project/components/Confirmation/README.md": "c6ed60c3ae6c563da1a5473546d14986ecfe5ecf691794ee3e6d89e39f4e3ed4",
+    "project/components/ContextMenu/README.md": "ab86dfa366dd2bacc98e6b01b45cc6e9919301e680a1d19798a0902b1b23475a",
+    "project/components/Conversation/README.md": "13ad68c8d4c5a5687245d64136f413d3edc62ce06efcaa0a5771004157ec04f0",
+    "project/components/CopyButton/README.md": "edac13d1acbd4fe4d72f440ed62e5eb943c33545d3e6faac2d1368b6f8bab00c",
+    "project/components/DataGrid/README.md": "ff20e0a9b7408048cd3cb50a51e7c3f3a6f89956ce0696e310232e06f3060f9b",
+    "project/components/DatePicker/README.md": "6ffccef22967b52791d9f95e72058c0b78696253ceeec27ae067344313b4fda7",
+    "project/components/Dialog/README.md": "324138d32db8315e365130c0a91ddda686292e9296883b7baae8d11fd9fce538",
+    "project/components/DiffView/README.md": "da741f44cbe1a5fdc658eb5cb646b72b47fe03ea800f842fd80e7f8f074448bb",
+    "project/components/DotPlot/README.md": "2d8f7a05497ba960292f3eaa9bbb771b50fc6bf71e114be7f4056355d4071c8a",
+    "project/components/Drilldown/README.md": "55e4ba22622faa579d5fa48229326aeb3516dca10898a71c9b7e0849bb86271b",
+    "project/components/DropZone/README.md": "698ff35d2b385a3a52f70709943a42055f3c8e4d90e6c4f9e9caa90ea9df9912",
+    "project/components/DropdownMenu/README.md": "258867ad981fbeffd7d6e5eb95d0c298c49e8e2f5b5fc127709a23610152dc65",
+    "project/components/EditRegion/README.md": "747a5dbe65b441f7930bab3cefd6360b11a6f46e19f7a7da526dec282629a196",
+    "project/components/EmptyState/README.md": "f616d8545c10c13c88d1f2e0afd9b7cad9bd60c4cc3491f632e0969b887813dd",
+    "project/components/FeatureGate/README.md": "c1a46ba656b5102cf7018d376f227e662dd48b8b224a1215056a60beee44b3c5",
+    "project/components/Field/README.md": "cfa5b963b00a8796b9ea22eae8856bd74a87be3cf4d4ceb6341b538c411138e1",
+    "project/components/FilterBar/README.md": "b861538ae1f2b778547547d4b6491ddb28b69d850ed1672960c143ef6b341bf1",
+    "project/components/FormattedNumber/README.md": "9b9e315986e913f7cb995ce82831ac1bc8148ca5b2cbf94e7aa3d2f941e649a0",
+    "project/components/Heatmap/README.md": "b239a7a7914e634c4bcea47dda84b51633399890dfecb4839740d45c0ab344ba",
+    "project/components/HoldButton/README.md": "bb81a002a2d37701a84a04123fbabd8cb820c52befaacaaf881de48d12f733f5",
+    "project/components/HoverCard/README.md": "23e6de1b79fa302b2ce168431fd15339b33132663911521594882f338c1ca366",
+    "project/components/InlineCitation/README.md": "b3f66c18bdf054f818525fbcf5f5db36535d121289f6d0451413ac0803bf8edd",
+    "project/components/InlineEdit/README.md": "a5f0ffcd73799922f438969020ef95b033460c12c2e5087bbf990d03c9cdfa8f",
+    "project/components/Input/README.md": "e983162dc22da7fa9dc7968a2db83b32e93b1ab5ee8b063bf5c63ab12d63b03b",
+    "project/components/InputOTP/README.md": "e1a17bca55de012b26f25dca299d7ffe01b21248efde19bea63ebeac4e2625aa",
+    "project/components/ItemGroup/README.md": "82e405e1c7df827ef00fd19cacf9b30809455c6dbd25b00fd1419a826bb02eaf",
+    "project/components/Kbd/README.md": "05560bba1e4177115f7e23eb1e9103625be645ce0b87df64c46adaeea9fc1512",
+    "project/components/LineChart/README.md": "5739a14c274b40970fd30249212d38e09e79529018173f698d70361f2a6cb911",
+    "project/components/Link/README.md": "13f72832bd509b9b6ef3c91f79df2dc6919d5c34346772c73e8c63fb9cb99fc3",
+    "project/components/Markdown/README.md": "9d1d5a8ea10cd4f8765d0a21c0f8bd7bbf150643820761dd5fb3dcc52e224616",
+    "project/components/Meter/README.md": "dc4b0b799841f208b61346de2490cf4af6dcc23db6725b072c9deaa608ecda92",
+    "project/components/NotificationCenter/README.md": "1c2043460b688347daa214e15d2c83925c2e272dd6655efaf3074f3594214b80",
+    "project/components/NumberInput/README.md": "6c8d196acac254243b16090a8d80c41731d88c170f0b1a7eaf6d00a05c09d195",
+    "project/components/PageHeader/README.md": "eaa286d9c7c758b904df9a70aba802bdd405c3d49de788334992b40dc5451934",
+    "project/components/Pagination/README.md": "775a3d85740b66ca932a5e04deb17e922e4819d8318503edc3e54c6ed0ca0542",
+    "project/components/PasswordInput/README.md": "073c4d74e606bc0225e832a887c9f279193df0d60ca4855eaeeaf576d1f37935",
+    "project/components/PermissionMatrix/README.md": "3f5ca4cf91ec2c9e3803104052c4dedd7778646b2d7d5afd8389b3c9385df4f8",
+    "project/components/Pile/README.md": "7ba9aa587158b68816f8317917b6e22d39cce2e42f26aa53247496fc38d7fb09",
+    "project/components/PlanPicker/README.md": "d8f9d7d80d7bbba959de64e7f18496945ef73b17c388ee0f639f203470acec58",
+    "project/components/Popover/README.md": "5666b43b85c453ec4315572e9c15d2868674d7d7686ec118cbce64ae16fe53ac",
+    "project/components/Progress/README.md": "e5f98ebfe662db89d568111880bede453acc2e976ebe74185a9f3d73e71ce323",
+    "project/components/PromptInput/README.md": "f412dee8e40a650914e2c835cef003365dd41e483cfcd743df826c4682c8a532",
+    "project/components/PropertyList/README.md": "168872db3bd96e0b432a1f6b931f1330bad401dccfc94cc219b64cc9a64446a5",
+    "project/components/Question/README.md": "94ece55de57e9cc358bbbd34dbe7a7329eba451a7f2c22aa02fa4f1f1b8ed199",
+    "project/components/RadioGroup/README.md": "c0242621ae36b104d574a2df6ee650527bdcb64d37642f0cf4dd86cf16ec5ae9",
+    "project/components/RelativeTime/README.md": "5b1a7f716825233b457319c2398ba574419a757c2c92c11223dac5d64a9990a2",
+    "project/components/RemovalReceipt/README.md": "b5a0392079b5f0db25ea12fa1e40fc5a2b7415360e9c35ecf523462fa88adc66",
+    "project/components/Resizable/README.md": "c166d0af35119ec622919a7c274696deee465beb3b3a999e263d5ea9d248c1f1",
+    "project/components/SaveBar/README.md": "87661cb5efda0d3aadac7d89f503368ab54080faf902464af9f6d7ce31752aff",
+    "project/components/SavedViews/README.md": "1eb6996c7ba7b6fe2f680603f66c4dcb0b2e98b5901dfa1ad405fd967a2e3fab",
+    "project/components/ScatterChart/README.md": "73f447b83eea8093ffca91b260a71102bd4e5d7953b4028ffd005f29276bd8c6",
+    "project/components/Schedule/README.md": "cab13327ec2b8ff9c317dc19ac12390705f15f9f9d61b94c3bc52810cb54ce82",
+    "project/components/ScrollArea/README.md": "937763fcbccf2398129499fb092d12cedecd67fcc42d619bfb5c918491f4214c",
+    "project/components/SecretField/README.md": "5cd6cf1baa5e05b697e0c9a6adf46ef75dca8baee13a5922ecc18cd058ae9c12",
+    "project/components/Select/README.md": "7100be945a087376144b36d5011ae1802ad4c09775508b738266a3b2bf4ff3cb",
+    "project/components/Separator/README.md": "3e1ea97e6f94b61b9238d0574af5c3b89dc98739038685d47a2ec900b06f9b04",
+    "project/components/Sheet/README.md": "6ae67731f739ddf3252d8379d5abb1593841c5539025e79ab7503ec338d2ee3b",
+    "project/components/Skeleton/README.md": "1dfb1c66fb09ab7fa9cb1c215d3d23ec64f80426429a30208965c7926aac5ac6",
+    "project/components/Slider/README.md": "83d151670641cfa52bd575ad14539a5d28ba6fa0d53a6dfcbacd5653bb0a27a6",
+    "project/components/SortableList/README.md": "82895ed1a93de818ebf294886056e038060a159a44ae909b7ccd4c1ec5a9e463",
+    "project/components/Sparkline/README.md": "1b5955eac19ba5d13061c8ed94f687347d37a7d8d25e8f9def6a47cdc302f51b",
+    "project/components/SplitButton/README.md": "e31e9de4502d843ae073d708d6dcf0692f1cf18cace8fe4dbc76f001b0535546",
+    "project/components/Stat/README.md": "ea503b7e12456695a7d70e1d07bb2943e766e1a41e537f5e9215bc4d960d907f",
+    "project/components/Stepper/README.md": "6a836faca42ccc7549ac86da1639280af8f19e880685258e3df937c6e17d4981",
+    "project/components/Suggestions/README.md": "de81a3988cf3233ca80332c099fca06381a9ab6416df0a560bc1ce5f5e976489",
+    "project/components/Surface/README.md": "1e14fd015df7aeceaacccf8b94cdfebbc821ef30b98f11c5e8fbeb30744a9721",
+    "project/components/Switch/README.md": "42402b1097acd4b84192d7ae9e7e4813d3a09d6c0fa76f8922e2ffa4f8abc66a",
+    "project/components/SyncIndicator/README.md": "55f1c197d822a97903a5590a72a4006b371a41fe5ac876f66ac395493ac4b0f8",
+    "project/components/Table/README.md": "e29d07664e06255add18ae88851a9fcd6f65f490d3dcbb62759109a384bf3aee",
+    "project/components/Tabs/README.md": "67ac2cff922ad2834a4dbc34255233c86106cb4db4757a3af485cc320e74dccd",
+    "project/components/TagInput/README.md": "767384532997c2d20b8e545d5a7f34ed8c33605a4167d22fff2eef38ef4db139",
+    "project/components/Terminal/README.md": "78921ce1351076df794075b563c3be6b5e36d4e0d0dea29d7bfa4e4414905ace",
+    "project/components/ThreadList/README.md": "d80cae5c14607e62edde48ccc281857c511c010c2393e1b5ad3b1a01ea20eae2",
+    "project/components/TimeInput/README.md": "38cefa3218caf4b1e327ef94e167e62834f07ac43a80aeeb522ed1630ab015fd",
+    "project/components/Timeline/README.md": "95daf26d1e2f1072f74ed0e3a3b6792468824cf1135dfa132dcce0081094aba8",
+    "project/components/Toaster/README.md": "0a4880d4de44302c66492130bbb59712f8ffa890d2b44adbcc8e3c380c92162c",
+    "project/components/Toggle/README.md": "436a2a35daaf0cb7a7750bcabbebc17731ce04565268ba3dd67dc48742eea181",
+    "project/components/Toolbar/README.md": "b40dea791d70f301a8b62317473a6f40962707164e57ecd41b6e46514925911d",
+    "project/components/Tooltip/README.md": "851245aab0a9f6e7b8aa111a7000b783a9656637bac5b50f332feb2c6a69e72b",
+    "project/components/Tour/README.md": "ecb436c7753b2d5d5d44255f04a833cea73041cf91287aac50c7519520ca2747",
+    "project/components/Trace/README.md": "62c571b2d96a83e5515988eacecd47de3e2c1a2452476d00645d1a26d3cbae3d",
+    "project/components/Tree/README.md": "9fadf66c7d223653bd299362e997c814f06baf2a9c59f8ebc15ef9a0a24235e4",
     "project/components/src/pattern-async-collection.tsx": "9e4df2265d1de6f269278eb4a42d8d63b3ef74a881a455eb17102be477ecbf4d",
     "project/components/src/pattern-consequential-action.tsx": "ffe49b7a9fa978e9177c6f3d839d311bdd3da913a6eeedc241800b10fc3287f7",
     "project/components/src/pattern-edit-record.tsx": "7e83cfdfdb85f6927667dae58f7392c1738dd05ff7a53c75209a875779c9db9d",

package/dist/guidance/llms.txt

@@ -1,4 +1,4 @@
-# Altitude 0.4.0
+# Altitude 0.4.2
 
 > Altitude's guidance for this installed version of altitude-design: the design rules, the task patterns and every component's guide. Height is the interface: settled content sits on the ground, anything live rises above it, anything waiting to receive sinks below it.