@caretcms/core 0.1.0

package/static/cms/editor/section-controls/utils.js

@@ -0,0 +1,35 @@
+import { SPACING_Y_VALUES } from './constants.js';
+
+export function humanizeSectionKey(key) {
+  const short = key.startsWith('home.') ? key.slice('home.'.length) : key;
+  return short.replace(/_/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+}
+
+export function normalizeSpacingY(value) {
+  if (typeof value !== 'string') return undefined;
+  return SPACING_Y_VALUES.includes(value) && value !== 'default' ? value : undefined;
+}
+
+export function spacingToken(value) {
+  return normalizeSpacingY(value) || 'default';
+}
+
+export function spacingIndex(value) {
+  const idx = SPACING_Y_VALUES.indexOf(spacingToken(value));
+  return idx === -1 ? 0 : idx;
+}
+
+export function spacingButtonLabel(value) {
+  const token = spacingToken(value);
+  return token === 'default' ? 'Space' : `Space:${token}`;
+}
+
+export function isRecord(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+export function generateSectionId(key) {
+  return `sec-${key.replace(/\./g, '-')}-${Date.now().toString(36)}-${Math.random()
+    .toString(36)
+    .slice(2, 6)}`;
+}

package/static/cms/editor/section-controls.css

@@ -0,0 +1,349 @@
+/* ---------------------------------------------------------------------------
+   Section controls (on-canvas layout actions)
+   --------------------------------------------------------------------------- */
+
+.cms-section-editable {
+  outline: 2px dashed transparent;
+  outline-offset: 2px;
+  transition: outline-color 0.2s ease, box-shadow 0.2s ease;
+}
+
+.cms-section-editable:hover {
+  outline-color: rgba(59, 130, 246, 0.45);
+}
+
+.cms-section-editable.cms-section-active {
+  outline-color: rgba(59, 130, 246, 0.85);
+  box-shadow: inset 0 0 0 1px rgba(59, 130, 246, 0.28);
+}
+
+.cms-section-editable.cms-section-disabled-preview {
+  opacity: 0.58;
+}
+
+.cms-section-editable.cms-section-disabled-preview .cms-section-controls,
+.cms-section-editable.cms-section-disabled-preview .cms-section-chip {
+  opacity: 1;
+  transform: translateY(0);
+  pointer-events: auto;
+}
+
+.cms-highlight-all .cms-section-editable {
+  outline-color: rgba(59, 130, 246, 0.35);
+}
+
+.cms-section-controls {
+  position: absolute;
+  top: 12px;
+  right: 12px;
+  z-index: 1200;
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 6px 8px;
+  border-radius: 6px;
+  background: rgba(20, 23, 28, 0.9);
+  border: 1px solid rgba(59, 130, 246, 0.22);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.25);
+  backdrop-filter: blur(4px);
+  opacity: 0;
+  transform: translateY(-4px);
+  transition: opacity 0.18s ease, transform 0.18s ease;
+  pointer-events: none;
+}
+
+.cms-section-editable:hover .cms-section-controls,
+.cms-section-editable.cms-section-active .cms-section-controls,
+.cms-section-controls:focus-within {
+  opacity: 1;
+  transform: translateY(0);
+  pointer-events: auto;
+}
+
+.cms-section-chip {
+  position: absolute;
+  top: 12px;
+  left: 12px;
+  z-index: 1198;
+  padding: 4px 8px;
+  border-radius: 999px;
+  font-family: var(--cms-font);
+  font-size: 9px;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  border: 1px solid rgba(59, 130, 246, 0.28);
+  background: rgba(12, 14, 18, 0.88);
+  color: rgba(255, 255, 255, 0.75);
+  opacity: 0;
+  transform: translateY(-4px);
+  transition: opacity 0.16s ease, transform 0.16s ease, border-color 0.16s ease;
+  pointer-events: none;
+}
+
+.cms-section-editable:hover .cms-section-chip,
+.cms-section-editable.cms-section-active .cms-section-chip,
+.cms-highlight-all .cms-section-chip {
+  opacity: 1;
+  transform: translateY(0);
+}
+
+.cms-section-editable.cms-section-active .cms-section-chip {
+  border-color: rgba(59, 130, 246, 0.65);
+  color: var(--cms-accent);
+}
+
+.cms-section-controls-actions {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.cms-section-btn {
+  border: 1px solid rgba(255, 255, 255, 0.15);
+  background: rgba(255, 255, 255, 0.03);
+  color: rgba(255, 255, 255, 0.76);
+  font-family: var(--cms-font);
+  font-size: 9px;
+  font-weight: 600;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  border-radius: 4px;
+  padding: 5px 7px;
+  cursor: pointer;
+  transition: all 0.16s ease;
+}
+
+.cms-section-btn:hover {
+  border-color: rgba(59, 130, 246, 0.55);
+  color: var(--cms-accent);
+  background: rgba(59, 130, 246, 0.1);
+}
+
+.cms-section-btn-drag {
+  cursor: grab;
+}
+
+.cms-section-btn-drag:active {
+  cursor: grabbing;
+}
+
+.cms-section-btn:disabled {
+  opacity: 0.4;
+  cursor: wait;
+}
+
+.cms-section-drag-source {
+  outline-color: rgba(59, 130, 246, 0.6) !important;
+  box-shadow: inset 0 0 0 2px rgba(59, 130, 246, 0.25);
+}
+
+.cms-section-drop-target {
+  outline-color: rgba(59, 130, 246, 0.75) !important;
+}
+
+.cms-section-drop-before {
+  box-shadow: inset 0 4px 0 0 rgba(59, 130, 246, 0.8);
+}
+
+.cms-section-drop-after {
+  box-shadow: inset 0 -4px 0 0 rgba(59, 130, 246, 0.8);
+}
+
+body.cms-section-dragging .cms-section-controls {
+  opacity: 1;
+  pointer-events: none;
+}
+
+.cms-section-boundary-actions {
+  position: absolute;
+  left: 50%;
+  bottom: -15px;
+  transform: translateX(-50%);
+  z-index: 1190;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  opacity: 0;
+  pointer-events: none;
+  transition: opacity 0.16s ease;
+}
+
+.cms-section-editable:hover .cms-section-boundary-actions,
+.cms-section-editable.cms-section-active .cms-section-boundary-actions,
+body.cms-spacing-dragging .cms-section-boundary-actions {
+  opacity: 1;
+  pointer-events: auto;
+}
+
+.cms-section-insert-handle {
+  width: 28px;
+  height: 28px;
+  border-radius: 999px;
+  border: 1px solid rgba(59, 130, 246, 0.5);
+  background: rgba(12, 14, 18, 0.96);
+  color: var(--cms-accent);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  box-shadow: 0 8px 18px rgba(0, 0, 0, 0.26);
+  transition: border-color 0.16s ease, transform 0.16s ease, background 0.16s ease;
+}
+
+.cms-section-insert-plus {
+  font-family: var(--cms-font);
+  font-size: 18px;
+  font-weight: 700;
+  line-height: 1;
+  transform: translateY(-1px);
+}
+
+.cms-section-insert-handle:hover {
+  border-color: rgba(59, 130, 246, 0.9);
+  background: rgba(59, 130, 246, 0.15);
+  transform: translateY(-1px);
+}
+
+.cms-section-gap-handle {
+  height: 22px;
+  min-width: 64px;
+  padding: 0 8px;
+  border: 1px solid rgba(59, 130, 246, 0.38);
+  border-radius: 999px;
+  background: rgba(12, 14, 18, 0.92);
+  color: rgba(255, 255, 255, 0.82);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  font-family: var(--cms-font);
+  font-size: 9px;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  cursor: ns-resize;
+  box-shadow: 0 6px 18px rgba(0, 0, 0, 0.28);
+  transition: border-color 0.16s ease, color 0.16s ease, background 0.16s ease;
+}
+
+.cms-section-gap-grip {
+  width: 10px;
+  height: 10px;
+  border-radius: 999px;
+  background:
+    radial-gradient(circle at 2px 2px, rgba(59, 130, 246, 0.9) 1.5px, transparent 1.7px),
+    radial-gradient(circle at 8px 2px, rgba(59, 130, 246, 0.9) 1.5px, transparent 1.7px),
+    radial-gradient(circle at 2px 8px, rgba(59, 130, 246, 0.9) 1.5px, transparent 1.7px),
+    radial-gradient(circle at 8px 8px, rgba(59, 130, 246, 0.9) 1.5px, transparent 1.7px);
+}
+
+.cms-section-gap-handle:hover,
+.cms-section-gap-handle.is-dragging {
+  border-color: rgba(59, 130, 246, 0.75);
+  color: var(--cms-accent);
+  background: rgba(59, 130, 246, 0.1);
+}
+
+body.cms-spacing-dragging {
+  cursor: ns-resize;
+}
+
+body.cms-spacing-dragging * {
+  user-select: none !important;
+}
+
+.cms-section-add-picker {
+  position: fixed;
+  z-index: 1400;
+  width: 220px;
+  border-radius: 8px;
+  background: rgba(12, 14, 18, 0.97);
+  border: 1px solid rgba(59, 130, 246, 0.26);
+  box-shadow: 0 12px 30px rgba(0, 0, 0, 0.35);
+  backdrop-filter: blur(6px);
+  transform: translateY(-4px);
+  opacity: 0;
+  pointer-events: none;
+  transition: opacity 0.16s ease, transform 0.16s ease;
+}
+
+.cms-section-add-picker.open {
+  opacity: 1;
+  transform: translateY(0);
+  pointer-events: auto;
+}
+
+.cms-section-add-picker-head {
+  padding: 10px 10px 8px;
+  font-size: 10px;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: rgba(255, 255, 255, 0.62);
+  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
+}
+
+.cms-section-add-picker-list {
+  padding: 6px;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.cms-section-add-option {
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  background: rgba(255, 255, 255, 0.02);
+  color: rgba(255, 255, 255, 0.83);
+  font-family: var(--cms-font);
+  font-size: 10px;
+  text-align: left;
+  padding: 7px 8px;
+  border-radius: 5px;
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.cms-section-add-option:hover {
+  border-color: rgba(59, 130, 246, 0.45);
+  color: var(--cms-accent);
+  background: rgba(59, 130, 246, 0.08);
+}
+
+.cms-section-add-option.active {
+  border-color: rgba(59, 130, 246, 0.55);
+  color: var(--cms-accent);
+  background: rgba(59, 130, 246, 0.14);
+}
+
+.cms-section-add-option:disabled {
+  opacity: 0.45;
+  cursor: wait;
+}
+
+@media (max-width: 960px) {
+  .cms-section-controls {
+    left: 10px;
+    right: 10px;
+    top: 10px;
+    flex-direction: column;
+    align-items: stretch;
+    gap: 6px;
+  }
+
+  .cms-section-controls-actions {
+    flex-wrap: wrap;
+  }
+
+  .cms-section-chip {
+    top: 8px;
+    left: 8px;
+  }
+
+  .cms-section-boundary-actions {
+    bottom: -18px;
+  }
+
+  .cms-section-add-picker {
+    width: calc(100vw - 24px);
+    max-width: 360px;
+  }
+}

package/static/cms/editor/section-controls.js

@@ -0,0 +1 @@
+export { mountSectionControls } from './section-controls/index.js';

package/static/cms/editor/security.js

@@ -0,0 +1,48 @@
+import { CLOUD, getCloudSessionToken, isCloudMode } from './config.js';
+
+async function getTurnstileToken(action) {
+  if (typeof window.cmsGetTurnstileToken !== 'function') return null;
+  try {
+    return await window.cmsGetTurnstileToken(action);
+  } catch {
+    return null;
+  }
+}
+
+export async function mutateHeaders() {
+  const headers = { 'Content-Type': 'application/json', 'x-caret-request': '1' };
+  if (isCloudMode()) {
+    if (CLOUD?.publicToken) headers['x-caret-token'] = CLOUD.publicToken;
+    const sessionToken = getCloudSessionToken();
+    if (sessionToken) headers.Authorization = `Bearer ${sessionToken}`;
+  }
+  const token = await getTurnstileToken('cms_mutate');
+  if (token) {
+    headers['x-cms-turnstile-token'] = token;
+  }
+  return headers;
+}
+
+export function readHeaders() {
+  const headers = {};
+  if (isCloudMode()) {
+    if (CLOUD?.publicToken) headers['x-caret-token'] = CLOUD.publicToken;
+    const sessionToken = getCloudSessionToken();
+    if (sessionToken) headers.Authorization = `Bearer ${sessionToken}`;
+  }
+  return Object.keys(headers).length > 0 ? headers : undefined;
+}
+
+export async function uploadHeaders() {
+  const headers = { 'x-caret-request': '1' };
+  if (isCloudMode()) {
+    if (CLOUD?.publicToken) headers['x-caret-token'] = CLOUD.publicToken;
+    const sessionToken = getCloudSessionToken();
+    if (sessionToken) headers.Authorization = `Bearer ${sessionToken}`;
+  }
+  const token = await getTurnstileToken('cms_upload');
+  if (token) {
+    headers['x-cms-turnstile-token'] = token;
+  }
+  return headers;
+}

package/static/cms/editor/sync.js

@@ -0,0 +1,72 @@
+import { sanitizeHtml } from './sanitize.js';
+
+export function mountStudioSync({ studioIframe, state, showToast, clientLinkify }) {
+  if (!studioIframe) return;
+
+  window.addEventListener('message', (e) => {
+    // Only accept messages from our iframe
+    if (e.source !== studioIframe.contentWindow) return;
+    const msg = e.data;
+    if (!msg || typeof msg.type !== 'string') return;
+
+    if (msg.type === 'cms:saved') {
+      const { collection, id, data } = msg;
+      if (!data || typeof data !== 'object') return;
+
+      let updated = 0;
+
+      function walkData(obj, prefix) {
+        for (const [key, value] of Object.entries(obj)) {
+          const path = prefix ? `${prefix}.${key}` : key;
+          const selector = `${collection}::${id}::${path}`;
+
+          if (typeof value === 'string') {
+            // Text and image fields — unified under [data-caret]
+            const els = document.querySelectorAll(`[data-caret="${selector}"]`);
+            els.forEach((el) => {
+              // Skip elements being actively edited to prevent overwriting unsaved work
+              if (el === state.dirtyEl || el === document.activeElement) return;
+
+              if (el instanceof HTMLImageElement) {
+                // Image element
+                if (el.src !== value && el.getAttribute('src') !== value) {
+                  el.src = value;
+                  updated++;
+                }
+              } else if (el.hasAttribute('data-caret-rich')) {
+                const sanitized = sanitizeHtml(value);
+                if (el.innerHTML !== sanitized) {
+                  el.innerHTML = sanitized;
+                  updated++;
+                }
+              } else if (el.hasAttribute('data-caret-raw')) {
+                if (el.getAttribute('data-caret-raw') !== value) {
+                  el.setAttribute('data-caret-raw', value);
+                  el.innerHTML = clientLinkify(value);
+                  updated++;
+                }
+              } else if (el.textContent !== value) {
+                el.textContent = value;
+                updated++;
+              }
+            });
+          } else if (typeof value === 'object' && value !== null) {
+            walkData(value, path);
+          }
+        }
+      }
+
+      walkData(data, '');
+
+      if (updated > 0) {
+        showToast(`Updated ${updated} element${updated > 1 ? 's' : ''} on page`, 'success');
+      } else {
+        showToast('Saved — refresh to see changes', 'success');
+      }
+    }
+
+    if (msg.type === 'cms:created') {
+      showToast('New entry created — refresh to see changes', 'success');
+    }
+  });
+}

package/static/cms/editor/text-edit.js

@@ -0,0 +1,151 @@
+import { createTextLinkInteractions } from './text-link-interactions.js';
+import { resolveBinding } from './helpers.js';
+import { sanitizeHtml } from './sanitize.js';
+
+const snapshots = new WeakMap();
+let keydownBound = false;
+
+export function mountTextEditors({
+  state,
+  parseCaretAttr,
+  clientLinkify,
+  saveField,
+  flash,
+  showToast,
+}) {
+  const applyTextValue = (target, value) => {
+    if (target.hasAttribute('data-caret-rich')) {
+      target.innerHTML = sanitizeHtml(value);
+    } else if (target.hasAttribute('data-caret-raw')) {
+      target.setAttribute('data-caret-raw', value);
+      target.innerHTML = clientLinkify(value);
+    } else {
+      target.textContent = value;
+    }
+  };
+  const syncBoundText = (attr, value) => {
+    document.querySelectorAll('[data-caret]').forEach((node) => {
+      if (!(node instanceof HTMLElement)) return;
+      if (node.getAttribute('data-caret') !== attr) return;
+      if (node instanceof HTMLImageElement) return;
+      applyTextValue(node, value);
+    });
+  };
+  const { onKeydown, showLinkHint, removeLinkHint, showLinkPopup } = createTextLinkInteractions({
+    state,
+    clientLinkify,
+    showToast,
+    snapshots,
+  });
+
+  if (!keydownBound) {
+    document.addEventListener('keydown', onKeydown);
+    keydownBound = true;
+  }
+
+  document.querySelectorAll('[data-caret]').forEach((el) => {
+    if (el instanceof HTMLImageElement) return;
+    if (el.dataset.caretTextMounted === 'true') return;
+    el.dataset.caretTextMounted = 'true';
+
+    const attr = el.getAttribute('data-caret');
+    const isRich = el.hasAttribute('data-caret-rich');
+    const isLinkable = !isRich && el.hasAttribute('data-caret-raw');
+
+    el.setAttribute('contenteditable', isRich ? 'true' : 'plaintext-only');
+    el.classList.add('cms-editable');
+    if (isRich) el.classList.add('cms-rich');
+    if (isLinkable) el.classList.add('cms-linkable');
+
+    el.addEventListener('focus', () => {
+      if (isRich) {
+        snapshots.set(el, el.innerHTML);
+      } else if (isLinkable) {
+        const raw = el.getAttribute('data-caret-raw') || '';
+        snapshots.set(el, raw);
+        el.textContent = raw;
+        showLinkHint(el);
+      } else {
+        snapshots.set(el, el.textContent || '');
+      }
+    });
+
+    el.addEventListener('input', () => {
+      const snapshot = snapshots.get(el);
+      const current = isRich ? el.innerHTML : (el.textContent || '');
+      state.dirtyEl = current !== snapshot ? el : null;
+    });
+
+    el.addEventListener('blur', async () => {
+      removeLinkHint();
+
+      // If link popup is active for this element, defer the save
+      if (state.linkPopupEl === el) return;
+
+      // Skip save if Escape was pressed
+      if (el._caretSkipSave) {
+        el._caretSkipSave = false;
+        state.dirtyEl = null;
+        if (isRich) {
+          el.innerHTML = snapshots.get(el) || '';
+        } else if (isLinkable) {
+          const raw = el.getAttribute('data-caret-raw') || '';
+          el.innerHTML = clientLinkify(raw);
+        }
+        return;
+      }
+
+      const snapshot = snapshots.get(el) ?? '';
+      let current;
+      if (isRich) {
+        current = sanitizeHtml(el.innerHTML);
+        el.innerHTML = current; // normalize
+      } else {
+        current = el.textContent || '';
+      }
+
+      if (current === snapshot) {
+        if (isLinkable) {
+          el.innerHTML = clientLinkify(current);
+        }
+        return;
+      }
+
+      const parsed = parseCaretAttr(el.getAttribute('data-caret') || '');
+      const resolved = resolveBinding(el, parsed);
+      if (!resolved) return;
+
+      // Update raw attribute and re-render before saving
+      if (isLinkable) {
+        el.setAttribute('data-caret-raw', current);
+        el.innerHTML = clientLinkify(current);
+      }
+
+      el.classList.add('cms-saving');
+      const result = await saveField(resolved.collection, resolved.id, resolved.field, current);
+      el.classList.remove('cms-saving');
+      flash(el, result.ok);
+      state.dirtyEl = null;
+
+      // Sync all duplicated text bindings
+      if (result.ok) {
+        syncBoundText(attr, current);
+        showToast('Content saved', 'success');
+      } else {
+        const rollbackValue =
+          result.reason === 'conflict' && typeof result.latestValue === 'string'
+            ? result.latestValue
+            : snapshot;
+        syncBoundText(attr, rollbackValue);
+
+        if (result.reason === 'conflict') {
+          showToast('Content changed elsewhere. Loaded latest value.', 'error');
+        } else if (result.reason !== 'unauthorized') {
+          showToast('Failed to save. Changes reverted.', 'error');
+        }
+      }
+    });
+  });
+
+  return { showLinkPopup };
+}