pinets 0.9.9 → 0.9.11

package/dist/types/PineTS.class.d.ts

@@ -148,6 +148,34 @@ export declare class PineTS {
      * @private
      */
     private _removeLastResult;
+    /**
+     * Snapshot the var/let/const/params Series state for streaming rollback.
+     * Captures the data array length and last value for each variable so we can
+     * restore to this exact state before re-executing the last bar.
+     *
+     * PERF NOTE: This currently snapshots ALL scopes (const, var, let, params).
+     * In practice, only `var` variables need snapshot/restore because:
+     *   - `let` variables are re-initialized every bar via $.init() — they reset naturally
+     *   - `const` variables are set once and never modified
+     *   - `params` are function parameters, not modified across bars
+     * Only `var` variables persist and get modified in-place by $.set() (e.g. n += 1),
+     * which causes drift on streaming re-execution.
+     * If this becomes a bottleneck, narrow to `['var']` only.
+     *
+     * An even lighter alternative: make $.set() on var Series append-only (push
+     * instead of in-place modify). Then the existing pop-based _removeLastResult
+     * would correctly revert var state without any snapshot. This would require
+     * changes to the core Series/set mechanics.
+     *
+     * @private
+     */
+    private _snapshotVarState;
+    /**
+     * Restore var/let/const/params Series state from a snapshot.
+     * Truncates each Series' data array back to the snapshotted length.
+     * @private
+     */
+    private _restoreVarState;
     /**
      * Initialize a new context for running Pine Script code
      * @private

package/dist/types/namespaces/Time.d.ts

@@ -1,3 +1,17 @@
+/**
+ * Normalize a Pine Script timeframe string to a canonical form.
+ * e.g. "1D" → "D", "60" → "60", "1W" → "W", "" → ""
+ */
+export declare function normalizeTimeframe(tf: string): string;
+/**
+ * Compute the opening timestamp of the higher-timeframe bar that contains the given timestamp.
+ *
+ * For intraday TFs (minutes): floor to the nearest multiple of the TF duration within the day.
+ * For daily: floor to UTC day start (00:00 UTC).
+ * For weekly: floor to Monday 00:00 UTC.
+ * For monthly: floor to 1st of month 00:00 UTC.
+ */
+export declare function alignToTimeframe(timestamp: number, tf: string): number;
 interface DateParts {
     year: number;
     month: number;
@@ -28,7 +42,7 @@ export declare class TimeHelper {
     constructor(context: any, dataField?: string);
     get __value(): any;
     param(source: any, index?: number): any;
-    any(...args: any[]): any;
+    any(...args: any[]): number;
     /**
      * Basic session check: parses "HHMM-HHMM" format and tests if
      * the timestamp falls within the session window.

package/dist/types/namespaces/Timeframe.d.ts

@@ -17,6 +17,14 @@ export declare class Timeframe {
     get isseconds(): boolean;
     get isminutes(): boolean;
     get isintraday(): boolean;
+    /**
+     * Detects changes in the specified timeframe.
+     * Returns true on the first bar of a new HTF period, false otherwise.
+     *
+     * Works by aligning current and previous bar timestamps to the target
+     * timeframe and comparing — if they differ, a new period has started.
+     */
+    change(timeframe: any): boolean;
     from_seconds(seconds: number): string | number;
     in_seconds(timeframe?: string): number;
 }

package/dist/types/namespaces/box/BoxHelper.d.ts

@@ -16,6 +16,11 @@ export declare class BoxHelper {
      */
     private _resolveColor;
     private _createBox;
+    /**
+     * Enforce max_boxes_count: auto-delete the oldest non-deleted boxes
+     * when the active count exceeds the limit (FIFO eviction).
+     */
+    private _enforceMaxCount;
     new(...args: any[]): BoxObject;
     any(...args: any[]): BoxObject;
     set_left(id: BoxObject, left: number): void;

package/dist/types/namespaces/label/LabelHelper.d.ts

@@ -15,6 +15,7 @@ export declare class LabelHelper {
      */
     private _resolve;
     private _createLabel;
+    private _enforceMaxCount;
     new(...args: any[]): LabelObject;
     any(...args: any[]): LabelObject;
     set_x(id: LabelObject, x: number): void;

package/dist/types/namespaces/line/LineHelper.d.ts

@@ -16,6 +16,7 @@ export declare class LineHelper {
      */
     private _resolve;
     private _createLine;
+    private _enforceMaxCount;
     new(...args: any[]): LineObject;
     any(...args: any[]): LineObject;
     set_x1(id: LineObject, x: number): void;

package/dist/types/namespaces/polyline/PolylineHelper.d.ts

@@ -20,6 +20,7 @@ export declare class PolylineHelper {
      */
     private _extractPoints;
     new(...args: any[]): PolylineObject;
+    private _enforceMaxCount;
     any(...args: any[]): PolylineObject;
     delete(id: PolylineObject): void;
     get all(): PolylineObject[];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pinets",
-    "version": "0.9.9",
+    "version": "0.9.11",
     "description": "Run Pine Script anywhere. PineTS is an open-source transpiler and runtime that brings Pine Script logic to Node.js and the browser with 1:1 syntax compatibility. Reliably write, port, and run indicators or strategies on your own infrastructure.",
     "keywords": [
         "Pine Script",