@godscene/visualizer 1.7.11

package/dist/types/utils/playground-utils.d.ts

@@ -0,0 +1,11 @@
+import type { UIContext } from '@godscene/core';
+import { StaticPageAgent } from '@godscene/web/static';
+/**
+ * @deprecated Import `actionNameForType` from `./action-label` directly.
+ * This re-export exists only to keep older import paths working and may be
+ * removed once all call sites are migrated.
+ */
+export { actionNameForType } from './action-label';
+export { getPlaceholderForType } from './prompt-placeholder';
+export declare const staticAgentFromContext: (context: UIContext) => StaticPageAgent;
+export declare const isRunButtonEnabled: (runButtonEnabled: boolean, needsStructuredParams: boolean, params: any, actionSpace: any[] | undefined, selectedType: string, promptValue: string) => boolean;

package/dist/types/utils/progress-action-icon.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from 'react';
+/**
+ * Default icon for a completed `InfoListItem.actionKind`. All action types
+ * resolve to the same green checkmark glyph; callers can opt out by passing
+ * an override via `ExecutionFlowConfig.resolveActionIcon`.
+ */
+export declare function defaultProgressActionIcon(_kind: string): ReactNode | null;
+/**
+ * Resolve the icon for a progress action, applying the host's override
+ * (if any) before falling back to the default mapping.
+ */
+export declare function resolveProgressActionIcon(kind: string | undefined, override?: (kind: string) => ReactNode | null | undefined): ReactNode | null;

package/dist/types/utils/prompt-input-utils.d.ts

@@ -0,0 +1,24 @@
+import type { DeviceAction } from '@godscene/core';
+export interface InlineStructuredFieldConfig {
+    name: string;
+    placeholder?: string;
+}
+/**
+ * Compute the list of action identifiers that should be offered in the prompt
+ * input's action dropdown.
+ *
+ * Inclusion rules:
+ *   - If `actionSpace` is empty/undefined, fall back to the full metadata set
+ *     so dry-mode / offline renderers still show something to pick from.
+ *   - `aiAct` is always included. It is an Agent-level API and is executed via
+ *     Playground's fallback path, so it does not need to appear in the device
+ *     interface's low-level `actionSpace`.
+ *   - `extraction` and `validation` APIs are kept even when not in the device's
+ *     `actionSpace`: they are executed against the captured UI context rather
+ *     than being dispatched to the device, so they apply universally.
+ *   - All remaining `actionSpace` entries are included verbatim (device-specific
+ *     actions surface automatically).
+ */
+export declare const getAvailablePromptActionTypes: (actionSpace: DeviceAction<any>[] | undefined) => string[];
+export declare const getInlineStructuredFieldConfig: (actionSpace: DeviceAction<any>[] | undefined, selectedType: string) => InlineStructuredFieldConfig | null;
+export declare const shouldOffsetEmptyStateForPromptInput: (actionSpace: DeviceAction<any>[] | undefined, selectedType: string) => boolean;

package/dist/types/utils/prompt-placeholder.d.ts

@@ -0,0 +1 @@
+export declare const getPlaceholderForType: (type: string) => string;

package/dist/types/utils/replay-scripts.d.ts

@@ -0,0 +1,50 @@
+import type { ExecutionDump, ExecutionTask, IExecutionDump, IReportActionDump, LocateResultElement, ModelBrief, Rect, ReportActionDump, UIContext } from '@godscene/core';
+export interface CameraState {
+    left: number;
+    top: number;
+    width: number;
+    pointerLeft: number;
+    pointerTop: number;
+}
+export type TargetCameraState = Omit<CameraState, 'pointerLeft' | 'pointerTop'> & Partial<Pick<CameraState, 'pointerLeft' | 'pointerTop'>>;
+export interface AnimationScript {
+    type: 'img' | 'insight' | 'clear-insight' | 'pointer' | 'spinning-pointer' | 'sleep';
+    img?: string;
+    camera?: TargetCameraState;
+    context?: UIContext;
+    highlightElement?: LocateResultElement;
+    searchArea?: Rect;
+    duration: number;
+    insightCameraDuration?: number;
+    title?: string;
+    subTitle?: string;
+    imageWidth?: number;
+    imageHeight?: number;
+    taskId?: string;
+}
+export declare const cameraStateForRect: (rect: Rect, imageWidth: number, imageHeight: number) => TargetCameraState;
+export declare const mergeTwoCameraState: (cameraState1: TargetCameraState, cameraState2: TargetCameraState) => TargetCameraState;
+export interface ReplayScriptsInfo {
+    scripts: AnimationScript[];
+    width?: number;
+    height?: number;
+    sdkVersion?: string;
+    modelBriefs: ModelBrief[];
+    deviceType?: string;
+}
+type DumpInput = ReportActionDump | IReportActionDump | ExecutionDump | null | undefined;
+export interface DumpMetaInfo {
+    width: number;
+    height: number;
+    sdkVersion?: string;
+    modelBriefs: ModelBrief[];
+    deviceType?: string;
+}
+/**
+ * Extract lightweight metadata from dump without reading any .base64 fields.
+ * Used to set up the UI (dimensions, version, model info) before replay.
+ */
+export declare const extractDumpMetaInfo: (dump: DumpInput) => DumpMetaInfo | null;
+export declare const allScriptsFromDump: (dump: DumpInput) => ReplayScriptsInfo | null;
+export declare const generateAnimationScripts: (execution: ExecutionDump | IExecutionDump | null, task: ExecutionTask | number, imageWidth: number, imageHeight: number, executionIndex?: number) => AnimationScript[] | null;
+export {};

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@godscene/visualizer",
+  "version": "1.7.11",
+  "repository": "https://github.com/web-infra-dev/midscene",
+  "homepage": "https://midscenejs.com/",
+  "types": "./dist/types/index.d.ts",
+  "main": "./dist/lib/index.js",
+  "module": "./dist/es/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/es/index.mjs",
+      "require": "./dist/lib/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "html",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": "18.3.1",
+    "react-dom": ">=19.1.0"
+  },
+  "devDependencies": {
+    "@rsbuild/plugin-less": "^1.5.0",
+    "@rsbuild/plugin-node-polyfill": "1.4.2",
+    "@rsbuild/plugin-react": "^1.4.1",
+    "@rsbuild/plugin-svgr": "^1.2.2",
+    "@rslib/core": "^0.18.3",
+    "@types/chrome": "0.0.279",
+    "@types/node": "^18.0.0",
+    "@types/react": "^18.3.1",
+    "@types/react-dom": "^18.3.1",
+    "execa": "9.3.0",
+    "http-server": "14.1.1",
+    "query-string": "9.1.1",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-resizable-panels": "2.0.22",
+    "rimraf": "~3.0.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.8.3",
+    "vitest": "3.0.5",
+    "zustand": "4.5.2"
+  },
+  "sideEffects": [
+    "**/*.css",
+    "**/*.less",
+    "**/*.sass",
+    "**/*.scss"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@ant-design/icons": "^5.3.1",
+    "antd": "^5.21.6",
+    "buffer": "6.0.3",
+    "dayjs": "^1.11.11",
+    "@godscene/core": "1.7.11",
+    "@godscene/shared": "1.7.11",
+    "@godscene/playground": "1.7.11",
+    "@godscene/web": "1.7.11"
+  },
+  "license": "MIT",
+  "scripts": {
+    "dev": "npm run build:watch",
+    "build": "rslib build",
+    "build:watch": "rslib build --watch --no-clean",
+    "test": "vitest --run",
+    "serve": "http-server ./dist/ -p 3000"
+  }
+}