NaverPayDev · yujeong-jeon · May 11, 2026 · May 7, 2026
@@ -72,12 +72,11 @@ Latest benchmark results comparing hidash vs lodash performance.
 | [zip](https://github.com/NaverPayDev/hidash/blob/main/src/zip.ts) | src/zip.bench.ts > zip performance | hidash is 1.14x faster | 49.01 🏆 | 43.09 |
 
 > Note: Higher operations per second (ops/sec) numbers are better. Each test compares hidash vs lodash implementation.
-> 
+>
 > ⚠️ indicates where hidash is slower than lodash.
-> 
+>
 > 🏆 indicates the faster implementation.
 
-
 _Last updated: 2026-03-05_
 
-*Last updated by [GitHub Actions](https://github.com/NaverPayDev/hidash/actions/runs/22704377699)*
+*Last updated by [GitHub Actions](https://github.com/NaverPayDev/hidash/actions/runs/22704377699)*
@@ -0,0 +1,63 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What This Project Is
+
+`@naverpay/hidash` is a zero-dependency, performance-focused drop-in replacement for Lodash. Each utility is exported via subpath imports (e.g., `import has from '@naverpay/hidash/has'`). Namespace imports are **not supported**.
+
+## Commands
+
+```bash
+pnpm test                        # run all tests
+pnpm test -- src/has.test.ts     # run a single test file
+pnpm bench                       # run all benchmarks
+pnpm build                       # clean + vite build (dual CJS/ESM output)
+pnpm lint                        # eslint check
+pnpm lint:fix                    # eslint fix
+pnpm prettier                    # prettier check
+pnpm prettier:fix                # prettier fix
+pnpm run generate                # regenerate index.ts + package.json exports from src/*.ts
+```
+
+## Architecture
+
+### One file = one utility
+
+Every utility lives as a single file in `src/` with a strict pattern enforced by `eslint-plugin-hidash`:
+
+- `src/<name>.ts` — implementation (must have both a named export and a default export)
+- `src/<name>.test.ts` — tests (compare against lodash to verify compatibility)
+- `src/<name>.bench.ts` — benchmarks (measure performance vs lodash)
+- Shared types live in `src/internal/types.ts`
+
+### Code generation
+
+`pnpm run generate` (`scripts/generate-utils.mjs`) scans `src/*.ts` (excluding test/bench files) and auto-generates:
+
+1. `index.ts` — moduleMap used by the Vite build config
+2. `package.json` `exports` field — subpath export entries for every utility
+
+**Run `pnpm run generate` after adding or removing any utility file.**
+
+### Build output
+
+Vite (via `@naverpay/pite`) produces per-function output: `<name>.js`, `<name>.mjs`, `<name>.d.ts`, `<name>.d.mts`. These are copied to the package root at publish time (`scripts/pre-build.mjs`) and cleaned up post-publish.
+
+### Release process
+
+Uses Changesets. Create a changeset file, merge to `main`, and the GitHub Actions publish workflow handles versioning and npm publish automatically.
+
+## Key Constraints
+
+- **Lodash behavioral compatibility is mandatory.** Tests assert `has(x, y) === _has(x, y)` against real lodash. Every edge case must match lodash's output exactly.
+- **Performance must be equal to or better than lodash.** Benchmarks verify this.
+- **Zero runtime dependencies.** lodash is a devDependency used only in tests/benchmarks.
+- **Dual export required.** Each `src/<name>.ts` must export both `export function <name>` and `export default <name>`. This is enforced by the `enforce-single-function-dual-export` ESLint rule.
+- **JSDoc header comments are required** on exported functions: `@description`, `@param`, `@returns`.
+- **Comments in English only.**
+
+## Git Hooks (lefthook)
+
+- **pre-commit**: eslint, prettier, markdownlint (parallel, on staged files)
+- **commit-msg**: `@naverpay/commit-helper` validates commit message format
@@ -0,0 +1,127 @@
+# @naverpay/hidash
+
+> A modern, zero-dependency, performance-focused drop-in replacement for Lodash. 100% behavior-compatible with Lodash, written in TypeScript with full type definitions, and shipped as dual CJS/ESM with subpath imports for optimal tree-shaking.
+
+## Installation
+
+```bash
+npm install @naverpay/hidash
+# or
+pnpm add @naverpay/hidash
+# or
+yarn add @naverpay/hidash
+```
+
+## Usage
+
+Each utility is exported via a dedicated subpath. Namespace imports are **not supported**.
+
+```typescript
+import has from '@naverpay/hidash/has'
+import isEmpty from '@naverpay/hidash/isEmpty'
+import debounce from '@naverpay/hidash/debounce'
+
+has({a: {b: 1}}, 'a.b')   // true
+isEmpty([])               // true
+const fn = debounce(() => {}, 200)
+```
+
+The following will **not** work:
+
+```typescript
+import {has, isEmpty} from '@naverpay/hidash' // ❌ namespace imports are not supported
+```
+
+Each subpath provides both a default export and a named export, with matching CJS (`*.js`, `*.d.ts`) and ESM (`*.mjs`, `*.d.mts`) artifacts.
+
+## Design Principles
+
+- **Behavior-compatible with Lodash.** Every utility is asserted against the real `lodash` implementation in tests; edge cases match Lodash exactly.
+- **Performance >= Lodash.** Each utility ships with a benchmark verifying parity or improvement.
+- **Zero runtime dependencies.** `lodash` is only a devDependency for compatibility testing.
+- **Tree-shakable by construction.** One file per utility means bundlers only pull what you import.
+
+## API
+
+- `assign`: Assigns the values of all enumerable properties from one or more source objects to a target object.
+- `before`: Creates a function that invokes `func` as long as it's called less than `initialN` times.
+- `chunk`: Creates an array of elements split into groups the length of `size`.
+- `clamp`: Clamps `number` within inclusive bounds.
+- `clone`: Creates a shallow clone of `value`.
+- `cloneDeep`: Creates a deep clone of `value`.
+- `debounce`: Creates a debounced function that delays invoking `func` until after `waitMilliseconds` have elapsed since the last time the debounced function was invoked.
+- `delay`: Invokes `func` after `wait` milliseconds.
+- `difference`: Creates an array of `array` values not included in the other given arrays.
+- `entries`: lodash-compatible `entries`.
+- `eq`: Performs a SameValueZero comparison between two values to determine if they are equivalent.
+- `every`: Checks if the `predicate` function returns a truthy value for all elements in the `collection`.
+- `filter`: Creates an array of elements from a collection that satisfy a given predicate.
+- `find`: Iterates over elements of collection, return first matched element
+- `findIndex`: Finds the **index** of the first element in an array that satisfies a given predicate.
+- `findLastIndex`: Finds the **last index** of an element in an array that satisfies a given predicate.
+- `first`: Gets the first element of an array.
+- `flatten`: Flattens a nested array a single level deep.
+- `flow`: Creates a composite function that invokes the provided functions in sequence from left to right.
+- `get`: Gets the property value at path of object.
+- `groupBy`: lodash-compatible `groupBy`.
+- `gt`: lodash-compatible `gt`.
+- `has`: lodash-compatible `has` (see https://unpkg.com/browse/lodash.has@4.5.2/index.js).
+- `identity`: lodash-compatible `identity` (see https://unpkg.com/lodash@4.17.21/identity.js).
+- `includes`: lodash-compatible `includes`.
+- `isArray`: lodash-compatible `isArray` (see https://unpkg.com/lodash.isarray@4.0.0/index.js).
+- `isEmpty`: lodash-compatible `isEmpty` (see https://unpkg.com/browse/lodash.isempty@4.4.0/index.js).
+- `isEqual`: Performs a **deep equality comparison** between two values.
+- `isError`: lodash-compatible `isError`.
+- `isFunction`: Checks if the provided value is a function.
+- `isMap`: Checks if the provided value is a `Map` object.
+- `isNil`: lodash-compatible `isNil` (see https://unpkg.com/browse/lodash.isnil@4.0.0/index.js).
+- `isNull`: lodash-compatible `isNull` (see https://unpkg.com/lodash@4.17.21/isNull.js).
+- `isNumber`: lodash-compatible `isNumber`.
+- `isObject`: lodash-compatible `isObject` (see https://unpkg.com/browse/lodash.isobject@3.0.2/index.js).
+- `isPlainObject`: lodash-compatible `isPlainObject`.
+- `isSet`: Checks if the provided value is a `Set` object.
+- `isString`: lodash-compatible `isString`.
+- `isSymbol`: lodash-compatible `isSymbol`.
+- `isUndefined`: lodash-compatible `isUndefined`.
+- `join`: lodash-compatible `join`.
+- `keys`: lodash-compatible `keys` (see https://unpkg.com/browse/lodash.keys@4.2.0/index.js).
+- `last`: lodash-compatible `last`.
+- `lt`: lodash-compatible `lt`.
+- `map`: lodash-compatible `map`.
+- `mapValues`: lodash-compatible `mapValues`.
+- `memoize`: lodash-compatible `memoize`.
+- `merge`: lodash-compatible `merge`.
+- `omit`: lodash-compatible `omit`.
+- `once`: lodash-compatible `once`.
+- `pick`: lodash-compatible `pick`.
+- `pickBy`: Creates an object composed of the properties that pass a given predicate.
+- `range`: lodash-compatible `range`.
+- `repeat`: Repeats a string `n` times using an efficient algorithm.
+- `reverse`: lodash-compatible `reverse`.
+- `shuffle`: lodash-compatible `shuffle`.
+- `size`: lodash-compatible `size` (see https://unpkg.com/lodash.size@4.2.0/index.js).
+- `sleep`: lodash-compatible `sleep`.
+- `some`: Checks if **any** element in a collection satisfies a given predicate.
+- `sortBy`: Sort in ascending order
+- `sum`: lodash-compatible `sum` (see https://unpkg.com/lodash.sum).
+- `sumBy`: lodash-compatible `sumBy`.
+- `throttle`: lodash-compatible `throttle`.
+- `times`: lodash-compatible `times`.
+- `toNumber`: lodash-compatible `toNumber`.
+- `toPairs`: Converts a given object, array, or collection into an array of key-value pairs.
+- `toString`: lodash-compatible `toString`.
+- `transform`: lodash-compatible `transform`.
+- `trim`: lodash-compatible `trim`.
+- `union`: lodash-compatible `union`.
+- `uniq`: lodash-compatible `uniq`.
+- `uniqBy`: Creates a duplicate-free version of an array.
+- `uniqWith`: lodash-compatible `uniqWith`.
+- `unzip`: Transposes an array of arrays (e.g., the output of `zip`) so that the first array contains the first element of each input array, the second array contains the second element, and so on.
+- `values`: Returns an array of the values of the given object.
+- `zip`: Combines multiple arrays into a single array of grouped elements, where each group contains the elements at the same index from each input array.
+
+## Repository
+
+- Source: https://github.com/NaverPayDev/hidash
+- Issues / feature requests: https://github.com/NaverPayDev/hidash/issues
+- License: MIT
@@ -11,7 +11,8 @@
         "internal/*.js",
         "internal/*.mjs",
         "internal/*.d.ts",
-        "internal/*.d.mts"
+        "internal/*.d.mts",
+        "llms.txt"
     ],
     "exports": {
         "./package.json": "./package.json",
@@ -795,7 +796,8 @@
         "changeset-version": "changeset version && pnpm run md:fix",
         "prepublish": "node scripts/pre-build.mjs",
         "postpublish": "rimraf ./*.js ./*.mjs ./*.d.ts ./*.d.mts",
-        "generate": "node ./scripts/generate-utils.mjs"
+        "generate": "node ./scripts/generate-utils.mjs && node ./scripts/generate-llms-txt.mjs",
+        "generate:llms": "node ./scripts/generate-llms-txt.mjs"
     },
     "author": "yc.effort@navercorp.com",
     "license": "MIT",