@fugood/bricks-project 2.23.0-beta.9 → 2.23.2

package/skills/bricks-project/rules/remote-data-bank.md

@@ -0,0 +1,196 @@
+# Remote Data Bank
+
+Cloud-synchronized Data Bank for real-time data sharing across devices and external API access.
+
+## Remote Update Types
+
+The `remoteUpdate` field configures cloud synchronization:
+
+```typescript
+remoteUpdate?:
+  | { type: 'auto' }           // Sync across all devices
+  | { type: 'device-specific' } // Isolated per device
+  | { type: 'global-data', id: string } // Cross-application global data
+```
+
+### Auto Sync
+
+Sync across all devices using the same application.
+
+```typescript
+import { makeId } from 'bricks-project'
+
+const data: Data = {
+  __typename: 'Data',
+  id: makeId('data'),
+  title: 'Announcement',
+  type: 'string',
+  value: '',
+  remoteUpdate: { type: 'auto' },
+  events: {},
+}
+```
+
+### Global Data
+
+Share data across different applications. Must create Global Data first on BANK page.
+
+```typescript
+import { makeId } from 'bricks-project'
+
+const data: Data = {
+  __typename: 'Data',
+  id: makeId('data'),
+  title: 'Global Config',
+  type: 'object',
+  value: {},
+  remoteUpdate: { type: 'global-data', id: 'workspace-global-config-id' },
+  events: {},
+}
+```
+
+### Device Specific
+
+Isolate data per device while still allowing web page control.
+
+```typescript
+import { makeId } from 'bricks-project'
+
+const data: Data = {
+  __typename: 'Data',
+  id: makeId('data'),
+  title: 'Device Message',
+  type: 'string',
+  value: '',
+  remoteUpdate: { type: 'device-specific' },
+  events: {},
+}
+```
+
+Use case: Control individual displays from a shared web interface without affecting other devices.
+
+## External Access
+
+### Web Update Page
+
+Generate a web page for non-technical users to update data:
+
+1. Visit BANK page
+2. Click `Manage Keys`
+3. Select `Generate Key used by Update Page`
+4. Share the generated link
+
+The page has independent permissions and can be shared with content managers.
+
+### API Access
+
+Programmatic data updates via REST API.
+
+**Setup:**
+1. Visit BANK page → Manage Keys
+2. Create API key with appropriate permissions
+3. Use key in API requests
+
+**Example API Usage:**
+
+```bash
+# Update a property
+curl -X POST https://api.bricks.tools/v1/bank/update \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "applicationId": "app-id",
+    "propertyId": "announcement",
+    "value": "New announcement text"
+  }'
+
+# Get property value
+curl https://api.bricks.tools/v1/bank/get \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -G \
+  -d "applicationId=app-id" \
+  -d "propertyId=announcement"
+```
+
+## Data Routing
+
+Cross-subspace data sharing with access control.
+
+```typescript
+const routedData: Data = {
+  __typename: 'Data',
+  id: 'shared-state',
+  type: 'object',
+  routing: 'read-only', // 'read-only' | default (read-write)
+  // When read-only: only accepts changes from same subspace
+  // Default: accepts changes from any subspace
+}
+```
+
+## Use Cases
+
+### Digital Signage Content Management
+
+```typescript
+import { makeId } from 'bricks-project'
+
+// Remote-updated announcement
+const announcement: Data = {
+  __typename: 'Data',
+  id: makeId('data'),
+  title: 'Announcement',
+  type: 'object',
+  value: { title: '', body: '', enabled: false },
+  remoteUpdate: { type: 'auto' },
+  events: {},
+}
+```
+
+Operator updates content via web page → All displays update in real-time.
+
+### Multi-Location Coordination
+
+```typescript
+import { makeId } from 'bricks-project'
+
+// Global data shared across locations
+const globalConfig: Data = {
+  __typename: 'Data',
+  id: makeId('data'),
+  title: 'Brand Config',
+  type: 'object',
+  value: {},
+  remoteUpdate: { type: 'global-data', id: 'brand-config-global' },
+  events: {},
+}
+```
+
+Update once → All locations receive update.
+
+### Per-Device Customization
+
+```typescript
+import { makeId } from 'bricks-project'
+
+// Device-specific greeting
+const deviceGreeting: Data = {
+  __typename: 'Data',
+  id: makeId('data'),
+  title: 'Greeting',
+  type: 'string',
+  value: '',
+  remoteUpdate: { type: 'device-specific' },
+  events: {},
+}
+```
+
+Each display shows different greeting, controlled from single dashboard.
+
+## Best Practices
+
+1. **Minimize remote data**: Only enable for data that truly needs cloud sync
+2. **Use device-specific wisely**: Good for personalization, not for shared state
+3. **API key security**: Use scoped keys with minimal permissions
+4. **Offline resilience**: Design for temporary disconnection
+5. **Batch updates**: Group related changes to reduce API calls
+6. **Global data governance**: Establish clear ownership for global data keys

package/skills/bricks-project/rules/standby-transition.md

@@ -0,0 +1,124 @@
+# Standby Transition
+
+Easy-to-configure animation for Bricks based on Canvas render/change. Provides smooth enter animations when bricks appear and position transitions when canvas changes.
+
+## How It Works
+
+Two transition cases:
+1. **First Render**: Run position transition based on `standbyMode` setting
+2. **Canvas Change**: Existing bricks animate to new positions instead of re-rendering
+
+## Configuration
+
+Standby transition is configured in the **canvas item frame**, not the brick itself.
+
+### Standby Mode
+
+| Mode | Description |
+|------|-------------|
+| `top` | Slide in from top |
+| `bottom` | Slide in from bottom |
+| `left` | Slide in from left |
+| `right` | Slide in from right |
+| `custom` | Use custom `standbyFrame` values |
+
+### Frame Options
+
+| Option | Description |
+|--------|-------------|
+| `standbyMode` | Direction or `'custom'` |
+| `standbyFrame` | Custom start frame `{ x?, y?, width?, height? }` |
+| `standbyOpacity` | Start opacity (0.0 - 1.0) |
+| `standbyDelay` | Delay before transition starts (ms) |
+| `standbyDelayRandom` | Random delay variance (ms) |
+| `standbyEasing` | Per-property easing config |
+
+### Easing Configuration
+
+```typescript
+standbyEasing: {
+  default?: { method: Easing, duration: number },
+  x?: { method: Easing, duration: number },
+  y?: { method: Easing, duration: number },
+  width?: { method: Easing, duration: number },
+  height?: { method: Easing, duration: number },
+  opacity?: { method: Easing, duration: number },
+}
+```
+
+## TypeScript Example
+
+```typescript
+import { makeId } from 'bricks-project'
+
+const canvas: Canvas = {
+  __typename: 'Canvas',
+  id: makeId('canvas'),
+  title: 'Home',
+  description: '',
+  property: {
+    backgroundColor: '#ffffff',
+  },
+  events: {},
+  switches: [],
+  items: [
+    {
+      item: () => heroCard,
+      frame: {
+        x: 100,
+        y: 50,
+        width: 400,
+        height: 300,
+        // Standby transition config
+        standbyMode: 'bottom',
+        standbyOpacity: 0,
+        standbyDelay: 100,
+        standbyEasing: {
+          default: { method: 'easeOutCubic', duration: 400 },
+          opacity: { method: 'easeOutQuad', duration: 300 },
+        },
+      },
+    },
+  ],
+}
+```
+
+## Canvas Change Transition
+
+When navigating between canvases, bricks with the same ID smoothly transition:
+- Position interpolates from old to new location
+- Size interpolates if dimensions change
+- Opacity interpolates if visibility changes
+
+This creates a "shared element transition" effect.
+
+## Related Events
+
+- `standby`: Triggered when brick completes standby transition
+
+```typescript
+// In brick definition
+events: {
+  standby: [
+    {
+      handler: 'system',
+      action: {
+        __actionName: 'DYNAMIC_ANIMATION',
+        parent: 'System',
+        params: [
+          { input: 'brickId', value: () => heroCard },
+          { input: 'animationId', value: () => pulseAnimation },
+        ],
+      },
+    },
+  ],
+}
+```
+
+## Best Practices
+
+1. **Stagger delays**: Use incremental delays for list items (e.g., 0, 50, 100ms)
+2. **Keep it short**: 200-400ms transitions feel responsive
+3. **Match content**: Use directional transitions that match scroll direction
+4. **Opacity for polish**: Combine position transition with opacity fade
+5. **Same-ID trick**: Reuse brick IDs across canvases for smooth transitions

package/skills/rive-marketplace/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: rive-marketplace
+description: Search and download assets from Rive Marketplace. Use when searching for Rive animations, downloading .riv files, or exploring Rive community assets. Supports keyword search, tag browsing, and direct file downloads via public API. Requires browser tool for searching; API calls work without browser.
+---
+
+# Rive Marketplace
+
+Download animated assets (.riv files) from Rive's community marketplace.
+
+## URL Structure
+
+- **Featured**: `https://rive.app/marketplace/featured/`
+- **Latest**: `https://rive.app/marketplace/latest/`
+- **Search**: `https://rive.app/marketplace/search/{query}/`
+- **Tags**: `https://rive.app/marketplace/tag/{TagName}/`
+- **Item**: `https://rive.app/marketplace/{post_id}-{revision_id}-{slug}/`
+
+## API (Public, No Auth)
+
+### Get Post Details
+```bash
+curl -s "https://api.rive.app/api/community-posts/{post_id}" | jq '.'
+```
+
+**Response contains:**
+- `community_post_id` — Post ID
+- `owner.username` — Creator name
+- `community_revisions[0].title` — Asset title
+- `community_revisions[0].description` — Description
+- `community_revisions[0].tags` — Tags array
+- `community_revisions[0].community_files[0].file_url` — **Download URL**
+
+### Download .riv File
+```bash
+# Extract file_url from API response
+curl -s "https://api.rive.app/api/community-posts/{post_id}" | jq -r '.community_revisions[0].community_files[0].file_url'
+
+# Download directly
+curl -O "https://public.rive.app/community/runtime-files/{post_id}-{revision_id}-{slug}.riv"
+```
+
+## Workflow: Search → Download
+
+### 1. Browse via Browser (profile=clawd)
+```
+Open: https://rive.app/marketplace/search/{keyword}/
+```
+
+### 2. Get Post ID from URL
+Item URL format: `/marketplace/{post_id}-{revision_id}-{slug}/`
+Example: `/marketplace/1683-3324-like-button/` → post_id = **1683**
+
+### 3. Fetch Download URL via API
+```bash
+curl -s "https://api.rive.app/api/community-posts/1683" | jq -r '.community_revisions[0].community_files[0].file_url'
+# Output: https://public.rive.app/community/runtime-files/1683-3324-like-button.riv
+```
+
+### 4. Download File
+```bash
+curl -O "https://public.rive.app/community/runtime-files/1683-3324-like-button.riv"
+```
+
+## Example: Full Flow
+
+```bash
+# Search for "button" assets, pick one, get post_id from URL
+POST_ID=1683
+
+# Get file URL
+FILE_URL=$(curl -s "https://api.rive.app/api/community-posts/$POST_ID" | jq -r '.community_revisions[0].community_files[0].file_url')
+
+# Download
+curl -o "my-button.riv" "$FILE_URL"
+```
+
+## Batch Download Script
+
+```bash
+#!/bin/bash
+# Download multiple Rive assets by post IDs
+for POST_ID in 1683 3548 3703; do
+  FILE_URL=$(curl -s "https://api.rive.app/api/community-posts/$POST_ID" | jq -r '.community_revisions[0].community_files[0].file_url')
+  FILENAME=$(basename "$FILE_URL")
+  echo "Downloading $FILENAME..."
+  curl -sO "$FILE_URL"
+done
+```
+
+## License
+
+All Marketplace files are shared under **CC BY** (Creative Commons Attribution 4.0).
+Attribution required when using assets.
+
+## Notes
+
+- No official search API; browse via browser or scrape search results
+- API is public but undocumented; may change without notice
+- Remix/Like/Comment requires authentication

package/tools/deploy.ts

@@ -1,8 +1,21 @@
 import { $ } from 'bun'
-import { deployApp, deployModule } from '../api'
+import { parseArgs } from 'util'
 
 const cwd = process.cwd()
 
+const {
+  values: { changelogs: changelogsArg, 'changelogs-file': changelogsFile, yes },
+} = parseArgs({
+  args: Bun.argv.slice(2),
+  options: {
+    changelogs: { type: 'string' },
+    'changelogs-file': { type: 'string' },
+    yes: { type: 'boolean', short: 'y' },
+  },
+  allowPositionals: true,
+})
+
+// Check git status
 const { exitCode } = await $`cd ${cwd} && git status`.nothrow()
 const isGitRepo = exitCode === 0
 
@@ -13,23 +26,72 @@ if (isGitRepo) {
     throw new Error('Unstaged changes found, please commit or stash your changes before deploying')
 
   commitId = (await $`cd ${cwd} && git rev-parse HEAD`.text()).trim()
-} else {
+} else if (!yes) {
   const confirmContinue = prompt('No git repository found, continue? (y/n)')
   if (confirmContinue !== 'y') throw new Error('Deployment cancelled')
 }
 
+// Read application.json
 const app = await Bun.file(`${cwd}/application.json`).json()
-const stage = app.stage || 'production'
 const config = await Bun.file(`${cwd}/.bricks/build/application-config.json`).json()
 
-// ask for confirmation
-const confirm = prompt('Are you sure you want to deploy? (y/n)')
-if (confirm !== 'y') throw new Error('Deployment cancelled')
+// Get version from project's package.json
+const pkgFile = Bun.file(`${cwd}/package.json`)
+const version = (await pkgFile.exists()) ? (await pkgFile.json()).version : undefined
+
+// Get changelog from flag or file
+let changelogs = ''
+if (changelogsArg) {
+  changelogs = changelogsArg
+} else if (changelogsFile) {
+  const file = Bun.file(changelogsFile)
+  if (!(await file.exists())) {
+    throw new Error(`Changelogs file not found: ${changelogsFile}`)
+  }
+  changelogs = await file.text()
+} else if (!yes) {
+  changelogs = prompt('Enter changelogs (optional, press Enter to skip):') || ''
+}
+
+// Ask for confirmation
+if (!yes) {
+  const confirm = prompt('Are you sure you want to deploy? (y/n)')
+  if (confirm !== 'y') throw new Error('Deployment cancelled')
+}
+
+const isModule = app.type === 'module'
+const command = isModule ? 'module' : 'app'
 
-if (!app.type || app.type === 'application') {
-  await deployApp(stage, app.id, config, commitId)
-  console.log('App deployed')
-} else if (app.type === 'module') {
-  await deployModule(stage, app.id, config, commitId)
-  console.log('Module deployed')
+// Add project-specific fields to config and write to temp file
+const releaseConfig = {
+  ...config,
+  title: version || config.title,
+  bricks_project_last_commit_id: commitId || undefined,
 }
+const configPath = `${cwd}/.bricks/build/release-config.json`
+await Bun.write(configPath, JSON.stringify(releaseConfig))
+
+const args = ['bricks', command, 'release', app.id, '-c', configPath, '--json']
+
+if (version) {
+  args.push('--version', version)
+}
+
+if (changelogs) {
+  args.push('--changelogs', changelogs)
+}
+
+const result = await $`${args}`.quiet().nothrow()
+
+if (result.exitCode !== 0) {
+  const output = result.stderr.toString() || result.stdout.toString()
+  try {
+    const json = JSON.parse(output)
+    throw new Error(json.error || 'Release failed')
+  } catch {
+    throw new Error(output || 'Release failed')
+  }
+}
+
+const output = JSON.parse(result.stdout.toString())
+console.log(`${isModule ? 'Module' : 'App'} deployed: ${output.name}`)

package/tools/icons/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf