@aircall/ds 0.14.0 → 0.15.0

package/README.md

@@ -20,6 +20,37 @@ required `@aircall/ds/globals.css` import, icon imports from `@aircall/react-ico
 dark-mode setup. The shipped `.d.ts` files are the source of truth for prop names and
 values (variants are typed as literal unions) — do not invent props.
 
+### Migrating off `@aircall/tractor`? Turn on the AI migration skills
+
+This package ships **[TanStack Intent](https://tanstack.com/intent) migration skills** in
+its `skills/` directory (published in the npm tarball) — version-matched, agent-loadable
+guidance for moving an app off `@aircall/tractor` / `@aircall/icons` (and `@dashboard/library`
+→ `@aircall/blocks`) to `@aircall/ds`. Enable them in your repo (one-time):
+
+```bash
+# 1. install / upgrade — @aircall/react-icons MUST be >= 0.4.0 (the ds bundle imports flags from it)
+pnpm add @aircall/ds@latest @aircall/blocks@latest @aircall/react-icons@latest
+
+# 2. let your AI agent discover the skills — writes a discovery block into CLAUDE.md / AGENTS.md
+npx @tanstack/intent install
+
+# 3. allowlist the packages in package.json, then verify discovery:
+#    { "intent": { "skills": ["@aircall/ds", "@aircall/blocks"] } }
+npx @tanstack/intent list   # should list @aircall/ds and @aircall/blocks
+```
+
+Your agent then loads guidance on demand, starting with setup:
+
+```bash
+npx @tanstack/intent load "@aircall/ds#aircall-ds/setup"
+# then per file: aircall-ds/migrate-tractor · aircall-ds/migrate-icons · aircall-blocks/migrate-dashboard
+```
+
+Each migrate skill carries an end-to-end playbook (setup → inventory → migrate → verify) and
+`requires` `setup` (providers incl. `DsI18nProvider`, the `globals.css` import, and the jsdom
+test shims). Keep `@aircall/tractor` installed until the last Tractor import is gone —
+migration is progressive (cohabitation).
+
 ## Installation
 
 ### For Monorepo Apps (Hydra Workspace)