@likec4/generators 1.53.0 → 1.55.0

package/dist/index.d.mts

@@ -45,7 +45,7 @@ type GenerateDrawioOptions = {
  * Generate a single DrawIO file from one view.
  *
  * @param viewmodel - Layouted LikeC4 view model (from model.view(id))
- * @param options - Optional overrides for layout/colors (round-trip from comment blocks)
+ * @param options - Optional overrides for layout/colors (round-trip from comment blocks); profile `leanix` adds bridge-managed metadata for LeanIX (see GenerateDrawioOptions).
  * @returns DrawIO .drawio XML string
  */
 declare function generateDrawio(viewmodel: DrawioViewModelLike, options?: GenerateDrawioOptions): string;
@@ -55,7 +55,7 @@ declare function generateDrawio(viewmodel: DrawioViewModelLike, options?: Genera
  * so all views open in one file with one tab per view.
  *
  * @param viewmodels - Layouted view models (e.g. from model.views())
- * @param optionsByViewId - Optional per-view options (e.g. compressed: false for each tab)
+ * @param optionsByViewId - Optional per-view options (layout, compressed, profile leanix, etc.)
  * @param modified - Optional ISO timestamp for mxfile modified attribute (for deterministic output)
  * @returns DrawIO .drawio XML string with multiple <diagram> elements
  */
@@ -115,6 +115,8 @@ declare function getAllDiagrams(fullXml: string): DiagramInfo[];
 /**
  * Convert DrawIO XML to LikeC4 source (.c4) string.
  * Vertices → model elements (actor/container); edges → relations (->). Uses first diagram only.
+ * Preserves likec4Id / likec4RelationId from leanix-profile exports when present on cells.
+ *
  * @param xml - Full .drawio mxfile XML (single or multi-tab).
  * @returns LikeC4 .c4 source string (model + views + round-trip comments).
  */
@@ -122,6 +124,8 @@ declare function parseDrawioToLikeC4(xml: string): string;
 /**
  * Convert DrawIO XML to LikeC4 source when file has multiple diagrams (tabs).
  * Merges elements by FQN and relations by (source, target); one view per diagram.
+ * Same leanix bridge style fields as parseDrawioToLikeC4 when present.
+ *
  * @param xml - Full .drawio mxfile XML with multiple <diagram> elements.
  * @returns LikeC4 .c4 source string (model + views + round-trip comments).
  */

package/dist/index.mjs

@@ -1221,6 +1221,8 @@ function emitLikeC4SourceFromSingleState(state) {
 /**
 * Convert DrawIO XML to LikeC4 source (.c4) string.
 * Vertices → model elements (actor/container); edges → relations (->). Uses first diagram only.
+* Preserves likec4Id / likec4RelationId from leanix-profile exports when present on cells.
+*
 * @param xml - Full .drawio mxfile XML (single or multi-tab).
 * @returns LikeC4 .c4 source string (model + views + round-trip comments).
 */
@@ -1348,6 +1350,8 @@ function emitMultiDiagramModel(lines, merged, rootsFromMap, rootFqns) {
 /**
 * Convert DrawIO XML to LikeC4 source when file has multiple diagrams (tabs).
 * Merges elements by FQN and relations by (source, target); one view per diagram.
+* Same leanix bridge style fields as parseDrawioToLikeC4 when present.
+*
 * @param xml - Full .drawio mxfile XML with multiple <diagram> elements.
 * @returns LikeC4 .c4 source string (model + views + round-trip comments).
 */
@@ -1762,7 +1766,7 @@ function buildLikec4StyleForNode(params) {
 	pushStylePart(parts, "likec4Notation", params.nodeNotation ?? void 0);
 	return parts.length > 0 ? parts.join(";") + ";" : "";
 }
-/** Bridge-managed style parts for profile 'leanix': likec4Id, likec4Kind, likec4ViewId, likec4ProjectId, bridgeManaged, optional leanixFactSheetType. */
+/** Bridge-managed style for leanix profile (vertex): likec4Id, likec4Kind, likec4ViewId, projectId, leanixFactSheetType. */
 function buildBridgeManagedStyleForNode(nodeId, nodeKind, viewId, options) {
 	if (options?.profile !== "leanix") return "";
 	const parts = [
@@ -1776,7 +1780,7 @@ function buildBridgeManagedStyleForNode(nodeId, nodeKind, viewId, options) {
 	if (factSheetType != null && factSheetType !== "") parts.push(`leanixFactSheetType=${encodeURIComponent(factSheetType)}`);
 	return parts.join(";") + ";";
 }
-/** Bridge-managed style parts for edge when profile is 'leanix': likec4RelationId, bridgeManaged. */
+/** Bridge-managed style for leanix profile (edge): likec4RelationId, bridgeManaged. */
 function buildBridgeManagedStyleForEdge(relationId, options) {
 	if (options?.profile !== "leanix") return "";
 	return `bridgeManaged=true;likec4RelationId=${encodeURIComponent(relationId)};`;
@@ -1996,7 +2000,7 @@ function getViewDescriptionString(view) {
 	if (typeof raw === "string") return raw;
 	return "";
 }
-/** Returns draw.io style tokens for the leanix profile (bridgeManaged, likec4ViewId, likec4ProjectId). Each token ends with ";". */
+/** Root-cell style tokens for leanix profile (bridgeManaged, likec4ViewId, likec4ProjectId). */
 function getLeanixRootStyleParts(view, options) {
 	const parts = ["bridgeManaged=true;", `likec4ViewId=${encodeURIComponent(view.id)};`];
 	if (options.projectId != null && options.projectId !== "") parts.push(`likec4ProjectId=${encodeURIComponent(options.projectId)};`);
@@ -2258,7 +2262,7 @@ ${diagrams.map((d) => `  <diagram name="${escapeXml(d.name)}" id="${DRAWIO_DIAGR
 * Generate a single DrawIO file from one view.
 *
 * @param viewmodel - Layouted LikeC4 view model (from model.view(id))
-* @param options - Optional overrides for layout/colors (round-trip from comment blocks)
+* @param options - Optional overrides for layout/colors (round-trip from comment blocks); profile `leanix` adds bridge-managed metadata for LeanIX (see GenerateDrawioOptions).
 * @returns DrawIO .drawio XML string
 */
 function generateDrawio(viewmodel, options) {
@@ -2270,7 +2274,7 @@ function generateDrawio(viewmodel, options) {
 * so all views open in one file with one tab per view.
 *
 * @param viewmodels - Layouted view models (e.g. from model.views())
-* @param optionsByViewId - Optional per-view options (e.g. compressed: false for each tab)
+* @param optionsByViewId - Optional per-view options (layout, compressed, profile leanix, etc.)
 * @param modified - Optional ISO timestamp for mxfile modified attribute (for deterministic output)
 * @returns DrawIO .drawio XML string with multiple <diagram> elements
 */