mcdview 0.26.2__tar.gz → 0.28.0__tar.gz

{mcdview-0.26.2 → mcdview-0.28.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcdview
-Version: 0.26.2
+Version: 0.28.0
 Summary: Turn a SQL data model into one self-contained, interactive HTML page
 Project-URL: Homepage, https://github.com/Gheop/mcdview
 Project-URL: Demo, https://gheop.github.io/mcdview/
@@ -210,8 +210,9 @@ In the page:
 | `--dialect NAME` | Input SQL dialect (default: `auto`); non-PostgreSQL needs `sqlglot` |
 | `--home-url URL` | Wrap the header logo in a link to this URL |
 | `--logo FILE` | Replace the header logo with this image (svg/png/jpg…, shown 22×22) |
-| `--credit TEXT` | Discreet attribution badge, bottom-right (off by default) |
+| `--credit TEXT` | Discreet attribution badge, bottom-right; auto-set to `mcdview` (linking mcdview.dev) on a branded page |
 | `--credit-url URL` | Make the `--credit` badge a link to this URL |
+| `--no-credit` | Never place the attribution badge, even on a branded page |
 | `--db URL` | Read a live database's schema instead of a file (`postgresql://…` via `pg_dump`, `mysql://…` via `mysqldump`); CLI only |
 | `--diff BASELINE` | Compare against an older model (any supported format); added/removed/changed tables, columns and FKs are colored |
 | `--summary FILE` | With `--diff`: also write a JSON summary of the changes (counts + change list) to `FILE` |
@@ -323,6 +324,29 @@ file's header.
 
 ## Changelog
 
+### v0.28.0 — Auto attribution badge on branded pages (2026-08-31)
+
+- A branded page (`--logo` or `--home-url`) now carries a discreet clickable
+  `mcdview` badge by default, linking to https://mcdview.dev. Branding drops the
+  header link back to mcdview, so the badge keeps the attribution. An explicit
+  `--credit` still sets its own text and url; a plain, unbranded page stays bare.
+- New `--no-credit` opts out of the badge, even on a branded page.
+
+### v0.27.1 — Fix SVG export from a zoomed-out diagram (2026-08-31)
+
+- SVG export now always draws full table boxes. Exporting while the diagram was
+  zoomed out (header-only, level-of-detail view) sized each box to its header
+  alone, so the columns spilled out with no background or border and the FK
+  links anchored to the header center. The export reflows to full detail before
+  measuring, so its output no longer depends on the current zoom level.
+
+### v0.27.0 — `--to-dico` data dictionary on the CLI (2026-08-30)
+
+- `--to-dico` outputs a Markdown data dictionary (one `## schema.table` section
+  with a `column / type / key` table) instead of the HTML page — to `-o` if
+  given, else stdout. Same content as the in-page **export → Markdown**, now
+  scriptable for a docs/CI pipeline like `--to-mermaid` and `--to-preview`.
+
 ### v0.26.2 — Auto-dismiss the hint banner (2026-08-30)
 
 - The transient hint banner (e.g. "No probable missing FK", "No match", a

{mcdview-0.26.2 → mcdview-0.28.0}/README.md

@@ -188,8 +188,9 @@ In the page:
 | `--dialect NAME` | Input SQL dialect (default: `auto`); non-PostgreSQL needs `sqlglot` |
 | `--home-url URL` | Wrap the header logo in a link to this URL |
 | `--logo FILE` | Replace the header logo with this image (svg/png/jpg…, shown 22×22) |
-| `--credit TEXT` | Discreet attribution badge, bottom-right (off by default) |
+| `--credit TEXT` | Discreet attribution badge, bottom-right; auto-set to `mcdview` (linking mcdview.dev) on a branded page |
 | `--credit-url URL` | Make the `--credit` badge a link to this URL |
+| `--no-credit` | Never place the attribution badge, even on a branded page |
 | `--db URL` | Read a live database's schema instead of a file (`postgresql://…` via `pg_dump`, `mysql://…` via `mysqldump`); CLI only |
 | `--diff BASELINE` | Compare against an older model (any supported format); added/removed/changed tables, columns and FKs are colored |
 | `--summary FILE` | With `--diff`: also write a JSON summary of the changes (counts + change list) to `FILE` |
@@ -301,6 +302,29 @@ file's header.
 
 ## Changelog
 
+### v0.28.0 — Auto attribution badge on branded pages (2026-08-31)
+
+- A branded page (`--logo` or `--home-url`) now carries a discreet clickable
+  `mcdview` badge by default, linking to https://mcdview.dev. Branding drops the
+  header link back to mcdview, so the badge keeps the attribution. An explicit
+  `--credit` still sets its own text and url; a plain, unbranded page stays bare.
+- New `--no-credit` opts out of the badge, even on a branded page.
+
+### v0.27.1 — Fix SVG export from a zoomed-out diagram (2026-08-31)
+
+- SVG export now always draws full table boxes. Exporting while the diagram was
+  zoomed out (header-only, level-of-detail view) sized each box to its header
+  alone, so the columns spilled out with no background or border and the FK
+  links anchored to the header center. The export reflows to full detail before
+  measuring, so its output no longer depends on the current zoom level.
+
+### v0.27.0 — `--to-dico` data dictionary on the CLI (2026-08-30)
+
+- `--to-dico` outputs a Markdown data dictionary (one `## schema.table` section
+  with a `column / type / key` table) instead of the HTML page — to `-o` if
+  given, else stdout. Same content as the in-page **export → Markdown**, now
+  scriptable for a docs/CI pipeline like `--to-mermaid` and `--to-preview`.
+
 ### v0.26.2 — Auto-dismiss the hint banner (2026-08-30)
 
 - The transient hint banner (e.g. "No probable missing FK", "No match", a

{mcdview-0.26.2 → mcdview-0.28.0}/mcdview.py

@@ -1606,6 +1606,36 @@ def vers_mermaid(tables, fks):
     return '\n'.join(lignes) + '\n'
 
 
+def vers_dico(tables, fks, titre):
+    """A Markdown data dictionary: one section per table with a
+    column / type / key row. Pastes into a wiki or a .md (GitHub/GitLab render
+    the tables). Same shape as the in-page "export → Markdown"."""
+    def cell(s):
+        return str(s).replace('|', '\\|')
+    fk_par = {}
+    for f in fks:
+        fk_par.setdefault(f['de'], {})[f['col']] = f['vers']
+    lignes = ['# ' + titre, '']
+    for cle in sorted(tables):
+        t = tables[cle]
+        fk = fk_par.get(cle, {})
+        lignes += ['## ' + cle, '']
+        if t.get('comment'):
+            lignes += ['> ' + t['comment'].replace('\n', ' '), '']
+        lignes += ['| column | type | key |', '| --- | --- | --- |']
+        for c in t['cols']:
+            if c['nom'] in t['pk']:
+                k = 'PK'
+            elif c['nom'] in fk:
+                k = 'FK → ' + fk[c['nom']].split('.', 1)[-1]
+            else:
+                k = ''
+            typ = c['type'] + (' NOT NULL' if c['nn'] else '')
+            lignes.append(f"| {cell(c['nom'])} | {cell(typ)} | {cell(k)} |")
+        lignes.append('')
+    return '\n'.join(lignes)
+
+
 def vers_svg(tables, fks, couleurs):
     """A static SVG snapshot of the diagram, for social/OpenGraph cards: the
     auto-layout positions, the same box sizing as the interactive page, table
@@ -1678,6 +1708,10 @@ def principal():
     ap.add_argument('--to-preview', action='store_true',
                     help='output a static SVG snapshot of the diagram (for a social '
                          'card / OpenGraph image) instead of the HTML page')
+    ap.add_argument('--to-dico', action='store_true',
+                    help='output a Markdown data dictionary (one section per table, '
+                         'column/type/key) instead of the HTML page; to -o if given, '
+                         'else stdout')
     ap.add_argument('--lint', action='store_true',
                     help='check the schema against a set of rules (missing PK, '
                          'unindexed FK, naming…) and print JSON violations instead '
@@ -1703,9 +1737,12 @@ def principal():
     ap.add_argument('--logo', default=None, metavar='FILE',
                     help="replace the header logo (svg/png/jpg…, shown 22×22)")
     ap.add_argument('--credit', default=None, metavar='TEXT',
-                    help="discreet attribution badge, bottom-right (off by default)")
+                    help="discreet attribution badge, bottom-right; auto-set to "
+                         "'mcdview' (linking mcdview.dev) on a branded page")
     ap.add_argument('--credit-url', default=None, metavar='URL',
                     help="make the --credit badge a link to this URL")
+    ap.add_argument('--no-credit', action='store_true',
+                    help="never place the attribution badge, even on a branded page")
     args = ap.parse_args()
     if args.summary and not args.diff:
         ap.error('--summary only applies with --diff')
@@ -1720,7 +1757,7 @@ def principal():
 
     generer(args, ap)
     if args.watch:
-        if args.db or args.to_mermaid or args.to_preview or not args.sql:
+        if args.db or args.to_mermaid or args.to_preview or args.to_dico or not args.sql:
             ap.error('--watch needs a model file (not --db or --to-mermaid)')
         surveiller(args, ap)
 
@@ -1922,6 +1959,15 @@ def generer(args, ap):
             sys.stdout.write(mmd)
         return
 
+    if args.to_dico:
+        md = vers_dico(tables, fks, args.titre or nom_defaut)
+        if args.sortie:
+            Path(args.sortie).write_text(md)
+            print(f'{len(tables)} tables, {len(fks)} FKs → {args.sortie} (data dictionary)')
+        else:
+            sys.stdout.write(md)
+        return
+
     if args.diff:
         vieux = charger(args.diff, args.dialect)[:2]
         tables, fks = comparer(vieux, (tables, fks))
@@ -1951,9 +1997,19 @@ def generer(args, ap):
 
     titre = args.titre or nom_defaut
     sortie = args.sortie or sortie_defaut
+    # Attribution badge. A branded page (--logo or --home-url) drops the header
+    # link back to mcdview, so unless the caller opts out or sets its own credit,
+    # stamp a discreet clickable "mcdview". An explicit --credit keeps its own
+    # text/url; a plain page (unbranded) stays bare.
+    credit, credit_url = args.credit, args.credit_url
+    if args.no_credit:
+        credit = None
+    elif credit is None and (args.logo or args.home_url):
+        credit = 'mcdview'
+        credit_url = credit_url or 'https://mcdview.dev'
     Path(sortie).write_text(composer_page(tables, fks, titre, args.lang, couleurs,
                                           dialecte, args.home_url, args.logo,
-                                          args.credit, args.credit_url, bool(args.diff)))
+                                          credit, credit_url, bool(args.diff)))
     if args.diff:
         if args.summary:
             resume = resume_diff(tables, fks, args.diff)

{mcdview-0.26.2 → mcdview-0.28.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mcdview"
-version = "0.26.2"
+version = "0.28.0"
 description = "Turn a SQL data model into one self-contained, interactive HTML page"
 readme = "README.md"
 requires-python = ">=3.9"

{mcdview-0.26.2 → mcdview-0.28.0}/templates/explorateur.html

@@ -879,6 +879,19 @@ btnReorg.addEventListener("click", reorganiser);
 function exporterSVG() {
   const pad = 24, vis = Object.keys(elems).filter(c => !elems[c].classList.contains("efface"));
   if (!vis.length) return;
+  // The export always draws every column, but a zoomed-out (compact) page
+  // collapses each node to its header, which would size the boxes and anchor the
+  // FK links to the header alone. Drop compact for the measurement (synchronous,
+  // restored before we return, so no flicker) so the DOM reflows to full detail.
+  const etaitCompact = plan.classList.contains("compact");
+  if (etaitCompact) plan.classList.remove("compact");
+  try {
+    exporterSVGImpl(pad, vis);
+  } finally {
+    if (etaitCompact) plan.classList.add("compact");
+  }
+}
+function exporterSVGImpl(pad, vis) {
   let bx0 = 1e9, by0 = 1e9, bx1 = -1e9, by1 = -1e9;
   vis.forEach(c => {
     const e = elems[c];