@likec4/core 1.43.0 → 1.45.0

package/dist/shared/{core.CvLjw3bH.d.mts → core.mUnpvHtA.d.mts}

@@ -1,9 +1,9 @@
-import { Tagged, NonEmptyTuple, PartialDeep, WritableDeep, Except } from 'type-fest';
-import { s as BorderStyle, q as ShapeSize, r as SpacingSize, p as TextSize, Q as Color, u as ElementShape, v as RelationshipLineType, y as RelationshipArrowType, b as LikeC4Theme, L as LikeC4StyleDefaults } from './core.CDvVInBp.mjs';
-import { I as Icon, M as MarkdownOrString, d as RelationId, P as ProjectId, N as NodeId, j as EdgeId, m as StepEdgeKind } from './core.DX-WYEPA.mjs';
-import { A as Any, n as WithOptionalTags, o as WithOptionalLinks, h as StrictViewId, f as _stage, g as _type, F as Fqn, R as RelationKind, W as WithDescriptionAndTech, q as WithMetadata, r as WithNotation, j as ElementKind, x as WithTags, t as DeploymentKind, s as DeploymentFqn } from './core.hNWo20Ym.mjs';
+import { Tagged, NonEmptyTuple, IsNever, PartialDeep, WritableDeep, Except } from 'type-fest';
+import { h as ElementShape, C as Color, B as BorderStyle, e as ShapeSize, S as SpacingSize, d as TextSize, f as RelationshipLineType, g as RelationshipArrowType, T as ThemeColor, G as ColorLiteral, Q as CustomColorDefinitions, a as LikeC4Theme, b as LikeC4StyleDefaults } from './core.0zAQeenX.mjs';
+import { A as Any, s as WithOptionalTags, u as WithOptionalLinks, S as StrictViewId, m as _stage, n as _type, F as Fqn, R as RelationKind, W as WithDescriptionAndTech, v as WithMetadata, w as WithNotation, E as ElementKind, T as Tag, y as DeploymentKind, C as MetadataKey, G as WithTags, x as DeploymentFqn } from './core.B73yxfPi.mjs';
+import { N as NonEmptyArray, E as ExclusiveUnion, a as NonEmptyReadonlyArray, L as Link } from './core.DB0Ue5Wx.mjs';
+import { M as MarkdownOrString, I as Icon, d as RelationId, T as Tag$1, P as ProjectId, N as NodeId, j as EdgeId, m as StepEdgeKind } from './core.DX-WYEPA.mjs';
 import { FqnRef } from '../types/fqnRef.mjs';
-import { N as NonEmptyArray, E as ExclusiveUnion, a as NonEmptyReadonlyArray } from './core.D5fzJWbF.mjs';
 import { ModelExpression, ModelFqnExpr } from '../types/expression-model.mjs';
 
 type Point = readonly [x: number, y: number];
@@ -19,11 +19,20 @@ interface BBox {
 }
 declare namespace BBox {
     function center({ x, y, width, height }: BBox): XYPoint;
+    /**
+     * Returns the four corner points of the box in clockwise order starting from top-left
+     */
+    function toPoints({ x, y, width, height }: BBox): [XYPoint, XYPoint, XYPoint, XYPoint];
     function fromPoints(points: Point[]): BBox;
     function merge(...boxes: BBox[]): BBox;
+    function fromRectBox(rect: RectBox): BBox;
     function toRectBox(box: BBox): RectBox;
     function expand(box: BBox, plus: number): BBox;
     function shrink(box: BBox, minus: number): BBox;
+    /**
+     * Returns true if `a` includes `b` (i.e. `b` is inside `a`)
+     */
+    function includes(a: BBox, b: BBox): boolean;
 }
 interface RectBox {
     x1: number;
@@ -36,6 +45,10 @@ declare namespace RectBox {
     function fromPoints(points: Point[]): RectBox;
     function merge(...boxes: RectBox[]): RectBox;
     function toBBox(box: RectBox): BBox;
+    /**
+     * Returns true if `a` includes `b` (i.e. `b` is inside `a`)
+     */
+    function includes(a: RectBox, b: RectBox): boolean;
 }
 
 interface AnyIncludePredicate<Expr> {
@@ -82,6 +95,12 @@ interface ViewAutoLayout {
     rankSep?: number;
     nodeSep?: number;
 }
+/**
+ * v1 Manual layout of a view, stored in the block comment to the view definition.
+ * Keeping this type for backward compatibility and migration purposes.
+ *
+ * @deprecated Use {@link ViewManualLayoutSnapshot} instead
+ */
 type ViewManualLayout = {
     readonly hash: string;
     readonly x: number;
@@ -97,7 +116,6 @@ type ViewManualLayout = {
         height: number;
     }>;
     readonly edges: Record<string, {
-        dotpos?: string;
         points: NonEmptyArray<Point>;
         controlPoints?: NonEmptyArray<XYPoint>;
         labelBBox?: BBox;
@@ -125,10 +143,6 @@ interface BaseParsedViewProperties<A extends Any> extends BaseViewProperties<A>
      * Undefined if the view is auto-generated.
      */
     readonly docUri?: string | undefined;
-    /**
-     * If the view is changed manually this field contains the layout data.
-     */
-    readonly manualLayout?: ViewManualLayout | undefined;
 }
 type NodeNotation = {
     kinds: string[];
@@ -320,6 +334,64 @@ interface Relationship<A extends Any = Any> extends AbstractRelationship<A> {
  */
 type ModelRelation<A extends Any = Any> = Relationship<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;
+};
+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 LikeC4ProjectTheme = PartialDeep<WritableDeep<LikeC4Theme>, {
     recurseIntoArrays: false;
     allowUndefinedInNonTupleArrays: false;
@@ -332,6 +404,9 @@ interface LikeC4ProjectStylesConfig {
     theme?: LikeC4ProjectTheme;
     defaults?: LikeC4ProjectStyleDefaults;
 }
+interface LikeC4ProjectManualLayoutsConfig {
+    outDir: string;
+}
 /**
  * Configuration of the project, as read from the config file.
  * LikeC4 projects encapsulate models, and can import from each other
@@ -346,6 +421,10 @@ interface LikeC4Project {
      * Custom styles
      */
     styles?: LikeC4ProjectStylesConfig | undefined;
+    /**
+     * Configuration for manual layouts snapshots
+     */
+    manualLayouts?: LikeC4ProjectManualLayoutsConfig | undefined;
 }
 
 type ComputedNodeStyle = Except<ElementStyle, 'icon' | 'shape' | 'color', {
@@ -425,7 +504,12 @@ interface BaseComputedViewProperties<A extends Any> extends BaseViewProperties<A
     readonly nodes: ComputedNode<A>[];
     readonly edges: ComputedEdge<A>[];
     /**
-     * If the view is changed manually this field contains the layout data.
+     * If the view has manual layout (v2)
+     */
+    readonly hasManualLayout?: boolean;
+    /**
+     * Manual layout data (v1), for compatibility during migration
+     * @deprecated
      */
     readonly manualLayout?: ViewManualLayout | undefined;
 }
@@ -447,4 +531,4 @@ interface ComputedDynamicView<A extends Any = Any> extends BaseComputedViewPrope
     readonly variant: DynamicViewDisplayVariant;
 }
 
-export { type DynamicViewIncludeRule as $, type AbstractRelationship as A, BBox as B, type ViewWithNotation as C, type ViewWithHash as D, type ElementStyle as E, type ComputedNodeStyle as F, type GlobalPredicateId as G, type ComputedNode as H, type ComputedEdge as I, type ComputedElementView as J, type ComputedDeploymentView as K, type LikeC4ProjectTheme as L, type ModelGlobals as M, type NodeNotation as N, type ComputedDynamicView as O, type Point as P, type DynamicStep as Q, RectBox as R, type DynamicStepsSeries as S, type DynamicStepsParallel as T, getParallelStepsPrefix as U, type ViewRuleGlobalStyle as V, type DynamicViewStep as W, type XYPoint as X, isDynamicStep as Y, isDynamicStepsParallel as Z, isDynamicStepsSeries as _, type GlobalPredicates as a, type DynamicViewRule as a0, type DynamicViewDisplayVariant as a1, type ParsedDynamicView as a2, type ElementViewIncludePredicate as a3, type ElementViewExcludePredicate as a4, type ElementViewPredicate as a5, type ElementViewRuleGroup as a6, isViewRuleGroup as a7, type ElementViewRuleStyle as a8, type ElementViewRule as a9, type ParsedElementView as aa, type GlobalDynamicPredicates as b, type GlobalStyleID as c, type GlobalStyles as d, ensureSizes as e, type Element as f, type Relationship as g, type ModelRelation as h, type LikeC4ProjectStyleDefaults as i, type LikeC4ProjectStylesConfig as j, type LikeC4Project as k, type AnyIncludePredicate as l, type AnyExcludePredicate as m, type AnyViewRuleStyle as n, isViewRuleGlobalStyle as o, type ViewRuleGlobalPredicateRef as p, isViewRuleGlobalPredicateRef as q, type AutoLayoutDirection as r, isAutoLayoutDirection as s, type ViewRuleAutoLayout as t, isViewRuleAutoLayout as u, type ViewAutoLayout as v, type ViewManualLayout as w, type ViewType as x, type BaseViewProperties as y, type BaseParsedViewProperties as z };
+export { type DynamicStepsParallel as $, type AbstractRelationship as A, BBox as B, type ComputedNodeStyle as C, type ViewManualLayout as D, type ElementStyle as E, type ViewType as F, type GlobalPredicateId as G, type BaseViewProperties as H, type BaseParsedViewProperties as I, type ViewWithNotation as J, type ViewWithHash as K, type LikeC4ProjectStylesConfig as L, type ModelGlobals as M, type NodeNotation as N, type ComputedNode as O, type Point as P, type ComputedEdge as Q, RectBox as R, type Specification as S, type TagSpecification as T, type ComputedElementView as U, type ViewRuleGlobalStyle as V, type ComputedDeploymentView as W, type XYPoint as X, type ComputedDynamicView as Y, type DynamicStep as Z, type DynamicStepsSeries as _, type GlobalPredicates as a, getParallelStepsPrefix as a0, type DynamicViewStep as a1, isDynamicStep as a2, isDynamicStepsParallel as a3, isDynamicStepsSeries as a4, type DynamicViewIncludeRule as a5, type DynamicViewRule as a6, type DynamicViewDisplayVariant as a7, type ParsedDynamicView as a8, type ElementViewIncludePredicate as a9, type ElementViewExcludePredicate as aa, type ElementViewPredicate as ab, type ElementViewRuleGroup as ac, isViewRuleGroup as ad, type ElementViewRuleStyle as ae, type ElementViewRule as af, type ParsedElementView as ag, type GlobalDynamicPredicates as b, type GlobalStyleID as c, type GlobalStyles as d, ensureSizes as e, type Element as f, type Relationship as g, type ModelRelation as h, type ElementSpecification as i, isTagColorSpecified as j, type RelationshipSpecification as k, type LikeC4ProjectTheme as l, type LikeC4ProjectStyleDefaults as m, type LikeC4ProjectManualLayoutsConfig as n, type LikeC4Project as o, type AnyIncludePredicate as p, type AnyExcludePredicate as q, type AnyViewRuleStyle as r, isViewRuleGlobalStyle as s, type ViewRuleGlobalPredicateRef as t, isViewRuleGlobalPredicateRef as u, type AutoLayoutDirection as v, isAutoLayoutDirection as w, type ViewRuleAutoLayout as x, isViewRuleAutoLayout as y, type ViewAutoLayout as z };

package/dist/shared/core.oSV6SRfk.mjs

@@ -0,0 +1,13 @@
+import { i as invariant } from './core.D4npX2q8.mjs';
+
+function stringHash(str) {
+  let hash = 5381;
+  const len = str.length;
+  invariant(len > 0, "stringHash: empty string");
+  for (let i = 0; i < len; i++) {
+    hash = hash * 33 ^ str.charCodeAt(i);
+  }
+  return (hash >>> 0).toString(36);
+}
+
+export { stringHash as s };

package/dist/shared/core.q10OP9oJ.mjs

@@ -0,0 +1,5 @@
+import { t as t$1 } from './core.BsSXS-_R.mjs';
+
+function t(...t){return t$1(n,t)}const n=(e,t)=>[...e,...t];
+
+export { t };

package/dist/shared/{core.BXs4wY7R.d.mts → core.t3qfsVvn.d.mts}

@@ -1,7 +1,7 @@
-import { C as Connection, c as customInspectSymbol } from './core.DTdfiejA.mjs';
-import { e as DeploymentElementModel, h as RelationshipsAccum, D as DeploymentNodeModel, R as RelationshipModel, b as DeploymentRelationModel } from './core.CcJ1FZ7h.mjs';
-import { A as Any, v as EdgeId } from './core.hNWo20Ym.mjs';
-import { c as IteratorLike } from './core.D5fzJWbF.mjs';
+import { C as Connection, c as customInspectSymbol } from './core.Cog93roC.mjs';
+import { e as DeploymentElementModel, h as RelationshipsAccum, D as DeploymentNodeModel, R as RelationshipModel, b as DeploymentRelationModel } from './core.CpURdWRM.mjs';
+import { A as Any, z as EdgeId } from './core.B73yxfPi.mjs';
+import { c as IteratorLike } from './core.DB0Ue5Wx.mjs';
 
 /**
  * Connection is ephemeral entity, result of a resolving relationships between source and target.

package/dist/shared/core.uFk_o9X6.mjs

@@ -0,0 +1,13 @@
+function ihead(iterable) {
+  if (!iterable) {
+    return _head;
+  }
+  return _head(iterable);
+}
+function _head(iter) {
+  const iterator = iter[Symbol.iterator]();
+  const { value } = iterator.next();
+  return value;
+}
+
+export { ihead as i };