@fugood/bricks-ctor 2.24.0-beta.40

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-ctor'
+
+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

@@ -0,0 +1,151 @@
+import { $ } from 'bun'
+import { parseArgs } from 'util'
+
+const cwd = process.cwd()
+
+const {
+  values: {
+    changelogs: changelogsArg,
+    'changelogs-file': changelogsFile,
+    'auto-commit': autoCommit,
+    'auto-version': autoVersion,
+    version: versionArg,
+    yes,
+    help,
+  },
+} = parseArgs({
+  args: Bun.argv.slice(2),
+  options: {
+    changelogs: { type: 'string' },
+    'changelogs-file': { type: 'string' },
+    'auto-commit': { type: 'boolean' },
+    'auto-version': { type: 'boolean' },
+    version: { type: 'string' },
+    yes: { type: 'boolean', short: 'y' },
+    help: { type: 'boolean', short: 'h' },
+  },
+  allowPositionals: true,
+})
+
+if (help) {
+  console.log(`Options:
+  --changelogs <text>        Changelogs text for the release
+  --changelogs-file <path>   Read changelogs from a file
+  --auto-commit              Auto-commit unstaged changes before deploying
+  --auto-version             Auto-bump patch version before deploying
+  --version <version>        Set explicit version for the release
+  -y, --yes                  Skip all prompts
+  -h, --help                 Show this help message`)
+  process.exit(0)
+}
+
+// Check git status
+const { exitCode } = await $`cd ${cwd} && git status`.quiet().nothrow()
+const isGitRepo = exitCode === 0
+
+if (!isGitRepo && !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 config = await Bun.file(`${cwd}/.bricks/build/application-config.json`).json()
+
+// Resolve version: explicit flag > auto-bump > package.json
+const pkgFile = Bun.file(`${cwd}/package.json`)
+const pkgExists = await pkgFile.exists()
+let version: string | undefined
+
+if (versionArg) {
+  version = versionArg
+  if (pkgExists) {
+    const pkg = await pkgFile.json()
+    pkg.version = version
+    await Bun.write(`${cwd}/package.json`, JSON.stringify(pkg, null, 2) + '\n')
+  }
+} else if (autoVersion && pkgExists) {
+  const pkg = await pkgFile.json()
+  const parts = (pkg.version || '0.0.0').split('.')
+  parts[2] = String(Number(parts[2] || 0) + 1)
+  version = parts.join('.')
+  pkg.version = version
+  await Bun.write(`${cwd}/package.json`, JSON.stringify(pkg, null, 2) + '\n')
+} else {
+  version = pkgExists ? (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):') || ''
+}
+
+// Handle unstaged changes
+let commitId = ''
+if (isGitRepo) {
+  const unstagedChanges = await $`cd ${cwd} && git diff --name-only --diff-filter=ACMR`.text()
+  if (unstagedChanges) {
+    if (autoCommit) {
+      const commitMsg = `chore: release ${version || 'new version'}`
+      const commitBody = changelogs || '[no changelogs]'
+      await $`cd ${cwd} && git add -A && git commit -m ${commitMsg} -m ${commitBody}`
+    } else {
+      throw new Error(
+        'Unstaged changes found, please commit or stash your changes before deploying',
+      )
+    }
+  }
+  commitId = (await $`cd ${cwd} && git rev-parse HEAD`.text()).trim()
+}
+
+// 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'
+
+// 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