@likec4/generators 1.55.0 → 1.56.0

package/dist/_chunks/chunk.mjs

@@ -1,3 +1,4 @@
+//#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -8,4 +9,5 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
+//#endregion
 export { __exportAll as t };

package/dist/index.mjs

@@ -5,6 +5,7 @@ import { RichText, flattenMarkdownOrString } from "@likec4/core/types";
 import pako from "pako";
 import JSON5 from "json5";
 import { compareNatural, invariant as invariant$1, sortNaturalByFqn } from "@likec4/core/utils";
+//#region src/d2/generate-d2.ts
 const capitalizeFirstLetter$2 = (value) => value.charAt(0).toLocaleUpperCase() + value.slice(1);
 const fqnName$2 = (nodeId) => nodeId.split(".").map(capitalizeFirstLetter$2).join("");
 const nodeName$2 = (node) => {
@@ -52,6 +53,8 @@ function generateD2(viewmodel) {
 	};
 	return toString(new CompositeGeneratorNode().append("direction: ", d2direction(view), NL, NL).append(joinToNode(nodes.filter((n) => isNullish(n.parent)), (n) => printNode(n), { appendNewLineIfNotEmpty: true })).appendIf(edges.length > 0, NL, joinToNode(edges, (e) => printEdge(e), { appendNewLineIfNotEmpty: true })));
 }
+//#endregion
+//#region src/drawio/constants.ts
 /**
 * DrawIO protocol and layout constants. Single source of truth so export/parse
 * stay in sync and magic numbers are named for readability.
@@ -60,47 +63,19 @@ function generateD2(viewmodel) {
 const DRAWIO_PAGE_LINK_PREFIX = "data:page/id,likec4-";
 /** Diagram (tab) id inside mxfile; we use "likec4-<viewId>" so Draw.io opens the correct tab. */
 const DRAWIO_DIAGRAM_ID_PREFIX = "likec4-";
-/** Fixed canvas size so the diagram opens centered in Draw.io (layout bounds often equal content). */
-const DEFAULT_CANVAS_WIDTH = 800;
-const DEFAULT_CANVAS_HEIGHT = 600;
-/** Default node bbox when layout has no position (used to detect "unlaid" nodes for spread/wrap). */
-const DEFAULT_NODE_WIDTH = 120;
-const DEFAULT_NODE_HEIGHT = 60;
-/** Vertical gap when spreading multiple nodes that share the same default bbox. */
-const NODES_SPREAD_GAP = 24;
 /** First id assigned to container title cells (incremented per container). */
 const CONTAINER_TITLE_CELL_ID_START = 1e4;
-/** Container title text cell: min/max width (px), approximate width per character, height, inset from container edge. */
-const CONTAINER_TITLE_MIN_WIDTH_PX = 60;
-const CONTAINER_TITLE_MAX_WIDTH_PX = 260;
-const CONTAINER_TITLE_CHAR_WIDTH_PX = 8;
-const CONTAINER_TITLE_HEIGHT_PX = 18;
-const CONTAINER_TITLE_INSET_X = 8;
-const CONTAINER_TITLE_INSET_Y = 8;
-/** Max height (px) for container title area when matching title cell to container (parse). */
-const CONTAINER_TITLE_AREA_MAX_HEIGHT_PX = 40;
 /** Ratio of container height used for title area when matching (parse). */
 const CONTAINER_TITLE_AREA_HEIGHT_RATIO = .5;
-/** Tolerance (px) for title cell position inside container bounds (parse). */
-const CONTAINER_TITLE_AREA_TOLERANCE = 2;
-/** Default container fill opacity (0–100) when not set in style. */
-const DEFAULT_CONTAINER_OPACITY = 15;
-/** Default node fill/stroke/font when no theme color (hex). */
-const DEFAULT_NODE_FILL_HEX = "#dae8fc";
-const DEFAULT_NODE_STROKE_HEX = "#2563eb";
-const DEFAULT_NODE_FONT_HEX = "#1e40af";
-/** mxGraphModel page dimensions (draw.io default A4-like). */
-const MXGRAPH_PAGE_WIDTH = 827;
 const MXGRAPH_PAGE_HEIGHT = 1169;
-/** mxGraphModel default grid origin (dx, dy) in mxGraphModel attribute. */
-const MXGRAPH_DEFAULT_DX = 800;
-const MXGRAPH_DEFAULT_DY = 800;
 /** Default filename when exporting all views into one .drawio file (CLI and playground). */
 const DEFAULT_DRAWIO_ALL_FILENAME = "diagrams.drawio";
 /** LikeC4 app font (matches --mantine-font-family / --likec4-app-font-default). Used in generate-drawio for cell text. */
 const LIKEC4_FONT_FAMILY = "'IBM Plex Sans Variable',ui-sans-serif,system-ui,sans-serif";
 /** Container title color in diagram (matches LikeC4 diagram compound title). Used in generate-drawio for container title cell. */
 const CONTAINER_TITLE_COLOR = "#74c0fc";
+//#endregion
+//#region src/drawio/xml-utils.ts
 /**
 * Shared XML escape/decode for DrawIO generate and parse.
 * Single place so escaping rules stay in sync (Clean Code 8.5.2).
@@ -121,6 +96,8 @@ function escapeXml(unsafe) {
 function decodeXmlEntities(s) {
 	return s.replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&quot;", "\"").replaceAll("&apos;", "'").replaceAll("&amp;", "&");
 }
+//#endregion
+//#region src/drawio/parse-drawio.ts
 /**
 * Parse DrawIO (mxGraph) XML and generate LikeC4 source code.
 * Extracts vertices as elements and edges as relations; preserves colors, descriptions,
@@ -713,8 +690,8 @@ function computeContainerTitles(vertices) {
 	const containerCells = vertices.filter((v) => v.style?.toLowerCase().includes("container=1") && v.x != null && v.y != null && v.width != null && v.height != null);
 	for (const cont of containerCells) {
 		const cw = cont.width, ch = cont.height;
-		const titleAreaHeight = Math.min(CONTAINER_TITLE_AREA_MAX_HEIGHT_PX, ch * CONTAINER_TITLE_AREA_HEIGHT_RATIO) + CONTAINER_TITLE_AREA_TOLERANCE;
-		const best = vertices.find((v) => v.id !== cont.id && v.parent === cont.id && (v.style?.toLowerCase().includes("shape=text") || v.style?.toLowerCase().includes("text;")) && v.x != null && v.y != null && v.x >= -CONTAINER_TITLE_AREA_TOLERANCE && v.x <= cw + CONTAINER_TITLE_AREA_TOLERANCE && v.y >= -CONTAINER_TITLE_AREA_TOLERANCE && v.y <= titleAreaHeight);
+		const titleAreaHeight = Math.min(40, ch * CONTAINER_TITLE_AREA_HEIGHT_RATIO) + 2;
+		const best = vertices.find((v) => v.id !== cont.id && v.parent === cont.id && (v.style?.toLowerCase().includes("shape=text") || v.style?.toLowerCase().includes("text;")) && v.x != null && v.y != null && v.x >= -2 && v.x <= cw + 2 && v.y >= -2 && v.y <= titleAreaHeight);
 		if (best) {
 			const raw = (best.value ?? "").trim();
 			if (raw) {
@@ -1068,7 +1045,7 @@ function decompressDrawioDiagram(base64Content) {
 function getFirstDiagram(fullXml) {
 	return getAllDiagrams(fullXml)[0] ?? {
 		name: "index",
-		id: `${DRAWIO_DIAGRAM_ID_PREFIX}index`,
+		id: `likec4-index`,
 		content: ""
 	};
 }
@@ -1092,7 +1069,7 @@ function getAllDiagrams(fullXml) {
 		if (closeStart === -1) break;
 		const inner = fullXml.slice(endOpen + 1, closeStart);
 		const name = getAttr(attrs, "name") ?? (results.length === 0 ? "index" : `diagram_${results.length + 1}`);
-		const id = getAttr(attrs, "id") ?? `${DRAWIO_DIAGRAM_ID_PREFIX}${name}`;
+		const id = getAttr(attrs, "id") ?? `likec4-${name}`;
 		let content;
 		if (inner.includes("<mxGraphModel")) content = inner;
 		else if (inner.trim() === "") content = inner;
@@ -1506,6 +1483,8 @@ function parseDrawioRoundtripComments(c4Source) {
 	};
 	return null;
 }
+//#endregion
+//#region src/drawio/generate-drawio.ts
 /**
 * DrawIO diagram generator.
 *
@@ -1615,7 +1594,7 @@ function getDefaultStrokeWidth(borderVal, isContainer) {
 /** Apply stroke color override to base element colors (KISS: named function instead of IIFE). */
 function applyStrokeColorOverride(base, override) {
 	return {
-		fill: base?.fill ?? DEFAULT_NODE_FILL_HEX,
+		fill: base?.fill ?? "#dae8fc",
 		stroke: override,
 		font: base?.font ?? override
 	};
@@ -1662,21 +1641,21 @@ function drawioShape(shape) {
 function getElementColors(viewmodel, color) {
 	const elementColors = getThemeColorValues(viewmodel, color, "primary").elements;
 	return {
-		fill: String(elementColors.fill ?? DEFAULT_NODE_FILL_HEX),
-		stroke: String(elementColors.stroke ?? DEFAULT_NODE_STROKE_HEX),
-		font: String(elementColors.hiContrast ?? elementColors.stroke ?? DEFAULT_NODE_FONT_HEX)
+		fill: String(elementColors.fill ?? "#dae8fc"),
+		stroke: String(elementColors.stroke ?? "#2563eb"),
+		font: String(elementColors.hiContrast ?? elementColors.stroke ?? "#1e40af")
 	};
 }
 /** Edge stroke (line) color from theme RelationshipColorValues.line. */
 function getEdgeStrokeColor(viewmodel, color) {
 	const values = getThemeColorValues(viewmodel, color ?? "gray", "gray");
-	return String(values.relationships?.line ?? DEFAULT_NODE_FONT_HEX);
+	return String(values.relationships?.line ?? "#1e40af");
 }
 /** Edge label font and background from theme (RelationshipColorValues.label, labelBg) for readable connector text. */
 function getEdgeLabelColors(viewmodel, color) {
 	const rel = getThemeColorValues(viewmodel, color ?? "gray", "gray").relationships;
 	return {
-		font: String(rel?.label ?? rel?.line ?? DEFAULT_NODE_FONT_HEX),
+		font: String(rel?.label ?? rel?.line ?? "#1e40af"),
 		background: String(rel?.labelBg ?? "#ffffff")
 	};
 }
@@ -1895,9 +1874,9 @@ function computeNodeStylePartsAndValue(node, layout, options, viewmodel) {
 	const strokeColorOverride = strokeColorByNodeId?.[node.id];
 	const strokeWidthOverride = strokeWidthByNodeId?.[node.id];
 	const elemColors = strokeColorOverride ? applyStrokeColorOverride(getElementColors(viewmodel, node.color), strokeColorOverride) : getElementColors(viewmodel, node.color);
-	const fillHex = elemColors?.fill ?? DEFAULT_NODE_FILL_HEX;
-	const strokeHex = elemColors?.stroke ?? DEFAULT_NODE_STROKE_HEX;
-	const fontHex = elemColors?.font ?? elemColors?.stroke ?? DEFAULT_NODE_FONT_HEX;
+	const fillHex = elemColors?.fill ?? "#dae8fc";
+	const strokeHex = elemColors?.stroke ?? "#2563eb";
+	const fontHex = elemColors?.font ?? elemColors?.stroke ?? "#1e40af";
 	const colorStyle = `fillColor=${fillHex};strokeColor=${strokeHex};fontColor=${fontHex};`;
 	const nodeStyle = node.style;
 	const fontSizePx = effectiveStyles.fontSize(nodeStyle?.textSize);
@@ -1906,7 +1885,7 @@ function computeNodeStylePartsAndValue(node, layout, options, viewmodel) {
 	const strokeWidth = strokeWidthOverride ?? getDefaultStrokeWidth(borderVal, isContainer);
 	const strokeWidthStyle = strokeWidth !== "" ? `strokeWidth=${strokeWidth};` : "";
 	const containerDashed = getContainerDashedStyle(isContainer, borderVal);
-	const containerOpacityNum = isContainer === true ? nodeStyle?.opacity ?? DEFAULT_CONTAINER_OPACITY : void 0;
+	const containerOpacityNum = isContainer === true ? nodeStyle?.opacity ?? 15 : void 0;
 	const fillOpacityStyle = containerOpacityNum != null && isContainer === true ? `fillOpacity=${Math.min(100, Math.max(0, containerOpacityNum))};` : "";
 	const likec4StyleWithBridge = buildLikec4StyleForNode({
 		desc,
@@ -1971,17 +1950,17 @@ function buildNodeCellXml(data) {
 	};
 	return {
 		vertexXml: cellXml,
-		titleCellXml: buildContainerTitleCellXml(data.title ?? "", data.titleCellId ?? data.id, data.navTo, data.id, data.fontFamily, data.containerTitleFontSizePx ?? 12, data.containerTitleColor ?? CONTAINER_TITLE_COLOR),
+		titleCellXml: buildContainerTitleCellXml(data.title ?? "", data.titleCellId ?? data.id, data.navTo, data.id, data.fontFamily, data.containerTitleFontSizePx ?? 12, data.containerTitleColor ?? "#74c0fc"),
 		isContainer: true
 	};
 }
 /** Build container title cell XML (child of container, relative position CONTAINER_TITLE_INSET_*). */
 function buildContainerTitleCellXml(title, titleId, navTo, containerId, fontFamily, fontSizePx, colorHex) {
 	const titleValue = escapeXml(title);
-	const titleWidth = Math.max(CONTAINER_TITLE_MIN_WIDTH_PX, Math.min(CONTAINER_TITLE_MAX_WIDTH_PX, title.length * CONTAINER_TITLE_CHAR_WIDTH_PX));
-	const titleHeight = CONTAINER_TITLE_HEIGHT_PX;
-	const titleX = CONTAINER_TITLE_INSET_X;
-	const titleY = CONTAINER_TITLE_INSET_Y;
+	const titleWidth = Math.max(60, Math.min(260, title.length * 8));
+	const titleHeight = 18;
+	const titleX = 8;
+	const titleY = 8;
 	const navLinkStyle = buildNavLinkStyle(navTo);
 	const titleStyle = `shape=text;html=1;fillColor=none;strokeColor=none;align=left;verticalAlign=top;fontSize=${fontSizePx};fontStyle=1;fontColor=${colorHex};fontFamily=${encodeURIComponent(fontFamily)};${navLinkStyle}`;
 	if (navTo === "") return `<mxCell id="${titleId}" value="${titleValue}" style="${titleStyle}" vertex="1" parent="${containerId}">\n  <mxGeometry x="${Math.round(titleX)}" y="${Math.round(titleY)}" width="${titleWidth}" height="${titleHeight}" as="geometry" />\n</mxCell>`;
@@ -2043,8 +2022,8 @@ function drawioArrow(arrow) {
 const DEFAULT_BBOX = {
 	x: 0,
 	y: 0,
-	width: DEFAULT_NODE_WIDTH,
-	height: DEFAULT_NODE_HEIGHT
+	width: 120,
+	height: 60
 };
 /** True when bbox equals default (unlaid) dimensions. */
 function isDefaultBbox(b) {
@@ -2071,7 +2050,7 @@ function spreadUnlaidNodesOverVertical(bboxes, sortedNodes, containerNodeIds) {
 			bboxes.set(node.id, {
 				...firstBbox,
 				x: firstBbox.x,
-				y: firstBbox.y + i * (firstBbox.height + NODES_SPREAD_GAP)
+				y: firstBbox.y + i * (firstBbox.height + 24)
 			});
 		});
 	}
@@ -2111,15 +2090,15 @@ function computeContentBoundsAndOffsets(bboxes) {
 	}
 	if (contentMinX === Infinity) contentMinX = 0;
 	if (contentMinY === Infinity) contentMinY = 0;
-	if (contentMaxX === -Infinity) contentMaxX = contentMinX + DEFAULT_CANVAS_WIDTH;
-	if (contentMaxY === -Infinity) contentMaxY = contentMinY + DEFAULT_CANVAS_HEIGHT;
+	if (contentMaxX === -Infinity) contentMaxX = contentMinX + 800;
+	if (contentMaxY === -Infinity) contentMaxY = contentMinY + 600;
 	const contentCx = contentMinX + (contentMaxX - contentMinX) / 2;
 	const contentCy = contentMinY + (contentMaxY - contentMinY) / 2;
 	return {
-		offsetX: DEFAULT_CANVAS_WIDTH / 2 - contentCx,
-		offsetY: DEFAULT_CANVAS_HEIGHT / 2 - contentCy,
-		canvasWidth: DEFAULT_CANVAS_WIDTH,
-		canvasHeight: DEFAULT_CANVAS_HEIGHT
+		offsetX: 800 / 2 - contentCx,
+		offsetY: 600 / 2 - contentCy,
+		canvasWidth: 800,
+		canvasHeight: 600
 	};
 }
 /**
@@ -2146,8 +2125,8 @@ function computeDiagramLayout(viewmodel, options) {
 		return {
 			x: typeof d.x === "number" ? d.x : Array.isArray(d.position) ? d.position[0] : 0,
 			y: typeof d.y === "number" ? d.y : Array.isArray(d.position) ? d.position[1] : 0,
-			width: typeof d.width === "number" ? d.width : d.size?.width ?? DEFAULT_NODE_WIDTH,
-			height: typeof d.height === "number" ? d.height : d.size?.height ?? DEFAULT_NODE_HEIGHT
+			width: typeof d.width === "number" ? d.width : d.size?.width ?? 120,
+			height: typeof d.height === "number" ? d.height : d.size?.height ?? 60
 		};
 	};
 	const bboxes = /* @__PURE__ */ new Map();
@@ -2200,7 +2179,7 @@ function generateDiagramContent(viewmodel, options) {
 	const getCellId = (nodeId) => {
 		let id = nodeIds.get(nodeId);
 		if (!id) {
-			if (cellId >= CONTAINER_TITLE_CELL_ID_START) throw new Error("DrawIO cell ID range exhausted");
+			if (cellId >= 1e4) throw new Error("DrawIO cell ID range exhausted");
 			id = String(cellId++);
 			nodeIds.set(nodeId, id);
 		}
@@ -2219,7 +2198,7 @@ function generateDiagramContent(viewmodel, options) {
 		} else vertexCells.push(result.vertexXml);
 	}
 	for (const edge of edges) {
-		if (cellId >= CONTAINER_TITLE_CELL_ID_START) throw new Error("DrawIO cell ID range exhausted");
+		if (cellId >= 1e4) throw new Error("DrawIO cell ID range exhausted");
 		const edgeId = String(cellId++);
 		edgeCells.push(buildEdgeCellXml(edge, layout, options, viewmodel, getCellId, edgeId));
 	}
@@ -2232,7 +2211,7 @@ function generateDiagramContent(viewmodel, options) {
 		...edgeCells
 	].join("\n");
 	const diagramName = (getViewTitle(view) ?? view.id).trim() || view.id;
-	const mxGraphModelXml = `<mxGraphModel dx="${MXGRAPH_DEFAULT_DX}" dy="${MXGRAPH_DEFAULT_DY}" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="${MXGRAPH_PAGE_WIDTH}" pageHeight="${MXGRAPH_PAGE_HEIGHT}" math="0" shadow="0">
+	const mxGraphModelXml = `<mxGraphModel dx="800" dy="800" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="${MXGRAPH_PAGE_HEIGHT}" math="0" shadow="0">
       <root>
         <mxCell id="${rootId}" />
         ${allCells}
@@ -2342,6 +2321,8 @@ function generateDrawioEditUrl(xml) {
 	});
 	return "https://app.diagrams.net/#create=" + encodeURIComponent(createObj);
 }
+//#endregion
+//#region src/mmd/generate-mmd.ts
 const capitalizeFirstLetter$1 = (value) => value.charAt(0).toLocaleUpperCase() + value.slice(1);
 const fqnName$1 = (nodeId) => nodeId.split(".").map(capitalizeFirstLetter$1).join("");
 const nodeName$1 = (node) => {
@@ -2392,6 +2373,8 @@ function generateMermaid(viewmodel) {
 		indentation: 2
 	}));
 }
+//#endregion
+//#region src/model/generate-aux.ts
 function toUnion(elements) {
 	if (elements.length === 0) return "never";
 	return elements.sort(compareNatural).map((v) => `  | ${JSON.stringify(v)}`).join("\n").trimStart();
@@ -2444,6 +2427,8 @@ export type $Tags = readonly $Aux['Tag'][]
 export type $MetadataKey = $Aux['MetadataKey']
 `.trimStart();
 }
+//#endregion
+//#region src/model/generate-likec4-model.ts
 function generateLikeC4Model(model, options = {}) {
 	const aux = generateAux(model, options);
 	const { useCorePackage = false } = options;
@@ -2467,6 +2452,8 @@ export const likec4model: LikeC4Model<$Aux> = new LikeC4Model(${JSON5.stringify(
 /* prettier-ignore-end */
 `.trimStart();
 }
+//#endregion
+//#region src/puml/generate-puml.ts
 const capitalizeFirstLetter = (value) => value.charAt(0).toLocaleUpperCase() + value.slice(1);
 const fqnName = (nodeId) => {
 	return nodeId.split(/[.-]/).map(capitalizeFirstLetter).join("");
@@ -2562,9 +2549,13 @@ function generatePuml(viewmodel) {
 	};
 	return toString(new CompositeGeneratorNode().append("@startuml", NL).append(printHeader(), NL).append(printTheme(), NL).append(joinToNode(nodes.filter((n) => n.children.length == 0), (n) => printStereotypes(n), { appendNewLineIfNotEmpty: true })).append(joinToNode(nodes.filter((n) => isNullish(n.parent)), (n) => n.children.length > 0 ? printBoundary(n) : printNode(n), { appendNewLineIfNotEmpty: true })).appendIf(edges.length > 0, NL, joinToNode(edges, (e) => printEdge(e), { appendNewLineIfNotEmpty: true })).append(`@enduml`, NL));
 }
+//#endregion
+//#region src/views-data-ts/generateViewId.ts
 function generateViewId(views) {
 	return joinToNode(views, (view) => expandToNode`${JSON5.stringify(view.id)}`, { separator: " | " });
 }
+//#endregion
+//#region src/views-data-ts/generate-views-data.ts
 /**
 * Generate *.js file with views data
 */
@@ -2687,6 +2678,8 @@ function generateViewsDataDTs(diagrams) {
   `.append(NL);
 	return toString(out);
 }
+//#endregion
+//#region src/react-next/generate-react-next.ts
 /**
 * @deprecated in favor packages/likec4/src/cli/codegen/react/index.ts
 */
@@ -2790,6 +2783,8 @@ function generateIndex() {
 		dts: toString(dts)
 	};
 }
+//#endregion
+//#region src/react/generate-react-types.ts
 function generateReactTypes(model, options = {}) {
 	const { useCorePackage = false } = options;
 	invariant$1(!model.isParsed(), "can not generate react types for parsed model");
@@ -2852,4 +2847,5 @@ export {
 /* prettier-ignore-end */
 `.trimStart();
 }
+//#endregion
 export { DEFAULT_DRAWIO_ALL_FILENAME, buildDrawioExportOptionsForViews, buildDrawioExportOptionsFromSource, decompressDrawioDiagram, generateD2, generateDrawio, generateDrawioEditUrl, generateDrawioMulti, generateLikeC4Model, generateMermaid, generatePuml, generateReactNext, generateReactTypes, generateViewsDataDTs, generateViewsDataJs, generateViewsDataTs, getAllDiagrams, parseDrawioRoundtripComments, parseDrawioToLikeC4, parseDrawioToLikeC4Multi };

package/dist/likec4/index.mjs

@@ -9,6 +9,7 @@ import * as z$1 from "zod/v4";
 import { BorderStyles, ElementShapes, IconPositions, RelationshipArrowTypes, Sizes, ThemeColors } from "@likec4/core/styles";
 import { produce } from "immer";
 import { LikeC4StylesConfigSchema } from "@likec4/config";
+//#region src/likec4/operators/base.ts
 var base_exports = /* @__PURE__ */ __exportAll({
 	body: () => body,
 	eachOnFresh: () => eachOnFresh,
@@ -527,6 +528,8 @@ function zodOp(schema) {
 		};
 	};
 }
+//#endregion
+//#region src/likec4/schemas/common.ts
 var common_exports = /* @__PURE__ */ __exportAll({
 	arrow: () => arrow,
 	border: () => border,
@@ -614,6 +617,8 @@ const props = z$1.object({
 	links: links.nullable(),
 	metadata
 }).partial();
+//#endregion
+//#region src/likec4/schemas/expression.ts
 var expression_exports = /* @__PURE__ */ __exportAll({
 	directRelationExpr: () => directRelationExpr$1,
 	elementKindExpr: () => elementKindExpr,
@@ -796,6 +801,8 @@ const expression$1 = z$1.union([
 	relationExprCustom$1,
 	whereExpr
 ]);
+//#endregion
+//#region src/likec4/schemas/deployment.ts
 var deployment_exports$1 = /* @__PURE__ */ __exportAll({
 	element: () => element$3,
 	instance: () => instance$1,
@@ -807,6 +814,11 @@ const node$1 = props.extend({
 	id: fqn,
 	kind,
 	style: style.optional(),
+	/**
+	* Allowing shape, color and icon to be defined at the element level for convenience,
+	* they will be moved to the style property during parsing
+	* (and will override properties)
+	*/
 	shape: shape.optional(),
 	color: color.optional(),
 	icon: icon.optional()
@@ -824,6 +836,11 @@ const instance$1 = props.extend({
 	id: fqn,
 	element: fqn,
 	style: style.optional(),
+	/**
+	* Allowing shape, color and icon to be defined at the element level for convenience,
+	* they will be moved to the style property during parsing
+	* (and will override properties)
+	*/
 	shape: shape.optional(),
 	color: color.optional(),
 	icon: icon.optional()
@@ -859,6 +876,8 @@ const schema$2 = z$1.object({
 	elements: z$1.union([elements$1, z$1.array(element$3)]).transform((v) => isArray(v) ? indexBy(v, prop("id")) : v).optional(),
 	relations: z$1.union([relationships$1, z$1.array(relationship$4)]).transform((v) => isArray(v) ? indexBy(v, genRelationshipId$1) : v).optional()
 });
+//#endregion
+//#region src/likec4/schemas/model.ts
 var model_exports$1 = /* @__PURE__ */ __exportAll({
 	element: () => element$2,
 	relationship: () => relationship$3,
@@ -873,6 +892,11 @@ const element$2 = z$1.object({
 	id: fqn,
 	kind,
 	style: style.optional(),
+	/**
+	* Allowing shape, color and icon to be defined at the element level for convenience,
+	* they will be moved to the style property during parsing
+	* (and will override properties)
+	*/
 	shape: shape.optional(),
 	color: color.optional(),
 	icon: icon.optional()
@@ -908,6 +932,8 @@ const schema$1 = z$1.object({
 	elements: z$1.union([elements, z$1.array(element$2)]).transform((v) => isArray(v) ? indexBy(v, prop("id")) : v).optional(),
 	relations: z$1.union([relationships, z$1.array(relationship$3)]).transform((v) => isArray(v) ? indexBy(v, genRelationshipId) : v).optional()
 });
+//#endregion
+//#region src/likec4/schemas/specification.ts
 var specification_exports$1 = /* @__PURE__ */ __exportAll({
 	element: () => element$1,
 	relationship: () => relationship$2,
@@ -942,11 +968,26 @@ const relationship$2 = z$1.object({
 }).partial().transform(pickBy(isNonNullish));
 const tagSpec = z$1.object({ color: z$1.string().regex(/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/).optional().catch(void 0) }).partial().transform(pickBy(isNonNullish));
 const schema = z$1.object({
+	/**
+	* Element kinds specifications, where key is the kind name
+	*/
 	elements: z$1.record(kind, element$1),
+	/**
+	* Element kinds specifications, where key is the kind name
+	*/
 	deployments: z$1.record(kind, element$1),
+	/**
+	* Relationship kinds specifications, where key is the kind name
+	*/
 	relationships: z$1.record(kind, relationship$2),
+	/**
+	* Tag specifications, where key is the tag name
+	* Or an array of tags, if no additional properties are needed for tags (like color)
+	*/
 	tags: z$1.union([z$1.record(tag, tagSpec), z$1.array(tag).transform((tags) => mapToObj(tags, (t) => [t, {}]))])
 }).partial();
+//#endregion
+//#region src/likec4/schemas/views.ts
 var views_exports$1 = /* @__PURE__ */ __exportAll({
 	anyView: () => anyView$1,
 	autoLayoutDirection: () => autoLayoutDirection,
@@ -1150,6 +1191,8 @@ function normalizeElementStyles(element, specs) {
 		for (const [key, value] of entries(specStyle)) if (isDeepEqual(element.style?.[key], value)) delete draft.style[key];
 	});
 }
+//#endregion
+//#region src/likec4/schemas/index.ts
 const schemas = {
 	common: common_exports,
 	expr: expression_exports,
@@ -1159,6 +1202,8 @@ const schemas = {
 	views: views_exports$1,
 	likec4data: likec4data$1
 };
+//#endregion
+//#region src/likec4/operators/properties.ts
 var properties_exports = /* @__PURE__ */ __exportAll({
 	colorProperty: () => colorProperty,
 	descriptionProperty: () => descriptionProperty,
@@ -1239,6 +1284,8 @@ function iconProperty() {
 	return property("icon", spaceBetween(print$1("icon"), print$1()));
 }
 const styleProperties = zodOp(style)(lines(property("shape"), colorProperty(), iconProperty(), property("iconColor"), property("iconSize"), property("iconPosition"), property("border"), opacityProperty(), property("size"), property("padding"), property("textSize"), property("multiple")));
+//#endregion
+//#region src/likec4/operators/expressions.ts
 var expressions_exports = /* @__PURE__ */ __exportAll({
 	directRelationExpr: () => directRelationExpr,
 	expression: () => expression,
@@ -1454,6 +1501,8 @@ const expression = zodOp(expression$1)(({ ctx, exec }) => {
 	}
 	nonexhaustive(ctx);
 });
+//#endregion
+//#region src/likec4/operators/deployment.ts
 var deployment_exports = /* @__PURE__ */ __exportAll({
 	deployment: () => deployment,
 	instance: () => instance,
@@ -1528,6 +1577,8 @@ function hasRelationProps$1(rel) {
 }
 const relationship$1 = zodOp(schemas.deployment.relationship)(spaceBetween(property("source", fqnRef()), print$1((rel) => rel.kind ? `-[${rel.kind}]->` : "->"), property("target", fqnRef()), property("title", inlineText()), when(hasRelationProps$1, body(tagsProperty(), technologyProperty(), summaryProperty(), descriptionProperty(), property("navigateTo"), linksProperty(), metadataProperty(), when(hasRelationStyle$1, body("style")(colorProperty(), property("line"), property("head"), property("tail")))))));
 const deployment = zodOp(schemas.deployment.schema)(body("deployment")(lines(2)(select((d) => buildTree$1(d.elements ? values(d.elements) : []).roots, lines(2)(foreach(node()))), select((d) => d.relations ? values(d.relations) : void 0, lines(2)(foreach(relationship$1()))))));
+//#endregion
+//#region src/likec4/operators/model.ts
 var model_exports = /* @__PURE__ */ __exportAll({
 	element: () => element,
 	model: () => model,
@@ -1588,6 +1639,8 @@ function hasRelationProps(rel) {
 const relationship = zodOp(schemas.model.relationship)(spaceBetween(property("source", fqnRef()), print$1((rel) => rel.kind ? `-[${rel.kind}]->` : "->"), property("target", fqnRef()), property("title", inlineText()), when(hasRelationProps, body(tagsProperty(), technologyProperty(), summaryProperty(), descriptionProperty(), property("navigateTo"), linksProperty(), metadataProperty(), when(hasRelationStyle, body("style")(colorProperty(), property("line"), property("head"), property("tail")))))));
 const element = zodOp(schemas.model.element)(elementTree());
 const model = zodOp(schemas.model.schema)(body("model")(lines(2)(select((d) => buildTree(d.elements ? values(d.elements) : []).roots, lines(2)(foreach(elementTree()))), select((d) => d.relations ? values(d.relations) : void 0, lines(2)(foreach(relationship()))))));
+//#endregion
+//#region src/likec4/operators/specification.ts
 var specification_exports = /* @__PURE__ */ __exportAll({
 	elementKind: () => elementKind,
 	relationshipKind: () => relationshipKind,
@@ -1598,6 +1651,8 @@ const tagSpecification = zodOp(z$1.tuple([z$1.string(), tagSpec]))(spaceBetween(
 const elementKind = (keyword) => zodOp(z$1.tuple([z$1.string(), element$1]))(spaceBetween(print$1(keyword), printProperty("0"), property("1", body(tagsProperty(), titleProperty(), summaryProperty(), descriptionProperty(), technologyProperty(), notationProperty(), linksProperty(), property("style", body("style")(styleProperties()))))));
 const relationshipKind = zodOp(z$1.tuple([z$1.string(), relationship$2]))(spaceBetween(print$1("relationship"), printProperty("0"), property("1", body(technologyProperty(), notationProperty(), colorProperty(), property("line"), property("head"), property("tail")))));
 const specification = zodOp(schema)(body("specification")(lines(2)(select((c) => c.elements && entries(c.elements), foreachNewLine(elementKind("element")())), select((c) => c.deployments && entries(c.deployments), foreachNewLine(elementKind("deploymentNode")())), select((c) => c.relationships && entries(c.relationships), foreachNewLine(relationshipKind())), select((c) => c.tags && entries(c.tags), foreachNewLine(tagSpecification())))));
+//#endregion
+//#region src/likec4/operators/views.ts
 var views_exports = /* @__PURE__ */ __exportAll({
 	anyView: () => anyView,
 	deploymentView: () => deploymentView,
@@ -1716,8 +1771,12 @@ const views = zodOp(schemas.views.views)(body("views")(select((ctx) => values(ct
 	separator: new CompositeGeneratorNode().appendNewLine().appendNewLine(),
 	prefix: (_, index, isLast) => index === 0 && !isLast ? NL : void 0
 }))));
+//#endregion
+//#region src/likec4/operators/likec4data.ts
 z$1.object({});
 const likec4data = zodOp(schemas.likec4data)(lines(2)(property("specification", specification()), model(), property("deployment", deployment()), property("deployments", deployment()), property("views", views())));
+//#endregion
+//#region src/likec4/operators/index.ts
 var operators_exports = /* @__PURE__ */ __exportAll({
 	base: () => base_exports,
 	deployment: () => deployment,
@@ -1735,6 +1794,8 @@ var operators_exports = /* @__PURE__ */ __exportAll({
 	specifications: () => specification_exports,
 	views: () => views_exports
 });
+//#endregion
+//#region src/likec4/generate-likec4.ts
 function generateLikeC4(input, params) {
 	params = {
 		indentation: 2,
@@ -1795,4 +1856,5 @@ function print(operator, data, params) {
 function printTabIndent(operator, data) {
 	return materialize(withctx(data, operator()), "	");
 }
+//#endregion
 export { generateLikeC4 as generate, operators_exports as operators, print, printTabIndent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@likec4/generators",
-  "version": "1.55.0",
+  "version": "1.56.0",
   "license": "MIT",
   "bugs": "https://github.com/likec4/likec4/issues",
   "homepage": "https://likec4.dev",
@@ -54,18 +54,18 @@
     "indent-string": "^5.0.0",
     "strip-indent": "^4.1.1",
     "zod": "^4.3.6",
-    "@likec4/core": "1.55.0",
-    "@likec4/config": "1.55.0",
-    "@likec4/log": "1.55.0"
+    "@likec4/core": "1.56.0",
+    "@likec4/config": "1.56.0",
+    "@likec4/log": "1.56.0"
   },
   "devDependencies": {
-    "@types/node": "~22.19.15",
+    "@types/node": "~22.19.17",
     "@types/pako": "^2.0.4",
     "typescript": "5.9.3",
     "obuild": "0.4.31",
     "vitest": "4.1.3",
-    "@likec4/tsconfig": "1.55.0",
-    "@likec4/devops": "1.42.0"
+    "@likec4/devops": "1.42.0",
+    "@likec4/tsconfig": "1.56.0"
   },
   "scripts": {
     "typecheck": "tsc -b --verbose",