likec4 1.8.2-next.0 → 1.8.2-next.1

package/README.md

@@ -12,7 +12,7 @@ Features:
 ## Install
 
 > **Compatibility Note:**\
-> LikeC4 requires [Node.js](https://nodejs.org/en/) version 18+, 20+
+> LikeC4 requires [Node.js](https://nodejs.org/en/) version 20+
 
 ### Local installation
 
@@ -154,6 +154,12 @@ likec4 codegen ts ...
 > Output file should have `.ts` extension\
 > By default, it generates `likec4.generated.ts` in current directory
 
+## API Usage
+
+LikeC4 model can be accessed 
+
+
+
 ## Development
 
 In root workspace:

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import {Z as getDocument,_ as findNodesForProperty,$ as TreeStreamImpl,a0 as NEWLINE_REGEXP,a1 as isAstNode,a2 as e,a3 as x,a4 as i,a5 as T,a6 as n,a7 as t,a8 as f,a9 as pLimit,aa as logger,ab as l,ac as createLikeC4Logger,ad as withTrailingSlash,ae as hasProtocol,af as withLeadingSlash,ag as d,ah as u,L as LikeC4,ai as i3,aj as inMillis,ak as startTimer,al as nonexhaustive,am as invariant,an as stripIndent,ao as i$1,ap as delay,aq as LogLevels,ar as pkg}from'../shared/likec4.BOI-5rb_.mjs';import {hrtime,cwd,argv,stdout,exit}from'node:process';import yargs from'yargs';import {hideBin}from'yargs/helpers';import {resolve,dirname,join,extname,relative,isAbsolute,basename}from'node:path';import {existsSync,copyFileSync,rmSync}from'node:fs';import {mkdtemp,writeFile,mkdir,stat,copyFile,rm}from'node:fs/promises';import os,{tmpdir}from'node:os';import {fileURLToPath}from'node:url';import {build,createServer,preview}from'vite';import {chromium}from'playwright';import net from'node:net';import {setTimeout as setTimeout$1}from'node:timers/promises';import {resolve as resolve$1}from'path';import react from'@vitejs/plugin-react';const path = {
+import {X as getDocument,Y as findNodesForProperty,Z as TreeStreamImpl,_ as NEWLINE_REGEXP,$ as isAstNode,a0 as e,a1 as x,a2 as i,a3 as T,a4 as n,a5 as t,a6 as f,a7 as pLimit,a8 as logger,a9 as l,aa as createLikeC4Logger,ab as withTrailingSlash,ac as hasProtocol,ad as withLeadingSlash,ae as d,af as u,L as LikeC4,ag as i3,ah as inMillis,ai as startTimer,aj as nonexhaustive,ak as invariant,al as stripIndent,am as i$1,an as delay,ao as LogLevels,ap as pkg}from'../shared/likec4.DNb51-HM.mjs';import {hrtime,cwd,argv,stdout,exit}from'node:process';import yargs from'yargs';import {hideBin}from'yargs/helpers';import {resolve,dirname,join,extname,relative,isAbsolute,basename}from'node:path';import {existsSync,copyFileSync,rmSync}from'node:fs';import {mkdtemp,writeFile,mkdir,stat,copyFile,rm}from'node:fs/promises';import os,{tmpdir}from'node:os';import {fileURLToPath}from'node:url';import {build,createServer,preview}from'vite';import {chromium}from'playwright';import net from'node:net';import {setTimeout as setTimeout$1}from'node:timers/promises';import {resolve as resolve$1}from'path';import react from'@vitejs/plugin-react';const path = {
   type: "string",
   desc: "<directory> with LikeC4 sources (default is current directory)",
   normalize: true,
@@ -3920,7 +3920,7 @@ async function pngHandler({
 }) {
   const logger = createLikeC4Logger("c4:export");
   const startTakeScreenshot = hrtime();
-  const languageServices = await LikeC4.initForWorkspace(path, {
+  const languageServices = await LikeC4.fromWorkspace(path, {
     logger: "vite",
     graphviz: useDotBin ? "binary" : "wasm"
   });
@@ -3992,8 +3992,7 @@ async function buildHandler({
   base
 }) {
   const logger = createLikeC4Logger("c4:build");
-  const languageServices = await LikeC4.initForWorkspace(path, {
-    logger: "vite",
+  const languageServices = await LikeC4.fromWorkspace(path, {
     graphviz: useDotBin ? "binary" : "wasm"
   });
   const outDir = outputDir ?? resolve(languageServices.workspace, "dist");
@@ -4146,7 +4145,7 @@ async function multipleFilesCodegenAction(languageServices, format, outdir, logg
 async function reactLegacyHandler({ path, useDotBin, ...outparams }) {
   const logger = createLikeC4Logger("c4:codegen");
   const timer = startTimer(logger);
-  const languageServices = await LikeC4.initForWorkspace(path, {
+  const languageServices = await LikeC4.fromWorkspace(path, {
     logger: "vite",
     graphviz: useDotBin ? "binary" : "wasm"
   });
@@ -4256,7 +4255,7 @@ async function reactLegacyHandler({ path, useDotBin, ...outparams }) {
 }async function reactHandler({ path, useDotBin, outfile }) {
   const logger$1 = createLikeC4Logger("c4:codegen");
   const timer = startTimer(logger$1);
-  const languageServices = await LikeC4.initForWorkspace(path, {
+  const languageServices = await LikeC4.fromWorkspace(path, {
     logger: "vite",
     graphviz: useDotBin ? "binary" : "wasm"
   });
@@ -4368,7 +4367,7 @@ export declare function LikeC4View({viewId, ...props}: LikeC4ViewProps): JSX.Ele
 }) {
   const logger$1 = createLikeC4Logger("c4:codegen");
   const timer = startTimer(logger$1);
-  const languageServices = await LikeC4.initForWorkspace(path, {
+  const languageServices = await LikeC4.fromWorkspace(path, {
     logger: "vite",
     graphviz: useDotBin ? "binary" : "wasm"
   });
@@ -4549,7 +4548,7 @@ export declare function LikeC4View({viewId, ...props}: LikeC4ViewProps): JSX.Ele
 };async function handler$2({ path, useDotBin, outfile }) {
   const logger = createLikeC4Logger("c4:export");
   const timer = startTimer(logger);
-  const languageServices = await LikeC4.initForWorkspace(path, {
+  const languageServices = await LikeC4.fromWorkspace(path, {
     logger: "vite",
     graphviz: useDotBin ? "binary" : "wasm"
   });
@@ -4681,7 +4680,7 @@ export declare function LikeC4View({viewId, ...props}: LikeC4ViewProps): JSX.Ele
   output: outputDir,
   base
 }) {
-  const languageServices = await LikeC4.initForWorkspace(path, {
+  const languageServices = await LikeC4.fromWorkspace(path, {
     logger: "vite"
   });
   const server = await vitePreview({ base, languageServices, outputDir, open: true });
@@ -4716,7 +4715,7 @@ export declare function LikeC4View({viewId, ...props}: LikeC4ViewProps): JSX.Ele
   useOverview = false,
   base
 }) {
-  const languageServices = await LikeC4.initForWorkspace(path, {
+  const languageServices = await LikeC4.fromWorkspace(path, {
     graphviz: useDotBin ? "binary" : "wasm"
   });
   const likec4AssetsDir = await mkdtemp(join(tmpdir(), ".likec4-assets-"));

package/dist/index.d.mts

@@ -1152,61 +1152,11 @@ type RelationID = LiteralUnion<RelationID$1, string>;
 type ViewID = LiteralUnion<ViewID$1, string>;
 type EdgeId = LiteralUnion<EdgeId$1, string>;
 
-/**
- * Represents an element in the view. (Diagram node)
- * All methods are view-scoped, i.e. `children` returns only children of the element in the view.
- */
-declare class ViewElement {
-    readonly node: ComputedNode;
-    private viewmodel;
-    constructor(node: ComputedNode, viewmodel: ViewModel);
-    get id(): NodeId;
-    get title(): string;
-    get kind(): ElementKind$1;
-    get isRoot(): boolean;
-    get hasNested(): boolean;
-    get shape(): ElementShape$1;
-    get color(): ThemeColor$1;
-    get tags(): Tag$1[];
-    model(): LikeC4Model.Element;
-    parent(): ViewElement | null;
-    metadata(key: string): string | undefined;
-    metadata(key: string, defaultValue: string): string;
-    hasMetadata(key: string): boolean;
-    ancestors(): ReadonlyArray<ViewElement>;
-    siblings(): ReadonlyArray<ViewElement>;
-    descendants(): ReadonlyArray<ViewElement>;
-    children(): ReadonlyArray<ViewElement>;
-    incoming(filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<ViewConnection>;
-    incomers(filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<ViewElement>;
-    outgoing(filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<ViewConnection>;
-    outgoers(filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<ViewElement>;
-    connectionsTo(target: Fqn | ViewElement): ReadonlyArray<ViewConnection>;
-}
-
-/**
- * Represents a connection between two elements.
- * May be source from multiple model relationships.
- */
-declare class ViewConnection {
-    readonly edge: ComputedEdge;
-    private viewmodel;
-    constructor(edge: ComputedEdge, viewmodel: ViewModel);
-    get id(): EdgeId$1;
-    get source(): ViewElement;
-    get target(): ViewElement;
-    get tags(): Tag$1[];
-    /**
-     * Model relationships
-     */
-    relationships(): ReadonlyArray<LikeC4Model.Relationship>;
-}
-
-type ElementOrFqn$1 = Fqn | ViewElement;
+type ElementOrFqn$1 = Fqn | LikeC4ViewModel.Element;
 /**
  * All methods are view-scoped, i.e. only return elements and connections in the view.
  */
-declare class ViewModel {
+declare class LikeC4ViewModel {
     #private;
     readonly view: ComputedView;
     readonly model: LikeC4Model;
@@ -1215,29 +1165,79 @@ declare class ViewModel {
     get title(): string;
     get viewOf(): LikeC4Model.Element;
     get tags(): Tag$1[];
-    roots(): ReadonlyArray<ViewElement>;
-    elements(): ReadonlyArray<ViewElement>;
-    element(id: Fqn): ViewElement;
+    roots(): ReadonlyArray<LikeC4ViewModel.Element>;
+    elements(): ReadonlyArray<LikeC4ViewModel.Element>;
+    element(id: Fqn): LikeC4ViewModel.Element;
     hasElement(id: Fqn): boolean;
-    connections(): ReadonlyArray<ViewConnection>;
-    connection(id: EdgeId): ViewConnection;
-    findConnections(source: ElementOrFqn$1, target: ElementOrFqn$1, direction?: 'both' | 'direct'): ReadonlyArray<ViewConnection>;
-    parent(element: ElementOrFqn$1): ViewElement | null;
-    children(element: ElementOrFqn$1): ReadonlyArray<ViewElement>;
-    siblings(element: ElementOrFqn$1): ReadonlyArray<ViewElement>;
+    connections(): ReadonlyArray<LikeC4ViewModel.Connection>;
+    connection(id: EdgeId): LikeC4ViewModel.Connection;
+    findConnections(source: ElementOrFqn$1, target: ElementOrFqn$1, direction?: 'both' | 'direct'): ReadonlyArray<LikeC4ViewModel.Connection>;
+    parent(element: ElementOrFqn$1): LikeC4ViewModel.Element | null;
+    children(element: ElementOrFqn$1): ReadonlyArray<LikeC4ViewModel.Element>;
+    siblings(element: ElementOrFqn$1): ReadonlyArray<LikeC4ViewModel.Element>;
     /**
      * Get all ancestor elements (i.e. parent, parent’s parent, etc.)
      * (from closest to root)
      */
-    ancestors(element: ElementOrFqn$1): ReadonlyArray<ViewElement>;
-    descendants(element: ElementOrFqn$1): ReadonlyArray<ViewElement>;
-    incoming(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<ViewConnection>;
-    incomers(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<ViewElement>;
+    ancestors(element: ElementOrFqn$1): ReadonlyArray<LikeC4ViewModel.Element>;
+    descendants(element: ElementOrFqn$1): ReadonlyArray<LikeC4ViewModel.Element>;
+    incoming(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4ViewModel.Connection>;
+    incomers(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4ViewModel.Element>;
     /**
      * Outgoing relationships from the element and its descendants
      */
-    outgoing(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<ViewConnection>;
-    outgoers(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<ViewElement>;
+    outgoing(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<LikeC4ViewModel.Connection>;
+    outgoers(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<LikeC4ViewModel.Element>;
+}
+declare namespace LikeC4ViewModel {
+    /**
+     * Represents an element in the view. (Diagram node)
+     * All methods are view-scoped, i.e. `children` returns only children of the element in the view.
+     */
+    class Element {
+        readonly node: ComputedNode;
+        private viewmodel;
+        constructor(node: ComputedNode, viewmodel: LikeC4ViewModel);
+        get id(): NodeId;
+        get title(): string;
+        get kind(): ElementKind$1;
+        get isRoot(): boolean;
+        get hasNested(): boolean;
+        get shape(): ElementShape$1;
+        get color(): ThemeColor$1;
+        get tags(): Tag$1[];
+        model(): LikeC4Model.Element;
+        parent(): LikeC4ViewModel.Element | null;
+        metadata(key: string): string | undefined;
+        metadata(key: string, defaultValue: string): string;
+        hasMetadata(key: string): boolean;
+        ancestors(): ReadonlyArray<LikeC4ViewModel.Element>;
+        siblings(): ReadonlyArray<LikeC4ViewModel.Element>;
+        descendants(): ReadonlyArray<LikeC4ViewModel.Element>;
+        children(): ReadonlyArray<LikeC4ViewModel.Element>;
+        incoming(filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4ViewModel.Connection>;
+        incomers(filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4ViewModel.Element>;
+        outgoing(filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<LikeC4ViewModel.Connection>;
+        outgoers(filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<LikeC4ViewModel.Element>;
+        connectionsTo(target: Fqn | LikeC4ViewModel.Element): ReadonlyArray<LikeC4ViewModel.Connection>;
+    }
+    /**
+     * Represents a connection between two elements.
+     * May be source from multiple model relationships.
+     */
+    class Connection {
+        readonly edge: ComputedEdge;
+        private viewmodel;
+        constructor(edge: ComputedEdge, viewmodel: LikeC4ViewModel);
+        get id(): EdgeId$1;
+        get source(): LikeC4ViewModel.Element;
+        get target(): LikeC4ViewModel.Element;
+        get tags(): Tag$1[];
+        /**
+         * Model relationships
+         */
+        relationships(): ReadonlyArray<LikeC4Model.Relationship>;
+    }
 }
 
 type ElementOrFqn = Fqn | LikeC4Model.Element;
@@ -1269,11 +1269,11 @@ declare class LikeC4Model {
     /**
      * Returns all views in the model.
      */
-    views(): ReadonlyArray<ViewModel>;
+    views(): ReadonlyArray<LikeC4ViewModel>;
     /**
      * Returns a specific view by its ID.
      */
-    view(viewId: ViewID): ViewModel;
+    view(viewId: ViewID): LikeC4ViewModel;
     /**
      * Returns the parent element of a given element.
      */
@@ -1294,7 +1294,6 @@ declare class LikeC4Model {
     descendants(element: ElementOrFqn): ReadonlyArray<LikeC4Model.Element>;
     /**
      * Incoming relationships to the element and its descendants
-     * @param onlyDirect - only direct incoming relationships, ignore descendants
      */
     incoming(element: ElementOrFqn, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4Model.Relationship>;
     /**
@@ -1321,7 +1320,7 @@ declare class LikeC4Model {
     /**
      * Resolve all views that contain the element
      */
-    viewsWithElement(element: ElementOrFqn): ReadonlyArray<ViewModel>;
+    viewsWithElement(element: ElementOrFqn): ReadonlyArray<LikeC4ViewModel>;
     private addElement;
     private addRelation;
     private _childrenOf;
@@ -1353,7 +1352,7 @@ declare namespace LikeC4Model {
         /**
          * Views that contain this element
          */
-        views(): readonly ViewModel[];
+        views(): readonly LikeC4ViewModel[];
         incoming(filter?: 'all' | 'direct' | 'to-descendants'): readonly Relationship[];
         incomers(filter?: 'all' | 'direct' | 'to-descendants'): readonly Element[];
         outgoing(filter?: 'all' | 'direct' | 'from-descendants'): readonly Relationship[];
@@ -4229,6 +4228,68 @@ declare namespace WorkspaceFolder {
     function is(value: any): value is WorkspaceFolder;
 }
 
+/**
+ * @hidden
+ */
+type $keywords<T extends string> = {
+  [key in T]: key;
+};
+
+declare module 'ts-graphviz' {
+    namespace ClusterSubgraphAttributeKey {
+        interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {
+        }
+    }
+    namespace NodeAttributeKey {
+        interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level'> {
+        }
+    }
+    namespace EdgeAttributeKey {
+        interface $values extends $keywords<'likec4_id'> {
+        }
+    }
+    namespace Attribute {
+        interface $keys extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {
+        }
+        interface $types {
+            likec4_type: 'folder' | 'file' | 'view';
+            likec4_path: string;
+            likec4_id: string;
+            likec4_level: number;
+            likec4_depth: number;
+        }
+    }
+}
+type DotSource = Tagged<string, 'DotSource'>;
+type DotLayoutResult = {
+    dot: DotSource;
+    diagram: DiagramView;
+};
+
+interface GraphvizPort {
+    unflatten(dot: DotSource): Promise<DotSource>;
+    acyclic(dot: DotSource): Promise<DotSource>;
+    layoutJson(dot: DotSource): Promise<string>;
+    svg(dot: DotSource): Promise<string>;
+}
+type LayoutResult = {
+    dot: DotSource;
+    diagram: DiagramView;
+};
+declare class GraphvizLayouter {
+    private graphviz;
+    constructor(graphviz: GraphvizPort);
+    get port(): GraphvizPort;
+    changePort(graphviz: GraphvizPort): void;
+    layout(view: ComputedView): Promise<LayoutResult>;
+    svg(view: ComputedView): Promise<{
+        svg: string;
+        dot: DotSource;
+    }>;
+    dot(computedView: ComputedView): Promise<DotSource>;
+    layoutOverviewGraph(views: ComputedView[]): Promise<OverviewGraph>;
+}
+
 type ParserMethod<ARGS extends unknown[], R> = (...args: ARGS) => R;
 
 /**
@@ -16101,68 +16162,6 @@ declare class LikeC4ModelParser {
     private convertLinks;
 }
 
-/**
- * @hidden
- */
-type $keywords<T extends string> = {
-  [key in T]: key;
-};
-
-declare module 'ts-graphviz' {
-    namespace ClusterSubgraphAttributeKey {
-        interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {
-        }
-    }
-    namespace NodeAttributeKey {
-        interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level'> {
-        }
-    }
-    namespace EdgeAttributeKey {
-        interface $values extends $keywords<'likec4_id'> {
-        }
-    }
-    namespace Attribute {
-        interface $keys extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {
-        }
-        interface $types {
-            likec4_type: 'folder' | 'file' | 'view';
-            likec4_path: string;
-            likec4_id: string;
-            likec4_level: number;
-            likec4_depth: number;
-        }
-    }
-}
-type DotSource = Tagged<string, 'DotSource'>;
-type DotLayoutResult = {
-    dot: DotSource;
-    diagram: DiagramView;
-};
-
-interface GraphvizPort {
-    unflatten(dot: DotSource): Promise<DotSource>;
-    acyclic(dot: DotSource): Promise<DotSource>;
-    layoutJson(dot: DotSource): Promise<string>;
-    svg(dot: DotSource): Promise<string>;
-}
-type LayoutResult = {
-    dot: DotSource;
-    diagram: DiagramView;
-};
-declare class GraphvizLayouter {
-    private graphviz;
-    constructor(graphviz: GraphvizPort);
-    get port(): GraphvizPort;
-    changePort(graphviz: GraphvizPort): void;
-    layout(view: ComputedView): Promise<LayoutResult>;
-    svg(view: ComputedView): Promise<{
-        svg: string;
-        dot: DotSource;
-    }>;
-    dot(computedView: ComputedView): Promise<DotSource>;
-    layoutOverviewGraph(views: ComputedView[]): Promise<OverviewGraph>;
-}
-
 // This definition file follows a somewhat unusual format. ESTree allows
 // runtime type checks based on the `type` parameter. In order to explain this
 // to typescript we want to use discriminated union types:
@@ -16777,6 +16776,26 @@ type Logger = {
     error(err: unknown): void;
 };
 
+declare class CliWorkspace {
+    private services;
+    private isInitialized;
+    constructor(services: CliServices);
+    initForWorkspace(workspacePath: string): Promise<void>;
+    init(): Promise<void>;
+}
+
+type CliAddedServices = {
+    logger: Logger;
+    likec4: {
+        Layouter: GraphvizLayouter;
+        Views: Views;
+    };
+    cli: {
+        Workspace: CliWorkspace;
+    };
+};
+type CliServices = LikeC4Services & CliAddedServices;
+
 type GraphvizOut = {
     id: ViewID$1;
     dot: DotSource;
@@ -16797,51 +16816,33 @@ declare class Views {
     overviewGraph(): Promise<OverviewGraph>;
 }
 
-declare class CliWorkspace {
-    private services;
-    private isInitialized;
-    constructor(services: CliServices);
-    initForWorkspace(workspacePath: string): Promise<void>;
-    init(): Promise<void>;
-}
-
-type CliAddedServices = {
-    logger: Logger;
-    likec4: {
-        Layouter: GraphvizLayouter;
-        Views: Views;
-    };
-    cli: {
-        Workspace: CliWorkspace;
-    };
-};
-type CliServices = LikeC4Services & CliAddedServices;
-type CreateLanguageServiceOptions = {
+type LikeC4Options = {
     /**
-     * Whether to use the file system for the language service.
-     * @default true
+     * If true, initialization will return rejected promise with the LikeC4 instance.
+     * Use `likec4.getErrors()` to get the errors.
+     * @default false
      */
-    useFileSystem?: boolean;
+    throwIfInvalid?: boolean;
     /**
      * Logger to use for the language service.
+     * @default 'default'
      */
     logger?: Logger | 'vite' | 'default';
     /**
      * Whether to use the `dot` binary for layouting or the WebAssembly version.
-     * Default is `wasm`.
+     * @default 'wasm'
      */
     graphviz?: 'wasm' | 'binary';
 };
-
 declare class LikeC4 {
     readonly workspace: string;
     private langium;
-    static initForSource(likec4SourceCode: string, opts?: CreateLanguageServiceOptions): Promise<LikeC4>;
+    static fromSource(likec4SourceCode: string, opts?: LikeC4Options): Promise<LikeC4>;
     /**
      * Prevents multiple instances of LikeC4 for the same workspace
      */
     private static likec4Instances;
-    static initForWorkspace(path: string, opts?: CreateLanguageServiceOptions): Promise<LikeC4>;
+    static fromWorkspace(path: string, opts?: LikeC4Options): Promise<LikeC4>;
     private cache;
     private logger;
     private langiumDocuments;
@@ -16866,4 +16867,4 @@ declare class LikeC4 {
     dispose(): void;
 }
 
-export { type AndOperator, AsFqn, type AutoLayoutDirection, type BBox, type BasicElementView, type BasicView, type BorderStyle, BorderStyles, type ColorLiteral, type ComputedDynamicView, type ComputedEdge, type ComputedElementView, type ComputedLikeC4Model, type ComputedNode, type ComputedView, type CustomElementExpr, type CustomRelationExpr, DefaultArrowType, DefaultElementShape, DefaultLineStyle, DefaultRelationshipColor, DefaultThemeColor, type DiagramEdge, type DiagramNode, type DiagramView, type DynamicView$1 as DynamicView, type DynamicViewIncludeRule, type DynamicViewRule$1 as DynamicViewRule, type DynamicViewStep$1 as DynamicViewStep, type EdgeId$1 as EdgeId, type Element$1 as Element, type ElementExpression$1 as ElementExpression, type ElementKind$1 as ElementKind, type ElementKindExpr, type ElementKindSpecification, type ElementKindSpecificationStyle, type ElementNotation, type ElementPredicateExpression, type ElementRefExpr, type ElementShape$1 as ElementShape, ElementShapes, type ElementStyle, type ElementTagExpr, type ElementThemeColorValues, type ElementThemeColors, type ElementView$1 as ElementView, type ElementWhereExpr, type EqualOperator, type ExpandedElementExpr, expression as Expr, type Expression$1 as Expression, type ExtendsElementView, type Fqn$1 as Fqn, type HexColorLiteral, type IconUrl, type InOutExpr, type IncomingExpr, type KindEqual, LikeC4, LikeC4Model, type LikeC4Theme, type LikeC4View$1 as LikeC4View, type Link, type NodeId, type NonEmptyArray, type NotOperator, type OrOperator, type OutgoingExpr, OverviewGraph, type ParsedLikeC4Model, type Point, type Relation$1 as Relation, type RelationExpr, type RelationExpression$1 as RelationExpression, type RelationID$1 as RelationID, type RelationPredicateExpression, type RelationWhereExpr, type RelationshipArrowType, type RelationshipKind$1 as RelationshipKind, type RelationshipKindSpecification, type RelationshipLineType, type RelationshipThemeColorValues, type RelationshipThemeColors, type ScopedElementView, StepEdgeId, type StepEdgeIdLiteral, type Tag$1 as Tag, type TagEqual, type TagSpec, type ThemeColor$1 as ThemeColor, ViewChange, ViewConnection, ViewElement, type ViewID$1 as ViewID, type ViewManualLayout, ViewModel, type ViewRule$1 as ViewRule, type ViewRuleAutoLayout$1 as ViewRuleAutoLayout, type ViewRulePredicate$1 as ViewRulePredicate, type ViewRuleStyle$1 as ViewRuleStyle, type ViewWithHash, type ViewWithNotation, type WhereOperator, type WildcardExpr, type XYPoint, extractStep, getBBoxCenter, isAndOperator, isComputedDynamicView, isComputedElementView, isCustomElement, isCustomRelationExpr, isDynamicView, isDynamicViewIncludeRule, isElement, isElementKindExpr, isElementPredicateExpr, isElementRef, isElementTagExpr, isElementView, isElementWhere, isExpandedElementExpr, isExtendsElementView, isInOut, isIncoming, isKindEqual, isNotOperator, isOrOperator, isOutgoing, isRelation, isRelationExpression, isRelationPredicateExpr, isRelationWhere, isScopedElementView, isStepEdgeId, isTagEqual, isViewRuleAutoLayout, isViewRulePredicate, isViewRuleStyle, isWildcard, whereOperatorAsPredicate };
+export { type AndOperator, AsFqn, type AutoLayoutDirection, type BBox, type BasicElementView, type BasicView, type BorderStyle, BorderStyles, type ColorLiteral, type ComputedDynamicView, type ComputedEdge, type ComputedElementView, type ComputedLikeC4Model, type ComputedNode, type ComputedView, type CustomElementExpr, type CustomRelationExpr, DefaultArrowType, DefaultElementShape, DefaultLineStyle, DefaultRelationshipColor, DefaultThemeColor, type DiagramEdge, type DiagramNode, type DiagramView, type DynamicView$1 as DynamicView, type DynamicViewIncludeRule, type DynamicViewRule$1 as DynamicViewRule, type DynamicViewStep$1 as DynamicViewStep, type EdgeId$1 as EdgeId, type Element$1 as Element, type ElementExpression$1 as ElementExpression, type ElementKind$1 as ElementKind, type ElementKindExpr, type ElementKindSpecification, type ElementKindSpecificationStyle, type ElementNotation, type ElementPredicateExpression, type ElementRefExpr, type ElementShape$1 as ElementShape, ElementShapes, type ElementStyle, type ElementTagExpr, type ElementThemeColorValues, type ElementThemeColors, type ElementView$1 as ElementView, type ElementWhereExpr, type EqualOperator, type ExpandedElementExpr, expression as Expr, type Expression$1 as Expression, type ExtendsElementView, type Fqn$1 as Fqn, type HexColorLiteral, type IconUrl, type InOutExpr, type IncomingExpr, type KindEqual, LikeC4, LikeC4Model, type LikeC4Theme, type LikeC4View$1 as LikeC4View, LikeC4ViewModel, type Link, type NodeId, type NonEmptyArray, type NotOperator, type OrOperator, type OutgoingExpr, OverviewGraph, type ParsedLikeC4Model, type Point, type Relation$1 as Relation, type RelationExpr, type RelationExpression$1 as RelationExpression, type RelationID$1 as RelationID, type RelationPredicateExpression, type RelationWhereExpr, type RelationshipArrowType, type RelationshipKind$1 as RelationshipKind, type RelationshipKindSpecification, type RelationshipLineType, type RelationshipThemeColorValues, type RelationshipThemeColors, type ScopedElementView, StepEdgeId, type StepEdgeIdLiteral, type Tag$1 as Tag, type TagEqual, type TagSpec, type ThemeColor$1 as ThemeColor, ViewChange, type ViewID$1 as ViewID, type ViewManualLayout, type ViewRule$1 as ViewRule, type ViewRuleAutoLayout$1 as ViewRuleAutoLayout, type ViewRulePredicate$1 as ViewRulePredicate, type ViewRuleStyle$1 as ViewRuleStyle, type ViewWithHash, type ViewWithNotation, type WhereOperator, type WildcardExpr, type XYPoint, extractStep, getBBoxCenter, isAndOperator, isComputedDynamicView, isComputedElementView, isCustomElement, isCustomRelationExpr, isDynamicView, isDynamicViewIncludeRule, isElement, isElementKindExpr, isElementPredicateExpr, isElementRef, isElementTagExpr, isElementView, isElementWhere, isExpandedElementExpr, isExtendsElementView, isInOut, isIncoming, isKindEqual, isNotOperator, isOrOperator, isOutgoing, isRelation, isRelationExpression, isRelationPredicateExpr, isRelationWhere, isScopedElementView, isStepEdgeId, isTagEqual, isViewRuleAutoLayout, isViewRulePredicate, isViewRuleStyle, isWildcard, whereOperatorAsPredicate };

package/dist/index.d.ts

@@ -1152,61 +1152,11 @@ type RelationID = LiteralUnion<RelationID$1, string>;
 type ViewID = LiteralUnion<ViewID$1, string>;
 type EdgeId = LiteralUnion<EdgeId$1, string>;
 
-/**
- * Represents an element in the view. (Diagram node)
- * All methods are view-scoped, i.e. `children` returns only children of the element in the view.
- */
-declare class ViewElement {
-    readonly node: ComputedNode;
-    private viewmodel;
-    constructor(node: ComputedNode, viewmodel: ViewModel);
-    get id(): NodeId;
-    get title(): string;
-    get kind(): ElementKind$1;
-    get isRoot(): boolean;
-    get hasNested(): boolean;
-    get shape(): ElementShape$1;
-    get color(): ThemeColor$1;
-    get tags(): Tag$1[];
-    model(): LikeC4Model.Element;
-    parent(): ViewElement | null;
-    metadata(key: string): string | undefined;
-    metadata(key: string, defaultValue: string): string;
-    hasMetadata(key: string): boolean;
-    ancestors(): ReadonlyArray<ViewElement>;
-    siblings(): ReadonlyArray<ViewElement>;
-    descendants(): ReadonlyArray<ViewElement>;
-    children(): ReadonlyArray<ViewElement>;
-    incoming(filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<ViewConnection>;
-    incomers(filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<ViewElement>;
-    outgoing(filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<ViewConnection>;
-    outgoers(filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<ViewElement>;
-    connectionsTo(target: Fqn | ViewElement): ReadonlyArray<ViewConnection>;
-}
-
-/**
- * Represents a connection between two elements.
- * May be source from multiple model relationships.
- */
-declare class ViewConnection {
-    readonly edge: ComputedEdge;
-    private viewmodel;
-    constructor(edge: ComputedEdge, viewmodel: ViewModel);
-    get id(): EdgeId$1;
-    get source(): ViewElement;
-    get target(): ViewElement;
-    get tags(): Tag$1[];
-    /**
-     * Model relationships
-     */
-    relationships(): ReadonlyArray<LikeC4Model.Relationship>;
-}
-
-type ElementOrFqn$1 = Fqn | ViewElement;
+type ElementOrFqn$1 = Fqn | LikeC4ViewModel.Element;
 /**
  * All methods are view-scoped, i.e. only return elements and connections in the view.
  */
-declare class ViewModel {
+declare class LikeC4ViewModel {
     #private;
     readonly view: ComputedView;
     readonly model: LikeC4Model;
@@ -1215,29 +1165,79 @@ declare class ViewModel {
     get title(): string;
     get viewOf(): LikeC4Model.Element;
     get tags(): Tag$1[];
-    roots(): ReadonlyArray<ViewElement>;
-    elements(): ReadonlyArray<ViewElement>;
-    element(id: Fqn): ViewElement;
+    roots(): ReadonlyArray<LikeC4ViewModel.Element>;
+    elements(): ReadonlyArray<LikeC4ViewModel.Element>;
+    element(id: Fqn): LikeC4ViewModel.Element;
     hasElement(id: Fqn): boolean;
-    connections(): ReadonlyArray<ViewConnection>;
-    connection(id: EdgeId): ViewConnection;
-    findConnections(source: ElementOrFqn$1, target: ElementOrFqn$1, direction?: 'both' | 'direct'): ReadonlyArray<ViewConnection>;
-    parent(element: ElementOrFqn$1): ViewElement | null;
-    children(element: ElementOrFqn$1): ReadonlyArray<ViewElement>;
-    siblings(element: ElementOrFqn$1): ReadonlyArray<ViewElement>;
+    connections(): ReadonlyArray<LikeC4ViewModel.Connection>;
+    connection(id: EdgeId): LikeC4ViewModel.Connection;
+    findConnections(source: ElementOrFqn$1, target: ElementOrFqn$1, direction?: 'both' | 'direct'): ReadonlyArray<LikeC4ViewModel.Connection>;
+    parent(element: ElementOrFqn$1): LikeC4ViewModel.Element | null;
+    children(element: ElementOrFqn$1): ReadonlyArray<LikeC4ViewModel.Element>;
+    siblings(element: ElementOrFqn$1): ReadonlyArray<LikeC4ViewModel.Element>;
     /**
      * Get all ancestor elements (i.e. parent, parent’s parent, etc.)
      * (from closest to root)
      */
-    ancestors(element: ElementOrFqn$1): ReadonlyArray<ViewElement>;
-    descendants(element: ElementOrFqn$1): ReadonlyArray<ViewElement>;
-    incoming(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<ViewConnection>;
-    incomers(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<ViewElement>;
+    ancestors(element: ElementOrFqn$1): ReadonlyArray<LikeC4ViewModel.Element>;
+    descendants(element: ElementOrFqn$1): ReadonlyArray<LikeC4ViewModel.Element>;
+    incoming(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4ViewModel.Connection>;
+    incomers(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4ViewModel.Element>;
     /**
      * Outgoing relationships from the element and its descendants
      */
-    outgoing(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<ViewConnection>;
-    outgoers(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<ViewElement>;
+    outgoing(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<LikeC4ViewModel.Connection>;
+    outgoers(element: ElementOrFqn$1, filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<LikeC4ViewModel.Element>;
+}
+declare namespace LikeC4ViewModel {
+    /**
+     * Represents an element in the view. (Diagram node)
+     * All methods are view-scoped, i.e. `children` returns only children of the element in the view.
+     */
+    class Element {
+        readonly node: ComputedNode;
+        private viewmodel;
+        constructor(node: ComputedNode, viewmodel: LikeC4ViewModel);
+        get id(): NodeId;
+        get title(): string;
+        get kind(): ElementKind$1;
+        get isRoot(): boolean;
+        get hasNested(): boolean;
+        get shape(): ElementShape$1;
+        get color(): ThemeColor$1;
+        get tags(): Tag$1[];
+        model(): LikeC4Model.Element;
+        parent(): LikeC4ViewModel.Element | null;
+        metadata(key: string): string | undefined;
+        metadata(key: string, defaultValue: string): string;
+        hasMetadata(key: string): boolean;
+        ancestors(): ReadonlyArray<LikeC4ViewModel.Element>;
+        siblings(): ReadonlyArray<LikeC4ViewModel.Element>;
+        descendants(): ReadonlyArray<LikeC4ViewModel.Element>;
+        children(): ReadonlyArray<LikeC4ViewModel.Element>;
+        incoming(filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4ViewModel.Connection>;
+        incomers(filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4ViewModel.Element>;
+        outgoing(filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<LikeC4ViewModel.Connection>;
+        outgoers(filter?: 'all' | 'direct' | 'from-descendants'): ReadonlyArray<LikeC4ViewModel.Element>;
+        connectionsTo(target: Fqn | LikeC4ViewModel.Element): ReadonlyArray<LikeC4ViewModel.Connection>;
+    }
+    /**
+     * Represents a connection between two elements.
+     * May be source from multiple model relationships.
+     */
+    class Connection {
+        readonly edge: ComputedEdge;
+        private viewmodel;
+        constructor(edge: ComputedEdge, viewmodel: LikeC4ViewModel);
+        get id(): EdgeId$1;
+        get source(): LikeC4ViewModel.Element;
+        get target(): LikeC4ViewModel.Element;
+        get tags(): Tag$1[];
+        /**
+         * Model relationships
+         */
+        relationships(): ReadonlyArray<LikeC4Model.Relationship>;
+    }
 }
 
 type ElementOrFqn = Fqn | LikeC4Model.Element;
@@ -1269,11 +1269,11 @@ declare class LikeC4Model {
     /**
      * Returns all views in the model.
      */
-    views(): ReadonlyArray<ViewModel>;
+    views(): ReadonlyArray<LikeC4ViewModel>;
     /**
      * Returns a specific view by its ID.
      */
-    view(viewId: ViewID): ViewModel;
+    view(viewId: ViewID): LikeC4ViewModel;
     /**
      * Returns the parent element of a given element.
      */
@@ -1294,7 +1294,6 @@ declare class LikeC4Model {
     descendants(element: ElementOrFqn): ReadonlyArray<LikeC4Model.Element>;
     /**
      * Incoming relationships to the element and its descendants
-     * @param onlyDirect - only direct incoming relationships, ignore descendants
      */
     incoming(element: ElementOrFqn, filter?: 'all' | 'direct' | 'to-descendants'): ReadonlyArray<LikeC4Model.Relationship>;
     /**
@@ -1321,7 +1320,7 @@ declare class LikeC4Model {
     /**
      * Resolve all views that contain the element
      */
-    viewsWithElement(element: ElementOrFqn): ReadonlyArray<ViewModel>;
+    viewsWithElement(element: ElementOrFqn): ReadonlyArray<LikeC4ViewModel>;
     private addElement;
     private addRelation;
     private _childrenOf;
@@ -1353,7 +1352,7 @@ declare namespace LikeC4Model {
         /**
          * Views that contain this element
          */
-        views(): readonly ViewModel[];
+        views(): readonly LikeC4ViewModel[];
         incoming(filter?: 'all' | 'direct' | 'to-descendants'): readonly Relationship[];
         incomers(filter?: 'all' | 'direct' | 'to-descendants'): readonly Element[];
         outgoing(filter?: 'all' | 'direct' | 'from-descendants'): readonly Relationship[];
@@ -4229,6 +4228,68 @@ declare namespace WorkspaceFolder {
     function is(value: any): value is WorkspaceFolder;
 }
 
+/**
+ * @hidden
+ */
+type $keywords<T extends string> = {
+  [key in T]: key;
+};
+
+declare module 'ts-graphviz' {
+    namespace ClusterSubgraphAttributeKey {
+        interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {
+        }
+    }
+    namespace NodeAttributeKey {
+        interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level'> {
+        }
+    }
+    namespace EdgeAttributeKey {
+        interface $values extends $keywords<'likec4_id'> {
+        }
+    }
+    namespace Attribute {
+        interface $keys extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {
+        }
+        interface $types {
+            likec4_type: 'folder' | 'file' | 'view';
+            likec4_path: string;
+            likec4_id: string;
+            likec4_level: number;
+            likec4_depth: number;
+        }
+    }
+}
+type DotSource = Tagged<string, 'DotSource'>;
+type DotLayoutResult = {
+    dot: DotSource;
+    diagram: DiagramView;
+};
+
+interface GraphvizPort {
+    unflatten(dot: DotSource): Promise<DotSource>;
+    acyclic(dot: DotSource): Promise<DotSource>;
+    layoutJson(dot: DotSource): Promise<string>;
+    svg(dot: DotSource): Promise<string>;
+}
+type LayoutResult = {
+    dot: DotSource;
+    diagram: DiagramView;
+};
+declare class GraphvizLayouter {
+    private graphviz;
+    constructor(graphviz: GraphvizPort);
+    get port(): GraphvizPort;
+    changePort(graphviz: GraphvizPort): void;
+    layout(view: ComputedView): Promise<LayoutResult>;
+    svg(view: ComputedView): Promise<{
+        svg: string;
+        dot: DotSource;
+    }>;
+    dot(computedView: ComputedView): Promise<DotSource>;
+    layoutOverviewGraph(views: ComputedView[]): Promise<OverviewGraph>;
+}
+
 type ParserMethod<ARGS extends unknown[], R> = (...args: ARGS) => R;
 
 /**
@@ -16101,68 +16162,6 @@ declare class LikeC4ModelParser {
     private convertLinks;
 }
 
-/**
- * @hidden
- */
-type $keywords<T extends string> = {
-  [key in T]: key;
-};
-
-declare module 'ts-graphviz' {
-    namespace ClusterSubgraphAttributeKey {
-        interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {
-        }
-    }
-    namespace NodeAttributeKey {
-        interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level'> {
-        }
-    }
-    namespace EdgeAttributeKey {
-        interface $values extends $keywords<'likec4_id'> {
-        }
-    }
-    namespace Attribute {
-        interface $keys extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {
-        }
-        interface $types {
-            likec4_type: 'folder' | 'file' | 'view';
-            likec4_path: string;
-            likec4_id: string;
-            likec4_level: number;
-            likec4_depth: number;
-        }
-    }
-}
-type DotSource = Tagged<string, 'DotSource'>;
-type DotLayoutResult = {
-    dot: DotSource;
-    diagram: DiagramView;
-};
-
-interface GraphvizPort {
-    unflatten(dot: DotSource): Promise<DotSource>;
-    acyclic(dot: DotSource): Promise<DotSource>;
-    layoutJson(dot: DotSource): Promise<string>;
-    svg(dot: DotSource): Promise<string>;
-}
-type LayoutResult = {
-    dot: DotSource;
-    diagram: DiagramView;
-};
-declare class GraphvizLayouter {
-    private graphviz;
-    constructor(graphviz: GraphvizPort);
-    get port(): GraphvizPort;
-    changePort(graphviz: GraphvizPort): void;
-    layout(view: ComputedView): Promise<LayoutResult>;
-    svg(view: ComputedView): Promise<{
-        svg: string;
-        dot: DotSource;
-    }>;
-    dot(computedView: ComputedView): Promise<DotSource>;
-    layoutOverviewGraph(views: ComputedView[]): Promise<OverviewGraph>;
-}
-
 // This definition file follows a somewhat unusual format. ESTree allows
 // runtime type checks based on the `type` parameter. In order to explain this
 // to typescript we want to use discriminated union types:
@@ -16777,6 +16776,26 @@ type Logger = {
     error(err: unknown): void;
 };
 
+declare class CliWorkspace {
+    private services;
+    private isInitialized;
+    constructor(services: CliServices);
+    initForWorkspace(workspacePath: string): Promise<void>;
+    init(): Promise<void>;
+}
+
+type CliAddedServices = {
+    logger: Logger;
+    likec4: {
+        Layouter: GraphvizLayouter;
+        Views: Views;
+    };
+    cli: {
+        Workspace: CliWorkspace;
+    };
+};
+type CliServices = LikeC4Services & CliAddedServices;
+
 type GraphvizOut = {
     id: ViewID$1;
     dot: DotSource;
@@ -16797,51 +16816,33 @@ declare class Views {
     overviewGraph(): Promise<OverviewGraph>;
 }
 
-declare class CliWorkspace {
-    private services;
-    private isInitialized;
-    constructor(services: CliServices);
-    initForWorkspace(workspacePath: string): Promise<void>;
-    init(): Promise<void>;
-}
-
-type CliAddedServices = {
-    logger: Logger;
-    likec4: {
-        Layouter: GraphvizLayouter;
-        Views: Views;
-    };
-    cli: {
-        Workspace: CliWorkspace;
-    };
-};
-type CliServices = LikeC4Services & CliAddedServices;
-type CreateLanguageServiceOptions = {
+type LikeC4Options = {
     /**
-     * Whether to use the file system for the language service.
-     * @default true
+     * If true, initialization will return rejected promise with the LikeC4 instance.
+     * Use `likec4.getErrors()` to get the errors.
+     * @default false
      */
-    useFileSystem?: boolean;
+    throwIfInvalid?: boolean;
     /**
      * Logger to use for the language service.
+     * @default 'default'
      */
     logger?: Logger | 'vite' | 'default';
     /**
      * Whether to use the `dot` binary for layouting or the WebAssembly version.
-     * Default is `wasm`.
+     * @default 'wasm'
      */
     graphviz?: 'wasm' | 'binary';
 };
-
 declare class LikeC4 {
     readonly workspace: string;
     private langium;
-    static initForSource(likec4SourceCode: string, opts?: CreateLanguageServiceOptions): Promise<LikeC4>;
+    static fromSource(likec4SourceCode: string, opts?: LikeC4Options): Promise<LikeC4>;
     /**
      * Prevents multiple instances of LikeC4 for the same workspace
      */
     private static likec4Instances;
-    static initForWorkspace(path: string, opts?: CreateLanguageServiceOptions): Promise<LikeC4>;
+    static fromWorkspace(path: string, opts?: LikeC4Options): Promise<LikeC4>;
     private cache;
     private logger;
     private langiumDocuments;
@@ -16866,4 +16867,4 @@ declare class LikeC4 {
     dispose(): void;
 }
 
-export { type AndOperator, AsFqn, type AutoLayoutDirection, type BBox, type BasicElementView, type BasicView, type BorderStyle, BorderStyles, type ColorLiteral, type ComputedDynamicView, type ComputedEdge, type ComputedElementView, type ComputedLikeC4Model, type ComputedNode, type ComputedView, type CustomElementExpr, type CustomRelationExpr, DefaultArrowType, DefaultElementShape, DefaultLineStyle, DefaultRelationshipColor, DefaultThemeColor, type DiagramEdge, type DiagramNode, type DiagramView, type DynamicView$1 as DynamicView, type DynamicViewIncludeRule, type DynamicViewRule$1 as DynamicViewRule, type DynamicViewStep$1 as DynamicViewStep, type EdgeId$1 as EdgeId, type Element$1 as Element, type ElementExpression$1 as ElementExpression, type ElementKind$1 as ElementKind, type ElementKindExpr, type ElementKindSpecification, type ElementKindSpecificationStyle, type ElementNotation, type ElementPredicateExpression, type ElementRefExpr, type ElementShape$1 as ElementShape, ElementShapes, type ElementStyle, type ElementTagExpr, type ElementThemeColorValues, type ElementThemeColors, type ElementView$1 as ElementView, type ElementWhereExpr, type EqualOperator, type ExpandedElementExpr, expression as Expr, type Expression$1 as Expression, type ExtendsElementView, type Fqn$1 as Fqn, type HexColorLiteral, type IconUrl, type InOutExpr, type IncomingExpr, type KindEqual, LikeC4, LikeC4Model, type LikeC4Theme, type LikeC4View$1 as LikeC4View, type Link, type NodeId, type NonEmptyArray, type NotOperator, type OrOperator, type OutgoingExpr, OverviewGraph, type ParsedLikeC4Model, type Point, type Relation$1 as Relation, type RelationExpr, type RelationExpression$1 as RelationExpression, type RelationID$1 as RelationID, type RelationPredicateExpression, type RelationWhereExpr, type RelationshipArrowType, type RelationshipKind$1 as RelationshipKind, type RelationshipKindSpecification, type RelationshipLineType, type RelationshipThemeColorValues, type RelationshipThemeColors, type ScopedElementView, StepEdgeId, type StepEdgeIdLiteral, type Tag$1 as Tag, type TagEqual, type TagSpec, type ThemeColor$1 as ThemeColor, ViewChange, ViewConnection, ViewElement, type ViewID$1 as ViewID, type ViewManualLayout, ViewModel, type ViewRule$1 as ViewRule, type ViewRuleAutoLayout$1 as ViewRuleAutoLayout, type ViewRulePredicate$1 as ViewRulePredicate, type ViewRuleStyle$1 as ViewRuleStyle, type ViewWithHash, type ViewWithNotation, type WhereOperator, type WildcardExpr, type XYPoint, extractStep, getBBoxCenter, isAndOperator, isComputedDynamicView, isComputedElementView, isCustomElement, isCustomRelationExpr, isDynamicView, isDynamicViewIncludeRule, isElement, isElementKindExpr, isElementPredicateExpr, isElementRef, isElementTagExpr, isElementView, isElementWhere, isExpandedElementExpr, isExtendsElementView, isInOut, isIncoming, isKindEqual, isNotOperator, isOrOperator, isOutgoing, isRelation, isRelationExpression, isRelationPredicateExpr, isRelationWhere, isScopedElementView, isStepEdgeId, isTagEqual, isViewRuleAutoLayout, isViewRulePredicate, isViewRuleStyle, isWildcard, whereOperatorAsPredicate };
+export { type AndOperator, AsFqn, type AutoLayoutDirection, type BBox, type BasicElementView, type BasicView, type BorderStyle, BorderStyles, type ColorLiteral, type ComputedDynamicView, type ComputedEdge, type ComputedElementView, type ComputedLikeC4Model, type ComputedNode, type ComputedView, type CustomElementExpr, type CustomRelationExpr, DefaultArrowType, DefaultElementShape, DefaultLineStyle, DefaultRelationshipColor, DefaultThemeColor, type DiagramEdge, type DiagramNode, type DiagramView, type DynamicView$1 as DynamicView, type DynamicViewIncludeRule, type DynamicViewRule$1 as DynamicViewRule, type DynamicViewStep$1 as DynamicViewStep, type EdgeId$1 as EdgeId, type Element$1 as Element, type ElementExpression$1 as ElementExpression, type ElementKind$1 as ElementKind, type ElementKindExpr, type ElementKindSpecification, type ElementKindSpecificationStyle, type ElementNotation, type ElementPredicateExpression, type ElementRefExpr, type ElementShape$1 as ElementShape, ElementShapes, type ElementStyle, type ElementTagExpr, type ElementThemeColorValues, type ElementThemeColors, type ElementView$1 as ElementView, type ElementWhereExpr, type EqualOperator, type ExpandedElementExpr, expression as Expr, type Expression$1 as Expression, type ExtendsElementView, type Fqn$1 as Fqn, type HexColorLiteral, type IconUrl, type InOutExpr, type IncomingExpr, type KindEqual, LikeC4, LikeC4Model, type LikeC4Theme, type LikeC4View$1 as LikeC4View, LikeC4ViewModel, type Link, type NodeId, type NonEmptyArray, type NotOperator, type OrOperator, type OutgoingExpr, OverviewGraph, type ParsedLikeC4Model, type Point, type Relation$1 as Relation, type RelationExpr, type RelationExpression$1 as RelationExpression, type RelationID$1 as RelationID, type RelationPredicateExpression, type RelationWhereExpr, type RelationshipArrowType, type RelationshipKind$1 as RelationshipKind, type RelationshipKindSpecification, type RelationshipLineType, type RelationshipThemeColorValues, type RelationshipThemeColors, type ScopedElementView, StepEdgeId, type StepEdgeIdLiteral, type Tag$1 as Tag, type TagEqual, type TagSpec, type ThemeColor$1 as ThemeColor, ViewChange, type ViewID$1 as ViewID, type ViewManualLayout, type ViewRule$1 as ViewRule, type ViewRuleAutoLayout$1 as ViewRuleAutoLayout, type ViewRulePredicate$1 as ViewRulePredicate, type ViewRuleStyle$1 as ViewRuleStyle, type ViewWithHash, type ViewWithNotation, type WhereOperator, type WildcardExpr, type XYPoint, extractStep, getBBoxCenter, isAndOperator, isComputedDynamicView, isComputedElementView, isCustomElement, isCustomRelationExpr, isDynamicView, isDynamicViewIncludeRule, isElement, isElementKindExpr, isElementPredicateExpr, isElementRef, isElementTagExpr, isElementView, isElementWhere, isExpandedElementExpr, isExtendsElementView, isInOut, isIncoming, isKindEqual, isNotOperator, isOrOperator, isOutgoing, isRelation, isRelationExpression, isRelationPredicateExpr, isRelationWhere, isScopedElementView, isStepEdgeId, isTagEqual, isViewRuleAutoLayout, isViewRulePredicate, isViewRuleStyle, isWildcard, whereOperatorAsPredicate };

package/dist/index.mjs

@@ -1 +1 @@
-export{T as AsFqn,U as BorderStyles,D as DefaultArrowType,W as DefaultElementShape,d as DefaultLineStyle,e as DefaultRelationshipColor,X as DefaultThemeColor,Y as ElementShapes,f as Expr,L as LikeC4,a as LikeC4Model,S as StepEdgeId,V as ViewConnection,b as ViewElement,c as ViewModel,g as extractStep,h as getBBoxCenter,i as isAndOperator,j as isComputedDynamicView,k as isComputedElementView,l as isCustomElement,m as isCustomRelationExpr,n as isDynamicView,o as isDynamicViewIncludeRule,p as isElement,q as isElementKindExpr,r as isElementPredicateExpr,s as isElementRef,t as isElementTagExpr,u as isElementView,v as isElementWhere,w as isExpandedElementExpr,x as isExtendsElementView,y as isInOut,z as isIncoming,A as isKindEqual,B as isNotOperator,C as isOrOperator,E as isOutgoing,F as isRelation,G as isRelationExpression,H as isRelationPredicateExpr,I as isRelationWhere,J as isScopedElementView,K as isStepEdgeId,M as isTagEqual,N as isViewRuleAutoLayout,O as isViewRulePredicate,P as isViewRuleStyle,Q as isWildcard,R as whereOperatorAsPredicate}from'./shared/likec4.BOI-5rb_.mjs';
+export{R as AsFqn,T as BorderStyles,D as DefaultArrowType,U as DefaultElementShape,c as DefaultLineStyle,d as DefaultRelationshipColor,V as DefaultThemeColor,W as ElementShapes,e as Expr,L as LikeC4,a as LikeC4Model,b as LikeC4ViewModel,S as StepEdgeId,f as extractStep,g as getBBoxCenter,i as isAndOperator,h as isComputedDynamicView,j as isComputedElementView,k as isCustomElement,l as isCustomRelationExpr,m as isDynamicView,n as isDynamicViewIncludeRule,o as isElement,p as isElementKindExpr,q as isElementPredicateExpr,r as isElementRef,s as isElementTagExpr,t as isElementView,u as isElementWhere,v as isExpandedElementExpr,w as isExtendsElementView,x as isInOut,y as isIncoming,z as isKindEqual,A as isNotOperator,B as isOrOperator,C as isOutgoing,E as isRelation,F as isRelationExpression,G as isRelationPredicateExpr,H as isRelationWhere,I as isScopedElementView,J as isStepEdgeId,K as isTagEqual,M as isViewRuleAutoLayout,N as isViewRulePredicate,O as isViewRuleStyle,P as isWildcard,Q as whereOperatorAsPredicate}from'./shared/likec4.DNb51-HM.mjs';

package/dist/shared/{likec4.BOI-5rb_.mjs → likec4.DNb51-HM.mjs}

@@ -136,111 +136,18 @@ function compareFqnHierarchically(a, b) {
 function compareByFqnHierarchically(a, b) {
   return compareFqnHierarchically(a.id, b.id);
 }
-class ViewConnection {
-  constructor(edge, viewmodel) {
-    this.edge = edge;
-    this.viewmodel = viewmodel;
-  }
-  get id() {
-    return this.edge.id;
-  }
-  get source() {
-    return this.viewmodel.element(this.edge.source);
-  }
-  get target() {
-    return this.viewmodel.element(this.edge.target);
-  }
-  get tags() {
-    return this.edge.tags ?? [];
-  }
-  /**
-   * Model relationships
-   */
-  relationships() {
-    return this.edge.relations.map((r2) => nonNullable(this.viewmodel.model.relationship(r2)));
-  }
-}
-class ViewElement {
-  constructor(node, viewmodel) {
-    this.node = node;
-    this.viewmodel = viewmodel;
-  }
-  get id() {
-    return this.node.id;
-  }
-  get title() {
-    return this.node.title;
-  }
-  get kind() {
-    return this.node.kind;
-  }
-  get isRoot() {
-    return e$6(this.node.parent);
-  }
-  get hasNested() {
-    return this.node.children.length > 0;
-  }
-  get shape() {
-    return this.node.shape;
-  }
-  get color() {
-    return this.node.color;
-  }
-  get tags() {
-    return this.node.tags ?? [];
-  }
-  model() {
-    return this.viewmodel.model.element(this.id);
-  }
-  parent() {
-    return this.node.parent ? this.viewmodel.element(this.node.parent) : null;
-  }
-  metadata(key, defaultValue) {
-    return this.model().metadata(key) ?? defaultValue;
-  }
-  hasMetadata(key) {
-    return this.model().hasMetadata(key);
-  }
-  ancestors() {
-    return this.viewmodel.ancestors(this);
-  }
-  siblings() {
-    return this.viewmodel.siblings(this);
-  }
-  descendants() {
-    return this.viewmodel.descendants(this);
-  }
-  children() {
-    return this.viewmodel.children(this);
-  }
-  incoming(filter = "all") {
-    return this.viewmodel.incoming(this, filter);
-  }
-  incomers(filter = "all") {
-    return this.viewmodel.incomers(this, filter);
-  }
-  outgoing(filter = "all") {
-    return this.viewmodel.outgoing(this, filter);
-  }
-  outgoers(filter = "all") {
-    return this.viewmodel.outgoers(this, filter);
-  }
-  connectionsTo(target) {
-    return this.viewmodel.findConnections(this, target);
-  }
-}
-class ViewModel {
+class LikeC4ViewModel {
   constructor(view, model) {
     this.view = view;
     this.model = model;
     for (const node of view.nodes) {
-      const el = new ViewElement(node, this);
+      const el = new LikeC4ViewModel.Element(node, this);
       this.#elements.set(node.id, el);
       if (e$6(node.parent)) {
         this.#rootElements.add(el);
       }
     }
-    this.#connections = new Map(view.edges.map((e2) => [e2.id, new ViewConnection(e2, this)]));
+    this.#connections = new Map(view.edges.map((e2) => [e2.id, new LikeC4ViewModel.Connection(e2, this)]));
   }
   #rootElements = /* @__PURE__ */ new Set();
   #elements = /* @__PURE__ */ new Map();
@@ -267,7 +174,7 @@ class ViewModel {
     return [...this.#elements.values()];
   }
   element(id) {
-    return nonNullable(this.#elements.get(id), `ViewElement ${id} in view ${this.view.id} not found`);
+    return nonNullable(this.#elements.get(id), `LikeC4ViewModel.Element ${id} in view ${this.view.id} not found`);
   }
   hasElement(id) {
     return this.#elements.has(id);
@@ -354,6 +261,103 @@ class ViewModel {
     return this.outgoing(element, filter).map((r2) => r2.target);
   }
 }
+((LikeC4ViewModel2) => {
+  class Element {
+    constructor(node, viewmodel) {
+      this.node = node;
+      this.viewmodel = viewmodel;
+    }
+    get id() {
+      return this.node.id;
+    }
+    get title() {
+      return this.node.title;
+    }
+    get kind() {
+      return this.node.kind;
+    }
+    get isRoot() {
+      return e$6(this.node.parent);
+    }
+    get hasNested() {
+      return this.node.children.length > 0;
+    }
+    get shape() {
+      return this.node.shape;
+    }
+    get color() {
+      return this.node.color;
+    }
+    get tags() {
+      return this.node.tags ?? [];
+    }
+    model() {
+      return this.viewmodel.model.element(this.id);
+    }
+    parent() {
+      return this.node.parent ? this.viewmodel.element(this.node.parent) : null;
+    }
+    metadata(key, defaultValue) {
+      return this.model().metadata(key) ?? defaultValue;
+    }
+    hasMetadata(key) {
+      return this.model().hasMetadata(key);
+    }
+    ancestors() {
+      return this.viewmodel.ancestors(this);
+    }
+    siblings() {
+      return this.viewmodel.siblings(this);
+    }
+    descendants() {
+      return this.viewmodel.descendants(this);
+    }
+    children() {
+      return this.viewmodel.children(this);
+    }
+    incoming(filter = "all") {
+      return this.viewmodel.incoming(this, filter);
+    }
+    incomers(filter = "all") {
+      return this.viewmodel.incomers(this, filter);
+    }
+    outgoing(filter = "all") {
+      return this.viewmodel.outgoing(this, filter);
+    }
+    outgoers(filter = "all") {
+      return this.viewmodel.outgoers(this, filter);
+    }
+    connectionsTo(target) {
+      return this.viewmodel.findConnections(this, target);
+    }
+  }
+  LikeC4ViewModel2.Element = Element;
+  class Connection {
+    constructor(edge, viewmodel) {
+      this.edge = edge;
+      this.viewmodel = viewmodel;
+    }
+    get id() {
+      return this.edge.id;
+    }
+    get source() {
+      return this.viewmodel.element(this.edge.source);
+    }
+    get target() {
+      return this.viewmodel.element(this.edge.target);
+    }
+    get tags() {
+      return this.edge.tags ?? [];
+    }
+    /**
+     * Model relationships
+     */
+    relationships() {
+      return this.edge.relations.map((r2) => nonNullable(this.viewmodel.model.relationship(r2)));
+    }
+  }
+  LikeC4ViewModel2.Connection = Connection;
+})(LikeC4ViewModel || (LikeC4ViewModel = {}));
 const RelationsSet$1 = Set;
 const MapRelations$1 = Map;
 class LikeC4Model {
@@ -366,7 +370,7 @@ class LikeC4Model {
       this.addRelation(rel);
     }
     this.#views = new Map(
-      r$7(computed.views).map((v) => [v.id, new ViewModel(v, this)])
+      r$7(computed.views).map((v) => [v.id, new LikeC4ViewModel(v, this)])
     );
   }
   #elements = /* @__PURE__ */ new Map();
@@ -473,7 +477,6 @@ class LikeC4Model {
   }
   /**
    * Incoming relationships to the element and its descendants
-   * @param onlyDirect - only direct incoming relationships, ignore descendants
    */
   incoming(element, filter = "all") {
     const id = t$7(element) ? element : element.id;
@@ -60948,7 +60951,7 @@ function p(n = !1) {
   return u;
 }// src/browser.ts
 var f = p(!1);const name = "likec4";
-const version = "1.8.2-next.0";
+const version = "1.8.2-next.1";
 const license = "MIT";
 const homepage = "https://likec4.dev";
 const author = "Denis Davydkov <denis@davydkov.com>";
@@ -61798,7 +61801,7 @@ function createLanguageServices(opts) {
     this.langiumDocuments = langium.shared.workspace.LangiumDocuments;
     this.views = langium.likec4.Views;
   }
-  static async initForSource(likec4SourceCode, opts) {
+  static async fromSource(likec4SourceCode, opts) {
     const langium = createLanguageServices({
       useFileSystem: false,
       ...opts
@@ -61818,13 +61821,17 @@ function createLanguageServices(opts) {
     const uri = UriUtils.joinPath(workspaceUri, "source.likec4");
     langium.shared.workspace.LangiumDocuments.createDocument(uri, likec4SourceCode);
     await langium.cli.Workspace.init();
-    return new LikeC4(workspaceUri.path, langium);
+    const likec4 = new LikeC4(workspaceUri.path, langium);
+    if (opts?.throwIfInvalid === true && likec4.hasErrors()) {
+      return Promise.reject(likec4);
+    }
+    return likec4;
   }
   /**
    * Prevents multiple instances of LikeC4 for the same workspace
    */
   static likec4Instances = /* @__PURE__ */ new Map();
-  static async initForWorkspace(path, opts) {
+  static async fromWorkspace(path, opts) {
     const workspace = resolve$1(path);
     let likec4 = LikeC4.likec4Instances.get(workspace);
     if (!likec4) {
@@ -61836,6 +61843,9 @@ function createLanguageServices(opts) {
       likec4 = new LikeC4(workspace, langium);
       LikeC4.likec4Instances.set(workspace, likec4);
     }
+    if (opts?.throwIfInvalid === true && likec4.hasErrors()) {
+      return Promise.reject(likec4);
+    }
     return likec4;
   }
   cache = /* @__PURE__ */ new WeakMap();
@@ -61907,4 +61917,4 @@ function createLanguageServices(opts) {
       }
     }
   }
-}export{TreeStreamImpl as $,isKindEqual as A,isNotOperator as B,isOrOperator as C,DefaultArrowType as D,isOutgoing as E,isRelation$1 as F,isRelationExpression$1 as G,isRelationPredicateExpr as H,isRelationWhere as I,isScopedElementView as J,isStepEdgeId as K,LikeC4 as L,isTagEqual as M,isViewRuleAutoLayout$1 as N,isViewRulePredicate$1 as O,isViewRuleStyle$1 as P,isWildcard$1 as Q,whereOperatorAsPredicate as R,StepEdgeId as S,AsFqn as T,BorderStyles as U,ViewConnection as V,DefaultElementShape as W,DefaultThemeColor as X,ElementShapes as Y,getDocument$4 as Z,findNodesForProperty as _,LikeC4Model as a,NEWLINE_REGEXP as a0,isAstNode as a1,e$3 as a2,x$1 as a3,i$8 as a4,T as a5,n$4 as a6,t$3 as a7,f as a8,pLimit as a9,logger$1 as aa,l$3 as ab,createLikeC4Logger as ac,withTrailingSlash as ad,hasProtocol as ae,withLeadingSlash as af,d$1 as ag,u$1 as ah,i3 as ai,inMillis as aj,startTimer as ak,nonexhaustive as al,invariant as am,stripIndent as an,i$7 as ao,delay as ap,LogLevels as aq,pkg as ar,ViewElement as b,ViewModel as c,DefaultLineStyle as d,DefaultRelationshipColor as e,expression as f,extractStep as g,getBBoxCenter as h,isAndOperator as i,isComputedDynamicView as j,isComputedElementView as k,isCustomElement as l,isCustomRelationExpr as m,isDynamicView as n,isDynamicViewIncludeRule as o,isElement$1 as p,isElementKindExpr as q,isElementPredicateExpr as r,isElementRef$1 as s,isElementTagExpr as t,isElementView$1 as u,isElementWhere as v,isExpandedElementExpr as w,isExtendsElementView as x,isInOut as y,isIncoming as z};
+}export{isAstNode as $,isNotOperator as A,isOrOperator as B,isOutgoing as C,DefaultArrowType as D,isRelation$1 as E,isRelationExpression$1 as F,isRelationPredicateExpr as G,isRelationWhere as H,isScopedElementView as I,isStepEdgeId as J,isTagEqual as K,LikeC4 as L,isViewRuleAutoLayout$1 as M,isViewRulePredicate$1 as N,isViewRuleStyle$1 as O,isWildcard$1 as P,whereOperatorAsPredicate as Q,AsFqn as R,StepEdgeId as S,BorderStyles as T,DefaultElementShape as U,DefaultThemeColor as V,ElementShapes as W,getDocument$4 as X,findNodesForProperty as Y,TreeStreamImpl as Z,NEWLINE_REGEXP as _,LikeC4Model as a,e$3 as a0,x$1 as a1,i$8 as a2,T as a3,n$4 as a4,t$3 as a5,f as a6,pLimit as a7,logger$1 as a8,l$3 as a9,createLikeC4Logger as aa,withTrailingSlash as ab,hasProtocol as ac,withLeadingSlash as ad,d$1 as ae,u$1 as af,i3 as ag,inMillis as ah,startTimer as ai,nonexhaustive as aj,invariant as ak,stripIndent as al,i$7 as am,delay as an,LogLevels as ao,pkg as ap,LikeC4ViewModel as b,DefaultLineStyle as c,DefaultRelationshipColor as d,expression as e,extractStep as f,getBBoxCenter as g,isComputedDynamicView as h,isAndOperator as i,isComputedElementView as j,isCustomElement as k,isCustomRelationExpr as l,isDynamicView as m,isDynamicViewIncludeRule as n,isElement$1 as o,isElementKindExpr as p,isElementPredicateExpr as q,isElementRef$1 as r,isElementTagExpr as s,isElementView$1 as t,isElementWhere as u,isExpandedElementExpr as v,isExtendsElementView as w,isInOut as x,isIncoming as y,isKindEqual as z};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "likec4",
-  "version": "1.8.2-next.0",
+  "version": "1.8.2-next.1",
   "license": "MIT",
   "homepage": "https://likec4.dev",
   "author": "Denis Davydkov <denis@davydkov.com>",