myio-js-library 0.1.498 → 0.1.499

package/dist/index.cjs

@@ -1162,7 +1162,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "myio-js-library",
-  version: "0.1.498",
+  version: "0.1.499",
   description: "A clean, standalone JS SDK for MYIO projects",
   license: "MIT",
   repository: "github:gh-myio/myio-js-library",
@@ -5548,7 +5548,7 @@ var MyIOSelectionStoreClass = class _MyIOSelectionStoreClass {
     if (_MyIOSelectionStoreClass.GlobalDebug) {
       console.trace("[SelectionStore] Constructor called from:");
     }
-    this.MAX_SELECTION = 6;
+    this.MAX_SELECTION = 20;
     this.state = { selectedDevice: null };
     this.selectedIds = /* @__PURE__ */ new Set();
     this.entities = /* @__PURE__ */ new Map();
@@ -5633,6 +5633,45 @@ var MyIOSelectionStoreClass = class _MyIOSelectionStoreClass {
     this._emitSelectionChange("clear");
     this._trackEvent("footer_dock.clear_all", { count: 0 });
   }
+  /**
+   * Updates the maximum number of concurrent selections at runtime.
+   * Typically called once from MAIN_VIEW onInit with the value from widget
+   * settings so operators can configure it per-customer without code changes.
+   *
+   * If the current selection already exceeds the new limit, keeps the first N
+   * in insertion order, drops the rest, and emits `selection:change` plus
+   * `selection:limit-reached` so any UI reflects the truncation.
+   *
+   * @param {number} n - new maximum (integer ≥ 1)
+   */
+  setMaxSelection(n) {
+    const v = Math.floor(Number(n));
+    if (!Number.isFinite(v) || v < 1) {
+      this._log("warn", `[MyIOSelectionStoreClass] Invalid maxSelection, ignoring:`, n);
+      return;
+    }
+    if (v === this.MAX_SELECTION) return;
+    const prev = this.MAX_SELECTION;
+    this.MAX_SELECTION = v;
+    this._log("log", `[MyIOSelectionStoreClass] MAX_SELECTION ${prev} \u2192 ${v}`);
+    if (this.selectedIds.size > v) {
+      const kept = Array.from(this.selectedIds).slice(0, v);
+      this.selectedIds = new Set(kept);
+      this._emitSelectionChange("truncate");
+      this._emit("selection:limit-reached", {
+        maxAllowed: v,
+        currentCount: this.selectedIds.size,
+        truncated: true
+      });
+    }
+  }
+  /**
+   * Returns the currently active selection limit.
+   * @returns {number}
+   */
+  getMaxSelection() {
+    return this.MAX_SELECTION;
+  }
   syncFromCheckbox(id, checked) {
     if (typeof id !== "string" || typeof checked !== "boolean") return;
     if (checked && !this.isSelected(id)) {
@@ -30587,27 +30626,36 @@ var EnergyModalView = class {
   }
   /**
    * (Re)builds the DateRangePicker. Time picker only shown when granularity = '1h'.
-   * Preserves the currently selected range when rebuilding after a granularity change.
+   *
+   * Preserves only the DATE portion of the previous range — times are always
+   * reset to 00:00:00 (start) / 23:59:59 (end) on every rebuild, so toggling
+   * the granularity tab reliably brings back the full-day default. In 1h
+   * mode the user can then adjust hours/minutes freely; switching back to
+   * 1d wipes any custom time and restores the full-day boundaries.
    */
   async rebuildDateRangePicker(input) {
-    let presetStart;
-    let presetEnd;
+    const toYmd = (v) => {
+      if (!v) return void 0;
+      if (v instanceof Date) return v.toISOString().split("T")[0];
+      if (typeof v === "string") return v.split("T")[0];
+      return void 0;
+    };
+    let startYmd;
+    let endYmd;
     if (this.dateRangePicker) {
       try {
         const current = this.dateRangePicker.getDates();
-        presetStart = current.startISO;
-        presetEnd = current.endISO;
+        startYmd = toYmd(current.startISO);
+        endYmd = toYmd(current.endISO);
       } catch {
       }
       this.dateRangePicker.destroy();
       this.dateRangePicker = null;
     }
-    if (!presetStart) {
-      presetStart = this.config.params.startDate instanceof Date ? this.config.params.startDate.toISOString().split("T")[0] : this.config.params.startDate;
-    }
-    if (!presetEnd) {
-      presetEnd = this.config.params.endDate instanceof Date ? this.config.params.endDate.toISOString().split("T")[0] : this.config.params.endDate;
-    }
+    if (!startYmd) startYmd = toYmd(this.config.params.startDate);
+    if (!endYmd) endYmd = toYmd(this.config.params.endDate);
+    const presetStart = startYmd ? `${startYmd}T00:00:00-03:00` : void 0;
+    const presetEnd = endYmd ? `${endYmd}T23:59:59-03:00` : void 0;
     try {
       this.dateRangePicker = await attach(input, {
         presetStart,
@@ -31631,20 +31679,28 @@ var DeviceReportModal = class {
    * Preserves the currently selected range when rebuilding after a granularity change.
    */
   async rebuildDateRangePicker(input) {
-    let presetStart;
-    let presetEnd;
+    const toYmd = (v) => {
+      if (!v) return void 0;
+      if (v instanceof Date) return v.toISOString().split("T")[0];
+      if (typeof v === "string") return v.split("T")[0];
+      return void 0;
+    };
+    let startYmd;
+    let endYmd;
     if (this.dateRangePicker) {
       try {
         const current = this.dateRangePicker.getDates();
-        presetStart = current.startISO;
-        presetEnd = current.endISO;
+        startYmd = toYmd(current.startISO);
+        endYmd = toYmd(current.endISO);
       } catch {
       }
       this.dateRangePicker.destroy();
       this.dateRangePicker = null;
     }
-    if (!presetStart) presetStart = this.getDefaultStartDate();
-    if (!presetEnd) presetEnd = this.getDefaultEndDate();
+    if (!startYmd) startYmd = toYmd(this.getDefaultStartDate());
+    if (!endYmd) endYmd = toYmd(this.getDefaultEndDate());
+    const presetStart = startYmd ? `${startYmd}T00:00:00-03:00` : void 0;
+    const presetEnd = endYmd ? `${endYmd}T23:59:59-03:00` : void 0;
     try {
       this.dateRangePicker = await attach(input, {
         presetStart,
@@ -41746,7 +41802,7 @@ var DEFAULT_CONFIG_TEMPLATE2 = {
   emptyMessage: "Selecione dispositivos para comparar",
   compareButtonLabel: "Comparar",
   clearButtonLabel: "Limpar",
-  maxSelections: 6,
+  maxSelections: 20,
   darkMode: DEFAULT_DARK_THEME2,
   lightMode: DEFAULT_LIGHT_THEME2
 };
@@ -43962,9 +44018,28 @@ var InternalSelectionStore = class {
   entities = /* @__PURE__ */ new Map();
   listeners = /* @__PURE__ */ new Map();
   maxSelections;
-  constructor(maxSelections = 6) {
+  constructor(maxSelections = DEFAULT_CONFIG_TEMPLATE2.maxSelections ?? 20) {
     this.maxSelections = maxSelections;
   }
+  /**
+   * Updates the maximum selection limit at runtime.
+   * If the current selection exceeds the new limit, trims the oldest
+   * entries (insertion order) and emits `selection:change`.
+   */
+  setMaxSelections(n) {
+    const v = Math.floor(Number(n));
+    if (!Number.isFinite(v) || v < 1) return;
+    this.maxSelections = v;
+    if (this.entities.size > v) {
+      const kept = Array.from(this.entities.entries()).slice(0, v);
+      this.entities = new Map(kept);
+      this.emit("selection:change", this.getSelectedEntities());
+      this.emit("selection:limit-reached", v);
+    }
+  }
+  getMaxSelections() {
+    return this.maxSelections;
+  }
   on(event, handler) {
     if (!this.listeners.has(event)) {
       this.listeners.set(event, []);
@@ -44017,7 +44092,7 @@ var FooterController = class {
   constructor(params, view) {
     this.params = params;
     this.view = view;
-    this.maxSelections = params.maxSelections ?? 6;
+    this.maxSelections = params.maxSelections ?? params.configTemplate?.maxSelections ?? DEFAULT_CONFIG_TEMPLATE2.maxSelections ?? 20;
     this.log = createLogger2(params.debug ?? false);
     if (params.colors) {
       setAlertColors(params.colors);
@@ -44361,6 +44436,38 @@ var FooterController = class {
   hideAlert() {
     hideAlert();
   }
+  /**
+   * Updates the maximum selection limit at runtime. If the footer is using
+   * an InternalSelectionStore, the store's limit is updated too; external
+   * stores are left untouched (they own their own limit).
+   *
+   * If the current selection exceeds the new limit, the underlying store
+   * will emit `selection:limit-reached` (and may truncate), and the view
+   * re-renders via the existing selection:change handler.
+   */
+  setMaxSelections(n) {
+    const v = Math.floor(Number(n));
+    if (!Number.isFinite(v) || v < 1) {
+      this.log.warn("setMaxSelections: invalid value, ignoring:", n);
+      return;
+    }
+    this.maxSelections = v;
+    if (this.store instanceof InternalSelectionStore) {
+      this.store.setMaxSelections(v);
+    } else {
+      this.log.log(
+        "setMaxSelections: external store detected \u2014 controller limit updated to",
+        v,
+        "but external store limit is not managed here. Call its own setter if supported."
+      );
+    }
+  }
+  /**
+   * Returns the maximum selection limit currently enforced by the controller.
+   */
+  getMaxSelections() {
+    return this.maxSelections;
+  }
   /**
    * Cleanup resources
    */
@@ -44396,6 +44503,8 @@ function createFooterComponent(params) {
     clearSelection: () => controller.clearSelection(),
     getSelectedEntities: () => controller.getSelectedEntities(),
     getSelectionCount: () => controller.getSelectionCount(),
+    setMaxSelections: (n) => controller.setMaxSelections(n),
+    getMaxSelections: () => controller.getMaxSelections(),
     // State methods
     getCurrentUnitType: () => controller.getCurrentUnitType(),
     setDateRange: (start, end) => controller.setDateRange(start, end),

package/dist/index.d.cts

@@ -3090,6 +3090,23 @@ declare class MyIOSelectionStoreClass {
     remove(id: any): void;
     toggle(id: any): void;
     clear(): void;
+    /**
+     * Updates the maximum number of concurrent selections at runtime.
+     * Typically called once from MAIN_VIEW onInit with the value from widget
+     * settings so operators can configure it per-customer without code changes.
+     *
+     * If the current selection already exceeds the new limit, keeps the first N
+     * in insertion order, drops the rest, and emits `selection:change` plus
+     * `selection:limit-reached` so any UI reflects the truncation.
+     *
+     * @param {number} n - new maximum (integer ≥ 1)
+     */
+    setMaxSelection(n: number): void;
+    /**
+     * Returns the currently active selection limit.
+     * @returns {number}
+     */
+    getMaxSelection(): number;
     syncFromCheckbox(id: any, checked: any): void;
     registerEntity(entity: any): void;
     unregisterEntity(id: any): void;
@@ -5499,6 +5516,10 @@ interface SelectionStore {
     clear: () => void;
     getSelectedEntities: () => SelectedEntity[];
     getSelectionCount: () => number;
+    /** Optional runtime setter — present on InternalSelectionStore and on
+     *  MyIOSelectionStore (when exposed). Callers should feature-detect. */
+    setMaxSelections?: (n: number) => void;
+    getMaxSelections?: () => number;
 }
 /**
  * Date range for comparison modals
@@ -5523,7 +5544,8 @@ interface FooterComponentParams {
     configTemplate?: FooterConfigTemplate;
     /** Selection store instance (default: window.MyIOSelectionStore) */
     selectionStore?: SelectionStore;
-    /** Maximum number of selections allowed (default: 6) */
+    /** Maximum number of selections allowed.
+     *  Resolution order: this param > configTemplate.maxSelections > DEFAULT_CONFIG_TEMPLATE.maxSelections (20). */
     maxSelections?: number;
     /** Message shown when dock is empty */
     emptyMessage?: string;
@@ -5585,6 +5607,20 @@ interface FooterComponentInstance {
      * Get the count of selected entities
      */
     getSelectionCount: () => number;
+    /**
+     * Update the maximum number of selections at runtime.
+     * If the current selection exceeds the new limit, it will be truncated
+     * (insertion order) and `selection:limit-reached` will be emitted.
+     *
+     * Note: when the footer is wired to an external store that does not
+     * implement `setMaxSelections`, the controller's internal limit is
+     * updated but the external store's own limit is left untouched.
+     */
+    setMaxSelections: (n: number) => void;
+    /**
+     * Get the maximum number of selections currently enforced.
+     */
+    getMaxSelections: () => number;
     /**
      * Get the current unit type (energy, water, tank, temperature, or null)
      */
@@ -5640,7 +5676,7 @@ interface FooterComponentInstance {
  * const footer = createFooterComponent({
  *   container: document.getElementById('footer-container'),
  *   theme: 'dark',
- *   maxSelections: 6,
+ *   maxSelections: 20,
  *   onCompareClick: (entities, unitType) => {
  *     console.log('Compare clicked:', entities.length, unitType);
  *   },

package/dist/index.js

@@ -546,7 +546,7 @@ var init_template_card = __esm({
 // package.json
 var package_default = {
   name: "myio-js-library",
-  version: "0.1.498",
+  version: "0.1.499",
   description: "A clean, standalone JS SDK for MYIO projects",
   license: "MIT",
   repository: "github:gh-myio/myio-js-library",
@@ -4932,7 +4932,7 @@ var MyIOSelectionStoreClass = class _MyIOSelectionStoreClass {
     if (_MyIOSelectionStoreClass.GlobalDebug) {
       console.trace("[SelectionStore] Constructor called from:");
     }
-    this.MAX_SELECTION = 6;
+    this.MAX_SELECTION = 20;
     this.state = { selectedDevice: null };
     this.selectedIds = /* @__PURE__ */ new Set();
     this.entities = /* @__PURE__ */ new Map();
@@ -5017,6 +5017,45 @@ var MyIOSelectionStoreClass = class _MyIOSelectionStoreClass {
     this._emitSelectionChange("clear");
     this._trackEvent("footer_dock.clear_all", { count: 0 });
   }
+  /**
+   * Updates the maximum number of concurrent selections at runtime.
+   * Typically called once from MAIN_VIEW onInit with the value from widget
+   * settings so operators can configure it per-customer without code changes.
+   *
+   * If the current selection already exceeds the new limit, keeps the first N
+   * in insertion order, drops the rest, and emits `selection:change` plus
+   * `selection:limit-reached` so any UI reflects the truncation.
+   *
+   * @param {number} n - new maximum (integer ≥ 1)
+   */
+  setMaxSelection(n) {
+    const v = Math.floor(Number(n));
+    if (!Number.isFinite(v) || v < 1) {
+      this._log("warn", `[MyIOSelectionStoreClass] Invalid maxSelection, ignoring:`, n);
+      return;
+    }
+    if (v === this.MAX_SELECTION) return;
+    const prev = this.MAX_SELECTION;
+    this.MAX_SELECTION = v;
+    this._log("log", `[MyIOSelectionStoreClass] MAX_SELECTION ${prev} \u2192 ${v}`);
+    if (this.selectedIds.size > v) {
+      const kept = Array.from(this.selectedIds).slice(0, v);
+      this.selectedIds = new Set(kept);
+      this._emitSelectionChange("truncate");
+      this._emit("selection:limit-reached", {
+        maxAllowed: v,
+        currentCount: this.selectedIds.size,
+        truncated: true
+      });
+    }
+  }
+  /**
+   * Returns the currently active selection limit.
+   * @returns {number}
+   */
+  getMaxSelection() {
+    return this.MAX_SELECTION;
+  }
   syncFromCheckbox(id, checked) {
     if (typeof id !== "string" || typeof checked !== "boolean") return;
     if (checked && !this.isSelected(id)) {
@@ -29971,27 +30010,36 @@ var EnergyModalView = class {
   }
   /**
    * (Re)builds the DateRangePicker. Time picker only shown when granularity = '1h'.
-   * Preserves the currently selected range when rebuilding after a granularity change.
+   *
+   * Preserves only the DATE portion of the previous range — times are always
+   * reset to 00:00:00 (start) / 23:59:59 (end) on every rebuild, so toggling
+   * the granularity tab reliably brings back the full-day default. In 1h
+   * mode the user can then adjust hours/minutes freely; switching back to
+   * 1d wipes any custom time and restores the full-day boundaries.
    */
   async rebuildDateRangePicker(input) {
-    let presetStart;
-    let presetEnd;
+    const toYmd = (v) => {
+      if (!v) return void 0;
+      if (v instanceof Date) return v.toISOString().split("T")[0];
+      if (typeof v === "string") return v.split("T")[0];
+      return void 0;
+    };
+    let startYmd;
+    let endYmd;
     if (this.dateRangePicker) {
       try {
         const current = this.dateRangePicker.getDates();
-        presetStart = current.startISO;
-        presetEnd = current.endISO;
+        startYmd = toYmd(current.startISO);
+        endYmd = toYmd(current.endISO);
       } catch {
       }
       this.dateRangePicker.destroy();
       this.dateRangePicker = null;
     }
-    if (!presetStart) {
-      presetStart = this.config.params.startDate instanceof Date ? this.config.params.startDate.toISOString().split("T")[0] : this.config.params.startDate;
-    }
-    if (!presetEnd) {
-      presetEnd = this.config.params.endDate instanceof Date ? this.config.params.endDate.toISOString().split("T")[0] : this.config.params.endDate;
-    }
+    if (!startYmd) startYmd = toYmd(this.config.params.startDate);
+    if (!endYmd) endYmd = toYmd(this.config.params.endDate);
+    const presetStart = startYmd ? `${startYmd}T00:00:00-03:00` : void 0;
+    const presetEnd = endYmd ? `${endYmd}T23:59:59-03:00` : void 0;
     try {
       this.dateRangePicker = await attach(input, {
         presetStart,
@@ -31015,20 +31063,28 @@ var DeviceReportModal = class {
    * Preserves the currently selected range when rebuilding after a granularity change.
    */
   async rebuildDateRangePicker(input) {
-    let presetStart;
-    let presetEnd;
+    const toYmd = (v) => {
+      if (!v) return void 0;
+      if (v instanceof Date) return v.toISOString().split("T")[0];
+      if (typeof v === "string") return v.split("T")[0];
+      return void 0;
+    };
+    let startYmd;
+    let endYmd;
     if (this.dateRangePicker) {
       try {
         const current = this.dateRangePicker.getDates();
-        presetStart = current.startISO;
-        presetEnd = current.endISO;
+        startYmd = toYmd(current.startISO);
+        endYmd = toYmd(current.endISO);
       } catch {
       }
       this.dateRangePicker.destroy();
       this.dateRangePicker = null;
     }
-    if (!presetStart) presetStart = this.getDefaultStartDate();
-    if (!presetEnd) presetEnd = this.getDefaultEndDate();
+    if (!startYmd) startYmd = toYmd(this.getDefaultStartDate());
+    if (!endYmd) endYmd = toYmd(this.getDefaultEndDate());
+    const presetStart = startYmd ? `${startYmd}T00:00:00-03:00` : void 0;
+    const presetEnd = endYmd ? `${endYmd}T23:59:59-03:00` : void 0;
     try {
       this.dateRangePicker = await attach(input, {
         presetStart,
@@ -41130,7 +41186,7 @@ var DEFAULT_CONFIG_TEMPLATE2 = {
   emptyMessage: "Selecione dispositivos para comparar",
   compareButtonLabel: "Comparar",
   clearButtonLabel: "Limpar",
-  maxSelections: 6,
+  maxSelections: 20,
   darkMode: DEFAULT_DARK_THEME2,
   lightMode: DEFAULT_LIGHT_THEME2
 };
@@ -43346,9 +43402,28 @@ var InternalSelectionStore = class {
   entities = /* @__PURE__ */ new Map();
   listeners = /* @__PURE__ */ new Map();
   maxSelections;
-  constructor(maxSelections = 6) {
+  constructor(maxSelections = DEFAULT_CONFIG_TEMPLATE2.maxSelections ?? 20) {
     this.maxSelections = maxSelections;
   }
+  /**
+   * Updates the maximum selection limit at runtime.
+   * If the current selection exceeds the new limit, trims the oldest
+   * entries (insertion order) and emits `selection:change`.
+   */
+  setMaxSelections(n) {
+    const v = Math.floor(Number(n));
+    if (!Number.isFinite(v) || v < 1) return;
+    this.maxSelections = v;
+    if (this.entities.size > v) {
+      const kept = Array.from(this.entities.entries()).slice(0, v);
+      this.entities = new Map(kept);
+      this.emit("selection:change", this.getSelectedEntities());
+      this.emit("selection:limit-reached", v);
+    }
+  }
+  getMaxSelections() {
+    return this.maxSelections;
+  }
   on(event, handler) {
     if (!this.listeners.has(event)) {
       this.listeners.set(event, []);
@@ -43401,7 +43476,7 @@ var FooterController = class {
   constructor(params, view) {
     this.params = params;
     this.view = view;
-    this.maxSelections = params.maxSelections ?? 6;
+    this.maxSelections = params.maxSelections ?? params.configTemplate?.maxSelections ?? DEFAULT_CONFIG_TEMPLATE2.maxSelections ?? 20;
     this.log = createLogger2(params.debug ?? false);
     if (params.colors) {
       setAlertColors(params.colors);
@@ -43745,6 +43820,38 @@ var FooterController = class {
   hideAlert() {
     hideAlert();
   }
+  /**
+   * Updates the maximum selection limit at runtime. If the footer is using
+   * an InternalSelectionStore, the store's limit is updated too; external
+   * stores are left untouched (they own their own limit).
+   *
+   * If the current selection exceeds the new limit, the underlying store
+   * will emit `selection:limit-reached` (and may truncate), and the view
+   * re-renders via the existing selection:change handler.
+   */
+  setMaxSelections(n) {
+    const v = Math.floor(Number(n));
+    if (!Number.isFinite(v) || v < 1) {
+      this.log.warn("setMaxSelections: invalid value, ignoring:", n);
+      return;
+    }
+    this.maxSelections = v;
+    if (this.store instanceof InternalSelectionStore) {
+      this.store.setMaxSelections(v);
+    } else {
+      this.log.log(
+        "setMaxSelections: external store detected \u2014 controller limit updated to",
+        v,
+        "but external store limit is not managed here. Call its own setter if supported."
+      );
+    }
+  }
+  /**
+   * Returns the maximum selection limit currently enforced by the controller.
+   */
+  getMaxSelections() {
+    return this.maxSelections;
+  }
   /**
    * Cleanup resources
    */
@@ -43780,6 +43887,8 @@ function createFooterComponent(params) {
     clearSelection: () => controller.clearSelection(),
     getSelectedEntities: () => controller.getSelectedEntities(),
     getSelectionCount: () => controller.getSelectionCount(),
+    setMaxSelections: (n) => controller.setMaxSelections(n),
+    getMaxSelections: () => controller.getMaxSelections(),
     // State methods
     getCurrentUnitType: () => controller.getCurrentUnitType(),
     setDateRange: (start, end) => controller.setDateRange(start, end),