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

package/README.md

@@ -51,3 +51,7 @@ To get started, check out our **Cookbook** of practical recipes.
 ### License
 
 Licensed under [MIT](./LICENSE).
+
+---
+
+[Next: The Cookbook (Examples) ➡️](./docs/examples.md)

package/docs/api.md

@@ -1,9 +1,26 @@
+---
+[⬅️ Previous: Features Showcase](./features.md)
+
 # API Reference: The Technical Blueprint
 
 This document provides an exhaustive reference for all `ZestButton` props and type definitions.
 
 ---
 
+## Table of Contents
+
+- [ZestButtonProps](#zestbuttonprops)
+- [Type Definitions](#type-definitions)
+  - [ZestCustomProps](#zestcustomprops)
+  - [ZestGlobalConfig](#zestglobalconfig)
+  - [VisualOptions](#visualoptions)
+  - [BusyOptions](#busyoptions)
+  - [SuccessOptions](#successoptions)
+  - [ConfirmOptions](#confirmoptions)
+  - [SemanticType](#semantictype)
+
+---
+
 ### `ZestButtonProps`
 
 The `ZestButton` component accepts all standard HTML `<button>` attributes (e.g., `disabled`, `type`, `name`, `className`) in addition to its own custom configuration prop, `zest`.
@@ -117,3 +134,7 @@ declare module 'jattac.libs.web.zest-button' {
 }
 ```
 After augmentation, `'archive'` and `'publish'` would be valid `SemanticType` values, available for autocompletion and type-checking.
+
+---
+
+[⬅️ Previous: Features Showcase](./features.md) | [Next: Configuration Guide ➡️](./configuration.md)

package/docs/breaking-changes.md

@@ -1,9 +1,20 @@
+---
+[⬅️ Previous: Development Guide](./development.md)
+
 # Breaking Changes: The Upgrade Path
 
 This document lists significant changes between versions that might require modifications to your existing codebase.
 
 ---
 
+## Table of Contents
+
+- [Version 1.2.7](#version-127)
+- [Version 1.2.6](#version-126)
+- [Version 1.2.0](#version-120)
+
+---
+
 ## Version 1.2.7
 
 ### Renamed `ZestProvider` to `ZestButtonConfigProvider`
@@ -126,3 +137,7 @@ This change allows for better organization of configuration options (e.g., `visu
   My Button
 </ZestButton>
 ```
+
+---
+
+[⬅️ Previous: Development Guide](./development.md) | [Next: README ➡️](../README.md)

package/docs/configuration.md

@@ -1,9 +1,27 @@
+---
+[⬅️ Previous: API Reference](./api.md)
+
 # Configuration: The Control Panel
 
 This document explains how to configure `ZestButton` on a component and global level.
 
 ---
 
+## Table of Contents
+
+- [Overview](#overview)
+- [Theme Configuration](#theme-configuration)
+  - [Order of Precedence](#order-of-precedence)
+  - [Example: Forcing a Theme](#example-forcing-a-theme)
+- [Global Configuration with ZestButtonConfigProvider](#global-configuration-with-zestbuttonconfigprovider)
+  - [Usage](#usage)
+  - [Precedence with the ZestButtonConfigProvider](#precedence-with-the-zestbuttonconfigprovider)
+- [Advanced: Customizing Semantic Defaults](#advanced-customizing-semantic-defaults)
+  - [Example: Defining a Custom 'archive' Type](#example-defining-a-custom-archive-type)
+  - [Example: Overriding a Built-in 'delete' Default](#example-overriding-a-built-in-delete-default)
+
+---
+
 ### Overview
 
 Currently, `ZestButton` is primarily configured on a per-component basis via the `zest` prop. This provides the most explicit and direct control over each button's behavior and appearance.
@@ -190,3 +208,7 @@ const App = () => (
 </ZestButton>
 ```
 
+---
+
+[⬅️ Previous: API Reference](./api.md) | [Next: Development Guide ➡️](./development.md)
+

package/docs/development.md

@@ -1,9 +1,21 @@
+---
+[⬅️ Previous: Configuration Guide](./configuration.md)
+
 # Development: The Contributor's Guide
 
 This guide provides an overview of the project's internal structure and instructions for setting up your development environment.
 
 ---
 
+## Table of Contents
+
+- [Internal Architecture](#internal-architecture)
+- [Setup Instructions](#setup-instructions)
+- [Scripts](#scripts)
+- [Extending Semantic Types](#extending-semantic-types)
+
+---
+
 ### Internal Architecture
 
 The `jattac.libs.web.zest-button` project is structured to be a self-contained React component library.
@@ -75,3 +87,7 @@ declare module 'jattac.libs.web.zest-button' {
 Once augmented, these new semantic types (`'archive'`, `'publish'`) will be available for autocompletion and type-checking when using the `semanticType` prop on your `ZestButton` instances.
 
 *(Note: Currently, there are no dedicated test scripts defined in `package.json`. Testing is typically done manually in a consuming project during development, or through dedicated test runners that would be added in the future.)*
+
+---
+
+[⬅️ Previous: Configuration Guide](./configuration.md) | [Next: Breaking Changes ➡️](./breaking-changes.md)

package/docs/examples.md

@@ -4,6 +4,15 @@ Welcome to the ZestButton Cookbook! This is the core learning path for mastering
 
 ---
 
+## Table of Contents
+
+- [Recipe 1: Your First Async Button](#recipe-1-your-first-async-button)
+- [Recipe 2: The Safe "Delete" Button](#recipe-2-the-safe-delete-button)
+- [Recipe 3: Standardizing Your Buttons with a Global Config](#recipe-3-standardizing-your-buttons-with-a-global-config)
+- [Recipe 4: Creating a Custom "Archive" Button](#recipe-4-creating-a-custom-archive-button)
+
+---
+
 ### Recipe 1: Your First Async Button
 
 **Goal:** Create a button that automatically shows a loading spinner during an operation and gives feedback when it's done.
@@ -211,5 +220,8 @@ const App = () => (
   </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).
+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).*
+
+---
 
+[⬅️ Previous: README](../README.md) | [Next: Features Showcase ➡️](./features.md)

package/docs/features.md

@@ -4,6 +4,16 @@ This document provides a high-level showcase of what's possible with `ZestButton
 
 ---
 
+## Table of Contents
+
+- [Asynchronous Operations & Feedback](#asynchronous-operations--feedback)
+- [Confirmation Flow](#confirmation-flow)
+- [Semantic Types](#semantic-types)
+- [Global Configuration](#global-configuration)
+- [Rich Styling](#rich-styling)
+
+---
+
 ### Asynchronous Operations & Feedback
 
 **What it does:** Automatically handles loading states and provides clear success/failure feedback for any action that returns a Promise.
@@ -100,7 +110,7 @@ const MyComponent = () => (
     <ZestButton zest={{ visualOptions: { variant: 'success', size: 'sm' } }}>
       Small Success
     </ZestButton>
-    <ZestButton zest={{ buttonStyle: 'outline', size: 'md' } }}>
+    <ZestButton zest={{ buttonStyle: 'outline', size: 'md' }}>
       Medium Outline
     </ZestButton>
     <ZestButton zest={{ visualOptions: { variant: 'danger', size: 'lg' } }}>
@@ -111,3 +121,6 @@ const MyComponent = () => (
 ```
 *Explore all the recipes in the **[Cookbook](./examples.md)** to see these options in action.*
 
+---
+
+[⬅️ Previous: The Cookbook (Examples)](./examples.md) | [Next: API Reference ➡️](./api.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jattac.libs.web.zest-button",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "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": {