likec4 1.55.0 → 1.56.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/__app__/chunks/ColorSchemeToggle.mjs +1 -0
- package/__app__/chunks/DiagramActorProvider.mjs +10 -0
- package/__app__/chunks/Fallback.mjs +1 -0
- package/__app__/chunks/Header.mjs +13 -0
- package/__app__/chunks/IconRenderer.mjs +1 -0
- package/__app__/chunks/LikeC4Diagram.mjs +19 -0
- package/__app__/chunks/LikeC4ModelContext.mjs +1 -0
- package/__app__/chunks/LikeC4ModelContext2.mjs +1 -0
- package/__app__/chunks/LikeC4Styles.mjs +48 -0
- package/__app__/chunks/NavigationPanel.mjs +1 -0
- package/__app__/chunks/StaticLikeC4Diagram.mjs +1 -0
- package/__app__/chunks/ViewReact.mjs +1 -0
- package/__app__/chunks/__root.mjs +1 -0
- package/__app__/chunks/adhoc-editor.mjs +1 -0
- package/__app__/chunks/hooks.mjs +1 -0
- package/__app__/chunks/libs/@dagrejs/dagre.mjs +1 -0
- package/__app__/chunks/libs/@floating-ui/core.mjs +1 -0
- package/__app__/chunks/libs/@floating-ui/dom.mjs +1 -0
- package/__app__/chunks/libs/@floating-ui/react.mjs +1 -0
- package/__app__/chunks/libs/@mantine/core.mjs +41 -0
- package/__app__/chunks/libs/@mantine/hooks.mjs +1 -0
- package/__app__/chunks/libs/@nanostores/react.mjs +1 -0
- package/__app__/chunks/libs/@react-hookz/web.mjs +1 -0
- package/__app__/chunks/libs/@tabler/icons-react.mjs +15 -0
- package/__app__/chunks/libs/@tanstack/history.mjs +1 -0
- package/__app__/chunks/libs/@tanstack/react-router.mjs +3 -0
- package/__app__/chunks/libs/@tanstack/router-core.mjs +1 -0
- package/__app__/chunks/libs/@xstate/react.mjs +1 -0
- package/__app__/chunks/libs/@xstate/store.mjs +1 -0
- package/__app__/chunks/libs/@xyflow/react.mjs +7 -0
- package/__app__/chunks/libs/@zag-js/anatomy.mjs +1 -0
- package/__app__/chunks/libs/@zag-js/collection.mjs +1 -0
- package/__app__/chunks/libs/@zag-js/core.mjs +1 -0
- package/__app__/chunks/libs/@zag-js/react.mjs +1 -0
- package/__app__/chunks/libs/@zag-js/tree-view.mjs +1 -0
- package/__app__/chunks/libs/bezier-js.mjs +1 -0
- package/__app__/chunks/libs/d3-path.mjs +1 -0
- package/__app__/chunks/libs/d3-shape.mjs +1 -0
- package/__app__/chunks/libs/fast-equals.mjs +1 -0
- package/__app__/chunks/libs/framer-motion.mjs +9 -0
- package/__app__/chunks/libs/html-to-image.mjs +2 -0
- package/__app__/chunks/libs/motion-dom.mjs +1 -0
- package/__app__/chunks/libs/motion.mjs +1 -0
- package/__app__/chunks/libs/nanostores.mjs +1 -0
- package/__app__/chunks/libs/react-error-boundary.mjs +1 -0
- package/__app__/chunks/libs/react-resizable-panels.mjs +1 -0
- package/__app__/chunks/libs/remeda.mjs +1 -0
- package/__app__/chunks/libs/xstate.mjs +1 -0
- package/__app__/chunks/libs/zod.mjs +39 -0
- package/__app__/chunks/rolldown-runtime.mjs +1 -0
- package/__app__/chunks/safeCtx.mjs +1 -0
- package/__app__/chunks/searchParams.mjs +1 -0
- package/__app__/chunks/single-index.mjs +1 -0
- package/__app__/chunks/styled-system.mjs +1 -0
- package/__app__/chunks/styles.css.mjs +1 -0
- package/__app__/chunks/useLikeC4Project.mjs +1 -0
- package/__app__/chunks/useUpdateEffect.mjs +1 -0
- package/__app__/codegen/react.mjs +11 -0
- package/__app__/codegen/webcomponent.mjs +790 -0
- package/__app__/src/fonts.css +1 -1
- package/__app__/src/main.mjs +1 -0
- package/__app__/src/pages/AdHocViewEditor.mjs +1 -0
- package/__app__/src/pages/EmbedPage.mjs +1 -0
- package/__app__/src/pages/ExportPage.mjs +1 -0
- package/__app__/src/pages/ProjectsOverview.mjs +1 -0
- package/__app__/src/pages/ViewAsD2.mjs +1 -0
- package/__app__/src/pages/ViewAsDot.mjs +1 -0
- package/__app__/src/pages/ViewAsMmd.mjs +1 -0
- package/__app__/src/pages/ViewAsPuml.mjs +1 -0
- package/__app__/src/pages/ViewEditor.mjs +1 -0
- package/__app__/src/pages/ViewReact.mjs +1 -0
- package/__app__/src/routeTree.gen.mjs +1 -0
- package/__app__/src/routes/__root.mjs +1 -0
- package/__app__/src/routes/_single/adhoc.mjs +1 -0
- package/__app__/src/routes/_single/embed._viewId.mjs +1 -0
- package/__app__/src/routes/_single/export._viewId.mjs +1 -0
- package/__app__/src/routes/_single/route.mjs +1 -0
- package/__app__/src/routes/_single/single-index.mjs +1 -0
- package/__app__/src/routes/_single/view._viewId.d2.mjs +1 -0
- package/__app__/src/routes/_single/view._viewId.dot.mjs +1 -0
- package/__app__/src/routes/_single/view._viewId.index.mjs +1 -0
- package/__app__/src/routes/_single/view._viewId.mjs +1 -0
- package/__app__/src/routes/_single/view._viewId.mmd.mjs +1 -0
- package/__app__/src/routes/_single/view._viewId.puml.mjs +1 -0
- package/__app__/src/routes/_single/webcomponent._.mjs +33 -0
- package/__app__/src/routes/index.mjs +1 -0
- package/__app__/src/routes/project._projectId/-components.mjs +1 -0
- package/__app__/src/routes/project._projectId/adhoc.mjs +1 -0
- package/__app__/src/routes/project._projectId/embed._viewId.mjs +1 -0
- package/__app__/src/routes/project._projectId/export._viewId.mjs +1 -0
- package/__app__/src/routes/project._projectId/index.mjs +1 -0
- package/__app__/src/routes/project._projectId/route.mjs +1 -0
- package/__app__/src/routes/project._projectId/view._viewId.d2.mjs +1 -0
- package/__app__/src/routes/project._projectId/view._viewId.dot.mjs +1 -0
- package/__app__/src/routes/project._projectId/view._viewId.index.mjs +1 -0
- package/__app__/src/routes/project._projectId/view._viewId.mjs +1 -0
- package/__app__/src/routes/project._projectId/view._viewId.mmd.mjs +1 -0
- package/__app__/src/routes/project._projectId/view._viewId.puml.mjs +1 -0
- package/__app__/src/routes/projects.mjs +1 -0
- package/__app__/src/style.css +1 -1
- package/dist/chunks/filenames.mjs +17 -0
- package/dist/{_chunks → chunks}/index.d.mts +2 -1
- package/dist/{_chunks → chunks}/index2.d.mts +71 -12
- package/dist/chunks/libs/@chevrotain/gast.mjs +1 -0
- package/dist/chunks/libs/@chevrotain/regexp-to-ast.mjs +9 -0
- package/dist/chunks/libs/@chevrotain/utils.mjs +1 -0
- package/dist/chunks/libs/@hono/mcp.mjs +45 -0
- package/dist/chunks/libs/@hono/node-server.mjs +1 -0
- package/dist/{_chunks → chunks}/libs/@logtape/logtape.d.mts +2 -0
- package/dist/chunks/libs/@logtape/logtape.mjs +4 -0
- package/dist/chunks/libs/@lume/kiwi.mjs +1 -0
- package/dist/chunks/libs/@modelcontextprotocol/sdk.mjs +12 -0
- package/dist/chunks/libs/ajv.mjs +1 -0
- package/dist/chunks/libs/ansi-align.mjs +2 -0
- package/dist/chunks/libs/ansi-regex.mjs +1 -0
- package/dist/chunks/libs/ansi-styles.mjs +1 -0
- package/dist/chunks/libs/atomically.mjs +1 -0
- package/dist/chunks/libs/birpc.mjs +1 -0
- package/dist/chunks/libs/boxen.mjs +22 -0
- package/dist/chunks/libs/chevrotain-allstar.mjs +2 -0
- package/dist/chunks/libs/chevrotain.mjs +58 -0
- package/dist/chunks/libs/conf.mjs +1 -0
- package/dist/chunks/libs/defu.mjs +1 -0
- package/dist/chunks/libs/destr.mjs +1 -0
- package/dist/chunks/libs/eventemitter3.mjs +1 -0
- package/dist/chunks/libs/find-up-simple.mjs +1 -0
- package/dist/chunks/libs/get-port.mjs +1 -0
- package/dist/chunks/libs/hono.mjs +1 -0
- package/dist/chunks/libs/is-docker.mjs +1 -0
- package/dist/chunks/libs/is-error-instance.mjs +1 -0
- package/dist/chunks/libs/is-inside-container.mjs +1 -0
- package/dist/chunks/libs/is-plain-obj.mjs +1 -0
- package/dist/chunks/libs/isexe.mjs +1 -0
- package/dist/chunks/libs/json5.mjs +14 -0
- package/dist/chunks/libs/khroma.mjs +1 -0
- package/dist/chunks/libs/ky.mjs +3 -0
- package/dist/{_chunks → chunks}/libs/langium.d.mts +4 -4
- package/dist/chunks/libs/langium.mjs +32 -0
- package/dist/chunks/libs/merge-error-cause.mjs +2 -0
- package/dist/chunks/libs/p-debounce.mjs +1 -0
- package/dist/chunks/libs/p-limit.mjs +1 -0
- package/dist/chunks/libs/p-queue.mjs +1 -0
- package/dist/chunks/libs/p-timeout.mjs +1 -0
- package/dist/chunks/libs/package-manager-detector.mjs +1 -0
- package/dist/chunks/libs/package-up.mjs +1 -0
- package/dist/chunks/libs/pako.mjs +1 -0
- package/dist/chunks/libs/parse-ms.mjs +1 -0
- package/dist/chunks/libs/pathe.mjs +1 -0
- package/dist/chunks/libs/picomatch.mjs +1 -0
- package/dist/chunks/libs/pretty-ms.mjs +1 -0
- package/dist/chunks/libs/remeda.mjs +1 -0
- package/dist/chunks/libs/safe-stringify.mjs +1 -0
- package/dist/chunks/libs/strip-indent.mjs +1 -0
- package/dist/chunks/libs/tinyrainbow.mjs +1 -0
- package/dist/{_chunks → chunks}/libs/ts-graphviz.d.mts +2 -0
- package/dist/chunks/libs/ts-graphviz.mjs +4 -0
- package/dist/chunks/libs/ufo.mjs +1 -0
- package/dist/chunks/libs/unstorage.mjs +1 -0
- package/dist/chunks/libs/which.mjs +1 -0
- package/dist/chunks/libs/word-wrap.mjs +12 -0
- package/dist/{_chunks → chunks}/libs/zod.d.mts +2 -0
- package/dist/chunks/node.mjs +76 -0
- package/dist/chunks/plugin.mjs +400 -0
- package/dist/chunks/rolldown-runtime.mjs +1 -0
- package/dist/chunks/sequence-view.mjs +1 -0
- package/dist/cli/index.mjs +262 -123
- package/dist/config/index.d.mts +1 -2
- package/dist/config/index.mjs +1 -1
- package/dist/index.d.mts +4 -8
- package/dist/index.mjs +1 -1
- package/dist/model/index.d.mts +2 -1
- package/dist/model/index.mjs +1 -1
- package/dist/vite-plugin/index.d.mts +38 -8
- package/dist/vite-plugin/index.mjs +1 -1
- package/dist/{_chunks → vite-plugin/internal/chunks}/libs/@nanostores/react.d.mts +2 -56
- package/dist/vite-plugin/internal/chunks/libs/@nanostores/react.mjs +1 -0
- package/dist/vite-plugin/internal/chunks/libs/birpc.mjs +1 -0
- package/dist/vite-plugin/internal/chunks/libs/fast-equals.mjs +1 -0
- package/dist/vite-plugin/internal/chunks/libs/nanostores.d.mts +59 -0
- package/dist/vite-plugin/internal/chunks/libs/nanostores.mjs +1 -0
- package/dist/vite-plugin/internal/chunks/libs/remeda.mjs +1 -0
- package/dist/vite-plugin/internal/chunks/rolldown-runtime.mjs +1 -0
- package/dist/vite-plugin/{internal.d.mts → internal/index.d.mts} +12 -3
- package/dist/vite-plugin/internal/index.mjs +1 -0
- package/package.json +37 -57
- package/react/index.d.mts +2 -28
- package/react/index.mjs +50520 -53827
- package/vite-plugin/internal/package.json +2 -2
- package/vite-plugin-modules.d.ts +14 -0
- package/__app__/react/likec4.tsx +0 -25
- package/__app__/src/ProjectsOverview.js +0 -16
- package/__app__/src/const.js +0 -19
- package/__app__/src/likec4.js +0 -21225
- package/__app__/src/main.js +0 -7
- package/__app__/src/routes/index.js +0 -324
- package/__app__/src/routes/projects.js +0 -189
- package/__app__/src/routes/single.js +0 -1924
- package/__app__/src/vendors.js +0 -52672
- package/__app__/src/webcomponent.js +0 -68
- package/dist/THIRD-PARTY-LICENSES.md +0 -1609
- package/dist/_chunks/libs/@chevrotain/cst-dts-gen.mjs +0 -30
- package/dist/_chunks/libs/@chevrotain/regexp-to-ast.mjs +0 -9
- package/dist/_chunks/libs/@chevrotain/types.d.mts +0 -1
- package/dist/_chunks/libs/@chevrotain/utils.mjs +0 -1
- package/dist/_chunks/libs/@hono/mcp.mjs +0 -45
- package/dist/_chunks/libs/@hono/node-server.mjs +0 -1
- package/dist/_chunks/libs/@logtape/logtape.mjs +0 -4
- package/dist/_chunks/libs/@lume/kiwi.mjs +0 -1
- package/dist/_chunks/libs/@modelcontextprotocol/sdk.mjs +0 -12
- package/dist/_chunks/libs/@nanostores/react.mjs +0 -1
- package/dist/_chunks/libs/ajv.mjs +0 -1
- package/dist/_chunks/libs/ansi-align.mjs +0 -2
- package/dist/_chunks/libs/ansi-regex.mjs +0 -1
- package/dist/_chunks/libs/ansi-styles.mjs +0 -1
- package/dist/_chunks/libs/atomically.mjs +0 -1
- package/dist/_chunks/libs/birpc.mjs +0 -1
- package/dist/_chunks/libs/boxen.mjs +0 -22
- package/dist/_chunks/libs/chevrotain-allstar.mjs +0 -2
- package/dist/_chunks/libs/chevrotain.mjs +0 -58
- package/dist/_chunks/libs/conf.mjs +0 -1
- package/dist/_chunks/libs/defu.mjs +0 -1
- package/dist/_chunks/libs/destr.mjs +0 -1
- package/dist/_chunks/libs/esm-env.mjs +0 -1
- package/dist/_chunks/libs/eventemitter3.mjs +0 -1
- package/dist/_chunks/libs/fast-equals.mjs +0 -1
- package/dist/_chunks/libs/find-up-simple.mjs +0 -1
- package/dist/_chunks/libs/get-port.mjs +0 -1
- package/dist/_chunks/libs/is-docker.mjs +0 -1
- package/dist/_chunks/libs/is-error-instance.mjs +0 -1
- package/dist/_chunks/libs/is-inside-container.mjs +0 -1
- package/dist/_chunks/libs/is-plain-obj.mjs +0 -1
- package/dist/_chunks/libs/isexe.mjs +0 -1
- package/dist/_chunks/libs/json5.mjs +0 -14
- package/dist/_chunks/libs/khroma.mjs +0 -1
- package/dist/_chunks/libs/ky.mjs +0 -3
- package/dist/_chunks/libs/langium.mjs +0 -33
- package/dist/_chunks/libs/merge-error-cause.mjs +0 -2
- package/dist/_chunks/libs/p-limit.mjs +0 -1
- package/dist/_chunks/libs/p-queue.mjs +0 -1
- package/dist/_chunks/libs/p-timeout.mjs +0 -1
- package/dist/_chunks/libs/package-manager-detector.mjs +0 -1
- package/dist/_chunks/libs/package-up.mjs +0 -1
- package/dist/_chunks/libs/pako.mjs +0 -1
- package/dist/_chunks/libs/parse-ms.mjs +0 -1
- package/dist/_chunks/libs/pathe.mjs +0 -1
- package/dist/_chunks/libs/picomatch.mjs +0 -1
- package/dist/_chunks/libs/pretty-ms.mjs +0 -1
- package/dist/_chunks/libs/remeda.mjs +0 -2
- package/dist/_chunks/libs/safe-stringify.mjs +0 -1
- package/dist/_chunks/libs/strip-indent.mjs +0 -1
- package/dist/_chunks/libs/tinyrainbow.mjs +0 -1
- package/dist/_chunks/libs/ts-graphviz.mjs +0 -4
- package/dist/_chunks/libs/ufo.mjs +0 -1
- package/dist/_chunks/libs/unstorage.mjs +0 -1
- package/dist/_chunks/libs/which.mjs +0 -1
- package/dist/_chunks/libs/word-wrap.mjs +0 -12
- package/dist/_chunks/node.mjs +0 -76
- package/dist/_chunks/rolldown-runtime.mjs +0 -1
- package/dist/_chunks/sequence.mjs +0 -1
- package/dist/_chunks/src.mjs +0 -17
- package/dist/_chunks/src2.mjs +0 -499
- package/dist/vite-plugin/internal.mjs +0 -1
- /package/dist/{_chunks → chunks}/libs/vscode-languageserver.mjs +0 -0
package/dist/cli/index.mjs
CHANGED
|
@@ -1,5 +1,47 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{
|
|
2
|
+
import{c as e,i as t}from"../chunks/rolldown-runtime.mjs";import{a as n,c as r,d as i,f as a,i as s,l as c,n as l,o as u,r as f,s as p,u as m}from"../chunks/node.mjs";import{t as h}from"../chunks/libs/defu.mjs";import{H as g,V as _,a as v,i as y,n as b,r as x,t as ee}from"../chunks/libs/langium.mjs";import{t as S}from"../chunks/libs/tinyrainbow.mjs";import{c as C,l as te,o as ne,r as w,s as T}from"../chunks/libs/ufo.mjs";import{t as E}from"../chunks/libs/json5.mjs";import{n as re,r as ie,t as ae}from"../chunks/libs/@hono/mcp.mjs";import{A as oe,C as se,G as ce,Q as le,X as ue,et as de,m as fe,q as pe,t as me,w as he,x as D,y as ge}from"../chunks/libs/remeda.mjs";import{t as _e}from"../chunks/libs/pretty-ms.mjs";import{t as ve}from"../chunks/libs/picomatch.mjs";import{n as ye}from"../chunks/libs/strip-indent.mjs";import{a as be,c as xe,i as Se,n as Ce,o as we,r as Te,s as Ee,t as De}from"../chunks/plugin.mjs";import{LikeC4Model as Oe}from"../model/index.mjs";import{t as O}from"../chunks/libs/is-inside-container.mjs";import{t as ke}from"../chunks/libs/boxen.mjs";import{t as Ae}from"../chunks/libs/package-up.mjs";import{n as je,t as Me}from"../chunks/libs/package-manager-detector.mjs";import{n as Ne,t as Pe}from"../chunks/libs/conf.mjs";import{a as k,c as A,d as j,f as Fe,i as Ie,l as M,n as N,o as P,p as Le,r as F,s as I,t as Re,u as L}from"../chunks/libs/@modelcontextprotocol/sdk.mjs";import{t as ze}from"../chunks/libs/ky.mjs";import{n as Be,t as Ve}from"../chunks/libs/get-port.mjs";import{t as He}from"../chunks/libs/vscode-languageserver.mjs";import{t as Ue}from"../chunks/libs/hono.mjs";import{t as We}from"../chunks/libs/@hono/node-server.mjs";import Ge from"node:module";import{invariant as R,nonexhaustive as Ke}from"@likec4/core";import{basename as qe,dirname as z,extname as Je,isAbsolute as Ye,join as B,relative as V,resolve as H,sep as Xe}from"node:path";import{compareNatural as Ze,ifilter as Qe,invariant as $e,isSameHierarchy as et,sortNaturalByFqn as tt}from"@likec4/core/utils";import{isDeploymentElementModel as nt,isDeploymentNodeModel as rt,isDeploymentRelationModel as it,isElementModel as at,isLikeC4ViewModel as ot,isRelationModel as st,modelConnection as ct}from"@likec4/core/model";import lt from"nano-spawn";import{tmpdir as ut}from"node:os";import{copyFileSync as dt,existsSync as U,readFileSync as ft,readdirSync as pt,rmSync as mt,statSync as ht}from"node:fs";import{copyFile as gt,mkdir as W,mkdtemp as _t,readFile as vt,readdir as yt,realpath as bt,rm as xt,stat as St,writeFile as G}from"node:fs/promises";import{fileURLToPath as Ct,pathToFileURL as wt}from"node:url";import{env as Tt,isCI as Et,isDevelopment as Dt,isTest as Ot,nodeENV as kt}from"std-env";import{argv as At,cwd as jt,exit as Mt,hrtime as Nt,stdout as Pt}from"node:process";import Ft from"yargs";import{hideBin as It}from"yargs/helpers";import{build as Lt,createServer as Rt,preview as zt}from"vite";import Bt from"@vitejs/plugin-react";import{viteSingleFile as Vt}from"vite-plugin-singlefile";import{setTimeout as Ht}from"node:timers/promises";import{setTimeout as Ut}from"node:timers";function toUnion(e){return e.length===0?`never`:e.sort(Ze).map(e=>` | ${JSON.stringify(e)}`).join(`
|
|
3
|
+
`).trimStart()}function elementIdToUnion(e){let t=me(e);return t.length===0?`never`:le(t,tt,ge(e=>` | ${JSON.stringify(e.id)}`)).join(`
|
|
4
|
+
`).trimStart()}function generateAux(e,t={}){let{useCorePackage:n=!1}=t;return`
|
|
5
|
+
import type { Aux, SpecAux } from '${n?`@likec4/core/types`:`likec4/model`}';
|
|
6
|
+
|
|
7
|
+
export type $Specs = SpecAux<
|
|
8
|
+
// Element kinds
|
|
9
|
+
${toUnion(D(e.specification.elements))},
|
|
10
|
+
// Deployment kinds
|
|
11
|
+
${toUnion(D(e.specification.deployments??{}))},
|
|
12
|
+
// Relationship kinds
|
|
13
|
+
${toUnion(D(e.specification.relationships??{}))},
|
|
14
|
+
// Tags
|
|
15
|
+
${toUnion(D(e.specification.tags??{}))},
|
|
16
|
+
// Metadata keys
|
|
17
|
+
${toUnion(e.specification.metadataKeys??[])}
|
|
18
|
+
>
|
|
19
|
+
|
|
20
|
+
export type $Aux = Aux<
|
|
21
|
+
${JSON.stringify(e.stage)},
|
|
22
|
+
// Elements
|
|
23
|
+
${elementIdToUnion(e.$data.elements)},
|
|
24
|
+
// Deployments
|
|
25
|
+
${elementIdToUnion(e.$data.deployments.elements)},
|
|
26
|
+
// Views
|
|
27
|
+
${toUnion(D(e.$data.views))},
|
|
28
|
+
// Project ID
|
|
29
|
+
${JSON.stringify(e.projectId)},
|
|
30
|
+
$Specs
|
|
31
|
+
>
|
|
32
|
+
|
|
33
|
+
export type $ElementId = $Aux['ElementId']
|
|
34
|
+
export type $DeploymentId = $Aux['DeploymentId']
|
|
35
|
+
export type $ViewId = $Aux['ViewId']
|
|
36
|
+
|
|
37
|
+
export type $ElementKind = $Aux['ElementKind']
|
|
38
|
+
export type $RelationKind = $Aux['RelationKind']
|
|
39
|
+
export type $DeploymentKind = $Aux['DeploymentKind']
|
|
40
|
+
export type $Tag = $Aux['Tag']
|
|
41
|
+
export type $Tags = readonly $Aux['Tag'][]
|
|
42
|
+
export type $MetadataKey = $Aux['MetadataKey']
|
|
43
|
+
`.trimStart()}function generateLikeC4Model(e,t={}){let n=generateAux(e,t),{useCorePackage:r=!1}=t;return`
|
|
44
|
+
/* prettier-ignore-start */
|
|
3
45
|
/* eslint-disable */
|
|
4
46
|
|
|
5
47
|
/******************************************************************************
|
|
@@ -7,43 +49,128 @@ import{s as e}from"../_chunks/rolldown-runtime.mjs";import"../_chunks/libs/birpc
|
|
|
7
49
|
* DO NOT EDIT MANUALLY!
|
|
8
50
|
******************************************************************************/
|
|
9
51
|
|
|
10
|
-
|
|
52
|
+
import { LikeC4Model } from '${r?`@likec4/core`:`likec4`}/model'
|
|
53
|
+
${n}
|
|
54
|
+
|
|
55
|
+
export const likec4model: LikeC4Model<$Aux> = new LikeC4Model(${E.stringify(e.$data,{space:2,quote:`'`})} as any) as any
|
|
11
56
|
|
|
12
57
|
/* prettier-ignore-end */
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
`))}catch{}}function Y(){var e=typeof SuppressedError==`function`?SuppressedError:function(e,t){var n=Error();return n.name=`SuppressedError`,n.error=e,n.suppressed=t,n},t={},n=[];function r(e,t){if(t!=null){if(Object(t)!==t)throw TypeError(`using declarations can only be used with objects, functions, null, or undefined.`);if(e)var r=t[Symbol.asyncDispose||Symbol.for(`Symbol.asyncDispose`)];if(r===void 0&&(r=t[Symbol.dispose||Symbol.for(`Symbol.dispose`)],e))var i=r;if(typeof r!=`function`)throw TypeError(`Object is not disposable.`);i&&(r=function e(){try{i.call(t)}catch(e){return Promise.reject(e)}}),n.push({v:t,d:r,a:e})}else e&&n.push({d:t,a:e});return t}return{e:t,u:r.bind(null,!1),a:r.bind(null,!0),d:function r(){var i,a=this.e,o=0;function s(){for(;i=n.pop();)try{if(!i.a&&o===1)return o=0,n.push(i),Promise.resolve().then(s);if(i.d){var e=i.d.call(i.v);if(i.a)return o|=2,Promise.resolve(e).then(s,c)}else o|=1}catch(e){return c(e)}if(o===1)return a===t?Promise.resolve():Promise.reject(a);if(a!==t)throw a}function c(n){return a=a===t?n:new e(n,a),s()}return s()}}}const Tn=e=>e.command({command:`build [path]`,aliases:[`bundle`],describe:`Build a static website`,builder:e=>e.positional(`path`,W).option(`output`,{alias:`o`,type:`string`,desc:`output directory for production build`,normalize:!0,coerce:F}).option(`base`,mn).option(`use-hash-history`,un).option(`use-dot`,G).option(`webcomponent-prefix`,dn).option(`title`,fn).option(`output-single-file`,hn).option(`theme`,pn).example(`${x.green(`$0 build -o ./build ./src`)}`,x.gray(`Search for likec4 files in 'src' and output static site to 'build'`)).example(`${x.green(`$0 build --theme dark -o ./build ./src`)}`,x.gray(`Build with dark color scheme as default`)),handler:async e=>{try{var t=Y();let n={useHashHistory:e[`use-hash-history`]??!1,useDotBin:e[`use-dot`],webcomponentPrefix:e[`webcomponent-prefix`],outputSingleFile:e[`output-single-file`]??!1};await sn();let r=V(`c4:build`),i=t.a(await v(e.path,{graphviz:e[`use-dot`]?`binary`:`wasm`,watch:!1})),a=e.output??F(i.workspace,`dist`),o=F(a,`assets`);await an({base:e.base,useHashHistory:n.outputSingleFile||n.useHashHistory,customLogger:r,webcomponentPrefix:n.webcomponentPrefix,title:e.title,theme:e.theme,languageServices:i,likec4AssetsDir:o,outputDir:a,outputSingleFile:n.outputSingleFile}),J()}catch(e){t.e=e}finally{await t.d()}}});var En=e(Pe(),1);const Dn=`check-update`;async function On(){if(dt||pt||mt===Dn)return;let e=Sn(),t=e.get(`lastUpdateCheck`);if(!t){await kn(!1);return}let n=e.get(`latestVersion`);if(s(n)||s(t)||t+864e5<Date.now())try{ct(`likec4`,[`check-update`],{stdio:`ignore`,timeout:5e3,preferLocal:!0,detached:!0,env:{NODE_ENV:Dn}}).catch(()=>{})}catch{}n&&(0,En.gt)(n,xn.version)&&U([`Update available: `,x.dim(xn.version),x.reset(` → `),x.green(n)].join(``))}async function kn(e=!0){try{let t=Sn();t.set({lastUpdateCheck:Date.now()});let n=await An();j(n,`No version found in latest npm`),t.set({lastUpdateCheck:Date.now(),latestVersion:n}),(0,En.gt)(n,xn.version)?U([`Update available: `,x.dim(xn.version),x.reset(` → `),x.green(n)].join(``)):e&&U(x.dim(`Up to date: `)+` `+x.green(xn.version))}catch(e){B.warning(h(e))}}async function An(){return(await Ve(`https://registry.npmjs.org/likec4/latest`,{headers:{accept:`application/vnd.npm.install-v1+json; q=1.0, application/json; q=0.8, */*`},timeout:5e3,keepalive:!0}).json()).version}const jn=e=>e.command({command:`check-update`,describe:`Check for updates`,handler:async()=>{await kn()}});function Mn(e,t){if(!t)return e.languageServices.projectsManager.ensureProjectId();let n=F(t);if(n===e.workspace)return e.languageServices.projectsManager.ensureProjectId();if(z(n)&&Et(n).isDirectory()){B.debug`Project path exists: ${n}`;let t=re.file(n.endsWith(it)?n:n+it),r=e.languageServices.projects().find(e=>e.folder.fsPath===t.fsPath);if(r)return B.debug`Found project ${r.id} at path: ${n}`,r.id;B.debug`No project registered at path: ${n}`}return e.languageServices.projectsManager.ensureProjectId(t)}function Nn(e,t){let n=Mn(e,t),r=e.languageServices.projectsManager.getProject(n);return e.languageServices.projectsManager.defaultProjectId=n,{projectId:n,projectFolder:r.folderUri.fsPath,config:r.config}}const Pn=B.getChild(`generator`);async function Fn({name:e,path:t,useDotBin:n,project:r}){try{var i=Y();let a=H(Pn),o=i.a(await v(t,{graphviz:n?`binary`:`wasm`,watch:!1})),{projectId:s,config:c}=Nn(o,r);r&&Pn.info(`${x.dim(`project`)} ${x.green(s)}`);let l=c.generators?.[e];if(!l)throw Pn.error(x.red(`generator ${e} does not exist in project config`)),Error(`generator ${e} does not exist in project config`);Pn.info(`${x.dim(`generator`)} ${x.green(e)}`),await In({likec4:o,model:await o.layoutedModel(s),generator:l,logger:Pn.getChild(e)}),a.stopAndLog()}catch(e){i.e=e}finally{await i.d()}}async function In({likec4:e,model:t,generator:n,logger:r}){let i=e.languageServices,a=new Set,o=i.project(t.project.id),s=t.project.id;r.debug(`${x.dim(`running for project:`)} ${x.green(o.id)}`),await Promise.resolve().then(()=>n({likec4model:t,ctx:{workspace:e.languageServices.workspaceUri,project:o,locate:e=>{let t=null;switch(!0){case Xe(e):t=i.locate({element:e.id,projectId:s});break;case Ze(e):t=i.locate({view:e.id,projectId:s});break;case qe(e):t=i.locate({deployment:e.id,projectId:s});break;case Qe(e):case Ye(e):t=i.locate({relation:e.id,projectId:s});break;default:et(e)}if(!t)throw r.error(`Cannot locate ${e.id}`,{target:e}),Error(`Cannot locate ${e.id}`);let n=re.parse(t.uri);return{range:t.range,document:n,relativePath:ie.relative(o.folder,n),folder:ie.dirname(n).fsPath,filename:ie.basename(n)}},write:async({path:e,content:t})=>{let n;n=Array.isArray(e)?F(o.folder.fsPath,...e):re.isUri(e)?e.fsPath:F(o.folder.fsPath,`${e}`);let i=M(n);a.has(i)||(z(i)||(r.debug(`${x.dim(`create directory`)} ${i}`),await L(i,{recursive:!0})),a.add(i)),r.debug(`${x.dim(`write`)} ${n}`),await R(n,t)},abort:e=>{throw r.error(e||`Generator aborted`),Error(e||`Generator aborted`)}}}))}async function Ln(e,t,n){t??=F(e.workspace,`likec4.generated.ts`),nt(t)!==`.ts`&&(t+=`.ts`),await L(M(t),{recursive:!0});let r=we([...await e.diagrams()]);await R(t,r),n.info(`${x.dim(`generated`)} ${P(process.cwd(),t)}`)}async function Rn(e,t,n){await L(t,{recursive:!0}),n.info(`${x.dim(`format`)} ${x.green(`dot`)}`),n.info(`${x.dim(`outdir`)} ${t}`);let r=new Set,i=await e.computedModel(),a=l(i.$data.views),o=0;for(let s of a)try{let a=await e.viewsService.layouter.dot({view:s,styles:i.$styles}),c=`.`;s.sourcePath&&(c=M(s.sourcePath)),c=F(t,c),r.has(c)||(await L(c,{recursive:!0}),r.add(c));let l=F(c,s.id+`.dot`);await R(l,a),n.info(`${x.dim(`generated`)} ${P(process.cwd(),l)}`),o++}catch(e){B.error(`error while generating ${s.id}`,{error:e})}o>0&&n.info(`${x.dim(`total`)} ${o} files`)}async function zn(e,t,n,r){await L(n,{recursive:!0}),r.info(`${x.dim(`format`)} ${x.green(t)}`),r.info(`${x.dim(`outdir`)} ${n}`);let i,a;switch(t){case`d2`:i=`.d2`,a=ye;break;case`mermaid`:i=`.mmd`,a=Ce;break;case`plantuml`:i=`.puml`,a=be;break;default:et(t)}let o=new Set,s=await e.layoutedModel(),c=0;for(let e of s.views()){let t=e.$view;try{let s=`.`;t.sourcePath&&(s=M(t.sourcePath)),s=F(n,s),o.has(s)||(await L(s,{recursive:!0}),o.add(s));let l=F(s,t.id+i);await R(l,a(e)),r.info(`${x.dim(`generated`)} ${P(process.cwd(),l)}`),c++}catch(e){r.error(`error while generating ${t.id}`,{error:e})}}c>0&&r.info(`${x.dim(`total`)} ${c} files`)}async function Bn({path:e,useDotBin:t,...n}){let r=V(`c4:codegen`),i=H(r),a=await v(e,{graphviz:t?`binary`:`wasm`,watch:!1});if(a.ensureSingleProject(),(await a.viewsService.computedViews()).length===0)throw r.warn(`no views found`),process.exitCode=1,Error(`no views found`);switch(n.format){case`views`:await Ln(a,n.outfile,r);break;case`dot`:await Rn(a,n.outdir??e,r);break;case`d2`:case`mermaid`:case`plantuml`:await zn(a,n.format,n.outdir??e,r);break;default:et(n)}i.stopAndLog()}const Vn=M(Pt(import.meta.url));function Hn(){try{let e=JSON.parse(Ct(N(Vn,`..`,`package.json`),`utf8`));if(e.version)return e.version}catch{}try{let e=JSON.parse(Ct(N(Vn,`..`,`..`,`package.json`),`utf8`));if(e.version)return e.version}catch{}return`0.1.0`}const Un=Hn(),Wn=`leanix`,Gn=`depends on`,Kn=new Set([`factSheetTypes`,`relationTypes`,`metadataToFields`]);function qn(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;for(let t of Object.values(e))if(typeof t!=`string`)return!1;return!0}function Jn(e){if(e==null)return e;if(typeof e!=`object`||Array.isArray(e))throw Error(`LeanIX mapping must be a plain object (not an array or primitive)`);let t=e;for(let e of Object.keys(t))if(!Kn.has(e))throw Error(`LeanIX mapping has unknown key "${e}". Allowed: factSheetTypes, relationTypes, metadataToFields`);if(t.factSheetTypes!==void 0&&!qn(t.factSheetTypes))throw Error(`LeanIX mapping "factSheetTypes" must be an object with string keys and string values`);if(t.relationTypes!==void 0&&!qn(t.relationTypes))throw Error(`LeanIX mapping "relationTypes" must be an object with string keys and string values`);if(t.metadataToFields!==void 0&&!qn(t.metadataToFields))throw Error(`LeanIX mapping "metadataToFields" must be an object with string keys and string values`);return e}const Yn={factSheetTypes:{system:`Application`,container:`ITComponent`,component:`ITComponent`,actor:`Provider`},relationTypes:{default:Gn},metadataToFields:{title:`name`,description:`description`,technology:`technology`}};function Xn(e){let t=Jn(e),n={factSheetTypes:{...Yn.factSheetTypes},relationTypes:{...Yn.relationTypes},metadataToFields:{...Yn.metadataToFields}};return t?{factSheetTypes:{...n.factSheetTypes,...t.factSheetTypes},relationTypes:{...n.relationTypes,...t.relationTypes},metadataToFields:{...n.metadataToFields,...t.metadataToFields}}:n}function Zn(e,t){return t.factSheetTypes[e]??t.factSheetTypes.default??`Application`}function Qn(e,t){let n=e??`default`;return t.relationTypes[n]??t.relationTypes.default??Gn}const $n={manifestVersion:`1.0`,bridgeVersion:Un,mappingProfile:`default`};function er(e){let t={};for(let n of e.elements())t[n.id]={canonicalId:n.id,external:{}};return t}function tr(e){let t={};for(let n of e.views())t[n.id]={viewId:n.id,external:{}};return t}function nr(e){let t=[];for(let n of e.relationships())t.push({relationId:n.id,sourceFqn:n.source.id,targetFqn:n.target.id,compositeKey:`${n.source.id}|${n.target.id}|${n.id}`,external:{}});return t}function rr(e,t={}){let n={...$n,...t,generatedAt:t.generatedAt??new Date().toISOString()};return{manifestVersion:n.manifestVersion,generatedAt:n.generatedAt,bridgeVersion:n.bridgeVersion,mappingProfile:n.mappingProfile,projectId:e.projectId,entities:er(e),views:tr(e),relations:nr(e)}}function ir(e,t){let n=[];for(let r of e.elements()){let e=Zn(r.kind,t),i=r.getMetadata(),a=typeof i.description==`string`?i.description:void 0,o=r.technology??(typeof i.technology==`string`?i.technology:void 0);n.push({type:e,likec4Id:r.id,name:r.title,...a!==void 0&&{description:a},...o!==void 0&&{technology:o},...r.tags.length>0&&{tags:[...r.tags]},...Object.keys(i).length>0&&{metadata:{...i}}})}return n.sort((e,t)=>e.likec4Id.localeCompare(t.likec4Id)),n}function ar(e,t){let n=[];for(let r of e.relationships()){let e=r.title??r.kind;n.push({type:Qn(r.kind,t),likec4RelationId:r.id,sourceLikec4Id:r.source.id,targetLikec4Id:r.target.id,...e!=null&&e!==``&&{title:String(e)}})}return n.sort((e,t)=>e.likec4RelationId.localeCompare(t.likec4RelationId)),n}function or(e,t={}){let n=Xn(t.mapping),r=t.generatedAt??new Date().toISOString(),i=t.mappingProfile??(t.mapping?`custom`:`default`);return{generatedAt:r,projectId:e.projectId,mappingProfile:i,factSheets:ir(e,n),relations:ar(e,n)}}function sr(e,t){let n=[];return e.projectId!==t.projectId&&n.push(`projectId (manifest: ${e.projectId}, leanixDryRun: ${t.projectId})`),e.mappingProfile!==t.mappingProfile&&n.push(`mappingProfile (manifest: ${e.mappingProfile}, leanixDryRun: ${t.mappingProfile})`),`Manifest and LeanIX dry-run must belong to the same run. Mismatch: ${n.join(`; `)}`}function cr(e,t){if(e.projectId!==t.projectId||e.mappingProfile!==t.mappingProfile)throw Error(sr(e,t));return{generatedAt:e.generatedAt,projectId:e.projectId,manifestVersion:e.manifestVersion,bridgeVersion:e.bridgeVersion,mappingProfile:e.mappingProfile,counts:{entities:Object.keys(e.entities).length,views:Object.keys(e.views).length,relations:e.relations.length,factSheets:t.factSheets.length,leanixRelations:t.relations.length},artifacts:{manifest:`manifest.json`,leanixDryRun:`leanix-dry-run.json`}}}var lr=class extends Error{constructor(e,t,n){super(e),this.statusCode=t,this.graphqlErrors=n,this.name=`LeanixApiError`}};function ur(e){return new Promise(t=>setTimeout(t,e))}var dr=class{baseUrl;apiToken;requestDelayMs;lastRequestTime=0;rateLimitLock=Promise.resolve();constructor(e){this.apiToken=e.apiToken,this.baseUrl=(e.baseUrl??`https://app.leanix.net`).replace(/\/$/,``),this.requestDelayMs=e.requestDelayMs??200}async graphql(e,t){let n=async()=>{let n=Date.now()-this.lastRequestTime;n<this.requestDelayMs&&await ur(this.requestDelayMs-n),this.lastRequestTime=Date.now();let r=`${this.baseUrl}/services/pathfinder/v1/graphql`,i;try{i=await fetch(r,{method:`POST`,headers:{"Content-Type":`application/json`,Authorization:`Bearer ${this.apiToken}`},body:JSON.stringify({query:e,variables:t})})}catch(e){throw new lr(`GraphQL request failed: ${r} POST - ${e instanceof Error?e.message:String(e)}`)}let a;try{a=await i.json()}catch(e){let t=e instanceof Error?e.message:String(e);throw new lr(`Invalid JSON response: ${r} ${i.status} ${i.statusText} - ${t}`,i.status)}if(!i.ok)throw new lr(a.errors?.[0]?.message??`HTTP ${i.status} ${i.statusText}`,i.status,a.errors);if(a.errors&&a.errors.length>0)throw new lr(a.errors.map(e=>e.message).join(`; `),i.status,a.errors);if(a.data===void 0)throw new lr(`GraphQL response had no data and no errors`);return a.data},r=this.rateLimitLock,i;this.rateLimitLock=new Promise(e=>{i=e}),await r;try{return await n()}finally{i()}}};async function fr(e,t,n){let r=(await e.graphql(`
|
|
58
|
+
`.trimStart()}function generateViewId(e){return ee(e,e=>v`${E.stringify(e.id)}`,{separator:` | `})}function generateViewsDataTs(e){let t=Array.from(e),n=new b;return n.appendTemplate`
|
|
59
|
+
/******************************************************************************
|
|
60
|
+
* This file was generated
|
|
61
|
+
* DO NOT EDIT MANUALLY!
|
|
62
|
+
******************************************************************************/
|
|
63
|
+
/* prettier-ignore-start */
|
|
64
|
+
/* eslint-disable */
|
|
65
|
+
|
|
66
|
+
// @ts-nocheck
|
|
67
|
+
|
|
68
|
+
import type { DiagramView } from 'likec4'
|
|
69
|
+
`.append(x,x),t.length===0?(n.append(`export {}`,x),y(n)):(n.appendTemplate`
|
|
70
|
+
export type LikeC4ViewId = ${generateViewId(t)};
|
|
71
|
+
export const LikeC4Views = {
|
|
72
|
+
`.indent({indentation:2,indentedChildren(e){e.appendNewLineIf(t.length>1).append(ee(t,e=>v`${E.stringify(e.id)}: (${E.stringify(e)} as unknown) as DiagramView`,{separator:`,`,appendNewLineIfNotEmpty:!0}))}}).append(`} as const satisfies Record<LikeC4ViewId, DiagramView>`,x,x).appendTemplate`
|
|
73
|
+
export type LikeC4Views = typeof LikeC4Views
|
|
74
|
+
|
|
75
|
+
export function isLikeC4ViewId(value: unknown): value is LikeC4ViewId {
|
|
76
|
+
return (
|
|
77
|
+
value != null &&
|
|
78
|
+
typeof value === 'string' &&
|
|
79
|
+
!!LikeC4Views[value]
|
|
80
|
+
)
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/* prettier-ignore-end */
|
|
84
|
+
`.append(x),y(n))}function generateReactTypes(e,t={}){let{useCorePackage:n=!1}=t;$e(!e.isParsed(),`can not generate react types for parsed model`);let r=generateAux(e,t);return`
|
|
85
|
+
/* prettier-ignore-start */
|
|
86
|
+
/* eslint-disable */
|
|
87
|
+
|
|
88
|
+
/******************************************************************************
|
|
89
|
+
* This file was generated
|
|
90
|
+
* DO NOT EDIT MANUALLY!
|
|
91
|
+
******************************************************************************/
|
|
92
|
+
|
|
93
|
+
import type { PropsWithChildren } from 'react'
|
|
94
|
+
import type { JSX } from 'react/jsx-runtime'
|
|
95
|
+
import type { LikeC4Model } from '${n?`@likec4/core`:`likec4`}/model'
|
|
96
|
+
import type { LayoutedView } from '${n?`@likec4/core/types`:`likec4/model`}'
|
|
97
|
+
import type {
|
|
98
|
+
LikeC4ViewProps as GenericLikeC4ViewProps,
|
|
99
|
+
ReactLikeC4Props as GenericReactLikeC4Props
|
|
100
|
+
} from 'likec4/react'
|
|
101
|
+
|
|
102
|
+
${r}
|
|
103
|
+
|
|
104
|
+
declare function isLikeC4ViewId(value: unknown): value is $ViewId;
|
|
105
|
+
|
|
106
|
+
declare const likec4model: LikeC4Model<$Aux>;
|
|
107
|
+
declare function useLikeC4Model(): LikeC4Model<$Aux>;
|
|
108
|
+
declare function useLikeC4View(viewId: $ViewId): LayoutedView<$Aux>;
|
|
109
|
+
|
|
110
|
+
declare function LikeC4ModelProvider(props: PropsWithChildren): JSX.Element;
|
|
111
|
+
|
|
112
|
+
type IconRendererProps = {
|
|
113
|
+
node: {
|
|
114
|
+
id: string
|
|
115
|
+
title: string
|
|
116
|
+
icon?: string | undefined
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
declare function RenderIcon(props: IconRendererProps): JSX.Element;
|
|
120
|
+
|
|
121
|
+
type LikeC4ViewProps = GenericLikeC4ViewProps<$Aux>;
|
|
122
|
+
declare function LikeC4View({viewId, ...props}: LikeC4ViewProps): JSX.Element;
|
|
123
|
+
|
|
124
|
+
type ReactLikeC4Props = GenericReactLikeC4Props<$Aux>
|
|
125
|
+
declare function ReactLikeC4({viewId, ...props}: ReactLikeC4Props): JSX.Element;
|
|
126
|
+
|
|
127
|
+
export {
|
|
128
|
+
type LikeC4ViewProps,
|
|
129
|
+
type ReactLikeC4Props,
|
|
130
|
+
isLikeC4ViewId,
|
|
131
|
+
useLikeC4Model,
|
|
132
|
+
useLikeC4View,
|
|
133
|
+
likec4model,
|
|
134
|
+
LikeC4ModelProvider,
|
|
135
|
+
LikeC4View,
|
|
136
|
+
RenderIcon,
|
|
137
|
+
ReactLikeC4
|
|
138
|
+
}
|
|
139
|
+
/* prettier-ignore-end */
|
|
140
|
+
`.trimStart()}var Wt=`likec4`,Gt=`1.56.0`;const K=r.getChild(`cli`);function createLikeC4Logger(e){let t=r.getChild(e);return{info(e){t.info(e)},debug(e,...n){n.length===0?t.debug(e):t.debug(e,{args:n})},warn(e){if(e instanceof Error){t.warn(`${S.red(e.name+` `+e.message)}`,{msg:e});return}if(typeof e==`string`){t.warn(e);return}t.warn`${e}`},warnOnce(e){t.warn(e)},error(e,n){let r=n?.error??e;if(r instanceof Error){if(e===r){t.error(`${S.red(r.name+` `+r.message)}`,{error:r});return}t.error(S.red(e),{error:r});return}if(typeof e==`string`){t.error(S.red(e));return}t.error`${e}`},clearScreen:function(e){},hasErrorLogged:function(e){return!1},hasWarned:!1}}function inMillis(e){let[t,n]=Nt(e),r=t*1e3+n/1e6;return{ms:r,pretty:_e(r)}}function startTimer(e){let t=Nt();return{stopAndLog(n=`done in `){n=S.green(`${n}${inMillis(t).pretty}`),(e||K).info(n)}}}function boxen(e,t){console.log(ke(e,{padding:1,margin:1,dimBorder:!0,...t}))}const Kt=createLikeC4Logger(`vite`),qt=z(Ct(import.meta.url));function findPkgRoot(){let e=Ae({cwd:qt});if(!e)throw Error(`likec4 package folder not found`);return z(e)}function viteAppRoot(){let e=[H(findPkgRoot(),`__app__`),H(qt,`../__app__`),H(qt,`../../__app__`),H(qt,`../../dist/__app__`)],t=pe(e,U);if(!t)throw r.error(`likec4 app root does not exist, tried:\n${e.join(`
|
|
141
|
+
`)}`),Error(`likec4 app root does not exist`);return t}async function mkTempPublicDir(){let e=await _t(B(ut(),`.likec4-public-`));return await G(B(e,`likec4-views.js`),`// generated by likec4
|
|
142
|
+
`),e}function relativeToCwd(e){return V(jt(),e)}function viteAliases(){let e=findPkgRoot();return{"likec4/react":H(e,`react/index.mjs`),"likec4/model":H(e,`dist/model/index.mjs`),"likec4/vite-plugin/internal":H(e,`dist/vite-plugin/internal/index.mjs`)}}const viteConfig=async({languageServices:e,likec4AssetsDir:t,...n})=>{let r=n.customLogger??Kt,i=viteAppRoot();r.info(`${S.cyan(`likec4 app root`)} ${S.dim(relativeToCwd(i))}`);let a=n.outputDir??H(e.workspace,`dist`);r.info(S.cyan(`outDir`)+` `+S.dim(relativeToCwd(a)));let s=`/`;n.base&&(s=te(n.base),!w(s)&&s!==`./`&&(s=T(s))),s!==`/`&&r.info(`${S.green(`app base url`)} ${S.dim(s)}`);let c=n.webcomponentPrefix??`likec4`,l=n.title??`LikeC4`,u=n.outputSingleFile??!1;return{isDev:Dt,likec4AssetsDir:t,webcomponentPrefix:c,title:l,root:i,languageServices:e,clearScreen:!1,base:s,resolve:{alias:{...viteAliases(),"likec4/previews":t}},configFile:!1,mode:`production`,define:{"process.env.NODE_ENV":`"production"`},build:{outDir:a,emptyOutDir:!1,sourcemap:!1,minify:!0,copyPublicDir:!0,chunkSizeWarningLimit:2*1024,modulePreload:{polyfill:!1},...!u&&{rolldownOptions:{input:[H(i,`index.html`),H(i,`src`,`main.mjs`),H(i,`src`,`fonts.css`),H(i,`src`,`style.css`)],output:{codeSplitting:{groups:[{name:`likec4-core`,test:/(likec4[\\/]core|core[\\/]dist|immer)/},{test:/node_modules/,name:e=>{let t=e.match(/.*\/node_modules\/(?<package>@[^/]+\/[^/]+|[^/]+)/)?.groups?.package,n=/\.d\.[mc]?ts$/.test(e);return`libs/${t||`common`}${n?`.d`:``}`}}]}}}}},customLogger:r,plugins:[Bt(),De({languageServices:e.languageServices,appConfig:{webcomponentPrefix:c,pageTitle:l,useHashHistory:n.useHashHistory,theme:n.theme}}),u?Vt():void 0]}};function viteWebcomponentConfig({languageServices:e,outDir:t,base:n,webcomponentPrefix:r=`likec4`,filename:i=`likec4-views.js`}){let a=createLikeC4Logger([`vite`,`webcomponent`]),s=viteAppRoot();return a.info(S.cyan(`outDir`)+` `+S.dim(t)),{root:s,clearScreen:!1,base:n,configFile:!1,publicDir:!1,mode:`production`,resolve:{alias:viteAliases()},define:{"process.env.NODE_ENV":`"production"`},build:{outDir:t,emptyOutDir:!1,sourcemap:!1,minify:!0,assetsInlineLimit:500*1024,chunkSizeWarningLimit:3*1024,lib:{entry:`codegen/webcomponent.mjs`,fileName(e,t){return i},formats:[`iife`],name:`LikeC4Views`}},customLogger:a,plugins:[De({languageServices:e.languageServices,appConfig:{webcomponentPrefix:r}})]}}const Jt=[`favicon.ico`,`robots.txt`];async function viteBuild({buildWebcomponent:e=!0,webcomponentPrefix:t=`likec4`,title:n,languageServices:r,likec4AssetsDir:i,outputSingleFile:a,...s}){i??=await _t(B(ut(),`.likec4-assets-`));let c=await viteConfig({...s,languageServices:r,likec4AssetsDir:i,webcomponentPrefix:t,title:n,outputSingleFile:a}),l=!U(c.build.outDir)||pt(c.build.outDir).length===0,u=await mkTempPublicDir();for(let e of Jt){let t=H(c.root,e);U(t)&&dt(t,H(u,e))}let f=r.languageServices.projects();if(f.length===1){let e=await r.viewsService.computedViews(),t=await r.diagrams();if(t.length===0)throw process.exitCode=1,Error(`no views found`);t.length===e.length?c.customLogger.info(`${S.dim(`workspace:`)} ${S.green(`✓ all views layouted`)}`):c.customLogger.warn(`${S.dim(`workspace:`)} ${S.yellow(`✗ layouted ${t.length} of ${e.length} views`)}`),t.forEach(e=>{(e.hasLayoutDrift||e.drifts&&e.drifts.length>0)&&c.customLogger.warn(S.dim(`view`)+` `+S.red(e.id)+` `+S.yellow(`is out of date, layout drift detected`))});let n=f[0].config.landingPage;if(n&&(`include`in n||`exclude`in n)){let e=`include`in n?n.include:n.exclude;t.some(t=>e.some(e=>e.startsWith(`#`)?t.tags?.some(t=>t===e.slice(1)):t.id===e))||c.customLogger.warn(S.dim(`landingPage:`)+` `+S.yellow(`no views match the configured filter`))}}else for(let e of f){let t=await r.viewsService.computedViews(e.id);t.length===0?c.customLogger.warn(`${S.dim(`project:`)} ${e.id} ${S.yellow(`✗ no views found`)}`):c.customLogger.info(`${S.dim(`project:`)} ${e.id} ${S.green(`${t.length} views`)}`);let n=await r.diagrams(e.id),i=e.config.landingPage;if(i&&(`include`in i||`exclude`in i)){let t=`include`in i?i.include:i.exclude;n.some(e=>t.some(t=>t.startsWith(`#`)?e.tags?.some(e=>e===t.slice(1)):e.id===t))||c.customLogger.warn(`${S.dim(`project:`)} ${e.id} ${S.yellow(`landingPage: no views match the configured filter`)}`)}}if(e&&!a&&await Lt(viteWebcomponentConfig({webcomponentPrefix:t,languageServices:r,outDir:u,base:c.base})),await Lt({...c,customLogger:c.customLogger,publicDir:u,mode:`production`}),a){if(!l){c.customLogger.warn(S.yellow(`outDir was not empty, skipping cleanup`));return}for(let e of pt(H(c.build.outDir)).filter(e=>e!==`index.html`))mt(H(c.build.outDir,e),{recursive:!0})}let p=H(c.build.outDir,`index.html`);U(p)&&dt(p,H(c.build.outDir,`404.html`))}function isInstalled(e){try{return!!Ge.createRequire(import.meta.url).resolve(e)}catch(e){return K.debug(a(e)),!1}}async function ensureReact(){if(isInstalled(`react`)&&isInstalled(`react-dom`)){K.debug(`react already installed`);return}K.warn(`react not installed`);let e=await Me();e||(K.error`Package manager not detected, please install dependencies manually: ${`react`} ${`react-dom`}`,process.exit(1));let t=je(e.agent,`add`,[`react`,`react-dom`]);t||(K.error`Please install dependencies manually: ${`react`} ${`react-dom`}`,process.exit(1));try{await lt(t.command,t.args,{stdio:`inherit`})}catch(e){K.debug(a(e)),K.error`Please install dependencies manually: ${`react`} ${`react-dom`}`,process.exit(1)}}async function ensurePlaywright(){if(isInstalled(`playwright`)){K.debug(`playwright already installed`);return}K.warn(`playwright not installed`);let e=await Me();e||(K.error`Package manager not detected, please install dependencies manually: ${`playwright`}`,process.exit(1));let t=je(e.agent,`add`,[`playwright`]);t||(K.error`Please install dependencies manually: ${`playwright`}`,process.exit(1));try{await lt(t.command,t.args,{preferLocal:!0,stdio:`inherit`})}catch(e){K.debug(a(e)),K.error`Please install dependencies manually: ${`playwright`}`,process.exit(1)}}const q={type:`string`,desc:`<directory> with LikeC4 sources (default is current directory or 'LIKEC4_WORKSPACE' env)`,normalize:!0,default:Tt.LIKEC4_WORKSPACE||`.`,coerce:H},J={alias:`use-dot-bin`,boolean:!0,type:`boolean`,desc:O()?`enabled in container, disable by --no-use-dot`:`use graphviz binaries ("dot" should be on PATH)`,default:O()},Yt={boolean:!0,type:`boolean`,desc:"use `@likec4/core` package in types",default:!1},Xt={boolean:!0,type:`boolean`,desc:`use hash history for navigation, e.g. "/#/view" instead of "/view"`},Y={alias:[`o`,`output`],string:!0,desc:`output directory`,normalize:!0,nargs:1,coerce:H},Zt={alias:`w`,string:!0,desc:`prefix for Webcomponents, e.g "c4" generates <c4-view ../>`,default:`likec4`,nargs:1},Qt={alias:`t`,string:!0,desc:`base title of the app pages (default is "LikeC4")`,default:`LikeC4`,nargs:1},$t={choices:[`light`,`dark`],desc:`default color scheme for the built website (default: auto, follows system preference)`,nargs:1},en={alias:[`base-url`],string:!0,desc:`base url the app is being served from, e.g. "/" or "/pages/"`,nargs:1},tn={boolean:!0,desc:`outputs a single self-contained HTML file with all required resources inlined`},nn={alias:`l`,string:!0,...O()?{desc:`listen 0.0.0.0 by default in container`,default:`0.0.0.0`}:{desc:`ip address of the network interface to listen on`},nargs:1},rn={number:!0,desc:`port number for the dev server (default is 5173, or PORT environment variable)`,nargs:1},X={alias:`p`,string:!0,desc:`select LikeC4 project by name (e.g. "my-project") or by path`,nargs:1},an={hidden:!0,nargs:1,desc:`force log level`,choices:[`trace`,`debug`,`info`,`warning`,`error`],conflicts:[`verbose`]},on={boolean:!0,desc:`verbose logging`,conflicts:[`log-level`]},sn=Dt?`trace`:`debug`,cn={name:Wt,version:Gt},ln=fe(()=>new Pe({projectName:Wt,clearInvalidConfig:!0})),un=1e3*60,dn=un*60*24*7;function showSupportUsMessage(){if(!Et)try{let e=ln(),t=e.get(`lastSupportUsMessage`);if(!t){e.set(`lastSupportUsMessage`,Date.now()-dn+5*un);return}if(t+dn>Date.now())return;e.set(`lastSupportUsMessage`,Date.now()),boxen([S.dim(`If you are working in a commercial environment`),S.dim(`consider supporting the project`),``,S.dim(`How to get more?`)+` `+S.underline(`https://likec4.dev/sponsor/`)].join(`
|
|
143
|
+
`))}catch{}}function _usingCtx(){var e=typeof SuppressedError==`function`?SuppressedError:function(e,t){var n=Error();return n.name=`SuppressedError`,n.error=e,n.suppressed=t,n},t={},n=[];function using(e,t){if(t!=null){if(Object(t)!==t)throw TypeError(`using declarations can only be used with objects, functions, null, or undefined.`);if(e)var r=t[Symbol.asyncDispose||Symbol.for(`Symbol.asyncDispose`)];if(r===void 0&&(r=t[Symbol.dispose||Symbol.for(`Symbol.dispose`)],e))var i=r;if(typeof r!=`function`)throw TypeError(`Object is not disposable.`);i&&(r=function o(){try{i.call(t)}catch(e){return Promise.reject(e)}}),n.push({v:t,d:r,a:e})}else e&&n.push({d:t,a:e});return t}return{e:t,u:using.bind(null,!1),a:using.bind(null,!0),d:function d(){var r,i=this.e,a=0;function next(){for(;r=n.pop();)try{if(!r.a&&a===1)return a=0,n.push(r),Promise.resolve().then(next);if(r.d){var e=r.d.call(r.v);if(r.a)return a|=2,Promise.resolve(e).then(next,err)}else a|=1}catch(e){return err(e)}if(a===1)return i===t?Promise.resolve():Promise.reject(i);if(i!==t)throw i}function err(n){return i=i===t?n:new e(n,i),next()}return next()}}}const buildCmd=e=>e.command({command:`build [path]`,aliases:[`bundle`],describe:`Build a static website`,builder:e=>e.positional(`path`,q).option(`output`,{alias:`o`,type:`string`,desc:`output directory for production build`,normalize:!0,coerce:H}).option(`base`,en).option(`use-hash-history`,Xt).option(`use-dot`,J).option(`webcomponent-prefix`,Zt).option(`title`,Qt).option(`output-single-file`,tn).option(`theme`,$t).example(`${S.green(`$0 build -o ./build ./src`)}`,S.gray(`Search for likec4 files in 'src' and output static site to 'build'`)).example(`${S.green(`$0 build --theme dark -o ./build ./src`)}`,S.gray(`Build with dark color scheme as default`)),handler:async e=>{try{var t=_usingCtx();let n={useHashHistory:e[`use-hash-history`]??!1,useDotBin:e[`use-dot`],webcomponentPrefix:e[`webcomponent-prefix`],outputSingleFile:e[`output-single-file`]??!1};await ensureReact();let r=createLikeC4Logger(`c4:build`),i=t.a(await l(e.path,{graphviz:e[`use-dot`]?`binary`:`wasm`,watch:!1})),a=e.output??H(i.workspace,`dist`),s=H(a,`assets`);await viteBuild({base:e.base,useHashHistory:n.outputSingleFile||n.useHashHistory,customLogger:r,webcomponentPrefix:n.webcomponentPrefix,title:e.title,theme:e.theme,languageServices:i,likec4AssetsDir:s,outputDir:a,outputSingleFile:n.outputSingleFile}),showSupportUsMessage()}catch(e){t.e=e}finally{await t.d()}}});var fn=e(Ne(),1);const pn=`check-update`;async function notifyAvailableUpdate(){if(Et||Ot||kt===pn)return;let e=ln(),t=e.get(`lastUpdateCheck`);if(!t){await checkAvailableUpdate(!1);return}let n=e.get(`latestVersion`);if(oe(n)||oe(t)||t+864e5<Date.now())try{lt(`likec4`,[`check-update`],{stdio:`ignore`,timeout:5e3,preferLocal:!0,detached:!0,env:{NODE_ENV:pn}}).catch(()=>{})}catch{}n&&(0,fn.gt)(n,cn.version)&&boxen([`Update available: `,S.dim(cn.version),S.reset(` → `),S.green(n)].join(``))}async function checkAvailableUpdate(e=!0){try{let t=ln();t.set({lastUpdateCheck:Date.now()});let n=await fetchLatestVersion();R(n,`No version found in latest npm`),t.set({lastUpdateCheck:Date.now(),latestVersion:n}),(0,fn.gt)(n,cn.version)?boxen([`Update available: `,S.dim(cn.version),S.reset(` → `),S.green(n)].join(``)):e&&boxen(S.dim(`Up to date: `)+` `+S.green(cn.version))}catch(e){K.warning(a(e))}}async function fetchLatestVersion(){return(await ze(`https://registry.npmjs.org/likec4/latest`,{headers:{accept:`application/vnd.npm.install-v1+json; q=1.0, application/json; q=0.8, */*`},timeout:5e3,keepalive:!0}).json()).version}const checkUpdateCmd=e=>e.command({command:`check-update`,describe:`Check for updates`,handler:async()=>{await checkAvailableUpdate()}});function ensureProjectId(e,t){if(!t)return e.languageServices.projectsManager.ensureProjectId();let n=H(t);if(n===e.workspace)return e.languageServices.projectsManager.ensureProjectId();if(U(n)&&ht(n).isDirectory()){K.debug`Project path exists: ${n}`;let t=g.file(n.endsWith(Xe)?n:n+Xe),r=e.languageServices.projects().find(e=>e.folder.fsPath===t.fsPath);if(r)return K.debug`Found project ${r.id} at path: ${n}`,r.id;K.debug`No project registered at path: ${n}`}return e.languageServices.projectsManager.ensureProjectId(t)}function ensureProject(e,t){let n=ensureProjectId(e,t),r=e.languageServices.projectsManager.getProject(n);return e.languageServices.projectsManager.defaultProjectId=n,{projectId:n,projectFolder:r.folderUri.fsPath,config:r.config}}const mn=K.getChild(`generator`);async function customHandler({name:e,path:t,useDotBin:n,project:r}){try{var i=_usingCtx();let a=startTimer(mn),s=i.a(await l(t,{graphviz:n?`binary`:`wasm`,watch:!1})),{projectId:c,config:u}=ensureProject(s,r);r&&mn.info(`${S.dim(`project`)} ${S.green(c)}`);let f=u.generators?.[e];if(!f)throw mn.error(S.red(`generator ${e} does not exist in project config`)),Error(`generator ${e} does not exist in project config`);mn.info(`${S.dim(`generator`)} ${S.green(e)}`),await runCustomGenerator({likec4:s,model:await s.layoutedModel(c),generator:f,logger:mn.getChild(e)}),a.stopAndLog()}catch(e){i.e=e}finally{await i.d()}}async function runCustomGenerator({likec4:e,model:t,generator:n,logger:r}){let i=e.languageServices,a=new Set,s=i.project(t.project.id),c=t.project.id;r.debug(`${S.dim(`running for project:`)} ${S.green(s.id)}`),await Promise.resolve().then(()=>n({likec4model:t,ctx:{workspace:e.languageServices.workspaceUri,project:s,locate:e=>{let t=null;switch(!0){case at(e):t=i.locate({element:e.id,projectId:c});break;case ot(e):t=i.locate({view:e.id,projectId:c});break;case nt(e):t=i.locate({deployment:e.id,projectId:c});break;case st(e):case it(e):t=i.locate({relation:e.id,projectId:c});break;default:Ke(e)}if(!t)throw r.error(`Cannot locate ${e.id}`,{target:e}),Error(`Cannot locate ${e.id}`);let n=g.parse(t.uri);return{range:t.range,document:n,relativePath:_.relative(s.folder,n),folder:_.dirname(n).fsPath,filename:_.basename(n)}},write:async({path:e,content:t})=>{let n;n=Array.isArray(e)?H(s.folder.fsPath,...e):g.isUri(e)?e.fsPath:H(s.folder.fsPath,`${e}`);let i=z(n);a.has(i)||(U(i)||(r.debug(`${S.dim(`create directory`)} ${i}`),await W(i,{recursive:!0})),a.add(i)),r.debug(`${S.dim(`write`)} ${n}`),await G(n,t)},abort:e=>{throw r.error(e||`Generator aborted`),Error(e||`Generator aborted`)}}}))}async function singleFileCodegenAction(e,t,n){t??=H(e.workspace,`likec4.generated.ts`),Je(t)!==`.ts`&&(t+=`.ts`),await W(z(t),{recursive:!0});let r=generateViewsDataTs([...await e.diagrams()]);await G(t,r),n.info(`${S.dim(`generated`)} ${V(process.cwd(),t)}`)}async function dotCodegenAction(e,t,n){await W(t,{recursive:!0}),n.info(`${S.dim(`format`)} ${S.green(`dot`)}`),n.info(`${S.dim(`outdir`)} ${t}`);let r=new Set,i=await e.computedModel(),a=me(i.$data.views),s=0;for(let c of a)try{let a=await e.viewsService.layouter.dot({view:c,styles:i.$styles}),l=`.`;c.sourcePath&&(l=z(c.sourcePath)),l=H(t,l),r.has(l)||(await W(l,{recursive:!0}),r.add(l));let u=H(l,c.id+`.dot`);await G(u,a),n.info(`${S.dim(`generated`)} ${V(process.cwd(),u)}`),s++}catch(e){K.error(`error while generating ${c.id}`,{error:e})}s>0&&n.info(`${S.dim(`total`)} ${s} files`)}async function multipleFilesCodegenAction(e,t,n,r){await W(n,{recursive:!0}),r.info(`${S.dim(`format`)} ${S.green(t)}`),r.info(`${S.dim(`outdir`)} ${n}`);let i,a;switch(t){case`d2`:i=`.d2`,a=xe;break;case`mermaid`:i=`.mmd`,a=Te;break;case`plantuml`:i=`.puml`,a=Ce;break;default:Ke(t)}let s=new Set,c=await e.layoutedModel(),l=0;for(let e of c.views()){let t=e.$view;try{let c=`.`;t.sourcePath&&(c=z(t.sourcePath)),c=H(n,c),s.has(c)||(await W(c,{recursive:!0}),s.add(c));let u=H(c,t.id+i);await G(u,a(e)),r.info(`${S.dim(`generated`)} ${V(process.cwd(),u)}`),l++}catch(e){r.error(`error while generating ${t.id}`,{error:e})}}l>0&&r.info(`${S.dim(`total`)} ${l} files`)}async function legacyHandler({path:e,useDotBin:t,...n}){let r=createLikeC4Logger(`c4:codegen`),i=startTimer(r),a=await l(e,{graphviz:t?`binary`:`wasm`,watch:!1});if(a.ensureSingleProject(),(await a.viewsService.computedViews()).length===0)throw r.warn(`no views found`),process.exitCode=1,Error(`no views found`);switch(n.format){case`views`:await singleFileCodegenAction(a,n.outfile,r);break;case`dot`:await dotCodegenAction(a,n.outdir??e,r);break;case`d2`:case`mermaid`:case`plantuml`:await multipleFilesCodegenAction(a,n.format,n.outdir??e,r);break;default:Ke(n)}i.stopAndLog()}const hn=z(Ct(import.meta.url));function readVersion(){try{let e=JSON.parse(ft(B(hn,`..`,`package.json`),`utf8`));if(e.version)return e.version}catch{}try{let e=JSON.parse(ft(B(hn,`..`,`..`,`package.json`),`utf8`));if(e.version)return e.version}catch{}return`0.1.0`}const gn=readVersion(),_n=`leanix`,vn=new Set([`factSheetTypes`,`relationTypes`,`metadataToFields`]);function isPlainObjectRecordOfStrings(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;for(let t of Object.values(e))if(typeof t!=`string`)return!1;return!0}function parseLeanixMappingInput(e){if(e==null)return e;if(typeof e!=`object`||Array.isArray(e))throw Error(`LeanIX mapping must be a plain object (not an array or primitive)`);let t=e;for(let e of Object.keys(t))if(!vn.has(e))throw Error(`LeanIX mapping has unknown key "${e}". Allowed: factSheetTypes, relationTypes, metadataToFields`);if(t.factSheetTypes!==void 0&&!isPlainObjectRecordOfStrings(t.factSheetTypes))throw Error(`LeanIX mapping "factSheetTypes" must be an object with string keys and string values`);if(t.relationTypes!==void 0&&!isPlainObjectRecordOfStrings(t.relationTypes))throw Error(`LeanIX mapping "relationTypes" must be an object with string keys and string values`);if(t.metadataToFields!==void 0&&!isPlainObjectRecordOfStrings(t.metadataToFields))throw Error(`LeanIX mapping "metadataToFields" must be an object with string keys and string values`);return e}const yn={factSheetTypes:{system:`Application`,container:`ITComponent`,component:`ITComponent`,actor:`Provider`},relationTypes:{default:`depends on`},metadataToFields:{title:`name`,description:`description`,technology:`technology`}};function mergeWithDefault(e){let t=parseLeanixMappingInput(e),n={factSheetTypes:{...yn.factSheetTypes},relationTypes:{...yn.relationTypes},metadataToFields:{...yn.metadataToFields}};return t?{factSheetTypes:{...n.factSheetTypes,...t.factSheetTypes},relationTypes:{...n.relationTypes,...t.relationTypes},metadataToFields:{...n.metadataToFields,...t.metadataToFields}}:n}function getFactSheetType(e,t){return t.factSheetTypes[e]??t.factSheetTypes.default??`Application`}function getRelationType(e,t){let n=e??`default`;return t.relationTypes[n]??t.relationTypes.default??`depends on`}const bn={manifestVersion:`1.0`,bridgeVersion:gn,mappingProfile:`default`};function buildManifestEntities(e){let t={};for(let n of e.elements())t[n.id]={canonicalId:n.id,external:{}};return t}function buildManifestViews(e){let t={};for(let n of e.views())t[n.id]={viewId:n.id,external:{}};return t}function buildManifestRelations(e){let t=[];for(let n of e.relationships())t.push({relationId:n.id,sourceFqn:n.source.id,targetFqn:n.target.id,compositeKey:`${n.source.id}|${n.target.id}|${n.id}`,external:{}});return t}function toBridgeManifest(e,t={}){let n={...bn,...t,generatedAt:t.generatedAt??new Date().toISOString()};return{manifestVersion:n.manifestVersion,generatedAt:n.generatedAt,bridgeVersion:n.bridgeVersion,mappingProfile:n.mappingProfile,projectId:e.projectId,entities:buildManifestEntities(e),views:buildManifestViews(e),relations:buildManifestRelations(e)}}function buildFactSheetsFromModel(e,t){let n=[];for(let r of e.elements()){let e=getFactSheetType(r.kind,t),i=r.getMetadata(),a=typeof i.description==`string`?i.description:void 0,s=r.technology??(typeof i.technology==`string`?i.technology:void 0);n.push({type:e,likec4Id:r.id,name:r.title,...a!==void 0&&{description:a},...s!==void 0&&{technology:s},...r.tags.length>0&&{tags:[...r.tags]},...Object.keys(i).length>0&&{metadata:{...i}}})}return n.sort((e,t)=>e.likec4Id.localeCompare(t.likec4Id)),n}function buildRelationsFromModel(e,t){let n=[];for(let r of e.relationships()){let e=r.title??r.kind;n.push({type:getRelationType(r.kind,t),likec4RelationId:r.id,sourceLikec4Id:r.source.id,targetLikec4Id:r.target.id,...e!=null&&e!==``&&{title:String(e)}})}return n.sort((e,t)=>e.likec4RelationId.localeCompare(t.likec4RelationId)),n}function toLeanixInventoryDryRun(e,t={}){let n=mergeWithDefault(t.mapping),r=t.generatedAt??new Date().toISOString(),i=t.mappingProfile??(t.mapping?`custom`:`default`);return{generatedAt:r,projectId:e.projectId,mappingProfile:i,factSheets:buildFactSheetsFromModel(e,n),relations:buildRelationsFromModel(e,n)}}function buildCoherenceErrorMessage(e,t){let n=[];return e.projectId!==t.projectId&&n.push(`projectId (manifest: ${e.projectId}, leanixDryRun: ${t.projectId})`),e.mappingProfile!==t.mappingProfile&&n.push(`mappingProfile (manifest: ${e.mappingProfile}, leanixDryRun: ${t.mappingProfile})`),`Manifest and LeanIX dry-run must belong to the same run. Mismatch: ${n.join(`; `)}`}function buildBridgeReport(e,t){if(e.projectId!==t.projectId||e.mappingProfile!==t.mappingProfile)throw Error(buildCoherenceErrorMessage(e,t));return{generatedAt:e.generatedAt,projectId:e.projectId,manifestVersion:e.manifestVersion,bridgeVersion:e.bridgeVersion,mappingProfile:e.mappingProfile,counts:{entities:Object.keys(e.entities).length,views:Object.keys(e.views).length,relations:e.relations.length,factSheets:t.factSheets.length,leanixRelations:t.relations.length},artifacts:{manifest:`manifest.json`,leanixDryRun:`leanix-dry-run.json`}}}var LeanixApiError=class extends Error{constructor(e,t,n){super(e),this.statusCode=t,this.graphqlErrors=n,this.name=`LeanixApiError`}};function sleep(e){return new Promise(t=>setTimeout(t,e))}var LeanixApiClient=class{baseUrl;apiToken;requestDelayMs;lastRequestTime=0;rateLimitLock=Promise.resolve();constructor(e){this.apiToken=e.apiToken,this.baseUrl=(e.baseUrl??`https://app.leanix.net`).replace(/\/$/,``),this.requestDelayMs=e.requestDelayMs??200}async graphql(e,t){let run=async()=>{let n=Date.now()-this.lastRequestTime;n<this.requestDelayMs&&await sleep(this.requestDelayMs-n),this.lastRequestTime=Date.now();let r=`${this.baseUrl}/services/pathfinder/v1/graphql`,i;try{i=await fetch(r,{method:`POST`,headers:{"Content-Type":`application/json`,Authorization:`Bearer ${this.apiToken}`},body:JSON.stringify({query:e,variables:t})})}catch(e){throw new LeanixApiError(`GraphQL request failed: ${r} POST - ${e instanceof Error?e.message:String(e)}`)}let a;try{a=await i.json()}catch(e){let t=e instanceof Error?e.message:String(e);throw new LeanixApiError(`Invalid JSON response: ${r} ${i.status} ${i.statusText} - ${t}`,i.status)}if(!i.ok)throw new LeanixApiError(a.errors?.[0]?.message??`HTTP ${i.status} ${i.statusText}`,i.status,a.errors);if(a.errors&&a.errors.length>0)throw new LeanixApiError(a.errors.map(e=>e.message).join(`; `),i.status,a.errors);if(a.data===void 0)throw new LeanixApiError(`GraphQL response had no data and no errors`);return a.data},n=this.rateLimitLock,r;this.rateLimitLock=new Promise(e=>{r=e}),await n;try{return await run()}finally{r()}}};async function findFactSheetByNameAndType(e,t,n){let r=(await e.graphql(`
|
|
17
144
|
query FindFactSheet($name: String!, $type: String!) {
|
|
18
145
|
allFactSheets(filter: { name: $name, factSheetType: $type }) {
|
|
19
146
|
edges { node { id name type } }
|
|
20
147
|
}
|
|
21
148
|
}
|
|
22
|
-
`,{name:t,type:n})).allFactSheets?.edges??[];if(r.length>1)throw Error(`Multiple fact sheets found for name="${t}" type="${n}". Ensure unique name+type in LeanIX or use likec4Id attribute for lookup.`);return r[0]?.node?.id??null}async function
|
|
149
|
+
`,{name:t,type:n})).allFactSheets?.edges??[];if(r.length>1)throw Error(`Multiple fact sheets found for name="${t}" type="${n}". Ensure unique name+type in LeanIX or use likec4Id attribute for lookup.`);return r[0]?.node?.id??null}async function findFactSheetByLikec4IdAttribute(e,t,n){let r={facetFilters:[{facetKey:t,operator:`OR`,keys:[n]}]},i=(await e.graphql(`
|
|
23
150
|
query FindFactSheetByAttribute($filter: FilterInput!) {
|
|
24
151
|
allFactSheets(filter: $filter) {
|
|
25
152
|
edges { node { id } }
|
|
26
153
|
}
|
|
27
154
|
}
|
|
28
|
-
`,{filter:r})).allFactSheets?.edges??[];if(i.length>1)throw Error(`Multiple fact sheets found for attribute ${t}=${n}. Ensure unique likec4Id in LeanIX.`);return i[0]?.node?.id??null}async function
|
|
155
|
+
`,{filter:r})).allFactSheets?.edges??[];if(i.length>1)throw Error(`Multiple fact sheets found for attribute ${t}=${n}. Ensure unique likec4Id in LeanIX.`);return i[0]?.node?.id??null}async function patchFactSheetAttribute(e,t,n,r){let i=[{op:`replace`,path:`/factSheetAttributes/${n}`,value:r}];if(!(await e.graphql(`
|
|
29
156
|
mutation UpdateFactSheet($id: ID!, $patches: [Patch]) {
|
|
30
157
|
updateFactSheet(id: $id, patches: $patches) {
|
|
31
158
|
factSheet { id }
|
|
32
159
|
}
|
|
33
160
|
}
|
|
34
|
-
`,{id:t,patches:i})).updateFactSheet?.factSheet?.id)throw Error(`updateFactSheet did not return fact sheet (id=${t}, attribute=${n})`)}async function
|
|
161
|
+
`,{id:t,patches:i})).updateFactSheet?.factSheet?.id)throw Error(`updateFactSheet did not return fact sheet (id=${t}, attribute=${n})`)}async function createFactSheet(e,t,n){let r=[];t.description&&r.push({op:`replace`,path:`/description`,value:t.description}),n&&t.likec4Id&&r.push({op:`replace`,path:`/factSheetAttributes/${n}`,value:t.likec4Id});let i={input:{name:t.name,type:t.type},patches:r},a=(await e.graphql(`
|
|
35
162
|
mutation CreateFactSheet($input: CreateFactSheetInput!, $patches: [Patch]) {
|
|
36
163
|
createFactSheet(input: $input, patches: $patches) {
|
|
37
164
|
factSheet { id name type rev }
|
|
38
165
|
}
|
|
39
166
|
}
|
|
40
|
-
`,i)).createFactSheet?.factSheet?.id;if(!a)throw Error(`createFactSheet did not return id for ${String(t.name)}`);return a}async function
|
|
167
|
+
`,i)).createFactSheet?.factSheet?.id;if(!a)throw Error(`createFactSheet did not return id for ${String(t.name)}`);return a}async function createRelation(e,t,n,r,i){let a=await e.graphql(`
|
|
41
168
|
mutation CreateRelation($source: ID!, $target: ID!, $type: String!) {
|
|
42
169
|
createRelation(source: $source, target: $target, type: $type) {
|
|
43
170
|
relation { id }
|
|
44
171
|
}
|
|
45
172
|
}
|
|
46
|
-
`,{source:t,target:n,type:r}),
|
|
173
|
+
`,{source:t,target:n,type:r}),s=a.createRelation?.relation?.id;if(!s){let e=JSON.stringify(a,null,2);throw Error(`createRelation did not return relation id (sourceFactSheetId=${t}, targetFactSheetId=${n}, relationType=${r}). Response: ${e}`)}return s}function buildFactSheetPlanEntry(e,t){let n=t?`update`:`create`;return{likec4Id:e.likec4Id,name:e.name,type:e.type,action:n,...t?{existingFactSheetId:t}:{}}}function buildPlanSummary(e,t){return{factSheetsToCreate:e.filter(e=>e.action===`create`).length,factSheetsToUpdate:e.filter(e=>e.action===`update`).length,relationsToCreate:t.length}}function toErrorMessage(e){if(e instanceof Error)return e.stack?`${e.message}\n${e.stack}`:e.message;if(typeof e==`object`&&e)try{return JSON.stringify(e,null,2)}catch{return Object.prototype.toString.call(e)}return String(e)}function applyLeanixIdsToEntities(e,t){let n={...e};for(let[r,i]of Object.entries(e)){let e=t.get(r);e&&(n[r]={...i,external:{...i.external,[_n]:{factSheetId:e,externalId:e}}})}return n}async function resolveExistingFactSheetId(e,t,n,r){if(!n)return null;if(r){let n=await findFactSheetByLikec4IdAttribute(e,r,t.likec4Id);if(n)return n;let i=await findFactSheetByNameAndType(e,t.name,t.type);if(i&&t.likec4Id)try{await patchFactSheetAttribute(e,i,r,t.likec4Id)}catch(e){console.warn(`[leanix-bridge] Failed to backfill likec4Id on fact sheet ${i} (${t.name}/${t.type}): ${e instanceof Error?e.message:String(e)}. Reusing ID.`)}return i??null}return findFactSheetByNameAndType(e,t.name,t.type)}async function syncFactSheetsToLeanix(e,t,n,r){let i=new Map,a=[],s=0,c=0;for(let l of t)try{let t=await resolveExistingFactSheetId(e,l,n,r);t&&c++,t||(t=await createFactSheet(e,l,r),s++),t&&i.set(l.likec4Id,t)}catch(e){a.push(`Fact sheet ${l.likec4Id} (${String(l.name)}): ${toErrorMessage(e)}`)}return{likec4IdToFactSheetId:i,factSheetsCreated:s,factSheetsReused:c,errors:a}}async function syncRelationsToLeanix(e,t,n,r){let i=[],a=[],s=0;for(let c of t){let t=r.get(c.sourceFqn),l=r.get(c.targetFqn),u=c.external?.[_n];if(t&&l&&!u?.relationId){let r=n.find(e=>e.sourceLikec4Id===c.sourceFqn&&e.targetLikec4Id===c.targetFqn&&e.likec4RelationId===c.relationId);if(r)try{let n=await createRelation(e,t,l,r.type,r.title);s++,i.push({...c,external:{...c.external,[_n]:{relationId:n,...c.external?.[_n]}}});continue}catch(e){a.push(`Relation ${c.compositeKey}: ${toErrorMessage(e)}`)}}i.push(c)}return{updatedRelations:i,relationsCreated:s,errors:a}}async function planSyncToLeanix(e,t,n={}){let r=n.idempotent??!0,i=n.likec4IdAttribute,a=n.generatedAt??new Date().toISOString(),s=[],c=[];for(let n of e.factSheets)try{let e=null;r&&(i?(e=await findFactSheetByLikec4IdAttribute(t,i,n.likec4Id),e||=await findFactSheetByNameAndType(t,n.name,n.type)):e=await findFactSheetByNameAndType(t,n.name,n.type)),c.push(buildFactSheetPlanEntry(n,e))}catch(e){s.push(`Fact sheet ${n.likec4Id} (${String(n.name)}): ${toErrorMessage(e)}`),c.push(buildFactSheetPlanEntry(n,null))}let l=e.relations.map(e=>({likec4RelationId:e.likec4RelationId,sourceLikec4Id:e.sourceLikec4Id,targetLikec4Id:e.targetLikec4Id,type:e.type,action:`create`}));return{generatedAt:a,projectId:e.projectId,mappingProfile:e.mappingProfile,summary:buildPlanSummary(c,l),factSheetPlans:c,relationPlans:l,errors:s}}async function syncToLeanix(e,t,n,r={}){let i=r.idempotent??!0,a=r.likec4IdAttribute,s=await syncFactSheetsToLeanix(n,t.factSheets,i,a),c=applyLeanixIdsToEntities(e.entities,s.likec4IdToFactSheetId),l=await syncRelationsToLeanix(n,e.relations,t.relations,s.likec4IdToFactSheetId);return{manifest:{...e,entities:c,relations:l.updatedRelations},factSheetsCreated:s.factSheetsCreated,factSheetsReused:s.factSheetsReused,relationsCreated:l.relationsCreated,errors:[...s.errors,...l.errors]}}async function withGraphQLRetry(e){let t;for(let n=0;n<3;n++)try{return await e()}catch(e){t=e,n<2&&await new Promise(e=>setTimeout(e,500*(n+1)))}throw t}async function fetchLeanixInventorySnapshot(e,t={}){let n=t.generatedAt??new Date().toISOString(),r=t.maxFactSheets??1e3;if(!Number.isInteger(r)||r<0)throw Error(`maxFactSheets must be a non-negative integer`);let i=t.likec4IdAttribute,a=await fetchAllFactSheets(e,{...i==null?{}:{likec4IdAttribute:i},maxFactSheets:r});return{generatedAt:n,factSheets:a,relations:await fetchAllRelations(e,a.map(e=>e.id))}}function mapNodeToFactSheetItem(e,t){if(!e?.id)return null;let n=t!=null&&Array.isArray(e.factSheetAttributes)?e.factSheetAttributes.find(e=>e.key===t)?.value:void 0;return{id:e.id,name:e.name??``,type:e.type??``,...n?{likec4Id:n}:{}}}async function fetchAllFactSheets(e,t){let n=t.likec4IdAttribute,r=Math.min(100,t.maxFactSheets),i=[],a=null,s=!0,c=`
|
|
47
174
|
query AllFactSheets($first: Int!, $after: String, $filter: FilterInput) {
|
|
48
175
|
allFactSheets(first: $first, after: $after, filter: $filter) {
|
|
49
176
|
edges {
|
|
@@ -61,7 +188,7 @@ import{s as e}from"../_chunks/rolldown-runtime.mjs";import"../_chunks/libs/birpc
|
|
|
61
188
|
}
|
|
62
189
|
}
|
|
63
190
|
}
|
|
64
|
-
`,
|
|
191
|
+
`,fetchPage=async t=>withGraphQLRetry(()=>e.graphql(c,{first:r,after:t,filter:{}}));for(;s&&i.length<t.maxFactSheets;){let e=await fetchPage(a),r=e.allFactSheets?.edges??[],c=e.allFactSheets?.pageInfo;for(let e of r){if(i.length>=t.maxFactSheets)break;let r=mapNodeToFactSheetItem(e.node,n);r&&i.push(r)}s=c?.hasNextPage===!0&&i.length<t.maxFactSheets,a=c?.endCursor??null}return i}async function fetchAllRelations(e,t){if(t.length===0)return[];let n=[],r=new Set(t);async function fetchRelationsForFactSheet(t){let n=[],i=null,a=!0;for(;a;){let s=await withGraphQLRetry(()=>e.graphql(`
|
|
65
192
|
query FactSheetRelations($id: ID!, $first: Int, $after: String) {
|
|
66
193
|
factSheet(id: $id) {
|
|
67
194
|
id
|
|
@@ -77,27 +204,26 @@ import{s as e}from"../_chunks/rolldown-runtime.mjs";import"../_chunks/libs/birpc
|
|
|
77
204
|
}
|
|
78
205
|
}
|
|
79
206
|
}
|
|
80
|
-
`,{id:t,first:100,after:i})),s
|
|
81
|
-
${
|
|
82
|
-
${
|
|
83
|
-
|
|
84
|
-
${
|
|
85
|
-
${
|
|
86
|
-
`).trim(),{padding:1,borderColor:`green`,borderStyle:`round`})}catch(e){a.e=e}finally{await a.d()}}async function
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
${
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
`))}catch(e){o.e=e}finally{await o.d()}}const fi=e=>e.command({command:`gen <command> [path]`,aliases:[`generate`,`codegen`],describe:`Generate various artifacts from LikeC4 sources`,builder:e=>e.positional(`path`,W).command(`react [path]`,`generate react component to render likec4 view`,e=>e.positional(`path`,W).option(`project`,q).option(`outfile`,{alias:[`o`,`output`],type:`string`,desc:`<file> path to output file (.jsx, .mjs or .js)`,normalize:!0,coerce:I}).option(`use-dot`,G).option(`use-core-package`,ln),async e=>{await ui({project:e.project,useDotBin:e.useDotBin,path:e.path,outfile:e.outfile,useCorePackage:e.useCorePackage}),J()}).command({command:`webcomponent [path]`,aliases:[`wc`,`webcomp`],describe:`generate js with webcomponents`,builder:e=>e.positional(`path`,W).option(`project`,q).option(`outfile`,{alias:[`o`,`output`],type:`string`,desc:`<file> path to output file (.mjs or .js)`,normalize:!0,coerce:I}).option(`webcomponent-prefix`,dn).option(`use-dot`,G),handler:async e=>{await di({project:e.project,useDotBin:e.useDotBin,path:e.path,outfile:e.outfile,webcomponentPrefix:e.webcomponentPrefix}),J()}}).command({command:`model [path]`,aliases:[`ts`],describe:`generate LikeC4Model (.ts)`,builder:e=>e.positional(`path`,W).option(`project`,q).option(`outfile`,{alias:[`o`,`output`],type:`string`,desc:`<file> path to output file (.ts)`,normalize:!0,coerce:I}).option(`use-dot`,G).option(`use-core-package`,ln),handler:async e=>{await ci({path:e.path,useDotBin:e.useDotBin,useCorePackage:e.useCorePackage,outfile:e.outfile,project:e.project}),J()}}).command({command:`views-data [path]`,aliases:[`views`],describe:`{deprecated} use codegen model`,deprecated:!0,builder:e=>e.positional(`path`,W).option(`outfile`,{alias:[`o`,`output`],type:`string`,desc:`<file> output .ts file`,normalize:!0,coerce:I}).option(`use-dot`,G),handler:async e=>{await Bn({format:`views`,path:e.path,useDotBin:e.useDotBin,outfile:e.outfile})}}).command({command:`leanix [path]`,describe:`LeanIX bridge: dry-run, inventory snapshot, reconcile`,builder:e=>e.positional(`path`,W).demandCommand(1,`Choose a subcommand: dry-run, inventory, reconcile`).command(`dry-run [path]`,`generate LeanIX bridge artifacts (manifest, dry-run inventory, report)`,e=>e.positional(`path`,W).option(`outdir`,{...K,desc:`<dir> output directory for manifest.json, leanix-dry-run.json, report.json`}).option(`project`,q).option(`use-dot`,G).example(`${x.green(`$0 gen leanix dry-run -o out/bridge`)}`,x.gray(`Write bridge artifacts to out/bridge`)),async e=>{await $r({path:e.path,outdir:e.outdir??I(process.cwd(),`out`,`bridge`),project:e.project,useDotBin:e.useDotBin})}).command(`inventory`,`fetch LeanIX inventory (read-only) and write leanix-inventory-snapshot.json`,e=>e.option(`outdir`,{...K,default:I(process.cwd(),`out`,`bridge`),desc:`<dir> output directory for leanix-inventory-snapshot.json`}).option(`likec4-id-attribute`,{type:`string`,desc:`custom LeanIX attribute key for likec4Id (e.g. "likec4Id")`}).example(`${x.green(`$0 gen leanix inventory -o out/bridge`)}`,x.gray(`Requires LEANIX_API_TOKEN`)),async e=>{await ni({outdir:e.outdir??I(process.cwd(),`out`,`bridge`),...e.likec4IdAttribute==null?{}:{likec4IdAttribute:e.likec4IdAttribute}})}).command(`reconcile [path]`,`reconcile manifest with leanix-inventory-snapshot; write reconciliation-report.json`,e=>e.positional(`path`,W).option(`outdir`,{...K,default:I(process.cwd(),`out`,`bridge`),desc:`<dir> directory with manifest.json and leanix-inventory-snapshot.json`}).option(`project`,q).option(`use-dot`,G).example(`${x.green(`$0 gen leanix reconcile -o out/bridge`)}`,x.gray(`Reads manifest + snapshot from outdir; optional workspace for name+type matching`)),async e=>{await si({path:e.path,outdir:e.outdir??I(process.cwd(),`out`,`bridge`),project:e.project,useDotBin:e.useDotBin})}),handler:async()=>{}}).command({command:`dot [path]`,describe:`generate graphviz files (.dot)`,builder:e=>e.positional(`path`,W).option(`outdir`,K).option(`use-dot`,G),handler:async e=>{await Bn({format:`dot`,path:e.path,useDotBin:e.useDotBin,outdir:e.outdir}),J()}}).command({command:`d2 [path]`,describe:`generate D2 files (.d2)`,builder:e=>e.positional(`path`,W).option(`outdir`,K).option(`use-dot`,G),handler:async e=>{await Bn({format:`d2`,path:e.path,useDotBin:e.useDotBin,outdir:e.outdir}),J()}}).command({command:`mermaid [path]`,aliases:[`mmd`],describe:`generate Mermaid files (.mmd)`,builder:e=>e.positional(`path`,W).option(`outdir`,K).option(`use-dot`,G),handler:async e=>{await Bn({format:`mermaid`,useDotBin:e.useDotBin,path:e.path,outdir:e.outdir}),J()}}).command({command:`plantuml [path]`,aliases:[`puml`],describe:`generate PlantUML files (.puml)`,builder:e=>e.positional(`path`,W).option(`outdir`,K).option(`use-dot`,G),handler:async e=>{await Bn({format:`plantuml`,useDotBin:e.useDotBin,path:e.path,outdir:e.outdir}),J()}}).command({command:`<custom> [path]`,describe:`run custom generator from likec4 config`,builder:e=>e.positional(`path`,W).option(`project`,q).option(`use-dot`,G),handler:async e=>{await Fn({name:`custom`,path:e.path,project:e.project,useDotBin:e.useDotBin})}}).epilog(`${x.bold(`Examples:`)}
|
|
207
|
+
`,{id:t,first:100,after:i})),c=s?.factSheet?.relations?.edges??[],l=s?.factSheet?.relations?.pageInfo;for(let e of c){let i=e.node,a=i?.targetFactSheet?.id;!a||!r.has(a)||n.push({...i?.id?{id:i.id}:{},sourceFactSheetId:t,targetFactSheetId:a,type:i?.type??`RELATES_TO`})}a=l?.hasNextPage===!0,i=l?.endCursor??null}return n}for(let e=0;e<t.length;e+=10){let r=t.slice(e,e+10),i=await Promise.all(r.map(e=>fetchRelationsForFactSheet(e)));for(let e of i)n.push(...e)}return n}function tryMatchByManifestFactSheetId(e,t,n,r){let i=e.external?.[_n],a=i?.factSheetId??i?.externalId;if(a==null)return null;let s=n.get(a);return!s||r.has(s.id)?null:(r.add(s.id),{canonicalId:t,factSheetId:s.id,name:s.name,type:s.type})}function tryMatchByLikec4Id(e,t,n){let r=t.get(e);return!r||n.has(r.id)?null:(n.add(r.id),{canonicalId:e,factSheetId:r.id,name:r.name,type:r.type})}function resolveByNameAndType(e,t,n,r,i,a,s,c){let l=`${t??e}${n??``}`,u=r.get(l)?.filter(e=>!i.has(e.id))??[];if(u.length===0)s.push({canonicalId:e,...t===void 0?{}:{name:t},...n===void 0?{}:{type:n}});else if(u.length===1){let t=u[0];a.push({canonicalId:e,factSheetId:t.id,name:t.name,type:t.type}),i.add(t.id)}else c.push({canonicalId:e,...t===void 0?{}:{name:t},...n===void 0?{}:{type:n},candidateFactSheetIds:u.map(e=>e.id)})}function reconcileInventoryWithManifest(e,t,n={}){let r=n.generatedAt??new Date().toISOString(),i=n.dryRun,a=[],s=[],c=[],l=new Map(e.factSheets.map(e=>[e.id,e])),u=new Map,f=new Map;for(let t of e.factSheets){t.likec4Id&&u.set(t.likec4Id,t);let e=`${t.name}${t.type}`;f.has(e)||f.set(e,[]),f.get(e).push(t)}let p=i?new Map(i.factSheets.map(e=>[e.likec4Id,e])):null,m=new Set;for(let[e,n]of Object.entries(t.entities)){let t=tryMatchByManifestFactSheetId(n,e,l,m);if(t){a.push(t);continue}let r=tryMatchByLikec4Id(e,u,m);if(r){a.push(r);continue}let i=p?.get(e);resolveByNameAndType(e,i?.name??void 0,i?.type??void 0,f,m,a,s,c)}let h=e.factSheets.filter(e=>!m.has(e.id)).map(e=>({factSheetId:e.id,name:e.name,type:e.type,...e.likec4Id?{likec4Id:e.likec4Id}:{}}));return{generatedAt:r,manifestProjectId:t.projectId,snapshotGeneratedAt:e.generatedAt,matched:a,unmatchedInLikec4:s,unmatchedInLeanix:h,ambiguous:c,summary:{matched:a.length,unmatchedInLikec4:s.length,unmatchedInLeanix:h.length,ambiguous:c.length}}}function isRecord(e){return typeof e==`object`&&!!e}function isManifestEntity(e){return isRecord(e)?typeof e.canonicalId==`string`:!1}function isManifestView(e){return isRecord(e)?typeof e.viewId==`string`:!1}function isManifestRelation(e){return isRecord(e)?typeof e.relationId==`string`&&typeof e.sourceFqn==`string`&&typeof e.targetFqn==`string`&&typeof e.compositeKey==`string`:!1}function isLeanixFactSheetSnapshotItem(e){return isRecord(e)?typeof e.id==`string`&&typeof e.name==`string`&&typeof e.type==`string`:!1}function isLeanixRelationSnapshotItem(e){return isRecord(e)?typeof e.sourceFactSheetId==`string`&&typeof e.targetFactSheetId==`string`&&typeof e.type==`string`:!1}function isBridgeManifest(e){if(!isRecord(e)||typeof e.manifestVersion!=`string`||typeof e.generatedAt!=`string`||typeof e.bridgeVersion!=`string`||typeof e.mappingProfile!=`string`||typeof e.projectId!=`string`)return!1;let t=e.entities;if(typeof t!=`object`||!t||Array.isArray(t))return!1;for(let e of Object.values(t))if(!isManifestEntity(e))return!1;let n=e.views;if(typeof n!=`object`||!n||Array.isArray(n))return!1;for(let e of Object.values(n))if(!isManifestView(e))return!1;let r=e.relations;if(!Array.isArray(r))return!1;for(let e of r)if(!isManifestRelation(e))return!1;return!0}function isLeanixInventorySnapshot(e){if(!isRecord(e)||typeof e.generatedAt!=`string`||e.workspaceId!==void 0&&typeof e.workspaceId!=`string`||!Array.isArray(e.factSheets))return!1;for(let t of e.factSheets)if(!isLeanixFactSheetSnapshotItem(t))return!1;if(!Array.isArray(e.relations))return!1;for(let t of e.relations)if(!isLeanixRelationSnapshotItem(t))return!1;return!0}const xn=`No project or empty model`,Sn=`LEANIX_API_TOKEN is required for likec4 sync leanix --apply`,Cn=`default`,wn=`manifest.json`,Tn=`leanix-dry-run.json`,En=`report.json`;function asBridgeModel(e){return{projectId:String(e.projectId),elements:()=>e.elements(),relationships:()=>e.relationships(),views:()=>e.views()}}function buildBridgeArtifacts(e){let t=toBridgeManifest(e,{mappingProfile:Cn}),n=toLeanixInventoryDryRun(e,{mappingProfile:Cn});return{manifest:t,dryRun:n,report:buildBridgeReport(t,n)}}async function writeBridgeArtifacts(e,t,n,r=process.cwd()){await W(e,{recursive:!0});let i=H(e,wn),a=H(e,Tn),s=H(e,En);await G(i,JSON.stringify(t.manifest,null,2)),await G(a,JSON.stringify(t.dryRun,null,2)),await G(s,JSON.stringify(t.report,null,2)),n.info(`${S.dim(`generated`)} ${V(r,i)}`),n.info(`${S.dim(`generated`)} ${V(r,a)}`),n.info(`${S.dim(`generated`)} ${V(r,s)}`)}const Dn={manifest:wn,dryRun:Tn,report:En};async function leanixDryRunHandler(e){let t=createLikeC4Logger(`c4:gen:leanix:dry-run`),n=startTimer(t),{path:r,outdir:i,project:a,useDotBin:s}=e;try{try{var c=_usingCtx();let e=c.a(await l(r,{graphviz:s?`binary`:`wasm`,watch:!1})),{projectId:n}=ensureProject(e,a);a&&t.info(`${S.dim(`project`)} ${S.green(n)}`);let u=await e.layoutedModel(n);if(u===Oe.EMPTY)throw t.error(xn),Error(xn);await writeBridgeArtifacts(i,buildBridgeArtifacts(asBridgeModel(u)),t)}catch(e){c.e=e}finally{await c.d()}}finally{n.stopAndLog()}}function createLeanixClientFromEnv(){let e=process.env.LEANIX_API_TOKEN?.trim();return e?new LeanixApiClient({apiToken:e,baseUrl:process.env.LEANIX_BASE_URL?.trim()||`https://app.leanix.net`,requestDelayMs:200}):null}function requireLeanixClient(){let e=createLeanixClientFromEnv();if(!e)throw Error(`LEANIX_API_TOKEN is required. Set it in the environment to call the LeanIX API.`);return e}async function leanixInventorySnapshotHandler(e){let t=createLikeC4Logger(`c4:gen:leanix:inventory`),n=startTimer(t),{outdir:r,likec4IdAttribute:i}=e;try{let e=requireLeanixClient(),n={};typeof i==`string`&&i.trim()!==``&&(n.likec4IdAttribute=i.trim());let a=await fetchLeanixInventorySnapshot(e,n);await W(r,{recursive:!0});let s=H(r,`leanix-inventory-snapshot.json`);await G(s,JSON.stringify(a,null,2)),t.info(`${S.dim(`generated`)} ${V(process.cwd(),s)}`),t.info(`${S.dim(`snapshot`)} ${a.factSheets.length} fact sheets, ${a.relations.length} relations`)}finally{n.stopAndLog()}}const On=`manifest.json`,kn=`leanix-inventory-snapshot.json`;async function readManifestAndSnapshot(e){let t=H(e,On),n=H(e,kn),[r,i]=await Promise.all([vt(t,`utf-8`),vt(n,`utf-8`)]),a=JSON.parse(r),s=JSON.parse(i);if(!isBridgeManifest(a))throw Error(`Invalid manifest format: missing manifestVersion, projectId, entities, relations, or views`);if(!isLeanixInventorySnapshot(s))throw Error(`Invalid snapshot format: missing factSheets or relations arrays`);return{manifest:a,snapshot:s}}async function loadDryRunFromWorkspace(e,t,n){try{var r=_usingCtx();let i=r.a(await l(e,{graphviz:n?`binary`:`wasm`,watch:!1})),{projectId:a}=ensureProject(i,t),s=await i.layoutedModel(a);return s===Oe.EMPTY?void 0:buildBridgeArtifacts(asBridgeModel(s)).dryRun}catch(e){r.e=e}finally{await r.d()}}async function leanixReconcileHandler(e){let t=createLikeC4Logger(`c4:gen:leanix:reconcile`),n=startTimer(t),{path:r,outdir:i,project:a,useDotBin:s}=e;try{let e,n;try{let t=await readManifestAndSnapshot(i);e=t.manifest,n=t.snapshot}catch(e){let n=e instanceof Error?e.message:String(e);throw t.error(`Failed to read ${On} or ${kn} from ${i}: ${n}`),e}let c;try{c=await loadDryRunFromWorkspace(r,a,s)}catch(e){let n=e instanceof Error?e.message:String(e);if(a!=null&&a!==``)throw t.error(`Failed to load workspace for dryRun enrichment: ${n}`),e;t.warn(`Could not load workspace for dryRun enrichment; proceeding without it: ${n}`),c=void 0}let l=reconcileInventoryWithManifest(n,e,{...c==null?{}:{dryRun:c}}),u=H(i,`reconciliation-report.json`);await G(u,JSON.stringify(l,null,2)),t.info(`${S.dim(`generated`)} ${V(process.cwd(),u)}`),t.info(`${S.dim(`reconcile`)} matched=${l.summary.matched} unmatchedLikec4=${l.summary.unmatchedInLikec4} unmatchedLeanix=${l.summary.unmatchedInLeanix} ambiguous=${l.summary.ambiguous}`)}finally{n.stopAndLog()}}async function modelHandler({path:e,useDotBin:t,useCorePackage:n,outfile:r,project:i}){try{var a=_usingCtx();let s=createLikeC4Logger(`c4:codegen`),c=startTimer(s),u=a.a(await l(e,{graphviz:t?`binary`:`wasm`,watch:!1})),{projectId:f,projectFolder:p}=ensureProject(u,i);i&&s.info(`${S.dim(`project`)} ${S.green(f)}`),s.info(`${S.dim(`format`)} ${S.green(`model`)}`);let m=await u.layoutedModel(f);for(let e of m.views())e.hasLayoutDrifts&&s.warn(S.yellow(`layout drift detected, view:`)+` `+S.red(e.id));let h=H(u.projectsManager.hasMultipleProjects()?p:u.workspace,`likec4-model.ts`);if(r&&(h=Ye(r)?r:H(r),U(r)&&(await St(r)).isDirectory()))throw Error(`output file is a directory: ${r}`);let g=qe(h);s.info(`${S.dim(`filename`)} ${g}`);let _=Je(g).toLocaleLowerCase();if(![`.ts`,`.mts`,`.cts`].includes(_))throw s.error(`output file ${r} has extension "${_}"`),Error(`output file ${r} must be a .ts, .mts or .cts file`);let v=z(h);s.info(`${S.dim(`outdir`)} ${v}`),await W(v,{recursive:!0}),await G(h,generateLikeC4Model(m,{useCorePackage:n}),{encoding:`utf-8`}),c.stopAndLog(),boxen(ye(`
|
|
208
|
+
${S.dim(`Source generated:`)}
|
|
209
|
+
${V(jt(),h)}
|
|
210
|
+
|
|
211
|
+
${S.dim(`How to use:`)}
|
|
212
|
+
${S.underline(`https://likec4.dev/tooling/code-generation/model/`)}
|
|
213
|
+
`).trim(),{padding:1,borderColor:`green`,borderStyle:`round`})}catch(e){a.e=e}finally{await a.d()}}async function viteReactConfig({languageServices:e,outDir:t,filename:n=`likec4-react.mjs`}){let r=createLikeC4Logger([`vite`,`react`]),i=viteAppRoot();return r.info(`${S.cyan(`likec4 app root`)} ${S.dim(relativeToCwd(i))}`),r.info(S.cyan(`outDir`)+` `+S.dim(relativeToCwd(t))),{customLogger:r,root:i,configFile:!1,clearScreen:!1,publicDir:!1,mode:`production`,resolve:{alias:viteAliases()},build:{outDir:t,emptyOutDir:!1,sourcemap:!1,minify:!1,copyPublicDir:!1,lib:{entry:`codegen/react.mjs`,fileName(e,t){return n},formats:[`es`]},rolldownOptions:{external:[`likec4/react`,`likec4/model`,`react`,`react-dom`,`react/jsx-runtime`,`react/jsx-dev-runtime`,`react-dom/client`,/@likec4\/core.*/]}},plugins:[De({languageServices:e.languageServices})]}}async function reactHandler({path:e,useDotBin:t,useCorePackage:n,outfile:r,project:i}){try{var a=_usingCtx();await ensureReact();let s=createLikeC4Logger(`c4:codegen`),c=startTimer(s),u=a.a(await l(e,{graphviz:t?`binary`:`wasm`,watch:!1})),{projectId:f,projectFolder:p}=ensureProject(u,i);i&&s.info(`${S.dim(`project`)} ${S.green(f)}`),s.info(`${S.dim(`format`)} ${S.green(`react`)}`);let m=await u.diagrams(f);if(m.length===0)throw process.exitCode=1,Error(`no views found`);m.forEach(e=>{if(e.drifts&&e.drifts.length>0){s.info(S.yellow(`layout drift detected, view:`)+` `+S.red(e.id));return}if(e.hasLayoutDrift){s.warn(S.yellow(`drift detected, manual layout can not be applied, view:`)+` `+S.red(e.id));return}});let h=H(u.projectsManager.hasMultipleProjects()?p:u.workspace,`likec4-views.js`);if(r&&(h=Ye(r)?r:H(r),U(r)&&(await St(r)).isDirectory()))throw Error(`output file is a directory: ${r}`);let g=z(h);s.info(`${S.dim(`outdir`)} ${g}`);let _=qe(h);s.info(`${S.dim(`filename`)} ${_}`);let v=Je(_).toLocaleLowerCase();if(![`.js`,`.mjs`,`.jsx`].includes(v))throw s.error(`output file ${r} has extension "${v}"`),Error(`output file ${r} must be a .js, .jsx or .mjs`);await Lt({...await viteReactConfig({languageServices:u,outDir:g,filename:_}),logLevel:`warn`});let y=await u.layoutedModel(f),b=H(g,qe(h,v)+(v===`.mjs`?`.d.mts`:`.d.ts`));await G(b,generateReactTypes(y,{useCorePackage:n})),c.stopAndLog(),boxen(ye(`
|
|
214
|
+
${S.dim(`Sources generated:`)}
|
|
215
|
+
${V(jt(),h)}
|
|
216
|
+
${V(jt(),b)}
|
|
217
|
+
|
|
218
|
+
${S.dim(`How to use:`)}
|
|
219
|
+
${S.underline(`https://likec4.dev/tooling/code-generation/react/`)}
|
|
220
|
+
`),{padding:1,borderColor:`green`,borderStyle:`round`})}catch(e){a.e=e}finally{await a.d()}}async function webcomponentHandler({project:e,path:t,useDotBin:n,webcomponentPrefix:r=`likec4`,outfile:i}){try{var a=_usingCtx();await ensureReact();let s=createLikeC4Logger(`c4:codegen`),c=startTimer(s),u=a.a(await l(t,{graphviz:n?`binary`:`wasm`,watch:!1})),{projectId:f,projectFolder:p}=ensureProject(u,e);e&&s.info(`${S.dim(`project`)} ${S.green(f)}`),s.info(`${S.dim(`format`)} ${S.green(`webcomponent`)}`);let m=await u.diagrams(f);if(!ue(m,1))throw s.warn(`no views found`),process.exitCode=1,Error(`no views found`);m.forEach(e=>{e.hasLayoutDrift&&s.warn(S.yellow(`drift detected, manual layout can not be applied, view:`)+` `+S.red(e.id))});let h=H(u.projectsManager.hasMultipleProjects()?p:u.workspace,`likec4-views.js`);if(i&&(h=Ye(i)?i:H(i),U(i)&&(await St(i)).isDirectory()))throw Error(`output file is a directory: ${i}`);s.debug(`${S.dim(`outfilepath`)} ${h}`);let g=qe(h);s.debug(`${S.dim(`filename`)} ${g}`);let _=Je(g).toLocaleLowerCase();if(_!==`.js`&&_!==`.mjs`)throw s.warn(`output file ${i} has extension "${_}"`),Error(`output file ${i} must be a .js or .mjs`);let v=await mkTempPublicDir();s.debug(`${S.dim(`created temp public`)} ${v}`);let y=viteWebcomponentConfig({languageServices:u,outDir:v,filename:g,webcomponentPrefix:r,base:`/`});s.debug(`${S.dim(`vite build webcomponent`)}`),await Lt({...y,logLevel:`warn`});let b=H(v,g);if(!U(b))throw Error(`output file not found: ${b}`);await W(z(h),{recursive:!0}),await gt(b,h),s.info(`${S.dim(`generated`)} ${h}`),s.debug(`${S.dim(`remove temp public`)}`),await xt(v,{recursive:!0,force:!0}),c.stopAndLog(),boxen(ye(`
|
|
221
|
+
${S.dim(`Webcomponents generated to:`)}
|
|
222
|
+
${V(jt(),h)}
|
|
223
|
+
|
|
224
|
+
${S.dim(`Setup and usage instructions:`)}
|
|
225
|
+
${S.blue(`https://likec4.dev/tooling/code-generation/webcomponent/`)}
|
|
226
|
+
`))}catch(e){a.e=e}finally{await a.d()}}const codegenCmd=e=>e.command({command:`gen <command> [path]`,aliases:[`generate`,`codegen`],describe:`Generate various artifacts from LikeC4 sources`,builder:e=>e.positional(`path`,q).command(`react [path]`,`generate react component to render likec4 view`,e=>e.positional(`path`,q).option(`project`,X).option(`outfile`,{alias:[`o`,`output`],type:`string`,desc:`<file> path to output file (.jsx, .mjs or .js)`,normalize:!0,coerce:H}).option(`use-dot`,J).option(`use-core-package`,Yt),async e=>{await reactHandler({project:e.project,useDotBin:e.useDotBin,path:e.path,outfile:e.outfile,useCorePackage:e.useCorePackage}),showSupportUsMessage()}).command({command:`webcomponent [path]`,aliases:[`wc`,`webcomp`],describe:`generate js with webcomponents`,builder:e=>e.positional(`path`,q).option(`project`,X).option(`outfile`,{alias:[`o`,`output`],type:`string`,desc:`<file> path to output file (.mjs or .js)`,normalize:!0,coerce:H}).option(`webcomponent-prefix`,Zt).option(`use-dot`,J),handler:async e=>{await webcomponentHandler({project:e.project,useDotBin:e.useDotBin,path:e.path,outfile:e.outfile,webcomponentPrefix:e.webcomponentPrefix}),showSupportUsMessage()}}).command({command:`model [path]`,aliases:[`ts`],describe:`generate LikeC4Model (.ts)`,builder:e=>e.positional(`path`,q).option(`project`,X).option(`outfile`,{alias:[`o`,`output`],type:`string`,desc:`<file> path to output file (.ts)`,normalize:!0,coerce:H}).option(`use-dot`,J).option(`use-core-package`,Yt),handler:async e=>{await modelHandler({path:e.path,useDotBin:e.useDotBin,useCorePackage:e.useCorePackage,outfile:e.outfile,project:e.project}),showSupportUsMessage()}}).command({command:`views-data [path]`,aliases:[`views`],describe:`{deprecated} use codegen model`,deprecated:!0,builder:e=>e.positional(`path`,q).option(`outfile`,{alias:[`o`,`output`],type:`string`,desc:`<file> output .ts file`,normalize:!0,coerce:H}).option(`use-dot`,J),handler:async e=>{await legacyHandler({format:`views`,path:e.path,useDotBin:e.useDotBin,outfile:e.outfile})}}).command({command:`leanix [path]`,describe:`LeanIX bridge: dry-run, inventory snapshot, reconcile`,builder:e=>e.positional(`path`,q).demandCommand(1,`Choose a subcommand: dry-run, inventory, reconcile`).command(`dry-run [path]`,`generate LeanIX bridge artifacts (manifest, dry-run inventory, report)`,e=>e.positional(`path`,q).option(`outdir`,{...Y,desc:`<dir> output directory for manifest.json, leanix-dry-run.json, report.json`}).option(`project`,X).option(`use-dot`,J).example(`${S.green(`$0 gen leanix dry-run -o out/bridge`)}`,S.gray(`Write bridge artifacts to out/bridge`)),async e=>{await leanixDryRunHandler({path:e.path,outdir:e.outdir??H(process.cwd(),`out`,`bridge`),project:e.project,useDotBin:e.useDotBin})}).command(`inventory`,`fetch LeanIX inventory (read-only) and write leanix-inventory-snapshot.json`,e=>e.option(`outdir`,{...Y,default:H(process.cwd(),`out`,`bridge`),desc:`<dir> output directory for leanix-inventory-snapshot.json`}).option(`likec4-id-attribute`,{type:`string`,desc:`custom LeanIX attribute key for likec4Id (e.g. "likec4Id")`}).example(`${S.green(`$0 gen leanix inventory -o out/bridge`)}`,S.gray(`Requires LEANIX_API_TOKEN`)),async e=>{await leanixInventorySnapshotHandler({outdir:e.outdir??H(process.cwd(),`out`,`bridge`),...e.likec4IdAttribute==null?{}:{likec4IdAttribute:e.likec4IdAttribute}})}).command(`reconcile [path]`,`reconcile manifest with leanix-inventory-snapshot; write reconciliation-report.json`,e=>e.positional(`path`,q).option(`outdir`,{...Y,default:H(process.cwd(),`out`,`bridge`),desc:`<dir> directory with manifest.json and leanix-inventory-snapshot.json`}).option(`project`,X).option(`use-dot`,J).example(`${S.green(`$0 gen leanix reconcile -o out/bridge`)}`,S.gray(`Reads manifest + snapshot from outdir; optional workspace for name+type matching`)),async e=>{await leanixReconcileHandler({path:e.path,outdir:e.outdir??H(process.cwd(),`out`,`bridge`),project:e.project,useDotBin:e.useDotBin})}),handler:async()=>{}}).command({command:`dot [path]`,describe:`generate graphviz files (.dot)`,builder:e=>e.positional(`path`,q).option(`outdir`,Y).option(`use-dot`,J),handler:async e=>{await legacyHandler({format:`dot`,path:e.path,useDotBin:e.useDotBin,outdir:e.outdir}),showSupportUsMessage()}}).command({command:`d2 [path]`,describe:`generate D2 files (.d2)`,builder:e=>e.positional(`path`,q).option(`outdir`,Y).option(`use-dot`,J),handler:async e=>{await legacyHandler({format:`d2`,path:e.path,useDotBin:e.useDotBin,outdir:e.outdir}),showSupportUsMessage()}}).command({command:`mermaid [path]`,aliases:[`mmd`],describe:`generate Mermaid files (.mmd)`,builder:e=>e.positional(`path`,q).option(`outdir`,Y).option(`use-dot`,J),handler:async e=>{await legacyHandler({format:`mermaid`,useDotBin:e.useDotBin,path:e.path,outdir:e.outdir}),showSupportUsMessage()}}).command({command:`plantuml [path]`,aliases:[`puml`],describe:`generate PlantUML files (.puml)`,builder:e=>e.positional(`path`,q).option(`outdir`,Y).option(`use-dot`,J),handler:async e=>{await legacyHandler({format:`plantuml`,useDotBin:e.useDotBin,path:e.path,outdir:e.outdir}),showSupportUsMessage()}}).command({command:`<custom> [path]`,describe:`run custom generator from likec4 config`,builder:e=>e.positional(`path`,q).option(`project`,X).option(`use-dot`,J),handler:async e=>{await customHandler({name:`custom`,path:e.path,project:e.project,useDotBin:e.useDotBin})}}).epilog(`${S.bold(`Examples:`)}
|
|
101
227
|
likec4 gen react -o dist/likec4-views.mjs ./src/likec4
|
|
102
228
|
likec4 gen model -o likec4-model.ts
|
|
103
229
|
likec4 gen leanix dry-run -o out/bridge
|
|
@@ -108,57 +234,70 @@ import{s as e}from"../_chunks/rolldown-runtime.mjs";import"../_chunks/libs/birpc
|
|
|
108
234
|
likec4 gen mmd --outdir assets/
|
|
109
235
|
likec4 gen plantuml --outdir assets/
|
|
110
236
|
likec4 gen dot -o out .
|
|
111
|
-
`),handler:async e=>{await
|
|
112
|
-
|
|
113
|
-
`){return e.filter(e=>e.trim()!==``).join(t)}const
|
|
114
|
-
${
|
|
115
|
-
${
|
|
116
|
-
|
|
117
|
-
${
|
|
118
|
-
${
|
|
119
|
-
|
|
120
|
-
${
|
|
121
|
-
${
|
|
122
|
-
|
|
123
|
-
${
|
|
124
|
-
${
|
|
125
|
-
|
|
126
|
-
${
|
|
127
|
-
${
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
`),
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
${
|
|
142
|
-
${
|
|
143
|
-
|
|
144
|
-
${
|
|
145
|
-
${
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
${
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
${
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
237
|
+
`),handler:async e=>{await customHandler({name:e.command,path:e.path,project:e.project,useDotBin:e.useDotBin})}}),An=new Set([`node_modules`,`.git`]);function isSourceFile(e){return e.endsWith(`.c4`)||e.endsWith(`.likec4`)}function joinNonEmptyFiles(e,t=`
|
|
238
|
+
|
|
239
|
+
`){return e.filter(e=>e.trim()!==``).join(t)}const jn=`No project or empty model`,Mn=`No views could be exported`;function getDrawioEpilog(){return`${S.bold(`Examples:`)}
|
|
240
|
+
${S.green(`$0 export drawio`)}
|
|
241
|
+
${S.gray(`Export each view to a separate .drawio file`)}
|
|
242
|
+
|
|
243
|
+
${S.green(`$0 export drawio --all-in-one -o ./diagrams src/`)}
|
|
244
|
+
${S.gray(`Export all views as tabs in one .drawio file`)}
|
|
245
|
+
|
|
246
|
+
${S.green(`$0 export drawio --roundtrip -o ./out`)}
|
|
247
|
+
${S.gray(`Re-apply layout/waypoints from comment blocks (e.g. after import from DrawIO)`)}
|
|
248
|
+
|
|
249
|
+
${S.green(`$0 export drawio --uncompressed -o ./out`)}
|
|
250
|
+
${S.gray(`Export with raw XML (no compression) for draw.io desktop compatibility`)}
|
|
251
|
+
|
|
252
|
+
${S.green(`$0 export drawio --profile leanix -o ./out`)}
|
|
253
|
+
${S.gray(`Export with bridge-managed metadata (likec4Id, likec4ViewId, etc.) for LeanIX interoperability`)}`}function toError(e){return e instanceof Error?e:Error(a(e))}function logAndRethrow(e,t,n){let r=toError(n);throw e.error(t,{error:r}),r}async function readWorkspaceSourceContent(e,t){let n=[],r=new Set;async function walk(e,i){if(i>=50)return;let a=await bt(e).catch(()=>null);if(a==null||r.has(a))return;r.add(a);let s=await yt(e,{withFileTypes:!0}).catch(n=>(t?.debug&&t.debug(`${S.dim(`Roundtrip:`)} readdir failed`,{dir:e,err:n}),[]));for(let r of s){let a=B(e,r.name);switch(!0){case r.isDirectory():An.has(r.name)||await walk(a,i+1);break;case r.isSymbolicLink():if((await St(a).catch(()=>null))?.isFile()&&isSourceFile(r.name)){let e=await vt(a,`utf-8`).catch(e=>(t?.debug&&t.debug(`${S.dim(`Roundtrip:`)} readFile failed`,{file:a,err:e}),``));e&&n.push(e)}break;case r.isFile()&&isSourceFile(r.name):{let e=await vt(a,`utf-8`).catch(e=>(t?.debug&&t.debug(`${S.dim(`Roundtrip:`)} readFile failed`,{file:a,err:e}),``));e&&n.push(e);break}}}}return await walk(e,0),joinNonEmptyFiles(n)}async function getSourceContentIfRoundtrip(e,t,n){if(t)return readWorkspaceSourceContent(H(e),n)}function buildDrawioExportOverrides(e,t,n){let r=e?{compressed:!1}:{compressed:!0};return t===`leanix`&&(r.profile=`leanix`,r.projectId=n),r}function buildOptionsByViewId(e,t,n,r,i){return Se(e.map(e=>String(e.$view.id)),t,buildDrawioExportOverrides(n,r,i))}async function exportDrawioAllInOne(e){let{viewmodels:t,outdir:n,workspacePath:r,roundtrip:i,uncompressed:a,profile:s,projectId:c,logger:l}=e,u=we(t,buildOptionsByViewId(t,await getSourceContentIfRoundtrip(r,i,l),a,s,c)),f=H(n,Ee);await G(f,u),l.info(`${S.dim(`generated`)} ${V(process.cwd(),f)} (${t.length} tab(s))`)}async function writeViewToFile(e,t,n,r){let i=String(e.$view.id);try{let a=be(e,t[i]),s=H(n,i+`.drawio`);return await W(z(s),{recursive:!0}),await G(s,a),r.info(`${S.dim(`generated`)} ${V(process.cwd(),s)}`),!0}catch(e){return r.error(`Failed to export view ${i}`,{error:toError(e)}),!1}}async function exportDrawioPerView(e){let{viewmodels:t,outdir:n,workspacePath:r,roundtrip:i,uncompressed:a,profile:s,projectId:c,logger:l}=e,u=buildOptionsByViewId(t,await getSourceContentIfRoundtrip(r,i,l),a,s,c),f=0;for(let e of t)await writeViewToFile(e,u,n,l)&&f++;return{succeeded:f}}async function runExportDrawio(e,t){try{var n=_usingCtx();let r=startTimer(t),i=n.a(await l(e.path,{graphviz:e.useDot?`binary`:`wasm`,watch:!1}));e.project||i.ensureSingleProject();let a=e.project==null?void 0:i.languageServices.projectsManager.ensureProjectId(e.project),s=await i.layoutedModel(a);if(s===Oe.EMPTY)throw t.error(jn),Error(jn);let c=[...s.views()];if(c.length===0)throw t.error(`No views to export`),Error(Mn);await W(e.outdir,{recursive:!0});let u=String(s.projectId),f={viewmodels:c,outdir:e.outdir,workspacePath:e.path,roundtrip:e.roundtrip,uncompressed:e.uncompressed,profile:e.profile,projectId:u,logger:t};if(e.allInOne)try{await exportDrawioAllInOne(f)}catch(e){logAndRethrow(t,`Failed to export DrawIO`,e)}else{let{succeeded:e}=await exportDrawioPerView(f);if(e===0)throw t.error(Mn),Error(Mn);t.info(`${S.dim(`total`)} ${e} DrawIO file(s)`)}r.stopAndLog(`✓ export drawio in `)}catch(e){n.e=e}finally{await n.d()}}function drawioCmd(e){return e.command({command:`drawio [path]`,describe:`export view(s) to DrawIO (.drawio) for editing in draw.io`,builder:e=>e.positional(`path`,q).option(`outdir`,{alias:`o`,type:`string`,desc:`<dir> output directory for .drawio files`,normalize:!0,coerce:H}).option(`all-in-one`,{type:`boolean`,default:!1,desc:`write one .drawio file with all views as tabs (diagrams)`}).option(`roundtrip`,{type:`boolean`,default:!1,desc:`apply layout/stroke/waypoints from DrawIO round-trip comment blocks in .c4 source`}).option(`uncompressed`,{type:`boolean`,default:!1,desc:`write diagram XML uncompressed inside .drawio (larger file; use if draw.io desktop fails to open compressed export)`}).option(`profile`,{type:`string`,choices:[`default`,`leanix`],default:`default`,desc:`export profile: default (round-trip) or leanix (bridge-managed metadata for LeanIX interoperability)`}).options({project:X,"use-dot":J}).epilog(getDrawioEpilog()),handler:async e=>{let t=createLikeC4Logger(`c4:export`);await runExportDrawio({path:e.path,outdir:e.outdir??e.path,allInOne:!!e.allInOne,roundtrip:!!e.roundtrip,uncompressed:!!e.uncompressed,profile:e.profile===`leanix`?`leanix`:`default`,project:e.project,useDot:!!e[`use-dot`]},t)}})}var Nn=e(ve(),1);function resolveServerUrl(e){if(e.resolvedUrls)return ce(e.resolvedUrls.network)??ce(e.resolvedUrls.local)}function printServerUrls(e){if(!e.resolvedUrls)throw Error(`Vite server is not ready, no resolvedUrls`);boxen([S.green(`LikeC4 served at:`),``,S.dim(`Local: `)+e.resolvedUrls.local.join(`
|
|
254
|
+
`+``.padEnd(9,` `)),e.resolvedUrls.network.length?S.dim(`Network: `)+e.resolvedUrls.network.join(`
|
|
255
|
+
`+``.padEnd(9,` `)):void 0].filter(e=>he(e)).join(`
|
|
256
|
+
`))}async function viteDev({buildWebcomponent:e=!1,hmr:t=!0,webcomponentPrefix:n=`likec4`,title:r,languageServices:i,likec4AssetsDir:s,openBrowser:c,listen:l,port:u,...f}){s??=await _t(B(ut(),`.likec4-assets-`));let{isDev:p,...m}=await viteConfig({...f,languageServices:i,likec4AssetsDir:s,webcomponentPrefix:n,title:r}),h=m.customLogger;u??=Tt.PORT?parseInt(Tt.PORT,10):void 0,u||=await Ve({port:[5173,5174,...Be(61e3,61010),...Be(62002,62010)]});let g=24678,_=await mkTempPublicDir(),v=l??(O()?`0.0.0.0`:`localhost`);t?(g=await Ve({port:Be(24678,24690)}),h.info(`Enabling HMR: localhost:${g}`),O()&&h.info(S.yellow(`ensure port ${g} is published from container`))):h.info(`Disabling HMR`);let y=await Rt({...m,define:t?{...m.define,"process.env.NODE_ENV":`"development"`}:m.define,mode:t?`development`:m.mode,publicDir:_,optimizeDeps:{force:!0},server:{host:v,allowedHosts:!0,port:u,hmr:t&&{overlay:!0,port:g},fs:{strict:!1},open:c??(!p&&!O())}});if(e){let e=viteWebcomponentConfig({webcomponentPrefix:n,languageServices:i,outDir:_,base:m.base});h.info(`Building webcomponent`),Lt({...e,logLevel:`warn`}).catch(e=>{h.warn(a(e)),h.warn(`webcomponent build failed, ignoring error and continue`)})}else h.info(`Skip webcomponent build`);return await y.listen(),y}async function takeScreenshot({browserContext:e,views:t,output:n,logger:r,timeout:i,maxAttempts:a,dynamicVariant:s,outputType:c,theme:l,format:u=`png`,quality:f}){let p,m=t.map(e=>({view:e,attempt:1})),h=[],g;for(;g=m.shift();){let{view:t,attempt:_}=g,v=`export/${encodeURIComponent(t.id)}/`;try{if(_>1){p&&=(p.close({runBeforeUnload:!0}).catch(e=>r.error(`failed to close page: ${e}`)),void 0);let e=de(_*200,{min:200,max:1e3});r.info(S.cyan(v)+S.dim(` attempt ${_} of ${a} after ${e}ms`)),await Ht(e)}else t.hasLayoutDrift&&r.warn(S.yellow(`Drift detected, manual layout can not be applied, view may be invalid: `)+S.red(t.id));let m=`.`;c===`relative`&&(m=t.sourcePath??`.`,m=m.includes(`/`)?m.slice(0,m.lastIndexOf(`/`)):`.`);let g=u===`jpeg`?`.jpg`:`.png`,y=H(n,m,`${t.id}${g}`);p??=await e.newPage();let b=t.bounds;s===`sequence`&&t._type===`dynamic`&&(b=t.sequenceLayout.bounds),await p.setViewportSize({width:b.width+40+20,height:b.height+40+20}),await p.goto(C(v,{padding:20,theme:l,dynamic:s,...u===`jpeg`?{format:`jpeg`}:{}})),r.info(S.cyan(v)+S.dim(` -> ${V(n,y)}`)),await p.waitForSelector(`.react-flow.initialized`),t.nodes.some(e=>se(e.icon)&&e.icon.toLowerCase().startsWith(`http`))&&await waitAllImages(p,i),await p.getByTestId(`export-page`).screenshot({animations:`disabled`,path:y,type:u===`jpeg`?`jpeg`:`png`,...u===`jpeg`?{quality:f??80,omitBackground:!1}:{omitBackground:!0}}),h.push({view:t,path:y})}catch(e){p?.close({runBeforeUnload:!0}).catch(e=>r.error(`failed to close page: ${e}`)),r.error(S.red(`failed `+v+`
|
|
257
|
+
`+e)),_<a&&(m.push({view:t,attempt:_+1}),r.info(S.dim(`retry ${v}`))),p=void 0}}return h}async function waitAllImages(e,t){let n=await e.locator(`//img`).all();if(!n.length)return;let r=n.map(e=>e.evaluate(e=>e.complete||new Promise(t=>{e.onload=t,e.onerror=t}),{timeout:Math.max(15e3,t)}));await Promise.allSettled(r)}async function exportViewsToPNG({logger:e,serverUrl:t,theme:n=`light`,timeoutMs:r=15e3,views:i,output:a,outputType:s=`relative`,maxAttempts:c=3,chromiumSandbox:l=!1,sequence:u=!1,format:f=`png`,quality:p}){e.info(`${S.dim(`output`)} ${a}`),e.info(`${S.dim(`base url`)} ${t}\n`);let{chromium:m}=await import(`playwright`),h=m.executablePath();e.info(S.cyan(`Start chromium`)+` `+S.dim(h));let g=await m.launch({chromiumSandbox:l,headless:!0});e.info(S.cyan(`Color scheme: `)+n+`
|
|
258
|
+
`);let _=await g.newContext({deviceScaleFactor:2,colorScheme:n,baseURL:t,bypassCSP:!0,ignoreHTTPSErrors:!0,isMobile:!1});_.setDefaultNavigationTimeout(r),_.setDefaultTimeout(r);try{return await takeScreenshot({browserContext:_,views:i,output:a,outputType:s,logger:e,maxAttempts:c,dynamicVariant:u?`sequence`:`diagram`,timeout:r,theme:n,format:f,quality:p})}finally{e.info(S.cyan(`close chromium`)),await _.close(),await g.close()}}async function runExportPng(e,t){try{var n=_usingCtx();let{path:r,useDotBin:i,project:a,theme:s=`light`,output:c,outputType:u,serverUrl:f,ignore:p=!1,timeoutMs:m=15e3,maxAttempts:h=3,filter:g,sequence:_=!1,chromiumSandbox:v=!1,format:y=`png`,quality:b}=e,x=n.a(await l(r,{graphviz:i?`binary`:`wasm`,watch:!1})),ee=c??x.workspace,C,w=f,T=[...x.languageServices.projects()];if(a&&!T.some(e=>e.id===a))throw t.error(`project not found: ${a}`),Error(`project not found: ${a}`);try{if(!w&&(t.info(S.cyan(`start preview server`)),C=await viteDev({languageServices:x,buildWebcomponent:!1,openBrowser:!1,hmr:!1}),w=resolveServerUrl(C),!w))throw t.error(`Vite server is not ready, no resolvedUrls`),Error(`Vite server is not ready, no resolvedUrls`);for(let e of T){if(a&&e.id!==a)continue;T.length>1&&(t.info(S.dim(`---------`)),t.info(`${S.dim(`project:`)} ${e.id}`),t.info(`${S.dim(`folder:`)} ${e.folder.fsPath}`));let n=await x.diagrams(e.id);if(g&&ue(g,1)&&ue(n,1)){let e=(0,Nn.default)(g);t.info(`${S.cyan(`filter`)} ${S.dim(JSON.stringify(g))}`),n=n.filter(n=>e(n.id)?(t.info(`${S.green(`include`)} ${n.id} ✅`),!0):(t.info(`${S.gray(`skip`)} ${S.dim(n.id)}`),!1))}if(!ue(n,1)){t.warn(`no views found`);continue}let r=T.length>1?te(ne(w,`project`,e.id)):w,i=T.length>1?ne(ee,e.id):ee,c=Nt(),l=await exportViewsToPNG({logger:t,serverUrl:r,theme:s,timeoutMs:m,views:n,output:i,outputType:u,maxAttempts:h,sequence:_,chromiumSandbox:v,format:y,quality:b}),{pretty:f}=inMillis(c);if(l.length>0&&t.info(S.green(`exported ${l.length} views in ${f}`)+`
|
|
259
|
+
`),l.length!==n.length&&(p&&l.length>0?t.info(S.dim(`ignore`)+` `+S.red(`failed ${n.length-l.length} out of ${n.length} views`)):t.error(S.red(`failed ${n.length-l.length} out of ${n.length} views`))),l.length!==n.length&&(l.length===0||!p))throw Error(`Failed ${n.length-l.length} out of ${n.length} views`)}}finally{C&&(t.info(S.cyan(`stop server`)),await C.close().catch(e=>{t.error(e)}))}}catch(e){n.e=e}finally{await n.d()}}async function pngHandler(e){await runExportPng(e,createLikeC4Logger(`c4:export`))}function pngCmd(e){return e.command({command:`png [path]`,describe:`export views to PNG`,builder:e=>e.positional(`path`,q).options({outdir:{alias:[`o`,`output`],type:`string`,desc:`output directory for PNG files; if not specified, images are saved next to sources`,normalize:!0,nargs:1,coerce:H},project:X,theme:{choices:[`light`,`dark`],desc:`color-scheme to use, defaults to light`,conflicts:[`dark`,`light`],nargs:1},dark:{type:`boolean`,desc:`use dark theme, shortcut for --theme=dark`,conflicts:[`theme`,`light`]},light:{type:`boolean`,desc:`use light theme, shortcut for --theme=light`,conflicts:[`theme`,`dark`]},"use-dot":J,seq:{alias:[`sequence`],type:`boolean`,desc:`use sequence layout for dynamic views`},flat:{alias:[`flatten`],type:`boolean`,desc:`flatten all images in outdir ignoring sources structure`},filter:{alias:`f`,array:!0,string:!0,desc:`include views with ids matching given patterns
|
|
260
|
+
multiple patterns are combined with OR`},ignore:{boolean:!0,alias:`i`,desc:`continue if export fails for some views`},timeout:{type:`number`,alias:`t`,desc:`timeout for playwright (in seconds)`,default:15,nargs:1},"max-attempts":{type:`number`,desc:`max attempts to export failing view, 1 means no retry`,default:3,nargs:1},"server-url":{type:`string`,desc:`use this url instead of starting new likec4 server`,nargs:1},"chromium-sandbox":{boolean:!0,desc:`enable chromium sandbox (see Playwright docs)`,default:!1}}).epilog(`${S.bold(`Examples:`)}
|
|
261
|
+
${S.green(`$0 export png`)}
|
|
262
|
+
${S.gray(`Search for likec4 files in current directory and output PNG next to sources`)}
|
|
263
|
+
|
|
264
|
+
${S.green(`$0 export png --theme dark -o ./png src/likec4`)}
|
|
265
|
+
${S.gray(`Search for likec4 files in src/likec4 and output PNG with dark theme to png folder`)}
|
|
266
|
+
|
|
267
|
+
${S.green(`$0 export png -f "team1*" -f "team2*" --flat -o ./png src/likec4`)}
|
|
268
|
+
${S.gray(`Export views matching team1* or team2* only`)}
|
|
269
|
+
|
|
270
|
+
${S.green(`$0 export png -f "use-case*" --sequence src/likec4`)}
|
|
271
|
+
${S.gray(`Export views matching use-case* using sequence layout`)}
|
|
272
|
+
`),handler:async e=>{R(e.timeout>=1,`timeout must be >= 1`),R(e[`max-attempts`]>=1,`max-attempts must be >= 1`),await ensureReact(),await ensurePlaywright();let t=e.theme??(e.dark?`dark`:`light`);await pngHandler({path:e.path,useDotBin:e[`use-dot`],output:e.outdir,project:e.project,timeoutMs:e.timeout*1e3,maxAttempts:e[`max-attempts`],ignore:e.ignore===!0,outputType:e.flat?`flat`:`relative`,serverUrl:e[`server-url`],theme:t,filter:e.filter,sequence:e.seq,chromiumSandbox:e[`chromium-sandbox`]}),showSupportUsMessage()}})}async function jpgHandler(e){let t=createLikeC4Logger(`c4:export`);await runExportPng({...e,format:`jpeg`},t)}function jpgCmd(e){return e.command({command:`jpg [path]`,describe:`export views to JPEG`,builder:e=>e.positional(`path`,q).options({outdir:{alias:[`o`,`output`],type:`string`,desc:`output directory for JPEG files; if not specified, images are saved next to sources`,normalize:!0,nargs:1,coerce:H},project:X,quality:{alias:`q`,type:`number`,desc:`JPEG quality (1-100)`,default:80,nargs:1},theme:{choices:[`light`,`dark`],desc:`color-scheme to use, defaults to light`,conflicts:[`dark`,`light`],nargs:1},dark:{type:`boolean`,desc:`use dark theme, shortcut for --theme=dark`,conflicts:[`theme`,`light`]},light:{type:`boolean`,desc:`use light theme, shortcut for --theme=light`,conflicts:[`theme`,`dark`]},"use-dot":J,seq:{alias:[`sequence`],type:`boolean`,desc:`use sequence layout for dynamic views`},flat:{alias:[`flatten`],type:`boolean`,desc:`flatten all images in outdir ignoring sources structure`},filter:{alias:`f`,array:!0,string:!0,desc:`include views with ids matching given patterns
|
|
273
|
+
multiple patterns are combined with OR`},ignore:{boolean:!0,alias:`i`,desc:`continue if export fails for some views`},timeout:{type:`number`,alias:`t`,desc:`timeout for playwright (in seconds)`,default:15,nargs:1},"max-attempts":{type:`number`,desc:`max attempts to export failing view, 1 means no retry`,default:3,nargs:1},"server-url":{type:`string`,desc:`use this url instead of starting new likec4 server`,nargs:1},"chromium-sandbox":{boolean:!0,desc:`enable chromium sandbox (see Playwright docs)`,default:!1}}).epilog(`${S.bold(`Examples:`)}
|
|
274
|
+
${S.green(`$0 export jpg`)}
|
|
275
|
+
${S.gray(`Search for likec4 files in current directory and output JPEG next to sources`)}
|
|
276
|
+
|
|
277
|
+
${S.green(`$0 export jpg --theme dark -o ./jpg src/likec4`)}
|
|
278
|
+
${S.gray(`Search for likec4 files in src/likec4 and output JPEG with dark theme to jpg folder`)}
|
|
279
|
+
|
|
280
|
+
${S.green(`$0 export jpg --quality 90 -o ./jpg src/likec4`)}
|
|
281
|
+
${S.gray(`Export JPEG with 90% quality`)}
|
|
282
|
+
|
|
283
|
+
${S.green(`$0 export jpg -f "team1*" -f "team2*" --flat -o ./jpg src/likec4`)}
|
|
284
|
+
${S.gray(`Export views matching team1* or team2* only`)}
|
|
285
|
+
`),handler:async e=>{R(e.quality>=1&&e.quality<=100,`quality must be between 1 and 100`),R(e.timeout>=1,`timeout must be >= 1`),R(e[`max-attempts`]>=1,`max-attempts must be >= 1`),await ensureReact(),await ensurePlaywright();let t=e.theme??(e.dark?`dark`:`light`);await jpgHandler({path:e.path,useDotBin:e[`use-dot`],output:e.outdir,project:e.project,timeoutMs:e.timeout*1e3,maxAttempts:e[`max-attempts`],ignore:e.ignore===!0,outputType:e.flat?`flat`:`relative`,serverUrl:e[`server-url`],theme:t,filter:e.filter,sequence:e.seq,chromiumSandbox:e[`chromium-sandbox`],format:`jpeg`,quality:e.quality}),showSupportUsMessage()}})}const Pn=`project not found`,Fn=`No projects found`;async function runExportJson(e,t){try{var n=_usingCtx();let r=startTimer(t),i=n.a(await l(e.path,{graphviz:e.useDot?`binary`:`wasm`,watch:!1})),a=[...i.projectsManager.all];if(e.project){if(a=a.filter(t=>t===e.project),!ue(a,1))throw t.error(`${Pn}: ${e.project}`),Error(`${Pn}: ${e.project}`)}else{if(!ue(a,1))throw t.error(Fn),Error(Fn);t.info(`${S.dim(`workspace:`)} Found ${a.length} projects`)}let s=[];for(let n of a){let r;if(e.skipLayout?(t.info(`Generate model for project ${S.green(n)} ${S.dim(`(skip layout)`)}`),r=await i.computedModel(n)):(t.info(`Generating layouted model for project ${S.green(n)}`),r=await i.layoutedModel(n)),r===Oe.EMPTY){t.warn(S.yellow(`Project ${n} is empty, skipping`));continue}s.push(r.$data)}if(s.length===0)throw t.warn(`No models generated, aborting export`),Error(`No models generated; all projects are empty or were skipped`);let c=e.outfile;Je(c).toLowerCase()!==`.json`&&(c+=`.json`),await W(z(c),{recursive:!0});let u=s.length===1?s[0]:s,f=e.pretty?JSON.stringify(u,void 0,2):JSON.stringify(u);await G(c,f);let p=c.startsWith(e.path)?V(e.path,c):c;t.info(`${S.dim(`generated`)} ${p}`),r.stopAndLog(`✓ export in `)}catch(e){n.e=e}finally{await n.d()}}function jsonCmd(e){return e.command({command:`json [path]`,describe:`export model(s) to JSON`,builder:e=>e.positional(`path`,q).option(`outfile`,{alias:`o`,type:`string`,desc:`<file> output .json file`,default:`likec4.json`,normalize:!0,coerce:H}).options({project:X,"use-dot":J,"skip-layout":{type:`boolean`,desc:`skip layouting (only compute model)`},pretty:{type:`boolean`,desc:`indented JSON output`}}).epilog(`${S.bold(`Examples:`)}
|
|
286
|
+
${S.green(`$0 export json --skip-layout`)}
|
|
287
|
+
${S.gray(`Search for likec4 files in current directory and output JSON to likec4.json (no layout)`)}
|
|
288
|
+
|
|
289
|
+
${S.green(`$0 export json --pretty -o ./generated/likec4.json src/likec4 `)}
|
|
290
|
+
${S.gray(`Search for likec4 files in src/likec4 and output JSON to generated/likec4.json`)}
|
|
291
|
+
`),handler:async e=>{let t=createLikeC4Logger(`c4:export`);await runExportJson({path:e.path,outfile:e.outfile,project:e.project,skipLayout:!!e.skipLayout,pretty:!!e.pretty,useDot:!!e[`use-dot`]},t),showSupportUsMessage()}})}const exportCmd=e=>e.command({command:`export <format> [path]`,describe:`Export to images, JSON, or DrawIO`,builder:e=>le(e.usage(`${S.bold(`Usage:`)} $0 export <format> [path]`),pngCmd,jpgCmd,jsonCmd,drawioCmd).updateStrings({"Commands:":S.bold(`Formats:`)}),handler:()=>void 0}),formatCmd=e=>e.command({command:`format [path]`,aliases:[`fmt`],describe:`Format LikeC4 source files`,builder:e=>e.positional(`path`,q).options({project:{alias:`p`,type:`string`,array:!0,desc:`select project(s) to format (repeatable)`},files:{type:`string`,array:!0,normalize:!0,coerce:e=>e.map(e=>H(e)),desc:`specific file(s) to format (repeatable)`},check:{type:`boolean`,desc:`Check if files are formatted (exit with 1 if not)`,default:!1}}),handler:async e=>{try{var t=_usingCtx();let n=createLikeC4Logger(`c4:format`),r=startTimer(n),i=e.check,a;try{a=await l(e.path,{watch:!1})}catch(e){n.error(e instanceof Error?e.message:String(e)),process.exitCode=1;return}t.a(a);let s=e.project?.filter(Boolean),c=e.files?.filter(Boolean).map(e=>wt(e).toString());if(n.debug(`workspace: ${e.path}`),s?.length){n.debug(`projects:`);for(let e of s)n.debug(` ${e}`)}if(c?.length){n.debug(`files:`);for(let e of c)n.debug(` ${Ct(e)}`)}let u;try{u=await a.format({...s?.length&&{projects:s},...c?.length&&{documentUris:c}})}catch(e){n.error(e instanceof Error?e.message:String(e)),process.exitCode=1;return}n.debug(`${u.size} document(s) to process`);let f=process.cwd(),displayPath=e=>{let t=V(f,e);return t.startsWith(`..`)?e:t};if(c){let e=c.filter(e=>!u.has(e));for(let t of e)n.warn(`${S.yellow(`skipped`)} ${displayPath(Ct(t))} (not found in workspace)`)}let p=0,m=0,h=[];for(let[e,t]of u){let r=Ct(e),a=displayPath(r),s;try{s=await vt(r,`utf-8`)}catch(e){n.error(`Failed to read ${a}: ${e}`),m++;continue}if(s===t){n.debug(`${S.dim(`unchanged`)} ${a}`);continue}if(p++,h.push(a),i)n.info(`${S.yellow(`needs formatting`)} ${a}`);else try{await G(r,t,`utf-8`),n.info(`${S.green(`formatted`)} ${a}`)}catch(e){n.error(`Failed to write ${a}: ${e}`),m++}}if(m>0){n.error(`${m} file(s) failed to process`),process.exitCode=1;return}if(i){if(p>0){n.error(`${p} of ${u.size} file(s) need formatting:\n${h.map(e=>` ${e}`).join(`
|
|
292
|
+
`)}`),process.exitCode=1;return}n.info(S.green(`All ${u.size} file(s) are formatted`))}else p>0?n.info(`${S.green(String(p))} of ${u.size} file(s) formatted`):n.info(S.green(`All ${u.size} file(s) already formatted`));r.stopAndLog(`✓ format in `)}catch(e){t.e=e}finally{await t.d()}}}),listIconsCmd=e=>e.command({command:`list-icons`,describe:`List available built-in icons`,builder:e=>e.option(`format`,{alias:`f`,choices:[`text`,`json`],default:`text`,description:`Output format`}).option(`group`,{alias:`g`,choices:s,description:`Filter icons by group`}),handler:e=>{let t=e.group?[e.group]:s;switch(!0){case e.format===`json`:{let e=Object.fromEntries(t.map(e=>[e,n[e]]));console.log(JSON.stringify(e,null,2));break}default:for(let e of t)for(let t of n[e])console.log(`${e}:${t}`)}}});var In=He();function lsp_default(e){return e.command({command:`lsp`,aliases:[],describe:`Start LSP server`,builder:e=>e.usage(`${S.bold(`Usage:`)} $0 lsp`).option(`log-level`,an).option(`verbose`,on).options({"node-ipc":{boolean:!0,description:`use node-ipc transport`,conflicts:[`stdio`,`socket`,`pipe`]},stdio:{boolean:!0,description:`use stdio transport`,conflicts:[`node-ipc`,`socket`,`pipe`]},socket:{number:!0,description:`use socket transport on specified port`,conflicts:[`node-ipc`,`stdio`,`pipe`],nargs:1},pipe:{string:!0,description:`use pipe transport with specified pipe name`,conflicts:[`node-ipc`,`stdio`,`socket`],nargs:1},"manual-layouts":{boolean:!0,description:`enable/disable manual layouts`,default:!0,defaultDescription:`enabled`},watch:{alias:`w`,boolean:!0,description:`enable built-in watcher`,default:!1,defaultDescription:`disabled`},telemetry:{boolean:!0,default:!0,defaultDescription:`IDE setting`,description:`enable/disable telemetry`,hidden:!0}}).option(`use-dot`,J).showHidden().epilog(`${S.bold(`Examples:`)}
|
|
293
|
+
|
|
294
|
+
${S.green(`$0 lsp --stdio `)}
|
|
295
|
+
${S.gray(`Start LSP with stdio transport`)}
|
|
296
|
+
|
|
297
|
+
${S.green(`$0 lsp --node-ipc --watch --no-manual-layouts --no-color `)}
|
|
298
|
+
${S.gray(`Start LSP with node-ipc transport and watcher, disabled manual layouts and disabled color`)}
|
|
299
|
+
|
|
300
|
+
`),handler:e=>{let t;if(e.nodeIpc||e.stdio||e.socket||e.pipe)t=(0,In.createConnection)(In.ProposedFeatures.all);else throw Error(`No transport specified`);u({lspConnection:t,useStdErr:e.stdio===!0,colors:S.isColorSupported,enableTelemetry:e.telemetry,logLevel:e.verbose?sn:e.logLevel}),f({connection:t,enableManualLayouts:e.manualLayouts,enableWatcher:e.watch,graphviz:e.useDot?`binary`:`wasm`,configureLogger:!1})}})}t(lsp_default,`default`);const Z=r.getChild(`mcp`);function likec4Tool(e,t){let{name:n,description:r,...i}=e;return e=>[n,{description:r?.trim()??``,...i},mkcallTool(n,e,t)]}function mkcallTool(e,t,n){let r=n.bind(null,t);return(async function callTool(t,n){Z.debug(`Calling tool {name}, args: {args}`,{name:e,args:t});try{let e=await r.call(null,t,n);return typeof e==`string`?{content:[{type:`text`,text:e}]}:{content:[{type:`text`,text:JSON.stringify(e)}],structuredContent:e}}catch(t){return Z.error(`Tool ${e} failed`,{err:t}),{content:[{type:`text`,text:a(t)}],isError:!0}}})}var Ln=`1.56.0`;const Rn=A({name:L().describe(`Project identifier`),title:L().optional().describe(`Human-readable project title`),contactPerson:L().optional().describe(`Maintainer contact information`),metadata:M(L(),Fe()).optional().describe(`Custom project metadata as key-value pairs`),extends:j([L(),N(L())]).optional().describe(`Style inheritance paths`),exclude:N(L()).optional().describe(`File exclusion patterns`),include:A({paths:N(L()).describe(`Include paths`),maxDepth:I().describe(`Maximum directory depth`),fileThreshold:I().describe(`File threshold`)}).optional().describe(`Include configuration`),manualLayouts:A({outDir:L().describe(`Output directory for manual layouts`)}).optional().describe(`Manual layouts configuration`),styles:A({hasTheme:F().describe(`Whether theme customization is defined`),hasDefaults:F().describe(`Whether default style values are defined`),hasCustomCss:F().describe(`Whether custom CSS is defined`)}).optional().describe(`Simplified styles configuration (boolean flags)`)});function serializeConfig(e){let t={name:e.name};return e.title!=null&&(t.title=e.title),e.contactPerson!=null&&(t.contactPerson=e.contactPerson),e.metadata&&(t.metadata=e.metadata),e.extends&&(t.extends=e.extends),e.exclude&&(t.exclude=e.exclude),e.include&&(t.include={paths:e.include.paths||[],maxDepth:e.include.maxDepth??3,fileThreshold:e.include.fileThreshold??30}),e.manualLayouts&&(t.manualLayouts={outDir:e.manualLayouts.outDir??`.likec4`}),e.styles&&(t.styles={hasTheme:!!e.styles.theme,hasDefaults:!!e.styles.defaults,hasCustomCss:!!e.styles.customCss}),t}const Q=A({id:L().describe(`Element id (FQN)`),name:L().describe(`Element name`),kind:L().describe(`Element kind`),title:L(),tags:N(L()),metadata:M(j([L(),N(L())])),includedInViews:N(A({id:L().describe(`View id`),title:L().describe(`View title`),type:k([`element`,`deployment`,`dynamic`]).describe(`View type`)})).describe(`Views that include this element`)});function serializeElement(e){return{id:e.id,name:e.name,kind:e.kind,title:e.title,tags:[...e.tags],metadata:e.getMetadata(),includedInViews:includedInViews(e.views())}}function traverseGraph(e,t,n,r,i,a){R(e.findElement(t),`Element "${t}" not found`);let s=new Set,c={},l=0,u=!1,f=[{elementId:t,depth:0}];for(;f.length>0;){let{elementId:t,depth:p}=f.shift();if(p>i||s.has(t))continue;if(s.size>=a){u=!0;break}let m=e.findElement(t);if(!m)continue;s.add(t),l=Math.max(l,p);let h=(n===`incoming`?[...m.incoming(r)]:[...m.outgoing(r)]).map(e=>{let t={elementId:n===`incoming`?e.source.id:e.target.id};return e.title&&(t.relationshipLabel=e.title),e.technology&&(t.technology=e.technology),t});c[t]={...serializeElement(m),neighbors:h,depth:p};for(let e of h)s.has(e.elementId)||f.push({elementId:e.elementId,depth:p+1})}for(let e of Object.values(c))e.neighbors=e.neighbors.filter(e=>e.elementId in c);return{target:t,totalNodes:s.size,maxDepth:l,truncated:u,nodes:c}}const zn=A({path:L().describe(`Path to the file`),range:A({start:A({line:I(),character:I()}),end:A({line:I(),character:I()})}).describe(`Range in the file`)}).nullable(),$=L().refine(e=>!0).optional().default(`default`).describe(`Project id (optional, will use "default" if not specified)`),Bn=N(A({id:L().describe(`View id`),title:L().describe(`View title`),type:k([`element`,`deployment`,`dynamic`]).describe(`View type`)})),includedInViews=e=>[...e].map(e=>({id:e.id,title:e.titleOrId,type:e.$view._type})),mkLocate=(e,t)=>n=>{try{let r=e.locate({projectId:t,...n});return r?{path:g.parse(r.uri).fsPath,range:r.range}:null}catch(e){return Z.debug(`Failed to locate {params}`,{error:e,params:n}),null}},Vn=Q.extend({description:L().nullable().describe(`Element description`),technology:L().nullable().describe(`Element technology`),shape:L().describe(`Rendered shape`),color:L().describe(`Rendered color`),children:N(L()).describe(`Direct child element ids`),incomingCount:I().describe(`Number of incoming relationships`),outgoingCount:I().describe(`Number of outgoing relationships`)}),Hn=likec4Tool({name:`batch-read-elements`,description:`
|
|
162
301
|
Read details of multiple elements in a single call, reducing round-trips.
|
|
163
302
|
Returns a compact summary for each element including metadata, description, technology, shape, children, and relationship counts.
|
|
164
303
|
|
|
@@ -220,7 +359,7 @@ Example response:
|
|
|
220
359
|
],
|
|
221
360
|
"notFound": []
|
|
222
361
|
}
|
|
223
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Batch read elements`},inputSchema:{ids:
|
|
362
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Batch read elements`},inputSchema:{ids:N(L()).min(1).max(50).describe(`Array of element ids (FQNs) to read (max 50)`),project:$},outputSchema:{elements:N(Vn),notFound:N(L()).describe(`Element ids that were not found`)}},async(e,t)=>{R(t.ids.length<=50,`Maximum 50 element ids per call`);let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=[],a=[];for(let e of t.ids){let t=r.findElement(e);if(!t){a.push(e);continue}i.push({...serializeElement(t),description:t.description.text,technology:t.technology,shape:t.shape,color:t.color,children:[...t.children()].map(e=>e.id),incomingCount:t.allIncoming.size,outgoingCount:t.allOutgoing.size})}return{elements:i,notFound:a}}),Un=A({id:L(),kind:L(),title:L(),description:L().nullable(),technology:L().nullable(),shape:L(),color:L()}),Wn=A({element1:Un,element2:Un,propertyDiffs:N(A({property:L().describe(`Property name`),element1Value:L().nullable().describe(`Value in element1`),element2Value:L().nullable().describe(`Value in element2`)})).describe(`Properties that differ between the two elements`),tags:A({onlyInElement1:N(L()).describe(`Tags present only in element1`),onlyInElement2:N(L()).describe(`Tags present only in element2`),common:N(L()).describe(`Tags present in both elements`)}),metadata:A({onlyInElement1:M(j([L(),N(L())])).describe(`Metadata keys only in element1`),onlyInElement2:M(j([L(),N(L())])).describe(`Metadata keys only in element2`),different:N(A({key:L(),element1Value:j([L(),N(L())]),element2Value:j([L(),N(L())])})).describe(`Metadata keys present in both but with different values`),common:M(j([L(),N(L())])).describe(`Metadata keys with identical values in both`)}),relationships:A({incomingOnlyElement1:I().describe(`Count of unique source elements sending to element1 only`),incomingOnlyElement2:I().describe(`Count of unique source elements sending to element2 only`),incomingShared:I().describe(`Count of unique source elements sending to both`),outgoingOnlyElement1:I().describe(`Count of unique target elements receiving from element1 only`),outgoingOnlyElement2:I().describe(`Count of unique target elements receiving from element2 only`),outgoingShared:I().describe(`Count of unique target elements receiving from both`)})}),Gn=likec4Tool({name:`element-diff`,description:`
|
|
224
363
|
Compare two elements side-by-side, showing differences in properties, tags, metadata, and relationships.
|
|
225
364
|
|
|
226
365
|
Request:
|
|
@@ -280,7 +419,7 @@ Example response:
|
|
|
280
419
|
"outgoingShared": 2
|
|
281
420
|
}
|
|
282
421
|
}
|
|
283
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Compare two elements`},inputSchema:{element1Id:
|
|
422
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Compare two elements`},inputSchema:{element1Id:L().describe(`First element id (FQN)`),element2Id:L().describe(`Second element id (FQN)`),project:$},outputSchema:Wn.shape},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=r.findElement(t.element1Id);R(i,`Element "${t.element1Id}" not found in project "${n}"`);let a=r.findElement(t.element2Id);R(a,`Element "${t.element2Id}" not found in project "${n}"`);let s=[],c=[{name:`kind`,get:e=>e.kind},{name:`title`,get:e=>e.title},{name:`description`,get:e=>e.description.text},{name:`technology`,get:e=>e.technology},{name:`shape`,get:e=>e.shape},{name:`color`,get:e=>e.color}];for(let e of c){let t=e.get(i),n=e.get(a);t!==n&&s.push({property:e.name,element1Value:t,element2Value:n})}let l=new Set(i.tags),u=new Set(a.tags),f=[],p=[],m=[];for(let e of l)u.has(e)?f.push(e):p.push(e);for(let e of u)l.has(e)||m.push(e);let h=i.getMetadata(),g=a.getMetadata(),_=new Set([...Object.keys(h),...Object.keys(g)]),v={},y={},b=[],x={};for(let e of _){let t=h[e],n=g[e];t!==void 0&&n===void 0?v[e]=t:t===void 0&&n!==void 0?y[e]=n:t!==void 0&&n!==void 0&&(JSON.stringify(t)===JSON.stringify(n)?x[e]=t:b.push({key:e,element1Value:t,element2Value:n}))}let ee=new Set([...i.incoming()].map(e=>e.source.id)),S=new Set([...a.incoming()].map(e=>e.source.id)),C=new Set([...i.outgoing()].map(e=>e.target.id)),te=new Set([...a.outgoing()].map(e=>e.target.id)),ne=0,w=0,T=0;for(let e of ee)S.has(e)?ne++:w++;for(let e of S)ee.has(e)||T++;let E=0,re=0,ie=0;for(let e of C)te.has(e)?E++:re++;for(let e of te)C.has(e)||ie++;return{element1:{id:i.id,kind:i.kind,title:i.title,description:i.description.text,technology:i.technology,shape:i.shape,color:i.color},element2:{id:a.id,kind:a.kind,title:a.title,description:a.description.text,technology:a.technology,shape:a.shape,color:a.color},propertyDiffs:s,tags:{onlyInElement1:p,onlyInElement2:m,common:f},metadata:{onlyInElement1:v,onlyInElement2:y,different:b,common:x},relationships:{incomingOnlyElement1:w,incomingOnlyElement2:T,incomingShared:ne,outgoingOnlyElement1:re,outgoingOnlyElement2:ie,outgoingShared:E}}}),Kn=likec4Tool({name:`find-relationship-paths`,description:`
|
|
284
423
|
Discover all paths (chains of relationships) between two elements, supporting multi-hop traversal.
|
|
285
424
|
|
|
286
425
|
Request:
|
|
@@ -369,7 +508,7 @@ Example response:
|
|
|
369
508
|
}
|
|
370
509
|
]
|
|
371
510
|
}
|
|
372
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Find relationship paths`},inputSchema:{sourceId:
|
|
511
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Find relationship paths`},inputSchema:{sourceId:L().describe(`Source element FQN`),targetId:L().describe(`Target element FQN`),maxDepth:I().int().min(1).max(5).optional().default(3).describe(`Maximum path length (default: 3, max: 5)`),includeIndirect:F().optional().default(!1).describe(`Include indirect (implied) relationships through nested elements (default: false)`),project:$},outputSchema:{paths:N(A({length:I().describe(`Number of hops in the path`),steps:N(A({source:L().describe(`Source element FQN`),target:L().describe(`Target element FQN`),relationship:A({kind:L().nullable().describe(`Relationship kind`),title:L().nullable().describe(`Relationship title`),description:L().nullable().describe(`Relationship description`),technology:L().nullable().describe(`Relationship technology`),tags:N(L()).describe(`Relationship tags`)})})).describe(`Ordered sequence of relationships in the path`)}))}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=r.findElement(t.sourceId);R(i,`Source element "${t.sourceId}" not found in project "${n}"`);let a=r.findElement(t.targetId);R(a,`Target element "${t.targetId}" not found in project "${n}"`),R(i.id!==a.id,`Source and target must be different elements`);let s=t.maxDepth,c=t.includeIndirect?`all`:`direct`,l=[{elementId:i.id,path:[],visited:new Set([i.id])}],u=[];for(;l.length>0&&u.length<100;){let e=l.shift();if(e.path.length>=s)continue;let t=r.findElement(e.elementId);if(t)for(let n of t.outgoing(c)){let t=n.target.id;if(t===a.id){let t={source:n.source.id,target:n.target.id,relationship:{kind:n.kind,title:n.title,description:n.description.text,technology:n.technology,tags:[...n.tags]}};if(u.push({length:e.path.length+1,steps:[...e.path,t]}),u.length>=100)break;continue}if(e.visited.has(t))continue;let r={source:n.source.id,target:n.target.id,relationship:{kind:n.kind,title:n.title,description:n.description.text,technology:n.technology,tags:[...n.tags]}};l.push({elementId:t,path:[...e.path,r],visited:new Set([...e.visited,t])})}}return u.sort((e,t)=>e.length-t.length),{paths:u}}),qn=A({id:L(),title:L(),kind:L()}),Jn=A({type:k([`direct`,`indirect`]).describe(`Type of relationship, "direct" for direct relationships, "indirect" for relationships through nested elements`),source:qn,target:qn,kind:L().nullable().describe(`Relationship kind`),title:L().nullable().describe(`Relationship title`),description:L().nullable().describe(`Relationship description`),technology:L().nullable().describe(`Relationship technology`),tags:N(L()).describe(`Relationship tags`),includedInViews:Bn.describe(`Views that include this relationship`),sourceLocation:zn}),Yn=likec4Tool({name:`find-relationships`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Find relationships between two elements`},description:`
|
|
373
512
|
Find relationships between two LikeC4 elements within a project.
|
|
374
513
|
|
|
375
514
|
What it does:
|
|
@@ -440,7 +579,7 @@ Response:
|
|
|
440
579
|
}
|
|
441
580
|
]
|
|
442
581
|
}
|
|
443
|
-
`,inputSchema:{element1:
|
|
582
|
+
`,inputSchema:{element1:L().describe(`Element ID (FQN)`),element2:L().describe(`Element ID (FQN)`),project:$},outputSchema:{found:N(Jn)}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project);if(et(t.element1,t.element2))throw Error(`No relationships possible between parent-child`);let r=[],i=await e.computedModel(n),a=i.findElement(t.element1);$e(a,`Element "${t.element1}" not found in project "${n}"`);let s=i.findElement(t.element2);$e(s,`Element "${t.element2}" not found in project "${n}"`);let c=mkLocate(e,n),l=ct.findConnection(a,s,`both`).flatMap(e=>[...e.relations]);for(let e of l){let t=e.source===a&&e.target===s||e.source===s&&e.target===a;r.push({type:t?`direct`:`indirect`,source:{id:e.source.id,title:e.source.title,kind:e.source.kind},target:{id:e.target.id,title:e.target.title,kind:e.target.kind},kind:e.kind,title:e.title,description:e.description.text,technology:e.technology,tags:[...e.tags],includedInViews:includedInViews(e.views()),sourceLocation:c({relation:e.id})})}return{found:r}}),Xn=likec4Tool({name:`list-projects`,description:`
|
|
444
583
|
List LikeC4 projects discoverable in the current workspace.
|
|
445
584
|
|
|
446
585
|
Request:
|
|
@@ -473,7 +612,7 @@ Example response:
|
|
|
473
612
|
}
|
|
474
613
|
]
|
|
475
614
|
}
|
|
476
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`List projects`},outputSchema:{projects:
|
|
615
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`List projects`},outputSchema:{projects:N(A({id:L(),title:L(),folder:L(),sources:N(L())}))}},async e=>({projects:e.projects().map(e=>({id:e.id,title:e.title,folder:e.folder.fsPath,sources:e.documents.map(e=>e.fsPath)}))})),Zn=k([`exact`,`contains`,`exists`]),Qn=likec4Tool({name:`query-by-metadata`,description:`
|
|
477
616
|
Search elements and deployment nodes by metadata key-value pairs with flexible matching modes.
|
|
478
617
|
|
|
479
618
|
Request:
|
|
@@ -539,7 +678,7 @@ Example response:
|
|
|
539
678
|
}
|
|
540
679
|
]
|
|
541
680
|
}
|
|
542
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query by metadata`},inputSchema:{key:
|
|
681
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query by metadata`},inputSchema:{key:L().describe(`Metadata key to filter by`),value:L().optional().describe(`Metadata value to match (ignored for exists mode)`),matchMode:Zn.optional().default(`exact`).describe(`Matching mode`),project:$},outputSchema:{results:N(Q.extend({matchedValue:L().describe(`The metadata value that matched`)}))}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=t.matchMode,a=[],matches=(e,t,n)=>{let r=Array.isArray(e)?e:[e];switch(n){case`exists`:return!0;case`exact`:return t===void 0?!1:r.some(e=>e===t);case`contains`:{if(t===void 0)return!1;let e=t.toLowerCase();return r.some(t=>t.toLowerCase().includes(e))}default:return!1}},getMatchedValue=(e,t,n)=>{let r=Array.isArray(e)?e:[e];if(n===`exists`||t===void 0)return r[0]||``;if(n===`exact`)return r.find(e=>e===t)||r[0]||``;if(n===`contains`){let e=t.toLowerCase();return r.find(t=>t.toLowerCase().includes(e))||r[0]||``}return r[0]||``};for(let e of r.elements()){if(a.length>=50)break;let n=e.getMetadata();if(t.key in n){let r=n[t.key];r!==void 0&&matches(r,t.value,i)&&a.push({...serializeElement(e),matchedValue:getMatchedValue(r,t.value,i)})}}if(a.length<50)for(let e of r.deployment.elements()){if(a.length>=50)break;let n=e.getMetadata();if(t.key in n){let r=n[t.key];r!==void 0&&matches(r,t.value,i)&&a.push({...serializeElement(e),matchedValue:getMatchedValue(r,t.value,i)})}}return{results:a}}),$n=likec4Tool({name:`query-by-tag-pattern`,description:`
|
|
543
682
|
Search elements by tag patterns using prefix or substring matching.
|
|
544
683
|
Useful for tag taxonomies with structured naming conventions (e.g., "schedule_*", "*_asil_*").
|
|
545
684
|
|
|
@@ -594,7 +733,7 @@ Example response:
|
|
|
594
733
|
"truncated": false,
|
|
595
734
|
"matchedTagValues": ["target_asil_qm", "target_asil_asil_b", "target_asil_qm__tbc"]
|
|
596
735
|
}
|
|
597
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query by tag pattern`},inputSchema:{pattern:
|
|
736
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query by tag pattern`},inputSchema:{pattern:L().min(1).describe(`Tag pattern to match`),matchMode:k([`prefix`,`contains`,`suffix`]).optional().default(`prefix`).describe(`Pattern matching mode (default: prefix)`),project:$},outputSchema:{results:N(Q.extend({matchedTags:N(L()).describe(`Tags that matched the pattern`)})),truncated:F().describe(`True if results were truncated`),matchedTagValues:N(L()).describe(`All unique tag values matching the pattern across all elements`)}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=t.pattern.toLowerCase(),matchesTag=e=>{let n=e.toLowerCase();switch(t.matchMode){case`prefix`:return n.startsWith(i);case`contains`:return n.includes(i);case`suffix`:return n.endsWith(i)}},a=[],s=!1,c=new Set;for(let e of r.elements()){let t=[...e.tags].filter(matchesTag);if(t.length>0){if(t.forEach(e=>c.add(e)),a.length>=50){s=!0;continue}a.push({...serializeElement(e),matchedTags:t})}}for(let e of r.deployment.elements()){if(!rt(e))continue;let t=[...e.tags].filter(matchesTag);if(t.length>0){if(t.forEach(e=>c.add(e)),a.length>=50){s=!0;continue}a.push({...serializeElement(e),matchedTags:t})}}return{results:a,truncated:s,matchedTagValues:[...c].sort((e,t)=>e.localeCompare(t))}}),er=likec4Tool({name:`query-by-tags`,description:`
|
|
598
737
|
Advanced tag filtering with boolean logic (AND, OR, NOT).
|
|
599
738
|
|
|
600
739
|
Request:
|
|
@@ -658,7 +797,7 @@ Example response:
|
|
|
658
797
|
}
|
|
659
798
|
]
|
|
660
799
|
}
|
|
661
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query by tags`},inputSchema:{allOf:
|
|
800
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query by tags`},inputSchema:{allOf:N(L()).optional().describe(`Element must have ALL these tags (AND)`),anyOf:N(L()).optional().describe(`Element must have ANY of these tags (OR)`),noneOf:N(L()).optional().describe(`Element must have NONE of these tags (NOT)`),project:$},outputSchema:{results:N(Q),truncated:F().describe(`True if results were truncated due to exceeding the 50-result limit`)}},async(e,t)=>{R(t.allOf&&t.allOf.length>0||t.anyOf&&t.anyOf.length>0||t.noneOf&&t.noneOf.length>0,`At least one condition (allOf, anyOf, or noneOf) must be specified with at least one tag`);let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n),i=[],a=!1,matchesTags=e=>{let n=e instanceof Set?e:new Set(e);return!(t.allOf&&t.allOf.length>0&&!t.allOf.every(e=>n.has(e))||t.anyOf&&t.anyOf.length>0&&!t.anyOf.some(e=>n.has(e))||t.noneOf&&t.noneOf.length>0&&t.noneOf.some(e=>n.has(e)))};for(let e of r.elements()){if(i.length>=50){a=!0;break}matchesTags(e.tags)&&i.push(serializeElement(e))}if(!a)for(let e of r.deployment.elements()){if(i.length>=50){a=!0;break}rt(e)&&matchesTags(e.tags)&&i.push(serializeElement(e))}return{results:i,truncated:a}}),tr=k([`ancestors`,`descendants`,`siblings`,`children`,`parent`,`incomers`,`outgoers`]),nr=likec4Tool({name:`query-graph`,description:`
|
|
662
801
|
Query element hierarchy and relationships in the architecture graph.
|
|
663
802
|
|
|
664
803
|
Request:
|
|
@@ -730,7 +869,7 @@ Example response:
|
|
|
730
869
|
],
|
|
731
870
|
"truncated": false
|
|
732
871
|
}
|
|
733
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query element graph`},inputSchema:{elementId:
|
|
872
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query element graph`},inputSchema:{elementId:L().describe(`Element id (FQN) to query`),queryType:tr.describe(`Type of graph query`),includeIndirect:F().optional().default(!0).describe(`For incomers/outgoers: include indirect relationships (default: true)`),project:$},outputSchema:{results:N(Q),truncated:F().describe(`True if results were truncated due to exceeding maximum limit`)}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=(await e.computedModel(n)).findElement(t.elementId);R(r,`Element "${t.elementId}" not found in project "${n}"`);let i=[],a=!1;switch(t.queryType){case`ancestors`:for(let e of r.ancestors()){if(i.length>=100){a=!0;break}i.push(serializeElement(e))}break;case`descendants`:for(let e of r.descendants()){if(i.length>=100){a=!0;break}i.push(serializeElement(e))}break;case`siblings`:for(let e of r.siblings()){if(i.length>=100){a=!0;break}i.push(serializeElement(e))}break;case`children`:for(let e of r.children()){if(i.length>=100){a=!0;break}i.push(serializeElement(e))}break;case`parent`:{let e=r.parent;e&&i.push(serializeElement(e));break}case`incomers`:{let e=t.includeIndirect?`all`:`direct`;for(let t of r.incomers(e)){if(i.length>=100){a=!0;break}i.push(serializeElement(t))}break}case`outgoers`:{let e=t.includeIndirect?`all`:`direct`;for(let t of r.outgoers(e)){if(i.length>=100){a=!0;break}i.push(serializeElement(t))}break}}return{results:i,truncated:a}}),rr=A({elementId:L().describe(`ID of the incoming element`),relationshipLabel:L().optional().describe(`Label on the relationship`),technology:L().optional().describe(`Technology specified on the relationship`)}),ir=likec4Tool({name:`query-incomers-graph`,description:`
|
|
734
873
|
Query the complete graph of all elements that provide input to the target element (recursive incomers/producers).
|
|
735
874
|
|
|
736
875
|
This tool performs a breadth-first traversal to discover all upstream dependencies - elements that directly or
|
|
@@ -787,7 +926,7 @@ Notes:
|
|
|
787
926
|
Example:
|
|
788
927
|
For a database element, this returns all services, APIs, and components that write to it,
|
|
789
928
|
plus all their dependencies, recursively up to maxDepth levels.
|
|
790
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query complete incomers graph`},inputSchema:{elementId:
|
|
929
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query complete incomers graph`},inputSchema:{elementId:L().describe(`Target element id (FQN) to query incomers for`),includeIndirect:F().optional().default(!0).describe(`Include indirect relationships through nested elements (default: true)`),maxDepth:I().int().positive().max(50).optional().default(10).describe(`Maximum traversal depth (default: 10, max: 50)`),maxNodes:I().int().positive().max(2e3).optional().default(200).describe(`Maximum number of nodes to return (default: 200, max: 2000)`),project:$},outputSchema:{target:L().describe(`Target element id`),totalNodes:I().describe(`Total number of nodes in the graph`),maxDepth:I().describe(`Maximum depth reached`),truncated:F().describe(`True if result was truncated due to maxNodes limit`),nodes:M(Q.extend({incomers:N(rr).describe(`Incoming relationships with details`),depth:I().describe(`Distance from target element (0 = target)`)}))}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n);R(r.findElement(t.elementId),`Element "${t.elementId}" not found in project "${n}"`);let i=t.includeIndirect?`all`:`direct`,a=traverseGraph(r,t.elementId,`incoming`,i,t.maxDepth,t.maxNodes),s={};for(let[e,t]of Object.entries(a.nodes)){let{neighbors:n,...r}=t;s[e]={...r,incomers:n}}return{target:a.target,totalNodes:a.totalNodes,maxDepth:a.maxDepth,truncated:a.truncated,nodes:s}}),ar=A({elementId:L().describe(`ID of the outgoing element`),relationshipLabel:L().optional().describe(`Label on the relationship`),technology:L().optional().describe(`Technology specified on the relationship`)}),or=likec4Tool({name:`query-outgoers-graph`,description:`
|
|
791
930
|
Query the complete graph of all elements that receive output from the target element (recursive outgoers/consumers).
|
|
792
931
|
|
|
793
932
|
This tool performs a breadth-first traversal to discover all downstream dependencies - elements that directly or
|
|
@@ -844,7 +983,7 @@ Notes:
|
|
|
844
983
|
Example:
|
|
845
984
|
For an API service, this returns all clients, services, and systems that consume its output,
|
|
846
985
|
plus all their consumers, recursively up to maxDepth levels.
|
|
847
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query complete outgoers graph`},inputSchema:{elementId:
|
|
986
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Query complete outgoers graph`},inputSchema:{elementId:L().describe(`Target element id (FQN) to query outgoers for`),includeIndirect:F().optional().default(!0).describe(`Include indirect relationships through nested elements (default: true)`),maxDepth:I().int().positive().max(50).optional().default(10).describe(`Maximum traversal depth (default: 10, max: 50)`),maxNodes:I().int().positive().max(2e3).optional().default(200).describe(`Maximum number of nodes to return (default: 200, max: 2000)`),project:$},outputSchema:{target:L().describe(`Target element id`),totalNodes:I().describe(`Total number of nodes in the graph`),maxDepth:I().describe(`Maximum depth reached`),truncated:F().describe(`True if result was truncated due to maxNodes limit`),nodes:M(Q.extend({outgoers:N(ar).describe(`Outgoing relationships with details`),depth:I().describe(`Distance from target element (0 = target)`)}))}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=await e.computedModel(n);R(r.findElement(t.elementId),`Element "${t.elementId}" not found in project "${n}"`);let i=t.includeIndirect?`all`:`direct`,a=traverseGraph(r,t.elementId,`outgoing`,i,t.maxDepth,t.maxNodes),s={};for(let[e,t]of Object.entries(a.nodes)){let{neighbors:n,...r}=t;s[e]={...r,outgoers:n}}return{target:a.target,totalNodes:a.totalNodes,maxDepth:a.maxDepth,truncated:a.truncated,nodes:s}}),sr=likec4Tool({name:`read-deployment`,description:`
|
|
848
987
|
Read details about a deployment node or a deployed instance in a LikeC4 project.
|
|
849
988
|
|
|
850
989
|
What it does:
|
|
@@ -909,7 +1048,7 @@ Example response (deployed instance):
|
|
|
909
1048
|
"range": { "start": { "line": 10, "character": 0 }, "end": { "line": 25, "character": 0 } }
|
|
910
1049
|
}
|
|
911
1050
|
}
|
|
912
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Read deployment entity`},inputSchema:{id:
|
|
1051
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Read deployment entity`},inputSchema:{id:L().describe(`Deployment id (FQN)`),project:$},outputSchema:{type:k([`deployment-node`,`deployed-instance`]),id:L().describe(`Deployment id (FQN)`),kind:L().describe(`Deployment node kind, or element kind for deployed instances`),name:L(),title:L(),description:L().nullable(),technology:L().nullable(),tags:N(L()),project:L(),metadata:M(j([L(),N(L())])),links:N(A({title:L().nullable().describe(`Optional link title`),url:L().describe(`Link URL`),relative:L().nullable().describe(`Relative path (if URL is relative to workspace root)`)})).describe(`External links associated with this deployment entity`),shape:L(),color:L(),children:N(L()).describe(`Children of this deployment node (Array of Deployment ids)`),includedInViews:Bn.describe(`Views that include this deployment node`),instanceof:A({id:L().describe(`Element ID (FQN)`),title:L(),kind:L()}).nullable().describe(`If type is "deployed-instance", the referenced element`),sourceLocation:zn}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=(await e.computedModel(n)).deployment.findElement(t.id);R(r,`Deployment entity "${t.id}" not found in project "${n}"`);let i=mkLocate(e,n);return{type:r.isInstance()?`deployed-instance`:`deployment-node`,id:r.id,name:r.name,kind:r.kind,title:r.title,description:r.description.text,technology:r.technology,tags:[...r.tags],project:n,metadata:r.getMetadata(),links:(r.links??[]).map(e=>({title:e.title??null,url:e.url,relative:e.relative??null})),shape:r.shape,color:r.color,children:r.isInstance()?[]:[...r.children()].map(e=>e.id),includedInViews:includedInViews(r.views()),instanceof:r.isInstance()?{id:r.element.id,title:r.element.title,kind:r.element.kind}:null,sourceLocation:i({deployment:r.id})}}),cr=likec4Tool({name:`read-element`,description:`
|
|
913
1052
|
Read detailed information about a LikeC4 element.
|
|
914
1053
|
|
|
915
1054
|
Request:
|
|
@@ -996,7 +1135,7 @@ Example response:
|
|
|
996
1135
|
"range": { "start": { "line": 10, "character": 0 }, "end": { "line": 25, "character": 0 } }
|
|
997
1136
|
}
|
|
998
1137
|
}
|
|
999
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Read element`},inputSchema:{id:
|
|
1138
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Read element`},inputSchema:{id:L().describe(`Element id (FQN)`),project:$},outputSchema:{id:L().describe(`Element id (FQN)`),kind:L().describe(`Element kind`),name:L().describe(`Element name`),title:L(),description:L().nullable(),technology:L().nullable(),tags:N(L()),project:L(),metadata:M(j([L(),N(L())])),links:N(A({title:L().nullable().describe(`Optional link title`),url:L().describe(`Link URL`),relative:L().nullable().describe(`Relative path (if URL is relative to workspace root)`)})).describe(`External links associated with this element`),shape:L(),color:L(),children:N(L()).describe(`Children of this element (Array of FQNs)`),defaultView:L().nullable().describe(`Name of the default view of this element`),includedInViews:Bn.describe(`Views that include this element`),relationships:A({incoming:N(A({source:A({id:L(),title:L(),kind:L()}).describe(`Source element of this relationship`),kind:L().nullable().describe(`Relationship kind`),target:L().describe(`Target element id (FQN), either this element or nested element, if relationship is indirect`),title:L().nullable().describe(`Relationship title`),description:L().nullable().describe(`Relationship description`),technology:L().nullable().describe(`Relationship technology`),tags:N(L()).describe(`Relationship tags`)})).describe(`Incoming relationships of this element (direct and indirect, incoming to nested elements)`),outgoing:N(A({source:L().describe(`Source element id (FQN), either this element or nested element, if relationship is indirect`),target:A({id:L(),title:L(),kind:L()}).describe(`Target element of this relationship`),kind:L().nullable().describe(`Relationship kind`),title:L().nullable().describe(`Relationship title`),description:L().nullable().describe(`Relationship description`),technology:L().nullable().describe(`Relationship technology`),tags:N(L()).describe(`Relationship tags`)})).describe(`Outgoing relationships of this element (direct and indirect, outgoing from nested elements)`)}).describe(`Relationships of this element`),deployedInstances:N(L()).describe(`Deployed instances of this element (Array of Deployment FQNs)`),sourceLocation:zn}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=(await e.computedModel(n)).findElement(t.id);R(r,`Element "${t.id}" not found in project "${n}"`);let i=mkLocate(e,n);return{id:r.id,name:r.name,kind:r.kind,title:r.title,description:r.description.text,technology:r.technology,tags:[...r.tags],project:n,metadata:r.getMetadata(),links:(r.links??[]).map(e=>({title:e.title??null,url:e.url,relative:e.relative??null})),shape:r.shape,color:r.color,children:[...r.children()].map(e=>e.id),defaultView:r.defaultView?.id||null,includedInViews:includedInViews(r.views()),relationships:{incoming:[...r.incoming()].map(e=>({source:{id:e.source.id,title:e.source.title,kind:e.source.kind},kind:e.kind,target:e.target.id,title:e.title,description:e.description.text,technology:e.technology,tags:[...e.tags]})),outgoing:[...r.outgoing()].map(e=>({source:e.source.id,target:{id:e.target.id,title:e.target.title,kind:e.target.kind},kind:e.kind,title:e.title,description:e.description.text,technology:e.technology,tags:[...e.tags]}))},deployedInstances:[...r.deployments()].map(e=>e.id),sourceLocation:i({element:r.id})}}),lr=likec4Tool({name:`read-project-summary`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Read project summary`},description:`
|
|
1000
1139
|
Request:
|
|
1001
1140
|
- project: string (optional) — project id. Defaults to "default" if omitted.
|
|
1002
1141
|
|
|
@@ -1087,7 +1226,7 @@ Example response:
|
|
|
1087
1226
|
}
|
|
1088
1227
|
]
|
|
1089
1228
|
}
|
|
1090
|
-
`,inputSchema:{project:$},outputSchema:{title:
|
|
1229
|
+
`,inputSchema:{project:$},outputSchema:{title:L(),folder:L(),sources:N(L()),config:Rn.describe(`Project configuration`),specification:A({elementKinds:N(L()),relationshipKinds:N(L()),deploymentKinds:N(L()),tags:N(L()),metadataKeys:N(L())}),elements:N(A({id:L(),kind:L(),title:L(),tags:N(L())})).describe(`List of elements in the project`),deployments:N(Ie(`type`,[A({type:P(`deployment-node`),id:L().describe(`Node ID`),kind:L().describe(`Deployment node kind`),title:L().describe(`Node title`),tags:N(L())}),A({type:P(`deployed-instance`),id:L().describe(`Node ID`),title:L().describe(`Node title`),tags:N(L()),referencedElementId:L().describe(`Element ID (FQN)`)})])).describe(`List of deployment nodes and deployed instances in the project`),views:N(A({id:L(),title:L(),type:k([`element`,`deployment`,`dynamic`])}))}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=e.project(n),i=await e.computedModel(n);return{title:r.title,folder:r.folder.fsPath,sources:r.documents?.map(e=>e.fsPath)??[],config:serializeConfig(r.config),specification:{elementKinds:D(i.specification.elements),relationshipKinds:D(i.specification.relationships),deploymentKinds:D(i.specification.deployments),tags:[...i.tags],metadataKeys:i.specification.metadataKeys??[]},elements:[...i.elements()].filter(e=>!e.imported).map(e=>({id:e.id,kind:e.kind,title:e.title,tags:[...e.tags]})),deployments:[...i.deployment.elements()].map(e=>e.isInstance()?{type:`deployed-instance`,id:e.id,title:e.title,tags:[...e.tags],referencedElementId:e.element.id}:{type:`deployment-node`,id:e.id,kind:e.kind,title:e.title,tags:[...e.tags]}),views:[...i.views()].map(e=>({id:e.id,title:e.titleOrId,type:e.$view._type}))}}),modelRef=e=>e.hasElement()?e.element.id:e.hasDeployment()?e.deployment.id:null,ur=Ie(`type`,[A({type:P(`element`),id:L().describe(`Node ID`),elementId:L().describe(`Element ID (FQN)`),kind:L().describe(`Element kind`),title:L().describe(`Node title`),description:L().nullable(),technology:L().nullable(),children:N(L()).describe(`Children nodes, array of node IDs`),shape:L().describe(`Rendered shape`),color:L().describe(`Rendered color`),tags:N(L())}),A({type:P(`deployment-node`),id:L().describe(`Node ID`),deploymentId:L().describe(`Deployment entity ID (FQN)`),kind:L().describe(`Deployment kind`),title:L().describe(`Node title`),description:L().nullable(),technology:L().nullable(),children:N(L()).describe(`Children nodes, array of node IDs`),shape:L().describe(`Rendered shape`),color:L().describe(`Rendered color`),tags:N(L())}),A({type:P(`deployed-instance`),id:L().describe(`Node ID`),deploymentId:L().describe(`Deployment entity ID (FQN)`),title:L().describe(`Node title`),description:L().nullable(),technology:L().nullable(),referencedElement:A({id:L().describe(`Element ID (FQN)`),kind:L().describe(`Element kind`),title:L().describe(`Element title`)}),shape:L().describe(`Rendered shape`),color:L().describe(`Rendered color`),tags:N(L())})]),dr=likec4Tool({name:`read-view`,description:`
|
|
1091
1230
|
Read detailed information about a LikeC4 view.
|
|
1092
1231
|
|
|
1093
1232
|
Request:
|
|
@@ -1135,7 +1274,7 @@ Example response:
|
|
|
1135
1274
|
"range": { "start": { "line": 10, "character": 0 }, "end": { "line": 30, "character": 0 } }
|
|
1136
1275
|
}
|
|
1137
1276
|
}
|
|
1138
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Read view`},inputSchema:{viewId:
|
|
1277
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Read view`},inputSchema:{viewId:L().describe(`View id (name)`),project:$},outputSchema:{id:L(),type:k([`element`,`deployment`,`dynamic`]).describe(`View type`),title:L(),description:L().nullable(),tags:N(L()),project:L(),nodes:N(ur),edges:N(A({source:L().describe(`Source node`),target:L().describe(`Target node`),label:L().nullable(),description:L().nullable(),technology:L().nullable(),tags:N(L())})).describe(`Edge represents relationship between nodes`),sourceLocation:zn}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=e.project(n),i=(await e.computedModel(n)).findView(t.viewId);if(!i)throw Error(`View with ID '${t.viewId}' not found in project ${r.id}`);let a=mkLocate(e,r.id);return{id:i.id,type:i.$view._type,title:i.title??i.id,description:i.description.text,tags:[...i.tags],project:r.id,nodes:[...i.nodes()].flatMap(e=>{let t={id:e.id,title:e.title,description:e.description.text,technology:e.technology,shape:e.shape,color:e.color,tags:[...e.tags]};return e.hasDeployedInstance()?{...t,type:`deployed-instance`,deploymentId:e.deployment.id,referencedElement:{id:e.deployment.element.id,kind:e.deployment.element.kind,title:e.deployment.element.title}}:e.hasDeployment()?{...t,type:`deployment-node`,kind:e.deployment.kind,deploymentId:e.deployment.id,children:[...e.children()].map(e=>e.id)}:e.hasElement()?{...t,type:`element`,elementId:e.element.id,kind:e.element.kind,children:[...e.children()].flatMap(e=>modelRef(e)??[])}:[]}),edges:[...i.edges()].map(e=>({source:e.source.id,target:e.target.id,label:e.label,description:e.description.text,technology:e.technology,tags:[...e.tags]})),sourceLocation:a({view:i.id})}}),fr=N(Ie(`type`,[A({type:P(`element`),project:L().describe(`Project ID`),id:L().describe(`Element ID (FQN)`),name:L().describe(`Element name`),kind:L(),title:L(),technology:L().nullable(),shape:L(),includedInViews:Bn,metadata:M(j([L(),N(L())])),tags:N(L())}),A({type:P(`deployment-node`),project:L().describe(`Project ID`),id:L().describe(`Deployment ID (FQN)`),name:L().describe(`Deployment name`),kind:L(),title:L(),technology:L().nullable(),shape:L(),includedInViews:Bn,metadata:M(j([L(),N(L())])),tags:N(L())})])),pr=likec4Tool({name:`search-element`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Search elements`},description:`
|
|
1139
1278
|
Search LikeC4 elements and deployment nodes across all projects.
|
|
1140
1279
|
|
|
1141
1280
|
Query syntax (case-insensitive):
|
|
@@ -1190,7 +1329,7 @@ Example response:
|
|
|
1190
1329
|
}
|
|
1191
1330
|
]
|
|
1192
1331
|
}
|
|
1193
|
-
`,inputSchema:{search:
|
|
1332
|
+
`,inputSchema:{search:L().min(2,`Search must be at least 2 characters long`)},outputSchema:{total:I(),found:fr}},async(e,t)=>{let n=e.projects(),r=[],i=t.search.toLowerCase(),predicate;i.startsWith(`kind:`)?(i=i.slice(5),Z.debug(`search by kind: {search}`,{search:i}),predicate=e=>e.kind.toLowerCase()===i):i.startsWith(`shape:`)?(i=i.slice(6),Z.debug(`search by shape: {search}`,{search:i}),predicate=e=>e.shape.toLowerCase()===i):i.startsWith(`meta:`)?(i=i.slice(5),Z.debug(`search by metadata: {search}`,{search:i}),predicate=e=>!!e.getMetadata(i)):i.startsWith(`#`)?(i=i.slice(1),Z.debug(`search by tag: {search}`,{search:i}),predicate=e=>e.tags.some(e=>e.toLowerCase().includes(i))):(Z.debug(`search by id/title: {search}`,{search:i}),predicate=e=>e.id.toLowerCase().includes(i)||e.title.toLowerCase().includes(i));for(let t of n)try{let n=await e.computedModel(t.id);for(let e of Qe(n.elements(),e=>!e.imported&&predicate(e)))r.push({type:`element`,project:t.id,id:e.id,name:e.name,kind:e.kind,title:e.title,technology:e.technology,shape:e.shape,tags:[...e.tags],metadata:e.getMetadata(),includedInViews:includedInViews(e.views())});for(let e of Qe(n.deployment.nodes(),predicate))r.push({type:`deployment-node`,project:t.id,id:e.id,name:e.name,kind:e.kind,title:e.title,technology:e.technology,shape:e.shape,tags:[...e.tags],metadata:e.getMetadata(),includedInViews:includedInViews(e.views())})}catch(e){Z.error(`Error searching in project ${t.id}:`,{error:e})}return{total:r.length,found:r.slice(0,20)}}),mr=A({id:L().describe(`Element id (FQN)`),name:L().describe(`Element name`),kind:L().describe(`Element kind`),title:L().describe(`Human-readable title`),depth:I().describe(`Depth relative to the root element (1 = direct child)`),tags:N(L()).describe(`Assigned tags`),metadata:M(j([L(),N(L())])).describe(`Element metadata`),childCount:I().describe(`Number of direct children`),incomingCount:I().describe(`Number of incoming relationships`),outgoingCount:I().describe(`Number of outgoing relationships`)}),hr=likec4Tool({name:`subgraph-summary`,description:`
|
|
1194
1333
|
Get a compact, table-friendly summary of all descendants of a parent element.
|
|
1195
1334
|
Returns each descendant with its depth, metadata, tags, and relationship counts in a single call.
|
|
1196
1335
|
Much more efficient than calling read-element for each descendant individually.
|
|
@@ -1256,7 +1395,7 @@ Example response:
|
|
|
1256
1395
|
"truncated": false,
|
|
1257
1396
|
"truncatedByDepth": false
|
|
1258
1397
|
}
|
|
1259
|
-
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Subgraph summary`},inputSchema:{elementId:
|
|
1398
|
+
`,annotations:{readOnlyHint:!0,idempotentHint:!0,title:`Subgraph summary`},inputSchema:{elementId:L().describe(`Parent element id (FQN) whose descendants to summarize`),maxDepth:I().int().min(1).max(20).optional().default(10).describe(`Maximum depth of descendants to include (default: 10, max: 20)`),metadataKeys:N(L()).optional().describe(`If provided, only include these metadata keys in the response`),project:$},outputSchema:{root:A({id:L(),kind:L(),title:L(),childCount:I()}),descendants:N(mr),totalDescendants:I().describe(`Total number of descendants found`),truncated:F().describe(`True if results were truncated due to exceeding the limit`),truncatedByDepth:F().describe(`True if deeper descendants exist beyond maxDepth`)}},async(e,t)=>{let n=e.projectsManager.ensureProjectId(t.project),r=(await e.computedModel(n)).findElement(t.elementId);R(r,`Element "${t.elementId}" not found in project "${n}"`);let i=t.maxDepth,a=t.metadataKeys,s=[],c=0,l=!1,u=!1,f=[],p=[...r.children()];for(let e of p)f.push({element:e,depth:1});for(;f.length>0;){let{element:e,depth:t}=f.shift();if(t>i){u=!0;continue}c++;let n=[...e.children()];if(s.length<200){let r=e.getMetadata(),i=a?Object.fromEntries(a.filter(e=>e in r).map(e=>[e,r[e]])):r;s.push({id:e.id,name:e.name,kind:e.kind,title:e.title,depth:t,tags:[...e.tags],metadata:i,childCount:n.length,incomingCount:[...e.incoming()].length,outgoingCount:[...e.outgoing()].length})}else l=!0;for(let e of n)f.push({element:e,depth:t+1})}return{root:{id:r.id,kind:r.kind,title:r.title,childCount:p.length},descendants:s,totalDescendants:c,truncated:l,truncatedByDepth:u}});function createMCPServer(e,t){let n=new Re({name:`LikeC4`,version:Ln},{instructions:`LikeC4 MCP – query and navigate LikeC4 models.
|
|
1260
1399
|
|
|
1261
1400
|
Conventions:
|
|
1262
1401
|
- All tools are read-only and idempotent.
|
|
@@ -1289,14 +1428,14 @@ Instructions:
|
|
|
1289
1428
|
- If response returns "sourceLocation", provide link to this location in the editor
|
|
1290
1429
|
|
|
1291
1430
|
Full documentation: https://likec4.dev/llms-full.txt
|
|
1292
|
-
`,enforceStrictCapabilities:!0,...t,capabilities:{tools:{},logging:{},...t?.capabilities}});return n.registerTool(...
|
|
1293
|
-
${
|
|
1294
|
-
${
|
|
1295
|
-
${
|
|
1296
|
-
${
|
|
1297
|
-
${
|
|
1298
|
-
${
|
|
1299
|
-
`),handler:async e=>{e.http||e.port?(
|
|
1431
|
+
`,enforceStrictCapabilities:!0,...t,capabilities:{tools:{},logging:{},...t?.capabilities}});return n.registerTool(...Xn(e)),n.registerTool(...lr(e)),n.registerTool(...cr(e)),n.registerTool(...sr(e)),n.registerTool(...dr(e)),n.registerTool(...pr(e)),n.registerTool(...Yn(e)),n.registerTool(...nr(e)),n.registerTool(...ir(e)),n.registerTool(...or(e)),n.registerTool(...Qn(e)),n.registerTool(...er(e)),n.registerTool(...Kn(e)),n.registerTool(...Hn(e)),n.registerTool(...$n(e)),n.registerTool(...Gn(e)),n.registerTool(...hr(e)),n.server.onerror=e=>{r.error(a(e))},n}var StdioLikeC4MCPServer=class{transport=void 0;_mcp=void 0;constructor(e){this.services=e}get mcp(){if(!this._mcp)throw Error(`MCP server is not started`);return this._mcp}get isStarted(){return this.transport!==void 0}get port(){return NaN}async dispose(){await this.stop()}async start(){this.transport||(Z.info(`Starting MCP stdio server`),this._mcp=createMCPServer(this.services),this.transport=new Le,await this._mcp.connect(this.transport),Z.info(`LikeC4 MCP Server running on stdio`))}async stop(){if(this.transport)try{Z.info(`Stopping MCP stdio server`),await this.transport.close(),this._mcp&&await this._mcp.close()}finally{this._mcp=void 0,this.transport=void 0}}};async function createHonoApp(e){let t=new Ue;t.use(`*`,ie({origin:`*`,allowHeaders:[`Content-Type`,`mcp-session-id`,`Last-Event-ID`,`mcp-protocol-version`],exposeHeaders:[`mcp-session-id`,`mcp-protocol-version`]})),t.get(`/health`,e=>e.json({status:`ok`}));let n=e(),r=new re({eventStore:new ae({})});return t.all(`/mcp`,async e=>(n.isConnected()||await n.connect(r),await r.handleRequest(e))),t.notFound(e=>(Z.debug(`${e.req.method} ${e.req.url} not found`),e.json({jsonrpc:`2.0`,error:{code:-32e3,message:`Method not found.`},id:null},{status:404}))),t.onError((e,t)=>(Z.error(a(e)),t.json({jsonrpc:`2.0`,error:{code:-32603,message:`Internal server error`},id:null},{status:500}))),t}async function startServer(e){let{factory:t,port:n}=e,r=await createHonoApp(t);return new Promise((e,t)=>{let i=We({fetch:r.fetch,hostname:`0.0.0.0`,port:n}).prependOnceListener(`error`,t).prependOnceListener(`listening`,()=>{i.removeListener(`error`,t),e(i.unref())})})}var StreamableLikeC4MCPServer=class{server=void 0;constructor(e,t=33335){this.services=e,this._port=t}get mcp(){throw Error(`StreamableLikeC4MCPServer has access to McpServer only during the request`)}get isStarted(){return this.server?.listening===!0}get port(){return this._port}async dispose(){await this.stop()}async start(e=this._port){if(this.server){if(this.port===e)return;await this.stop()}Z.info(`Starting MCP server on port {port}`,{port:e}),this._port=e,this.server=await startServer({factory:()=>createMCPServer(this.services),port:e}),Z.info(`MCP server ready at http://0.0.0.0:{port}/mcp`,{port:e})}stop(){let e=this.server;return e?(Z.info(`Stopping MCP server`),this.server=void 0,new Promise(t=>{e.close(e=>{e?Z.error(`Failed to stop MCP server`,{err:e}):Z.info(`MCP server stopped`),t()})})):(Z.info(`MCP server is not running, nothing to stop`),Promise.resolve())}};async function initLikeC4MCP(e){let t=h(e,{workspacePath:`.`,mcp:`stdio`,graphviz:`wasm`,watch:!0,throwIfInvalid:!1,configureLogger:!0});t.configureLogger&&(u({useStdErr:t.mcp===`stdio`,colors:S.isColorSupported&&t.mcp!==`stdio`,logLevel:Dt?`debug`:`info`}),process.on(`uncaughtException`,e=>{Z.error(`uncaughtException`,{err:e})}),process.on(`unhandledRejection`,e=>{Z.error(`unhandledRejection`,{err:e})}));let n=H(t.workspacePath);Z.info`Loading LikeC4 from workspace: ${n}`;let r=await l(n,{graphviz:t.graphviz,manualLayouts:!0,configureLogger:!1,watch:t.watch,throwIfInvalid:t.throwIfInvalid}),i=r.languageServices;return{server:t.mcp===`stdio`?new StdioLikeC4MCPServer(i):new StreamableLikeC4MCPServer(i,t.mcp.port),likec4:r}}async function startLikeC4MCP(e){let t=await initLikeC4MCP(e);return await t.server.start(),t}const mcpCmd=e=>e.command({command:`mcp [path]`,aliases:[],describe:`Start MCP server`,builder:e=>e.usage(`${S.bold(`Usage:`)} $0 mcp [path]`).positional(`path`,q).default(`path`,`.`,`current directory`).option(`stdio`,{boolean:!0,description:`use stdio transport`,conflicts:[`http`,`port`]}).option(`http`,{boolean:!0,description:`use streamable http transport (use 33335 port by default)`,conflicts:`stdio`}).option(`port`,{alias:`p`,number:!0,description:`enables http transport and sets the port`,conflicts:`stdio`}).option(`use-dot`,J).option(`log-level`,an).option(`verbose`,on).showHidden().epilog(`${S.bold(`Examples:`)}
|
|
1432
|
+
${S.green(`$0 mcp`)}
|
|
1433
|
+
${S.gray(`Start MCP with default stdio transport`)}
|
|
1434
|
+
${S.green(`$0 mcp --http ./src`)}
|
|
1435
|
+
${S.gray(`Start MCP with streamable http transport on port 33335 at ./src folder`)}
|
|
1436
|
+
${S.green(`$0 mcp -p 1234`)}
|
|
1437
|
+
${S.gray(`Start MCP with streamable http transport on port 1234`)}
|
|
1438
|
+
`),handler:async e=>{e.http||e.port?(u({colors:S.isColorSupported,logLevel:e.verbose?sn:e.logLevel}),await startHttpMcp(e.path,e.useDot,e.port)):(u({useStdErr:!0,colors:!1,logLevel:e.verbose?sn:e.logLevel}),await startStdioMcp(e.path,e.useDot))}});async function startHttpMcp(e,t,n=33335){await startLikeC4MCP({workspacePath:e,mcp:{port:n},watch:!0,configureLogger:!1,graphviz:t?`binary`:`wasm`}),boxen([S.green(`LikeC4 MCP served at:`),`
|
|
1300
1439
|
{
|
|
1301
1440
|
"mcpServers": {
|
|
1302
1441
|
"likec4": {
|
|
@@ -1305,18 +1444,18 @@ ${x.green(`$0 mcp -p 1234`)}
|
|
|
1305
1444
|
}
|
|
1306
1445
|
}
|
|
1307
1446
|
|
|
1308
|
-
${
|
|
1309
|
-
${
|
|
1447
|
+
${S.dim(`Documentation:`)}
|
|
1448
|
+
${S.underline(`https://likec4.dev/tooling/mcp/#using-extension`)}
|
|
1310
1449
|
`].join(`
|
|
1311
|
-
`))}async function
|
|
1312
|
-
if not specified search in current directory`,normalize:!0}).options({output:{alias:`o`,type:`string`,desc:`output directory from production build`,normalize:!0},base:{type:`string`,desc:`base url the app is being served from`},listen:{alias:`l`,type:`string`,desc:`ip address of the network interface to listen on`}}).coerce([`path`,`output`],
|
|
1313
|
-
${
|
|
1314
|
-
${
|
|
1315
|
-
|
|
1316
|
-
${
|
|
1317
|
-
${
|
|
1318
|
-
|
|
1319
|
-
${
|
|
1320
|
-
${
|
|
1321
|
-
`),handler:async e=>{try{var t=
|
|
1322
|
-
`),skipValidation:!0,hidden:!0,global:!0}).group([`log-level`,`verbose`,`color`,`help`,`version`,`show-hidden`],`Globals:`).demandCommand(1,`Please run with valid command`).recommendCommands().showHelpOnFail(!0).showHidden().updateStrings({"Globals:":
|
|
1450
|
+
`))}async function startStdioMcp(e,t){await startLikeC4MCP({workspacePath:e,mcp:`stdio`,watch:!0,configureLogger:!1,graphviz:t?`binary`:`wasm`})}async function vitePreview(e){let t=await viteConfig({...e,likec4AssetsDir:``,webcomponentPrefix:void 0}),n=await Ve({port:Be(62001,62010)}),r=e?.open??!1;return await zt({...t,customLogger:t.customLogger,mode:`production`,preview:{host:e.listen??`127.0.0.1`,allowedHosts:!0,port:n,open:r}})}async function handler$1({path:e,output:t,base:n,listen:r}){printServerUrls(await vitePreview({base:n,languageServices:await l(e,{watch:!1}),outputDir:t,open:!O(),listen:r}))}t(handler$1,`handler`);const previewCmd=e=>e.command({command:`preview [path]`,describe:`Start local server to preview production build`,builder:e=>e.positional(`path`,{type:`string`,desc:`Directory with LikeC4 source files
|
|
1451
|
+
if not specified search in current directory`,normalize:!0}).options({output:{alias:`o`,type:`string`,desc:`output directory from production build`,normalize:!0},base:{type:`string`,desc:`base url the app is being served from`},listen:{alias:`l`,type:`string`,desc:`ip address of the network interface to listen on`}}).coerce([`path`,`output`],H).default(`path`,H(`.`),`.`).default(`listen`,`127.0.0.1`,`localhost`),handler:async e=>{await handler$1(e)}});async function handler({path:e,useDotBin:t,webcomponentPrefix:n,title:r,useHashHistory:i,enableWebcomponent:a=!0,enableHMR:s=!0,base:c,listen:u,port:f}){s&&(process.env.NODE_ENV=`development`);let p=await viteDev({buildWebcomponent:a,hmr:s,base:c,webcomponentPrefix:n,title:r,languageServices:await l(e,{graphviz:t?`binary`:`wasm`,watch:s}),useHashHistory:i,likec4AssetsDir:await _t(B(ut(),`.likec4-assets-`)),listen:u,port:f});p.config.logger.clearScreen(`info`),printServerUrls(p),Ut(showSupportUsMessage,1e3).unref()}const serveCmd=e=>e.command({command:`start [path]`,aliases:[`serve`,`dev`],describe:`Start local dev server to preview LikeC4 views`,builder:e=>e.positional(`path`,q).option(`base`,en).option(`webcomponent-prefix`,Zt).option(`title`,Qt).option(`use-hash-history`,Xt).option(`use-dot`,J).option(`listen`,nn).option(`port`,rn).options({"react-hmr":{type:`boolean`,default:!0,describe:`Enable/Disable React HMR`},"build-webcomponent":{type:`boolean`,default:!0,describe:`Enable/Disable Webcomponent build`}}),handler:async e=>{await ensureReact(),await handler({path:e.path,useDotBin:e[`use-dot`],base:e.base,webcomponentPrefix:e[`webcomponent-prefix`],title:e.title,useHashHistory:e[`use-hash-history`],listen:e.listen,port:e.port,enableHMR:e[`react-hmr`],enableWebcomponent:e[`build-webcomponent`]})}});async function runSyncPlan(e,t,n,r){let i=await planSyncToLeanix(t,n,{idempotent:!0}),a=H(e,`sync-plan.json`);if(await G(a,JSON.stringify(i,null,2)),r.info(`${S.dim(`generated`)} ${V(process.cwd(),a)}`),i.errors.length>0){let e=`${i.errors.length} plan error(s): ${i.errors.join(`; `)}`;throw r.error(e),Error(e)}}async function runSyncApply(e,t,n,r){let i=await syncToLeanix(t.manifest,t.dryRun,n,{idempotent:!0}),a=H(e,Dn.manifest);if(await G(a,JSON.stringify(i.manifest,null,2)),r.info(`${S.dim(`generated`)} ${V(process.cwd(),a)} (after sync)`),i.errors.length>0){let e=`${i.errors.length} sync error(s): ${i.errors.join(`; `)}`;throw r.error(e),Error(e)}}async function runSyncLeanix(e){let t=createLikeC4Logger(`c4:sync:leanix`),n=startTimer(t),{path:r,outdir:i,project:a,useDotBin:s,dryRun:c,apply:u}=e;try{try{var f=_usingCtx();if(c&&u)throw Error(`Choose either dryRun or apply, not both`);let e=f.a(await l(r,{graphviz:s?`binary`:`wasm`,watch:!1})),{projectId:n}=ensureProject(e,a);a&&t.info(`${S.dim(`project`)} ${S.green(n)}`);let p=await e.layoutedModel(n);if(p===Oe.EMPTY)throw t.error(xn),Error(xn);let m=buildBridgeArtifacts(asBridgeModel(p));await writeBridgeArtifacts(i,m,t);let h=createLeanixClientFromEnv();if((c||!u)&&(h?await runSyncPlan(i,m.dryRun,h,t):t.info(`${S.dim(`skip`)} sync-plan (set LEANIX_API_TOKEN to include plan)`)),u){if(!h)throw t.error(Sn),Error(Sn);await runSyncApply(i,m,h,t)}}catch(e){f.e=e}finally{await f.d()}}finally{n.stopAndLog()}}const gr=H(process.cwd(),`out`,`bridge`);function isSyncCmdArgs(e){return typeof e!=`object`||!e||!Object.hasOwn(e,`target`)?!1:typeof Reflect.get(e,`target`)==`string`}function syncCmd(e){return e.command({command:`sync <target> [path]`,describe:`Sync bridge artifacts (e.g. LeanIX)`,builder:e=>e.positional(`target`,{type:`string`,choices:[`leanix`],describe:`Target system (leanix)`}).positional(`path`,q).option(`outdir`,{...Y,default:gr,desc:`<dir> output directory for bridge artifacts (manifest, leanix-dry-run, report, sync-plan)`}).option(`dry-run`,{type:`boolean`,describe:`Only write artifacts and optional sync-plan; do not call LeanIX API for create/update`}).option(`apply`,{type:`boolean`,describe:`Run live sync to LeanIX (requires LEANIX_API_TOKEN)`}).conflicts(`dry-run`,`apply`).option(`project`,X).option(`use-dot`,J).example(`${S.green(`$0 sync leanix --dry-run -o out/bridge`)}`,S.gray(`Write bridge artifacts and optionally sync-plan when LEANIX_API_TOKEN is set`)).example(`${S.green(`$0 sync leanix --apply -o out/bridge`)}`,S.gray(`Write artifacts then run live sync; updates manifest with LeanIX IDs`)),handler:async e=>{if(!isSyncCmdArgs(e)||e.target!==`leanix`)return;let t=e.apply??!1,n=e.dryRun??!t;await runSyncLeanix({path:e.path??`.`,outdir:e.outdir??gr,project:e.project,useDotBin:e.useDotBin??!1,dryRun:n,apply:t})}})}const validateCmd=e=>e.command({command:`validate [path]`,aliases:[],describe:`Validate syntax, semantics and layout drifts`,builder:e=>e.positional(`path`,q).options({project:X,file:{alias:`f`,array:!0,string:!0,description:`only report errors from these files (can be specified multiple times)`},layout:{boolean:!0,default:!0,defaultDescription:`enabled`,description:`force layout validation, or disable with --no-layout`},json:{boolean:!0,nargs:0,description:`output as JSON (structured)`}}).showHidden().epilog(`${S.bold(`Examples:`)}
|
|
1452
|
+
${S.green(`$0 validate `)}
|
|
1453
|
+
${S.gray(`Validate all in the current directory`)}
|
|
1454
|
+
|
|
1455
|
+
${S.green(`$0 validate --no-layout --json -f ./src/model.c4 -f ./src/deployment.c4 `)}
|
|
1456
|
+
${S.gray([`Validate all`,`ignore layout drifts`,`report only errors from these files`,`output as JSON`].join(`, `))}
|
|
1457
|
+
|
|
1458
|
+
${S.green(`$0 validate --project my-project /some/where`)}
|
|
1459
|
+
${S.gray(`Validate my-project in /some/where`)}
|
|
1460
|
+
`),handler:async e=>{try{var t=_usingCtx();let n=createLikeC4Logger(`c4:validate`),r=startTimer(n),i=e.json===!0,a=e.layout===!0,s=e.file?.map(e=>H(e))??null,c=t.a(await l(e.path,{watch:!1,printErrors:!i,throwIfInvalid:!1,configureLogger:i?`stderr`:!1})),u=c.getErrors().map(e=>({message:e.message,file:e.sourceFsPath,line:e.line,range:e.range})),f=[];if(a){n.debug(`running layout validation...`);try{let t=await c.diagrams(e.project);for(let n of t)n.drifts&&n.drifts.length>0&&f.push({message:`Layout drift detected on view '${n.id}'`,file:n.sourcePath?H(e.path,n.sourcePath):``,line:0,range:null})}catch(e){f.push({message:`Layout validation failed: ${e instanceof Error?e.message:String(e)}`,file:``,line:0,range:null})}}let p=[...u,...f],m=c.documentCount(),h=p.length,g=s?p.filter(e=>s.some(t=>e.file===t||e.file.endsWith(`/`+t)||e.file.endsWith(`\\`+t))):p,_=new Set(g.map(e=>e.file)),v=g.length===0;process.exitCode=+!v;let y={valid:v,errors:g,stats:{totalFiles:m,totalErrors:h,filteredFiles:s?_.size:m,filteredErrors:g.length}};if(i){console.log(JSON.stringify(y,null,2));return}for(let e of f)n.error(S.red(e.message)+(e.file?` at `+e.file:``));if(v)n.info(S.green(`✓ Valid`)+S.dim(` (${m} files)`));else{let e=s?`, ${g.length} in filtered files`:``;n.error(S.red(`✗ Invalid`)+S.dim(` (${m} files, ${h} errors${e})`))}r.stopAndLog(`validate `)}catch(e){t.e=e}finally{await t.d()}}});function applyLoggerConfig(e){let t=e??(Dt?`debug`:`info`);p({reset:!0,sinks:{console:c({formatter:S.isColorSupported?m():i()})},loggers:[{category:`likec4`,sinks:[`console`],lowestLevel:t}]})}async function main(){!Ot&&!Et&&!O()&&await notifyAvailableUpdate(),await le(Ft(It(At)),serveCmd,buildCmd,codegenCmd,exportCmd,formatCmd,previewCmd,syncCmd,validateCmd,listIconsCmd,mcpCmd,lsp_default,checkUpdateCmd,e=>e.command({command:`completion`,describe:`Generate completion script`,handler:()=>{e.showCompletionScript()}})).scriptName(`likec4`).usage(`Usage: $0 <command>`).version(Gt).alias(`v`,`version`).alias(`h`,`help`).help(`help`).option(`log-level`,an).option(`verbose`,on).option(`color`,{boolean:!0,describe:[`force color output, or disable with --no-color`,`respects 'FORCE_COLOR' and 'NO_COLOR' env variables`].join(`
|
|
1461
|
+
`),skipValidation:!0,hidden:!0,global:!0}).group([`log-level`,`verbose`,`color`,`help`,`version`,`show-hidden`],`Globals:`).demandCommand(1,`Please run with valid command`).recommendCommands().showHelpOnFail(!0).showHidden().updateStrings({"Globals:":S.bold(`Globals:`),"Options:":S.bold(`Options:`),"Positionals:":S.bold(`Arguments:`),"Commands:":S.bold(`Commands:`),"Examples:":S.bold(`Examples:`)}).wrap(de(Pt.columns-10,{min:60,max:180})).middleware(e=>{applyLoggerConfig(e.verbose?sn:e.logLevel)}).parseAsync()}function exitWithFailure(e,t){console.error(t==null?a(e):`${t} ${a(e)}`),Mt(1)}main().catch(exitWithFailure),process.on(`unhandledRejection`,e=>{exitWithFailure(e,`Unhandled rejection:`)}),process.on(`uncaughtException`,e=>{console.error(e)});export{};
|