@simplysm/orm-common 13.0.100 → 14.0.1

package/src/types/expr.ts

@@ -2,18 +2,18 @@ import type { ColumnPrimitive, DataType } from "./column";
 import type { SelectQueryDef } from "./query-def";
 
 /**
- * Date operation unit
+ * 날짜 연산 단위
  *
- * Used in Date functions like dateDiff, dateAdd, etc.
+ * dateDiff, dateAdd 등 날짜 함수에서 사용
  */
 export type DateUnit = "year" | "month" | "day" | "hour" | "minute" | "second";
 
-//#region ========== value expression ==========
+//#region ========== 값 expression ==========
 
 /**
- * Column reference expression
+ * Column 참조 expression
  *
- * @property path - Column path (e.g. tableAlias.columnName)
+ * @property path - Column 경로 (예: tableAlias.columnName)
  */
 export interface ExprColumn {
   type: "column";
@@ -21,9 +21,9 @@ export interface ExprColumn {
 }
 
 /**
- * Literal value expression
+ * 리터럴 값 expression
  *
- * @property value - Column primitive value
+ * @property value - Column 원시 값
  */
 export interface ExprValue {
   type: "value";
@@ -33,8 +33,8 @@ export interface ExprValue {
 /**
  * Raw SQL expression
  *
- * @property sql - SQL string (parameters denoted as {0}, {1})
- * @property params - Parameter expression array
+ * @property sql - SQL 문자열 (파라미터는 {0}, {1}로 표기)
+ * @property params - 파라미터 expression 배열
  */
 export interface ExprRaw {
   type: "raw";
@@ -44,44 +44,44 @@ export interface ExprRaw {
 
 //#endregion
 
-//#region ========== Comparison operations (for WHERE) ==========
+//#region ========== 비교 연산 (WHERE용) ==========
 
-/** Equality comparison (=) - NULL-safe */
+/** 동등 비교 (=) - NULL 안전 */
 export interface ExprEq {
   type: "eq";
   source: Expr;
   target: Expr;
 }
 
-/** Greater than comparison (>) */
+/** 초과 비교 (>) */
 export interface ExprGt {
   type: "gt";
   source: Expr;
   target: Expr;
 }
 
-/** Less than comparison (<) */
+/** 미만 비교 (<) */
 export interface ExprLt {
   type: "lt";
   source: Expr;
   target: Expr;
 }
 
-/** Greater than or equal comparison (>=) */
+/** 이상 비교 (>=) */
 export interface ExprGte {
   type: "gte";
   source: Expr;
   target: Expr;
 }
 
-/** Less than or equal comparison (<=) */
+/** 이하 비교 (<=) */
 export interface ExprLte {
   type: "lte";
   source: Expr;
   target: Expr;
 }
 
-/** Range comparison (BETWEEN from AND to) */
+/** 범위 비교 (BETWEEN from AND to) */
 export interface ExprBetween {
   type: "between";
   source: Expr;
@@ -89,41 +89,41 @@ export interface ExprBetween {
   to?: Expr;
 }
 
-/** NULL check (IS NULL) */
+/** NULL 검사 (IS NULL) */
 export interface ExprIsNull {
   type: "null";
   arg: Expr;
 }
 
-/** Pattern matching (LIKE) */
+/** 패턴 매칭 (LIKE) */
 export interface ExprLike {
   type: "like";
   source: Expr;
   pattern: Expr;
 }
 
-/** Regular expression matching (REGEXP) */
+/** 정규식 매칭 (REGEXP) */
 export interface ExprRegexp {
   type: "regexp";
   source: Expr;
   pattern: Expr;
 }
 
-/** Value list inclusion check (IN) */
+/** 값 목록 포함 검사 (IN) */
 export interface ExprIn {
   type: "in";
   source: Expr;
   values: Expr[];
 }
 
-/** Subquery result inclusion check (IN subquery) */
+/** Subquery 결과 포함 검사 (IN subquery) */
 export interface ExprInQuery {
   type: "inQuery";
   source: Expr;
   query: SelectQueryDef;
 }
 
-/** Subquery existence check (EXISTS) */
+/** Subquery 존재 검사 (EXISTS) */
 export interface ExprExists {
   type: "exists";
   query: SelectQueryDef;
@@ -131,21 +131,21 @@ export interface ExprExists {
 
 //#endregion
 
-//#region ========== Logical operations ==========
+//#region ========== 논리 연산 ==========
 
-/** Logical negation (NOT) */
+/** 논리 부정 (NOT) */
 export interface ExprNot {
   type: "not";
   arg: WhereExpr;
 }
 
-/** Logical conjunction (AND) */
+/** 논리곱 (AND) */
 export interface ExprAnd {
   type: "and";
   conditions: WhereExpr[];
 }
 
-/** Logical disjunction (OR) */
+/** 논리합 (OR) */
 export interface ExprOr {
   type: "or";
   conditions: WhereExpr[];
@@ -153,35 +153,35 @@ export interface ExprOr {
 
 //#endregion
 
-//#region ========== String function ==========
+//#region ========== 문자열 함수 ==========
 
-/** String concatenation (CONCAT) */
+/** 문자열 연결 (CONCAT) */
 export interface ExprConcat {
   type: "concat";
   args: Expr[];
 }
 
-/** Extract left N characters (LEFT) */
+/** 왼쪽 N자 추출 (LEFT) */
 export interface ExprLeft {
   type: "left";
   source: Expr;
   length: Expr;
 }
 
-/** Extract right N characters (RIGHT) */
+/** 오른쪽 N자 추출 (RIGHT) */
 export interface ExprRight {
   type: "right";
   source: Expr;
   length: Expr;
 }
 
-/** Remove leading and trailing whitespace (TRIM) */
+/** 앞뒤 공백 제거 (TRIM) */
 export interface ExprTrim {
   type: "trim";
   arg: Expr;
 }
 
-/** Left padding (LPAD) */
+/** 왼쪽 패딩 (LPAD) */
 export interface ExprPadStart {
   type: "padStart";
   source: Expr;
@@ -189,7 +189,7 @@ export interface ExprPadStart {
   fillString: Expr;
 }
 
-/** String replacement (REPLACE) */
+/** 문자열 치환 (REPLACE) */
 export interface ExprReplace {
   type: "replace";
   source: Expr;
@@ -197,31 +197,31 @@ export interface ExprReplace {
   to: Expr;
 }
 
-/** Uppercase transform (UPPER) */
+/** 대문자 변환 (UPPER) */
 export interface ExprUpper {
   type: "upper";
   arg: Expr;
 }
 
-/** Lowercase transform (LOWER) */
+/** 소문자 변환 (LOWER) */
 export interface ExprLower {
   type: "lower";
   arg: Expr;
 }
 
-/** Character length (CHAR_LENGTH) */
+/** 문자 길이 (CHAR_LENGTH) */
 export interface ExprLength {
   type: "length";
   arg: Expr;
 }
 
-/** Byte length (LENGTH/DATALENGTH) */
+/** 바이트 길이 (LENGTH/DATALENGTH) */
 export interface ExprByteLength {
   type: "byteLength";
   arg: Expr;
 }
 
-/** Substring (SUBSTRING) */
+/** 부분 문자열 (SUBSTRING) */
 export interface ExprSubstring {
   type: "substring";
   source: Expr;
@@ -229,7 +229,7 @@ export interface ExprSubstring {
   length?: Expr;
 }
 
-/** String position (LOCATE/CHARINDEX/POSITION) */
+/** 문자열 위치 (LOCATE/CHARINDEX/POSITION) */
 export interface ExprIndexOf {
   type: "indexOf";
   source: Expr;
@@ -238,28 +238,28 @@ export interface ExprIndexOf {
 
 //#endregion
 
-//#region ========== Number function ==========
+//#region ========== 숫자 함수 ==========
 
-/** Absolute value (ABS) */
+/** 절대값 (ABS) */
 export interface ExprAbs {
   type: "abs";
   arg: Expr;
 }
 
-/** Rounding (ROUND) */
+/** 반올림 (ROUND) */
 export interface ExprRound {
   type: "round";
   arg: Expr;
   digits: number;
 }
 
-/** Ceiling (CEIL) */
+/** 올림 (CEIL) */
 export interface ExprCeil {
   type: "ceil";
   arg: Expr;
 }
 
-/** Floor (FLOOR) */
+/** 내림 (FLOOR) */
 export interface ExprFloor {
   type: "floor";
   arg: Expr;
@@ -267,63 +267,63 @@ export interface ExprFloor {
 
 //#endregion
 
-//#region ========== Date function ==========
+//#region ========== 날짜 함수 ==========
 
-/** Year extraction (YEAR) */
+/** 연도 추출 (YEAR) */
 export interface ExprYear {
   type: "year";
   arg: Expr;
 }
 
-/** Month extraction (MONTH) */
+/** 월 추출 (MONTH) */
 export interface ExprMonth {
   type: "month";
   arg: Expr;
 }
 
-/** Day extraction (DAY) */
+/** 일 추출 (DAY) */
 export interface ExprDay {
   type: "day";
   arg: Expr;
 }
 
-/** Hour extraction (HOUR) */
+/** 시 추출 (HOUR) */
 export interface ExprHour {
   type: "hour";
   arg: Expr;
 }
 
-/** Minute extraction (MINUTE) */
+/** 분 추출 (MINUTE) */
 export interface ExprMinute {
   type: "minute";
   arg: Expr;
 }
 
-/** Second extraction (SECOND) */
+/** 초 추출 (SECOND) */
 export interface ExprSecond {
   type: "second";
   arg: Expr;
 }
 
-/** ISO week number (WEEK) */
+/** ISO 주 번호 (WEEK) */
 export interface ExprIsoWeek {
   type: "isoWeek";
   arg: Expr;
 }
 
-/** ISO week start date */
+/** ISO 주 시작일 */
 export interface ExprIsoWeekStartDate {
   type: "isoWeekStartDate";
   arg: Expr;
 }
 
-/** ISO year-month (YYYYMM format) */
+/** ISO 연월 (YYYYMM 형식) */
 export interface ExprIsoYearMonth {
   type: "isoYearMonth";
   arg: Expr;
 }
 
-/** Date difference (DATEDIFF) */
+/** 날짜 차이 (DATEDIFF) */
 export interface ExprDateDiff {
   type: "dateDiff";
   unit: DateUnit;
@@ -331,7 +331,7 @@ export interface ExprDateDiff {
   to: Expr;
 }
 
-/** Date arithmetic (DATEADD) */
+/** 날짜 연산 (DATEADD) */
 export interface ExprDateAdd {
   type: "dateAdd";
   unit: DateUnit;
@@ -339,7 +339,7 @@ export interface ExprDateAdd {
   value: Expr;
 }
 
-/** Date format (FORMAT/DATE_FORMAT) */
+/** 날짜 포맷 (FORMAT/DATE_FORMAT) */
 export interface ExprFormatDate {
   type: "formatDate";
   source: Expr;
@@ -348,22 +348,22 @@ export interface ExprFormatDate {
 
 //#endregion
 
-//#region ========== Conditional ==========
+//#region ========== 조건부 ==========
 
-/** NULL replacement (COALESCE - returns first non-null) */
+/** NULL 대체 (COALESCE - 첫 번째 non-null 반환) */
 export interface ExprCoalesce {
   type: "coalesce";
   args: Expr[];
 }
 
-/** Conditional NULL (NULLIF - returns NULL if source === value) */
+/** 조건부 NULL (NULLIF - source === value이면 NULL 반환) */
 export interface ExprNullIf {
   type: "nullIf";
   source: Expr;
   value: Expr;
 }
 
-/** Transform condition to value (boolean -> 0/1) */
+/** 조건을 값으로 변환 (boolean -> 0/1) */
 export interface ExprIs {
   type: "is";
   condition: WhereExpr;
@@ -376,7 +376,7 @@ export interface ExprSwitch {
   else: Expr;
 }
 
-/** IF expression (IIF/IF) */
+/** IF expression (IIF/IF) - 조건 분기 */
 export interface ExprIf {
   type: "if";
   condition: WhereExpr;
@@ -386,34 +386,34 @@ export interface ExprIf {
 
 //#endregion
 
-//#region ========== Aggregation ==========
+//#region ========== 집계 ==========
 
-/** Record count (COUNT) */
+/** 레코드 수 (COUNT) */
 export interface ExprCount {
   type: "count";
   arg?: Expr;
   distinct?: boolean;
 }
 
-/** Sum (SUM) */
+/** 합계 (SUM) */
 export interface ExprSum {
   type: "sum";
   arg: Expr;
 }
 
-/** Average (AVG) */
+/** 평균 (AVG) */
 export interface ExprAvg {
   type: "avg";
   arg: Expr;
 }
 
-/** Maximum value (MAX) */
+/** 최대값 (MAX) */
 export interface ExprMax {
   type: "max";
   arg: Expr;
 }
 
-/** Minimum value (MIN) */
+/** 최소값 (MIN) */
 export interface ExprMin {
   type: "min";
   arg: Expr;
@@ -421,31 +421,31 @@ export interface ExprMin {
 
 //#endregion
 
-//#region ========== Other ==========
+//#region ========== 기타 ==========
 
-/** Maximum value selection (GREATEST) */
+/** 최대값 선택 (GREATEST) */
 export interface ExprGreatest {
   type: "greatest";
   args: Expr[];
 }
 
-/** Minimum value selection (LEAST) */
+/** 최소값 선택 (LEAST) */
 export interface ExprLeast {
   type: "least";
   args: Expr[];
 }
 
-/** Row number (simple ROW_NUMBER version) */
+/** 행 번호 (단순 ROW_NUMBER 버전) */
 export interface ExprRowNum {
   type: "rowNum";
 }
 
-/** Random number (RAND/RANDOM) */
+/** 난수 (RAND/RANDOM) */
 export interface ExprRandom {
   type: "random";
 }
 
-/** Type cast (CAST) */
+/** 타입 변환 (CAST) */
 export interface ExprCast {
   type: "cast";
   source: Expr;
@@ -454,9 +454,9 @@ export interface ExprCast {
 
 //#endregion
 
-//#region ========== Window Functions ==========
+//#region ========== Window 함수 ==========
 
-// Window Function Types
+// Window 함수 타입
 
 /** ROW_NUMBER() */
 export interface WinFnRowNumber {
@@ -479,7 +479,7 @@ export interface WinFnNtile {
   n: number;
 }
 
-/** LAG() - Previous row value */
+/** LAG() - 이전 행 값 */
 export interface WinFnLag {
   type: "lag";
   column: Expr;
@@ -487,7 +487,7 @@ export interface WinFnLag {
   default?: Expr;
 }
 
-/** LEAD() - Next row value */
+/** LEAD() - 다음 행 값 */
 export interface WinFnLead {
   type: "lead";
   column: Expr;
@@ -538,9 +538,9 @@ export interface WinFnMax {
 }
 
 /**
- * Window function union type
+ * Window 함수 union 타입
  *
- * Ranking, navigation, and aggregation Window functions
+ * 순위, 탐색, 집계 Window 함수
  */
 export type WinFn =
   | WinFnRowNumber
@@ -558,10 +558,10 @@ export type WinFn =
   | WinFnMax;
 
 /**
- * Window specification (OVER clause)
+ * Window 명세 (OVER 절)
  *
- * @property partitionBy - PARTITION BY expression list
- * @property orderBy - ORDER BY [column, direction] list
+ * @property partitionBy - PARTITION BY expression 목록
+ * @property orderBy - ORDER BY [column, direction] 목록
  */
 export interface WinSpec {
   partitionBy?: Expr[];
@@ -571,7 +571,7 @@ export interface WinSpec {
 /**
  * Window expression
  *
- * Window function + Window specification composition
+ * Window 함수 + Window 명세 조합
  */
 export interface ExprWindow {
   type: "window";
@@ -583,7 +583,7 @@ export interface ExprWindow {
 
 //#region ========== System ==========
 
-/** Scalar Subquery */
+/** 스칼라 Subquery */
 export interface ExprSubquery {
   type: "subquery";
   queryDef: SelectQueryDef;
@@ -591,16 +591,16 @@ export interface ExprSubquery {
 
 //#endregion
 
-//#region ========== Union Types ==========
+//#region ========== Union 타입 ==========
 
 /**
- * Expression used in WHERE clause (returns boolean)
+ * WHERE 절에서 사용되는 expression (boolean 반환)
  *
- * Union type of comparison operations + logical operations
- * Used in where(), having(), etc.
+ * 비교 연산 + 논리 연산의 union 타입
+ * where(), having() 등에서 사용
  */
 export type WhereExpr =
-  // Comparison
+  // 비교
   | ExprEq
   | ExprGt
   | ExprLt
@@ -614,26 +614,26 @@ export type WhereExpr =
   | ExprInQuery
   | ExprExists
 
-  // Logical
+  // 논리
   | ExprNot
   | ExprAnd
   | ExprOr;
 
 /**
- * All expression union type
+ * 전체 expression union 타입
  *
- * All expressions including value, string, number, date, conditional, aggregation, window, etc.
- * Used in select(), orderBy(), etc.
+ * 값, 문자열, 숫자, 날짜, 조건부, 집계, window 등 모든 expression 포함
+ * select(), orderBy() 등에서 사용
  *
- * @see {@link WhereExpr} WHERE clause-specific expression
+ * @see {@link WhereExpr} WHERE 절 전용 expression
  */
 export type Expr =
-  // Value
+  // 값
   | ExprColumn
   | ExprValue
   | ExprRaw
 
-  // String
+  // 문자열
   | ExprConcat
   | ExprLeft
   | ExprRight
@@ -647,13 +647,13 @@ export type Expr =
   | ExprSubstring
   | ExprIndexOf
 
-  // Numeric
+  // 숫자
   | ExprAbs
   | ExprRound
   | ExprCeil
   | ExprFloor
 
-  // Date
+  // 날짜
   | ExprYear
   | ExprMonth
   | ExprDay
@@ -667,21 +667,21 @@ export type Expr =
   | ExprDateAdd
   | ExprFormatDate
 
-  // Condition
+  // 조건
   | ExprCoalesce
   | ExprNullIf
   | ExprIs
   | ExprSwitch
   | ExprIf
 
-  // Aggregate
+  // 집계
   | ExprCount
   | ExprSum
   | ExprAvg
   | ExprMax
   | ExprMin
 
-  // Other
+  // 기타
   | ExprGreatest
   | ExprLeast
   | ExprRowNum
@@ -691,7 +691,7 @@ export type Expr =
   // Window
   | ExprWindow
 
-  // System
+  // 시스템
   | ExprSubquery;
 
 //#endregion