@record-evolution/widget-filter-calendar 1.0.6 → 1.0.8

package/dist/widget-filter-calendar.js

@@ -554,7 +554,7 @@ var Nt = Object.defineProperty, jt = Object.getOwnPropertyDescriptor, $ = (r, t,
 };
 let u = class extends w {
   constructor() {
-    super(...arguments), this.defaultRange = [], this.version = "1.0.6";
+    super(...arguments), this.defaultRange = [], this.version = "1.0.8";
   }
   update(r) {
     r.has("theme") && this.registerTheme(this.theme), (r.has("route") || r.has("inputData")) && this.updateRangeFromRoute(), super.update(r);
@@ -730,7 +730,7 @@ $([
   Ht("lit-flatpickr")
 ], u.prototype, "flatpickr", 2);
 u = $([
-  Ot("widget-filter-calendar-1.0.6")
+  Ot("widget-filter-calendar-1.0.8")
 ], u);
 export {
   u as WidgetfilterCalendar

package/package.json

@@ -3,7 +3,7 @@
     "description": "Webcomponent widget-filter-calendar for IronFlock UI",
     "license": "MIT",
     "author": "widget-filter-calendar",
-    "version": "1.0.6",
+    "version": "1.0.8",
     "engines": {
         "node": ">=24.9.0",
         "npm": ">=10.0.2"
@@ -14,18 +14,19 @@
     "files": [
         "dist",
         "src",
-        "thumbnail.png"
+        "thumbnail.png",
+        "thumbnail.webp"
     ],
     "scripts": {
         "analyze": "cem analyze --litelement",
-        "start": "vite",
+        "start": "vite build --watch & vite",
         "build": "vite build",
         "watch": "vite build --watch",
         "types": "cat src/definition-schema.json | json2ts > src/definition-schema.d.ts",
         "release": "npm run build && npm run types && npm version patch --tag-version-prefix='' && git push && git push --tag && npm run build"
     },
     "dependencies": {
-        "lit": "^3.3.2"
+        "lit": "^3.3.3"
     },
     "peerDependencies": {
         "@material/web": "^2.4.1",

package/src/definition-schema.d.ts

@@ -10,11 +10,11 @@
  */
 export type Label = string;
 /**
- * The URL parameter key for the start timestamp (e.g., 'startTime', 'from'). Other widgets can reference this parameter in their data filter configurations to filter data from this date. Leave empty for single-date mode using only endKey.
+ * The NAME of the URL parameter that receives the selected start timestamp (e.g., 'start_time', 'from'). Every widget that should be filtered by this calendar must carry exactly this name as 'timeStartParam' in its data queryParams — together with 'timeEndParam' and a complete sliding time window (windowPeriod, windowLength, nowMinusPeriods), which the selection then overrides. Do NOT reference this parameter in a filterAnd condition on the timestamp column: filterAnd values are plain literals and are never substituted from the URL. Leave empty for single-date mode using only endKey.
  */
 export type TimeRangeStartKey = string;
 /**
- * The URL parameter key for the end timestamp (e.g., 'endTime', 'to'). Other widgets can reference this parameter in their data filter configurations to filter data until this date. Leave empty for single-date mode using only startKey.
+ * The NAME of the URL parameter that receives the selected end timestamp (e.g., 'end_time', 'to'). Every widget that should be filtered by this calendar must carry exactly this name as 'timeEndParam' in its data queryParams — together with 'timeStartParam' and a complete sliding time window (windowPeriod, windowLength, nowMinusPeriods), which the selection then overrides. Do NOT reference this parameter in a filterAnd condition on the timestamp column: filterAnd values are plain literals and are never substituted from the URL. Leave empty for single-date mode using only startKey.
  */
 export type TimeRangeEndKey = string;
 /**
@@ -23,7 +23,7 @@ export type TimeRangeEndKey = string;
 export type NumberOfMonthsToDisplay = number;
 
 /**
- * A date/time range picker filter widget using Flatpickr calendar. Use this widget to allow users to select date ranges for filtering dashboard data. Supports single date selection (configure only startKey or endKey) or date range selection (configure both). The selected timestamps are stored as URL parameters and can be referenced by other widgets' data queries. Ideal for time-series dashboards, historical data analysis, and report generation with customizable time windows.
+ * A date/time range picker filter widget using Flatpickr calendar. Use this widget to allow users to select date ranges for filtering dashboard data. Supports single date selection (configure only startKey or endKey) or date range selection (configure both). It writes the selected timestamps (epoch milliseconds) into the URL parameters NAMED by its startKey/endKey properties. WIRING (important): every widget that should follow this calendar binds to those names through its own data queryParams — timeStartParam = this widget's startKey, timeEndParam = this widget's endKey — as bare parameter names, never with a $ or {{}} prefix, and NEVER as a filterAnd condition on the timestamp column. Those widgets must additionally have a complete sliding time window set (windowPeriod + windowLength + nowMinusPeriods), otherwise the custom range is discarded and the calendar has no effect. Ideal for time-series dashboards, historical data analysis, and report generation with customizable time windows.
  */
 export interface InputData {
   label?: Label;

package/src/definition-schema.json

@@ -1,6 +1,6 @@
 {
     "title": "Input Data",
-    "description": "A date/time range picker filter widget using Flatpickr calendar. Use this widget to allow users to select date ranges for filtering dashboard data. Supports single date selection (configure only startKey or endKey) or date range selection (configure both). The selected timestamps are stored as URL parameters and can be referenced by other widgets' data queries. Ideal for time-series dashboards, historical data analysis, and report generation with customizable time windows.",
+    "description": "A date/time range picker filter widget using Flatpickr calendar. Use this widget to allow users to select date ranges for filtering dashboard data. Supports single date selection (configure only startKey or endKey) or date range selection (configure both). It writes the selected timestamps (epoch milliseconds) into the URL parameters NAMED by its startKey/endKey properties. WIRING (important): every widget that should follow this calendar binds to those names through its own data queryParams — timeStartParam = this widget's startKey, timeEndParam = this widget's endKey — as bare parameter names, never with a $ or {{}} prefix, and NEVER as a filterAnd condition on the timestamp column. Those widgets must additionally have a complete sliding time window set (windowPeriod + windowLength + nowMinusPeriods), otherwise the custom range is discarded and the calendar has no effect. Ideal for time-series dashboards, historical data analysis, and report generation with customizable time windows.",
     "type": "object",
     "properties": {
         "label": {
@@ -14,14 +14,14 @@
             "title": "Time Range Start Key",
             "order": 2,
             "dataDrivenDisabled": true,
-            "description": "The URL parameter key for the start timestamp (e.g., 'startTime', 'from'). Other widgets can reference this parameter in their data filter configurations to filter data from this date. Leave empty for single-date mode using only endKey.",
+            "description": "The NAME of the URL parameter that receives the selected start timestamp (e.g., 'start_time', 'from'). Every widget that should be filtered by this calendar must carry exactly this name as 'timeStartParam' in its data queryParams — together with 'timeEndParam' and a complete sliding time window (windowPeriod, windowLength, nowMinusPeriods), which the selection then overrides. Do NOT reference this parameter in a filterAnd condition on the timestamp column: filterAnd values are plain literals and are never substituted from the URL. Leave empty for single-date mode using only endKey.",
             "type": "string"
         },
         "endKey": {
             "title": "Time Range End Key",
             "order": 3,
             "dataDrivenDisabled": true,
-            "description": "The URL parameter key for the end timestamp (e.g., 'endTime', 'to'). Other widgets can reference this parameter in their data filter configurations to filter data until this date. Leave empty for single-date mode using only startKey.",
+            "description": "The NAME of the URL parameter that receives the selected end timestamp (e.g., 'end_time', 'to'). Every widget that should be filtered by this calendar must carry exactly this name as 'timeEndParam' in its data queryParams — together with 'timeStartParam' and a complete sliding time window (windowPeriod, windowLength, nowMinusPeriods), which the selection then overrides. Do NOT reference this parameter in a filterAnd condition on the timestamp column: filterAnd values are plain literals and are never substituted from the URL. Leave empty for single-date mode using only startKey.",
             "type": "string"
         },
         "numMonths": {