@playtagon/cli 0.2.9 → 0.3.2

package/README.md

@@ -88,6 +88,66 @@ playtagon spine preset > playtagon-export.json
 
 Import this file into Spine Editor for optimal export settings.
 
+## Syncing Assets (for Developers)
+
+Download approved Spine assets to your local project with TypeScript types and Storybook stories:
+
+```bash
+# Sync all approved assets
+playtagon spine sync --studio my-studio --game my-game
+
+# Sync to custom directory
+playtagon spine sync -s my-studio -o ./src/assets/spine
+
+# Sync specific assets only
+playtagon spine sync --assets hero,villain,effects
+
+# Preview what would be synced
+playtagon spine sync --dry-run
+
+# Force overwrite local changes
+playtagon spine sync --force
+```
+
+### Generated Files
+
+```
+src/assets/spine/
+├── hero/
+│   ├── hero.skel           # Skeleton file
+│   ├── hero.atlas          # Atlas file
+│   ├── hero.png            # Texture(s)
+│   ├── index.ts            # TypeScript types
+│   └── hero.stories.ts     # Storybook story
+├── villain/
+│   └── ...
+└── manifest.ts             # Re-exports all assets
+```
+
+### TypeScript Types
+
+Generated `index.ts` provides full IntelliSense:
+
+```typescript
+import { hero } from './assets/spine/manifest';
+
+// Typed animation names
+hero.animations.idle;
+hero.animations.walk;
+
+// Animation durations (seconds)
+hero.durations.idle;   // 1.5
+hero.durations.walk;   // 0.8
+
+// Skins and events
+hero.skins.default;
+hero.events.footstep;
+```
+
+### Incremental Sync
+
+The CLI tracks synced assets in `.sync-manifest.json`. Subsequent syncs only download new or updated assets. Use `--force` to re-download everything.
+
 ## Commands
 
 | Command | Description |
@@ -100,6 +160,7 @@ Import this file into Spine Editor for optimal export settings.
 | `playtagon spine upload` | Upload Spine assets |
 | `playtagon spine validate` | Validate Spine files |
 | `playtagon spine preset` | Output export preset JSON |
+| `playtagon spine sync` | Sync approved assets with codegen |
 
 ## Requirements