@fugood/bricks-project 2.25.0-beta.19 → 2.25.0-beta.21

package/compile/action-name-map.ts

@@ -350,6 +350,62 @@ export const templateActionNameMap = {
       strokeWidth: 'BRICK_SKETCH_STROKE_WIDTH',
     },
   },
+  BRICK_SCENE_3D: {
+    BRICK_SCENE_3D_ADD_OBJECT: {
+      objectId: 'BRICK_SCENE_3D_OBJECT_ID',
+      objectType: 'BRICK_SCENE_3D_OBJECT_TYPE',
+      objectUrl: 'BRICK_SCENE_3D_OBJECT_URL',
+      objectMd5: 'BRICK_SCENE_3D_OBJECT_MD5',
+      objectPosition: 'BRICK_SCENE_3D_OBJECT_POSITION',
+      objectRotation: 'BRICK_SCENE_3D_OBJECT_ROTATION',
+      objectScale: 'BRICK_SCENE_3D_OBJECT_SCALE',
+      objectColor: 'BRICK_SCENE_3D_OBJECT_COLOR',
+    },
+    BRICK_SCENE_3D_REMOVE_OBJECT: {
+      objectId: 'BRICK_SCENE_3D_OBJECT_ID',
+    },
+    BRICK_SCENE_3D_UPDATE_OBJECT: {
+      objectId: 'BRICK_SCENE_3D_OBJECT_ID',
+      objectPosition: 'BRICK_SCENE_3D_OBJECT_POSITION',
+      objectRotation: 'BRICK_SCENE_3D_OBJECT_ROTATION',
+      objectScale: 'BRICK_SCENE_3D_OBJECT_SCALE',
+      objectVisible: 'BRICK_SCENE_3D_OBJECT_VISIBLE',
+      objectColor: 'BRICK_SCENE_3D_OBJECT_COLOR',
+    },
+    BRICK_SCENE_3D_SET_CAMERA: {
+      cameraPosition: 'BRICK_SCENE_3D_CAMERA_POSITION',
+      cameraTarget: 'BRICK_SCENE_3D_CAMERA_TARGET',
+      cameraFov: 'BRICK_SCENE_3D_CAMERA_FOV',
+      cameraAnimateMs: 'BRICK_SCENE_3D_CAMERA_ANIMATE_MS',
+    },
+    BRICK_SCENE_3D_LOOK_AT: {
+      objectId: 'BRICK_SCENE_3D_OBJECT_ID',
+    },
+    BRICK_SCENE_3D_PLAY_ANIMATION: {
+      objectId: 'BRICK_SCENE_3D_OBJECT_ID',
+      animationName: 'BRICK_SCENE_3D_ANIMATION_NAME',
+      animationLoop: 'BRICK_SCENE_3D_ANIMATION_LOOP',
+      animationSpeed: 'BRICK_SCENE_3D_ANIMATION_SPEED',
+    },
+    BRICK_SCENE_3D_STOP_ANIMATION: {
+      objectId: 'BRICK_SCENE_3D_OBJECT_ID',
+      animationName: 'BRICK_SCENE_3D_ANIMATION_NAME',
+    },
+    BRICK_SCENE_3D_SET_BACKGROUND: {
+      backgroundColor: 'BRICK_SCENE_3D_BACKGROUND_COLOR',
+      backgroundHdrUrl: 'BRICK_SCENE_3D_BACKGROUND_HDR_URL',
+      backgroundMd5: 'BRICK_SCENE_3D_BACKGROUND_MD5',
+    },
+    BRICK_SCENE_3D_SET_CONTROLS: {
+      controlsEnabled: 'BRICK_SCENE_3D_CONTROLS_ENABLED',
+      controlsAutoRotate: 'BRICK_SCENE_3D_CONTROLS_AUTO_ROTATE',
+      controlsAutoRotateSpeed: 'BRICK_SCENE_3D_CONTROLS_AUTO_ROTATE_SPEED',
+    },
+    BRICK_SCENE_3D_SCREENSHOT: {
+      screenshotFormat: 'BRICK_SCENE_3D_SCREENSHOT_FORMAT',
+      screenshotQuality: 'BRICK_SCENE_3D_SCREENSHOT_QUALITY',
+    },
+  },
 
   GENERATOR_FILE: {
     GENERATOR_FILE_READ_CONTENT: {
@@ -782,6 +838,11 @@ export const templateActionNameMap = {
       seed: 'GENERATOR_LLM_SEED',
       typicalP: 'GENERATOR_LLM_TYPICAL_P',
       ignoreEos: 'GENERATOR_LLM_IGNORE_EOS',
+      mtpSpeculativeDecoding: 'GENERATOR_LLM_MTP_SPECULATIVE_DECODING',
+      mtpDraftTokens: 'GENERATOR_LLM_MTP_DRAFT_TOKENS',
+      mtpDraftMinTokens: 'GENERATOR_LLM_MTP_DRAFT_MIN_TOKENS',
+      mtpDraftMinProbability: 'GENERATOR_LLM_MTP_DRAFT_MIN_PROBABILITY',
+      mtpDraftSplitProbability: 'GENERATOR_LLM_MTP_DRAFT_SPLIT_PROBABILITY',
       functionCallEnabled: 'GENERATOR_LLM_FUNCTION_CALL_ENABLED',
       functionCallSchema: 'GENERATOR_LLM_FUNCTION_CALL_SCHEMA',
     },

package/compile/index.ts

@@ -154,11 +154,13 @@ const basicAnimationEvents = ['show', 'standby', 'breatheStart']
 
 const compileAnimations = (
   templateKey: string,
-  animations: { [key: string]: Animation },
+  animations: { [key: string]: Animation | (() => Animation) },
   errorReference: string,
 ) =>
   Object.entries(animations).reduce((acc, [key, animation]) => {
-    const animationId = assertEntryId(animation?.id, 'ANIMATION', errorReference)
+    // Animation events accept either a direct Animation or a getter; unwrap.
+    const resolved = typeof animation === 'function' ? animation() : animation
+    const animationId = assertEntryId(resolved?.id, 'ANIMATION', errorReference)
     acc[convertEventKey(basicAnimationEvents.includes(key) ? 'BRICK' : templateKey, key)] =
       `ANIMATION#${animationId}`
     return acc
@@ -483,6 +485,8 @@ const preloadTypes = [
   'ggml-model-asset',
   'gguf-model-asset',
   'binary-asset',
+  'mlx-model-asset',
+  'scene3d-objects',
 ]
 
 const compileKind = (kind: Data['kind']) => {

package/package.json

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

package/package.json.bak

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

package/tools/mcp-tools/compile.ts

@@ -19,6 +19,8 @@ export function register(server: McpServer, projectDir: string) {
     }
   })
 
+  if (process.env.BRICKS_CTOR_MCP_DISABLE_PREVIEW === '1') return
+
   server.tool(
     'preview',
     {

package/types/animation.ts

@@ -104,8 +104,13 @@ export interface AnimationComposeDef {
 
 export type Animation = AnimationDef | AnimationComposeDef
 
+// Animation event handlers accept either a direct Animation or a getter that
+// returns one. The getter form is useful for lazy/forward references between
+// animations defined across files.
+export type AnimationOrGetter = Animation | (() => Animation)
+
 export interface AnimationBasicEvents {
-  showStart?: Animation
-  standby?: Animation
-  breatheStart?: Animation
+  showStart?: AnimationOrGetter
+  standby?: AnimationOrGetter
+  breatheStart?: AnimationOrGetter
 }

package/types/brick-base.ts

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

package/types/bricks/Camera.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -213,13 +213,13 @@ Default property:
     faceDetected?: () => Data<Array<{ [key: string]: any }>>
   }
   animation?: AnimationBasicEvents & {
-    stateChange?: Animation
-    recordStart?: Animation
-    recordEnd?: Animation
-    barcodeRead?: Animation
-    pictureTaken?: Animation
-    recordFinish?: Animation
-    mountError?: Animation
+    stateChange?: AnimationOrGetter
+    recordStart?: AnimationOrGetter
+    recordEnd?: AnimationOrGetter
+    barcodeRead?: AnimationOrGetter
+    pictureTaken?: AnimationOrGetter
+    recordFinish?: AnimationOrGetter
+    mountError?: AnimationOrGetter
   }
 }
 

package/types/bricks/Chart.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -343,9 +343,9 @@ Default property:
     >
   }
   animation?: AnimationBasicEvents & {
-    onRender?: Animation
-    onPress?: Animation
-    onLegendSelectChanged?: Animation
+    onRender?: AnimationOrGetter
+    onPress?: AnimationOrGetter
+    onLegendSelectChanged?: AnimationOrGetter
   }
 }
 

package/types/bricks/GenerativeMedia.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -250,20 +250,20 @@ Default property:
     loading?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    generativeMediaOnPress?: Animation
-    generativeMediaOnPressIn?: Animation
-    generativeMediaOnPressOut?: Animation
-    generativeMediaOnLongPress?: Animation
-    generativeMediaOnFocus?: Animation
-    generativeMediaOnBlur?: Animation
-    onSuccess?: Animation
-    onError?: Animation
-    promptStart?: Animation
-    promptSuccess?: Animation
-    promptError?: Animation
-    loadStart?: Animation
-    loadSuccess?: Animation
-    loadError?: Animation
+    generativeMediaOnPress?: AnimationOrGetter
+    generativeMediaOnPressIn?: AnimationOrGetter
+    generativeMediaOnPressOut?: AnimationOrGetter
+    generativeMediaOnLongPress?: AnimationOrGetter
+    generativeMediaOnFocus?: AnimationOrGetter
+    generativeMediaOnBlur?: AnimationOrGetter
+    onSuccess?: AnimationOrGetter
+    onError?: AnimationOrGetter
+    promptStart?: AnimationOrGetter
+    promptSuccess?: AnimationOrGetter
+    promptError?: AnimationOrGetter
+    loadStart?: AnimationOrGetter
+    loadSuccess?: AnimationOrGetter
+    loadError?: AnimationOrGetter
   }
 }
 

package/types/bricks/Icon.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -66,12 +66,12 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
   }
 }
 

package/types/bricks/Image.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -92,14 +92,14 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
-    onLoad?: Animation
-    onError?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
+    onLoad?: AnimationOrGetter
+    onError?: AnimationOrGetter
   }
 }
 

package/types/bricks/Items.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -438,12 +438,12 @@ Default property:
     pageIsOutOfBound?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPageRender?: Animation
-    onPageChange?: Animation
-    onPageOutOfBound?: Animation
-    onIntoDetailMode?: Animation
-    onIntoListMode?: Animation
-    onError?: Animation
+    onPageRender?: AnimationOrGetter
+    onPageChange?: AnimationOrGetter
+    onPageOutOfBound?: AnimationOrGetter
+    onIntoDetailMode?: AnimationOrGetter
+    onIntoListMode?: AnimationOrGetter
+    onError?: AnimationOrGetter
   }
 }
 

package/types/bricks/Lottie.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -133,15 +133,15 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
-    onAnimationFinish?: Animation
-    onAnimationFailure?: Animation
-    onAnimationLoop?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
+    onAnimationFinish?: AnimationOrGetter
+    onAnimationFailure?: AnimationOrGetter
+    onAnimationLoop?: AnimationOrGetter
   }
 }
 

package/types/bricks/Maps.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -226,16 +226,16 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
-    onMarkerPress?: Animation
-    onMapPress?: Animation
-    onRegionChange?: Animation
-    onReady?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
+    onMarkerPress?: AnimationOrGetter
+    onMapPress?: AnimationOrGetter
+    onRegionChange?: AnimationOrGetter
+    onReady?: AnimationOrGetter
   }
 }
 

package/types/bricks/QrCode.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -85,12 +85,12 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
   }
 }
 

package/types/bricks/Rect.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -118,12 +118,12 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
   }
 }
 

package/types/bricks/RichText.ts

@@ -1,10 +1,10 @@
 /* Auto generated by build script
  *
- * Rich text with HTML content rendering, multiple fonts, colors, heading levels (h1-h6), and inline images
+ * Rich text with HTML or Markdown content rendering, multiple fonts, colors, heading levels (h1-h6), and inline images
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -23,6 +23,7 @@ Default property:
 {
   "content": "",
   "renderImage": false,
+  "renderMarkdown": false,
   "color": "#000",
   "fontWeight": "normal",
   "fontStyle": "normal",
@@ -42,6 +43,8 @@ Default property:
     content?: string | DataLink
     /* Render Image */
     renderImage?: boolean | DataLink
+    /* Treat content as Markdown (converted to HTML before rendering) */
+    renderMarkdown?: boolean | DataLink
     /* The text color */
     color?: string | DataLink
     /* Specifies font weight.  The values 'normal' and are supported for most fonts.  Not all fonts have a variant for each of the numeric values,  in that case the closest one is chosen. */
@@ -96,16 +99,16 @@ Default property:
     brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
-    onPress?: Animation
-    onPressIn?: Animation
-    onPressOut?: Animation
-    onLongPress?: Animation
-    onFocus?: Animation
-    onBlur?: Animation
+    onPress?: AnimationOrGetter
+    onPressIn?: AnimationOrGetter
+    onPressOut?: AnimationOrGetter
+    onLongPress?: AnimationOrGetter
+    onFocus?: AnimationOrGetter
+    onBlur?: AnimationOrGetter
   }
 }
 
-/* Rich text with HTML content rendering, multiple fonts, colors, heading levels (h1-h6), and inline images */
+/* Rich text with HTML or Markdown content rendering, multiple fonts, colors, heading levels (h1-h6), and inline images */
 export type BrickRichText = Brick &
   BrickRichTextDef & {
     templateKey: 'BRICK_RICH_TEXT'

package/types/bricks/Rive.ts

@@ -4,7 +4,7 @@
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
-import type { Animation, AnimationBasicEvents } from '../animation'
+import type { Animation, AnimationBasicEvents, AnimationOrGetter } from '../animation'
 import type {
   Brick,
   EventAction,
@@ -186,14 +186,14 @@ Default property:
     >
   }
   animation?: AnimationBasicEvents & {
-    onPlay?: Animation
-    onPause?: Animation
-    onStop?: Animation
-    onLoopEnd?: Animation
-    onStateChanged?: Animation
-    onError?: Animation
-    onRiveGeneralEvent?: Animation
-    onRiveOpenUrlEvent?: Animation
+    onPlay?: AnimationOrGetter
+    onPause?: AnimationOrGetter
+    onStop?: AnimationOrGetter
+    onLoopEnd?: AnimationOrGetter
+    onStateChanged?: AnimationOrGetter
+    onError?: AnimationOrGetter
+    onRiveGeneralEvent?: AnimationOrGetter
+    onRiveOpenUrlEvent?: AnimationOrGetter
   }
 }