/* ============================================================
   BlueGem CRM · docs layer (v4, tema scuro)
   Si appoggia a css/style.css: stessi token del marchio, stessa
   grammatica (superfici tenui sul fondo notte, raggio ampio,
   faccetta chiara come accento). Shell a 3 colonne, chip metodo
   HTTP, blocchi endpoint, code block, callout, TOC con scrollspy.
   ============================================================ */

:root {
  /* Colori semantici dei metodi HTTP, ritarati per il fondo scuro: testo
     chiaro su velo colorato. Ogni coppia supera 4.5:1 anche nel caso
     peggiore, cioè il chip appoggiato alla testata dell'endpoint, che è
     la superficie più chiara in cui compare. */
  --m-get: #8fbbee;
  --m-get-bg: rgba(61, 123, 218, 0.16);
  --m-post: #6fdca4;
  --m-post-bg: rgba(74, 222, 128, 0.14);
  --m-patch: #f0b45f;
  --m-patch-bg: rgba(240, 180, 95, 0.14);
  --m-put: #5fd3cc;
  --m-put-bg: rgba(45, 212, 191, 0.14);
  --m-del: #f78fa3;
  --m-del-bg: rgba(244, 63, 94, 0.16);
  /* Superficie dei blocchi di codice: un velo più nero del fondo pagina,
     così resta scavata sia sulla pagina sia dentro una card. */
  --code-surface: rgba(5, 9, 17, 0.6);
  --docs-side-w: 260px;
  --docs-toc-w: 220px;
}

/* ---------- Shell a 3 colonne ---------- */
.docs-shell {
  display: grid;
  grid-template-columns: var(--docs-side-w) minmax(0, 1fr) var(--docs-toc-w);
  max-width: 1440px;
  margin: 0 auto;
}

/* sidebar sinistra */
.docs-side {
  border-right: 1px solid var(--line);
  position: sticky; top: 60px;
  height: calc(100vh - 60px);
  overflow-y: auto;
  padding: 32px 14px 48px;
  scrollbar-width: thin;
  scrollbar-color: rgba(143, 187, 238, 0.25) transparent;
}
.docs-side .group { margin-bottom: 22px; }
.docs-side .group > .glabel {
  display: block;
  font-size: 0.78rem; font-weight: 650; color: var(--ink-3);
  padding: 0 12px 8px;
}

/* gruppo collassabile */
.docs-side details.group { margin-bottom: 6px; }
.docs-side details.group > summary.glabel {
  display: flex; justify-content: space-between; align-items: center; gap: 12px;
  cursor: pointer; list-style: none; user-select: none;
  padding: 8px 12px; border-radius: 9px;
  transition: background 0.15s;
}
.docs-side details.group > summary.glabel::-webkit-details-marker { display: none; }
.docs-side details.group > summary.glabel::after {
  content: ""; width: 8px; height: 8px; flex: none;
  border-right: 1.7px solid var(--faint); border-bottom: 1.7px solid var(--faint);
  transform: rotate(-45deg); transition: transform 0.2s;
  margin-right: 3px;
}
.docs-side details.group[open] > summary.glabel::after { transform: rotate(45deg); }
.docs-side details.group > summary.glabel:hover { background: rgba(143, 187, 238, 0.06); }
.docs-side details.group .glinks { padding: 2px 0 8px; }
.docs-side a {
  display: block; color: var(--muted); font-size: 0.88rem;
  padding: 6.5px 12px; border-radius: 9px;
}
.docs-side a:hover { color: var(--ink-3); background: rgba(143, 187, 238, 0.06); text-decoration: none; }
.docs-side a.active {
  color: var(--facet); background: rgba(61, 123, 218, 0.14); font-weight: 600;
}
.docs-side a.soon { color: var(--faint); cursor: default; }
.docs-side a.soon:hover { color: var(--faint); background: none; }
.docs-side a.soon::after {
  content: "presto"; font-size: 0.66rem; font-weight: 600; color: var(--faint);
  background: rgba(143, 187, 238, 0.08); border-radius: 980px; padding: 2px 8px; margin-left: 8px;
}

/* contenuto centrale */
.docs-main { padding: 44px 56px 110px; min-width: 0; }
.docs-main > * { max-width: 860px; }

/* colonna destra: in questa pagina */
.docs-toc {
  border-left: 1px solid var(--line);
  position: sticky; top: 60px;
  height: calc(100vh - 60px);
  overflow-y: auto;
  padding: 36px 12px 48px;
  font-size: 0.84rem;
}
.docs-toc .tlabel {
  display: block; font-size: 0.76rem; font-weight: 650; color: var(--ink-3);
  padding: 0 12px 10px;
}
.docs-toc a {
  display: block; color: var(--muted); padding: 5px 12px; border-radius: 8px;
  line-height: 1.45;
}
.docs-toc a:hover { color: var(--ink-3); text-decoration: none; }
.docs-toc a.active { color: var(--facet); background: rgba(61, 123, 218, 0.14); font-weight: 600; }
.docs-toc a.sub { padding-left: 26px; font-size: 0.8rem; }

/* ---------- Testata pagina docs ---------- */
.doc-head { padding: 0 0 34px; border-bottom: 1px solid var(--line); margin-bottom: 44px; }
.doc-head .crumb {
  display: block; font-size: 0.84rem; font-weight: 600; color: var(--facet);
  margin-bottom: 14px;
}
.doc-head h1 {
  font-family: var(--display); color: var(--ink);
  font-size: clamp(1.9rem, 4vw, 2.6rem); font-weight: 680;
  letter-spacing: -0.02em; line-height: 1.1;
}
.doc-head p { margin-top: 16px; color: var(--text-2); font-size: 1.05rem; max-width: 46em; }

/* ---------- Tipografia contenuto ---------- */
.docs-main h2 {
  font-family: var(--display); color: var(--ink-2);
  font-size: 1.5rem; font-weight: 650; letter-spacing: -0.015em; line-height: 1.2;
  margin: 60px 0 16px; padding-top: 30px; border-top: 1px solid var(--line);
}
.docs-main h2:first-of-type { margin-top: 0; border-top: none; padding-top: 0; }
.docs-main h2 .hidx {
  display: block; font-size: 0.8rem; font-weight: 600; color: var(--facet);
  letter-spacing: 0.01em; margin-bottom: 6px;
}
.docs-main h3 {
  font-family: var(--display); color: var(--ink-3);
  font-size: 1.12rem; font-weight: 650; letter-spacing: -0.01em; margin: 32px 0 10px;
}
.docs-main p { color: var(--muted); font-size: 0.98rem; margin-bottom: 14px; }
.docs-main p strong, .docs-main li strong { color: var(--ink-3); font-weight: 600; }
.docs-main ul.plain { list-style: none; margin: 0 0 18px; }
.docs-main ul.plain li {
  padding: 7px 0 7px 26px; position: relative; color: var(--muted); font-size: 0.95rem;
}
.docs-main ul.plain li::before {
  content: ""; position: absolute; left: 4px; top: 14px;
  width: 6px; height: 6px; border-radius: 50%; background: var(--facet);
}
code.inline {
  font-family: var(--mono); font-size: 0.84em; color: var(--ink-3);
  background: rgba(143, 187, 238, 0.09); border-radius: 6px; padding: 2px 7px;
  /* Niente nowrap: su schermi stretti un token lungo (per esempio
     l'intestazione Authorization con il bearer token) mandava in
     scorrimento orizzontale l'intera pagina, WCAG 1.4.10. */
  overflow-wrap: anywhere;
}

/* ---------- Chip metodo HTTP ---------- */
.method {
  font-family: var(--mono); font-size: 0.68rem; font-weight: 700;
  letter-spacing: 0.06em; padding: 4px 10px; border-radius: 980px; flex: none;
}
.method.get    { color: var(--m-get);   background: var(--m-get-bg); }
.method.post   { color: var(--m-post);  background: var(--m-post-bg); }
.method.patch  { color: var(--m-patch); background: var(--m-patch-bg); }
.method.put    { color: var(--m-put);   background: var(--m-put-bg); }
.method.delete { color: var(--m-del);   background: var(--m-del-bg); }

/* ---------- Blocco endpoint ---------- */
.ep {
  border: 1px solid var(--line); border-radius: 16px; background: var(--panel);
  margin: 26px 0 40px; overflow: hidden;
  box-shadow: var(--shadow-card, 0 1px 2px rgba(0, 0, 0, 0.35), 0 10px 30px rgba(0, 0, 0, 0.28));
}
.ep-head {
  display: flex; align-items: center; gap: 12px; flex-wrap: wrap;
  padding: 14px 20px; border-bottom: 1px solid var(--line); background: var(--panel-2);
}
.ep-head .ep-path { font-family: var(--mono); font-size: 0.88rem; color: var(--ink-3); word-break: break-all; }
.ep-head .ep-auth {
  margin-left: auto; font-size: 0.7rem; font-weight: 600; color: var(--faint);
  border: 1px solid var(--line-strong); border-radius: 980px; padding: 3px 10px; flex: none;
}
.ep-head .ep-auth.yes { color: var(--m-patch); border-color: rgba(240, 180, 95, 0.4); }
.ep-body { padding: 22px 20px 26px; }
.ep-body > p { font-size: 0.95rem; }

/* etichetta di sezione dentro l'endpoint (Parametri / Risposta / Errori) */
.docs-main .slabel {
  display: block; font-size: 0.76rem; font-weight: 650; letter-spacing: 0.02em;
  text-transform: uppercase; color: var(--faint); margin: 26px 0 12px;
}
.ep .slabel:first-child { margin-top: 0; }

/* ---------- Tabella parametri ---------- */
.ptbl-wrap {
  overflow-x: auto; border: 1px solid var(--line); border-radius: 12px; background: var(--panel);
}
table.ptbl { width: 100%; border-collapse: collapse; font-size: 0.9rem; min-width: 560px; }
table.ptbl th, table.ptbl td {
  padding: 11px 16px; text-align: left; vertical-align: top;
  border-bottom: 1px solid var(--line-soft);
}
table.ptbl tbody tr:last-child td { border-bottom: none; }
table.ptbl thead th {
  font-size: 0.76rem; font-weight: 600; color: var(--muted); background: var(--panel-2);
}
table.ptbl td { color: var(--muted); }
table.ptbl td:first-child { font-family: var(--mono); font-size: 0.8rem; color: var(--ink-3); white-space: nowrap; }
table.ptbl .typ { font-family: var(--mono); font-size: 0.74rem; color: var(--m-put); white-space: nowrap; }
table.ptbl .req { font-size: 0.68rem; font-weight: 700; letter-spacing: 0.04em; text-transform: uppercase; color: var(--facet); }
table.ptbl .opt { font-size: 0.68rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--faint); }
table.ptbl code.inline { white-space: nowrap; }

/* codici di stato */
.st { font-family: var(--mono); font-size: 0.8rem; white-space: nowrap; }
.st.ok { color: var(--m-post); }
.st.err { color: var(--m-del); }
.st.warn { color: var(--m-patch); }

/* ---------- Code block ---------- */
.code {
  border: 1px solid var(--line); border-radius: 14px; background: var(--code-surface);
  margin: 14px 0 4px; overflow: hidden;
}
.code-bar {
  display: flex; align-items: center; justify-content: space-between; gap: 12px;
  border-bottom: 1px solid var(--line-soft); padding: 8px 12px 8px 18px;
}
.code-bar .lbl {
  font-family: var(--mono); font-size: 0.68rem; color: var(--faint); letter-spacing: 0.05em;
}
.code-bar .copy {
  font-size: 0.72rem; font-weight: 600; color: var(--text-2); background: rgba(143, 187, 238, 0.09);
  border: none; border-radius: 980px; padding: 6px 14px; min-height: 24px; cursor: pointer;
  transition: color 0.15s, background 0.15s;
}
.code-bar .copy:hover { color: var(--ink-3); background: rgba(143, 187, 238, 0.16); }
.code-bar .copy.done { color: var(--ok); }
.code pre {
  padding: 18px 20px; overflow-x: auto;
  font-family: var(--mono); font-size: 0.82rem; line-height: 1.75; color: var(--text);
}
.code pre .k { color: var(--facet); }   /* chiave JSON / flag */
.code pre .s { color: var(--ok); }      /* stringa / valore evidenziato */
.code pre .c { color: #8090a5; }        /* commento */
.code pre .w { color: var(--ink-3); }   /* testo pieno */

/* ---------- Code block a tab (multi-linguaggio) ---------- */
.codetabs {
  border: 1px solid var(--line); border-radius: 14px; background: var(--code-surface);
  margin: 14px 0 4px; overflow: hidden;
}
.codetabs-bar {
  display: flex; align-items: stretch; border-bottom: 1px solid var(--line-soft);
  background: rgba(143, 187, 238, 0.035);
}
.codetabs-bar .ct-btn {
  font-size: 0.74rem; font-weight: 600; color: var(--faint); background: none;
  border: none; padding: 10px 16px; cursor: pointer;
  transition: color 0.15s, background 0.15s;
}
.codetabs-bar .ct-btn:hover { color: var(--text-2); }
/* La tab attiva torna al colore del pannello sotto, così sembra continua con
   il codice: il velo scuro annulla la schiaritura della barra. */
.codetabs-bar .ct-btn.active { color: var(--ink-3); background: rgba(5, 9, 17, 0.55); box-shadow: inset 0 -2px 0 var(--facet); }
.codetabs-bar .ct-copy {
  margin-left: auto; align-self: center; margin-right: 10px;
  font-size: 0.72rem; font-weight: 600; color: var(--text-2); background: rgba(143, 187, 238, 0.09);
  border: none; border-radius: 980px; padding: 6px 14px; min-height: 24px; cursor: pointer;
  transition: color 0.15s, background 0.15s;
}
.codetabs-bar .ct-copy:hover { color: var(--ink-3); background: rgba(143, 187, 238, 0.16); }
.codetabs-bar .ct-copy.done { color: var(--ok); }
.codetabs .ct-pane { display: none; padding: 18px 20px; overflow-x: auto;
  font-family: var(--mono); font-size: 0.82rem; line-height: 1.75; color: var(--text); }
.codetabs .ct-pane.active { display: block; }
.codetabs .ct-pane .k { color: var(--facet); }
.codetabs .ct-pane .s { color: var(--ok); }
.codetabs .ct-pane .c { color: #8090a5; }
.codetabs .ct-pane .w { color: var(--ink-3); }

/* ---------- Callout ---------- */
.callout {
  background: rgba(61, 123, 218, 0.14); border-radius: 14px;
  padding: 16px 20px; margin: 22px 0;
}
.callout .ctag {
  display: block; font-size: 0.72rem; font-weight: 700; letter-spacing: 0.04em;
  text-transform: uppercase; color: var(--facet); margin-bottom: 6px;
}
.callout p { color: var(--text-2); font-size: 0.92rem; margin: 0; }
.callout.warn { background: var(--m-patch-bg); }
.callout.warn .ctag { color: var(--m-patch); }
.callout.danger { background: var(--m-del-bg); }
.callout.danger .ctag { color: var(--m-del); }

/* ---------- Nav precedente / successiva ---------- */
.doc-foot {
  display: grid; grid-template-columns: 1fr 1fr; gap: 14px; margin-top: 70px;
}
.doc-foot a {
  padding: 20px 24px; background: var(--panel); border: 1px solid var(--line); border-radius: 16px;
  transition: background 0.15s, border-color 0.15s;
}
.doc-foot a:hover { background: var(--panel-2); border-color: var(--line-strong); text-decoration: none; }
.doc-foot a + a { text-align: right; }
.doc-foot .dir {
  display: block; font-size: 0.76rem; font-weight: 600; color: var(--faint); margin-bottom: 4px;
}
.doc-foot .ttl { color: var(--ink-3); font-weight: 650; font-size: 0.98rem; }
.doc-foot a:hover .ttl { color: var(--facet); }
.doc-foot a.off { visibility: hidden; }

/* ---------- Hub docs (docs/index.html) ---------- */
.hub-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 20px; }
/* Sul fondo scuro il solo cambio di superficie non basta a staccare la card:
   serve il filo di bordo, altrimenti la griglia sparisce. */
.hub-grid a.cell {
  padding: 36px 32px 40px; background: var(--panel); border: 1px solid var(--line);
  border-radius: var(--radius, 24px);
  color: var(--text); display: block;
  transition: transform 0.25s ease, box-shadow 0.25s ease, border-color 0.25s ease;
}
.hub-grid a.cell:hover {
  text-decoration: none; transform: translateY(-3px); border-color: var(--line-strong);
  box-shadow: var(--shadow-card, 0 1px 2px rgba(0, 0, 0, 0.35), 0 10px 30px rgba(0, 0, 0, 0.28));
}
.hub-grid .k {
  display: flex; align-items: center; justify-content: center;
  width: 36px; height: 36px; border-radius: 50%;
  background: rgba(61, 123, 218, 0.14); color: var(--facet);
  font-weight: 650; font-size: 0.85rem; margin-bottom: 20px;
  font-variant-numeric: tabular-nums;
}
.hub-grid h2, .hub-grid h3 {
  font-family: var(--display); color: var(--ink-3);
  font-size: 1.25rem; font-weight: 650; letter-spacing: -0.015em; margin-bottom: 8px;
}
.hub-grid p { color: var(--muted); font-size: 0.94rem; }
.hub-grid .go {
  display: block; margin-top: 22px; font-size: 0.92rem; font-weight: 600; color: var(--facet);
}

.hub-note { margin-top: 22px; color: var(--muted); font-size: 0.94rem; }
.hub-note a { font-weight: 600; }

/* ---------- Barra toggle sidebar (solo mobile) ---------- */
.docs-togglebar { display: none; }
.docs-togglebar button {
  font-size: 0.85rem; font-weight: 600; color: var(--ink-3); background: none; border: none;
  padding: 13px 24px; cursor: pointer; width: 100%; text-align: left;
}
.docs-togglebar button::before { content: "☰  "; color: var(--facet); }

/* ---------- Responsive ---------- */
@media (max-width: 1280px) {
  .docs-shell { grid-template-columns: var(--docs-side-w) minmax(0, 1fr); }
  .docs-toc { display: none; }
}
@media (max-width: 960px) {
  .docs-shell { grid-template-columns: 1fr; }
  .docs-side {
    position: static; height: auto; border-right: none;
    border-bottom: 1px solid var(--line); padding: 14px;
    display: none;
  }
  .docs-side.open { display: block; }
  .docs-main { padding: 34px 22px 80px; }
  .docs-togglebar {
    display: flex; position: sticky; top: 60px; z-index: 50;
    background: rgba(11, 18, 32, 0.92);
    -webkit-backdrop-filter: blur(20px); backdrop-filter: blur(20px);
    border-bottom: 1px solid var(--line);
  }
  .hub-grid { grid-template-columns: 1fr; }
  .doc-foot { grid-template-columns: 1fr; }
  .doc-foot a + a { text-align: left; }
}

/* ---------- Segnalazioni (bottone flottante + modal) ---------- */
/* Il flottante sta sopra al testo che scorre: fondo pieno, non velo, se no
   si legge il contenuto in trasparenza sotto l'etichetta. */
.fb-fab {
  position: fixed; right: 20px; bottom: 20px; z-index: 200;
  font-family: var(--sans, inherit); font-size: 0.85rem; font-weight: 600; color: var(--ink-3);
  background: var(--bg-deep); border: 1px solid var(--line-strong); border-radius: 980px;
  padding: 11px 20px; cursor: pointer;
  box-shadow: var(--shadow-card, 0 1px 2px rgba(0, 0, 0, 0.35), 0 10px 30px rgba(0, 0, 0, 0.28));
  transition: border-color 0.15s, color 0.15s, box-shadow 0.15s;
}
.fb-fab:hover {
  border-color: var(--facet); color: var(--facet);
  box-shadow: var(--shadow-float, 0 2px 10px rgba(0, 0, 0, 0.45), 0 34px 80px rgba(0, 0, 0, 0.55));
}
.fb-overlay {
  position: fixed; inset: 0; z-index: 210;
  background: rgba(3, 6, 12, 0.7);
  -webkit-backdrop-filter: blur(6px); backdrop-filter: blur(6px);
  display: flex; align-items: center; justify-content: center; padding: 20px;
}
.fb-overlay.hidden { display: none; }
.fb-modal {
  background: var(--bg); border: 1px solid var(--line-strong); border-radius: 22px;
  box-shadow: var(--shadow-float, 0 2px 10px rgba(0, 0, 0, 0.45), 0 34px 80px rgba(0, 0, 0, 0.55));
  width: 100%; max-width: 600px; max-height: calc(100vh - 40px); overflow: auto;
}
.fb-head {
  display: flex; align-items: center; justify-content: space-between;
  border-bottom: 1px solid var(--line); padding: 18px 24px;
}
.fb-head .fb-title { font-size: 1.02rem; font-weight: 650; color: var(--ink-3); }
.fb-close {
  font-size: 0.8rem; font-weight: 600; color: var(--muted); background: rgba(143, 187, 238, 0.08);
  border: none; border-radius: 980px; padding: 7px 14px; cursor: pointer;
}
.fb-close:hover { color: var(--ink-3); background: rgba(143, 187, 238, 0.14); }
.fb-body { padding: 24px; }
.fb-field { margin-bottom: 16px; }
.fb-field label {
  display: block; font-size: 0.86rem; font-weight: 600; color: var(--ink-3); margin-bottom: 7px;
}
.fb-field input, .fb-field select, .fb-field textarea {
  width: 100%; background: rgba(5, 9, 17, 0.5); border: 1px solid var(--line); border-radius: 12px;
  color: var(--ink-3); font: inherit; font-size: 0.95rem; padding: 11px 14px;
  appearance: none; -webkit-appearance: none;
}
.fb-field select {
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12'%3E%3Cpath fill='none' stroke='%238fa5c4' stroke-width='1.6' stroke-linecap='round' d='m2.5 4.5 3.5 3.5 3.5-3.5'/%3E%3C/svg%3E");
  background-repeat: no-repeat; background-position: right 14px center; background-size: 12px;
  padding-right: 38px;
}
.fb-field textarea { resize: vertical; min-height: 110px; }
.fb-field input:focus, .fb-field select:focus, .fb-field textarea:focus {
  outline: none; border-color: var(--facet);
  box-shadow: 0 0 0 3.5px rgba(143, 187, 238, 0.22);
}
.fb-field input[readonly] { color: var(--faint); cursor: default; background: rgba(143, 187, 238, 0.05); }
.fb-note { font-size: 0.82rem; color: var(--muted); margin: 14px 0 18px; }
.fb-error {
  display: none; font-size: 0.85rem; font-weight: 600; color: var(--m-del); margin-bottom: 14px;
}
.fb-error.show { display: block; }
.fb-done { padding: 34px 24px; }
.fb-done .ok-line { font-size: 1rem; font-weight: 650; color: var(--ok); margin-bottom: 12px; }
.fb-done p { color: var(--muted); font-size: 0.95rem; }
.fb-done code { font-family: var(--mono); color: var(--ink-3); }
@media (max-width: 680px) {
  .fb-fab { right: 12px; bottom: 12px; padding: 9px 16px; }
}