likec4 1.40.0 → 1.41.0

package/dist/vite-plugin/index.d.mts

@@ -1,4 +1,4 @@
-import { L as LikeC4LanguageServices } from '../shared/likec4.DDO3vjMr.mjs';
+import { L as LikeC4LanguageServices } from '../shared/likec4.3AlS7pfZ.mjs';
 import '@likec4/core';
 import 'type-fest';
 import '../shared/likec4.DX1wM3Or.mjs';

package/dist/vite-plugin/index.mjs

@@ -1 +1 @@
-export{L as LikeC4VitePlugin}from"../shared/likec4.P9UC3Wd_.mjs";
+export{L as LikeC4VitePlugin}from"../shared/likec4.Db3cTW-C.mjs";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "likec4",
   "description": "Toolchain for your architecture diagrams",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "license": "MIT",
   "homepage": "https://likec4.dev",
   "author": "Denis Davydkov <denis@davydkov.com>",
@@ -112,7 +112,7 @@
     "vite": "^6.3.6",
     "std-env": "^3.9.0",
     "yargs": "17.7.2",
-    "@likec4/core": "1.40.0"
+    "@likec4/core": "1.41.0"
   },
   "peerDependencies": {
     "react": "^18.x || ^19.x",
@@ -190,16 +190,16 @@
     "vscode-uri": "3.1.0",
     "which": "^5.0.0",
     "wireit": "0.14.12",
-    "@likec4/diagram": "1.40.0",
-    "@likec4/icons": "1.40.0",
-    "@likec4/generators": "1.40.0",
-    "@likec4/language-server": "1.40.0",
-    "@likec4/config": "1.40.0",
-    "@likec4/log": "1.40.0",
-    "@likec4/layouts": "1.40.0",
-    "@likec4/style-preset": "1.40.0",
-    "@likec4/tsconfig": "1.40.0",
-    "@likec4/styles": "1.40.0"
+    "@likec4/diagram": "1.41.0",
+    "@likec4/generators": "1.41.0",
+    "@likec4/language-server": "1.41.0",
+    "@likec4/icons": "1.41.0",
+    "@likec4/layouts": "1.41.0",
+    "@likec4/config": "1.41.0",
+    "@likec4/log": "1.41.0",
+    "@likec4/style-preset": "1.41.0",
+    "@likec4/styles": "1.41.0",
+    "@likec4/tsconfig": "1.41.0"
   },
   "scripts": {
     "typecheck": "tsc --build --verbose",

package/react/index.d.mts

@@ -1573,6 +1573,13 @@ export type StrictTag<A> = A extends infer T extends Any ? Tag$1<Tag$2<T>> : nev
 export type StrictElementKind<A> = A extends infer T extends Any ? ElementKind<ElementKind$1<T>> : never;
 export type StrictDeploymentKind<A> = A extends infer T extends Any ? DeploymentKind<DeploymentKind$1<T>> : never;
 export type StrictRelationKind<A> = A extends infer T extends Any ? RelationshipKind<RelationKind<T>> : never;
+export type WithDescriptionAndTech = {
+	readonly summary?: MarkdownOrString | null;
+	readonly description?: MarkdownOrString | null;
+	readonly technology?: string | null;
+};
+declare function preferSummary(a: WithDescriptionAndTech): MarkdownOrString | null | undefined;
+declare function preferDescription(a: WithDescriptionAndTech): MarkdownOrString | null | undefined;
 export type WithTags<A extends Any> = {
 	readonly tags: Tags<A>;
 };
@@ -1588,6 +1595,9 @@ export type WithOptionalLinks = {
 export type WithMetadata<A extends Any> = {
 	readonly metadata?: Metadata<A>;
 };
+export type WithNotation = {
+	readonly notation?: string | null;
+};
 /**
  * @see {@link LiteralUnion} from type-fest (https://github.com/sindresorhus/type-fest/blob/main/source/literal-union.d.ts)
  */
@@ -1644,18 +1654,22 @@ export type _aux_UnknownComputed = UnknownComputed;
 export type _aux_UnknownLayouted = UnknownLayouted;
 export type _aux_UnknownParsed = UnknownParsed;
 export type _aux_ViewId<A> = ViewId$1<A>;
+export type _aux_WithDescriptionAndTech = WithDescriptionAndTech;
 export type _aux_WithLinks = WithLinks;
 export type _aux_WithMetadata<A extends Any> = WithMetadata<A>;
+export type _aux_WithNotation = WithNotation;
 export type _aux_WithOptionalLinks = WithOptionalLinks;
 export type _aux_WithOptionalTags<A extends Any> = WithOptionalTags<A>;
 export type _aux_WithTags<A extends Any> = WithTags<A>;
+declare const _aux_preferDescription: typeof preferDescription;
+declare const _aux_preferSummary: typeof preferSummary;
 export type _aux_setProject<A, P extends string> = setProject<A, P>;
 export type _aux_setStage<A, S extends ModelStage> = setStage<A, S>;
 export type _aux_toComputed<A> = toComputed<A>;
 export type _aux_toLayouted<A> = toLayouted<A>;
 export type _aux_toParsed<A> = toParsed<A>;
 declare namespace _aux {
-	export type { _aux_AllKinds as _aux_AllKinds, _aux_Any as _aux_Any, Any as Any, _aux_AnySpec as _aux_AnySpec, _aux_Aux as _aux_Aux, _aux_DeploymentFqn as _aux_DeploymentFqn, _aux_DeploymentId as _aux_DeploymentId, _aux_DeploymentKind as _aux_DeploymentKind, _aux_EdgeId as _aux_EdgeId, _aux_ElementId as _aux_ElementId, _aux_ElementKind as _aux_ElementKind, _aux_Fqn as _aux_Fqn, _aux_LooseDeploymentId as _aux_LooseDeploymentId, _aux_LooseDeploymentKind as _aux_LooseDeploymentKind, _aux_LooseElementId as _aux_LooseElementId, _aux_LooseElementKind as _aux_LooseElementKind, _aux_LooseRelationKind as _aux_LooseRelationKind, _aux_LooseTag as _aux_LooseTag, _aux_LooseTags as _aux_LooseTags, _aux_LooseViewId as _aux_LooseViewId, _aux_Metadata as _aux_Metadata, _aux_MetadataKey as _aux_MetadataKey, _aux_Never as _aux_Never, _aux_NodeId as _aux_NodeId, _aux_OrString as _aux_OrString, _aux_PickByStage as _aux_PickByStage, _aux_ProjectId as _aux_ProjectId, _aux_RelationId as _aux_RelationId, _aux_RelationKind as _aux_RelationKind, _aux_Spec as _aux_Spec, _aux_SpecAux as _aux_SpecAux, _aux_Stage as _aux_Stage, DeploymentFqn$1 as DeploymentFqn$1, _aux_StrictDeploymentKind as _aux_StrictDeploymentKind, _aux_StrictElementKind as _aux_StrictElementKind, Fqn$1 as Fqn$1, _aux_StrictProjectId as _aux_StrictProjectId, _aux_StrictRelationKind as _aux_StrictRelationKind, _aux_StrictTag as _aux_StrictTag, _aux_StrictViewId as _aux_StrictViewId, _aux_Tag as _aux_Tag, _aux_Tags as _aux_Tags, _aux_Unknown as _aux_Unknown, _aux_UnknownComputed as _aux_UnknownComputed, _aux_UnknownLayouted as _aux_UnknownLayouted, _aux_UnknownParsed as _aux_UnknownParsed, _aux_ViewId as _aux_ViewId, _aux_WithLinks as _aux_WithLinks, _aux_WithMetadata as _aux_WithMetadata, _aux_WithOptionalLinks as _aux_WithOptionalLinks, _aux_WithOptionalTags as _aux_WithOptionalTags, _aux_WithTags as _aux_WithTags, _aux_setProject as _aux_setProject, _aux_setStage as _aux_setStage, _aux_toComputed as _aux_toComputed, _aux_toLayouted as _aux_toLayouted, _aux_toParsed as _aux_toParsed };
+	export { type _aux_AllKinds as _aux_AllKinds, type _aux_Any as _aux_Any, type Any as Any, type _aux_AnySpec as _aux_AnySpec, type _aux_Aux as _aux_Aux, type _aux_DeploymentFqn as _aux_DeploymentFqn, type _aux_DeploymentId as _aux_DeploymentId, type _aux_DeploymentKind as _aux_DeploymentKind, type _aux_EdgeId as _aux_EdgeId, type _aux_ElementId as _aux_ElementId, type _aux_ElementKind as _aux_ElementKind, type _aux_Fqn as _aux_Fqn, type _aux_LooseDeploymentId as _aux_LooseDeploymentId, type _aux_LooseDeploymentKind as _aux_LooseDeploymentKind, type _aux_LooseElementId as _aux_LooseElementId, type _aux_LooseElementKind as _aux_LooseElementKind, type _aux_LooseRelationKind as _aux_LooseRelationKind, type _aux_LooseTag as _aux_LooseTag, type _aux_LooseTags as _aux_LooseTags, type _aux_LooseViewId as _aux_LooseViewId, type _aux_Metadata as _aux_Metadata, type _aux_MetadataKey as _aux_MetadataKey, type _aux_Never as _aux_Never, type _aux_NodeId as _aux_NodeId, type _aux_OrString as _aux_OrString, type _aux_PickByStage as _aux_PickByStage, type _aux_ProjectId as _aux_ProjectId, type _aux_RelationId as _aux_RelationId, type _aux_RelationKind as _aux_RelationKind, type _aux_Spec as _aux_Spec, type _aux_SpecAux as _aux_SpecAux, type _aux_Stage as _aux_Stage, type DeploymentFqn$1 as DeploymentFqn$1, type _aux_StrictDeploymentKind as _aux_StrictDeploymentKind, type _aux_StrictElementKind as _aux_StrictElementKind, type Fqn$1 as Fqn$1, type _aux_StrictProjectId as _aux_StrictProjectId, type _aux_StrictRelationKind as _aux_StrictRelationKind, type _aux_StrictTag as _aux_StrictTag, type _aux_StrictViewId as _aux_StrictViewId, type _aux_Tag as _aux_Tag, type _aux_Tags as _aux_Tags, type _aux_Unknown as _aux_Unknown, type _aux_UnknownComputed as _aux_UnknownComputed, type _aux_UnknownLayouted as _aux_UnknownLayouted, type _aux_UnknownParsed as _aux_UnknownParsed, type _aux_ViewId as _aux_ViewId, type _aux_WithDescriptionAndTech as _aux_WithDescriptionAndTech, type _aux_WithLinks as _aux_WithLinks, type _aux_WithMetadata as _aux_WithMetadata, type _aux_WithNotation as _aux_WithNotation, type _aux_WithOptionalLinks as _aux_WithOptionalLinks, type _aux_WithOptionalTags as _aux_WithOptionalTags, type _aux_WithTags as _aux_WithTags, _aux_preferDescription as _aux_preferDescription, _aux_preferSummary as _aux_preferSummary, type _aux_setProject as _aux_setProject, type _aux_setStage as _aux_setStage, type _aux_toComputed as _aux_toComputed, type _aux_toLayouted as _aux_toLayouted, type _aux_toParsed as _aux_toParsed };
 }
 export type AnyAux = Any;
 type Unknown$1 = Unknown;
@@ -2441,35 +2455,24 @@ export interface ElementStyle {
 	readonly padding?: SpacingSize;
 	readonly textSize?: TextSize;
 }
-interface Element$1<A extends Any = Any> extends WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A> {
+interface Element$1<A extends Any = Any> extends WithDescriptionAndTech, WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A>, WithNotation {
 	readonly id: Fqn$1<A>;
 	readonly kind: ElementKind$1<A>;
 	readonly title: string;
-	readonly description?: MarkdownOrString | null;
-	readonly technology?: string | null;
-	readonly tags?: Tags<A> | null;
-	readonly links?: readonly Link[] | null;
 	readonly icon?: Icon;
 	readonly shape?: ElementShape;
 	readonly color?: Color;
 	readonly style?: ElementStyle;
-	readonly notation?: string | null;
-	readonly metadata?: Metadata<A>;
 }
-export interface AbstractRelationship<A extends Any> extends WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A> {
+export interface AbstractRelationship<A extends Any> extends WithDescriptionAndTech, WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A> {
 	readonly id: RelationId;
 	readonly title?: string | null;
-	readonly description?: MarkdownOrString | null;
-	readonly technology?: string | null;
 	readonly kind?: RelationKind<A>;
 	readonly color?: Color;
 	readonly line?: RelationshipLineType;
 	readonly head?: RelationshipArrowType;
 	readonly tail?: RelationshipArrowType;
-	readonly tags?: Tags<A> | null;
-	readonly links?: readonly Link[] | null;
 	readonly navigateTo?: ViewId$1<A>;
-	readonly metadata?: Metadata<A>;
 }
 /**
  * Relationship between two model elements
@@ -2483,20 +2486,14 @@ export interface DeploymentElementStyle extends ElementStyle {
 	readonly shape?: ElementShape;
 	readonly color?: Color;
 }
-export interface DeploymentNode<A extends Any = Unknown> extends WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A> {
+export interface DeploymentNode<A extends Any = Unknown> extends WithDescriptionAndTech, WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A>, WithNotation {
 	element?: never;
 	readonly id: DeploymentFqn$1<A>;
 	readonly kind: DeploymentKind$1<A>;
 	readonly title: string;
-	readonly description?: MarkdownOrString | null;
-	readonly technology?: string | null;
-	readonly tags?: Tags<A> | null;
-	readonly links?: readonly Link[] | null;
 	readonly style: DeploymentElementStyle;
-	readonly notation?: string | null;
-	readonly metadata?: Metadata<A>;
 }
-export interface DeployedInstance<A extends Any = Unknown> extends WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A> {
+export interface DeployedInstance<A extends Any = Unknown> extends WithDescriptionAndTech, WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A>, WithNotation {
 	kind?: never;
 	/**
 	 * Format: `<DeploymentNode Fqn>.<Instance Id>`
@@ -2505,13 +2502,7 @@ export interface DeployedInstance<A extends Any = Unknown> extends WithOptionalT
 	readonly id: DeploymentFqn$1<A>;
 	readonly element: Fqn$1<A>;
 	readonly title?: string;
-	readonly description?: MarkdownOrString | null;
-	readonly technology?: string | null;
-	readonly tags?: Tags<A> | null;
-	readonly links?: readonly Link[] | null;
 	readonly style?: DeploymentElementStyle;
-	readonly notation?: string;
-	readonly metadata?: Metadata<A>;
 }
 export type DeploymentElement<A extends Any = Unknown> = DeploymentNode<A> | DeployedInstance<A>;
 /**
@@ -2527,6 +2518,7 @@ export interface DeploymentRelationship<A extends Any = Unknown> extends Abstrac
 export interface ElementSpecification {
 	tags?: Tag$1[];
 	title?: string;
+	summary?: MarkdownOrString;
 	description?: MarkdownOrString;
 	technology?: string;
 	notation?: string;
@@ -2581,37 +2573,40 @@ export interface LikeC4Project {
 	readonly id: ProjectId;
 	title?: string;
 }
-export interface ComputedNode<A extends Any = Any> extends WithOptionalLinks {
+export interface ComputedNode<A extends Any = Any> extends WithTags<A>, WithOptionalLinks {
 	id: NodeId;
 	kind: ElementKind$1<A> | DeploymentKind$1<A> | "@group";
 	parent: NodeId | null;
 	/**
 	 * Reference to model element
 	 */
-	modelRef?: Fqn$1<A> | undefined;
+	modelRef?: Fqn$1<A>;
 	/**
 	 * Reference to deployment element
 	 */
-	deploymentRef?: DeploymentFqn$1<A> | undefined;
+	deploymentRef?: DeploymentFqn$1<A>;
 	title: string;
+	/**
+	 * Description of the node
+	 * either summary or description
+	 */
 	description?: MarkdownOrString | null;
 	technology?: string | null;
-	notation?: string;
 	children: NodeId[];
 	inEdges: EdgeId[];
 	outEdges: EdgeId[];
-	tags: Tags<A>;
 	shape: ElementShape;
 	color: Color;
 	icon?: Icon;
 	style: ElementStyle;
 	navigateTo?: StrictViewId<A> | null;
 	level: number;
-	depth?: number;
+	depth?: number | null;
 	/**
 	 * If this node was customized in the view
 	 */
 	isCustomized?: boolean;
+	notation?: string | null;
 }
 export interface ComputedEdge<A extends Any = Any> extends WithOptionalTags<A> {
 	id: EdgeId;
@@ -2620,7 +2615,7 @@ export interface ComputedEdge<A extends Any = Any> extends WithOptionalTags<A> {
 	target: NodeId;
 	label: string | null;
 	description?: MarkdownOrString | null;
-	technology?: string;
+	technology?: string | null;
 	relations: RelationId[];
 	kind?: RelationKind<A> | typeof StepEdgeKind;
 	notation?: string;
@@ -4762,6 +4757,20 @@ declare class ElementModel<A extends Any = Any> implements WithTags$1<A>, WithMe
 	 */
 	get tags(): Tags<A>;
 	get title(): string;
+	/**
+	 * Returns true if the element has a summary and a description
+	 * (if one is missing - it falls back to another)
+	 */
+	get hasSummary(): boolean;
+	/**
+	 * Short description of the element.
+	 * Falls back to description if summary is not provided.
+	 */
+	get summary(): RichTextOrEmpty;
+	/**
+	 * Long description of the element.
+	 * Falls back to summary if description is not provided.
+	 */
 	get description(): RichTextOrEmpty;
 	get technology(): string | null;
 	get links(): ReadonlyArray<Link>;
@@ -5298,6 +5307,15 @@ declare abstract class AbstractDeploymentElementModel<A extends Any> implements
 	get name(): string;
 	get shape(): ElementShape;
 	get color(): Color;
+	/**
+	 * Short description of the element.
+	 * Falls back to description if summary is not provided.
+	 */
+	get summary(): RichTextOrEmpty;
+	/**
+	 * Long description of the element.
+	 * Falls back to summary if description is not provided.
+	 */
 	get description(): RichTextOrEmpty;
 	get technology(): string | null;
 	get links(): ReadonlyArray<Link>;
@@ -5407,6 +5425,7 @@ declare class DeployedInstanceModel<A extends Any = Any> extends AbstractDeploym
 	get color(): Color;
 	get tags(): Tags<A>;
 	get kind(): ElementKind$1<A>;
+	get summary(): RichTextOrEmpty;
 	get description(): RichTextOrEmpty;
 	get technology(): string | null;
 	get links(): ReadonlyArray<Link>;
@@ -5429,6 +5448,7 @@ declare class NestedElementOfDeployedInstanceModel<A extends Any = Any> {
 	get shape(): ElementShape;
 	get color(): Color;
 	get title(): string;
+	get summary(): RichTextOrEmpty;
 	get description(): RichTextOrEmpty;
 	get technology(): string | null;
 	isDeploymentNode(): this is DeploymentNodeModel<A>;