@fugood/bricks-project 2.24.11 → 2.24.13

package/package.json

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

package/skills/bricks-ctor/SKILL.md

@@ -26,6 +26,7 @@ This skill covers advanced BRICKS features not in the main project instructions.
 
 - **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
+- **Fonts**: See [Font Families](references/fonts.md) for supported `fontFamily` names, native fallback behavior, and Google Font fallback guidance
 - **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

package/skills/bricks-ctor/references/fonts.md

@@ -0,0 +1,322 @@
+# Font Families
+
+Use this when choosing or answering questions about `fontFamily` for Text, TextInput, RichText, or nested Items text Bricks.
+
+## Runtime Rules
+
+- Use exact family names from the target platform list; BRICKS matches comma-separated fallbacks left-to-right on native platforms.
+- Prefer cross-platform stacks such as `Arial, sans-serif`, `Helvetica, Roboto, sans-serif`, `Times New Roman, serif`, or `Courier New, monospace` when the same project runs on iOS/tvOS and Android.
+- Android supports generic system families plus `Roboto`; iOS/tvOS use the larger built-in Apple font set below.
+- Web keeps the supplied CSS font-family value. Native ignores unsupported names unless a dynamically loaded or Google Font preload resolves them.
+- Google Fonts can be used by setting a Google font family and letting the config preload path materialize it; keep a platform fallback after it, for example `Roboto Mono, monospace`.
+
+## Android
+
+- normal
+- notoserif
+- sans-serif
+- sans-serif-light
+- sans-serif-thin
+- sans-serif-condensed
+- sans-serif-medium
+- serif
+- Roboto
+- monospace
+
+## iOS/tvOS
+
+- San Francisco
+- Academy Engraved LET
+- AcademyEngravedLetPlain
+- Al Nile
+- AlNile-Bold
+- American Typewriter
+- AmericanTypewriter-Bold
+- AmericanTypewriter-Condensed
+- AmericanTypewriter-CondensedBold
+- AmericanTypewriter-CondensedLight
+- AmericanTypewriter-Light
+- Apple Color Emoji
+- Apple SD Gothic Neo
+- AppleColorEmoji
+- AppleSDGothicNeo-Bold
+- AppleSDGothicNeo-Light
+- AppleSDGothicNeo-Medium
+- AppleSDGothicNeo-Regular
+- AppleSDGothicNeo-SemiBold
+- AppleSDGothicNeo-Thin
+- AppleSDGothicNeo-UltraLight
+- Arial
+- Arial Hebrew
+- Arial Rounded MT Bold
+- Arial-BoldItalicMT
+- Arial-BoldMT
+- Arial-ItalicMT
+- ArialHebrew
+- ArialHebrew-Bold
+- ArialHebrew-Light
+- ArialMT
+- ArialRoundedMTBold
+- Avenir
+- Avenir Next
+- Avenir Next Condensed
+- Avenir-Black
+- Avenir-BlackOblique
+- Avenir-Book
+- Avenir-BookOblique
+- Avenir-Heavy
+- Avenir-HeavyOblique
+- Avenir-Light
+- Avenir-LightOblique
+- Avenir-Medium
+- Avenir-MediumOblique
+- Avenir-Oblique
+- Avenir-Roman
+- AvenirNext-Bold
+- AvenirNext-BoldItalic
+- AvenirNext-DemiBold
+- AvenirNext-DemiBoldItalic
+- AvenirNext-Heavy
+- AvenirNext-HeavyItalic
+- AvenirNext-Italic
+- AvenirNext-Medium
+- AvenirNext-MediumItalic
+- AvenirNext-Regular
+- AvenirNext-UltraLight
+- AvenirNext-UltraLightItalic
+- AvenirNextCondensed-Bold
+- AvenirNextCondensed-BoldItalic
+- AvenirNextCondensed-DemiBold
+- AvenirNextCondensed-DemiBoldItalic
+- AvenirNextCondensed-Heavy
+- AvenirNextCondensed-HeavyItalic
+- AvenirNextCondensed-Italic
+- AvenirNextCondensed-Medium
+- AvenirNextCondensed-MediumItalic
+- AvenirNextCondensed-Regular
+- AvenirNextCondensed-UltraLight
+- AvenirNextCondensed-UltraLightItalic
+- Bangla Sangam MN
+- Baskerville
+- Baskerville-Bold
+- Baskerville-BoldItalic
+- Baskerville-Italic
+- Baskerville-SemiBold
+- Baskerville-SemiBoldItalic
+- Bodoni 72
+- Bodoni 72 Oldstyle
+- Bodoni 72 Smallcaps
+- Bodoni Ornaments
+- BodoniOrnamentsITCTT
+- BodoniSvtyTwoITCTT-Bold
+- BodoniSvtyTwoITCTT-Book
+- BodoniSvtyTwoITCTT-BookIta
+- BodoniSvtyTwoOSITCTT-Bold
+- BodoniSvtyTwoOSITCTT-Book
+- BodoniSvtyTwoSCITCTT-Book
+- Bradley Hand
+- BradleyHandITCTT-Bold
+- Chalkboard SE
+- ChalkboardSE-Bold
+- ChalkboardSE-Light
+- ChalkboardSE-Regular
+- Chalkduster
+- Cochin
+- Cochin-Bold
+- Cochin-BoldItalic
+- Cochin-Italic
+- Copperplate
+- Copperplate-Bold
+- Copperplate-Light
+- Courier
+- Courier New
+- Courier-Bold
+- Courier-BoldOblique
+- Courier-Oblique
+- CourierNewPS-BoldItalicMT
+- CourierNewPS-BoldMT
+- CourierNewPS-ItalicMT
+- CourierNewPSMT
+- Damascus
+- DamascusBold
+- DamascusLight
+- DamascusMedium
+- DamascusSemiBold
+- Devanagari Sangam MN
+- DevanagariSangamMN
+- DevanagariSangamMN-Bold
+- Didot
+- Didot-Bold
+- Didot-Italic
+- DiwanMishafi
+- Euphemia UCAS
+- EuphemiaUCAS-Bold
+- EuphemiaUCAS-Italic
+- Farah
+- Futura
+- Futura-CondensedExtraBold
+- Futura-CondensedMedium
+- Futura-Medium
+- Futura-MediumItalic
+- Geeza Pro
+- GeezaPro-Bold
+- Georgia
+- Georgia-Bold
+- Georgia-BoldItalic
+- Georgia-Italic
+- Gill Sans
+- GillSans-Bold
+- GillSans-BoldItalic
+- GillSans-Italic
+- GillSans-Light
+- GillSans-LightItalic
+- GillSans-SemiBold
+- GillSans-SemiBoldItalic
+- GillSans-UltraBold
+- Gujarati Sangam MN
+- GujaratiSangamMN
+- GujaratiSangamMN-Bold
+- Gurmukhi MN
+- GurmukhiMN-Bold
+- Heiti SC
+- Heiti TC
+- Helvetica
+- Helvetica Neue
+- Helvetica-Bold
+- Helvetica-BoldOblique
+- Helvetica-Light
+- Helvetica-LightOblique
+- Helvetica-Oblique
+- HelveticaNeue-Bold
+- HelveticaNeue-BoldItalic
+- HelveticaNeue-CondensedBlack
+- HelveticaNeue-CondensedBold
+- HelveticaNeue-Italic
+- HelveticaNeue-Light
+- HelveticaNeue-LightItalic
+- HelveticaNeue-Medium
+- HelveticaNeue-MediumItalic
+- HelveticaNeue-Thin
+- HelveticaNeue-ThinItalic
+- HelveticaNeue-UltraLight
+- HelveticaNeue-UltraLightItalic
+- Hiragino Mincho ProN
+- Hiragino Sans
+- HiraginoSans-W3
+- HiraginoSans-W6
+- HiraMinProN-W3
+- HiraMinProN-W6
+- Hoefler Text
+- HoeflerText-Black
+- HoeflerText-BlackItalic
+- HoeflerText-Italic
+- HoeflerText-Regular
+- Iowan Old Style
+- IowanOldStyle-Bold
+- IowanOldStyle-BoldItalic
+- IowanOldStyle-Italic
+- IowanOldStyle-Roman
+- Kailasa
+- Kailasa-Bold
+- Kannada Sangam MN
+- KannadaSangamMN
+- KannadaSangamMN-Bold
+- Khmer Sangam MN
+- Kohinoor Bangla
+- Kohinoor Devanagari
+- Kohinoor Telugu
+- KohinoorBangla-Light
+- KohinoorBangla-Regular
+- KohinoorBangla-Semibold
+- KohinoorDevanagari-Light
+- KohinoorDevanagari-Regular
+- KohinoorDevanagari-Semibold
+- KohinoorTelugu-Light
+- KohinoorTelugu-Medium
+- KohinoorTelugu-Regular
+- Lao Sangam MN
+- Malayalam Sangam MN
+- MalayalamSangamMN
+- MalayalamSangamMN-Bold
+- Marker Felt
+- MarkerFelt-Thin
+- MarkerFelt-Wide
+- Menlo
+- Menlo-Bold
+- Menlo-BoldItalic
+- Menlo-Italic
+- Menlo-Regular
+- Mishafi
+- Noteworthy
+- Noteworthy-Bold
+- Noteworthy-Light
+- Optima
+- Optima-Bold
+- Optima-BoldItalic
+- Optima-ExtraBlack
+- Optima-Italic
+- Optima-Regular
+- Oriya Sangam MN
+- OriyaSangamMN
+- OriyaSangamMN-Bold
+- Palatino
+- Palatino-Bold
+- Palatino-BoldItalic
+- Palatino-Italic
+- Palatino-Roman
+- Papyrus
+- Papyrus-Condensed
+- Party LET
+- PartyLetPlain
+- PingFang HK
+- PingFang SC
+- PingFang TC
+- PingFangHK-Light
+- PingFangHK-Medium
+- PingFangHK-Regular
+- PingFangHK-Semibold
+- PingFangHK-Thin
+- PingFangHK-Ultralight
+- PingFangSC-Light
+- PingFangSC-Medium
+- PingFangSC-Regular
+- PingFangSC-Semibold
+- PingFangSC-Thin
+- PingFangSC-Ultralight
+- PingFangTC-Light
+- PingFangTC-Medium
+- PingFangTC-Regular
+- PingFangTC-Semibold
+- PingFangTC-Thin
+- PingFangTC-Ultralight
+- Savoye LET
+- SavoyeLetPlain
+- Sinhala Sangam MN
+- SinhalaSangamMN
+- SinhalaSangamMN-Bold
+- Snell Roundhand
+- SnellRoundhand-Black
+- SnellRoundhand-Bold
+- Symbol
+- Tamil Sangam MN
+- TamilSangamMN-Bold
+- Telugu Sangam MN
+- Thonburi
+- Thonburi-Bold
+- Thonburi-Light
+- Times New Roman
+- TimesNewRomanPS-BoldItalicMT
+- TimesNewRomanPS-BoldMT
+- TimesNewRomanPS-ItalicMT
+- TimesNewRomanPSMT
+- Trebuchet MS
+- Trebuchet-BoldItalic
+- TrebuchetMS-Bold
+- TrebuchetMS-Italic
+- Verdana
+- Verdana-Bold
+- Verdana-BoldItalic
+- Verdana-Italic
+- Zapf Dingbats
+- ZapfDingbatsITC
+- Zapfino

package/types/bricks/Text.d.ts

@@ -36,7 +36,7 @@ Default property:
   property?: BrickBasicProperty & {
     /* The text content */
     text?: string | DataLink | number | DataLink | boolean | DataLink | string | DataLink | DataLink
-    /* Data to be used in the text template (e.g. `Hello ${name}`). Supports nested data, such as `Hello ${user.name}`. */
+    /* Data to be used in the text template. Must be an OBJECT whose keys are the template variable names: `Hello ${name}` needs `{ name: ... }` (a linked data must resolve to such an object — linking a scalar leaves the template unresolved). Supports nested data, such as `Hello ${user.name}`. */
     templateData?: {} | DataLink
     /* The text template type */
     templateType?: '${}' | '{{}}' | DataLink
@@ -80,6 +80,14 @@ Default property:
     letterSpacing?: number | DataLink
     /* The line height of text content (grid) */
     lineHeight?: number | DataLink
+    /* The text top padding (grid) */
+    paddingTop?: number | DataLink
+    /* The text left padding (grid) */
+    paddingLeft?: number | DataLink
+    /* The text right padding (grid) */
+    paddingRight?: number | DataLink
+    /* The text bottom padding (grid) */
+    paddingBottom?: number | DataLink
     /* The line number limit of text content */
     lineNumber?: number | DataLink
     /* The text align */

package/types/bricks/TextInput.d.ts

@@ -177,7 +177,7 @@ Default property:
     onEmpty?: Array<EventAction>
     /* Event of the TextInput value change */
     onChange?: Array<EventAction<string & keyof TemplateEventPropsMap['TextInput']['onChange']>>
-    /* Event of the TextInput submit */
+    /* Event of the TextInput submit. Fires on EVERY submit attempt, even when the value does not match `regex` — to react only to a valid submit, gate on a data updated from the result outlet (e.g. `valueHit`), or handle the invalid case via `onResultNotMatch` */
     onSubmit?: Array<EventAction<string & keyof TemplateEventPropsMap['TextInput']['onSubmit']>>
     /* Event of the TextInput match regex (check every value change) */
     onMatch?: Array<EventAction<string & keyof TemplateEventPropsMap['TextInput']['onMatch']>>

package/types/generators/LlmAppleBuiltin.d.ts

@@ -1,13 +1,13 @@
 /* Auto generated by build script
  *
- * LLM inference using Apple Intelligence on iOS/tvOS 26+
+ * LLM inference using Apple Intelligence on iOS 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+
+ *  - Requires iOS 26+
  */
 import type { SwitchCondInnerStateCurrentCanvas, SwitchCondData, SwitchDef } from '../switch'
 import type { Data, DataLink } from '../data'
@@ -125,14 +125,14 @@ Default property:
   }
 }
 
-/* LLM inference using Apple Intelligence on iOS/tvOS 26+
+/* LLM inference using Apple Intelligence on iOS 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+ */
+ - Requires iOS 26+ */
 export type GeneratorAppleLLM = Generator &
   GeneratorAppleLLMDef & {
     templateKey: 'GENERATOR_APPLE_LLM'

package/types/generators/LlmGgml.d.ts

@@ -493,6 +493,8 @@ Default property:
   "ctxShift": true,
   "cpuMoeLayers": 0,
   "mtpSpeculativeDecoding": false,
+  "mtpDraftCacheKType": "f16",
+  "mtpDraftCacheVType": "f16",
   "mtpDraftTokens": 3,
   "transformScriptEnabled": false,
   "transformScriptCode": "\/\* Global variable: inputs = { prompt, messages, variables }, members = { llmUtils } \*\/\nreturn inputs.prompt",
@@ -606,6 +608,36 @@ Default property:
     cpuMoeLayers?: number | DataLink
     /* Enable MTP speculative decoding for GGUF models that contain MTP / NextN layers */
     mtpSpeculativeDecoding?: boolean | DataLink
+    /* URL or path of an optional separate GGUF draft model for speculative decoding. Leave empty for models with embedded MTP / NextN layers */
+    modelDraftUrl?: string | DataLink
+    /* Hash type of the separate draft model */
+    modelDraftHashType?: 'md5' | 'sha256' | 'sha1' | DataLink
+    /* Hash of the separate draft model */
+    modelDraftHash?: string | DataLink
+    /* Number of draft model layers stored in VRAM (-1 = auto, -2 = all) */
+    mtpDraftGpuLayers?: number | DataLink
+    /* KV cache data type for the separate draft model's K cache */
+    mtpDraftCacheKType?:
+      | 'f16'
+      | 'f32'
+      | 'q8_0'
+      | 'q4_0'
+      | 'q4_1'
+      | 'iq4_nl'
+      | 'q5_0'
+      | 'q5_1'
+      | DataLink
+    /* KV cache data type for the separate draft model's V cache */
+    mtpDraftCacheVType?:
+      | 'f16'
+      | 'f32'
+      | 'q8_0'
+      | 'q4_0'
+      | 'q4_1'
+      | 'iq4_nl'
+      | 'q5_0'
+      | 'q5_1'
+      | DataLink
     /* Maximum number of MTP draft tokens */
     mtpDraftTokens?: number | DataLink
     /* Minimum number of MTP draft tokens */