@fugood/bricks-project 2.24.6 → 2.24.7

package/compile/action-name-map.ts

@@ -899,10 +899,12 @@ export const templateActionNameMap = {
     GENERATOR_APPLE_STT_TRANSCRIBE_FILE: {
       fileUrl: 'GENERATOR_APPLE_STT_FILE_URL',
       language: 'GENERATOR_APPLE_STT_LANGUAGE',
+      contextualStrings: 'GENERATOR_APPLE_STT_CONTEXTUAL_STRINGS',
     },
     GENERATOR_APPLE_STT_TRANSCRIBE_DATA: {
       data: 'GENERATOR_APPLE_STT_DATA',
       language: 'GENERATOR_APPLE_STT_LANGUAGE',
+      contextualStrings: 'GENERATOR_APPLE_STT_CONTEXTUAL_STRINGS',
     },
   },
   GENERATOR_APPLE_TTS: {

package/compile/index.ts

@@ -511,9 +511,10 @@ const compileKind = (kind: Data['kind']) => {
 }
 
 const compileRemoteUpdate = (remoteUpdate: Data['remoteUpdate']) => {
-  if (!remoteUpdate) return {}
-  if (remoteUpdate.type === 'auto') return { enable_remote_update: true }
+  if (!remoteUpdate) return { bank_type: 'none' }
+  if (remoteUpdate.type === 'auto') return { bank_type: 'create', enable_remote_update: true }
   return {
+    bank_type: remoteUpdate.type === 'device-specific' ? 'create-device-specific' : 'global',
     enable_remote_update: true,
     ...(remoteUpdate.type === 'device-specific' ? { use_remote_id_prefix: true } : {}),
     ...(remoteUpdate.type === 'global-data' ? { global_remote_update_prop: remoteUpdate.id } : {}),

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.24.6",
+  "version": "2.24.7",
   "main": "index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "bun scripts/build.js"
   },
   "dependencies": {
-    "@fugood/bricks-cli": "^2.24.6",
+    "@fugood/bricks-cli": "^2.24.7",
     "@huggingface/gguf": "^0.3.2",
     "@iarna/toml": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.15.0",

package/skills/bricks-ctor/SKILL.md

@@ -11,24 +11,24 @@ This skill covers advanced BRICKS features not in the main project instructions.
 
 | Rule | Description |
 |------|-------------|
-| [Architecture Patterns](rules/architecture-patterns.md) | **Read first** — decompose flows and select patterns |
-| [Animation](rules/animation.md) | Animation system for brick transforms and opacity |
-| [Standby Transition](rules/standby-transition.md) | Canvas enter/exit animations |
-| [Automations](rules/automations.md) | E2E testing and scheduled tasks |
-| [Data Calculation](rules/data-calculation.md) | JS sandbox libraries (25+ available) |
-| [Local Sync](rules/local-sync.md) | LAN device synchronization |
-| [Remote Data Bank](rules/remote-data-bank.md) | Cloud data sync and API access |
-| [Media Flow](rules/media-flow.md) | Media asset management |
-| [Buttress](rules/buttress.md) | Remote inference for AI generators |
-| [Verification Toolchain](rules/verification-toolchain.md) | Definition of done, compile, preview tool selection, on-device DevTools, Path 1/2/3 decision rule |
+| [Architecture Patterns](references/architecture-patterns.md) | **Read first** — decompose flows and select patterns |
+| [Animation](references/animation.md) | Animation system for brick transforms and opacity |
+| [Standby Transition](references/standby-transition.md) | Canvas enter/exit animations |
+| [Automations](references/automations.md) | E2E testing and scheduled tasks |
+| [Data Calculation](references/data-calculation.md) | JS sandbox libraries (25+ available) |
+| [Local Sync](references/local-sync.md) | LAN device synchronization |
+| [Remote Data Bank](references/remote-data-bank.md) | Cloud data sync and API access |
+| [Media Flow](references/media-flow.md) | Media asset management |
+| [Buttress](references/buttress.md) | Remote inference for AI generators |
+| [Verification Toolchain](references/verification-toolchain.md) | Definition of done, compile, preview tool selection, on-device DevTools, Path 1/2/3 decision rule |
 
 ## Quick Reference
 
-- **Complex flows**: See [Architecture Patterns](rules/architecture-patterns.md) for decomposing multi-step workflows
-- **Multi-device**: See [Local Sync](rules/local-sync.md) for LAN coordination
-- **Cloud data**: See [Remote Data Bank](rules/remote-data-bank.md) for sync and API access
-- **Media assets**: See [Media Flow](rules/media-flow.md) for centralized asset management
-- **AI offloading**: See [Buttress](rules/buttress.md) for GPU server delegation
-- **E2E testing**: See [Automations](rules/automations.md) for test automation
-- **Enter animations**: See [Standby Transition](rules/standby-transition.md) for canvas transitions
-- **Verification before done**: See [Verification Toolchain](rules/verification-toolchain.md) for the definition-of-done gate and Path 1/2/3 decision rule
+- **Complex flows**: See [Architecture Patterns](references/architecture-patterns.md) for decomposing multi-step workflows
+- **Multi-device**: See [Local Sync](references/local-sync.md) for LAN coordination
+- **Cloud data**: See [Remote Data Bank](references/remote-data-bank.md) for sync and API access
+- **Media assets**: See [Media Flow](references/media-flow.md) for centralized asset management
+- **AI offloading**: See [Buttress](references/buttress.md) for GPU server delegation
+- **E2E testing**: See [Automations](references/automations.md) for test automation
+- **Enter animations**: See [Standby Transition](references/standby-transition.md) for canvas transitions
+- **Verification before done**: See [Verification Toolchain](references/verification-toolchain.md) for the definition-of-done gate and Path 1/2/3 decision rule

package/types/generators/LlmGgml.d.ts

@@ -11,6 +11,8 @@
  *    - Supported Hexagon NPU for Qualcomm Snapdragon 8 Gen 1+ GPUs.
  *  - Linux / Windows  [@nextline    - Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property
  *    - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux)
+ *  - Web: Supported with CPU and WebGPU acceleration.
+ *    - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable.
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -863,7 +865,9 @@ Default property:
    - Supported GPU acceleration by OpenCL, currently only for Qualcomm Adreno 700+ GPUs, other GPUs are not supported.  
    - Supported Hexagon NPU for Qualcomm Snapdragon 8 Gen 1+ GPUs.  
  - Linux / Windows  [@nextline    - Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property  
-   - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux) */
+   - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux)  
+ - Web: Supported with CPU and WebGPU acceleration.  
+   - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable. */
 export type GeneratorLLM = Generator &
   GeneratorLLMDef & {
     templateKey: 'GENERATOR_LLM'

package/types/generators/RerankerGgml.d.ts

@@ -12,6 +12,8 @@
  *  - Linux / Windows
  *    - Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property
  *    - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux)
+ *  - Web: Supported with CPU and WebGPU acceleration.
+ *    - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable.
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -163,7 +165,9 @@ Default property:
    - Supported Hexagon NPU for Qualcomm Snapdragon 8 Gen 2+ GPUs.  
  - Linux / Windows  
    - Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property  
-   - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux) */
+   - Supported Hexagon NPU for Qualcomm Dragonwing IQ9 series+ (Linux)  
+ - Web: Supported with CPU and WebGPU acceleration.  
+   - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable. */
 export type GeneratorReranker = Generator &
   GeneratorRerankerDef & {
     templateKey: 'GENERATOR_RERANKER'

package/types/generators/SoundRecorder.d.ts

@@ -54,7 +54,8 @@ Default property:
   "autoCuttingVocalFreqMin": 75,
   "autoCuttingVocalFreqMax": 900,
   "autoCuttingFreqClarity": 0.5,
-  "autoCuttingSpeakSpacing": 0.5
+  "autoCuttingSpeakSpacing": 0.5,
+  "userMediaAudioOptions": {}
 }
   */
   property?: {
@@ -86,6 +87,14 @@ Default property:
     autoCuttingVolumeThreshold?: number | DataLink
     /* Speak spacing of cutting fragments */
     autoCuttingSpeakSpacing?: number | DataLink
+    /* Custom getUserMedia audio options for Web / Desktop. Merged into the audio constraints. */
+    userMediaAudioOptions?:
+      | DataLink
+      | {
+          autoGainControl?: boolean | DataLink
+          echoCancellation?: boolean | DataLink
+          noiseSuppression?: boolean | DataLink
+        }
   }
   events?: {
     /* Event for chunk data (Base64 encoded PCM) */

package/types/generators/SpeechToTextGgml.d.ts

@@ -7,6 +7,8 @@
  *  - macOS: Supported GPU acceleration, recommended use M1+ chip device
  *  - Android: Currently not supported GPU acceleration (Coming soon), recommended use Android 13+ system
  *  - Linux / Windows: Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property
+ *  - Web: Supported with WASM CPU and optional WebGPU acceleration in Web Preview.
+ *    - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable.
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -389,7 +391,9 @@ Default property:
  - iOS: Supported GPU acceleration, recommended use M1+ / A17+ chip device  
  - macOS: Supported GPU acceleration, recommended use M1+ chip device  
  - Android: Currently not supported GPU acceleration (Coming soon), recommended use Android 13+ system  
- - Linux / Windows: Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property */
+ - Linux / Windows: Supported GPU acceleration, you can choose `vulkan` or `cuda` backend in Accel Variant property  
+ - Web: Supported with WASM CPU and optional WebGPU acceleration in Web Preview.  
+   - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable. */
 export type GeneratorSpeechInference = Generator &
   GeneratorSpeechInferenceDef & {
     templateKey: 'GENERATOR_SPEECH_INFERENCE'

package/types/generators/SttAppleBuiltin.d.ts

@@ -1,13 +1,13 @@
 /* Auto generated by build script
  *
- * Speech recognition on iOS 26+ (Not supported on tvOS)
+ * Speech recognition on iOS 26+ and Desktop (macOS 26+). Not supported on tvOS
  *
  *  ## Features
  *  - Native Apple speech recognition
  *  - High accuracy transcription
  *  - Privacy-focused on-device processing
  *  - Supports file and data transcription
- *  - Requires iOS 26+ (Not supported on tvOS)
+ *  - Requires iOS 26+ or Desktop on macOS 26+. Not supported on tvOS
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -41,6 +41,11 @@ export type GeneratorAppleSTTActionTranscribeFile = ActionWithParams & {
         value?: string | DataLink | EventProperty
         mapping?: string
       }
+    | {
+        input: 'contextualStrings'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
   >
 }
 
@@ -58,15 +63,26 @@ export type GeneratorAppleSTTActionTranscribeData = ActionWithParams & {
         value?: string | DataLink | EventProperty
         mapping?: string
       }
+    | {
+        input: 'contextualStrings'
+        value?: Array<any> | DataLink | EventProperty
+        mapping?: string
+      }
   >
 }
 
+/* Release context */
+export type GeneratorAppleSTTActionReleaseContext = Action & {
+  __actionName: 'GENERATOR_APPLE_STT_RELEASE_CONTEXT'
+}
+
 interface GeneratorAppleSTTDef {
   /*
 Default property:
 {
   "init": false,
   "language": "en-US",
+  "contextualStrings": [],
   "enablePartialResults": true
 }
   */
@@ -75,6 +91,13 @@ Default property:
     init?: boolean | DataLink
     /* Language/locale for recognition (e.g., 'en-US') */
     language?: string | DataLink
+    /* Phrases that should be recognized, even if they are not in the system vocabulary. */
+    contextualStrings?:
+      | Array<string | DataLink>
+      | DataLink
+      | Record<string, Array<string | DataLink> | DataLink>
+      | DataLink
+      | DataLink
     /* Enable partial results during transcription */
     enablePartialResults?: boolean | DataLink
     /* The file URL or path to be transcribed */
@@ -100,14 +123,14 @@ Default property:
   }
 }
 
-/* Speech recognition on iOS 26+ (Not supported on tvOS)
+/* Speech recognition on iOS 26+ and Desktop (macOS 26+). Not supported on tvOS
 
  ## Features  
  - Native Apple speech recognition  
  - High accuracy transcription  
  - Privacy-focused on-device processing  
  - Supports file and data transcription  
- - Requires iOS 26+ (Not supported on tvOS) */
+ - Requires iOS 26+ or Desktop on macOS 26+. Not supported on tvOS */
 export type GeneratorAppleSTT = Generator &
   GeneratorAppleSTTDef & {
     templateKey: 'GENERATOR_APPLE_STT'

package/types/generators/VadGgml.d.ts

@@ -1,6 +1,11 @@
 /* Auto generated by build script
  *
- * Local Voice Activity Detection (VAD) inference based on GGML and [whisper.rn](https://github.com/mybigday/whisper.rn)
+ * Local Voice Activity Detection (VAD) inference based on GGML and [whisper.cpp](https://github.com/ggerganov/whisper.cpp)
+ *
+ *  ## Notice
+ *  - Web: Supported with WASM CPU in Web Preview.
+ *    - WebGPU is not used for browser VAD; the wasm package falls back to CPU for the VAD graph.
+ *    - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable.
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -222,7 +227,12 @@ Default property:
   }
 }
 
-/* Local Voice Activity Detection (VAD) inference based on GGML and [whisper.rn](https://github.com/mybigday/whisper.rn) */
+/* Local Voice Activity Detection (VAD) inference based on GGML and [whisper.cpp](https://github.com/ggerganov/whisper.cpp)
+
+ ## Notice  
+ - Web: Supported with WASM CPU in Web Preview.  
+   - WebGPU is not used for browser VAD; the wasm package falls back to CPU for the VAD graph.  
+   - Single thread only in the current web preview (no SharedArrayBuffer due to cross-origin isolation / CORP), so multi-thread is unavailable. */
 export type GeneratorVadInference = Generator &
   GeneratorVadInferenceDef & {
     templateKey: 'GENERATOR_VAD_INFERENCE'