@kitn.ai/ui 0.27.0 → 0.29.0

package/src/index.ts

@@ -1,428 +0,0 @@
-// The package root entry (".").
-//
-// SCOPE — read before adding an export here.
-// -----------------------------------------
-// Every consumer of `@kitn.ai/ui` pays for this barrel, INCLUDING React/Vue/
-// Svelte consumers who never render a Solid component. It is therefore frozen at
-// the surface that shipped: adding a Solid component here taxes four frameworks
-// to serve one. Closing the element coverage gaps on this file grew it
-// 591,359 -> 705,031 bytes (+19.2%), which is what motivated the split. (That
-// measurement was taken at the then-79 elements; the catalog grows, the bytes
-// quoted do not — they are a record of the split, not a current reading.)
-//
-// The COMPLETE SolidJS surface — a component for EVERY registered element plus a
-// `<Name>Props` type for every public component — lives on `@kitn.ai/ui/solid`
-// (src/solid.ts), which is its own build target so only Solid consumers pay for
-// it. `npm run verify:solid-coverage` prints the element count and proves that
-// surface n/n on every run, which is why no count is restated here. `./solid`
-// re-exports this file, so it is a strict superset: anything here is reachable
-// there too, and a Solid consumer only ever needs the one import.
-//
-// Rule of thumb: a NEW Solid component export belongs in src/solid.ts.
-// Type-only exports are free (fully erased by the build) and may live in either.
-
-// Shared types (folded in from @tab-zen/shared)
-export type { ModelOption, SearchFilters, ConversationScope, ConversationSummary, ConversationGroup } from './types';
-
-// Utilities
-export { cn } from './utils/cn';
-
-// Layer 1: Headless Primitives
-export { createKaiChat } from './primitives/create-kai-chat';
-export type { CreateKaiChatOptions, KaiChatStore } from './primitives/create-kai-chat';
-export { useAutoResize } from './primitives/use-auto-resize';
-export { useStickToBottom } from './primitives/use-stick-to-bottom';
-export { useTextStream } from './primitives/use-text-stream';
-export type { UseTextStreamOptions, TextStreamSegment } from './primitives/use-text-stream';
-export { useVoiceRecorder } from './primitives/use-voice-recorder';
-export type { UseVoiceRecorderOptions } from './primitives/use-voice-recorder';
-export { ChatConfig, useChatConfig, proseClass, textClass } from './primitives/chat-config';
-export type { ChatConfigValue, ProseSize, ChatConfigProps } from './primitives/chat-config';
-export { configureCodeHighlighting, isCodeHighlightingEnabled } from './primitives/highlighter';
-export type { CodeHighlightingOptions } from './primitives/highlighter';
-export { configurePdfPreview, isPdfPreviewEnabled } from './primitives/pdf-preview';
-export type { PdfPreviewOptions } from './primitives/pdf-preview';
-
-// Toasts: imperative `toast()` API + the reactive store behind <kai-toast-region>
-export { toast, configureToasts, ensureMounted as ensureToastRegion, getToasts } from './primitives/toast-store';
-export type {
-  ToastItem, ToastVariant, ToastAction, ToastOptions, ToastHandle, ToastFn, ToastConfig,
-} from './primitives/toast-store';
-export { Toast, ToastRegion } from './components/toast';
-export type {
-  ToastProps, ToastRegionProps, ToastDismissReason, ToastPosition,
-} from './components/toast';
-
-// Card Contract (generative-UI foundation)
-export { CARD_CONTRACT_VERSION } from './primitives/card-contract';
-export type {
-  CardEnvelope, CardContext, CardEvent, CardEventKind, CardResolution, CardHost, CardPolicy,
-} from './primitives/card-contract';
-export { applyResolution, resolutionFromEvent } from './primitives/card-resolution';
-export { CardProvider, useCardHost } from './primitives/card-host';
-export type { CardProviderProps } from './primitives/card-host';
-export { CARD_EVENT_NAME, emitCardEvent, routeCardEvent, listenForCardEvents } from './primitives/card-routing';
-export { dismissRecovery, defaultIsReopenable } from './primitives/card-recovery';
-export type {
-  RecoveryToast, ReopenEnv, DismissRecoveryOptions,
-} from './primitives/card-recovery';
-export { validateAgainstSchema } from './primitives/card-validate';
-export type { JsonSchema, ValidationResult } from './primitives/card-validate';
-
-// Remote host SDK (iframe transport — host side only; provider runtime ships via ./provider subpath)
-export { mountRemoteCard } from './remote/host-embed';
-export type { MountRemoteCardOptions, RemoteCardHandle } from './remote/host-embed';
-
-// Card dispatcher (generative-UI host glue)
-export { CardRenderer, renderCard } from './components/card-renderer';
-export type { CardRendererProps } from './components/card-renderer';
-export { CardFallback } from './components/card-fallback';
-export type { CardFallbackProps } from './components/card-fallback';
-export {
-  BUILTIN_CARD_TAGS, BUILTIN_CARD_COMPONENTS, mergeCardTags, mergeCardComponents,
-} from './primitives/card-registry';
-export type { CardComponent, CardComponentMap, CardTagMap } from './primitives/card-registry';
-
-// Card: kai-card (base shell) + kai-form (JSON-Schema form renderer)
-export { Card } from './components/card';
-export type { CardProps } from './components/card';
-export { DismissedStub, stubIntent } from './components/dismissed-stub';
-export type { DismissedStubProps, DismissedCardType } from './components/dismissed-stub';
-export { Form, validateForm, buildResult, widgetFor, orderedKeys, coerceValue } from './components/form';
-export type {
-  FormProps,
-  FormField,
-  FormDefinition,
-  FormCardEnvelope,
-  FormValidation,
-  WidgetKind,
-} from './components/form';
-
-// Card: kai-confirm (approval) + kai-tasks (selectable plan)
-export {
-  ConfirmCard,
-  CONFIRM_CARD_TYPE,
-  buttonVariantForStyle,
-  normalizeActions,
-  defaultActionId,
-} from './components/confirm-card';
-export type {
-  ConfirmCardProps,
-  ConfirmAction,
-  ConfirmActionStyle,
-  ConfirmTone,
-  ConfirmCardData,
-  ConfirmCardEnvelope,
-} from './components/confirm-card';
-export {
-  TasksCard,
-  TASKS_CARD_TYPE,
-  normalizeTasks,
-  initialSelected,
-  selectedInOrder,
-  toggleableIds,
-  selectAllState,
-  showSelectAll,
-  canConfirm,
-  isMaxReached,
-  confirmReason,
-} from './components/tasks-card';
-export type {
-  TasksCardProps,
-  TasksTask,
-  TasksCardData,
-  TasksCardResult,
-  TasksCardEnvelope,
-  SelectAllState,
-} from './components/tasks-card';
-
-// Card: kai-choice (single-select option card)
-export {
-  ChoiceCard,
-  CHOICE_CARD_TYPE,
-  OTHER_ACTION,
-  normalizeOptions,
-  resolveOtherConfig,
-  nextEnabledIndex,
-  firstEnabledIndex,
-} from './components/choice-card';
-export type {
-  ChoiceCardProps,
-  ChoiceOption,
-  ChoiceOptionMedia,
-  ChoiceAllowOther,
-  ChoiceCardData,
-  ChoiceCardEnvelope,
-} from './components/choice-card';
-
-// Card: kai-link-preview (OG/link preview) + kai-embed (lazy media embed)
-export { LinkPreview } from './components/link-preview';
-export type { LinkPreviewProps } from './components/link-preview';
-export { Embed } from './components/embed';
-export type { EmbedProps } from './components/embed';
-export {
-  configureLinkPreview,
-  resolveLinkMetadata,
-  hasLinkPreviewFetcher,
-  LINK_PREVIEW_TYPE,
-} from './primitives/link-preview';
-export type { LinkPreviewData, LinkPreviewEnvelope, LinkMetadataFetcher } from './primitives/link-preview';
-export {
-  resolveEmbed,
-  parseYouTubeId,
-  parseVimeoId,
-  configureEmbedAllowlist,
-  isGenericOriginAllowed,
-  EMBED_CARD_TYPE,
-} from './primitives/embed-providers';
-export type { EmbedCardData, EmbedCardEnvelope, EmbedProvider, ResolvedEmbed } from './primitives/embed-providers';
-
-// Layer 2: UI Primitives
-export { Button, buttonVariants } from './ui/button';
-export type { ButtonProps } from './ui/button';
-export { Avatar } from './ui/avatar';
-export type { AvatarProps } from './ui/avatar';
-export { Tooltip } from './ui/tooltip';
-export type { TooltipProps, TooltipController } from './ui/tooltip';
-export { HoverCard } from './ui/hover-card';
-export type { HoverCardProps, HoverCardController } from './ui/hover-card';
-export { Collapsible, CollapsibleTrigger, CollapsibleContent } from './ui/collapsible';
-export type {
-  CollapsibleProps, CollapsibleTriggerProps, CollapsibleContentProps, CollapsibleController,
-} from './ui/collapsible';
-export { ScrollArea } from './ui/scroll-area';
-export type { ScrollAreaProps, ScrollOrientation } from './ui/scroll-area';
-export { Dropdown, DropdownTrigger, DropdownContent, DropdownItem } from './ui/dropdown';
-export type {
-  DropdownProps, DropdownTriggerProps, DropdownContentProps, DropdownItemProps, DropdownController,
-} from './ui/dropdown';
-export { Textarea } from './ui/textarea';
-export type { TextareaProps } from './ui/textarea';
-export { Badge } from './ui/badge';
-export type { BadgeProps } from './ui/badge';
-export { Separator } from './ui/separator';
-export type { SeparatorProps } from './ui/separator';
-export { ResizablePanelGroup, ResizablePanel, ResizableHandle, Resizable, normalizeSize, resolveToPx } from './ui/resizable';
-export type { ResizablePanelGroupProps, ResizablePanelProps, ResizableHandleProps, ResizableProps, SizeValue } from './ui/resizable';
-export { Skeleton } from './ui/skeleton';
-export type { SkeletonProps, SkeletonVariant } from './ui/skeleton';
-export { FileTree, buildFileTree } from './components/file-tree';
-export type {
-  FileTreeProps, FileTreeFile, FileTreeNode, FileTreeFolderNode, FileTreeFileNode,
-} from './components/file-tree';
-export { Artifact } from './components/artifact';
-export type { ArtifactProps, ArtifactFile, ArtifactTab } from './components/artifact';
-export { ArtifactCard, DEFAULT_ARTIFACT_CARD_HEIGHT } from './components/artifact-card';
-// `ArtifactCardFile` is the SAME declaration `FileTreeFile` and `ArtifactFile`
-// alias, authored in primitives/card-data-types.ts because `ArtifactCardData.files`
-// reaches it and that module has to stay resolvable from a Node/no-DOM project.
-// It is exported here under its authored name because that is the name the
-// generated element metadata records for `kai-artifact.files` / `kai-file-tree.files`,
-// and tests/elements/prop-types-exported.ts requires every named prop type to be
-// importable from this entry. The two aliases stay exported above, unchanged.
-export type {
-  ArtifactCardProps,
-  ArtifactCardData,
-  ArtifactCardEnvelope,
-  ArtifactCardFile,
-  ArtifactCardTab,
-} from './components/artifact-card';
-
-// Layer 3: AI/Feature Components
-export {
-  ChatContainer, ChatContainerRoot, ChatContainerContent, ChatContainerScrollAnchor,
-  useChatContainer,
-} from './components/chat-container';
-export type {
-  ChatContainerProps, ChatContainerRootProps, ChatContainerContentProps, ChatContainerScrollAnchorProps,
-} from './components/chat-container';
-export { Message, MessageAvatar, MessageContent, MessageActions, MessageAction, MessageCopyButton, MessageBody } from './components/message';
-export type {
-  MessageProps, MessageAvatarProps, MessageContentProps, MessageActionsProps,
-  MessageActionProps, MessageCopyButtonProps, MessageBodyProps,
-} from './components/message';
-export { ResponseCompare, useResolved } from './components/response-compare';
-export type { ResponseCompareProps, CompareLayout, ResolvedController } from './components/response-compare';
-export {
-  normalizeCandidates,
-  buildSelection,
-  isAnyStreaming,
-} from './components/response-compare';
-export type {
-  CompareCandidate,
-  ComparePair,
-  CompareCollapse,
-  ResponseCompareData,
-  CompareSelection,
-} from './components/response-compare';
-export { MessageSkills } from './components/message-skills';
-export type { MessageSkillsProps, Skill as MessageSkill } from './components/message-skills';
-export {
-  PromptInput, PromptInputTextarea, PromptInputActions, PromptInputAction,
-  usePromptInput,
-} from './components/prompt-input';
-export type {
-  PromptInputProps, PromptInputTextareaProps, PromptInputActionsProps, PromptInputActionProps,
-} from './components/prompt-input';
-export { ResponseStream } from './components/response-stream';
-export type { ResponseStreamProps } from './components/response-stream';
-export { Markdown } from './components/markdown';
-export type { MarkdownProps } from './components/markdown';
-export { CodeBlock, CodeBlockCode, CodeBlockGroup } from './components/code-block';
-export type { CodeBlockProps, CodeBlockCodeProps, CodeBlockGroupProps } from './components/code-block';
-export { Loader } from './components/loader';
-export type { LoaderVariant, LoaderSize, LoaderProps } from './components/loader';
-export {
-  CircularLoader, ClassicLoader, PulseLoader, PulseDotLoader,
-  DotsLoader, TypingLoader, WaveLoader, BarsLoader,
-  TerminalLoader, TextBlinkLoader, TextShimmerLoader, TextDotsLoader,
-} from './components/loader';
-export type {
-  LoaderShapeProps, LoaderTextProps,
-  CircularLoaderProps, ClassicLoaderProps, PulseLoaderProps, PulseDotLoaderProps,
-  DotsLoaderProps, TypingLoaderProps, WaveLoaderProps, BarsLoaderProps,
-  TerminalLoaderProps, TextBlinkLoaderProps, TextShimmerLoaderProps, TextDotsLoaderProps,
-} from './components/loader';
-export { FeedbackBar, type FeedbackValue, type FeedbackDetail, type FeedbackBarProps } from './components/feedback-bar';
-export {
-  ChainOfThought, ChainOfThoughtStep, ChainOfThoughtTrigger,
-  ChainOfThoughtContent, ChainOfThoughtItem,
-} from './components/chain-of-thought';
-export type {
-  ChainOfThoughtProps, ChainOfThoughtStepProps, ChainOfThoughtTriggerProps,
-  ChainOfThoughtContentProps, ChainOfThoughtItemProps,
-  ChainOfThoughtType, ChainOfThoughtStepData, ChainOfThoughtController,
-} from './components/chain-of-thought';
-export { Source, SourceTrigger, SourceContent, SourceList } from './components/source';
-export type { SourceProps, SourceTriggerProps, SourceContentProps, SourceListProps } from './components/source';
-export { PromptSuggestion } from './components/prompt-suggestion';
-export type { PromptSuggestionProps } from './components/prompt-suggestion';
-export {
-  Empty, EmptyHeader, EmptyMedia, EmptyTitle, EmptyDescription, EmptyContent, emptyMediaVariants,
-} from './components/empty';
-export type {
-  EmptyProps, EmptyHeaderProps, EmptyMediaProps, EmptyTitleProps, EmptyDescriptionProps, EmptyContentProps,
-} from './components/empty';
-export { ScrollButton } from './components/scroll-button';
-export type { ScrollButtonProps } from './components/scroll-button';
-export { TextShimmer } from './components/text-shimmer';
-export type { TextShimmerProps } from './components/text-shimmer';
-export { Checkpoint, CheckpointIcon, CheckpointTrigger } from './components/checkpoint';
-export type { CheckpointProps, CheckpointIconProps, CheckpointTriggerProps } from './components/checkpoint';
-export {
-  Context,
-  ContextTrigger,
-  ContextContent,
-  ContextContentHeader,
-  ContextContentBody,
-  ContextContentFooter,
-  ContextInputUsage,
-  ContextOutputUsage,
-  ContextReasoningUsage,
-  ContextCacheUsage,
-} from './components/context';
-export type {
-  ContextProps,
-  ContextTriggerProps,
-  ContextContentProps,
-  ContextContentHeaderProps,
-  ContextContentBodyProps,
-  ContextContentFooterProps,
-  ContextUsageRowProps,
-  ContextInputUsageProps,
-  ContextOutputUsageProps,
-  ContextReasoningUsageProps,
-  ContextCacheUsageProps,
-} from './components/context';
-export { VoiceInput } from './components/voice-input';
-export type { VoiceInputProps, VoiceInputController } from './components/voice-input';
-export { ConversationList } from './components/conversation-list';
-export type { ConversationListProps, ConversationListController } from './components/conversation-list';
-export { ConversationItem } from './components/conversation-item';
-export { SlottedConversationItem } from './components/conversation-item';
-export type { SlottedConversationItemProps } from './components/conversation-item';
-export type { ConversationItemProps } from './components/conversation-item';
-export { ModelSwitcher } from './components/model-switcher';
-export type { ModelSwitcherProps } from './components/model-switcher';
-export { ChatScopePicker } from './components/chat-scope-picker';
-export type { ChatScopePickerProps } from './components/chat-scope-picker';
-export { Tool } from './components/tool';
-export type { ToolPart, ToolProps } from './components/tool';
-// ToolPart.kind's doc comment says "Derive with `classifyTool(type)`", so the
-// function has to be reachable from every entry that surfaces ToolPart. It is
-// total, deterministic and terminates in 'generic', so it is safe public API and
-// genuinely useful to anyone rendering tool calls themselves.
-export { classifyTool } from './components/tool-classify';
-export type { ToolKind } from './components/tool-classify';
-export { ThinkingBar } from './components/thinking-bar';
-export type { ThinkingBarProps } from './components/thinking-bar';
-export { Reasoning, ReasoningTrigger, ReasoningContent } from './components/reasoning';
-export type { ReasoningProps, ReasoningTriggerProps, ReasoningContentProps } from './components/reasoning';
-export { Image } from './components/image';
-export type { ImageProps, GeneratedImageLike } from './components/image';
-export { FileUpload, FileUploadTrigger, FileUploadContent } from './components/file-upload';
-export type { FileUploadProps, FileUploadTriggerProps, FileUploadContentProps } from './components/file-upload';
-export {
-  Attachments, Attachment, AttachmentPreview, AttachmentInfo, AttachmentRemove,
-  AttachmentHoverCard, AttachmentHoverCardTrigger, AttachmentHoverCardContent,
-  AttachmentEmpty, getMediaCategory, getAttachmentLabel,
-  useAttachmentsContext, useAttachmentContext,
-} from './components/attachments';
-export type {
-  AttachmentData, AttachmentMediaCategory, AttachmentVariant,
-  AttachmentsProps, AttachmentProps, AttachmentPreviewProps,
-  AttachmentInfoProps, AttachmentRemoveProps, AttachmentEmptyProps,
-  AttachmentHoverCardProps, AttachmentHoverCardTriggerProps, AttachmentHoverCardContentProps,
-} from './components/attachments';
-
-// Chat message types — public API for consumers who need to type their own message arrays.
-// NOTE: chat-types.ts also exports an unrelated `Source` interface (a citation), and
-// `Source` is already a public component export (./components/source, a citation
-// chip/trigger), so re-exporting both under that name is a duplicate-identifier error.
-// The citation type therefore ships under its alias `MessageSource`, which is also the
-// argument type of the public `AssistantStream.addSource(source)`.
-export type {
-  ChatMessage, ChatMessageAction, CustomAction, AvatarData, FeedbackVote, MessagePart,
-  MessageSource, RawOrigin,
-} from './elements/chat-types';
-
-// Composer document model. This belongs on "." rather than "./solid" because it
-// is part of the ELEMENT contract, not the Solid-only surface: `ComposerDoc` is
-// the non-string half of `kai-prompt-input` / `kai-composer` / `kai-default-input`'s
-// `value` property, and `doc` + `entities` on their `kai-submit` /
-// `kai-value-change` details. The shipped prop docs name `ComposerDoc` by name,
-// so a React or Vue consumer reading them has to be able to import it. Type-only,
-// so it is erased by the build and costs the root barrel nothing.
-export type { ComposerDoc, Segment, EntityRef } from './primitives/composer-model';
-
-// ---------------------------------------------------------------------------
-// Named types for the remaining kai-* array/object PROPERTIES.
-//
-// Same rationale as `ComposerDoc` above, applied to the whole class instead of
-// one instance: the generated `./elements` declarations and React wrappers expand
-// every prop type structurally (deliberately — see the `IMPORTS = {}` note in
-// scripts/gen-element-api.mjs), so a consumer who wants to NAME the shape had to
-// write `NonNullable<KaiPromptInputElementProps['triggers']>`. Every element-prop
-// type that has a name in source is now reachable from "." — the entry a React /
-// Vue / Svelte / vanilla consumer imports — not only from "./solid".
-//
-// Type-only, so the root barrel pays nothing at runtime.
-// Guarded by tests/elements/prop-types-exported.test.ts, which re-derives the
-// list from the facades with the TS checker and fails on a new unexported one.
-// ---------------------------------------------------------------------------
-export type { TriggerDef, TriggerItem } from './components/composer';
-export type { ChatThreadContextUsage } from './components/chat-thread';
-export type { Skill } from './components/message-skills';
-export type { AgentStatus } from './ui/agent-card';
-export type { KaiNavItem } from './ui/nav';
-export type { KaiTabItem } from './ui/tabs';
-export type { PaneStatus } from './ui/pane';
-export type { PaneTab } from './ui/pane-group';
-export type {
-  KaiCheckboxOption, KaiCommandItem, KaiContextUsage, KaiMenuItem, KaiRadioOption, KaiSegmentedOption, KaiSelectOption,
-  KaiSourceItem,
-} from './elements/element-data-types';
-// `kai-audio-visualizer.shader` takes a ShaderSpec. The element arrived from main
-// after this block was written, and prop-types-exported.test.ts caught it, which
-// is the point of deriving that list from the facades rather than maintaining it.
-export type { ShaderSpec } from './components/audio-visualizer';

package/src/primitives/audio-bands.ts

@@ -1,174 +0,0 @@
-/**
- * Pure reductions from AnalyserNode output to the numbers a visualizer draws.
- *
- * Ported from livekit/components-js `packages/react/src/hooks/useTrackVolume.ts`
- * (Apache License 2.0). Both the dB normalization curve AND the band split
- * are carried over so our output matches theirs frame for frame: the split
- * is upstream's linear-proportional chunking (their PR #1265). An interim
- * revision here spaced the buckets geometrically to serve a wide raw-mic
- * window; both reverted together -- see `reduceToBands` below and the
- * DEFAULTS docstring in use-audio-analysis.ts for the full story.
- */
-
-/** dB floor of the normalization curve. Below this reads as silence. */
-const MIN_DB = -100;
-/** dB ceiling. Above this saturates. */
-const MAX_DB = -10;
-
-/**
- * Map one `getFloatFrequencyData` decibel value to 0..1.
- *
- * The `sqrt` at the end is a perceptual curve, not a normalization step: it
- * lifts quiet detail so low-level audio still moves the bars visibly.
- */
-export function normalizeDb(value: number): number {
-  if (value === -Infinity) return 0;
-  const clamped = Math.max(MIN_DB, Math.min(MAX_DB, value));
-  return Math.sqrt(1 - (clamped * -1) / 100);
-}
-
-/**
- * Average a slice of the frequency spectrum into `bands` buckets.
- *
- * `loPass` / `hiPass` are BIN INDICES relative to `fftSize`, not frequencies.
- * Upstream's naming is misleading; the behavior is a plain array slice.
- *
- * Bucket edges are LINEAR-PROPORTIONAL across `[loPass, hiPass]` -- upstream
- * LiveKit's own distribution (`useMultibandTrackVolume`, useTrackVolume.ts
- * lines 141-153, rewritten to proportional chunking by their PR #1265): each
- * band averages an equal consecutive run of bins, `floor(i * total / bands)`
- * to `floor((i + 1) * total / bands)`, and a run that comes out empty reads
- * 0 (their `chunkLength === 0` branch). With the default window's 100 bins
- * and 5 bands, that is 20 bins averaged per band -- the averaging itself is
- * part of upstream's idle stillness, diluting any single flickering bin
- * 20:1 (noise-floor diagnosis, table B).
- *
- * An interim revision spaced these buckets geometrically so that a wide
- * raw-microphone window (bins 4-120) kept its upper buckets alive. That
- * concentrated the noisiest few low bins into band 0 undiluted, which the
- * centre-out mirror below then promoted to the CENTRE element -- the
- * measured core of the "white noise when the mic is on" defect (diagnosis
- * table B: geometric band 0 idled at 0.52 on real room tone where this
- * split reads 0.32 over the same wide window, and exactly 0 over the
- * default one). Reverted to upstream's split when the default window
- * reverted; the mirror stays, it is orthogonal.
- */
-export function reduceToBands(
-  freq: Float32Array,
-  bands: number,
-  loPass: number,
-  hiPass: number,
-): number[] {
-  // `slice` clamps both ends into the buffer and yields an empty window when
-  // hiPass <= loPass -- every bucket then reads 0 below, no special case.
-  const window = freq.slice(Math.max(0, loPass), Math.max(0, hiPass));
-  const total = window.length;
-  const out: number[] = [];
-
-  for (let i = 0; i < bands; i++) {
-    const start = Math.floor((i * total) / bands);
-    const end = Math.floor(((i + 1) * total) / bands);
-    if (end <= start) {
-      out.push(0);
-      continue;
-    }
-    let sum = 0;
-    for (let j = start; j < end; j++) sum += normalizeDb(window[j] as number);
-    out.push(sum / (end - start));
-  }
-
-  return out;
-}
-
-/** Root-mean-square of `getByteFrequencyData`, scaled to 0..1. */
-export function reduceToVolume(bytes: Uint8Array): number {
-  if (bytes.length === 0) return 0;
-  let sum = 0;
-  for (let i = 0; i < bytes.length; i++) {
-    const a = bytes[i] as number;
-    sum += a * a;
-  }
-  return Math.sqrt(sum / bytes.length) / 255;
-}
-
-/**
- * Resize a caller-supplied band array to exactly `count` entries. Extra values
- * are dropped; a short array repeats its last value (0 when empty) so a
- * consumer passing the wrong length gets a sane picture instead of holes.
- */
-export function normalizeVolumeBands(bands: number[], count: number): number[] {
-  if (bands.length === count) return bands;
-  if (bands.length > count) return bands.slice(0, count);
-  const last = bands[bands.length - 1] ?? 0;
-  return [...bands, ...new Array(count - bands.length).fill(last)];
-}
-
-/**
- * Maps a smaller, ordered set of "half" band values (index 0 = loudest,
- * typically lowest frequency) onto `count` positions laid out in a straight
- * line -- a row of bars, or a row of grid columns -- centre-outward and
- * mirrored: band 0 lands on the centre (an odd `count`) or the centre PAIR
- * (an even one, both positions sharing band 0), band 1 on the pair either
- * side of that, and so on outward to the two ends.
- *
- * Every scripted state in this component is already centre-oriented
- * (`listening` blinks the centre bar, `connecting` sweeps inward from both
- * ends, `thinking` sweeps the middle row) -- `speaking` ramping left to
- * right, because it fed the analyser's raw band order straight across, was
- * the one state inconsistent with that. This closes that gap.
- *
- * `halfBands` should have exactly `Math.ceil(count / 2)` entries -- the
- * caller is responsible for requesting that many bands from
- * `useAudioAnalysis`, matching counts exactly rather than leaning on
- * `normalizeVolumeBands`'s pad-by-repeating-the-last-value, which would
- * produce a subtly wrong (not obviously broken) shape here. A shorter
- * `halfBands` still degrades sanely: the outermost positions repeat the last
- * value available rather than reading `undefined`.
- */
-export function mirrorBandsCenterOut(halfBands: number[], count: number): number[] {
-  const center = (count - 1) / 2;
-  const out: number[] = new Array(count);
-  for (let i = 0; i < count; i++) {
-    const ring = Math.floor(Math.abs(i - center));
-    out[i] = halfBands[Math.min(ring, halfBands.length - 1)] ?? 0;
-  }
-  return out;
-}
-
-/**
- * Maps a smaller, ordered set of "half" band values onto `count` positions
- * arranged around a RING (radial's spokes), mirrored left-right across a
- * single vertical axis rather than fanned from a linear centre: index 0 and
- * index `count / 2` (for an even `count`; radial warns when `count` is not
- * divisible by 4, so this is the common case) are each their own fixed
- * point of the reflection and both land band 0, and every other index pairs
- * with its mirror partner at `count - i`, sharing a band.
- *
- * Radial's own geometry (`variant-radial.tsx`) places index 0 at the
- * BOTTOM of the ring (`rotate(0) translateY(radius)`, and CSS rotation is
- * clockwise for a positive angle), so band 0 (usually the loudest) reads at
- * the bottom, fading toward the top -- not band 0 at both the top AND the
- * bottom, which would need a second, horizontal mirror axis on top of this
- * one. Chosen over that fuller symmetry because it reuses the exact same
- * `Math.ceil(count / 2)` band request as the linear mirror above (one rule
- * for every variant, not a radial-specific band count), and because the
- * task's request was "spikes vary in length, not moving as one" -- this
- * already delivers that. If bottom-loud/top-quiet reads wrong in practice,
- * swapping to true 4-fold symmetry is a self-contained change here, not
- * elsewhere.
- *
- * For an even `count`, the antipodal index (`count / 2`) needs one more
- * distinct band than the linear mirror does (rings run 0..`count / 2`, not
- * 0..`count / 2 - 1`) -- with only `Math.ceil(count / 2)` bands available,
- * that one index clamps to the same value as its nearest neighbour rather
- * than getting a unique band. A minor, deliberate simplification for the
- * same one-rule-for-every-variant reason above.
- */
-export function mirrorBandsAroundRing(halfBands: number[], count: number): number[] {
-  const out: number[] = new Array(count);
-  for (let i = 0; i < count; i++) {
-    const ring = Math.min(i, count - i);
-    out[i] = halfBands[Math.min(ring, halfBands.length - 1)] ?? 0;
-  }
-  return out;
-}

package/src/primitives/card-component-types.ts

@@ -1,63 +0,0 @@
-// src/primitives/card-component-types.ts
-// `CardEnvelope.type` -> the Solid component that renders it, as a TYPE.
-//
-// TYPES ONLY, AND THAT IS THE WHOLE FILE. `BUILTIN_CARD_COMPONENTS` and
-// `mergeCardComponents` stay in card-registry.tsx and cannot follow them here: they
-// ARE JSX. So this is not the same split card-tags.ts made — that one moved data and
-// its type; this one moves only the type, because the value half has nowhere else to
-// go. Do not try to "finish" the symmetry by dragging the component map over.
-//
-// WHY THE TYPES ARE ALONE IN A `.ts`
-// ----------------------------------
-// The same reason, one layer along, that card-tags.ts exists — read that file's header
-// first; this is the second instance of its problem, not a new one.
-//
-// `@kitn.ai/ui/schemas` is the server-safe entry, and src/schemas/registry.ts declares
-// `CustomCardSpec.component` and `CardRegistry.components` in terms of
-// `CardComponentMap`. That is a TYPE import and erases at runtime, but a type import
-// still has to RESOLVE, and while these two types lived in card-registry.tsx it
-// resolved to a `.tsx`. tsconfig.mcp.json has no `jsx` on purpose, so the `kai` MCP's
-// typecheck pass reported, on any tree that had not been built:
-//
-//   src/schemas/registry.ts(61,51): error TS6142: Module '../primitives/card-registry'
-//   was resolved to '.../card-registry.tsx', but '--jsx' is not set.
-//
-// Exactly one error, and the last one standing on an unbuilt tree. Moving the two type
-// aliases into this file takes that pass to 0. Measured on this tree, both directions.
-//
-// Relaxing tsconfig.mcp.json instead is not an option, and that is measured too, not
-// recalled: giving that project `jsx: "preserve"` + `jsxImportSource: "solid-js"` —
-// the settings the main tsconfig.json actually uses — takes it from 1 error to 130,
-// almost all `TS2304: Cannot find name 'HTMLDivElement' / 'window'`, because a `jsx`
-// setting drags the whole Solid component tree into a Node-only, `lib: ["ESNext"]`
-// pass. (`jsx: "preserve"` with no import source is worse still: 838.) card-tags.ts
-// records 1364 for the broader case. The figures differ because the reachable set
-// differs; the conclusion does not. The Node/no-DOM boundary is load-bearing.
-//
-// `import type { Component } from 'solid-js'` below does NOT reintroduce the problem
-// it just solved. Type-importing from solid-js resolves to a `.d.ts`, and a
-// declaration file needs no `jsx` to be read; `skipLibCheck` covers what is inside it.
-// It is resolving a `.tsx` SOURCE file that TS6142 objects to, and this file resolves
-// none.
-//
-// WHAT THIS SPLIT DOES NOT DO
-// ---------------------------
-// It changes nothing at runtime, and must not be sold as if it did. This module is
-// types only, so it compiles to nothing and there is no emitted module to compare:
-// `verify:ssr` and `verify:schemas` read the BUILT entry and cannot tell the two
-// arrangements apart even in principle. card-tags.ts records the same finding for its
-// own case from the harder direction, where there WAS a bundle to diff and it came out
-// byte-identical. The boundary this file defends is a compile-time one. The
-// discriminating check is `tsc --noEmit -p tsconfig.mcp.json` on an UNBUILT tree, and
-// nothing else is evidence for it.
-
-import type { Component } from 'solid-js';
-import type { CardEnvelope, CardHost } from './card-contract';
-
-/** Solid renderer for one envelope. `host` is the resolved CardHost so each wrapper
- *  can bridge its card's emit convention (form/confirm/tasks take `host`;
- *  link/embed take `onEmit`). */
-export type CardComponent = Component<{ envelope: CardEnvelope; host?: CardHost }>;
-
-/** Solid layer: envelope type → the component that draws it. */
-export type CardComponentMap = Record<string, CardComponent>;