cortena-ui 1.3.0 → 1.4.0

package/src/entries/form.ts

@@ -0,0 +1,24 @@
+/**
+ * `cortena-ui/form` — the form area: the pieces that pull a form dependency.
+ *
+ * `Form` and `useForm` bring react-hook-form, `zodResolver` brings zod and
+ * `@hookform/resolvers`, the date components bring react-day-picker and
+ * `Dropzone` brings react-dropzone.
+ *
+ * The light controls a form is built from — `Field`, `Input`, `Select`,
+ * `Checkbox`, `RadioGroup`, `Switch`, `Textarea`, `Combobox`, `Label` — have no
+ * heavy dependency and therefore live in `cortena-ui/core`. Each component has
+ * exactly one home so the root barrel can re-export every entry without an
+ * ambiguous name.
+ */
+
+export type { Accept, DropzoneProps, DropzoneState, FileListProps, FileRejection } from "@/components/dropzone";
+export type { CalendarProps } from "@/components/calendar";
+export type { DateFieldProps } from "@/components/date-field";
+export type { DatePickerProps, DateRangePickerProps } from "@/components/date-picker";
+export type { FormControlProps, FormDescriptionProps, FormItemProps, FormLabelProps, FormMessageProps, SubmitHandler, UseFormFieldReturn, UseFormReturn } from "@/components/form";
+export { Calendar, CalendarDayButton } from "@/components/calendar";
+export { DateField, formatDateISO, formatDateLong, formatDateShort, formatRelative, parseDateDefault, parseDateISO } from "@/components/date-field";
+export { DatePicker, DateRangePicker, formatDateDefault } from "@/components/date-picker";
+export { Dropzone, FileList, formatFileSize } from "@/components/dropzone";
+export { Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, useForm, useFormField, zodResolver } from "@/components/form";

package/src/entries/markdown.ts

@@ -0,0 +1,9 @@
+/**
+ * `cortena-ui/markdown` — the Markdown renderer.
+ *
+ * Brings react-markdown, remark-gfm and rehype-sanitize, which together are
+ * larger than the rest of the package's primitives put together.
+ */
+
+export type { CodeRendererProps, MarkdownComponents, MarkdownProps } from "@/components/markdown";
+export { Markdown, markdownSanitizeSchema } from "@/components/markdown";

package/src/entries/sortable-list.ts

@@ -0,0 +1,13 @@
+/**
+ * `cortena-ui/sortable-list` — the reorderable list.
+ *
+ * Its own entry for a specific reason: `@dnd-kit/core` and `@dnd-kit/sortable`
+ * declare no `"sideEffects"` in their package.json, so a bundler must assume
+ * importing them does something observable and keeps them even when nothing
+ * from them is used. Every other dependency here declares itself side-effect
+ * free and shakes out of the root barrel on its own; dnd-kit cannot, so it is
+ * quarantined behind an import you have to ask for.
+ */
+
+export type { SortableHandleProps, SortableListProps, SortableRenderState, SortableReorderDetails } from "@/components/sortable-list";
+export { SortableHandle, SortableList, arrayMove } from "@/components/sortable-list";

package/src/index.ts

@@ -1,98 +1,32 @@
-// cortena-ui public surface. One export line per component file; every
-// component is styled from cortena-design tokens and built on Base UI.
-export { cn } from "@/lib/cn";
-// The A2UI catalogue and renderer: the vocabulary agents draw with (05-agent-ui.md).
-export * from "@/a2ui";
-export * from "@/components/chart";
-export * from "@/components/data-table";
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/accordion";
-export { Alert, AlertDescription, AlertIcon, AlertTitle, alertVariants } from "@/components/alert";
-export type { AlertProps } from "@/components/alert";
-export { Avatar, AvatarFallback, AvatarImage } from "@/components/avatar";
-export { Badge, badgeVariants } from "@/components/badge";
-export type { BadgeProps } from "@/components/badge";
-export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from "@/components/breadcrumb";
-export type { BreadcrumbLinkProps } from "@/components/breadcrumb";
-export { ButtonLink } from "@/components/button-link";
-export type { ButtonLinkProps } from "@/components/button-link";
-export { Button, buttonVariants } from "@/components/button";
-export type { ButtonProps } from "@/components/button";
-export { Calendar, CalendarDayButton } from "@/components/calendar";
-export type { CalendarProps } from "@/components/calendar";
-export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@/components/card";
-export type { CardProps } from "@/components/card";
-export { Checkbox } from "@/components/checkbox";
-export type { CheckboxProps } from "@/components/checkbox";
-export { Chip, chipVariants } from "@/components/chip";
-export type { ChipProps } from "@/components/chip";
-export { Combobox, ComboboxChip, ComboboxChips, ComboboxClear, ComboboxCollection, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxGroupLabel, ComboboxInput, ComboboxItem, ComboboxSeparator, ComboboxStatus, ComboboxTrigger, ComboboxValue, useComboboxFilter } from "@/components/combobox";
-export type { ComboboxChipProps, ComboboxChipsProps, ComboboxContentProps, ComboboxInputProps } from "@/components/combobox";
-export { Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandLoading, CommandSeparator, CommandShortcut } from "@/components/command";
-export type { CommandDialogProps, CommandItemProps } from "@/components/command";
-export { DateField, formatDateISO, formatDateLong, formatDateShort, formatRelative, parseDateDefault, parseDateISO } from "@/components/date-field";
-export type { DateFieldProps } from "@/components/date-field";
-export { DatePicker, DateRangePicker, formatDateDefault } from "@/components/date-picker";
-export type { DatePickerProps, DateRangePickerProps } from "@/components/date-picker";
-export { Dialog, DialogBody, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger } from "@/components/dialog";
-export type { DialogContentProps } from "@/components/dialog";
-export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from "@/components/dropdown-menu";
-export type { DropdownMenuContentProps, DropdownMenuItemProps, DropdownMenuLabelProps, DropdownMenuSubTriggerProps } from "@/components/dropdown-menu";
-export { Dropzone, FileList, formatFileSize } from "@/components/dropzone";
-export type { Accept, DropzoneProps, DropzoneState, FileListProps, FileRejection } from "@/components/dropzone";
-export { EmptyState } from "@/components/empty-state";
-export type { EmptyStateProps } from "@/components/empty-state";
-export { ErrorBanner } from "@/components/error-banner";
-export type { ErrorBannerProps } from "@/components/error-banner";
-export { Field, FieldContent, FieldControl, FieldDescription, FieldError, FieldGroup, FieldLabel, Fieldset, FieldsetLegend, fieldVariants } from "@/components/field";
-export type { FieldControlProps, FieldDescriptionProps, FieldErrorItem, FieldErrorProps, FieldLabelProps, FieldProps, FieldsetLegendProps, FieldsetProps } from "@/components/field";
-export { Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, useForm, useFormField, zodResolver } from "@/components/form";
-export type { FormControlProps, FormDescriptionProps, FormItemProps, FormLabelProps, FormMessageProps, SubmitHandler, UseFormFieldReturn, UseFormReturn } from "@/components/form";
-export { Input, inputClassName } from "@/components/input";
-export type { InputProps } from "@/components/input";
-export { Kbd } from "@/components/kbd";
-export { Label, labelVariants } from "@/components/label";
-export type { LabelProps } from "@/components/label";
-export { LoadingSkeleton } from "@/components/loading-skeleton";
-export type { LoadingSkeletonPreset, LoadingSkeletonProps } from "@/components/loading-skeleton";
-export { Markdown, markdownSanitizeSchema } from "@/components/markdown";
-export type { CodeRendererProps, MarkdownComponents, MarkdownProps } from "@/components/markdown";
-export { PageHeader } from "@/components/page-header";
-export type { PageHeaderProps } from "@/components/page-header";
-export { Popover, PopoverClose, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger } from "@/components/popover";
-export type { PopoverContentProps } from "@/components/popover";
-export { Progress, ProgressIndicator, ProgressLabel, ProgressTrack, ProgressValue } from "@/components/progress";
-export type { ProgressProps } from "@/components/progress";
-export { RadioGroup, RadioGroupItem } from "@/components/radio-group";
-export type { RadioGroupItemProps, RadioGroupProps } from "@/components/radio-group";
-export { ScrollArea, ScrollBar } from "@/components/scroll-area";
-export type { ScrollAreaProps } from "@/components/scroll-area";
-export { SectionCard } from "@/components/section-card";
-export type { SectionCardProps } from "@/components/section-card";
-export { Segmented } from "@/components/segmented";
-export type { SegmentedOption, SegmentedProps } from "@/components/segmented";
-export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue } from "@/components/select";
-export type { SelectContentProps, SelectProps, SelectTriggerProps } from "@/components/select";
-export { Separator } from "@/components/separator";
-export type { SeparatorProps } from "@/components/separator";
-export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, sheetVariants } from "@/components/sheet";
-export type { SheetContentProps, SheetProps } from "@/components/sheet";
-export { Skeleton } from "@/components/skeleton";
-export { SortableHandle, SortableList, arrayMove } from "@/components/sortable-list";
-export type { SortableHandleProps, SortableListProps, SortableRenderState, SortableReorderDetails } from "@/components/sortable-list";
-export { Spinner } from "@/components/spinner";
-export type { SpinnerProps } from "@/components/spinner";
-export { StatusDot } from "@/components/status-dot";
-export type { StatusDotProps, StatusDotTone } from "@/components/status-dot";
-export { Switch } from "@/components/switch";
-export type { SwitchProps } from "@/components/switch";
-export { Tabs, TabsContent, TabsIndicator, TabsList, TabsTrigger } from "@/components/tabs";
-export { Textarea, textareaClassName } from "@/components/textarea";
-export type { TextareaProps } from "@/components/textarea";
-export { Toast, Toaster, toastVariants, useToast } from "@/components/toast";
-export type { ToastProps, ToasterProps } from "@/components/toast";
-export { Toolbar, ToolbarEnd, ToolbarSeparator, ToolbarStart } from "@/components/toolbar";
-export type { ToolbarProps } from "@/components/toolbar";
-export { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/components/tooltip";
-export type { TooltipContentProps } from "@/components/tooltip";
-export { DEFAULT_THEME_STORAGE_KEY, THEME_MESSAGE_TYPE, applyStoredTheme, applyTheme, getThemeInitScript, readStoredTheme, themeFromBackground, themeFromMessage, themeInitScript, useCortenaTheme } from "@/hooks/use-cortena-theme";
-export type { CortenaTheme, CortenaThemeMessage, ResolvedCortenaTheme, UseCortenaThemeOptions, UseCortenaThemeResult } from "@/hooks/use-cortena-theme";
+/**
+ * cortena-ui public surface.
+ *
+ * The convenient path: everything the package exports, from one import. It is
+ * genuinely tree-shakeable — the package declares `"sideEffects": false` for
+ * JavaScript and no component module runs anything at import time — so an app
+ * that imports `Button` from here ships `Button`, not the library.
+ * `scripts/bundle-probe.mjs` measures that on every `pnpm test`, and the
+ * measured numbers are in CONSUMING.md.
+ *
+ * For a size-critical bundle — an MCP app inlined into a single HTML file, for
+ * instance — import the area entry instead and do not rely on the consumer's
+ * bundler getting tree-shaking right:
+ *
+ *   cortena-ui/core           primitives, overlays, light form controls, cn, theme hook
+ *   cortena-ui/form           Form, useForm, zodResolver, date pickers, Dropzone
+ *   cortena-ui/data-table     DataTable and its parts
+ *   cortena-ui/chart          Chart and the themed Recharts primitives
+ *   cortena-ui/markdown       Markdown
+ *   cortena-ui/a2ui           the A2UI catalogue and renderer
+ *   cortena-ui/sortable-list  SortableList (dnd-kit, which cannot be shaken)
+ *
+ * Each component has exactly one home, so these unions never collide. Adding a
+ * component means adding it to its area entry, not here.
+ */
+export * from "@/entries/core";
+export * from "@/entries/form";
+export * from "@/entries/data-table";
+export * from "@/entries/chart";
+export * from "@/entries/markdown";
+export * from "@/entries/a2ui";
+export * from "@/entries/sortable-list";

package/src/lib/shakeable.ts

@@ -0,0 +1,33 @@
+/**
+ * Evaluates `build` immediately and returns its value.
+ *
+ * A pass-through with exactly one job: to let a consumer's bundler delete what
+ * it wraps.
+ *
+ * The package is one ESM module tree with no side effects, so a bundler is free
+ * to drop anything an app does not reach. It can only do that for statements it
+ * can prove are safe to skip, and a top-level call it cannot see inside —
+ * `tableFeatures({ … })`, a `z.enum(...).describe(...)` chain, `Object.freeze`
+ * over a spread — is never provably safe. The statement is kept, and with it
+ * every module it can reach. That is how `import { Button } from "cortena-ui"`
+ * came to pull recharts, nivo, exceljs, dnd-kit, react-markdown, cmdk and
+ * react-day-picker into an app that renders one button: 2,479 kB of it.
+ *
+ * Wrapped in a thunk the same work is no longer a top-level expression, and the
+ * `@__PURE__` annotation each call site carries tells the bundler the call may
+ * be dropped when its result is unused. Runtime behaviour is unchanged — the
+ * thunk runs on the line it is written — so nothing is deferred, lazy or
+ * asynchronous. Only the bundler sees a difference.
+ *
+ * Use it for a module-scope constant built by a call. Prefer a bare
+ * `/* @__PURE__ *\/` annotation where the call's arguments are literals
+ * (`cva(...)`, `cn(...)`, `React.createContext(...)`); the thunk is for the
+ * cases where the arguments themselves contain calls, because a bundler
+ * evaluates arguments even when the call around them is annotated pure.
+ *
+ * `test/bundle-probe.test.mjs` measures a real consumer bundle, which is what
+ * stops any of this being quietly undone.
+ */
+export function shakeable<T>(build: () => T): T {
+  return build();
+}