ionbase-ui 0.19.0 → 0.20.0

package/dist/meta/components.json

@@ -1,6 +1,6 @@
 {
   "package": "ionbase-ui",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "generated": "by scripts/build-meta.mjs — do not edit; intent lives in meta/*.json",
   "hooks": [
     "useToast"

package/dist/meta/index.json

@@ -1,6 +1,6 @@
 {
   "package": "ionbase-ui",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "usage": "Pick a component here, then read dist/meta/<Name>.json for its full contract.",
   "hooks": [
     "useToast"

package/llms.txt

@@ -0,0 +1,27 @@
+# ionbase-ui
+
+> IonBase is a React design system for enterprise SaaS, built to be consumed by an agent rather than read by a developer. Every component ships a machine-readable contract carrying the judgement a type signature cannot: when to use it, what to use instead, the anti-patterns, and what it guarantees for accessibility versus what it requires of you.
+
+Version 0.20.0. 35 components.
+
+## Read these, in this order
+
+1. `dist/meta/index.json` — every component with its summary and variant axes. Pick one from here.
+2. `dist/meta/<Name>.json` — the full contract for that one component: props with their origins and defaults, variant guidance, slots, accessibility guarantees and requirements, anti-patterns, tokens.
+
+Both are importable: `ionbase-ui/meta/index` and `ionbase-ui/meta/<Name>.json`. Do NOT load `ionbase-ui/meta` (`components.json`) — it is all 35 contracts in one file, for tooling that wants a single fetch, and it will bury the component you need.
+
+## Components
+
+`Alert`, `Avatar`, `AvatarGroup`, `Badge`, `Button`, `Checkbox`, `Divider`, `FullCard`, `Header`, `Icon`, `Input`, `Link`, `Logo`, `LogoMark`, `Menu`, `MenuItem`, `Modal`, `NavItem`, `PhoneInput`, `Popover`, `Radio`, `RadioGroup`, `ScrollProgress`, `Select`, `TabItem`, `Table`, `TableBody`, `TableCell`, `TableHead`, `TableRow`, `Tabs`, `Toast`, `ToastProvider`, `Toggle`, `Tooltip`
+
+## Rules that ship with this package
+
+- `ionbase-ui/eslint-plugin` — five rules driven from the contracts: deprecated props, missing accessible names, raw style values, measured contrast failures, competing primary actions.
+- `ionbase-ui/stylelint-config` — bans raw colour and spacing values in favour of tokens.
+
+Turn both on. They encode the same judgement as the contracts, enforced.
+
+## Hosted
+
+https://raza-ahmed.github.io/ionbase-design-system/llms.txt — the same index with per-component markdown pages.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ionbase-ui",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "IonBase Design System — accessible React components, styles and design tokens in one package",
   "license": "MIT",
   "type": "module",
@@ -22,6 +22,7 @@
       "types": "./dist/tokens-js.d.ts",
       "default": "./dist/tokens-js.js"
     },
+    "./llms.txt": "./llms.txt",
     "./stylelint-config": "./stylelint-config.js",
     "./eslint-plugin": "./eslint-plugin/index.js"
   },
@@ -38,7 +39,8 @@
   "files": [
     "dist",
     "eslint-plugin",
-    "stylelint-config.js"
+    "stylelint-config.js",
+    "llms.txt"
   ],
   "sideEffects": [
     "**/*.css"
@@ -57,7 +59,7 @@
   },
   "scripts": {
     "dev": "tsc --watch",
-    "build": "node scripts/sync-tokens.mjs && tsc --build --force && node scripts/copy-css.mjs && node scripts/verify-client-boundaries.mjs && node scripts/verify-contrast.mjs && node scripts/build-meta.mjs && node scripts/verify-meta.mjs",
+    "build": "node scripts/sync-tokens.mjs && tsc --build --force && node scripts/copy-css.mjs && node scripts/verify-client-boundaries.mjs && node scripts/verify-contrast.mjs && node scripts/build-meta.mjs && node scripts/verify-meta.mjs && node scripts/build-llms.mjs",
     "typecheck": "tsc --noEmit",
     "lint": "eslint . && stylelint \"src/styles/*.css\"",
     "format": "prettier --check .",
@@ -65,7 +67,8 @@
     "meta:build": "node scripts/build-meta.mjs",
     "meta:verify": "node scripts/build-meta.mjs && node scripts/verify-meta.mjs",
     "contrast": "node scripts/verify-contrast.mjs",
-    "contrast:list": "node scripts/verify-contrast.mjs --list"
+    "contrast:list": "node scripts/verify-contrast.mjs --list",
+    "llms": "node scripts/build-llms.mjs"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",