@fugood/bricks-project 2.22.2 → 2.22.4

package/compile/action-name-map.ts

@@ -525,6 +525,13 @@ export const templateActionNameMap = {
       params: 'GENERATOR_SQLITE_PARAMS',
       paramsString: 'GENERATOR_SQLITE_PARAMS_STRING',
     },
+    GENERATOR_SQLITE_TRANSACTION: {
+      statements: 'GENERATOR_SQLITE_STATEMENTS',
+    },
+    GENERATOR_SQLITE_BATCH_EXECUTE: {
+      sql: 'GENERATOR_SQLITE_SQL',
+      batchParams: 'GENERATOR_SQLITE_BATCH_PARAMS',
+    },
   },
 
   GENERATOR_MCP: {
@@ -566,6 +573,7 @@ export const templateActionNameMap = {
       prompt: 'GENERATOR_ONNX_LLM_PROMPT',
       chat: 'GENERATOR_ONNX_LLM_CHAT',
       images: 'GENERATOR_ONNX_LLM_IMAGES',
+      audios: 'GENERATOR_ONNX_LLM_AUDIOS',
       tools: 'GENERATOR_ONNX_LLM_TOOLS',
       toolChoice: 'GENERATOR_ONNX_LLM_TOOL_CHOICE',
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.22.2",
+  "version": "2.22.4",
   "main": "index.ts",
   "scripts": {
     "build": "node scripts/build.js"

package/types/bricks/GenerativeMedia.ts

@@ -198,6 +198,8 @@ Default property:
     url?: () => Data
     /* Generated media error */
     error?: () => Data
+    /* Loading state */
+    loading?: () => Data
   }
   animation?: AnimationBasicEvents & {
     generativeMediaOnPress?: Animation
@@ -231,7 +233,7 @@ export type GenerativeMedia = Brick &
               | SwitchCondData
               | {
                   __typename: 'SwitchCondInnerStateOutlet'
-                  outlet: 'brickPressing' | 'brickFocusing' | 'url' | 'error'
+                  outlet: 'brickPressing' | 'brickFocusing' | 'url' | 'error' | 'loading'
                   value: any
                 }
           }>

package/types/bricks/Slideshow.ts

@@ -34,6 +34,26 @@ export type BrickSlideshowActionJumpToIndex = ActionWithParams & {
   >
 }
 
+/* Play the slideshow (resume if paused) */
+export type BrickSlideshowActionPlay = Action & {
+  __actionName: 'BRICK_SLIDESHOW_PLAY'
+}
+
+/* Pause the slideshow */
+export type BrickSlideshowActionPause = Action & {
+  __actionName: 'BRICK_SLIDESHOW_PAUSE'
+}
+
+/* Go to next slide */
+export type BrickSlideshowActionNext = Action & {
+  __actionName: 'BRICK_SLIDESHOW_NEXT'
+}
+
+/* Go to previous slide */
+export type BrickSlideshowActionPrev = Action & {
+  __actionName: 'BRICK_SLIDESHOW_PREV'
+}
+
 interface BrickSlideshowDef {
   /*
 Default property:
@@ -41,17 +61,28 @@ Default property:
   "countdown": 2000,
   "loop": true,
   "shuffle": false,
+  "photoResizeMode": "contain",
+  "photoLoadSystemIos": "auto",
+  "photoLoadSystemAndroid": "auto",
+  "videoResizeMode": "contain",
+  "videoAutoAspectRatio": false,
   "videoVolume": 100,
+  "videoMuted": false,
+  "videoRenderMode": "auto",
+  "fadeDuration": 0,
   "emptyViewText": "no available image item to show",
   "emptyViewTextSize": 44,
   "emptyViewTextColor": "#fff",
+  "enableBlurBackground": false,
   "blurBackgroundRadius": 8
 }
   */
   property?: BrickBasicProperty & {
     /* The time interval of show for each photo */
     countdown?: number | DataLink
-    /* The slideshow media path list (File, URL) */
+    /* The slideshow media path list (File, URL)  
+ Each path object can override global photo/video settings.  
+ Item-level properties take precedence over brick-level properties. */
     paths?:
       | Array<
           | DataLink
@@ -70,7 +101,8 @@ Default property:
             }
         >
       | DataLink
-    /* Multiple slideshow media path lists to combine (Array of path arrays) */
+    /* Multiple slideshow media path lists to combine (Array of path arrays).  
+ All arrays are flattened and combined: [...paths, ...pathsList[0], ...pathsList[1], ...] */
     pathsList?: Array<Array<any> | DataLink | DataLink> | DataLink
     /* Loop the slideshow */
     loop?: boolean | DataLink
@@ -122,6 +154,8 @@ Default property:
     roundEnd?: Array<EventAction>
     /* Event of the slideshow on load */
     mediaOnLoad?: Array<EventAction>
+    /* Event of the slideshow media loading error */
+    mediaOnError?: Array<EventAction>
   }
   animation?: AnimationBasicEvents & {
     changeStart?: Animation
@@ -129,6 +163,7 @@ Default property:
     contentChange?: Animation
     roundEnd?: Animation
     mediaOnLoad?: Animation
+    mediaOnError?: Animation
   }
 }
 

package/types/bricks/WebView.ts

@@ -75,7 +75,7 @@ Default property:
     /* The WebView content URL */
     url?: string | DataLink
     /* The request headers to load content */
-    headers?: {} | DataLink
+    headers?: Record<string, string | DataLink> | DataLink
     /* The request UserAgent */
     userAgent?: string | DataLink
     /* The webview content HTML (Use `url` first) */
@@ -100,7 +100,7 @@ Default property:
     cacheEnabled?: boolean | DataLink
     /* Enable Geolocation */
     geolocationEnabled?: boolean | DataLink
-    /* Enable Third Party Cooikies */
+    /* Enable Third Party Cookies */
     thirdPartyCookiesEnabled?: boolean | DataLink
     /* Enable JavaScript */
     javaScriptEnabled?: boolean | DataLink

package/types/generators/CanvasMap.ts

@@ -31,10 +31,21 @@ Default property:
         >
       | DataLink
   }
-  outlets?: {}
+  events?: {
+    /* Event triggered when a rule matches and canvas navigation occurs */
+    onNavigate?: Array<EventAction>
+  }
+  outlets?: {
+    /* Last matched trigger rule that caused canvas navigation */
+    lastMatchedRule?: () => Data
+    /* Index of the last matched rule in triggerList */
+    lastMatchedIndex?: () => Data
+    /* Total count of canvas navigations triggered by this generator */
+    navigationCount?: () => Data
+  }
 }
 
-/* Trigger change canvas by setup rules */
+/* Trigger canvas navigation by setup rules */
 export type GeneratorCanvasMap = Generator &
   GeneratorCanvasMapDef & {
     templateKey: 'GENERATOR_CANVAS_MAP'
@@ -48,7 +59,7 @@ export type GeneratorCanvasMap = Generator &
               | SwitchCondData
               | {
                   __typename: 'SwitchCondInnerStateOutlet'
-                  outlet: ''
+                  outlet: 'lastMatchedRule' | 'lastMatchedIndex' | 'navigationCount'
                   value: any
                 }
           }>

package/types/generators/Iterator.ts

@@ -19,6 +19,11 @@ export type GeneratorIteratorActionPrevious = Action & {
   __actionName: 'GENERATOR_ITERATOR_PREVIOUS'
 }
 
+/* Jump to the first iteration element */
+export type GeneratorIteratorActionFirst = Action & {
+  __actionName: 'GENERATOR_ITERATOR_FIRST'
+}
+
 /* Jump to the last iteration element (ignoring the loop setting) */
 export type GeneratorIteratorActionLast = Action & {
   __actionName: 'GENERATOR_ITERATOR_LAST'
@@ -39,13 +44,13 @@ Default property:
 }
   */
   property?: {
-    /* Data source for iteration. If it's an Array, it will iterate through elements. If it's an Object, it will use Object.values() as data source. If it's a String, it will iterate through characters. If it's a Number, it represents count from 1 to N. */
+    /* Data source for iteration. If it's an Array, it will iterate through elements. If it's an Object, it will use Object.entries() to get key-value pairs. If it's a String, it will iterate through characters. If it's a Number, it represents count from 1 to N. */
     data?: any
     /* Starting element position */
     start?: number | DataLink
     /* Step size for each iteration */
     step?: number | DataLink
-    /* Maximum number of iterations (can be set to -1 for unlimited) */
+    /* Maximum number of iterations (can be set to -1 for unlimited). When reached, further iteration actions will be silently ignored. */
     maxQuantity?: number | DataLink
     /* Whether to loop the iteration */
     loop?: boolean | DataLink
@@ -57,6 +62,8 @@ Default property:
     first?: Array<EventAction>
     /* Event triggered on the last iteration of a round */
     end?: Array<EventAction>
+    /* Event triggered when data type is invalid or unexpected */
+    error?: Array<EventAction>
   }
   outlets?: {
     /* Elements that have been iterated (including current one) */

package/types/generators/Keyboard.ts

@@ -15,6 +15,7 @@ Default property:
 {
   "enabled": true,
   "keyMap": {},
+  "keyOutletPrefer": "auto",
   "batchStopKeys": [
     13
   ],
@@ -24,15 +25,18 @@ Default property:
   property?: {
     /* Enable listening for input */
     enabled?: boolean | DataLink
-    /* Key map to transform key or key code to the designated content (e.g. { 37: 'left' }) */
+    /* Key map to transform key or key code to the designated content  
+ Example: { 37: 'left', 38: 'up', 39: 'right', 40: 'down', 'Enter': 'confirm' }  
+ Supports both key codes (numbers) and key names (strings) as keys */
     keyMap?: {} | DataLink
     /* Key outlet preference use key code or key. */
     keyOutletPrefer?: 'auto' | 'key-code' | 'key' | DataLink
-    /* Key or code to finish continuous input */
+    /* Key or code to finish batch input  
+ Common values: 13 (Enter), 27 (Escape), 'Enter', 'Escape' */
     batchStopKeys?: Array<string | DataLink | number | DataLink | DataLink> | DataLink
-    /* Debounce time (ms) to finish continuous input */
+    /* Debounce time (ms) to finish batch input */
     batchDebounce?: number | DataLink
-    /* Maximum wait time (ms) to finish continuous input (default: unlimited) */
+    /* Maximum wait time (ms) to finish batch input (default: unlimited) */
     batchDebounceMaxWait?: number | DataLink
   }
   events?: {
@@ -40,7 +44,7 @@ Default property:
     onDown?: Array<EventAction>
     /* Event on key up */
     onUp?: Array<EventAction>
-    /* Event on continuous input complete */
+    /* Event on batch input complete */
     onBatch?: Array<EventAction>
   }
   outlets?: {
@@ -52,7 +56,7 @@ Default property:
     lastKeyUp?: () => Data
     /* Modifier key information on last key release */
     lastKeyUpFlags?: () => Data
-    /* Last continuous event */
+    /* Last batch event */
     lastBatchEvents?: () => Data
   }
 }

package/types/generators/LlmOnnx.ts

@@ -33,6 +33,11 @@ export type GeneratorOnnxLLMActionInfer = ActionWithParams & {
         value?: Array<any> | DataLink | EventProperty
         mapping?: string
       }
+    | {
+        input: 'audios'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
     | {
         input: 'tools'
         value?: Array<any> | DataLink | EventProperty
@@ -99,6 +104,8 @@ Default property:
     messages?: Array<DataLink | {}> | DataLink
     /* Images with message to inference */
     images?: Array<string | DataLink> | DataLink
+    /* Audios with message to inference */
+    audios?: Array<string | DataLink> | DataLink
     /* Tool call parser */
     toolCallParser?: 'llama3_json' | 'mistral' | 'hermes' | 'internlm' | 'phi4' | DataLink
     /* Tools for chat mode using OpenAI-compatible function calling format  

package/types/generators/SqLite.ts

@@ -53,6 +53,33 @@ export type GeneratorSqliteActionQuery = ActionWithParams & {
   >
 }
 
+/* Execute multiple SQL statements in transaction */
+export type GeneratorSqliteActionTransaction = ActionWithParams & {
+  __actionName: 'GENERATOR_SQLITE_TRANSACTION'
+  params?: Array<{
+    input: 'statements'
+    value?: Array<any> | DataLink | EventProperty
+    mapping?: string
+  }>
+}
+
+/* Execute same SQL statement with multiple parameter sets */
+export type GeneratorSqliteActionBatchExecute = ActionWithParams & {
+  __actionName: 'GENERATOR_SQLITE_BATCH_EXECUTE'
+  params?: Array<
+    | {
+        input: 'sql'
+        value?: string | DataLink | EventProperty
+        mapping?: string
+      }
+    | {
+        input: 'batchParams'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
+  >
+}
+
 interface GeneratorSqliteDef {
   /*
 Default property:
@@ -92,6 +119,8 @@ Default property:
     error?: () => Data
     /* Last query result */
     lastResult?: () => Data
+    /* Last execute result with metadata */
+    lastExecuteResult?: () => Data
   }
 }
 
@@ -109,7 +138,7 @@ export type GeneratorSqlite = Generator &
               | SwitchCondData
               | {
                   __typename: 'SwitchCondInnerStateOutlet'
-                  outlet: 'isReady' | 'dbPath' | 'error' | 'lastResult'
+                  outlet: 'isReady' | 'dbPath' | 'error' | 'lastResult' | 'lastExecuteResult'
                   value: any
                 }
           }>

package/types/generators/Tick.ts

@@ -49,6 +49,8 @@ Default property:
   outlets?: {
     /* Countdown step value */
     countdown?: () => Data
+    /* Is tick running? */
+    running?: () => Data
   }
 }
 
@@ -66,7 +68,7 @@ export type GeneratorTick = Generator &
               | SwitchCondData
               | {
                   __typename: 'SwitchCondInnerStateOutlet'
-                  outlet: 'countdown'
+                  outlet: 'countdown' | 'running'
                   value: any
                 }
           }>

package/types/generators/WebCrawler.ts

@@ -29,7 +29,7 @@ Default property:
     init?: boolean | DataLink
     /* URL of crawler request */
     url?: string | DataLink
-    /* Timeout of crawler request  
+    /* Method of crawler request  
 
  Platform not supported for `webview`: tvOS, Desktop, Web */
     method?: 'webview' | 'http' | DataLink

package/utils/data.ts

@@ -79,6 +79,7 @@ type SystemDataName =
   | 'systemOpenAIApiKey'
   | 'systemAnthropicApiKey'
   | 'systemGeminiApiKey'
+  | 'ggmlBackendDevices'
 
 type SystemDataInfo = {
   name: SystemDataName
@@ -468,6 +469,15 @@ export const systemDataList: Array<SystemDataInfo> = [
     type: 'string',
     value: '',
   },
+  {
+    name: 'ggmlBackendDevices',
+    id: 'PROPERTY_BANK_DATA_NODE_9e8f7a6b-5c4d-3e2f-1a0b-9c8d7e6f5a4b',
+    title: 'SYSTEM: GGML Backend Devices',
+    description: 'Available GGML backend devices with supported generators',
+    schema: { type: 'object', allowNewItem: false, allowCustomProperty: false },
+    type: 'array',
+    value: [],
+  },
 ]
 
 export const useSystemData = (name: SystemDataName): Data => {

package/utils/event-props.ts

@@ -55,6 +55,11 @@ export const templateEventPropsMap = {
       'BRICK_SLIDESHOW_PAYLOAD_VALUE', // type: number
       'BRICK_SLIDESHOW_ORIGINAL_INDEX', // type: number
     ],
+    mediaOnError: [
+      'BRICK_SLIDESHOW_ERROR_MESSAGE', // type: string
+      'BRICK_SLIDESHOW_ERROR_URL', // type: string
+      'BRICK_SLIDESHOW_ERROR_INDEX', // type: number
+    ],
   },
   BRICK_CHART: {
     onPress: [
@@ -251,7 +256,7 @@ export const templateEventPropsMap = {
       'GENERATOR_ALARM_CLOCK_CURRENT_TIME', // type: string
       'GENERATOR_ALARM_CLOCK_CURRENT_TIMESTAMP', // type: number
       'GENERATOR_ALARM_CLOCK_REASON', // type: string
-      'GENERATOR_ALARM_CLOCK_MAX_TRIGS', // type: nummber
+      'GENERATOR_ALARM_CLOCK_MAX_TRIGS', // type: number
       'GENERATOR_ALARM_CLOCK_STOP_AT', // type: string
     ],
   },
@@ -388,7 +393,16 @@ export const templateEventPropsMap = {
       'GENERATOR_WEB_SOCKET_MESSAGE', // type: any
     ],
   },
-
+  GENERATOR_CANVAS_MAP: {
+    onNavigate: [
+      'GENERATOR_CANVAS_MAP_MATCHED_RULE', // type: object
+      'GENERATOR_CANVAS_MAP_MATCHED_INDEX', // type: number
+      'GENERATOR_CANVAS_MAP_TARGET_CANVAS_ID', // type: string
+      'GENERATOR_CANVAS_MAP_TARGET_CANVAS_TITLE_LIKE', // type: string
+      'GENERATOR_CANVAS_MAP_PROPERTY_VALUE', // type: any
+      'GENERATOR_CANVAS_MAP_PREVIOUS_VALUE', // type: any
+    ],
+  },
   GENERATOR_STEP: {
     onStep: [
       'GENERATOR_STEP_PAYLOAD', // type: string
@@ -399,7 +413,21 @@ export const templateEventPropsMap = {
     iterate: [
       'GENERATOR_ITERATOR_ITERATE_VALUE', // type: any
       'GENERATOR_ITERATOR_ITERATE_KEY', // type: any
-      'GENERATOR_ITERATOR_ITERATE_INDEX', // type: string
+      'GENERATOR_ITERATOR_ITERATE_INDEX', // type: number
+    ],
+    first: [
+      'GENERATOR_ITERATOR_ITERATE_VALUE', // type: any
+      'GENERATOR_ITERATOR_ITERATE_KEY', // type: any
+      'GENERATOR_ITERATOR_ITERATE_INDEX', // type: number
+    ],
+    end: [
+      'GENERATOR_ITERATOR_ITERATE_VALUE', // type: any
+      'GENERATOR_ITERATOR_ITERATE_KEY', // type: any
+      'GENERATOR_ITERATOR_ITERATE_INDEX', // type: number
+    ],
+    error: [
+      'GENERATOR_ITERATOR_ERROR_MESSAGE', // type: string
+      'GENERATOR_ITERATOR_ERROR_DATA', // type: any
     ],
   },
   GENERATOR_WATCHDOG: {
@@ -838,7 +866,15 @@ export const templateEventPropsMap = {
       'GENERATOR_GGML_TTS_ERROR', // type: string
     ],
   },
-  GENERATOR_RERANKER: {},
+  GENERATOR_RERANKER: {
+    onContextStateChange: [
+      'GENERATOR_RERANKER_CONTEXT_STATE', // type: string
+      'GENERATOR_RERANKER_CONTEXT_DETAILS', // type: object
+    ],
+    onError: [
+      'GENERATOR_RERANKER_ERROR', // type: string
+    ],
+  },
   GENERATOR_QNN_LLM: {
     onContextStateChange: [
       'GENERATOR_QNN_LLM_CONTEXT_STATE', // type: string