neba 1.13.0 → 1.15.0

package/dist/types.d.ts

@@ -27,7 +27,7 @@ export type NebaOrientation = 'horizontal' | 'vertical';
  * Which edge of an anchor something is placed against. Tooltip reads this, and
  * so does anything else that hangs a popup off an element.
  *
- * Logical rather than physical — `start`/`end` would be wrong here, because a
+ * Physical rather than logical — `start`/`end` would be wrong here, because a
  * tooltip above a button is above it in every writing direction.
  */
 export type NebaSide = 'top' | 'right' | 'bottom' | 'left';
@@ -86,6 +86,24 @@ export type NebaWeekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
  * would be reporting a day nobody chose.
  */
 export type NebaDateGranularity = 'day' | 'month' | 'year';
+/**
+ * How far a piece of work an agent is doing has got.
+ *
+ * One vocabulary rather than one per component, for the reason `NebaSize` is
+ * one: a tool call and a step of a plan are the same lifecycle seen at two
+ * scales, and a library that said `running` on one and `current` on the other
+ * would make a caller translate between them in the middle of a transcript.
+ * [Timeline](../components/display/timeline) keeps its own three words on
+ * purpose — a step of a checkout is `upcoming` rather than `pending`, because
+ * nothing is waiting on it.
+ *
+ * Four, and the list is closed. `success` and `error` are two endings and not
+ * one `done` with a flag beside it, because what a reader needs from a failed
+ * step is the thing a boolean would bury; and there is no `cancelled`, because
+ * a run that was stopped ended without succeeding, which is what `error`
+ * already says.
+ */
+export type NebaRunStatus = 'pending' | 'running' | 'success' | 'error';
 /**
  * The viewport widths the layout components branch on, smallest first.
  *
@@ -280,8 +298,12 @@ export interface NebaAnimateProps {
     paused?: boolean;
     /** What starts it. @default 'mount' */
     trigger?: NebaAnimateTrigger;
-    /** Runs it, when `trigger` is `manual`. Each `false` → `true` starts it over. */
-    play?: boolean;
+    /**
+     * Runs it, when `trigger` is `manual`. Each `false` → `true` starts it over,
+     * and so does a number that changes: a count of failed attempts replays a
+     * shake on every failure without remounting what is inside it. `0` is stopped.
+     */
+    play?: boolean | number;
     /**
      * With `trigger="visible"`, whether it runs only the first time. Off, it runs
      * again every time the element comes back into view.
@@ -359,7 +381,8 @@ export interface NebaTransitionOptions {
  * A bare effect name is the whole of what most callers want —
  * `transition="fade"` — and the object form is there for the rest.
  *
- * It runs on mount and once. Anything else — replaying on scroll, on hover, or
+ * It runs on mount and once, except `blink`, which repeats until its `repeat`
+ * says otherwise: a blink that ran once would be a flicker. Anything else — replaying on scroll, on hover, or
  * under your own control — is what the `Animate*` components are, and any
  * component can be wrapped in one. This prop exists so the common case does not
  * need an extra element in the tree.
@@ -527,7 +550,7 @@ export interface NebaChartTooltipContext {
 }
 /** The tooltip, when a bare `true` or `false` is not enough. */
 export interface NebaChartTooltip {
-    /** @default 'index' */
+    /** @default 'index', or 'item' on ScatterChart and TimelineChart */
     mode?: NebaChartTooltipMode;
     /**
      * The line dropped through the plot at the active category. On in `index`
@@ -558,8 +581,12 @@ export interface NebaChartAxis {
     max?: number;
     /** Roughly how many ticks. The scale still rounds to clean numbers. */
     tickCount?: number;
-    /** How a tick is written, overriding the chart's own `format`. */
-    tickFormat?: (value: NebaChartCategory, index: number) => React.ReactNode;
+    /**
+     * How a tick is written, overriding the chart's own `format`. A tick is SVG
+     * text, so this returns a string or a number: an element has nowhere to go and
+     * was written out as `[object Object]`.
+     */
+    tickFormat?: (value: NebaChartCategory, index: number) => string | number;
     /**
      * How much room the axis keeps for its ticks and its label, in pixels.
      * Measured from the ticks themselves otherwise; set it when a long category

package/dist/types.js

@@ -1,8 +0,0 @@
-/**
- * Shared prop vocabulary for every Neba component.
- *
- * These names and values are deliberately generic: a `size` of `md` or a
- * `color` of `primary` has to mean the same thing on a Button, a Chip, a
- * TextField or a Dialog. Components pick the subset they need from here and
- * never invent a parallel spelling of the same idea.
- */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neba",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "A comprehensive React UI component library — buttons, fields, menus, dialogs, tables and much more — accessible and themeable, sharing one prop vocabulary and a translucent acrylic design language. ESM only, types included, dark mode built in.",
   "type": "module",
   "types": "dist/index.d.ts",
@@ -19,22 +19,24 @@
   },
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
-    "build": "npm run clean && npm run format:fix && tsc --project tsconfig.prod.json && node scripts/annotate-pure.mjs && npm run minify && node scripts/build-styles.mjs",
+    "build": "npm run clean && npm run format:fix && tsc --project tsconfig.prod.json && node scripts/annotate-pure.mjs && npm run minify && node scripts/build-styles.mjs && node scripts/build-catalog.mjs",
     "lint": "eslint . --report-unused-disable-directives",
     "lint:fix": "eslint . --report-unused-disable-directives --fix",
-    "minify": "terser-glob 'dist/**/*.js' --config-file terser.config.json",
+    "minify": "node scripts/minify.mjs",
     "size": "node scripts/measure-bundle.mjs",
     "size:update": "node scripts/measure-bundle.mjs --update",
+    "compat": "node scripts/check-browsers.mjs",
     "prepare": "npm run build",
     "format": "prettier .",
     "format:fix": "prettier . --write",
     "docs:changelog": "node scripts/copy-changelog.mjs",
-    "docs:dev": "npm run docs:changelog && vitepress dev docs",
-    "docs:build": "npm run docs:changelog && node --max-old-space-size=8192 ./node_modules/vitepress/bin/vitepress.js build docs",
+    "docs:dev": "npm run docs:changelog && npm run docs:catalog && vitepress dev docs",
+    "docs:build": "npm run docs:changelog && npm run docs:catalog && node --max-old-space-size=8192 ./node_modules/vitepress/bin/vitepress.js build docs",
     "docs:serve": "npm run docs:build && vitepress serve docs",
     "test": "node scripts/run-tests.mjs",
     "test:watch": "vitest",
-    "typecheck": "tsc --project tsconfig.prod.json --noEmit && tsc --project test/tsconfig.json && tsc --project docs/tsconfig.json"
+    "typecheck": "tsc --project tsconfig.prod.json --noEmit && tsc --project test/tsconfig.json && tsc --project docs/tsconfig.json",
+    "docs:catalog": "node scripts/build-catalog.mjs --docs"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -69,6 +71,12 @@
     "./styles.css": "./dist/styles.css",
     "./tailwind.css": "./dist/tailwind.css",
     "./package.json": "./package.json",
+    "./a2ui": {
+      "types": "./dist/a2ui/index.d.ts",
+      "module": "./dist/a2ui/index.js",
+      "default": "./dist/a2ui/index.js"
+    },
+    "./a2ui/catalog.json": "./dist/a2ui/catalog.json",
     "./*": {
       "types": "./dist/components/*/index.d.ts",
       "module": "./dist/components/*/index.js",
@@ -89,6 +97,12 @@
       "locales/*": [
         "dist/locales/*.d.ts"
       ],
+      "hooks": [
+        "dist/hooks/index.d.ts"
+      ],
+      "a2ui": [
+        "dist/a2ui/index.d.ts"
+      ],
       "*": [
         "dist/components/*/index.d.ts"
       ]
@@ -137,7 +151,10 @@
     "form"
   ],
   "devDependencies": {
+    "@a2ui/react": "^0.11.1",
+    "@a2ui/web_core": "^0.11.0",
     "@eslint/js": "^9.39.1",
+    "@mdn/browser-compat-data": "^8.1.1",
     "@tailwindcss/postcss": "^4.3.3",
     "@types/node": "^26.4.1",
     "@types/react": "^19.2.18",
@@ -159,7 +176,7 @@
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "tailwindcss": "^4.3.3",
-    "terser-glob": "^1.2.1",
+    "terser": "^5.51.2",
     "tsx": "^4.23.13",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.69.0",
@@ -168,7 +185,8 @@
     "vitepress-i18n": "^1.4.0",
     "vitepress-sidebar": "^1.40.0",
     "vitest": "^5.0.0",
-    "vitest-browser-react": "^2.3.0"
+    "vitest-browser-react": "^2.3.0",
+    "zod": "^3.25.76"
   },
   "dependencies": {
     "@base-ui/react": "^1.8.0",
@@ -177,11 +195,27 @@
   "peerDependencies": {
     "@types/react": "^18.0.0 || ^19.0.0",
     "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "@a2ui/react": "^0.11.0",
+    "@a2ui/web_core": "^0.11.0",
+    "zod": "^3.25.76"
   },
   "peerDependenciesMeta": {
     "@types/react": {
       "optional": true
+    },
+    "@a2ui/react": {
+      "optional": true
+    },
+    "@a2ui/web_core": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
     }
+  },
+  "allowScripts": {
+    "esbuild": false,
+    "fsevents": false
   }
 }