@madecki/ui 1.5.0 → 2.1.0

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+## [2.1.0](https://github.com/madecki/ui/compare/v2.0.0...v2.1.0) (2026-04-08)
+
+### Features
+
+* add DetailsPanel native details/summary disclosure ([d1d24d9](https://github.com/madecki/ui/commit/d1d24d989537fe1845aeb5059b3f59d745357c23))
+* add Toast with placement, auto-close, and variants ([5874709](https://github.com/madecki/ui/commit/587470962cf265eafe8cc9659b78b073f6ef1756))
+
+## [2.0.0](https://github.com/madecki/ui/compare/v1.5.0...v2.0.0) (2026-04-08)
+
+### ⚠ BREAKING CHANGES
+
+* RadioButtons requires `label`. Group uses radiogroup; options use radio + aria-checked.
+
+Made-with: Cursor
+
+### Features
+
+* add visible form labels, Textarea, and automated changelog ([f00476c](https://github.com/madecki/ui/commit/f00476ca7c548f0e7c1397c22e426449bed2d3f1))
+
+### Bug Fixes
+
+* unblock release checks for Textarea story and workflows ([6aed8a7](https://github.com/madecki/ui/commit/6aed8a77fbb46ae9734024e0195cf323176abd31))
+
+# Changelog
+
+All release notes in this file are **generated automatically** by [semantic-release](https://semantic-release.gitbook.io/) when a version is published to npm. They are built **only** from [Conventional Commits](https://www.conventionalcommits.org/) on **`main`** (see **Releasing** in the repository README).
+
+**Reading this file:** The **latest** published release is always the **topmost** `## [x.y.z]` section. It should match `"version"` in `package.json` inside the package you installed.
+
+**Contributing:** Do not hand-edit versioned sections. Describe user-visible work in commits: use **`feat`**, **`fix`**, or **`perf`** so they appear in the notes. For **breaking** API or behavior changes, use a **`!`** after the type (e.g. **`feat!:`**) and/or a **`BREAKING CHANGE:`** paragraph in the commit **body**. [commitlint](https://commitlint.js.org/) validates messages on **`git commit`** (Husky) and on **every push to `main`** (CI).

package/README.md

@@ -424,6 +424,47 @@ Full-screen loading overlay.
 <SpinnerOverlay isVisible={isLoading} />
 ```
 
+#### Toast
+
+Fixed-position message in any screen corner, with configurable auto-dismiss (milliseconds) and a close control. Border colors match semantic tokens (`info` uses the same blue accent as `ContentBox`).
+
+```tsx
+import { Toast } from "@madecki/ui";
+import { useState } from "react";
+
+function Example() {
+  const [toastKey, setToastKey] = useState(0);
+
+  return (
+    <>
+      <button type="button" onClick={() => setToastKey((n) => n + 1)}>
+        Save
+      </button>
+      {toastKey > 0 ? (
+        <Toast
+          key={toastKey}
+          variant="success"
+          placement="bottom-right"
+          autoCloseMs={4000}
+          onClose={() => setToastKey(0)}
+        >
+          <p className="text-white">Saved.</p>
+        </Toast>
+      ) : null}
+    </>
+  );
+}
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `children` | `ReactNode` | (required) | Message body (use `Text` / markup as needed). |
+| `variant` | `"info"` \| `"success"` \| `"danger"` | `"info"` | Semantic style (border / live region). |
+| `placement` | `"top-left"` \| `"top-right"` \| `"bottom-left"` \| `"bottom-right"` | `"bottom-right"` | Viewport corner (`fixed`, offset with spacing token `5`). |
+| `autoCloseMs` | `number` | `5000` | Auto-dismiss delay in ms; use `0` to disable. |
+| `onClose` | `() => void` | — | Fired when the toast is dismissed (timer or close control). |
+| `className` | `string` | `""` | Extra classes on the root element. |
+
 ### Content Components
 
 #### BlockQuote
@@ -452,6 +493,37 @@ import { ContentBox, Info, Warning } from "@madecki/ui";
 </ContentBox>
 ```
 
+#### DetailsPanel
+
+Collapsible panel using native **`<details>`** and **`<summary>`** (accessible disclosure), with the same border variants as `ContentBox`.
+
+```tsx
+import { DetailsPanel, Info } from "@madecki/ui";
+
+<DetailsPanel variant="info" summary="Show more">
+  <p className="text-white">Extra content appears here when expanded.</p>
+</DetailsPanel>
+
+<DetailsPanel
+  variant="warning"
+  icon={<Info />}
+  defaultOpen
+  summary="Important details"
+>
+  <p className="text-white">Initially open; still toggles like a normal details element.</p>
+</DetailsPanel>
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `summary` | `ReactNode` | (required) | Content of the `<summary>` row (click to toggle). |
+| `children` | `ReactNode` | (required) | Panel body shown when open. |
+| `variant` | `"info"` \| `"warning"` \| `"success"` \| `"danger"` | `"info"` | Border color (matches `ContentBox`). |
+| `icon` | `ReactNode` | — | Optional icon before the summary text. |
+| `defaultOpen` | `boolean` | `false` | Initial open state; toggling still uses native `<details>` behavior (open state is synced in React so `defaultOpen` works reliably). |
+| `className` | `string` | `""` | Extra classes on `<details>`. |
+| `id` | `string` | — | `id` on `<details>`. |
+
 #### Hr
 
 Styled horizontal rule.
@@ -574,30 +646,45 @@ src/components/ComponentName/
 
 ## Releasing
 
-Releases are fully automated using [semantic-release](https://semantic-release.gitbook.io/). When commits are pushed to `main`, the CI automatically:
+Releases are fully automated using [semantic-release](https://semantic-release.gitbook.io/). When commits are pushed to `main`, the **Release** workflow runs `typecheck`, `lint`, `build`, and **`npm test`**, then **`npx semantic-release`**, which in order:
+
+1. Analyzes **conventional** commit messages since the last release to pick the **semver** bump
+2. Generates release notes **only** from those commits
+3. **Prepends** a new `## [version]` section to **`CHANGELOG.md`** and sets **`package.json`** `"version"`
+4. Publishes to npm (the `prepublishOnly` script builds again)
+5. Pushes the version commit, creates a Git tag, and opens a **GitHub Release**
 
-1. Analyzes commit messages to determine the version bump
-2. Updates `package.json` and `CHANGELOG.md`
-3. Creates a Git tag and GitHub Release
-4. Publishes to NPM with provenance
+There is **no** separate manual changelog step: if it is not described in a merged commit on `main`, it will not appear in **`CHANGELOG.md`**.
 
 ### Commit Message Format
 
-This project uses [Conventional Commits](https://www.conventionalcommits.org/) enforced by [commitlint](https://commitlint.js.org/).
+This project uses [Conventional Commits](https://www.conventionalcommits.org/) enforced by [commitlint](https://commitlint.js.org/):
+
+- **Locally:** Husky runs **`commitlint`** on the **`commit-msg`** hook, so **`git commit` fails** if the message does not follow the rules (bypass only with **`git commit --no-verify`**).
+- **Locally:** Husky runs **`npm run precheck`** on **`pre-push`** (typecheck, lint, build, tests, Storybook build — same as CI/Release). Bypass with **`git push --no-verify`** if you must.
+- **On `main`:** CI runs commitlint on **every push** for the commits in that push, so bad messages are caught even if someone skipped the hook.
 
 **Format:** `type(scope?): description`
 
-| Type | Description | Release |
-|------|-------------|---------|
-| `feat` | New feature | Minor |
-| `fix` | Bug fix | Patch |
-| `docs` | Documentation only | None |
+| Type | Description | Release / changelog |
+|------|-------------|---------------------|
+| `feat` | New feature | Minor; appears under **Features** |
+| `fix` | Bug fix | Patch; appears under **Bug Fixes** |
+| `perf` | Performance improvement | Patch; appears under **Performance Improvements** |
+| `docs` | Documentation only | None (not in changelog by default) |
 | `style` | Code style (formatting) | None |
 | `refactor` | Code change (no fix/feat) | None |
-| `perf` | Performance improvement | Patch |
 | `test` | Adding/updating tests | None |
 | `chore` | Maintenance tasks | None |
 
+**Breaking changes** (major bump): use **`feat!:`** / **`fix!:`** and/or a **`BREAKING CHANGE:`** paragraph in the commit **body** (after a blank line). Example body:
+
+```text
+feat!: require label on RadioButtons
+
+BREAKING CHANGE: RadioButtons now requires a `label` prop.
+```
+
 ### Examples
 
 ```bash

package/cursor-rule-template.md

@@ -44,7 +44,7 @@ This file contains:
 ## Import Pattern
 
 \`\`\`tsx
-import { Container, Stack, Heading, Text, Button } from "@madecki/ui";
+import { Container, Stack, Heading, Text, Button, DetailsPanel, Toast } from "@madecki/ui";
 import { Heart, Info } from "@madecki/ui";
 \`\`\`