@chenzy-design/core 0.2.1 → 0.4.0

package/dist/audio-player.test.js

@@ -0,0 +1,275 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createAudioPlayer, normalizeAudioUrl, clampVolume, clampTime, } from './audio-player.js';
+/** 一个可断言的假 <audio> 适配器：记录调用并维护一份内部媒体状态。 */
+function makeAdapter(overrides = {}) {
+    const media = { currentTime: 0, duration: 120, volume: 1, playbackRate: 1 };
+    const play = vi.fn(() => { });
+    const pause = vi.fn(() => { });
+    const adapter = {
+        play,
+        pause,
+        getCurrentTime: () => media.currentTime,
+        setCurrentTime: (s) => {
+            media.currentTime = s;
+        },
+        getDuration: () => media.duration,
+        getVolume: () => media.volume,
+        setVolume: (v) => {
+            media.volume = v;
+        },
+        getPlaybackRate: () => media.playbackRate,
+        setPlaybackRate: (v) => {
+            media.playbackRate = v;
+        },
+        ...overrides,
+    };
+    return { adapter, media, play, pause };
+}
+describe('normalizeAudioUrl — audioUrl 四形态归一（对齐 Semi）', () => {
+    it('string → 单曲', () => {
+        expect(normalizeAudioUrl('a.mp3')).toEqual([{ src: 'a.mp3' }]);
+    });
+    it('AudioInfo → 单曲带 title/cover', () => {
+        expect(normalizeAudioUrl({ src: 'a.mp3', title: 'A', cover: 'a.png' })).toEqual([
+            { src: 'a.mp3', title: 'A', cover: 'a.png' },
+        ]);
+    });
+    it('string[] → 多曲，丢弃空串', () => {
+        expect(normalizeAudioUrl(['a.mp3', '', 'b.mp3'])).toEqual([
+            { src: 'a.mp3' },
+            { src: 'b.mp3' },
+        ]);
+    });
+    it('AudioInfo[] → 多曲，丢弃无 src 项', () => {
+        const input = [
+            { src: 'a.mp3', title: 'A' },
+            { title: 'no-src' },
+            { src: 'b.mp3', cover: 'b.png' },
+        ];
+        expect(normalizeAudioUrl(input)).toEqual([
+            { src: 'a.mp3', title: 'A' },
+            { src: 'b.mp3', cover: 'b.png' },
+        ]);
+    });
+    it('空/无效输入 → []', () => {
+        expect(normalizeAudioUrl(undefined)).toEqual([]);
+        expect(normalizeAudioUrl(null)).toEqual([]);
+        expect(normalizeAudioUrl('')).toEqual([]);
+        expect(normalizeAudioUrl([])).toEqual([]);
+    });
+});
+describe('clamp helpers', () => {
+    it('clampVolume 钳制 [0,100]', () => {
+        expect(clampVolume(-5)).toBe(0);
+        expect(clampVolume(50)).toBe(50);
+        expect(clampVolume(150)).toBe(100);
+        expect(clampVolume(NaN)).toBe(0);
+    });
+    it('clampTime 钳制 [0,total]', () => {
+        expect(clampTime(-1, 100)).toBe(0);
+        expect(clampTime(50, 100)).toBe(50);
+        expect(clampTime(200, 100)).toBe(100);
+    });
+});
+describe('createAudioPlayer — statusClick 播放/暂停', () => {
+    it('切换 isPlaying 并调用 play/pause', () => {
+        const { adapter, play, pause } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        expect(p.getState().isPlaying).toBe(false);
+        p.handleStatusClick();
+        expect(p.getState().isPlaying).toBe(true);
+        expect(play).toHaveBeenCalledTimes(1);
+        p.handleStatusClick();
+        expect(p.getState().isPlaying).toBe(false);
+        expect(pause).toHaveBeenCalledTimes(1);
+    });
+});
+describe('createAudioPlayer — trackChange 上下曲边界', () => {
+    it('多曲 next/prev 取模循环（对齐 Semi：末曲 next 绕回首曲、首曲 prev 绕到末曲）', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: ['a.mp3', 'b.mp3', 'c.mp3'] });
+        expect(p.isMultiTrack()).toBe(true);
+        expect(p.getState().currentTrackIndex).toBe(0);
+        // 首曲 prev 绕到末曲（(0-1+3)%3=2，对齐 Semi）
+        p.handleTrackChange('prev');
+        expect(p.getState().currentTrackIndex).toBe(2);
+        p.handleTrackChange('next'); // (2+1)%3=0 绕回首曲
+        expect(p.getState().currentTrackIndex).toBe(0);
+        p.handleTrackChange('next');
+        expect(p.getState().currentTrackIndex).toBe(1);
+        p.handleTrackChange('next');
+        expect(p.getState().currentTrackIndex).toBe(2);
+        // 末曲 next 绕回首曲（(2+1)%3=0）
+        p.handleTrackChange('next');
+        expect(p.getState().currentTrackIndex).toBe(0);
+    });
+    it('切曲重置进度', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: ['a.mp3', 'b.mp3'] });
+        p.handleTimeChange(30);
+        expect(p.getState().currentTime).toBe(30);
+        p.handleTrackChange('next');
+        expect(p.getState().currentTime).toBe(0);
+        expect(p.getState().totalTime).toBe(0);
+    });
+    it('单曲 trackChange no-op', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        expect(p.isMultiTrack()).toBe(false);
+        p.handleTrackChange('next');
+        expect(p.getState().currentTrackIndex).toBe(0);
+    });
+});
+describe('createAudioPlayer — timeChange / seek 钳制', () => {
+    it('timeChange 钳到 [0,totalTime] 并写 audio', () => {
+        const { adapter, media } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        p.initAudioState(); // totalTime=120
+        expect(p.getState().totalTime).toBe(120);
+        p.handleTimeChange(50);
+        expect(p.getState().currentTime).toBe(50);
+        expect(media.currentTime).toBe(50);
+        p.handleTimeChange(999);
+        expect(p.getState().currentTime).toBe(120);
+        p.handleTimeChange(-10);
+        expect(p.getState().currentTime).toBe(0);
+    });
+    it('seek 按 skipDuration 相对跳，并钳制', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3', skipDuration: 15 });
+        p.initAudioState(); // totalTime=120
+        p.handleTimeChange(30);
+        p.handleSeek(1); // +15 → 45
+        expect(p.getState().currentTime).toBe(45);
+        p.handleSeek(-1); // -15 → 30
+        expect(p.getState().currentTime).toBe(30);
+        p.handleTimeChange(10);
+        p.handleSeek(-1); // 10-15 → 钳到 0
+        expect(p.getState().currentTime).toBe(0);
+    });
+    it('skipDuration 默认 10', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        p.initAudioState();
+        p.handleTimeChange(20);
+        p.handleSeek(1);
+        expect(p.getState().currentTime).toBe(30);
+    });
+});
+describe('createAudioPlayer — speedChange', () => {
+    it('写倍速到 audio 并存 state', () => {
+        const { adapter, media } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        p.handleSpeedChange({ label: '2.0x', value: 2 });
+        expect(media.playbackRate).toBe(2);
+        expect(p.getState().playbackRate).toEqual({ label: '2.0x', value: 2 });
+    });
+});
+describe('createAudioPlayer — refresh 重播', () => {
+    it('无错误：仅 currentTime 归零，不自动播放、不改 isPlaying（对齐 Semi handleRefresh）', () => {
+        const { adapter, media, play } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        p.handleTimeChange(60);
+        p.handleRefresh();
+        expect(media.currentTime).toBe(0);
+        expect(p.getState().currentTime).toBe(0);
+        // 对齐 Semi：不播放、不改 isPlaying（初始 false）。
+        expect(p.getState().isPlaying).toBe(false);
+        expect(play).not.toHaveBeenCalled();
+    });
+    it('错误态：调 adapter.reload() 重载并清 isError（对齐 Semi handleRefresh error 分支）', () => {
+        const { adapter, media } = makeAdapter();
+        const reload = vi.fn();
+        // 补齐 reload（makeAdapter 可能未提供）。
+        const withReload = { ...adapter, reload };
+        const p = createAudioPlayer(withReload, { audioUrl: 'a.mp3' });
+        p.errorHandler();
+        expect(p.getState().isError).toBe(true);
+        p.handleRefresh();
+        expect(reload).toHaveBeenCalledTimes(1);
+        expect(p.getState().isError).toBe(false);
+        void media;
+    });
+});
+describe('createAudioPlayer — volumeChange 钳制', () => {
+    it('钳到 [0,100] 并写 audio（0–1）', () => {
+        const { adapter, media } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        p.handleVolumeChange(50);
+        expect(p.getState().volume).toBe(50);
+        expect(media.volume).toBe(0.5);
+        p.handleVolumeChange(150);
+        expect(p.getState().volume).toBe(100);
+        expect(media.volume).toBe(1);
+        p.handleVolumeChange(-20);
+        expect(p.getState().volume).toBe(0);
+        expect(media.volume).toBe(0);
+    });
+});
+describe('createAudioPlayer — endHandler（对齐 Semi）', () => {
+    it('多曲未到末曲：切下一曲', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: ['a.mp3', 'b.mp3'] });
+        p.endHandler();
+        expect(p.getState().currentTrackIndex).toBe(1);
+    });
+    it('单曲：停止播放', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        p.handleStatusClick();
+        p.endHandler();
+        expect(p.getState().isPlaying).toBe(false);
+    });
+    it('多曲末曲：ended 绕回首曲并续播（对齐 Semi 循环连播）', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: ['a.mp3', 'b.mp3'] });
+        p.handleTrackChange('next'); // → 末曲 index=1
+        expect(p.getState().currentTrackIndex).toBe(1);
+        p.endHandler(); // 末曲 ended → (1+1)%2=0 绕回首曲
+        expect(p.getState().currentTrackIndex).toBe(0);
+        // handleTrackChange 设 isPlaying=true（切曲自动播放，对齐 Semi resetAudioState）。
+        expect(p.getState().isPlaying).toBe(true);
+    });
+});
+describe('createAudioPlayer — errorHandler / initAudioState / subscribe', () => {
+    it('errorHandler 置 isError 并停播', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        p.errorHandler();
+        expect(p.getState().isError).toBe(true);
+        expect(p.getState().isPlaying).toBe(false);
+    });
+    it('initAudioState 从 audio 回读时长/音量/倍速', () => {
+        const { adapter } = makeAdapter({ getDuration: () => 200, getVolume: () => 0.8 });
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3', autoPlay: true });
+        p.initAudioState();
+        const s = p.getState();
+        expect(s.totalTime).toBe(200);
+        expect(s.volume).toBe(80);
+        expect(s.isPlaying).toBe(true);
+    });
+    it('subscribe 收到状态更新，取消后不再收到', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: 'a.mp3' });
+        const seen = [];
+        const unsub = p.subscribe((s) => seen.push(s.isPlaying));
+        p.handleStatusClick();
+        expect(seen).toEqual([true]);
+        unsub();
+        p.handleStatusClick();
+        expect(seen).toEqual([true]);
+    });
+});
+describe('createAudioPlayer — setAudioUrl 重置与 index 钳制', () => {
+    it('换更短列表时 index 钳到末尾', () => {
+        const { adapter } = makeAdapter();
+        const p = createAudioPlayer(adapter, { audioUrl: ['a.mp3', 'b.mp3', 'c.mp3'] });
+        p.handleTrackChange('next');
+        p.handleTrackChange('next'); // index=2
+        p.setAudioUrl(['x.mp3']);
+        expect(p.getState().currentTrackIndex).toBe(0);
+        expect(p.isMultiTrack()).toBe(false);
+        expect(p.getCurrentTrack()).toEqual({ src: 'x.mp3' });
+    });
+});
+//# sourceMappingURL=audio-player.test.js.map

package/dist/audio-player.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-player.test.js","sourceRoot":"","sources":["../src/audio-player.test.ts"],"names":[],"mappings":"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"}

package/dist/back-top.d.ts

@@ -6,7 +6,10 @@
  */
 /** easeInOutCubic — smooth acceleration then deceleration, t in [0,1] → [0,1]. */
 export declare function easeInOutCubic(t: number): number;
-/** true if the button should be visible given the current scroll position. */
+/**
+ * true if the button should be visible given the current scroll position.
+ * 对齐 Semi foundation：`scrollTop > visibilityHeight`（严格大于，边界处不显）。
+ */
 export declare function isAboveThreshold(scrollTop: number, visibilityHeight: number): boolean;
 /**
  * Interpolate the scroll position at elapsed `elapsed` ms of a `duration` ms

package/dist/back-top.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"back-top.d.ts","sourceRoot":"","sources":["../src/back-top.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAErF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIxF"}
+{"version":3,"file":"back-top.d.ts","sourceRoot":"","sources":["../src/back-top.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAErF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIxF"}

package/dist/back-top.js

@@ -12,9 +12,12 @@ export function easeInOutCubic(t) {
         return 1;
     return t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2;
 }
-/** true if the button should be visible given the current scroll position. */
+/**
+ * true if the button should be visible given the current scroll position.
+ * 对齐 Semi foundation：`scrollTop > visibilityHeight`（严格大于，边界处不显）。
+ */
 export function isAboveThreshold(scrollTop, visibilityHeight) {
-    return scrollTop >= visibilityHeight;
+    return scrollTop > visibilityHeight;
 }
 /**
  * Interpolate the scroll position at elapsed `elapsed` ms of a `duration` ms

package/dist/back-top.js.map

@@ -1 +1 @@
-{"version":3,"file":"back-top.js","sourceRoot":"","sources":["../src/back-top.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,gBAAwB;IAC1E,OAAO,SAAS,IAAI,gBAAgB,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAe,EAAE,QAAgB;IAC9E,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"back-top.js","sourceRoot":"","sources":["../src/back-top.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,gBAAwB;IAC1E,OAAO,SAAS,GAAG,gBAAgB,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAe,EAAE,QAAgB;IAC9E,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/back-top.test.js

@@ -18,9 +18,10 @@ describe('easeInOutCubic', () => {
     });
 });
 describe('isAboveThreshold', () => {
-    it('flips exactly at the threshold', () => {
+    // 对齐 Semi foundation：`scrollTop > visibilityHeight`（严格大于，边界处不显）。
+    it('flips just past the threshold (strict >, matches Semi)', () => {
         expect(isAboveThreshold(399, 400)).toBe(false);
-        expect(isAboveThreshold(400, 400)).toBe(true);
+        expect(isAboveThreshold(400, 400)).toBe(false);
         expect(isAboveThreshold(401, 400)).toBe(true);
     });
 });

package/dist/back-top.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"back-top.test.js","sourceRoot":"","sources":["../src/back-top.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"back-top.test.js","sourceRoot":"","sources":["../src/back-top.test.ts"],"names":[],"mappings":"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"}

package/dist/calendar.d.ts

@@ -1,63 +1,151 @@
 /**
- * createCalendar helpers — framework-agnostic month-view event grouping.
- * Pure functions only; reuses date.ts grid math. No DOM, no framework deps.
- * See specs/components/show/Calendar.spec.md §3 (month-view subset).
+ * Framework-agnostic Calendar event algorithms — aligned to Semi Design's
+ * `@douyinfe/semi-foundation/calendar/eventUtil` + `foundation`.
+ *
+ * Four view modes: day / week / month / range. Pure functions only; no DOM,
+ * no framework deps. The render layer (Calendar.svelte) supplies `children`
+ * for each event and turns the numeric positions here into inline styles.
+ *
+ * Semi event model: an EventObject carries a `key` (required, unique) and an
+ * optional `start` / `end` / `allDay`. Content is the render layer's business
+ * (Semi: `children`); this module never touches it beyond passing it through.
  */
 import { isSameDay } from './date.js';
 export type CalendarEventKey = string | number;
+/** Semi EventObject. `children` is opaque render content (any). */
 export interface CalendarEvent {
     key: CalendarEventKey;
-    /** event start (inclusive) */
-    start: Date;
-    /** event end (inclusive day for multi-day; same day as start if omitted) */
+    start?: Date;
     end?: Date;
-    title: string;
-    /** category accent color (any CSS color); render layer falls back to a token */
-    color?: string;
     allDay?: boolean;
-    disabled?: boolean;
+    /** opaque render content (Semi: children); render layer owns it */
+    children?: unknown;
+    [x: string]: unknown;
 }
-/** Events visible on one day plus an overflow count after capping. */
-export interface DayEvents {
-    /** events shown (already capped to `maxPerDay`) */
-    visible: CalendarEvent[];
-    /** total events on the day (including hidden) */
-    total: CalendarEvent[];
-    /** how many events are hidden beyond the cap (total - visible) */
-    overflow: number;
+export declare function addDaysLocal(d: Date, n: number): Date;
+export declare function addHoursLocal(d: Date, n: number): Date;
+export declare function endOfDay(d: Date): Date;
+export declare function startOfMonth(d: Date): Date;
+export declare function endOfMonth(d: Date): Date;
+export declare function startOfWeek(d: Date, weekStartsOn?: WeekStartsOn): Date;
+export declare function endOfWeek(d: Date, weekStartsOn?: WeekStartsOn): Date;
+export declare function isSameMonth(a: Date, b: Date): boolean;
+export declare function isSameWeek(a: Date, b: Date, weekStartsOn?: WeekStartsOn): boolean;
+/** whole calendar days b - a (positive when b is later) */
+export declare function differenceInCalendarDays(b: Date, a: Date): number;
+export declare function isBefore(a: Date, b: Date): boolean;
+export declare function isAfter(a: Date, b: Date): boolean;
+export declare function isWeekend(d: Date): boolean;
+/** ISO-ish week-of-month index (1-based) for a date, given weekStartsOn */
+export declare function getWeekOfMonth(date: Date, weekStartsOn?: WeekStartsOn): number;
+/** number of week rows the month spans, given weekStartsOn */
+export declare function getWeeksInMonth(date: Date, weekStartsOn?: WeekStartsOn): number;
+export type WeekStartsOn = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+export declare const round: (value: number) => number;
+/** fraction of the day [0,1) at which `value`'s clock time falls (Semi getPos) */
+export declare function getPos(value: Date): number;
+interface DatedEvent extends CalendarEvent {
+    /** the calendar day this (possibly split) copy belongs to */
+    date: Date;
 }
-/** true if `date` falls within [start, end] (inclusive, day granularity). */
-export declare function eventCoversDay(event: CalendarEvent, date: Date): boolean;
 /**
- * Group events onto a specific day, sorted by start time, capped at `maxPerDay`.
- * Multi-day events appear on every day they cover.
+ * Normalize a single event: if it has no start, default start = end - 1h (or
+ * start-of-day if that would cross a day boundary); symmetric for missing end.
+ * (Semi amendEvent)
  */
-export declare function eventsForDay(events: readonly CalendarEvent[], date: Date, maxPerDay?: number): DayEvents;
+export declare function amendEvent(event: CalendarEvent): CalendarEvent | undefined;
+/** split a spanned all-day event into one copy per covered day (Semi parseAllDayEvent) */
+export declare function parseAllDayEvent(event: CalendarEvent, allDay?: boolean, currDate?: Date): DatedEvent[];
 /**
- * Build a map (keyed by `YYYY-M-D`) of events-per-day for a set of cells,
- * so the render layer can look up each grid cell in O(1).
+ * Split an event into per-day copies (Semi parseEvent). Same-day timed events
+ * stay whole; timed events spanning < 24h split into a head (to end-of-day) and
+ * a tail (start-of-next-day); longer/all-day span into daily all-day copies.
  */
-export declare function groupEventsByDays(events: readonly CalendarEvent[], days: readonly Date[], maxPerDay?: number): Map<string, DayEvents>;
-/** stable per-day map key (local time) */
-export declare function dayKey(date: Date): string;
-/** true if `date` is strictly before today (day granularity) */
-export declare function isPastDay(date: Date, today: Date): boolean;
-/** Events laid out on a single day's hour timeline. */
-export interface DayTimeline {
-    /** all-day events + events that cover the day without a concrete hour (e.g. multi-day) */
-    allDay: CalendarEvent[];
-    /** map of hour (0..23) → timed events starting in that hour, sorted by start time */
-    byHour: Map<number, CalendarEvent[]>;
+export declare function parseEvent(event: CalendarEvent): DatedEvent[];
+/** split all events into all-day vs timed buckets (Semi _parseEvents) */
+export declare function parseEvents(events: readonly CalendarEvent[]): {
+    allDay: DatedEvent[];
+    day: DatedEvent[];
+};
+/** group dated events into a Map keyed by start-of-day string (Semi convertEventsArrToMap) */
+export declare function convertEventsArrToMap(arr: readonly DatedEvent[], key: 'start' | 'date', normalize: ((v: Date) => Date) | null): Map<string, DatedEvent[]>;
+/** a timed event positioned on a single day's [0,1] vertical axis */
+export interface PositionedDayEvent {
+    key: CalendarEventKey;
+    children: unknown;
+    /** fraction [0,1] where the event starts on the day */
+    startPos: number;
+    /** fraction [0,1] where the event ends on the day */
+    endPos: number;
+    /** horizontal offset for side-by-side overlaps, e.g. "50%" or 0 */
+    left: string | number;
+    allDay: boolean;
+}
+/** compute a timed event's startPos/endPos on its day (Semi renderDailyEvent) */
+export declare function renderDailyEvent(event: DatedEvent): {
+    startPos: number;
+    endPos: number;
+    children: unknown;
+    allDay: boolean;
+    key: CalendarEventKey;
+};
+/**
+ * Timed events for one calendar day, positioned and offset for overlaps
+ * (Semi getParseDailyEvents). Events sharing an identical [startPos,endPos]
+ * are laid out side-by-side via the `left` percentage.
+ */
+export declare function getDailyEvents(events: readonly DatedEvent[], date: Date): {
+    day: PositionedDayEvent[];
+    allDay: DatedEvent[];
+};
+/** a spanned all-day event positioned across the week/range top row */
+export interface PositionedSpanEvent {
+    key: CalendarEventKey;
+    children: unknown;
+    /** fraction [0,1] of the row width where the bar starts */
+    leftPos: number;
+    /** fraction (0,1] of the row width the bar occupies */
+    width: number;
+    /** vertical stacking row index (0-based) */
+    topInd: number;
+}
+/**
+ * Lay out all-day/spanned events across a date range (week or multi-day view).
+ * `rangeStart` inclusive, `rangeEnd` exclusive (Semi's left-closed-right-open).
+ */
+export declare function parseSpanEvents(allDayEvents: readonly DatedEvent[], rangeStart: Date, rangeEnd: Date): PositionedSpanEvent[];
+/** week-scoped span layout (Semi parseWeeklyAllDayEvents) */
+export declare function parseWeekSpanEvents(allDayEvents: readonly DatedEvent[], weekStart: Date, weekStartsOn?: WeekStartsOn): PositionedSpanEvent[];
+/** the all-day bucket (start-of-day keyed) for a set of events, for span layout */
+export declare function allDayEventMap(events: readonly CalendarEvent[]): DatedEvent[];
+/** number of stacking rows a span layout needs (Semi calcRowHeight) */
+export declare function calcRowHeight(events: readonly PositionedSpanEvent[]): number;
+/** one date cell descriptor for month/week header rendering */
+export interface DateObj {
+    ind: number;
+    date: Date;
+    dayString: string;
+    weekday: string;
+    isToday: boolean;
+    isWeekend: boolean;
+    isSameMonth?: boolean;
+}
+/**
+ * Month event layout: for each week row (0-based), the events laid out as a
+ * grid (day[]) plus a flat display list of positioned span bars, so the render
+ * layer can cap to N per cell and show "+remaining". (Semi getParseMonthlyEvents)
+ */
+export interface MonthWeekEvents {
+    /** display[col] → span events stacked in this week, by topInd */
+    display: PositionedSpanEvent[];
+    /** day[col][topInd] → event occupying that cell/row (for +N counting) */
+    day: (PositionedSpanEvent | DatedEvent | undefined)[][];
 }
 /**
- * Split a day's events into an all-day bucket and per-hour buckets for the
- * day timeline (`mode='day'`). An event is "timed" on `date` only when it
- * actually starts on that calendar day and is not flagged `allDay`; its hour
- * is clamped into [fromHour, toHour]. Everything else covering the day (all-day
- * flagged, or multi-day events whose start falls on another day) goes to
- * `allDay`. Pure: no DOM, no mutation of inputs.
+ * Lay out a month's events by week row (Semi getParseMonthlyEvents). Returns a
+ * map week-index → { day, display }. The render layer counts how many events a
+ * given day cell holds beyond `itemLimit` for the "+N" affordance.
  */
-export declare function timelineForDay(events: readonly CalendarEvent[], date: Date, fromHour?: number, toHour?: number): DayTimeline;
-/** re-export for convenience so the render layer imports calendar bits from one place */
+export declare function getMonthEvents(events: readonly CalendarEvent[], displayValue: Date, weekStartsOn?: WeekStartsOn): Record<number, MonthWeekEvents>;
 export { isSameDay };
 //# sourceMappingURL=calendar.d.ts.map

package/dist/calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../src/calendar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAc,MAAM,WAAW,CAAC;AAElD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,gBAAgB,CAAC;IACtB,8BAA8B;IAC9B,KAAK,EAAE,IAAI,CAAC;IACZ,4EAA4E;IAC5E,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,iDAAiD;IACjD,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAKxE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,IAAI,EAAE,IAAI,EACV,SAAS,SAAW,GACnB,SAAS,CAcX;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,IAAI,EAAE,SAAS,IAAI,EAAE,EACrB,SAAS,SAAW,GACnB,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAMxB;AAED,0CAA0C;AAC1C,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEzC;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAE1D;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,qFAAqF;IACrF,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,IAAI,EAAE,IAAI,EACV,QAAQ,SAAI,EACZ,MAAM,SAAK,GACV,WAAW,CA0Bb;AAED,yFAAyF;AACzF,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../src/calendar.ts"],"names":[],"mappings":"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"}