@thinkingos/vsl-sdk 0.1.1 → 0.3.0

package/dist/index.mjs

@@ -48,7 +48,13 @@ var CSS_PROPERTIES = [
   ["opacity", "opacity"],
   ["pointerEvents", "pointer-events"],
   ["overflow", "overflow"],
-  ["height", "height"]
+  ["height", "height"],
+  ["backgroundColor", "background-color"],
+  ["color", "color"],
+  ["border", "border"],
+  ["borderRadius", "border-radius"],
+  ["boxShadow", "box-shadow"],
+  ["fontFamily", "font-family"]
 ];
 function captureCss(el) {
   const view = viewOf(el);
@@ -258,14 +264,16 @@ function isAriaHidden(attributes) {
 }
 function segmentOne(el) {
   const { attributes } = el;
+  const isFileInput = el.tag === "input" && attributes["type"] === "file";
   return {
     tag: el.tag,
     indexPath: el.indexPath,
     rect: el.rect,
     attributes,
-    t: resolveLevel1Type(el.tag) ?? resolveAriaRoleType(attributes["role"]) ?? resolveLevel3Type(el.css, attributes),
+    t: isFileInput ? "file_input" : resolveLevel1Type(el.tag) ?? resolveAriaRoleType(attributes["role"]) ?? resolveLevel3Type(el.css, attributes),
     txt: attributes["aria-label"] ?? el.text,
     st: resolveSt(attributes),
+    css: el.css,
     ch: []
   };
 }
@@ -318,6 +326,8 @@ function defaultActions(t, st, attributes) {
       return ["click", "select"];
     case "textarea":
       return ["click", "type", "clear"];
+    case "file_input":
+      return ["click", "upload"];
     default:
       return void 0;
   }
@@ -330,6 +340,39 @@ function baseSemanticScore(el) {
   if (el.txt) score += 1;
   return score;
 }
+function extractVisualStyles(css) {
+  if (!css) return void 0;
+  const style = {};
+  let hasContent = false;
+  if (css.backgroundColor && css.backgroundColor !== "transparent" && !css.backgroundColor.includes("rgba(0, 0, 0, 0)")) {
+    style.bg = css.backgroundColor;
+    hasContent = true;
+  }
+  if (css.color && css.color !== "rgb(0, 0, 0)") {
+    style.fg = css.color;
+    hasContent = true;
+  }
+  if (css.border && css.border !== "none" && !css.border.startsWith("0px")) {
+    style.border = css.border;
+    hasContent = true;
+  }
+  if (css.borderRadius && css.borderRadius !== "0px") {
+    style.radius = css.borderRadius;
+    hasContent = true;
+  }
+  if (css.boxShadow && css.boxShadow !== "none") {
+    style.shadow = css.boxShadow;
+    hasContent = true;
+  }
+  if (css.fontFamily || css.fontSize || css.fontWeight) {
+    style.font = {};
+    if (css.fontFamily) style.font.family = css.fontFamily;
+    if (css.fontSize) style.font.size = css.fontSize;
+    if (css.fontWeight) style.font.weight = css.fontWeight;
+    hasContent = true;
+  }
+  return hasContent ? style : void 0;
+}
 function toVslObject(el, viewport, includedChildren, textBlocks, counter) {
   const t = el.t ?? "container";
   const object = {
@@ -356,6 +399,12 @@ function toVslObject(el, viewport, includedChildren, textBlocks, counter) {
   if (includedChildren.length > 0) object.ch = includedChildren;
   if (el.vf !== void 0) object.vf = el.vf;
   if (el.vf_meta !== void 0) object.vf_meta = el.vf_meta;
+  const sty = extractVisualStyles(el.css);
+  if (sty !== void 0) object.sty = sty;
+  if (t === "file_input") {
+    if (el.attributes["accept"] !== void 0) object.accept = el.attributes["accept"];
+    if (el.attributes["multiple"] !== void 0) object.multiple = true;
+  }
   return object;
 }
 function convert(el, viewport, textBlocks, counter) {
@@ -542,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) {
@@ -678,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) и возвращает полный документ либо дифф (см. шапку).
@@ -686,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
@@ -699,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 = {
@@ -710,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);