@fugood/bricks-project 2.24.0-beta.33 → 2.24.0-beta.35

package/compile/index.ts

@@ -412,14 +412,21 @@ const compileTestCase = (testCase: TestCase) => ({
   pre_delay: testCase.pre_delay,
   post_delay: testCase.post_delay,
   post_delay_rule: testCase.post_delay_rule,
-  jump_cond: testCase.jump_cond.map((cond) => ({
-    type: cond.type,
-    status: cond.status,
-    variable: cond.variable,
-    operator: cond.operator,
-    value: cond.value,
-    jump_to: cond.jump_to,
-  })),
+  jump_cond: testCase.jump_cond.map((cond) => {
+    if (cond.jump_to == null) {
+      console.warn(
+        `[Warning] jump_cond is missing jump_to in test case "${testCase.name}" (${testCase.id})`,
+      )
+    }
+    return {
+      type: cond.type,
+      status: cond.status,
+      variable: cond.variable,
+      operator: cond.operator,
+      value: cond.value,
+      jump_to: cond.jump_to,
+    }
+  }),
 })
 
 /**

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.24.0-beta.33",
+  "version": "2.24.0-beta.35",
   "main": "index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "bun scripts/build.js"
   },
   "dependencies": {
-    "@fugood/bricks-cli": "^2.24.0-beta.33",
+    "@fugood/bricks-cli": "^2.24.0-beta.35",
     "@huggingface/gguf": "^0.3.2",
     "@iarna/toml": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.15.0",
@@ -24,5 +24,5 @@
   "peerDependencies": {
     "oxfmt": "^0.36.0"
   },
-  "gitHead": "f8d104d4eab5ef41b105879d97b6da4030147cf0"
+  "gitHead": "b714e309336d714fba3bb3f1a81d24fa62832fa6"
 }

package/tools/preview.ts

@@ -66,7 +66,7 @@ const useTypecheck = !values['skip-typecheck']
 
 const compile = async () => {
   if (useTypecheck) await $`bun typecheck`
-  await $`bun compile`
+  await $`bun compile.ts`
 }
 
 await compile()

package/types/automation.ts

@@ -45,7 +45,7 @@ export interface TestCaseJumpCondition {
   operator?: JumpConditionOperator
   value?: any
   // The test case to jump to (getter function for dynamic IDs or string for static IDs)
-  jump_to: string | (() => TestCase)
+  jump_to?: string | (() => TestCase)
 }
 
 /**

package/types/bricks/Camera.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Camera view with photo capture and barcode scanning capabilities
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -215,7 +218,7 @@ Default property:
   }
 }
 
-/* Camera view brick */
+/* Camera view with photo capture and barcode scanning capabilities */
 export type BrickCamera = Brick &
   BrickCameraDef & {
     templateKey: 'BRICK_CAMERA'

package/types/bricks/Chart.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Chart brick, based on [Apache ECharts](https://echarts.apache.org/en/index.html).
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/GenerativeMedia.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Generative Media brick - Generate images and videos using AI
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/Icon.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Display vector icons from bundled icon sets (FontAwesome, Material, etc.)
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -71,7 +74,7 @@ Default property:
   }
 }
 
-/* Icon brick */
+/* Display vector icons from bundled icon sets (FontAwesome, Material, etc.) */
 export type BrickIcon = Brick &
   BrickIconDef & {
     templateKey: 'BRICK_ICON'

package/types/bricks/Image.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Display images from URL or local assets with resize modes and caching
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -87,7 +90,7 @@ Default property:
   }
 }
 
-/* Image brick */
+/* Display images from URL or local assets with resize modes and caching */
 export type BrickImage = Brick &
   BrickImageDef & {
     templateKey: 'BRICK_IMAGE'

package/types/bricks/Items.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Repeating list/grid that renders child bricks for each data item
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -433,7 +436,7 @@ Default property:
   }
 }
 
-/* Brick items component */
+/* Repeating list/grid that renders child bricks for each data item */
 export type BrickItems = Brick &
   BrickItemsDef & {
     templateKey: 'BRICK_ITEMS'

package/types/bricks/Lottie.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Lottie Adobe After Effects animations brick
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/Maps.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Interactive map display with markers, regions, and user location tracking
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -231,7 +234,7 @@ Default property:
   }
 }
 
-/* Maps brick */
+/* Interactive map display with markers, regions, and user location tracking */
 export type BrickMaps = Brick &
   BrickMapsDef & {
     templateKey: 'BRICK_MAPS'

package/types/bricks/QrCode.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Generate and display QR codes from text or URL values
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -90,7 +93,7 @@ Default property:
   }
 }
 
-/* QRCode brick */
+/* Generate and display QR codes from text or URL values */
 export type BrickQrcode = Brick &
   BrickQrcodeDef & {
     templateKey: 'BRICK_QRCODE'

package/types/bricks/Rect.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Rectangle shape with customizable fill, border, radius, and shadow
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -88,7 +91,7 @@ Default property:
   }
 }
 
-/* Rect brick */
+/* Rectangle shape with customizable fill, border, radius, and shadow */
 export type BrickRect = Brick &
   BrickRectDef & {
     templateKey: 'BRICK_RECT'

package/types/bricks/RichText.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Rich text display supporting HTML content rendering
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -101,7 +104,7 @@ Default property:
   }
 }
 
-/* RichText brick */
+/* Rich text display supporting HTML content rendering */
 export type BrickRichText = Brick &
   BrickRichTextDef & {
     templateKey: 'BRICK_RICH_TEXT'

package/types/bricks/Rive.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Rive file component
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/Slideshow.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Auto-advancing slideshow of child bricks with transition effects
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -168,7 +171,7 @@ Default property:
   }
 }
 
-/* Slideshow brick */
+/* Auto-advancing slideshow of child bricks with transition effects */
 export type BrickSlideshow = Brick &
   BrickSlideshowDef & {
     templateKey: 'BRICK_SLIDESHOW'

package/types/bricks/Svg.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * SVG is an XML-based vector image format for 2D graphics
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/Text.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Display styled text with font, color, alignment, and truncation controls
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -121,7 +124,7 @@ Default property:
   }
 }
 
-/* Text brick */
+/* Display styled text with font, color, alignment, and truncation controls */
 export type BrickText = Brick &
   BrickTextDef & {
     templateKey: 'BRICK_TEXT'

package/types/bricks/TextInput.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Editable text input field with keyboard type, placeholder, and validation support
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -213,7 +216,7 @@ Default property:
   }
 }
 
-/* Text Input brick */
+/* Editable text input field with keyboard type, placeholder, and validation support */
 export type BrickTextInput = Brick &
   BrickTextInputDef & {
     templateKey: 'BRICK_TEXT_INPUT'

package/types/bricks/Video.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Video playback with play/pause controls and streaming support
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -148,7 +151,7 @@ Default property:
   }
 }
 
-/* Video brick */
+/* Video playback with play/pause controls and streaming support */
 export type BrickVideo = Brick &
   BrickVideoDef & {
     templateKey: 'BRICK_VIDEO'

package/types/bricks/VideoStreaming.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Brick video streaming component, supports RTSP / RTMP streaming.
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/bricks/WebRtcStream.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Display WebRTC video/audio stream from a WebRTC generator connection
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'
@@ -38,7 +41,7 @@ Default property:
   }
 }
 
-/* WebRTCStream brick */
+/* Display WebRTC video/audio stream from a WebRTC generator connection */
 export type BrickWebRTCStream = Brick &
   BrickWebRTCStreamDef & {
     templateKey: 'BRICK_WEBRTC_STREAM'

package/types/bricks/WebView.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * WebView brick
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type { Animation, AnimationBasicEvents } from '../animation'

package/types/generators/AlarmClock.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Schedule events using cron expressions (e.g. daily, hourly)
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -81,7 +84,7 @@ Default property:
   }
 }
 
-/* Execute event by cron tab */
+/* Schedule events using cron expressions (e.g. daily, hourly) */
 export type GeneratorAlarmClock = Generator &
   GeneratorAlarmClockDef & {
     templateKey: 'GENERATOR_ALARM_CLOCK'

package/types/generators/Assistant.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * AI assistant orchestrator combining LLM, STT, TTS, and tool-use into a conversational agent
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -585,7 +588,7 @@ Default property:
   }
 }
 
-/* AI Assistant */
+/* AI assistant orchestrator combining LLM, STT, TTS, and tool-use into a conversational agent */
 export type GeneratorAssistant = Generator &
   GeneratorAssistantDef & {
     templateKey: 'GENERATOR_ASSISTANT'

package/types/generators/BleCentral.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Bluetooth Low Energy central: scan, connect, and communicate with BLE peripherals
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -212,7 +215,7 @@ Default property:
   }
 }
 
-/* BLE Central Mode Generator */
+/* Bluetooth Low Energy central: scan, connect, and communicate with BLE peripherals */
 export type GeneratorBleCentral = Generator &
   GeneratorBleCentralDef & {
     templateKey: 'GENERATOR_BLE_CENTRAL'

package/types/generators/BlePeripheral.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Bluetooth Low Energy peripheral: advertise services and respond to central connections
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -181,7 +184,7 @@ Default property:
   }
 }
 
-/* BLE Peripheral Mode Generator */
+/* Bluetooth Low Energy peripheral: advertise services and respond to central connections */
 export type GeneratorBlePeripheral = Generator &
   GeneratorBlePeripheralDef & {
     templateKey: 'GENERATOR_BLE_PERIPHERAL'

package/types/generators/CanvasMap.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Trigger canvas navigation by setup rules
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {

package/types/generators/CastlesPay.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Payment processing integration for Castles payment terminals
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -56,7 +59,7 @@ Default property:
   }
 }
 
-/* Castles Pay */
+/* Payment processing integration for Castles payment terminals */
 export type GeneratorCastlesPay = Generator &
   GeneratorCastlesPayDef & {
     templateKey: 'GENERATOR_CASTLES_PAY'

package/types/generators/DataBank.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Access and subscribe to shared Data properties from the project Data Bank
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -129,7 +132,7 @@ Default property:
   }
 }
 
-/* Get Data or subscribe to Data changes from Data Bank */
+/* Access and subscribe to shared Data properties from the project Data Bank */
 export type GeneratorDataBank = Generator &
   GeneratorDataBankDef & {
     templateKey: 'GENERATOR_DATA_BANK'

package/types/generators/File.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * File system operations: read, write, copy, delete, and list files
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {
@@ -366,7 +369,7 @@ Default property:
   }
 }
 
-/* File handling */
+/* File system operations: read, write, copy, delete, and list files */
 export type GeneratorFile = Generator &
   GeneratorFileDef & {
     templateKey: 'GENERATOR_FILE'

package/types/generators/GraphQl.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Execute GraphQL Query / Mutation / Subscriptions
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {

package/types/generators/Http.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * Execute HTTP requests
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {

package/types/generators/HttpServer.ts

@@ -1,4 +1,7 @@
-/* Auto generated by build script */
+/* Auto generated by build script
+ *
+ * HTTP Server
+ */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
 import type {

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 {
@@ -76,7 +79,7 @@ Default property:
   }
 }
 
-/* Show information */
+/* Display informational dialog or toast messages to the user */
 export type GeneratorInformation = Generator &
   GeneratorInformationDef & {
     templateKey: 'GENERATOR_INFORMATION'

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 {

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 {

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 {
@@ -73,7 +76,7 @@ Default property:
   }
 }
 
-/* Access keyboard (remote control) events */
+/* Listen to keyboard and remote control key events (keyDown, keyUp) */
 export type GeneratorKeyboard = Generator &
   GeneratorKeyboardDef & {
     templateKey: 'GENERATOR_KEYBOARD'

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 {

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 {