@vertebr/react 0.5.1 → 0.7.0

package/dist/hooks/useVertebrControls.js

@@ -1,14 +1,19 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
-import { createVertebrClient } from "@vertebr/client";
+import { createVertebrClient, isVertebrPreviewMode, postVertebrPreviewReady, subscribeVertebrPreviewDraft, } from "@vertebr/client";
 const ControlsContext = createContext(null);
 /**
  * Loads all public Vertebr controls for the storefront once and shares them.
+ * When the URL has `?vertebrPreview=1`, also merges live drafts from the
+ * admin iframe parent (host still renders).
  */
-export function VertebrControlsProvider({ apiBase = "/admin/api", environment, children, }) {
+export function VertebrControlsProvider({ apiBase = "/admin/api", environment, enablePreview, children, }) {
     const [controls, setControls] = useState({});
+    const [drafts, setDrafts] = useState({});
     const [loading, setLoading] = useState(true);
     const [error, setError] = useState(null);
+    const previewEnabled = enablePreview ??
+        (typeof window !== "undefined" && isVertebrPreviewMode());
     const client = useMemo(() => createVertebrClient({
         apiBase,
         getEnvironment: () => environment,
@@ -31,7 +36,31 @@ export function VertebrControlsProvider({ apiBase = "/admin/api", environment, c
     useEffect(() => {
         void load();
     }, [load]);
-    const value = useMemo(() => ({ environment, controls, loading, error, refresh }), [environment, controls, loading, error, refresh]);
+    useEffect(() => {
+        if (!previewEnabled)
+            return;
+        postVertebrPreviewReady();
+        return subscribeVertebrPreviewDraft((controlId, value) => {
+            setDrafts((current) => ({ ...current, [controlId]: value }));
+        });
+    }, [previewEnabled]);
+    const merged = useMemo(() => {
+        if (!previewEnabled || Object.keys(drafts).length === 0)
+            return controls;
+        const next = { ...controls };
+        for (const [id, value] of Object.entries(drafts)) {
+            next[id] = { ...(controls[id] ?? {}), ...value };
+        }
+        return next;
+    }, [controls, drafts, previewEnabled]);
+    const value = useMemo(() => ({
+        environment,
+        controls: merged,
+        loading,
+        error,
+        refresh,
+        preview: previewEnabled,
+    }), [environment, merged, loading, error, refresh, previewEnabled]);
     return (_jsx(ControlsContext.Provider, { value: value, children: children }));
 }
 function useControlsContext() {

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { VertebrAdmin } from "./components/admin/VertebrAdmin";
 export type { VertebrAdminProps } from "./components/admin/VertebrAdmin";
 export { MetricsBoard } from "./components/metrics/MetricsBoard";
 export { GalleryBoard } from "./components/gallery/GalleryBoard";
+export { FontLibraryBoard } from "./components/fonts/FontLibraryBoard";
+export { FontPickerField } from "./components/fonts/FontPickerField";
 export { EmailsBoard } from "./components/emails/EmailsBoard";
 export type { EmailsBoardProps } from "./components/emails/EmailsBoard";
 export type { EmailRecipientOption } from "./components/emails/EmailRecipientSelect";
@@ -20,7 +22,7 @@ export { useVertebrTheme } from "./hooks/useVertebrTheme";
 export type { VbTheme } from "./hooks/useVertebrTheme";
 export { VertebrControlsProvider, useVertebrConfig, useVertebrControls, } from "./hooks/useVertebrControls";
 export type { VertebrControlsProviderProps } from "./hooks/useVertebrControls";
-export { createVertebrClient, VERTEBR_ENV_HEADER, renderMarkdown, } from "@vertebr/client";
+export { createVertebrClient, VERTEBR_ENV_HEADER, renderMarkdown, isVertebrPreviewMode, getVertebrPreviewControlId, buildVertebrPreviewUrl, } from "@vertebr/client";
 export { VertebrMarkdown } from "@vertebr/client/react";
 export type { VertebrMarkdownProps } from "@vertebr/client/react";
 export { createVertebrCatalog, catalogHref, catalogMatch, } from "@vertebr/client";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,YAAY,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,YAAY,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAG/E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,SAAS,EACT,WAAW,EACX,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,8 @@
 export { VertebrAdmin } from "./components/admin/VertebrAdmin";
 export { MetricsBoard } from "./components/metrics/MetricsBoard";
 export { GalleryBoard } from "./components/gallery/GalleryBoard";
+export { FontLibraryBoard } from "./components/fonts/FontLibraryBoard";
+export { FontPickerField } from "./components/fonts/FontPickerField";
 export { EmailsBoard } from "./components/emails/EmailsBoard";
 export { ResourcePanel, ResourceTable } from "./components/resources/ResourceTable";
 export { ThemeToggle } from "./components/theme/ThemeToggle";
@@ -10,8 +12,7 @@ export { isDescriptionField, descriptionStats, applyMarkdown, } from "./lib/desc
 export { EnvSelect } from "./components/env/EnvSelect";
 export { useVertebrTheme } from "./hooks/useVertebrTheme";
 export { VertebrControlsProvider, useVertebrConfig, useVertebrControls, } from "./hooks/useVertebrControls";
-// Re-export the framework-agnostic client for convenience.
-export { createVertebrClient, VERTEBR_ENV_HEADER, renderMarkdown, } from "@vertebr/client";
+export { createVertebrClient, VERTEBR_ENV_HEADER, renderMarkdown, isVertebrPreviewMode, getVertebrPreviewControlId, buildVertebrPreviewUrl, } from "@vertebr/client";
 export { VertebrMarkdown } from "@vertebr/client/react";
 export { createVertebrCatalog, catalogHref, catalogMatch, } from "@vertebr/client";
 export { VertebrCatalogProvider, useVertebrCatalog, useVertebrCatalogItem, } from "@vertebr/client/react";

package/dist/styles/base.css

@@ -21,33 +21,27 @@ html:has(.vertebr-error) body {
   position: relative;
   z-index: 1;
   box-sizing: border-box;
-  height: 100vh;
-  max-height: 100vh;
-  min-height: 100vh;
+  height: 100dvh;
+  max-height: 100dvh;
+  min-height: 100dvh;
   width: 100%;
   display: grid;
   grid-template-columns: var(--vb-sidebar-width) 1fr;
-  background:
-    radial-gradient(
-      900px 480px at 0% -10%,
-      var(--vb-glow-accent),
-      transparent 55%
-    ),
-    radial-gradient(
-      700px 400px at 100% 100%,
-      var(--vb-glow-cool),
-      transparent 50%
-    ),
-    linear-gradient(180deg, var(--vb-bg-deep) 0%, var(--vb-bg) 45%);
+  grid-template-rows: var(--vb-topbar-height) 1fr;
+  background: var(--vb-bg);
   color: var(--vb-text);
   font-family: var(--vb-font);
-  font-size: 15px;
-  line-height: 1.45;
+  font-size: var(--vb-font-size-300);
+  line-height: var(--vb-line-height-normal);
   -webkit-font-smoothing: antialiased;
   isolation: isolate;
   overflow: clip;
 }
 
+.vertebr-root[data-sidebar-collapsed="true"] {
+  grid-template-columns: var(--vb-sidebar-width-collapsed) 1fr;
+}
+
 .vertebr-root *,
 .vertebr-root *::before,
 .vertebr-root *::after {

package/dist/styles/buttons.css

@@ -27,23 +27,14 @@
 }
 
 .vertebr-btn-primary {
-  background: linear-gradient(
-    180deg,
-    var(--vb-btn-primary-from) 0%,
-    var(--vb-btn-primary-to) 100%
-  );
+  background: var(--vb-btn-primary-from);
   border-color: var(--vb-btn-primary-border);
   color: var(--vb-accent-contrast);
-  font-weight: 600;
-  box-shadow: 0 1px 0 var(--vb-surface-tint-strong) inset;
+  font-weight: var(--vb-font-weight-semibold);
 }
 
 .vertebr-btn-primary:hover:not(:disabled) {
-  background: linear-gradient(
-    180deg,
-    var(--vb-btn-primary-hover-from) 0%,
-    var(--vb-btn-primary-hover-to) 100%
-  );
+  background: var(--vb-btn-primary-hover-from);
   border-color: var(--vb-btn-primary-hover-border);
 }
 

package/dist/styles/font-library.css

@@ -0,0 +1,401 @@
+/* ── Font library ─────────────────────────────────────── */
+
+.vertebr-font-library {
+  flex: 1 1 auto;
+  min-height: 0;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+
+.vertebr-font-library-head-actions {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+}
+
+.vertebr-font-library-body {
+  flex: 1 1 auto;
+  min-height: 0;
+  overflow: auto;
+  display: flex;
+  flex-direction: column;
+  gap: 1.25rem;
+  padding: 1.15rem 1.35rem 1.35rem;
+}
+
+.vertebr-font-library-note {
+  margin: 0;
+  color: var(--vb-muted);
+  font-size: 0.875rem;
+}
+
+.vertebr-font-library-grid,
+.vertebr-font-picker-grid,
+.vertebr-google-fonts-grid {
+  display: grid;
+  gap: 1rem;
+  align-content: start;
+}
+
+.vertebr-font-library-grid {
+  grid-template-columns: repeat(auto-fill, minmax(16rem, 1fr));
+}
+
+.vertebr-font-library-card,
+.vertebr-google-fonts-card {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  padding: 1rem;
+  border: 1px solid var(--vb-line);
+  border-radius: 0.75rem;
+  background: var(--vb-surface);
+  min-width: 0;
+}
+
+.vertebr-font-library-preview-btn,
+.vertebr-google-fonts-preview-btn {
+  display: flex;
+  flex-direction: column;
+  gap: 0.45rem;
+  width: 100%;
+  padding: 0;
+  border: 0;
+  background: transparent;
+  color: inherit;
+  text-align: left;
+  cursor: pointer;
+}
+
+.vertebr-font-library-preview-btn:hover .vertebr-font-library-preview,
+.vertebr-google-fonts-preview-btn:hover .vertebr-google-fonts-card-copy {
+  border-color: var(--vb-accent);
+}
+
+.vertebr-font-library-preview {
+  display: flex;
+  flex-direction: column;
+  gap: 0.35rem;
+  min-height: 5.5rem;
+  padding: 0.75rem;
+  border: 1px solid var(--vb-line);
+  border-radius: 0.5rem;
+  background: var(--vb-bg);
+  transition: border-color 0.15s ease;
+}
+
+.vertebr-font-library-preview-hint {
+  color: var(--vb-muted);
+  font-size: 0.72rem;
+}
+
+.vertebr-font-library-ag {
+  font-size: 2rem;
+  line-height: 1;
+}
+
+.vertebr-font-library-preview p,
+.vertebr-font-picker-preview p,
+.vertebr-font-preview-body {
+  margin: 0;
+  font-size: 0.95rem;
+  line-height: 1.45;
+}
+
+.vertebr-font-library-meta {
+  display: flex;
+  flex-direction: column;
+  gap: 0.2rem;
+  min-width: 0;
+}
+
+.vertebr-font-library-meta strong {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.vertebr-font-library-meta span,
+.vertebr-font-library-meta code {
+  color: var(--vb-muted);
+  font-size: 0.8rem;
+}
+
+.vertebr-font-library-meta code {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.vertebr-google-fonts {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  padding: 1rem;
+  border: 1px solid var(--vb-line);
+  border-radius: 0.75rem;
+  background: color-mix(in srgb, var(--vb-surface) 88%, var(--vb-bg));
+}
+
+.vertebr-google-fonts-head {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: end;
+  justify-content: space-between;
+  gap: 1rem;
+}
+
+.vertebr-google-fonts-head h3,
+.vertebr-font-picker-modal-head h3,
+.vertebr-font-preview-modal-head h3 {
+  margin: 0;
+}
+
+.vertebr-google-fonts-head p,
+.vertebr-font-picker-modal-head p,
+.vertebr-font-preview-modal-head p {
+  margin: 0.25rem 0 0;
+  color: var(--vb-muted);
+  font-size: 0.875rem;
+}
+
+.vertebr-google-fonts-search {
+  min-width: 14rem;
+  padding: 0.55rem 0.75rem;
+  border: 1px solid var(--vb-line);
+  border-radius: 0.5rem;
+  background: var(--vb-bg);
+  color: var(--vb-ink);
+}
+
+.vertebr-google-fonts-grid-scroll {
+  max-height: min(18rem, 42vh);
+  overflow: auto;
+  padding-right: 0.15rem;
+}
+
+.vertebr-google-fonts-grid {
+  grid-template-columns: repeat(auto-fill, minmax(13rem, 1fr));
+}
+
+.vertebr-google-fonts-card-copy {
+  display: flex;
+  flex-direction: column;
+  gap: 0.15rem;
+  padding: 0.65rem;
+  border: 1px solid var(--vb-line);
+  border-radius: 0.5rem;
+  background: var(--vb-bg);
+  transition: border-color 0.15s ease;
+}
+
+.vertebr-google-fonts-card-copy span {
+  color: var(--vb-muted);
+  font-size: 0.8rem;
+}
+
+.vertebr-font-picker {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.vertebr-font-picker-current {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 0.85rem 1rem;
+  border: 1px solid var(--vb-line);
+  border-radius: 0.65rem;
+  background: var(--vb-surface);
+}
+
+.vertebr-font-picker-current strong {
+  display: block;
+}
+
+.vertebr-font-picker-current span {
+  color: var(--vb-muted);
+  font-size: 0.875rem;
+}
+
+.vertebr-font-picker-preview {
+  padding: 1rem;
+  border: 1px dashed var(--vb-line);
+  border-radius: 0.65rem;
+}
+
+.vertebr-font-picker-modal-backdrop,
+.vertebr-font-preview-modal-backdrop {
+  position: fixed;
+  inset: 0;
+  z-index: 40;
+  display: grid;
+  place-items: center;
+  padding: 1.5rem;
+  background: rgb(0 0 0 / 45%);
+}
+
+.vertebr-font-picker-modal,
+.vertebr-font-preview-modal {
+  width: min(52rem, 100%);
+  max-height: min(88vh, 44rem);
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  padding: 1.25rem;
+  border: 1px solid var(--vb-line);
+  border-radius: 0.85rem;
+  background: var(--vb-bg);
+  box-shadow: 0 24px 64px rgb(0 0 0 / 18%);
+  overflow: hidden;
+}
+
+.vertebr-font-preview-modal {
+  width: min(40rem, 100%);
+}
+
+.vertebr-font-picker-modal-head,
+.vertebr-font-preview-modal-head {
+  display: flex;
+  align-items: start;
+  justify-content: space-between;
+  gap: 1rem;
+  flex-shrink: 0;
+}
+
+.vertebr-font-picker-modal-body {
+  display: grid;
+  grid-template-columns: minmax(0, 1.2fr) minmax(14rem, 0.9fr);
+  gap: 1rem;
+  min-height: 0;
+  flex: 1 1 auto;
+}
+
+.vertebr-font-picker-grid-scroll {
+  min-height: 0;
+  max-height: min(52vh, 28rem);
+  overflow: auto;
+  padding-right: 0.2rem;
+}
+
+.vertebr-font-picker-grid {
+  grid-template-columns: repeat(auto-fill, minmax(10.5rem, 1fr));
+}
+
+.vertebr-font-picker-detail {
+  min-height: 0;
+  max-height: min(52vh, 28rem);
+  overflow: auto;
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  padding: 1rem;
+  border: 1px solid var(--vb-line);
+  border-radius: 0.65rem;
+  background: var(--vb-surface);
+}
+
+.vertebr-font-picker-detail-label {
+  margin: 0;
+  color: var(--vb-muted);
+  font-size: 0.72rem;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+}
+
+.vertebr-font-picker-modal-actions,
+.vertebr-font-preview-modal-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 0.65rem;
+  flex-shrink: 0;
+  padding-top: 0.15rem;
+  border-top: 1px solid var(--vb-line);
+}
+
+.vertebr-font-picker-option {
+  display: flex;
+  flex-direction: column;
+  gap: 0.2rem;
+  min-height: 6.5rem;
+  padding: 0.85rem;
+  border: 1px solid var(--vb-line);
+  border-radius: 0.65rem;
+  background: var(--vb-bg);
+  color: var(--vb-ink);
+  text-align: left;
+  cursor: pointer;
+}
+
+.vertebr-font-picker-option[data-active] {
+  border-color: var(--vb-accent);
+  box-shadow: inset 0 0 0 1px var(--vb-accent);
+}
+
+.vertebr-font-picker-option span,
+.vertebr-font-picker-option em {
+  color: var(--vb-muted);
+  font-size: 0.8rem;
+  font-style: normal;
+}
+
+.vertebr-font-preview-modal-body {
+  overflow: auto;
+  min-height: 0;
+}
+
+.vertebr-font-preview-sample {
+  display: flex;
+  flex-direction: column;
+  gap: 0.65rem;
+}
+
+.vertebr-font-preview-sample[data-compact="true"] {
+  gap: 0.4rem;
+}
+
+.vertebr-font-preview-eyebrow {
+  font-size: 0.72rem;
+  letter-spacing: 0.18em;
+  text-transform: uppercase;
+}
+
+.vertebr-font-preview-heading {
+  font-size: clamp(1.5rem, 3vw, 2rem);
+  line-height: 1.15;
+}
+
+.vertebr-font-preview-alphabet {
+  font-size: 0.82rem;
+  line-height: 1.55;
+  color: var(--vb-muted);
+}
+
+.vertebr-font-preview-weights {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem;
+  font-size: 0.85rem;
+}
+
+.vertebr-error-inline {
+  color: var(--vb-danger, #b42318);
+  font-size: 0.875rem;
+}
+
+@media (max-width: 760px) {
+  .vertebr-font-picker-modal-body {
+    grid-template-columns: 1fr;
+  }
+
+  .vertebr-font-picker-detail {
+    max-height: none;
+  }
+
+  .vertebr-font-picker-grid-scroll {
+    max-height: min(34vh, 18rem);
+  }
+}

package/dist/styles/form.css

@@ -1,7 +1,7 @@
 /* ── Form ────────────────────────────────────────────── */
 
 .vertebr-form {
-  flex: 1 1 auto;
+  flex: 1 1 0%;
   min-height: 0;
   display: flex;
   flex-direction: column;
@@ -101,6 +101,62 @@
   height: 1.85rem;
 }
 
+.vertebr-form-fields[data-layout="settings"] {
+  display: block;
+  padding: 1.05rem 1.1rem 1.15rem;
+}
+
+.vertebr-settings-list {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  border: 1px solid var(--vb-border);
+  border-radius: var(--vb-radius-sm);
+  background: var(--vb-bg);
+  overflow: hidden;
+}
+
+.vertebr-settings-list-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  padding: 0.65rem 0.75rem;
+  border-bottom: 1px solid var(--vb-border);
+}
+
+.vertebr-settings-list-row:last-child {
+  border-bottom: 0;
+}
+
+.vertebr-settings-list-row[data-on="false"] {
+  opacity: 0.55;
+}
+
+.vertebr-settings-list-copy {
+  display: flex;
+  flex-direction: column;
+  gap: 0.15rem;
+  min-width: 0;
+  flex: 1 1 auto;
+}
+
+.vertebr-settings-list-copy label {
+  font-size: 0.86rem;
+  font-weight: 500;
+  color: var(--vb-text);
+  cursor: pointer;
+}
+
+.vertebr-settings-list-desc {
+  margin: 0;
+  font-size: 0.78rem;
+  line-height: 1.4;
+  color: var(--vb-text-muted);
+}
+
 .vertebr-form-fields[data-layout="chips"] .vertebr-field label {
   font-family: var(--vb-mono);
   font-size: 0.7rem;
@@ -705,6 +761,21 @@
   grid-column: 1 / -1;
 }
 
+.vertebr-switch-row-copy {
+  display: flex;
+  flex-direction: column;
+  gap: 0.15rem;
+  min-width: 0;
+  flex: 1 1 auto;
+}
+
+.vertebr-switch-row-desc {
+  margin: 0;
+  font-size: 0.78rem;
+  line-height: 1.4;
+  color: var(--vb-text-muted);
+}
+
 .vertebr-switch-row label {
   font-size: 0.88rem;
   font-weight: 500;
@@ -747,16 +818,31 @@
 
 .vertebr-actions {
   flex: 0 0 auto;
-  z-index: 3;
+  position: relative;
+  z-index: 5;
   display: flex;
   align-items: center;
   gap: 0.75rem;
   padding: 0.85rem 1.35rem;
+  /* Home indicator / browser chrome */
+  padding-bottom: calc(0.85rem + env(safe-area-inset-bottom, 0px));
   border-top: 1px solid var(--vb-border);
-  background: var(--vb-bg-elevated);
+  background: linear-gradient(
+    180deg,
+    var(--vb-actions-from) 0%,
+    var(--vb-actions-to) 100%
+  );
+  backdrop-filter: blur(10px);
   box-shadow: 0 -10px 24px -18px color-mix(in srgb, var(--vb-text) 40%, transparent);
 }
 
+/* iPadOS floating dock overlays the page and is NOT in safe-area-inset. */
+@media (pointer: coarse) {
+  .vertebr-actions {
+    padding-bottom: calc(0.85rem + env(safe-area-inset-bottom, 0px) + 4.75rem);
+  }
+}
+
 .vertebr-actions-spacer {
   flex: 1;
 }