@manufosela/circle-steps

@manufosela/circle-steps

Step indicator web component with circular progress visualization

Circle Steps

Step indicator with circular progress and navigation controls.

Basic Usage

Starts in "not started" state (current=-1). Use next() to activate first step. On last step, next() marks all as complete.

Not started (current: -1)
<circle-steps id="steps"> <step-item label="Step 1"></step-item> <step-item label="Step 2"></step-item> <step-item label="Step 3"></step-item> <step-item label="Step 4"></step-item> </circle-steps> <button onclick="steps.prev()">Previous</button> <button onclick="steps.next()">Next</button> <button onclick="steps.reset()">Reset</button> <button onclick="steps.complete()">Complete All</button> <script> const steps = document.getElementById('steps'); // Listen for step changes steps.addEventListener('step-change', (e) => { console.log('New step:', e.detail.newStep); console.log('Step data:', e.detail.step); console.log('All complete?', e.detail.isComplete); console.log('Not started?', e.detail.isNotStarted); }); // Programmatic control steps.next(); // Advance (starts if current=-1) steps.prev(); // Go back steps.reset(); // Back to not started (current=-1) steps.start(); // Go to first step (current=0) steps.complete(); // Mark all complete (current=4) steps.goToStep(2); // Go to specific step </script>

All Complete State

When current equals the number of steps, all steps show as complete with checkmarks.

<!-- current="4" with 4 steps = all complete --> <circle-steps current="4"> <step-item label="Done"></step-item> <step-item label="Done"></step-item> <step-item label="Done"></step-item> <step-item label="Done"></step-item> </circle-steps>

With Labels & Descriptions

Steps with custom labels and descriptions.

<circle-steps current="1"> <step-item label="Account" description="Create your account"></step-item> <step-item label="Profile" description="Setup your profile"></step-item> <step-item label="Preferences" description="Set preferences"></step-item> <step-item label="Confirm" description="Review & submit"></step-item> </circle-steps>

Vertical Orientation

Steps displayed vertically.

<circle-steps orientation="vertical" current="1"> <step-item label="Order Placed" description="Your order has been confirmed"></step-item> <step-item label="Processing" description="We are preparing your order"></step-item> <step-item label="Shipped" description="Your order is on its way"></step-item> <step-item label="Delivered" description="Package delivered"></step-item> </circle-steps>

Clickable Steps

Click on steps to navigate. Click on the last step when active to mark all as complete. Click any step to go back.

Active: Active (index 2)
<!-- Add "clickable" attribute to enable click navigation --> <circle-steps id="wizard" clickable current="0"> <step-item label="Start"></step-item> <step-item label="Middle"></step-item> <step-item label="Almost"></step-item> <step-item label="End"></step-item> </circle-steps> <script> const wizard = document.getElementById('wizard'); // Listen for clicks on steps wizard.addEventListener('step-click', (e) => { console.log('Clicked step:', e.detail.index); console.log('Step label:', e.detail.step.label); }); // Listen for navigation changes wizard.addEventListener('step-change', (e) => { if (e.detail.isComplete) { alert('All steps completed!'); } }); </script> <!-- Behavior: - Click any step to navigate to it - Click last step (when active) to complete all - Click completed step to go back -->

Size Variants

Different sizes for different contexts.

Small

Medium (default)

Large

<circle-steps size="small">...</circle-steps> <circle-steps size="large">...</circle-steps>

Without Numbers

Show only checkmarks, no numbers.

<circle-steps current="2" hide-numbers> <step-item label="First"></step-item> <step-item label="Second"></step-item> <step-item label="Third"></step-item> <step-item label="Fourth"></step-item> </circle-steps>

Without Checkmarks

Numbers only, no checkmarks for completed steps.

<circle-steps current="2" hide-check> <step-item label="First"></step-item> <step-item label="Second"></step-item> <step-item label="Third"></step-item> <step-item label="Fourth"></step-item> </circle-steps>

Custom Styling

Theme with CSS custom properties.

<circle-steps current="2" style=" --steps-active: #8b5cf6; --steps-complete: #ec4899; --steps-line-complete: #ec4899; --steps-pending: #fce7f3; " > <step-item label="First"></step-item> <step-item label="Second"></step-item> <step-item label="Third"></step-item> <step-item label="Fourth"></step-item> </circle-steps>

Checkout Flow Example

Real-world checkout process with navigation buttons.

<circle-steps id="checkout" current="0"> <step-item label="Cart" description="Review items"></step-item> <step-item label="Shipping" description="Delivery address"></step-item> <step-item label="Payment" description="Payment method"></step-item> <step-item label="Review" description="Confirm order"></step-item> </circle-steps> <button id="backBtn" onclick="checkout.prev()">Back</button> <button id="nextBtn" onclick="checkout.next()">Continue</button> <script> const checkout = document.getElementById('checkout'); const backBtn = document.getElementById('backBtn'); const nextBtn = document.getElementById('nextBtn'); checkout.addEventListener('step-change', (e) => { // Update button states backBtn.disabled = e.detail.newStep <= 0; if (e.detail.isComplete) { nextBtn.textContent = 'Order Placed!'; nextBtn.disabled = true; // Submit order... } else if (e.detail.newStep === 3) { nextBtn.textContent = 'Place Order'; } else { nextBtn.textContent = 'Continue'; nextBtn.disabled = false; } }); </script>
Demo code (CodePen-ready HTML, CSS, JS)
HTML (html)
<h1>Circle Steps</h1>
<p class="subtitle">Step indicator with circular progress and navigation controls.</p>
<div class="demo-links">
  <a href="https://manufosela.dev/ui-components/">← Back to components</a>
  <a href="https://github.com/manufosela/ui-components/tree/main/packages/circle-steps" target="_blank" rel="noopener">GitHub Repo</a>
  <a href="playground.html">Playground</a>
  <a href="https://www.npmjs.com/package/@manufosela/circle-steps" target="_blank" rel="noopener">npm</a>
</div>
<div class="demo-theme-toggle">
  <theme-toggle theme="dark"></theme-toggle>
</div>
<div class="demo-section">
    <h2>Basic Usage</h2>
    <p>Starts in "not started" state (current=-1). Use next() to activate first step. On last step, next() marks all as complete.</p>
    <circle-steps id="basic">
      <step-item label="Step 1"></step-item>
      <step-item label="Step 2"></step-item>
      <step-item label="Step 3"></step-item>
      <step-item label="Step 4"></step-item>
    </circle-steps>
    <div class="controls">
      <button onclick="document.getElementById('basic').prev()">Previous</button>
      <button onclick="document.getElementById('basic').next()">Next</button>
      <button onclick="document.getElementById('basic').reset()">Reset</button>
      <button onclick="document.getElementById('basic').complete()">Complete All</button>
    </div>
    <div class="output" id="basicOutput">Not started (current: -1)</div>
    <div class="code-block">&lt;circle-steps id="steps"&gt;
  &lt;step-item label="Step 1"&gt;&lt;/step-item&gt;
  &lt;step-item label="Step 2"&gt;&lt;/step-item&gt;
  &lt;step-item label="Step 3"&gt;&lt;/step-item&gt;
  &lt;step-item label="Step 4"&gt;&lt;/step-item&gt;
&lt;/circle-steps&gt;

&lt;button onclick="steps.prev()"&gt;Previous&lt;/button&gt;
&lt;button onclick="steps.next()"&gt;Next&lt;/button&gt;
&lt;button onclick="steps.reset()"&gt;Reset&lt;/button&gt;
&lt;button onclick="steps.complete()"&gt;Complete All&lt;/button&gt;

&lt;script&gt;
  const steps = document.getElementById('steps');

  // Listen for step changes
  steps.addEventListener('step-change', (e) =&gt; {
    console.log('New step:', e.detail.newStep);
    console.log('Step data:', e.detail.step);
    console.log('All complete?', e.detail.isComplete);
    console.log('Not started?', e.detail.isNotStarted);
  });

  // Programmatic control
  steps.next();     // Advance (starts if current=-1)
  steps.prev();     // Go back
  steps.reset();    // Back to not started (current=-1)
  steps.start();    // Go to first step (current=0)
  steps.complete(); // Mark all complete (current=4)
  steps.goToStep(2); // Go to specific step
&lt;/script&gt;</div>
      
  </div>

  <div class="demo-section">
    <h2>All Complete State</h2>
    <p>When current equals the number of steps, all steps show as complete with checkmarks.</p>
    <circle-steps current="4">
      <step-item label="Done"></step-item>
      <step-item label="Done"></step-item>
      <step-item label="Done"></step-item>
      <step-item label="Done"></step-item>
    </circle-steps>
    <div class="code-block">&lt;!-- current="4" with 4 steps = all complete --&gt;
&lt;circle-steps current="4"&gt;
  &lt;step-item label="Done"&gt;&lt;/step-item&gt;
  &lt;step-item label="Done"&gt;&lt;/step-item&gt;
  &lt;step-item label="Done"&gt;&lt;/step-item&gt;
  &lt;step-item label="Done"&gt;&lt;/step-item&gt;
&lt;/circle-steps&gt;</div>
  </div>

  <div class="demo-section">
    <h2>With Labels & Descriptions</h2>
    <p>Steps with custom labels and descriptions.</p>
    <circle-steps current="1">
      <step-item label="Account" description="Create your account"></step-item>
      <step-item label="Profile" description="Setup your profile"></step-item>
      <step-item label="Preferences" description="Set preferences"></step-item>
      <step-item label="Confirm" description="Review & submit"></step-item>
    </circle-steps>
    <div class="code-block">&lt;circle-steps current="1"&gt;
  &lt;step-item label="Account" description="Create your account"&gt;&lt;/step-item&gt;
  &lt;step-item label="Profile" description="Setup your profile"&gt;&lt;/step-item&gt;
  &lt;step-item label="Preferences" description="Set preferences"&gt;&lt;/step-item&gt;
  &lt;step-item label="Confirm" description="Review &amp; submit"&gt;&lt;/step-item&gt;
&lt;/circle-steps&gt;</div>
  </div>

  <div class="demo-section">
    <h2>Vertical Orientation</h2>
    <p>Steps displayed vertically.</p>
    <circle-steps orientation="vertical" current="1">
      <step-item label="Order Placed" description="Your order has been confirmed"></step-item>
      <step-item label="Processing" description="We are preparing your order"></step-item>
      <step-item label="Shipped" description="Your order is on its way"></step-item>
      <step-item label="Delivered" description="Package delivered"></step-item>
    </circle-steps>
    <div class="code-block">&lt;circle-steps orientation="vertical" current="1"&gt;
  &lt;step-item label="Order Placed" description="Your order has been confirmed"&gt;&lt;/step-item&gt;
  &lt;step-item label="Processing" description="We are preparing your order"&gt;&lt;/step-item&gt;
  &lt;step-item label="Shipped" description="Your order is on its way"&gt;&lt;/step-item&gt;
  &lt;step-item label="Delivered" description="Package delivered"&gt;&lt;/step-item&gt;
&lt;/circle-steps&gt;</div>
  </div>

  <div class="demo-section">
    <h2>Clickable Steps</h2>
    <p>Click on steps to navigate. Click on the last step when active to mark all as complete. Click any step to go back.</p>
    <circle-steps id="clickable" clickable current="2">
      <step-item label="Start"></step-item>
      <step-item label="Middle"></step-item>
      <step-item label="Active"></step-item>
      <step-item label="End"></step-item>
    </circle-steps>
    <div class="controls">
      <button onclick="document.getElementById('clickable').reset()">Reset</button>
      <button onclick="document.getElementById('clickable').start()">Start</button>
    </div>
    <div class="output" id="clickableOutput">Active: Active (index 2)</div>
    <div class="code-block">&lt;!-- Add "clickable" attribute to enable click navigation --&gt;
&lt;circle-steps id="wizard" clickable current="0"&gt;
  &lt;step-item label="Start"&gt;&lt;/step-item&gt;
  &lt;step-item label="Middle"&gt;&lt;/step-item&gt;
  &lt;step-item label="Almost"&gt;&lt;/step-item&gt;
  &lt;step-item label="End"&gt;&lt;/step-item&gt;
&lt;/circle-steps&gt;

&lt;script&gt;
  const wizard = document.getElementById('wizard');

  // Listen for clicks on steps
  wizard.addEventListener('step-click', (e) =&gt; {
    console.log('Clicked step:', e.detail.index);
    console.log('Step label:', e.detail.step.label);
  });

  // Listen for navigation changes
  wizard.addEventListener('step-change', (e) =&gt; {
    if (e.detail.isComplete) {
      alert('All steps completed!');
    }
  });
&lt;/script&gt;

&lt;!-- Behavior:
  - Click any step to navigate to it
  - Click last step (when active) to complete all
  - Click completed step to go back --&gt;</div>
  </div>

  <div class="demo-section">
    <h2>Size Variants</h2>
    <p>Different sizes for different contexts.</p>
    <h3>Small</h3>
    <circle-steps size="small" current="1">
      <step-item label="One"></step-item>
      <step-item label="Two"></step-item>
      <step-item label="Three"></step-item>
      <step-item label="Four"></step-item>
    </circle-steps>
    <h3>Medium (default)</h3>
    <circle-steps current="1">
      <step-item label="One"></step-item>
      <step-item label="Two"></step-item>
      <step-item label="Three"></step-item>
      <step-item label="Four"></step-item>
    </circle-steps>
    <h3>Large</h3>
    <circle-steps size="large" current="1">
      <step-item label="One"></step-item>
      <step-item label="Two"></step-item>
      <step-item label="Three"></step-item>
      <step-item label="Four"></step-item>
    </circle-steps>
    <div class="code-block">&lt;circle-steps size="small"&gt;...&lt;/circle-steps&gt;
&lt;circle-steps size="large"&gt;...&lt;/circle-steps&gt;</div>
  </div>

  <div class="demo-section">
    <h2>Without Numbers</h2>
    <p>Show only checkmarks, no numbers.</p>
    <circle-steps current="2" hide-numbers>
      <step-item label="First"></step-item>
      <step-item label="Second"></step-item>
      <step-item label="Third"></step-item>
      <step-item label="Fourth"></step-item>
    </circle-steps>
    <div class="code-block">&lt;circle-steps current="2" hide-numbers&gt;
  &lt;step-item label="First"&gt;&lt;/step-item&gt;
  &lt;step-item label="Second"&gt;&lt;/step-item&gt;
  &lt;step-item label="Third"&gt;&lt;/step-item&gt;
  &lt;step-item label="Fourth"&gt;&lt;/step-item&gt;
&lt;/circle-steps&gt;</div>
  </div>

  <div class="demo-section">
    <h2>Without Checkmarks</h2>
    <p>Numbers only, no checkmarks for completed steps.</p>
    <circle-steps current="2" hide-check>
      <step-item label="First"></step-item>
      <step-item label="Second"></step-item>
      <step-item label="Third"></step-item>
      <step-item label="Fourth"></step-item>
    </circle-steps>
    <div class="code-block">&lt;circle-steps current="2" hide-check&gt;
  &lt;step-item label="First"&gt;&lt;/step-item&gt;
  &lt;step-item label="Second"&gt;&lt;/step-item&gt;
  &lt;step-item label="Third"&gt;&lt;/step-item&gt;
  &lt;step-item label="Fourth"&gt;&lt;/step-item&gt;
&lt;/circle-steps&gt;</div>
  </div>

  <div class="demo-section">
    <h2>Custom Styling</h2>
    <p>Theme with CSS custom properties.</p>
    <circle-steps
      current="2"
      style="
        --steps-active: #8b5cf6;
        --steps-complete: #ec4899;
        --steps-line-complete: #ec4899;
        --steps-pending: #fce7f3;
      "
    >
      <step-item label="First"></step-item>
      <step-item label="Second"></step-item>
      <step-item label="Third"></step-item>
      <step-item label="Fourth"></step-item>
    </circle-steps>
    <div class="code-block">&lt;circle-steps
  current="2"
  style="
    --steps-active: #8b5cf6;
    --steps-complete: #ec4899;
    --steps-line-complete: #ec4899;
    --steps-pending: #fce7f3;
  "
&gt;
  &lt;step-item label="First"&gt;&lt;/step-item&gt;
  &lt;step-item label="Second"&gt;&lt;/step-item&gt;
  &lt;step-item label="Third"&gt;&lt;/step-item&gt;
  &lt;step-item label="Fourth"&gt;&lt;/step-item&gt;
&lt;/circle-steps&gt;</div>
  </div>

  <div class="demo-section">
    <h2>Checkout Flow Example</h2>
    <p>Real-world checkout process with navigation buttons.</p>
    <circle-steps id="checkout" current="1">
      <step-item label="Cart" description="Review items"></step-item>
      <step-item label="Shipping" description="Delivery address"></step-item>
      <step-item label="Payment" description="Payment method"></step-item>
      <step-item label="Review" description="Confirm order"></step-item>
    </circle-steps>
    <div class="controls">
      <button onclick="document.getElementById('checkout').prev()">Back</button>
      <button onclick="document.getElementById('checkout').next()">Continue</button>
    </div>
    <div class="code-block">&lt;circle-steps id="checkout" current="0"&gt;
  &lt;step-item label="Cart" description="Review items"&gt;&lt;/step-item&gt;
  &lt;step-item label="Shipping" description="Delivery address"&gt;&lt;/step-item&gt;
  &lt;step-item label="Payment" description="Payment method"&gt;&lt;/step-item&gt;
  &lt;step-item label="Review" description="Confirm order"&gt;&lt;/step-item&gt;
&lt;/circle-steps&gt;

&lt;button id="backBtn" onclick="checkout.prev()"&gt;Back&lt;/button&gt;
&lt;button id="nextBtn" onclick="checkout.next()"&gt;Continue&lt;/button&gt;

&lt;script&gt;
  const checkout = document.getElementById('checkout');
  const backBtn = document.getElementById('backBtn');
  const nextBtn = document.getElementById('nextBtn');

  checkout.addEventListener('step-change', (e) =&gt; {
    // Update button states
    backBtn.disabled = e.detail.newStep &lt;= 0;

    if (e.detail.isComplete) {
      nextBtn.textContent = 'Order Placed!';
      nextBtn.disabled = true;
      // Submit order...
    } else if (e.detail.newStep === 3) {
      nextBtn.textContent = 'Place Order';
    } else {
      nextBtn.textContent = 'Continue';
      nextBtn.disabled = false;
    }
  });
&lt;/script&gt;</div>
  </div>
CSS (css)
:root {
  --bg: #0c0f14;
  --bg-elevated: #141923;
  --bg-panel: #171d28;
  --border: #262f3f;
  --text: #f4f6fb;
  --text-muted: #a7b0c2;
  --text-dim: #7d879b;
  --accent: #ff8a3d;
  --accent-strong: #ff6a00;
  --accent-soft: rgba(255, 138, 61, 0.16);
  --shadow: 0 20px 50px rgba(5, 8, 14, 0.45);
  --radius-lg: 22px;
  --radius-md: 14px;
  --radius-sm: 10px;
  --max-width: 1160px;
}

h1 { color: #1d1d1f; }
    .demo-section {
      background: white;
      padding: 2rem;
      border-radius: 12px;
      margin-bottom: 2rem;
      box-shadow: 0 2px 8px rgba(0,0,0,0.1);
    }
    h2 { margin-top: 0; color: #1d1d1f; }
    h3 { color: #6b7280; margin-bottom: 0.5rem; }
    p { color: #86868b; line-height: 1.6; }
    a { color: #3b82f6; }
    .code-block {
      background: #1d1d1f;
      color: #f5f5f7;
      padding: 1rem;
      border-radius: 8px;
      font-family: monospace;
      font-size: 0.8rem;
      margin-top: 1rem;
      overflow: auto;
      max-height: 300px;
      white-space: pre;
    }
    .output {
      margin-top: 1rem;
      padding: 1rem;
      background: #f5f5f7;
      border-radius: 8px;
      font-family: monospace;
    }
    .controls {
      display: flex;
      gap: 0.5rem;
      margin-top: 1rem;
    }
    .controls button {
      padding: 0.5rem 1rem;
      border: 1px solid #e5e7eb;
      border-radius: 6px;
      background: white;
      cursor: pointer;
    }
    .controls button:hover {
      background: #f3f4f6;
    }
    step-item {
      display: none;
    }
  
    footer {
      text-align: center;
      margin-top: 3rem;
      padding-top: 2rem;
      border-top: 1px solid #d2d2d7;
      color: #86868b;
      font-size: 0.9rem;
    }
    footer a { color: #1d1d1f; text-decoration: none; }
    footer a:hover { text-decoration: underline; }
  


@import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700&display=swap');

:root {
  --bg: #f5f5f7;
  --bg-2: #ffffff;
  --bg-spot-1: #f8e9d0;
  --bg-spot-2: #e8eef8;
  --card: #ffffff;
  --text: #1d1d1f;
  --muted: #6b7280;
  --line: #e5e7eb;
  --accent: #ffb000;
  --accent-2: #00a7d6;
  --accent-soft: rgba(255, 176, 0, 0.18);
  --surface-1: #f3f4f6;
  --surface-2: #eef2f7;
  --code-bg: #111827;
  --code-text: #f9fafb;
  --panel-bg: rgba(255, 255, 255, 0.85);
  --overlay-bg: rgba(255, 255, 255, 0.98);
}

:root.dark {
  --bg: #0f1117;
  --bg-2: #151a26;
  --bg-spot-1: #1a2136;
  --bg-spot-2: #1d1b34;
  --card: #1c2233;
  --text: #f3f6ff;
  --muted: #b8c0d9;
  --line: #2b3247;
  --accent: #ffb000;
  --accent-2: #00d0ff;
  --accent-soft: rgba(255, 176, 0, 0.25);
  --surface-1: #0b0f1a;
  --surface-2: #263046;
  --code-bg: #0b0f1a;
  --code-text: #d6d9e6;
  --panel-bg: rgba(28, 34, 51, 0.8);
  --overlay-bg: rgba(15, 17, 23, 0.98);
}

* {
  box-sizing: border-box;
}

a {
  color: var(--accent);
}

h1 {
  color: var(--accent);
}

.demo-links {
  margin-top: 12px;
  display: flex;
  gap: 12px;
  justify-content: center;
  flex-wrap: wrap;
}

.demo-links a {
  border: 1px solid var(--line);
  border-radius: 999px;
  padding: 6px 12px;
  color: var(--muted);
  text-decoration: none;
  font-size: 0.85rem;
  transition: border-color 0.2s ease, color 0.2s ease;
}

.demo-links a:hover {
  color: var(--text);
  border-color: var(--accent-2);
}

.demo-theme-toggle {
  margin-top: 12px;
  display: flex;
  justify-content: center;
}

header {
  border-bottom: 1px solid var(--line);
}

.demo-card,
.section,
.demo-section,
.panel,
.card {
  background: var(--card);
  border: 1px solid var(--line);
  border-radius: 16px;
  color: var(--text);
  box-shadow: 0 18px 36px rgba(6, 10, 24, 0.45);
}

.demo-card {
  display: flex;
  flex-direction: column;
  gap: 12px;
}

.demo-card .code-block {
  margin-top: auto;
}

.demo-grid,
.grid {
  align-items: stretch;
}

.demo-card h2,
.demo-card h3,
.section h2,
.demo-section h2,
.panel-header {
  color: var(--text);
}

.label,
.stat-label,
.category-title,
.subtitle,
.hint,
.note {
  color: var(--muted);
}

.info-item,
.capability,
.preference,
.option-group,
.output,
.current-url,
.event-log,
.result-card,
.log,
.stat {
  background: var(--surface-1);
  border: 1px solid var(--line);
  color: var(--text);
}

.info-item .label,
.capability .name {
  color: var(--muted);
}

.panel-header,
.options,
.topbar,
.top-links {
  background: var(--panel-bg);
  border-bottom: 1px solid var(--line);
  color: var(--text);
}

.subtitle,
.hint,
.note,
.demo-card p,
.section p,
.demo-section p {
  color: var(--muted);
}

.code-block,
pre,
code {
  background: var(--code-bg);
  color: var(--code-text);
  border-radius: 8px;
}

.value-display,
.output,
.result,
.demo-output {
  background: var(--surface-1);
  border: 1px solid var(--line);
  color: var(--text);
}

button {
  background: linear-gradient(120deg, var(--accent), #ff6a00);
  color: #111;
  border: none;
}

button:hover {
  filter: brightness(1.05);
}

input,
select,
textarea {
  background: var(--surface-1);
  color: var(--text);
  border: 1px solid var(--line);
}

footer {
  color: var(--muted);
}

footer a {
  color: var(--text);
}

arc-slider {
  --arc-slider-text-color: var(--text);
  --arc-slider-value-bg: var(--surface-1);
  --arc-slider-value-border: var(--line);
  --arc-slider-value-shadow: 0 6px 16px rgba(0, 0, 0, 0.35);
}

rich-select {
  --caller-background: var(--card);
  --caller-color: var(--text);
  --caller-border: 1px solid var(--line);
  --caller-hover-background: var(--surface-2);
  --caller-hover-color: var(--text);
  --caller-hover-border-color: var(--line);
  --caller-focus-border-color: var(--accent-2);
  --caller-focus-shadow: 0 0 0 3px rgba(0, 208, 255, 0.25);
  --caller-disabled-background: var(--surface-1);
  --caller-disabled-color: #6b7280;
  --caller-disabled-border-color: var(--line);
  --arrow-color: var(--muted);
  --selectOptions-background: var(--card);
  --selectOptions-border: 1px solid var(--line);
  --selectOptions-shadow: 0 10px 22px rgba(0, 0, 0, 0.45);
  --input-background: var(--surface-1);
  --input-border: 1px solid var(--line);
  --input-color: var(--text);
  --input-placeholder-color: #6b7280;
  --option-color: var(--text);
  --option-hover-background: var(--surface-2);
  --option-hover-color: var(--text);
  --option-active-background: var(--accent);
  --option-active-color: #111;
  --option-selected-background: var(--accent-soft);
  --option-selected-color: var(--text);
  --option-disabled-background: var(--surface-1);
  --option-disabled-color: #6b7280;
}

multi-select {
  --multi-select-bg: var(--card);
  --multi-select-border-color: var(--line);
  --multi-select-border-hover: var(--line);
  --multi-select-border-focus: var(--accent-2);
  --multi-select-text-color: var(--text);
  --multi-select-placeholder-color: #6b7280;
  --multi-select-arrow-color: var(--muted);
  --multi-select-dropdown-bg: var(--card);
  --multi-select-shadow: 0 10px 22px rgba(0, 0, 0, 0.45);
  --multi-select-option-hover-bg: var(--surface-2);
  --multi-select-option-selected-bg: var(--accent-soft);
}

tab-nav {
  --tab-bg: var(--card);
  --tab-border: var(--line);
  --tab-text: var(--muted);
  --tab-active-text: var(--text);
  --tab-hover-bg: var(--surface-2);
  --tab-active-border: var(--accent);
  --tab-disabled: #9ca3af;
}

slider-underline {
  --slider-track: var(--surface-2);
  --slider-fill: var(--accent);
  --slider-thumb: var(--accent);
  --slider-label-color: var(--text);
  --slider-tick-color: #9ca3af;
  --slider-tick-value-color: var(--muted);
}

header-nav {
  --header-bg: var(--card);
  --header-shadow: 0 12px 24px rgba(0, 0, 0, 0.2);
  --header-link-color: var(--text);
  --header-link-hover: var(--accent);
  --header-mobile-hover-bg: var(--surface-2);
}

calendar-inline {
  --calendar-bg: var(--card);
  --calendar-shadow: 0 12px 24px rgba(0, 0, 0, 0.2);
  --calendar-text: var(--text);
  --calendar-accent: var(--accent);
  --calendar-today: var(--accent-soft);
  --calendar-selected: var(--accent);
  --calendar-hover-bg: var(--surface-2);
  --calendar-muted: var(--muted);
  --calendar-muted-strong: #9ca3af;
  --calendar-other-month: #9ca3af;
  --calendar-disabled: #cbd5e1;
  --calendar-holiday: #ef4444;
  --calendar-holiday-selected: #111;
}

marked-calendar {
  --calendar-bg: var(--card);
  --calendar-border: var(--line);
  --calendar-title: var(--text);
  --calendar-muted: var(--muted);
  --calendar-surface: var(--surface-1);
  --calendar-accent: var(--accent);
  --calendar-accent-hover: #ff7a1a;
  --calendar-border-strong: var(--line);
  --calendar-contrast: #111;
  --calendar-nav-bg: var(--surface-1);
  --calendar-nav-hover: var(--surface-2);
}

radar-chart {
  --radar-bg: var(--card);
  --radar-grid-color: var(--line);
  --radar-axis-color: #94a3b8;
  --radar-label-color: var(--muted);
}

multi-carousel {
  --carousel-bg: var(--card);
  --carousel-arrow-bg: var(--surface-1);
  --carousel-arrow-color: var(--text);
  --carousel-arrow-hover-bg: var(--surface-2);
  --carousel-arrow-hover-color: var(--text);
  --carousel-nav-bg: var(--surface-1);
  --carousel-nav-color: var(--muted);
  --carousel-nav-hover: #9ca3af;
  --carousel-nav-active: var(--accent);
  --carousel-focus-color: var(--accent-2);
}

nav-list {
  --nav-list-bg: var(--card);
  --nav-list-border-color: var(--line);
  --nav-list-selected-border-color: var(--accent);
  --nav-list-selected-bg: var(--surface-2);
  --nav-list-hover-bg: var(--surface-2);
  --nav-list-selected-color: var(--text);
}

theme-toggle {
  --theme-toggle-bg: var(--card);
  --theme-toggle-icon-color: var(--muted);
  --theme-toggle-hover-bg: var(--surface-2);
  --theme-toggle-active-bg: var(--surface-1);
  --theme-toggle-active-color: var(--text);
  --theme-toggle-dark-bg: var(--card);
  --theme-toggle-dark-border: var(--line);
  --theme-toggle-dark-icon-color: var(--muted);
  --theme-toggle-dark-active-bg: var(--surface-1);
  --theme-toggle-dark-active-color: var(--text);
  --theme-toggle-dark-hover-bg: var(--surface-2);
}

qr-code {
  --qr-fg: #0f1117;
  --qr-bg: #f3f6ff;
}

click-clock {
  --clock-color: var(--text);
  --clock-bg: var(--card);
  --clock-muted-color: var(--muted);
}

historical-line {
  --title-color: var(--text);
  --border-color: var(--line);
  --year-bg: var(--surface-1);
}

circle-steps {
  --steps-muted: var(--muted);
  --steps-text: var(--text);
  --steps-pending: var(--surface-2);
}

rich-inputfile {
  --input-border: var(--line);
  --input-border-focus: var(--accent-2);
  --input-bg: var(--card);
  --input-label-color: var(--text);
  --input-hover-bg: var(--surface-2);
  --input-drag-bg: var(--accent-soft);
  --input-disabled-bg: var(--surface-1);
  --input-success-border: #22c55e;
  --input-success-bg: rgba(34, 197, 94, 0.12);
  --input-icon-color: #94a3b8;
  --input-text-color: var(--muted);
  --input-accent-color: var(--accent-2);
  --input-file-bg: var(--surface-1);
  --input-preview-bg: var(--surface-1);
  --input-file-name-color: var(--text);
  --input-file-size-color: var(--muted);
  --input-error-color: #ef4444;
  --input-hint-color: var(--muted);
}

data-card {
  --data-card-bg: var(--card);
  --data-card-border-color: var(--line);
  --data-card-title-color: var(--text);
  --data-card-desc-color: var(--muted);
  --data-card-info-bg: var(--overlay-bg);
  --data-card-info-close-bg: var(--surface-2);
  --data-card-info-close-color: var(--text);
  --data-card-info-close-hover-bg: var(--surface-1);
  --data-card-info-text: var(--text);
  --data-card-loading-color: var(--muted);
  --data-card-info-trigger-hover: var(--accent);
}

app-modal {
  --app-modal-bg: var(--card);
  --app-modal-body-color: var(--text);
  --app-modal-standalone-bg: rgba(255, 176, 0, 0.35);
  --app-modal-standalone-color: #111;
  --app-modal-standalone-hover-bg: rgba(255, 176, 0, 0.6);
}
JS (js)
document.querySelectorAll('.footer-year').forEach(el => el.textContent = new Date().getFullYear());
  

    import "https://esm.sh/@manufosela/circle-steps";

    // Basic event listener
    const basic = document.getElementById('basic');
    const basicOutput = document.getElementById('basicOutput');
    basic.addEventListener('step-change', (e) => {
      if (e.detail.isNotStarted) {
        basicOutput.textContent = `Not started (current: -1)`;
      } else if (e.detail.isComplete) {
        basicOutput.textContent = `All complete! (current: ${e.detail.newStep})`;
      } else {
        basicOutput.textContent = `Active: ${e.detail.step.label} (current: ${e.detail.newStep})`;
      }
    });

    // Clickable event listener
    const clickable = document.getElementById('clickable');
    const clickableOutput = document.getElementById('clickableOutput');
    clickable.addEventListener('step-change', (e) => {
      if (e.detail.isNotStarted) {
        clickableOutput.textContent = `Not started`;
      } else if (e.detail.isComplete) {
        clickableOutput.textContent = `All steps completed!`;
      } else {
        clickableOutput.textContent = `Active: ${e.detail.step.label} (index ${e.detail.newStep})`;
      }
    });
  

  import '../../theme-toggle/src/theme-toggle.js';

  const root = document.documentElement;
  root.classList.add('dark');

  const toggle = document.querySelector('theme-toggle');
  if (toggle) {
    toggle.theme = root.classList.contains('dark') ? 'dark' : 'light';
    toggle.addEventListener('theme-changed', (event) => {
      const theme = event.detail?.theme;
      if (!theme) return;
      root.classList.toggle('dark', theme === 'dark');
    });
  }