@fugood/bricks-ctor 2.25.0-beta.6 → 2.25.0-beta.60

package/types/bricks/{Sketch.ts → Sketch.d.ts}

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -191,9 +191,11 @@ Default property:
     /* A stroke was just committed (drawn or added programmatically) */
     onStrokeEnd?: Array<EventAction<string & keyof TemplateEventPropsMap['Sketch']['onStrokeEnd']>>
     /* The canvas was cleared */
-    onClear?: Array<EventAction>
+    onClear?: Array<EventAction<string & keyof TemplateEventPropsMap['Sketch']['onClear']>>
     /* Sketch state changed (any commit, undo, redo, clear, or import) */
-    onStateChange?: Array<EventAction>
+    onStateChange?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['Sketch']['onStateChange']>
+    >
     /* Active tool changed */
     onToolChange?: Array<
       EventAction<string & keyof TemplateEventPropsMap['Sketch']['onToolChange']>
@@ -223,11 +225,11 @@ Default property:
     }>
   }
   animation?: AnimationBasicEvents & {
-    onStrokeEnd?: Animation
-    onClear?: Animation
-    onStateChange?: Animation
-    onToolChange?: Animation
-    onExportImage?: Animation
+    onStrokeEnd?: AnimationOrGetter
+    onClear?: AnimationOrGetter
+    onStateChange?: AnimationOrGetter
+    onToolChange?: AnimationOrGetter
+    onExportImage?: AnimationOrGetter
   }
 }
 

package/types/bricks/{Slideshow.ts → Slideshow.d.ts}

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -169,12 +169,12 @@ Default property:
     >
   }
   animation?: AnimationBasicEvents & {
-    changeStart?: Animation
-    changeEnd?: Animation
-    contentChange?: Animation
-    roundEnd?: Animation
-    mediaOnLoad?: Animation
-    mediaOnError?: Animation
+    changeStart?: AnimationOrGetter
+    changeEnd?: AnimationOrGetter
+    contentChange?: AnimationOrGetter
+    roundEnd?: AnimationOrGetter
+    mediaOnLoad?: AnimationOrGetter
+    mediaOnError?: AnimationOrGetter
   }
 }
 

package/types/bricks/{Svg.ts → Svg.d.ts}

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -67,12 +67,12 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
   }
 }
 

package/types/bricks/{Text.ts → Text.d.ts}

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -114,14 +114,14 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
-    beforeValueChange?: Animation
-    valueChange?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
+    beforeValueChange?: AnimationOrGetter
+    valueChange?: AnimationOrGetter
   }
 }
 

package/types/bricks/{TextInput.ts → TextInput.d.ts}

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -207,15 +207,15 @@ Default property:
     selectionText?: () => Data<string>
   }
   animation?: AnimationBasicEvents & {
-    onFocus?: Animation
-    onBlur?: Animation
-    onEmpty?: Animation
-    onChange?: Animation
-    onSubmit?: Animation
-    onMatch?: Animation
-    onNotMatch?: Animation
-    onResultNotMatch?: Animation
-    onFullFill?: Animation
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
+    onEmpty?: AnimationOrGetter
+    onChange?: AnimationOrGetter
+    onSubmit?: AnimationOrGetter
+    onMatch?: AnimationOrGetter
+    onNotMatch?: AnimationOrGetter
+    onResultNotMatch?: AnimationOrGetter
+    onFullFill?: AnimationOrGetter
   }
 }
 

package/types/bricks/{Video.ts → Video.d.ts}

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -63,7 +63,13 @@ Default property:
   "muted": false,
   "progressUpdateInterval": 1000,
   "replayTimeout": 500,
-  "renderMode": "auto"
+  "renderMode": "auto",
+  "showSubtitles": true,
+  "subtitleColor": "#FFFFFF",
+  "subtitleBackgroundColor": "rgba(0, 0, 0, 0.6)",
+  "subtitleFontSize": 2,
+  "subtitlePosition": "bottom",
+  "subtitleTextAlign": "center"
 }
   */
   property?: BrickBasicProperty & {
@@ -106,6 +112,57 @@ Default property:
     replayTimeout?: number | DataLink
     /* Use what view type for render video (Auto / Texture or Surface).  Notice: Although using surface has better performance, it also affects the Animation & Standby Transition used by itself */
     renderMode?: 'auto' | 'texture' | 'surface' | DataLink
+    /* The subtitle file path list or single path (SRT/WebVTT), index-matched to the video path. Used when no inline subtitles are set for that video. */
+    subtitlePath?:
+      | string
+      | DataLink
+      | DataLink
+      | {
+          url?: string | DataLink
+        }
+      | Array<
+          | DataLink
+          | {
+              url?: string | DataLink
+            }
+          | string
+          | DataLink
+          | DataLink
+        >
+      | DataLink
+      | DataLink
+    /* Inline subtitles per video, index-matched to the video path: each entry holds a `cues` list of { start, end, text } (start/end in seconds). Takes precedence over the subtitle file for that video. */
+    subtitles?:
+      | Array<
+          | DataLink
+          | {
+              cues?:
+                | Array<
+                    | DataLink
+                    | {
+                        start?: number | DataLink
+                        end?: number | DataLink
+                        text?: string | DataLink
+                      }
+                  >
+                | DataLink
+            }
+        >
+      | DataLink
+    /* Render the subtitle overlay. Turn off to only trigger subtitle events without rendering text */
+    showSubtitles?: boolean | DataLink
+    /* Subtitle text color */
+    subtitleColor?: string | DataLink
+    /* Subtitle background color */
+    subtitleBackgroundColor?: string | DataLink
+    /* Subtitle font size, in grid units (same as Brick Text) */
+    subtitleFontSize?: number | DataLink
+    /* Subtitle font family */
+    subtitleFontFamily?: string | DataLink
+    /* Subtitle vertical position */
+    subtitlePosition?: 'bottom' | 'top' | DataLink
+    /* Subtitle text alignment */
+    subtitleTextAlign?: 'left' | 'center' | 'right' | DataLink
   }
   events?: BrickBasicEvents & {
     /* Event of the brick press */
@@ -130,6 +187,14 @@ Default property:
     onError?: Array<EventAction>
     /* Event of the video progress interval */
     onProgress?: Array<EventAction<string & keyof TemplateEventPropsMap['Video']['onProgress']>>
+    /* Event when a subtitle cue starts (appears) during playback */
+    subtitleCueEnter?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['Video']['subtitleCueEnter']>
+    >
+    /* Event when a subtitle cue ends (disappears) during playback */
+    subtitleCueExit?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['Video']['subtitleCueExit']>
+    >
   }
   outlets?: {
     /* Brick is pressing */
@@ -138,17 +203,19 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
-    nextVideo?: Animation
-    roundEnd?: Animation
-    onLoad?: Animation
-    onError?: Animation
-    onProgress?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
+    nextVideo?: AnimationOrGetter
+    roundEnd?: AnimationOrGetter
+    onLoad?: AnimationOrGetter
+    onError?: AnimationOrGetter
+    onProgress?: AnimationOrGetter
+    subtitleCueEnter?: AnimationOrGetter
+    subtitleCueExit?: AnimationOrGetter
   }
 }
 

package/types/bricks/{VideoStreaming.ts → VideoStreaming.d.ts}

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -77,15 +77,15 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
-    onEnd?: Animation
-    onLoad?: Animation
-    onError?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
+    onEnd?: AnimationOrGetter
+    onLoad?: AnimationOrGetter
+    onError?: AnimationOrGetter
   }
 }
 

package/types/bricks/{WebRtcStream.ts → WebRtcStream.d.ts}

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,

package/types/bricks/{WebView.ts → WebView.d.ts}

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -139,9 +139,9 @@ Default property:
     queryError?: () => Data<string>
   }
   animation?: AnimationBasicEvents & {
-    onLoad?: Animation
-    onError?: Animation
-    onMessage?: Animation
+    onLoad?: AnimationOrGetter
+    onError?: AnimationOrGetter
+    onMessage?: AnimationOrGetter
   }
 }
 

package/types/bricks/{index.ts → index.d.ts}

@@ -20,3 +20,4 @@ export * from './WebRtcStream'
 export * from './GenerativeMedia'
 export * from './Maps'
 export * from './Sketch'
+export * from './Scene3D'

package/types/{common.ts → common.d.ts}

@@ -12,16 +12,13 @@ export interface Brick {
   description?: string
   hideShortRef?: boolean
   property?: {}
-  events: {}
+  events?: {}
   outlets?: {}
   animation?: {}
   switches?: Array<SwitchDef>
 }
 
-export enum LocalSyncStrategy {
-  mainOnly = 'main-only',
-  minorOnly = 'minor-only',
-}
+export type LocalSyncStrategy = 'main-only' | 'minor-only'
 
 export interface Generator {
   __typename: 'Generator'
@@ -33,7 +30,7 @@ export interface Generator {
   hideShortRef?: boolean
   localSyncRunMode?: LocalSyncStrategy
   property?: {}
-  events: {}
+  events?: {}
   outlets?: {}
   switches?: Array<SwitchDef>
 }

package/types/data-calc-command/base.d.ts

@@ -0,0 +1,57 @@
+/* Auto generated by build script */
+import type { Data } from '../data'
+import type { DataCalculation } from '../data-calc'
+
+// Shared helpers — every generated DataCommand{Name} reuses these to describe
+// its narrowed inputs/outputs, so the per-command files stay short.
+export type DataCalcInput<K extends string = string, T = any> = {
+  key: K
+  source: (() => DataCalculationData | DataCommand) | T
+  sourceKey: string
+  trigger?: boolean
+}
+
+export type DataCalcOutput<K extends string = string> = {
+  key: K
+  target: () => DataCalculationData | DataCommand
+  targetKey: string
+}
+
+export interface DataCalculationData {
+  __typename: 'DataCalculationData'
+  title?: string
+  description?: string
+  hideShortRef?: boolean
+  data: () => Data
+  // 'change' is the only valid input port on a data node; the source must be
+  // another node (no inline literals), hence `never` for the second type arg.
+  inputs: Array<DataCalcInput<'change', never>>
+  outputs: Array<DataCalcOutput<'value'>>
+}
+
+export interface DataCommand {
+  __typename: 'DataCommand'
+  __commandName: string
+  id: string
+  title?: string
+  description?: string
+  hideShortRef?: boolean
+  inputs: Array<DataCalcInput>
+  outputs: Array<DataCalcOutput>
+}
+
+export type DataCalculationMap = DataCalculation & {
+  __typename: 'DataCalculationMap'
+  nodes: Array<DataCalculationData | DataCommand>
+  editorInfo: Array<{
+    node: DataCalculationData | DataCommand
+    position: { x: number; y: number }
+    points: Array<{
+      source: DataCalculationData | DataCommand
+      sourceOutputKey: string
+      target: DataCalculationData | DataCommand
+      targetInputKey: string
+      positions: Array<{ x: number; y: number }>
+    }>
+  }>
+}