@nadicodeai/ui 0.22.0 → 1.0.1

package/docs/migration/1.0.0.md

@@ -0,0 +1,75 @@
+# Migrating to `@nadicodeai/ui` 1.0.0
+
+This release makes material hierarchy and Agent identity package-owned. It
+also publishes the previously held status-vocabulary break.
+
+## Status
+
+`StatusTag` and `StateTag` are removed. Use `Badge` with one of its five
+semantic tones. The consuming app owns the status word, icon, and tone mapping.
+
+```tsx
+import { Badge } from "@nadicodeai/ui/components/badge";
+
+<Badge variant="green">Ready</Badge>;
+```
+
+The retired `.nc-status-tag`, `.nc-state-tag`, and `.nc-state-row` CSS classes
+have no replacement CSS API.
+
+## Material and Card
+
+Import `@nadicodeai/ui/globals.css` once. It now composes
+`shadow-plugin@1.2.7`; consumers do not install its classes or override its
+ring.
+
+`Card` defaults to `surface="resting"`. Use `surface="raised"` only for work
+that is physically raised or selected, and `surface="plain"` for the explicit
+structural/auth/website escape. `variant` continues to describe interaction.
+Replace the removed `variant="borderless"` with `surface="plain"`.
+
+```tsx
+<Card>Resting content</Card>
+<Card surface="raised">Selected work</Card>
+<Card surface="plain">Structural content</Card>
+```
+
+Overlay primitives now own floating or modal elevation internally. Remove
+caller `border-*`, `ring-*`, `shadow-*`, and `smooth-shadow-*` appearance
+classes from their content roots.
+
+## Empty and glass control
+
+Set Empty containment explicitly when nesting matters:
+
+```tsx
+<Empty scope="region">No agents</Empty>
+<Card><Empty scope="card">No runs</Empty></Card>
+```
+
+Use `GlassControl shape="control"` for compact controls and `shape="bar"` for
+full-width header chrome. Both float over legible content. Cards and modal
+primitives continue to contain page content and dialog bodies.
+
+## Agent identity
+
+Agent identity is available from direct component subpaths. The
+`@nadicodeai/ui/agents` entry remains the client-only assistant conversation
+and runtime interface.
+
+```tsx
+import { AgentCard } from "@nadicodeai/ui/components/agent-card";
+import { AgentVisual } from "@nadicodeai/ui/components/agent-visual";
+
+<AgentCard
+  name={agent.name}
+  job={agent.job}
+  status={<Badge variant="blue">Running</Badge>}
+  visual={<AgentVisual recipe={agent.recipe} presentation="card" />}
+/>;
+```
+
+Recipe assignment is app-owned and explicit. Do not infer it from a free-form
+role, hash an identifier, or randomize it. `AgentVisual` accepts only the five
+closed recipes and three presentations; raw shader controls are intentionally
+not public. `AgentGlyph` and `AgentRow` do not exist in the 1.0.0 API.

package/llms.txt

@@ -13,6 +13,8 @@ Use this file as a map; read the owning document before changing behavior.
 - Current published subpaths: `package.json` `exports` plus the generated
   `dist/components/**/*.d.ts` declarations in an installed package.
 - Public Agent UI interface: `src/agents.ts`, exported as `@nadicodeai/ui/agents`.
+- Material, Card, Empty, glass-control, AgentVisual, and AgentCard semantics:
+  `docs/contract.md`; 1.0 adoption steps: `docs/migration/1.0.0.md`.
 - Maintained conversation implementation: `src/internal/assistant-ui/`.
 - Product compositions and sections: `docs/product-compositions.md` and
   `docs/product-sections.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/ui",
-  "version": "0.22.0",
+  "version": "1.0.1",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -38,6 +38,8 @@
   },
   "files": [
     "dist",
+    "LICENSES",
+    "NOTICE",
     "README.md",
     "AGENTS.md",
     "llms.txt",
@@ -47,11 +49,13 @@
   "scripts": {
     "dev": "node scripts/dev-build.mjs --watch",
     "build": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/fix-dist-imports.mjs && node scripts/build-styles.mjs && node scripts/build-eslint.mjs",
-    "build:fast": "node scripts/dev-build.mjs",
+    "build:dev": "node scripts/dev-build.mjs",
     "generate:brand-icons": "node scripts/build-brand-icons.mjs",
     "prepack": "npm run build",
     "lint": "eslint --max-warnings=0",
     "typecheck": "tsc --noEmit",
+    "check": "npm run lint && npm run typecheck",
+    "check:static": "npm run check",
     "pretest": "npm run build",
     "test": "vitest run"
   },
@@ -59,7 +63,8 @@
     "@assistant-ui/react": "0.15.1",
     "@assistant-ui/react-markdown": "0.14.8",
     "@base-ui/react": "^1.6.0",
-    "@nadicodeai/design-system": "0.22.0",
+    "@nadicodeai/design-system": "1.0.1",
+    "@paper-design/shaders": "0.0.78",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
@@ -72,8 +77,9 @@
     "react-hook-form": "^7.80.0",
     "react-resizable-panels": "^4.11.2",
     "recharts": "^3.8.0",
-    "sonner": "^2.0.7",
     "remark-gfm": "^4.0.1",
+    "shadow-plugin": "1.2.7",
+    "sonner": "^2.0.7",
     "tailwind-merge": "^3.0.0",
     "tw-animate-css": "^1.4.0",
     "tw-shimmer": "0.4.12",

package/skills/nadicodeai-ui/SKILL.md

@@ -40,12 +40,18 @@ Product component imports:
 
 ```tsx
 import { DashboardShell } from "@nadicodeai/ui/components/dashboard-shell";
+import { AgentCard } from "@nadicodeai/ui/components/agent-card";
+import { AgentVisual } from "@nadicodeai/ui/components/agent-visual";
 import { Thread } from "@nadicodeai/ui/agents";
 ```
 
 ## Product Components
 
-- Use `@nadicodeai/ui/agents` for Agent presentation, runtime primitives, providers, hooks, and types. Do not import assistant-ui packages directly or recreate their behavior.
+- Use `@nadicodeai/ui/agents` for assistant-ui conversation primitives, providers, hooks, runtimes, and types. It is a client-only entry; do not import assistant-ui packages directly or recreate their behavior.
+- Import Agent identity from `@nadicodeai/ui/components/agent-card` and `@nadicodeai/ui/components/agent-visual`. Direct subpaths keep the Card composition server-compatible and the animated visual at a client leaf.
+- Use `AgentVisual` with an explicit closed recipe and `registry`, `card`, or `detail` presentation; every role renders the living identity when motion and WebGL are available. The poster is first paint and fallback. Never infer or randomize identity from a free-form role. Compose it through `AgentCard` when the Agent is a recognizable content object. There is no `AgentGlyph` or `AgentRow`.
+- `Card` defaults to the resting material. Select `surface="raised"` for physically raised/selected work and `surface="plain"` for an intentional structural/auth/website escape. Do not add border, ring, or shadow classes at call sites.
+- Use `Empty scope="page|region|card"` so only the owning container draws a frame. Use `GlassControl shape="control"` for compact floating controls and `shape="bar"` for full-width header chrome, never content or modal bodies.
 - Use first-party shadcn registry source in the consuming app for generic data tables, command palettes, and chart cards; do not import a NadicodeAI package abstraction for those patterns.
 - Keep routes, data, auth, server actions, persistence, permission decisions, runtime adapters, analytics, and product-specific copy in the consuming app.
 - Fixtures must be synthetic or redacted and cover provider, model, plugin, approval, diff, terminal, installer recovery, queued, streaming, and interrupted states. Do not use generic SaaS/card-grid filler, secrets, environment values, raw terminal output, hidden reasoning, user memory, fake customers, or fake proof metrics.