@gkucmierz/utils 3.2.0 → 4.0.1

package/README.md

@@ -28,7 +28,6 @@ This library provides a wide range of mathematical functions and data structures
   - `Trie`: Efficient prefix tree implementation (`class`).
   - `Heap`: Min-heap priority queue (`class`).
   - `ListNode`: Linked list node implementation (`class`).
-  - `matrixAsArray`: 2D matrix representation as a flat array.
 
 - **Number Theory**:
   - `gcd`, `lcm`: Greatest Common Divisor and Least Common Multiple (supports BigInt).
@@ -50,9 +49,10 @@ This library provides a wide range of mathematical functions and data structures
   - `particleSwarmOptimization`: PSO algorithm for global optimization.
   - `simulatedAnnealing`: Probabilistic technique for approximating the global optimum of a given function.
 
-- **Math & 3D Geometry**:
+- **Geometry & Math**:
+  - `barycentricCoordinates`: Triangle barycentric coordinates computation (supports coordinate arrays).
+  - `matrixAsArray`: 2D matrix representation as a flat array.
   - `math3d`: Utilities for 3D vector and matrix math (`crossProduct`, `dotProduct`, `normalize`, `multiplyMatrix4`, `projectToTrackball`, `getRotationMatrixFromVectors`).
-  - `randNormal`: Normal (Gaussian) distribution random number generator (Box-Muller transform).
 
 - **Automata & Simulation**:
   - `createLangtonsAnt`, `createUnlimitedGrid`: Infinite 2D grid and Langton's Ant cellular automaton engine (Project Euler 349 compatible).
@@ -66,6 +66,7 @@ This library provides a wide range of mathematical functions and data structures
   - `formatBigNumber`: Intelligent formatting for massively large numbers with suffixes.
 
 - **Developer Utilities**:
+  - `randNormal`: Normal (Gaussian) distribution random number generator (Box-Muller transform).
   - `measurePerformance`: A micro-benchmarking tool for high-iteration performance testing.
   - `setSafeInterval`: A safe, asynchronous alternative to `setInterval` that prevents overlapping executions and supports immediate yielding.
   - `consumeIteratorNonBlocking`: Yield consumption macro-tasks queue resolver for heavy computations.

package/main.mjs

@@ -1,178 +1,182 @@
 
 import {
-  SetCnt
-} from './src/SetCnt.mjs'
-import {
-  Trie
-} from './src/Trie.mjs'
-import {
-  arrayHistogram
-} from './src/array-histogram.mjs'
-import {
-  fromBase64, fromBase64Url, toBase64, toBase64Url
-} from './src/base64.mjs'
+  createLangtonsAnt, createUnlimitedGrid
+} from './src/automata/langtons-ant.mjs'
 import {
-  bijective2num, bijective2numBI, num2bijective, num2bijectiveBI
-} from './src/bijective-numeration.mjs'
+  combinations, combinationsIterator
+} from './src/combinatorics/combinations.mjs'
 import {
-  binarySearchArr, binarySearchGE, binarySearchLE, binarySearchRangeIncl
-} from './src/binary-search.mjs'
+  bin2gray, gray2bin
+} from './src/combinatorics/gray-code.mjs'
 import {
-  chunks, chunksAsyncIterator, chunksIterator
-} from './src/chunks.mjs'
+  nChooseK
+} from './src/combinatorics/n-choose-k.mjs'
 import {
-  combinations, combinationsIterator
-} from './src/combinations.mjs'
+  permutations, permutationsIterator
+} from './src/combinatorics/permutations.mjs'
 import {
-  consumeIteratorNonBlocking
-} from './src/consume-iterator.mjs'
+  SetCnt
+} from './src/data-structures/SetCnt.mjs'
 import {
-  copyCase
-} from './src/copy-case.mjs'
+  Trie
+} from './src/data-structures/Trie.mjs'
 import {
-  egcd
-} from './src/egcd.mjs'
+  Heap
+} from './src/data-structures/heap.mjs'
 import {
-  factors, factorsBI
-} from './src/factors.mjs'
+  ListNode
+} from './src/data-structures/list-node.mjs'
 import {
-  formatBigNumber, formatBigNumberBI, wrapFn
-} from './src/format-big-number.mjs'
+  binarySearchArr, binarySearchGE, binarySearchLE, binarySearchRangeIncl
+} from './src/developer-utils/binary-search.mjs'
 import {
-  gcd, gcdBI
-} from './src/gcd.mjs'
+  consumeIteratorNonBlocking
+} from './src/developer-utils/consume-iterator.mjs'
 import {
   getType
-} from './src/get-type.mjs'
-import {
-  goldenRatio, goldenRatioBI, goldenRatioStr
-} from './src/golden-ratio.mjs'
-import {
-  gpn, gpnBI
-} from './src/gpn.mjs'
+} from './src/developer-utils/get-type.mjs'
 import {
-  bin2gray, gray2bin
-} from './src/gray-code.mjs'
+  measurePerformance
+} from './src/developer-utils/measure-performance.mjs'
 import {
-  Heap
-} from './src/heap.mjs'
+  memoize
+} from './src/developer-utils/memoize.mjs'
 import {
-  heronsFormula, heronsFormulaBI
-} from './src/herons-formula.mjs'
+  naturalSearch
+} from './src/developer-utils/natural-search.mjs'
 import {
-  createLangtonsAnt, createUnlimitedGrid
-} from './src/langtons-ant.mjs'
+  randNormal
+} from './src/developer-utils/rand-normal.mjs'
 import {
-  lcm, lcmBI
-} from './src/lcm.mjs'
+  array2range, range2array
+} from './src/developer-utils/range-array.mjs'
 import {
-  ListNode
-} from './src/list-node.mjs'
+  setSafeInterval
+} from './src/developer-utils/set-safe-interval.mjs'
 import {
-  lucasLehmerBI
-} from './src/lucas-lehmer.mjs'
+  barycentricCoordinates
+} from './src/geometry/barycentric.mjs'
 import {
   axisAngleToMatrix4, crossProduct, dotProduct, getRotationMatrixFromVectors, multiplyMatrix4, normalize, projectToTrackball
-} from './src/math3d.mjs'
+} from './src/geometry/math3d.mjs'
 import {
   matrixAsArray
-} from './src/matrix.mjs'
+} from './src/geometry/matrix.mjs'
 import {
-  measurePerformance
-} from './src/measure-performance.mjs'
+  egcd
+} from './src/number-theory/egcd.mjs'
 import {
-  memoize
-} from './src/memoize.mjs'
+  factors, factorsBI
+} from './src/number-theory/factors.mjs'
+import {
+  gcd, gcdBI
+} from './src/number-theory/gcd.mjs'
+import {
+  lcm, lcmBI
+} from './src/number-theory/lcm.mjs'
+import {
+  lucasLehmerBI
+} from './src/number-theory/lucas-lehmer.mjs'
 import {
   mobius, mobiusBI
-} from './src/mobius.mjs'
+} from './src/number-theory/mobius.mjs'
 import {
   mod, modBI
-} from './src/mod.mjs'
+} from './src/number-theory/mod.mjs'
 import {
-  nChooseK
-} from './src/n-choose-k.mjs'
+  phi, phiBI
+} from './src/number-theory/phi.mjs'
 import {
-  naturalSearch
-} from './src/natural-search.mjs'
+  powMod, powModBI
+} from './src/number-theory/pow-mod.mjs'
+import {
+  tonelliShanksBI
+} from './src/number-theory/tonelli-shanks.mjs'
 import {
   nelderMead
-} from './src/nelder-mead.mjs'
+} from './src/optimization/nelder-mead.mjs'
 import {
   particleSwarmOptimization
-} from './src/particle-swarm.mjs'
+} from './src/optimization/particle-swarm.mjs'
 import {
-  permutations, permutationsIterator
-} from './src/permutations.mjs'
+  simulatedAnnealing
+} from './src/optimization/simulated-annealing.mjs'
 import {
-  phi, phiBI
-} from './src/phi.mjs'
+  goldenRatio, goldenRatioBI, goldenRatioStr
+} from './src/sequences/golden-ratio.mjs'
 import {
-  powMod, powModBI
-} from './src/pow-mod.mjs'
+  gpn, gpnBI
+} from './src/sequences/gpn.mjs'
 import {
-  randNormal
-} from './src/rand-normal.mjs'
+  heronsFormula, heronsFormulaBI
+} from './src/sequences/herons-formula.mjs'
 import {
-  array2range, range2array
-} from './src/range-array.mjs'
+  squareRoot, squareRootBI
+} from './src/sequences/square-root.mjs'
 import {
-  setSafeInterval
-} from './src/set-safe-interval.mjs'
+  arrayHistogram
+} from './src/string-arrays/array-histogram.mjs'
 import {
-  simulatedAnnealing
-} from './src/simulated-annealing.mjs'
+  fromBase64, fromBase64Url, toBase64, toBase64Url
+} from './src/string-arrays/base64.mjs'
 import {
-  squareRoot, squareRootBI
-} from './src/square-root.mjs'
+  bijective2num, bijective2numBI, num2bijective, num2bijectiveBI
+} from './src/string-arrays/bijective-numeration.mjs'
 import {
-  tonelliShanksBI
-} from './src/tonelli-shanks.mjs'
+  chunks, chunksAsyncIterator, chunksIterator
+} from './src/string-arrays/chunks.mjs'
+import {
+  copyCase
+} from './src/string-arrays/copy-case.mjs'
+import {
+  formatBigNumber, formatBigNumberBI, wrapFn
+} from './src/string-arrays/format-big-number.mjs'
 
-export * from './src/SetCnt.mjs';
-export * from './src/Trie.mjs';
-export * from './src/array-histogram.mjs';
-export * from './src/base64.mjs';
-export * from './src/bijective-numeration.mjs';
-export * from './src/binary-search.mjs';
-export * from './src/chunks.mjs';
-export * from './src/combinations.mjs';
-export * from './src/consume-iterator.mjs';
-export * from './src/copy-case.mjs';
-export * from './src/egcd.mjs';
-export * from './src/factors.mjs';
-export * from './src/format-big-number.mjs';
-export * from './src/gcd.mjs';
-export * from './src/get-type.mjs';
-export * from './src/golden-ratio.mjs';
-export * from './src/gpn.mjs';
-export * from './src/gray-code.mjs';
-export * from './src/heap.mjs';
-export * from './src/herons-formula.mjs';
-export * from './src/langtons-ant.mjs';
-export * from './src/lcm.mjs';
-export * from './src/list-node.mjs';
-export * from './src/lucas-lehmer.mjs';
-export * from './src/math3d.mjs';
-export * from './src/matrix.mjs';
-export * from './src/measure-performance.mjs';
-export * from './src/memoize.mjs';
-export * from './src/mobius.mjs';
-export * from './src/mod.mjs';
-export * from './src/n-choose-k.mjs';
-export * from './src/natural-search.mjs';
-export * from './src/nelder-mead.mjs';
-export * from './src/particle-swarm.mjs';
-export * from './src/permutations.mjs';
-export * from './src/phi.mjs';
-export * from './src/pow-mod.mjs';
-export * from './src/rand-normal.mjs';
-export * from './src/range-array.mjs';
-export * from './src/set-safe-interval.mjs';
-export * from './src/simulated-annealing.mjs';
-export * from './src/square-root.mjs';
-export * from './src/tonelli-shanks.mjs';
+export * from './src/automata/langtons-ant.mjs';
+export * from './src/combinatorics/combinations.mjs';
+export * from './src/combinatorics/gray-code.mjs';
+export * from './src/combinatorics/n-choose-k.mjs';
+export * from './src/combinatorics/permutations.mjs';
+export * from './src/data-structures/SetCnt.mjs';
+export * from './src/data-structures/Trie.mjs';
+export * from './src/data-structures/heap.mjs';
+export * from './src/data-structures/list-node.mjs';
+export * from './src/developer-utils/binary-search.mjs';
+export * from './src/developer-utils/consume-iterator.mjs';
+export * from './src/developer-utils/get-type.mjs';
+export * from './src/developer-utils/measure-performance.mjs';
+export * from './src/developer-utils/memoize.mjs';
+export * from './src/developer-utils/natural-search.mjs';
+export * from './src/developer-utils/rand-normal.mjs';
+export * from './src/developer-utils/range-array.mjs';
+export * from './src/developer-utils/set-safe-interval.mjs';
+export * from './src/geometry/barycentric.mjs';
+export * from './src/geometry/math3d.mjs';
+export * from './src/geometry/matrix.mjs';
+export * from './src/number-theory/egcd.mjs';
+export * from './src/number-theory/factors.mjs';
+export * from './src/number-theory/gcd.mjs';
+export * from './src/number-theory/lcm.mjs';
+export * from './src/number-theory/lucas-lehmer.mjs';
+export * from './src/number-theory/mobius.mjs';
+export * from './src/number-theory/mod.mjs';
+export * from './src/number-theory/phi.mjs';
+export * from './src/number-theory/pow-mod.mjs';
+export * from './src/number-theory/tonelli-shanks.mjs';
+export * from './src/optimization/nelder-mead.mjs';
+export * from './src/optimization/particle-swarm.mjs';
+export * from './src/optimization/simulated-annealing.mjs';
+export * from './src/sequences/golden-ratio.mjs';
+export * from './src/sequences/gpn.mjs';
+export * from './src/sequences/herons-formula.mjs';
+export * from './src/sequences/square-root.mjs';
+export * from './src/string-arrays/array-histogram.mjs';
+export * from './src/string-arrays/base64.mjs';
+export * from './src/string-arrays/bijective-numeration.mjs';
+export * from './src/string-arrays/chunks.mjs';
+export * from './src/string-arrays/copy-case.mjs';
+export * from './src/string-arrays/format-big-number.mjs';
 
 export default [
-  SetCnt, Trie, arrayHistogram, fromBase64, fromBase64Url, toBase64, toBase64Url, bijective2num, bijective2numBI, num2bijective, num2bijectiveBI, binarySearchArr, binarySearchGE, binarySearchLE, binarySearchRangeIncl, chunks, chunksAsyncIterator, chunksIterator, combinations, combinationsIterator, consumeIteratorNonBlocking, copyCase, egcd, factors, factorsBI, formatBigNumber, formatBigNumberBI, wrapFn, gcd, gcdBI, getType, goldenRatio, goldenRatioBI, goldenRatioStr, gpn, gpnBI, bin2gray, gray2bin, Heap, heronsFormula, heronsFormulaBI, createLangtonsAnt, createUnlimitedGrid, lcm, lcmBI, ListNode, lucasLehmerBI, axisAngleToMatrix4, crossProduct, dotProduct, getRotationMatrixFromVectors, multiplyMatrix4, normalize, projectToTrackball, matrixAsArray, measurePerformance, memoize, mobius, mobiusBI, mod, modBI, nChooseK, naturalSearch, nelderMead, particleSwarmOptimization, permutations, permutationsIterator, phi, phiBI, powMod, powModBI, randNormal, array2range, range2array, setSafeInterval, simulatedAnnealing, squareRoot, squareRootBI, tonelliShanksBI
+  createLangtonsAnt, createUnlimitedGrid, combinations, combinationsIterator, bin2gray, gray2bin, nChooseK, permutations, permutationsIterator, SetCnt, Trie, Heap, ListNode, binarySearchArr, binarySearchGE, binarySearchLE, binarySearchRangeIncl, consumeIteratorNonBlocking, getType, measurePerformance, memoize, naturalSearch, randNormal, array2range, range2array, setSafeInterval, barycentricCoordinates, axisAngleToMatrix4, crossProduct, dotProduct, getRotationMatrixFromVectors, multiplyMatrix4, normalize, projectToTrackball, matrixAsArray, egcd, factors, factorsBI, gcd, gcdBI, lcm, lcmBI, lucasLehmerBI, mobius, mobiusBI, mod, modBI, phi, phiBI, powMod, powModBI, tonelliShanksBI, nelderMead, particleSwarmOptimization, simulatedAnnealing, goldenRatio, goldenRatioBI, goldenRatioStr, gpn, gpnBI, heronsFormula, heronsFormulaBI, squareRoot, squareRootBI, arrayHistogram, fromBase64, fromBase64Url, toBase64, toBase64Url, bijective2num, bijective2numBI, num2bijective, num2bijectiveBI, chunks, chunksAsyncIterator, chunksIterator, copyCase, formatBigNumber, formatBigNumberBI, wrapFn
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gkucmierz/utils",
-  "version": "3.2.0",
+  "version": "4.0.1",
   "type": "module",
   "description": "Usefull functions for solving programming tasks",
   "keywords": [
@@ -53,7 +53,11 @@
     "rand-normal",
     "format-big-number",
     "natural-search",
-    "mobius"
+    "mobius",
+    "barycentric",
+    "barycentric-coordinates",
+    "geometry",
+    "interpolation"
   ],
   "files": [
     "main.mjs",

package/src/{langtons-ant.mjs → automata/langtons-ant.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module automata
+ */
+
 /**
  * Creates an unlimited, dynamically expanding 2D grid using nested Maps.
  * Ideal for sparse matrices or algorithms operating on an infinite plane (e.g., Langton's Ant, Game of Life).

package/src/{combinations.mjs → combinatorics/combinations.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module combinatorics
+ */
+
 /**
  * Generates all possible combinations of size n from a set of size k without repetition.
  * Yields arrays of indices representing the current combination.

package/src/{gray-code.mjs → combinatorics/gray-code.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module combinatorics
+ */
+
 /**
  * Internal logic for toggling bit state based on MSB progression.
  */

package/src/{n-choose-k.mjs → combinatorics/n-choose-k.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module combinatorics
+ */
+
 /**
  * Newton's formula (Binomial Coefficient) n choose k.
  * Evaluates the number of possible combinations.

package/src/{permutations.mjs → combinatorics/permutations.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module combinatorics
+ */
+
 /**
  * Creates a permutations generator from a specified size or an array of elements.
  * 

package/src/{SetCnt.mjs → data-structures/SetCnt.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module data-structures
+ */
+
 /**
  * Set-like data structure built using Map with elements counter.
  * Allows adding multiple occurrences of the same element.

package/src/{Trie.mjs → data-structures/Trie.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module data-structures
+ */
+
 /**
  * Creates a Trie (prefix tree) data structure.
  * Implemented as a proper ES6 Class to fix prototyping documentation and encapsulate nodes.

package/src/{heap.mjs → data-structures/heap.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module data-structures
+ */
+
 /**
  * Creates a Min Heap data structure.
  * Implemented as a ES6 Class to fix prototyping documentation 

package/src/{list-node.mjs → data-structures/list-node.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module data-structures
+ */
+
 
 
 /**

package/src/{binary-search.mjs → developer-utils/binary-search.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module developer-utils
+ */
+
 
 /**
  * Performs a binary search for an exact element in a sorted array.

package/src/{consume-iterator.mjs → developer-utils/consume-iterator.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module developer-utils
+ */
+
 /**
  * Consume iterator values asynchronously utilizing macro-task queue
  * to prevent Event Loop blocking.

package/src/{get-type.mjs → developer-utils/get-type.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module developer-utils
+ */
+
 
 /**
  * Returns the type of the value as a lowercase string.

package/src/{measure-performance.mjs → developer-utils/measure-performance.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module developer-utils
+ */
+
 /**
  * Measures the execution time of a given function by running it multiple times.
  * Useful for micro-benchmarking and performance comparison.

package/src/{memoize.mjs → developer-utils/memoize.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module developer-utils
+ */
+
 
 /**
  * Creates a memoized version of a function.

package/src/{natural-search.mjs → developer-utils/natural-search.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module developer-utils
+ */
+
 /**
  * Natural Search Algorithm by gkucmierz
  * Mathematically finds the exponential boundary and binary searches bounds for a conditional function.

package/src/{rand-normal.mjs → developer-utils/rand-normal.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module developer-utils
+ */
+
 /**
  * Generates a random number from a normal (Gaussian) distribution.
  * Uses the Box-Muller transform.

package/src/{range-array.mjs → developer-utils/range-array.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module developer-utils
+ */
+
 
 // https://www.codewars.com/kata/57d83dfc950d842dcb00005b/train/javascript
 

package/src/{set-safe-interval.mjs → developer-utils/set-safe-interval.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module developer-utils
+ */
+
 /**
  * A safe alternative to setInterval that uses recursive setTimeout.
  * It waits for the callback (even if it's async) to finish before scheduling the next tick,

package/src/geometry/barycentric.mjs

@@ -0,0 +1,23 @@
+/**
+ * @module geometry
+ */
+
+/**
+ * Calculates the barycentric coordinates of a 2D point P relative to a triangle ABC.
+ * @param {Array<number>} p - Point [x, y]
+ * @param {Array<number>} a - Vertex A [x, y]
+ * @param {Array<number>} b - Vertex B [x, y]
+ * @param {Array<number>} c - Vertex C [x, y]
+ * @returns {Array<number>} [l1, l2, l3] barycentric coordinates summing to 1
+ * @see {@link https://instacode.app/run/FASwtgDg9gTgLgAgN4IEYEMYE8DGBTAOzhhBwGEpYATEA9OPAZwQF8EAzGKMBAIgAEA5gGsArjjAg8MAF4B6UXBAAbRrwDcwYBmz4iJcpRg06DRpqA|▶ Try it live in Instacode}
+ */
+export const barycentricCoordinates = (p, a, b, c) => {
+  const det = (b[1] - c[1]) * (a[0] - c[0]) + (c[0] - b[0]) * (a[1] - c[1]);
+  if (Math.abs(det) < 1e-9) {
+    return [1/3, 1/3, 1/3]; // Fallback for collinear vertices
+  }
+  const l1 = ((b[1] - c[1]) * (p[0] - c[0]) + (c[0] - b[0]) * (p[1] - c[1])) / det;
+  const l2 = ((c[1] - a[1]) * (p[0] - c[0]) + (a[0] - c[0]) * (p[1] - c[1])) / det;
+  const l3 = 1 - l1 - l2;
+  return [l1, l2, l3];
+};

package/src/{math3d.mjs → geometry/math3d.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module geometry
+ */
+
 /**
  * Pure 3D Math Engine for Arcball/Trackball raw matrix transformations
  * @see {@link https://instacode.app/run/FASwtgDg9gTgLgAgN4IMYygZ0wBQwEwFdVEBfBAMwzAQCIABAcwGtiwQBTGALwHpC4IADaZaAbmDB0WXAWJwJQA|▶ Try it live in Instacode}
@@ -65,3 +69,4 @@ export const getRotationMatrixFromVectors = (u, v) => {
   const angle = Math.acos(Math.max(-1, Math.min(1, dot)));
   return axisAngleToMatrix4(axis, angle);
 };
+

package/src/{matrix.mjs → geometry/matrix.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module geometry
+ */
+
 
 
 /**

package/src/{egcd.mjs → number-theory/egcd.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 
 /**
  * Extended Euclidean Algorithm.

package/src/{factors.mjs → number-theory/factors.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 
 /**
  * Calculates the prime factorization of a number.

package/src/{gcd.mjs → number-theory/gcd.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 
 const getGCD = ZERO => {
   return (a, b) => {

package/src/{lcm.mjs → number-theory/lcm.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 
 import {
   gcd,

package/src/{lucas-lehmer.mjs → number-theory/lucas-lehmer.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 /**
  * Calculates whether a given Mersenne number (2^p - 1) is prime using the Lucas-Lehmer primality test.
  * 

package/src/{mobius.mjs → number-theory/mobius.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 import { factors, factorsBI } from './factors.mjs';
 
 /**

package/src/{mod.mjs → number-theory/mod.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 
 const getMod = ZERO => {
   return (dividend, divisor) => {

package/src/{phi.mjs → number-theory/phi.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 
 import {
   gcd,

package/src/{pow-mod.mjs → number-theory/pow-mod.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 
 // implementation of power function with modulus like native python pow
 

package/src/{tonelli-shanks.mjs → number-theory/tonelli-shanks.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module number-theory
+ */
+
 
 import {
   powModBI,

package/src/{nelder-mead.mjs → optimization/nelder-mead.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module optimization
+ */
+
 /**
  * Nelder-Mead Simplex Algorithm (Direct Search Gradient-Free Optimization)
  * Maximizes continuous N-dimensional spaces through contraction and expansion.

package/src/{particle-swarm.mjs → optimization/particle-swarm.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module optimization
+ */
+
 /**
  * Particle Swarm Optimization (PSO)
  * A stochastic, population-based metaheuristic for maximizing complex multidimensional bounds.

package/src/{simulated-annealing.mjs → optimization/simulated-annealing.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module optimization
+ */
+
 /**
  * Simulated Annealing (Derivative-Free Stochastic Optimization)
  * Maximizes the evaluate function payload.

package/src/{golden-ratio.mjs → sequences/golden-ratio.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module sequences
+ */
+
 import { squareRootBI } from './square-root.mjs';
 
 /**

package/src/{gpn.mjs → sequences/gpn.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module sequences
+ */
+
 
 // Generalized pentagonal numbers
 // https://oeis.org/A001318

package/src/{herons-formula.mjs → sequences/herons-formula.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module sequences
+ */
+
 
 import {
   squareRootBI,

package/src/{square-root.mjs → sequences/square-root.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module sequences
+ */
+
 
 
 /**

package/src/{array-histogram.mjs → string-arrays/array-histogram.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module string-arrays
+ */
+
 /**
  * Generates a Map with unique elements and their occurring frequencies.
  * Transforms an array into a Map of (key -> quantity) using an optional mapping callback.

package/src/{base64.mjs → string-arrays/base64.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module string-arrays
+ */
+
 
 /**
  * Encodes a string to Base64.

package/src/{bijective-numeration.mjs → string-arrays/bijective-numeration.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module string-arrays
+ */
+
 
 /**
  * Converts a number to a bijective base-k string.

package/src/{chunks.mjs → string-arrays/chunks.mjs}

@@ -1,3 +1,8 @@
+/**
+ * @module string-arrays
+ * @see {@link https://instacode.app/run/FASwtgDg9gTgLgAgN4IMYAsCuA7A1gZwQF8EAzGKMBAIgAEBzXTVMEAUxgC8B6TOEADb5qAbmDAMOAmKA|▶ Try it live in Instacode}
+ */
+
 export const chunks = (input, size = 1) => {
   if (size < 1) size = 1;
   

package/src/{copy-case.mjs → string-arrays/copy-case.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module string-arrays
+ */
+
 
 /**
  * Copies the case pattern from one string to another.

package/src/{format-big-number.mjs → string-arrays/format-big-number.mjs}

@@ -1,3 +1,7 @@
+/**
+ * @module string-arrays
+ */
+
 
 /**
  * Formats a BigNumber, Number or string representation of a number