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

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,

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@fugood/bricks-project",
-  "version": "2.24.0-beta.16",
+  "version": "2.24.0-beta.17",
   "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.17",
     "@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": "d99917a2e6eacce97d527fee3c2d6c5bbdcfeef5"
 }

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/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/subspace.ts

@@ -9,6 +9,7 @@ export type Subspace = {
   id: string
   title: string
   description?: string
+  hideShortRef?: boolean
   // Unexpanded information in Editor
   unexpanded?: {
     data?: boolean