@likec4/core 1.32.2 → 1.33.0

package/dist/shared/{core.Bdz6fBF1.d.mts → core.1pNeDdRk.d.mts}

@@ -1,6 +1,8 @@
-import { TupleToUnion, Tagged, Simplify, MergeExclusive, NonEmptyTuple, IsNever, IsAny } from 'type-fest';
-import { f as ExclusiveUnion, d as NonEmptyArray, i as Icon, L as Link, R as RelationId, T as Tag$1, N as NodeId, E as EdgeId, r as StepEdgeKind, K as KeysOf } from './core.BuO4ncfY.mjs';
-import { A as Any, U as Unknown, g as ElementId, P as ProjectId, F as Fqn, u as DeploymentId, v as Tag, y as AllKinds, T as Tags, n as StrictViewId, l as ElementKind, W as WithOptionalTags, z as WithOptionalLinks, _ as _stage, f as _type, B as WithMetadata, j as Metadata, R as RelationKind, V as ViewId, q as DeploymentFqn, D as DeploymentKind, k as MetadataKey, E as ExtractOnStage, M as ModelStage, e as UnknownParsed, c as UnknownComputed, d as UnknownLayouted, S as SpecAux, b as Aux, N as Never } from './core.CBxTtXMi.mjs';
+import { Simplify, MergeExclusive, Tagged, NonEmptyTuple, IsNever, IsAny } from 'type-fest';
+import { E as ExclusiveUnion, N as NonEmptyArray, L as Link, K as KeysOf } from './core.DuSLYTG6.mjs';
+import { A as Any, U as Unknown, g as ElementId, P as ProjectId, F as Fqn, s as DeploymentId, u as Tag, x as AllKinds, T as Tags, m as StrictViewId, k as ElementKind, W as WithOptionalTags, y as WithOptionalLinks, _ as _stage, f as _type, z as WithMetadata, h as Metadata, R as RelationKind, V as ViewId, p as DeploymentFqn, D as DeploymentKind, j as MetadataKey, E as ExtractOnStage, M as ModelStage, e as UnknownParsed, c as UnknownComputed, d as UnknownLayouted, S as SpecAux, b as Aux, N as Never } from './core.De___iBS.mjs';
+import { I as Icon, M as MarkdownOrString, d as RelationId, T as Tag$1, N as NodeId, j as EdgeId, m as StepEdgeKind } from './core.668kXpZq.mjs';
+import { i as Color, R as RelationshipLineType, f as RelationshipArrowType, c as ElementShape, b as BorderStyle, a as ShapeSize, S as SpacingSize, T as TextSize, h as ThemeColor, C as ColorLiteral, e as CustomColorDefinitions } from './core.CzdwsPmY.mjs';
 
 declare namespace FqnRef {
     /**
@@ -107,72 +109,6 @@ type Filterable<A extends Any> = {
 type OperatorPredicate<A extends Any> = (value: Filterable<A>) => boolean;
 declare function whereOperatorAsPredicate<A extends Any>(operator: WhereOperator<A>): OperatorPredicate<A>;
 
-/**
- * For padding, margin, etc.
- */
-type SpacingSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-type TextSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-type ShapeSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-declare const BorderStyles: readonly ["solid", "dashed", "dotted", "none"];
-type BorderStyle = TupleToUnion<typeof BorderStyles>;
-declare const ElementShapes: readonly ["rectangle", "person", "browser", "mobile", "cylinder", "storage", "queue"];
-type ElementShape = TupleToUnion<typeof ElementShapes>;
-type HexColor = `#${string}`;
-type ColorLiteral = HexColor | `rgb(${number},${number},${number})` | `rgba(${number},${number},${number},${number})`;
-type CustomColor<T = string> = Tagged<T, 'CustomColor'>;
-type CustomColorDefinitions = {
-    [key: string]: ThemeColorValues;
-};
-type RelationshipLineType = 'dashed' | 'solid' | 'dotted';
-type RelationshipArrowType = 'none' | 'normal' | 'onormal' | 'dot' | 'odot' | 'diamond' | 'odiamond' | 'crow' | 'open' | 'vee';
-declare const ThemeColors: readonly ["amber", "blue", "gray", "slate", "green", "indigo", "muted", "primary", "red", "secondary", "sky"];
-type ThemeColor = typeof ThemeColors[number];
-/**
- * Backward compatibility alias
- * @deprecated Use {@link ThemeColor} instead
- */
-type Color = ThemeColor | ColorLiteral;
-declare function isThemeColor(color: string): color is ThemeColor;
-interface ElementThemeColorValues {
-    fill: ColorLiteral;
-    stroke: ColorLiteral;
-    hiContrast: ColorLiteral;
-    loContrast: ColorLiteral;
-}
-type ElementThemeColors = {
-    [key in ThemeColor]: ElementThemeColorValues;
-};
-interface RelationshipThemeColorValues {
-    lineColor: ColorLiteral;
-    labelBgColor: ColorLiteral;
-    labelColor: ColorLiteral;
-}
-interface ThemeColorValues {
-    elements: ElementThemeColorValues;
-    relationships: RelationshipThemeColorValues;
-}
-type RelationshipThemeColors = {
-    [key in ThemeColor]: RelationshipThemeColorValues;
-};
-interface LikeC4Theme {
-    font: 'Arial';
-    shadow: ColorLiteral;
-    relationships: RelationshipThemeColors;
-    elements: ElementThemeColors;
-    sizes: {
-        [key in ShapeSize]: {
-            width: number;
-            height: number;
-        };
-    };
-    spacing: {
-        [key in SpacingSize]: number;
-    };
-    textSizes: {
-        [key in TextSize]: number;
-    };
-}
-
 type PredicateSelector = 'children' | 'expanded' | 'descendants';
 declare namespace FqnExpr {
     type Wildcard = {
@@ -646,7 +582,7 @@ type ViewType = 'element' | 'dynamic' | 'deployment';
 interface BaseViewProperties<A extends Any> extends WithOptionalTags<A>, WithOptionalLinks {
     readonly id: StrictViewId<A>;
     readonly title: string | null;
-    readonly description: string | null;
+    readonly description: MarkdownOrString | null;
     /**
      * For all views we find common ancestor path.
      * This is used to generate relative paths, i.e.:
@@ -809,7 +745,7 @@ interface Element<A extends Any = Any> extends WithOptionalTags<A>, WithOptional
     readonly id: Fqn<A>;
     readonly kind: ElementKind<A>;
     readonly title: string;
-    readonly description?: string | null;
+    readonly description?: MarkdownOrString | null;
     readonly technology?: string | null;
     readonly tags?: Tags<A> | null;
     readonly links?: readonly Link[] | null;
@@ -817,7 +753,7 @@ interface Element<A extends Any = Any> extends WithOptionalTags<A>, WithOptional
     readonly shape?: ElementShape;
     readonly color?: Color;
     readonly style?: ElementStyle;
-    readonly notation?: string;
+    readonly notation?: string | null;
     readonly metadata?: Metadata<A>;
 }
 declare const DefaultLineStyle: RelationshipLineType;
@@ -826,7 +762,7 @@ declare const DefaultRelationshipColor: ThemeColor;
 interface AbstractRelationship<A extends Any> extends WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A> {
     readonly id: RelationId;
     readonly title?: string | null;
-    readonly description?: string | null;
+    readonly description?: MarkdownOrString | null;
     readonly technology?: string | null;
     readonly kind?: RelationKind<A>;
     readonly color?: Color;
@@ -861,12 +797,12 @@ interface DeploymentNode<A extends Any = Unknown> extends WithOptionalTags<A>, W
     readonly id: DeploymentFqn<A>;
     readonly kind: DeploymentKind<A>;
     readonly title: string;
-    readonly description?: string | null;
+    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 notation?: string | null;
     readonly metadata?: Metadata<A>;
 }
 interface DeployedInstance<A extends Any = Unknown> extends WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A> {
@@ -878,7 +814,7 @@ interface DeployedInstance<A extends Any = Unknown> extends WithOptionalTags<A>,
     readonly id: DeploymentFqn<A>;
     readonly element: Fqn<A>;
     readonly title?: string;
-    readonly description?: string | null;
+    readonly description?: MarkdownOrString | null;
     readonly technology?: string | null;
     readonly tags?: Tags<A> | null;
     readonly links?: readonly Link[] | null;
@@ -966,16 +902,14 @@ interface ComputedNode<A extends Any = Any> extends WithOptionalLinks {
     parent: NodeId | null;
     /**
      * Reference to model element
-     * If 1 - node id is a reference
      */
     modelRef?: Fqn<A> | undefined;
     /**
      * Reference to deployment element
-     * If 1 - node id is a reference
      */
     deploymentRef?: DeploymentFqn<A> | undefined;
     title: string;
-    description?: string | null;
+    description?: MarkdownOrString | null;
     technology?: string | null;
     notation?: string;
     children: NodeId[];
@@ -1000,7 +934,7 @@ interface ComputedEdge<A extends Any = Any> extends WithOptionalTags<A> {
     source: NodeId;
     target: NodeId;
     label: string | null;
-    description?: string;
+    description?: MarkdownOrString | null;
     technology?: string;
     relations: RelationId[];
     kind?: RelationKind<A> | typeof StepEdgeKind;
@@ -1261,4 +1195,81 @@ type LikeC4ModelDump = {
 };
 type AuxFromDump<D> = D extends LikeC4ModelDump ? Aux<D[_stage] extends infer S extends string & 'computed' | 'layouted' ? S : 'computed' | 'layouted' | 'parsed', KeysOf<D['elements']>, KeysOf<D['deployments']['elements']>, KeysOf<D['views']>, D['projectId'] extends infer P extends string ? P : never, SpecTypesFromDump<D['specification']>> : Never;
 
-export { type TagSpecification as $, type AuxFromLikeC4ModelData as A, BBox as B, type ColorLiteral as C, type DeploymentElementStyle as D, Expression as E, FqnExpr as F, type GlobalPredicateId as G, DefaultElementShape as H, DefaultShapeSize as I, DefaultPaddingSize as J, DefaultTextSize as K, type LikeC4Theme as L, ModelFqnExpr as M, type ElementStyle as N, type Element as O, type PredicateSelector as P, DefaultLineStyle as Q, RelationExpr as R, type SpecificationDump as S, type ThemeColorValues as T, DefaultArrowType as U, DefaultRelationshipColor as V, type AbstractRelationship as W, type XYPoint as X, type Relationship as Y, type ModelRelation as Z, type ElementSpecification as _, ModelRelationExpr as a, isViewRuleGlobalStyle as a$, isTagColorSpecified as a0, type RelationshipSpecification as a1, type Specification as a2, type EqualOperator as a3, type TagEqual as a4, isTagEqual as a5, type KindEqual as a6, isKindEqual as a7, type Participant as a8, type ParticipantOperator as a9, isThemeColor as aA, type ElementThemeColorValues as aB, type ElementThemeColors as aC, type RelationshipThemeColorValues as aD, type RelationshipThemeColors as aE, type ParsedView as aF, type LayoutedView as aG, isDiagramView as aH, type ComputedView as aI, type ProcessedView as aJ, type AnyView as aK, type ViewOnStage as aL, type ViewWithType as aM, type ViewRule as aN, type ViewRulePredicate as aO, isViewRulePredicate as aP, isViewRuleStyle as aQ, isComputedView as aR, isElementView as aS, isScopedElementView as aT, isExtendsElementView as aU, isDeploymentView as aV, isDynamicView as aW, type AnyIncludePredicate as aX, type AnyExcludePredicate as aY, type AnyViewRuleStyle as aZ, type ViewRuleGlobalStyle as a_, isParticipantOperator as aa, type NotOperator as ab, isNotOperator as ac, type AndOperator as ad, isAndOperator as ae, type OrOperator as af, isOrOperator as ag, type WhereOperator as ah, type Filterable as ai, type OperatorPredicate as aj, whereOperatorAsPredicate as ak, type SpacingSize as al, type TextSize as am, type ShapeSize as an, BorderStyles as ao, type BorderStyle as ap, ElementShapes as aq, type ElementShape as ar, type HexColor as as, type CustomColor as at, type CustomColorDefinitions as au, type RelationshipLineType as av, type RelationshipArrowType as aw, ThemeColors as ax, type ThemeColor as ay, type Color as az, ModelExpression as b, type ViewRuleGlobalPredicateRef as b0, isViewRuleGlobalPredicateRef as b1, type AutoLayoutDirection as b2, isAutoLayoutDirection as b3, type ViewRuleAutoLayout as b4, isViewRuleAutoLayout as b5, type ViewAutoLayout as b6, type ViewManualLayout as b7, type ViewType as b8, type BaseViewProperties as b9, type ParsedDynamicView as bA, isDynamicViewParallelSteps as bB, type ElementViewIncludePredicate as bC, type ElementViewExcludePredicate as bD, type ElementViewPredicate as bE, type ElementViewRuleGroup as bF, isViewRuleGroup as bG, type ElementViewRuleStyle as bH, type ElementViewRule as bI, type ParsedElementView as bJ, type BaseParsedViewProperties as ba, type NodeNotation as bb, type ViewWithNotation as bc, type ViewWithHash as bd, type ComputedNode as be, type ComputedEdge as bf, type ComputedElementView as bg, type ComputedDeploymentView as bh, type ComputedDynamicView as bi, type DiagramNode as bj, type DiagramEdge as bk, type LayoutedElementView as bl, type LayoutedDeploymentView as bm, type LayoutedDynamicView as bn, type DeploymentViewIncludePredicate as bo, type DeploymentViewExcludePredicate as bp, type DeploymentViewPredicate as bq, type DeploymentViewRuleStyle as br, type DeploymentViewRule as bs, type ParsedDeploymentView as bt, type DynamicViewStep as bu, type DynamicViewParallelSteps as bv, getParallelStepsPrefix as bw, type DynamicViewStepOrParallel as bx, type DynamicViewIncludeRule as by, type DynamicViewRule as bz, FqnRef as c, type Point as d, RectBox as e, type GlobalPredicates as f, type GlobalDynamicPredicates as g, type GlobalStyleID as h, type GlobalStyles as i, type ModelGlobals as j, type ParsedLikeC4ModelData as k, type ComputedLikeC4ModelData as l, type LayoutedLikeC4ModelData as m, type LikeC4ModelData as n, type DeploymentNode as o, type DeployedInstance as p, type DeploymentElement as q, type DeploymentElementRef as r, isDeploymentNode as s, isDeployedInstance as t, type DeploymentRelationship as u, type DeploymentRelation as v, type SpecTypesFromDump as w, type LikeC4ModelDump as x, type AuxFromDump as y, DefaultThemeColor as z };
+interface RichTextEmpty {
+    readonly isEmpty: true;
+    readonly isMarkdown: false;
+    readonly nonEmpty: false;
+    readonly $source: null;
+    readonly text: null;
+    readonly md: null;
+    readonly html: null;
+    equals(other: unknown): boolean;
+}
+interface RichTextNonEmpty {
+    readonly isEmpty: false;
+    readonly nonEmpty: true;
+    readonly isMarkdown: boolean;
+    readonly $source: MarkdownOrString;
+    readonly text: string;
+    readonly md: string;
+    readonly html: string;
+    equals(other: unknown): boolean;
+}
+type RichTextOrEmpty = RichTextNonEmpty | RichTextEmpty;
+/**
+ * RichText is a class that represents a potentially markdown string.
+ * It can be either a plain text or a markdown.
+ * It is used to represent the content of a node or a link.
+ */
+declare class RichText {
+    private static _cache;
+    /**
+     * Creates and memoizes a RichText instance.
+     * @see ElementModel.description
+     * @example
+     *
+     *  get description(): RichTextOrEmpty {
+     *    return RichText.memoize(this, this.$element.description)
+     *  }
+     */
+    static memoize(obj: object, source: MarkdownOrString | null | undefined): RichTextOrEmpty;
+    /**
+     * Creates a RichText instance from a source.
+     */
+    static from(source: RichTextOrEmpty | MarkdownOrString | string | null | undefined): RichTextOrEmpty;
+    /**
+     * This is a workaround for the fact that we need instance of RichText for `instanceof` checks
+     * It is invalid inheritance (returning `null` from getters), and we cast to @see RichTextEmpty
+     */
+    static EMPTY: RichTextEmpty;
+    readonly $source: Readonly<MarkdownOrString> | null;
+    readonly isEmpty: boolean;
+    readonly nonEmpty: boolean;
+    readonly isMarkdown: boolean;
+    /**
+     * Private constructor to prevent direct instantiation.
+     * Use {@link RichText.from} or {@link RichText.memoize} instead.
+     */
+    private constructor();
+    /**
+     * Returns the text content of the rich text.
+     * If the source is a string, it returns the string.
+     * If the source is a markdown, it returns the markdown.
+     */
+    get text(): string;
+    /**
+     * Returns the markdown content of the rich text.
+     * If the source is a string, it returns the string.
+     * If the source is a markdown, it returns the markdown.
+     */
+    get md(): string;
+    /**
+     * Returns the html content of the rich text.
+     * If the source is a string, it returns the string.
+     * If the source is a markdown, it returns the HTML.
+     */
+    get html(): string;
+    equals(other: unknown): boolean;
+}
+
+export { type TagSpecification as $, type AuxFromLikeC4ModelData as A, BBox as B, type ComputedLikeC4ModelData as C, type DeploymentElementStyle as D, Expression as E, FqnExpr as F, type GlobalPredicateId as G, DefaultThemeColor as H, DefaultElementShape as I, DefaultShapeSize as J, DefaultPaddingSize as K, type LayoutedLikeC4ModelData as L, ModelFqnExpr as M, DefaultTextSize as N, type ElementStyle as O, type PredicateSelector as P, type Element as Q, RichText as R, type SpecificationDump as S, DefaultLineStyle as T, DefaultArrowType as U, DefaultRelationshipColor as V, type AbstractRelationship as W, type XYPoint as X, type Relationship as Y, type ModelRelation as Z, type ElementSpecification as _, type RichTextEmpty as a, type DiagramNode as a$, isTagColorSpecified as a0, type RelationshipSpecification as a1, type Specification as a2, type EqualOperator as a3, type TagEqual as a4, isTagEqual as a5, type KindEqual as a6, isKindEqual as a7, type Participant as a8, type ParticipantOperator as a9, isExtendsElementView as aA, isDeploymentView as aB, isDynamicView as aC, type AnyIncludePredicate as aD, type AnyExcludePredicate as aE, type AnyViewRuleStyle as aF, type ViewRuleGlobalStyle as aG, isViewRuleGlobalStyle as aH, type ViewRuleGlobalPredicateRef as aI, isViewRuleGlobalPredicateRef as aJ, type AutoLayoutDirection as aK, isAutoLayoutDirection as aL, type ViewRuleAutoLayout as aM, isViewRuleAutoLayout as aN, type ViewAutoLayout as aO, type ViewManualLayout as aP, type ViewType as aQ, type BaseViewProperties as aR, type BaseParsedViewProperties as aS, type NodeNotation as aT, type ViewWithNotation as aU, type ViewWithHash as aV, type ComputedNode as aW, type ComputedEdge as aX, type ComputedElementView as aY, type ComputedDeploymentView as aZ, type ComputedDynamicView as a_, isParticipantOperator as aa, type NotOperator as ab, isNotOperator as ac, type AndOperator as ad, isAndOperator as ae, type OrOperator as af, isOrOperator as ag, type WhereOperator as ah, type Filterable as ai, type OperatorPredicate as aj, whereOperatorAsPredicate as ak, type ParsedView as al, type LayoutedView as am, isDiagramView as an, type ComputedView as ao, type ProcessedView as ap, type AnyView as aq, type ViewOnStage as ar, type ViewWithType as as, type ViewRule as at, type ViewRulePredicate as au, isViewRulePredicate as av, isViewRuleStyle as aw, isComputedView as ax, isElementView as ay, isScopedElementView as az, type RichTextOrEmpty as b, type DiagramEdge as b0, type LayoutedElementView as b1, type LayoutedDeploymentView as b2, type LayoutedDynamicView as b3, type DeploymentViewIncludePredicate as b4, type DeploymentViewExcludePredicate as b5, type DeploymentViewPredicate as b6, type DeploymentViewRuleStyle as b7, type DeploymentViewRule as b8, type ParsedDeploymentView as b9, type DynamicViewStep as ba, type DynamicViewParallelSteps as bb, getParallelStepsPrefix as bc, type DynamicViewStepOrParallel as bd, type DynamicViewIncludeRule as be, type DynamicViewRule as bf, type ParsedDynamicView as bg, isDynamicViewParallelSteps as bh, type ElementViewIncludePredicate as bi, type ElementViewExcludePredicate as bj, type ElementViewPredicate as bk, type ElementViewRuleGroup as bl, isViewRuleGroup as bm, type ElementViewRuleStyle as bn, type ElementViewRule as bo, type ParsedElementView as bp, RelationExpr as c, ModelRelationExpr as d, ModelExpression as e, FqnRef as f, type Point as g, RectBox as h, type GlobalPredicates as i, type GlobalDynamicPredicates as j, type GlobalStyleID as k, type GlobalStyles as l, type ModelGlobals as m, type ParsedLikeC4ModelData as n, type LikeC4ModelData as o, type DeploymentNode as p, type DeployedInstance as q, type DeploymentElement as r, type DeploymentElementRef as s, isDeploymentNode as t, isDeployedInstance as u, type DeploymentRelationship as v, type DeploymentRelation as w, type SpecTypesFromDump as x, type LikeC4ModelDump as y, type AuxFromDump as z };

package/dist/shared/{core.BuO4ncfY.d.mts → core.668kXpZq.d.mts}

@@ -1,60 +1,48 @@
-import { IsAny, UnionToIntersection, Simplify, Tagged } from 'type-fest';
+import { Tagged } from 'type-fest';
 
-type NonEmptyArray<T> = [T, ...T[]];
-type NonEmptyReadonlyArray<T> = readonly [T, ...T[]];
-type KeysOf<T> = keyof T extends infer K extends string ? K : never;
-type AllNever<Expressions> = UnionToIntersection<{
-    [Name in keyof Expressions]: {
-        -readonly [Key in keyof Expressions[Name]]?: never;
-    };
-}[keyof Expressions]>;
+type ProjectId<T = string> = Tagged<T, 'ProjectID'>;
+type MarkdownOrString = {
+    txt: string;
+    md?: never;
+} | {
+    md: string;
+    txt?: never;
+};
 /**
+ * Converts a MarkdownOrString object or a plain string into a simple string representation.
+ * This utility function handles different types of text content and normalizes them to a string format.
+ *
+ * @param value - The content to be flattened.
+ *   Can be one of:
+ *   - A plain string
+ *   - A MarkdownOrString object with either txt or md property
+ *   - undefined or null
+ *
+ * @returns The string content contained within the input value.
+ *   - Returns the input directly if it's already a string
+ *   - Returns the txt property if available in a MarkdownOrString object
+ *   - Falls back to the md property if txt is not available
+ *   - Returns null if:
+ *     - The input is null or undefined
+ *     - The resulting string value is empty, whitespace, or null
+ *
  * @example
- * ```ts
- *   type Variant1 = {
- *     a: string
- *   }
- *   type Variant2 = {
- *     b: number
- *   }
+ * // String input
+ * flattenMarkdownOrString("Hello world") // Returns: "Hello world"
+ * flattenMarkdownOrString("   ") // Returns: null
  *
- *   type Variants = ExclusiveUnion<{
- *     Variant1: Variant1,
- *     Variant2: Variant2
- *   }>
+ * // MarkdownOrString with txt property
+ * flattenMarkdownOrString({ txt: "Plain text" }) // Returns: "Plain text"
+ * flattenMarkdownOrString({ txt: "   " }) // Returns: null
  *
- *   // Fail here
- *   const variant1: Variants = {
- *      a: 'one',
- *      b: 1
- *   }
- * ```
- */
-type ExclusiveUnion<Expressions, All = AllNever<Expressions>> = Expressions extends object ? {
-    [Name in keyof Expressions]: Simplify<Omit<All, keyof Expressions[Name]> & Expressions[Name]>;
-}[keyof Expressions] : never;
-/**
- * Copy from https://github.com/remeda/remeda/blob/main/src/internal/types/NTuple.ts
- * An array with *exactly* N elements in it.
+ * // MarkdownOrString with md property
+ * flattenMarkdownOrString({ md: "**Bold markdown**" }) // Returns: "**Bold markdown**"
  *
- * Only literal N values are supported. For very large N the type might result
- * in a recurse depth error. For negative N the type would result in an infinite
- * recursion. None of these have protections because this is an internal type!
+ * // Null input
+ * flattenMarkdownOrString(null) // Returns: null
  */
-type NTuple<T, N extends number, Result extends Array<unknown> = []> = Result['length'] extends N ? Result : NTuple<T, N, [...Result, T]>;
-type IteratorLike<T> = IteratorObject<T, BuiltinIteratorReturn>;
-type Predicate<T> = (x: T) => boolean;
-interface Link {
-    title?: string;
-    url: string;
-    relative?: string;
-}
-/**
- * Coalesce `V` to a string if it is `any`
- */
-type Coalesce<V extends string, OrIfAny = string> = IsAny<V> extends true ? OrIfAny : V;
-
-type ProjectId<T = string> = Tagged<T, 'ProjectID'>;
+declare function flattenMarkdownOrString(value: MarkdownOrString | string): string;
+declare function flattenMarkdownOrString(value: MarkdownOrString | string | undefined | null): string | null;
 type BuiltInIcon = 'none' | `${'aws' | 'azure' | 'gcp' | 'tech'}:${string}`;
 type Icon = Tagged<string, 'Icon'> | BuiltInIcon;
 type IconUrl = Icon;
@@ -123,6 +111,7 @@ declare const scalar_GlobalFqn: typeof GlobalFqn;
 type scalar_GroupElementKind = GroupElementKind;
 type scalar_Icon = Icon;
 type scalar_IconUrl = IconUrl;
+type scalar_MarkdownOrString = MarkdownOrString;
 declare const scalar_NodeId: typeof NodeId;
 type scalar_ProjectId<T = string> = ProjectId<T>;
 declare const scalar_RelationId: typeof RelationId;
@@ -134,13 +123,14 @@ declare const scalar_StepEdgeKind: typeof StepEdgeKind;
 type scalar_Tag<T = string> = Tag<T>;
 declare const scalar_ViewId: typeof ViewId;
 declare const scalar_extractStep: typeof extractStep;
+declare const scalar_flattenMarkdownOrString: typeof flattenMarkdownOrString;
 declare const scalar_isGlobalFqn: typeof isGlobalFqn;
 declare const scalar_isGroupElementKind: typeof isGroupElementKind;
 declare const scalar_isStepEdgeId: typeof isStepEdgeId;
 declare const scalar_splitGlobalFqn: typeof splitGlobalFqn;
 declare const scalar_stepEdgeId: typeof stepEdgeId;
 declare namespace scalar {
-  export { type scalar_AnyFqn as AnyFqn, type scalar_BuiltInIcon as BuiltInIcon, scalar_DeploymentFqn as DeploymentFqn, type scalar_DeploymentKind as DeploymentKind, scalar_EdgeId as EdgeId, type scalar_ElementKind as ElementKind, scalar_Fqn as Fqn, scalar_GlobalFqn as GlobalFqn, type scalar_GroupElementKind as GroupElementKind, type scalar_Icon as Icon, type scalar_IconUrl as IconUrl, scalar_NodeId as NodeId, type scalar_ProjectId as ProjectId, scalar_RelationId as RelationId, type scalar_RelationKind as RelationKind, type scalar_RelationshipKind as RelationshipKind, type scalar_StepEdgeId as StepEdgeId, type scalar_StepEdgeIdLiteral as StepEdgeIdLiteral, scalar_StepEdgeKind as StepEdgeKind, type scalar_Tag as Tag, scalar_ViewId as ViewId, scalar_extractStep as extractStep, scalar_isGlobalFqn as isGlobalFqn, scalar_isGroupElementKind as isGroupElementKind, scalar_isStepEdgeId as isStepEdgeId, scalar_splitGlobalFqn as splitGlobalFqn, scalar_stepEdgeId as stepEdgeId };
+  export { type scalar_AnyFqn as AnyFqn, type scalar_BuiltInIcon as BuiltInIcon, scalar_DeploymentFqn as DeploymentFqn, type scalar_DeploymentKind as DeploymentKind, scalar_EdgeId as EdgeId, type scalar_ElementKind as ElementKind, scalar_Fqn as Fqn, scalar_GlobalFqn as GlobalFqn, type scalar_GroupElementKind as GroupElementKind, type scalar_Icon as Icon, type scalar_IconUrl as IconUrl, type scalar_MarkdownOrString as MarkdownOrString, scalar_NodeId as NodeId, type scalar_ProjectId as ProjectId, scalar_RelationId as RelationId, type scalar_RelationKind as RelationKind, type scalar_RelationshipKind as RelationshipKind, type scalar_StepEdgeId as StepEdgeId, type scalar_StepEdgeIdLiteral as StepEdgeIdLiteral, scalar_StepEdgeKind as StepEdgeKind, type scalar_Tag as Tag, scalar_ViewId as ViewId, scalar_extractStep as extractStep, scalar_flattenMarkdownOrString as flattenMarkdownOrString, scalar_isGlobalFqn as isGlobalFqn, scalar_isGroupElementKind as isGroupElementKind, scalar_isStepEdgeId as isStepEdgeId, scalar_splitGlobalFqn as splitGlobalFqn, scalar_stepEdgeId as stepEdgeId };
 }
 
-export { type AnyFqn as A, type BuiltInIcon as B, type Coalesce as C, DeploymentFqn as D, EdgeId as E, Fqn as F, GroupElementKind as G, type IteratorLike as I, type KeysOf as K, type Link as L, NodeId as N, type ProjectId as P, RelationId as R, type StepEdgeIdLiteral as S, type Tag as T, ViewId as V, type ElementKind as a, type DeploymentKind as b, type RelationshipKind as c, type NonEmptyArray as d, type NonEmptyReadonlyArray as e, type ExclusiveUnion as f, type NTuple as g, type Predicate as h, type Icon as i, type IconUrl as j, isGroupElementKind as k, type RelationKind as l, GlobalFqn as m, isGlobalFqn as n, splitGlobalFqn as o, type StepEdgeId as p, stepEdgeId as q, StepEdgeKind as r, scalar as s, isStepEdgeId as t, extractStep as u };
+export { type AnyFqn as A, type BuiltInIcon as B, DeploymentFqn as D, type ElementKind as E, Fqn as F, GroupElementKind as G, type Icon as I, type MarkdownOrString as M, NodeId as N, type ProjectId as P, type RelationKind as R, type StepEdgeIdLiteral as S, type Tag as T, ViewId as V, type IconUrl as a, type DeploymentKind as b, type RelationshipKind as c, RelationId as d, GlobalFqn as e, flattenMarkdownOrString as f, isGlobalFqn as g, splitGlobalFqn as h, isGroupElementKind as i, EdgeId as j, type StepEdgeId as k, stepEdgeId as l, StepEdgeKind as m, isStepEdgeId as n, extractStep as o, scalar as s };

package/dist/shared/core.8KM0D6va.mjs

@@ -0,0 +1,33 @@
+function n(e){return e!==void 0}
+
+function l(n){return n!=null}
+
+function isIterable(something) {
+  return l(something) && typeof something === "object" && Symbol.iterator in something;
+}
+
+function iflat(iterable) {
+  return iterable ? _iflat(iterable) : _iflat;
+}
+function* _iflat(iterable) {
+  for (const inner of iterable) {
+    yield* inner;
+  }
+  return;
+}
+
+function iunique(iterable) {
+  return iterable ? _iunique(iterable) : _iunique;
+}
+function* _iunique(iterable) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of iterable) {
+    if (!seen.has(item)) {
+      seen.add(item);
+      yield item;
+    }
+  }
+  return;
+}
+
+export { isIterable as a, iunique as b, iflat as i, l, n };

package/dist/shared/core.B0oEIXqd.mjs

@@ -0,0 +1,47 @@
+import rehypeRaw from 'rehype-raw';
+import rehypeSanitize from 'rehype-sanitize';
+import rehypeStringify from 'rehype-stringify';
+import remarkGfm from 'remark-gfm';
+import remarkParse from 'remark-parse';
+import remarkRehype from 'remark-rehype';
+import { unified } from 'unified';
+import { fromMarkdown } from 'mdast-util-from-markdown';
+import { toString } from 'mdast-util-to-string';
+
+function memoizeProp(obj, tag, fn) {
+  const tagSymbol = typeof tag === "symbol" ? tag : Symbol.for(tag);
+  if (!obj.hasOwnProperty(tagSymbol)) {
+    Object.defineProperty(obj, tagSymbol, {
+      enumerable: false,
+      writable: false,
+      value: fn()
+    });
+  }
+  return obj[tagSymbol];
+}
+
+function remark() {
+  return unified().use(remarkParse).use(remarkGfm).use(remarkRehype, {
+    // Tight paragraphs prevent extra newlines
+    allowDangerousHtml: true,
+    clobberPrefix: "",
+    tableCellPadding: false,
+    tight: true
+  }).use(rehypeRaw).use(rehypeSanitize).use(rehypeStringify, {
+    // Prevent extra closing newlines
+    closeSelfClosing: true,
+    tightSelfClosing: true
+  });
+}
+function markdownToHtml(markdown) {
+  return String(remark().processSync(markdown.trim())).trim();
+}
+
+function markdownToText(markdown) {
+  return toString(fromMarkdown(markdown), {
+    includeHtml: false,
+    includeImageAlt: false
+  });
+}
+
+export { markdownToHtml as a, markdownToText as b, memoizeProp as m };

package/dist/shared/core.BH9nN-_I.mjs

@@ -0,0 +1,22 @@
+import { i as invariant } from './core.D4npX2q8.mjs';
+
+function t(n){return typeof n=="function"}
+
+function ifilter(arg1, arg2) {
+  const pred = arg2 ?? arg1;
+  invariant(t(pred));
+  function* _filter(iter) {
+    for (const value of iter) {
+      if (pred(value)) {
+        yield value;
+      }
+    }
+    return;
+  }
+  if (!arg2) {
+    return _filter;
+  }
+  return _filter(arg1);
+}
+
+export { ifilter as i, t };

package/dist/shared/core.BMCb0wJI.mjs

@@ -0,0 +1,177 @@
+import { r as getDefaultExportFromCjs } from './core.C_C-3c1S.mjs';
+
+/**
+ * Mnemonist DefaultMap
+ * =====================
+ *
+ * JavaScript implementation of a default map that will return a constructed
+ * value any time one tries to access an inexisting key. It's quite similar
+ * to python's defaultdict.
+ */
+
+var defaultMap;
+var hasRequiredDefaultMap;
+
+function requireDefaultMap () {
+	if (hasRequiredDefaultMap) return defaultMap;
+	hasRequiredDefaultMap = 1;
+	/**
+	 * DefaultMap.
+	 *
+	 * @constructor
+	 */
+	function DefaultMap(factory) {
+	  if (typeof factory !== 'function')
+	    throw new Error('mnemonist/DefaultMap.constructor: expecting a function.');
+
+	  this.items = new Map();
+	  this.factory = factory;
+	  this.size = 0;
+	}
+
+	/**
+	 * Method used to clear the structure.
+	 *
+	 * @return {undefined}
+	 */
+	DefaultMap.prototype.clear = function() {
+
+	  // Properties
+	  this.items.clear();
+	  this.size = 0;
+	};
+
+	/**
+	 * Method used to get the value set for given key. If the key does not exist,
+	 * the value will be created using the provided factory.
+	 *
+	 * @param  {any} key - Target key.
+	 * @return {any}
+	 */
+	DefaultMap.prototype.get = function(key) {
+	  var value = this.items.get(key);
+
+	  if (typeof value === 'undefined') {
+	    value = this.factory(key, this.size);
+	    this.items.set(key, value);
+	    this.size++;
+	  }
+
+	  return value;
+	};
+
+	/**
+	 * Method used to get the value set for given key. If the key does not exist,
+	 * a value won't be created.
+	 *
+	 * @param  {any} key - Target key.
+	 * @return {any}
+	 */
+	DefaultMap.prototype.peek = function(key) {
+	  return this.items.get(key);
+	};
+
+	/**
+	 * Method used to set a value for given key.
+	 *
+	 * @param  {any} key   - Target key.
+	 * @param  {any} value - Value.
+	 * @return {DefaultMap}
+	 */
+	DefaultMap.prototype.set = function(key, value) {
+	  this.items.set(key, value);
+	  this.size = this.items.size;
+
+	  return this;
+	};
+
+	/**
+	 * Method used to test the existence of a key in the map.
+	 *
+	 * @param  {any} key   - Target key.
+	 * @return {boolean}
+	 */
+	DefaultMap.prototype.has = function(key) {
+	  return this.items.has(key);
+	};
+
+	/**
+	 * Method used to delete target key.
+	 *
+	 * @param  {any} key   - Target key.
+	 * @return {boolean}
+	 */
+	DefaultMap.prototype.delete = function(key) {
+	  var deleted = this.items.delete(key);
+
+	  this.size = this.items.size;
+
+	  return deleted;
+	};
+
+	/**
+	 * Method used to iterate over each of the key/value pairs.
+	 *
+	 * @param  {function}  callback - Function to call for each item.
+	 * @param  {object}    scope    - Optional scope.
+	 * @return {undefined}
+	 */
+	DefaultMap.prototype.forEach = function(callback, scope) {
+	  scope = arguments.length > 1 ? scope : this;
+
+	  this.items.forEach(callback, scope);
+	};
+
+	/**
+	 * Iterators.
+	 */
+	DefaultMap.prototype.entries = function() {
+	  return this.items.entries();
+	};
+
+	DefaultMap.prototype.keys = function() {
+	  return this.items.keys();
+	};
+
+	DefaultMap.prototype.values = function() {
+	  return this.items.values();
+	};
+
+	/**
+	 * Attaching the #.entries method to Symbol.iterator if possible.
+	 */
+	if (typeof Symbol !== 'undefined')
+	  DefaultMap.prototype[Symbol.iterator] = DefaultMap.prototype.entries;
+
+	/**
+	 * Convenience known methods.
+	 */
+	DefaultMap.prototype.inspect = function() {
+	  return this.items;
+	};
+
+	if (typeof Symbol !== 'undefined')
+	  DefaultMap.prototype[Symbol.for('nodejs.util.inspect.custom')] = DefaultMap.prototype.inspect;
+
+	/**
+	 * Typical factories.
+	 */
+	DefaultMap.autoIncrement = function() {
+	  var i = 0;
+
+	  return function() {
+	    return i++;
+	  };
+	};
+
+	/**
+	 * Exporting.
+	 */
+	defaultMap = DefaultMap;
+	return defaultMap;
+}
+
+var defaultMapExports = /*@__PURE__*/ requireDefaultMap();
+const DefaultMap = /*@__PURE__*/getDefaultExportFromCjs(defaultMapExports);
+
+export { DefaultMap as D };