singly-linked-list-typed 2.4.5 → 2.5.0

package/README.md

@@ -34,79 +34,6 @@ yarn add singly-linked-list-typed
 
 [//]: # (No deletion!!! Start of Example Replace Section)
 
-### basic SinglyLinkedList creation and push operation
-```typescript
- // Create a simple SinglyLinkedList with initial values
-    const list = new SinglyLinkedList([1, 2, 3, 4, 5]);
-
-    // Verify the list maintains insertion order
-    console.log([...list]); // [1, 2, 3, 4, 5];
-
-    // Check length
-    console.log(list.length); // 5;
-
-    // Push a new element to the end
-    list.push(6);
-    console.log(list.length); // 6;
-    console.log([...list]); // [1, 2, 3, 4, 5, 6];
-```
-
-### SinglyLinkedList pop and shift operations
-```typescript
- const list = new SinglyLinkedList<number>([10, 20, 30, 40, 50]);
-
-    // Pop removes from the end
-    const last = list.pop();
-    console.log(last); // 50;
-
-    // Shift removes from the beginning
-    const first = list.shift();
-    console.log(first); // 10;
-
-    // Verify remaining elements
-    console.log([...list]); // [20, 30, 40];
-    console.log(list.length); // 3;
-```
-
-### SinglyLinkedList unshift and forward traversal
-```typescript
- const list = new SinglyLinkedList<number>([20, 30, 40]);
-
-    // Unshift adds to the beginning
-    list.unshift(10);
-    console.log([...list]); // [10, 20, 30, 40];
-
-    // Access elements (forward traversal only for singly linked)
-    const second = list.at(1);
-    console.log(second); // 20;
-
-    // SinglyLinkedList allows forward iteration only
-    const elements: number[] = [];
-    for (const item of list) {
-      elements.push(item);
-    }
-    console.log(elements); // [10, 20, 30, 40];
-
-    console.log(list.length); // 4;
-```
-
-### SinglyLinkedList filter and map operations
-```typescript
- const list = new SinglyLinkedList<number>([1, 2, 3, 4, 5]);
-
-    // Filter even numbers
-    const filtered = list.filter(value => value % 2 === 0);
-    console.log(filtered.length); // 2;
-
-    // Map to double values
-    const doubled = list.map(value => value * 2);
-    console.log(doubled.length); // 5;
-
-    // Use reduce to sum
-    const sum = list.reduce((acc, value) => acc + value, 0);
-    console.log(sum); // 15;
-```
-
 ### SinglyLinkedList for sequentially processed data stream
 ```typescript
  interface LogEntry {
@@ -228,6 +155,21 @@ yarn add singly-linked-list-typed
     console.log(editor.getText()); // 'Haello';
 ```
 
+### Find first matching element
+```typescript
+ const list = new SinglyLinkedList<number>([1, 2, 3, 4, 5]);
+    console.log(list.find(n => n > 3)); // 4;
+    console.log(list.find(n => n > 10)); // undefined;
+```
+
+### Iterate over elements
+```typescript
+ const list = new SinglyLinkedList<number>([10, 20, 30]);
+    const result: number[] = [];
+    list.forEach(n => result.push(n));
+    console.log(result); // [10, 20, 30];
+```
+
 [//]: # (No deletion!!! End of Example Replace Section)