@thinkingos/vsl-sdk 0.3.1 → 0.4.0

package/dist/index.d.mts

@@ -88,7 +88,7 @@ declare function extractDomTree(root?: Element): ExtractedElement[];
  * Семантический тип объекта VSL (поле `t`): L1-теги + L2-роли (T1.1.3/T1.1.4),
  * L3-CSS (T1.5.1), L4-структурные (T1.5.2), L5-vision (T1.5.4).
  */
-type VslType = 'button' | 'input' | 'file_input' | 'link' | 'nav' | 'header' | 'main' | 'container' | 'image' | 'select' | 'textarea' | 'modal' | 'tab' | 'heading' | 'footer' | 'scrollable_container' | 'toolbar' | 'list' | 'grid' | 'form_field' | 'tab_bar' | 'layout' | 'icon' | 'chart' | 'custom_widget' | 'unknown';
+type VslType = 'button' | 'input' | 'file_input' | 'link' | 'nav' | 'header' | 'main' | 'container' | 'image' | 'select' | 'textarea' | 'modal' | 'tab' | 'dropdown_toggle' | 'heading' | 'footer' | 'scrollable_container' | 'toolbar' | 'list' | 'grid' | 'form_field' | 'tab_bar' | 'layout' | 'icon' | 'chart' | 'custom_widget' | 'unknown';
 /** Состояние объекта VSL (поле `st`) — из ARIA-атрибутов (T1.1.4). */
 type VslState = 'checked' | 'expanded' | 'disabled';
 /** Тип визуального фрагмента — выход классификации vision (§2.2.2 Шаг 2). */
@@ -189,6 +189,8 @@ interface VslObject {
     accept?: string;
     /** Multiple attribute для file_input — разрешена загрузка нескольких файлов. */
     multiple?: boolean;
+    /** Атрибут aria-haspopup — указывает на dropdown/menu (для LLM). */
+    hasPopup?: string;
 }
 interface VslDocument {
     vsl_version: string;
@@ -1097,7 +1099,7 @@ declare const ACTION_TOOL_SCHEMA: {
         action: {
             type: string;
             description: string;
-            enum: ("select" | "type" | "click" | "close" | "check" | "uncheck" | "clear" | "scroll" | "hover" | "focus" | "blur" | "drag" | "drop" | "submit" | "reset" | "open" | "expand" | "collapse" | "wait" | "navigate" | "go_back" | "go_forward" | "refresh" | "download")[];
+            enum: ("select" | "type" | "click" | "expand" | "collapse" | "close" | "check" | "uncheck" | "clear" | "scroll" | "hover" | "focus" | "blur" | "drag" | "drop" | "submit" | "reset" | "open" | "wait" | "navigate" | "go_back" | "go_forward" | "refresh" | "download")[];
         };
         target_id: {
             type: string;

package/dist/index.d.ts

@@ -88,7 +88,7 @@ declare function extractDomTree(root?: Element): ExtractedElement[];
  * Семантический тип объекта VSL (поле `t`): L1-теги + L2-роли (T1.1.3/T1.1.4),
  * L3-CSS (T1.5.1), L4-структурные (T1.5.2), L5-vision (T1.5.4).
  */
-type VslType = 'button' | 'input' | 'file_input' | 'link' | 'nav' | 'header' | 'main' | 'container' | 'image' | 'select' | 'textarea' | 'modal' | 'tab' | 'heading' | 'footer' | 'scrollable_container' | 'toolbar' | 'list' | 'grid' | 'form_field' | 'tab_bar' | 'layout' | 'icon' | 'chart' | 'custom_widget' | 'unknown';
+type VslType = 'button' | 'input' | 'file_input' | 'link' | 'nav' | 'header' | 'main' | 'container' | 'image' | 'select' | 'textarea' | 'modal' | 'tab' | 'dropdown_toggle' | 'heading' | 'footer' | 'scrollable_container' | 'toolbar' | 'list' | 'grid' | 'form_field' | 'tab_bar' | 'layout' | 'icon' | 'chart' | 'custom_widget' | 'unknown';
 /** Состояние объекта VSL (поле `st`) — из ARIA-атрибутов (T1.1.4). */
 type VslState = 'checked' | 'expanded' | 'disabled';
 /** Тип визуального фрагмента — выход классификации vision (§2.2.2 Шаг 2). */
@@ -189,6 +189,8 @@ interface VslObject {
     accept?: string;
     /** Multiple attribute для file_input — разрешена загрузка нескольких файлов. */
     multiple?: boolean;
+    /** Атрибут aria-haspopup — указывает на dropdown/menu (для LLM). */
+    hasPopup?: string;
 }
 interface VslDocument {
     vsl_version: string;
@@ -1097,7 +1099,7 @@ declare const ACTION_TOOL_SCHEMA: {
         action: {
             type: string;
             description: string;
-            enum: ("select" | "type" | "click" | "close" | "check" | "uncheck" | "clear" | "scroll" | "hover" | "focus" | "blur" | "drag" | "drop" | "submit" | "reset" | "open" | "expand" | "collapse" | "wait" | "navigate" | "go_back" | "go_forward" | "refresh" | "download")[];
+            enum: ("select" | "type" | "click" | "expand" | "collapse" | "close" | "check" | "uncheck" | "clear" | "scroll" | "hover" | "focus" | "blur" | "drag" | "drop" | "submit" | "reset" | "open" | "wait" | "navigate" | "go_back" | "go_forward" | "refresh" | "download")[];
         };
         target_id: {
             type: string;

package/dist/index.js

@@ -198,6 +198,13 @@ function resolveAriaRoleType(role) {
   if (!role) return null;
   return ARIA_ROLE_TYPE_MAP[role.toLowerCase()] ?? null;
 }
+function resolveDropdownToggle(attributes) {
+  const hasPopup = attributes["aria-haspopup"];
+  if (hasPopup === "menu" || hasPopup === "listbox") {
+    return "dropdown_toggle";
+  }
+  return null;
+}
 var TRUE = "true";
 function resolveSt(attributes) {
   if (attributes["aria-pressed"] === TRUE) return "checked";
@@ -331,7 +338,7 @@ function segmentOne(el) {
     indexPath: el.indexPath,
     rect: el.rect,
     attributes,
-    t: isFileInput ? "file_input" : resolveLevel1Type(el.tag) ?? resolveAriaRoleType(attributes["role"]) ?? resolveLevel3Type(el.css, attributes),
+    t: isFileInput ? "file_input" : resolveDropdownToggle(attributes) ?? resolveLevel1Type(el.tag) ?? resolveAriaRoleType(attributes["role"]) ?? resolveLevel3Type(el.css, attributes),
     txt: attributes["aria-label"] ?? el.text,
     st: resolveSt(attributes),
     css: el.css,
@@ -377,6 +384,8 @@ function defaultActions(t, st, attributes) {
     case "link":
     case "tab":
       return ["click"];
+    case "dropdown_toggle":
+      return ["click", "expand", "collapse"];
     case "modal":
       return ["close"];
     case "input": {
@@ -466,6 +475,9 @@ function toVslObject(el, viewport, includedChildren, textBlocks, counter) {
     if (el.attributes["accept"] !== void 0) object.accept = el.attributes["accept"];
     if (el.attributes["multiple"] !== void 0) object.multiple = true;
   }
+  if (t === "dropdown_toggle" && el.attributes["aria-haspopup"] !== void 0) {
+    object.hasPopup = el.attributes["aria-haspopup"];
+  }
   return object;
 }
 function convert(el, viewport, textBlocks, counter) {