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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fugood/bricks-ctor",
-  "version": "2.25.0-beta.58",
+  "version": "2.25.0-beta.60",
   "main": "index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -11,7 +11,7 @@
     "@babel/parser": "7.28.5",
     "@babel/traverse": "7.28.5",
     "@babel/types": "7.28.5",
-    "@fugood/bricks-cli": "^2.25.0-beta.58",
+    "@fugood/bricks-cli": "^2.25.0-beta.60",
     "@huggingface/gguf": "^0.3.2",
     "@iarna/toml": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
@@ -29,5 +29,5 @@
   "peerDependencies": {
     "oxfmt": "^0.36.0"
   },
-  "gitHead": "355da5754f1136c10e073460af4727dae94f7e30"
+  "gitHead": "c0dd2ea071f45382808ad55acfc9837217d683ca"
 }

package/skills/bricks-ctor/references/media-flow.md

@@ -31,6 +31,7 @@ const mediaListGenerator: GeneratorMediaFlow = {
   description: '',
   property: {
     boxId: 'promo-box-id',
+    passcode: 'box-read-only-passcode',
   },
   outlets: {
     files: () => promoFilesData, // Array of file objects
@@ -40,6 +41,12 @@ const mediaListGenerator: GeneratorMediaFlow = {
 }
 ```
 
+When hand-writing `GENERATOR_MEDIA_FLOW`, do not use a bare `boxId`. The editor
+flow creates the required authorization, but manual config must include either
+`property.passcode` from a Media Box passcode or `property.accessToken`.
+Without one, devices cannot read the box and the generator will report an
+authorization error.
+
 ## Property Kinds for Media
 
 Link Data properties to Media Flow for asset selection:

package/types/bricks/Video.d.ts

@@ -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 */
@@ -149,6 +214,8 @@ Default property:
     onLoad?: AnimationOrGetter
     onError?: AnimationOrGetter
     onProgress?: AnimationOrGetter
+    subtitleCueEnter?: AnimationOrGetter
+    subtitleCueExit?: AnimationOrGetter
   }
 }
 

package/utils/event-props.ts

@@ -16,6 +16,13 @@ export const templateEventPropsMap = {
   Video: {
     nextVideo: { BRICK_VIDEO_NEXT_INDEX: 'number' },
     onProgress: { BRICK_VIDEO_CURRENT_TIME: 'number', BRICK_VIDEO_PLAYABLE_DURATION: 'number' },
+    subtitleCueEnter: {
+      BRICK_VIDEO_SUBTITLE_TEXT: 'string',
+      BRICK_VIDEO_SUBTITLE_INDEX: 'number',
+      BRICK_VIDEO_SUBTITLE_START: 'number',
+      BRICK_VIDEO_SUBTITLE_END: 'number',
+    },
+    subtitleCueExit: { BRICK_VIDEO_SUBTITLE_TEXT: 'string', BRICK_VIDEO_SUBTITLE_INDEX: 'number' },
   },
   VideoStreaming: {},
   Qrcode: {},