@cocoar/vue-calendar 3.1.0 → 3.2.0-beta.6

package/dist/core/rangeLabel.d.ts

@@ -0,0 +1,14 @@
+import { Temporal } from '@js-temporal/polyfill';
+import { FormatOverrides } from './temporal';
+import { CalendarView, ViewWindow } from './types';
+export interface RangeLabelOptions extends FormatOverrides {
+    view: CalendarView;
+    /** The rendered window — `[start, end)` as ISO dates in the display zone. */
+    window: ViewWindow;
+    /** The builder's cursor date (day / month / year labels are cursor-based). */
+    cursor: Temporal.PlainDate;
+    locale: string;
+}
+/** Format the label for `view` over `window`, respecting the C6 format overrides. */
+export declare function formatRangeLabel(opts: RangeLabelOptions): string;
+//# sourceMappingURL=rangeLabel.d.ts.map

package/dist/core/rangeLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rangeLabel.d.ts","sourceRoot":"","sources":["../../src/core/rangeLabel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,IAAI,EAAE,YAAY,CAAC;IACnB,6EAA6E;IAC7E,MAAM,EAAE,UAAU,CAAC;IACnB,8EAA8E;IAC9E,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAqBD,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAwChE"}

package/dist/core/timeGridRange.d.ts

@@ -0,0 +1,50 @@
+import { Temporal } from '@js-temporal/polyfill';
+import { DayOfWeek } from './temporal';
+export type TimeGridAnchor = 'cursor' | 'weekStart';
+export type TimeGridFilter = 'all' | 'workDays';
+/** The three views that render on the time grid. */
+export type TimeGridView = 'day' | 'week' | 'workWeek';
+export interface TimeGridRangeSpec {
+    anchor: TimeGridAnchor;
+    /** Days from the anchor (≥ 1), or as many complete columns as fit. */
+    span: number | 'responsive';
+    filter: TimeGridFilter;
+    /** Days per page turn (≥ 1), or `'span'` = as many as are shown. */
+    step: number | 'span';
+}
+export declare const TIME_GRID_PRESETS: Readonly<Record<'daySingle' | 'dayMulti' | 'week' | 'workWeek', TimeGridRangeSpec>>;
+/**
+ * The spec a view renders with. `week` / `workWeek` are fixed presets
+ * by definition; `day` honours an explicit `builder.timeGridRange(...)`
+ * and otherwise follows `dayMode`.
+ */
+export declare function timeGridRangeSpecFor(view: TimeGridView, options?: {
+    dayMode?: 'single' | 'multiDay';
+    explicit?: TimeGridRangeSpec | null;
+}): TimeGridRangeSpec;
+export interface ResolveTimeGridRangeOptions {
+    spec: TimeGridRangeSpec;
+    cursor: Temporal.PlainDate;
+    /** 0 = Sun … 6 = Sat. Only read for the `weekStart` anchor. */
+    firstDayOfWeek: DayOfWeek;
+    /** Only read for the `workDays` filter. */
+    workDays: readonly DayOfWeek[];
+    /** The measured column count for a `'responsive'` span (≥ 1). */
+    responsiveColumns: number;
+}
+export interface TimeGridRange {
+    /** First day of the (unfiltered) span — the loader window's start. */
+    start: Temporal.PlainDate;
+    /** Length of the unfiltered span in days — the loader window's length. */
+    spanDays: number;
+    /** The dates actually rendered as columns, in order. */
+    days: Temporal.PlainDate[];
+    /** Days `next` / `prev` move the cursor. */
+    stepDays: number;
+}
+export declare function resolveTimeGridRange(opts: ResolveTimeGridRangeOptions): TimeGridRange;
+/** The unfiltered span length for `spec` given the measured column count. */
+export declare function resolveSpanDays(spec: TimeGridRangeSpec, responsiveColumns: number): number;
+/** Days one page turn moves for `spec` whose span resolved to `spanDays`. */
+export declare function timeGridStepDays(spec: TimeGridRangeSpec, spanDays: number): number;
+//# sourceMappingURL=timeGridRange.d.ts.map

package/dist/core/timeGridRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeGridRange.d.ts","sourceRoot":"","sources":["../../src/core/timeGridRange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,KAAK,SAAS,EAAyC,MAAM,YAAY,CAAC;AAEnF,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,UAAU,CAAC;AAChD,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,sEAAsE;IACtE,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,oEAAoE;IACpE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CACtC,MAAM,CAAC,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,EAAE,iBAAiB,CAAC,CAM1E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAO,GACrF,iBAAiB,CAKnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC3B,+DAA+D;IAC/D,cAAc,EAAE,SAAS,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IAC/B,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,2BAA2B,GAAG,aAAa,CAUrF;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAG1F;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlF"}

package/dist/core/timedCardAnatomy.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Timed-card anatomy — what the built-in Day / Week card shows, given
+ * how much of it is actually unobscured (iOS 4.0 parity).
+ *
+ * Overlapping cards form a content-aware cascade; a front card may
+ * cover most of the card behind it. When an overlapped card's width
+ * that stays visible falls below `detailMinWidth` (iOS
+ * `timedEventDetailMinimumWidth`, 112 pt), it switches to a
+ * **compact** anatomy: one end-truncated title line, no location row,
+ * no time row. Every card stays a separate tappable, draggable target.
+ * A card alone in its column is never compacted — a narrow column
+ * ellipsizes its rows instead. `detailMinWidth` of `0` disables the
+ * switch.
+ *
+ * The full anatomy grows with the card's height, using the same
+ * duration thresholds the cascade budgets for its content block:
+ * location from 34 minutes, time row from 52, a second title line
+ * from 70 (at the default 60 px per hour).
+ *
+ * Pure: no DOM, no Vue.
+ */
+export interface TimedCardAnatomy {
+    /** Compact policy engaged: one title line, nothing else. */
+    compact: boolean;
+    /** Title lines the card may use (clamped with an ellipsis). */
+    titleLines: 1 | 2;
+    showLocation: boolean;
+    showTime: boolean;
+}
+export interface TimedCardAnatomyInput {
+    /** Visible duration of the card in minutes. */
+    durationMinutes: number;
+    /**
+     * Width that stays unobscured by cards in front, in pixels. `null`
+     * when the column hasn't been measured yet (never compact then).
+     */
+    visibleWidthPx: number | null;
+    /** iOS `timedEventDetailMinimumWidth`; `0` disables the compact switch. */
+    detailMinWidth: number;
+    /** The card shares its time with others (cascade lanes > 1). */
+    overlapped: boolean;
+    hasLocation: boolean;
+}
+export declare const DEFAULT_TIMED_EVENT_DETAIL_MIN_WIDTH = 112;
+export declare const COMPACT_TIMED_CARD: TimedCardAnatomy;
+export declare function resolveTimedCardAnatomy(input: TimedCardAnatomyInput): TimedCardAnatomy;
+//# sourceMappingURL=timedCardAnatomy.d.ts.map

package/dist/core/timedCardAnatomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timedCardAnatomy.d.ts","sourceRoot":"","sources":["../../src/core/timedCardAnatomy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,oCAAoC,MAAM,CAAC;AAExD,eAAO,MAAM,kBAAkB,EAAE,gBAK/B,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,CAgBtF"}

package/dist/core/viewWindow.d.ts

@@ -1,6 +1,7 @@
 import { Temporal } from '@js-temporal/polyfill';
 import { DayOfWeek } from './temporal';
 import { CalendarView, ViewWindow } from './types';
+import { TimeGridRangeSpec } from './timeGridRange';
 /** Default `workDays` — Mon–Fri using the 0=Sun..6=Sat convention. */
 export declare const DEFAULT_WORK_DAYS: readonly DayOfWeek[];
 export interface ViewWindowOptions {
@@ -20,10 +21,17 @@ export interface ViewWindowOptions {
      */
     timelineRangeDays?: number;
     /**
-     * Number of adjacent columns rendered by the day view. Default 1.
-     * Ignored for non-day views.
+     * Resolved column count for a `'responsive'` time-grid span (the
+     * day view measures its container). Default 1. Ignored by views
+     * whose spec has a fixed span.
      */
     dayColumnCount?: number;
+    /**
+     * Explicit time-grid range spec for the `day` view
+     * (`builder.timeGridRange(...)`). `week` / `workWeek` are fixed
+     * presets and ignore it. Without it the day view is one column.
+     */
+    timeGridRange?: TimeGridRangeSpec | null;
     /** Adjacent calendar months loaded around the cursor for the continuous month surface. */
     monthBuffer?: number;
     /**
@@ -56,11 +64,16 @@ export declare function windowContainsDate(window: ViewWindow, date: Temporal.Pl
 /**
  * Navigate forward / backward by one logical "page" in the view.
  *
- * - day: ±1 day
- * - week: ±7 days
+ * - day: ± the rendered column count (the time-grid preset's step)
+ * - week / workWeek: ±7 days
  * - month: ±1 month (from the cursor's calendar month)
  * - agenda: ± agendaLengthDays
  *
+ * The builder resolves the time-grid views through
+ * `timeGridStepDays(spec, spanDays)` so an explicit
+ * `builder.timeGridRange(...)` step applies; this function keeps the
+ * preset semantics for direct callers.
+ *
  * Returns the new cursor for the next computeViewWindow call.
  */
 export declare function navigateCursor(view: CalendarView, cursor: Temporal.PlainDate, direction: 'prev' | 'next', agendaLengthDays?: number, timelineRangeDays?: number, dayColumnCount?: number): Temporal.PlainDate;

package/dist/core/viewWindow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewWindow.d.ts","sourceRoot":"","sources":["../../src/core/viewWindow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,YAAY,CAAC;AAEzE,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,uDAAuD;IACvD,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC3B,oEAAoE;IACpE,cAAc,EAAE,SAAS,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CA8GrE;AAID;;;;GAIG;AACH,wBAAiB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAO/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,GAAG,OAAO,CAIxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,QAAQ,CAAC,SAAS,EAC1B,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,gBAAgB,SAAK,EACrB,iBAAiB,SAAK,EACtB,cAAc,SAAI,GACjB,QAAQ,CAAC,SAAS,CA4BpB"}
+{"version":3,"file":"viewWindow.d.ts","sourceRoot":"","sources":["../../src/core/viewWindow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,YAAY,CAAC;AAEzE,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAE,SAAS,SAAS,EAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,uDAAuD;IACvD,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC3B,oEAAoE;IACpE,cAAc,EAAE,SAAS,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzC,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CA0GrE;AAID;;;;GAIG;AACH,wBAAiB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAO/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,GAAG,OAAO,CAIxF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,QAAQ,CAAC,SAAS,EAC1B,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,gBAAgB,SAAK,EACrB,iBAAiB,SAAK,EACtB,cAAc,SAAI,GACjB,QAAQ,CAAC,SAAS,CA4BpB"}