quickdbd-cli 0.1.13__tar.gz → 0.1.15__tar.gz

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/NOTICE

@@ -16,7 +16,8 @@ This product bundles third-party components, distributed unmodified:
 
 The demo gallery (gallery/, not part of the Python package) includes schemas derived from:
 
-* Northwind and AdventureWorks (gallery/northwind, gallery/adventureworks), converted from
+* Northwind, pubs, AdventureWorks and AdventureWorks DW (gallery/northwind, gallery/pubs,
+  gallery/adventureworks, gallery/adventureworks-dw), converted from
   microsoft/sql-server-samples. Copyright (c) Microsoft Corporation. MIT License.
 * Sakila (gallery/sakila), converted from sakila-schema.sql. Copyright (c) 2006, 2026, Oracle and/or
   its affiliates. BSD-3-Clause.

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: quickdbd-cli
-Version: 0.1.13
+Version: 0.1.15
 Summary: Compile QuickDBD-syntax schema files into interactive HTML ER diagrams, with no table limit.
 Project-URL: Homepage, https://github.com/MarkPhamm/quickdbd-cli
 Author: Minh (Mark) Pham
@@ -77,7 +77,7 @@ Every demo is a single HTML page written by `qdbd build`, from a QuickDBD schema
 | [![200 tables](https://raw.githubusercontent.com/MarkPhamm/quickdbd-cli/main/docs/assets/img/gallery/synthetic.png)](https://qdbd.dev/demo/synthetic/)<br>**[200 tables](https://qdbd.dev/demo/synthetic/)**<br>Five business domains, 200 tables and every relationship type. Search, filter, click a table to focus it. | [![Schema diff](https://raw.githubusercontent.com/MarkPhamm/quickdbd-cli/main/docs/assets/img/gallery/diff.png)](https://qdbd.dev/demo/diff/)<br>**[Schema diff](https://qdbd.dev/demo/diff/)**<br>What a branch changed, coloured in: new tables in green, changed columns in amber, removals listed. |
 | [![AdventureWorks](https://raw.githubusercontent.com/MarkPhamm/quickdbd-cli/main/docs/assets/img/gallery/adventureworks.png)](https://qdbd.dev/demo/adventureworks/)<br>**[AdventureWorks](https://qdbd.dev/demo/adventureworks/)**<br>Microsoft's bicycle-company OLTP database: 68 tables in five schemas, one region each, with column descriptions. | [![OMOP CDM on Synthea](https://raw.githubusercontent.com/MarkPhamm/quickdbd-cli/main/docs/assets/img/gallery/synthea.png)](https://qdbd.dev/demo/synthea/#t=concept)<br>**[OMOP CDM on Synthea](https://qdbd.dev/demo/synthea/#t=concept)**<br>OHDSI's dbt-synthea: synthetic patient records mapped to the OMOP Common Data Model. 145 tables, 235 relationships from tests. |
 
-[View all 14 demos →](https://qdbd.dev/demo/)
+[View all 18 demos →](https://qdbd.dev/demo/)
 <!-- gallery:end -->
 
 ## Quickstart

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/README.md

@@ -49,7 +49,7 @@ Every demo is a single HTML page written by `qdbd build`, from a QuickDBD schema
 | [![200 tables](https://raw.githubusercontent.com/MarkPhamm/quickdbd-cli/main/docs/assets/img/gallery/synthetic.png)](https://qdbd.dev/demo/synthetic/)<br>**[200 tables](https://qdbd.dev/demo/synthetic/)**<br>Five business domains, 200 tables and every relationship type. Search, filter, click a table to focus it. | [![Schema diff](https://raw.githubusercontent.com/MarkPhamm/quickdbd-cli/main/docs/assets/img/gallery/diff.png)](https://qdbd.dev/demo/diff/)<br>**[Schema diff](https://qdbd.dev/demo/diff/)**<br>What a branch changed, coloured in: new tables in green, changed columns in amber, removals listed. |
 | [![AdventureWorks](https://raw.githubusercontent.com/MarkPhamm/quickdbd-cli/main/docs/assets/img/gallery/adventureworks.png)](https://qdbd.dev/demo/adventureworks/)<br>**[AdventureWorks](https://qdbd.dev/demo/adventureworks/)**<br>Microsoft's bicycle-company OLTP database: 68 tables in five schemas, one region each, with column descriptions. | [![OMOP CDM on Synthea](https://raw.githubusercontent.com/MarkPhamm/quickdbd-cli/main/docs/assets/img/gallery/synthea.png)](https://qdbd.dev/demo/synthea/#t=concept)<br>**[OMOP CDM on Synthea](https://qdbd.dev/demo/synthea/#t=concept)**<br>OHDSI's dbt-synthea: synthetic patient records mapped to the OMOP Common Data Model. 145 tables, 235 relationships from tests. |
 
-[View all 14 demos →](https://qdbd.dev/demo/)
+[View all 18 demos →](https://qdbd.dev/demo/)
 <!-- gallery:end -->
 
 ## Quickstart

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quickdbd-cli"
-version = "0.1.13"
+version = "0.1.15"
 description = "Compile QuickDBD-syntax schema files into interactive HTML ER diagrams, with no table limit."
 readme = "README.md"
 license = "Apache-2.0"

quickdbd_cli-0.1.15/src/quickdbd_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.15"

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/src/quickdbd_cli/assets/render.js

@@ -63,7 +63,7 @@
   }
 
   function keyIcon(x, cy) {
-    return '<g stroke="' + C.key + '" stroke-width="1.5" fill="none">' +
+    return '<g class="ki" stroke="' + C.key + '" stroke-width="1.5" fill="none">' +
       '<circle cx="' + n(x + 3.5) + '" cy="' + n(cy) + '" r="3"/>' +
       '<path d="M' + n(x + 6.5) + " " + n(cy) + "h7m-2 0v3m-2.5-3v2" + '"/></g>';
   }
@@ -84,7 +84,7 @@
       out.push('<text x="' + (w - st.padX) + '" y="' + n(st.headerH / 2 + 4) + '" text-anchor="end" fill="#fff" font-family="' + FONT +
         '" font-size="10" font-weight="bold">' + (state === "added" ? "NEW" : "CHANGED") + "</text>");
     }
-    out.push('<text x="' + st.padX + '" y="' + n(st.headerH / 2 + st.headerSize * 0.36) + '" fill="' + C.headerText +
+    out.push('<text class="tn" x="' + st.padX + '" y="' + n(st.headerH / 2 + st.headerSize * 0.36) + '" fill="' + C.headerText +
       '" font-family="' + FONT + '" font-size="' + st.headerSize + '">' + esc(t.name) + "</text>");
     if (docMarks && t.doc) {
       out.push(docMark(st.padX, st.headerH / 2 + st.headerSize * 0.36 + 3, t.nameW, "rgba(255,255,255,.7)"));
@@ -92,24 +92,24 @@
     g.cols.forEach(function (c, i) {
       var y = st.headerH + i * st.rowH, cy = y + st.rowH / 2, base = n(cy + st.rowSize * 0.36);
       var weight = c.pk || c.fk ? ' font-weight="bold"' : "";
-      var color = c.pk ? C.pk : c.fk ? C.fk : C.text;
+      var color = c.pk ? C.pk : c.fk ? C.fk : C.text, rn = c.pk ? "rn rpk" : c.fk ? "rn rfk" : "rn";
       out.push('<g class="r" data-c="' + esc(c.id) + '">');
       out.push('<rect class="rb" y="' + y + '" width="' + w + '" height="' + st.rowH + '" fill="' + C.body + '" fill-opacity="0"/>');
       var cstate = t.diff && t.diff.cols && t.diff.cols[c.id];
       if (cstate) out.push('<rect y="' + (y + 3) + '" width="3" height="' + (st.rowH - 6) + '" fill="' + C[cstate] + '"/>');
-      out.push('<text x="' + st.padX + '" y="' + base + '" fill="' + color + '" font-family="' + FONT + '" font-size="' +
+      out.push('<text class="' + rn + '" x="' + st.padX + '" y="' + base + '" fill="' + color + '" font-family="' + FONT + '" font-size="' +
         st.rowSize + '"' + weight + ">" + esc(c.name) + "</text>");
       if (docMarks && c.doc) out.push(docMark(st.padX, cy + st.rowSize * 0.36 + 2.5, c.nameW, color));
       var bx = st.padX + c.nameW + 6;
       c.badges.forEach(function (b) {
         var bh = st.badgeSize + 5;
-        out.push('<rect x="' + n(bx) + '" y="' + n(cy - bh / 2) + '" width="' + n(b.w) + '" height="' + bh + '" rx="3" fill="' + C.badgeBg + '"/>');
-        out.push('<text x="' + n(bx + st.badgePad) + '" y="' + n(cy + st.badgeSize * 0.36) + '" fill="' + C.badgeText +
+        out.push('<rect class="bb" x="' + n(bx) + '" y="' + n(cy - bh / 2) + '" width="' + n(b.w) + '" height="' + bh + '" rx="3" fill="' + C.badgeBg + '"/>');
+        out.push('<text class="bt" x="' + n(bx + st.badgePad) + '" y="' + n(cy + st.badgeSize * 0.36) + '" fill="' + C.badgeText +
           '" font-family="' + FONT + '" font-size="' + st.badgeSize + '">' + esc(b.t) + "</text>");
         bx += b.w + st.badgeGap;
       });
       if (c.pk) out.push(keyIcon(w - st.padX - c.typeW - st.keyW, cy));
-      out.push('<text x="' + (w - st.padX) + '" y="' + base + '" text-anchor="end" fill="' + C.type + '" font-family="' + FONT +
+      out.push('<text class="rt" x="' + (w - st.padX) + '" y="' + base + '" text-anchor="end" fill="' + C.type + '" font-family="' + FONT +
         '" font-size="' + st.rowSize + '">' + esc(c.type) + "</text>");
       out.push("</g>");
     });
@@ -150,7 +150,7 @@
       s.push('<path d="M' + n(x + dir * 11) + " " + n(y) + "L" + n(x) + " " + n(y - 6) + "M" + n(x + dir * 11) + " " + n(y) + "L" + n(x) + " " + n(y + 6) + '"' + st + "/>");
     }
     function circle(o) {
-      s.push('<circle cx="' + n(x + dir * o) + '" cy="' + n(y) + '" r="3.5" fill="' + C.bg + '" stroke="' + C.edge + '" stroke-width="1.2"/>');
+      s.push('<circle class="mc" cx="' + n(x + dir * o) + '" cy="' + n(y) + '" r="3.5" fill="' + C.bg + '" stroke="' + C.edge + '" stroke-width="1.2"/>');
     }
     if (card === "one") { bar(7); }
     else if (card === "many") { crow(); }
@@ -252,7 +252,7 @@
     var x0 = b[0] - pad - edgePad, y0 = b[1] - pad, w = b[2] - b[0] + 2 * (pad + edgePad), h = b[3] - b[1] + 2 * pad;
     var style = opts.fontCss ? "<style>" + opts.fontCss + "</style>" : "";
     return '<svg xmlns="http://www.w3.org/2000/svg" width="' + n(w) + '" height="' + n(h) + '" viewBox="' + n(x0) + " " + n(y0) + " " + n(w) + " " + n(h) + '">' +
-      style + '<rect x="' + n(x0) + '" y="' + n(y0) + '" width="' + n(w) + '" height="' + n(h) + '" fill="' + C.bg + '"/>' +
+      style + '<rect class="bgr" x="' + n(x0) + '" y="' + n(y0) + '" width="' + n(w) + '" height="' + n(h) + '" fill="' + C.bg + '"/>' +
       renderInner(m, pos, mode, { regions: opts.regions }) + "</svg>";
   }
 

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/src/quickdbd_cli/assets/style.css

@@ -10,10 +10,71 @@
   --sel: #eaf0f8;
   --amber: #f0a020;
   --shadow: 0 1px 2px rgba(16, 24, 40, .05), 0 8px 24px rgba(16, 24, 40, .07);
+  --on-ink: #fff;
+  --pick: #fde3b0;
+  --scroll: #cfd4da;
+  --chip-hover: #b8c2d0;
+  --tag-bg: #eef1f5;
+  --tag-ink: #6b7a8c;
+  --tag-pk-bg: #dfe8f6;
+  --tag-fk-bg: #ece6f7;
+  --tag-fk: #6a4fa3;
+  --mini-bg: rgba(255, 255, 255, .94);
+  --tip-bg: #15181c;
+  /* diagram: the same colours render.js writes as SVG attributes (exports keep those) */
+  --t-body: #ffffff;
+  --t-border: #dfe3e8;
+  --t-text: #333333;
+  --t-pk: #2b5797;
+  --t-fk: #222222;
+  --t-type: #9a9a9a;
+  --t-key: #b0b0b0;
+  --t-badge-bg: #eef1f5;
+  --t-badge-ink: #7a8899;
+  --t-edge: #b8bcc2;
+  --row-hl: #dbe6f6;
+  --row-hover: #eef3fa;
 }
-::selection { background: #fde3b0; color: var(--ink); }
+/* Dark theme. viewer.js sets data-theme from the toggle, or from prefers-color-scheme when it's on auto. */
+:root[data-theme="dark"] {
+  color-scheme: dark;
+  --bg: #121418;
+  --blue: #7aa7ff;
+  --ink: #e6e8eb;
+  --ink-2: #b4bac3;
+  --muted: #8a929e;
+  --panel: #1b1e23;
+  --line: #2c313a;
+  --hover: #252930;
+  --sel: #23324a;
+  --shadow: 0 1px 2px rgba(0, 0, 0, .3), 0 8px 24px rgba(0, 0, 0, .35);
+  --on-ink: #121418;
+  --pick: #5a4210;
+  --scroll: #3a404a;
+  --chip-hover: #4a5260;
+  --tag-bg: #2a2f37;
+  --tag-ink: #9aa5b3;
+  --tag-pk-bg: #22324a;
+  --tag-fk-bg: #2f2840;
+  --tag-fk: #b7a2e6;
+  --mini-bg: rgba(27, 30, 35, .94);
+  --tip-bg: #2a2f37;
+  --t-body: #1e2228;
+  --t-border: #333944;
+  --t-text: #d5d9df;
+  --t-pk: #8fb4ff;
+  --t-fk: #eceef1;
+  --t-type: #7d8693;
+  --t-key: #6b7380;
+  --t-badge-bg: #2a2f37;
+  --t-badge-ink: #9aa5b3;
+  --t-edge: #5b6472;
+  --row-hl: #24344d;
+  --row-hover: #23282f;
+}
+::selection { background: var(--pick); color: var(--ink); }
 :focus-visible { outline: 2px solid var(--amber); outline-offset: 1px; }
-* { scrollbar-width: thin; scrollbar-color: #cfd4da transparent; }
+* { scrollbar-width: thin; scrollbar-color: var(--scroll) transparent; }
 * { box-sizing: border-box; }
 html, body { margin: 0; height: 100%; background: var(--bg); color: var(--ink);
   font-family: Inter, "Helvetica Neue", Helvetica, Arial, sans-serif; font-size: 13px; overflow: hidden; }
@@ -22,13 +83,26 @@ html, body { margin: 0; height: 100%; background: var(--bg); color: var(--ink);
 #canvas { width: 100%; height: 100%; display: block; cursor: grab; touch-action: none; user-select: none; }
 #canvas.panning { cursor: grabbing; }
 
+/* diagram colours: CSS beats the SVG presentation attributes, so the page can theme them */
+.tb { fill: var(--t-body); stroke: var(--t-border); }
+.rn { fill: var(--t-text); }
+.rn.rpk { fill: var(--t-pk); }
+.rn.rfk { fill: var(--t-fk); }
+.r .dm { stroke: var(--t-text); }
+.rt { fill: var(--t-type); }
+.ki { stroke: var(--t-key); }
+.bb { fill: var(--t-badge-bg); }
+.bt { fill: var(--t-badge-ink); }
+.e path { stroke: var(--t-edge); }
+.e .mc { stroke: var(--t-edge); fill: var(--bg); }
+
 /* states */
 .t, .e { transition: opacity .15s; }
 .focus .t.dim, .focus .e.dim { opacity: .12; }
 .e.hl .ep { stroke: var(--blue); stroke-width: 2.2; }
 .e.hl path, .e.hl circle { stroke: var(--blue); }
-.r.hl .rb { fill: #dbe6f6; fill-opacity: 1; }
-.r:hover .rb { fill: #eef3fa; fill-opacity: 1; }
+.r.hl .rb { fill: var(--row-hl); fill-opacity: 1; }
+.r:hover .rb { fill: var(--row-hover); fill-opacity: 1; }
 .t.flash .tb { stroke: #f0a020; stroke-width: 3; }
 .t { cursor: grab; }
 #canvas.panning .t { cursor: grabbing; }
@@ -39,13 +113,13 @@ html, body { margin: 0; height: 100%; background: var(--bg); color: var(--ink);
 .bar button, .seg button { border: 0; background: transparent; color: var(--ink-2); font: inherit; font-weight: 500;
   cursor: pointer; padding: 5px 9px; border-radius: 6px; transition: background .12s, color .12s; }
 .bar button:hover, .seg button:hover { background: var(--hover); color: var(--ink); }
-.bar button.on { background: var(--ink); color: #fff; }
+.bar button.on { background: var(--ink); color: var(--on-ink); }
 .zoomval { min-width: 46px; text-align: center; color: var(--muted); font-variant-numeric: tabular-nums; }
 .seg { display: flex; background: var(--hover); border-radius: 7px; padding: 2px; }
 .seg button.on { background: var(--panel); color: var(--ink); box-shadow: 0 1px 2px rgba(16, 24, 40, .12); }
 .sep { width: 1px; height: 18px; background: var(--line); margin: 0 4px; }
 .bar button svg, .exhead button svg, .details .close svg { display: block; }
-#zin, #zout, #zfit { padding: 5px 6px; }
+#zin, #zout, #zfit, #xtheme { padding: 5px 6px; }
 
 /* explorer (left): search + table tree grouped by file/folder */
 .explorer { position: absolute; top: 14px; left: 16px; width: 270px; max-height: calc(100% - 60px); display: flex;
@@ -62,7 +136,7 @@ html, body { margin: 0; height: 100%; background: var(--bg); color: var(--ink);
 .exfilter { padding: 6px 6px 4px; border-bottom: 1px solid var(--line); }
 .explorer.collapsed .exfilter { display: none; }
 .exfilter input { width: 100%; padding: 5px 8px; border: 1px solid var(--line); border-radius: 7px; font: 12px ui-monospace, Menlo, Consolas, monospace;
-  color: var(--ink); outline: none; }
+  color: var(--ink); background: var(--panel); outline: none; }
 .exfilter input:focus { border-color: var(--ink-2); }
 .exfilter input.bad { border-color: #e57373; }
 .fstat { font-size: 11px; color: var(--muted); padding: 3px 2px 0; min-height: 14px; }
@@ -70,10 +144,10 @@ html, body { margin: 0; height: 100%; background: var(--bg); color: var(--ink);
 .fstat a { color: var(--blue); cursor: pointer; margin-left: 6px; }
 .tagbar { display: flex; flex-wrap: wrap; gap: 4px; padding: 4px 0 2px; }
 .tchip { display: inline-flex; align-items: center; gap: 4px; font: 11px/1.6 inherit; padding: 0 7px 0 5px; border: 1px solid var(--line);
-  border-radius: 10px; background: #fff; color: var(--text, #333); cursor: pointer; }
+  border-radius: 10px; background: var(--panel); color: var(--ink); cursor: pointer; }
 .tchip i { width: 8px; height: 8px; border-radius: 50%; display: inline-block; }
 .tchip small { color: var(--muted); }
-.tchip:hover { border-color: #b8c2d0; }
+.tchip:hover { border-color: var(--chip-hover); }
 .tchip.on { border-color: var(--ink-2); background: var(--sel); }
 .tdot { display: inline-block; width: 7px; height: 7px; border-radius: 50%; margin: 0 6px 1px -13px; vertical-align: middle; }
 .tree.flat .tdot { margin-left: 0; }
@@ -117,10 +191,10 @@ html, body { margin: 0; height: 100%; background: var(--bg); color: var(--ink);
 .details td.cn { font-weight: 600; word-break: break-word; }
 .details td.ct { color: var(--muted); text-align: right; white-space: nowrap; }
 .details .cd { color: var(--ink-2); font-weight: normal; margin-top: 2px; white-space: pre-wrap; }
-.details .tag { display: inline-block; font-size: 10px; padding: 0 5px; border-radius: 3px; background: #eef1f5;
-  color: #6b7a8c; margin: 0 3px 0 0; font-weight: normal; }
-.details .tag.pk { background: #dfe8f6; color: var(--blue); }
-.details .tag.fk { background: #ece6f7; color: #6a4fa3; }
+.details .tag { display: inline-block; font-size: 10px; padding: 0 5px; border-radius: 3px; background: var(--tag-bg);
+  color: var(--tag-ink); margin: 0 3px 0 0; font-weight: normal; }
+.details .tag.pk { background: var(--tag-pk-bg); color: var(--blue); }
+.details .tag.fk { background: var(--tag-fk-bg); color: var(--tag-fk); }
 .details ul { list-style: none; margin: 0; padding: 0; }
 .details li { padding: 6px 0; border-top: 1px solid var(--line); }
 .details a { color: var(--blue); text-decoration: none; cursor: pointer; }
@@ -130,19 +204,19 @@ html, body { margin: 0; height: 100%; background: var(--bg); color: var(--ink);
 .details .hidden { color: var(--muted); }
 
 /* minimap (bottom right) */
-.minimap { position: absolute; right: 16px; bottom: 16px; width: 200px; height: 140px; background: rgba(255, 255, 255, .94);
+.minimap { position: absolute; right: 16px; bottom: 16px; width: 200px; height: 140px; background: var(--mini-bg);
   border: 1px solid var(--line); border-radius: 10px; box-shadow: var(--shadow); overflow: hidden; cursor: pointer; }
 .minimap svg { width: 100%; height: 100%; display: block; }
 .minimap .vpr { fill: rgba(43,87,151,.12); stroke: var(--blue); stroke-width: 1.5; vector-effect: non-scaling-stroke; }
 
-.toast { position: absolute; left: 50%; bottom: 24px; transform: translateX(-50%); background: var(--ink); color: #fff;
+.toast { position: absolute; left: 50%; bottom: 24px; transform: translateX(-50%); background: var(--tip-bg); color: #fff;
   padding: 8px 14px; border-radius: 8px; font-size: 12px; opacity: 0; transition: opacity .2s; pointer-events: none; z-index: 6; }
 .toast.open { opacity: 1; }
 
 /* path finder (in the details panel) */
 .details .pathbox { display: flex; gap: 6px; margin: 10px 0 4px; }
 .details .pathbox input { flex: 1; min-width: 0; padding: 6px 9px; border: 1px solid var(--line); border-radius: 7px; font: inherit;
-  color: var(--ink); outline: none; }
+  color: var(--ink); background: var(--panel); outline: none; }
 .details .pathbox input:focus { border-color: var(--ink-2); }
 .details .pathres ol { margin: 6px 0 8px 18px; padding: 0; }
 .details .pathres li { border: 0; padding: 2px 0; }
@@ -173,7 +247,7 @@ html, body { margin: 0; height: 100%; background: var(--bg); color: var(--ink);
 .details .state.changed { background: #d48806; }
 
 /* doc-comment tooltip */
-.tip { position: absolute; display: none; max-width: 340px; background: var(--ink); color: #eef0f2; border-radius: 8px;
+.tip { position: absolute; display: none; max-width: 340px; background: var(--tip-bg); color: #eef0f2; border-radius: 8px;
   padding: 8px 10px; font-size: 12px; line-height: 1.45; pointer-events: none; box-shadow: 0 4px 14px rgba(0,0,0,.25);
   z-index: 5; }
 .tip.open { display: block; }

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/src/quickdbd_cli/assets/viewer.js

@@ -287,6 +287,26 @@
   }
   regionBtn.onclick = function () { setRegions(!S.regions); };
 
+  /* Theme: auto (follow the OS) -> dark -> light. A viewer preference, so localStorage, not the URL hash.
+   * The <head> script applies it before paint; exports always use render.js's light colours. */
+  var themeBtn = document.getElementById("xtheme"), darkQuery = window.matchMedia("(prefers-color-scheme: dark)");
+  function themePref() {
+    try { var t = localStorage.getItem("qdbd-theme"); return t === "light" || t === "dark" ? t : "auto"; } catch (e) { return "auto"; }
+  }
+  function applyTheme() {
+    var pref = themePref(), t = pref === "auto" ? (darkQuery.matches ? "dark" : "light") : pref;
+    document.documentElement.setAttribute("data-theme", t);
+    themeBtn.title = "Theme: " + pref;
+  }
+  themeBtn.onclick = function () {
+    var next = { auto: "dark", dark: "light", light: "auto" }[themePref()];
+    try { if (next === "auto") localStorage.removeItem("qdbd-theme"); else localStorage.setItem("qdbd-theme", next); } catch (e) { /* private mode */ }
+    applyTheme();
+    showToast("Theme: " + next);
+  };
+  if (darkQuery.addEventListener) darkQuery.addEventListener("change", applyTheme);
+  applyTheme();
+
   function setMode(mode) {
     S.mode = ["full", "keys", "header"].indexOf(mode) >= 0 ? mode : "full";
     document.querySelectorAll("#modes button").forEach(function (o) { o.classList.toggle("on", o.getAttribute("data-mode") === S.mode); });

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/src/quickdbd_cli/cli.py

@@ -3,11 +3,13 @@
 from __future__ import annotations
 
 import argparse
+import dataclasses
+import json
 import sys
 from pathlib import Path
 
 from . import __version__
-from .model import Schema
+from .model import Diagnostic, Schema
 from .project import Project, SelectionError, selector_expr
 
 OK = "No errors found. Good job!"
@@ -36,9 +38,31 @@ def _title(project: Project) -> str:
     return "diagram"
 
 
+def _github_annotation(d: Diagnostic, level: str) -> str:
+    """A GitHub Actions workflow command, which shows `d` inline on the PR's changed lines."""
+
+    def esc(s: str) -> str:
+        return s.replace("%", "%25").replace("\r", "%0D").replace("\n", "%0A")
+
+    def esc_prop(s: str) -> str:
+        return esc(s).replace(":", "%3A").replace(",", "%2C")
+
+    return f"::{level} file={esc_prop(d.path)},line={d.line},title=qdbd::{esc(d.message)}"
+
+
 def cmd_check(args) -> int:
     project = _open(args)
     schema = project.compile()
+    if args.format == "json":
+        ok = not schema.errors and not (args.strict and schema.warnings)
+        diags = [dataclasses.asdict(d) for d in schema.diagnostics]
+        report = {"ok": ok, "errors": len(schema.errors), "warnings": len(schema.warnings), "diagnostics": diags}
+        print(json.dumps(report, indent=2))
+        return 0 if ok else 1
+    if args.format == "github":
+        # Under --strict a warning fails the job, so it's annotated as an error.
+        for d in schema.diagnostics:
+            print(_github_annotation(d, "error" if args.strict else d.severity))
     ok = _print_diagnostics(schema, args.strict)
     if ok and not schema.diagnostics:
         print(OK)
@@ -345,6 +369,12 @@ def build_parser() -> argparse.ArgumentParser:
     sp = sub.add_parser("check", help="validate schema files")
     paths(sp)
     sp.add_argument("--strict", action="store_true", help="treat warnings (QuickDBD incompatibilities) as errors")
+    sp.add_argument(
+        "--format",
+        choices=["text", "github", "json"],
+        default="text",
+        help="github: also emit GitHub Actions annotations (inline on PR lines); json: a machine-readable report",
+    )
     sp.set_defaults(func=cmd_check)
 
     sp = sub.add_parser("build", help="write an interactive HTML diagram")

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/src/quickdbd_cli/html.py

@@ -39,6 +39,7 @@ ICONS = {
     "icon_minus": _icon("M5 12h14"),
     "icon_plus": _icon("M12 5v14M5 12h14"),
     "icon_fit": _icon("M4 9V4h5M15 4h5v5M20 15v5h-5M9 20H4v-5"),
+    "icon_theme": _icon("M12 3a9 9 0 1 0 0 18a9 9 0 1 0 0-18zM12 3v18M12 8h4.5M12 12h6M12 16h4.5"),
 }
 
 
@@ -82,6 +83,8 @@ BODY = """
       <span class="zoomval" id="zoomval">100%</span>
       <button id="zin" title="Zoom in" aria-label="Zoom in">{icon_plus}</button>
       <button id="zfit" title="Fit to screen" aria-label="Fit to screen">{icon_fit}</button>
+      <div class="sep"></div>
+      <button id="xtheme" title="Theme: auto" aria-label="Switch light / dark theme">{icon_theme}</button>
     </div>
     <div class="minimap">
       <svg id="mini" xmlns="http://www.w3.org/2000/svg" preserveAspectRatio="xMidYMid meet"></svg>
@@ -111,6 +114,14 @@ FILTER_HELP = (
 )
 
 
+# Runs in <head> so the page paints in the right theme. viewer.js owns the toggle; keep the key in sync.
+THEME_JS = (
+    "(function(){var t;try{t=localStorage.getItem('qdbd-theme');}catch(e){}"
+    "if(t!=='light'&&t!=='dark')t=matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light';"
+    "document.documentElement.setAttribute('data-theme',t);})();"
+)
+
+
 # Read-only live view: refetch the model whenever the server's version changes. Relative URLs, so it
 # also works behind a tunnel or a path prefix.
 LIVE_JS = (
@@ -151,6 +162,7 @@ def render_page(model: dict, positions: dict, title: str, serve: bool = False, l
         '<meta name="viewport" content="width=device-width, initial-scale=1">'
         '<meta name="generator" content="qdbd">'
         f"<title>{_escape(title)}</title>"
+        f"<script>{THEME_JS}</script>"
         # The font CSS lives in its own <style> so the viewer can reuse it for SVG/PNG export
         # instead of embedding the fonts a second time.
         f'<style id="qdbd-font">{font_css()}</style>'

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/tests/test_gallery.py

@@ -91,6 +91,11 @@ def test_sample_databases_and_dbt_projects(built):
     assert sizes["adventureworks"][0] == 68 and sizes["adventureworks"][1] >= 90
     assert sizes["synthea"] == (145, 235)
     assert sizes["shopify"][0] == 155 and sizes["shopify"][1] > 150  # every link inferred
+    for d, n in (("pubs", 11), ("adventureworks-dw", 28), ("saas-billing", 13), ("courses", 14)):
+        m = _model(built / d / "index.html")
+        assert len(m["tables"]) == n and m["rels"], d
+    dw = _model(built / "adventureworks-dw" / "index.html")
+    assert {"dim", "fact"} <= {t["name"] for t in dw["tags"]}  # coloured by the Dim/Fact name prefixes
     aw = _model(built / "adventureworks" / "index.html")
     assert aw["regions"] and any(t.get("doc") for t in aw["tables"])  # MS_Description -> tooltips
 

{quickdbd_cli-0.1.13 → quickdbd_cli-0.1.15}/tests/test_pipeline.py

@@ -136,6 +136,47 @@ def test_check_strict_warnings(tmp_path):
     assert main(["check", "--strict", str(f)]) == 1
 
 
+def test_check_format_github(tmp_path, capsys):
+    bad = tmp_path / "bad.txt"
+    bad.write_text("T\n-\nA int foo\nB decimal(10, 2)\n")
+    assert main(["check", "--format", "github", str(bad)]) == 1
+    out = capsys.readouterr().out.splitlines()
+    assert f"::error file={bad},line=3,title=qdbd::Unrecognized keyword 'foo'" in out
+    assert any(line.startswith(f"::warning file={bad},line=4,title=qdbd::QuickDBD would reject this") for line in out)
+
+
+def test_check_format_github_strict_promotes_warnings(tmp_path, capsys):
+    f = tmp_path / "w.txt"
+    f.write_text("T\n-\nA decimal(10, 2)\n")
+    assert main(["check", "--format", "github", "--strict", str(f)]) == 1
+    assert capsys.readouterr().out.startswith(f"::error file={f},line=3,")
+
+
+def test_github_annotation_escaping():
+    from quickdbd_cli.cli import _github_annotation
+    from quickdbd_cli.model import Diagnostic
+
+    d = Diagnostic("a,b:c.txt", 2, "50% bad\nnext", "warning")
+    assert _github_annotation(d, "warning") == "::warning file=a%2Cb%3Ac.txt,line=2,title=qdbd::50%25 bad%0Anext"
+
+
+def test_check_format_json(tmp_path, capsys):
+    bad = tmp_path / "bad.txt"
+    bad.write_text("T\n-\nA int foo\n")
+    assert main(["check", "--format", "json", str(bad)]) == 1
+    data = json.loads(capsys.readouterr().out)
+    assert data["ok"] is False and data["errors"] == 1 and data["warnings"] == 0
+    assert data["diagnostics"] == [
+        {"path": str(bad), "line": 3, "severity": "error", "message": "Unrecognized keyword 'foo'"}
+    ]
+
+
+def test_check_format_json_ok(capsys):
+    assert main(["check", "--format", "json", str(SAMPLE)]) == 0
+    data = json.loads(capsys.readouterr().out)
+    assert data == {"ok": True, "errors": 0, "warnings": 0, "diagnostics": []}
+
+
 def test_build_is_deterministic_and_does_not_write_sidecar(tmp_path):
     work = tmp_path / "s"
     shutil.copytree(SYNTH, work)
@@ -240,6 +281,16 @@ def test_page_has_share_link_controls():
     assert 'id="xlink"' in html and 'id="toast"' in html
 
 
+def test_page_has_theme_toggle_and_exports_stay_light():
+    m = model_json(compile_text(SMALL))
+    pos = {"Customer": [0, 0], "Order": [300, 0]}
+    html = render_page(m, pos, "t")
+    assert 'id="xtheme"' in html and ':root[data-theme="dark"]' in html
+    assert html.index("qdbd-theme") < html.index("</head>")  # theme applied before first paint
+    svg = export.render_svg(m, pos, embed_font=False)
+    assert "data-theme" not in svg and 'fill="#ffffff"' in svg and "#1e2228" not in svg
+
+
 def test_drawio_export(tmp_path):
     import xml.etree.ElementTree as ET
 

quickdbd_cli-0.1.13/src/quickdbd_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.13"