@fugood/bricks-project 2.24.0-beta.9 → 2.24.0

package/types/generators/VectorStore.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Vector database for semantic search. Supports GGML (on-device GGUF models) and OpenAI Compatible API (OpenAI/ollama/llama.cpp) as embedding sources
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Load the model (Only if source is ggml) */
 export type GeneratorVectorStoreActionModelLoad = Action & {
@@ -31,7 +35,7 @@ export type GeneratorVectorStoreActionReset = ActionWithParams & {
   }>
 }
 
-/* Insert file content with path or url, support Office / OpenOffice / PDF  
+/* Insert file content with path or url, support Office / OpenOffice / PDF
 
  PDF is not currently supprted in iOS / Android */
 export type GeneratorVectorStoreActionInsertFile = ActionWithParams & {
@@ -161,13 +165,13 @@ Default property:
     ggmlContextSize?: number | DataLink
     /* Pooling type of ggml model */
     ggmlPoolingType?: 'none' | 'mean' | 'cls' | 'last' | 'rank' | DataLink
-    /* GGML accelerator variant (Only for desktop)  
+    /* GGML accelerator variant (Only for desktop)
  `default` - CPU / Metal (macOS)  
  `vulkan` - Use Vulkan  
  `cuda` - Use CUDA  
  `snapdragon` - Use OpenCL/Hexagon of Qualcomm Snapdragon */
     ggmlAccelVariant?: 'default' | 'vulkan' | 'cuda' | 'snapdragon' | DataLink
-    /* Devices. For example:  
+    /* Devices. For example:
   
  Metal or CPU for iOS/tvOS/MacOS  
  OpenCL or CPU for Android  
@@ -197,23 +201,40 @@ Default property:
   }
   events?: {
     /* Event triggered when error occurs */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['VectorStore']['onError']>>
   }
   outlets?: {
     /* undefined */
-    isReady?: () => Data
+    isReady?: () => Data<boolean>
     /* Whether the embedding is processing */
-    processing?: () => Data
+    processing?: () => Data<boolean>
     /* Progress of embedding processing */
-    processProgress?: () => Data
+    processProgress?: () => Data<{
+      chunking?: number
+      embedding?: number
+      writing?: number
+      [key: string]: any
+    }>
     /* Files inserted to embedding */
-    files?: () => Data
+    files?: () => Data<Array<string>>
     /* Search result */
-    searchResult?: () => Data
+    searchResult?: () => Data<
+      Array<{
+        sessionId?: string
+        payload?: { [key: string]: any }
+        filename?: string
+        text?: string
+        textTokenSize?: number
+        fileTokenPos?: number
+        fileTokenLength?: number
+        distance?: number
+        [key: string]: any
+      }>
+    >
   }
 }
 
-/* Vector Store - File embeddings & search */
+/* Vector database for semantic search. Supports GGML (on-device GGUF models) and OpenAI Compatible API (OpenAI/ollama/llama.cpp) as embedding sources */
 export type GeneratorVectorStore = Generator &
   GeneratorVectorStoreDef & {
     templateKey: 'GENERATOR_VECTOR_STORE'

package/types/generators/Watchdog.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Trigger event with timeout by listening to specified events
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Reset watch */
 export type GeneratorWatchdogActionResetWatch = Action & {
@@ -52,25 +56,30 @@ Default property:
   }
   events?: {
     /* Event on specific sender id trigger event */
-    onEvent?: Array<EventAction>
+    onEvent?: Array<EventAction<string & keyof TemplateEventPropsMap['Watchdog']['onEvent']>>
     /* Event on timeout */
-    onTimeout?: Array<EventAction>
+    onTimeout?: Array<EventAction<string & keyof TemplateEventPropsMap['Watchdog']['onTimeout']>>
   }
   outlets?: {
     /* The last event */
-    lastEvent?: () => Data
+    lastEvent?: () => Data<{
+      id?: string
+      type?: string
+      triggerType?: string
+      timeout?: number
+    }>
     /* The type fo last event */
-    lastEventType?: () => Data
+    lastEventType?: () => Data<string>
     /* The trigger type of last event */
-    lastEventTriggerType?: () => Data
+    lastEventTriggerType?: () => Data<string>
     /* The sender id of last event */
-    lastEventSenderId?: () => Data
+    lastEventSenderId?: () => Data<string>
     /* Is timed out */
-    isTimedOut?: () => Data
+    isTimedOut?: () => Data<boolean>
   }
 }
 
-/* Triger event with timeout by listen specified events */
+/* Trigger event with timeout by listening to specified events */
 export type GeneratorWatchdog = Generator &
   GeneratorWatchdogDef & {
     templateKey: 'GENERATOR_WATCHDOG'

package/types/generators/WebCrawler.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Extract web content via CSS selectors. Supports WebView method (iOS/Android, renders JS) and HTTP method (all platforms, direct request)
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Run Crawler request with defined properties */
 export type GeneratorWebCrawlerActionRunRequest = Action & {
@@ -31,7 +35,7 @@ Default property:
     init?: boolean | DataLink
     /* URL of crawler request */
     url?: string | DataLink
-    /* Method of crawler request  
+    /* Method of crawler request
 
  Platform not supported for `webview`: tvOS, Desktop, Web */
     method?: 'webview' | 'http' | DataLink
@@ -68,15 +72,15 @@ Default property:
   }
   outlets?: {
     /* Response for CRAWLER request (selector) */
-    response?: () => Data
+    response?: () => Data<string>
     /* Responses for CRAWLER request (selectorList) */
-    responseList?: () => Data
+    responseList?: () => Data<Array<any>>
     /* The error response of CRAWLER request,  it will save to property bank */
-    error?: () => Data
+    error?: () => Data<string>
   }
 }
 
-/* Web crawler to get specific value */
+/* Extract web content via CSS selectors. Supports WebView method (iOS/Android, renders JS) and HTTP method (all platforms, direct request) */
 export type GeneratorWebCrawler = Generator &
   GeneratorWebCrawlerDef & {
     templateKey: 'GENERATOR_WEB_CRAWLER'

package/types/generators/WebRtc.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * WebRTC peer connection for real-time audio/video/data communication
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Initiate WebRTC request */
 export type GeneratorWebRTCActionInitiate = Action & {
@@ -63,7 +67,7 @@ Default property:
     localVideoTarget?: string | DataLink | (() => Brick)
     /* Target remote WebRTC stream brick ID */
     remoteVideoTarget?: string | DataLink | (() => Brick)
-    /* ICE Server list  
+    /* ICE Server list
   Default use Google public STUN servers if not setted. */
     iceServers?:
       | Array<
@@ -89,7 +93,7 @@ Default property:
     videoWidth?: number | DataLink
     /* Label of data channel */
     dataChannelLabel?: string | DataLink
-    /* Input signal for create peer connection  
+    /* Input signal for create peer connection
   Signal Types:  
   `initiate`: Initiate a WebRTC call  
   `offer`: WebRTC SDP offer  
@@ -102,41 +106,51 @@ Default property:
   }
   events?: {
     /* Event of signal update */
-    onSignalUpdate?: Array<EventAction>
+    onSignalUpdate?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['Webrtc']['onSignalUpdate']>
+    >
     /* Event of peer connected */
     onConnected?: Array<EventAction>
     /* Event of peer disconnected */
     onDisconnected?: Array<EventAction>
     /* Event of handshake error */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['Webrtc']['onError']>>
     /* Event of data channel open */
     onChannelOpen?: Array<EventAction>
     /* Event of data channel close */
     onChannelClose?: Array<EventAction>
     /* Event of received message on data channel */
-    onChannelMessage?: Array<EventAction>
+    onChannelMessage?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['Webrtc']['onChannelMessage']>
+    >
   }
   outlets?: {
     /* Signal to create peer connection */
-    signal?: () => Data
+    signal?: () => Data<any>
     /* Local SDP offer */
-    sdpOffer?: () => Data
+    sdpOffer?: () => Data<{
+      type?: string
+      sdp?: string
+    }>
     /* Local SDP answer */
-    sdpAnswer?: () => Data
+    sdpAnswer?: () => Data<{
+      type?: string
+      sdp?: string
+    }>
     /* Peer connection state */
-    connectionState?: () => Data
+    connectionState?: () => Data<string>
     /* ICE connection state */
-    iceConnectionState?: () => Data
+    iceConnectionState?: () => Data<string>
     /* Signaling state */
-    signalingState?: () => Data
+    signalingState?: () => Data<string>
     /* Last message from data channel */
-    lastChannelMessage?: () => Data
+    lastChannelMessage?: () => Data<string>
     /* Error message */
-    errorMessage?: () => Data
+    errorMessage?: () => Data<string>
   }
 }
 
-/* WebRTC */
+/* WebRTC peer connection for real-time audio/video/data communication */
 export type GeneratorWebRTC = Generator &
   GeneratorWebRTCDef & {
     templateKey: 'GENERATOR_WEBRTC'

package/types/generators/WebSocket.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * WebSocket or Socket.IO Generator
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +13,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Connect */
 export type GeneratorWebSocketActionConnect = Action & {
@@ -105,19 +109,19 @@ Default property:
     /* Event for disconnect from server */
     onClose?: Array<EventAction>
     /* Event for receive message */
-    onMessage?: Array<EventAction>
+    onMessage?: Array<EventAction<string & keyof TemplateEventPropsMap['WebSocket']['onMessage']>>
     /* Event for error occurred */
     onError?: Array<EventAction>
   }
   outlets?: {
     /* Show socket.io connected or not */
-    readyState?: () => Data
+    readyState?: () => Data<string>
     /* Results of each countdown change,  it will save to Data */
-    message?: () => Data
+    message?: () => Data<any>
     /* When Socket.IO mode server can response acknowledgemnt with data to client */
-    acknowledgeData?: () => Data
+    acknowledgeData?: () => Data<{ [key: string]: any }>
     /* Error message */
-    errorMessage?: () => Data
+    errorMessage?: () => Data<string>
   }
 }
 

package/types/generators/index.ts

@@ -44,7 +44,9 @@ export * from './RealtimeTranscription'
 export * from './LlmGgml'
 export * from './TextToSpeechGgml'
 export * from './RerankerGgml'
+export * from './LlmMlx'
 export * from './LlmQualcommAiEngine'
+export * from './LlmMediaTekNeuroPilot'
 export * from './LlmOpenAiCompat'
 export * from './TextToSpeechOpenAiLike'
 export * from './LlmAnthropicCompat'

package/types/subspace.ts

@@ -9,6 +9,9 @@ export type Subspace = {
   id: string
   title: string
   description?: string
+  hideShortRef?: boolean
+  unused?: boolean
+  portal?: 'top' | 'left' | 'bottom' | 'right'
   // Unexpanded information in Editor
   unexpanded?: {
     data?: boolean
@@ -20,6 +23,7 @@ export type Subspace = {
   module?: {
     id: string
     version: string
+    link?: boolean
     selectedRequirements?: Array<{
       subspace: SubspaceID
       id: string

package/types/system.ts

@@ -276,7 +276,7 @@ export type SystemActionPopupReset = ActionWithParams & {
   >
 }
 
-/* Take screenshot for current subspace */
+/* Take screenshot for current subspace or the full viewport (including portal subspaces) */
 export type SystemActionTakeScreenshot = ActionWithParams & {
   __actionName: 'TAKE_SCREENSHOT'
   params?: Array<