ko-chrono 0.3.1 → 0.4.0

package/dist/parsers/holiday.js

@@ -4,6 +4,7 @@ const FIXED = {
     크리스마스: [12, 25],
     성탄절: [12, 25],
     신정: [1, 1],
+    '새해 첫날': [1, 1],
     삼일절: [3, 1],
     '근로자의 날': [5, 1],
     노동절: [5, 1],

package/dist/parsers/offset.js

@@ -36,7 +36,9 @@ export const offset = (text) => {
                 break;
             case '달':
             case '개월':
+                // "한 달 뒤" = 다음 달 같은 날 (그 달 1일이 아니라)
                 c.monthOffset = sign * n;
+                c.sameDay = true;
                 break;
             case '년':
                 // "2028년 후"는 "2028년 뒤"가 아니라 "2028년 이후"일 가능성이 크다. 100년 넘게는 상대 이동으로 보지 않는다

package/dist/parsers/recurrence.d.ts

@@ -1,5 +1,9 @@
 import type { Parser, Recurrence } from '../types.js';
 /** 반복 일정. 날짜는 계산하지 않고 규칙만 뽑는다 (첫 발생일은 resolve가 계산) */
 export declare const recurrence: Parser;
-/** RFC 5545 RRULE 문자열. 요일은 월요일부터 */
-export declare function toRRule(r: Omit<Recurrence, 'rrule'>): string;
+/**
+ * RFC 5545 RRULE 문자열. 요일은 월요일부터.
+ * UNTIL은 벽시계 시각 그대로 쓴다 (DTSTART가 TZID 또는 floating time일 때의 형식).
+ * dateOnly면 DTSTART가 DATE이므로 UNTIL도 날짜만.
+ */
+export declare function toRRule(r: Omit<Recurrence, 'rrule'>, dateOnly?: boolean): string;

package/dist/parsers/recurrence.js

@@ -95,8 +95,13 @@ export const recurrence = (text) => {
     return out;
 };
 const CODE = ['SU', 'MO', 'TU', 'WE', 'TH', 'FR', 'SA'];
-/** RFC 5545 RRULE 문자열. 요일은 월요일부터 */
-export function toRRule(r) {
+const pad = (n) => String(n).padStart(2, '0');
+/**
+ * RFC 5545 RRULE 문자열. 요일은 월요일부터.
+ * UNTIL은 벽시계 시각 그대로 쓴다 (DTSTART가 TZID 또는 floating time일 때의 형식).
+ * dateOnly면 DTSTART가 DATE이므로 UNTIL도 날짜만.
+ */
+export function toRRule(r, dateOnly = false) {
     const parts = [`FREQ=${r.freq}`];
     if (r.interval > 1)
         parts.push(`INTERVAL=${r.interval}`);
@@ -108,5 +113,13 @@ export function toRRule(r) {
         const days = [...r.byWeekday].sort((a, b) => ((a + 6) % 7) - ((b + 6) % 7)).map((d) => CODE[d]);
         parts.push(`BYDAY=${days.map((c) => (r.byWeekdayNth ? `${r.byWeekdayNth}${c}` : c)).join(',')}`);
     }
+    if (r.until) {
+        const u = r.until;
+        const date = `${u.getFullYear()}${pad(u.getMonth() + 1)}${pad(u.getDate())}`;
+        parts.push(`UNTIL=${dateOnly ? date : `${date}T${pad(u.getHours())}${pad(u.getMinutes())}${pad(u.getSeconds())}`}`);
+    }
+    else if (r.count) {
+        parts.push(`COUNT=${r.count}`);
+    }
     return parts.join(';');
 }

package/dist/parsers/time.js

@@ -1,4 +1,6 @@
 import { parseKoreanNumber } from '../util/number.js';
+// "24시 편의점", "24시 영업": 하루 종일 연다는 뜻이지 시각이 아니다
+const OPEN_ALL_DAY = /^\s*(?:편의점|영업|운영|무인|사우나|찜질방|약국|병원|동물병원|매장|카페|식당|해장국|김밥|헬스|콜센터|상담)/;
 // "오후 3시", "3시 반", "오전 10시 30분", "새벽 2시", "저녁 7시", "낮 12시", "15시", "7시30", "3시 정각"
 const CLOCK = /(오전|오후|새벽|아침|저녁|밤|낮|정오)?\s*(\d{1,2}|한|두|세|네|다섯|여섯|일곱|여덟|아홉|열|열한|열두)\s*시(?!간)\s*(?:(반)|(\d{1,2})\s*분|(\d{2})(?![\d가-힣])|정각)?/g;
 // "5시 10분 전" → 4:50
@@ -97,6 +99,8 @@ export const time = (text) => {
         const raw = parseKoreanNumber(m[2]);
         if (raw == null || raw > 24)
             continue;
+        if (raw === 24 && !m[1] && OPEN_ALL_DAY.test(text.slice(m.index + m[0].length)))
+            continue;
         if (!take(m.index, m[0].length))
             continue;
         const hour = applyMeridiem(m[1], raw);

package/dist/parsers/weekday.js

@@ -22,8 +22,8 @@ const WEEKS_LATER = new RegExp(`(\\d{1,2}|한|두|세|네|다섯)\\s*주\\s*(?:
 // "전주"는 도시 이름과 너무 자주 겹쳐서 요일이 붙을 때만
 const FORMAL_WEEK = { 전전: -2, 전: -1, 금: 0, 차: 1, 익: 1, 차차: 2 };
 const FORMAL_WITH_DAY = new RegExp(`(?<![가-힣])(전전|차차|전|금|차|익)주\\s*(${DAY})(?:요일|욜)`, 'g');
-// "차주 중으로", "금주 내로", "차주에 회의", "익주까지". "금주에"는 "금주에 성공했어"(禁酒)와 겹쳐서 제외
-const FORMAL_WEEK_ONLY = /(?<![가-힣])(?:(전전|차차|차|익)주(?=\s*(?:에(?!게|서)|에는|중으로|중에|내로|내|안에|안으로|까지|초|말|부터))|(금)주(?=\s*(?:중으로|중에|내로|내|안에|안으로|까지|초|말|부터)))/g;
+// "차주 중으로", "차주 중", "금주 내로", "차주에 회의", "익주까지". "금주에"는 "금주에 성공했어"(禁酒)와 겹쳐서 제외
+const FORMAL_WEEK_ONLY = /(?<![가-힣])(?:(전전|차차|차|익)주(?=\s*(?:에(?!게|서)|에는|중으로|중에|중(?![가-힣])|내로|내|안에|안으로|까지|초|말|부터))|(금)주(?=\s*(?:중으로|중에|중(?![가-힣])|내로|내|안에|안으로|까지|초|말|부터)))/g;
 // "지난 금요일" = 오늘 제외 가장 가까운 과거, "다음 금요일" = 오늘 제외 가장 가까운 미래
 const DIR = new RegExp(`(지난|저번|다음)\\s*(${DAY})(?:요일|욜)`, 'g');
 // "주말에 보자" ("이번 주말"은 위 WEEKEND가 먼저 잡는다)
@@ -85,7 +85,7 @@ export const weekday = (text) => {
         taken.push([m.index, m.index + m[0].length]);
     }
     for (const m of text.matchAll(WEEKEND)) {
-        out.push({ text: m[0], index: m.index, components: { weekOffset: WEEK_WORDS[m[1]], weekday: 6 } });
+        out.push({ text: m[0], index: m.index, components: { weekOffset: WEEK_WORDS[m[1]], weekday: 6, weekend: true } });
         taken.push([m.index, m.index + m[0].length]);
     }
     for (const m of text.matchAll(BARE_WEEKEND)) {

package/dist/resolve.js

@@ -67,6 +67,7 @@ const DATE_KEYS = [
 /** 날짜 정보 없이 시각만 있는 조각인지 ("5시까지", "17:00") */
 export function isTimeOnly(c) {
     return (c.hour !== undefined &&
+        c.recur === undefined &&
         c.hourOffset === undefined &&
         c.minuteOffset === undefined &&
         !DATE_KEYS.some((k) => c[k] !== undefined));
@@ -110,7 +111,9 @@ function hasConflict(a, b) {
     const weekdayNote = (x, y) => x.day !== undefined && y.weekday !== undefined && !y.weekend &&
         y.weekOffset === undefined && y.day === undefined && y.dayOffset === undefined && y.monthPart === undefined;
     const dayConflict = both(dayKeys) && !weekdayNote(a, b) && !weekdayNote(b, a);
-    return dayConflict || both(timeKeys) || dateVsRel;
+    // 규칙 34: "다음주부터 매주 월요일"의 날짜는 반복의 시작·끝이라 따로 해석한 뒤 parseAll이 묶는다
+    const recurVsDate = (a.recur !== undefined && has(b, dateKeys)) || (b.recur !== undefined && has(a, dateKeys));
+    return dayConflict || both(timeKeys) || dateVsRel || recurVsDate;
 }
 export function resolve(group, opts) {
     const c = merge(group.map((f) => f.components));
@@ -159,7 +162,15 @@ export function resolve(group, opts) {
     if (!isLunar && (hasYear || c.month !== undefined || c.day !== undefined)) {
         let y = c.year ?? ref.getFullYear() + (c.yearOffset ?? 0);
         // "작년", "내년"처럼 연도만 있으면 1월 1일. "내년 이맘때", "1년 뒤"는 오늘 날짜 유지
-        const m0 = c.month !== undefined ? c.month - 1 : hasYear && !c.sameDay ? 0 : ref.getMonth();
+        let m0 = c.month !== undefined ? c.month - 1 : hasYear && !c.sameDay ? 0 : ref.getMonth();
+        // "5일까지"처럼 일만 있으면: 오늘이 그날을 넘었으면 다음 달, 아니면 이번 달 (오늘 포함).
+        // 그 달에 없는 날("11월에 31일")은 아래에서 null
+        if (!hasYear && c.month === undefined && c.day !== undefined && c.monthOffset === undefined && c.nthWeek === undefined) {
+            if (c.day < ref.getDate())
+                m0 += 1;
+            y += Math.floor(m0 / 12);
+            m0 %= 12;
+        }
         // 연도 미지정 + 이미 지났으면 내년으로.
         // 월일("3월 1일")은 그 날이, 월("3월", "2월 말")은 그 달이 통째로 지났을 때.
         if (!hasYear && c.month !== undefined) {
@@ -313,6 +324,9 @@ export function resolve(group, opts) {
         // "~까지", "~이내": 시작은 기준 시각, 끝은 해당 시점(시간 없으면 그날 23:59)
         // "~내내": 시작은 그 기간의 시작, 끝은 기간의 끝
         result.end = hasTime ? new Date(d) : periodEnd(d, c);
+        // "이번 주말 내내" → 토요일부터 일요일까지
+        if (c.whole && c.weekend && !hasTime && result.end.getDay() === 6)
+            result.end.setDate(result.end.getDate() + 1);
         // 규칙 30: "어제까지"처럼 이미 지난 마감은 구간이 아니라 그 시점 (date = end)
         if (c.isEnd)
             result.date = result.end < ref ? new Date(result.end) : new Date(ref);
@@ -324,7 +338,7 @@ function periodEnd(d, c) {
     let end = new Date(d);
     if (c.weekOffset !== undefined && c.weekday === undefined)
         end.setDate(end.getDate() + 6);
-    else if (c.monthOffset !== undefined && c.monthPart === undefined && c.day === undefined)
+    else if (c.monthOffset !== undefined && c.monthPart === undefined && c.day === undefined && !c.sameDay)
         end = new Date(end.getFullYear(), end.getMonth(), lastDayOfMonth(end.getFullYear(), end.getMonth()));
     else if ((c.year !== undefined || c.yearOffset !== undefined) && c.month === undefined && !c.sameDay)
         end = new Date(end.getFullYear(), 11, 31);
@@ -392,13 +406,25 @@ function resolveRecurrence(group, c, opts) {
     }
     if (!d)
         return null;
+    // 규칙 34: "10주 동안 매주 월요일" → 오늘(또는 "A부터"의 A)부터 그 기간의 마지막 날 23:59까지
+    const rule = { ...r };
+    if (c.durationDays !== undefined || c.durationMonths !== undefined) {
+        // N달 뒤 같은 날의 전날까지. 그 달에 없는 날이면 말일로 맞춘다 (11/30 + 3달 → 2/28의 전날)
+        const until = sameDayIn(today.getFullYear(), today.getMonth() + (c.durationMonths ?? 0), today.getDate());
+        until.setDate(until.getDate() + (c.durationDays ?? 0) - 1);
+        until.setHours(23, 59, 0, 0);
+        if (until < d)
+            return null;
+        rule.until = until;
+    }
     const last = group[group.length - 1];
+    const timed = hasTime || r.freq === 'HOURLY' || r.freq === 'MINUTELY';
     const result = {
         date: d,
         text: '',
         index: group[0].index,
-        hasTime: hasTime || r.freq === 'HOURLY' || r.freq === 'MINUTELY',
-        recurrence: { ...r, rrule: toRRule(r) },
+        hasTime: timed,
+        recurrence: { ...rule, rrule: toRRule(rule, !timed) },
     };
     result._end = last.index + last.text.length;
     return result;

package/dist/types.d.ts

@@ -88,7 +88,15 @@ export interface Recurrence {
     byMonthDay?: number;
     /** 매년 몇 월 */
     byMonth?: number;
-    /** 'FREQ=WEEKLY;BYDAY=MO,WE,FR'. date를 DTSTART로 함께 쓰면 캘린더에 그대로 넣을 수 있다 */
+    /** 마지막 발생 한도 ("다음달까지 매주 월요일" → 다음달 말일 23:59). count와 함께 오지 않는다 */
+    until?: Date;
+    /** 전체 횟수 ("총 8회", "10번 반복") */
+    count?: number;
+    /**
+     * 'FREQ=WEEKLY;BYDAY=MO,WE,FR'. date를 DTSTART로 함께 쓰면 캘린더에 그대로 넣을 수 있다.
+     * UNTIL은 date와 같은 벽시계 시각(floating time)으로 쓴다. 시각이 없으면 'UNTIL=20261130'처럼 날짜만.
+     * DTSTART를 UTC나 TZID로 쓰는 캘린더 파일에는 toICS()가 UNTIL을 UTC로 바꿔 넣는다
+     */
     rrule: string;
 }
 export interface Fragment {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ko-chrono",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "한국어 자연어 날짜/시간 파서 — '다음주 화요일 오후 3시' → Date",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -16,10 +16,15 @@
         "types": "./dist/cjs/index.d.ts",
         "default": "./dist/cjs/index.js"
       }
-    }
+    },
+    "./package.json": "./package.json"
   },
   "sideEffects": false,
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.cjs.json && node scripts/mark-cjs.mjs",
     "prepublishOnly": "npm run build && npm test",
@@ -28,7 +33,16 @@
     "typecheck": "tsc --noEmit",
     "playground": "npm run build && npx serve ."
   },
-  "keywords": ["korean", "한국어", "date", "parser", "natural-language", "날짜", "nlp", "chrono"],
+  "keywords": [
+    "korean",
+    "한국어",
+    "date",
+    "parser",
+    "natural-language",
+    "날짜",
+    "nlp",
+    "chrono"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",