@opengeni/react 0.29.0 → 0.32.1

package/dist/lib/clipboard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Copy plain text to the clipboard. Prefers the async Clipboard API; falls
+ * back to a short-lived textarea for older embeds / denied permissions.
+ */
+export declare function copyTextToClipboard(text: string): Promise<boolean>;
+/** Serialize an HTML table to tab-separated values (spreadsheet-friendly). */
+export declare function tableElementToTsv(table: HTMLTableElement | null | undefined): string;

package/dist/lib/cn.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+/** Merge class names with Tailwind-aware conflict resolution. */
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/lib/format.d.ts

@@ -0,0 +1,48 @@
+/** Compact relative time: "now", "42s", "7m", "3h", "2d", then a date. */
+export declare function formatRelativeTime(iso: string, now?: Date): string;
+/** Human-readable byte size: "512 B", "8.0 KB", "1.4 MB", "3 GB". */
+export declare function formatBytes(bytes: number): string;
+/** Single-line preview of arbitrary text, for tiles and collapsed rows. */
+export declare function truncate(text: string, maxLength: number): string;
+/** Render an unknown payload as readable text (pretty JSON when possible). */
+export declare function stringifyPayload(value: unknown): string;
+/** JSON.parse that returns `undefined` instead of throwing. */
+export declare function tryParseJson(text: string): unknown;
+/**
+ * The canonical credit-death sentence. Credit exhaustion is the one failure a
+ * user can fix themselves — the copy must say what happened (empty balance),
+ * what to do (add credits), and what is safe (nothing was lost). Crucially it
+ * must NOT say "send a message to revive": a revive turn burns credits the
+ * workspace no longer has.
+ */
+export declare const CREDIT_EXHAUSTION_MESSAGE = "Out of OpenGeni credits \u2014 this workspace's balance is empty. Add credits to continue; the conversation is preserved.";
+/**
+ * Actionable composer copy for an edge rejection before a turn is accepted.
+ * Unlike an in-flight credit exhaustion, this path has not consumed the
+ * actor-private draft or any finalized attachment.
+ */
+export declare const COMPOSER_PAYMENT_REQUIRED_MESSAGE = "This turn requires OpenGeni managed credits, but the account balance is empty. Add credits or choose a connected Codex subscription model, then retry. Your draft and attachments are preserved.";
+export declare function composerSubmissionErrorMessage(error: Error): string;
+/**
+ * Does this failure/completion payload (or raw error string) mean the
+ * workspace ran out of OpenGeni credits? Matches the engine's
+ * "insufficient OpenGeni credits" text (case-insensitive, substring — it
+ * arrives both bare and wrapped in "Activity task failed: …") and the
+ * budget-exhausted segment limit the engine stamps on a turn it ended early.
+ */
+export declare function isCreditExhaustion(input: {
+    error?: string | null;
+    detail?: string | null;
+    segmentLimit?: string | null;
+} | string): boolean;
+/**
+ * Humanize engine/provider failure text before it reaches the timeline or a
+ * failure banner. Raw provider errors leak the wrong audience's instructions —
+ * "Incorrect API key … find your API key at platform.openai.com" tells a
+ * managed-deployment USER to fix credentials only an OPERATOR controls (and is
+ * flatly wrong for Azure or subscription-backed engines). Auth, quota, and
+ * credit-exhaustion failures collapse to one neutral, honest sentence; every
+ * other reason passes through untouched. Raw payloads stay available in the
+ * debug surfaces.
+ */
+export declare function humanizeFailureReason(reason: string | null): string | null;

package/dist/lib/git-patch.d.ts

@@ -0,0 +1,8 @@
+import type { GitFileDiff } from "@opengeni/sdk";
+/**
+ * Reconstruct a unified-diff patch string for a single `GitFileDiff` so it can
+ * be fed to a generic patch renderer (e.g. Pierre's `PatchDiff`). The hook
+ * already carries per-line old/new numbers and a hunk header, so we emit a
+ * conventional `--- / +++ / @@` patch the parser understands.
+ */
+export declare function gitFileDiffToPatch(file: GitFileDiff): string;

package/dist/lib/motion-inspect.d.ts

@@ -0,0 +1,5 @@
+/**
+ * TEMP eyeball scale for vertical motion (tip-follow, settle fold, CSS).
+ * Set back to `1` before landing — not a product knob.
+ */
+export declare const MOTION_INSPECT_SCALE = 1;

package/dist/lib/motion.d.ts

@@ -0,0 +1,14 @@
+export declare function prefersReducedMotion(): boolean;
+/** Test seam: forget the cached MediaQueryList so a stubbed matchMedia applies. */
+export declare function resetReducedMotionCache(): void;
+/** Active VT type for markdown crystallize — scoped CSS, not a full-page blink. */
+export declare const MARKDOWN_CRYSTALLIZE_VT_TYPE = "og-md-crystallize";
+/**
+ * Run a DOM update inside the browser View Transition API when available.
+ * Snapshots the before/after paint and cross-fades (or custom CSS morphs)
+ * between them — the platform "morph" primitive React's experimental
+ * `<ViewTransition>` wraps. Falls back to a synchronous update.
+ */
+export declare function runViewTransition(update: () => void, options?: {
+    types?: string[];
+}): void;

package/dist/lib/noto-sans-arabic-loader.d.ts

@@ -0,0 +1 @@
+export declare function loadNotoSansArabic(): Promise<void>;

package/dist/lib/noto-sans-jp-loader.generated.d.ts

@@ -0,0 +1 @@
+export declare function loadNotoSansJp(text: string): Promise<void>;

package/dist/lib/relay-wire.d.ts

@@ -0,0 +1,30 @@
+/** `StreamKind.STREAM_KIND_DESKTOP` (agent-proto enum value). */
+export declare const STREAM_KIND_DESKTOP = 2;
+/** `StreamRole.STREAM_ROLE_CLIENT` (agent-proto enum value). */
+export declare const STREAM_ROLE_CLIENT = 2;
+export interface RelayChannel {
+    channelId: string;
+    workspaceId: string;
+    agentId: string;
+    kind: number;
+    port: number;
+}
+export interface RelayStreamOpen {
+    channel: RelayChannel;
+    token: string;
+    role: number;
+    resumeFromSeq: string;
+}
+/** Encode a `StreamOpen`, byte-compatible with `StreamOpen.encode(...).finish()`. */
+export declare function encodeStreamOpen(message: RelayStreamOpen): Uint8Array;
+/** Decode a `StreamOpenAck` (we need `accepted` + the error message). */
+export declare function decodeStreamOpenAck(bytes: Uint8Array): {
+    accepted: boolean;
+    error?: {
+        message?: string;
+    };
+};
+/** Decode a `StreamFrame`, extracting only the `data` (framebuffer PNG) bytes. */
+export declare function decodeStreamFrame(bytes: Uint8Array): {
+    data: Uint8Array;
+};

package/dist/lib/use-portal-token-style.d.ts

@@ -0,0 +1,9 @@
+import { type CSSProperties, type RefObject } from "react";
+export type PortalTokenStyle = CSSProperties & Record<`--${string}`, string>;
+/**
+ * Copy the effective SDK tokens across a portal boundary. A locally themed or
+ * rebranded embed cannot rely on CSS inheritance once a portal mounts under
+ * `<body>`. Ancestor theme/class/style mutations and OS color-scheme changes
+ * keep the copied values live.
+ */
+export declare function usePortalTokenStyle(sourceRef: RefObject<HTMLElement | null>): PortalTokenStyle;

package/dist/lib/use-theme-type.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Resolve the diff theme. An explicit `forced` value wins; otherwise auto-detect
+ * from the host `data-og-theme` (defaulting to dark) and track live flips.
+ */
+export declare function useThemeType(forced: "dark" | "light" | undefined): "dark" | "light";

package/dist/lib/use-unicode-fonts.d.ts

@@ -0,0 +1,12 @@
+export type UnicodeFontNeeds = {
+    japanese: boolean;
+    arabic: boolean;
+};
+export declare function detectUnicodeFontNeeds(values: Iterable<string>): UnicodeFontNeeds;
+/**
+ * Load large script-specific font manifests only when visible workspace content
+ * needs them. Fontsource splits the actual glyphs by unicode-range, so Chromium
+ * then fetches only the small shards used by the path instead of charging every
+ * Latin-only session for the complete font.
+ */
+export declare function useUnicodeFallbackFonts(values: readonly string[]): void;

package/dist/lib/xterm-renderer.d.ts

@@ -0,0 +1,19 @@
+export type RendererTier = "webgl" | "canvas" | "dom";
+export type RendererAddon = {
+    dispose: () => void;
+};
+/** A loader constructs + `loadAddon`s its renderer, wiring `onLoss` to the
+ *  addon's context-loss event, and throws if the renderer can't initialize. */
+export type RendererLoaders = {
+    webgl?: ((onLoss: () => void) => Promise<RendererAddon>) | undefined;
+    canvas?: (() => Promise<RendererAddon>) | undefined;
+};
+/** The next lower renderer tier, or null at the bottom (DOM). Pure. */
+export declare function nextRendererTier(tier: RendererTier): RendererTier | null;
+/**
+ * Attach the highest renderer tier at or below `prefer` that initializes,
+ * reporting the settled tier via `onTier`. On a WebGL/canvas context loss the
+ * loader's `onLoss` re-enters at the next tier down, so `onTier` is called again
+ * with the downgraded tier. Returns the tier chosen on this pass.
+ */
+export declare function attachRenderer(prefer: RendererTier, loaders: RendererLoaders, onTier: (tier: RendererTier) => void): Promise<RendererTier>;

package/dist/lib/xterm-theme.d.ts

@@ -0,0 +1,75 @@
+import type { XtermTheme } from "../components/sandbox-terminal";
+export type ThemeMode = "dark" | "light";
+/** Reads a resolved token value (already `getComputedStyle`-flattened). */
+export type TokenReader = (name: string) => string | undefined;
+/**
+ * The 16 ANSI colors + selection/cursor treatment, designed against the og
+ * OKLCH palette. Hues are borrowed from the og status ramp so terminal color
+ * reads as part of the same system: red≈status-failed(22), green≈status-idle
+ * (155), yellow≈status-running(80), blue≈accent(255), magenta≈status-waiting
+ * (305), cyan≈200. Dark uses lifted lightness on the dark slate ground; light
+ * uses deeper, more saturated inks on the near-white ground. Bright variants
+ * add lightness + a touch of chroma. `black`/`white` are neutral slate ramp
+ * stops (never pure #000/#fff — that clashes with the calm neutral ground).
+ */
+export type AnsiPalette = {
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    brightBlack: string;
+    brightRed: string;
+    brightGreen: string;
+    brightYellow: string;
+    brightBlue: string;
+    brightMagenta: string;
+    brightCyan: string;
+    brightWhite: string;
+    /** Selection wash + its foreground; sits over the terminal ground. */
+    selectionBackground: string;
+    selectionForeground: string;
+    selectionInactiveBackground: string;
+};
+/** The designed ANSI-16 palette for a theme mode. Pure. */
+export declare function ogAnsiPalette(mode: ThemeMode): AnsiPalette;
+/**
+ * Build a COMPLETE xterm ITheme from token values. Background/foreground/cursor
+ * come from the live `--og-*` tokens (so an embedder's rebrand flows through);
+ * the ANSI-16 + selection come from the designed palette for `mode`. Every ANSI
+ * slot is always set — xterm never falls back to its stock VGA colors. Pure.
+ */
+export declare function buildXtermTheme(read: TokenReader, mode: ThemeMode): XtermTheme;
+/**
+ * Derive a COMPLETE xterm `ITheme` from the live `--og-*` token system on the
+ * DOM. Reads the COMPUTED values so xterm gets concrete colors, detects the
+ * active theme mode, and fills every ANSI slot. Call on mount + re-derive on a
+ * `data-og-theme` flip. SSR-safe: returns undefined off the DOM.
+ *
+ * `root` should be an element INSIDE the themed subtree (e.g. the terminal
+ * container) so nested `[data-og-theme]` themes resolve correctly; when omitted
+ * it falls back to the nearest `[data-og-theme]` element, then documentElement.
+ */
+export declare function xtermThemeFromTokens(root?: HTMLElement | null): XtermTheme | undefined;
+export type ResolvedTerminalFont = {
+    fontFamily: string;
+    fontSize: number;
+    lineHeight: number;
+};
+export type FontOverrides = {
+    fontFamily?: string | undefined;
+    fontSize?: number | undefined;
+};
+/**
+ * Resolve xterm's font from token values. The critical bug this fixes:
+ * `fontFamily: "var(--og-font-mono)"` is measured by xterm via a canvas font
+ * string where `var()` does NOT resolve, so xterm silently mis-measures every
+ * glyph. Here the family is a CONCRETE stack; a `var(` in the input is treated
+ * as unresolved and replaced with the fallback. Pure over a token `read`.
+ */
+export declare function resolveTerminalFontFromReader(read: TokenReader, overrides?: FontOverrides): ResolvedTerminalFont;
+/** DOM wrapper: resolve the terminal font from an element's computed tokens. */
+export declare function resolveTerminalFont(el: HTMLElement, overrides?: FontOverrides): ResolvedTerminalFont;