@laststance/claude-plugin-dashboard 0.2.3 → 0.3.2

package/dist/components/PluginDetail.js

@@ -1,27 +1,77 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
  * PluginDetail component
  * Right panel showing detailed plugin information
+ *
+ * Uses fixed height to prevent layout jumping when switching between plugins
+ * with different amounts of content (e.g., varying component counts).
+ *
+ * Supports component focus mode for navigating and viewing component details
  */
 import { Box, Text } from 'ink';
 import StatusIcon from './StatusIcon.js';
 import ComponentBadges from './ComponentBadges.js';
+import ComponentList, { hasAnyCountComponents, hasAnyDetailedComponents, } from './ComponentList.js';
+import ComponentDetail from './ComponentDetail.js';
+/**
+ * Fixed height for PluginDetail panel (in terminal lines)
+ * Matches PluginList's visibleCount * 2 + 2 = 26 lines
+ * This ensures both panels have consistent height regardless of content
+ */
+const DETAIL_PANEL_HEIGHT = 26;
+/**
+ * Layout height constants for consistent rendering
+ * Total budget: 26 lines (DETAIL_PANEL_HEIGHT)
+ *
+ * Normal mode:
+ *   Border/Padding: 4 | Header: 2 | Description: 2 | Metadata: 7
+ *   Separator: 1 | ComponentList: 4 | Status: 3 | Actions: 3
+ *
+ * Focused mode (hide Status/Actions to maximize component browsing):
+ *   Border/Padding: 4 | Header: 2 | Description: 2 | Metadata: 7
+ *   Separator: 1 | ComponentList: 7 | ComponentDetail: 3
+ */
+const COMPONENT_LIST_HEIGHT_NORMAL = 4;
+const COMPONENT_LIST_HEIGHT_FOCUSED = 7;
+const COMPONENT_DETAIL_HEIGHT = 3;
+const COMPONENT_LIST_VISIBLE_COUNT = 5;
 /**
  * Displays detailed information about a selected plugin
+ * Supports component focus mode for drilling into component details
  * @example
- * <PluginDetail plugin={selectedPlugin} />
+ * <PluginDetail
+ *   plugin={selectedPlugin}
+ *   componentFocusMode={true}
+ *   selectedComponentIndex={0}
+ * />
  */
-export default function PluginDetail({ plugin }) {
+export default function PluginDetail({ plugin, componentFocusMode = false, selectedComponentIndex = 0, selectedComponentDetail = null, }) {
     if (!plugin) {
-        return (_jsx(Box, { flexDirection: "column", padding: 1, borderStyle: "round", borderColor: "gray", children: _jsx(Text, { dimColor: true, children: "Select a plugin to view details" }) }));
+        return (_jsx(Box, { flexDirection: "column", padding: 1, borderStyle: "round", borderColor: "gray", height: DETAIL_PANEL_HEIGHT, children: _jsx(Text, { dimColor: true, children: "Select a plugin to view details" }) }));
     }
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, borderStyle: "round", borderColor: "cyan", children: [_jsxs(Box, { marginBottom: 1, gap: 1, children: [_jsx(StatusIcon, { isInstalled: plugin.isInstalled, isEnabled: plugin.isEnabled }), _jsx(Text, { bold: true, color: "cyan", children: plugin.name })] }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { wrap: "wrap", children: plugin.description || 'No description available' }) }), _jsxs(Box, { flexDirection: "column", gap: 0, children: [_jsx(DetailRow, { label: "Marketplace", value: plugin.marketplace }), _jsx(DetailRow, { label: "Version", value: plugin.version }), _jsx(DetailRow, { label: "Installs", value: formatCount(plugin.installCount) }), plugin.category && (_jsx(DetailRow, { label: "Category", value: plugin.category })), plugin.author && (_jsx(DetailRow, { label: "Author", value: plugin.author.name })), plugin.homepage && (_jsx(DetailRow, { label: "Homepage", value: plugin.homepage })), plugin.components && (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "gray", children: "Components:" }), _jsx(ComponentBadges, { components: plugin.components })] }))] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { children: "Status:" }), plugin.isInstalled ? (plugin.isEnabled ? (_jsx(Text, { color: "green", bold: true, children: "Installed & Enabled" })) : (_jsx(Text, { color: "yellow", bold: true, children: "Installed & Disabled" }))) : (_jsx(Text, { color: "gray", children: "Not Installed" }))] }), plugin.installedAt && (_jsxs(Text, { dimColor: true, children: ["Installed: ", formatDate(plugin.installedAt)] }))] }), _jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "column", children: plugin.isInstalled ? (_jsx(Box, { flexDirection: "column", children: _jsxs(Text, { dimColor: true, children: [_jsx(Text, { bold: true, color: "white", children: "Space" }), ' ', plugin.isEnabled ? 'disable' : 'enable', " |", ' ', _jsx(Text, { bold: true, color: "white", children: "u" }), ' ', "uninstall"] }) })) : (_jsxs(Text, { dimColor: true, children: [_jsx(Text, { bold: true, color: "white", children: "i" }), ' ', "install"] })) })] }));
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, borderStyle: "round", borderColor: "cyan", height: DETAIL_PANEL_HEIGHT, overflow: "hidden", children: [_jsxs(Box, { marginBottom: 1, gap: 1, children: [_jsx(StatusIcon, { isInstalled: plugin.isInstalled, isEnabled: plugin.isEnabled }), _jsx(Text, { bold: true, color: "cyan", children: plugin.name })] }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { wrap: "wrap", children: plugin.description || 'No description available' }) }), _jsxs(Box, { flexDirection: "column", gap: 0, children: [_jsx(DetailRow, { label: "Marketplace", value: plugin.marketplace }), _jsx(DetailRow, { label: "Version", value: plugin.version || '-' }), _jsx(DetailRow, { label: "Installs", value: formatCount(plugin.installCount) }), _jsx(DetailRow, { label: "Category", value: plugin.category || '-' }), _jsx(DetailRow, { label: "Author", value: plugin.author?.name || '-' }), _jsx(DetailRow, { label: "Homepage", value: plugin.homepage || '-' }), _jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "gray", children: 'Components:'.padEnd(12) }), plugin.components ? (_jsx(ComponentBadges, { components: plugin.components })) : (_jsx(Text, { color: "gray", children: "-" }))] })] }), ((plugin.components && hasAnyCountComponents(plugin.components)) ||
+                (plugin.componentsDetailed &&
+                    hasAnyDetailedComponents(plugin.componentsDetailed))) && (_jsxs(_Fragment, { children: [_jsx(Box, { marginY: 1, height: 1, children: _jsx(Text, { dimColor: true, children: '─'.repeat(36) }) }), _jsx(Box, { height: componentFocusMode
+                            ? COMPONENT_LIST_HEIGHT_FOCUSED
+                            : COMPONENT_LIST_HEIGHT_NORMAL, overflow: "hidden", children: _jsx(ComponentList, { components: plugin.components, componentsDetailed: plugin.componentsDetailed, maxItems: 3, isFocused: componentFocusMode, selectedIndex: selectedComponentIndex, visibleCount: COMPONENT_LIST_VISIBLE_COUNT }) })] })), componentFocusMode && selectedComponentDetail && (_jsx(Box, { height: COMPONENT_DETAIL_HEIGHT, overflow: "hidden", children: _jsx(ComponentDetail, { component: selectedComponentDetail, maxHeight: COMPONENT_DETAIL_HEIGHT }) })), !componentFocusMode && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { children: "Status:" }), plugin.isInstalled ? (plugin.isEnabled ? (_jsx(Text, { color: "green", bold: true, wrap: "truncate", children: "Enabled" })) : (_jsx(Text, { color: "yellow", bold: true, wrap: "truncate", children: "Disabled" }))) : (_jsx(Text, { color: "gray", wrap: "truncate", children: "Not Installed" }))] }), plugin.installedAt && (_jsxs(Text, { dimColor: true, wrap: "truncate", children: ["Installed: ", formatDate(plugin.installedAt)] }))] })), !componentFocusMode && (_jsx(Box, { marginTop: 1, borderStyle: "single", borderColor: "gray", paddingX: 1, flexDirection: "column", children: plugin.isInstalled ? (_jsx(Box, { flexDirection: "column", children: _jsxs(Text, { dimColor: true, children: [_jsx(Text, { bold: true, color: "white", children: "Space" }), ' ', plugin.isEnabled ? 'disable' : 'enable', " |", ' ', _jsx(Text, { bold: true, color: "white", children: "u" }), ' ', "uninstall |", ' ', _jsx(Text, { bold: true, color: "white", children: "\u2192" }), ' ', "components"] }) })) : (_jsxs(Text, { dimColor: true, children: [_jsx(Text, { bold: true, color: "white", children: "i" }), ' ', "install |", ' ', _jsx(Text, { bold: true, color: "white", children: "\u2192" }), ' ', "components"] })) }))] }));
 }
 /**
  * Single detail row with label and value
+ * Pads both label and value to fixed widths to prevent ghost text artifacts
+ * when content changes between selections
+ * @param label - Label text (e.g., "Marketplace", "Version")
+ * @param value - Value to display
+ * @returns Detail row with fixed-width padding to overwrite previous content
  */
 function DetailRow({ label, value }) {
-    return (_jsxs(Box, { gap: 1, children: [_jsxs(Text, { color: "gray", children: [label, ":"] }), _jsx(Text, { children: value })] }));
+    // Fixed widths to ensure consistent line length and prevent ghost text
+    const LABEL_WIDTH = 12;
+    const VALUE_WIDTH = 40;
+    const paddedLabel = `${label}:`.padEnd(LABEL_WIDTH);
+    // Truncate long values, pad short values with spaces to overwrite old content
+    const truncatedValue = value.length > VALUE_WIDTH ? value.slice(0, VALUE_WIDTH - 1) + '…' : value;
+    const paddedValue = truncatedValue.padEnd(VALUE_WIDTH);
+    return (_jsxs(Text, { children: [_jsx(Text, { color: "gray", children: paddedLabel }), _jsx(Text, { children: paddedValue })] }));
 }
 /**
  * Format large numbers with K/M suffix

package/dist/components/PluginList.js

@@ -26,15 +26,27 @@ export default function PluginList({ plugins, selectedIndex, visibleCount = 15,
     const visiblePlugins = plugins.slice(startIndex, endIndex);
     const hasMore = endIndex < plugins.length;
     const hasPrevious = startIndex > 0;
-    return (_jsxs(Box, { flexDirection: "column", children: [hasPrevious && _jsxs(Text, { dimColor: true, children: ["\u2191 ", startIndex, " more above"] }), visiblePlugins.map((plugin, index) => {
+    // Calculate fixed height: each item is 2 lines + 1 line for top indicator + 1 line for bottom indicator
+    // Total fixed lines: visibleCount * 2 (items) + 2 (indicators)
+    const totalLines = visibleCount * 2 + 2;
+    // Lines used by items
+    const itemLines = visiblePlugins.length * 2;
+    // Lines used by indicators (always rendered, but may be empty)
+    const topIndicatorLine = 1;
+    const bottomIndicatorLine = 1;
+    // Calculate padding lines needed to maintain fixed height
+    const usedLines = itemLines + topIndicatorLine + bottomIndicatorLine;
+    const paddingLines = Math.max(0, totalLines - usedLines);
+    return (_jsxs(Box, { flexDirection: "column", height: totalLines, children: [_jsx(Text, { dimColor: true, children: hasPrevious ? `↑ ${startIndex} more above` : ' ' }), visiblePlugins.map((plugin, index) => {
                 const actualIndex = startIndex + index;
                 const isSelected = actualIndex === selectedIndex;
-                return (_jsxs(Box, { paddingX: 1, children: [_jsx(Box, { width: 2, children: isSelected && isFocused ? (_jsx(Text, { color: "cyan", children: '>' })) : isSelected ? (_jsx(Text, { color: "gray", children: '›' })) : (_jsx(Text, { children: " " })) }), _jsx(Box, { width: 2, children: _jsx(StatusIcon, { isInstalled: plugin.isInstalled, isEnabled: plugin.isEnabled }) }), _jsxs(Box, { flexGrow: 1, flexDirection: "column", children: [_jsxs(Box, { gap: 1, children: [_jsx(Text, { bold: true, color: isSelected && isFocused
-                                                ? 'cyan'
-                                                : isSelected
-                                                    ? 'gray'
-                                                    : 'white', children: plugin.name }), _jsx(Text, { dimColor: true, children: "\u00B7" }), _jsx(Text, { color: "gray", children: truncate(plugin.marketplace, 20) }), plugin.installCount > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: "\u00B7" }), _jsxs(Text, { color: "gray", children: [formatCount(plugin.installCount), " installs"] })] }))] }), _jsx(Text, { dimColor: true, wrap: "truncate", children: truncate(plugin.description, 60) })] })] }, plugin.id));
-            }), hasMore && (_jsxs(Text, { dimColor: true, children: ["\u2193 ", plugins.length - endIndex, " more below"] }))] }));
+                return (_jsxs(Box, { paddingX: 1, height: 2, children: [_jsx(Box, { width: 2, children: isSelected && isFocused ? (_jsx(Text, { color: "cyan", children: '>' })) : isSelected ? (_jsx(Text, { color: "gray", children: '›' })) : (_jsx(Text, { children: " " })) }), _jsx(Box, { width: 2, children: _jsx(StatusIcon, { isInstalled: plugin.isInstalled, isEnabled: plugin.isEnabled }) }), _jsxs(Box, { flexDirection: "column", overflow: "hidden", children: [_jsx(Box, { height: 1, children: _jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { bold: true, color: isSelected && isFocused
+                                                    ? 'cyan'
+                                                    : isSelected
+                                                        ? 'gray'
+                                                        : 'white', children: plugin.name }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), _jsx(Text, { color: "gray", children: truncate(plugin.marketplace, 20) }), plugin.installCount > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: " \u00B7 " }), _jsxs(Text, { color: "gray", children: [formatCount(plugin.installCount), " installs"] })] }))] }) }), _jsx(Box, { height: 1, children: _jsx(Text, { dimColor: true, wrap: "truncate", children: truncate(plugin.description, 60) }) })] })] }, plugin.id));
+            }), paddingLines > 0 &&
+                Array.from({ length: paddingLines }).map((_, i) => (_jsx(Text, { children: " " }, `pad-${i}`))), _jsx(Text, { dimColor: true, children: hasMore ? `↓ ${plugins.length - endIndex} more below` : ' ' })] }));
 }
 /**
  * Truncate text to max length with ellipsis

package/dist/services/componentService.d.ts

@@ -2,34 +2,13 @@
  * Component service for detecting plugin component types
  * Parses plugin.json and scans plugin directory structure to identify
  * skills, commands, agents, hooks, MCP servers, and LSP servers
- */
-import type { PluginComponents } from '../types/index.js';
-/**
- * Detect all component types for a plugin at the given install path
- * @param installPath - Absolute path to the installed plugin directory
- * @returns PluginComponents object with detected component counts
- * - Returns undefined values for components that are not present
- * - Returns counts > 0 for components that exist
- * @example
- * const components = detectPluginComponents('/path/to/plugin')
- * // => { skills: 5, commands: 2, mcpServers: 1 }
- */
-export declare function detectPluginComponents(installPath: string): PluginComponents | undefined;
-/**
- * Check if a plugin has any components
- * @param components - PluginComponents object
- * @returns true if at least one component type is present
- * @example
- * hasAnyComponents({ skills: 2 }) // => true
- * hasAnyComponents({}) // => false
- * hasAnyComponents(undefined) // => false
- */
-export declare function hasAnyComponents(components: PluginComponents | undefined): boolean;
-/**
- * Get total component count for a plugin
- * @param components - PluginComponents object
- * @returns Total number of components (hooks count as 1)
- * @example
- * getTotalComponentCount({ skills: 3, commands: 2, hooks: true }) // => 6
- */
-export declare function getTotalComponentCount(components: PluginComponents | undefined): number;
+ *
+ * This is a facade module that re-exports from the components/ submodules.
+ * For implementation details, see:
+ * - components/skillService.ts - Skill detection and SKILL.md parsing
+ * - components/markdownService.ts - Command/Agent markdown parsing
+ * - components/hookService.ts - Hook detection
+ * - components/serverService.ts - MCP/LSP server detection
+ * - components/utils.ts - Utility functions
+ */
+export { detectPluginComponents, detectComponentsDetailed, parseSkillMdFull, getSkillDetailedInfo, getMarkdownComponentDetailedInfo, hasAnyComponents, getTotalComponentCount, } from './components/index.js';

package/dist/services/componentService.js

@@ -2,177 +2,22 @@
  * Component service for detecting plugin component types
  * Parses plugin.json and scans plugin directory structure to identify
  * skills, commands, agents, hooks, MCP servers, and LSP servers
- */
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { readJsonFile, directoryExists, fileExists } from './fileService.js';
-/**
- * Detect all component types for a plugin at the given install path
- * @param installPath - Absolute path to the installed plugin directory
- * @returns PluginComponents object with detected component counts
- * - Returns undefined values for components that are not present
- * - Returns counts > 0 for components that exist
- * @example
- * const components = detectPluginComponents('/path/to/plugin')
- * // => { skills: 5, commands: 2, mcpServers: 1 }
- */
-export function detectPluginComponents(installPath) {
-    if (!directoryExists(installPath)) {
-        return undefined;
-    }
-    const components = {};
-    // Detect skills (count directories in skills/ folder)
-    const skillsCount = countSkills(installPath);
-    if (skillsCount > 0) {
-        components.skills = skillsCount;
-    }
-    // Detect commands (legacy location, now unified with skills in Claude Code v2.1.3+)
-    const commandsCount = countMarkdownFiles(installPath, 'commands');
-    if (commandsCount > 0) {
-        components.commands = commandsCount;
-    }
-    // Detect agents (count .md files in agents/ folder)
-    const agentsCount = countMarkdownFiles(installPath, 'agents');
-    if (agentsCount > 0) {
-        components.agents = agentsCount;
-    }
-    // Detect hooks
-    const hasHooks = detectHooks(installPath);
-    if (hasHooks) {
-        components.hooks = true;
-    }
-    // Detect MCP servers from plugin.json
-    const mcpCount = countMcpServers(installPath);
-    if (mcpCount > 0) {
-        components.mcpServers = mcpCount;
-    }
-    // Detect LSP servers from .lsp.json
-    const lspCount = countLspServers(installPath);
-    if (lspCount > 0) {
-        components.lspServers = lspCount;
-    }
-    // Return undefined if no components detected
-    if (Object.keys(components).length === 0) {
-        return undefined;
-    }
-    return components;
-}
-/**
- * Count skill directories in the skills/ folder
- * Skills are stored as subdirectories with SKILL.md files
- * @param installPath - Plugin install path
- * @returns Number of skill directories
- */
-function countSkills(installPath) {
-    const skillsPath = path.join(installPath, 'skills');
-    if (!directoryExists(skillsPath)) {
-        return 0;
-    }
-    try {
-        const entries = fs.readdirSync(skillsPath, { withFileTypes: true });
-        return entries.filter((entry) => entry.isDirectory()).length;
-    }
-    catch {
-        return 0;
-    }
-}
-/**
- * Count .md files in a specific directory
- * @param installPath - Plugin install path
- * @param subdir - Subdirectory name ('commands' or 'agents')
- * @returns Number of .md files
- */
-function countMarkdownFiles(installPath, subdir) {
-    const dirPath = path.join(installPath, subdir);
-    if (!directoryExists(dirPath)) {
-        return 0;
-    }
-    try {
-        const files = fs.readdirSync(dirPath);
-        return files.filter((file) => file.endsWith('.md')).length;
-    }
-    catch {
-        return 0;
-    }
-}
-/**
- * Detect if plugin has hooks configured
- * Checks for hooks/ directory or hooks.json file
- * @param installPath - Plugin install path
- * @returns true if hooks are configured
- */
-function detectHooks(installPath) {
-    const hooksDir = path.join(installPath, 'hooks');
-    const hooksJson = path.join(installPath, 'hooks.json');
-    return directoryExists(hooksDir) || fileExists(hooksJson);
-}
-/**
- * Count MCP servers defined in plugin.json
- * @param installPath - Plugin install path
- * @returns Number of MCP server configurations
- */
-function countMcpServers(installPath) {
-    // Check both .claude-plugin/plugin.json and plugin.json at root
-    const pluginJsonPaths = [
-        path.join(installPath, '.claude-plugin', 'plugin.json'),
-        path.join(installPath, 'plugin.json'),
-    ];
-    for (const pluginJsonPath of pluginJsonPaths) {
-        const pluginJson = readJsonFile(pluginJsonPath);
-        if (pluginJson?.mcpServers) {
-            return Object.keys(pluginJson.mcpServers).length;
-        }
-    }
-    return 0;
-}
-/**
- * Count LSP servers defined in .lsp.json
- * @param installPath - Plugin install path
- * @returns Number of LSP server configurations
- */
-function countLspServers(installPath) {
-    const lspJsonPath = path.join(installPath, '.lsp.json');
-    const lspConfig = readJsonFile(lspJsonPath);
-    if (!lspConfig) {
-        return 0;
-    }
-    return Object.keys(lspConfig).length;
-}
-/**
- * Check if a plugin has any components
- * @param components - PluginComponents object
- * @returns true if at least one component type is present
- * @example
- * hasAnyComponents({ skills: 2 }) // => true
- * hasAnyComponents({}) // => false
- * hasAnyComponents(undefined) // => false
- */
-export function hasAnyComponents(components) {
-    if (!components) {
-        return false;
-    }
-    return ((components.skills ?? 0) > 0 ||
-        (components.commands ?? 0) > 0 ||
-        (components.agents ?? 0) > 0 ||
-        components.hooks === true ||
-        (components.mcpServers ?? 0) > 0 ||
-        (components.lspServers ?? 0) > 0);
-}
-/**
- * Get total component count for a plugin
- * @param components - PluginComponents object
- * @returns Total number of components (hooks count as 1)
- * @example
- * getTotalComponentCount({ skills: 3, commands: 2, hooks: true }) // => 6
- */
-export function getTotalComponentCount(components) {
-    if (!components) {
-        return 0;
-    }
-    return ((components.skills ?? 0) +
-        (components.commands ?? 0) +
-        (components.agents ?? 0) +
-        (components.hooks ? 1 : 0) +
-        (components.mcpServers ?? 0) +
-        (components.lspServers ?? 0));
-}
+ *
+ * This is a facade module that re-exports from the components/ submodules.
+ * For implementation details, see:
+ * - components/skillService.ts - Skill detection and SKILL.md parsing
+ * - components/markdownService.ts - Command/Agent markdown parsing
+ * - components/hookService.ts - Hook detection
+ * - components/serverService.ts - MCP/LSP server detection
+ * - components/utils.ts - Utility functions
+ */
+// Re-export everything from the components module for backward compatibility
+export { 
+// Main detection functions
+detectPluginComponents, detectComponentsDetailed, 
+// Skill functions
+parseSkillMdFull, getSkillDetailedInfo, 
+// Markdown functions
+getMarkdownComponentDetailedInfo, 
+// Utility functions
+hasAnyComponents, getTotalComponentCount, } from './components/index.js';

package/dist/services/components/hookService.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Hook component detection service
+ * Handles hooks/ directory and hooks.json scanning
+ */
+/**
+ * Detect if plugin has hooks configured
+ * Checks for hooks/ directory or hooks.json file
+ * @param installPath - Plugin install path
+ * @returns true if hooks are configured
+ */
+export declare function detectHooks(installPath: string): boolean;
+/**
+ * Get hook event names from hooks configuration
+ * @param installPath - Plugin install path
+ * @returns Array of hook event names
+ */
+export declare function getHookNames(installPath: string): string[];

package/dist/services/components/hookService.js

@@ -0,0 +1,45 @@
+/**
+ * Hook component detection service
+ * Handles hooks/ directory and hooks.json scanning
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { readJsonFile, directoryExists, fileExists } from '../fileService.js';
+/**
+ * Detect if plugin has hooks configured
+ * Checks for hooks/ directory or hooks.json file
+ * @param installPath - Plugin install path
+ * @returns true if hooks are configured
+ */
+export function detectHooks(installPath) {
+    const hooksDir = path.join(installPath, 'hooks');
+    const hooksJson = path.join(installPath, 'hooks.json');
+    return directoryExists(hooksDir) || fileExists(hooksJson);
+}
+/**
+ * Get hook event names from hooks configuration
+ * @param installPath - Plugin install path
+ * @returns Array of hook event names
+ */
+export function getHookNames(installPath) {
+    // Try hooks.json first
+    const hooksJsonPath = path.join(installPath, 'hooks.json');
+    const hooksJson = readJsonFile(hooksJsonPath);
+    if (hooksJson) {
+        return Object.keys(hooksJson);
+    }
+    // Try hooks/ directory
+    const hooksDir = path.join(installPath, 'hooks');
+    if (directoryExists(hooksDir)) {
+        try {
+            const files = fs.readdirSync(hooksDir);
+            return files
+                .filter((f) => f.endsWith('.json') || f.endsWith('.js'))
+                .map((f) => f.replace(/\.(json|js)$/, ''));
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}

package/dist/services/components/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Component service module index
+ * Re-exports all component detection and parsing functions
+ *
+ * This module provides a facade for detecting plugin components:
+ * - Skills (skills/ directory with SKILL.md files)
+ * - Commands (commands/ directory with .md files)
+ * - Agents (agents/ directory with .md files)
+ * - Hooks (hooks/ directory or hooks.json)
+ * - MCP Servers (plugin.json mcpServers)
+ * - LSP Servers (.lsp.json)
+ */
+export { hasAnyComponents, getTotalComponentCount } from './utils.js';
+export { countSkills, getSkillDetails, parseSkillMdFull, getSkillDetailedInfo, } from './skillService.js';
+export { countMarkdownFiles, getMarkdownFileDetails, getMarkdownComponentDetailedInfo, parseFirstLineDescriptionFromContent, } from './markdownService.js';
+export { detectHooks, getHookNames } from './hookService.js';
+export { countMcpServers, getMcpServerNames, countLspServers, getLspServerNames, } from './serverService.js';
+export type { ComponentInfo, ComponentDetailedInfo } from '../../types/index.js';
+import type { PluginComponents, PluginComponentsDetailed } from '../../types/index.js';
+/**
+ * Detect all component types for a plugin at the given install path
+ * @param installPath - Absolute path to the installed plugin directory
+ * @returns PluginComponents object with detected component counts
+ * - Returns undefined values for components that are not present
+ * - Returns counts > 0 for components that exist
+ * @example
+ * const components = detectPluginComponents('/path/to/plugin')
+ * // => { skills: 5, commands: 2, mcpServers: 1 }
+ */
+export declare function detectPluginComponents(installPath: string): PluginComponents | undefined;
+/**
+ * Detect detailed components for an installed plugin
+ * Reads skills/, commands/, agents/ directories and parses plugin.json
+ * @param installPath - Absolute path to installed plugin directory
+ * @returns Detailed component info with names and descriptions
+ * - Returns undefined if path doesn't exist or has no components
+ * @example
+ * detectComponentsDetailed('/path/to/plugin')
+ * // => { skills: [{ name: 'xlsx', description: '...', type: 'skill' }] }
+ */
+export declare function detectComponentsDetailed(installPath: string): PluginComponentsDetailed | undefined;

package/dist/services/components/index.js

@@ -0,0 +1,126 @@
+/**
+ * Component service module index
+ * Re-exports all component detection and parsing functions
+ *
+ * This module provides a facade for detecting plugin components:
+ * - Skills (skills/ directory with SKILL.md files)
+ * - Commands (commands/ directory with .md files)
+ * - Agents (agents/ directory with .md files)
+ * - Hooks (hooks/ directory or hooks.json)
+ * - MCP Servers (plugin.json mcpServers)
+ * - LSP Servers (.lsp.json)
+ */
+// Re-export all from submodules for backward compatibility
+export { hasAnyComponents, getTotalComponentCount } from './utils.js';
+export { countSkills, getSkillDetails, parseSkillMdFull, getSkillDetailedInfo, } from './skillService.js';
+export { countMarkdownFiles, getMarkdownFileDetails, getMarkdownComponentDetailedInfo, parseFirstLineDescriptionFromContent, } from './markdownService.js';
+export { detectHooks, getHookNames } from './hookService.js';
+export { countMcpServers, getMcpServerNames, countLspServers, getLspServerNames, } from './serverService.js';
+import { directoryExists } from '../fileService.js';
+// Import from submodules for orchestration functions
+import { countSkills, getSkillDetails } from './skillService.js';
+import { countMarkdownFiles, getMarkdownFileDetails, } from './markdownService.js';
+import { detectHooks, getHookNames } from './hookService.js';
+import { countMcpServers, getMcpServerNames, countLspServers, getLspServerNames, } from './serverService.js';
+/**
+ * Detect all component types for a plugin at the given install path
+ * @param installPath - Absolute path to the installed plugin directory
+ * @returns PluginComponents object with detected component counts
+ * - Returns undefined values for components that are not present
+ * - Returns counts > 0 for components that exist
+ * @example
+ * const components = detectPluginComponents('/path/to/plugin')
+ * // => { skills: 5, commands: 2, mcpServers: 1 }
+ */
+export function detectPluginComponents(installPath) {
+    if (!directoryExists(installPath)) {
+        return undefined;
+    }
+    const components = {};
+    // Detect skills (count directories in skills/ folder)
+    const skillsCount = countSkills(installPath);
+    if (skillsCount > 0) {
+        components.skills = skillsCount;
+    }
+    // Detect commands (legacy location, now unified with skills in Claude Code v2.1.3+)
+    const commandsCount = countMarkdownFiles(installPath, 'commands');
+    if (commandsCount > 0) {
+        components.commands = commandsCount;
+    }
+    // Detect agents (count .md files in agents/ folder)
+    const agentsCount = countMarkdownFiles(installPath, 'agents');
+    if (agentsCount > 0) {
+        components.agents = agentsCount;
+    }
+    // Detect hooks
+    const hasHooks = detectHooks(installPath);
+    if (hasHooks) {
+        components.hooks = true;
+    }
+    // Detect MCP servers from plugin.json
+    const mcpCount = countMcpServers(installPath);
+    if (mcpCount > 0) {
+        components.mcpServers = mcpCount;
+    }
+    // Detect LSP servers from .lsp.json
+    const lspCount = countLspServers(installPath);
+    if (lspCount > 0) {
+        components.lspServers = lspCount;
+    }
+    // Return undefined if no components detected
+    if (Object.keys(components).length === 0) {
+        return undefined;
+    }
+    return components;
+}
+/**
+ * Detect detailed components for an installed plugin
+ * Reads skills/, commands/, agents/ directories and parses plugin.json
+ * @param installPath - Absolute path to installed plugin directory
+ * @returns Detailed component info with names and descriptions
+ * - Returns undefined if path doesn't exist or has no components
+ * @example
+ * detectComponentsDetailed('/path/to/plugin')
+ * // => { skills: [{ name: 'xlsx', description: '...', type: 'skill' }] }
+ */
+export function detectComponentsDetailed(installPath) {
+    if (!directoryExists(installPath)) {
+        return undefined;
+    }
+    const detailed = {};
+    // Skills: Read directory names + SKILL.md frontmatter
+    const skills = getSkillDetails(installPath);
+    if (skills.length > 0) {
+        detailed.skills = skills;
+    }
+    // Commands: Read .md filenames
+    const commands = getMarkdownFileDetails(installPath, 'commands', 'command');
+    if (commands.length > 0) {
+        detailed.commands = commands;
+    }
+    // Agents: Read .md filenames
+    const agents = getMarkdownFileDetails(installPath, 'agents', 'agent');
+    if (agents.length > 0) {
+        detailed.agents = agents;
+    }
+    // Hooks: Read event names from hooks.json or hooks/ directory
+    const hooks = getHookNames(installPath);
+    if (hooks.length > 0) {
+        detailed.hooks = hooks;
+    }
+    // MCP Servers: Read plugin.json mcpServers keys
+    const mcpServers = getMcpServerNames(installPath);
+    if (mcpServers.length > 0) {
+        detailed.mcpServers = mcpServers;
+    }
+    // LSP Servers: Read .lsp.json keys
+    const lspServers = getLspServerNames(installPath);
+    if (lspServers.length > 0) {
+        detailed.lspServers = lspServers;
+    }
+    // Return undefined if no components detected
+    if (Object.keys(detailed).length === 0) {
+        return undefined;
+    }
+    return detailed;
+}

package/dist/services/components/markdownService.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Markdown component detection and parsing service
+ * Handles commands/ and agents/ directory scanning
+ */
+import type { ComponentInfo, ComponentDetailedInfo } from '../../types/index.js';
+/**
+ * Count .md files in a specific directory
+ * @param installPath - Plugin install path
+ * @param subdir - Subdirectory name ('commands' or 'agents')
+ * @returns Number of .md files
+ */
+export declare function countMarkdownFiles(installPath: string, subdir: string): number;
+/**
+ * Get component details from .md files in a directory
+ * Uses filename (minus extension) as component name
+ * @param installPath - Plugin install path
+ * @param subdir - Subdirectory name ('commands' or 'agents')
+ * @param type - Component type
+ * @returns Array of ComponentInfo
+ */
+export declare function getMarkdownFileDetails(installPath: string, subdir: string, type: 'command' | 'agent'): ComponentInfo[];
+/**
+ * Get detailed info for a command or agent markdown file
+ * @param installPath - Plugin install path
+ * @param componentName - Name of the component (without .md)
+ * @param type - Component type ('command' or 'agent')
+ * @returns ComponentDetailedInfo with full content
+ */
+export declare function getMarkdownComponentDetailedInfo(installPath: string, componentName: string, type: 'command' | 'agent'): ComponentDetailedInfo | undefined;
+/**
+ * Parse first non-empty line of content as description
+ * Properly skips YAML frontmatter block and strips heading markers
+ * @param content - Markdown content string
+ * @returns First non-frontmatter, non-empty line or undefined
+ * @example
+ * parseFirstLineDescriptionFromContent("---\nname: test\n---\n# My Title\n")
+ * // => "My Title"
+ */
+export declare function parseFirstLineDescriptionFromContent(content: string): string | undefined;