@fugood/bricks-project 2.24.0-beta.16 → 2.24.0-beta.18

package/compile/index.ts

@@ -266,6 +266,7 @@ const compileApplicationSettings = (settings: Application['settings']) => ({
         use_gemini_api_key_system_data: settings.ai.useGeminiApiKeySystemData,
       }
     : undefined,
+  hide_short_refs: settings?.hideShortRefs,
 })
 
 const animationTypeMap = {
@@ -385,6 +386,7 @@ function compileRunArray(run: unknown[]): unknown[] {
 const compileTestCase = (testCase: TestCase) => ({
   id: testCase.id,
   name: testCase.name,
+  hide_short_ref: testCase.hideShortRef,
   run: compileRunArray(testCase.run),
   exit_on_failed: testCase.exit_on_failed,
   commented: testCase.commented,
@@ -449,6 +451,7 @@ const compileAutomationTest = (
   return {
     id: testId,
     title: test.title,
+    hide_short_ref: test.hideShortRef,
     timeout: test.timeout,
     trigger_type: test.trigger_type,
     cron: test.cron,
@@ -476,6 +479,7 @@ const compileAutomationTestMap = (testMap: AutomationTestMap, mapId: string) =>
 
   return {
     title: testMap.title,
+    hide_short_ref: testMap.hideShortRef,
     createdAt: testMap.createdAt,
     map: arrayToIdMap(
       testMap.tests,
@@ -519,6 +523,7 @@ export const compile = async (app: Application) => {
       subspaceMap[subspaceId] = {
         title: subspace.title,
         description: subspace.description,
+        hide_short_ref: subspace.hideShortRef,
         _expanded: subspace.unexpanded
           ? {
               brick: !subspace.unexpanded.brick,
@@ -556,8 +561,10 @@ export const compile = async (app: Application) => {
           if (animation.__typename === 'Animation') {
             const animationDef = animation as AnimationDef
             map[animationId] = {
+              alias: animationDef.alias,
               title: animationDef.title,
               description: animationDef.description,
+              hide_short_ref: animationDef.hideShortRef,
               animationRunType: animationDef.runType,
               property: animationDef.property,
               type: animationTypeMap[animationDef.config.__type],
@@ -569,8 +576,10 @@ export const compile = async (app: Application) => {
           } else if (animation.__typename === 'AnimationCompose') {
             const animationDef = animation as AnimationComposeDef
             map[animationId] = {
+              alias: animationDef.alias,
               title: animationDef.title,
               description: animationDef.description,
+              hide_short_ref: animationDef.hideShortRef,
               animationRunType: animationDef.runType,
               compose_type: animationDef.composeType,
               item_list: animationDef.items.map((item, index) => {
@@ -690,8 +699,10 @@ export const compile = async (app: Application) => {
           }
           map[brickId] = {
             template_key: brick.templateKey,
+            alias: brick.alias,
             title: brick.title,
             description: brick.description,
+            hide_short_ref: brick.hideShortRef,
             property,
             animation: compileAnimations(
               brick.templateKey,
@@ -758,8 +769,10 @@ export const compile = async (app: Application) => {
           )
 
           map[canvasId] = {
+            alias: canvas.alias,
             title: canvas.title,
             description: canvas.description,
+            hide_short_ref: canvas.hideShortRef,
             property: compileProperty(
               canvas.property,
               `(canvas: ${canvasId}, subspace ${subspaceId})`,
@@ -838,8 +851,10 @@ export const compile = async (app: Application) => {
 
           map[generatorId] = {
             template_key: generator.templateKey,
+            alias: generator.alias,
             title: generator.title,
             description: generator.description,
+            hide_short_ref: generator.hideShortRef,
             local_sync: generator.localSyncRunMode
               ? {
                   run_mode: generator.localSyncRunMode,
@@ -908,8 +923,10 @@ export const compile = async (app: Application) => {
           )
 
           map[dataId] = {
+            alias: data.alias,
             title: data.title,
             description: data.description,
+            hide_short_ref: data.hideShortRef,
             linked: data.metadata?.linked,
             linkedFrom: data.metadata?.linkedFrom,
             local_sync: data.localSyncUpdateMode
@@ -943,6 +960,7 @@ export const compile = async (app: Application) => {
           const calc: any = {
             title: dataCalc.title,
             description: dataCalc.description,
+            hide_short_ref: dataCalc.hideShortRef,
           }
           if (dataCalc.triggerMode) calc.trigger_type = dataCalc.triggerMode
           if (dataCalc.__typename === 'DataCalculationMap') {
@@ -1029,6 +1047,7 @@ export const compile = async (app: Application) => {
                 acc[getNodeId(dataNode, 'data node', nodeIndex)] = {
                   title: dataNode.title,
                   description: dataNode.description,
+                  hide_short_ref: dataNode.hideShortRef,
                   type: 'data-node',
                   properties: {},
                   in: generateInputPorts(dataNode.inputs),
@@ -1054,6 +1073,7 @@ export const compile = async (app: Application) => {
                 acc[getNodeId(commandNode, 'command node', nodeIndex)] = {
                   title: commandNode.title,
                   description: commandNode.description,
+                  hide_short_ref: commandNode.hideShortRef,
                   type: `command-node-${type}`,
                   properties: {
                     command: commandNode.__commandName,
@@ -1197,3 +1217,8 @@ export const compile = async (app: Application) => {
   }
   return config
 }
+
+export const checkConfig = async (configPath: string) => {
+  const { $ } = await import('bun')
+  await $`bricks app check-config ${configPath}`
+}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.24.0-beta.16",
+  "version": "2.24.0-beta.18",
   "main": "index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "bun scripts/build.js"
   },
   "dependencies": {
-    "@fugood/bricks-cli": "^2.24.0-beta.15",
+    "@fugood/bricks-cli": "^2.24.0-beta.18",
     "@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": "b024e1980b2c25797ae26e9b973497e3ee724265"
+  "gitHead": "c7d8e3252e72c78d8b356e3f366e24f072c12521"
 }

package/skills/bricks-project/rules/architecture-patterns.md

@@ -37,6 +37,13 @@ Built-in commands for direct state and UI changes.
 ### Data Calculation (Priority 4)
 ONLY for deriving, formatting, or aggregating values from other data. Not for orchestration, side effects, or flow control.
 
+## Entity Aliases
+
+Set `alias` on entities to give them a stable, human-readable name:
+- Code generation uses alias as the variable name (e.g., `alias: 'submitBtn'` → `export const submitBtn`)
+- At runtime, devtools MCP tools accept alias instead of short ID and selectors can match by alias. Note: bricks-project does not directly interact with devtools MCP — aliases here primarily affect code generation
+- Aliases must be unique across the application — duplicates are excluded from resolution
+
 ## Flow Decomposition
 
 When the user describes a complex flow, decompose it BEFORE writing code:

package/types/animation.ts

@@ -61,8 +61,10 @@ export interface AnimationDecayConfig {
 export interface AnimationDef {
   __typename: 'Animation'
   id: string
+  alias?: string
   title: string
   description?: string
+  hideShortRef?: boolean
   runType?: 'once' | 'loop'
   property:
     | 'transform.translateX'
@@ -80,8 +82,10 @@ export interface AnimationDef {
 export interface AnimationComposeDef {
   __typename: 'AnimationCompose'
   id: string
+  alias?: string
   title: string
   description?: string
+  hideShortRef?: boolean
   runType?: 'once' | 'loop'
   composeType: 'parallel' | 'sequence'
   items: Array<() => Animation>

package/types/automation.ts

@@ -182,6 +182,7 @@ export interface TestCase {
   __typename: 'TestCase'
   id: string
   name: string
+  hideShortRef?: boolean
   run: TestMethodRun
   exit_on_failed: boolean
   commented: boolean
@@ -203,6 +204,7 @@ export interface AutomationTest {
   __typename: 'AutomationTest'
   id: string
   title: string
+  hideShortRef?: boolean
   timeout: number
   trigger_type?: TestTriggerType
   cron?: string // Cron expression when trigger_type is 'cron'
@@ -220,6 +222,7 @@ export interface AutomationTestMap {
   __typename: 'AutomationTestMap'
   id: string
   title: string
+  hideShortRef?: boolean
   createdAt: number
   tests: AutomationTest[]
 }

package/types/bricks/Camera.ts

@@ -167,15 +167,42 @@ Default property:
   }
   outlets?: {
     /* Camera device and format information */
-    info?: () => Data
+    info?: () => Data<{ [key: string]: any }>
     /* Picture taken result */
-    pictureTaken?: () => Data
+    pictureTaken?: () => Data<{
+      width?: number
+      height?: number
+      uri?: string
+      base64?: string
+      [key: string]: any
+    }>
     /* Record video result */
-    recordVideo?: () => Data
+    recordVideo?: () => Data<{
+      uri?: string
+      [key: string]: any
+    }>
     /* Barcode read result */
-    barcodeRead?: () => Data
+    barcodeRead?: () => Data<{
+      type?: string
+      data?: string
+      rawData?: string
+      bounds?: {
+        origin?: {
+          x?: number
+          y?: number
+          [key: string]: any
+        }
+        size?: {
+          width?: number
+          height?: number
+          [key: string]: any
+        }
+        [key: string]: any
+      }
+      [key: string]: any
+    }>
     /* Faces detected result */
-    faceDetected?: () => Data
+    faceDetected?: () => Data<Array<{ [key: string]: any }>>
   }
   animation?: AnimationBasicEvents & {
     stateChange?: Animation

package/types/bricks/GenerativeMedia.ts

@@ -209,15 +209,15 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
     /* Generated media URL */
-    url?: () => Data
+    url?: () => Data<string>
     /* Generated media error */
-    error?: () => Data
+    error?: () => Data<string>
     /* Loading state */
-    loading?: () => Data
+    loading?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     generativeMediaOnPress?: Animation

package/types/bricks/Icon.ts

@@ -57,9 +57,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/Image.ts

@@ -71,9 +71,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/Items.ts

@@ -411,17 +411,17 @@ Default property:
   }
   outlets?: {
     /* Catched error message */
-    error?: () => Data
+    error?: () => Data<string>
     /* Current render mode */
-    mode?: () => Data
+    mode?: () => Data<string>
     /* Current page index */
-    pageIndex?: () => Data
+    pageIndex?: () => Data<number>
     /* Current page size */
-    pageSize?: () => Data
+    pageSize?: () => Data<number>
     /* Selected item index of detail mode */
-    selectedItemIndex?: () => Data
+    selectedItemIndex?: () => Data<number>
     /* Page is out of bound */
-    pageIsOutOfBound?: () => Data
+    pageIsOutOfBound?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPageRender?: Animation

package/types/bricks/Lottie.ts

@@ -120,9 +120,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/Maps.ts

@@ -213,9 +213,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/QrCode.ts

@@ -76,9 +76,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/Rect.ts

@@ -74,9 +74,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/RichText.ts

@@ -87,9 +87,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/Svg.ts

@@ -58,9 +58,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/Text.ts

@@ -105,9 +105,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/TextInput.ts

@@ -186,15 +186,19 @@ Default property:
   }
   outlets?: {
     /* The raw input */
-    rawInput?: () => Data
+    rawInput?: () => Data<any>
     /* The regex result */
-    resultVariable?: () => Data
+    resultVariable?: () => Data<{ [key: string]: any }>
     /* Last key in */
-    lastKey?: () => Data
+    lastKey?: () => Data<any>
     /* Selection of the TextInput (start, end, text) */
-    selection?: () => Data
+    selection?: () => Data<{
+      start?: number
+      end?: number
+      text?: string
+    }>
     /* Selection text of the TextInput */
-    selectionText?: () => Data
+    selectionText?: () => Data<string>
   }
   animation?: AnimationBasicEvents & {
     onFocus?: Animation

package/types/bricks/Video.ts

@@ -129,9 +129,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/VideoStreaming.ts

@@ -68,9 +68,9 @@ Default property:
   }
   outlets?: {
     /* Brick is pressing */
-    brickPressing?: () => Data
+    brickPressing?: () => Data<boolean>
     /* Brick is focusing (Use TV Device with controller) */
-    brickFocusing?: () => Data
+    brickFocusing?: () => Data<boolean>
   }
   animation?: AnimationBasicEvents & {
     onPress?: Animation

package/types/bricks/WebView.ts

@@ -130,9 +130,9 @@ Default property:
   }
   outlets?: {
     /* The result of the query selector action */
-    queryResult?: () => Data
+    queryResult?: () => Data<any>
     /* The error of the query selector action */
-    queryError?: () => Data
+    queryError?: () => Data<string>
   }
   animation?: AnimationBasicEvents & {
     onLoad?: Animation

package/types/canvas.ts

@@ -36,8 +36,10 @@ interface CanvasDef {
 export type Canvas = CanvasDef & {
   __typename: 'Canvas'
   id: string
+  alias?: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   switches?: Array<
     SwitchDef &
       CanvasDef & {

package/types/common.ts

@@ -6,9 +6,11 @@ import type { AutomationMap } from './automation'
 export interface Brick {
   __typename: 'Brick'
   id: string
+  alias?: string
   templateKey: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   property?: {}
   events: {}
   outlets?: {}
@@ -24,9 +26,11 @@ export enum LocalSyncStrategy {
 export interface Generator {
   __typename: 'Generator'
   id: string
+  alias?: string
   templateKey: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   localSyncRunMode?: LocalSyncStrategy
   property?: {}
   events: {}
@@ -121,6 +125,7 @@ export type ApplicationSettings = {
     useOpenAiApiKeySystemData?: boolean
     useGeminiApiKeySystemData?: boolean
   }
+  hideShortRefs?: boolean
 }
 
 export type Application = {

package/types/data-calc-command.ts

@@ -6,6 +6,7 @@ export interface DataCalculationData {
   __typename: 'DataCalculationData'
   title?: string
   description?: string
+  hideShortRef?: boolean
   data: () => Data
   inputs: Array<{
     key: 'change'
@@ -26,6 +27,7 @@ export interface DataCommand {
   id: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   inputs: Array<{
     key: string
     source: (() => DataCalculationData | DataCommand) | any

package/types/data-calc.ts

@@ -4,6 +4,7 @@ export interface DataCalculation {
   id: string
   title?: string
   description?: string
+  hideShortRef?: boolean
   // Auto: Run the calculation when inputs change and allow triggers. Careful with circular dependencies!
   // Manual: Only run the calculation when manually triggered by System Action PROPERTY_BANK_COMMAND
   triggerMode?: 'auto' | 'manual'

package/types/data.ts

@@ -17,8 +17,10 @@ interface DataDef {
 export type Data<T = any> = DataDef & {
   __typename: 'Data'
   id: string
+  alias?: string
   title: string
   description?: string
+  hideShortRef?: boolean
   metadata?: {
     linked?: Array<SubspaceID>
     linkedFrom?: SubspaceID

package/types/generators/AlarmClock.ts

@@ -71,13 +71,13 @@ Default property:
   }
   outlets?: {
     /* Current time of each alarm clock trig */
-    trigTime?: () => Data
+    trigTime?: () => Data<string>
     /* Current timestamp (unix time) of each alarm clock trig */
-    trigTimestamp?: () => Data
+    trigTimestamp?: () => Data<string | number>
     /* Count of alarm clock trigs */
-    trigCount?: () => Data
+    trigCount?: () => Data<string | number>
     /* Is alarm clock running? */
-    running?: () => Data
+    running?: () => Data<boolean | string | number>
   }
 }
 

package/types/generators/Assistant.ts

@@ -524,19 +524,64 @@ Default property:
   }
   outlets?: {
     /* Whether the assistant is heating up */
-    isHeatingUp?: () => Data
+    isHeatingUp?: () => Data<boolean>
     /* Whether the assistant is file processing */
-    isFileProcessing?: () => Data
+    isFileProcessing?: () => Data<boolean>
     /* Whether the assistant is responding */
-    isResponding?: () => Data
+    isResponding?: () => Data<boolean>
     /* Whether the assistant is busy */
-    isBusy?: () => Data
+    isBusy?: () => Data<boolean>
     /* Embedding files of the assistant */
-    files?: () => Data
+    files?: () => Data<Array<any>>
     /* Messages of the assistant */
-    messages?: () => Data
+    messages?: () => Data<
+      Array<{
+        role?: string
+        name?: string
+        content?: any
+        tool_call_id?: string
+        tool_calls?: Array<{
+          id?: string
+          type?: string
+          function?: {
+            name?: string
+            arguments?: string
+            [key: string]: any
+          }
+          [key: string]: any
+        }>
+        reasoning_content?: string
+        audio?: {
+          generating?: boolean
+          [key: string]: any
+        }
+        last_generated_at?: number
+        responding?: boolean
+        is_summary?: boolean
+        summary_created_at?: number
+        [key: string]: any
+      }>
+    >
     /* MCP servers status and available tools */
-    mcpServers?: () => Data
+    mcpServers?: () => Data<
+      Array<{
+        generatorId?: string
+        generatorKey?: string
+        name?: string
+        version?: string
+        connected?: boolean
+        error?: string
+        resources?: Array<{
+          name?: string
+          [key: string]: any
+        }>
+        tools?: Array<{
+          name?: string
+          [key: string]: any
+        }>
+        [key: string]: any
+      }>
+    >
   }
 }