undirected-graph-typed 1.47.7 → 1.47.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/dist/data-structures/binary-tree/segment-tree.d.ts +6 -6
  2. package/dist/data-structures/binary-tree/segment-tree.js +7 -7
  3. package/dist/data-structures/graph/abstract-graph.d.ts +17 -17
  4. package/dist/data-structures/graph/abstract-graph.js +30 -30
  5. package/dist/data-structures/graph/directed-graph.d.ts +24 -24
  6. package/dist/data-structures/graph/directed-graph.js +28 -28
  7. package/dist/data-structures/graph/undirected-graph.d.ts +14 -14
  8. package/dist/data-structures/graph/undirected-graph.js +18 -18
  9. package/dist/data-structures/linked-list/doubly-linked-list.d.ts +28 -28
  10. package/dist/data-structures/linked-list/doubly-linked-list.js +33 -33
  11. package/dist/data-structures/linked-list/singly-linked-list.d.ts +21 -21
  12. package/dist/data-structures/linked-list/singly-linked-list.js +27 -27
  13. package/dist/data-structures/linked-list/skip-linked-list.js +4 -4
  14. package/dist/data-structures/queue/queue.d.ts +13 -13
  15. package/dist/data-structures/queue/queue.js +13 -13
  16. package/dist/data-structures/stack/stack.d.ts +6 -6
  17. package/dist/data-structures/stack/stack.js +7 -7
  18. package/dist/types/data-structures/graph/abstract-graph.d.ts +2 -2
  19. package/package.json +2 -2
  20. package/src/data-structures/binary-tree/segment-tree.ts +10 -10
  21. package/src/data-structures/graph/abstract-graph.ts +46 -46
  22. package/src/data-structures/graph/directed-graph.ts +40 -40
  23. package/src/data-structures/graph/undirected-graph.ts +26 -26
  24. package/src/data-structures/linked-list/doubly-linked-list.ts +45 -45
  25. package/src/data-structures/linked-list/singly-linked-list.ts +38 -38
  26. package/src/data-structures/linked-list/skip-linked-list.ts +4 -4
  27. package/src/data-structures/queue/queue.ts +13 -13
  28. package/src/data-structures/stack/stack.ts +9 -9
  29. package/src/types/data-structures/graph/abstract-graph.ts +2 -2
@@ -99,15 +99,15 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
99
99
  * Space Complexity: O(1)
100
100
  *
101
101
  * The `getEdge` function retrieves an edge between two vertices based on their source and destination IDs.
102
- * @param {VO | VertexKey | null} srcOrKey - The source vertex or its ID. It can be either a vertex object or a vertex ID.
103
- * @param {VO | VertexKey | null} destOrKey - The `destOrKey` parameter in the `getEdge` function represents the
104
- * destination vertex of the edge. It can be either a vertex object (`VO`), a vertex ID (`VertexKey`), or `null` if the
102
+ * @param {VO | VertexKey | undefined} srcOrKey - The source vertex or its ID. It can be either a vertex object or a vertex ID.
103
+ * @param {VO | VertexKey | undefined} destOrKey - The `destOrKey` parameter in the `getEdge` function represents the
104
+ * destination vertex of the edge. It can be either a vertex object (`VO`), a vertex ID (`VertexKey`), or `undefined` if the
105
105
  * destination is not specified.
106
- * @returns the first edge found between the source and destination vertices, or null if no such edge is found.
106
+ * @returns the first edge found between the source and destination vertices, or undefined if no such edge is found.
107
107
  */
108
108
  getEdge(srcOrKey, destOrKey) {
109
109
  let edges = [];
110
- if (srcOrKey !== null && destOrKey !== null) {
110
+ if (srcOrKey !== undefined && destOrKey !== undefined) {
111
111
  const src = this._getVertex(srcOrKey);
112
112
  const dest = this._getVertex(destOrKey);
113
113
  if (src && dest) {
@@ -117,7 +117,7 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
117
117
  }
118
118
  }
119
119
  }
120
- return edges[0] || null;
120
+ return edges[0] || undefined;
121
121
  }
122
122
  /**
123
123
  * Time Complexity: O(|E|) where |E| is the number of edges
@@ -130,14 +130,14 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
130
130
  * The function removes an edge between two vertices in a graph and returns the removed edge.
131
131
  * @param {VO | VertexKey} srcOrKey - The source vertex or its ID.
132
132
  * @param {VO | VertexKey} destOrKey - The `destOrKey` parameter represents the destination vertex or its ID.
133
- * @returns the removed edge (EO) if it exists, or null if either the source or destination vertex does not exist.
133
+ * @returns the removed edge (EO) if it exists, or undefined if either the source or destination vertex does not exist.
134
134
  */
135
135
  deleteEdgeSrcToDest(srcOrKey, destOrKey) {
136
136
  const src = this._getVertex(srcOrKey);
137
137
  const dest = this._getVertex(destOrKey);
138
- let removed = null;
138
+ let removed = undefined;
139
139
  if (!src || !dest) {
140
- return null;
140
+ return undefined;
141
141
  }
142
142
  const srcOutEdges = this._outEdgeMap.get(src);
143
143
  if (srcOutEdges) {
@@ -145,7 +145,7 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
145
145
  }
146
146
  const destInEdges = this._inEdgeMap.get(dest);
147
147
  if (destInEdges) {
148
- removed = (0, utils_1.arrayRemove)(destInEdges, (edge) => edge.src === src.key)[0] || null;
148
+ removed = (0, utils_1.arrayRemove)(destInEdges, (edge) => edge.src === src.key)[0] || undefined;
149
149
  }
150
150
  return removed;
151
151
  }
@@ -157,13 +157,13 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
157
157
  * Time Complexity: O(|E|) where |E| is the number of edges
158
158
  * Space Complexity: O(1)
159
159
  *
160
- * The function removes an edge from a graph and returns the removed edge, or null if the edge was not found.
160
+ * The function removes an edge from a graph and returns the removed edge, or undefined if the edge was not found.
161
161
  * @param {EO} edge - The `edge` parameter is an object that represents an edge in a graph. It has two properties: `src`
162
162
  * and `dest`, which represent the source and destination vertices of the edge, respectively.
163
- * @returns The method `deleteEdge` returns the removed edge (`EO`) if it exists, or `null` if the edge does not exist.
163
+ * @returns The method `deleteEdge` returns the removed edge (`EO`) if it exists, or `undefined` if the edge does not exist.
164
164
  */
165
165
  deleteEdge(edge) {
166
- let removed = null;
166
+ let removed = undefined;
167
167
  const src = this._getVertex(edge.src);
168
168
  const dest = this._getVertex(edge.dest);
169
169
  if (src && dest) {
@@ -311,9 +311,9 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
311
311
  * Time Complexity: O(1)
312
312
  * Space Complexity: O(1)
313
313
  *
314
- * The function "getEdgeSrc" returns the source vertex of an edge, or null if the edge does not exist.
314
+ * The function "getEdgeSrc" returns the source vertex of an edge, or undefined if the edge does not exist.
315
315
  * @param {EO} e - The parameter "e" is of type EO, which represents an edge in a graph.
316
- * @returns either a vertex object (VO) or null.
316
+ * @returns either a vertex object (VO) or undefined.
317
317
  */
318
318
  getEdgeSrc(e) {
319
319
  return this._getVertex(e.src);
@@ -328,7 +328,7 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
328
328
  *
329
329
  * The function "getEdgeDest" returns the destination vertex of an edge.
330
330
  * @param {EO} e - The parameter "e" is of type "EO", which represents an edge in a graph.
331
- * @returns either a vertex object of type VO or null.
331
+ * @returns either a vertex object of type VO or undefined.
332
332
  */
333
333
  getEdgeDest(e) {
334
334
  return this._getVertex(e.dest);
@@ -342,12 +342,12 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
342
342
  * Space Complexity: O(1)
343
343
  *
344
344
  * The function `getDestinations` returns an array of destination vertices connected to a given vertex.
345
- * @param {VO | VertexKey | null} vertex - The `vertex` parameter represents the starting vertex from which we want to
346
- * find the destinations. It can be either a `VO` object, a `VertexKey` value, or `null`.
345
+ * @param {VO | VertexKey | undefined} vertex - The `vertex` parameter represents the starting vertex from which we want to
346
+ * find the destinations. It can be either a `VO` object, a `VertexKey` value, or `undefined`.
347
347
  * @returns an array of vertices (VO[]).
348
348
  */
349
349
  getDestinations(vertex) {
350
- if (vertex === null) {
350
+ if (vertex === undefined) {
351
351
  return [];
352
352
  }
353
353
  const destinations = [];
@@ -369,11 +369,11 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
369
369
  * Space Complexity: O(|V|)
370
370
  *
371
371
  * The `topologicalSort` function performs a topological sort on a graph and returns an array of vertices or vertex IDs
372
- * in the sorted order, or null if the graph contains a cycle.
372
+ * in the sorted order, or undefined if the graph contains a cycle.
373
373
  * @param {'vertex' | 'key'} [propertyName] - The `propertyName` parameter is an optional parameter that specifies the
374
374
  * property to use for sorting the vertices. It can have two possible values: 'vertex' or 'key'. If 'vertex' is
375
375
  * specified, the vertices themselves will be used for sorting. If 'key' is specified, the ids of
376
- * @returns an array of vertices or vertex IDs in topological order. If there is a cycle in the graph, it returns null.
376
+ * @returns an array of vertices or vertex IDs in topological order. If there is a cycle in the graph, it returns undefined.
377
377
  */
378
378
  topologicalSort(propertyName) {
379
379
  propertyName = propertyName !== null && propertyName !== void 0 ? propertyName : 'key';
@@ -406,7 +406,7 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
406
406
  }
407
407
  }
408
408
  if (hasCycle)
409
- return null;
409
+ return undefined;
410
410
  if (propertyName === 'key')
411
411
  sorted = sorted.map(vertex => (vertex instanceof DirectedVertex ? vertex.key : vertex));
412
412
  return sorted.reverse();
@@ -449,7 +449,7 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
449
449
  const outEdges = this.outgoingEdgesOf(vertex);
450
450
  for (const outEdge of outEdges) {
451
451
  const neighbor = this._getVertex(outEdge.dest);
452
- // TODO after no-non-null-assertion not ensure the logic
452
+ // TODO after no-non-undefined-assertion not ensure the logic
453
453
  if (neighbor) {
454
454
  neighbors.push(neighbor);
455
455
  }
@@ -466,14 +466,14 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
466
466
  * Space Complexity: O(1)
467
467
  *
468
468
  * The function "getEndsOfEdge" returns the source and destination vertices of an edge if it exists in the graph,
469
- * otherwise it returns null.
469
+ * otherwise it returns undefined.
470
470
  * @param {EO} edge - The parameter `edge` is of type `EO`, which represents an edge in a graph.
471
471
  * @returns The function `getEndsOfEdge` returns an array containing two vertices `[VO, VO]` if the edge exists in the
472
- * graph. If the edge does not exist, it returns `null`.
472
+ * graph. If the edge does not exist, it returns `undefined`.
473
473
  */
474
474
  getEndsOfEdge(edge) {
475
475
  if (!this.hasEdge(edge.src, edge.dest)) {
476
- return null;
476
+ return undefined;
477
477
  }
478
478
  const v1 = this._getVertex(edge.src);
479
479
  const v2 = this._getVertex(edge.dest);
@@ -481,7 +481,7 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
481
481
  return [v1, v2];
482
482
  }
483
483
  else {
484
- return null;
484
+ return undefined;
485
485
  }
486
486
  }
487
487
  /**
@@ -504,7 +504,7 @@ class DirectedGraph extends abstract_graph_1.AbstractGraph {
504
504
  }
505
505
  const srcVertex = this._getVertex(edge.src);
506
506
  const destVertex = this._getVertex(edge.dest);
507
- // TODO after no-non-null-assertion not ensure the logic
507
+ // TODO after no-non-undefined-assertion not ensure the logic
508
508
  if (srcVertex && destVertex) {
509
509
  const srcOutEdges = this._outEdgeMap.get(srcVertex);
510
510
  if (srcOutEdges) {
@@ -61,14 +61,14 @@ export declare class UndirectedGraph<V = any, E = any, VO extends UndirectedVert
61
61
  * Time Complexity: O(|E|), where |E| is the number of edges incident to the given vertex.
62
62
  * Space Complexity: O(1)
63
63
  *
64
- * The function `getEdge` returns the first edge that connects two vertices, or null if no such edge exists.
65
- * @param {VO | VertexKey | null} v1 - The parameter `v1` represents a vertex or vertex ID. It can be of type `VO` (vertex
66
- * object), `null`, or `VertexKey` (a string or number representing the ID of a vertex).
67
- * @param {VO | VertexKey | null} v2 - The parameter `v2` represents a vertex or vertex ID. It can be of type `VO` (vertex
68
- * object), `null`, or `VertexKey` (vertex ID).
69
- * @returns an edge (EO) or null.
64
+ * The function `getEdge` returns the first edge that connects two vertices, or undefined if no such edge exists.
65
+ * @param {VO | VertexKey | undefined} v1 - The parameter `v1` represents a vertex or vertex ID. It can be of type `VO` (vertex
66
+ * object), `undefined`, or `VertexKey` (a string or number representing the ID of a vertex).
67
+ * @param {VO | VertexKey | undefined} v2 - The parameter `v2` represents a vertex or vertex ID. It can be of type `VO` (vertex
68
+ * object), `undefined`, or `VertexKey` (vertex ID).
69
+ * @returns an edge (EO) or undefined.
70
70
  */
71
- getEdge(v1: VO | VertexKey | null, v2: VO | VertexKey | null): EO | null;
71
+ getEdge(v1: VO | VertexKey | undefined, v2: VO | VertexKey | undefined): EO | undefined;
72
72
  /**
73
73
  * Time Complexity: O(|E|), where |E| is the number of edges incident to the given vertex.
74
74
  * Space Complexity: O(1)
@@ -81,9 +81,9 @@ export declare class UndirectedGraph<V = any, E = any, VO extends UndirectedVert
81
81
  * @param {VO | VertexKey} v1 - The parameter `v1` represents either a vertex object (`VO`) or a vertex ID (`VertexKey`).
82
82
  * @param {VO | VertexKey} v2 - VO | VertexKey - This parameter can be either a vertex object (VO) or a vertex ID
83
83
  * (VertexKey). It represents the second vertex of the edge that needs to be removed.
84
- * @returns the removed edge (EO) if it exists, or null if either of the vertices (VO) does not exist.
84
+ * @returns the removed edge (EO) if it exists, or undefined if either of the vertices (VO) does not exist.
85
85
  */
86
- deleteEdgeBetween(v1: VO | VertexKey, v2: VO | VertexKey): EO | null;
86
+ deleteEdgeBetween(v1: VO | VertexKey, v2: VO | VertexKey): EO | undefined;
87
87
  /**
88
88
  * Time Complexity: O(|E|), where |E| is the number of edges incident to the given vertex.
89
89
  * Space Complexity: O(1)
@@ -94,9 +94,9 @@ export declare class UndirectedGraph<V = any, E = any, VO extends UndirectedVert
94
94
  *
95
95
  * The deleteEdge function removes an edge between two vertices in a graph.
96
96
  * @param {EO} edge - The parameter "edge" is of type EO, which represents an edge in a graph.
97
- * @returns The method is returning either the removed edge (of type EO) or null if the edge was not found.
97
+ * @returns The method is returning either the removed edge (of type EO) or undefined if the edge was not found.
98
98
  */
99
- deleteEdge(edge: EO): EO | null;
99
+ deleteEdge(edge: EO): EO | undefined;
100
100
  /**
101
101
  * Time Complexity: O(1)
102
102
  * Space Complexity: O(1)
@@ -161,12 +161,12 @@ export declare class UndirectedGraph<V = any, E = any, VO extends UndirectedVert
161
161
  * Space Complexity: O(1)
162
162
  *
163
163
  * The function "getEndsOfEdge" returns the vertices at the ends of an edge if the edge exists in the graph, otherwise
164
- * it returns null.
164
+ * it returns undefined.
165
165
  * @param {EO} edge - The parameter "edge" is of type EO, which represents an edge in a graph.
166
166
  * @returns The function `getEndsOfEdge` returns an array containing two vertices `[VO, VO]` if the edge exists in the
167
- * graph. If the edge does not exist, it returns `null`.
167
+ * graph. If the edge does not exist, it returns `undefined`.
168
168
  */
169
- getEndsOfEdge(edge: EO): [VO, VO] | null;
169
+ getEndsOfEdge(edge: EO): [VO, VO] | undefined;
170
170
  /**
171
171
  * Time Complexity: O(1)
172
172
  * Space Complexity: O(1)
@@ -84,24 +84,24 @@ class UndirectedGraph extends abstract_graph_1.AbstractGraph {
84
84
  * Time Complexity: O(|E|), where |E| is the number of edges incident to the given vertex.
85
85
  * Space Complexity: O(1)
86
86
  *
87
- * The function `getEdge` returns the first edge that connects two vertices, or null if no such edge exists.
88
- * @param {VO | VertexKey | null} v1 - The parameter `v1` represents a vertex or vertex ID. It can be of type `VO` (vertex
89
- * object), `null`, or `VertexKey` (a string or number representing the ID of a vertex).
90
- * @param {VO | VertexKey | null} v2 - The parameter `v2` represents a vertex or vertex ID. It can be of type `VO` (vertex
91
- * object), `null`, or `VertexKey` (vertex ID).
92
- * @returns an edge (EO) or null.
87
+ * The function `getEdge` returns the first edge that connects two vertices, or undefined if no such edge exists.
88
+ * @param {VO | VertexKey | undefined} v1 - The parameter `v1` represents a vertex or vertex ID. It can be of type `VO` (vertex
89
+ * object), `undefined`, or `VertexKey` (a string or number representing the ID of a vertex).
90
+ * @param {VO | VertexKey | undefined} v2 - The parameter `v2` represents a vertex or vertex ID. It can be of type `VO` (vertex
91
+ * object), `undefined`, or `VertexKey` (vertex ID).
92
+ * @returns an edge (EO) or undefined.
93
93
  */
94
94
  getEdge(v1, v2) {
95
95
  var _a;
96
96
  let edges = [];
97
- if (v1 !== null && v2 !== null) {
97
+ if (v1 !== undefined && v2 !== undefined) {
98
98
  const vertex1 = this._getVertex(v1);
99
99
  const vertex2 = this._getVertex(v2);
100
100
  if (vertex1 && vertex2) {
101
101
  edges = (_a = this._edges.get(vertex1)) === null || _a === void 0 ? void 0 : _a.filter(e => e.vertices.includes(vertex2.key));
102
102
  }
103
103
  }
104
- return edges ? edges[0] || null : null;
104
+ return edges ? edges[0] || undefined : undefined;
105
105
  }
106
106
  /**
107
107
  * Time Complexity: O(|E|), where |E| is the number of edges incident to the given vertex.
@@ -115,18 +115,18 @@ class UndirectedGraph extends abstract_graph_1.AbstractGraph {
115
115
  * @param {VO | VertexKey} v1 - The parameter `v1` represents either a vertex object (`VO`) or a vertex ID (`VertexKey`).
116
116
  * @param {VO | VertexKey} v2 - VO | VertexKey - This parameter can be either a vertex object (VO) or a vertex ID
117
117
  * (VertexKey). It represents the second vertex of the edge that needs to be removed.
118
- * @returns the removed edge (EO) if it exists, or null if either of the vertices (VO) does not exist.
118
+ * @returns the removed edge (EO) if it exists, or undefined if either of the vertices (VO) does not exist.
119
119
  */
120
120
  deleteEdgeBetween(v1, v2) {
121
121
  const vertex1 = this._getVertex(v1);
122
122
  const vertex2 = this._getVertex(v2);
123
123
  if (!vertex1 || !vertex2) {
124
- return null;
124
+ return undefined;
125
125
  }
126
126
  const v1Edges = this._edges.get(vertex1);
127
- let removed = null;
127
+ let removed = undefined;
128
128
  if (v1Edges) {
129
- removed = (0, utils_1.arrayRemove)(v1Edges, (e) => e.vertices.includes(vertex2.key))[0] || null;
129
+ removed = (0, utils_1.arrayRemove)(v1Edges, (e) => e.vertices.includes(vertex2.key))[0] || undefined;
130
130
  }
131
131
  const v2Edges = this._edges.get(vertex2);
132
132
  if (v2Edges) {
@@ -144,7 +144,7 @@ class UndirectedGraph extends abstract_graph_1.AbstractGraph {
144
144
  *
145
145
  * The deleteEdge function removes an edge between two vertices in a graph.
146
146
  * @param {EO} edge - The parameter "edge" is of type EO, which represents an edge in a graph.
147
- * @returns The method is returning either the removed edge (of type EO) or null if the edge was not found.
147
+ * @returns The method is returning either the removed edge (of type EO) or undefined if the edge was not found.
148
148
  */
149
149
  deleteEdge(edge) {
150
150
  return this.deleteEdgeBetween(edge.vertices[0], edge.vertices[1]);
@@ -251,14 +251,14 @@ class UndirectedGraph extends abstract_graph_1.AbstractGraph {
251
251
  * Space Complexity: O(1)
252
252
  *
253
253
  * The function "getEndsOfEdge" returns the vertices at the ends of an edge if the edge exists in the graph, otherwise
254
- * it returns null.
254
+ * it returns undefined.
255
255
  * @param {EO} edge - The parameter "edge" is of type EO, which represents an edge in a graph.
256
256
  * @returns The function `getEndsOfEdge` returns an array containing two vertices `[VO, VO]` if the edge exists in the
257
- * graph. If the edge does not exist, it returns `null`.
257
+ * graph. If the edge does not exist, it returns `undefined`.
258
258
  */
259
259
  getEndsOfEdge(edge) {
260
260
  if (!this.hasEdge(edge.vertices[0], edge.vertices[1])) {
261
- return null;
261
+ return undefined;
262
262
  }
263
263
  const v1 = this._getVertex(edge.vertices[0]);
264
264
  const v2 = this._getVertex(edge.vertices[1]);
@@ -266,7 +266,7 @@ class UndirectedGraph extends abstract_graph_1.AbstractGraph {
266
266
  return [v1, v2];
267
267
  }
268
268
  else {
269
- return null;
269
+ return undefined;
270
270
  }
271
271
  }
272
272
  /**
@@ -284,7 +284,7 @@ class UndirectedGraph extends abstract_graph_1.AbstractGraph {
284
284
  _addEdgeOnly(edge) {
285
285
  for (const end of edge.vertices) {
286
286
  const endVertex = this._getVertex(end);
287
- if (endVertex === null)
287
+ if (endVertex === undefined)
288
288
  return false;
289
289
  if (endVertex) {
290
290
  const edges = this._edges.get(endVertex);
@@ -7,8 +7,8 @@
7
7
  */
8
8
  export declare class DoublyLinkedListNode<E = any> {
9
9
  value: E;
10
- next: DoublyLinkedListNode<E> | null;
11
- prev: DoublyLinkedListNode<E> | null;
10
+ next: DoublyLinkedListNode<E> | undefined;
11
+ prev: DoublyLinkedListNode<E> | undefined;
12
12
  /**
13
13
  * The constructor function initializes the value, next, and previous properties of an object.
14
14
  * @param {E} value - The "value" parameter is the value that will be stored in the node. It can be of any data type, as it
@@ -21,10 +21,10 @@ export declare class DoublyLinkedList<E = any> {
21
21
  * The constructor initializes the linked list with an empty head, tail, and length.
22
22
  */
23
23
  constructor(elements?: Iterable<E>);
24
- protected _head: DoublyLinkedListNode<E> | null;
25
- get head(): DoublyLinkedListNode<E> | null;
26
- protected _tail: DoublyLinkedListNode<E> | null;
27
- get tail(): DoublyLinkedListNode<E> | null;
24
+ protected _head: DoublyLinkedListNode<E> | undefined;
25
+ get head(): DoublyLinkedListNode<E> | undefined;
26
+ protected _tail: DoublyLinkedListNode<E> | undefined;
27
+ get tail(): DoublyLinkedListNode<E> | undefined;
28
28
  protected _length: number;
29
29
  get length(): number;
30
30
  get size(): number;
@@ -76,7 +76,7 @@ export declare class DoublyLinkedList<E = any> {
76
76
  *
77
77
  * The `pop()` function removes and returns the value of the last node in a doubly linked list.
78
78
  * @returns The method is returning the value of the removed node (removedNode.value) if the list is not empty. If the
79
- * list is empty, it returns null.
79
+ * list is empty, it returns undefined.
80
80
  */
81
81
  pop(): E | undefined;
82
82
  /**
@@ -89,7 +89,7 @@ export declare class DoublyLinkedList<E = any> {
89
89
  *
90
90
  * The `popLast()` function removes and returns the value of the last node in a doubly linked list.
91
91
  * @returns The method is returning the value of the removed node (removedNode.value) if the list is not empty. If the
92
- * list is empty, it returns null.
92
+ * list is empty, it returns undefined.
93
93
  */
94
94
  popLast(): E | undefined;
95
95
  /**
@@ -152,8 +152,8 @@ export declare class DoublyLinkedList<E = any> {
152
152
  * Time Complexity: O(n), where n is the number of elements in the linked list.
153
153
  * Space Complexity: O(1)
154
154
  *
155
- * The `getFirst` function returns the first node in a doubly linked list, or null if the list is empty.
156
- * @returns The method `getFirst()` returns the first node of the doubly linked list, or `null` if the list is empty.
155
+ * The `getFirst` function returns the first node in a doubly linked list, or undefined if the list is empty.
156
+ * @returns The method `getFirst()` returns the first node of the doubly linked list, or `undefined` if the list is empty.
157
157
  */
158
158
  getFirst(): E | undefined;
159
159
  /**
@@ -164,8 +164,8 @@ export declare class DoublyLinkedList<E = any> {
164
164
  * Time Complexity: O(n), where n is the number of elements in the linked list.
165
165
  * Space Complexity: O(1)
166
166
  *
167
- * The `getLast` function returns the last node in a doubly linked list, or null if the list is empty.
168
- * @returns The method `getLast()` returns the last node of the doubly linked list, or `null` if the list is empty.
167
+ * The `getLast` function returns the last node in a doubly linked list, or undefined if the list is empty.
168
+ * @returns The method `getLast()` returns the last node of the doubly linked list, or `undefined` if the list is empty.
169
169
  */
170
170
  getLast(): E | undefined;
171
171
  /**
@@ -176,11 +176,11 @@ export declare class DoublyLinkedList<E = any> {
176
176
  * Time Complexity: O(n), where n is the number of elements in the linked list.
177
177
  * Space Complexity: O(1)
178
178
  *
179
- * The `getAt` function returns the value at a specified index in a linked list, or null if the index is out of bounds.
179
+ * The `getAt` function returns the value at a specified index in a linked list, or undefined if the index is out of bounds.
180
180
  * @param {number} index - The index parameter is a number that represents the position of the element we want to
181
181
  * retrieve from the list.
182
182
  * @returns The method is returning the value at the specified index in the linked list. If the index is out of bounds
183
- * or the linked list is empty, it will return null.
183
+ * or the linked list is empty, it will return undefined.
184
184
  */
185
185
  getAt(index: number): E | undefined;
186
186
  /**
@@ -191,14 +191,14 @@ export declare class DoublyLinkedList<E = any> {
191
191
  * Time Complexity: O(n), where n is the number of elements in the linked list.
192
192
  * Space Complexity: O(1)
193
193
  *
194
- * The function `getNodeAt` returns the node at a given index in a doubly linked list, or null if the index is out of
194
+ * The function `getNodeAt` returns the node at a given index in a doubly linked list, or undefined if the index is out of
195
195
  * range.
196
196
  * @param {number} index - The `index` parameter is a number that represents the position of the node we want to
197
197
  * retrieve from the doubly linked list. It indicates the zero-based index of the node we want to access.
198
198
  * @returns The method `getNodeAt(index: number)` returns a `DoublyLinkedListNode<E>` object if the index is within the
199
- * valid range of the linked list, otherwise it returns `null`.
199
+ * valid range of the linked list, otherwise it returns `undefined`.
200
200
  */
201
- getNodeAt(index: number): DoublyLinkedListNode<E> | null;
201
+ getNodeAt(index: number): DoublyLinkedListNode<E> | undefined;
202
202
  /**
203
203
  * Time Complexity: O(n), where n is the number of elements in the linked list.
204
204
  * Space Complexity: O(1)
@@ -208,12 +208,12 @@ export declare class DoublyLinkedList<E = any> {
208
208
  * Space Complexity: O(1)
209
209
  *
210
210
  * The function `findNodeByValue` searches for a node with a specific value in a doubly linked list and returns the
211
- * node if found, otherwise it returns null.
211
+ * node if found, otherwise it returns undefined.
212
212
  * @param {E} value - The `value` parameter is the value that we want to search for in the doubly linked list.
213
213
  * @returns The function `findNodeByValue` returns a `DoublyLinkedListNode<E>` if a node with the specified value `value`
214
- * is found in the linked list. If no such node is found, it returns `null`.
214
+ * is found in the linked list. If no such node is found, it returns `undefined`.
215
215
  */
216
- getNode(value: E | null): DoublyLinkedListNode<E> | null;
216
+ getNode(value: E | undefined): DoublyLinkedListNode<E> | undefined;
217
217
  /**
218
218
  * Time Complexity: O(n), where n is the number of elements in the linked list.
219
219
  * Space Complexity: O(1)
@@ -277,7 +277,7 @@ export declare class DoublyLinkedList<E = any> {
277
277
  * The `deleteAt` function removes an element at a specified index from a linked list and returns the removed element.
278
278
  * @param {number} index - The index parameter represents the position of the element that needs to be deleted in the
279
279
  * data structure. It is of type number.
280
- * @returns The method `deleteAt` returns the value of the node that was deleted, or `null` if the index is out of
280
+ * @returns The method `deleteAt` returns the value of the node that was deleted, or `undefined` if the index is out of
281
281
  * bounds.
282
282
  */
283
283
  deleteAt(index: number): E | undefined;
@@ -295,14 +295,14 @@ export declare class DoublyLinkedList<E = any> {
295
295
  * @returns The `delete` method returns a boolean value. It returns `true` if the value or node was successfully
296
296
  * deleted from the doubly linked list, and `false` if the value or node was not found in the list.
297
297
  */
298
- delete(valOrNode: E | DoublyLinkedListNode<E> | null): boolean;
298
+ delete(valOrNode: E | DoublyLinkedListNode<E> | undefined): boolean;
299
299
  /**
300
300
  * The function checks if a variable has a length greater than zero and returns a boolean value.
301
301
  * @returns A boolean value is being returned.
302
302
  */
303
303
  isEmpty(): boolean;
304
304
  /**
305
- * The `clear` function resets the linked list by setting the head, tail, and length to null and 0 respectively.
305
+ * The `clear` function resets the linked list by setting the head, tail, and length to undefined and 0 respectively.
306
306
  */
307
307
  clear(): void;
308
308
  /**
@@ -317,9 +317,9 @@ export declare class DoublyLinkedList<E = any> {
317
317
  * @param callback - A function that takes a value of type E as its parameter and returns a boolean value. This
318
318
  * function is used to determine whether a particular value in the linked list satisfies a certain condition.
319
319
  * @returns The method `find` returns the first element in the linked list that satisfies the condition specified by
320
- * the callback function. If no element satisfies the condition, it returns `null`.
320
+ * the callback function. If no element satisfies the condition, it returns `undefined`.
321
321
  */
322
- find(callback: (value: E) => boolean): E | null;
322
+ find(callback: (value: E) => boolean): E | undefined;
323
323
  /**
324
324
  * Time Complexity: O(n), where n is the number of elements in the linked list.
325
325
  * Space Complexity: O(1)
@@ -344,13 +344,13 @@ export declare class DoublyLinkedList<E = any> {
344
344
  * Space Complexity: O(1)
345
345
  *
346
346
  * The `findBackward` function iterates through a linked list from the last node to the first node and returns the last
347
- * value that satisfies the given callback function, or null if no value satisfies the callback.
347
+ * value that satisfies the given callback function, or undefined if no value satisfies the callback.
348
348
  * @param callback - A function that takes a value of type E as its parameter and returns a boolean value. This
349
349
  * function is used to determine whether a given value satisfies a certain condition.
350
350
  * @returns The method `findBackward` returns the last value in the linked list that satisfies the condition specified by
351
- * the callback function. If no value satisfies the condition, it returns `null`.
351
+ * the callback function. If no value satisfies the condition, it returns `undefined`.
352
352
  */
353
- findBackward(callback: (value: E) => boolean): E | null;
353
+ findBackward(callback: (value: E) => boolean): E | undefined;
354
354
  /**
355
355
  * Time Complexity: O(n), where n is the number of elements in the linked list.
356
356
  * Space Complexity: O(1)