/* developers.html -- the public API guide.
 *
 * Its OWN stylesheet, deliberately not site.css: the sales site restyles
 * itself with the sales site, and a reference page people bookmark and read
 * code from must not change shape because a hero banner did. Pine & Copper,
 * Parlor's look, with the same values site.css uses for its tokens.
 *
 * Phone first. Nothing here may scroll the PAGE sideways: long code scrolls
 * inside its own block, and wide tables inside .d-table-wrap. */

:root{
  --d-paper:#F1F0E7;
  --d-paper-2:#E7E6DA;
  --d-card:#FFFFFF;
  --d-ink:#1A1F1B;
  --d-ink-2:#4A5449;
  --d-ink-3:#5F675C;
  --d-line:#D6D6CA;
  --d-night:#1E3B2F;
  --d-night-2:#14291F;
  --d-night-ink:#F1F0E7;
  --d-night-ink-2:#B9C7BC;
  --d-pine:#2F5B47;
  --d-pine-soft:#DDE8DF;
  --d-copper:#B96A3C;
  --d-copper-lamp:#CC7F50;
  --d-copper-ink:#8E4E26;
  --d-copper-soft:#F4E4D6;
  --d-code-bg:#14291F;
  --d-code-ink:#E8ECE6;
  --d-focus:#B96A3C;
  --d-display:"Fraunces",Georgia,"Times New Roman",serif;
  --d-ui:"Geist","Segoe UI",system-ui,-apple-system,sans-serif;
  --d-mono:"Geist Mono",ui-monospace,"Cascadia Mono",Consolas,monospace;
  --d-gutter:16px;
  color-scheme:light;
}
@media (prefers-color-scheme: dark){
  :root:not([data-theme="light"]){
    --d-paper:#111A15; --d-paper-2:#18241E; --d-card:#16211B;
    --d-ink:#E8ECE6; --d-ink-2:#B4C2B7; --d-ink-3:#8C9A8F; --d-line:#26352C;
    --d-pine:#9CCBB0; --d-pine-soft:#1C3027; --d-copper-ink:#E0A37A; --d-copper-soft:#2E2219;
    --d-code-bg:#0B120E;
    color-scheme:dark;
  }
}
:root[data-theme="dark"]{
  --d-paper:#111A15; --d-paper-2:#18241E; --d-card:#16211B;
  --d-ink:#E8ECE6; --d-ink-2:#B4C2B7; --d-ink-3:#8C9A8F; --d-line:#26352C;
  --d-pine:#9CCBB0; --d-pine-soft:#1C3027; --d-copper-ink:#E0A37A; --d-copper-soft:#2E2219;
  --d-code-bg:#0B120E;
  color-scheme:dark;
}
@media (min-width:720px){ :root{ --d-gutter:32px; } }

*,*::before,*::after{box-sizing:border-box}
html{-webkit-text-size-adjust:100%;scroll-behavior:smooth;scroll-padding-top:72px}
@media (prefers-reduced-motion: reduce){ html{scroll-behavior:auto} }
body{margin:0;background:var(--d-paper);color:var(--d-ink);font-family:var(--d-ui);font-size:1.0625rem;line-height:1.6;overflow-x:hidden}
a{color:var(--d-pine);text-underline-offset:3px}
a:hover{text-decoration-thickness:2px}
:focus-visible{outline:3px solid var(--d-focus);outline-offset:3px;border-radius:4px}
p{margin:0 0 1em}
code{font-family:var(--d-mono);font-size:.88em;background:var(--d-paper-2);padding:.1em .35em;border-radius:5px;overflow-wrap:anywhere}
h1,h2,h3{font-family:var(--d-display);font-weight:500;line-height:1.12;margin:0;letter-spacing:-.01em;font-variation-settings:"SOFT" 60}
h2{font-size:clamp(1.8rem,5.5vw,2.5rem);margin:0 0 .6em}
h3{font-size:1.35rem;margin:1.6em 0 .5em}
h4{font-family:var(--d-ui);font-size:.8rem;font-weight:600;text-transform:uppercase;letter-spacing:.08em;color:var(--d-ink-3);margin:1.4em 0 .5em}
.d-wrap{max-width:1180px;margin:0 auto;padding:0 var(--d-gutter)}
.d-skip{position:absolute;left:-9999px;top:8px;background:var(--d-card);color:var(--d-ink);padding:10px 14px;border-radius:8px;z-index:50}
.d-skip:focus{left:8px}

/* Top bar */
.d-bar{position:sticky;top:0;z-index:20;background:var(--d-night);color:var(--d-night-ink)}
.d-bar-in{max-width:1180px;margin:0 auto;padding:0 var(--d-gutter);min-height:56px;display:flex;align-items:center;gap:16px;flex-wrap:wrap}
.d-brand{display:flex;align-items:center;gap:10px;color:var(--d-night-ink);text-decoration:none;font-family:var(--d-display);font-size:1.25rem;min-height:44px}
.d-mark{display:grid;place-items:center;width:30px;height:30px;border-radius:8px;background:var(--d-copper-lamp);color:var(--d-night-2);font-weight:600}
.d-brand-sub{font-family:var(--d-ui);font-size:.8rem;letter-spacing:.08em;text-transform:uppercase;color:var(--d-night-ink-2)}
.d-bar-nav{display:none;margin-left:auto;gap:4px}
.d-bar-nav a{color:var(--d-night-ink);text-decoration:none;padding:10px 12px;border-radius:8px;font-size:.95rem}
.d-bar-nav a:hover{background:rgba(255,255,255,.08)}
@media (min-width:720px){ .d-bar-nav{display:flex} }

/* Hero */
.d-hero{background:var(--d-night);color:var(--d-night-ink);padding:36px 0 44px}
.d-hero h1{font-size:clamp(2.1rem,7vw,3.4rem);max-width:18ch;margin-bottom:16px}
.d-kicker{font-size:.8rem;letter-spacing:.1em;text-transform:uppercase;color:var(--d-copper-lamp);margin-bottom:12px}
.d-lede{font-size:1.15rem;color:var(--d-night-ink-2);max-width:40rem}
.d-badge{display:inline-block;border:1px solid var(--d-copper-lamp);color:var(--d-night-ink);border-radius:999px;padding:6px 14px;font-size:.95rem}
.d-cta{display:flex;flex-wrap:wrap;gap:12px;margin-top:22px}
.d-btn{display:inline-flex;align-items:center;justify-content:center;min-height:48px;padding:0 20px;border-radius:8px;font-weight:600;text-decoration:none;border:1px solid transparent}
.d-btn--copper{background:var(--d-copper-lamp);color:var(--d-night-2)}
.d-btn--ghost{border-color:var(--d-night-ink-2);color:var(--d-night-ink)}
.d-btn:hover{filter:brightness(1.05)}

/* Layout: table of contents above the text on a phone, beside it on a wide screen */
.d-layout{display:block;padding-top:24px;padding-bottom:40px}
.d-toc-box{background:var(--d-card);border:1px solid var(--d-line);border-radius:10px;padding:4px 16px;margin-bottom:24px}
.d-toc-box summary{cursor:pointer;min-height:44px;display:flex;align-items:center;font-weight:600}
.d-toc ol{margin:0 0 12px;padding-left:1.3em}
.d-toc li{margin:2px 0}
.d-toc a{display:inline-block;padding:6px 0;text-decoration:none}
.d-toc code{background:none;padding:0}
.d-main{min-width:0}
.d-main > section{padding:28px 0;border-top:1px solid var(--d-line)}
.d-main > section:first-child{border-top:0;padding-top:4px}
@media (min-width:960px){
  .d-layout{display:grid;grid-template-columns:230px minmax(0,1fr);gap:48px}
  .d-toc{position:sticky;top:72px;align-self:start;max-height:calc(100vh - 88px);overflow:auto}
  .d-toc-box{background:transparent;border:0;padding:0}
  .d-toc-box summary{min-height:0;margin-bottom:8px;font-size:.8rem;text-transform:uppercase;letter-spacing:.08em;color:var(--d-ink-3);pointer-events:none;list-style:none}
  .d-toc-box summary::-webkit-details-marker{display:none}
  .d-main{max-width:50rem}
}

.d-list{padding-left:1.2em}
.d-list li{margin:.35em 0}
.d-steps{padding-left:1.4em}
.d-steps li{margin:.5em 0}
.d-note{background:var(--d-copper-soft);border-left:4px solid var(--d-copper);border-radius:6px;padding:12px 14px;color:var(--d-ink)}

/* Code */
.d-code{position:relative;background:var(--d-code-bg);color:var(--d-code-ink);border-radius:10px;padding:16px;margin:0 0 1.2em;overflow-x:auto;font-size:.85rem;line-height:1.55;-webkit-overflow-scrolling:touch}
.d-code code{background:none;padding:0;font-size:inherit;color:inherit;overflow-wrap:normal;white-space:pre}
.d-copy{position:absolute;top:8px;right:8px;min-height:36px;min-width:64px;padding:0 12px;border-radius:6px;border:1px solid rgba(255,255,255,.25);background:rgba(20,41,31,.9);color:var(--d-code-ink);font:inherit;font-family:var(--d-ui);font-size:.8rem;cursor:pointer}
.d-copy:hover{border-color:var(--d-copper-lamp)}

/* Tables: scroll inside their own box, never the page */
.d-table-wrap{overflow-x:auto;margin:0 0 1.2em;-webkit-overflow-scrolling:touch}
.d-table{width:100%;border-collapse:collapse;font-size:.95rem;background:var(--d-card);border:1px solid var(--d-line);border-radius:10px}
.d-table th,.d-table td{text-align:left;vertical-align:top;padding:10px 12px;border-bottom:1px solid var(--d-line)}
.d-table thead th{font-size:.78rem;text-transform:uppercase;letter-spacing:.06em;color:var(--d-ink-3);font-weight:600}
.d-table tbody tr:last-child th,.d-table tbody tr:last-child td{border-bottom:0}
.d-table tbody th{font-weight:600;white-space:nowrap}
/* A field list stacks name over description on a phone: two columns of code do not fit 360px. */
@media (max-width:599px){
  .d-fields,.d-fields tbody,.d-fields tr,.d-fields th,.d-fields td{display:block;width:100%}
  .d-fields tbody th{white-space:normal;padding-bottom:0;border-bottom:0}
  .d-fields td{padding-top:4px}
}
.d-type{font-family:var(--d-mono);font-size:.8rem;color:var(--d-copper-ink)}
.d-req{font-size:.72rem;font-weight:600;text-transform:uppercase;letter-spacing:.06em;color:var(--d-copper-ink)}
.d-in{font-size:.75rem;color:var(--d-ink-3);font-weight:400}
.d-sub{margin-top:6px;padding-left:10px;border-left:2px solid var(--d-line);font-size:.9rem}

/* Objects and endpoints */
.d-object,.d-op{background:var(--d-card);border:1px solid var(--d-line);border-radius:12px;padding:16px;margin:0 0 20px}
.d-object h3{margin-top:0}
.d-tag-h{font-size:1.6rem;margin:1.4em 0 .6em}
.d-op-h{font-family:var(--d-mono);font-size:1rem;margin:0 0 8px;display:flex;flex-wrap:wrap;align-items:center;gap:8px;letter-spacing:0}
.d-path{font-size:.95rem;background:none;padding:0}
.d-verb{display:inline-block;font-family:var(--d-ui);font-size:.75rem;font-weight:650;letter-spacing:.06em;border-radius:6px;padding:3px 8px}
.d-verb-get{background:var(--d-pine-soft);color:var(--d-pine)}
.d-verb-post{background:var(--d-copper-soft);color:var(--d-copper-ink)}
.d-verb-delete{background:transparent;border:1px solid var(--d-copper-ink);color:var(--d-copper-ink)}
.d-op-sum{font-family:var(--d-display);font-size:1.3rem;margin-bottom:.4em}
.d-scope{font-size:.9rem;color:var(--d-ink-3)}
.d-status{margin:.8em 0 .4em}
.d-code-n{display:inline-block;font-family:var(--d-mono);font-size:.8rem;font-weight:600;border-radius:5px;padding:1px 7px;background:var(--d-paper-2);color:var(--d-ink-2)}
.d-code-n.d-ok{background:var(--d-pine-soft);color:var(--d-pine)}
.d-ex{margin:.5em 0}
.d-ex summary{cursor:pointer;min-height:44px;display:flex;align-items:center;gap:8px;flex-wrap:wrap}
.d-ex-name{font-size:.9rem;color:var(--d-ink-3);margin:.6em 0 .3em}
.d-common{font-size:.9rem;color:var(--d-ink-3);margin:1em 0 0}

.d-foot{border-top:1px solid var(--d-line);padding:24px 0 40px;color:var(--d-ink-3);font-size:.95rem}
