@diamondslab/diamonds 1.3.2 → 1.4.0

package/dist/cli/diamond-abi-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=diamond-abi-cli.d.ts.map

package/dist/cli/diamond-abi-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diamond-abi-cli.d.ts","sourceRoot":"","sources":["../../src/cli/diamond-abi-cli.ts"],"names":[],"mappings":";AAqeA,OAAO,EAAE,CAAC"}

package/dist/cli/diamond-abi-cli.js

@@ -0,0 +1,377 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = require("fs");
+// NOTE: `hardhat` (and, via its config, the hardhat-ethers plugin) is loaded
+// lazily inside `setupDiamondConnection` so commands that don't need a chain
+// connection (`validate`, `compare`) run without booting the Hardhat runtime.
+// Importing `@nomicfoundation/hardhat-ethers` at module scope would call
+// `extendEnvironment` before a Hardhat context exists (HH5), so it is avoided.
+// This CLI formats and inspects arbitrary ABI/JSON artifacts and indexes internal
+// selector maps, so `any` and dynamic property access are intentional below.
+/* eslint-disable @typescript-eslint/no-explicit-any, security/detect-object-injection */
+const program = new commander_1.Command();
+// Keep the CLI version in sync with the package version. The relative path
+// resolves to the package root from both src/cli (dev) and dist/cli (published).
+const { version: pkgVersion } = require('../../package.json');
+program
+    .name('diamond-abi')
+    .description('Diamond ABI generation utilities')
+    .version(pkgVersion);
+// Generate command
+program
+    .command('generate')
+    .description('Generate ABI for a deployed diamond')
+    .option('-d, --diamond <name>', 'Diamond name', 'GeniusDiamond')
+    .option('-n, --network <name>', 'Network name', 'localhost')
+    .option('-c, --chain-id <id>', 'Chain ID', '31337')
+    .option('-o, --output <dir>', 'Output directory (overrides diamond config)', undefined)
+    .option('--deployments-path <path>', 'Deployments path', './diamonds')
+    .option('--contracts-path <path>', 'Contracts path', './contracts')
+    .option('--include-source', 'Include source information in ABI', false)
+    .option('--validate-selectors', 'Validate function selector uniqueness', true)
+    .option('-v, --verbose', 'Verbose output', false)
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.blue('🔧 Generating Diamond ABI...'));
+        const { generateDiamondAbi } = await import('../utils/diamondAbiGenerator.js');
+        const { Diamond } = await import('../core/Diamond.js');
+        const { FileDeploymentRepository } = await import('../repositories/FileDeploymentRepository.js');
+        const config = {
+            diamondName: options.diamond,
+            networkName: options.network,
+            chainId: parseInt(options.chainId),
+            deploymentsPath: options.deploymentsPath,
+            contractsPath: options.contractsPath,
+        };
+        if (options.verbose) {
+            console.log(chalk_1.default.cyan('📋 Configuration:'));
+            console.log(chalk_1.default.gray(`  Diamond: ${config.diamondName}`));
+            console.log(chalk_1.default.gray(`  Network: ${config.networkName}`));
+            console.log(chalk_1.default.gray(`  Chain ID: ${config.chainId}`));
+            console.log(chalk_1.default.gray(`  Output: ${options.output}`));
+        }
+        // Create diamond instance
+        const repository = new FileDeploymentRepository(config);
+        const diamond = new Diamond(config, repository);
+        // Set provider and signer if available
+        await setupDiamondConnection(diamond, options.verbose);
+        // Generate ABI using Diamond's configured paths
+        const result = await generateDiamondAbi(diamond, {
+            outputDir: options.output ?? diamond.getDiamondAbiPath(),
+            includeSourceInfo: options.includeSource,
+            validateSelectors: options.validateSelectors,
+            verbose: options.verbose,
+        });
+        console.log(chalk_1.default.green('\n✅ Diamond ABI generation completed!'));
+        displayResults(result, options.verbose);
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Error generating Diamond ABI:'), error);
+        process.exit(1);
+    }
+});
+// Preview command
+program
+    .command('preview')
+    .description('Preview ABI changes for planned diamond cuts')
+    .option('-d, --diamond <name>', 'Diamond name', 'GeniusDiamond')
+    .option('-n, --network <name>', 'Network name', 'localhost')
+    .option('-c, --chain-id <id>', 'Chain ID', '31337')
+    .option('--deployments-path <path>', 'Deployments path', './diamonds')
+    .option('--contracts-path <path>', 'Contracts path', './contracts')
+    .option('-v, --verbose', 'Verbose output', false)
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.blue('🔍 Previewing Diamond ABI changes...'));
+        const { generateDiamondAbi, previewDiamondAbi } = await import('../utils/diamondAbiGenerator.js');
+        const { Diamond } = await import('../core/Diamond.js');
+        const { FileDeploymentRepository } = await import('../repositories/FileDeploymentRepository.js');
+        const config = {
+            diamondName: options.diamond,
+            networkName: options.network,
+            chainId: parseInt(options.chainId),
+            deploymentsPath: options.deploymentsPath,
+            contractsPath: options.contractsPath,
+        };
+        const repository = new FileDeploymentRepository(config);
+        const diamond = new Diamond(config, repository);
+        await setupDiamondConnection(diamond, options.verbose);
+        // Get current state
+        const currentResult = await generateDiamondAbi(diamond, {
+            verbose: false,
+            includeSourceInfo: false,
+        });
+        console.log(chalk_1.default.cyan('\n📋 Current ABI state:'));
+        console.log(chalk_1.default.gray(`  Functions: ${currentResult.stats.totalFunctions}`));
+        console.log(chalk_1.default.gray(`  Events: ${currentResult.stats.totalEvents}`));
+        console.log(chalk_1.default.gray(`  Facets: ${currentResult.stats.facetCount}`));
+        // Check for planned cuts
+        const registry = diamond.functionSelectorRegistry;
+        const plannedCuts = Array.from(registry.entries())
+            .filter(([_, entry]) => entry.action !== 0) // Not deployed
+            .map(([selector, entry]) => ({
+            facetAddress: entry.address,
+            action: entry.action,
+            functionSelectors: [selector],
+            name: entry.facetName,
+        }));
+        if (plannedCuts.length === 0) {
+            console.log(chalk_1.default.yellow('\n⚠️  No planned cuts found in function selector registry'));
+            console.log(chalk_1.default.gray('   Use the diamond deployment system to plan upgrades first.'));
+            return;
+        }
+        console.log(chalk_1.default.cyan(`\n🔄 Found ${plannedCuts.length} planned cuts:`));
+        for (const cut of plannedCuts) {
+            const actionName = cut.action === 1 ? 'Add' : cut.action === 2 ? 'Remove' : 'Replace';
+            console.log(chalk_1.default.gray(`  ${actionName}: ${cut.name} (${cut.functionSelectors.length} selectors)`));
+        }
+        // Preview with planned cuts
+        const previewResult = await previewDiamondAbi(diamond, plannedCuts, {
+            verbose: options.verbose,
+            includeSourceInfo: false,
+        });
+        console.log(chalk_1.default.green('\n✅ ABI preview completed!'));
+        console.log(chalk_1.default.blue('\n📊 Preview Results:'));
+        console.log(chalk_1.default.cyan(`  Functions after cuts: ${previewResult.stats.totalFunctions}`));
+        console.log(chalk_1.default.cyan(`  Events after cuts: ${previewResult.stats.totalEvents}`));
+        console.log(chalk_1.default.cyan(`  Facets after cuts: ${previewResult.stats.facetCount}`));
+        // Show differences
+        const functionDiff = previewResult.stats.totalFunctions - currentResult.stats.totalFunctions;
+        const facetDiff = previewResult.stats.facetCount - currentResult.stats.facetCount;
+        if (functionDiff !== 0) {
+            const color = functionDiff > 0 ? chalk_1.default.green : chalk_1.default.red;
+            console.log(color(`  Function change: ${functionDiff > 0 ? '+' : ''}${functionDiff}`));
+        }
+        if (facetDiff !== 0) {
+            const color = facetDiff > 0 ? chalk_1.default.green : chalk_1.default.red;
+            console.log(color(`  Facet change: ${facetDiff > 0 ? '+' : ''}${facetDiff}`));
+        }
+        if (options.verbose) {
+            console.log(chalk_1.default.blue('\n🎯 Planned Function Changes:'));
+            displaySelectorChanges(currentResult.selectorMap, previewResult.selectorMap);
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Error previewing Diamond ABI:'), error);
+        process.exit(1);
+    }
+});
+// Compare command
+program
+    .command('compare')
+    .description('Compare two diamond ABI files')
+    .argument('<file1>', 'First ABI file path')
+    .argument('<file2>', 'Second ABI file path')
+    .option('-v, --verbose', 'Verbose output', false)
+    .action(async (file1, file2, options) => {
+    try {
+        console.log(chalk_1.default.blue('🔍 Comparing Diamond ABI files...'));
+        if (!(0, fs_1.existsSync)(file1)) {
+            throw new Error(`File not found: ${file1}`);
+        }
+        if (!(0, fs_1.existsSync)(file2)) {
+            throw new Error(`File not found: ${file2}`);
+        }
+        const abi1 = JSON.parse(require('fs').readFileSync(file1, 'utf8'));
+        const abi2 = JSON.parse(require('fs').readFileSync(file2, 'utf8'));
+        console.log(chalk_1.default.cyan(`\n📋 Comparing:`));
+        console.log(chalk_1.default.gray(`  File 1: ${file1}`));
+        console.log(chalk_1.default.gray(`  File 2: ${file2}`));
+        const result1 = analyzeAbi(abi1);
+        const result2 = analyzeAbi(abi2);
+        console.log(chalk_1.default.blue('\n📊 Comparison Results:'));
+        // Function comparison
+        const funcDiff = result2.functions - result1.functions;
+        console.log(chalk_1.default.cyan(`Functions: ${result1.functions} → ${result2.functions} `), funcDiff === 0
+            ? chalk_1.default.gray('(no change)')
+            : funcDiff > 0
+                ? chalk_1.default.green(`(+${funcDiff})`)
+                : chalk_1.default.red(`(${funcDiff})`));
+        // Event comparison
+        const eventDiff = result2.events - result1.events;
+        console.log(chalk_1.default.cyan(`Events: ${result1.events} → ${result2.events} `), eventDiff === 0
+            ? chalk_1.default.gray('(no change)')
+            : eventDiff > 0
+                ? chalk_1.default.green(`(+${eventDiff})`)
+                : chalk_1.default.red(`(${eventDiff})`));
+        // Error comparison
+        const errorDiff = result2.errors - result1.errors;
+        console.log(chalk_1.default.cyan(`Errors: ${result1.errors} → ${result2.errors} `), errorDiff === 0
+            ? chalk_1.default.gray('(no change)')
+            : errorDiff > 0
+                ? chalk_1.default.green(`(+${errorDiff})`)
+                : chalk_1.default.red(`(${errorDiff})`));
+        if (options.verbose && abi1._diamondMetadata && abi2._diamondMetadata) {
+            console.log(chalk_1.default.blue('\n🔍 Detailed Selector Comparison:'));
+            displaySelectorChanges(abi1._diamondMetadata.selectorMap ?? {}, abi2._diamondMetadata.selectorMap ?? {});
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Error comparing ABI files:'), error);
+        process.exit(1);
+    }
+});
+// Validate command
+program
+    .command('validate')
+    .description('Validate a diamond ABI file')
+    .argument('<file>', 'ABI file path')
+    .option('-v, --verbose', 'Verbose output', false)
+    .action(async (file, options) => {
+    try {
+        console.log(chalk_1.default.blue('🔍 Validating Diamond ABI...'));
+        if (!(0, fs_1.existsSync)(file)) {
+            throw new Error(`File not found: ${file}`);
+        }
+        const artifact = JSON.parse(require('fs').readFileSync(file, 'utf8'));
+        // Basic structure validation
+        const hasRequiredFields = artifact.abi && artifact.contractName;
+        if (!hasRequiredFields) {
+            throw new Error('Invalid artifact: missing required fields (abi, contractName)');
+        }
+        // ABI validation with ethers
+        const { Interface } = await import('ethers');
+        let ethersInterface;
+        try {
+            ethersInterface = new Interface(artifact.abi);
+        }
+        catch (error) {
+            throw new Error(`Invalid ABI: ${error}`);
+        }
+        const analysis = analyzeAbi(artifact);
+        console.log(chalk_1.default.green('✅ ABI validation passed!'));
+        console.log(chalk_1.default.blue('\n📊 ABI Analysis:'));
+        console.log(chalk_1.default.cyan(`  Functions: ${analysis.functions}`));
+        console.log(chalk_1.default.cyan(`  Events: ${analysis.events}`));
+        console.log(chalk_1.default.cyan(`  Errors: ${analysis.errors}`));
+        console.log(chalk_1.default.cyan(`  Total fragments: ${ethersInterface.fragments.length}`));
+        if (artifact._diamondMetadata) {
+            const metadata = artifact._diamondMetadata;
+            console.log(chalk_1.default.blue('\n💎 Diamond Metadata:'));
+            console.log(chalk_1.default.cyan(`  Diamond: ${metadata.diamondName}`));
+            console.log(chalk_1.default.cyan(`  Network: ${metadata.networkName}`));
+            console.log(chalk_1.default.cyan(`  Chain ID: ${metadata.chainId}`));
+            console.log(chalk_1.default.cyan(`  Generated: ${metadata.generatedAt}`));
+            if (metadata.selectorMap) {
+                const selectorCount = Object.keys(metadata.selectorMap).length;
+                const facetCount = new Set(Object.values(metadata.selectorMap)).size;
+                console.log(chalk_1.default.cyan(`  Function selectors: ${selectorCount}`));
+                console.log(chalk_1.default.cyan(`  Facets: ${facetCount}`));
+            }
+        }
+        if (options.verbose) {
+            console.log(chalk_1.default.blue('\n🔍 Function Signatures:'));
+            ethersInterface.fragments
+                .filter((f) => f.type === 'function')
+                .slice(0, 10) // Show first 10
+                .forEach((f) => {
+                console.log(chalk_1.default.gray(`  ${f.format()}`));
+            });
+            if (ethersInterface.fragments.filter((f) => f.type === 'function').length > 10) {
+                console.log(chalk_1.default.gray(`  ... and ${ethersInterface.fragments.filter((f) => f.type === 'function').length - 10} more`));
+            }
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ ABI validation failed:'), error);
+        process.exit(1);
+    }
+});
+// Helper functions
+async function setupDiamondConnection(diamond, verbose) {
+    try {
+        // Typed as `any`: the `hre.ethers` helper is added at runtime by the
+        // hardhat-ethers plugin (loaded via the project's hardhat config).
+        const hre = (await import('hardhat')).default;
+        diamond.setProvider(hre.ethers.provider);
+        const signers = await hre.ethers.getSigners();
+        if (signers.length > 0) {
+            diamond.setSigner(signers[0]);
+        }
+        if (verbose) {
+            console.log(chalk_1.default.gray('✅ Connected to Hardhat provider'));
+        }
+    }
+    catch (error) {
+        if (verbose) {
+            console.log(chalk_1.default.yellow('⚠️  Could not connect to provider (running in standalone mode)'));
+        }
+    }
+}
+function displayResults(result, verbose) {
+    console.log(chalk_1.default.blue('\n📊 Generation Results:'));
+    console.log(chalk_1.default.cyan(`  Functions: ${result.stats.totalFunctions}`));
+    console.log(chalk_1.default.cyan(`  Events: ${result.stats.totalEvents}`));
+    console.log(chalk_1.default.cyan(`  Errors: ${result.stats.totalErrors}`));
+    console.log(chalk_1.default.cyan(`  Facets: ${result.stats.facetCount}`));
+    if (result.outputPath) {
+        console.log(chalk_1.default.cyan(`  Output: ${result.outputPath}`));
+    }
+    if (result.stats.duplicateSelectorsSkipped > 0) {
+        console.log(chalk_1.default.yellow(`  Duplicates skipped: ${result.stats.duplicateSelectorsSkipped}`));
+    }
+    if (verbose && result.selectorMap) {
+        console.log(chalk_1.default.blue('\n🎯 Function Selector Mapping:'));
+        const sortedSelectors = Object.entries(result.selectorMap).sort(([, a], [, b]) => a.localeCompare(b));
+        sortedSelectors.slice(0, 20).forEach(([selector, facet]) => {
+            console.log(chalk_1.default.gray(`  ${selector} → ${facet}`));
+        });
+        if (sortedSelectors.length > 20) {
+            console.log(chalk_1.default.gray(`  ... and ${sortedSelectors.length - 20} more`));
+        }
+    }
+}
+function displaySelectorChanges(oldMap, newMap) {
+    const oldSelectors = new Set(Object.keys(oldMap));
+    const newSelectors = new Set(Object.keys(newMap));
+    const added = Array.from(newSelectors).filter((s) => !oldSelectors.has(s));
+    const removed = Array.from(oldSelectors).filter((s) => !newSelectors.has(s));
+    const changed = Array.from(oldSelectors).filter((s) => newSelectors.has(s) && oldMap[s] !== newMap[s]);
+    if (added.length > 0) {
+        console.log(chalk_1.default.green(`\n  ➕ Added (${added.length}):`));
+        added.slice(0, 10).forEach((selector) => {
+            console.log(chalk_1.default.gray(`    ${selector} → ${newMap[selector]}`));
+        });
+        if (added.length > 10) {
+            console.log(chalk_1.default.gray(`    ... and ${added.length - 10} more`));
+        }
+    }
+    if (removed.length > 0) {
+        console.log(chalk_1.default.red(`\n  ➖ Removed (${removed.length}):`));
+        removed.slice(0, 10).forEach((selector) => {
+            console.log(chalk_1.default.gray(`    ${selector} → ${oldMap[selector]}`));
+        });
+        if (removed.length > 10) {
+            console.log(chalk_1.default.gray(`    ... and ${removed.length - 10} more`));
+        }
+    }
+    if (changed.length > 0) {
+        console.log(chalk_1.default.yellow(`\n  🔄 Changed (${changed.length}):`));
+        changed.slice(0, 10).forEach((selector) => {
+            console.log(chalk_1.default.gray(`    ${selector}: ${oldMap[selector]} → ${newMap[selector]}`));
+        });
+        if (changed.length > 10) {
+            console.log(chalk_1.default.gray(`    ... and ${changed.length - 10} more`));
+        }
+    }
+    if (added.length === 0 && removed.length === 0 && changed.length === 0) {
+        console.log(chalk_1.default.gray('  No selector changes detected'));
+    }
+}
+function analyzeAbi(artifact) {
+    const abi = artifact.abi ?? [];
+    return {
+        functions: abi.filter((item) => item.type === 'function').length,
+        events: abi.filter((item) => item.type === 'event').length,
+        errors: abi.filter((item) => item.type === 'error').length,
+    };
+}
+// Parse command line arguments
+program.parse();
+//# sourceMappingURL=diamond-abi-cli.js.map

package/dist/cli/diamond-abi-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diamond-abi-cli.js","sourceRoot":"","sources":["../../src/cli/diamond-abi-cli.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\n// The diamond/ABI-generator modules transitively import `hardhat` at module\n// scope, so they (and `hardhat` itself) are imported lazily inside the\n// `generate`/`preview` actions. This keeps `validate` and `compare` — which only\n// read ABI JSON files — runnable as a plain `node`/`npx` bin with no Hardhat.\nimport type { Diamond } from '../core/Diamond';\nimport type { DiamondConfig } from '../types';\nimport { existsSync } from 'fs';\n// NOTE: `hardhat` (and, via its config, the hardhat-ethers plugin) is loaded\n// lazily inside `setupDiamondConnection` so commands that don't need a chain\n// connection (`validate`, `compare`) run without booting the Hardhat runtime.\n// Importing `@nomicfoundation/hardhat-ethers` at module scope would call\n// `extendEnvironment` before a Hardhat context exists (HH5), so it is avoided.\n\n// This CLI formats and inspects arbitrary ABI/JSON artifacts and indexes internal\n// selector maps, so `any` and dynamic property access are intentional below.\n/* eslint-disable @typescript-eslint/no-explicit-any, security/detect-object-injection */\n\nconst program = new Command();\n\n// Keep the CLI version in sync with the package version. The relative path\n// resolves to the package root from both src/cli (dev) and dist/cli (published).\nconst { version: pkgVersion } = require('../../package.json');\n\nprogram\n\t.name('diamond-abi')\n\t.description('Diamond ABI generation utilities')\n\t.version(pkgVersion);\n\n// Generate command\nprogram\n\t.command('generate')\n\t.description('Generate ABI for a deployed diamond')\n\t.option('-d, --diamond <name>', 'Diamond name', 'GeniusDiamond')\n\t.option('-n, --network <name>', 'Network name', 'localhost')\n\t.option('-c, --chain-id <id>', 'Chain ID', '31337')\n\t.option('-o, --output <dir>', 'Output directory (overrides diamond config)', undefined)\n\t.option('--deployments-path <path>', 'Deployments path', './diamonds')\n\t.option('--contracts-path <path>', 'Contracts path', './contracts')\n\t.option('--include-source', 'Include source information in ABI', false)\n\t.option('--validate-selectors', 'Validate function selector uniqueness', true)\n\t.option('-v, --verbose', 'Verbose output', false)\n\t.action(async (options) => {\n\t\ttry {\n\t\t\tconsole.log(chalk.blue('🔧 Generating Diamond ABI...'));\n\n\t\t\tconst { generateDiamondAbi } = await import('../utils/diamondAbiGenerator.js');\n\t\t\tconst { Diamond } = await import('../core/Diamond.js');\n\t\t\tconst { FileDeploymentRepository } = await import(\n\t\t\t\t'../repositories/FileDeploymentRepository.js'\n\t\t\t);\n\n\t\t\tconst config: DiamondConfig = {\n\t\t\t\tdiamondName: options.diamond,\n\t\t\t\tnetworkName: options.network,\n\t\t\t\tchainId: parseInt(options.chainId),\n\t\t\t\tdeploymentsPath: options.deploymentsPath,\n\t\t\t\tcontractsPath: options.contractsPath,\n\t\t\t};\n\n\t\t\tif (options.verbose) {\n\t\t\t\tconsole.log(chalk.cyan('📋 Configuration:'));\n\t\t\t\tconsole.log(chalk.gray(`  Diamond: ${config.diamondName}`));\n\t\t\t\tconsole.log(chalk.gray(`  Network: ${config.networkName}`));\n\t\t\t\tconsole.log(chalk.gray(`  Chain ID: ${config.chainId}`));\n\t\t\t\tconsole.log(chalk.gray(`  Output: ${options.output}`));\n\t\t\t}\n\n\t\t\t// Create diamond instance\n\t\t\tconst repository = new FileDeploymentRepository(config);\n\t\t\tconst diamond: Diamond = new Diamond(config, repository);\n\n\t\t\t// Set provider and signer if available\n\t\t\tawait setupDiamondConnection(diamond, options.verbose);\n\n\t\t\t// Generate ABI using Diamond's configured paths\n\t\t\tconst result = await generateDiamondAbi(diamond, {\n\t\t\t\toutputDir: options.output ?? diamond.getDiamondAbiPath(),\n\t\t\t\tincludeSourceInfo: options.includeSource,\n\t\t\t\tvalidateSelectors: options.validateSelectors,\n\t\t\t\tverbose: options.verbose,\n\t\t\t});\n\n\t\t\tconsole.log(chalk.green('\\n✅ Diamond ABI generation completed!'));\n\t\t\tdisplayResults(result, options.verbose);\n\t\t} catch (error) {\n\t\t\tconsole.error(chalk.red('❌ Error generating Diamond ABI:'), error);\n\t\t\tprocess.exit(1);\n\t\t}\n\t});\n\n// Preview command\nprogram\n\t.command('preview')\n\t.description('Preview ABI changes for planned diamond cuts')\n\t.option('-d, --diamond <name>', 'Diamond name', 'GeniusDiamond')\n\t.option('-n, --network <name>', 'Network name', 'localhost')\n\t.option('-c, --chain-id <id>', 'Chain ID', '31337')\n\t.option('--deployments-path <path>', 'Deployments path', './diamonds')\n\t.option('--contracts-path <path>', 'Contracts path', './contracts')\n\t.option('-v, --verbose', 'Verbose output', false)\n\t.action(async (options) => {\n\t\ttry {\n\t\t\tconsole.log(chalk.blue('🔍 Previewing Diamond ABI changes...'));\n\n\t\t\tconst { generateDiamondAbi, previewDiamondAbi } = await import(\n\t\t\t\t'../utils/diamondAbiGenerator.js'\n\t\t\t);\n\t\t\tconst { Diamond } = await import('../core/Diamond.js');\n\t\t\tconst { FileDeploymentRepository } = await import(\n\t\t\t\t'../repositories/FileDeploymentRepository.js'\n\t\t\t);\n\n\t\t\tconst config: DiamondConfig = {\n\t\t\t\tdiamondName: options.diamond,\n\t\t\t\tnetworkName: options.network,\n\t\t\t\tchainId: parseInt(options.chainId),\n\t\t\t\tdeploymentsPath: options.deploymentsPath,\n\t\t\t\tcontractsPath: options.contractsPath,\n\t\t\t};\n\n\t\t\tconst repository = new FileDeploymentRepository(config);\n\t\t\tconst diamond: Diamond = new Diamond(config, repository);\n\n\t\t\tawait setupDiamondConnection(diamond, options.verbose);\n\n\t\t\t// Get current state\n\t\t\tconst currentResult = await generateDiamondAbi(diamond, {\n\t\t\t\tverbose: false,\n\t\t\t\tincludeSourceInfo: false,\n\t\t\t});\n\n\t\t\tconsole.log(chalk.cyan('\\n📋 Current ABI state:'));\n\t\t\tconsole.log(chalk.gray(`  Functions: ${currentResult.stats.totalFunctions}`));\n\t\t\tconsole.log(chalk.gray(`  Events: ${currentResult.stats.totalEvents}`));\n\t\t\tconsole.log(chalk.gray(`  Facets: ${currentResult.stats.facetCount}`));\n\n\t\t\t// Check for planned cuts\n\t\t\tconst registry = diamond.functionSelectorRegistry;\n\t\t\tconst plannedCuts = Array.from(registry.entries())\n\t\t\t\t.filter(([_, entry]) => entry.action !== 0) // Not deployed\n\t\t\t\t.map(([selector, entry]) => ({\n\t\t\t\t\tfacetAddress: entry.address,\n\t\t\t\t\taction: entry.action,\n\t\t\t\t\tfunctionSelectors: [selector],\n\t\t\t\t\tname: entry.facetName,\n\t\t\t\t}));\n\n\t\t\tif (plannedCuts.length === 0) {\n\t\t\t\tconsole.log(\n\t\t\t\t\tchalk.yellow('\\n⚠️  No planned cuts found in function selector registry'),\n\t\t\t\t);\n\t\t\t\tconsole.log(\n\t\t\t\t\tchalk.gray('   Use the diamond deployment system to plan upgrades first.'),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconsole.log(chalk.cyan(`\\n🔄 Found ${plannedCuts.length} planned cuts:`));\n\t\t\tfor (const cut of plannedCuts) {\n\t\t\t\tconst actionName =\n\t\t\t\t\tcut.action === 1 ? 'Add' : cut.action === 2 ? 'Remove' : 'Replace';\n\t\t\t\tconsole.log(\n\t\t\t\t\tchalk.gray(\n\t\t\t\t\t\t`  ${actionName}: ${cut.name} (${cut.functionSelectors.length} selectors)`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Preview with planned cuts\n\t\t\tconst previewResult = await previewDiamondAbi(diamond, plannedCuts, {\n\t\t\t\tverbose: options.verbose,\n\t\t\t\tincludeSourceInfo: false,\n\t\t\t});\n\n\t\t\tconsole.log(chalk.green('\\n✅ ABI preview completed!'));\n\t\t\tconsole.log(chalk.blue('\\n📊 Preview Results:'));\n\t\t\tconsole.log(\n\t\t\t\tchalk.cyan(`  Functions after cuts: ${previewResult.stats.totalFunctions}`),\n\t\t\t);\n\t\t\tconsole.log(chalk.cyan(`  Events after cuts: ${previewResult.stats.totalEvents}`));\n\t\t\tconsole.log(chalk.cyan(`  Facets after cuts: ${previewResult.stats.facetCount}`));\n\n\t\t\t// Show differences\n\t\t\tconst functionDiff =\n\t\t\t\tpreviewResult.stats.totalFunctions - currentResult.stats.totalFunctions;\n\t\t\tconst facetDiff = previewResult.stats.facetCount - currentResult.stats.facetCount;\n\n\t\t\tif (functionDiff !== 0) {\n\t\t\t\tconst color = functionDiff > 0 ? chalk.green : chalk.red;\n\t\t\t\tconsole.log(\n\t\t\t\t\tcolor(`  Function change: ${functionDiff > 0 ? '+' : ''}${functionDiff}`),\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (facetDiff !== 0) {\n\t\t\t\tconst color = facetDiff > 0 ? chalk.green : chalk.red;\n\t\t\t\tconsole.log(color(`  Facet change: ${facetDiff > 0 ? '+' : ''}${facetDiff}`));\n\t\t\t}\n\n\t\t\tif (options.verbose) {\n\t\t\t\tconsole.log(chalk.blue('\\n🎯 Planned Function Changes:'));\n\t\t\t\tdisplaySelectorChanges(currentResult.selectorMap, previewResult.selectorMap);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconsole.error(chalk.red('❌ Error previewing Diamond ABI:'), error);\n\t\t\tprocess.exit(1);\n\t\t}\n\t});\n\n// Compare command\nprogram\n\t.command('compare')\n\t.description('Compare two diamond ABI files')\n\t.argument('<file1>', 'First ABI file path')\n\t.argument('<file2>', 'Second ABI file path')\n\t.option('-v, --verbose', 'Verbose output', false)\n\t.action(async (file1, file2, options) => {\n\t\ttry {\n\t\t\tconsole.log(chalk.blue('🔍 Comparing Diamond ABI files...'));\n\n\t\t\tif (!existsSync(file1)) {\n\t\t\t\tthrow new Error(`File not found: ${file1}`);\n\t\t\t}\n\t\t\tif (!existsSync(file2)) {\n\t\t\t\tthrow new Error(`File not found: ${file2}`);\n\t\t\t}\n\n\t\t\tconst abi1 = JSON.parse(require('fs').readFileSync(file1, 'utf8'));\n\t\t\tconst abi2 = JSON.parse(require('fs').readFileSync(file2, 'utf8'));\n\n\t\t\tconsole.log(chalk.cyan(`\\n📋 Comparing:`));\n\t\t\tconsole.log(chalk.gray(`  File 1: ${file1}`));\n\t\t\tconsole.log(chalk.gray(`  File 2: ${file2}`));\n\n\t\t\tconst result1 = analyzeAbi(abi1);\n\t\t\tconst result2 = analyzeAbi(abi2);\n\n\t\t\tconsole.log(chalk.blue('\\n📊 Comparison Results:'));\n\n\t\t\t// Function comparison\n\t\t\tconst funcDiff = result2.functions - result1.functions;\n\t\t\tconsole.log(\n\t\t\t\tchalk.cyan(`Functions: ${result1.functions} → ${result2.functions} `),\n\t\t\t\tfuncDiff === 0\n\t\t\t\t\t? chalk.gray('(no change)')\n\t\t\t\t\t: funcDiff > 0\n\t\t\t\t\t\t? chalk.green(`(+${funcDiff})`)\n\t\t\t\t\t\t: chalk.red(`(${funcDiff})`),\n\t\t\t);\n\n\t\t\t// Event comparison\n\t\t\tconst eventDiff = result2.events - result1.events;\n\t\t\tconsole.log(\n\t\t\t\tchalk.cyan(`Events: ${result1.events} → ${result2.events} `),\n\t\t\t\teventDiff === 0\n\t\t\t\t\t? chalk.gray('(no change)')\n\t\t\t\t\t: eventDiff > 0\n\t\t\t\t\t\t? chalk.green(`(+${eventDiff})`)\n\t\t\t\t\t\t: chalk.red(`(${eventDiff})`),\n\t\t\t);\n\n\t\t\t// Error comparison\n\t\t\tconst errorDiff = result2.errors - result1.errors;\n\t\t\tconsole.log(\n\t\t\t\tchalk.cyan(`Errors: ${result1.errors} → ${result2.errors} `),\n\t\t\t\terrorDiff === 0\n\t\t\t\t\t? chalk.gray('(no change)')\n\t\t\t\t\t: errorDiff > 0\n\t\t\t\t\t\t? chalk.green(`(+${errorDiff})`)\n\t\t\t\t\t\t: chalk.red(`(${errorDiff})`),\n\t\t\t);\n\n\t\t\tif (options.verbose && abi1._diamondMetadata && abi2._diamondMetadata) {\n\t\t\t\tconsole.log(chalk.blue('\\n🔍 Detailed Selector Comparison:'));\n\t\t\t\tdisplaySelectorChanges(\n\t\t\t\t\tabi1._diamondMetadata.selectorMap ?? {},\n\t\t\t\t\tabi2._diamondMetadata.selectorMap ?? {},\n\t\t\t\t);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconsole.error(chalk.red('❌ Error comparing ABI files:'), error);\n\t\t\tprocess.exit(1);\n\t\t}\n\t});\n\n// Validate command\nprogram\n\t.command('validate')\n\t.description('Validate a diamond ABI file')\n\t.argument('<file>', 'ABI file path')\n\t.option('-v, --verbose', 'Verbose output', false)\n\t.action(async (file, options) => {\n\t\ttry {\n\t\t\tconsole.log(chalk.blue('🔍 Validating Diamond ABI...'));\n\n\t\t\tif (!existsSync(file)) {\n\t\t\t\tthrow new Error(`File not found: ${file}`);\n\t\t\t}\n\n\t\t\tconst artifact = JSON.parse(require('fs').readFileSync(file, 'utf8'));\n\n\t\t\t// Basic structure validation\n\t\t\tconst hasRequiredFields = artifact.abi && artifact.contractName;\n\t\t\tif (!hasRequiredFields) {\n\t\t\t\tthrow new Error('Invalid artifact: missing required fields (abi, contractName)');\n\t\t\t}\n\n\t\t\t// ABI validation with ethers\n\t\t\tconst { Interface } = await import('ethers');\n\t\t\tlet ethersInterface: InstanceType<typeof Interface>;\n\t\t\ttry {\n\t\t\t\tethersInterface = new Interface(artifact.abi);\n\t\t\t} catch (error) {\n\t\t\t\tthrow new Error(`Invalid ABI: ${error}`);\n\t\t\t}\n\n\t\t\tconst analysis = analyzeAbi(artifact);\n\n\t\t\tconsole.log(chalk.green('✅ ABI validation passed!'));\n\t\t\tconsole.log(chalk.blue('\\n📊 ABI Analysis:'));\n\t\t\tconsole.log(chalk.cyan(`  Functions: ${analysis.functions}`));\n\t\t\tconsole.log(chalk.cyan(`  Events: ${analysis.events}`));\n\t\t\tconsole.log(chalk.cyan(`  Errors: ${analysis.errors}`));\n\t\t\tconsole.log(chalk.cyan(`  Total fragments: ${ethersInterface.fragments.length}`));\n\n\t\t\tif (artifact._diamondMetadata) {\n\t\t\t\tconst metadata = artifact._diamondMetadata;\n\t\t\t\tconsole.log(chalk.blue('\\n💎 Diamond Metadata:'));\n\t\t\t\tconsole.log(chalk.cyan(`  Diamond: ${metadata.diamondName}`));\n\t\t\t\tconsole.log(chalk.cyan(`  Network: ${metadata.networkName}`));\n\t\t\t\tconsole.log(chalk.cyan(`  Chain ID: ${metadata.chainId}`));\n\t\t\t\tconsole.log(chalk.cyan(`  Generated: ${metadata.generatedAt}`));\n\n\t\t\t\tif (metadata.selectorMap) {\n\t\t\t\t\tconst selectorCount = Object.keys(metadata.selectorMap).length;\n\t\t\t\t\tconst facetCount = new Set(Object.values(metadata.selectorMap)).size;\n\t\t\t\t\tconsole.log(chalk.cyan(`  Function selectors: ${selectorCount}`));\n\t\t\t\t\tconsole.log(chalk.cyan(`  Facets: ${facetCount}`));\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (options.verbose) {\n\t\t\t\tconsole.log(chalk.blue('\\n🔍 Function Signatures:'));\n\t\t\t\tethersInterface.fragments\n\t\t\t\t\t.filter((f: any) => f.type === 'function')\n\t\t\t\t\t.slice(0, 10) // Show first 10\n\t\t\t\t\t.forEach((f: any) => {\n\t\t\t\t\t\tconsole.log(chalk.gray(`  ${(f as any).format()}`));\n\t\t\t\t\t});\n\n\t\t\t\tif (\n\t\t\t\t\tethersInterface.fragments.filter((f: any) => f.type === 'function').length > 10\n\t\t\t\t) {\n\t\t\t\t\tconsole.log(\n\t\t\t\t\t\tchalk.gray(\n\t\t\t\t\t\t\t`  ... and ${ethersInterface.fragments.filter((f: any) => f.type === 'function').length - 10} more`,\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconsole.error(chalk.red('❌ ABI validation failed:'), error);\n\t\t\tprocess.exit(1);\n\t\t}\n\t});\n\n// Helper functions\nasync function setupDiamondConnection(diamond: Diamond, verbose: boolean): Promise<void> {\n\ttry {\n\t\t// Typed as `any`: the `hre.ethers` helper is added at runtime by the\n\t\t// hardhat-ethers plugin (loaded via the project's hardhat config).\n\t\tconst hre: any = (await import('hardhat')).default;\n\t\tdiamond.setProvider(hre.ethers.provider);\n\t\tconst signers = await hre.ethers.getSigners();\n\t\tif (signers.length > 0) {\n\t\t\tdiamond.setSigner(signers[0]);\n\t\t}\n\n\t\tif (verbose) {\n\t\t\tconsole.log(chalk.gray('✅ Connected to Hardhat provider'));\n\t\t}\n\t} catch (error) {\n\t\tif (verbose) {\n\t\t\tconsole.log(\n\t\t\t\tchalk.yellow('⚠️  Could not connect to provider (running in standalone mode)'),\n\t\t\t);\n\t\t}\n\t}\n}\n\nfunction displayResults(result: any, verbose: boolean): void {\n\tconsole.log(chalk.blue('\\n📊 Generation Results:'));\n\tconsole.log(chalk.cyan(`  Functions: ${result.stats.totalFunctions}`));\n\tconsole.log(chalk.cyan(`  Events: ${result.stats.totalEvents}`));\n\tconsole.log(chalk.cyan(`  Errors: ${result.stats.totalErrors}`));\n\tconsole.log(chalk.cyan(`  Facets: ${result.stats.facetCount}`));\n\n\tif (result.outputPath) {\n\t\tconsole.log(chalk.cyan(`  Output: ${result.outputPath}`));\n\t}\n\n\tif (result.stats.duplicateSelectorsSkipped > 0) {\n\t\tconsole.log(\n\t\t\tchalk.yellow(`  Duplicates skipped: ${result.stats.duplicateSelectorsSkipped}`),\n\t\t);\n\t}\n\n\tif (verbose && result.selectorMap) {\n\t\tconsole.log(chalk.blue('\\n🎯 Function Selector Mapping:'));\n\t\tconst sortedSelectors = Object.entries(result.selectorMap).sort(([, a], [, b]) =>\n\t\t\t(a as string).localeCompare(b as string),\n\t\t);\n\t\tsortedSelectors.slice(0, 20).forEach(([selector, facet]) => {\n\t\t\tconsole.log(chalk.gray(`  ${selector} → ${facet}`));\n\t\t});\n\n\t\tif (sortedSelectors.length > 20) {\n\t\t\tconsole.log(chalk.gray(`  ... and ${sortedSelectors.length - 20} more`));\n\t\t}\n\t}\n}\n\nfunction displaySelectorChanges(\n\toldMap: Record<string, string>,\n\tnewMap: Record<string, string>,\n): void {\n\tconst oldSelectors = new Set(Object.keys(oldMap));\n\tconst newSelectors = new Set(Object.keys(newMap));\n\n\tconst added = Array.from(newSelectors).filter((s) => !oldSelectors.has(s));\n\tconst removed = Array.from(oldSelectors).filter((s) => !newSelectors.has(s));\n\tconst changed = Array.from(oldSelectors).filter(\n\t\t(s) => newSelectors.has(s) && oldMap[s] !== newMap[s],\n\t);\n\n\tif (added.length > 0) {\n\t\tconsole.log(chalk.green(`\\n  ➕ Added (${added.length}):`));\n\t\tadded.slice(0, 10).forEach((selector) => {\n\t\t\tconsole.log(chalk.gray(`    ${selector} → ${newMap[selector]}`));\n\t\t});\n\t\tif (added.length > 10) {\n\t\t\tconsole.log(chalk.gray(`    ... and ${added.length - 10} more`));\n\t\t}\n\t}\n\n\tif (removed.length > 0) {\n\t\tconsole.log(chalk.red(`\\n  ➖ Removed (${removed.length}):`));\n\t\tremoved.slice(0, 10).forEach((selector) => {\n\t\t\tconsole.log(chalk.gray(`    ${selector} → ${oldMap[selector]}`));\n\t\t});\n\t\tif (removed.length > 10) {\n\t\t\tconsole.log(chalk.gray(`    ... and ${removed.length - 10} more`));\n\t\t}\n\t}\n\n\tif (changed.length > 0) {\n\t\tconsole.log(chalk.yellow(`\\n  🔄 Changed (${changed.length}):`));\n\t\tchanged.slice(0, 10).forEach((selector) => {\n\t\t\tconsole.log(chalk.gray(`    ${selector}: ${oldMap[selector]} → ${newMap[selector]}`));\n\t\t});\n\t\tif (changed.length > 10) {\n\t\t\tconsole.log(chalk.gray(`    ... and ${changed.length - 10} more`));\n\t\t}\n\t}\n\n\tif (added.length === 0 && removed.length === 0 && changed.length === 0) {\n\t\tconsole.log(chalk.gray('  No selector changes detected'));\n\t}\n}\n\nfunction analyzeAbi(artifact: any): { functions: number; events: number; errors: number } {\n\tconst abi = artifact.abi ?? [];\n\treturn {\n\t\tfunctions: abi.filter((item: any) => item.type === 'function').length,\n\t\tevents: abi.filter((item: any) => item.type === 'event').length,\n\t\terrors: abi.filter((item: any) => item.type === 'error').length,\n\t};\n}\n\n// Parse command line arguments\nprogram.parse();\n\nexport {};\n"]}

package/dist/resolution/index.d.ts

@@ -0,0 +1,2 @@
+export * from './selectorResolution';
+//# sourceMappingURL=index.d.ts.map

package/dist/resolution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolution/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/resolution/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./selectorResolution"), exports);
+//# sourceMappingURL=index.js.map

package/dist/resolution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resolution/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC","sourcesContent":["export * from './selectorResolution';\n"]}

package/dist/resolution/selectorResolution.d.ts

@@ -0,0 +1,65 @@
+import { FunctionSelectorRegistryEntry, NewDeployedFacets } from '../types';
+/**
+ * Pure selector-resolution core for ERC-2535 diamond deployments.
+ *
+ * Extracted from `BaseDeploymentStrategy` (M1-E1) so the resolution semantics can be
+ * unit-tested without a chain and later promoted into the shared core used by both the
+ * deployment strategy and the planned pre-launch config validator.
+ *
+ * Lifted from the strategy in M1-E1 (behavior-preserving). Status of the original quirks:
+ *   - the deploy-time `deployInclude` whitelist — **REMOVED in M2-E1**: `deployInclude` is now
+ *     **additive** (INV-3); a facet keeps its other selectors (the override is resolved below);
+ *   - the inverted/dead `registryHigherPrioritySplit` (`entry.priority > priority`) — **REMOVED in
+ *     M3-E3**: it never matched a real conflict; the cases it nominally handled fall through to the
+ *     `5b2f7af` Replace branch with the identical result;
+ *   - the `5b2f7af` `Replace`-instead-of-`Add` branch — **verified correct (M3-E1 S-1)**; kept as-is.
+ *
+ * The module takes NO Hardhat/provider dependency (only `ethers` for selector math).
+ */
+/** Map<functionSelector, registry entry>. Mirrors `Diamond.functionSelectorRegistry`. */
+export type SelectorRegistry = Map<string, FunctionSelectorRegistryEntry>;
+/**
+ * Reserved for M3 upgrade/redeploy reconciliation. Today, prior deployed state is carried
+ * by the pre-populated `registry` (entries whose action is `Deployed`). Shape aligned to
+ * `DeployedDiamondData.DeployedFacets` to minimise adapter code when M3 wires it in.
+ */
+export type PriorDeployedState = Record<string, {
+    address?: string;
+    funcSelectors?: string[];
+    version?: number;
+}>;
+/**
+ * Compute a facet's candidate selectors: its raw ABI selectors **minus `deployExclude`**.
+ *
+ * `deployInclude` is **additive** (INV-3, M2-E1) — it does NOT reduce the candidate set; a facet keeps
+ * its other selectors. The override (force-ownership over a higher-priority facet) and the additive
+ * priority resolution both happen in `resolveFunctionSelectorRegistry`. Pure.
+ *
+ * @param facetSelectors  the facet's raw ABI function selectors (4-byte, `0x…`)
+ * @param _deployInclude  the facet's `deployInclude` signatures — accepted for API symmetry; additive
+ *                        (not used to filter the candidate set)
+ * @param deployExclude   function signatures to remove
+ * @returns the candidate selector list (a new array; the input is not mutated)
+ */
+export declare function computeFacetSelectors(facetSelectors: string[], _deployInclude: string[], deployExclude: string[]): string[];
+export interface ResolveRegistryArgs {
+    /** The selector registry to resolve into. Mutated IN PLACE (same contract as before). */
+    registry: SelectorRegistry;
+    /** The newly-deployed facets (with addresses, priorities, include/exclude, funcSelectors). */
+    newDeployedFacets: NewDeployedFacets;
+    /** All facet names currently in the deploy config (used to Remove deleted facets). */
+    facetNames: string[];
+    /**
+     * Reserved for M3 upgrade/redeploy reconciliation. Unused today — prior deployed state
+     * is carried by the pre-populated `registry` (entries with action `Deployed`).
+     */
+    priorDeployedState?: PriorDeployedState;
+}
+/**
+ * Resolve ownership of every function selector across the newly-deployed facets and write
+ * the result (`Add`/`Replace`/`Remove`/`Deployed` actions) into `registry` **in place**.
+ * Pure — no Hardhat/provider. Extracted verbatim from
+ * `BaseDeploymentStrategy.updateFunctionSelectorRegistryTasks`.
+ */
+export declare function resolveFunctionSelectorRegistry(args: ResolveRegistryArgs): void;
+//# sourceMappingURL=selectorResolution.d.ts.map

package/dist/resolution/selectorResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectorResolution.d.ts","sourceRoot":"","sources":["../../src/resolution/selectorResolution.ts"],"names":[],"mappings":"AACA,OAAO,EACN,6BAA6B,EAC7B,iBAAiB,EAEjB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;GAgBG;AAEH,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CACtC,MAAM,EACN;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAChE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACpC,cAAc,EAAE,MAAM,EAAE,EACxB,cAAc,EAAE,MAAM,EAAE,EACxB,aAAa,EAAE,MAAM,EAAE,GACrB,MAAM,EAAE,CAaV;AAED,MAAM,WAAW,mBAAmB;IACnC,yFAAyF;IACzF,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8FAA8F;IAC9F,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,sFAAsF;IACtF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CA0J/E"}