layoutbridge-light 0.0.0-stage → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog – LayoutBridge Light for Adobe InDesign®
+
+All notable changes to `layoutbridge-light`. Format: Keep a Changelog;
+versions follow Semantic Versioning. Within a major version, tool names,
+parameters and return fields remain stable; additions are additive.
+
+## [1.0.0] - 2026-11-01
+
+### Added
+
+- First release of LayoutBridge Light: 77 tools for book typesetting in
+  Adobe® InDesign® – documents and pages, master pages and sections,
+  layout grid, text frames and autoflow of whole manuscripts, text,
+  paragraph and character styles with drop caps, images and anchored
+  objects, table of contents and index, typography checks, print-on-demand
+  checks and book covers, preflight, PDF and image export, EPUB export and
+  check.
+- Same server code as LayoutBridge for Adobe InDesign® 1.0.4; separate
+  licence key, settings folder and log folder.
+
+Adobe and InDesign are either registered trademarks or trademarks of Adobe
+in the United States and/or other countries.

package/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2026 SP Medienservice, Inhaber Sascha Piprek
+Alle Rechte vorbehalten. / All rights reserved.
+
+Diese Software und die zugehörige Dokumentation sind
+urheberrechtlich geschützt. Die Nutzung ist nur mit einem
+gültigen Lizenzschlüssel und nur nach den Lizenzbedingungen
+gestattet:
+https://mcp-schnittstellen.de/layoutbridge-light/lizenzbedingungen.html
+Darüber hinaus wird kein Nutzungsrecht eingeräumt.
+Vervielfältigung, Verbreitung, Bearbeitung, Weitergabe und
+öffentliche Zugänglichmachung – ganz oder in Teilen – bedürfen
+der vorherigen schriftlichen Zustimmung des Rechteinhabers,
+soweit die Lizenzbedingungen sie nicht erlauben.
+
+This software and its documentation are protected by
+copyright. Use is permitted only with a valid licence key and
+only under the licence terms:
+https://mcp-interfaces.com/layoutbridge-light/license.html
+No other rights of use are granted. Reproduction,
+distribution, modification, transfer and making available to
+the public – in whole or in part – require the prior written
+consent of the rights holder, except as permitted by the
+licence terms.
+
+Drittsoftware / Third-party software: THIRD-PARTY-NOTICES.md
+Kontakt / Contact: kontakt@mcp-interfaces.com

package/README.de.md

@@ -0,0 +1,338 @@
+# LayoutBridge Light for Adobe InDesign®
+
+English version: [README.md](README.md)
+
+**LayoutBridge Light for Adobe InDesign®** – MCP-Server für den Buchsatz in
+Adobe® InDesign® (npm-Paket `layoutbridge-light`) von MCP Interfaces. Er
+stellt die Werkzeuge bereit, die ein Buch braucht, für jede MCP-fähige KI:
+Dokumente und Seiten, Musterseiten und Abschnitte, Satzspiegel, Textrahmen
+und Autofluss ganzer Manuskripte, Text, Absatz- und Zeichenformate mit
+Initialen, Bilder und verankerte Objekte, Inhaltsverzeichnis und Register,
+Typografieprüfung, Prüfung für Print-on-Demand und Buchumschlag, Preflight
+und Export (PDF, Seitenbilder und E-Books als EPUB, mit Prüfung des EPUB).
+
+LayoutBridge Light ist die Buchausgabe von LayoutBridge for Adobe InDesign®:
+derselbe Server, 77 seiner Werkzeuge. Nicht enthalten sind Tabellen, Ebenen,
+Gruppen und Objektformate, Formen, Linien und Effekte, das Umsortieren von
+Seiten, das Verpacken und die Werkzeuge zum Übernehmen fremder Dokumente. Es braucht einen eigenen
+Lizenzschlüssel; ein Schlüssel für LayoutBridge for Adobe InDesign® gilt
+hier nicht, und umgekehrt.
+
+Produktseite: https://mcp-schnittstellen.de/layoutbridge-light/ (englisch:
+https://mcp-interfaces.com/layoutbridge-light/).
+Ausführliche Schritt-für-Schritt-Anleitung:
+https://mcp-schnittstellen.de/layoutbridge-light/installation.html (englisch:
+https://mcp-interfaces.com/layoutbridge-light/installation.html).
+
+Adobe and InDesign are either registered trademarks or trademarks of Adobe in
+the United States and/or other countries.
+
+## Voraussetzungen
+
+- Adobe® InDesign®, installiert und gestartet – Mac oder Windows (Windows
+  10/11 x64; geprüft mit InDesign® 21.5.1.73 auf Windows 11)
+- Windows: Windows PowerShell 5.1 (`powershell.exe`, in Windows enthalten)
+- Ihr Lizenzschlüssel aus der Quittungsmail des Kaufs – ein Schlüssel je
+  Arbeitsplatz
+- Eine Netzverbindung für die Lizenzprüfung beim ersten Aufruf
+- **Node.js ab Version 20 – nur für das npm-Paket** (Eintrag in der
+  Konfigurationsdatei, `--setup`, `--deactivate`) **und für andere
+  MCP-Clients.** Mit dem Installationspaket (`.mcpb`) ist keine eigene
+  Node.js-Installation nötig – Claude Desktop bringt Node.js mit (Schalter
+  „Use built-in Node.js for MCP“ unter „Erweiterte Einstellungen“, ab Werk
+  eingeschaltet).
+
+## Installation in Claude Desktop
+
+Es gibt zwei Wege. Weg A ist der kürzere; Weg B ist derselbe Eintrag, den
+auch andere MCP-Clients bekommen. Die oben verlinkte Anleitung zeigt jeden
+Schritt mit den Einzelheiten für Mac und Windows.
+
+**Weg A – Installationspaket (Bundle-Datei `.mcpb`)**
+
+1. Laden Sie die Datei `layoutbridge-light-<Version>.mcpb` von der
+   Produktseite herunter.
+2. Öffnen Sie in Claude Desktop Einstellungen › Desktop-App › Erweiterungen
+   und ziehen Sie die Datei in dieses Fenster – dort steht „Ziehe .MCPB-
+   oder .DXT-Dateien hier her, um sie zu installieren“. Auf dem Mac können
+   Sie die Datei stattdessen per Doppelklick öffnen. Unter Windows öffnet
+   der Doppelklick Claude Desktop nicht – Windows fragt nach einem
+   Programm; ziehen Sie die Datei dort ins Fenster oder wählen Sie unter
+   „Erweiterte Einstellungen“ die Schaltfläche zum Installieren einer
+   Erweiterung (englische Oberfläche: „Advanced settings“ › „Install
+   extension“) und dann die Datei. Bestätigen Sie den Installationsdialog
+   mit „Installieren“.
+3. Tragen Sie Ihren Lizenzschlüssel in das Feld „Licence key“ ein und
+   klicken Sie auf „Speichern“. Claude Desktop speichert den Schlüssel auf
+   Ihrem Rechner.
+4. **Schalten Sie die Erweiterung ein.** Nach der Installation steht
+   „LayoutBridge Light for Adobe InDesign®“ unter Einstellungen › Erweiterungen
+   auf „Deaktiviert“. Stellen Sie den Schalter auf „Aktiviert“ – sonst
+   erscheinen keine Werkzeuge.
+
+**Weg B – npm-Paket (Node.js ab Version 20)**
+
+Einrichtungsbefehl – im Terminal (Mac) bzw. in der PowerShell (Windows)
+aufrufen:
+
+```
+npx layoutbridge-light --setup
+```
+
+Der Befehl trägt den Server in die Konfigurationsdatei von Claude Desktop
+ein und legt den Lizenzschlüssel am Vorgabeort ab (siehe
+„Lizenzschlüssel“). Er läuft nur, wenn Sie ihn aufrufen. Vor jeder Änderung
+zeigt er den vollen Pfad der Datei und den neuen Eintrag im Wortlaut und
+fragt nach (`y` für ja, `n` für nein). Vor dem Schreiben legt er eine
+Sicherung `claude_desktop_config.json.bak-JJJJ-MM-TT_HHMM` im selben Ordner
+an; geändert wird nur der Eintrag `layoutbridge-light` unter `mcpServers`,
+alle anderen Einträge bleiben unverändert. Ist die Datei kein gültiges
+JSON, bricht er ab und nennt Zeile und Spalte. Den Lizenzschlüssel fragt er
+verdeckt ab und schreibt ihn nur nach `license.key`. Keine
+Administratorrechte, keine Netzverbindung. Unter Windows nimmt er den
+Konfigurationsordner des Claude-Desktop-Pakets (siehe „Von Hand“), sofern es
+einen gibt, sonst `%APPDATA%\Claude`, und nennt, welchen er gewählt hat;
+findet er mehrere Claude-Desktop-Pakete und kann nicht erkennen, welches
+benutzt wird, bricht er ab, ohne etwas zu ändern.
+
+- `--dry-run` zeigt dasselbe und schreibt nichts.
+- `--license-key-file <Pfad>` liest den Schlüssel aus einer Datei, statt
+  ihn abzufragen.
+
+**Von Hand:** Öffnen Sie die Konfigurationsdatei von Claude Desktop in
+einem Texteditor. Unter Windows geht das am einfachsten über Einstellungen ›
+Desktop-App › Entwickler › „Konfiguration bearbeiten“: Das öffnet den
+Ordner, den Claude Desktop tatsächlich liest. Bei der üblichen Installation
+als App-Paket ist das
+`%LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json`
+(`<id>` ist eine Folge aus Buchstaben und Ziffern); nur eine Installation
+ohne Paket verwendet `%APPDATA%\Claude\claude_desktop_config.json`. Am Mac
+ist es `~/Library/Application Support/Claude/claude_desktop_config.json`
+(„Konfiguration bearbeiten“ geht dort ebenso). Ist die Datei leer oder noch
+nicht vorhanden, hat sie genau diesen Inhalt:
+
+```json
+{
+  "mcpServers": {
+    "layoutbridge-light": {
+      "command": "npx",
+      "args": ["-y", "layoutbridge-light"]
+    }
+  }
+}
+```
+
+Enthält die Datei bereits andere Server unter `"mcpServers"`, fügen Sie nur
+den Block `"layoutbridge-light": { … }` dort ein – mit einem Komma zwischen
+den Einträgen – und lassen Sie alles andere unverändert. Legen Sie dann den
+Lizenzschlüssel ab (siehe „Lizenzschlüssel“). Beim ersten Start lädt `npx`
+das Paket `layoutbridge-light` von der npm-Registry; danach startet es aus
+dem lokalen Speicher.
+
+**Danach:** Beenden Sie Claude Desktop vollständig – auf dem Mac mit ⌘ + Q,
+unter Windows über „Beenden“ im Menü der Anwendung; das Fenster zu
+schließen genügt nicht – und starten Sie es neu. Starten Sie Adobe®
+InDesign® und fragen Sie in Claude Desktop: „Welche InDesign®-Version
+läuft?“ Claude ruft das Werkzeug `get_app_version` auf und nennt die
+Version. Die Werkzeuge erscheinen auf Weg A unter dem Namen der Erweiterung
+„LayoutBridge Light for Adobe InDesign®“, auf Weg B mit dem Präfix
+`layoutbridge-light:`.
+
+## Andere MCP-Clients
+
+Andere MCP-Clients (Claude Code, Cursor, GitHub Copilot u. a.) tragen
+denselben Server nach ihrer eigenen Dokumentation ein. Der Befehl ist
+überall
+
+```
+npx -y layoutbridge-light
+```
+
+und setzt Node.js ab Version 20 voraus. Den Lizenzschlüssel findet der
+Server an denselben Orten wie unter „Lizenzschlüssel“ beschrieben.
+
+## Lizenzschlüssel
+
+Der Schlüssel steht in der Quittungsmail des Kaufs und gilt für genau einen
+Arbeitsplatz; mehrere Arbeitsplätze brauchen mehrere Schlüssel.
+
+**Wo LayoutBridge den Schlüssel sucht, in dieser Reihenfolge:**
+
+1. die Umgebungsvariable `LAYOUTBRIDGE_LIGHT_LICENSE_KEY` – das
+   Installationspaket setzt sie aus dem Feld „Licence key“; auf Weg B kann
+   sie als `"env": { "LAYOUTBRIDGE_LIGHT_LICENSE_KEY": "IHR-LIZENZSCHLÜSSEL" }`
+   in den Server-Eintrag,
+2. die Datei, die in der Umgebungsvariablen `LAYOUTBRIDGE_LIGHT_LICENSE_FILE`
+   steht,
+3. die Datei `license.key` am Vorgabeort – nur der Schlüssel, ohne weiteren
+   Text:
+   - Mac: `~/Library/Application Support/layoutbridge-light/license.key`
+   - Windows: `%USERPROFILE%\.layoutbridge-light\license.key`
+
+Den Ordner `layoutbridge-light` bzw. `.layoutbridge-light` legen Sie an, falls
+er fehlt. Ein nachgelegter oder geänderter Schlüssel wirkt ohne Neustart.
+
+**Prüfung:** Beim ersten Werkzeugaufruf prüft LayoutBridge den Schlüssel
+online; danach höchstens einmal in 24 Stunden. Ist der Dienst nicht
+erreichbar, arbeitet LayoutBridge ab der letzten gültigen Prüfung 14 Tage
+weiter und hängt jeder Antwort eine Warnung an; danach – oder wenn es noch
+nie eine gültige Prüfung gab – sind die Werkzeuge gesperrt, bis der
+Schlüssel wieder geprüft werden kann.
+
+**Ohne gültigen Schlüssel** antwortet jedes Werkzeug mit `ok: false` und
+`error.kind: "license"`. Die Meldung sagt im Klartext, ob der Schlüssel
+fehlt, abgelaufen, ungültig, für ein anderes Produkt oder gerade nicht
+prüfbar ist, und nennt den Ort, an dem der Schlüssel erwartet wurde;
+`error.details` nennt dazu die Support-Adresse und die Lizenzbedingungen.
+InDesign® wird dabei nicht angesprochen.
+
+**Was gespeichert und übertragen wird:** Das Ergebnis der letzten Prüfung
+steht in `license-state.json` neben `license.key` – mit einem
+Fingerabdruck des Schlüssels, nie dem Schlüssel selbst, und ohne
+Kundendaten. Zur Prüfung gehen der Lizenzschlüssel und eine Kennung dieses
+Arbeitsplatzes an den Zahlungsdienst Polar (`api.polar.sh`, USA). Die
+Kennung ist ein zufälliger Name der Form `layoutbridge-<8 Zeichen>`, der
+beim ersten Mal erzeugt und in
+`instance-name` neben `license.key` abgelegt wird; der Rechnername wird
+nicht verwendet. Wer im Händler-Konto einen lesbaren Namen möchte, setzt
+`LAYOUTBRIDGE_LIGHT_INSTANCE_NAME`. Dokumentinhalte, Dateipfade und
+Werkzeugaufrufe werden nie übertragen.
+
+## Rechnerwechsel
+
+Eine Lizenz ist auf einem Arbeitsplatz aktiv. Geben Sie sie auf dem alten
+Rechner frei, bevor Sie den Schlüssel auf dem neuen eintragen – ohne
+InDesign®, ohne Claude Desktop, aber mit Node.js ab Version 20:
+
+```
+npx layoutbridge-light --deactivate
+```
+
+Der Befehl meldet im Klartext, ob die Freigabe geklappt hat, und löscht das
+lokale Prüfergebnis. Er liest den Schlüssel an denselben Orten wie der
+Server (siehe „Lizenzschlüssel“); beim Installationspaket verwahrt Claude
+Desktop den Schlüssel – legen Sie ihn dann vorher als `license.key` ab oder
+schreiben Sie an den Support. Haben Sie kein Node.js, weil Sie nur das
+Installationspaket nutzen, oder ist der alte Rechner nicht mehr erreichbar,
+können Sie die Aktivierung selbst im Kundenportal von Polar freigeben oder
+an den Support schreiben; er gibt die Aktivierung frei.
+
+## Konfiguration des Servers
+
+Vorgaben, die je Arbeitsplatz verschieden sind, lassen sich in einer
+JSON-Datei festlegen, die der Server beim Start liest: Pfad aus der
+Umgebungsvariablen `LAYOUTBRIDGE_LIGHT_CONFIG`, sonst auf dem Mac
+`~/Library/Application Support/layoutbridge-light/config.json`, unter Windows
+`%USERPROFILE%\.layoutbridge-light\config.json`. Fehlt die Datei, gelten die
+neutralen Vorgaben. Alle Schlüssel sind optional; ein Parameter im Aufruf
+geht immer vor.
+
+```json
+{
+  "tracking_warn_beyond": 20,
+  "min_ppi": 300,
+  "export_pdf": {
+    "preset": "Name des PDF-Presets",
+    "fallback_preset": "Name des Ausweichpresets",
+    "fallback_over_bytes": 4194304
+  }
+}
+```
+
+| Schlüssel | Wirkung |
+|---|---|
+| `tracking_warn_beyond` | `apply_character_format_to_range` warnt, wenn die Laufweite betragsmäßig darüber liegt. Ohne Eintrag keine Warnung. |
+| `min_ppi` | Vorgabe für den Parameter `min_ppi` von `place_image`, `scale_image_in_frame` und `fit_frame` (Warnung unter dieser effektiven Auflösung). Ohne Eintrag 300. |
+| `export_pdf.preset` | Vorgabe für `preset` von `export_pdf`. Ohne Eintrag das lokalisierte „High Quality Print“. |
+| `export_pdf.fallback_preset`, `export_pdf.fallback_over_bytes` | Zweiter Durchgang mit diesem Preset, wenn die Datei größer ist. Ohne Eintrag kein zweiter Durchgang. |
+| `print_on_demand` | Grenzwerte eines Print-on-Demand-Dienstes für `check_print_on_demand` (`min_page_count`, `max_page_count`, `page_count_multiple`, `inside_margin_tiers` als Liste aus `max_pages` und `min_mm`, `min_outside_margin_mm`, `bleed_mm`, `min_font_size_pt`) und Maße für `create_book_cover` (`spine_per_page_mm`, `bleed_mm`, `safety_margin_mm`, `spine_safety_mm`, `barcode_area` mit `width_mm`, `height_mm`, `offset_x_mm`, `offset_y_mm`). Die Werte stehen in den aktuellen Vorgaben Ihres Dienstes. Ohne Eintrag überspringt die Prüfung diesen Punkt. |
+| `epub.min_ppi` | Kleinste effektive Bildauflösung, die `check_epub` bei der Dokumentprüfung annimmt. Ohne Eintrag wird die Bildauflösung nicht geprüft (das allgemeine `min_ppi` gilt nicht für E-Books). |
+
+Unbekannte Schlüssel und falsche Typen meldet der Server beim Start auf der
+Standardfehlerausgabe und ignoriert sie.
+
+## Protokoll
+
+Eine Zeile je Aufruf, eine Datei je laufender Instanz:
+`~/Library/Logs/layoutbridge-light/` auf dem Mac,
+`%USERPROFILE%\.layoutbridge-light\logs\` unter Windows; anderer Ort über die
+Umgebungsvariable `LAYOUTBRIDGE_LIGHT_LOG_DIR`. Das Protokoll bleibt auf
+Ihrem Rechner; es wird nirgendwohin gesendet.
+
+**Was in der Zeile steht (Vorgabe `basic`):** Zeitpunkt, Werkzeugname,
+Dauer, Erfolg, Fehlerart und Fehlertext, Warnungen und die **Namen** der
+übergebenen Parameter. Werte stehen nur dort, wo sie für die Fehlersuche
+nötig und harmlos sind (Zahlen, Kennungen, Aufzählungswerte, Dateipfade).
+Text, der Dokumentinhalt sein kann, erscheint nur als Längenangabe –
+`"<Text, 248 Zeichen>"`. In Pfaden wird Ihr Benutzerverzeichnis durch `~`
+ersetzt. Der Lizenzschlüssel wird nie protokolliert.
+
+**Tiefe einstellen –** `LAYOUTBRIDGE_LIGHT_LOG_LEVEL`:
+
+| Wert | Bedeutung |
+|---|---|
+| `off` | keine Protokollierung, es wird keine Datei angelegt |
+| `basic` | **Vorgabe**, gefiltert wie oben beschrieben |
+| `full` | alle Parameter im Wortlaut, Pfade mit Benutzernamen – nur für die Fehlersuche, auf Bitte des Supports |
+
+Läuft `full`, sagt das die erste Zeile im Protokoll und die Startmeldung des
+Servers. Danach wieder auf `basic` stellen.
+
+**Aufbewahrung:** Beim Start löscht der Server Protokolldateien, die älter
+als **30 Tage** sind. Andere Frist über `LAYOUTBRIDGE_LIGHT_LOG_KEEP_DAYS`
+(Zahl in Tagen; `0` schaltet das Löschen ab).
+
+## License terms
+
+Die Nutzung von LayoutBridge Light for Adobe InDesign® richtet sich nach den
+Lizenzbedingungen (EULA). Maßgeblich ist die deutsche Fassung.
+
+- Deutsch: https://mcp-schnittstellen.de/layoutbridge-light/lizenzbedingungen.html
+- English: https://mcp-interfaces.com/layoutbridge-light/license.html
+
+Der Server nennt die Adresse in seiner Startzeile und in jeder Antwort der
+Fehlerart `license` (`error.details.license_terms`).
+
+## Privacy Policy
+
+Welche Daten der Server verarbeitet – Lizenzprüfung beim Zahlungsdienst,
+Protokoll auf dem eigenen Rechner, nichts weiter – steht in der
+Datenschutzerklärung des Produkts:
+
+- Deutsch: https://mcp-schnittstellen.de/layoutbridge-light/datenschutz.html
+- English: https://mcp-interfaces.com/layoutbridge-light/privacy.html
+
+Die Lizenzprüfung ruft den Zahlungsdienst Polar auf; dessen
+Datenschutzerklärung: https://polar.sh/legal/privacy.
+
+## Support
+
+Fragen und Fehlermeldungen an **kontakt@mcp-interfaces.com**. Wir antworten
+an Werktagen, angestrebt innerhalb von zwei Werktagen. Hilfreich sind:
+Werkzeugname, Fehlertext im Wortlaut, Zeitpunkt, InDesign-Version und
+Betriebssystem. Schicken Sie uns **nie Ihren Lizenzschlüssel**.
+
+Eine kopierte Fehlermeldung kann Dateinamen und den Ordnerweg unterhalb
+Ihres Benutzerverzeichnisses sowie Bezeichnungen aus dem Dokument
+(Seiten, Rahmen, Formate) enthalten – keinen Benutzernamen, keinen
+Dokumenttext, keinen Lizenzschlüssel. Fehlerkorrekturen werden
+schnellstmöglich umgesetzt.
+
+## Third-party notices
+
+Das Paket enthält Software Dritter (Laufzeitabhängigkeiten einschließlich
+transitiver Pakete). Name, Version, Lizenz, Urheberzeile und vollständiger
+Lizenztext je Paket stehen in `THIRD-PARTY-NOTICES.md` (im npm-Paket und im
+Installationspaket enthalten).
+
+## Versionen und Changelog
+
+Ein Release im Monat mit Katalog der neuen Funktionen; Fehlerkorrekturen
+werden schnellstmöglich und unabhängig davon umgesetzt. Alle Änderungen
+stehen in `CHANGELOG.md` (im Paket enthalten). Innerhalb einer
+Hauptversion bleiben Werkzeugnamen, Parameter und Rückgabefelder stabil;
+Ergänzungen sind additiv.
+
+## Lizenz
+
+Proprietär, alle Rechte vorbehalten. Siehe `LICENSE`.