@hoox-sh/pynets 0.3.0 → 0.5.0

package/src/runtime/compile/emit_call.ts

@@ -46,6 +46,8 @@ const NS = new Set([
   "syminfo",
   "timenow",
   "chart",
+  "footprint",
+  "volume_row",
 ]);
 
 /** TaEngine methods we emit. Unknown `ta.*` → `null`. */
@@ -136,6 +138,23 @@ const TA_METHODS = new Set([
   "fractal",
   "atr_stop",
   "zigzag",
+  "hammer",
+  "gap_detector",
+  "macd_signal",
+  "acceleration_factor",
+  "stoch_smooth",
+  "engulfing",
+  "inside_bar_pattern",
+  "double_top_bottom",
+  "voi",
+  "bid_ask_imbalance",
+  "rsi_oversold_overbought",
+  "rsi_divergence",
+  "cumulative_delta",
+  "volume_momentum",
+  "volume_profile_high",
+  "volume_profile_low",
+  "volume_thrust",
 ]);
 
 /**
@@ -367,7 +386,15 @@ export function emitCall(ctx: EmitCtx, node: Call, visit: VisitFn): string {
     return `(() => { throw new Error(String(${msg})); })()`;
   }
 
-  if (name === "alertcondition") return "null";
+  if (name === "max_bars_back") return "null";
+  if (name === "timenow") return "__h.timenow(time_arr)";
+  if (name === "alertcondition") {
+    ctx.usesDrawings = true;
+    const cond = pick(args, 0, ["condition"], "null");
+    const title = hasArg(args, 1, ["title"]) ? pick(args, 1, ["title"], `"Alert"`) : `"Alert"`;
+    const message = hasArg(args, 2, ["message"]) ? pick(args, 2, ["message"], `"Alert"`) : `"Alert"`;
+    return `__h.draw.alertcondition(__bar_idx, ${cond}, ${title}, ${message})`;
+  }
   if (name === "str_tostring" || name === "tostring") {
     const x = pick(args, 0, ["value", "source", "x"], "null");
     return `String(${x} ?? "")`;
@@ -428,6 +455,8 @@ export function emitCall(ctx: EmitCtx, node: Call, visit: VisitFn): string {
 
   const req = emitRequest(ctx, name, args);
   if (req != null) return req;
+  const fp = emitFootprint(name, args);
+  if (fp != null) return fp;
 
   return "null";
 }
@@ -525,6 +554,19 @@ function finiteOr(expr: string, fb: string): string {
   return `((__v) => (__v != null && Number.isFinite(__v) ? __v : ${fb}))(${expr})`;
 }
 
+/** Interpret `unwrap`: bool → 1/0, non-finite → null. */
+function cellOf(expr: string): string {
+  return `((__c) => (__c == null ? null : typeof __c === "boolean" ? (__c ? 1 : 0) : (typeof __c === "number" && Number.isFinite(__c) ? __c : null)))(${expr})`;
+}
+
+/**
+ * Interpret `wave10bList`: a Pine array becomes its cells; a scalar is a
+ * one-element list. Bar-mode series stay one element.
+ */
+function cellList(expr: string): string {
+  return `(() => { const __v = ${expr}; const __cell = (e) => (e == null ? null : typeof e === "boolean" ? (e ? 1 : 0) : (typeof e === "number" && Number.isFinite(e) ? e : null)); if (__v != null && typeof __v.size === "function" && typeof __v.get === "function") { const __n = __v.size(); const __o = []; for (let __i = 0; __i < __n; __i++) __o.push(__cell(__v.get(__i))); return __o; } return [__cell(__v)]; })()`;
+}
+
 const DRAW_KINDS = new Set(["label", "line", "box", "table", "polyline", "linefill"]);
 
 const ARRAY_SIGS: Record<string, string[][]> = {
@@ -704,6 +746,10 @@ function emitHostCall(ns: string, method: string, args: CallArgs, params: string
 function emitArray(name: string, args: CallArgs): string | null {
   const raw = nsMethod(name, "array_");
   if (raw == null) return null;
+  if (raw === "from") {
+    const parts = args.pos.length > 0 ? args.pos : Object.values(args.kw);
+    return `__h.array.from([${parts.join(", ")}])`;
+  }
   const method = ctorMethod(raw);
   const params = ARRAY_SIGS[method];
   if (params == null) return null;
@@ -745,11 +791,24 @@ const DRAW_METHODS: Record<string, Record<string, string[][]>> = {
   label: {
     set_text: [["id"], ["text"]],
     set_xy: [["id"], ["x"], ["y"]],
+    set_x: [["id"], ["x"]],
+    set_y: [["id"], ["y"]],
     set_color: [["id"], ["color"]],
     set_style: [["id"], ["style"]],
     set_size: [["id"], ["size"]],
     set_tooltip: [["id"], ["tooltip"]],
     set_textalign: [["id"], ["textalign"]],
+    set_textcolor: [["id"], ["color", "textcolor"]],
+    set_text_font_family: [["id"], ["font_family", "text_font_family"]],
+    set_text_halign: [["id"], ["halign", "text_halign"]],
+    set_text_valign: [["id"], ["valign", "text_valign"]],
+    set_text_size: [["id"], ["size", "text_size"]],
+    set_text_formatting: [["id"], ["formatting", "text_formatting"]],
+    set_border_color: [["id"], ["color"]],
+    set_border_width: [["id"], ["width"]],
+    set_border_style: [["id"], ["style"]],
+    set_xloc: [["id"], ["xloc"]],
+    set_yloc: [["id"], ["yloc"]],
     delete: [["id"]],
     get_text: [["id"]],
     get_x: [["id"]],
@@ -757,12 +816,17 @@ const DRAW_METHODS: Record<string, Record<string, string[][]>> = {
   },
   line: {
     set_xy: [["id"], ["x1"], ["y1"], ["x2"], ["y2"]],
-    set_xy1: [["id"], ["x1"], ["y1"]],
-    set_xy2: [["id"], ["x2"], ["y2"]],
+    set_xy1: [["id"], ["x1", "x"], ["y1", "y"]],
+    set_xy2: [["id"], ["x2", "x"], ["y2", "y"]],
+    set_x1: [["id"], ["x1", "x"]],
+    set_y1: [["id"], ["y1", "y"]],
+    set_x2: [["id"], ["x2", "x"]],
+    set_y2: [["id"], ["y2", "y"]],
     set_color: [["id"], ["color"]],
     set_width: [["id"], ["width"]],
     set_style: [["id"], ["style"]],
     set_extend: [["id"], ["extend"]],
+    set_xloc: [["id"], ["xloc"]],
     delete: [["id"]],
     get_price: [["id"], ["x"]],
     get_x1: [["id"]],
@@ -773,44 +837,144 @@ const DRAW_METHODS: Record<string, Record<string, string[][]>> = {
   box: {
     set_corners: [["id"], ["left", "x1"], ["top", "y1"], ["right", "x2"], ["bottom", "y2"]],
     set_lefttop: [["id"], ["left", "x1"], ["top", "y1"], ["right", "x2"], ["bottom", "y2"]],
+    set_left: [["id"], ["left"]],
+    set_right: [["id"], ["right"]],
+    set_top: [["id"], ["top"]],
+    set_bottom: [["id"], ["bottom"]],
     set_bgcolor: [["id"], ["bgcolor", "color"]],
     set_border_color: [["id"], ["color", "border_color"]],
+    set_border_width: [["id"], ["width"]],
+    set_border_style: [["id"], ["style"]],
     set_text: [["id"], ["text"]],
+    set_text_color: [["id"], ["color", "text_color"]],
+    set_text_font_family: [["id"], ["font_family"]],
+    set_text_halign: [["id"], ["halign"]],
+    set_text_valign: [["id"], ["valign"]],
+    set_text_size: [["id"], ["size"]],
+    set_text_formatting: [["id"], ["formatting"]],
+    set_text_wrap: [["id"], ["wrap"]],
     set_extend: [["id"], ["extend"]],
+    set_closed: [["id"], ["closed"]],
+    set_rightbottom: [["id"], ["right"], ["bottom"]],
+    get_left: [["id"]],
+    get_right: [["id"]],
+    get_top: [["id"]],
+    get_bottom: [["id"]],
     delete: [["id"]],
   },
   table: {
     cell: [["id"], ["column", "col"], ["row"], ["text"]],
-    cell_set_text: [["id"], ["column", "col"], ["row"], ["text"]],
+    // Interpret positional order is (id, row, column, text), not column-first.
+    cell_set_text: [["id"], ["row"], ["column", "col"], ["text"]],
+    cell_get_text: [["id"], ["row"], ["column", "col"]],
+    cell_set_text_color: [["id"], ["row"], ["column", "col"], ["color", "text"]],
+    cell_set_bgcolor: [["id"], ["row"], ["column", "col"], ["color"]],
+    cell_set_border_color: [["id"], ["row"], ["column", "col"], ["color"]],
+    cell_set_border_width: [["id"], ["row"], ["column", "col"], ["width"]],
+    cell_set_tooltip: [["id"], ["row"], ["column", "col"], ["tooltip", "text"]],
+    cell_set_width: [["id"], ["column", "col"], ["row"], ["width"]],
+    cell_set_height: [["id"], ["column", "col"], ["row"], ["height"]],
+    cell_set_text_halign: [["id"], ["column", "col"], ["row"], ["halign"]],
+    cell_set_text_valign: [["id"], ["column", "col"], ["row"], ["valign"]],
+    cell_set_text_size: [["id"], ["column", "col"], ["row"], ["size"]],
+    cell_set_text_font_family: [["id"], ["column", "col"], ["row"], ["font_family"]],
+    cell_set_text_formatting: [["id"], ["column", "col"], ["row"], ["formatting"]],
     set_position: [["id"], ["position"]],
+    set_bgcolor: [["id"], ["color", "bgcolor"]],
+    set_border_color: [["id"], ["color"]],
+    set_border_width: [["id"], ["width"]],
+    set_frame_color: [["id"], ["color"]],
+    set_frame_width: [["id"], ["width"]],
+    merge_cells: [["id"], ["start_row"], ["start_column", "start_col"], ["end_row"], ["end_column", "end_col"]],
     delete: [["id"]],
   },
   polyline: {
     delete: [["id"]],
+    get_points: [["id"]],
+    set_points: [["id"], ["points"]],
+    set_line_color: [["id"], ["color"]],
+    set_line_width: [["id"], ["width"]],
+    set_line_style: [["id"], ["style"]],
+    set_fill_color: [["id"], ["fill_color", "color"]],
+    set_curved: [["id"], ["curved"]],
+    set_force_overlay: [["id"], ["force_overlay"]],
+    set_closed: [["id"], ["closed"]],
+    set_xloc: [["id"], ["xloc"]],
   },
   linefill: {
     set_color: [["id"], ["color"]],
     delete: [["id"]],
+    get_line1: [["id"]],
+    get_line2: [["id"]],
   },
 };
 
+function emitChartPoint(name: string, args: CallArgs): string | null {
+  const meth = name.slice("chart_point_".length);
+  if (meth === "new" || meth === "from_time") {
+    return `__h.draw.point_new(${pick(args, 0, ["time"], "null")}, ${pick(args, 1, ["price"], "0")})`;
+  }
+  if (meth === "from_index") {
+    return `__h.draw.point_from_index(${pick(args, 0, ["index"], "null")}, ${pick(args, 1, ["price"], "0")})`;
+  }
+  if (meth === "now") {
+    return `__h.draw.point_now(__bar_idx, time, ${pick(args, 0, ["price"], "0")})`;
+  }
+  if (meth === "copy") {
+    return `__h.draw.point_copy(${pick(args, 0, ["point"], "null")})`;
+  }
+  return null;
+}
+
 function emitDraw(ctx: EmitCtx, name: string, methodSrc: expr | null, args: CallArgs): string | null {
   if (name === "alert" && methodSrc == null) {
     ctx.usesDrawings = true;
     return `__h.draw.alert(__bar_idx, ${pick(args, 0, ["message"], "null")})`;
   }
+  if (name.startsWith("chart_point_")) {
+    const point = emitChartPoint(name, args);
+    if (point != null) ctx.usesDrawings = true;
+    return point;
+  }
   const parsed = drawKindAndMethod(name, methodSrc);
   if (parsed == null) return null;
   const { kind, method } = parsed;
   let code: string | null = null;
-  if (method === "new") {
+  if (method === "all") {
+    code = `__h.draw.all(${JSON.stringify(kind)})`;
+  } else if (method === "copy" && (kind === "line" || kind === "label" || kind === "box" || kind === "polyline")) {
+    code = `__h.draw.copy(${pick(args, 0, ["id"], "null")})`;
+  } else if (method === "new") {
     if (kind === "label") {
-      code = `__h.draw.label_new(__bar_idx, ${pick(args, 2, ["text"], "null")})`;
+      code = `__h.draw.label_new(__bar_idx, ${pick(args, 2, ["text"], "null")}, ${pick(args, 0, ["x"], "0")}, ${pick(args, 1, ["y"], "0")})`;
+    } else if (kind === "line") {
+      code = `__h.draw.line_new(__bar_idx, ${pick(args, 0, ["x1"], "0")}, ${pick(args, 1, ["y1"], "0")}, ${pick(args, 2, ["x2"], "0")}, ${pick(args, 3, ["y2"], "0")})`;
+    } else if (kind === "box") {
+      code = `__h.draw.box_new(__bar_idx, ${pick(args, 0, ["left"], "0")}, ${pick(args, 1, ["top"], "0")}, ${pick(args, 2, ["right"], "0")}, ${pick(args, 3, ["bottom"], "0")})`;
+    } else if (kind === "polyline") {
+      code = `__h.draw.polyline_new(__bar_idx, ${pick(args, 0, ["points"], "null")})`;
     } else if (kind === "linefill") {
-      code = `__h.draw.linefill_new(__bar_idx, ${pick(args, 0, ["id1"], "null")}, ${pick(args, 1, ["id2"], "null")})`;
+      const color = hasArg(args, 2, ["color"]) ? pick(args, 2, ["color"], "null") : "null";
+      code = `__h.draw.linefill_new(__bar_idx, ${pick(args, 0, ["id1", "line1"], "null")}, ${pick(args, 1, ["id2", "line2"], "null")}, ${color})`;
     } else if (DRAW_KINDS.has(kind)) {
       code = `__h.draw.${kind}_new(__bar_idx)`;
     }
+  } else if (kind === "line" && method === "fill") {
+    const color = hasArg(args, 2, ["color"]) ? pick(args, 2, ["color"], "null") : "null";
+    code = `__h.draw.linefill_new(__bar_idx, ${pick(args, 0, ["id1", "line1"], "null")}, ${pick(args, 1, ["id2", "line2"], "null")}, ${color})`;
+  } else if (
+    (kind === "line" && (method === "set_first_point" || method === "set_second_point")) ||
+    (kind === "label" && method === "set_point") ||
+    (kind === "box" && (method === "set_top_left_point" || method === "set_bottom_right_point"))
+  ) {
+    code = `__h.draw.${kind}_${method}(${pick(args, 0, ["id"], "null")}, ${pick(args, 1, ["point"], "null")})`;
+  } else if (kind === "box" && method === "set_xloc") {
+    code = `__h.draw.box_set_xloc(${pick(args, 0, ["id"], "null")}, ${pick(args, 1, ["left"], "null")}, ${pick(args, 2, ["right"], "null")}, ${pick(args, 3, ["xloc"], "null")})`;
+  } else if (kind === "table" && method === "clear") {
+    const id = pick(args, 0, ["id", "table_id"], "null");
+    code = hasArg(args, 1, ["start_row"])
+      ? `__h.draw.table_clear(${id}, ${pick(args, 1, ["start_row"], "null")}, ${pick(args, 2, ["start_column", "start_col"], "null")}, ${pick(args, 3, ["end_row"], "null")}, ${pick(args, 4, ["end_column", "end_col"], "null")})`
+      : `__h.draw.table_clear(${id})`;
   } else {
     const aliased = kind === "box" && method === "set_lefttop" ? "set_corners" : method;
     const params = DRAW_METHODS[kind]?.[method] ?? DRAW_METHODS[kind]?.[aliased];
@@ -855,9 +1019,9 @@ function emitUdt(ctx: EmitCtx, name: string, methodSrc: expr | null, args: CallA
 
 const SECURITY_FUNCS = new Set([
   "security",
+  "security_lower_tf",
   "request_security",
   "request_security_lower_tf",
-  "request_seed",
 ]);
 
 const SIMPLE_CHART_EXPR = new Set([
@@ -903,10 +1067,60 @@ function emitRequest(ctx: EmitCtx, name: string, args: CallArgs): string | null
   if (name === "request_currency_rate" || name === "currency_rate") {
     return `__h.currencyRate(${pick(args, 0, ["from", "from_currency"], "null")}, ${pick(args, 1, ["to", "to_currency"], "null")})`;
   }
+  if (name === "request_seed") {
+    return `__h.requestSeed(${pick(args, 0, ["seed"], "0")})`;
+  }
+  if (name === "request_footprint") {
+    return `__h.requestFootprint(${pick(args, 0, ["num_ticks"], "100")}, ${pick(args, 1, ["va_percentage"], "70")})`;
+  }
   if (name.startsWith("request_")) return "null";
   return null;
 }
 
+/** Python `request.footprint` mock + `footprint.*` / `volume_row.*` accessors. */
+function emitFootprint(name: string, args: CallArgs): string | null {
+  const fp = pick(args, 0, ["id", "footprint"], "null");
+  const vr = pick(args, 0, ["id", "volume_row"], "null");
+  switch (name) {
+    case "footprint_buy_volume":
+      return `__h.footprint.buy_volume(${fp})`;
+    case "footprint_sell_volume":
+      return `__h.footprint.sell_volume(${fp})`;
+    case "footprint_delta":
+      return `__h.footprint.delta(${fp})`;
+    case "footprint_total_volume":
+      return `__h.footprint.total_volume(${fp})`;
+    case "footprint_vah":
+      return `__h.footprint.vah(${fp})`;
+    case "footprint_val":
+      return `__h.footprint.val(${fp})`;
+    case "footprint_poc":
+      return `__h.footprint.poc(${fp})`;
+    case "footprint_rows":
+      return `__h.footprint.rows(${fp})`;
+    case "footprint_get_row_by_price":
+      return `__h.footprint.get_row_by_price(${fp}, ${pick(args, 1, ["price"], "null")})`;
+    case "volume_row_up_price":
+      return `__h.footprint.volume_row.up_price(${vr})`;
+    case "volume_row_down_price":
+      return `__h.footprint.volume_row.down_price(${vr})`;
+    case "volume_row_buy_volume":
+      return `__h.footprint.volume_row.buy_volume(${vr})`;
+    case "volume_row_sell_volume":
+      return `__h.footprint.volume_row.sell_volume(${vr})`;
+    case "volume_row_delta":
+      return `__h.footprint.volume_row.delta(${vr})`;
+    case "volume_row_total_volume":
+      return `__h.footprint.volume_row.total_volume(${vr})`;
+    case "volume_row_has_buy_imbalance":
+      return `__h.footprint.volume_row.has_buy_imbalance(${vr})`;
+    case "volume_row_has_sell_imbalance":
+      return `__h.footprint.volume_row.has_sell_imbalance(${vr})`;
+    default:
+      return null;
+  }
+}
+
 function isSimpleSecurityExpr(expr: string): boolean {
   const e = expr.trim();
   if (!e) return false;
@@ -1024,6 +1238,7 @@ function emitStrategyDecl(ctx: EmitCtx, args: CallArgs): string {
   add(["default_qty_type"], "default_qty_type");
   add(["default_qty_value"], "default_qty_value");
   add(["initial_capital"], "initial_capital");
+  add(["currency"], "currency");
   return `__h.strategy.configure({${fields.join(", ")}})`;
 }
 
@@ -1095,8 +1310,50 @@ function emitStrategy(ctx: EmitCtx, name: string, args: CallArgs): string {
     case "margin_liquidation_price":
     case "position_avg_price":
     case "initial_capital":
+    case "cash":
+    case "position_entry_name":
+    case "account_currency":
+    case "max_contracts_held_all":
+    case "max_contracts_held_long":
+    case "max_contracts_held_short":
+    case "wintrades":
+    case "losstrades":
+    case "eventrades":
+    case "grossprofit":
+    case "grossloss":
+    case "avg_trade":
+    case "avg_winning_trade":
+    case "avg_losing_trade":
+    case "netprofit_percent":
+    case "openprofit_percent":
+    case "grossprofit_percent":
+    case "grossloss_percent":
+    case "avg_trade_percent":
+    case "avg_winning_trade_percent":
+    case "avg_losing_trade_percent":
+    case "max_drawdown":
+    case "max_drawdown_percent":
+    case "max_runup":
+    case "max_runup_percent":
+    case "percent_profitable":
+    case "winrate":
+    case "profitfactor":
+    case "profit_factor":
+    case "capital_held":
+    case "closedtrades_first_index":
       ctx.usesStrategy = true;
       return `__h.strategy.${method}()`;
+    case "commission":
+      return "0";
+    case "default_entry_qty":
+      ctx.usesStrategy = true;
+      return hasArg(args, 0, ["percent_equity"])
+        ? `__h.strategy.default_entry_qty(${pick(args, 0, ["percent_equity"], "null")})`
+        : `__h.strategy.default_entry_qty()`;
+    case "convert_to_account":
+    case "convert_to_symbol":
+      ctx.usesStrategy = true;
+      return hasArg(args, 0, ["value"]) ? `__h.strategy.convert_to(${pick(args, 0, ["value"], "null")})` : "1";
     case "risk_allow_entry_in":
       ctx.usesStrategy = true;
       return `__h.strategy.risk_allow_entry_in(${pick(args, 0, ["value"], "null")})`;
@@ -1106,9 +1363,33 @@ function emitStrategy(ctx: EmitCtx, name: string, args: CallArgs): string {
     case "risk_max_drawdown":
       ctx.usesStrategy = true;
       return `__h.strategy.risk_max_drawdown(${pick(args, 0, ["value"], "null")}, ${pick(args, 1, ["type"], "null")})`;
-    default:
+    default: {
+      if (method.startsWith("direction_")) {
+        const tail = method.slice("direction_".length);
+        if (tail === "long" || tail === "short" || tail === "all") return JSON.stringify(tail);
+      }
+      if (method.startsWith("oca_")) {
+        const tail = method.slice("oca_".length);
+        if (tail === "none" || tail === "cancel" || tail === "reduce") return JSON.stringify(tail);
+      }
+      if (method.startsWith("commission_")) {
+        const tail = method.slice("commission_".length);
+        if (tail === "percent" || tail === "cash_per_order" || tail === "cash_per_contract") {
+          return JSON.stringify(tail);
+        }
+      }
+      if (method.startsWith("closedtrades_") || method.startsWith("opentrades_")) {
+        ctx.usesStrategy = true;
+        if (method === "opentrades_capital_held") return "__h.strategy.capital_held()";
+        if (method === "closedtrades_first_index") return "__h.strategy.closedtrades_first_index()";
+        const idx = hasArg(args, 0, ["trade_num", "trade_index", "index"])
+          ? pick(args, 0, ["trade_num", "trade_index", "index"], "0")
+          : "0";
+        return `__h.strategy.${method}(${idx})`;
+      }
       if (isStrategyAction(name, method)) ctx.usesStrategy = true;
       return "null";
+    }
   }
 }
 
@@ -1167,7 +1448,7 @@ function emitPlot(ctx: EmitCtx, fname: string, args: CallArgs): string {
     : pick(args, 0, ["series", "source", "price"], "null");
   const i = ctx.plots.length;
   ctx.plots.push({ title });
-  return `plot_${i}[__bar_idx] = __h.naNum(${series})`;
+  return `plot_${i}[__bar_idx] = __h.plotNum(${series})`;
 }
 
 function emitColor(name: string, args: CallArgs): string | null {
@@ -1792,5 +2073,80 @@ function emitTa(ctx: EmitCtx, method: string, args: CallArgs): string {
     ]);
     return `(() => { const __r = ${call}; return [__r.high, __r.low, __r.dir]; })()`;
   }
+  if (method === "hammer") {
+    return `__h.ta.hammer(${cellOf(pick(args, 0, ["open"], "null"))}, ${cellOf(pick(args, 1, ["high"], "null"))}, ${cellOf(pick(args, 2, ["low"], "null"))}, ${cellOf(pick(args, 3, ["close"], "null"))})`;
+  }
+  if (method === "gap_detector") {
+    return `__h.ta.gapDetector(${cellOf(pick(args, 0, ["high"], "null"))}, ${cellOf(pick(args, 1, ["low"], "null"))}, ${cellOf(pick(args, 2, ["prev_close", "prev"], "null"))})`;
+  }
+  if (method === "macd_signal") {
+    return `__h.ta.macdSignal(${cellOf(pick(args, 0, ["macd_line", "macd"], "null"))}, ${cellOf(pick(args, 1, ["signal_line", "signal"], "null"))})`;
+  }
+  if (method === "acceleration_factor") {
+    return taCall("accelerationFactor", site, [
+      cellOf(pick(args, 0, ["momentum_list", "momentum", "source", "series"], "null")),
+      cellOf(pick(args, 1, ["period", "length"], "null")),
+    ]);
+  }
+  if (method === "stoch_smooth") {
+    return `__h.ta.stochSmooth(${cellOf(pick(args, 0, ["high"], "null"))}, ${cellOf(pick(args, 1, ["low"], "null"))}, ${cellOf(pick(args, 2, ["close"], "null"))}, ${cellOf(pick(args, 3, ["period", "length"], "null"))}, ${cellOf(pick(args, 4, ["smooth_k", "k"], "null"))}, ${cellOf(pick(args, 5, ["smooth_d", "d"], "null"))})`;
+  }
+  if (method === "engulfing") {
+    // Bar-mode sentinel. Args are still evaluated (interpret reads all four).
+    return `(() => { ${cellOf(pick(args, 0, ["open"], "null"))}; ${cellOf(pick(args, 1, ["high"], "null"))}; ${cellOf(pick(args, 2, ["low"], "null"))}; ${cellOf(pick(args, 3, ["close"], "null"))}; return __h.ta.engulfing(); })()`;
+  }
+  if (method === "inside_bar_pattern") {
+    return `(() => { ${cellOf(pick(args, 0, ["high"], "null"))}; ${cellOf(pick(args, 1, ["low"], "null"))}; return __h.ta.insideBarPattern(); })()`;
+  }
+  if (method === "double_top_bottom") {
+    return `(() => { ${cellOf(pick(args, 0, ["high"], "null"))}; ${cellOf(pick(args, 1, ["low"], "null"))}; return __h.ta.doubleTopBottom(${cellOf(pick(args, 2, ["period", "length"], "null"))}); })()`;
+  }
+  if (method === "voi") {
+    return `__h.ta.voi(${cellOf(pick(args, 0, ["buy_volume", "buy"], "null"))}, ${cellOf(pick(args, 1, ["sell_volume", "sell"], "null"))})`;
+  }
+  if (method === "bid_ask_imbalance") {
+    return `__h.ta.bidAskImbalance(${cellOf(pick(args, 0, ["bid_size", "bid"], "null"))}, ${cellOf(pick(args, 1, ["ask_size", "ask"], "null"))}, ${cellOf(pick(args, 2, ["bid_price"], "null"))}, ${cellOf(pick(args, 3, ["ask_price"], "null"))})`;
+  }
+  if (method === "rsi_oversold_overbought") {
+    return `__h.ta.rsiOversoldOverbought(${cellOf(pick(args, 0, ["rsi_series", "rsi", "source"], "null"))}, ${cellOf(pick(args, 1, ["oversold_level", "oversold"], "null"))}, ${cellOf(pick(args, 2, ["overbought_level", "overbought"], "null"))})`;
+  }
+  if (method === "rsi_divergence") {
+    // Missing period is 0 (interpret `period ?? 0`), not the engine's null → na.
+    const period = `((__n) => (__n == null ? 0 : __n))(${cellOf(pick(args, 1, ["period", "length"], "null"))})`;
+    return `__h.ta.rsiDivergence(${cellList(pick(args, 0, ["rsi_series", "series", "source"], "null"))}, ${period})`;
+  }
+  if (method === "cumulative_delta") {
+    return taCall("cumulativeDelta", site, [
+      cellOf(pick(args, 0, ["close", "source"], "null")),
+      cellOf(pick(args, 1, ["volume"], "null")),
+      cellOf(pick(args, 2, ["period", "length"], "null")),
+    ]);
+  }
+  if (method === "volume_momentum") {
+    return taCall("volumeMomentum", site, [
+      cellOf(pick(args, 0, ["volume", "source"], "null")),
+      cellOf(pick(args, 1, ["period", "length"], "null")),
+    ]);
+  }
+  if (method === "volume_profile_high") {
+    return `__h.ta.volumeProfileHigh(${cellList(pick(args, 0, ["close", "price", "source", "series"], "null"))}, ${cellList(pick(args, 1, ["volume"], "null"))})`;
+  }
+  if (method === "volume_profile_low") {
+    return taCall("volumeProfileLow", site, [
+      cellOf(pick(args, 0, ["close", "source"], "null")),
+      cellOf(pick(args, 1, ["volume"], "null")),
+      cellOf(pick(args, 2, ["period", "length"], "null")),
+      cellOf(pick(args, 3, ["levels"], "null")),
+    ]);
+  }
+  if (method === "volume_thrust") {
+    const sens = cellOf(pick(args, 3, ["sensitivity"], "null"));
+    return taCall("volumeThrust", site, [
+      cellOf(pick(args, 0, ["close", "source"], "null")),
+      cellOf(pick(args, 1, ["volume"], "null")),
+      cellOf(pick(args, 2, ["volume_sma", "vol_sma", "sma"], "null")),
+      `((__n) => (__n == null ? 0.3 : __n))(${sens})`,
+    ]);
+  }
   return "null";
 }

package/src/runtime/compile/runtime.ts

@@ -56,7 +56,28 @@ import {
   strUpper,
 } from "../str.ts";
 import { LogBook, formatLogParts } from "../log.ts";
-import { resolveCurrencyRate } from "../request.ts";
+import { PineArray } from "../array.ts";
+import {
+  createFootprint,
+  footprintBuyVolume,
+  footprintDelta,
+  footprintGetRowByPrice,
+  footprintPoc,
+  footprintRows,
+  footprintSellVolume,
+  footprintTotalVolume,
+  footprintVah,
+  footprintVal,
+  volumeRowBuyVolume,
+  volumeRowDelta,
+  volumeRowDownPrice,
+  volumeRowHasBuyImbalance,
+  volumeRowHasSellImbalance,
+  volumeRowSellVolume,
+  volumeRowTotalVolume,
+  volumeRowUpPrice,
+} from "../footprint.ts";
+import { resolveCurrencyRate, resolveSeed } from "../request.ts";
 import { TaEngine } from "../ta.ts";
 import { utcPartsFromMs, timestamp, weekOfYear, timeTradingDay, type UtcParts } from "../time.ts";
 import { TickerId } from "../ticker.ts";
@@ -83,6 +104,7 @@ import {
   safeNeg,
   safeSub,
 } from "./helpers.ts";
+import { isStrategyCashAmount } from "../strategy.ts";
 import { createCompileStrategy } from "./strategy.ts";
 import { udtGet, udtNew, udtRegister, udtSet } from "./udt_runtime.ts";
 
@@ -105,6 +127,8 @@ export function createCompileHelpers(opts?: CompileHelperOpts) {
     na: NA_FN,
     nz,
     naNum,
+    plotNum,
+    timenow,
     isNa: isNaCell,
     eq: pineEq,
     ne: pineNe,
@@ -224,12 +248,41 @@ export function createCompileHelpers(opts?: CompileHelperOpts) {
     udtSet,
     udtRegister,
     currencyRate: resolveCurrencyRate,
+    requestSeed: resolveSeed,
+    requestFootprint: createFootprint,
+    footprint: {
+      buy_volume: footprintBuyVolume,
+      sell_volume: footprintSellVolume,
+      delta: footprintDelta,
+      total_volume: footprintTotalVolume,
+      vah: footprintVah,
+      val: footprintVal,
+      poc: footprintPoc,
+      rows: compileFootprintRows,
+      get_row_by_price: footprintGetRowByPrice,
+      volume_row: {
+        up_price: volumeRowUpPrice,
+        down_price: volumeRowDownPrice,
+        buy_volume: volumeRowBuyVolume,
+        sell_volume: volumeRowSellVolume,
+        delta: volumeRowDelta,
+        total_volume: volumeRowTotalVolume,
+        has_buy_imbalance: volumeRowHasBuyImbalance,
+        has_sell_imbalance: volumeRowHasSellImbalance,
+      },
+    },
     runtimeError(msg: unknown): never {
       throw new Error(String(msg));
     },
   };
 }
 
+function compileFootprintRows(fp: unknown): PineArray {
+  const arr = new PineArray();
+  for (const row of footprintRows(fp)) arr.push(row);
+  return arr;
+}
+
 /** Pine `color.new(color, transp)` — first arg is a color, not r,g,b. */
 function compileColorNew(color: unknown, transp?: unknown) {
   const parsed = asColor(color);
@@ -264,6 +317,23 @@ function iff(cond: unknown, thenV: unknown, elseV: unknown): unknown {
   return mathIff(cond as number | null, thenV as number | null, elseV as number | null);
 }
 
+/** Plot cell: tagged `strategy.cash` unwraps to its number (interpret `unwrap`). */
+function plotNum(v: unknown): number | null {
+  if (isStrategyCashAmount(v)) return Number.isFinite(v.value) ? v.value : null;
+  return naNum(v);
+}
+
+/**
+ * Dataset last-bar time on every bar. Interpret `beginBar` stores that on
+ * `ctx.timenow` (host seed is overwritten). Not wall-clock, not current bar.
+ */
+function timenow(timeArr: unknown): number {
+  if (!Array.isArray(timeArr) || timeArr.length === 0) return 0;
+  const last = timeArr[timeArr.length - 1];
+  if (typeof last === "number" && Number.isFinite(last)) return last;
+  return (timeArr.length - 1) * 60_000;
+}
+
 function NA_FN(v?: unknown): number | null {
   if (arguments.length === 0) return null;
   return isNaCell(v) ? 1 : 0;