@tasknotes/calendar 0.1.6 → 0.1.8

package/dist/esm/index.js

@@ -7,7 +7,7 @@ import {
   TIMELINE_UNIT_DAYS,
   defaultOptions,
   localeFirstDay
-} from "./chunk-URE7QLU3.js";
+} from "./chunk-EXKFHPW2.js";
 import {
   DAY_MS,
   ItemStore,

package/dist/esm/react.js

@@ -1,6 +1,6 @@
 import {
   Calendar
-} from "./chunk-URE7QLU3.js";
+} from "./chunk-EXKFHPW2.js";
 import "./chunk-66A6EMCU.js";
 
 // src/react/index.tsx

package/dist/types/core/types.d.cts

@@ -25,6 +25,7 @@ export interface CalendarItem<D = unknown> {
     backgroundColor?: string;
     borderColor?: string;
     textColor?: string;
+    timeDisplay?: "start" | "range";
     className?: string | string[];
     /** Host-managed temporary placement: inert, mirror-styled and never hidden by event limits. */
     preview?: boolean;

package/dist/types/core/types.d.ts

@@ -25,6 +25,7 @@ export interface CalendarItem<D = unknown> {
     backgroundColor?: string;
     borderColor?: string;
     textColor?: string;
+    timeDisplay?: "start" | "range";
     className?: string | string[];
     /** Host-managed temporary placement: inert, mirror-styled and never hidden by event limits. */
     preview?: boolean;

package/dist/types/dom/calendar.d.cts

@@ -37,6 +37,11 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
         scroll: number;
     };
     draggingId: string | null;
+    private listDragPreview;
+    private dragSources;
+    private dragScrollFrame;
+    private readonly dragScrollOrigins;
+    private readonly itemWriteStates;
     dragRow: {
         id: string;
         rowId: string;
@@ -53,6 +58,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private session;
     private selection;
     private suppressClick;
+    private cancelledPointerId;
     private selectedIds;
     private popover;
     private timer;
@@ -136,7 +142,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     suppressNextClick(): void;
     dayArg(day: Day): DayArg;
     dayClasses(day: Day): string[];
-    isEditable(n: NormalizedItem<D>, what: "start" | "duration"): boolean;
+    isEditable(n: NormalizedItem<D>, what: "start" | "duration", presentation?: boolean): boolean;
     navLink(day: Day, label: Node | string, cls: string): HTMLElement;
     navigate(day: Day, jsEvent: MouseEvent | KeyboardEvent, view?: "day" | "month"): void;
     createItemEl(meta: ElMeta<D>): HTMLElement;
@@ -144,7 +150,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private selectedSet;
     private applySelected;
     destroyItemEl(el: HTMLElement): void;
-    openMore(day: Day, anchor: HTMLElement, jsEvent: MouseEvent | KeyboardEvent): void;
+    openMore(day: Day, anchor: HTMLElement, jsEvent: MouseEvent | KeyboardEvent, itemIds?: readonly string[]): void;
     private resolveText;
     private todayDay;
     private toDay;
@@ -170,6 +176,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     dateClick(day: Day, jsEvent: MouseEvent | KeyboardEvent): void;
     private createView;
     private renderToolbar;
+    private syncToolbarViewDisplay;
     private applyChange;
     /** Renders pending changes now. Called automatically on the next frame. */
     flush(): void;
@@ -184,6 +191,9 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private addHandles;
     /** Start and finish link handles (a milestone has one). */
     private addPorts;
+    private readonly onMoreGeometryChange;
+    private listenMoreGeometry;
+    private positionMore;
     private refreshMore;
     private closeMore;
     private bindEvents;
@@ -193,6 +203,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private readonly onDocPointerDown;
     private readonly onPointerDown;
     private activate;
+    private startDragScroll;
     private readonly onTouchMove;
     private readonly onPointerMove;
     private readonly onPointerUp;
@@ -200,6 +211,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private readonly onDocKeyDown;
     /** Proposal for the current pointer position. */
     private track;
+    private invalidateProposal;
     private trackExternal;
     private externalItem;
     private timelineSnap;
@@ -218,6 +230,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     /** Ends the current pointer session, committing unless `cancel`. */
     private endSession;
     private commit;
+    private applyItemWriteState;
     /** Runs in the capture phase so the click ending a drag never reaches content inside the calendar, React portals included. */
     private readonly onClickCapture;
     private readonly onClick;

package/dist/types/dom/calendar.d.ts

@@ -37,6 +37,11 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
         scroll: number;
     };
     draggingId: string | null;
+    private listDragPreview;
+    private dragSources;
+    private dragScrollFrame;
+    private readonly dragScrollOrigins;
+    private readonly itemWriteStates;
     dragRow: {
         id: string;
         rowId: string;
@@ -53,6 +58,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private session;
     private selection;
     private suppressClick;
+    private cancelledPointerId;
     private selectedIds;
     private popover;
     private timer;
@@ -136,7 +142,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     suppressNextClick(): void;
     dayArg(day: Day): DayArg;
     dayClasses(day: Day): string[];
-    isEditable(n: NormalizedItem<D>, what: "start" | "duration"): boolean;
+    isEditable(n: NormalizedItem<D>, what: "start" | "duration", presentation?: boolean): boolean;
     navLink(day: Day, label: Node | string, cls: string): HTMLElement;
     navigate(day: Day, jsEvent: MouseEvent | KeyboardEvent, view?: "day" | "month"): void;
     createItemEl(meta: ElMeta<D>): HTMLElement;
@@ -144,7 +150,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private selectedSet;
     private applySelected;
     destroyItemEl(el: HTMLElement): void;
-    openMore(day: Day, anchor: HTMLElement, jsEvent: MouseEvent | KeyboardEvent): void;
+    openMore(day: Day, anchor: HTMLElement, jsEvent: MouseEvent | KeyboardEvent, itemIds?: readonly string[]): void;
     private resolveText;
     private todayDay;
     private toDay;
@@ -170,6 +176,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     dateClick(day: Day, jsEvent: MouseEvent | KeyboardEvent): void;
     private createView;
     private renderToolbar;
+    private syncToolbarViewDisplay;
     private applyChange;
     /** Renders pending changes now. Called automatically on the next frame. */
     flush(): void;
@@ -184,6 +191,9 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private addHandles;
     /** Start and finish link handles (a milestone has one). */
     private addPorts;
+    private readonly onMoreGeometryChange;
+    private listenMoreGeometry;
+    private positionMore;
     private refreshMore;
     private closeMore;
     private bindEvents;
@@ -193,6 +203,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private readonly onDocPointerDown;
     private readonly onPointerDown;
     private activate;
+    private startDragScroll;
     private readonly onTouchMove;
     private readonly onPointerMove;
     private readonly onPointerUp;
@@ -200,6 +211,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     private readonly onDocKeyDown;
     /** Proposal for the current pointer position. */
     private track;
+    private invalidateProposal;
     private trackExternal;
     private externalItem;
     private timelineSnap;
@@ -218,6 +230,7 @@ export declare class Calendar<D = unknown> implements ViewContext<D> {
     /** Ends the current pointer session, committing unless `cancel`. */
     private endSession;
     private commit;
+    private applyItemWriteState;
     /** Runs in the capture phase so the click ending a drag never reaches content inside the calendar, React portals included. */
     private readonly onClickCapture;
     private readonly onClick;

package/dist/types/dom/context.d.cts

@@ -61,7 +61,7 @@ export interface ViewContext<D = unknown> {
     destroyItemEl(el: HTMLElement): void;
     /** Builds a nav link (day number / header) for a day. */
     navLink(day: Day, label: Node | string, cls: string): HTMLElement;
-    openMore(day: Day, anchor: HTMLElement, jsEvent: MouseEvent | KeyboardEvent): void;
+    openMore(day: Day, anchor: HTMLElement, jsEvent: MouseEvent | KeyboardEvent, itemIds?: readonly string[]): void;
     /** Follows a date link: `onNavLink`, or switches to `view` at `day`. */
     navigate(day: Day, jsEvent: MouseEvent | KeyboardEvent, view?: "day" | "month"): void;
     /** Swallows the click that follows a drag the view handled itself. */

package/dist/types/dom/context.d.ts

@@ -61,7 +61,7 @@ export interface ViewContext<D = unknown> {
     destroyItemEl(el: HTMLElement): void;
     /** Builds a nav link (day number / header) for a day. */
     navLink(day: Day, label: Node | string, cls: string): HTMLElement;
-    openMore(day: Day, anchor: HTMLElement, jsEvent: MouseEvent | KeyboardEvent): void;
+    openMore(day: Day, anchor: HTMLElement, jsEvent: MouseEvent | KeyboardEvent, itemIds?: readonly string[]): void;
     /** Follows a date link: `onNavLink`, or switches to `view` at `day`. */
     navigate(day: Day, jsEvent: MouseEvent | KeyboardEvent, view?: "day" | "month"): void;
     /** Swallows the click that follows a drag the view handled itself. */

package/dist/types/dom/options.d.cts

@@ -16,7 +16,7 @@ export interface ViewInfo {
     title: string;
     /**
      * The days whose items the calendar can show: `range`, extended to the
-     * end of the days a date strip is showing so their dots are right. Load
+     * full window of days a date strip is showing so their dots are right. Load
      * items for this range; `onRangeChange` fires when it changes too.
      */
     dataRange: DateRange;
@@ -258,6 +258,7 @@ export interface ToolbarButton {
 export interface ToolbarOptions {
     /** View buttons, in order. */
     views?: ViewType[];
+    viewDisplay?: "auto" | "buttons" | "select";
     extraButtons?: ToolbarButton[];
     /** Extra buttons go before prev/next ("start") or after the view buttons ("end"). */
     extraPlacement?: "start" | "end";
@@ -269,6 +270,7 @@ export interface CalendarText {
     allDay: string;
     noItems: string;
     more: (n: number) => string;
+    appointments: (n: number) => string;
     /** Day-cell label suffix in `monthDisplay: "dots"`. */
     itemCount: (n: number) => string;
     weekNumber: (n: number) => string;
@@ -319,6 +321,7 @@ export interface CalendarOptions<D = unknown> {
     }) => void;
     /** Agenda lists: an add row with this label under every day, reported through `onListAdd`. Null for none. */
     listAddText: string | null;
+    listEmptyContent?: () => Node;
     onListAdd?: (arg: DayArg & {
         jsEvent: MouseEvent | KeyboardEvent;
     }) => void;
@@ -329,7 +332,7 @@ export interface CalendarOptions<D = unknown> {
      * the tap target: dots ignore the pointer and are hidden from assistive
      * technology, and the cell is labelled with its item count.
      */
-    monthDisplay: "full" | "dots";
+    monthDisplay: "full" | "dots" | "chips";
     /** "local" or an IANA name. */
     timeZone: string;
     locale: string | undefined;

package/dist/types/dom/options.d.ts

@@ -16,7 +16,7 @@ export interface ViewInfo {
     title: string;
     /**
      * The days whose items the calendar can show: `range`, extended to the
-     * end of the days a date strip is showing so their dots are right. Load
+     * full window of days a date strip is showing so their dots are right. Load
      * items for this range; `onRangeChange` fires when it changes too.
      */
     dataRange: DateRange;
@@ -258,6 +258,7 @@ export interface ToolbarButton {
 export interface ToolbarOptions {
     /** View buttons, in order. */
     views?: ViewType[];
+    viewDisplay?: "auto" | "buttons" | "select";
     extraButtons?: ToolbarButton[];
     /** Extra buttons go before prev/next ("start") or after the view buttons ("end"). */
     extraPlacement?: "start" | "end";
@@ -269,6 +270,7 @@ export interface CalendarText {
     allDay: string;
     noItems: string;
     more: (n: number) => string;
+    appointments: (n: number) => string;
     /** Day-cell label suffix in `monthDisplay: "dots"`. */
     itemCount: (n: number) => string;
     weekNumber: (n: number) => string;
@@ -319,6 +321,7 @@ export interface CalendarOptions<D = unknown> {
     }) => void;
     /** Agenda lists: an add row with this label under every day, reported through `onListAdd`. Null for none. */
     listAddText: string | null;
+    listEmptyContent?: () => Node;
     onListAdd?: (arg: DayArg & {
         jsEvent: MouseEvent | KeyboardEvent;
     }) => void;
@@ -329,7 +332,7 @@ export interface CalendarOptions<D = unknown> {
      * the tap target: dots ignore the pointer and are hidden from assistive
      * technology, and the cell is labelled with its item count.
      */
-    monthDisplay: "full" | "dots";
+    monthDisplay: "full" | "dots" | "chips";
     /** "local" or an IANA name. */
     timeZone: string;
     locale: string | undefined;

package/dist/types/dom/views/daygrid.d.cts

@@ -13,7 +13,7 @@ export declare class DayGridView<D> implements View {
     private morePx;
     private topPx;
     private lastHeights;
-    private readonly dotsMode;
+    private dotsMode;
     constructor(ctx: ViewContext<D>);
     private daysPerWeek;
     private sizeKey;

package/dist/types/dom/views/daygrid.d.ts

@@ -13,7 +13,7 @@ export declare class DayGridView<D> implements View {
     private morePx;
     private topPx;
     private lastHeights;
-    private readonly dotsMode;
+    private dotsMode;
     constructor(ctx: ViewContext<D>);
     private daysPerWeek;
     private sizeKey;

package/dist/types/dom/views/timegrid.d.cts

@@ -1,3 +1,4 @@
+import { type Day } from "../../core/date.cjs";
 import type { StoreChange } from "../../core/store.cjs";
 import { type Selection, type View, type ViewContext } from "../context.cjs";
 import type { Hit } from "../options.cjs";
@@ -6,6 +7,7 @@ export declare class TimeGridView<D> implements View {
     private readonly ctx;
     readonly el: HTMLElement;
     private readonly scroller;
+    private readonly dayNavigation;
     private readonly top;
     private readonly headRow;
     private readonly allDayRow;
@@ -40,6 +42,8 @@ export declare class TimeGridView<D> implements View {
     hit(x: number, y: number): Hit | null;
     tick(): void;
     resize(): void;
+    revealDay(day: Day): void;
+    private updateDayNavigation;
     scrollToTime(minute: number): void;
     getScroll(): {
         top: number;

package/dist/types/dom/views/timegrid.d.ts

@@ -1,3 +1,4 @@
+import { type Day } from "../../core/date.js";
 import type { StoreChange } from "../../core/store.js";
 import { type Selection, type View, type ViewContext } from "../context.js";
 import type { Hit } from "../options.js";
@@ -6,6 +7,7 @@ export declare class TimeGridView<D> implements View {
     private readonly ctx;
     readonly el: HTMLElement;
     private readonly scroller;
+    private readonly dayNavigation;
     private readonly top;
     private readonly headRow;
     private readonly allDayRow;
@@ -40,6 +42,8 @@ export declare class TimeGridView<D> implements View {
     hit(x: number, y: number): Hit | null;
     tick(): void;
     resize(): void;
+    revealDay(day: Day): void;
+    private updateDayNavigation;
     scrollToTime(minute: number): void;
     getScroll(): {
         top: number;

package/dist/types/dom/views/year.d.cts

@@ -21,6 +21,7 @@ export declare class YearView<D> implements View {
         top: number;
         left: number;
     }): void;
+    revealDay(day: Day): void;
     elementsFor(_id: string): HTMLElement[];
     destroy(): void;
 }

package/dist/types/dom/views/year.d.ts

@@ -21,6 +21,7 @@ export declare class YearView<D> implements View {
         top: number;
         left: number;
     }): void;
+    revealDay(day: Day): void;
     elementsFor(_id: string): HTMLElement[];
     destroy(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tasknotes/calendar",
-	"version": "0.1.6",
+	"version": "0.1.8",
 	"description": "Task-native calendar engine for TaskNotes: incremental layout, time grid, month, list, year and timeline views.",
 	"license": "MIT",
 	"type": "module",