@thinkingos/vsl-sdk 0.2.0 → 0.3.1

package/dist/index.mjs

@@ -591,6 +591,8 @@ function objectsEqual(a, b) {
   return computeContentHash(a) === computeContentHash(b) && computeCoordHash(a) === computeCoordHash(b);
 }
 function tuple2Equal(a, b) {
+  if (a === null || a === void 0) return b === null || b === void 0;
+  if (b === null || b === void 0) return false;
   return a[0] === b[0] && a[1] === b[1];
 }
 function stringArrayEqual(a, b) {
@@ -727,6 +729,25 @@ var VslSnapshotSession = class {
   constructor(store = createCacheStore()) {
     this.store = store;
   }
+  /**
+   * Сбрасывает состояние сессии (URL, viewport, документ, версия).
+   * Следующий вызов snapshot() вернёт полный документ (как первый вызов).
+   */
+  clear() {
+    this.store.clear();
+    this.lastUrl = null;
+    this.lastViewport = null;
+    this.lastDocument = null;
+    this.version = 0;
+  }
+  /** Возвращает последний полный документ (не diff). */
+  getLastDocument() {
+    return this.lastDocument;
+  }
+  /** Текущая версия документа (инкрементируется при каждом diff). */
+  getVersion() {
+    return this.version;
+  }
   /**
    * Строит VSL из DOM поддерева root (extractDomTree → segmentTree →
    * buildVslDocument) и возвращает полный документ либо дифф (см. шапку).
@@ -735,6 +756,15 @@ var VslSnapshotSession = class {
     const elements = segmentTree(extractDomTree(root));
     return this.commit(elements, this.buildOptions(root, input), input);
   }
+  /**
+   * Вариант snapshot() для pre-extracted elements (MCP сервер, Node.js контекст).
+   * Принимает ExtractedElement[] напрямую (без DOM Element), проходит тот же
+   * pipeline: segmentTree → buildVslDocument → cache/diff.
+   */
+  snapshotFromElements(extractedElements, input) {
+    const elements = segmentTree(extractedElements);
+    return this.commit(elements, this.buildOptionsFromInput(input), input);
+  }
   /**
    * Vision-вариант конвейера (T1.5.5): segmentTree → enrichWithVision (Level 5
    * fallback — аннотация t + vf/vf_meta на элементах ДО сборки) → buildVslDocument
@@ -748,6 +778,16 @@ var VslSnapshotSession = class {
     const snapshot = this.commit(elements, this.buildOptions(root, input), input);
     return { snapshot, fragments: visionResult.fragments };
   }
+  /**
+   * Vision-вариант для pre-extracted elements (MCP сервер, Node.js контекст).
+   * Полный pipeline: segmentTree → enrichWithVision → buildVslDocument → cache/diff.
+   */
+  async snapshotWithVisionFromElements(extractedElements, input, vision) {
+    const elements = segmentTree(extractedElements);
+    const visionResult = await enrichWithVision(elements, vision);
+    const snapshot = this.commit(elements, this.buildOptionsFromInput(input), input);
+    return { snapshot, fragments: visionResult.fragments };
+  }
   /** BuildOptions из input + портативный title (логика бывшего snapshot()). */
   buildOptions(root, input) {
     const options = {
@@ -759,6 +799,20 @@ var VslSnapshotSession = class {
     if (input.background !== void 0) options.background = input.background;
     return options;
   }
+  /**
+   * BuildOptions из input без DOM Element (для snapshotFromElements).
+   * Title берётся только из input (нет фолбэка на root.ownerDocument.title).
+   */
+  buildOptionsFromInput(input) {
+    const options = {
+      viewport: { width: input.viewport.width, height: input.viewport.height },
+      url: input.url
+    };
+    if (input.title !== void 0) options.title = input.title;
+    if (input.timestamp !== void 0) options.timestamp = input.timestamp;
+    if (input.background !== void 0) options.background = input.background;
+    return options;
+  }
   /** Сборка документа + кэш/дифф (логика бывшего snapshot(), см. шапку модуля). */
   commit(elements, options, input) {
     const nextDocument = buildVslDocument(elements, options);