@simplysm/orm-common 14.0.99 → 14.0.101

package/dist/expr/expr.d.ts

@@ -22,27 +22,6 @@ export interface SwitchExprBuilder<TPrimitive extends ColumnPrimitive> {
  * SQL 문자열 대신 JSON AST(Expr)를 생성하며, QueryBuilder가
  * 각 DBMS(MySQL, MSSQL, PostgreSQL)로 변환
  *
- * @example
- * ```typescript
- * // WHERE condition
- * db.user().where((u) => [
- *   expr.eq(u.status, "active"),
- *   expr.gt(u.age, 18),
- * ])
- *
- * // SELECT expression
- * db.user().select((u) => ({
- *   name: expr.concat(u.firstName, " ", u.lastName),
- *   age: expr.dateDiff("year", u.birthDate, expr.val("DateOnly", DateOnly.today())),
- * }))
- *
- * // Aggregate function
- * db.order().groupBy((o) => o.userId).select((o) => ({
- *   userId: o.userId,
- *   total: expr.sum(o.amount),
- * }))
- * ```
- *
  * @see {@link Queryable} Query builder 클래스
  * @see {@link ExprUnit} Expression 래퍼 클래스
  */
@@ -55,21 +34,6 @@ export declare const expr: {
      * @param dataType - 값의 데이터 타입 ("string", "number", "boolean", "DateTime", "DateOnly", "Time", "Uuid", "Buffer")
      * @param value - 래핑할 값 (undefined 허용)
      * @returns 래핑된 ExprUnit 인스턴스
-     *
-     * @example
-     * ```typescript
-     * // String value
-     * expr.val("string", "active")
-     *
-     * // Number value
-     * expr.val("number", 100)
-     *
-     * // Date value
-     * expr.val("DateOnly", DateOnly.today())
-     *
-     * // undefined value
-     * expr.val("string", undefined)
-     * ```
      */
     val<TStr extends ColumnPrimitiveStr, T extends ColumnPrimitiveMap[TStr] | undefined>(dataType: TStr, value: T): ExprUnit<T extends undefined ? ColumnPrimitiveMap[TStr] | undefined : ColumnPrimitiveMap[TStr]>;
     /**
@@ -80,12 +44,6 @@ export declare const expr: {
      * @param dataType - Column 데이터 타입
      * @param path - Column 경로 (테이블 별칭, column 이름 등)
      * @returns Column 참조 ExprUnit 인스턴스
-     *
-     * @example
-     * ```typescript
-     * // Direct column reference (internal use)
-     * expr.col("string", "T1", "name")
-     * ```
      */
     col<TStr extends ColumnPrimitiveStr>(dataType: ColumnPrimitiveStr, ...path: string[]): ExprUnit<ColumnPrimitiveMap[TStr] | undefined>;
     /**
@@ -96,18 +54,6 @@ export declare const expr: {
      *
      * @param dataType - 반환 값의 데이터 타입
      * @returns 태그드 템플릿 함수
-     *
-     * @example
-     * ```typescript
-     * // Using MySQL JSON function
-     * db.user().select((u) => ({
-     *   name: u.name,
-     *   data: expr.raw("string")`JSON_EXTRACT(${u.metadata}, '$.email')`,
-     * }))
-     *
-     * // PostgreSQL array function
-     * expr.raw("number")`ARRAY_LENGTH(${u.tags}, 1)`
-     * ```
      */
     raw<T extends ColumnPrimitiveStr>(dataType: T): (strings: TemplateStringsArray, ...values: ExprInput<ColumnPrimitive>[]) => ExprUnit<ColumnPrimitiveMap[T] | undefined>;
     /**
@@ -118,12 +64,6 @@ export declare const expr: {
      * @param source - 비교할 column 또는 expression
      * @param target - 비교 대상 값 또는 expression
      * @returns WHERE 조건 expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [expr.eq(u.status, "active")])
-     * // WHERE status <=> 'active' (MySQL)
-     * ```
      */
     eq<T extends ColumnPrimitive>(source: ExprUnit<T>, target: ExprInput<T>): WhereExprUnit;
     /**
@@ -132,12 +72,6 @@ export declare const expr: {
      * @param source - 비교할 column 또는 expression
      * @param target - 비교 대상 값 또는 expression
      * @returns WHERE 조건 expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [expr.gt(u.age, 18)])
-     * // WHERE age > 18
-     * ```
      */
     gt<T extends ColumnPrimitive>(source: ExprUnit<T>, target: ExprInput<T>): WhereExprUnit;
     /**
@@ -146,12 +80,6 @@ export declare const expr: {
      * @param source - 비교할 column 또는 expression
      * @param target - 비교 대상 값 또는 expression
      * @returns WHERE 조건 expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [expr.lt(u.score, 60)])
-     * // WHERE score < 60
-     * ```
      */
     lt<T extends ColumnPrimitive>(source: ExprUnit<T>, target: ExprInput<T>): WhereExprUnit;
     /**
@@ -160,12 +88,6 @@ export declare const expr: {
      * @param source - 비교할 column 또는 expression
      * @param target - 비교 대상 값 또는 expression
      * @returns WHERE 조건 expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [expr.gte(u.age, 18)])
-     * // WHERE age >= 18
-     * ```
      */
     gte<T extends ColumnPrimitive>(source: ExprUnit<T>, target: ExprInput<T>): WhereExprUnit;
     /**
@@ -174,12 +96,6 @@ export declare const expr: {
      * @param source - 비교할 column 또는 expression
      * @param target - 비교 대상 값 또는 expression
      * @returns WHERE 조건 expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [expr.lte(u.score, 100)])
-     * // WHERE score <= 100
-     * ```
      */
     lte<T extends ColumnPrimitive>(source: ExprUnit<T>, target: ExprInput<T>): WhereExprUnit;
     /**
@@ -191,17 +107,6 @@ export declare const expr: {
      * @param from - 시작 값 (undefined이면 하한 없음)
      * @param to - 끝 값 (undefined이면 상한 없음)
      * @returns WHERE 조건 expression
-     *
-     * @example
-     * ```typescript
-     * // Specify range
-     * db.user().where((u) => [expr.between(u.age, 18, 65)])
-     * // WHERE age BETWEEN 18 AND 65
-     *
-     * // Specify only lower bound
-     * db.user().where((u) => [expr.between(u.age, 18, undefined)])
-     * // WHERE age >= 18
-     * ```
      */
     between<T extends ColumnPrimitive>(source: ExprUnit<T>, from?: ExprInput<T>, to?: ExprInput<T>): WhereExprUnit;
     /**
@@ -209,12 +114,6 @@ export declare const expr: {
      *
      * @param source - Column or expression to check
      * @returns WHERE condition expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [expr.null(u.deletedAt)])
-     * // WHERE deletedAt IS NULL
-     * ```
      */
     null<T extends ColumnPrimitive>(source: ExprUnit<T>): WhereExprUnit;
     /**
@@ -226,16 +125,6 @@ export declare const expr: {
      * @param source - Column or expression to search
      * @param pattern - Search pattern (%, _ wildcards available)
      * @returns WHERE condition expression
-     *
-     * @example
-     * ```typescript
-     * // Prefix search
-     * db.user().where((u) => [expr.like(u.name, "John%")])
-     * // WHERE name LIKE 'John%' ESCAPE '\'
-     *
-     * // Contains search
-     * db.user().where((u) => [expr.like(u.email, "%@gmail.com")])
-     * ```
      */
     like(source: ExprUnit<string | undefined>, pattern: ExprInput<string | undefined>): WhereExprUnit;
     /**
@@ -246,12 +135,6 @@ export declare const expr: {
      * @param source - Column or expression to search
      * @param pattern - Regular expression pattern
      * @returns WHERE condition expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [expr.regexp(u.email, "^[a-z]+@")])
-     * // MySQL: WHERE email REGEXP '^[a-z]+@'
-     * ```
      */
     regexp(source: ExprUnit<string | undefined>, pattern: ExprInput<string | undefined>): WhereExprUnit;
     /**
@@ -260,12 +143,6 @@ export declare const expr: {
      * @param source - Column or expression to compare
      * @param values - List of values to compare against
      * @returns WHERE condition expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [expr.in(u.status, ["active", "pending"])])
-     * // WHERE status IN ('active', 'pending')
-     * ```
      */
     in<T extends ColumnPrimitive>(source: ExprUnit<T>, values: ExprInput<T>[]): WhereExprUnit;
     /**
@@ -277,19 +154,6 @@ export declare const expr: {
      * @param query - Queryable that returns a single column
      * @returns WHERE condition expression
      * @throws {Error} When the subquery does not return a single column
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [
-     *   expr.inQuery(
-     *     u.id,
-     *     db.order()
-     *       .where((o) => [expr.gt(o.amount, 1000)])
-     *       .select((o) => ({ userId: o.userId }))
-     *   ),
-     * ])
-     * // WHERE id IN (SELECT userId FROM Order WHERE amount > 1000)
-     * ```
      */
     inQuery<T extends ColumnPrimitive, TData extends Record<string, T>>(source: ExprUnit<T>, query: Queryable<TData, any>): WhereExprUnit;
     /**
@@ -299,17 +163,6 @@ export declare const expr: {
      *
      * @param query - Queryable to check for existence
      * @returns WHERE condition expression
-     *
-     * @example
-     * ```typescript
-     * // Query users who have orders
-     * db.user().where((u) => [
-     *   expr.exists(
-     *     db.order().where((o) => [expr.eq(o.userId, u.id)])
-     *   ),
-     * ])
-     * // WHERE EXISTS (SELECT 1 FROM Order WHERE userId = User.id)
-     * ```
      */
     exists(query: Queryable<any, any>): WhereExprUnit;
     /**
@@ -317,12 +170,6 @@ export declare const expr: {
      *
      * @param arg - Condition to negate
      * @returns Negated WHERE condition expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [expr.not(expr.eq(u.status, "deleted"))])
-     * // WHERE NOT (status <=> 'deleted')
-     * ```
      */
     not(arg: WhereExprUnit): WhereExprUnit;
     /**
@@ -332,17 +179,6 @@ export declare const expr: {
      *
      * @param conditions - List of conditions to combine with AND
      * @returns Combined WHERE condition expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [
-     *   expr.and([
-     *     expr.eq(u.status, "active"),
-     *     expr.gte(u.age, 18),
-     *   ]),
-     * ])
-     * // WHERE (status <=> 'active' AND age >= 18)
-     * ```
      */
     and(conditions: WhereExprUnit[]): WhereExprUnit;
     /**
@@ -350,17 +186,6 @@ export declare const expr: {
      *
      * @param conditions - List of conditions to combine with OR
      * @returns Combined WHERE condition expression
-     *
-     * @example
-     * ```typescript
-     * db.user().where((u) => [
-     *   expr.or([
-     *     expr.eq(u.status, "active"),
-     *     expr.eq(u.status, "pending"),
-     *   ]),
-     * ])
-     * // WHERE (status <=> 'active' OR status <=> 'pending')
-     * ```
      */
     or(conditions: WhereExprUnit[]): WhereExprUnit;
     /**
@@ -370,14 +195,6 @@ export declare const expr: {
      *
      * @param args - Strings to concatenate
      * @returns Concatenated string expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   fullName: expr.concat(u.firstName, " ", u.lastName),
-     * }))
-     * // SELECT CONCAT(firstName, ' ', lastName) AS fullName
-     * ```
      */
     concat(...args: ExprInput<string | undefined>[]): ExprUnit<string>;
     /**
@@ -386,14 +203,6 @@ export declare const expr: {
      * @param source - Original string
      * @param length - Number of characters to extract
      * @returns Extracted string expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   initial: expr.left(u.name, 1),
-     * }))
-     * // SELECT LEFT(name, 1) AS initial
-     * ```
      */
     left<T extends string | undefined>(source: ExprUnit<T>, length: ExprInput<number>): ExprUnit<T>;
     /**
@@ -402,14 +211,6 @@ export declare const expr: {
      * @param source - Original string
      * @param length - Number of characters to extract
      * @returns Extracted string expression
-     *
-     * @example
-     * ```typescript
-     * db.phone().select((p) => ({
-     *   lastFour: expr.right(p.number, 4),
-     * }))
-     * // SELECT RIGHT(number, 4) AS lastFour
-     * ```
      */
     right<T extends string | undefined>(source: ExprUnit<T>, length: ExprInput<number>): ExprUnit<T>;
     /**
@@ -417,14 +218,6 @@ export declare const expr: {
      *
      * @param source - Original string
      * @returns String expression with whitespace removed
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   name: expr.trim(u.name),
-     * }))
-     * // SELECT TRIM(name) AS name
-     * ```
      */
     trim<T extends string | undefined>(source: ExprUnit<T>): ExprUnit<T>;
     /**
@@ -436,15 +229,6 @@ export declare const expr: {
      * @param length - Target length
      * @param fillString - String to use for padding
      * @returns Padded string expression
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   orderNo: expr.padStart(expr.cast(o.id, { type: "varchar", length: 10 }), 8, "0"),
-     * }))
-     * // SELECT LPAD(CAST(id AS VARCHAR(10)), 8, '0') AS orderNo
-     * // Result: "00000123"
-     * ```
      */
     padStart<T extends string | undefined>(source: ExprUnit<T>, length: ExprInput<number>, fillString: ExprInput<string>): ExprUnit<T>;
     /**
@@ -454,14 +238,6 @@ export declare const expr: {
      * @param from - String to find
      * @param to - Replacement string
      * @returns Replaced string expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   phone: expr.replace(u.phone, "-", ""),
-     * }))
-     * // SELECT REPLACE(phone, '-', '') AS phone
-     * ```
      */
     replace<T extends string | undefined>(source: ExprUnit<T>, from: ExprInput<string>, to: ExprInput<string>): ExprUnit<T>;
     /**
@@ -469,14 +245,6 @@ export declare const expr: {
      *
      * @param source - Original string
      * @returns Uppercase string expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   code: expr.upper(u.code),
-     * }))
-     * // SELECT UPPER(code) AS code
-     * ```
      */
     upper<T extends string | undefined>(source: ExprUnit<T>): ExprUnit<T>;
     /**
@@ -484,14 +252,6 @@ export declare const expr: {
      *
      * @param source - Original string
      * @returns Lowercase string expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   email: expr.lower(u.email),
-     * }))
-     * // SELECT LOWER(email) AS email
-     * ```
      */
     lower<T extends string | undefined>(source: ExprUnit<T>): ExprUnit<T>;
     /**
@@ -499,14 +259,6 @@ export declare const expr: {
      *
      * @param source - Original string
      * @returns Character count
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   nameLength: expr.length(u.name),
-     * }))
-     * // SELECT CHAR_LENGTH(name) AS nameLength
-     * ```
      */
     length(source: ExprUnit<string | undefined>): ExprUnit<number>;
     /**
@@ -516,14 +268,6 @@ export declare const expr: {
      *
      * @param source - Original string
      * @returns Byte count
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   byteLen: expr.byteLength(u.name),
-     * }))
-     * // SELECT OCTET_LENGTH(name) AS byteLen
-     * ```
      */
     byteLength(source: ExprUnit<string | undefined>): ExprUnit<number>;
     /**
@@ -535,15 +279,6 @@ export declare const expr: {
      * @param start - Start position (starting from 1)
      * @param length - Length to extract (to the end if omitted)
      * @returns Extracted string expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   // From "Hello World", 5 characters starting at index 1: "Hello"
-     *   prefix: expr.substring(u.name, 1, 5),
-     * }))
-     * // SELECT SUBSTRING(name, 1, 5) AS prefix
-     * ```
      */
     substring<T extends string | undefined>(source: ExprUnit<T>, start: ExprInput<number>, length?: ExprInput<number>): ExprUnit<T>;
     /**
@@ -554,15 +289,6 @@ export declare const expr: {
      * @param source - String to search in
      * @param search - String to find
      * @returns Position (starting from 1, 0 if not found)
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   atPos: expr.indexOf(u.email, "@"),
-     * }))
-     * // SELECT LOCATE('@', email) AS atPos (MySQL)
-     * // "john@example.com" → 5
-     * ```
      */
     indexOf(source: ExprUnit<string | undefined>, search: ExprInput<string>): ExprUnit<number>;
     /**
@@ -570,14 +296,6 @@ export declare const expr: {
      *
      * @param source - Original number
      * @returns Absolute value expression
-     *
-     * @example
-     * ```typescript
-     * db.account().select((a) => ({
-     *   balance: expr.abs(a.balance),
-     * }))
-     * // SELECT ABS(balance) AS balance
-     * ```
      */
     abs<T extends number | undefined>(source: ExprUnit<T>): ExprUnit<T>;
     /**
@@ -586,15 +304,6 @@ export declare const expr: {
      * @param source - Original number
      * @param digits - Number of decimal places
      * @returns Rounded number expression
-     *
-     * @example
-     * ```typescript
-     * db.product().select((p) => ({
-     *   price: expr.round(p.price, 2),
-     * }))
-     * // SELECT ROUND(price, 2) AS price
-     * // 123.456 → 123.46
-     * ```
      */
     round<T extends number | undefined>(source: ExprUnit<T>, digits: number): ExprUnit<T>;
     /**
@@ -602,15 +311,6 @@ export declare const expr: {
      *
      * @param source - Original number
      * @returns Ceiling number expression
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   pages: expr.ceil(expr.multiply(o.itemCount, 0.1)),
-     * }))
-     * // SELECT CEILING(itemCount / 10) AS pages
-     * // 25 / 10 = 2.5 → 3
-     * ```
      */
     ceil<T extends number | undefined>(source: ExprUnit<T>): ExprUnit<T>;
     /**
@@ -618,15 +318,6 @@ export declare const expr: {
      *
      * @param source - Original number
      * @returns Floor number expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   ageGroup: expr.floor(expr.multiply(u.age, 0.1)),
-     * }))
-     * // SELECT FLOOR(age / 10) AS ageGroup
-     * // 25 / 10 = 2.5 → 2
-     * ```
      */
     floor<T extends number | undefined>(source: ExprUnit<T>): ExprUnit<T>;
     /**
@@ -634,14 +325,6 @@ export declare const expr: {
      *
      * @param source - DateTime or DateOnly expression
      * @returns Year (4-digit number)
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   birthYear: expr.year(u.birthDate),
-     * }))
-     * // SELECT YEAR(birthDate) AS birthYear
-     * ```
      */
     year<T extends DateTime | DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
     /**
@@ -649,14 +332,6 @@ export declare const expr: {
      *
      * @param source - DateTime or DateOnly expression
      * @returns Month (1~12)
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   orderMonth: expr.month(o.createdAt),
-     * }))
-     * // SELECT MONTH(createdAt) AS orderMonth
-     * ```
      */
     month<T extends DateTime | DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
     /**
@@ -664,14 +339,6 @@ export declare const expr: {
      *
      * @param source - DateTime or DateOnly expression
      * @returns Day (1~31)
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   birthDay: expr.day(u.birthDate),
-     * }))
-     * // SELECT DAY(birthDate) AS birthDay
-     * ```
      */
     day<T extends DateTime | DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
     /**
@@ -679,14 +346,6 @@ export declare const expr: {
      *
      * @param source - DateTime or Time expression
      * @returns Hour (0~23)
-     *
-     * @example
-     * ```typescript
-     * db.log().select((l) => ({
-     *   logHour: expr.hour(l.createdAt),
-     * }))
-     * // SELECT HOUR(createdAt) AS logHour
-     * ```
      */
     hour<T extends DateTime | Time | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
     /**
@@ -694,14 +353,6 @@ export declare const expr: {
      *
      * @param source - DateTime or Time expression
      * @returns Minute (0~59)
-     *
-     * @example
-     * ```typescript
-     * db.log().select((l) => ({
-     *   logMinute: expr.minute(l.createdAt),
-     * }))
-     * // SELECT MINUTE(createdAt) AS logMinute
-     * ```
      */
     minute<T extends DateTime | Time | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
     /**
@@ -709,14 +360,6 @@ export declare const expr: {
      *
      * @param source - DateTime or Time expression
      * @returns Second (0~59)
-     *
-     * @example
-     * ```typescript
-     * db.log().select((l) => ({
-     *   logSecond: expr.second(l.createdAt),
-     * }))
-     * // SELECT SECOND(createdAt) AS logSecond
-     * ```
      */
     second<T extends DateTime | Time | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
     /**
@@ -726,14 +369,6 @@ export declare const expr: {
      *
      * @param source - DateOnly expression
      * @returns ISO week number
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   weekNum: expr.isoWeek(o.orderDate),
-     * }))
-     * // SELECT WEEK(orderDate, 3) AS weekNum (MySQL)
-     * ```
      */
     isoWeek<T extends DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : number>;
     /**
@@ -743,14 +378,6 @@ export declare const expr: {
      *
      * @param source - DateOnly expression
      * @returns Week start date (Monday)
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   weekStart: expr.isoWeekStartDate(o.orderDate),
-     * }))
-     * // 2024-01-10 (Wed) → 2024-01-08 (Mon)
-     * ```
      */
     isoWeekStartDate<T extends DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T>;
     /**
@@ -760,14 +387,6 @@ export declare const expr: {
      *
      * @param source - DateOnly expression
      * @returns Year-month string (YYYYMM)
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   yearMonth: expr.isoYearMonth(o.orderDate),
-     * }))
-     * // 2024-01-15 → "202401"
-     * ```
      */
     isoYearMonth<T extends DateOnly | undefined>(source: ExprUnit<T>): ExprUnit<T extends undefined ? undefined : string>;
     /**
@@ -777,14 +396,6 @@ export declare const expr: {
      * @param from - Start date
      * @param to - End date
      * @returns Difference value (to - from)
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   age: expr.dateDiff("year", u.birthDate, expr.val("DateOnly", DateOnly.today())),
-     * }))
-     * // SELECT DATEDIFF(year, birthDate, '2024-01-15') AS age
-     * ```
      */
     dateDiff<T extends DateTime | DateOnly | Time | undefined>(unit: DateUnit, from: ExprInput<T>, to: ExprInput<T>): ExprUnit<T extends undefined ? undefined : number>;
     /**
@@ -794,14 +405,6 @@ export declare const expr: {
      * @param source - Original date
      * @param value - Value to add (negative allowed)
      * @returns Calculated date
-     *
-     * @example
-     * ```typescript
-     * db.subscription().select((s) => ({
-     *   expiresAt: expr.dateAdd("month", s.startDate, 12),
-     * }))
-     * // SELECT DATEADD(month, 12, startDate) AS expiresAt
-     * ```
      */
     dateAdd<T extends DateTime | DateOnly | Time | undefined>(unit: DateUnit, source: ExprUnit<T>, value: ExprInput<number>): ExprUnit<T>;
     /**
@@ -812,15 +415,6 @@ export declare const expr: {
      * @param source - Date expression
      * @param format - Format string (e.g., "%Y-%m-%d")
      * @returns Formatted string expression
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   orderDate: expr.formatDate(o.createdAt, "%Y-%m-%d"),
-     * }))
-     * // SELECT DATE_FORMAT(createdAt, '%Y-%m-%d') AS orderDate (MySQL)
-     * // 2024-01-15 10:30:00 → "2024-01-15"
-     * ```
      */
     formatDate<T extends DateTime | DateOnly | Time | undefined>(source: ExprUnit<T>, format: string): ExprUnit<T extends undefined ? undefined : string>;
     /**
@@ -830,14 +424,6 @@ export declare const expr: {
      *
      * @param args - Values to inspect (last is default value)
      * @returns First non-null value
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   displayName: expr.coalesce(u.nickname, u.name, "Guest"),
-     * }))
-     * // SELECT COALESCE(nickname, name, 'Guest') AS displayName
-     * ```
      */
     coalesce: typeof coalesce;
     /**
@@ -848,15 +434,6 @@ export declare const expr: {
      * @param source - Original value
      * @param value - Value to compare
      * @returns NULL or original value
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   // Convert empty string to NULL
-     *   bio: expr.nullIf(u.bio, ""),
-     * }))
-     * // SELECT NULLIF(bio, '') AS bio
-     * ```
      */
     nullIf<T extends ColumnPrimitive>(source: ExprUnit<T>, value: ExprInput<T>): ExprUnit<T | undefined>;
     /**
@@ -866,14 +443,6 @@ export declare const expr: {
      *
      * @param condition - Condition to transform
      * @returns boolean expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   isActive: expr.is(expr.eq(u.status, "active")),
-     * }))
-     * // SELECT (status <=> 'active') AS isActive
-     * ```
      */
     is(condition: WhereExprUnit): ExprUnit<boolean>;
     /**
@@ -882,18 +451,6 @@ export declare const expr: {
      * 메서드 체이닝으로 조건 분기 구성
      *
      * @returns SwitchExprBuilder instance
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   grade: expr.switch<string>()
-     *     .case(expr.gte(u.score, 90), "A")
-     *     .case(expr.gte(u.score, 80), "B")
-     *     .case(expr.gte(u.score, 70), "C")
-     *     .default("F"),
-     * }))
-     * // SELECT CASE WHEN score >= 90 THEN 'A' ... ELSE 'F' END AS grade
-     * ```
      */
     switch<T extends ColumnPrimitive>(): SwitchExprBuilder<T>;
     /**
@@ -903,14 +460,6 @@ export declare const expr: {
      * @param then - Value when condition is true
      * @param else_ - Value when condition is false
      * @returns Conditional value expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   type: expr.if(expr.gte(u.age, 18), "adult", "minor"),
-     * }))
-     * // SELECT IF(age >= 18, 'adult', 'minor') AS type
-     * ```
      */
     if<T extends ColumnPrimitive>(condition: WhereExprUnit, then: ExprInput<T>, else_: ExprInput<T>): ExprUnit<T>;
     /**
@@ -919,17 +468,6 @@ export declare const expr: {
      * @param arg - Column to count (all rows if omitted)
      * @param distinct - If true, remove duplicates
      * @returns Row count
-     *
-     * @example
-     * ```typescript
-     * // Total row count
-     * db.user().select(() => ({ total: expr.count() }))
-     *
-     * // Distinct count
-     * db.order().select((o) => ({
-     *   uniqueCustomers: expr.count(o.customerId, true),
-     * }))
-     * ```
      */
     count(arg?: ExprUnit<ColumnPrimitive>, distinct?: boolean): ExprUnit<number>;
     /**
@@ -939,14 +477,6 @@ export declare const expr: {
      *
      * @param arg - Number column to sum
      * @returns Sum (or NULL)
-     *
-     * @example
-     * ```typescript
-     * db.order().groupBy((o) => o.userId).select((o) => ({
-     *   userId: o.userId,
-     *   totalAmount: expr.sum(o.amount),
-     * }))
-     * ```
      */
     sum(arg: ExprUnit<number | undefined>): ExprUnit<number | undefined>;
     /**
@@ -956,14 +486,6 @@ export declare const expr: {
      *
      * @param arg - Number column to average
      * @returns Average (or NULL)
-     *
-     * @example
-     * ```typescript
-     * db.product().groupBy((p) => p.categoryId).select((p) => ({
-     *   categoryId: p.categoryId,
-     *   avgPrice: expr.avg(p.price),
-     * }))
-     * ```
      */
     avg(arg: ExprUnit<number | undefined>): ExprUnit<number | undefined>;
     /**
@@ -973,14 +495,6 @@ export declare const expr: {
      *
      * @param arg - Column to find maximum of
      * @returns Maximum value (or NULL)
-     *
-     * @example
-     * ```typescript
-     * db.order().groupBy((o) => o.userId).select((o) => ({
-     *   userId: o.userId,
-     *   lastOrderDate: expr.max(o.createdAt),
-     * }))
-     * ```
      */
     max<T extends ColumnPrimitive>(arg: ExprUnit<T>): ExprUnit<T | undefined>;
     /**
@@ -990,14 +504,6 @@ export declare const expr: {
      *
      * @param arg - Column to find minimum of
      * @returns Minimum value (or NULL)
-     *
-     * @example
-     * ```typescript
-     * db.product().groupBy((p) => p.categoryId).select((p) => ({
-     *   categoryId: p.categoryId,
-     *   minPrice: expr.min(p.price),
-     * }))
-     * ```
      */
     min<T extends ColumnPrimitive>(arg: ExprUnit<T>): ExprUnit<T | undefined>;
     /**
@@ -1005,14 +511,6 @@ export declare const expr: {
      *
      * @param args - Values to compare
      * @returns Greatest value
-     *
-     * @example
-     * ```typescript
-     * db.product().select((p) => ({
-     *   effectivePrice: expr.greatest(p.price, p.minPrice),
-     * }))
-     * // SELECT GREATEST(price, minPrice) AS effectivePrice
-     * ```
      */
     greatest<T extends ColumnPrimitive>(...args: ExprInput<T>[]): ExprUnit<T>;
     /**
@@ -1020,28 +518,12 @@ export declare const expr: {
      *
      * @param args - Values to compare
      * @returns Least value
-     *
-     * @example
-     * ```typescript
-     * db.product().select((p) => ({
-     *   effectivePrice: expr.least(p.price, p.maxDiscount),
-     * }))
-     * // SELECT LEAST(price, maxDiscount) AS effectivePrice
-     * ```
      */
     least<T extends ColumnPrimitive>(...args: ExprInput<T>[]): ExprUnit<T>;
     /**
      * 행 번호 (ROW_NUMBER 없이 모든 행에 순번 부여)
      *
      * @returns Row number (starting from 1)
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   rowNum: expr.rowNum(),
-     *   name: u.name,
-     * }))
-     * ```
      */
     rowNum(): ExprUnit<number>;
     /**
@@ -1050,12 +532,6 @@ export declare const expr: {
      * 0과 1 사이의 난수 반환. 주로 ORDER BY에서 무작위 정렬에 사용
      *
      * @returns Random number between 0 and 1
-     *
-     * @example
-     * ```typescript
-     * // Random sorting
-     * db.user().orderBy(() => expr.random()).limit(10)
-     * ```
      */
     random(): ExprUnit<number>;
     /**
@@ -1064,14 +540,6 @@ export declare const expr: {
      * @param source - Expression to transform
      * @param targetType - Target data type
      * @returns Transformed expression
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   idStr: expr.cast(o.id, { type: "varchar", length: 20 }),
-     * }))
-     * // SELECT CAST(id AS VARCHAR(20)) AS idStr
-     * ```
      */
     cast<T extends ColumnPrimitive, TDataType extends DataType>(source: ExprUnit<T>, targetType: TDataType): ExprUnit<T extends undefined ? undefined : InferColumnPrimitiveFromDataType<TDataType>>;
     /**
@@ -1082,20 +550,6 @@ export declare const expr: {
      * @param dataType - Data type of the returned value
      * @param queryable - Queryable that returns a scalar value
      * @returns Subquery result expression
-     *
-     * @example
-     * ```typescript
-     * db.user().select((u) => ({
-     *   id: u.id,
-     *   postCount: expr.subquery(
-     *     "number",
-     *     db.post()
-     *       .where((p) => [expr.eq(p.userId, u.id)])
-     *       .select(() => ({ cnt: expr.count() }))
-     *   ),
-     * }))
-     * // SELECT id, (SELECT COUNT(*) FROM Post WHERE userId = User.id) AS postCount
-     * ```
      */
     subquery<TStr extends ColumnPrimitiveStr>(dataType: TStr, queryable: {
         getSelectQueryDef(): SelectQueryDef;
@@ -1107,18 +561,6 @@ export declare const expr: {
      *
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns Row number (starting from 1)
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   ...o,
-     *   rowNum: expr.rowNumber({
-     *     partitionBy: [o.userId],
-     *     orderBy: [[o.createdAt, "DESC"]],
-     *   }),
-     * }))
-     * // SELECT *, ROW_NUMBER() OVER (PARTITION BY userId ORDER BY createdAt DESC)
-     * ```
      */
     rowNumber(spec: WinSpecInput): ExprUnit<number>;
     /**
@@ -1126,16 +568,6 @@ export declare const expr: {
      *
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns Rank (skips after ties: 1, 1, 3)
-     *
-     * @example
-     * ```typescript
-     * db.student().select((s) => ({
-     *   name: s.name,
-     *   rank: expr.rank({
-     *     orderBy: [[s.score, "DESC"]],
-     *   }),
-     * }))
-     * ```
      */
     rank(spec: WinSpecInput): ExprUnit<number>;
     /**
@@ -1143,16 +575,6 @@ export declare const expr: {
      *
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns Dense rank (consecutive after ties: 1, 1, 2)
-     *
-     * @example
-     * ```typescript
-     * db.student().select((s) => ({
-     *   name: s.name,
-     *   denseRank: expr.denseRank({
-     *     orderBy: [[s.score, "DESC"]],
-     *   }),
-     * }))
-     * ```
      */
     denseRank(spec: WinSpecInput): ExprUnit<number>;
     /**
@@ -1161,17 +583,6 @@ export declare const expr: {
      * @param n - Number of groups to split into
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns Group number (1 ~ n)
-     *
-     * @example
-     * ```typescript
-     * // Quartile split to find top 25%
-     * db.user().select((u) => ({
-     *   name: u.name,
-     *   quartile: expr.ntile(4, {
-     *     orderBy: [[u.score, "DESC"]],
-     *   }),
-     * }))
-     * ```
      */
     ntile(n: number, spec: WinSpecInput): ExprUnit<number>;
     /**
@@ -1181,18 +592,6 @@ export declare const expr: {
      * @param spec - Window spec (partitionBy, orderBy)
      * @param options - offset (default 1), default (default value when no previous row)
      * @returns Previous row's value (or default value/NULL)
-     *
-     * @example
-     * ```typescript
-     * db.stock().select((s) => ({
-     *   date: s.date,
-     *   price: s.price,
-     *   prevPrice: expr.lag(s.price, {
-     *     partitionBy: [s.symbol],
-     *     orderBy: [[s.date, "ASC"]],
-     *   }),
-     * }))
-     * ```
      */
     lag<T extends ColumnPrimitive>(column: ExprUnit<T>, spec: WinSpecInput, options?: {
         offset?: number;
@@ -1205,18 +604,6 @@ export declare const expr: {
      * @param spec - Window spec (partitionBy, orderBy)
      * @param options - offset (default 1), default (default value when no following row)
      * @returns Following row's value (or default value/NULL)
-     *
-     * @example
-     * ```typescript
-     * db.stock().select((s) => ({
-     *   date: s.date,
-     *   price: s.price,
-     *   nextPrice: expr.lead(s.price, {
-     *     partitionBy: [s.symbol],
-     *     orderBy: [[s.date, "ASC"]],
-     *   }),
-     * }))
-     * ```
      */
     lead<T extends ColumnPrimitive>(column: ExprUnit<T>, spec: WinSpecInput, options?: {
         offset?: number;
@@ -1228,17 +615,6 @@ export declare const expr: {
      * @param column - Column to reference
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns First value
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   ...o,
-     *   firstOrderAmount: expr.firstValue(o.amount, {
-     *     partitionBy: [o.userId],
-     *     orderBy: [[o.createdAt, "ASC"]],
-     *   }),
-     * }))
-     * ```
      */
     firstValue<T extends ColumnPrimitive>(column: ExprUnit<T>, spec: WinSpecInput): ExprUnit<T | undefined>;
     /**
@@ -1247,17 +623,6 @@ export declare const expr: {
      * @param column - Column to reference
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns Last value
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   ...o,
-     *   lastOrderAmount: expr.lastValue(o.amount, {
-     *     partitionBy: [o.userId],
-     *     orderBy: [[o.createdAt, "ASC"]],
-     *   }),
-     * }))
-     * ```
      */
     lastValue<T extends ColumnPrimitive>(column: ExprUnit<T>, spec: WinSpecInput): ExprUnit<T | undefined>;
     /**
@@ -1266,18 +631,6 @@ export declare const expr: {
      * @param column - Column to sum
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns Sum within window
-     *
-     * @example
-     * ```typescript
-     * // Running total
-     * db.order().select((o) => ({
-     *   ...o,
-     *   runningTotal: expr.sumOver(o.amount, {
-     *     partitionBy: [o.userId],
-     *     orderBy: [[o.createdAt, "ASC"]],
-     *   }),
-     * }))
-     * ```
      */
     sumOver(column: ExprUnit<number | undefined>, spec: WinSpecInput): ExprUnit<number | undefined>;
     /**
@@ -1286,18 +639,6 @@ export declare const expr: {
      * @param column - Column to average
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns Average within window
-     *
-     * @example
-     * ```typescript
-     * // Moving average
-     * db.stock().select((s) => ({
-     *   ...s,
-     *   movingAvg: expr.avgOver(s.price, {
-     *     partitionBy: [s.symbol],
-     *     orderBy: [[s.date, "ASC"]],
-     *   }),
-     * }))
-     * ```
      */
     avgOver(column: ExprUnit<number | undefined>, spec: WinSpecInput): ExprUnit<number | undefined>;
     /**
@@ -1306,16 +647,6 @@ export declare const expr: {
      * @param spec - Window spec (partitionBy, orderBy)
      * @param column - Column to count (all rows if omitted)
      * @returns Row count within window
-     *
-     * @example
-     * ```typescript
-     * db.order().select((o) => ({
-     *   ...o,
-     *   totalOrdersPerUser: expr.countOver({
-     *     partitionBy: [o.userId],
-     *   }),
-     * }))
-     * ```
      */
     countOver(spec: WinSpecInput, column?: ExprUnit<ColumnPrimitive>): ExprUnit<number>;
     /**
@@ -1324,16 +655,6 @@ export declare const expr: {
      * @param column - Column to find minimum of
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns Minimum value within window
-     *
-     * @example
-     * ```typescript
-     * db.stock().select((s) => ({
-     *   ...s,
-     *   minPriceInPeriod: expr.minOver(s.price, {
-     *     partitionBy: [s.symbol],
-     *   }),
-     * }))
-     * ```
      */
     minOver<T extends ColumnPrimitive>(column: ExprUnit<T>, spec: WinSpecInput): ExprUnit<T | undefined>;
     /**
@@ -1342,16 +663,6 @@ export declare const expr: {
      * @param column - Column to find maximum of
      * @param spec - Window spec (partitionBy, orderBy)
      * @returns Maximum value within window
-     *
-     * @example
-     * ```typescript
-     * db.stock().select((s) => ({
-     *   ...s,
-     *   maxPriceInPeriod: expr.maxOver(s.price, {
-     *     partitionBy: [s.symbol],
-     *   }),
-     * }))
-     * ```
      */
     maxOver<T extends ColumnPrimitive>(column: ExprUnit<T>, spec: WinSpecInput): ExprUnit<T | undefined>;
     /**