@sebgroup/green-core 2.21.0-rc.20251218133405834 → 2.21.0-rc.20260112142904069

package/bin/mcp-server/utils.d.ts

@@ -0,0 +1,56 @@
+import type { ComponentEntry, ComponentsIndex, GlobalIndex, IconEntry, IconsIndex } from './types.js';
+/**
+ * Resolve the path to the MCP data directory
+ * When compiled: Server is at dist/libs/core/src/bin/mcp-server/
+ * When compiled: MCP data is at dist/libs/core/src/generated/mcp/
+ */
+export declare function getMcpDataPath(): string;
+/**
+ * Read the package version from package.json at runtime
+ */
+export declare function getPackageVersion(): Promise<string>;
+/**
+ * Load the components index
+ */
+export declare function loadComponentsIndex(): Promise<ComponentsIndex | null>;
+/**
+ * Load the icons index
+ */
+export declare function loadIconsIndex(): Promise<IconsIndex | null>;
+/**
+ * Load the global index
+ */
+export declare function loadGlobalIndex(): Promise<GlobalIndex | null>;
+/**
+ * Normalize component name for matching
+ * Handles both 'gds-button' and 'button' formats
+ */
+export declare function normalizeComponentName(name: string): string;
+/**
+ * Find a component by name (flexible matching)
+ */
+export declare function findComponent(name: string, components: ComponentEntry[]): ComponentEntry | null;
+/**
+ * Find an icon by name (flexible matching)
+ */
+export declare function findIcon(name: string, icons: IconEntry[]): IconEntry | null;
+/**
+ * Read a markdown file from the MCP data directory
+ */
+export declare function readMcpFile(relativePath: string): Promise<string | null>;
+/**
+ * Check if a file exists in the MCP data directory
+ */
+export declare function fileExists(relativePath: string): Promise<boolean>;
+/**
+ * Build a resource URI for a component/icon documentation file
+ */
+export declare function buildResourceUri(category: 'components' | 'icons' | 'guides' | 'concepts', name: string, docType?: string): string;
+/**
+ * Parse a resource URI into its components
+ */
+export declare function parseResourceUri(uri: string): {
+    category: string;
+    name: string;
+    docType?: string;
+} | null;

package/bin/mcp-server/utils.js

@@ -0,0 +1,123 @@
+import "../../chunks/chunk.QU3DSPNU.js";
+import { promises as fs } from "fs";
+import * as path from "node:path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+function getMcpDataPath() {
+  return path.resolve(__dirname, "../../generated/mcp");
+}
+async function getPackageVersion() {
+  try {
+    const packageJsonPath = path.resolve(__dirname, "../../package.json");
+    const content = await fs.readFile(packageJsonPath, "utf-8");
+    const pkg = JSON.parse(content);
+    return pkg.version || "0.0.0";
+  } catch (error) {
+    console.error("Failed to read package version:", error);
+    return "0.0.0";
+  }
+}
+async function loadJsonFile(filePath) {
+  try {
+    const content = await fs.readFile(filePath, "utf-8");
+    return JSON.parse(content);
+  } catch (error) {
+    console.error(`Failed to load ${filePath}:`, error);
+    return null;
+  }
+}
+async function loadComponentsIndex() {
+  const dataPath = getMcpDataPath();
+  return loadJsonFile(path.join(dataPath, "components.json"));
+}
+async function loadIconsIndex() {
+  const dataPath = getMcpDataPath();
+  return loadJsonFile(path.join(dataPath, "icons.json"));
+}
+async function loadGlobalIndex() {
+  const dataPath = getMcpDataPath();
+  return loadJsonFile(path.join(dataPath, "index.json"));
+}
+function normalizeComponentName(name) {
+  const lower = name.toLowerCase().trim();
+  if (lower.startsWith("gds-")) {
+    return lower;
+  }
+  if (lower.startsWith("icon-")) {
+    return `gds-${lower}`;
+  }
+  return `gds-${lower}`;
+}
+function findComponent(name, components) {
+  const normalized = normalizeComponentName(name);
+  let found = components.find((c) => c.tagName === normalized);
+  if (found) return found;
+  const withoutPrefix = name.replace(/^gds-/, "");
+  found = components.find((c) => c.tagName === `gds-${withoutPrefix}`);
+  if (found) return found;
+  const lowerName = name.toLowerCase();
+  found = components.find(
+    (c) => c.tagName.toLowerCase().includes(lowerName) || c.name.toLowerCase().includes(lowerName)
+  );
+  return found || null;
+}
+function findIcon(name, icons) {
+  const normalized = normalizeComponentName(name);
+  let found = icons.find((i) => i.tagName === normalized);
+  if (found) return found;
+  const withoutPrefix = name.replace(/^gds-/, "").replace(/^icon-/, "");
+  found = icons.find((i) => i.tagName === `gds-icon-${withoutPrefix}`);
+  if (found) return found;
+  const lowerName = name.toLowerCase();
+  found = icons.find(
+    (i) => i.tagName.toLowerCase().includes(lowerName) || i.name.toLowerCase().includes(lowerName)
+  );
+  return found || null;
+}
+async function readMcpFile(relativePath) {
+  try {
+    const dataPath = getMcpDataPath();
+    const fullPath = path.join(dataPath, relativePath);
+    return await fs.readFile(fullPath, "utf-8");
+  } catch (error) {
+    console.error(`Failed to read ${relativePath}:`, error);
+    return null;
+  }
+}
+async function fileExists(relativePath) {
+  try {
+    const dataPath = getMcpDataPath();
+    const fullPath = path.join(dataPath, relativePath);
+    await fs.access(fullPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function buildResourceUri(category, name, docType) {
+  if (docType) {
+    return `green://${category}/${name}/${docType}`;
+  }
+  return `green://${category}/${name}`;
+}
+function parseResourceUri(uri) {
+  const match = uri.match(/^green:\/\/([^/]+)\/([^/]+)(?:\/([^/]+))?$/);
+  if (!match) return null;
+  const [, category, name, docType] = match;
+  return { category, name, docType };
+}
+export {
+  buildResourceUri,
+  fileExists,
+  findComponent,
+  findIcon,
+  getMcpDataPath,
+  getPackageVersion,
+  loadComponentsIndex,
+  loadGlobalIndex,
+  loadIconsIndex,
+  normalizeComponentName,
+  parseResourceUri,
+  readMcpFile
+};

package/components/dropdown/dropdown.component.d.ts

@@ -152,6 +152,9 @@ declare const GdsDropdown_base: (new (...args: any[]) => import("../../utils/mix
  * @slot message - ***(deprecated - use `errorMessage` property instead)*** Error message to show below the input field whem there is a validation error.
  * @slot sub-label - ***(deprecated - use `supporting-text` property instead)*** Renders between the label and the trigger button.
  *
+ * @subcomponent gds-option - Defines an option in the dropdown
+ * @subcomponent gds-menu-heading - Defines a non-selectable heading in the dropdown options list
+ *
  * @event change - Fired when the value of the dropdown is changed through user interaction (not when value prop is set programatically).
  * @event input - Fired when the value of the dropdown is changed through user interaction.
  * @event gds-ui-state - Fired when the dropdown is opened or closed by the user. Can be cancelled to prevent the dropdown from opening or closing.

package/components/segmented-control/segmented-control.component.d.ts

@@ -8,6 +8,8 @@ declare const GdsSegmentedControl_base: (new (...args: any[]) => import("../../u
  *
  * @slot - Segments to display in the control
  *
+ * @subcomponent gds-segment - Defines a segment in the segmented control
+ *
  * @event change - Fires when the selected segment is changed
  */
 export declare class GdsSegmentedControl<ValueT = any> extends GdsSegmentedControl_base {