@vortexm/vjt 0.1.7 → 0.1.9

package/dist/index.js

@@ -4154,6 +4154,32 @@ function readPath(target, path) {
   }
   return current;
 }
+function writePath(target, path, value) {
+  if (!isPlainObject2(target) || path.length === 0) {
+    return false;
+  }
+  let current = target;
+  for (let index = 0; index < path.length - 1; index += 1) {
+    const segment = path[index];
+    if (isBlockedObjectKey(segment)) {
+      return false;
+    }
+    const next = current[segment];
+    if (isPlainObject2(next)) {
+      current = next;
+      continue;
+    }
+    const created = {};
+    current[segment] = created;
+    current = created;
+  }
+  const leaf = path[path.length - 1];
+  if (isBlockedObjectKey(leaf)) {
+    return false;
+  }
+  current[leaf] = value;
+  return true;
+}
 function sanitizeIdFragment(value) {
   return value.replace(/[^A-Za-z0-9_-]/g, "");
 }
@@ -4273,8 +4299,9 @@ var ReferenceRuntime = class {
   }
   resolveCurrentReference(reference, currentValue) {
     if (this.isListElementContext(currentValue)) {
+      const resolvedDescriptor = this.resolveListDescriptorNode(currentValue.descriptor, currentValue);
       const firstPart = reference.split(".")[0];
-      const namedNode = this.findNamedWidget(currentValue.descriptor, firstPart);
+      const namedNode = this.findNamedWidget(resolvedDescriptor, firstPart, currentValue);
       if (namedNode) {
         const widgetKey = this.host.resolveItemNodeKey(namedNode, currentValue.listId, currentValue.index, `named.${firstPart}`);
         const state = this.host.ensureWidgetState(namedNode, widgetKey);
@@ -4285,12 +4312,16 @@ var ReferenceRuntime = class {
       if (directDescriptorValue !== void 0) {
         return directDescriptorValue;
       }
-      if (typeof currentValue.descriptor.widget === "string") {
-        const descriptorKey = this.host.resolveItemNodeKey(currentValue.descriptor, currentValue.listId, currentValue.index, "item");
-        const descriptorState = this.host.ensureWidgetState(currentValue.descriptor, descriptorKey);
+      const resolvedDescriptorValue = resolvedDescriptor !== currentValue.descriptor ? readPath(resolvedDescriptor, reference.split(".")) : void 0;
+      if (resolvedDescriptorValue !== void 0) {
+        return resolvedDescriptorValue;
+      }
+      if (typeof resolvedDescriptor.widget === "string") {
+        const descriptorKey = this.host.resolveItemNodeKey(resolvedDescriptor, currentValue.listId, currentValue.index, "item");
+        const descriptorState = this.host.ensureWidgetState(resolvedDescriptor, descriptorKey);
         return this.readWidgetField(descriptorState, reference);
       }
-      return readPath(currentValue.descriptor, reference.split("."));
+      return readPath(resolvedDescriptor, reference.split("."));
     }
     if (isPlainObject2(currentValue) || Array.isArray(currentValue)) {
       return readPath(currentValue, reference.split("."));
@@ -4335,6 +4366,8 @@ var ReferenceRuntime = class {
         return state.isHidden ?? true;
       case "url":
         return state.url ?? "";
+      case "base64":
+        return state.base64 ?? "";
       case "elements":
         if (state.widget === "list") {
           return (state.elements ?? []).map((descriptor, index) => ({
@@ -4374,8 +4407,12 @@ var ReferenceRuntime = class {
         return readPath(state, field.split("."));
     }
   }
-  assignReference(reference, inputValue, _currentValue, options) {
-    if (reference.startsWith("current.") || hasBlockedReferenceSegment(reference)) {
+  assignReference(reference, inputValue, currentValue, options) {
+    if (hasBlockedReferenceSegment(reference)) {
+      return;
+    }
+    if (reference.startsWith("current.")) {
+      this.assignCurrentReference(reference.slice(8), inputValue, currentValue);
       return;
     }
     if (reference.startsWith("cookies.")) {
@@ -4418,6 +4455,9 @@ var ReferenceRuntime = class {
       case "url":
         state.url = stringifyReferenceValue(inputValue);
         break;
+      case "base64":
+        state.base64 = stringifyReferenceValue(inputValue);
+        break;
       case "condition":
         state.condition = Boolean(inputValue);
         break;
@@ -4443,6 +4483,19 @@ var ReferenceRuntime = class {
         break;
     }
   }
+  assignCurrentReference(reference, inputValue, currentValue) {
+    const path = reference.split(".").filter(Boolean);
+    if (path.length === 0) {
+      return;
+    }
+    if (this.isListElementContext(currentValue)) {
+      writePath(currentValue.descriptor, path, inputValue);
+      return;
+    }
+    if (isPlainObject2(currentValue)) {
+      writePath(currentValue, path, inputValue);
+    }
+  }
   clearListElementState(listKey) {
     const generatedPrefix = `${sanitizeIdFragment(listKey)}Element`;
     for (const key of Array.from(this.host.stateByKey.keys())) {
@@ -4493,7 +4546,7 @@ var ReferenceRuntime = class {
   isListElementContext(value) {
     return isPlainObject2(value) && value.kind === "list-element" && typeof value.listId === "string" && typeof value.index === "number" && isPlainObject2(value.descriptor) && typeof value.descriptor.widget === "string";
   }
-  findNamedWidget(node, name) {
+  findNamedWidget(node, name, currentValue) {
     if (!node) {
       return null;
     }
@@ -4502,12 +4555,12 @@ var ReferenceRuntime = class {
     }
     switch (node.widget) {
       case "adaptive-layout":
-        return this.findNamedWidget(node.desktop, name) ?? this.findNamedWidget(node.mobile, name);
+        return this.findNamedWidget(node.desktop, name, currentValue) ?? this.findNamedWidget(node.mobile, name, currentValue);
       case "container-layout":
         if (node.type === "grid") {
           for (const row of node.grid?.rows ?? []) {
             for (const column of row.columns ?? []) {
-              const match = this.findNamedWidget(column.child, name);
+              const match = this.findNamedWidget(column.child, name, currentValue);
               if (match) {
                 return match;
               }
@@ -4516,20 +4569,20 @@ var ReferenceRuntime = class {
           return null;
         }
         for (const cell of node.children ?? []) {
-          const match = this.findNamedWidget(cell.child, name);
+          const match = this.findNamedWidget(cell.child, name, currentValue);
           if (match) {
             return match;
           }
         }
         return null;
       case "panel":
-        return this.findNamedWidget(node.child, name);
+        return this.findNamedWidget(node.child, name, currentValue);
       case "conditional-container":
-        return this.findNamedWidget(node.default, name) ?? this.findNamedWidget(node.alternative, name);
+        return this.findNamedWidget(node.default, name, currentValue) ?? this.findNamedWidget(node.alternative, name, currentValue);
       case "list":
       case "grid-view":
         for (const element of node.elements ?? []) {
-          const match = this.findNamedWidget(element, name);
+          const match = this.findNamedWidget(element, name, currentValue);
           if (match) {
             return match;
           }
@@ -4537,7 +4590,7 @@ var ReferenceRuntime = class {
         return null;
       case "overlay-container":
         for (const layer of node.layers ?? []) {
-          const match = this.findNamedWidget(layer.child, name);
+          const match = this.findNamedWidget(layer.child, name, currentValue);
           if (match) {
             return match;
           }
@@ -4545,20 +4598,40 @@ var ReferenceRuntime = class {
         return null;
       case "tabs":
         for (const tab of node.tabs ?? []) {
-          const match = this.findNamedWidget(tab.content, name);
+          const match = this.findNamedWidget(tab.content, name, currentValue);
           if (match) {
             return match;
           }
         }
         return null;
       case "spoiler":
-        return typeof node.content === "string" ? null : this.findNamedWidget(node.content, name);
+        return typeof node.content === "string" ? null : this.findNamedWidget(node.content, name, currentValue);
+      case "ui-reference": {
+        const referenced = currentValue ? this.resolveUiReferenceNode(node, currentValue) : null;
+        return referenced ? this.findNamedWidget(referenced, name, currentValue) : null;
+      }
       case "modal-window":
-        return this.findNamedWidget(node.child, name);
+        return this.findNamedWidget(node.child, name, currentValue);
       default:
         return null;
     }
   }
+  resolveListDescriptorNode(node, currentValue) {
+    if (node.widget !== "ui-reference") {
+      return node;
+    }
+    return this.resolveUiReferenceNode(node, currentValue) ?? node;
+  }
+  resolveUiReferenceNode(node, currentValue) {
+    if (node.widget !== "ui-reference") {
+      return null;
+    }
+    const resolvedValue = typeof node.ref === "string" && node.ref.startsWith("$ref:") ? this.resolveReference(node.ref.slice(5), currentValue, null) : node.ref;
+    if (typeof resolvedValue !== "string" || resolvedValue.length === 0) {
+      return null;
+    }
+    return this.host.getUiResource(resolvedValue);
+  }
 };
 
 // src/lib/action-runtime.ts
@@ -4577,9 +4650,14 @@ var ActionRuntime = class {
   assignReference;
   resolveMappedValue;
   setWidgetEnabled;
+  setWidgetVisible;
   clearWidget;
   clearListElementState;
   focusWidget;
+  moveCursorToEnd;
+  scrollWidgetToTop;
+  scrollWidgetToBottom;
+  scrollWidgetToElementByIndex;
   playAudio;
   stopPlaying;
   copyToClipboard;
@@ -4614,9 +4692,14 @@ var ActionRuntime = class {
     this.assignReference = options.assignReference;
     this.resolveMappedValue = options.resolveMappedValue;
     this.setWidgetEnabled = options.setWidgetEnabled;
+    this.setWidgetVisible = options.setWidgetVisible;
     this.clearWidget = options.clearWidget;
     this.clearListElementState = options.clearListElementState;
     this.focusWidget = options.focusWidget;
+    this.moveCursorToEnd = options.moveCursorToEnd;
+    this.scrollWidgetToTop = options.scrollWidgetToTop;
+    this.scrollWidgetToBottom = options.scrollWidgetToBottom;
+    this.scrollWidgetToElementByIndex = options.scrollWidgetToElementByIndex;
     this.playAudio = options.playAudio;
     this.stopPlaying = options.stopPlaying;
     this.copyToClipboard = options.copyToClipboard;
@@ -4678,7 +4761,7 @@ var ActionRuntime = class {
       let output = rawOutput;
       if (action.andThen?.length) {
         if (output !== null && output !== void 0) {
-          output = await this.runActions(action.andThen, output, { ...context, currentValue: output });
+          output = await this.runActions(action.andThen, output, context);
         } else {
           output = null;
         }
@@ -4765,7 +4848,7 @@ var ActionRuntime = class {
       return null;
     }
     if (name === "startListening") {
-      await this.startListening();
+      await this.startListening(action.args);
       return null;
     }
     if (name === "stopListening") {
@@ -4809,6 +4892,14 @@ var ActionRuntime = class {
       this.setWidgetEnabled(name.slice(8), false);
       return null;
     }
+    if (name.startsWith("makeVisible ")) {
+      this.setWidgetVisible(name.slice(12), true);
+      return null;
+    }
+    if (name.startsWith("makeInvisible ")) {
+      this.setWidgetVisible(name.slice(14), false);
+      return null;
+    }
     if (name.startsWith("clear ")) {
       this.clearWidget(name.slice(6));
       return null;
@@ -4817,6 +4908,22 @@ var ActionRuntime = class {
       this.focusWidget(name.slice(9));
       return null;
     }
+    if (name.startsWith("moveCursorToEnd ")) {
+      this.moveCursorToEnd(name.slice(16));
+      return null;
+    }
+    if (name.startsWith("scrollToTop ")) {
+      this.scrollWidgetToTop(name.slice(12));
+      return inputValue;
+    }
+    if (name.startsWith("scrollToBottom ")) {
+      this.scrollWidgetToBottom(name.slice(15));
+      return inputValue;
+    }
+    if (name.startsWith("scrollToElementByIndex ")) {
+      this.scrollWidgetToElementByIndex(name.slice(23), inputValue);
+      return inputValue;
+    }
     if (name.startsWith("setUi ")) {
       const widgetId = name.slice(6);
       const resourceRef = typeof inputValue === "string" ? inputValue : "";
@@ -4827,14 +4934,62 @@ var ActionRuntime = class {
     }
     if (name.startsWith("get ")) {
       const reference = name.slice(4);
-      if (Array.isArray(context.currentValue) && this.isCurrentScopedReference(reference)) {
-        return context.currentValue.map((entry) => this.resolveReference(reference, entry, context.responseValue)).filter((entry) => entry !== null && entry !== void 0);
+      if (Array.isArray(inputValue) && this.isCurrentScopedReference(reference)) {
+        return inputValue.map((entry) => this.resolveReference(reference, entry, context.responseValue)).filter((entry) => entry !== null && entry !== void 0);
       }
       return this.resolveReference(reference, context.currentValue, context.responseValue);
     }
+    if (name.startsWith("count ")) {
+      return this.countValue(this.resolveReference(name.slice(6), context.currentValue, context.responseValue));
+    }
+    if (name === "indexOf") {
+      if (isListElementLike(context.currentValue)) {
+        return context.currentValue.index;
+      }
+      if (typeof context.currentIndex === "number") {
+        return context.currentIndex;
+      }
+      return null;
+    }
+    if (name === "foreach") {
+      if (Array.isArray(inputValue) && action.andThen?.length) {
+        const currentList = inputValue;
+        for (let index = 0; index < currentList.length; index += 1) {
+          const entry = currentList[index];
+          await this.runActions(action.andThen, entry, {
+            ...context,
+            currentValue: entry,
+            currentList,
+            currentIndex: index
+          });
+        }
+      }
+      return inputValue;
+    }
+    if (name === "inc") {
+      return this.toNumber(inputValue) + 1;
+    }
+    if (name === "dec") {
+      return this.toNumber(inputValue) - 1;
+    }
     if (name.startsWith("equals ")) {
       return this.resolveReference(name.slice(7), context.currentValue, context.responseValue) === action.args;
     }
+    if (name.startsWith("greaterThan ")) {
+      return this.toNumber(inputValue) > this.toNumber(this.resolveReference(name.slice(12), context.currentValue, context.responseValue));
+    }
+    if (name.startsWith("greaterThanOrEquals ")) {
+      return this.toNumber(inputValue) >= this.toNumber(this.resolveReference(name.slice(20), context.currentValue, context.responseValue));
+    }
+    if (name.startsWith("lessThan ")) {
+      return this.toNumber(inputValue) < this.toNumber(this.resolveReference(name.slice(9), context.currentValue, context.responseValue));
+    }
+    if (name.startsWith("lessThanOrEquals ")) {
+      return this.toNumber(inputValue) <= this.toNumber(this.resolveReference(name.slice(17), context.currentValue, context.responseValue));
+    }
+    if (name.startsWith("and ")) {
+      return Boolean(inputValue) && Boolean(this.resolveReference(name.slice(4), context.currentValue, context.responseValue));
+    }
     if (name.startsWith("isEmpty ")) {
       return this.isEmptyReference(name.slice(8), context.currentValue, context.responseValue);
     }
@@ -4852,8 +5007,8 @@ var ActionRuntime = class {
     }
     if (name.startsWith("filter ")) {
       const reference = name.slice(7);
-      if (Array.isArray(context.currentValue) && this.isCurrentScopedReference(reference)) {
-        return context.currentValue.filter((entry) => this.resolveReference(reference, entry, context.responseValue));
+      if (Array.isArray(inputValue) && this.isCurrentScopedReference(reference)) {
+        return inputValue.filter((entry) => this.resolveReference(reference, entry, context.responseValue));
       }
       const value = this.resolveReference(reference, context.currentValue, context.responseValue);
       return value ? inputValue : null;
@@ -4878,6 +5033,12 @@ var ActionRuntime = class {
         this.clearListElementState(listState.key);
         return listState.elements;
       }
+      const inputListState = this.asListWidgetState(inputValue);
+      if (inputListState && Array.isArray(inputListState.elements)) {
+        inputListState.elements.push(valueToAdd);
+        this.clearListElementState(inputListState.key);
+        return inputListState.elements;
+      }
       if (context.currentList && typeof context.currentIndex === "number") {
         return context.currentIndex === context.currentList.length - 1 ? [this.unwrapListValue(inputValue), valueToAdd] : this.unwrapListValue(inputValue);
       }
@@ -4902,6 +5063,12 @@ var ActionRuntime = class {
           return listState.elements;
         }
       }
+      const inputListState = this.asListWidgetState(inputValue);
+      if (inputListState && Array.isArray(inputListState.elements)) {
+        inputListState.elements.push(valueToInsert);
+        this.clearListElementState(inputListState.key);
+        return inputListState.elements;
+      }
       if (context.currentList && typeof context.currentIndex === "number") {
         return [this.unwrapListValue(inputValue), valueToInsert];
       }
@@ -4916,10 +5083,10 @@ var ActionRuntime = class {
       return inputValue;
     }
     if (name === "map") {
-      if (Array.isArray(context.currentValue)) {
-        return context.currentValue.map((entry) => this.resolveMappedValue(action.args, entry, context.responseValue));
+      if (Array.isArray(inputValue)) {
+        return inputValue.map((entry) => this.resolveMappedValue(action.args, entry, context.responseValue));
       }
-      return this.resolveMappedValue(action.args, context.currentValue, context.responseValue);
+      return this.resolveMappedValue(action.args, inputValue, context.responseValue);
     }
     if (name === "ifelse") {
       const branches = isIfElseArgs(action.args) ? action.args : null;
@@ -4964,6 +5131,46 @@ var ActionRuntime = class {
   isCurrentScopedReference(reference) {
     return reference === "current" || reference.startsWith("current.") || reference.startsWith("this.") || reference === "this";
   }
+  countValue(value) {
+    if (Array.isArray(value) || typeof value === "string") {
+      return value.length;
+    }
+    if (value && typeof value === "object") {
+      const widgetState = value;
+      if (widgetState.widget === "list" || widgetState.widget === "grid-view") {
+        return Array.isArray(widgetState.elements) ? widgetState.elements.length : 0;
+      }
+      if (widgetState.widget === "listbox") {
+        return Array.isArray(widgetState.listboxElements) ? widgetState.listboxElements.length : 0;
+      }
+      if (widgetState.widget === "combobox") {
+        return Array.isArray(widgetState.comboboxElements) ? widgetState.comboboxElements.length : 0;
+      }
+      if ("length" in widgetState && typeof widgetState.length === "number") {
+        return widgetState.length;
+      }
+    }
+    return 0;
+  }
+  toNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+      return value;
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+      const parsed = Number.parseFloat(value);
+      if (Number.isFinite(parsed)) {
+        return parsed;
+      }
+    }
+    return 0;
+  }
+  asListWidgetState(value) {
+    if (!value || typeof value !== "object") {
+      return null;
+    }
+    const state = value;
+    return state.widget === "list" || state.widget === "grid-view" ? state : null;
+  }
 };
 function isIfElseArgs(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -5393,7 +5600,7 @@ var MAX_CONCURRENT_PLAYERS = 5;
 var MAX_RECORDING_MS = 10 * 60 * 1e3;
 var MAX_LISTENING_SILENCE_MS = 60 * 60 * 1e3;
 var SILENCE_STOP_MS = 2e3;
-var SPEECH_THRESHOLD = 0.035;
+var DEFAULT_SPEECH_THRESHOLD = 0.035;
 var RECORDING_MIME_CANDIDATES = [
   "audio/webm;codecs=opus",
   "audio/webm",
@@ -5446,6 +5653,21 @@ function blobToBase64(blob) {
     reader.readAsDataURL(blob);
   });
 }
+function normalizeSpeechThreshold(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return Math.max(0, Math.min(1, value));
+  }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number.parseFloat(value);
+    if (Number.isFinite(parsed)) {
+      return Math.max(0, Math.min(1, parsed));
+    }
+  }
+  return DEFAULT_SPEECH_THRESHOLD;
+}
+function isStartListeningArgs(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 var VoiceRuntime = class {
   debugLogging;
   triggerSystemEvent;
@@ -5542,11 +5764,12 @@ var VoiceRuntime = class {
     this.clearRecordingTimeout();
     this.mediaRecorder.stop();
   }
-  async startListening() {
+  async startListening(args) {
     if (this.listening) {
       return;
     }
     try {
+      const silenceThreshold = isStartListeningArgs(args) ? normalizeSpeechThreshold(args.silenceThreshold) : DEFAULT_SPEECH_THRESHOLD;
       const stream = await this.ensureInputStream();
       const context = new AudioContext();
       const analyser = context.createAnalyser();
@@ -5573,7 +5796,7 @@ var VoiceRuntime = class {
         }
         const rms = Math.sqrt(squareSum / sampleBuffer.length);
         const now = performance.now();
-        if (rms >= SPEECH_THRESHOLD) {
+        if (rms >= silenceThreshold) {
           this.lastSpeechAt = now;
           this.listeningStartedAt = now;
           if (!this.speechEventTriggered) {
@@ -5595,6 +5818,9 @@ var VoiceRuntime = class {
           void step();
         });
       };
+      logRuntimeDebug(this.debugLogging, "voice-listening-started", {
+        silenceThreshold
+      });
       void step();
     } catch (error) {
       await this.handleListeningError(error);
@@ -6010,7 +6236,7 @@ var renderGridView = (env, node, state, key) => {
         index: realIndex,
         descriptor: element
       };
-      return `<div class="vjt-grid-cell">${env.renderNode(element, `${key}.elements.${realIndex}`, context)}</div>`;
+      return `<div class="vjt-grid-cell" data-list-id="${env.escapeHtml(key)}" data-list-index="${realIndex}">${env.renderNode(element, `${key}.elements.${realIndex}`, context)}</div>`;
     }).join("");
     rows.push(`<div class="vjt-grid-row">${rowMarkup}</div>`);
   }
@@ -6056,13 +6282,13 @@ var renderCombobox = (env, node, state, key) => {
 var HEADING_TAGS = /* @__PURE__ */ new Set(["h1", "h2", "h3", "h4", "h5", "h6"]);
 var TEXT_ALIGN_MAP = { left: "left", center: "center", right: "right" };
 var VERTICAL_ALIGN_MAP = { top: "flex-start", center: "center", bottom: "flex-end" };
-var renderStaticText = (env, node, state, key) => {
+var renderStaticText = (env, node, state, key, _path, itemContext) => {
   const resolvedHeading = node.heading && HEADING_TAGS.has(node.heading) ? node.heading : null;
   const tag = resolvedHeading ?? "div";
   const align = TEXT_ALIGN_MAP[node["horiz-align"] ?? "left"];
   const verticalAlign = VERTICAL_ALIGN_MAP[node["vert-align"] ?? "center"];
   const common = state.id ? ` id="${env.escapeHtml(state.id)}"` : "";
-  const text = env.escapeHtml(env.resolveI18nValue(state.text ?? node.text));
+  const text = env.escapeHtml(env.resolveTextValue(state.text ?? node.text, itemContext));
   const inlineStyle = [
     "display:flex",
     `align-items:${verticalAlign}`,
@@ -6093,11 +6319,11 @@ var markdownConverter = new import_showdown.default.Converter({
   strikethrough: false,
   tasklists: false
 });
-var renderMdText = (env, node, state, key) => {
+var renderMdText = (env, node, state, key, _path, itemContext) => {
   const align = TEXT_ALIGN_MAP2[node["horiz-align"] ?? "left"];
   const verticalAlign = VERTICAL_ALIGN_MAP2[node["vert-align"] ?? "center"];
   const common = state.id ? ` id="${env.escapeHtml(state.id)}"` : "";
-  const markdown = env.resolveI18nValue(state.text ?? node.text);
+  const markdown = env.resolveTextValue(state.text ?? node.text, itemContext);
   const html = sanitizeGeneratedHtml(markdownConverter.makeHtml(sanitizeMarkdownSource(markdown)));
   const inlineStyle = [
     "display:flex",
@@ -6119,24 +6345,24 @@ var renderMdText = (env, node, state, key) => {
 };
 
 // src/lib/widgets/edit.ts
-function resolvePlaceholder(env, node, statePlaceholder) {
+function resolvePlaceholder(env, node, itemContext, statePlaceholder) {
   if (statePlaceholder) {
-    return env.resolveI18nValue(statePlaceholder);
+    return env.resolveTextValue(statePlaceholder, itemContext);
   }
   if (node.placeholder) {
-    return env.resolveI18nValue(node.placeholder);
+    return env.resolveTextValue(node.placeholder, itemContext);
   }
   if ((node.type ?? "string") === "date") {
     return env.getDateFormat(node);
   }
   return "";
 }
-var renderEdit = (env, node, state, key) => {
+var renderEdit = (env, node, state, key, _path, itemContext) => {
   const common = state.id ? ` id="${env.escapeHtml(state.id)}"` : "";
   const enabled = state.enabled ?? env.normalizeBoolean(node.enabled, true);
   const editable = state.editable ?? env.normalizeBoolean(node.editable, true);
-  const placeholder = env.escapeHtml(resolvePlaceholder(env, node, state.placeholder));
-  const value = env.escapeHtml(env.resolveI18nValue(state.text ?? node.text));
+  const placeholder = env.escapeHtml(resolvePlaceholder(env, node, itemContext, state.placeholder));
+  const value = env.escapeHtml(env.resolveTextValue(state.text ?? node.text, itemContext));
   const inputType = node.type === "password" ? "password" : "text";
   const disabledAttribute = enabled ? "" : " disabled";
   const readonlyAttribute = editable ? "" : " readonly";
@@ -6159,23 +6385,23 @@ var renderEdit = (env, node, state, key) => {
 };
 
 // src/lib/widgets/textarea.ts
-var renderTextarea = (env, node, state, key) => {
+var renderTextarea = (env, node, state, key, _path, itemContext) => {
   const common = state.id ? ` id="${env.escapeHtml(state.id)}"` : "";
   const enabled = state.enabled ?? env.normalizeBoolean(node.enabled, true);
   const editable = state.editable ?? env.normalizeBoolean(node.editable, true);
-  const placeholder = env.escapeHtml(env.resolveI18nValue(state.placeholder ?? node.placeholder));
-  const value = env.escapeHtml(state.text ?? env.resolveI18nValue(node.text));
+  const placeholder = env.escapeHtml(env.resolveTextValue(state.placeholder ?? node.placeholder, itemContext));
+  const value = env.escapeHtml(state.text ?? env.resolveTextValue(node.text, itemContext));
   const styleString = env.buildStyleString(node);
   const styleAttribute = styleString ? ` style="${env.escapeHtml(styleString)}"` : "";
   return `<textarea${common}${env.buildWidgetDataAttributes(key, node)} class="vjt-textarea" data-widget="textarea" placeholder="${placeholder}"${enabled ? "" : " disabled"}${editable ? "" : " readonly"}${styleAttribute}>${value}</textarea>`;
 };
 
 // src/lib/widgets/button.ts
-var renderButton = (env, node, state, key) => {
+var renderButton = (env, node, state, key, _path, itemContext) => {
   const common = state.id ? ` id="${env.escapeHtml(state.id)}"` : "";
   const enabled = state.enabled ?? env.normalizeBoolean(node.enabled, true);
   const disabledAttribute = enabled ? "" : " disabled";
-  const text = env.escapeHtml(env.resolveI18nValue(state.text ?? node.text));
+  const text = env.escapeHtml(env.resolveTextValue(state.text ?? node.text, itemContext));
   const styleString = env.buildStyleString(node);
   const styleAttribute = styleString ? ` style="${env.escapeHtml(styleString)}"` : "";
   const buttonType = env.escapeHtml(node.type === "submit" ? "submit" : "button");
@@ -6204,7 +6430,10 @@ var renderCheckbox = (env, node, state, key) => {
 
 // src/lib/widgets/image.ts
 var renderImage = (env, node, state, key) => {
-  const url = env.escapeHtml(sanitizeUrl(state.url ?? node.url ?? "", { allowRelative: true }) ?? "");
+  const rawBase64 = typeof state.base64 === "string" ? state.base64 : typeof node.base64 === "string" ? node.base64 : "";
+  const rawUrl = sanitizeUrl(state.url ?? node.url ?? "", { allowRelative: true }) ?? "";
+  const imageSource = rawBase64 ? rawBase64.startsWith("data:") ? rawBase64 : `data:image/png;base64,${rawBase64}` : rawUrl;
+  const url = env.escapeHtml(imageSource);
   const styleParts = [
     "box-sizing:border-box",
     "width:100%",
@@ -6224,10 +6453,10 @@ var renderImage = (env, node, state, key) => {
 };
 
 // src/lib/widgets/link.ts
-var renderLink = (env, node, state, key) => {
+var renderLink = (env, node, state, key, _path, itemContext) => {
   const type = node.type === "button" || node.type === "text" ? node.type : "link";
   const enabled = state.enabled ?? env.normalizeBoolean(node.enabled, true);
-  const text = env.escapeHtml(env.resolveI18nValue(state.text ?? node.text));
+  const text = env.escapeHtml(env.resolveTextValue(state.text ?? node.text, itemContext));
   const classes = `vjt-link vjt-link--${type}${enabled ? "" : " is-disabled"}`;
   const styleString = env.buildStyleString(node);
   const styleAttribute = styleString ? ` style="${env.escapeHtml(styleString)}"` : "";
@@ -6408,6 +6637,32 @@ function renderConfirmModalOverlay(env, modal) {
 }
 
 // src/lib/widgets/bindings.ts
+function readBlobAsDataUrl(blob) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(typeof reader.result === "string" ? reader.result : "");
+    reader.onerror = () => reject(reader.error ?? new Error("Failed to read clipboard blob"));
+    reader.readAsDataURL(blob);
+  });
+}
+async function getPasteInputValue(event) {
+  const clipboardData = event.clipboardData;
+  if (!clipboardData) {
+    return "";
+  }
+  for (const item of Array.from(clipboardData.items)) {
+    if (!item.type.startsWith("image/")) {
+      continue;
+    }
+    const file = item.getAsFile();
+    if (!file) {
+      continue;
+    }
+    const dataUrl = await readBlobAsDataUrl(file);
+    return dataUrl;
+  }
+  return clipboardData.getData("text/plain");
+}
 function bindKeyboardSubmitEvents(element, node, key, env) {
   const hasKeyboardEvents = Boolean(
     node.events?.onEnter?.length || node.events?.onShiftEnter?.length || node.events?.onControlEnter?.length
@@ -6430,6 +6685,10 @@ function bindKeyboardSubmitEvents(element, node, key, env) {
     if (!eventName || !node.events?.[eventName]?.length) {
       return;
     }
+    if (eventName !== "onShiftEnter") {
+      event.preventDefault();
+      event.stopPropagation();
+    }
     void env.dispatchWidgetEvent(node, eventName, key, env.getActionInputValueForElement(element, node), null);
   });
 }
@@ -6501,6 +6760,11 @@ function bindWidgetEvents(root, env) {
     }
     if (element instanceof HTMLInputElement && element.dataset.widget === "edit") {
       bindKeyboardSubmitEvents(element, node, key, env);
+      if (node.events?.onPaste?.length) {
+        element.addEventListener("paste", (event) => {
+          void getPasteInputValue(event).then((inputValue) => env.dispatchWidgetEvent(node, "onPaste", key, inputValue, null));
+        });
+      }
       element.addEventListener("input", () => {
         const state = env.stateByKey.get(key);
         if (state) {
@@ -6519,6 +6783,11 @@ function bindWidgetEvents(root, env) {
     }
     if (element instanceof HTMLTextAreaElement && element.dataset.widget === "textarea") {
       bindKeyboardSubmitEvents(element, node, key, env);
+      if (node.events?.onPaste?.length) {
+        element.addEventListener("paste", (event) => {
+          void getPasteInputValue(event).then((inputValue) => env.dispatchWidgetEvent(node, "onPaste", key, inputValue, null));
+        });
+      }
       element.addEventListener("input", () => {
         const state = env.stateByKey.get(key);
         if (state) {
@@ -6984,6 +7253,7 @@ var RuntimeRenderer = class {
   i18n;
   actionsMap;
   requestsMap;
+  routes;
   sseConfigs;
   systemEvents;
   resourceManager;
@@ -7003,6 +7273,7 @@ var RuntimeRenderer = class {
   vars = /* @__PURE__ */ new Map();
   resizeHandler = null;
   pointerHandler = null;
+  popstateHandler = null;
   eventSources = [];
   referenceRuntime;
   networkRuntime;
@@ -7015,6 +7286,11 @@ var RuntimeRenderer = class {
   activeConfirmModal = null;
   lastPointer = { x: 24, y: 24 };
   pendingResetModalIds = /* @__PURE__ */ new Set();
+  pendingScrollAction = null;
+  pendingScrollFrameId = null;
+  activeScrollAnimationFrameId = null;
+  pendingCursorReference = null;
+  pendingCursorFrameId = null;
   constructor(description, options = {}) {
     this.description = deepClone(description);
     this.resourceManager = options.resourceManager ?? null;
@@ -7028,6 +7304,8 @@ var RuntimeRenderer = class {
     this.theme = options.theme === "light" ? "light" : "dark";
     this.actionsMap = options.actionsMap ?? this.resourceManager?.getActionsMap() ?? {};
     this.requestsMap = options.requestsMap ?? this.resourceManager?.getRequestsMap() ?? {};
+    const resolvedRoutes = options.routes ?? this.resourceManager?.getRoutes() ?? [];
+    this.routes = Array.isArray(resolvedRoutes) ? resolvedRoutes.map((route) => ({ ...route })) : Array.isArray(resolvedRoutes?.routes) ? resolvedRoutes.routes.map((route) => ({ ...route })) : [];
     const resolvedSseConfigs = options.sseConfigs ?? this.resourceManager?.getSseConfigs() ?? [];
     this.sseConfigs = Array.isArray(resolvedSseConfigs) ? resolvedSseConfigs : resolvedSseConfigs ? [resolvedSseConfigs] : [];
     this.systemEvents = options.systemEvents ?? this.resourceManager?.getSystemEvents() ?? {};
@@ -7041,12 +7319,15 @@ var RuntimeRenderer = class {
       stateByKey: this.stateByKey,
       nodeById: this.nodeById,
       nodeByKey: this.nodeByKey,
+      getUiResource: (ref) => this.resourceManager?.getUi(ref) ?? null,
       getAppValue: (name) => {
         switch (name) {
           case "language":
             return this.language;
           case "theme":
             return this.theme;
+          case "isMobile":
+            return typeof window === "undefined" ? false : isMobileViewport();
           case "urlPath":
             return typeof window === "undefined" ? "" : window.location.pathname;
           default:
@@ -7111,9 +7392,14 @@ var RuntimeRenderer = class {
       assignReference: (reference, inputValue, currentValue, options2) => this.referenceRuntime.assignReference(reference, inputValue, currentValue, options2),
       resolveMappedValue: (template, currentValue, responseValue) => this.referenceRuntime.resolveMappedValue(template, currentValue, responseValue),
       setWidgetEnabled: (widgetId, enabled) => this.setWidgetEnabled(widgetId, enabled),
+      setWidgetVisible: (widgetId, visible) => this.setWidgetVisible(widgetId, visible),
       clearWidget: (widgetId) => this.clearWidget(widgetId),
       clearListElementState: (listKey) => this.clearListElementState(listKey),
       focusWidget: (reference) => this.focusWidget(reference),
+      moveCursorToEnd: (reference) => this.moveCursorToEnd(reference),
+      scrollWidgetToTop: (reference) => this.scrollWidgetToTop(reference),
+      scrollWidgetToBottom: (reference) => this.scrollWidgetToBottom(reference),
+      scrollWidgetToElementByIndex: (reference, index) => this.scrollWidgetToElementByIndex(reference, index),
       playAudio: (value) => this.voiceRuntime.play(value),
       stopPlaying: () => this.voiceRuntime.stopPlaying(),
       copyToClipboard: (value) => this.copyToClipboard(value),
@@ -7121,7 +7407,7 @@ var RuntimeRenderer = class {
       confirmModal: (args, inputValue) => this.confirmModal(args, inputValue),
       startRecording: () => this.voiceRuntime.startRecording(),
       stopRecording: () => Promise.resolve(this.voiceRuntime.stopRecording()),
-      startListening: () => this.voiceRuntime.startListening(),
+      startListening: (args) => this.voiceRuntime.startListening(args),
       stopListening: () => this.voiceRuntime.stopListening(),
       setUiReference: (widgetId, resourceRef) => {
         const node = this.nodeById.get(widgetId);
@@ -7151,11 +7437,12 @@ var RuntimeRenderer = class {
       getInlineActions: (node) => this.getInlineActions(node),
       isWidgetEnabled: (node, key) => this.isWidgetEnabled(node, key)
     });
-    this.indexStaticNodes(this.description, "root");
+    this.indexStaticNodes(this.getActiveDescription(), "root");
     this.applyRuntimeSnapshot(this.initialRuntimeSnapshot);
   }
   renderMarkup() {
-    const markup = `${this.renderNode(this.description, "root", null)}${this.renderGlobalOverlays()}`;
+    const activeDescription = this.getActiveDescription();
+    const markup = `${this.renderNode(activeDescription, "root", null)}${this.renderGlobalOverlays()}`;
     logRuntimeDebug(this.debugLogging, "html", markup);
     return markup;
   }
@@ -7205,6 +7492,17 @@ var RuntimeRenderer = class {
     };
     window.addEventListener("pointerdown", handlePointer);
     this.pointerHandler = handlePointer;
+    const handlePopState = () => {
+      void (async () => {
+        await this.runSystemEvent("onBeforeNavigate");
+        await this.rerenderRoot();
+        await this.runSystemEvent("onAfterNavigate");
+      })().catch((error) => {
+        logRuntimeError("popstate", error);
+      });
+    };
+    window.addEventListener("popstate", handlePopState);
+    this.popstateHandler = handlePopState;
     return () => {
       if (this.resizeHandler) {
         window.removeEventListener("resize", this.resizeHandler);
@@ -7212,6 +7510,9 @@ var RuntimeRenderer = class {
       if (this.pointerHandler) {
         window.removeEventListener("pointerdown", this.pointerHandler);
       }
+      if (this.popstateHandler) {
+        window.removeEventListener("popstate", this.popstateHandler);
+      }
       for (const source of this.eventSources) {
         source.close();
       }
@@ -7234,6 +7535,8 @@ var RuntimeRenderer = class {
     this.attachInputBehavior(this.root);
     this.attachWidgetEvents(this.root);
     restoreElementState(this.root, preservedState, this.stateByKey);
+    this.applyPendingScrollAction();
+    this.applyPendingCursorAction();
     this.activeContextMenu = adjustContextMenuPosition(this.root, this.activeContextMenu);
     this.pendingResetModalIds.clear();
     if (typeof this.onRuntimeSnapshot === "function") {
@@ -7413,7 +7716,113 @@ var RuntimeRenderer = class {
     this.nodeByKey.clear();
     this.nodeById.clear();
     this.stateById.clear();
-    this.indexStaticNodes(this.description, "root");
+    this.indexStaticNodes(this.getActiveDescription(), "root");
+  }
+  getActiveDescription() {
+    if (this.hasRoutes() && !this.isCurrentPathValid()) {
+      return this.buildNotFoundDescription(this.getCurrentPathname());
+    }
+    return this.description;
+  }
+  hasRoutes() {
+    return this.routes.length > 0;
+  }
+  isCurrentPathValid() {
+    const pathname = this.getCurrentPathname();
+    if (pathname === "/") {
+      return true;
+    }
+    return this.routes.some((entry) => this.normalizePathname(entry.path) === pathname);
+  }
+  getCurrentPathname() {
+    if (typeof window === "undefined") {
+      return "/";
+    }
+    return this.normalizePathname(window.location.pathname);
+  }
+  normalizePathname(path) {
+    if (!path || path === "/" || path === "/index.html") {
+      return "/";
+    }
+    const normalized = path.startsWith("/") ? path : `/${path}`;
+    return normalized.length > 1 ? normalized.replace(/\/+$/, "") : normalized;
+  }
+  buildNotFoundDescription(pathname) {
+    const dictionary = this.getBuiltinNotFoundTexts();
+    return {
+      widget: "panel",
+      id: "vjt-not-found-panel",
+      css: "position:fixed;left:50%;top:50%;transform:translate(-50%,-50%);width:min(520px, calc(100vw - 32px));padding:28px;border-radius:20px;background:color-mix(in srgb, var(--vjt-surface) 92%, black 8%);border:1px solid var(--vjt-border);box-shadow:var(--vjt-shadow);",
+      child: {
+        widget: "container-layout",
+        type: "vertical",
+        children: [
+          {
+            minHeightPx: 64,
+            maxHeightPx: 64,
+            marginBottomPx: 8,
+            child: {
+              widget: "static-text",
+              heading: "h1",
+              text: dictionary.title,
+              css: "font-size:42px;font-weight:800;letter-spacing:0.04em;text-align:center;justify-content:center;"
+            }
+          },
+          {
+            minHeightPx: 36,
+            maxHeightPx: 36,
+            marginBottomPx: 8,
+            child: {
+              widget: "static-text",
+              heading: "h3",
+              text: dictionary.caption,
+              css: "text-align:center;justify-content:center;"
+            }
+          },
+          {
+            minHeightPx: 64,
+            marginBottomPx: 16,
+            child: {
+              widget: "static-text",
+              text: `${dictionary.note} ${pathname}`,
+              css: "text-align:center;justify-content:center;color:var(--vjt-muted);"
+            }
+          },
+          {
+            minHeightPx: 52,
+            maxHeightPx: 52,
+            child: {
+              widget: "button",
+              text: dictionary.home,
+              events: {
+                onClick: [
+                  {
+                    action: "navigate /"
+                  }
+                ]
+              }
+            }
+          }
+        ]
+      }
+    };
+  }
+  getBuiltinNotFoundTexts() {
+    const language = this.language.toLowerCase();
+    if (language.startsWith("ru")) {
+      return {
+        title: "404",
+        caption: "\u0421\u0442\u0440\u0430\u043D\u0438\u0446\u0430 \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u0430",
+        note: "\u0417\u0430\u043F\u0440\u043E\u0448\u0435\u043D\u043D\u044B\u0439 \u043F\u0443\u0442\u044C \u043D\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442:",
+        home: "\u041D\u0430 \u0433\u043B\u0430\u0432\u043D\u0443\u044E"
+      };
+    }
+    return {
+      title: "404",
+      caption: "Page not found",
+      note: "The requested path does not exist:",
+      home: "Go home"
+    };
   }
   getUiReferenceTarget(node, key) {
     if (node.widget !== "ui-reference") {
@@ -7648,6 +8057,9 @@ var RuntimeRenderer = class {
         existing.id = stateId2;
         this.stateById.set(stateId2, existing);
       }
+      if (existing.visible === void 0) {
+        existing.visible = normalizeBoolean(node.visible, true);
+      }
       this.syncStateDefinition(existing, node);
       return existing;
     }
@@ -7698,7 +8110,8 @@ var RuntimeRenderer = class {
           id: stateId,
           name: node.name,
           text: typeof node.text === "string" ? node.text : void 0,
-          url: "url" in node ? typeof node.url === "string" ? node.url : "" : void 0
+          url: "url" in node ? typeof node.url === "string" ? node.url : "" : void 0,
+          base64: "base64" in node ? typeof node.base64 === "string" ? node.base64 : "" : void 0
         };
         break;
       case "conditional-container":
@@ -7871,6 +8284,20 @@ var RuntimeRenderer = class {
     }
     return `??${key}??`;
   }
+  resolveTextValue(value, itemContext) {
+    if (typeof value !== "string") {
+      return value ?? "";
+    }
+    if (value.startsWith("$ref:")) {
+      const resolved = this.referenceRuntime.resolveReference(value.slice(5), itemContext, null);
+      if (resolved == null) {
+        return "";
+      }
+      const resolvedText = typeof resolved === "string" ? resolved : typeof resolved === "number" || typeof resolved === "boolean" || typeof resolved === "bigint" ? String(resolved) : JSON.stringify(resolved);
+      return this.resolveI18nValue(resolvedText);
+    }
+    return this.resolveI18nValue(value);
+  }
   buildWidgetDataAttributes(key, node) {
     const parts = [` data-widget-key="${escapeHtml(key)}"`];
     if (node.id) {
@@ -7889,6 +8316,7 @@ var RuntimeRenderer = class {
       escapeHtml,
       buildStyleString: (node) => this.buildStyleString(node),
       resolveI18nValue: (value) => this.resolveI18nValue(value),
+      resolveTextValue: (value, itemContext) => this.resolveTextValue(value, itemContext),
       getUiResource: (ref) => this.resourceManager?.getUi(ref) ?? null,
       resolveReference: (reference, currentValue, responseValue) => this.referenceRuntime.resolveReference(reference, currentValue, responseValue),
       buildWidgetDataAttributes: (key, node) => this.buildWidgetDataAttributes(key, node),
@@ -7920,6 +8348,9 @@ var RuntimeRenderer = class {
     const key = itemContext ? this.resolveItemNodeKey(node, itemContext.listId, itemContext.index, path) : this.resolveNodeKey(node, path);
     this.nodeByKey.set(key, node);
     const state = this.ensureWidgetState(node, key);
+    if ((state.visible ?? normalizeBoolean(node.visible, true)) === false) {
+      return "";
+    }
     switch (node.widget) {
       case "adaptive-layout":
         return renderAdaptiveLayout(env, node, state, key, path, itemContext);
@@ -8409,6 +8840,13 @@ var RuntimeRenderer = class {
     }
     state.enabled = enabled;
   }
+  setWidgetVisible(widgetId, visible) {
+    const state = this.stateById.get(widgetId);
+    if (!state) {
+      return;
+    }
+    state.visible = visible;
+  }
   clearListElementState(listKey) {
     this.referenceRuntime.clearListElementState(listKey);
   }
@@ -8434,6 +8872,199 @@ var RuntimeRenderer = class {
       nestedTarget.focus({ preventScroll: true });
     }
   }
+  moveCursorToEnd(reference) {
+    this.pendingCursorReference = reference;
+    if (typeof window === "undefined" || this.pendingCursorFrameId !== null) {
+      return;
+    }
+    this.pendingCursorFrameId = window.requestAnimationFrame(() => {
+      this.pendingCursorFrameId = null;
+      this.applyPendingCursorAction();
+    });
+  }
+  scrollWidgetToTop(reference) {
+    this.pendingScrollAction = { kind: "top", reference };
+    this.schedulePendingScrollAction();
+  }
+  scrollWidgetToBottom(reference) {
+    this.pendingScrollAction = { kind: "bottom", reference };
+    this.schedulePendingScrollAction();
+  }
+  scrollWidgetToElementByIndex(reference, indexValue) {
+    this.pendingScrollAction = { kind: "index", reference, indexValue };
+    this.schedulePendingScrollAction();
+  }
+  schedulePendingScrollAction() {
+    if (typeof window === "undefined" || this.pendingScrollFrameId !== null) {
+      return;
+    }
+    this.pendingScrollFrameId = window.requestAnimationFrame(() => {
+      this.pendingScrollFrameId = null;
+      this.applyPendingScrollAction();
+    });
+  }
+  applyPendingScrollAction() {
+    if (!this.pendingScrollAction) {
+      return;
+    }
+    const pending = this.pendingScrollAction;
+    if (pending.kind === "top") {
+      this.animateScrollTop(pending.reference, 0);
+      this.pendingScrollAction = null;
+      return;
+    }
+    if (pending.kind === "bottom") {
+      const element = this.findScrollableWidgetElement(pending.reference);
+      if (!element) {
+        return;
+      }
+      this.animateScrollTop(pending.reference, element.scrollHeight);
+      this.pendingScrollAction = null;
+      return;
+    }
+    const index = this.toScrollableIndex(pending.indexValue);
+    if (index === null) {
+      this.pendingScrollAction = null;
+      return;
+    }
+    this.performScrollToElementByIndex(pending.reference, index);
+    this.pendingScrollAction = null;
+  }
+  performScrollToElementByIndex(reference, index) {
+    const element = this.findScrollableWidgetElement(reference);
+    if (!element) {
+      return;
+    }
+    if (element instanceof HTMLSelectElement) {
+      const option = element.options.item(index);
+      if (!option) {
+        return;
+      }
+      const maxScrollTop = Math.max(0, element.scrollHeight - element.clientHeight);
+      this.animateScrollTop(reference, Math.max(0, Math.min(option.offsetTop, maxScrollTop)));
+      return;
+    }
+    const listElement = element.querySelector(`.vjt-list-element[data-list-index="${index}"], .vjt-grid-cell[data-list-index="${index}"]`);
+    if (listElement instanceof HTMLElement) {
+      const maxScrollTop = Math.max(0, element.scrollHeight - element.clientHeight);
+      const containerRect = element.getBoundingClientRect();
+      const itemRect = listElement.getBoundingClientRect();
+      const targetTop = element.scrollTop + (itemRect.top - containerRect.top);
+      const remainingContentHeight = element.scrollHeight - targetTop;
+      const nextScrollTop = remainingContentHeight > element.clientHeight ? Math.max(0, Math.min(targetTop, maxScrollTop)) : maxScrollTop;
+      this.animateScrollTop(reference, nextScrollTop);
+    }
+  }
+  animateScrollTop(reference, targetTop) {
+    const resolveLiveElement = () => {
+      const resolved = this.findScrollableWidgetElement(reference);
+      return resolved instanceof HTMLElement ? resolved : null;
+    };
+    const getMaxScrollTop = (element) => Math.max(
+      0,
+      element.scrollHeight - element.clientHeight
+    );
+    const initialElement = resolveLiveElement();
+    if (!initialElement) {
+      return;
+    }
+    if (typeof window === "undefined") {
+      initialElement.scrollTop = Math.max(0, Math.min(targetTop, getMaxScrollTop(initialElement)));
+      return;
+    }
+    if (this.activeScrollAnimationFrameId !== null) {
+      window.cancelAnimationFrame(this.activeScrollAnimationFrameId);
+      this.activeScrollAnimationFrameId = null;
+    }
+    const startTop = initialElement.scrollTop;
+    const clampedTargetTop = Math.max(0, Math.min(targetTop, getMaxScrollTop(initialElement)));
+    const delta = clampedTargetTop - startTop;
+    if (Math.abs(delta) < 1) {
+      initialElement.scrollTop = clampedTargetTop;
+      return;
+    }
+    const durationMs = 300;
+    const startTime = window.performance.now();
+    const easeInOutCubic = (t) => t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2;
+    const tick = (now) => {
+      const liveElement = resolveLiveElement();
+      if (!liveElement) {
+        this.activeScrollAnimationFrameId = null;
+        return;
+      }
+      const elapsed = now - startTime;
+      const progress = Math.min(1, elapsed / durationMs);
+      const liveTargetTop = Math.max(0, Math.min(clampedTargetTop, getMaxScrollTop(liveElement)));
+      liveElement.scrollTop = startTop + (liveTargetTop - startTop) * easeInOutCubic(progress);
+      if (progress < 1) {
+        this.activeScrollAnimationFrameId = window.requestAnimationFrame(tick);
+      } else {
+        liveElement.scrollTop = liveTargetTop;
+        this.activeScrollAnimationFrameId = null;
+      }
+    };
+    this.activeScrollAnimationFrameId = window.requestAnimationFrame(tick);
+  }
+  applyPendingCursorAction() {
+    if (!(this.root instanceof HTMLElement) || !this.pendingCursorReference) {
+      return;
+    }
+    const reference = this.pendingCursorReference;
+    const widgetId = reference.split(".")[0]?.trim();
+    if (!widgetId) {
+      this.pendingCursorReference = null;
+      return;
+    }
+    const directTarget = this.root.querySelector(`#${CSS.escape(widgetId)}`);
+    const widgetRoot = directTarget ?? this.root.querySelector(`[data-widget-id="${CSS.escape(widgetId)}"]`);
+    if (!widgetRoot) {
+      return;
+    }
+    const inputTarget = widgetRoot instanceof HTMLInputElement || widgetRoot instanceof HTMLTextAreaElement ? widgetRoot : widgetRoot.querySelector("input, textarea");
+    if (!inputTarget || inputTarget.disabled) {
+      this.pendingCursorReference = null;
+      return;
+    }
+    if (typeof inputTarget.focus === "function") {
+      inputTarget.focus({ preventScroll: true });
+    }
+    if (typeof inputTarget.setSelectionRange === "function") {
+      const end = inputTarget.value.length;
+      inputTarget.setSelectionRange(end, end);
+    }
+    this.pendingCursorReference = null;
+  }
+  findScrollableWidgetElement(reference) {
+    if (!(this.root instanceof HTMLElement)) {
+      return null;
+    }
+    const widgetId = reference.split(".")[0]?.trim();
+    if (!widgetId) {
+      return null;
+    }
+    const directTarget = this.root.querySelector(`#${CSS.escape(widgetId)}`);
+    if (directTarget) {
+      return directTarget;
+    }
+    for (const element of Array.from(this.root.querySelectorAll("[data-widget-id]"))) {
+      if (element.dataset.widgetId === widgetId) {
+        return element;
+      }
+    }
+    return null;
+  }
+  toScrollableIndex(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+      return Math.max(0, Math.trunc(value));
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+      const parsed = Number.parseInt(value, 10);
+      if (Number.isFinite(parsed)) {
+        return Math.max(0, parsed);
+      }
+    }
+    return null;
+  }
 };
 function renderJson(description, options = {}) {
   const renderer = new RuntimeRenderer(description, options);
@@ -8449,6 +9080,7 @@ var ResourceManager = class {
   ui = /* @__PURE__ */ new Map();
   actions = {};
   requests = {};
+  routes = [];
   sse = {};
   systemEvents = {};
   i18n = {};
@@ -8459,6 +9091,7 @@ var ResourceManager = class {
     }
     this.actions = { ...input.actions ?? {} };
     this.requests = { ...input.requests ?? {} };
+    this.routes = Array.isArray(input.routes) ? input.routes.map((route) => ({ ...route })) : Array.isArray(input.routes?.routes) ? input.routes.routes.map((route) => ({ ...route })) : [];
     this.sse = { ...input.sse ?? {} };
     this.systemEvents = { ...input.systemEvents ?? {} };
     this.i18n = { ...input.i18n ?? {} };
@@ -8476,6 +9109,9 @@ var ResourceManager = class {
   getRequestsMap() {
     return this.requests;
   }
+  getRoutes() {
+    return this.routes.map((route) => ({ ...route }));
+  }
   getSseConfigs() {
     return Object.values(this.sse);
   }