@likec4/config 1.57.0 → 1.59.0

package/dist/chunks/index.d.mts

@@ -0,0 +1,596 @@
+import { t as __name } from "./rolldown-runtime.mjs";
+import z from "zod/v4";
+import { LikeC4ProjectStylesConfig, LikeC4ProjectTheme, ProjectId, ThemeColorValues as ThemeColorValues$1, aux } from "@likec4/core/types";
+import { DeploymentElementModel, DeploymentRelationModel, ElementModel, LikeC4Model, LikeC4ViewModel, RelationshipModel } from "@likec4/core/model";
+//#region src/schema.include.d.ts
+declare const IncludeSchema: z.ZodObject<{
+  paths: z.ZodArray<z.ZodString>;
+  maxDepth: z.ZodDefault<z.ZodNumber>;
+  fileThreshold: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+type IncludeConfig = z.infer<typeof IncludeSchema>;
+//#endregion
+//#region src/schema.d.ts
+interface VscodeURI {
+  readonly scheme: string;
+  readonly authority: string;
+  readonly path: string;
+  readonly fsPath: string;
+  readonly query: string;
+  readonly fragment: string;
+  toString(): string;
+}
+declare const LikeC4ProjectJsonConfigSchema: z.ZodObject<{
+  name: z.ZodString;
+  extends: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+  title: z.ZodOptional<z.ZodString>;
+  contactPerson: z.ZodOptional<z.ZodString>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+  styles: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+    theme: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+      colors: z.ZodOptional<z.ZodPipe<z.ZodRecord<z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+        [x: string]: any;
+      }>, z.ZodPipe<z.ZodCustom<string & Record<never, never>, string & Record<never, never>>, z.ZodTransform<any, string & Record<never, never>>>]>, z.ZodTransform<any, any>> & z.core.$partial, z.ZodPipe<z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+        elements: z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+          fill: z.ZodString;
+          stroke: z.ZodString;
+          hiContrast: z.ZodString;
+          loContrast: z.ZodString;
+        }, z.core.$strict>, z.ZodTransform<any, {
+          fill: string;
+          stroke: string;
+          hiContrast: string;
+          loContrast: string;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>;
+        relationships: z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+          line: z.ZodString;
+          label: z.ZodString;
+          labelBg: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strict>, z.ZodTransform<any, {
+          line: string;
+          label: string;
+          labelBg: string;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>;
+      }, z.core.$strict>, z.ZodTransform<any, {
+        elements: any;
+        relationships: any;
+      }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>, z.ZodTransform<any, any>>>, z.ZodTransform<Record<ThemeColor, ThemeColorValues>, Partial<Record<any, any>>>>>;
+      sizes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        [x: string]: any;
+      }> & z.core.$partial, z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodTransform<any, {
+      colors?: Record<ThemeColor, ThemeColorValues> | undefined;
+      sizes?: Partial<Record<any, {
+        width: number;
+        height: number;
+      }>> | undefined;
+    }>>>;
+    defaults: z.ZodOptional<z.ZodObject<{
+      color: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+        [x: string]: any;
+      }>, z.ZodPipe<z.ZodCustom<string & Record<never, never>, string & Record<never, never>>, z.ZodTransform<any, string & Record<never, never>>>]>, z.ZodTransform<any, any>>>;
+      opacity: z.ZodOptional<z.ZodInt>;
+      border: z.ZodOptional<z.ZodEnum<{
+        [x: string]: any;
+      }>>;
+      size: z.ZodOptional<z.ZodEnum<{
+        [x: string]: any;
+      }>>;
+      shape: z.ZodOptional<z.ZodEnum<{
+        [x: string]: any;
+      }>>;
+      iconPosition: z.ZodOptional<z.ZodEnum<{
+        [x: string]: any;
+      }>>;
+      group: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+          [x: string]: any;
+        }>, z.ZodPipe<z.ZodCustom<string & Record<never, never>, string & Record<never, never>>, z.ZodTransform<any, string & Record<never, never>>>]>, z.ZodTransform<any, any>>>;
+        opacity: z.ZodOptional<z.ZodInt>;
+        border: z.ZodOptional<z.ZodEnum<{
+          [x: string]: any;
+        }>>;
+      }, z.core.$strict>>;
+      relationship: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+          [x: string]: any;
+        }>, z.ZodPipe<z.ZodCustom<string & Record<never, never>, string & Record<never, never>>, z.ZodTransform<any, string & Record<never, never>>>]>, z.ZodTransform<any, any>>>;
+        line: z.ZodOptional<z.ZodEnum<{
+          dashed: "dashed";
+          solid: "solid";
+          dotted: "dotted";
+        }>>;
+        arrow: z.ZodOptional<z.ZodEnum<{
+          [x: string]: any;
+        }>>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    customCss: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+  }, z.core.$strict>, z.ZodTransform<any, {
+    theme?: any;
+    defaults?: {
+      color?: any;
+      opacity?: number | undefined;
+      border?: any;
+      size?: any;
+      shape?: any;
+      iconPosition?: any;
+      group?: {
+        color?: any;
+        opacity?: number | undefined;
+        border?: any;
+      } | undefined;
+      relationship?: {
+        color?: any;
+        line?: "dashed" | "solid" | "dotted" | undefined;
+        arrow?: any;
+      } | undefined;
+    } | undefined;
+    customCss?: string | string[] | undefined;
+  }>>>;
+  imageAliases: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  include: z.ZodOptional<z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+    maxDepth: z.ZodDefault<z.ZodNumber>;
+    fileThreshold: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strict>>;
+  exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  manualLayouts: z.ZodOptional<z.ZodObject<{
+    outDir: z.ZodDefault<z.ZodString>;
+  }, z.core.$strict>>;
+  inferTechnologyFromIcon: z.ZodOptional<z.ZodBoolean>;
+  implicitViews: z.ZodOptional<z.ZodBoolean>;
+  landingPage: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+    redirect: z.ZodLiteral<true>;
+  }, z.core.$strict>, z.ZodObject<{
+    include: z.ZodArray<z.ZodString>;
+  }, z.core.$strict>, z.ZodObject<{
+    exclude: z.ZodArray<z.ZodString>;
+  }, z.core.$strict>]>>;
+}, z.core.$strip>;
+type LikeC4ProjectJsonConfig = z.input<typeof LikeC4ProjectJsonConfigSchema>;
+/**
+ * Result of the {@link GeneratorFnContext.locate} function
+ */
+type LocateResult = {
+  /**
+   * Range inside the source file
+   */
+  range: {
+    start: {
+      line: number;
+      character: number;
+    };
+    end: {
+      line: number;
+      character: number;
+    };
+  };
+  /**
+   * Full path to the source file
+   */
+  document: VscodeURI;
+  /**
+   * Document path relative to the project folder
+   */
+  relativePath: string;
+  /**
+   * Folder, containing the source file ("dirname" of document)
+   */
+  folder: string;
+  /**
+   * Source file name ("basename" of document)
+   */
+  filename: string;
+};
+interface GeneratorFnContext {
+  /**
+   * Workspace root directory
+   */
+  readonly workspace: VscodeURI;
+  /**
+   * Current project
+   */
+  readonly project: {
+    /**
+     * Project name
+     */
+    readonly id: ProjectId;
+    readonly title?: string;
+    /**
+     * Project folder
+     */
+    readonly folder: VscodeURI;
+  };
+  /**
+   * Returns the location of the specified element, relation, view or deployment element
+   */
+  locate(target: ElementModel | RelationshipModel | DeploymentRelationModel | LikeC4ViewModel | DeploymentElementModel): LocateResult;
+  /**
+   * Write a file
+   * @param path - Path to the file, either absolute or relative to the project folder
+   *               All folders will be created automatically
+   * @param content - Content of the file
+   */
+  write(file: {
+    path: string | string[] | VscodeURI;
+    content: string | NodeJS.ArrayBufferView | Iterable<string | NodeJS.ArrayBufferView> | AsyncIterable<string | NodeJS.ArrayBufferView> | NodeJS.ReadableStream;
+  }): Promise<void>;
+  /**
+   * Abort the process
+   */
+  abort(reason?: string): never;
+}
+type GeneratorFnParams = {
+  /**
+   * LikeC4 model
+   */
+  likec4model: LikeC4Model<aux.UnknownLayouted>;
+  /**
+   * Generator context
+   */
+  ctx: GeneratorFnContext;
+};
+interface GeneratorFn {
+  (params: GeneratorFnParams): Promise<void> | void;
+}
+/**
+ * LikeC4 project configuration
+ *
+ * @example
+ * ```ts
+ * export default defineConfig({
+ *   name: 'my-project',
+ *   generators: {
+ *     'my-generator': async ({ likec4model, ctx }) => {
+ *       await ctx.write('my-generator.txt', likec4model.project.id)
+ *     }
+ *   }
+ * })
+ * ```
+ */
+type LikeC4ProjectConfig = z.infer<typeof LikeC4ProjectJsonConfigSchema> & {
+  /**
+   * Add custom generators to the project
+   * @example
+   * ```ts
+   * export default defineConfig({
+   *   name: 'my-project',
+   *   generators: {
+   *     'my-generator': async ({ likec4model, ctx }) => {
+   *       await ctx.write('my-generator.txt', likec4model.project.id)
+   *     }
+   *   }
+   * })
+   * ```
+   *
+   * Execute generator:
+   * ```bash
+   * likec4 gen my-generator
+   * ```
+   */
+  generators?: Record<string, GeneratorFn> | undefined;
+};
+type LikeC4ProjectConfigInput = LikeC4ProjectJsonConfig & {
+  generators?: Record<string, GeneratorFn> | undefined;
+};
+/**
+ * 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;
+/**
+ * Parses JSON string into a LikeC4ProjectConfig object.
+ * Does not process "extends" - use `loadConfig` function instead
+ */
+declare function parseProjectConfigJSON(config: string): LikeC4ProjectConfig;
+declare const LikeC4ProjectConfigOps: {
+  parse: typeof parseProjectConfigJSON;
+  validate: typeof validateProjectConfig;
+  normalizeInclude: (include: z.input<typeof IncludeSchema> | undefined) => IncludeConfig;
+};
+//#endregion
+//#region src/schema.theme.d.ts
+declare const ThemeColorValuesSchema: z.ZodPipe<z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+  elements: z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+    fill: z.ZodString;
+    stroke: z.ZodString;
+    hiContrast: z.ZodString;
+    loContrast: z.ZodString;
+  }, z.core.$strict>, z.ZodTransform<any, {
+    fill: string;
+    stroke: string;
+    hiContrast: string;
+    loContrast: string;
+  }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>;
+  relationships: z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+    line: z.ZodString;
+    label: z.ZodString;
+    labelBg: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  }, z.core.$strict>, z.ZodTransform<any, {
+    line: string;
+    label: string;
+    labelBg: string;
+  }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>;
+}, z.core.$strict>, z.ZodTransform<any, {
+  elements: any;
+  relationships: any;
+}>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>, z.ZodTransform<any, any>>;
+type ThemeColorValuesInput = z.input<typeof ThemeColorValuesSchema>;
+declare const LikeC4Config_Styles_Theme: z.ZodPipe<z.ZodObject<{
+  colors: z.ZodOptional<z.ZodPipe<z.ZodRecord<z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+    [x: string]: any;
+  }>, z.ZodPipe<z.ZodCustom<string & Record<never, never>, string & Record<never, never>>, z.ZodTransform<any, string & Record<never, never>>>]>, z.ZodTransform<any, any>> & z.core.$partial, z.ZodPipe<z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+    elements: z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+      fill: z.ZodString;
+      stroke: z.ZodString;
+      hiContrast: z.ZodString;
+      loContrast: z.ZodString;
+    }, z.core.$strict>, z.ZodTransform<any, {
+      fill: string;
+      stroke: string;
+      hiContrast: string;
+      loContrast: string;
+    }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>;
+    relationships: z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+      line: z.ZodString;
+      label: z.ZodString;
+      labelBg: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strict>, z.ZodTransform<any, {
+      line: string;
+      label: string;
+      labelBg: string;
+    }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>;
+  }, z.core.$strict>, z.ZodTransform<any, {
+    elements: any;
+    relationships: any;
+  }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>, z.ZodTransform<any, any>>>, z.ZodTransform<Record<ThemeColor, ThemeColorValues>, Partial<Record<any, any>>>>>;
+  sizes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+    [x: string]: any;
+  }> & z.core.$partial, z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+  }, z.core.$strict>>>;
+}, z.core.$strict>, z.ZodTransform<any, {
+  colors?: Record<ThemeColor, ThemeColorValues> | undefined;
+  sizes?: Partial<Record<any, {
+    width: number;
+    height: number;
+  }>> | undefined;
+}>>;
+type LikeC4ConfigThemeInput = z.input<typeof LikeC4Config_Styles_Theme>;
+declare const LikeC4StylesConfigSchema: z.ZodPipe<z.ZodObject<{
+  theme: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+    colors: z.ZodOptional<z.ZodPipe<z.ZodRecord<z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+      [x: string]: any;
+    }>, z.ZodPipe<z.ZodCustom<string & Record<never, never>, string & Record<never, never>>, z.ZodTransform<any, string & Record<never, never>>>]>, z.ZodTransform<any, any>> & z.core.$partial, z.ZodPipe<z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+      elements: z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+        fill: z.ZodString;
+        stroke: z.ZodString;
+        hiContrast: z.ZodString;
+        loContrast: z.ZodString;
+      }, z.core.$strict>, z.ZodTransform<any, {
+        fill: string;
+        stroke: string;
+        hiContrast: string;
+        loContrast: string;
+      }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>;
+      relationships: z.ZodUnion<[z.ZodPipe<z.ZodObject<{
+        line: z.ZodString;
+        label: z.ZodString;
+        labelBg: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+      }, z.core.$strict>, z.ZodTransform<any, {
+        line: string;
+        label: string;
+        labelBg: string;
+      }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>;
+    }, z.core.$strict>, z.ZodTransform<any, {
+      elements: any;
+      relationships: any;
+    }>>, z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>]>, z.ZodTransform<any, any>>>, z.ZodTransform<Record<ThemeColor, ThemeColorValues>, Partial<Record<any, any>>>>>;
+    sizes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+      [x: string]: any;
+    }> & z.core.$partial, z.ZodObject<{
+      width: z.ZodNumber;
+      height: z.ZodNumber;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>, z.ZodTransform<any, {
+    colors?: Record<ThemeColor, ThemeColorValues> | undefined;
+    sizes?: Partial<Record<any, {
+      width: number;
+      height: number;
+    }>> | undefined;
+  }>>>;
+  defaults: z.ZodOptional<z.ZodObject<{
+    color: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+      [x: string]: any;
+    }>, z.ZodPipe<z.ZodCustom<string & Record<never, never>, string & Record<never, never>>, z.ZodTransform<any, string & Record<never, never>>>]>, z.ZodTransform<any, any>>>;
+    opacity: z.ZodOptional<z.ZodInt>;
+    border: z.ZodOptional<z.ZodEnum<{
+      [x: string]: any;
+    }>>;
+    size: z.ZodOptional<z.ZodEnum<{
+      [x: string]: any;
+    }>>;
+    shape: z.ZodOptional<z.ZodEnum<{
+      [x: string]: any;
+    }>>;
+    iconPosition: z.ZodOptional<z.ZodEnum<{
+      [x: string]: any;
+    }>>;
+    group: z.ZodOptional<z.ZodObject<{
+      color: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+        [x: string]: any;
+      }>, z.ZodPipe<z.ZodCustom<string & Record<never, never>, string & Record<never, never>>, z.ZodTransform<any, string & Record<never, never>>>]>, z.ZodTransform<any, any>>>;
+      opacity: z.ZodOptional<z.ZodInt>;
+      border: z.ZodOptional<z.ZodEnum<{
+        [x: string]: any;
+      }>>;
+    }, z.core.$strict>>;
+    relationship: z.ZodOptional<z.ZodObject<{
+      color: z.ZodOptional<z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+        [x: string]: any;
+      }>, z.ZodPipe<z.ZodCustom<string & Record<never, never>, string & Record<never, never>>, z.ZodTransform<any, string & Record<never, never>>>]>, z.ZodTransform<any, any>>>;
+      line: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        solid: "solid";
+        dotted: "dotted";
+      }>>;
+      arrow: z.ZodOptional<z.ZodEnum<{
+        [x: string]: any;
+      }>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>;
+  customCss: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strict>, z.ZodTransform<any, {
+  theme?: any;
+  defaults?: {
+    color?: any;
+    opacity?: number | undefined;
+    border?: any;
+    size?: any;
+    shape?: any;
+    iconPosition?: any;
+    group?: {
+      color?: any;
+      opacity?: number | undefined;
+      border?: any;
+    } | undefined;
+    relationship?: {
+      color?: any;
+      line?: "dashed" | "solid" | "dotted" | undefined;
+      arrow?: any;
+    } | undefined;
+  } | undefined;
+  customCss?: string | string[] | undefined;
+}>>;
+interface LikeC4StylesConfig extends z.infer<typeof LikeC4StylesConfigSchema> {}
+type LikeC4StylesConfigInput = z.input<typeof LikeC4StylesConfigSchema>;
+//#endregion
+//#region src/filenames.d.ts
+/** All known LikeC4 config filenames (JSON and non-JSON). */
+declare const ConfigFilenames: readonly [".likec4rc", ".likec4.config.json", "likec4.config.json", "likec4.config.js", "likec4.config.cjs", "likec4.config.mjs", "likec4.config.ts", "likec4.config.cts", "likec4.config.mts"];
+/** Returns true if the **basename** of the given path matches a known config filename. */
+declare function isLikeC4JsonConfig(filename: string): boolean;
+/**
+ * Returns true if the **basename** of the given path matches a known non-JSON config filename (JS, MJS, TS, MTS).
+ */
+declare function isLikeC4NonJsonConfig(filename: string): boolean;
+/**
+ * Returns true if the **basename** of the given path matches a known LikeC4 config file (JSON or non-JSON).
+ */
+declare function isLikeC4Config(filename: string): boolean;
+//#endregion
+//#region src/define-config.d.ts
+/**
+ * Defines LikeC4 Project, allows custom generators that can be executed using CLI:
+ *
+ * `$ likec4 gen <generator-name>`
+ *
+ * or VSCode command `LikeC4: Run code generator`
+ *
+ * @example
+ * ```ts
+ * export default defineConfig({
+ *   name: 'my-project',
+ *   title: 'My Project',
+ *
+ *   exclude: ['picomatch pattern'],
+ *   generators: {
+ *     '<generator-name>': async ({ likec4model, ctx }) => {
+ *       await ctx.write('my-generator.txt', likec4model.project.id)
+ *     }
+ *   }
+ * })
+ * ```
+ */
+declare function defineConfig<C extends LikeC4ProjectConfigInput>(config: C): LikeC4ProjectConfig;
+/**
+ * Define reusable custom generators
+ *
+ * @example
+ * ```ts
+ * // generators.ts
+ * export default defineGenerators({
+ *   'my-generator': async ({ likec4model, ctx }) => {
+ *     await ctx.write('my-generator.txt', likec4model.project.id)
+ *   }
+ * })
+ *
+ * // likec4.config.ts
+ * import generators from './generators'
+ *
+ * export default defineConfig({
+ *   name: 'my-project',
+ *   generators,
+ * })
+ * ```
+ */
+declare function defineGenerators<const G extends Record<string, GeneratorFn>>(generators: G): G;
+/**
+ * Define reusable custom theme color
+ * @example
+ * ```ts
+ * export default defineThemeColor({
+ *   element: {
+ *     fill: 'red'
+ *   }
+ * })
+ * ```
+ */
+declare function defineThemeColor<const S extends ThemeColorValuesInput>(colors: S): ThemeColorValues$1;
+/**
+ * Define reusable custom theme
+ * @example
+ * ```ts
+ * import { defineThemeColor, defineTheme } from 'likec4/config'
+ *
+ * export default defineTheme({
+ *   colors: {
+ *     primary: '#FF0000',
+ *     // Or use defineThemeColor
+ *     red: defineThemeColor({
+ *       elements: {
+ *         fill: 'red'
+ *       }
+ *     })
+ *   }
+ * })
+ * ```
+ */
+declare function defineTheme<const S extends LikeC4ConfigThemeInput>(theme: S): LikeC4ProjectTheme;
+/**
+ * Define reusable custom style
+ * @example
+ * ```ts
+ * import { defineStyle, defineThemeColor } from 'likec4/config'
+ *
+ * export default defineStyle({
+ *   theme: {
+ *     colors: {
+ *       red: defineThemeColor({
+ *         elements: {
+ *           fill: 'red'
+ *         }
+ *       })
+ *     }
+ *   },
+ *   defaults: {
+ *     color: 'red',
+ *     opacity: 50,
+ *     border: 'solid',
+ *     size: 'sm',
+ *     relationship: {
+ *       color: 'grey',
+ *       line: 'solid',
+ *     }
+ *   }
+ * })
+ */
+declare function defineStyle<const S extends LikeC4StylesConfigInput>(styles: S): LikeC4ProjectStylesConfig;
+//#endregion
+export { VscodeURI as C, LocateResult as S, GeneratorFnParams as _, defineThemeColor as a, LikeC4ProjectConfigOps as b, isLikeC4JsonConfig as c, LikeC4StylesConfig as d, LikeC4StylesConfigInput as f, GeneratorFnContext as g, GeneratorFn as h, defineTheme as i, isLikeC4NonJsonConfig as l, ThemeColorValuesInput as m, defineGenerators as n, ConfigFilenames as o, LikeC4StylesConfigSchema as p, defineStyle as r, isLikeC4Config as s, defineConfig as t, LikeC4ConfigThemeInput as u, LikeC4ProjectConfig as v, IncludeConfig as w, LikeC4ProjectJsonConfig as x, LikeC4ProjectConfigInput as y };

package/dist/chunks/rolldown-runtime.mjs

@@ -0,0 +1 @@
+var e=Object.defineProperty,__name=(t,n)=>e(t,`name`,{value:n,configurable:!0});export{__name as t};

package/dist/chunks/src.mjs

@@ -0,0 +1,17 @@
+import"./rolldown-runtime.mjs";import e from"json5";import t from"zod/v4";import{BorderStyles as n,ElementShapes as r,IconPositions as i,RelationshipArrowTypes as a,Sizes as o,ThemeColors as s,computeColorValues as c}from"@likec4/core/styles";import{exact as l}from"@likec4/core/types";const u=/^@[A-Za-z0-9_-]*$/,d=/^(?!\/|[A-Za-z]:[\\\/])(?!.*:\/\/).*$/,f=t.string().min(1,`Image alias key cannot be empty`).regex(u,`Image alias key must match /^@\\w+$/`),p=t.string().min(1,`Image alias value cannot be empty`).regex(d,`Image alias value must be a relative path (no leading slash or protocol)`),m=t.record(f,p).meta({id:`ImageAliases`,description:`Map of image alias prefixes to relative paths (keys must match /^@\\w+$/; values must be relative paths without protocol or leading slash).`}),h=t.string().min(1,`Include path cannot be empty`).regex(/^(?!\/|[A-Za-z]:[\\\/])(?!.*:\/\/).*$/,`Include path must be a relative path (no leading slash, drive letter, or protocol)`),g=t.strictObject({paths:t.array(h).meta({description:[`Additional relative directory paths to include LikeC4 source files from, searched recursively.`,`Paths are relative to the project folder (the folder containing this config file).`,`Example: ["../shared", "../common/specs"]`].join(`
+`)}),maxDepth:t.number().int().min(1).max(20).default(3).meta({description:[`Maximum directory depth to scan when searching for .c4 files in include paths.`,`Prevents excessive scanning of deeply nested directories.`,`Default: 3`].join(`
+`)}),fileThreshold:t.number().int().min(1).max(1e4).default(30).meta({description:[`Maximum number of files to load from include paths before warning.`,`Helps identify performance issues from accidentally including large directories.`,`Default: 30`].join(`
+`)})}).meta({id:`include-config`,description:[`Configuration for including additional LikeC4 source files from other directories.`,`Example: { "paths": ["../shared", "../common/specs"], "maxDepth": 5, "fileThreshold": 50 }`].join(`
+`)}),_=t.int().min(0,`Opacity must be between 0 and 100`).max(100,`Opacity must be between 0 and 100`).meta({id:`Opacity`,description:`Opacity 0-100%`}),v=t.enum(r).meta({id:`ElementShape`}),y=t.enum(n).meta({id:`BorderStyle`}),b=t.enum(o).meta({id:`ElementSize`}),x=t.enum(i).meta({id:`IconPosition`}),S=t.enum(a).meta({id:`ArrowType`}),C=t.enum([`dashed`,`solid`,`dotted`]).meta({id:`LineType`}),w=t.enum(s).meta({id:`ThemeColorName`}),T=t.custom().refine(e=>typeof e==`string`,`Custom color name must be a string`).transform(e=>e).meta({id:`CustomColorName`}),E=w.or(T).transform(e=>e).meta({id:`ColorName`}),D=t.string().min(1,`Color value cannot be empty`).meta({id:`ColorLiteral`}),O=t.strictObject({fill:D.meta({description:`Background color`}),stroke:D.meta({description:`Stroke color (border, paths above background)`}),hiContrast:D.meta({description:`High contrast text color (title)`}),loContrast:D.meta({description:`Low contrast text color (description)`})}).meta({id:`ElementColorValues`}).transform(e=>e),k=t.strictObject({line:D.meta({description:`Line color`}),label:D.meta({description:`Label text color`}),labelBg:D.optional().default(`rgba(0, 0, 0, 0.5)`).meta({description:`Label background color`})}).meta({id:`RelationshipColorValues`}).transform(e=>e),A=t.strictObject({elements:O.or(D.transform(e=>c(e).elements)).meta({description:`Exact color value (hex, rgb, rgba, hsl, hsla ...) or break down of specific color values`}),relationships:k.or(D.transform(e=>c(e).relationships)).meta({description:`Exact color value (hex, rgb, rgba, hsl, hsla ...) or break down of specific color values`})}).transform(e=>e).meta({id:`StrictThemeColorValues`,description:`Exact color value (hex, rgb, rgba, hsl, hsla ...) or break down of specific color value`}).or(D.transform(e=>c(e))).transform(e=>e).meta({id:`ThemeColorValues`,description:`Exact value (hex, rgb, rgba, hsl, hsla ...) or break down of specific color values`}),j=t.partialRecord(E,A).transform(e=>e),M=t.strictObject({width:t.number().min(50),height:t.number().min(50)}).meta({id:`Dimensions`,description:`Defines dimensions for theme size`}),N=t.partialRecord(b,M),P=t.strictObject({colors:j.optional().meta({description:`Override theme colors`}),sizes:N.optional().meta({description:`Override theme sizes`})}).meta({id:`ThemeCustomization`,description:`Customize theme colors and sizes`}).transform(({colors:e,sizes:t})=>l({colors:e?l(e):void 0,sizes:t?l(t):void 0})),F=t.strictObject({color:E.optional().meta({description:`Default color for groups
+(must be a valid color name from the theme)`}),opacity:_.optional().meta({description:`Default opacity for groups`}),border:y.optional().meta({description:`Default border for groups`})}).meta({id:`GroupDefaultStyleValues`}),I=t.strictObject({color:E.optional().meta({description:`Default color for relationships
+(must be a valid color name from the theme)`}),line:C.optional().meta({description:`Default line style for relationships`}),arrow:S.optional().meta({description:`Default arrow style for relationships`})}).meta({id:`RelationshipDefaultStyleValues`,description:`Override default values for relationship style properties
+These values will be used if such property is not defined`}),L=t.strictObject({color:E.optional().meta({description:`Default color for elements
+(must be a valid color name from the theme)`}),opacity:_.optional().meta({description:`Default opacity (0-100%) for elements when displayed as a group (like a container)`}),border:y.optional().meta({description:`Default border style for elements when displayed as a group (like a container)`}),size:b.optional().meta({description:`Default size for elements`}),shape:v.optional().meta({description:`Default shape for elements`}),iconPosition:x.optional().meta({description:`Default icon position for elements`}),group:F.optional().meta({description:`Override default values for group style properties
+These values will be used if such property is not defined`}),relationship:I.optional().meta({description:`Override default values for relationship style properties
+These values will be used if such property is not defined`})}).meta({id:`DefaultStyleValues`}),R=t.union([t.string().min(1,`Custom CSS file path cannot be empty`),t.array(t.string().min(1,`Custom CSS file path cannot be empty`))]).meta({id:`CustomStylesheets`}),z=t.strictObject({theme:P.optional().meta({description:`Project theme customization`}),defaults:L.optional().meta({description:`Override default values for style properties
+These values will be used if such property is not defined`}),customCss:R.optional().meta({description:`Custom CSS (or list of CSS files) to be included in the generated diagrams`})}).transform(({theme:e,defaults:t,customCss:n})=>l({defaults:normalizeDefaults(t),customCss:normalizeStylesheets(n),theme:e}));function normalizeDefaults(e){if(!e)return;let{relationship:t,group:n,...r}=e;return l({...r,relationship:t&&l(t),group:n&&l(n)})}function normalizeStylesheets(e){if(!e)return;let t=(Array.isArray(e)?e:[e]).filter(Boolean);if(t.length!==0)return{paths:t,content:``}}const B=t.strictObject({outDir:t.string().default(`.likec4`).meta({description:[`Path to the directory where manual layouts will be stored,`,`relative to the folder containing the project config. `,``,`Defaults to '.likec4'.`].join(`
+`)})}).meta({id:`ManualLayoutsConfig`,description:`Configuration for manual layouts`}),V=t.union([t.strictObject({redirect:t.literal(!0)}),t.strictObject({include:t.array(t.string().nonempty().refine(e=>e!==`#`,{message:`selector cannot be "#"`})).nonempty(`include list cannot be empty`)}),t.strictObject({exclude:t.array(t.string().nonempty().refine(e=>e!==`#`,{message:`selector cannot be "#"`})).nonempty(`exclude list cannot be empty`)})]).meta({id:`LandingPageConfig`,description:`Configure the landing page. Use redirect to go to the index view, or include/exclude to filter the view grid.`}),H=t.object({name:t.string().nonempty(`Project name cannot be empty`).refine(e=>e!=="default",{abort:!0,error:`Project name cannot be "default"`}).refine(e=>!e.includes(`.`)&&!e.includes(`@`)&&!e.includes(`#`),{abort:!0,error:`Project name cannot contain ".", "@" or "#", try to use A-z, 0-9, _ and -`}).meta({description:`Project name, must be unique in the workspace`}),extends:t.union([t.string().min(1,`Extend path cannot be empty`),t.array(t.string().min(1,`Extend path cannot be empty`)).min(1,`Extend list cannot be empty`)]).optional().meta({description:`Extend styles from other config files`}),title:t.string().nonempty(`Project title cannot be empty if specified`).optional().meta({description:`A human readable title for the project`}),contactPerson:t.string().nonempty(`Contact person cannot be empty if specified`).optional().meta({description:`A person who has been involved in creating or maintaining this project`}),metadata:t.record(t.string(),t.any()).optional().meta({description:`Arbitrary metadata as key-value pairs for custom project information`}),styles:z.optional().meta({description:`Project styles customization`}),imageAliases:m.optional(),include:g.optional(),exclude:t.array(t.string()).optional().meta({description:`List of file patterns to exclude from the project, default is ["**/node_modules/**"]`}),manualLayouts:B.optional(),inferTechnologyFromIcon:t.boolean().optional().meta({description:[`Automatically derive element technology from icon name when technology is not set explicitly.`,`Applies to aws:, azure:, gcp:, and tech: icons. Bootstrap icons are excluded.`,`Defaults to true.`].join(`
+`)}),implicitViews:t.boolean().optional().meta({description:`Auto-generate scoped views for elements without explicit views. Defaults to false.`}),landingPage:V.optional()}).meta({id:`LikeC4ProjectConfig`,description:`LikeC4 Project Configuration`}),U=t.instanceof(Function),W=t.record(t.string(),U),G=H.extend({generators:W.optional()});function validateProjectConfig(e){let n=e.landingPage,r=null;if(n!=null){let e=V.safeParse(n);if(!e.success)throw Error(`Config validation failed:
+`+t.prettifyError(e.error));r=e.data}let i=H.safeParse(e);if(!i.success)throw Error(`Config validation failed:
+`+t.prettifyError(i.error));let a=i.data;r!==null&&(a={...a,landingPage:r});let o=e.generators;if(typeof o==`object`&&o&&!Array.isArray(o)){let e=W.safeParse(o);if(!e.success)throw Error(`Config validation failed (generators):
+`+t.prettifyError(e.error));return{...a,generators:e.data}}return a}function parseProjectConfigJSON(t){return validateProjectConfig(e.parse(t.trim()||`{}`))}const K={parse:parseProjectConfigJSON,validate:validateProjectConfig,normalizeInclude:e=>{let t=g.safeParse(e);return t.success?t.data:{paths:[],maxDepth:3,fileThreshold:30}}};function trimTrailingSlashes(e){let t=e.length;for(;t>0&&(e[t-1]===`/`||e[t-1]===`\\`);)t--;return e.slice(0,t)}function splitPath(e){return e.split(`/`).flatMap(e=>e.split(`\\`))}function basename(e){let t=trimTrailingSlashes(e),n=splitPath(t);return n[n.length-1]||t}const q=[`.likec4rc`,`.likec4.config.json`,`likec4.config.json`],J=[`likec4.config.js`,`likec4.config.cjs`,`likec4.config.mjs`,`likec4.config.ts`,`likec4.config.cts`,`likec4.config.mts`],Y=[...q,...J];function isLikeC4JsonConfig(e){return q.includes(basename(e))}function isLikeC4NonJsonConfig(e){return J.includes(basename(e))}function isLikeC4Config(e){return isLikeC4JsonConfig(e)||isLikeC4NonJsonConfig(e)}function defineConfig(e){return G.parse(e)}function defineGenerators(e){return W.parse(e)}function defineThemeColor(e){return A.parse(e)}function defineTheme(e){return P.parse(e)}function defineStyle(e){return z.parse(e)}export{defineThemeColor as a,isLikeC4JsonConfig as c,H as d,validateProjectConfig as f,defineTheme as i,isLikeC4NonJsonConfig as l,defineGenerators as n,Y as o,z as p,defineStyle as r,isLikeC4Config as s,defineConfig as t,K as u};