umwd-components 0.1.714 → 0.1.716

package/README.md

@@ -0,0 +1,273 @@
+# UMWD Components
+
+A comprehensive React component library for e-commerce and logistics
+applications, built with TypeScript and Material-UI.
+
+## Overview
+
+UMWD Components is a feature-rich component library designed for building modern
+e-commerce platforms with integrated logistics management. It provides
+ready-to-use components for customer management, product catalogs, order
+processing, invoicing, vendor management, and logistics operations.
+
+## Key Features
+
+### 🛒 E-commerce Components
+
+- **Product Management**: Product displays, forms, categories, pricing, and
+  inventory
+- **Shopping Cart**: Cart functionality with add/remove items, quantity updates,
+  and checkout process
+- **Customer Profiles**: Customer registration, authentication, and profile
+  management
+- **Order Processing**: Order placement, tracking, and management (OPO -
+  Outbound Purchase Orders)
+- **Returns Management**: Return merchandise authorization (RMA) and processing
+  (IRO - Inbound Return Orders)
+- **Invoice Generation**: PDF invoice creation and management
+- **Payment Integration**: Mollie payment provider integration
+
+### 📦 Logistics Components
+
+- **Vendor Management**: Vendor profiles, business credentials, and contact
+  management
+- **Inventory Processing**: Inbound Purchase Orders (IPO) management
+- **Dispatcher Profiles**: Logistics operator management and tracking
+- **Shipping & Fulfillment**: Order fulfillment and delivery tracking
+
+### 🏗️ Page Builder Components
+
+- **Dynamic Page Building**: Flexible page construction with reusable blocks
+- **Hero Sections**: Landing page components with images and CTAs
+- **Feature Sections**: Product and service highlighting components
+- **Contact Forms**: Customizable contact and inquiry forms
+
+### 🔐 Authentication & Authorization
+
+- **User Authentication**: Login, registration, and password reset
+- **Session Management**: Secure session handling with context providers
+- **Role-based Access**: Customer, dispatcher, and admin role management
+
+### 🎨 UI Components
+
+- **Layout Components**: Headers, footers, navigation, and sidebars
+- **Common Elements**: Forms, buttons, modals, and utility components
+- **Responsive Design**: Mobile-first approach with Material-UI integration
+- **Theming**: Customizable themes and styling with Material-UI
+
+## Technology Stack
+
+- **Framework**: Next.js 14+ with React 18
+- **Language**: TypeScript
+- **UI Library**: Material-UI (MUI) v5
+- **Styling**: CSS-in-JS with Material-UI's sx prop
+- **State Management**: React Context API
+- **Form Handling**: React Hook Form with Zod validation
+- **Date Handling**: Day.js
+- **PDF Generation**: @react-pdf/renderer
+- **Build Tools**: Rollup for library bundling
+
+## Installation
+
+```bash
+npm install umwd-components
+```
+
+### Peer Dependencies
+
+Make sure to install the required peer dependencies:
+
+```bash
+npm install @mui/icons-material @mui/material @mui/x-date-pickers @react-pdf/renderer @types/validator mui-markdown next react react-dom validator zod
+```
+
+## Usage
+
+### Basic Setup
+
+```tsx
+import { SessionProvider, CartProvider } from "umwd-components";
+
+function App() {
+  return (
+    <SessionProvider>
+      <CartProvider>{/* Your app components */}</CartProvider>
+    </SessionProvider>
+  );
+}
+```
+
+### Product Display
+
+```tsx
+import { ProductCard, Price } from "umwd-components";
+import { Grid } from "@mui/material";
+
+function ProductGrid({ products }) {
+  return (
+    <Grid container spacing={2}>
+      {products.map((product) => (
+        <Grid item xs={12} md={4} key={product.id}>
+          <ProductCard data={product} />
+        </Grid>
+      ))}
+    </Grid>
+  );
+}
+```
+
+### Customer Profile Management
+
+```tsx
+import {
+  CustomerProfileDisplay,
+  CustomerProfileEditForm,
+} from "umwd-components";
+
+function CustomerDashboard({ customer }) {
+  return (
+    <div>
+      <CustomerProfileDisplay data={customer} />
+      <CustomerProfileEditForm
+        data={customer}
+        revalidateCallback={() => window.location.reload()}
+      />
+    </div>
+  );
+}
+```
+
+### Shopping Cart
+
+```tsx
+import { CartWidget, AddToCartButton, useCart } from "umwd-components";
+
+function ProductPage({ product }) {
+  const { addItem } = useCart();
+
+  return (
+    <div>
+      <h1>{product.name}</h1>
+      <AddToCartButton product={product} />
+      <CartWidget />
+    </div>
+  );
+}
+```
+
+## Business Domain Features
+
+### Business Credentials Management
+
+- **VAT Number Validation**: Automatic VAT number verification
+- **EORI Number Validation**: Economic Operators Registration validation
+- **Chamber of Commerce**: Business registration details
+- **Multi-address Support**: Separate billing, delivery, and company addresses
+
+### Order Management Workflow
+
+1. **OPO (Outbound Purchase Orders)**: Customer orders placed on the platform
+2. **IPO (Inbound Purchase Orders)**: Vendor purchase orders for inventory
+3. **IRO (Inbound Return Orders)**: Customer returns and RMA processing
+4. **Invoice Generation**: Automated PDF invoice creation
+5. **Payment Processing**: Integrated payment workflows
+
+### Logistics Integration
+
+- **Vendor Management**: Complete vendor profile and product catalog management
+- **Dispatcher Coordination**: Logistics operator assignment and tracking
+- **Inventory Tracking**: Stock levels and product movement
+- **Shipping Coordination**: Delivery scheduling and tracking
+
+## Component Categories
+
+### Layout Components
+
+- `Footer`, `Navbar`, `NavbarV2`, `SideNav`
+- `WebsitePlaceholder`, `FluidBackground`
+
+### Authentication
+
+- `AuthWidget`, `RegisterForm`, `SigninForm`, `LogoutButton`
+- `ForgotPasswordForm`, `PasswordResetForm`
+
+### E-commerce
+
+- `ProductCard`, `SingleProduct`, `AddProductForm`, `EditProductForm`
+- `CartDisplay`, `AddToCartButton`, `CheckoutForm`
+- `CustomerProfileDisplay`, `CustomerProfileEditForm`
+- `CreateInvoiceForm`, `InvoicePDFViewer`
+
+### Logistics
+
+- `VendorDisplay`, `AddVendorForm`, `EditVendorForm`
+- `DispatcherProfileDisplay`, `ManageIPOForm`
+
+### Common Utilities
+
+- `Address`, `BusinessCredentials`, `Pagination`
+- `StrapiImage`, `ContactForm`, `ScrollLink`
+
+## Development
+
+### Local Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build library
+npm run build-lib
+
+# Type checking
+npm run type-check
+
+# Lint code
+npm run lint
+```
+
+### Building for Production
+
+```bash
+# Build the component library
+npm run build-lib
+```
+
+## Configuration
+
+### Environment Variables
+
+The library expects certain environment variables for proper functionality:
+
+- `NEXT_PUBLIC_STRAPI_API_URL`: Backend API URL
+- `NEXT_PUBLIC_STRAPI_API_TOKEN`: API authentication token
+
+### Styling
+
+The library uses Material-UI for all styling. Components follow Material Design
+principles and can be customized using MUI's theming system and sx props.
+
+## Contributing
+
+1. Clone the repository
+2. Install dependencies: `npm install`
+3. Create a feature branch
+4. Make your changes
+5. Build the library: `npm run build-lib`
+6. Submit a pull request
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Support
+
+For issues, feature requests, or questions, please create an issue in the
+project repository.
+
+---
+
+**Note**: This is a comprehensive component library designed for enterprise
+e-commerce and logistics applications. It integrates with Strapi CMS for content
+management and includes sophisticated business logic for European VAT/EORI
+validation and multi-currency support.

package/dist/_virtual/_commonjsHelpers.js

@@ -3,4 +3,4 @@
  * @copyright Jelle Paulus
  * @license MIT
  */
-var e="undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:{};function t(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}function o(e){if(e.__esModule)return e;var t=e.default;if("function"==typeof t){var o=function e(){return this instanceof e?Reflect.construct(t,arguments,this.constructor):t.apply(this,arguments)};o.prototype=t.prototype}else o={};return Object.defineProperty(o,"__esModule",{value:!0}),Object.keys(e).forEach((function(t){var n=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(o,t,n.get?n:{enumerable:!0,get:function(){return e[t]}})})),o}export{e as commonjsGlobal,o as getAugmentedNamespace,t as getDefaultExportFromCjs};
+var e="undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:{};function t(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}function o(e){if(e.__esModule)return e;var t=e.default;if("function"==typeof t){var o=function e(){return this instanceof e?Reflect.construct(t,arguments,this.constructor):t.apply(this,arguments)};o.prototype=t.prototype}else o={};return Object.defineProperty(o,"__esModule",{value:!0}),Object.keys(e).forEach(function(t){var n=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(o,t,n.get?n:{enumerable:!0,get:function(){return e[t]}})}),o}export{e as commonjsGlobal,o as getAugmentedNamespace,t as getDefaultExportFromCjs};

package/dist/_virtual/_rollupPluginBabelHelpers.js

@@ -3,4 +3,4 @@
  * @copyright Jelle Paulus
  * @license MIT
  */
-function t(){return t=Object.assign?Object.assign.bind():function(t){for(var n=1;n<arguments.length;n++){var r=arguments[n];for(var e in r)Object.prototype.hasOwnProperty.call(r,e)&&(t[e]=r[e])}return t},t.apply(this,arguments)}export{t as extends};
+function t(t,r){this.v=t,this.k=r}function r(r){var e={},n=!1;function o(e,o){return n=!0,o=new Promise(function(t){t(r[e](o))}),{done:!1,value:new t(o,1)}}return e["undefined"!=typeof Symbol&&Symbol.iterator||"@@iterator"]=function(){return this},e.next=function(t){return n?(n=!1,t):o("next",t)},"function"==typeof r.throw&&(e.throw=function(t){if(n)throw n=!1,t;return o("throw",t)}),"function"==typeof r.return&&(e.return=function(t){return n?(n=!1,t):o("return",t)}),e}function e(t){var r,e,o,i=2;for("undefined"!=typeof Symbol&&(e=Symbol.asyncIterator,o=Symbol.iterator);i--;){if(e&&null!=(r=t[e]))return r.call(t);if(o&&null!=(r=t[o]))return new n(r.call(t));e="@@asyncIterator",o="@@iterator"}throw new TypeError("Object is not async iterable")}function n(t){function r(t){if(Object(t)!==t)return Promise.reject(new TypeError(t+" is not an object."));var r=t.done;return Promise.resolve(t.value).then(function(t){return{value:t,done:r}})}return n=function(t){this.s=t,this.n=t.next},n.prototype={s:null,n:null,next:function(){return r(this.n.apply(this.s,arguments))},return:function(t){var e=this.s.return;return void 0===e?Promise.resolve({value:t,done:!0}):r(e.apply(this.s,arguments))},throw:function(t){var e=this.s.return;return void 0===e?Promise.reject(t):r(e.apply(this.s,arguments))}},new n(t)}function o(r){return new t(r,0)}function i(t,r,e){return(r=f(r))in t?Object.defineProperty(t,r,{value:e,enumerable:!0,configurable:!0,writable:!0}):t[r]=e,t}function u(){return u=Object.assign?Object.assign.bind():function(t){for(var r=1;r<arguments.length;r++){var e=arguments[r];for(var n in e)({}).hasOwnProperty.call(e,n)&&(t[n]=e[n])}return t},u.apply(null,arguments)}function a(t,r){var e=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);r&&(n=n.filter(function(r){return Object.getOwnPropertyDescriptor(t,r).enumerable})),e.push.apply(e,n)}return e}function c(t){for(var r=1;r<arguments.length;r++){var e=null!=arguments[r]?arguments[r]:{};r%2?a(Object(e),!0).forEach(function(r){i(t,r,e[r])}):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(e)):a(Object(e)).forEach(function(r){Object.defineProperty(t,r,Object.getOwnPropertyDescriptor(e,r))})}return t}function s(t,r){if("object"!=typeof t||!t)return t;var e=t[Symbol.toPrimitive];if(void 0!==e){var n=e.call(t,r);if("object"!=typeof n)return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===r?String:Number)(t)}function f(t){var r=s(t,"string");return"symbol"==typeof r?r:r+""}function l(t){return function(){return new y(t.apply(this,arguments))}}function y(r){var e,n;function o(e,n){try{var u=r[e](n),a=u.value,c=a instanceof t;Promise.resolve(c?a.v:a).then(function(t){if(c){var n="return"===e?"return":"next";if(!a.k||t.done)return o(n,t);t=r[n](t).value}i(u.done?"return":"normal",t)},function(t){o("throw",t)})}catch(t){i("throw",t)}}function i(t,r){switch(t){case"return":e.resolve({value:r,done:!0});break;case"throw":e.reject(r);break;default:e.resolve({value:r,done:!1})}(e=e.next)?o(e.key,e.arg):n=null}this._invoke=function(t,r){return new Promise(function(i,u){var a={key:t,arg:r,resolve:i,reject:u,next:null};n?n=n.next=a:(e=n=a,o(t,r))})},"function"!=typeof r.return&&(this.return=void 0)}y.prototype["function"==typeof Symbol&&Symbol.asyncIterator||"@@asyncIterator"]=function(){return this},y.prototype.next=function(t){return this._invoke("next",t)},y.prototype.throw=function(t){return this._invoke("throw",t)},y.prototype.return=function(t){return this._invoke("return",t)};export{t as OverloadYield,r as asyncGeneratorDelegate,e as asyncIterator,o as awaitAsyncGenerator,i as defineProperty,u as extends,c as objectSpread2,s as toPrimitive,f as toPropertyKey,l as wrapAsyncGenerator};