@kitn.ai/ui 0.28.0 → 0.29.0

package/src/components/response-compare.tsx

@@ -1,455 +0,0 @@
-import {
-  type JSX,
-  type Accessor,
-  Show,
-  Index,
-  splitProps,
-  mergeProps,
-  createSignal,
-  createMemo,
-  createEffect,
-  on,
-  ErrorBoundary,
-  createUniqueId,
-} from 'solid-js';
-import { cn } from '../utils/cn';
-import { Button } from '../ui/button';
-import { Card } from './card';
-import { MessageBody } from './message';
-import { TextShimmer } from './text-shimmer';
-import { Check } from 'lucide-solid';
-import {
-  type CompareCandidate,
-  type ComparePair,
-  type CompareSelection,
-  type ResponseCompareData,
-  buildSelection,
-  candidateToParts,
-  isAnyStreaming,
-  normalizeCandidates,
-} from './response-compare-types';
-
-// Re-export the data types + pure helpers so consumers (and the `<kai-compare>`
-// facade) can import everything from a single `response-compare` module.
-export type {
-  CompareCandidate,
-  ComparePair,
-  CompareCollapse,
-  ResponseCompareData,
-  CompareSelection,
-} from './response-compare-types';
-export { normalizeCandidates, buildSelection, isAnyStreaming, candidateToParts } from './response-compare-types';
-
-export type CompareLayout = 'auto' | 'columns' | 'tabs';
-
-/** Imperative handle exposed via `controllerRef` — surfaces the compare's latent
- *  capabilities (commit a pick by candidate id, focus the roving tab stop) so the
- *  `<kai-compare>` facade can forward them as instance methods (Pattern C). */
-export interface ResponseCompareController {
-  /** Commit a pick by candidate id — same path as the "Pick this" button: emits
-   *  onSelect + optimistically collapses (single-shot; inert while streaming or
-   *  already resolved). No-op for an unknown id. */
-  select(candidateId: string): void;
-  /** Focus the current roving tab stop (the focused candidate's "Pick this" radio). */
-  focus(options?: FocusOptions): void;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Resolution controller — a sibling of `useCardResolution` for `CompareSelection`,
-// which has no `kind` field (so it can't satisfy `R extends CardResolution`). Same
-// precedence: prop (host-driven / re-hydrated) > local optimistic flip > none. A
-// fresh `data` identity clears the local flip, but an explicit prop keeps it
-// resolved. `isOptimistic` is true only for a flip made THIS session (announced via
-// role="status"; silent on re-hydrate).
-// ─────────────────────────────────────────────────────────────────────────────
-
-export interface ResolvedController<T> {
-  value: Accessor<T | undefined>;
-  isResolved: Accessor<boolean>;
-  isOptimistic: Accessor<boolean>;
-  setLocal: (v: T) => void;
-}
-
-export function useResolved<T>(opts: {
-  prop: Accessor<T | undefined>;
-  data: Accessor<unknown>;
-}): ResolvedController<T> {
-  const [local, setLocal] = createSignal<T | undefined>(undefined);
-  // Clear the optimistic flip on a NEW data identity (deferred so mount doesn't
-  // clobber an initial prop). The prop still wins via the memo below.
-  createEffect(on(opts.data, () => setLocal(undefined), { defer: true }));
-  const value = createMemo(() => opts.prop() ?? local());
-  const isResolved = createMemo(() => value() !== undefined);
-  const isOptimistic = createMemo(() => opts.prop() === undefined && local() !== undefined);
-  return { value, isResolved, isOptimistic, setLocal };
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// The <ResponseCompare> component.
-// ─────────────────────────────────────────────────────────────────────────────
-
-export interface ResponseCompareProps {
-  /** The compare definition (prompt + the two candidates). */
-  data?: ResponseCompareData;
-  /** Stable id correlating every emitted event. */
-  compareId?: string;
-  /** Re-hydrate / control the selection. Renders the collapsed winner. Set as a
-   *  JS property: `el.selection = { chosenId, rejectedIds }`. */
-  selection?: CompareSelection;
-  /** Layout. `'columns'` = side-by-side; `'tabs'` = one candidate at a time with
-   *  pills to switch; `'auto'` (default) uses a CONTAINER query — columns when the
-   *  component is ≥640px wide, tabs when narrower (e.g. on a phone). */
-  layout?: CompareLayout;
-  class?: string;
-  /** Receive the imperative controller once mounted. The `<kai-compare>` facade
-   *  forwards these as element methods (select/focus). */
-  controllerRef?: (controller: ResponseCompareController) => void;
-  /** Fired when the user commits a pick. */
-  onSelect?: (sel: CompareSelection) => void;
-  /** Fired once both candidates have settled (stopped streaming) and a valid
-   *  definition is shown. */
-  onReady?: () => void;
-  /** Fired for an unusable definition (inline error state). */
-  onError?: (message: string) => void;
-}
-
-/**
- * `ResponseCompare` — a dual-response comparison. Two assistant candidates for the
- * same prompt render side-by-side (or as tabs), each via `MessageBody` so a
- * candidate reads exactly like an assistant message (reasoning + tools +
- * attachments + markdown). The pick is a COMMIT, not a Submit: clicking "Pick this"
- * (or Enter on the focused column) computes `{ chosenId, rejectedIds:[other], at }`,
- * optimistically collapses to the chosen candidate's body, and calls `onSelect` for
- * the consumer to send a `(prompt, chosen, rejected)` preference pair. Single-shot.
- *
- * While EITHER candidate is `streaming`, both pick controls are disabled and the
- * streaming column shows a `TextShimmer`; `onReady` fires once both settle. The two
- * columns are a WAI-ARIA radiogroup with roving tabindex (Arrow keys move A↔B,
- * Enter/Space picks). Emits `onError` for a malformed definition.
- */
-export function ResponseCompare(props: ResponseCompareProps): JSX.Element {
-  const merged = mergeProps({ compareId: 'kai-compare', layout: 'auto' as CompareLayout }, props);
-  const [local] = splitProps(merged, [
-    'data',
-    'compareId',
-    'selection',
-    'layout',
-    'class',
-    'controllerRef',
-    'onSelect',
-    'onReady',
-    'onError',
-  ]);
-
-  const uid = createUniqueId();
-
-  const normalized = createMemo(() => normalizeCandidates(local.data?.candidates));
-  const valid = createMemo(() => normalized().candidates !== null);
-  const errorMessage = createMemo(() => normalized().error ?? '');
-  const pair = createMemo<ComparePair | null>(() => normalized().candidates);
-
-  const res = useResolved<CompareSelection>({
-    prop: () => local.selection,
-    data: () => local.data,
-  });
-
-  // Both candidates settled → enable the pick + announce ready.
-  const streaming = createMemo(() => isAnyStreaming(pair()));
-
-  const [focusIndex, setFocusIndex] = createSignal(0);
-  // In tabs mode (and auto when the container is narrow) only one candidate shows
-  // at a time; `active` is which. Ignored in columns mode where both render.
-  const [active, setActive] = createSignal(0);
-  let groupRef: HTMLDivElement | undefined;
-
-  // Reset the roving tab stop + active tab whenever a NEW definition arrives.
-  createEffect(on(() => local.data, () => { setFocusIndex(0); setActive(0); }));
-
-  // ready / error lifecycle: error on an unusable definition, ready once both
-  // candidates have settled (so consumers know the pick is now live).
-  createEffect(
-    on([valid, streaming], ([ok, isStreaming]) => {
-      if (!ok) {
-        local.onError?.(errorMessage());
-        return;
-      }
-      if (!isStreaming) local.onReady?.();
-    }),
-  );
-
-  const chosenId = createMemo(() => res.value()?.chosenId);
-  const chosenCandidate = createMemo<CompareCandidate | undefined>(() => {
-    const id = chosenId();
-    return id === undefined ? undefined : pair()?.find((c) => c.id === id);
-  });
-
-  // Commit a pick: emit + optimistically flip (single-shot; inert once resolved
-  // or while still streaming).
-  const pick = (candidate: CompareCandidate): void => {
-    if (res.isResolved()) return;
-    if (streaming()) return;
-    const p = pair();
-    if (!p) return;
-    const sel = buildSelection(p, candidate.id);
-    local.onSelect?.(sel);
-    res.setLocal(sel);
-  };
-
-  const focusColumn = (index: number, options?: FocusOptions): void => {
-    const cols = groupRef?.querySelectorAll<HTMLElement>('[role="radio"]');
-    cols?.[index]?.focus(options);
-  };
-
-  // Imperative controller (Pattern C): hand the facade a handle over the latent
-  // pick + roving-focus capabilities. `pick`/`focusColumn` are already wired
-  // internally — this just surfaces them. `select` looks the candidate up by id
-  // (the public surface is id-based; `pick` is candidate-based internally) and
-  // is a no-op for an unknown id, while streaming, or once resolved (via pick()).
-  local.controllerRef?.({
-    select: (candidateId: string) => {
-      const cand = pair()?.find((c) => c.id === candidateId);
-      if (cand) pick(cand);
-    },
-    focus: (options?: FocusOptions) => focusColumn(focusIndex(), options),
-  });
-
-  // Two-item roving tabindex (A↔B). Arrows toggle the focused column; Enter/Space
-  // picks it. No-op once resolved.
-  const onGroupKeyDown = (e: KeyboardEvent): void => {
-    if (res.isResolved()) return;
-    const p = pair();
-    if (!p) return;
-    const move = (next: number) => { setFocusIndex(next); setActive(next); focusColumn(next); };
-    if (e.key === 'ArrowRight' || e.key === 'ArrowDown' || e.key === 'ArrowLeft' || e.key === 'ArrowUp') {
-      e.preventDefault();
-      move(focusIndex() === 0 ? 1 : 0);
-    } else if (e.key === 'Home') {
-      e.preventDefault();
-      move(0);
-    } else if (e.key === 'End') {
-      e.preventDefault();
-      move(1);
-    } else if (e.key === ' ' || e.key === 'Enter') {
-      e.preventDefault();
-      const cand = p[focusIndex()];
-      if (cand) pick(cand);
-    }
-  };
-
-  // `auto` switches by CONTAINER width (Tailwind v4 `@container` + `@[640px]`
-  // variants); `@container/compare` lives on the OUTER wrapper (below) so the
-  // pill bar + columns both respond to it.
-  const wrapperClass = createMemo(() => {
-    const l = local.layout;
-    if (l === 'columns') return 'grid grid-cols-2 gap-3';
-    if (l === 'tabs') return 'grid grid-cols-1 gap-3';
-    return 'grid grid-cols-1 gap-3 @[640px]/compare:grid-cols-2'; // auto
-  });
-  // The tab-pill bar shows in tabs mode, and in auto only while the container is narrow.
-  const showTabs = () => local.layout === 'tabs' || local.layout === 'auto';
-  const tabBarClass = () => (local.layout === 'auto' ? '@[640px]/compare:hidden' : '');
-  // A non-active candidate is hidden in tabs (always) and auto (only while narrow);
-  // the active one — and both in columns mode — always render.
-  const columnHiddenClass = (index: number): string => {
-    const l = local.layout;
-    if (l === 'columns' || index === active()) return '';
-    return l === 'tabs' ? 'hidden' : 'hidden @[640px]/compare:block';
-  };
-
-  const promptId = `kai-compare-prompt-${uid}`;
-  const groupLabel = (): string => local.data?.prompt ?? 'Compare two responses';
-
-  return (
-    <Show
-      when={valid()}
-      fallback={<Card errorMessage={errorMessage() || "This comparison couldn't be displayed."} />}
-    >
-      <ErrorBoundary
-        fallback={() => {
-          local.onError?.('The comparison failed to render.');
-          return <Card errorMessage="The comparison failed to render." />;
-        }}
-      >
-        <div class={cn('flex flex-col gap-3', local.layout === 'auto' && '@container/compare', local.class)}>
-          <Show when={local.data?.prompt}>
-            <p id={promptId} class="text-sm text-foreground">
-              {local.data?.prompt}
-            </p>
-          </Show>
-
-          <Show
-            when={!res.isResolved()}
-            fallback={
-              <CollapsedWinner
-                candidate={chosenCandidate()}
-                optimistic={res.isOptimistic()}
-              />
-            }
-          >
-            {/* Tab pills — switch the visible candidate in tabs / auto-narrow mode. */}
-            <Show when={showTabs()}>
-              <div role="tablist" aria-label="Switch response" class={cn('flex gap-1', tabBarClass())}>
-                <Index each={pair() ?? []}>
-                  {(candidate, index) => (
-                    <button
-                      type="button"
-                      role="tab"
-                      aria-selected={active() === index}
-                      class={cn(
-                        'rounded-md px-3 py-1 text-xs font-medium transition-colors',
-                        active() === index
-                          ? 'bg-muted text-foreground'
-                          : 'text-muted-foreground hover:text-foreground',
-                      )}
-                      onClick={() => { setActive(index); setFocusIndex(index); }}
-                    >
-                      {candidate().label ?? `Response ${candidate().id}`}
-                    </button>
-                  )}
-                </Index>
-              </div>
-            </Show>
-
-            <div
-              ref={groupRef}
-              role="radiogroup"
-              aria-label={groupLabel()}
-              aria-describedby={local.data?.prompt ? promptId : undefined}
-              class={wrapperClass()}
-              onKeyDown={onGroupKeyDown}
-            >
-              <Index each={pair() ?? []}>
-                {(candidate, index) => (
-                  <CompareColumn
-                    candidate={candidate()}
-                    tabStop={index === focusIndex()}
-                    disabled={streaming()}
-                    hiddenClass={() => columnHiddenClass(index)}
-                    onFocus={() => setFocusIndex(index)}
-                    onPick={() => {
-                      setFocusIndex(index);
-                      pick(candidate());
-                    }}
-                  />
-                )}
-              </Index>
-            </div>
-          </Show>
-        </div>
-      </ErrorBoundary>
-    </Show>
-  );
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// One candidate column — a plain container with the assistant-styled body and a
-// "Pick this" button that IS the radio (the radiogroup option). Keeping the radio
-// on the button, not the wrapping div, avoids nesting interactive controls (the
-// body itself can contain interactive bits like reasoning/tool toggles).
-// ─────────────────────────────────────────────────────────────────────────────
-
-interface ColumnProps {
-  candidate: CompareCandidate;
-  tabStop: boolean;
-  disabled: boolean;
-  /** Extra (reactive) class controlling tabs/auto visibility — hidden when this
-   *  is the non-active candidate in tabs / auto-narrow mode. */
-  hiddenClass?: () => string;
-  onFocus: () => void;
-  onPick: () => void;
-}
-
-function CompareColumn(props: ColumnProps): JSX.Element {
-  const labelText = (): string =>
-    props.candidate.label ?? props.candidate.model ?? props.candidate.id;
-  return (
-    <div
-      class={cn(
-        'flex min-w-0 flex-col gap-3 rounded-lg border border-border bg-background/40 p-3',
-        props.hiddenClass?.(),
-      )}
-    >
-      <Show when={props.candidate.label || props.candidate.model}>
-        <div class="flex items-center gap-2">
-          <Show when={props.candidate.label}>
-            <span class="text-xs font-semibold uppercase tracking-wide text-muted-foreground">
-              {props.candidate.label}
-            </span>
-          </Show>
-          <Show when={props.candidate.model}>
-            <span class="text-xs text-muted-foreground">{props.candidate.model}</span>
-          </Show>
-        </div>
-      </Show>
-
-      <div class="min-w-0 flex-1">
-        <Show
-          when={props.candidate.streaming}
-          fallback={
-            <MessageBody
-              parts={candidateToParts(props.candidate)}
-              isUser={false}
-              markdown={true}
-            />
-          }
-        >
-          <TextShimmer class="text-sm">Generating response…</TextShimmer>
-        </Show>
-      </div>
-
-      <Button
-        type="button"
-        role="radio"
-        aria-checked={false}
-        aria-label={`Pick ${labelText()}`}
-        data-candidate-id={props.candidate.id}
-        variant="outline"
-        size="sm"
-        class="mt-auto w-full"
-        disabled={props.disabled}
-        tabindex={props.tabStop ? 0 : -1}
-        onFocus={props.onFocus}
-        onClick={(e) => {
-          e.stopPropagation();
-          props.onPick();
-        }}
-      >
-        Pick this
-      </Button>
-    </div>
-  );
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// CollapsedWinner — the read-only view after a pick: the chosen candidate's body
-// (reasoning + tools + attachments + markdown), with a "Selected" affordance.
-// role="status" only for an optimistic flip made this session.
-// ─────────────────────────────────────────────────────────────────────────────
-
-function CollapsedWinner(props: {
-  candidate: CompareCandidate | undefined;
-  optimistic: boolean;
-}): JSX.Element {
-  return (
-    <div
-      class="flex flex-col gap-2 rounded-lg border border-border bg-accent/40 p-3"
-      role={props.optimistic ? 'status' : undefined}
-    >
-      <div class="flex items-center gap-2 text-sm font-medium text-accent-foreground">
-        <Check size={16} aria-hidden="true" />
-        <span>Selected{props.candidate?.label ? `: ${props.candidate.label}` : ''}</span>
-      </div>
-      <Show when={props.candidate} fallback={<p class="text-sm text-muted-foreground">Response selected.</p>}>
-        {(c) => (
-          <div class="min-w-0">
-            <MessageBody
-              parts={candidateToParts(c())}
-              isUser={false}
-              markdown={true}
-            />
-          </div>
-        )}
-      </Show>
-    </div>
-  );
-}

package/src/components/response-stream.tsx

@@ -1,109 +0,0 @@
-import { splitProps, Show, For, createEffect, on } from 'solid-js';
-import { Dynamic } from 'solid-js/web';
-import { cn } from '../utils/cn';
-import { useTextStream, defaultFadeDuration, defaultSegmentDelay } from '../primitives/use-text-stream';
-
-export type Mode = 'typewriter' | 'fade';
-
-export interface ResponseStreamProps {
-  textStream: string | AsyncIterable<string>;
-  mode?: Mode;
-  speed?: number;
-  class?: string;
-  onComplete?: () => void;
-  as?: string;
-  fadeDuration?: number;
-  segmentDelay?: number;
-  characterChunkSize?: number;
-}
-
-function ResponseStream(props: ResponseStreamProps) {
-  const [local] = splitProps(props, [
-    'textStream', 'mode', 'speed', 'class', 'onComplete',
-    'as', 'fadeDuration', 'segmentDelay', 'characterChunkSize',
-  ]);
-
-  const mode = () => local.mode ?? 'typewriter';
-  const speed = () => local.speed ?? 20;
-
-  const stream = useTextStream({
-    mode: mode(),
-    speed: speed(),
-    characterChunkSize: local.characterChunkSize,
-    fadeDuration: local.fadeDuration,
-    segmentDelay: local.segmentDelay,
-  });
-
-  createEffect(on(
-    () => local.textStream,
-    (source) => {
-      if (source) stream.startStreaming(source);
-    }
-  ));
-
-  // Deferred: `isComplete` INITIALISES true (nothing has streamed yet), so an
-  // undeferred first run would announce completion at mount — the same
-  // no-event-on-mount contract kai-tool pins for kai-open-change. Only the
-  // false -> true transition of a real stream may call onComplete.
-  createEffect(on(
-    () => stream.isComplete(),
-    (complete) => {
-      if (complete) local.onComplete?.();
-    },
-    { defer: true }
-  ));
-
-  const fadeStyle = () => {
-    const dur = local.fadeDuration ?? defaultFadeDuration(speed());
-    return `
-      @keyframes fadeIn {
-        from { opacity: 0; }
-        to { opacity: 1; }
-      }
-      .fade-segment {
-        display: inline-block;
-        opacity: 0;
-        animation: fadeIn ${dur}ms ease-out forwards;
-      }
-      .fade-segment-space {
-        white-space: pre;
-      }
-    `;
-  };
-
-  const segDelay = () => {
-    if (typeof local.segmentDelay === 'number') return Math.max(0, local.segmentDelay);
-    return defaultSegmentDelay(speed());
-  };
-
-  return (
-    <Dynamic component={local.as ?? 'div'} class={local.class}>
-      <Show
-        when={mode() === 'fade'}
-        fallback={<>{stream.displayedText()}</>}
-      >
-        <style>{fadeStyle()}</style>
-        <div class="relative">
-          <For each={stream.segments()}>
-            {(segment, idx) => {
-              const isWhitespace = () => /^\s+$/.test(segment.text);
-              return (
-                <span
-                  class={cn(
-                    'fade-segment',
-                    isWhitespace() && 'fade-segment-space'
-                  )}
-                  style={{ 'animation-delay': `${idx() * segDelay()}ms` }}
-                >
-                  {segment.text}
-                </span>
-              );
-            }}
-          </For>
-        </div>
-      </Show>
-    </Dynamic>
-  );
-}
-
-export { ResponseStream };