HiveGrid-Wireframes/hivegrid-cloud/packages/ui/docs/migration.md

UI Adapter Migration

@toolctrl/ui is the package boundary for future UI primitive ownership. Phase 11 only establishes the boundary; it does not migrate existing app imports.

Category Checklist

For each category:

1. Inventory current app-level primitives and third-party dependencies.
2. Pick a stable export name and props contract before moving implementation.
3. Add the implementation under the matching packages/ui/src/<category>.ts entrypoint or a category-owned folder.
4. Add package-level tests or type assertions when the export becomes non-trivial.
5. Migrate app imports in a separate phase after the package API is reviewed.

Boundaries

• buttons
• inputs
• dialogs
• tables
• layout
• navigation
• feedback

Do not mix app route behavior, data loading or feature-specific orchestration into this package. Keep this layer focused on reusable UI primitives and adapter contracts.