jattac.libs.web.zest-button 1.2.6 → 1.2.7

package/docs/breaking-changes.md

@@ -4,6 +4,46 @@ This document lists significant changes between versions that might require modi
 
 ---
 
+## Version 1.2.7
+
+### Renamed `ZestProvider` to `ZestButtonConfigProvider`
+
+To provide more explicit naming and better context within the API, the `ZestProvider` component has been renamed to `ZestButtonConfigProvider`. Additionally, its associated context is now `ZestButtonConfigContext`, and the consumption hook is `useZestButtonConfig`.
+
+This is a breaking change that requires updating all imports and usages of the provider, context, and hook in your application.
+
+**Before:**
+
+```tsx
+import { ZestProvider, useZest } from 'jattac.libs.web.zest-button';
+
+const App = () => (
+  <ZestProvider config={myConfig}>...</ZestProvider>
+);
+
+const MyComponent = () => {
+  const config = useZest();
+  // ...
+}
+```
+
+**After:**
+
+```tsx
+import { ZestButtonConfigProvider, useZestButtonConfig } from 'jattac.libs.web.zest-button';
+
+const App = () => (
+  <ZestButtonConfigProvider config={myConfig}>...</ZestButtonConfigProvider>
+);
+
+const MyComponent = () => {
+  const config = useZestButtonConfig();
+  // ...
+}
+```
+
+---
+
 ## Version 1.2.6
 
 ### Renamed `fullWidth` prop to `stretch`

package/docs/configuration.md

@@ -48,18 +48,18 @@ const PinnedFooter = () => (
 
 ---
 
-### Global Configuration with `ZestProvider`
+### Global Configuration with `ZestButtonConfigProvider`
 
-The `ZestProvider` component is now implemented, allowing you to streamline `ZestButton` configuration across your entire application. You can define a set of default `zest` properties that all `ZestButton` instances within its scope will inherit.
+The `ZestButtonConfigProvider` component is now implemented, allowing you to streamline `ZestButton` configuration across your entire application. You can define a set of default `zest` properties that all `ZestButton` instances within its scope will inherit.
 
 #### Usage
 
-Wrap your application (or specific sections) with the `ZestProvider` and pass a configuration object to its `config` prop. The `config` prop expects an object of type `ZestGlobalConfig`, which contains a `defaultProps` field of type `ZestCustomProps`.
+Wrap your application (or specific sections) with the `ZestButtonConfigProvider` and pass a configuration object to its `config` prop. The `config` prop expects an object of type `ZestGlobalConfig`, which contains a `defaultProps` field of type `ZestCustomProps`.
 
 ```tsx
 // In your main App.tsx file
 
-import { ZestProvider } from 'jattac.libs.web.zest-button';
+import { ZestButtonConfigProvider } from 'jattac.libs.web.zest-button';
 import MyRoutes from './MyRoutes';
 
 const appZestConfig = {
@@ -74,28 +74,28 @@ const appZestConfig = {
 };
 
 const App = () => (
-  <ZestProvider config={appZestConfig}>
+  <ZestButtonConfigProvider config={appZestConfig}>
     <MyRoutes />
-  </ZestProvider>
+  </ZestButtonConfigProvider>
 );
 ```
 
-#### Precedence with the `ZestProvider`
+#### Precedence with the `ZestButtonConfigProvider`
 
 Property configurations are merged in a "deep merge" fashion with the following order of precedence (where the last one wins):
 
-1.  **Global `defaultProps`**: Props defined in the `ZestProvider`'s `config.defaultProps` object. This is the base layer of styling.
+1.  **Global `defaultProps`**: Props defined in the `ZestButtonConfigProvider`'s `config.defaultProps` object. This is the base layer of styling.
 2.  **Built-in Semantic Defaults**: The library's own defaults for a given `semanticType` (e.g., the `success` variant for `save`).
-3.  **Custom Semantic Defaults**: **(New!)** Defaults for a `semanticType` that you provide in the `ZestProvider`'s `config.semanticTypeDefaults` object. This allows you to override the library's defaults or create new ones.
+3.  **Custom Semantic Defaults**: **(New!)** Defaults for a `semanticType` that you provide in the `ZestButtonConfigProvider`'s `config.semanticTypeDefaults` object. This allows you to override the library's defaults or create new ones.
 4.  **Local `zest` Props**: The props passed directly to a specific `<ZestButton>` instance. This gives you the ultimate granular control.
 
 ---
 
 ### Advanced: Customizing Semantic Defaults
 
-This is one of the most powerful features of the `ZestProvider`. You can define application-wide styles and behaviors for any `semanticType`. This is perfect for creating a consistent design system.
+This is one of the most powerful features of the `ZestButtonConfigProvider`. You can define application-wide styles and behaviors for any `semanticType`. This is perfect for creating a consistent design system.
 
-The `ZestProvider`'s `config` prop accepts a `semanticTypeDefaults` object. You can use this to **override** built-in defaults or **define** defaults for your own custom types.
+The `ZestButtonConfigProvider`'s `config` prop accepts a `semanticTypeDefaults` object. You can use this to **override** built-in defaults or **define** defaults for your own custom types.
 
 #### Example: Defining a Custom 'archive' Type
 
@@ -112,11 +112,11 @@ declare module 'jattac.libs.web.zest-button' {
 }
 ```
 
-Now, configure the defaults in your `ZestProvider`:
+Now, configure the defaults in your `ZestButtonConfigProvider`:
 
 ```tsx
 // In your main App.tsx file
-import { ZestProvider } from 'jattac.libs.web.zest-button';
+import { ZestButtonConfigProvider } from 'jattac.libs.web.zest-button';
 import { FaArchive } from 'react-icons/fa';
 import MyRoutes from './MyRoutes';
 
@@ -138,9 +138,9 @@ const appZestConfig = {
 };
 
 const App = () => (
-  <ZestProvider config={appZestConfig}>
+  <ZestButtonConfigProvider config={appZestConfig}>
     <MyRoutes />
-  </ZestProvider>
+  </ZestButtonConfigProvider>
 );
 
 // --- Later, in some other component ---
@@ -157,7 +157,7 @@ Let's say you like the built-in `delete` type, but for your application, you wan
 
 ```tsx
 // In your main App.tsx file
-import { ZestProvider } from 'jattac.libs.web.zest-button';
+import { ZestButtonConfigProvider } from 'jattac.libs.web.zest-button';
 import MyRoutes from './MyRoutes';
 
 const appZestConfig = {
@@ -177,9 +177,9 @@ const appZestConfig = {
 };
 
 const App = () => (
-  <ZestProvider config={appZestConfig}>
+  <ZestButtonConfigProvider config={appZestConfig}>
     <MyRoutes />
-  </ZestProvider>
+  </ZestButtonConfigProvider>
 );
 
 // --- Later, in some other component ---

package/docs/examples.md

@@ -108,7 +108,7 @@ const DeleteButton = () => {
 ```tsx
 // In your main App.tsx
 import React from 'react';
-import { ZestProvider, ZestButton } from 'jattac.libs.web.zest-button';
+import { ZestButtonConfigProvider, ZestButton } from 'jattac.libs.web.zest-button';
 
 const appZestConfig = {
   defaultProps: {
@@ -120,7 +120,7 @@ const appZestConfig = {
 };
 
 const App = () => (
-  <ZestProvider config={appZestConfig}>
+  <ZestButtonConfigProvider config={appZestConfig}>
     <div style={{ display: 'flex', gap: '1rem', alignItems: 'center' }}>
       <ZestButton>I'm a small outline button</ZestButton>
       <ZestButton>So am I</ZestButton>
@@ -128,7 +128,7 @@ const App = () => (
         I'm a large solid button! (Local override)
       </ZestButton>
     </div>
-  </ZestProvider>
+  </ZestButtonConfigProvider>
 );
 ```
 *For a full list of provider settings, see the [`ZestGlobalConfig`](./api.md#zestglobalconfig) documentation. To understand the precedence rules, see the [Configuration Guide](./configuration.md).*
@@ -141,7 +141,7 @@ const App = () => (
 
 **Problem:** You have a common action in your app, like "Archive," that should always look and feel the same. You want to avoid configuring it manually each time and just be able to write `zest={{ semanticType: 'archive' }}`.
 
-**Solution:** This is a two-step process that combines **TypeScript Module Augmentation** with the **`ZestProvider`**.
+**Solution:** This is a two-step process that combines **TypeScript Module Augmentation** with the **`ZestButtonConfigProvider`**.
 
 **Step 1: Define the new type**
 In your project's type declarations file (e.g., `src/zest.d.ts`), augment the `CustomZestSemanticTypes` interface.
@@ -161,12 +161,12 @@ declare module 'jattac.libs.web.zest-button' {
 *(For more on this, see the [Contributor's Guide](./development.md#extending-semantic-types).)*
 
 **Step 2: Provide the default configuration**
-In your `App.tsx`, use the `semanticTypeDefaults` property in the `ZestProvider` to define the default props for your new `'archive'` type.
+In your `App.tsx`, use the `semanticTypeDefaults` property in the `ZestButtonConfigProvider` to define the default props for your new `'archive'` type.
 
 ```tsx
 // In your main App.tsx
 import React from 'react';
-import { ZestProvider, ZestButton } from 'jattac.libs.web.zest-button';
+import { ZestButtonConfigProvider, ZestButton } from 'jattac.libs.web.zest-button';
 import { FaArchive } from 'react-icons/fa';
 
 const appZestConfig = {
@@ -191,7 +191,7 @@ const appZestConfig = {
 };
 
 const App = () => (
-  <ZestProvider config={appZestConfig}>
+  <ZestButtonConfigProvider config={appZestConfig}>
     <div style={{ display: 'flex', gap: '1rem' }}>
         {/* 3. Now just use it! */}
         <ZestButton 
@@ -208,7 +208,7 @@ const App = () => (
           Delete
         </ZestButton>
     </div>
-  </ZestProvider>
+  </ZestButtonConfigProvider>
 );
 ```
 This powerful pattern allows you to build a complete, consistent design system for all button actions in your application. For more details on configuration, see the [Configuration Guide](./configuration.md).

package/docs/features.md

@@ -81,9 +81,9 @@ const appZestConfig = {
 };
 
 const App = () => (
-  <ZestProvider config={appZestConfig}>
+  <ZestButtonConfigProvider config={appZestConfig}>
     {/* All buttons inside will be small and outline by default */}
-  </ZestProvider>
+  </ZestButtonConfigProvider>
 );
 ```
 *__Learn more in the [Standardizing Your Buttons recipe](./examples.md#recipe-3-standardizing-your-buttons-with-a-global-config).__*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jattac.libs.web.zest-button",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "description": "A highly customizable and production-ready React button component featuring robust asynchronous handling, rich visual feedback, and built-in confirmation flows for enhanced user experience",
   "homepage": "https://github.com/nyingimaina/jattac.libs.web.zest-button#readme",
   "repository": {