Merge branch 'main' into fix/findIndex

Author: D-Sketon

.github/CONTRIBUTING-ko_kr.md

@@ -4,6 +4,16 @@
 
 > es-toolkit에 기여할 때, [행동 강령(Code of conduct)](./CODE_OF_CONDUCT.md)을 준수해 주세요. 허용되는 행동과 허용되지 않는 행동을 준수해 주세요.
 
+## 패키지 매니저
+
+이 프로젝트는 **Yarn 4**를 패키지 매니저로 사용해요. `yarn install`을 실행하면 Corepack을 통해 올바른 버전이 자동으로 설치돼요.
+
+시작하는 방법:
+
+1. Node.js가 설치되어 있는지 확인하세요 (필요한 버전은 `.nvmrc` 파일을 참고하세요)
+2. Corepack을 활성화하세요: `corepack enable`
+3. 의존성을 설치하세요: `yarn install`
+
 ## 1. 설계 원칙
 
 es-toolkit 프로젝트는 성능, 구현의 단순함, 그리고 꼼꼼한 문서화가 중요해요. 다양한 기능과 옵션을 지원하기보다, 성능이 뛰어나고 안정적으로 작동하는 핵심 유틸리티들만 제공하려고 해요.

.github/CONTRIBUTING.md

@@ -4,6 +4,16 @@ We welcome contribution from everyone in the community. All communications in th
 
 > Every contributor to es-toolkit should adhere to our Code of Conduct. Please read the [full text](./CODE_OF_CONDUCT.md) to understand what actions will and will not be tolerated.
 
+## Package Manager
+
+This project uses **Yarn 4** as its package manager. The correct version is automatically installed via Corepack when you run `yarn install`.
+
+To get started:
+
+1. Make sure you have Node.js installed (see `.nvmrc` for the required version)
+2. Enable Corepack: `corepack enable`
+3. Install dependencies: `yarn install`
+
 ## 1. Our Design Principles
 
 Note that we value performance, simplicity of implementation, and detailed documentations. We do not aim for supporting a variety of features and options. Our goal is to provide a small set of performant and well-functioning utilities.

.github/workflows/autofix.yml

@@ -19,11 +19,10 @@ jobs:
     steps:
       - uses: actions/checkout@v5
       - run: corepack enable
-      - uses: actions/setup-node@v5
+      - uses: actions/setup-node@v6
         with:
-          cache: 'yarn'
-          cache-dependency-path: 'yarn.lock'
           node-version-file: '.nvmrc'
+          cache: 'yarn'
       - run: yarn install
       - run: yarn prettier --write .
       - run: yarn run packlint

.github/workflows/broken-link-checker.yml

@@ -8,15 +8,15 @@ on:
 
 jobs:
   broken-link-checker:
+    if: github.repository == 'toss/es-toolkit'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
       - run: corepack enable
-      - uses: actions/setup-node@v5
+      - uses: actions/setup-node@v6
         with:
-          cache: 'yarn'
-          cache-dependency-path: 'yarn.lock'
           node-version-file: '.nvmrc'
+          cache: 'yarn'
       - run: yarn install
       - name: Check broken link
         env:

.github/workflows/codecov.yml

@@ -15,7 +15,7 @@ jobs:
     steps:
       - uses: actions/checkout@v5
       - run: corepack enable
-      - uses: actions/setup-node@v5
+      - uses: actions/setup-node@v6
         with:
           node-version-file: .nvmrc
           cache: 'yarn'

.github/workflows/release.yml

@@ -9,6 +9,7 @@ on:
 
 jobs:
   release:
+    if: github.repository == 'toss/es-toolkit'
     runs-on: ubuntu-latest
     permissions:
       id-token: write
@@ -18,11 +19,10 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v5
       - run: corepack enable
-      - uses: actions/setup-node@v5
+      - uses: actions/setup-node@v6
         with:
-          cache: 'yarn'
-          cache-dependency-path: 'yarn.lock'
           node-version-file: '.nvmrc'
+          cache: 'yarn'
       - name: Update npm
         run: npm install -g [email protected]
       - uses: denoland/setup-deno@v2
@@ -84,17 +84,16 @@ jobs:
         working-directory: ${{ github.workspace }}/out/
 
   deploy-docs:
-    if: github.event_name == 'push' && github.ref_type == 'tag'
+    if: github.repository == 'toss/es-toolkit' && github.event_name == 'push' && github.ref_type == 'tag'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v5
       - run: corepack enable
-      - uses: actions/setup-node@v5
+      - uses: actions/setup-node@v6
         with:
-          cache: 'yarn'
-          cache-dependency-path: 'yarn.lock'
           node-version-file: '.nvmrc'
+          cache: 'yarn'
       - name: Install dependencies
         run: yarn install
       - name: Deploy a docs site

.scripts/docs/operations/render/en.ts

@@ -56,14 +56,14 @@ function returns(item: DocumentationItem) {
 
   if (item.returns.type == null) {
     return `
-### Returns
+#### Returns
 
 (\`${item.returns.type}\`): ${item.returns.document} 
     `.trim();
   }
 
   return `
-### Returns
+#### Returns
 
 (\`${item.returns.type}\`): ${item.returns.document}
   `.trim();

.scripts/docs/operations/render/ja.ts

@@ -57,7 +57,7 @@ function returns(item: DocumentationItem) {
   }
 
   return `
-### 戻り値
+#### 戻り値
 
 (\`${item.returns.type}\`): ${item.returns.document}
   `.trim();

.scripts/docs/operations/render/ko.ts

@@ -55,7 +55,7 @@ function returns(item: DocumentationItem) {
   }
 
   return `
-### 반환 값
+#### 반환 값
 
 (\`${item.returns.type}\`): ${item.returns.document}
   `.trim();

.scripts/docs/operations/render/zh_hans.ts

@@ -55,7 +55,7 @@ function returns(item: DocumentationItem) {
   }
 
   return `
-### 返回值
+#### 返回值
 
 (\`${item.returns.type}\`): ${item.returns.document}
   `.trim();