@originkit/avatars 0.0.0-stage → 0.2.0

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@originkit/avatars",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "OriginKit Avatars: turn any name into an avatar. 18 styles, SVG out, live React avatars, a CLI and an MCP server.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./react/index.d.ts",
+      "default": "./react/index.js"
+    }
+  },
+  "bin": {
+    "avatars": "bin/avatars.js"
+  },
+  "files": [
+    "dist",
+    "react",
+    "bin",
+    "mcp",
+    "GUIDE.md",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json && node scripts/build-react.mjs && cp ../../LICENSE .",
+    "test": "node --test \"test/*.test.js\"",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "zod": "^3.25 || ^4.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "landerdevelopers",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/landerdevelopers/botAvatars.git",
+    "directory": "packages/avatars"
+  },
+  "homepage": "https://originkit.dev/avatars",
+  "engines": {
+    "node": ">=20.10"
+  },
+  "keywords": [
+    "avatar",
+    "avatars",
+    "svg",
+    "identicon",
+    "generator",
+    "deterministic",
+    "mcp",
+    "model-context-protocol"
+  ]
+}

package/react/index.d.ts

@@ -0,0 +1,28 @@
+import type { JSX } from "react";
+
+/** The studio's settings for an avatar, as its How to use guide prints them. */
+export type Overrides = Record<string, number | string>;
+
+export interface AvatarProps {
+  /** A style id, as `styles` from "@originkit/avatars" lists them, such as "bots" or "glances". */
+  style: string;
+  /** What it's generated from. The same name always gives the same avatar. */
+  name: string;
+  /** The studio's settings for it. */
+  overrides?: Overrides;
+  /** Width and height, in pixels or any CSS length. 96 by default. */
+  size?: number | string;
+  /** Whether the eyes follow the pointer. On by default. */
+  follow?: boolean;
+  /** Whether it blinks, moves and reacts to taps. On by default, and off for reduced motion. */
+  animate?: boolean;
+  /** Read out for the image. Empty by default, as an avatar beside a name adds nothing. */
+  label?: string;
+  className?: string;
+}
+
+/**
+ * A live avatar: it blinks, follows the pointer and reacts to taps. On the server, and until
+ * the page is running, it shows the still SVG of the same avatar.
+ */
+export function Avatar(props: AvatarProps): JSX.Element;