@likec4/config 1.52.0 → 1.53.0

package/dist/index.d.mts

@@ -143,6 +143,13 @@ declare const LikeC4ProjectJsonConfigSchema: z.ZodObject<{
   }, 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>;
 /**
@@ -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;
 /**
@@ -584,4 +593,4 @@ declare function defineTheme<const S extends LikeC4ConfigThemeInput>(theme: S):
  */
 declare function defineStyle<const S extends LikeC4StylesConfigInput>(styles: S): LikeC4ProjectStylesConfig;
 //#endregion
-export { ConfigFilenames, type GeneratorFn, type GeneratorFnContext, type GeneratorFnParams, type IncludeConfig, type LikeC4ConfigThemeInput, type LikeC4ProjectConfig, type LikeC4ProjectConfigInput, LikeC4ProjectConfigOps, type LikeC4ProjectJsonConfig, type LikeC4StylesConfig, type LikeC4StylesConfigInput, type LocateResult, type ThemeColorValuesInput, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig };
+export { ConfigFilenames, type GeneratorFn, type GeneratorFnContext, type GeneratorFnParams, type IncludeConfig, type LikeC4ConfigThemeInput, type LikeC4ProjectConfig, type LikeC4ProjectConfigInput, LikeC4ProjectConfigOps, type LikeC4ProjectJsonConfig, type LikeC4StylesConfig, type LikeC4StylesConfigInput, LikeC4StylesConfigSchema, type LocateResult, type ThemeColorValuesInput, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig };

package/dist/index.mjs

@@ -151,6 +151,14 @@ const ManualLayoutsConfigSchema = z.strictObject({ outDir: z.string().default(".
 	id: "ManualLayoutsConfig",
 	description: "Configuration for manual layouts"
 });
+const LandingPageSchema = z.union([
+	z.strictObject({ redirect: z.literal(true) }),
+	z.strictObject({ include: z.array(z.string().nonempty().refine((s) => s !== "#", { message: "selector cannot be \"#\"" })).nonempty("include list cannot be empty") }),
+	z.strictObject({ exclude: z.array(z.string().nonempty().refine((s) => s !== "#", { 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."
+});
 const LikeC4ProjectJsonConfigSchema = z.object({
 	name: z.string().nonempty("Project name cannot be empty").refine((value) => value !== "default", {
 		abort: true,
@@ -173,7 +181,8 @@ const LikeC4ProjectJsonConfigSchema = z.object({
 		"Applies to aws:, azure:, gcp:, and tech: icons. Bootstrap icons are excluded.",
 		"Defaults to true."
 	].join("\n") }),
-	implicitViews: z.boolean().optional().meta({ description: "Auto-generate scoped views for elements without explicit views. Defaults to false." })
+	implicitViews: z.boolean().optional().meta({ description: "Auto-generate scoped views for elements without explicit views. Defaults to false." }),
+	landingPage: LandingPageSchema.optional()
 }).meta({
 	id: "LikeC4ProjectConfig",
 	description: "LikeC4 Project Configuration"
@@ -183,11 +192,34 @@ const GeneratorsSchema = z.record(z.string(), FunctionType);
 const LikeC4ProjectConfigSchema = LikeC4ProjectJsonConfigSchema.extend({ generators: GeneratorsSchema.optional() });
 /**
 * 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.
 */
 function validateProjectConfig(config) {
-	const parsed = LikeC4ProjectConfigSchema.safeParse(config);
-	if (parsed.success) return parsed.data;
-	throw new Error("Config validation failed:\n" + z.prettifyError(parsed.error));
+	const inputLandingPage = config["landingPage"];
+	let validatedLandingPage = null;
+	if (inputLandingPage != null) {
+		const lpResult = LandingPageSchema.safeParse(inputLandingPage);
+		if (!lpResult.success) throw new Error("Config validation failed:\n" + z.prettifyError(lpResult.error));
+		validatedLandingPage = lpResult.data;
+	}
+	const parsed = LikeC4ProjectJsonConfigSchema.safeParse(config);
+	if (!parsed.success) throw new Error("Config validation failed:\n" + z.prettifyError(parsed.error));
+	let data = parsed.data;
+	if (validatedLandingPage !== null) data = {
+		...data,
+		landingPage: validatedLandingPage
+	};
+	const generatorsInput = config["generators"];
+	if (generatorsInput != null && typeof generatorsInput === "object" && !Array.isArray(generatorsInput)) {
+		const genParsed = GeneratorsSchema.safeParse(generatorsInput);
+		if (!genParsed.success) throw new Error("Config validation failed (generators):\n" + z.prettifyError(genParsed.error));
+		return {
+			...data,
+			generators: genParsed.data
+		};
+	}
+	return data;
 }
 /**
 * Parses JSON string into a LikeC4ProjectConfig object.
@@ -374,4 +406,4 @@ function defineTheme(theme) {
 function defineStyle(styles) {
 	return LikeC4StylesConfigSchema.parse(styles);
 }
-export { ConfigFilenames, LikeC4ProjectConfigOps, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig };
+export { ConfigFilenames, LikeC4ProjectConfigOps, LikeC4StylesConfigSchema, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig };

package/dist/node/index.d.mts

@@ -143,6 +143,13 @@ declare const LikeC4ProjectJsonConfigSchema: z.ZodObject<{
   }, 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>;
 /**
@@ -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;
 /**
@@ -591,4 +600,4 @@ declare function defineStyle<const S extends LikeC4StylesConfigInput>(styles: S)
  */
 declare function loadConfig(filepath: VscodeURI | string): Promise<LikeC4ProjectConfig>;
 //#endregion
-export { ConfigFilenames, type GeneratorFn, type GeneratorFnContext, type GeneratorFnParams, type IncludeConfig, type LikeC4ConfigThemeInput, type LikeC4ProjectConfig, type LikeC4ProjectConfigInput, LikeC4ProjectConfigOps, type LikeC4ProjectJsonConfig, type LikeC4StylesConfig, type LikeC4StylesConfigInput, type LocateResult, type ThemeColorValuesInput, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig, loadConfig };
+export { ConfigFilenames, type GeneratorFn, type GeneratorFnContext, type GeneratorFnParams, type IncludeConfig, type LikeC4ConfigThemeInput, type LikeC4ProjectConfig, type LikeC4ProjectConfigInput, LikeC4ProjectConfigOps, type LikeC4ProjectJsonConfig, type LikeC4StylesConfig, type LikeC4StylesConfigInput, LikeC4StylesConfigSchema, type LocateResult, type ThemeColorValuesInput, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig, loadConfig };

package/dist/node/index.mjs

@@ -159,6 +159,14 @@ const ManualLayoutsConfigSchema = z.strictObject({ outDir: z.string().default(".
 	id: "ManualLayoutsConfig",
 	description: "Configuration for manual layouts"
 });
+const LandingPageSchema = z.union([
+	z.strictObject({ redirect: z.literal(true) }),
+	z.strictObject({ include: z.array(z.string().nonempty().refine((s) => s !== "#", { message: "selector cannot be \"#\"" })).nonempty("include list cannot be empty") }),
+	z.strictObject({ exclude: z.array(z.string().nonempty().refine((s) => s !== "#", { 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."
+});
 const LikeC4ProjectJsonConfigSchema = z.object({
 	name: z.string().nonempty("Project name cannot be empty").refine((value) => value !== "default", {
 		abort: true,
@@ -181,7 +189,8 @@ const LikeC4ProjectJsonConfigSchema = z.object({
 		"Applies to aws:, azure:, gcp:, and tech: icons. Bootstrap icons are excluded.",
 		"Defaults to true."
 	].join("\n") }),
-	implicitViews: z.boolean().optional().meta({ description: "Auto-generate scoped views for elements without explicit views. Defaults to false." })
+	implicitViews: z.boolean().optional().meta({ description: "Auto-generate scoped views for elements without explicit views. Defaults to false." }),
+	landingPage: LandingPageSchema.optional()
 }).meta({
 	id: "LikeC4ProjectConfig",
 	description: "LikeC4 Project Configuration"
@@ -191,11 +200,34 @@ const GeneratorsSchema = z.record(z.string(), FunctionType);
 const LikeC4ProjectConfigSchema = LikeC4ProjectJsonConfigSchema.extend({ generators: GeneratorsSchema.optional() });
 /**
 * 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.
 */
 function validateProjectConfig(config) {
-	const parsed = LikeC4ProjectConfigSchema.safeParse(config);
-	if (parsed.success) return parsed.data;
-	throw new Error("Config validation failed:\n" + z.prettifyError(parsed.error));
+	const inputLandingPage = config["landingPage"];
+	let validatedLandingPage = null;
+	if (inputLandingPage != null) {
+		const lpResult = LandingPageSchema.safeParse(inputLandingPage);
+		if (!lpResult.success) throw new Error("Config validation failed:\n" + z.prettifyError(lpResult.error));
+		validatedLandingPage = lpResult.data;
+	}
+	const parsed = LikeC4ProjectJsonConfigSchema.safeParse(config);
+	if (!parsed.success) throw new Error("Config validation failed:\n" + z.prettifyError(parsed.error));
+	let data = parsed.data;
+	if (validatedLandingPage !== null) data = {
+		...data,
+		landingPage: validatedLandingPage
+	};
+	const generatorsInput = config["generators"];
+	if (generatorsInput != null && typeof generatorsInput === "object" && !Array.isArray(generatorsInput)) {
+		const genParsed = GeneratorsSchema.safeParse(generatorsInput);
+		if (!genParsed.success) throw new Error("Config validation failed (generators):\n" + z.prettifyError(genParsed.error));
+		return {
+			...data,
+			generators: genParsed.data
+		};
+	}
+	return data;
 }
 /**
 * Parses JSON string into a LikeC4ProjectConfig object.
@@ -495,4 +527,4 @@ export {
 	});
 	return validateProjectConfig(Object.assign(implicitcfg, mod?.default ?? mod));
 }
-export { ConfigFilenames, LikeC4ProjectConfigOps, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig, loadConfig };
+export { ConfigFilenames, LikeC4ProjectConfigOps, LikeC4StylesConfigSchema, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig, loadConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@likec4/config",
-  "version": "1.52.0",
+  "version": "1.53.0",
   "license": "MIT",
   "homepage": "https://likec4.dev",
   "author": "Denis Davydkov <denis@davydkov.com>",
@@ -56,12 +56,12 @@
     "json5": "^2.2.3",
     "zod": "^3.25.76",
     "type-fest": "^4.41.0",
-    "@likec4/core": "1.52.0",
-    "@likec4/log": "1.52.0"
+    "@likec4/core": "1.53.0",
+    "@likec4/log": "1.53.0"
   },
   "peerDependencies": {
     "bundle-require": "^5.1.0",
-    "esbuild": "0.27.3"
+    "esbuild": "0.27.4"
   },
   "peerDependenciesMeta": {
     "esbuild": {
@@ -72,17 +72,17 @@
     }
   },
   "devDependencies": {
-    "@types/node": "~22.19.11",
+    "@types/node": "~22.19.15",
     "remeda": "^2.33.6",
     "defu": "^6.1.4",
     "ufo": "1.6.3",
     "tsx": "4.21.0",
-    "turbo": "2.8.13",
+    "turbo": "2.8.17",
     "typescript": "5.9.3",
-    "obuild": "^0.4.31",
+    "obuild": "0.4.31",
     "nano-spawn": "^2.0.0",
-    "vitest": "4.0.18",
-    "@likec4/tsconfig": "1.52.0",
+    "vitest": "4.1.0",
+    "@likec4/tsconfig": "1.53.0",
     "@likec4/devops": "1.42.0"
   },
   "scripts": {

package/schema.json

@@ -86,6 +86,9 @@
     "implicitViews": {
       "description": "Auto-generate scoped views for elements without explicit views. Defaults to false.",
       "type": "boolean"
+    },
+    "landingPage": {
+      "$ref": "#/$defs/LandingPageConfig"
     }
   },
   "required": [
@@ -523,6 +526,59 @@
         }
       },
       "additionalProperties": false
+    },
+    "LandingPageConfig": {
+      "id": "LandingPageConfig",
+      "description": "Configure the landing page. Use redirect to go to the index view, or include/exclude to filter the view grid.",
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "redirect": {
+              "type": "boolean",
+              "const": true
+            }
+          },
+          "required": [
+            "redirect"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "include": {
+              "minItems": 1,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          "required": [
+            "include"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "exclude": {
+              "minItems": 1,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          "required": [
+            "exclude"
+          ],
+          "additionalProperties": false
+        }
+      ]
     }
   }
 }

package/src/index.ts

@@ -23,6 +23,10 @@ export type {
   ThemeColorValuesInput,
 } from './schema.theme'
 
+export {
+  LikeC4StylesConfigSchema,
+} from './schema.theme'
+
 export {
   ConfigFilenames,
   isLikeC4Config,

package/src/schema.ts

@@ -53,6 +53,28 @@ export const ManualLayoutsConfigSchema = z
 
 export type ManualLayoutsConfig = z.infer<typeof ManualLayoutsConfigSchema>
 
+export const LandingPageSchema = z
+  .union([
+    z.strictObject({
+      redirect: z.literal(true),
+    }),
+    z.strictObject({
+      include: z.array(z.string().nonempty().refine(s => s !== '#', { message: 'selector cannot be "#"' })).nonempty(
+        'include list cannot be empty',
+      ),
+    }),
+    z.strictObject({
+      exclude: z.array(z.string().nonempty().refine(s => s !== '#', { 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.',
+  })
+
 export const LikeC4ProjectJsonConfigSchema = z.object({
   name: z.string()
     .nonempty('Project name cannot be empty')
@@ -105,6 +127,7 @@ export const LikeC4ProjectJsonConfigSchema = z.object({
     .meta({
       description: 'Auto-generate scoped views for elements without explicit views. Defaults to false.',
     }),
+  landingPage: LandingPageSchema.optional(),
 })
   .meta({
     id: 'LikeC4ProjectConfig',
@@ -271,13 +294,40 @@ export 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.
  */
 export function validateProjectConfig<C extends Record<string, unknown>>(config: C): LikeC4ProjectConfig {
-  const parsed = LikeC4ProjectConfigSchema.safeParse(config)
-  if (parsed.success) {
-    return parsed.data as unknown as LikeC4ProjectConfig
+  const inputLandingPage = config['landingPage']
+  let validatedLandingPage: z.infer<typeof LandingPageSchema> | null = null
+  if (inputLandingPage != null) {
+    const lpResult = LandingPageSchema.safeParse(inputLandingPage)
+    if (!lpResult.success) {
+      throw new Error('Config validation failed:\n' + z.prettifyError(lpResult.error))
+    }
+    validatedLandingPage = lpResult.data
+  }
+  const parsed = LikeC4ProjectJsonConfigSchema.safeParse(config)
+  if (!parsed.success) {
+    throw new Error('Config validation failed:\n' + z.prettifyError(parsed.error))
+  }
+  let data = parsed.data as unknown as LikeC4ProjectConfig
+  if (validatedLandingPage !== null) {
+    data = { ...data, landingPage: validatedLandingPage }
+  }
+  const generatorsInput = config['generators']
+  if (
+    generatorsInput != null &&
+    typeof generatorsInput === 'object' &&
+    !Array.isArray(generatorsInput)
+  ) {
+    const genParsed = GeneratorsSchema.safeParse(generatorsInput)
+    if (!genParsed.success) {
+      throw new Error('Config validation failed (generators):\n' + z.prettifyError(genParsed.error))
+    }
+    return { ...data, generators: genParsed.data as Record<string, GeneratorFn> }
   }
-  throw new Error('Config validation failed:\n' + z.prettifyError(parsed.error))
+  return data
 }
 
 /**