docs: improve scope in code comments

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

diff --git a/src/circular-array.ts b/src/circular-array.ts
index bb958d8287519acf91efc4c7a1468fe422da0a86..9cea08bcdd7f09463a2e7eeab323483b1ee676cc 100644 (file)
--- a/src/circular-array.ts
+++ b/src/circular-array.ts
@@ -4,6 +4,8 @@ const DEFAULT_CIRCULAR_ARRAY_SIZE = 1024
 
 /**
  * Array with a maximum length and shifting items when full.
+ *
+ * @internal
  */
 export class CircularArray<T> extends Array<T> {
   public size: number

diff --git a/src/deque.ts b/src/deque.ts
index 42f9953d5e4f4d926e4e09d31340a6f0f56a0319..9be270ffa8d6f2e95f1d045b07459d595576d30a 100644 (file)
--- a/src/deque.ts
+++ b/src/deque.ts
@@ -1,5 +1,8 @@
 // Copyright Jerome Benoit. 2023. All Rights Reserved.
 
+/**
+ * @internal
+ */
 export class Node<T> {
   public value: T
   public next?: Node<T>
@@ -15,6 +18,7 @@ export class Node<T> {
  * Implemented with a doubly linked list.
  *
  * @typeParam T - Type of deque values.
+ * @internal
  */
 export class Deque<T> {
   private head?: Node<T>

diff --git a/src/utils.ts b/src/utils.ts
index 6f9d1226bb71210b020d987b32d169bbd593b5b8..77f889c9b417ad008b0352b8c2e1779788ceb6d9 100644 (file)
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -44,6 +44,7 @@ export const DEFAULT_MEASUREMENT_STATISTICS_REQUIREMENTS: MeasurementStatisticsR
  * Always returns a value greater than zero.
  *
  * @returns The host OS optimized maximum pool size.
+ * @internal
  */
 export const availableParallelism = (): number => {
   let availableParallelism = 1
@@ -64,6 +65,7 @@ export const availableParallelism = (): number => {
 //  * @param retryNumber - The number of retries that have already been attempted
 //  * @param maxDelayRatio - The maximum ratio of the delay that can be randomized
 //  * @returns Delay in milliseconds
+//  * @internal
 //  */
 // export const exponentialDelay = (
 //   retryNumber = 0,
@@ -79,6 +81,7 @@ export const availableParallelism = (): number => {
  *
  * @param dataSet - Data set.
  * @returns The median of the given data set.
+ * @internal
  */
 export const median = (dataSet: number[]): number => {
   if (Array.isArray(dataSet) && dataSet.length === 0) {
@@ -127,6 +130,7 @@ export const isPlainObject = (obj: unknown): boolean =>
  * @param killBehavior - Which kind of kill behavior to detect.
  * @param value - Any value.
  * @returns `true` if `value` was strictly equals to `killBehavior`, otherwise `false`.
+ * @internal
  */
 export const isKillBehavior = <KB extends KillBehavior>(
   killBehavior: KB,
@@ -154,6 +158,7 @@ export const isAsyncFunction = (
  * @param measurementRequirements - The measurement statistics requirements.
  * @param measurementValue - The measurement value.
  * @param numberOfMeasurements - The number of measurements.
+ * @internal
  */
 export const updateMeasurementStatistics = (
   measurementStatistics: MeasurementStatistics,