@likec4/config 1.57.0 → 1.59.0

package/dist/index.mjs

@@ -1,421 +1 @@
-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";
-//#region src/schema.image-alias.ts
-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+$/");
-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(ImageAliasKey, ImageAliasValue).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)."
-});
-//#endregion
-//#region src/schema.include.ts
-const IncludePathValue = z.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)");
-const IncludeSchema = z.strictObject({
-	paths: z.array(IncludePathValue).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).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("\n") })
-}).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("\n")
-});
-//#endregion
-//#region src/schema.theme.ts
-const opacity = z.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%"
-});
-const shape = z.enum(ElementShapes).meta({ id: "ElementShape" });
-const border = z.enum(BorderStyles).meta({ id: "BorderStyle" });
-const size = z.enum(Sizes).meta({ id: "ElementSize" });
-const iconPosition = z.enum(IconPositions).meta({ id: "IconPosition" });
-const arrow = z.enum(RelationshipArrowTypes).meta({ id: "ArrowType" });
-const line = z.enum([
-	"dashed",
-	"solid",
-	"dotted"
-]).meta({ id: "LineType" });
-const themeColor = z.enum(ThemeColors).meta({ id: "ThemeColorName" });
-const customColor = z.custom().refine((v) => typeof v === "string", "Custom color name must be a string").transform((value) => value).meta({ id: "CustomColorName" });
-const color = themeColor.or(customColor).transform((value) => value).meta({ id: "ColorName" });
-const colorSchema = z.string().min(1, "Color value cannot be empty").meta({ id: "ColorLiteral" });
-const ElementColorValuesSchema = z.strictObject({
-	fill: colorSchema.meta({ description: "Background color" }),
-	stroke: colorSchema.meta({ description: "Stroke color (border, paths above background)" }),
-	hiContrast: colorSchema.meta({ description: "High contrast text color (title)" }),
-	loContrast: colorSchema.meta({ description: "Low contrast text color (description)" })
-}).meta({ id: "ElementColorValues" }).transform((value) => value);
-const RelationshipColorValuesSchema = z.strictObject({
-	line: colorSchema.meta({ description: "Line color" }),
-	label: colorSchema.meta({ description: "Label text color" }),
-	labelBg: colorSchema.optional().default("rgba(0, 0, 0, 0.5)").meta({ description: "Label background color" })
-}).meta({ id: "RelationshipColorValues" }).transform((value) => value);
-const ThemeColorValuesSchema = z.strictObject({
-	elements: ElementColorValuesSchema.or(colorSchema.transform((v) => computeColorValues(v).elements)).meta({ description: "Exact color value (hex, rgb, rgba, hsl, hsla ...) or break down of specific color values" }),
-	relationships: RelationshipColorValuesSchema.or(colorSchema.transform((v) => computeColorValues(v).relationships)).meta({ description: "Exact color value (hex, rgb, rgba, hsl, hsla ...) or break down of specific color values" })
-}).transform((value) => value).meta({
-	id: "StrictThemeColorValues",
-	description: "Exact color value (hex, rgb, rgba, hsl, hsla ...) or break down of specific color value"
-}).or(colorSchema.transform((v) => computeColorValues(v))).transform((value) => value).meta({
-	id: "ThemeColorValues",
-	description: "Exact value (hex, rgb, rgba, hsl, hsla ...) or break down of specific color values"
-});
-const ThemeColorsSchema = z.partialRecord(color, ThemeColorValuesSchema).transform((value) => value);
-const DimensionsSchema = z.strictObject({
-	width: z.number().min(50),
-	height: z.number().min(50)
-}).meta({
-	id: "Dimensions",
-	description: "Defines dimensions for theme size"
-});
-const LikeC4Config_Styles_Theme_Sizes = z.partialRecord(size, DimensionsSchema);
-const LikeC4Config_Styles_Theme = z.strictObject({
-	colors: ThemeColorsSchema.optional().meta({ description: "Override theme colors" }),
-	sizes: LikeC4Config_Styles_Theme_Sizes.optional().meta({ description: "Override theme sizes" })
-}).meta({
-	id: "ThemeCustomization",
-	description: "Customize theme colors and sizes"
-}).transform(({ colors, sizes }) => {
-	return exact({
-		colors: colors ? exact(colors) : void 0,
-		sizes: sizes ? exact(sizes) : void 0
-	});
-});
-const LikeC4Config_Styles_Defaults_Group = z.strictObject({
-	color: color.optional().meta({ description: "Default color for groups\n(must be a valid color name from the theme)" }),
-	opacity: opacity.optional().meta({ description: "Default opacity for groups" }),
-	border: border.optional().meta({ description: "Default border for groups" })
-}).meta({ id: "GroupDefaultStyleValues" });
-const LikeC4Config_Styles_Defaults_Relationship = z.strictObject({
-	color: color.optional().meta({ description: "Default color for relationships\n(must be a valid color name from the theme)" }),
-	line: line.optional().meta({ description: "Default line style for relationships" }),
-	arrow: arrow.optional().meta({ description: "Default arrow style for relationships" })
-}).meta({
-	id: "RelationshipDefaultStyleValues",
-	description: "Override default values for relationship style properties\nThese values will be used if such property is not defined"
-});
-const LikeC4Config_Styles_Defaults = z.strictObject({
-	color: color.optional().meta({ description: "Default color for elements\n(must be a valid color name from the theme)" }),
-	opacity: opacity.optional().meta({ description: "Default opacity (0-100%) for elements when displayed as a group (like a container)" }),
-	border: border.optional().meta({ description: "Default border style for elements when displayed as a group (like a container)" }),
-	size: size.optional().meta({ description: "Default size for elements" }),
-	shape: shape.optional().meta({ description: "Default shape for elements" }),
-	iconPosition: iconPosition.optional().meta({ description: "Default icon position for elements" }),
-	group: LikeC4Config_Styles_Defaults_Group.optional().meta({ description: "Override default values for group style properties\nThese values will be used if such property is not defined" }),
-	relationship: LikeC4Config_Styles_Defaults_Relationship.optional().meta({ description: "Override default values for relationship style properties\nThese values will be used if such property is not defined" })
-}).meta({ id: "DefaultStyleValues" });
-const LikeC4Config_Styles_CustomStylesheets = z.union([z.string().min(1, "Custom CSS file path cannot be empty"), z.array(z.string().min(1, "Custom CSS file path cannot be empty"))]).meta({ id: "CustomStylesheets" });
-const LikeC4StylesConfigSchema = z.strictObject({
-	theme: LikeC4Config_Styles_Theme.optional().meta({ description: "Project theme customization" }),
-	defaults: LikeC4Config_Styles_Defaults.optional().meta({ description: "Override default values for style properties\nThese values will be used if such property is not defined" }),
-	customCss: LikeC4Config_Styles_CustomStylesheets.optional().meta({ description: "Custom CSS (or list of CSS files) to be included in the generated diagrams" })
-}).transform(({ theme, defaults, customCss }) => exact({
-	defaults: normalizeDefaults(defaults),
-	customCss: normalizeStylesheets(customCss),
-	theme
-}));
-function normalizeDefaults(defaults) {
-	if (!defaults) return;
-	const { relationship, group, ...rest } = defaults;
-	return exact({
-		...rest,
-		relationship: relationship && exact(relationship),
-		group: group && exact(group)
-	});
-}
-function normalizeStylesheets(stylesheets) {
-	if (!stylesheets) return;
-	const paths = (Array.isArray(stylesheets) ? stylesheets : [stylesheets]).filter(Boolean);
-	if (paths.length === 0) return;
-	return {
-		paths,
-		content: ""
-	};
-}
-//#endregion
-//#region src/schema.ts
-const ManualLayoutsConfigSchema = z.strictObject({ 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: "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,
-		error: "Project name cannot be \"default\""
-	}).refine((value) => !value.includes(".") && !value.includes("@") && !value.includes("#"), {
-		abort: true,
-		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: 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(),
-	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 false." }),
-	landingPage: LandingPageSchema.optional()
-}).meta({
-	id: "LikeC4ProjectConfig",
-	description: "LikeC4 Project Configuration"
-});
-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.
-* 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 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.
-* Does not process "extends" - use `loadConfig` function instead
-*/
-function parseProjectConfigJSON(config) {
-	return validateProjectConfig(JSON5.parse(config.trim() || "{}"));
-}
-const LikeC4ProjectConfigOps = {
-	parse: parseProjectConfigJSON,
-	validate: validateProjectConfig,
-	normalizeInclude: (include) => {
-		const parsed = IncludeSchema.safeParse(include);
-		if (parsed.success) return parsed.data;
-		return {
-			paths: [],
-			maxDepth: 3,
-			fileThreshold: 30
-		};
-	}
-};
-//#endregion
-//#region src/filenames.ts
-/** 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",
-	"likec4.config.mjs",
-	"likec4.config.ts",
-	"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);
-}
-//#endregion
-//#region src/define-config.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)
-*     }
-*   }
-* })
-* ```
-*/
-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);
-}
-//#endregion
-export { ConfigFilenames, LikeC4ProjectConfigOps, LikeC4StylesConfigSchema, defineConfig, defineGenerators, defineStyle, defineTheme, defineThemeColor, isLikeC4Config, isLikeC4JsonConfig, isLikeC4NonJsonConfig };
+import{a as e,c as t,i as n,l as r,n as i,o as a,p as o,r as s,s as c,t as l,u}from"./chunks/src.mjs";export{a as ConfigFilenames,u as LikeC4ProjectConfigOps,o as LikeC4StylesConfigSchema,l as defineConfig,i as defineGenerators,s as defineStyle,n as defineTheme,e as defineThemeColor,c as isLikeC4Config,t as isLikeC4JsonConfig,r as isLikeC4NonJsonConfig};