added ensure capacity to grow a memory space

Squashed commit of the following:

commit e046712d
Author: asemenov <alexandr.v.semenov@nasa.gov>
Date:   Sat Mar 28 16:18:29 2026 -0400

    #1124 remove debug print

commit 3bf4a193
Author: alex <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 19:20:46 2026 +0000

    #1124 simplified

commit 1b5354a2
Author: alex <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 18:21:20 2026 +0000

    #1124 cleanup comments

commit 77a56e8a
Author: alex <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 18:15:01 2026 +0000

    #1124 changed doxygen comments

commit f6df6c86
Author: alex <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 18:12:52 2026 +0000

    #1124 made more robust ensured capacity

commit f83b2d2f
Author: alex <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 17:21:40 2026 +0000

    #1124 added missing gcc header

commit fea9d029
Author: asemenov <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 11:11:55 2026 -0400

    #1124 fixed the function api

commit 312e7038
Author: asemenov <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 11:04:19 2026 -0400

    #1124 fixed the function api

commit 73308ddf
Author: asemenov <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 10:37:33 2026 -0400

    #1124 fixed doxygen comment

commit c56fbca6
Author: asemenov <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 10:36:23 2026 -0400

    #1124 new helper function to ensure capacity

commit 6afbcb92
Author: asemenov <alexandr.v.semenov@nasa.gov>
Date:   Fri Mar 27 10:29:20 2026 -0400

    #1124 new helper function to ensure capacity