@fugood/bricks-project 2.22.0-beta.3 → 2.22.0-beta.31

package/compile/action-name-map.ts

@@ -100,6 +100,9 @@ export const templateActionNameMap = {
       payloadType: 'CHANNEL_PUBLISH_PAYLOAD_TYPE',
       payload: 'CHANNEL_PUBLISH_PAYLOAD',
     },
+    DELAY: {
+      time: 'DELAY_TIME',
+    },
     USE_SHARE_APPLICATION: {
       applicationId: 'APPLICATION_ID',
       releaseVersion: 'RELEASE_VERSION',
@@ -126,6 +129,17 @@ export const templateActionNameMap = {
       behavior: 'BEHAVIOR',
       exceptionMessage: 'EXCEPTION_MESSAGE',
     },
+    TRIGGER_APPLICATION_FILTER: {
+      name: 'NAME',
+      variables: 'VARIABLES',
+      result: 'RESULT',
+      error: 'ERROR',
+    },
+    SAVE_UPDATE_SNAPSHOT: {
+      snapshotFileIndentifier: 'SNAPSHOT_FILE_INDENTIFIER',
+      snapshotSaveResult: 'SNAPSHOT_SAVE_RESULT',
+      snapshotErrorResult: 'SNAPSHOT_ERROR_RESULT',
+    },
   },
 
   BRICK_TEXT_INPUT: {
@@ -142,6 +156,13 @@ export const templateActionNameMap = {
     },
   },
 
+  BRICK_VIDEO: {
+    BRICK_VIDEO_SEEK: {
+      seekTime: 'BRICK_VIDEO_SEEK_TIME',
+      play: 'BRICK_VIDEO_PLAY',
+    },
+  },
+
   BRICK_SLIDESHOW: {
     BRICK_SLIDESHOW_JUMP_TO_INDEX: {
       index: 'BRICK_SLIDESHOW_INDEX',
@@ -231,7 +252,12 @@ export const templateActionNameMap = {
       index: 'BRICK_ITEMS_INDEX',
     },
   },
-
+  BRICK_LOTTIE: {
+    BRICK_LOTTIE_PLAY: {
+      startFrame: 'BRICK_LOTTIE_START_FRAME',
+      endFrame: 'BRICK_LOTTIE_END_FRAME',
+    },
+  },
   BRICK_RIVE: {
     BRICK_RIVE_PLAY: {
       animationName: 'BRICK_RIVE_ANIMATION_NAME',
@@ -257,6 +283,10 @@ export const templateActionNameMap = {
     BRICK_WEBVIEW_INJECT_JAVASCRIPT: {
       javascriptCode: 'BRICK_WEBVIEW_JAVASCRIPT_CODE',
     },
+    BRICK_WEBVIEW_QUERY_SELECTOR: {
+      querySelector: 'BRICK_WEBVIEW_QUERY_SELECTOR',
+      expression: 'BRICK_WEBVIEW_EXPRESSION',
+    },
   },
   BRICK_CAMERA: {
     BRICK_CAMERA_TAKE_PICTURE: {
@@ -512,6 +542,36 @@ export const templateActionNameMap = {
       paramsString: 'GENERATOR_SQLITE_PARAMS_STRING',
     },
   },
+
+  GENERATOR_MCP: {
+    GENERATOR_MCP_LIST_RESOURCES: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+    },
+    GENERATOR_MCP_LIST_RESOURCE_TEMPLATES: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+    },
+    GENERATOR_MCP_READ_RESOURCE: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+      uri: 'GENERATOR_MCP_URI',
+      variables: 'GENERATOR_MCP_VARIABLES',
+    },
+    GENERATOR_MCP_LIST_TOOLS: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+    },
+    GENERATOR_MCP_CALL_TOOL: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+      name: 'GENERATOR_MCP_NAME',
+      variables: 'GENERATOR_MCP_VARIABLES',
+    },
+    GENERATOR_MCP_LIST_PROMPTS: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+    },
+    GENERATOR_MCP_GET_PROMPT: {
+      requestId: 'GENERATOR_MCP_REQUEST_ID',
+      name: 'GENERATOR_MCP_NAME',
+      variables: 'GENERATOR_MCP_VARIABLES',
+    },
+  },
   GENERATOR_TTS: {
     GENERATOR_TTS_GENERATE: {
       text: 'GENERATOR_TTS_TEXT',
@@ -521,6 +581,9 @@ export const templateActionNameMap = {
     GENERATOR_ONNX_LLM_INFER: {
       prompt: 'GENERATOR_ONNX_LLM_PROMPT',
       chat: 'GENERATOR_ONNX_LLM_CHAT',
+      images: 'GENERATOR_ONNX_LLM_IMAGES',
+      tools: 'GENERATOR_ONNX_LLM_TOOLS',
+      toolChoice: 'GENERATOR_ONNX_LLM_TOOL_CHOICE',
     },
   },
   GENERATOR_ONNX_STT: {
@@ -558,7 +621,37 @@ export const templateActionNameMap = {
       realtimeVadFreqThold: 'GENERATOR_SPEECH_INFERENCE_REALTIME_VAD_FREQ_THOLD',
     },
   },
+  GENERATOR_VAD_INFERENCE: {
+    GENERATOR_VAD_INFERENCE_DETECT_FILE: {
+      fileUrl: 'GENERATOR_VAD_INFERENCE_FILE_URL',
+      threshold: 'GENERATOR_VAD_INFERENCE_THRESHOLD',
+      minSpeechDurationMs: 'GENERATOR_VAD_INFERENCE_MIN_SPEECH_DURATION_MS',
+      minSilenceDurationMs: 'GENERATOR_VAD_INFERENCE_MIN_SILENCE_DURATION_MS',
+      maxSpeechDurationS: 'GENERATOR_VAD_INFERENCE_MAX_SPEECH_DURATION_S',
+      speechPadMs: 'GENERATOR_VAD_INFERENCE_SPEECH_PAD_MS',
+      samplesOverlap: 'GENERATOR_VAD_INFERENCE_SAMPLES_OVERLAP',
+    },
+    GENERATOR_VAD_INFERENCE_DETECT_DATA: {
+      data: 'GENERATOR_VAD_INFERENCE_DATA',
+      threshold: 'GENERATOR_VAD_INFERENCE_THRESHOLD',
+      minSpeechDurationMs: 'GENERATOR_VAD_INFERENCE_MIN_SPEECH_DURATION_MS',
+      minSilenceDurationMs: 'GENERATOR_VAD_INFERENCE_MIN_SILENCE_DURATION_MS',
+      maxSpeechDurationS: 'GENERATOR_VAD_INFERENCE_MAX_SPEECH_DURATION_S',
+      speechPadMs: 'GENERATOR_VAD_INFERENCE_SPEECH_PAD_MS',
+      samplesOverlap: 'GENERATOR_VAD_INFERENCE_SAMPLES_OVERLAP',
+    },
+  },
+
   GENERATOR_LLM: {
+    GENERATOR_LLM_TOKENIZE: {
+      mode: 'GENERATOR_LLM_MODE',
+      prompt: 'GENERATOR_LLM_PROMPT',
+      promptMediaPaths: 'GENERATOR_LLM_PROMPT_MEDIA_PATHS',
+      messages: 'GENERATOR_LLM_MESSAGES',
+    },
+    GENERATOR_LLM_DETOKENIZE: {
+      tokens: 'GENERATOR_LLM_TOKENS',
+    },
     GENERATOR_LLM_PROCESS_PROMPT: {
       sessionKey: 'GENERATOR_LLM_SESSION_KEY',
       mode: 'GENERATOR_LLM_MODE',
@@ -566,10 +659,15 @@ export const templateActionNameMap = {
       tools: 'GENERATOR_LLM_TOOLS',
       parallelToolCalls: 'GENERATOR_LLM_PARALLEL_TOOL_CALLS',
       toolChoice: 'GENERATOR_LLM_TOOL_CHOICE',
+      enableThinking: 'GENERATOR_LLM_ENABLE_THINKING',
       prompt: 'GENERATOR_LLM_PROMPT',
+      promptMediaPaths: 'GENERATOR_LLM_PROMPT_MEDIA_PATHS',
       promptTemplateData: 'GENERATOR_LLM_PROMPT_TEMPLATE_DATA',
       promptTemplateType: 'GENERATOR_LLM_PROMPT_TEMPLATE_TYPE',
       responseFormat: 'GENERATOR_LLM_RESPONSE_FORMAT',
+      chatTemplateKwargs: 'GENERATOR_LLM_CHAT_TEMPLATE_KWARGS',
+      addGenerationPrompt: 'GENERATOR_LLM_ADD_GENERATION_PROMPT',
+      now: 'GENERATOR_LLM_NOW',
     },
     GENERATOR_LLM_COMPLETION: {
       sessionKey: 'GENERATOR_LLM_SESSION_KEY',
@@ -578,10 +676,16 @@ export const templateActionNameMap = {
       tools: 'GENERATOR_LLM_TOOLS',
       parallelToolCalls: 'GENERATOR_LLM_PARALLEL_TOOL_CALLS',
       toolChoice: 'GENERATOR_LLM_TOOL_CHOICE',
+      enableThinking: 'GENERATOR_LLM_ENABLE_THINKING',
+      useReasoningFormat: 'GENERATOR_LLM_USE_REASONING_FORMAT',
       prompt: 'GENERATOR_LLM_PROMPT',
+      promptMediaPaths: 'GENERATOR_LLM_PROMPT_MEDIA_PATHS',
       promptTemplateData: 'GENERATOR_LLM_PROMPT_TEMPLATE_DATA',
       promptTemplateType: 'GENERATOR_LLM_PROMPT_TEMPLATE_TYPE',
       responseFormat: 'GENERATOR_LLM_RESPONSE_FORMAT',
+      chatTemplateKwargs: 'GENERATOR_LLM_CHAT_TEMPLATE_KWARGS',
+      addGenerationPrompt: 'GENERATOR_LLM_ADD_GENERATION_PROMPT',
+      now: 'GENERATOR_LLM_NOW',
       grammar: 'GENERATOR_LLM_GRAMMAR',
       stopWords: 'GENERATOR_LLM_STOP_WORDS',
       predict: 'GENERATOR_LLM_PREDICT',
@@ -615,6 +719,29 @@ export const templateActionNameMap = {
       sessionCustomKey: 'GENERATOR_LLM_SESSION_CUSTOM_KEY',
     },
   },
+  GENERATOR_GGML_TTS: {
+    GENERATOR_GGML_TTS_GENERATE: {
+      text: 'GENERATOR_GGML_TTS_TEXT',
+    },
+  },
+  GENERATOR_RERANKER: {
+    GENERATOR_RERANKER_RERANK: {
+      query: 'GENERATOR_RERANKER_QUERY',
+      documents: 'GENERATOR_RERANKER_DOCUMENTS',
+    },
+  },
+  GENERATOR_QNN_LLM: {
+    GENERATOR_QNN_LLM_PROCESS: {
+      prompt: 'GENERATOR_QNN_LLM_PROMPT',
+      messages: 'GENERATOR_QNN_LLM_MESSAGES',
+      tools: 'GENERATOR_QNN_LLM_TOOLS',
+    },
+    GENERATOR_QNN_LLM_GENERATE: {
+      prompt: 'GENERATOR_QNN_LLM_PROMPT',
+      messages: 'GENERATOR_QNN_LLM_MESSAGES',
+      tools: 'GENERATOR_QNN_LLM_TOOLS',
+    },
+  },
   GENERATOR_OPENAI_LLM: {
     GENERATOR_OPENAI_LLM_COMPLETION: {
       messages: 'GENERATOR_OPENAI_LLM_MESSAGES',
@@ -630,10 +757,29 @@ export const templateActionNameMap = {
       responseFormat: 'GENERATOR_OPENAI_LLM_RESPONSE_FORMAT',
     },
   },
+  GENERATOR_OPENAI_TTS: {
+    GENERATOR_OPENAI_TTS_GENERATE: {
+      text: 'GENERATOR_OPENAI_TTS_TEXT',
+    },
+  },
+  GENERATOR_ANTHROPIC_LLM: {
+    GENERATOR_ANTHROPIC_LLM_COMPLETION: {
+      systemMessage: 'GENERATOR_ANTHROPIC_LLM_SYSTEM_MESSAGE',
+      messages: 'GENERATOR_ANTHROPIC_LLM_MESSAGES',
+      maxTokens: 'GENERATOR_ANTHROPIC_LLM_MAX_TOKENS',
+      temperature: 'GENERATOR_ANTHROPIC_LLM_TEMPERATURE',
+      topP: 'GENERATOR_ANTHROPIC_LLM_TOP_P',
+      topK: 'GENERATOR_ANTHROPIC_LLM_TOP_K',
+      stopSequences: 'GENERATOR_ANTHROPIC_LLM_STOP_SEQUENCES',
+      tools: 'GENERATOR_ANTHROPIC_LLM_TOOLS',
+      toolChoice: 'GENERATOR_ANTHROPIC_LLM_TOOL_CHOICE',
+    },
+  },
   GENERATOR_ASSISTANT: {
     GENERATOR_ASSISTANT_ADD_MESSAGE: {
       role: 'GENERATOR_ASSISTANT_ROLE',
       content: 'GENERATOR_ASSISTANT_CONTENT',
+      image: 'GENERATOR_ASSISTANT_IMAGE',
       payload: 'GENERATOR_ASSISTANT_PAYLOAD',
       useFileSearch: 'GENERATOR_ASSISTANT_USE_FILE_SEARCH',
       filePath: 'GENERATOR_ASSISTANT_FILE_PATH',
@@ -643,15 +789,28 @@ export const templateActionNameMap = {
       fileSearchCitationCount: 'GENERATOR_ASSISTANT_FILE_SEARCH_CITATION_COUNT',
       fileSearchInsertMethod: 'GENERATOR_ASSISTANT_FILE_SEARCH_INSERT_METHOD',
     },
+    GENERATOR_ASSISTANT_INIT_MCP_PROMPT: {
+      mcpClientName: 'GENERATOR_ASSISTANT_MCP_CLIENT_NAME',
+      mcpPromptName: 'GENERATOR_ASSISTANT_MCP_PROMPT_NAME',
+      mcpArguments: 'GENERATOR_ASSISTANT_MCP_ARGUMENTS',
+      firstMessageAsSystem: 'GENERATOR_ASSISTANT_FIRST_MESSAGE_AS_SYSTEM',
+    },
+    GENERATOR_ASSISTANT_ADD_MCP_PROMPT_MESSAGE: {
+      mcpClientName: 'GENERATOR_ASSISTANT_MCP_CLIENT_NAME',
+      mcpPromptName: 'GENERATOR_ASSISTANT_MCP_PROMPT_NAME',
+      mcpArguments: 'GENERATOR_ASSISTANT_MCP_ARGUMENTS',
+    },
     GENERATOR_ASSISTANT_UPDATE_MESSAGE_AT_INDEX: {
       index: 'GENERATOR_ASSISTANT_INDEX',
       content: 'GENERATOR_ASSISTANT_CONTENT',
+      image: 'GENERATOR_ASSISTANT_IMAGE',
       payload: 'GENERATOR_ASSISTANT_PAYLOAD',
     },
     GENERATOR_ASSISTANT_ADD_AUDIO_MESSAGE: {
       role: 'GENERATOR_ASSISTANT_ROLE',
       contentFile: 'GENERATOR_ASSISTANT_CONTENT_FILE',
       contentBase64: 'GENERATOR_ASSISTANT_CONTENT_BASE64',
+      image: 'GENERATOR_ASSISTANT_IMAGE',
       useFileSearch: 'GENERATOR_ASSISTANT_USE_FILE_SEARCH',
       payload: 'GENERATOR_ASSISTANT_PAYLOAD',
       filePath: 'GENERATOR_ASSISTANT_FILE_PATH',
@@ -674,11 +833,27 @@ export const templateActionNameMap = {
       index: 'GENERATOR_ASSISTANT_INDEX',
       contentFile: 'GENERATOR_ASSISTANT_CONTENT_FILE',
       contentBase64: 'GENERATOR_ASSISTANT_CONTENT_BASE64',
+      image: 'GENERATOR_ASSISTANT_IMAGE',
       payload: 'GENERATOR_ASSISTANT_PAYLOAD',
     },
     GENERATOR_ASSISTANT_REMOVE_MESSAGE_AT_INDEX: {
       index: 'GENERATOR_ASSISTANT_INDEX',
     },
+    GENERATOR_ASSISTANT_SUBMIT: {
+      continueOnToolCallConfirm: 'GENERATOR_ASSISTANT_CONTINUE_ON_TOOL_CALL_CONFIRM',
+      continueOnToolCallStrategy: 'GENERATOR_ASSISTANT_CONTINUE_ON_TOOL_CALL_STRATEGY',
+      continueOnToolCallLimit: 'GENERATOR_ASSISTANT_CONTINUE_ON_TOOL_CALL_LIMIT',
+    },
+    GENERATOR_ASSISTANT_INSERT_MCP_RESOURCE: {
+      mcpClientName: 'GENERATOR_ASSISTANT_MCP_CLIENT_NAME',
+      mcpResourceUri: 'GENERATOR_ASSISTANT_MCP_RESOURCE_URI',
+      mcpVariables: 'GENERATOR_ASSISTANT_MCP_VARIABLES',
+      role: 'GENERATOR_ASSISTANT_ROLE',
+    },
+    GENERATOR_ASSISTANT_SUMMARY_MESSAGES: {
+      summaryMessages: 'GENERATOR_ASSISTANT_SUMMARY_MESSAGES',
+      summarySessionKey: 'GENERATOR_ASSISTANT_SUMMARY_SESSION_KEY',
+    },
   },
   GENERATOR_VECTOR_STORE: {
     GENERATOR_VECTOR_STORE_RESET: {

package/compile/index.ts

@@ -856,6 +856,7 @@ export const compile = async (app: Application) => {
     fonts: app.fonts,
     ...compileApplicationSettings(app.settings),
     test_map: app.metadata?.TEMP_test_map || {},
+    automation_map: app.metadata?.TEMP_automation_map || {},
   }
   return config
 }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.22.0-beta.3",
+  "version": "2.22.0-beta.31",
   "main": "index.ts",
   "scripts": {
     "build": "node scripts/build.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.7.0",
+    "@modelcontextprotocol/sdk": "^1.15.0",
     "@types/escodegen": "^0.0.10",
     "@types/lodash": "^4.17.12",
     "acorn": "^8.13.0",
@@ -14,5 +14,5 @@
     "lodash": "^4.17.4",
     "uuid": "^8.3.1"
   },
-  "gitHead": "cbb283b7ce73520369f855f7fbe86e8e07b831eb"
+  "gitHead": "62a6707c07d0602c36f1f88df6baf07747da6c0a"
 }

package/tools/postinstall.ts

@@ -1,15 +1,7 @@
 import { $ } from 'bun'
 import { stat, readFile, writeFile } from 'fs/promises'
-const cwd = process.cwd()
-
-const libFiles = ['types', 'utils', 'index.ts']
 
-await $`mkdir -p ${cwd}/project`
-for (const file of libFiles) {
-  await $`cp -r ${__dirname}/../${file} ${cwd}/project`
-}
-
-console.log('Copied files to project/')
+const cwd = process.cwd()
 
 async function exists(f: string) {
   try {
@@ -20,6 +12,21 @@ async function exists(f: string) {
   }
 }
 
+// handle flag --skip-copy
+const skipCopyProject = process.argv.includes('--skip-copy-project')
+if (skipCopyProject) {
+  console.log('Skipping copy of files to project/')
+} else {
+
+  const libFiles = ['types', 'utils', 'index.ts']
+  
+  await $`mkdir -p ${cwd}/project`
+  for (const file of libFiles) {
+    await $`cp -r ${__dirname}/../${file} ${cwd}/project`
+  }
+  console.log('Copied files to project/')
+}
+
 const projectMcpServer = {
   command: 'bun',
   args: [`${cwd}/node_modules/@fugood/bricks-project/tools/mcp-server.ts`],
@@ -51,8 +58,7 @@ const handleMcpConfigOverride = async (mcpConfigPath: string) => {
   console.log(`Updated ${mcpConfigPath}`)
 }
 
-if (await exists(`${cwd}/.cursorrules`)) {
-  await $`mkdir -p ${cwd}/.cursor`
+if (await exists(`${cwd}/.cursor/rules/instructions.mdc`)) {
   const cursorMcpConfigPath = `${cwd}/.cursor/mcp.json`
   await handleMcpConfigOverride(cursorMcpConfigPath)
 }

package/types/animation.ts

@@ -30,6 +30,7 @@ export type Easing =
   | 'easeInBounce'
   | 'easeOutBounce'
   | 'easeInOutBounce'
+  | string // Support format like 'cubic-bezier(x1, y1, x2, y2)'
 
 export interface AnimationTimingConfig {
   __type: 'AnimationTimingConfig'
@@ -89,7 +90,7 @@ export interface AnimationComposeDef {
 export type Animation = AnimationDef | AnimationComposeDef
 
 export interface AnimationBasicEvents {
-  show?: Animation
+  showStart?: Animation
   standby?: Animation
   breatheStart?: Animation
 }

package/types/brick-base.ts

@@ -0,0 +1,77 @@
+import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from './switch'
+import type { Data, DataLink } from './data'
+import type { Animation, AnimationBasicEvents } from './animation'
+import type {
+  Brick,
+  EventAction,
+  EventActionForItem,
+  ActionWithDataParams,
+  ActionWithParams,
+  Action,
+  EventProperty,
+} from './common'
+
+export interface BrickBasicProperty {
+  /* The brick opacity (0 ~ 1) */
+  opacity?: number | DataLink
+  /* The brick background color */
+  backgroundColor?: string | DataLink
+  /* The brick border style */
+  borderStyle?: 'solid' | 'dotted' | 'dashed' | DataLink
+  /* The brick border width (top) */
+  borderTopSize?: number | DataLink
+  /* The brick border color (top) */
+  borderTopColor?: string | DataLink
+  /* The brick border radius (top left) */
+  borderTopLeftRadius?: number | DataLink
+  /* The brick border radius (top right) */
+  borderTopRightRadius?: number | DataLink
+  /* The brick border width (bottom) */
+  borderBottomSize?: number | DataLink
+  /* The brick border color (bottom) */
+  borderBottomColor?: string | DataLink
+  /* The brick border radius (bottom left) */
+  borderBottomLeftRadius?: number | DataLink
+  /* The brick border radius (bottom right) */
+  borderBottomRightRadius?: number | DataLink
+  /* The brick border width (left) */
+  borderLeftSize?: number | DataLink
+  /* The brick border color (bottom) */
+  borderLeftColor?: string | DataLink
+  /* The brick border width (right) */
+  borderRightSize?: number | DataLink
+  /* The brick border color (right) */
+  borderRightColor?: string | DataLink
+  /* The brick rotate (deg) */
+  rotate?: number | DataLink
+  /* The brick rotateX (deg) */
+  rotateX?: number | DataLink
+  /* The brick rotateY (deg) */
+  rotateY?: number | DataLink
+  /* The brick shadow color */
+  shadowColor?: string | DataLink
+  /* The brick shadow opacity (0 ~ 1) */
+  shadowOpacity?: number | DataLink
+  /* The brick shadow radius */
+  shadowRadius?: number | DataLink
+  /* The brick shadow offset width */
+  shadowOffsetWidth?: number | DataLink
+  /* The brick shadow offset height */
+  shadowOffsetHeight?: number | DataLink
+  /* Brick pressable.  
+ Disabled: Disabled even if event or animation is set.  
+ Bypass: Disable and bypass the touch event on the brick. */
+  pressable?: 'enabled' | 'disabled' | 'bypass' | DataLink
+}
+
+export interface BrickBasicEvents {
+  showStart?: Array<EventAction>
+  switchUpdate?: Array<EventAction>
+  standby?: Array<EventAction>
+}
+
+export interface BrickBasicEventsForItem {
+  showStart?: Array<EventActionForItem>
+  switchUpdate?: Array<EventActionForItem>
+  standby?: Array<EventActionForItem>
+}

package/types/bricks/3DViewer.ts

@@ -0,0 +1,200 @@
+import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
+import type { Data, DataLink } from '../data'
+import type { Animation, AnimationBasicEvents } from '../animation'
+import type {
+  Brick,
+  EventAction,
+  EventActionForItem,
+  ActionWithDataParams,
+  ActionWithParams,
+  Action,
+  EventProperty,
+} from '../common'
+import type { BrickBasicProperty, BrickBasicEvents, BrickBasicEventsForItem } from '../brick-base'
+
+/* Play object animation */
+export type Brick3DViewerActionAnimationPlay = ActionWithParams & {
+  __actionName: 'BRICK_3D_VIEWER_ANIMATION_PLAY'
+  params?: Array<{
+    input: 'objectIndex'
+    value?: number | DataLink | EventProperty
+    mapping?: string
+  }>
+}
+
+/* Pause object animation */
+export type Brick3DViewerActionAnimationPause = ActionWithParams & {
+  __actionName: 'BRICK_3D_VIEWER_ANIMATION_PAUSE'
+  params?: Array<{
+    input: 'objectIndex'
+    value?: number | DataLink | EventProperty
+    mapping?: string
+  }>
+}
+
+/* Goto object animation progress */
+export type Brick3DViewerActionAnimationGoto = ActionWithParams & {
+  __actionName: 'BRICK_3D_VIEWER_ANIMATION_GOTO'
+  params?: Array<
+    | {
+        input: 'objectIndex'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'animationProgress'
+        value?: number | DataLink | EventProperty
+        mapping?: string
+      }
+  >
+}
+
+interface Brick3DViewerDef {
+  /*
+Default property:
+{
+  "showLoadingBox": true,
+  "enableOrbitControls": true
+}
+  */
+  property?: BrickBasicProperty & {
+    /* 3D model list */
+    objects?:
+      | Array<
+          | DataLink
+          | {
+              url?: string | DataLink
+              md5?: string | DataLink
+              type?: 'USDZ' | 'glTF' | DataLink
+              rotation?: number | DataLink | Array<number | DataLink> | DataLink | DataLink
+              scale?: number | DataLink | Array<number | DataLink> | DataLink | DataLink
+              x?: number | DataLink
+              y?: number | DataLink
+              z?: number | DataLink
+              moveable?: boolean | DataLink
+              rotateable?: boolean | DataLink
+              selectable?: boolean | DataLink
+              enableCollision?: boolean | DataLink
+              animationLoopMode?: 'once' | 'repeat' | 'pingpong' | DataLink
+              animationProgress?: number | DataLink
+              animationPaused?: boolean | DataLink
+              boundingBox?:
+                | DataLink
+                | {
+                    min?:
+                      | DataLink
+                      | {
+                          x?: number | DataLink
+                          y?: number | DataLink
+                          z?: number | DataLink
+                        }
+                    max?:
+                      | DataLink
+                      | {
+                          x?: number | DataLink
+                          y?: number | DataLink
+                          z?: number | DataLink
+                        }
+                  }
+            }
+        >
+      | DataLink
+    /* Show loading placeholder box */
+    showLoadingBox?: boolean | DataLink
+    /* Display shadows */
+    shadows?: boolean | DataLink
+    /* Default camera position */
+    camera?:
+      | DataLink
+      | {
+          fov?: number | DataLink
+          aspect?: number | DataLink
+          near?: number | DataLink
+          far?: number | DataLink
+          position?:
+            | DataLink
+            | {
+                x?: number | DataLink
+                y?: number | DataLink
+                z?: number | DataLink
+              }
+          quaternion?:
+            | DataLink
+            | {
+                x?: number | DataLink
+                y?: number | DataLink
+                z?: number | DataLink
+                w?: number | DataLink
+              }
+        }
+    /* Enable orbit controls */
+    enableOrbitControls?: boolean | DataLink
+    /* Camera control options */
+    orbitControls?:
+      | DataLink
+      | {
+          autoRotate?: boolean | DataLink
+          enableZoom?: boolean | DataLink
+          enablePan?: boolean | DataLink
+          enableRotate?: boolean | DataLink
+          enableDamping?: boolean | DataLink
+          dampingFactor?: number | DataLink
+          rotateSpeed?: number | DataLink
+          zoomSpeed?: number | DataLink
+          panSpeed?: number | DataLink
+          minDistance?: number | DataLink
+          maxDistance?: number | DataLink
+          minPolarAngle?: number | DataLink
+          maxPolarAngle?: number | DataLink
+          minAzimuthAngle?: number | DataLink
+          maxAzimuthAngle?: number | DataLink
+        }
+    /* Move controls options */
+    moveControls?:
+      | DataLink
+      | {
+          responsiveness?: number | DataLink
+          rotationRingColor?: string | DataLink
+          rotationRingSize?: number | DataLink
+          showBoundingBox?: boolean | DataLink
+        }
+  }
+  events?: BrickBasicEvents & {
+    /* Event of error occurred */
+    onError?: Array<EventAction>
+    /* Event of object changed position or rotation */
+    onChange?: Array<EventAction>
+    /* Event of object selected */
+    onSelectChange?: Array<EventAction>
+    /* Event of object collision occurred */
+    onCollision?: Array<EventAction>
+  }
+  animation?: AnimationBasicEvents & {
+    onError?: Animation
+    onChange?: Animation
+    onSelectChange?: Animation
+    onCollision?: Animation
+  }
+}
+
+/* 3D viewer brick */
+export type Brick3DViewer = Brick &
+  Brick3DViewerDef & {
+    templateKey: 'BRICK_3D_VIEWER'
+    switches: Array<
+      SwitchDef &
+        Brick3DViewerDef & {
+          conds?: Array<{
+            method: '==' | '!=' | '>' | '<' | '>=' | '<='
+            cond:
+              | SwitchCondInnerStateCurrentCanvas
+              | SwitchCondData
+              | {
+                  __typename: 'SwitchCondInnerStateOutlet'
+                  outlet: ''
+                  value: any
+                }
+          }>
+        }
+    >
+  }