@photon-ai/pho-ui 3.0.0 → 4.2.0

package/dist/components/trace.js

@@ -1,44 +1,45 @@
 "use client";
-import { A as s, B as e, C as i, D as n, E as r, F as l, I as t, L as o, M as p, N as c, O as T, P as I, R as S, S as m, T as u, _ as d, a as v, b, c as w, d as V, f, g as D, h as _, i as x, j as L, k as g, l as k, m as A, n as E, o as F, p as N, r as z, s as B, t as O, u as P, v as R, w as W, x as y, y as C, z as G } from "../chunks/trace-Ba1RMBfk.js";
+import { A as s, B as e, C as i, D as n, E as l, F as r, I as t, L as o, M as p, N as c, O as T, P as u, R as I, S, T as m, V as d, _ as v, a as b, b as V, c as w, d as f, f as D, g as L, h as _, i as k, j as x, k as g, l as A, m as E, n as F, o as N, p as y, r as z, s as B, t as O, u as P, v as R, w as W, x as C, y as G, z as K } from "../chunks/trace-Hku-rImp.js";
 export {
-  m as FULL_VIEW,
-  f as GEN_AI_KINDS,
-  i as MIN_VIEW_WIDTH,
-  C as SpanPrimitive,
+  i as FULL_VIEW,
+  y as GEN_AI_KINDS,
+  W as MIN_VIEW_WIDTH,
+  V as SpanPrimitive,
   O as Trace,
-  W as allCollapsed,
-  u as ancestorIds,
-  N as attribute,
-  A as attributeText,
-  x as axisTicks,
-  v as barGeometry,
-  r as buildSpanTree,
-  n as clampView,
-  T as collapseAllIds,
-  g as collapseOneLevel,
-  s as deriveSpanTree,
-  L as expandOneLevel,
-  p as filterSpans,
-  E as footerTotals,
-  F as formatDuration,
+  m as allCollapsed,
+  l as ancestorIds,
+  E as attribute,
+  _ as attributeText,
+  k as axisTicks,
+  b as barGeometry,
+  n as buildSpanTree,
+  T as clampView,
+  g as collapseAllIds,
+  s as collapseOneLevel,
+  x as deriveSpanTree,
+  p as expandOneLevel,
+  c as filterSpans,
+  F as footerTotals,
+  N as formatDuration,
   B as formatTick,
-  _ as genAIKind,
-  c as isFullView,
+  L as genAIKind,
+  u as isFullView,
   w as labeledTicks,
-  k as niceStep,
-  P as normalizeSpans,
-  I as panView,
-  D as peerService,
-  d as spanDecorationIcon,
-  V as spanDuration,
-  R as spanPills,
-  l as spanTimelineBarVars,
+  A as layoutTickLabels,
+  P as niceStep,
+  f as normalizeSpans,
+  r as panView,
+  v as peerService,
+  R as spanDecorationIcon,
+  D as spanDuration,
+  G as spanPills,
+  t as spanTimelineBarVars,
   z as traceBulletInset,
-  t as traceRange,
-  b as useSpan,
-  y as useSpanTree,
-  o as viewFraction,
-  S as viewToRange,
-  G as visibleSpans,
-  e as zoomView
+  o as traceRange,
+  C as useSpan,
+  S as useSpanTree,
+  I as viewFraction,
+  K as viewToRange,
+  e as visibleSpans,
+  d as zoomView
 };

package/dist/index.js

@@ -3,181 +3,182 @@ import { t as s } from "./chunks/cn-ChIgwEl3.js";
 import { t as r } from "./chunks/is-react-component-DSnjtBmo.js";
 import { t as e } from "./chunks/resolve-variant-CcD8iG5l.js";
 import { n as E, t as S } from "./chunks/link-provider-DXzDQ08N.js";
-import { BAR_RISE_PX as n, BLUR_PX as m, EASE_POP as I, EASE_STACK as T, FADE_ENTRANCE as p, FADE_SWAP as A, PRESS_SCALE as R, PRESS_SCALE_ROW as l, RISE_PX as C, SPRING_ENTRANCE as B, SPRING_PRESS as f, SPRING_PRESS_INLINE as N, SPRING_PRESS_QUICK as P, SPRING_SETTLE as u, TRAVEL_LINEAR as L, fadeThroughBlur as D, riseIn as c } from "./motion.js";
+import { BAR_RISE_PX as n, BLUR_PX as m, EASE_POP as I, EASE_STACK as T, FADE_ENTRANCE as p, FADE_SWAP as A, PRESS_SCALE as R, PRESS_SCALE_ROW as l, RISE_PX as C, SPRING_ENTRANCE as B, SPRING_PRESS as f, SPRING_PRESS_INLINE as N, SPRING_PRESS_QUICK as P, SPRING_SETTLE as u, TRAVEL_LINEAR as L, fadeThroughBlur as c, riseIn as D } from "./motion.js";
 import { n as V, r as d, t as U } from "./chunks/use-press-pulse-IbNstUT0.js";
-import { n as F, t as b } from "./chunks/use-copy-D6JwKUll.js";
+import { n as b, t as F } from "./chunks/use-copy-D6JwKUll.js";
 import "./utils.js";
-import { a as h, c as v, d as k, i as w, l as W, n as x, o as H, r as z, s as K, t as y, u as X } from "./chunks/button-CdqS_t5a.js";
+import { a as h, c as k, d as v, i as w, l as W, n as x, o as H, r as y, s as z, t as K, u as X } from "./chunks/button-CdqS_t5a.js";
 import { a as Z, c as j, i as J, l as Q, n as q, o as $, r as aa, s as sa, t as ta } from "./chunks/error-BAQgnde7.js";
-import { A as oa, B as ea, C as ia, D as Ea, E as Sa, F as _a, I as na, L as ma, M as Ia, N as Ta, O as pa, P as Aa, R as Ra, S as la, T as Ca, _ as Ba, a as fa, b as Na, c as Pa, d as ua, f as La, g as Da, h as ca, i as Oa, j as Va, k as da, l as Ua, m as Ga, n as Fa, o as ba, p as Ma, r as ga, s as ha, t as va, u as ka, v as wa, w as Wa, x as xa, y as Ha, z as za } from "./chunks/trace-Ba1RMBfk.js";
-import { n as ya, t as Xa } from "./chunks/date-picker-Bwa6J4ik.js";
-import { n as Za, t as ja } from "./chunks/copy-button-B_B15mEi.js";
-import { a as Qa, c as qa, d as $a, i as as, l as ss, n as ts, o as rs, r as os, s as es, t as is, u as Es } from "./chunks/sidebar-DRPe5CAh.js";
-import { t as _s } from "./chunks/input-DjvZoF8v.js";
-import { i as ms, n as Is, r as Ts, t as ps } from "./chunks/filter-bar-D9lBBr4z.js";
-import { a as Rs } from "./chunks/data-table-DcwCgXJU.js";
-import { n as Cs, t as Bs } from "./chunks/code-block-BuDIo8Q0.js";
-import { n as Ns, t as Ps } from "./chunks/stat-hnNqjWVG.js";
-import { t as Ls } from "./chunks/calendar-4OFiCLAv.js";
-import { t as cs } from "./chunks/close-button-GvqWbLl0.js";
-import { t as Vs } from "./chunks/input-group-fc9_jD4d.js";
-import { n as Us, t as Gs } from "./chunks/card-DhDwtSi9.js";
-import { n as bs, t as Ms } from "./chunks/dialog-BwfUFn6B.js";
-import { i as hs, n as vs, r as ks, t as ws } from "./chunks/status-view-C8tabjDu.js";
-import { a as xs, c as Hs, d as zs, f as Ks, i as ys, l as Xs, m as Ys, n as Zs, o as js, p as Js, r as Qs, s as qs, t as $s, u as at } from "./chunks/basic-page-CYDwfVjO.js";
-import { i as tt, n as rt, r as ot, t as et } from "./chunks/legend-C0mU7dqd.js";
+import { A as oa, B as ea, C as ia, D as Ea, E as Sa, F as _a, I as na, L as ma, M as Ia, N as Ta, O as pa, P as Aa, R as Ra, S as la, T as Ca, V as Ba, _ as fa, a as Na, b as Pa, c as ua, d as La, f as ca, g as Da, h as Oa, i as Va, j as da, k as Ua, l as Ga, m as ba, n as Fa, o as Ma, p as ga, r as ha, s as ka, t as va, u as wa, v as Wa, w as xa, x as Ha, y as ya, z as za } from "./chunks/trace-Hku-rImp.js";
+import { n as Xa, t as Ya } from "./chunks/date-picker-Ddeo1fNE.js";
+import { n as ja, t as Ja } from "./chunks/copy-button-B_B15mEi.js";
+import { a as qa, c as $a, d as as, i as ss, l as ts, n as rs, o as os, r as es, s as is, t as Es, u as Ss } from "./chunks/sidebar-DRPe5CAh.js";
+import { t as ns } from "./chunks/input-DjvZoF8v.js";
+import { i as Is, n as Ts, r as ps, t as As } from "./chunks/filter-bar-D9lBBr4z.js";
+import { a as ls } from "./chunks/data-table-BeUwsjmX.js";
+import { n as Bs, t as fs } from "./chunks/code-block-BuDIo8Q0.js";
+import { n as Ps, t as us } from "./chunks/stat-hnNqjWVG.js";
+import { t as cs } from "./chunks/calendar-4OFiCLAv.js";
+import { t as Os } from "./chunks/close-button-GvqWbLl0.js";
+import { t as ds } from "./chunks/input-group-fc9_jD4d.js";
+import { n as Gs, t as bs } from "./chunks/card-DhDwtSi9.js";
+import { n as Ms, t as gs } from "./chunks/dialog-BwfUFn6B.js";
+import { i as ks, n as vs, r as ws, t as Ws } from "./chunks/status-view-C8tabjDu.js";
+import { a as Hs, c as ys, d as zs, f as Ks, i as Xs, l as Ys, m as Zs, n as js, o as Js, p as Qs, r as qs, s as $s, t as at, u as st } from "./chunks/basic-page-C3qjXfBe.js";
+import { i as rt, n as ot, r as et, t as it } from "./chunks/legend-C0mU7dqd.js";
 import "./components/chart.js";
-import { t as St } from "./chunks/bar-chart-DIALC2_z.js";
-import { t as nt } from "./chunks/line-chart-VuMYKzW3.js";
-import { i as It, n as Tt, r as pt, t as At } from "./chunks/log-list-BERiO4UJ.js";
-import { t as lt } from "./chunks/description-list-C-mwe4ki.js";
+import { t as _t } from "./chunks/bar-chart-DIALC2_z.js";
+import { t as mt } from "./chunks/line-chart-VuMYKzW3.js";
+import { i as Tt, n as pt, r as At, t as Rt } from "./chunks/log-list-BERiO4UJ.js";
+import { t as Ct } from "./chunks/description-list-C-mwe4ki.js";
 export {
-  $s as AUTO_SAVE_DELAY_MS,
+  at as AUTO_SAVE_DELAY_MS,
   n as BAR_RISE_PX,
-  Zs as BASIC_PAGE_CALLOUT,
-  Qs as BASIC_PAGE_CARD,
-  ys as BASIC_PAGE_ITEM,
-  xs as BASIC_PAGE_ITEM_PANEL,
-  js as BASIC_PAGE_ITEM_PANEL_DIVIDED,
-  qs as BASIC_PAGE_ROW,
+  js as BASIC_PAGE_CALLOUT,
+  qs as BASIC_PAGE_CARD,
+  Xs as BASIC_PAGE_ITEM,
+  Hs as BASIC_PAGE_ITEM_PANEL,
+  Js as BASIC_PAGE_ITEM_PANEL_DIVIDED,
+  $s as BASIC_PAGE_ROW,
   m as BLUR_PX,
-  y as BUTTON_COLORS,
+  K as BUTTON_COLORS,
   x as BUTTON_SHAPES,
-  z as BUTTON_SIZES,
+  y as BUTTON_SIZES,
   w as BUTTON_VARIANTS,
-  St as BarChart,
-  Hs as BasicPage,
+  _t as BarChart,
+  ys as BasicPage,
   h as Button,
   H as ButtonLink,
-  Gs as CARD_SURFACE,
-  ot as CHART_SLOTS,
-  Xs as CONDENSE_BAR_ENTER,
-  at as CONDENSE_BAR_RISE_PX,
+  bs as CARD_SURFACE,
+  et as CHART_SLOTS,
+  Ys as CONDENSE_BAR_ENTER,
+  st as CONDENSE_BAR_RISE_PX,
   zs as CONDENSE_BAR_TRAVEL,
   U as CONTROL_PRESS_SCALE,
   V as CONTROL_PRESS_SPRING,
-  ja as COPY_BUTTON_SIZES,
-  b as COPY_FEEDBACK_MS,
-  Ls as Calendar,
-  Us as Card,
-  et as ChartLegend,
-  rt as ChartSwatch,
-  cs as CloseButton,
-  Bs as CodeBlock,
-  Za as CopyButton,
-  Xa as DatePicker,
-  lt as DescriptionList,
-  Ms as Dialog,
+  Ja as COPY_BUTTON_SIZES,
+  F as COPY_FEEDBACK_MS,
+  cs as Calendar,
+  Gs as Card,
+  it as ChartLegend,
+  ot as ChartSwatch,
+  Os as CloseButton,
+  fs as CodeBlock,
+  ja as CopyButton,
+  Ya as DatePicker,
+  Ct as DescriptionList,
+  gs as Dialog,
   I as EASE_POP,
   T as EASE_STACK,
-  K as EFFECT_BUTTON_SIZES,
-  v as EffectButton,
+  z as EFFECT_BUTTON_SIZES,
+  k as EffectButton,
   W as EffectButtonLink,
   ta as Error,
   q as ErrorView,
   p as FADE_ENTRANCE,
   A as FADE_SWAP,
-  ps as FILTER_DATE_PRESETS,
-  la as FULL_VIEW,
-  Is as FilterBar,
+  As as FILTER_DATE_PRESETS,
+  ia as FULL_VIEW,
+  Ts as FilterBar,
   aa as GENERIC_ERROR_TITLE,
-  La as GEN_AI_KINDS,
-  _s as Input,
-  Vs as InputGroup,
-  nt as LineChart,
+  ga as GEN_AI_KINDS,
+  ns as Input,
+  ds as InputGroup,
+  mt as LineChart,
   S as LinkProvider,
-  At as LogList,
-  ia as MIN_VIEW_WIDTH,
+  Rt as LogList,
+  xa as MIN_VIEW_WIDTH,
   R as PRESS_SCALE,
   l as PRESS_SCALE_ROW,
   C as RISE_PX,
-  is as SIDEBAR_HEADER_INSET,
-  ts as SIDEBAR_ITEM,
-  os as SIDEBAR_ITEM_ACTIVE,
-  as as SIDEBAR_ITEM_INACTIVE,
-  Qa as SIDEBAR_ROOT,
-  rs as SIDEBAR_ROOT_BASE,
-  es as SIDEBAR_ROOT_INSET,
-  qa as SIDEBAR_SUBMENU_CHEVRON,
-  ss as SIDEBAR_SUBMENU_LIST_INDENT,
-  Es as SIDEBAR_SUBMENU_TRIGGER_CHILD_ACTIVE,
+  Es as SIDEBAR_HEADER_INSET,
+  rs as SIDEBAR_ITEM,
+  es as SIDEBAR_ITEM_ACTIVE,
+  ss as SIDEBAR_ITEM_INACTIVE,
+  qa as SIDEBAR_ROOT,
+  os as SIDEBAR_ROOT_BASE,
+  is as SIDEBAR_ROOT_INSET,
+  $a as SIDEBAR_SUBMENU_CHEVRON,
+  ts as SIDEBAR_SUBMENU_LIST_INDENT,
+  Ss as SIDEBAR_SUBMENU_TRIGGER_CHILD_ACTIVE,
   B as SPRING_ENTRANCE,
   f as SPRING_PRESS,
   N as SPRING_PRESS_INLINE,
   P as SPRING_PRESS_QUICK,
   u as SPRING_SETTLE,
-  ws as STATUS_VIEW,
+  Ws as STATUS_VIEW,
   vs as STATUS_VIEW_COPY,
-  ks as STATUS_VIEW_SIZES,
-  $a as Sidebar,
-  Ha as SpanPrimitive,
-  Ps as Stat,
-  Ns as StatGroup,
-  hs as StatusView,
+  ws as STATUS_VIEW_SIZES,
+  as as Sidebar,
+  Pa as SpanPrimitive,
+  us as Stat,
+  Ps as StatGroup,
+  ks as StatusView,
   L as TRAVEL_LINEAR,
   va as Trace,
-  Wa as allCollapsed,
-  Ca as ancestorIds,
-  Ma as attribute,
-  Ga as attributeText,
-  Oa as axisTicks,
-  fa as barGeometry,
-  Sa as buildSpanTree,
+  Ca as allCollapsed,
+  Sa as ancestorIds,
+  ba as attribute,
+  Oa as attributeText,
+  Va as axisTicks,
+  Na as barGeometry,
+  Ea as buildSpanTree,
   X as buttonVariants,
   J as capitalizeFirst,
-  tt as chartColor,
-  Ea as clampView,
+  rt as chartColor,
+  pa as clampView,
   s as cn,
-  pa as collapseAllIds,
-  da as collapseOneLevel,
-  Rs as createColumns,
-  oa as deriveSpanTree,
+  Ua as collapseAllIds,
+  oa as collapseOneLevel,
+  ls as createColumns,
+  da as deriveSpanTree,
   Z as describeError,
-  k as effectButtonVariants,
-  Va as expandOneLevel,
-  D as fadeThroughBlur,
-  Ia as filterSpans,
+  v as effectButtonVariants,
+  Ia as expandOneLevel,
+  c as fadeThroughBlur,
+  Ta as filterSpans,
   Fa as footerTotals,
   Ks as formToasts,
-  ya as formatDateLabel,
-  ba as formatDuration,
-  Ts as formatFilterValue,
-  ha as formatTick,
-  ca as genAIKind,
+  Xa as formatDateLabel,
+  Ma as formatDuration,
+  ps as formatFilterValue,
+  ka as formatTick,
+  Da as genAIKind,
   $ as httpReasonPhrase,
   sa as httpStatusExplanation,
-  ms as isFilterSet,
-  Ta as isFullView,
+  Is as isFilterSet,
+  Aa as isFullView,
   j as isProblem,
   r as isReactComponent,
-  Pa as labeledTicks,
-  Tt as logStatusColor,
-  pt as logStatusLabel,
-  Ua as niceStep,
-  ka as normalizeSpans,
-  Aa as panView,
+  ua as labeledTicks,
+  Ga as layoutTickLabels,
+  pt as logStatusColor,
+  At as logStatusLabel,
+  wa as niceStep,
+  La as normalizeSpans,
+  _a as panView,
   Q as parseProblem,
-  Da as peerService,
+  fa as peerService,
   e as resolveVariant,
-  c as riseIn,
-  Ba as spanDecorationIcon,
-  ua as spanDuration,
-  wa as spanPills,
-  _a as spanTimelineBarVars,
-  Cs as tokenizeJson,
-  ga as traceBulletInset,
-  na as traceRange,
-  It as truncateMiddle,
-  Js as useAutoSave,
-  Ys as useCondense,
-  F as useCopy,
-  bs as useDialogPending,
+  D as riseIn,
+  Wa as spanDecorationIcon,
+  ca as spanDuration,
+  ya as spanPills,
+  na as spanTimelineBarVars,
+  Bs as tokenizeJson,
+  ha as traceBulletInset,
+  ma as traceRange,
+  Tt as truncateMiddle,
+  Qs as useAutoSave,
+  Zs as useCondense,
+  b as useCopy,
+  Ms as useDialogPending,
   E as useLinkComponent,
   d as usePressPulse,
-  Na as useSpan,
-  xa as useSpanTree,
-  ma as viewFraction,
-  Ra as viewToRange,
-  za as visibleSpans,
-  ea as zoomView
+  Ha as useSpan,
+  la as useSpanTree,
+  Ra as viewFraction,
+  za as viewToRange,
+  ea as visibleSpans,
+  Ba as zoomView
 };

package/dist/sections/basic-page.js

@@ -1,6 +1,6 @@
 "use client";
-import { a as s } from "../chunks/data-table-DcwCgXJU.js";
-import { a as E, c as a, d as C, f as S, i as I, l as e, m as o, n as B, o as P, p as N, r, s as t, t as D, u as R } from "../chunks/basic-page-CYDwfVjO.js";
+import { a as s } from "../chunks/data-table-BeUwsjmX.js";
+import { a as E, c as a, d as C, f as S, i as I, l as e, m as o, n as B, o as P, p as N, r, s as t, t as D, u as R } from "../chunks/basic-page-C3qjXfBe.js";
 export {
   D as AUTO_SAVE_DELAY_MS,
   B as BASIC_PAGE_CALLOUT,

package/dist/src/components/data-table/data-table.d.ts

@@ -77,13 +77,13 @@ declare const features: {
     columnMeta: DataTableColumnMeta;
 };
 export type DataTableFeatures = typeof features;
-/** Body row height — header stays `h-10` on every size. */
+/** Body row height — the header keeps its own `h-10` on every size. */
 export declare const DATA_TABLE_SIZES: {
     sm: {
         classes: string;
         description: string;
     };
-    md: {
+    base: {
         classes: string;
         description: string;
     };
@@ -218,10 +218,12 @@ export interface DataTableProps<TData extends RowData> extends Omit<ComponentPro
      */
     layout?: "auto" | "fixed";
     /**
-     * Body row height. `md` (the default) is 48px — one line of body type.
-     * `sm` is 40px, the header's own height, for a dense list scanned more
-     * than read. `lg` is 56px, for a two-line cell (a number and a caption)
-     * that would crowd `md`. The header row stays 40px on every size.
+     * Body row height and the type that comes with it. `base` (the default)
+     * is 48px rows at 14px — one line of body type. `sm` is 40px at 13px,
+     * the header's own height, for a dense list scanned more than read.
+     * `lg` is 56px at 16px, for a two-line cell (a number and a caption)
+     * that would crowd `base`. The header row keeps its 40px on every size
+     * and follows the type.
      */
     size?: DataTableSize;
     ref?: Ref<HTMLDivElement>;

package/dist/src/components/date-picker/date-picker.d.ts

@@ -16,7 +16,7 @@ export type DatePickerTime = "hour" | "minute" | "second";
  */
 export declare function dateFieldMask(locales?: Intl.LocalesArgument, time?: DatePickerTime): string;
 /**
- * The figures in the field — `09/12/2026`, or `09/10/2026 – 09/13/2026` for a
+ * The figures in the field — `09/12/2026`, or `09/10/2026–09/13/2026` for a
  * span, in the viewer's locale. An empty or half-finished range prints just
  * the day that is settled; nothing selected prints nothing. Pass `time` to
  * print the clock too, at the precision that was asked for.
@@ -25,6 +25,15 @@ export declare function dateFieldMask(locales?: Intl.LocalesArgument, time?: Dat
  * a month's name is the one part of a date nobody wants to spell.
  */
 export declare function formatDateLabel(value: Date | DateRange | undefined, locales?: Intl.LocalesArgument, time?: DatePickerTime): string;
+/**
+ * A window the page offers by name — `Last 7 days` — beside the calendar.
+ * Pass a function for anything measured from now, so it is resolved at the
+ * click rather than at render.
+ */
+export interface DatePickerPreset<T> {
+    label: string;
+    value: T | (() => T);
+}
 interface DatePickerBaseProps {
     /** Field label (associated for accessibility). */
     label?: ReactNode;
@@ -42,6 +51,13 @@ interface DatePickerBaseProps {
     required?: boolean;
     /** Size variant. @default "md" */
     size?: DatePickerSize;
+    /**
+     * `fill` takes the column it is in, like every other field. `hug` shrinks
+     * to the words it is showing, for a field that sits in a toolbar or beside
+     * a title rather than in a form.
+     * @default "fill"
+     */
+    width?: "fill" | "hug";
     /**
      * Ask for a time as well as a day, this fine. `hour` sets the hour and
      * zeroes the rest, `minute` the hour and minute, `second` all three. Omit
@@ -66,12 +82,23 @@ export interface DatePickerSingleProps extends DatePickerBaseProps {
     value?: Date;
     defaultValue?: Date;
     onValueChange?: (value: Date | undefined) => void;
+    /** Named days offered beside the calendar. */
+    presets?: DatePickerPreset<Date>[];
 }
 export interface DatePickerRangeProps extends DatePickerBaseProps {
     mode: "range";
     value?: DateRange;
     defaultValue?: DateRange;
     onValueChange?: (value: DateRange | undefined) => void;
+    /** Named windows offered beside the calendar — `Last 7 days`, and so on. */
+    presets?: DatePickerPreset<DateRange>[];
+    /**
+     * Shortest and longest span the viewer may pick, counted in days. A pick
+     * that would break either restarts the span from the day just clicked, so
+     * the bound is felt rather than explained.
+     */
+    minDays?: number;
+    maxDays?: number;
 }
 export type DatePickerProps = DatePickerSingleProps | DatePickerRangeProps;
 /**

package/dist/src/components/trace/index.d.ts

@@ -2,4 +2,4 @@ export { Trace, traceBulletInset, footerTotals, type TraceWaterfallProps, type T
 export { SpanPrimitive, useSpan, useSpanTree, type SpanTreeContextValue, type SpanProviderProps, type SpanChildrenProps, type SpanRootProps, type SpanIndentProps, type SpanCollapseToggleProps, type SpanStatusIndicatorProps, type SpanTypeBadgeProps, type SpanNameProps, type SpanTimelineProps, type SpanTimelineBarProps, } from './span-primitive';
 export { deriveSpanTree, visibleSpans, buildSpanTree, ancestorIds, collapseAllIds, collapseOneLevel, expandOneLevel, allCollapsed, traceRange, clampView, viewToRange, zoomView, panView, viewFraction, isFullView, spanTimelineBarVars, filterSpans, FULL_VIEW, MIN_VIEW_WIDTH, type SpanData, type SpanStatus, type SpanKind, type SpanItemState, type SpanTree, type SpanTimelineRange, type SpanView, } from './span-tree';
 export { spanDecorationIcon, spanPills, genAIKind, peerService, attribute, attributeText, GEN_AI_KINDS, type SpanPill, type SpanDecorationIcon, type GenAIKind, } from './decorations';
-export { normalizeSpans, spanDuration, barGeometry, axisTicks, niceStep, formatDuration, formatTick, labeledTicks, type AxisTick, type TraceWaterfallSpan, type TraceSpanStatus, type TraceSpanKind, type TraceRange, } from './layout';
+export { normalizeSpans, spanDuration, barGeometry, axisTicks, niceStep, formatDuration, formatTick, labeledTicks, layoutTickLabels, type AxisTick, type TickLabel, type TraceWaterfallSpan, type TraceSpanStatus, type TraceSpanKind, type TraceRange, } from './layout';

package/dist/src/components/trace/layout.d.ts

@@ -64,13 +64,19 @@ export declare function axisTicks(startMs: number, endMs: number): AxisTick[];
 export declare function formatDuration(ms: number): string;
 /** An axis tick's label: whole numbers where the step allows, "2 s" past a second. */
 export declare function formatTick(ms: number): string;
+export interface TickLabel extends AxisTick {
+    /** Which side of the mark the label sits: after it, or ending at it. */
+    align: "start" | "end";
+}
 /**
- * Which tick marks get a label at this track width. Marks themselves
- * always draw; a label hides when it would overlap the previous one.
- * The last tick is treated as right-aligned so it never runs past the
- * track's edge — at a narrow axis that often means dropping the label
- * before it (`40 ms` next to `50 ms` on a ~335px track).
+ * Which tick marks get a label at this track width, and on which side.
+ * Marks themselves always draw; a label hides when it would overlap the
+ * previous one. A label that would run past the track's end ends at its
+ * mark instead, and the label before it yields if the two would touch
+ * (`40 ms` next to `50 ms` on a ~335px track).
  */
+export declare function layoutTickLabels(ticks: readonly AxisTick[], trackPx: number): TickLabel[];
+/** The ticks that get a label, in ms — `layoutTickLabels` without the sides. */
 export declare function labeledTicks(ticks: readonly AxisTick[], trackPx: number): number[];
 /** A fraction as a CSS percentage, rounded so floats never leak into styles. */
 export declare function percent(fraction: number): string;

package/dist/src/components/trace/trace.d.ts

@@ -7,7 +7,7 @@ import { TraceWaterfallSpan } from './layout';
  */
 export declare function traceBulletInset(depth: number): string;
 export type TraceWaterfallShortcuts = "focus" | "global" | false;
-export interface TraceWaterfallProps extends Omit<ComponentProps<"section">, "children" | "onSelect" | "title"> {
+export interface TraceWaterfallProps extends Omit<ComponentProps<"section">, "children" | "onSelect"> {
     spans: readonly TraceWaterfallSpan[];
     /**
      * The current time on the spans' clock, for running spans: their bars
@@ -58,19 +58,6 @@ export interface TraceWaterfallProps extends Omit<ComponentProps<"section">, "ch
      * outside a field, `false` for none. @default "focus"
      */
     shortcuts?: TraceWaterfallShortcuts;
-    /** The lead on the axis row — "Waterfall". Omit for none. */
-    title?: ReactNode;
-    /**
-     * Optional copy after `title` on the axis row. Totals live in the
-     * footer by default; pass a node here only to put something else
-     * beside the title.
-     */
-    summary?: ReactNode;
-    /**
-     * Wall-clock start of the trace, in ms. The footer prints
-     * `Started 12:59:07.206` when this is a readable time.
-     */
-    startedAt?: number;
     /**
      * The legend and totals under the rows. Default when there are
      * spans; pass `null` to hide it, or a node (`<Trace.Waterfall.Footer />`)
@@ -79,29 +66,20 @@ export interface TraceWaterfallProps extends Omit<ComponentProps<"section">, "ch
     footer?: ReactNode;
     ref?: Ref<HTMLElement>;
 }
-declare function Waterfall({ spans, now: nowProp, selectedId, onSelect, renderSpanDetail, defaultCollapsed, collapsed, onCollapsedChange, foldControls, search, query: queryProp, onQueryChange, defaultView, view, onViewChange, shortcuts, title, summary, startedAt, footer, className, ...props }: TraceWaterfallProps): import("react").JSX.Element;
-export declare function footerTotals({ spanCount, errorCount, orphanCount, durationMs, window, startedAt, }: {
+declare function Waterfall({ spans, now: nowProp, selectedId, onSelect, renderSpanDetail, defaultCollapsed, collapsed, onCollapsedChange, foldControls, search, query: queryProp, onQueryChange, defaultView, view, onViewChange, shortcuts, footer, className, ...props }: TraceWaterfallProps): import("react").JSX.Element;
+export declare function footerTotals({ spanCount, errorCount, orphanCount, durationMs, }: {
     spanCount: number;
     errorCount: number;
     orphanCount?: number;
     durationMs: number;
-    /** The zoom window, in ms from the trace's start, when zoomed. */
-    window?: {
-        startMs: number;
-        endMs: number;
-    } | null;
-    startedAt?: number;
 }): string[];
-export interface WaterfallFooterProps extends ComponentProps<"div"> {
-    /** Wall-clock start; falls back to the waterfall's `startedAt`. */
-    startedAt?: number;
-}
+export type WaterfallFooterProps = ComponentProps<"div">;
 /**
  * The waterfall's legend and totals. Renders inside `Trace.Waterfall`
  * so it can read the spans; pass it as `footer` to keep the default
  * chrome when replacing the slot.
  */
-declare function WaterfallFooter({ startedAt: startedAtProp, className, ...props }: WaterfallFooterProps): import("react").JSX.Element;
+declare function WaterfallFooter({ className, ...props }: WaterfallFooterProps): import("react").JSX.Element;
 export type TraceLogLevel = "debug" | "info" | "warn" | "error";
 export interface TraceLog {
     id?: string;

package/dist/src/sections/basic-page/basic-page.d.ts

@@ -95,6 +95,11 @@ export interface BasicPageRootProps extends ComponentProps<"div"> {
      * starting values would blink it out. The React page taking over from
      * it stays put too — it finds the marker in the document at its first
      * render, while the twin is still there.
+     *
+     * Not needed for markup React hydrates in place (a server-rendered
+     * page): the parts know a hydration pass from a mount and stay at rest
+     * on their own. This is for the twin that mounts fresh, beside or over
+     * markup it does not hydrate.
      */
     prerendered?: boolean;
 }
@@ -222,7 +227,8 @@ export interface BasicPageStackProps extends Omit<ComponentProps<"div">, RevealM
      * second the page was painted before React and is already there. A
      * loading part in some other page (one still on screen while this one
      * mounts) does not count. `true` always enters, except inside a
-     * `Root prerendered`; `false` never does.
+     * `Root prerendered` or while hydrating server markup (the page is on
+     * screen either way); `false` never does.
      */
     enter?: boolean;
     ref?: Ref<HTMLDivElement>;
@@ -253,6 +259,11 @@ export interface BasicPageStackProps extends Omit<ComponentProps<"div">, RevealM
  *   nothing inside that root does either, and the React page taking over
  *   finds the marker in the document and stays put on its own;
  *   `enter={false}` says so outright for markup that must never move.
+ * - **A page the server rendered and React hydrates** stays put with no
+ *   flag at all: the hydration pass renders what the server did, at rest,
+ *   and the entrance waits for a page React mounts itself (a navigation).
+ *   An `enter` on a hydrating stack does not override this either: the
+ *   page is on screen, and starting values would blink it out.
  * - **A region the skeleton couldn't predict** (a list of unknown length)
  *   — `Reveal` rises that region in once its shape is known.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@photon-ai/pho-ui",
-  "version": "3.0.0",
+  "version": "4.2.0",
   "description": "Pho Design System — Photon's React component library, built on Base UI",
   "license": "UNLICENSED",
   "repository": {