@candor-ui/react 1.5.0 → 1.8.0

package/dist/lib/render-prop.d.ts

@@ -6,11 +6,11 @@ import * as React from "react";
  */
 export type RenderProp = {
     /** Base UI's way to render as another element; the same as `asChild` with that element as the child. */
-    render?: React.ReactElement;
+    render?: React.ReactElement | undefined;
     /** Base UI's flag for a button rendered as another element; shadcn adds it with `render`. Radix doesn't need it. */
-    nativeButton?: boolean;
+    nativeButton?: boolean | undefined;
 };
 export declare function withRender<P extends {
-    asChild?: boolean;
-    children?: React.ReactNode;
+    asChild?: boolean | undefined;
+    children?: React.ReactNode | undefined;
 }>({ render, nativeButton: _nativeButton, ...props }: P & RenderProp): P;

package/dist/lib/safe-markdown.d.ts

@@ -4,7 +4,7 @@ import type { InlineNode, MessageBlock } from "./chat.js";
  * unless `headings` is set, when `#`, `##` and `###` (and deeper, as level 3) become heading blocks.
  */
 export declare function markdownBlocks(text: string, { headings }?: {
-    headings?: boolean;
+    headings?: boolean | undefined;
 }): MessageBlock[];
 /** `code`, **strong**, *em* and links (as text). Everything else stays literal. */
 export declare function inline(text: string): InlineNode[];

package/dist/lib/status.d.ts

@@ -34,3 +34,24 @@ export declare const statusTone: {
     readonly skipped: "outline";
 };
 export declare function isTerminal(status: RunStatus): status is "succeeded" | "failed" | "cancelled" | "skipped";
+/** The machine or worker a run is on, when the app can't reach it. */
+export type HostOffline = {
+    /** The host's name as the app knows it: "Build runner 3", "Priya’s laptop". Left out, it's "The host". */
+    host?: string | undefined;
+    /** When the app lost contact. */
+    since?: string | undefined;
+};
+/**
+ * Whether a run can be called alive. "live": heard from recently, or the app doesn't track it. "stale": running, but
+ * nothing heard for longer than `staleAfter`, so it may have stopped. "offline": its host can't be reached.
+ * "unchecked": there's no clock yet (rendering on the server), so freshness isn't claimed either way. "settled": it
+ * has finished, so silence is expected. Only a running run goes stale: a queued or waiting one is quiet by design.
+ */
+export type RunLiveness = "live" | "stale" | "offline" | "unchecked" | "settled";
+/** Two minutes: the default silence after which a running run is no longer called running. */
+export declare const STALE_AFTER = 120000;
+export declare function runLiveness(run: {
+    status: RunStatus;
+    lastHeardAt?: Date | string | undefined;
+    hostOffline?: HostOffline | undefined;
+}, now: number | null, staleAfter?: number): RunLiveness;

package/dist/lib/status.js

@@ -33,3 +33,20 @@ export const statusTone = {
 export function isTerminal(status) {
     return status === "succeeded" || status === "failed" || status === "cancelled" || status === "skipped";
 }
+/** Two minutes: the default silence after which a running run is no longer called running. */
+export const STALE_AFTER = 120_000;
+export function runLiveness(run, now, staleAfter = STALE_AFTER) {
+    if (isTerminal(run.status))
+        return "settled";
+    if (run.hostOffline)
+        return "offline";
+    if (run.status !== "running" || run.lastHeardAt === undefined)
+        return "live";
+    const heard = new Date(run.lastHeardAt).getTime();
+    // An unreadable time ("", "10:42") is no evidence the run is alive.
+    if (Number.isNaN(heard))
+        return "stale";
+    if (now === null)
+        return "unchecked";
+    return now - heard > staleAfter ? "stale" : "live";
+}

package/dist/lib/use-shortcut.d.ts

@@ -11,5 +11,5 @@ export declare function comboKeys(combo: string): string[];
  * the person is typing in a field, so "?" still types a question mark.
  */
 export declare function useShortcut(combo: string, handler: (e: KeyboardEvent) => void, { enabled }?: {
-    enabled?: boolean;
+    enabled?: boolean | undefined;
 }): void;

package/dist/lib/use-virtual-list.d.ts

@@ -27,13 +27,13 @@ export declare function useVirtualList({ enabled, count, keyOf, scroller, estima
     count: number;
     keyOf: (index: number) => React.Key;
     scroller: React.RefObject<HTMLElement | null>;
-    estimate?: number;
-    overscan?: number;
-    initial?: number;
+    estimate?: number | undefined;
+    overscan?: number | undefined;
+    initial?: number | undefined;
     /** Which end to show before the scroller is measured: "end" for a thread (newest last), "start" for a list. Defaults to "end". */
-    anchor?: "start" | "end";
+    anchor?: "start" | "end" | undefined;
     /** The gap between items, in pixels, read once the scroller is measured (e.g. from the list's computed `row-gap`). */
-    gap?: () => number;
+    gap?: (() => number) | undefined;
     /** The key of an item to keep rendered, such as the one holding focus. */
-    pin?: string | null;
+    pin?: string | null | undefined;
 }): VirtualList;

package/dist/styles.css

@@ -238,6 +238,9 @@
  * (--primary, --background…), everything else by its --cd-* name. A brand theme
  * is just such a file.
  *
+ * Font: Inter when the font-inter item is installed (styles/candor-font-inter.css),
+ * else the system's sans-serif. Point --cd-font at your own font to use it instead.
+ *
  * Density: data-density="compact" on <html> (or any container) tightens type for
  * dense apps: 14px conversation text and 13px body and label text, with a narrower
  * thread and sidebar.
@@ -476,7 +479,7 @@
 
 @layer base {
   * {
-    @apply border-border outline-ring/50;
+    @apply border-border outline-ring/80;
   }
   body {
     @apply bg-background text-foreground font-sans text-sm;

package/dist/ui/button.d.ts

@@ -7,6 +7,6 @@ declare const buttonVariants: (props?: ({
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Button(allProps: React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
     /** Render the child element (a link, say) with the button's styles instead of a <button>. */
-    asChild?: boolean;
+    asChild?: boolean | undefined;
 } & RenderProp): React.JSX.Element;
 export { Button, buttonVariants };

package/dist/ui/button.js

@@ -7,7 +7,7 @@ import { withRender } from "../lib/render-prop.js";
 import { cn } from "../lib/utils.js";
 // The accent fills the one primary act, the radius is the theme's
 // --cd-radius-button, and buttons press down slightly on :active.
-const buttonVariants = cva("inline-flex shrink-0 items-center justify-center gap-2 rounded-button text-sm font-medium whitespace-nowrap outline-none select-none transition-[background-color,color,border-color,box-shadow,transform,opacity] duration-150 ease-standard active:scale-[0.98] focus-visible:ring-[3px] focus-visible:ring-ring/40 disabled:pointer-events-none disabled:opacity-45 data-[locked]:cursor-not-allowed data-[locked]:opacity-45 data-[locked]:active:scale-100 aria-invalid:ring-destructive/25 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", {
+const buttonVariants = cva("inline-flex shrink-0 items-center justify-center gap-2 rounded-button text-sm font-medium whitespace-nowrap outline-none select-none transition-[background-color,color,border-color,box-shadow,transform,opacity] duration-150 ease-standard active:scale-[0.98] focus-visible:ring-[3px] focus-visible:ring-ring/80 disabled:pointer-events-none disabled:opacity-45 data-[locked]:cursor-not-allowed data-[locked]:opacity-45 data-[locked]:active:scale-100 aria-invalid:ring-destructive/25 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", {
     variants: {
         variant: {
             default: "bg-primary text-primary-foreground hover:bg-primary-hover",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@candor-ui/react",
-  "version": "1.5.0",
+  "version": "1.8.0",
   "description": "Candor UI's free tier as an npm package: React components for agents that do real work, on shadcn/ui and Tailwind 4.",
   "license": "MIT",
   "author": "Methodic LLC",