likec4/likec4 v1.59.3

on GitHub

🚀 Features

• MCP Apps: render-view and preview-view:
  render-view renders a LikeC4 view as an interactive diagram (pan/zoom/fit) inline in MCP hosts that support MCP Apps, alongside the existing text-only read-view. preview-view renders a preview of a view defined by DSL text within the context of an existing project's real elements, without saving to disk — so view definitions can be experimented with before adding them to the project. Thanks @kgeilmann, #3174

• Markdown Export:
  New generateMarkdown generator and likec4 export markdown [path] command render a project's views as a single GitHub-flavored Markdown document, with embedded Mermaid diagrams. Writes one README.md per project into that project's own folder, or use --project to restrict to one — so the rendered architecture is browsable directly on GitHub, with no server and no manual diagram assembly. Thanks @StefanStuehrmann, #3160

• Bidirectional Relationships:
  Model relationships can use the documented <-> and -[kind]<-> syntax. Bidirectional semantics are preserved through styling and relationship extensions, and such relationships can be included or excluded from either endpoint in view relationship expressions. Thanks @ckeller42, #2949, fixes #2927

• Global Predicates in View Groups:
  Global predicate groups can be referenced inside view groups, so a reusable set of predicates can be scoped into a named group. Thanks @farhan523, #3147

• View Order Metadata:
  Optional view order metadata for sorting sibling views in navigation. Thanks @merlincat11, #3150

• Configurable Webapp Export Formats:
  Generated webapps can limit the available export formats from project config. Omitting webapp.exportFormats keeps all current formats enabled; an empty list hides webapp exports. Thanks @ckeller42, #3078

• Project-scoped Web Components:
  Define project-scoped LikeC4 web components directly from the Vite plugin with likec4:webcomponents/<project-id>. Thanks @JJordan0C, #3161

• Escaping / in Titles:
  Escape a forward slash in a title with \/ so it doesn't create a view folder. This also applies to element titles, so implicitViews no longer split an auto-generated view into an unwanted subfolder when the element's title contains a slash. Thanks @AndersHogqvist, #3215

• Syntax Highlighting in Markdown Blocks:
  Language-tagged Markdown code blocks and combined diff-<language> blocks are syntax highlighted in diagram descriptions and notes. Thanks @ekisu, #3196

• Manual Layout Editor:
  Manual layouts can be saved and reset for implicit element views, and the built-in manual-layout comparison state and actions are exposed to custom viewers. Embedded editors can skip waiting for a refreshed view after applying a change locally. Thanks @Phrogz, #3188, #3190, #3166

🐞 Bug Fixes

• Fixed --theme light and --theme dark export flags not applying the requested theme in PNG and JPEG diagram exports. Thanks @Abhirup0, #3193

• Fixed crash when clicking another step during a walkthrough in a diagram-variant dynamic view. Thanks @wataryooou, #3200, fixes #3201

• Fixed likec4 mcp ignoring the LIKEC4_WORKSPACE environment variable. The command overrode the shared path default, so the workspace always fell back to the current directory and the server silently served an empty model. Thanks @tnucera, #3204

• Fixed generated output using CRLF line endings on Windows. Markdown, Mermaid, D2, PlantUML and LikeC4 DSL exports now always emit LF, so generated files are byte-identical across platforms. #3210

• Fixed likec4 validate --file reporting filteredFiles: 0 for clean files. Every file matched by the filter is now counted, including files with no diagnostics. Thanks @luantaraschi, #3182

• Fixed keyword completions inserting the keyword twice (e.g. modelmodel) in editors other than VS Code. Thanks @farhan523, #3146

• Fixed outline entries merging an element's kind into its name, such as modelmodel. The kind now renders in parentheses. Thanks @bounce12340, #3151, fixes #3091

• Fixed Bootstrap icons in the VS Code preview so iconColor colors them correctly. Thanks @ckeller42, #3144

• Preserve original colors for non-Bootstrap diagram icons, including bundled brand, cloud provider, and image-based icons. Thanks @ckeller42, #3154, fixes #3153

• Render custom SVG icons reliably in relationship views, and allow local SVG icons that use currentColor to follow iconColor. Thanks @ckeller42, #3155

• Avoid overlapping-area warnings when multiple projects intentionally include the same shared folder. Nested or partially overlapping include paths still warn because those can make file ownership ambiguous. Thanks @ckeller42, #3156, fixes #2973

• Preserve imported project prefixes for scoped view of element views. Thanks @ckeller42, #3143

• Keep automatically routed relationships automatic when moving connected nodes in the layout editor. Thanks @Phrogz, #3187, fixes #3184

• Restore node dragging and selection when the editor finishes synchronizing a layout change. Thanks @Phrogz, #3164

• Hide the manual layout tools tooltip while its popover is open. Thanks @Phrogz, #3176

Full changelog: v1.59.2...v1.59.3