@particle-academy/react-fancy 4.12.0 → 4.12.1

package/README.md

@@ -232,9 +232,9 @@ Dark mode works via Tailwind's `dark:` class strategy. The library's `Portal` co
 ```
 src/
 ├── components/           # One directory per component
-│   ├── Action/
-│   │   ├── Action.tsx           # Component implementation
-│   │   ├── Action.types.ts      # Props interface
+│   ├── Button/
+│   │   ├── Button.tsx           # Component implementation
+│   │   ├── Button.types.ts      # Props interface
 │   │   └── index.ts             # Re-exports
 │   ├── Modal/
 │   │   ├── Modal.tsx            # Root + Object.assign compound
@@ -257,7 +257,7 @@ src/
 
 - `Size` — `"xs" | "sm" | "md" | "lg" | "xl"`
 - `Color` — Full Tailwind color palette (17 colors)
-- `ButtonColor` — Subset of 10 standalone colors used by `Button` and friends (legacy alias: `ActionColor`)
+- `ButtonColor` — Standalone colors used by `Button` and friends; alias of `Color` (full palette). Deprecated legacy alias: `ActionColor`
 - `Variant` — `"solid" | "outline" | "ghost" | "soft"`
 - `Placement` — `"top" | "bottom" | "left" | "right"` + start/end variants
 

package/dist/index.d.cts

@@ -1128,9 +1128,9 @@ declare const Timeline: react.ForwardRefExoticComponent<TimelineProps & react.Re
 };
 
 /**
- * Subset of palette colors the TimeGrid offers for the "cell-on" tone.
- * Mirrors react-fancy's `ActionColor` choice — small enough to keep the
- * compiled CSS tight, broad enough to cover most use cases.
+ * Subset of palette colors the TimeGrid offers for the "cell-on" tone —
+ * small enough to keep the compiled CSS tight, broad enough to cover most
+ * use cases.
  */
 type TimeGridTone = "violet" | "emerald" | "sky" | "rose" | "amber" | "indigo" | "blue" | "zinc";
 interface TimeGridProps {

package/dist/index.d.ts

@@ -1128,9 +1128,9 @@ declare const Timeline: react.ForwardRefExoticComponent<TimelineProps & react.Re
 };
 
 /**
- * Subset of palette colors the TimeGrid offers for the "cell-on" tone.
- * Mirrors react-fancy's `ActionColor` choice — small enough to keep the
- * compiled CSS tight, broad enough to cover most use cases.
+ * Subset of palette colors the TimeGrid offers for the "cell-on" tone —
+ * small enough to keep the compiled CSS tight, broad enough to cover most
+ * use cases.
  */
 type TimeGridTone = "violet" | "emerald" | "sky" | "rose" | "amber" | "indigo" | "blue" | "zinc";
 interface TimeGridProps {

package/docs/AccordionPanel.md

@@ -22,22 +22,22 @@ import { AccordionPanel } from "@particle-academy/react-fancy";
 ```tsx
 <AccordionPanel orientation="horizontal" defaultValue={["wishlist"]}>
   <AccordionPanel.Section id="home" pinned>
-    <Action icon="home" />
+    <Button icon="home" />
   </AccordionPanel.Section>
 
   <AccordionPanel.Section id="wishlist">
     <AccordionPanel.Trigger />
     <AccordionPanel.Content>
-      <Action icon="list">Wishlist</Action>
-      <Action icon="mail">Feedback</Action>
-      <Action icon="file-text">Plans</Action>
+      <Button icon="list">Wishlist</Button>
+      <Button icon="mail">Feedback</Button>
+      <Button icon="file-text">Plans</Button>
     </AccordionPanel.Content>
   </AccordionPanel.Section>
 
   <AccordionPanel.Section id="board">
     <AccordionPanel.Trigger />
     <AccordionPanel.Content>
-      <Action icon="grid">Board</Action>
+      <Button icon="grid">Board</Button>
     </AccordionPanel.Content>
   </AccordionPanel.Section>
 </AccordionPanel>
@@ -55,7 +55,7 @@ When closed, the Trigger renders as a standalone chevron button. When open, the
     {({ open }) => (open ? "Collapse" : "Expand")}
   </AccordionPanel.Trigger>
   <AccordionPanel.Content>
-    <Action>Releases</Action>
+    <Button>Releases</Button>
   </AccordionPanel.Content>
 </AccordionPanel.Section>
 ```

package/docs/Action.md

@@ -10,86 +10,7 @@
 > ```
 >
 > `ActionProps` → `ButtonProps`, `ActionColor` → `ButtonColor` (also deprecated
-> aliases). Full, current documentation lives in **[Button](./Button.md)**.
+> aliases).
 
-A versatile button component with support for icons, emojis, avatars, badges, loading states, and color variants.
-
-## Import
-
-```tsx
-import { Action } from "@particle-academy/react-fancy"; // deprecated — prefer Button
-```
-
-## Basic Usage
-
-```tsx
-<Action>Click me</Action> // identical to <Button>Click me</Button>
-```
-
-## Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| variant | `"default" \| "circle" \| "ghost"` | `"default"` | Shape/fill variant. `"ghost"` is transparent with subtle hover. |
-| color | `ActionColor` | - | Standalone color (overrides state colors). One of: `"blue"`, `"emerald"`, `"amber"`, `"red"`, `"violet"`, `"indigo"`, `"sky"`, `"rose"`, `"orange"`, `"zinc"` |
-| size | `"xs" \| "sm" \| "md" \| "lg" \| "xl"` | `"md"` | Button size |
-| active | `boolean` | - | Active state (blue highlight) |
-| checked | `boolean` | - | Checked state (emerald highlight) |
-| warn | `boolean` | - | Warning state (amber highlight) |
-| alert | `boolean` | - | Pulsing animation on the entire button |
-| icon | `string` | - | Leading icon slug resolved via the Icon component |
-| iconTrailing | `string` | - | Trailing icon slug |
-| iconPlace | `string` | `"left"` | Icon placement. Supports: `"left"`, `"right"`, `"top"`, `"bottom"`, and compound positions like `"top left"`, `"bottom right"` |
-| alertIcon | `string` | - | Pulsing alert icon slug |
-| alertIconTrailing | `boolean` | - | Position alert icon on trailing side |
-| emoji | `string` | - | Leading emoji slug |
-| emojiTrailing | `string` | - | Trailing emoji slug |
-| avatar | `string` | - | Avatar image URL |
-| avatarTrailing | `boolean` | - | Position avatar on trailing side |
-| badge | `string` | - | Badge text |
-| badgeTrailing | `boolean` | - | Position badge on trailing side |
-| sort | `string` | `"eiab"` | Sort order of decorative elements: `e`=emoji, `i`=icon, `a`=avatar, `b`=badge |
-| loading | `boolean` | `false` | Show loading spinner (disables the button) |
-| disabled | `boolean` | - | Disable the button |
-| href | `string` | - | Render as an anchor tag instead of a button. Sanitized to a safe-protocol allow-list (since v2.5.0) — `javascript:`, `data:`, `vbscript:` are silently dropped and the component renders a `<button>` instead of an `<a>`. |
-
-Also extends all native `<button>` HTML attributes (except `color`).
-
-## Examples
-
-### Icon button with color
-
-```tsx
-<Action icon="pencil" color="blue" size="lg">
-  Edit
-</Action>
-```
-
-### Circle icon button
-
-```tsx
-<Action variant="circle" icon="plus" color="emerald" />
-```
-
-### Loading state with badge
-
-```tsx
-<Action loading badge="3" badgeTrailing>
-  Messages
-</Action>
-```
-
-### Link button with trailing icon
-
-```tsx
-<Action href="/docs" iconTrailing="arrow-right">
-  Read docs
-</Action>
-```
-
-### Ghost variant
-
-```tsx
-<Action variant="ghost" color="red" icon="trash-2">Delete</Action>
-<Action variant="ghost" icon="download">Export</Action>
-```
+Do not use `Action` in new code, examples, or generated snippets — always use
+`Button`. Full, current documentation lives in **[Button](./Button.md)**.

package/docs/utilities.md

@@ -55,12 +55,13 @@ type Color =
 type Variant = "solid" | "outline" | "ghost" | "soft";
 ```
 
-### ActionColor
+### ButtonColor
+
+Standalone color accepted by `Button` and friends — an alias of `Color` (the
+full palette above). `ActionColor` remains as a deprecated alias.
 
 ```ts
-type ActionColor =
-  | "blue" | "emerald" | "amber" | "red" | "violet"
-  | "indigo" | "sky" | "rose" | "orange" | "zinc";
+type ButtonColor = Color;
 ```
 
 ### Placement

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/react-fancy",
-  "version": "4.12.0",
+  "version": "4.12.1",
   "description": "React UI component library for Human+ UX — controlled, agent-bridgeable primitives",
   "repository": {
     "type": "git",