@akinon/pz-basket-gift-pack 2.0.0-beta.2 → 2.0.0-beta.21

package/CHANGELOG.md

@@ -1,18 +1,134 @@
 # @akinon/pz-basket-gift-pack
 
-## 2.0.0-beta.2
+## 2.0.0-beta.21
 
-## 2.0.0-beta.1
+## 2.0.0-beta.20
+
+## 1.126.0
+
+## 1.125.2
+
+## 1.125.1
+
+## 1.125.0
+
+## 1.124.0
+
+## 1.123.0
+
+## 1.122.0
+
+## 1.121.0
+
+## 1.120.0
+
+## 1.119.0
+
+## 1.118.0
+
+## 1.117.0
+
+## 1.116.0
+
+## 1.115.0
+
+## 1.114.0
+
+## 1.113.0
+
+## 1.112.0
+
+## 1.111.0
+
+## 1.110.0
+
+## 1.109.0
+
+## 1.108.0
+
+## 1.107.0
+
+### Minor Changes
+
+- 72bfcbf2: ZERO-3347: Manage save button disable status
+
+## 1.106.0
+
+## 1.105.0
+
+## 1.104.0
+
+### Minor Changes
+
+- 2ba89b3: ZERO-3361: Refactor basket gift pack component
+
+## 1.103.0
+
+## 1.102.0
+
+## 1.101.0
+
+## 1.100.0
+
+## 1.99.0
 
 ### Minor Changes
 
-- ZERO-3091: Upgrade Next.js to v15 and React to v19
+- d58538b: ZERO-3638: Enhance RC pipeline: add fetch, merge, and pre-release setup with conditional commit
+
+## 1.98.0
+
+## 1.97.0
+
+## 1.96.0
+
+## 1.95.0
+
+## 1.94.0
+
+## 1.93.0
+
+## 1.92.0
+
+## 1.91.0
+
+## 1.90.0
+
+## 1.89.0
+
+## 1.88.0
+
+### Minor Changes
+
+- 3037704: ZERO-3328: Add data-testid attributes for improved testing in BasketItem and BasketGiftPack components
+
+## 1.87.0
+
+## 1.86.0
+
+## 1.85.0
+
+## 1.84.0
+
+### Minor Changes
+
+- 624a4eb: ZERO-3276: Update installation instructions across multiple README files to standardize format and improve clarity
+
+## 1.83.0
+
+## 1.82.0
+
+## 1.81.0
+
+## 1.80.0
+
+## 1.79.0
 
-## 2.0.0-beta.0
+## 1.78.0
 
-### Major Changes
+## 1.77.0
 
-- be6c09d: ZERO-3114: Create beta version.
+## 1.76.0
 
 ## 1.75.0
 

package/README.md

@@ -1,13 +1,13 @@
 # @akinon/pz-basket-gift-pack
 
-### Install the npm package
+## Installation method
+
+You can use the following command to install the extension with the latest plugins:
 
 ```bash
-# For latest version
-yarn add @akinon/pz-basket-gift-pack
 
-# Preferred installation method
 npx @akinon/projectzero@latest --plugins
+
 ```
 
 ### Props
@@ -19,3 +19,143 @@ npx @akinon/projectzero@latest --plugins
 | modalClassName | `string` | This prop is used to customize the overall style of the modal. |
 | modalTitle | `string` | This prop sets the title of the modal. |
 | modalContentClassName | `string` | This prop is used to customize the style of the modal content. |
+| customUIRender | `React.ReactNode` | Optional function to fully customize the gift pack rendering. Receives hasGiftPack, hasNote, note, textAreaCount, onAddGiftPack, onRemoveGiftPack, onAddNote, onRemoveNote, formContent and translations props. |
+| customGiftNoteFormUIRender | `React.ReactNode` | Optional function to fully customize the form rendering. Receives register, errors, note, textAreaCount, onSubmit, removeNote and handleSubmit props. |
+
+### Customizing Gift Pack
+
+```javascript
+import PluginModule, { Component } from '@akinon/next/components/plugin-module';
+
+<PluginModule
+  component={Component.BasketGiftPack}
+  props={{
+    basketItem,
+    customUIRender: ({
+      hasGiftPack,
+      hasNote,
+      onAddGiftPack,
+      onRemoveGiftPack,
+      onAddNote,
+      formContent,
+      translations
+    }) => (
+      <>
+        <div className="flex gap-4">
+          <div className="flex items-center gap-2">
+            <Icon
+              name="giftbox"
+              size={15}
+              className={clsx(
+                hasGiftPack ? 'text-[#e85150]' : 'text-[#000000]'
+              )}
+            />
+            {hasGiftPack ? (
+              <span className="text-[0.75rem]">
+                {translations.giftPackAdded}
+              </span>
+            ) : (
+              <Button
+                appearance="ghost"
+                className="text-[#000000] cursor-pointer underline border-0 px-0 py-0 text-[0.75rem] h-auto hover:bg-transparent hover:text-[#000000]"
+                onClick={onAddGiftPack}
+                data-testid="add-basket-gift-pack"
+              >
+                {translations.addGiftPack}
+              </Button>
+            )}
+          </div>
+
+          {hasGiftPack && (
+            <>
+              <Button
+                appearance="ghost"
+                className="text-[#000000] cursor-pointer border-0 px-0 py-0 text-[0.75rem] select-none underline h-auto hover:bg-transparent hover:text-[#000000]"
+                onClick={onAddNote}
+                data-testid="add-basket-gift-pack-note"
+              >
+                {hasNote.title}
+              </Button>
+              <Button
+                appearance="ghost"
+                className={clsx(
+                  'text-[#000000] cursor-pointer border-0 px-0 py-0 text-[0.75rem] underline h-auto hover:bg-transparent hover:text-[#000000]',
+                  {
+                    hidden: !hasGiftPack
+                  }
+                )}
+                onClick={onRemoveGiftPack}
+                data-testid="remove-basket-gift-pack"
+              >
+                {translations.removeGiftPack}
+              </Button>
+            </>
+          )}
+        </div>
+
+        <div className="w-full">
+          {hasNote.state ? <div className="mt-4">{formContent}</div> : null}
+        </div>
+      </>
+    )
+  }}
+/>;
+```
+
+### Customizing Gift Note Form
+
+```javascript
+import PluginModule, { Component } from '@akinon/next/components/plugin-module';
+
+<PluginModule
+  component={Component.BasketGiftPack}
+  props={{
+    basketItem,
+    customGiftNoteFormUIRender: ({
+      register,
+      errors,
+      note,
+      textAreaCount,
+      onSubmit,
+      removeNote,
+      handleSubmit
+    }) => (
+      <div className="bg-gray-100 p-4 rounded-md shadow-lg">
+        <h4 className="text-lg font-semibold mb-2">🎁 Add Your Note</h4>
+        <form onSubmit={handleSubmit(onSubmit)}>
+          <textarea
+            className="w-full border border-gray-300 p-2"
+            {...register('message')}
+            placeholder="Mesajını yaz..."
+            rows={5}
+            value={note}
+          />
+          {errors.message && (
+            <p className="text-red-500 text-sm">{errors.message.message}</p>
+          )}
+          <div className="flex justify-between items-center mt-2">
+            <span className="text-sm text-gray-500">
+              {textAreaCount}/ 160 characters
+            </span>
+            <div className="flex gap-2">
+              <button
+                type="button"
+                onClick={removeNote}
+                className="text-sm underline"
+              >
+                Delete Note
+              </button>
+              <button
+                type="submit"
+                className="bg-black text-white px-3 py-1 text-sm rounded"
+              >
+                Save
+              </button>
+            </div>
+          </div>
+        </form>
+      </div>
+    )
+  }}
+/>;
+```

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@akinon/pz-basket-gift-pack",
-  "version": "2.0.0-beta.2",
+  "version": "2.0.0-beta.21",
   "license": "MIT",
   "main": "src/index.tsx",
   "peerDependencies": {
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.10.2",
-    "@types/react": "^19.0.2",
-    "@types/react-dom": "^19.0.2",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "typescript": "^5.7.2"
+    "@types/node": "^18.7.8",
+    "@types/react": "^18.0.17",
+    "@types/react-dom": "^18.0.6",
+    "react": "19.2.5",
+    "react-dom": "19.2.5",
+    "typescript": "^4.7.4"
   }
 }

package/src/index.tsx

@@ -4,38 +4,69 @@ import {
 } from './endpoints';
 import clsx from 'clsx';
 import { twMerge } from 'tailwind-merge';
-import { useForm, SubmitHandler } from 'react-hook-form';
+import {
+  useForm,
+  SubmitHandler,
+  UseFormRegister,
+  FieldErrors,
+  UseFormHandleSubmit
+} from 'react-hook-form';
 import { yupResolver } from '@hookform/resolvers/yup';
 import * as yup from 'yup';
 import { useEffect, useState } from 'react';
 import { Button, Icon, Modal } from '@akinon/next/components';
 import { BasketItem as BasketItemType } from '@akinon/next/types';
 
+const defaultTranslations = {
+  placeholderInput:
+    'You can leave this area empty. However it will be a gift package without note.',
+  warningMessage: 'Ensure this field has no more than 160 characters.',
+  addNote: 'Add Note',
+  addGiftNote: 'Add Gift Note',
+  changeNote: 'Change Note',
+  giftPackAdded: 'Gift Pack Added',
+  addGiftPack: 'Add Gift Pack',
+  removeGiftPack: 'Remove Gift Pack',
+  charactersLength: 'characters left',
+  removeNote: 'Remove Note',
+  save: 'SAVE',
+  saving: 'SAVING...',
+  close: 'Close'
+};
+
 interface GiftPackForm {
   message: string;
 }
-
+interface CustomRenderParams {
+  hasGiftPack: boolean;
+  hasNote: { title: string; state: boolean };
+  note: string;
+  textAreaCount: number;
+  onAddGiftPack: () => void;
+  onRemoveGiftPack: () => void;
+  onAddNote: () => void;
+  onRemoveNote: () => void;
+  formContent: React.ReactNode;
+  translations: typeof defaultTranslations;
+}
 interface Props {
   basketItem: BasketItemType;
   useModal?: boolean;
   modalTitle?: string;
   modalClassName?: string;
   modalContentClassName?: string;
-  translations?: {
-    placeholderInput?: string;
-    warningMessage?: string;
-    addNote?: string;
-    addGiftNote?: string;
-    changeNote?: string;
-    giftPackAdded?: string;
-    addGiftPack?: string;
-    removeGiftPack?: string;
-    charactersLength?: string;
-    removeNote?: string;
-    save?: string;
-    close?: string;
-  };
+  translations?: Partial<typeof defaultTranslations>;
   className?: string;
+  customUIRender?: (params: CustomRenderParams) => React.ReactNode;
+  customGiftNoteFormUIRender?: (params: {
+    register: UseFormRegister<GiftPackForm>;
+    errors: FieldErrors<GiftPackForm>;
+    note: string;
+    textAreaCount: number;
+    onSubmit: () => void;
+    removeNote: () => void;
+    handleSubmit: UseFormHandleSubmit<GiftPackForm>;
+  }) => React.ReactNode;
 }
 
 export const BasketGiftPack = ({
@@ -45,30 +76,13 @@ export const BasketGiftPack = ({
   useModal = false,
   modalTitle = 'Gift Note',
   modalClassName,
-  modalContentClassName
+  modalContentClassName,
+  customUIRender,
+  customGiftNoteFormUIRender
 }: Props) => {
-  const defaultTranslations = {
-    placeholderInput:
-      'You can leave this area empty. However it will be a gift package without note.',
-    warningMessage: 'Ensure this field has no more than 160 characters.',
-    addNote: 'Add Note',
-    addGiftNote: 'Add Gift Note',
-    changeNote: 'Change Note',
-    giftPackAdded: 'Gift Pack Added',
-    addGiftPack: 'Add Gift Pack',
-    removeGiftPack: 'Remove Gift Pack',
-    charactersLength: 'characters left',
-    removeNote: 'Remove Note',
-    save: 'SAVE',
-    close: 'Close'
-  };
-
-  const _translations = {
-    ...defaultTranslations,
-    ...translations
-  };
-
-  const [addGiftPackage] = useAddGiftPackageMutation();
+  const _translations = { ...defaultTranslations, ...translations };
+  const [addGiftPackage, { isLoading: isAddingGiftPackage }] =
+    useAddGiftPackageMutation();
   const [removeGiftPackage] = useRemoveGiftPackageMutation();
   const [hasGiftPack, setHasGiftPack] = useState(false);
   const [hasNote, setHasNote] = useState({
@@ -79,10 +93,9 @@ export const BasketGiftPack = ({
   const [note, setNote] = useState('');
   const defaultMessage = 'NO-GIFT-NOTE';
 
-  const giftPackFormSchema = () =>
-    yup.object().shape({
-      message: yup.string().max(160, _translations.warningMessage)
-    });
+  const schema = yup.object().shape({
+    message: yup.string().max(160, _translations.warningMessage)
+  });
 
   const {
     register,
@@ -90,54 +103,83 @@ export const BasketGiftPack = ({
     handleSubmit,
     formState: { errors }
   } = useForm<GiftPackForm>({
-    resolver: yupResolver(giftPackFormSchema())
+    resolver: yupResolver(schema) as any
   });
 
   const onSubmit: SubmitHandler<GiftPackForm> = async (data) => {
-    addGiftPackage({ id: basketItem.id, message: data.message })
-      .unwrap()
-      .then(() => {
-        setHasNote((prevstate) => ({ ...prevstate, state: false }));
-        changeNoteTitle(data.message);
-      });
+    await addGiftPackage({ id: basketItem.id, message: data.message }).unwrap();
+    setHasNote({ ...hasNote, state: false });
+    changeNoteTitle(data.message);
   };
 
-  const addGiftPack = () => {
-    addGiftPackage({ id: basketItem.id, message: defaultMessage })
-      .unwrap()
-      .then(() => {
-        setHasGiftPack(true);
-        setHasNote((prevstate) => ({ ...prevstate, state: false }));
-      });
+  const addGiftPack = async () => {
+    await addGiftPackage({
+      id: basketItem.id,
+      message: defaultMessage
+    }).unwrap();
+    setHasGiftPack(true);
+    setHasNote({ ...hasNote, state: false });
   };
 
   const removeGiftPack = () => {
     removeGiftPackage({ id: basketItem.id });
     setHasGiftPack(false);
-    setHasNote((prevstate) => ({ ...prevstate, state: false }));
+    setHasNote({ ...hasNote, state: false });
   };
 
   const removeNote = () => {
     addGiftPackage({ id: basketItem.id, message: defaultMessage });
-    setHasNote((prevstate) => ({ ...prevstate, state: false }));
+    setHasNote({ ...hasNote, state: false });
     changeNoteTitle(defaultMessage);
   };
 
-  const changeNoteTitle = (value) => {
-    if (value !== defaultMessage) {
-      setHasNote((prevstate) => ({
-        ...prevstate,
-        title: _translations.changeNote
-      }));
-    } else {
-      setHasNote((prevstate) => ({
-        ...prevstate,
-        title: _translations.addNote
-      }));
-    }
+  const changeNoteTitle = (value: string) => {
+    const title =
+      value !== defaultMessage
+        ? _translations.changeNote
+        : _translations.addNote;
+    setHasNote((prev) => ({ ...prev, title }));
   };
 
-  const formContent = (
+  useEffect(() => {
+    for (const [key, value] of Object.entries(basketItem.attributes)) {
+      if (value === '') {
+        setHasGiftPack(false);
+        setHasNote({ ...hasNote, state: false });
+        setNote('');
+        setTextAreaCount(0);
+        return;
+      }
+
+      if (key) {
+        changeNoteTitle(value);
+        setNote(value);
+        setHasGiftPack(true);
+        setTextAreaCount(value === defaultMessage ? 0 : value.length);
+      }
+    }
+  }, [basketItem.attributes]);
+
+  useEffect(() => {
+    const subscription = watch(({ message }) => {
+      setNote(message);
+      setTextAreaCount(message.length);
+    });
+
+    return () => subscription.unsubscribe();
+  }, [watch]);
+
+  const formContent = customGiftNoteFormUIRender ? (
+    customGiftNoteFormUIRender({
+      register,
+      errors,
+      note,
+      textAreaCount,
+      onSubmit: () => handleSubmit(onSubmit)(),
+      removeNote,
+      handleSubmit
+    })
+  ) : (
     <form onSubmit={handleSubmit(onSubmit)}>
       {!useModal && (
         <div className="flex justify-between mb-3">
@@ -149,7 +191,7 @@ export const BasketGiftPack = ({
             className="text-[#000000] cursor-pointer border-0 px-0 py-0 text-[0.75rem] select-none underline h-auto hover:bg-transparent hover:text-[#000000]"
             onClick={(e) => {
               e.preventDefault();
-              setHasNote((prevstate) => ({ ...prevstate, state: false }));
+              setHasNote({ ...hasNote, state: false });
             }}
           >
             {_translations.close}
@@ -157,80 +199,55 @@ export const BasketGiftPack = ({
         </div>
       )}
       <textarea
-        className="w-full border border-solid border-[#4a4f53] p-4 placeholder:text-[0.75rem] placeholder:text-[#c8c9c8] outline-none text-[0.75rem]"
+        className="w-full border border-[#4a4f53] p-4 text-[0.75rem] placeholder:text-[#c8c9c8]"
         rows={7}
-        name="message"
-        value={note !== defaultMessage ? note : ' '}
         placeholder={_translations.placeholderInput}
         {...register('message')}
+        value={note !== defaultMessage ? note : ''}
+        data-testid="basket-gift-pack-note-input"
       />
       {errors.message && (
-        <span className="text-sm text-[#d72a04]">{errors.message.message}</span>
+        <span className="text-sm text-[#d72a04]">{String(errors.message.message)}</span>
       )}
-      <div className="flex justify-between items-center mt-2">
+      <div className="flex justify-between mt-2 items-center">
         <span
           className={clsx(
-            'text-[0.75rem] ',
+            'text-[0.75rem]',
             textAreaCount > 160 ? 'text-[#e85150]' : 'text-[#82a27c]'
           )}
         >
           {textAreaCount}/160 {_translations.charactersLength}
         </span>
-        <div className="flex items-center gap-3">
+        <div className="flex gap-3 items-center">
           <Button
             appearance="ghost"
             className="text-[#000000] cursor-pointer border-0 px-0 py-0 text-[0.75rem] select-none underline h-auto hover:bg-transparent hover:text-[#000000]"
             onClick={removeNote}
+            data-testid="basket-gift-pack-note-remove-button"
           >
             {_translations.removeNote}
           </Button>
-          <Button type="submit" className="w-28 h-7 font-medium uppercase">
-            {_translations.save}
+          <Button
+            type="submit"
+            className="w-28 h-7 font-medium uppercase"
+            data-testid="basket-gift-pack-note-save-button"
+            disabled={
+              isAddingGiftPackage ||
+              textAreaCount === 0 ||
+              note.trim() === '' ||
+              note === defaultMessage
+            }
+          >
+            {isAddingGiftPackage ? _translations.saving : _translations.save}
           </Button>
         </div>
       </div>
     </form>
   );
 
-  useEffect(() => {
-    for (const [key, value] of Object.entries(basketItem.attributes)) {
-      if (value === '') {
-        setHasGiftPack(false);
-        setHasNote((prevstate) => ({ ...prevstate, state: false }));
-        setNote('');
-        setTextAreaCount(0);
-        return;
-      }
-
-      if (key) {
-        changeNoteTitle(value);
-        setNote(value);
-        setHasGiftPack(true);
-        setTextAreaCount(value?.length);
-      }
-    }
-  }, [basketItem.attributes]);
-
-  useEffect(() => {
-    const subscription = watch(({ message }) => {
-      setNote(message);
-      setTextAreaCount(message.length);
-    });
-
-    return () => subscription.unsubscribe();
-  }, [watch]);
-
-  return (
+  const defaultRender = () => (
     <div
-      className={twMerge(
-        clsx(
-          'mt-4 sm:mt-0',
-          {
-            'sm:mt-8': hasNote.state
-          },
-          className
-        )
-      )}
+      className={twMerge(clsx('mt-4', { 'md:mt-8': hasNote.state }, className))}
     >
       <div className="flex gap-4">
         <div className="flex items-center gap-2">
@@ -239,7 +256,6 @@ export const BasketGiftPack = ({
             size={15}
             className={clsx(hasGiftPack ? 'text-[#e85150]' : 'text-[#000000]')}
           />
-
           {hasGiftPack ? (
             <span className="text-[0.75rem]">
               {_translations.giftPackAdded}
@@ -249,39 +265,40 @@ export const BasketGiftPack = ({
               appearance="ghost"
               className="text-[#000000] cursor-pointer underline border-0 px-0 py-0 text-[0.75rem] h-auto hover:bg-transparent hover:text-[#000000]"
               onClick={addGiftPack}
+              data-testid="add-basket-gift-pack"
             >
               {_translations.addGiftPack}
             </Button>
           )}
         </div>
-        <Button
-          appearance="ghost"
-          className={clsx(
-            'text-[#000000] underline cursor-pointer border-0 px-0 py-0 text-[0.75rem] h-auto hover:bg-transparent hover:text-[#000000]',
-            {
-              hidden: !hasGiftPack
-            }
-          )}
-          onClick={() =>
-            setHasNote((prevstate) => ({ ...prevstate, state: true }))
-          }
-        >
-          {hasNote.title}
-        </Button>
 
-        <Button
-          appearance="ghost"
-          className={clsx(
-            'text-[#000000] cursor-pointer border-0 px-0 py-0 text-[0.75rem] underline h-auto hover:bg-transparent hover:text-[#000000]',
-            {
-              hidden: !hasGiftPack
-            }
-          )}
-          onClick={removeGiftPack}
-        >
-          {_translations.removeGiftPack}
-        </Button>
+        {hasGiftPack && (
+          <>
+            <Button
+              appearance="ghost"
+              className="text-[#000000] cursor-pointer border-0 px-0 py-0 text-[0.75rem] select-none underline h-auto hover:bg-transparent hover:text-[#000000]"
+              onClick={() => setHasNote({ ...hasNote, state: true })}
+              data-testid="add-basket-gift-pack-note"
+            >
+              {hasNote.title}
+            </Button>
+            <Button
+              appearance="ghost"
+              className={clsx(
+                'text-[#000000] cursor-pointer border-0 px-0 py-0 text-[0.75rem] underline h-auto hover:bg-transparent hover:text-[#000000]',
+                {
+                  hidden: !hasGiftPack
+                }
+              )}
+              onClick={removeGiftPack}
+              data-testid="remove-basket-gift-pack"
+            >
+              {_translations.removeGiftPack}
+            </Button>
+          </>
+        )}
       </div>
+
       {useModal ? (
         <Modal
           portalId="basket-gift-pack-modal"
@@ -291,23 +308,30 @@ export const BasketGiftPack = ({
             modalClassName
           )}
           open={hasNote.state}
-          setOpen={(state) =>
-            setHasNote((prevstate) => ({ ...prevstate, state }))
-          }
+          setOpen={(state) => setHasNote((prev) => ({ ...prev, state }))}
         >
           <div className={twMerge('px-6 py-4', modalContentClassName)}>
             {formContent}
           </div>
         </Modal>
-      ) : (
-        <div
-          className={clsx('mt-4', {
-            hidden: !hasNote.state
-          })}
-        >
-          {formContent}
-        </div>
-      )}
+      ) : hasNote.state ? (
+        <div className="mt-4">{formContent}</div>
+      ) : null}
     </div>
   );
+
+  return customUIRender
+    ? customUIRender({
+        hasGiftPack,
+        hasNote,
+        note,
+        textAreaCount,
+        onAddGiftPack: addGiftPack,
+        onRemoveGiftPack: removeGiftPack,
+        onAddNote: () => setHasNote({ ...hasNote, state: true }),
+        onRemoveNote: removeNote,
+        formContent,
+        translations: _translations
+      })
+    : defaultRender();
 };