@kitn.ai/ui 0.28.0 → 0.30.0

package/src/components/context.tsx

@@ -1,377 +0,0 @@
-import { type JSX, Show, createContext, createMemo, useContext } from 'solid-js';
-import { HoverCardRoot, HoverCardTrigger, HoverCardContent } from '../ui/hover-card';
-import { cn } from '../utils/cn';
-import { Button } from '../ui/button';
-import { ProgressBar, type ProgressTone } from '../ui/progress-bar';
-
-const ICON_RADIUS = 10;
-const ICON_VIEWBOX = 24;
-const ICON_CENTER = 12;
-const ICON_STROKE_WIDTH = 2;
-
-/** Default fraction (0–1) at which the meter transitions to the warning colour. */
-export const DEFAULT_WARN_THRESHOLD = 0.7;
-/** Default fraction (0–1) at which the meter transitions to the danger colour. */
-export const DEFAULT_DANGER_THRESHOLD = 0.9;
-
-/**
- * Compute the severity level for a given usage fraction and thresholds.
- * `pct` is a 0–1 fraction (e.g. `usedTokens / maxTokens`).
- */
-export function computeSeverity(
-  pct: number,
-  warnThreshold = DEFAULT_WARN_THRESHOLD,
-  dangerThreshold = DEFAULT_DANGER_THRESHOLD,
-): ContextSeverity {
-  if (pct > dangerThreshold) return 'danger';
-  if (pct > warnThreshold) return 'warn';
-  return 'ok';
-}
-
-export type ContextSeverity = 'ok' | 'warn' | 'danger';
-
-interface ContextSchema {
-  usedTokens: number;
-  maxTokens: number;
-  inputTokens?: number;
-  outputTokens?: number;
-  reasoningTokens?: number;
-  cacheTokens?: number;
-  estimatedCost?: number;
-  /** Fraction (0–1) above which the meter turns yellow. Default 0.7. */
-  warnThreshold: number;
-  /** Fraction (0–1) above which the meter turns red. Default 0.9. */
-  dangerThreshold: number;
-}
-
-const ContextCtx = createContext<ContextSchema>();
-
-function useContextValue(): ContextSchema {
-  const ctx = useContext(ContextCtx);
-  if (!ctx) {
-    throw new Error('Context components must be used within Context');
-  }
-  return ctx;
-}
-
-const fmtCompact = new Intl.NumberFormat('en-US', { notation: 'compact' });
-const fmtPercent = new Intl.NumberFormat('en-US', { maximumFractionDigits: 1, style: 'percent' });
-const fmtCurrency = new Intl.NumberFormat('en-US', { currency: 'USD', style: 'currency' });
-
-// --- Root provider ---
-
-export interface ContextProps {
-  usedTokens: number;
-  maxTokens: number;
-  inputTokens?: number;
-  outputTokens?: number;
-  reasoningTokens?: number;
-  cacheTokens?: number;
-  estimatedCost?: number;
-  /**
-   * Fraction (0–1) above which the progress bar turns yellow.
-   * Defaults to `0.7` (70%).
-   */
-  warnThreshold?: number;
-  /**
-   * Fraction (0–1) above which the progress bar turns red.
-   * Defaults to `0.9` (90%).
-   */
-  dangerThreshold?: number;
-  children?: JSX.Element;
-}
-
-export function Context(props: ContextProps) {
-  const value = createMemo<ContextSchema>(() => ({
-    usedTokens: props.usedTokens,
-    maxTokens: props.maxTokens,
-    inputTokens: props.inputTokens,
-    outputTokens: props.outputTokens,
-    reasoningTokens: props.reasoningTokens,
-    cacheTokens: props.cacheTokens,
-    estimatedCost: props.estimatedCost,
-    warnThreshold: props.warnThreshold ?? DEFAULT_WARN_THRESHOLD,
-    dangerThreshold: props.dangerThreshold ?? DEFAULT_DANGER_THRESHOLD,
-  }));
-
-  return (
-    <ContextCtx.Provider value={value()}>
-      <HoverCardRoot openDelay={0}>
-        {props.children}
-      </HoverCardRoot>
-    </ContextCtx.Provider>
-  );
-}
-
-// --- Icon (internal) ---
-
-function ContextIcon() {
-  const ctx = useContextValue();
-  const circumference = 2 * Math.PI * ICON_RADIUS;
-  const usedPercent = createMemo(() => ctx.usedTokens / ctx.maxTokens);
-  const dashOffset = createMemo(() => circumference * (1 - usedPercent()));
-
-  return (
-    <svg
-      aria-label="Model context usage"
-      height="20"
-      role="img"
-      style={{ color: 'currentcolor' }}
-      viewBox={`0 0 ${ICON_VIEWBOX} ${ICON_VIEWBOX}`}
-      width="20"
-    >
-      <circle
-        cx={ICON_CENTER}
-        cy={ICON_CENTER}
-        fill="none"
-        opacity="0.25"
-        r={ICON_RADIUS}
-        stroke="currentColor"
-        stroke-width={ICON_STROKE_WIDTH}
-      />
-      <circle
-        cx={ICON_CENTER}
-        cy={ICON_CENTER}
-        fill="none"
-        opacity="0.7"
-        r={ICON_RADIUS}
-        stroke="currentColor"
-        stroke-dasharray={`${circumference} ${circumference}`}
-        stroke-dashoffset={dashOffset()}
-        stroke-linecap="round"
-        stroke-width={ICON_STROKE_WIDTH}
-        style={{ transform: 'rotate(-90deg)', 'transform-origin': 'center' }}
-      />
-    </svg>
-  );
-}
-
-// --- Trigger ---
-
-export interface ContextTriggerProps {
-  children?: JSX.Element;
-  class?: string;
-}
-
-export function ContextTrigger(props: ContextTriggerProps) {
-  const ctx = useContextValue();
-  const usedPercent = createMemo(() => ctx.usedTokens / ctx.maxTokens);
-  const renderedPercent = createMemo(() => fmtPercent.format(usedPercent()));
-
-  return (
-    <HoverCardTrigger>
-      <Show
-        when={!props.children}
-        fallback={props.children}
-      >
-        <Button type="button" variant="ghost" class={props.class}>
-          <span class="font-medium text-muted-foreground">{renderedPercent()}</span>
-          <ContextIcon />
-        </Button>
-      </Show>
-    </HoverCardTrigger>
-  );
-}
-
-// --- Content ---
-
-export interface ContextContentProps {
-  class?: string;
-  children?: JSX.Element;
-}
-
-export function ContextContent(props: ContextContentProps) {
-  return (
-    <HoverCardContent
-      class={cn(
-        'min-w-60 divide-y divide-border overflow-hidden',
-        props.class
-      )}
-    >
-      {props.children}
-    </HoverCardContent>
-  );
-}
-
-// --- Content Header ---
-
-export interface ContextContentHeaderProps {
-  class?: string;
-  children?: JSX.Element;
-}
-
-export function ContextContentHeader(props: ContextContentHeaderProps) {
-  const ctx = useContextValue();
-  const usedPercent = createMemo(() => ctx.usedTokens / ctx.maxTokens);
-  const displayPct = createMemo(() => fmtPercent.format(usedPercent()));
-  const used = createMemo(() => fmtCompact.format(ctx.usedTokens));
-  const total = createMemo(() => fmtCompact.format(ctx.maxTokens));
-
-  const severity = createMemo<ContextSeverity>(() => {
-    const pct = usedPercent();
-    if (pct > ctx.dangerThreshold) return 'danger';
-    if (pct > ctx.warnThreshold) return 'warn';
-    return 'ok';
-  });
-
-  // Severity used to pick a bare hue class and nothing else, so the meter was a
-  // pair of styled divs: no role, no value, invisible to assistive tech. Map it to
-  // the shared ProgressBar's semantic `tone` instead and let that primitive supply
-  // `role="progressbar"` + aria-valuenow/min/max, rather than hand-rolling those
-  // onto the divs.
-  const tone = createMemo<ProgressTone>(() => {
-    const s = severity();
-    if (s === 'danger') return 'error';
-    if (s === 'warn') return 'warning';
-    return 'primary';
-  });
-
-  return (
-    <div class={cn('w-full space-y-2 p-3', props.class)}>
-      <Show when={!props.children} fallback={props.children}>
-        <div class="flex items-center justify-between gap-3 text-xs">
-          <p>{displayPct()}</p>
-          <p class="font-mono text-muted-foreground">
-            {used()} / {total()}
-          </p>
-        </div>
-        <div class="space-y-2">
-          {/* Values are the raw token counts, so a screen reader announces
-              "190,000 of 200,000" rather than a bare percentage. */}
-          <ProgressBar
-            value={ctx.usedTokens}
-            max={ctx.maxTokens}
-            tone={tone()}
-            aria-label="Context usage"
-          />
-        </div>
-      </Show>
-    </div>
-  );
-}
-
-// --- Content Body ---
-
-export interface ContextContentBodyProps {
-  class?: string;
-  children?: JSX.Element;
-}
-
-export function ContextContentBody(props: ContextContentBodyProps) {
-  return (
-    <div class={cn('w-full p-3', props.class)}>
-      {props.children}
-    </div>
-  );
-}
-
-// --- Content Footer ---
-
-export interface ContextContentFooterProps {
-  class?: string;
-  children?: JSX.Element;
-}
-
-export function ContextContentFooter(props: ContextContentFooterProps) {
-  const ctx = useContextValue();
-  const totalCost = createMemo(() =>
-    fmtCurrency.format(ctx.estimatedCost ?? 0)
-  );
-
-  return (
-    <div
-      class={cn(
-        'flex w-full items-center justify-between gap-3 bg-muted p-3 text-xs',
-        props.class
-      )}
-    >
-      <Show when={!props.children} fallback={props.children}>
-        <span class="text-muted-foreground">Total cost</span>
-        <span>{totalCost()}</span>
-      </Show>
-    </div>
-  );
-}
-
-// --- Token row helper ---
-
-function TokensDisplay(props: { tokens?: number }) {
-  return (
-    <span>
-      {props.tokens === undefined
-        ? '\u2014'
-        : fmtCompact.format(props.tokens)}
-    </span>
-  );
-}
-
-// --- Specialized usage rows ---
-
-export interface ContextUsageRowProps {
-  class?: string;
-  children?: JSX.Element;
-}
-
-// The four rows share one shape, but each still ships a `<Name>Props` alias: a
-// consumer typing a wrapper around one of them should not have to discover that
-// the shared name exists.
-export type ContextInputUsageProps = ContextUsageRowProps;
-export type ContextOutputUsageProps = ContextUsageRowProps;
-export type ContextReasoningUsageProps = ContextUsageRowProps;
-export type ContextCacheUsageProps = ContextUsageRowProps;
-
-export function ContextInputUsage(props: ContextInputUsageProps) {
-  const ctx = useContextValue();
-  return (
-    <Show when={props.children || ctx.inputTokens}>
-      <Show when={!props.children} fallback={props.children}>
-        <div class={cn('flex items-center justify-between text-xs', props.class)}>
-          <span class="text-muted-foreground">Input</span>
-          <TokensDisplay tokens={ctx.inputTokens} />
-        </div>
-      </Show>
-    </Show>
-  );
-}
-
-export function ContextOutputUsage(props: ContextOutputUsageProps) {
-  const ctx = useContextValue();
-  return (
-    <Show when={props.children || ctx.outputTokens}>
-      <Show when={!props.children} fallback={props.children}>
-        <div class={cn('flex items-center justify-between text-xs', props.class)}>
-          <span class="text-muted-foreground">Output</span>
-          <TokensDisplay tokens={ctx.outputTokens} />
-        </div>
-      </Show>
-    </Show>
-  );
-}
-
-export function ContextReasoningUsage(props: ContextReasoningUsageProps) {
-  const ctx = useContextValue();
-  return (
-    <Show when={props.children || ctx.reasoningTokens}>
-      <Show when={!props.children} fallback={props.children}>
-        <div class={cn('flex items-center justify-between text-xs', props.class)}>
-          <span class="text-muted-foreground">Reasoning</span>
-          <TokensDisplay tokens={ctx.reasoningTokens} />
-        </div>
-      </Show>
-    </Show>
-  );
-}
-
-export function ContextCacheUsage(props: ContextCacheUsageProps) {
-  const ctx = useContextValue();
-  return (
-    <Show when={props.children || ctx.cacheTokens}>
-      <Show when={!props.children} fallback={props.children}>
-        <div class={cn('flex items-center justify-between text-xs', props.class)}>
-          <span class="text-muted-foreground">Cache</span>
-          <TokensDisplay tokens={ctx.cacheTokens} />
-        </div>
-      </Show>
-    </Show>
-  );
-}

package/src/components/conversation-item.tsx

@@ -1,241 +0,0 @@
-import { Show, splitProps, createMemo, type JSX } from 'solid-js';
-import { MessageSquare } from 'lucide-solid';
-import { cn } from '../utils/cn';
-import type { ConversationSummary } from '../types';
-
-export interface ConversationItemProps {
-  conversation: ConversationSummary;
-  isActive: boolean;
-  onSelect: (id: string) => void;
-  /** Dense single-line row: a leading dot + title, no message count. */
-  compact?: boolean;
-  class?: string;
-}
-
-/**
- * Short relative time from an ISO date string: "just now", "5m ago", "3h ago",
- * "2d ago", "24d ago". Pure — it snapshots `now` (defaults to `Date.now()`) at
- * call time, so it re-derives whenever the list re-renders; there is no internal
- * ticking clock. Returns '' for a missing or unparseable date.
- */
-export function relativeTimeShort(iso?: string, now: number = Date.now()): string {
-  if (!iso) return '';
-  const then = Date.parse(iso);
-  if (Number.isNaN(then)) return '';
-  const secs = Math.max(0, Math.round((now - then) / 1000));
-  if (secs < 60) return 'just now';
-  const mins = Math.floor(secs / 60);
-  if (mins < 60) return `${mins}m ago`;
-  const hours = Math.floor(mins / 60);
-  if (hours < 24) return `${hours}h ago`;
-  return `${Math.floor(hours / 24)}d ago`;
-}
-
-/**
- * Whether a conversation should show an unread indicator (owner round,
- * 2026-08-26). `lastReadAt`'s own doc (`types.ts`) has the full contract;
- * this is the one place that reads it, so both list surfaces (this file's
- * `ConversationItem` and the widget-box `ConversationPanel`) derive it
- * identically rather than each restating the comparison.
- *
- * Absent `lastReadAt` reads as NOT unread — the decide-loudly default for a
- * store that never implements `ConversationStore.markRead` at all (every
- * summary it returns leaves the field undefined forever, so this always
- * returns `false` for it) rather than guessing "probably unread" from a
- * signal the store never actually provided. Defensive `Date.parse`, same
- * pattern as `relativeTimeShort` above: an unparsable date reads as not
- * unread rather than throwing.
- */
-export function isConversationUnread(conv: Pick<ConversationSummary, 'updatedAt' | 'lastReadAt'>): boolean {
-  if (!conv.lastReadAt) return false;
-  const updated = Date.parse(conv.updatedAt);
-  const read = Date.parse(conv.lastReadAt);
-  if (Number.isNaN(updated) || Number.isNaN(read)) return false;
-  return updated > read;
-}
-
-/**
- * The slotted-item shape rendered by `<kai-conversation-item>` — the composed
- * row of the consumer-owned loop. Distinct from the
- * data-mode `ConversationItem` above, which batteries mode keeps rendering
- * unchanged: this one takes REGIONS, not a `ConversationSummary`.
- *
- * Regions map 1:1 to the element's slots: `children` = the default slot (the
- * title), plus `leading`, `meta`, and `menu`. The `menu` region takes the
- * consumer's OWN popover (rename / fork / archive live there); the component
- * provides only the region plus focus and ARIA plumbing, never a declarative
- * actions prop. Activation has two modes: inside `<kai-conversations>` it
- * lives in the CONTAINER (`createConversationItemsController` in
- * conversation-list.tsx — this row renders no handler and the
- * `data-kai-item-menu` marker on the menu region is what the container's
- * activation guard keys off so a click in the consumer's menu never also
- * selects the row); STANDALONE, `onActivate` makes the row body
- * its own tabbable button-role control — click / Enter / Space — with the menu
- * still outside the control as the body's sibling.
- *
- * ARIA contract for direct Solid use: the row renders `role="listitem"` holding
- * a `role="button"` body (`aria-current` marks the active row, the same dialect
- * as the batteries-mode row above) with the menu as the body's tabbable SIBLING
- * (axe `nested-interactive` bans focusable descendants of
- * a control, and `aria-required-children` outlaws non-option content anywhere
- * inside a listbox, which is why the vocabulary is not listbox/option). Render
- * your loop's rows inside a `role="list"` ancestor; element mode has no such
- * burden: `<kai-conversations>`' items region provides it for slotted items.
- */
-export interface SlottedConversationItemProps {
-  /** The row's identity, handed to the container's selection contract. In the
-   *  element this is the `conversation-id` attribute (host `id` is the fallback). */
-  conversationId?: string;
-  /** Selected state. Reflected as `aria-current` on the row body and a
-   *  `data-active` styling hook on the row; the container drives it from its
-   *  `activeId`. */
-  active?: boolean;
-  /** Dense single-line row padding. */
-  compact?: boolean;
-  /** Leading region before the title (an icon or avatar). */
-  leading?: JSX.Element;
-  /** Meta region under the title (a timestamp or status line). */
-  meta?: JSX.Element;
-  /** Your own row menu (a popover trigger). Never selects the row. */
-  menu?: JSX.Element;
-  /** The title (the element's default slot). */
-  children?: JSX.Element;
-  /** Set when the element HOST carries the row-group semantics: the inner row
-   *  then renders `role="presentation"` so the accessibility tree sees one
-   *  group (the host), never two. The `kai-conversation-item` facade sets it;
-   *  Solid consumers rendering the component directly leave it off and the row
-   *  itself is the group. */
-  hostSemantics?: boolean;
-  /** STANDALONE activation: when set, the row body is itself the
-   *  activation control — `tabindex="0"` on the `role="button"` body, and
-   *  click / Enter / Space call this. The menu region never triggers it (it is
-   *  the body's sibling, outside the control). Inside `<kai-conversations>`
-   *  leave it UNSET: the container's controller owns activation (its delegated
-   *  click/keydown → `kai-conversation-select`) plus roving tabindex, and a
-   *  handler here would double-fire. The `kai-conversation-item` facade passes
-   *  it only when the item is standalone. */
-  onActivate?: () => void;
-  class?: string;
-}
-
-export function SlottedConversationItem(props: SlottedConversationItemProps) {
-  const [local] = splitProps(props, ['conversationId', 'active', 'compact', 'leading', 'meta', 'menu', 'children', 'hostSemantics', 'onActivate', 'class']);
-  return (
-    // The sibling restructure: axe nested-interactive
-    // bans focusable descendants of an activation control, so the control role
-    // sits on the row BODY and the consumer's menu is its tabbable SIBLING
-    // (the nav.tsx TrailingActions precedent). The vocabulary is
-    // list/listitem/button + aria-current — NOT listbox/option, because axe
-    // aria-required-children lets a listbox subtree own nothing but options
-    // (and groups of options), which outlaws a sibling menu ANYWHERE inside
-    // it; button + aria-current is also exactly what the batteries-mode
-    // ConversationItem row above renders, so the two modes speak one dialect.
-    <div
-      part="row"
-      role={local.hostSemantics ? 'presentation' : 'listitem'}
-      data-active={local.active ? '' : undefined}
-      data-conversation-id={local.conversationId}
-      class={cn(
-        'flex w-full items-center gap-2.5 rounded-lg text-left transition-colors',
-        local.compact ? 'px-2.5 py-1.5' : 'px-2.5 py-2',
-        local.active ? 'bg-muted' : 'hover:bg-muted/50',
-        local.class,
-      )}
-    >
-      <div
-        part="body"
-        role="button"
-        data-kai-item-body
-        aria-current={local.active ? 'true' : 'false'}
-        // Standalone activation only: with `onActivate` unset —
-        // the inside-a-container case — no tabindex and no handlers render, so
-        // the container's delegated activation stays the single path.
-        tabindex={local.onActivate ? 0 : undefined}
-        onClick={() => local.onActivate?.()}
-        onKeyDown={(e: KeyboardEvent) => {
-          if (!local.onActivate) return;
-          if (e.key === 'Enter' || e.key === ' ') {
-            e.preventDefault(); // Space must not scroll the page
-            local.onActivate();
-          }
-        }}
-        class="flex min-w-0 flex-1 cursor-pointer items-center gap-2.5 rounded-md focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-      >
-        <Show when={local.leading}>
-          <span part="leading" class="flex shrink-0 items-center text-muted-foreground">{local.leading}</span>
-        </Show>
-        <div class="min-w-0 flex-1">
-          <div part="title" class={cn('truncate text-sm', local.active ? 'font-medium text-foreground' : 'text-foreground/80')}>
-            {local.children}
-          </div>
-          <Show when={local.meta}>
-            <div part="meta" class="mt-0.5 truncate text-xs text-muted-foreground">{local.meta}</div>
-          </Show>
-        </div>
-      </div>
-      <Show when={local.menu}>
-        <span part="menu" data-kai-item-menu class="ml-auto flex shrink-0 items-center">{local.menu}</span>
-      </Show>
-    </div>
-  );
-}
-
-export function ConversationItem(props: ConversationItemProps) {
-  const [local] = splitProps(props, ['conversation', 'isActive', 'onSelect', 'compact', 'class']);
-  // The trailing text: the consumer's own `trailing` field, else an auto relative
-  // time from updatedAt (fallback lastMessageAt). Never an internal clock — it is a
-  // render-time snapshot.
-  //
-  // REACTIVITY, and the weaker version of this note is what #224 was filed against:
-  // a new `conversations` array reference is NOT sufficient. `ConversationList` renders
-  // these rows through a reference-keyed `<For>` that captures `conv` as a VALUE, so a
-  // row whose item object is unchanged is never re-invoked and never re-reads anything
-  // below. The consumer needs BOTH — a new array (which is what notifies at all) and a
-  // new object for the item that changed (which is what this row can see). Adds,
-  // removes and reorders are fine on a fresh array alone, since those rows' identities
-  // already differ. Pinned by `src/components/reactivity-contract.test.tsx`.
-  const trailing = createMemo(
-    () => local.conversation.trailing ?? relativeTimeShort(local.conversation.updatedAt ?? local.conversation.lastMessageAt),
-  );
-  return (
-    <button
-      data-conversation-id={local.conversation.id}
-      // `isActive` drives the selected LOOK below; it has to reach assistive tech
-      // too, or the active conversation is visible only to sighted users. `true`
-      // rather than `page` because this selects a conversation within the app, it
-      // is not page navigation — same call as ui/agent-card.tsx and ui/pane-group.tsx
-      // (ui/nav.tsx uses `page` because its items really are nav links).
-      aria-current={local.isActive ? 'true' : undefined}
-      onClick={() => local.onSelect(local.conversation.id)}
-      class={cn(
-        'w-full rounded-lg text-left transition-colors',
-        local.compact ? 'px-2.5 py-1.5' : 'px-2.5 py-2',
-        local.isActive ? 'bg-muted' : 'hover:bg-muted/50',
-        local.class,
-      )}
-    >
-      <Show
-        when={local.compact}
-        fallback={
-          <>
-            <div class="flex items-center gap-2">
-              <div class={cn('min-w-0 flex-1 truncate text-sm', local.isActive ? 'font-medium text-foreground' : 'text-foreground/80')}>{local.conversation.title}</div>
-              <Show when={trailing()}>
-                <span part="trailing" class="ml-auto shrink-0 text-xs text-muted-foreground">{trailing()}</span>
-              </Show>
-            </div>
-            <div class={cn('mt-0.5 truncate text-xs', local.isActive ? 'text-foreground/70' : 'text-muted-foreground')}>{local.conversation.messageCount} messages</div>
-          </>
-        }
-      >
-        <div class="flex items-center gap-2.5">
-          <MessageSquare class={cn('size-3.5 shrink-0', local.isActive ? 'text-foreground' : 'text-muted-foreground')} />
-          <span class={cn('min-w-0 flex-1 truncate text-sm', local.isActive ? 'font-medium text-foreground' : 'text-foreground/80')}>{local.conversation.title}</span>
-          <Show when={trailing()}>
-            <span part="trailing" class="ml-auto shrink-0 text-xs text-muted-foreground">{trailing()}</span>
-          </Show>
-        </div>
-      </Show>
-    </button>
-  );
-}