ng-primitives 0.93.0 → 0.95.0

package/roving-focus/index.d.ts

@@ -8,10 +8,26 @@ import { BooleanInput } from '@angular/cdk/coercion';
  * The state interface for the RovingFocusItem pattern.
  */
 interface NgpRovingFocusItemState {
+    /**
+     * The unique id of the roving focus item.
+     */
     readonly id: Signal<string>;
+    /**
+     * Whether the item is disabled.
+     */
     readonly disabled: Signal<boolean>;
+    /**
+     * The tabindex of the roving focus item.
+     */
     readonly tabindex: Signal<number>;
+    /**
+     * The element reference of the roving focus item.
+     */
     readonly element: ElementRef<HTMLElement>;
+    /**
+     * Focus the roving focus item.
+     * @param origin The focus origin
+     */
     focus(origin: FocusOrigin): void;
 }
 /**
@@ -30,10 +46,12 @@ declare const injectRovingFocusItemState: {
     (options: {
         hoisted: true;
         optional?: boolean;
+        skipSelf?: boolean;
     }): Signal<NgpRovingFocusItemState | null>;
     (options?: {
         hoisted?: boolean;
         optional?: boolean;
+        skipSelf?: boolean;
     }): Signal<NgpRovingFocusItemState> | Signal<NgpRovingFocusItemState | null>;
 };
 declare const provideRovingFocusItemState: (opts?: {
@@ -41,23 +59,75 @@ declare const provideRovingFocusItemState: (opts?: {
 }) => _angular_core.FactoryProvider;
 
 interface NgpRovingFocusGroupState {
-    orientation: Signal<NgpOrientation>;
-    wrap: Signal<boolean>;
-    homeEnd: Signal<boolean>;
-    disabled: Signal<boolean>;
-    activeItem: Signal<string | null>;
+    /**
+     * The orientation of the roving focus group.
+     */
+    readonly orientation: Signal<NgpOrientation>;
+    /**
+     * Whether the roving focus group should wrap around.
+     */
+    readonly wrap: Signal<boolean>;
+    /**
+     * Whether the Home and End keys are enabled.
+     */
+    readonly homeEnd: Signal<boolean>;
+    /**
+     * Whether the roving focus group is disabled.
+     */
+    readonly disabled: Signal<boolean>;
+    /**
+     * The id of the currently active item.
+     */
+    readonly activeItem: Signal<string | null>;
+    /**
+     * Handle keyboard navigation.
+     * @param event The keyboard event
+     */
     onKeydown(event: KeyboardEvent): void;
+    /**
+     * Set the active item by id.
+     * @param id The id of the item to activate
+     * @param origin The origin of the focus change
+     */
     setActiveItem(id: string | null, origin?: FocusOrigin): void;
+    /**
+     * Register an item with the roving focus group.
+     * @param item The item to register
+     */
     register(item: NgpRovingFocusItemState): void;
+    /**
+     * Unregister an item from the roving focus group.
+     * @param item The item to unregister
+     * @internal
+     */
     unregister(item: NgpRovingFocusItemState): void;
+    /**
+     * Set the orientation of the roving focus group.
+     * @param orientation The orientation value
+     */
     setOrientation(orientation: NgpOrientation): void;
 }
 interface NgpRovingFocusGroupProps {
-    orientation?: Signal<NgpOrientation>;
-    wrap?: Signal<boolean>;
-    homeEnd?: Signal<boolean>;
-    disabled?: Signal<boolean>;
-    inherit?: boolean;
+    /**
+     * The orientation of the roving focus group.
+     */
+    readonly orientation?: Signal<NgpOrientation>;
+    /**
+     * Whether the roving focus group should wrap around.
+     */
+    readonly wrap?: Signal<boolean>;
+    /**
+     * Whether the Home and End keys are enabled.
+     */
+    readonly homeEnd?: Signal<boolean>;
+    /**
+     * Whether the roving focus group is disabled.
+     */
+    readonly disabled?: Signal<boolean>;
+    /**
+     * Whether to inherit state from a parent roving focus group.
+     */
+    readonly inherit?: boolean;
 }
 declare const NgpRovingFocusGroupStateToken: _angular_core.InjectionToken<_angular_core.WritableSignal<NgpRovingFocusGroupState>>;
 declare const ngpRovingFocusGroup: ({ orientation: _orientation, wrap, homeEnd, disabled, inherit, }: NgpRovingFocusGroupProps) => NgpRovingFocusGroupState;
@@ -66,10 +136,12 @@ declare const injectRovingFocusGroupState: {
     (options: {
         hoisted: true;
         optional?: boolean;
+        skipSelf?: boolean;
     }): Signal<NgpRovingFocusGroupState | null>;
     (options?: {
         hoisted?: boolean;
         optional?: boolean;
+        skipSelf?: boolean;
     }): Signal<NgpRovingFocusGroupState> | Signal<NgpRovingFocusGroupState | null>;
 };
 declare const provideRovingFocusGroupState: (opts?: {

package/schematics/mcp-setup/README.md

@@ -0,0 +1,180 @@
+# MCP Setup Schematic
+
+This schematic automatically configures the Angular Primitives MCP (Model Context Protocol) server for various AI tools and editors with **project-based configurations**.
+
+## Usage
+
+### With Angular CLI
+
+```bash
+ng generate ng-primitives:mcp-setup
+```
+
+Or using the alias:
+
+```bash
+ng generate ng-primitives:mcp
+```
+
+### With Nx
+
+```bash
+nx generate ng-primitives:mcp-setup
+```
+
+### Options
+
+- `--tools` - Array of AI tools/editors to configure. Available options:
+  - `claude-code` - Claude Code
+  - `cursor` - Cursor
+  - `vscode` - VS Code (GitHub Copilot)
+  - `codex` - Codex
+
+### Examples
+
+#### Interactive Mode (Recommended)
+
+```bash
+ng generate ng-primitives:mcp-setup
+```
+
+This will prompt you to select which tools to configure using a multi-select menu.
+
+#### Command Line
+
+Configure specific tools:
+
+```bash
+ng generate ng-primitives:mcp-setup --tools=claude-code,cursor
+```
+
+Configure all tools:
+
+```bash
+ng generate ng-primitives:mcp-setup --tools=claude-code,cursor,vscode,codex
+```
+
+## What It Does
+
+The schematic creates **project-local** configuration files for each selected tool:
+
+- **Claude Code**: `.mcp.json` in project root
+- **Cursor**: `.cursor/mcp.json` in project root
+- **VS Code**: `.vscode/mcp.json` in project root
+- **Codex**: `.codex/config.toml` in project root
+
+### Configuration Format
+
+#### Claude Code & Cursor
+
+```json
+{
+  "mcpServers": {
+    "ngp-mcp": {
+      "command": "npx",
+      "args": ["-y", "@ng-primitives/mcp"]
+    }
+  }
+}
+```
+
+#### VS Code (GitHub Copilot)
+
+```json
+{
+  "servers": {
+    "ngp-mcp": {
+      "command": "npx",
+      "args": ["-y", "@ng-primitives/mcp"]
+    }
+  }
+}
+```
+
+#### Codex
+
+```toml
+[mcp_servers.ngp-mcp]
+command = "npx"
+args = ["-y", "@ng-primitives/mcp"]
+```
+
+## Available MCP Tools
+
+Once configured, the following tools will be available in your AI editor:
+
+- `list_primitives` - List all available Angular Primitives with filtering
+- `get_primitive_details` - Get detailed information about a specific primitive
+- `get_install_command` - Generate npm install commands
+- `list_reusable_components` - List reusable component implementations
+- `get_reusable_component` - Get full source code for a component
+- `get_setup_guide` - Get setup instructions for Angular Primitives
+
+## After Running
+
+1. **Restart your AI tool/editor** for changes to take effect
+2. **Enable the ngp-mcp server** in your tool's settings (if required)
+3. The MCP server will automatically start when needed
+4. You can verify the server is configured by checking for "ngp-mcp" in your tool's MCP settings
+
+## Project-Based vs Global
+
+This schematic creates **project-based configurations** (not global). This means:
+
+- ✅ Configuration is version-controlled with your project
+- ✅ Different projects can have different MCP setups
+- ✅ Team members get the same MCP configuration
+- ✅ No need to configure MCP globally on each machine
+
+## Updating Existing Configurations
+
+The schematic is smart about existing configurations:
+
+- If a config file already exists, it will be updated (not replaced)
+- Other MCP servers in the config are preserved
+- Only the `ngp-mcp` server configuration is added/updated
+
+## Troubleshooting
+
+### Configuration Not Working
+
+If the MCP server doesn't appear after restarting:
+
+1. Check that the configuration file was created in your project root
+2. Verify your AI tool supports project-based MCP configs
+3. Try enabling the server manually in your tool's settings
+4. Check that Node.js and npx are available in your PATH
+
+### Server Not Starting
+
+If the MCP server doesn't start:
+
+1. Try running `npx -y @ng-primitives/mcp` manually to test
+2. Check your tool's MCP logs for errors
+3. Verify you have internet access to download the package
+4. Ensure you're using a recent version of Node.js (v18+)
+
+### VS Code Specific
+
+For VS Code with GitHub Copilot:
+
+1. Open `.vscode/mcp.json` in your project
+2. Click the "Start" button next to the ngp-mcp server
+3. Check the MCP output panel for any errors
+
+## Example Prompts
+
+Try these prompts once configured:
+
+- "Show me all available Angular Primitives"
+- "Add the button primitive to my project"
+- "Get details about the dialog primitive"
+- "Show me the reusable button component implementation"
+- "How do I set up Angular Primitives?"
+
+## Learn More
+
+- [Angular Primitives Documentation](https://angularprimitives.com)
+- [Model Context Protocol](https://modelcontextprotocol.io)
+- [GitHub Repository](https://github.com/ng-primitives/ng-primitives)
+- [MCP Documentation](https://modelcontextprotocol.io/docs)

package/schematics/mcp-setup/index.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '@angular-devkit/schematics';
+import { McpSetupSchema } from './schema';
+export default function mcpSetup(options: McpSetupSchema): Rule;

package/schematics/mcp-setup/index.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = mcpSetup;
+const tasks_1 = require("@angular-devkit/schematics/tasks");
+const dependencies_1 = require("@schematics/angular/utility/dependencies");
+// Read version from package.json at compile time
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { version: PACKAGE_VERSION } = require('../../package.json');
+/**
+ * Get the configuration file path for each tool (project-relative)
+ */
+function getConfigPath(tool) {
+    switch (tool) {
+        case 'claude-code':
+            return '.mcp.json';
+        case 'cursor':
+            return '.cursor/mcp.json';
+        case 'vscode':
+            return '.vscode/mcp.json';
+        case 'codex':
+            return '.codex/config.toml';
+        default:
+            throw new Error(`Unknown tool: ${tool}`);
+    }
+}
+/**
+ * Create MCP server configuration
+ */
+function createMcpServerConfig() {
+    return {
+        command: 'npx',
+        args: ['-y', '@ng-primitives/mcp'],
+    };
+}
+/**
+ * Update or create MCP configuration for Codex (TOML format)
+ */
+function updateCodexConfig(tree, configPath, context) {
+    let content = '';
+    if (tree.exists(configPath)) {
+        const existingContent = tree.read(configPath);
+        if (existingContent) {
+            content = existingContent.toString();
+            context.logger.info(`Found existing configuration at ${configPath}`);
+        }
+    }
+    else {
+        context.logger.info(`Creating new configuration at ${configPath}`);
+    }
+    // Check if ngp-mcp already exists (more robust check)
+    if (content.match(/\[mcp_servers\.ngp-mcp\]/)) {
+        context.logger.info(`ngp-mcp already configured in ${configPath}`);
+        return;
+    }
+    // Add ngp-mcp configuration
+    const mcpConfig = `
+[mcp_servers.ngp-mcp]
+command = "npx"
+args = ["-y", "@ng-primitives/mcp"]
+`;
+    content += mcpConfig;
+    if (tree.exists(configPath)) {
+        tree.overwrite(configPath, content);
+    }
+    else {
+        tree.create(configPath, content);
+    }
+    context.logger.info(`✓ Configured ngp-mcp for Codex`);
+}
+/**
+ * Update or create MCP configuration for JSON-based tools
+ */
+function updateJsonConfig(tree, tool, configPath, context) {
+    let config = {};
+    if (tree.exists(configPath)) {
+        const content = tree.read(configPath);
+        if (content) {
+            try {
+                config = JSON.parse(content.toString());
+                context.logger.info(`Found existing configuration at ${configPath}`);
+            }
+            catch {
+                context.logger.warn(`Failed to parse existing config at ${configPath}, creating new one`);
+            }
+        }
+    }
+    else {
+        context.logger.info(`Creating new configuration at ${configPath}`);
+    }
+    const serverConfig = createMcpServerConfig();
+    // Tool-specific configuration structure
+    switch (tool) {
+        case 'claude-code':
+        case 'cursor':
+            // These use mcpServers
+            if (!config.mcpServers) {
+                config.mcpServers = {};
+            }
+            if (config.mcpServers['ngp-mcp']) {
+                context.logger.info(`ngp-mcp already configured in ${configPath}`);
+                return;
+            }
+            config.mcpServers['ngp-mcp'] = serverConfig;
+            break;
+        case 'vscode':
+            // VS Code uses servers
+            if (!config.servers) {
+                config.servers = {};
+            }
+            if (config.servers['ngp-mcp']) {
+                context.logger.info(`ngp-mcp already configured in ${configPath}`);
+                return;
+            }
+            config.servers['ngp-mcp'] = serverConfig;
+            break;
+    }
+    // Write the updated configuration
+    const configJson = JSON.stringify(config, null, 2);
+    if (tree.exists(configPath)) {
+        tree.overwrite(configPath, configJson);
+    }
+    else {
+        tree.create(configPath, configJson);
+    }
+    context.logger.info(`✓ Configured ngp-mcp for ${tool}`);
+}
+/**
+ * Update or create MCP configuration for a tool
+ */
+function updateToolConfig(tree, tool, context) {
+    const configPath = getConfigPath(tool);
+    if (tool === 'codex') {
+        updateCodexConfig(tree, configPath, context);
+    }
+    else {
+        updateJsonConfig(tree, tool, configPath, context);
+    }
+}
+function mcpSetup(options) {
+    return (tree, context) => {
+        if (!options.tools || options.tools.length === 0) {
+            context.logger.info('MCP setup skipped.');
+            return tree;
+        }
+        // Filter out 'none' and configure each selected tool
+        const toolsToConfig = options.tools.filter(tool => tool !== 'none');
+        if (toolsToConfig.length === 0) {
+            context.logger.info('MCP setup skipped.');
+            return tree;
+        }
+        context.logger.info('Setting up Angular Primitives MCP server...');
+        // Add @ng-primitives/mcp as a dependency
+        (0, dependencies_1.addPackageJsonDependency)(tree, {
+            type: dependencies_1.NodeDependencyType.Default,
+            name: '@ng-primitives/mcp',
+            version: `^${PACKAGE_VERSION}`,
+            overwrite: false,
+        });
+        context.logger.info('✓ Added @ng-primitives/mcp to dependencies');
+        // Schedule package installation
+        context.addTask(new tasks_1.NodePackageInstallTask());
+        for (const tool of toolsToConfig) {
+            try {
+                updateToolConfig(tree, tool, context);
+            }
+            catch (error) {
+                context.logger.error(`Failed to configure ${tool}: ${error}`);
+            }
+        }
+        context.logger.info('');
+        context.logger.info('✓ MCP server setup complete!');
+        context.logger.info('');
+        context.logger.info('Next steps:');
+        context.logger.info('1. Restart your AI tool/editor');
+        context.logger.info('2. Enable the ngp-mcp server in your tool settings');
+        context.logger.info('3. The server will be available with the following tools:');
+        context.logger.info('   • list_primitives - List all available primitives');
+        context.logger.info('   • get_primitive_details - Get detailed information about a primitive');
+        context.logger.info('   • get_install_command - Generate install commands');
+        context.logger.info('   • list_reusable_components - List reusable component implementations');
+        context.logger.info('   • get_reusable_component - Get component source code');
+        context.logger.info('   • get_setup_guide - Get setup instructions');
+        context.logger.info('');
+        context.logger.info('Learn more: https://angularprimitives.com');
+        return tree;
+    };
+}
+//# sourceMappingURL=index.js.map

package/schematics/mcp-setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/ng-primitives/schematics/mcp-setup/index.ts"],"names":[],"mappings":"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"}

package/schematics/mcp-setup/schema.d.ts

@@ -0,0 +1,3 @@
+export interface McpSetupSchema {
+  tools: ('none' | 'claude-code' | 'cursor' | 'vscode' | 'codex')[];
+}

package/schematics/mcp-setup/schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "angular-primitives-mcp-setup",
+  "title": "Angular Primitives MCP Setup",
+  "type": "object",
+  "properties": {
+    "tools": {
+      "type": "array",
+      "uniqueItems": true,
+      "description": "Specifies which AI tools to generate MCP configuration files for. These files are used to improve the outputs of AI tools by providing context about Angular Primitives.",
+      "default": ["none"],
+      "items": {
+        "type": "string",
+        "enum": ["none", "claude-code", "cursor", "vscode", "codex"]
+      },
+      "x-prompt": {
+        "message": "Which AI tools would you like to configure for Angular Primitives MCP server?",
+        "type": "list",
+        "multiselect": true,
+        "items": [
+          {
+            "value": "none",
+            "label": "None (skip MCP setup)"
+          },
+          {
+            "value": "claude-code",
+            "label": "Claude Code"
+          },
+          {
+            "value": "cursor",
+            "label": "Cursor"
+          },
+          {
+            "value": "vscode",
+            "label": "VS Code (GitHub Copilot)"
+          },
+          {
+            "value": "codex",
+            "label": "Codex"
+          }
+        ]
+      }
+    }
+  },
+  "required": ["tools"]
+}

package/schematics/ng-add/index.d.ts

@@ -1,2 +1,3 @@
 import { Rule } from '@angular-devkit/schematics';
-export default function ngAdd(): Rule;
+import { Schema } from './schema';
+export default function ngAdd(options: Schema): Rule;

package/schematics/ng-add/index.js

@@ -1,24 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = ngAdd;
+const schematics_1 = require("@angular-devkit/schematics");
 const tasks_1 = require("@angular-devkit/schematics/tasks");
+const core_1 = require("@angular/core");
 const dependencies_1 = require("@schematics/angular/utility/dependencies");
-function ngAdd() {
+function ngAdd(options) {
     return (tree, context) => {
-        (0, dependencies_1.addPackageJsonDependency)(tree, {
-            type: dependencies_1.NodeDependencyType.Default,
-            name: '@angular/cdk',
-            version: '^19.0.0',
-            overwrite: false,
-        });
-        (0, dependencies_1.addPackageJsonDependency)(tree, {
-            type: dependencies_1.NodeDependencyType.Default,
-            name: '@floating-ui/dom',
-            version: '^1.6.0',
-            overwrite: false,
-        });
-        context.addTask(new tasks_1.NodePackageInstallTask());
-        return tree;
+        const rules = [];
+        // Add dependencies
+        const addDependencies = (tree) => {
+            (0, dependencies_1.addPackageJsonDependency)(tree, {
+                type: dependencies_1.NodeDependencyType.Default,
+                name: '@angular/cdk',
+                version: `^${core_1.VERSION.major}.0.0`,
+                overwrite: false,
+            });
+            (0, dependencies_1.addPackageJsonDependency)(tree, {
+                type: dependencies_1.NodeDependencyType.Default,
+                name: '@floating-ui/dom',
+                version: '^1.6.0',
+                overwrite: false,
+            });
+            context.addTask(new tasks_1.NodePackageInstallTask());
+            return tree;
+        };
+        rules.push(addDependencies);
+        // Add MCP setup if tools are selected (excluding 'none')
+        if (options.mcpTools && options.mcpTools.length > 0) {
+            const toolsToSetup = options.mcpTools.filter(tool => tool !== 'none');
+            if (toolsToSetup.length > 0) {
+                rules.push((0, schematics_1.schematic)('mcp-setup', {
+                    tools: toolsToSetup,
+                }));
+            }
+        }
+        return (0, schematics_1.chain)(rules);
     };
 }
 //# sourceMappingURL=index.js.map

package/schematics/ng-add/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/ng-primitives/schematics/ng-add/index.ts"],"names":[],"mappings":";;AAOA,wBAmBC;AAzBD,4DAA0E;AAC1E,2EAGkD;AAElD,SAAwB,KAAK;IAC3B,OAAO,CAAC,IAAU,EAAE,OAAO,EAAE,EAAE;QAC7B,IAAA,uCAAwB,EAAC,IAAI,EAAE;YAC7B,IAAI,EAAE,iCAAkB,CAAC,OAAO;YAChC,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QAEH,IAAA,uCAAwB,EAAC,IAAI,EAAE;YAC7B,IAAI,EAAE,iCAAkB,CAAC,OAAO;YAChC,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QAEH,OAAO,CAAC,OAAO,CAAC,IAAI,8BAAsB,EAAE,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/ng-primitives/schematics/ng-add/index.ts"],"names":[],"mappings":";;AASA,wBAwCC;AAjDD,2DAA0E;AAC1E,4DAA0E;AAC1E,wCAAwC;AACxC,2EAGkD;AAGlD,SAAwB,KAAK,CAAC,OAAe;IAC3C,OAAO,CAAC,IAAU,EAAE,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAW,EAAE,CAAC;QAEzB,mBAAmB;QACnB,MAAM,eAAe,GAAS,CAAC,IAAU,EAAE,EAAE;YAC3C,IAAA,uCAAwB,EAAC,IAAI,EAAE;gBAC7B,IAAI,EAAE,iCAAkB,CAAC,OAAO;gBAChC,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,IAAI,cAAO,CAAC,KAAK,MAAM;gBAChC,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YAEH,IAAA,uCAAwB,EAAC,IAAI,EAAE;gBAC7B,IAAI,EAAE,iCAAkB,CAAC,OAAO;gBAChC,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,QAAQ;gBACjB,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YAEH,OAAO,CAAC,OAAO,CAAC,IAAI,8BAAsB,EAAE,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAE5B,yDAAyD;QACzD,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YACtE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CACR,IAAA,sBAAS,EAAC,WAAW,EAAE;oBACrB,KAAK,EAAE,YAAY;iBACpB,CAAC,CACH,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAA,kBAAK,EAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}

package/schematics/ng-add/schema.d.ts

@@ -1 +1,3 @@
-export interface Schema {}
+export interface Schema {
+  mcpTools?: ('none' | 'claude-code' | 'cursor' | 'vscode' | 'codex')[];
+}