@design.estate/dees-catalog 3.98.0 → 3.98.1

package/dist_ts_web/elements/00group-chart/dees-chart-area/realtime-updates.d.ts

@@ -0,0 +1,21 @@
+export interface IRealtimeChartPoint {
+    time: number;
+    value: number;
+}
+export interface IRealtimeChartUpdate {
+    point: IRealtimeChartPoint;
+    historicalUpdate: boolean;
+}
+export interface IRealtimeChartUpdatePlan {
+    replacementRequired: boolean;
+    updates: IRealtimeChartUpdate[];
+    pruneRecommended: boolean;
+    pruneRequired: boolean;
+}
+/**
+ * Lightweight Charts can update the newest point or append newer points with
+ * update(). Historical update() calls may only target timestamps that already
+ * exist. Everything else needs an exact setData() replacement.
+ */
+export declare const planRealtimeChartUpdates: (renderedData: readonly IRealtimeChartPoint[], canonicalData: readonly IRealtimeChartPoint[]) => IRealtimeChartUpdatePlan;
+export declare const haveSameSeriesLayout: (renderedNames: readonly string[], canonicalNames: readonly string[]) => boolean;

package/dist_ts_web/elements/00group-chart/dees-chart-area/realtime-updates.js

@@ -0,0 +1,79 @@
+/**
+ * Lightweight Charts can update the newest point or append newer points with
+ * update(). Historical update() calls may only target timestamps that already
+ * exist. Everything else needs an exact setData() replacement.
+ */
+export const planRealtimeChartUpdates = (renderedData, canonicalData) => {
+    if (canonicalData.length === 0) {
+        return {
+            replacementRequired: renderedData.length !== 0,
+            updates: [],
+            pruneRecommended: false,
+            pruneRequired: false,
+        };
+    }
+    if (renderedData.length === 0) {
+        return {
+            replacementRequired: false,
+            updates: canonicalData.map((point) => ({ point, historicalUpdate: false })),
+            pruneRecommended: false,
+            pruneRequired: false,
+        };
+    }
+    const renderedByTime = new Map(renderedData.map((point) => [point.time, point]));
+    const canonicalByTime = new Map(canonicalData.map((point) => [point.time, point]));
+    const canonicalStart = canonicalData[0].time;
+    const renderedLastTime = renderedData[renderedData.length - 1].time;
+    // Points before canonicalStart are an expired rolling-window prefix and may
+    // stay hidden temporarily. Missing points anywhere else are structural
+    // deletions (including suffix deletion) and require an exact replacement.
+    const hasStructuralDeletion = renderedData.some((point) => point.time >= canonicalStart && !canonicalByTime.has(point.time));
+    if (hasStructuralDeletion) {
+        return {
+            replacementRequired: true,
+            updates: [],
+            pruneRecommended: false,
+            pruneRequired: false,
+        };
+    }
+    const updates = [];
+    for (const canonicalPoint of canonicalData) {
+        const renderedPoint = renderedByTime.get(canonicalPoint.time);
+        if (!renderedPoint) {
+            if (canonicalPoint.time < renderedLastTime) {
+                // Historical update() cannot insert a missing timestamp.
+                return {
+                    replacementRequired: true,
+                    updates: [],
+                    pruneRecommended: false,
+                    pruneRequired: false,
+                };
+            }
+            updates.push({ point: canonicalPoint, historicalUpdate: false });
+            continue;
+        }
+        if (renderedPoint.value !== canonicalPoint.value) {
+            updates.push({
+                point: canonicalPoint,
+                historicalUpdate: canonicalPoint.time < renderedLastTime,
+            });
+        }
+    }
+    const firstCanonicalPointIndex = renderedData.findIndex((point) => point.time >= canonicalStart);
+    const retainedPrefixLength = firstCanonicalPointIndex === -1
+        ? renderedData.length
+        : firstCanonicalPointIndex;
+    const projectedLength = renderedData.length
+        + updates.filter((update) => !renderedByTime.has(update.point.time)).length;
+    // Retain at most one additional hidden rolling window before compacting.
+    const retentionLimit = Math.max(canonicalData.length * 2, 2);
+    const pruneRecommended = retainedPrefixLength > 0 && projectedLength > retentionLimit;
+    // Hover may defer a recommended compaction to preserve the active crosshair,
+    // but never beyond two additional hidden windows.
+    const hardRetentionLimit = Math.max(canonicalData.length * 3, 3);
+    const pruneRequired = retainedPrefixLength > 0 && projectedLength > hardRetentionLimit;
+    return { replacementRequired: false, updates, pruneRecommended, pruneRequired };
+};
+export const haveSameSeriesLayout = (renderedNames, canonicalNames) => renderedNames.length === canonicalNames.length
+    && renderedNames.every((name, index) => name === canonicalNames[index]);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVhbHRpbWUtdXBkYXRlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzX3dlYi9lbGVtZW50cy8wMGdyb3VwLWNoYXJ0L2RlZXMtY2hhcnQtYXJlYS9yZWFsdGltZS11cGRhdGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQWlCQTs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sd0JBQXdCLEdBQUcsQ0FDdEMsWUFBNEMsRUFDNUMsYUFBNkMsRUFDbkIsRUFBRTtJQUM1QixJQUFJLGFBQWEsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDL0IsT0FBTztZQUNMLG1CQUFtQixFQUFFLFlBQVksQ0FBQyxNQUFNLEtBQUssQ0FBQztZQUM5QyxPQUFPLEVBQUUsRUFBRTtZQUNYLGdCQUFnQixFQUFFLEtBQUs7WUFDdkIsYUFBYSxFQUFFLEtBQUs7U0FDckIsQ0FBQztJQUNKLENBQUM7SUFDRCxJQUFJLFlBQVksQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDOUIsT0FBTztZQUNMLG1CQUFtQixFQUFFLEtBQUs7WUFDMUIsT0FBTyxFQUFFLGFBQWEsQ0FBQyxHQUFHLENBQUMsQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDLENBQUMsRUFBRSxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQztZQUMzRSxnQkFBZ0IsRUFBRSxLQUFLO1lBQ3ZCLGFBQWEsRUFBRSxLQUFLO1NBQ3JCLENBQUM7SUFDSixDQUFDO0lBRUQsTUFBTSxjQUFjLEdBQUcsSUFBSSxHQUFHLENBQUMsWUFBWSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEtBQUssRUFBRSxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUNqRixNQUFNLGVBQWUsR0FBRyxJQUFJLEdBQUcsQ0FBQyxhQUFhLENBQUMsR0FBRyxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUUs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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design.estate/dees-catalog",
-  "version": "3.98.0",
+  "version": "3.98.1",
   "private": false,
   "description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.",
   "main": "dist_ts_web/index.js",

package/ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@design.estate/dees-catalog',
-  version: '3.98.0',
+  version: '3.98.1',
   description: 'A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.'
 }