ui-soxo-bootstrap-core 2.4.25-dev.7 → 2.4.25-dev.9

package/core/lib/elements/basic/rangepicker/rangepicker.js

@@ -1,46 +1,135 @@
-import { DatePicker } from 'antd';
+/**
+ * @file rangepicker.js
+ * @description A reusable, enhanced Ant Design RangePicker component.
+ *
+ * Features:
+ * - Manual selections require "Apply" button confirmation
+ * - Preset ranges apply immediately without confirmation
+ * - Optimized state management and event handling
+ */
+
+import { useCallback, useRef, useState } from 'react';
+import { DatePicker, Space } from 'antd';
 import moment from 'moment-timezone';
 import PropTypes from 'prop-types';
+import { useTranslation } from 'react-i18next';
+import Button from '../button/button';
 import './rangepicker.scss';
 
+/**
+ * Enhanced RangePicker with Apply/Cancel controls for manual selections.
+ * @param {object} props
+ * @param {moment.Moment[]} props.value - Current applied date range
+ * @param {function(moment.Moment[]): void} props.onChange - Callback when range is applied
+ * @param {string} [props.format='DD/MM/YYYY'] - Date display format
+ * @param {object} [props.ranges] - Preset date ranges
+ * @param {boolean} [props.allowClear=false] - Whether to show clear button
+ * @param {boolean} [props.inputReadOnly=true] - Whether input is read-only
+ */
+
 const { RangePicker } = DatePicker;
 
-export default function RangePickerComponent({ onChange, value, ranges }) {
-  // value is still: [moment, moment]
-  const startDate = value[0];
-  const endDate = value[1];
+export default function RangePickerComponent({
+  value,
+  onChange,
+  format = 'DD/MM/YYYY',
+  ranges,
+  allowClear = false,
+  inputReadOnly = true,
+  ...restProps
+}) {
+  const { t } = useTranslation();
+
+  // Temporary range during selection (before Apply is clicked)
+  const [tempRange, setTempRange] = useState(null);
+  const [isOpen, setIsOpen] = useState(false);
+
+  // Ref to track if a selection just happened, to prevent the picker from closing.
+  const selectionJustHappened = useRef(false);
 
-  function handleChange(dates) {
-    if (!dates) {
-      onChange(null);
+  /**
+   * Handles any completed date selection (both manual and preset).
+   * It updates the temporary range and sets a flag to keep the picker open.
+   */
+  const handleChange = useCallback((dates) => {
+    setTempRange(dates || []);
+    selectionJustHappened.current = true;
+  }, []);
+
+  /**
+   * Handles picker open/close events.
+   * Prevents closing after a selection, requiring user to click Apply/Cancel.
+   */
+  const handleOpenChange = useCallback((open) => {
+    // If the picker is trying to close, check if it was due to a selection.
+    if (!open && selectionJustHappened.current) {
+      // It was a selection, so ignore the close request and reset the flag.
+      selectionJustHappened.current = false;
       return;
     }
 
-    // Convert dayjs → moment so your external code does NOT break
-    const converted = [moment(dates[0].toDate()), moment(dates[1].toDate())];
+    // For all other cases (opening, or closing by clicking outside), proceed as normal.
+    if (open) {
+      // Reset temp range when opening for a fresh selection.
+      setTempRange(null);
+    }
+    setIsOpen(open);
+  }, []);
+
+  /**
+   * Applies the temporary range and closes picker
+   */
+  const handleApply = useCallback(() => {
+    if (tempRange?.length === 2 && onChange) {
+      onChange(tempRange);
+    }
+    selectionJustHappened.current = false; // Clear the flag
+    setIsOpen(false);
+  }, [tempRange, onChange]);
 
-    onChange(converted);
-  }
+  /**
+   * Cancels selection and closes picker
+   */
+  const handleCancel = useCallback(() => {
+    selectionJustHappened.current = false; // Clear the flag
+    setTempRange(null);
+    setIsOpen(false);
+  }, []);
 
-  // Convert your old "ranges" object into AntD presets array
-  const presets = Object.entries(ranges).map(([label, range]) => ({
-    label,
-    value: range,
-  }));
+  // Memoized preset ranges - use provided ranges or default set
+  const defaultRanges = useRef({
+    Today: [moment(), moment()],
+    Yesterday: [moment().subtract(1, 'days').startOf('day'), moment().subtract(1, 'days').endOf('day')],
+    'This Week': [moment().startOf('week'), moment().endOf('week')],
+    'Last Week': [moment().subtract(1, 'week').startOf('week'), moment().subtract(1, 'week').endOf('week')],
+    'This Month': [moment().startOf('month'), moment().endOf('month')],
+    'Last Month': [moment().subtract(1, 'month').startOf('month'), moment().subtract(1, 'month').endOf('month')],
+  }).current;
 
   return (
-    <div className="rangepicker">
-      <RangePicker
-        allowClear={false}
-        inputReadOnly
-        format="DD/MM/YYYY"
-        // moment → allowed
-        value={[startDate, endDate]}
-        onChange={handleChange}
-        presets={presets}
-        ranges={ranges}
-      />
-    </div>
+    <RangePicker
+      allowClear={allowClear}
+      inputReadOnly={inputReadOnly}
+      format={format}
+      value={tempRange || value}
+      open={isOpen}
+      onOpenChange={handleOpenChange}
+      onChange={handleChange}
+      ranges={ranges !== undefined ? ranges : defaultRanges}
+      {...restProps}
+      renderExtraFooter={() => (
+        <div style={{ width: '100%', display: 'flex', justifyContent: 'flex-end', order: 1 }}>
+          <Space>
+            <Button size="small" onClick={handleCancel}>
+              {t('Cancel')}
+            </Button>
+            <Button type="primary" size="small" onClick={handleApply}>
+              {t('Apply')}
+            </Button>
+          </Space>
+        </div>
+      )}
+    />
   );
 }
 

package/core/models/staff/components/staff-add/staff-add.js

@@ -0,0 +1,352 @@
+import React, { useState, useEffect, useRef } from 'react';
+import './staff-add.scss';
+import { Modal, Tabs, Input, Form, Row, Col, message, Checkbox, Select } from 'antd';
+import { useTranslation, Button } from './../../../../lib/';
+import { UsersAPI } from '../../..';
+
+const StaffAdd = ({ visible, onCancel, staffId, staffData, onSuccess }) => {
+  const [form] = Form.useForm();
+  const { t } = useTranslation();
+
+  /** -------------------------------
+   *  STATE
+   * ------------------------------- */
+  const [loading, setLoading] = useState(false);
+  const [designations, setDesignations] = useState([]);
+  const [isSubmitDisabled, setIsSubmitDisabled] = useState(true);
+  const [codeStatus, setCodeStatus] = useState({ status: '', message: '' });
+
+  const nameInputRef = useRef(null);
+
+  const editMode = Boolean(staffId);
+
+  /** -------------------------------
+   *  FORM WATCHERS
+   * ------------------------------- */
+  const watchedName = Form.useWatch('shortName', form);
+  const watchedCode = Form.useWatch('id', form);
+  const watchedDesc = Form.useWatch('description', form);
+
+  /** -------------------------------
+   *  EFFECTS
+   * ------------------------------- */
+
+  // Auto-focus on open
+  useEffect(() => {
+    if (visible) {
+      setTimeout(() => nameInputRef.current?.focus(), 200);
+    }
+  }, [visible]);
+
+  // Control submit button
+  useEffect(() => {
+    setIsSubmitDisabled(!(watchedName && watchedCode && watchedDesc));
+  }, [watchedName, watchedCode, watchedDesc]);
+
+  // Load designations when modal opens
+  useEffect(() => {
+    if (visible) getDesignations();
+  }, [visible]);
+
+  // Reset or fill edit form
+  useEffect(() => {
+    if (visible) {
+      if (editMode && staffData) fillEditForm(staffData);
+    } else {
+      form.resetFields();
+    }
+  }, [visible]);
+
+  /** -------------------------------
+   *  API CALL – Designations
+   * ------------------------------- */
+  const getDesignations = () => {
+    setLoading(true);
+    UsersAPI.getDesignations()
+      .then((res) => {
+        if (res?.success && Array.isArray(res.result)) {
+          const formatted = res.result.map((ele) => ({
+            label: ele.dg_desc?.trim() || '',
+            value: ele.dg_code,
+          }));
+          setDesignations(formatted);
+        } else {
+          setDesignations([]);
+        }
+      })
+      .catch((err) => {
+        console.error('Error fetching designations:', err);
+        setDesignations([]);
+      })
+      .finally(() => setLoading(false));
+  };
+
+  /** -------------------------------
+   *  VALIDATION – Code
+   * ------------------------------- */
+  const validateDoctorCode = async (_, value) => {
+    if (editMode) return Promise.resolve(); // Skip validation if editing
+
+    if (!value) {
+      setCodeStatus({ status: '', message: '' });
+      return Promise.resolve();
+    }
+
+    try {
+      const res = await UsersAPI.getStaffCode(value);
+
+      if (res?.status === 409 || res?.success === false) {
+        setCodeStatus({ status: 'error', message: res.message || 'Code already exists' });
+        return Promise.reject(new Error(res.message || 'Code already exists'));
+      }
+
+      if (res?.status === 200 && res?.success === true) {
+        setCodeStatus({
+          status: 'success',
+          message: 'The entered code is valid for assigning a staff.',
+        });
+        return Promise.resolve();
+      }
+
+      setCodeStatus({ status: 'error', message: 'Unexpected response' });
+      return Promise.reject(new Error('Unexpected response'));
+    } catch {
+      setCodeStatus({ status: 'error', message: 'Validation failed' });
+      return Promise.reject(new Error('Validation failed'));
+    }
+  };
+
+  /** -------------------------------
+   *  UTIL – Enter Key Navigation
+   * ------------------------------- */
+  const handleEnterKey = (e) => {
+    if (e.key === 'Enter') {
+      e.preventDefault();
+      const fields = Array.from(document.querySelectorAll('.ant-input'));
+      const index = fields.indexOf(e.target);
+      if (index > -1 && index < fields.length - 1) {
+        fields[index + 1].focus();
+      }
+    }
+  };
+
+  /** -------------------------------
+   *  FORM FILL – Edit Mode
+   * ------------------------------- */
+  const fillEditForm = (data) => {
+    form.setFieldsValue({
+      id: data.id,
+      shortName: data.shortName,
+      description: data.description,
+      designation: data.designationPtr,
+      phone1: data.phone,
+      phone2: data.mobile || data.alternateMobile,
+      email1: data.email,
+      email2: data.alternateEmail,
+      slno: data.slNo,
+      active: data.active === 'Y' ? 'Y' : 'N',
+      remarks: data.remarks,
+      address1: data.address1,
+      address2: data.address2,
+      place: data.place,
+      zip: data.zip,
+    });
+  };
+
+  /** -------------------------------
+   *  SUBMIT HANDLER
+   * ------------------------------- */
+  const handleFinish = async (values) => {
+    setLoading(true);
+
+    const payload = {
+      id: values.id,
+      shortName: values.shortName,
+      description: values.description,
+      designationPtr: values.designation,
+      phone: values.phone1,
+      mobile: values.phone2,
+      alternateMobile: values.phone2,
+      email: values.email1,
+      alternateEmail: values.email2,
+      remarks: values.remarks,
+      slNo: values.slno ? Number(values.slno) : null,
+      active: values.active === 'Y' ? 'Y' : 'N',
+      address1: values.address1,
+      address2: values.address2,
+      place: values.place,
+      zip: values.zip,
+    };
+
+    try {
+      const res = editMode ? await UsersAPI.updateStaff(payload, staffData.id) : await UsersAPI.createStaff(payload);
+
+      if (res?.success) {
+        message.success(editMode ? 'Staff updated successfully' : 'Staff created successfully');
+        onSuccess?.();
+        onCancel();
+      } else {
+        message.error(res?.message || 'Operation failed');
+      }
+    } catch {
+      message.error('Something went wrong');
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  /** -------------------------------
+   *  RENDER
+   * ------------------------------- */
+  return (
+    <Modal
+      title={editMode ? 'Edit Staff' : 'Add Staff'}
+      open={visible}
+      onCancel={onCancel}
+      width={950}
+      footer={null}
+      destroyOnClose
+      style={{ top: 10 }}
+    >
+      <Form form={form} layout="vertical" onFinish={handleFinish}>
+        {/* TOP SECTION */}
+        <Row gutter={16}>
+          <Col span={6}>
+            <Form.Item
+              label="Code"
+              name="id"
+              validateTrigger="onChange"
+              hasFeedback={!editMode}
+              rules={[{ required: true }, { validator: validateDoctorCode }]}
+            >
+              <Input placeholder="Enter Code" ref={nameInputRef} onKeyDown={handleEnterKey} disabled={editMode} />
+            </Form.Item>
+          </Col>
+
+          <Col span={6}>
+            <Form.Item label="Name" name="shortName" rules={[{ required: true }]}>
+              <Input placeholder="Enter Name" onKeyDown={handleEnterKey} />
+            </Form.Item>
+          </Col>
+
+          <Col span={12}>
+            <Form.Item label="Description" name="description" rules={[{ required: true }]}>
+              <Input placeholder="Enter Description" onKeyDown={handleEnterKey} />
+            </Form.Item>
+          </Col>
+        </Row>
+
+        <Tabs defaultActiveKey="1">
+          {/* GENERAL TAB */}
+          <Tabs.TabPane tab="GENERAL" key="1">
+            <Row gutter={16}>
+              <Col span={6}>
+                <Form.Item label="Phone Number 1" name="phone1">
+                  <Input maxLength={10} placeholder="Enter Phone Number" onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+
+              <Col span={6}>
+                <Form.Item label="Phone Number 2" name="phone2">
+                  <Input maxLength={10} placeholder="Enter Phone Number" onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+
+              <Col span={6}>
+                <Form.Item label="Email ID 1" name="email1">
+                  <Input placeholder="Enter Email" onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+
+              <Col span={6}>
+                <Form.Item label="Email ID 2" name="email2">
+                  <Input placeholder="Enter Email" onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+            </Row>
+
+            <Row gutter={16}>
+              <Col span={8}>
+                <Form.Item name="designation" label="Designation">
+                  <Select placeholder="Select Designation" options={designations} allowClear showSearch optionFilterProp="label" />
+                </Form.Item>
+              </Col>
+
+              <Col span={8}>
+                <Form.Item label="Serial Number" name="slno">
+                  <Input placeholder="Enter Serial Number" onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+
+              <Col span={8}>
+                <div style={{ display: 'flex', alignItems: 'center', gap: 10, marginTop: 30 }}>
+                  <label>Active</label>
+                  <Form.Item
+                    name="active"
+                    valuePropName="checked"
+                    getValueFromEvent={(e) => (e.target.checked ? 'Y' : 'N')}
+                    getValueProps={(value) => ({ checked: value === 'Y' })}
+                    style={{ marginBottom: 0 }}
+                  >
+                    <Checkbox />
+                  </Form.Item>
+                </div>
+              </Col>
+            </Row>
+
+            <Row>
+              <Col span={24}>
+                <Form.Item label="Remarks" name="remarks">
+                  <Input placeholder="Enter Remarks" onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+            </Row>
+          </Tabs.TabPane>
+
+          {/* ADDRESS TAB */}
+          <Tabs.TabPane tab="ADDRESS" key="2">
+            <Row gutter={16}>
+              <Col span={12}>
+                <Form.Item label="Address Line 1" name="address1">
+                  <Input placeholder="Enter Address" onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+
+              <Col span={12}>
+                <Form.Item label="Address Line 2" name="address2">
+                  <Input placeholder="Enter Address" onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+            </Row>
+
+            <Row gutter={16}>
+              <Col span={12}>
+                <Form.Item label="Place" name="place">
+                  <Input placeholder="Enter Place" onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+
+              <Col span={12}>
+                <Form.Item label="Zip Code" name="zip">
+                  <Input placeholder="Enter Zip Code" maxLength={7} onKeyDown={handleEnterKey} />
+                </Form.Item>
+              </Col>
+            </Row>
+          </Tabs.TabPane>
+        </Tabs>
+
+        {/* FOOTER BUTTONS */}
+        <div style={{ display: 'flex', justifyContent: 'flex-end', gap: 10 }}>
+          <Button onClick={onCancel} type="secondary">
+            Cancel
+          </Button>
+          <Button type="primary" htmlType="submit" loading={loading} disabled={isSubmitDisabled}>
+            {editMode ? 'Update' : 'Save'}
+          </Button>
+        </div>
+      </Form>
+    </Modal>
+  );
+};
+
+export default StaffAdd;

package/core/models/users/components/user-add/user-add.js

@@ -12,6 +12,7 @@ import { ModelsAPI, PagesAPI } from '../../..';
 
 import { UsersAPI } from '../../..';
 import DoctorAdd from '../../../doctor/components/doctor-add/doctor-add';
+import StaffAdd from '../../../staff/components/staff-add/staff-add';
 
 const { Title } = Typography;
 
@@ -37,6 +38,9 @@ const UserAdd = ({ model, callback, edit, history, formContent, match, additiona
   const [users, setUsers] = useState([]);
   const [doctorID, setDoctorID] = useState(false);
   const [selectedDoctor, setSelectedDoctor] = useState(null);
+  const [staffID, setStaffID] = useState(false);
+  const [selectedStaff, setSelectedStaff] = useState(null);
+  const [staffList, setStaffList] = useState([]);
   /**Converting to JSON */
   let firmDetails = JSON.parse(user.firm.f_otherdetails1);
 
@@ -160,6 +164,7 @@ const UserAdd = ({ model, callback, edit, history, formContent, match, additiona
     { label: 'General', value: 'GEN' },
     { label: 'Doctor', value: 'RAD' },
     { label: 'Radiographer', value: 'TECH' },
+    { label: 'Staff', value: 'STAFF' },
   ];
 
   /**
@@ -237,6 +242,25 @@ const UserAdd = ({ model, callback, edit, history, formContent, match, additiona
       })
       .catch((err) => console.error('Doctor API Error:', err));
   };
+  /** Get staff List */
+  const getStaff = () => {
+    UsersAPI.getAllStaff()
+      .then((res) => {
+        console.log('Staff List Response:', res);
+
+        if (Array.isArray(res)) {
+          const list = res.map((staff) => ({
+            label: `${staff.shortName || 'No Name'} (${staff.id})`,
+            value: staff.id,
+          }));
+
+          setStaffList(list);
+        } else {
+          console.error('API did not return an array!');
+        }
+      })
+      .catch((err) => console.error('staff API Error:', err));
+  };
 
   // Function to handle user type change
   const handleUserTypeChange = (value) => {
@@ -247,6 +271,11 @@ const UserAdd = ({ model, callback, edit, history, formContent, match, additiona
     } else {
       form.setFieldsValue({ default_code: undefined });
     }
+    if (value === 'STAFF') {
+      getStaff(); // load staff list
+    } else {
+      form.setFieldsValue({ staff_code: undefined });
+    }
   };
 
   useEffect(() => {
@@ -254,6 +283,7 @@ const UserAdd = ({ model, callback, edit, history, formContent, match, additiona
     getDesignations();
     getDepartments();
     getDoctors(); // load doctor list
+    getStaff();
   }, []);
 
   useEffect(() => {
@@ -264,6 +294,9 @@ const UserAdd = ({ model, callback, edit, history, formContent, match, additiona
       if (formContent.user_type === 'RAD' && formContent.doctor_code) {
         form.setFieldsValue({ default_code: formContent.doctor_code });
       }
+      if (formContent.user_type === 'STAFF' && formContent.staff_code) {
+        form.setFieldsValue({ staff_code: formContent.staff_code });
+      }
     }
     if (formContent?.id && formContent?.organization_details) {
       try {
@@ -294,7 +327,6 @@ const UserAdd = ({ model, callback, edit, history, formContent, match, additiona
    * Submit values
    */
   const onSubmit = (values) => {
-    console.log('values____________', values);
     /**If PanelOpen is open and edit mode then password will be existing password else new password*/
     if (!isPasswordVisible && mode === 'Edit') {
       values.password = body.password;
@@ -306,6 +338,11 @@ const UserAdd = ({ model, callback, edit, history, formContent, match, additiona
     } else {
       values.doctor_code = null;
     }
+    if (values.user_type === 'STAFF') {
+      values.staff_code = values.staff_code;
+    } else {
+      values.staff_code = null;
+    }
     values = {
       ...values,
       auth_type: 'LDAP',
@@ -481,6 +518,37 @@ const UserAdd = ({ model, callback, edit, history, formContent, match, additiona
                   />
                 </Form.Item>
               )}
+              {userType === 'STAFF' && (
+                <Form.Item name="staff_code" label="Staff Code" rules={[{ required: true, message: 'Please select a staff code' }]}>
+                  <Select
+                    placeholder="Select Code"
+                    options={staffList}
+                    showSearch
+                    optionFilterProp="label"
+                    dropdownRender={(menu) => (
+                      <>
+                        {menu}
+                        <div
+                          style={{
+                            padding: '8px',
+                            cursor: 'pointer',
+                            borderTop: '1px solid #f0f0f0',
+                            color: '#1890ff',
+                          }}
+                          onClick={() => setVisible(true)}
+                        >
+                          + Add New Staff
+                        </div>
+                      </>
+                    )}
+                  />
+                  {/* Render DoctorAdd OUTSIDE the Select */}
+
+                  <StaffAdd visible={visible} onCancel={() => setVisible(false)} staffData={selectedStaff} staffId={staffID} onSuccess={getStaff} />
+
+                  <></>
+                </Form.Item>
+              )}
             </Col>
           </Row>
           <Row gutter={16}>

package/core/models/users/users.js

@@ -276,6 +276,63 @@ class Users extends Base {
   getUser = ({ id }) => {
     return ApiUtils.get({ url: `users/${id}` });
   };
+
+  /**
+   *Cutsom Api for creating staff
+   * @returns
+   */
+
+  createStaff = (formBody) => {
+    return ApiUtils.post({
+      url: `staff/create-staff`,
+      formBody,
+    });
+  };
+
+  /**
+   * Update a staff by ID
+   * @param {Object} formBody - Data to update
+   * @param {string|number} id - Staff ID
+   * @returns {Promise} API response
+   */
+  updateStaff = (formBody, id) => {
+    return ApiUtils.put({
+      url: `staff/update-staff/${id}`,
+      formBody,
+    });
+  };
+
+  /**
+   * edit staff with id
+   * @returns
+   */
+
+  getStaff = (id) => {
+    return ApiUtils.get({
+      url: `staff/get-staff/${id}`,
+    });
+  };
+
+  /**
+   * staff code validation
+   *
+   */
+  getStaffCode = (code) => {
+    return ApiUtils.get({
+      url: `staff/check-staff-exists/${code}`,
+    });
+  };
+
+  /**
+   * get all staff
+   * @returns
+   */
+
+  getAllStaff = () => {
+    return ApiUtils.get({
+      url: 'staff/get-all-staff',
+    });
+  };
 }
 
 export default Users;

package/core/modules/steps/steps.js

@@ -512,7 +512,7 @@ export default function ProcessStepsPage({ processId = 1, match, CustomComponent
   return (
     <Card>
       <Row gutter={20}>
-        <Col xs={24} sm={24} lg={timelineCollapsed ? 3 : 6}>
+        <Col xs={24} sm={24} lg={timelineCollapsed ? 2 : 6}>
 
        
         

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ui-soxo-bootstrap-core",
-  "version": "2.4.25-dev.7",
+  "version": "2.4.25-dev.9",
   "description": "All the Core Components for you to start",
   "keywords": [
     "all in one"

package/README.md

@@ -1,260 +0,0 @@
-# 📦 NPM Release Workflow — Task-Based Development → Develop → Master
-
-This guide describes the complete workflow for publishing **task-based development builds** and **stable releases** using GitHub Actions, Git tags, and npm versioning.
-
-Incorrect versioning or incorrect tags will break the publish pipeline — follow the process exactly.
-
----
-
-# 📘 Table of Contents
-- Overview
-- Branch Strategy
-- Task Branch Workflow
-- Versioning Rules
-- Development Release Workflow (`develop`)
-- Promotion Workflow (Dev → Master)
-- Publishing via GitHub Release UI
-- How GitHub Action Detects Release Type
-- Summary Table
-- Common Mistakes & Fixes
-
----
-
-# 🧩 Overview
-
-We maintain two release channels:
-
-| Channel              | Branch   | Tag              | Purpose               |
-|---------------------|----------|------------------|-----------------------|
-| Stable (`latest`)   | master   | `vX.Y.Z`         | Production release    |
-| Development (`dev`) | develop  | `vX.Y.Z-dev.N`   | QA/internal testing   |
-
-Releases are triggered using Git tags:
-
-```
-npm version
-```
-
----
-
-# 🌿 Branch Strategy
-
-## `master`
-- Production-ready code  
-- Publishes **stable** builds  
-- Versions never include a `dev` suffix  
-
-## `develop`
-- Used for QA/internal testing  
-- Publishes **development** builds  
-- Versions always include `-dev.N`  
-
-## Task Branches
-- Create from `master`  
-- Naming: `task/<JIRA-ID>-<description>`  
-- After completing work, merge into `develop`  
-
----
-
-# 🏗️ Task Branch Workflow
-
-### 1. Create a task branch
-```bash
-git checkout master
-git pull origin master
-git checkout -b task/<JIRA-ID>-<description>
-```
-
-### 2. Work on the task
-```bash
-git add .
-git commit -m "TASK-123: Implement XYZ"
-```
-
-### 3. Merge into develop
-```bash
-git checkout develop
-git pull origin develop
-git merge task/<JIRA-ID>-<description>
-```
-
----
-
-# 🔧 Versioning Rules
-
-## Development Versions
-```
-X.Y.Z-dev.N
-```
-Example:
-```
-2.4.30-dev.0
-```
-
-## Stable Versions
-```
-X.Y.Z
-```
-
-## Rules
-- Each version must be unique  
-- Dev versions do **not** convert into stable versions  
-- Git tag must exactly match `package.json` version  
-
----
-
-# 🟦 Development Release Workflow (`develop`)
-
-### 1. Switch to develop
-```bash
-git checkout develop
-git pull origin develop
-```
-
-### 2. Create a new development version
-```bash
-npm version prerelease --preid=dev
-```
-
-### 3. Push commit + tag
-```bash
-git push --follow-tags
-```
-
-### 4. GitHub Action publishes dev build
-```
-npm publish --tag dev
-```
-
-### 5. Install the dev build
-```bash
-npm install soxo-bootstrap-core@dev
-```
-
----
-
-# 🟩 Promotion Workflow (Dev → Master)
-
-### 1. Switch to master
-```bash
-git checkout master
-git pull origin master
-```
-
-### 2. Merge develop into master
-```bash
-git merge develop
-```
-
-### 3. Bump the stable version
-```bash
-npm version patch
-# or
-npm version minor
-# or
-npm version major
-```
-
-### 4. Push with tags
-```bash
-git push --follow-tags
-```
-
-### 5. GitHub Action publishes stable build
-```
-npm publish
-```
-
-### 6. Install stable version
-```bash
-npm install soxo-bootstrap-core
-# or
-npm install soxo-bootstrap-core@<version>
-```
-
----
-
-# 🟧 Publishing via GitHub Release UI
-
-### Important
-**The tag must match the `package.json` version exactly**, including the `v` prefix.
-
-Example:
-```
-package.json: "version": "2.4.31-dev.0"
-GitHub Tag:  v2.4.31-dev.0
-```
-
----
-
-## Steps
-
-### 1. Ensure `develop` branch is up to date  
-Push your changes.
-
-### 2. Ensure version contains a dev suffix  
-If not:
-```bash
-npm version prerelease --preid=dev
-git push --follow-tags
-```
-
-### 3. Open GitHub → Releases → Draft a new release
-
-### 4. Create tag matching the version  
-Example:
-```
-v2.4.31-dev.0
-```
-
-### 5. Select target branch = `develop`
-
-### 6. Title = tag version  
-Description is optional.
-
-### 7. Publish the release  
-Triggers:
-```
-npm publish --tag dev
-```
-
----
-
-# ⚙️ How GitHub Action Detects Release Type
-
-If version contains `dev`:
-```
-npm publish --tag dev
-```
-
-Otherwise:
-```
-npm publish
-```
-
----
-
-# 📊 Summary Table
-
-| Step                     | Branch   | Command                                 | Tag              | Publish Type |
-|--------------------------|----------|------------------------------------------|------------------|--------------|
-| Create task branch       | master   | `git checkout -b task/<ID>`              | —                | —            |
-| Merge task → develop     | develop  | `git merge task/<ID>`                    | —                | —            |
-| Dev version              | develop  | `npm version prerelease --preid=dev`     | `vX.Y.Z-dev.N`   | dev          |
-| Publish dev build        | develop  | `git push --follow-tags`                 | —                | dev          |
-| Merge develop → master   | master   | `git merge develop`                      | —                | —            |
-| Stable version           | master   | `npm version patch/minor/major`          | `vX.Y.Z`         | latest       |
-| Publish stable build     | master   | `git push --follow-tags`                 | —                | latest       |
-
----
-
-# ⚠️ Common Mistakes & Fixes
-
-| Mistake                        | Issue                | Fix                             |
-|-------------------------------|----------------------|---------------------------------|
-| Tag doesn't match version     | Publish fails        | Always use `npm version`         |
-| Manual tag creation           | Version mismatch     | Avoid manual tagging             |
-| Dev publish from master       | Wrong channel        | Verify branch before tagging     |
-| Not pushing tags              | Workflow won’t run   | Use `git push --follow-tags`     |
-| Merging incomplete tasks      | Breaks dev builds    | Test before merging              |
-