@ikonai/sdk-react-ui 1.8.0 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikonai/sdk-react-ui",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",

package/parallax-view.d.ts

@@ -1,6 +1,6 @@
 import { IkonClient } from '../sdk/sdk/src/index.ts';
 import { IkonUiStoreEntry } from './surface';
-import { UiComponentLibrary } from './renderer';
+import { DispatchActionOptions, UiComponentLibrary } from './renderer';
 /**
  * Mounts a named Parallax sub-tree into a host-controlled container.
  *
@@ -22,6 +22,6 @@ export interface ParallaxViewProps {
     /** Connected Ikon client; required for media-bearing UIs (video, audio). */
     client?: IkonClient | null;
     /** Optional handler for ParallaxView-internal action dispatches. */
-    onAction?: (actionId: string, payload?: string) => void;
+    onAction?: (actionId: string, payload?: string, options?: DispatchActionOptions) => void;
 }
 export declare function ParallaxView({ mount, stores, registry, client, onAction }: ParallaxViewProps): import("react").JSX.Element;

package/renderer/index.d.ts

@@ -3,4 +3,4 @@ export { UiComponentRegistry, createComponentLibrary, } from './component-librar
 export { useUiStore } from './use-ui-store';
 export { useUiNode } from './use-ui-node';
 export { useRootView } from './use-root-view';
-export type { UiComponentRenderer, UiComponentLibrary, UiNode, UiRenderContext, UiComponentRendererProps, ParsedUiUpdate, UiSnapshot, UiFullSnapshot, UiDiffSnapshot, UiNodeDiff, TextDelta, UiNodeProps, UiUpdateType, UiStoreSnapshot, } from './types';
+export type { DispatchActionOptions, UiComponentRenderer, UiComponentLibrary, UiNode, UiRenderContext, UiComponentRendererProps, ParsedUiUpdate, UiSnapshot, UiFullSnapshot, UiDiffSnapshot, UiNodeDiff, TextDelta, UiNodeProps, UiUpdateType, UiStoreSnapshot, } from './types';

package/renderer/types.d.ts

@@ -3,6 +3,17 @@ import { HandlerCache, UiNode, UiStreamStore } from '../../sdk/sdk-ui/src/index.
 import { IkonClient, IkonVideoPlayback } from '../../sdk/sdk/src/index.ts';
 import { ComponentType, ReactNode } from 'react';
 export { type UiUpdateType, type UiNodeProps, type UiNode, type UiNodeDiff, type UiSnapshot, type UiFullSnapshot, type UiDiffSnapshot, type UiSnapshotMetadata, type TextDelta, type ParsedUiUpdate, type UiStoreSnapshot, } from '../../sdk/sdk-ui/src/index.ts';
+/** How a dispatched action should be treated when the server cannot run it. */
+export interface DispatchActionOptions {
+    /**
+     * The dispatch is the component's own bookkeeping rather than something a person did, so a
+     * server refusal is not worth a person's attention. A controlled overlay reports itself closed
+     * as it unmounts; when the whole subtree is being removed the server has already retired that
+     * action, and the refusal that comes back describes a state it reached on its own. Failures of
+     * a best-effort dispatch are logged at debug instead of error.
+     */
+    bestEffort?: boolean;
+}
 /**
  * Context for rendering UI nodes.
  * Provides access to payloads, action dispatch, and rendering utilities.
@@ -15,7 +26,7 @@ export interface UiRenderContext {
     /** Render a view by ID */
     renderView: (viewId: string) => ReactNode;
     /** Dispatch an action with optional payload */
-    dispatchAction: (actionId: string, payload?: unknown) => void;
+    dispatchAction: (actionId: string, payload?: unknown, options?: DispatchActionOptions) => void;
     /** The Ikon client instance */
     client?: IkonClient | null;
     /** Video playback API */

package/renderer/ui-renderer.d.ts

@@ -1,7 +1,7 @@
 import { IkonClient, IkonVideoPlayback } from '../../sdk/sdk/src/index.ts';
 import { UiStreamStore } from '../../sdk/sdk-ui/src/index.ts';
 import { ReactNode } from 'react';
-import { UiComponentLibrary, UiNode, UiRenderContext } from './types';
+import { DispatchActionOptions, UiComponentLibrary, UiNode, UiRenderContext } from './types';
 /**
  * Render children nodes by their IDs.
  * Used by component renderers to render their children.
@@ -14,7 +14,7 @@ export interface UiRendererProps {
     readonly library: UiComponentLibrary;
     readonly viewId?: string;
     readonly emptyFallback?: ReactNode;
-    readonly onAction?: (actionId: string, payloadJson: string) => void;
+    readonly onAction?: (actionId: string, payloadJson: string, options?: DispatchActionOptions) => void;
     readonly client?: IkonClient | null;
     readonly video?: IkonVideoPlayback | null;
 }

package/surface.d.ts

@@ -1,6 +1,6 @@
 import { UIStreamCategories } from '../shared/protocol/src/index.ts';
 import { UiStreamStore } from '../sdk/sdk-ui/src/index.ts';
-import { UiComponentLibrary } from './renderer';
+import { DispatchActionOptions, UiComponentLibrary } from './renderer';
 import { IkonClient } from '../sdk/sdk/src/index.ts';
 export declare const IKON_UI_STREAM_CATEGORY: "ikon-ui";
 export type IkonUiCategory = UIStreamCategories | typeof IKON_UI_STREAM_CATEGORY | (string & {});
@@ -13,7 +13,7 @@ export interface IkonUiSurfaceProps {
     stores: ReadonlyMap<string, IkonUiStoreEntry>;
     registry: UiComponentLibrary;
     category?: IkonUiCategory;
-    onAction?: (actionId: string, payload?: string) => void;
+    onAction?: (actionId: string, payload?: string, options?: DispatchActionOptions) => void;
     client?: IkonClient | null;
 }
 export declare const IkonUiSurface: import('react').MemoExoticComponent<({ stores, registry, category, onAction, client }: IkonUiSurfaceProps) => import("react").JSX.Element | null>;

package/theme/ikon-app.css

@@ -103,8 +103,10 @@
   padding: 24px;
   z-index: 9999;
   background: var(--ikon-overlay-scrim);
-  backdrop-filter: blur(8px);
+  /* The prefixed form first: the minifier folds this pair into whichever is written last, and
+     Chromium has dropped `-webkit-backdrop-filter`, so standard-last is the one that blurs. */
   -webkit-backdrop-filter: blur(8px);
+  backdrop-filter: blur(8px);
   animation: ikon-fade-in 0.4s ease-out;
 }