@xemahq/ui-kernel 0.10.0 → 0.11.0

package/src/vista/surfaces/blob-surfaces.tsx

@@ -29,7 +29,9 @@ function BlobBody({
   payload: VistaBlobPayload;
   render: (url: string) => ReactNode;
 }>): ReactElement {
-  if (payload.url !== undefined) return <>{render(payload.url)}</>;
+  if (payload.url !== undefined) {
+    return <>{render(payload.url)}</>;
+  }
   // `validateBlobPayload` guarantees exactly one of url/path.
   return <VistaFileUrl path={payload.path as string} render={render} />;
 }
@@ -51,7 +53,11 @@ export function ImageSurface(payload: VistaBlobPayload): ReactElement {
           <img
             src={url}
             alt={payload.alt ?? 'Preview'}
-            style={{ maxWidth: '100%', maxHeight: '100%', objectFit: 'contain' }}
+            style={{
+              maxWidth: '100%',
+              maxHeight: '100%',
+              objectFit: 'contain',
+            }}
           />
         </div>
       )}
@@ -113,7 +119,11 @@ export function MediaSurface(payload: VistaBlobPayload): ReactElement {
         >
           {isAudio ? (
             // eslint-disable-next-line jsx-a11y/media-has-caption
-            <audio src={url} controls style={{ width: '100%', maxWidth: 520 }} />
+            <audio
+              src={url}
+              controls
+              style={{ width: '100%', maxWidth: 520 }}
+            />
           ) : (
             // eslint-disable-next-line jsx-a11y/media-has-caption
             <video

package/src/vista/surfaces/elicitation-transport.ts

@@ -66,7 +66,9 @@ function asRecord(value: unknown): UnknownRecord | null {
  */
 function unwrapEnvelope(body: unknown): UnknownRecord | null {
   const record = asRecord(body);
-  if (record === null) return null;
+  if (record === null) {
+    return null;
+  }
   const inner = asRecord(record.data);
   return inner ?? record;
 }
@@ -82,14 +84,20 @@ export function extractServiceMessage(body: unknown, status: number): string {
     record === null
       ? undefined
       : (record.message ?? asRecord(record.error)?.message ?? record.error);
-  if (typeof candidate === 'string' && candidate.length > 0) return candidate;
+  if (typeof candidate === 'string' && candidate.length > 0) {
+    return candidate;
+  }
   if (Array.isArray(candidate)) {
     const joined = candidate
       .filter((m): m is string => typeof m === 'string')
       .join(' ');
-    if (joined.length > 0) return joined;
+    if (joined.length > 0) {
+      return joined;
+    }
+  }
+  if (typeof body === 'string' && body.length > 0) {
+    return body;
   }
-  if (typeof body === 'string' && body.length > 0) return body;
   return `The service rejected the submission (HTTP ${status}).`;
 }
 
@@ -112,11 +120,15 @@ async function readBody(response: Response): Promise<unknown> {
  */
 function toOutcome(body: unknown, ref: string): VistaFormOutcome | null {
   const record = unwrapEnvelope(body);
-  if (record === null) return null;
+  if (record === null) {
+    return null;
+  }
   const submitted =
     record.submitted === true ||
     (typeof record.status === 'string' && record.status === 'submitted');
-  if (!submitted) return null;
+  if (!submitted) {
+    return null;
+  }
   const connectionId =
     typeof record.connectionId === 'string' && record.connectionId.length > 0
       ? record.connectionId
@@ -133,7 +145,9 @@ function authHeaders(
     Authorization: `Bearer ${accessToken}`,
     Accept: 'application/json',
   };
-  if (json) headers['Content-Type'] = 'application/json';
+  if (json) {
+    headers['Content-Type'] = 'application/json';
+  }
   return headers;
 }
 

package/src/vista/surfaces/file-surface-utils.ts

@@ -37,8 +37,12 @@ export interface VistaFileGroup {
 }
 
 function compareDirs(a: string, b: string): number {
-  if (a === '') return -1;
-  if (b === '') return 1;
+  if (a === '') {
+    return -1;
+  }
+  if (b === '') {
+    return 1;
+  }
   return a.localeCompare(b);
 }
 
@@ -50,8 +54,11 @@ export function groupFilesByFolder(
     const slash = file.path.lastIndexOf('/');
     const dir = slash < 0 ? '' : file.path.slice(0, slash);
     const bucket = groups.get(dir);
-    if (bucket) bucket.push(file);
-    else groups.set(dir, [file]);
+    if (bucket) {
+      bucket.push(file);
+    } else {
+      groups.set(dir, [file]);
+    }
   }
   return [...groups.keys()].sort(compareDirs).map((dir) => ({
     dir,

package/src/vista/surfaces/register-surfaces.tsx

@@ -60,7 +60,9 @@ import {
  */
 function validateMediaPayload(raw: unknown): VistaBlobPayload | null {
   const payload = validateBlobPayload(raw);
-  if (payload === null) return null;
+  if (payload === null) {
+    return null;
+  }
   return payload.contentType === undefined ? null : payload;
 }
 

package/src/vista/surfaces/text-surfaces.tsx

@@ -35,7 +35,9 @@ function TextBody({
   payload: VistaTextPayload;
   render: (content: string) => ReactNode;
 }>): ReactElement {
-  if (payload.content !== undefined) return <>{render(payload.content)}</>;
+  if (payload.content !== undefined) {
+    return <>{render(payload.content)}</>;
+  }
   // `validateTextPayload` guarantees exactly one of content/path.
   return <VistaFileText path={payload.path as string} render={render} />;
 }
@@ -73,10 +75,13 @@ export function CodeSurface(payload: VistaTextPayload): ReactElement {
  * parses and shown VERBATIM when it does not (a malformed JSON file is shown as
  * it is, never swallowed).
  */
-export function JsonSurface({ data }: Readonly<{ data: unknown }>): ReactElement {
+export function JsonSurface({
+  data,
+}: Readonly<{ data: unknown }>): ReactElement {
   let text: string;
   try {
-    text = JSON.stringify(data, null, 2) ?? String(data);
+    const serialized: unknown = JSON.stringify(data, null, 2);
+    text = typeof serialized === 'string' ? serialized : String(data);
   } catch {
     text = String(data);
   }
@@ -89,10 +94,18 @@ export function JsonSurface({ data }: Readonly<{ data: unknown }>): ReactElement
 
 /** Colour a unified-diff line by its leading marker. */
 function diffLineColor(line: string): string | undefined {
-  if (line.startsWith('+++') || line.startsWith('---')) return 'hsl(var(--ink-3))';
-  if (line.startsWith('@@')) return 'hsl(var(--info))';
-  if (line.startsWith('+')) return 'hsl(var(--success))';
-  if (line.startsWith('-')) return 'hsl(var(--destructive, var(--danger)))';
+  if (line.startsWith('+++') || line.startsWith('---')) {
+    return 'hsl(var(--ink-3))';
+  }
+  if (line.startsWith('@@')) {
+    return 'hsl(var(--info))';
+  }
+  if (line.startsWith('+')) {
+    return 'hsl(var(--success))';
+  }
+  if (line.startsWith('-')) {
+    return 'hsl(var(--destructive, var(--danger)))';
+  }
   return undefined;
 }
 
@@ -105,7 +118,7 @@ export function DiffSurface(payload: VistaTextPayload): ReactElement {
           {content.split('\n').map((line, index) => (
             <div
               // A diff has no stable per-line identity other than its position.
-               
+
               key={index}
               style={{ color: diffLineColor(line) }}
             >

package/src/vista/use-vista-tabs.ts

@@ -128,14 +128,18 @@ export function useVistaTabs({
   activeRef.current = activeTabId;
 
   const activate = useCallback((tabId: string): void => {
-    if (!tabsRef.current.some((t) => t.tabId === tabId)) return;
+    if (!tabsRef.current.some((t) => t.tabId === tabId)) {
+      return;
+    }
     setActiveTabId(tabId);
   }, []);
 
   const open = useCallback((surface: VistaTab): string => {
     setOpenedTabs((prev) => {
       const index = prev.findIndex((t) => t.tabId === surface.tabId);
-      if (index === -1) return [...prev, surface];
+      if (index === -1) {
+        return [...prev, surface];
+      }
       // Re-opening the same tabId REPLACES it (the `VistaSurface` contract).
       const next = [...prev];
       next[index] = surface;
@@ -153,7 +157,9 @@ export function useVistaTabs({
       // overwritten on the next reconcile, so it is REFUSED rather than
       // silently lost. Ownership is decided synchronously from the ref, not
       // inside the state updater (which React may invoke twice).
-      if (!openedTabsRef.current.some((t) => t.tabId === tabId)) return false;
+      if (!openedTabsRef.current.some((t) => t.tabId === tabId)) {
+        return false;
+      }
       setOpenedTabs((prev) =>
         prev.map((tab) => (tab.tabId === tabId ? { ...tab, ...patch } : tab)),
       );
@@ -164,7 +170,9 @@ export function useVistaTabs({
 
   const close = useCallback((tabId: string): boolean => {
     const tab = tabsRef.current.find((t) => t.tabId === tabId);
-    if (tab === undefined || tab.pinned === true) return false;
+    if (tab === undefined || tab.pinned === true) {
+      return false;
+    }
     setOpenedTabs((prev) => prev.filter((t) => t.tabId !== tabId));
     setClosedHostTabIds((prev) =>
       prev.includes(tabId) ? prev : [...prev, tabId],

package/src/vista/vista-code-renderer.tsx

@@ -13,10 +13,8 @@
  * pane is the intended rendering, and with a provider the host's renderer is
  * the intended rendering. Neither is an error path.
  */
-import {
-  type ReactElement,
-  type ReactNode,
-} from 'react';
+import { type ReactElement, type ReactNode } from 'react';
+
 import {
   VistaCodeRendererContext,
   type VistaCodeRenderer,
@@ -25,7 +23,10 @@ import {
 export function VistaCodeRendererProvider({
   renderer,
   children,
-}: Readonly<{ renderer: VistaCodeRenderer; children: ReactNode }>): ReactElement {
+}: Readonly<{
+  renderer: VistaCodeRenderer;
+  children: ReactNode;
+}>): ReactElement {
   return (
     <VistaCodeRendererContext.Provider value={renderer}>
       {children}

package/src/vista/vista-file-source.tsx

@@ -12,12 +12,8 @@
  * provider renders a visible error, never a blank pane and never a silent
  * "content unavailable".
  */
-import {
-  useEffect,
-  useState,
-  type ReactElement,
-  type ReactNode,
-} from 'react';
+import { useEffect, useState, type ReactElement, type ReactNode } from 'react';
+
 import {
   VistaFileSourceContext,
   useVistaFileSource,
@@ -43,10 +39,7 @@ type LoadState =
 
 const LOADING: LoadState = { status: 'loading' };
 
-function useResolvedFile(
-  path: string,
-  mode: 'text' | 'url',
-): LoadState {
+function useResolvedFile(path: string, mode: 'text' | 'url'): LoadState {
   const source = useVistaFileSource();
   const revision = source?.revision;
   const [state, setState] = useState<LoadState>(LOADING);
@@ -66,10 +59,14 @@ function useResolvedFile(
       mode === 'text' ? source.readText(path) : source.resolveUrl(path);
     promise.then(
       (value) => {
-        if (!cancelled) setState({ status: 'ready', value });
+        if (!cancelled) {
+          setState({ status: 'ready', value });
+        }
       },
       (error: unknown) => {
-        if (cancelled) return;
+        if (cancelled) {
+          return;
+        }
         setState({
           status: 'error',
           message: error instanceof Error ? error.message : String(error),
@@ -122,7 +119,9 @@ export function VistaFileText({
   render: (content: string) => ReactNode;
 }>): ReactElement {
   const state = useResolvedFile(path, 'text');
-  if (state.status !== 'ready') return <LoadNotice state={state} />;
+  if (state.status !== 'ready') {
+    return <LoadNotice state={state} />;
+  }
   return <>{render(state.value)}</>;
 }
 
@@ -135,6 +134,8 @@ export function VistaFileUrl({
   render: (url: string) => ReactNode;
 }>): ReactElement {
   const state = useResolvedFile(path, 'url');
-  if (state.status !== 'ready') return <LoadNotice state={state} />;
+  if (state.status !== 'ready') {
+    return <LoadNotice state={state} />;
+  }
   return <>{render(state.value)}</>;
 }

package/src/vista/vista-form-host.tsx

@@ -26,14 +26,9 @@
  * provider renders a visible refusal and cannot submit. Fail-closed — a form
  * that silently posts nowhere would be worse than one that says it cannot.
  */
-import {
-  type ReactElement,
-  type ReactNode,
-} from 'react';
-import {
-  VistaFormHostContext,
-  type VistaFormHost,
-} from './vista-form-context';
+import { type ReactElement, type ReactNode } from 'react';
+
+import { VistaFormHostContext, type VistaFormHost } from './vista-form-context';
 
 /**
  * Everything a settled elicitation reports. Closed, scalar-only, and

package/src/vista/vista-model.ts

@@ -22,7 +22,10 @@
  *     `<biomeId>:tests` kind rather than a first-party one. Nothing in the tree
  *     rendered it (the thin workspace's `renderTests` slot was never supplied).
  */
-import { SurfaceKind, type VistaSurface } from '@xemahq/kernel-contracts/surface';
+import {
+  SurfaceKind,
+  type VistaSurface,
+} from '@xemahq/kernel-contracts/surface';
 
 /**
  * Id of the pinned, UI-owned file-browser tab. It is owned by the panel, never
@@ -74,7 +77,9 @@ const EXTENSION_KIND: Readonly<Record<string, SurfaceKind>> = {
  */
 export function surfaceKindForPath(path: string): SurfaceKind {
   const dot = path.lastIndexOf('.');
-  if (dot === -1) return SurfaceKind.Code;
+  if (dot === -1) {
+    return SurfaceKind.Code;
+  }
   const ext = path.slice(dot + 1).toLowerCase();
   return EXTENSION_KIND[ext] ?? SurfaceKind.Code;
 }
@@ -101,7 +106,9 @@ const EXTENSION_CONTENT_TYPE: Readonly<Record<string, string>> = {
 /** Content type for a path, or `null` when the extension is unknown. */
 export function contentTypeForPath(path: string): string | null {
   const dot = path.lastIndexOf('.');
-  if (dot === -1) return null;
+  if (dot === -1) {
+    return null;
+  }
   return EXTENSION_CONTENT_TYPE[path.slice(dot + 1).toLowerCase()] ?? null;
 }
 

package/src/vista/vista-open-context.tsx

@@ -11,14 +11,9 @@
  * (`useVistaOpen()` returns `null`) — an inert list, never a dead click that
  * silently does nothing.
  */
-import {
-  type ReactElement,
-  type ReactNode,
-} from 'react';
-import {
-  VistaOpenContext,
-  type VistaOpenFn,
-} from './vista-open-state';
+import { type ReactElement, type ReactNode } from 'react';
+
+import { VistaOpenContext, type VistaOpenFn } from './vista-open-state';
 
 export function VistaOpenProvider({
   open,