Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.
Python aecai-agentsautodeskautomationbimclaudeifcmcpmcp-servermodel-context-protocolnavisworksrevitrevit-addinrevit-apirhino
design: one brand mark, one palette, one icon grammar
sammohammad5784f86c7299142
diff --git a/docs/design/review.html b/docs/design/review.htmlnew file mode 100644index 0000000..f6a76aa--- /dev/null+++ b/docs/design/review.html@@ -0,0 +1,1529 @@+<!doctype html>+<html lang="en">+<head>+<meta charset="utf-8">+<meta name="viewport" content="width=device-width, initial-scale=1">+<title>AEC Model Bridge — design review</title>+<style>+/* ------------------------------------------------------------------ *+ This sheet is painted with the tokens it documents.+ Every hex below also appears in docs/design/tokens.md.+ * ------------------------------------------------------------------ */+:root{+ --sheet-bg:#0F1319;+ --sheet:#161B22;+ --sheet-2:#1C222B;+ --rule:#242D39;+ --rule-soft:#1D242E;+ --ink:#E9EEF5;+ --muted:#8D9BAD;+ --faint:#67758A;+ --brand:#3FC3D6;+ --brand-2:#6FD8E6;++ /* mark paint, dark context (default for this sheet) */+ --mk-ink:#E9EEF5;+ --mk-brand:#3FC3D6;+ --mk-ink-wash:rgba(233,238,245,.16);+ --mk-brand-wash:rgba(63,195,214,.20);+}++*{box-sizing:border-box}++svg{max-width:100%;height:auto}++html{-webkit-text-size-adjust:100%}++body{+ margin:0;+ background:var(--sheet-bg);+ color:var(--ink);+ font-family:"Segoe UI",system-ui,-apple-system,sans-serif;+ font-size:14px;+ line-height:1.55;+}++.sheet{+ max-width:1120px;+ margin:0 auto;+ padding:0 16px 96px;+}++/* ---------- title block ---------- */++.titleblock{+ display:flex;+ flex-wrap:wrap;+ gap:8px 28px;+ align-items:baseline;+ padding:22px 0 18px;+ border-bottom:1px solid var(--rule);+}+.titleblock .doc{font-size:13px;font-weight:600;letter-spacing:.01em}+.titleblock .bit{font-size:12px;color:var(--faint)}+.titleblock .bit b{font-weight:600;color:var(--muted)}++/* ---------- hero ---------- */++.hero{+ display:grid;+ grid-template-columns:minmax(320px,480px) minmax(0,1fr);+ gap:40px 56px;+ align-items:center;+ padding:56px 0 64px;+ border-bottom:1px solid var(--rule);+}+.hero svg{width:100%;height:auto;max-width:480px}+.hero h1{+ margin:0;+ font-size:clamp(30px,4.4vw,46px);+ font-weight:600;+ line-height:1.1;+ letter-spacing:-.012em;+}+.hero .tag{margin:10px 0 0;font-size:17px;color:var(--muted);font-weight:400}+.hero p.lede{margin:26px 0 0;max-width:46ch;color:var(--muted);font-size:14.5px}+.hero p.lede b{color:var(--ink);font-weight:600}++/* annotation layer on the hero mark */+.annot line{stroke:rgba(141,155,173,.42);stroke-width:.55;stroke-dasharray:2.4 2.6}+.annot .tick{stroke:rgba(141,155,173,.75);stroke-dasharray:none;stroke-width:.6}+.annot circle{fill:rgba(141,155,173,.85)}+.annot text{+ fill:#8D9BAD;font-size:4.1px;+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;+ letter-spacing:-.03em;+}++/* ---------- section scaffold: drawing-sheet margin column ---------- */++section{+ display:grid;+ grid-template-columns:186px minmax(0,1fr);+ gap:24px 40px;+ padding:44px 0;+ border-bottom:1px solid var(--rule-soft);+}+section > .margin h2{+ margin:0;+ font-size:16px;+ font-weight:600;+ line-height:1.25;+ letter-spacing:-.005em;+}+section > .margin p{+ margin:10px 0 0;+ font-size:12.5px;+ line-height:1.5;+ color:var(--faint);+}+section > .margin p + p{margin-top:9px}+section > .body{min-width:0}++/* ---------- chips: a light context and a dark context ---------- */++.chips{display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:16px}++.chip{+ border-radius:12px;+ padding:26px 22px 20px;+ border:1px solid transparent;+}+.chip .cap{+ margin-top:20px;+ font-size:11.5px;+ color:inherit;+ opacity:.62;+}+.chip.dark{+ background:#1C222B;border-color:#2F3945;color:#E9EEF5;+ --mk-ink:#E9EEF5;--mk-brand:#3FC3D6;+ --mk-ink-wash:rgba(233,238,245,.16);--mk-brand-wash:rgba(63,195,214,.20);+}+.chip.light{+ background:#FFFFFF;border-color:#D3DAE3;color:#18202C;+ --mk-ink:#18202C;--mk-brand:#0091A7;+ --mk-ink-wash:rgba(24,32,44,.12);--mk-brand-wash:rgba(0,145,167,.20);+}++/* ---------- the mark ---------- */++.mark{display:block}+.mark .w-ink{fill:var(--mk-ink-wash);stroke:none}+.mark .w-brand{fill:var(--mk-brand-wash);stroke:none}+.mark .s{fill:none;stroke-linecap:round;stroke-linejoin:round}+.mark .s .ink{stroke:var(--mk-ink)}+.mark .s .br{stroke:var(--mk-brand)}++/* size row */+.sizes{display:flex;flex-wrap:wrap;align-items:flex-end;gap:34px}+.spec{display:flex;flex-direction:column;align-items:center;gap:12px}+.spec .px{+ font-size:11px;color:var(--muted);+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;+}+.chip.light .spec .px{color:#5B6676}+.chip.dark .spec .px{color:#9BA8B9}+.rule-under{border-top:1px solid currentColor;opacity:.16;width:100%;margin-top:2px}++/* ---------- lockup ---------- */++.lockup{display:flex;align-items:center;gap:20px}+.lockup .name{font-size:26px;font-weight:600;line-height:1.1;letter-spacing:-.01em}+.lockup .sub{font-size:13px;line-height:1.3;opacity:.62;margin-top:3px}++/* ---------- panel mock ---------- */++.mocks{display:grid;grid-template-columns:repeat(auto-fit,minmax(320px,1fr));gap:20px}++.panel{+ border-radius:12px;+ overflow:hidden;+ display:grid;+ grid-template-columns:58px minmax(0,1fr);+ font-size:13px;+ border:1px solid;+ min-height:400px;+}+.panel.dark{+ background:#14181E;border-color:#2F3945;color:#E9EEF5;+ --p-surface:#1C222B;--p-line:#2F3945;--p-muted:#9BA8B9;--p-raised:#232A34;+ --p-brand:#3FC3D6;--p-glass:rgba(28,34,43,.72);--p-glass-line:rgba(255,255,255,.07);+ --mk-ink:#E9EEF5;--mk-brand:#3FC3D6;+ --mk-ink-wash:rgba(233,238,245,.16);--mk-brand-wash:rgba(63,195,214,.20);+}+.panel.light{+ background:#F2F5F8;border-color:#D3DAE3;color:#18202C;+ --p-surface:#FFFFFF;--p-line:#D3DAE3;--p-muted:#5B6676;--p-raised:#E9EEF4;+ --p-brand:#0091A7;--p-glass:rgba(255,255,255,.72);--p-glass-line:rgba(16,24,40,.08);+ --mk-ink:#E9EEF5;--mk-brand:#3FC3D6;+ --mk-ink-wash:rgba(233,238,245,.16);--mk-brand-wash:rgba(63,195,214,.20);+}++/* the rail is dark in both themes */+.rail{+ background:#141B24;+ display:grid;+ grid-template-rows:58px repeat(6,44px) 1fr;+ gap:6px;+ padding:8px;+ border-right:1px solid rgba(255,255,255,.07);+}+.rail .brandcell{display:grid;place-items:center;gap:4px}+.rail .amb{font-size:10px;font-weight:600;letter-spacing:.06em;color:#C9D4E2}+.rail .nav{+ position:relative;+ display:grid;place-items:center;+ border-radius:8px;+ font-size:13px;font-weight:600;+ color:#C9D4E2;+ background:transparent;+ border:0;+ font-family:inherit;+}+.rail .nav.on{background:rgba(63,195,214,.14);color:#E9EEF5}+.rail .nav.on::before{+ content:"";position:absolute;left:-8px;top:9px;bottom:9px;width:2px;+ background:#3FC3D6;border-radius:0 2px 2px 0;+}++.appcol{display:grid;grid-template-rows:auto minmax(0,1fr);min-width:0}+.topbar{+ display:flex;align-items:center;justify-content:space-between;gap:10px;+ padding:12px 14px;+ background:var(--p-glass);+ border-bottom:1px solid var(--p-line);+ backdrop-filter:blur(14px) saturate(140%);+ -webkit-backdrop-filter:blur(14px) saturate(140%);+}+.topbar h3{margin:0;font-size:18px;font-weight:650;line-height:1.2}+.topbar .sub{margin:3px 0 0;font-size:12px;color:var(--p-muted)}+.pill{+ display:inline-flex;align-items:center;gap:7px;+ padding:5px 11px;border-radius:999px;+ background:var(--p-raised);border:1px solid var(--p-line);+ font-size:12px;color:var(--p-muted);white-space:nowrap;+}+.pill .dot{width:8px;height:8px;border-radius:50%;background:#3FCB8B}+.panel.light .pill .dot{background:#127A4B}++.cards{display:grid;gap:10px;align-content:start;padding:14px}+.card{+ background:var(--p-surface);+ border:1px solid var(--p-line);+ border-radius:8px;+ padding:11px 12px;+}+.panel.light .card{box-shadow:0 1px 2px rgba(16,24,40,.08)}+.card .head{display:flex;align-items:center;justify-content:space-between;gap:10px}+.card h4{margin:0;font-size:14px;font-weight:600;line-height:1.3}+.card p{margin:6px 0 0;font-size:12.5px;line-height:1.45;color:var(--p-muted)}+.card .acts{display:flex;gap:8px;margin-top:10px}+.btn{+ font-family:inherit;font-size:12.5px;+ padding:6px 11px;border-radius:6px;+ border:1px solid var(--p-line);+ background:var(--p-surface);color:inherit;+}+.btn.primary{background:var(--p-brand);border-color:var(--p-brand);color:#06222A;font-weight:600}+.panel.light .btn.primary{color:#FFFFFF}++/* ---------- badges ---------- */++.badge{+ display:inline-block;+ border-radius:999px;+ padding:3px 9px;+ font-size:11px;font-weight:600;letter-spacing:.01em;+ text-transform:capitalize;+ border:1px solid transparent;+ white-space:nowrap;+}+.badgerow{display:flex;flex-wrap:wrap;gap:8px;align-items:center}++.on-light .badge{color:#fff}+.on-light .badge.error{background:#C23B2E}+.on-light .badge.warning{background:#A45F0B}+.on-light .badge.info{background:#2457C5}+.on-light .badge.success{background:#127A4B}+.on-light .badge.pending{background:#6D3FB8}+.on-light .badge.idle{background:#5B6676}++.on-dark .badge.error{background:rgba(240,121,107,.14);border-color:rgba(240,121,107,.40);color:#F0796B}+.on-dark .badge.warning{background:rgba(242,166,60,.14);border-color:rgba(242,166,60,.40);color:#F2A63C}+.on-dark .badge.info{background:rgba(127,166,245,.14);border-color:rgba(127,166,245,.40);color:#7FA6F5}+.on-dark .badge.success{background:rgba(63,203,139,.14);border-color:rgba(63,203,139,.40);color:#3FCB8B}+.on-dark .badge.pending{background:rgba(183,154,240,.14);border-color:rgba(183,154,240,.40);color:#B79AF0}+.on-dark .badge.idle{background:rgba(155,168,185,.14);border-color:rgba(155,168,185,.40);color:#9BA8B9}++/* the pending fix, shown as it was vs as it is */+.fix{+ display:grid;grid-template-columns:repeat(auto-fit,minmax(230px,1fr));+ gap:14px;margin-top:20px;+}+.fix .col{border:1px solid var(--rule);border-radius:10px;padding:14px 15px}+.fix .col h5{margin:0 0 4px;font-size:12.5px;font-weight:600}+.fix .col small{display:block;color:var(--faint);font-size:11.5px;line-height:1.45;margin-bottom:12px}+.fix .was{background:#64748b;color:#fff;border-radius:999px;padding:3px 9px;font-size:11px;font-weight:600;display:inline-block}+.fix .col.now{border-color:rgba(63,195,214,.35)}++/* ---------- tool icons ---------- */++.ico{display:block}+.ico .fi{fill:var(--ic-ink-wash);stroke:none}+.ico .fa{fill:var(--ic-wash);stroke:none}+.ico .sa{fill:var(--ic);stroke:none}+.ico .st{fill:none;stroke-linecap:round;stroke-linejoin:round}+.ico .st.k{stroke:var(--ic-ink)}+.ico .st.a{stroke:var(--ic)}++.iconwall{display:grid;grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:18px}+.icell{display:flex;flex-direction:column;align-items:center;gap:11px;padding:16px 8px;border-radius:10px}+.icell .pair{display:flex;align-items:flex-end;gap:14px;min-height:34px}+.icell .nm{font-size:12px;font-weight:600;text-align:center}+.icell .tk{+ font-size:10.5px;opacity:.6;text-align:center;+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;+}+.ribbon.dark{background:#2F3338;border:1px solid #3C4249}+.ribbon.light{background:#F0F0F0;border:1px solid #D8D8D8;color:#18202C}++.tier{margin:0 0 14px;font-size:12.5px;color:var(--faint)}++/* ---------- token table ---------- */++.tablewrap{overflow-x:auto;-webkit-overflow-scrolling:touch}+table{border-collapse:collapse;width:100%;min-width:480px;font-size:12.5px}+thead th{+ text-align:left;font-weight:600;font-size:11.5px;color:var(--faint);+ padding:0 10px 9px 0;border-bottom:1px solid var(--rule);+}+tbody td{padding:9px 10px 9px 0;border-bottom:1px solid var(--rule-soft);vertical-align:middle}+tbody tr:last-child td{border-bottom:0}+.tname{font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;font-size:11.5px;white-space:nowrap}+.sw{display:inline-flex;align-items:center;gap:9px;white-space:nowrap}+.sw i{width:17px;height:17px;border-radius:5px;display:inline-block;border:1px solid rgba(255,255,255,.14);flex:none}+.sw code{+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;+ font-size:11.5px;color:var(--muted);font-style:normal;+}+td.role{color:var(--faint)}++/* ---------- type ---------- */+.typerow{display:grid;grid-template-columns:auto minmax(0,1fr);gap:6px 22px;align-items:baseline}+.typerow .lab{+ font-size:11px;color:var(--faint);white-space:nowrap;+ font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;+}++footer{padding:38px 0 0;color:var(--faint);font-size:12.5px;max-width:64ch}+footer code{font-family:ui-monospace,"Cascadia Mono",Consolas,monospace;color:var(--muted)}++@media (max-width:760px){+ .hero{grid-template-columns:minmax(0,1fr);gap:32px;padding:36px 0 44px}+ .hero svg{max-width:100%}+ section{grid-template-columns:minmax(0,1fr);gap:18px;padding:34px 0}+ .mocks{grid-template-columns:minmax(0,1fr)}+ .iconwall{grid-template-columns:repeat(auto-fill,minmax(120px,1fr))}+ .sizes{gap:22px}+}+@media (max-width:420px){+ .sheet{padding:0 14px 72px}+ .chips{grid-template-columns:minmax(0,1fr)}+ .fix{grid-template-columns:minmax(0,1fr)}+ .titleblock{gap:6px 18px}+}+</style>+</head>+<body>+<div class="sheet">++ <div class="titleblock">+ <span class="doc">AEC Model Bridge — design review</span>+ <span class="bit"><b>Sheet</b> 1 of 1</span>+ <span class="bit"><b>Spec</b> docs/design/tokens.md</span>+ <span class="bit"><b>Status</b> proposed, awaiting approval</span>+ </div>++ <!-- ================= HERO ================= -->+ <div class="hero">+ <svg class="mark" viewBox="-26 -10 152 116" width="456" height="348" role="img"+ aria-label="The Span: two nodes joined by a deck, with a triangular apex above them">+ <g class="annot">+ <line x1="-20" y1="72.5" x2="120" y2="72.5"/>+ <line x1="50" y1="0" x2="50" y2="82"/>+ <line x1="33" y1="45" x2="33" y2="70"/>+ <line x1="67" y1="45" x2="67" y2="70"/>+ <line class="tick" x1="36.5" y1="57.8" x2="44" y2="57.8"/>+ <line class="tick" x1="56" y1="57.8" x2="63.5" y2="57.8"/>+ <line class="tick" x1="19" y1="72.5" x2="28.9" y2="82.4"/>+ <circle cx="50" cy="8.5" r="1.15"/>+ <circle cx="81" cy="72.5" r="1.15"/>+ <text x="-24" y="69.2">y 0.725</text>+ <text x="-24" y="63.5">deck</text>+ <text x="52.2" y="-1.4">x 0.500</text>+ <text x="33.5" y="91.6">r 0.140</text>+ <text x="122" y="99" text-anchor="end">node 0.810, 0.725</text>+ <text x="55.5" y="7.4">apex 0.500, 0.085</text>+ <text x="50" y="59.6" text-anchor="middle">0.340</text>+ </g>+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>++ <div>+ <h1>The Span</h1>+ <p class="tag">One mark, sixteen colors, one icon grammar.</p>+ <p class="lede">+ A span, drawn flat. The <b>two nodes are the model and the agent</b>;+ the <b>apex above them is this product</b>. Deck and nodes are drawn in+ ink because they already exist — the apex is the only thing painted in+ brand color, because it is the only thing the bridge adds.+ </p>+ <p class="lede">+ Nothing draws a line from the nodes up to the apex. They are tied+ together by <b>alignment</b>: the apex base and the deck are both+ exactly 0.340 wide and sit on the same two axes. Connector lines were+ drawn five different ways and every one of them turned the mark into a+ capital A.+ </p>+ <p class="lede">+ It is the <b>Connect</b> icon already shipping in the ribbon,+ reproportioned and promoted. Circles and straight lines only, which is+ what lets SVG, WPF and CSS each reproduce it exactly — something the+ three different shaded cubes it replaces never managed.+ </p>+ </div>+ </div>++ <!-- ================= SIZES ================= -->+ <section>+ <div class="margin">+ <h2>The sizes it ships at</h2>+ <p>16 and 32 px on the Revit ribbon, 26 px in the panel nav rail,+ ~300 px in the README lockup.</p>+ <p>One geometry at every size. Nothing is dropped or re-tuned for small+ sizes, so there is no optical-size variant to keep in sync across three+ renderers by hand.</p>+ <p>Only the stroke changes: <code>size × 0.06</code>, snapped to half a+ pixel, floor 1.5 px — the arithmetic+ <code>IconGenerator.StrokeWidth</code> already does.</p>+ </div>+ <div class="body">+ <div class="chips">++ <div class="chip dark">+ <div class="sizes">+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="9.4">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">16</span>+ </div>+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="26" height="26" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="5.8">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">26</span>+ </div>+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">32</span>+ </div>+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="96" height="96" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">96</span>+ </div>+ </div>+ <div class="cap">Dark — Revit dark theme, GitHub dark README, panel dark</div>+ </div>++ <div class="chip light">+ <div class="sizes">+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="9.4">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">16</span>+ </div>+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="26" height="26" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="5.8">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">26</span>+ </div>+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">32</span>+ </div>+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="96" height="96" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">96</span>+ </div>+ </div>+ <div class="cap">Light — Revit light theme, GitHub light README, panel light</div>+ </div>++ </div>+ </div>+ </section>++ <!-- ================= WHY NO CONNECTORS ================= -->+ <section>+ <div class="margin">+ <h2>Why nothing connects the apex</h2>+ <p>The brief's motif has lines running from each node up to the apex. Drawn+ literally, they extend the apex's own legs and the deck becomes a+ crossbar.</p>+ <p>Five variants, all the same outcome. The alignment of the apex base to+ the deck says “these belong together” without spelling the letter.</p>+ </div>+ <div class="body">+ <div class="chips">+ <div class="chip dark" style="--mk-brand:#F0796B;--mk-brand-wash:rgba(240,121,107,.20)">+ <div class="sizes">+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="96" height="96" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 65.5,43 34.5,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="13"/>+ <circle class="w-ink" cx="81" cy="72.5" r="13"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="32" y1="72.5" x2="68" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="13"/>+ <circle class="ink" cx="81" cy="72.5" r="13"/>+ <line class="br" x1="25.1" y1="61" x2="34.5" y2="43"/>+ <line class="br" x1="74.9" y1="61" x2="65.5" y2="43"/>+ <polygon class="br" points="50,8.5 65.5,43 34.5,43"/>+ </g>+ </svg>+ <span class="px">rejected</span>+ </div>+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 65.5,43 34.5,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="13"/>+ <circle class="w-ink" cx="81" cy="72.5" r="13"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="32" y1="72.5" x2="68" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="13"/>+ <circle class="ink" cx="81" cy="72.5" r="13"/>+ <line class="br" x1="25.1" y1="61" x2="34.5" y2="43"/>+ <line class="br" x1="74.9" y1="61" x2="65.5" y2="43"/>+ <polygon class="br" points="50,8.5 65.5,43 34.5,43"/>+ </g>+ </svg>+ <span class="px">32</span>+ </div>+ </div>+ <div class="cap">With connectors — it is a letter, not a mark</div>+ </div>++ <div class="chip dark">+ <div class="sizes">+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="96" height="96" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">adopted</span>+ </div>+ <div class="spec">+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="px">32</span>+ </div>+ </div>+ <div class="cap">Tied by alignment — 0.340 shared by deck and apex base</div>+ </div>+ </div>+ </div>+ </section>++ <!-- ================= LOCKUP ================= -->+ <section>+ <div class="margin">+ <h2>The lockup</h2>+ <p>What replaces the cube-plus-“AEC / BRIDGE” in <code>assets/logo.svg</code>.</p>+ <p>Segoe UI at weight 600, sentence case, no tracking. The mark carries the+ identity; the wordmark only says the name.</p>+ </div>+ <div class="body">+ <div class="chips">+ <div class="chip dark">+ <div class="lockup">+ <svg class="mark" viewBox="0 0 100 100" width="72" height="72" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <div>+ <div class="name">AEC Model Bridge</div>+ <div class="sub">Model context for Revit</div>+ </div>+ </div>+ <div class="cap">Dark README</div>+ </div>+ <div class="chip light">+ <div class="lockup">+ <svg class="mark" viewBox="0 0 100 100" width="72" height="72" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <div>+ <div class="name">AEC Model Bridge</div>+ <div class="sub">Model context for Revit</div>+ </div>+ </div>+ <div class="cap">Light README</div>+ </div>+ </div>+ </div>+ </section>++ <!-- ================= PANEL MOCK ================= -->+ <section>+ <div class="margin">+ <h2>The panel</h2>+ <p>Same markup the panel ships today — 58 px rail, 64 px topbar, card list —+ repainted with these tokens and the mark dropped into the rail in place+ of the gradient square.</p>+ <p>The rail stays dark in both themes. It is the product's spine, and it is+ the one place the brand indicator lives.</p>+ <p>Rail and topbar are the only translucent surfaces. Cards stay opaque —+ glass behind body text is a legibility tax.</p>+ </div>+ <div class="body">+ <div class="mocks">++ <!-- dark -->+ <div class="panel dark on-dark">+ <div class="rail">+ <div class="brandcell">+ <svg class="mark" viewBox="0 0 100 100" width="26" height="26" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="5.8">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="amb">AMB</span>+ </div>+ <div class="nav">C</div>+ <div class="nav">P</div>+ <div class="nav on">F</div>+ <div class="nav">R</div>+ <div class="nav">L</div>+ <div class="nav">S</div>+ </div>+ <div class="appcol">+ <div class="topbar">+ <div>+ <h3>Findings</h3>+ <p class="sub">4 findings in Level 2 — Structure</p>+ </div>+ <span class="pill"><span class="dot"></span>Hub connected</span>+ </div>+ <div class="cards">+ <div class="card">+ <div class="head">+ <h4>Wall joins unmitred</h4>+ <span class="badge error">error</span>+ </div>+ <p>Six walls on grid C meet without a mitre. Corners will render open in section.</p>+ <div class="acts"><button class="btn">Select in Revit</button></div>+ </div>+ <div class="card">+ <div class="head">+ <h4>Rooms unbounded</h4>+ <span class="badge warning">warning</span>+ </div>+ <p>Two rooms on Level 2 have no bounding element and report zero area.</p>+ </div>+ <div class="card">+ <div class="head">+ <h4>Rename 14 door types</h4>+ <span class="badge pending">pending</span>+ </div>+ <p>Waiting on your approval before anything is written to the model.</p>+ <div class="acts">+ <button class="btn primary">Approve</button>+ <button class="btn">Reject</button>+ </div>+ </div>+ </div>+ </div>+ </div>++ <!-- light -->+ <div class="panel light on-light">+ <div class="rail">+ <div class="brandcell">+ <svg class="mark" viewBox="0 0 100 100" width="26" height="26" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="5.8">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <span class="amb">AMB</span>+ </div>+ <div class="nav">C</div>+ <div class="nav">P</div>+ <div class="nav on">F</div>+ <div class="nav">R</div>+ <div class="nav">L</div>+ <div class="nav">S</div>+ </div>+ <div class="appcol">+ <div class="topbar">+ <div>+ <h3>Findings</h3>+ <p class="sub">4 findings in Level 2 — Structure</p>+ </div>+ <span class="pill"><span class="dot"></span>Hub connected</span>+ </div>+ <div class="cards">+ <div class="card">+ <div class="head">+ <h4>Wall joins unmitred</h4>+ <span class="badge error">error</span>+ </div>+ <p>Six walls on grid C meet without a mitre. Corners will render open in section.</p>+ <div class="acts"><button class="btn">Select in Revit</button></div>+ </div>+ <div class="card">+ <div class="head">+ <h4>Rooms unbounded</h4>+ <span class="badge warning">warning</span>+ </div>+ <p>Two rooms on Level 2 have no bounding element and report zero area.</p>+ </div>+ <div class="card">+ <div class="head">+ <h4>Rename 14 door types</h4>+ <span class="badge pending">pending</span>+ </div>+ <p>Waiting on your approval before anything is written to the model.</p>+ <div class="acts">+ <button class="btn primary">Approve</button>+ <button class="btn">Reject</button>+ </div>+ </div>+ </div>+ </div>+ </div>++ </div>+ </div>+ </section>++ <!-- ================= BADGES ================= -->+ <section>+ <div class="margin">+ <h2>Severity</h2>+ <p>One set of six, shared by the ribbon icons and the panel badges. Solid+ fill on light, 14 % tint with a hairline on dark.</p>+ <p>Every light fill clears 4.5:1 against its own white label. The amber+ shipping today does not — it measures 3.6:1.</p>+ <p>Sentence case, not caps. Uppercase at 11 px costs legibility on a word+ like “warning” and the pill shape already says “status”.</p>+ </div>+ <div class="body">+ <div class="chips">+ <div class="chip light on-light">+ <div class="badgerow">+ <span class="badge error">error</span>+ <span class="badge warning">warning</span>+ <span class="badge info">info</span>+ <span class="badge success">success</span>+ <span class="badge pending">pending</span>+ <span class="badge idle">idle</span>+ </div>+ <div class="cap">Light</div>+ </div>+ <div class="chip dark on-dark">+ <div class="badgerow">+ <span class="badge error">error</span>+ <span class="badge warning">warning</span>+ <span class="badge info">info</span>+ <span class="badge success">success</span>+ <span class="badge pending">pending</span>+ <span class="badge idle">idle</span>+ </div>+ <div class="cap">Dark</div>+ </div>+ </div>++ <div class="fix">+ <div class="col">+ <h5>Pending today, in the panel</h5>+ <small>Slate grey <code>#64748b</code>. Grey is the universal signal+ for “nothing to do here”, on the one state that blocks everything+ until you act.</small>+ <span class="was">PENDING</span>+ </div>+ <div class="col">+ <h5>Pending today, on the ribbon</h5>+ <small>Violet <code>#7B1FA2</code>. Same concept, unrelated colour,+ drawn by a different file.</small>+ <span class="badge" style="background:#7B1FA2;color:#fff;border-color:#7B1FA2">pending</span>+ </div>+ <div class="col now">+ <h5>Resolved: violet, both surfaces</h5>+ <small>The ribbon was right. <code>--amb-pending</code> is+ <code>#6D3FB8</code> light and <code>#B79AF0</code> dark, and the+ grey moves to <code>--amb-idle</code> for states that really are+ inert.</small>+ <span class="badgerow on-dark" style="display:inline-flex">+ <span class="badge pending">pending</span>+ <span class="badge idle">idle</span>+ </span>+ </div>+ </div>+ </div>+ </section>++ <!-- ================= ICONS ================= -->+ <section>+ <div class="margin">+ <h2>Icon grammar</h2>+ <p>Structure is ink. One accent, and only if the icon reports a state.</p>+ <p>Five state icons carry a semantic colour. Four action icons carry none —+ ink strokes, ink-tinted interiors. That is what makes a ribbon scannable+ instead of eight unrelated stickers.</p>+ <p>Brand cyan appears on the mark and nowhere else in the ribbon, which is+ what makes the brand button findable.</p>+ </div>+ <div class="body">++ <p class="tier">State — the icon reports a condition</p>+ <div class="iconwall">++ <!-- Connect: monochrome success -->+ <div class="icell ribbon dark" style="--ic:#3FCB8B;--ic-ink:#3FCB8B;--ic-wash:rgba(63,203,139,.20);--ic-ink-wash:rgba(63,203,139,.20)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <polygon class="fa" points="50,8.5 67,43 33,43"/>+ <circle class="fi" cx="19" cy="72.5" r="14"/>+ <circle class="fi" cx="81" cy="72.5" r="14"/>+ <g class="st a" stroke-width="9.4">+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle cx="19" cy="72.5" r="14"/>+ <circle cx="81" cy="72.5" r="14"/>+ <polygon points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <polygon class="fa" points="50,8.5 67,43 33,43"/>+ <circle class="fi" cx="19" cy="72.5" r="14"/>+ <circle class="fi" cx="81" cy="72.5" r="14"/>+ <g class="st a" stroke-width="6.25">+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle cx="19" cy="72.5" r="14"/>+ <circle cx="81" cy="72.5" r="14"/>+ <polygon points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ </div>+ <div class="nm">Connect</div>+ <div class="tk">--amb-success</div>+ </div>++ <!-- Disconnect: monochrome danger + slash -->+ <div class="icell ribbon dark" style="--ic:#F0796B;--ic-ink:#F0796B;--ic-wash:rgba(240,121,107,.20);--ic-ink-wash:rgba(240,121,107,.20)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <polygon class="fa" points="50,8.5 67,43 33,43"/>+ <circle class="fi" cx="19" cy="72.5" r="14"/>+ <circle class="fi" cx="81" cy="72.5" r="14"/>+ <g class="st a" stroke-width="9.4">+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle cx="19" cy="72.5" r="14"/>+ <circle cx="81" cy="72.5" r="14"/>+ <polygon points="50,8.5 67,43 33,43"/>+ </g>+ <g class="st a" stroke-width="12.5">+ <line x1="30" y1="29" x2="70" y2="69"/>+ </g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <polygon class="fa" points="50,8.5 67,43 33,43"/>+ <circle class="fi" cx="19" cy="72.5" r="14"/>+ <circle class="fi" cx="81" cy="72.5" r="14"/>+ <g class="st a" stroke-width="6.25">+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle cx="19" cy="72.5" r="14"/>+ <circle cx="81" cy="72.5" r="14"/>+ <polygon points="50,8.5 67,43 33,43"/>+ </g>+ <g class="st a" stroke-width="7.8">+ <line x1="30" y1="29" x2="70" y2="69"/>+ </g>+ </svg>+ </div>+ <div class="nm">Disconnect</div>+ <div class="tk">--amb-danger</div>+ </div>++ <!-- Status: ink + info -->+ <div class="icell ribbon dark" style="--ic:#7FA6F5;--ic-ink:#E9EEF5;--ic-wash:rgba(127,166,245,.20);--ic-ink-wash:rgba(233,238,245,.16)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <circle class="fa" cx="73" cy="72" r="14"/>+ <g class="st k" stroke-width="9.4">+ <rect x="7" y="7" width="86" height="86" rx="9"/>+ <line x1="19" y1="32" x2="58" y2="32"/>+ <line x1="19" y1="53" x2="50" y2="53"/>+ </g>+ <g class="st a" stroke-width="9.4"><circle cx="73" cy="72" r="14"/></g>+ <circle class="sa" cx="73" cy="72" r="5.5"/>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <circle class="fa" cx="73" cy="72" r="14"/>+ <g class="st k" stroke-width="6.25">+ <rect x="7" y="7" width="86" height="86" rx="9"/>+ <line x1="19" y1="32" x2="58" y2="32"/>+ <line x1="19" y1="53" x2="50" y2="53"/>+ </g>+ <g class="st a" stroke-width="6.25"><circle cx="73" cy="72" r="14"/></g>+ <circle class="sa" cx="73" cy="72" r="5.5"/>+ </svg>+ </div>+ <div class="nm">Status</div>+ <div class="tk">--amb-info</div>+ </div>++ <!-- Health: ink + warning -->+ <div class="icell ribbon dark" style="--ic:#F2A63C;--ic-ink:#E9EEF5;--ic-wash:rgba(242,166,60,.20);--ic-ink-wash:rgba(233,238,245,.16)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <g class="st k" stroke-width="9.4">+ <rect x="20" y="12" width="60" height="78" rx="6"/>+ <rect x="38" y="5" width="24" height="11" rx="3"/>+ </g>+ <g class="st a" stroke-width="11"><polyline points="32,53 45,66 70,36"/></g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <g class="st k" stroke-width="6.25">+ <rect x="20" y="12" width="60" height="78" rx="6"/>+ <rect x="38" y="5" width="24" height="11" rx="3"/>+ </g>+ <g class="st a" stroke-width="9"><polyline points="32,53 45,66 70,36"/></g>+ </svg>+ </div>+ <div class="nm">Health</div>+ <div class="tk">--amb-warning</div>+ </div>++ <!-- Pending: ink + pending -->+ <div class="icell ribbon dark" style="--ic:#B79AF0;--ic-ink:#E9EEF5;--ic-wash:rgba(183,154,240,.20);--ic-ink-wash:rgba(233,238,245,.16)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <circle class="fa" cx="73" cy="74" r="21"/>+ <g class="st k" stroke-width="10">+ <line x1="10" y1="22" x2="62" y2="22"/>+ <line x1="10" y1="42" x2="54" y2="42"/>+ <line x1="10" y1="62" x2="42" y2="62"/>+ </g>+ <g class="st a" stroke-width="8.6">+ <circle cx="73" cy="74" r="21"/>+ <line x1="73" y1="74" x2="73" y2="62.5"/>+ <line x1="73" y1="74" x2="82.5" y2="76.1"/>+ </g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <circle class="fa" cx="73" cy="74" r="21"/>+ <g class="st k" stroke-width="7">+ <line x1="10" y1="22" x2="62" y2="22"/>+ <line x1="10" y1="42" x2="54" y2="42"/>+ <line x1="10" y1="62" x2="42" y2="62"/>+ </g>+ <g class="st a" stroke-width="5.5">+ <circle cx="73" cy="74" r="21"/>+ <line x1="73" y1="74" x2="73" y2="62.5"/>+ <line x1="73" y1="74" x2="82.5" y2="76.1"/>+ </g>+ </svg>+ </div>+ <div class="nm">Pending</div>+ <div class="tk">--amb-pending</div>+ </div>++ </div>++ <p class="tier" style="margin-top:26px">Action — no condition, so no accent</p>+ <div class="iconwall">++ <!-- Settings: ink only -->+ <div class="icell ribbon dark" style="--ic:#E9EEF5;--ic-ink:#E9EEF5;--ic-wash:rgba(233,238,245,.16);--ic-ink-wash:rgba(233,238,245,.16)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <g class="st k" stroke-width="9.4">+ <circle cx="50" cy="50" r="12"/>+ <circle cx="50" cy="50" r="30"/>+ </g>+ <g class="st k" stroke-width="11">+ <line x1="80" y1="50" x2="91" y2="50"/>+ <line x1="65" y1="75.98" x2="70.5" y2="85.51"/>+ <line x1="35" y1="75.98" x2="29.5" y2="85.51"/>+ <line x1="20" y1="50" x2="9" y2="50"/>+ <line x1="35" y1="24.02" x2="29.5" y2="14.49"/>+ <line x1="65" y1="24.02" x2="70.5" y2="14.49"/>+ </g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <g class="st k" stroke-width="6.25">+ <circle cx="50" cy="50" r="12"/>+ <circle cx="50" cy="50" r="30"/>+ </g>+ <g class="st k" stroke-width="8">+ <line x1="80" y1="50" x2="91" y2="50"/>+ <line x1="65" y1="75.98" x2="70.5" y2="85.51"/>+ <line x1="35" y1="75.98" x2="29.5" y2="85.51"/>+ <line x1="20" y1="50" x2="9" y2="50"/>+ <line x1="35" y1="24.02" x2="29.5" y2="14.49"/>+ <line x1="65" y1="24.02" x2="70.5" y2="14.49"/>+ </g>+ </svg>+ </div>+ <div class="nm">Settings</div>+ <div class="tk">ink only</div>+ </div>++ <!-- Panel: ink only -->+ <div class="icell ribbon dark" style="--ic:#E9EEF5;--ic-ink:#E9EEF5;--ic-wash:rgba(233,238,245,.16);--ic-ink-wash:rgba(233,238,245,.16)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <rect class="fi" x="63" y="9" width="28" height="82"/>+ <g class="st k" stroke-width="9.4">+ <rect x="7" y="7" width="86" height="86" rx="9"/>+ <line x1="17" y1="30" x2="53" y2="30"/>+ <line x1="17" y1="50" x2="46" y2="50"/>+ </g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <rect class="fi" x="63" y="9" width="28" height="82"/>+ <g class="st k" stroke-width="6.25">+ <rect x="7" y="7" width="86" height="86" rx="9"/>+ <line x1="17" y1="30" x2="53" y2="30"/>+ <line x1="17" y1="50" x2="46" y2="50"/>+ </g>+ </svg>+ </div>+ <div class="nm">Panel</div>+ <div class="tk">ink only</div>+ </div>++ <!-- Reports: ink only -->+ <div class="icell ribbon dark" style="--ic:#E9EEF5;--ic-ink:#E9EEF5;--ic-wash:rgba(233,238,245,.16);--ic-ink-wash:rgba(233,238,245,.16)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <g class="fi">+ <rect x="15" y="58" width="17" height="28"/>+ <rect x="41.5" y="40" width="17" height="46"/>+ <rect x="68" y="22" width="17" height="64"/>+ </g>+ <g class="st k" stroke-width="9.4">+ <rect x="15" y="58" width="17" height="28"/>+ <rect x="41.5" y="40" width="17" height="46"/>+ <rect x="68" y="22" width="17" height="64"/>+ </g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <g class="fi">+ <rect x="15" y="58" width="17" height="28"/>+ <rect x="41.5" y="40" width="17" height="46"/>+ <rect x="68" y="22" width="17" height="64"/>+ </g>+ <g class="st k" stroke-width="5">+ <rect x="15" y="58" width="17" height="28"/>+ <rect x="41.5" y="40" width="17" height="46"/>+ <rect x="68" y="22" width="17" height="64"/>+ </g>+ <g class="st k" stroke-width="6.25"><line x1="10" y1="86" x2="90" y2="86"/></g>+ </svg>+ </div>+ <div class="nm">Reports</div>+ <div class="tk">ink only</div>+ </div>+++ </div>++ <p class="tier" style="margin-top:26px">The mark — brand cyan, and nothing else in the ribbon has it</p>+ <div class="iconwall">+ <div class="icell ribbon dark" style="--mk-ink:#E9EEF5;--mk-brand:#3FC3D6;--mk-ink-wash:rgba(233,238,245,.16);--mk-brand-wash:rgba(63,195,214,.20)">+ <div class="pair">+ <svg class="mark" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="9.4">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <svg class="mark" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <polygon class="w-brand" points="50,8.5 67,43 33,43"/>+ <circle class="w-ink" cx="19" cy="72.5" r="14"/>+ <circle class="w-ink" cx="81" cy="72.5" r="14"/>+ <g class="s" stroke-width="6.25">+ <line class="ink" x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle class="ink" cx="19" cy="72.5" r="14"/>+ <circle class="ink" cx="81" cy="72.5" r="14"/>+ <polygon class="br" points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ </div>+ <div class="nm">Brand</div>+ <div class="tk">--amb-brand</div>+ </div>++ </div>++ <p class="tier" style="margin-top:26px">The same five state icons on a light Revit ribbon</p>+ <div class="iconwall">+ <div class="icell ribbon light" style="--ic:#127A4B;--ic-ink:#127A4B;--ic-wash:rgba(18,122,75,.20);--ic-ink-wash:rgba(18,122,75,.20)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <polygon class="fa" points="50,8.5 67,43 33,43"/>+ <circle class="fi" cx="19" cy="72.5" r="14"/>+ <circle class="fi" cx="81" cy="72.5" r="14"/>+ <g class="st a" stroke-width="9.4">+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle cx="19" cy="72.5" r="14"/>+ <circle cx="81" cy="72.5" r="14"/>+ <polygon points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <polygon class="fa" points="50,8.5 67,43 33,43"/>+ <circle class="fi" cx="19" cy="72.5" r="14"/>+ <circle class="fi" cx="81" cy="72.5" r="14"/>+ <g class="st a" stroke-width="6.25">+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle cx="19" cy="72.5" r="14"/>+ <circle cx="81" cy="72.5" r="14"/>+ <polygon points="50,8.5 67,43 33,43"/>+ </g>+ </svg>+ </div>+ <div class="nm">Connect</div>+ <div class="tk">#127A4B</div>+ </div>++ <div class="icell ribbon light" style="--ic:#C23B2E;--ic-ink:#C23B2E;--ic-wash:rgba(194,59,46,.20);--ic-ink-wash:rgba(194,59,46,.20)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <polygon class="fa" points="50,8.5 67,43 33,43"/>+ <circle class="fi" cx="19" cy="72.5" r="14"/>+ <circle class="fi" cx="81" cy="72.5" r="14"/>+ <g class="st a" stroke-width="9.4">+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle cx="19" cy="72.5" r="14"/>+ <circle cx="81" cy="72.5" r="14"/>+ <polygon points="50,8.5 67,43 33,43"/>+ </g>+ <g class="st a" stroke-width="12.5">+ <line x1="30" y1="29" x2="70" y2="69"/>+ </g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <polygon class="fa" points="50,8.5 67,43 33,43"/>+ <circle class="fi" cx="19" cy="72.5" r="14"/>+ <circle class="fi" cx="81" cy="72.5" r="14"/>+ <g class="st a" stroke-width="6.25">+ <line x1="33" y1="72.5" x2="67" y2="72.5"/>+ <circle cx="19" cy="72.5" r="14"/>+ <circle cx="81" cy="72.5" r="14"/>+ <polygon points="50,8.5 67,43 33,43"/>+ </g>+ <g class="st a" stroke-width="7.8">+ <line x1="30" y1="29" x2="70" y2="69"/>+ </g>+ </svg>+ </div>+ <div class="nm">Disconnect</div>+ <div class="tk">#C23B2E</div>+ </div>++ <div class="icell ribbon light" style="--ic:#2457C5;--ic-ink:#18202C;--ic-wash:rgba(36,87,197,.20);--ic-ink-wash:rgba(24,32,44,.12)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <circle class="fa" cx="73" cy="72" r="14"/>+ <g class="st k" stroke-width="9.4">+ <rect x="7" y="7" width="86" height="86" rx="9"/>+ <line x1="19" y1="32" x2="58" y2="32"/>+ <line x1="19" y1="53" x2="50" y2="53"/>+ </g>+ <g class="st a" stroke-width="9.4"><circle cx="73" cy="72" r="14"/></g>+ <circle class="sa" cx="73" cy="72" r="5.5"/>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <circle class="fa" cx="73" cy="72" r="14"/>+ <g class="st k" stroke-width="6.25">+ <rect x="7" y="7" width="86" height="86" rx="9"/>+ <line x1="19" y1="32" x2="58" y2="32"/>+ <line x1="19" y1="53" x2="50" y2="53"/>+ </g>+ <g class="st a" stroke-width="6.25"><circle cx="73" cy="72" r="14"/></g>+ <circle class="sa" cx="73" cy="72" r="5.5"/>+ </svg>+ </div>+ <div class="nm">Status</div>+ <div class="tk">#2457C5</div>+ </div>++ <div class="icell ribbon light" style="--ic:#A45F0B;--ic-ink:#18202C;--ic-wash:rgba(164,95,11,.20);--ic-ink-wash:rgba(24,32,44,.12)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <g class="st k" stroke-width="9.4">+ <rect x="20" y="12" width="60" height="78" rx="6"/>+ <rect x="38" y="5" width="24" height="11" rx="3"/>+ </g>+ <g class="st a" stroke-width="11"><polyline points="32,53 45,66 70,36"/></g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <g class="st k" stroke-width="6.25">+ <rect x="20" y="12" width="60" height="78" rx="6"/>+ <rect x="38" y="5" width="24" height="11" rx="3"/>+ </g>+ <g class="st a" stroke-width="9"><polyline points="32,53 45,66 70,36"/></g>+ </svg>+ </div>+ <div class="nm">Health</div>+ <div class="tk">#A45F0B</div>+ </div>++ <div class="icell ribbon light" style="--ic:#6D3FB8;--ic-ink:#18202C;--ic-wash:rgba(109,63,184,.20);--ic-ink-wash:rgba(24,32,44,.12)">+ <div class="pair">+ <svg class="ico" viewBox="0 0 100 100" width="16" height="16" aria-hidden="true">+ <circle class="fa" cx="73" cy="74" r="21"/>+ <g class="st k" stroke-width="10">+ <line x1="10" y1="22" x2="62" y2="22"/>+ <line x1="10" y1="42" x2="54" y2="42"/>+ <line x1="10" y1="62" x2="42" y2="62"/>+ </g>+ <g class="st a" stroke-width="8.6">+ <circle cx="73" cy="74" r="21"/>+ <line x1="73" y1="74" x2="73" y2="62.5"/>+ <line x1="73" y1="74" x2="82.5" y2="76.1"/>+ </g>+ </svg>+ <svg class="ico" viewBox="0 0 100 100" width="32" height="32" aria-hidden="true">+ <circle class="fa" cx="73" cy="74" r="21"/>+ <g class="st k" stroke-width="7">+ <line x1="10" y1="22" x2="62" y2="22"/>+ <line x1="10" y1="42" x2="54" y2="42"/>+ <line x1="10" y1="62" x2="42" y2="62"/>+ </g>+ <g class="st a" stroke-width="5.5">+ <circle cx="73" cy="74" r="21"/>+ <line x1="73" y1="74" x2="73" y2="62.5"/>+ <line x1="73" y1="74" x2="82.5" y2="76.1"/>+ </g>+ </svg>+ </div>+ <div class="nm">Pending</div>+ <div class="tk">#6D3FB8</div>+ </div>+ </div>++ </div>+ </section>++ <!-- ================= COLOR ================= -->+ <section>+ <div class="margin">+ <h2>Sixteen tokens</h2>+ <p>Down from the twenty-two unrelated hexes spread across+ <code>logo.svg</code>, <code>IconGenerator.cs</code> and+ <code>styles.css</code> today.</p>+ <p>Brand cyan is the one saturated family no semantic token occupies, so+ the brand can never be misread as a status. It is deliberately not+ Autodesk's <code>#0696D7</code> — the panel is a guest inside Revit,+ not a part of it.</p>+ </div>+ <div class="body">+ <div class="tablewrap">+ <table>+ <thead>+ <tr><th>Token</th><th>Light</th><th>Dark</th><th>Role</th></tr>+ </thead>+ <tbody>+ <tr><td class="tname">--amb-ink</td>+ <td><span class="sw"><i style="background:#18202C"></i><code>#18202C</code></span></td>+ <td><span class="sw"><i style="background:#E9EEF5"></i><code>#E9EEF5</code></span></td>+ <td class="role">Text; every icon's structural stroke</td></tr>+ <tr><td class="tname">--amb-ink-muted</td>+ <td><span class="sw"><i style="background:#5B6676"></i><code>#5B6676</code></span></td>+ <td><span class="sw"><i style="background:#9BA8B9"></i><code>#9BA8B9</code></span></td>+ <td class="role">Secondary text, metadata</td></tr>+ <tr><td class="tname">--amb-bg</td>+ <td><span class="sw"><i style="background:#F2F5F8"></i><code>#F2F5F8</code></span></td>+ <td><span class="sw"><i style="background:#14181E"></i><code>#14181E</code></span></td>+ <td class="role">App background</td></tr>+ <tr><td class="tname">--amb-surface</td>+ <td><span class="sw"><i style="background:#FFFFFF"></i><code>#FFFFFF</code></span></td>+ <td><span class="sw"><i style="background:#1C222B"></i><code>#1C222B</code></span></td>+ <td class="role">Cards, topbar, inputs</td></tr>+ <tr><td class="tname">--amb-surface-raised</td>+ <td><span class="sw"><i style="background:#E9EEF4"></i><code>#E9EEF4</code></span></td>+ <td><span class="sw"><i style="background:#232A34"></i><code>#232A34</code></span></td>+ <td class="role">Pills, hovered rows</td></tr>+ <tr><td class="tname">--amb-line</td>+ <td><span class="sw"><i style="background:#D3DAE3"></i><code>#D3DAE3</code></span></td>+ <td><span class="sw"><i style="background:#2F3945"></i><code>#2F3945</code></span></td>+ <td class="role">1 px borders and dividers</td></tr>+ <tr><td class="tname">--amb-rail</td>+ <td><span class="sw"><i style="background:#141B24"></i><code>#141B24</code></span></td>+ <td><span class="sw"><i style="background:#141B24"></i><code>#141B24</code></span></td>+ <td class="role">Nav rail — dark in both themes</td></tr>+ <tr><td class="tname">--amb-rail-ink</td>+ <td><span class="sw"><i style="background:#C9D4E2"></i><code>#C9D4E2</code></span></td>+ <td><span class="sw"><i style="background:#C9D4E2"></i><code>#C9D4E2</code></span></td>+ <td class="role">Rail label and inactive glyph</td></tr>+ <tr><td class="tname">--amb-brand</td>+ <td><span class="sw"><i style="background:#0091A7"></i><code>#0091A7</code></span></td>+ <td><span class="sw"><i style="background:#3FC3D6"></i><code>#3FC3D6</code></span></td>+ <td class="role">Mark apex; focus ring; active nav</td></tr>+ <tr><td class="tname">--amb-brand-strong</td>+ <td><span class="sw"><i style="background:#046B80"></i><code>#046B80</code></span></td>+ <td><span class="sw"><i style="background:#6FD8E6"></i><code>#6FD8E6</code></span></td>+ <td class="role">Brand-coloured text and links</td></tr>+ <tr><td class="tname">--amb-danger</td>+ <td><span class="sw"><i style="background:#C23B2E"></i><code>#C23B2E</code></span></td>+ <td><span class="sw"><i style="background:#F0796B"></i><code>#F0796B</code></span></td>+ <td class="role">Error finding; disconnected</td></tr>+ <tr><td class="tname">--amb-warning</td>+ <td><span class="sw"><i style="background:#A45F0B"></i><code>#A45F0B</code></span></td>+ <td><span class="sw"><i style="background:#F2A63C"></i><code>#F2A63C</code></span></td>+ <td class="role">Warning finding; health check</td></tr>+ <tr><td class="tname">--amb-info</td>+ <td><span class="sw"><i style="background:#2457C5"></i><code>#2457C5</code></span></td>+ <td><span class="sw"><i style="background:#7FA6F5"></i><code>#7FA6F5</code></span></td>+ <td class="role">Info finding; status readout</td></tr>+ <tr><td class="tname">--amb-success</td>+ <td><span class="sw"><i style="background:#127A4B"></i><code>#127A4B</code></span></td>+ <td><span class="sw"><i style="background:#3FCB8B"></i><code>#3FCB8B</code></span></td>+ <td class="role">Connected; passed; approved</td></tr>+ <tr><td class="tname">--amb-pending</td>+ <td><span class="sw"><i style="background:#6D3FB8"></i><code>#6D3FB8</code></span></td>+ <td><span class="sw"><i style="background:#B79AF0"></i><code>#B79AF0</code></span></td>+ <td class="role">Awaiting a human decision</td></tr>+ <tr><td class="tname">--amb-idle</td>+ <td><span class="sw"><i style="background:#5B6676"></i><code>#5B6676</code></span></td>+ <td><span class="sw"><i style="background:#9BA8B9"></i><code>#9BA8B9</code></span></td>+ <td class="role">Inert: not run yet, disabled, n/a</td></tr>+ </tbody>+ </table>+ </div>+ </div>+ </section>++ <!-- ================= TYPE ================= -->+ <section>+ <div class="margin">+ <h2>Type</h2>+ <p>Segoe UI stays, for everything, and this is now a decision rather than+ an accident.</p>+ <p>The panel is a docked pane inside Revit. A webfont would flash on every+ open and would make the product look like a web page embedded in Revit+ instead of a part of it. The distinctiveness budget is spent on the mark+ and the icon grammar.</p>+ </div>+ <div class="body">+ <div class="typerow">+ <span class="lab">18 / 650</span>+ <span style="font-size:18px;font-weight:650;line-height:1.2">Findings</span>+ <span class="lab">14 / 600</span>+ <span style="font-size:14px;font-weight:600;line-height:1.3">Wall joins unmitred</span>+ <span class="lab">13 / 400</span>+ <span style="font-size:13px;line-height:1.45">Six walls on grid C meet without a mitre. Corners will render open in section.</span>+ <span class="lab">12 / 400</span>+ <span style="font-size:12px;line-height:1.45;color:var(--muted)">4 findings in Level 2 — Structure</span>+ <span class="lab">11 / 400</span>+ <span style="font-size:11px;line-height:1.4;color:var(--faint);font-variant-numeric:tabular-nums">14:02:11 · health check complete</span>+ <span class="lab">11 / 600</span>+ <span class="on-dark"><span class="badge pending">pending</span></span>+ <span class="lab">10 / 600</span>+ <span style="font-size:10px;font-weight:600;letter-spacing:.06em;color:var(--muted)">AMB</span>+ </div>+ <p style="margin:22px 0 0;font-size:12.5px;color:var(--faint);max-width:62ch">+ Sentence case for all UI strings. <code style="font-family:ui-monospace,Consolas,monospace">font-variant-numeric: tabular-nums</code>+ on the run log, finding counts and timestamps, so columns of numbers stop+ shifting as they update.+ </p>+ </div>+ </section>++ <footer>+ Every value on this sheet is written out in <code>docs/design/tokens.md</code>+ and hand-copied from there into <code>assets/logo.svg</code>,+ <code>packages/revit-bridge-addin/src/UI/IconGenerator.cs</code> and+ <code>panel/styles.css</code>, each under a+ <code>// keep in sync with docs/design/tokens.md</code> comment. There is no+ token build step, on purpose.+ </footer>++</div>+</body>+</html>diff --git a/docs/design/tokens.md b/docs/design/tokens.mdnew file mode 100644index 0000000..be83f6f--- /dev/null+++ b/docs/design/tokens.md@@ -0,0 +1,545 @@+# AEC Model Bridge — design tokens++Status: **proposed**, pending maintainer approval.+Scope: the brand mark, the color system, typography, and the ribbon icon+grammar for `assets/logo.svg`, `packages/revit-bridge-addin/src/UI/IconGenerator.cs`,+and `panel/styles.css`.++This file is the single source of truth. There is **no codegen and no token+sync tool** — that is deliberate (ADR-free decision for a solo maintainer with+no bundler in `panel/`). Every value below is hand-copied into the three+renderers, and each copy site carries the comment:++```+// keep in sync with docs/design/tokens.md+```++Companion file: `docs/design/review.html` — open it in a browser to see every+token on this page rendered at real size.++---++## 1. What is being replaced++| Today | Problem |+| --- | --- |+| `assets/logo.svg` — isometric cube + "AEC / BRIDGE" text | Cube #1 |+| `IconGenerator.CreateBrandIcon()` — a *different* isometric cube, gradient-shaded | Cube #2, disagrees with cube #1 |+| `panel/styles.css` `.brand-mark` — a 3-color gradient square | Not a cube at all; disagrees with both |+| 9 ribbon icons, 8 unrelated accent hues | No system; nothing means anything |+| `pending` = violet on the ribbon, grey in `.badge.pending` | Same concept, two colors |++All five are replaced by **one mark** and **one palette** below.++---++## 2. The mark — "the Span"++### 2.1 Concept++A span, drawn flat: **two anchor nodes joined by a deck, and the bridge itself+standing above them.** It is the existing `CreateConnectIcon()` motif promoted+to primary mark — the same three parts, reproportioned and resolved.++- **Two anchor nodes** joined by a **deck** — the model and the agent, the two+ things being connected.+- **One apex** above them — the bridge process.++Four shapes: one line, two circles, one triangle. No gradients, no shading, no+3D. That is what makes it reproducible to the pixel in SVG, WPF+`DrawingVisual` and CSS, which the cube never was.++**The apex is not tied to the nodes by drawn lines.** It is tied to them by+alignment: the apex's base edge and the deck are both exactly `0.340` wide and+sit on the same two vertical axes, `x = 0.330` and `x = 0.670`. One module,+stated twice. Drawn connector lines were tried in five variants and every one+of them turned the mark into a capital **A** — the connector continues the+apex's own leg, and the deck becomes the crossbar. Alignment says the same+thing and stays a mark.++### 2.2 Geometry — exact++All coordinates are fractions of a `size × size` box, same convention as+`IconGenerator.cs` (multiply by `size`). Origin top-left, y grows downward.++| # | Element | Geometry | Stroke | Fill |+| --- | --- | --- | --- | --- |+| 1 | Apex wash | closed polygon `(0.500, 0.085)` → `(0.670, 0.430)` → `(0.330, 0.430)` | none | brand wash |+| 2 | Node wash, left | circle center `(0.190, 0.725)`, r `0.140` | none | ink wash |+| 3 | Node wash, right | circle center `(0.810, 0.725)`, r `0.140` | none | ink wash |+| 4 | Deck | line `(0.330, 0.725)` → `(0.670, 0.725)` | **ink** | — |+| 5 | Node, left | circle center `(0.190, 0.725)`, r `0.140` | **ink** | none |+| 6 | Node, right | circle center `(0.810, 0.725)`, r `0.140` | **ink** | none |+| 7 | Apex | closed polygon `(0.500, 0.085)` → `(0.670, 0.430)` → `(0.330, 0.430)` | **brand** | none |++Draw in the order given (1 → 7). Rows 1–3 are unstroked fills painted first;+rows 4–7 are unfilled strokes painted on top. Rows 1 and 7 are the same+polygon, once filled and once stroked — in SVG that is a single `<polygon>`+with both `fill` and `stroke`; the two rows are split here only because WPF+`DrawGeometry(fill, pen, geo)` and CSS take them separately.++The same geometry is used at **every** size, 16 px to 300 px. There is no+optical-size variant to keep in sync across three renderers.++Relationships worth preserving if anyone ever nudges this:++- Node edge `0.190 + 0.140 = 0.330` — the deck starts exactly where the left+ node ends, and ends exactly where the right node begins.+- Apex base spans `0.330 → 0.670`, the same `0.340` module as the deck.+- Ink extents: `x 0.020 → 0.980`, `y 0.055 → 0.895` at `stroke = 0.06`. Optical+ center `y ≈ 0.475`, deliberately a touch above the box center because the+ figure is top-heavy.++### 2.3 Stroke++```+stroke = clamp( round(size × 0.06 × 2) / 2 , min 1.5 , ∞ )+```++Snapped to half a pixel, floor 1.5 px. This is exactly the existing+`IconGenerator.StrokeWidth(size, 0.06)` contract — do not change that helper.++| size | stroke |+| --- | --- |+| 16 | 1.5 |+| 24 | 1.5 |+| 32 | 2.0 |+| 48 | 3.0 |+| 96 | 6.0 |+| 300 | 18.0 |++Caps: **round**. Joins: **round**. (Same as today.)++### 2.4 Paint++Two-tone. The **deck and nodes are ink** — the model and the agent, the things+that already exist. The **apex is brand** — the bridge, the only thing this+product adds. That split is the reason the mark is not just a triangle, and it+is what tells the brand mark apart from the monochrome Connect icon two+buttons away on the same ribbon.++| Part | Light theme | Dark theme |+| --- | --- | --- |+| Deck, node strokes | `--amb-ink` `#18202C` | `--amb-ink` `#E9EEF5` |+| Node wash fill | `rgba(24, 32, 44, 0.12)` | `rgba(233, 238, 245, 0.16)` |+| Apex stroke | `--amb-brand` `#0091A7` | `--amb-brand` `#3FC3D6` |+| Apex wash fill | `rgba(0, 145, 167, 0.20)` | `rgba(63, 195, 214, 0.20)` |++The ink wash is lighter than the accent wash on purpose. A near-white fill at+`0.20` over a dark surface turns the nodes into solid discs and the deck reads+as a strike-through; a near-black fill at `0.20` over white is just as heavy.+Accent hues are mid-luminance and take `0.20` in both themes.++**Monochrome variant** (favicon, disabled state, single-color print, and the+Connect / Disconnect icons): every stroke in one color, every wash in that+color at `0.20`.++### 2.5 Wordmark lockup — for `assets/logo.svg` and the README++```+viewBox="0 0 560 168"+```++| Item | Placement |+| --- | --- |+| Mark | `size = 120`, translated to `(24, 24)` — i.e. mark box occupies `x 24…144`, `y 24…144` |+| "AEC Model Bridge" | Segoe UI, weight 600, `font-size: 46`, `letter-spacing: 0`, `fill: #18202C`, baseline at `x = 188, y = 88` |+| "Model context for Revit" | Segoe UI, weight 400, `font-size: 19`, `letter-spacing: 0.2`, `fill: #5B6676`, baseline at `x = 190, y = 120` |++- Sentence case. No tracked-out caps, no em-dash fragments.+- Clear space on all sides: **≥ 0.25 × mark size** (30 px at the lockup scale).+- Minimum reproduction size of the mark alone: **16 px**. Minimum for the full+ lockup: **180 px** wide.+- `assets/logo.svg` ships the **light-theme** paint and adds+ `@media (prefers-color-scheme: dark)` inside its `<style>` block so it also+ reads on GitHub's dark README.+- The isometric cube polygons and the `AEC` / `BRIDGE` text in the current file+ are deleted outright — not recolored.++### 2.6 Panel rail mark (`panel/styles.css` `.brand-mark`)++Replace the three stacked `linear-gradient()`s with the mark as an inline+`<svg>` in `panel/index.html` (26 × 26, two-tone, dark-rail paint).+Do **not** try to rebuild the mark out of CSS gradients — that is how the+third inconsistent mark happened.++---++## 3. Color++### 3.1 Reading the table++Every token resolves to one value under the light theme and one under the dark+theme, exactly like the existing `@media (prefers-color-scheme: dark)` block in+`panel/styles.css`. On the ribbon, `IconGenerator.IsDarkTheme()` already makes+the same choice.++Contrast figures are measured against that theme's `--amb-surface`+(`#FFFFFF` / `#1C222B`), or against white for the solid badge fills.++### 3.2 Neutrals — the structure++| Token | Light | Dark | Role |+| --- | --- | --- | --- |+| `--amb-ink` | `#18202C` | `#E9EEF5` | Primary text; every icon's structural stroke |+| `--amb-ink-muted` | `#5B6676` | `#9BA8B9` | Secondary text, metadata, inactive icon |+| `--amb-bg` | `#F2F5F8` | `#14181E` | App background |+| `--amb-surface` | `#FFFFFF` | `#1C222B` | Cards, topbar, inputs |+| `--amb-surface-raised` | `#E9EEF4` | `#232A34` | Pills, hovered rows, segmented controls |+| `--amb-line` | `#D3DAE3` | `#2F3945` | 1 px borders and dividers |+| `--amb-rail` | `#141B24` | `#141B24` | Nav rail — **dark in both themes**, as today |+| `--amb-rail-ink` | `#C9D4E2` | `#C9D4E2` | Nav rail label and inactive glyph |++Measured: ink 16.4:1 light / 13.7:1 dark. Muted 5.8:1 light / 6.7:1 dark.++`--amb-ink` light is `#18202C`, the value already in `panel/styles.css`.+Kept on purpose — it is correct, and continuity beats novelty for neutrals.++### 3.3 Brand++| Token | Light | Dark | Role |+| --- | --- | --- | --- |+| `--amb-brand` | `#0091A7` | `#3FC3D6` | Mark apex; focus ring; active nav indicator |+| `--amb-brand-strong` | `#046B80` | `#6FD8E6` | Brand-colored **text** and links; primary button hover |+| `--amb-brand-wash` | `rgba(0, 145, 167, 0.14)` | `rgba(63, 195, 214, 0.14)` | Tinted brand surfaces |++Measured: `--amb-brand` 3.8:1 on white, 4.2:1 on `#1C222B` — above the 3:1+floor for graphics in both themes, which is why one hue serves both.+`--amb-brand-strong` 5.6:1 / 9.7:1 — safe for text.++**Why this hue.** It is the one saturated family that no semantic token below+occupies, so the brand never gets read as a status. It is also the color of an+instrument readout — displacement plots, point-cloud intensity, total-station+displays — which is the vernacular this product actually lives in. It is+deliberately *not* Autodesk's `#0696D7`: the panel is a guest inside Revit, not+a part of it.++**Primary buttons.** `panel/styles.css` currently paints the submit/save+buttons with `--blue` (`#2563eb`), which is now the *info* token. Repaint them+with `--amb-brand` (light) / `--amb-brand` (dark) and white / `#06222A` label+respectively.++### 3.4 Semantic — shared by ribbon icons and panel badges++| Token | Light | Dark | Meaning |+| --- | --- | --- | --- |+| `--amb-danger` | `#C23B2E` | `#F0796B` | Error finding; disconnected; destructive action |+| `--amb-warning` | `#A45F0B` | `#F2A63C` | Warning finding; health check; degraded |+| `--amb-info` | `#2457C5` | `#7FA6F5` | Info finding; status readout; report |+| `--amb-success` | `#127A4B` | `#3FCB8B` | Connected; passed; approved |+| `--amb-pending` | `#6D3FB8` | `#B79AF0` | Awaiting a human decision |+| `--amb-idle` | `#5B6676` | `#9BA8B9` | Inert: not run yet, disabled, n/a |++Measured against white (the solid badge label color), light column:+danger 5.3:1, warning 5.0:1, info 6.5:1, success 5.4:1, pending 6.8:1,+idle 5.8:1. All pass AA for 11 px text.+Measured against `#1C222B`, dark column: 5.8 / 7.9 / 6.6 / 7.7 / 6.8 / 6.7.++> The current `.badge.warning` uses `#b7791f`, which is **3.6:1 against its own+> white label** — it fails AA today. `#A45F0B` is the fix, not a restyle.++### 3.5 The `pending` mismatch — resolved++**`pending` is violet. `#6D3FB8` light, `#B79AF0` dark. Both surfaces.**++- `IconGenerator.CreatePendingIcon()`: `#7B1FA2` → `--amb-pending`.+- `panel/styles.css` `.badge.pending`: `#64748b` → `--amb-pending`.++The ribbon was right and the panel was wrong. `pending` in this product means+"a plan is sitting in the approval queue and nothing moves until you act"+(ADR 0008). That is the single most action-required state in the app, and grey+is the universal signal for *ignore me*. A grey approval queue is a queue+nobody empties.++Violet, not amber or red, because nothing is wrong — it is held, not failing.+Violet is also the only semantic hue with no other job in this palette.++The vacated grey is **not** deleted. It becomes `--amb-idle` and now has a real+job: states that genuinely are inert — a health check that has never run, a+disabled nav item, an unavailable provider.++**Implementer note for Task 7:** `panel/app.js` `renderPlans()` hardcodes+`class="badge pending"` while printing `plan.status` as the label, so a plan+whose status is `approved` currently renders a violet "approved" badge. Map the+status string to a token class (`approved` → `success`, `rejected` → `danger`,+`pending`/anything else → `pending`) at the same time.++### 3.6 Badge treatment++Light theme — solid fill, white label:++```css+.badge { border-radius: 999px; padding: 3px 9px; font-size: 11px;+ font-weight: 600; letter-spacing: 0.01em;+ text-transform: capitalize; color: #fff; }+.badge.error { background: #C23B2E; }+.badge.warning { background: #A45F0B; }+.badge.info { background: #2457C5; }+.badge.success { background: #127A4B; }+.badge.pending { background: #6D3FB8; }+.badge.idle { background: #5B6676; }+```++Dark theme — 14 % tint, 40 % hairline, lifted label:++```css+.badge.error { background: rgba(240,121,107,.14); border: 1px solid rgba(240,121,107,.40); color: #F0796B; }+.badge.warning { background: rgba(242,166, 60,.14); border: 1px solid rgba(242,166, 60,.40); color: #F2A63C; }+.badge.info { background: rgba(127,166,245,.14); border: 1px solid rgba(127,166,245,.40); color: #7FA6F5; }+.badge.success { background: rgba( 63,203,139,.14); border: 1px solid rgba( 63,203,139,.40); color: #3FCB8B; }+.badge.pending { background: rgba(183,154,240,.14); border: 1px solid rgba(183,154,240,.40); color: #B79AF0; }+.badge.idle { background: rgba(155,168,185,.14); border: 1px solid rgba(155,168,185,.40); color: #9BA8B9; }+```++The 14 % tint is the largest value that still leaves the lifted label at+≥ 4.5:1 over the tinted surface (measured 4.7:1 for the tightest case, danger).+Do not raise it.++Add `border: 1px solid transparent` to the base `.badge` rule so the box does+not resize between themes.++`text-transform` changes from `uppercase` to `capitalize`. Uppercase at 11 px+costs real legibility on words like "warning" and buys nothing; the pill shape+already marks it as a status.++### 3.6.1 Alpha washes++| Name | Alpha | Hex byte (WPF `Color.FromArgb`) | Used for |+| --- | --- | --- | --- |+| wash | `0.14` | `0x24` (36) | Badge tints, tinted panel surfaces |+| wash-strong | `0.20` | `0x33` (51) | Accent interior fills in icons and the mark |+| wash-ink | `0.12` light / `0.16` dark | `0x1F` (31) / `0x29` (41) | Ink interior fills in icons and the mark |++Only these two. The current icons use four different alphas (`32`, `64`, `90`,+and opaque) — that is part of what makes the ribbon look assembled rather than+designed.++### 3.7 Surface treatment — the glassmorphism the ADR promised++ADR 0011 §4 committed to "sleek dark mode default, subtle micro-animations,+glassmorphism card layouts". Delivering that means exactly two translucent+surfaces — the rail and the topbar — not translucent everything.++```css+/* dark */+--amb-glass: rgba(28, 34, 43, 0.72);+--amb-glass-line: rgba(255, 255, 255, 0.07);+--amb-glass-filter: blur(14px) saturate(140%);++/* light */+--amb-glass: rgba(255, 255, 255, 0.72);+--amb-glass-line: rgba(16, 24, 40, 0.08);+--amb-glass-filter: blur(14px) saturate(120%);+```++Applied to `.rail` and `.topbar` only. Cards, inputs and list rows stay opaque+— glass behind body text is a legibility tax with no benefit.++Elevation:++```css+/* light */ --amb-shadow-1: 0 1px 2px rgba(16,24,40,.08);+ --amb-shadow-2: 0 6px 16px rgba(16,24,40,.10);+/* dark */ --amb-shadow-1: 0 1px 0 rgba(255,255,255,.04) inset;+ --amb-shadow-2: 0 1px 0 rgba(255,255,255,.04) inset, 0 10px 28px rgba(0,0,0,.45);+```++Radius: `4` chips · `6` buttons, inputs, selects · `8` cards, alerts, messages ·+`10` the rail mark plate · `999` pills and badges.++Spacing scale (px): `4 · 6 · 8 · 12 · 16 · 24 · 32`.++Focus ring — one rule, everywhere, replacing the current+`button:hover { border-color: … }` as the only visible affordance:++```css+:focus-visible { outline: none;+ box-shadow: 0 0 0 2px var(--amb-bg), 0 0 0 4px var(--amb-brand); }+```++Motion:++```css+--amb-motion-fast: 120ms cubic-bezier(.4, 0, .2, 1); /* hover, press */+--amb-motion-view: 180ms cubic-bezier(.2, .7, .3, 1); /* view switch */+@media (prefers-reduced-motion: reduce) { * { animation: none !important; transition: none !important; } }+```++---++## 4. Typography++**Decision: keep `"Segoe UI", system-ui, sans-serif` for everything.**+Recorded explicitly so it stops being an accident.++One family, no display face, no webfont. The panel is a docked pane inside+Revit; a loaded webfont would flash on every panel open and would make the app+look like a web page embedded in Revit rather than a part of it. Distinctiveness+is spent on the mark and the icon grammar instead.++| Role | Size | Weight | Line height | Notes |+| --- | --- | --- | --- | --- |+| View title (`h1`) | 18 px | 650 | 1.2 | Unchanged from today |+| Card title (`h2`) | 14 px | 600 | 1.3 | |+| Body | 13 px | 400 | 1.45 | |+| Secondary / detail | 12 px | 400 | 1.45 | `--amb-ink-muted` |+| Metadata, timestamps | 11 px | 400 | 1.4 | `--amb-ink-muted` |+| Badge | 11 px | 600 | 1 | `letter-spacing: .01em`, capitalize |+| Rail label ("AMB") | 10 px | 600 | 1 | `letter-spacing: .06em` |++Additional rules:++- Sentence case for all UI strings. No tracked-out all-caps eyebrow labels.+- `font-variant-numeric: tabular-nums` on the run log, finding counts, and any+ timestamp, so columns of numbers stop shifting.+- Body copy caps at ~72 characters per line; the panel is narrow enough that+ this only affects the settings view.+- The wordmark is the same family at weight 600 — the mark carries the+ identity, the wordmark just says the name.++---++## 5. Icon system++### 5.1 The grammar — one rule for all nine++> **Structure is ink. One accent, and only if the icon reports a state.**++Every icon is drawn with `--amb-ink` strokes. Then:++- **State icons** — the icon reports a condition the user should scan for —+ get exactly one element in a semantic color.+- **Action icons** — the icon is a verb with no condition attached — get+ **no accent at all**. Ink only, with interiors filled at wash-ink.++That is the whole system. It is why the ribbon currently looks like eight+unrelated stickers: eight icons, eight hues, none of them meaning anything. A+ribbon where only the five state icons are colored is scannable at a glance.++Brand cyan appears on the brand mark and nowhere else in the ribbon, which is+what makes the brand button findable.++Shared across all icons: stroke per §2.3 (`size × 0.06`), round caps, round+joins, interiors at wash-strong / wash-ink (§3.6.1), `IsDarkTheme()` picks the+theme column.++### 5.2 Re-targeting table — Task 6 follows this directly++| # | `IconGenerator` method | Tier | Structure | Accent token | Accent light / dark | Was |+| --- | --- | --- | --- | --- | --- | --- |+| 1 | `CreateConnectIcon` | state | *mono — accent* | `--amb-success` | `#127A4B` / `#3FCB8B` | `#2E7D32` emerald |+| 2 | `CreateDisconnectIcon` | state | *mono — accent* | `--amb-danger` | `#C23B2E` / `#F0796B` | `#D32F2F` crimson |+| 3 | `CreateStatusIcon` | state | `--amb-ink` | `--amb-info` | `#2457C5` / `#7FA6F5` | `#0288D1` "Autodesk blue" |+| 4 | `CreateSettingsIcon` | action | `--amb-ink` | **none** | — | already ink-only |+| 5 | `CreateHelpIcon` | action | `--amb-ink` | **none** | — | `#009688` teal — dropped |+| 6 | `CreatePanelIcon` | action | `--amb-ink` | **none** | — | `#3F51B5` indigo — dropped |+| 7 | `CreateHealthIcon` | state | `--amb-ink` | `--amb-warning` | `#A45F0B` / `#F2A63C` | `#F57C00` amber |+| 8 | `CreatePendingIcon` | state | `--amb-ink` | `--amb-pending` | `#6D3FB8` / `#B79AF0` | `#7B1FA2` violet |+| 9 | `CreateReportsIcon` | action | `--amb-ink` | **none** | — | `#1976D2` blue — dropped |+| — | `CreateBrandIcon` | mark | `--amb-ink` | `--amb-brand` | `#0091A7` / `#3FC3D6` | gradient cube — deleted |++Nine icons, nine explicit assignments, no gaps.++### 5.3 Per-icon notes++**1 · Connect** — becomes the mark of §2.2, drawn **monochrome in+`--amb-success`**: every stroke green, both washes green at `0.20`. Being+monochrome is what keeps it distinct from the two-tone brand mark sitting a+few buttons away on the same ribbon.++**2 · Disconnect** — identical to Connect but monochrome in `--amb-danger`,+plus a **single** cancel slash `(0.300, 0.290) → (0.700, 0.690)`, stroke+`size × 0.08`, round caps, same danger color. One slash, not a cross — a cross+over a triangle is mush at 16 px, and the single diagonal already reads as+“not connected”. Drop the broken-connector treatment; the slash is the signal.++**3 · Status** — geometry unchanged. Frame, both grid lines and the outer ring+go to `--amb-ink`; the inner pulse dot (`r = 0.055`, filled) and its `r = 0.14`+ring stay accented, now `--amb-info`, ring fill at wash-strong.++**4 · Settings** — geometry and paint unchanged. It was already correct; it is+the reference for the action tier.++**5 · Help** — remove the teal balloon fill and the teal stroke. Circle stroked+in ink, filled at wash-ink; the `?` glyph in ink. Segoe UI Bold at+`size × 0.54`, as today.++**6 · Panel** — remove the indigo. Frame and content rows in ink; the docked+right-hand strip filled at wash-ink with an ink stroke.++**7 · Health** — clipboard body, clip tab and rows in ink; **the checkmark** is+the accent, `--amb-warning`. Warning rather than success because the tool's job+is to surface problems, and a permanently green check implies a result the+button has not produced yet.++**8 · Pending** — the three queue rows in ink; **the clock badge** (ring, fill,+both hands) in `--amb-pending`, fill at wash-strong. This is the ribbon half of+the §3.5 fix.++While you are in there, fix the clipping: the badge is currently centred at+`(0.74, 0.76)` with `r = 0.23`, so its bottom edge lands at `0.99` and the+stroke is cut off by the bitmap boundary at every size. Move it to+`(0.730, 0.740)` with `r = 0.210`; hands then run to `(0.730, 0.6245)` and+`(0.825, 0.761)`.++**9 · Reports** — remove the blue. All three bars filled at wash-ink with ink+strokes, baseline in ink. The tinted fills keep it from reading hollow.++**Brand** — the two-tone mark of §2.2/§2.4, identical at every size. Delete+the gradient-cube code entirely.++### 5.4 Panel nav rail glyphs++`panel/index.html` renders the six nav items as single letters+(`C P F R L S`). Leave them as letters — swapping in six new glyphs is a+separate piece of work and is not covered by this token set. Style only:++- inactive: `--amb-rail-ink`, weight 600, 13 px+- hover: `--amb-ink` `#E9EEF5` on `rgba(255,255,255,.08)`+- active: `--amb-ink` `#E9EEF5` on `rgba(63,195,214,.14)` plus a 2 px+ `--amb-brand` bar on the rail's inner edge, radius 0 2px 2px 0++---++## 6. Copy-site checklist for Tasks 5–7++| Task | File | Uses |+| --- | --- | --- |+| 5 | `assets/logo.svg` | §2.2 geometry, §2.4 light paint + dark media query, §2.5 lockup |+| 6 | `packages/revit-bridge-addin/src/UI/IconGenerator.cs` | §2.2–2.4 for `CreateBrandIcon`/`CreateConnectIcon`/`CreateDisconnectIcon`, §3.2–3.4 hexes, §3.6.1 alpha bytes, §5.2 table, §5.3 notes |+| 7 | `panel/styles.css`, `panel/index.html`, `panel/app.js` | §2.6 inline rail mark, §3.2–3.7 all tokens, §3.5 badge fix + `renderPlans()` status mapping, §4 type scale, §5.4 rail glyph styling |++Each of the three files gets a `// keep in sync with docs/design/tokens.md`+comment at the top of the block that carries copied values.++---++## 7. Full value index++```+--amb-ink #18202C #E9EEF5+--amb-ink-muted #5B6676 #9BA8B9+--amb-bg #F2F5F8 #14181E+--amb-surface #FFFFFF #1C222B+--amb-surface-raised #E9EEF4 #232A34+--amb-line #D3DAE3 #2F3945+--amb-rail #141B24 #141B24+--amb-rail-ink #C9D4E2 #C9D4E2+--amb-brand #0091A7 #3FC3D6+--amb-brand-strong #046B80 #6FD8E6+--amb-danger #C23B2E #F0796B+--amb-warning #A45F0B #F2A63C+--amb-info #2457C5 #7FA6F5+--amb-success #127A4B #3FCB8B+--amb-pending #6D3FB8 #B79AF0+--amb-idle #5B6676 #9BA8B9+--amb-on-brand #FFFFFF #06222A+wash 0.14 (0x24)+wash-strong 0.20 (0x33) accent fills+wash-ink 0.12 / 0.16 (0x1F / 0x29) ink fills+```++Seventeen tokens. Retired: `#2E7D32`, `#D32F2F`, `#0288D1`, `#009688`, `#3F51B5`,+`#F57C00`, `#7B1FA2`, `#1976D2`, `#00BCD4`, `#2196F3`, `#1565C0`, `#00695C`,+`#64748b`, `#b7791f`, `#c2413a`, `#0f8a5f`, `#2563eb`, `#14b8a6`, `#8b5cf6`,+`#60a5fa`, `#93c5fd`, `#3b82f6`.