@likec4/config 1.44.0 → 1.46.0

package/dist/index.d.mts

@@ -7,13 +7,18 @@ import * as z from 'zod';
 import { ElementColorValues, RelationshipColorValues, ThemeColorValues, ColorLiteral } from '@likec4/core/styles';
 
 declare const ManualLayoutsConfigSchema: z.ZodObject<{
-    outDir: z.ZodString;
+    outDir: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 declare const LikeC4ProjectJsonConfigSchema: z.ZodObject<{
     name: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
     contactPerson: z.ZodOptional<z.ZodString>;
     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.$strip>>;
     styles: z.ZodOptional<z.ZodPipe<z.ZodObject<{
         theme: z.ZodOptional<z.ZodPipe<z.ZodObject<{
             colors: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodPipe<z.ZodUnion<readonly [z.ZodLiteral<"amber" | "blue" | "gray" | "slate" | "green" | "indigo" | "muted" | "primary" | "red" | "secondary" | "sky">, z.ZodString]>, z.ZodTransform<"amber" | "blue" | "gray" | "slate" | "green" | "indigo" | "muted" | "primary" | "red" | "secondary" | "sky", string>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<`#${string}` | `rgb(${number},${number},${number})` | `rgba(${number},${number},${number},${number})`, string>>, z.ZodObject<{
@@ -779,7 +784,7 @@ declare const LikeC4ProjectJsonConfigSchema: z.ZodObject<{
     }>>>;
     exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     manualLayouts: z.ZodOptional<z.ZodObject<{
-        outDir: z.ZodString;
+        outDir: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 type LikeC4ProjectJsonConfig = SimplifyDeep<z.input<typeof LikeC4ProjectJsonConfigSchema>>;
@@ -912,12 +917,21 @@ type LikeC4ProjectConfigInput = SimplifyDeep<z.input<typeof LikeC4ProjectJsonCon
  * Validates JSON string or JSON object into a LikeC4ProjectConfig object.
  */
 declare function validateProjectConfig<C extends string | Record<string, unknown>>(config: C): LikeC4ProjectConfig;
-/**
- * Converts a LikeC4ProjectConfig object into a LikeC4ProjectJsonConfig object.
- * Omit generators property (as it is not serializable)
- */
-declare function serializableLikeC4ProjectConfig({ generators: _, // omit
-...config }: LikeC4ProjectConfig): LikeC4ProjectJsonConfig;
+
+declare const IncludeConfigSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+    maxDepth: z.ZodDefault<z.ZodNumber>;
+    fileThreshold: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type IncludeConfig = z.infer<typeof IncludeConfigSchema>;
+declare const IncludeSchema: z.ZodOptional<z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+    maxDepth: z.ZodDefault<z.ZodNumber>;
+    fileThreshold: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+type LikeC4IncludeConfig = z.infer<typeof IncludeSchema>;
+declare function normalizeIncludeConfig(include?: LikeC4IncludeConfig): IncludeConfig;
+declare function validateIncludePaths(include?: LikeC4IncludeConfig): void;
 
 declare const ThemeColorValuesSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<`#${string}` | `rgb(${number},${number},${number})` | `rgba(${number},${number},${number},${number})`, string>>, z.ZodObject<{
     elements: z.ZodPipe<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<`#${string}` | `rgb(${number},${number},${number})` | `rgba(${number},${number},${number},${number})`, string>>, z.ZodPipe<z.ZodObject<{
@@ -2378,4 +2392,4 @@ declare function defineTheme<const S extends LikeC4ConfigThemeInput>(theme: S):
  */
 declare function defineStyle<const S extends LikeC4StylesConfigInput>(styles: S): LikeC4ProjectStylesConfig;
 
-export { ConfigFilenames, type GeneratorFn, type GeneratorFnContext, type GeneratorFnParams, type LikeC4ProjectConfig, type LikeC4ProjectConfigInput, type LikeC4ProjectJsonConfig, type LikeC4StylesConfig, type LikeC4StylesConfigInput, type LocateResult, ManualLayoutsConfigSchema, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig, serializableLikeC4ProjectConfig, validateProjectConfig };
+export { ConfigFilenames, type GeneratorFn, type GeneratorFnContext, type GeneratorFnParams, type IncludeConfig, type LikeC4ProjectConfig, type LikeC4ProjectConfigInput, type LikeC4ProjectJsonConfig, type LikeC4StylesConfig, type LikeC4StylesConfigInput, type LocateResult, ManualLayoutsConfigSchema, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig, normalizeIncludeConfig, validateIncludePaths, validateProjectConfig };

package/dist/index.mjs

@@ -1 +1 @@
-export { C as ConfigFilenames, d as defineConfig, c as defineGenerators, e as defineStyle, f as defineTheme, g as defineThemeColor, i as isLikeC4Config, a as isLikeC4JsonConfig, b as isLikeC4NonJsonConfig, s as serializableLikeC4ProjectConfig, v as validateProjectConfig } from './shared/config.FegrYs1S.mjs';
+export { C as ConfigFilenames, d as defineConfig, e as defineGenerators, f as defineStyle, g as defineTheme, h as defineThemeColor, i as isLikeC4Config, b as isLikeC4JsonConfig, c as isLikeC4NonJsonConfig, n as normalizeIncludeConfig, a as validateIncludePaths, v as validateProjectConfig } from './shared/config.CUC_rqhf.mjs';

package/dist/node/index.d.mts

@@ -1,6 +1,6 @@
 import { URI } from 'vscode-uri';
 import { LikeC4ProjectConfig } from '../index.mjs';
-export { ConfigFilenames, GeneratorFn, GeneratorFnContext, GeneratorFnParams, LikeC4ProjectConfigInput, LikeC4ProjectJsonConfig, LikeC4StylesConfig, LikeC4StylesConfigInput, LocateResult, ManualLayoutsConfigSchema, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig, serializableLikeC4ProjectConfig, validateProjectConfig } from '../index.mjs';
+export { ConfigFilenames, GeneratorFn, GeneratorFnContext, GeneratorFnParams, IncludeConfig, LikeC4ProjectConfigInput, LikeC4ProjectJsonConfig, LikeC4StylesConfig, LikeC4StylesConfigInput, LocateResult, ManualLayoutsConfigSchema, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig, normalizeIncludeConfig, validateIncludePaths, validateProjectConfig } from '../index.mjs';
 import '@likec4/core';
 import '@likec4/core/model';
 import '@likec4/core/types';

package/dist/node/index.mjs

@@ -2,8 +2,8 @@ import { invariant } from '@likec4/core';
 import { bundleRequire } from 'bundle-require';
 import * as fs from 'node:fs/promises';
 import { dirname } from 'node:path';
-import { a as isLikeC4JsonConfig, v as validateProjectConfig, b as isLikeC4NonJsonConfig, d as defineConfig } from '../shared/config.FegrYs1S.mjs';
-export { C as ConfigFilenames, c as defineGenerators, e as defineStyle, f as defineTheme, g as defineThemeColor, i as isLikeC4Config, s as serializableLikeC4ProjectConfig } from '../shared/config.FegrYs1S.mjs';
+import { b as isLikeC4JsonConfig, v as validateProjectConfig, c as isLikeC4NonJsonConfig, d as defineConfig } from '../shared/config.CUC_rqhf.mjs';
+export { C as ConfigFilenames, e as defineGenerators, f as defineStyle, g as defineTheme, h as defineThemeColor, i as isLikeC4Config, n as normalizeIncludeConfig, a as validateIncludePaths } from '../shared/config.CUC_rqhf.mjs';
 import { rootLogger } from '@likec4/log';
 
 const logger = rootLogger.getChild("config");

package/dist/shared/{config.FegrYs1S.mjs → config.CUC_rqhf.mjs}

@@ -5,13 +5,13 @@ import { exact } from '@likec4/core/types';
 
 const IMAGE_ALIAS_KEY_REGEX = /^@[A-Za-z0-9_-]*$/;
 const IMAGE_ALIAS_VALUE_REGEX = /^(?!\/|[A-Za-z]:[\\\/])(?!.*:\/\/).*$/;
-const ImageAliasValue = z.string().nonempty("Image alias value cannot be empty").regex(
+const ImageAliasValue = z.string().min(1, "Image alias value cannot be empty").regex(
   IMAGE_ALIAS_VALUE_REGEX,
   "Image alias value must be a relative path (no leading slash or protocol)"
 );
 const ImageAliasesSchema = z.record(
   z.string(),
-  // PLAIN key schema - valibot JSON schema export-safe.
+  // PLAIN key schema - zod JSON schema export-safe.
   ImageAliasValue
 ).meta({
   description: "Map of image alias prefixes to relative paths (keys must match /^@\\w+$/; values must be relative paths without protocol or leading slash)."
@@ -45,6 +45,66 @@ function validateImageAliases(imageAliases) {
   }
 }
 
+const RELATIVE_PATH_REGEX = /^(?!\/|[A-Za-z]:[\\\/])(?!.*:\/\/).*$/;
+const IncludePathValue = z.string().min(1, "Include path cannot be empty").regex(
+  RELATIVE_PATH_REGEX,
+  "Include path must be a relative path (no leading slash, drive letter, or protocol)"
+);
+const IncludeConfigSchema = z.object({
+  paths: z.array(IncludePathValue).min(1, "Include paths cannot be empty").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("\n")
+  }),
+  maxDepth: z.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("\n")
+  }),
+  fileThreshold: z.number().int().min(1).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("\n")
+  })
+}).meta({
+  id: "include-config",
+  description: "Configuration for including additional LikeC4 source files"
+});
+const IncludeSchema = IncludeConfigSchema.optional().meta({
+  description: [
+    "Configuration for including additional LikeC4 source files from other directories.",
+    'Example: { "paths": ["../shared", "../common/specs"], "maxDepth": 5, "fileThreshold": 50 }'
+  ].join("\n")
+});
+function normalizeIncludeConfig(include) {
+  if (!include) {
+    return { paths: [], maxDepth: 3, fileThreshold: 30 };
+  }
+  return include;
+}
+function validateIncludePaths(include) {
+  if (!include?.paths) {
+    return;
+  }
+  const invalidPaths = [];
+  for (const path of include.paths) {
+    if (!RELATIVE_PATH_REGEX.test(path)) {
+      invalidPaths.push(path);
+    }
+  }
+  if (invalidPaths.length) {
+    throw new Error(
+      `Invalid include path(s): ${invalidPaths.map((p) => JSON.stringify(p)).join(", ")} (must be relative paths without leading slash, drive letter, or protocol)`
+    );
+  }
+}
+
 function e(e,t,n){let r=n=>e(n,...t);return n===void 0?r:Object.assign(r,{lazy:n,lazyArgs:t})}
 
 function t$1(t,n,r){let i=t.length-n.length;if(i===0)return t(...n);if(i===1)return e(t,n,r);throw Error(`Wrong number of arguments`)}
@@ -63,9 +123,9 @@ const line = z.literal(["dashed", "solid", "dotted"]).meta({ id: "LineType" });
 const themeColor = z.literal(ThemeColors).meta({ id: "ThemeColor" });
 const color = z.union([
   themeColor,
-  z.string().nonempty("Color name cannot be empty")
+  z.string().min(1, "Color name cannot be empty")
 ]).transform((value) => value).meta({ id: "ColorName" });
-const colorValue = z.string().nonempty("Color value cannot be empty").transform((value) => value).meta({
+const colorValue = z.string().min(1, "Color value cannot be empty").transform((value) => value).meta({
   id: "ColorLiteral",
   description: "Color value in any valid CSS format: hex, rgb, rgba, hsl, hsla ..."
 });
@@ -211,8 +271,13 @@ function normalizeDefaults(defaults) {
 }
 
 const ManualLayoutsConfigSchema = z.object({
-  outDir: z.string().meta({
-    description: "Path to the directory where manual layouts will be stored, relative to the folder containing the project config"
+  outDir: z.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("\n")
   })
 }).meta({
   id: "manual-layouts-config",
@@ -229,6 +294,7 @@ const LikeC4ProjectJsonConfigSchema = z.object({
   title: z.string().nonempty("Project title cannot be empty if specified").optional().meta({ description: "A human readable title for the project" }),
   contactPerson: z.string().nonempty("Contact person cannot be empty if specified").optional().meta({ description: "A person who has been involved in creating or maintaining this project" }),
   imageAliases: ImageAliasesSchema.optional(),
+  include: IncludeSchema,
   styles: LikeC4StylesConfigSchema.optional(),
   exclude: z.array(z.string()).optional().meta({ description: 'List of file patterns to exclude from the project, default is ["**/node_modules/**"]' }),
   manualLayouts: ManualLayoutsConfigSchema.optional()
@@ -250,15 +316,11 @@ function validateProjectConfig(config) {
   if (parsed.data.imageAliases) {
     validateImageAliases(parsed.data.imageAliases);
   }
+  if (parsed.data.include) {
+    validateIncludePaths(parsed.data.include);
+  }
   return parsed.data;
 }
-function serializableLikeC4ProjectConfig({
-  generators: _,
-  // omit
-  ...config
-}) {
-  return LikeC4ProjectJsonConfigSchema.parse(config);
-}
 
 const configJsonFilenames = [
   ".likec4rc",
@@ -311,4 +373,4 @@ function defineStyle(styles) {
   return LikeC4StylesConfigSchema.parse(styles);
 }
 
-export { ConfigFilenames as C, isLikeC4JsonConfig as a, isLikeC4NonJsonConfig as b, defineGenerators as c, defineConfig as d, defineStyle as e, defineTheme as f, defineThemeColor as g, isLikeC4Config as i, serializableLikeC4ProjectConfig as s, validateProjectConfig as v };
+export { ConfigFilenames as C, validateIncludePaths as a, isLikeC4JsonConfig as b, isLikeC4NonJsonConfig as c, defineConfig as d, defineGenerators as e, defineStyle as f, defineTheme as g, defineThemeColor as h, isLikeC4Config as i, normalizeIncludeConfig as n, validateProjectConfig as v };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@likec4/config",
-  "version": "1.44.0",
+  "version": "1.46.0",
   "license": "MIT",
   "homepage": "https://likec4.dev",
   "author": "Denis Davydkov <denis@davydkov.com>",
@@ -58,14 +58,14 @@
     "bundle-require": "^5.1.0",
     "defu": "^6.1.4",
     "json5": "^2.2.3",
-    "zod": "^4.1.12",
+    "zod": "^4.1.13",
     "type-fest": "^4.41.0"
   },
   "peerDependencies": {
     "esbuild": "^0.25.11",
     "vscode-uri": "3.1.0",
-    "@likec4/core": "1.44.0",
-    "@likec4/log": "1.44.0"
+    "@likec4/core": "1.46.0",
+    "@likec4/log": "1.46.0"
   },
   "peerDependenciesMeta": {
     "vscode-uri": {
@@ -73,18 +73,18 @@
     }
   },
   "devDependencies": {
-    "@types/node": "~20.19.22",
+    "@types/node": "~22.19.1",
     "remeda": "^2.32.0",
-    "tsx": "4.20.6",
-    "turbo": "2.6.0",
+    "tsx": "4.21.0",
+    "turbo": "2.6.3",
     "typescript": "5.9.3",
     "unbuild": "3.5.0",
     "nano-spawn": "^1.0.3",
-    "vitest": "4.0.8",
-    "@likec4/core": "1.44.0",
-    "@likec4/devops": "1.42.0",
-    "@likec4/log": "1.44.0",
-    "@likec4/tsconfig": "1.44.0"
+    "vitest": "4.0.15",
+    "@likec4/core": "1.46.0",
+    "@likec4/log": "1.46.0",
+    "@likec4/tsconfig": "1.46.0",
+    "@likec4/devops": "1.42.0"
   },
   "scripts": {
     "typecheck": "tsc -b --verbose",

package/schema.json

@@ -30,6 +30,10 @@
         "pattern": "^(?!\\/|[A-Za-z]:[\\\\\\/])(?!.*:\\/\\/).*$"
       }
     },
+    "include": {
+      "description": "Configuration for including additional LikeC4 source files from other directories.\nExample: { \"paths\": [\"../shared\", \"../common/specs\"], \"maxDepth\": 5, \"fileThreshold\": 50 }",
+      "$ref": "#/$defs/include-config"
+    },
     "styles": {
       "$ref": "#/$defs/StylesConfiguration"
     },
@@ -48,6 +52,40 @@
     "name"
   ],
   "$defs": {
+    "include-config": {
+      "id": "include-config",
+      "description": "Configuration for including additional LikeC4 source files",
+      "type": "object",
+      "properties": {
+        "paths": {
+          "description": "Additional relative directory paths to include LikeC4 source files from, searched recursively.\nPaths are relative to the project folder (the folder containing this config file).\nExample: [\"../shared\", \"../common/specs\"]",
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^(?!\\/|[A-Za-z]:[\\\\\\/])(?!.*:\\/\\/).*$"
+          }
+        },
+        "maxDepth": {
+          "description": "Maximum directory depth to scan when searching for .c4 files in include paths.\nPrevents excessive scanning of deeply nested directories.\nDefault: 3",
+          "default": 3,
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 20
+        },
+        "fileThreshold": {
+          "description": "Maximum number of files to load from include paths before warning.\nHelps identify performance issues from accidentally including large directories.\nDefault: 30",
+          "default": 30,
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "paths"
+      ]
+    },
     "StylesConfiguration": {
       "id": "StylesConfiguration",
       "description": "Project styles customization",
@@ -448,13 +486,11 @@
       "type": "object",
       "properties": {
         "outDir": {
-          "description": "Path to the directory where manual layouts will be stored, relative to the folder containing the project config",
+          "description": "Path to the directory where manual layouts will be stored,\nrelative to the folder containing the project config. \n\nDefaults to '.likec4'.",
+          "default": ".likec4",
           "type": "string"
         }
-      },
-      "required": [
-        "outDir"
-      ]
+      }
     }
   }
 }

package/src/index.ts

@@ -9,12 +9,18 @@ export type {
   ManualLayoutsConfigSchema,
 } from './schema'
 
+export type {
+  IncludeConfig,
+} from './schema.include'
+
 export type {
   LikeC4StylesConfig,
   LikeC4StylesConfigInput,
 } from './schema.theme'
 
-export { serializableLikeC4ProjectConfig, validateProjectConfig } from './schema'
+export { validateProjectConfig } from './schema'
+
+export { normalizeIncludeConfig, validateIncludePaths } from './schema.include'
 
 export {
   ConfigFilenames,

package/src/schema.image-alias.ts

@@ -8,14 +8,14 @@ const IMAGE_ALIAS_VALUE_REGEX = /^(?!\/|[A-Za-z]:[\\\/])(?!.*:\/\/).*$/
 // Schema for an image alias value: must be a non-empty string representing a relative path (no leading slash, drive letter, or protocol).
 const ImageAliasValue = z
   .string()
-  .nonempty('Image alias value cannot be empty')
+  .min(1, 'Image alias value cannot be empty')
   .regex(
     IMAGE_ALIAS_VALUE_REGEX,
     'Image alias value must be a relative path (no leading slash or protocol)',
   )
 
 export const ImageAliasesSchema = z.record(
-  z.string(), // PLAIN key schema - valibot JSON schema export-safe.
+  z.string(), // PLAIN key schema - zod JSON schema export-safe.
   ImageAliasValue,
 ).meta({
   description:
@@ -34,7 +34,7 @@ export function validateImageAliases(imageAliases?: LikeC4ImageAliasConfig) {
       if (!IMAGE_ALIAS_KEY_REGEX.test(key)) {
         invalidKeys.push(key)
       }
-      // Value regex is technically already enforced by Valibot,
+      // Value regex is technically already enforced by zod,
       // so this check is purely defensive.
       if (!IMAGE_ALIAS_VALUE_REGEX.test(value)) {
         invalidValues.push(`${key} -> ${value}`)

package/src/schema.include.ts

@@ -0,0 +1,97 @@
+import * as z from 'zod'
+
+// Relative path (no leading slash, drive letter, or protocol)
+// eslint-disable-next-line no-useless-escape
+const RELATIVE_PATH_REGEX = /^(?!\/|[A-Za-z]:[\\\/])(?!.*:\/\/).*$/
+
+// Schema for an include path value: must be a non-empty string representing a relative path
+const IncludePathValue = z
+  .string()
+  .min(1, 'Include path cannot be empty')
+  .regex(
+    RELATIVE_PATH_REGEX,
+    'Include path must be a relative path (no leading slash, drive letter, or protocol)',
+  )
+
+export const IncludeConfigSchema = z.object({
+  paths: z.array(IncludePathValue)
+    .min(1, 'Include paths cannot be empty')
+    .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('\n'),
+    }),
+  maxDepth: z.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('\n'),
+    }),
+  fileThreshold: z.number()
+    .int()
+    .min(1)
+    .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('\n'),
+    }),
+})
+  .meta({
+    id: 'include-config',
+    description: 'Configuration for including additional LikeC4 source files',
+  })
+
+export type IncludeConfig = z.infer<typeof IncludeConfigSchema>
+
+export const IncludeSchema = IncludeConfigSchema
+  .optional()
+  .meta({
+    description: [
+      'Configuration for including additional LikeC4 source files from other directories.',
+      'Example: { "paths": ["../shared", "../common/specs"], "maxDepth": 5, "fileThreshold": 50 }',
+    ].join('\n'),
+  })
+
+type LikeC4IncludeConfig = z.infer<typeof IncludeSchema>
+
+export function normalizeIncludeConfig(include?: LikeC4IncludeConfig): IncludeConfig {
+  if (!include) {
+    return { paths: [], maxDepth: 3, fileThreshold: 30 }
+  }
+  return include
+}
+
+export function validateIncludePaths(include?: LikeC4IncludeConfig) {
+  if (!include?.paths) {
+    return
+  }
+
+  const invalidPaths: string[] = []
+
+  for (const path of include.paths) {
+    if (!RELATIVE_PATH_REGEX.test(path)) {
+      invalidPaths.push(path)
+    }
+  }
+
+  if (invalidPaths.length) {
+    throw new Error(
+      `Invalid include path(s): ${
+        invalidPaths
+          .map((p) => JSON.stringify(p))
+          .join(', ')
+      } (must be relative paths without leading slash, drive letter, or protocol)`,
+    )
+  }
+}

package/src/schema.theme.ts

@@ -56,14 +56,14 @@ const themeColor = z
 const color = z
   .union([
     themeColor,
-    z.string().nonempty('Color name cannot be empty'),
+    z.string().min(1, 'Color name cannot be empty'),
   ])
   .transform(value => value as ThemeColor)
   .meta({ id: 'ColorName' })
 
 const colorValue = z
   .string()
-  .nonempty('Color value cannot be empty')
+  .min(1, 'Color value cannot be empty')
   .transform(value => value as ColorLiteral)
   .meta({
     id: 'ColorLiteral',

package/src/schema.ts

@@ -15,14 +15,20 @@ import type { SimplifyDeep } from 'type-fest'
 import type { URI } from 'vscode-uri'
 import * as z from 'zod'
 import { ImageAliasesSchema, validateImageAliases } from './schema.image-alias'
+import { IncludeSchema, validateIncludePaths } from './schema.include'
 import { LikeC4StylesConfigSchema } from './schema.theme'
 
 export const ManualLayoutsConfigSchema = z
   .object({
     outDir: z.string()
+      .default('.likec4')
       .meta({
-        description:
-          'Path to the directory where manual layouts will be stored, relative to the folder containing the project config',
+        description: [
+          'Path to the directory where manual layouts will be stored,',
+          'relative to the folder containing the project config. ',
+          '',
+          'Defaults to \'.likec4\'.',
+        ].join('\n'),
       }),
   })
   .meta({
@@ -54,6 +60,7 @@ export const LikeC4ProjectJsonConfigSchema = z.object({
     .meta({ description: 'A person who has been involved in creating or maintaining this project' }),
   imageAliases: ImageAliasesSchema
     .optional(),
+  include: IncludeSchema,
   styles: LikeC4StylesConfigSchema
     .optional(),
   exclude: z.array(z.string())
@@ -242,16 +249,8 @@ export function validateProjectConfig<C extends string | Record<string, unknown>
   if (parsed.data.imageAliases) {
     validateImageAliases(parsed.data.imageAliases)
   }
+  if (parsed.data.include) {
+    validateIncludePaths(parsed.data.include)
+  }
   return parsed.data as unknown as LikeC4ProjectConfig
 }
-
-/**
- * Converts a LikeC4ProjectConfig object into a LikeC4ProjectJsonConfig object.
- * Omit generators property (as it is not serializable)
- */
-export function serializableLikeC4ProjectConfig({
-  generators: _, // omit
-  ...config
-}: LikeC4ProjectConfig): LikeC4ProjectJsonConfig {
-  return LikeC4ProjectJsonConfigSchema.parse(config) as unknown as LikeC4ProjectJsonConfig
-}