@nanisoft/prism-ui 0.10.2 → 0.15.0

package/dist/index.js

@@ -6,63 +6,136 @@
  * pull the provider, the catalogue or a stylesheet. Consumers that want one
  * item import its own subpath instead.
  */
-export { Button } from './components/ui/button';
-export { CtaLink } from './components/ui/cta-link';
-export { Badge } from './components/ui/badge';
-export { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, } from './components/ui/card';
-export { Section, SectionHeading } from './components/ui/section';
-export { Alert, AlertTitle, AlertDescription } from './components/ui/alert';
-export { Separator } from './components/ui/separator';
-export { Skeleton } from './components/ui/skeleton';
-export { Input } from './components/ui/input';
-export { Textarea } from './components/ui/textarea';
-export { Field, FieldLabel, FieldDescription, FieldError, FieldGroup, } from './components/ui/field';
-export { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption, } from './components/ui/table';
-export { Heading, Text } from './components/ui/typography';
-export { Kbd } from './components/ui/kbd';
-export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, } from './components/ui/breadcrumb';
-export { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationPrevious, PaginationNext, PaginationEllipsis, } from './components/ui/pagination';
-export { Select, SelectTrigger, SelectValue, SelectContent, SelectItem, SelectGroup, SelectLabel, SelectSeparator, } from './components/ui/select';
-export { Checkbox } from './components/ui/checkbox';
-export { RadioGroup, RadioGroupItem } from './components/ui/radio-group';
-export { Switch } from './components/ui/switch';
-export { Slider } from './components/ui/slider';
-export { Progress } from './components/ui/progress';
-export { Tooltip, TooltipTrigger, TooltipContent } from './components/ui/tooltip';
-export { Accordion, AccordionItem, AccordionTrigger, AccordionContent, } from './components/ui/accordion';
-export { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogFooter, DialogTitle, DialogDescription, DialogClose, } from './components/ui/dialog';
-export { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuGroup, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, } from './components/ui/dropdown-menu';
-export { Popover, PopoverTrigger, PopoverContent } from './components/ui/popover';
-export { Tabs, TabsList, TabsTrigger, TabsContent } from './components/ui/tabs';
-export { Avatar, AvatarImage, AvatarFallback } from './components/ui/avatar';
-export { Diagram } from './components/ui/diagram';
-export { ProductMark } from './components/ui/product-mark';
-export { Prose } from './components/ui/prose';
-export { FactList } from './components/ui/fact-list';
-export { ProductSwitcher } from './components/ui/product-switcher';
-export { Hero01 } from './blocks/hero-01';
-export { FeatureGrid01 } from './blocks/feature-grid-01';
-export { Stats01 } from './blocks/stats-01';
-export { Pricing01 } from './blocks/pricing-01';
-export { Cta01 } from './blocks/cta-01';
-export { PageHeader01 } from './blocks/page-header-01';
-export { DataTable01 } from './blocks/data-table-01';
-export { SettingsPanel01 } from './blocks/settings-panel-01';
-export { AuthForm01 } from './blocks/auth-form-01';
-export { AppShell01 } from './blocks/app-shell-01';
-export { ProcessRail01 } from './blocks/process-rail-01';
-export { StatusLedger01, STATUS_TIERS } from './blocks/status-ledger-01';
-export { ProductGrid01 } from './blocks/product-grid-01';
-export { StackGrid01 } from './blocks/stack-grid-01';
-export { LogoStrip01 } from './blocks/logo-strip-01';
-export { NoteGrid01 } from './blocks/note-grid-01';
-export { InstrumentPanel01 } from './blocks/instrument-panel-01';
-export { SiteHeader } from './blocks/site-header';
-export { SiteFooter } from './blocks/site-footer';
-export { MarketingPage } from './pages/marketing-page';
-export { DashboardPage } from './pages/dashboard-page';
-export { SettingsPage } from './pages/settings-page';
-export { AuthPage } from './pages/auth-page';
-export { NotFoundPage } from './pages/not-found-page';
-export { BlogPostPage } from './pages/blog-post-page';
-export { PACKS, MODES, parseStoredTheme, themeAttributes } from './theming';
+export { Button } from './components/ui/button.js';
+export { CtaLink } from './components/ui/cta-link.js';
+export { Badge } from './components/ui/badge.js';
+export { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, } from './components/ui/card.js';
+export { Section, SectionHeading } from './components/ui/section.js';
+export { Alert, AlertTitle, AlertDescription } from './components/ui/alert.js';
+export { Separator } from './components/ui/separator.js';
+export { Skeleton } from './components/ui/skeleton.js';
+export { Input } from './components/ui/input.js';
+export { Textarea } from './components/ui/textarea.js';
+export { Field, FieldLabel, FieldDescription, FieldError, FieldGroup, } from './components/ui/field.js';
+export { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption, } from './components/ui/table.js';
+export { Heading, Text } from './components/ui/typography.js';
+export { Kbd } from './components/ui/kbd.js';
+export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, } from './components/ui/breadcrumb.js';
+export { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationPrevious, PaginationNext, PaginationEllipsis, } from './components/ui/pagination.js';
+export { Select, SelectTrigger, SelectValue, SelectContent, SelectItem, SelectGroup, SelectLabel, SelectSeparator, } from './components/ui/select.js';
+export { Checkbox } from './components/ui/checkbox.js';
+export { RadioGroup, RadioGroupItem } from './components/ui/radio-group.js';
+export { Switch } from './components/ui/switch.js';
+export { Slider } from './components/ui/slider.js';
+export { Progress } from './components/ui/progress.js';
+export { Tooltip, TooltipTrigger, TooltipContent } from './components/ui/tooltip.js';
+export { Accordion, AccordionItem, AccordionTrigger, AccordionContent, } from './components/ui/accordion.js';
+export { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogFooter, DialogTitle, DialogDescription, DialogClose, } from './components/ui/dialog.js';
+export { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuGroup, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, } from './components/ui/dropdown-menu.js';
+export { Popover, PopoverTrigger, PopoverContent } from './components/ui/popover.js';
+export { Tabs, TabsList, TabsTrigger, TabsContent } from './components/ui/tabs.js';
+export { Avatar, AvatarImage, AvatarFallback } from './components/ui/avatar.js';
+export { Diagram } from './components/ui/diagram.js';
+export { ProductMark } from './components/ui/product-mark.js';
+export { Prose } from './components/ui/prose.js';
+export { FactList } from './components/ui/fact-list.js';
+export { ProductSwitcher } from './components/ui/product-switcher.js';
+/*
+ * The roster expansion of 2026-09. The twenty-two here are every new Component
+ * except `ModeToggle`, and the one exclusion is this file's own header rather
+ * than a judgement: importing this entry must not pull the provider, and a
+ * theme toggle is the one Component that writes the theme rather than reading
+ * it. A consumer on the declarative path uses `PrismThemeScript` and their own
+ * button; a consumer that wants this one imports it from
+ * `@nanisoft/prism-ui/components/mode-toggle`.
+ */
+export { Metric } from './components/ui/metric.js';
+export { Status } from './components/ui/status.js';
+export { Price } from './components/ui/price.js';
+export { RelativeTime } from './components/ui/relative-time.js';
+export { Sparkline } from './components/ui/sparkline.js';
+export { ContributionGraph } from './components/ui/contribution-graph.js';
+export { Chart, ChartLegend } from './components/ui/chart.js';
+export { CodeBlock, Code } from './components/ui/code-block.js';
+export { Lightbox } from './components/ui/lightbox.js';
+export { Steps } from './components/ui/steps.js';
+export { SearchField } from './components/ui/search-field.js';
+export { PasswordField } from './components/ui/password-field.js';
+export { TagGroup, Tag } from './components/ui/tag-group.js';
+export { Dropzone } from './components/ui/dropzone.js';
+export { FileUpload } from './components/ui/file-upload.js';
+export { MiniCalendar } from './components/ui/mini-calendar.js';
+export { ListPanel, ListPanelHeader, ListPanelBody, ListPanelFooter } from './components/ui/list-panel.js';
+export { DataToolbar, DataToolbarGroup } from './components/ui/data-toolbar.js';
+export { FilterPanel, FilterPanelHeader, FilterPanelFooter } from './components/ui/filter-panel.js';
+export { AvatarGroup } from './components/ui/avatar-group.js';
+export { PackSwatch } from './components/ui/pack-swatch.js';
+export { Announcement } from './components/ui/announcement.js';
+export { Hero01 } from './blocks/hero-01/index.js';
+export { FeatureGrid01 } from './blocks/feature-grid-01/index.js';
+export { Stats01 } from './blocks/stats-01/index.js';
+export { Pricing01 } from './blocks/pricing-01/index.js';
+export { Cta01 } from './blocks/cta-01/index.js';
+export { PageHeader01 } from './blocks/page-header-01/index.js';
+export { DataTable01 } from './blocks/data-table-01/index.js';
+export { SettingsPanel01 } from './blocks/settings-panel-01/index.js';
+export { AuthForm01 } from './blocks/auth-form-01/index.js';
+export { AppShell01 } from './blocks/app-shell-01/index.js';
+export { ProcessRail01 } from './blocks/process-rail-01/index.js';
+export { StatusLedger01, STATUS_TIERS } from './blocks/status-ledger-01/index.js';
+export { RunConsole01 } from './blocks/run-console-01/index.js';
+export { ProductGrid01 } from './blocks/product-grid-01/index.js';
+export { StackGrid01 } from './blocks/stack-grid-01/index.js';
+export { LogoStrip01 } from './blocks/logo-strip-01/index.js';
+export { NoteGrid01 } from './blocks/note-grid-01/index.js';
+export { InstrumentPanel01 } from './blocks/instrument-panel-01/index.js';
+export { SiteHeader } from './blocks/site-header/index.js';
+export { SiteFooter } from './blocks/site-footer/index.js';
+export { MarketingPage } from './pages/marketing-page/index.js';
+export { DashboardPage } from './pages/dashboard-page/index.js';
+export { SettingsPage } from './pages/settings-page/index.js';
+export { AuthPage } from './pages/auth-page/index.js';
+export { NotFoundPage } from './pages/not-found-page/index.js';
+export { BlogPostPage } from './pages/blog-post-page/index.js';
+export { PACKS, MODES, parseStoredTheme, themeAttributes } from './theming/index.js';
+/* The nine Components of the 2026-09 component sweep, re-exported from the package
+ * root so `@nanisoft/prism-ui` and `@nanisoft/prism-ui/components` agree on what
+ * the package publishes. One list, two doors. */
+export { PackSwitcher } from './components/ui/pack-switcher.js';
+export { Pill } from './components/ui/pill.js';
+export { BillingSource, BillingSources } from './components/ui/billing-source.js';
+export { Drawer, DrawerTrigger, DrawerContent, DrawerHeader, DrawerBody, DrawerFooter, DrawerTitle, DrawerDescription, DrawerHandle, DrawerClose } from './components/ui/drawer.js';
+export { ImageZoom } from './components/ui/image-zoom.js';
+export { VideoPlayer } from './components/ui/video-player.js';
+export { EmojiPicker } from './components/ui/emoji-picker.js';
+export { RepoStars } from './components/ui/repo-stars.js';
+export { ChoiceCard } from './components/ui/choice-card.js';
+/* The three data-figure Components, re-exported from the package root. */
+export { IntensityGrid } from './components/ui/intensity-grid.js';
+export { ProportionList } from './components/ui/proportion-list.js';
+export { CohortGrid } from './components/ui/cohort-grid.js';
+/* The four Components the strict audit kept, re-exported from the package root. */
+export { MultiCombobox } from './components/ui/multi-combobox.js';
+export { CreatableCombobox } from './components/ui/creatable-combobox.js';
+export { RangeField } from './components/ui/range-field.js';
+export { PlatformModifierKey } from './components/ui/platform-modifier-key.js';
+/* The last five Components the strict audit kept, re-exported from the package root. */
+export { ImageListField } from './components/ui/image-list-field.js';
+export { RepeatableRows } from './components/ui/repeatable-rows.js';
+export { TextFormatToolbar } from './components/ui/text-format-toolbar.js';
+export { PromptComposer } from './components/ui/prompt-composer.js';
+export { LifecycleButton } from './components/ui/lifecycle-button.js';
+/* The last thirteen Components the strict audit kept, re-exported from the root. */
+export { ReorderableList } from './components/ui/reorderable-list.js';
+export { Checklist } from './components/ui/checklist.js';
+export { FormDialog } from './components/ui/form-dialog.js';
+export { FormWizard } from './components/ui/form-wizard.js';
+export { StatefulTable } from './components/ui/stateful-table.js';
+export { NestedTabs } from './components/ui/nested-tabs.js';
+export { MegaMenu } from './components/ui/mega-menu.js';
+export { TaskProgress } from './components/ui/task-progress.js';
+export { SplitButton } from './components/ui/split-button.js';
+export { Stepper } from './components/ui/stepper.js';
+export { OverflowActions } from './components/ui/overflow-actions.js';
+export { SelectionToolbar } from './components/ui/selection-toolbar.js';
+export { MoneyField } from './components/ui/money-field.js';

package/dist/lib/rank.d.ts

@@ -0,0 +1,69 @@
+/**
+ * One scorer for every surface that searches.
+ *
+ * The ranking is shared because the *answer* is shared. A command palette and a
+ * combobox that each carried their own scorer would agree for a month and then
+ * diverge on the case nobody thought about, and a reader would find that a query
+ * which floats to the top in one surface sinks in the other. That is the same
+ * defect as the catalogue and a second list about the same items, and it is the
+ * reason this lives in one module rather than in whichever Component was written
+ * first.
+ *
+ * It lives here rather than in either Component for a second reason: the first
+ * version put it in `command-palette` and the combobox imported it from there, so
+ * a leaf depended on a composite. That compiles, it typechecks, and it is still
+ * wrong, because the next surface to need a scorer has no honest module to import
+ * and the tempting answer is to copy the one it can see.
+ *
+ * This is not an Item. It is not in the catalogue, it has no documentation page and
+ * no Demo, and it is not exported from the package, because it is the inside of
+ * two Items rather than something a consumer composes.
+ */
+/**
+ * How well a match fits, ordered.
+ *
+ * The order is the feature rather than a detail. A surface that filters without
+ * ranking shows every match in whatever order the items happened to be declared,
+ * so the item the reader meant sits below one that merely mentions their query,
+ * and they scroll. Ranking by where the match falls puts it first, which is the
+ * whole reason a searchable surface beats a menu.
+ *
+ * `prefix` is separate from `wordStart` because collapsing them means a command
+ * whose name *begins* with the query ties with one that has it at the start of a
+ * later word, and a reader who typed the start of a name is the reader who meant
+ * that name.
+ */
+export declare const RANKS: {
+    /** The query is the start of the label. */
+    readonly prefix: 0;
+    /** The query starts a word inside the label. */
+    readonly wordStart: 1;
+    /** The query appears inside the label. */
+    readonly substring: 2;
+    /** The query appears only in the keywords. */
+    readonly keyword: 3;
+    /** No match. */
+    readonly none: 4;
+};
+/** One ranked match: where the query fell, and which characters it covered. */
+export type Rank = {
+    /** How good the match is. Lower is better. */
+    rank: number;
+    /**
+     * The character range in the text that matched, absent when nothing matched or
+     * when the match was in a keyword rather than in the text.
+     *
+     * A range rather than a boolean is what lets a surface emphasise the matched
+     * characters instead of the whole row.
+     */
+    range?: readonly [number, number];
+};
+/**
+ * Where the first match of `query` falls in `text`, and how good it is.
+ *
+ * An empty query is a prefix match covering nothing, which is what makes an
+ * untyped surface render every row with nothing emphasised rather than needing a
+ * separate branch for the empty case at each call site.
+ */
+export declare function locate(text: string, query: string): Rank;
+//# sourceMappingURL=rank.d.ts.map

package/dist/lib/rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.d.ts","sourceRoot":"","sources":["../../src/lib/rank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK;IAChB,2CAA2C;;IAE3C,gDAAgD;;IAEhD,0CAA0C;;IAE1C,8CAA8C;;IAE9C,gBAAgB;;CAER,CAAA;AAEV,+EAA+E;AAC/E,MAAM,MAAM,IAAI,GAAG;IACjB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAsBxD"}

package/dist/lib/rank.js

@@ -0,0 +1,77 @@
+/**
+ * One scorer for every surface that searches.
+ *
+ * The ranking is shared because the *answer* is shared. A command palette and a
+ * combobox that each carried their own scorer would agree for a month and then
+ * diverge on the case nobody thought about, and a reader would find that a query
+ * which floats to the top in one surface sinks in the other. That is the same
+ * defect as the catalogue and a second list about the same items, and it is the
+ * reason this lives in one module rather than in whichever Component was written
+ * first.
+ *
+ * It lives here rather than in either Component for a second reason: the first
+ * version put it in `command-palette` and the combobox imported it from there, so
+ * a leaf depended on a composite. That compiles, it typechecks, and it is still
+ * wrong, because the next surface to need a scorer has no honest module to import
+ * and the tempting answer is to copy the one it can see.
+ *
+ * This is not an Item. It is not in the catalogue, it has no documentation page and
+ * no Demo, and it is not exported from the package, because it is the inside of
+ * two Items rather than something a consumer composes.
+ */
+/**
+ * How well a match fits, ordered.
+ *
+ * The order is the feature rather than a detail. A surface that filters without
+ * ranking shows every match in whatever order the items happened to be declared,
+ * so the item the reader meant sits below one that merely mentions their query,
+ * and they scroll. Ranking by where the match falls puts it first, which is the
+ * whole reason a searchable surface beats a menu.
+ *
+ * `prefix` is separate from `wordStart` because collapsing them means a command
+ * whose name *begins* with the query ties with one that has it at the start of a
+ * later word, and a reader who typed the start of a name is the reader who meant
+ * that name.
+ */
+export const RANKS = {
+    /** The query is the start of the label. */
+    prefix: 0,
+    /** The query starts a word inside the label. */
+    wordStart: 1,
+    /** The query appears inside the label. */
+    substring: 2,
+    /** The query appears only in the keywords. */
+    keyword: 3,
+    /** No match. */
+    none: 4,
+};
+/**
+ * Where the first match of `query` falls in `text`, and how good it is.
+ *
+ * An empty query is a prefix match covering nothing, which is what makes an
+ * untyped surface render every row with nothing emphasised rather than needing a
+ * separate branch for the empty case at each call site.
+ */
+export function locate(text, query) {
+    if (query === '')
+        return { rank: RANKS.prefix, range: [0, 0] };
+    const haystack = text.toLowerCase();
+    const needle = query.toLowerCase();
+    const at = haystack.indexOf(needle);
+    if (at === -1)
+        return { rank: RANKS.none };
+    // A match at the very start is a prefix match, which is the best possible
+    // answer, and it has to be its own tier rather than sharing the word-start one.
+    if (at === 0)
+        return { rank: RANKS.prefix, range: [0, needle.length] };
+    // Otherwise a whole-word match beats a match inside a word, and the boundary is
+    // the character before it. Without this, "se" in "Settings" would outrank
+    // "Reset workspace" for a reader who typed "set". The boundary is tested as a
+    // class rather than compared to a space, because a space is a string literal
+    // and the copy gate is right to ask what a lone space in a Component is for.
+    const isWordStart = /[\s\-/]/.test(haystack.at(at - 1) ?? '');
+    return {
+        rank: isWordStart ? RANKS.wordStart : RANKS.substring,
+        range: [at, at + needle.length],
+    };
+}

package/dist/lib/utils.d.ts

@@ -1,3 +1,32 @@
 import { type ClassValue } from 'clsx';
 export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * The calendar day a moment falls on, as a `YYYY-MM-DD` key.
+ *
+ * **This is here rather than in three Blocks because three Blocks needed it and
+ * the fourth would have been the argument.** `activity-feed-01`, `audit-log-01`
+ * and `calendar-01` each grew their own copy while the roster was being authored,
+ * each with its own three-line JSDoc saying the duplication was a decision and
+ * naming this file as the right home. Three copies of a five-line function that
+ * computes a date are three places a bug would be fixed once and stay broken
+ * twice, so this module holds the one and the three Blocks import it.
+ *
+ * `lib/utils.ts` is the file every registry item already ships beside itself, so
+ * the shared implementation needs no new path in the generated registry and no
+ * new entry for a consumer to resolve. That is why the helper is here and not in
+ * a second `lib` module.
+ *
+ * **The day is the runtime's, not the reader's**, and the JSDoc on each of the
+ * three Blocks says what to do about that: a consumer whose records are grouped
+ * by a named zone groups them itself and passes one entry per group with grouping
+ * off. Prism ships no calendar, and a Block cannot pick the reader's zone without
+ * a prop that would be a guess dressed as a setting. A caller who needs a
+ * particular zone composes `Intl.DateTimeFormat` with one and passes the key.
+ *
+ * Accepts the same three shapes the Blocks pass: epoch milliseconds, a `Date`,
+ * and a date string. A string that is not parseable returns an empty key rather
+ * than throwing, because the Blocks treat an absent key as a moment with no group
+ * and a throw would take a whole record list down over one bad row.
+ */
+export declare function dayKey(at: number | string | Date): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAA;AAG5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAA;AAG5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAKzD"}

package/dist/lib/utils.js

@@ -3,3 +3,38 @@ import { twMerge } from 'tailwind-merge';
 export function cn(...inputs) {
     return twMerge(clsx(inputs));
 }
+/**
+ * The calendar day a moment falls on, as a `YYYY-MM-DD` key.
+ *
+ * **This is here rather than in three Blocks because three Blocks needed it and
+ * the fourth would have been the argument.** `activity-feed-01`, `audit-log-01`
+ * and `calendar-01` each grew their own copy while the roster was being authored,
+ * each with its own three-line JSDoc saying the duplication was a decision and
+ * naming this file as the right home. Three copies of a five-line function that
+ * computes a date are three places a bug would be fixed once and stay broken
+ * twice, so this module holds the one and the three Blocks import it.
+ *
+ * `lib/utils.ts` is the file every registry item already ships beside itself, so
+ * the shared implementation needs no new path in the generated registry and no
+ * new entry for a consumer to resolve. That is why the helper is here and not in
+ * a second `lib` module.
+ *
+ * **The day is the runtime's, not the reader's**, and the JSDoc on each of the
+ * three Blocks says what to do about that: a consumer whose records are grouped
+ * by a named zone groups them itself and passes one entry per group with grouping
+ * off. Prism ships no calendar, and a Block cannot pick the reader's zone without
+ * a prop that would be a guess dressed as a setting. A caller who needs a
+ * particular zone composes `Intl.DateTimeFormat` with one and passes the key.
+ *
+ * Accepts the same three shapes the Blocks pass: epoch milliseconds, a `Date`,
+ * and a date string. A string that is not parseable returns an empty key rather
+ * than throwing, because the Blocks treat an absent key as a moment with no group
+ * and a throw would take a whole record list down over one bad row.
+ */
+export function dayKey(at) {
+    const date = at instanceof Date ? at : new Date(at);
+    if (Number.isNaN(date.getTime()))
+        return '';
+    const two = (value) => String(value).padStart(2, '0');
+    return `${date.getFullYear()}-${two(date.getMonth() + 1)}-${two(date.getDate())}`;
+}

package/dist/live/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Every Prism live surface.
+ *
+ * A live surface is the fourth Kind: content that changes over time **without a
+ * navigation event**. A Block takes its content as props, so it is rendered once
+ * and re-rendered when the consumer's framework decides; a live surface's content
+ * changes on its own, which no amount of prop-passing expresses.
+ *
+ * The `-NN` suffix is the live-family variant ordinal, as it is for Blocks and
+ * Pages. They are client Components because of what they are rather than as an
+ * accident: a surface that receives events owns the subscription that delivers
+ * them. That is not the same as being the only client code in the package, which
+ * this file used to claim and which stopped being true when the roster grew
+ * Blocks and a Page that hold a handler. The claim that still holds, and is the
+ * one worth keeping, is narrower: **a live surface is the only Item Prism ships
+ * that receives its own content over a subscription rather than being handed it
+ * as props.**
+ *
+ * **Nothing here opens a connection.** A live surface takes a `subscribe` function
+ * the consumer supplies and a function it tears down, so Prism owns no socket, no
+ * endpoint, no retry policy and no persistence, and a consumer acquires no client
+ * runtime by importing one. The transport is the consumer's fact and this is where
+ * that boundary is stated once.
+ */
+export { RunStream01 } from './run-stream-01/index.js';
+export type { RunStream01Props, RunEvent, RunEventRole, RunStatus, RunSubscribe, } from './run-stream-01/index.js';
+export { ToolLedger01 } from './tool-ledger-01/index.js';
+export type { ToolLedger01Props, ToolCall, ToolCallState, ToolSubscribe } from './tool-ledger-01/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/live/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,YAAY,EACV,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,YAAY,GACb,MAAM,iBAAiB,CAAA;AAMxB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/live/index.js

@@ -0,0 +1,29 @@
+/**
+ * Every Prism live surface.
+ *
+ * A live surface is the fourth Kind: content that changes over time **without a
+ * navigation event**. A Block takes its content as props, so it is rendered once
+ * and re-rendered when the consumer's framework decides; a live surface's content
+ * changes on its own, which no amount of prop-passing expresses.
+ *
+ * The `-NN` suffix is the live-family variant ordinal, as it is for Blocks and
+ * Pages. They are client Components because of what they are rather than as an
+ * accident: a surface that receives events owns the subscription that delivers
+ * them. That is not the same as being the only client code in the package, which
+ * this file used to claim and which stopped being true when the roster grew
+ * Blocks and a Page that hold a handler. The claim that still holds, and is the
+ * one worth keeping, is narrower: **a live surface is the only Item Prism ships
+ * that receives its own content over a subscription rather than being handed it
+ * as props.**
+ *
+ * **Nothing here opens a connection.** A live surface takes a `subscribe` function
+ * the consumer supplies and a function it tears down, so Prism owns no socket, no
+ * endpoint, no retry policy and no persistence, and a consumer acquires no client
+ * runtime by importing one. The transport is the consumer's fact and this is where
+ * that boundary is stated once.
+ */
+export { RunStream01 } from './run-stream-01/index.js';
+/*
+ * Derived by the maintainer rather than authored: each entry is read out of the Item own
+ * index module, so an Item and its barrel line cannot come apart. */
+export { ToolLedger01 } from './tool-ledger-01/index.js';

package/dist/live/run-stream-01/index.d.ts

@@ -0,0 +1,3 @@
+export { RunStream01, default } from './run-stream.js';
+export type { RunStream01Props, RunEvent, RunEventRole, RunStatus, RunSubscribe } from './run-stream.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/live/run-stream-01/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/live/run-stream-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACnD,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA"}

package/dist/live/run-stream-01/index.js

@@ -0,0 +1 @@
+export { RunStream01, default } from './run-stream.js';

package/dist/live/run-stream-01/run-stream.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Who produced an event, as a closed set.
+ *
+ * The four are the ones an agent run actually has, and they are closed because the
+ * treatment is not the caller's: a role is a slot for a colour, a mark and an
+ * announcement, and a free-text role would be a string with no rendering behind it.
+ * The **words** are still the caller's, in `message`. Prism owns which role looks
+ * like what, and ships none of the labels.
+ */
+export type RunEventRole = 'agent' | 'tool' | 'system' | 'error';
+/** One event, as the surface receives it. */
+export type RunEvent = {
+    /** Stable across re-renders, so an event is never re-announced because its index moved. */
+    id: string;
+    role: RunEventRole;
+    /** Epoch milliseconds, used for order and for the elapsed column. */
+    at: number;
+    /** What happened, in the consumer's words. */
+    message: string;
+    /** Optional second line: a tool's arguments, a path, a code. */
+    detail?: string;
+};
+/** Where a run has got to. The tiers are Prism's; the words beside them are the caller's. */
+export type RunStatus = 'queued' | 'running' | 'waiting' | 'done' | 'failed';
+/**
+ * How the surface receives events.
+ *
+ * The consumer owns the socket, the transport and the persistence, so this is a
+ * function it supplies rather than a connection Prism opens. It is called once on
+ * mount and must return an unsubscribe, which is what makes a WebSocket, an
+ * `EventSource`, a polling timer or a test's own array all the same shape to the
+ * surface. Nothing here knows which one it got.
+ */
+export type RunSubscribe = (emit: (event: RunEvent) => void) => () => void;
+export type RunStream01Props = {
+    /**
+     * Called once to begin receiving, and again whenever `resubscribeKey` changes.
+     * Must return an unsubscribe; the surface calls it on unmount and before
+     * re-subscribing, so a consumer that returns nothing leaks its connection.
+     */
+    subscribe: RunSubscribe;
+    /**
+     * Which run this surface is showing, and the reset lever.
+     *
+     * Changing it **clears the log and reseeds it from `initial`**, as well as
+     * tearing the subscription down and opening a new one. A run is identified by
+     * whatever the consumer already uses to identify it, so a second run in the same
+     * surface is a new subscription rather than two consumers of one, and it is a new
+     * log rather than the old run's events with the new run's appended, which is the
+     * reading a reader would not distinguish from one run being longer than it was.
+     */
+    resubscribeKey?: string | number;
+    /**
+     * The events already known when this run is opened, so a surface opened mid-run
+     * is not blank. Oldest first.
+     *
+     * Read when the run is opened, and again whenever `resubscribeKey` changes. It is
+     * **not** read on every render: a prop that looked like the current event list
+     * and quietly seeded only once would be a trap, and a prop that re-seeded on
+     * every render would discard the stream. This seeds, and the stream takes over.
+     */
+    initial?: readonly RunEvent[];
+    /** Where the run has got to. */
+    status?: RunStatus;
+    /** The word beside the status. Required when a status is passed. */
+    statusLabel?: string;
+    /** Optional label above the surface's heading. See the No-Default-Eyebrow Rule. */
+    eyebrow?: string;
+    /** The surface's heading. Omit it for one composed under its own. */
+    title?: string;
+    /** One or two sentences under the heading. */
+    description?: string;
+    /** What the surface says when it holds no events yet. */
+    emptyLabel?: string;
+    /**
+     * The accessible name of the scrolling region.
+     *
+     * Required, because `ScrollArea` requires it and the reason is the right one: a
+     * scroll region with no name is announced as a group of focusable nothing, and a
+     * keyboard reader who tabs into it cannot tell what is in it or what is past the
+     * edge. The name is the consumer's word, as every other word here is.
+     */
+    eventsLabel: string;
+    /** Announced to assistive technology as events arrive. */
+    liveLabel?: string;
+    /** How many events to keep. Older events fall off the top. */
+    limit?: number;
+    className?: string;
+};
+/**
+ * The event log of a run, receiving events as they arrive.
+ *
+ * **This is the first surface in the package that is a client Component**, and that
+ * is the whole of what the fourth Kind is for. A Block takes its content as props,
+ * so it is rendered once and re-rendered when the consumer's framework decides; a
+ * `live` surface's content changes **without a navigation event**, which no amount
+ * of prop-passing expresses. So this owns a subscription and the accumulation
+ * behind it.
+ *
+ * **Prism owns the surface, the consumer owns the transport.** `subscribe` is a
+ * function the consumer supplies and a function it tears down. There is no socket
+ * in this file, no endpoint, no retry policy and no persistence, and there is no
+ * provider to mount: a consumer that already has a connection passes it in, and one
+ * that does not has not acquired a client runtime by importing this.
+ *
+ * **The events are kept sorted by `at`, not by arrival.** A consumer's transport
+ * decides when a message is delivered, and a reconnect can deliver an older event
+ * after a newer one. Sorting on arrival would put a run's own history out of order
+ * in exactly the case where a reader is most likely to be watching. Ties break on
+ * `id`, so the order is total and two runs of the same suite render the same log.
+ *
+ * **New events are announced once, politely, and the log itself is not a live
+ * region.** Announcing a growing list would make a screen reader read the whole run
+ * again on every arrival, which is the failure a live region on a list guarantees.
+ * `LiveRegion` carries the newest event's message alone, and the log is an ordinary
+ * scrollable list a reader can move through at their own pace.
+ *
+ * `limit` bounds what is held, because an agent run can produce thousands of events
+ * and a surface that grows without bound is a surface that eventually stops
+ * repainting. Older events fall off the top, which is the direction a reader wants:
+ * the run's beginning is the part they can scroll back to in another surface.
+ */
+export declare function RunStream01({ subscribe, resubscribeKey, initial, status, statusLabel, eyebrow, title, description, emptyLabel, eventsLabel, liveLabel, limit, className, }: RunStream01Props): import("react").JSX.Element;
+export default RunStream01;
+//# sourceMappingURL=run-stream.d.ts.map