@fundamental-ngx/mcp 0.62.0-rc.100

package/src/extractors/build-metadata.d.ts

@@ -0,0 +1,8 @@
+import { ComponentCatalog } from '../types/component-metadata';
+/**
+ * Build the complete MCP metadata catalog.
+ *
+ * Orchestrates all extractors and writes the unified components.json.
+ * Can be run as a standalone script or via an NX executor.
+ */
+export declare function buildMetadata(basePath: string, outputPath: string): Promise<ComponentCatalog>;

package/src/extractors/build-metadata.js

@@ -0,0 +1,214 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMetadata = buildMetadata;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const cem_extractor_1 = require("./cem-extractor");
+const description_extractor_1 = require("./description-extractor");
+const example_extractor_1 = require("./example-extractor");
+const typedoc_extractor_1 = require("./typedoc-extractor");
+/** Map npm package name to the docs directory alias used in example paths. */
+const LIBRARY_TO_DIR = {
+    '@fundamental-ngx/core': 'core',
+    '@fundamental-ngx/platform': 'platform',
+    '@fundamental-ngx/btp': 'btp',
+    '@fundamental-ngx/cx': 'cx',
+    '@fundamental-ngx/cdk': 'cdk'
+};
+/** Derive the example directory name from a selector.
+ *  "fd-date-picker" → "date-picker"
+ *  "fdp-table" → "table"
+ *  "button[fd-button], a[fd-button]" → "button"
+ *  "[fdOverflowLayout]" → "overflow-layout"
+ */
+function selectorToDir(selector) {
+    // Handle attribute selectors like "button[fd-button], a[fd-button]" or "[fdOverflowLayout]"
+    const attrMatch = selector.match(/\[(fd[pbk]?)-([^\]]+)\]/);
+    if (attrMatch) {
+        return attrMatch[2];
+    }
+    // Handle camelCase attribute selectors like "[fdOverflowLayout]"
+    const camelMatch = selector.match(/\[fd([A-Z][^\]]*)\]/);
+    if (camelMatch) {
+        // Convert camelCase to kebab-case: "OverflowLayout" → "overflow-layout"
+        return camelMatch[1]
+            .replace(/([A-Z])/g, '-$1')
+            .toLowerCase()
+            .replace(/^-/, '');
+    }
+    // Simple prefix selectors: "fd-button" → "button"
+    return selector
+        .split(',')[0]
+        .trim()
+        .replace(/^(fd[pbk]?|cx|ui5)-/, '');
+}
+/**
+ * Build the complete MCP metadata catalog.
+ *
+ * Orchestrates all extractors and writes the unified components.json.
+ * Can be run as a standalone script or via an NX executor.
+ */
+async function buildMetadata(basePath, outputPath) {
+    console.log('Starting metadata extraction...');
+    const startTime = Date.now();
+    // Run CEM and TypeDoc extraction in parallel
+    const [cemComponents, typeDocComponents] = await Promise.all([
+        (0, cem_extractor_1.extractAllUi5Components)(basePath).then((components) => {
+            console.log(`  CEM: extracted ${components.length} UI5 components`);
+            return components;
+        }),
+        (0, typedoc_extractor_1.extractAllTypeDocComponents)(basePath).then((components) => {
+            console.log(`  TypeDoc: extracted ${components.length} hand-written components`);
+            return components;
+        })
+    ]);
+    // Merge all components
+    const allComponents = [...cemComponents, ...typeDocComponents];
+    // Enrich with examples
+    const examples = await (0, example_extractor_1.extractExamples)(basePath);
+    console.log(`  Examples: found ${examples.size} components with examples`);
+    // Attach examples to matching components
+    let enrichedCount = 0;
+    for (const component of allComponents) {
+        const libDir = LIBRARY_TO_DIR[component.library];
+        if (!libDir) {
+            continue;
+        }
+        const compDir = selectorToDir(component.selector);
+        const key = `${libDir}/${compDir}`;
+        const compExamples = examples.get(key);
+        if (compExamples && compExamples.length > 0) {
+            component.examples = compExamples.map((ex) => ({
+                name: ex.name,
+                description: ex.description,
+                typescript: ex.typescript,
+                html: ex.html
+            }));
+            enrichedCount++;
+        }
+    }
+    console.log(`  Examples: enriched ${enrichedCount} components`);
+    // Enrich with docs descriptions (for components missing JSDoc)
+    const descriptions = await (0, description_extractor_1.extractDescriptions)(basePath);
+    console.log(`  Descriptions: found ${descriptions.size} docs descriptions`);
+    let descriptionEnrichedCount = 0;
+    for (const component of allComponents) {
+        // Skip components that already have a real description (from JSDoc)
+        if (component.description && !component.description.match(/^\w[\w ]+ (?:component|directive) \(/)) {
+            continue;
+        }
+        const libDir = LIBRARY_TO_DIR[component.library];
+        if (!libDir) {
+            continue;
+        }
+        const compDir = selectorToDir(component.selector);
+        const key = `${libDir}/${compDir}`;
+        const docsDesc = descriptions.get(key);
+        if (docsDesc) {
+            component.description = docsDesc;
+            descriptionEnrichedCount++;
+        }
+    }
+    console.log(`  Descriptions: enriched ${descriptionEnrichedCount} components`);
+    // Sort alphabetically by selector for consistent output
+    allComponents.sort((a, b) => a.selector.localeCompare(b.selector));
+    const catalog = {
+        generatedAt: new Date().toISOString(),
+        version: '0.62.0-rc.67',
+        components: allComponents
+    };
+    // Write output
+    await (0, promises_1.mkdir)((0, path_1.dirname)(outputPath), { recursive: true });
+    await (0, promises_1.writeFile)(outputPath, JSON.stringify(catalog, null, 2), 'utf-8');
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+    console.log(`\nMetadata extraction complete in ${elapsed}s`);
+    console.log(`  Total components: ${allComponents.length}`);
+    console.log(`  Output: ${outputPath}`);
+    return catalog;
+}
+/**
+ * CLI entry point for running extraction standalone.
+ * Usage: npx ts-node libs/mcp-server/src/extractors/build-metadata.ts [--dry-run]
+ */
+async function main() {
+    const basePath = (0, path_1.resolve)(__dirname, '../../../../');
+    const outputPath = (0, path_1.resolve)(__dirname, '../data/components.json');
+    const isDryRun = process.argv.includes('--dry-run');
+    try {
+        const catalog = await buildMetadata(basePath, isDryRun ? '/dev/null' : outputPath);
+        if (isDryRun) {
+            // In dry-run mode, compare with existing file
+            const { readFile } = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+            try {
+                const existing = await readFile(outputPath, 'utf-8');
+                const existingCatalog = JSON.parse(existing);
+                if (existingCatalog.components.length !== catalog.components.length) {
+                    console.error(`\nSTALE: Component count changed (${existingCatalog.components.length} → ${catalog.components.length})`);
+                    process.exit(1);
+                }
+                // Compare component names/selectors
+                const existingSelectors = new Set(existingCatalog.components.map((c) => c.selector));
+                const newSelectors = new Set(catalog.components.map((c) => c.selector));
+                const added = catalog.components.filter((c) => !existingSelectors.has(c.selector));
+                const removed = existingCatalog.components.filter((c) => !newSelectors.has(c.selector));
+                if (added.length > 0 || removed.length > 0) {
+                    if (added.length) {
+                        console.error(`  Added: ${added.map((c) => c.selector).join(', ')}`);
+                    }
+                    if (removed.length) {
+                        console.error(`  Removed: ${removed.map((c) => c.selector).join(', ')}`);
+                    }
+                    console.error('\nSTALE: Run `nx run mcp-server:extract-metadata` to update.');
+                    process.exit(1);
+                }
+                console.log('\ncomponents.json is up to date.');
+            }
+            catch {
+                console.error('\nSTALE: components.json does not exist. Run `nx run mcp-server:extract-metadata`.');
+                process.exit(1);
+            }
+        }
+    }
+    catch (error) {
+        console.error('Metadata extraction failed:', error);
+        process.exit(1);
+    }
+}
+// Run if executed directly
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=build-metadata.js.map

package/src/extractors/build-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-metadata.js","sourceRoot":"","sources":["../../../../../libs/mcp-server/src/extractors/build-metadata.ts"],"names":[],"mappings":"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"}

package/src/extractors/cem-extractor.d.ts

@@ -0,0 +1,17 @@
+import { ComponentMetadata, Library } from '../types/component-metadata';
+/**
+ * Extract component metadata from a single Custom Elements Manifest JSON file.
+ *
+ * @param cemFilePath Absolute path to a `custom-elements-internal.json` file.
+ * @param library The fundamental-ngx library this CEM belongs to.
+ * @returns Array of normalized `ComponentMetadata` entries.
+ */
+export declare function extractFromCem(cemFilePath: string, library: Library): Promise<ComponentMetadata[]>;
+/**
+ * Convenience function that extracts metadata from all three UI5 Web Components
+ * CEM files and returns a merged array.
+ *
+ * @param basePath Absolute path to the repository root (where `node_modules` lives).
+ * @returns Combined array of `ComponentMetadata` for all UI5 packages.
+ */
+export declare function extractAllUi5Components(basePath: string): Promise<ComponentMetadata[]>;

package/src/extractors/cem-extractor.js

@@ -0,0 +1,434 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFromCem = extractFromCem;
+exports.extractAllUi5Components = extractAllUi5Components;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const CEM_SOURCES = [
+    {
+        cemPath: '@ui5/webcomponents/dist/custom-elements-internal.json',
+        library: '@fundamental-ngx/ui5-webcomponents'
+    },
+    {
+        cemPath: '@ui5/webcomponents-fiori/dist/custom-elements-internal.json',
+        library: '@fundamental-ngx/ui5-webcomponents-fiori'
+    },
+    {
+        cemPath: '@ui5/webcomponents-ai/dist/custom-elements-internal.json',
+        library: '@fundamental-ngx/ui5-webcomponents-ai'
+    }
+];
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Extract component metadata from a single Custom Elements Manifest JSON file.
+ *
+ * @param cemFilePath Absolute path to a `custom-elements-internal.json` file.
+ * @param library The fundamental-ngx library this CEM belongs to.
+ * @returns Array of normalized `ComponentMetadata` entries.
+ */
+async function extractFromCem(cemFilePath, library) {
+    const raw = await (0, promises_1.readFile)(cemFilePath, 'utf-8');
+    const cem = JSON.parse(raw);
+    const enumMap = buildEnumMap(cem);
+    const components = [];
+    for (const mod of cem.modules) {
+        for (const decl of mod.declarations ?? []) {
+            if (!isPublicCustomElement(decl)) {
+                continue;
+            }
+            const component = mapDeclaration(decl, mod.path, library, enumMap);
+            components.push(component);
+        }
+    }
+    return components;
+}
+/**
+ * Convenience function that extracts metadata from all three UI5 Web Components
+ * CEM files and returns a merged array.
+ *
+ * @param basePath Absolute path to the repository root (where `node_modules` lives).
+ * @returns Combined array of `ComponentMetadata` for all UI5 packages.
+ */
+async function extractAllUi5Components(basePath) {
+    const results = [];
+    for (const source of CEM_SOURCES) {
+        const cemFilePath = (0, path_1.resolve)(basePath, 'node_modules', source.cemPath);
+        try {
+            const components = await extractFromCem(cemFilePath, source.library);
+            results.push(...components);
+        }
+        catch {
+            // CEM file may not exist (e.g. ai package not installed)
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Type guard: declaration is a public, non-abstract custom element. */
+function isPublicCustomElement(decl) {
+    if (decl.kind !== 'class') {
+        return false;
+    }
+    const cls = decl;
+    return (cls.customElement === true &&
+        !!cls.tagName &&
+        cls._ui5privacy !== 'private' &&
+        cls._ui5privacy !== 'protected' &&
+        cls._ui5abstract !== true);
+}
+/** Build a lookup from enum name to its member values. */
+function buildEnumMap(cem) {
+    const map = new Map();
+    for (const mod of cem.modules) {
+        for (const decl of mod.declarations ?? []) {
+            if (decl.kind === 'enum') {
+                const enumDecl = decl;
+                const values = (enumDecl.members ?? []).map((m) => m.name);
+                map.set(enumDecl.name, values);
+            }
+        }
+    }
+    return map;
+}
+/** Try to resolve enum values from a type reference. */
+function resolveEnumValues(type, enumMap) {
+    if (!type) {
+        return undefined;
+    }
+    // Check direct references first
+    if (type.references?.length) {
+        for (const ref of type.references) {
+            const refValues = enumMap.get(ref.name);
+            if (refValues?.length) {
+                return refValues;
+            }
+        }
+    }
+    // Fall back to matching the type text against known enum names
+    const typeName = type.text.replace(/\s*\|.*$/, '').trim();
+    const typeValues = enumMap.get(typeName);
+    if (typeValues?.length) {
+        return typeValues;
+    }
+    // Handle inline union types like '"Auto" | "Accent1" | "Accent2"'
+    if (type.text.includes('"') && type.text.includes('|')) {
+        const matches = type.text.match(/"([^"]+)"/g);
+        if (matches?.length) {
+            return matches.map((m) => m.replace(/"/g, ''));
+        }
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Declaration → ComponentMetadata mapping
+// ---------------------------------------------------------------------------
+function mapDeclaration(decl, modulePath, library, enumMap) {
+    const rawDescription = decl.description ?? '';
+    return {
+        name: decl.name,
+        selector: decl.tagName,
+        library,
+        category: inferCategory(modulePath, library),
+        description: cleanCemDescription(rawDescription),
+        since: decl._ui5since,
+        deprecated: normalizeDeprecated(decl.deprecated),
+        inputs: mapInputs(decl.members, enumMap),
+        outputs: mapOutputs(decl.events),
+        slots: mapSlots(decl.slots),
+        methods: mapMethods(decl.members),
+        cssProperties: mapCssProperties(decl.cssProperties),
+        keyboardHandling: extractSection(rawDescription, 'Keyboard Handling'),
+        sourceFile: modulePath,
+        source: 'cem'
+    };
+}
+// ---------------------------------------------------------------------------
+// Input mapping
+// ---------------------------------------------------------------------------
+function mapInputs(members, enumMap) {
+    if (!members) {
+        return [];
+    }
+    return members
+        .filter((m) => m.kind === 'field' && m.privacy === 'public' && !m.readonly)
+        .map((m) => ({
+        name: m.name,
+        type: m.type?.text ?? 'unknown',
+        defaultValue: m.default,
+        description: m.description ?? '',
+        required: m.default === undefined && !isOptionalType(m.type?.text),
+        enumValues: resolveEnumValues(m.type, enumMap),
+        since: m._ui5since,
+        deprecated: normalizeDeprecated(m.deprecated)
+    }));
+}
+/** Returns true if the type string indicates the value is optional. */
+function isOptionalType(typeText) {
+    if (!typeText) {
+        return false;
+    }
+    return typeText.includes('undefined') || typeText.includes('null') || typeText.endsWith('?');
+}
+// ---------------------------------------------------------------------------
+// Output mapping
+// ---------------------------------------------------------------------------
+function mapOutputs(events) {
+    if (!events) {
+        return [];
+    }
+    return events
+        .filter((e) => e._ui5privacy !== 'private' && e._ui5privacy !== 'protected')
+        .map((e) => ({
+        name: toUi5OutputName(e.name),
+        type: e.type?.text ?? 'CustomEvent',
+        description: e.description ?? '',
+        detail: mapEventDetail(e._ui5parameters),
+        since: e._ui5since,
+        deprecated: normalizeDeprecated(e.deprecated)
+    }));
+}
+/**
+ * Convert a DOM event name to the Angular output name used by the UI5 wrappers.
+ * Prefix with "ui5" and PascalCase the rest.
+ *
+ * Examples:
+ * - "click"            → "ui5Click"
+ * - "selection-change" → "ui5SelectionChange"
+ * - "close"            → "ui5Close"
+ */
+function toUi5OutputName(eventName) {
+    const pascal = eventName
+        .split('-')
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+    return `ui5${pascal}`;
+}
+function mapEventDetail(params) {
+    if (!params?.length) {
+        return undefined;
+    }
+    return params
+        .filter((p) => p._ui5privacy !== 'private' && p._ui5privacy !== 'protected')
+        .map((p) => ({
+        name: p.name,
+        type: p.type?.text ?? 'unknown',
+        description: p.description ?? ''
+    }));
+}
+// ---------------------------------------------------------------------------
+// Slot mapping
+// ---------------------------------------------------------------------------
+function mapSlots(slots) {
+    if (!slots) {
+        return [];
+    }
+    return slots
+        .filter((s) => s._ui5privacy !== 'private' && s._ui5privacy !== 'protected')
+        .map((s) => ({
+        name: s.name,
+        description: s.description ?? '',
+        acceptedTypes: extractAcceptedTypes(s._ui5type),
+        since: s._ui5since,
+        deprecated: normalizeDeprecated(s.deprecated)
+    }));
+}
+/** Extract accepted type names from a slot's _ui5type field. */
+function extractAcceptedTypes(type) {
+    if (!type) {
+        return undefined;
+    }
+    // References give the most accurate type names
+    if (type.references?.length) {
+        return type.references.map((ref) => ref.name);
+    }
+    // Fall back to parsing the text, e.g. "Array<HTMLElement>" → ["HTMLElement"]
+    const genericMatch = type.text.match(/Array<(.+)>/);
+    if (genericMatch) {
+        return genericMatch[1].split('|').map((t) => t.trim());
+    }
+    return [type.text];
+}
+// ---------------------------------------------------------------------------
+// Method mapping
+// ---------------------------------------------------------------------------
+function mapMethods(members) {
+    if (!members) {
+        return [];
+    }
+    return members
+        .filter((m) => m.kind === 'method' && m.privacy === 'public')
+        .map((m) => ({
+        name: m.name,
+        returnType: m.return?.type?.text ?? 'void',
+        description: m.description ?? '',
+        params: mapMethodParams(m.parameters),
+        deprecated: normalizeDeprecated(m.deprecated)
+    }));
+}
+function mapMethodParams(params) {
+    if (!params) {
+        return [];
+    }
+    return params.map((p) => ({
+        name: p.name,
+        type: p.type?.text ?? 'unknown',
+        description: p.description ?? '',
+        optional: p.name.endsWith('?') || (p.type?.text?.includes('undefined') ?? false)
+    }));
+}
+// ---------------------------------------------------------------------------
+// CSS property mapping
+// ---------------------------------------------------------------------------
+function mapCssProperties(props) {
+    if (!props) {
+        return [];
+    }
+    return props.map((p) => ({
+        name: p.name,
+        description: p.description ?? '',
+        defaultValue: p.default
+    }));
+}
+// ---------------------------------------------------------------------------
+// Description cleaning
+// ---------------------------------------------------------------------------
+/** Normalize a CEM `deprecated` field (string message or boolean) to a string or undefined. */
+function normalizeDeprecated(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (value === true) {
+        return 'Deprecated';
+    }
+    return undefined;
+}
+/**
+ * Extract the content of a named `### Section` from a CEM markdown description.
+ * Returns `undefined` if the section is not found.
+ *
+ * @param sectionName Plain text section name (must not contain regex special characters).
+ */
+function extractSection(markdown, sectionName) {
+    const escaped = sectionName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = new RegExp(`###\\s+${escaped}\\s*\\n([\\s\\S]*?)(?=\\n###\\s|$)`);
+    const match = markdown.match(pattern);
+    if (!match) {
+        return undefined;
+    }
+    return match[1].trim() || undefined;
+}
+/**
+ * Clean a CEM markdown description into plain-text suitable for MCP output.
+ *
+ * 1. Extract the "### Overview" section content (if present)
+ * 2. Otherwise use everything before the first `###` header
+ * 3. Strip known boilerplate sections (ES6 Module Import, Keyboard Handling)
+ * 4. Remove markdown formatting
+ */
+function cleanCemDescription(raw) {
+    if (!raw) {
+        return '';
+    }
+    // Try to extract Overview section
+    let text = extractSection(raw, 'Overview');
+    if (!text) {
+        // No ### Overview — use text before the first ### header
+        const firstHeader = raw.indexOf('###');
+        text = firstHeader > 0 ? raw.slice(0, firstHeader).trim() : raw;
+    }
+    // Remove remaining ### sections that may have leaked through
+    text = text.replace(/###\s+[\s\S]*$/m, '').trim();
+    // Strip markdown formatting
+    text = text
+        .replace(/`([^`]+)`/g, '$1') // inline code
+        .replace(/\*\*([^*]+)\*\*/g, '$1') // bold
+        .replace(/\*([^*]+)\*/g, '$1') // italic
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') // links
+        .replace(/\n{2,}/g, '\n') // collapse blank lines
+        .trim();
+    return text;
+}
+// ---------------------------------------------------------------------------
+// Category inference
+// ---------------------------------------------------------------------------
+/** Infer a human-readable category from the module path and library. */
+function inferCategory(modulePath, library) {
+    switch (library) {
+        case '@fundamental-ngx/ui5-webcomponents-fiori':
+            return 'Fiori';
+        case '@fundamental-ngx/ui5-webcomponents-ai':
+            return 'AI';
+        default:
+            break;
+    }
+    // For the base @ui5/webcomponents package, try to derive category from path
+    // Module paths look like "dist/Button.js", "dist/CalendarDate.js"
+    const fileName = modulePath.replace(/^dist\//, '').replace(/\.js$/, '');
+    // Group by common prefixes
+    const categoryPrefixes = {
+        Avatar: 'User & Identity',
+        Badge: 'Indicators',
+        Bar: 'Layout',
+        Breadcrumbs: 'Navigation',
+        BusyIndicator: 'Indicators',
+        Button: 'Actions',
+        Calendar: 'Date & Time',
+        Card: 'Data Display',
+        Carousel: 'Data Display',
+        CheckBox: 'Form',
+        ColorPalette: 'Form',
+        ColorPicker: 'Form',
+        ComboBox: 'Form',
+        DatePicker: 'Date & Time',
+        DateRangePicker: 'Date & Time',
+        DateTimePicker: 'Date & Time',
+        Dialog: 'Popover & Dialog',
+        DragDrop: 'Utilities',
+        FileUploader: 'Form',
+        Form: 'Form',
+        Icon: 'Data Display',
+        Input: 'Form',
+        Label: 'Form',
+        Link: 'Navigation',
+        List: 'Data Display',
+        Menu: 'Navigation',
+        MessageStrip: 'Feedback',
+        MultiComboBox: 'Form',
+        MultiInput: 'Form',
+        Panel: 'Layout',
+        Popover: 'Popover & Dialog',
+        Progress: 'Indicators',
+        Radio: 'Form',
+        RangeSlider: 'Form',
+        RatingIndicator: 'Form',
+        ResponsivePopover: 'Popover & Dialog',
+        SegmentedButton: 'Actions',
+        Select: 'Form',
+        Slider: 'Form',
+        SplitButton: 'Actions',
+        StepInput: 'Form',
+        Switch: 'Form',
+        Tab: 'Navigation',
+        Table: 'Data Display',
+        TextArea: 'Form',
+        TimePicker: 'Date & Time',
+        Title: 'Data Display',
+        Toast: 'Feedback',
+        ToggleButton: 'Actions',
+        Token: 'Data Display',
+        Toolbar: 'Actions',
+        Tree: 'Data Display',
+        Tag: 'Data Display'
+    };
+    for (const [prefix, category] of Object.entries(categoryPrefixes)) {
+        if (fileName.startsWith(prefix)) {
+            return category;
+        }
+    }
+    return 'UI5 Component';
+}
+//# sourceMappingURL=cem-extractor.js.map