@arbidocs/blocks 0.3.142 → 0.3.143

package/dist/{index-BzrF2JbQ.d.ts → index-CNjUY3Zm.d.ts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ComponentType, ReactNode } from 'react';
+import { ReactNode, ComponentType } from 'react';
 import { LucideIcon } from 'lucide-react';
 import { UseBoundStore, StoreApi } from 'zustand';
 
@@ -269,6 +269,89 @@ declare function pct(n: number): string;
  */
 declare function formatPageRefs(pages: number[]): string;
 
+/**
+ * The one shape every timeline view in this package reads.
+ *
+ * A timeline entry is a LABELLED SPAN: something that happened, and the stretch
+ * of time it occupies. An instant is simply a span whose end equals its start —
+ * "5pm" is a moment, not a five-minute window — so callers never have to model
+ * "events" and "periods" as two different things.
+ *
+ * Views are generic over `T extends TimelineItem`, so a caller may hand over its
+ * own richer objects (a note, a matter, a booking) and get that exact type back
+ * from `onSelect` and `renderDetail` without a cast.
+ */
+interface TimelineItem {
+    /** Stable identity. Used as the React key and to track the active row. */
+    id: string;
+    /** One-line label, drawn on the bar and in the row header. */
+    label: string;
+    /** ISO 8601 start of the span. */
+    start: string;
+    /** ISO 8601 end. Omit (or equal `start`) for an instant. */
+    end?: string | null;
+    /** Longer text shown in the detail panel. */
+    description?: string;
+}
+
+interface TimelineCalendarProps<T extends TimelineItem = TimelineItem> {
+    items: T[];
+    /** Clicking a bar. The caller's own object comes back, not a copy. */
+    onSelect?: (item: T) => void;
+    /** Bars shown per week before the remainder collapses to "+n more". */
+    maxLanes?: number;
+    /** Shown when nothing in `items` carries a date. */
+    emptyState?: ReactNode;
+    className?: string;
+    /** Prefix for every `data-testid` this view emits. */
+    testId?: string;
+}
+declare function TimelineCalendar<T extends TimelineItem = TimelineItem>({ items, onSelect, maxLanes, emptyState, className, testId, }: TimelineCalendarProps<T>): react.JSX.Element;
+
+interface TimelineGanttProps<T extends TimelineItem = TimelineItem> {
+    items: T[];
+    /** The selected item, or null when the panel closes. */
+    onSelect?: (item: T | null) => void;
+    /** Extra detail-panel content for the selected item — sources, links, actions. */
+    renderDetail?: (item: T) => ReactNode;
+    /** Width of the row-label gutter, in pixels. */
+    labelWidth?: number;
+    /** Shown when nothing in `items` carries a usable date. */
+    emptyMessage?: string;
+    className?: string;
+    /** Prefix for every `data-testid` this view emits. */
+    testId?: string;
+}
+declare function TimelineGantt<T extends TimelineItem = TimelineItem>({ items, onSelect, renderDetail, labelWidth, emptyMessage, className, testId, }: TimelineGanttProps<T>): react.JSX.Element;
+
+type TimelineViewMode = 'calendar' | 'gantt';
+interface TimelineProps<T extends TimelineItem = TimelineItem> {
+    items: T[];
+    /** Pin the view. Omit to show the toggle and let the reader switch. */
+    view?: TimelineViewMode;
+    /** Which view the toggle starts on. */
+    defaultView?: TimelineViewMode;
+    onSelect?: (item: T) => void;
+    /** Extra Gantt detail-panel content — sources, links, actions. */
+    renderDetail?: (item: T) => ReactNode;
+    /** Shown when nothing carries a date. */
+    emptyMessage?: string;
+    className?: string;
+    testId?: string;
+}
+declare function Timeline<T extends TimelineItem = TimelineItem>({ items, view, defaultView, onSelect, renderDetail, emptyMessage, className, testId, }: TimelineProps<T>): react.JSX.Element;
+
+/** Month name and year, e.g. "October 2019". */
+declare function monthLabel(d: Date): string;
+/** The UTC midnight that starts the day `d` falls in. */
+declare function utcDay(d: Date): Date;
+/** `YYYY-MM-DD` for the UTC day — a stable key and testid suffix. */
+declare function dayKey(d: Date): string;
+/** Parse an ISO string, returning null rather than an Invalid Date. */
+declare function parseIso(iso: string | null | undefined): Date | null;
+/** Format a stored span the way its precision implies. '' when undated. */
+declare function formatSpan(startIso: string | null | undefined, endIso: string | null | undefined): string;
+
 /** Editorial heading block for marketing sections: eyebrow + title + lead. */
 declare function SectionHeading({ eyebrow, title, lead, align, className, invert, eyebrowClassName, }: {
     eyebrow?: string;
@@ -694,4 +777,4 @@ interface TestimonialGridProps {
 /** A grid of multiple pull-quote testimonials. */
 declare function TestimonialGrid({ items, columns, testId }: TestimonialGridProps): react.JSX.Element;
 
-export { type NavLink as $, Accordion as A, Banner as B, CTABanner as C, type FaqItem as D, FeatureGrid as E, FAQ as F, type FeatureGridProps as G, type FeatureItem as H, type FontPairing as I, Footer as J, type FooterColumn as K, type FooterLink as L, type FooterProps as M, Gallery as N, type GalleryImage as O, type GalleryProps as P, Hero as Q, type HeroCta as R, type HeroProps as S, ListBlock as T, type ListBlockProps as U, type ListItem as V, LogoCloud as W, type LogoCloudProps as X, type LogoItem as Y, MediaText as Z, type MediaTextProps as _, type AccordionItem as a, Navbar as a0, type NavbarProps as a1, type PricingPlan as a2, PricingTable as a3, type PricingTableProps as a4, RichTextBlock as a5, type RichTextBlockProps as a6, SectionHeading as a7, Spacer as a8, type SpacerProps as a9, type VideoEmbedProps as aA, applyFontVars as aB, applyStoredTheme as aC, applyThemeVars as aD, clearFontVars as aE, clearThemeVars as aF, createThemeStore as aG, daysUntil as aH, fmtDate as aI, fmtDateTime as aJ, fontPackages as aK, formatPageRefs as aL, fromNow as aM, gbp as aN, getFontPairing as aO, hrs as aP, initials as aQ, matchFontPairing as aR, pct as aS, tid as aT, toEmbedUrl as aU, toHslTriplet as aV, type StepItem as aa, Steps as ab, type StepsProps as ac, THEME_STYLE_ID as ad, type TabItem as ae, Tabs as af, type TabsProps as ag, TeamGrid as ah, type TeamGridProps as ai, type TeamMember as aj, Testimonial as ak, TestimonialGrid as al, type TestimonialGridProps as am, type TestimonialItem as an, type TestimonialProps as ao, type ThemeBundle as ap, ThemeEditor as aq, type ThemeEditorProps as ar, type ThemeEmitMode as as, type ThemeFonts as at, type ThemePreset as au, type ThemeState as av, type ThemeStoreConfig as aw, type ThemeTokens as ax, type VideoAspect as ay, VideoEmbed as az, type AccordionProps as b, type ApplyThemeOptions as c, AvatarBlock as d, type AvatarBlockProps as e, type BannerProps as f, type BannerTone as g, BlockImage as h, type BlockImageProps as i, BlockLink as j, type BlockLinkComponent as k, type BlockLinkProps as l, type CTABannerProps as m, Callout as n, type CalloutProps as o, type CalloutVariant as p, type ColorToken as q, Columns as r, type ColumnsProps as s, type ContactField as t, ContactForm as u, type ContactFormProps as v, Container as w, type ContainerProps as x, type FAQProps as y, FONT_PAIRINGS as z };
+export { type NavLink as $, Accordion as A, Banner as B, CTABanner as C, type FaqItem as D, FeatureGrid as E, FAQ as F, type FeatureGridProps as G, type FeatureItem as H, type FontPairing as I, Footer as J, type FooterColumn as K, type FooterLink as L, type FooterProps as M, Gallery as N, type GalleryImage as O, type GalleryProps as P, Hero as Q, type HeroCta as R, type HeroProps as S, ListBlock as T, type ListBlockProps as U, type ListItem as V, LogoCloud as W, type LogoCloudProps as X, type LogoItem as Y, MediaText as Z, type MediaTextProps as _, type AccordionItem as a, matchFontPairing as a$, Navbar as a0, type NavbarProps as a1, type PricingPlan as a2, PricingTable as a3, type PricingTableProps as a4, RichTextBlock as a5, type RichTextBlockProps as a6, SectionHeading as a7, Spacer as a8, type SpacerProps as a9, type TimelineCalendarProps as aA, TimelineGantt as aB, type TimelineGanttProps as aC, type TimelineItem as aD, type TimelineProps as aE, type TimelineViewMode as aF, type VideoAspect as aG, VideoEmbed as aH, type VideoEmbedProps as aI, applyFontVars as aJ, applyStoredTheme as aK, applyThemeVars as aL, clearFontVars as aM, clearThemeVars as aN, createThemeStore as aO, dayKey as aP, daysUntil as aQ, fmtDate as aR, fmtDateTime as aS, fontPackages as aT, formatPageRefs as aU, formatSpan as aV, fromNow as aW, gbp as aX, getFontPairing as aY, hrs as aZ, initials as a_, type StepItem as aa, Steps as ab, type StepsProps as ac, THEME_STYLE_ID as ad, type TabItem as ae, Tabs as af, type TabsProps as ag, TeamGrid as ah, type TeamGridProps as ai, type TeamMember as aj, Testimonial as ak, TestimonialGrid as al, type TestimonialGridProps as am, type TestimonialItem as an, type TestimonialProps as ao, type ThemeBundle as ap, ThemeEditor as aq, type ThemeEditorProps as ar, type ThemeEmitMode as as, type ThemeFonts as at, type ThemePreset as au, type ThemeState as av, type ThemeStoreConfig as aw, type ThemeTokens as ax, Timeline as ay, TimelineCalendar as az, type AccordionProps as b, monthLabel as b0, parseIso as b1, pct as b2, tid as b3, toEmbedUrl as b4, toHslTriplet as b5, utcDay as b6, type ApplyThemeOptions as c, AvatarBlock as d, type AvatarBlockProps as e, type BannerProps as f, type BannerTone as g, BlockImage as h, type BlockImageProps as i, BlockLink as j, type BlockLinkComponent as k, type BlockLinkProps as l, type CTABannerProps as m, Callout as n, type CalloutProps as o, type CalloutVariant as p, type ColorToken as q, Columns as r, type ColumnsProps as s, type ContactField as t, ContactForm as u, type ContactFormProps as v, Container as w, type ContainerProps as x, type FAQProps as y, FONT_PAIRINGS as z };