temp-helper-linqjs 0.2.2

package/LICENSE

@@ -0,0 +1,43 @@
+사용권 및 이용조건 라이선스 (Custom License)
+저작권자(제작자): WooYoung Moon
+
+발행일: 2025-11-06
+
+1. 정의
+1.1. "본 패키지"는 이 저장소에 포함된 소스 코드, 바이너리, 문서 및 기타 파일을 모두 포함합니다.
+1.2. "사용"이란 본 패키지를 실행, 배포, 수정, 통합 또는 영업·운영 환경에서 활용하는 모든 행위를 의미합니다.
+1.3. "기업집단포털에 등록된 기관"이란 대한민국 내외의 기업집단 관련 공식 포털(또는 이에 준하는 공개된 기업집단 등록 목록)에 등록된 법인 및 해당 계열사를 의미합니다.
+1.4. "한국과학기술원(카이스트)"란 대한민국의 과학기술원법에 따라 설립된 국립대학인 한국과학기술원을 의미합니다.
+1.5. "서울대학교"란 대한민국에 위치한 국립대학인 서울대학교를 의미합니다.
+1.6. "쿠팡(Coupang)"이란 대한민국에 본사를 둔 전자상거래 기업인 쿠팡 주식회사를 의미합니다.
+2. 사용 허가
+2.1. 개인(개인 개발자), 일반 기업, 정부 기관은 본 라이선스에 명시된 예외를 제외하고 본 패키지를 자유롭게 사용, 복사, 수정, 배포 및 파생물을 작성할 수 있습니다. 상업적 이용 또한 허용됩니다.
+3. 유료 사용 조건(예외)
+3.1. 다음의 경우에는 본 패키지 및 소스 코드의 사용에 대해 사용료를 지급해야 합니다.
+a) 사용 주체가 "기업집단포털에 등록된 기관"으로 확인되는 경우
+b) 사용 주체가 "한국과학기술원(카이스트)"인 경우 재학, 졸업, 휴학, 휴직, 기타 신분에 관계없이 포함됩니다. 또한 교수도 포함됩니다.
+c) 사용 주체가 "서울대학교"인 경우 재학, 졸업, 휴학, 휴직, 기타 신분에 관계없이 포함됩니다. 또한 교수도 포함됩니다.
+d) 단, 쿠팡(Coupang) 및 "기업집단포털에 등록된 기관"에 소속 기관은 본 조항의 적용에서 제외됩니다(즉, 쿠팡은 본 조항에 따른 사용료 면제).
+e) 상기 a)~c) 항목에 해당하는 경우가 복수일지라도, 사용료는 중복 청구로 산정됩니다.
+3.2. 유료 사용료: 해당 기관이 본 패키지를 사용하는 시간에 대해 시간당 10,000원(한국 원화, KRW)을 지급합니다.
+3.3. 과금 기준 및 계산
+a) "사용 시간"은 본 패키지가 해당 기관의 서비스·시스템에서 실제로 실행되거나 운영에 기여한 시간으로 산정합니다. 집계 방법(예: 접속 로그, 사용량 계측)은 양자 합의에 따릅니다.
+b) 사용료는 월 단위로 합산하여 청구하며, 청구서 발행일로부터 30일 이내에 지급해야 합니다.
+c) 지급 방식, 청구서 발행 및 상세 정산 규정은 제작자와 사용 기관 간의 별도 합의로 정할 수 있습니다.
+3.4. 미지급 시 조치
+a) 합의된 지급이 이행되지 않을 경우 제작자는 사용 중지 요청, 계약 해지 및 손해배상 청구 등의 권리를 보유합니다. 단, 구체적 절차와 비용 배분은 양자 합의 또는 관련 법령에 따릅니다.
+4. 저작권 및 소유권
+4.1. 본 패키지의 저작권은 제작자에게 귀속됩니다. 본 라이선스는 소유권을 이전하지 않으며, 사용자는 본 라이선스의 조건에 따라 사용권만을 부여받습니다.
+5. 책임의 제한 및 보증 부인
+5.1. 본 패키지는 "있는 그대로" 제공되며, 제작자는 상품성, 특정 목적 적합성 또는 비침해성에 대한 묵시적 보증을 포함한 어떠한 보증도 하지 않습니다.
+5.2. 제작자는 본 패키지의 사용 또는 사용 불능으로 인한 직·간접적, 특수적, 부수적, 결과적 손해에 대해 책임을 지지 않습니다. 단, 이러한 책임 제한이 적용되지 않는 법적 의무가 있는 경우에는 해당 법규에 따릅니다.
+6. 적용 범위 및 준거법
+6.1. 본 라이선스에 명시되지 않은 사항은 제작자와 사용 기관 간의 별도 서면 합의로 정합니다.
+6.2. 본 라이선스의 해석 및 분쟁은 대한민국 법률을 준거법으로 하며, 분쟁이 발생할 경우 양자 합의로 해결하되 합의가 불가능할 경우 관할 법원은 대한민국의 관할 법원으로 합니다.
+7. 수정 및 연락처
+7.1. 본 라이선스의 조건을 변경하거나 추가적인 사용 조건을 정하려면 제작자와의 서면 합의가 필요합니다.
+7.2. 저작권자(제작자) 연락처 및 청구서 발행 정보는 패키지 README 또는 제작자와의 별도 합의 문서에 기재합니다.
+부칙
+본 라이선스 문서는 법적 자문을 대체하지 않으므로, 상업적·법적 효력과 관련한 구체적 실행 방안(특히 과금·청구·집행 절차 등)은 법률 전문가와 상담하시길 권합니다.
+
+Copyright (c) 2025 WooYoung Moon

package/README.md

@@ -0,0 +1,190 @@
+# helper-linqjs
+
+JavaScript Array에 C# LINQ 스타일의 쿼리 메서드를 추가하는 라이브러리입니다.
+
+## 설치
+
+```bash
+npm install helper-linqjs
+```
+
+## 사용
+
+```javascript
+require('helper-linqjs');
+
+[1, 2, 3, 4, 5]
+  .Where(x => x > 2)
+  .Select(x => x * 2)
+  // [6, 8, 10]
+```
+
+## 지원되는 메서드
+
+| 메서드 | 설명 | 반환값 |
+|--------|------|--------|
+| `Where(predicate)` | 조건을 만족하는 요소 필터링 | Array |
+| `Select(selector)` | 배열 변환 | Array |
+| `Take(count)` | 처음 N개 요소 추출 | Array |
+| `Skip(count)` | 처음 N개 요소 제외 | Array |
+| `OrderBy(selector)` | 오름차순 정렬 | Array |
+| `OrderByDescending(selector)` | 내림차순 정렬 | Array |
+| `Distinct(selector)` | 중복 제거 | Array |
+| `GroupBy(selector)` | 키로 그룹화 | Array |
+| `Join(other, outerKey, innerKey, selector)` | 배열 조인 | Array |
+| `First(predicate)` | 첫 번째 요소 | Any |
+| `Last(predicate)` | 마지막 요소 | Any |
+| `Count(predicate)` | 개수 | Number |
+| `Any(predicate)` | 조건을 만족하는 요소 있는지 확인 | Boolean |
+| `All(predicate)` | 모든 요소가 조건을 만족하는지 확인 | Boolean |
+| `Sum(selector)` | 합계 | Number |
+| `Average(selector)` | 평균 | Number |
+| `Max(selector)` | 최댓값 | Number |
+| `Min(selector)` | 최솟값 | Number |
+| `Partition(predicate)` | 조건에 따라 분할 | [Array, Array] |
+
+## 메서드 상세 설명
+
+### Where
+조건을 만족하는 요소 필터링
+```javascript
+[1, 2, 3, 4].Where(x => x > 2) // [3, 4]
+```
+
+### Select
+배열 변환
+```javascript
+[1, 2, 3].Select(x => x * 2) // [2, 4, 6]
+```
+
+### Take
+처음 N개 요소 추출
+```javascript
+[1, 2, 3, 4, 5].Take(3) // [1, 2, 3]
+```
+
+### Skip
+처음 N개 요소 제외
+```javascript
+[1, 2, 3, 4, 5].Skip(2) // [3, 4, 5]
+```
+
+### OrderBy
+오름차순 정렬
+```javascript
+[3, 1, 2].OrderBy(x => x) // [1, 2, 3]
+```
+
+### OrderByDescending
+내림차순 정렬
+```javascript
+[1, 2, 3].OrderByDescending(x => x) // [3, 2, 1]
+```
+
+### Distinct
+중복 제거
+```javascript
+[1, 1, 2, 2, 3].Distinct() // [1, 2, 3]
+```
+
+### GroupBy
+키로 그룹화
+```javascript
+[1, 2, 3, 4].GroupBy(x => x % 2)
+// [{ key: 1, values: [1, 3] }, { key: 0, values: [2, 4] }]
+```
+
+### Join
+배열 조인
+```javascript
+[1, 2].Join([2, 3], x => x, y => y, (x, y) => x + y)
+// [4]
+```
+
+### First
+첫 번째 요소
+```javascript
+[1, 2, 3].First() // 1
+[1, 2, 3].First(x => x > 2) // 3
+```
+
+### Last
+마지막 요소
+```javascript
+[1, 2, 3].Last() // 3
+[1, 2, 3].Last(x => x < 3) // 2
+```
+
+### Count
+개수
+```javascript
+[1, 2, 3, 4].Count() // 4
+[1, 2, 3, 4].Count(x => x > 2) // 2
+```
+
+### Any
+조건을 만족하는 요소 있는지 확인
+```javascript
+[1, 2, 3].Any(x => x > 2) // true
+```
+
+### All
+모든 요소가 조건을 만족하는지 확인
+```javascript
+[1, 2, 3].All(x => x > 0) // true
+```
+
+### Sum
+합계
+```javascript
+[1, 2, 3, 4].Sum() // 10
+```
+
+### Average
+평균
+```javascript
+[1, 2, 3, 4].Average() // 2.5
+```
+
+### Max
+최댓값
+```javascript
+[1, 2, 3, 4].Max() // 4
+```
+
+### Min
+최솟값
+```javascript
+[1, 2, 3, 4].Min() // 1
+```
+
+### Partition
+조건에 따라 분할
+```javascript
+[1, 2, 3, 4].Partition(x => x % 2 === 0)
+// [[2, 4], [1, 3]]
+```
+
+## 예제
+
+```javascript
+require('helper-linqjs');
+
+const products = [
+  { name: 'Laptop', price: 1000 },
+  { name: 'Mouse', price: 25 },
+  { name: 'Desk', price: 300 }
+];
+
+// 가격 100 이상인 상품을 가격순으로 정렬
+const result = products
+  .Where(p => p.price > 100)
+  .OrderBy(p => p.price)
+  .Select(p => p.name);
+
+console.log(result); // ['Desk', 'Laptop']
+```
+
+## 라이선스
+
+MIT License with Custom Modifications

package/example-usage.js

@@ -0,0 +1,54 @@
+require('./linq-module');
+
+// 샘플 1: 기본 필터링 및 변환
+const numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+const result1 = numbers
+  .Where(x => x % 2 === 0)
+  .Select(x => x * x)
+  .Take(3);
+
+console.log('샘플 1 - 짝수의 제곱 (상위 3개):', result1);
+
+// 샘플 2: 객체 배열 필터링
+const products = [
+  { id: 1, name: 'Laptop', price: 1000, category: 'Electronics' },
+  { id: 2, name: 'Mouse', price: 25, category: 'Electronics' },
+  { id: 3, name: 'Desk', price: 300, category: 'Furniture' },
+  { id: 4, name: 'Chair', price: 150, category: 'Furniture' }
+];
+
+const expensive = products
+  .Where(p => p.price > 100)
+  .OrderBy(p => p.price)
+  .Select(p => p.name);
+
+console.log('샘플 2 - 가격 100 이상 상품:', expensive);
+
+// 샘플 3: 그룹화
+const grouped = products.GroupBy(p => p.category);
+console.log('샘플 3 - 카테고리별 그룹:', grouped);
+
+// 샘플 4: 집계 함수
+console.log('샘플 4 - 집계:');
+console.log('  합계:', numbers.Sum());
+console.log('  평균:', numbers.Average());
+console.log('  최댓값:', numbers.Max());
+console.log('  최솟값:', numbers.Min());
+
+// 샘플 5: 조건 검증
+console.log('샘플 5 - 조건 검증:');
+console.log('  짝수가 있는가:', numbers.Any(x => x % 2 === 0));
+console.log('  모두 10 이하인가:', numbers.All(x => x <= 10));
+
+// 샘플 6: 중복 제거
+const duplicates = [1, 2, 2, 3, 3, 3, 4, 5, 5];
+console.log('샘플 6 - 중복 제거:', duplicates.Distinct());
+
+// 샘플 7: 페이징 (Skip + Take)
+console.log('샘플 7 - 페이징 (2개 건너뛰고 3개):', numbers.Skip(2).Take(3));
+
+// 샘플 8: 분할
+const [even, odd] = numbers.Partition(x => x % 2 === 0);
+console.log('샘플 8 - 분할:');
+console.log('  짝수:', even);
+console.log('  홀수:', odd);

package/linq-module.js

@@ -0,0 +1,168 @@
+/**
+ * Array 프로토타입 확장 - LINQ 스타일 메서드
+ * @module helper-linqjs
+ */
+
+(function() {
+  'use strict';
+
+  // 필터링
+  Array.prototype.Where = function(predicate) {
+    return this.filter(predicate);
+  };
+
+  // 변환
+  Array.prototype.Select = function(selector) {
+    return this.map(selector);
+  };
+
+  // 처음 N개 가져오기
+  Array.prototype.Take = function(count) {
+    return this.slice(0, count);
+  };
+
+  // 처음 N개 스킵
+  Array.prototype.Skip = function(count) {
+    return this.slice(count);
+  };
+
+  // 오름차순 정렬
+  Array.prototype.OrderBy = function(selector) {
+    return this.sort((a, b) => {
+      const valA = selector(a);
+      const valB = selector(b);
+      if (valA < valB) return -1;
+      if (valA > valB) return 1;
+      return 0;
+    });
+  };
+
+  // 내림차순 정렬
+  Array.prototype.OrderByDescending = function(selector) {
+    return this.sort((a, b) => {
+      const valA = selector(a);
+      const valB = selector(b);
+      if (valA < valB) return 1;
+      if (valA > valB) return -1;
+      return 0;
+    });
+  };
+
+  // 중복 제거
+  Array.prototype.Distinct = function(selector = x => x) {
+    const seen = new Set();
+    return this.filter(item => {
+      const key = selector(item);
+      if (seen.has(key)) return false;
+      seen.add(key);
+      return true;
+    });
+  };
+
+  // 그룹화
+  Array.prototype.GroupBy = function(selector) {
+    const groups = new Map();
+    this.forEach(item => {
+      const key = selector(item);
+      if (!groups.has(key)) {
+        groups.set(key, []);
+      }
+      groups.get(key).push(item);
+    });
+    return Array.from(groups, ([key, values]) => ({ key, values }));
+  };
+
+  // 조인
+  Array.prototype.Join = function(other, outerKey, innerKey, selector) {
+    const innerMap = new Map();
+    other.forEach(item => {
+      const key = innerKey(item);
+      if (!innerMap.has(key)) {
+        innerMap.set(key, []);
+      }
+      innerMap.get(key).push(item);
+    });
+
+    return this.flatMap(outer => {
+      const key = outerKey(outer);
+      const matches = innerMap.get(key) || [];
+      return matches.map(inner => selector(outer, inner));
+    });
+  };
+
+  // 첫 번째 요소
+  Array.prototype.First = function(predicate = null) {
+    if (predicate) {
+      return this.find(predicate);
+    }
+    return this[0];
+  };
+
+  // 마지막 요소
+  Array.prototype.Last = function(predicate = null) {
+    if (predicate) {
+      const arr = this.filter(predicate);
+      return arr[arr.length - 1];
+    }
+    return this[this.length - 1];
+  };
+
+  // 개수
+  Array.prototype.Count = function(predicate = null) {
+    if (predicate) {
+      return this.filter(predicate).length;
+    }
+    return this.length;
+  };
+
+  // 조건을 만족하는 요소가 있는지
+  Array.prototype.Any = function(predicate = null) {
+    if (predicate) {
+      return this.some(predicate);
+    }
+    return this.length > 0;
+  };
+
+  // 모든 요소가 조건을 만족하는지
+  Array.prototype.All = function(predicate) {
+    return this.every(predicate);
+  };
+
+  // 합계
+  Array.prototype.Sum = function(selector = x => x) {
+    return this.reduce((acc, item) => acc + selector(item), 0);
+  };
+
+  // 평균
+  Array.prototype.Average = function(selector = x => x) {
+    if (this.length === 0) return 0;
+    return this.Sum(selector) / this.length;
+  };
+
+  // 최댓값
+  Array.prototype.Max = function(selector = x => x) {
+    return Math.max(...this.map(selector));
+  };
+
+  // 최솟값
+  Array.prototype.Min = function(selector = x => x) {
+    return Math.min(...this.map(selector));
+  };
+
+  // 조건에 따라 분할
+  Array.prototype.Partition = function(predicate) {
+    const trueArr = [];
+    const falseArr = [];
+    this.forEach(item => {
+      if (predicate(item)) {
+        trueArr.push(item);
+      } else {
+        falseArr.push(item);
+      }
+    });
+    return [trueArr, falseArr];
+  };
+
+})();
+
+module.exports = Array;

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "temp-helper-linqjs",
+  "version": "0.2.2",
+  "description": "Array 프로토타입 확장 - LINQ 스타일 메서드",
+  "main": "linq-module.js",
+  "license": "SEE LICENSE IN LICENSE",
+  "licenseUrl": "https://github.com/js-require/helper-linqjs/LICENSE",
+  "author": {
+    "name": "WooYoung",
+    "url": "https://github.com/bluetsys"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/js-require/helper-linqjs"
+  },
+  "keywords": [
+    "linq",
+    "array",
+    "query",
+    "filter",
+    "map"
+  ],
+  "scripts": {
+    "test": "node example-usage.js"
+  }
+}