@likec4/core 1.48.0 → 1.50.0

package/dist/_chunks/index3.d.mts

@@ -1,9 +1,11 @@
-import { Ct as NTuple } from "./_aux.mjs";
-import { S as Tag } from "./scalar.mjs";
-import { B as ShapeSize, C as BorderStyle, F as LikeC4Theme, G as ThemeColorValues, H as SpacingSize, M as IconSize, N as LikeC4StyleDefaults, O as ElementColorValues, P as LikeC4StylesConfig, R as RelationshipColorValues, T as ColorLiteral, U as TextSize, W as ThemeColor, j as IconPosition, w as Color } from "./expression.mjs";
-import { Z as ComputedNodeStyle, ct as TagSpecification, nt as LikeC4ProjectStylesConfig } from "./index2.mjs";
+import { Er as DefaultTagColors, Fi as Tag, Sr as ThemeColorValues, _r as ShapeSize, _t as TagSpecification, ar as ElementColorValues, br as TextSize, cr as IconPosition, dr as LikeC4StylesConfig, dt as LikeC4ProjectStylesConfig, er as BorderStyle, fr as LikeC4Theme, ft as LikeC4ProjectStylesCustomStylesheets, hr as RelationshipColorValues, ir as CustomColorDefinitions, lr as IconSize, nr as ColorLiteral, ot as ComputedNodeStyle, ra as NTuple, tr as Color, ur as LikeC4StyleDefaults, xr as ThemeColor, yr as SpacingSize } from "./index.mjs";
 import { LiteralUnion } from "type-fest";
 
+//#region src/styles/assignTagColors.d.ts
+declare function assignTagColors(tags: {
+  [kind: string]: Partial<TagSpecification>;
+}): Record<Tag, TagSpecification>;
+//#endregion
 //#region src/styles/LikeC4Styles.d.ts
 /**
  * Styles of a LikeC4 project
@@ -17,10 +19,11 @@ import { LiteralUnion } from "type-fest";
  */
 declare class LikeC4Styles {
   protected config: LikeC4StylesConfig;
+  protected customCss?: LikeC4ProjectStylesCustomStylesheets | undefined;
   readonly theme: LikeC4Theme;
   readonly defaults: LikeC4StyleDefaults;
   static readonly DEFAULT: LikeC4Styles;
-  static from(...configs: Array<LikeC4ProjectStylesConfig | undefined | null>): LikeC4Styles;
+  static from(stylesConfig: LikeC4ProjectStylesConfig | undefined, customColors?: CustomColorDefinitions | undefined): LikeC4Styles;
   private constructor();
   /**
    * Default element colors
@@ -105,10 +108,10 @@ declare class LikeC4Styles {
       readonly size?: ShapeSize;
       readonly padding?: SpacingSize;
       readonly textSize?: TextSize;
-    }, "iconSize" | "size" | "padding" | "textSize"> & Required<{
-      readonly iconSize?: IconSize;
+    }, "size" | "padding" | "iconSize" | "textSize"> & Required<{
       readonly size?: ShapeSize;
       readonly padding?: SpacingSize;
+      readonly iconSize?: IconSize;
       readonly textSize?: TextSize;
     }>;
     values: {
@@ -127,13 +130,12 @@ declare class LikeC4Styles {
    */
   computeFrom(color: string): ThemeColorValues;
   equals(other: LikeC4Styles): boolean;
+  /**
+   * Get color values for a tag (including default tag colors)
+   */
+  tagColor(tag: typeof DefaultTagColors[number] | ThemeColor | ColorLiteral): ThemeColorValues['elements'];
 }
 //#endregion
-//#region src/styles/assignTagColors.d.ts
-declare function assignTagColors(tags: {
-  [kind: string]: Partial<TagSpecification>;
-}): Record<Tag, TagSpecification>;
-//#endregion
 //#region src/styles/compute-color-values.d.ts
 declare function computeColorValues(color: ColorLiteral): ThemeColorValues;
 //#endregion
@@ -143,4 +145,4 @@ declare const styleDefaults: LikeC4StyleDefaults;
 //#region src/styles/theme.d.ts
 declare const defaultTheme: LikeC4Theme;
 //#endregion
-export { LikeC4Styles as a, assignTagColors as i, styleDefaults as n, computeColorValues as r, defaultTheme as t };
+export { assignTagColors as a, LikeC4Styles as i, styleDefaults as n, computeColorValues as r, defaultTheme as t };

package/dist/_chunks/index4.d.mts

@@ -1,6 +1,151 @@
-import { Dt as ReorderedArray, yt as IterableContainer } from "./_aux.mjs";
-import { n as Connection } from "./const.mjs";
+import { $i as IterableContainer, bi as Fqn, ea as IteratorLike, ii as Unknown, jr as Any, sa as ReorderedArray, zr as EdgeId } from "./index.mjs";
+import { C as ElementModel, S as NodeModel, T as RelationshipModel, a as DeploymentNodeModel, c as NestedElementOfDeployedInstanceModel, i as DeploymentElementModel, l as RelationshipsAccum, r as DeployedInstanceModel, s as DeploymentRelationModel, w as AnyRelationshipModel, x as EdgeModel, y as LikeC4ViewModel } from "./LikeC4Model.mjs";
 
+//#region src/model/connection/Connection.d.ts
+interface Connection<Elem = ElementModel<Any> | DeploymentElementModel<Any>, Id = string> {
+  readonly id: Id;
+  readonly source: Elem;
+  readonly target: Elem;
+  /**
+   * Common ancestor of the source and target elements.
+   * Represents the boundary of the connection.
+   */
+  readonly boundary: Elem | null;
+  /**
+   * Human readable expression of the connection
+   * Mostly used for testing and debugging
+   */
+  readonly expression: string;
+  mergeWith(this: Connection<Elem, Id>, other: typeof this): typeof this;
+  nonEmpty(): boolean;
+  difference(this: Connection<Elem, Id>, other: typeof this): typeof this;
+  intersect(this: Connection<Elem, Id>, other: typeof this): typeof this;
+  equals(other: Connection): boolean;
+}
+declare namespace Connection {
+  type ConnectionPredicate = <C extends Connection<{
+    id: string;
+  }, any>>(connection: C) => boolean;
+  type ElementId = Fqn | string;
+  export const isInside: (fqn: ElementId) => ConnectionPredicate;
+  export const isDirectedBetween: (source: ElementId, target: ElementId) => ConnectionPredicate;
+  export const isAnyBetween: (source: ElementId, target: ElementId) => ConnectionPredicate;
+  export const isIncoming: (target: ElementId) => ConnectionPredicate;
+  export const isOutgoing: (source: ElementId) => ConnectionPredicate;
+  export const isAnyInOut: (source: ElementId) => ConnectionPredicate;
+  export {};
+}
+//#endregion
+//#region src/utils/const.d.ts
+declare const customInspectSymbol: unique symbol;
+//#endregion
+//#region src/model/connection/deployment/DeploymentConnectionModel.d.ts
+/**
+ * Connection is ephemeral entity, result of a resolving relationships between source and target.
+ * Includes direct relationships and/or between their nested elements.
+ */
+declare class DeploymentConnectionModel<A extends Any = Any> implements Connection<DeploymentElementModel<A>, EdgeId> {
+  readonly source: DeploymentElementModel<A>;
+  readonly target: DeploymentElementModel<A>;
+  readonly relations: RelationshipsAccum<A>;
+  readonly id: EdgeId;
+  constructor(source: DeploymentElementModel<A>, target: DeploymentElementModel<A>, relations: RelationshipsAccum<A>);
+  /**
+   * Human readable expression of the connection
+   * Mostly used for testing and debugging
+   */
+  get expression(): string;
+  private _boundary;
+  /**
+   * Common ancestor of the source and target elements.
+   * Represents the boundary of the connection.
+   */
+  get boundary(): DeploymentNodeModel<A> | null;
+  nonEmpty(): boolean;
+  [customInspectSymbol](_depth: any, _inspectOptions: any, _inspect: any): string;
+  toString(): string;
+  /**
+   * Check if connection contains deployment relation,
+   * that is directly connected to source or target.
+   */
+  hasDirectDeploymentRelation(): boolean;
+  values(): IteratorLike<RelationshipModel<A> | DeploymentRelationModel<A>>;
+  /**
+   * Merge with another connections, if it has the same source and target.
+   * Returns new connection with union of relationships.
+   */
+  mergeWith(others: DeploymentConnectionModel<A>[]): DeploymentConnectionModel<A>;
+  /**
+   * Merge with another connection, if it has the same source and target.
+   * Returns new connection with union of relationships.
+   */
+  mergeWith(other: DeploymentConnectionModel<A>): DeploymentConnectionModel<A>;
+  difference(other: DeploymentConnectionModel<A>): DeploymentConnectionModel<A>;
+  intersect(other: DeploymentConnectionModel<A>): DeploymentConnectionModel<A>;
+  equals(other: Connection): boolean;
+  /**
+   * Creates a clone of the current `DeploymentConnectionModel` instance with optional overrides.
+   * if `null` is provided in overrides, the corresponding relation set will be empty.
+   */
+  update(overrides?: {
+    model?: ReadonlySet<RelationshipModel<A>> | null;
+    deployment?: ReadonlySet<DeploymentRelationModel<A>> | null;
+  }): DeploymentConnectionModel<A>;
+}
+//#endregion
+//#region src/model/connection/model/ConnectionModel.d.ts
+/**
+ * Connection refers to any relationships between two elements,
+ * both direct and implicit ones (between their nested elements).
+ *
+ * Merges relationships together to an single edge on the diagram.
+ */
+declare class ConnectionModel<A extends Any = Unknown> implements Connection<ElementModel<A>, EdgeId> {
+  readonly source: ElementModel<A>;
+  readonly target: ElementModel<A>;
+  readonly relations: ReadonlySet<RelationshipModel<A>>;
+  readonly id: EdgeId;
+  constructor(source: ElementModel<A>, target: ElementModel<A>, relations?: ReadonlySet<RelationshipModel<A>>);
+  private _boundary;
+  /**
+   * Common ancestor of the source and target elements.
+   * Represents the boundary of the connection.
+   */
+  get boundary(): ElementModel<A> | null;
+  /**
+   * Human readable expression of the connection
+   * Mostly used for testing and debugging
+   */
+  get expression(): string;
+  /**
+   * Returns true if only includes relations between the source and target elements.
+   */
+  get isDirect(): boolean;
+  /**
+   * Returns true if includes relations between nested elements of the source and target elements.
+   */
+  get isImplicit(): boolean;
+  get directRelations(): ReadonlySet<RelationshipModel<A>>;
+  nonEmpty(): boolean;
+  mergeWith(other: ConnectionModel<A>): ConnectionModel<A>;
+  difference(other: ConnectionModel<A>): ConnectionModel<A>;
+  intersect(other: ConnectionModel<A>): ConnectionModel<A>;
+  equals(other: Connection): boolean;
+  /**
+   * Returns a new instance with the updated relations.
+   *
+   * @param relations - A readonly set of `RelationshipModel` instances representing the new relations.
+   * @returns A new `ConnectionModel` instance with the updated relations.
+   */
+  update(relations: ReadonlySet<RelationshipModel<A>>): ConnectionModel<A>;
+  [customInspectSymbol](_depth: any, _inspectOptions: any, _inspect: any): string;
+  toString(): string;
+  /**
+   * Creates a new connection with reversed direction (target becomes source and vice versa)
+   */
+  reversed(): ConnectionModel<A>;
+}
+//#endregion
 //#region src/model/connection/ops.d.ts
 /**
  * Check if connection is nested inside another connection
@@ -58,5 +203,86 @@ declare function isIncoming<T extends string>(target: WithId<NoInfer<T>>): (a: W
 declare function isIncoming<T extends string>(a: WithSourceTarget<WithId<T>>, target: WithId<T>): boolean;
 declare function isAnyInOut<T extends string>(source: WithId<NoInfer<T>>): (a: WithSourceTarget<WithId<T>>) => boolean;
 declare function isAnyInOut<T extends string>(a: WithSourceTarget<WithId<T>>, source: WithId<T>): boolean;
+declare namespace find_d_exports$1 {
+  export { findConnection$1 as findConnection, findConnectionsBetween$1 as findConnectionsBetween, findConnectionsWithin$1 as findConnectionsWithin };
+}
+/**
+ * Resolve connection from source to target
+ * If direction is `both`, also look for reverse connection
+ *
+ * @default direction directed
+ */
+declare function findConnection$1<M extends Any>(source: DeploymentElementModel<M>, target: DeploymentElementModel<NoInfer<M>>, direction: 'directed'): readonly [DeploymentConnectionModel<M>] | readonly [];
+declare function findConnection$1<M extends Any>(source: DeploymentElementModel<M>, target: DeploymentElementModel<NoInfer<M>>, direction: 'both'): readonly [DeploymentConnectionModel<M>, DeploymentConnectionModel<M>] | readonly [DeploymentConnectionModel<M>] | readonly [];
+declare function findConnection$1<M extends Any>(source: DeploymentElementModel<M>, target: DeploymentElementModel<NoInfer<M>>, direction?: 'directed' | 'both'): readonly [DeploymentConnectionModel<M>, DeploymentConnectionModel<M>] | readonly [DeploymentConnectionModel<M>] | readonly [];
+/**
+ * Resolve all connections between element and others
+ * By default, look for both directions.
+ *
+ * @default direction both
+ */
+declare function findConnectionsBetween$1<M extends Any>(element: DeploymentElementModel<M>, others: Iterable<DeploymentElementModel<NoInfer<M>>>, direction?: 'directed' | 'both'): readonly DeploymentConnectionModel<M>[];
+/**
+ * Resolve all connections within a given set of elements
+ */
+declare function findConnectionsWithin$1<M extends Any>(elements: Iterable<DeploymentElementModel<M>>): readonly DeploymentConnectionModel<M>[];
+declare namespace find_d_exports {
+  export { findConnection, findConnectionsBetween, findConnectionsWithin };
+}
+/**
+ * Resolve connection from source to target
+ *
+ * @param direction - if 'both', also returns connection from target to source
+ * @default `directed`
+ */
+declare function findConnection<A extends Any>(source: ElementModel<A>, target: ElementModel<A>, direction?: 'directed' | 'both'): [ConnectionModel<A>, ConnectionModel<A>] | [ConnectionModel<A>] | [];
+/**
+ * Resolve all connections between element and others
+ * @param direction - if 'directed', only look for outgoing connections from the element to others
+ * @default `both`
+ */
+declare function findConnectionsBetween<M extends Any>(element: ElementModel<M>, others: Iterable<ElementModel<M>>, direction?: 'directed' | 'both'): readonly ConnectionModel<M>[];
+/**
+ * Resolve all connections within a given set of elements
+ */
+declare function findConnectionsWithin<M extends Any>(elements: Iterable<ElementModel<M>>): readonly ConnectionModel<M>[];
+//#endregion
+//#region src/model/guards.d.ts
+type AnyModel<A extends Any> = DeploymentNodeModel<A> | DeployedInstanceModel<A> | DeploymentRelationModel<A> | AnyRelationshipModel<A> | NestedElementOfDeployedInstanceModel<A> | ElementModel<A> | RelationshipModel<A> | LikeC4ViewModel<A> | NodeModel<A> | EdgeModel<A>;
+declare function isDeploymentNodeModel<M extends Any>(model: AnyModel<M>): model is DeploymentNodeModel<M>;
+declare function isDeployedInstanceModel<M extends Any>(model: AnyModel<M>): model is DeployedInstanceModel<M>;
+declare function isDeploymentElementModel<M extends Any>(model: AnyModel<M>): model is DeploymentElementModel<M>;
+declare function isNestedElementOfDeployedInstanceModel<M extends Any>(model: AnyModel<M>): model is NestedElementOfDeployedInstanceModel<M>;
+declare function isDeploymentRelationModel<M extends Any>(x: AnyModel<M>): x is DeploymentRelationModel<M>;
+declare function isRelationModel<M extends Any>(x: AnyModel<M>): x is RelationshipModel<M>;
+declare function isElementModel<M extends Any>(element: AnyModel<M>): element is ElementModel<M>;
+declare function isLikeC4ViewModel<M extends Any>(view: AnyModel<M>): view is LikeC4ViewModel<M>;
+declare function isNodeModel<M extends Any>(node: AnyModel<M>): node is NodeModel<M>;
+declare function isEdgeModel<M extends Any>(edge: AnyModel<M>): edge is EdgeModel<M>;
+//#endregion
+//#region src/model/utils/view-title-path.d.ts
+declare const VIEW_FOLDERS_SEPARATOR = "/";
+/**
+ * Normalizes view path by removing spaces from segments, removing empty segments,
+ * and removing leading/trailing slashes
+ * @example
+ * normalizeViewPath('One / Tw o / Thre e') === 'One/Tw o/Thre e'
+ */
+declare const normalizeViewPath: (title: string) => string;
+/**
+ * Returns view group path if it is used as a path
+ * Returns empty string if it is not a path
+ * @example
+ * getViewFolderPath('One / Tw o / Thre e') === 'One/Tw o'
+ * getViewFolderPath('One') === ''
+ */
+declare const getViewFolderPath: (title: string) => string | null;
+/**
+ * Returns view title if it is used as a path
+ * @example
+ * getViewTitleFromPath('One / Tw o / Thre e') === 'Thre e'
+ * getViewTitleFromPath('One') === 'One'
+ */
+declare const extractViewTitleFromPath: (title: string) => string;
 //#endregion
-export { hasSameSource as a, isAnyInOut as c, isOutgoing as d, mergeConnections as f, findDescendantConnections as i, isIncoming as l, sortDeepestFirst as m, findAscendingConnections as n, hasSameSourceTarget as o, sortConnectionsByBoundaryHierarchy as p, findDeepestNestedConnection as r, hasSameTarget as s, differenceConnections as t, isNestedConnection as u };
+export { sortDeepestFirst as A, hasSameTarget as C, isOutgoing as D, isNestedConnection as E, DeploymentConnectionModel as M, Connection as N, mergeConnections as O, hasSameSourceTarget as S, isIncoming as T, differenceConnections as _, isDeployedInstanceModel as a, findDescendantConnections as b, isDeploymentRelationModel as c, isLikeC4ViewModel as d, isNestedElementOfDeployedInstanceModel as f, find_d_exports$1 as g, find_d_exports as h, normalizeViewPath as i, ConnectionModel as j, sortConnectionsByBoundaryHierarchy as k, isEdgeModel as l, isRelationModel as m, extractViewTitleFromPath as n, isDeploymentElementModel as o, isNodeModel as p, getViewFolderPath as r, isDeploymentNodeModel as s, VIEW_FOLDERS_SEPARATOR as t, isElementModel as u, findAscendingConnections as v, isAnyInOut as w, hasSameSource as x, findDeepestNestedConnection as y };