@zeyos/zx 4.3.0 → 4.3.4

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

@@ -73,10 +73,15 @@ export declare class Component<TOptions extends ComponentOptions = ComponentOpti
      * Dispatches a component event and a bubbling, composed `zx-*` DOM event.
      * @param {string} type Lowercase event name.
      * @param {Record<string, unknown>} [detail={}] Single event detail object.
+     * @param {{honorDomCancellation?:boolean}} [options={}] Mirrored DOM-event behavior. Components
+     * with a cancelable mutation boundary may opt into treating `preventDefault()` on the bubbling
+     * `zx-*` event exactly like cancellation of the component event.
      * @returns {Event & {detail: Record<string, unknown>}}
      * @fires Component#event
      */
-    emit(type: string, detail?: Record<string, unknown>): Event & {
+    emit(type: string, detail?: Record<string, unknown>, options?: {
+        honorDomCancellation?: boolean;
+    }): Event & {
         detail: Record<string, unknown>;
     };
     /**

package/dist/types/index.d.ts

@@ -78,12 +78,13 @@ export { DateRangePicker, clampRange, defaultDateRangePresets, normalizeRange, r
 export { DateRangeBox, formatRangeText, parseRangeText } from './components/datebox/date-range-box.js';
 export { Timebox, splitTime, joinTime } from './components/timebox/timebox.js';
 export { Calendar } from './components/calendar/calendar.js';
-export { CALENDAR_VIEWS, addCalendarDays, calendarDayDifference, calendarDayKey, calendarEventIntersects, calendarEventSpansDays, calendarRange, cloneCalendarEvent, layoutCalendarSpans, layoutTimedCalendarEvents, normalizeCalendarEvents, shiftCalendarEvent, startOfCalendarDay, startOfCalendarWeek } from './components/calendar/calendar-model.js';
+export { CALENDAR_VIEWS, addCalendarDays, addCalendarMonths, calendarDayDifference, calendarDayKey, calendarEventIntersects, calendarEventSpansDays, calendarPageDate, calendarRange, cloneCalendarEvent, layoutCalendarSpans, layoutTimedCalendarEvents, normalizeCalendarEvents, shiftCalendarEvent, startOfCalendarDay, startOfCalendarWeek } from './components/calendar/calendar-model.js';
 export { RecordView, normalizeViewFields, reconcileFieldOrder, moveViewField, readViewField, renderViewField, sortViewRecords, normalizeViewState, viewRecordId } from './components/view/record-view.js';
 export { Table, reorderTableRows } from './components/table/table.js';
 export { TableView } from './components/table-view/table-view.js';
 export { CardView } from './components/card-view/card-view.js';
 export { KanbanView } from './components/kanban-view/kanban-view.js';
+export { absoluteKanbanIndex, allowsKanbanTransition, createKanbanHistory, evaluateKanbanMove, kanbanSearchTerms, locateKanbanRecord, matchesKanbanSearch, normalizeKanbanRules, reorderKanbanRecords, resolveKanbanRules } from './components/kanban-view/kanban-policy.js';
 export { Grid, billingColumns, isBillingLine } from './components/grid/grid.js';
 export { Chart, ChartJsAdapter, chartSummaryTable, cloneChartValue, isEmptyChartData } from './components/chart/chart.js';
 export { TreeView } from './components/tree/tree.js';

package/dist/zx-zeyos.esm.js

@@ -870,21 +870,26 @@ var Component = class extends EventTarget {
    * Dispatches a component event and a bubbling, composed `zx-*` DOM event.
    * @param {string} type Lowercase event name.
    * @param {Record<string, unknown>} [detail={}] Single event detail object.
+   * @param {{honorDomCancellation?:boolean}} [options={}] Mirrored DOM-event behavior. Components
+   * with a cancelable mutation boundary may opt into treating `preventDefault()` on the bubbling
+   * `zx-*` event exactly like cancellation of the component event.
    * @returns {Event & {detail: Record<string, unknown>}}
    * @fires Component#event
    */
-  emit(type, detail = {}) {
+  emit(type, detail = {}, options = {}) {
     if (detail === null || typeof detail !== "object" || Array.isArray(detail)) {
       throw new TypeError("Event detail must be an object");
     }
     const componentEvent = createCustomEvent(type, detail, { cancelable: true });
     this.dispatchEvent(componentEvent);
     if (this.el) {
-      this.el.dispatchEvent(createCustomEvent(`zx-${type}`, detail, {
+      const domEvent = createCustomEvent(`zx-${type}`, detail, {
         bubbles: true,
         composed: true,
         cancelable: true
-      }));
+      });
+      this.el.dispatchEvent(domEvent);
+      if (options.honorDomCancellation && domEvent.defaultPrevented) componentEvent.preventDefault();
     }
     return componentEvent;
   }
@@ -13132,6 +13137,29 @@ function calendarRange(view, anchor, options = {}) {
   }
   return { start, end };
 }
+function calendarPageDate(view, anchor, direction, options = {}) {
+  const date = validDate5(anchor, "Calendar date");
+  const step = integer(direction, "direction");
+  if (view === "day") date.setDate(date.getDate() + step);
+  else if (view === "agenda") {
+    date.setDate(date.getDate() + step * positiveInteger(options.agendaDays ?? 14, "agendaDays"));
+  } else if (view === "week") date.setDate(date.getDate() + step * 7);
+  else if (view === "month") return addCalendarMonths(date, step);
+  else if (view === "year") return addCalendarMonths(date, step * 12);
+  else throw new RangeError(`Unknown calendar view: ${view}`);
+  return date;
+}
+function addCalendarMonths(value, months) {
+  const date = validDate5(value, "Calendar date");
+  const day = date.getDate();
+  date.setDate(1);
+  date.setMonth(date.getMonth() + integer(months, "month amount"));
+  date.setDate(Math.min(day, daysInCalendarMonth(date.getFullYear(), date.getMonth())));
+  return date;
+}
+function daysInCalendarMonth(year, month) {
+  return new Date(year, month + 1, 0).getDate();
+}
 function normalizeCalendarEvents(records, options = {}) {
   if (!Array.isArray(records)) throw new TypeError("Calendar events must be an array");
   const readers = {
@@ -13575,7 +13603,7 @@ var Calendar = class extends Component {
       durationEditable: Object.prototype.hasOwnProperty.call(changes, "durationEditable") ? changes.durationEditable : current.durationEditable,
       data: changes.data ?? current.data
     };
-    const [next] = normalizeCalendarEvents([source]);
+    const [next] = normalizeCalendarEvents([source], { dateUnit: this.options.dateUnit });
     next.data = source.data;
     this._events = this._events.map((event, eventIndex) => eventIndex === index ? next : event);
     this._mutationVersions.delete(String(id));
@@ -14601,13 +14629,9 @@ var Calendar = class extends Component {
   }
   /** @param {number} direction @returns {this} */
   _page(direction) {
-    const date = new Date(this._date.getTime());
-    if (this._view === "day") date.setDate(date.getDate() + direction);
-    else if (this._view === "agenda") date.setDate(date.getDate() + direction * this.options.agendaDays);
-    else if (this._view === "week") date.setDate(date.getDate() + direction * 7);
-    else if (this._view === "month") date.setMonth(date.getMonth() + direction);
-    else date.setFullYear(date.getFullYear() + direction);
-    return this.setDate(date);
+    return this.setDate(calendarPageDate(this._view, this._date, direction, {
+      agendaDays: this.options.agendaDays
+    }));
   }
   /** @param {{start: Date, end: Date}} range @returns {string} */
   _rangeTitle(range) {