@elizaos/ui 2.0.0-alpha.25 → 2.0.0-alpha.334

package/package.json

@@ -1,51 +1,95 @@
 {
   "name": "@elizaos/ui",
-  "version": "2.0.0-alpha.25",
-  "description": "Reusable UI primitives and components for elizaOS applications.",
+  "version": "2.0.0-alpha.334",
+  "description": "Shared UI primitives, composites, and layout utilities for elizaOS apps.",
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "license": "MIT",
-  "homepage": "https://elizaos.ai",
+  "homepage": "https://github.com/elizaOS/eliza",
   "repository": {
     "type": "git",
-    "url": "https://github.com/elizaos/eliza.git",
+    "url": "https://github.com/elizaOS/eliza.git",
     "directory": "packages/ui"
   },
   "keywords": [
     "elizaos",
     "ui",
     "react",
-    "components"
+    "design-system"
   ],
-  "scripts": {
-    "clean": "rm -rf dist && find src -type f \\( -name '*.js' -o -name '*.d.ts' -o -name '*.d.ts.map' -o -name '*.js.map' \\) -delete",
-    "build": "bun run build:dist",
-    "build:dist": "find src -type f \\( -name '*.js' -o -name '*.d.ts' -o -name '*.d.ts.map' -o -name '*.js.map' \\) -delete && rm -rf dist && tsc -p tsconfig.build.json && find src -type f \\( -name '*.js' -o -name '*.d.ts' -o -name '*.d.ts.map' -o -name '*.js.map' \\) -delete && node ../../scripts/copy-package-assets.mjs packages/ui src/styles && node ../../scripts/prepare-package-dist.mjs packages/ui",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "lint": "bunx @biomejs/biome check --write ./src/index.ts ./src/lib ./src/components ./src/stories",
-    "lint:check": "bunx @biomejs/biome check ./src/index.ts ./src/lib ./src/components ./src/stories",
-    "pack:dry-run": "cd dist && npm pack --dry-run",
-    "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build"
-  },
+  "main": "./packages/ui/src/index.js",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./packages/ui/src/index.d.ts",
+      "import": "./packages/ui/src/index.js",
+      "default": "./packages/ui/src/index.js"
+    },
+    "./components/*": {
+      "types": "./packages/ui/src/components/*.d.ts",
+      "import": "./packages/ui/src/components/*.js",
+      "default": "./packages/ui/src/components/*.js"
+    },
+    "./components/*/*": {
+      "types": "./packages/ui/src/components/*/*.d.ts",
+      "import": "./packages/ui/src/components/*/*.js",
+      "default": "./packages/ui/src/components/*/*.js"
+    },
+    "./components/*/*/*": {
+      "types": "./packages/ui/src/components/*/*/*.d.ts",
+      "import": "./packages/ui/src/components/*/*/*.js",
+      "default": "./packages/ui/src/components/*/*/*.js"
+    },
+    "./components/ui/*": {
+      "types": "./packages/ui/src/components/ui/*.tsx.d.ts",
+      "import": "./packages/ui/src/components/ui/*.tsx.js",
+      "default": "./packages/ui/src/components/ui/*.tsx.js"
+    },
+    "./components/composites/page-panel": {
+      "types": "./packages/ui/src/components/composites/page-panel/index.d.ts",
+      "import": "./packages/ui/src/components/composites/page-panel/index.js",
+      "default": "./packages/ui/src/components/composites/page-panel/index.js"
+    },
+    "./components/composites/*": {
+      "types": "./packages/ui/src/components/composites/*.d.ts",
+      "import": "./packages/ui/src/components/composites/*.js",
+      "default": "./packages/ui/src/components/composites/*.js"
+    },
+    "./components/composites/*/*": {
+      "types": "./packages/ui/src/components/composites/*/*.tsx.d.ts",
+      "import": "./packages/ui/src/components/composites/*/*.tsx.js",
+      "default": "./packages/ui/src/components/composites/*/*.tsx.js"
     },
-    "./utils": {
-      "types": "./dist/lib/utils.d.ts",
-      "import": "./dist/lib/utils.js"
+    "./hooks": {
+      "types": "./packages/ui/src/hooks/index.d.ts",
+      "import": "./packages/ui/src/hooks/index.js",
+      "default": "./packages/ui/src/hooks/index.js"
+    },
+    "./hooks/*": {
+      "types": "./packages/ui/src/hooks/*.d.ts",
+      "import": "./packages/ui/src/hooks/*.js",
+      "default": "./packages/ui/src/hooks/*.js"
+    },
+    "./layouts": {
+      "types": "./packages/ui/src/layouts/index.d.ts",
+      "import": "./packages/ui/src/layouts/index.js",
+      "default": "./packages/ui/src/layouts/index.js"
+    },
+    "./layouts/*": {
+      "types": "./packages/ui/src/layouts/*.d.ts",
+      "import": "./packages/ui/src/layouts/*.js",
+      "default": "./packages/ui/src/layouts/*.js"
+    },
+    "./lib/*": {
+      "types": "./packages/ui/src/lib/*.d.ts",
+      "import": "./packages/ui/src/lib/*.js",
+      "default": "./packages/ui/src/lib/*.js"
+    },
+    "./styles/*": {
+      "types": "./packages/ui/src/styles/*.d.ts",
+      "import": "./packages/ui/src/styles/*.js",
+      "default": "./packages/ui/src/styles/*.js"
     },
-    "./styles/theme.css": "./src/styles/theme.css",
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist",
-    "src/styles/theme.css",
-    "README.md"
-  ],
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
@@ -65,30 +109,13 @@
     "@radix-ui/react-tooltip": "^1.2.8",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.575.0",
-    "next-themes": "^0.4.6",
+    "lucide-react": "^1.0.0",
     "sonner": "^2.0.7",
-    "tailwind-merge": "^2.6.0"
+    "tailwind-merge": "^3.0.0"
   },
   "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "@storybook/addon-essentials": "8.6.14",
-    "@storybook/blocks": "8.6.14",
-    "@storybook/react": "8.6.14",
-    "@storybook/react-vite": "8.6.14",
-    "@storybook/test": "8.6.14",
-    "@tailwindcss/vite": "^4.2.1",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "storybook": "8.6.17",
-    "tailwindcss": "^4.1.18",
-    "typescript": "^5.9.3"
-  },
-  "author": "elizaOS Team",
-  "engines": {
-    "node": ">=18.0.0"
+    "access": "public",
+    "directory": "dist"
   },
-  "gitHead": "d4610addb338f1c08c2910c2ad2e9ce66df23855"
+  "types": "./packages/ui/src/index.d.ts"
 }

package/packages/typescript/src/action-docs.d.ts

@@ -0,0 +1,22 @@
+import type { Action, Evaluator } from "./types/index.ts";
+/**
+ * Merge canonical docs (description/similes/parameters) into an action definition.
+ *
+ * This is additive and intentionally conservative:
+ * - does not overwrite an existing action.description
+ * - does not overwrite existing action.similes
+ * - does not overwrite existing action.parameters
+ */
+export declare function withCanonicalActionDocs(action: Action): Action;
+export declare function withCanonicalActionDocsAll(actions: readonly Action[]): Action[];
+/**
+ * Merge canonical docs (description/similes/examples) into an evaluator definition.
+ *
+ * This is additive and intentionally conservative:
+ * - does not overwrite an existing evaluator.description
+ * - does not overwrite existing evaluator.similes
+ * - does not overwrite existing evaluator.examples (when non-empty)
+ */
+export declare function withCanonicalEvaluatorDocs(evaluator: Evaluator): Evaluator;
+export declare function withCanonicalEvaluatorDocsAll(evaluators: readonly Evaluator[]): Evaluator[];
+//# sourceMappingURL=action-docs.d.ts.map

package/packages/typescript/src/action-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-docs.d.ts","sourceRoot":"","sources":["../../../../../typescript/src/action-docs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,MAAM,EAIN,SAAS,EACT,MAAM,kBAAkB,CAAC;AA0B1B;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAsB9D;AAED,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,EAAE,CAEV;AA4BD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAoB1E;AAED,wBAAgB,6BAA6B,CAC5C,UAAU,EAAE,SAAS,SAAS,EAAE,GAC9B,SAAS,EAAE,CAEb"}

package/packages/typescript/src/action-docs.js

@@ -0,0 +1,95 @@
+import { allActionDocs, allEvaluatorDocs } from "./generated/action-docs.js";
+const coreActionDocByName = allActionDocs.reduce((acc, doc) => {
+    acc[doc.name] = doc;
+    return acc;
+}, {});
+function toActionParameter(param) {
+    return {
+        name: param.name,
+        description: param.description,
+        descriptionCompressed: param.descriptionCompressed,
+        required: param.required,
+        schema: {
+            ...param.schema,
+            enumValues: param.schema.enum,
+        },
+        examples: param.examples ? [...param.examples] : undefined,
+    };
+}
+/**
+ * Merge canonical docs (description/similes/parameters) into an action definition.
+ *
+ * This is additive and intentionally conservative:
+ * - does not overwrite an existing action.description
+ * - does not overwrite existing action.similes
+ * - does not overwrite existing action.parameters
+ */
+export function withCanonicalActionDocs(action) {
+    const doc = coreActionDocByName[action.name];
+    if (!doc)
+        return action;
+    const parameters = action.parameters && action.parameters.length > 0
+        ? action.parameters
+        : (doc.parameters ?? []).map(toActionParameter);
+    return {
+        ...action,
+        description: action.description || doc.description,
+        descriptionCompressed: action.descriptionCompressed || doc.descriptionCompressed,
+        similes: action.similes && action.similes.length > 0
+            ? action.similes
+            : doc.similes
+                ? [...doc.similes]
+                : undefined,
+        parameters,
+    };
+}
+export function withCanonicalActionDocsAll(actions) {
+    return actions.map(withCanonicalActionDocs);
+}
+const coreEvaluatorDocByName = allEvaluatorDocs.reduce((acc, doc) => {
+    acc[doc.name] = doc;
+    return acc;
+}, {});
+function toEvaluationExample(ex) {
+    const messages = (ex.messages ?? []).map((m) => ({
+        name: m.name,
+        content: {
+            text: m.content.text,
+            type: m.content.type,
+        },
+    }));
+    return {
+        prompt: ex.prompt,
+        messages,
+        outcome: ex.outcome,
+    };
+}
+/**
+ * Merge canonical docs (description/similes/examples) into an evaluator definition.
+ *
+ * This is additive and intentionally conservative:
+ * - does not overwrite an existing evaluator.description
+ * - does not overwrite existing evaluator.similes
+ * - does not overwrite existing evaluator.examples (when non-empty)
+ */
+export function withCanonicalEvaluatorDocs(evaluator) {
+    const doc = coreEvaluatorDocByName[evaluator.name];
+    if (!doc)
+        return evaluator;
+    const examples = evaluator.examples && evaluator.examples.length > 0
+        ? evaluator.examples
+        : (doc.examples ?? []).map(toEvaluationExample);
+    return {
+        ...evaluator,
+        description: evaluator.description || doc.description,
+        similes: evaluator.similes && evaluator.similes.length > 0
+            ? evaluator.similes
+            : doc.similes
+                ? [...doc.similes]
+                : undefined,
+        examples,
+    };
+}
+export function withCanonicalEvaluatorDocsAll(evaluators) {
+    return evaluators.map(withCanonicalEvaluatorDocs);
+}

package/packages/typescript/src/actions.d.ts

@@ -0,0 +1,29 @@
+import type { Action, ActionParameter, ActionParameters } from "./types";
+export declare const composeActionExamples: (actionsData: Action[], count: number, seed?: string) => string;
+/**
+ * Render canonical action-call examples (including <params> blocks).
+ *
+ * Deterministic ordering is important to keep tests stable and avoid prompt churn.
+ */
+export declare function composeActionCallExamples(actionsData: Action[], maxExamples: number): string;
+export declare function formatActionNames(actions: Action[], seed?: string): string;
+export declare function formatActions(actions: Action[], seed?: string): string;
+export declare function formatActionParameters(parameters: ActionParameter[]): string;
+/**
+ * Parse action parameters from either the new nested format or the legacy flat format.
+ *
+ * New format (preferred):
+ *   <actions>
+ *     <action><name>ACTION1</name><params><p1>v1</p1></params></action>
+ *   </actions>
+ *
+ * Legacy format (backward-compat – previously stored in content.params):
+ *   <ACTION1><p1>v1</p1></ACTION1>
+ */
+export declare function parseActionParams(paramsInput: unknown): Map<string, ActionParameters>;
+export declare function validateActionParams(action: Action, extractedParams: ActionParameters | undefined): {
+    valid: boolean;
+    params: ActionParameters | undefined;
+    errors: string[];
+};
+//# sourceMappingURL=actions.d.ts.map

package/packages/typescript/src/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../../typescript/src/actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,MAAM,EAEN,eAAe,EAEf,gBAAgB,EAGhB,MAAM,SAAS,CAAC;AAwBjB,eAAO,MAAM,qBAAqB,GACjC,aAAa,MAAM,EAAE,EACrB,OAAO,MAAM,EACb,aAAgB,KACd,MA8CF,CAAC;AAmBF;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,GACjB,MAAM,CAgBR;AA8GD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,SAAY,GAAG,MAAM,CAM7E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,SAAY,GAAG,MAAM,CAwCzE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CA0B5E;AAuBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,OAAO,GAClB,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAyE/B;AA+HD,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,gBAAgB,GAAG,SAAS,GAC3C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAyC5E"}