@likec4/generators 1.55.1 → 1.57.0

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,
@@ -25,13 +26,13 @@ var base_exports = /* @__PURE__ */ __exportAll({
 	lazy: () => lazy,
 	lines: () => lines,
 	markdown: () => markdown,
-	markdownOrString: () => markdownOrString$1,
+	markdownOrString: () => markdownOrString,
 	materialize: () => materialize,
 	merge: () => merge,
 	newline: () => newline,
 	noop: () => noop,
 	operation: () => operation,
-	print: () => print$1,
+	print: () => print,
 	printProperty: () => printProperty,
 	property: () => property,
 	select: () => select,
@@ -103,7 +104,7 @@ function operation(opOrName, fn) {
 function isPrintable(value) {
 	return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
 }
-function print$1(value) {
+function print(value) {
 	return operation(function printOp({ ctx, out }) {
 		let v = typeof value === "function" ? value(ctx) : value ?? ctx;
 		if (isNullish(v) || v === "") return;
@@ -111,8 +112,8 @@ function print$1(value) {
 		out.append(String(v));
 	});
 }
-const eq = () => print$1("=");
-const space = () => print$1(" ");
+const eq = () => print("=");
+const space = () => print(" ");
 function noop() {
 	return identity();
 }
@@ -178,7 +179,7 @@ function body(...args) {
 	return body("{", "}")(...ops);
 }
 const QUOTE = "'";
-const ESCAPED_QUOTE = "\\" + QUOTE;
+const ESCAPED_QUOTE = "\\'";
 function inlineText(value) {
 	return operation(({ ctx, out }) => {
 		let v = value ?? ctx;
@@ -189,7 +190,7 @@ function inlineText(value) {
 	});
 }
 function multilineText(value, quotes = QUOTE) {
-	return merge(print$1(quotes), indent(value.replaceAll(QUOTE, ESCAPED_QUOTE)), print$1(quotes));
+	return merge(print(quotes), indent(value.replaceAll(QUOTE, ESCAPED_QUOTE)), print(quotes));
 }
 function text(value) {
 	return operation(function text({ ctx, out }) {
@@ -215,7 +216,7 @@ function markdown(value) {
 		return multilineText(v, TRIPLE_QUOTE)(ctx);
 	});
 }
-function markdownOrString$1(value) {
+function markdownOrString(value) {
 	return operation(function markdownOrString(ctx) {
 		let v = value ?? ctx.ctx;
 		if (isNullish(v)) return;
@@ -354,7 +355,7 @@ function property(propertyName, op) {
 * ```
 */
 function printProperty(propertyName) {
-	return property(propertyName, print$1());
+	return property(propertyName, print());
 }
 function foreach(...args) {
 	const [arg1, arg2] = args;
@@ -527,6 +528,8 @@ function zodOp(schema) {
 		};
 	};
 }
+//#endregion
+//#region src/likec4/schemas/common.ts
 var common_exports = /* @__PURE__ */ __exportAll({
 	arrow: () => arrow,
 	border: () => border,
@@ -540,7 +543,7 @@ var common_exports = /* @__PURE__ */ __exportAll({
 	line: () => line,
 	link: () => link,
 	links: () => links,
-	markdownOrString: () => markdownOrString,
+	markdownOrString: () => markdownOrString$1,
 	metadata: () => metadata,
 	metadataValue: () => metadataValue$1,
 	opacity: () => opacity,
@@ -578,7 +581,7 @@ const themeColor = z$1.literal(ThemeColors);
 const customColor = z$1.custom().refine((v) => typeof v === "string", "Custom color name must be a string").transform((value) => value);
 const tag = z$1.string().nonempty("Tag cannot be empty").transform((tag) => tag.startsWith("#") ? tag.slice(1) : tag);
 const tags = z$1.array(tag).readonly();
-const markdownOrString = z$1.union([
+const markdownOrString$1 = z$1.union([
 	z$1.string(),
 	z$1.strictObject({ md: z$1.string() }),
 	z$1.strictObject({ txt: z$1.string() })
@@ -607,13 +610,15 @@ const metadata = z$1.record(z$1.string(), metadataValue$1.or(z$1.array(metadataV
 const props = z$1.object({
 	tags: tags.nullable(),
 	title: z$1.string(),
-	summary: markdownOrString.nullable(),
-	description: markdownOrString.nullable(),
+	summary: markdownOrString$1.nullable(),
+	description: markdownOrString$1.nullable(),
 	notation: z$1.string().nullable(),
 	technology: z$1.string().nullable(),
 	links: links.nullable(),
 	metadata
 }).partial();
+//#endregion
+//#region src/likec4/schemas/expression.ts
 var expression_exports = /* @__PURE__ */ __exportAll({
 	directRelationExpr: () => directRelationExpr$1,
 	elementKindExpr: () => elementKindExpr,
@@ -732,10 +737,10 @@ const fqnExprOrWhere$1 = z$1.union([fqnExpr$1, fqnExprWhere]);
 */
 const commonCustomProperties = z$1.object({
 	title: z$1.string(),
-	description: markdownOrString,
+	description: markdownOrString$1,
 	technology: z$1.string(),
 	notation: z$1.string(),
-	notes: markdownOrString,
+	notes: markdownOrString$1,
 	navigateTo: viewId,
 	color
 });
@@ -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,
@@ -921,8 +947,8 @@ var specification_exports$1 = /* @__PURE__ */ __exportAll({
 const element$1 = z$1.object({
 	tags: tags.nullable(),
 	title: z$1.string().nullable(),
-	summary: markdownOrString.nullable(),
-	description: markdownOrString.nullable(),
+	summary: markdownOrString$1.nullable(),
+	description: markdownOrString$1.nullable(),
 	technology: z$1.string().nullable(),
 	notation: z$1.string().nullable(),
 	links: links.nullable(),
@@ -942,16 +968,32 @@ 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,
 	deploymentView: () => deploymentView$1,
 	deploymentViewRule: () => deploymentViewRule$1,
+	deploymentViewRuleIncludeAncestors: () => deploymentViewRuleIncludeAncestors$1,
 	dynamicStep: () => dynamicStep$1,
 	dynamicStepsParallel: () => dynamicStepsParallel$1,
 	dynamicStepsSeries: () => dynamicStepsSeries$1,
@@ -984,6 +1026,7 @@ const viewRuleAutoLayout$1 = z$1.object({
 	nodeSep: z$1.number().optional(),
 	rankSep: z$1.number().optional()
 }).transform((v) => v);
+const deploymentViewRuleIncludeAncestors$1 = z$1.strictObject({ includeAncestors: z$1.boolean() });
 const viewRuleInclude = z$1.strictObject({ include: z$1.array(expression$1) });
 const viewRuleExclude = z$1.strictObject({ exclude: z$1.array(expression$1) });
 const viewRulePredicate$1 = z$1.union([viewRuleInclude, viewRuleExclude]).transform((v) => v);
@@ -1029,7 +1072,7 @@ const viewProps = z$1.object({
 	id: viewId,
 	_stage: z$1.literal("parsed").default("parsed"),
 	title: z$1.string().nullish(),
-	description: markdownOrString.nullish(),
+	description: markdownOrString$1.nullish(),
 	tags: tags.nullish(),
 	links: links.nullish()
 });
@@ -1048,7 +1091,8 @@ const deploymentViewRule$1 = z$1.union([
 	viewRuleAutoLayout$1,
 	viewRuleStyle$1,
 	viewRuleGlobalStyle$1,
-	viewRuleGlobalPredicate$1
+	viewRuleGlobalPredicate$1,
+	deploymentViewRuleIncludeAncestors$1
 ]);
 /**
 * Replicates ParsedElementView from the core,
@@ -1063,10 +1107,10 @@ const dynamicStep$1 = z$1.object({
 	target: fqn,
 	title: z$1.string().nullish().default(null),
 	kind: z$1.string().nullish(),
-	description: markdownOrString.nullish(),
+	description: markdownOrString$1.nullish(),
 	technology: z$1.string().nullish(),
 	notation: z$1.string().nullish(),
-	notes: markdownOrString.nullish(),
+	notes: markdownOrString$1.nullish(),
 	color: color.optional(),
 	line: line.optional(),
 	head: arrow.optional(),
@@ -1150,6 +1194,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 +1205,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,
@@ -1183,27 +1231,27 @@ var properties_exports = /* @__PURE__ */ __exportAll({
 * Print a property from the context as a text.
 */
 function textProperty(propertyName, keyword) {
-	return select((e) => e[propertyName], spaceBetween(print$1(keyword ?? propertyName), text()));
+	return select((e) => e[propertyName], spaceBetween(print(keyword ?? propertyName), text()));
 }
 /**
 * Print a property from the context as a markdown string.
 */
 function markdownProperty(propertyName, keyword) {
-	return select((e) => e[propertyName], spaceBetween(print$1(keyword ?? propertyName), markdownOrString$1()));
-}
-const titleProperty = () => property("title", spaceBetween(print$1("title"), text()));
-const summaryProperty = () => property("summary", spaceBetween(print$1("summary"), markdownOrString$1()));
-const descriptionProperty = () => property("description", spaceBetween(print$1("description"), markdownOrString$1()));
-const notesProperty = () => property("notes", spaceBetween(print$1("notes"), markdownOrString$1()));
-const technologyProperty = () => property("technology", spaceBetween(print$1("technology"), text()));
-const notationProperty = () => property("notation", spaceBetween(print$1("notation"), text()));
+	return select((e) => e[propertyName], spaceBetween(print(keyword ?? propertyName), markdownOrString()));
+}
+const titleProperty = () => property("title", spaceBetween(print("title"), text()));
+const summaryProperty = () => property("summary", spaceBetween(print("summary"), markdownOrString()));
+const descriptionProperty = () => property("description", spaceBetween(print("description"), markdownOrString()));
+const notesProperty = () => property("notes", spaceBetween(print("notes"), markdownOrString()));
+const technologyProperty = () => property("technology", spaceBetween(print("technology"), text()));
+const notationProperty = () => property("notation", spaceBetween(print("notation"), text()));
 function printMetadataValue() {
 	return operation(({ ctx, out }) => {
 		if (isString(ctx)) return text()({
 			ctx,
 			out
 		});
-		return print$1()({
+		return print()({
 			ctx,
 			out
 		});
@@ -1217,28 +1265,30 @@ function metadataValue() {
 		}
 	}))));
 }
-const metadataProperty = () => select((e) => e.metadata ? entries(e.metadata) : void 0, body("metadata")(foreach(spaceBetween(print$1((v) => v[0]), property("1", metadataValue())), separateNewLine())));
-const tagsProperty = () => property("tags", print$1((v) => v.map((t) => `#${t}`).join(", ")));
+const metadataProperty = () => select((e) => e.metadata ? entries(e.metadata) : void 0, body("metadata")(foreach(spaceBetween(print((v) => v[0]), property("1", metadataValue())), separateNewLine())));
+const tagsProperty = () => property("tags", print((v) => v.map((t) => `#${t}`).join(", ")));
 function linkProperty() {
 	return spaceBetween(select((l) => typeof l === "string" ? { url: l } : exact({
 		url: l.url,
 		title: l.title
-	}), print$1("link"), print$1((v) => v.url), property("title", inlineText())));
+	}), print("link"), print((v) => v.url), property("title", inlineText())));
 }
 const linksProperty = () => property("links", foreachNewLine(linkProperty()));
 function styleBlockProperty() {
 	return select((e) => e.style, body("style")(styleProperties()));
 }
 function colorProperty() {
-	return property("color", spaceBetween(print$1("color"), print$1()));
+	return property("color", spaceBetween(print("color"), print()));
 }
 function opacityProperty() {
-	return property("opacity", spaceBetween(print$1("opacity"), print$1((v) => `${v}%`)));
+	return property("opacity", spaceBetween(print("opacity"), print((v) => `${v}%`)));
 }
 function iconProperty() {
-	return property("icon", spaceBetween(print$1("icon"), print$1()));
+	return property("icon", spaceBetween(print("icon"), print()));
 }
 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,
@@ -1298,7 +1348,7 @@ const whereMetadataEqual = zodOp(whereMetadata)(function whereMetadataEqualOp({
 	if ("neq" in value) return out.append(`metadata.${key} is not ${quoteMetadataValue(value.neq)}`);
 	nonexhaustive(value);
 });
-const whereNot = zodOp(whereNot$1)(property("not", spaceBetween(print$1("not ("), lazy(() => whereOperator()), print$1(")"))));
+const whereNot = zodOp(whereNot$1)(property("not", spaceBetween(print("not ("), lazy(() => whereOperator()), print(")"))));
 const whereParticipant = zodOp(whereParticipant$1)(function whereParticipantOp({ ctx: { participant, operator }, out }) {
 	out.append(participant, ".");
 	if ("tag" in operator) {
@@ -1390,7 +1440,7 @@ const fqnExprCustom = zodOp(fqnExprCustom$1)(({ ctx: { custom }, exec }) => {
 const fqnExprOrWhere = zodOp(fqnExprOrWhere$1)(({ ctx, exec }) => {
 	if ("where" in ctx) {
 		exec(ctx.where.expr, fqnExpr());
-		exec(ctx.where.condition, indent(print$1("where"), indent(whereOperator())));
+		exec(ctx.where.condition, indent(print("where"), indent(whereOperator())));
 		return;
 	}
 	exec(ctx, fqnExpr());
@@ -1405,10 +1455,10 @@ const fqnExprAny = zodOp(fqnExprAny$1)(({ ctx, out }) => {
 		out
 	});
 });
-const directRelationExpr = zodOp(directRelationExpr$1)(merge(property("source", fqnExpr()), print$1((v) => v.isBidirectional ? " <-> " : " -> "), property("target", fqnExpr())));
-const incomingRelationExpr = zodOp(incomingRelationExpr$1)(merge(print$1("-> "), property("incoming", fqnExpr())));
-const outgoingRelationExpr = zodOp(outgoingRelationExpr$1)(merge(property("outgoing", fqnExpr()), print$1(" ->")));
-const inOutRelationExpr = zodOp(inoutRelationExpr)(merge(print$1("-> "), property("inout", fqnExpr()), print$1(" ->")));
+const directRelationExpr = zodOp(directRelationExpr$1)(merge(property("source", fqnExpr()), print((v) => v.isBidirectional ? " <-> " : " -> "), property("target", fqnExpr())));
+const incomingRelationExpr = zodOp(incomingRelationExpr$1)(merge(print("-> "), property("incoming", fqnExpr())));
+const outgoingRelationExpr = zodOp(outgoingRelationExpr$1)(merge(property("outgoing", fqnExpr()), print(" ->")));
+const inOutRelationExpr = zodOp(inoutRelationExpr)(merge(print("-> "), property("inout", fqnExpr()), print(" ->")));
 const relationExpr = zodOp(relationExpr$1)(({ ctx, exec }) => {
 	if ("source" in ctx) return exec(ctx, directRelationExpr());
 	if ("incoming" in ctx) return exec(ctx, incomingRelationExpr());
@@ -1417,7 +1467,7 @@ const relationExpr = zodOp(relationExpr$1)(({ ctx, exec }) => {
 	nonexhaustive(ctx);
 });
 const relationExprOrWhere = zodOp(relationExprOrWhere$1)(({ ctx, out }) => {
-	if ("where" in ctx) return merge(withctx(ctx.where.expr)(relationExpr()), indent(print$1("where"), indent(withctx(ctx.where.condition)(whereOperator()))))({
+	if ("where" in ctx) return merge(withctx(ctx.where.expr)(relationExpr()), indent(print("where"), indent(withctx(ctx.where.condition)(whereOperator()))))({
 		ctx,
 		out
 	});
@@ -1454,6 +1504,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,
@@ -1490,7 +1542,7 @@ function hasElementProps$1(el) {
 	return !!(el.description || el.summary || el.technology || el.notation || el.tags && el.tags.length > 0 || el.links && el.links.length > 0 || !isEmptyish(el.metadata) || hasStyleProps$1(el));
 }
 const elementProperties$1 = zodOp(schemas.deployment.element)(lines(tagsProperty(), technologyProperty(), summaryProperty(), descriptionProperty(), linksProperty(), metadataProperty(), select((e) => hasStyleProps$1(e) ? e.style : void 0, body("style")(styleProperties()))));
-const instance = zodOp(schemas.deployment.instance)(spaceBetween(when((v) => nameFromFqn(v.id) !== nameFromFqn(v.element), print$1((v) => nameFromFqn(v.id)), print$1(" =")), print$1("instanceOf"), printProperty("element"), when((v) => !!v.title && v.title !== nameFromFqn(v.id), property("title", inlineText())), when((e) => hasElementProps$1(e), body(elementProperties$1()))));
+const instance = zodOp(schemas.deployment.instance)(spaceBetween(when((v) => nameFromFqn(v.id) !== nameFromFqn(v.element), print((v) => nameFromFqn(v.id)), print(" =")), print("instanceOf"), printProperty("element"), when((v) => !!v.title && v.title !== nameFromFqn(v.id), property("title", inlineText())), when((e) => hasElementProps$1(e), body(elementProperties$1()))));
 function node() {
 	return function nodeOp({ ctx, out }) {
 		const el = ctx;
@@ -1508,9 +1560,9 @@ function node() {
 		const needsBody = el.children.length > 0 || hasElementProps$1(el);
 		const name = nameFromFqn(el.id);
 		const inline = [
-			print$1(name),
-			print$1("="),
-			print$1(el.kind)
+			print(name),
+			print("="),
+			print(el.kind)
 		];
 		if (el.title && el.title !== name) inline.push(inlineText(el.title));
 		if (needsBody) inline.push(body(lines(2)(withctx(el, elementProperties$1()), ...el.children.map((node) => withctx(node, nodeOp)))));
@@ -1526,8 +1578,10 @@ function hasRelationStyle$1(rel) {
 function hasRelationProps$1(rel) {
 	return !!(rel.description || rel.summary || rel.technology || rel.tags && rel.tags.length > 0 || rel.links && rel.links.length > 0 || !isEmptyish(rel.metadata) || hasRelationStyle$1(rel) || rel.navigateTo);
 }
-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 relationship$1 = zodOp(schemas.deployment.relationship)(spaceBetween(property("source", fqnRef()), print((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,
@@ -1567,9 +1621,9 @@ function elementTree() {
 		const needsBody = (ctx.children?.length ?? 0) > 0 || hasElementProps(el);
 		const name = nameFromFqn(el.id);
 		const inline = [
-			print$1(name),
-			print$1("="),
-			print$1(el.kind)
+			print(name),
+			print("="),
+			print(el.kind)
 		];
 		if (el.title && el.title !== name) inline.push(inlineText(el.title));
 		if (needsBody) inline.push(body(lines(2)(withctx(el, elementProperties()), ...(ctx.children ?? []).map((node) => withctx(node, elementTree())))));
@@ -1585,23 +1639,28 @@ function hasRelationStyle(rel) {
 function hasRelationProps(rel) {
 	return !!(rel.description || rel.summary || rel.technology || rel.tags && rel.tags.length > 0 || rel.links && rel.links.length > 0 || !isEmptyish(rel.metadata) || hasRelationStyle(rel) || rel.navigateTo);
 }
-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 relationship = zodOp(schemas.model.relationship)(spaceBetween(property("source", fqnRef()), print((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,
 	specification: () => specification,
 	tagSpecification: () => tagSpecification
 });
-const tagSpecification = zodOp(z$1.tuple([z$1.string(), tagSpec]))(spaceBetween(print$1("tag"), printProperty("0"), property("1", property("color", body(spaceBetween(print$1("color"), print$1()))))));
-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 tagSpecification = zodOp(z$1.tuple([z$1.string(), tagSpec]))(spaceBetween(print("tag"), printProperty("0"), property("1", property("color", body(spaceBetween(print("color"), print()))))));
+const elementKind = (keyword) => zodOp(z$1.tuple([z$1.string(), element$1]))(spaceBetween(print(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("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,
 	deploymentViewRule: () => deploymentViewRule,
+	deploymentViewRuleIncludeAncestors: () => deploymentViewRuleIncludeAncestors,
 	dynamicStep: () => dynamicStep,
 	dynamicStepsParallel: () => dynamicStepsParallel,
 	dynamicStepsSeries: () => dynamicStepsSeries,
@@ -1620,7 +1679,7 @@ var views_exports = /* @__PURE__ */ __exportAll({
 	viewRuleStyle: () => viewRuleStyle,
 	views: () => views
 });
-const viewTitleProperty = () => property("title", spaceBetween(print$1("title"), inlineText()));
+const viewTitleProperty = () => property("title", spaceBetween(print("title"), inlineText()));
 const viewRulePredicate = zodOp(schemas.views.viewRulePredicate)(({ ctx, exec }) => {
 	let exprs;
 	let type;
@@ -1635,9 +1694,9 @@ const viewRulePredicate = zodOp(schemas.views.viewRulePredicate)(({ ctx, exec })
 	if (!hasAtLeast(exprs, 1)) return;
 	const isMultiple = hasAtLeast(exprs, 2);
 	const exprOp = withctx(exprs)(foreach(expression(), separateComma(isMultiple)));
-	exec(ctx, merge(print$1(type), ...isMultiple ? [indent(exprOp)] : [space(), exprOp]));
+	exec(ctx, merge(print(type), ...isMultiple ? [indent(exprOp)] : [space(), exprOp]));
 });
-const viewRuleStyle = zodOp(schemas.views.viewRuleStyle)(spaceBetween(print$1("style"), property("targets", foreach(expression(), separateComma())), body("{", "}")(notationProperty(), property("style", styleProperties()))));
+const viewRuleStyle = zodOp(schemas.views.viewRuleStyle)(spaceBetween(print("style"), property("targets", foreach(expression(), separateComma())), body("{", "}")(notationProperty(), property("style", styleProperties()))));
 const viewRuleGroup = zodOp(schemas.views.viewRuleGroup)(({ ctx, exec }) => {
 	throw new Error("not implemented");
 });
@@ -1653,7 +1712,8 @@ const mapping = {
 	"LR": "LeftRight",
 	"RL": "RightLeft"
 };
-const viewRuleAutoLayout = zodOp(schemas.views.viewRuleAutoLayout)(spaceBetween(print$1("autoLayout"), property("direction", print$1((v) => mapping[v])), guard(hasProp("rankSep"), spaceBetween(printProperty("rankSep"), printProperty("nodeSep")))));
+const viewRuleAutoLayout = zodOp(schemas.views.viewRuleAutoLayout)(spaceBetween(print("autoLayout"), property("direction", print((v) => mapping[v])), guard(hasProp("rankSep"), spaceBetween(printProperty("rankSep"), printProperty("nodeSep")))));
+const deploymentViewRuleIncludeAncestors = zodOp(schemas.views.deploymentViewRuleIncludeAncestors)(spaceBetween(print("includeAncestors"), printProperty("includeAncestors")));
 const viewRuleRank = zodOp(schemas.views.viewRuleRank)(({ ctx, exec }) => {
 	throw new Error("not implemented");
 });
@@ -1667,17 +1727,18 @@ const elementViewRule = zodOp(schemas.views.elementViewRule)(({ ctx, exec }) =>
 	if ("targets" in ctx && "style" in ctx) return exec(ctx, viewRuleStyle());
 	nonexhaustive(ctx);
 });
-const elementView = zodOp(schemas.views.elementView.partial({ _type: true }))(spaceBetween(print$1("view"), print$1((v) => v.id), property("viewOf", spaceBetween(print$1("of"), print$1())), body(lines(2)(lines(tagsProperty(), viewTitleProperty(), descriptionProperty(), linksProperty()), property("rules", foreachNewLine(elementViewRule()))))));
+const elementView = zodOp(schemas.views.elementView.partial({ _type: true }))(spaceBetween(print("view"), print((v) => v.id), property("viewOf", spaceBetween(print("of"), print())), body(lines(2)(lines(tagsProperty(), viewTitleProperty(), descriptionProperty(), linksProperty()), property("rules", foreachNewLine(elementViewRule()))))));
 const deploymentViewRule = zodOp(schemas.views.deploymentViewRule)(({ ctx, exec }) => {
 	if ("include" in ctx || "exclude" in ctx) return exec(ctx, viewRulePredicate());
+	if ("includeAncestors" in ctx) return exec(ctx, deploymentViewRuleIncludeAncestors());
 	if ("direction" in ctx) return exec(ctx, viewRuleAutoLayout());
 	if ("styleId" in ctx) return exec(ctx, viewRuleGlobalStyle());
 	if ("predicateId" in ctx) return exec(ctx, viewRuleGlobalPredicate());
 	if ("targets" in ctx && "style" in ctx) return exec(ctx, viewRuleStyle());
 	nonexhaustive(ctx);
 });
-const deploymentView = zodOp(schemas.views.deploymentView.partial({ _type: true }))(spaceBetween(print$1("deployment view"), print$1((v) => v.id), body(lines(2)(lines(tagsProperty(), viewTitleProperty(), descriptionProperty(), linksProperty()), property("rules", foreachNewLine(deploymentViewRule()))))));
-const dynamicStep = zodOp(schemas.views.dynamicStep)(spaceBetween(print$1((v) => v.source), print$1((v) => v.isBackward ? "<-" : "->"), print$1((v) => v.target), body(lines(titleProperty(), technologyProperty(), descriptionProperty(), notesProperty(), property("navigateTo"), notationProperty(), colorProperty(), property("line"), property("head"), property("tail")))));
+const deploymentView = zodOp(schemas.views.deploymentView.partial({ _type: true }))(spaceBetween(print("deployment view"), print((v) => v.id), body(lines(2)(lines(tagsProperty(), viewTitleProperty(), descriptionProperty(), linksProperty()), property("rules", foreachNewLine(deploymentViewRule()))))));
+const dynamicStep = zodOp(schemas.views.dynamicStep)(spaceBetween(print((v) => v.source), print((v) => v.isBackward ? "<-" : "->"), print((v) => v.target), body(lines(titleProperty(), technologyProperty(), descriptionProperty(), notesProperty(), property("navigateTo"), notationProperty(), colorProperty(), property("line"), property("head"), property("tail")))));
 const dynamicStepsSeries = zodOp(schemas.views.dynamicStepsSeries)(({ ctx, exec }) => {
 	throw new Error("Not implemented");
 });
@@ -1693,7 +1754,7 @@ const dynamicViewIncludeRule = zodOp(schemas.views.dynamicViewIncludeRule)(({ ct
 	if (!hasAtLeast(ctx.include, 1)) return;
 	const isMultiple = hasAtLeast(ctx.include, 2);
 	const exprOp = withctx(ctx.include)(foreach(expression(), separateComma(isMultiple)));
-	exec(ctx, merge(print$1("include"), ...isMultiple ? [indent(exprOp)] : [space(), exprOp]));
+	exec(ctx, merge(print("include"), ...isMultiple ? [indent(exprOp)] : [space(), exprOp]));
 });
 const dynamicViewRule = zodOp(schemas.views.dynamicViewRule)(({ ctx, exec }) => {
 	if ("include" in ctx) return exec(ctx, dynamicViewIncludeRule());
@@ -1703,7 +1764,7 @@ const dynamicViewRule = zodOp(schemas.views.dynamicViewRule)(({ ctx, exec }) =>
 	if ("direction" in ctx) return exec(ctx, viewRuleAutoLayout());
 	nonexhaustive(ctx);
 });
-const dynamicView = zodOp(schemas.views.dynamicView.partial({ _type: true }))(spaceBetween(print$1("dynamic view"), print$1((v) => v.id), body(lines(2)(lines(tagsProperty(), viewTitleProperty(), descriptionProperty(), linksProperty(), property("variant")), property("steps", foreachNewLine(dynamicViewStep())), property("rules", foreachNewLine(dynamicViewRule()))))));
+const dynamicView = zodOp(schemas.views.dynamicView.partial({ _type: true }))(spaceBetween(print("dynamic view"), print((v) => v.id), body(lines(2)(lines(tagsProperty(), viewTitleProperty(), descriptionProperty(), linksProperty(), property("variant")), property("steps", foreachNewLine(dynamicViewStep())), property("rules", foreachNewLine(dynamicViewRule()))))));
 const anyView = zodOp(schemas.views.anyView)(({ ctx, exec }) => {
 	if ("_type" in ctx) {
 		if (ctx._type == "element") return exec(ctx, elementView());
@@ -1716,8 +1777,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 +1800,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,
@@ -1742,57 +1809,11 @@ function generateLikeC4(input, params) {
 	};
 	return materialize(withctx(input, likec4data()), params.indentation);
 }
-/**
-* Prints the result of an operation with the data
-*
-* @see operators
-*
-* @example
-* ```ts
-* print(operators.expression, {
-*   ref: {
-*     model: 'some.el',
-*   },
-*   selector: 'descendants',
-* })
-* // "some.el.**"
-* ```
-*
-* @example
-* ```ts
-* print(operators.model, {
-*   elements: [
-*     {
-*       id: 'cloud',
-*       kind: 'system',
-*     },
-*     {
-*       id: 'cloud.mobile',
-*       kind: 'mobileapp',
-*       shape: 'mobile',
-*       color: 'amber',
-*     }
-*   ],
-* })
-* // model {
-* //   cloud = system {
-* //     mobile = mobileapp {
-* //       style {
-* //         shape mobile
-* //         color amber
-* //       }
-* //     }
-* //   }
-* // }
-* ```
-*/
-function print(operator, data, params) {
-	return materialize(withctx(data, operator()), params?.indentation);
+function printOperation(operation, data, params) {
+	return materialize(withctx(data ?? {}, operation), params?.indentation);
 }
-/**
-* Same as {@link print} but uses tab indentation
-*/
-function printTabIndent(operator, data) {
-	return materialize(withctx(data, operator()), "	");
+function printWithTabIndent(operation, data) {
+	return materialize(withctx(data ?? {}, operation), "	");
 }
-export { generateLikeC4 as generate, operators_exports as operators, print, printTabIndent };
+//#endregion
+export { body, eachOnFresh, eq, executeOnCtx, executeOnFresh, foreach, foreachNewLine, fresh, generateLikeC4 as generate, guard, indent, inlineText, join, lazy, lines, markdown, markdownOrString, materialize, merge, newline, noop, operation, operators_exports as ops, print, printOperation, printProperty, printWithTabIndent, property, select, separateComma, separateNewLine, separateWith, space, spaceBetween, text, when, withctx, zodOp };