@docyrus/docyrus 0.0.50 → 0.0.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docyrus/docyrus",
-  "version": "0.0.50",
+  "version": "0.0.51",
   "private": false,
   "description": "Docyrus API CLI",
   "main": "./main.js",

package/resources/pi-agent/skills/docyrus-app-dev-react/SKILL.md

@@ -196,7 +196,7 @@ Use `DataGridViewSelect` as the default saved-view UI for Docyrus grids, and per
 14. **`DataGridViewSelect` needs a TanStack table instance** and should receive `fields` when you want the built-in filter builder/editor experience.
 15. **Data view creation requires `name` and `tenant_data_source_id`**.
 16. **Use `dataViews.update(viewId, { archived: true })` for soft-delete** and `dataViews.remove(viewId)` only for irreversible hard-delete.
-17. **Regenerate collections after schema changes** by rebuilding the tenant OpenAPI spec, downloading the latest `openapi.json`, and re-running the collection generator.
+17. **Regenerate collections after schema changes** by rebuilding the tenant OpenAPI spec, downloading the latest `openapi.json`, and re-running the collection generator. Use `--apps <appSlug>` or `--dataSources <appSlug/dataSourceSlug>` flags to regenerate only the affected collections instead of all (e.g., `pnpm generate-orm -- --dataSources crm/contacts crm/accounts`).
 18. **ACL endpoints are usually raw-client integrations** — use `useDocyrusClient()` or `RestApiClient` for roles, user-role assignments, role queries, record sharing, and ownership transfer.
 19. **Prefer role `uid` values** for ACL role writes, user-role `roleIds`, and role-query `roleIds`.
 20. **Treat `PUT /v1/users/acl/users/:userId/roles` as full replacement** and `POST /v1/users/acl/users/:userId/roles` as additive.

package/resources/pi-agent/skills/docyrus-app-dev-react/references/collections-and-patterns.md

@@ -21,6 +21,28 @@ Collections are auto-generated from `openapi.json` using `@docyrus/tanstack-db-g
 
 **Generate command**: `pnpm generate-orm` (runs `@docyrus/tanstack-db-generator openapi.json`)
 
+The generator supports filtering to regenerate only specific collections:
+
+```bash
+# Generate all collections
+pnpm generate-orm
+
+# Generate collections for specific apps only
+pnpm generate-orm -- --apps crm support
+
+# Generate only specific data source collections (appSlug/dataSourceSlug format)
+pnpm generate-orm -- --dataSources crm/contacts crm/accounts
+
+# Combine both filters (intersection — must match both)
+pnpm generate-orm -- --apps crm --dataSources crm/contacts
+
+# Comma-separated values are also accepted
+pnpm generate-orm -- --apps crm,support
+pnpm generate-orm -- --dataSources crm/contacts,crm/accounts
+```
+
+**Prefer targeted regeneration** (`--apps` or `--dataSources`) over full regeneration when you only changed a few data sources. This is faster and avoids unnecessary file churn.
+
 **Key files:**
 - `src/collections/<app>-<entity>.collection.ts` — generated React hooks with CRUD methods + entity types
 - `src/collections/types.ts` — shared query types (filters, calculations, formulas, etc.)