@eduardoalvarez/arrecife 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -13,7 +13,7 @@ import { DayPicker } from 'react-day-picker';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
-export { L as Label, a as LabelProps } from './label-MgHFKnFy.js';
+export { L as Label, a as LabelProps } from './label-DJ4HuD-R.js';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import * as ProgressPrimitive from '@radix-ui/react-progress';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
@@ -28,7 +28,7 @@ import { F as Face, P as Pose } from './catalog-D13txprv.js';
 export { A as ASSETS_PATH, B as Background, a as Fin, f as faceList, b as faceUsage, c as faces, d as fins, p as poseList, e as poses } from './catalog-D13txprv.js';
 export { Isotype, IsotypeProps, Logo, LogoProps, Mascot, MascotFace, MascotFaceProps, MascotProps } from './brand/index.js';
 import { ClassValue } from 'clsx';
-export { i as social } from './index-DlAO2JZs.js';
+export { i as social } from './index-BbRplw_B.js';
 import '@radix-ui/react-label';
 
 /**
@@ -49,7 +49,7 @@ import '@radix-ui/react-label';
  * `--ease-standard`, so it introduces neither a new timing nor a new curve.
  * Whoever asked for less motion still sees the panel appear where it will stay.
  *
- * See `docs/decisions.md` § 20.
+ * See `docs/decisions/0.6.md` § 20.
  *
  * The chevron, by contrast, rotates with no transition: `transition-standard`
  * only covers color and border, so `rotate` snaps even with the class in place.
@@ -112,7 +112,7 @@ declare function Alert({ className, variant, emphasis, title, icon, children, ..
  * «Borrar el artículo», not «Aceptar».
  *
  * `destructive` is for the destructive button that has none of that around it:
- * a table row, a toolbar. See `docs/decisions.md` § 21.
+ * a table row, a toolbar. See `docs/decisions/0.6.md` § 21.
  */
 declare const AlertDialog: react.FC<AlertDialogPrimitive.AlertDialogProps>;
 declare const AlertDialogTrigger: react.ForwardRefExoticComponent<AlertDialogPrimitive.AlertDialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
@@ -267,7 +267,8 @@ declare function Checkbox({ className, ...props }: CheckboxProps): react.JSX.Ele
 type CodeProps = ComponentPropsWithoutRef<'code'>;
 declare function Code({ className, ...props }: CodeProps): react.JSX.Element;
 
-type DateFieldProps = Omit<ComponentPropsWithoutRef<'input'>, 'type'> & {
+/** `ComponentProps` carries `ref`, which React 19 passes as a prop. See `InputProps`. */
+type DateFieldProps = Omit<ComponentProps<'input'>, 'type'> & {
     invalid?: boolean | undefined;
     /** Adds the time to the field. It is the native `datetime-local`. */
     withTime?: boolean | undefined;
@@ -316,7 +317,29 @@ declare function DropdownMenuSeparator({ className, ...props }: ComponentPropsWi
 declare function DropdownMenuSubTrigger({ className, children, ...props }: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubTrigger>): react.JSX.Element;
 declare function DropdownMenuSubContent({ className, ...props }: ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.SubContent>): react.JSX.Element;
 
-type InputProps = ComponentPropsWithoutRef<'input'> & {
+/**
+ * `ComponentProps` and not `ComponentPropsWithoutRef`, and the difference is a
+ * bug and not a preference.
+ *
+ * `WithoutRef` is what React 18 required: `ref` was not a prop there, it arrived
+ * through `forwardRef`, and a type that included it promised something the
+ * component could not deliver. React 19 passes `ref` as an ordinary prop, so the
+ * `...props` spread below already forwards it — the type was the only thing
+ * still saying otherwise. It WORKED at runtime and failed at `tsc` with
+ * «Property 'ref' does not exist», which is the worst half of the two: the
+ * escape route is a cast or a wrapper element, and both are detours around a
+ * type rather than around a behaviour.
+ *
+ * `blog-content-manager` took the second one — its Giphy dialog focuses the
+ * search field 50 ms after opening, because Radix claims focus first, and it had
+ * to take the `ref` on the wrapping `div` and reach the input with a
+ * `querySelector`.
+ *
+ * The same applies to every primitive that wraps a native control you can focus:
+ * `Textarea`, `Label` and `DateField` change with it. See `docs/decisions/`
+ * § 41.
+ */
+type InputProps = ComponentProps<'input'> & {
     /** Marks the control as invalid and tints the border. */
     invalid?: boolean;
 };
@@ -447,7 +470,50 @@ type SwitchProps = ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>;
  */
 declare function Switch({ className, ...props }: SwitchProps): react.JSX.Element;
 
-/** The container scrolls horizontally: the page never does. */
+/**
+ * The table, and the surface it sits on. The two are one piece.
+ *
+ * The container has always scrolled horizontally so the PAGE never does. What it
+ * did not carry was a shape, and that turned out to be the same omission twice:
+ * `TableRow` tints a `<tr>` on hover, a `<tr>` is a rectangle, and nothing
+ * clipped it — so every project wrapped the table in its own `rounded-xl border`
+ * and the hover of the header row and of the last row spilled out through the
+ * rounded corner. The fix from outside is `overflow-hidden` on that wrapper, and
+ * it worked exactly as far as somebody remembering it: five tables in `cursos`
+ * had it and the nine in `blog-content-manager` did not.
+ *
+ * So the surface comes with the table. `rounded-card` and `border-hairline` are
+ * the same two the system already gives a card — a table IS a panel of content,
+ * not a bare grid — and the clip comes free with the scroll: an element with
+ * `overflow-x: auto` clips its content to the border box, corners included. The
+ * hover cannot spill because there is nowhere left to spill to, and fourteen
+ * copies of the same `div` stop existing.
+ *
+ * There is NO background token on it, and that is not an oversight: `TableRow`'s
+ * hover is `bg-surface`, so painting the container `surface` too would make the
+ * hover invisible. The table sits on the page and the row lifts off it, which is
+ * the direction the tint was written for.
+ *
+ * `className` reaches the `<table>` and not the container, which is the trap
+ * `Nav`'s `size` documents: a `rounded-none` passed from the call site does
+ * nothing, silently. There is one shape on purpose — fourteen call sites wanted
+ * the same one — and a second gets a prop when a second consumer exists, not
+ * before. See `docs/decisions/0.8.md` § 39.
+ *
+ * THE `tabIndex` IS NOT DECORATION and it is not new behaviour dressed up as
+ * markup. A region you can pan with a mouse has to be reachable with a keyboard
+ * — WCAG 2.1.1 — and a table of text contains nothing focusable to land on, so
+ * without it a keyboard user simply cannot read the columns that are off screen.
+ * It has been true since the container started scrolling; it went unseen because
+ * no story had more columns than width, and the first one that did failed axe on
+ * `scrollable-region-focusable` at once.
+ *
+ * It is unconditional because the alternative is worse. Whether the table
+ * overflows depends on the viewport, so the only way to set this correctly at
+ * render is to measure in an effect and re-measure on resize — a ResizeObserver
+ * on every table in the system to avoid a tab stop. A stop that scrolls nothing
+ * is a small cost; a region a keyboard cannot reach is content that is not there.
+ */
 declare function Table({ className, ...props }: ComponentPropsWithoutRef<'table'>): react.JSX.Element;
 declare function TableHeader({ className, ...props }: ComponentPropsWithoutRef<'thead'>): react.JSX.Element;
 declare function TableBody({ className, ...props }: ComponentPropsWithoutRef<'tbody'>): react.JSX.Element;
@@ -455,6 +521,15 @@ declare function TableFooter({ className, ...props }: ComponentPropsWithoutRef<'
 declare function TableRow({ className, ...props }: ComponentPropsWithoutRef<'tr'>): react.JSX.Element;
 declare function TableHead({ className, ...props }: ComponentPropsWithoutRef<'th'>): react.JSX.Element;
 declare function TableCell({ className, ...props }: ComponentPropsWithoutRef<'td'>): react.JSX.Element;
+/**
+ * The caption, at the bottom and INSIDE the surface.
+ *
+ * It carries its own horizontal padding, which the cells get from `px-step-sm`
+ * and it used to get from nobody: with no border drawn around the table it read
+ * as a line under a grid, and with one it would sit flush against the left edge.
+ * The bottom padding is the same reasoning — a caption touching the border below
+ * it reads as an overflow, not as a caption.
+ */
 declare function TableCaption({ className, ...props }: ComponentPropsWithoutRef<'caption'>): react.JSX.Element;
 
 type TabsProps = ComponentPropsWithoutRef<typeof TabsPrimitive.Root>;
@@ -463,7 +538,8 @@ declare function TabsList({ className, ...props }: ComponentPropsWithoutRef<type
 declare function TabsTrigger({ className, ...props }: ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>): react.JSX.Element;
 declare function TabsContent({ className, ...props }: ComponentPropsWithoutRef<typeof TabsPrimitive.Content>): react.JSX.Element;
 
-type TextareaProps = ComponentPropsWithoutRef<'textarea'> & {
+/** `ComponentProps` carries `ref`, which React 19 passes as a prop. See `InputProps`. */
+type TextareaProps = ComponentProps<'textarea'> & {
     invalid?: boolean;
 };
 declare function Textarea({ className, invalid, ...props }: TextareaProps): react.JSX.Element;
@@ -572,7 +648,7 @@ type CardShellProps = ComponentPropsWithoutRef<'a'> & {
     children: ReactNode;
 };
 
-type ArticleCardProps = Omit<CardShellProps, 'children' | 'title'> & {
+type ArticleCardProps = Omit<CardShellProps, "children" | "title"> & {
     title: ReactNode;
     /** Standfirst. Clamped to two lines so the grid does not fall out of line. */
     excerpt?: ReactNode;
@@ -617,8 +693,8 @@ type ArticleCardProps = Omit<CardShellProps, 'children' | 'title'> & {
     }) => ReactNode) | undefined;
 };
 /**
- * The metadata line uses `meta` and not `eyebrow`: `18 ago 2026 · 8 min de
- * lectura` is a datum, not an overline, and in small caps it was neither.
+ * The metadata line uses `meta` and not `eyebrow`: `18 ago 2026 · 8 min de lectura`
+ * is a datum, not an overline, and in small caps it was neither.
  *
  * The tags are the CATEGORY family — a lowercase sand pill — not the status one.
  * A slug is something you read as `engineering-culture`.
@@ -788,7 +864,7 @@ declare function CourseCard({ title, summary, meta, status, progress, className,
  * smaller one: the hole inside a table page or a dashboard widget, competing with
  * a dozen elements around it. An admin panel has twenty of those on one screen,
  * and twenty faces is not the humour contract, it is a zoo. The variant carries
- * no face, and the type does not let one through. See `docs/decisions.md` § 27.
+ * no face, and the type does not let one through. See `docs/decisions/0.7.md` § 27.
  */
 type EmptyStateBase = Omit<ComponentPropsWithoutRef<'div'>, 'title'> & {
     title: ReactNode;
@@ -874,18 +950,32 @@ declare function EventCalendar({ events, onCreateEvent, onUpdateEvent, onDeleteE
 /**
  * The footer, and the site's CLI signature: `$ cd ~/eduardoalvarez.dev/2026`.
  *
- * The domain comes from `naming.domain` and not from a hand-written string, for
+ * The domain defaults to `naming.domain` and not to a hand-written string, for
  * the same reason as the wordmark: if it changes, it changes in all five
- * projects at once.
+ * projects at once. A project that lives on its OWN domain passes `domain` —
+ * see `docs/decisions/0.9.md` § 49.
  *
  * The social links are icons with NO visible text, so `aria-label` is not an
  * improvement: it is the only thing that makes them legible. Which is why it is
  * mandatory in the type and not an optional prop that gets forgotten.
  *
- * The signature sits top right, level with the FIRST row that exists, not at the
- * end of the block. That is a composition decision and not a styling one: the
- * footer can carry brand, links and social icons, and hanging the signature off
- * one specific row sinks it the moment that row stops being the first.
+ * IT HAS TWO SHAPES, and the one that already existed is the one you get by
+ * passing nothing. That is not a courtesy: of the three projects that draw a
+ * footer, two want what was already there — `eduardoalvarez.dev` in 56 lines and
+ * `links` in a 64-line Astro replica — and only `cursos` wanted more. Changing
+ * the default would have broken the two that work to serve the one that did not.
+ *
+ * It is the third time the system answers «one component, two shapes» and the
+ * answer has not moved: `EmptyState` is a discriminated union where `page` is
+ * the default and `inline` cannot be handed a face; `Nav` takes a `size` where
+ * `default` is the bar it always was. Both left what was written before exactly
+ * where it was. See `docs/decisions/0.8.md` § 44.
+ *
+ * The union is what holds the rule up. `columns`, `description` and `action`
+ * exist only on `full`, and the default form cannot be handed one. As loose
+ * optional props they would compose into a third shape that nobody designed and
+ * nothing describes — a footer with columns and no description, or with a
+ * description and no columns, laid out by whichever branch happened to run.
  */
 type SocialLink = {
     /** What replaces the visible text. Mandatory. */
@@ -897,12 +987,40 @@ type SocialLink = {
      */
     icon: ReactNode;
 };
-type FooterProps = ComponentPropsWithoutRef<'footer'> & {
+/** One link in a column of the full footer. */
+type FooterColumnLink = {
+    label: ReactNode;
+    href: string;
+    /** Opens in a new tab, with the `rel` that has to go with it. */
+    external?: boolean | undefined;
+};
+/**
+ * A column of the full footer: a mono heading in small caps and its links.
+ *
+ * The columns are not decoration and they are not a sitemap. Two of the three in
+ * `cursos` change with who is looking — «Administración» with panel and metrics
+ * for an admin, «Cuenta» with my courses and my diplomas for everybody else —
+ * and a flat row of nine links cannot express that. Which is why this is data
+ * the project builds and not a `children` the library walks.
+ */
+type FooterColumn = {
+    title: string;
+    links: readonly FooterColumnLink[];
+};
+/**
+ * `children` is OMITTED, and it is the point of the type rather than an
+ * oversight.
+ *
+ * The footer used to take a row of loose text links this way — `./rss`,
+ * `./aviso-legal` — and that row is what `variant="full"`'s columns replace. A
+ * flat row cannot say which block a link belongs to, cannot carry a heading a
+ * screen reader can jump to, and made whoever wrote the label type the `./`
+ * themselves, which the columns put there. See docs/decisions/0.8.md § 47.
+ */
+type FooterBase = Omit<ComponentPropsWithoutRef<'footer'>, 'children'> & {
     social?: readonly SocialLink[];
     /** The signature's year. */
     year?: number;
-    /** Text links: legal notice, RSS, sitemap. */
-    children?: ReactNode;
     /**
      * The brand row: the fin and the wordmark, at the very top.
      *
@@ -912,12 +1030,66 @@ type FooterProps = ComponentPropsWithoutRef<'footer'> & {
      * type.
      */
     brand?: ReactNode;
+    /**
+     * Makes the domain inside the signature a link, keeping the `$`, the path and
+     * the prompt's mark as text.
+     *
+     * Only the domain: linking the whole line would turn a prompt into a button
+     * and put `cd ~/` inside the accessible name of the link. Without it the
+     * signature is text, which is what it has always been.
+     */
+    signatureHref?: string | undefined;
+    /**
+     * The domain the signature prints, defaulting to the identity's own.
+     *
+     * It exists because the default is right for the sites that ARE
+     * `eduardoalvarez.dev` and wrong for the ones that are not: `cursos` lives on
+     * `cursos.eduardoalvarez.dev` and had been printing it since before this
+     * component existed. Adopting the footer would have made a site sign with its
+     * parent's domain — a fact, not a style, and one nothing in the type could
+     * have warned about.
+     *
+     * It is a domain and not a whole signature: the `$`, the `cd ~/` and the year
+     * are the identity's and stay the component's. See `docs/decisions/0.9.md`
+     * § 49.
+     */
+    domain?: string | undefined;
 };
-declare function Footer({ social, year, children, brand, className, ...props }: FooterProps): react.JSX.Element;
-type FooterLinkProps = ComponentPropsWithoutRef<'a'> & {
-    asChild?: boolean | undefined;
-};
-declare function FooterLink({ asChild, className, ...props }: FooterLinkProps): react.JSX.Element;
+type FooterProps = FooterBase & ({
+    /** The shape the library has always had: stacked rows and the signature at the top right. */
+    variant?: 'default' | undefined;
+    columns?: never;
+    description?: never;
+    action?: never;
+    linkAsChild?: never;
+} | {
+    /** `full`: brand and description on the left, link columns on the right, signature closing it. */
+    variant: 'full';
+    /** The link columns. Mandatory: without them `full` is the default form with extra steps. */
+    columns: readonly FooterColumn[];
+    /** One line under the brand, saying what the site is. */
+    description?: ReactNode;
+    /** An action under the row of icons — «Reportar un problema». Usually a tertiary button. */
+    action?: ReactNode;
+    /**
+     * Renders the column links through the child, to plug in the framework's
+     * `Link`. It receives each `href` in the Slot's `props`.
+     *
+     * It is § 24's rule applied where it now bites: a column turns data into
+     * markup, so without a slot the only way to reach one of those links
+     * from a project is to select it by structure or by a style class, and
+     * neither is a contract. `Breadcrumb` and `ArticleCard` have the same
+     * signature on purpose.
+     *
+     * It is also what a client-side transition needs: `cursos` reached for
+     * it the moment its columns stopped being `<a>` tags.
+     */
+    linkAsChild?: ((props: {
+        href: string;
+        children: ReactNode;
+    }) => ReactNode) | undefined;
+});
+declare function Footer({ variant, columns, description, action, linkAsChild, social, brand, year, signatureHref, domain, className, ...rest }: FooterProps): react.JSX.Element;
 
 /**
  * ONE per site. It is the only piece in the system that is spent like the
@@ -1000,7 +1172,7 @@ declare function LinkRow({ name, description, icon, external, className, ...prop
  * everything an app shell asks for: a `~/cursos` wordmark goes in `brand`, and a
  * user menu or a «Entrar» button goes in `actions`. Session state does not get a
  * prop of its own — it is project infrastructure, which is the third clause of
- * the criterion that decides what enters this library. See `docs/decisions.md`
+ * the criterion that decides what enters this library. See `docs/decisions/`
  * § 30.
  */
 type NavProps = ComponentPropsWithoutRef<'header'> & {
@@ -1043,6 +1215,15 @@ type NavItemProps = ComponentPropsWithoutRef<'a'> & {
  * than it looks in a mockup. Brackets are how a terminal marks the active path,
  * so they say «you are here» without relying on the color being told apart. They
  * are `aria-hidden`, because whoever is listening already has `aria-current`.
+ *
+ * `children` goes through `Slottable`, and that is what makes `asChild` work at
+ * all. The prompt and the brackets are the component's own nodes, so a plain
+ * `Slot` saw four children where it needs one and threw «Slot failed to slot
+ * onto its children» on EVERY render — the prop was declared, typed and
+ * impossible to call. It passed `tsc` and it passed the build, because the shape
+ * of the children is not something either one looks at. `Slottable` is Radix's
+ * answer to exactly this: it marks which child the router's `Link` replaces and
+ * leaves the decoration where it is. See `docs/decisions/0.8.md` § 40.
  */
 declare function NavItem({ active, asChild, className, children, ...props }: NavItemProps): react.JSX.Element;
 
@@ -1237,101 +1418,6 @@ type ScrollingProgressBarProps = Omit<ComponentPropsWithoutRef<'div'>, 'children
 };
 declare function ScrollingProgressBar({ target, tone, sticky, className, ...props }: ScrollingProgressBarProps): react.JSX.Element;
 
-/**
- * The blog admin's sidebar.
- *
- * The `▸` is put there by the component, same as `NavItem`'s `./` and the
- * breadcrumb's `~`: it is the same CLI aesthetic and the same decision — the
- * format is part of the piece, not a convention to be remembered. It is
- * `aria-hidden`.
- *
- * An `icon` REPLACES it rather than joining it. Two marks before a label is one
- * more than the eye needs, and the `▸` exists to say «this is a place you can
- * go» — which is exactly what a section icon already says, and says better. A
- * sidebar with no icons keeps the prompt, which is the reading sites' case.
- *
- * The footer carries the version and the branch (`v5.0.1 · main`) in the `meta`
- * scale. It is not decoration: in an admin it is the first thing anyone asks
- * when something looks off.
- */
-type SidebarItemProps = ComponentPropsWithoutRef<'a'> & {
-    active?: boolean | undefined;
-    asChild?: boolean | undefined;
-    /** Counter on the right: pending drafts, unused media. */
-    badge?: ReactNode;
-    /**
-     * The section's glyph, on the left. It REPLACES the `▸` rather than joining
-     * it, and it inherits `currentColor`, so it follows the item's state without
-     * being tinted separately.
-     */
-    icon?: ReactNode;
-};
-declare function SidebarItem({ active, asChild, badge, icon, className, children, ...props }: SidebarItemProps): react.JSX.Element;
-/**
- * A labelled block of items — «Contenido», «Alumnos», «Ventas».
- *
- * A panel's sidebar stops being readable somewhere around eight items, and the
- * fix is not a scrollbar: it is saying what the blocks are. The label is a `<p>`
- * and not a heading, because a heading here would land in the document outline
- * between the page's own — a sidebar is navigation, not content.
- *
- * The items go in a nested `<ul>` named by that label, which is what gives a
- * screen reader «lista Ventas, 3 elementos» instead of one list of eleven.
- */
-type SidebarGroupProps = Omit<ComponentPropsWithoutRef<'li'>, 'title'> & {
-    /** The block's name. Sentence case, not a section title. */
-    label: ReactNode;
-};
-declare function SidebarGroup({ label, children, className, ...props }: SidebarGroupProps): react.JSX.Element;
-type SidebarNavProps = ComponentPropsWithoutRef<'nav'> & {
-    /**
-     * The panel's heading, as an eyebrow. It also names the `<nav>` when it is a
-     * string, which is why a `brand` row does not replace it: a logo is not an
-     * accessible name. Pass `aria-label` when neither fits.
-     */
-    title?: ReactNode;
-    /**
-     * The row at the top: isotype and wordmark, `cursos · admin`. It is a slot and
-     * not a `logo`/`name` pair because every panel spells its own name
-     * differently, and the part that IS the system — the rhythm, the hairline
-     * under it — is here.
-     *
-     * Collapsed, it is hidden: a wordmark does not fit in a rail and the component
-     * cannot trim somebody else's markup. Pass the isotype on its own through
-     * `mark` for the rail to keep something at the top.
-     */
-    brand?: ReactNode;
-    /** What `brand` becomes in the rail. Usually the isotype with no wordmark. */
-    mark?: ReactNode;
-    /**
-     * Who is signed in, at the bottom above the version. A slot, because an avatar
-     * needs a session and a sign-out route and the library takes no project
-     * infrastructure — the same reason `Nav`'s user menu goes in `actions`.
-     */
-    user?: ReactNode;
-    /**
-     * Turns the sidebar into a rail: icons only, and the widths become the
-     * library's — `w-sidebar` and `w-sidebar-rail`. It is CONTROLLED and there is
-     * no uncontrolled mode, because this state is almost always persisted in a
-     * cookie or in `localStorage`, and an internal state would fight the one the
-     * project already keeps.
-     */
-    collapsed?: boolean | undefined;
-    /**
-     * Called with what the state should become. With it, the toggle appears; with
-     * `collapsed` alone the sidebar is a rail with no way out of it, which is a
-     * legitimate layout and not an accident.
-     */
-    onCollapsedChange?: ((collapsed: boolean) => void) | undefined;
-    /** The toggle's accessible name, in the two directions. */
-    collapseLabel?: string;
-    expandLabel?: string;
-    /** Version and branch, at the bottom. */
-    version?: ReactNode;
-    branch?: ReactNode;
-};
-declare function SidebarNav({ title, brand, mark, user, collapsed, onCollapsedChange, collapseLabel, expandLabel, version, branch, children, className, ...props }: SidebarNavProps): react.JSX.Element;
-
 /**
  * A large metric: the number in the `stat` scale and its name underneath.
  *
@@ -1356,7 +1442,7 @@ declare function SidebarNav({ title, brand, mark, user, collapsed, onCollapsedCh
  * eyebrow is the same length in none of them, so an inline icon puts the only
  * coloured mark on a different x in every card; pinned to the corner it lands on
  * a grid. The circle is the tint pattern the system already has — `bg-accent/10`
- * as a surface and the colour on the GLYPH, per `docs/decisions.md` § 4b — and a
+ * as a surface and the colour on the GLYPH, per `docs/decisions/0.6.md` § 4b — and a
  * glyph clears the 3:1 graphical threshold where text would not clear 4.5.
  *
  * WHICH IS WHY A NEUTRAL NUMBER IS PRIMARY INK AND NOT BIOLUME. With a biolume
@@ -1364,7 +1450,7 @@ declare function SidebarNav({ title, brand, mark, user, collapsed, onCollapsedCh
  * the size of a postcard, and the thing you came to read stops being the loudest
  * thing in it. `alert` and `achievement` DO still paint the number sand, so the
  * document's rule survives exactly where it matters: sand when the number is not
- * just a number. See `docs/decisions.md` § 31.
+ * just a number. See `docs/decisions/0.7.md` § 31.
  */
 type StatProps = Omit<ComponentPropsWithoutRef<'div'>, 'title'> & {
     /** The number, already formatted. The library imposes no locale. */
@@ -1376,7 +1462,7 @@ type StatProps = Omit<ComponentPropsWithoutRef<'div'>, 'title'> & {
      * the opposite — the diplomas issued, the modules finished. The two paint the
      * same sand today and they are still two names: a system that names by meaning
      * cannot make «this is bad» the only way to say «this stands out». See
-     * `docs/decisions.md` § 28.
+     * `docs/decisions/0.7.md` § 28.
      */
     tone?: 'neutral' | 'alert' | 'achievement';
     /** With `progress`, the metric reads as progress and adds the bar. */
@@ -1562,4 +1648,4 @@ declare function TableOfContents({ items, title, activeHref, linkAsChild, classN
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Accordion, AccordionContent, AccordionItem, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogTitle, AlertDialogTrigger, type AlertProps, ArticleCard, type ArticleCardProps, AudioPlayer, type AudioPlayerMode, type AudioPlayerProps, AuthorCard, type AuthorCardProps, Avatar, AvatarFallback, AvatarImage, type AvatarProps, AvatarUpload, type AvatarUploadProps, Badge, type BadgeProps, Blockquote, type BlockquoteProps, Breadcrumb, type BreadcrumbProps, Button, type ButtonProps, Calendar, type CalendarEvent, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryBadge, type CategoryBadgeProps, Checkbox, type CheckboxProps, Code, CodeBlock, type CodeBlockProps, type CodeProps, CourseCard, type CourseCardProps, type Crumb, DateField, type DateFieldProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, EventCalendar, type EventCalendarProps, Face, Footer, FooterLink, type FooterLinkProps, type FooterProps, Hero, type HeroProps, Input, type InputProps, LinkRow, type LinkRowProps, MetricBadge, type MetricBadgeProps, Nav, NavItem, type NavItemProps, type NavProps, NewsletterForm, type NewsletterFormProps, type NewsletterState, PageHeader, type PageHeaderProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, type PaginationLinkProps, PaginationNext, PaginationPrevious, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, Pose, Progress, type ProgressProps, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, ScrollingProgressBar, type ScrollingProgressBarProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, Separator, type SeparatorProps, Sheet, SheetBody, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, SidebarGroup, type SidebarGroupProps, SidebarItem, type SidebarItemProps, SidebarNav, type SidebarNavProps, Skeleton, type SkeletonProps, type SocialLink, Stat, type StatDelta, type StatProps, Switch, type SwitchProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableOfContents, type TableOfContentsProps, TableRow, Tabs, TabsContent, TabsList, type TabsProps, TabsTrigger, TalkCard, type TalkCardProps, Text, type TextProps, Textarea, type TextareaProps, Theme, ThemeToggle, type ThemeToggleProps, ToastAction, type ToastOptions, type ToastVariant, Toaster, type ToasterProps, type TocEntry, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, alert as alertVariants, avatar as avatarVariants, badge as badgeVariants, button as buttonVariants, cn, text as textVariants, toast, useTheme };
+export { Accordion, AccordionContent, AccordionItem, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogTitle, AlertDialogTrigger, type AlertProps, ArticleCard, type ArticleCardProps, AudioPlayer, type AudioPlayerMode, type AudioPlayerProps, AuthorCard, type AuthorCardProps, Avatar, AvatarFallback, AvatarImage, type AvatarProps, AvatarUpload, type AvatarUploadProps, Badge, type BadgeProps, Blockquote, type BlockquoteProps, Breadcrumb, type BreadcrumbProps, Button, type ButtonProps, Calendar, type CalendarEvent, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CategoryBadge, type CategoryBadgeProps, Checkbox, type CheckboxProps, Code, CodeBlock, type CodeBlockProps, type CodeProps, CourseCard, type CourseCardProps, type Crumb, DateField, type DateFieldProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, EventCalendar, type EventCalendarProps, Face, Footer, type FooterColumn, type FooterColumnLink, type FooterProps, Hero, type HeroProps, Input, type InputProps, LinkRow, type LinkRowProps, MetricBadge, type MetricBadgeProps, Nav, NavItem, type NavItemProps, type NavProps, NewsletterForm, type NewsletterFormProps, type NewsletterState, PageHeader, type PageHeaderProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, type PaginationLinkProps, PaginationNext, PaginationPrevious, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, Pose, Progress, type ProgressProps, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, ScrollingProgressBar, type ScrollingProgressBarProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, Separator, type SeparatorProps, Sheet, SheetBody, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, type SocialLink, Stat, type StatDelta, type StatProps, Switch, type SwitchProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableOfContents, type TableOfContentsProps, TableRow, Tabs, TabsContent, TabsList, type TabsProps, TabsTrigger, TalkCard, type TalkCardProps, Text, type TextProps, Textarea, type TextareaProps, Theme, ThemeToggle, type ThemeToggleProps, ToastAction, type ToastOptions, type ToastVariant, Toaster, type ToasterProps, type TocEntry, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, alert as alertVariants, avatar as avatarVariants, badge as badgeVariants, button as buttonVariants, cn, text as textVariants, toast, useTheme };