@likec4/config 1.49.0 → 1.50.0

package/README.md

@@ -180,6 +180,7 @@ Fields:
 - `name` (required): unique project id within the workspace
 - `title` (optional): human-readable project title
 - `contactPerson` (optional): maintainer/author
+- `metadata` (optional): arbitrary project-level key-value pairs
 - `extends` (optional): string or array of strings, paths to JSON configs to merge `styles` from (relative to each config file)
 - `styles` (optional): theme/defaults/customCss customization
 - `exclude` (optional): array of glob patterns (picomatch) to exclude (defaults to `['**/node_modules/**']`)

package/dist/_chunks/libs/remeda.mjs

@@ -1,33 +1,33 @@
-function e$1(e, t, n) {
+function e$2(e, t, n) {
 	let r = (n) => e(n, ...t);
 	return n === void 0 ? r : Object.assign(r, {
 		lazy: n,
 		lazyArgs: t
 	});
 }
-function t$2(t, n, r) {
+function t$3(t, n, r) {
 	let i = t.length - n.length;
 	if (i === 0) return t(...n);
-	if (i === 1) return e$1(t, n, r);
+	if (i === 1) return e$2(t, n, r);
 	throw Error(`Wrong number of arguments`);
 }
-function t$1(...t) {
-	return t$2(n$2, t);
+function t$2(...t) {
+	return t$3(n$2, t);
 }
 const n$2 = (e, t) => e.length >= t;
-function e(e) {
+function e$1(e) {
 	return e != null;
 }
-function t(...t) {
-	return t$2(n$1, t);
+function t$1(...t) {
+	return t$3(n$1, t);
 }
 const n$1 = (e) => e.at(-1);
 function n(...t) {
-	return t$2(r, t);
+	return t$3(r, t);
 }
 function r(e, n) {
-	if (!t$1(n, 1)) return { ...e };
-	if (!t$1(n, 2)) {
+	if (!t$2(n, 1)) return { ...e };
+	if (!t$2(n, 2)) {
 		let { [n[0]]: t, ...r } = e;
 		return r;
 	}
@@ -35,4 +35,10 @@ function r(e, n) {
 	for (let e of n) delete r[e];
 	return r;
 }
-export { t$1 as i, t as n, e as r, n as t };
+new Set([
+	`-`,
+	`_`,
+	...`	.
+.\v.\f.\r. .….\xA0. . . . . . . . . . . . .\u2028.\u2029. . .　.`.split(`.`)
+]);
+export { t$2 as i, t$1 as n, e$1 as r, n as t };

package/dist/index.d.mts

@@ -25,6 +25,7 @@ declare const LikeC4ProjectJsonConfigSchema: z.ZodObject<{
   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<{
@@ -140,6 +141,8 @@ declare const LikeC4ProjectJsonConfigSchema: z.ZodObject<{
   manualLayouts: z.ZodOptional<z.ZodObject<{
     outDir: z.ZodDefault<z.ZodString>;
   }, z.core.$strict>>;
+  inferTechnologyFromIcon: z.ZodOptional<z.ZodBoolean>;
+  implicitViews: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type LikeC4ProjectJsonConfig = z.input<typeof LikeC4ProjectJsonConfigSchema>;
 /**
@@ -460,21 +463,18 @@ interface LikeC4StylesConfig extends z.infer<typeof LikeC4StylesConfigSchema> {}
 type LikeC4StylesConfigInput = z.input<typeof LikeC4StylesConfigSchema>;
 //#endregion
 //#region src/filenames.d.ts
-declare const configJsonFilenames: readonly [".likec4rc", ".likec4.config.json", "likec4.config.json"];
-declare const configNonJsonFilenames: readonly ["likec4.config.js", "likec4.config.cjs", "likec4.config.mjs", "likec4.config.ts", "likec4.config.cts", "likec4.config.mts"];
+/** 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;
 /**
- * Checks if the given filename is a LikeC4 JSON config file (JSON, RC).
+ * Returns true if the **basename** of the given path matches a known non-JSON config filename (JS, MJS, TS, MTS).
  */
-declare function isLikeC4JsonConfig(filename: string): filename is typeof configJsonFilenames[number];
+declare function isLikeC4NonJsonConfig(filename: string): boolean;
 /**
- * Checks if the given filename is a LikeC4 non-JSON config file (JS, MJS, TS, MTS)
+ * Returns true if the **basename** of the given path matches a known LikeC4 config file (JSON or non-JSON).
  */
-declare function isLikeC4NonJsonConfig(filename: string): filename is typeof configNonJsonFilenames[number];
-/**
- * Checks if the given filename is a LikeC4 config file (JSON or non-JSON)
- */
-declare function isLikeC4Config(filename: string): filename is typeof ConfigFilenames[number];
+declare function isLikeC4Config(filename: string): boolean;
 //#endregion
 //#region src/define-config.d.ts
 /**

package/dist/index.mjs

@@ -2,7 +2,6 @@ import JSON5 from "json5";
 import z from "zod/v4";
 import { BorderStyles, ElementShapes, IconPositions, RelationshipArrowTypes, Sizes, ThemeColors, computeColorValues } from "@likec4/core/styles";
 import { exact } from "@likec4/core/types";
-import { basename } from "pathe";
 const IMAGE_ALIAS_KEY_REGEX = /^@[A-Za-z0-9_-]*$/;
 const IMAGE_ALIAS_VALUE_REGEX = /^(?!\/|[A-Za-z]:[\\\/])(?!.*:\/\/).*$/;
 const ImageAliasKey = z.string().min(1, "Image alias key cannot be empty").regex(IMAGE_ALIAS_KEY_REGEX, "Image alias key must match /^@\\w+$/");
@@ -163,11 +162,18 @@ const LikeC4ProjectJsonConfigSchema = z.object({
 	extends: z.union([z.string().min(1, "Extend path cannot be empty"), z.array(z.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: 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" }),
+	metadata: z.record(z.string(), z.any()).optional().meta({ description: "Arbitrary metadata as key-value pairs for custom project information" }),
 	styles: LikeC4StylesConfigSchema.optional().meta({ description: "Project styles customization" }),
 	imageAliases: ImageAliasesSchema.optional(),
 	include: IncludeSchema.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()
+	manualLayouts: ManualLayoutsConfigSchema.optional(),
+	inferTechnologyFromIcon: z.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("\n") }),
+	implicitViews: z.boolean().optional().meta({ description: "Auto-generate scoped views for elements without explicit views. Defaults to true." })
 }).meta({
 	id: "LikeC4ProjectConfig",
 	description: "LikeC4 Project Configuration"
@@ -175,11 +181,18 @@ const LikeC4ProjectJsonConfigSchema = z.object({
 const FunctionType = z.instanceof(Function);
 const GeneratorsSchema = z.record(z.string(), FunctionType);
 const LikeC4ProjectConfigSchema = LikeC4ProjectJsonConfigSchema.extend({ generators: GeneratorsSchema.optional() });
+/**
+* Validates Object into a LikeC4ProjectConfig object.
+*/
 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));
 }
+/**
+* Parses JSON string into a LikeC4ProjectConfig object.
+* Does not process "extends" - use `loadConfig` function instead
+*/
 function parseProjectConfigJSON(config) {
 	return validateProjectConfig(JSON5.parse(config.trim() || "{}"));
 }
@@ -196,11 +209,29 @@ const LikeC4ProjectConfigOps = {
 		};
 	}
 };
+/** Trim trailing slashes and backslashes (no regex, avoids S5852 ReDoS). */
+function trimTrailingSlashes(s) {
+	let end = s.length;
+	while (end > 0 && (s[end - 1] === "/" || s[end - 1] === "\\")) end--;
+	return s.slice(0, end);
+}
+/** Split by / or \ without regex (avoids S5852 ReDoS). */
+function splitPath(s) {
+	return s.split("/").flatMap((part) => part.split("\\"));
+}
+/** basename compatible with Node and browser (no node:path for Vite/playground bundle). */
+function basename(path) {
+	const trimmed = trimTrailingSlashes(path);
+	const segments = splitPath(trimmed);
+	return segments[segments.length - 1] || trimmed;
+}
+/** Known LikeC4 JSON config filenames (RC and .json). */
 const configJsonFilenames = [
 	".likec4rc",
 	".likec4.config.json",
 	"likec4.config.json"
 ];
+/** Known LikeC4 non-JSON config filenames (JS, MJS, TS, MTS). */
 const configNonJsonFilenames = [
 	"likec4.config.js",
 	"likec4.config.cjs",
@@ -209,28 +240,137 @@ const configNonJsonFilenames = [
 	"likec4.config.cts",
 	"likec4.config.mts"
 ];
+/** All known LikeC4 config filenames (JSON and non-JSON). */
 const ConfigFilenames = [...configJsonFilenames, ...configNonJsonFilenames];
+/** Returns true if the **basename** of the given path matches a known config filename. */
 function isLikeC4JsonConfig(filename) {
 	return configJsonFilenames.includes(basename(filename));
 }
+/**
+* Returns true if the **basename** of the given path matches a known non-JSON config filename (JS, MJS, TS, MTS).
+*/
 function isLikeC4NonJsonConfig(filename) {
 	return configNonJsonFilenames.includes(basename(filename));
 }
+/**
+* Returns true if the **basename** of the given path matches a known LikeC4 config file (JSON or non-JSON).
+*/
 function isLikeC4Config(filename) {
 	return isLikeC4JsonConfig(filename) || isLikeC4NonJsonConfig(filename);
 }
+/**
+* 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)
+*     }
+*   }
+* })
+* ```
+*/
 function defineConfig(config) {
 	return LikeC4ProjectConfigSchema.parse(config);
 }
+/**
+* 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,
+* })
+* ```
+*/
 function defineGenerators(generators) {
 	return GeneratorsSchema.parse(generators);
 }
+/**
+* Define reusable custom theme color
+* @example
+* ```ts
+* export default defineThemeColor({
+*   element: {
+*     fill: 'red'
+*   }
+* })
+* ```
+*/
 function defineThemeColor(colors) {
 	return ThemeColorValuesSchema.parse(colors);
 }
+/**
+* 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'
+*       }
+*     })
+*   }
+* })
+* ```
+*/
 function defineTheme(theme) {
 	return LikeC4Config_Styles_Theme.parse(theme);
 }
+/**
+* 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',
+*     }
+*   }
+* })
+*/
 function defineStyle(styles) {
 	return LikeC4StylesConfigSchema.parse(styles);
 }

package/dist/node/index.d.mts

@@ -25,6 +25,7 @@ declare const LikeC4ProjectJsonConfigSchema: z.ZodObject<{
   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<{
@@ -140,6 +141,8 @@ declare const LikeC4ProjectJsonConfigSchema: z.ZodObject<{
   manualLayouts: z.ZodOptional<z.ZodObject<{
     outDir: z.ZodDefault<z.ZodString>;
   }, z.core.$strict>>;
+  inferTechnologyFromIcon: z.ZodOptional<z.ZodBoolean>;
+  implicitViews: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type LikeC4ProjectJsonConfig = z.input<typeof LikeC4ProjectJsonConfigSchema>;
 /**
@@ -460,21 +463,18 @@ interface LikeC4StylesConfig extends z.infer<typeof LikeC4StylesConfigSchema> {}
 type LikeC4StylesConfigInput = z.input<typeof LikeC4StylesConfigSchema>;
 //#endregion
 //#region src/filenames.d.ts
-declare const configJsonFilenames: readonly [".likec4rc", ".likec4.config.json", "likec4.config.json"];
-declare const configNonJsonFilenames: readonly ["likec4.config.js", "likec4.config.cjs", "likec4.config.mjs", "likec4.config.ts", "likec4.config.cts", "likec4.config.mts"];
+/** 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;
 /**
- * Checks if the given filename is a LikeC4 JSON config file (JSON, RC).
+ * Returns true if the **basename** of the given path matches a known non-JSON config filename (JS, MJS, TS, MTS).
  */
-declare function isLikeC4JsonConfig(filename: string): filename is typeof configJsonFilenames[number];
+declare function isLikeC4NonJsonConfig(filename: string): boolean;
 /**
- * Checks if the given filename is a LikeC4 non-JSON config file (JS, MJS, TS, MTS)
+ * Returns true if the **basename** of the given path matches a known LikeC4 config file (JSON or non-JSON).
  */
-declare function isLikeC4NonJsonConfig(filename: string): filename is typeof configNonJsonFilenames[number];
-/**
- * Checks if the given filename is a LikeC4 config file (JSON or non-JSON)
- */
-declare function isLikeC4Config(filename: string): filename is typeof ConfigFilenames[number];
+declare function isLikeC4Config(filename: string): boolean;
 //#endregion
 //#region src/define-config.d.ts
 /**

package/dist/node/index.mjs

@@ -4,13 +4,12 @@ import JSON5 from "json5";
 import z from "zod/v4";
 import { BorderStyles, ElementShapes, IconPositions, RelationshipArrowTypes, Sizes, ThemeColors, computeColorValues } from "@likec4/core/styles";
 import { exact } from "@likec4/core/types";
-import { basename } from "pathe";
 import { invariant } from "@likec4/core";
 import { logger, wrapError } from "@likec4/log";
 import { bundleRequire } from "bundle-require";
 import { formatMessagesSync } from "esbuild";
 import * as fs from "node:fs/promises";
-import { basename as basename$1, dirname, resolve } from "node:path";
+import { basename, dirname, resolve } from "node:path";
 const IMAGE_ALIAS_KEY_REGEX = /^@[A-Za-z0-9_-]*$/;
 const IMAGE_ALIAS_VALUE_REGEX = /^(?!\/|[A-Za-z]:[\\\/])(?!.*:\/\/).*$/;
 const ImageAliasKey = z.string().min(1, "Image alias key cannot be empty").regex(IMAGE_ALIAS_KEY_REGEX, "Image alias key must match /^@\\w+$/");
@@ -171,11 +170,18 @@ const LikeC4ProjectJsonConfigSchema = z.object({
 	extends: z.union([z.string().min(1, "Extend path cannot be empty"), z.array(z.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: 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" }),
+	metadata: z.record(z.string(), z.any()).optional().meta({ description: "Arbitrary metadata as key-value pairs for custom project information" }),
 	styles: LikeC4StylesConfigSchema.optional().meta({ description: "Project styles customization" }),
 	imageAliases: ImageAliasesSchema.optional(),
 	include: IncludeSchema.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()
+	manualLayouts: ManualLayoutsConfigSchema.optional(),
+	inferTechnologyFromIcon: z.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("\n") }),
+	implicitViews: z.boolean().optional().meta({ description: "Auto-generate scoped views for elements without explicit views. Defaults to true." })
 }).meta({
 	id: "LikeC4ProjectConfig",
 	description: "LikeC4 Project Configuration"
@@ -183,11 +189,18 @@ const LikeC4ProjectJsonConfigSchema = z.object({
 const FunctionType = z.instanceof(Function);
 const GeneratorsSchema = z.record(z.string(), FunctionType);
 const LikeC4ProjectConfigSchema = LikeC4ProjectJsonConfigSchema.extend({ generators: GeneratorsSchema.optional() });
+/**
+* Validates Object into a LikeC4ProjectConfig object.
+*/
 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));
 }
+/**
+* Parses JSON string into a LikeC4ProjectConfig object.
+* Does not process "extends" - use `loadConfig` function instead
+*/
 function parseProjectConfigJSON(config) {
 	return validateProjectConfig(JSON5.parse(config.trim() || "{}"));
 }
@@ -204,11 +217,29 @@ const LikeC4ProjectConfigOps = {
 		};
 	}
 };
+/** Trim trailing slashes and backslashes (no regex, avoids S5852 ReDoS). */
+function trimTrailingSlashes(s) {
+	let end = s.length;
+	while (end > 0 && (s[end - 1] === "/" || s[end - 1] === "\\")) end--;
+	return s.slice(0, end);
+}
+/** Split by / or \ without regex (avoids S5852 ReDoS). */
+function splitPath(s) {
+	return s.split("/").flatMap((part) => part.split("\\"));
+}
+/** basename compatible with Node and browser (no node:path for Vite/playground bundle). */
+function basename$1(path) {
+	const trimmed = trimTrailingSlashes(path);
+	const segments = splitPath(trimmed);
+	return segments[segments.length - 1] || trimmed;
+}
+/** Known LikeC4 JSON config filenames (RC and .json). */
 const configJsonFilenames = [
 	".likec4rc",
 	".likec4.config.json",
 	"likec4.config.json"
 ];
+/** Known LikeC4 non-JSON config filenames (JS, MJS, TS, MTS). */
 const configNonJsonFilenames = [
 	"likec4.config.js",
 	"likec4.config.cjs",
@@ -217,28 +248,137 @@ const configNonJsonFilenames = [
 	"likec4.config.cts",
 	"likec4.config.mts"
 ];
+/** All known LikeC4 config filenames (JSON and non-JSON). */
 const ConfigFilenames = [...configJsonFilenames, ...configNonJsonFilenames];
+/** Returns true if the **basename** of the given path matches a known config filename. */
 function isLikeC4JsonConfig(filename) {
-	return configJsonFilenames.includes(basename(filename));
+	return configJsonFilenames.includes(basename$1(filename));
 }
+/**
+* Returns true if the **basename** of the given path matches a known non-JSON config filename (JS, MJS, TS, MTS).
+*/
 function isLikeC4NonJsonConfig(filename) {
-	return configNonJsonFilenames.includes(basename(filename));
+	return configNonJsonFilenames.includes(basename$1(filename));
 }
+/**
+* Returns true if the **basename** of the given path matches a known LikeC4 config file (JSON or non-JSON).
+*/
 function isLikeC4Config(filename) {
 	return isLikeC4JsonConfig(filename) || isLikeC4NonJsonConfig(filename);
 }
+/**
+* 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)
+*     }
+*   }
+* })
+* ```
+*/
 function defineConfig(config) {
 	return LikeC4ProjectConfigSchema.parse(config);
 }
+/**
+* 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,
+* })
+* ```
+*/
 function defineGenerators(generators) {
 	return GeneratorsSchema.parse(generators);
 }
+/**
+* Define reusable custom theme color
+* @example
+* ```ts
+* export default defineThemeColor({
+*   element: {
+*     fill: 'red'
+*   }
+* })
+* ```
+*/
 function defineThemeColor(colors) {
 	return ThemeColorValuesSchema.parse(colors);
 }
+/**
+* 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'
+*       }
+*     })
+*   }
+* })
+* ```
+*/
 function defineTheme(theme) {
 	return LikeC4Config_Styles_Theme.parse(theme);
 }
+/**
+* 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',
+*     }
+*   }
+* })
+*/
 function defineStyle(styles) {
 	return LikeC4StylesConfigSchema.parse(styles);
 }
@@ -279,12 +419,16 @@ const loadJsonConfigs = async (filepath, stack) => {
 	}
 	return [...configs, parsed];
 };
+/**
+* Load LikeC4 Project config file.
+* If filepath is a non-JSON file, it will be bundled and required
+*/
 async function loadConfig(filepath) {
 	filepath = typeof filepath === "string" ? filepath : filepath.fsPath;
 	logger.getChild("config").debug`Loading config: ${filepath}`;
 	const folder = dirname(filepath);
-	const filename = basename$1(filepath);
-	const implicitcfg = { name: basename$1(folder) };
+	const filename = basename(filepath);
+	const implicitcfg = { name: basename(folder) };
 	if (isLikeC4JsonConfig(filename)) {
 		const configs = await loadJsonConfigs(resolve(filepath), []);
 		invariant(t(configs, 1), "Expect at least one config");
@@ -313,6 +457,9 @@ async function loadConfig(filepath) {
 			plugins: [{
 				name: "likec4-config",
 				setup(build) {
+					/**
+					* Intercept @likec4/config and likec4/config imports
+					*/
 					build.onResolve({ filter: /^@?likec4\/config$/ }, (args) => ({
 						path: args.path,
 						namespace: "likec4-config"
@@ -321,6 +468,9 @@ async function loadConfig(filepath) {
 						const messages = formatMessagesSync(result.errors, { kind: "error" });
 						for (const message of messages) logger.error(message);
 					});
+					/**
+					* Mock implementation, this allows to skip redundant bundling @likec4/config
+					*/
 					build.onLoad({
 						filter: /.*/,
 						namespace: "likec4-config"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@likec4/config",
-  "version": "1.49.0",
+  "version": "1.50.0",
   "license": "MIT",
   "homepage": "https://likec4.dev",
   "author": "Denis Davydkov <denis@davydkov.com>",
@@ -54,11 +54,10 @@
   },
   "dependencies": {
     "json5": "^2.2.3",
-    "pathe": "^2.0.3",
     "zod": "^3.25.76",
     "type-fest": "^4.41.0",
-    "@likec4/log": "1.49.0",
-    "@likec4/core": "1.49.0"
+    "@likec4/core": "1.50.0",
+    "@likec4/log": "1.50.0"
   },
   "peerDependencies": {
     "bundle-require": "^5.1.0",
@@ -73,18 +72,18 @@
     }
   },
   "devDependencies": {
-    "@types/node": "~22.19.10",
+    "@types/node": "~22.19.11",
     "remeda": "^2.33.5",
     "defu": "^6.1.4",
     "ufo": "1.6.3",
     "tsx": "4.21.0",
-    "turbo": "2.8.3",
+    "turbo": "2.8.10",
     "typescript": "5.9.3",
-    "obuild": "^0.4.27",
+    "obuild": "^0.4.31",
     "nano-spawn": "^2.0.0",
     "vitest": "4.0.18",
-    "@likec4/devops": "1.42.0",
-    "@likec4/tsconfig": "1.49.0"
+    "@likec4/tsconfig": "1.50.0",
+    "@likec4/devops": "1.42.0"
   },
   "scripts": {
     "generate": "tsx --conditions=sources scripts/generate.mts",

package/schema.json

@@ -36,6 +36,14 @@
       "type": "string",
       "minLength": 1
     },
+    "metadata": {
+      "description": "Arbitrary metadata as key-value pairs for custom project information",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    },
     "styles": {
       "description": "Project styles customization",
       "type": "object",
@@ -70,6 +78,14 @@
     },
     "manualLayouts": {
       "$ref": "#/$defs/ManualLayoutsConfig"
+    },
+    "inferTechnologyFromIcon": {
+      "description": "Automatically derive element technology from icon name when technology is not set explicitly.\nApplies to aws:, azure:, gcp:, and tech: icons. Bootstrap icons are excluded.\nDefaults to true.",
+      "type": "boolean"
+    },
+    "implicitViews": {
+      "description": "Auto-generate scoped views for elements without explicit views. Defaults to true.",
+      "type": "boolean"
     }
   },
   "required": [

package/src/filenames.ts

@@ -1,11 +1,31 @@
-import { basename } from 'pathe'
+/** Trim trailing slashes and backslashes (no regex, avoids S5852 ReDoS). */
+function trimTrailingSlashes(s: string): string {
+  let end = s.length
+  while (end > 0 && (s[end - 1] === '/' || s[end - 1] === '\\')) end--
+  return s.slice(0, end)
+}
+
+/** Split by / or \ without regex (avoids S5852 ReDoS). */
+function splitPath(s: string): string[] {
+  return s.split('/').flatMap(part => part.split('\\'))
+}
 
+/** basename compatible with Node and browser (no node:path for Vite/playground bundle). */
+function basename(path: string): string {
+  const trimmed = trimTrailingSlashes(path)
+  const segments = splitPath(trimmed)
+  const last = segments[segments.length - 1]
+  return last || trimmed
+}
+
+/** Known LikeC4 JSON config filenames (RC and .json). */
 export const configJsonFilenames = [
   '.likec4rc',
   '.likec4.config.json',
   'likec4.config.json',
 ] as const
 
+/** Known LikeC4 non-JSON config filenames (JS, MJS, TS, MTS). */
 export const configNonJsonFilenames = [
   'likec4.config.js',
   'likec4.config.cjs',
@@ -15,28 +35,27 @@ export const configNonJsonFilenames = [
   'likec4.config.mts',
 ] as const
 
+/** All known LikeC4 config filenames (JSON and non-JSON). */
 export const ConfigFilenames = [
   ...configJsonFilenames,
   ...configNonJsonFilenames,
 ] as const
 
-/**
- * Checks if the given filename is a LikeC4 JSON config file (JSON, RC).
- */
-export function isLikeC4JsonConfig(filename: string): filename is typeof configJsonFilenames[number] {
+/** Returns true if the **basename** of the given path matches a known config filename. */
+export function isLikeC4JsonConfig(filename: string): boolean {
   return (configJsonFilenames as readonly string[]).includes(basename(filename))
 }
 
 /**
- * Checks if the given filename is a LikeC4 non-JSON config file (JS, MJS, TS, MTS)
+ * Returns true if the **basename** of the given path matches a known non-JSON config filename (JS, MJS, TS, MTS).
  */
-export function isLikeC4NonJsonConfig(filename: string): filename is typeof configNonJsonFilenames[number] {
+export function isLikeC4NonJsonConfig(filename: string): boolean {
   return (configNonJsonFilenames as readonly string[]).includes(basename(filename))
 }
 
 /**
- * Checks if the given filename is a LikeC4 config file (JSON or non-JSON)
+ * Returns true if the **basename** of the given path matches a known LikeC4 config file (JSON or non-JSON).
  */
-export function isLikeC4Config(filename: string): filename is typeof ConfigFilenames[number] {
+export function isLikeC4Config(filename: string): boolean {
   return isLikeC4JsonConfig(filename) || isLikeC4NonJsonConfig(filename)
 }

package/src/schema.ts

@@ -1,3 +1,10 @@
+// SPDX-License-Identifier: MIT
+//
+// Copyright (c) 2023-2026 Denis Davydkov
+// Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+//
+// Portions of this file have been modified by NVIDIA CORPORATION & AFFILIATES.
+
 import type {
   DeploymentElementModel,
   DeploymentRelationModel,
@@ -72,6 +79,9 @@ export const LikeC4ProjectJsonConfigSchema = z.object({
     .nonempty('Contact person cannot be empty if specified')
     .optional()
     .meta({ description: 'A person who has been involved in creating or maintaining this project' }),
+  metadata: z.record(z.string(), z.any())
+    .optional()
+    .meta({ description: 'Arbitrary metadata as key-value pairs for custom project information' }),
   styles: LikeC4StylesConfigSchema.optional().meta({
     description: 'Project styles customization',
   }),
@@ -81,6 +91,20 @@ export const LikeC4ProjectJsonConfigSchema = z.object({
     .optional()
     .meta({ description: 'List of file patterns to exclude from the project, default is ["**/node_modules/**"]' }),
   manualLayouts: ManualLayoutsConfigSchema.optional(),
+  inferTechnologyFromIcon: z.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('\n'),
+    }),
+  implicitViews: z.boolean()
+    .optional()
+    .meta({
+      description: 'Auto-generate scoped views for elements without explicit views. Defaults to true.',
+    }),
 })
   .meta({
     id: 'LikeC4ProjectConfig',