@devfellowship/components 3.2.4 → 3.3.0

package/dist/index.d.cts

@@ -39,6 +39,7 @@ import * as ToastPrimitives from '@radix-ui/react-toast';
 import * as TogglePrimitive from '@radix-ui/react-toggle';
 import * as ToggleGroupPrimitive from '@radix-ui/react-toggle-group';
 import { LucideIcon } from 'lucide-react';
+import { z } from 'zod';
 export { c as cn } from './utils-Cbsgs0XP.cjs';
 export { ToastProps, ToastVariant, toast, useIframeAuth, useIframeNavigate, useIsMobile, useToast } from './hooks.cjs';
 export { A as AuthContextType, a as AuthProvider, b as AuthProviderProps, U as UserProfile, u as useAuth, c as useSession } from './use-auth-t8aJ9mx7.cjs';
@@ -2202,4 +2203,1063 @@ declare function validatePublishForm(input: {
 }): string | null;
 declare function PublishDrawer({ open, onOpenChange, supabase, videoUrl, transcript, suggestedTitle, suggestedDescription, suggestedThumbnailUrl, thumbnailTemplateId, buId, registerLesson, onPublished, onError, className, _storyStatus, _storyResult, _storyAccounts, _storyErrorMsg, }: PublishDrawerProps): React$1.JSX.Element;
 
-export { ALLOWED_ORIGINS, AVATAR_MEMBER_PALETTE_SIZE, Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, type AlertDialogActionProps, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppNavbar, type AppNavbarProps, AppSidebar, type AppSidebarProps, AspectRatio, Avatar, AvatarFallback, AvatarGroup, AvatarImage, type AvatarSize, AvatarStatus, type AvatarStatusValue, type AvatarTone, Badge, type BadgeProps, Breadcrumb, BreadcrumbEllipsis, type BreadcrumbEntry, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, type ButtonProps, Calendar, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselDots, CarouselItem, CarouselNext, CarouselPrevious, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleHeader, CollapsibleItem, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmDialog, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DEFAULT_NAME_COL_WIDTH, type DflIframeMessage, type DflNavigateMessage, type DflReadyMessage, DflRemote, type DflRemoteProps, type DflResizeMessage, type DflSetTokenMessage, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, Gantt, type GanttDependency, type GanttMilestone, type GanttProps, type GanttStage, HoverCard, HoverCardContent, HoverCardTrigger, IconButton, type IconButtonProps, IframeAware, type IframeAwareProps, IframeContext, type IframeContextValue, type IframeMessageType, Input, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Kbd, type KbdProps, Label, LoginPage, type LoginPageProps, LoginScreen, type LoginScreenProps, MEMBER_PALETTE_SIZE, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, type NavGroup, type NavItem, type NavbarUserInfo, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, type OTPStatus, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PasswordInput, type PasswordInputProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, type ProgressProps, ProtectedRoute, type ProtectedRouteProps, PublishDrawer, type PublishDrawerProps, type PublishDrawerSupabase, type PublishResult, type PublishStatus, type PublisherAccount, RadioGroup, RadioGroupItem, RadioGroupRow, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, type ScrollAreaScrollbars, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorWithLabel, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, SonnerToaster, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, Toast, ToastAction, type ToastActionElement, ToastClose, type ToastComponentProps, ToastDescription, ToastProvider, ToastTitle, ToastViewport, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserAvatar, type UserAvatarProps, type UserInfo, UserMenu, type UserMenuItem, type UserMenuProps, avatarMemberColor, badgeVariants, barGridColumn, buttonVariants, clampPct, filterPublishableAccounts, getInitials, iconButtonVariants, isAllowedOrigin, kbdVariants, labelVariants, memberHueIndex, memberHueVar, navigationMenuTriggerStyle, parseTags, resolveNameColWidth, resolveWeekCount, resolveWeekLabels, stageProgress, toggleVariants, useFormField, useSidebar, validatePublishForm };
+/**
+ * RoadmapDocument — the versioned JSON contract of the `Roadmap` organism.
+ *
+ * The component takes a document, not coordinates. A knowledge map is authored
+ * (or emitted by a learning engine) as a list of nodes that each name a COLUMN
+ * and a ROW, plus edges, groups and a legend. The renderer places them in a
+ * 3-column CSS grid. No absolute pixel travels in this shape.
+ *
+ * Why the shape looks like this (plan ADR-2): roadmap.sh stores `position {x,y}`
+ * and scales one fixed canvas, so a 17 px label renders at 6.2 px on a 390 px
+ * phone. Absolute coordinates cannot reflow. `column` + `order` can. A layout
+ * engine (dagre, ELK) cannot pin a node to a lane, so there is no layout engine
+ * either — the author owns the placement, and the grid owns the pixels.
+ *
+ * Colour is a TOKEN, never a hex (plan ADR-6). `tone` is one of eight names and
+ * the schema REJECTS any other string, `"#fdff00"` included. That closed
+ * vocabulary is what keeps the dark design system, the editorial surface and a
+ * downstream `--s-*` rebrand all working from one document.
+ *
+ * The live progress state does NOT live in the document (plan ADR-8). A document
+ * is shared; a learner's state is not. `RoadmapStateOverlay` carries it, and the
+ * overlay wins over an authored `node.state`.
+ *
+ * Versioning rule: `version` is a literal. An additive OPTIONAL field is a minor
+ * release and does not change the literal. A removed field, a renamed field or a
+ * changed DEFAULT becomes `roadmap/v2`, ships with `upgradeV1toV2()` next to this
+ * schema, and `parseRoadmapDocument()` accepts both for one major release of the
+ * package. `meta` is never versioned.
+ */
+
+declare const ROADMAP_COLUMNS: readonly ["left", "center", "right"];
+declare const ROADMAP_TONES: readonly ["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"];
+declare const ROADMAP_NODE_KINDS: readonly ["topic", "subtopic", "label", "title", "paragraph", "button", "legend"];
+declare const ROADMAP_NODE_STATES: readonly ["todo", "done", "learning", "skipped", "locked"];
+declare const ROADMAP_EDGE_STYLES: readonly ["solid", "dashed", "dotted"];
+declare const ROADMAP_EDGE_ROUTES: readonly ["auto", "straight", "elbow", "curve"];
+declare const ROADMAP_ARROWS: readonly ["none", "end", "both"];
+declare const ROADMAP_LEGEND_PLACEMENTS: readonly ["top", "bottom", "inline"];
+type RoadmapColumn = (typeof ROADMAP_COLUMNS)[number];
+type RoadmapTone = (typeof ROADMAP_TONES)[number];
+type RoadmapNodeKind = (typeof ROADMAP_NODE_KINDS)[number];
+type RoadmapNodeState = (typeof ROADMAP_NODE_STATES)[number];
+type RoadmapEdgeStyle = (typeof ROADMAP_EDGE_STYLES)[number];
+type RoadmapEdgeRoute = (typeof ROADMAP_EDGE_ROUTES)[number];
+type RoadmapArrow = (typeof ROADMAP_ARROWS)[number];
+type RoadmapLegendPlacement = (typeof ROADMAP_LEGEND_PLACEMENTS)[number];
+/** A glyph drawn half inside and half outside the node border. */
+interface RoadmapIcon {
+    /** A `lucide-react` icon name, kebab-case. */
+    name: string;
+    side: "left" | "right";
+    tone?: RoadmapTone;
+}
+/** A button INSIDE a node. Exactly one of `href` or `actionId`. */
+interface RoadmapAction {
+    label: string;
+    href?: string;
+    /** Handed back to `onAction(actionId, node)`; the component never reads it. */
+    actionId?: string;
+    tone?: RoadmapTone;
+}
+interface RoadmapLink {
+    label: string;
+    href: string;
+}
+interface RoadmapNode {
+    /** `/^[A-Za-z0-9_-]{1,64}$/`, unique in the document. */
+    id: string;
+    column: RoadmapColumn;
+    /** Integer >= 0 — the grid ROW. Unique per `(column, order)` cell. */
+    order: number;
+    /** Default 1. `3` = full width and the `column` is ignored. */
+    span?: 1 | 2 | 3;
+    kind: RoadmapNodeKind;
+    label: string;
+    /** Paragraph body, or the tooltip of a topic. */
+    description?: string;
+    /** Default: topic -> primary, subtopic -> secondary, button -> primary, else neutral. */
+    tone?: RoadmapTone;
+    icon?: RoadmapIcon;
+    /** Id of a legend entry; draws that entry's icon and tone on the node. */
+    badge?: string;
+    /** Authored default. A `RoadmapStateOverlay` wins over it. */
+    state?: RoadmapNodeState;
+    action?: RoadmapAction;
+    /** The whole node becomes a link. */
+    href?: string;
+    /** `paragraph` or `label`: a list of links (the roadmap.sh `linksgroup`). */
+    links?: RoadmapLink[];
+    /** Opaque; passed back on click, never read by the component. */
+    meta?: Record<string, unknown>;
+}
+interface RoadmapEdge {
+    id: string;
+    source: string;
+    target: string;
+    /** Default `dashed` — plan ADR-5. 2 719 of 4 411 roadmap.sh edges are dashed. */
+    style?: RoadmapEdgeStyle;
+    /** <= 40 chars. A NEW capability: roadmap.sh has no edge labels at all. */
+    label?: string;
+    /** Default `auto`. */
+    route?: RoadmapEdgeRoute;
+    /** Default `none`. */
+    arrow?: RoadmapArrow;
+    tone?: RoadmapTone;
+}
+/**
+ * A group is an inclusive RANGE over `order`, not a box (plan ADR-3). A rect
+ * cannot reflow; a range spans the same rows at every width.
+ */
+interface RoadmapGroup {
+    id: string;
+    title?: string;
+    /** Default `neutral`. */
+    tone?: RoadmapTone;
+    from: number;
+    to: number;
+    /** Default: all three columns. */
+    columns?: RoadmapColumn[];
+    description?: string;
+}
+interface RoadmapLegendEntry {
+    id: string;
+    label: string;
+    tone: RoadmapTone;
+    /** A `lucide-react` icon name, kebab-case. */
+    icon?: string;
+}
+interface RoadmapLegend {
+    entries: RoadmapLegendEntry[];
+    /** `inline` = drawn where a node of kind `legend` sits. Default `top`. */
+    placement?: RoadmapLegendPlacement;
+}
+interface RoadmapDocument {
+    version: "roadmap/v1";
+    title?: string;
+    /** v1 accepts only `down`. */
+    direction: "down";
+    /** v1 accepts only 3. */
+    columns: 3;
+    nodes: RoadmapNode[];
+    edges: RoadmapEdge[];
+    groups: RoadmapGroup[];
+    legend?: RoadmapLegend;
+    meta?: Record<string, unknown>;
+}
+/** The live state, kept OUT of the document — plan ADR-8. Unknown ids are ignored. */
+interface RoadmapStateOverlay {
+    version: "roadmap-state/v1";
+    nodes: Record<string, RoadmapNodeState>;
+}
+declare const DEFAULT_NODE_SPAN: 1;
+declare const DEFAULT_EDGE_STYLE: RoadmapEdgeStyle;
+declare const DEFAULT_EDGE_ROUTE: RoadmapEdgeRoute;
+declare const DEFAULT_EDGE_ARROW: RoadmapArrow;
+declare const DEFAULT_GROUP_TONE: RoadmapTone;
+declare const DEFAULT_LEGEND_PLACEMENT: RoadmapLegendPlacement;
+declare const DEFAULT_NODE_STATE: RoadmapNodeState;
+/** Per-kind tone default. Every kind that is not listed falls back to `neutral`. */
+declare const NODE_KIND_DEFAULT_TONE: Record<RoadmapNodeKind, RoadmapTone>;
+declare const resolveNodeSpan: (node: RoadmapNode) => 1 | 2 | 3;
+declare const resolveNodeTone: (node: RoadmapNode) => RoadmapTone;
+declare const resolveEdgeStyle: (edge: RoadmapEdge) => RoadmapEdgeStyle;
+declare const resolveEdgeRoute: (edge: RoadmapEdge) => RoadmapEdgeRoute;
+declare const resolveEdgeArrow: (edge: RoadmapEdge) => RoadmapArrow;
+declare const resolveGroupTone: (group: RoadmapGroup) => RoadmapTone;
+declare const resolveGroupColumns: (group: RoadmapGroup) => RoadmapColumn[];
+declare const resolveLegendPlacement: (legend: RoadmapLegend) => RoadmapLegendPlacement;
+/** The overlay wins over the authored `node.state` — plan ADR-8. */
+declare const resolveNodeState: (node: RoadmapNode, overlay?: RoadmapStateOverlay) => RoadmapNodeState;
+declare const ROADMAP_NODE_ID_PATTERN: RegExp;
+declare const ROADMAP_EDGE_LABEL_MAX = 40;
+declare const ROADMAP_LABEL_MAX = 200;
+declare const roadmapIconSchema: z.ZodObject<{
+    name: z.ZodString;
+    side: z.ZodEnum<["left", "right"]>;
+    tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    side: "left" | "right";
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+}, {
+    name: string;
+    side: "left" | "right";
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+}>;
+declare const roadmapActionSchema: z.ZodEffects<z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodOptional<z.ZodString>;
+    actionId: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+}, "strict", z.ZodTypeAny, {
+    label: string;
+    href?: string | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    actionId?: string | undefined;
+}, {
+    label: string;
+    href?: string | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    actionId?: string | undefined;
+}>, {
+    label: string;
+    href?: string | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    actionId?: string | undefined;
+}, {
+    label: string;
+    href?: string | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    actionId?: string | undefined;
+}>;
+declare const roadmapLinkSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    label: string;
+    href: string;
+}, {
+    label: string;
+    href: string;
+}>;
+declare const roadmapNodeStateSchema: z.ZodEnum<["todo", "done", "learning", "skipped", "locked"]>;
+declare const roadmapNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    column: z.ZodEnum<["left", "center", "right"]>;
+    order: z.ZodNumber;
+    span: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+    kind: z.ZodEnum<["topic", "subtopic", "label", "title", "paragraph", "button", "legend"]>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+    icon: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        side: z.ZodEnum<["left", "right"]>;
+        tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        side: "left" | "right";
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    }, {
+        name: string;
+        side: "left" | "right";
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    }>>;
+    badge: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<["todo", "done", "learning", "skipped", "locked"]>>;
+    action: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodOptional<z.ZodString>;
+        actionId: z.ZodOptional<z.ZodString>;
+        tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        href?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        actionId?: string | undefined;
+    }, {
+        label: string;
+        href?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        actionId?: string | undefined;
+    }>, {
+        label: string;
+        href?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        actionId?: string | undefined;
+    }, {
+        label: string;
+        href?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        actionId?: string | undefined;
+    }>>;
+    href: z.ZodOptional<z.ZodString>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        href: string;
+    }, {
+        label: string;
+        href: string;
+    }>, "many">>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    label: string;
+    id: string;
+    order: number;
+    kind: "button" | "label" | "legend" | "title" | "topic" | "subtopic" | "paragraph";
+    column: "center" | "left" | "right";
+    span?: 1 | 2 | 3 | undefined;
+    meta?: Record<string, unknown> | undefined;
+    href?: string | undefined;
+    action?: {
+        label: string;
+        href?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        actionId?: string | undefined;
+    } | undefined;
+    icon?: {
+        name: string;
+        side: "left" | "right";
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    } | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    description?: string | undefined;
+    state?: "done" | "todo" | "learning" | "skipped" | "locked" | undefined;
+    badge?: string | undefined;
+    links?: {
+        label: string;
+        href: string;
+    }[] | undefined;
+}, {
+    label: string;
+    id: string;
+    order: number;
+    kind: "button" | "label" | "legend" | "title" | "topic" | "subtopic" | "paragraph";
+    column: "center" | "left" | "right";
+    span?: 1 | 2 | 3 | undefined;
+    meta?: Record<string, unknown> | undefined;
+    href?: string | undefined;
+    action?: {
+        label: string;
+        href?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        actionId?: string | undefined;
+    } | undefined;
+    icon?: {
+        name: string;
+        side: "left" | "right";
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    } | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    description?: string | undefined;
+    state?: "done" | "todo" | "learning" | "skipped" | "locked" | undefined;
+    badge?: string | undefined;
+    links?: {
+        label: string;
+        href: string;
+    }[] | undefined;
+}>;
+declare const roadmapEdgeSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodString;
+    target: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
+    label: z.ZodOptional<z.ZodString>;
+    route: z.ZodOptional<z.ZodEnum<["auto", "straight", "elbow", "curve"]>>;
+    arrow: z.ZodOptional<z.ZodEnum<["none", "end", "both"]>>;
+    tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+}, "strict", z.ZodTypeAny, {
+    source: string;
+    id: string;
+    target: string;
+    label?: string | undefined;
+    style?: "dashed" | "dotted" | "solid" | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    route?: "auto" | "straight" | "elbow" | "curve" | undefined;
+    arrow?: "end" | "none" | "both" | undefined;
+}, {
+    source: string;
+    id: string;
+    target: string;
+    label?: string | undefined;
+    style?: "dashed" | "dotted" | "solid" | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    route?: "auto" | "straight" | "elbow" | "curve" | undefined;
+    arrow?: "end" | "none" | "both" | undefined;
+}>;
+declare const roadmapGroupSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+    from: z.ZodNumber;
+    to: z.ZodNumber;
+    columns: z.ZodOptional<z.ZodArray<z.ZodEnum<["left", "center", "right"]>, "many">>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    from: number;
+    to: number;
+    title?: string | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    description?: string | undefined;
+    columns?: ("center" | "left" | "right")[] | undefined;
+}, {
+    id: string;
+    from: number;
+    to: number;
+    title?: string | undefined;
+    tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+    description?: string | undefined;
+    columns?: ("center" | "left" | "right")[] | undefined;
+}>;
+declare const roadmapLegendEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    tone: z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>;
+    icon: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    label: string;
+    id: string;
+    tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+    icon?: string | undefined;
+}, {
+    label: string;
+    id: string;
+    tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+    icon?: string | undefined;
+}>;
+declare const roadmapLegendSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        tone: z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>;
+        icon: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        id: string;
+        tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+        icon?: string | undefined;
+    }, {
+        label: string;
+        id: string;
+        tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+        icon?: string | undefined;
+    }>, "many">;
+    placement: z.ZodOptional<z.ZodEnum<["top", "bottom", "inline"]>>;
+}, "strict", z.ZodTypeAny, {
+    entries: {
+        label: string;
+        id: string;
+        tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+        icon?: string | undefined;
+    }[];
+    placement?: "inline" | "bottom" | "top" | undefined;
+}, {
+    entries: {
+        label: string;
+        id: string;
+        tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+        icon?: string | undefined;
+    }[];
+    placement?: "inline" | "bottom" | "top" | undefined;
+}>;
+/** Which grid tracks a node occupies. `span: 3` ignores `column` and takes all three. */
+declare function columnsCovered(node: {
+    column: RoadmapColumn;
+    span?: 1 | 2 | 3;
+}): RoadmapColumn[];
+/**
+ * The document schema, with every cross-field invariant the plan lists.
+ *
+ * Each issue carries a PATH into the document, so a caller can point an author
+ * at the exact node, edge or group that is wrong.
+ */
+declare const roadmapDocumentSchema: z.ZodEffects<z.ZodObject<{
+    version: z.ZodLiteral<"roadmap/v1">;
+    title: z.ZodOptional<z.ZodString>;
+    direction: z.ZodLiteral<"down">;
+    columns: z.ZodLiteral<3>;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        column: z.ZodEnum<["left", "center", "right"]>;
+        order: z.ZodNumber;
+        span: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+        kind: z.ZodEnum<["topic", "subtopic", "label", "title", "paragraph", "button", "legend"]>;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+        icon: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            side: z.ZodEnum<["left", "right"]>;
+            tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            side: "left" | "right";
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        }, {
+            name: string;
+            side: "left" | "right";
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        }>>;
+        badge: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodEnum<["todo", "done", "learning", "skipped", "locked"]>>;
+        action: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodOptional<z.ZodString>;
+            actionId: z.ZodOptional<z.ZodString>;
+            tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        }, {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        }>, {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        }, {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        }>>;
+        href: z.ZodOptional<z.ZodString>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            href: string;
+        }, {
+            label: string;
+            href: string;
+        }>, "many">>;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        id: string;
+        order: number;
+        kind: "button" | "label" | "legend" | "title" | "topic" | "subtopic" | "paragraph";
+        column: "center" | "left" | "right";
+        span?: 1 | 2 | 3 | undefined;
+        meta?: Record<string, unknown> | undefined;
+        href?: string | undefined;
+        action?: {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        } | undefined;
+        icon?: {
+            name: string;
+            side: "left" | "right";
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        } | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        state?: "done" | "todo" | "learning" | "skipped" | "locked" | undefined;
+        badge?: string | undefined;
+        links?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }, {
+        label: string;
+        id: string;
+        order: number;
+        kind: "button" | "label" | "legend" | "title" | "topic" | "subtopic" | "paragraph";
+        column: "center" | "left" | "right";
+        span?: 1 | 2 | 3 | undefined;
+        meta?: Record<string, unknown> | undefined;
+        href?: string | undefined;
+        action?: {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        } | undefined;
+        icon?: {
+            name: string;
+            side: "left" | "right";
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        } | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        state?: "done" | "todo" | "learning" | "skipped" | "locked" | undefined;
+        badge?: string | undefined;
+        links?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }>, "many">;
+    edges: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodString;
+        target: z.ZodString;
+        style: z.ZodOptional<z.ZodEnum<["solid", "dashed", "dotted"]>>;
+        label: z.ZodOptional<z.ZodString>;
+        route: z.ZodOptional<z.ZodEnum<["auto", "straight", "elbow", "curve"]>>;
+        arrow: z.ZodOptional<z.ZodEnum<["none", "end", "both"]>>;
+        tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+    }, "strict", z.ZodTypeAny, {
+        source: string;
+        id: string;
+        target: string;
+        label?: string | undefined;
+        style?: "dashed" | "dotted" | "solid" | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        route?: "auto" | "straight" | "elbow" | "curve" | undefined;
+        arrow?: "end" | "none" | "both" | undefined;
+    }, {
+        source: string;
+        id: string;
+        target: string;
+        label?: string | undefined;
+        style?: "dashed" | "dotted" | "solid" | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        route?: "auto" | "straight" | "elbow" | "curve" | undefined;
+        arrow?: "end" | "none" | "both" | undefined;
+    }>, "many">;
+    groups: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        tone: z.ZodOptional<z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>>;
+        from: z.ZodNumber;
+        to: z.ZodNumber;
+        columns: z.ZodOptional<z.ZodArray<z.ZodEnum<["left", "center", "right"]>, "many">>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        from: number;
+        to: number;
+        title?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        columns?: ("center" | "left" | "right")[] | undefined;
+    }, {
+        id: string;
+        from: number;
+        to: number;
+        title?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        columns?: ("center" | "left" | "right")[] | undefined;
+    }>, "many">;
+    legend: z.ZodOptional<z.ZodObject<{
+        entries: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            tone: z.ZodEnum<["primary", "secondary", "accent", "muted", "success", "info", "danger", "neutral"]>;
+            icon: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            id: string;
+            tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+            icon?: string | undefined;
+        }, {
+            label: string;
+            id: string;
+            tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+            icon?: string | undefined;
+        }>, "many">;
+        placement: z.ZodOptional<z.ZodEnum<["top", "bottom", "inline"]>>;
+    }, "strict", z.ZodTypeAny, {
+        entries: {
+            label: string;
+            id: string;
+            tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+            icon?: string | undefined;
+        }[];
+        placement?: "inline" | "bottom" | "top" | undefined;
+    }, {
+        entries: {
+            label: string;
+            id: string;
+            tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+            icon?: string | undefined;
+        }[];
+        placement?: "inline" | "bottom" | "top" | undefined;
+    }>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    direction: "down";
+    version: "roadmap/v1";
+    edges: {
+        source: string;
+        id: string;
+        target: string;
+        label?: string | undefined;
+        style?: "dashed" | "dotted" | "solid" | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        route?: "auto" | "straight" | "elbow" | "curve" | undefined;
+        arrow?: "end" | "none" | "both" | undefined;
+    }[];
+    columns: 3;
+    nodes: {
+        label: string;
+        id: string;
+        order: number;
+        kind: "button" | "label" | "legend" | "title" | "topic" | "subtopic" | "paragraph";
+        column: "center" | "left" | "right";
+        span?: 1 | 2 | 3 | undefined;
+        meta?: Record<string, unknown> | undefined;
+        href?: string | undefined;
+        action?: {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        } | undefined;
+        icon?: {
+            name: string;
+            side: "left" | "right";
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        } | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        state?: "done" | "todo" | "learning" | "skipped" | "locked" | undefined;
+        badge?: string | undefined;
+        links?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }[];
+    groups: {
+        id: string;
+        from: number;
+        to: number;
+        title?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        columns?: ("center" | "left" | "right")[] | undefined;
+    }[];
+    legend?: {
+        entries: {
+            label: string;
+            id: string;
+            tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+            icon?: string | undefined;
+        }[];
+        placement?: "inline" | "bottom" | "top" | undefined;
+    } | undefined;
+    meta?: Record<string, unknown> | undefined;
+    title?: string | undefined;
+}, {
+    direction: "down";
+    version: "roadmap/v1";
+    edges: {
+        source: string;
+        id: string;
+        target: string;
+        label?: string | undefined;
+        style?: "dashed" | "dotted" | "solid" | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        route?: "auto" | "straight" | "elbow" | "curve" | undefined;
+        arrow?: "end" | "none" | "both" | undefined;
+    }[];
+    columns: 3;
+    nodes: {
+        label: string;
+        id: string;
+        order: number;
+        kind: "button" | "label" | "legend" | "title" | "topic" | "subtopic" | "paragraph";
+        column: "center" | "left" | "right";
+        span?: 1 | 2 | 3 | undefined;
+        meta?: Record<string, unknown> | undefined;
+        href?: string | undefined;
+        action?: {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        } | undefined;
+        icon?: {
+            name: string;
+            side: "left" | "right";
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        } | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        state?: "done" | "todo" | "learning" | "skipped" | "locked" | undefined;
+        badge?: string | undefined;
+        links?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }[];
+    groups: {
+        id: string;
+        from: number;
+        to: number;
+        title?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        columns?: ("center" | "left" | "right")[] | undefined;
+    }[];
+    legend?: {
+        entries: {
+            label: string;
+            id: string;
+            tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+            icon?: string | undefined;
+        }[];
+        placement?: "inline" | "bottom" | "top" | undefined;
+    } | undefined;
+    meta?: Record<string, unknown> | undefined;
+    title?: string | undefined;
+}>, {
+    direction: "down";
+    version: "roadmap/v1";
+    edges: {
+        source: string;
+        id: string;
+        target: string;
+        label?: string | undefined;
+        style?: "dashed" | "dotted" | "solid" | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        route?: "auto" | "straight" | "elbow" | "curve" | undefined;
+        arrow?: "end" | "none" | "both" | undefined;
+    }[];
+    columns: 3;
+    nodes: {
+        label: string;
+        id: string;
+        order: number;
+        kind: "button" | "label" | "legend" | "title" | "topic" | "subtopic" | "paragraph";
+        column: "center" | "left" | "right";
+        span?: 1 | 2 | 3 | undefined;
+        meta?: Record<string, unknown> | undefined;
+        href?: string | undefined;
+        action?: {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        } | undefined;
+        icon?: {
+            name: string;
+            side: "left" | "right";
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        } | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        state?: "done" | "todo" | "learning" | "skipped" | "locked" | undefined;
+        badge?: string | undefined;
+        links?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }[];
+    groups: {
+        id: string;
+        from: number;
+        to: number;
+        title?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        columns?: ("center" | "left" | "right")[] | undefined;
+    }[];
+    legend?: {
+        entries: {
+            label: string;
+            id: string;
+            tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+            icon?: string | undefined;
+        }[];
+        placement?: "inline" | "bottom" | "top" | undefined;
+    } | undefined;
+    meta?: Record<string, unknown> | undefined;
+    title?: string | undefined;
+}, {
+    direction: "down";
+    version: "roadmap/v1";
+    edges: {
+        source: string;
+        id: string;
+        target: string;
+        label?: string | undefined;
+        style?: "dashed" | "dotted" | "solid" | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        route?: "auto" | "straight" | "elbow" | "curve" | undefined;
+        arrow?: "end" | "none" | "both" | undefined;
+    }[];
+    columns: 3;
+    nodes: {
+        label: string;
+        id: string;
+        order: number;
+        kind: "button" | "label" | "legend" | "title" | "topic" | "subtopic" | "paragraph";
+        column: "center" | "left" | "right";
+        span?: 1 | 2 | 3 | undefined;
+        meta?: Record<string, unknown> | undefined;
+        href?: string | undefined;
+        action?: {
+            label: string;
+            href?: string | undefined;
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+            actionId?: string | undefined;
+        } | undefined;
+        icon?: {
+            name: string;
+            side: "left" | "right";
+            tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        } | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        state?: "done" | "todo" | "learning" | "skipped" | "locked" | undefined;
+        badge?: string | undefined;
+        links?: {
+            label: string;
+            href: string;
+        }[] | undefined;
+    }[];
+    groups: {
+        id: string;
+        from: number;
+        to: number;
+        title?: string | undefined;
+        tone?: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral" | undefined;
+        description?: string | undefined;
+        columns?: ("center" | "left" | "right")[] | undefined;
+    }[];
+    legend?: {
+        entries: {
+            label: string;
+            id: string;
+            tone: "muted" | "info" | "success" | "danger" | "primary" | "secondary" | "accent" | "neutral";
+            icon?: string | undefined;
+        }[];
+        placement?: "inline" | "bottom" | "top" | undefined;
+    } | undefined;
+    meta?: Record<string, unknown> | undefined;
+    title?: string | undefined;
+}>;
+declare const roadmapStateOverlaySchema: z.ZodObject<{
+    version: z.ZodLiteral<"roadmap-state/v1">;
+    nodes: z.ZodRecord<z.ZodString, z.ZodEnum<["todo", "done", "learning", "skipped", "locked"]>>;
+}, "strict", z.ZodTypeAny, {
+    version: "roadmap-state/v1";
+    nodes: Record<string, "done" | "todo" | "learning" | "skipped" | "locked">;
+}, {
+    version: "roadmap-state/v1";
+    nodes: Record<string, "done" | "todo" | "learning" | "skipped" | "locked">;
+}>;
+/** Kept as an alias: the plan names this schema `roadmapStateSchema`. */
+declare const roadmapStateSchema: z.ZodObject<{
+    version: z.ZodLiteral<"roadmap-state/v1">;
+    nodes: z.ZodRecord<z.ZodString, z.ZodEnum<["todo", "done", "learning", "skipped", "locked"]>>;
+}, "strict", z.ZodTypeAny, {
+    version: "roadmap-state/v1";
+    nodes: Record<string, "done" | "todo" | "learning" | "skipped" | "locked">;
+}, {
+    version: "roadmap-state/v1";
+    nodes: Record<string, "done" | "todo" | "learning" | "skipped" | "locked">;
+}>;
+/** Throws a `ZodError` whose issues carry a path into the document. */
+declare function parseRoadmapDocument(input: unknown): RoadmapDocument;
+declare function safeParseRoadmapDocument(input: unknown): z.SafeParseReturnType<unknown, RoadmapDocument>;
+declare function parseRoadmapStateOverlay(input: unknown): RoadmapStateOverlay;
+declare function safeParseRoadmapStateOverlay(input: unknown): z.SafeParseReturnType<unknown, RoadmapStateOverlay>;
+
+/** 0 for `left`, 1 for `center`, 2 for `right`. */
+declare function columnIndex(column: RoadmapColumn): number;
+/**
+ * The CSS grid placement of a node, 1-based as `grid-column` wants it.
+ * A `span: 3` node always starts at track 1 and covers all three.
+ */
+declare function gridColumnFor(node: Pick<RoadmapNode, "column" | "span">): {
+    start: number;
+    span: number;
+};
+/** The `order` values that carry at least one node, ascending. */
+declare function rowsOf(doc: Pick<RoadmapDocument, "nodes">): number[];
+/** The highest `order` in the document, or `-1` when there is no node. */
+declare function maxRowOf(doc: Pick<RoadmapDocument, "nodes">): number;
+/**
+ * Nodes bucketed by `order`, each bucket ordered left to right. That order is
+ * also the DOM order the renderer emits, which is what makes a screen reader
+ * read the map in reading order.
+ */
+declare function nodesByRow(doc: Pick<RoadmapDocument, "nodes">): Map<number, RoadmapNode[]>;
+/**
+ * The columns that at least one node occupies.
+ *
+ * `collapseEmptyColumns` (round R4) reads this. It is the fix for the measured
+ * ITERA regression of 2026-09-03, where 512 of 776 px were reserved for two
+ * side columns that held nothing.
+ */
+declare function columnsUsed(doc: Pick<RoadmapDocument, "nodes">): RoadmapColumn[];
+/** One resolved group: its row range and the tracks it paints. */
+interface RoadmapGroupRange {
+    id: string;
+    from: number;
+    to: number;
+    columns: RoadmapColumn[];
+    /** 1-based `grid-row` start and span. */
+    row: {
+        start: number;
+        span: number;
+    };
+    /** 1-based `grid-column` start and span. Contiguous groups only (see below). */
+    column: {
+        start: number;
+        span: number;
+    };
+    /** True when `columns` is not a contiguous run — the renderer paints one box per run. */
+    fragmented: boolean;
+}
+/**
+ * Resolve every group to the range and the tracks it paints.
+ *
+ * A group is a RANGE over `order`, never a rect (plan ADR-3), so it spans the
+ * same rows at every viewport width. `columns` may be any subset; when the
+ * subset is not contiguous (`['left','right']`), `fragmented` is true and the
+ * renderer draws one box per contiguous run rather than one box that swallows
+ * the middle track.
+ */
+declare function groupRanges(doc: Pick<RoadmapDocument, "groups">): RoadmapGroupRange[];
+/** The contiguous column runs of a group — one painted box each. */
+declare function groupColumnRuns(group: RoadmapGroup): {
+    start: number;
+    span: number;
+}[];
+/** One reported collision between two things that want the same space. */
+interface RoadmapOverlap {
+    kind: "node" | "group";
+    /** `(column, order)` for a node collision; `(column, row)` for a group collision. */
+    column: RoadmapColumn;
+    row: number;
+    /** The two ids that collide, in document order. */
+    ids: [string, string];
+}
+/**
+ * Every cell claimed twice — by two nodes, or by two groups.
+ *
+ * The zod schema rejects both cases, so a parsed document always returns an
+ * empty array here. The helper exists for the CONVERTER, which must find and
+ * repair a collision before it emits a document, and for the renderer's dev
+ * assertions.
+ */
+declare function validateNoOverlap(doc: Pick<RoadmapDocument, "nodes" | "groups">): RoadmapOverlap[];
+/** One node, resolved to its grid placement. */
+interface RoadmapPlacement {
+    node: RoadmapNode;
+    row: {
+        start: number;
+        span: number;
+    };
+    column: {
+        start: number;
+        span: number;
+    };
+}
+/**
+ * Place every node in the 3-column grid, in DOM order (row by row, left to
+ * right). `rows` is the ascending list of occupied `order` values and
+ * `rowCount` is `maxRow + 1`, because the grid keeps an empty row that a group
+ * may still paint.
+ */
+declare function placeNodes(doc: Pick<RoadmapDocument, "nodes">): {
+    placements: RoadmapPlacement[];
+    rows: number[];
+    rowCount: number;
+};
+/**
+ * The first free `order` at or below `from` for a node in `columns`.
+ * The converter uses it to resolve a cell collision by shifting a node down.
+ */
+declare function firstFreeRow(taken: ReadonlySet<string>, columns: readonly RoadmapColumn[], from: number): number;
+
+export { ALLOWED_ORIGINS, AVATAR_MEMBER_PALETTE_SIZE, Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, type AlertDialogActionProps, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppNavbar, type AppNavbarProps, AppSidebar, type AppSidebarProps, AspectRatio, Avatar, AvatarFallback, AvatarGroup, AvatarImage, type AvatarSize, AvatarStatus, type AvatarStatusValue, type AvatarTone, Badge, type BadgeProps, Breadcrumb, BreadcrumbEllipsis, type BreadcrumbEntry, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, type ButtonProps, Calendar, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselDots, CarouselItem, CarouselNext, CarouselPrevious, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleHeader, CollapsibleItem, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmDialog, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DEFAULT_EDGE_ARROW, DEFAULT_EDGE_ROUTE, DEFAULT_EDGE_STYLE, DEFAULT_GROUP_TONE, DEFAULT_LEGEND_PLACEMENT, DEFAULT_NAME_COL_WIDTH, DEFAULT_NODE_SPAN, DEFAULT_NODE_STATE, type DflIframeMessage, type DflNavigateMessage, type DflReadyMessage, DflRemote, type DflRemoteProps, type DflResizeMessage, type DflSetTokenMessage, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, Gantt, type GanttDependency, type GanttMilestone, type GanttProps, type GanttStage, HoverCard, HoverCardContent, HoverCardTrigger, IconButton, type IconButtonProps, IframeAware, type IframeAwareProps, IframeContext, type IframeContextValue, type IframeMessageType, Input, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Kbd, type KbdProps, Label, LoginPage, type LoginPageProps, LoginScreen, type LoginScreenProps, MEMBER_PALETTE_SIZE, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NODE_KIND_DEFAULT_TONE, type NavGroup, type NavItem, type NavbarUserInfo, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, type OTPStatus, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PasswordInput, type PasswordInputProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, type ProgressProps, ProtectedRoute, type ProtectedRouteProps, PublishDrawer, type PublishDrawerProps, type PublishDrawerSupabase, type PublishResult, type PublishStatus, type PublisherAccount, ROADMAP_ARROWS, ROADMAP_COLUMNS, ROADMAP_EDGE_LABEL_MAX, ROADMAP_EDGE_ROUTES, ROADMAP_EDGE_STYLES, ROADMAP_LABEL_MAX, ROADMAP_LEGEND_PLACEMENTS, ROADMAP_NODE_ID_PATTERN, ROADMAP_NODE_KINDS, ROADMAP_NODE_STATES, ROADMAP_TONES, RadioGroup, RadioGroupItem, RadioGroupRow, ResizableHandle, ResizablePanel, ResizablePanelGroup, type RoadmapAction, type RoadmapArrow, type RoadmapColumn, type RoadmapDocument, type RoadmapEdge, type RoadmapEdgeRoute, type RoadmapEdgeStyle, type RoadmapGroup, type RoadmapGroupRange, type RoadmapIcon, type RoadmapLegend, type RoadmapLegendEntry, type RoadmapLegendPlacement, type RoadmapLink, type RoadmapNode, type RoadmapNodeKind, type RoadmapNodeState, type RoadmapOverlap, type RoadmapPlacement, type RoadmapStateOverlay, type RoadmapTone, ScrollArea, type ScrollAreaScrollbars, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorWithLabel, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, SonnerToaster, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, Toast, ToastAction, type ToastActionElement, ToastClose, type ToastComponentProps, ToastDescription, ToastProvider, ToastTitle, ToastViewport, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserAvatar, type UserAvatarProps, type UserInfo, UserMenu, type UserMenuItem, type UserMenuProps, avatarMemberColor, badgeVariants, barGridColumn, buttonVariants, clampPct, columnIndex, columnsCovered, columnsUsed, filterPublishableAccounts, firstFreeRow, getInitials, gridColumnFor, groupColumnRuns, groupRanges, iconButtonVariants, isAllowedOrigin, kbdVariants, labelVariants, maxRowOf, memberHueIndex, memberHueVar, navigationMenuTriggerStyle, nodesByRow, parseRoadmapDocument, parseRoadmapStateOverlay, parseTags, placeNodes, resolveEdgeArrow, resolveEdgeRoute, resolveEdgeStyle, resolveGroupColumns, resolveGroupTone, resolveLegendPlacement, resolveNameColWidth, resolveNodeSpan, resolveNodeState, resolveNodeTone, resolveWeekCount, resolveWeekLabels, roadmapActionSchema, roadmapDocumentSchema, roadmapEdgeSchema, roadmapGroupSchema, roadmapIconSchema, roadmapLegendEntrySchema, roadmapLegendSchema, roadmapLinkSchema, roadmapNodeSchema, roadmapNodeStateSchema, roadmapStateOverlaySchema, roadmapStateSchema, rowsOf, safeParseRoadmapDocument, safeParseRoadmapStateOverlay, stageProgress, toggleVariants, useFormField, useSidebar, validateNoOverlap, validatePublishForm };