likec4 1.51.0 → 1.53.0

package/dist/_chunks/index.d.mts

@@ -1,4 +1,4 @@
-import { S as $strip, _ as ZodUnion, a as ZodBoolean, b as $partial, c as ZodEnum, d as ZodObject, f as ZodOptional, g as ZodTransform, h as ZodString, i as ZodArray, l as ZodInt, m as ZodRecord, o as ZodCustom, p as ZodPipe, r as ZodAny, s as ZodDefault, u as ZodNumber, v as input, x as $strict, y as output } from "./libs/@modelcontextprotocol/sdk.mjs";
+import { C as $strip, S as $strict, _ as ZodTransform, a as ZodBoolean, b as output, c as ZodEnum, d as ZodNumber, f as ZodObject, g as ZodString, h as ZodRecord, i as ZodArray, l as ZodInt, m as ZodPipe, o as ZodCustom, p as ZodOptional, r as ZodAny, s as ZodDefault, u as ZodLiteral, v as ZodUnion, x as $partial, y as input } from "./libs/@modelcontextprotocol/sdk.mjs";
 import { DeploymentElementModel, DeploymentRelationModel, ElementModel, LikeC4Model, LikeC4ViewModel, RelationshipModel } from "@likec4/core/model";
 import { LikeC4ProjectStylesConfig, LikeC4ProjectTheme, ProjectId, ThemeColorValues as ThemeColorValues$1, aux } from "@likec4/core/types";
 
@@ -143,6 +143,13 @@ declare const LikeC4ProjectJsonConfigSchema: ZodObject<{
   }, $strict>>;
   inferTechnologyFromIcon: ZodOptional<ZodBoolean>;
   implicitViews: ZodOptional<ZodBoolean>;
+  landingPage: ZodOptional<ZodUnion<readonly [ZodObject<{
+    redirect: ZodLiteral<true>;
+  }, $strict>, ZodObject<{
+    include: ZodArray<ZodString>;
+  }, $strict>, ZodObject<{
+    exclude: ZodArray<ZodString>;
+  }, $strict>]>>;
 }, $strip>;
 type LikeC4ProjectJsonConfig = input<typeof LikeC4ProjectJsonConfigSchema>;
 /**
@@ -272,6 +279,8 @@ type LikeC4ProjectConfigInput = LikeC4ProjectJsonConfig & {
 };
 /**
  * Validates Object into a LikeC4ProjectConfig object.
+ * Zod v4 can strip optional union keys (e.g. landingPage) from parse output;
+ * we validate landingPage once with LandingPageSchema and merge onto the result.
  */
 declare function validateProjectConfig<C extends Record<string, unknown>>(config: C): LikeC4ProjectConfig;
 /**

package/dist/_chunks/index2.d.mts

@@ -304,6 +304,7 @@ declare class GraphvizLayouter implements Disposable {
   [Symbol.dispose](): void;
   get graphvizPort(): GraphvizPort;
   changePort(graphviz: GraphvizPort): void;
+  printToDot(params: LayoutTaskParams): DotSource;
   dotToJson(dot: DotSource): Promise<GraphvizJson>;
   layout<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<LayoutResult<A>>;
   svg<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<{
@@ -557,11 +558,46 @@ type ManualLayoutsSnapshot = {
   hash: string;
   views: Record<ViewId$1, LayoutedView$1>;
 };
+type ManualLayoutUpdateEvent = {
+  updated: URI;
+  projectId: ProjectId$1;
+  viewId: ViewId$1;
+} | {
+  removed: URI;
+  projectId: ProjectId$1;
+  /**
+   * Missing if triggered by FS event (file was deleted)
+   */
+  viewId?: ViewId$1;
+};
+type ManualLayoutUpdateListener = (event: ManualLayoutUpdateEvent) => void;
 interface LikeC4ManualLayouts {
+  /**
+   * Reads a single layouted view from the file system by its URI.
+   * Used by the language server to get the current layout state.
+   */
+  readSnapshot(uri: URI): Promise<LayoutedView$1 | null>;
   read(project: Project): Promise<ManualLayoutsSnapshot | null>;
   write(project: Project, layouted: LayoutedView$1): Promise<Location>;
   remove(project: Project, view: ViewId$1): Promise<Location | null>;
   clearCaches(): void;
+  /**
+   * Registers a listener for manual layout updates.
+   * The listener will be called when a manual layout is created, updated, or deleted.
+   */
+  onManualLayoutUpdate(listener: ManualLayoutUpdateListener): Disposable$1;
+  /**
+   * Handles file system updates for manual layouts.
+   * Used by the file system watcher to notify the manual layouts module of changes.
+   * @param event The file system event
+   */
+  handleFileSystemUpdate(event: {
+    update: URI;
+    delete?: never;
+  } | {
+    delete: URI;
+    update?: never;
+  }): Promise<void>;
 } //#endregion
 //#region src/filesystem/noop.d.ts
 //#endregion
@@ -676,6 +712,7 @@ type Id = 'deployment' | 'element' | 'group' | 'instance' | 'model' | 'node' | A
 type LikeC4View = DeploymentView | DynamicView | ElementView;
 declare const LikeC4View = "LikeC4View";
 type LineOptions = 'dashed' | 'dotted' | 'solid';
+type MetadataFilterValue = boolean | string;
 type MetadataProperty = MetadataBody;
 declare const MetadataProperty = "MetadataProperty";
 type MetadataValue = MarkdownOrString | MetadataArray;
@@ -712,7 +749,7 @@ type ViewRule = ViewRuleAutoLayout | ViewRuleGlobalPredicateRef | ViewRuleGroup
 declare const ViewRule = "ViewRule";
 type ViewRuleStyleOrGlobalRef = ViewRuleGlobalStyle | ViewRuleStyle;
 declare const ViewRuleStyleOrGlobalRef = "ViewRuleStyleOrGlobalRef";
-type WhereElement = WhereElementKind | WhereElementTag;
+type WhereElement = WhereElementKind | WhereElementMetadata | WhereElementTag;
 declare const WhereElement = "WhereElement";
 type WhereElementExpression = WhereBinaryExpression | WhereElement | WhereElementNegation;
 declare const WhereElementExpression = "WhereElementExpression";
@@ -720,7 +757,9 @@ type WhereExpression = WhereElementExpression | WhereRelationExpression;
 declare const WhereExpression = "WhereExpression";
 type WhereKindEqual = WhereElementKind | WhereRelationKind | WhereRelationParticipantKind;
 declare const WhereKindEqual = "WhereKindEqual";
-type WhereRelation = WhereRelationKind | WhereRelationParticipantKind | WhereRelationParticipantTag | WhereRelationTag;
+type WhereMetadataEqual = WhereElementMetadata | WhereRelationMetadata | WhereRelationParticipantMetadata;
+declare const WhereMetadataEqual = "WhereMetadataEqual";
+type WhereRelation = WhereRelationKind | WhereRelationMetadata | WhereRelationParticipantKind | WhereRelationParticipantMetadata | WhereRelationParticipantTag | WhereRelationTag;
 declare const WhereRelation = "WhereRelation";
 type WhereRelationExpression = WhereBinaryExpression | WhereRelation | WhereRelationNegation;
 declare const WhereRelationExpression = "WhereRelationExpression";
@@ -1251,8 +1290,9 @@ declare const MetadataArray = "MetadataArray";
 interface MetadataAttribute extends AstNode {
   readonly $container: MetadataBody;
   readonly $type: 'MetadataAttribute';
+  boolValue: boolean;
   key: string;
-  value: MetadataValue;
+  value?: MetadataValue;
 }
 declare const MetadataAttribute = "MetadataAttribute";
 interface MetadataBody extends AstNode {
@@ -1606,6 +1646,15 @@ interface WhereElementKind extends AstNode {
   value: Reference<DeploymentNodeOrElementKind>;
 }
 declare const WhereElementKind = "WhereElementKind";
+interface WhereElementMetadata extends AstNode {
+  readonly $container: FqnExprWhere | WhereBinaryExpression | WhereElementNegation;
+  readonly $type: 'WhereElementMetadata';
+  key: Id;
+  not: boolean;
+  operator?: 'is' | string;
+  value?: MetadataFilterValue;
+}
+declare const WhereElementMetadata = "WhereElementMetadata";
 interface WhereElementNegation extends AstNode {
   readonly $container: FqnExprWhere | WhereBinaryExpression | WhereElementNegation;
   readonly $type: 'WhereElementNegation';
@@ -1628,6 +1677,15 @@ interface WhereRelationKind extends AstNode {
   value: Reference<RelationshipKind>;
 }
 declare const WhereRelationKind = "WhereRelationKind";
+interface WhereRelationMetadata extends AstNode {
+  readonly $container: RelationExprWhere | WhereBinaryExpression | WhereRelationNegation;
+  readonly $type: 'WhereRelationMetadata';
+  key: Id;
+  not: boolean;
+  operator?: 'is' | string;
+  value?: MetadataFilterValue;
+}
+declare const WhereRelationMetadata = "WhereRelationMetadata";
 interface WhereRelationNegation extends AstNode {
   readonly $container: RelationExprWhere | WhereBinaryExpression | WhereRelationNegation;
   readonly $type: 'WhereRelationNegation';
@@ -1643,6 +1701,16 @@ interface WhereRelationParticipantKind extends AstNode {
   value: Reference<DeploymentNodeOrElementKind>;
 }
 declare const WhereRelationParticipantKind = "WhereRelationParticipantKind";
+interface WhereRelationParticipantMetadata extends AstNode {
+  readonly $container: RelationExprWhere | WhereBinaryExpression | WhereRelationNegation;
+  readonly $type: 'WhereRelationParticipantMetadata';
+  key: Id;
+  not: boolean;
+  operator?: 'is' | string;
+  participant: Participant;
+  value?: MetadataFilterValue;
+}
+declare const WhereRelationParticipantMetadata = "WhereRelationParticipantMetadata";
 interface WhereRelationParticipantTag extends AstNode {
   readonly $container: RelationExprWhere | WhereBinaryExpression | WhereRelationNegation;
   readonly $type: 'WhereRelationParticipantTag';
@@ -1836,15 +1904,19 @@ type LikeC4AstType = {
   WhereElement: WhereElement;
   WhereElementExpression: WhereElementExpression;
   WhereElementKind: WhereElementKind;
+  WhereElementMetadata: WhereElementMetadata;
   WhereElementNegation: WhereElementNegation;
   WhereElementTag: WhereElementTag;
   WhereExpression: WhereExpression;
   WhereKindEqual: WhereKindEqual;
+  WhereMetadataEqual: WhereMetadataEqual;
   WhereRelation: WhereRelation;
   WhereRelationExpression: WhereRelationExpression;
   WhereRelationKind: WhereRelationKind;
+  WhereRelationMetadata: WhereRelationMetadata;
   WhereRelationNegation: WhereRelationNegation;
   WhereRelationParticipantKind: WhereRelationParticipantKind;
+  WhereRelationParticipantMetadata: WhereRelationParticipantMetadata;
   WhereRelationParticipantTag: WhereRelationParticipantTag;
   WhereRelationTag: WhereRelationTag;
   WhereTagEqual: WhereTagEqual;
@@ -2005,7 +2077,6 @@ interface ParsedAstElementView {
   tags: c4.NonEmptyArray<c4.Tag> | null;
   links: c4.NonEmptyArray<c4.Link> | null;
   rules: c4.ElementViewRule[];
-  manualLayout?: c4.ViewManualLayout;
 }
 interface ParsedAstDynamicView {
   id: c4.ViewId;
@@ -2017,7 +2088,6 @@ interface ParsedAstDynamicView {
   steps: c4.DynamicViewStep[];
   rules: Array<c4.DynamicViewRule>;
   variant: c4.DynamicViewDisplayVariant | undefined;
-  manualLayout?: c4.ViewManualLayout;
 }
 interface ParsedAstDeploymentView {
   id: c4.ViewId;
@@ -2027,7 +2097,6 @@ interface ParsedAstDeploymentView {
   tags: c4.NonEmptyArray<c4.Tag> | null;
   links: c4.NonEmptyArray<c4.Link> | null;
   rules: Array<c4.DeploymentViewRule>;
-  manualLayout?: c4.ViewManualLayout;
 }
 type ParsedAstView = ParsedAstElementView | ParsedAstDynamicView | ParsedAstDeploymentView;
 interface AstNodeDescriptionWithFqn extends AstNodeDescription {
@@ -2367,7 +2436,7 @@ declare class LastSeenArtifacts {
   model(projectId: c4.ProjectId): LikeC4Model.Computed | undefined;
 } //#endregion
 //#region src/model/model-builder.d.ts
-type ModelParsedListener = (docs: URI[]) => void;
+type ModelParsedListener = (projectId: ProjectId, docs: URI[]) => void;
 interface LikeC4ModelBuilder extends Disposable$1 {
   parseModel(projectId?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<LikeC4Model<UnknownParsed> | null>;
   unsafeSyncComputeModel(projectId: ProjectId): LikeC4Model<UnknownComputed>;
@@ -3317,7 +3386,42 @@ interface LikeC4LanguageServices {
    * Returns the location of the specified element, relation, view or deployment element
    */
   locate(params: Locate.Params): Locate.Res;
+  /**
+   * Formats documents and returns a map of document URI → formatted source text.
+   *
+   * Target selection uses union semantics:
+   * - No options: formats all documents across all projects
+   * - `projectIds`: includes all documents from those projects
+   * - `documentUris`: includes specific documents
+   * - Both: formats the union (deduplicated)
+   */
+  format(options?: FormatOptions): Promise<Map<string, string>>;
   dispose(): Promise<void>;
+}
+/**
+ * Options for {@link LikeC4LanguageServices.format}.
+ *
+ * Target selection uses union semantics:
+ * - Omit both `projectIds` and `documentUris` to format **all** documents.
+ * - Provide `projectIds` to include all documents from those projects.
+ * - Provide `documentUris` to include specific documents.
+ * - Provide both to format the **union** of project documents and specified documents.
+ */
+interface FormatOptions {
+  /** Include all documents from these projects. */
+  projectIds?: ReadonlyArray<ProjectId>;
+  /** Include these specific documents (by URI string). */
+  documentUris?: ReadonlyArray<string>;
+  /** Size of a tab in spaces (default: 2). */
+  tabSize?: number;
+  /** Prefer spaces over tabs (default: true). */
+  insertSpaces?: boolean;
+  /** Trim trailing whitespace on a line. */
+  trimTrailingWhitespace?: boolean;
+  /** Insert a newline character at the end of the file if one does not exist. */
+  insertFinalNewline?: boolean;
+  /** Trim all newlines after the final newline at the end of the file. */
+  trimFinalNewlines?: boolean;
 } //#endregion
 //#region src/lsp/CodeLensProvider.d.ts
 declare class LikeC4CodeLensProvider implements CodeLensProvider {
@@ -3424,7 +3528,7 @@ declare class LikeC4CodeActionProvider implements CodeActionProvider {
    * @throws `OperationCancelled` if cancellation is detected during execution
    * @throws `ResponseError` if an error is detected that should be sent as response to the client
    */
-  getCodeActions(document: LangiumDocument, params: CodeActionParams): CommandOrCodeAction[] | undefined;
+  getCodeActions(_document: LangiumDocument, _params: CodeActionParams): CommandOrCodeAction[] | undefined;
 } //#endregion
 //#region src/lsp/SemanticTokenProvider.d.ts
 declare class LikeC4SemanticTokenProvider extends AbstractSemanticTokenProvider {