admin-ui-starter-kit 0.1.1 → 0.1.3

package/README.md

@@ -99,6 +99,11 @@ exactly your tool.**
 For a full framework and bundler setup walkthrough, see
 [INTEGRATION.md](INTEGRATION.md).
 
+Migrating an app that already copied an older local UI tree? Start with
+[MIGRATION.md](MIGRATION.md), then use
+[COMPONENT_SELECTION.md](COMPONENT_SELECTION.md) to choose exact package
+entrypoints.
+
 ### 1. Add the package
 
 ```bash
@@ -164,23 +169,37 @@ import { UIProvider } from 'admin-ui-starter-kit/ui-provider';
 
 The provider is locked at first mount; pass everything once at the root.
 
-### 6. Install the AI agent skill (optional)
+### 6. Install the AI agent skills (optional)
+
+This package ships AI skills for Claude Code and other agents:
 
-This package ships a `component-library-rules` skill for Claude Code and other
-AI agents. After installing the package:
+- `component-library-rules` — maintainer rules for editing this library.
+- `admin-ui-consumer-migration` — consumer-app migration rules and guardrails.
+
+After installing the package:
 
 ```bash
 npx admin-ui-starter-kit-install-skill
 ```
 
-Copies the skill into your project's `.claude/skills/component-library-rules/`
-and `.agents/skills/component-library-rules/`. Run again to update after a
-package upgrade.
+Copies both skills into your project's `.claude/skills/` and
+`.agents/skills/`. Run again to update after a package upgrade.
 
 Flags:
+- `--skill=all|component-library-rules|admin-ui-consumer-migration` (default `all`)
 - `--target=claude|agents|both` (default `both`) — pick which directory to install into.
 - `--force` — overwrite without prompting.
 
+For migration checks in a consuming app:
+
+```bash
+npx admin-ui-starter-kit-audit
+npx admin-ui-starter-kit-audit --fix
+```
+
+The audit rejects stale copied imports, invalid package subpaths, and local
+files that only re-export package components.
+
 ---
 
 ## Browse the component showcase
@@ -283,22 +302,25 @@ utilities with optional peers:
 import { MetadataList } from 'admin-ui-starter-kit/base/display/metadata';
 ```
 
-Safe public entrypoints:
+Safe public entrypoint shapes:
 - `admin-ui-starter-kit` — provider, strings helpers, and `cn` only.
 - `admin-ui-starter-kit/ui-provider`
 - `admin-ui-starter-kit/typography`
-- `admin-ui-starter-kit/base/*`
+- `admin-ui-starter-kit/base/buttons`, `admin-ui-starter-kit/base/item`, etc.
 - `admin-ui-starter-kit/base/display/metadata`
-- `admin-ui-starter-kit/composed/*`
-- `admin-ui-starter-kit/features/*`
-- `admin-ui-starter-kit/layout` and `admin-ui-starter-kit/layout/*`
+- `admin-ui-starter-kit/composed/cards`, `admin-ui-starter-kit/composed/analytics`, etc.
+- `admin-ui-starter-kit/features/comments`, `admin-ui-starter-kit/features/filters`, etc.
+- `admin-ui-starter-kit/layout` and exact layout families such as `admin-ui-starter-kit/layout/page`
 - `admin-ui-starter-kit/lib/strings`
 - `admin-ui-starter-kit/lib/utils`
 
 Avoid broad component imports such as `admin-ui-starter-kit/base`,
 `admin-ui-starter-kit/composed`, or `admin-ui-starter-kit/features`; they are
 intentionally not exported. Use the exact family subpath so missing optional
-peers fail only when you import the feature that needs them.
+peers fail only when you import the feature that needs them. The package
+`exports` map lists each public family as an exact key; wildcard exports and
+null wildcard blockers are intentionally avoided because bundlers handle them
+inconsistently.
 
 Dropdown menus use Base UI's `render` prop for custom triggers, not Radix's
 `asChild` prop:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "admin-ui-starter-kit",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Opinionated React component kit for admin panels and SaaS dashboards, built on top of shadcn/ui + Tailwind CSS v4. Callback-driven, framework-agnostic, i18n-ready.",
   "type": "module",
   "license": "MIT",
@@ -29,6 +29,8 @@
   "files": [
     "dist",
     "README.md",
+    "MIGRATION.md",
+    "COMPONENT_SELECTION.md",
     "INTEGRATION.md",
     "CHANGELOG.md",
     "CONTRIBUTING.md",
@@ -39,10 +41,13 @@
     "CLAUDE.md",
     "AGENTS.md",
     ".agents/skills/component-library-rules",
+    ".agents/skills/admin-ui-consumer-migration",
+    "scripts/audit-consumer.mjs",
     "scripts/install-skill.mjs",
     "scripts/serve-showcase.mjs"
   ],
   "bin": {
+    "admin-ui-starter-kit-audit": "./scripts/audit-consumer.mjs",
     "admin-ui-starter-kit-install-skill": "./scripts/install-skill.mjs",
     "admin-ui-starter-kit-showcase": "./scripts/serve-showcase.mjs"
   },
@@ -91,39 +96,265 @@
       "import": "./dist/components/typography/index.js",
       "require": "./dist/components/typography/index.cjs"
     },
+    "./base/accordion": {
+      "types": "./dist/components/base/accordion/index.d.ts",
+      "import": "./dist/components/base/accordion/index.js",
+      "require": "./dist/components/base/accordion/index.cjs"
+    },
+    "./base/badge": {
+      "types": "./dist/components/base/badge/index.d.ts",
+      "import": "./dist/components/base/badge/index.js",
+      "require": "./dist/components/base/badge/index.cjs"
+    },
+    "./base/buttons": {
+      "types": "./dist/components/base/buttons/index.d.ts",
+      "import": "./dist/components/base/buttons/index.js",
+      "require": "./dist/components/base/buttons/index.cjs"
+    },
+    "./base/cards": {
+      "types": "./dist/components/base/cards/index.d.ts",
+      "import": "./dist/components/base/cards/index.js",
+      "require": "./dist/components/base/cards/index.cjs"
+    },
+    "./base/combobox": {
+      "types": "./dist/components/base/combobox/index.d.ts",
+      "import": "./dist/components/base/combobox/index.js",
+      "require": "./dist/components/base/combobox/index.cjs"
+    },
+    "./base/command": {
+      "types": "./dist/components/base/command/index.d.ts",
+      "import": "./dist/components/base/command/index.js",
+      "require": "./dist/components/base/command/index.cjs"
+    },
+    "./base/copyable": {
+      "types": "./dist/components/base/copyable/index.d.ts",
+      "import": "./dist/components/base/copyable/index.js",
+      "require": "./dist/components/base/copyable/index.cjs"
+    },
+    "./base/currency": {
+      "types": "./dist/components/base/currency/index.d.ts",
+      "import": "./dist/components/base/currency/index.js",
+      "require": "./dist/components/base/currency/index.cjs"
+    },
+    "./base/date-pickers": {
+      "types": "./dist/components/base/date-pickers/index.d.ts",
+      "import": "./dist/components/base/date-pickers/index.js",
+      "require": "./dist/components/base/date-pickers/index.cjs"
+    },
+    "./base/display": {
+      "types": "./dist/components/base/display/index.d.ts",
+      "import": "./dist/components/base/display/index.js",
+      "require": "./dist/components/base/display/index.cjs"
+    },
     "./base/display/metadata": {
       "types": "./dist/components/base/display/metadata/index.d.ts",
       "import": "./dist/components/base/display/metadata/index.js",
       "require": "./dist/components/base/display/metadata/index.cjs"
     },
-    "./base/*/*": null,
-    "./base/*": {
-      "types": "./dist/components/base/*/index.d.ts",
-      "import": "./dist/components/base/*/index.js",
-      "require": "./dist/components/base/*/index.cjs"
-    },
-    "./composed/*/*": null,
-    "./composed/*": {
-      "types": "./dist/components/composed/*/index.d.ts",
-      "import": "./dist/components/composed/*/index.js",
-      "require": "./dist/components/composed/*/index.cjs"
-    },
-    "./features/*/*": null,
-    "./features/*": {
-      "types": "./dist/components/features/*/index.d.ts",
-      "import": "./dist/components/features/*/index.js",
-      "require": "./dist/components/features/*/index.cjs"
+    "./base/event-calendar": {
+      "types": "./dist/components/base/event-calendar/index.d.ts",
+      "import": "./dist/components/base/event-calendar/index.js",
+      "require": "./dist/components/base/event-calendar/index.cjs"
+    },
+    "./base/forms": {
+      "types": "./dist/components/base/forms/index.d.ts",
+      "import": "./dist/components/base/forms/index.js",
+      "require": "./dist/components/base/forms/index.cjs"
+    },
+    "./base/item": {
+      "types": "./dist/components/base/item/index.d.ts",
+      "import": "./dist/components/base/item/index.js",
+      "require": "./dist/components/base/item/index.cjs"
+    },
+    "./base/map": {
+      "types": "./dist/components/base/map/index.d.ts",
+      "import": "./dist/components/base/map/index.js",
+      "require": "./dist/components/base/map/index.cjs"
+    },
+    "./base/navigation": {
+      "types": "./dist/components/base/navigation/index.d.ts",
+      "import": "./dist/components/base/navigation/index.js",
+      "require": "./dist/components/base/navigation/index.cjs"
+    },
+    "./base/popover": {
+      "types": "./dist/components/base/popover/index.d.ts",
+      "import": "./dist/components/base/popover/index.js",
+      "require": "./dist/components/base/popover/index.cjs"
+    },
+    "./base/popover-menu": {
+      "types": "./dist/components/base/popover-menu/index.d.ts",
+      "import": "./dist/components/base/popover-menu/index.js",
+      "require": "./dist/components/base/popover-menu/index.cjs"
+    },
+    "./base/sheet": {
+      "types": "./dist/components/base/sheet/index.d.ts",
+      "import": "./dist/components/base/sheet/index.js",
+      "require": "./dist/components/base/sheet/index.cjs"
+    },
+    "./base/sidebar": {
+      "types": "./dist/components/base/sidebar/index.d.ts",
+      "import": "./dist/components/base/sidebar/index.js",
+      "require": "./dist/components/base/sidebar/index.cjs"
+    },
+    "./base/spinner": {
+      "types": "./dist/components/base/spinner/index.d.ts",
+      "import": "./dist/components/base/spinner/index.js",
+      "require": "./dist/components/base/spinner/index.cjs"
+    },
+    "./base/table": {
+      "types": "./dist/components/base/table/index.d.ts",
+      "import": "./dist/components/base/table/index.js",
+      "require": "./dist/components/base/table/index.cjs"
+    },
+    "./base/toaster": {
+      "types": "./dist/components/base/toaster/index.d.ts",
+      "import": "./dist/components/base/toaster/index.js",
+      "require": "./dist/components/base/toaster/index.cjs"
+    },
+    "./composed/admin": {
+      "types": "./dist/components/composed/admin/index.d.ts",
+      "import": "./dist/components/composed/admin/index.js",
+      "require": "./dist/components/composed/admin/index.cjs"
+    },
+    "./composed/ai": {
+      "types": "./dist/components/composed/ai/index.d.ts",
+      "import": "./dist/components/composed/ai/index.js",
+      "require": "./dist/components/composed/ai/index.cjs"
+    },
+    "./composed/analytics": {
+      "types": "./dist/components/composed/analytics/index.d.ts",
+      "import": "./dist/components/composed/analytics/index.js",
+      "require": "./dist/components/composed/analytics/index.cjs"
+    },
+    "./composed/cards": {
+      "types": "./dist/components/composed/cards/index.d.ts",
+      "import": "./dist/components/composed/cards/index.js",
+      "require": "./dist/components/composed/cards/index.cjs"
+    },
+    "./composed/commerce": {
+      "types": "./dist/components/composed/commerce/index.d.ts",
+      "import": "./dist/components/composed/commerce/index.js",
+      "require": "./dist/components/composed/commerce/index.cjs"
+    },
+    "./composed/dark-surfaces": {
+      "types": "./dist/components/composed/dark-surfaces/index.d.ts",
+      "import": "./dist/components/composed/dark-surfaces/index.js",
+      "require": "./dist/components/composed/dark-surfaces/index.cjs"
+    },
+    "./composed/data-display": {
+      "types": "./dist/components/composed/data-display/index.d.ts",
+      "import": "./dist/components/composed/data-display/index.js",
+      "require": "./dist/components/composed/data-display/index.cjs"
+    },
+    "./composed/navigation": {
+      "types": "./dist/components/composed/navigation/index.d.ts",
+      "import": "./dist/components/composed/navigation/index.js",
+      "require": "./dist/components/composed/navigation/index.cjs"
+    },
+    "./composed/onboarding": {
+      "types": "./dist/components/composed/onboarding/index.d.ts",
+      "import": "./dist/components/composed/onboarding/index.js",
+      "require": "./dist/components/composed/onboarding/index.cjs"
+    },
+    "./composed/timelines": {
+      "types": "./dist/components/composed/timelines/index.d.ts",
+      "import": "./dist/components/composed/timelines/index.js",
+      "require": "./dist/components/composed/timelines/index.cjs"
+    },
+    "./features/activities": {
+      "types": "./dist/components/features/activities/index.d.ts",
+      "import": "./dist/components/features/activities/index.js",
+      "require": "./dist/components/features/activities/index.cjs"
+    },
+    "./features/ai-chat": {
+      "types": "./dist/components/features/ai-chat/index.d.ts",
+      "import": "./dist/components/features/ai-chat/index.js",
+      "require": "./dist/components/features/ai-chat/index.cjs"
+    },
+    "./features/card": {
+      "types": "./dist/components/features/card/index.d.ts",
+      "import": "./dist/components/features/card/index.js",
+      "require": "./dist/components/features/card/index.cjs"
+    },
+    "./features/comments": {
+      "types": "./dist/components/features/comments/index.d.ts",
+      "import": "./dist/components/features/comments/index.js",
+      "require": "./dist/components/features/comments/index.cjs"
+    },
+    "./features/event-log": {
+      "types": "./dist/components/features/event-log/index.d.ts",
+      "import": "./dist/components/features/event-log/index.js",
+      "require": "./dist/components/features/event-log/index.cjs"
+    },
+    "./features/filters": {
+      "types": "./dist/components/features/filters/index.d.ts",
+      "import": "./dist/components/features/filters/index.js",
+      "require": "./dist/components/features/filters/index.cjs"
+    },
+    "./features/global-search": {
+      "types": "./dist/components/features/global-search/index.d.ts",
+      "import": "./dist/components/features/global-search/index.js",
+      "require": "./dist/components/features/global-search/index.cjs"
+    },
+    "./features/kanban": {
+      "types": "./dist/components/features/kanban/index.d.ts",
+      "import": "./dist/components/features/kanban/index.js",
+      "require": "./dist/components/features/kanban/index.cjs"
+    },
+    "./features/mentions": {
+      "types": "./dist/components/features/mentions/index.d.ts",
+      "import": "./dist/components/features/mentions/index.js",
+      "require": "./dist/components/features/mentions/index.cjs"
+    },
+    "./features/overlays": {
+      "types": "./dist/components/features/overlays/index.d.ts",
+      "import": "./dist/components/features/overlays/index.js",
+      "require": "./dist/components/features/overlays/index.cjs"
+    },
+    "./features/rich-text-editor": {
+      "types": "./dist/components/features/rich-text-editor/index.d.ts",
+      "import": "./dist/components/features/rich-text-editor/index.js",
+      "require": "./dist/components/features/rich-text-editor/index.cjs"
+    },
+    "./features/suggestions": {
+      "types": "./dist/components/features/suggestions/index.d.ts",
+      "import": "./dist/components/features/suggestions/index.js",
+      "require": "./dist/components/features/suggestions/index.cjs"
+    },
+    "./features/sync": {
+      "types": "./dist/components/features/sync/index.d.ts",
+      "import": "./dist/components/features/sync/index.js",
+      "require": "./dist/components/features/sync/index.cjs"
     },
     "./layout": {
       "types": "./dist/components/layout/index.d.ts",
       "import": "./dist/components/layout/index.js",
       "require": "./dist/components/layout/index.cjs"
     },
-    "./layout/*/*": null,
-    "./layout/*": {
-      "types": "./dist/components/layout/*/index.d.ts",
-      "import": "./dist/components/layout/*/index.js",
-      "require": "./dist/components/layout/*/index.cjs"
+    "./layout/containers": {
+      "types": "./dist/components/layout/containers/index.d.ts",
+      "import": "./dist/components/layout/containers/index.js",
+      "require": "./dist/components/layout/containers/index.cjs"
+    },
+    "./layout/page": {
+      "types": "./dist/components/layout/page/index.d.ts",
+      "import": "./dist/components/layout/page/index.js",
+      "require": "./dist/components/layout/page/index.cjs"
+    },
+    "./layout/header": {
+      "types": "./dist/components/layout/header/index.d.ts",
+      "import": "./dist/components/layout/header/index.js",
+      "require": "./dist/components/layout/header/index.cjs"
+    },
+    "./layout/sidebar": {
+      "types": "./dist/components/layout/sidebar/index.d.ts",
+      "import": "./dist/components/layout/sidebar/index.js",
+      "require": "./dist/components/layout/sidebar/index.cjs"
+    },
+    "./layout/hooks": {
+      "types": "./dist/components/layout/hooks/index.d.ts",
+      "import": "./dist/components/layout/hooks/index.js",
+      "require": "./dist/components/layout/hooks/index.cjs"
     },
     "./lib/strings": {
       "types": "./dist/lib/strings.d.ts",