回答。

Kotlinでは、visibility modifiersを使用して、クラス、プロパティ、関数、およびトップレベル（ファイルレベル）のエンティティへのアクセスを制御します。Javaとは異なり、Javaでは修飾子がクラスレベルでのみ機能しますが、Kotlinではトップレベルの宣言にも適用され、これは大規模プロジェクトやライブラリAPIの構成において重要です。

質問の背景

Javaにはクラス外の関数やプロパティのためのvisibility modifiersがなく、すべてがpublic（またはpackage-private）クラスの内部に存在します。Kotlinでは、プロジェクトを独自に構成することが一般的で、関数やプロパティがクラス内ではなく、ファイル内に直接存在することがよくあります。

問題

Javaの開発者はしばしば、publicがJavaと同じように機能することを期待しますが、Kotlinではトップレベルの関数（またはプロパティ）は明示的に別の修飾子でマークされていない限り、すべてのモジュールから見えることになります。visibilityを正しく定義しないと、公開APIが汚染され、内部ユーティリティが予期せず入手可能になったり、必要な公開関数が利用できなくなったりします。

解決策

Kotlinでは、次のvisibility modifiersが利用可能です：

public: 宣言はどこでも見える（トップレベルのデフォルト修飾子）。
internal: 宣言は同じモジュールのすべてのファイルで見える（単一のGradleモジュール、コンパイルされたアーティファクト、単一のJAR）。
private: 宣言は、宣言された同じファイル/クラス内でのみ見える。トップレベルの場合はファイル内のみ。
protected: トップレベルの宣言には適用されず、クラス/インターフェースおよびその子孫にのみ適用される。

例:

// file: Foo.kt
private fun utilityFun() {}
internal val bar: Int = 10
public val baz: Int = 20 // publicは省略可能

fun printValue() {
    println(bar)
}

主な特徴：

internalはパッケージではなくモジュール（JAR/アーティファクト）での可視性を制限します。
protectedはトップレベルの関数やプロパティには使用できません。
トップレベルのprivateは現在のファイルの境界で宣言を制限します。

トリッキーな質問。

トップレベル関数にprotectedを使用できますか？

いいえ、protectedはクラス/インターフェースのメンバーにのみ関連し、トップレベル要素はサポートされていません。

トップレベル関数をinternalとして宣言した場合、他のモジュール内で見えるでしょうか？

いいえ。現在のJAR/Gradleモジュールの範囲内でのみ見えます。

privateクラスとprivateトップレベル関数の違いは何ですか？

privateクラス: 現在のファイル内でのみ見え、ファイル外で使用できません。
privateトップレベル関数またはプロパティ: 同様に、現在のファイル内でのみ見えます。

例:

// file: Utils.kt
private fun helper() { /* ... */ } // このファイル内でのみ見える
internal fun useful() { /* ... */ } // モジュール全体で見える

よくあるエラーとアンチパターン

すべての宣言に対してpublicデフォルトを使用すると、自動補完やAPIが"汚染"されます。
外部クライアント向けのライブラリにinternalを使用すると、必要なpublic APIが隠れます。
protectedの混乱、トップレベルへの適用の試み。

実際の例

ネガティブケース

テストユーティリティがpublicとして宣言され、アーティファクトに含まれるため、ライブラリのクライアントに混乱をもたらします — public APIに関連しないすべてが見えるようになります。

利点:

迅速な統合。

欠点:

公開APIのサイズが増加し、"偶発的な"メソッドがアクセス可能になる。

ポジティブケース

内部関数がprivateとして宣言され、内部で一般的に使用されるユーティリティがinternalの可視性を持ち、慎重に考慮されたインターフェースのみがpublicとして提供されます。