@jini-ai/ui 0.6.17 → 0.6.22

package/dist/features/charts/wire.js

@@ -25,6 +25,43 @@ export const rechartsPieChartManifest = {
     propsSchema: rechartsPieChartPropsSchema, description: 'Pie chart: named, weighted slices. Uses an enabled chart provider or a styled data table.',
 };
 export const chartWireManifests = [rechartsBarChartManifest, rechartsLineChartManifest, rechartsPieChartManifest];
+/** A series point is a finite number, or null for a gap (a missing month on a line). */
+function isSeriesValue(value) {
+    return value === null || (typeof value === 'number' && Number.isFinite(value));
+}
+function isCategoryValue(value) {
+    return typeof value === 'string' || (typeof value === 'number' && Number.isFinite(value));
+}
+/** Report the first bad row per key only, so a large table of strings yields one issue, not thousands. */
+function checkColumn({ rows, key, accepts, expected, ctx }, _options = {}) {
+    const index = rows.findIndex((row) => !Object.hasOwn(row, key) || !accepts(row[key]));
+    if (index < 0)
+        return;
+    const problem = Object.hasOwn(rows[index], key) ? `is not ${expected}` : 'is missing';
+    ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['data', index, key], message: `Row ${index} "${key}" ${problem}; every row needs it.` });
+}
+/** Rows are the shared x axis: every row carries every series key, so series lengths always match. */
+function checkSeriesShape(spec, ctx) {
+    const keys = spec.series.map(({ key }) => key);
+    const duplicate = keys.find((key, index) => keys.indexOf(key) !== index);
+    if (duplicate !== undefined) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ['series'], message: `Series key "${duplicate}" is listed twice.` });
+    }
+    if (spec.categoryKey !== undefined) {
+        checkColumn({ rows: spec.data, key: spec.categoryKey, accepts: isCategoryValue, expected: 'a string or number', ctx });
+    }
+    for (const key of new Set(keys))
+        checkColumn({ rows: spec.data, key, accepts: isSeriesValue, expected: 'a number or null', ctx });
+}
+/** `chart.spec` props: one neutral spec, any kind, one or more series. Stricter than the contract
+ * (which also carries converted legacy data) because an agent writes this shape directly.
+ */
+export const chartSpecPropsSchema = z.object({
+    spec: chartSpecSchema.extend({
+        data: chartSpecSchema.shape.data.min(1),
+        series: chartSpecSchema.shape.series.min(1),
+    }).superRefine(checkSeriesShape),
+}).passthrough();
 /** Convert validated legacy props to the neutral contract; optional provider overrides stay data.
  * @example legacyChartSpec({ kind: 'pie', props: { data: [{ name: 'A', value: 2 }] } })
  * @throws ZodError for an invalid wire shape or nonserializable row data.

package/dist/features/interactive-ui/index.js

@@ -8,6 +8,7 @@ import { shadcnDataTableManifest, DataTable as ShadcnDataTable, shadcnButtonMani
 import { createChartProviderRegistry } from '../charts/registry.js';
 import { createChartInteractiveRegistry } from '../charts/react.js';
 import { chartWireManifests } from '../charts/wire.js';
+import { CHART_SPEC_COMPONENT_ID } from '../charts/catalog-manifests.js';
 /**
  * Every provider currently registered, shadcn preferred over the dependency-free native fallback
  * for `data-table`/`table` — the same order `manifests.ts`'s `ALL_MANIFESTS` declares, so a
@@ -35,9 +36,11 @@ const nonChartRegistry = new InteractiveUiRegistry({ entries: [
     ] });
 // Charts retain their wire IDs and validation while an unconfigured host renders the core table.
 // Runtime providers belong to the host's admitted boot snapshot, never to the default registry.
+// `chart.spec` is here too, so a saved multi-series chart still renders (as a table) in a host that
+// has no provider snapshot. It stays out of `ALL_MANIFESTS`: that list is the legacy wire set.
 const chartHosts = createChartInteractiveRegistry({ registry: nonChartRegistry, providers: createChartProviderRegistry({ providers: [] }) });
 export const DEFAULT_INTERACTIVE_UI_REGISTRY = new InteractiveUiRegistry({ entries: [
         ...nonChartRegistry.list(),
-        ...chartWireManifests.map(({ id }) => chartHosts.resolveById({ id })),
+        ...[...chartWireManifests.map(({ id }) => id), CHART_SPEC_COMPONENT_ID].map((id) => chartHosts.resolveById({ id })),
     ] });
 //# sourceMappingURL=index.js.map

package/dist/features/lexical-rich-text-editor/react/components/RichTextInput.js

@@ -1,5 +1,6 @@
 'use client';
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatErrorForLog } from '@jini-ai/core';
 import { forwardRef, useImperativeHandle, useRef } from 'react';
 import { LexicalComposer } from '@lexical/react/LexicalComposer';
 import { PlainTextPlugin } from '@lexical/react/LexicalPlainTextPlugin';
@@ -145,7 +146,7 @@ export const RichTextInput = forwardRef(function RichTextInput(props, ref) {
         theme: EDITOR_THEME,
         onError(err) {
             if (process.env.NODE_ENV !== 'production') {
-                console.error('[rich-text-input]', err);
+                console.error('[rich-text-input]', formatErrorForLog({ error: err }));
             }
         },
         // editorState intentionally omitted → empty on first paint (SSR-safe).

package/dist/features/mcp-ui/surfaces/outcome.d.ts

@@ -33,7 +33,7 @@
  * every call site into "sometimes required, sometimes not" — worse than a small, purpose-built
  * sibling that carries only what a result needs.
  *
- * ## The one interactive element this DOES carry
+ * ## The external link and optional cancellation
  *
  * `openLinkUrl` renders a single button wired to the bridge's existing `openLink` (`ui/open-link`) —
  * no new bridge plumbing: a `<a href>` is dead inside this package's sandboxed `srcdoc` frame (no
@@ -41,9 +41,13 @@
  * all (`bridge.ts`'s own header). The URL is ALSO always rendered as a plain detail row regardless —
  * copyable/selectable text that needs no script to be useful, matching this package's general
  * "the document should say something true even if a caller never runs its script" posture.
+ * A partial outcome may also describe external work still waiting on the person. Its optional
+ * cancel action answers the caller's existing exchange without confirming an operation or
+ * navigating. Ordinary completed outcomes retain their read-only contract.
  */
 import { type UIResource, type UIResourceUri } from '../resource.js';
 import { type SurfaceDetail } from './document.js';
+import type { ConfirmationToolAction } from './confirmation.js';
 import type { BridgeScriptSpec } from './bridge.js';
 import type { SurfaceTokenName } from './tokens.js';
 export interface SurfaceOutcomeSpec {
@@ -74,6 +78,8 @@ export interface SurfaceOutcomeSpec {
      *  Only meaningful alongside `state: 'success'` — a caller should not supply this for a failure. */
     readonly openLinkUrl?: string;
     readonly openLinkLabel?: string;
+    /** A pending external action may be skipped through its existing surface exchange. */
+    readonly cancel?: ConfirmationToolAction;
     /** Identity reported to the Host in `ui/initialize`. Defaults to a generic one. */
     readonly app?: BridgeScriptSpec;
     readonly lang?: string;

package/dist/features/mcp-ui/surfaces/outcome.js

@@ -33,7 +33,7 @@
  * every call site into "sometimes required, sometimes not" — worse than a small, purpose-built
  * sibling that carries only what a result needs.
  *
- * ## The one interactive element this DOES carry
+ * ## The external link and optional cancellation
  *
  * `openLinkUrl` renders a single button wired to the bridge's existing `openLink` (`ui/open-link`) —
  * no new bridge plumbing: a `<a href>` is dead inside this package's sandboxed `srcdoc` frame (no
@@ -41,10 +41,13 @@
  * all (`bridge.ts`'s own header). The URL is ALSO always rendered as a plain detail row regardless —
  * copyable/selectable text that needs no script to be useful, matching this package's general
  * "the document should say something true even if a caller never runs its script" posture.
+ * A partial outcome may also describe external work still waiting on the person. Its optional
+ * cancel action answers the caller's existing exchange without confirming an operation or
+ * navigating. Ordinary completed outcomes retain their read-only contract.
  */
 import { createUIResource } from '../resource.js';
 import { escapeHtml, escapeJsValue } from '../escape.js';
-import { renderActions, renderDetailList, renderSurfaceDocument, renderSurfaceHeader, SURFACE_SCRIPT_PRELUDE, SURFACE_STATUS_ELEMENT_ID, } from './document.js';
+import { DEFAULT_SURFACE_STATUS_TEXT, renderActions, renderDetailList, renderSurfaceDocument, renderSurfaceHeader, SURFACE_SCRIPT_PRELUDE, SURFACE_STATUS_ELEMENT_ID, } from './document.js';
 const DEFAULT_APP = { appName: 'jini-mcp-ui-outcome', appVersion: '1' };
 const DEFAULT_OPEN_LINK_LABEL = 'Open site';
 const OPEN_LINK_ACTION_ID = 'open-link';
@@ -54,11 +57,45 @@ function statusStateOf(state) {
         return 'done';
     return state === 'partial' ? 'partial' : 'failed';
 }
-/** The open-link button, or nothing without a link. @complexity O(n) in the label length. */
+/** One action list for the frame and its host mirror. @complexity O(n) in the label length. */
+function outcomeActions(spec) {
+    const actions = [];
+    if (spec.openLinkUrl !== undefined)
+        actions.push({ id: OPEN_LINK_ACTION_ID, label: spec.openLinkLabel ?? DEFAULT_OPEN_LINK_LABEL, variant: spec.state === 'success' ? 'primary' : 'neutral' });
+    if (spec.cancel)
+        actions.push({ id: 'cancel', label: spec.cancel.label, variant: 'neutral' });
+    return actions;
+}
 function renderOpenLinkActions(spec) {
-    if (spec.openLinkUrl === undefined)
-        return '';
-    return renderActions([{ id: OPEN_LINK_ACTION_ID, label: spec.openLinkLabel ?? DEFAULT_OPEN_LINK_LABEL, variant: spec.state === 'success' ? 'primary' : 'neutral' }]);
+    const actions = outcomeActions(spec);
+    return actions.length === 0 ? '' : renderActions(actions);
+}
+/** Pending external work keeps its outbound link and answers cancellation through the same bridge.
+ * Existing read-only outcomes retain their script and need no exchange. @complexity O(n) rendered bytes. */
+function cancellableOutcomeScript(spec) {
+    if (!spec.cancel)
+        return outcomeScript(spec.openLinkUrl);
+    return `(function () {
+  "use strict";
+${SURFACE_SCRIPT_PRELUDE}
+  var TEXT = ${escapeJsValue(DEFAULT_SURFACE_STATUS_TEXT)};
+  var CANCEL = ${escapeJsValue(spec.cancel)};
+  var OPEN_URL = ${escapeJsValue(spec.openLinkUrl ?? null)};
+  var locked = false;
+  function onClick(event) {
+    if (event.isTrusted !== true || locked) return;
+    if (event.currentTarget.getAttribute("data-mcpui-action") === "open-link") {
+      api.openLink(OPEN_URL);
+      return;
+    }
+    locked = true;
+    setBusy(true);
+    api.callTool(CANCEL.toolName, CANCEL.params).then(function () {
+      setStatus(TEXT.dismissed, "dismissed");
+    }, function (error) { locked = !reportCallFailure(error); });
+  }
+  for (var i = 0; i < actionButtons.length; i++) actionButtons[i].addEventListener("click", onClick);
+}());`;
 }
 /** The inline script: wires the open-link button, or nothing at all. @complexity O(n) in the URL length. */
 function outcomeScript(openLinkUrl) {
@@ -99,7 +136,7 @@ export function renderOutcomeDocument(spec) {
     return renderSurfaceDocument({
         title: spec.title,
         bodyHtml,
-        script: outcomeScript(spec.openLinkUrl),
+        script: cancellableOutcomeScript(spec),
         app: spec.app ?? DEFAULT_APP,
         ...(spec.lang === undefined ? {} : { lang: spec.lang }),
         ...(spec.tokens === undefined ? {} : { tokens: spec.tokens }),
@@ -120,10 +157,12 @@ export function buildOutcomeSurface(spec) {
         uri: spec.uri,
         htmlString: renderOutcomeDocument(spec),
         ...(spec.preferredFrameSize === undefined ? {} : { preferredFrameSize: spec.preferredFrameSize }),
+        ...(spec.cancel ? { actionPlan: { title: spec.title, actions: outcomeActions(spec) } } : {}),
         // No `actionPlan`: unlike a confirmation, this surface has nothing PENDING for
         // `page.find_elements`'s parent-DOM mirror to describe (`McpUiSurfaceCard`'s own
         // `readActionPlan`/`PendingSurfaceMirror` — that mirror exists for a confirmation a human has not
-        // yet answered; a result has already been answered).
+        // yet answered; a result has already been answered). A cancellable external wait above is
+        // pending, so its mirror uses the same actions its frame renders, with no routing params.
     });
 }
 //# sourceMappingURL=outcome.js.map

package/dist/features/panel-kit/ErrorNotice.d.ts

@@ -0,0 +1,18 @@
+import type { UserFacingError } from '@jini-ai/core';
+import { type CopyToClipboardOptions } from '../../utils/copy-to-clipboard.js';
+import type { Translate } from '../i18n/index.js';
+/** A formatted failure, optional host translation, and injectable clipboard ports. */
+export interface ErrorNoticeProps extends CopyToClipboardOptions {
+    readonly failure: UserFacingError;
+    readonly t?: Translate;
+    readonly className?: string;
+    /** History surfaces use polite announcements; active form failures keep the alert default. */
+    readonly role?: "alert" | "status";
+}
+/**
+ * Disclose exactly the formatted copy block in native, selectable details. Copying has no recovery effects.
+ * Failed writes leave the details available for manual copying; feedback resets with the incident.
+ * @complexity O(copyText length) per render/copy; one clipboard write plus the existing fallback on rejection.
+ */
+export declare function ErrorNotice({ failure, t, className, role, ...ports }: ErrorNoticeProps): import("react").JSX.Element;
+//# sourceMappingURL=ErrorNotice.d.ts.map

package/dist/features/panel-kit/ErrorNotice.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { copyToClipboard } from '../../utils/copy-to-clipboard.js';
+/**
+ * Disclose exactly the formatted copy block in native, selectable details. Copying has no recovery effects.
+ * Failed writes leave the details available for manual copying; feedback resets with the incident.
+ * @complexity O(copyText length) per render/copy; one clipboard write plus the existing fallback on rejection.
+ */
+export function ErrorNotice({ failure, t = text => text, className = 'notice error', role = 'alert', ...ports }) {
+    const [feedback, setFeedback] = useState(null);
+    async function copy() {
+        const copied = await copyToClipboard({ text: failure.copyText }, ports);
+        setFeedback({ text: failure.copyText, copied });
+    }
+    return (_jsxs("div", { className: className, role: role, children: [_jsx("p", { children: failure.message }), _jsx("p", { children: failure.action }), _jsxs("details", { children: [_jsx("summary", { children: t('Show details') }), _jsx("pre", { style: { whiteSpace: 'pre-wrap', overflowWrap: 'anywhere', userSelect: 'text' }, children: failure.copyText }), _jsx("button", { type: "button", onClick: () => void copy(), children: t('Copy details') }), feedback && feedback.text === failure.copyText ? _jsx("p", { role: "status", children: t(feedback.copied ? 'Copied' : 'Copy failed. Select the details and copy them manually.') }) : null] })] }));
+}
+//# sourceMappingURL=ErrorNotice.js.map

package/dist/features/panel-kit/index.d.ts

@@ -1,4 +1,6 @@
 export * from './fetch-query/index.js';
+export { ErrorNotice } from './ErrorNotice.js';
+export type { ErrorNoticeProps } from './ErrorNotice.js';
 export { useFocusTrap } from './hooks/use-focus-trap.hooks.js';
 export { useDirtyGuard } from './hooks/use-dirty-guard.hooks.js';
 export type { DirtyGuard } from './hooks/use-dirty-guard.hooks.js';

package/dist/features/panel-kit/index.js

@@ -1,4 +1,5 @@
 export * from './fetch-query/index.js';
+export { ErrorNotice } from './ErrorNotice.js';
 export { useFocusTrap } from './hooks/use-focus-trap.hooks.js';
 export { useDirtyGuard } from './hooks/use-dirty-guard.hooks.js';
 export { useAsyncAction } from './hooks/use-async-action.hooks.js';

package/dist/features/sketch-editor/react/hooks/useSketchSaveWorkflow.js

@@ -1,3 +1,4 @@
+import { formatErrorForLog } from '@jini-ai/core';
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { EXPORTED_IMAGE_MIME_TYPE, SAVED_VISIBLE_MS } from '../../constants.js';
 import { defaultSketchEditorDependencies } from '../../dependencies.js';
@@ -85,7 +86,7 @@ export function useSketchSaveWorkflow(params) {
             });
         }
         catch (err) {
-            console.warn('[SketchEditor] export image failed', err);
+            console.warn('[SketchEditor] export image failed', formatErrorForLog({ error: err }));
             setToast({ message: tRef.current('Could not export image'), tone: 'error' });
         }
         finally {

package/dist/react/components/TooltipLayer.js

@@ -73,6 +73,12 @@ export function useTooltipLayer() {
     const rafRef = useRef(null);
     const lastInputRef = useRef('pointer');
     const suppressedTitleRef = useRef(null);
+    // Touch has no hover, and a tap's own pointerdown/click would hide the tip
+    // the instant it appeared — so a touch tap on a trigger TOGGLES the tip
+    // instead. `touchTapRef` remembers the trigger under the touch pointerdown
+    // (and whether its tip was already open) until the matching click.
+    const touchTapRef = useRef(null);
+    const openTargetRef = useRef(null);
     const [state, setState] = useState(null);
     const restoreNativeTitle = useCallback(() => {
         const suppressed = suppressedTitleRef.current;
@@ -170,6 +176,7 @@ export function useTooltipLayer() {
         });
     }, [updatePosition]);
     useLayoutEffect(() => {
+        openTargetRef.current = state?.target ?? null;
         if (!state)
             return;
         updatePosition();
@@ -209,11 +216,15 @@ export function useTooltipLayer() {
         };
         const onPointerOver = (event) => {
             lastInputRef.current = 'pointer';
+            if (event.pointerType === 'touch')
+                return;
             const target = readTooltipTarget(event.target);
             if (target)
                 showTooltip(target);
         };
         const onTargetExit = (event) => {
+            if ('pointerType' in event && event.pointerType === 'touch')
+                return;
             const target = readTooltipTarget(event.target);
             if (!target)
                 return;
@@ -224,14 +235,28 @@ export function useTooltipLayer() {
         };
         const onPointerDown = (event) => {
             lastInputRef.current = 'pointer';
-            hideTooltipForActivation(readTooltipTarget(event.target));
+            const target = readTooltipTarget(event.target);
+            touchTapRef.current = null;
+            if (event.pointerType === 'touch' && target) {
+                touchTapRef.current = { target, wasOpen: openTargetRef.current === target };
+                return;
+            }
+            hideTooltipForActivation(target);
         };
         const onPointerCancel = () => {
             lastInputRef.current = 'pointer';
+            touchTapRef.current = null;
             hideTooltip();
         };
         const onClick = (event) => {
-            hideTooltipForActivation(readTooltipTarget(event.target));
+            const target = readTooltipTarget(event.target);
+            const touchTap = touchTapRef.current;
+            touchTapRef.current = null;
+            if (target && touchTap?.target === target && !touchTap.wasOpen) {
+                showTooltip(target);
+                return;
+            }
+            hideTooltipForActivation(target);
         };
         const onFocusIn = (event) => {
             const target = readTooltipTarget(event.target);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/ui",
-  "version": "0.6.17",
+  "version": "0.6.22",
   "description": "Generic, product-neutral React UI primitives and feature domains. Framework-free types, decision rules, catalogs, and host port contracts live behind ./core (no React, no DOM). The Excalidraw and Lexical editors live behind ./sketch-editor and ./lexical-rich-text-editor; the GrapesJS-backed inline HTML editor lives behind ./html-editor.",
   "license": "Apache-2.0",
   "repository": {
@@ -263,19 +263,19 @@
     "shiki": "^1.24.4",
     "tailwind-merge": "^2.6.0",
     "zod": "^3.25.76",
-    "@jini-ai/agent-runtime": "^0.6.17",
-    "@jini-ai/platform": "^0.6.17",
-    "@jini-ai/agentic": "^0.6.17",
-    "@jini-ai/core": "^0.6.17",
-    "@jini-ai/integrations": "^0.6.17"
+    "@jini-ai/platform": "^0.6.22",
+    "@jini-ai/agent-runtime": "^0.6.22",
+    "@jini-ai/integrations": "^0.6.19",
+    "@jini-ai/agentic": "^0.6.19",
+    "@jini-ai/core": "^0.6.22"
   },
   "dependencies": {
     "micromark": "^4.0.0",
     "micromark-extension-gfm": "^3.0.0",
-    "@jini-ai/ui-kit": "^0.6.17",
-    "@jini-ai/platform": "^0.6.17",
-    "@jini-ai/core": "^0.6.17",
-    "@jini-ai/agentic": "^0.6.17"
+    "@jini-ai/core": "^0.6.22",
+    "@jini-ai/ui-kit": "^0.6.19",
+    "@jini-ai/agentic": "^0.6.19",
+    "@jini-ai/platform": "^0.6.22"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",