@baron1996/kline-scene-schema 0.6.0 → 0.9.7

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-/** 场景协议包版本；Scene version 仍保持 1。 */
-export declare const SCENE_PACKAGE_VERSION: "0.6.0";
+/** 场景协议包版本；支持 Scene v1，并以 Scene v2 作为当前版本。 */
+export declare const SCENE_PACKAGE_VERSION: "0.9.7";
 export * from './canonical-json.js';
 export * from './canonicalize.js';
 export * from './decimal-normalization.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,eAAO,MAAM,qBAAqB,EAAG,OAAgB,CAAC;AAEtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mCAAmC,CAAC;AAClD,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AACnF,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,EAAG,OAAgB,CAAC;AAEtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mCAAmC,CAAC;AAClD,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AACnF,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
-/** 场景协议包版本；Scene version 仍保持 1。 */
-export const SCENE_PACKAGE_VERSION = '0.6.0';
+/** 场景协议包版本；支持 Scene v1，并以 Scene v2 作为当前版本。 */
+export const SCENE_PACKAGE_VERSION = '0.9.7';
 export * from './canonical-json.js';
 export * from './canonicalize.js';
 export * from './decimal-normalization.js';

package/dist/semantic-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-validator.d.ts","sourceRoot":"","sources":["../src/semantic-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EAIV,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AA8iB/E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAM9E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAM3D"}
+{"version":3,"file":"semantic-validator.d.ts","sourceRoot":"","sources":["../src/semantic-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EAIV,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAmlB/E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAM9E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAM3D"}

package/dist/semantic-validator.js

@@ -87,6 +87,25 @@ function validateMarketData(scene, issues) {
     if (!scene.data.some((bar) => bar.timestamp === scene.viewport.anchorTimestamp)) {
         issues.push(issue('INVALID_REFERENCE', '/viewport/anchorTimestamp', 'Viewport anchorTimestamp must reference an embedded market-data bar.'));
     }
+    const barTimestamps = new Set(scene.data.map((bar) => bar.timestamp));
+    let previousGapTimestamp = -Infinity;
+    for (let index = 0; index < (scene.gaps?.length ?? 0); index++) {
+        const gap = scene.gaps?.[index];
+        if (gap === undefined) {
+            continue;
+        }
+        const path = `/gaps/${index}`;
+        if (gap.timestamp <= previousGapTimestamp) {
+            issues.push(issue('INVALID_MARKET_DATA', `${path}/timestamp`, 'Market-data Gap timestamps must be strictly increasing.'));
+        }
+        previousGapTimestamp = gap.timestamp;
+        if (gap.barEnd <= gap.timestamp) {
+            issues.push(issue('INVALID_MARKET_DATA', `${path}/barEnd`, 'Market-data Gap barEnd must be greater than timestamp.'));
+        }
+        if (barTimestamps.has(gap.timestamp)) {
+            issues.push(issue('INVALID_MARKET_DATA', `${path}/timestamp`, 'A timestamp cannot contain both a real Bar and a Gap.'));
+        }
+    }
 }
 function validateIndicator(indicator, pane, index, issues) {
     const path = `/panes/${pane.order}/indicators/${index}`;

package/dist/version.d.ts

@@ -1,5 +1,7 @@
 export declare const SCENE_SCHEMA_NAME: "@baron1996/kline-scene";
-export declare const SCENE_SCHEMA_VERSION: 1;
+export declare const LEGACY_SCENE_SCHEMA_VERSION: 1;
+export declare const SCENE_SCHEMA_VERSION: 2;
+export declare const SUPPORTED_SCENE_SCHEMA_VERSIONS: readonly [1, 2];
 export declare const KLINECHARTS_ENGINE_VERSION: "10.0.0";
 export declare const M1_SCENE_RUNTIME_VERSION: "0.1.0";
 export declare const SCENE_RUNTIME_VERSION: "0.2.0";

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,EAAG,wBAAiC,CAAC;AACnE,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAC/C,eAAO,MAAM,0BAA0B,EAAG,QAAiB,CAAC;AAC5D,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC;AACzD,eAAO,MAAM,qBAAqB,EAAG,OAAgB,CAAC;AACtD,eAAO,MAAM,gCAAgC,6BAGnC,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,EAAG,wBAAiC,CAAC;AACnE,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAC;AACtD,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAC/C,eAAO,MAAM,+BAA+B,iBAGlC,CAAC;AACX,eAAO,MAAM,0BAA0B,EAAG,QAAiB,CAAC;AAC5D,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC;AACzD,eAAO,MAAM,qBAAqB,EAAG,OAAgB,CAAC;AACtD,eAAO,MAAM,gCAAgC,6BAGnC,CAAC"}

package/dist/version.js

@@ -1,5 +1,10 @@
 export const SCENE_SCHEMA_NAME = '@baron1996/kline-scene';
-export const SCENE_SCHEMA_VERSION = 1;
+export const LEGACY_SCENE_SCHEMA_VERSION = 1;
+export const SCENE_SCHEMA_VERSION = 2;
+export const SUPPORTED_SCENE_SCHEMA_VERSIONS = [
+    LEGACY_SCENE_SCHEMA_VERSION,
+    SCENE_SCHEMA_VERSION,
+];
 export const KLINECHARTS_ENGINE_VERSION = '10.0.0';
 export const M1_SCENE_RUNTIME_VERSION = '0.1.0';
 export const SCENE_RUNTIME_VERSION = '0.2.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baron1996/kline-scene-schema",
-  "version": "0.6.0",
+  "version": "0.9.7",
   "description": "Strict ChartScene schema, types, validation, and canonical serialization.",
   "type": "module",
   "license": "Apache-2.0",

package/schema/chart-scene.schema.json

@@ -23,7 +23,10 @@
       "const": "@baron1996/kline-scene"
     },
     "version": {
-      "const": 1
+      "enum": [
+        1,
+        2
+      ]
     },
     "runtime": {
       "$ref": "https://baron.dev/kline-scene/runtime.schema.json"
@@ -42,6 +45,13 @@
         "$ref": "https://baron.dev/kline-scene/market-data.schema.json"
       }
     },
+    "gaps": {
+      "type": "array",
+      "maxItems": 1000000,
+      "items": {
+        "$ref": "https://baron.dev/kline-scene/market-data-gap.schema.json"
+      }
+    },
     "chart": {
       "$ref": "https://baron.dev/kline-scene/chart-config.schema.json"
     },
@@ -70,6 +80,33 @@
       "$ref": "https://baron.dev/kline-scene/common.schema.json#/$defs/metadata"
     }
   },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "version": {
+            "const": 1
+          }
+        },
+        "required": [
+          "version"
+        ]
+      },
+      "then": {
+        "properties": {
+          "gaps": false
+        }
+      },
+      "else": {
+        "properties": {
+          "gaps": true
+        },
+        "required": [
+          "gaps"
+        ]
+      }
+    }
+  ],
   "$defs": {
     "symbol": {
       "type": "object",

package/schema/market-data-gap.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://baron.dev/kline-scene/market-data-gap.schema.json",
+  "title": "MarketDataGap",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "timestamp",
+    "barEnd",
+    "classification",
+    "reasonCode",
+    "retryable"
+  ],
+  "properties": {
+    "timestamp": {
+      "$ref": "https://baron.dev/kline-scene/common.schema.json#/$defs/safeInteger"
+    },
+    "barEnd": {
+      "$ref": "https://baron.dev/kline-scene/common.schema.json#/$defs/safeInteger"
+    },
+    "classification": {
+      "enum": [
+        "INSTRUMENT_NOT_TRADABLE",
+        "SOURCE_ERROR",
+        "NO_TRADE",
+        "UNKNOWN_MISSING"
+      ]
+    },
+    "reasonCode": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Z][A-Z0-9_]*$"
+    },
+    "retryable": {
+      "type": "boolean"
+    }
+  }
+}