@tradejs/core 3.1.28-beta.258 → 3.1.29-beta.259

package/dist/grid.mjs

@@ -1,9 +1,9 @@
-import {
-  toJson
-} from "./chunk-OJPHC3S2.mjs";
 import {
   uuid
 } from "./chunk-U3GDILUZ.mjs";
+import {
+  toJson
+} from "./chunk-OJPHC3S2.mjs";
 import {
   getTimestamp
 } from "./chunk-S4KHOAXM.mjs";

package/dist/jev.d.mts

@@ -0,0 +1,21 @@
+import { JevDimension, JevScores, JevConfig, JevFeature, JevTree } from '@tradejs/types';
+
+declare const JEV_DIMENSIONS: JevDimension[];
+declare const JEV_PROVIDERS: readonly [{
+    readonly label: "OpenRouter";
+    readonly endpoint: "https://openrouter.ai/api/alpha/decisions";
+    readonly model: "typesafe/jev-1.13";
+}, {
+    readonly label: "TypeSafe";
+    readonly endpoint: "https://api.typesafe.ai/v1/systemone";
+    readonly model: "jev-1.13.0";
+}];
+declare const normalizeJevEndpoint: (value: unknown) => string;
+declare const parseJevConfig: (value: unknown) => JevConfig | undefined;
+declare const decideJev: (scores: JevScores, config: JevConfig, geometryStatus: "available" | "facts_only" | "absent" | "invalid", features: Record<string, JevFeature> | undefined, questions: JevDimension[]) => {
+    allowed: boolean;
+    reasons: string[];
+};
+declare const predictJevTree: (tree: JevTree, features: Record<string, JevFeature>) => number;
+
+export { JEV_DIMENSIONS, JEV_PROVIDERS, decideJev, normalizeJevEndpoint, parseJevConfig, predictJevTree };

package/dist/jev.d.ts

@@ -0,0 +1,21 @@
+import { JevDimension, JevScores, JevConfig, JevFeature, JevTree } from '@tradejs/types';
+
+declare const JEV_DIMENSIONS: JevDimension[];
+declare const JEV_PROVIDERS: readonly [{
+    readonly label: "OpenRouter";
+    readonly endpoint: "https://openrouter.ai/api/alpha/decisions";
+    readonly model: "typesafe/jev-1.13";
+}, {
+    readonly label: "TypeSafe";
+    readonly endpoint: "https://api.typesafe.ai/v1/systemone";
+    readonly model: "jev-1.13.0";
+}];
+declare const normalizeJevEndpoint: (value: unknown) => string;
+declare const parseJevConfig: (value: unknown) => JevConfig | undefined;
+declare const decideJev: (scores: JevScores, config: JevConfig, geometryStatus: "available" | "facts_only" | "absent" | "invalid", features: Record<string, JevFeature> | undefined, questions: JevDimension[]) => {
+    allowed: boolean;
+    reasons: string[];
+};
+declare const predictJevTree: (tree: JevTree, features: Record<string, JevFeature>) => number;
+
+export { JEV_DIMENSIONS, JEV_PROVIDERS, decideJev, normalizeJevEndpoint, parseJevConfig, predictJevTree };

package/dist/jev.js

@@ -0,0 +1,135 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/jev.ts
+var jev_exports = {};
+__export(jev_exports, {
+  JEV_DIMENSIONS: () => JEV_DIMENSIONS,
+  JEV_PROVIDERS: () => JEV_PROVIDERS,
+  decideJev: () => decideJev,
+  normalizeJevEndpoint: () => normalizeJevEndpoint,
+  parseJevConfig: () => parseJevConfig,
+  predictJevTree: () => predictJevTree
+});
+module.exports = __toCommonJS(jev_exports);
+var JEV_DIMENSIONS = [
+  "trend",
+  "swing",
+  "participation",
+  "setupParticipation",
+  "extension",
+  "confirmation",
+  "setupStrength",
+  "geometry"
+];
+var JEV_PROVIDERS = [
+  {
+    label: "OpenRouter",
+    endpoint: "https://openrouter.ai/api/alpha/decisions",
+    model: "typesafe/jev-1.13"
+  },
+  {
+    label: "TypeSafe",
+    endpoint: "https://api.typesafe.ai/v1/systemone",
+    model: "jev-1.13.0"
+  }
+];
+var normalizeJevEndpoint = (value) => {
+  if (typeof value !== "string" || !value.trim()) return "";
+  try {
+    const url = new URL(value.trim());
+    if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash)
+      return "";
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return "";
+  }
+};
+var parseJevConfig = (value) => {
+  if (value == null || value === false) return void 0;
+  if (typeof value !== "object" || Array.isArray(value))
+    throw new Error("JEV must be a configuration object");
+  const config = value;
+  const keys = /* @__PURE__ */ new Set([
+    "source",
+    "mode",
+    "provider",
+    "recordsDir",
+    "modelFile",
+    "modelSha256"
+  ]);
+  if (Object.keys(config).some((key) => !keys.has(key)))
+    throw new Error("Unknown JEV configuration field");
+  if (!["provider", "recorded", "local"].includes(config.source) || config.mode !== "observe")
+    throw new Error("JEV supports enrichment only (mode: observe)");
+  if (config.provider && (!normalizeJevEndpoint(config.provider.endpoint) || !config.provider.model?.trim() || Object.keys(config.provider).some(
+    (key) => !["endpoint", "model"].includes(key)
+  )))
+    throw new Error("Invalid JEV provider");
+  if (config.provider && /(?:latest|preview)$/i.test(config.provider.model))
+    throw new Error("Pin a versioned Jev model instead of latest or preview");
+  if (config.source === "recorded" && !config.provider)
+    throw new Error("Recorded Jev requires the original endpoint and model");
+  if (config.source === "local" && (!config.modelFile || !/^[a-f0-9]{64}$/.test(config.modelSha256 ?? "")))
+    throw new Error("Local Jev gate requires modelFile and modelSha256");
+  for (const key of ["recordsDir", "modelFile"])
+    if (config[key] != null && (typeof config[key] !== "string" || !config[key]?.trim()))
+      throw new Error(`Invalid JEV ${key}`);
+  return {
+    ...config,
+    ...config.provider ? {
+      provider: {
+        endpoint: normalizeJevEndpoint(config.provider.endpoint),
+        model: config.provider.model.trim()
+      }
+    } : {}
+  };
+};
+var decideJev = (scores, config, geometryStatus, features, questions) => {
+  const reasons = [];
+  if (features?.["signal.validLevels"] === false)
+    reasons.push("INVALID_SIGNAL_LEVELS");
+  if (geometryStatus === "invalid") reasons.push("INVALID_GEOMETRY");
+  if (!questions.length) reasons.push("NO_ELIGIBLE_QUESTIONS");
+  if (config.requireGeometry && (!questions.includes("geometry") || geometryStatus === "absent"))
+    reasons.push("GEOMETRY_UNAVAILABLE");
+  for (const dimension of questions) {
+    const score = scores[dimension];
+    if (score == null || !Number.isFinite(score))
+      reasons.push(`${dimension.toUpperCase()}_UNAVAILABLE`);
+    else if (score < (config.minScores?.[dimension] ?? 0.5))
+      reasons.push(`${dimension.toUpperCase()}_BELOW_MIN`);
+  }
+  return { allowed: reasons.length === 0, reasons };
+};
+var predictJevTree = (tree, features) => {
+  if ("samples" in tree) return tree.value;
+  const value = features[tree.feature];
+  const left = value == null ? tree.missingLeft : tree.operator === "lte" ? typeof value === "number" && value <= tree.value : value === tree.value;
+  return predictJevTree(left ? tree.left : tree.right, features);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  JEV_DIMENSIONS,
+  JEV_PROVIDERS,
+  decideJev,
+  normalizeJevEndpoint,
+  parseJevConfig,
+  predictJevTree
+});

package/dist/jev.mjs

@@ -0,0 +1,105 @@
+// src/jev.ts
+var JEV_DIMENSIONS = [
+  "trend",
+  "swing",
+  "participation",
+  "setupParticipation",
+  "extension",
+  "confirmation",
+  "setupStrength",
+  "geometry"
+];
+var JEV_PROVIDERS = [
+  {
+    label: "OpenRouter",
+    endpoint: "https://openrouter.ai/api/alpha/decisions",
+    model: "typesafe/jev-1.13"
+  },
+  {
+    label: "TypeSafe",
+    endpoint: "https://api.typesafe.ai/v1/systemone",
+    model: "jev-1.13.0"
+  }
+];
+var normalizeJevEndpoint = (value) => {
+  if (typeof value !== "string" || !value.trim()) return "";
+  try {
+    const url = new URL(value.trim());
+    if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash)
+      return "";
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return "";
+  }
+};
+var parseJevConfig = (value) => {
+  if (value == null || value === false) return void 0;
+  if (typeof value !== "object" || Array.isArray(value))
+    throw new Error("JEV must be a configuration object");
+  const config = value;
+  const keys = /* @__PURE__ */ new Set([
+    "source",
+    "mode",
+    "provider",
+    "recordsDir",
+    "modelFile",
+    "modelSha256"
+  ]);
+  if (Object.keys(config).some((key) => !keys.has(key)))
+    throw new Error("Unknown JEV configuration field");
+  if (!["provider", "recorded", "local"].includes(config.source) || config.mode !== "observe")
+    throw new Error("JEV supports enrichment only (mode: observe)");
+  if (config.provider && (!normalizeJevEndpoint(config.provider.endpoint) || !config.provider.model?.trim() || Object.keys(config.provider).some(
+    (key) => !["endpoint", "model"].includes(key)
+  )))
+    throw new Error("Invalid JEV provider");
+  if (config.provider && /(?:latest|preview)$/i.test(config.provider.model))
+    throw new Error("Pin a versioned Jev model instead of latest or preview");
+  if (config.source === "recorded" && !config.provider)
+    throw new Error("Recorded Jev requires the original endpoint and model");
+  if (config.source === "local" && (!config.modelFile || !/^[a-f0-9]{64}$/.test(config.modelSha256 ?? "")))
+    throw new Error("Local Jev gate requires modelFile and modelSha256");
+  for (const key of ["recordsDir", "modelFile"])
+    if (config[key] != null && (typeof config[key] !== "string" || !config[key]?.trim()))
+      throw new Error(`Invalid JEV ${key}`);
+  return {
+    ...config,
+    ...config.provider ? {
+      provider: {
+        endpoint: normalizeJevEndpoint(config.provider.endpoint),
+        model: config.provider.model.trim()
+      }
+    } : {}
+  };
+};
+var decideJev = (scores, config, geometryStatus, features, questions) => {
+  const reasons = [];
+  if (features?.["signal.validLevels"] === false)
+    reasons.push("INVALID_SIGNAL_LEVELS");
+  if (geometryStatus === "invalid") reasons.push("INVALID_GEOMETRY");
+  if (!questions.length) reasons.push("NO_ELIGIBLE_QUESTIONS");
+  if (config.requireGeometry && (!questions.includes("geometry") || geometryStatus === "absent"))
+    reasons.push("GEOMETRY_UNAVAILABLE");
+  for (const dimension of questions) {
+    const score = scores[dimension];
+    if (score == null || !Number.isFinite(score))
+      reasons.push(`${dimension.toUpperCase()}_UNAVAILABLE`);
+    else if (score < (config.minScores?.[dimension] ?? 0.5))
+      reasons.push(`${dimension.toUpperCase()}_BELOW_MIN`);
+  }
+  return { allowed: reasons.length === 0, reasons };
+};
+var predictJevTree = (tree, features) => {
+  if ("samples" in tree) return tree.value;
+  const value = features[tree.feature];
+  const left = value == null ? tree.missingLeft : tree.operator === "lte" ? typeof value === "number" && value <= tree.value : value === tree.value;
+  return predictJevTree(left ? tree.left : tree.right, features);
+};
+export {
+  JEV_DIMENSIONS,
+  JEV_PROVIDERS,
+  decideJev,
+  normalizeJevEndpoint,
+  parseJevConfig,
+  predictJevTree
+};

package/dist/strategies.js

@@ -11926,15 +11926,20 @@ var buildStrategySignal = ({
   additionalIndicators,
   isConfigFromBacktest
 }) => {
+  const jevEvidence = additionalIndicators?.jevEvidence;
+  const strategyAdditionalIndicators = jevEvidence != null && additionalIndicators ? copyEnumerableDataPropertiesExcept(
+    additionalIndicators,
+    /* @__PURE__ */ new Set(["jevEvidence"])
+  ) : additionalIndicators;
   const indicatorsRecord = indicators && typeof indicators === "object" ? indicators : {};
   const baseContext = indicatorsRecord.baseContext;
   const normalizedIndicators = baseContext == null ? indicators : copyEnumerableDataPropertiesExcept(
     indicatorsRecord,
     /* @__PURE__ */ new Set(["baseContext"])
   );
-  const mergedAdditionalIndicators = baseContext == null ? additionalIndicators : {
-    ...additionalIndicators ?? {},
-    baseContext: additionalIndicators?.baseContext ?? baseContext
+  const mergedAdditionalIndicators = baseContext == null ? strategyAdditionalIndicators : {
+    ...strategyAdditionalIndicators,
+    baseContext: strategyAdditionalIndicators?.baseContext ?? baseContext
   };
   const normalizedAdditionalIndicators = normalizeAdditionalIndicatorsBaseContext(
     mergedAdditionalIndicators,
@@ -11952,6 +11957,7 @@ var buildStrategySignal = ({
     prices,
     indicators: normalizedIndicators,
     additionalIndicators: normalizedAdditionalIndicators,
+    ...jevEvidence != null ? { jevEvidence } : {},
     isConfigFromBacktest
   };
 };

package/dist/strategies.mjs

@@ -1187,15 +1187,20 @@ var buildStrategySignal = ({
   additionalIndicators,
   isConfigFromBacktest
 }) => {
+  const jevEvidence = additionalIndicators?.jevEvidence;
+  const strategyAdditionalIndicators = jevEvidence != null && additionalIndicators ? copyEnumerableDataPropertiesExcept(
+    additionalIndicators,
+    /* @__PURE__ */ new Set(["jevEvidence"])
+  ) : additionalIndicators;
   const indicatorsRecord = indicators && typeof indicators === "object" ? indicators : {};
   const baseContext = indicatorsRecord.baseContext;
   const normalizedIndicators = baseContext == null ? indicators : copyEnumerableDataPropertiesExcept(
     indicatorsRecord,
     /* @__PURE__ */ new Set(["baseContext"])
   );
-  const mergedAdditionalIndicators = baseContext == null ? additionalIndicators : {
-    ...additionalIndicators ?? {},
-    baseContext: additionalIndicators?.baseContext ?? baseContext
+  const mergedAdditionalIndicators = baseContext == null ? strategyAdditionalIndicators : {
+    ...strategyAdditionalIndicators,
+    baseContext: strategyAdditionalIndicators?.baseContext ?? baseContext
   };
   const normalizedAdditionalIndicators = normalizeAdditionalIndicatorsBaseContext(
     mergedAdditionalIndicators,
@@ -1213,6 +1218,7 @@ var buildStrategySignal = ({
     prices,
     indicators: normalizedIndicators,
     additionalIndicators: normalizedAdditionalIndicators,
+    ...jevEvidence != null ? { jevEvidence } : {},
     isConfigFromBacktest
   };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/core",
-  "version": "3.1.28-beta.258",
+  "version": "3.1.29-beta.259",
   "description": "MIT-licensed browser-safe API for TradeJS config, strategy authoring, figures, and shared helpers.",
   "keywords": [
     "tradejs",
@@ -129,10 +129,15 @@
       "types": "./dist/time.d.ts",
       "import": "./dist/time.mjs",
       "require": "./dist/time.js"
+    },
+    "./jev": {
+      "types": "./dist/jev.d.ts",
+      "import": "./dist/jev.mjs",
+      "require": "./dist/jev.js"
     }
   },
   "dependencies": {
-    "@tradejs/types": "^3.1.28-beta.258",
+    "@tradejs/types": "^3.1.29-beta.259",
     "date-fns": "^3.6.0",
     "fast-technical-indicators": "^1.1.4",
     "klinecharts": "10.0.0-alpha9",