@operato/data-grist 1.3.4 → 1.3.11

package/docs/default-value/value-generator/date-generator.md

@@ -0,0 +1,40 @@
+# 함수 설명: getRelativeDate
+
+이 함수는 현재 날짜를 기준으로 파라미터로 주어진 상대적인 날짜의 시작 시간을 제공합니다.
+
+## 함수 시그니처
+
+```typescript
+function getRelativeDate(params: RelativeDateParams = {}): Date | number | string
+```
+
+## 매개변수
+
+이 함수는 `RelativeDateParams`라는 이름의 타입의 매개변수 객체를 받습니다. 이 객체의 필드에 대한 상세한 정보는 다음과 같습니다:
+
+- `relativeDate?: number`: 상대적인 날짜를 나타내는 숫자입니다. 이 값은 현재 날짜로부터의 일 수를 나타냅니다. 예를 들어, 이 값이 3이면 현재 날짜로부터 3일 뒤를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 날짜를 의미합니다.
+
+- `timeZone?: string`: 날짜를 얻고자 하는 시간대를 나타내는 문자열입니다. 이 값이 주어지지 않으면 사용자의 로컬 시간대가 사용됩니다.
+
+- `format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions`: 반환하려는 날짜의 형식을 결정합니다. 이 값은 다음 세 가지 중 하나일 수 있습니다:
+  - `'timestamp'`: 반환 값이 UNIX 타임스탬프 (1970년 1월 1일 00:00:00 UTC로부터의 밀리초)가 됩니다.
+  - `'date'`: 반환 값이 Date 객체가 됩니다.
+  - `Intl.DateTimeFormatOptions`: 반환 값이 이 옵션에 따라 포맷된 문자열이 됩니다. 이 값이 제공되지 않으면 기본적으로 Date 객체가 반환됩니다.
+
+## 반환 값
+
+이 함수는 `Date | number | string` 형식의 값을 반환합니다. 반환 값의 형식은 `format` 매개변수에 따라 결정됩니다.
+
+## 예제
+
+```typescript
+const relativeDate = getRelativeDate({
+  relativeDate: 1,
+  timeZone: 'Asia/Seoul',
+  format: 'date'
+})
+
+console.log(relativeDate)
+```
+
+이 코드는 현재 시간으로부터 1일 뒤의 날짜를 `'Asia/Seoul'` 시간대에서의 Date 객체로 반환합니다.

package/docs/default-value/value-generator/default-value-generator.md

@@ -0,0 +1,9 @@
+## Date Utility Functions
+
+This is a collection of utility functions for working with dates and performing relative date calculations.
+
+### getCurrentTime
+
+```typescript
+getCurrentTime(params?: { timeZone?: string; format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions }): Date | number | string
+```

package/docs/default-value/value-generator/hour-time-generator.md

@@ -0,0 +1,43 @@
+# 함수 설명: getRelativeHourTime
+
+이 함수는 현재 시간을 기준으로 파라미터로 주어진 상대적인 시간(Hour)의 상대적인 초(Seconds)의 시작 시간을 제공합니다.
+
+## 함수 시그니처
+
+```typescript
+function getRelativeHourTime(params: RelativeHourTimeParams = {}): string | number | Date
+```
+
+## 매개변수
+
+이 함수는 `RelativeHourTimeParams`라는 이름의 타입의 매개변수 객체를 받습니다. 이 객체의 필드에 대한 상세한 정보는 다음과 같습니다:
+
+- `relativeHour?: number`: 상대적인 시간을 나타내는 숫자입니다. 이 값은 현재 시간으로부터의 시간 수를 나타냅니다. 예를 들어, 이 값이 3이면 현재 시간으로부터 3시간 뒤를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 시간을 의미합니다.
+
+- `relativeSeconds?: number`: 상대적인 초를 나타내는 숫자입니다. 이 값은 현재 시간으로부터의 초 수를 나타냅니다. 예를 들어, 이 값이 120이면 현재 시간으로부터 2분 뒤를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 시간을 의미합니다.
+
+- `timeZone?: string`: 시간을 얻고자 하는 시간대를 나타내는 문자열입니다. 이 값이 주어지지 않으면 사용자의 로컬 시간대가 사용됩니다.
+
+- `format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions`: 반환하려는 시간의 형식을 결정합니다. 이 값은 다음 세 가지 중 하나일 수 있습니다:
+  - `'timestamp'`: 반환 값이 UNIX 타임스탬프 (1970년 1월 1일 00:00:00 UTC로부터의 밀리초)가 됩니다.
+  - `'date'`: 반환 값이 Date 객체가 됩니다.
+  - `Intl.DateTimeFormatOptions`: 반환 값이 이 옵션에 따라 포맷된 문자열이 됩니다. 이 값이 제공되지 않으면 기본적으로 Date 객체가 반환됩니다.
+
+## 반환 값
+
+이 함수는 `string | number | Date` 형식의 값을 반환합니다. 반환 값의 형식은 `format` 매개변수에 따라 결정됩니다.
+
+## 예제
+
+```typescript
+const relativeHourTime = getRelativeHourTime({
+  relativeHour: 2,
+  relativeSeconds: 120,
+  timeZone: 'Asia/Seoul',
+  format: 'date'
+})
+
+console.log(relativeHourTime)
+```
+
+이 코드는 현재 시간으로부터 2시간 후와 2분 후의 시간을 `'Asia/Seoul'` 시간대에서의 Date 객체로 반환합니다.

package/docs/default-value/value-generator/minute-time-generator.md

@@ -0,0 +1,43 @@
+# 함수 설명: getRelativeMinuteTime
+
+이 함수는 현재 시간을 기준으로 파라미터로 주어진 상대적인 분(Minute)의 상대적인 초(Seconds)의 시작 시간을 제공합니다.
+
+## 함수 시그니처
+
+```typescript
+function getRelativeMinuteTime(params: RelativeMinuteTimeParams = {}): string | number | Date
+```
+
+## 매개변수
+
+이 함수는 `RelativeMinuteTimeParams`라는 이름의 타입의 매개변수 객체를 받습니다. 이 객체의 필드에 대한 상세한 정보는 다음과 같습니다:
+
+- `relativeMinutes?: number`: 상대적인 분을 나타내는 숫자입니다. 이 값은 현재 시간으로부터의 분 수를 나타냅니다. 예를 들어, 이 값이 15이면 현재 시간으로부터 15분 후를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 시간을 의미합니다.
+
+- `relativeSeconds?: number`: 상대적인 초를 나타내는 숫자입니다. 이 값은 현재 시간으로부터의 초 수를 나타냅니다. 예를 들어, 이 값이 30이면 현재 시간으로부터 30초 후를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 시간을 의미합니다.
+
+- `timeZone?: string`: 시간을 얻고자 하는 시간대를 나타내는 문자열입니다. 이 값이 주어지지 않으면 사용자의 로컬 시간대가 사용됩니다.
+
+- `format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions`: 반환하려는 시간의 형식을 결정합니다. 이 값은 다음 세 가지 중 하나일 수 있습니다:
+  - `'timestamp'`: 반환 값이 UNIX 타임스탬프 (1970년 1월 1일 00:00:00 UTC로부터의 밀리초)가 됩니다.
+  - `'date'`: 반환 값이 Date 객체가 됩니다.
+  - `Intl.DateTimeFormatOptions`: 반환 값이 이 옵션에 따라 포맷된 문자열이 됩니다. 이 값이 제공되지 않으면 기본적으로 Date 객체가 반환됩니다.
+
+## 반환 값
+
+이 함수는 `string | number | Date` 형식의 값을 반환합니다. 반환 값의 형식은 `format` 매개변수에 따라 결정됩니다.
+
+## 예제
+
+```typescript
+const relativeMinuteTime = getRelativeMinuteTime({
+  relativeMinutes: 15,
+  relativeSeconds: 30,
+  timeZone: 'Asia/Seoul',
+  format: 'date'
+})
+
+console.log(relativeMinuteTime)
+```
+
+이 코드는 현재 시간으로부터 15분 30초 후의 시간을 `'Asia/Seoul'` 시간대에서의 Date 객체로 반환합니다.

package/docs/default-value/value-generator/month-date-generator.md

@@ -0,0 +1,43 @@
+# 함수 설명: getRelativeMonthDate
+
+이 함수는 현재 날짜를 기준으로 파라미터로 주어진 상대적인 달(Month)의 상대적인 날짜(Date)의 시작 시간을 제공합니다.
+
+## 함수 시그니처
+
+```typescript
+function getRelativeMonthDate(params: RelativeMonthDateParams = {}): string | number | Date
+```
+
+## 매개변수
+
+이 함수는 `RelativeMonthDateParams`라는 이름의 타입의 매개변수 객체를 받습니다. 이 객체의 필드에 대한 상세한 정보는 다음과 같습니다:
+
+- `relativeMonths?: number`: 상대적인 월을 나타내는 숫자입니다. 이 값은 현재 날짜로부터의 월 수를 나타냅니다. 예를 들어, 이 값이 3이면 현재 날짜로부터 3개월 뒤를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 월을 의미합니다.
+
+- `relativeDates?: number`: 상대적인 일수를 나타내는 숫자입니다. 이 값은 현재 날짜로부터의 일 수를 나타냅니다. 예를 들어, 이 값이 2이면 현재 날짜로부터 2일 뒤를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 날짜를 의미합니다.
+
+- `timeZone?: string`: 날짜를 얻고자 하는 시간대를 나타내는 문자열입니다. 이 값이 주어지지 않으면 사용자의 로컬 시간대가 사용됩니다.
+
+- `format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions`: 반환하려는 날짜의 형식을 결정합니다. 이 값은 다음 세 가지 중 하나일 수 있습니다:
+  - `'timestamp'`: 반환 값이 UNIX 타임스탬프 (1970년 1월 1일 00:00:00 UTC로부터의 밀리초)가 됩니다.
+  - `'date'`: 반환 값이 Date 객체가 됩니다.
+  - `Intl.DateTimeFormatOptions`: 반환 값이 이 옵션에 따라 포맷된 문자열이 됩니다. 이 값이 제공되지 않으면 기본적으로 Date 객체가 반환됩니다.
+
+## 반환 값
+
+이 함수는 `string | number | Date` 형식의 값을 반환합니다. 반환 값의 형식은 `format` 매개변수에 따라 결정됩니다.
+
+## 예제
+
+```typescript
+const relativeMonthDate = getRelativeMonthDate({
+  relativeMonths: 2,
+  relativeDates: 3,
+  timeZone: 'Asia/Seoul',
+  format: 'date'
+})
+
+console.log(relativeMonthDate)
+```
+
+이 코드는 현재 시간으로부터 2개월 후와 3일 후의 날짜를 `'Asia/Seoul'` 시간대에서의 Date 객체로 반환합니다.

package/docs/default-value/value-generator/now-generator.md

@@ -0,0 +1,39 @@
+# 함수 설명: getCurrentTime
+
+이 함수는 현재 시간을 제공합니다.
+
+## 함수 시그니처
+
+```typescript
+function getCurrentTime(
+  params: { timeZone?: string; format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions } = {}
+): Date | number | string
+```
+
+## 매개변수
+
+이 함수는 객체를 매개변수로 받습니다. 이 객체의 필드에 대한 상세한 정보는 다음과 같습니다:
+
+- `timeZone?: string`: 시간을 얻고자 하는 시간대를 나타내는 문자열입니다. 이 값이 주어지지 않으면 사용자의 로컬 시간대가 사용됩니다.
+
+- `format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions`: 반환하려는 시간의 형식을 결정합니다. 이 값은 다음 세 가지 중 하나일 수 있습니다:
+  - `'timestamp'`: 반환 값이 UNIX 타임스탬프 (1970년 1월 1일 00:00:00 UTC로부터의 밀리초)가 됩니다.
+  - `'date'`: 반환 값이 Date 객체가 됩니다.
+  - `Intl.DateTimeFormatOptions`: 반환 값이 이 옵션에 따라 포맷된 문자열이 됩니다. 이 값이 제공되지 않으면 기본적으로 Date 객체가 반환됩니다.
+
+## 반환 값
+
+이 함수는 `string | number | Date` 형식의 값을 반환합니다. 반환 값의 형식은 `format` 매개변수에 따라 결정됩니다.
+
+## 예제
+
+```typescript
+const currentTime = getCurrentTime({
+  timeZone: 'Asia/Seoul',
+  format: 'date'
+})
+
+console.log(currentTime)
+```
+
+이 코드는 현재 시간을 `'Asia/Seoul'` 시간대에서의 Date 객체로 반환합니다.

package/docs/default-value/value-generator/time-generator.md

@@ -0,0 +1,40 @@
+# 함수 설명: getRelativeTime
+
+이 함수는 현재 시간을 기준으로 파라미터로 주어진 상대적인 초의 시간을 제공합니다.
+
+## 함수 시그니처
+
+```typescript
+function getRelativeTime(params: RelativeTimeParams = {}): string | number | Date
+```
+
+## 매개변수
+
+이 함수는 `RelativeTimeParams`라는 이름의 타입의 매개변수 객체를 받습니다. 이 객체의 필드에 대한 상세한 정보는 다음과 같습니다:
+
+- `relativeSeconds?: number`: 상대적인 시간을 나타내는 초 단위의 숫자입니다. 이 값은 현재 시간으로부터의 초 수를 나타냅니다. 예를 들어, 이 값이 3600이면 현재 시간으로부터 1시간 후를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 시간을 의미합니다.
+
+- `timeZone?: string`: 시간을 얻고자 하는 시간대를 나타내는 문자열입니다. 이 값이 주어지지 않으면 사용자의 로컬 시간대가 사용됩니다.
+
+- `format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions`: 반환하려는 시간의 형식을 결정합니다. 이 값은 다음 세 가지 중 하나일 수 있습니다:
+  - `'timestamp'`: 반환 값이 UNIX 타임스탬프 (1970년 1월 1일 00:00:00 UTC로부터의 밀리초)가 됩니다.
+  - `'date'`: 반환 값이 Date 객체가 됩니다.
+  - `Intl.DateTimeFormatOptions`: 반환 값이 이 옵션에 따라 포맷된 문자열이 됩니다. 이 값이 제공되지 않으면 기본적으로 타임스탬프 값이 반환됩니다.
+
+## 반환 값
+
+이 함수는 `string | number | Date` 형식의 값을 반환합니다. 반환 값의 형식은 `format` 매개변수에 따라 결정됩니다.
+
+## 예제
+
+```typescript
+const relativeTime = getRelativeTime({
+  relativeSeconds: 3600,
+  timeZone: 'Asia/Seoul',
+  format: 'date'
+})
+
+console.log(relativeTime)
+```
+
+이 코드는 현재 시간으로부터 1시간 후의 시간을 `'Asia/Seoul'` 시간대에서의 Date 객체로 반환합니다.

package/docs/default-value/value-generator/today-generator.md

@@ -0,0 +1,39 @@
+# 함수 설명: getToday
+
+이 함수는 오늘 날자의 시작시간을 제공합니다.
+
+## 함수 시그니처
+
+```typescript
+function getToday(
+  params: { timeZone?: string; format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions } = {}
+): Date | number | string
+```
+
+## 매개변수
+
+이 함수는 객체를 매개변수로 받습니다. 이 객체의 필드에 대한 상세한 정보는 다음과 같습니다:
+
+- `timeZone?: string`: 시간을 얻고자 하는 시간대를 나타내는 문자열입니다. 이 값이 주어지지 않으면 사용자의 로컬 시간대가 사용됩니다.
+
+- `format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions`: 반환하려는 시간의 형식을 결정합니다. 이 값은 다음 세 가지 중 하나일 수 있습니다:
+  - `'timestamp'`: 반환 값이 UNIX 타임스탬프 (1970년 1월 1일 00:00:00 UTC로부터의 밀리초)가 됩니다.
+  - `'date'`: 반환 값이 Date 객체가 됩니다.
+  - `Intl.DateTimeFormatOptions`: 반환 값이 이 옵션에 따라 포맷된 문자열이 됩니다. 이 값이 제공되지 않으면 기본적으로 Date 객체가 반환됩니다.
+
+## 반환 값
+
+이 함수는 `string | number | Date` 형식의 값을 반환합니다. 반환 값의 형식은 `format` 매개변수에 따라 결정됩니다.
+
+## 예제
+
+```typescript
+const todayDate = getToday({
+  timeZone: 'Asia/Seoul',
+  format: 'date'
+})
+
+console.log(todayDate)
+```
+
+이 코드는 오늘의 날짜를 `'Asia/Seoul'` 시간대에서의 Date 객체로 반환합니다.

package/docs/default-value/value-generator/week-date-generator.md

@@ -0,0 +1,43 @@
+# 함수 설명: getRelativeWeekDate
+
+이 함수는 현재 날짜를 기준으로 파라미터로 주어진 상대적인 주(Week)의 상대적인 날짜(Date)의 시작 시간을 제공합니다.
+
+## 함수 시그니처
+
+```typescript
+function getRelativeWeekDate(params: RelativeWeekDateParams = {}): string | number | Date
+```
+
+## 매개변수
+
+이 함수는 `RelativeWeekDateParams`라는 이름의 타입의 매개변수 객체를 받습니다. 이 객체의 필드에 대한 상세한 정보는 다음과 같습니다:
+
+- `relativeWeeks?: number`: 상대적인 주를 나타내는 숫자입니다. 이 값은 현재 날짜로부터의 주 수를 나타냅니다. 예를 들어, 이 값이 3이면 현재 날짜로부터 3주 뒤를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 주를 의미합니다.
+
+- `relativeDates?: number`: 상대적인 일수를 나타내는 숫자입니다. 이 값은 현재 날짜로부터의 일 수를 나타냅니다. 예를 들어, 이 값이 2이면 현재 날짜로부터 2일 뒤를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 날짜를 의미합니다.
+
+- `timeZone?: string`: 날짜를 얻고자 하는 시간대를 나타내는 문자열입니다. 이 값이 주어지지 않으면 사용자의 로컬 시간대가 사용됩니다.
+
+- `format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions`: 반환하려는 날짜의 형식을 결정합니다. 이 값은 다음 세 가지 중 하나일 수 있습니다:
+  - `'timestamp'`: 반환 값이 UNIX 타임스탬프 (1970년 1월 1일 00:00:00 UTC로부터의 밀리초)가 됩니다.
+  - `'date'`: 반환 값이 Date 객체가 됩니다.
+  - `Intl.DateTimeFormatOptions`: 반환 값이 이 옵션에 따라 포맷된 문자열이 됩니다. 이 값이 제공되지 않으면 기본적으로 타임스탬프 값이 반환됩니다.
+
+## 반환 값
+
+이 함수는 `string | number | Date` 형식의 값을 반환합니다. 반환 값의 형식은 `format` 매개변수에 따라 결정됩니다.
+
+## 예제
+
+```typescript
+const relativeWeekDate = getRelativeWeekDate({
+  relativeWeeks: 2,
+  relativeDates: 3,
+  timeZone: 'Asia/Seoul',
+  format: 'date'
+})
+
+console.log(relativeWeekDate)
+```
+
+이 코드는 현재 시간으로부터 2주 후와 3일 후의 날짜를 `'Asia/Seoul'` 시간대에서의 Date 객체로 반환합니다.

package/docs/default-value/value-generator/year-date-generator.md

@@ -0,0 +1,43 @@
+# 함수 설명: getRelativeYearDate
+
+이 함수는 현재 날짜를 기준으로 파라미터로 주어진 상대적인 해(Year)의 상대적인 날짜(Date)의 시작 시간을 제공합니다.
+
+## 함수 시그니처
+
+```typescript
+function getRelativeYearDate(params: RelativeYearDateParams = {}): string | number | Date
+```
+
+## 매개변수
+
+이 함수는 `RelativeYearDateParams`라는 이름의 타입의 매개변수 객체를 받습니다. 이 객체의 필드에 대한 상세한 정보는 다음과 같습니다:
+
+- `relativeYears?: number`: 상대적인 연도를 나타내는 숫자입니다. 이 값은 현재 날짜로부터의 연도 수를 나타냅니다. 예를 들어, 이 값이 3이면 현재 날짜로부터 3년 뒤를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 연도를 의미합니다.
+
+- `relativeDates?: number`: 상대적인 일수를 나타내는 숫자입니다. 이 값은 현재 날짜로부터의 일 수를 나타냅니다. 예를 들어, 이 값이 2이면 현재 날짜로부터 2일 뒤를 나타냅니다. 이 값이 주어지지 않으면 기본값은 0입니다, 즉 현재 날짜를 의미합니다.
+
+- `timeZone?: string`: 날짜를 얻고자 하는 시간대를 나타내는 문자열입니다. 이 값이 주어지지 않으면 사용자의 로컬 시간대가 사용됩니다.
+
+- `format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions`: 반환하려는 날짜의 형식을 결정합니다. 이 값은 다음 세 가지 중 하나일 수 있습니다:
+  - `'timestamp'`: 반환 값이 UNIX 타임스탬프 (1970년 1월 1일 00:00:00 UTC로부터의 밀리초)가 됩니다.
+  - `'date'`: 반환 값이 Date 객체가 됩니다.
+  - `Intl.DateTimeFormatOptions`: 반환 값이 이 옵션에 따라 포맷된 문자열이 됩니다. 이 값이 제공되지 않으면 기본적으로 Date 객체가 반환됩니다.
+
+## 반환 값
+
+이 함수는 `string | number | Date` 형식의 값을 반환합니다. 반환 값의 형식은 `format` 매개변수에 따라 결정됩니다.
+
+## 예제
+
+```typescript
+const relativeYearDate = getRelativeYearDate({
+  relativeYears: 2,
+  relativeDates: 3,
+  timeZone: 'Asia/Seoul',
+  format: 'date'
+})
+
+console.log(relativeYearDate)
+```
+
+이 코드는 현재 시간으로부터 2년 후와 3일 후의 날짜를 `'Asia/Seoul'` 시간대에서의 Date 객체로 반환합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operato/data-grist",
-  "version": "1.3.4",
+  "version": "1.3.11",
   "description": "User interface for grid (desktop) and list (mobile)",
   "author": "heartyoh",
   "main": "dist/index.js",
@@ -57,7 +57,7 @@
   "dependencies": {
     "@material/mwc-icon": "^0.27.0",
     "@operato/headroom": "^1.3.2",
-    "@operato/input": "^1.3.2",
+    "@operato/input": "^1.3.5",
     "@operato/popup": "^1.3.2",
     "@operato/pull-to-refresh": "^1.3.2",
     "@operato/styles": "^1.3.2",
@@ -100,5 +100,5 @@
       "prettier --write"
     ]
   },
-  "gitHead": "05e81b4a374750b17aafea18d99ea19a45974dd9"
+  "gitHead": "4eafc978b1ab42661fd67dc2e30714d266d2c4de"
 }

package/src/editors/ox-grist-editor.ts

@@ -4,6 +4,7 @@ import { customElement, property } from 'lit/decorators.js'
 import { ZERO_COLUMN, ZERO_RECORD } from '../configure/zero-config'
 import { DataGridField } from '../data-grid/data-grid-field'
 import { ColumnConfig, GristRecord } from '../types'
+import { getDefaultValue } from '../value-generator'
 
 const STYLE = css`
   :host {
@@ -106,14 +107,21 @@ export class OxGristEditor extends LitElement {
     this.addEventListener('mousemove', (e: Event) => e.stopPropagation())
     this.addEventListener('mouseup', (e: Event) => e.stopPropagation())
 
-    const align = this.column.record.align
+    const { name = '' } = this.column
+    const { align, defaultValue } = this.column.record
+
     if (align) {
       this.style.textAlign = align
       this.style.textAlignLast = align /* for select */
     }
 
-    const name = this.column.name || ''
-    this.value = this._dirtyValue = this.formatForEditor(this.record[name])
+    var currentValue = this.record[name]
+
+    if (typeof currentValue == 'undefined' && defaultValue) {
+      currentValue = getDefaultValue(defaultValue, this.record)
+    }
+
+    this.value = this._dirtyValue = this.formatForEditor(currentValue)
 
     requestAnimationFrame(() => {
       this.focus()
@@ -144,13 +152,16 @@ export class OxGristEditor extends LitElement {
   }
 
   _onfocusout() {
-    if (this._dirtyValue !== this.value) {
+    const { name = '' } = this.column
+    var currentValue = this.record[name]
+
+    if (this._dirtyValue !== currentValue) {
       this.dispatchEvent(
         new CustomEvent('field-change', {
           bubbles: true,
           composed: true,
           detail: {
-            before: this.value,
+            before: currentValue,
             after: this._dirtyValue,
             column: this.column,
             record: this.record,

package/src/index.ts

@@ -12,5 +12,6 @@ export * from './gutters'
 export * from './filters'
 export * from './sorters/sorters-control'
 export * from './record-view'
+export * from './value-generator'
 
 export * from './utils/list-param'

package/src/types.ts

@@ -151,6 +151,21 @@ export type HeaderConfig = {
 }
 export type HeaderRenderer = (column: ColumnConfig) => any
 
+export type ValueGeneratorFn = (...args: any[]) => any
+export type DefaultValueFnConfig =
+  | {
+      /**
+       * The name of the default value function to be used for the column.
+       */
+      name: string
+
+      /**
+       * The parameters to be passed to the default value function.
+       */
+      params?: any[]
+    }
+  | Function
+
 export type RecordConfig = {
   renderer: FieldRenderer
   editor?: FieldEditor
@@ -160,6 +175,7 @@ export type RecordConfig = {
   align?: 'left' | 'right' | 'center'
   options: { [key: string]: any }
   rowOptionField?: string
+  defaultValue?: DefaultValueFnConfig
   [extended: string]: any
 }
 

package/src/value-generator/date-generator.ts

@@ -0,0 +1,35 @@
+export type RelativeDateParams = {
+  relativeDate?: number
+  timeZone?: string
+  format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions
+}
+
+export const getRelativeDate = (params: RelativeDateParams = {}): Date | number | string => {
+  const { relativeDate = 0, timeZone, format } = params
+  const relativeSeconds = relativeDate * 24 * 60 * 60
+
+  const now = new Date()
+  let currentDate: Date
+
+  if (timeZone) {
+    const options: Intl.DateTimeFormatOptions = { timeZone }
+    const currentDateISOString = now.toLocaleString('en-US', options).split(',')[0]
+    currentDate = new Date(currentDateISOString)
+  } else {
+    currentDate = now
+  }
+
+  const startOfDay = new Date(currentDate.getFullYear(), currentDate.getMonth(), currentDate.getDate())
+  const targetTime = startOfDay.getTime() + relativeSeconds * 1000
+
+  if (format === 'date') {
+    return new Date(targetTime)
+  } else if (format === 'timestamp') {
+    return targetTime
+  } else if (format) {
+    const formatter = new Intl.DateTimeFormat(undefined, format)
+    return formatter.format(new Date(targetTime))
+  } else {
+    return new Date(targetTime)
+  }
+}

package/src/value-generator/hour-time-generator.ts

@@ -0,0 +1,43 @@
+export type RelativeHourTimeParams = {
+  timeZone?: string
+  format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions
+  relativeHour?: number
+  relativeSeconds?: number
+}
+
+export const getRelativeHourTime = (params: RelativeHourTimeParams = {}): Date | number | string => {
+  const { relativeHour = 0, relativeSeconds = 0, timeZone, format } = params
+
+  const now = new Date()
+  let currentDate: Date
+
+  if (timeZone) {
+    const options: Intl.DateTimeFormatOptions = { timeZone }
+    const currentDateISOString = now.toLocaleString('en-US', options).split(',')[0]
+    currentDate = new Date(currentDateISOString)
+  } else {
+    currentDate = now
+  }
+
+  const startOfHour = new Date(
+    currentDate.getFullYear(),
+    currentDate.getMonth(),
+    currentDate.getDate(),
+    currentDate.getHours(),
+    0,
+    0,
+    0
+  )
+  const targetTime = startOfHour.getTime() + relativeHour * 60 * 60 * 1000 + relativeSeconds * 1000
+
+  if (format === 'date') {
+    return new Date(targetTime)
+  } else if (format === 'timestamp') {
+    return targetTime
+  } else if (format) {
+    const formatter = new Intl.DateTimeFormat(undefined, format)
+    return formatter.format(new Date(targetTime))
+  } else {
+    return new Date(targetTime)
+  }
+}

package/src/value-generator/index.ts

@@ -0,0 +1 @@
+export * from './registry'

package/src/value-generator/minute-time-generator.ts

@@ -0,0 +1,43 @@
+export type RelativeMinuteTimeParams = {
+  timeZone?: string
+  format?: 'timestamp' | 'date' | Intl.DateTimeFormatOptions
+  relativeMinutes?: number
+  relativeSeconds?: number
+}
+
+export const getRelativeMinuteTime = (params: RelativeMinuteTimeParams = {}): Date | number | string => {
+  const { relativeMinutes = 0, relativeSeconds = 0, timeZone, format } = params
+
+  const now = new Date()
+  let currentDate: Date
+
+  if (timeZone) {
+    const options: Intl.DateTimeFormatOptions = { timeZone }
+    const currentDateISOString = now.toLocaleString('en-US', options).split(',')[0]
+    currentDate = new Date(currentDateISOString)
+  } else {
+    currentDate = now
+  }
+
+  const startOfMinute = new Date(
+    currentDate.getFullYear(),
+    currentDate.getMonth(),
+    currentDate.getDate(),
+    currentDate.getHours(),
+    currentDate.getMinutes(),
+    0,
+    0
+  )
+  const targetTime = startOfMinute.getTime() + relativeMinutes * 60 * 1000 + relativeSeconds * 1000
+
+  if (format === 'date') {
+    return new Date(targetTime)
+  } else if (format === 'timestamp') {
+    return targetTime
+  } else if (format) {
+    const formatter = new Intl.DateTimeFormat(undefined, format)
+    return formatter.format(new Date(targetTime))
+  } else {
+    return new Date(targetTime)
+  }
+}