1.6.0

changelog.md

@@ -1,5 +1,107 @@
 # Changelog
 
+## 2025-01-22 - 1.6.0 - feat(elements)
+Enhance theme handling and CSS organization for consent component
+
+- Introduced theme-specific CSS variables for better theming support in consentsoftware-cookieconsent.
+- Reorganized styles in consentsoftware-cookieconsent for cleaner look and consistency.
+- Added media queries for responsive design in consentsoftware-tabs.
+
+## 2025-01-21 - 1.5.4 - fix(consentsoftware-components)
+Add interactive consent software components for managing cookie levels.
+
+- Implemented 'consentsoftware-cookieconsent' component for cookie management
+- Introduced 'consentsoftware-toggle' for user interaction improvements
+- Added theme support for light/dark modes in consent components
+- Enhanced consent interface with responsive design and accessibility features
+
+## 2025-01-20 - 1.5.3 - fix(consentsoftware-cookieconsent)
+Fix visual inconsistencies in the consent software modal overlay and shadow.
+
+- Updated the shadow color in the modal box to use a consistent color.
+- Restored backdrop blur effect in the page overlay when visible.
+
+## 2025-01-20 - 1.5.2 - fix(core)
+No changes detected
+
+
+## 2025-01-20 - 1.5.1 - fix(consentsoftware-cookieconsent)
+Adjusted shake animation duration and box-shadow for modalBox in consent cookie component.
+
+- Changed the box-shadow to be softer with reduced spread for more subtle visual effect.
+- Increased the duration of shake animation from 300ms to 2000ms for enhanced user feedback upon overlay interaction.
+
+## 2025-01-20 - 1.5.0 - feat(consentsoftware-cookieconsent)
+Enhance consent modal with shake animation on overlay click
+
+- Added shake animation to the modal and overlay when clicked outside the modal.
+- Updated dependency @consent.software/interfaces to version ^1.0.14.
+
+## 2025-01-17 - 1.4.5 - fix(elements)
+Fix issues in consentsoftware-cookieconsent component
+
+- Removed unused attribute handling for 'gotIt'.
+- Fixed background and backdrop-filter transitions to ensure proper UI behavior.
+- Consolidated consent button click handling into handleConsentButtonClick.
+- Improved modal visibility toggling and acceptance flow.
+
+## 2025-01-17 - 1.4.4 - fix(core)
+Update LitElement properties to use accessors
+
+- Changes made in ts_web/elements/consentsoftware-toggle.ts
+- Updated properties 'required' and 'selected' to use accessors
+
+## 2025-01-17 - 1.4.3 - fix(consentsoftware-cookieconsent)
+Fix transition property in consent button styles and add HTMLElementTagNameMap declaration for global interface.
+
+- Updated the transition property for consent buttons to transition all properties instead of just the background.
+- Added global interface HTMLElementTagNameMap for custom element type support.
+
+## 2025-01-16 - 1.4.2 - fix(cookieconsent)
+Fix user-select property in consentsoftware-cookieconsent component for consistency in interaction.
+
+
+## 2025-01-16 - 1.4.1 - fix(consentsoftware-toggle)
+Fix issue in drag event handling logic for the toggle component.
+
+- Corrected dragging functionality to accurately track dragging state.
+- Included logic to delay the reset of the dragging state after toggling.
+
+## 2025-01-16 - 1.4.0 - feat(toggle component)
+Enhanced consent toggle component with drag functionality
+
+- Implemented drag functionality for the toggle knob.
+- Added smooth transitions for the toggle knob movement.
+- Handled drag state management to differentiate between actual click and drag.
+- Improved user interaction by allowing click anywhere in the toggle area.
+
+## 2025-01-16 - 1.3.5 - fix(elements)
+Improved styling consistency across several components
+
+- Increased box-shadow intensity for better visual separation
+- Changed border-bottom styles to use dotted lines for consistency
+- Adjusted line-height for better vertical spacing
+- Fixed border-right gradient on itemBox for better styling
+
+## 2025-01-14 - 1.3.4 - fix(dependencies)
+Corrected build script and updated @consent.software/webclient dependency version
+
+- Corrected the build script entry in package.json.
+- Updated @consent.software/webclient dependency to version ^1.1.0.
+
+## 2025-01-14 - 1.3.3 - fix(package.json)
+Fixed incorrect main and typings fields, replacing with exports field
+
+- Updated package.json to use the 'exports' field instead of 'main' and 'typings' for module entry points
+
+## 2025-01-14 - 1.3.2 - fix(core)
+No code changes detected, maintain current state.
+
+
+## 2025-01-14 - 1.3.1 - fix(package setup)
+Fix package metadata and dependency consistency
+
+
 ## 2025-01-14 - 1.3.0 - feat(elements)
 Enhance consent management components with advanced styling and interaction
 

package.json

@@ -1,21 +1,22 @@
 {
   "name": "@consent.software/catalog",
-  "version": "1.3.0",
+  "version": "1.6.0",
   "private": false,
   "description": "A library of web components designed to integrate robust consent management capabilities into web applications, ensuring compliance with privacy regulations.",
-  "main": "dist_ts_web/index.js",
+  "exports": {
-  "typings": "dist_ts_web/index.d.ts",
+    ".": "./dist_ts_web/index.js"
+  },
   "type": "module",
   "scripts": {
     "test": "npm run build",
-    "build": "tsbuild element --allowimplicitany && tsbundle element --production",
+    "build": "tsbuild tsfolders --allowimplicitany && tsbundle element --production",
     "watch": "tswatch element"
   },
   "author": "Lossless GmbH",
   "license": "MIT",
   "dependencies": {
-    "@consent.software/interfaces": "^1.0.11",
+    "@consent.software/interfaces": "^1.0.14",
-    "@consent.software/webclient": "^1.0.14",
+    "@consent.software/webclient": "^1.1.0",
     "@push.rocks/smartdelay": "^3.0.5",
     "lit": "^3.2.1"
   },

ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@consent.software/catalog',
-  version: '1.3.0',
+  version: '1.6.0',
   description: 'A library of web components designed to integrate robust consent management capabilities into web applications, ensuring compliance with privacy regulations.'
 }

ts_web/elements/consentsoftware-cookieconsent.ts

@@ -8,6 +8,12 @@ import * as csInterfaces from '@consent.software/interfaces';
 import * as csWebclient from '@consent.software/webclient';
 import { delayFor } from '@push.rocks/smartdelay';
 
+declare global {
+  interface HTMLElementTagNameMap {
+    'consentsoftware-cookieconsent': ConsentsoftwareCookieconsent;
+  }
+}
+
 @customElement('consentsoftware-cookieconsent')
 export class ConsentsoftwareCookieconsent extends LitElement {
   public static demo = () => html`<consentsoftware-cookieconsent></consentsoftware-cookieconsent>`;
@@ -15,17 +21,20 @@ export class ConsentsoftwareCookieconsent extends LitElement {
   public csWebclientInstance = new csWebclient.CsWebclient();
   public csWebclientRan = false;
 
+  // Reflects the current theme ('light' or 'dark')
   @property({ type: String, reflect: true })
   public theme: 'light' | 'dark' = 'light';
 
   /**
-   * We bind `heightPixels` to a CSS variable (--cookieconsent-height).
+   * Define component styles with CSS variables that adjust based on theme.
-   * Then we can do margin-bottom animations in CSS.
+   * The default variables serve as baseline for the light theme.
+   * Theme-specific overrides modify these for dark mode.
    */
   public static styles = css`
     :host {
       font-family: ${shared.fontStack};
-      /* Default theme variables */
+      user-select: none;
+      /* Default variables for Light Theme */
       --text-color: #333;
       --background-color: #eeeeee;
       --accent-color: #333333;
@@ -34,8 +43,14 @@ export class ConsentsoftwareCookieconsent extends LitElement {
       --icon-color: #4496f5;
       --link-color: #333;
       --padding-sides: 16px;
+      /* Additional variables for modal and info container styling */
+      --info-bg: rgba(0, 0, 0, 0.1);
+      --info-text: rgba(255, 255, 255, 0.5);
+      --modal-box-shadow: 0px 0px 8px rgba(0, 0, 0, 0.2);
     }
 
+    /* Dark Theme Overrides:
+       When theme attribute is 'dark', override variables accordingly. */
     :host([theme='dark']) {
       --text-color: #fff;
       --background-color: #111;
@@ -44,8 +59,14 @@ export class ConsentsoftwareCookieconsent extends LitElement {
       --button-hover-bg: #222222;
       --icon-color: #4496f5;
       --link-color: #fff;
+      --info-bg: rgba(0, 0, 0, 0.1);
+      --info-text: rgba(255, 255, 255, 0.5);
+      --modal-box-shadow: 0px 0px 8px rgba(255, 255, 255, 0.6);
     }
 
+    /* Light Theme Overrides:
+       Explicit light theme settings, currently matching defaults.
+       Can be customized independently if desired. */
     :host([theme='light']) {
       --text-color: #333;
       --background-color: #eeeeee;
@@ -54,49 +75,79 @@ export class ConsentsoftwareCookieconsent extends LitElement {
       --button-hover-bg: #f2f2f2;
       --icon-color: #4496f5;
       --link-color: #333;
+      --info-bg: rgba(0, 0, 0, 0.1);
+      --info-text: rgba(0, 0, 0, 0.5);
+      --modal-box-shadow: 0px 0px 8px rgba(0, 0, 0, 0.2);
     }
 
+    /* Overlay covering the page behind the modal */
     .pageOverlay {
       position: fixed;
-      top: 0px;
+      top: 0;
-      bottom: 0px;
+      bottom: 0;
-      right: 0px;
+      right: 0;
-      left: 0px;
+      left: 0;
       display: grid;
       align-items: center;
       justify-content: center;
-      z-index: 1000; /* standard z-index for fixed elements */
+      z-index: 1000; /* Ensures the overlay is on top of other elements */
-      background: rgba(0, 0, 0, 0);
+      background: rgba(255, 255, 255, 0);
       backdrop-filter: blur(0px);
       transition: all 0.2s;
     }
 
+    /* Shake animation for overlay when clicked */
+    .pageOverlay.shake {
+      background: rgba(0, 0, 0, 0.5) !important;
+    }
+
+    /* Modal box styling using theme variables for colors and shadows */
     .modalBox {
       display: block;
       color: var(--text-color);
       background: var(--background-color);
-      box-shadow: 0px 0px 15px rgba(0, 0, 0, 0.4);
+      box-shadow: var(--modal-box-shadow);
-      position: realtive;
+      position: relative;
+      border: 1px dotted rgba(255, 255, 255, 0.1);
       border-top: 1px solid var(--accent-color);
       border-radius: 16px;
       max-width: 1100px;
       min-width: calc(100vw / 3);
       box-sizing: border-box;
       overflow: hidden;
-      /* 
+      will-change: transform;
-       * We start with margin-bottom as negative to hide the banner.
-       * The animation occurs when we toggle the gotIt/show attributes.
-       */
-      will-change: transform; /* ensure efficient rendering */
       transition: all 0.3s;
       transform: scale(0.95);
       opacity: 0;
     }
 
-    /* 
+    /* Media query for mobile devices: stack buttons vertically */
-     * Toggle display based on [show] attribute 
+    @media (max-width: 600px) {
-     * (so if show=false, the banner doesn't show at all).
+      .modalBox {
-     */
+        height: 100vh;
+        box-shadow: none;
+        border-radius: 0px;
+      }
+    }
+
+    /* Shake animation for modal box */
+    .modalBox.shake {
+      animation: shake 150ms 2 linear;
+    }
+
+    @keyframes shake {
+      0% {
+        transform: translate(3px, 0);
+      }
+      50% {
+        transform: translate(-3px, 0);
+      }
+      100% {
+        transform: translate(0, 0);
+      }
+    }
+
+    /* Toggle display based on [show] attribute */
     :host([show='false']) {
       display: none;
     }
@@ -104,18 +155,6 @@ export class ConsentsoftwareCookieconsent extends LitElement {
       display: block;
     }
 
-    /* 
-     * Animate margin-bottom when [gotIt] toggles.
-     * If gotIt=true, push the banner down off-screen.
-     * If gotIt=false, pull the banner into view.
-     */
-    :host([gotIt='true']) {
-      background: blue;
-    }
-    :host([gotIt='false']) {
-      background: red;
-    }
-
     .content {
       margin: auto;
     }
@@ -139,14 +178,37 @@ export class ConsentsoftwareCookieconsent extends LitElement {
       gap: 16px;
     }
 
-    .info-container {
+    /* Media query for mobile devices: stack buttons vertically */
-      color: var(--text-color);
+    @media (max-width: 600px) {
+      .button-container {
+        grid-template-columns: 1fr;
+      }
+    }
+
+    /* Consent button styling using theme variables */
+    .consent-button {
+      border-radius: 3px;
+      background: var(--button-bg);
+      box-shadow: 0px 0px 5px rgba(0, 0, 0, 0.2);
+      padding: 10px;
+      line-height: 30px;
       text-align: center;
-      line-height: 2em;
+      cursor: pointer;
-      background: rgba(0, 0, 0, 0.1);
+      transition: all 0.2s;
-      border-top: 1px solid rgba(255, 255, 255, 0.1);
+    }
+
+    .consent-button:hover {
+      background: var(--button-hover-bg);
+    }
+
+    /* Use theme variables for info container background and text */
+    .info-container {
+      text-align: center;
+      line-height: 3em;
+      background: var(--info-bg);
+      border-top: 1px dotted rgba(255, 255, 255, 0.1);
       font-size: 0.8em;
-      color: rgba(255, 255, 255, 0.5);
+      color: var(--info-text);
     }
 
     .info-container a {
@@ -157,32 +219,17 @@ export class ConsentsoftwareCookieconsent extends LitElement {
     .info-container a:hover {
       color: #ffffff;
     }
-
-    .consent-button {
-      border-radius: 3px;
-      background: var(--button-bg);
-      box-shadow: 0px 0px 5px rgba(0, 0, 0, 0.2);
-      padding: 10px;
-      line-height: 30px;
-      text-align: center;
-      cursor: pointer;
-      transition: background 0.2s;
-    }
-
-    .consent-button:hover {
-      background: var(--button-hover-bg);
-    }
   `;
 
   constructor() {
     super();
-    this.setAttribute('gotIt', 'true');
+    // Initially hide the consent banner until needed
     this.setAttribute('show', 'false');
   }
 
   public render(): TemplateResult {
     return html`
-      <div class="pageOverlay">
+      <div class="pageOverlay" @click=${this.pageOverlayClick}>
         <div class="modalBox">
           <div class="content">
             <consentsoftware-header></consentsoftware-header>
@@ -194,52 +241,26 @@ export class ConsentsoftwareCookieconsent extends LitElement {
                 and choose which cookie level you are willing to accept.
               </div>
             </div>
-            <!-- <div class="button-container">
-              <div
-                class="consent-button"
-                @click=${(event: MouseEvent) => this.setLevel(event, ['functional'])}
-              >
-                Functional cookies
-              </div>
-              <div
-                class="consent-button"
-                @click=${(event: MouseEvent) => this.setLevel(event, ['functional', 'analytics'])}
-              >
-                Analytics cookies
-              </div>
-              <div
-                class="consent-button"
-                @click=${(event: MouseEvent) =>
-              this.setLevel(event, ['functional', 'analytics', 'marketing'])}
-              >
-                Marketing cookies
-              </div>
-              <div
-                class="consent-button"
-                @click=${(event: MouseEvent) =>
-              this.setLevel(event, ['functional', 'analytics', 'marketing', 'all'])}
-              >
-                All cookies
-              </div>
-            </div> -->
             <consentsoftware-mainselection></consentsoftware-mainselection>
             <div class="button-container">
               <div
                 class="consent-button"
-                @click=${(event: MouseEvent) => this.setLevel(event, ['functional'])}
+                @click=${(event: MouseEvent) =>
+                  this.handleConsentButtonClick(event, ['functional'])}
               >
                 Deny
               </div>
               <div
                 class="consent-button"
-                @click=${(event: MouseEvent) => this.setLevel(event, ['functional', 'analytics'])}
+                @click=${(event: MouseEvent) =>
+                  this.handleConsentButtonClick(event, ['functional', 'analytics'])}
               >
                 Accept selection
               </div>
               <div
                 class="consent-button"
                 @click=${(event: MouseEvent) =>
-                  this.setLevel(event, ['functional', 'analytics', 'marketing'])}
+                  this.handleConsentButtonClick(event, ['functional', 'analytics', 'marketing'])}
               >
                 Accept all cookies
               </div>
@@ -255,43 +276,44 @@ export class ConsentsoftwareCookieconsent extends LitElement {
   }
 
   /**
-   * Called when the element is inserted into the DOM.
+   * Lifecycle method called when the element is connected to the DOM.
+   * It sets up the theme and displays the consent banner if no cookie levels are set.
    */
   public async connectedCallback() {
     super.connectedCallback();
-    this.updateTheme();
+    this.updateTheme(); // Initialize theme based on system preference
 
     const cookieLevel = await this.csWebclientInstance.getCookieLevels();
     if (!cookieLevel) {
+      // Show consent banner if cookie levels haven't been set yet
       this.setAttribute('show', 'true');
-      this.setAttribute('gotIt', 'false');
       requestAnimationFrame(async () => {
         await this.updated();
         const pageOverlay: HTMLDivElement = this.shadowRoot?.querySelector('.pageOverlay');
         if (pageOverlay) {
+          // Apply dark overlay styling when modal appears
           pageOverlay.style.background = 'rgba(0,0,0, 0.5)';
-          pageOverlay.style.backdropFilter = 'blur(2px)';
+          pageOverlay.style.backdropFilter = 'blur(20px)';
         }
         const modalBox: HTMLDivElement = this.shadowRoot?.querySelector('.modalBox');
         if (modalBox) {
+          // Animate modal box appearance
           modalBox.style.transform = `scale(1)`;
           modalBox.style.opacity = '1';
         }
       });
     } else {
+      // Hide banner if cookie levels are already set
       this.setAttribute('show', 'false');
-      this.setAttribute('gotIt', 'true');
     }
   }
 
-  /**
+  public async firstUpdated() {
-   * Called after the first render of the component.
+    // Placeholder for any logic needed after first render
-   * We measure the actual height of the banner and update the CSS variable.
+  }
-   */
-  public async firstUpdated() {}
 
   /**
-   * Called whenever the element is updated or re-rendered.
+   * Called after updates. Logs banner height and runs consent scripts if necessary.
    */
   public async updated() {
     console.log(`The height of the cookie banner is ${this.shadowRoot?.host?.clientHeight}px`);
@@ -303,25 +325,61 @@ export class ConsentsoftwareCookieconsent extends LitElement {
   }
 
   /**
-   * Sets the user’s chosen cookie level(s) and hides the banner.
+   * Handles consent button clicks, sets cookie levels, and hides the banner.
+   * Uses theme variables for styling transitions.
    */
-  private async setLevel(event: MouseEvent, levelsArg: csInterfaces.TCookieLevel[]) {
+  private async handleConsentButtonClick(
+    event: MouseEvent,
+    levelsArg: csInterfaces.TCookieLevel[]
+  ) {
     console.log(`Set level to ${levelsArg}`);
+    const pageOverlay: HTMLDivElement = this.shadowRoot?.querySelector('.pageOverlay');
+    if (pageOverlay) {
+      // Fade out overlay effect using inline styles for transition
+      pageOverlay.style.background = 'rgba(255,255,255, 0)';
+      pageOverlay.style.backdropFilter = 'blur(0px)';
+    }
+    const modalBox: HTMLDivElement = this.shadowRoot?.querySelector('.modalBox');
+    if (modalBox) {
+      // Scale down and fade out modal box before hiding
+      modalBox.style.transform = `scale(0.95)`;
+      modalBox.style.opacity = '0';
+    }
+    // Save user consent preferences
     await this.csWebclientInstance.setCookieLevels(levelsArg);
-    this.setAttribute('gotIt', 'true');
     await delayFor(300);
-    this.setAttribute('show', 'false');
+    this.setAttribute('show', 'false'); // Hide the consent banner
-    // After user selection, re-check for any required scripts to run
+    this.updated(); // Trigger any post-consent actions
-    this.updated();
   }
 
   /**
-   * Dynamically switches the theme between light/dark,
+   * Handles clicks on the page overlay. If clicked outside the modal,
-   * respecting `prefers-color-scheme` by default.
+   * triggers a shake animation as feedback.
+   */
+  private async pageOverlayClick(e: MouseEvent) {
+    if (e.target === e.currentTarget) {
+      const pageOverlay: HTMLDivElement = this.shadowRoot?.querySelector('.pageOverlay');
+      const modalBox: HTMLDivElement = this.shadowRoot?.querySelector('.modalBox');
+      if (pageOverlay && modalBox) {
+        pageOverlay.classList.add('shake');
+        modalBox.classList.add('shake');
+        await delayFor(2000);
+        pageOverlay.classList.remove('shake');
+        modalBox.classList.remove('shake');
+      }
+    }
+  }
+
+  /**
+   * Dynamically switches the theme between light and dark.
+   * Listens for system theme changes to update the component's theme.
    */
   private updateTheme() {
+    // Check the initial system preference for dark mode
     const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
     this.theme = prefersDark ? 'dark' : 'light';
+
+    // Listen for changes in the system color scheme preference
     window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', (e) => {
       this.theme = e.matches ? 'dark' : 'light';
     });

ts_web/elements/consentsoftware-header.ts

@@ -11,10 +11,10 @@ export class ConsentsoftwareHeader extends LitElement {
   public static styles = css`
     :host {
       display: block;
-      line-height: 2em;
+      line-height: 3em;
       text-align: center;
       font-family: ${shared.fontStack};
-      border-bottom: 1px solid rgba(255, 255, 255, 0.1);
+      border-bottom: 1px dotted rgba(255, 255, 255, 0.1);
     }
 
     .heading {

ts_web/elements/consentsoftware-mainselection.ts

@@ -16,8 +16,6 @@ export class ConsentsoftwareMainSelection extends LitElement {
     :host {
       display: block;
       position: relative;
-      border-top: 1px solid rgba(255, 255, 255, 0.1);
-      border-bottom: 1px solid rgba(255, 255, 255, 0.1);
     }
 
     .maincontainer {
@@ -28,7 +26,8 @@ export class ConsentsoftwareMainSelection extends LitElement {
     .itemBox {
       padding: 16px;
       text-align: center;
-      border-right: 1px solid rgba(255, 255, 255, 0.1);
+      border-right: 1px solid;
+      border-image: radial-gradient(circle, rgba(255, 255, 255, 0.7) 0%, rgba(255, 255, 255, 0) 100%) 1;
     }
     .itemBox:last-child {
       border-right: none;

ts_web/elements/consentsoftware-tabs.ts

@@ -24,6 +24,13 @@ export class ConsentsoftwareTabs extends LitElement {
       cursor: pointer;
     }
 
+    /* Media query for mobile devices: stack buttons vertically */
+    @media (max-width: 600px) {
+      .tabs .tab {
+        font-size: 0.8em;
+      }
+    }
+
     .selector {
       position: absolute;
       width: calc(100% / 3);
@@ -44,7 +51,7 @@ export class ConsentsoftwareTabs extends LitElement {
       <div class="tabs">
         <div class="tab" @click=${this.handleClick}>Consent</div>
         <div class="tab" @click=${this.handleClick}>Details</div>
-        <div class="tab" @click=${this.handleClick}>About Cookies</div>
+        <div class="tab" @click=${this.handleClick}>Cookie Policy</div>
       </div>
       <div class="selector"></div>
     `;

ts_web/elements/consentsoftware-toggle.ts

@@ -1,18 +1,31 @@
 import { LitElement, html, css, type TemplateResult } from 'lit';
 import { customElement } from 'lit/decorators.js';
 import { property } from 'lit/decorators/property.js';
-
 import { delayFor } from '@push.rocks/smartdelay';
 
 @customElement('consentsoftware-toggle')
 export class ConsentsoftwareToggle extends LitElement {
-  public static demo = () => html`<consentsoftware-toggle></consentsoftware-toggle>`;
-
   @property({ type: Boolean })
-  public required = false;
+  public accessor required = false;
 
   @property({ type: Boolean, reflect: true })
-  public selected = false;
+  public accessor selected = false;
+
+  /**
+   * We always track the knob’s left offset in `currentX`.
+   * - 0 => fully left
+   * - 30 => fully right
+   */
+  private currentX = 0;
+
+  /**
+   * Drag state
+   */
+  private isDragging = false;
+  private hasDragged = false;
+  private startX = 0; // pointerdown offset
+  private readonly knobWidth = 30;
+  private readonly trackWidth = 60;
 
   public static styles = css`
     :host {
@@ -24,17 +37,21 @@ export class ConsentsoftwareToggle extends LitElement {
       margin-bottom: 16px;
     }
 
+    .toggle {
+      user-select: none; /* helps avoid text selection on drag */
+    }
+
     .toggleKnobArea {
-      cursor: pointer;
+      position: relative;
       margin: auto;
       height: 30px;
       width: 60px;
       border-radius: 20px;
       background: rgba(255, 255, 255, 0.1);
-      position: relative;
-      overflow: hidden;
-      transition: all 0.2s;
       border: 1px solid rgba(255, 255, 255, 0);
+      overflow: hidden;
+      transition: background 0.2s ease;
+      cursor: pointer;
     }
 
     :host([selected]) .toggleKnobArea {
@@ -42,19 +59,27 @@ export class ConsentsoftwareToggle extends LitElement {
     }
 
     .toggleKnobMover {
-      transition: all 0.2s;
+      position: relative;
+      height: 100%;
+      width: 100%;
     }
 
     .toggleKnobInner {
-      height: 30px;
-      width: 30px;
-      border-radius: 15px;
-      background: rgba(255, 255, 255, 0.5);
       position: absolute;
       top: 0;
       left: 0;
-      transition: all 0.2s;
+      width: 30px;
+      height: 30px;
+      border-radius: 15px;
+      background: rgba(255, 255, 255, 0.5);
+      transition: left 0.2s ease, background 0.2s ease;
       transform: scale(0.7);
+      /* Prevent scroll gestures on mobile */
+      touch-action: none;
+    }
+
+    .toggleKnobInner.dragging {
+      transition: background 0.2s ease;
     }
 
     :host([selected]) .toggleKnobInner {
@@ -78,50 +103,153 @@ export class ConsentsoftwareToggle extends LitElement {
   public render(): TemplateResult {
     return html`
       <div class="label">${this.getText()}</div>
+      <!-- A user can click anywhere in this toggle area. -->
       <div class="toggle" @click=${this.handleClick}>
         <div class="toggleKnobArea">
           <div class="toggleKnobMover">
-            <div class="toggleKnobInner"></div>
+            <!-- The knob itself, with pointer events for dragging. -->
+            <div
+              class="toggleKnobInner"
+              style="left: ${this.currentX}px;"
+              @pointerdown=${this.onPointerDown}
+              @pointermove=${this.onPointerMove}
+              @pointerup=${this.onPointerUp}
+              @pointercancel=${this.onPointerUp}
+            ></div>
           </div>
         </div>
       </div>
     `;
   }
 
-  public async firstUpdated(_changedProperties: Map<string | number | symbol, unknown>) {
+  /**
-    super.firstUpdated(_changedProperties);
+   * If required = true on first render, auto-select and set the knob to the right.
+   */
+  public async firstUpdated() {
     if (this.required) {
+      // If "required" => always selected
       this.selected = true;
-      this.syncSelection();
+      this.currentX = this.knobWidth; // 30
+      this.requestUpdate();
+    } else {
+      // If not required, set knob to 0 or 30 depending on `selected`
+      this.currentX = this.selected ? this.knobWidth : 0;
+      this.requestUpdate();
     }
   }
 
-  public async handleClick(mouseEvent) {
+  /**
-    if (this.required) {
+   * CLICK HANDLER
-      const moverElement: HTMLDivElement = this.shadowRoot.querySelector('.toggleKnobMover');
+   */
-      moverElement.style.transform = 'translateX(20px)';
+  public async handleClick(event: MouseEvent) {
-      await delayFor(250);
+    // If the user truly dragged the knob, skip the normal click toggle.
-      moverElement.style.transform = 'translateX(30px)';
+    if (this.isDragging || this.hasDragged) {
+      event.stopPropagation();
+      event.preventDefault();
       return;
     }
+
+    if (this.required) {
+      // small bounce from 30 -> 20 -> 30
+      this.currentX = this.knobWidth; // ensure at 30
+      this.requestUpdate();
+      await new Promise((r) => setTimeout(r, 10));
+
+      this.currentX = 20; // small bounce left
+      this.requestUpdate();
+      await delayFor(200);
+
+      this.currentX = this.knobWidth; // back to 30
+      this.requestUpdate();
+      return;
+    }
+
+    // Normal toggle if no drag & not required
+    event.stopPropagation();
+    event.preventDefault();
+
     this.selected = !this.selected;
-    mouseEvent.stopPropagation();
+    this.currentX = this.selected ? this.knobWidth : 0; // snap knob left(0) or right(30)
-    mouseEvent.preventDefault();
+    this.requestUpdate();
-    this.syncSelection();
+
     this.dispatchEvent(new CustomEvent('toggle', { detail: { selected: this.selected } }));
+    delayFor(0).then(() => {
+      this.hasDragged = false;
+    });
   }
 
-  public async syncSelection() {
+  /**
-    console.log(`Selected ${this.selected}`);
+   * DRAG HANDLERS (pointer events)
-    const moverElement: HTMLDivElement = this.shadowRoot.querySelector('.toggleKnobMover');
+   */
-    if (this.selected) {
+  private onPointerDown(event: PointerEvent) {
-      moverElement.style.transform = 'translateX(30px)';
+    if (this.required) {
-    } else {
+      // If "required", disallow manual dragging
-      moverElement.style.transform = 'translateX(0px)';
+      return;
-    }
     }
 
-  public getText() {
+    // Start dragging
+    this.isDragging = true;
+    // The difference between the pointer’s X and the knob’s current position
+    this.startX = event.clientX - this.currentX;
+
+    // capture pointer so we keep receiving pointermove/pointerup
+    (event.target as HTMLElement).setPointerCapture(event.pointerId);
+  }
+
+  private onPointerMove(event: PointerEvent) {
+    if (!this.isDragging) return;
+    const newX = event.clientX - this.startX;
+    this.hasDragged = true;
+    const toggleKnobInner: HTMLDivElement = this.shadowRoot.querySelector('.toggleKnobInner');
+    toggleKnobInner.classList.add('dragging');
+
+    // Clamp
+    this.currentX = Math.max(0, Math.min(newX, this.trackWidth - this.knobWidth));
+    this.requestUpdate();
+  }
+
+  private onPointerUp(event: PointerEvent) {
+    if (!this.isDragging) return;
+    (event.target as HTMLElement).releasePointerCapture(event.pointerId);
+    this.isDragging = false;
+
+    // If we didn’t truly drag, pointerup does nothing; click handler handles toggling.
+    if (!this.hasDragged) {
+      return;
+    }
+    const toggleKnobInner: HTMLDivElement = this.shadowRoot.querySelector('.toggleKnobInner');
+    toggleKnobInner.classList.remove('dragging');
+
+    // Real drag => decide final side
+    const midpoint = (this.trackWidth - this.knobWidth) / 2; // 15
+    this.selected = this.currentX > midpoint;
+    this.currentX = this.selected ? this.knobWidth : 0; // snap to edge
+    this.requestUpdate();
+
+    // Dispatch toggle event
+    this.dispatchEvent(new CustomEvent('toggle', { detail: { selected: this.selected } }));
+    delayFor(0).then(() => {
+      this.hasDragged = false;
+    });
+  }
+
+  /**
+   * If external code sets `selected = true/false`, we also sync the knob position
+   */
+  protected updated(changedProperties: Map<PropertyKey, unknown>): void {
+    if (
+      changedProperties.has('selected') &&
+      !this.isDragging &&
+      !this.hasDragged &&
+      !this.required
+    ) {
+      this.currentX = this.selected ? this.knobWidth : 0;
+      this.requestUpdate();
+    }
+    super.updated(changedProperties);
+  }
+
+  public getText(): string | null {
     return this.textContent;
   }
 }