igniteui-theming 25.1.0 → 25.2.0

package/dist/mcp/tools/handlers/layout.js

@@ -1,197 +1,146 @@
-import "../../knowledge/colors.js";
-import { COMPONENT_METADATA, getComponentSelector, getComponentPlatformAvailability } from "../../knowledge/component-metadata.js";
-import "../../knowledge/custom-palettes.js";
-import "../../utils/types.js";
-import "../../knowledge/palettes.js";
-import "node:fs";
-import "node:path";
-const SIZE_KEYWORDS = {
-  small: 1,
-  medium: 2,
-  large: 3
+import { COMPONENT_METADATA, getComponentPlatformAvailability, getComponentSelector } from "../../knowledge/component-metadata.js";
+import "../../knowledge/index.js";
+//#region src/tools/handlers/layout.ts
+/**
+* Handlers for layout scale tools: set_size, set_spacing, set_roundness.
+*/
+var SIZE_KEYWORDS = {
+	small: 1,
+	medium: 2,
+	large: 3
 };
 function normalizeComponentName(component) {
-  return component ? component.toLowerCase().trim() : null;
+	return component ? component.toLowerCase().trim() : null;
 }
 function buildSelectorList(value) {
-  return Array.isArray(value) ? value : [value];
+	return Array.isArray(value) ? value : [value];
 }
 function resolveScope(component, scope, platform) {
-  const notes = [];
-  if (component) {
-    const normalized = normalizeComponentName(component);
-    if (!normalized || !COMPONENT_METADATA[normalized]) {
-      const available = Object.keys(COMPONENT_METADATA);
-      const suggestions = normalized ? available.filter((name) => name.includes(normalized)).slice(0, 10) : [];
-      const list = suggestions.length > 0 ? suggestions : available.slice(0, 15);
-      return {
-        error: `**Error:** Component "${component}" not found.
+	const notes = [];
+	if (component) {
+		const normalized = normalizeComponentName(component);
+		if (!normalized || !COMPONENT_METADATA[normalized]) {
+			const available = Object.keys(COMPONENT_METADATA);
+			const suggestions = normalized ? available.filter((name) => name.includes(normalized)).slice(0, 10) : [];
+			const list = suggestions.length > 0 ? suggestions : available.slice(0, 15);
+			return { error: `**Error:** Component "${component}" not found.
 
 ${suggestions.length > 0 ? "**Similar components:**" : "**Available components:**"}
-${list.map((name) => `- ${name}`).join("\n")}`
-      };
-    }
-    if (scope) {
-      notes.push("Scope ignored because component was provided.");
-    }
-    const selectorsEntry = COMPONENT_METADATA[normalized].selectors;
-    let selectors = [];
-    if (platform && platform !== "generic") {
-      selectors = getComponentSelector(normalized, platform);
-      if (selectors.length === 0) {
-        const availability = getComponentPlatformAvailability(normalized);
-        const availablePlatforms = [];
-        if (availability?.angular) availablePlatforms.push("angular");
-        if (availability?.webcomponents)
-          availablePlatforms.push("webcomponents");
-        return {
-          error: `**Error:** Component "${component}" is not available on platform "${platform}".
-${availablePlatforms.length > 0 ? `Available platforms: ${availablePlatforms.join(", ")}.` : ""}`
-        };
-      }
-    } else {
-      if (selectorsEntry.angular) {
-        selectors = selectors.concat(buildSelectorList(selectorsEntry.angular));
-      }
-      if (selectorsEntry.webcomponents) {
-        selectors = selectors.concat(
-          buildSelectorList(selectorsEntry.webcomponents)
-        );
-      }
-      if (selectorsEntry.angular && selectorsEntry.webcomponents) {
-        notes.push(
-          "Platform not specified; output includes Angular and Web Components selectors."
-        );
-      }
-    }
-    return {
-      selectors: Array.from(new Set(selectors)),
-      notes,
-      scopeLabel: `component "${normalized}"`
-    };
-  }
-  if (scope) {
-    return {
-      selectors: [scope],
-      notes,
-      scopeLabel: `scope "${scope}"`
-    };
-  }
-  return {
-    selectors: [":root"],
-    notes,
-    scopeLabel: "global scope (:root)"
-  };
+${list.map((name) => `- ${name}`).join("\n")}` };
+		}
+		if (scope) notes.push("Scope ignored because component was provided.");
+		const selectorsEntry = COMPONENT_METADATA[normalized].selectors;
+		let selectors = [];
+		if (platform && platform !== "generic") {
+			selectors = getComponentSelector(normalized, platform);
+			if (selectors.length === 0) {
+				const availability = getComponentPlatformAvailability(normalized);
+				const availablePlatforms = [];
+				if (availability?.angular) availablePlatforms.push("angular");
+				if (availability?.webcomponents) availablePlatforms.push("webcomponents");
+				return { error: `**Error:** Component "${component}" is not available on platform "${platform}".
+${availablePlatforms.length > 0 ? `Available platforms: ${availablePlatforms.join(", ")}.` : ""}` };
+			}
+		} else {
+			if (selectorsEntry.angular) selectors = selectors.concat(buildSelectorList(selectorsEntry.angular));
+			if (selectorsEntry.webcomponents) selectors = selectors.concat(buildSelectorList(selectorsEntry.webcomponents));
+			if (selectorsEntry.angular && selectorsEntry.webcomponents) notes.push("Platform not specified; output includes Angular and Web Components selectors.");
+		}
+		return {
+			selectors: Array.from(new Set(selectors)),
+			notes,
+			scopeLabel: `component "${normalized}"`
+		};
+	}
+	if (scope) return {
+		selectors: [scope],
+		notes,
+		scopeLabel: `scope "${scope}"`
+	};
+	return {
+		selectors: [":root"],
+		notes,
+		scopeLabel: "global scope (:root)"
+	};
 }
 function formatSelectorBlock(selectors, declarations) {
-  const selectorLine = selectors.join(",\n");
-  const lines = [
-    selectorLine,
-    "{",
-    ...declarations.map((line) => `  ${line}`),
-    "}"
-  ];
-  return lines.join("\n");
+	return [
+		selectors.join(",\n"),
+		"{",
+		...declarations.map((line) => `  ${line}`),
+		"}"
+	].join("\n");
 }
 function buildResponse(description, output, code, notes, guidance) {
-  const responseParts = [description];
-  if (notes.length > 0) {
-    responseParts.push("", ...notes);
-  }
-  if (guidance.length > 0) {
-    responseParts.push("", ...guidance);
-  }
-  responseParts.push("");
-  responseParts.push(output === "sass" ? "```scss" : "```css");
-  responseParts.push(code);
-  responseParts.push("```");
-  return {
-    content: [
-      {
-        type: "text",
-        text: responseParts.join("\n")
-      }
-    ]
-  };
+	const responseParts = [description];
+	if (notes.length > 0) responseParts.push("", ...notes);
+	if (guidance.length > 0) responseParts.push("", ...guidance);
+	responseParts.push("");
+	responseParts.push(output === "sass" ? "```scss" : "```css");
+	responseParts.push(code);
+	responseParts.push("```");
+	return { content: [{
+		type: "text",
+		text: responseParts.join("\n")
+	}] };
 }
 function coerceSizeValue(size) {
-  if (typeof size === "number") {
-    return { display: String(size), value: size };
-  }
-  const normalized = size.toLowerCase();
-  const value = SIZE_KEYWORDS[normalized];
-  return { display: `${size} (${value})`, value };
+	if (typeof size === "number") return {
+		display: String(size),
+		value: size
+	};
+	const value = SIZE_KEYWORDS[size.toLowerCase()];
+	return {
+		display: `${size} (${value})`,
+		value
+	};
 }
 async function handleSetSize(params) {
-  const { component, scope, platform, size, output = "css" } = params;
-  const resolution = resolveScope(component, scope, platform);
-  if ("error" in resolution) {
-    return {
-      content: [{ type: "text", text: resolution.error }],
-      isError: true
-    };
-  }
-  const { selectors, notes, scopeLabel } = resolution;
-  const { display, value } = coerceSizeValue(size);
-  const declarations = [`--ig-size: ${value};`];
-  const code = formatSelectorBlock(selectors, declarations);
-  const description = `Set size to ${display} in ${scopeLabel}.`;
-  const guidance = output === "sass" ? [
-    "Sass note: sizable() requires @include sizable() in component styles.",
-    "Components map --ig-size to --component-size internally."
-  ] : [];
-  return buildResponse(description, output, code, notes, guidance);
+	const { component, scope, platform, size, output = "css" } = params;
+	const resolution = resolveScope(component, scope, platform);
+	if ("error" in resolution) return {
+		content: [{
+			type: "text",
+			text: resolution.error
+		}],
+		isError: true
+	};
+	const { selectors, notes, scopeLabel } = resolution;
+	const { display, value } = coerceSizeValue(size);
+	const code = formatSelectorBlock(selectors, [`--ig-size: ${value};`]);
+	return buildResponse(`Set size to ${display} in ${scopeLabel}.`, output, code, notes, output === "sass" ? ["Sass note: sizable() requires @include sizable() in component styles.", "Components map --ig-size to --component-size internally."] : []);
 }
 async function handleSetSpacing(params) {
-  const {
-    component,
-    scope,
-    platform,
-    spacing,
-    inline,
-    block,
-    output = "css"
-  } = params;
-  const resolution = resolveScope(component, scope, platform);
-  if ("error" in resolution) {
-    return {
-      content: [{ type: "text", text: resolution.error }],
-      isError: true
-    };
-  }
-  const { selectors, notes, scopeLabel } = resolution;
-  const declarations = [];
-  if (spacing !== void 0) declarations.push(`--ig-spacing: ${spacing};`);
-  if (inline !== void 0)
-    declarations.push(`--ig-spacing-inline: ${inline};`);
-  if (block !== void 0) declarations.push(`--ig-spacing-block: ${block};`);
-  const code = formatSelectorBlock(selectors, declarations);
-  const description = `Set spacing in ${scopeLabel}.`;
-  const guidance = output === "sass" ? [
-    "Sass note: pad() functions require @include spacing() once at root scope."
-  ] : [];
-  return buildResponse(description, output, code, notes, guidance);
+	const { component, scope, platform, spacing, inline, block, output = "css" } = params;
+	const resolution = resolveScope(component, scope, platform);
+	if ("error" in resolution) return {
+		content: [{
+			type: "text",
+			text: resolution.error
+		}],
+		isError: true
+	};
+	const { selectors, notes, scopeLabel } = resolution;
+	const declarations = [];
+	if (spacing !== void 0) declarations.push(`--ig-spacing: ${spacing};`);
+	if (inline !== void 0) declarations.push(`--ig-spacing-inline: ${inline};`);
+	if (block !== void 0) declarations.push(`--ig-spacing-block: ${block};`);
+	const code = formatSelectorBlock(selectors, declarations);
+	return buildResponse(`Set spacing in ${scopeLabel}.`, output, code, notes, output === "sass" ? ["Sass note: pad() functions require @include spacing() once at root scope."] : []);
 }
 async function handleSetRoundness(params) {
-  const { component, scope, platform, radiusFactor, output = "css" } = params;
-  const resolution = resolveScope(component, scope, platform);
-  if ("error" in resolution) {
-    return {
-      content: [{ type: "text", text: resolution.error }],
-      isError: true
-    };
-  }
-  const { selectors, notes, scopeLabel } = resolution;
-  const declarations = [`--ig-radius-factor: ${radiusFactor};`];
-  const code = formatSelectorBlock(selectors, declarations);
-  const description = `Set roundness factor to ${radiusFactor} in ${scopeLabel}.`;
-  const guidance = output === "sass" ? [
-    "Sass note: border-radius() responds to --ig-radius-factor without extra mixins."
-  ] : [];
-  return buildResponse(description, output, code, notes, guidance);
+	const { component, scope, platform, radiusFactor, output = "css" } = params;
+	const resolution = resolveScope(component, scope, platform);
+	if ("error" in resolution) return {
+		content: [{
+			type: "text",
+			text: resolution.error
+		}],
+		isError: true
+	};
+	const { selectors, notes, scopeLabel } = resolution;
+	const code = formatSelectorBlock(selectors, [`--ig-radius-factor: ${radiusFactor};`]);
+	return buildResponse(`Set roundness factor to ${radiusFactor} in ${scopeLabel}.`, output, code, notes, output === "sass" ? ["Sass note: border-radius() responds to --ig-radius-factor without extra mixins."] : []);
 }
-export {
-  handleSetRoundness,
-  handleSetSize,
-  handleSetSpacing
-};
+//#endregion
+export { handleSetRoundness, handleSetSize, handleSetSpacing };

package/dist/mcp/tools/handlers/palette.js

@@ -1,127 +1,112 @@
-import { generatePaletteCss, formatCssOutput } from "../../generators/css.js";
-import { generatePalette } from "../../generators/sass.js";
 import { PLATFORM_METADATA } from "../../knowledge/platforms/index.js";
-import "../../knowledge/colors.js";
-import "../../knowledge/component-metadata.js";
-import "../../knowledge/custom-palettes.js";
-import "../../utils/types.js";
-import "../../knowledge/palettes.js";
-import "../../utils/color.js";
-import { validatePaletteColors, formatValidationResult, generateWarningComments } from "../../validators/palette.js";
+import { generatePalette } from "../../generators/sass.js";
+import { formatCssOutput, generatePaletteCss } from "../../generators/css.js";
+import { formatValidationResult, generateWarningComments, validatePaletteColors } from "../../validators/palette.js";
+import "../../validators/index.js";
+//#region src/tools/handlers/palette.ts
+/**
+* Handler for create_palette tool.
+*/
 async function handleCreatePalette(params) {
-  const variant = params.variant ?? "light";
-  const output = params.output ?? "sass";
-  const validation = await validatePaletteColors({
-    variant,
-    surface: params.surface,
-    gray: params.gray
-  });
-  if (output === "css") {
-    return handleCssOutput(params, validation);
-  }
-  return handleSassOutput(params, validation);
+	const variant = params.variant ?? "light";
+	const output = params.output ?? "sass";
+	const validation = await validatePaletteColors({
+		variant,
+		surface: params.surface,
+		gray: params.gray
+	});
+	if (output === "css") return handleCssOutput(params, validation);
+	return handleSassOutput(params, validation);
 }
+/**
+* Handle CSS output format - generates CSS custom properties directly.
+*/
 async function handleCssOutput(params, validation) {
-  try {
-    const result = await generatePaletteCss({
-      primary: params.primary,
-      secondary: params.secondary,
-      surface: params.surface,
-      gray: params.gray,
-      info: params.info,
-      success: params.success,
-      warn: params.warn,
-      error: params.error,
-      variant: params.variant
-    });
-    const formattedCss = formatCssOutput(result.css, result.description);
-    const responseParts = [result.description];
-    responseParts.push("");
-    responseParts.push("Output format: CSS custom properties");
-    const validationText = formatValidationResult(validation);
-    if (validationText) {
-      responseParts.push("");
-      responseParts.push(validationText);
-    }
-    responseParts.push("");
-    responseParts.push("```css");
-    responseParts.push(formattedCss.trimEnd());
-    responseParts.push("```");
-    return {
-      content: [
-        {
-          type: "text",
-          text: responseParts.join("\n")
-        }
-      ]
-    };
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      content: [
-        {
-          type: "text",
-          text: `**Error generating CSS palette**
-
-${message}`
-        }
-      ]
-    };
-  }
+	try {
+		const result = await generatePaletteCss({
+			primary: params.primary,
+			secondary: params.secondary,
+			surface: params.surface,
+			gray: params.gray,
+			info: params.info,
+			success: params.success,
+			warn: params.warn,
+			error: params.error,
+			variant: params.variant
+		});
+		const formattedCss = formatCssOutput(result.css, result.description);
+		const responseParts = [result.description];
+		responseParts.push("");
+		responseParts.push("Output format: CSS custom properties");
+		const validationText = formatValidationResult(validation);
+		if (validationText) {
+			responseParts.push("");
+			responseParts.push(validationText);
+		}
+		responseParts.push("");
+		responseParts.push("```css");
+		responseParts.push(formattedCss.trimEnd());
+		responseParts.push("```");
+		return { content: [{
+			type: "text",
+			text: responseParts.join("\n")
+		}] };
+	} catch (error) {
+		return { content: [{
+			type: "text",
+			text: `**Error generating CSS palette**\n\n${error instanceof Error ? error.message : String(error)}`
+		}] };
+	}
 }
+/**
+* Handle Sass output format - generates Sass code using the palette() function.
+*/
 function handleSassOutput(params, validation) {
-  const result = generatePalette({
-    platform: params.platform,
-    licensed: params.licensed,
-    primary: params.primary,
-    secondary: params.secondary,
-    surface: params.surface,
-    gray: params.gray,
-    info: params.info,
-    success: params.success,
-    warn: params.warn,
-    error: params.error,
-    variant: params.variant,
-    name: params.name
-  });
-  let finalCode = result.code;
-  if (!validation.isValid) {
-    const warningComments = generateWarningComments(validation);
-    if (warningComments.length > 0) {
-      const lines = finalCode.split("\n");
-      const useIndex = lines.findIndex(
-        (line) => line.startsWith("@use '") || line.startsWith('@use "')
-      );
-      if (useIndex > 0) {
-        lines.splice(useIndex, 0, ...warningComments, "");
-        finalCode = lines.join("\n");
-      }
-    }
-  }
-  const responseParts = [result.description];
-  const platformNote = params.platform ? `Platform: ${PLATFORM_METADATA[params.platform]?.name ?? params.platform}` : "Platform: Not specified (generic output). Specify `platform` for optimized code.";
-  responseParts.push("");
-  responseParts.push(platformNote);
-  const validationText = formatValidationResult(validation);
-  if (validationText) {
-    responseParts.push("");
-    responseParts.push(validationText);
-  }
-  responseParts.push("");
-  responseParts.push(`Variables created: ${result.variables.join(", ")}`);
-  responseParts.push("");
-  responseParts.push("```scss");
-  responseParts.push(finalCode.trimEnd());
-  responseParts.push("```");
-  return {
-    content: [
-      {
-        type: "text",
-        text: responseParts.join("\n")
-      }
-    ]
-  };
+	const result = generatePalette({
+		platform: params.platform,
+		licensed: params.licensed,
+		primary: params.primary,
+		secondary: params.secondary,
+		surface: params.surface,
+		gray: params.gray,
+		info: params.info,
+		success: params.success,
+		warn: params.warn,
+		error: params.error,
+		variant: params.variant,
+		name: params.name
+	});
+	let finalCode = result.code;
+	if (!validation.isValid) {
+		const warningComments = generateWarningComments(validation);
+		if (warningComments.length > 0) {
+			const lines = finalCode.split("\n");
+			const useIndex = lines.findIndex((line) => line.startsWith("@use '") || line.startsWith("@use \""));
+			if (useIndex > 0) {
+				lines.splice(useIndex, 0, ...warningComments, "");
+				finalCode = lines.join("\n");
+			}
+		}
+	}
+	const responseParts = [result.description];
+	const platformNote = params.platform ? `Platform: ${PLATFORM_METADATA[params.platform]?.name ?? params.platform}` : "Platform: Not specified (generic output). Specify `platform` for optimized code.";
+	responseParts.push("");
+	responseParts.push(platformNote);
+	const validationText = formatValidationResult(validation);
+	if (validationText) {
+		responseParts.push("");
+		responseParts.push(validationText);
+	}
+	responseParts.push("");
+	responseParts.push(`Variables created: ${result.variables.join(", ")}`);
+	responseParts.push("");
+	responseParts.push("```scss");
+	responseParts.push(finalCode.trimEnd());
+	responseParts.push("```");
+	return { content: [{
+		type: "text",
+		text: responseParts.join("\n")
+	}] };
 }
-export {
-  handleCreatePalette
-};
+//#endregion
+export { handleCreatePalette };