🧰 헬퍼 함수

shared/helpers 패키지는 여러 패키지와 앱에서 공통적으로 사용할 수 있는 범용 유틸리티 함수(헬퍼 함수)들을 제공합니다.

🎯 주요 목적

중복되는 로직을 한 곳에 모아 재사용성을 높이고, 코드 품질과 유지보수성을 향상시킵니다.
npm 에 배포하지는 않고, monorepo 내에서만 사용되는 헬퍼 함수들을 제공합니다.

📁 주요 구성

함수 모음:
문자열 처리, 배열/객체 조작, 타입 체크, 경로 처리 등 다양한 상황에서 활용할 수 있는 헬퍼 함수들이 포함되어 있습니다.
타입 정의:
TypeScript 기반으로 타입 안정성을 제공합니다.

🧑‍💻 ️다른 워크스페이스에서 사용하기

다른 워크스페이스에서 이 헬퍼 함수를 사용하려면, 다음 단계를 따르면 됩니다:

➕ 의존성 추가

해당 패키지를 의존성으로 추가하기 위해 package.json 파일에 다음과 같이 작성합니다:


{
  "dependencies": {
    "@repo/helpers": "workspace:*"
  }
}

🧑‍💻️ 사용 예시

이제 헬퍼 함수를 임포트하여 사용할 수 있습니다. 예를 들어, helpers 패키지에서 제공하는 runWithGlob 함수를 사용하는 예시는 다음과 같습니다:

packages/browser-utils/vite.config.ts


/// <reference types="vitest" />
import { defineConfig } from "vite";
import { runWithGlob } from "@repo/helpers/runWithGlob";
import { resolve } from "path";
 
export default defineConfig({
  // ...existing code...
  build: {
    // ...existing code...
    lib: {
      entry: Object.fromEntries(
        runWithGlob(
          "src/**/*.{ts,tsx}",
          (file) => [
            // 엔트리 이름
            file.replace(/^src\//, "").replace(/index\.(ts|tsx)$/, ""),
            // 절대 경로
            resolve(__dirname, file),
          ],
          ["src/**/*.{d,spec}.ts"],
        ),
      ),
      // ...existing code...
    },
  },
  // ...existing code...
});

📌 참고

실제 함수 목록과 사용법은 shared/helpers 패키지의 소스와 README를 참고하세요.
공통적으로 필요한 로직이 있다면 이 패키지에 추가하여 여러 곳에서 재사용할 수 있습니다.