dittory 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 warabi1062
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# dittory
+
+Reactコンポーネントや関数の引数使用状況を静的解析し、**常に同じ値が渡されているパラメータ**を検出するCLIツールです。
+
+## 用途
+
+- 不要なパラメータの発見（デフォルト値化の候補）
+- コードベースのリファクタリング支援
+- APIの簡素化
+
+## インストール
+
+```bash
+npm install -g dittory
+```
+
+## 使い方
+
+```bash
+# srcディレクトリを解析（デフォルト）
+dittory
+
+# 特定のディレクトリを解析
+dittory ./path/to/src
+
+# 最小使用回数を指定（デフォルト: 2）
+dittory --min=3
+
+# 解析対象を指定
+dittory --target=components  # Reactコンポーネントのみ
+dittory --target=functions   # 関数・クラスメソッドのみ
+dittory --target=all         # 両方（デフォルト）
+
+# ヘルプ
+dittory --help
+```
+
+## 出力例
+
+```
+解析対象ディレクトリ: ./src
+最小使用箇所数: 2
+解析対象: all
+
+1. exportされたコンポーネントを収集中...
+   → 15個のコンポーネントを検出
+
+=== 常に同じ値が渡されているprops ===
+
+コンポーネント: Button
+  定義: src/components/Button.tsx
+  prop: variant
+  常に渡される値: "primary"
+  使用箇所: 5箇所
+    - src/pages/Home.tsx:23
+    - src/pages/About.tsx:45
+    ...
+```
+
+## 検出対象
+
+- **Reactコンポーネント**: JSX要素として使用されているコンポーネントのprops
+- **関数**: exportされた関数の引数
+- **クラスメソッド**: exportされたクラスのメソッド引数
+
+## 要件
+
+- Node.js >= 18
+- プロジェクトに `tsconfig.json` が必要
+
+## ライセンス
+
+MIT

package/dist/analyzeProps-YWnY-Mf7.mjs

@@ -0,0 +1,532 @@
+import { Node, SyntaxKind } from "ts-morph";
+
+//#region src/components/getProps.ts
+/**
+* コンポーネントのprops定義を取得する
+*
+* 関数の第一パラメータの型情報からpropsを抽出する。
+* 「Props」などの命名規則に依存せず、TypeScriptの型システムから直接取得するため、
+* どのような命名でもpropsを正確に取得できる。
+*
+* 対応パターン:
+* - function Component(props: Props)
+* - const Component = (props: Props) => ...
+* - React.forwardRef((props, ref) => ...)
+* - React.memo((props) => ...)
+*/
+function getProps(declaration) {
+	let propsParam;
+	if (Node.isFunctionDeclaration(declaration)) {
+		const params = declaration.getParameters();
+		if (params.length > 0) propsParam = params[0];
+	} else if (Node.isVariableDeclaration(declaration)) {
+		const initializer = declaration.getInitializer();
+		if (initializer) {
+			if (Node.isArrowFunction(initializer) || Node.isFunctionExpression(initializer)) {
+				const params = initializer.getParameters();
+				if (params.length > 0) propsParam = params[0];
+			} else if (Node.isCallExpression(initializer)) {
+				const args = initializer.getArguments();
+				for (const arg of args) if (Node.isArrowFunction(arg) || Node.isFunctionExpression(arg)) {
+					const params = arg.getParameters();
+					if (params.length > 0) {
+						propsParam = params[0];
+						break;
+					}
+				}
+			}
+		}
+	}
+	if (!propsParam) return [];
+	return extractPropsFromType(propsParam.getType());
+}
+/**
+* 型からprops定義を抽出する
+*
+* Mapを使用する理由:
+* - 交差型（A & B）の場合、同じprop名が複数の型に存在する可能性がある
+* - 最初に見つかった定義を優先し、重複を排除するためにMapを使用
+* - 抽出後にindexを付与してDefinition配列として返す
+*/
+function extractPropsFromType(type) {
+	const propsMap = /* @__PURE__ */ new Map();
+	collectPropsFromType(type, propsMap);
+	return Array.from(propsMap.values()).map((prop, index) => ({
+		...prop,
+		index
+	}));
+}
+/**
+* 型からpropsを収集する（交差型の場合は再帰的に処理）
+*/
+function collectPropsFromType(type, propsMap) {
+	if (type.isIntersection()) {
+		for (const intersectionType of type.getIntersectionTypes()) collectPropsFromType(intersectionType, propsMap);
+		return;
+	}
+	const properties = type.getProperties();
+	for (const prop of properties) {
+		const propName = prop.getName();
+		const declarations = prop.getDeclarations();
+		let isOptional = false;
+		for (const decl of declarations) if (Node.isPropertySignature(decl) && decl.hasQuestionToken()) {
+			isOptional = true;
+			break;
+		}
+		if (!propsMap.has(propName)) propsMap.set(propName, {
+			name: propName,
+			required: !isOptional
+		});
+	}
+}
+
+//#endregion
+//#region src/extraction/resolveExpressionValue.ts
+/**
+* 引数が渡されなかった場合を表す特別な値
+* 必須/任意を問わず、引数未指定の使用箇所を統一的に扱うために使用
+*/
+const UNDEFINED_VALUE = "undefined";
+/**
+* 関数型の値を表すプレフィックス
+* コールバック関数など、関数が渡された場合は使用箇所ごとにユニークな値として扱う
+* これにより、同じコールバック関数を渡していても「定数」として検出されない
+*/
+const FUNCTION_VALUE_PREFIX = "[function]";
+/**
+* 式の実際の値を解決する
+*
+* 異なるファイルで同じenum値やリテラル値を使用している場合でも、
+* 同一の値として認識できるよう、値を正規化して文字列表現で返す。
+* 同名だが異なる定義（別ファイルの同名enum等）を区別するため、
+* 必要に応じてファイルパスを含めた識別子を返す。
+*/
+function resolveExpressionValue(expression) {
+	const type = expression.getType();
+	if (type.getCallSignatures().length > 0) {
+		const sourceFile = expression.getSourceFile();
+		const line = expression.getStartLineNumber();
+		return `${FUNCTION_VALUE_PREFIX}${sourceFile.getFilePath()}:${line}`;
+	}
+	if (Node.isPropertyAccessExpression(expression)) {
+		const decl = expression.getSymbol()?.getDeclarations()[0];
+		if (decl && Node.isEnumMember(decl)) {
+			const enumDecl = decl.getParent();
+			if (Node.isEnumDeclaration(enumDecl)) {
+				const filePath = enumDecl.getSourceFile().getFilePath();
+				const enumName = enumDecl.getName();
+				const memberName = decl.getName();
+				const value = decl.getValue();
+				return `${filePath}:${enumName}.${memberName}=${JSON.stringify(value)}`;
+			}
+		}
+	}
+	if (Node.isIdentifier(expression)) {
+		if (expression.getText() === "undefined") return UNDEFINED_VALUE;
+		const decl = expression.getSymbol()?.getDeclarations()[0];
+		if (decl && Node.isVariableDeclaration(decl)) {
+			const initializer = decl.getInitializer();
+			return initializer ? initializer.getText().replace(/\s+/g, " ") : `${decl.getSourceFile().getFilePath()}:${expression.getText()}`;
+		}
+		if (decl) return `${decl.getSourceFile().getFilePath()}:${expression.getText()}`;
+	}
+	if (type.isStringLiteral() || type.isNumberLiteral()) return JSON.stringify(type.getLiteralValue());
+	if (type.isBooleanLiteral()) return type.getText();
+	return expression.getText();
+}
+
+//#endregion
+//#region src/extraction/flattenObjectExpression.ts
+/**
+* オブジェクトリテラルを再帰的に解析し、フラットなkey-valueペアを返す
+*
+* @param expression - 解析対象の式ノード
+* @param prefix - キー名のプレフィックス（ネストしたプロパティの親パスを表す）
+* @returns フラット化されたkey-valueペアの配列
+*
+* @example
+* // { a: { b: 1, c: 2 } } → [{ key: "prefix.a.b", value: "1" }, { key: "prefix.a.c", value: "2" }]
+*/
+function flattenObjectExpression(expression, prefix) {
+	if (!Node.isObjectLiteralExpression(expression)) return [{
+		key: prefix,
+		value: resolveExpressionValue(expression)
+	}];
+	return expression.getProperties().flatMap((property) => {
+		if (Node.isPropertyAssignment(property)) {
+			const propertyName = property.getName();
+			const nestedPrefix = prefix ? `${prefix}.${propertyName}` : propertyName;
+			const initializer = property.getInitializer();
+			return initializer ? flattenObjectExpression(initializer, nestedPrefix) : [];
+		}
+		if (Node.isShorthandPropertyAssignment(property)) {
+			const propertyName = property.getName();
+			return [{
+				key: prefix ? `${prefix}.${propertyName}` : propertyName,
+				value: resolveExpressionValue(property.getNameNode())
+			}];
+		}
+		return [];
+	});
+}
+
+//#endregion
+//#region src/extraction/extractUsages.ts
+/**
+* 使用状況を抽出するユーティリティクラス
+*/
+var ExtractUsages = class {
+	/**
+	* 関数呼び出しから引数の使用状況を抽出する
+	*
+	* オブジェクトリテラルの場合は再帰的にフラット化し、
+	* 各プロパティを「引数名.プロパティ名」形式で記録する。
+	*
+	* @param callExpression - 関数呼び出しノード
+	* @param callable - 対象の関数情報
+	* @returns 引数使用状況の配列
+	*/
+	static fromCall(callExpression, callable) {
+		const usages = [];
+		const sourceFile = callExpression.getSourceFile();
+		const args = callExpression.getArguments();
+		for (const param of callable.definitions) {
+			const arg = args[param.index];
+			if (!arg) {
+				usages.push({
+					name: param.name,
+					value: UNDEFINED_VALUE,
+					usageFilePath: sourceFile.getFilePath(),
+					usageLine: callExpression.getStartLineNumber()
+				});
+				continue;
+			}
+			for (const { key, value } of flattenObjectExpression(arg, param.name)) usages.push({
+				name: key,
+				value,
+				usageFilePath: sourceFile.getFilePath(),
+				usageLine: arg.getStartLineNumber()
+			});
+		}
+		return usages;
+	}
+	/**
+	* JSX要素からprops使用状況を抽出する
+	*
+	* @param element - JSX要素ノード
+	* @param definitions - props定義の配列
+	* @returns props使用状況の配列
+	*/
+	static fromJsxElement(element, definitions) {
+		const usages = [];
+		const sourceFile = element.getSourceFile();
+		const attributeMap = /* @__PURE__ */ new Map();
+		for (const attr of element.getAttributes()) if (Node.isJsxAttribute(attr)) attributeMap.set(attr.getNameNode().getText(), attr);
+		for (const prop of definitions) {
+			const attr = attributeMap.get(prop.name);
+			if (!attr) {
+				usages.push({
+					name: prop.name,
+					value: UNDEFINED_VALUE,
+					usageFilePath: sourceFile.getFilePath(),
+					usageLine: element.getStartLineNumber()
+				});
+				continue;
+			}
+			const initializer = attr.getInitializer();
+			if (!initializer) usages.push({
+				name: prop.name,
+				value: "true",
+				usageFilePath: sourceFile.getFilePath(),
+				usageLine: attr.getStartLineNumber()
+			});
+			else if (Node.isJsxExpression(initializer)) {
+				const expression = initializer.getExpression();
+				if (!expression) continue;
+				for (const { key, value } of flattenObjectExpression(expression, prop.name)) usages.push({
+					name: key,
+					value,
+					usageFilePath: sourceFile.getFilePath(),
+					usageLine: attr.getStartLineNumber()
+				});
+			} else usages.push({
+				name: prop.name,
+				value: initializer.getText(),
+				usageFilePath: sourceFile.getFilePath(),
+				usageLine: attr.getStartLineNumber()
+			});
+		}
+		return usages;
+	}
+};
+
+//#endregion
+//#region src/source/fileFilters.ts
+/**
+* ファイルパスがテストファイルまたはStorybookファイルかどうかを判定する
+* - 拡張子が .test.* / .spec.* / .stories.* のファイル
+* - __tests__ / __stories__ フォルダ内のファイル
+*/
+function isTestOrStorybookFile(filePath) {
+	if (/\.(test|spec|stories)\.(ts|tsx|js|jsx)$/.test(filePath)) return true;
+	if (/\b__tests__\b|\b__stories__\b/.test(filePath)) return true;
+	return false;
+}
+
+//#endregion
+//#region src/utils/getSingleValueFromSet.ts
+/**
+* Setから唯一の値を安全に取得する
+*/
+function getSingleValueFromSet(values) {
+	if (values.size !== 1) throw new Error(`Expected exactly 1 value, got ${values.size}`);
+	const [firstValue] = Array.from(values);
+	return firstValue;
+}
+
+//#endregion
+//#region src/analyzer/baseAnalyzer.ts
+/**
+* 分析処理の基底クラス
+*/
+var BaseAnalyzer = class {
+	shouldExcludeFile;
+	minUsages;
+	constructor(options = {}) {
+		this.shouldExcludeFile = options.shouldExcludeFile ?? isTestOrStorybookFile;
+		this.minUsages = options.minUsages ?? 2;
+	}
+	/**
+	* メイン分析処理
+	*
+	* @param declarations - 事前分類済みの宣言配列
+	*/
+	analyze(declarations) {
+		const exported = this.collect(declarations);
+		const groupedMap = this.createGroupedMap(exported);
+		return {
+			constants: this.extractConstants(groupedMap),
+			exported
+		};
+	}
+	/**
+	* 使用状況をグループ化したマップを作成
+	*/
+	createGroupedMap(exported) {
+		const groupedMap = /* @__PURE__ */ new Map();
+		for (const item of exported) {
+			let fileMap = groupedMap.get(item.sourceFilePath);
+			if (!fileMap) {
+				fileMap = /* @__PURE__ */ new Map();
+				groupedMap.set(item.sourceFilePath, fileMap);
+			}
+			const paramMap = /* @__PURE__ */ new Map();
+			for (const [paramName, usages] of Object.entries(item.usages)) {
+				const values = /* @__PURE__ */ new Set();
+				for (const usage of usages) values.add(usage.value);
+				paramMap.set(paramName, {
+					values,
+					usages
+				});
+			}
+			fileMap.set(item.name, paramMap);
+		}
+		return groupedMap;
+	}
+	/**
+	* 常に同じ値が渡されているパラメータを抽出
+	*/
+	extractConstants(groupedMap) {
+		const result = [];
+		for (const [sourceFile, targetMap] of groupedMap) for (const [targetName, paramMap] of targetMap) for (const [paramName, usageData] of paramMap) {
+			if (!(usageData.usages.length >= this.minUsages && usageData.values.size === 1)) continue;
+			const value = getSingleValueFromSet(usageData.values);
+			if (value.startsWith(FUNCTION_VALUE_PREFIX)) continue;
+			result.push({
+				targetName,
+				targetSourceFile: sourceFile,
+				paramName,
+				value,
+				usages: usageData.usages
+			});
+		}
+		return result;
+	}
+};
+
+//#endregion
+//#region src/analyzer/componentAnalyzer.ts
+/**
+* Reactコンポーネントのprops分析を行うAnalyzer
+*
+* exportされたReactコンポーネントを収集し、各コンポーネントのprops使用状況を分析する。
+* 常に同じ値が渡されているpropsを検出し、定数として報告する。
+*
+* @example
+* ```ts
+* const analyzer = new ComponentAnalyzer({ minUsages: 2 });
+* const result = analyzer.analyze(sourceFiles);
+* console.log(result.constants);
+* ```
+*/
+var ComponentAnalyzer = class extends BaseAnalyzer {
+	constructor(options = {}) {
+		super(options);
+	}
+	/**
+	* 事前分類済みの宣言からReactコンポーネントを収集する
+	*
+	* @param declarations - 事前分類済みの宣言配列
+	* @returns exportされたコンポーネントとその使用状況の配列
+	*/
+	collect(declarations) {
+		const exportedComponents = [];
+		for (const classified of declarations) {
+			const { exportName, sourceFile, declaration } = classified;
+			if (!Node.isFunctionDeclaration(declaration) && !Node.isVariableDeclaration(declaration)) continue;
+			const nameNode = declaration.getNameNode();
+			if (!nameNode || !Node.isIdentifier(nameNode)) continue;
+			const references = nameNode.findReferences().flatMap((referencedSymbol) => referencedSymbol.getReferences()).filter((ref) => !this.shouldExcludeFile(ref.getSourceFile().getFilePath()));
+			const props = getProps(declaration);
+			const component = {
+				name: exportName,
+				sourceFilePath: sourceFile.getFilePath(),
+				definitions: props,
+				declaration,
+				usages: {}
+			};
+			const groupedUsages = {};
+			for (const reference of references) {
+				const refNode = reference.getNode();
+				const parent = refNode.getParent();
+				if (!parent) continue;
+				const jsxElement = parent.asKind(SyntaxKind.JsxOpeningElement) ?? parent.asKind(SyntaxKind.JsxSelfClosingElement);
+				if (!jsxElement) continue;
+				if (jsxElement.getTagNameNode() !== refNode) continue;
+				const usages = ExtractUsages.fromJsxElement(jsxElement, component.definitions);
+				for (const usage of usages) {
+					if (!groupedUsages[usage.name]) groupedUsages[usage.name] = [];
+					groupedUsages[usage.name].push(usage);
+				}
+			}
+			component.usages = groupedUsages;
+			exportedComponents.push(component);
+		}
+		return exportedComponents;
+	}
+};
+
+//#endregion
+//#region src/components/isReactComponent.ts
+/**
+* 宣言がReactコンポーネントかどうかを判定する
+* - 関数がJSXを返しているかチェック
+* - React.FC型注釈を持っているかチェック
+*/
+function isReactComponent(declaration) {
+	if (Node.isFunctionDeclaration(declaration)) return containsJsx(declaration);
+	if (Node.isVariableDeclaration(declaration)) {
+		const initializer = declaration.getInitializer();
+		if (!initializer) return false;
+		if (Node.isArrowFunction(initializer) || Node.isFunctionExpression(initializer)) return containsJsx(initializer);
+		if (Node.isCallExpression(initializer)) {
+			const args = initializer.getArguments();
+			for (const arg of args) if (Node.isArrowFunction(arg) || Node.isFunctionExpression(arg)) {
+				if (containsJsx(arg)) return true;
+			}
+		}
+	}
+	return false;
+}
+/**
+* ノード内にJSX要素が含まれているかチェック
+* 効率化: 1回のトラバースで全てのJSX要素をチェック
+*/
+function containsJsx(node) {
+	let hasJsx = false;
+	node.forEachDescendant((descendant) => {
+		if (Node.isJsxElement(descendant) || Node.isJsxSelfClosingElement(descendant) || Node.isJsxFragment(descendant)) {
+			hasJsx = true;
+			return true;
+		}
+	});
+	return hasJsx;
+}
+
+//#endregion
+//#region src/source/classifyDeclarations.ts
+/**
+* ソースファイルからexportされた関数/コンポーネント/クラス宣言を収集し、
+* 種別（react/function/class）を事前に分類する
+*
+* @param sourceFiles - 分析対象のソースファイル配列
+* @returns 分類済みの宣言配列
+*/
+function classifyDeclarations(sourceFiles) {
+	const results = [];
+	for (const sourceFile of sourceFiles) {
+		const exportedDecls = sourceFile.getExportedDeclarations();
+		for (const [exportName, declarations] of exportedDecls) {
+			const funcDecl = declarations.find((decl) => isFunctionLike(decl));
+			if (funcDecl) {
+				if (Node.isFunctionDeclaration(funcDecl) || Node.isVariableDeclaration(funcDecl)) {
+					const type = isReactComponent(funcDecl) ? "react" : "function";
+					results.push({
+						exportName,
+						sourceFile,
+						declaration: funcDecl,
+						type
+					});
+				}
+				continue;
+			}
+			const classDecl = declarations.find((decl) => Node.isClassDeclaration(decl));
+			if (classDecl && Node.isClassDeclaration(classDecl)) results.push({
+				exportName,
+				sourceFile,
+				declaration: classDecl,
+				type: "class"
+			});
+		}
+	}
+	return results;
+}
+/**
+* 宣言が関数的なもの（関数宣言、アロー関数、関数式）かどうかを判定
+*/
+function isFunctionLike(declaration) {
+	if (Node.isFunctionDeclaration(declaration)) return true;
+	if (Node.isVariableDeclaration(declaration)) {
+		const initializer = declaration.getInitializer();
+		if (!initializer) return false;
+		return Node.isArrowFunction(initializer) || Node.isFunctionExpression(initializer) || Node.isCallExpression(initializer);
+	}
+	return false;
+}
+
+//#endregion
+//#region src/analyzeProps.ts
+/**
+* コンポーネントのprops使用状況を解析し、常に同じ値が渡されているpropsを検出する
+*
+* @param sourceFiles - 解析対象のソースファイル配列
+* @param options - オプション設定
+* @returns 解析結果（定数props、統計情報、exportされたコンポーネント）
+*
+* @example
+* const project = new Project();
+* project.addSourceFilesAtPaths("src/**\/*.tsx");
+* const result = analyzePropsCore(project.getSourceFiles());
+*/
+function analyzePropsCore(sourceFiles, options = {}) {
+	const { shouldExcludeFile = isTestOrStorybookFile, minUsages = 2 } = options;
+	const components = classifyDeclarations(sourceFiles).filter((decl) => decl.type === "react");
+	return new ComponentAnalyzer({
+		shouldExcludeFile,
+		minUsages
+	}).analyze(components);
+}
+
+//#endregion
+export { ExtractUsages as a, isTestOrStorybookFile as i, classifyDeclarations as n, BaseAnalyzer as r, analyzePropsCore as t };
+//# sourceMappingURL=analyzeProps-YWnY-Mf7.mjs.map

package/dist/analyzeProps-YWnY-Mf7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeProps-YWnY-Mf7.mjs","names":["propsParam: Node | undefined","usages: Usage[]","groupedMap: GroupedMap","result: Constant[]","exportedComponents: Exported[]","component: Exported","groupedUsages: Record<string, Usage[]>","results: ClassifiedDeclaration[]","type: DeclarationType"],"sources":["../src/components/getProps.ts","../src/extraction/resolveExpressionValue.ts","../src/extraction/flattenObjectExpression.ts","../src/extraction/extractUsages.ts","../src/source/fileFilters.ts","../src/utils/getSingleValueFromSet.ts","../src/analyzer/baseAnalyzer.ts","../src/analyzer/componentAnalyzer.ts","../src/components/isReactComponent.ts","../src/source/classifyDeclarations.ts","../src/analyzeProps.ts"],"sourcesContent":["import { Node, type Type } from \"ts-morph\";\nimport type { Definition } from \"@/types\";\n\n/**\n * コンポーネントのprops定義を取得する\n *\n * 関数の第一パラメータの型情報からpropsを抽出する。\n * 「Props」などの命名規則に依存せず、TypeScriptの型システムから直接取得するため、\n * どのような命名でもpropsを正確に取得できる。\n *\n * 対応パターン:\n * - function Component(props: Props)\n * - const Component = (props: Props) => ...\n * - React.forwardRef((props, ref) => ...)\n * - React.memo((props) => ...)\n */\nexport function getProps(declaration: Node): Definition[] {\n  // 関数宣言、アロー関数、関数式から第一パラメータ（props）を取得\n  let propsParam: Node | undefined;\n\n  if (Node.isFunctionDeclaration(declaration)) {\n    const params = declaration.getParameters();\n    if (params.length > 0) {\n      propsParam = params[0];\n    }\n  } else if (Node.isVariableDeclaration(declaration)) {\n    const initializer = declaration.getInitializer();\n    if (initializer) {\n      if (\n        Node.isArrowFunction(initializer) ||\n        Node.isFunctionExpression(initializer)\n      ) {\n        const params = initializer.getParameters();\n        if (params.length > 0) {\n          propsParam = params[0];\n        }\n      } else if (Node.isCallExpression(initializer)) {\n        // React.forwardRef, React.memo などのラッパー関数の場合\n        const args = initializer.getArguments();\n        for (const arg of args) {\n          if (Node.isArrowFunction(arg) || Node.isFunctionExpression(arg)) {\n            const params = arg.getParameters();\n            if (params.length > 0) {\n              propsParam = params[0];\n              break;\n            }\n          }\n        }\n      }\n    }\n  }\n\n  if (!propsParam) {\n    return [];\n  }\n\n  // パラメータの型情報を取得\n  const propsType = propsParam.getType();\n  return extractPropsFromType(propsType);\n}\n\n/**\n * 型からprops定義を抽出する\n *\n * Mapを使用する理由:\n * - 交差型（A & B）の場合、同じprop名が複数の型に存在する可能性がある\n * - 最初に見つかった定義を優先し、重複を排除するためにMapを使用\n * - 抽出後にindexを付与してDefinition配列として返す\n */\nfunction extractPropsFromType(type: Type): Definition[] {\n  const propsMap = new Map<string, Omit<Definition, \"index\">>();\n\n  collectPropsFromType(type, propsMap);\n\n  return Array.from(propsMap.values()).map((prop, index) => ({\n    ...prop,\n    index,\n  }));\n}\n\n/**\n * 型からpropsを収集する（交差型の場合は再帰的に処理）\n */\nfunction collectPropsFromType(\n  type: Type,\n  propsMap: Map<string, Omit<Definition, \"index\">>,\n): void {\n  if (type.isIntersection()) {\n    for (const intersectionType of type.getIntersectionTypes()) {\n      collectPropsFromType(intersectionType, propsMap);\n    }\n    return;\n  }\n\n  const properties = type.getProperties();\n  for (const prop of properties) {\n    const propName = prop.getName();\n    const declarations = prop.getDeclarations();\n\n    let isOptional = false;\n    for (const decl of declarations) {\n      if (Node.isPropertySignature(decl) && decl.hasQuestionToken()) {\n        isOptional = true;\n        break;\n      }\n    }\n\n    // 同じ名前のpropが既に存在する場合は上書きしない（最初に見つかった定義を優先）\n    if (!propsMap.has(propName)) {\n      propsMap.set(propName, {\n        name: propName,\n        required: !isOptional,\n      });\n    }\n  }\n}\n","import { Node } from \"ts-morph\";\n\n/**\n * 引数が渡されなかった場合を表す特別な値\n * 必須/任意を問わず、引数未指定の使用箇所を統一的に扱うために使用\n */\nexport const UNDEFINED_VALUE = \"undefined\";\n\n/**\n * 関数型の値を表すプレフィックス\n * コールバック関数など、関数が渡された場合は使用箇所ごとにユニークな値として扱う\n * これにより、同じコールバック関数を渡していても「定数」として検出されない\n */\nexport const FUNCTION_VALUE_PREFIX = \"[function]\";\n\n/**\n * 式の実際の値を解決する\n *\n * 異なるファイルで同じenum値やリテラル値を使用している場合でも、\n * 同一の値として認識できるよう、値を正規化して文字列表現で返す。\n * 同名だが異なる定義（別ファイルの同名enum等）を区別するため、\n * 必要に応じてファイルパスを含めた識別子を返す。\n */\nexport function resolveExpressionValue(expression: Node): string {\n  // 関数型の場合は定数として扱わない。\n  // 同じ関数参照でも使用箇所ごとに異なる値として扱うことで、\n  // コールバック関数が「常に同じ値」として誤検出されるのを防ぐ\n  const type = expression.getType();\n  if (type.getCallSignatures().length > 0) {\n    const sourceFile = expression.getSourceFile();\n    const line = expression.getStartLineNumber();\n    return `${FUNCTION_VALUE_PREFIX}${sourceFile.getFilePath()}:${line}`;\n  }\n\n  // PropertyAccessExpression (例: Status.Active) の場合\n  // enum参照を正確に識別するために、ファイルパスを含めた完全修飾名を返す\n  if (Node.isPropertyAccessExpression(expression)) {\n    const symbol = expression.getSymbol();\n    const decl = symbol?.getDeclarations()[0];\n\n    // enum memberの場合は、同名enumの誤認識を防ぐためファイルパスを含める\n    if (decl && Node.isEnumMember(decl)) {\n      const enumDecl = decl.getParent();\n      if (Node.isEnumDeclaration(enumDecl)) {\n        const filePath = enumDecl.getSourceFile().getFilePath();\n        const enumName = enumDecl.getName();\n        const memberName = decl.getName();\n        const value = decl.getValue();\n        // 例: \"/path/to/file.ts:Status.Active=0\"\n        return `${filePath}:${enumName}.${memberName}=${JSON.stringify(value)}`;\n      }\n    }\n  }\n\n  // Identifier (変数参照) の場合\n  // 変数の定義元を辿って実際の値を解決する\n  if (Node.isIdentifier(expression)) {\n    if (expression.getText() === \"undefined\") {\n      return UNDEFINED_VALUE;\n    }\n\n    const symbol = expression.getSymbol();\n    const decl = symbol?.getDeclarations()[0];\n\n    if (decl && Node.isVariableDeclaration(decl)) {\n      const initializer = decl.getInitializer();\n      // 初期化子がある場合はその値を使用（空白は正規化して比較しやすくする）\n      // 初期化子がない場合は、ファイルパス + 変数名で一意に識別\n      return initializer\n        ? initializer.getText().replace(/\\s+/g, \" \")\n        : `${decl.getSourceFile().getFilePath()}:${expression.getText()}`;\n    }\n\n    // パラメータや分割代入など、VariableDeclaration以外の宣言の場合\n    // ファイルパス + 変数名で識別する\n    if (decl) {\n      return `${decl.getSourceFile().getFilePath()}:${expression.getText()}`;\n    }\n  }\n\n  // リテラル型の場合は型情報から値を取得\n  // JSON.stringifyで文字列と数値を区別できる形式にする（\"foo\" vs 42）\n  if (type.isStringLiteral() || type.isNumberLiteral()) {\n    return JSON.stringify(type.getLiteralValue());\n  }\n\n  // booleanリテラルの場合はgetLiteralValue()がundefinedを返すためgetText()を使用\n  if (type.isBooleanLiteral()) {\n    return type.getText();\n  }\n\n  // 上記のいずれにも該当しない場合（オブジェクト、配列、テンプレートリテラル等）\n  // ソースコードのテキストをそのまま返す\n  return expression.getText();\n}\n","import { Node } from \"ts-morph\";\nimport { resolveExpressionValue } from \"@/extraction/resolveExpressionValue\";\n\nexport type FlattenedValue = { key: string; value: string };\n\n/**\n * オブジェクトリテラルを再帰的に解析し、フラットなkey-valueペアを返す\n *\n * @param expression - 解析対象の式ノード\n * @param prefix - キー名のプレフィックス（ネストしたプロパティの親パスを表す）\n * @returns フラット化されたkey-valueペアの配列\n *\n * @example\n * // { a: { b: 1, c: 2 } } → [{ key: \"prefix.a.b\", value: \"1\" }, { key: \"prefix.a.c\", value: \"2\" }]\n */\nexport function flattenObjectExpression(\n  expression: Node,\n  prefix: string,\n): FlattenedValue[] {\n  if (!Node.isObjectLiteralExpression(expression)) {\n    // オブジェクトリテラル以外の場合は単一の値として返す\n    return [{ key: prefix, value: resolveExpressionValue(expression) }];\n  }\n\n  return expression.getProperties().flatMap((property) => {\n    if (Node.isPropertyAssignment(property)) {\n      const propertyName = property.getName();\n      const nestedPrefix = prefix ? `${prefix}.${propertyName}` : propertyName;\n      const initializer = property.getInitializer();\n\n      return initializer\n        ? flattenObjectExpression(initializer, nestedPrefix)\n        : [];\n    }\n\n    if (Node.isShorthandPropertyAssignment(property)) {\n      // { foo } のような省略形\n      const propertyName = property.getName();\n      const nestedPrefix = prefix ? `${prefix}.${propertyName}` : propertyName;\n      return [\n        {\n          key: nestedPrefix,\n          value: resolveExpressionValue(property.getNameNode()),\n        },\n      ];\n    }\n\n    return [];\n  });\n}\n","import {\n  type CallExpression,\n  type JsxAttribute,\n  type JsxOpeningElement,\n  type JsxSelfClosingElement,\n  Node,\n} from \"ts-morph\";\nimport type { Definition, Exported, Usage } from \"@/types\";\nimport { flattenObjectExpression } from \"./flattenObjectExpression\";\nimport { UNDEFINED_VALUE } from \"./resolveExpressionValue\";\n\n/**\n * 使用状況を抽出するユーティリティクラス\n */\nexport class ExtractUsages {\n  /**\n   * 関数呼び出しから引数の使用状況を抽出する\n   *\n   * オブジェクトリテラルの場合は再帰的にフラット化し、\n   * 各プロパティを「引数名.プロパティ名」形式で記録する。\n   *\n   * @param callExpression - 関数呼び出しノード\n   * @param callable - 対象の関数情報\n   * @returns 引数使用状況の配列\n   */\n  static fromCall(callExpression: CallExpression, callable: Exported): Usage[] {\n    const usages: Usage[] = [];\n    const sourceFile = callExpression.getSourceFile();\n    const args = callExpression.getArguments();\n\n    for (const param of callable.definitions) {\n      const arg = args[param.index];\n\n      if (!arg) {\n        // 引数が渡されていない場合はundefinedとして記録\n        usages.push({\n          name: param.name,\n          value: UNDEFINED_VALUE,\n          usageFilePath: sourceFile.getFilePath(),\n          usageLine: callExpression.getStartLineNumber(),\n        });\n        continue;\n      }\n\n      // オブジェクトリテラルの場合は再帰的にフラット化\n      for (const { key, value } of flattenObjectExpression(arg, param.name)) {\n        usages.push({\n          name: key,\n          value,\n          usageFilePath: sourceFile.getFilePath(),\n          usageLine: arg.getStartLineNumber(),\n        });\n      }\n    }\n\n    return usages;\n  }\n\n  /**\n   * JSX要素からprops使用状況を抽出する\n   *\n   * @param element - JSX要素ノード\n   * @param definitions - props定義の配列\n   * @returns props使用状況の配列\n   */\n  static fromJsxElement(\n    element: JsxOpeningElement | JsxSelfClosingElement,\n    definitions: Definition[],\n  ): Usage[] {\n    const usages: Usage[] = [];\n    const sourceFile = element.getSourceFile();\n\n    // JSX属性をMapに変換\n    const attributeMap = new Map<string, JsxAttribute>();\n    for (const attr of element.getAttributes()) {\n      if (Node.isJsxAttribute(attr)) {\n        attributeMap.set(attr.getNameNode().getText(), attr);\n      }\n    }\n\n    // definitionsをループして処理\n    for (const prop of definitions) {\n      const attr = attributeMap.get(prop.name);\n\n      if (!attr) {\n        // 渡されていない場合（required/optional問わず記録）\n        usages.push({\n          name: prop.name,\n          value: UNDEFINED_VALUE,\n          usageFilePath: sourceFile.getFilePath(),\n          usageLine: element.getStartLineNumber(),\n        });\n        continue;\n      }\n\n      // 属性が渡されている場合、値を抽出\n      const initializer = attr.getInitializer();\n\n      if (!initializer) {\n        // boolean shorthand (例: <Component disabled />)\n        usages.push({\n          name: prop.name,\n          value: \"true\",\n          usageFilePath: sourceFile.getFilePath(),\n          usageLine: attr.getStartLineNumber(),\n        });\n      } else if (Node.isJsxExpression(initializer)) {\n        // {expression} 形式\n        const expression = initializer.getExpression();\n        if (!expression) {\n          continue;\n        }\n        for (const { key, value } of flattenObjectExpression(\n          expression,\n          prop.name,\n        )) {\n          usages.push({\n            name: key,\n            value,\n            usageFilePath: sourceFile.getFilePath(),\n            usageLine: attr.getStartLineNumber(),\n          });\n        }\n      } else {\n        // \"string\" 形式\n        usages.push({\n          name: prop.name,\n          value: initializer.getText(),\n          usageFilePath: sourceFile.getFilePath(),\n          usageLine: attr.getStartLineNumber(),\n        });\n      }\n    }\n\n    return usages;\n  }\n}\n","/**\n * ファイルパスがテストファイルまたはStorybookファイルかどうかを判定する\n * - 拡張子が .test.* / .spec.* / .stories.* のファイル\n * - __tests__ / __stories__ フォルダ内のファイル\n */\nexport function isTestOrStorybookFile(filePath: string): boolean {\n  // 拡張子ベースの判定\n  if (/\\.(test|spec|stories)\\.(ts|tsx|js|jsx)$/.test(filePath)) {\n    return true;\n  }\n\n  // フォルダ名ベースの判定\n  if (/\\b__tests__\\b|\\b__stories__\\b/.test(filePath)) {\n    return true;\n  }\n\n  return false;\n}\n","/**\n * Setから唯一の値を安全に取得する\n */\nexport function getSingleValueFromSet(values: Set<string>): string {\n  if (values.size !== 1) {\n    throw new Error(`Expected exactly 1 value, got ${values.size}`);\n  }\n  const [firstValue] = Array.from(values);\n  return firstValue;\n}\n","import { FUNCTION_VALUE_PREFIX } from \"@/extraction/resolveExpressionValue\";\nimport { isTestOrStorybookFile } from \"@/source/fileFilters\";\nimport type {\n  AnalysisResult,\n  AnalyzerOptions,\n  ClassifiedDeclaration,\n  Constant,\n  Exported,\n  FileFilter,\n  Usage,\n} from \"@/types\";\nimport { getSingleValueFromSet } from \"@/utils/getSingleValueFromSet\";\n\n/**\n * 使用データのグループ\n * values.size === 1 の場合、そのパラメータは「定数」として検出される\n */\ninterface UsageData {\n  values: Set<string>;\n  usages: Usage[];\n}\n\n/**\n * 使用状況を階層的にグループ化したマップ\n *\n * 3階層の構造で使用状況を整理する:\n * 1. ソースファイルパス: どのファイルで定義された対象か\n * 2. 対象名: 関数名/コンポーネント名\n * 3. パラメータ名: 各パラメータごとの使用状況\n *\n * この構造により、定数検出時に効率的に走査できる。\n */\ntype GroupedMap = Map<string, Map<string, Map<string, UsageData>>>;\n\n/**\n * 分析処理の基底クラス\n */\nexport abstract class BaseAnalyzer {\n  protected shouldExcludeFile: FileFilter;\n  protected minUsages: number;\n\n  constructor(options: AnalyzerOptions = {}) {\n    this.shouldExcludeFile = options.shouldExcludeFile ?? isTestOrStorybookFile;\n    this.minUsages = options.minUsages ?? 2;\n  }\n\n  /**\n   * メイン分析処理\n   *\n   * @param declarations - 事前分類済みの宣言配列\n   */\n  analyze(declarations: ClassifiedDeclaration[]): AnalysisResult {\n    // 1. エクスポートされた対象を収集\n    const exported = this.collect(declarations);\n\n    // 2. 使用状況をグループ化\n    const groupedMap = this.createGroupedMap(exported);\n\n    // 3. 常に同じ値が渡されているパラメータを抽出\n    const constants = this.extractConstants(groupedMap);\n\n    // 4. 結果を構築\n    return { constants, exported };\n  }\n\n  /**\n   * エクスポートされた対象を収集する（サブクラスで実装）\n   *\n   * @param declarations - 事前分類済みの宣言配列\n   */\n  protected abstract collect(declarations: ClassifiedDeclaration[]): Exported[];\n\n  /**\n   * 使用状況をグループ化したマップを作成\n   */\n  private createGroupedMap(exported: Exported[]): GroupedMap {\n    const groupedMap: GroupedMap = new Map();\n\n    for (const item of exported) {\n      let fileMap = groupedMap.get(item.sourceFilePath);\n      if (!fileMap) {\n        fileMap = new Map();\n        groupedMap.set(item.sourceFilePath, fileMap);\n      }\n\n      const paramMap = new Map<string, UsageData>();\n      for (const [paramName, usages] of Object.entries(item.usages)) {\n        const values = new Set<string>();\n        for (const usage of usages) {\n          values.add(usage.value);\n        }\n        paramMap.set(paramName, { values, usages });\n      }\n      fileMap.set(item.name, paramMap);\n    }\n\n    return groupedMap;\n  }\n\n  /**\n   * 常に同じ値が渡されているパラメータを抽出\n   */\n  private extractConstants(groupedMap: GroupedMap): Constant[] {\n    const result: Constant[] = [];\n\n    for (const [sourceFile, targetMap] of groupedMap) {\n      for (const [targetName, paramMap] of targetMap) {\n        for (const [paramName, usageData] of paramMap) {\n          const isConstant =\n            usageData.usages.length >= this.minUsages &&\n            usageData.values.size === 1;\n\n          if (!isConstant) {\n            continue;\n          }\n\n          const value = getSingleValueFromSet(usageData.values);\n\n          // 関数型の値は定数として報告しない\n          // （onClickに同じハンドラを渡している等は、デフォルト値化の候補ではない）\n          if (value.startsWith(FUNCTION_VALUE_PREFIX)) {\n            continue;\n          }\n\n          result.push({\n            targetName,\n            targetSourceFile: sourceFile,\n            paramName,\n            value,\n            usages: usageData.usages,\n          });\n        }\n      }\n    }\n\n    return result;\n  }\n}\n","import { Node, SyntaxKind } from \"ts-morph\";\nimport { getProps } from \"@/components/getProps\";\nimport { ExtractUsages } from \"@/extraction/extractUsages\";\nimport type {\n  AnalyzerOptions,\n  ClassifiedDeclaration,\n  Exported,\n  Usage,\n} from \"@/types\";\nimport { BaseAnalyzer } from \"./baseAnalyzer\";\n\n/**\n * Reactコンポーネントのprops分析を行うAnalyzer\n *\n * exportされたReactコンポーネントを収集し、各コンポーネントのprops使用状況を分析する。\n * 常に同じ値が渡されているpropsを検出し、定数として報告する。\n *\n * @example\n * ```ts\n * const analyzer = new ComponentAnalyzer({ minUsages: 2 });\n * const result = analyzer.analyze(sourceFiles);\n * console.log(result.constants);\n * ```\n */\nexport class ComponentAnalyzer extends BaseAnalyzer {\n  constructor(options: AnalyzerOptions = {}) {\n    super(options);\n  }\n\n  /**\n   * 事前分類済みの宣言からReactコンポーネントを収集する\n   *\n   * @param declarations - 事前分類済みの宣言配列\n   * @returns exportされたコンポーネントとその使用状況の配列\n   */\n  protected collect(declarations: ClassifiedDeclaration[]): Exported[] {\n    const exportedComponents: Exported[] = [];\n\n    for (const classified of declarations) {\n      const { exportName, sourceFile, declaration } = classified;\n\n      // FunctionDeclaration または VariableDeclaration のみを処理\n      if (\n        !Node.isFunctionDeclaration(declaration) &&\n        !Node.isVariableDeclaration(declaration)\n      ) {\n        continue;\n      }\n\n      // コンポーネントの定義から名前ノードを取得\n      const nameNode = declaration.getNameNode();\n      if (!nameNode || !Node.isIdentifier(nameNode)) {\n        continue;\n      }\n\n      // 名前ノードから全参照を検索し、除外対象ファイルからの参照をフィルタ\n      const references = nameNode\n        .findReferences()\n        .flatMap((referencedSymbol) => referencedSymbol.getReferences())\n        .filter(\n          (ref) => !this.shouldExcludeFile(ref.getSourceFile().getFilePath()),\n        );\n\n      // コンポーネントの宣言からprops定義を取得\n      const props = getProps(declaration);\n\n      const component: Exported = {\n        name: exportName,\n        sourceFilePath: sourceFile.getFilePath(),\n        definitions: props,\n        declaration,\n        usages: {},\n      };\n\n      // 参照からJSX要素を抽出し、usagesをprop名ごとにグループ化\n      const groupedUsages: Record<string, Usage[]> = {};\n      for (const reference of references) {\n        const refNode = reference.getNode();\n        const parent = refNode.getParent();\n        if (!parent) {\n          continue;\n        }\n\n        // <Component> または <Component /> の形でJSX要素として使われているかチェック\n        const jsxElement =\n          parent.asKind(SyntaxKind.JsxOpeningElement) ??\n          parent.asKind(SyntaxKind.JsxSelfClosingElement);\n\n        if (!jsxElement) {\n          continue;\n        }\n\n        // タグ名ノードが参照ノードと一致するか確認\n        const tagNameNode = jsxElement.getTagNameNode();\n        if (tagNameNode !== refNode) {\n          continue;\n        }\n\n        // JSX要素からprops使用状況を抽出\n        const usages = ExtractUsages.fromJsxElement(\n          jsxElement,\n          component.definitions,\n        );\n        for (const usage of usages) {\n          if (!groupedUsages[usage.name]) {\n            groupedUsages[usage.name] = [];\n          }\n          groupedUsages[usage.name].push(usage);\n        }\n      }\n\n      component.usages = groupedUsages;\n      exportedComponents.push(component);\n    }\n\n    return exportedComponents;\n  }\n}\n","import { Node } from \"ts-morph\";\n\n/**\n * 宣言がReactコンポーネントかどうかを判定する\n * - 関数がJSXを返しているかチェック\n * - React.FC型注釈を持っているかチェック\n */\nexport function isReactComponent(declaration: Node): boolean {\n  // 関数宣言の場合\n  if (Node.isFunctionDeclaration(declaration)) {\n    return containsJsx(declaration);\n  }\n\n  // 変数宣言の場合 (const Button = ...)\n  if (Node.isVariableDeclaration(declaration)) {\n    const initializer = declaration.getInitializer();\n    if (!initializer) return false;\n\n    // アロー関数または関数式の場合\n    if (\n      Node.isArrowFunction(initializer) ||\n      Node.isFunctionExpression(initializer)\n    ) {\n      return containsJsx(initializer);\n    }\n\n    // React.forwardRef, React.memo などのラッパー関数の場合\n    if (Node.isCallExpression(initializer)) {\n      const args = initializer.getArguments();\n      for (const arg of args) {\n        if (Node.isArrowFunction(arg) || Node.isFunctionExpression(arg)) {\n          if (containsJsx(arg)) return true;\n        }\n      }\n    }\n  }\n\n  return false;\n}\n\n/**\n * ノード内にJSX要素が含まれているかチェック\n * 効率化: 1回のトラバースで全てのJSX要素をチェック\n */\nfunction containsJsx(node: Node): boolean {\n  let hasJsx = false;\n\n  node.forEachDescendant((descendant) => {\n    if (\n      Node.isJsxElement(descendant) ||\n      Node.isJsxSelfClosingElement(descendant) ||\n      Node.isJsxFragment(descendant)\n    ) {\n      hasJsx = true;\n      return true; // 早期終了\n    }\n    return undefined;\n  });\n\n  return hasJsx;\n}\n","import { Node, type SourceFile } from \"ts-morph\";\nimport { isReactComponent } from \"@/components/isReactComponent\";\nimport type { ClassifiedDeclaration, DeclarationType } from \"@/types\";\n\n/**\n * ソースファイルからexportされた関数/コンポーネント/クラス宣言を収集し、\n * 種別（react/function/class）を事前に分類する\n *\n * @param sourceFiles - 分析対象のソースファイル配列\n * @returns 分類済みの宣言配列\n */\nexport function classifyDeclarations(\n  sourceFiles: SourceFile[],\n): ClassifiedDeclaration[] {\n  const results: ClassifiedDeclaration[] = [];\n\n  for (const sourceFile of sourceFiles) {\n    const exportedDecls = sourceFile.getExportedDeclarations();\n\n    for (const [exportName, declarations] of exportedDecls) {\n      // 関数宣言または変数宣言（アロー関数/関数式）を見つける\n      const funcDecl = declarations.find((decl) => isFunctionLike(decl));\n\n      if (funcDecl) {\n        if (\n          Node.isFunctionDeclaration(funcDecl) ||\n          Node.isVariableDeclaration(funcDecl)\n        ) {\n          const type: DeclarationType = isReactComponent(funcDecl)\n            ? \"react\"\n            : \"function\";\n          results.push({\n            exportName,\n            sourceFile,\n            declaration: funcDecl,\n            type,\n          });\n        }\n        continue;\n      }\n\n      // クラス宣言を見つける\n      const classDecl = declarations.find((decl) =>\n        Node.isClassDeclaration(decl),\n      );\n\n      if (classDecl && Node.isClassDeclaration(classDecl)) {\n        results.push({\n          exportName,\n          sourceFile,\n          declaration: classDecl,\n          type: \"class\",\n        });\n      }\n    }\n  }\n\n  return results;\n}\n\n/**\n * 宣言が関数的なもの（関数宣言、アロー関数、関数式）かどうかを判定\n */\nfunction isFunctionLike(declaration: Node): boolean {\n  if (Node.isFunctionDeclaration(declaration)) {\n    return true;\n  }\n\n  if (Node.isVariableDeclaration(declaration)) {\n    const initializer = declaration.getInitializer();\n    if (!initializer) {\n      return false;\n    }\n\n    return (\n      Node.isArrowFunction(initializer) ||\n      Node.isFunctionExpression(initializer) ||\n      Node.isCallExpression(initializer) // React.forwardRef, React.memo など\n    );\n  }\n\n  return false;\n}\n","import type { SourceFile } from \"ts-morph\";\nimport { ComponentAnalyzer } from \"@/analyzer/componentAnalyzer\";\nimport { classifyDeclarations } from \"@/source/classifyDeclarations\";\nimport { isTestOrStorybookFile } from \"@/source/fileFilters\";\nimport type { AnalysisResult, FileFilter } from \"@/types\";\n\ninterface AnalyzePropsOptions {\n  shouldExcludeFile?: FileFilter;\n  minUsages?: number;\n}\n\n/**\n * コンポーネントのprops使用状況を解析し、常に同じ値が渡されているpropsを検出する\n *\n * @param sourceFiles - 解析対象のソースファイル配列\n * @param options - オプション設定\n * @returns 解析結果（定数props、統計情報、exportされたコンポーネント）\n *\n * @example\n * const project = new Project();\n * project.addSourceFilesAtPaths(\"src/**\\/*.tsx\");\n * const result = analyzePropsCore(project.getSourceFiles());\n */\nexport function analyzePropsCore(\n  sourceFiles: SourceFile[],\n  options: AnalyzePropsOptions = {},\n): AnalysisResult {\n  const { shouldExcludeFile = isTestOrStorybookFile, minUsages = 2 } = options;\n\n  // 宣言を事前分類し、Reactコンポーネントのみ抽出\n  const declarations = classifyDeclarations(sourceFiles);\n  const components = declarations.filter((decl) => decl.type === \"react\");\n\n  const analyzer = new ComponentAnalyzer({\n    shouldExcludeFile,\n    minUsages,\n  });\n\n  return analyzer.analyze(components);\n}\n"],"mappings":"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"}

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,427 @@
+#!/usr/bin/env node
+import { a as ExtractUsages, i as isTestOrStorybookFile, n as classifyDeclarations, r as BaseAnalyzer, t as analyzePropsCore } from "./analyzeProps-YWnY-Mf7.mjs";
+import { Node, Project, SyntaxKind } from "ts-morph";
+import fs from "node:fs";
+import path from "node:path";
+
+//#region src/analyzer/classMethodAnalyzer.ts
+/**
+* クラスメソッドの引数分析を行うAnalyzer
+*
+* exportされたクラスのメソッド（static/instance）を収集し、
+* 各メソッドの引数使用状況を分析する。
+* 常に同じ値が渡されている引数を検出し、定数として報告する。
+*
+* @example
+* ```ts
+* const analyzer = new ClassMethodAnalyzer({ minUsages: 2 });
+* const result = analyzer.analyze(declarations);
+* console.log(result.constants);
+* ```
+*/
+var ClassMethodAnalyzer = class extends BaseAnalyzer {
+	constructor(options = {}) {
+		super(options);
+	}
+	/**
+	* 事前分類済みの宣言からクラスメソッドを収集する
+	*
+	* @param declarations - 事前分類済みの宣言配列（type: "class"）
+	* @returns クラスメソッドとその使用状況の配列（名前は「ClassName.methodName」形式）
+	*/
+	collect(declarations) {
+		const results = [];
+		for (const classified of declarations) {
+			const { exportName, sourceFile, declaration } = classified;
+			if (!Node.isClassDeclaration(declaration)) continue;
+			const methods = declaration.getMethods();
+			for (const method of methods) {
+				const methodName = method.getName();
+				const parameters = this.getParameters(method);
+				const callable = {
+					name: `${exportName}.${methodName}`,
+					sourceFilePath: sourceFile.getFilePath(),
+					definitions: parameters,
+					declaration: method,
+					usages: {}
+				};
+				const nameNode = method.getNameNode();
+				if (!Node.isIdentifier(nameNode)) continue;
+				const references = nameNode.findReferences().flatMap((referencedSymbol) => referencedSymbol.getReferences()).filter((ref) => !this.shouldExcludeFile(ref.getSourceFile().getFilePath()));
+				const groupedUsages = {};
+				for (const reference of references) {
+					const propertyAccess = reference.getNode().getParent();
+					if (!propertyAccess || !Node.isPropertyAccessExpression(propertyAccess)) continue;
+					const callExpression = propertyAccess.getParent();
+					if (!callExpression || !Node.isCallExpression(callExpression)) continue;
+					if (callExpression.getExpression() !== propertyAccess) continue;
+					const usages = ExtractUsages.fromCall(callExpression, callable);
+					for (const usage of usages) {
+						if (!groupedUsages[usage.name]) groupedUsages[usage.name] = [];
+						groupedUsages[usage.name].push(usage);
+					}
+				}
+				callable.usages = groupedUsages;
+				results.push(callable);
+			}
+		}
+		return results;
+	}
+	/**
+	* メソッドのパラメータ定義を取得する
+	*/
+	getParameters(method) {
+		return this.extractParameterDeclarations(method).map((param, index) => ({
+			name: param.getName(),
+			index,
+			required: !param.hasQuestionToken() && !param.hasInitializer()
+		}));
+	}
+	/**
+	* メソッド宣言からParameterDeclarationの配列を抽出する
+	*/
+	extractParameterDeclarations(method) {
+		if (Node.isMethodDeclaration(method)) return method.getParameters();
+		return [];
+	}
+};
+
+//#endregion
+//#region src/analyzer/functionAnalyzer.ts
+/**
+* 関数の引数分析を行うAnalyzer
+*
+* exportされた関数を収集し、各関数の引数使用状況を分析する。
+* 常に同じ値が渡されている引数を検出し、定数として報告する。
+*
+* @example
+* ```ts
+* const analyzer = new FunctionAnalyzer({ minUsages: 2 });
+* const result = analyzer.analyze(declarations);
+* console.log(result.constants);
+* ```
+*/
+var FunctionAnalyzer = class extends BaseAnalyzer {
+	constructor(options = {}) {
+		super(options);
+	}
+	/**
+	* 事前分類済みの宣言から関数を収集する
+	*
+	* @param declarations - 事前分類済みの宣言配列（type: "function"）
+	* @returns exportされた関数とその使用状況の配列
+	*/
+	collect(declarations) {
+		const results = [];
+		for (const classified of declarations) {
+			const { exportName, sourceFile, declaration } = classified;
+			if (!Node.isFunctionDeclaration(declaration) && !Node.isVariableDeclaration(declaration)) continue;
+			const nameNode = declaration.getNameNode();
+			if (!nameNode || !Node.isIdentifier(nameNode)) continue;
+			const references = nameNode.findReferences().flatMap((referencedSymbol) => referencedSymbol.getReferences()).filter((ref) => !this.shouldExcludeFile(ref.getSourceFile().getFilePath()));
+			const parameters = this.getParameters(declaration);
+			const callable = {
+				name: exportName,
+				sourceFilePath: sourceFile.getFilePath(),
+				definitions: parameters,
+				declaration,
+				usages: {}
+			};
+			const groupedUsages = {};
+			for (const reference of references) {
+				const refNode = reference.getNode();
+				const parent = refNode.getParent();
+				if (!parent) continue;
+				const callExpression = parent.asKind(SyntaxKind.CallExpression);
+				if (!callExpression) continue;
+				if (callExpression.getExpression() !== refNode) continue;
+				const usages = ExtractUsages.fromCall(callExpression, callable);
+				for (const usage of usages) {
+					if (!groupedUsages[usage.name]) groupedUsages[usage.name] = [];
+					groupedUsages[usage.name].push(usage);
+				}
+			}
+			callable.usages = groupedUsages;
+			results.push(callable);
+		}
+		return results;
+	}
+	/**
+	* 関数のパラメータ定義を取得する
+	*/
+	getParameters(declaration) {
+		return this.extractParameterDeclarations(declaration).map((param, index) => ({
+			name: param.getName(),
+			index,
+			required: !param.hasQuestionToken() && !param.hasInitializer()
+		}));
+	}
+	/**
+	* 宣言からParameterDeclarationの配列を抽出する
+	*/
+	extractParameterDeclarations(declaration) {
+		if (Node.isFunctionDeclaration(declaration)) return declaration.getParameters();
+		if (Node.isVariableDeclaration(declaration)) {
+			const initializer = declaration.getInitializer();
+			if (initializer) {
+				if (Node.isArrowFunction(initializer) || Node.isFunctionExpression(initializer)) return initializer.getParameters();
+			}
+		}
+		return [];
+	}
+};
+
+//#endregion
+//#region src/analyzeFunctions.ts
+/**
+* 関数・クラスメソッドの引数使用状況を解析し、常に同じ値が渡されている引数を検出する
+*
+* @param sourceFiles - 解析対象のソースファイル配列
+* @param options - オプション設定
+* @returns 解析結果（定数引数、統計情報、exportされた関数・メソッド）
+*
+* @example
+* const project = new Project();
+* project.addSourceFilesAtPaths("src/**\/*.ts");
+* const result = analyzeFunctionsCore(project.getSourceFiles());
+*/
+function analyzeFunctionsCore(sourceFiles, options = {}) {
+	const { shouldExcludeFile = isTestOrStorybookFile, minUsages = 2 } = options;
+	const declarations = classifyDeclarations(sourceFiles);
+	const functions = declarations.filter((decl) => decl.type === "function");
+	const classes = declarations.filter((decl) => decl.type === "class");
+	const analyzerOptions = {
+		shouldExcludeFile,
+		minUsages
+	};
+	const functionResult = new FunctionAnalyzer(analyzerOptions).analyze(functions);
+	const classMethodResult = new ClassMethodAnalyzer(analyzerOptions).analyze(classes);
+	return {
+		constants: [...functionResult.constants, ...classMethodResult.constants],
+		exported: [...functionResult.exported, ...classMethodResult.exported]
+	};
+}
+
+//#endregion
+//#region src/cli/parseCliOptions.ts
+var CliValidationError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "CliValidationError";
+	}
+};
+const VALID_TARGETS = [
+	"all",
+	"components",
+	"functions"
+];
+/** 不明なオプションの検出に使用 */
+const VALID_OPTIONS = [
+	"--min",
+	"--target",
+	"--help"
+];
+/**
+* CLIオプションをパースする
+*
+* @throws {CliValidationError} オプションが無効な場合
+*/
+function parseCliOptions(args) {
+	let targetDir = path.join(process.cwd(), "src");
+	let minUsages = 2;
+	let target = "all";
+	let showHelp = false;
+	for (const arg of args) {
+		if (arg === "--help") {
+			showHelp = true;
+			continue;
+		}
+		if (arg.startsWith("--min=")) {
+			const valueStr = arg.slice(6);
+			const value = Number.parseInt(valueStr, 10);
+			if (valueStr === "" || Number.isNaN(value)) throw new CliValidationError(`--min の値が無効です: "${valueStr}" (数値を指定してください)`);
+			if (value < 1) throw new CliValidationError(`--min の値は1以上である必要があります: ${value}`);
+			minUsages = value;
+		} else if (arg.startsWith("--target=")) {
+			const value = arg.slice(9);
+			if (!VALID_TARGETS.includes(value)) throw new CliValidationError(`--target の値が無効です: "${value}" (有効な値: ${VALID_TARGETS.join(", ")})`);
+			target = value;
+		} else if (arg.startsWith("--")) {
+			const optionName = arg.split("=")[0];
+			if (!VALID_OPTIONS.includes(optionName)) throw new CliValidationError(`不明なオプション: ${optionName}`);
+		} else targetDir = arg;
+	}
+	return {
+		targetDir,
+		minUsages,
+		target,
+		showHelp
+	};
+}
+/**
+* 対象ディレクトリの存在を検証する
+*
+* @throws {CliValidationError} ディレクトリが存在しない、またはディレクトリでない場合
+*/
+function validateTargetDir(targetDir) {
+	if (!fs.existsSync(targetDir)) throw new CliValidationError(`ディレクトリが存在しません: ${targetDir}`);
+	if (!fs.statSync(targetDir).isDirectory()) throw new CliValidationError(`指定されたパスはディレクトリではありません: ${targetDir}`);
+}
+/**
+* ヘルプメッセージを取得する
+*/
+function getHelpMessage() {
+	return `
+Usage: dittory [options] [directory]
+
+Options:
+  --min=<number>    最小使用箇所数 (デフォルト: 2)
+  --target=<mode>   解析対象: all, components, functions (デフォルト: all)
+  --help            このヘルプを表示
+
+Arguments:
+  directory         解析対象ディレクトリ (デフォルト: ./src)
+`;
+}
+
+//#endregion
+//#region src/output/printAnalysisResult.ts
+/**
+* exportされたコンポーネントの一覧を出力
+*/
+function printExportedComponents(exported) {
+	const lines = [
+		"1. exportされたコンポーネントを収集中...",
+		`   → ${exported.length}個のコンポーネントを検出`,
+		...exported.map((comp) => `      - ${comp.name} (${path.relative(process.cwd(), comp.sourceFilePath)})`),
+		""
+	];
+	console.log(lines.join("\n"));
+}
+/**
+* 常に同じ値が渡されているpropsを出力
+*/
+function printConstantProps(constants) {
+	console.log("=== 常に同じ値が渡されているprops ===\n");
+	if (constants.length === 0) {
+		console.log("常に同じ値が渡されているpropsは見つかりませんでした。");
+		return;
+	}
+	for (const prop of constants) {
+		const relativeComponentPath = path.relative(process.cwd(), prop.targetSourceFile);
+		console.log(`コンポーネント: ${prop.targetName}`);
+		console.log(`  定義: ${relativeComponentPath}`);
+		console.log(`  prop: ${prop.paramName}`);
+		console.log(`  常に渡される値: ${prop.value}`);
+		console.log(`  使用箇所: ${prop.usages.length}箇所`);
+		for (const usage of prop.usages) {
+			const relativePath = path.relative(process.cwd(), usage.usageFilePath);
+			console.log(`    - ${relativePath}:${usage.usageLine}`);
+		}
+		console.log("");
+	}
+}
+/**
+* 解析結果を全て出力
+*/
+function printAnalysisResult(result) {
+	printExportedComponents(result.exported);
+	printConstantProps(result.constants);
+}
+/**
+* exportされた関数の一覧を出力
+*/
+function printExportedFunctions(exported) {
+	const lines = [
+		"2. exportされた関数を収集中...",
+		`   → ${exported.length}個の関数を検出`,
+		...exported.map((fn) => `      - ${fn.name} (${path.relative(process.cwd(), fn.sourceFilePath)})`),
+		""
+	];
+	console.log(lines.join("\n"));
+}
+/**
+* 常に同じ値が渡されている引数を出力
+*/
+function printConstantArguments(constants) {
+	console.log("=== 常に同じ値が渡されている引数 ===\n");
+	if (constants.length === 0) {
+		console.log("常に同じ値が渡されている引数は見つかりませんでした。");
+		return;
+	}
+	for (const arg of constants) {
+		const relativeFunctionPath = path.relative(process.cwd(), arg.targetSourceFile);
+		console.log(`関数: ${arg.targetName}`);
+		console.log(`  定義: ${relativeFunctionPath}`);
+		console.log(`  引数: ${arg.paramName}`);
+		console.log(`  常に渡される値: ${arg.value}`);
+		console.log(`  使用箇所: ${arg.usages.length}箇所`);
+		for (const usage of arg.usages) {
+			const relativePath = path.relative(process.cwd(), usage.usageFilePath);
+			console.log(`    - ${relativePath}:${usage.usageLine}`);
+		}
+		console.log("");
+	}
+}
+/**
+* 関数解析結果を全て出力
+*/
+function printFunctionAnalysisResult(result) {
+	printExportedFunctions(result.exported);
+	printConstantArguments(result.constants);
+}
+
+//#endregion
+//#region src/source/createFilteredSourceFiles.ts
+/**
+* プロジェクトを初期化し、フィルタリングされたソースファイルを取得する
+*/
+function createFilteredSourceFiles(targetDir, shouldExcludeFile = isTestOrStorybookFile) {
+	const project = new Project({
+		tsConfigFilePath: path.join(process.cwd(), "tsconfig.json"),
+		skipAddingFilesFromTsConfig: true
+	});
+	project.addSourceFilesAtPaths(`${targetDir}/**/*.{ts,tsx,js,jsx}`);
+	return project.getSourceFiles().filter((sourceFile) => !shouldExcludeFile(sourceFile.getFilePath()));
+}
+
+//#endregion
+//#region src/cli.ts
+/**
+* エラーメッセージを表示してプロセスを終了する
+*/
+function exitWithError(message) {
+	console.error(`エラー: ${message}`);
+	process.exit(1);
+}
+function main() {
+	let options;
+	try {
+		options = parseCliOptions(process.argv.slice(2));
+	} catch (error) {
+		if (error instanceof CliValidationError) exitWithError(error.message);
+		throw error;
+	}
+	const { targetDir, minUsages, target, showHelp } = options;
+	if (showHelp) {
+		console.log(getHelpMessage());
+		process.exit(0);
+	}
+	try {
+		validateTargetDir(targetDir);
+	} catch (error) {
+		if (error instanceof CliValidationError) exitWithError(error.message);
+		throw error;
+	}
+	console.log(`解析対象ディレクトリ: ${targetDir}`);
+	console.log(`最小使用箇所数: ${minUsages}`);
+	console.log(`解析対象: ${target}\n`);
+	const sourceFilesToAnalyze = createFilteredSourceFiles(targetDir);
+	if (target === "all" || target === "components") printAnalysisResult(analyzePropsCore(sourceFilesToAnalyze, { minUsages }));
+	if (target === "all" || target === "functions") printFunctionAnalysisResult(analyzeFunctionsCore(sourceFilesToAnalyze, { minUsages }));
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["results: Exported[]","callable: Exported","groupedUsages: Record<string, Usage[]>","results: Exported[]","callable: Exported","groupedUsages: Record<string, Usage[]>","VALID_TARGETS: readonly AnalyzeMode[]","VALID_OPTIONS: readonly string[]","target: AnalyzeMode","options: CliOptions"],"sources":["../src/analyzer/classMethodAnalyzer.ts","../src/analyzer/functionAnalyzer.ts","../src/analyzeFunctions.ts","../src/cli/parseCliOptions.ts","../src/output/printAnalysisResult.ts","../src/source/createFilteredSourceFiles.ts","../src/cli.ts"],"sourcesContent":["import { Node, type ParameterDeclaration } from \"ts-morph\";\nimport { ExtractUsages } from \"@/extraction/extractUsages\";\nimport type {\n  AnalyzerOptions,\n  ClassifiedDeclaration,\n  Definition,\n  Exported,\n  Usage,\n} from \"@/types\";\nimport { BaseAnalyzer } from \"./baseAnalyzer\";\n\n/**\n * クラスメソッドの引数分析を行うAnalyzer\n *\n * exportされたクラスのメソッド（static/instance）を収集し、\n * 各メソッドの引数使用状況を分析する。\n * 常に同じ値が渡されている引数を検出し、定数として報告する。\n *\n * @example\n * ```ts\n * const analyzer = new ClassMethodAnalyzer({ minUsages: 2 });\n * const result = analyzer.analyze(declarations);\n * console.log(result.constants);\n * ```\n */\nexport class ClassMethodAnalyzer extends BaseAnalyzer {\n  constructor(options: AnalyzerOptions = {}) {\n    super(options);\n  }\n\n  /**\n   * 事前分類済みの宣言からクラスメソッドを収集する\n   *\n   * @param declarations - 事前分類済みの宣言配列（type: \"class\"）\n   * @returns クラスメソッドとその使用状況の配列（名前は「ClassName.methodName」形式）\n   */\n  protected collect(declarations: ClassifiedDeclaration[]): Exported[] {\n    const results: Exported[] = [];\n\n    for (const classified of declarations) {\n      const { exportName, sourceFile, declaration } = classified;\n\n      if (!Node.isClassDeclaration(declaration)) {\n        continue;\n      }\n\n      const methods = declaration.getMethods();\n\n      for (const method of methods) {\n        const methodName = method.getName();\n        const parameters = this.getParameters(method);\n\n        const callable: Exported = {\n          name: `${exportName}.${methodName}`,\n          sourceFilePath: sourceFile.getFilePath(),\n          definitions: parameters,\n          declaration: method,\n          usages: {},\n        };\n\n        // メソッド名から参照を検索\n        const nameNode = method.getNameNode();\n        if (!Node.isIdentifier(nameNode)) {\n          continue;\n        }\n\n        // 名前ノードから全参照を検索し、除外対象ファイルからの参照をフィルタ\n        const references = nameNode\n          .findReferences()\n          .flatMap((referencedSymbol) => referencedSymbol.getReferences())\n          .filter(\n            (ref) => !this.shouldExcludeFile(ref.getSourceFile().getFilePath()),\n          );\n\n        // 参照からメソッド呼び出しを抽出し、usagesをパラメータ名ごとにグループ化\n        const groupedUsages: Record<string, Usage[]> = {};\n        for (const reference of references) {\n          const refNode = reference.getNode();\n\n          // obj.method の形でPropertyAccessExpressionの一部かチェック\n          const propertyAccess = refNode.getParent();\n          if (\n            !propertyAccess ||\n            !Node.isPropertyAccessExpression(propertyAccess)\n          ) {\n            continue;\n          }\n\n          // obj.method(...) の形でCallExpressionかチェック\n          const callExpression = propertyAccess.getParent();\n          if (!callExpression || !Node.isCallExpression(callExpression)) {\n            continue;\n          }\n\n          // 呼び出し対象がPropertyAccessExpressionと一致するか確認\n          if (callExpression.getExpression() !== propertyAccess) {\n            continue;\n          }\n\n          // メソッド呼び出しから引数使用状況を抽出\n          const usages = ExtractUsages.fromCall(callExpression, callable);\n          for (const usage of usages) {\n            if (!groupedUsages[usage.name]) {\n              groupedUsages[usage.name] = [];\n            }\n            groupedUsages[usage.name].push(usage);\n          }\n        }\n\n        callable.usages = groupedUsages;\n        results.push(callable);\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * メソッドのパラメータ定義を取得する\n   */\n  private getParameters(method: Node): Definition[] {\n    const params = this.extractParameterDeclarations(method);\n\n    return params.map((param, index) => ({\n      name: param.getName(),\n      index,\n      required: !param.hasQuestionToken() && !param.hasInitializer(),\n    }));\n  }\n\n  /**\n   * メソッド宣言からParameterDeclarationの配列を抽出する\n   */\n  private extractParameterDeclarations(method: Node): ParameterDeclaration[] {\n    if (Node.isMethodDeclaration(method)) {\n      return method.getParameters();\n    }\n\n    return [];\n  }\n}\n","import { Node, type ParameterDeclaration, SyntaxKind } from \"ts-morph\";\nimport { ExtractUsages } from \"@/extraction/extractUsages\";\nimport type {\n  AnalyzerOptions,\n  ClassifiedDeclaration,\n  Definition,\n  Exported,\n  Usage,\n} from \"@/types\";\nimport { BaseAnalyzer } from \"./baseAnalyzer\";\n\n/**\n * 関数の引数分析を行うAnalyzer\n *\n * exportされた関数を収集し、各関数の引数使用状況を分析する。\n * 常に同じ値が渡されている引数を検出し、定数として報告する。\n *\n * @example\n * ```ts\n * const analyzer = new FunctionAnalyzer({ minUsages: 2 });\n * const result = analyzer.analyze(declarations);\n * console.log(result.constants);\n * ```\n */\nexport class FunctionAnalyzer extends BaseAnalyzer {\n  constructor(options: AnalyzerOptions = {}) {\n    super(options);\n  }\n\n  /**\n   * 事前分類済みの宣言から関数を収集する\n   *\n   * @param declarations - 事前分類済みの宣言配列（type: \"function\"）\n   * @returns exportされた関数とその使用状況の配列\n   */\n  protected collect(declarations: ClassifiedDeclaration[]): Exported[] {\n    const results: Exported[] = [];\n\n    for (const classified of declarations) {\n      const { exportName, sourceFile, declaration } = classified;\n\n      // FunctionDeclaration または VariableDeclaration のみを処理\n      if (\n        !Node.isFunctionDeclaration(declaration) &&\n        !Node.isVariableDeclaration(declaration)\n      ) {\n        continue;\n      }\n\n      // 関数の定義から名前ノードを取得\n      const nameNode = declaration.getNameNode();\n      if (!nameNode || !Node.isIdentifier(nameNode)) {\n        continue;\n      }\n\n      // 名前ノードから全参照を検索し、除外対象ファイルからの参照をフィルタ\n      const references = nameNode\n        .findReferences()\n        .flatMap((referencedSymbol) => referencedSymbol.getReferences())\n        .filter(\n          (ref) => !this.shouldExcludeFile(ref.getSourceFile().getFilePath()),\n        );\n\n      // 関数の宣言からパラメータ定義を取得\n      const parameters = this.getParameters(declaration);\n\n      const callable: Exported = {\n        name: exportName,\n        sourceFilePath: sourceFile.getFilePath(),\n        definitions: parameters,\n        declaration,\n        usages: {},\n      };\n\n      // 参照から関数呼び出しを抽出し、usagesをパラメータ名ごとにグループ化\n      const groupedUsages: Record<string, Usage[]> = {};\n      for (const reference of references) {\n        const refNode = reference.getNode();\n        const parent = refNode.getParent();\n        if (!parent) {\n          continue;\n        }\n\n        // func(...) の形で関数呼び出しとして使われているかチェック\n        const callExpression = parent.asKind(SyntaxKind.CallExpression);\n        if (!callExpression) {\n          continue;\n        }\n\n        // 呼び出し対象が参照ノードと一致するか確認\n        const expression = callExpression.getExpression();\n        if (expression !== refNode) {\n          continue;\n        }\n\n        // 関数呼び出しから引数使用状況を抽出\n        const usages = ExtractUsages.fromCall(callExpression, callable);\n        for (const usage of usages) {\n          if (!groupedUsages[usage.name]) {\n            groupedUsages[usage.name] = [];\n          }\n          groupedUsages[usage.name].push(usage);\n        }\n      }\n\n      callable.usages = groupedUsages;\n      results.push(callable);\n    }\n\n    return results;\n  }\n\n  /**\n   * 関数のパラメータ定義を取得する\n   */\n  private getParameters(declaration: Node): Definition[] {\n    const params = this.extractParameterDeclarations(declaration);\n\n    return params.map((param, index) => ({\n      name: param.getName(),\n      index,\n      required: !param.hasQuestionToken() && !param.hasInitializer(),\n    }));\n  }\n\n  /**\n   * 宣言からParameterDeclarationの配列を抽出する\n   */\n  private extractParameterDeclarations(\n    declaration: Node,\n  ): ParameterDeclaration[] {\n    if (Node.isFunctionDeclaration(declaration)) {\n      return declaration.getParameters();\n    }\n\n    if (Node.isVariableDeclaration(declaration)) {\n      const initializer = declaration.getInitializer();\n      if (initializer) {\n        if (\n          Node.isArrowFunction(initializer) ||\n          Node.isFunctionExpression(initializer)\n        ) {\n          return initializer.getParameters();\n        }\n      }\n    }\n\n    return [];\n  }\n}\n","import type { SourceFile } from \"ts-morph\";\nimport { ClassMethodAnalyzer } from \"@/analyzer/classMethodAnalyzer\";\nimport { FunctionAnalyzer } from \"@/analyzer/functionAnalyzer\";\nimport { classifyDeclarations } from \"@/source/classifyDeclarations\";\nimport { isTestOrStorybookFile } from \"@/source/fileFilters\";\nimport type { AnalysisResult, FileFilter } from \"@/types\";\n\ninterface AnalyzeFunctionsOptions {\n  shouldExcludeFile?: FileFilter;\n  minUsages?: number;\n}\n\n/**\n * 関数・クラスメソッドの引数使用状況を解析し、常に同じ値が渡されている引数を検出する\n *\n * @param sourceFiles - 解析対象のソースファイル配列\n * @param options - オプション設定\n * @returns 解析結果（定数引数、統計情報、exportされた関数・メソッド）\n *\n * @example\n * const project = new Project();\n * project.addSourceFilesAtPaths(\"src/**\\/*.ts\");\n * const result = analyzeFunctionsCore(project.getSourceFiles());\n */\nexport function analyzeFunctionsCore(\n  sourceFiles: SourceFile[],\n  options: AnalyzeFunctionsOptions = {},\n): AnalysisResult {\n  const { shouldExcludeFile = isTestOrStorybookFile, minUsages = 2 } = options;\n\n  // 宣言を事前分類\n  const declarations = classifyDeclarations(sourceFiles);\n  const functions = declarations.filter((decl) => decl.type === \"function\");\n  const classes = declarations.filter((decl) => decl.type === \"class\");\n\n  const analyzerOptions = { shouldExcludeFile, minUsages };\n\n  // 関数を分析\n  const functionAnalyzer = new FunctionAnalyzer(analyzerOptions);\n  const functionResult = functionAnalyzer.analyze(functions);\n\n  // クラスメソッドを分析\n  const classMethodAnalyzer = new ClassMethodAnalyzer(analyzerOptions);\n  const classMethodResult = classMethodAnalyzer.analyze(classes);\n\n  // 結果をマージ\n  return {\n    constants: [...functionResult.constants, ...classMethodResult.constants],\n    exported: [...functionResult.exported, ...classMethodResult.exported],\n  };\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport type AnalyzeMode = \"all\" | \"components\" | \"functions\";\n\nexport interface CliOptions {\n  targetDir: string;\n  minUsages: number;\n  target: AnalyzeMode;\n  showHelp: boolean;\n}\n\nexport class CliValidationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CliValidationError\";\n  }\n}\n\nconst VALID_TARGETS: readonly AnalyzeMode[] = [\n  \"all\",\n  \"components\",\n  \"functions\",\n];\n\n/** 不明なオプションの検出に使用 */\nconst VALID_OPTIONS: readonly string[] = [\"--min\", \"--target\", \"--help\"];\n\n/**\n * CLIオプションをパースする\n *\n * @throws {CliValidationError} オプションが無効な場合\n */\nexport function parseCliOptions(args: string[]): CliOptions {\n  let targetDir = path.join(process.cwd(), \"src\");\n  let minUsages = 2;\n  let target: AnalyzeMode = \"all\";\n  let showHelp = false;\n\n  for (const arg of args) {\n    if (arg === \"--help\") {\n      showHelp = true;\n      continue;\n    }\n\n    if (arg.startsWith(\"--min=\")) {\n      const valueStr = arg.slice(6);\n      const value = Number.parseInt(valueStr, 10);\n\n      if (valueStr === \"\" || Number.isNaN(value)) {\n        throw new CliValidationError(\n          `--min の値が無効です: \"${valueStr}\" (数値を指定してください)`,\n        );\n      }\n      if (value < 1) {\n        throw new CliValidationError(\n          `--min の値は1以上である必要があります: ${value}`,\n        );\n      }\n\n      minUsages = value;\n    } else if (arg.startsWith(\"--target=\")) {\n      const value = arg.slice(9);\n\n      if (!VALID_TARGETS.includes(value as AnalyzeMode)) {\n        throw new CliValidationError(\n          `--target の値が無効です: \"${value}\" (有効な値: ${VALID_TARGETS.join(\", \")})`,\n        );\n      }\n\n      target = value as AnalyzeMode;\n    } else if (arg.startsWith(\"--\")) {\n      const optionName = arg.split(\"=\")[0];\n\n      if (!VALID_OPTIONS.includes(optionName)) {\n        throw new CliValidationError(`不明なオプション: ${optionName}`);\n      }\n    } else {\n      targetDir = arg;\n    }\n  }\n\n  return { targetDir, minUsages, target, showHelp };\n}\n\n/**\n * 対象ディレクトリの存在を検証する\n *\n * @throws {CliValidationError} ディレクトリが存在しない、またはディレクトリでない場合\n */\nexport function validateTargetDir(targetDir: string): void {\n  if (!fs.existsSync(targetDir)) {\n    throw new CliValidationError(`ディレクトリが存在しません: ${targetDir}`);\n  }\n\n  const stat = fs.statSync(targetDir);\n  if (!stat.isDirectory()) {\n    throw new CliValidationError(\n      `指定されたパスはディレクトリではありません: ${targetDir}`,\n    );\n  }\n}\n\n/**\n * ヘルプメッセージを取得する\n */\nexport function getHelpMessage(): string {\n  return `\nUsage: dittory [options] [directory]\n\nOptions:\n  --min=<number>    最小使用箇所数 (デフォルト: 2)\n  --target=<mode>   解析対象: all, components, functions (デフォルト: all)\n  --help            このヘルプを表示\n\nArguments:\n  directory         解析対象ディレクトリ (デフォルト: ./src)\n`;\n}\n","import path from \"node:path\";\nimport type { AnalysisResult, Constant, Exported } from \"@/types\";\n\n/**\n * exportされたコンポーネントの一覧を出力\n */\nexport function printExportedComponents(exported: Exported[]): void {\n  const lines = [\n    \"1. exportされたコンポーネントを収集中...\",\n    `   → ${exported.length}個のコンポーネントを検出`,\n    ...exported.map(\n      (comp) =>\n        `      - ${comp.name} (${path.relative(process.cwd(), comp.sourceFilePath)})`,\n    ),\n    \"\",\n  ];\n  console.log(lines.join(\"\\n\"));\n}\n\n/**\n * 常に同じ値が渡されているpropsを出力\n */\nexport function printConstantProps(constants: Constant[]): void {\n  console.log(\"=== 常に同じ値が渡されているprops ===\\n\");\n\n  if (constants.length === 0) {\n    console.log(\"常に同じ値が渡されているpropsは見つかりませんでした。\");\n    return;\n  }\n\n  for (const prop of constants) {\n    const relativeComponentPath = path.relative(\n      process.cwd(),\n      prop.targetSourceFile,\n    );\n\n    console.log(`コンポーネント: ${prop.targetName}`);\n    console.log(`  定義: ${relativeComponentPath}`);\n    console.log(`  prop: ${prop.paramName}`);\n    console.log(`  常に渡される値: ${prop.value}`);\n    console.log(`  使用箇所: ${prop.usages.length}箇所`);\n\n    for (const usage of prop.usages) {\n      const relativePath = path.relative(process.cwd(), usage.usageFilePath);\n      console.log(`    - ${relativePath}:${usage.usageLine}`);\n    }\n\n    console.log(\"\");\n  }\n}\n\n/**\n * 解析結果を全て出力\n */\nexport function printAnalysisResult(result: AnalysisResult): void {\n  printExportedComponents(result.exported);\n  printConstantProps(result.constants);\n}\n\n/**\n * exportされた関数の一覧を出力\n */\nexport function printExportedFunctions(exported: Exported[]): void {\n  const lines = [\n    \"2. exportされた関数を収集中...\",\n    `   → ${exported.length}個の関数を検出`,\n    ...exported.map(\n      (fn) =>\n        `      - ${fn.name} (${path.relative(process.cwd(), fn.sourceFilePath)})`,\n    ),\n    \"\",\n  ];\n  console.log(lines.join(\"\\n\"));\n}\n\n/**\n * 常に同じ値が渡されている引数を出力\n */\nexport function printConstantArguments(constants: Constant[]): void {\n  console.log(\"=== 常に同じ値が渡されている引数 ===\\n\");\n\n  if (constants.length === 0) {\n    console.log(\"常に同じ値が渡されている引数は見つかりませんでした。\");\n    return;\n  }\n\n  for (const arg of constants) {\n    const relativeFunctionPath = path.relative(\n      process.cwd(),\n      arg.targetSourceFile,\n    );\n\n    console.log(`関数: ${arg.targetName}`);\n    console.log(`  定義: ${relativeFunctionPath}`);\n    console.log(`  引数: ${arg.paramName}`);\n    console.log(`  常に渡される値: ${arg.value}`);\n    console.log(`  使用箇所: ${arg.usages.length}箇所`);\n\n    for (const usage of arg.usages) {\n      const relativePath = path.relative(process.cwd(), usage.usageFilePath);\n      console.log(`    - ${relativePath}:${usage.usageLine}`);\n    }\n\n    console.log(\"\");\n  }\n}\n\n/**\n * 関数解析結果を全て出力\n */\nexport function printFunctionAnalysisResult(result: AnalysisResult): void {\n  printExportedFunctions(result.exported);\n  printConstantArguments(result.constants);\n}\n","import path from \"node:path\";\nimport { Project, type SourceFile } from \"ts-morph\";\nimport { isTestOrStorybookFile } from \"@/source/fileFilters\";\nimport type { FileFilter } from \"@/types\";\n\n/**\n * プロジェクトを初期化し、フィルタリングされたソースファイルを取得する\n */\nexport function createFilteredSourceFiles(\n  targetDir: string,\n  shouldExcludeFile: FileFilter = isTestOrStorybookFile,\n): SourceFile[] {\n  // プロジェクトを初期化\n  const project = new Project({\n    tsConfigFilePath: path.join(process.cwd(), \"tsconfig.json\"),\n    skipAddingFilesFromTsConfig: true,\n  });\n\n  // 対象ディレクトリのファイルを追加\n  project.addSourceFilesAtPaths(`${targetDir}/**/*.{ts,tsx,js,jsx}`);\n\n  // ファイルをフィルタリング\n  const allSourceFiles = project.getSourceFiles();\n  const sourceFilesToAnalyze = allSourceFiles.filter(\n    (sourceFile) => !shouldExcludeFile(sourceFile.getFilePath()),\n  );\n\n  return sourceFilesToAnalyze;\n}\n","#!/usr/bin/env node\nimport { analyzeFunctionsCore } from \"@/analyzeFunctions\";\nimport { analyzePropsCore } from \"@/analyzeProps\";\nimport {\n  type CliOptions,\n  CliValidationError,\n  getHelpMessage,\n  parseCliOptions,\n  validateTargetDir,\n} from \"@/cli/parseCliOptions\";\nimport {\n  printAnalysisResult,\n  printFunctionAnalysisResult,\n} from \"@/output/printAnalysisResult\";\nimport { createFilteredSourceFiles } from \"@/source/createFilteredSourceFiles\";\n\n/**\n * エラーメッセージを表示してプロセスを終了する\n */\nfunction exitWithError(message: string): never {\n  console.error(`エラー: ${message}`);\n  process.exit(1);\n}\n\nfunction main(): void {\n  let options: CliOptions;\n\n  try {\n    options = parseCliOptions(process.argv.slice(2));\n  } catch (error) {\n    if (error instanceof CliValidationError) {\n      exitWithError(error.message);\n    }\n    throw error;\n  }\n\n  const { targetDir, minUsages, target, showHelp } = options;\n\n  if (showHelp) {\n    console.log(getHelpMessage());\n    process.exit(0);\n  }\n\n  // 対象ディレクトリの存在を検証\n  try {\n    validateTargetDir(targetDir);\n  } catch (error) {\n    if (error instanceof CliValidationError) {\n      exitWithError(error.message);\n    }\n    throw error;\n  }\n\n  console.log(`解析対象ディレクトリ: ${targetDir}`);\n  console.log(`最小使用箇所数: ${minUsages}`);\n  console.log(`解析対象: ${target}\\n`);\n\n  const sourceFilesToAnalyze = createFilteredSourceFiles(targetDir);\n\n  if (target === \"all\" || target === \"components\") {\n    const propsResult = analyzePropsCore(sourceFilesToAnalyze, { minUsages });\n    printAnalysisResult(propsResult);\n  }\n\n  if (target === \"all\" || target === \"functions\") {\n    const functionsResult = analyzeFunctionsCore(sourceFilesToAnalyze, {\n      minUsages,\n    });\n    printFunctionAnalysisResult(functionsResult);\n  }\n}\n\nmain();\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,80 @@
+import { FunctionDeclaration, MethodDeclaration, SourceFile, VariableDeclaration } from "ts-morph";
+
+//#region src/types.d.ts
+
+/**
+ * ファイルパスを受け取り、除外すべきかどうかを判定する関数の型
+ */
+type FileFilter = (filePath: string) => boolean;
+/**
+ * 使用箇所の共通interface
+ * 関数呼び出しやJSX要素で、どのパラメータにどの値が渡されたかを記録する
+ */
+interface Usage {
+  /** ネストしたプロパティの場合は "param.nested.key" 形式 */
+  name: string;
+  /** リテラル値、enum参照、変数参照などを解決した結果 */
+  value: string;
+  usageFilePath: string;
+  usageLine: number;
+}
+/**
+ * パラメータ/props定義の共通interface
+ */
+interface Definition {
+  name: string;
+  /** 引数リストにおける位置（0始まり） */
+  index: number;
+  /** ?がなく、デフォルト値もない場合はtrue */
+  required: boolean;
+}
+/**
+ * エクスポートされた対象の共通interface
+ */
+interface Exported {
+  /** クラスメソッドの場合は "ClassName.methodName" 形式 */
+  name: string;
+  sourceFilePath: string;
+  definitions: Definition[];
+  declaration: FunctionDeclaration | VariableDeclaration | MethodDeclaration;
+  usages: Record<string, Usage[]>;
+}
+/**
+ * 常に同じ値が渡されているパラメータ（デフォルト値化の候補）
+ */
+interface Constant {
+  targetName: string;
+  targetSourceFile: string;
+  paramName: string;
+  value: string;
+  usages: Usage[];
+}
+/**
+ * 分析結果
+ */
+interface AnalysisResult {
+  constants: Constant[];
+  exported: Exported[];
+}
+//#endregion
+//#region src/analyzeProps.d.ts
+interface AnalyzePropsOptions {
+  shouldExcludeFile?: FileFilter;
+  minUsages?: number;
+}
+/**
+ * コンポーネントのprops使用状況を解析し、常に同じ値が渡されているpropsを検出する
+ *
+ * @param sourceFiles - 解析対象のソースファイル配列
+ * @param options - オプション設定
+ * @returns 解析結果（定数props、統計情報、exportされたコンポーネント）
+ *
+ * @example
+ * const project = new Project();
+ * project.addSourceFilesAtPaths("src/**\/*.tsx");
+ * const result = analyzePropsCore(project.getSourceFiles());
+ */
+declare function analyzePropsCore(sourceFiles: SourceFile[], options?: AnalyzePropsOptions): AnalysisResult;
+//#endregion
+export { type AnalysisResult, type Constant, type Definition, type Exported, type FileFilter, type Usage, analyzePropsCore };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { t as analyzePropsCore } from "./analyzeProps-YWnY-Mf7.mjs";
+
+export { analyzePropsCore };

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "dittory",
+  "version": "0.0.1",
+  "description": "Reactコンポーネントのprops使用状況を解析し、常に同じ値が渡されているpropsを検出するツール",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "bin": {
+    "dittory": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown && node ./dist/cli.mjs",
+    "lint": "biome check --write src",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
+  "keywords": [
+    "react",
+    "props",
+    "analyzer",
+    "static-analysis",
+    "typescript"
+  ],
+  "author": "warabi1062",
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "repository": "github:warabi1062/dittory",
+  "packageManager": "pnpm@10.6.4",
+  "devDependencies": {
+    "@biomejs/biome": "2.3.10",
+    "@types/node": "^25.0.3",
+    "@types/react": "^19.2.7",
+    "react": "^19.2.3",
+    "tsdown": "^0.18.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "dependencies": {
+    "ts-morph": "^27.0.2"
+  }
+}