@fugood/bricks-project 2.24.0-beta.4 → 2.24.0-beta.40

package/types/generators/HttpServer.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Embedded HTTP/HTTPS server with route matching, CORS, auth (Basic/Bearer), SSE streaming, file upload, and async response mode
+ */
 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'
 
 /* Start HTTP server */
 export type GeneratorHTTPServerActionStart = Action & {
@@ -70,7 +74,7 @@ Default property:
     idleTimeout?: number | DataLink
     /* HTTP request body limit, 0 is unlimited */
     bodyLimit?: number | DataLink
-    /* CORS allowed origins  
+    /* CORS allowed origins
   You can use wildcard like `*`, `*.example.com`, `http://*.example.com` */
     corsOrigins?: Array<string | DataLink> | DataLink
     /* Authorization type of HTTP request */
@@ -81,15 +85,15 @@ Default property:
     basicAuthPassword?: string | DataLink
     /* Token of bearer auth */
     bearerToken?: string | DataLink
-    /* Asynchronous response mode  
+    /* Asynchronous response mode
   Will block connection until Response Body update. */
     asyncMode?: boolean | DataLink
-    /* Save request body as file  
+    /* Save request body as file
   Only work on `application/octet-stream` or `multipart/form-data`. */
     saveBodyAsFile?: boolean | DataLink
     /* Response status code */
     resStatusCode?: number | DataLink
-    /* Response Content-Type  
+    /* Response Content-Type
   `text/*` will not convert body.  
   `application/xml` convert object to XML, [example object struct](https://github.com/davidcalhoun/jstoxml#example-10-podcast-rss-feed)  
   `application/octet-stream` body should be Base64 string or file path. */
@@ -123,33 +127,37 @@ Default property:
     /* Event of HTTP server is ready */
     onReady?: Array<EventAction>
     /* Event of HTTP server accept the request */
-    onRequest?: Array<EventAction>
+    onRequest?: Array<EventAction<string & keyof TemplateEventPropsMap['HttpServer']['onRequest']>>
     /* Event of client close connection */
-    onClientClose?: Array<EventAction>
+    onClientClose?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['HttpServer']['onClientClose']>
+    >
     /* Event of client error */
-    onClientError?: Array<EventAction>
+    onClientError?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['HttpServer']['onClientError']>
+    >
     /* Event of server close */
     onClose?: Array<EventAction>
     /* Event of server error */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['HttpServer']['onError']>>
   }
   outlets?: {
     /* Server is listening */
-    isListening?: () => Data
+    isListening?: () => Data<boolean>
     /* Query of request */
-    requestQuery?: () => Data
+    requestQuery?: () => Data<{ [key: string]: any }>
     /* Body of request */
-    requestBody?: () => Data
+    requestBody?: () => Data<any>
     /* Remote address of request */
-    clientAddress?: () => Data
+    clientAddress?: () => Data<string>
   }
 }
 
-/* HTTP Server */
+/* Embedded HTTP/HTTPS server with route matching, CORS, auth (Basic/Bearer), SSE streaming, file upload, and async response mode */
 export type GeneratorHTTPServer = Generator &
   GeneratorHTTPServerDef & {
     templateKey: 'GENERATOR_HTTP_SERVER'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorHTTPServerDef & {
           conds?: Array<{

package/types/generators/Information.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Display informational dialog or toast messages to the user
+ */
 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'
 
 /* Show information */
 export type GeneratorInformationActionShow = ActionWithParams & {
@@ -68,19 +72,19 @@ Default property:
     /* Trigger when user confirms the information */
     onConfirm?: Array<EventAction>
     /* Trigger when error occurs */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['Information']['onError']>>
   }
   outlets?: {
     /* Error message */
-    errorMessage?: () => Data
+    errorMessage?: () => Data<string>
   }
 }
 
-/* Show information */
+/* Display informational dialog or toast messages to the user */
 export type GeneratorInformation = Generator &
   GeneratorInformationDef & {
     templateKey: 'GENERATOR_INFORMATION'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorInformationDef & {
           conds?: Array<{

package/types/generators/Intent.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Send intent to app and get result (Android only)
+ */
 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'
 
 /* Read stats */
 export type GeneratorIntentActionSendIntent = ActionWithParams & {
@@ -125,13 +129,19 @@ Default property:
   }
   events?: {
     /* On intent return a result trigger */
-    onResult?: Array<EventAction>
+    onResult?: Array<EventAction<string & keyof TemplateEventPropsMap['Intent']['onResult']>>
     /* On intent error trigger */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['Intent']['onError']>>
   }
   outlets?: {
     /* Last intent result */
-    result?: () => Data
+    result?: () => Data<{
+      action?: string
+      data?: string
+      type?: string
+      extras?: { [key: string]: any }
+      [key: string]: any
+    }>
   }
 }
 
@@ -139,7 +149,7 @@ Default property:
 export type GeneratorIntent = Generator &
   GeneratorIntentDef & {
     templateKey: 'GENERATOR_INTENT'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorIntentDef & {
           conds?: Array<{

package/types/generators/Iterator.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Iterate through values (Array, Object, Number, String)
+ */
 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'
 
 /* Proceed to next iteration */
 export type GeneratorIteratorActionNext = Action & {
@@ -59,25 +63,25 @@ Default property:
   }
   events?: {
     /* Event triggered on each iteration */
-    iterate?: Array<EventAction>
+    iterate?: Array<EventAction<string & keyof TemplateEventPropsMap['Iterator']['iterate']>>
     /* Event triggered on the first iteration of a round */
-    first?: Array<EventAction>
+    first?: Array<EventAction<string & keyof TemplateEventPropsMap['Iterator']['first']>>
     /* Event triggered on the last iteration of a round */
-    end?: Array<EventAction>
+    end?: Array<EventAction<string & keyof TemplateEventPropsMap['Iterator']['end']>>
     /* Event triggered when data type is invalid or unexpected */
-    error?: Array<EventAction>
+    error?: Array<EventAction<string & keyof TemplateEventPropsMap['Iterator']['error']>>
   }
   outlets?: {
     /* Elements that have been iterated (including current one) */
-    iteratedArray?: () => Data
+    iteratedArray?: () => Data<Array<any>>
     /* Elements that will be iterated but have not been iterated yet */
-    upcomingArray?: () => Data
+    upcomingArray?: () => Data<Array<any>>
     /* Current iteration element */
-    value?: () => Data
+    value?: () => Data<any>
     /* Key of the current iteration element (for number: same as value, for array/string: index, for object: string key) */
-    key?: () => Data
+    key?: () => Data<any>
     /* Current iteration count (if data is 6 and step is 2, this will return: 1,2,3 in sequence) */
-    index?: () => Data
+    index?: () => Data<number>
   }
 }
 
@@ -85,7 +89,7 @@ Default property:
 export type GeneratorIterator = Generator &
   GeneratorIteratorDef & {
     templateKey: 'GENERATOR_ITERATOR'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorIteratorDef & {
           conds?: Array<{

package/types/generators/Keyboard.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Listen to keyboard and remote control key events (keyDown, keyUp)
+ */
 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'
 
 interface GeneratorKeyboardDef {
   /*
@@ -27,13 +31,13 @@ Default property:
   property?: {
     /* Enable listening for input */
     enabled?: boolean | DataLink
-    /* Key map to transform key or key code to the designated content  
+    /* 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 batch 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 batch input */
@@ -43,31 +47,41 @@ Default property:
   }
   events?: {
     /* Event on key press */
-    onDown?: Array<EventAction>
+    onDown?: Array<EventAction<string & keyof TemplateEventPropsMap['Keyboard']['onDown']>>
     /* Event on key up */
-    onUp?: Array<EventAction>
+    onUp?: Array<EventAction<string & keyof TemplateEventPropsMap['Keyboard']['onUp']>>
     /* Event on batch input complete */
-    onBatch?: Array<EventAction>
+    onBatch?: Array<EventAction<string & keyof TemplateEventPropsMap['Keyboard']['onBatch']>>
   }
   outlets?: {
     /* Last key code pressed */
-    lastKeyDown?: () => Data
+    lastKeyDown?: () => Data<string | number>
     /* Modifier key information on last key press */
-    lastKeyDownFlags?: () => Data
+    lastKeyDownFlags?: () => Data<{ [key: string]: any }>
     /* Last key code released */
-    lastKeyUp?: () => Data
+    lastKeyUp?: () => Data<string | number>
     /* Modifier key information on last key release */
-    lastKeyUpFlags?: () => Data
+    lastKeyUpFlags?: () => Data<{ [key: string]: any }>
     /* Last batch event */
-    lastBatchEvents?: () => Data
+    lastBatchEvents?: () => Data<
+      Array<{
+        event?: string
+        key?: any
+        keyNoMapping?: any
+        keyCode?: any
+        keyCodeNoMapping?: any
+        flags?: { [key: string]: any }
+        [key: string]: any
+      }>
+    >
   }
 }
 
-/* Access keyboard (remote control) events */
+/* Listen to keyboard and remote control key events (keyDown, keyUp) */
 export type GeneratorKeyboard = Generator &
   GeneratorKeyboardDef & {
     templateKey: 'GENERATOR_KEYBOARD'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorKeyboardDef & {
           conds?: Array<{

package/types/generators/LlmAnthropicCompat.ts

@@ -1,4 +1,13 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * LLM inference using Anthropic-compatible API endpoints
+ *
+ *  ## Features
+ *  - Compatible with Anthropic API format
+ *  - Supports function calling (tools)
+ *  - Streaming responses
+ *  - Custom API endpoints (Default to https://api.anthropic.com/v1/messages)
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +19,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Run text completion */
 export type GeneratorAnthropicLLMActionCompletion = ActionWithParams & {
@@ -119,7 +129,7 @@ Default property:
             }
         >
       | DataLink
-    /* Tools for function calling following Anthropic format  
+    /* Tools for function calling following Anthropic format
  Format: Array of objects with {name, description, input_schema} structure  
  See: https://docs.anthropic.com/en/docs/tool-use */
     completionTools?: Array<{} | DataLink> | DataLink
@@ -143,25 +153,37 @@ Default property:
   }
   events?: {
     /* Error event */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['AnthropicLlm']['onError']>>
     /* Completion event */
-    onCompletion?: Array<EventAction>
+    onCompletion?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AnthropicLlm']['onCompletion']>
+    >
     /* Completion finished event */
-    onCompletionFinished?: Array<EventAction>
+    onCompletionFinished?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AnthropicLlm']['onCompletionFinished']>
+    >
     /* Tool use event */
-    onToolUse?: Array<EventAction>
+    onToolUse?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AnthropicLlm']['onToolUse']>
+    >
   }
   outlets?: {
     /* Evaluating outlet */
-    isEvaluating?: () => Data
+    isEvaluating?: () => Data<boolean>
     /* Completion result outlet */
-    completionResult?: () => Data
+    completionResult?: () => Data<string>
     /* Completion details outlet */
-    completionDetails?: () => Data
+    completionDetails?: () => Data<{
+      model?: string
+      stop_reason?: string
+      usage?: { [key: string]: any }
+      content?: Array<any>
+      [key: string]: any
+    }>
   }
 }
 
-/* LLM inference using Anthropic-compatible API endpoints  
+/* LLM inference using Anthropic-compatible API endpoints
 
  ## Features  
  - Compatible with Anthropic API format  
@@ -171,7 +193,7 @@ Default property:
 export type GeneratorAnthropicLLM = Generator &
   GeneratorAnthropicLLMDef & {
     templateKey: 'GENERATOR_ANTHROPIC_LLM'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorAnthropicLLMDef & {
           conds?: Array<{

package/types/generators/LlmAppleBuiltin.ts

@@ -1,4 +1,14 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * LLM inference using Apple Intelligence on iOS/tvOS 26+
+ *
+ *  ## Features
+ *  - Native Apple Intelligence integration
+ *  - No model download required
+ *  - Privacy-focused on-device processing
+ *  - Optimized for Apple Silicon
+ *  - Requires iOS 26+ or tvOS 26+
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -10,6 +20,7 @@ import type {
   Action,
   EventProperty,
 } from '../common'
+import type { TemplateEventPropsMap } from '../../utils/event-props'
 
 /* Load model */
 export type GeneratorAppleLLMActionLoadModel = Action & {
@@ -90,27 +101,31 @@ Default property:
   }
   events?: {
     /* Error event */
-    onError?: Array<EventAction>
+    onError?: Array<EventAction<string & keyof TemplateEventPropsMap['AppleLlm']['onError']>>
     /* Model loaded event */
     onModelLoaded?: Array<EventAction>
     /* Completion event */
-    onCompletion?: Array<EventAction>
+    onCompletion?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AppleLlm']['onCompletion']>
+    >
     /* Completion finished event */
-    onCompletionFinished?: Array<EventAction>
+    onCompletionFinished?: Array<
+      EventAction<string & keyof TemplateEventPropsMap['AppleLlm']['onCompletionFinished']>
+    >
   }
   outlets?: {
     /* Context state outlet */
-    contextState?: () => Data
+    contextState?: () => Data<string>
     /* Evaluating outlet */
-    isEvaluating?: () => Data
+    isEvaluating?: () => Data<boolean>
     /* Completion result outlet */
-    completionResult?: () => Data
+    completionResult?: () => Data<string>
     /* Last token outlet */
-    completionLastToken?: () => Data
+    completionLastToken?: () => Data<string>
   }
 }
 
-/* LLM inference using Apple Intelligence on iOS/tvOS 26+  
+/* LLM inference using Apple Intelligence on iOS/tvOS 26+
 
  ## Features  
  - Native Apple Intelligence integration  
@@ -121,7 +136,7 @@ Default property:
 export type GeneratorAppleLLM = Generator &
   GeneratorAppleLLMDef & {
     templateKey: 'GENERATOR_APPLE_LLM'
-    switches: Array<
+    switches?: Array<
       SwitchDef &
         GeneratorAppleLLMDef & {
           conds?: Array<{