dittory 0.0.2 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analyzeProps-6k4QTasK.mjs","names":["current: Node | undefined","resolvedValue: ArgValue | undefined","value: ArgValue","callSiteMap: CallSiteMap","paramNames: string[]","missingValues: FlattenedValue[]","result: FlattenedValue[]","current: Node | undefined","usages: Usage[]","VALID_VALUE_TYPES: readonly ValueType[]","groupedMap: GroupedMap","result: Constant[]","results: Exported[]","callable: Exported","groupedUsages: Record<string, Usage[]>","results: Exported[]","callable: Exported","groupedUsages: Record<string, Usage[]>","results: ClassifiedDeclaration[]","type: DeclarationType","propsParam: Node | undefined","exportedComponents: Exported[]","component: Exported","groupedUsages: Record<string, Usage[]>"],"sources":["../src/source/fileFilters.ts","../src/extraction/parameterUtils.ts","../src/extraction/callSiteCollector.ts","../src/extraction/resolveExpressionValue.ts","../src/extraction/flattenObjectExpression.ts","../src/extraction/hasDisableComment.ts","../src/extraction/extractUsages.ts","../src/utils/getSingleValueFromSet.ts","../src/utils/valueTypeDetector.ts","../src/analyzer/baseAnalyzer.ts","../src/analyzer/classMethodAnalyzer.ts","../src/analyzer/functionAnalyzer.ts","../src/components/isReactComponent.ts","../src/source/classifyDeclarations.ts","../src/analyzeFunctions.ts","../src/components/getProps.ts","../src/analyzer/componentAnalyzer.ts","../src/analyzeProps.ts"],"sourcesContent":["/**\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","import { Node, SyntaxKind } from \"ts-morph\";\nimport {\n type ArgValue,\n ArgValueType,\n type CallSiteMap,\n} from \"./callSiteCollector\";\n\n/**\n * 式がパラメータ(関数の引数)を参照しているかどうかを判定する\n * ネストしたプロパティアクセス(例: props.nested.value)にも対応\n */\nexport function isParameterReference(expression: Node): boolean {\n if (Node.isIdentifier(expression)) {\n const symbol = expression.getSymbol();\n const decl = symbol?.getDeclarations()[0];\n if (!decl) return false;\n const kind = decl.getKind();\n return kind === SyntaxKind.Parameter || kind === SyntaxKind.BindingElement;\n }\n if (Node.isPropertyAccessExpression(expression)) {\n return isParameterReference(expression.getExpression());\n }\n return false;\n}\n\n/**\n * 式を含む関数宣言を見つける\n */\nexport function findContainingFunction(node: Node): Node | undefined {\n let current: Node | undefined = node;\n while (current) {\n if (\n Node.isFunctionDeclaration(current) ||\n Node.isArrowFunction(current) ||\n Node.isFunctionExpression(current) ||\n Node.isMethodDeclaration(current)\n ) {\n return current;\n }\n current = current.getParent();\n }\n return undefined;\n}\n\n/**\n * 関数スコープから関数名を取得する\n */\nexport function getFunctionName(functionScope: Node): string {\n if (Node.isFunctionDeclaration(functionScope)) {\n return functionScope.getName() ?? \"anonymous\";\n }\n if (\n Node.isArrowFunction(functionScope) ||\n Node.isFunctionExpression(functionScope)\n ) {\n const parent = functionScope.getParent();\n if (parent && Node.isVariableDeclaration(parent)) {\n return parent.getName();\n }\n return \"anonymous\";\n }\n if (Node.isMethodDeclaration(functionScope)) {\n const className = functionScope\n .getParent()\n ?.asKind(SyntaxKind.ClassDeclaration)\n ?.getName();\n const methodName = functionScope.getName();\n return className ? `${className}.${methodName}` : methodName;\n }\n return \"anonymous\";\n}\n\n/**\n * 式からパラメータパスを構築\n * 例: props.nested.value → \"props.nested.value\"\n */\nexport function buildParameterPath(expression: Node): string {\n if (Node.isIdentifier(expression)) {\n return expression.getText();\n }\n if (Node.isPropertyAccessExpression(expression)) {\n const left = buildParameterPath(expression.getExpression());\n const right = expression.getName();\n return `${left}.${right}`;\n }\n return expression.getText();\n}\n\n/**\n * パラメータ参照の ArgValue を作成する\n */\nexport function createParamRefValue(expression: Node): ArgValue {\n const sourceFile = expression.getSourceFile();\n const filePath = sourceFile.getFilePath();\n const functionScope = findContainingFunction(expression);\n\n if (!functionScope) {\n return { type: ArgValueType.Literal, value: expression.getText() };\n }\n\n const functionName = getFunctionName(functionScope);\n const path = buildParameterPath(expression);\n\n return { type: ArgValueType.ParamRef, filePath, functionName, path };\n}\n\n/**\n * ArgValue を比較可能な文字列キーに変換\n * 同じ値かどうかの判定に使用\n */\nexport function argValueToKey(value: ArgValue): string {\n switch (value.type) {\n case ArgValueType.Literal:\n return `literal:${value.value}`;\n case ArgValueType.Function:\n return `function:${value.filePath}:${value.line}`;\n case ArgValueType.ParamRef:\n return `paramRef:${value.filePath}:${value.functionName}:${value.path}`;\n case ArgValueType.Undefined:\n return \"undefined\";\n }\n}\n\n/**\n * パラメータ参照を解決する\n * callSiteMapを使って、パラメータに渡されたすべての値を取得し、\n * すべて同じ値ならその値を返す。異なる値があればundefinedを返す。\n *\n * @param argValue - 解決対象の ArgValue\n * @param callSiteMap - 呼び出し情報マップ\n * @param visited - 循環参照防止用のセット\n * @returns 解決された ArgValue。異なる値がある場合や解決できない場合はundefined\n */\nexport function resolveParameterValue(\n argValue: ArgValue,\n callSiteMap: CallSiteMap,\n visited: Set<string> = new Set(),\n): ArgValue | undefined {\n // パラメータ参照でない場合はそのまま返す\n if (argValue.type !== ArgValueType.ParamRef) {\n return argValue;\n }\n\n // 循環参照を防ぐ\n const key = argValueToKey(argValue);\n if (visited.has(key)) {\n return undefined;\n }\n visited.add(key);\n\n const { filePath, functionName, path } = argValue;\n const targetId = `${filePath}:${functionName}`;\n const callSiteInfo = callSiteMap.get(targetId);\n\n if (!callSiteInfo) {\n return undefined;\n }\n\n // パラメータパスからプロパティ名を抽出\n // 例: \"props.number\" → \"number\", \"a\" → \"a\"\n const paramParts = path.split(\".\");\n // JSXの場合は props.xxx 形式なので最後のプロパティ名を使用\n // 通常関数の場合は最初の名前がそのまま引数名\n const propName =\n paramParts.length > 1 ? paramParts[paramParts.length - 1] : paramParts[0];\n\n const args = callSiteInfo.get(propName);\n if (!args || args.length === 0) {\n return undefined;\n }\n\n // すべての呼び出し箇所で渡された値を収集\n const resolvedKeys = new Set<string>();\n let resolvedValue: ArgValue | undefined;\n\n for (const arg of args) {\n // 再帰的にパラメータ参照を解決\n const resolved = resolveParameterValue(\n arg.value,\n callSiteMap,\n new Set(visited),\n );\n if (resolved === undefined) {\n return undefined;\n }\n\n const resolvedKey = argValueToKey(resolved);\n resolvedKeys.add(resolvedKey);\n resolvedValue = resolved;\n }\n\n // すべて同じ値なら、その値を返す\n if (resolvedKeys.size === 1) {\n return resolvedValue;\n }\n\n // 異なる値がある場合は解決不可\n return undefined;\n}\n","import {\n type CallExpression,\n type JsxOpeningElement,\n type JsxSelfClosingElement,\n Node,\n type SourceFile,\n SyntaxKind,\n} from \"ts-morph\";\nimport { isTestOrStorybookFile } from \"@/source/fileFilters\";\nimport type { FileFilter } from \"@/types\";\nimport { createParamRefValue, isParameterReference } from \"./parameterUtils\";\n\n/**\n * ArgValueのtype識別子\n */\nexport const ArgValueType = {\n Literal: \"literal\",\n Function: \"function\",\n ParamRef: \"paramRef\",\n Undefined: \"undefined\",\n} as const;\n\n/**\n * 引数の値を表す union 型\n * 文字列エンコーディングの代わりに型安全な表現を使用\n */\nexport type ArgValue =\n | { type: typeof ArgValueType.Literal; value: string }\n | { type: typeof ArgValueType.Function; filePath: string; line: number }\n | {\n type: typeof ArgValueType.ParamRef;\n filePath: string;\n functionName: string;\n path: string;\n }\n | { type: typeof ArgValueType.Undefined };\n\n/**\n * 呼び出し箇所での引数情報\n */\nexport interface CallSiteArg {\n /** 引数のインデックス(0始まり)またはプロパティ名 */\n name: string;\n /** 引数の値 */\n value: ArgValue;\n /** 呼び出し元ファイルパス */\n filePath: string;\n /** 呼び出し元行番号 */\n line: number;\n}\n\n/**\n * 関数/コンポーネントへの呼び出し情報\n * key: パラメータ名, value: 渡された値の配列\n */\nexport type CallSiteInfo = Map<string, CallSiteArg[]>;\n\n/**\n * すべての関数/コンポーネントの呼び出し情報\n * key: \"ファイルパス:関数名\" 形式の識別子\n */\nexport type CallSiteMap = Map<string, CallSiteInfo>;\n\n/**\n * 関数/コンポーネントの識別子を生成する\n */\nexport function createTargetId(filePath: string, name: string): string {\n return `${filePath}:${name}`;\n}\n\n/**\n * 識別子から関数/コンポーネント名を抽出する\n */\nexport function parseTargetId(targetId: string): {\n filePath: string;\n name: string;\n} {\n const lastColonIndex = targetId.lastIndexOf(\":\");\n return {\n filePath: targetId.substring(0, lastColonIndex),\n name: targetId.substring(lastColonIndex + 1),\n };\n}\n\n/**\n * 式がthisキーワードへのプロパティアクセスかどうかを判定する\n * ネストしたアクセス(例: this.logger.name)にも対応\n */\nfunction isThisPropertyAccess(expression: Node): boolean {\n if (Node.isPropertyAccessExpression(expression)) {\n const baseExpr = expression.getExpression();\n if (baseExpr.getKind() === SyntaxKind.ThisKeyword) {\n return true;\n }\n return isThisPropertyAccess(baseExpr);\n }\n return false;\n}\n\n/**\n * 式から ArgValue を抽出する\n *\n * 式の値を型安全な ArgValue として返す。\n * 呼び出し情報収集時および式の値解決時に使用する。\n *\n * @param expression - 解析対象の式ノード\n * @returns 式の値を表す ArgValue\n */\nexport function extractArgValue(expression: Node): ArgValue {\n const type = expression.getType();\n\n // 関数型の場合\n if (type.getCallSignatures().length > 0) {\n const sourceFile = expression.getSourceFile();\n const line = expression.getStartLineNumber();\n return {\n type: ArgValueType.Function,\n filePath: sourceFile.getFilePath(),\n line,\n };\n }\n\n // PropertyAccessExpression (例: Status.Active, props.number)\n if (Node.isPropertyAccessExpression(expression)) {\n const symbol = expression.getSymbol();\n const decl = symbol?.getDeclarations()[0];\n\n // enum memberの場合\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 return {\n type: ArgValueType.Literal,\n value: `${filePath}:${enumName}.${memberName}=${JSON.stringify(value)}`,\n };\n }\n }\n\n // パラメータのプロパティアクセスの場合\n if (isParameterReference(expression.getExpression())) {\n return createParamRefValue(expression);\n }\n\n // thisキーワードへのプロパティアクセスの場合\n // クラスメンバーは実行時にインスタンスごとに異なる値を持つ可能性があるため、\n // 使用箇所ごとにユニークな値として扱う\n if (isThisPropertyAccess(expression)) {\n const sourceFile = expression.getSourceFile();\n const line = expression.getStartLineNumber();\n return {\n type: ArgValueType.Literal,\n value: `[this]${sourceFile.getFilePath()}:${line}:${expression.getText()}`,\n };\n }\n }\n\n // Identifier (変数参照)\n if (Node.isIdentifier(expression)) {\n if (expression.getText() === \"undefined\") {\n return { type: ArgValueType.Undefined };\n }\n\n const symbol = expression.getSymbol();\n const resolvedSymbol = symbol?.getAliasedSymbol() ?? symbol;\n const decl = resolvedSymbol?.getDeclarations()[0];\n\n if (decl) {\n const kind = decl.getKind();\n // パラメータまたはBindingElementの場合\n if (kind === SyntaxKind.Parameter || kind === SyntaxKind.BindingElement) {\n return createParamRefValue(expression);\n }\n\n // 変数宣言の場合は初期化子を再帰的に解決\n if (Node.isVariableDeclaration(decl)) {\n const initializer = decl.getInitializer();\n if (initializer) {\n return extractArgValue(initializer);\n }\n return {\n type: ArgValueType.Literal,\n value: `${decl.getSourceFile().getFilePath()}:${expression.getText()}`,\n };\n }\n\n // その他の宣言タイプ(インポート宣言など)\n // ファイルパス + 変数名で識別する\n return {\n type: ArgValueType.Literal,\n value: `${decl.getSourceFile().getFilePath()}:${expression.getText()}`,\n };\n }\n }\n\n // リテラル型\n if (type.isStringLiteral() || type.isNumberLiteral()) {\n return {\n type: ArgValueType.Literal,\n value: JSON.stringify(type.getLiteralValue()),\n };\n }\n\n if (type.isBooleanLiteral()) {\n return { type: ArgValueType.Literal, value: type.getText() };\n }\n\n // CallExpression (例: this.method(), obj.method())\n // プロパティアクセスを伴うメソッド呼び出しは、実行時に異なる値を返す可能性があるため、\n // 使用箇所ごとにユニークな値として扱う\n // 例: declSourceFile.getFilePath() はループ内で異なる declSourceFile に対して呼ばれる可能性がある\n if (Node.isCallExpression(expression)) {\n const calleeExpr = expression.getExpression();\n if (Node.isPropertyAccessExpression(calleeExpr)) {\n const sourceFile = expression.getSourceFile();\n const line = expression.getStartLineNumber();\n return {\n type: ArgValueType.Literal,\n value: `[methodCall]${sourceFile.getFilePath()}:${line}:${expression.getText()}`,\n };\n }\n }\n\n return { type: ArgValueType.Literal, value: expression.getText() };\n}\n\n/**\n * JSX要素から呼び出し情報を抽出\n */\nfunction extractFromJsxElement(\n element: JsxOpeningElement | JsxSelfClosingElement,\n targetId: string,\n callSiteMap: CallSiteMap,\n): void {\n const sourceFile = element.getSourceFile();\n const filePath = sourceFile.getFilePath();\n\n let info = callSiteMap.get(targetId);\n if (!info) {\n info = new Map();\n callSiteMap.set(targetId, info);\n }\n\n for (const attr of element.getAttributes()) {\n if (!Node.isJsxAttribute(attr)) continue;\n\n const propName = attr.getNameNode().getText();\n const initializer = attr.getInitializer();\n\n let value: ArgValue;\n if (!initializer) {\n // boolean shorthand\n value = { type: ArgValueType.Literal, value: \"true\" };\n } else if (Node.isJsxExpression(initializer)) {\n const expr = initializer.getExpression();\n value = expr ? extractArgValue(expr) : { type: ArgValueType.Undefined };\n } else {\n value = { type: ArgValueType.Literal, value: initializer.getText() };\n }\n\n const args = info.get(propName) ?? [];\n args.push({\n name: propName,\n value,\n filePath,\n line: element.getStartLineNumber(),\n });\n info.set(propName, args);\n }\n}\n\n/**\n * 関数呼び出しから呼び出し情報を抽出\n */\nfunction extractFromCallExpression(\n callExpr: CallExpression,\n targetId: string,\n paramNames: string[],\n callSiteMap: CallSiteMap,\n): void {\n const sourceFile = callExpr.getSourceFile();\n const filePath = sourceFile.getFilePath();\n\n let info = callSiteMap.get(targetId);\n if (!info) {\n info = new Map();\n callSiteMap.set(targetId, info);\n }\n\n const args = callExpr.getArguments();\n for (let i = 0; i < paramNames.length; i++) {\n const paramName = paramNames[i];\n const arg = args[i];\n const value: ArgValue = arg\n ? extractArgValue(arg)\n : { type: ArgValueType.Undefined };\n\n const argList = info.get(paramName) ?? [];\n argList.push({\n name: paramName,\n value,\n filePath,\n line: callExpr.getStartLineNumber(),\n });\n info.set(paramName, argList);\n }\n}\n\n/**\n * ソースファイルからすべての呼び出し情報を収集する\n */\nexport function collectCallSites(\n sourceFiles: SourceFile[],\n shouldExcludeFile: FileFilter = isTestOrStorybookFile,\n): CallSiteMap {\n const callSiteMap: CallSiteMap = new Map();\n\n for (const sourceFile of sourceFiles) {\n if (shouldExcludeFile(sourceFile.getFilePath())) continue;\n\n // JSX要素を収集\n const jsxElements = [\n ...sourceFile.getDescendantsOfKind(SyntaxKind.JsxOpeningElement),\n ...sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement),\n ];\n\n for (const element of jsxElements) {\n const tagName = element.getTagNameNode();\n if (!Node.isIdentifier(tagName)) continue;\n\n const symbol = tagName.getSymbol();\n // インポートを通じて実際の定義を解決する\n const resolvedSymbol = symbol?.getAliasedSymbol() ?? symbol;\n const decl = resolvedSymbol?.getDeclarations()[0];\n if (!decl) continue;\n\n const declSourceFile = decl.getSourceFile();\n const targetId = createTargetId(\n declSourceFile.getFilePath(),\n tagName.getText(),\n );\n\n extractFromJsxElement(element, targetId, callSiteMap);\n }\n\n // 関数呼び出しを収集\n const callExprs = sourceFile.getDescendantsOfKind(\n SyntaxKind.CallExpression,\n );\n\n for (const callExpr of callExprs) {\n const expr = callExpr.getExpression();\n if (!Node.isIdentifier(expr)) continue;\n\n const symbol = expr.getSymbol();\n const resolvedSymbol = symbol?.getAliasedSymbol() ?? symbol;\n const decl = resolvedSymbol?.getDeclarations()[0];\n if (!decl) continue;\n\n // 関数宣言またはアロー関数を含む変数宣言のみ\n // パラメータを取得\n let paramNames: string[] = [];\n\n if (Node.isFunctionDeclaration(decl)) {\n paramNames = decl.getParameters().map((p) => p.getName());\n } else if (Node.isVariableDeclaration(decl)) {\n const init = decl.getInitializer();\n if (init && Node.isArrowFunction(init)) {\n paramNames = init.getParameters().map((p) => p.getName());\n } else if (init && Node.isFunctionExpression(init)) {\n paramNames = init.getParameters().map((p) => p.getName());\n } else {\n continue;\n }\n } else {\n continue;\n }\n\n const declSourceFile = decl.getSourceFile();\n const targetId = createTargetId(\n declSourceFile.getFilePath(),\n expr.getText(),\n );\n\n extractFromCallExpression(callExpr, targetId, paramNames, callSiteMap);\n }\n }\n\n return callSiteMap;\n}\n","import type { Node } from \"ts-morph\";\nimport {\n type ArgValue,\n ArgValueType,\n type CallSiteMap,\n extractArgValue,\n} from \"./callSiteCollector\";\nimport { argValueToKey, resolveParameterValue } from \"./parameterUtils\";\n\n/**\n * 引数が渡されなかった場合を表す特別な値\n * 必須/任意を問わず、引数未指定の使用箇所を統一的に扱うために使用\n *\n * 注意: この値は文字列 \"[undefined]\" であり、JavaScriptの undefined とは異なる。\n * 解決関数が undefined を返す場合は「値を解決できなかった」ことを意味し、\n * この文字列を返す場合は「実際に undefined が渡された」ことを意味する。\n */\nexport const UNDEFINED_VALUE = \"[undefined]\";\n\n/**\n * 関数型の値を表すプレフィックス\n * コールバック関数など、関数が渡された場合は使用箇所ごとにユニークな値として扱う\n * これにより、同じコールバック関数を渡していても「定数」として検出されない\n */\nexport const FUNCTION_VALUE_PREFIX = \"[function]\";\n\n/**\n * resolveExpressionValueのコンテキスト\n */\nexport interface ResolveContext {\n /** 呼び出し情報(パラメータ参照の解決に使用) */\n callSiteMap: CallSiteMap;\n}\n\n/**\n * 式の実際の値を解決する\n *\n * 異なるファイルで同じenum値やリテラル値を使用している場合でも、\n * 同一の値として認識できるよう、値を正規化して文字列表現で返す。\n * 同名だが異なる定義(別ファイルの同名enum等)を区別するため、\n * 必要に応じてファイルパスを含めた識別子を返す。\n *\n * @param expression - 解決対象の式\n * @param context - 呼び出し情報などのコンテキスト\n */\nexport function resolveExpressionValue(\n expression: Node,\n context: ResolveContext,\n): string {\n const argValue = extractArgValue(expression);\n const sourceFile = expression.getSourceFile();\n const usageLocation = {\n filePath: sourceFile.getFilePath(),\n line: expression.getStartLineNumber(),\n };\n return argValueToString(argValue, context, usageLocation);\n}\n\n/**\n * 使用箇所の位置情報\n */\ninterface UsageLocation {\n filePath: string;\n line: number;\n}\n\n/**\n * ArgValue を文字列表現に変換する\n *\n * @param value - 変換対象の ArgValue\n * @param context - パラメータ参照解決用のコンテキスト\n * @param usageLocation - 使用箇所の位置情報(解決できないParamRefのユニーク化に使用)\n */\nfunction argValueToString(\n value: ArgValue,\n context: ResolveContext,\n usageLocation: UsageLocation,\n): string {\n switch (value.type) {\n case ArgValueType.Literal:\n return value.value;\n\n case ArgValueType.Function:\n // 関数型は使用箇所ごとにユニークな値として扱う\n return `${FUNCTION_VALUE_PREFIX}${value.filePath}:${value.line}`;\n\n case ArgValueType.ParamRef: {\n // パラメータ参照は callSiteMap を使って解決を試みる\n const resolved = resolveParameterValue(value, context.callSiteMap);\n if (resolved !== undefined) {\n return argValueToKey(resolved);\n }\n // 解決できない場合は使用箇所ごとにユニークな値として扱う\n // 使用箇所の位置情報を含めてユニークにする\n return `[paramRef]${usageLocation.filePath}:${usageLocation.line}:${argValueToKey(value)}`;\n }\n\n case ArgValueType.Undefined:\n return UNDEFINED_VALUE;\n }\n}\n","import { Node, type ObjectLiteralExpression, type Type } from \"ts-morph\";\nimport {\n type ResolveContext,\n resolveExpressionValue,\n UNDEFINED_VALUE,\n} from \"@/extraction/resolveExpressionValue\";\n\nexport type FlattenedValue = { key: string; value: string };\n\n/**\n * オブジェクトリテラルを再帰的に解析し、フラットなkey-valueペアを返す\n *\n * 期待される型(コンテキスト型)から省略されたプロパティも検出し、\n * [undefined] として記録する。\n *\n * @param expression - 解析対象の式ノード\n * @param prefix - キー名のプレフィックス(ネストしたプロパティの親パスを表す)\n * @param context - 呼び出し情報などのコンテキスト\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 context: ResolveContext,\n): FlattenedValue[] {\n if (!Node.isObjectLiteralExpression(expression)) {\n // オブジェクトリテラル以外の場合は単一の値として返す\n return [\n { key: prefix, value: resolveExpressionValue(expression, context) },\n ];\n }\n\n // 渡されたプロパティを収集\n const existingValues = flattenExistingProperties(expression, prefix, context);\n\n // 期待される型から省略されたプロパティを検出\n // ユニオン型(例: `{ a: number } | undefined`)からオブジェクト型を抽出\n const contextualType = expression.getContextualType();\n const objectType = contextualType ? extractObjectType(contextualType) : null;\n const missingValues = objectType\n ? getMissingProperties(expression, objectType, prefix)\n : [];\n\n return [...existingValues, ...missingValues];\n}\n\n/**\n * オブジェクトリテラル内の既存プロパティをフラット化する\n */\nfunction flattenExistingProperties(\n expression: ObjectLiteralExpression,\n prefix: string,\n context: ResolveContext,\n): FlattenedValue[] {\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, context)\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(), context),\n },\n ];\n }\n\n return [];\n });\n}\n\n/**\n * 期待される型と比較して、省略されたプロパティを検出する\n *\n * 省略されたプロパティがオブジェクト型の場合、そのネストプロパティも\n * 再帰的に [undefined] として出力する。これにより、親プロパティが\n * 省略された場合でも、ネストプロパティが他の呼び出しと比較可能になる。\n *\n * @param objectExpression - オブジェクトリテラル\n * @param expectedType - 期待される型(コンテキスト型)\n * @param prefix - キー名のプレフィックス\n * @returns 省略されたプロパティの配列(値は [undefined])\n */\nfunction getMissingProperties(\n objectExpression: ObjectLiteralExpression,\n expectedType: Type,\n prefix: string,\n): FlattenedValue[] {\n // 渡されたプロパティ名を収集\n const existingPropNames = new Set<string>();\n for (const property of objectExpression.getProperties()) {\n if (Node.isPropertyAssignment(property)) {\n existingPropNames.add(property.getName());\n } else if (Node.isShorthandPropertyAssignment(property)) {\n existingPropNames.add(property.getName());\n }\n }\n\n const missingValues: FlattenedValue[] = [];\n\n // 期待される型のプロパティを走査\n for (const propSymbol of expectedType.getProperties()) {\n const propName = propSymbol.getName();\n\n // 既に渡されているプロパティはスキップ\n if (existingPropNames.has(propName)) {\n continue;\n }\n\n const nestedPrefix = prefix ? `${prefix}.${propName}` : propName;\n\n // 省略されたプロパティを [undefined] として記録\n missingValues.push({\n key: nestedPrefix,\n value: UNDEFINED_VALUE,\n });\n\n // 省略されたプロパティがオブジェクト型の場合、ネストプロパティも再帰的に出力\n const propType = propSymbol.getValueDeclaration()?.getType();\n if (propType) {\n const objType = extractObjectType(propType);\n if (objType) {\n missingValues.push(\n ...getNestedMissingProperties(objType, nestedPrefix),\n );\n }\n }\n }\n\n return missingValues;\n}\n\n/**\n * 省略された親プロパティのネストプロパティを再帰的に [undefined] として出力\n */\nfunction getNestedMissingProperties(\n parentType: Type,\n prefix: string,\n): FlattenedValue[] {\n const result: FlattenedValue[] = [];\n\n for (const propSymbol of parentType.getProperties()) {\n const propName = propSymbol.getName();\n const nestedPrefix = `${prefix}.${propName}`;\n\n result.push({\n key: nestedPrefix,\n value: UNDEFINED_VALUE,\n });\n\n // さらにネストされたオブジェクト型があれば再帰\n const propType = propSymbol.getValueDeclaration()?.getType();\n if (propType) {\n const objType = extractObjectType(propType);\n if (objType) {\n result.push(...getNestedMissingProperties(objType, nestedPrefix));\n }\n }\n }\n\n return result;\n}\n\n/**\n * 型からオブジェクト部分を抽出する\n * ユニオン型(例: `{ a: number } | undefined`)から `undefined` を除外して\n * オブジェクト型部分を返す。オブジェクト型でない場合は null を返す。\n */\nfunction extractObjectType(type: Type): Type | null {\n // ユニオン型の場合、undefined/null を除外したオブジェクト型を探す\n if (type.isUnion()) {\n for (const unionType of type.getUnionTypes()) {\n if (unionType.isUndefined() || unionType.isNull()) {\n continue;\n }\n const objType = extractObjectType(unionType);\n if (objType) {\n return objType;\n }\n }\n return null;\n }\n\n // プリミティブ型は除外\n if (\n type.isString() ||\n type.isNumber() ||\n type.isBoolean() ||\n type.isUndefined() ||\n type.isNull() ||\n type.isLiteral()\n ) {\n return null;\n }\n\n // 配列型は除外\n if (type.isArray()) {\n return null;\n }\n\n // オブジェクト型かつプロパティを持つ場合\n if (type.isObject() && type.getProperties().length > 0) {\n return type;\n }\n\n return null;\n}\n","import type { Node } from \"ts-morph\";\n\nconst DISABLE_NEXT_LINE = \"dittory-disable-next-line\";\nconst DISABLE_LINE = \"dittory-disable-line\";\n\n/**\n * ノードに除外コメントがあるかを判定する\n *\n * 以下の2パターンをサポート:\n * - \"dittory-disable-next-line\": 次の行を除外(leading comments をチェック)\n * - \"dittory-disable-line\": 同じ行を除外(trailing comments をチェック)\n *\n * 祖先ノードを辿り、いずれかのノードのコメントに\n * 除外キーワードが含まれていれば除外対象とする。\n *\n * @param node - 判定対象のノード\n * @returns 除外コメントが存在すれば true\n */\nexport function hasDisableComment(node: Node): boolean {\n let current: Node | undefined = node;\n\n while (current) {\n const leadingComments = current.getLeadingCommentRanges();\n const trailingComments = current.getTrailingCommentRanges();\n\n for (const comment of leadingComments) {\n if (comment.getText().includes(DISABLE_NEXT_LINE)) {\n return true;\n }\n }\n\n for (const comment of trailingComments) {\n if (comment.getText().includes(DISABLE_LINE)) {\n return true;\n }\n }\n\n current = current.getParent();\n }\n\n return false;\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 { hasDisableComment } from \"./hasDisableComment\";\nimport { type ResolveContext, UNDEFINED_VALUE } from \"./resolveExpressionValue\";\n\n/**\n * 使用状況を抽出するユーティリティクラス\n */\nexport class ExtractUsages {\n /**\n * 関数呼び出しから引数の使用状況を抽出する\n *\n * オブジェクトリテラルの場合は再帰的にフラット化し、\n * 各プロパティを「引数名.プロパティ名」形式で記録する。\n *\n * @param callExpression - 関数呼び出しノード\n * @param callable - 対象の関数情報\n * @param context - 呼び出し情報などのコンテキスト\n * @returns 引数使用状況の配列\n */\n static fromCall(\n callExpression: CallExpression,\n callable: Exported,\n context: ResolveContext,\n ): Usage[] {\n // dittory-disable-next-line コメントがある場合は除外\n if (hasDisableComment(callExpression)) {\n return [];\n }\n\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(\n arg,\n param.name,\n context,\n )) {\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 * @param context - 呼び出し情報などのコンテキスト\n * @returns props使用状況の配列\n */\n static fromJsxElement(\n element: JsxOpeningElement | JsxSelfClosingElement,\n definitions: Definition[],\n context: ResolveContext,\n ): Usage[] {\n // dittory-disable-next-line コメントがある場合は除外\n if (hasDisableComment(element)) {\n return [];\n }\n\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 context,\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 * 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 { UNDEFINED_VALUE } from \"@/extraction/resolveExpressionValue\";\n\n/**\n * フィルタリング対象の値種別\n */\nexport type ValueType = \"boolean\" | \"number\" | \"string\" | \"enum\" | \"undefined\";\n\n/**\n * 有効な値種別の一覧\n */\nexport const VALID_VALUE_TYPES: readonly ValueType[] = [\n \"boolean\",\n \"number\",\n \"string\",\n \"enum\",\n \"undefined\",\n];\n\n/**\n * enum値の文字列表現パターン\n * 形式: \"filePath:EnumName.MemberName=value\"\n */\nconst ENUM_PATTERN = /^.+:\\w+\\.\\w+=.+$/;\n\n/**\n * 値の文字列表現から種別を判定する\n *\n * @param value - resolveExpressionValue で得られた値の文字列表現\n * @returns 検出された種別、または判定不能な場合は null\n */\nexport function detectValueType(value: string): ValueType | null {\n // boolean: \"true\" または \"false\"\n if (value === \"true\" || value === \"false\") {\n return \"boolean\";\n }\n\n // undefined: \"[undefined]\"\n if (value === UNDEFINED_VALUE) {\n return \"undefined\";\n }\n\n // enum: \"filePath:EnumName.MemberName=value\" 形式\n if (ENUM_PATTERN.test(value)) {\n return \"enum\";\n }\n\n // string: ダブルクォート囲み(JSON.stringify形式)\n if (value.startsWith('\"') && value.endsWith('\"')) {\n return \"string\";\n }\n\n // number: 数値として解釈可能\n // 空文字列は Number(\"\") === 0 となるため除外\n if (value !== \"\" && !Number.isNaN(Number(value))) {\n return \"number\";\n }\n\n // 判定不能(function, paramRef, this, 変数参照など)\n return null;\n}\n\n/**\n * 値が指定された種別に含まれるか判定する\n *\n * @param value - resolveExpressionValue で得られた値の文字列表現\n * @param allowedTypes - 許可する種別の配列、または \"all\"\n * @returns 指定種別に含まれる場合は true\n */\nexport function matchesValueTypes(\n value: string,\n allowedTypes: ValueType[] | \"all\",\n): boolean {\n if (allowedTypes === \"all\") {\n return true;\n }\n\n const detectedType = detectValueType(value);\n if (detectedType === null) {\n // 判定不能な値は種別指定時にはマッチしない\n return false;\n }\n\n return allowedTypes.includes(detectedType);\n}\n","import {\n type Identifier,\n Node,\n type ParameterDeclaration,\n type ReferencedSymbol,\n} from \"ts-morph\";\nimport type { CallSiteMap } from \"@/extraction/callSiteCollector\";\nimport {\n FUNCTION_VALUE_PREFIX,\n type ResolveContext,\n} from \"@/extraction/resolveExpressionValue\";\nimport { isTestOrStorybookFile } from \"@/source/fileFilters\";\nimport type {\n AnalysisResult,\n AnalyzerOptions,\n ClassifiedDeclaration,\n Constant,\n Definition,\n Exported,\n FileFilter,\n Usage,\n ValueType,\n} from \"@/types\";\nimport { getSingleValueFromSet } from \"@/utils/getSingleValueFromSet\";\nimport { matchesValueTypes } from \"@/utils/valueTypeDetector\";\n\n/**\n * ts-morph の参照情報を表す型\n */\ntype ReferenceEntry = ReturnType<ReferencedSymbol[\"getReferences\"]>[number];\n\n/**\n * 使用データのグループ\n * values.size === 1 の場合、そのパラメータは「定数」として検出される\n */\ninterface UsageData {\n values: Set<string>;\n usages: Usage[];\n}\n\n/**\n * 対象ごとの情報(行番号とパラメータ使用状況)\n */\ninterface TargetInfo {\n line: number;\n params: Map<string, UsageData>;\n /** 総呼び出し回数(ネストしたプロパティの存在チェックに使用) */\n totalCallCount: number;\n}\n\n/**\n * 使用状況を階層的にグループ化したマップ\n *\n * 3階層の構造で使用状況を整理する:\n * 1. ソースファイルパス: どのファイルで定義された対象か\n * 2. 対象名: 関数名/コンポーネント名(+ 行番号とパラメータ使用状況)\n *\n * この構造により、定数検出時に効率的に走査できる。\n */\ntype GroupedMap = Map<string, Map<string, TargetInfo>>;\n\n/**\n * 分析処理の基底クラス\n */\nexport abstract class BaseAnalyzer {\n protected shouldExcludeFile: FileFilter;\n protected minUsages: number;\n protected valueTypes: ValueType[] | \"all\";\n protected callSiteMap!: CallSiteMap;\n\n constructor(options: AnalyzerOptions = {}) {\n this.shouldExcludeFile = options.shouldExcludeFile ?? isTestOrStorybookFile;\n this.minUsages = options.minUsages ?? 2;\n this.valueTypes = options.valueTypes ?? \"all\";\n }\n\n /**\n * 呼び出し情報を設定する\n * パラメータ経由で渡された値を解決するために使用\n *\n * @param callSiteMap - 呼び出し情報マップ\n */\n setCallSiteMap(callSiteMap: CallSiteMap): void {\n this.callSiteMap = callSiteMap;\n }\n\n /**\n * コンテキストを取得する\n */\n protected getResolveContext(): ResolveContext {\n return {\n callSiteMap: this.callSiteMap,\n };\n }\n\n /**\n * 識別子から全参照を検索し、除外対象ファイルからの参照をフィルタリングする\n *\n * @param nameNode - 検索対象の識別子ノード\n * @returns フィルタリングされた参照エントリの配列\n */\n protected findFilteredReferences(nameNode: Identifier): ReferenceEntry[] {\n return nameNode\n .findReferences()\n .flatMap((referencedSymbol) => referencedSymbol.getReferences())\n .filter(\n (ref) => !this.shouldExcludeFile(ref.getSourceFile().getFilePath()),\n );\n }\n\n /**\n * 使用状況をグループに追加する\n *\n * @param groupedUsages - 使用状況のグループ(パラメータ名 → 使用状況配列)\n * @param usages - 追加する使用状況の配列\n */\n protected addUsagesToGroup(\n groupedUsages: Record<string, Usage[]>,\n usages: Usage[],\n ): void {\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 /**\n * ノードからパラメータ定義を取得する\n *\n * FunctionDeclaration, MethodDeclaration, VariableDeclaration(ArrowFunction/FunctionExpression)\n * からパラメータを抽出し、Definition配列として返す。\n *\n * @param node - パラメータを抽出する対象のノード\n * @returns パラメータ定義の配列\n */\n protected getParameterDefinitions(node: Node): Definition[] {\n const params = this.extractParameterDeclarations(node);\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 * 以下のノードタイプに対応:\n * - FunctionDeclaration: 直接パラメータを取得\n * - MethodDeclaration: 直接パラメータを取得\n * - VariableDeclaration: 初期化子がArrowFunctionまたはFunctionExpressionの場合にパラメータを取得\n *\n * @param node - パラメータを抽出する対象のノード\n * @returns ParameterDeclarationの配列\n */\n protected extractParameterDeclarations(node: Node): ParameterDeclaration[] {\n if (Node.isFunctionDeclaration(node)) {\n return node.getParameters();\n }\n\n if (Node.isMethodDeclaration(node)) {\n return node.getParameters();\n }\n\n if (Node.isVariableDeclaration(node)) {\n const initializer = node.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 /**\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\n // 総呼び出し回数を計算(最大のUsage配列の長さを使用)\n // すべての呼び出しで存在するパラメータのUsage数が基準となる\n const totalCallCount = Math.max(\n ...Object.values(item.usages).map((usages) => usages.length),\n 0,\n );\n\n fileMap.set(item.name, {\n line: item.sourceLine,\n params: paramMap,\n totalCallCount,\n });\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, targetInfo] of targetMap) {\n for (const [paramName, usageData] of targetInfo.params) {\n // 定数として認識する条件:\n // 1. 使用回数が最小使用回数以上\n // 2. すべての使用箇所で同じ値\n // 3. Usage数が総呼び出し回数と一致(すべての呼び出しで値が存在)\n // これにより、オプショナルなプロパティが一部の呼び出しでのみ\n // 指定されている場合を定数として誤検出しない\n const isConstant =\n usageData.usages.length >= this.minUsages &&\n usageData.values.size === 1 &&\n usageData.usages.length === targetInfo.totalCallCount;\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 // 値種別によるフィルタリング\n if (!matchesValueTypes(value, this.valueTypes)) {\n continue;\n }\n\n result.push({\n targetName,\n targetSourceFile: sourceFile,\n targetLine: targetInfo.line,\n paramName,\n value,\n usages: usageData.usages,\n });\n }\n }\n }\n\n return result;\n }\n}\n","import { Node } from \"ts-morph\";\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 * クラスメソッドの引数分析を行う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.getParameterDefinitions(method);\n\n const callable: Exported = {\n name: `${exportName}.${methodName}`,\n sourceFilePath: sourceFile.getFilePath(),\n sourceLine: method.getStartLineNumber(),\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 = this.findFilteredReferences(nameNode);\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(\n callExpression,\n callable,\n this.getResolveContext(),\n );\n this.addUsagesToGroup(groupedUsages, usages);\n }\n\n callable.usages = groupedUsages;\n results.push(callable);\n }\n }\n\n return results;\n }\n}\n","import { Node, SyntaxKind } from \"ts-morph\";\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 * 関数の引数分析を行う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 = this.findFilteredReferences(nameNode);\n\n // 関数の宣言からパラメータ定義を取得\n const parameters = this.getParameterDefinitions(declaration);\n\n const callable: Exported = {\n name: exportName,\n sourceFilePath: sourceFile.getFilePath(),\n sourceLine: declaration.getStartLineNumber(),\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(\n callExpression,\n callable,\n this.getResolveContext(),\n );\n this.addUsagesToGroup(groupedUsages, usages);\n }\n\n callable.usages = groupedUsages;\n results.push(callable);\n }\n\n return results;\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 { ClassMethodAnalyzer } from \"@/analyzer/classMethodAnalyzer\";\nimport { FunctionAnalyzer } from \"@/analyzer/functionAnalyzer\";\nimport type { CallSiteMap } from \"@/extraction/callSiteCollector\";\nimport { classifyDeclarations } from \"@/source/classifyDeclarations\";\nimport { isTestOrStorybookFile } from \"@/source/fileFilters\";\nimport type { AnalysisResult, FileFilter, ValueType } from \"@/types\";\n\ninterface AnalyzeFunctionsOptions {\n shouldExcludeFile?: FileFilter;\n minUsages?: number;\n /** 検出対象の値種別。デフォルト: \"all\" */\n valueTypes?: ValueType[] | \"all\";\n /** 呼び出し情報(パラメータ経由で渡された値を解決するために使用) */\n callSiteMap: CallSiteMap;\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 {\n shouldExcludeFile = isTestOrStorybookFile,\n minUsages = 2,\n valueTypes = \"all\",\n callSiteMap,\n } = 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, valueTypes };\n\n // 関数を分析\n const functionAnalyzer = new FunctionAnalyzer(analyzerOptions);\n functionAnalyzer.setCallSiteMap(callSiteMap);\n const functionResult = functionAnalyzer.analyze(functions);\n\n // クラスメソッドを分析\n const classMethodAnalyzer = new ClassMethodAnalyzer(analyzerOptions);\n classMethodAnalyzer.setCallSiteMap(callSiteMap);\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 { 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, 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 = this.findFilteredReferences(nameNode);\n\n // コンポーネントの宣言からprops定義を取得\n const props = getProps(declaration);\n\n const component: Exported = {\n name: exportName,\n sourceFilePath: sourceFile.getFilePath(),\n sourceLine: declaration.getStartLineNumber(),\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 this.getResolveContext(),\n );\n this.addUsagesToGroup(groupedUsages, usages);\n }\n\n component.usages = groupedUsages;\n exportedComponents.push(component);\n }\n\n return exportedComponents;\n }\n}\n","import type { SourceFile } from \"ts-morph\";\nimport { ComponentAnalyzer } from \"@/analyzer/componentAnalyzer\";\nimport type { CallSiteMap } from \"@/extraction/callSiteCollector\";\nimport { classifyDeclarations } from \"@/source/classifyDeclarations\";\nimport { isTestOrStorybookFile } from \"@/source/fileFilters\";\nimport type { AnalysisResult, FileFilter, ValueType } from \"@/types\";\n\ninterface AnalyzePropsOptions {\n shouldExcludeFile?: FileFilter;\n minUsages?: number;\n /** 検出対象の値種別。デフォルト: \"all\" */\n valueTypes?: ValueType[] | \"all\";\n /** 呼び出し情報(パラメータ経由で渡された値を解決するために使用) */\n callSiteMap: CallSiteMap;\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 {\n shouldExcludeFile = isTestOrStorybookFile,\n minUsages = 2,\n valueTypes = \"all\",\n callSiteMap,\n } = 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 valueTypes,\n });\n analyzer.setCallSiteMap(callSiteMap);\n\n return analyzer.analyze(components);\n}\n"],"mappings":"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"}
package/dist/cli.mjs CHANGED
@@ -1,211 +1,10 @@
1
1
  #!/usr/bin/env node
2
- import { a as ExtractUsages, i as isTestOrStorybookFile, n as classifyDeclarations, r as BaseAnalyzer, t as analyzePropsCore } from "./analyzeProps-CoEqudRM.mjs";
3
- import { Node, Project, SyntaxKind } from "ts-morph";
2
+ import { a as isTestOrStorybookFile, i as collectCallSites, n as analyzeFunctionsCore, r as VALID_VALUE_TYPES, t as analyzePropsCore } from "./analyzeProps-6k4QTasK.mjs";
3
+ import { Project } from "ts-morph";
4
4
  import path from "node:path";
5
5
  import fs from "node:fs";
6
6
  import { pathToFileURL } from "node:url";
7
7
 
8
- //#region src/analyzer/classMethodAnalyzer.ts
9
- /**
10
- * クラスメソッドの引数分析を行うAnalyzer
11
- *
12
- * exportされたクラスのメソッド(static/instance)を収集し、
13
- * 各メソッドの引数使用状況を分析する。
14
- * 常に同じ値が渡されている引数を検出し、定数として報告する。
15
- *
16
- * @example
17
- * ```ts
18
- * const analyzer = new ClassMethodAnalyzer({ minUsages: 2 });
19
- * const result = analyzer.analyze(declarations);
20
- * console.log(result.constants);
21
- * ```
22
- */
23
- var ClassMethodAnalyzer = class extends BaseAnalyzer {
24
- constructor(options = {}) {
25
- super(options);
26
- }
27
- /**
28
- * 事前分類済みの宣言からクラスメソッドを収集する
29
- *
30
- * @param declarations - 事前分類済みの宣言配列(type: "class")
31
- * @returns クラスメソッドとその使用状況の配列(名前は「ClassName.methodName」形式)
32
- */
33
- collect(declarations) {
34
- const results = [];
35
- for (const classified of declarations) {
36
- const { exportName, sourceFile, declaration } = classified;
37
- if (!Node.isClassDeclaration(declaration)) continue;
38
- const methods = declaration.getMethods();
39
- for (const method of methods) {
40
- const methodName = method.getName();
41
- const parameters = this.getParameters(method);
42
- const callable = {
43
- name: `${exportName}.${methodName}`,
44
- sourceFilePath: sourceFile.getFilePath(),
45
- sourceLine: method.getStartLineNumber(),
46
- definitions: parameters,
47
- declaration: method,
48
- usages: {}
49
- };
50
- const nameNode = method.getNameNode();
51
- if (!Node.isIdentifier(nameNode)) continue;
52
- const references = nameNode.findReferences().flatMap((referencedSymbol) => referencedSymbol.getReferences()).filter((ref) => !this.shouldExcludeFile(ref.getSourceFile().getFilePath()));
53
- const groupedUsages = {};
54
- for (const reference of references) {
55
- const propertyAccess = reference.getNode().getParent();
56
- if (!propertyAccess || !Node.isPropertyAccessExpression(propertyAccess)) continue;
57
- const callExpression = propertyAccess.getParent();
58
- if (!callExpression || !Node.isCallExpression(callExpression)) continue;
59
- if (callExpression.getExpression() !== propertyAccess) continue;
60
- const usages = ExtractUsages.fromCall(callExpression, callable);
61
- for (const usage of usages) {
62
- if (!groupedUsages[usage.name]) groupedUsages[usage.name] = [];
63
- groupedUsages[usage.name].push(usage);
64
- }
65
- }
66
- callable.usages = groupedUsages;
67
- results.push(callable);
68
- }
69
- }
70
- return results;
71
- }
72
- /**
73
- * メソッドのパラメータ定義を取得する
74
- */
75
- getParameters(method) {
76
- return this.extractParameterDeclarations(method).map((param, index) => ({
77
- name: param.getName(),
78
- index,
79
- required: !param.hasQuestionToken() && !param.hasInitializer()
80
- }));
81
- }
82
- /**
83
- * メソッド宣言からParameterDeclarationの配列を抽出する
84
- */
85
- extractParameterDeclarations(method) {
86
- if (Node.isMethodDeclaration(method)) return method.getParameters();
87
- return [];
88
- }
89
- };
90
-
91
- //#endregion
92
- //#region src/analyzer/functionAnalyzer.ts
93
- /**
94
- * 関数の引数分析を行うAnalyzer
95
- *
96
- * exportされた関数を収集し、各関数の引数使用状況を分析する。
97
- * 常に同じ値が渡されている引数を検出し、定数として報告する。
98
- *
99
- * @example
100
- * ```ts
101
- * const analyzer = new FunctionAnalyzer({ minUsages: 2 });
102
- * const result = analyzer.analyze(declarations);
103
- * console.log(result.constants);
104
- * ```
105
- */
106
- var FunctionAnalyzer = class extends BaseAnalyzer {
107
- constructor(options = {}) {
108
- super(options);
109
- }
110
- /**
111
- * 事前分類済みの宣言から関数を収集する
112
- *
113
- * @param declarations - 事前分類済みの宣言配列(type: "function")
114
- * @returns exportされた関数とその使用状況の配列
115
- */
116
- collect(declarations) {
117
- const results = [];
118
- for (const classified of declarations) {
119
- const { exportName, sourceFile, declaration } = classified;
120
- if (!Node.isFunctionDeclaration(declaration) && !Node.isVariableDeclaration(declaration)) continue;
121
- const nameNode = declaration.getNameNode();
122
- if (!nameNode || !Node.isIdentifier(nameNode)) continue;
123
- const references = nameNode.findReferences().flatMap((referencedSymbol) => referencedSymbol.getReferences()).filter((ref) => !this.shouldExcludeFile(ref.getSourceFile().getFilePath()));
124
- const parameters = this.getParameters(declaration);
125
- const callable = {
126
- name: exportName,
127
- sourceFilePath: sourceFile.getFilePath(),
128
- sourceLine: declaration.getStartLineNumber(),
129
- definitions: parameters,
130
- declaration,
131
- usages: {}
132
- };
133
- const groupedUsages = {};
134
- for (const reference of references) {
135
- const refNode = reference.getNode();
136
- const parent = refNode.getParent();
137
- if (!parent) continue;
138
- const callExpression = parent.asKind(SyntaxKind.CallExpression);
139
- if (!callExpression) continue;
140
- if (callExpression.getExpression() !== refNode) continue;
141
- const usages = ExtractUsages.fromCall(callExpression, callable);
142
- for (const usage of usages) {
143
- if (!groupedUsages[usage.name]) groupedUsages[usage.name] = [];
144
- groupedUsages[usage.name].push(usage);
145
- }
146
- }
147
- callable.usages = groupedUsages;
148
- results.push(callable);
149
- }
150
- return results;
151
- }
152
- /**
153
- * 関数のパラメータ定義を取得する
154
- */
155
- getParameters(declaration) {
156
- return this.extractParameterDeclarations(declaration).map((param, index) => ({
157
- name: param.getName(),
158
- index,
159
- required: !param.hasQuestionToken() && !param.hasInitializer()
160
- }));
161
- }
162
- /**
163
- * 宣言からParameterDeclarationの配列を抽出する
164
- */
165
- extractParameterDeclarations(declaration) {
166
- if (Node.isFunctionDeclaration(declaration)) return declaration.getParameters();
167
- if (Node.isVariableDeclaration(declaration)) {
168
- const initializer = declaration.getInitializer();
169
- if (initializer) {
170
- if (Node.isArrowFunction(initializer) || Node.isFunctionExpression(initializer)) return initializer.getParameters();
171
- }
172
- }
173
- return [];
174
- }
175
- };
176
-
177
- //#endregion
178
- //#region src/analyzeFunctions.ts
179
- /**
180
- * 関数・クラスメソッドの引数使用状況を解析し、常に同じ値が渡されている引数を検出する
181
- *
182
- * @param sourceFiles - 解析対象のソースファイル配列
183
- * @param options - オプション設定
184
- * @returns 解析結果(定数引数、統計情報、exportされた関数・メソッド)
185
- *
186
- * @example
187
- * const project = new Project();
188
- * project.addSourceFilesAtPaths("src/**\/*.ts");
189
- * const result = analyzeFunctionsCore(project.getSourceFiles());
190
- */
191
- function analyzeFunctionsCore(sourceFiles, options = {}) {
192
- const { shouldExcludeFile = isTestOrStorybookFile, minUsages = 2 } = options;
193
- const declarations = classifyDeclarations(sourceFiles);
194
- const functions = declarations.filter((decl) => decl.type === "function");
195
- const classes = declarations.filter((decl) => decl.type === "class");
196
- const analyzerOptions = {
197
- shouldExcludeFile,
198
- minUsages
199
- };
200
- const functionResult = new FunctionAnalyzer(analyzerOptions).analyze(functions);
201
- const classMethodResult = new ClassMethodAnalyzer(analyzerOptions).analyze(classes);
202
- return {
203
- constants: [...functionResult.constants, ...classMethodResult.constants],
204
- exported: [...functionResult.exported, ...classMethodResult.exported]
205
- };
206
- }
207
-
208
- //#endregion
209
8
  //#region src/cli/loadConfig.ts
210
9
  /** コンフィグファイルの検索順序 */
211
10
  const CONFIG_FILE_NAMES = [
@@ -294,6 +93,14 @@ function validateConfig(config) {
294
93
  if (typeof config.targetDir !== "string" || config.targetDir === "") throw new Error(`Invalid config: targetDir must be a non-empty string, got ${config.targetDir}`);
295
94
  result.targetDir = config.targetDir;
296
95
  }
96
+ if ("valueTypes" in config) {
97
+ const value = config.valueTypes;
98
+ if (value === "all") result.valueTypes = "all";
99
+ else if (Array.isArray(value)) {
100
+ for (const type of value) if (!VALID_VALUE_TYPES.includes(type)) throw new Error(`Invalid config: valueTypes contains invalid type "${type}" (valid values: ${VALID_VALUE_TYPES.join(", ")}, all)`);
101
+ result.valueTypes = value;
102
+ } else throw new Error(`Invalid config: valueTypes must be "all" or an array of value types, got ${value}`);
103
+ }
297
104
  return result;
298
105
  }
299
106
 
@@ -305,7 +112,8 @@ const DEFAULT_OPTIONS = {
305
112
  minUsages: 2,
306
113
  target: "all",
307
114
  output: "simple",
308
- tsconfig: "./tsconfig.json"
115
+ tsconfig: "./tsconfig.json",
116
+ valueTypes: "all"
309
117
  };
310
118
  var CliValidationError = class extends Error {
311
119
  constructor(message) {
@@ -325,6 +133,7 @@ const VALID_OPTIONS = [
325
133
  "--target",
326
134
  "--output",
327
135
  "--tsconfig",
136
+ "--value-types",
328
137
  "--help"
329
138
  ];
330
139
  /**
@@ -359,6 +168,13 @@ function parseCliOptions(args) {
359
168
  const value = arg.slice(11);
360
169
  if (value === "") throw new CliValidationError("Invalid value for --tsconfig: path cannot be empty");
361
170
  result.tsconfig = value;
171
+ } else if (arg.startsWith("--value-types=")) {
172
+ const value = arg.slice(14);
173
+ if (value === "") throw new CliValidationError("Invalid value for --value-types: value cannot be empty");
174
+ if (value === "all") continue;
175
+ const types = value.split(",").map((t) => t.trim());
176
+ for (const type of types) if (!VALID_VALUE_TYPES.includes(type)) throw new CliValidationError(`Invalid value type: "${type}" (valid values: ${VALID_VALUE_TYPES.join(", ")}, all)`);
177
+ result.valueTypes = types;
362
178
  } else if (arg.startsWith("--")) {
363
179
  const optionName = arg.split("=")[0];
364
180
  if (!VALID_OPTIONS.includes(optionName)) throw new CliValidationError(`Unknown option: ${optionName}`);
@@ -391,14 +207,16 @@ function getHelpMessage() {
391
207
  Usage: dittory [options] [directory]
392
208
 
393
209
  Options:
394
- --min=<number> Minimum usage count (default: 2)
395
- --target=<mode> Analysis target: all, components, functions (default: all)
396
- --output=<mode> Output mode: simple, verbose (default: simple)
397
- --tsconfig=<path> Path to tsconfig.json (default: ./tsconfig.json)
398
- --help Show this help message
210
+ --min=<number> Minimum usage count (default: 2)
211
+ --target=<mode> Analysis target: all, components, functions (default: all)
212
+ --output=<mode> Output mode: simple, verbose (default: simple)
213
+ --tsconfig=<path> Path to tsconfig.json (default: ./tsconfig.json)
214
+ --value-types=<types> Value types to detect: boolean, number, string, enum, undefined, all (default: all)
215
+ Multiple types can be specified with comma: --value-types=boolean,string
216
+ --help Show this help message
399
217
 
400
218
  Arguments:
401
- directory Target directory to analyze (default: ./src)
219
+ directory Target directory to analyze (default: ./src)
402
220
  `;
403
221
  }
404
222
 
@@ -542,12 +360,13 @@ async function main() {
542
360
  if (error instanceof Error) exitWithError(error.message);
543
361
  throw error;
544
362
  }
545
- const { targetDir, minUsages, target, output, tsconfig } = {
363
+ const { targetDir, minUsages, target, output, tsconfig, valueTypes } = {
546
364
  targetDir: path.resolve(cliOptions.targetDir ?? fileConfig.targetDir ?? DEFAULT_OPTIONS.targetDir),
547
365
  minUsages: cliOptions.minUsages ?? fileConfig.minUsages ?? DEFAULT_OPTIONS.minUsages,
548
366
  target: cliOptions.target ?? fileConfig.target ?? DEFAULT_OPTIONS.target,
549
367
  output: cliOptions.output ?? fileConfig.output ?? DEFAULT_OPTIONS.output,
550
- tsconfig: cliOptions.tsconfig ?? fileConfig.tsconfig ?? DEFAULT_OPTIONS.tsconfig
368
+ tsconfig: cliOptions.tsconfig ?? fileConfig.tsconfig ?? DEFAULT_OPTIONS.tsconfig,
369
+ valueTypes: cliOptions.valueTypes ?? fileConfig.valueTypes ?? DEFAULT_OPTIONS.valueTypes
551
370
  };
552
371
  try {
553
372
  validateTargetDir(targetDir);
@@ -567,15 +386,24 @@ async function main() {
567
386
  console.log(`Analysis target: ${target}\n`);
568
387
  }
569
388
  const sourceFilesToAnalyze = createFilteredSourceFiles(targetDir, { tsConfigFilePath: tsconfig });
389
+ const callSiteMap = collectCallSites(sourceFilesToAnalyze);
570
390
  const allExported = [];
571
391
  const allConstants = [];
572
392
  if (target === "all" || target === "components") {
573
- const propsResult = analyzePropsCore(sourceFilesToAnalyze, { minUsages });
393
+ const propsResult = analyzePropsCore(sourceFilesToAnalyze, {
394
+ minUsages,
395
+ valueTypes,
396
+ callSiteMap
397
+ });
574
398
  allExported.push(...propsResult.exported);
575
399
  allConstants.push(...propsResult.constants);
576
400
  }
577
401
  if (target === "all" || target === "functions") {
578
- const functionsResult = analyzeFunctionsCore(sourceFilesToAnalyze, { minUsages });
402
+ const functionsResult = analyzeFunctionsCore(sourceFilesToAnalyze, {
403
+ minUsages,
404
+ valueTypes,
405
+ callSiteMap
406
+ });
579
407
  allExported.push(...functionsResult.exported);
580
408
  allConstants.push(...functionsResult.constants);
581
409
  }