@freshjuice/zest 0.1.0 → 2.0.0

package/src/ui/banner.js

@@ -0,0 +1,134 @@
+/**
+ * Banner - Main consent banner component
+ */
+
+import { generateStyles } from './styles.js';
+import { getCurrentConfig } from '../config/parser.js';
+import { escapeHTML } from '../core/security.js';
+
+let bannerElement = null;
+let shadowRoot = null;
+
+const SAFE_POSITIONS = new Set(['bottom', 'bottom-left', 'bottom-right', 'top']);
+
+/**
+ * Create the banner HTML
+ */
+function createBannerHTML(config) {
+  const labels = config.labels.banner;
+  const rawPosition = config.position || 'bottom';
+  const position = SAFE_POSITIONS.has(rawPosition) ? rawPosition : 'bottom';
+
+  return `
+    <div class="zest-banner zest-banner--${position}" role="dialog" aria-modal="false" aria-label="${escapeHTML(labels.title)}">
+      <h2 class="zest-banner__title">${escapeHTML(labels.title)}</h2>
+      <p class="zest-banner__description">${escapeHTML(labels.description)}</p>
+      <div class="zest-banner__buttons">
+        <button type="button" class="zest-btn zest-btn--primary" data-action="accept-all">
+          ${escapeHTML(labels.acceptAll)}
+        </button>
+        <button type="button" class="zest-btn zest-btn--secondary" data-action="reject-all">
+          ${escapeHTML(labels.rejectAll)}
+        </button>
+        <button type="button" class="zest-btn zest-btn--ghost" data-action="settings">
+          ${escapeHTML(labels.settings)}
+        </button>
+      </div>
+    </div>
+  `;
+}
+
+/**
+ * Create and mount the banner
+ */
+export function createBanner(callbacks = {}) {
+  if (bannerElement) {
+    return bannerElement;
+  }
+
+  const config = getCurrentConfig();
+
+  // Create host element
+  bannerElement = document.createElement('zest-banner');
+  bannerElement.setAttribute('data-theme', config.theme || 'light');
+
+  // Create shadow root
+  shadowRoot = bannerElement.attachShadow({ mode: 'open' });
+
+  // Add styles
+  const styleEl = document.createElement('style');
+  styleEl.textContent = generateStyles(config);
+  shadowRoot.appendChild(styleEl);
+
+  // Add banner HTML
+  const container = document.createElement('div');
+  container.innerHTML = createBannerHTML(config);
+  shadowRoot.appendChild(container.firstElementChild);
+
+  // Add event listeners
+  const banner = shadowRoot.querySelector('.zest-banner');
+
+  banner.addEventListener('click', (e) => {
+    const action = e.target.dataset.action;
+    if (!action) return;
+
+    switch (action) {
+      case 'accept-all':
+        callbacks.onAcceptAll?.();
+        break;
+      case 'reject-all':
+        callbacks.onRejectAll?.();
+        break;
+      case 'settings':
+        callbacks.onSettings?.();
+        break;
+    }
+  });
+
+  // Keyboard handling
+  banner.addEventListener('keydown', (e) => {
+    if (e.key === 'Escape') {
+      callbacks.onSettings?.();
+    }
+  });
+
+  // Mount to document
+  document.body.appendChild(bannerElement);
+
+  // Focus first button for accessibility
+  requestAnimationFrame(() => {
+    const firstButton = shadowRoot.querySelector('button');
+    firstButton?.focus();
+  });
+
+  return bannerElement;
+}
+
+/**
+ * Show the banner
+ */
+export function showBanner(callbacks = {}) {
+  if (!bannerElement) {
+    createBanner(callbacks);
+  } else {
+    bannerElement.classList.remove('zest-hidden');
+  }
+}
+
+/**
+ * Hide the banner
+ */
+export function hideBanner() {
+  if (bannerElement) {
+    bannerElement.remove();
+    bannerElement = null;
+    shadowRoot = null;
+  }
+}
+
+/**
+ * Check if banner is visible
+ */
+export function isBannerVisible() {
+  return bannerElement !== null && document.body.contains(bannerElement);
+}

package/src/ui/modal.js

@@ -0,0 +1,215 @@
+/**
+ * Modal - Settings modal component for category toggles
+ */
+
+import { generateStyles } from './styles.js';
+import { getCurrentConfig } from '../config/parser.js';
+import { DEFAULT_CATEGORIES } from '../core/categories.js';
+import { escapeHTML, safeUrl } from '../core/security.js';
+
+let modalElement = null;
+let shadowRoot = null;
+let currentSelections = {};
+
+/**
+ * Create category toggle HTML
+ */
+function createCategoryHTML(category, isChecked, isRequired) {
+  const disabled = isRequired ? 'disabled' : '';
+  const checked = isChecked ? 'checked' : '';
+  const safeId = escapeHTML(category.id);
+  const safeLabel = escapeHTML(category.label);
+
+  return `
+    <div class="zest-category">
+      <div class="zest-category__header">
+        <div class="zest-category__info">
+          <span class="zest-category__label">${safeLabel}</span>
+          <p class="zest-category__description">${escapeHTML(category.description)}</p>
+        </div>
+        <label class="zest-toggle">
+          <input
+            type="checkbox"
+            class="zest-toggle__input"
+            data-category="${safeId}"
+            ${checked}
+            ${disabled}
+            aria-label="${safeLabel}"
+          >
+          <span class="zest-toggle__slider"></span>
+        </label>
+      </div>
+    </div>
+  `;
+}
+
+/**
+ * Create the modal HTML
+ */
+function createModalHTML(config, consent) {
+  const labels = config.labels.modal;
+  const categories = config.categories || DEFAULT_CATEGORIES;
+
+  const categoriesHTML = Object.values(categories)
+    .map(cat => createCategoryHTML(
+      cat,
+      consent[cat.id] ?? cat.default,
+      cat.required
+    ))
+    .join('');
+
+  const validatedPolicyUrl = config.policyUrl ? safeUrl(config.policyUrl) : null;
+  const policyLink = validatedPolicyUrl
+    ? `<a href="${escapeHTML(validatedPolicyUrl)}" class="zest-link" target="_blank" rel="noopener noreferrer">Privacy Policy</a>`
+    : '';
+
+  return `
+    <div class="zest-modal-overlay" role="dialog" aria-modal="true" aria-label="${escapeHTML(labels.title)}">
+      <div class="zest-modal">
+        <div class="zest-modal__header">
+          <h2 class="zest-modal__title">${escapeHTML(labels.title)}</h2>
+          <p class="zest-modal__description">${escapeHTML(labels.description)} ${policyLink}</p>
+        </div>
+        <div class="zest-modal__body">
+          ${categoriesHTML}
+        </div>
+        <div class="zest-modal__footer">
+          <button type="button" class="zest-btn zest-btn--primary" data-action="save">
+            ${escapeHTML(labels.save)}
+          </button>
+          <button type="button" class="zest-btn zest-btn--secondary" data-action="accept-all">
+            ${escapeHTML(labels.acceptAll)}
+          </button>
+          <button type="button" class="zest-btn zest-btn--ghost" data-action="reject-all">
+            ${escapeHTML(labels.rejectAll)}
+          </button>
+        </div>
+      </div>
+    </div>
+  `;
+}
+
+/**
+ * Get current selections from toggles
+ */
+function getSelections() {
+  if (!shadowRoot) return currentSelections;
+
+  const toggles = shadowRoot.querySelectorAll('.zest-toggle__input');
+  const selections = { essential: true };
+
+  toggles.forEach(toggle => {
+    const category = toggle.dataset.category;
+    if (category && category !== 'essential') {
+      selections[category] = toggle.checked;
+    }
+  });
+
+  return selections;
+}
+
+/**
+ * Create and show the modal
+ */
+export function showModal(consent = {}, callbacks = {}) {
+  if (modalElement) {
+    return modalElement;
+  }
+
+  const config = getCurrentConfig();
+  currentSelections = { ...consent };
+
+  // Create host element
+  modalElement = document.createElement('zest-modal');
+  modalElement.setAttribute('data-theme', config.theme || 'light');
+
+  // Create shadow root
+  shadowRoot = modalElement.attachShadow({ mode: 'open' });
+
+  // Add styles
+  const styleEl = document.createElement('style');
+  styleEl.textContent = generateStyles(config);
+  shadowRoot.appendChild(styleEl);
+
+  // Add modal HTML
+  const container = document.createElement('div');
+  container.innerHTML = createModalHTML(config, consent);
+  shadowRoot.appendChild(container.firstElementChild);
+
+  // Add event listeners
+  const modal = shadowRoot.querySelector('.zest-modal-overlay');
+
+  // Button clicks
+  modal.addEventListener('click', (e) => {
+    const action = e.target.dataset.action;
+    if (!action) {
+      // Click on overlay background to close
+      if (e.target === modal) {
+        callbacks.onClose?.();
+      }
+      return;
+    }
+
+    switch (action) {
+      case 'save':
+        callbacks.onSave?.(getSelections());
+        break;
+      case 'accept-all':
+        callbacks.onAcceptAll?.();
+        break;
+      case 'reject-all':
+        callbacks.onRejectAll?.();
+        break;
+    }
+  });
+
+  // Keyboard handling
+  modal.addEventListener('keydown', (e) => {
+    if (e.key === 'Escape') {
+      callbacks.onClose?.();
+    }
+  });
+
+  // Track toggle changes
+  shadowRoot.querySelectorAll('.zest-toggle__input').forEach(toggle => {
+    toggle.addEventListener('change', () => {
+      currentSelections = getSelections();
+    });
+  });
+
+  // Mount to document
+  document.body.appendChild(modalElement);
+
+  // Trap focus
+  requestAnimationFrame(() => {
+    const firstButton = shadowRoot.querySelector('button');
+    firstButton?.focus();
+  });
+
+  return modalElement;
+}
+
+/**
+ * Hide the modal
+ */
+export function hideModal() {
+  if (modalElement) {
+    modalElement.remove();
+    modalElement = null;
+    shadowRoot = null;
+  }
+}
+
+/**
+ * Check if modal is visible
+ */
+export function isModalVisible() {
+  return modalElement !== null && document.body.contains(modalElement);
+}
+
+/**
+ * Get current modal selections
+ */
+export function getModalSelections() {
+  return getSelections();
+}