@tai42/studio-sdk 6.1.1 → 7.0.0

package/dist/schema-form/validate.js

@@ -1,8 +1,8 @@
 /**
  * `validateAgainstSchema` — a loud, structured pre-submit check. It walks the
  * schema against a value and returns a path-keyed `SchemaFormErrors` bag:
- * required-presence, type/format mismatches, enum/const violations, and any
- * `unsupported` construct (surfaced, never hidden). It never throws on a
+ * required-presence, type/format mismatches, enum/const violations, and the
+ * container constraint on a free-form `json` field. It never throws on a
  * malformed value — a malformed value IS the error it reports.
  */
 import { classifySchema } from './classify';
@@ -52,8 +52,15 @@ function walk(schema, value, path, root, errors, maxUploadBytes) {
     }
     const { model } = classified;
     switch (model.kind) {
-        case 'unsupported':
-            errors[path] = `unsupported schema (${model.reason})`;
+        case 'json':
+            // A free-form JSON field: any JSON is accepted, subject only to the
+            // container the schema commits to (mirrors the renderer's inline check).
+            if (model.jsonType === 'object' && !isPlainObject(value)) {
+                errors[path] = 'must be a JSON object';
+            }
+            else if (model.jsonType === 'array' && !Array.isArray(value)) {
+                errors[path] = 'must be a JSON array';
+            }
             return;
         case 'const':
             if (value !== model.value)

package/dist/schema-form/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/schema-form/validate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/schema-form/validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/studio-sdk",
-  "version": "6.1.1",
+  "version": "7.0.0",
   "description": "The Studio plugin contract, shared UI components, and hooks that every feature builds on.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",
@@ -90,7 +90,7 @@
     "@radix-ui/react-select": "^2.3.2",
     "@radix-ui/react-tabs": "^1.1.16",
     "@radix-ui/react-tooltip": "^1.2.11",
-    "@tai42/api-client": "6.1.1"
+    "@tai42/api-client": "7.0.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json && node scripts/copy-assets.mjs",

package/src/components/completion-input.tsx

@@ -30,10 +30,27 @@ export interface CompletionInputProps {
 const wrapStyle: CSSProperties = { position: 'relative' };
 
 /**
- * The popup sits directly under the field rather than against its top edge. It
- * is a `<ul>`, so it also drops the marker a host without a CSS reset would draw.
+ * The popup FLOATS below the field: absolutely positioned within the
+ * `position: relative` wrapper (`top: 100%` = the field's bottom edge, stretched
+ * `left`/`right` to the field's width) so it is taken OUT OF FLOW — it neither
+ * displaces the content below the field nor gets laid out inside it. Its stacking
+ * comes from `tai-select-content`'s `--tai-z-popover` z-index, which was inert
+ * while the list was in-flow (z-index needs a positioned box) and is exactly what
+ * this `position` now activates, so the list clears a sibling control it overlaps.
+ *
+ * Absolute-in-wrapper rather than a portal on purpose: this is an inline form
+ * control (a `SchemaForm` string field). A portal would need anchor-rect popper
+ * plumbing, and it buys nothing here — the wrapper is a plain flow box, so the
+ * only container that could clip the list is a scrollable ancestor (e.g. the
+ * `Dialog` body), where an absolute list simply extends that ancestor's scroll
+ * area instead of being cut off. It is still a `<ul>`, so it also drops the marker
+ * a host without a CSS reset would draw.
  */
 const listStyle: CSSProperties = {
+  position: 'absolute',
+  top: '100%',
+  left: 0,
+  right: 0,
   marginTop: 'var(--tai-space-1)',
   marginBottom: 0,
   listStyle: 'none',

package/src/components/components.css

@@ -533,8 +533,9 @@
      clears the dialog scrim that would otherwise cover and swallow it. The
      height cap yields to the space the popper actually has, so a long list in a
      short viewport still scrolls inside the screen; the fallback covers the
-     in-flow suggestion list, which wears these classes without a popper to
-     publish that measurement. */
+     completion suggestion list, which wears these classes without a Radix popper
+     to publish that measurement (it floats via its own absolute position, not a
+     popper — see `completion-input.tsx`). */
   .tai-select-content {
     z-index: var(--tai-z-popover);
     /* Capped against the VIEWPORT as well as its own content, like every other
@@ -545,7 +546,7 @@
     overflow-y: auto;
     /* The cap is on the BORDER box, or it is not a cap at all: with the default
        `content-box` the side padding and the 1 px boundary sit outside it. Radix
-       inline-styles `box-sizing: border-box` on its own popper, but the in-flow
+       inline-styles `box-sizing: border-box` on its own popper, but the completion
        suggestion list wears this class as a plain `<ul>` with no Radix near it. */
     box-sizing: border-box;
     background: var(--tai-color-surface-raised);

package/src/components/explorer-view.tsx

@@ -12,12 +12,13 @@
  * {@link matchesSelectedTags}, {@link UNTAGGED_TOKEN}) so every consuming screen
  * shares one vocabulary/untagged-sentinel/OR-match rule rather than copying it.
  */
-import { useCallback, useEffect, useState, type MouseEvent, type ReactNode } from 'react';
+import { useCallback, useEffect, useState, type ReactNode } from 'react';
 
 import { EntityCardGrid } from './entity-card-grid';
 import { childFolders, FolderBreadcrumb, FolderRow, type Folder } from './folder-nav';
 import { SearchIcon } from './icons';
 import { TextInput } from './inputs';
+import { openTargetProps, type OpenTargetProps } from './open-target';
 import { Button, Card, EmptyState } from './primitives';
 import { ScrollRegion } from './scroll-region';
 import { Select } from './select';
@@ -373,32 +374,20 @@ export function ExplorerView<T>({
     tags.onChange(next);
   };
 
-  // The pointer-open props for one item's row/card, present only when `onOpenItem`
-  // is set. The handler yields to any nested interactive element the click landed
-  // on (a name link, an actions kebab) so it never hijacks its activation; a
-  // portalled menu (Radix) never bubbles here, so the role selectors are defensive
-  // for an inline menu only.
-  const openProps = (
-    item: T,
-  ): { onClick?: (event: MouseEvent<HTMLElement>) => void; style?: { cursor: 'pointer' } } => {
-    if (onOpenItem === undefined) return {};
-    return {
-      onClick: (event) => {
-        // A press-drag that selects the name text also fires a click; that is a
-        // selection, not an open intent.
-        if (window.getSelection()?.isCollapsed === false) return;
-        const target = event.target;
-        if (
-          target instanceof Element &&
-          target.closest('button, a, [role="menu"], [role="menuitem"]') !== null
-        ) {
-          return;
-        }
-        onOpenItem(item);
-      },
-      style: { cursor: 'pointer' },
-    };
-  };
+  // The pointer-open props for one item's row/card, via the shared house pattern
+  // ({@link openTargetProps}): present only when `onOpenItem` is set, it yields to
+  // the item's own nested interactive elements (its name link, an actions kebab)
+  // and to a text-selection drag. The accessible activation path stays that nested
+  // name link, so no `keyboard` here — the row is never itself a focus stop.
+  const openProps = (item: T): OpenTargetProps =>
+    openTargetProps({
+      onOpen:
+        onOpenItem === undefined
+          ? undefined
+          : () => {
+              onOpenItem(item);
+            },
+    });
 
   const hasEntries = subfolders.length > 0 || filtered.length > 0;
 

package/src/components/field.tsx

@@ -91,6 +91,19 @@ export interface FieldProps {
    * `group`.
    */
   readonly group?: boolean;
+  /**
+   * Render the label for ASSISTIVE TECH ONLY — visually hidden, but still the
+   * control's accessible name through the very same `<label for>` (or, in a group,
+   * the same `aria-labelledby`). The label element stays in the DOM behind
+   * `tai-visually-hidden`, so nothing about the accessible name changes; only its
+   * paint is dropped. It is the standard idiom for a dense grid of otherwise
+   * identical fields, where each row needs a UNIQUE, addressable name (a
+   * voice-control user can only say a name that exists) but there is no room for a
+   * visible label on every row — the same trade `RadioGroup`'s `visuallyHiddenLabel`
+   * and `ViewToggle` make. The label text still governs WCAG 2.5.3 (Label in Name),
+   * so a caller passes the real per-row name as `label`, not a decoration.
+   */
+  readonly hideLabel?: boolean;
 }
 
 export function Field({
@@ -101,6 +114,7 @@ export function Field({
   style,
   className,
   group = false,
+  hideLabel = false,
 }: FieldProps) {
   const controlId = useId();
   const labelId = `${controlId}-label`;
@@ -122,6 +136,10 @@ export function Field({
     ? { controlId: undefined, describedBy: undefined, invalid: error !== undefined }
     : { controlId, describedBy, invalid: error !== undefined };
 
+  // The label keeps its `htmlFor`/`id` wiring either way — `hideLabel` only drops
+  // its PAINT, so the accessible name it gives the control is unchanged.
+  const labelClassName = hideLabel ? 'tai-field-label tai-visually-hidden' : 'tai-field-label';
+
   return (
     <FieldContext.Provider value={value}>
       <div
@@ -129,11 +147,11 @@ export function Field({
         style={style}
       >
         {group ? (
-          <span id={labelId} className="tai-field-label">
+          <span id={labelId} className={labelClassName}>
             {label}
           </span>
         ) : (
-          <label id={labelId} htmlFor={controlId} className="tai-field-label">
+          <label id={labelId} htmlFor={controlId} className={labelClassName}>
             {label}
           </label>
         )}

package/src/components/open-target.ts

@@ -0,0 +1,121 @@
+/**
+ * `openTargetProps` — the ONE house pattern for a whole-row / whole-card "open"
+ * affordance.
+ *
+ * A navigable list entry (a table `<TR>`, a card `<div role="listitem">`) has a
+ * single natural destination: opening it. The industry-standard affordance is to
+ * make the WHOLE entry the click target — not only the name link buried in its
+ * first cell — while never HIJACKING the interactive elements nested inside it
+ * (the name link itself, an actions kebab, a Run button, an expandable preview).
+ * This helper is that affordance, extracted once so every surface spreads the
+ * same object rather than hand-rolling — and subtly diverging on — the yield
+ * rules.
+ *
+ * The contract, spread onto the entry element:
+ *  - `cursor: pointer`, so the whole entry reads as activatable.
+ *  - a click handler that opens the entry, EXCEPT when the click
+ *      • landed on (or inside) a nested interactive element — a `button`, an
+ *        `a`, or an inline `[role="menu"]`/`[role="menuitem"]` — which owns its
+ *        own activation, or
+ *      • is the tail of a press-drag that SELECTED text (a non-collapsed
+ *        selection), which is a read gesture, not an open intent.
+ *  - with `keyboard`, `tabIndex: 0` and an Enter/Space handler under the same
+ *    yield rules, so the entry is operable without a pointer.
+ *
+ * Keyboard note: PREFER giving the entry a real nested interactive element (the
+ * name `AppLink`) as its accessible activation path and leaving `keyboard` off —
+ * the helper yields to that element, so it stays the one keyboard/AT target and
+ * the whole-entry click is a pure pointer convenience layered over it. Reach for
+ * `keyboard` only when the entry genuinely has no such nested control (a run row
+ * of timestamps and badges), where the entry itself must become the focus stop.
+ *
+ * Dependency-free: it reads only the DOM `event.target`, `window.getSelection()`,
+ * and returns plain React attributes — nothing to bundle, nothing to mock.
+ */
+import type { KeyboardEvent, MouseEvent } from 'react';
+
+/** The nested interactive elements a whole-target open always yields to: a click
+ *  or key that originates on one of these (or a descendant, e.g. an icon `<svg>`
+ *  inside a button) is that element's own activation, never an open of the entry.
+ *  The menu roles cover an INLINE menu; a portalled menu (Radix) never bubbles to
+ *  the entry, so it needs no selector here. */
+const NESTED_INTERACTIVE = 'button, a, [role="menu"], [role="menuitem"]';
+
+export interface OpenTargetOptions {
+  /** Open the entry. `undefined` disables the affordance entirely — the helper
+   *  returns empty props so the element stays inert (no cursor, no handlers),
+   *  which lets a caller wire the whole thing behind an optional prop. */
+  readonly onOpen: (() => void) | undefined;
+  /** Extra selector(s) that also count as "nested interactive" for THIS surface,
+   *  merged with the built-in set. Use it for a marked non-`button`/`a` subtree
+   *  that owns its own clicks (e.g. an expandable preview keyed by a data
+   *  attribute). Standard CSS selector syntax, comma-separated. */
+  readonly ignoreWithin?: string;
+  /** Make the entry itself keyboard-operable: a `tabIndex: 0` focus stop with
+   *  Enter/Space activation. Leave off when a nested interactive element already
+   *  carries the accessible path (see the keyboard note above) — adding it there
+   *  would create a duplicate tab stop. */
+  readonly keyboard?: boolean;
+}
+
+/** The React attributes {@link openTargetProps} yields — spread onto the entry
+ *  element (`<TR>`, card `<div>`). Every field is optional so the disabled case
+ *  is the empty object. */
+export interface OpenTargetProps {
+  readonly onClick?: (event: MouseEvent<HTMLElement>) => void;
+  readonly onKeyDown?: (event: KeyboardEvent<HTMLElement>) => void;
+  readonly tabIndex?: number;
+  readonly style?: { readonly cursor: 'pointer' };
+}
+
+/** True when the event originated on, or inside, an element the entry must yield
+ *  to — a built-in nested-interactive element or a caller `ignoreWithin` match. */
+function landedOnNestedInteractive(target: EventTarget | null, selector: string): boolean {
+  return target instanceof Element && target.closest(selector) !== null;
+}
+
+/**
+ * Build the whole-target open props for one entry. See the module doc for the
+ * contract; pass `onOpen: undefined` to get an inert entry (empty props).
+ */
+export function openTargetProps({
+  onOpen,
+  ignoreWithin,
+  keyboard = false,
+}: OpenTargetOptions): OpenTargetProps {
+  if (onOpen === undefined) return {};
+
+  const selector =
+    ignoreWithin === undefined ? NESTED_INTERACTIVE : `${NESTED_INTERACTIVE}, ${ignoreWithin}`;
+
+  const props: {
+    onClick: (event: MouseEvent<HTMLElement>) => void;
+    onKeyDown?: (event: KeyboardEvent<HTMLElement>) => void;
+    tabIndex?: number;
+    style: { readonly cursor: 'pointer' };
+  } = {
+    onClick: (event) => {
+      // A press-drag that selects the entry's text also fires a click; that is a
+      // read gesture, not an open intent, so an active (non-collapsed) selection
+      // suppresses the open. A keyboard Enter cannot leave a selection, so its
+      // handler skips this check.
+      if (window.getSelection()?.isCollapsed === false) return;
+      if (landedOnNestedInteractive(event.target, selector)) return;
+      onOpen();
+    },
+    style: { cursor: 'pointer' },
+  };
+
+  if (keyboard) {
+    props.tabIndex = 0;
+    props.onKeyDown = (event) => {
+      if (event.key !== 'Enter' && event.key !== ' ') return;
+      if (landedOnNestedInteractive(event.target, selector)) return;
+      // Space would otherwise scroll the region; Enter/Space both activate.
+      event.preventDefault();
+      onOpen();
+    };
+  }
+
+  return props;
+}