@likec4/core 1.43.0 → 1.45.0

package/dist/shared/{core.BT-9gaqQ.d.mts → core.DnCLhN8C.d.mts}

@@ -1,10 +1,10 @@
-import { IsNever, IsAny } from 'type-fest';
-import { A as Any, U as Unknown, W as WithDescriptionAndTech, n as WithOptionalTags, o as WithOptionalLinks, q as WithMetadata, r as WithNotation, s as DeploymentFqn, t as DeploymentKind, F as Fqn, T as Tag, j as ElementKind, R as RelationKind, u as MetadataKey, f as _stage, g as _type, h as StrictViewId, N as NodeId, v as EdgeId, E as ExtractOnStage, M as ModelStage, P as ProjectId, k as ElementId, D as DeploymentId, d as UnknownParsed, V as ViewId, b as UnknownComputed, c as UnknownLayouted, S as SpecAux, a as Aux, w as Never } from './core.hNWo20Ym.mjs';
-import { N as NonEmptyArray, L as Link, E as ExclusiveUnion, K as KeysOf } from './core.D5fzJWbF.mjs';
-import { E as ElementStyle, A as AbstractRelationship, y as BaseViewProperties, D as ViewWithHash, C as ViewWithNotation, v as ViewAutoLayout, H as ComputedNode, B as BBox, I as ComputedEdge, P as Point, X as XYPoint, a1 as DynamicViewDisplayVariant, z as BaseParsedViewProperties, l as AnyIncludePredicate, m as AnyExcludePredicate, n as AnyViewRuleStyle, t as ViewRuleAutoLayout, aa as ParsedElementView, a2 as ParsedDynamicView, J as ComputedElementView, K as ComputedDeploymentView, O as ComputedDynamicView, x as ViewType, k as LikeC4Project, f as Element, g as Relationship, M as ModelGlobals } from './core.CvLjw3bH.mjs';
+import { Simplify, IsAny } from 'type-fest';
+import { A as Any, U as Unknown, W as WithDescriptionAndTech, s as WithOptionalTags, u as WithOptionalLinks, v as WithMetadata, w as WithNotation, x as DeploymentFqn, y as DeploymentKind, F as Fqn, n as _type, m as _stage, o as _layout, S as StrictViewId, N as NodeId, z as EdgeId, k as ExtractOnStage, M as ModelStage, P as ProjectId, a as ElementId, D as DeploymentId, d as AnyParsed, i as UnknownParsed, V as ViewId$1, b as AnyComputed, g as UnknownComputed, c as AnyLayouted, h as UnknownLayouted, f as SpecAux, e as Aux, B as Never } from './core.B73yxfPi.mjs';
+import { a as NonEmptyReadonlyArray, N as NonEmptyArray, E as ExclusiveUnion, K as KeysOf } from './core.DB0Ue5Wx.mjs';
+import { E as ElementStyle, A as AbstractRelationship, F as ViewType, B as BBox, z as ViewAutoLayout, J as ViewWithNotation, H as BaseViewProperties, K as ViewWithHash, O as ComputedNode, Q as ComputedEdge, P as Point, X as XYPoint, a7 as DynamicViewDisplayVariant, I as BaseParsedViewProperties, p as AnyIncludePredicate, q as AnyExcludePredicate, r as AnyViewRuleStyle, x as ViewRuleAutoLayout, ag as ParsedElementView, a8 as ParsedDynamicView, U as ComputedElementView, W as ComputedDeploymentView, Y as ComputedDynamicView, o as LikeC4Project, S as Specification, f as Element, g as Relationship, M as ModelGlobals } from './core.mUnpvHtA.mjs';
 import { FqnRef } from '../types/fqnRef.mjs';
-import { D as ThemeColor, C as ColorLiteral, u as ElementShape, Q as Color, s as BorderStyle, q as ShapeSize, r as SpacingSize, p as TextSize, v as RelationshipLineType, y as RelationshipArrowType, I as CustomColorDefinitions, E as Expression, F as FqnExpr } from './core.CDvVInBp.mjs';
-import { T as Tag$1, M as MarkdownOrString, I as Icon, d as RelationId } from './core.DX-WYEPA.mjs';
+import { F as Fqn$1, V as ViewId, M as MarkdownOrString, d as RelationId } from './core.DX-WYEPA.mjs';
+import { j as Expression, F as FqnExpr } from './core.0zAQeenX.mjs';
 
 interface DeploymentNode<A extends Any = Unknown> extends WithDescriptionAndTech, WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A>, WithNotation {
     element?: never;
@@ -44,63 +44,31 @@ interface DeploymentRelationship<A extends Any = Unknown> extends AbstractRelati
  */
 type DeploymentRelation<A extends Any = Unknown> = DeploymentRelationship<A>;
 
-/**
- * Element and deployment kind specification
- */
-interface ElementSpecification {
-    tags?: Tag$1[];
-    title?: string;
-    summary?: MarkdownOrString;
-    description?: MarkdownOrString;
-    technology?: string;
-    notation?: string;
-    links?: NonEmptyArray<Link>;
-    style: {
-        shape?: ElementShape;
-        icon?: Icon;
-        color?: Color;
-        border?: BorderStyle;
-        opacity?: number;
-        size?: ShapeSize;
-        padding?: SpacingSize;
-        textSize?: TextSize;
-        multiple?: boolean;
-    };
-}
-interface TagSpecification {
-    color: ThemeColor | ColorLiteral;
-}
-/**
- * Checks if tag color is defined in the specification
- * Expects HEX, `rgb(...)` or `rgba(...)` color
- */
-declare function isTagColorSpecified(spec: string | TagSpecification): spec is {
-    color: ColorLiteral;
+type LayoutedViewDriftReason = 'not-exists' | 'type-changed' | 'nodes-added' | 'nodes-removed' | 'nodes-drift' | 'edges-added' | 'edges-removed' | 'edges-drift';
+type DiagramNodeDriftReason = 'removed' | 'added' | 'label-changed' | 'modelRef-changed' | 'parent-changed' | 'children-changed' | 'became-compound' | 'became-leaf' | 'shape-changed';
+type DiagramEdgeDriftReason = 'removed' | 'added' | 'label-added' | 'label-removed' | 'label-changed' | 'notes-changed' | 'direction-changed' | 'source-changed' | 'target-changed';
+type ViewManualLayoutSnapshotPerType = {
+    readonly [_type]: 'element';
+    readonly viewOf?: Fqn$1;
+    readonly extends?: ViewId;
+} | {
+    readonly [_type]: 'deployment';
+} | {
+    readonly [_type]: 'dynamic';
+    readonly sequenceLayout: LayoutedDynamicView.Sequence.Layout;
 };
-interface RelationshipSpecification {
-    technology?: string;
-    notation?: string;
-    color?: Color;
-    line?: RelationshipLineType;
-    head?: RelationshipArrowType;
-    tail?: RelationshipArrowType;
-}
-type Specification<A> = A extends Any ? {
-    tags: {
-        [key in Tag<A>]: TagSpecification;
-    };
-    elements: {
-        [key in ElementKind<A>]: Partial<ElementSpecification>;
-    };
-    deployments: {
-        [key in DeploymentKind<A>]: Partial<ElementSpecification>;
-    };
-    relationships: {
-        [key in RelationKind<A>]: Partial<RelationshipSpecification>;
-    };
-    metadataKeys?: IsNever<MetadataKey<A>> extends true ? never : MetadataKey<A>[];
-    customColors?: CustomColorDefinitions;
-} : never;
+type ViewManualLayoutSnapshot<Type extends ViewType = ViewType> = Simplify<ViewManualLayoutSnapshotPerType & {
+    readonly id: ViewId;
+    readonly title: string | null;
+    readonly description: MarkdownOrString | null;
+    readonly [_type]: Type;
+    readonly [_stage]: 'layouted';
+    readonly hash: string;
+    readonly nodes: DiagramNode[];
+    readonly edges: DiagramEdge[];
+    readonly bounds: BBox;
+    readonly autoLayout: ViewAutoLayout;
+} & ViewWithNotation>;
 
 interface DiagramNode<A extends Any = Any> extends ComputedNode<A>, BBox {
     /**
@@ -118,6 +86,10 @@ interface DiagramNode<A extends Any = Any> extends ComputedNode<A>, BBox {
      * (Absolute coordinates)
      */
     labelBBox: BBox;
+    /**
+     * List of reasons causing node drift
+     */
+    drifts?: NonEmptyReadonlyArray<DiagramNodeDriftReason> | null;
 }
 interface DiagramEdge<A extends Any = Any> extends ComputedEdge<A> {
     /**
@@ -129,22 +101,29 @@ interface DiagramEdge<A extends Any = Any> extends ComputedEdge<A> {
      * Control points to adjust the edge
      * (Absolute coordinates)
      */
-    controlPoints?: NonEmptyArray<XYPoint>;
+    controlPoints?: NonEmptyArray<XYPoint> | null;
     /**
      * Bounding box of label
      * (Absolute coordinates)
      */
     labelBBox?: BBox | null;
     /**
-     * Graphviz edge POS
-     *
-     * TODO: temporary solution, should be moved out
-     * @deprecated
+     * List of reasons causing edge drift
      */
-    dotpos?: string;
+    drifts?: NonEmptyReadonlyArray<DiagramEdgeDriftReason> | null;
 }
+/**
+ * Type of the layout
+ * - `auto`: auto-layouted from the current sources
+ * - `manual`: read from the manually layouted snapshot
+ */
+type LayoutType = 'auto' | 'manual';
 interface BaseLayoutedViewProperties<A extends Any> extends BaseViewProperties<A>, ViewWithHash, ViewWithNotation {
     readonly [_stage]: 'layouted';
+    /**
+     * If undefined, view does not have any manual layouts, and is auto-layouted
+     */
+    readonly [_layout]?: LayoutType;
     readonly autoLayout: ViewAutoLayout;
     readonly nodes: DiagramNode<A>[];
     readonly edges: DiagramEdge<A>[];
@@ -152,8 +131,14 @@ interface BaseLayoutedViewProperties<A extends Any> extends BaseViewProperties<A
     /**
      * If diagram has manual layout
      * But was changed and layout should be recalculated
+     * @deprecated manual layout v2 uses {@link drifts}
+     */
+    readonly hasLayoutDrift?: boolean;
+    /**
+     * List of reasons causing layout drift
+     * If undefined or null, there is no layout drift or view is auto-layouted
      */
-    hasLayoutDrift?: boolean;
+    readonly drifts?: NonEmptyReadonlyArray<LayoutedViewDriftReason> | null;
 }
 interface LayoutedElementView<A extends Any = Any> extends BaseLayoutedViewProperties<A> {
     readonly [_type]: 'element';
@@ -166,8 +151,8 @@ interface LayoutedDeploymentView<A extends Any = Any> extends BaseLayoutedViewPr
 interface LayoutedDynamicView<A extends Any = Any> extends BaseLayoutedViewProperties<A> {
     readonly [_type]: 'dynamic';
     /**
-     * How to display the dynamic view
-     * - `diagram`: display as a regular likec4 view
+     * Default variant of this dynamic view
+     * - `diagram`: display as a regular likec4 view (default if not specified)
      * - `sequence`: display as a sequence diagram
      */
     readonly variant: DynamicViewDisplayVariant;
@@ -297,7 +282,16 @@ declare function isExtendsElementView<V extends AnyView<any>>(view: V): view is
 declare function isDeploymentView<V extends AnyView<any>>(view: V): view is ViewWithType<V, 'deployment'>;
 declare function isDynamicView<V extends AnyView<any>>(view: V): view is ViewWithType<V, 'dynamic'>;
 
+/**
+ * Represents a LikeC4 model data, in different stages of processing
+ * - {@link ParsedLikeC4ModelData} - parsed from DSL or result from Builder
+ * - {@link ComputedLikeC4ModelData} - computed from parsed model
+ * - {@link LayoutedLikeC4ModelData} - layouted from computed model
+ *
+ * !IMPORTANT: This is a low-level type, use `LikeC4Model` instead.
+ */
 interface BaseLikeC4ModelData<A extends Any> {
+    [_stage]: A['Stage'];
     projectId: ProjectId<A>;
     project: LikeC4Project;
     specification: Specification<A>;
@@ -311,31 +305,25 @@ interface BaseLikeC4ModelData<A extends Any> {
     imports: Record<string, NonEmptyArray<Element<A>>>;
 }
 type AuxFromLikeC4ModelData<D> = D extends BaseLikeC4ModelData<infer A extends Any> ? IsAny<A> extends true ? never : A : never;
-/**
- * Represents a LikeC4 model with customizable type parameters,
- * parsed from DSL or result from Builder
- *
- * !IMPORTANT: This is a low-level type, use `LikeC4Model` instead.
- * !NOTE: Views are not computed yet.
- *
- * @typeParam ElementKinds - Types of elements in the model (defaults to string)
- * @typeParam RelationKinds - Types of relationships (defaults to string)
- * @typeParam Tags - Types of tags that can be applied (defaults to string)
- * @typeParam Fqns - Fully Qualified Names for elements (defaults to string)
- * @typeParam Views - Types of views in the model (defaults to string)
- * @typeParam DeploymentFqns - Fully Qualified Names for deployment nodes (defaults to string)
- */
-interface ParsedLikeC4ModelData<A extends Any = UnknownParsed> extends BaseLikeC4ModelData<A> {
+interface ParsedLikeC4ModelData<A extends AnyParsed = UnknownParsed> extends BaseLikeC4ModelData<A> {
     [_stage]: 'parsed';
-    views: Record<ViewId<A>, ParsedView<A>>;
+    views: Record<ViewId$1<A>, ParsedView<A>>;
 }
-interface ComputedLikeC4ModelData<A extends Any = UnknownComputed> extends BaseLikeC4ModelData<A> {
+interface ComputedLikeC4ModelData<A extends AnyComputed = UnknownComputed> extends BaseLikeC4ModelData<A> {
     [_stage]: 'computed';
-    views: Record<ViewId<A>, ComputedView<A>>;
+    views: Record<ViewId$1<A>, ComputedView<A>>;
+    /**
+     * If project contains saved manual layouts
+     */
+    manualLayouts?: Record<ViewId, ViewManualLayoutSnapshot>;
 }
-interface LayoutedLikeC4ModelData<A extends Any = UnknownLayouted> extends BaseLikeC4ModelData<A> {
+interface LayoutedLikeC4ModelData<A extends AnyLayouted = UnknownLayouted> extends BaseLikeC4ModelData<A> {
     [_stage]: 'layouted';
-    views: Record<ViewId<A>, LayoutedView<A>>;
+    views: Record<ViewId$1<A>, LayoutedView<A>>;
+    /**
+     * If this model contains saved manual layouts
+     */
+    manualLayouts?: Record<ViewId, ViewManualLayoutSnapshot>;
 }
 type LikeC4ModelData<A extends Any> = ParsedLikeC4ModelData<A> | ComputedLikeC4ModelData<A> | LayoutedLikeC4ModelData<A>;
 
@@ -423,14 +411,15 @@ type RichTextOrEmpty = RichTextNonEmpty | RichTextEmpty;
  * It is used to represent the content of a node or a link.
  */
 declare class RichText {
-    private static _cache;
+    private static getOrCreateFromText;
+    private static getOrCreateFromMarkdown;
     /**
      * Creates and memoizes a RichText instance.
      * @see ElementModel.description
      * @example
      *
      *  get description(): RichTextOrEmpty {
-     *    return RichText.memoize(this, this.$element.description)
+     *    return RichText.memoize(this, 'description', this.$element.description)
      *  }
      */
     static memoize(obj: object, tag: symbol | string, source: MarkdownOrString | null | undefined): RichTextOrEmpty;
@@ -473,4 +462,4 @@ declare class RichText {
     equals(other: unknown): boolean;
 }
 
-export { type DeploymentViewRule as $, type AuxFromLikeC4ModelData as A, isViewRulePredicate as B, type ComputedLikeC4ModelData as C, type DeploymentNode as D, type ElementSpecification as E, isViewRuleStyle as F, isComputedView as G, isElementView as H, isScopedElementView as I, isExtendsElementView as J, isDeploymentView as K, type LayoutedLikeC4ModelData as L, isDynamicView as M, type DiagramNode as N, type DiagramEdge as O, type ParsedLikeC4ModelData as P, type LayoutedElementView as Q, RichText as R, type SpecificationDump as S, type TagSpecification as T, type LayoutedDeploymentView as U, type ViewOnStage as V, LayoutedDynamicView as W, type DeploymentViewIncludePredicate as X, type DeploymentViewExcludePredicate as Y, type DeploymentViewPredicate as Z, type DeploymentViewRuleStyle as _, type RichTextEmpty as a, type ParsedDeploymentView as a0, type RichTextOrEmpty as b, type LikeC4ModelData as c, type DeployedInstance as d, type DeploymentElement as e, type DeploymentElementRef as f, isDeployedInstance as g, type DeploymentRelationship as h, isDeploymentNode as i, type DeploymentRelation as j, type SpecTypesFromDump as k, type LikeC4ModelDump as l, type ProjectDump as m, type AuxFromDump as n, isTagColorSpecified as o, type RelationshipSpecification as p, type Specification as q, type ParsedView as r, type LayoutedView as s, isDiagramView as t, type ComputedView as u, type ProcessedView as v, type AnyView as w, type ViewWithType as x, type ViewRule as y, type ViewRulePredicate as z };
+export { type DeploymentViewRule as $, type AuxFromLikeC4ModelData as A, isComputedView as B, type ComputedLikeC4ModelData as C, type DeploymentNode as D, isElementView as E, isScopedElementView as F, isExtendsElementView as G, isDeploymentView as H, isDynamicView as I, type DiagramNode as J, type DiagramEdge as K, type LayoutedView as L, type LayoutType as M, type LayoutedElementView as N, type LayoutedDeploymentView as O, type ParsedLikeC4ModelData as P, LayoutedDynamicView as Q, RichText as R, type SpecificationDump as S, type LayoutedViewDriftReason as T, type DiagramNodeDriftReason as U, type ViewManualLayoutSnapshot as V, type DiagramEdgeDriftReason as W, type DeploymentViewIncludePredicate as X, type DeploymentViewExcludePredicate as Y, type DeploymentViewPredicate as Z, type DeploymentViewRuleStyle as _, type RichTextEmpty as a, type ParsedDeploymentView as a0, type RichTextOrEmpty as b, type LayoutedLikeC4ModelData as c, type LikeC4ModelData as d, type DeployedInstance as e, type DeploymentElement as f, type DeploymentElementRef as g, isDeployedInstance as h, isDeploymentNode as i, type DeploymentRelationship as j, type DeploymentRelation as k, type SpecTypesFromDump as l, type LikeC4ModelDump as m, type ProjectDump as n, type AuxFromDump as o, type ParsedView as p, isDiagramView as q, type ComputedView as r, type ProcessedView as s, type AnyView as t, type ViewOnStage as u, type ViewWithType as v, type ViewRule as w, type ViewRulePredicate as x, isViewRulePredicate as y, isViewRuleStyle as z };

package/dist/shared/{core.BouyJs63.mjs → core.DqlrMlsf.mjs}

@@ -1,4 +1,4 @@
-import { i as isAncestor } from './core.727Qoh_W.mjs';
+import { i as isAncestor } from './core.CdNCAwq7.mjs';
 
 var Connection;
 ((Connection2) => {

package/dist/shared/{core.CNgZvKb8.mjs → core.DrUt0Lbi.mjs}

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'events';
 import { g as getDefaultExportFromCjs } from './core.B85MJLTf.mjs';
-import { a as requireIterator, r as requireSupport } from './core.rCeaAqgW.mjs';
+import { r as requireIterator, a as requireSupport } from './core.BdPcbSkN.mjs';
 
 var iteratorExports = requireIterator();
 const Iterator = /*@__PURE__*/getDefaultExportFromCjs(iteratorExports);

package/dist/shared/{core.CT1xBp4R.d.mts → core.Dvh1H0T2.d.mts}

@@ -1,6 +1,6 @@
-import { a as LikeC4StylesConfig, b as LikeC4Theme, L as LikeC4StyleDefaults, U as ElementColorValues, V as RelationshipColorValues, D as ThemeColor, T as ThemeColorValues, p as TextSize, r as SpacingSize, q as ShapeSize } from './core.CDvVInBp.mjs';
+import { L as LikeC4StylesConfig, a as LikeC4Theme, b as LikeC4StyleDefaults, E as ElementColorValues, R as RelationshipColorValues, T as ThemeColor, c as ThemeColorValues, d as TextSize, S as SpacingSize, e as ShapeSize } from './core.0zAQeenX.mjs';
 import { LiteralUnion } from 'type-fest';
-import { j as LikeC4ProjectStylesConfig, F as ComputedNodeStyle } from './core.CvLjw3bH.mjs';
+import { L as LikeC4ProjectStylesConfig, C as ComputedNodeStyle } from './core.mUnpvHtA.mjs';
 
 /**
  * Styles of a LikeC4 project