From c68eff2be1284143e3b3d3bd7a6683eabac44822 Mon Sep 17 00:00:00 2001
From: kaushal-kumar-it <techs308@gmail.com>
Date: Wed, 7 Jan 2026 10:55:41 +0530
Subject: [PATCH] feat: add cosine wave visualization to
 `simulate/iter/cosine-wave`

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---
---
 .../simulate/iter/cosine-wave/README.md       |  5 +-
 .../iter/cosine-wave/docs/img/cosine_wave.svg | 49 +++++++++++++++++++
 2 files changed, 53 insertions(+), 1 deletion(-)
 create mode 100644 lib/node_modules/@stdlib/simulate/iter/cosine-wave/docs/img/cosine_wave.svg

diff --git a/lib/node_modules/@stdlib/simulate/iter/cosine-wave/README.md b/lib/node_modules/@stdlib/simulate/iter/cosine-wave/README.md
index 694e15745790..ea9c176cee20 100644
--- a/lib/node_modules/@stdlib/simulate/iter/cosine-wave/README.md
+++ b/lib/node_modules/@stdlib/simulate/iter/cosine-wave/README.md
@@ -43,7 +43,10 @@ f(t; \tau, a, \varphi) = a \cos \frac{2\pi(t-\varphi)}{\tau}
 
 where `τ` is the period, `a` is the peak amplitude, and `φ` is the phase offset.
 
-<!-- TODO: add a figure showing a sine wave -->
+<!-- <div class="image" align="center">
+    <img src="https://cdn.jsdelivr.net/gh/stdlib-js/stdlib@39a75d78bc004d21624ab73b86c6a8f4fa47faba/lib/node_modules/@stdlib/simulate/iter/cosine-wave/docs/img/cosine_wave.svg" alt="Cosine waveform over two periods.">
+    <br>
+</div> -->
 
 </section>
 
diff --git a/lib/node_modules/@stdlib/simulate/iter/cosine-wave/docs/img/cosine_wave.svg b/lib/node_modules/@stdlib/simulate/iter/cosine-wave/docs/img/cosine_wave.svg
new file mode 100644
index 000000000000..769d92e769ee
--- /dev/null
+++ b/lib/node_modules/@stdlib/simulate/iter/cosine-wave/docs/img/cosine_wave.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="600" height="200" viewBox="0 0 600 200">
+  <defs>
+    <style>
+      .axis { stroke: #333; stroke-width: 1; }
+      .grid { stroke: #ddd; stroke-width: 0.5; stroke-dasharray: 2,2; }
+      .wave { fill: none; stroke: #0066cc; stroke-width: 2.5; }
+      .label { font-family: Arial, sans-serif; font-size: 12px; fill: #333; }
+      .caption { font-family: Arial, sans-serif; font-size: 11px; fill: #666; font-style: italic; }
+    </style>
+  </defs>
+  
+  
+  <!-- Grid lines -->
+  <line x1="40" y1="100" x2="560" y2="100" class="grid"/>
+  <line x1="40" y1="40" x2="40" y2="160" class="grid"/>
+  <line x1="302.62626262626264" y1="40" x2="302.62626262626264" y2="160" class="grid"/>
+  <line x1="565.2525252525253" y1="40" x2="565.2525252525253" y2="160" class="grid"/>
+  
+  <!-- Axes -->
+  <line x1="40" y1="40" x2="40" y2="160" class="axis"/>
+  <line x1="40" y1="160" x2="560" y2="160" class="axis"/>
+  
+  <!-- Cosine wave -->
+  <path d="M 40 40 L 45.25252525252525 40.47311792113132 L 50.505050505050505 41.885010332282135 L 55.75757575757576 44.21341084670492 L 61.01010101010101 47.421599197368195 L 66.26262626262627 51.45898033750315 L 71.51515151515152 56.26188235471531 L 76.76767676767676 61.75456061507862 L 82.02020202020202 67.8503923012602 L 87.27272727272728 74.45324250609563 L 92.52525252525253 81.45898033750315 L 97.77777777777777 88.75712112485652 L 103.03030303030303 96.2325688282412 L 108.28282828282829 103.7674311717588 L 113.53535353535354 111.24287887514349 L 118.7878787878788 118.54101966249684 L 124.04040404040404 125.54675749390435 L 129.29292929292927 132.1496076987398 L 134.54545454545456 138.24543938492138 L 139.7979797979798 143.7381176452847 L 145.05050505050505 148.54101966249684 L 150.3030303030303 152.57840080263182 L 155.55555555555554 155.7865891532951 L 160.8080808080808 158.11498966771788 L 166.06060606060606 159.52688207886865 L 171.31313131313132 160 L 176.56565656565658 159.52688207886865 L 181.8181818181818 158.11498966771785 L 187.07070707070707 155.78658915329507 L 192.32323232323233 152.57840080263182 L 197.5757575757576 148.54101966249684 L 202.82828282828285 143.7381176452847 L 208.08080808080808 138.24543938492138 L 213.33333333333331 132.14960769873977 L 218.58585858585857 125.54675749390434 L 223.83838383838383 118.54101966249682 L 229.0909090909091 111.24287887514349 L 234.34343434343435 103.7674311717588 L 239.59595959595958 96.2325688282412 L 244.84848484848484 88.75712112485651 L 250.1010101010101 81.45898033750314 L 255.35353535353536 74.45324250609562 L 260.6060606060606 67.8503923012602 L 265.8585858585859 61.75456061507862 L 271.1111111111111 56.26188235471531 L 276.3636363636364 51.45898033750315 L 281.6161616161616 47.42159919736818 L 286.86868686868684 44.2134108467049 L 292.1212121212121 41.885010332282135 L 297.3737373737374 40.47311792113133 L 302.62626262626264 40 L 307.8787878787879 40.47311792113132 L 313.13131313131316 41.885010332282135 L 318.3838383838384 44.21341084670492 L 323.6363636363636 47.421599197368195 L 328.8888888888889 51.45898033750315 L 334.14141414141415 56.26188235471531 L 339.39393939393943 61.75456061507862 L 344.64646464646466 67.8503923012602 L 349.8989898989899 74.45324250609563 L 355.1515151515152 81.45898033750315 L 360.4040404040404 88.75712112485652 L 365.6565656565657 96.2325688282412 L 370.9090909090909 103.7674311717588 L 376.16161616161617 111.24287887514349 L 381.4141414141414 118.54101966249684 L 386.66666666666663 125.54675749390435 L 391.9191919191919 132.1496076987398 L 397.17171717171715 138.24543938492138 L 402.42424242424244 143.7381176452847 L 407.67676767676767 148.54101966249684 L 412.9292929292929 152.57840080263182 L 418.1818181818182 155.7865891532951 L 423.4343434343434 158.11498966771788 L 428.6868686868687 159.52688207886865 L 433.93939393939394 160 L 439.19191919191917 159.52688207886865 L 444.44444444444446 158.11498966771785 L 449.6969696969697 155.78658915329507 L 454.949494949495 152.57840080263182 L 460.2020202020202 148.54101966249684 L 465.4545454545455 143.7381176452847 L 470.7070707070707 138.24543938492138 L 475.95959595959596 132.14960769873977 L 481.21212121212125 125.54675749390434 L 486.4646464646465 118.54101966249682 L 491.71717171717177 111.24287887514349 L 496.96969696969694 103.7674311717588 L 502.2222222222222 96.2325688282412 L 507.47474747474746 88.75712112485651 L 512.7272727272727 81.45898033750314 L 517.9797979797979 74.45324250609562 L 523.2323232323232 67.8503923012602 L 528.4848484848485 61.75456061507862 L 533.7373737373737 56.26188235471531 L 538.989898989899 51.45898033750315 L 544.2424242424242 47.42159919736818 L 549.4949494949494 44.2134108467049 L 554.7474747474748 41.885010332282135 L 560 40.47311792113133" class="wave"/>
+  
+  <!-- Axis labels -->
+  <text x="300" y="195" text-anchor="middle" class="label">Time (radians)</text>
+  <text x="15" y="100" text-anchor="middle" transform="rotate(-90 15 100)" class="label">Amplitude</text>
+  
+  <!-- X-axis tick labels (π intervals) -->
+  <text x="40" y="180" text-anchor="middle" class="label">0π</text>
+  <line x1="40" y1="160" x2="40" y2="165" class="axis"/>
+  <text x="302.62626262626264" y="180" text-anchor="middle" class="label">2π</text>
+  <line x1="302.62626262626264" y1="160" x2="302.62626262626264" y2="165" class="axis"/>
+  <text x="565.2525252525253" y="180" text-anchor="middle" class="label">4π</text>
+  <line x1="565.2525252525253" y1="160" x2="565.2525252525253" y2="165" class="axis"/>
+  
+  <!-- Y-axis tick labels -->
+  <text x="30" y="40" text-anchor="end" class="label">1</text>
+  <text x="30" y="100" text-anchor="end" class="label">0</text>
+  <text x="30" y="160" text-anchor="end" class="label">-1</text>
+  <line x1="35" y1="40" x2="40" y2="40" class="axis"/>
+  <line x1="35" y1="100" x2="40" y2="100" class="axis"/>
+  <line x1="35" y1="160" x2="40" y2="160" class="axis"/>
+  
+  <!-- Caption -->
+  <text x="300" y="20" text-anchor="middle" class="caption">Cosine waveform over two periods</text>
+</svg>