ko-chrono 0.1.0 → 0.3.0

package/dist/cjs/parsers/time.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.time = void 0;
+const number_js_1 = require("../util/number.js");
+// "오후 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
+const BEFORE = /(오전|오후|새벽|아침|저녁|밤|낮)?\s*(\d{1,2}|한|두|세|네|다섯|여섯|일곱|여덟|아홉|열|열한|열두)\s*시\s*(\d{1,2})\s*분\s*전(?=[\s,에까]|$)/g;
+// "오전 중으로", "오후 중에" → 그 시간대의 끝(12시/18시)까지
+const HALF_DAY = /(오전|오후)\s*중(?!순)(?:으로|에는|에)?/g;
+// "3pm", "9 AM", "12pm"
+const AMPM = /(?<![\d:])(\d{1,2})(?::(\d{2}))?\s*([ap])\.?m\.?(?![a-z])/gi;
+// "3~5시", "오후 3~5시" → "오후 3" + "5시" 두 조각 (index.ts가 "~"로 구간을 합친다)
+const SHORT_RANGE = /(오전|오후|새벽|아침|저녁|밤|낮)?\s*(\d{1,2}|한|두|세|네|다섯|여섯|일곱|여덟|아홉|열|열한|열두)\s*~\s*((\d{1,2}|한|두|세|네|다섯|여섯|일곱|여덟|아홉|열|열한|열두)\s*시)/g;
+// "15:30", "3:00", "오후 3:30"
+const COLON = /(?:(오전|오후|새벽|아침|저녁|밤|낮)\s*)?(?<!\d)(\d{1,2}):(\d{2})(?!\d)/g;
+// 단독 시간 단어. "낮"은 "낮다"와 겹쳐서 뒤에 공백/조사가 올 때만
+const WORD = /(정오|자정|점심|아침|저녁|밤(?!새|낮)|퇴근|낮(?=[\s에,]|$))(?!\s*\d)/g;
+// "내일 오후", "오전에" → 9시/15시 (규칙 25). 뒤에 조사·공백·끝만 허용하고,
+// "오전반", "오후 반차", "오전오후"처럼 다른 낱말이 붙으면 잡지 않는다
+const HALF_WORD = /(?<![가-힣])(오전|오후)(?=(?:에는|에|엔|은|는|도|쯤|께)?(?:[\s,.!?~]|$))(?!\s*(?:반|오전|오후|\d))/g;
+const WORD_HOUR = {
+    정오: 12, 자정: 0, 점심: 12, 아침: 8, 저녁: 19, 밤: 21, 퇴근: 18, 낮: 12, 오전: 9, 오후: 15,
+};
+// "내일 이 시간", "다음 주 이 시간" → 기준 시각의 시:분. "같이 시간 내자"는 잡지 않는다
+const SAME_TIME = /(?<![가-힣])이\s*시간(?!대|\s*(?:뒤|후|전|동안|이내|안에))/g;
+function applyMeridiem(prefix, hour) {
+    if (hour === 24)
+        return 0;
+    switch (prefix) {
+        case '밤':
+            // 밤 12시 = 자정, 밤 1~5시 = 새벽
+            return hour === 12 ? 0 : hour <= 5 ? hour : hour < 12 ? hour + 12 : hour;
+        case '오후':
+        case '저녁':
+        case '낮':
+            return hour < 12 ? hour + 12 : hour;
+        case '오전':
+        case '새벽':
+        case '아침':
+            return hour === 12 ? 0 : hour;
+        case '정오':
+            return 12;
+        default:
+            return hour;
+    }
+}
+/** 시각 표현 */
+const time = (text) => {
+    const out = [];
+    const taken = [];
+    const take = (i, len) => {
+        if (taken.some(([s, e]) => i < e && i + len > s))
+            return false;
+        taken.push([i, i + len]);
+        return true;
+    };
+    for (const m of text.matchAll(SHORT_RANGE)) {
+        const a = (0, number_js_1.parseKoreanNumber)(m[2]), b = (0, number_js_1.parseKoreanNumber)(m[4]);
+        if (a == null || b == null || a > 24 || b > 24)
+            continue;
+        const bIndex = m.index + m[0].length - m[3].length;
+        if (!take(m.index, m[0].length))
+            continue;
+        const startText = m[0].slice(0, m[0].indexOf('~')).trimEnd();
+        const start = { hour: applyMeridiem(m[1], a), minute: 0 };
+        if (m[1])
+            start.meridiem = true;
+        out.push({ text: startText, index: m.index, components: start });
+        out.push({ text: m[3], index: bIndex, components: { hour: b === 24 ? 0 : b, minute: 0 } });
+    }
+    for (const m of text.matchAll(BEFORE)) {
+        const raw = (0, number_js_1.parseKoreanNumber)(m[2]);
+        if (raw == null || raw > 24 || +m[3] > 59)
+            continue;
+        if (!take(m.index, m[0].length))
+            continue;
+        const total = applyMeridiem(m[1], raw) * 60 - +m[3];
+        const c = { hour: Math.floor(total / 60), minute: total % 60 };
+        if (m[1])
+            c.meridiem = true;
+        out.push({ text: m[0], index: m.index, components: c });
+    }
+    for (const m of text.matchAll(HALF_DAY)) {
+        if (!take(m.index, m[0].length))
+            continue;
+        const hour = m[1] === '오전' ? 12 : 18;
+        out.push({ text: m[0], index: m.index, components: { hour, minute: 0, meridiem: true, isEnd: true } });
+    }
+    for (const m of text.matchAll(AMPM)) {
+        const raw = +m[1];
+        if (raw < 1 || raw > 12)
+            continue;
+        if (!take(m.index, m[0].length))
+            continue;
+        const hour = applyMeridiem(m[3].toLowerCase() === 'p' ? '오후' : '오전', raw);
+        out.push({ text: m[0], index: m.index, components: { hour, minute: m[2] ? +m[2] : 0, meridiem: true } });
+    }
+    for (const m of text.matchAll(CLOCK)) {
+        const raw = (0, number_js_1.parseKoreanNumber)(m[2]);
+        if (raw == null || raw > 24)
+            continue;
+        if (!take(m.index, m[0].length))
+            continue;
+        const hour = applyMeridiem(m[1], raw);
+        let minute = 0;
+        if (m[3])
+            minute = 30;
+        else if (m[4] ?? m[5])
+            minute = +(m[4] ?? m[5]);
+        if (minute > 59)
+            continue;
+        const c = { hour, minute };
+        if (m[1])
+            c.meridiem = true;
+        if (raw === 24 || (m[1] === '밤' && raw === 12))
+            c.midnight = true;
+        out.push({ text: m[0], index: m.index, components: c });
+    }
+    for (const m of text.matchAll(COLON)) {
+        const raw = +m[2], minute = +m[3];
+        if (raw > 23 || minute > 59)
+            continue;
+        if (!take(m.index, m[0].length))
+            continue;
+        const hour = applyMeridiem(m[1], raw);
+        out.push({ text: m[0], index: m.index, components: { hour, minute, meridiem: true } });
+    }
+    for (const m of text.matchAll(SAME_TIME)) {
+        if (!take(m.index, m[0].length))
+            continue;
+        out.push({ text: m[0], index: m.index, components: { sameTime: true } });
+    }
+    for (const m of text.matchAll(HALF_WORD)) {
+        if (!take(m.index, m[0].length))
+            continue;
+        out.push({ text: m[0], index: m.index, components: { hour: WORD_HOUR[m[1]], minute: 0, meridiem: true, approximate: true } });
+    }
+    for (const m of text.matchAll(WORD)) {
+        if (!take(m.index, m[0].length))
+            continue;
+        const c = { hour: WORD_HOUR[m[1]], minute: 0, meridiem: true };
+        if (m[1] === '자정')
+            c.midnight = true;
+        // 정오·자정은 정확한 시각, 나머지(아침·저녁·밤·점심·낮·퇴근)는 관례
+        else if (m[1] !== '정오')
+            c.approximate = true;
+        out.push({ text: m[0], index: m.index, components: c });
+    }
+    return out;
+};
+exports.time = time;

package/dist/cjs/parsers/weekday.d.ts

@@ -0,0 +1,3 @@
+import type { Parser } from '../types.js';
+/** 요일 관련 표현 */
+export declare const weekday: Parser;

package/dist/cjs/parsers/weekday.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.weekday = void 0;
+const number_js_1 = require("../util/number.js");
+const WEEKDAY = { 일: 0, 월: 1, 화: 2, 수: 3, 목: 4, 금: 5, 토: 6 };
+const WEEK_WORDS = {
+    지지난: -2, 저저번: -2, 지난: -1, 저번: -1, 이번: 0, 다음: 1, 다다음: 2, 다담: 2, 담: 1,
+};
+const WEEK_WORD = '지지난|저저번|지난|저번|이번|다다음|다음|다담|담';
+const DAY = '월|화|수|목|금|토|일';
+// "이번 주말", "다음주말", "지난 주말" → 그 주의 토요일
+const WEEKEND = new RegExp(`(${WEEK_WORD})\\s*주말`, 'g');
+// "월~금", "화~목요일" → 두 조각 (index.ts가 "~"로 구간을 합친다)
+const RANGE = new RegExp(`(?<![\\d가-힣])(${DAY})\\s*~\\s*((${DAY})(?:요일|욜)?)(?![가-힣])`, 'g');
+// "11/3(화)", "11월 5일 (목)" 뒤에 붙는 요일 표시
+const PAREN = new RegExp(`\\((${DAY})\\)`, 'g');
+// "11월 첫째 주 월요일", "둘째 주 수요일", "마지막 주 금요일", "12월 셋째 주"
+// 요일 글자만 쓸 때("첫째 주 월")는 뒤에 한글이 없어야 한다 ("둘째 주 일정"의 "일"은 요일이 아님)
+const NTH = new RegExp(`(?:(\\d{1,2})\\s*월\\s*)?(첫째|첫|둘째|셋째|넷째|다섯째|마지막)\\s*주(?:\\s*(${DAY})(?:요일|욜|(?![가-힣])))?`, 'g');
+const NTH_NUM = { 첫째: 1, 첫: 1, 둘째: 2, 셋째: 3, 넷째: 4, 다섯째: 5, 마지막: -1 };
+// "2주 뒤 월요일", "3주 후 금요일" → N주 뒤의 그 주의 X요일 ("다다음주 월요일"과 같은 계산)
+const WEEKS_LATER = new RegExp(`(\\d{1,2}|한|두|세|네|다섯)\\s*주\\s*(?:뒤|후)\\s*(${DAY})(?:요일|욜)`, 'g');
+// "지난 금요일" = 오늘 제외 가장 가까운 과거, "다음 금요일" = 오늘 제외 가장 가까운 미래
+const DIR = new RegExp(`(지난|저번|다음)\\s*(${DAY})(?:요일|욜)`, 'g');
+// "주말에 보자" ("이번 주말"은 위 WEEKEND가 먼저 잡는다)
+const BARE_WEEKEND = /(?<![가-힣])주말(?=[\s,에엔은는도까부]|$)/g;
+// "다음주 화요일", "이번 주 금", "다다음주 월요일", "담주 월욜"
+const WITH_WEEK = new RegExp(`(${WEEK_WORD})\\s*주\\s*(${DAY})(요일|욜)?`, 'g');
+// "화요일", "화욜" 단독 (요일 글자만은 오탐이 많아 '요일'/'욜'까지 요구)
+const BARE = /(?<![가-힣])(월|화|수|목|금|토|일)(?:요일|욜)/g;
+// "다음주", "이번주" 단독 (요일 없음) → 그 주의 시작 요일
+const WEEK_ONLY = new RegExp(`(${WEEK_WORD})\\s*주(\\s*이맘때)?(?!\\s*(${DAY}))`, 'g');
+/** 요일 관련 표현 */
+const weekday = (text) => {
+    const out = [];
+    const taken = [];
+    const overlaps = (i, len) => taken.some(([s, e]) => i < e && i + len > s);
+    for (const m of text.matchAll(WEEKS_LATER)) {
+        const n = (0, number_js_1.parseKoreanNumber)(m[1]);
+        if (n == null)
+            continue;
+        out.push({ text: m[0], index: m.index, components: { weekOffset: n, weekday: WEEKDAY[m[2]] } });
+        taken.push([m.index, m.index + m[0].length]);
+    }
+    for (const m of text.matchAll(NTH)) {
+        const c = { nthWeek: NTH_NUM[m[2]] };
+        if (m[1]) {
+            const month = +m[1];
+            if (month < 1 || month > 12)
+                continue;
+            c.month = month;
+        }
+        if (m[3])
+            c.weekday = WEEKDAY[m[3]];
+        out.push({ text: m[0], index: m.index, components: c });
+        taken.push([m.index, m.index + m[0].length]);
+    }
+    for (const m of text.matchAll(RANGE)) {
+        const bIndex = m.index + m[0].length - m[2].length;
+        out.push({ text: m[1], index: m.index, components: { weekday: WEEKDAY[m[1]] } });
+        out.push({ text: m[2], index: bIndex, components: { weekday: WEEKDAY[m[3]] } });
+        taken.push([m.index, m.index + m[0].length]);
+    }
+    for (const m of text.matchAll(PAREN)) {
+        out.push({ text: m[0], index: m.index, components: { weekday: WEEKDAY[m[1]] } });
+        taken.push([m.index, m.index + m[0].length]);
+    }
+    for (const m of text.matchAll(DIR)) {
+        const dir = m[1] === '다음' ? 'next' : 'past';
+        out.push({ text: m[0], index: m.index, components: { weekday: WEEKDAY[m[2]], weekdayDir: dir } });
+        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 } });
+        taken.push([m.index, m.index + m[0].length]);
+    }
+    for (const m of text.matchAll(BARE_WEEKEND)) {
+        if (overlaps(m.index, m[0].length))
+            continue;
+        out.push({ text: m[0], index: m.index, components: { weekday: 6, weekend: true } });
+        taken.push([m.index, m.index + m[0].length]);
+    }
+    for (const m of text.matchAll(WITH_WEEK)) {
+        if (overlaps(m.index, m[0].length))
+            continue;
+        out.push({
+            text: m[0],
+            index: m.index,
+            components: { weekOffset: WEEK_WORDS[m[1]], weekday: WEEKDAY[m[2]] },
+        });
+        taken.push([m.index, m.index + m[0].length]);
+    }
+    for (const m of text.matchAll(BARE)) {
+        if (overlaps(m.index, m[0].length))
+            continue;
+        out.push({ text: m[0], index: m.index, components: { weekday: WEEKDAY[m[1]] } });
+        taken.push([m.index, m.index + m[0].length]);
+    }
+    for (const m of text.matchAll(WEEK_ONLY)) {
+        if (overlaps(m.index, m[0].length))
+            continue;
+        const c = { weekOffset: WEEK_WORDS[m[1]] };
+        if (m[2])
+            c.sameDay = true;
+        out.push({ text: m[0], index: m.index, components: c });
+    }
+    return out;
+};
+exports.weekday = weekday;

package/dist/cjs/resolve.d.ts

@@ -0,0 +1,21 @@
+import type { Components, Fragment, ParseResult, ResolveOptions } from './types.js';
+/**
+ * 인접한 조각(fragment)을 하나로 합친다.
+ * 예: "다음주 화요일" + "오후 3시" → 하나의 결과.
+ * 인접 기준: 사이에 공백/쉼표/조사(에,의,엔,은,는,도)/어림말(쯤,경,께)만 있을 때.
+ */
+export declare function groupFragments(fragments: Fragment[], text: string): Fragment[][];
+export declare function merge(list: Components[]): Components;
+/** 날짜 정보 없이 시각만 있는 조각인지 ("5시까지", "17:00") */
+export declare function isTimeOnly(c: Components): boolean;
+/** 날짜 정보가 요일뿐인 조각인지 ("금요일까지") */
+export declare function isWeekdayOnly(c: Components): boolean;
+/** 날짜 정보가 "N일"뿐인 조각인지 ("3일까지") */
+export declare function isDayOnly(c: Components): boolean;
+/**
+ * 시 범위의 끝을 시작에 맞춘다 (규칙 16).
+ * 끝을 시작과 같은 날에 놓고, 시작보다 이르면 오전/오후를 이어받거나(+12h) 다음날로 넘긴다.
+ * "오후 3~5시" → 17시, "오후 11시부터 1시까지" → 다음날 1시, "오후 3시부터 오전 1시까지" → 다음날 1시
+ */
+export declare function alignEnd(start: Date, end: Components): Date;
+export declare function resolve(group: Fragment[], opts: ResolveOptions): ParseResult | null;